@gravito/satellite-analytics 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# @gravito/satellite-analytics
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @gravito/core@1.0.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { ServiceProvider, Container } from '@gravito/core';
+
+declare class AnalyticsServiceProvider extends ServiceProvider {
+    private resolvers;
+    register(_container: Container): void;
+    private addResolver;
+    boot(): void;
+}
+
+export { AnalyticsServiceProvider };

package/dist/index.js

@@ -0,0 +1,61 @@
+// src/index.ts
+import { ServiceProvider } from "@gravito/core";
+
+// src/Application/Resolvers/OrderVolumeResolver.ts
+var OrderVolumeResolver = class {
+  metric = "order_volume";
+  async resolve(_query) {
+    return {
+      type: "TIMESERIES",
+      data: [
+        { label: "Mon", value: 120 },
+        { label: "Tue", value: 150 },
+        { label: "Wed", value: 80 },
+        { label: "Thu", value: 200 },
+        { label: "Fri", value: 170 },
+        { label: "Sat", value: 250 },
+        { label: "Sun", value: 300 }
+      ],
+      summary: "\u672C\u9031\u8A02\u55AE\u91CF\u589E\u9577 15%"
+    };
+  }
+};
+
+// src/index.ts
+var AnalyticsServiceProvider = class extends ServiceProvider {
+  resolvers = /* @__PURE__ */ new Map();
+  register(_container) {
+    this.addResolver(new OrderVolumeResolver());
+  }
+  addResolver(resolver) {
+    this.resolvers.set(resolver.metric, resolver);
+  }
+  boot() {
+    const core = this.core;
+    if (!core) {
+      return;
+    }
+    core.logger.info("\u{1F4CA} Analytics Framework is ready for data ingestion");
+    core.router.prefix("/api/admin/v1/analytics").group((router) => {
+      router.get("/query", async (ctx) => {
+        const metric = ctx.req.query("metric");
+        const period = ctx.req.query("period") || "7d";
+        if (!metric) {
+          return ctx.json({ error: "Metric is required" }, 400);
+        }
+        const resolver = this.resolvers.get(metric);
+        if (!resolver) {
+          return ctx.json({ error: `Metric ${metric} not supported` }, 404);
+        }
+        const result = await resolver.resolve({ metric, period });
+        return ctx.json(result);
+      });
+      router.get("/metrics", (ctx) => {
+        return ctx.json(Array.from(this.resolvers.keys()));
+      });
+    });
+  }
+};
+export {
+  AnalyticsServiceProvider
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@gravito/satellite-analytics",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck"
+  },
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@gravito/core": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gravito-framework/gravito.git",
+    "directory": "satellites/analytics"
+  }
+}

package/src/Application/Resolvers/OrderVolumeResolver.ts

@@ -0,0 +1,26 @@
+import type {
+  AnalyticsQuery,
+  AnalyticsResponse,
+  IAnalyticsResolver,
+} from '../../Domain/Contracts/IAnalyticsResolver'
+
+export class OrderVolumeResolver implements IAnalyticsResolver {
+  metric = 'order_volume'
+
+  async resolve(_query: AnalyticsQuery): Promise<AnalyticsResponse> {
+    // 模擬數據邏輯
+    return {
+      type: 'TIMESERIES',
+      data: [
+        { label: 'Mon', value: 120 },
+        { label: 'Tue', value: 150 },
+        { label: 'Wed', value: 80 },
+        { label: 'Thu', value: 200 },
+        { label: 'Fri', value: 170 },
+        { label: 'Sat', value: 250 },
+        { label: 'Sun', value: 300 },
+      ],
+      summary: '本週訂單量增長 15%',
+    }
+  }
+}

package/src/Domain/Contracts/IAnalyticsResolver.ts

@@ -0,0 +1,16 @@
+export interface AnalyticsQuery {
+  metric: string
+  period: '24h' | '7d' | '30d' | '90d'
+  filters?: Record<string, any>
+}
+
+export interface AnalyticsResponse {
+  type: 'TIMESERIES' | 'SINGLE_VALUE' | 'PIE' | 'TABLE'
+  data: any
+  summary?: string
+}
+
+export interface IAnalyticsResolver {
+  metric: string
+  resolve(query: AnalyticsQuery): Promise<AnalyticsResponse>
+}

package/src/index.ts

@@ -0,0 +1,49 @@
+import { type Container, ServiceProvider } from '@gravito/core'
+import { OrderVolumeResolver } from './Application/Resolvers/OrderVolumeResolver'
+import type { IAnalyticsResolver } from './Domain/Contracts/IAnalyticsResolver'
+
+export class AnalyticsServiceProvider extends ServiceProvider {
+  private resolvers: Map<string, IAnalyticsResolver> = new Map()
+
+  register(_container: Container): void {
+    // 註冊內建解析器
+    this.addResolver(new OrderVolumeResolver())
+  }
+
+  private addResolver(resolver: IAnalyticsResolver) {
+    this.resolvers.set(resolver.metric, resolver)
+  }
+
+  override boot(): void {
+    const core = this.core
+    if (!core) {
+      return
+    }
+
+    core.logger.info('📊 Analytics Framework is ready for data ingestion')
+
+    core.router.prefix('/api/admin/v1/analytics').group((router) => {
+      router.get('/query', async (ctx) => {
+        const metric = ctx.req.query('metric')
+        const period = (ctx.req.query('period') as any) || '7d'
+
+        if (!metric) {
+          return ctx.json({ error: 'Metric is required' }, 400)
+        }
+
+        const resolver = this.resolvers.get(metric)
+        if (!resolver) {
+          return ctx.json({ error: `Metric ${metric} not supported` }, 404)
+        }
+
+        const result = await resolver.resolve({ metric, period })
+        return ctx.json(result)
+      })
+
+      // 讓開發者查詢目前有哪些可用的指標
+      router.get('/metrics', (ctx) => {
+        return ctx.json(Array.from(this.resolvers.keys()))
+      })
+    })
+  }
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "./dist",
+        "baseUrl": ".",
+        "skipLibCheck": true,
+        "types": ["bun-types"],
+        "paths": {
+            "@gravito/core": ["../../packages/core/src/index.ts"],
+            "@gravito/*": ["../../packages/*/src/index.ts"]
+        }
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "**/*.test.ts"
+    ]
+}