@pattern-stack/codegen 0.15.3 → 0.16.1

package/dist/runtime/subsystems/index.js

@@ -1,19 +1,17 @@
-import "../../chunk-ZUMULSEQ.js";
+import "../../chunk-IWAOY6KC.js";
 import {
-  StorageModule
-} from "../../chunk-4MVGAMUA.js";
+  CacheModule
+} from "../../chunk-COGHTKXY.js";
 import {
-  LocalStorageBackend
-} from "../../chunk-JWNHNUYL.js";
+  DrizzleCacheService
+} from "../../chunk-T6C4LFLC.js";
 import {
-  MemoryStorageBackend
-} from "../../chunk-3SZFUTXE.js";
+  MemoryCacheService
+} from "../../chunk-IF5I3DAA.js";
+import "../../chunk-FASRXRX5.js";
 import {
-  STORAGE
-} from "../../chunk-NYBCQZC7.js";
-import "../../chunk-J6MN42LG.js";
-import "../../chunk-UTN4GBPQ.js";
-import "../../chunk-IWAOY6KC.js";
+  CACHE
+} from "../../chunk-L6FTY45T.js";
 import "../../chunk-FI34KYZ5.js";
 import "../../chunk-L4SDDEEU.js";
 import {
@@ -21,48 +19,69 @@ import {
 } from "../../chunk-EWYCWP4H.js";
 import {
   ObservabilityModule
-} from "../../chunk-TNXH7BJS.js";
+} from "../../chunk-E45CSC33.js";
 import "../../chunk-AQFQ4BYM.js";
-import "../../chunk-YPWODKD5.js";
+import "../../chunk-W2UIDI3R.js";
 import {
   OBSERVABILITY,
   OBSERVABILITY_MODULE_OPTIONS
 } from "../../chunk-Y7RRSEOC.js";
-import "../../chunk-FN2PYDPP.js";
-import {
-  EventsModule
-} from "../../chunk-EOLLMEAH.js";
-import "../../chunk-GM3RMJIJ.js";
-import "../../chunk-BGULBWKJ.js";
-import "../../chunk-JRQO2IOF.js";
+import "../../chunk-ZUMULSEQ.js";
 import {
-  CacheModule
-} from "../../chunk-27ETSJ2X.js";
+  StorageModule
+} from "../../chunk-RUSUZZAF.js";
 import {
-  DrizzleCacheService
-} from "../../chunk-7YGORYZD.js";
+  MemoryStorageBackend
+} from "../../chunk-3SZFUTXE.js";
 import {
-  MemoryCacheService
-} from "../../chunk-IF5I3DAA.js";
+  STORAGE
+} from "../../chunk-NYBCQZC7.js";
 import {
-  CACHE
-} from "../../chunk-L6FTY45T.js";
-import "../../chunk-FASRXRX5.js";
+  LocalStorageBackend
+} from "../../chunk-JWNHNUYL.js";
+import "../../chunk-J6MN42LG.js";
+import "../../chunk-W4HOHZVF.js";
+import "../../chunk-AYC2HEAL.js";
+import "../../chunk-JM3T27ZW.js";
+import "../../chunk-DGYTSCKN.js";
+import "../../chunk-5LXOJGO2.js";
+import "../../chunk-QSJ3J4HE.js";
+import "../../chunk-L3LZWWSX.js";
+import "../../chunk-DV4RV2DC.js";
+import "../../chunk-I6MVCB5A.js";
+import "../../chunk-RHVN6NA7.js";
+import "../../chunk-IT6FRTEW.js";
 import {
-  DrizzleEventBus
-} from "../../chunk-4JLJYWJC.js";
+  collisionModeEnum,
+  jobRunStatusEnum,
+  jobRuns,
+  jobStepKindEnum,
+  jobStepStatusEnum,
+  jobSteps,
+  jobs,
+  parentClosePolicyEnum,
+  replayFromEnum,
+  triggerSourceEnum,
+  waitKindEnum
+} from "../../chunk-OKXZ63IA.js";
+import "../../chunk-T4YJRD22.js";
+import "../../chunk-PNZSGAB2.js";
+import "../../chunk-SNQ3TOWP.js";
+import "../../chunk-CO6LUM72.js";
+import "../../chunk-ZPL74UQN.js";
+import "../../chunk-T4BIIU5E.js";
+import "../../chunk-FN2PYDPP.js";
 import {
-  MemoryEventBus
-} from "../../chunk-Z7PQCAVK.js";
-import "../../chunk-UQ5EHOH2.js";
+  EventsModule
+} from "../../chunk-TKVTEUBD.js";
+import "../../chunk-GM3RMJIJ.js";
+import "../../chunk-BGULBWKJ.js";
+import "../../chunk-JRQO2IOF.js";
 import "../../chunk-V4AF6DI4.js";
 import "../../chunk-7C3FOSDI.js";
 import {
   OAuth2RefreshStrategy
 } from "../../chunk-M6QLSLPO.js";
-import {
-  ConnectionBrokenError
-} from "../../chunk-2N4UG4VD.js";
 import {
   withAuthRetry
 } from "../../chunk-WL67FZGF.js";
@@ -71,6 +90,22 @@ import {
   isSessionExpiredError
 } from "../../chunk-7RELQJIN.js";
 import "../../chunk-OSQRXVG2.js";
+import {
+  ConnectionBrokenError
+} from "../../chunk-2N4UG4VD.js";
+import {
+  DrizzleEventBus
+} from "../../chunk-H6FO2ZDJ.js";
+import "../../chunk-4LH67P4U.js";
+import "../../chunk-MYQIQ27N.js";
+import "../../chunk-OFRRBC7M.js";
+import {
+  MemoryEventBus
+} from "../../chunk-LQ6PYFU6.js";
+import {
+  EVENT_BUS
+} from "../../chunk-H5NH7KPE.js";
+import "../../chunk-UQ5EHOH2.js";
 import {
   AuthModule
 } from "../../chunk-T6SCOJF4.js";
@@ -89,9 +124,6 @@ import {
 import {
   OAuthStateError
 } from "../../chunk-BPARRK6F.js";
-import {
-  authOAuthState
-} from "../../chunk-NPFPZ2HO.js";
 import {
   AUTH_CONNECTION_GRANT_SINK,
   AUTH_CONNECTION_READER,
@@ -102,55 +134,23 @@ import {
   OAUTH_STATE_STORE,
   STRATEGY_REGISTRY
 } from "../../chunk-6XY6ZMMD.js";
-import "../../chunk-4H3PETLM.js";
-import "../../chunk-RC23QROE.js";
-import "../../chunk-O37C3YE6.js";
-import "../../chunk-FBGHYQIZ.js";
-import "../../chunk-RDVTWIYY.js";
-import "../../chunk-L3LZWWSX.js";
-import "../../chunk-DV4RV2DC.js";
-import "../../chunk-I6MVCB5A.js";
-import "../../chunk-RHVN6NA7.js";
-import "../../chunk-5Y7W3XR6.js";
-import "../../chunk-4RFHUZXU.js";
-import "../../chunk-PNZSGAB2.js";
-import "../../chunk-SNQ3TOWP.js";
-import "../../chunk-T4BIIU5E.js";
-import "../../chunk-CO6LUM72.js";
-import "../../chunk-BIO6F7YI.js";
 import {
-  EVENT_BUS
-} from "../../chunk-H5NH7KPE.js";
-import "../../chunk-4LH67P4U.js";
-import {
-  collisionModeEnum,
-  jobRunStatusEnum,
-  jobRuns,
-  jobStepKindEnum,
-  jobStepStatusEnum,
-  jobSteps,
-  jobs,
-  parentClosePolicyEnum,
-  replayFromEnum,
-  triggerSourceEnum,
-  waitKindEnum
-} from "../../chunk-OKXZ63IA.js";
-import "../../chunk-OFRRBC7M.js";
+  authOAuthState
+} from "../../chunk-NPFPZ2HO.js";
 import "../../chunk-GYGNEQSC.js";
-import "../../chunk-ZUKFQL6E.js";
 import "../../chunk-KVOWSC5S.js";
-import "../../chunk-GCYKMF22.js";
+import "../../chunk-24WXSC3C.js";
 import "../../chunk-EO2QPOKH.js";
 import "../../chunk-PRWIX6UW.js";
-import "../../chunk-DCCZB4UC.js";
+import "../../chunk-XWBK3XJK.js";
 import "../../chunk-AHV4GDYM.js";
-import "../../chunk-SR7F3TJY.js";
+import "../../chunk-YK5JEVLX.js";
 import "../../chunk-SQDOBLBP.js";
 import {
   CURSOR_DIVISIBILITY,
   DetectionConfigSchema,
   isDivisibleCursor
-} from "../../chunk-3NMCDN7L.js";
+} from "../../chunk-5TK7MEN4.js";
 import {
   MemoryEntityChangeSourceRegistry
 } from "../../chunk-4KNXX6TI.js";
@@ -159,7 +159,12 @@ import {
 } from "../../chunk-3CJFPU6Q.js";
 import {
   ExecuteIntegrationUseCase
-} from "../../chunk-OGIZXGPY.js";
+} from "../../chunk-TDEHU73T.js";
+import {
+  ENTITY_CHANGE_SOURCE_REGISTRY,
+  INTEGRATION_CHANGE_SOURCE,
+  INTEGRATION_SINK
+} from "../../chunk-S7C6TIIF.js";
 import "../../chunk-MZ6GV4YF.js";
 import {
   IncrementalReadBase,
@@ -168,20 +173,16 @@ import {
 import "../../chunk-HNWZFNKP.js";
 import {
   buildChangeSource
-} from "../../chunk-WWGYCIJX.js";
+} from "../../chunk-43SBT72G.js";
 import {
   PollChangeSource
 } from "../../chunk-4MF3HKJA.js";
 import {
   WebhookChangeSource
-} from "../../chunk-YLPAPPLW.js";
+} from "../../chunk-TIZXQU26.js";
 import "../../chunk-36U5UGIO.js";
-import {
-  ENTITY_CHANGE_SOURCE_REGISTRY,
-  INTEGRATION_CHANGE_SOURCE,
-  INTEGRATION_SINK
-} from "../../chunk-S7C6TIIF.js";
 import "../../chunk-U64T4YZE.js";
+import "../../chunk-ZUKFQL6E.js";
 import "../../chunk-2E224ZSN.js";
 export {
   AUTH_CONNECTION_GRANT_SINK,

package/dist/runtime/subsystems/integration/build-change-source.js

@@ -1,8 +1,8 @@
 import {
   buildChangeSource
-} from "../../../chunk-WWGYCIJX.js";
+} from "../../../chunk-43SBT72G.js";
 import "../../../chunk-4MF3HKJA.js";
-import "../../../chunk-YLPAPPLW.js";
+import "../../../chunk-TIZXQU26.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   buildChangeSource

package/dist/runtime/subsystems/integration/detection-config.schema.d.ts

@@ -24,8 +24,10 @@ import { z } from 'zod';
  *     primitive while emitting `Change<T>.source = 'cdc'`. Long-lived
  *     streaming CDC (SFDC Pub-Sub, Debezium) is a separate primitive
  *     deferred to #226-8.
- *   - `webhook` mode requires `eventIdField` so `WebhookChangeSource<T>`
- *     can populate `Change<T>.dedupKey` from the inbound staging row.
+ *   - `webhook` mode's `eventIdField` is optional: `WebhookChangeSource<T>`
+ *     prefers an `eventId` yielded by the queue iterator and falls back to the
+ *     `eventIdField` record extraction (precedence: yielded eventId >
+ *     eventIdField extraction > undefined dedupKey).
  */
 
 /**
@@ -138,9 +140,9 @@ type CursorStrategy = z.infer<typeof CursorStrategySchema>;
  * `eventId` is classified atomic conservatively: a generic opaque id is treated
  * all-or-nothing unless a concrete strategy proves it monotonically resumable.
  */
-declare const CURSOR_DIVISIBILITY: Readonly<Record<CursorStrategy['kind'], boolean>>;
+declare const CURSOR_DIVISIBILITY: Readonly<Record<CursorStrategy["kind"], boolean>>;
 /** Predicate form of {@link CURSOR_DIVISIBILITY}. */
-declare function isDivisibleCursor(kind: CursorStrategy['kind']): boolean;
+declare function isDivisibleCursor(kind: CursorStrategy["kind"]): boolean;
 /**
  * Poll-mode block. `provenance: 'cdc'` opts the poll primitive into stamping
  * `Change<T>.source = 'cdc'` and populating `dedupKey` from the cursor's
@@ -248,16 +250,22 @@ declare const PollDetectionSchema: z.ZodObject<{
 }>;
 type PollDetection = z.infer<typeof PollDetectionSchema>;
 /**
- * Webhook-mode block. `eventIdField` names the column in the consumer-owned
- * inbound staging row that `WebhookChangeSource<T>` reads to set
- * `Change<T>.dedupKey`.
+ * Webhook-mode block. `eventIdField`, when present, names the field on the
+ * emitted canonical record that `WebhookChangeSource<T>` reads to set
+ * `Change<T>.dedupKey` — used only as the fallback when the queue iterator
+ * does NOT yield an `eventId` alongside the record.
+ *
+ * `eventIdField` is **optional**: a queue iterator that always yields an
+ * `eventId` (vendor delivery metadata, the preferred channel) need not declare
+ * a record field for it. dedupKey precedence is: yielded `eventId` >
+ * `eventIdField` record extraction > undefined.
  */
 declare const WebhookDetectionSchema: z.ZodObject<{
-    eventIdField: z.ZodString;
+    eventIdField: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    eventIdField: string;
+    eventIdField?: string | undefined;
 }, {
-    eventIdField: string;
+    eventIdField?: string | undefined;
 }>;
 type WebhookDetection = z.infer<typeof WebhookDetectionSchema>;
 /**
@@ -466,11 +474,11 @@ declare const DetectionConfigSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObjec
 }>, z.ZodObject<{
     mode: z.ZodLiteral<"webhook">;
     webhook: z.ZodObject<{
-        eventIdField: z.ZodString;
+        eventIdField: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        eventIdField: string;
+        eventIdField?: string | undefined;
     }, {
-        eventIdField: string;
+        eventIdField?: string | undefined;
     }>;
     mapping: z.ZodArray<z.ZodObject<{
         source: z.ZodString;
@@ -500,7 +508,7 @@ declare const DetectionConfigSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObjec
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     webhook: {
-        eventIdField: string;
+        eventIdField?: string | undefined;
     };
     mode: "webhook";
     mapping: {
@@ -515,7 +523,7 @@ declare const DetectionConfigSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObjec
     }[];
 }, {
     webhook: {
-        eventIdField: string;
+        eventIdField?: string | undefined;
     };
     mode: "webhook";
     mapping: {

package/dist/runtime/subsystems/integration/detection-config.schema.js

@@ -7,7 +7,7 @@ import {
   ResolvedFilterSchema,
   WebhookDetectionSchema,
   isDivisibleCursor
-} from "../../../chunk-3NMCDN7L.js";
+} from "../../../chunk-5TK7MEN4.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   CURSOR_DIVISIBILITY,

package/dist/runtime/subsystems/integration/execute-integration.use-case.js

@@ -1,8 +1,8 @@
 import {
   ExecuteIntegrationUseCase
-} from "../../../chunk-OGIZXGPY.js";
-import "../../../chunk-MZ6GV4YF.js";
+} from "../../../chunk-TDEHU73T.js";
 import "../../../chunk-S7C6TIIF.js";
+import "../../../chunk-MZ6GV4YF.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   ExecuteIntegrationUseCase

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

@@ -1,7 +1,7 @@
 import "../../../chunk-KVOWSC5S.js";
 import {
   IntegrationModule
-} from "../../../chunk-GCYKMF22.js";
+} from "../../../chunk-24WXSC3C.js";
 import {
   MemoryRunRecorder
 } from "../../../chunk-EO2QPOKH.js";
@@ -10,13 +10,13 @@ import {
 } from "../../../chunk-PRWIX6UW.js";
 import {
   PostgresCursorStore
-} from "../../../chunk-DCCZB4UC.js";
+} from "../../../chunk-XWBK3XJK.js";
 import {
   MemoryCursorStore
 } from "../../../chunk-AHV4GDYM.js";
 import {
   DrizzleIntegrationRunRecorder
-} from "../../../chunk-SR7F3TJY.js";
+} from "../../../chunk-YK5JEVLX.js";
 import {
   FieldDiffSchema,
   FieldDiffValueSchema
@@ -30,7 +30,7 @@ import {
   ResolvedFilterSchema,
   WebhookDetectionSchema,
   isDivisibleCursor
-} from "../../../chunk-3NMCDN7L.js";
+} from "../../../chunk-5TK7MEN4.js";
 import {
   MemoryEntityChangeSourceRegistry
 } from "../../../chunk-4KNXX6TI.js";
@@ -39,7 +39,17 @@ import {
 } from "../../../chunk-3CJFPU6Q.js";
 import {
   ExecuteIntegrationUseCase
-} from "../../../chunk-OGIZXGPY.js";
+} from "../../../chunk-TDEHU73T.js";
+import {
+  ENTITY_CHANGE_SOURCE_REGISTRY,
+  INTEGRATION_CHANGE_SOURCE,
+  INTEGRATION_CURSOR_STORE,
+  INTEGRATION_FIELD_DIFFER,
+  INTEGRATION_MODULE_OPTIONS,
+  INTEGRATION_MULTI_TENANT,
+  INTEGRATION_RUN_RECORDER,
+  INTEGRATION_SINK
+} from "../../../chunk-S7C6TIIF.js";
 import {
   MissingTenantIdError,
   assertTenantId
@@ -60,26 +70,16 @@ import {
 } from "../../../chunk-HNWZFNKP.js";
 import {
   buildChangeSource
-} from "../../../chunk-WWGYCIJX.js";
+} from "../../../chunk-43SBT72G.js";
 import {
   PollChangeSource
 } from "../../../chunk-4MF3HKJA.js";
 import {
   WebhookChangeSource
-} from "../../../chunk-YLPAPPLW.js";
+} from "../../../chunk-TIZXQU26.js";
 import {
   DeepEqualDiffer
 } from "../../../chunk-36U5UGIO.js";
-import {
-  ENTITY_CHANGE_SOURCE_REGISTRY,
-  INTEGRATION_CHANGE_SOURCE,
-  INTEGRATION_CURSOR_STORE,
-  INTEGRATION_FIELD_DIFFER,
-  INTEGRATION_MODULE_OPTIONS,
-  INTEGRATION_MULTI_TENANT,
-  INTEGRATION_RUN_RECORDER,
-  INTEGRATION_SINK
-} from "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";
 export {

package/dist/runtime/subsystems/integration/integration-cursor-store.drizzle-backend.js

@@ -1,9 +1,9 @@
 import {
   PostgresCursorStore
-} from "../../../chunk-DCCZB4UC.js";
+} from "../../../chunk-XWBK3XJK.js";
+import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-MZ6GV4YF.js";
 import "../../../chunk-HNWZFNKP.js";
-import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";
 export {

package/dist/runtime/subsystems/integration/integration-run-recorder.drizzle-backend.js

@@ -1,10 +1,10 @@
 import {
   DrizzleIntegrationRunRecorder
-} from "../../../chunk-SR7F3TJY.js";
+} from "../../../chunk-YK5JEVLX.js";
 import "../../../chunk-SQDOBLBP.js";
+import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-MZ6GV4YF.js";
 import "../../../chunk-HNWZFNKP.js";
-import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";
 export {

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

@@ -1,15 +1,15 @@
 import {
   IntegrationModule
-} from "../../../chunk-GCYKMF22.js";
+} from "../../../chunk-24WXSC3C.js";
 import "../../../chunk-EO2QPOKH.js";
-import "../../../chunk-DCCZB4UC.js";
+import "../../../chunk-XWBK3XJK.js";
 import "../../../chunk-AHV4GDYM.js";
-import "../../../chunk-SR7F3TJY.js";
+import "../../../chunk-YK5JEVLX.js";
 import "../../../chunk-SQDOBLBP.js";
+import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-MZ6GV4YF.js";
 import "../../../chunk-HNWZFNKP.js";
 import "../../../chunk-36U5UGIO.js";
-import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";
 export {

package/dist/runtime/subsystems/integration/webhook-change-source.d.ts

@@ -12,8 +12,11 @@ import 'zod';
  * queue. The primitive owns:
  *
  *   - canonical `Change<T>.source = 'webhook'` stamping;
- *   - `dedupKey` derivation from the configured `webhook.eventIdField` on
- *     the emitted record;
+ *   - `dedupKey` derivation, preferring the `eventId` yielded alongside the
+ *     record by the queue iterator, and falling back to the configured
+ *     `webhook.eventIdField` on the emitted record when no `eventId` is yielded
+ *     (precedence: yielded `eventId` > `eventIdField` record extraction >
+ *     undefined `dedupKey`);
  *   - `externalId` derivation: the mapping entry whose `target === 'external_id'`
  *     names — via its `source` — the field on the emitted record that carries
  *     the canonical external id (mirrors `PollChangeSource`);
@@ -60,10 +63,22 @@ interface WebhookFetchContext {
 }
 /**
  * Consumer-supplied queue iterator. Returns an async iterable of
- * `{ record }` pairs — the consumer drains the inbound staging queue and
- * emits already-mapped canonical records `T`. The primitive stamps
- * `source: 'webhook'` and `dedupKey` from the record's configured
- * `webhook.eventIdField`; the consumer is the one who decided when a
+ * `{ record, eventId?, cursor? }` tuples — the consumer drains the inbound
+ * staging queue and emits already-mapped canonical records `T`. The primitive
+ * stamps `source: 'webhook'` and derives `dedupKey` with this precedence:
+ *
+ *   1. the yielded `eventId` (vendor delivery metadata — the queue is the
+ *      right channel for it: a vendor's event id should never need a field
+ *      on the vendor-neutral canonical record);
+ *   2. else the record field named by `webhook.eventIdField`, when configured;
+ *   3. else `undefined`.
+ *
+ * Yielding `eventId` is the safe channel when one canonical record identity
+ * (the `external_id`) can recur across distinct vendor events in a single
+ * drain batch — e.g. a message create and its later edit share an
+ * `external_id` but are different events. Reading dedup identity off the
+ * record (`eventIdField`) collapses those into one `dedupKey`; the yielded
+ * `eventId` keeps them distinct. The consumer is the one who decided when a
  * staging row is "ready" to drain.
  *
  * Webhook mode has no per-record cursor advance — the staging-row drain
@@ -73,6 +88,7 @@ interface WebhookFetchContext {
  */
 type WebhookFetchCallback<T> = (ctx: WebhookFetchContext) => AsyncIterable<{
     record: T;
+    eventId?: string;
     cursor?: WebhookCursor;
 }>;
 interface WebhookChangeSourceOptions<T> {
@@ -100,11 +116,25 @@ declare class WebhookChangeSource<T> implements IChangeSource<T> {
     readonly label: string;
     private readonly queue;
     private readonly externalIdSourceField;
+    /**
+     * Record field carrying the event id, when `webhook.eventIdField` is
+     * configured. Used only as the fallback when the queue iterator does NOT
+     * yield an `eventId` — see {@link WebhookFetchCallback} for the precedence.
+     */
     private readonly eventIdSourceField;
     private readonly composed;
     constructor(opts: WebhookChangeSourceOptions<T>);
     listChanges(subscription: IntegrationSubscriptionView, cursor: unknown | null): AsyncIterable<Change<T>>;
     private fetch;
+    /**
+     * Resolve `Change<T>.dedupKey` with the precedence: yielded `eventId` >
+     * `webhook.eventIdField` record extraction > `undefined`. A non-empty
+     * yielded `eventId` always wins; otherwise the configured field is read off
+     * the record (and must be a non-empty string when the field is configured);
+     * with neither, `dedupKey` is `undefined` (the orchestrator then has no
+     * delivery-level dedup signal for this change).
+     */
+    private deriveDedupKey;
 }
 
 export { WebhookChangeSource, type WebhookChangeSourceOptions, type WebhookCursor, type WebhookFetchCallback, type WebhookFetchContext };

package/dist/runtime/subsystems/integration/webhook-change-source.js

@@ -1,6 +1,6 @@
 import {
   WebhookChangeSource
-} from "../../../chunk-YLPAPPLW.js";
+} from "../../../chunk-TIZXQU26.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   WebhookChangeSource

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

@@ -1,5 +1,5 @@
 export { JobDefinitionRow, JobRunRow, JobStepRow, collisionModeEnum, jobRunStatusEnum, jobRuns, jobStepKindEnum, jobStepStatusEnum, jobSteps, jobs, parentClosePolicyEnum, replayFromEnum, triggerSourceEnum, waitKindEnum } from './job-orchestration.schema.js';
-export { JOBS_MULTI_TENANT, JOB_ORCHESTRATOR, JOB_RUN_SERVICE, JOB_STEP_SERVICE } from './jobs-domain.tokens.js';
+export { JOBS_LISTEN_NOTIFY, JOBS_MULTI_TENANT, JOB_ORCHESTRATOR, JOB_RUN_SERVICE, JOB_STEP_SERVICE } from './jobs-domain.tokens.js';
 export { C as CancelOptions, a as ConcurrencyPolicy, D as DedupePolicy, H as HandlerRegistry, b as HandlerRegistryEntry, I as IJobOrchestrator, J as JOB_HANDLER_METADATA_KEY, c as JOB_HANDLER_REGISTRY, d as JobContext, e as JobHandler, f as JobHandlerBase, g as JobHandlerMeta, h as JobPoolDef, i as JobRun, j as JobUpsertEntry, P as ParentClosePolicy, R as RetryPolicy, S as ScopeRef, k as SpawnChildOptions, l as StartOptions, m as StepOptions } from '../../../job-orchestrator.protocol-DubMVbm9.js';
 export { CancelForScopeOptions, IJobRunService, JobRunFailure, JobRunPage, JobRunSummary, ListForScopeOptions, ListJobRunsQuery, PoolStatusCount, RescheduleForScopeOptions } from './job-run-service.protocol.js';
 export { IJobStepService, JobStep, RecordStepInput } from './job-step-service.protocol.js';
@@ -8,6 +8,7 @@ export { DrizzleJobRunService } from './job-run-service.drizzle-backend.js';
 export { DrizzleJobStepService } from './job-step-service.drizzle-backend.js';
 export { BULLMQ_CONNECTION, BULLMQ_RESOLVED_CONFIG, BullMqConnectionOptions, BullMqExtensionsConfig, BullMqResolvedConfig, resolveBullMqConfig, resolvePoolQueueName } from './bullmq.config.js';
 export { JOB_WORKER_OPTIONS, JobWorker, JobWorkerOptions, buildClaimQuery, buildStaleSweepQuery, classifyError, computeBackoff } from './job-worker.js';
+export { EVENTS_WAKE_CHANNEL, JOBS_WAKE_CHANNEL, PgNotifyListener, PgNotifyListenerOptions, pgNotify } from './pg-notify.js';
 export { BootValidationError, JobCollisionError, JobNotReplayableError, JobTemplateFieldMissingError, JobTypeNotFoundError, MissingTenantIdError, ReservedPoolViolationError } from './jobs-errors.js';
 export { MemoryJobStore } from './memory-job-store.js';
 export { MemoryJobOrchestrator } from './job-orchestrator.memory-backend.js';