@uniforge/portal 0.1.0-alpha.2

package/dist/metrics/index.d.cts

@@ -0,0 +1,83 @@
+/**
+ * API metrics types for the developer portal.
+ */
+interface ApiMetricEntry {
+    id: string;
+    endpoint: string;
+    method: string;
+    statusCode: number;
+    responseTimeMs: number;
+    timestamp: Date;
+    shopDomain?: string;
+    errorMessage?: string;
+}
+interface MetricsTimeRange {
+    start: Date;
+    end: Date;
+}
+interface MetricsSummary {
+    totalRequests: number;
+    avgResponseTimeMs: number;
+    p95ResponseTimeMs: number;
+    p99ResponseTimeMs: number;
+    errorRate: number;
+    successRate: number;
+    timeRange: MetricsTimeRange;
+}
+interface EndpointMetrics {
+    endpoint: string;
+    method: string;
+    totalRequests: number;
+    avgResponseTimeMs: number;
+    errorCount: number;
+    errorRate: number;
+}
+interface ErrorSummary {
+    errorMessage: string;
+    count: number;
+    lastOccurrence: Date;
+    endpoints: string[];
+}
+interface MetricsFilter {
+    endpoint?: string;
+    method?: string;
+    statusCode?: number;
+    shopDomain?: string;
+    startDate?: Date;
+    endDate?: Date;
+}
+
+interface MetricsDataSource {
+    recordMetric(entry: Omit<ApiMetricEntry, 'id'>): Promise<ApiMetricEntry>;
+    getMetrics(filter?: MetricsFilter): Promise<ApiMetricEntry[]>;
+    getMetricsSummary(timeRange: MetricsTimeRange): Promise<MetricsSummary>;
+    getEndpointMetrics(timeRange: MetricsTimeRange): Promise<EndpointMetrics[]>;
+    getErrorSummary(timeRange: MetricsTimeRange, limit?: number): Promise<ErrorSummary[]>;
+}
+
+declare class MetricsCollector {
+    private readonly dataSource;
+    constructor(dataSource: MetricsDataSource);
+    record(entry: Omit<ApiMetricEntry, 'id'>): Promise<ApiMetricEntry>;
+    recordBatch(entries: Array<Omit<ApiMetricEntry, 'id'>>): Promise<ApiMetricEntry[]>;
+}
+
+declare class MetricsQueryService {
+    private readonly dataSource;
+    constructor(dataSource: MetricsDataSource);
+    getSummary(timeRange?: MetricsTimeRange): Promise<MetricsSummary>;
+    getEndpointBreakdown(timeRange?: MetricsTimeRange): Promise<EndpointMetrics[]>;
+    getTopErrors(timeRange?: MetricsTimeRange, limit?: number): Promise<ErrorSummary[]>;
+    getMetricsByFilter(filter: MetricsFilter): Promise<ApiMetricEntry[]>;
+    private defaultTimeRange;
+}
+
+declare class ErrorTracker {
+    private readonly dataSource;
+    constructor(dataSource: MetricsDataSource);
+    trackError(endpoint: string, method: string, statusCode: number, errorMessage: string, shopDomain?: string): Promise<ApiMetricEntry>;
+    getRecentErrors(limit?: number): Promise<ApiMetricEntry[]>;
+    getErrorsByEndpoint(endpoint: string, limit?: number): Promise<ApiMetricEntry[]>;
+}
+
+export { type ApiMetricEntry, type EndpointMetrics, type ErrorSummary, ErrorTracker, MetricsCollector, type MetricsDataSource, type MetricsFilter, MetricsQueryService, type MetricsSummary, type MetricsTimeRange };

package/dist/metrics/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * API metrics types for the developer portal.
+ */
+interface ApiMetricEntry {
+    id: string;
+    endpoint: string;
+    method: string;
+    statusCode: number;
+    responseTimeMs: number;
+    timestamp: Date;
+    shopDomain?: string;
+    errorMessage?: string;
+}
+interface MetricsTimeRange {
+    start: Date;
+    end: Date;
+}
+interface MetricsSummary {
+    totalRequests: number;
+    avgResponseTimeMs: number;
+    p95ResponseTimeMs: number;
+    p99ResponseTimeMs: number;
+    errorRate: number;
+    successRate: number;
+    timeRange: MetricsTimeRange;
+}
+interface EndpointMetrics {
+    endpoint: string;
+    method: string;
+    totalRequests: number;
+    avgResponseTimeMs: number;
+    errorCount: number;
+    errorRate: number;
+}
+interface ErrorSummary {
+    errorMessage: string;
+    count: number;
+    lastOccurrence: Date;
+    endpoints: string[];
+}
+interface MetricsFilter {
+    endpoint?: string;
+    method?: string;
+    statusCode?: number;
+    shopDomain?: string;
+    startDate?: Date;
+    endDate?: Date;
+}
+
+interface MetricsDataSource {
+    recordMetric(entry: Omit<ApiMetricEntry, 'id'>): Promise<ApiMetricEntry>;
+    getMetrics(filter?: MetricsFilter): Promise<ApiMetricEntry[]>;
+    getMetricsSummary(timeRange: MetricsTimeRange): Promise<MetricsSummary>;
+    getEndpointMetrics(timeRange: MetricsTimeRange): Promise<EndpointMetrics[]>;
+    getErrorSummary(timeRange: MetricsTimeRange, limit?: number): Promise<ErrorSummary[]>;
+}
+
+declare class MetricsCollector {
+    private readonly dataSource;
+    constructor(dataSource: MetricsDataSource);
+    record(entry: Omit<ApiMetricEntry, 'id'>): Promise<ApiMetricEntry>;
+    recordBatch(entries: Array<Omit<ApiMetricEntry, 'id'>>): Promise<ApiMetricEntry[]>;
+}
+
+declare class MetricsQueryService {
+    private readonly dataSource;
+    constructor(dataSource: MetricsDataSource);
+    getSummary(timeRange?: MetricsTimeRange): Promise<MetricsSummary>;
+    getEndpointBreakdown(timeRange?: MetricsTimeRange): Promise<EndpointMetrics[]>;
+    getTopErrors(timeRange?: MetricsTimeRange, limit?: number): Promise<ErrorSummary[]>;
+    getMetricsByFilter(filter: MetricsFilter): Promise<ApiMetricEntry[]>;
+    private defaultTimeRange;
+}
+
+declare class ErrorTracker {
+    private readonly dataSource;
+    constructor(dataSource: MetricsDataSource);
+    trackError(endpoint: string, method: string, statusCode: number, errorMessage: string, shopDomain?: string): Promise<ApiMetricEntry>;
+    getRecentErrors(limit?: number): Promise<ApiMetricEntry[]>;
+    getErrorsByEndpoint(endpoint: string, limit?: number): Promise<ApiMetricEntry[]>;
+}
+
+export { type ApiMetricEntry, type EndpointMetrics, type ErrorSummary, ErrorTracker, MetricsCollector, type MetricsDataSource, type MetricsFilter, MetricsQueryService, type MetricsSummary, type MetricsTimeRange };

package/dist/metrics/index.js

@@ -0,0 +1,112 @@
+"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/metrics/index.ts
+var metrics_exports = {};
+__export(metrics_exports, {
+  ErrorTracker: () => ErrorTracker,
+  MetricsCollector: () => MetricsCollector,
+  MetricsQueryService: () => MetricsQueryService
+});
+module.exports = __toCommonJS(metrics_exports);
+
+// src/metrics/metrics-collector.ts
+var MetricsCollector = class {
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async record(entry) {
+    return this.dataSource.recordMetric(entry);
+  }
+  async recordBatch(entries) {
+    const results = await Promise.all(
+      entries.map((entry) => this.dataSource.recordMetric(entry))
+    );
+    return results;
+  }
+};
+
+// src/metrics/metrics-query-service.ts
+var MetricsQueryService = class {
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async getSummary(timeRange) {
+    const range = timeRange ?? this.defaultTimeRange();
+    return this.dataSource.getMetricsSummary(range);
+  }
+  async getEndpointBreakdown(timeRange) {
+    const range = timeRange ?? this.defaultTimeRange();
+    return this.dataSource.getEndpointMetrics(range);
+  }
+  async getTopErrors(timeRange, limit) {
+    const range = timeRange ?? this.defaultTimeRange();
+    return this.dataSource.getErrorSummary(range, limit);
+  }
+  async getMetricsByFilter(filter) {
+    return this.dataSource.getMetrics(filter);
+  }
+  defaultTimeRange() {
+    const end = /* @__PURE__ */ new Date();
+    const start = new Date(end.getTime() - 24 * 60 * 60 * 1e3);
+    return { start, end };
+  }
+};
+
+// src/metrics/error-tracker.ts
+var ErrorTracker = class {
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async trackError(endpoint, method, statusCode, errorMessage, shopDomain) {
+    const entry = {
+      endpoint,
+      method,
+      statusCode,
+      responseTimeMs: 0,
+      timestamp: /* @__PURE__ */ new Date(),
+      errorMessage,
+      ...shopDomain !== void 0 ? { shopDomain } : {}
+    };
+    return this.dataSource.recordMetric(entry);
+  }
+  async getRecentErrors(limit) {
+    const entries = await this.dataSource.getMetrics({});
+    const sorted = entries.filter((e) => e.statusCode >= 400).sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+    if (limit !== void 0) {
+      return sorted.slice(0, limit);
+    }
+    return sorted;
+  }
+  async getErrorsByEndpoint(endpoint, limit) {
+    const entries = await this.dataSource.getMetrics({ endpoint });
+    const errors = entries.filter((e) => e.statusCode >= 400).sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+    if (limit !== void 0) {
+      return errors.slice(0, limit);
+    }
+    return errors;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ErrorTracker,
+  MetricsCollector,
+  MetricsQueryService
+});
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/metrics/index.ts","../../src/metrics/metrics-collector.ts","../../src/metrics/metrics-query-service.ts","../../src/metrics/error-tracker.ts"],"sourcesContent":["export type {\n  ApiMetricEntry,\n  MetricsSummary,\n  MetricsTimeRange,\n  EndpointMetrics,\n  ErrorSummary,\n  MetricsFilter,\n} from './types.js';\n\nexport type { MetricsDataSource } from './metrics-data-source.js';\nexport { MetricsCollector } from './metrics-collector.js';\nexport { MetricsQueryService } from './metrics-query-service.js';\nexport { ErrorTracker } from './error-tracker.js';\n","import type { MetricsDataSource } from './metrics-data-source.js';\nimport type { ApiMetricEntry } from './types.js';\n\nexport class MetricsCollector {\n  constructor(private readonly dataSource: MetricsDataSource) {}\n\n  async record(\n    entry: Omit<ApiMetricEntry, 'id'>,\n  ): Promise<ApiMetricEntry> {\n    return this.dataSource.recordMetric(entry);\n  }\n\n  async recordBatch(\n    entries: Array<Omit<ApiMetricEntry, 'id'>>,\n  ): Promise<ApiMetricEntry[]> {\n    const results = await Promise.all(\n      entries.map((entry) => this.dataSource.recordMetric(entry)),\n    );\n    return results;\n  }\n}\n","import type { MetricsDataSource } from './metrics-data-source.js';\nimport type {\n  ApiMetricEntry,\n  EndpointMetrics,\n  ErrorSummary,\n  MetricsFilter,\n  MetricsSummary,\n  MetricsTimeRange,\n} from './types.js';\n\nexport class MetricsQueryService {\n  constructor(private readonly dataSource: MetricsDataSource) {}\n\n  async getSummary(timeRange?: MetricsTimeRange): Promise<MetricsSummary> {\n    const range = timeRange ?? this.defaultTimeRange();\n    return this.dataSource.getMetricsSummary(range);\n  }\n\n  async getEndpointBreakdown(\n    timeRange?: MetricsTimeRange,\n  ): Promise<EndpointMetrics[]> {\n    const range = timeRange ?? this.defaultTimeRange();\n    return this.dataSource.getEndpointMetrics(range);\n  }\n\n  async getTopErrors(\n    timeRange?: MetricsTimeRange,\n    limit?: number,\n  ): Promise<ErrorSummary[]> {\n    const range = timeRange ?? this.defaultTimeRange();\n    return this.dataSource.getErrorSummary(range, limit);\n  }\n\n  async getMetricsByFilter(\n    filter: MetricsFilter,\n  ): Promise<ApiMetricEntry[]> {\n    return this.dataSource.getMetrics(filter);\n  }\n\n  private defaultTimeRange(): MetricsTimeRange {\n    const end = new Date();\n    const start = new Date(end.getTime() - 24 * 60 * 60 * 1000);\n    return { start, end };\n  }\n}\n","import type { MetricsDataSource } from './metrics-data-source.js';\nimport type { ApiMetricEntry } from './types.js';\n\nexport class ErrorTracker {\n  constructor(private readonly dataSource: MetricsDataSource) {}\n\n  async trackError(\n    endpoint: string,\n    method: string,\n    statusCode: number,\n    errorMessage: string,\n    shopDomain?: string,\n  ): Promise<ApiMetricEntry> {\n    const entry: Omit<ApiMetricEntry, 'id'> = {\n      endpoint,\n      method,\n      statusCode,\n      responseTimeMs: 0,\n      timestamp: new Date(),\n      errorMessage,\n      ...(shopDomain !== undefined ? { shopDomain } : {}),\n    };\n    return this.dataSource.recordMetric(entry);\n  }\n\n  async getRecentErrors(limit?: number): Promise<ApiMetricEntry[]> {\n    const entries = await this.dataSource.getMetrics({});\n    const sorted = entries\n      .filter((e) => e.statusCode >= 400)\n      .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());\n    if (limit !== undefined) {\n      return sorted.slice(0, limit);\n    }\n    return sorted;\n  }\n\n  async getErrorsByEndpoint(\n    endpoint: string,\n    limit?: number,\n  ): Promise<ApiMetricEntry[]> {\n    const entries = await this.dataSource.getMetrics({ endpoint });\n    const errors = entries\n      .filter((e) => e.statusCode >= 400)\n      .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());\n    if (limit !== undefined) {\n      return errors.slice(0, limit);\n    }\n    return errors;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAA6B,YAA+B;AAA/B;AAAA,EAAgC;AAAA,EAE7D,MAAM,OACJ,OACyB;AACzB,WAAO,KAAK,WAAW,aAAa,KAAK;AAAA,EAC3C;AAAA,EAEA,MAAM,YACJ,SAC2B;AAC3B,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,QAAQ,IAAI,CAAC,UAAU,KAAK,WAAW,aAAa,KAAK,CAAC;AAAA,IAC5D;AACA,WAAO;AAAA,EACT;AACF;;;ACVO,IAAM,sBAAN,MAA0B;AAAA,EAC/B,YAA6B,YAA+B;AAA/B;AAAA,EAAgC;AAAA,EAE7D,MAAM,WAAW,WAAuD;AACtE,UAAM,QAAQ,aAAa,KAAK,iBAAiB;AACjD,WAAO,KAAK,WAAW,kBAAkB,KAAK;AAAA,EAChD;AAAA,EAEA,MAAM,qBACJ,WAC4B;AAC5B,UAAM,QAAQ,aAAa,KAAK,iBAAiB;AACjD,WAAO,KAAK,WAAW,mBAAmB,KAAK;AAAA,EACjD;AAAA,EAEA,MAAM,aACJ,WACA,OACyB;AACzB,UAAM,QAAQ,aAAa,KAAK,iBAAiB;AACjD,WAAO,KAAK,WAAW,gBAAgB,OAAO,KAAK;AAAA,EACrD;AAAA,EAEA,MAAM,mBACJ,QAC2B;AAC3B,WAAO,KAAK,WAAW,WAAW,MAAM;AAAA,EAC1C;AAAA,EAEQ,mBAAqC;AAC3C,UAAM,MAAM,oBAAI,KAAK;AACrB,UAAM,QAAQ,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,KAAK,KAAK,GAAI;AAC1D,WAAO,EAAE,OAAO,IAAI;AAAA,EACtB;AACF;;;ACzCO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAA6B,YAA+B;AAA/B;AAAA,EAAgC;AAAA,EAE7D,MAAM,WACJ,UACA,QACA,YACA,cACA,YACyB;AACzB,UAAM,QAAoC;AAAA,MACxC;AAAA,MACA;AAAA,MACA;AAAA,MACA,gBAAgB;AAAA,MAChB,WAAW,oBAAI,KAAK;AAAA,MACpB;AAAA,MACA,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,IACnD;AACA,WAAO,KAAK,WAAW,aAAa,KAAK;AAAA,EAC3C;AAAA,EAEA,MAAM,gBAAgB,OAA2C;AAC/D,UAAM,UAAU,MAAM,KAAK,WAAW,WAAW,CAAC,CAAC;AACnD,UAAM,SAAS,QACZ,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,EACjC,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,QAAQ,IAAI,EAAE,UAAU,QAAQ,CAAC;AAC/D,QAAI,UAAU,QAAW;AACvB,aAAO,OAAO,MAAM,GAAG,KAAK;AAAA,IAC9B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,oBACJ,UACA,OAC2B;AAC3B,UAAM,UAAU,MAAM,KAAK,WAAW,WAAW,EAAE,SAAS,CAAC;AAC7D,UAAM,SAAS,QACZ,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,EACjC,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,QAAQ,IAAI,EAAE,UAAU,QAAQ,CAAC;AAC/D,QAAI,UAAU,QAAW;AACvB,aAAO,OAAO,MAAM,GAAG,KAAK;AAAA,IAC9B;AACA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/metrics/index.mjs

@@ -0,0 +1,83 @@
+// src/metrics/metrics-collector.ts
+var MetricsCollector = class {
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async record(entry) {
+    return this.dataSource.recordMetric(entry);
+  }
+  async recordBatch(entries) {
+    const results = await Promise.all(
+      entries.map((entry) => this.dataSource.recordMetric(entry))
+    );
+    return results;
+  }
+};
+
+// src/metrics/metrics-query-service.ts
+var MetricsQueryService = class {
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async getSummary(timeRange) {
+    const range = timeRange ?? this.defaultTimeRange();
+    return this.dataSource.getMetricsSummary(range);
+  }
+  async getEndpointBreakdown(timeRange) {
+    const range = timeRange ?? this.defaultTimeRange();
+    return this.dataSource.getEndpointMetrics(range);
+  }
+  async getTopErrors(timeRange, limit) {
+    const range = timeRange ?? this.defaultTimeRange();
+    return this.dataSource.getErrorSummary(range, limit);
+  }
+  async getMetricsByFilter(filter) {
+    return this.dataSource.getMetrics(filter);
+  }
+  defaultTimeRange() {
+    const end = /* @__PURE__ */ new Date();
+    const start = new Date(end.getTime() - 24 * 60 * 60 * 1e3);
+    return { start, end };
+  }
+};
+
+// src/metrics/error-tracker.ts
+var ErrorTracker = class {
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async trackError(endpoint, method, statusCode, errorMessage, shopDomain) {
+    const entry = {
+      endpoint,
+      method,
+      statusCode,
+      responseTimeMs: 0,
+      timestamp: /* @__PURE__ */ new Date(),
+      errorMessage,
+      ...shopDomain !== void 0 ? { shopDomain } : {}
+    };
+    return this.dataSource.recordMetric(entry);
+  }
+  async getRecentErrors(limit) {
+    const entries = await this.dataSource.getMetrics({});
+    const sorted = entries.filter((e) => e.statusCode >= 400).sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+    if (limit !== void 0) {
+      return sorted.slice(0, limit);
+    }
+    return sorted;
+  }
+  async getErrorsByEndpoint(endpoint, limit) {
+    const entries = await this.dataSource.getMetrics({ endpoint });
+    const errors = entries.filter((e) => e.statusCode >= 400).sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+    if (limit !== void 0) {
+      return errors.slice(0, limit);
+    }
+    return errors;
+  }
+};
+export {
+  ErrorTracker,
+  MetricsCollector,
+  MetricsQueryService
+};
+//# sourceMappingURL=index.mjs.map

package/dist/metrics/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/metrics/metrics-collector.ts","../../src/metrics/metrics-query-service.ts","../../src/metrics/error-tracker.ts"],"sourcesContent":["import type { MetricsDataSource } from './metrics-data-source.js';\nimport type { ApiMetricEntry } from './types.js';\n\nexport class MetricsCollector {\n  constructor(private readonly dataSource: MetricsDataSource) {}\n\n  async record(\n    entry: Omit<ApiMetricEntry, 'id'>,\n  ): Promise<ApiMetricEntry> {\n    return this.dataSource.recordMetric(entry);\n  }\n\n  async recordBatch(\n    entries: Array<Omit<ApiMetricEntry, 'id'>>,\n  ): Promise<ApiMetricEntry[]> {\n    const results = await Promise.all(\n      entries.map((entry) => this.dataSource.recordMetric(entry)),\n    );\n    return results;\n  }\n}\n","import type { MetricsDataSource } from './metrics-data-source.js';\nimport type {\n  ApiMetricEntry,\n  EndpointMetrics,\n  ErrorSummary,\n  MetricsFilter,\n  MetricsSummary,\n  MetricsTimeRange,\n} from './types.js';\n\nexport class MetricsQueryService {\n  constructor(private readonly dataSource: MetricsDataSource) {}\n\n  async getSummary(timeRange?: MetricsTimeRange): Promise<MetricsSummary> {\n    const range = timeRange ?? this.defaultTimeRange();\n    return this.dataSource.getMetricsSummary(range);\n  }\n\n  async getEndpointBreakdown(\n    timeRange?: MetricsTimeRange,\n  ): Promise<EndpointMetrics[]> {\n    const range = timeRange ?? this.defaultTimeRange();\n    return this.dataSource.getEndpointMetrics(range);\n  }\n\n  async getTopErrors(\n    timeRange?: MetricsTimeRange,\n    limit?: number,\n  ): Promise<ErrorSummary[]> {\n    const range = timeRange ?? this.defaultTimeRange();\n    return this.dataSource.getErrorSummary(range, limit);\n  }\n\n  async getMetricsByFilter(\n    filter: MetricsFilter,\n  ): Promise<ApiMetricEntry[]> {\n    return this.dataSource.getMetrics(filter);\n  }\n\n  private defaultTimeRange(): MetricsTimeRange {\n    const end = new Date();\n    const start = new Date(end.getTime() - 24 * 60 * 60 * 1000);\n    return { start, end };\n  }\n}\n","import type { MetricsDataSource } from './metrics-data-source.js';\nimport type { ApiMetricEntry } from './types.js';\n\nexport class ErrorTracker {\n  constructor(private readonly dataSource: MetricsDataSource) {}\n\n  async trackError(\n    endpoint: string,\n    method: string,\n    statusCode: number,\n    errorMessage: string,\n    shopDomain?: string,\n  ): Promise<ApiMetricEntry> {\n    const entry: Omit<ApiMetricEntry, 'id'> = {\n      endpoint,\n      method,\n      statusCode,\n      responseTimeMs: 0,\n      timestamp: new Date(),\n      errorMessage,\n      ...(shopDomain !== undefined ? { shopDomain } : {}),\n    };\n    return this.dataSource.recordMetric(entry);\n  }\n\n  async getRecentErrors(limit?: number): Promise<ApiMetricEntry[]> {\n    const entries = await this.dataSource.getMetrics({});\n    const sorted = entries\n      .filter((e) => e.statusCode >= 400)\n      .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());\n    if (limit !== undefined) {\n      return sorted.slice(0, limit);\n    }\n    return sorted;\n  }\n\n  async getErrorsByEndpoint(\n    endpoint: string,\n    limit?: number,\n  ): Promise<ApiMetricEntry[]> {\n    const entries = await this.dataSource.getMetrics({ endpoint });\n    const errors = entries\n      .filter((e) => e.statusCode >= 400)\n      .sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());\n    if (limit !== undefined) {\n      return errors.slice(0, limit);\n    }\n    return errors;\n  }\n}\n"],"mappings":";AAGO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAA6B,YAA+B;AAA/B;AAAA,EAAgC;AAAA,EAE7D,MAAM,OACJ,OACyB;AACzB,WAAO,KAAK,WAAW,aAAa,KAAK;AAAA,EAC3C;AAAA,EAEA,MAAM,YACJ,SAC2B;AAC3B,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,QAAQ,IAAI,CAAC,UAAU,KAAK,WAAW,aAAa,KAAK,CAAC;AAAA,IAC5D;AACA,WAAO;AAAA,EACT;AACF;;;ACVO,IAAM,sBAAN,MAA0B;AAAA,EAC/B,YAA6B,YAA+B;AAA/B;AAAA,EAAgC;AAAA,EAE7D,MAAM,WAAW,WAAuD;AACtE,UAAM,QAAQ,aAAa,KAAK,iBAAiB;AACjD,WAAO,KAAK,WAAW,kBAAkB,KAAK;AAAA,EAChD;AAAA,EAEA,MAAM,qBACJ,WAC4B;AAC5B,UAAM,QAAQ,aAAa,KAAK,iBAAiB;AACjD,WAAO,KAAK,WAAW,mBAAmB,KAAK;AAAA,EACjD;AAAA,EAEA,MAAM,aACJ,WACA,OACyB;AACzB,UAAM,QAAQ,aAAa,KAAK,iBAAiB;AACjD,WAAO,KAAK,WAAW,gBAAgB,OAAO,KAAK;AAAA,EACrD;AAAA,EAEA,MAAM,mBACJ,QAC2B;AAC3B,WAAO,KAAK,WAAW,WAAW,MAAM;AAAA,EAC1C;AAAA,EAEQ,mBAAqC;AAC3C,UAAM,MAAM,oBAAI,KAAK;AACrB,UAAM,QAAQ,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,KAAK,KAAK,GAAI;AAC1D,WAAO,EAAE,OAAO,IAAI;AAAA,EACtB;AACF;;;ACzCO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAA6B,YAA+B;AAA/B;AAAA,EAAgC;AAAA,EAE7D,MAAM,WACJ,UACA,QACA,YACA,cACA,YACyB;AACzB,UAAM,QAAoC;AAAA,MACxC;AAAA,MACA;AAAA,MACA;AAAA,MACA,gBAAgB;AAAA,MAChB,WAAW,oBAAI,KAAK;AAAA,MACpB;AAAA,MACA,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,IACnD;AACA,WAAO,KAAK,WAAW,aAAa,KAAK;AAAA,EAC3C;AAAA,EAEA,MAAM,gBAAgB,OAA2C;AAC/D,UAAM,UAAU,MAAM,KAAK,WAAW,WAAW,CAAC,CAAC;AACnD,UAAM,SAAS,QACZ,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,EACjC,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,QAAQ,IAAI,EAAE,UAAU,QAAQ,CAAC;AAC/D,QAAI,UAAU,QAAW;AACvB,aAAO,OAAO,MAAM,GAAG,KAAK;AAAA,IAC9B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,oBACJ,UACA,OAC2B;AAC3B,UAAM,UAAU,MAAM,KAAK,WAAW,WAAW,EAAE,SAAS,CAAC;AAC7D,UAAM,SAAS,QACZ,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,EACjC,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,QAAQ,IAAI,EAAE,UAAU,QAAQ,CAAC;AAC/D,QAAI,UAAU,QAAW;AACvB,aAAO,OAAO,MAAM,GAAG,KAAK;AAAA,IAC9B;AACA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/tickets/index.d.cts

@@ -0,0 +1,96 @@
+type TicketPriority = 'low' | 'medium' | 'high' | 'urgent';
+type TicketStatus = 'open' | 'in_progress' | 'waiting_on_customer' | 'waiting_on_developer' | 'resolved' | 'closed';
+interface Ticket {
+    id: string;
+    subject: string;
+    description: string;
+    status: TicketStatus;
+    priority: TicketPriority;
+    shopDomain: string;
+    merchantEmail: string;
+    assignee?: string;
+    tags: string[];
+    createdAt: Date;
+    updatedAt: Date;
+    resolvedAt?: Date;
+    closedAt?: Date;
+}
+interface TicketComment {
+    id: string;
+    ticketId: string;
+    author: string;
+    authorRole: 'merchant' | 'developer' | 'system';
+    content: string;
+    createdAt: Date;
+}
+interface TicketCreateInput {
+    subject: string;
+    description: string;
+    priority?: TicketPriority;
+    shopDomain: string;
+    merchantEmail: string;
+    tags?: string[];
+}
+interface TicketUpdateInput {
+    status?: TicketStatus;
+    priority?: TicketPriority;
+    assignee?: string;
+    tags?: string[];
+}
+interface TicketFilter {
+    status?: TicketStatus;
+    priority?: TicketPriority;
+    shopDomain?: string;
+    assignee?: string;
+    search?: string;
+}
+interface TicketListResult {
+    tickets: Ticket[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+interface TicketStats {
+    openCount: number;
+    inProgressCount: number;
+    resolvedCount: number;
+    avgResolutionTimeHours: number;
+}
+
+interface TicketDataSource {
+    create(input: TicketCreateInput): Promise<Ticket>;
+    getById(ticketId: string): Promise<Ticket | null>;
+    list(filter?: TicketFilter, page?: number, pageSize?: number): Promise<TicketListResult>;
+    update(ticketId: string, input: TicketUpdateInput): Promise<Ticket | null>;
+    addComment(ticketId: string, comment: Omit<TicketComment, 'id' | 'ticketId' | 'createdAt'>): Promise<TicketComment>;
+    getComments(ticketId: string): Promise<TicketComment[]>;
+    getStats(): Promise<TicketStats>;
+}
+
+declare class TicketService {
+    private readonly dataSource;
+    constructor(dataSource: TicketDataSource);
+    createTicket(input: TicketCreateInput): Promise<Ticket>;
+    getTicket(ticketId: string): Promise<Ticket | null>;
+    listTickets(filter?: TicketFilter, page?: number, pageSize?: number): Promise<TicketListResult>;
+    updateTicket(ticketId: string, input: TicketUpdateInput): Promise<Ticket | null>;
+    resolveTicket(ticketId: string): Promise<Ticket | null>;
+    closeTicket(ticketId: string): Promise<Ticket | null>;
+    assignTicket(ticketId: string, assignee: string): Promise<Ticket | null>;
+}
+
+declare class TicketCommentService {
+    private readonly dataSource;
+    constructor(dataSource: TicketDataSource);
+    addComment(ticketId: string, author: string, authorRole: TicketComment['authorRole'], content: string): Promise<TicketComment>;
+    getComments(ticketId: string): Promise<TicketComment[]>;
+}
+
+declare class TicketStatsService {
+    private readonly dataSource;
+    constructor(dataSource: TicketDataSource);
+    getStats(): Promise<TicketStats>;
+    getOpenTicketCount(): Promise<number>;
+}
+
+export { type Ticket, type TicketComment, TicketCommentService, type TicketCreateInput, type TicketDataSource, type TicketFilter, type TicketListResult, type TicketPriority, TicketService, type TicketStats, TicketStatsService, type TicketStatus, type TicketUpdateInput };

package/dist/tickets/index.d.ts

@@ -0,0 +1,96 @@
+type TicketPriority = 'low' | 'medium' | 'high' | 'urgent';
+type TicketStatus = 'open' | 'in_progress' | 'waiting_on_customer' | 'waiting_on_developer' | 'resolved' | 'closed';
+interface Ticket {
+    id: string;
+    subject: string;
+    description: string;
+    status: TicketStatus;
+    priority: TicketPriority;
+    shopDomain: string;
+    merchantEmail: string;
+    assignee?: string;
+    tags: string[];
+    createdAt: Date;
+    updatedAt: Date;
+    resolvedAt?: Date;
+    closedAt?: Date;
+}
+interface TicketComment {
+    id: string;
+    ticketId: string;
+    author: string;
+    authorRole: 'merchant' | 'developer' | 'system';
+    content: string;
+    createdAt: Date;
+}
+interface TicketCreateInput {
+    subject: string;
+    description: string;
+    priority?: TicketPriority;
+    shopDomain: string;
+    merchantEmail: string;
+    tags?: string[];
+}
+interface TicketUpdateInput {
+    status?: TicketStatus;
+    priority?: TicketPriority;
+    assignee?: string;
+    tags?: string[];
+}
+interface TicketFilter {
+    status?: TicketStatus;
+    priority?: TicketPriority;
+    shopDomain?: string;
+    assignee?: string;
+    search?: string;
+}
+interface TicketListResult {
+    tickets: Ticket[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+interface TicketStats {
+    openCount: number;
+    inProgressCount: number;
+    resolvedCount: number;
+    avgResolutionTimeHours: number;
+}
+
+interface TicketDataSource {
+    create(input: TicketCreateInput): Promise<Ticket>;
+    getById(ticketId: string): Promise<Ticket | null>;
+    list(filter?: TicketFilter, page?: number, pageSize?: number): Promise<TicketListResult>;
+    update(ticketId: string, input: TicketUpdateInput): Promise<Ticket | null>;
+    addComment(ticketId: string, comment: Omit<TicketComment, 'id' | 'ticketId' | 'createdAt'>): Promise<TicketComment>;
+    getComments(ticketId: string): Promise<TicketComment[]>;
+    getStats(): Promise<TicketStats>;
+}
+
+declare class TicketService {
+    private readonly dataSource;
+    constructor(dataSource: TicketDataSource);
+    createTicket(input: TicketCreateInput): Promise<Ticket>;
+    getTicket(ticketId: string): Promise<Ticket | null>;
+    listTickets(filter?: TicketFilter, page?: number, pageSize?: number): Promise<TicketListResult>;
+    updateTicket(ticketId: string, input: TicketUpdateInput): Promise<Ticket | null>;
+    resolveTicket(ticketId: string): Promise<Ticket | null>;
+    closeTicket(ticketId: string): Promise<Ticket | null>;
+    assignTicket(ticketId: string, assignee: string): Promise<Ticket | null>;
+}
+
+declare class TicketCommentService {
+    private readonly dataSource;
+    constructor(dataSource: TicketDataSource);
+    addComment(ticketId: string, author: string, authorRole: TicketComment['authorRole'], content: string): Promise<TicketComment>;
+    getComments(ticketId: string): Promise<TicketComment[]>;
+}
+
+declare class TicketStatsService {
+    private readonly dataSource;
+    constructor(dataSource: TicketDataSource);
+    getStats(): Promise<TicketStats>;
+    getOpenTicketCount(): Promise<number>;
+}
+
+export { type Ticket, type TicketComment, TicketCommentService, type TicketCreateInput, type TicketDataSource, type TicketFilter, type TicketListResult, type TicketPriority, TicketService, type TicketStats, TicketStatsService, type TicketStatus, type TicketUpdateInput };

package/dist/tickets/index.js

@@ -0,0 +1,102 @@
+"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/tickets/index.ts
+var tickets_exports = {};
+__export(tickets_exports, {
+  TicketCommentService: () => TicketCommentService,
+  TicketService: () => TicketService,
+  TicketStatsService: () => TicketStatsService
+});
+module.exports = __toCommonJS(tickets_exports);
+
+// src/tickets/ticket-service.ts
+var TicketService = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async createTicket(input) {
+    if (!input.subject.trim()) {
+      throw new Error("Ticket subject cannot be empty");
+    }
+    return this.dataSource.create(input);
+  }
+  async getTicket(ticketId) {
+    return this.dataSource.getById(ticketId);
+  }
+  async listTickets(filter, page = 1, pageSize = 20) {
+    return this.dataSource.list(filter, page, pageSize);
+  }
+  async updateTicket(ticketId, input) {
+    return this.dataSource.update(ticketId, input);
+  }
+  async resolveTicket(ticketId) {
+    return this.dataSource.update(ticketId, {
+      status: "resolved"
+    });
+  }
+  async closeTicket(ticketId) {
+    return this.dataSource.update(ticketId, {
+      status: "closed"
+    });
+  }
+  async assignTicket(ticketId, assignee) {
+    return this.dataSource.update(ticketId, { assignee });
+  }
+};
+
+// src/tickets/ticket-comment-service.ts
+var TicketCommentService = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async addComment(ticketId, author, authorRole, content) {
+    if (!content.trim()) {
+      throw new Error("Comment content cannot be empty");
+    }
+    return this.dataSource.addComment(ticketId, { author, authorRole, content });
+  }
+  async getComments(ticketId) {
+    return this.dataSource.getComments(ticketId);
+  }
+};
+
+// src/tickets/ticket-stats-service.ts
+var TicketStatsService = class {
+  dataSource;
+  constructor(dataSource) {
+    this.dataSource = dataSource;
+  }
+  async getStats() {
+    return this.dataSource.getStats();
+  }
+  async getOpenTicketCount() {
+    const stats = await this.dataSource.getStats();
+    return stats.openCount;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TicketCommentService,
+  TicketService,
+  TicketStatsService
+});
+//# sourceMappingURL=index.js.map