@pattern-stack/codegen 0.23.0 → 0.24.0

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -1,8 +1,8 @@
 import {
   PostgresCursorStore
-} from "../../../chunk-O2A6XHGD.js";
+} from "../../../chunk-LLDJS7PJ.js";
 import "../../../chunk-HNWZFNKP.js";
-import "../../../chunk-S7C6TIIF.js";
+import "../../../chunk-S5G3HO7N.js";
 import "../../../chunk-MZ6GV4YF.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

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

@@ -1,9 +1,9 @@
 import {
   DrizzleIntegrationRunRecorder
-} from "../../../chunk-FFUDEIFF.js";
+} from "../../../chunk-HN5HT5WL.js";
 import "../../../chunk-HNWZFNKP.js";
 import "../../../chunk-SQDOBLBP.js";
-import "../../../chunk-S7C6TIIF.js";
+import "../../../chunk-S5G3HO7N.js";
 import "../../../chunk-MZ6GV4YF.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

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

@@ -1,14 +1,14 @@
 import {
   IntegrationModule
-} from "../../../chunk-QFUIE37H.js";
-import "../../../chunk-FFUDEIFF.js";
+} from "../../../chunk-KFXXOFDC.js";
+import "../../../chunk-HN5HT5WL.js";
 import "../../../chunk-EO2QPOKH.js";
-import "../../../chunk-O2A6XHGD.js";
+import "../../../chunk-LLDJS7PJ.js";
 import "../../../chunk-HNWZFNKP.js";
 import "../../../chunk-AHV4GDYM.js";
 import "../../../chunk-SQDOBLBP.js";
 import "../../../chunk-JEINYUJH.js";
-import "../../../chunk-S7C6TIIF.js";
+import "../../../chunk-S5G3HO7N.js";
 import "../../../chunk-MZ6GV4YF.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

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

@@ -23,6 +23,16 @@ declare const INTEGRATION_CHANGE_SOURCE: "INTEGRATION_CHANGE_SOURCE";
 declare const INTEGRATION_CURSOR_STORE: "INTEGRATION_CURSOR_STORE";
 declare const INTEGRATION_FIELD_DIFFER: "INTEGRATION_FIELD_DIFFER";
 declare const INTEGRATION_SINK: "INTEGRATION_SINK";
+/**
+ * Optional post-upsert change-event emitter token (EMIT-CHANGES seam).
+ *
+ * Backed by `IIntegrationChangeEmitter`. Bound ONLY by codegen-emitted assembly
+ * modules whose entity opts in via `integration.sink.emit_changes: true`. The
+ * orchestrator injects it `@Optional()` — an unbound token means no domain
+ * events are published (the back-compat default for non-opted-in entities).
+ * See `integration-change-emitter.protocol.ts`.
+ */
+declare const INTEGRATION_CHANGE_EMITTER: "INTEGRATION_CHANGE_EMITTER";
 /**
  * Run-recorder token (SYNC-5). Backed by `IIntegrationRunRecorder`. Drizzle impl
  * lands in SYNC-4; tests provide inline fakes.
@@ -57,4 +67,4 @@ declare const INTEGRATION_MULTI_TENANT: "INTEGRATION_MULTI_TENANT";
  */
 declare const ENTITY_CHANGE_SOURCE_REGISTRY: "ENTITY_CHANGE_SOURCE_REGISTRY";
 
-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 };
+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 };

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

@@ -1,5 +1,6 @@
 import {
   ENTITY_CHANGE_SOURCE_REGISTRY,
+  INTEGRATION_CHANGE_EMITTER,
   INTEGRATION_CHANGE_SOURCE,
   INTEGRATION_CURSOR_STORE,
   INTEGRATION_FIELD_DIFFER,
@@ -7,10 +8,11 @@ import {
   INTEGRATION_MULTI_TENANT,
   INTEGRATION_RUN_RECORDER,
   INTEGRATION_SINK
-} from "../../../chunk-S7C6TIIF.js";
+} from "../../../chunk-S5G3HO7N.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   ENTITY_CHANGE_SOURCE_REGISTRY,
+  INTEGRATION_CHANGE_EMITTER,
   INTEGRATION_CHANGE_SOURCE,
   INTEGRATION_CURSOR_STORE,
   INTEGRATION_FIELD_DIFFER,

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

@@ -2,7 +2,7 @@ import "../../../chunk-W4HOHZVF.js";
 import {
   JobWorkerModule,
   JobWorkerOrchestrator
-} from "../../../chunk-SH76CFAY.js";
+} from "../../../chunk-ENAR3F5S.js";
 import {
   JOB_WORKER_OPTIONS,
   JobWorker,
@@ -13,10 +13,7 @@ import {
 } from "../../../chunk-7B7MMDOJ.js";
 import {
   JobsDomainModule
-} from "../../../chunk-FIUC6QB5.js";
-import {
-  MemoryJobOrchestrator
-} from "../../../chunk-VQOAATIG.js";
+} from "../../../chunk-CKLM57IE.js";
 import {
   DrizzleJobRunService
 } from "../../../chunk-3VEVGL74.js";
@@ -27,12 +24,6 @@ import "../../../chunk-L3LZWWSX.js";
 import {
   DrizzleJobStepService
 } from "../../../chunk-DV4RV2DC.js";
-import {
-  MemoryJobStepService
-} from "../../../chunk-PNZSGAB2.js";
-import {
-  MemoryJobStore
-} from "../../../chunk-SNQ3TOWP.js";
 import {
   BULLMQ_CONNECTION,
   BULLMQ_RESOLVED_CONFIG,
@@ -49,6 +40,15 @@ import {
 import {
   DrizzleJobOrchestrator
 } from "../../../chunk-E6PLM6QG.js";
+import {
+  MemoryJobOrchestrator
+} from "../../../chunk-VQOAATIG.js";
+import {
+  MemoryJobStepService
+} from "../../../chunk-PNZSGAB2.js";
+import {
+  MemoryJobStore
+} from "../../../chunk-SNQ3TOWP.js";
 import {
   BootValidationError,
   JobCollisionError,

package/dist/runtime/subsystems/jobs/job-worker.module.js

@@ -2,19 +2,19 @@ import {
   JOB_WORKER_MODULE_OPTIONS,
   JobWorkerModule,
   JobWorkerOrchestrator
-} from "../../../chunk-SH76CFAY.js";
+} from "../../../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";

package/dist/runtime/subsystems/jobs/jobs-domain.module.js

@@ -1,16 +1,16 @@
 import {
   JobsDomainModule
-} from "../../../chunk-FIUC6QB5.js";
-import "../../../chunk-VQOAATIG.js";
+} from "../../../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";

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

@@ -5,20 +5,20 @@ import {
 } from "../../../chunk-EWYCWP4H.js";
 import {
   ObservabilityModule
-} from "../../../chunk-XKWOJZZ4.js";
+} from "../../../chunk-37PILMIT.js";
 import {
   BridgeMetricsReporter
 } from "../../../chunk-AQFQ4BYM.js";
-import "../../../chunk-CLWBNXKF.js";
 import {
   OBSERVABILITY,
   OBSERVABILITY_MODULE_OPTIONS
 } from "../../../chunk-Y7RRSEOC.js";
+import "../../../chunk-PLUJEQLU.js";
 import "../../../chunk-ZPL74UQN.js";
 import "../../../chunk-H5NH7KPE.js";
 import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-GYGNEQSC.js";
-import "../../../chunk-S7C6TIIF.js";
+import "../../../chunk-S5G3HO7N.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   BridgeMetricsReporter,

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

@@ -1,14 +1,14 @@
 import {
   ObservabilityModule
-} from "../../../chunk-XKWOJZZ4.js";
+} from "../../../chunk-37PILMIT.js";
 import "../../../chunk-AQFQ4BYM.js";
-import "../../../chunk-CLWBNXKF.js";
 import "../../../chunk-Y7RRSEOC.js";
+import "../../../chunk-PLUJEQLU.js";
 import "../../../chunk-ZPL74UQN.js";
 import "../../../chunk-H5NH7KPE.js";
 import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-GYGNEQSC.js";
-import "../../../chunk-S7C6TIIF.js";
+import "../../../chunk-S5G3HO7N.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   ObservabilityModule

package/dist/runtime/subsystems/observability/observability.service.js

@@ -1,11 +1,11 @@
 import {
   ObservabilityService
-} from "../../../chunk-CLWBNXKF.js";
+} from "../../../chunk-PLUJEQLU.js";
 import "../../../chunk-ZPL74UQN.js";
 import "../../../chunk-H5NH7KPE.js";
 import "../../../chunk-4LH67P4U.js";
 import "../../../chunk-GYGNEQSC.js";
-import "../../../chunk-S7C6TIIF.js";
+import "../../../chunk-S5G3HO7N.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   ObservabilityService

package/dist/src/cli/index.js

@@ -44,13 +44,13 @@ import {
   validateOrchestrationProject,
   validateProviders,
   writeManifest
-} from "../../chunk-4M66MQYA.js";
+} from "../../chunk-K4BQQ2NN.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";
@@ -63,8 +63,8 @@ import {
 } from "../../chunk-5TK7MEN4.js";
 import "../../chunk-4KNXX6TI.js";
 import "../../chunk-3CJFPU6Q.js";
-import "../../chunk-TDEHU73T.js";
-import "../../chunk-S7C6TIIF.js";
+import "../../chunk-YIVQ7KLS.js";
+import "../../chunk-S5G3HO7N.js";
 import "../../chunk-MZ6GV4YF.js";
 import "../../chunk-LG57S2SC.js";
 import "../../chunk-U64T4YZE.js";
@@ -2151,7 +2151,7 @@ function loadEvents(eventsDir, entityNames) {
 function desugarEntityEvents(entity) {
   const entityName = entity.entity.name;
   const entityEvents = entity.events ?? [];
-  return entityEvents.map((ev) => {
+  const explicit = entityEvents.map((ev) => {
     const payload = {};
     for (const [key, typeString] of Object.entries(ev.body)) {
       if (!isEventFieldType(typeString)) {
@@ -2173,6 +2173,56 @@ function desugarEntityEvents(entity) {
     };
     return def;
   });
+  const changeTriad = desugarEmitChangeEvents(entity);
+  return [...explicit, ...changeTriad];
+}
+var EMIT_CHANGE_SUFFIXES = ["created", "edited", "deleted"];
+function desugarEmitChangeEvents(entity) {
+  if (entity.integration?.sink?.emit_changes !== true) return [];
+  const entityName = entity.entity.name;
+  const basePayload = {
+    entity_id: {
+      type: "uuid",
+      nullable: false,
+      description: "Local aggregate id the sink wrote/soft-deleted."
+    },
+    external_id: {
+      type: "string",
+      nullable: false,
+      description: "Vendor external id the change keyed on."
+    },
+    provider: {
+      type: "string",
+      nullable: false,
+      description: "Provider label (e.g. 'slack', 'google')."
+    },
+    source: {
+      type: "string",
+      nullable: false,
+      description: "Provenance marker \u2014 always 'integration'. A write-back action reads this to avoid echoing the change back to the vendor."
+    }
+  };
+  return EMIT_CHANGE_SUFFIXES.map((suffix) => {
+    const payload = { ...basePayload };
+    if (suffix !== "deleted") {
+      payload.changed_fields = {
+        type: "json",
+        nullable: true,
+        description: "Differ's per-field before/after map (same value as integration_run_items.changed_fields)."
+      };
+    }
+    const def = {
+      type: `${entityName}_${suffix}`,
+      tier: "domain",
+      direction: "change",
+      aggregate: entityName,
+      payload,
+      retry: { attempts: 3, backoff: "exponential" },
+      version: 1,
+      pool: DIRECTION_TO_POOL.change
+    };
+    return def;
+  });
 }
 function isEventFieldType(s) {
   return EVENT_FIELD_TYPES.includes(s);
@@ -3696,6 +3746,97 @@ import {
 } from "fs";
 import { dirname, join as join8 } from "path";
 
+// src/cli/shared/change-emitter-emission-generator.ts
+function generatedBanner(sourceDesc) {
+  return `// @generated by @pattern-stack/codegen from ${sourceDesc} \u2014 DO NOT EDIT.
+// Hand edits are overwritten on re-emit. Regenerate with \`bun run codegen\`.`;
+}
+function changeEmitterClass(entityClass) {
+  return `${entityClass}ChangeEmitter`;
+}
+function generateChangeEmitter(input) {
+  const mode = input.mode ?? "package";
+  const cls = changeEmitterClass(input.entityClass);
+  const eventsImport = subsystemsImport(mode, "events");
+  const integrationImport = subsystemsImport(mode, "integration");
+  const createdType = `${input.entityName}_created`;
+  const editedType = `${input.entityName}_edited`;
+  const deletedType = `${input.entityName}_deleted`;
+  return `${generatedBanner(input.sourceDesc)}
+import { Inject, Injectable } from '@nestjs/common';
+import { TYPED_EVENT_BUS } from '${eventsImport}';
+import type {
+  IIntegrationChangeEmitter,
+  IntegrationChangeNotification,
+} from '${integrationImport}';
+
+/**
+ * Minimal publisher shape the emitter calls \u2014 decoupled from BOTH the package's
+ * \`TypedEventBus\` (whose \`EventTypeName\` union is the package's own events) and
+ * the consumer's generated \`TypedEventBus\` (whose union is the consumer's
+ * events). The \`${createdType}\` / \`${editedType}\` / \`${deletedType}\` events
+ * THIS class publishes live in the CONSUMER's registry; the structural \`publish\`
+ * here accepts the string types without depending on either compile-time union.
+ * The TYPED_EVENT_BUS token resolves to the consumer's generated bus at runtime
+ * (bound by EventsModule.forRoot()), which validates the payload against the
+ * generated event schema.
+ */
+interface ChangeEventPublisher {
+  publish(
+    type: string,
+    aggregateId: string,
+    payload: Record<string, unknown>,
+    opts?: { tx?: unknown; metadata?: Record<string, unknown> },
+  ): Promise<void>;
+}
+
+/**
+ * ${cls} \u2014 publishes the typed ${input.entityName} data-level change events
+ * (\`${createdType}\` / \`${editedType}\` / \`${deletedType}\`) after the
+ * integration orchestrator's sink write/soft-delete (EMIT-CHANGES seam).
+ *
+ * Bound to INTEGRATION_CHANGE_EMITTER in the ${input.entityName} integration
+ * assembly; the orchestrator calls \`emitChange\` once per real change. The
+ * payload carries \`source: 'integration'\` so a write-back action can detect an
+ * integration-originated change and decline to echo it back to the vendor.
+ */
+@Injectable()
+export class ${cls} implements IIntegrationChangeEmitter {
+  constructor(
+    @Inject(TYPED_EVENT_BUS) private readonly bus: ChangeEventPublisher,
+  ) {}
+
+  async emitChange(notification: IntegrationChangeNotification): Promise<void> {
+    const type =
+      notification.action === 'created'
+        ? '${createdType}'
+        : notification.action === 'updated'
+          ? '${editedType}'
+          : '${deletedType}';
+
+    const payload: Record<string, unknown> = {
+      entityId: notification.entityId,
+      externalId: notification.externalId,
+      provider: notification.provider,
+      source: 'integration',
+    };
+    // changedFields is present on created/edited only (deletes are tombstones).
+    if (notification.changedFields !== undefined) {
+      payload['changedFields'] = notification.changedFields;
+    }
+
+    await this.bus.publish(type, notification.entityId, payload, {
+      tx: notification.tx,
+      metadata:
+        notification.tenantId !== undefined && notification.tenantId !== null
+          ? { tenantId: notification.tenantId }
+          : undefined,
+    });
+  }
+}
+`;
+}
+
 // src/cli/shared/sink-emission-generator.ts
 var USER_ID_FIELD = "userId";
 function sinkNames(entityClass) {
@@ -3916,7 +4057,7 @@ export class ${n.sinkClass} extends ${n.sinkBaseClass} {
 
 // src/cli/shared/assembly-emission-generator.ts
 import { relative, resolve as resolve2, sep } from "path";
-function generatedBanner(sourceDesc) {
+function generatedBanner2(sourceDesc) {
   return `// @generated by @pattern-stack/codegen from ${sourceDesc} \u2014 DO NOT EDIT.
 // Hand edits are overwritten on re-emit. Regenerate with \`bun run codegen\`.`;
 }
@@ -3947,19 +4088,30 @@ function generateAssemblyModule(input) {
   const token = integrationUseCaseToken(input.entityName, input.provider);
   const moduleClass = assemblyModuleClass(input.entityName, input.provider);
   const tokensImport = `../../${input.surface}-integration.tokens`;
-  return `${generatedBanner(input.sourceDesc)}
+  const emitChanges = input.emitChanges === true;
+  const emitterClass = changeEmitterClass(input.entityClass);
+  const emitterImport = `../../sinks/${input.entityName}.change-emitter`;
+  const integrationTokenImports = emitChanges ? `  INTEGRATION_CHANGE_EMITTER,
+  INTEGRATION_CHANGE_SOURCE,
+  INTEGRATION_SINK,` : `  INTEGRATION_CHANGE_SOURCE,
+  INTEGRATION_SINK,`;
+  const emitterImportLine = emitChanges ? `
+import { ${emitterClass} } from '${emitterImport}';` : "";
+  const emitterProviderBlock = emitChanges ? `
+    ${emitterClass},
+    { provide: INTEGRATION_CHANGE_EMITTER, useExisting: ${emitterClass} },` : "";
+  return `${generatedBanner2(input.sourceDesc)}
 import { Module } from '@nestjs/common';
 import {
   ExecuteIntegrationUseCase,
-  INTEGRATION_CHANGE_SOURCE,
-  INTEGRATION_SINK,
+${integrationTokenImports}
 } from '${subsystemsImport(input.mode ?? "package", "integration")}';
 import { ${adapterClass} } from '${adapterImport}';
 import { ${adapterModuleClass} } from '${adapterModuleImport}';
 import { ${sinkClass} } from '${sinkImport}';
 import { ${input.repoClass} } from '${input.repoImportSpecifier}';
 import { ${input.moduleClass} } from '${input.moduleImportSpecifier}';
-import { ${token} } from '${tokensImport}';
+import { ${token} } from '${tokensImport}';${emitterImportLine}
 
 /**
  * ${moduleClass} \u2014 the ${input.surface}/${input.entityName} \u2190 ${input.provider}
@@ -3969,7 +4121,12 @@ import { ${token} } from '${tokensImport}';
  * \`changeSources.${input.entityName}\` and INTEGRATION_SINK from
  * ${sinkClass}, provides a local ExecuteIntegrationUseCase, and aliases+exports
  * it under ${token} (the bare class token is ambiguous at app root \u2014 every
- * assembly provides it). The substrate (cursor store, run recorder, differ,
+ * assembly provides it).${emitChanges ? `
+ *
+ * EMIT-CHANGES: binds INTEGRATION_CHANGE_EMITTER to ${emitterClass} so the
+ * orchestrator publishes typed ${input.entityName}_created/_edited/_deleted events
+ * after every sink write/soft-delete (integration.sink.emit_changes).
+ *` : ""} The substrate (cursor store, run recorder, differ,
  * multi-tenant flag) comes from the global IntegrationModule.forRoot(...) in
  * AppModule, never re-bound here.
  */
@@ -3985,7 +4142,7 @@ import { ${token} } from '${tokensImport}';
       provide: INTEGRATION_SINK,
       useFactory: (repo: ${input.repoClass}) => new ${sinkClass}(repo, '${input.provider}'),
       inject: [${input.repoClass}],
-    },
+    },${emitterProviderBlock}
     ExecuteIntegrationUseCase,
     { provide: ${token}, useExisting: ExecuteIntegrationUseCase },
   ],
@@ -4005,7 +4162,7 @@ function generateIntegrationTokens(surface, entries) {
  *  (${assemblyModuleClass(e.entityName, e.provider)}). A trigger grabs this to run it. */
 export const ${token} = Symbol.for('${key}');`;
   }).join("\n\n");
-  return `${generatedBanner(`surface: ${surface}`)}
+  return `${generatedBanner2(`surface: ${surface}`)}
 /**
  * Use-case handles for the \`${surface}\` surface \u2014 one per (entity, provider)
  * assembly. Each is a Symbol \`provide:\` token a per-entity
@@ -4031,7 +4188,7 @@ function generateIntegrationAggregator(surface, entries) {
     return `import { ${cls} } from '${path36}';`;
   }).join("\n");
   const membersInline = moduleClasses.join(", ");
-  return `${generatedBanner(`surface: ${surface}`)}
+  return `${generatedBanner2(`surface: ${surface}`)}
 import { Module } from '@nestjs/common';
 ${importLines || "// no (entity, provider) integration assemblies on this surface yet"}
 
@@ -4184,7 +4341,7 @@ function isClientlessProvider(surfaces) {
   return surfaces.length > 0 && surfaces.every((s) => SURFACE_REGISTRY[s]?.readPrimitive === true);
 }
 var SCAFFOLD_SENTINEL = "// <CODEGEN-SCAFFOLD-V1>";
-function generatedBanner2(sourceDesc) {
+function generatedBanner3(sourceDesc) {
   return `// @generated by @pattern-stack/codegen from ${sourceDesc} \u2014 DO NOT EDIT.
 // Hand edits are overwritten on re-emit. Regenerate with \`bun run codegen\`.`;
 }
@@ -4424,7 +4581,7 @@ ${changeSourcesDecl}
 }
 function generateAdapterModule(def, surface) {
   const n = names(def.slug, surface);
-  return `${generatedBanner2(`definitions/providers/${def.slug}.yaml (surface: ${surface})`)}
+  return `${generatedBanner3(`definitions/providers/${def.slug}.yaml (surface: ${surface})`)}
 import { Module } from '@nestjs/common';
 import { ${n.providerModuleClass} } from '../../../providers/${def.slug}/${def.slug}.provider.module';
 import { ${n.adapterClass} } from './${def.slug}-${surface}.adapter';
@@ -4442,13 +4599,13 @@ function generateAdaptersBarrel(surface, providerSlugs) {
     const n = names(slug, surface);
     return `export { ${n.adapterModuleClass} } from './${slug}/${slug}-${surface}.adapter.module';`;
   }).join("\n");
-  return `${generatedBanner2(`definitions/providers/*.yaml (surface: ${surface})`)}
+  return `${generatedBanner3(`definitions/providers/*.yaml (surface: ${surface})`)}
 ${lines}
 `;
 }
 function generateSurfaceTokens(surface, mode = "package") {
   const n = names("__placeholder__", surface);
-  return `${generatedBanner2(`surface: ${surface}`)}
+  return `${generatedBanner3(`surface: ${surface}`)}
 import type { IChangeSource } from '${subsystemsImport(mode, "integration")}';
 
 /** The assembled list of every ${surface} adapter's contribution. */
@@ -4487,7 +4644,7 @@ function generateSurfaceAggregator(surface, providerSlugs, mode = "package") {
     return `${lowerFirst(p.adapterClass)}: ${p.adapterClass}`;
   }).join(", ");
   const injectTokens = per.map((p) => p.adapterClass).join(", ");
-  return `${generatedBanner2(`surface: ${surface}`)}
+  return `${generatedBanner3(`surface: ${surface}`)}
 import { Module } from '@nestjs/common';
 import {
   MemoryEntityChangeSourceRegistry,
@@ -4559,7 +4716,7 @@ function generateTypedView(surface, providerSlugs, entities) {
   const providerUnion = slugs.length ? slugs.map((s) => `'${s}'`).join(" | ") : "never";
   const entityUnion = ents.length ? ents.map((e) => `'${e}'`).join(" | ") : "never";
   const mapEntries = slugs.map((s) => `  ${jsKey(s)}: ${surfacePascal}Entity;`).join("\n");
-  return `${generatedBanner2(`surface: ${surface}`)}
+  return `${generatedBanner3(`surface: ${surface}`)}
 /**
  * Per-consumer typed view for the \`${surface}\` surface. Surface-scoped unions
  * + a (provider, entity) validity map for compile-time-checked consumer
@@ -4589,6 +4746,7 @@ function emitAdapters(opts) {
     scaffoldsSkipped: [],
     skippedSurfaces: [],
     assembliesWritten: [],
+    changeEmittersWritten: [],
     tokensWritten: [],
     integrationAggregatorsWritten: [],
     skippedAssemblies: []
@@ -4702,6 +4860,19 @@ function emitAdapters(opts) {
           if (!opts.dryRun) writeFile(subclassPath, subclassContent);
           result.scaffoldsWritten.push(subclassPath);
         }
+        const emitChanges = def?.integration?.sink?.emit_changes === true;
+        if (emitChanges) {
+          const emitterPath = join8(sinksDir, `${entityName}.change-emitter.ts`);
+          const emitterContent = generateChangeEmitter({
+            entityName,
+            entityClass: loc.entityClass,
+            surface,
+            sourceDesc: `definitions entity '${entityName}' (integration.sink.emit_changes)`,
+            mode
+          });
+          if (!opts.dryRun) writeIfChanged(emitterPath, emitterContent);
+          result.changeEmittersWritten.push(emitterPath);
+        }
         for (const slug of slugs) {
           const assemblyPath = join8(
             modulesDir,
@@ -4718,7 +4889,8 @@ function emitAdapters(opts) {
             repoImportSpecifier: loc.repoImportSpecifier,
             repoClass: loc.repoClass,
             sourceDesc: `definitions/providers/${slug}.yaml`,
-            mode
+            mode,
+            emitChanges
           });
           if (!opts.dryRun) writeIfChanged(assemblyPath, assemblyContent);
           result.assembliesWritten.push(assemblyPath);
@@ -5052,12 +5224,12 @@ function resolveSyncMode(entity, config) {
 // src/emitters/frontend/emit-utils.ts
 import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
 import { dirname as dirname3 } from "path";
-function generatedBanner3(sourceDesc) {
+function generatedBanner4(sourceDesc) {
   return `// @generated by @pattern-stack/codegen from ${sourceDesc} \u2014 DO NOT EDIT.
 // Hand edits are overwritten on re-emit. Regenerate with \`bun run codegen\`.`;
 }
 function withBanner(sourceDesc, body) {
-  return `${generatedBanner3(sourceDesc)}
+  return `${generatedBanner4(sourceDesc)}
 
 ${body}`;
 }
@@ -6893,6 +7065,11 @@ var EntityNewCommand = class extends Command2 {
               `integration assembly codegen: ${adapterResult.assembliesWritten.length} module(s) + ${adapterResult.tokensWritten.length} tokens file(s) + ${adapterResult.integrationAggregatorsWritten.length} aggregator(s)`
             );
           }
+          if (adapterResult.changeEmittersWritten.length) {
+            printInfo(
+              `integration change-emitters (emit_changes): ${adapterResult.changeEmittersWritten.length} emitter(s)`
+            );
+          }
           for (const s of adapterResult.scaffoldsSkipped) {
             printInfo(`skipped scaffold ${s} (author-owned)`);
           }