@pattern-stack/codegen 0.2.0

package/dist/runtime/subsystems/analytics/analytics-query.protocol.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Analytics subsystem — protocol (port)
+ *
+ * IAnalyticsQuery is the hexagonal port. Services inject this interface via
+ * the ANALYTICS_QUERY token. They never depend on a specific backend
+ * implementation (cube.js, noop, etc.).
+ */
+interface ResultRow {
+    [key: string]: any;
+}
+interface AnalyticsQueryOpts {
+    /** Include raw entity IDs in the result set. */
+    withIds?: boolean;
+    /** Maximum number of rows to return. */
+    limit?: number;
+}
+interface IAnalyticsQuery {
+    /**
+     * Execute an analytics query against the semantic layer.
+     *
+     * @param cube - Cube name (e.g., 'Orders')
+     * @param measures - Measure names (e.g., ['totalRevenue'])
+     * @param dimensions - Dimension names (e.g., ['status', 'createdAt'])
+     * @param where - Optional filter conditions
+     * @param opts - Query options (limit, withIds)
+     */
+    execute(cube: string, measures: string[], dimensions: string[], where?: Record<string, any>, opts?: AnalyticsQueryOpts): Promise<ResultRow[]>;
+}
+
+export type { AnalyticsQueryOpts, IAnalyticsQuery, ResultRow };

package/dist/runtime/subsystems/analytics/analytics-query.protocol.js

@@ -0,0 +1 @@
+//# sourceMappingURL=analytics-query.protocol.js.map

package/dist/runtime/subsystems/analytics/analytics-query.protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,34 @@
+import { DynamicModule } from '@nestjs/common';
+
+/**
+ * AnalyticsModule — DynamicModule factory for the analytics query subsystem.
+ *
+ * Register once in AppModule:
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     AnalyticsModule.forRoot({ backend: 'cube' }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * Tests swap to the noop backend without touching application code:
+ * ```typescript
+ * Test.createTestingModule({
+ *   imports: [AnalyticsModule.forRoot({ backend: 'noop' })],
+ * });
+ * ```
+ *
+ * `global: true` means entity modules do not need to import AnalyticsModule
+ * individually — the ANALYTICS_QUERY token is available project-wide.
+ */
+
+interface AnalyticsModuleOptions {
+    backend: 'cube' | 'noop';
+}
+declare class AnalyticsModule {
+    static forRoot(options?: AnalyticsModuleOptions): DynamicModule;
+}
+
+export { AnalyticsModule, type AnalyticsModuleOptions };

package/dist/runtime/subsystems/analytics/analytics.module.js

@@ -0,0 +1,117 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// runtime/subsystems/analytics/analytics.module.ts
+import { Module } from "@nestjs/common";
+
+// runtime/subsystems/analytics/analytics.tokens.ts
+var ANALYTICS_QUERY = "ANALYTICS_QUERY";
+var CUBE_API_URL = /* @__PURE__ */ Symbol("CUBE_API_URL");
+var CUBE_API_SECRET = /* @__PURE__ */ Symbol("CUBE_API_SECRET");
+
+// runtime/subsystems/analytics/cube-backend.ts
+import { Inject, Injectable, Logger } from "@nestjs/common";
+var CubeAnalyticsBackend = class {
+  constructor(apiUrl, apiSecret) {
+    this.apiUrl = apiUrl;
+    this.apiSecret = apiSecret;
+  }
+  apiUrl;
+  apiSecret;
+  logger = new Logger(CubeAnalyticsBackend.name);
+  cubejsApi;
+  async onModuleInit() {
+    try {
+      const { default: cubejs } = await import("@cubejs-client/core");
+      this.cubejsApi = cubejs(this.apiSecret, { apiUrl: this.apiUrl });
+    } catch {
+      throw new Error(
+        "CubeAnalyticsBackend requires @cubejs-client/core. Install it: bun add @cubejs-client/core"
+      );
+    }
+  }
+  async execute(cube, measures, dimensions, where, opts) {
+    if (!this.cubejsApi) {
+      this.logger.warn("Cube.js client not initialized \u2014 returning empty result");
+      return [];
+    }
+    const query = {
+      measures: measures.map((m) => cube + "." + m),
+      dimensions: dimensions.map((d) => cube + "." + d)
+    };
+    if (where && Object.keys(where).length > 0) {
+      query.filters = Object.entries(where).map(([member, value]) => ({
+        member: cube + "." + member,
+        operator: "equals",
+        values: Array.isArray(value) ? value : [String(value)]
+      }));
+    }
+    if (opts?.limit) {
+      query.limit = opts.limit;
+    }
+    const resultSet = await this.cubejsApi.load(query);
+    return resultSet.tablePivot();
+  }
+};
+CubeAnalyticsBackend = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(CUBE_API_URL)),
+  __decorateParam(1, Inject(CUBE_API_SECRET))
+], CubeAnalyticsBackend);
+
+// runtime/subsystems/analytics/noop-backend.ts
+import { Injectable as Injectable2 } from "@nestjs/common";
+var NoopAnalyticsBackend = class {
+  async execute(_cube, _measures, _dimensions, _where, _opts) {
+    return [];
+  }
+};
+NoopAnalyticsBackend = __decorateClass([
+  Injectable2()
+], NoopAnalyticsBackend);
+
+// runtime/subsystems/analytics/analytics.module.ts
+var AnalyticsModule = class {
+  static forRoot(options = { backend: "noop" }) {
+    if (options.backend === "cube") {
+      return {
+        module: AnalyticsModule,
+        global: true,
+        providers: [
+          {
+            provide: CUBE_API_URL,
+            useValue: process.env["CUBE_API_URL"] ?? "http://localhost:4000/cubejs-api/v1"
+          },
+          {
+            provide: CUBE_API_SECRET,
+            useValue: process.env["CUBE_API_SECRET"] ?? ""
+          },
+          { provide: ANALYTICS_QUERY, useClass: CubeAnalyticsBackend }
+        ],
+        exports: [ANALYTICS_QUERY]
+      };
+    }
+    return {
+      module: AnalyticsModule,
+      global: true,
+      providers: [{ provide: ANALYTICS_QUERY, useClass: NoopAnalyticsBackend }],
+      exports: [ANALYTICS_QUERY]
+    };
+  }
+};
+AnalyticsModule = __decorateClass([
+  Module({})
+], AnalyticsModule);
+export {
+  AnalyticsModule
+};
+//# sourceMappingURL=analytics.module.js.map

package/dist/runtime/subsystems/analytics/analytics.module.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/analytics/analytics.module.ts","../../../../runtime/subsystems/analytics/analytics.tokens.ts","../../../../runtime/subsystems/analytics/cube-backend.ts","../../../../runtime/subsystems/analytics/noop-backend.ts"],"sourcesContent":["/**\n * AnalyticsModule — DynamicModule factory for the analytics query subsystem.\n *\n * Register once in AppModule:\n * ```typescript\n * @Module({\n *   imports: [\n *     AnalyticsModule.forRoot({ backend: 'cube' }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n *\n * Tests swap to the noop backend without touching application code:\n * ```typescript\n * Test.createTestingModule({\n *   imports: [AnalyticsModule.forRoot({ backend: 'noop' })],\n * });\n * ```\n *\n * `global: true` means entity modules do not need to import AnalyticsModule\n * individually — the ANALYTICS_QUERY token is available project-wide.\n */\nimport { Module, type DynamicModule } from '@nestjs/common';\nimport { ANALYTICS_QUERY, CUBE_API_URL, CUBE_API_SECRET } from './analytics.tokens';\nimport { CubeAnalyticsBackend } from './cube-backend';\nimport { NoopAnalyticsBackend } from './noop-backend';\n\nexport interface AnalyticsModuleOptions {\n  backend: 'cube' | 'noop';\n}\n\n@Module({})\nexport class AnalyticsModule {\n  static forRoot(\n    options: AnalyticsModuleOptions = { backend: 'noop' },\n  ): DynamicModule {\n    if (options.backend === 'cube') {\n      return {\n        module: AnalyticsModule,\n        global: true,\n        providers: [\n          {\n            provide: CUBE_API_URL,\n            useValue: process.env['CUBE_API_URL'] ?? 'http://localhost:4000/cubejs-api/v1',\n          },\n          {\n            provide: CUBE_API_SECRET,\n            useValue: process.env['CUBE_API_SECRET'] ?? '',\n          },\n          { provide: ANALYTICS_QUERY, useClass: CubeAnalyticsBackend },\n        ],\n        exports: [ANALYTICS_QUERY],\n      };\n    }\n\n    return {\n      module: AnalyticsModule,\n      global: true,\n      providers: [{ provide: ANALYTICS_QUERY, useClass: NoopAnalyticsBackend }],\n      exports: [ANALYTICS_QUERY],\n    };\n  }\n}\n","/**\n * Injection tokens for the analytics subsystem.\n *\n * String constants (not Symbols) so they match by value across import\n * boundaries — same convention as events.tokens.ts.\n *\n * Usage in services:\n * ```typescript\n * constructor(@Inject(ANALYTICS_QUERY) private readonly analytics: IAnalyticsQuery) {}\n * ```\n */\nexport const ANALYTICS_QUERY = 'ANALYTICS_QUERY' as const;\n\n/**\n * Injection token for the cube.js API URL.\n * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nexport const CUBE_API_URL = Symbol('CUBE_API_URL');\n\n/**\n * Injection token for the cube.js API secret.\n * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nexport const CUBE_API_SECRET = Symbol('CUBE_API_SECRET');\n","/**\n * CubeAnalyticsBackend — cube.js backend for the analytics query port.\n *\n * Connects to a running cube.js instance via @cubejs-client/core and\n * translates IAnalyticsQuery calls into cube.js query objects.\n *\n * @cubejs-client/core is an optional peer dependency; lazy-imported so\n * the module loads even if the package isn't installed. Consumers who\n * use the cube backend must install it separately:\n *   bun add @cubejs-client/core\n *\n * Provided by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nimport { Inject, Injectable, OnModuleInit, Logger } from '@nestjs/common';\nimport { CUBE_API_URL, CUBE_API_SECRET } from './analytics.tokens';\nimport type {\n  AnalyticsQueryOpts,\n  IAnalyticsQuery,\n  ResultRow,\n} from './analytics-query.protocol';\n\n@Injectable()\nexport class CubeAnalyticsBackend implements IAnalyticsQuery, OnModuleInit {\n  private readonly logger = new Logger(CubeAnalyticsBackend.name);\n  private cubejsApi: any;\n\n  constructor(\n    @Inject(CUBE_API_URL) private readonly apiUrl: string,\n    @Inject(CUBE_API_SECRET) private readonly apiSecret: string,\n  ) {}\n\n  async onModuleInit(): Promise<void> {\n    try {\n      const { default: cubejs } = await import('@cubejs-client/core');\n      this.cubejsApi = cubejs(this.apiSecret, { apiUrl: this.apiUrl });\n    } catch {\n      throw new Error(\n        'CubeAnalyticsBackend requires @cubejs-client/core. Install it: bun add @cubejs-client/core',\n      );\n    }\n  }\n\n  async execute(\n    cube: string,\n    measures: string[],\n    dimensions: string[],\n    where?: Record<string, any>,\n    opts?: AnalyticsQueryOpts,\n  ): Promise<ResultRow[]> {\n    if (!this.cubejsApi) {\n      this.logger.warn('Cube.js client not initialized — returning empty result');\n      return [];\n    }\n\n    const query: Record<string, any> = {\n      measures: measures.map((m) => cube + '.' + m),\n      dimensions: dimensions.map((d) => cube + '.' + d),\n    };\n\n    if (where && Object.keys(where).length > 0) {\n      query.filters = Object.entries(where).map(([member, value]) => ({\n        member: cube + '.' + member,\n        operator: 'equals',\n        values: Array.isArray(value) ? value : [String(value)],\n      }));\n    }\n\n    if (opts?.limit) {\n      query.limit = opts.limit;\n    }\n\n    const resultSet = await this.cubejsApi.load(query);\n    return resultSet.tablePivot() as ResultRow[];\n  }\n}\n","/**\n * NoopAnalyticsBackend — no-op backend for the analytics query port.\n *\n * Returns empty arrays for all queries. Use this backend when analytics\n * is disabled or in tests that don't need real analytics data.\n *\n * Provided by AnalyticsModule.forRoot({ backend: 'noop' }).\n */\nimport { Injectable } from '@nestjs/common';\nimport type {\n  AnalyticsQueryOpts,\n  IAnalyticsQuery,\n  ResultRow,\n} from './analytics-query.protocol';\n\n@Injectable()\nexport class NoopAnalyticsBackend implements IAnalyticsQuery {\n  async execute(\n    _cube: string,\n    _measures: string[],\n    _dimensions: string[],\n    _where?: Record<string, any>,\n    _opts?: AnalyticsQueryOpts,\n  ): Promise<ResultRow[]> {\n    return [];\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAuBA,SAAS,cAAkC;;;ACZpC,IAAM,kBAAkB;AAMxB,IAAM,eAAe,uBAAO,cAAc;AAM1C,IAAM,kBAAkB,uBAAO,iBAAiB;;;ACVvD,SAAS,QAAQ,YAA0B,cAAc;AASlD,IAAM,uBAAN,MAAoE;AAAA,EAIzE,YACyC,QACG,WAC1C;AAFuC;AACG;AAAA,EACzC;AAAA,EAFsC;AAAA,EACG;AAAA,EAL3B,SAAS,IAAI,OAAO,qBAAqB,IAAI;AAAA,EACtD;AAAA,EAOR,MAAM,eAA8B;AAClC,QAAI;AACF,YAAM,EAAE,SAAS,OAAO,IAAI,MAAM,OAAO,qBAAqB;AAC9D,WAAK,YAAY,OAAO,KAAK,WAAW,EAAE,QAAQ,KAAK,OAAO,CAAC;AAAA,IACjE,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,QACJ,MACA,UACA,YACA,OACA,MACsB;AACtB,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,OAAO,KAAK,8DAAyD;AAC1E,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,QAA6B;AAAA,MACjC,UAAU,SAAS,IAAI,CAAC,MAAM,OAAO,MAAM,CAAC;AAAA,MAC5C,YAAY,WAAW,IAAI,CAAC,MAAM,OAAO,MAAM,CAAC;AAAA,IAClD;AAEA,QAAI,SAAS,OAAO,KAAK,KAAK,EAAE,SAAS,GAAG;AAC1C,YAAM,UAAU,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;AAAA,QAC9D,QAAQ,OAAO,MAAM;AAAA,QACrB,UAAU;AAAA,QACV,QAAQ,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC;AAAA,MACvD,EAAE;AAAA,IACJ;AAEA,QAAI,MAAM,OAAO;AACf,YAAM,QAAQ,KAAK;AAAA,IACrB;AAEA,UAAM,YAAY,MAAM,KAAK,UAAU,KAAK,KAAK;AACjD,WAAO,UAAU,WAAW;AAAA,EAC9B;AACF;AApDa,uBAAN;AAAA,EADN,WAAW;AAAA,EAMP,0BAAO,YAAY;AAAA,EACnB,0BAAO,eAAe;AAAA,GANd;;;ACdb,SAAS,cAAAA,mBAAkB;AAQpB,IAAM,uBAAN,MAAsD;AAAA,EAC3D,MAAM,QACJ,OACA,WACA,aACA,QACA,OACsB;AACtB,WAAO,CAAC;AAAA,EACV;AACF;AAVa,uBAAN;AAAA,EADNC,YAAW;AAAA,GACC;;;AHiBN,IAAM,kBAAN,MAAsB;AAAA,EAC3B,OAAO,QACL,UAAkC,EAAE,SAAS,OAAO,GACrC;AACf,QAAI,QAAQ,YAAY,QAAQ;AAC9B,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ;AAAA,QACR,WAAW;AAAA,UACT;AAAA,YACE,SAAS;AAAA,YACT,UAAU,QAAQ,IAAI,cAAc,KAAK;AAAA,UAC3C;AAAA,UACA;AAAA,YACE,SAAS;AAAA,YACT,UAAU,QAAQ,IAAI,iBAAiB,KAAK;AAAA,UAC9C;AAAA,UACA,EAAE,SAAS,iBAAiB,UAAU,qBAAqB;AAAA,QAC7D;AAAA,QACA,SAAS,CAAC,eAAe;AAAA,MAC3B;AAAA,IACF;AAEA,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,WAAW,CAAC,EAAE,SAAS,iBAAiB,UAAU,qBAAqB,CAAC;AAAA,MACxE,SAAS,CAAC,eAAe;AAAA,IAC3B;AAAA,EACF;AACF;AA9Ba,kBAAN;AAAA,EADN,OAAO,CAAC,CAAC;AAAA,GACG;","names":["Injectable","Injectable"]}

package/dist/runtime/subsystems/analytics/analytics.tokens.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Injection tokens for the analytics subsystem.
+ *
+ * String constants (not Symbols) so they match by value across import
+ * boundaries — same convention as events.tokens.ts.
+ *
+ * Usage in services:
+ * ```typescript
+ * constructor(@Inject(ANALYTICS_QUERY) private readonly analytics: IAnalyticsQuery) {}
+ * ```
+ */
+declare const ANALYTICS_QUERY: "ANALYTICS_QUERY";
+/**
+ * Injection token for the cube.js API URL.
+ * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).
+ */
+declare const CUBE_API_URL: unique symbol;
+/**
+ * Injection token for the cube.js API secret.
+ * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).
+ */
+declare const CUBE_API_SECRET: unique symbol;
+
+export { ANALYTICS_QUERY, CUBE_API_SECRET, CUBE_API_URL };

package/dist/runtime/subsystems/analytics/analytics.tokens.js

@@ -0,0 +1,10 @@
+// runtime/subsystems/analytics/analytics.tokens.ts
+var ANALYTICS_QUERY = "ANALYTICS_QUERY";
+var CUBE_API_URL = /* @__PURE__ */ Symbol("CUBE_API_URL");
+var CUBE_API_SECRET = /* @__PURE__ */ Symbol("CUBE_API_SECRET");
+export {
+  ANALYTICS_QUERY,
+  CUBE_API_SECRET,
+  CUBE_API_URL
+};
+//# sourceMappingURL=analytics.tokens.js.map

package/dist/runtime/subsystems/analytics/analytics.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/analytics/analytics.tokens.ts"],"sourcesContent":["/**\n * Injection tokens for the analytics subsystem.\n *\n * String constants (not Symbols) so they match by value across import\n * boundaries — same convention as events.tokens.ts.\n *\n * Usage in services:\n * ```typescript\n * constructor(@Inject(ANALYTICS_QUERY) private readonly analytics: IAnalyticsQuery) {}\n * ```\n */\nexport const ANALYTICS_QUERY = 'ANALYTICS_QUERY' as const;\n\n/**\n * Injection token for the cube.js API URL.\n * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nexport const CUBE_API_URL = Symbol('CUBE_API_URL');\n\n/**\n * Injection token for the cube.js API secret.\n * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nexport const CUBE_API_SECRET = Symbol('CUBE_API_SECRET');\n"],"mappings":";AAWO,IAAM,kBAAkB;AAMxB,IAAM,eAAe,uBAAO,cAAc;AAM1C,IAAM,kBAAkB,uBAAO,iBAAiB;","names":[]}

package/dist/runtime/subsystems/analytics/cube-backend.d.ts

@@ -0,0 +1,28 @@
+import { OnModuleInit } from '@nestjs/common';
+import { IAnalyticsQuery, AnalyticsQueryOpts, ResultRow } from './analytics-query.protocol.js';
+
+/**
+ * CubeAnalyticsBackend — cube.js backend for the analytics query port.
+ *
+ * Connects to a running cube.js instance via @cubejs-client/core and
+ * translates IAnalyticsQuery calls into cube.js query objects.
+ *
+ * @cubejs-client/core is an optional peer dependency; lazy-imported so
+ * the module loads even if the package isn't installed. Consumers who
+ * use the cube backend must install it separately:
+ *   bun add @cubejs-client/core
+ *
+ * Provided by AnalyticsModule.forRoot({ backend: 'cube' }).
+ */
+
+declare class CubeAnalyticsBackend implements IAnalyticsQuery, OnModuleInit {
+    private readonly apiUrl;
+    private readonly apiSecret;
+    private readonly logger;
+    private cubejsApi;
+    constructor(apiUrl: string, apiSecret: string);
+    onModuleInit(): Promise<void>;
+    execute(cube: string, measures: string[], dimensions: string[], where?: Record<string, any>, opts?: AnalyticsQueryOpts): Promise<ResultRow[]>;
+}
+
+export { CubeAnalyticsBackend };

package/dist/runtime/subsystems/analytics/cube-backend.js

@@ -0,0 +1,71 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// runtime/subsystems/analytics/cube-backend.ts
+import { Inject, Injectable, Logger } from "@nestjs/common";
+
+// runtime/subsystems/analytics/analytics.tokens.ts
+var CUBE_API_URL = /* @__PURE__ */ Symbol("CUBE_API_URL");
+var CUBE_API_SECRET = /* @__PURE__ */ Symbol("CUBE_API_SECRET");
+
+// runtime/subsystems/analytics/cube-backend.ts
+var CubeAnalyticsBackend = class {
+  constructor(apiUrl, apiSecret) {
+    this.apiUrl = apiUrl;
+    this.apiSecret = apiSecret;
+  }
+  apiUrl;
+  apiSecret;
+  logger = new Logger(CubeAnalyticsBackend.name);
+  cubejsApi;
+  async onModuleInit() {
+    try {
+      const { default: cubejs } = await import("@cubejs-client/core");
+      this.cubejsApi = cubejs(this.apiSecret, { apiUrl: this.apiUrl });
+    } catch {
+      throw new Error(
+        "CubeAnalyticsBackend requires @cubejs-client/core. Install it: bun add @cubejs-client/core"
+      );
+    }
+  }
+  async execute(cube, measures, dimensions, where, opts) {
+    if (!this.cubejsApi) {
+      this.logger.warn("Cube.js client not initialized \u2014 returning empty result");
+      return [];
+    }
+    const query = {
+      measures: measures.map((m) => cube + "." + m),
+      dimensions: dimensions.map((d) => cube + "." + d)
+    };
+    if (where && Object.keys(where).length > 0) {
+      query.filters = Object.entries(where).map(([member, value]) => ({
+        member: cube + "." + member,
+        operator: "equals",
+        values: Array.isArray(value) ? value : [String(value)]
+      }));
+    }
+    if (opts?.limit) {
+      query.limit = opts.limit;
+    }
+    const resultSet = await this.cubejsApi.load(query);
+    return resultSet.tablePivot();
+  }
+};
+CubeAnalyticsBackend = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(CUBE_API_URL)),
+  __decorateParam(1, Inject(CUBE_API_SECRET))
+], CubeAnalyticsBackend);
+export {
+  CubeAnalyticsBackend
+};
+//# sourceMappingURL=cube-backend.js.map

package/dist/runtime/subsystems/analytics/cube-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/analytics/cube-backend.ts","../../../../runtime/subsystems/analytics/analytics.tokens.ts"],"sourcesContent":["/**\n * CubeAnalyticsBackend — cube.js backend for the analytics query port.\n *\n * Connects to a running cube.js instance via @cubejs-client/core and\n * translates IAnalyticsQuery calls into cube.js query objects.\n *\n * @cubejs-client/core is an optional peer dependency; lazy-imported so\n * the module loads even if the package isn't installed. Consumers who\n * use the cube backend must install it separately:\n *   bun add @cubejs-client/core\n *\n * Provided by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nimport { Inject, Injectable, OnModuleInit, Logger } from '@nestjs/common';\nimport { CUBE_API_URL, CUBE_API_SECRET } from './analytics.tokens';\nimport type {\n  AnalyticsQueryOpts,\n  IAnalyticsQuery,\n  ResultRow,\n} from './analytics-query.protocol';\n\n@Injectable()\nexport class CubeAnalyticsBackend implements IAnalyticsQuery, OnModuleInit {\n  private readonly logger = new Logger(CubeAnalyticsBackend.name);\n  private cubejsApi: any;\n\n  constructor(\n    @Inject(CUBE_API_URL) private readonly apiUrl: string,\n    @Inject(CUBE_API_SECRET) private readonly apiSecret: string,\n  ) {}\n\n  async onModuleInit(): Promise<void> {\n    try {\n      const { default: cubejs } = await import('@cubejs-client/core');\n      this.cubejsApi = cubejs(this.apiSecret, { apiUrl: this.apiUrl });\n    } catch {\n      throw new Error(\n        'CubeAnalyticsBackend requires @cubejs-client/core. Install it: bun add @cubejs-client/core',\n      );\n    }\n  }\n\n  async execute(\n    cube: string,\n    measures: string[],\n    dimensions: string[],\n    where?: Record<string, any>,\n    opts?: AnalyticsQueryOpts,\n  ): Promise<ResultRow[]> {\n    if (!this.cubejsApi) {\n      this.logger.warn('Cube.js client not initialized — returning empty result');\n      return [];\n    }\n\n    const query: Record<string, any> = {\n      measures: measures.map((m) => cube + '.' + m),\n      dimensions: dimensions.map((d) => cube + '.' + d),\n    };\n\n    if (where && Object.keys(where).length > 0) {\n      query.filters = Object.entries(where).map(([member, value]) => ({\n        member: cube + '.' + member,\n        operator: 'equals',\n        values: Array.isArray(value) ? value : [String(value)],\n      }));\n    }\n\n    if (opts?.limit) {\n      query.limit = opts.limit;\n    }\n\n    const resultSet = await this.cubejsApi.load(query);\n    return resultSet.tablePivot() as ResultRow[];\n  }\n}\n","/**\n * Injection tokens for the analytics subsystem.\n *\n * String constants (not Symbols) so they match by value across import\n * boundaries — same convention as events.tokens.ts.\n *\n * Usage in services:\n * ```typescript\n * constructor(@Inject(ANALYTICS_QUERY) private readonly analytics: IAnalyticsQuery) {}\n * ```\n */\nexport const ANALYTICS_QUERY = 'ANALYTICS_QUERY' as const;\n\n/**\n * Injection token for the cube.js API URL.\n * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nexport const CUBE_API_URL = Symbol('CUBE_API_URL');\n\n/**\n * Injection token for the cube.js API secret.\n * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nexport const CUBE_API_SECRET = Symbol('CUBE_API_SECRET');\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAS,QAAQ,YAA0B,cAAc;;;ACIlD,IAAM,eAAe,uBAAO,cAAc;AAM1C,IAAM,kBAAkB,uBAAO,iBAAiB;;;ADDhD,IAAM,uBAAN,MAAoE;AAAA,EAIzE,YACyC,QACG,WAC1C;AAFuC;AACG;AAAA,EACzC;AAAA,EAFsC;AAAA,EACG;AAAA,EAL3B,SAAS,IAAI,OAAO,qBAAqB,IAAI;AAAA,EACtD;AAAA,EAOR,MAAM,eAA8B;AAClC,QAAI;AACF,YAAM,EAAE,SAAS,OAAO,IAAI,MAAM,OAAO,qBAAqB;AAC9D,WAAK,YAAY,OAAO,KAAK,WAAW,EAAE,QAAQ,KAAK,OAAO,CAAC;AAAA,IACjE,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,QACJ,MACA,UACA,YACA,OACA,MACsB;AACtB,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,OAAO,KAAK,8DAAyD;AAC1E,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,QAA6B;AAAA,MACjC,UAAU,SAAS,IAAI,CAAC,MAAM,OAAO,MAAM,CAAC;AAAA,MAC5C,YAAY,WAAW,IAAI,CAAC,MAAM,OAAO,MAAM,CAAC;AAAA,IAClD;AAEA,QAAI,SAAS,OAAO,KAAK,KAAK,EAAE,SAAS,GAAG;AAC1C,YAAM,UAAU,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;AAAA,QAC9D,QAAQ,OAAO,MAAM;AAAA,QACrB,UAAU;AAAA,QACV,QAAQ,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC;AAAA,MACvD,EAAE;AAAA,IACJ;AAEA,QAAI,MAAM,OAAO;AACf,YAAM,QAAQ,KAAK;AAAA,IACrB;AAEA,UAAM,YAAY,MAAM,KAAK,UAAU,KAAK,KAAK;AACjD,WAAO,UAAU,WAAW;AAAA,EAC9B;AACF;AApDa,uBAAN;AAAA,EADN,WAAW;AAAA,EAMP,0BAAO,YAAY;AAAA,EACnB,0BAAO,eAAe;AAAA,GANd;","names":[]}

package/dist/runtime/subsystems/analytics/index.d.ts

@@ -0,0 +1,6 @@
+export { AnalyticsQueryOpts, IAnalyticsQuery, ResultRow } from './analytics-query.protocol.js';
+export { ANALYTICS_QUERY, CUBE_API_SECRET, CUBE_API_URL } from './analytics.tokens.js';
+export { AnalyticsModule, AnalyticsModuleOptions } from './analytics.module.js';
+export { CubeAnalyticsBackend } from './cube-backend.js';
+export { NoopAnalyticsBackend } from './noop-backend.js';
+import '@nestjs/common';

package/dist/runtime/subsystems/analytics/index.js

@@ -0,0 +1,122 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// runtime/subsystems/analytics/analytics.tokens.ts
+var ANALYTICS_QUERY = "ANALYTICS_QUERY";
+var CUBE_API_URL = /* @__PURE__ */ Symbol("CUBE_API_URL");
+var CUBE_API_SECRET = /* @__PURE__ */ Symbol("CUBE_API_SECRET");
+
+// runtime/subsystems/analytics/analytics.module.ts
+import { Module } from "@nestjs/common";
+
+// runtime/subsystems/analytics/cube-backend.ts
+import { Inject, Injectable, Logger } from "@nestjs/common";
+var CubeAnalyticsBackend = class {
+  constructor(apiUrl, apiSecret) {
+    this.apiUrl = apiUrl;
+    this.apiSecret = apiSecret;
+  }
+  apiUrl;
+  apiSecret;
+  logger = new Logger(CubeAnalyticsBackend.name);
+  cubejsApi;
+  async onModuleInit() {
+    try {
+      const { default: cubejs } = await import("@cubejs-client/core");
+      this.cubejsApi = cubejs(this.apiSecret, { apiUrl: this.apiUrl });
+    } catch {
+      throw new Error(
+        "CubeAnalyticsBackend requires @cubejs-client/core. Install it: bun add @cubejs-client/core"
+      );
+    }
+  }
+  async execute(cube, measures, dimensions, where, opts) {
+    if (!this.cubejsApi) {
+      this.logger.warn("Cube.js client not initialized \u2014 returning empty result");
+      return [];
+    }
+    const query = {
+      measures: measures.map((m) => cube + "." + m),
+      dimensions: dimensions.map((d) => cube + "." + d)
+    };
+    if (where && Object.keys(where).length > 0) {
+      query.filters = Object.entries(where).map(([member, value]) => ({
+        member: cube + "." + member,
+        operator: "equals",
+        values: Array.isArray(value) ? value : [String(value)]
+      }));
+    }
+    if (opts?.limit) {
+      query.limit = opts.limit;
+    }
+    const resultSet = await this.cubejsApi.load(query);
+    return resultSet.tablePivot();
+  }
+};
+CubeAnalyticsBackend = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(CUBE_API_URL)),
+  __decorateParam(1, Inject(CUBE_API_SECRET))
+], CubeAnalyticsBackend);
+
+// runtime/subsystems/analytics/noop-backend.ts
+import { Injectable as Injectable2 } from "@nestjs/common";
+var NoopAnalyticsBackend = class {
+  async execute(_cube, _measures, _dimensions, _where, _opts) {
+    return [];
+  }
+};
+NoopAnalyticsBackend = __decorateClass([
+  Injectable2()
+], NoopAnalyticsBackend);
+
+// runtime/subsystems/analytics/analytics.module.ts
+var AnalyticsModule = class {
+  static forRoot(options = { backend: "noop" }) {
+    if (options.backend === "cube") {
+      return {
+        module: AnalyticsModule,
+        global: true,
+        providers: [
+          {
+            provide: CUBE_API_URL,
+            useValue: process.env["CUBE_API_URL"] ?? "http://localhost:4000/cubejs-api/v1"
+          },
+          {
+            provide: CUBE_API_SECRET,
+            useValue: process.env["CUBE_API_SECRET"] ?? ""
+          },
+          { provide: ANALYTICS_QUERY, useClass: CubeAnalyticsBackend }
+        ],
+        exports: [ANALYTICS_QUERY]
+      };
+    }
+    return {
+      module: AnalyticsModule,
+      global: true,
+      providers: [{ provide: ANALYTICS_QUERY, useClass: NoopAnalyticsBackend }],
+      exports: [ANALYTICS_QUERY]
+    };
+  }
+};
+AnalyticsModule = __decorateClass([
+  Module({})
+], AnalyticsModule);
+export {
+  ANALYTICS_QUERY,
+  AnalyticsModule,
+  CUBE_API_SECRET,
+  CUBE_API_URL,
+  CubeAnalyticsBackend,
+  NoopAnalyticsBackend
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/subsystems/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/analytics/analytics.tokens.ts","../../../../runtime/subsystems/analytics/analytics.module.ts","../../../../runtime/subsystems/analytics/cube-backend.ts","../../../../runtime/subsystems/analytics/noop-backend.ts"],"sourcesContent":["/**\n * Injection tokens for the analytics subsystem.\n *\n * String constants (not Symbols) so they match by value across import\n * boundaries — same convention as events.tokens.ts.\n *\n * Usage in services:\n * ```typescript\n * constructor(@Inject(ANALYTICS_QUERY) private readonly analytics: IAnalyticsQuery) {}\n * ```\n */\nexport const ANALYTICS_QUERY = 'ANALYTICS_QUERY' as const;\n\n/**\n * Injection token for the cube.js API URL.\n * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nexport const CUBE_API_URL = Symbol('CUBE_API_URL');\n\n/**\n * Injection token for the cube.js API secret.\n * Provided automatically by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nexport const CUBE_API_SECRET = Symbol('CUBE_API_SECRET');\n","/**\n * AnalyticsModule — DynamicModule factory for the analytics query subsystem.\n *\n * Register once in AppModule:\n * ```typescript\n * @Module({\n *   imports: [\n *     AnalyticsModule.forRoot({ backend: 'cube' }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n *\n * Tests swap to the noop backend without touching application code:\n * ```typescript\n * Test.createTestingModule({\n *   imports: [AnalyticsModule.forRoot({ backend: 'noop' })],\n * });\n * ```\n *\n * `global: true` means entity modules do not need to import AnalyticsModule\n * individually — the ANALYTICS_QUERY token is available project-wide.\n */\nimport { Module, type DynamicModule } from '@nestjs/common';\nimport { ANALYTICS_QUERY, CUBE_API_URL, CUBE_API_SECRET } from './analytics.tokens';\nimport { CubeAnalyticsBackend } from './cube-backend';\nimport { NoopAnalyticsBackend } from './noop-backend';\n\nexport interface AnalyticsModuleOptions {\n  backend: 'cube' | 'noop';\n}\n\n@Module({})\nexport class AnalyticsModule {\n  static forRoot(\n    options: AnalyticsModuleOptions = { backend: 'noop' },\n  ): DynamicModule {\n    if (options.backend === 'cube') {\n      return {\n        module: AnalyticsModule,\n        global: true,\n        providers: [\n          {\n            provide: CUBE_API_URL,\n            useValue: process.env['CUBE_API_URL'] ?? 'http://localhost:4000/cubejs-api/v1',\n          },\n          {\n            provide: CUBE_API_SECRET,\n            useValue: process.env['CUBE_API_SECRET'] ?? '',\n          },\n          { provide: ANALYTICS_QUERY, useClass: CubeAnalyticsBackend },\n        ],\n        exports: [ANALYTICS_QUERY],\n      };\n    }\n\n    return {\n      module: AnalyticsModule,\n      global: true,\n      providers: [{ provide: ANALYTICS_QUERY, useClass: NoopAnalyticsBackend }],\n      exports: [ANALYTICS_QUERY],\n    };\n  }\n}\n","/**\n * CubeAnalyticsBackend — cube.js backend for the analytics query port.\n *\n * Connects to a running cube.js instance via @cubejs-client/core and\n * translates IAnalyticsQuery calls into cube.js query objects.\n *\n * @cubejs-client/core is an optional peer dependency; lazy-imported so\n * the module loads even if the package isn't installed. Consumers who\n * use the cube backend must install it separately:\n *   bun add @cubejs-client/core\n *\n * Provided by AnalyticsModule.forRoot({ backend: 'cube' }).\n */\nimport { Inject, Injectable, OnModuleInit, Logger } from '@nestjs/common';\nimport { CUBE_API_URL, CUBE_API_SECRET } from './analytics.tokens';\nimport type {\n  AnalyticsQueryOpts,\n  IAnalyticsQuery,\n  ResultRow,\n} from './analytics-query.protocol';\n\n@Injectable()\nexport class CubeAnalyticsBackend implements IAnalyticsQuery, OnModuleInit {\n  private readonly logger = new Logger(CubeAnalyticsBackend.name);\n  private cubejsApi: any;\n\n  constructor(\n    @Inject(CUBE_API_URL) private readonly apiUrl: string,\n    @Inject(CUBE_API_SECRET) private readonly apiSecret: string,\n  ) {}\n\n  async onModuleInit(): Promise<void> {\n    try {\n      const { default: cubejs } = await import('@cubejs-client/core');\n      this.cubejsApi = cubejs(this.apiSecret, { apiUrl: this.apiUrl });\n    } catch {\n      throw new Error(\n        'CubeAnalyticsBackend requires @cubejs-client/core. Install it: bun add @cubejs-client/core',\n      );\n    }\n  }\n\n  async execute(\n    cube: string,\n    measures: string[],\n    dimensions: string[],\n    where?: Record<string, any>,\n    opts?: AnalyticsQueryOpts,\n  ): Promise<ResultRow[]> {\n    if (!this.cubejsApi) {\n      this.logger.warn('Cube.js client not initialized — returning empty result');\n      return [];\n    }\n\n    const query: Record<string, any> = {\n      measures: measures.map((m) => cube + '.' + m),\n      dimensions: dimensions.map((d) => cube + '.' + d),\n    };\n\n    if (where && Object.keys(where).length > 0) {\n      query.filters = Object.entries(where).map(([member, value]) => ({\n        member: cube + '.' + member,\n        operator: 'equals',\n        values: Array.isArray(value) ? value : [String(value)],\n      }));\n    }\n\n    if (opts?.limit) {\n      query.limit = opts.limit;\n    }\n\n    const resultSet = await this.cubejsApi.load(query);\n    return resultSet.tablePivot() as ResultRow[];\n  }\n}\n","/**\n * NoopAnalyticsBackend — no-op backend for the analytics query port.\n *\n * Returns empty arrays for all queries. Use this backend when analytics\n * is disabled or in tests that don't need real analytics data.\n *\n * Provided by AnalyticsModule.forRoot({ backend: 'noop' }).\n */\nimport { Injectable } from '@nestjs/common';\nimport type {\n  AnalyticsQueryOpts,\n  IAnalyticsQuery,\n  ResultRow,\n} from './analytics-query.protocol';\n\n@Injectable()\nexport class NoopAnalyticsBackend implements IAnalyticsQuery {\n  async execute(\n    _cube: string,\n    _measures: string[],\n    _dimensions: string[],\n    _where?: Record<string, any>,\n    _opts?: AnalyticsQueryOpts,\n  ): Promise<ResultRow[]> {\n    return [];\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAWO,IAAM,kBAAkB;AAMxB,IAAM,eAAe,uBAAO,cAAc;AAM1C,IAAM,kBAAkB,uBAAO,iBAAiB;;;ACAvD,SAAS,cAAkC;;;ACV3C,SAAS,QAAQ,YAA0B,cAAc;AASlD,IAAM,uBAAN,MAAoE;AAAA,EAIzE,YACyC,QACG,WAC1C;AAFuC;AACG;AAAA,EACzC;AAAA,EAFsC;AAAA,EACG;AAAA,EAL3B,SAAS,IAAI,OAAO,qBAAqB,IAAI;AAAA,EACtD;AAAA,EAOR,MAAM,eAA8B;AAClC,QAAI;AACF,YAAM,EAAE,SAAS,OAAO,IAAI,MAAM,OAAO,qBAAqB;AAC9D,WAAK,YAAY,OAAO,KAAK,WAAW,EAAE,QAAQ,KAAK,OAAO,CAAC;AAAA,IACjE,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,QACJ,MACA,UACA,YACA,OACA,MACsB;AACtB,QAAI,CAAC,KAAK,WAAW;AACnB,WAAK,OAAO,KAAK,8DAAyD;AAC1E,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,QAA6B;AAAA,MACjC,UAAU,SAAS,IAAI,CAAC,MAAM,OAAO,MAAM,CAAC;AAAA,MAC5C,YAAY,WAAW,IAAI,CAAC,MAAM,OAAO,MAAM,CAAC;AAAA,IAClD;AAEA,QAAI,SAAS,OAAO,KAAK,KAAK,EAAE,SAAS,GAAG;AAC1C,YAAM,UAAU,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;AAAA,QAC9D,QAAQ,OAAO,MAAM;AAAA,QACrB,UAAU;AAAA,QACV,QAAQ,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC;AAAA,MACvD,EAAE;AAAA,IACJ;AAEA,QAAI,MAAM,OAAO;AACf,YAAM,QAAQ,KAAK;AAAA,IACrB;AAEA,UAAM,YAAY,MAAM,KAAK,UAAU,KAAK,KAAK;AACjD,WAAO,UAAU,WAAW;AAAA,EAC9B;AACF;AApDa,uBAAN;AAAA,EADN,WAAW;AAAA,EAMP,0BAAO,YAAY;AAAA,EACnB,0BAAO,eAAe;AAAA,GANd;;;ACdb,SAAS,cAAAA,mBAAkB;AAQpB,IAAM,uBAAN,MAAsD;AAAA,EAC3D,MAAM,QACJ,OACA,WACA,aACA,QACA,OACsB;AACtB,WAAO,CAAC;AAAA,EACV;AACF;AAVa,uBAAN;AAAA,EADNC,YAAW;AAAA,GACC;;;AFiBN,IAAM,kBAAN,MAAsB;AAAA,EAC3B,OAAO,QACL,UAAkC,EAAE,SAAS,OAAO,GACrC;AACf,QAAI,QAAQ,YAAY,QAAQ;AAC9B,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ;AAAA,QACR,WAAW;AAAA,UACT;AAAA,YACE,SAAS;AAAA,YACT,UAAU,QAAQ,IAAI,cAAc,KAAK;AAAA,UAC3C;AAAA,UACA;AAAA,YACE,SAAS;AAAA,YACT,UAAU,QAAQ,IAAI,iBAAiB,KAAK;AAAA,UAC9C;AAAA,UACA,EAAE,SAAS,iBAAiB,UAAU,qBAAqB;AAAA,QAC7D;AAAA,QACA,SAAS,CAAC,eAAe;AAAA,MAC3B;AAAA,IACF;AAEA,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,WAAW,CAAC,EAAE,SAAS,iBAAiB,UAAU,qBAAqB,CAAC;AAAA,MACxE,SAAS,CAAC,eAAe;AAAA,IAC3B;AAAA,EACF;AACF;AA9Ba,kBAAN;AAAA,EADN,OAAO,CAAC,CAAC;AAAA,GACG;","names":["Injectable","Injectable"]}

package/dist/runtime/subsystems/analytics/noop-backend.d.ts

@@ -0,0 +1,7 @@
+import { IAnalyticsQuery, AnalyticsQueryOpts, ResultRow } from './analytics-query.protocol.js';
+
+declare class NoopAnalyticsBackend implements IAnalyticsQuery {
+    execute(_cube: string, _measures: string[], _dimensions: string[], _where?: Record<string, any>, _opts?: AnalyticsQueryOpts): Promise<ResultRow[]>;
+}
+
+export { NoopAnalyticsBackend };

package/dist/runtime/subsystems/analytics/noop-backend.js

@@ -0,0 +1,25 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// runtime/subsystems/analytics/noop-backend.ts
+import { Injectable } from "@nestjs/common";
+var NoopAnalyticsBackend = class {
+  async execute(_cube, _measures, _dimensions, _where, _opts) {
+    return [];
+  }
+};
+NoopAnalyticsBackend = __decorateClass([
+  Injectable()
+], NoopAnalyticsBackend);
+export {
+  NoopAnalyticsBackend
+};
+//# sourceMappingURL=noop-backend.js.map

package/dist/runtime/subsystems/analytics/noop-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/analytics/noop-backend.ts"],"sourcesContent":["/**\n * NoopAnalyticsBackend — no-op backend for the analytics query port.\n *\n * Returns empty arrays for all queries. Use this backend when analytics\n * is disabled or in tests that don't need real analytics data.\n *\n * Provided by AnalyticsModule.forRoot({ backend: 'noop' }).\n */\nimport { Injectable } from '@nestjs/common';\nimport type {\n  AnalyticsQueryOpts,\n  IAnalyticsQuery,\n  ResultRow,\n} from './analytics-query.protocol';\n\n@Injectable()\nexport class NoopAnalyticsBackend implements IAnalyticsQuery {\n  async execute(\n    _cube: string,\n    _measures: string[],\n    _dimensions: string[],\n    _where?: Record<string, any>,\n    _opts?: AnalyticsQueryOpts,\n  ): Promise<ResultRow[]> {\n    return [];\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAQA,SAAS,kBAAkB;AAQpB,IAAM,uBAAN,MAAsD;AAAA,EAC3D,MAAM,QACJ,OACA,WACA,aACA,QACA,OACsB;AACtB,WAAO,CAAC;AAAA,EACV;AACF;AAVa,uBAAN;AAAA,EADN,WAAW;AAAA,GACC;","names":[]}

package/dist/runtime/subsystems/cache/cache.drizzle-backend.d.ts

@@ -0,0 +1,43 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { DrizzleClient } from '../../types/drizzle.js';
+import { ICacheService } from './cache.protocol.js';
+export { CACHE_DEFAULT_TTL } from './cache.tokens.js';
+import 'drizzle-orm/node-postgres';
+
+/**
+ * DrizzleCacheService — Postgres-backed ICacheService via Drizzle ORM.
+ *
+ * Storage: `cache_entries` table with key (text pk), value (jsonb), expiresAt (timestamp).
+ * TTL enforcement: reads filter by `expiresAt > now() OR expiresAt IS NULL`.
+ * Prefix invalidation: `DELETE WHERE key LIKE 'escaped_prefix%'`.
+ *
+ * Lifecycle:
+ * - OnModuleInit: starts periodic cleanup of expired entries.
+ *   Uses the Jobs subsystem if available (optional injection); falls back to setInterval.
+ * - OnModuleDestroy: clears the setInterval timer if used.
+ *
+ * Error behavior per ADR-008:
+ * - get() / has() return null/false on any error (never throw for reads).
+ * - set() / delete() / invalidateByPrefix() throw on failure.
+ */
+
+declare class DrizzleCacheService implements ICacheService, OnModuleInit, OnModuleDestroy {
+    private readonly db;
+    private readonly defaultTtl;
+    private cleanupTimer;
+    /** In-flight getOrSet promises — keyed by cache key to deduplicate stampedes. */
+    private readonly inflight;
+    constructor(db: DrizzleClient, defaultTtl?: number | null);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set<T = unknown>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    invalidateByPrefix(prefix: string): Promise<number>;
+    has(key: string): Promise<boolean>;
+    getOrSet<T = unknown>(key: string, factory: () => Promise<T>, ttlSeconds?: number): Promise<T>;
+    /** Remove all expired entries. Called by the cleanup timer. */
+    private deleteExpired;
+}
+
+export { DrizzleCacheService };