feat: add cli_install_stats collection and implement StatsService for usage tracking

Introduced the `cli_install_stats` collection with full schema and snapshot updates to track CLI usage data. Added `StatsService` and new `/cli/stats` API endpoint for handling related functionality.

Author: Romakita

extensions/tsed-rest/src/index.ts

@@ -1,8 +1,12 @@
 import { defineEndpoint } from "@directus/extensions-sdk";
-import { inject } from "@tsed/di";
+import { inject, logger } from "@tsed/di";
 import { wrapEndpoint } from "@tsed-cms/infra/bootstrap/directus.js";
+import { validate } from "@tsed-cms/infra/validators/validate.js";
 import { LegacyRestService } from "@tsed-cms/usecases/legacy/LegacyRestService.js";
 import { SlackService } from "@tsed-cms/usecases/slack/SlackService.js";
+import { StatsService } from "@tsed-cms/usecases/stats/StatsService.js";
+
+import { CliStatPayload } from "./schema/CliStatPayload.js";
 
 function getCategory(name: string) {
   if (name.startsWith("tsed-cli-") || name.startsWith("@tsed/cli")) {
@@ -121,5 +125,20 @@ export default defineEndpoint({
 
       return res.redirect(302, url);
     });
+
+    router.post("/cli/stats", async (req, res) => {
+      const value = await validate(req.body, CliStatPayload);
+
+      inject(StatsService)
+        .create(value)
+        .catch((err) => {
+          logger().error({
+            event: "ERROR_STATS",
+            message: err.message
+          });
+        });
+
+      return res.status(201).send();
+    });
   })
 });

extensions/tsed-rest/src/schema/CliStatPayload.ts

@@ -0,0 +1,12 @@
+import { s } from "@tsed/schema";
+
+export const CliStatPayload = s.object({
+  tsed_version: s.string().required(),
+  platform: s.string().required(),
+  convention: s.string().required(),
+  package_manager: s.string().required(),
+  runtime: s.string().required(),
+  features: s.array(s.string()),
+  channel: s.string().enum("cli", "mcp").required(),
+  cli_version: s.string().required()
+});

packages/infra/directus/interfaces/DirectusSchema.d.ts

@@ -1,3 +1,21 @@
+export interface CliInstallStat {
+  /** @primaryKey */
+  id: number;
+  user_created?: DirectusUser | string | null;
+  date_created?: string | null;
+  user_updated?: DirectusUser | string | null;
+  date_updated?: string | null;
+  tsed_version?: string | null;
+  platform?: string | null;
+  convention?: string | null;
+  package_manager?: string | null;
+  runtime?: string | null;
+  features?: string[] | null;
+  /** @required */
+  channel: "cli" | "mcp";
+  cli_version?: string | null;
+}
+
 export interface Maintainer {
   /** @primaryKey */
   id: string;
@@ -593,6 +611,7 @@ export interface DirectusExtension {
 }
 
 export interface Schema {
+  cli_install_stats: CliInstallStat[];
   maintainers: Maintainer[];
   packages: Package[];
   packages_maintainers: PackagesMaintainer[];
@@ -631,6 +650,7 @@ export interface Schema {
 }
 
 export enum CollectionNames {
+  cli_install_stats = "cli_install_stats",
   maintainers = "maintainers",
   packages = "packages",
   packages_maintainers = "packages_maintainers",

packages/usecases/stats/StatsService.ts

@@ -0,0 +1,9 @@
+import { injectable } from "@tsed/di";
+import { DirectusItemsRepository } from "@tsed-cms/infra/directus/DirectusItemsRepository.js";
+import type { CliInstallStat, PackageSymbol } from "@tsed-cms/infra/directus/interfaces/DirectusSchema.d.js";
+
+export class StatsService extends DirectusItemsRepository<CliInstallStat> {
+  protected collection = "cli_install_stats" as const;
+}
+
+injectable(StatsService);