@uniforge/portal 0.1.0-alpha.2

package/dist/dashboard/index.d.ts

@@ -0,0 +1,76 @@
+interface DashboardMetrics {
+    totalInstalls: number;
+    activeMerchants: number;
+    monthlyRevenue: string;
+    churnRate: number;
+}
+interface DashboardActivity {
+    id: string;
+    title: string;
+    description?: string;
+    timestamp: Date;
+    type: 'install' | 'uninstall' | 'upgrade' | 'downgrade' | 'payment' | 'error';
+    shopDomain?: string;
+}
+type DashboardTimeRange = 'day' | 'week' | 'month' | 'quarter' | 'year';
+interface MetricsSnapshot {
+    metrics: DashboardMetrics;
+    timestamp: Date;
+    timeRange: DashboardTimeRange;
+}
+interface DashboardConfig {
+    metricsDataSource: MetricsDataSource;
+    activityDataSource: ActivityDataSource;
+    defaultTimeRange?: DashboardTimeRange;
+    defaultActivityLimit?: number;
+}
+interface MetricsDataSource {
+    countShops(filter?: string): Promise<number>;
+    countActiveShops(): Promise<number>;
+    sumRevenue(since: Date): Promise<number>;
+    countChurned(since: Date): Promise<number>;
+    getInstallTimeline(range: DashboardTimeRange): Promise<{
+        date: string;
+        count: number;
+    }[]>;
+}
+interface ActivityDataSource {
+    getRecentActivities(limit: number): Promise<DashboardActivity[]>;
+    getActivitiesByShop(shopDomain: string, limit: number): Promise<DashboardActivity[]>;
+    getActivitiesByType(type: string, limit: number): Promise<DashboardActivity[]>;
+}
+
+declare class MetricsService {
+    private readonly dataSource;
+    constructor(dataSource: MetricsDataSource);
+    getMetrics(range?: DashboardTimeRange): Promise<DashboardMetrics>;
+    getMetricsSnapshot(range?: DashboardTimeRange): Promise<MetricsSnapshot>;
+    calculateChurnRate(totalShops: number, churnedShops: number): number;
+    formatRevenue(amount: number, currency?: string): string;
+    private getStartDate;
+}
+
+declare class ActivityService {
+    private readonly dataSource;
+    constructor(dataSource: ActivityDataSource);
+    getRecentActivity(limit?: number): Promise<DashboardActivity[]>;
+    getActivityByShop(shopDomain: string, limit?: number): Promise<DashboardActivity[]>;
+    getActivityFeed(options?: {
+        limit?: number;
+        types?: string[];
+        shopDomain?: string;
+    }): Promise<DashboardActivity[]>;
+}
+
+interface DashboardData {
+    metrics: DashboardMetrics;
+    recentActivity: DashboardActivity[];
+}
+declare class DashboardService {
+    private readonly metricsService;
+    private readonly activityService;
+    constructor(metricsDataSource: MetricsDataSource, activityDataSource: ActivityDataSource);
+    getDashboardData(range?: DashboardTimeRange): Promise<DashboardData>;
+}
+
+export { type ActivityDataSource, ActivityService, type DashboardActivity, type DashboardConfig, type DashboardData, type DashboardMetrics, DashboardService, type DashboardTimeRange, type MetricsDataSource, MetricsService, type MetricsSnapshot };

package/dist/dashboard/index.js

@@ -0,0 +1,158 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/dashboard/index.ts
+var dashboard_exports = {};
+__export(dashboard_exports, {
+  ActivityService: () => ActivityService,
+  DashboardService: () => DashboardService,
+  MetricsService: () => MetricsService
+});
+module.exports = __toCommonJS(dashboard_exports);
+
+// src/dashboard/metrics-service.ts
+var MetricsService = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async getMetrics(range) {
+    const timeRange = range ?? "month";
+    const since = this.getStartDate(timeRange);
+    const [totalInstalls, activeMerchants, revenueAmount, churnedShops] = await Promise.all([
+      this.dataSource.countShops(),
+      this.dataSource.countActiveShops(),
+      this.dataSource.sumRevenue(since),
+      this.dataSource.countChurned(since)
+    ]);
+    const churnRate = this.calculateChurnRate(totalInstalls, churnedShops);
+    return {
+      totalInstalls,
+      activeMerchants,
+      monthlyRevenue: this.formatRevenue(revenueAmount),
+      churnRate
+    };
+  }
+  async getMetricsSnapshot(range) {
+    const timeRange = range ?? "month";
+    const metrics = await this.getMetrics(timeRange);
+    return {
+      metrics,
+      timestamp: /* @__PURE__ */ new Date(),
+      timeRange
+    };
+  }
+  calculateChurnRate(totalShops, churnedShops) {
+    if (totalShops <= 0) {
+      return 0;
+    }
+    const rate = churnedShops / totalShops * 100;
+    return Math.round(rate * 100) / 100;
+  }
+  formatRevenue(amount, currency) {
+    const cur = currency ?? "USD";
+    return new Intl.NumberFormat("en-US", {
+      style: "currency",
+      currency: cur
+    }).format(amount);
+  }
+  getStartDate(range) {
+    const now = /* @__PURE__ */ new Date();
+    switch (range) {
+      case "day":
+        return new Date(now.getTime() - 24 * 60 * 60 * 1e3);
+      case "week":
+        return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1e3);
+      case "month":
+        return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1e3);
+      case "quarter":
+        return new Date(now.getTime() - 90 * 24 * 60 * 60 * 1e3);
+      case "year":
+        return new Date(now.getTime() - 365 * 24 * 60 * 60 * 1e3);
+    }
+  }
+};
+
+// src/dashboard/activity-service.ts
+var DEFAULT_ACTIVITY_LIMIT = 20;
+var ActivityService = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async getRecentActivity(limit) {
+    return this.dataSource.getRecentActivities(limit ?? DEFAULT_ACTIVITY_LIMIT);
+  }
+  async getActivityByShop(shopDomain, limit) {
+    return this.dataSource.getActivitiesByShop(
+      shopDomain,
+      limit ?? DEFAULT_ACTIVITY_LIMIT
+    );
+  }
+  async getActivityFeed(options) {
+    const limit = options?.limit ?? DEFAULT_ACTIVITY_LIMIT;
+    if (options?.shopDomain !== void 0) {
+      const activities = await this.dataSource.getActivitiesByShop(
+        options.shopDomain,
+        limit
+      );
+      if (options.types !== void 0 && options.types.length > 0) {
+        return activities.filter((a) => options.types.includes(a.type));
+      }
+      return activities;
+    }
+    if (options?.types !== void 0 && options.types.length > 0) {
+      const results = [];
+      for (const type of options.types) {
+        const activities = await this.dataSource.getActivitiesByType(
+          type,
+          limit
+        );
+        results.push(...activities);
+      }
+      results.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+      return results.slice(0, limit);
+    }
+    return this.dataSource.getRecentActivities(limit);
+  }
+};
+
+// src/dashboard/dashboard-service.ts
+var DashboardService = class {
+  metricsService;
+  activityService;
+  constructor(metricsDataSource, activityDataSource) {
+    this.metricsService = new MetricsService(metricsDataSource);
+    this.activityService = new ActivityService(activityDataSource);
+  }
+  async getDashboardData(range) {
+    const [metrics, recentActivity] = await Promise.all([
+      this.metricsService.getMetrics(range),
+      this.activityService.getRecentActivity()
+    ]);
+    return { metrics, recentActivity };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ActivityService,
+  DashboardService,
+  MetricsService
+});
+//# sourceMappingURL=index.js.map

package/dist/dashboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dashboard/index.ts","../../src/dashboard/metrics-service.ts","../../src/dashboard/activity-service.ts","../../src/dashboard/dashboard-service.ts"],"sourcesContent":["export type {\n  DashboardMetrics,\n  DashboardActivity,\n  DashboardTimeRange,\n  MetricsSnapshot,\n  DashboardConfig,\n  MetricsDataSource,\n  ActivityDataSource,\n} from './types.js';\n\nexport { MetricsService } from './metrics-service.js';\nexport { ActivityService } from './activity-service.js';\nexport { DashboardService } from './dashboard-service.js';\nexport type { DashboardData } from './dashboard-service.js';\n","import type {\n  DashboardMetrics,\n  DashboardTimeRange,\n  MetricsDataSource,\n  MetricsSnapshot,\n} from './types.js';\n\nexport class MetricsService {\n  private readonly dataSource: MetricsDataSource;\n\n  constructor(dataSource: MetricsDataSource) {\n    this.dataSource = dataSource;\n  }\n\n  async getMetrics(range?: DashboardTimeRange): Promise<DashboardMetrics> {\n    const timeRange = range ?? 'month';\n    const since = this.getStartDate(timeRange);\n\n    const [totalInstalls, activeMerchants, revenueAmount, churnedShops] =\n      await Promise.all([\n        this.dataSource.countShops(),\n        this.dataSource.countActiveShops(),\n        this.dataSource.sumRevenue(since),\n        this.dataSource.countChurned(since),\n      ]);\n\n    const churnRate = this.calculateChurnRate(totalInstalls, churnedShops);\n\n    return {\n      totalInstalls,\n      activeMerchants,\n      monthlyRevenue: this.formatRevenue(revenueAmount),\n      churnRate,\n    };\n  }\n\n  async getMetricsSnapshot(\n    range?: DashboardTimeRange,\n  ): Promise<MetricsSnapshot> {\n    const timeRange = range ?? 'month';\n    const metrics = await this.getMetrics(timeRange);\n\n    return {\n      metrics,\n      timestamp: new Date(),\n      timeRange,\n    };\n  }\n\n  calculateChurnRate(totalShops: number, churnedShops: number): number {\n    if (totalShops <= 0) {\n      return 0;\n    }\n    const rate = (churnedShops / totalShops) * 100;\n    return Math.round(rate * 100) / 100;\n  }\n\n  formatRevenue(amount: number, currency?: string): string {\n    const cur = currency ?? 'USD';\n    return new Intl.NumberFormat('en-US', {\n      style: 'currency',\n      currency: cur,\n    }).format(amount);\n  }\n\n  private getStartDate(range: DashboardTimeRange): Date {\n    const now = new Date();\n    switch (range) {\n      case 'day':\n        return new Date(now.getTime() - 24 * 60 * 60 * 1000);\n      case 'week':\n        return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);\n      case 'month':\n        return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);\n      case 'quarter':\n        return new Date(now.getTime() - 90 * 24 * 60 * 60 * 1000);\n      case 'year':\n        return new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000);\n    }\n  }\n}\n","import type { ActivityDataSource, DashboardActivity } from './types.js';\n\nconst DEFAULT_ACTIVITY_LIMIT = 20;\n\nexport class ActivityService {\n  private readonly dataSource: ActivityDataSource;\n\n  constructor(dataSource: ActivityDataSource) {\n    this.dataSource = dataSource;\n  }\n\n  async getRecentActivity(limit?: number): Promise<DashboardActivity[]> {\n    return this.dataSource.getRecentActivities(limit ?? DEFAULT_ACTIVITY_LIMIT);\n  }\n\n  async getActivityByShop(\n    shopDomain: string,\n    limit?: number,\n  ): Promise<DashboardActivity[]> {\n    return this.dataSource.getActivitiesByShop(\n      shopDomain,\n      limit ?? DEFAULT_ACTIVITY_LIMIT,\n    );\n  }\n\n  async getActivityFeed(options?: {\n    limit?: number;\n    types?: string[];\n    shopDomain?: string;\n  }): Promise<DashboardActivity[]> {\n    const limit = options?.limit ?? DEFAULT_ACTIVITY_LIMIT;\n\n    if (options?.shopDomain !== undefined) {\n      const activities = await this.dataSource.getActivitiesByShop(\n        options.shopDomain,\n        limit,\n      );\n      if (options.types !== undefined && options.types.length > 0) {\n        return activities.filter((a) => options.types!.includes(a.type));\n      }\n      return activities;\n    }\n\n    if (options?.types !== undefined && options.types.length > 0) {\n      const results: DashboardActivity[] = [];\n      for (const type of options.types) {\n        const activities = await this.dataSource.getActivitiesByType(\n          type,\n          limit,\n        );\n        results.push(...activities);\n      }\n      results.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());\n      return results.slice(0, limit);\n    }\n\n    return this.dataSource.getRecentActivities(limit);\n  }\n}\n","import type {\n  ActivityDataSource,\n  DashboardActivity,\n  DashboardMetrics,\n  DashboardTimeRange,\n  MetricsDataSource,\n} from './types.js';\nimport { MetricsService } from './metrics-service.js';\nimport { ActivityService } from './activity-service.js';\n\nexport interface DashboardData {\n  metrics: DashboardMetrics;\n  recentActivity: DashboardActivity[];\n}\n\nexport class DashboardService {\n  private readonly metricsService: MetricsService;\n  private readonly activityService: ActivityService;\n\n  constructor(\n    metricsDataSource: MetricsDataSource,\n    activityDataSource: ActivityDataSource,\n  ) {\n    this.metricsService = new MetricsService(metricsDataSource);\n    this.activityService = new ActivityService(activityDataSource);\n  }\n\n  async getDashboardData(range?: DashboardTimeRange): Promise<DashboardData> {\n    const [metrics, recentActivity] = await Promise.all([\n      this.metricsService.getMetrics(range),\n      this.activityService.getRecentActivity(),\n    ]);\n\n    return { metrics, recentActivity };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/dashboard/index.mjs

@@ -0,0 +1,129 @@
+// src/dashboard/metrics-service.ts
+var MetricsService = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async getMetrics(range) {
+    const timeRange = range ?? "month";
+    const since = this.getStartDate(timeRange);
+    const [totalInstalls, activeMerchants, revenueAmount, churnedShops] = await Promise.all([
+      this.dataSource.countShops(),
+      this.dataSource.countActiveShops(),
+      this.dataSource.sumRevenue(since),
+      this.dataSource.countChurned(since)
+    ]);
+    const churnRate = this.calculateChurnRate(totalInstalls, churnedShops);
+    return {
+      totalInstalls,
+      activeMerchants,
+      monthlyRevenue: this.formatRevenue(revenueAmount),
+      churnRate
+    };
+  }
+  async getMetricsSnapshot(range) {
+    const timeRange = range ?? "month";
+    const metrics = await this.getMetrics(timeRange);
+    return {
+      metrics,
+      timestamp: /* @__PURE__ */ new Date(),
+      timeRange
+    };
+  }
+  calculateChurnRate(totalShops, churnedShops) {
+    if (totalShops <= 0) {
+      return 0;
+    }
+    const rate = churnedShops / totalShops * 100;
+    return Math.round(rate * 100) / 100;
+  }
+  formatRevenue(amount, currency) {
+    const cur = currency ?? "USD";
+    return new Intl.NumberFormat("en-US", {
+      style: "currency",
+      currency: cur
+    }).format(amount);
+  }
+  getStartDate(range) {
+    const now = /* @__PURE__ */ new Date();
+    switch (range) {
+      case "day":
+        return new Date(now.getTime() - 24 * 60 * 60 * 1e3);
+      case "week":
+        return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1e3);
+      case "month":
+        return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1e3);
+      case "quarter":
+        return new Date(now.getTime() - 90 * 24 * 60 * 60 * 1e3);
+      case "year":
+        return new Date(now.getTime() - 365 * 24 * 60 * 60 * 1e3);
+    }
+  }
+};
+
+// src/dashboard/activity-service.ts
+var DEFAULT_ACTIVITY_LIMIT = 20;
+var ActivityService = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async getRecentActivity(limit) {
+    return this.dataSource.getRecentActivities(limit ?? DEFAULT_ACTIVITY_LIMIT);
+  }
+  async getActivityByShop(shopDomain, limit) {
+    return this.dataSource.getActivitiesByShop(
+      shopDomain,
+      limit ?? DEFAULT_ACTIVITY_LIMIT
+    );
+  }
+  async getActivityFeed(options) {
+    const limit = options?.limit ?? DEFAULT_ACTIVITY_LIMIT;
+    if (options?.shopDomain !== void 0) {
+      const activities = await this.dataSource.getActivitiesByShop(
+        options.shopDomain,
+        limit
+      );
+      if (options.types !== void 0 && options.types.length > 0) {
+        return activities.filter((a) => options.types.includes(a.type));
+      }
+      return activities;
+    }
+    if (options?.types !== void 0 && options.types.length > 0) {
+      const results = [];
+      for (const type of options.types) {
+        const activities = await this.dataSource.getActivitiesByType(
+          type,
+          limit
+        );
+        results.push(...activities);
+      }
+      results.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+      return results.slice(0, limit);
+    }
+    return this.dataSource.getRecentActivities(limit);
+  }
+};
+
+// src/dashboard/dashboard-service.ts
+var DashboardService = class {
+  metricsService;
+  activityService;
+  constructor(metricsDataSource, activityDataSource) {
+    this.metricsService = new MetricsService(metricsDataSource);
+    this.activityService = new ActivityService(activityDataSource);
+  }
+  async getDashboardData(range) {
+    const [metrics, recentActivity] = await Promise.all([
+      this.metricsService.getMetrics(range),
+      this.activityService.getRecentActivity()
+    ]);
+    return { metrics, recentActivity };
+  }
+};
+export {
+  ActivityService,
+  DashboardService,
+  MetricsService
+};
+//# sourceMappingURL=index.mjs.map

package/dist/dashboard/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dashboard/metrics-service.ts","../../src/dashboard/activity-service.ts","../../src/dashboard/dashboard-service.ts"],"sourcesContent":["import type {\n  DashboardMetrics,\n  DashboardTimeRange,\n  MetricsDataSource,\n  MetricsSnapshot,\n} from './types.js';\n\nexport class MetricsService {\n  private readonly dataSource: MetricsDataSource;\n\n  constructor(dataSource: MetricsDataSource) {\n    this.dataSource = dataSource;\n  }\n\n  async getMetrics(range?: DashboardTimeRange): Promise<DashboardMetrics> {\n    const timeRange = range ?? 'month';\n    const since = this.getStartDate(timeRange);\n\n    const [totalInstalls, activeMerchants, revenueAmount, churnedShops] =\n      await Promise.all([\n        this.dataSource.countShops(),\n        this.dataSource.countActiveShops(),\n        this.dataSource.sumRevenue(since),\n        this.dataSource.countChurned(since),\n      ]);\n\n    const churnRate = this.calculateChurnRate(totalInstalls, churnedShops);\n\n    return {\n      totalInstalls,\n      activeMerchants,\n      monthlyRevenue: this.formatRevenue(revenueAmount),\n      churnRate,\n    };\n  }\n\n  async getMetricsSnapshot(\n    range?: DashboardTimeRange,\n  ): Promise<MetricsSnapshot> {\n    const timeRange = range ?? 'month';\n    const metrics = await this.getMetrics(timeRange);\n\n    return {\n      metrics,\n      timestamp: new Date(),\n      timeRange,\n    };\n  }\n\n  calculateChurnRate(totalShops: number, churnedShops: number): number {\n    if (totalShops <= 0) {\n      return 0;\n    }\n    const rate = (churnedShops / totalShops) * 100;\n    return Math.round(rate * 100) / 100;\n  }\n\n  formatRevenue(amount: number, currency?: string): string {\n    const cur = currency ?? 'USD';\n    return new Intl.NumberFormat('en-US', {\n      style: 'currency',\n      currency: cur,\n    }).format(amount);\n  }\n\n  private getStartDate(range: DashboardTimeRange): Date {\n    const now = new Date();\n    switch (range) {\n      case 'day':\n        return new Date(now.getTime() - 24 * 60 * 60 * 1000);\n      case 'week':\n        return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);\n      case 'month':\n        return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);\n      case 'quarter':\n        return new Date(now.getTime() - 90 * 24 * 60 * 60 * 1000);\n      case 'year':\n        return new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000);\n    }\n  }\n}\n","import type { ActivityDataSource, DashboardActivity } from './types.js';\n\nconst DEFAULT_ACTIVITY_LIMIT = 20;\n\nexport class ActivityService {\n  private readonly dataSource: ActivityDataSource;\n\n  constructor(dataSource: ActivityDataSource) {\n    this.dataSource = dataSource;\n  }\n\n  async getRecentActivity(limit?: number): Promise<DashboardActivity[]> {\n    return this.dataSource.getRecentActivities(limit ?? DEFAULT_ACTIVITY_LIMIT);\n  }\n\n  async getActivityByShop(\n    shopDomain: string,\n    limit?: number,\n  ): Promise<DashboardActivity[]> {\n    return this.dataSource.getActivitiesByShop(\n      shopDomain,\n      limit ?? DEFAULT_ACTIVITY_LIMIT,\n    );\n  }\n\n  async getActivityFeed(options?: {\n    limit?: number;\n    types?: string[];\n    shopDomain?: string;\n  }): Promise<DashboardActivity[]> {\n    const limit = options?.limit ?? DEFAULT_ACTIVITY_LIMIT;\n\n    if (options?.shopDomain !== undefined) {\n      const activities = await this.dataSource.getActivitiesByShop(\n        options.shopDomain,\n        limit,\n      );\n      if (options.types !== undefined && options.types.length > 0) {\n        return activities.filter((a) => options.types!.includes(a.type));\n      }\n      return activities;\n    }\n\n    if (options?.types !== undefined && options.types.length > 0) {\n      const results: DashboardActivity[] = [];\n      for (const type of options.types) {\n        const activities = await this.dataSource.getActivitiesByType(\n          type,\n          limit,\n        );\n        results.push(...activities);\n      }\n      results.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());\n      return results.slice(0, limit);\n    }\n\n    return this.dataSource.getRecentActivities(limit);\n  }\n}\n","import type {\n  ActivityDataSource,\n  DashboardActivity,\n  DashboardMetrics,\n  DashboardTimeRange,\n  MetricsDataSource,\n} from './types.js';\nimport { MetricsService } from './metrics-service.js';\nimport { ActivityService } from './activity-service.js';\n\nexport interface DashboardData {\n  metrics: DashboardMetrics;\n  recentActivity: DashboardActivity[];\n}\n\nexport class DashboardService {\n  private readonly metricsService: MetricsService;\n  private readonly activityService: ActivityService;\n\n  constructor(\n    metricsDataSource: MetricsDataSource,\n    activityDataSource: ActivityDataSource,\n  ) {\n    this.metricsService = new MetricsService(metricsDataSource);\n    this.activityService = new ActivityService(activityDataSource);\n  }\n\n  async getDashboardData(range?: DashboardTimeRange): Promise<DashboardData> {\n    const [metrics, recentActivity] = await Promise.all([\n      this.metricsService.getMetrics(range),\n      this.activityService.getRecentActivity(),\n    ]);\n\n    return { metrics, recentActivity };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/feature-flags/index.d.cts

@@ -0,0 +1,75 @@
+interface FeatureFlag {
+    id: string;
+    key: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    rolloutPercentage: number;
+    targetShops: string[];
+    excludedShops: string[];
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: string;
+}
+interface FeatureFlagCreateInput {
+    key: string;
+    name: string;
+    description?: string;
+    enabled?: boolean;
+    rolloutPercentage?: number;
+    targetShops?: string[];
+    excludedShops?: string[];
+    createdBy: string;
+}
+interface FeatureFlagUpdateInput {
+    name?: string;
+    description?: string;
+    enabled?: boolean;
+    rolloutPercentage?: number;
+    targetShops?: string[];
+    excludedShops?: string[];
+}
+type FeatureFlagEvaluationReason = 'targeted' | 'excluded' | 'rollout' | 'default' | 'disabled' | 'not_found';
+interface FeatureFlagEvaluation {
+    flagKey: string;
+    enabled: boolean;
+    reason: FeatureFlagEvaluationReason;
+}
+interface FeatureFlagListResult {
+    flags: FeatureFlag[];
+    total: number;
+}
+interface FeatureFlagFilter {
+    enabled?: boolean;
+    search?: string;
+}
+
+interface FeatureFlagDataSource {
+    create(input: FeatureFlagCreateInput): Promise<FeatureFlag>;
+    getById(flagId: string): Promise<FeatureFlag | null>;
+    getByKey(key: string): Promise<FeatureFlag | null>;
+    list(filter?: FeatureFlagFilter): Promise<FeatureFlagListResult>;
+    update(flagId: string, input: FeatureFlagUpdateInput): Promise<FeatureFlag | null>;
+    delete(flagId: string): Promise<boolean>;
+}
+
+declare class FeatureFlagService {
+    private readonly dataSource;
+    constructor(dataSource: FeatureFlagDataSource);
+    createFlag(input: FeatureFlagCreateInput): Promise<FeatureFlag>;
+    getFlag(flagId: string): Promise<FeatureFlag | null>;
+    getFlagByKey(key: string): Promise<FeatureFlag | null>;
+    listFlags(filter?: FeatureFlagFilter): Promise<FeatureFlagListResult>;
+    updateFlag(flagId: string, input: FeatureFlagUpdateInput): Promise<FeatureFlag | null>;
+    deleteFlag(flagId: string): Promise<boolean>;
+    toggleFlag(flagId: string, enabled: boolean): Promise<FeatureFlag | null>;
+}
+
+declare class FeatureFlagEvaluator {
+    private readonly dataSource;
+    constructor(dataSource: FeatureFlagDataSource);
+    evaluate(flagKey: string, shopDomain: string): Promise<FeatureFlagEvaluation>;
+    evaluateAll(shopDomain: string): Promise<Record<string, FeatureFlagEvaluation>>;
+}
+
+export { type FeatureFlag, type FeatureFlagCreateInput, type FeatureFlagDataSource, type FeatureFlagEvaluation, type FeatureFlagEvaluationReason, FeatureFlagEvaluator, type FeatureFlagFilter, type FeatureFlagListResult, FeatureFlagService, type FeatureFlagUpdateInput };

package/dist/feature-flags/index.d.ts

@@ -0,0 +1,75 @@
+interface FeatureFlag {
+    id: string;
+    key: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    rolloutPercentage: number;
+    targetShops: string[];
+    excludedShops: string[];
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: string;
+}
+interface FeatureFlagCreateInput {
+    key: string;
+    name: string;
+    description?: string;
+    enabled?: boolean;
+    rolloutPercentage?: number;
+    targetShops?: string[];
+    excludedShops?: string[];
+    createdBy: string;
+}
+interface FeatureFlagUpdateInput {
+    name?: string;
+    description?: string;
+    enabled?: boolean;
+    rolloutPercentage?: number;
+    targetShops?: string[];
+    excludedShops?: string[];
+}
+type FeatureFlagEvaluationReason = 'targeted' | 'excluded' | 'rollout' | 'default' | 'disabled' | 'not_found';
+interface FeatureFlagEvaluation {
+    flagKey: string;
+    enabled: boolean;
+    reason: FeatureFlagEvaluationReason;
+}
+interface FeatureFlagListResult {
+    flags: FeatureFlag[];
+    total: number;
+}
+interface FeatureFlagFilter {
+    enabled?: boolean;
+    search?: string;
+}
+
+interface FeatureFlagDataSource {
+    create(input: FeatureFlagCreateInput): Promise<FeatureFlag>;
+    getById(flagId: string): Promise<FeatureFlag | null>;
+    getByKey(key: string): Promise<FeatureFlag | null>;
+    list(filter?: FeatureFlagFilter): Promise<FeatureFlagListResult>;
+    update(flagId: string, input: FeatureFlagUpdateInput): Promise<FeatureFlag | null>;
+    delete(flagId: string): Promise<boolean>;
+}
+
+declare class FeatureFlagService {
+    private readonly dataSource;
+    constructor(dataSource: FeatureFlagDataSource);
+    createFlag(input: FeatureFlagCreateInput): Promise<FeatureFlag>;
+    getFlag(flagId: string): Promise<FeatureFlag | null>;
+    getFlagByKey(key: string): Promise<FeatureFlag | null>;
+    listFlags(filter?: FeatureFlagFilter): Promise<FeatureFlagListResult>;
+    updateFlag(flagId: string, input: FeatureFlagUpdateInput): Promise<FeatureFlag | null>;
+    deleteFlag(flagId: string): Promise<boolean>;
+    toggleFlag(flagId: string, enabled: boolean): Promise<FeatureFlag | null>;
+}
+
+declare class FeatureFlagEvaluator {
+    private readonly dataSource;
+    constructor(dataSource: FeatureFlagDataSource);
+    evaluate(flagKey: string, shopDomain: string): Promise<FeatureFlagEvaluation>;
+    evaluateAll(shopDomain: string): Promise<Record<string, FeatureFlagEvaluation>>;
+}
+
+export { type FeatureFlag, type FeatureFlagCreateInput, type FeatureFlagDataSource, type FeatureFlagEvaluation, type FeatureFlagEvaluationReason, FeatureFlagEvaluator, type FeatureFlagFilter, type FeatureFlagListResult, FeatureFlagService, type FeatureFlagUpdateInput };

package/dist/feature-flags/index.js

@@ -0,0 +1,111 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/feature-flags/index.ts
+var feature_flags_exports = {};
+__export(feature_flags_exports, {
+  FeatureFlagEvaluator: () => FeatureFlagEvaluator,
+  FeatureFlagService: () => FeatureFlagService
+});
+module.exports = __toCommonJS(feature_flags_exports);
+
+// src/feature-flags/feature-flag-service.ts
+var FLAG_KEY_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+var FeatureFlagService = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async createFlag(input) {
+    if (!FLAG_KEY_PATTERN.test(input.key)) {
+      throw new Error(
+        `Invalid flag key "${input.key}". Keys must be alphanumeric and may contain hyphens or underscores.`
+      );
+    }
+    return this.dataSource.create(input);
+  }
+  async getFlag(flagId) {
+    return this.dataSource.getById(flagId);
+  }
+  async getFlagByKey(key) {
+    return this.dataSource.getByKey(key);
+  }
+  async listFlags(filter) {
+    return this.dataSource.list(filter);
+  }
+  async updateFlag(flagId, input) {
+    return this.dataSource.update(flagId, input);
+  }
+  async deleteFlag(flagId) {
+    return this.dataSource.delete(flagId);
+  }
+  async toggleFlag(flagId, enabled) {
+    return this.dataSource.update(flagId, { enabled });
+  }
+};
+
+// src/feature-flags/feature-flag-evaluator.ts
+function hashToPercentage(input) {
+  let hash = 5381;
+  for (let i = 0; i < input.length; i++) {
+    hash = hash * 33 ^ input.charCodeAt(i);
+  }
+  return Math.abs(hash) % 100;
+}
+var FeatureFlagEvaluator = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async evaluate(flagKey, shopDomain) {
+    const flag = await this.dataSource.getByKey(flagKey);
+    if (!flag) {
+      return { flagKey, enabled: false, reason: "not_found" };
+    }
+    if (!flag.enabled) {
+      return { flagKey, enabled: false, reason: "disabled" };
+    }
+    if (flag.excludedShops.includes(shopDomain)) {
+      return { flagKey, enabled: false, reason: "excluded" };
+    }
+    if (flag.targetShops.includes(shopDomain)) {
+      return { flagKey, enabled: true, reason: "targeted" };
+    }
+    if (flag.rolloutPercentage > 0) {
+      const bucket = hashToPercentage(flagKey + shopDomain);
+      const enabled = bucket < flag.rolloutPercentage;
+      return { flagKey, enabled, reason: "rollout" };
+    }
+    return { flagKey, enabled: flag.enabled, reason: "default" };
+  }
+  async evaluateAll(shopDomain) {
+    const { flags } = await this.dataSource.list();
+    const result = {};
+    for (const flag of flags) {
+      result[flag.key] = await this.evaluate(flag.key, shopDomain);
+    }
+    return result;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FeatureFlagEvaluator,
+  FeatureFlagService
+});
+//# sourceMappingURL=index.js.map

package/dist/feature-flags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feature-flags/index.ts","../../src/feature-flags/feature-flag-service.ts","../../src/feature-flags/feature-flag-evaluator.ts"],"sourcesContent":["export type {\n  FeatureFlag,\n  FeatureFlagCreateInput,\n  FeatureFlagUpdateInput,\n  FeatureFlagEvaluation,\n  FeatureFlagEvaluationReason,\n  FeatureFlagListResult,\n  FeatureFlagFilter,\n} from './types.js';\n\nexport type { FeatureFlagDataSource } from './feature-flag-data-source.js';\n\nexport { FeatureFlagService } from './feature-flag-service.js';\nexport { FeatureFlagEvaluator } from './feature-flag-evaluator.js';\n","import type { FeatureFlagDataSource } from './feature-flag-data-source.js';\nimport type {\n  FeatureFlag,\n  FeatureFlagCreateInput,\n  FeatureFlagFilter,\n  FeatureFlagListResult,\n  FeatureFlagUpdateInput,\n} from './types.js';\n\nconst FLAG_KEY_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;\n\nexport class FeatureFlagService {\n  private readonly dataSource: FeatureFlagDataSource;\n\n  constructor(dataSource: FeatureFlagDataSource) {\n    this.dataSource = dataSource;\n  }\n\n  async createFlag(input: FeatureFlagCreateInput): Promise<FeatureFlag> {\n    if (!FLAG_KEY_PATTERN.test(input.key)) {\n      throw new Error(\n        `Invalid flag key \"${input.key}\". Keys must be alphanumeric and may contain hyphens or underscores.`,\n      );\n    }\n    return this.dataSource.create(input);\n  }\n\n  async getFlag(flagId: string): Promise<FeatureFlag | null> {\n    return this.dataSource.getById(flagId);\n  }\n\n  async getFlagByKey(key: string): Promise<FeatureFlag | null> {\n    return this.dataSource.getByKey(key);\n  }\n\n  async listFlags(\n    filter?: FeatureFlagFilter,\n  ): Promise<FeatureFlagListResult> {\n    return this.dataSource.list(filter);\n  }\n\n  async updateFlag(\n    flagId: string,\n    input: FeatureFlagUpdateInput,\n  ): Promise<FeatureFlag | null> {\n    return this.dataSource.update(flagId, input);\n  }\n\n  async deleteFlag(flagId: string): Promise<boolean> {\n    return this.dataSource.delete(flagId);\n  }\n\n  async toggleFlag(\n    flagId: string,\n    enabled: boolean,\n  ): Promise<FeatureFlag | null> {\n    return this.dataSource.update(flagId, { enabled });\n  }\n}\n","import type { FeatureFlagDataSource } from './feature-flag-data-source.js';\nimport type { FeatureFlagEvaluation } from './types.js';\n\n/**\n * Simple djb2 hash for deterministic rollout.\n * Returns a value in [0, 99].\n */\nfunction hashToPercentage(input: string): number {\n  let hash = 5381;\n  for (let i = 0; i < input.length; i++) {\n    hash = (hash * 33) ^ input.charCodeAt(i);\n  }\n  return Math.abs(hash) % 100;\n}\n\nexport class FeatureFlagEvaluator {\n  private readonly dataSource: FeatureFlagDataSource;\n\n  constructor(dataSource: FeatureFlagDataSource) {\n    this.dataSource = dataSource;\n  }\n\n  async evaluate(\n    flagKey: string,\n    shopDomain: string,\n  ): Promise<FeatureFlagEvaluation> {\n    const flag = await this.dataSource.getByKey(flagKey);\n\n    if (!flag) {\n      return { flagKey, enabled: false, reason: 'not_found' };\n    }\n\n    if (!flag.enabled) {\n      return { flagKey, enabled: false, reason: 'disabled' };\n    }\n\n    if (flag.excludedShops.includes(shopDomain)) {\n      return { flagKey, enabled: false, reason: 'excluded' };\n    }\n\n    if (flag.targetShops.includes(shopDomain)) {\n      return { flagKey, enabled: true, reason: 'targeted' };\n    }\n\n    if (flag.rolloutPercentage > 0) {\n      const bucket = hashToPercentage(flagKey + shopDomain);\n      const enabled = bucket < flag.rolloutPercentage;\n      return { flagKey, enabled, reason: 'rollout' };\n    }\n\n    return { flagKey, enabled: flag.enabled, reason: 'default' };\n  }\n\n  async evaluateAll(\n    shopDomain: string,\n  ): Promise<Record<string, FeatureFlagEvaluation>> {\n    const { flags } = await this.dataSource.list();\n    const result: Record<string, FeatureFlagEvaluation> = {};\n\n    for (const flag of flags) {\n      result[flag.key] = await this.evaluate(flag.key, shopDomain);\n    }\n\n    return result;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSA,IAAM,mBAAmB;AAElB,IAAM,qBAAN,MAAyB;AAAA,EACb;AAAA,EAEjB,YAAY,YAAmC;AAC7C,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,WAAW,OAAqD;AACpE,QAAI,CAAC,iBAAiB,KAAK,MAAM,GAAG,GAAG;AACrC,YAAM,IAAI;AAAA,QACR,qBAAqB,MAAM,GAAG;AAAA,MAChC;AAAA,IACF;AACA,WAAO,KAAK,WAAW,OAAO,KAAK;AAAA,EACrC;AAAA,EAEA,MAAM,QAAQ,QAA6C;AACzD,WAAO,KAAK,WAAW,QAAQ,MAAM;AAAA,EACvC;AAAA,EAEA,MAAM,aAAa,KAA0C;AAC3D,WAAO,KAAK,WAAW,SAAS,GAAG;AAAA,EACrC;AAAA,EAEA,MAAM,UACJ,QACgC;AAChC,WAAO,KAAK,WAAW,KAAK,MAAM;AAAA,EACpC;AAAA,EAEA,MAAM,WACJ,QACA,OAC6B;AAC7B,WAAO,KAAK,WAAW,OAAO,QAAQ,KAAK;AAAA,EAC7C;AAAA,EAEA,MAAM,WAAW,QAAkC;AACjD,WAAO,KAAK,WAAW,OAAO,MAAM;AAAA,EACtC;AAAA,EAEA,MAAM,WACJ,QACA,SAC6B;AAC7B,WAAO,KAAK,WAAW,OAAO,QAAQ,EAAE,QAAQ,CAAC;AAAA,EACnD;AACF;;;ACnDA,SAAS,iBAAiB,OAAuB;AAC/C,MAAI,OAAO;AACX,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,WAAQ,OAAO,KAAM,MAAM,WAAW,CAAC;AAAA,EACzC;AACA,SAAO,KAAK,IAAI,IAAI,IAAI;AAC1B;AAEO,IAAM,uBAAN,MAA2B;AAAA,EACf;AAAA,EAEjB,YAAY,YAAmC;AAC7C,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,MAAM,SACJ,SACA,YACgC;AAChC,UAAM,OAAO,MAAM,KAAK,WAAW,SAAS,OAAO;AAEnD,QAAI,CAAC,MAAM;AACT,aAAO,EAAE,SAAS,SAAS,OAAO,QAAQ,YAAY;AAAA,IACxD;AAEA,QAAI,CAAC,KAAK,SAAS;AACjB,aAAO,EAAE,SAAS,SAAS,OAAO,QAAQ,WAAW;AAAA,IACvD;AAEA,QAAI,KAAK,cAAc,SAAS,UAAU,GAAG;AAC3C,aAAO,EAAE,SAAS,SAAS,OAAO,QAAQ,WAAW;AAAA,IACvD;AAEA,QAAI,KAAK,YAAY,SAAS,UAAU,GAAG;AACzC,aAAO,EAAE,SAAS,SAAS,MAAM,QAAQ,WAAW;AAAA,IACtD;AAEA,QAAI,KAAK,oBAAoB,GAAG;AAC9B,YAAM,SAAS,iBAAiB,UAAU,UAAU;AACpD,YAAM,UAAU,SAAS,KAAK;AAC9B,aAAO,EAAE,SAAS,SAAS,QAAQ,UAAU;AAAA,IAC/C;AAEA,WAAO,EAAE,SAAS,SAAS,KAAK,SAAS,QAAQ,UAAU;AAAA,EAC7D;AAAA,EAEA,MAAM,YACJ,YACgD;AAChD,UAAM,EAAE,MAAM,IAAI,MAAM,KAAK,WAAW,KAAK;AAC7C,UAAM,SAAgD,CAAC;AAEvD,eAAW,QAAQ,OAAO;AACxB,aAAO,KAAK,GAAG,IAAI,MAAM,KAAK,SAAS,KAAK,KAAK,UAAU;AAAA,IAC7D;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}