@pattern-stack/codegen 0.23.0 → 0.24.0

package/dist/runtime/subsystems/events/generated/registry.d.ts

@@ -95,6 +95,42 @@ declare const eventRegistry: {
             readonly backoff: "exponential";
         };
     };
+    readonly message_created: {
+        readonly type: "message_created";
+        readonly tier: "domain";
+        readonly direction: "change";
+        readonly pool: "events_change";
+        readonly aggregate: "message";
+        readonly version: 1;
+        readonly retry: {
+            readonly attempts: 3;
+            readonly backoff: "exponential";
+        };
+    };
+    readonly message_deleted: {
+        readonly type: "message_deleted";
+        readonly tier: "domain";
+        readonly direction: "change";
+        readonly pool: "events_change";
+        readonly aggregate: "message";
+        readonly version: 1;
+        readonly retry: {
+            readonly attempts: 3;
+            readonly backoff: "exponential";
+        };
+    };
+    readonly message_edited: {
+        readonly type: "message_edited";
+        readonly tier: "domain";
+        readonly direction: "change";
+        readonly pool: "events_change";
+        readonly aggregate: "message";
+        readonly version: 1;
+        readonly retry: {
+            readonly attempts: 3;
+            readonly backoff: "exponential";
+        };
+    };
     readonly stripe_payment_received: {
         readonly type: "stripe_payment_received";
         readonly tier: "domain";

package/dist/runtime/subsystems/events/generated/registry.js

@@ -1,7 +1,7 @@
 import {
   eventRegistry,
   getEventMetadata
-} from "../../../../chunk-JOBQ6RUU.js";
+} from "../../../../chunk-LQZESSM3.js";
 import "../../../../chunk-2E224ZSN.js";
 export {
   eventRegistry,

package/dist/runtime/subsystems/events/generated/schemas.d.ts

@@ -72,6 +72,60 @@ declare const dealStageChangedPayloadSchema: z.ZodObject<{
     newStage: string;
     oldStage: string;
 }>;
+declare const messageCreatedPayloadSchema: z.ZodObject<{
+    changedFields: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    entityId: z.ZodString;
+    externalId: z.ZodString;
+    provider: z.ZodString;
+    source: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    source: string;
+    changedFields: Record<string, unknown> | null;
+    entityId: string;
+    externalId: string;
+    provider: string;
+}, {
+    source: string;
+    changedFields: Record<string, unknown> | null;
+    entityId: string;
+    externalId: string;
+    provider: string;
+}>;
+declare const messageDeletedPayloadSchema: z.ZodObject<{
+    entityId: z.ZodString;
+    externalId: z.ZodString;
+    provider: z.ZodString;
+    source: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    source: string;
+    entityId: string;
+    externalId: string;
+    provider: string;
+}, {
+    source: string;
+    entityId: string;
+    externalId: string;
+    provider: string;
+}>;
+declare const messageEditedPayloadSchema: z.ZodObject<{
+    changedFields: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    entityId: z.ZodString;
+    externalId: z.ZodString;
+    provider: z.ZodString;
+    source: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    source: string;
+    changedFields: Record<string, unknown> | null;
+    entityId: string;
+    externalId: string;
+    provider: string;
+}, {
+    source: string;
+    changedFields: Record<string, unknown> | null;
+    entityId: string;
+    externalId: string;
+    provider: string;
+}>;
 declare const stripePaymentReceivedPayloadSchema: z.ZodObject<{
     amountCents: z.ZodNumber;
     currency: z.ZodString;
@@ -177,6 +231,60 @@ declare const eventPayloadSchemas: {
         newStage: string;
         oldStage: string;
     }>;
+    readonly message_created: z.ZodObject<{
+        changedFields: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        entityId: z.ZodString;
+        externalId: z.ZodString;
+        provider: z.ZodString;
+        source: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source: string;
+        changedFields: Record<string, unknown> | null;
+        entityId: string;
+        externalId: string;
+        provider: string;
+    }, {
+        source: string;
+        changedFields: Record<string, unknown> | null;
+        entityId: string;
+        externalId: string;
+        provider: string;
+    }>;
+    readonly message_deleted: z.ZodObject<{
+        entityId: z.ZodString;
+        externalId: z.ZodString;
+        provider: z.ZodString;
+        source: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source: string;
+        entityId: string;
+        externalId: string;
+        provider: string;
+    }, {
+        source: string;
+        entityId: string;
+        externalId: string;
+        provider: string;
+    }>;
+    readonly message_edited: z.ZodObject<{
+        changedFields: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        entityId: z.ZodString;
+        externalId: z.ZodString;
+        provider: z.ZodString;
+        source: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source: string;
+        changedFields: Record<string, unknown> | null;
+        entityId: string;
+        externalId: string;
+        provider: string;
+    }, {
+        source: string;
+        changedFields: Record<string, unknown> | null;
+        entityId: string;
+        externalId: string;
+        provider: string;
+    }>;
     readonly stripe_payment_received: z.ZodObject<{
         amountCents: z.ZodNumber;
         currency: z.ZodString;
@@ -211,4 +319,4 @@ declare const eventPayloadSchemas: {
     }>;
 };
 
-export { contactCreatedPayloadSchema, contactMarkedChampionPayloadSchema, contactMergedPayloadSchema, crmSyncStartedPayloadSchema, dealCreatedPayloadSchema, dealStageChangedPayloadSchema, eventPayloadSchemas, stripePaymentReceivedPayloadSchema, webhookOutboundContactSyncPayloadSchema };
+export { contactCreatedPayloadSchema, contactMarkedChampionPayloadSchema, contactMergedPayloadSchema, crmSyncStartedPayloadSchema, dealCreatedPayloadSchema, dealStageChangedPayloadSchema, eventPayloadSchemas, messageCreatedPayloadSchema, messageDeletedPayloadSchema, messageEditedPayloadSchema, stripePaymentReceivedPayloadSchema, webhookOutboundContactSyncPayloadSchema };

package/dist/runtime/subsystems/events/generated/schemas.js

@@ -6,9 +6,12 @@ import {
   dealCreatedPayloadSchema,
   dealStageChangedPayloadSchema,
   eventPayloadSchemas,
+  messageCreatedPayloadSchema,
+  messageDeletedPayloadSchema,
+  messageEditedPayloadSchema,
   stripePaymentReceivedPayloadSchema,
   webhookOutboundContactSyncPayloadSchema
-} from "../../../../chunk-JRQO2IOF.js";
+} from "../../../../chunk-MU54DZCC.js";
 import "../../../../chunk-2E224ZSN.js";
 export {
   contactCreatedPayloadSchema,
@@ -18,6 +21,9 @@ export {
   dealCreatedPayloadSchema,
   dealStageChangedPayloadSchema,
   eventPayloadSchemas,
+  messageCreatedPayloadSchema,
+  messageDeletedPayloadSchema,
+  messageEditedPayloadSchema,
   stripePaymentReceivedPayloadSchema,
   webhookOutboundContactSyncPayloadSchema
 };

package/dist/runtime/subsystems/events/generated/types.d.ts

@@ -56,6 +56,52 @@ interface DealStageChangedEvent extends DomainEvent {
         oldStage: string;
     };
 }
+interface MessageCreatedEvent extends DomainEvent {
+    readonly type: 'message_created';
+    readonly aggregateType: 'message';
+    readonly payload: {
+        /** Differ's per-field before/after map (same value as integration_run_items.changed_fields). */
+        changedFields: Record<string, unknown> | null;
+        /** Local aggregate id the sink wrote/soft-deleted. */
+        entityId: string;
+        /** Vendor external id the change keyed on. */
+        externalId: string;
+        /** Provider label (e.g. 'slack', 'google'). */
+        provider: string;
+        /** Provenance marker — always 'integration'. A write-back action reads this to avoid echoing the change back to the vendor. */
+        source: string;
+    };
+}
+interface MessageDeletedEvent extends DomainEvent {
+    readonly type: 'message_deleted';
+    readonly aggregateType: 'message';
+    readonly payload: {
+        /** Local aggregate id the sink wrote/soft-deleted. */
+        entityId: string;
+        /** Vendor external id the change keyed on. */
+        externalId: string;
+        /** Provider label (e.g. 'slack', 'google'). */
+        provider: string;
+        /** Provenance marker — always 'integration'. A write-back action reads this to avoid echoing the change back to the vendor. */
+        source: string;
+    };
+}
+interface MessageEditedEvent extends DomainEvent {
+    readonly type: 'message_edited';
+    readonly aggregateType: 'message';
+    readonly payload: {
+        /** Differ's per-field before/after map (same value as integration_run_items.changed_fields). */
+        changedFields: Record<string, unknown> | null;
+        /** Local aggregate id the sink wrote/soft-deleted. */
+        entityId: string;
+        /** Vendor external id the change keyed on. */
+        externalId: string;
+        /** Provider label (e.g. 'slack', 'google'). */
+        provider: string;
+        /** Provenance marker — always 'integration'. A write-back action reads this to avoid echoing the change back to the vendor. */
+        source: string;
+    };
+}
 /** Stripe charge.succeeded webhook, post-signature-verification. */
 interface StripePaymentReceivedEvent extends DomainEvent {
     readonly type: 'stripe_payment_received';
@@ -80,11 +126,11 @@ interface WebhookOutboundContactSyncEvent extends DomainEvent {
         operation: string;
     };
 }
-type AppDomainEvent = ContactCreatedEvent | ContactMarkedChampionEvent | ContactMergedEvent | CrmSyncStartedEvent | DealCreatedEvent | DealStageChangedEvent | StripePaymentReceivedEvent | WebhookOutboundContactSyncEvent;
+type AppDomainEvent = ContactCreatedEvent | ContactMarkedChampionEvent | ContactMergedEvent | CrmSyncStartedEvent | DealCreatedEvent | DealStageChangedEvent | MessageCreatedEvent | MessageDeletedEvent | MessageEditedEvent | StripePaymentReceivedEvent | WebhookOutboundContactSyncEvent;
 type EventTypeName = AppDomainEvent['type'];
 type EventOfType<T extends EventTypeName> = Extract<AppDomainEvent, {
     type: T;
 }>;
 type PayloadOfType<T extends EventTypeName> = EventOfType<T>['payload'];
 
-export type { AppDomainEvent, ContactCreatedEvent, ContactMarkedChampionEvent, ContactMergedEvent, CrmSyncStartedEvent, DealCreatedEvent, DealStageChangedEvent, EventOfType, EventTypeName, PayloadOfType, StripePaymentReceivedEvent, WebhookOutboundContactSyncEvent };
+export type { AppDomainEvent, ContactCreatedEvent, ContactMarkedChampionEvent, ContactMergedEvent, CrmSyncStartedEvent, DealCreatedEvent, DealStageChangedEvent, EventOfType, EventTypeName, MessageCreatedEvent, MessageDeletedEvent, MessageEditedEvent, PayloadOfType, StripePaymentReceivedEvent, WebhookOutboundContactSyncEvent };

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

@@ -2,12 +2,12 @@ import "../../../chunk-SYVZ4MD2.js";
 import {
   EventSchedulerLifecycle,
   EventsModule
-} from "../../../chunk-42763UEE.js";
+} from "../../../chunk-6M6LZEP6.js";
 import {
   TypedEventBus
-} from "../../../chunk-INO47JXD.js";
-import "../../../chunk-JOBQ6RUU.js";
-import "../../../chunk-JRQO2IOF.js";
+} from "../../../chunk-PBENHIN2.js";
+import "../../../chunk-LQZESSM3.js";
+import "../../../chunk-MU54DZCC.js";
 import {
   EventScheduler,
   SCHEDULE_FLOOR_MS,

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

@@ -1,5 +1,5 @@
 export { DomainEvent, DrizzleTransaction, IEventBus } from './events/event-bus.protocol.js';
-export { EVENT_BUS } from './events/events.tokens.js';
+export { EVENT_BUS, TYPED_EVENT_BUS } from './events/events.tokens.js';
 export { EventsModule } from './events/events.module.js';
 export { MemoryEventBus } from './events/event-bus.memory-backend.js';
 export { DrizzleEventBus } from './events/event-bus.drizzle-backend.js';
@@ -22,6 +22,7 @@ export { ObservabilityError } from './observability/observability-errors.js';
 export { IChangeSource, IntegrationSubscriptionView } from './integration/integration-change-source.protocol.js';
 export { CursorSnapshot } from './integration/integration-cursor-store.protocol.js';
 export { IIntegrationSink } from './integration/integration-sink.protocol.js';
+export { IIntegrationChangeEmitter, IntegrationChangeAction, IntegrationChangeNotification } from './integration/integration-change-emitter.protocol.js';
 export { IntegrationRunSummary } from './integration/integration-run-recorder.protocol.js';
 export { IEntityChangeSourceRegistry, UnknownEntityError } from './integration/entity-change-source-registry.protocol.js';
 export { MemoryEntityChangeSourceRegistry } from './integration/entity-change-source-registry.memory.js';
@@ -30,7 +31,7 @@ export { PollChangeSource, PollChangeSourceOptions, PollCursor, PollFetchCallbac
 export { IncrementalRead, IncrementalReadBase, RandomRead, ReadContext, ReadMode, ReadRequest, Ref, SourcedRecord, mapConcurrent } from './integration/incremental-read.js';
 export { WebhookChangeSource, WebhookChangeSourceOptions, WebhookCursor, WebhookFetchCallback, WebhookFetchContext } from './integration/webhook-change-source.js';
 export { buildChangeSource } from './integration/build-change-source.js';
-export { ENTITY_CHANGE_SOURCE_REGISTRY, INTEGRATION_CHANGE_SOURCE, INTEGRATION_SINK } from './integration/integration.tokens.js';
+export { ENTITY_CHANGE_SOURCE_REGISTRY, INTEGRATION_CHANGE_EMITTER, INTEGRATION_CHANGE_SOURCE, INTEGRATION_SINK } from './integration/integration.tokens.js';
 export { ExecuteIntegrationUseCase } from './integration/execute-integration.use-case.js';
 export { AuthCredentials, AuthResolveOptions, IAuthStrategy } from './auth/protocols/auth-strategy.js';
 export { IEncryptionKey } from './auth/protocols/encryption-key.js';

package/dist/runtime/subsystems/index.js

@@ -1,3 +1,4 @@
+import "../../chunk-W4HOHZVF.js";
 import "../../chunk-ZUMULSEQ.js";
 import {
   StorageModule
@@ -19,21 +20,20 @@ import {
 } from "../../chunk-EWYCWP4H.js";
 import {
   ObservabilityModule
-} from "../../chunk-XKWOJZZ4.js";
+} from "../../chunk-37PILMIT.js";
 import "../../chunk-AQFQ4BYM.js";
-import "../../chunk-CLWBNXKF.js";
 import {
   OBSERVABILITY,
   OBSERVABILITY_MODULE_OPTIONS
 } from "../../chunk-Y7RRSEOC.js";
-import "../../chunk-W4HOHZVF.js";
+import "../../chunk-PLUJEQLU.js";
 import "../../chunk-SYVZ4MD2.js";
 import {
   EventsModule
-} from "../../chunk-42763UEE.js";
-import "../../chunk-INO47JXD.js";
-import "../../chunk-JOBQ6RUU.js";
-import "../../chunk-JRQO2IOF.js";
+} from "../../chunk-6M6LZEP6.js";
+import "../../chunk-PBENHIN2.js";
+import "../../chunk-LQZESSM3.js";
+import "../../chunk-MU54DZCC.js";
 import "../../chunk-DUUCU77W.js";
 import "../../chunk-DUBZOXJC.js";
 import "../../chunk-IWAOY6KC.js";
@@ -57,25 +57,26 @@ import {
 import {
   CACHE
 } from "../../chunk-L6FTY45T.js";
-import "../../chunk-SH76CFAY.js";
+import "../../chunk-ENAR3F5S.js";
 import "../../chunk-7B7MMDOJ.js";
-import "../../chunk-FIUC6QB5.js";
-import "../../chunk-VQOAATIG.js";
+import "../../chunk-CKLM57IE.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-E6PLM6QG.js";
+import "../../chunk-VQOAATIG.js";
+import "../../chunk-PNZSGAB2.js";
+import "../../chunk-SNQ3TOWP.js";
 import "../../chunk-T4BIIU5E.js";
 import "../../chunk-Q6LRJ4VI.js";
 import "../../chunk-7P5ODGLA.js";
 import "../../chunk-ZPL74UQN.js";
 import {
-  EVENT_BUS
+  EVENT_BUS,
+  TYPED_EVENT_BUS
 } from "../../chunk-H5NH7KPE.js";
 import "../../chunk-4LH67P4U.js";
 import {
@@ -119,12 +120,12 @@ import {
 import {
   MemoryOAuthStateStore
 } from "../../chunk-QLTJSCE6.js";
-import {
-  OAuthStateError
-} from "../../chunk-BPARRK6F.js";
 import {
   AuthController
 } from "../../chunk-SZVPIHWE.js";
+import {
+  OAuthStateError
+} from "../../chunk-BPARRK6F.js";
 import {
   authOAuthState
 } from "../../chunk-NPFPZ2HO.js";
@@ -140,11 +141,11 @@ import {
 } from "../../chunk-6XY6ZMMD.js";
 import "../../chunk-GYGNEQSC.js";
 import "../../chunk-KVOWSC5S.js";
-import "../../chunk-QFUIE37H.js";
-import "../../chunk-FFUDEIFF.js";
-import "../../chunk-EO2QPOKH.js";
 import "../../chunk-PRWIX6UW.js";
-import "../../chunk-O2A6XHGD.js";
+import "../../chunk-KFXXOFDC.js";
+import "../../chunk-HN5HT5WL.js";
+import "../../chunk-EO2QPOKH.js";
+import "../../chunk-LLDJS7PJ.js";
 import "../../chunk-HNWZFNKP.js";
 import "../../chunk-AHV4GDYM.js";
 import "../../chunk-SQDOBLBP.js";
@@ -171,12 +172,13 @@ import {
 } from "../../chunk-3CJFPU6Q.js";
 import {
   ExecuteIntegrationUseCase
-} from "../../chunk-TDEHU73T.js";
+} from "../../chunk-YIVQ7KLS.js";
 import {
   ENTITY_CHANGE_SOURCE_REGISTRY,
+  INTEGRATION_CHANGE_EMITTER,
   INTEGRATION_CHANGE_SOURCE,
   INTEGRATION_SINK
-} from "../../chunk-S7C6TIIF.js";
+} from "../../chunk-S5G3HO7N.js";
 import "../../chunk-MZ6GV4YF.js";
 import {
   IncrementalReadBase,
@@ -207,6 +209,7 @@ export {
   EnvEncryptionKey,
   EventsModule,
   ExecuteIntegrationUseCase,
+  INTEGRATION_CHANGE_EMITTER,
   INTEGRATION_CHANGE_SOURCE,
   INTEGRATION_SINK,
   IncrementalReadBase,
@@ -228,6 +231,7 @@ export {
   STRATEGY_REGISTRY,
   SessionExpiredError,
   StorageModule,
+  TYPED_EVENT_BUS,
   UnknownEntityError,
   WebhookChangeSource,
   authOAuthState,

package/dist/runtime/subsystems/integration/execute-integration.use-case.d.ts

@@ -3,6 +3,7 @@ import { ICursorStore } from './integration-cursor-store.protocol.js';
 import { IFieldDiffer } from './integration-field-diff.protocol.js';
 import { IIntegrationSink } from './integration-sink.protocol.js';
 import { IIntegrationRunRecorder } from './integration-run-recorder.protocol.js';
+import { IIntegrationChangeEmitter } from './integration-change-emitter.protocol.js';
 import 'zod';
 
 interface ExecuteIntegrationInput<T> {
@@ -47,10 +48,19 @@ declare class ExecuteIntegrationUseCase<T extends Record<string, unknown>> {
     private readonly sink;
     private readonly recorder;
     private readonly multiTenant;
+    private readonly emitter;
     private readonly logger;
-    constructor(source: IChangeSource<T>, cursors: ICursorStore, differ: IFieldDiffer<T>, sink: IIntegrationSink<T>, recorder: IIntegrationRunRecorder, multiTenant?: boolean);
+    constructor(source: IChangeSource<T>, cursors: ICursorStore, differ: IFieldDiffer<T>, sink: IIntegrationSink<T>, recorder: IIntegrationRunRecorder, multiTenant?: boolean, emitter?: IIntegrationChangeEmitter | null);
     execute(input: ExecuteIntegrationInput<T>): Promise<ExecuteIntegrationResult>;
     private processChange;
+    /**
+     * Publish one typed data-level change event via the optional emitter
+     * (EMIT-CHANGES seam). No-op when no emitter is bound (the back-compat
+     * default). A failed publish is logged but never aborts the run — the row is
+     * already written; emission is best-effort (the outbox tx, when the generated
+     * adapter rides on one, gives the at-least-once guarantee, not this try/catch).
+     */
+    private emitChange;
 }
 
 export { type ExecuteIntegrationInput, type ExecuteIntegrationResult, ExecuteIntegrationUseCase };

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

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

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

@@ -2,6 +2,7 @@ export { Change, ChangeSource, IChangeSource, IntegrationSubscriptionView } from
 export { CursorSnapshot, ICursorStore } from './integration-cursor-store.protocol.js';
 export { DiffResult, FieldDiff, FieldDiffSchema, FieldDiffValue, FieldDiffValueSchema, IFieldDiffer } from './integration-field-diff.protocol.js';
 export { IIntegrationSink } from './integration-sink.protocol.js';
+export { IIntegrationChangeEmitter, IntegrationChangeAction, IntegrationChangeNotification } from './integration-change-emitter.protocol.js';
 export { CompleteRunInput, IIntegrationRunRecorder, IntegrationRunSummary, RecordItemInput, StartRunInput } from './integration-run-recorder.protocol.js';
 export { ILoopbackFingerprintStore } from './integration-loopback.protocol.js';
 export { IEntityChangeSourceRegistry, UnknownEntityError } from './entity-change-source-registry.protocol.js';
@@ -13,7 +14,7 @@ export { PollChangeSource, PollChangeSourceOptions, PollCursor, PollFetchCallbac
 export { IncrementalRead, IncrementalReadBase, RandomRead, ReadContext, ReadMode, ReadRequest, Ref, SourcedRecord, mapConcurrent } from './incremental-read.js';
 export { WebhookChangeSource, WebhookChangeSourceOptions, WebhookCursor, WebhookFetchCallback, WebhookFetchContext } from './webhook-change-source.js';
 export { buildChangeSource } from './build-change-source.js';
-export { 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 './integration.tokens.js';
+export { ENTITY_CHANGE_SOURCE_REGISTRY, INTEGRATION_CHANGE_EMITTER, INTEGRATION_CHANGE_SOURCE, INTEGRATION_CURSOR_STORE, INTEGRATION_FIELD_DIFFER, INTEGRATION_MODULE_OPTIONS, INTEGRATION_MULTI_TENANT, INTEGRATION_RUN_RECORDER, INTEGRATION_SINK } from './integration.tokens.js';
 export { MissingTenantIdError, assertTenantId } from './integration-errors.js';
 export { IntegrationRunItemRow, IntegrationRunRow, IntegrationSubscriptionRow, integrationRunActionEnum, integrationRunDirectionEnum, integrationRunItemOperationEnum, integrationRunItemStatusEnum, integrationRunItems, integrationRunStatusEnum, integrationRuns, integrationSubscriptions } from './integration-audit.schema.js';
 export { MemoryCursorStore } from './integration-cursor-store.memory-backend.js';

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

@@ -1,19 +1,19 @@
 import "../../../chunk-KVOWSC5S.js";
+import {
+  createLoopbackMiddleware
+} from "../../../chunk-PRWIX6UW.js";
 import {
   IntegrationModule
-} from "../../../chunk-QFUIE37H.js";
+} from "../../../chunk-KFXXOFDC.js";
 import {
   DrizzleIntegrationRunRecorder
-} from "../../../chunk-FFUDEIFF.js";
+} from "../../../chunk-HN5HT5WL.js";
 import {
   MemoryRunRecorder
 } from "../../../chunk-EO2QPOKH.js";
-import {
-  createLoopbackMiddleware
-} from "../../../chunk-PRWIX6UW.js";
 import {
   PostgresCursorStore
-} from "../../../chunk-O2A6XHGD.js";
+} from "../../../chunk-LLDJS7PJ.js";
 import {
   integrationRunActionEnum,
   integrationRunDirectionEnum,
@@ -61,9 +61,10 @@ import {
 } from "../../../chunk-3CJFPU6Q.js";
 import {
   ExecuteIntegrationUseCase
-} from "../../../chunk-TDEHU73T.js";
+} from "../../../chunk-YIVQ7KLS.js";
 import {
   ENTITY_CHANGE_SOURCE_REGISTRY,
+  INTEGRATION_CHANGE_EMITTER,
   INTEGRATION_CHANGE_SOURCE,
   INTEGRATION_CURSOR_STORE,
   INTEGRATION_FIELD_DIFFER,
@@ -71,7 +72,7 @@ import {
   INTEGRATION_MULTI_TENANT,
   INTEGRATION_RUN_RECORDER,
   INTEGRATION_SINK
-} from "../../../chunk-S7C6TIIF.js";
+} from "../../../chunk-S5G3HO7N.js";
 import {
   MissingTenantIdError,
   assertTenantId
@@ -93,6 +94,7 @@ export {
   FieldDiffSchema,
   FieldDiffValueSchema,
   FieldMappingSchema,
+  INTEGRATION_CHANGE_EMITTER,
   INTEGRATION_CHANGE_SOURCE,
   INTEGRATION_CURSOR_STORE,
   INTEGRATION_FIELD_DIFFER,

package/dist/runtime/subsystems/integration/integration-change-emitter.protocol.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Integration subsystem — change-emitter protocol (port).
+ *
+ * `IIntegrationChangeEmitter` is the OPT-IN seam through which the generic
+ * orchestrator (`ExecuteIntegrationUseCase`) publishes a typed, data-level
+ * domain event after every sink write/soft-delete. It is the upstream-generalized
+ * form of the per-sink event emission swe-brain hand-built (ADR-0009 Amendment B):
+ * the differ already records `changed_fields` on `integration_run_items`, but
+ * nothing publishes a "this entity changed" domain event for downstream
+ * trigger→action consumers. This port closes that gap.
+ *
+ * ## Why a port (not a direct TypedEventBus call in the orchestrator)
+ *
+ * The orchestrator is strictly provider- AND entity-agnostic: `entityType` is a
+ * bare `string` and the canonical record is generic `T` (see the use-case header
+ * "No CRM bleed"). It therefore cannot know the typed event NAME
+ * (`<entity>_created`) or the typed payload shape at compile time. The typed
+ * knowledge lives at the per-entity assembly wiring (codegen knows the entity
+ * name there). So the orchestrator depends on this thin, untyped port; codegen
+ * binds a per-entity adapter that maps `(operation) → <entity>_<verb>` and calls
+ * the project's generated `TypedEventBus.publish(...)` with the typed payload.
+ *
+ * ## Backwards compatibility
+ *
+ * The port is `@Optional()` on the orchestrator. Entities that do NOT opt in
+ * (`integration.sink.emit_changes` absent/false) bind no emitter, so the
+ * orchestrator's `this.emitter` is `undefined` and NOTHING is published — zero
+ * behavior change. This is the invariant the snapshot fixture (which opts none
+ * in) keeps green.
+ *
+ * ## Provenance — loop-breaking
+ *
+ * Every emitted event carries `source: 'integration'` in its payload. A future
+ * write-back action (the Intervention layer in swe-brain terms) that subscribes
+ * to these events can detect `source === 'integration'` and decline to echo the
+ * change back to the vendor, breaking the inbound→writeback→inbound loop. This
+ * is the data-layer counterpart of the loopback middleware that already guards
+ * the read side (`createLoopbackMiddleware`).
+ *
+ * ## Transactionality
+ *
+ * `emitChange` receives the same `tx` the sink wrote under (when the sink exposes
+ * one — today the sink owns its own transaction internally, so `tx` is reserved
+ * for the future where the orchestrator drives the transaction). The generated
+ * adapter forwards `tx` into `TypedEventBus.publish(type, id, payload, { tx })`,
+ * so the event lands in the outbox iff the row commits (the events subsystem's
+ * outbox guarantee). When `tx` is absent the publish is post-commit best-effort,
+ * matching today's sink-owns-its-own-transaction reality.
+ */
+/** The data-level action the orchestrator observed. Maps onto the generated
+ *  event verb: `created → <entity>_created`, `updated → <entity>_edited`
+ *  (per swe-brain ADR-0009 B1 — `_edited`, never `_updated`),
+ *  `deleted → <entity>_deleted` (tombstone soft-delete). `noop` never emits. */
+type IntegrationChangeAction = 'created' | 'updated' | 'deleted';
+/**
+ * The vendor-blind change descriptor the orchestrator hands the emitter. The
+ * generated adapter reshapes this into the typed `<entity>_<verb>` payload
+ * (`{ entityId, externalId, provider, changedFields?, source: 'integration' }`).
+ */
+interface IntegrationChangeNotification {
+    /** The local row id the sink wrote/soft-deleted (the domain aggregate id —
+     *  becomes `aggregateId` on the published event AND `entityId` in the payload). */
+    readonly entityId: string;
+    /** Vendor-prefixed-or-bare external id the change keyed on (e.g. `slack:123`). */
+    readonly externalId: string;
+    /** Provider label from `ExecuteIntegrationInput.provider` (e.g. `'slack'`). */
+    readonly provider: string;
+    /** The observed action. `created`/`updated` come from the existing-row check;
+     *  `deleted` from the soft-delete path. */
+    readonly action: IntegrationChangeAction;
+    /** The differ's structured per-field before/after map (the same value written
+     *  to `integration_run_items.changed_fields`). Absent on deletes. */
+    readonly changedFields?: Record<string, unknown>;
+    /** Multi-tenant deployments thread the tenant id through to the event metadata. */
+    readonly tenantId?: string | null;
+    /** The transaction the sink wrote under, when the orchestrator drives one.
+     *  Forwarded to `TypedEventBus.publish(..., { tx })` for the outbox guarantee.
+     *  Reserved: today the sink owns its own transaction, so this is usually
+     *  `undefined` and the publish is post-commit. Typed `unknown` here so the
+     *  port stays free of a Drizzle type dependency (the generated adapter narrows). */
+    readonly tx?: unknown;
+}
+/**
+ * Post-upsert change-event emission port.
+ *
+ * One implementation per opted-in (entity, provider) assembly — codegen-emitted,
+ * bound to `INTEGRATION_CHANGE_EMITTER` in that assembly module. The orchestrator
+ * injects it `@Optional()`; an unbound token means no emission (back-compat).
+ */
+interface IIntegrationChangeEmitter {
+    /**
+     * Publish the typed `<entity>_<verb>` domain event for one observed change.
+     *
+     * MUST be called only for real changes — the orchestrator never calls this on
+     * a `noop` diff (canonical state unchanged) or a delete that hit no local row
+     * (no tombstone created). Implementations should treat a call as "this thing
+     * happened" and publish unconditionally.
+     *
+     * Errors are the orchestrator's concern: it wraps the call so a failed publish
+     * does not abort the run (the row is already written; emission is best-effort
+     * unless ridden on the outbox tx). See `ExecuteIntegrationUseCase.processChange`.
+     */
+    emitChange(notification: IntegrationChangeNotification): Promise<void>;
+}
+
+export type { IIntegrationChangeEmitter, IntegrationChangeAction, IntegrationChangeNotification };

package/dist/runtime/subsystems/integration/integration-change-emitter.protocol.js

@@ -0,0 +1 @@
+//# sourceMappingURL=integration-change-emitter.protocol.js.map