@pattern-stack/codegen 0.15.1 → 0.15.2

package/dist/chunk-36U5UGIO.js

@@ -0,0 +1,107 @@
+import {
+  __decorateClass
+} from "./chunk-2E224ZSN.js";
+
+// runtime/subsystems/integration/deep-equal.differ.ts
+import { Injectable } from "@nestjs/common";
+var DEFAULT_IGNORE_FIELDS = /* @__PURE__ */ new Set([
+  "id",
+  "createdAt",
+  "updatedAt",
+  "deletedAt",
+  "type",
+  "lastModifiedAt",
+  "fields",
+  "external_id",
+  "externalId",
+  "provider",
+  "provider_metadata",
+  "providerMetadata"
+]);
+var DeepEqualDiffer = class {
+  ignore;
+  constructor(opts = {}) {
+    if (opts.ignore && opts.ignore.length > 0) {
+      this.ignore = /* @__PURE__ */ new Set([...DEFAULT_IGNORE_FIELDS, ...opts.ignore]);
+    } else {
+      this.ignore = DEFAULT_IGNORE_FIELDS;
+    }
+  }
+  diff(existing, incoming, providerChangedFields) {
+    if (existing === null) {
+      const out2 = {};
+      for (const key of Object.keys(incoming)) {
+        if (this.ignore.has(key)) continue;
+        const value = incoming[key];
+        if (value === null || value === void 0) continue;
+        out2[key] = { from: null, to: value };
+      }
+      return Object.keys(out2).length === 0 ? "noop" : out2;
+    }
+    const candidates = /* @__PURE__ */ new Set();
+    if (providerChangedFields && providerChangedFields.length > 0) {
+      for (const key of providerChangedFields) {
+        if (!this.ignore.has(key)) candidates.add(key);
+      }
+    } else {
+      for (const key of Object.keys(incoming)) {
+        if (!this.ignore.has(key)) candidates.add(key);
+      }
+      for (const key of Object.keys(existing)) {
+        if (this.ignore.has(key)) continue;
+        if (!(key in incoming)) continue;
+        candidates.add(key);
+      }
+    }
+    const out = {};
+    for (const key of candidates) {
+      const before = existing[key];
+      const after = incoming[key];
+      if (!isEqual(before, after)) {
+        out[key] = { from: before ?? null, to: after ?? null };
+      }
+    }
+    return Object.keys(out).length === 0 ? "noop" : out;
+  }
+};
+DeepEqualDiffer = __decorateClass([
+  Injectable()
+], DeepEqualDiffer);
+function isEqual(a, b) {
+  if (a === b) return true;
+  const na = normalize(a);
+  const nb = normalize(b);
+  if (na === nb) return true;
+  if (typeof na === "object" && typeof nb === "object" && na !== null && nb !== null) {
+    return deepEqualObject(na, nb);
+  }
+  const numericEqual = maybeNumericEqual(na, nb) || maybeNumericEqual(nb, na);
+  return numericEqual;
+}
+function normalize(value) {
+  if (value instanceof Date) return value.toISOString();
+  return value;
+}
+function maybeNumericEqual(a, b) {
+  if (typeof a !== "string" || typeof b !== "number") return false;
+  if (a.trim() === "") return false;
+  const parsed = Number(a);
+  if (!Number.isFinite(parsed)) return false;
+  return parsed === b;
+}
+function deepEqualObject(a, b) {
+  if (Array.isArray(a) !== Array.isArray(b)) return false;
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  for (const key of aKeys) {
+    if (!(key in b)) return false;
+    if (!isEqual(a[key], b[key])) return false;
+  }
+  return true;
+}
+
+export {
+  DeepEqualDiffer
+};
+//# sourceMappingURL=chunk-36U5UGIO.js.map

package/dist/chunk-36U5UGIO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/integration/deep-equal.differ.ts"],"sourcesContent":["/**\n * DeepEqualDiffer — default `IFieldDiffer<T>` for the integration subsystem (SYNC-5).\n *\n * Walks every field of `incoming` against `existing`, emitting a structured\n * per-field diff (`{ from, to }`) for every field whose value changed.\n * Returns `'noop'` when the record is unchanged.\n *\n * Design decisions (extracted from the upstream consumer + HS-9 findings):\n *\n * 1. **Ignore list** — row metadata that sinks/services stamp unconditionally\n *    so upstream cannot reasonably disagree:\n *      `id`, `createdAt`, `updatedAt`, `deletedAt`, `type`,\n *      `lastModifiedAt`, `fields`, `providerMetadata`\n *    (`fields` is the EAV bag — it's diffed by the sink's EAV dual-write\n *    path, not at the canonical-record layer.)\n *\n * 2. **`providerChangedFields` hint (CDC)** — when present, restricts the\n *    comparison to the hinted field set. The hint is advisory; fields in\n *    the ignore list are still filtered out even when hinted. Provider\n *    hints are field-NAME-level; they don't override the ignore rules.\n *\n * 3. **Date → ISO string** — `Date` instances are normalized to\n *    `toISOString()` before comparison. Sinks return `Date` from the DB\n *    driver; adapters typically deliver strings. Direct `===` would\n *    always say \"changed.\"\n *\n * 4. **Decimal-string vs number** — Postgres `numeric` columns return as\n *    strings through Drizzle; adapters deliver numbers. When one side is a\n *    number and the other is a numeric string that parses to the same\n *    number, they're equal. The normalizer does NOT coerce non-numeric\n *    strings, and it preserves zero-vs-null distinction.\n *\n * 5. **null-existing path** — `diff(null, incoming)` produces a full\n *    created-shape diff (`{from: null, to: <value>}` for every non-ignored\n *    field). Orchestrator sees this and records `operation: 'created'`.\n */\nimport { Injectable } from '@nestjs/common';\nimport type {\n  DiffResult,\n  FieldDiff,\n  IFieldDiffer,\n} from './integration-field-diff.protocol';\n\n/**\n * Default ignore list. Keep in integration with consumer canonical-record shapes —\n * adding a row-metadata field here means no integration will ever mark it changed.\n *\n * Includes the columns contributed by the `external_id_tracking` behavior\n * (`external_id`/`externalId`, `provider`, `provider_metadata`/`providerMetadata`).\n * These are integration-tracking metadata, not domain attributes: they ride on the\n * canonical record but must never register as a field change (the external id\n * is the record's identity, not a mutable value). Listed in both snake_case\n * and camelCase so the differ ignores them regardless of the consumer's\n * canonical projection casing.\n */\nconst DEFAULT_IGNORE_FIELDS: ReadonlySet<string> = new Set([\n  'id',\n  'createdAt',\n  'updatedAt',\n  'deletedAt',\n  'type',\n  'lastModifiedAt',\n  'fields',\n  'external_id',\n  'externalId',\n  'provider',\n  'provider_metadata',\n  'providerMetadata',\n]);\n\nexport interface DeepEqualDifferOptions {\n  /**\n   * Extra field names to ignore in addition to the defaults. Consumers can\n   * pass `['integration_version']` etc. to augment the base list; values here are\n   * merged (not replaced) with `DEFAULT_IGNORE_FIELDS`.\n   */\n  readonly ignore?: readonly string[];\n}\n\n@Injectable()\nexport class DeepEqualDiffer<T extends Record<string, unknown>>\n  implements IFieldDiffer<T>\n{\n  private readonly ignore: ReadonlySet<string>;\n\n  constructor(opts: DeepEqualDifferOptions = {}) {\n    if (opts.ignore && opts.ignore.length > 0) {\n      this.ignore = new Set([...DEFAULT_IGNORE_FIELDS, ...opts.ignore]);\n    } else {\n      this.ignore = DEFAULT_IGNORE_FIELDS;\n    }\n  }\n\n  diff(\n    existing: T | null,\n    incoming: T,\n    providerChangedFields?: string[],\n  ): DiffResult {\n    // Created-shape: every non-ignored field becomes `{from: null, to}`.\n    if (existing === null) {\n      const out: FieldDiff = {};\n      for (const key of Object.keys(incoming)) {\n        if (this.ignore.has(key)) continue;\n        const value = (incoming as Record<string, unknown>)[key];\n        // Skip fields that are themselves null/undefined — a created record\n        // doesn't need to declare \"this field is null now\" for every\n        // untouched column.\n        if (value === null || value === undefined) continue;\n        out[key] = { from: null, to: value };\n      }\n      return Object.keys(out).length === 0 ? 'noop' : out;\n    }\n\n    // Field set to compare. `providerChangedFields` narrows to a hint set;\n    // ignored fields are filtered out regardless of hint.\n    const candidates = new Set<string>();\n    if (providerChangedFields && providerChangedFields.length > 0) {\n      for (const key of providerChangedFields) {\n        if (!this.ignore.has(key)) candidates.add(key);\n      }\n    } else {\n      for (const key of Object.keys(incoming)) {\n        if (!this.ignore.has(key)) candidates.add(key);\n      }\n      // Also include keys that exist on existing but not on incoming —\n      // e.g. a field that was cleared. This would otherwise be missed when\n      // incoming carries an undefined column we drop from the iteration.\n      for (const key of Object.keys(existing)) {\n        if (this.ignore.has(key)) continue;\n        if (!(key in (incoming as Record<string, unknown>))) continue;\n        candidates.add(key);\n      }\n    }\n\n    const out: FieldDiff = {};\n    for (const key of candidates) {\n      const before = (existing as Record<string, unknown>)[key];\n      const after = (incoming as Record<string, unknown>)[key];\n      if (!isEqual(before, after)) {\n        out[key] = { from: before ?? null, to: after ?? null };\n      }\n    }\n\n    return Object.keys(out).length === 0 ? 'noop' : out;\n  }\n}\n\n// ─── equality helpers ───────────────────────────────────────────────────────\n\n/**\n * Field-level equality with the canonical-integration normalizations:\n *   - Date → toISOString (adapters deliver strings)\n *   - numeric-string vs number → numeric equality when both parse\n *   - deep equality for plain objects/arrays (single-level is enough for\n *     canonical records; nested records travel as jsonb columns where the\n *     sink already owns the comparison)\n */\nfunction isEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n\n  const na = normalize(a);\n  const nb = normalize(b);\n  if (na === nb) return true;\n\n  // After normalization: both may still be non-primitive objects.\n  if (\n    typeof na === 'object' &&\n    typeof nb === 'object' &&\n    na !== null &&\n    nb !== null\n  ) {\n    return deepEqualObject(na as Record<string, unknown>, nb as Record<string, unknown>);\n  }\n\n  // Numeric string ↔ number: when one side is a number and the other is a\n  // string that parses to the same finite number.\n  const numericEqual = maybeNumericEqual(na, nb) || maybeNumericEqual(nb, na);\n  return numericEqual;\n}\n\nfunction normalize(value: unknown): unknown {\n  if (value instanceof Date) return value.toISOString();\n  return value;\n}\n\nfunction maybeNumericEqual(a: unknown, b: unknown): boolean {\n  // a is string-shape, b is number — parse a and compare. Only when the\n  // string looks numeric AND the parse round-trips (no silent NaN pass-\n  // through on non-numeric strings).\n  if (typeof a !== 'string' || typeof b !== 'number') return false;\n  if (a.trim() === '') return false;\n  const parsed = Number(a);\n  if (!Number.isFinite(parsed)) return false;\n  return parsed === b;\n}\n\nfunction deepEqualObject(\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n): boolean {\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  const aKeys = Object.keys(a);\n  const bKeys = Object.keys(b);\n  if (aKeys.length !== bKeys.length) return false;\n  for (const key of aKeys) {\n    if (!(key in b)) return false;\n    if (!isEqual(a[key], b[key])) return false;\n  }\n  return true;\n}\n"],"mappings":"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","names":["out"]}

package/dist/chunk-3CJFPU6Q.js

@@ -0,0 +1,14 @@
+// runtime/subsystems/integration/entity-change-source-registry.protocol.ts
+var UnknownEntityError = class extends Error {
+  constructor(entity, available) {
+    super(
+      `No change source registered for entity '${entity}'. Available: ${available.join(", ")}`
+    );
+    this.name = "UnknownEntityError";
+  }
+};
+
+export {
+  UnknownEntityError
+};
+//# sourceMappingURL=chunk-3CJFPU6Q.js.map

package/dist/chunk-3CJFPU6Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/integration/entity-change-source-registry.protocol.ts"],"sourcesContent":["/**\n * Integration subsystem — entity-keyed change-source registry (port)\n *\n * `IEntityChangeSourceRegistry` resolves an `IChangeSource<T>` by entity name.\n * It generalizes today's per-entity DI tokens (`ACCOUNT_POLL_FETCH_REGISTRY`,\n * `CONTACT_POLL_FETCH_REGISTRY`, …) into one entity-keyed registry, so the L3\n * composing port (`<Surface>Port`, Track C C6) can be entity-agnostic at the\n * type level instead of enumerating entities (epic #328 locked decision #5).\n *\n * This lives in L1 (the integration subsystem) rather than in a per-surface\n * package because the same shape applies across surfaces — CRM (`account`,\n * `contact`, `deal`), Mail (`email`, `thread`, `label`), Transcript\n * (`transcript`, `speaker`, `utterance`), Meeting (`meeting`, `attendee`).\n * Cross-surface plumbing belongs at L1 (epic #328 locked decision #6).\n *\n * Scope (Track C · C7): this is purely the L1 type + memory impl. Codegen does\n * NOT yet emit this registry, and the existing per-entity tokens keep emitting\n * unchanged — the retarget (and the per-entity-token deprecation) is Track D\n * D3/D4 (RFC-0001 §3/§8).\n *\n * See #336 (this issue), #328 (parent epic), RFC-0001 §3 (the registry\n * contract Track D emits the wiring for).\n */\n\nimport type { IChangeSource } from './integration-change-source.protocol';\n\n/**\n * Entity-keyed resolver for change sources. The orchestrator (and the L3\n * surface port) consume this, agnostic to whether a source came from a\n * hand-written adapter or a configured `PollChangeSource<T>`.\n */\nexport interface IEntityChangeSourceRegistry {\n  /**\n   * Resolve a change source for a given entity name.\n   * Throws {@link UnknownEntityError} if the entity isn't registered.\n   */\n  get<T = unknown>(entityName: string): IChangeSource<T>;\n\n  /** True if the entity is registered. */\n  has(entityName: string): boolean;\n\n  /** List all entity names this registry serves. */\n  entities(): readonly string[];\n}\n\n/**\n * Thrown by {@link IEntityChangeSourceRegistry.get} when no source is\n * registered for the requested entity. The message enumerates the available\n * entities so a misconfiguration (typo'd entity name, missing adapter\n * contribution) is diagnosable from the error alone.\n */\nexport class UnknownEntityError extends Error {\n  constructor(entity: string, available: readonly string[]) {\n    super(\n      `No change source registered for entity '${entity}'. Available: ${available.join(', ')}`,\n    );\n    this.name = 'UnknownEntityError';\n  }\n}\n"],"mappings":";AAmDO,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAC5C,YAAY,QAAgB,WAA8B;AACxD;AAAA,MACE,2CAA2C,MAAM,iBAAiB,UAAU,KAAK,IAAI,CAAC;AAAA,IACxF;AACA,SAAK,OAAO;AAAA,EACd;AACF;","names":[]}

package/dist/chunk-3NMCDN7L.js

@@ -0,0 +1,90 @@
+// runtime/subsystems/integration/detection-config.schema.ts
+import { z } from "zod";
+var FieldMappingSchema = z.object({
+  source: z.string().min(1),
+  target: z.string().min(1),
+  transform: z.string().min(1).optional()
+});
+var ResolvedFilterSchema = z.object({
+  field: z.string().min(1),
+  op: z.enum(["eq", "neq", "in", "nin", "gt", "gte", "lt", "lte"]),
+  value: z.unknown()
+});
+var SystemModstampCursorSchema = z.object({
+  kind: z.literal("systemModstamp"),
+  field: z.string().min(1)
+});
+var ReplayIdCursorSchema = z.object({
+  kind: z.literal("replayId"),
+  field: z.string().min(1)
+});
+var TimestampCursorSchema = z.object({
+  kind: z.literal("timestamp"),
+  field: z.string().min(1)
+});
+var EventIdCursorSchema = z.object({
+  kind: z.literal("eventId"),
+  field: z.string().min(1)
+});
+var HistoryIdCursorSchema = z.object({
+  kind: z.literal("historyId"),
+  field: z.string().min(1)
+});
+var SyncTokenCursorSchema = z.object({
+  kind: z.literal("syncToken"),
+  field: z.string().min(1)
+});
+var CursorStrategySchema = z.discriminatedUnion("kind", [
+  SystemModstampCursorSchema,
+  ReplayIdCursorSchema,
+  TimestampCursorSchema,
+  EventIdCursorSchema,
+  HistoryIdCursorSchema,
+  SyncTokenCursorSchema
+]);
+var CURSOR_DIVISIBILITY = {
+  systemModstamp: true,
+  timestamp: true,
+  replayId: true,
+  eventId: false,
+  historyId: false,
+  syncToken: false
+};
+function isDivisibleCursor(kind) {
+  return CURSOR_DIVISIBILITY[kind];
+}
+var PollDetectionSchema = z.object({
+  cursor: CursorStrategySchema,
+  provenance: z.enum(["poll", "cdc"]).optional()
+});
+var WebhookDetectionSchema = z.object({
+  eventIdField: z.string().min(1)
+});
+var PollModeSchema = z.object({
+  mode: z.literal("poll"),
+  poll: PollDetectionSchema,
+  mapping: z.array(FieldMappingSchema).min(1),
+  filters: z.array(ResolvedFilterSchema).default([])
+});
+var WebhookModeSchema = z.object({
+  mode: z.literal("webhook"),
+  webhook: WebhookDetectionSchema,
+  mapping: z.array(FieldMappingSchema).min(1),
+  filters: z.array(ResolvedFilterSchema).default([])
+});
+var DetectionConfigSchema = z.discriminatedUnion("mode", [
+  PollModeSchema,
+  WebhookModeSchema
+]);
+
+export {
+  FieldMappingSchema,
+  ResolvedFilterSchema,
+  CursorStrategySchema,
+  CURSOR_DIVISIBILITY,
+  isDivisibleCursor,
+  PollDetectionSchema,
+  WebhookDetectionSchema,
+  DetectionConfigSchema
+};
+//# sourceMappingURL=chunk-3NMCDN7L.js.map

package/dist/chunk-3NMCDN7L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/integration/detection-config.schema.ts"],"sourcesContent":["/**\n * Integration subsystem — DetectionConfig schema (#226-1)\n *\n * Canonical Zod schema for per-entity integration detection config. The schema is\n * the single source of truth for filter/mapping shape and is consumed by:\n *\n *   1. Runtime primitives — `PollChangeSource<T>`, `WebhookChangeSource<T>`\n *      (#226-3, #226-4) accept a parsed `DetectionConfig` at construction.\n *   2. Codegen — `src/schema/entity-definition.schema.ts` (#226-6) imports\n *      this schema so per-entity YAML `detection:` blocks validate against\n *      the same shape the runtime enforces.\n *\n * Locked decisions (see ADR-033 + decision memo Q1–Q6):\n *   - Filter vocabulary is flat AND of `{ field, op, value }` triples; richer\n *     boolean expressions (OR / NOT / nested) are deferred per epic open Q3.\n *   - Cursor strategy is a tagged union over the four shapes the three modes\n *     need (`systemModstamp`, `replayId`, `timestamp`, `eventId`). Each\n *     strategy types its cursor internally; the orchestrator persists what\n *     the iterator last yielded (integration skill rule 2).\n *   - `mode: 'poll'` may opt into `provenance: 'cdc'` so Stripe-style event\n *     endpoints (mechanically a poll, semantically CDC) reuse the poll\n *     primitive while emitting `Change<T>.source = 'cdc'`. Long-lived\n *     streaming CDC (SFDC Pub-Sub, Debezium) is a separate primitive\n *     deferred to #226-8.\n *   - `webhook` mode requires `eventIdField` so `WebhookChangeSource<T>`\n *     can populate `Change<T>.dedupKey` from the inbound staging row.\n */\nimport { z } from 'zod';\n\n// ============================================================================\n// Field mapping — provider field → canonical target\n// ============================================================================\n\n/**\n * Maps a single provider field onto the canonical record. `transform` is an\n * opt-in tag the adapter callback may inspect (`date-iso`, `decimal-string`,\n * etc.); the schema does not enumerate transforms — adapters interpret them.\n */\nexport const FieldMappingSchema = z.object({\n  source: z.string().min(1),\n  target: z.string().min(1),\n  transform: z.string().min(1).optional(),\n});\n\nexport type FieldMapping = z.infer<typeof FieldMappingSchema>;\n\n// ============================================================================\n// Resolved filter — flat-AND triple\n// ============================================================================\n\n/**\n * A single resolved filter clause applied at fetch time. `value` is `unknown`\n * to admit primitives, arrays (for `in` / `nin`), and dates as ISO strings —\n * adapters interpret per provider.\n */\nexport const ResolvedFilterSchema = z.object({\n  field: z.string().min(1),\n  op: z.enum(['eq', 'neq', 'in', 'nin', 'gt', 'gte', 'lt', 'lte']),\n  value: z.unknown(),\n});\n\nexport type ResolvedFilter = z.infer<typeof ResolvedFilterSchema>;\n\n// ============================================================================\n// Cursor strategy — tagged union over the four shapes the modes need\n// ============================================================================\n\nconst SystemModstampCursorSchema = z.object({\n  kind: z.literal('systemModstamp'),\n  field: z.string().min(1),\n});\n\nconst ReplayIdCursorSchema = z.object({\n  kind: z.literal('replayId'),\n  field: z.string().min(1),\n});\n\nconst TimestampCursorSchema = z.object({\n  kind: z.literal('timestamp'),\n  field: z.string().min(1),\n});\n\nconst EventIdCursorSchema = z.object({\n  kind: z.literal('eventId'),\n  field: z.string().min(1),\n});\n\n/**\n * Gmail `historyId` (RFC-0003 §3) — an opaque, atomic vendor token. The next\n * watermark only exists at end-of-walk; there is no resumable mid-walk value.\n * `field` is metadata for codegen/adapters (the response key the token lives on).\n */\nconst HistoryIdCursorSchema = z.object({\n  kind: z.literal('historyId'),\n  field: z.string().min(1),\n});\n\n/**\n * Google Calendar `syncToken` (RFC-0003 §3) — an opaque, atomic sync token,\n * same divisibility profile as `historyId`.\n */\nconst SyncTokenCursorSchema = z.object({\n  kind: z.literal('syncToken'),\n  field: z.string().min(1),\n});\n\nexport const CursorStrategySchema = z.discriminatedUnion('kind', [\n  SystemModstampCursorSchema,\n  ReplayIdCursorSchema,\n  TimestampCursorSchema,\n  EventIdCursorSchema,\n  HistoryIdCursorSchema,\n  SyncTokenCursorSchema,\n]);\n\nexport type CursorStrategy = z.infer<typeof CursorStrategySchema>;\n\n// ============================================================================\n// Cursor divisibility (RFC-0003 §3)\n// ============================================================================\n\n/**\n * Whether a cursor strategy is *divisible* — a property of the strategy, not\n * the read primitive. Divisible cursors are sortable/monotonic watermarks whose\n * value is meaningful AS OF any single record (HubSpot `systemModstamp`, a\n * `timestamp` field, a Salesforce CDC `replayId`); the read primitive may\n * checkpoint per-ref mid-walk, so a crash resumes from the last delivered ref.\n *\n * Atomic cursors are opaque vendor tokens (Gmail `historyId`, Calendar\n * `syncToken`, a generic `eventId`) whose next value only exists at end-of-walk.\n * The primitive must withhold per-ref cursors and emit the token only at a safe\n * boundary, so an interrupted run never persists an unresumable mid-walk token\n * (it resumes all-or-nothing from the prior token — see `IncrementalReadBase`).\n *\n * `eventId` is classified atomic conservatively: a generic opaque id is treated\n * all-or-nothing unless a concrete strategy proves it monotonically resumable.\n */\nexport const CURSOR_DIVISIBILITY: Readonly<Record<CursorStrategy['kind'], boolean>> = {\n  systemModstamp: true,\n  timestamp: true,\n  replayId: true,\n  eventId: false,\n  historyId: false,\n  syncToken: false,\n};\n\n/** Predicate form of {@link CURSOR_DIVISIBILITY}. */\nexport function isDivisibleCursor(kind: CursorStrategy['kind']): boolean {\n  return CURSOR_DIVISIBILITY[kind];\n}\n\n// ============================================================================\n// Mode-specific blocks\n// ============================================================================\n\n/**\n * Poll-mode block. `provenance: 'cdc'` opts the poll primitive into stamping\n * `Change<T>.source = 'cdc'` and populating `dedupKey` from the cursor's\n * `field` — used for Stripe-style event endpoints. Defaults to `'poll'`.\n */\nexport const PollDetectionSchema = z.object({\n  cursor: CursorStrategySchema,\n  provenance: z.enum(['poll', 'cdc']).optional(),\n});\n\nexport type PollDetection = z.infer<typeof PollDetectionSchema>;\n\n/**\n * Webhook-mode block. `eventIdField` names the column in the consumer-owned\n * inbound staging row that `WebhookChangeSource<T>` reads to set\n * `Change<T>.dedupKey`.\n */\nexport const WebhookDetectionSchema = z.object({\n  eventIdField: z.string().min(1),\n});\n\nexport type WebhookDetection = z.infer<typeof WebhookDetectionSchema>;\n\n// ============================================================================\n// DetectionConfig — top-level discriminated union over `mode`\n// ============================================================================\n\nconst PollModeSchema = z.object({\n  mode: z.literal('poll'),\n  poll: PollDetectionSchema,\n  mapping: z.array(FieldMappingSchema).min(1),\n  filters: z.array(ResolvedFilterSchema).default([]),\n});\n\nconst WebhookModeSchema = z.object({\n  mode: z.literal('webhook'),\n  webhook: WebhookDetectionSchema,\n  mapping: z.array(FieldMappingSchema).min(1),\n  filters: z.array(ResolvedFilterSchema).default([]),\n});\n\n/**\n * Top-level detection config. Discriminated on `mode` so the relevant\n * mode-block (poll/webhook) is structurally required for that mode. CDC as a\n * long-lived streaming primitive is deferred (#226-8); CDC-as-provenance\n * (Stripe-style event endpoints) is expressed via `mode: 'poll'` with\n * `poll.provenance: 'cdc'`.\n */\nexport const DetectionConfigSchema = z.discriminatedUnion('mode', [\n  PollModeSchema,\n  WebhookModeSchema,\n]);\n\nexport type DetectionConfig = z.infer<typeof DetectionConfigSchema>;\n"],"mappings":";AA2BA,SAAS,SAAS;AAWX,IAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACxB,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACxB,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS;AACxC,CAAC;AAaM,IAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACvB,IAAI,EAAE,KAAK,CAAC,MAAM,OAAO,MAAM,OAAO,MAAM,OAAO,MAAM,KAAK,CAAC;AAAA,EAC/D,OAAO,EAAE,QAAQ;AACnB,CAAC;AAQD,IAAM,6BAA6B,EAAE,OAAO;AAAA,EAC1C,MAAM,EAAE,QAAQ,gBAAgB;AAAA,EAChC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACzB,CAAC;AAED,IAAM,uBAAuB,EAAE,OAAO;AAAA,EACpC,MAAM,EAAE,QAAQ,UAAU;AAAA,EAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACzB,CAAC;AAED,IAAM,wBAAwB,EAAE,OAAO;AAAA,EACrC,MAAM,EAAE,QAAQ,WAAW;AAAA,EAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACzB,CAAC;AAED,IAAM,sBAAsB,EAAE,OAAO;AAAA,EACnC,MAAM,EAAE,QAAQ,SAAS;AAAA,EACzB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACzB,CAAC;AAOD,IAAM,wBAAwB,EAAE,OAAO;AAAA,EACrC,MAAM,EAAE,QAAQ,WAAW;AAAA,EAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACzB,CAAC;AAMD,IAAM,wBAAwB,EAAE,OAAO;AAAA,EACrC,MAAM,EAAE,QAAQ,WAAW;AAAA,EAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;AACzB,CAAC;AAEM,IAAM,uBAAuB,EAAE,mBAAmB,QAAQ;AAAA,EAC/D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAwBM,IAAM,sBAAyE;AAAA,EACpF,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,UAAU;AAAA,EACV,SAAS;AAAA,EACT,WAAW;AAAA,EACX,WAAW;AACb;AAGO,SAAS,kBAAkB,MAAuC;AACvE,SAAO,oBAAoB,IAAI;AACjC;AAWO,IAAM,sBAAsB,EAAE,OAAO;AAAA,EAC1C,QAAQ;AAAA,EACR,YAAY,EAAE,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,SAAS;AAC/C,CAAC;AASM,IAAM,yBAAyB,EAAE,OAAO;AAAA,EAC7C,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC;AAChC,CAAC;AAQD,IAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,MAAM,EAAE,QAAQ,MAAM;AAAA,EACtB,MAAM;AAAA,EACN,SAAS,EAAE,MAAM,kBAAkB,EAAE,IAAI,CAAC;AAAA,EAC1C,SAAS,EAAE,MAAM,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACjC,MAAM,EAAE,QAAQ,SAAS;AAAA,EACzB,SAAS;AAAA,EACT,SAAS,EAAE,MAAM,kBAAkB,EAAE,IAAI,CAAC;AAAA,EAC1C,SAAS,EAAE,MAAM,oBAAoB,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AASM,IAAM,wBAAwB,EAAE,mBAAmB,QAAQ;AAAA,EAChE;AAAA,EACA;AACF,CAAC;","names":[]}

package/dist/chunk-3SZFUTXE.js

@@ -0,0 +1,62 @@
+import {
+  toBuffer
+} from "./chunk-J6MN42LG.js";
+
+// runtime/subsystems/storage/storage.memory-backend.ts
+var MemoryStorageBackend = class {
+  store = /* @__PURE__ */ new Map();
+  async upload(key, data, contentType) {
+    const buffer = await toBuffer(data);
+    this.store.set(key, { data: buffer, contentType });
+    return key;
+  }
+  async download(key) {
+    const entry = this.store.get(key);
+    if (!entry) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    return entry.data;
+  }
+  async delete(key) {
+    if (!this.store.has(key)) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    this.store.delete(key);
+  }
+  async getUrl(key, _expiresInSeconds) {
+    if (!this.store.has(key)) {
+      throw new Error(`Storage: file not found: ${key}`);
+    }
+    return `memory://${key}`;
+  }
+  async exists(key) {
+    return this.store.has(key);
+  }
+  async list(prefix) {
+    const keys = Array.from(this.store.keys());
+    if (prefix === void 0) return keys;
+    return keys.filter((k) => k.startsWith(prefix));
+  }
+  async downloadStream(key) {
+    const buffer = await this.download(key);
+    return new ReadableStream({
+      start(controller) {
+        controller.enqueue(new Uint8Array(buffer));
+        controller.close();
+      }
+    });
+  }
+  /** Clear all stored files. Useful for test teardown. */
+  clear() {
+    this.store.clear();
+  }
+  /** Return number of stored files. Useful for test assertions. */
+  size() {
+    return this.store.size;
+  }
+};
+
+export {
+  MemoryStorageBackend
+};
+//# sourceMappingURL=chunk-3SZFUTXE.js.map

package/dist/chunk-3SZFUTXE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/storage/storage.memory-backend.ts"],"sourcesContent":["/**\n * Storage subsystem — in-memory backend\n *\n * Stores files as Buffers in a Map. Intended for unit tests only.\n * All state is lost when the process exits.\n *\n * - getUrl returns `memory://{key}` (not a real URL, useful for assertions)\n * - All methods throw on failure (missing keys, etc.)\n */\nimport type { IStorageService } from './storage.protocol';\nimport { toBuffer } from './storage.utils';\n\ninterface MemoryEntry {\n  data: Buffer;\n  contentType?: string;\n}\n\nexport class MemoryStorageBackend implements IStorageService {\n  private readonly store = new Map<string, MemoryEntry>();\n\n  async upload(key: string, data: Buffer | ReadableStream, contentType?: string): Promise<string> {\n    const buffer = await toBuffer(data);\n    this.store.set(key, { data: buffer, contentType });\n    return key;\n  }\n\n  async download(key: string): Promise<Buffer> {\n    const entry = this.store.get(key);\n    if (!entry) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    return entry.data;\n  }\n\n  async delete(key: string): Promise<void> {\n    if (!this.store.has(key)) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    this.store.delete(key);\n  }\n\n  async getUrl(key: string, _expiresInSeconds?: number): Promise<string> {\n    if (!this.store.has(key)) {\n      throw new Error(`Storage: file not found: ${key}`);\n    }\n    return `memory://${key}`;\n  }\n\n  async exists(key: string): Promise<boolean> {\n    return this.store.has(key);\n  }\n\n  async list(prefix?: string): Promise<string[]> {\n    const keys = Array.from(this.store.keys());\n    if (prefix === undefined) return keys;\n    return keys.filter((k) => k.startsWith(prefix));\n  }\n\n  async downloadStream(key: string): Promise<ReadableStream> {\n    const buffer = await this.download(key);\n    return new ReadableStream<Uint8Array>({\n      start(controller) {\n        controller.enqueue(new Uint8Array(buffer));\n        controller.close();\n      },\n    });\n  }\n\n  /** Clear all stored files. Useful for test teardown. */\n  clear(): void {\n    this.store.clear();\n  }\n\n  /** Return number of stored files. Useful for test assertions. */\n  size(): number {\n    return this.store.size;\n  }\n}\n"],"mappings":";;;;;AAiBO,IAAM,uBAAN,MAAsD;AAAA,EAC1C,QAAQ,oBAAI,IAAyB;AAAA,EAEtD,MAAM,OAAO,KAAa,MAA+B,aAAuC;AAC9F,UAAM,SAAS,MAAM,SAAS,IAAI;AAClC,SAAK,MAAM,IAAI,KAAK,EAAE,MAAM,QAAQ,YAAY,CAAC;AACjD,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,SAAS,KAA8B;AAC3C,UAAM,QAAQ,KAAK,MAAM,IAAI,GAAG;AAChC,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,MAAM,4BAA4B,GAAG,EAAE;AAAA,IACnD;AACA,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,MAAM,OAAO,KAA4B;AACvC,QAAI,CAAC,KAAK,MAAM,IAAI,GAAG,GAAG;AACxB,YAAM,IAAI,MAAM,4BAA4B,GAAG,EAAE;AAAA,IACnD;AACA,SAAK,MAAM,OAAO,GAAG;AAAA,EACvB;AAAA,EAEA,MAAM,OAAO,KAAa,mBAA6C;AACrE,QAAI,CAAC,KAAK,MAAM,IAAI,GAAG,GAAG;AACxB,YAAM,IAAI,MAAM,4BAA4B,GAAG,EAAE;AAAA,IACnD;AACA,WAAO,YAAY,GAAG;AAAA,EACxB;AAAA,EAEA,MAAM,OAAO,KAA+B;AAC1C,WAAO,KAAK,MAAM,IAAI,GAAG;AAAA,EAC3B;AAAA,EAEA,MAAM,KAAK,QAAoC;AAC7C,UAAM,OAAO,MAAM,KAAK,KAAK,MAAM,KAAK,CAAC;AACzC,QAAI,WAAW,OAAW,QAAO;AACjC,WAAO,KAAK,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,CAAC;AAAA,EAChD;AAAA,EAEA,MAAM,eAAe,KAAsC;AACzD,UAAM,SAAS,MAAM,KAAK,SAAS,GAAG;AACtC,WAAO,IAAI,eAA2B;AAAA,MACpC,MAAM,YAAY;AAChB,mBAAW,QAAQ,IAAI,WAAW,MAAM,CAAC;AACzC,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,MAAM,MAAM;AAAA,EACnB;AAAA;AAAA,EAGA,OAAe;AACb,WAAO,KAAK,MAAM;AAAA,EACpB;AACF;","names":[]}

package/dist/chunk-4DOJBQTP.js

@@ -0,0 +1,117 @@
+import {
+  UniqueConstraintError
+} from "./chunk-NXXDZ6ZF.js";
+
+// runtime/subsystems/bridge/bridge-delivery.memory-backend.ts
+import { randomUUID } from "crypto";
+var BRIDGE_DELIVERY_UNIQUE_CONSTRAINT = "uq_bridge_delivery_event_trigger";
+function key(eventId, triggerId) {
+  return `${eventId}::${triggerId}`;
+}
+var MemoryBridgeDeliveryRepo = class {
+  deliveries = /* @__PURE__ */ new Map();
+  async insertDelivery(row) {
+    const k = key(row.eventId, row.triggerId);
+    if (this.deliveries.has(k)) {
+      throw new UniqueConstraintError(
+        BRIDGE_DELIVERY_UNIQUE_CONSTRAINT,
+        row.eventId,
+        row.triggerId
+      );
+    }
+    const record = {
+      id: row.id ?? randomUUID(),
+      eventId: row.eventId,
+      triggerId: row.triggerId,
+      wrapperRunId: row.wrapperRunId ?? null,
+      userRunId: row.userRunId ?? null,
+      status: row.status ?? "pending",
+      skipReason: row.skipReason ?? null,
+      error: row.error ?? null,
+      tenantId: row.tenantId ?? null,
+      attemptedAt: row.attemptedAt instanceof Date ? row.attemptedAt : /* @__PURE__ */ new Date(),
+      deliveredAt: row.deliveredAt instanceof Date ? row.deliveredAt : null
+    };
+    this.deliveries.set(k, record);
+  }
+  async findDelivery(eventId, triggerId) {
+    return this.deliveries.get(key(eventId, triggerId)) ?? null;
+  }
+  async findDeliveryById(id) {
+    for (const record of this.deliveries.values()) {
+      if (record.id === id) return record;
+    }
+    return null;
+  }
+  async markDelivered(id, userRunId) {
+    const record = this.findById(id);
+    record.status = "delivered";
+    record.userRunId = userRunId;
+    record.deliveredAt = /* @__PURE__ */ new Date();
+  }
+  async markSkipped(id, reason) {
+    const record = this.findById(id);
+    record.status = "skipped";
+    record.skipReason = reason;
+  }
+  async markFailed(id, error) {
+    const record = this.findById(id);
+    record.status = "failed";
+    record.error = error;
+  }
+  /**
+   * Observability read — see `IJobBridge.getStatusHistogram` JSDoc for the
+   * tenant-filter and windowHours contract.
+   *
+   * Unlike `insertDelivery`, this read does NOT call `assertTenantId`:
+   * `tenantId === undefined` is the supported cross-tenant admin view.
+   */
+  async getStatusHistogram(windowHours, tenantId, nowMs = Date.now()) {
+    if (!Number.isFinite(windowHours) || windowHours <= 0) {
+      throw new RangeError("windowHours must be positive");
+    }
+    const cutoffMs = nowMs - windowHours * 36e5;
+    const histogram = {
+      pending: 0,
+      delivered: 0,
+      skipped: 0,
+      failed: 0
+    };
+    for (const record of this.deliveries.values()) {
+      if (record.attemptedAt.getTime() < cutoffMs) continue;
+      if (tenantId === null && record.tenantId !== null) continue;
+      if (typeof tenantId === "string" && record.tenantId !== tenantId) {
+        continue;
+      }
+      histogram[record.status] += 1;
+    }
+    return histogram;
+  }
+  // ─── Test helpers ────────────────────────────────────────────────────────
+  /** All deliveries for a given event (any status, declaration order). */
+  getDeliveriesForEvent(eventId) {
+    return [...this.deliveries.values()].filter((r) => r.eventId === eventId);
+  }
+  /** All deliveries currently in the given status. */
+  getByStatus(status) {
+    return [...this.deliveries.values()].filter((r) => r.status === status);
+  }
+  /** Reset the store. Tests use this in `beforeEach`. */
+  clear() {
+    this.deliveries.clear();
+  }
+  // ─── Internals ───────────────────────────────────────────────────────────
+  findById(id) {
+    for (const record of this.deliveries.values()) {
+      if (record.id === id) return record;
+    }
+    throw new Error(
+      `MemoryBridgeDeliveryRepo: no delivery with id '${id}' (transition methods may not be called for unknown rows; the framework handler should always findDelivery first or operate on a row it just inserted).`
+    );
+  }
+};
+
+export {
+  MemoryBridgeDeliveryRepo
+};
+//# sourceMappingURL=chunk-4DOJBQTP.js.map

package/dist/chunk-4DOJBQTP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/bridge/bridge-delivery.memory-backend.ts"],"sourcesContent":["/**\n * MemoryBridgeDeliveryRepo — in-memory `IJobBridge` (BRIDGE-3, ADR-023 Phase 2).\n *\n * Behavioral twin of the Drizzle backend (BRIDGE-4) for use in\n * `just test-unit`. No Docker, no Postgres, fully synchronous. Backs a\n * `Map<\"${eventId}::${triggerId}\", BridgeDeliveryRecord>` so the UNIQUE\n * `(event_id, trigger_id)` constraint can be simulated cheaply.\n *\n * Precedent: `MemoryEventBus` (EVT-5), `MemoryJobOrchestrator`\n * (jobs subsystem). Same shape — a class implementing the protocol plus\n * test-only helpers (`getDeliveriesForEvent`, `getByStatus`, `clear`) that\n * BRIDGE-5's framework-handler tests and BRIDGE-7's facade tests will\n * exercise.\n *\n * The synthetic `UniqueConstraintError` carries a `constraint` field equal\n * to the Drizzle constraint name (`uq_bridge_delivery_event_trigger`, set\n * in BRIDGE-1's schema) so consumers — including BRIDGE-4's\n * `INSERT … ON CONFLICT (event_id, trigger_id) DO NOTHING` path and\n * BRIDGE-7's Case B dedup tests — can branch on the same discriminator\n * regardless of which backend is wired up. ADR-023 explicitly relies on\n * this constraint as the dedup mechanism in two places (replay; facade-\n * vs-drain Case B); a typed error makes both call sites checkable.\n */\nimport { randomUUID } from 'node:crypto';\n\nimport type {\n  BridgeDeliveryInsert,\n  IJobBridge,\n  StatusHistogram,\n} from './bridge.protocol';\nimport type { BridgeDeliveryRecord } from './bridge-delivery.schema';\nimport { UniqueConstraintError } from './bridge-errors';\n\nconst BRIDGE_DELIVERY_UNIQUE_CONSTRAINT =\n  'uq_bridge_delivery_event_trigger' as const;\n\nfunction key(eventId: string, triggerId: string): string {\n  return `${eventId}::${triggerId}`;\n}\n\nexport class MemoryBridgeDeliveryRepo implements IJobBridge {\n  private readonly deliveries = new Map<string, BridgeDeliveryRecord>();\n\n  async insertDelivery(row: BridgeDeliveryInsert): Promise<void> {\n    const k = key(row.eventId, row.triggerId);\n    if (this.deliveries.has(k)) {\n      throw new UniqueConstraintError(\n        BRIDGE_DELIVERY_UNIQUE_CONSTRAINT,\n        row.eventId,\n        row.triggerId,\n      );\n    }\n    // Materialize a full BridgeDeliveryRecord — fill in DB defaults that\n    // the insert payload allowed to be omitted.\n    const record: BridgeDeliveryRecord = {\n      id: row.id ?? randomUUID(),\n      eventId: row.eventId,\n      triggerId: row.triggerId,\n      wrapperRunId: row.wrapperRunId ?? null,\n      userRunId: row.userRunId ?? null,\n      status: row.status ?? 'pending',\n      skipReason: row.skipReason ?? null,\n      error: (row.error as Record<string, unknown> | null | undefined) ?? null,\n      tenantId: row.tenantId ?? null,\n      attemptedAt:\n        row.attemptedAt instanceof Date ? row.attemptedAt : new Date(),\n      deliveredAt:\n        row.deliveredAt instanceof Date ? row.deliveredAt : null,\n    };\n    this.deliveries.set(k, record);\n  }\n\n  async findDelivery(\n    eventId: string,\n    triggerId: string,\n  ): Promise<BridgeDeliveryRecord | null> {\n    return this.deliveries.get(key(eventId, triggerId)) ?? null;\n  }\n\n  async findDeliveryById(id: string): Promise<BridgeDeliveryRecord | null> {\n    for (const record of this.deliveries.values()) {\n      if (record.id === id) return record;\n    }\n    return null;\n  }\n\n  async markDelivered(id: string, userRunId: string): Promise<void> {\n    const record = this.findById(id);\n    record.status = 'delivered';\n    record.userRunId = userRunId;\n    record.deliveredAt = new Date();\n  }\n\n  async markSkipped(id: string, reason: string): Promise<void> {\n    const record = this.findById(id);\n    record.status = 'skipped';\n    record.skipReason = reason;\n  }\n\n  async markFailed(\n    id: string,\n    error: Record<string, unknown>,\n  ): Promise<void> {\n    const record = this.findById(id);\n    record.status = 'failed';\n    record.error = error;\n  }\n\n  /**\n   * Observability read — see `IJobBridge.getStatusHistogram` JSDoc for the\n   * tenant-filter and windowHours contract.\n   *\n   * Unlike `insertDelivery`, this read does NOT call `assertTenantId`:\n   * `tenantId === undefined` is the supported cross-tenant admin view.\n   */\n  async getStatusHistogram(\n    windowHours: number,\n    tenantId?: string | null,\n    // Reference instant for the window cutoff. Defaults to the wall clock; exposed\n    // as a test-injection seam so a caller can pin the cutoff to the same `now` it\n    // positioned a boundary row from. Without it the cutoff is re-sampled here a few\n    // ms later, pushing an \"exactly at the boundary\" row just below the window\n    // (the OBS-3 boundary test flake). The drizzle backend has no analogue — it\n    // evaluates the cutoff once in SQL via `now()`.\n    nowMs: number = Date.now(),\n  ): Promise<StatusHistogram> {\n    if (!Number.isFinite(windowHours) || windowHours <= 0) {\n      throw new RangeError('windowHours must be positive');\n    }\n\n    const cutoffMs = nowMs - windowHours * 3_600_000;\n    const histogram: StatusHistogram = {\n      pending: 0,\n      delivered: 0,\n      skipped: 0,\n      failed: 0,\n    };\n\n    for (const record of this.deliveries.values()) {\n      if (record.attemptedAt.getTime() < cutoffMs) continue;\n      if (tenantId === null && record.tenantId !== null) continue;\n      if (typeof tenantId === 'string' && record.tenantId !== tenantId) {\n        continue;\n      }\n      // tenantId === undefined → no tenant filter.\n      histogram[record.status] += 1;\n    }\n\n    return histogram;\n  }\n\n  // ─── Test helpers ────────────────────────────────────────────────────────\n\n  /** All deliveries for a given event (any status, declaration order). */\n  getDeliveriesForEvent(eventId: string): BridgeDeliveryRecord[] {\n    return [...this.deliveries.values()].filter((r) => r.eventId === eventId);\n  }\n\n  /** All deliveries currently in the given status. */\n  getByStatus(\n    status: BridgeDeliveryRecord['status'],\n  ): BridgeDeliveryRecord[] {\n    return [...this.deliveries.values()].filter((r) => r.status === status);\n  }\n\n  /** Reset the store. Tests use this in `beforeEach`. */\n  clear(): void {\n    this.deliveries.clear();\n  }\n\n  // ─── Internals ───────────────────────────────────────────────────────────\n\n  private findById(id: string): BridgeDeliveryRecord {\n    for (const record of this.deliveries.values()) {\n      if (record.id === id) return record;\n    }\n    throw new Error(\n      `MemoryBridgeDeliveryRepo: no delivery with id '${id}' (transition ` +\n        `methods may not be called for unknown rows; the framework handler ` +\n        `should always findDelivery first or operate on a row it just ` +\n        `inserted).`,\n    );\n  }\n}\n"],"mappings":"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","names":[]}