@pattern-stack/codegen 0.4.4 → 0.4.6

package/dist/runtime/subsystems/observability/observability.memory-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/observability/observability.memory-backend.ts"],"sourcesContent":["/**\n * MemoryObservabilityService — in-memory test backend for\n * IObservabilityService.\n *\n * Stores snapshot data set by the test harness and returns it verbatim.\n * This is deliberately NOT a replay-from-events simulator — the point of\n * the memory backend is to let tests assert \"when the subsystem returns\n * X, does the caller render Y correctly?\" without standing up Postgres.\n *\n * Tests populate the backend via the `seed*` methods, then exercise the\n * protocol reads. Each seed method replaces (not merges) its slice, which\n * keeps the mental model simple: the backend is a fixture holder.\n *\n * No lifecycle hooks (no background work to manage).\n */\nimport { Injectable } from '@nestjs/common';\nimport type {\n  CursorSnapshot,\n  IObservabilityService,\n  JobRunFailure,\n  PoolDepth,\n  StatusHistogram,\n  SyncRunSummary,\n} from './observability.protocol';\n\n@Injectable()\nexport class MemoryObservabilityService implements IObservabilityService {\n  private pools: PoolDepth[] = [];\n  private syncRuns: SyncRunSummary[] = [];\n  private bridgeHistogram: StatusHistogram = {};\n  private failedJobs: JobRunFailure[] = [];\n  private cursors: CursorSnapshot[] = [];\n\n  // ─── Core contract ─────────────────────────────────────────────────────\n\n  async getPoolDepths(): Promise<PoolDepth[]> {\n    return [...this.pools];\n  }\n\n  async getRecentSyncRuns(\n    limit: number,\n    integrationId?: string,\n  ): Promise<SyncRunSummary[]> {\n    const filtered =\n      integrationId !== undefined\n        ? this.syncRuns.filter((r) => r.integrationId === integrationId)\n        : this.syncRuns;\n    return filtered\n      .slice()\n      .sort((a, b) => b.startedAt.getTime() - a.startedAt.getTime())\n      .slice(0, limit);\n  }\n\n  async getBridgeDeliveryHistogram(\n    _windowHours: number,\n  ): Promise<StatusHistogram> {\n    // Memory backend ignores the window — tests that care about windowing\n    // should seed the histogram for the window they're simulating.\n    return { ...this.bridgeHistogram };\n  }\n\n  async getRecentFailedJobs(limit: number): Promise<JobRunFailure[]> {\n    return this.failedJobs\n      .slice()\n      .sort(\n        (a, b) =>\n          (b.finishedAt?.getTime() ?? 0) - (a.finishedAt?.getTime() ?? 0),\n      )\n      .slice(0, limit);\n  }\n\n  async getCursors(): Promise<CursorSnapshot[]> {\n    return [...this.cursors];\n  }\n\n  // ─── Test seams ────────────────────────────────────────────────────────\n\n  /** Replace the pool-depth slice. */\n  seedPools(pools: PoolDepth[]): void {\n    this.pools = [...pools];\n  }\n\n  /** Replace the sync-run slice. */\n  seedSyncRuns(runs: SyncRunSummary[]): void {\n    this.syncRuns = [...runs];\n  }\n\n  /** Replace the bridge-delivery histogram. */\n  seedBridgeHistogram(hist: StatusHistogram): void {\n    this.bridgeHistogram = { ...hist };\n  }\n\n  /** Replace the failed-jobs slice. */\n  seedFailedJobs(jobs: JobRunFailure[]): void {\n    this.failedJobs = [...jobs];\n  }\n\n  /** Replace the cursor slice. */\n  seedCursors(cursors: CursorSnapshot[]): void {\n    this.cursors = [...cursors];\n  }\n\n  /** Reset every slice — for afterEach hooks. */\n  reset(): void {\n    this.pools = [];\n    this.syncRuns = [];\n    this.bridgeHistogram = {};\n    this.failedJobs = [];\n    this.cursors = [];\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAeA,SAAS,kBAAkB;AAWpB,IAAM,6BAAN,MAAkE;AAAA,EAC/D,QAAqB,CAAC;AAAA,EACtB,WAA6B,CAAC;AAAA,EAC9B,kBAAmC,CAAC;AAAA,EACpC,aAA8B,CAAC;AAAA,EAC/B,UAA4B,CAAC;AAAA;AAAA,EAIrC,MAAM,gBAAsC;AAC1C,WAAO,CAAC,GAAG,KAAK,KAAK;AAAA,EACvB;AAAA,EAEA,MAAM,kBACJ,OACA,eAC2B;AAC3B,UAAM,WACJ,kBAAkB,SACd,KAAK,SAAS,OAAO,CAAC,MAAM,EAAE,kBAAkB,aAAa,IAC7D,KAAK;AACX,WAAO,SACJ,MAAM,EACN,KAAK,CAAC,GAAG,MAAM,EAAE,UAAU,QAAQ,IAAI,EAAE,UAAU,QAAQ,CAAC,EAC5D,MAAM,GAAG,KAAK;AAAA,EACnB;AAAA,EAEA,MAAM,2BACJ,cAC0B;AAG1B,WAAO,EAAE,GAAG,KAAK,gBAAgB;AAAA,EACnC;AAAA,EAEA,MAAM,oBAAoB,OAAyC;AACjE,WAAO,KAAK,WACT,MAAM,EACN;AAAA,MACC,CAAC,GAAG,OACD,EAAE,YAAY,QAAQ,KAAK,MAAM,EAAE,YAAY,QAAQ,KAAK;AAAA,IACjE,EACC,MAAM,GAAG,KAAK;AAAA,EACnB;AAAA,EAEA,MAAM,aAAwC;AAC5C,WAAO,CAAC,GAAG,KAAK,OAAO;AAAA,EACzB;AAAA;AAAA;AAAA,EAKA,UAAU,OAA0B;AAClC,SAAK,QAAQ,CAAC,GAAG,KAAK;AAAA,EACxB;AAAA;AAAA,EAGA,aAAa,MAA8B;AACzC,SAAK,WAAW,CAAC,GAAG,IAAI;AAAA,EAC1B;AAAA;AAAA,EAGA,oBAAoB,MAA6B;AAC/C,SAAK,kBAAkB,EAAE,GAAG,KAAK;AAAA,EACnC;AAAA;AAAA,EAGA,eAAe,MAA6B;AAC1C,SAAK,aAAa,CAAC,GAAG,IAAI;AAAA,EAC5B;AAAA;AAAA,EAGA,YAAY,SAAiC;AAC3C,SAAK,UAAU,CAAC,GAAG,OAAO;AAAA,EAC5B;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,QAAQ,CAAC;AACd,SAAK,WAAW,CAAC;AACjB,SAAK,kBAAkB,CAAC;AACxB,SAAK,aAAa,CAAC;AACnB,SAAK,UAAU,CAAC;AAAA,EAClB;AACF;AApFa,6BAAN;AAAA,EADN,WAAW;AAAA,GACC;","names":[]}

package/dist/runtime/subsystems/observability/observability.module.d.ts

@@ -0,0 +1,56 @@
+import { DynamicModule } from '@nestjs/common';
+
+/**
+ * ObservabilityModule — DynamicModule factory for the observability
+ * subsystem (ADR-008, 5th subsystem).
+ *
+ * Usage in AppModule:
+ * ```typescript
+ * ObservabilityModule.forRoot({
+ *   backend: 'drizzle',
+ *   reporters: { bridgeMetrics: true }, // optional — requires bridge subsystem
+ * })
+ * ```
+ *
+ * Usage in tests:
+ * ```typescript
+ * ObservabilityModule.forRoot({ backend: 'memory' })
+ * ```
+ *
+ * `global: true` means any module that needs `IObservabilityService` can
+ * inject `OBSERVABILITY` without importing this module. Register once in
+ * AppModule.
+ *
+ * The drizzle backend requires `DRIZZLE` to be provided globally (e.g.,
+ * via DatabaseModule). The memory backend has no dependencies.
+ *
+ * # Reporters
+ *
+ * Reporters are orthogonal to backends — they compose on top of either
+ * drizzle or memory. The `reporters.bridgeMetrics` flag enables the
+ * `BridgeMetricsReporter` sampler. Gated because the reporter imports the
+ * bridge + events schemas; consumers without the bridge subsystem should
+ * leave it off (the default).
+ *
+ * `ScheduleModule.forRoot()` is imported conditionally — only when a
+ * reporter that needs it is enabled. Keeps the module dependency-light
+ * for consumers that only want the read surface.
+ */
+
+interface ObservabilityReporterOptions {
+    /**
+     * Register `BridgeMetricsReporter` — periodic log sampler over
+     * `bridge_delivery`. Requires the bridge subsystem (schemas imported
+     * transitively). Defaults to `false`.
+     */
+    bridgeMetrics?: boolean;
+}
+interface ObservabilityModuleOptions {
+    backend: 'drizzle' | 'memory';
+    reporters?: ObservabilityReporterOptions;
+}
+declare class ObservabilityModule {
+    static forRoot(options?: ObservabilityModuleOptions): DynamicModule;
+}
+
+export { ObservabilityModule, type ObservabilityModuleOptions, type ObservabilityReporterOptions };