@pattern-stack/codegen 0.16.0 → 0.17.0

package/dist/runtime/subsystems/index.js

@@ -1,17 +1,3 @@
-import "../../chunk-ZUMULSEQ.js";
-import {
-  StorageModule
-} from "../../chunk-BK5ICA2F.js";
-import {
-  STORAGE
-} from "../../chunk-NYBCQZC7.js";
-import {
-  LocalStorageBackend
-} from "../../chunk-JWNHNUYL.js";
-import {
-  MemoryStorageBackend
-} from "../../chunk-3SZFUTXE.js";
-import "../../chunk-J6MN42LG.js";
 import "../../chunk-FI34KYZ5.js";
 import "../../chunk-L4SDDEEU.js";
 import {
@@ -26,71 +12,20 @@ import {
   OBSERVABILITY,
   OBSERVABILITY_MODULE_OPTIONS
 } from "../../chunk-Y7RRSEOC.js";
-import "../../chunk-W4HOHZVF.js";
-import "../../chunk-RUYLXR5F.js";
-import "../../chunk-XDIIVIIK.js";
-import "../../chunk-3RWMQC3K.js";
-import "../../chunk-DV4RV2DC.js";
-import "../../chunk-OTR44OH6.js";
-import "../../chunk-BULPAAD3.js";
-import "../../chunk-PNZSGAB2.js";
-import "../../chunk-VNBC3VXM.js";
-import "../../chunk-BHZP6LOV.js";
-import "../../chunk-SNQ3TOWP.js";
-import "../../chunk-T4BIIU5E.js";
-import "../../chunk-L3LZWWSX.js";
-import "../../chunk-I6MVCB5A.js";
-import "../../chunk-RHVN6NA7.js";
-import "../../chunk-ZPL74UQN.js";
-import "../../chunk-CO6LUM72.js";
-import {
-  collisionModeEnum,
-  jobRunStatusEnum,
-  jobRuns,
-  jobStepKindEnum,
-  jobStepStatusEnum,
-  jobSteps,
-  jobs,
-  parentClosePolicyEnum,
-  replayFromEnum,
-  triggerSourceEnum,
-  waitKindEnum
-} from "../../chunk-OKXZ63IA.js";
-import "../../chunk-IWAOY6KC.js";
-import {
-  CacheModule
-} from "../../chunk-COGHTKXY.js";
-import {
-  DrizzleCacheService
-} from "../../chunk-T6C4LFLC.js";
-import {
-  MemoryCacheService
-} from "../../chunk-IF5I3DAA.js";
-import "../../chunk-FASRXRX5.js";
-import {
-  CACHE
-} from "../../chunk-L6FTY45T.js";
-import "../../chunk-FN2PYDPP.js";
+import "../../chunk-ZUMULSEQ.js";
 import {
-  EventsModule
-} from "../../chunk-EJBK7I4F.js";
-import "../../chunk-GM3RMJIJ.js";
-import "../../chunk-BGULBWKJ.js";
-import "../../chunk-JRQO2IOF.js";
-import "../../chunk-V4AF6DI4.js";
+  StorageModule
+} from "../../chunk-4MVGAMUA.js";
 import {
-  DrizzleEventBus
-} from "../../chunk-4PFF3ED4.js";
-import "../../chunk-MYQIQ27N.js";
-import "../../chunk-4LH67P4U.js";
-import "../../chunk-OFRRBC7M.js";
+  LocalStorageBackend
+} from "../../chunk-JWNHNUYL.js";
 import {
-  MemoryEventBus
-} from "../../chunk-LQ6PYFU6.js";
+  MemoryStorageBackend
+} from "../../chunk-3SZFUTXE.js";
+import "../../chunk-J6MN42LG.js";
 import {
-  EVENT_BUS
-} from "../../chunk-H5NH7KPE.js";
-import "../../chunk-UQ5EHOH2.js";
+  STORAGE
+} from "../../chunk-NYBCQZC7.js";
 import "../../chunk-7C3FOSDI.js";
 import {
   OAuth2RefreshStrategy
@@ -106,15 +41,27 @@ import {
   isSessionExpiredError
 } from "../../chunk-7RELQJIN.js";
 import "../../chunk-OSQRXVG2.js";
+import "../../chunk-W4HOHZVF.js";
+import "../../chunk-GJDEPTPY.js";
+import "../../chunk-OITTYGJS.js";
+import "../../chunk-3MAZ4TQH.js";
+import "../../chunk-BULPAAD3.js";
+import "../../chunk-3VEVGL74.js";
+import "../../chunk-CDLWYZVQ.js";
+import "../../chunk-L3LZWWSX.js";
+import "../../chunk-DV4RV2DC.js";
+import "../../chunk-PNZSGAB2.js";
+import "../../chunk-SNQ3TOWP.js";
+import "../../chunk-I6MVCB5A.js";
+import "../../chunk-RHVN6NA7.js";
+import "../../chunk-OTR44OH6.js";
+import "../../chunk-T4BIIU5E.js";
 import {
   AuthModule
-} from "../../chunk-T6SCOJF4.js";
+} from "../../chunk-7LKAMLV4.js";
 import {
   EnvEncryptionKey
 } from "../../chunk-IP4OO26U.js";
-import {
-  AuthController
-} from "../../chunk-SZVPIHWE.js";
 import {
   DrizzleOAuthStateStore
 } from "../../chunk-N5OTOWTP.js";
@@ -125,8 +72,8 @@ import {
   OAuthStateError
 } from "../../chunk-BPARRK6F.js";
 import {
-  authOAuthState
-} from "../../chunk-NPFPZ2HO.js";
+  AuthController
+} from "../../chunk-SZVPIHWE.js";
 import {
   AUTH_CONNECTION_GRANT_SINK,
   AUTH_CONNECTION_READER,
@@ -137,52 +84,105 @@ import {
   OAUTH_STATE_STORE,
   STRATEGY_REGISTRY
 } from "../../chunk-6XY6ZMMD.js";
+import {
+  authOAuthState
+} from "../../chunk-NPFPZ2HO.js";
+import "../../chunk-FN2PYDPP.js";
+import "../../chunk-CO6LUM72.js";
+import "../../chunk-ZPL74UQN.js";
+import {
+  collisionModeEnum,
+  jobRunStatusEnum,
+  jobRuns,
+  jobStepKindEnum,
+  jobStepStatusEnum,
+  jobSteps,
+  jobs,
+  parentClosePolicyEnum,
+  replayFromEnum,
+  triggerSourceEnum,
+  waitKindEnum
+} from "../../chunk-OKXZ63IA.js";
+import {
+  EventsModule
+} from "../../chunk-RHYNACZS.js";
+import "../../chunk-GM3RMJIJ.js";
+import "../../chunk-BGULBWKJ.js";
+import "../../chunk-JRQO2IOF.js";
+import "../../chunk-V4AF6DI4.js";
+import "../../chunk-IWAOY6KC.js";
+import {
+  CacheModule
+} from "../../chunk-COGHTKXY.js";
+import {
+  DrizzleEventBus
+} from "../../chunk-UTNWFHJF.js";
+import "../../chunk-MYQIQ27N.js";
+import "../../chunk-4LH67P4U.js";
+import "../../chunk-OFRRBC7M.js";
+import {
+  MemoryEventBus
+} from "../../chunk-Z7PQCAVK.js";
+import "../../chunk-UQ5EHOH2.js";
+import {
+  EVENT_BUS
+} from "../../chunk-H5NH7KPE.js";
+import {
+  DrizzleCacheService
+} from "../../chunk-T6C4LFLC.js";
+import "../../chunk-FASRXRX5.js";
+import {
+  MemoryCacheService
+} from "../../chunk-IF5I3DAA.js";
+import {
+  CACHE
+} from "../../chunk-L6FTY45T.js";
 import "../../chunk-GYGNEQSC.js";
+import "../../chunk-ZUKFQL6E.js";
 import "../../chunk-KVOWSC5S.js";
-import "../../chunk-24WXSC3C.js";
-import "../../chunk-EO2QPOKH.js";
+import "../../chunk-P3AYBRP6.js";
 import "../../chunk-PRWIX6UW.js";
-import "../../chunk-XWBK3XJK.js";
-import "../../chunk-AHV4GDYM.js";
-import "../../chunk-YK5JEVLX.js";
+import "../../chunk-SR7F3TJY.js";
+import "../../chunk-EO2QPOKH.js";
 import "../../chunk-SQDOBLBP.js";
-import {
-  CURSOR_DIVISIBILITY,
-  DetectionConfigSchema,
-  isDivisibleCursor
-} from "../../chunk-3NMCDN7L.js";
-import {
-  MemoryEntityChangeSourceRegistry
-} from "../../chunk-4KNXX6TI.js";
-import {
-  UnknownEntityError
-} from "../../chunk-3CJFPU6Q.js";
 import {
   ExecuteIntegrationUseCase
-} from "../../chunk-TDEHU73T.js";
-import {
-  ENTITY_CHANGE_SOURCE_REGISTRY,
-  INTEGRATION_CHANGE_SOURCE,
-  INTEGRATION_SINK
-} from "../../chunk-S7C6TIIF.js";
-import "../../chunk-MZ6GV4YF.js";
+} from "../../chunk-OGIZXGPY.js";
 import {
   IncrementalReadBase,
   mapConcurrent
 } from "../../chunk-LG57S2SC.js";
+import "../../chunk-DCCZB4UC.js";
+import "../../chunk-MZ6GV4YF.js";
 import "../../chunk-HNWZFNKP.js";
+import "../../chunk-AHV4GDYM.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 {
+  CURSOR_DIVISIBILITY,
+  DetectionConfigSchema,
+  isDivisibleCursor
+} from "../../chunk-5TK7MEN4.js";
+import {
+  MemoryEntityChangeSourceRegistry
+} from "../../chunk-4KNXX6TI.js";
+import {
+  UnknownEntityError
+} from "../../chunk-3CJFPU6Q.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-TDEHU73T.js";
-import "../../../chunk-S7C6TIIF.js";
+} from "../../../chunk-OGIZXGPY.js";
 import "../../../chunk-MZ6GV4YF.js";
+import "../../../chunk-S7C6TIIF.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   ExecuteIntegrationUseCase

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

@@ -1,63 +1,34 @@
 import "../../../chunk-KVOWSC5S.js";
 import {
   IntegrationModule
-} from "../../../chunk-24WXSC3C.js";
-import {
-  MemoryRunRecorder
-} from "../../../chunk-EO2QPOKH.js";
+} from "../../../chunk-P3AYBRP6.js";
 import {
   createLoopbackMiddleware
 } from "../../../chunk-PRWIX6UW.js";
-import {
-  PostgresCursorStore
-} from "../../../chunk-XWBK3XJK.js";
-import {
-  MemoryCursorStore
-} from "../../../chunk-AHV4GDYM.js";
 import {
   DrizzleIntegrationRunRecorder
-} from "../../../chunk-YK5JEVLX.js";
+} from "../../../chunk-SR7F3TJY.js";
+import {
+  MemoryRunRecorder
+} from "../../../chunk-EO2QPOKH.js";
 import {
   FieldDiffSchema,
   FieldDiffValueSchema
 } from "../../../chunk-SQDOBLBP.js";
-import {
-  CURSOR_DIVISIBILITY,
-  CursorStrategySchema,
-  DetectionConfigSchema,
-  FieldMappingSchema,
-  PollDetectionSchema,
-  ResolvedFilterSchema,
-  WebhookDetectionSchema,
-  isDivisibleCursor
-} from "../../../chunk-3NMCDN7L.js";
-import {
-  MemoryEntityChangeSourceRegistry
-} from "../../../chunk-4KNXX6TI.js";
-import {
-  UnknownEntityError
-} from "../../../chunk-3CJFPU6Q.js";
 import {
   ExecuteIntegrationUseCase
-} from "../../../chunk-TDEHU73T.js";
+} from "../../../chunk-OGIZXGPY.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";
+  IncrementalReadBase,
+  mapConcurrent
+} from "../../../chunk-LG57S2SC.js";
+import {
+  PostgresCursorStore
+} from "../../../chunk-DCCZB4UC.js";
 import {
   MissingTenantIdError,
   assertTenantId
 } from "../../../chunk-MZ6GV4YF.js";
-import {
-  IncrementalReadBase,
-  mapConcurrent
-} from "../../../chunk-LG57S2SC.js";
 import {
   integrationRunActionEnum,
   integrationRunDirectionEnum,
@@ -68,18 +39,47 @@ import {
   integrationRuns,
   integrationSubscriptions
 } from "../../../chunk-HNWZFNKP.js";
+import {
+  MemoryCursorStore
+} from "../../../chunk-AHV4GDYM.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 {
+  CURSOR_DIVISIBILITY,
+  CursorStrategySchema,
+  DetectionConfigSchema,
+  FieldMappingSchema,
+  PollDetectionSchema,
+  ResolvedFilterSchema,
+  WebhookDetectionSchema,
+  isDivisibleCursor
+} from "../../../chunk-5TK7MEN4.js";
+import {
+  MemoryEntityChangeSourceRegistry
+} from "../../../chunk-4KNXX6TI.js";
+import {
+  UnknownEntityError
+} from "../../../chunk-3CJFPU6Q.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-XWBK3XJK.js";
-import "../../../chunk-S7C6TIIF.js";
+} from "../../../chunk-DCCZB4UC.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-YK5JEVLX.js";
+} from "../../../chunk-SR7F3TJY.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-24WXSC3C.js";
+} from "../../../chunk-P3AYBRP6.js";
+import "../../../chunk-SR7F3TJY.js";
 import "../../../chunk-EO2QPOKH.js";
-import "../../../chunk-XWBK3XJK.js";
-import "../../../chunk-AHV4GDYM.js";
-import "../../../chunk-YK5JEVLX.js";
 import "../../../chunk-SQDOBLBP.js";
-import "../../../chunk-S7C6TIIF.js";
+import "../../../chunk-DCCZB4UC.js";
 import "../../../chunk-MZ6GV4YF.js";
 import "../../../chunk-HNWZFNKP.js";
+import "../../../chunk-AHV4GDYM.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