@pattern-stack/codegen 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.25.0] — 2026-06-07
+
+### Fixed
+
+- **Lifecycle events: revive the audit trail + diagnosable emit failures.** The
+  `BaseService` lifecycle/change event path (`runtime/base-classes/lifecycle-events.ts`)
+  predates the AUDIT tier + routing schema (ADR-039) and was never migrated:
+  `buildLifecycleEvent` / `buildChangeEvents` stamped no `tier`, so
+  `toInsertValues` defaulted the row to `tier='domain'` with NULL `pool` /
+  `direction` — which violates the `domain_events_tier_routing_check` CHECK
+  (`tier='audit' ⇔ pool IS NULL AND direction IS NULL`). Result: **every**
+  `BaseService` create/update/delete in every consumer paid a rejected INSERT and
+  silently lost its lifecycle audit trail. The builders now stamp `tier: 'audit'`
+  (lifecycle/change events are exactly audit-tier semantics — untyped audit
+  records, never bridge-routed); the rows land and surface under the
+  observability viewer's audit-tier toggle, and the bridge guard keeps them out
+  of job routing. Discovered by the swe-brain dogfood (2× `failed to emit 3
+  event(s)` per dispatcher fire — the 3 being the `[updated, field_changed,
+  field_changed]` `publishMany` batch from `BaseService.update`).
+- **Lifecycle events: `emitSafely` logs the cause via the Nest Logger.** The
+  fire-and-forget catch was a bare `catch {}` that swallowed the error and
+  printed `failed to emit N event(s)` via raw `console.warn` — bypassing the Nest
+  `Logger` (so consumers configuring `app.useLogger` / factory `logger:` could
+  neither format nor filter it) with zero diagnosability. Now logs via a
+  module-level `Logger('LifecycleEvents')` at `warn` level including the event
+  count, the distinct event types, and the error message; the stack follows at
+  `debug`. Never-throw semantics preserved.
+
 ## [0.24.0] — 2026-06-06
 
 ### Added

package/dist/{chunk-2VHZ7EKC.js → chunk-5AAA4LTE.js}

@@ -1,6 +1,6 @@
 import {
   BaseService
-} from "./chunk-W72PRNJY.js";
+} from "./chunk-BPYZCEHS.js";
 
 // runtime/base-classes/integrated-entity-service.ts
 var IntegratedEntityService = class extends BaseService {
@@ -34,4 +34,4 @@ var IntegratedEntityService = class extends BaseService {
 export {
   IntegratedEntityService
 };
-//# sourceMappingURL=chunk-2VHZ7EKC.js.map
+//# sourceMappingURL=chunk-5AAA4LTE.js.map

package/dist/{chunk-AS3NAZB6.js → chunk-B7SC2V45.js}

@@ -1,6 +1,6 @@
 import {
   BaseService
-} from "./chunk-W72PRNJY.js";
+} from "./chunk-BPYZCEHS.js";
 
 // runtime/base-classes/knowledge-entity-service.ts
 var KnowledgeEntityService = class extends BaseService {
@@ -11,4 +11,4 @@ var KnowledgeEntityService = class extends BaseService {
 export {
   KnowledgeEntityService
 };
-//# sourceMappingURL=chunk-AS3NAZB6.js.map
+//# sourceMappingURL=chunk-B7SC2V45.js.map

package/dist/{chunk-W72PRNJY.js → chunk-BPYZCEHS.js}

@@ -4,7 +4,7 @@ import {
   diffSnapshots,
   emitSafely,
   entitySnapshot
-} from "./chunk-KYR3B3OW.js";
+} from "./chunk-DAHWN63L.js";
 
 // runtime/base-classes/base-service.ts
 var BaseService = class {
@@ -123,4 +123,4 @@ var BaseService = class {
 export {
   BaseService
 };
-//# sourceMappingURL=chunk-W72PRNJY.js.map
+//# sourceMappingURL=chunk-BPYZCEHS.js.map

package/dist/{chunk-KYR3B3OW.js → chunk-DAHWN63L.js}

@@ -1,5 +1,7 @@
 // runtime/base-classes/lifecycle-events.ts
 import { randomUUID } from "crypto";
+import { Logger } from "@nestjs/common";
+var logger = new Logger("LifecycleEvents");
 var SYSTEM_FIELDS = /* @__PURE__ */ new Set([
   "id",
   "createdAt",
@@ -36,7 +38,17 @@ function buildLifecycleEvent(entityName, action, entityId, snapshot) {
     aggregateType: entityName,
     payload: snapshot ? { snapshot } : {},
     occurredAt: /* @__PURE__ */ new Date(),
-    metadata: { category: "lifecycle" }
+    // AUDIT tier: lifecycle/change events are untyped audit-trail records —
+    // never bridge-routed, no pool/direction. The `domain_events`
+    // `domain_events_tier_routing_check` CHECK requires `tier='audit' ⇔
+    // (pool IS NULL AND direction IS NULL)`; the DEFAULT `tier='domain'`
+    // (applied by toInsertValues when absent) requires non-null routing
+    // fields, so an un-tiered lifecycle row violates the constraint and the
+    // INSERT is rejected — silently, pre-fix, by emitSafely's catch. Stamp
+    // `tier:'audit'` so these rows land (and surface under the
+    // observability viewer's audit-tier toggle). The bridge guard keeps
+    // audit-tier events out of job routing.
+    metadata: { category: "lifecycle", tier: "audit" }
   };
 }
 function buildChangeEvents(entityName, entityId, changes) {
@@ -51,7 +63,9 @@ function buildChangeEvents(entityName, entityId, changes) {
       newValue: c.newValue
     },
     occurredAt: /* @__PURE__ */ new Date(),
-    metadata: { category: "change" }
+    // AUDIT tier — see buildLifecycleEvent. Change events are audit-trail
+    // records; tier:'audit' satisfies the tier-routing CHECK constraint.
+    metadata: { category: "change", tier: "audit" }
   }));
 }
 async function emitSafely(eventBus, events) {
@@ -64,8 +78,15 @@ async function emitSafely(eventBus, events) {
     } else {
       await eventBus.publishMany(events);
     }
-  } catch {
-    console.warn(`[lifecycle-events] failed to emit ${events.length} event(s)`);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const types = [...new Set(events.map((e) => e.type))].join(", ");
+    logger.warn(
+      `failed to emit ${events.length} event(s) [${types}]: ${message}`
+    );
+    if (err instanceof Error && err.stack) {
+      logger.debug(err.stack);
+    }
   }
 }
 
@@ -76,4 +97,4 @@ export {
   buildChangeEvents,
   emitSafely
 };
-//# sourceMappingURL=chunk-KYR3B3OW.js.map
+//# sourceMappingURL=chunk-DAHWN63L.js.map

package/dist/chunk-DAHWN63L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/base-classes/lifecycle-events.ts"],"sourcesContent":["/**\n * Lifecycle event emission for BaseService.\n *\n * Ported from pattern-stack/atoms/patterns/services/base.py — the Python\n * BaseService emits LIFECYCLE and CHANGE events on every CRUD operation.\n * This module provides the same capability for the TypeScript codegen stack.\n *\n * Design:\n *   - Fire-and-forget: event emission never fails the CRUD operation.\n *   - IEventBus is optional: if no EVENT_BUS is injected, emission is silently\n *     skipped. This means base classes work in projects that haven't installed\n *     the events subsystem.\n *   - LIFECYCLE events carry an entity snapshot in payload.\n *   - CHANGE events carry per-field old/new diffs.\n *   - Controlled per-entity via `emitLifecycleEvents` flag (default: true).\n *\n * @deprecated EVT-7 — Lifecycle events are untyped and emit outside of the\n *   CRUD transaction. New work should declare an `emits:` block on the entity\n *   and publish typed domain events from use-cases via TYPED_EVENT_BUS inside\n *   the same Drizzle transaction. See `docs/specs/EVT-7.md`. This helper is\n *   retained for BaseService backward compatibility until all entities have\n *   migrated to typed emits.\n */\n\nimport { randomUUID } from 'crypto';\nimport { Logger } from '@nestjs/common';\nimport type { IEventBus, DomainEvent } from '../subsystems/events/event-bus.protocol';\n\n/**\n * Module-level logger for fire-and-forget emission failures. Routed through the\n * Nest `Logger` (not bare `console`) so consumers configuring `app.useLogger`\n * or the factory `logger:` option can format and filter it like any other\n * framework log line.\n */\nconst logger = new Logger('LifecycleEvents');\n\n// ============================================================================\n// Event categories (subset of pattern-stack's EventCategory)\n// ============================================================================\n\nexport type EventCategory = 'lifecycle' | 'change';\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/** System fields excluded from entity snapshots and change diffs. */\nconst SYSTEM_FIELDS = new Set([\n\t'id',\n\t'createdAt',\n\t'updatedAt',\n\t'deletedAt',\n]);\n\n/**\n * Snapshot an entity's field values, excluding system fields.\n * Mirrors pattern-stack's `_get_entity_snapshot()`.\n */\nexport function entitySnapshot(entity: Record<string, unknown>): Record<string, unknown> {\n\tconst snap: Record<string, unknown> = {};\n\tfor (const [key, value] of Object.entries(entity)) {\n\t\tif (!SYSTEM_FIELDS.has(key)) {\n\t\t\tsnap[key] = value;\n\t\t}\n\t}\n\treturn snap;\n}\n\n/**\n * Diff two entity snapshots, returning per-field old/new pairs.\n * Only includes fields that actually changed.\n */\nexport function diffSnapshots(\n\tbefore: Record<string, unknown>,\n\tafter: Record<string, unknown>,\n): Array<{ field: string; oldValue: unknown; newValue: unknown }> {\n\tconst changes: Array<{ field: string; oldValue: unknown; newValue: unknown }> = [];\n\tconst allKeys = new Set([...Object.keys(before), ...Object.keys(after)]);\n\n\tfor (const key of allKeys) {\n\t\tif (SYSTEM_FIELDS.has(key)) continue;\n\t\tconst oldVal = before[key];\n\t\tconst newVal = after[key];\n\t\t// Simple equality — good enough for primitives and nulls.\n\t\t// For deep objects, JSON.stringify comparison.\n\t\tif (oldVal !== newVal && JSON.stringify(oldVal) !== JSON.stringify(newVal)) {\n\t\t\tchanges.push({ field: key, oldValue: oldVal, newValue: newVal });\n\t\t}\n\t}\n\n\treturn changes;\n}\n\n// ============================================================================\n// Event builders\n// ============================================================================\n\nexport function buildLifecycleEvent(\n\tentityName: string,\n\taction: 'created' | 'updated' | 'deleted',\n\tentityId: string,\n\tsnapshot?: Record<string, unknown>,\n): DomainEvent {\n\treturn {\n\t\tid: randomUUID(),\n\t\ttype: `${entityName}.${action}`,\n\t\taggregateId: entityId,\n\t\taggregateType: entityName,\n\t\tpayload: snapshot ? { snapshot } : {},\n\t\toccurredAt: new Date(),\n\t\t// AUDIT tier: lifecycle/change events are untyped audit-trail records —\n\t\t// never bridge-routed, no pool/direction. The `domain_events`\n\t\t// `domain_events_tier_routing_check` CHECK requires `tier='audit' ⇔\n\t\t// (pool IS NULL AND direction IS NULL)`; the DEFAULT `tier='domain'`\n\t\t// (applied by toInsertValues when absent) requires non-null routing\n\t\t// fields, so an un-tiered lifecycle row violates the constraint and the\n\t\t// INSERT is rejected — silently, pre-fix, by emitSafely's catch. Stamp\n\t\t// `tier:'audit'` so these rows land (and surface under the\n\t\t// observability viewer's audit-tier toggle). The bridge guard keeps\n\t\t// audit-tier events out of job routing.\n\t\tmetadata: { category: 'lifecycle' as EventCategory, tier: 'audit' },\n\t};\n}\n\nexport function buildChangeEvents(\n\tentityName: string,\n\tentityId: string,\n\tchanges: Array<{ field: string; oldValue: unknown; newValue: unknown }>,\n): DomainEvent[] {\n\treturn changes.map((c) => ({\n\t\tid: randomUUID(),\n\t\ttype: `${entityName}.field_changed`,\n\t\taggregateId: entityId,\n\t\taggregateType: entityName,\n\t\tpayload: {\n\t\t\tfieldName: c.field,\n\t\t\toldValue: c.oldValue,\n\t\t\tnewValue: c.newValue,\n\t\t},\n\t\toccurredAt: new Date(),\n\t\t// AUDIT tier — see buildLifecycleEvent. Change events are audit-trail\n\t\t// records; tier:'audit' satisfies the tier-routing CHECK constraint.\n\t\tmetadata: { category: 'change' as EventCategory, tier: 'audit' },\n\t}));\n}\n\n// ============================================================================\n// Emission helper (fire-and-forget)\n// ============================================================================\n\n/**\n * Emit events to the bus, swallowing errors.\n * Mirrors pattern-stack's `_emit_lifecycle_event()` try/except.\n */\nexport async function emitSafely(\n\teventBus: IEventBus | undefined,\n\tevents: DomainEvent[],\n): Promise<void> {\n\tif (!eventBus || events.length === 0) return;\n\ttry {\n\t\tif (events.length === 1) {\n\t\t\tconst only = events[0];\n\t\t\tif (!only) return;\n\t\t\tawait eventBus.publish(only);\n\t\t} else {\n\t\t\tawait eventBus.publishMany(events);\n\t\t}\n\t} catch (err) {\n\t\t// Never fail the CRUD operation — but surface the cause. The bare\n\t\t// `catch` that used to live here swallowed the error entirely, so a\n\t\t// failing bus printed `failed to emit N event(s)` with zero\n\t\t// diagnosability. Route through the Nest Logger (not bare console) at\n\t\t// warn level, including the distinct event types and the error message;\n\t\t// the stack follows at debug so it's available without noising the\n\t\t// default-threshold output.\n\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\tconst types = [...new Set(events.map((e) => e.type))].join(', ');\n\t\tlogger.warn(\n\t\t\t`failed to emit ${events.length} event(s) [${types}]: ${message}`,\n\t\t);\n\t\tif (err instanceof Error && err.stack) {\n\t\t\tlogger.debug(err.stack);\n\t\t}\n\t}\n}\n"],"mappings":";AAwBA,SAAS,kBAAkB;AAC3B,SAAS,cAAc;AASvB,IAAM,SAAS,IAAI,OAAO,iBAAiB;AAa3C,IAAM,gBAAgB,oBAAI,IAAI;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACD,CAAC;AAMM,SAAS,eAAe,QAA0D;AACxF,QAAM,OAAgC,CAAC;AACvC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AAClD,QAAI,CAAC,cAAc,IAAI,GAAG,GAAG;AAC5B,WAAK,GAAG,IAAI;AAAA,IACb;AAAA,EACD;AACA,SAAO;AACR;AAMO,SAAS,cACf,QACA,OACiE;AACjE,QAAM,UAA0E,CAAC;AACjF,QAAM,UAAU,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,CAAC,CAAC;AAEvE,aAAW,OAAO,SAAS;AAC1B,QAAI,cAAc,IAAI,GAAG,EAAG;AAC5B,UAAM,SAAS,OAAO,GAAG;AACzB,UAAM,SAAS,MAAM,GAAG;AAGxB,QAAI,WAAW,UAAU,KAAK,UAAU,MAAM,MAAM,KAAK,UAAU,MAAM,GAAG;AAC3E,cAAQ,KAAK,EAAE,OAAO,KAAK,UAAU,QAAQ,UAAU,OAAO,CAAC;AAAA,IAChE;AAAA,EACD;AAEA,SAAO;AACR;AAMO,SAAS,oBACf,YACA,QACA,UACA,UACc;AACd,SAAO;AAAA,IACN,IAAI,WAAW;AAAA,IACf,MAAM,GAAG,UAAU,IAAI,MAAM;AAAA,IAC7B,aAAa;AAAA,IACb,eAAe;AAAA,IACf,SAAS,WAAW,EAAE,SAAS,IAAI,CAAC;AAAA,IACpC,YAAY,oBAAI,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAWrB,UAAU,EAAE,UAAU,aAA8B,MAAM,QAAQ;AAAA,EACnE;AACD;AAEO,SAAS,kBACf,YACA,UACA,SACgB;AAChB,SAAO,QAAQ,IAAI,CAAC,OAAO;AAAA,IAC1B,IAAI,WAAW;AAAA,IACf,MAAM,GAAG,UAAU;AAAA,IACnB,aAAa;AAAA,IACb,eAAe;AAAA,IACf,SAAS;AAAA,MACR,WAAW,EAAE;AAAA,MACb,UAAU,EAAE;AAAA,MACZ,UAAU,EAAE;AAAA,IACb;AAAA,IACA,YAAY,oBAAI,KAAK;AAAA;AAAA;AAAA,IAGrB,UAAU,EAAE,UAAU,UAA2B,MAAM,QAAQ;AAAA,EAChE,EAAE;AACH;AAUA,eAAsB,WACrB,UACA,QACgB;AAChB,MAAI,CAAC,YAAY,OAAO,WAAW,EAAG;AACtC,MAAI;AACH,QAAI,OAAO,WAAW,GAAG;AACxB,YAAM,OAAO,OAAO,CAAC;AACrB,UAAI,CAAC,KAAM;AACX,YAAM,SAAS,QAAQ,IAAI;AAAA,IAC5B,OAAO;AACN,YAAM,SAAS,YAAY,MAAM;AAAA,IAClC;AAAA,EACD,SAAS,KAAK;AAQb,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,UAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI;AAC/D,WAAO;AAAA,MACN,kBAAkB,OAAO,MAAM,cAAc,KAAK,MAAM,OAAO;AAAA,IAChE;AACA,QAAI,eAAe,SAAS,IAAI,OAAO;AACtC,aAAO,MAAM,IAAI,KAAK;AAAA,IACvB;AAAA,EACD;AACD;","names":[]}

package/dist/{chunk-RFH7N6EP.js → chunk-FCPTHS42.js}

@@ -1,6 +1,6 @@
 import {
   BaseService
-} from "./chunk-W72PRNJY.js";
+} from "./chunk-BPYZCEHS.js";
 
 // runtime/base-classes/metadata-entity-service.ts
 var MetadataEntityService = class extends BaseService {
@@ -33,4 +33,4 @@ var MetadataEntityService = class extends BaseService {
 export {
   MetadataEntityService
 };
-//# sourceMappingURL=chunk-RFH7N6EP.js.map
+//# sourceMappingURL=chunk-FCPTHS42.js.map

package/dist/{chunk-JYBFPNBJ.js → chunk-SJGEBMJT.js}

@@ -1,6 +1,6 @@
 import {
   BaseService
-} from "./chunk-W72PRNJY.js";
+} from "./chunk-BPYZCEHS.js";
 
 // runtime/base-classes/activity-entity-service.ts
 var ActivityEntityService = class extends BaseService {
@@ -33,4 +33,4 @@ var ActivityEntityService = class extends BaseService {
 export {
   ActivityEntityService
 };
-//# sourceMappingURL=chunk-JYBFPNBJ.js.map
+//# sourceMappingURL=chunk-SJGEBMJT.js.map

package/dist/runtime/base-classes/activity-entity-service.js

@@ -1,8 +1,8 @@
 import {
   ActivityEntityService
-} from "../../chunk-JYBFPNBJ.js";
-import "../../chunk-W72PRNJY.js";
-import "../../chunk-KYR3B3OW.js";
+} from "../../chunk-SJGEBMJT.js";
+import "../../chunk-BPYZCEHS.js";
+import "../../chunk-DAHWN63L.js";
 import "../../chunk-2E224ZSN.js";
 export {
   ActivityEntityService

package/dist/runtime/base-classes/base-service.js

@@ -1,7 +1,7 @@
 import {
   BaseService
-} from "../../chunk-W72PRNJY.js";
-import "../../chunk-KYR3B3OW.js";
+} from "../../chunk-BPYZCEHS.js";
+import "../../chunk-DAHWN63L.js";
 import "../../chunk-2E224ZSN.js";
 export {
   BaseService

package/dist/runtime/base-classes/index.js

@@ -1,3 +1,15 @@
+import {
+  MetadataEntityService
+} from "../../chunk-FCPTHS42.js";
+import {
+  WithAnalytics
+} from "../../chunk-IBGER4YK.js";
+import {
+  IntegratedEntityRepository
+} from "../../chunk-OTDN3OUQ.js";
+import {
+  IntegratedEntityService
+} from "../../chunk-5AAA4LTE.js";
 import {
   JunctionIntegrationRepository,
   buildCompositeExternalId,
@@ -8,42 +20,20 @@ import {
 } from "../../chunk-NN7XZEGF.js";
 import {
   KnowledgeEntityService
-} from "../../chunk-AS3NAZB6.js";
+} from "../../chunk-B7SC2V45.js";
 import {
   MetadataEntityRepository
 } from "../../chunk-7KOW6PU6.js";
 import {
-  MetadataEntityService
-} from "../../chunk-RFH7N6EP.js";
-import {
-  WithAnalytics
-} from "../../chunk-IBGER4YK.js";
+  ActivityEntityRepository
+} from "../../chunk-MKWQKKK7.js";
 import {
   ActivityEntityService
-} from "../../chunk-JYBFPNBJ.js";
+} from "../../chunk-SJGEBMJT.js";
 import {
   BaseFindByIdUseCase,
   BaseListUseCase
 } from "../../chunk-EXVDJMIY.js";
-import {
-  IntegratedEntityRepository
-} from "../../chunk-OTDN3OUQ.js";
-import {
-  IntegratedEntityService
-} from "../../chunk-2VHZ7EKC.js";
-import {
-  BaseService
-} from "../../chunk-W72PRNJY.js";
-import {
-  buildChangeEvents,
-  buildLifecycleEvent,
-  diffSnapshots,
-  emitSafely,
-  entitySnapshot
-} from "../../chunk-KYR3B3OW.js";
-import {
-  ActivityEntityRepository
-} from "../../chunk-MKWQKKK7.js";
 import {
   BaseRepository
 } from "../../chunk-J6KZS54B.js";
@@ -56,6 +46,16 @@ import {
   withSuperuserScope,
   withUserScope
 } from "../../chunk-ZUKFQL6E.js";
+import {
+  BaseService
+} from "../../chunk-BPYZCEHS.js";
+import {
+  buildChangeEvents,
+  buildLifecycleEvent,
+  diffSnapshots,
+  emitSafely,
+  entitySnapshot
+} from "../../chunk-DAHWN63L.js";
 import "../../chunk-2E224ZSN.js";
 export {
   ActivityEntityRepository,

package/dist/runtime/base-classes/integrated-entity-service.js

@@ -1,8 +1,8 @@
 import {
   IntegratedEntityService
-} from "../../chunk-2VHZ7EKC.js";
-import "../../chunk-W72PRNJY.js";
-import "../../chunk-KYR3B3OW.js";
+} from "../../chunk-5AAA4LTE.js";
+import "../../chunk-BPYZCEHS.js";
+import "../../chunk-DAHWN63L.js";
 import "../../chunk-2E224ZSN.js";
 export {
   IntegratedEntityService

package/dist/runtime/base-classes/knowledge-entity-service.js

@@ -1,8 +1,8 @@
 import {
   KnowledgeEntityService
-} from "../../chunk-AS3NAZB6.js";
-import "../../chunk-W72PRNJY.js";
-import "../../chunk-KYR3B3OW.js";
+} from "../../chunk-B7SC2V45.js";
+import "../../chunk-BPYZCEHS.js";
+import "../../chunk-DAHWN63L.js";
 import "../../chunk-2E224ZSN.js";
 export {
   KnowledgeEntityService

package/dist/runtime/base-classes/lifecycle-events.js

@@ -4,7 +4,7 @@ import {
   diffSnapshots,
   emitSafely,
   entitySnapshot
-} from "../../chunk-KYR3B3OW.js";
+} from "../../chunk-DAHWN63L.js";
 import "../../chunk-2E224ZSN.js";
 export {
   buildChangeEvents,

package/dist/runtime/base-classes/metadata-entity-service.js

@@ -1,8 +1,8 @@
 import {
   MetadataEntityService
-} from "../../chunk-RFH7N6EP.js";
-import "../../chunk-W72PRNJY.js";
-import "../../chunk-KYR3B3OW.js";
+} from "../../chunk-FCPTHS42.js";
+import "../../chunk-BPYZCEHS.js";
+import "../../chunk-DAHWN63L.js";
 import "../../chunk-2E224ZSN.js";
 export {
   MetadataEntityService

package/dist/runtime/subsystems/index.js

@@ -1,4 +1,3 @@
-import "../../chunk-W4HOHZVF.js";
 import "../../chunk-ZUMULSEQ.js";
 import {
   StorageModule
@@ -27,6 +26,7 @@ import {
   OBSERVABILITY_MODULE_OPTIONS
 } from "../../chunk-Y7RRSEOC.js";
 import "../../chunk-PLUJEQLU.js";
+import "../../chunk-W4HOHZVF.js";
 import "../../chunk-SYVZ4MD2.js";
 import {
   EventsModule

package/dist/src/cli/index.js

@@ -7408,7 +7408,7 @@ function resolveJobsScaffoldLocals(input) {
   const { cwd, config, fileExists, readFile } = input;
   const jobsBlock = config?.jobs ?? {};
   const subsystemsRoot = resolveSubsystemsRootFromConfig(cwd, config);
-  const workerPath = path16.resolve(cwd, "worker.ts");
+  const workerPath = path16.resolve(cwd, "src", "worker.ts");
   const mainTsPath = path16.resolve(cwd, "src/main.ts");
   const configPath = path16.resolve(cwd, "codegen.config.yaml");
   const schemaPath = path16.resolve(
@@ -7426,10 +7426,37 @@ function resolveJobsScaffoldLocals(input) {
     configPath,
     workerExists: fileExists(workerPath),
     workerPath,
+    jobWorkerModuleImport: resolveJobWorkerModuleImport(config),
+    workerForRootOpts: resolveWorkerForRootOpts(jobsBlock),
     schemaPath,
-    mainHookInjected
+    mainHookInjected,
+    // #517 — in package mode the schema ships in the package (consumed via the
+    // schema barrel), so the template is skipped; vendored mode renders it.
+    skipSchema: resolveRuntimeMode(config) === "package"
   };
 }
+function resolveJobWorkerModuleImport(config) {
+  return runtimeImport(resolveRuntimeMode(config), "subsystems/jobs/index");
+}
+function resolveWorkerForRootOpts(jobsBlock) {
+  const backend = jobsBlock.backend ?? "drizzle";
+  const parts = [`mode: 'standalone'`];
+  if (backend === "bullmq") {
+    parts.push(`backend: 'bullmq'`);
+    const bullExt = jobsBlock.extensions?.bullmq;
+    if (bullExt) {
+      parts.push(`domainModuleExtensions: { bullmq: ${jsonToTs(bullExt)} }`);
+    }
+  } else {
+    const workerExtClause = drizzleExtensionsClause(
+      drizzleJobsExtensions(backend, jobsBlock),
+      "domainModuleExtensions"
+    );
+    if (workerExtClause) parts.push(workerExtClause);
+  }
+  parts.push(`allPools: true`);
+  return `{ ${parts.join(", ")} }`;
+}
 function normaliseWorkerMode(raw) {
   if (raw === "standalone") return "standalone";
   return "embedded";
@@ -7437,6 +7464,9 @@ function normaliseWorkerMode(raw) {
 function normaliseMultiTenant2(raw) {
   return raw === true;
 }
+function encodeWorkerForRootOpts(opts) {
+  return Buffer.from(opts, "utf-8").toString("base64");
+}
 function localsToHygenArgs2(locals) {
   return [
     "--appName",
@@ -7453,10 +7483,19 @@ function localsToHygenArgs2(locals) {
     workerSkipValue(locals.workerExists),
     "--workerPath",
     locals.workerPath,
+    "--jobWorkerModuleImport",
+    locals.jobWorkerModuleImport,
+    "--workerForRootOpts",
+    encodeWorkerForRootOpts(locals.workerForRootOpts),
     "--schemaPath",
     locals.schemaPath,
     "--mainHookInjected",
-    workerSkipValue(locals.mainHookInjected)
+    workerSkipValue(locals.mainHookInjected),
+    // #517 — boolean-ish for `skip_if` (same '' / 'true' encoding as
+    // workerExists / mainHookInjected). 'true' in package mode → the schema
+    // template is skipped (the package ships the schema).
+    "--skipSchema",
+    workerSkipValue(locals.skipSchema)
   ];
 }
 
@@ -8314,6 +8353,12 @@ var SubsystemInstallCommand = class extends Command3 {
       return 1;
     }
     if (this.dryRun) {
+      const jobsScaffoldDryRun = desc.name === "jobs" ? runJobsScaffold(ctx.cwd, ctx.config, {
+        dryRun: true,
+        json: isJsonMode(),
+        forceConfig: this.forceConfig,
+        skipConfigBlock: true
+      }) : null;
       if (isJsonMode()) {
         printJson({
           command: "subsystem install",
@@ -8321,7 +8366,8 @@ var SubsystemInstallCommand = class extends Command3 {
           runtime: "package",
           dryRun: true,
           installList: already ? installed : [...installed, desc.name],
-          configBlockOutcome
+          configBlockOutcome,
+          ...jobsScaffoldDryRun ? { scaffold: jobsScaffoldDryRun } : {}
         });
       } else {
         printInfo(`Dry run \u2014 runtime: package (no files vendored).`);
@@ -8330,6 +8376,14 @@ var SubsystemInstallCommand = class extends Command3 {
           printInfo(`  ${desc.name} config block would be ${configBlockOutcome}`);
         }
         printInfo("  would regenerate <generated>/subsystems.ts + subsystems-schema.ts");
+        if (jobsScaffoldDryRun?.planned?.length) {
+          printInfo(
+            `  jobs scaffold \u2014 ${jobsScaffoldDryRun.planned.length} template targets (worker + main.ts hook; schema ships in the package)`
+          );
+          for (const p of jobsScaffoldDryRun.planned) {
+            console.log(`  ${theme.muted(icons.arrow)} ${path24.relative(ctx.cwd, p) || p}`);
+          }
+        }
       }
       return 0;
     }
@@ -8374,6 +8428,12 @@ var SubsystemInstallCommand = class extends Command3 {
       const msg = err instanceof Error ? err.message : String(err);
       printWarning(`barrel regeneration failed \u2014 ${msg}`);
     }
+    const jobsScaffold = desc.name === "jobs" ? runJobsScaffold(ctx.cwd, refreshed.config, {
+      dryRun: false,
+      json: isJsonMode(),
+      forceConfig: this.forceConfig,
+      skipConfigBlock: true
+    }) : null;
     if (isJsonMode()) {
       printJson({
         command: "subsystem install",
@@ -8385,7 +8445,8 @@ var SubsystemInstallCommand = class extends Command3 {
         installOutcome: installResult.outcome,
         configBlockOutcome,
         barrelEmitted,
-        schemaEmitted
+        schemaEmitted,
+        ...jobsScaffold ? { scaffold: jobsScaffold } : {}
       });
       return 0;
     }
@@ -8393,6 +8454,17 @@ var SubsystemInstallCommand = class extends Command3 {
     if (installResult.outcome === "added") {
       printInfo(`Added '${desc.name}' to subsystems.install.`);
     }
+    if (jobsScaffold) {
+      if (jobsScaffold.ok) {
+        printSuccess(
+          `jobs scaffold applied (emitted src/worker.ts + src/main.ts hook; schema ships in the package).`
+        );
+      } else {
+        printWarning(
+          `jobs scaffold (Hygen) failed \u2014 config + barrels were written; re-run after fixing: ${jobsScaffold.error ?? "unknown error"}`
+        );
+      }
+    }
     printInfo(
       `Regenerated <generated>/subsystems.ts (${barrelEmitted.join(", ") || "none"}) + subsystems-schema.ts (${schemaEmitted.join(", ") || "none"}).`
     );
@@ -8622,14 +8694,10 @@ function runJobsScaffold(cwd, config, opts) {
   const planned = [
     ...!locals.workerExists ? [locals.workerPath] : [],
     locals.mainTsPath,
-    locals.configPath,
-    locals.schemaPath
+    ...opts.skipConfigBlock ? [] : [locals.configPath],
+    ...locals.skipSchema ? [] : [locals.schemaPath]
   ];
-  const configBlockOutcome = planConfigBlockAction(
-    locals.configPath,
-    "jobs",
-    opts.forceConfig
-  );
+  const configBlockOutcome = opts.skipConfigBlock ? void 0 : planConfigBlockAction(locals.configPath, "jobs", opts.forceConfig);
   if (configBlockOutcome === "parse-error") {
     return { ok: false, planned, configBlockOutcome };
   }
@@ -8652,21 +8720,23 @@ function runJobsScaffold(cwd, config, opts) {
       configBlockOutcome
     };
   }
-  const configResult = runConfigBlockAction({
-    cwd,
-    actionFolder: "jobs-config",
-    configPath: locals.configPath,
-    subsystem: "jobs",
-    outcome: configBlockOutcome,
-    json: opts.json
-  });
-  if (!configResult.ok) {
-    return {
-      ok: false,
-      planned,
-      error: configResult.error,
-      configBlockOutcome
-    };
+  if (!opts.skipConfigBlock && configBlockOutcome) {
+    const configResult = runConfigBlockAction({
+      cwd,
+      actionFolder: "jobs-config",
+      configPath: locals.configPath,
+      subsystem: "jobs",
+      outcome: configBlockOutcome,
+      json: opts.json
+    });
+    if (!configResult.ok) {
+      return {
+        ok: false,
+        planned,
+        error: configResult.error,
+        configBlockOutcome
+      };
+    }
   }
   return { ok: true, planned, configBlockOutcome };
 }