@pattern-stack/codegen 0.15.1 → 0.15.3

package/dist/chunk-V4AF6DI4.js

@@ -0,0 +1,16 @@
+// runtime/subsystems/events/events-errors.ts
+var MissingTenantIdError = class extends Error {
+  constructor(eventType) {
+    super(
+      `Missing tenantId for event '${eventType}'. EventsModule is configured with multiTenant: true \u2014 every publish must include opts.metadata.tenantId. Either pass the tenantId or disable multi-tenancy on the module.`
+    );
+    this.eventType = eventType;
+  }
+  eventType;
+  name = "MissingTenantIdError";
+};
+
+export {
+  MissingTenantIdError
+};
+//# sourceMappingURL=chunk-V4AF6DI4.js.map

package/dist/chunk-V4AF6DI4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/events/events-errors.ts"],"sourcesContent":["/**\n * Typed errors for the events subsystem (ADR-024, EVT-6).\n *\n * All thrown from the publish path of `TypedEventBus`. They exist as\n * classes so consumers can `instanceof` them in catch blocks and\n * exception filters can map them to HTTP codes.\n */\n\n/**\n * Thrown by `TypedEventBus.publish()` when the EventsModule is configured\n * with `multiTenant: true` and the caller did not supply\n * `opts.metadata.tenantId`. Multi-tenant mode requires every outbox row to\n * be attributable to a tenant — the `domain_events.tenant_id` column is\n * populated from this value and the drain loop uses it for future\n * tenant-scoped filtering (deferred — see ADR-024 §Multi-tenancy).\n *\n * Disable multi-tenancy at the module level (`multiTenant: false`, the\n * default) to opt out of the requirement entirely.\n */\nexport class MissingTenantIdError extends Error {\n  override readonly name = 'MissingTenantIdError';\n  constructor(public readonly eventType: string) {\n    super(\n      `Missing tenantId for event '${eventType}'. EventsModule is configured ` +\n        `with multiTenant: true — every publish must include ` +\n        `opts.metadata.tenantId. Either pass the tenantId or disable ` +\n        `multi-tenancy on the module.`,\n    );\n  }\n}\n"],"mappings":";AAmBO,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAE9C,YAA4B,WAAmB;AAC7C;AAAA,MACE,+BAA+B,SAAS;AAAA,IAI1C;AAN0B;AAAA,EAO5B;AAAA,EAP4B;AAAA,EADV,OAAO;AAS3B;","names":[]}

package/dist/chunk-W72PRNJY.js

@@ -0,0 +1,126 @@
+import {
+  buildChangeEvents,
+  buildLifecycleEvent,
+  diffSnapshots,
+  emitSafely,
+  entitySnapshot
+} from "./chunk-KYR3B3OW.js";
+
+// runtime/base-classes/base-service.ts
+var BaseService = class {
+  constructor(repository) {
+    this.repository = repository;
+  }
+  repository;
+  /**
+   * Entity name for event types (e.g., 'account' → 'account.created').
+   * Set by generated services. If empty, lifecycle events are skipped.
+   */
+  entityName;
+  /**
+   * Event bus for lifecycle/change event emission.
+   * Injected via @Inject(EVENT_BUS) @Optional() on generated services.
+   * If undefined (no events subsystem installed), emission is silently skipped.
+   */
+  eventBus;
+  /**
+   * Whether to emit lifecycle events. Default: true.
+   * Override to false in entity YAML via behaviors or in the service class.
+   */
+  emitLifecycleEvents = true;
+  /**
+   * Find a single entity by its primary key.
+   * Returns null if not found.
+   */
+  findById(id) {
+    return this.repository.findById(id);
+  }
+  /**
+   * Find multiple entities by their primary keys.
+   */
+  findByIds(ids) {
+    return this.repository.findByIds(ids);
+  }
+  /**
+   * List entities with optional filtering/pagination options.
+   */
+  list(options) {
+    return this.repository.list(options);
+  }
+  /**
+   * Count entities matching an optional filter.
+   */
+  count(where) {
+    return this.repository.count(where);
+  }
+  /**
+   * Check whether an entity with the given id exists.
+   */
+  exists(id) {
+    return this.repository.exists(id);
+  }
+  /**
+   * Insert a new entity.
+   * Emits a LIFECYCLE 'created' event with entity snapshot.
+   */
+  async create(input, tx) {
+    const result = await this.repository.create(input, tx);
+    if (this._shouldEmit()) {
+      const snap = entitySnapshot(result);
+      const id = result.id;
+      const event = buildLifecycleEvent(this.entityName, "created", id, snap);
+      void emitSafely(this.eventBus, [event]);
+    }
+    return result;
+  }
+  /**
+   * Update an existing entity by id.
+   * Emits a LIFECYCLE 'updated' event + CHANGE events for each modified field.
+   */
+  async update(id, input, tx) {
+    let before;
+    if (this._shouldEmit()) {
+      const existing = await this.repository.findById(id);
+      if (existing) {
+        before = entitySnapshot(existing);
+      }
+    }
+    const result = await this.repository.update(id, input, tx);
+    if (this._shouldEmit()) {
+      const after = entitySnapshot(result);
+      const events = [
+        buildLifecycleEvent(this.entityName, "updated", id, after)
+      ];
+      if (before) {
+        const changes = diffSnapshots(before, after);
+        if (changes.length > 0) {
+          events.push(...buildChangeEvents(this.entityName, id, changes));
+        }
+      }
+      void emitSafely(this.eventBus, events);
+    }
+    return result;
+  }
+  /**
+   * Delete an entity by id.
+   * Emits a LIFECYCLE 'deleted' event.
+   */
+  async delete(id, tx) {
+    await this.repository.delete(id, tx);
+    if (this._shouldEmit()) {
+      const event = buildLifecycleEvent(this.entityName, "deleted", id);
+      void emitSafely(this.eventBus, [event]);
+    }
+  }
+  /** Check whether lifecycle event emission is active. */
+  _shouldEmit() {
+    return Boolean(
+      this.emitLifecycleEvents && this.entityName && this.eventBus
+    );
+  }
+};
+
+export {
+  BaseService
+};
+//# sourceMappingURL=chunk-W72PRNJY.js.map

package/dist/chunk-W72PRNJY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/base-classes/base-service.ts"],"sourcesContent":["/**\n * BaseService<TRepo, TEntity>\n *\n * Abstract base class providing 8 CRUD pass-through methods delegating to\n * an injected repository. Every generated service extends this class.\n *\n * Lifecycle event emission (LIFECYCLE + CHANGE categories) is built into\n * create/update/delete — matching pattern-stack's BaseService. Events are\n * fire-and-forget: emission never fails the CRUD operation. If no IEventBus\n * is injected (eventBus is undefined), emission is silently skipped.\n *\n * Generated services set `entityName` and optionally inject `eventBus` via\n * NestJS property injection (@Inject(EVENT_BUS) @Optional()).\n *\n * Note: @Injectable() is applied on concrete services (not here) so that\n * NestJS DI metadata is emitted at the concrete class level. This matches\n * the pattern established by BaseRepository.\n */\n\nimport type { IEventBus } from '../subsystems/events/event-bus.protocol';\nimport {\n  entitySnapshot,\n  diffSnapshots,\n  buildLifecycleEvent,\n  buildChangeEvents,\n  emitSafely,\n} from './lifecycle-events';\n\n// ============================================================================\n// IBaseRepository interface\n// ============================================================================\n\n/**\n * Structural interface that BaseRepository satisfies.\n * Use this as the TRepo constraint so BaseService is not coupled to the\n * concrete Drizzle-backed BaseRepository.\n */\nexport interface IBaseRepository<TEntity> {\n  findById(id: string): Promise<TEntity | null>;\n  findByIds(ids: string[]): Promise<TEntity[]>;\n  list(options?: unknown): Promise<TEntity[]>;\n  count(where?: unknown): Promise<number>;\n  exists(id: string): Promise<boolean>;\n  create(input: Partial<TEntity>, tx?: unknown): Promise<TEntity>;\n  update(id: string, input: Partial<TEntity>, tx?: unknown): Promise<TEntity>;\n  delete(id: string, tx?: unknown): Promise<void>;\n}\n\n// ============================================================================\n// BaseService\n// ============================================================================\n\nexport abstract class BaseService<TRepo extends IBaseRepository<TEntity>, TEntity> {\n  /**\n   * Entity name for event types (e.g., 'account' → 'account.created').\n   * Set by generated services. If empty, lifecycle events are skipped.\n   */\n  protected entityName?: string;\n\n  /**\n   * Event bus for lifecycle/change event emission.\n   * Injected via @Inject(EVENT_BUS) @Optional() on generated services.\n   * If undefined (no events subsystem installed), emission is silently skipped.\n   */\n  protected eventBus?: IEventBus;\n\n  /**\n   * Whether to emit lifecycle events. Default: true.\n   * Override to false in entity YAML via behaviors or in the service class.\n   */\n  protected emitLifecycleEvents = true;\n\n  constructor(protected readonly repository: TRepo) {}\n\n  /**\n   * Find a single entity by its primary key.\n   * Returns null if not found.\n   */\n  findById(id: string): Promise<TEntity | null> {\n    return this.repository.findById(id);\n  }\n\n  /**\n   * Find multiple entities by their primary keys.\n   */\n  findByIds(ids: string[]): Promise<TEntity[]> {\n    return this.repository.findByIds(ids);\n  }\n\n  /**\n   * List entities with optional filtering/pagination options.\n   */\n  list(options?: unknown): Promise<TEntity[]> {\n    return this.repository.list(options);\n  }\n\n  /**\n   * Count entities matching an optional filter.\n   */\n  count(where?: unknown): Promise<number> {\n    return this.repository.count(where);\n  }\n\n  /**\n   * Check whether an entity with the given id exists.\n   */\n  exists(id: string): Promise<boolean> {\n    return this.repository.exists(id);\n  }\n\n  /**\n   * Insert a new entity.\n   * Emits a LIFECYCLE 'created' event with entity snapshot.\n   */\n  async create(input: Partial<TEntity>, tx?: unknown): Promise<TEntity> {\n    const result = await this.repository.create(input, tx);\n\n    if (this._shouldEmit()) {\n      const snap = entitySnapshot(result as Record<string, unknown>);\n      const id = (result as Record<string, unknown>).id as string;\n      const event = buildLifecycleEvent(this.entityName!, 'created', id, snap);\n      void emitSafely(this.eventBus, [event]);\n    }\n\n    return result;\n  }\n\n  /**\n   * Update an existing entity by id.\n   * Emits a LIFECYCLE 'updated' event + CHANGE events for each modified field.\n   */\n  async update(id: string, input: Partial<TEntity>, tx?: unknown): Promise<TEntity> {\n    // Snapshot before for change diffing\n    let before: Record<string, unknown> | undefined;\n    if (this._shouldEmit()) {\n      const existing = await this.repository.findById(id);\n      if (existing) {\n        before = entitySnapshot(existing as Record<string, unknown>);\n      }\n    }\n\n    const result = await this.repository.update(id, input, tx);\n\n    if (this._shouldEmit()) {\n      const after = entitySnapshot(result as Record<string, unknown>);\n      const events = [\n        buildLifecycleEvent(this.entityName!, 'updated', id, after),\n      ];\n      // Append per-field CHANGE events\n      if (before) {\n        const changes = diffSnapshots(before, after);\n        if (changes.length > 0) {\n          events.push(...buildChangeEvents(this.entityName!, id, changes));\n        }\n      }\n      void emitSafely(this.eventBus, events);\n    }\n\n    return result;\n  }\n\n  /**\n   * Delete an entity by id.\n   * Emits a LIFECYCLE 'deleted' event.\n   */\n  async delete(id: string, tx?: unknown): Promise<void> {\n    await this.repository.delete(id, tx);\n\n    if (this._shouldEmit()) {\n      const event = buildLifecycleEvent(this.entityName!, 'deleted', id);\n      void emitSafely(this.eventBus, [event]);\n    }\n  }\n\n  /** Check whether lifecycle event emission is active. */\n  private _shouldEmit(): boolean {\n    return Boolean(\n      this.emitLifecycleEvents &&\n      this.entityName &&\n      this.eventBus,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;AAoDO,IAAe,cAAf,MAA4E;AAAA,EAoBjF,YAA+B,YAAmB;AAAnB;AAAA,EAAoB;AAAA,EAApB;AAAA;AAAA;AAAA;AAAA;AAAA,EAfrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,sBAAsB;AAAA;AAAA;AAAA;AAAA;AAAA,EAQhC,SAAS,IAAqC;AAC5C,WAAO,KAAK,WAAW,SAAS,EAAE;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,KAAmC;AAC3C,WAAO,KAAK,WAAW,UAAU,GAAG;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA,EAKA,KAAK,SAAuC;AAC1C,WAAO,KAAK,WAAW,KAAK,OAAO;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAkC;AACtC,WAAO,KAAK,WAAW,MAAM,KAAK;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,IAA8B;AACnC,WAAO,KAAK,WAAW,OAAO,EAAE;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO,OAAyB,IAAgC;AACpE,UAAM,SAAS,MAAM,KAAK,WAAW,OAAO,OAAO,EAAE;AAErD,QAAI,KAAK,YAAY,GAAG;AACtB,YAAM,OAAO,eAAe,MAAiC;AAC7D,YAAM,KAAM,OAAmC;AAC/C,YAAM,QAAQ,oBAAoB,KAAK,YAAa,WAAW,IAAI,IAAI;AACvE,WAAK,WAAW,KAAK,UAAU,CAAC,KAAK,CAAC;AAAA,IACxC;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO,IAAY,OAAyB,IAAgC;AAEhF,QAAI;AACJ,QAAI,KAAK,YAAY,GAAG;AACtB,YAAM,WAAW,MAAM,KAAK,WAAW,SAAS,EAAE;AAClD,UAAI,UAAU;AACZ,iBAAS,eAAe,QAAmC;AAAA,MAC7D;AAAA,IACF;AAEA,UAAM,SAAS,MAAM,KAAK,WAAW,OAAO,IAAI,OAAO,EAAE;AAEzD,QAAI,KAAK,YAAY,GAAG;AACtB,YAAM,QAAQ,eAAe,MAAiC;AAC9D,YAAM,SAAS;AAAA,QACb,oBAAoB,KAAK,YAAa,WAAW,IAAI,KAAK;AAAA,MAC5D;AAEA,UAAI,QAAQ;AACV,cAAM,UAAU,cAAc,QAAQ,KAAK;AAC3C,YAAI,QAAQ,SAAS,GAAG;AACtB,iBAAO,KAAK,GAAG,kBAAkB,KAAK,YAAa,IAAI,OAAO,CAAC;AAAA,QACjE;AAAA,MACF;AACA,WAAK,WAAW,KAAK,UAAU,MAAM;AAAA,IACvC;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO,IAAY,IAA6B;AACpD,UAAM,KAAK,WAAW,OAAO,IAAI,EAAE;AAEnC,QAAI,KAAK,YAAY,GAAG;AACtB,YAAM,QAAQ,oBAAoB,KAAK,YAAa,WAAW,EAAE;AACjE,WAAK,WAAW,KAAK,UAAU,CAAC,KAAK,CAAC;AAAA,IACxC;AAAA,EACF;AAAA;AAAA,EAGQ,cAAuB;AAC7B,WAAO;AAAA,MACL,KAAK,uBACL,KAAK,cACL,KAAK;AAAA,IACP;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-WL67FZGF.js

@@ -0,0 +1,21 @@
+import {
+  isSessionExpiredError
+} from "./chunk-7RELQJIN.js";
+
+// runtime/subsystems/auth/runtime/with-auth-retry.ts
+async function withAuthRetry(authStrategy, connectionId, op, options = {}) {
+  const classify = options.isSessionExpired ?? isSessionExpiredError;
+  let creds = await authStrategy.resolve(connectionId);
+  try {
+    return await op(creds);
+  } catch (e) {
+    if (!classify(e)) throw e;
+    creds = await authStrategy.resolve(connectionId, { forceRefresh: true });
+    return op(creds);
+  }
+}
+
+export {
+  withAuthRetry
+};
+//# sourceMappingURL=chunk-WL67FZGF.js.map

package/dist/chunk-WL67FZGF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/auth/runtime/with-auth-retry.ts"],"sourcesContent":["/**\n * Run `op` with auth-aware retry-once on session-expired errors.\n *\n * Pattern: resolve creds → run op → if `isSessionExpired(e)` → resolve with\n * `forceRefresh: true` → retry → propagate. A second session-expired error\n * on the refreshed token propagates rather than looping, so transient\n * adapter bugs can't hang the caller.\n *\n * Generalisation over the extraction source's SFDC-specific original: the\n * session-expired classifier is injected. Providers mark their session-\n * expired errors (via `instanceof` of a marker class, or by setting a known\n * property) and pass a classifier matching that shape.\n *\n * Default classifier recognises the marker interface `SessionExpiredError`\n * shipped in `session-expired.error.ts` — concrete provider errors that\n * extend it (or set `isSessionExpired === true`) get retried without any\n * further wiring.\n */\nimport type {\n  AuthCredentials,\n  IAuthStrategy,\n} from '../protocols/auth-strategy';\nimport { isSessionExpiredError } from './session-expired.error';\n\nexport interface WithAuthRetryOptions {\n  /**\n   * Classifier that decides whether a thrown error is a session-expired\n   * signal worth retrying once with a fresh token. Defaults to the marker-\n   * interface check in `session-expired.error.ts`.\n   */\n  isSessionExpired?: (err: unknown) => boolean;\n}\n\nexport async function withAuthRetry<T>(\n  authStrategy: IAuthStrategy,\n  connectionId: string,\n  op: (credentials: AuthCredentials) => Promise<T>,\n  options: WithAuthRetryOptions = {},\n): Promise<T> {\n  const classify = options.isSessionExpired ?? isSessionExpiredError;\n\n  let creds = await authStrategy.resolve(connectionId);\n  try {\n    return await op(creds);\n  } catch (e) {\n    if (!classify(e)) throw e;\n    creds = await authStrategy.resolve(connectionId, { forceRefresh: true });\n    return op(creds);\n  }\n}\n"],"mappings":";;;;;AAiCA,eAAsB,cACpB,cACA,cACA,IACA,UAAgC,CAAC,GACrB;AACZ,QAAM,WAAW,QAAQ,oBAAoB;AAE7C,MAAI,QAAQ,MAAM,aAAa,QAAQ,YAAY;AACnD,MAAI;AACF,WAAO,MAAM,GAAG,KAAK;AAAA,EACvB,SAAS,GAAG;AACV,QAAI,CAAC,SAAS,CAAC,EAAG,OAAM;AACxB,YAAQ,MAAM,aAAa,QAAQ,cAAc,EAAE,cAAc,KAAK,CAAC;AACvE,WAAO,GAAG,KAAK;AAAA,EACjB;AACF;","names":[]}

package/dist/chunk-WWGYCIJX.js

@@ -0,0 +1,29 @@
+import {
+  PollChangeSource
+} from "./chunk-4MF3HKJA.js";
+import {
+  WebhookChangeSource
+} from "./chunk-YLPAPPLW.js";
+
+// runtime/subsystems/integration/build-change-source.ts
+function buildChangeSource(cfg, fetch, middlewares = []) {
+  switch (cfg.mode) {
+    case "poll":
+      return new PollChangeSource({
+        adapter: fetch,
+        config: cfg,
+        middlewares
+      });
+    case "webhook":
+      return new WebhookChangeSource({
+        queue: fetch,
+        config: cfg,
+        middlewares
+      });
+  }
+}
+
+export {
+  buildChangeSource
+};
+//# sourceMappingURL=chunk-WWGYCIJX.js.map

package/dist/chunk-WWGYCIJX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/integration/build-change-source.ts"],"sourcesContent":["/**\n * Integration subsystem — `buildChangeSource()` runtime factory (#250, ADR-033.1 b).\n *\n * Mode-dispatching constructor for `IChangeSource<T>`. Codegen-emitted\n * provider modules call this from `useFactory` once they've resolved the\n * provider-keyed `fetches[provider]` callback and parsed the per-entity\n * `DetectionConfig`. Switching is on `cfg.mode` so the option-bag shape\n * difference between primitives (`adapter` vs. `queue`) stays internal —\n * consumers pass one fetch callback regardless of mode.\n */\nimport type { DetectionConfig } from './detection-config.schema';\nimport type { IChangeSource } from './integration-change-source.protocol';\nimport type { ChangeMiddleware } from './integration-middleware.protocol';\nimport {\n  PollChangeSource,\n  type PollFetchCallback,\n} from './poll-change-source';\nimport {\n  WebhookChangeSource,\n  type WebhookFetchCallback,\n} from './webhook-change-source';\n\nexport function buildChangeSource<T>(\n  cfg: DetectionConfig,\n  fetch: PollFetchCallback<T> | WebhookFetchCallback<T>,\n  middlewares: ReadonlyArray<ChangeMiddleware<T>> = [],\n): IChangeSource<T> {\n  switch (cfg.mode) {\n    case 'poll':\n      return new PollChangeSource<T>({\n        adapter: fetch as PollFetchCallback<T>,\n        config: cfg,\n        middlewares,\n      });\n    case 'webhook':\n      return new WebhookChangeSource<T>({\n        queue: fetch as WebhookFetchCallback<T>,\n        config: cfg,\n        middlewares,\n      });\n  }\n}\n"],"mappings":";;;;;;;;AAsBO,SAAS,kBACd,KACA,OACA,cAAkD,CAAC,GACjC;AAClB,UAAQ,IAAI,MAAM;AAAA,IAChB,KAAK;AACH,aAAO,IAAI,iBAAoB;AAAA,QAC7B,SAAS;AAAA,QACT,QAAQ;AAAA,QACR;AAAA,MACF,CAAC;AAAA,IACH,KAAK;AACH,aAAO,IAAI,oBAAuB;AAAA,QAChC,OAAO;AAAA,QACP,QAAQ;AAAA,QACR;AAAA,MACF,CAAC;AAAA,EACL;AACF;","names":[]}

package/dist/chunk-X2GMTYPA.js

@@ -0,0 +1,50 @@
+// runtime/analytics/types.ts
+var AggregationType = /* @__PURE__ */ ((AggregationType2) => {
+  AggregationType2["SUM"] = "sum";
+  AggregationType2["MIN"] = "min";
+  AggregationType2["MAX"] = "max";
+  AggregationType2["COUNT"] = "count";
+  AggregationType2["COUNT_DISTINCT"] = "count_distinct";
+  AggregationType2["AVERAGE"] = "average";
+  AggregationType2["MEDIAN"] = "median";
+  AggregationType2["PERCENTILE"] = "percentile";
+  AggregationType2["SUM_BOOLEAN"] = "sum_boolean";
+  return AggregationType2;
+})(AggregationType || {});
+var DimensionType = /* @__PURE__ */ ((DimensionType2) => {
+  DimensionType2["CATEGORICAL"] = "categorical";
+  DimensionType2["TIME"] = "time";
+  return DimensionType2;
+})(DimensionType || {});
+var EntityType = /* @__PURE__ */ ((EntityType2) => {
+  EntityType2["PRIMARY"] = "primary";
+  EntityType2["UNIQUE"] = "unique";
+  EntityType2["FOREIGN"] = "foreign";
+  EntityType2["NATURAL"] = "natural";
+  return EntityType2;
+})(EntityType || {});
+var MetricType = /* @__PURE__ */ ((MetricType2) => {
+  MetricType2["SIMPLE"] = "simple";
+  MetricType2["DERIVED"] = "derived";
+  MetricType2["RATIO"] = "ratio";
+  MetricType2["CUMULATIVE"] = "cumulative";
+  MetricType2["CONVERSION"] = "conversion";
+  return MetricType2;
+})(MetricType || {});
+var TimeGranularity = /* @__PURE__ */ ((TimeGranularity2) => {
+  TimeGranularity2["DAY"] = "day";
+  TimeGranularity2["WEEK"] = "week";
+  TimeGranularity2["MONTH"] = "month";
+  TimeGranularity2["QUARTER"] = "quarter";
+  TimeGranularity2["YEAR"] = "year";
+  return TimeGranularity2;
+})(TimeGranularity || {});
+
+export {
+  AggregationType,
+  DimensionType,
+  EntityType,
+  MetricType,
+  TimeGranularity
+};
+//# sourceMappingURL=chunk-X2GMTYPA.js.map

package/dist/chunk-X2GMTYPA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/analytics/types.ts"],"sourcesContent":["/**\n * Semantic type definitions for the analytics layer.\n *\n * These types mirror MetricFlow / dbt-semantic-interfaces enums but are\n * defined locally so consumers don't need the full dependency for basic\n * field configuration. When the cube.js backend is used, these values\n * map 1:1 to cube measure/dimension types.\n */\n\n// ============================================================================\n// Enums\n// ============================================================================\n\nexport enum AggregationType {\n  SUM = 'sum',\n  MIN = 'min',\n  MAX = 'max',\n  COUNT = 'count',\n  COUNT_DISTINCT = 'count_distinct',\n  AVERAGE = 'average',\n  MEDIAN = 'median',\n  PERCENTILE = 'percentile',\n  SUM_BOOLEAN = 'sum_boolean',\n}\n\nexport enum DimensionType {\n  CATEGORICAL = 'categorical',\n  TIME = 'time',\n}\n\nexport enum EntityType {\n  PRIMARY = 'primary',\n  UNIQUE = 'unique',\n  FOREIGN = 'foreign',\n  NATURAL = 'natural',\n}\n\nexport enum MetricType {\n  SIMPLE = 'simple',\n  DERIVED = 'derived',\n  RATIO = 'ratio',\n  CUMULATIVE = 'cumulative',\n  CONVERSION = 'conversion',\n}\n\n/**\n * Time granularity for time dimensions.\n *\n * Sub-day granularities (hour, minute, second) are intentionally omitted\n * because cube.js does not support them.\n */\nexport enum TimeGranularity {\n  DAY = 'day',\n  WEEK = 'week',\n  MONTH = 'month',\n  QUARTER = 'quarter',\n  YEAR = 'year',\n}\n\n// ============================================================================\n// Config interfaces\n// ============================================================================\n\n/**\n * Configuration for non-additive dimensions on measures.\n *\n * Non-additive dimensions specify that a measure cannot be summed across\n * certain dimensions. For example, inventory balances cannot be summed\n * across time — you need the latest value, not the sum.\n */\nexport interface NonAdditiveDimensionConfig {\n  name: string;\n  window_choice?: AggregationType;\n  window_groupings?: string[];\n}\n\n/**\n * Complete semantic configuration for a field.\n *\n * Used to store all semantic metadata on a field definition for later\n * extraction by the manifest builder / cube schema generator.\n */\nexport interface SemanticFieldConfig {\n  // Measure configuration\n  measure?: boolean;\n  agg?: AggregationType;\n  agg_time_dimension?: string;\n  non_additive_dimension?: NonAdditiveDimensionConfig;\n\n  // Dimension configuration\n  dimension?: boolean;\n  dimension_type?: DimensionType;\n  time_granularity?: TimeGranularity;\n  is_partition?: boolean;\n\n  // Entity configuration\n  entity?: boolean;\n  entity_type?: EntityType;\n  entity_role?: string;\n\n  // Common\n  semantic_expr?: string;\n  semantic_label?: string;\n  visibility?: 'internal' | 'agent' | 'public';\n}\n"],"mappings":";AAaO,IAAK,kBAAL,kBAAKA,qBAAL;AACL,EAAAA,iBAAA,SAAM;AACN,EAAAA,iBAAA,SAAM;AACN,EAAAA,iBAAA,SAAM;AACN,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,oBAAiB;AACjB,EAAAA,iBAAA,aAAU;AACV,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,gBAAa;AACb,EAAAA,iBAAA,iBAAc;AATJ,SAAAA;AAAA,GAAA;AAYL,IAAK,gBAAL,kBAAKC,mBAAL;AACL,EAAAA,eAAA,iBAAc;AACd,EAAAA,eAAA,UAAO;AAFG,SAAAA;AAAA,GAAA;AAKL,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,YAAS;AACT,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,aAAU;AAJA,SAAAA;AAAA,GAAA;AAOL,IAAK,aAAL,kBAAKC,gBAAL;AACL,EAAAA,YAAA,YAAS;AACT,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,WAAQ;AACR,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,gBAAa;AALH,SAAAA;AAAA,GAAA;AAcL,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,SAAM;AACN,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,aAAU;AACV,EAAAA,iBAAA,UAAO;AALG,SAAAA;AAAA,GAAA;","names":["AggregationType","DimensionType","EntityType","MetricType","TimeGranularity"]}

package/dist/chunk-XCEI7NUH.js

@@ -0,0 +1,41 @@
+import {
+  BaseRepository
+} from "./chunk-J6KZS54B.js";
+
+// runtime/base-classes/activity-entity-repository.ts
+import { eq, between, desc } from "drizzle-orm";
+var ActivityEntityRepository = class extends BaseRepository {
+  /**
+   * Find activities within a date range (inclusive).
+   */
+  async findByDateRange(start, end) {
+    const rows = await this.baseQuery().where(between(this.table["occurredAt"], start, end));
+    return rows;
+  }
+  /**
+   * Find all activities for a specific user.
+   */
+  async findByUserId(userId) {
+    const rows = await this.baseQuery().where(eq(this.table["userId"], userId));
+    return rows;
+  }
+  /**
+   * Find all activities for a specific opportunity.
+   */
+  async findByOpportunityId(opportunityId) {
+    const rows = await this.baseQuery().where(eq(this.table["opportunityId"], opportunityId));
+    return rows;
+  }
+  /**
+   * Find the most recent activities for an opportunity, ordered by occurredAt desc.
+   */
+  async findRecentByOpportunityId(opportunityId, limit = 10) {
+    const rows = await this.baseQuery().where(eq(this.table["opportunityId"], opportunityId)).orderBy(desc(this.table["occurredAt"])).limit(limit);
+    return rows;
+  }
+};
+
+export {
+  ActivityEntityRepository
+};
+//# sourceMappingURL=chunk-XCEI7NUH.js.map

package/dist/chunk-XCEI7NUH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/base-classes/activity-entity-repository.ts"],"sourcesContent":["/**\n * ActivityEntityRepository<TEntity>\n *\n * Family-specific base for activity entities (emails, calls, meetings, notes).\n * Adds date-range queries, user/opportunity scoping, and recency ordering.\n *\n * Concrete repos extend this and declare their table + behaviors.\n */\nimport { eq, between, desc } from 'drizzle-orm';\nimport { BaseRepository } from './base-repository';\n\nexport abstract class ActivityEntityRepository<TEntity> extends BaseRepository<TEntity> {\n  /**\n   * Find activities within a date range (inclusive).\n   */\n  async findByDateRange(start: Date, end: Date): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(between(this.table['occurredAt'], start, end));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find all activities for a specific user.\n   */\n  async findByUserId(userId: string): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table['userId'], userId));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find all activities for a specific opportunity.\n   */\n  async findByOpportunityId(opportunityId: string): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table['opportunityId'], opportunityId));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find the most recent activities for an opportunity, ordered by occurredAt desc.\n   */\n  async findRecentByOpportunityId(opportunityId: string, limit = 10): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table['opportunityId'], opportunityId))\n      .orderBy(desc(this.table['occurredAt']))\n      .limit(limit);\n    return rows as TEntity[];\n  }\n}\n"],"mappings":";;;;;AAQA,SAAS,IAAI,SAAS,YAAY;AAG3B,IAAe,2BAAf,cAAyD,eAAwB;AAAA;AAAA;AAAA;AAAA,EAItF,MAAM,gBAAgB,OAAa,KAA+B;AAChE,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,QAAQ,KAAK,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC;AACtD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,QAAoC;AACrD,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,QAAQ,GAAG,MAAM,CAAC;AACzC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,oBAAoB,eAA2C;AACnE,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,eAAe,GAAG,aAAa,CAAC;AACvD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,0BAA0B,eAAuB,QAAQ,IAAwB;AACrF,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,eAAe,GAAG,aAAa,CAAC,EACpD,QAAQ,KAAK,KAAK,MAAM,YAAY,CAAC,CAAC,EACtC,MAAM,KAAK;AACd,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/chunk-Y7GDG744.js

@@ -0,0 +1,88 @@
+import {
+  ERROR_RESPONSE_SCHEMA_NAME,
+  errorResponseSchema
+} from "./chunk-SOVM2VEK.js";
+import {
+  DuplicateSchemaError,
+  OpenApiPeerDepMissingError
+} from "./chunk-YSLTTQLC.js";
+
+// runtime/shared/openapi/registry.ts
+var OpenApiRegistry = class {
+  zodSchemas = /* @__PURE__ */ new Map();
+  pathEntries = /* @__PURE__ */ new Map();
+  peer = null;
+  constructor() {
+    this.zodSchemas.set(ERROR_RESPONSE_SCHEMA_NAME, errorResponseSchema);
+  }
+  registerSchema(name, schema) {
+    if (this.zodSchemas.has(name)) {
+      throw new DuplicateSchemaError(name);
+    }
+    this.zodSchemas.set(name, schema);
+  }
+  registerPath(path, method, spec) {
+    let methods = this.pathEntries.get(path);
+    if (!methods) {
+      methods = /* @__PURE__ */ new Map();
+      this.pathEntries.set(path, methods);
+    }
+    methods.set(method, spec);
+  }
+  /**
+   * Emit the full OpenAPI document. Lazy-imports `@anatine/zod-openapi`
+   * on first call; failure to resolve raises `OpenApiPeerDepMissingError`
+   * (matches the `CubeAnalyticsBackend.onModuleInit` precedent).
+   *
+   * OpenAPI version is pinned to `3.0.3` — Swagger UI tooling is most
+   * stable on 3.0.x (see OPENAPI-PHASE-1-PLAN §Four locked decisions).
+   */
+  async build(info) {
+    const peer = await this.loadPeer();
+    const schemas = {};
+    for (const [name, zodSchema] of this.zodSchemas) {
+      schemas[name] = peer.generateSchema(zodSchema, false, "3.0");
+    }
+    const paths = {};
+    for (const [path, methods] of this.pathEntries) {
+      const methodMap = {};
+      for (const [method, spec] of methods) {
+        methodMap[method] = spec;
+      }
+      paths[path] = methodMap;
+    }
+    return {
+      openapi: "3.0.3",
+      info,
+      paths,
+      components: { schemas }
+    };
+  }
+  /**
+   * Test helper — clears registered schemas and paths, then re-seeds the
+   * core `ErrorResponseDto` entry so post-reset state matches the
+   * invariant established in the constructor.
+   */
+  reset() {
+    this.zodSchemas.clear();
+    this.pathEntries.clear();
+    this.peer = null;
+    this.zodSchemas.set(ERROR_RESPONSE_SCHEMA_NAME, errorResponseSchema);
+  }
+  async loadPeer() {
+    if (this.peer) return this.peer;
+    try {
+      const specifier = "@anatine/zod-openapi";
+      const mod = await import(specifier);
+      this.peer = mod;
+      return mod;
+    } catch {
+      throw new OpenApiPeerDepMissingError();
+    }
+  }
+};
+
+export {
+  OpenApiRegistry
+};
+//# sourceMappingURL=chunk-Y7GDG744.js.map

package/dist/chunk-Y7GDG744.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/shared/openapi/registry.ts"],"sourcesContent":["/**\n * OpenApiRegistry — collects Zod schemas and path specs, emits a\n * complete `OpenAPIObject` on `build()` (OPENAPI-1).\n *\n * Wraps `@anatine/zod-openapi` as an **optional peer dependency** using\n * the lazy-import pattern from `runtime/subsystems/analytics/cube-backend.ts`\n * — consumer apps that never call `build()` still boot even if\n * `@anatine/zod-openapi` isn't installed.\n *\n * The registry is the single source of truth consumed by OPENAPI-2\n * (generated DTOs register their Zod schemas at module init), OPENAPI-3\n * (controller decorators reference those schemas), and OPENAPI-4\n * (Swagger UI bootstrap calls `build()` once at startup).\n */\nimport type { z } from 'zod';\n\nimport { ERROR_RESPONSE_SCHEMA_NAME, errorResponseSchema } from './error-response.dto';\nimport { OpenApiPeerDepMissingError, DuplicateSchemaError } from './errors';\n\nexport type HttpMethod = 'get' | 'post' | 'patch' | 'delete' | 'put';\n\n/**\n * OpenAPI path spec. Structurally compatible with `openapi3-ts`'s\n * `OperationObject` but typed loosely here because the peer type package\n * isn't installed as a direct dep — consumers supply whatever their\n * codegen emits.\n */\nexport interface PathSpec {\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  tags?: string[];\n  parameters?: unknown[];\n  requestBody?: unknown;\n  responses?: Record<string, unknown>;\n  security?: unknown[];\n  [key: string]: unknown;\n}\n\nexport interface OpenAPIInfo {\n  title: string;\n  version: string;\n  description?: string;\n}\n\n/**\n * Minimal OpenAPIObject shape. We redeclare rather than pull\n * `openapi3-ts` types through the peer — the peer's `generateSchema`\n * returns a `SchemaObject`, but the final document assembly is ours.\n */\nexport interface OpenAPIObject {\n  openapi: string;\n  info: OpenAPIInfo;\n  paths: Record<string, Record<string, PathSpec>>;\n  components: {\n    schemas: Record<string, unknown>;\n  };\n}\n\ninterface PeerModule {\n  generateSchema: (zodRef: unknown, useOutput?: boolean, version?: '3.0' | '3.1') => unknown;\n}\n\nexport class OpenApiRegistry {\n  private zodSchemas = new Map<string, z.ZodType>();\n  private pathEntries = new Map<string, Map<HttpMethod, PathSpec>>();\n  private peer: PeerModule | null = null;\n\n  constructor() {\n    // Auto-register the shared error response schema so controllers that\n    // reference `#/components/schemas/ErrorResponseDto` always resolve\n    // (OPENAPI-3). Consumers can `reset()` + re-register in tests.\n    this.zodSchemas.set(ERROR_RESPONSE_SCHEMA_NAME, errorResponseSchema);\n  }\n\n  registerSchema(name: string, schema: z.ZodType): void {\n    if (this.zodSchemas.has(name)) {\n      throw new DuplicateSchemaError(name);\n    }\n    this.zodSchemas.set(name, schema);\n  }\n\n  registerPath(path: string, method: HttpMethod, spec: PathSpec): void {\n    let methods = this.pathEntries.get(path);\n    if (!methods) {\n      methods = new Map();\n      this.pathEntries.set(path, methods);\n    }\n    methods.set(method, spec);\n  }\n\n  /**\n   * Emit the full OpenAPI document. Lazy-imports `@anatine/zod-openapi`\n   * on first call; failure to resolve raises `OpenApiPeerDepMissingError`\n   * (matches the `CubeAnalyticsBackend.onModuleInit` precedent).\n   *\n   * OpenAPI version is pinned to `3.0.3` — Swagger UI tooling is most\n   * stable on 3.0.x (see OPENAPI-PHASE-1-PLAN §Four locked decisions).\n   */\n  async build(info: OpenAPIInfo): Promise<OpenAPIObject> {\n    const peer = await this.loadPeer();\n\n    const schemas: Record<string, unknown> = {};\n    for (const [name, zodSchema] of this.zodSchemas) {\n      schemas[name] = peer.generateSchema(zodSchema, false, '3.0');\n    }\n\n    const paths: Record<string, Record<string, PathSpec>> = {};\n    for (const [path, methods] of this.pathEntries) {\n      const methodMap: Record<string, PathSpec> = {};\n      for (const [method, spec] of methods) {\n        methodMap[method] = spec;\n      }\n      paths[path] = methodMap;\n    }\n\n    return {\n      openapi: '3.0.3',\n      info,\n      paths,\n      components: { schemas },\n    };\n  }\n\n  /**\n   * Test helper — clears registered schemas and paths, then re-seeds the\n   * core `ErrorResponseDto` entry so post-reset state matches the\n   * invariant established in the constructor.\n   */\n  reset(): void {\n    this.zodSchemas.clear();\n    this.pathEntries.clear();\n    this.peer = null;\n    this.zodSchemas.set(ERROR_RESPONSE_SCHEMA_NAME, errorResponseSchema);\n  }\n\n  protected async loadPeer(): Promise<PeerModule> {\n    if (this.peer) return this.peer;\n    try {\n      // Computed specifier: prevents tsc from resolving this import at\n      // typecheck time. Consumers vendor this file but may not install\n      // @anatine/zod-openapi (optional peer).\n      const specifier: string = '@anatine/zod-openapi';\n      const mod = (await import(specifier)) as PeerModule;\n      this.peer = mod;\n      return mod;\n    } catch {\n      throw new OpenApiPeerDepMissingError();\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AA+DO,IAAM,kBAAN,MAAsB;AAAA,EACnB,aAAa,oBAAI,IAAuB;AAAA,EACxC,cAAc,oBAAI,IAAuC;AAAA,EACzD,OAA0B;AAAA,EAElC,cAAc;AAIZ,SAAK,WAAW,IAAI,4BAA4B,mBAAmB;AAAA,EACrE;AAAA,EAEA,eAAe,MAAc,QAAyB;AACpD,QAAI,KAAK,WAAW,IAAI,IAAI,GAAG;AAC7B,YAAM,IAAI,qBAAqB,IAAI;AAAA,IACrC;AACA,SAAK,WAAW,IAAI,MAAM,MAAM;AAAA,EAClC;AAAA,EAEA,aAAa,MAAc,QAAoB,MAAsB;AACnE,QAAI,UAAU,KAAK,YAAY,IAAI,IAAI;AACvC,QAAI,CAAC,SAAS;AACZ,gBAAU,oBAAI,IAAI;AAClB,WAAK,YAAY,IAAI,MAAM,OAAO;AAAA,IACpC;AACA,YAAQ,IAAI,QAAQ,IAAI;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,MAAM,MAA2C;AACrD,UAAM,OAAO,MAAM,KAAK,SAAS;AAEjC,UAAM,UAAmC,CAAC;AAC1C,eAAW,CAAC,MAAM,SAAS,KAAK,KAAK,YAAY;AAC/C,cAAQ,IAAI,IAAI,KAAK,eAAe,WAAW,OAAO,KAAK;AAAA,IAC7D;AAEA,UAAM,QAAkD,CAAC;AACzD,eAAW,CAAC,MAAM,OAAO,KAAK,KAAK,aAAa;AAC9C,YAAM,YAAsC,CAAC;AAC7C,iBAAW,CAAC,QAAQ,IAAI,KAAK,SAAS;AACpC,kBAAU,MAAM,IAAI;AAAA,MACtB;AACA,YAAM,IAAI,IAAI;AAAA,IAChB;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT;AAAA,MACA;AAAA,MACA,YAAY,EAAE,QAAQ;AAAA,IACxB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAc;AACZ,SAAK,WAAW,MAAM;AACtB,SAAK,YAAY,MAAM;AACvB,SAAK,OAAO;AACZ,SAAK,WAAW,IAAI,4BAA4B,mBAAmB;AAAA,EACrE;AAAA,EAEA,MAAgB,WAAgC;AAC9C,QAAI,KAAK,KAAM,QAAO,KAAK;AAC3B,QAAI;AAIF,YAAM,YAAoB;AAC1B,YAAM,MAAO,MAAM,OAAO;AAC1B,WAAK,OAAO;AACZ,aAAO;AAAA,IACT,QAAQ;AACN,YAAM,IAAI,2BAA2B;AAAA,IACvC;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-Y7RRSEOC.js

@@ -0,0 +1,9 @@
+// runtime/subsystems/observability/observability.tokens.ts
+var OBSERVABILITY = "OBSERVABILITY";
+var OBSERVABILITY_MODULE_OPTIONS = "OBSERVABILITY_MODULE_OPTIONS";
+
+export {
+  OBSERVABILITY,
+  OBSERVABILITY_MODULE_OPTIONS
+};
+//# sourceMappingURL=chunk-Y7RRSEOC.js.map

package/dist/chunk-Y7RRSEOC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/observability/observability.tokens.ts"],"sourcesContent":["/**\n * Observability combiner subsystem — DI tokens (ADR-025, OBS-5).\n *\n * String constants (not Symbols), matching the events / bridge / integration\n * convention. The jobs subsystem uses Symbols for its analogous tokens;\n * observability stays internally consistent with its sibling combiner\n * (bridge) because the two are structurally paired (ADR-025).\n *\n * Usage in consumers:\n * ```ts\n * constructor(@Inject(OBSERVABILITY) private readonly obs: IObservability) {}\n * ```\n */\n\n/**\n * Token for the `IObservability` composer facade (OBS-5). Resolves to the\n * single `ObservabilityService` instance registered by\n * `ObservabilityModule.forRoot(...)`.\n */\nexport const OBSERVABILITY = 'OBSERVABILITY' as const;\n\n/**\n * Token for the resolved `ObservabilityModuleOptions` object. Provided by\n * `ObservabilityModule.forRoot(...)`. Reserved for phase 2 — the current\n * options shape is empty; OBS-6 will extend it with a `reporters` field.\n */\nexport const OBSERVABILITY_MODULE_OPTIONS = 'OBSERVABILITY_MODULE_OPTIONS' as const;\n"],"mappings":";AAmBO,IAAM,gBAAgB;AAOtB,IAAM,+BAA+B;","names":[]}

package/dist/chunk-YLPAPPLW.js

@@ -0,0 +1,75 @@
+// runtime/subsystems/integration/webhook-change-source.ts
+var WebhookChangeSource = class {
+  label;
+  queue;
+  externalIdSourceField;
+  eventIdSourceField;
+  composed;
+  constructor(opts) {
+    if (opts.config.mode !== "webhook") {
+      throw new Error(
+        `WebhookChangeSource requires DetectionConfig.mode === 'webhook'; got '${opts.config.mode}'`
+      );
+    }
+    const config = opts.config;
+    const externalIdMapping = config.mapping.find(
+      (m) => m.target === "external_id"
+    );
+    if (!externalIdMapping) {
+      throw new Error(
+        "WebhookChangeSource: DetectionConfig.mapping must include an entry with target 'external_id' so emitted Change<T>.externalId can be populated"
+      );
+    }
+    this.externalIdSourceField = externalIdMapping.source;
+    this.eventIdSourceField = config.webhook.eventIdField;
+    this.queue = opts.queue;
+    this.label = opts.label ?? `webhook-change-source:${externalIdMapping.source}`;
+    const inner = (sub, cur) => this.fetch(sub, cur);
+    const middlewares = opts.middlewares ?? [];
+    this.composed = middlewares.reduceRight(
+      (next, mw) => mw(next),
+      inner
+    );
+  }
+  listChanges(subscription, cursor) {
+    return this.composed(subscription, cursor);
+  }
+  async *fetch(subscription, cursor) {
+    const ctx = {
+      subscription,
+      cursor
+    };
+    for await (const { record, cursor: nextCursor } of this.queue(ctx)) {
+      const externalIdRaw = record[this.externalIdSourceField];
+      if (typeof externalIdRaw !== "string" || externalIdRaw.length === 0) {
+        throw new Error(
+          `WebhookChangeSource: record missing string '${this.externalIdSourceField}' \u2014 emitted records MUST carry the canonical external id keyed by the mapping source`
+        );
+      }
+      const eventIdRaw = record[this.eventIdSourceField];
+      if (typeof eventIdRaw !== "string" || eventIdRaw.length === 0) {
+        throw new Error(
+          `WebhookChangeSource: record missing string '${this.eventIdSourceField}' \u2014 webhook records MUST carry the event id (DetectionConfig.webhook.eventIdField) so Change<T>.dedupKey can be populated`
+        );
+      }
+      const change = {
+        externalId: externalIdRaw,
+        // Webhook mode cannot distinguish create vs. update vs. delete on
+        // its own — the orchestrator's diff stage handles classification.
+        // Tombstone / soft-delete detection is consumer-driven (same as
+        // poll mode — see ADR-033).
+        operation: "updated",
+        record,
+        cursor: nextCursor ?? null,
+        source: "webhook",
+        dedupKey: eventIdRaw
+      };
+      yield change;
+    }
+  }
+};
+
+export {
+  WebhookChangeSource
+};
+//# sourceMappingURL=chunk-YLPAPPLW.js.map

package/dist/chunk-YLPAPPLW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/integration/webhook-change-source.ts"],"sourcesContent":["/**\n * Integration subsystem — `WebhookChangeSource<T>` primitive (#226-4, ADR-033).\n *\n * Generic webhook-mode `IChangeSource<T>` implementation parameterized by a\n * parsed `DetectionConfig` (webhook mode) and a consumer-supplied\n * `WebhookFetchCallback<T>` that iterates a consumer-owned inbound staging\n * queue. The primitive owns:\n *\n *   - canonical `Change<T>.source = 'webhook'` stamping;\n *   - `dedupKey` derivation from the configured `webhook.eventIdField` on\n *     the emitted record;\n *   - `externalId` derivation: the mapping entry whose `target === 'external_id'`\n *     names — via its `source` — the field on the emitted record that carries\n *     the canonical external id (mirrors `PollChangeSource`);\n *   - middleware-chain composition via the locked `ChangeMiddleware<T>` shape\n *     (#226-1) — same composition seam as the poll primitive.\n *\n * The primitive is **passive**: it iterates whatever the consumer-owned\n * queue yields. It does NOT synchronously drive the orchestrator, does NOT\n * own a transport, and does NOT manage acks. The inbound staging table\n * schema is consumer-owned and deferred per ADR-0002 §Phase 4 — the\n * `WebhookFetchCallback<T>` is the queue contract the consumer injects.\n *\n * Shape locks (decision memo Q5, mirrored from poll primitive):\n *   - `WebhookFetchContext = { subscription, cursor }` — explicitly NO\n *     `userId` / `tenantId`. Run-scope identity is closed over by the\n *     consumer at queue construction or resolved inside the callback via\n *     consumer services. There are no `filters` on the webhook context —\n *     filtering is done at registration / on the staging row, not at the\n *     port seam (the queue is already filtered by the time the primitive\n *     iterates).\n *\n * Long-lived streaming CDC primitives (SFDC Pub-Sub gRPC, Debezium/Kafka,\n * Postgres logical replication) are deferred to `#226-8` — they need a\n * fundamentally different lifecycle (`subscribe(onChange, onError)`,\n * server-paced backpressure, ack-on-yield) and shouldn't be retrofitted\n * into either this primitive or the poll primitive.\n */\n\nimport type { DetectionConfig } from './detection-config.schema';\nimport type {\n  Change,\n  IChangeSource,\n  IntegrationSubscriptionView,\n} from './integration-change-source.protocol';\nimport type {\n  ChangeIterator,\n  ChangeMiddleware,\n} from './integration-middleware.protocol';\n\n// ============================================================================\n// Cursor + queue callback shapes\n// ============================================================================\n\n/**\n * Opaque webhook cursor shape. Webhook mode typically has a cursor of\n * `{ ts: ISO-string }` (last drained staging-row timestamp) but the\n * primitive treats it as opaque. Consumer-owned queue iterators interpret\n * it however the staging schema needs.\n */\nexport type WebhookCursor = unknown;\n\n/**\n * Context the primitive forwards to the queue iterator. Locked to exactly\n * two fields per the same Q5 reasoning that locks `PollFetchContext` — no\n * `userId` / `tenantId`.\n */\nexport interface WebhookFetchContext {\n  readonly subscription: IntegrationSubscriptionView;\n  readonly cursor: WebhookCursor | null;\n}\n\n/**\n * Consumer-supplied queue iterator. Returns an async iterable of\n * `{ record }` pairs — the consumer drains the inbound staging queue and\n * emits already-mapped canonical records `T`. The primitive stamps\n * `source: 'webhook'` and `dedupKey` from the record's configured\n * `webhook.eventIdField`; the consumer is the one who decided when a\n * staging row is \"ready\" to drain.\n *\n * Webhook mode has no per-record cursor advance — the staging-row drain\n * order is consumer policy (FIFO by ingestion timestamp, by event id, etc.)\n * and is opaque to the primitive. The orchestrator's last-yielded cursor\n * is whatever the consumer chooses to surface, if anything.\n */\nexport type WebhookFetchCallback<T> = (\n  ctx: WebhookFetchContext,\n) => AsyncIterable<{ record: T; cursor?: WebhookCursor }>;\n\n// ============================================================================\n// Constructor options\n// ============================================================================\n\nexport interface WebhookChangeSourceOptions<T> {\n  /** Consumer-supplied inbound queue iterator. */\n  readonly queue: WebhookFetchCallback<T>;\n  /**\n   * Parsed detection config. MUST be `mode: 'webhook'`; the constructor\n   * throws if a poll config is supplied. Codegen-emitted factories call\n   * `DetectionConfigSchema.parse(...)` upstream so this is a safety net,\n   * not the primary validation point.\n   */\n  readonly config: DetectionConfig;\n  /**\n   * Optional middleware chain. Same shape and composition rules as\n   * `PollChangeSource` — first element is the outermost layer.\n   */\n  readonly middlewares?: ReadonlyArray<ChangeMiddleware<T>>;\n  /**\n   * Optional human label for run logs (e.g. `'stripe-webhook-charge'`).\n   * Defaults to a derived label based on the mapping at construction.\n   */\n  readonly label?: string;\n}\n\n// ============================================================================\n// WebhookChangeSource<T>\n// ============================================================================\n\nexport class WebhookChangeSource<T> implements IChangeSource<T> {\n  public readonly label: string;\n\n  private readonly queue: WebhookFetchCallback<T>;\n  private readonly externalIdSourceField: string;\n  private readonly eventIdSourceField: string;\n  private readonly composed: ChangeIterator<T>;\n\n  constructor(opts: WebhookChangeSourceOptions<T>) {\n    if (opts.config.mode !== 'webhook') {\n      throw new Error(\n        `WebhookChangeSource requires DetectionConfig.mode === 'webhook'; got '${(opts.config as { mode: string }).mode}'`,\n      );\n    }\n    const config = opts.config;\n\n    // Field mapping: locate the entry whose canonical `target` is `external_id`\n    // — mirrors the poll primitive's contract. Adapters emit records\n    // already-mapped; the primitive needs to know which key on T carries the\n    // external id so it can stamp `Change.externalId`. That key is the\n    // mapping's `source` (the field on the emitted record), NOT its `target`\n    // (the canonical column) — they differ whenever the canonical record is\n    // vendor-neutral camelCase (e.g. `source: 'externalId'` → `target: 'external_id'`).\n    const externalIdMapping = config.mapping.find(\n      (m) => m.target === 'external_id',\n    );\n    if (!externalIdMapping) {\n      throw new Error(\n        \"WebhookChangeSource: DetectionConfig.mapping must include an entry with target 'external_id' so emitted Change<T>.externalId can be populated\",\n      );\n    }\n    this.externalIdSourceField = externalIdMapping.source;\n    this.eventIdSourceField = config.webhook.eventIdField;\n\n    this.queue = opts.queue;\n\n    this.label =\n      opts.label ?? `webhook-change-source:${externalIdMapping.source}`;\n\n    // Compose middleware chain — same shape as PollChangeSource.\n    const inner: ChangeIterator<T> = (sub, cur) => this.fetch(sub, cur);\n    const middlewares = opts.middlewares ?? [];\n    this.composed = middlewares.reduceRight<ChangeIterator<T>>(\n      (next, mw) => mw(next),\n      inner,\n    );\n  }\n\n  listChanges(\n    subscription: IntegrationSubscriptionView,\n    cursor: unknown | null,\n  ): AsyncIterable<Change<T>> {\n    return this.composed(subscription, cursor);\n  }\n\n  private async *fetch(\n    subscription: IntegrationSubscriptionView,\n    cursor: unknown | null,\n  ): AsyncIterable<Change<T>> {\n    const ctx: WebhookFetchContext = {\n      subscription,\n      cursor: cursor as WebhookCursor | null,\n    };\n\n    for await (const { record, cursor: nextCursor } of this.queue(ctx)) {\n      const externalIdRaw = (record as Record<string, unknown>)[\n        this.externalIdSourceField\n      ];\n      if (typeof externalIdRaw !== 'string' || externalIdRaw.length === 0) {\n        throw new Error(\n          `WebhookChangeSource: record missing string '${this.externalIdSourceField}' — emitted records MUST carry the canonical external id keyed by the mapping source`,\n        );\n      }\n      const eventIdRaw = (record as Record<string, unknown>)[\n        this.eventIdSourceField\n      ];\n      if (typeof eventIdRaw !== 'string' || eventIdRaw.length === 0) {\n        throw new Error(\n          `WebhookChangeSource: record missing string '${this.eventIdSourceField}' — webhook records MUST carry the event id (DetectionConfig.webhook.eventIdField) so Change<T>.dedupKey can be populated`,\n        );\n      }\n\n      const change: Change<T> = {\n        externalId: externalIdRaw,\n        // Webhook mode cannot distinguish create vs. update vs. delete on\n        // its own — the orchestrator's diff stage handles classification.\n        // Tombstone / soft-delete detection is consumer-driven (same as\n        // poll mode — see ADR-033).\n        operation: 'updated',\n        record,\n        cursor: nextCursor ?? null,\n        source: 'webhook',\n        dedupKey: eventIdRaw,\n      };\n      yield change;\n    }\n  }\n}\n"],"mappings":";AAuHO,IAAM,sBAAN,MAAyD;AAAA,EAC9C;AAAA,EAEC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,MAAqC;AAC/C,QAAI,KAAK,OAAO,SAAS,WAAW;AAClC,YAAM,IAAI;AAAA,QACR,yEAA0E,KAAK,OAA4B,IAAI;AAAA,MACjH;AAAA,IACF;AACA,UAAM,SAAS,KAAK;AASpB,UAAM,oBAAoB,OAAO,QAAQ;AAAA,MACvC,CAAC,MAAM,EAAE,WAAW;AAAA,IACtB;AACA,QAAI,CAAC,mBAAmB;AACtB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AACA,SAAK,wBAAwB,kBAAkB;AAC/C,SAAK,qBAAqB,OAAO,QAAQ;AAEzC,SAAK,QAAQ,KAAK;AAElB,SAAK,QACH,KAAK,SAAS,yBAAyB,kBAAkB,MAAM;AAGjE,UAAM,QAA2B,CAAC,KAAK,QAAQ,KAAK,MAAM,KAAK,GAAG;AAClE,UAAM,cAAc,KAAK,eAAe,CAAC;AACzC,SAAK,WAAW,YAAY;AAAA,MAC1B,CAAC,MAAM,OAAO,GAAG,IAAI;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,YACE,cACA,QAC0B;AAC1B,WAAO,KAAK,SAAS,cAAc,MAAM;AAAA,EAC3C;AAAA,EAEA,OAAe,MACb,cACA,QAC0B;AAC1B,UAAM,MAA2B;AAAA,MAC/B;AAAA,MACA;AAAA,IACF;AAEA,qBAAiB,EAAE,QAAQ,QAAQ,WAAW,KAAK,KAAK,MAAM,GAAG,GAAG;AAClE,YAAM,gBAAiB,OACrB,KAAK,qBACP;AACA,UAAI,OAAO,kBAAkB,YAAY,cAAc,WAAW,GAAG;AACnE,cAAM,IAAI;AAAA,UACR,+CAA+C,KAAK,qBAAqB;AAAA,QAC3E;AAAA,MACF;AACA,YAAM,aAAc,OAClB,KAAK,kBACP;AACA,UAAI,OAAO,eAAe,YAAY,WAAW,WAAW,GAAG;AAC7D,cAAM,IAAI;AAAA,UACR,+CAA+C,KAAK,kBAAkB;AAAA,QACxE;AAAA,MACF;AAEA,YAAM,SAAoB;AAAA,QACxB,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,QAKZ,WAAW;AAAA,QACX;AAAA,QACA,QAAQ,cAAc;AAAA,QACtB,QAAQ;AAAA,QACR,UAAU;AAAA,MACZ;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}