Update plugins/federations.js

plugins/federations.js

@@ -414,4 +414,84 @@ FedsRoutes.post("/api/v2/federation/ban-check", authenticateApiKey, async (req,
   }
 });
 
+/**
+ * @swagger
+ * /api/v2/federation/fedstats:
+ *   get:
+ *     summary: Get Federation Statistics
+ *     tags: [Federation]
+ *     description: Retrieve the statistics of a federation, including total banned users and sub-federations.
+ *     parameters:
+ *       - in: query
+ *         name: uuid
+ *         required: true
+ *         description: UUID of the federation to check stats for.
+ *         schema:
+ *           type: string
+ *       - in: header
+ *         name: x-api-key
+ *         required: true
+ *         description: API key for authentication.
+ *         schema:
+ *           type: string
+ *     responses:
+ *       200:
+ *         description: Federation statistics retrieved successfully.
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 stats:
+ *                   type: object
+ *                   properties:
+ *                     federation_name:
+ *                       type: string
+ *                       example: "Example Federation"
+ *                     total_banned_users:
+ *                       type: integer
+ *                       example: 10
+ *                     total_sub_federations:
+ *                       type: integer
+ *                       example: 3
+ *                     owner:
+ *                       type: number
+ *                       example: 123456789
+ *       400:
+ *         description: Missing or invalid federation UUID.
+ *       404:
+ *         description: Federation not found.
+ *       500:
+ *         description: Internal server error.
+ */
+FedsRoutes.get("/api/v2/federation/fedstats", authenticateApiKey, async (req, res) => {
+  try {
+    const { uuid } = req.query;
+
+    if (!uuid) {
+      return res.status(400).json({ error: "Federation UUID is required" });
+    }
+
+    const federation = await Federation.findOne({ uuid });
+
+    if (!federation) {
+      return res.status(404).json({ error: "Federation not found" });
+    }
+
+    const stats = {
+      federation_name: federation.name,
+      total_banned_users: federation.banned_users.length,
+      total_sub_federations: federation.sub_federations.length,
+      owner: federation.owner,
+    };
+
+    res.json({ success: true, stats });
+  } catch (error) {
+    res.status(500).json({ error: `Failed to fetch federation stats: ${error.message}` });
+  }
+});
+
 export { FedsRoutes };