@pattern-stack/codegen 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -2,7 +2,29 @@
 
 All notable changes to this project will be documented in this file.
 
-## [Unreleased]
+## [0.24.0] — 2026-06-06
+
+### Added
+
+- **Integration: opt-in post-upsert change-event emission seam.** An entity that
+  declares `integration.sink.emit_changes: true` now gets typed per-entity domain
+  events published automatically when integration sync upserts/soft-deletes rows.
+  Codegen (a) desugars the entity into `<entity>_created` / `<entity>_edited` /
+  `<entity>_deleted` events (merged into the generated events registry exactly
+  like a hand-authored `events/*.yaml` — TypedEventBus augmentation, the
+  `EventTypeName` union, payload schemas), and (b) emits a fully-`@generated`
+  `<entity>.change-emitter.ts` that the per-entity assembly module binds to the
+  new optional `INTEGRATION_CHANGE_EMITTER` token. `ExecuteIntegrationUseCase`
+  injects the emitter `@Optional()` and publishes after every real sink
+  write/soft-delete (never on a `noop` diff or a delete that hit no row). Payload:
+  `{ entityId, externalId, provider, changedFields?, source: 'integration' }` —
+  the `source` provenance marker lets a write-back action detect
+  integration-originated changes and break the inbound→writeback loop. The verb
+  is `_edited`, NOT `_updated` (swe-brain ADR-0009 B1). Entities that don't opt in
+  are byte-for-byte unchanged (the emitter token stays unbound). Generalizes the
+  emission swe-brain hand-built in its sinks. See `docs/specs/EMIT-CHANGES-1.md`.
+
+## [0.23.0] — 2026-06-06
 
 ### Fixed
 

package/consumer-skills/integration/SKILL.md

@@ -114,9 +114,17 @@ export class AppModule {}
    those records. This is the most common "wait, what?" moment; document it in
    your runbooks. Retry semantics are caller-owned.
 
-7. **The orchestrator does not emit events, schedule itself, retry, or resolve
-   subscriptions.** Those are all consumer concerns. Wire event emission inside
-   your sink's transaction; wire scheduling via a job or webhook handler.
+7. **Event emission is an opt-in seam; scheduling/retry/subscription-resolution
+   stay consumer concerns.** Declare `integration.sink.emit_changes: true` on an
+   entity and codegen generates `<entity>_created` / `<entity>_edited` /
+   `<entity>_deleted` typed events plus a `<entity>.change-emitter.ts` the
+   assembly binds to `INTEGRATION_CHANGE_EMITTER`; the orchestrator then publishes
+   after every real sink write/soft-delete (payload carries
+   `source: 'integration'` for loop-breaking). Omit the flag (the default) and the
+   orchestrator emits nothing — hand-roll emission in your sink if you need a
+   bespoke payload, or override the generated event via a top-level
+   `events/<entity>_created.yaml`. Scheduling is still a job/webhook concern;
+   retry semantics are still caller-owned. See `docs/specs/EMIT-CHANGES-1.md`.
 
 ## Do not
 

package/dist/{chunk-XKWOJZZ4.js → chunk-37PILMIT.js}

@@ -1,13 +1,13 @@
 import {
   BridgeMetricsReporter
 } from "./chunk-AQFQ4BYM.js";
-import {
-  ObservabilityService
-} from "./chunk-CLWBNXKF.js";
 import {
   OBSERVABILITY,
   OBSERVABILITY_MODULE_OPTIONS
 } from "./chunk-Y7RRSEOC.js";
+import {
+  ObservabilityService
+} from "./chunk-PLUJEQLU.js";
 import {
   __decorateClass
 } from "./chunk-2E224ZSN.js";
@@ -45,4 +45,4 @@ ObservabilityModule = __decorateClass([
 export {
   ObservabilityModule
 };
-//# sourceMappingURL=chunk-XKWOJZZ4.js.map
+//# sourceMappingURL=chunk-37PILMIT.js.map

package/dist/{chunk-42763UEE.js → chunk-6M6LZEP6.js}

@@ -1,6 +1,6 @@
 import {
   TypedEventBus
-} from "./chunk-INO47JXD.js";
+} from "./chunk-PBENHIN2.js";
 import {
   EventScheduler,
   scheduledEventsFromRegistry
@@ -200,4 +200,4 @@ export {
   EventSchedulerLifecycle,
   EventsModule
 };
-//# sourceMappingURL=chunk-42763UEE.js.map
+//# sourceMappingURL=chunk-6M6LZEP6.js.map

package/dist/{chunk-FIUC6QB5.js → chunk-CKLM57IE.js}

@@ -1,6 +1,3 @@
-import {
-  MemoryJobOrchestrator
-} from "./chunk-VQOAATIG.js";
 import {
   DrizzleJobRunService
 } from "./chunk-3VEVGL74.js";
@@ -10,12 +7,6 @@ import {
 import {
   DrizzleJobStepService
 } from "./chunk-DV4RV2DC.js";
-import {
-  MemoryJobStepService
-} from "./chunk-PNZSGAB2.js";
-import {
-  MemoryJobStore
-} from "./chunk-SNQ3TOWP.js";
 import {
   BULLMQ_CONNECTION,
   BULLMQ_RESOLVED_CONFIG,
@@ -24,6 +15,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 {
   JOBS_LISTEN_NOTIFY,
   JOBS_MULTI_TENANT,
@@ -114,4 +114,4 @@ JobsDomainModule = __decorateClass([
 export {
   JobsDomainModule
 };
-//# sourceMappingURL=chunk-FIUC6QB5.js.map
+//# sourceMappingURL=chunk-CKLM57IE.js.map

package/dist/{chunk-SH76CFAY.js → chunk-ENAR3F5S.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-7B7MMDOJ.js";
 import {
   JobsDomainModule
-} from "./chunk-FIUC6QB5.js";
+} from "./chunk-CKLM57IE.js";
 import {
   BULLMQ_CONNECTION,
   BULLMQ_RESOLVED_CONFIG,
@@ -295,4 +295,4 @@ export {
   JobWorkerOrchestrator,
   JobWorkerModule
 };
-//# sourceMappingURL=chunk-SH76CFAY.js.map
+//# sourceMappingURL=chunk-ENAR3F5S.js.map

package/dist/{chunk-FFUDEIFF.js → chunk-HN5HT5WL.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-SQDOBLBP.js";
 import {
   INTEGRATION_MULTI_TENANT
-} from "./chunk-S7C6TIIF.js";
+} from "./chunk-S5G3HO7N.js";
 import {
   assertTenantId
 } from "./chunk-MZ6GV4YF.js";
@@ -127,4 +127,4 @@ DrizzleIntegrationRunRecorder = __decorateClass([
 export {
   DrizzleIntegrationRunRecorder
 };
-//# sourceMappingURL=chunk-FFUDEIFF.js.map
+//# sourceMappingURL=chunk-HN5HT5WL.js.map

package/dist/{chunk-4M66MQYA.js → chunk-K4BQQ2NN.js}

@@ -399,7 +399,9 @@ var ProviderIntegrationSchema = z.object({
 var SinkPolicySchema = z.object({
   delete: z.enum(["soft", "tombstone", "noop"]).optional(),
   // NO .default() — see default fence in spec §Goal
-  exclude_fields: z.array(z.string()).optional()
+  exclude_fields: z.array(z.string()).optional(),
+  emit_changes: z.boolean().optional()
+  // NO .default() — absent ⇒ no emission
 }).strict();
 var IntegrationConfigSchema = z.object({
   electric: z.boolean().optional().default(false),
@@ -4347,4 +4349,4 @@ export {
   analyzeDomain,
   validateEntities
 };
-//# sourceMappingURL=chunk-4M66MQYA.js.map
+//# sourceMappingURL=chunk-K4BQQ2NN.js.map