@pattern-stack/codegen 0.22.0 → 0.23.0

package/dist/src/index.d.ts

@@ -283,7 +283,7 @@ interface CodegenManifest {
     };
 }
 
-declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
     entity: z.ZodEffects<z.ZodObject<{
         name: z.ZodString;
         plural: z.ZodString;
@@ -1528,6 +1528,16 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }>>>;
+        sink: z.ZodOptional<z.ZodObject<{
+            delete: z.ZodOptional<z.ZodEnum<["soft", "tombstone", "noop"]>>;
+            exclude_fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        }, {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         electric: boolean;
         providers?: Record<string, {
@@ -1537,6 +1547,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
     }, {
         electric?: boolean | undefined;
         providers?: Record<string, {
@@ -1546,6 +1560,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
     }>>;
     detection: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
         mode: z.ZodLiteral<"poll">;
@@ -2187,6 +2205,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
     } | undefined;
     detection?: Record<string, {
         poll: {
@@ -2400,6 +2422,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
     } | undefined;
     detection?: Record<string, {
         poll: {
@@ -2613,6 +2639,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
     } | undefined;
     detection?: Record<string, {
         poll: {
@@ -2826,6 +2856,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
     } | undefined;
     detection?: Record<string, {
         poll: {
@@ -3039,6 +3073,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
     } | undefined;
     detection?: Record<string, {
         poll: {
@@ -3252,6 +3290,444 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             field_mapping?: Record<string, string> | undefined;
             read_only_fields?: string[] | undefined;
         }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    detection?: Record<string, {
+        poll: {
+            cursor: {
+                field: string;
+                kind: "systemModstamp";
+            } | {
+                field: string;
+                kind: "replayId";
+            } | {
+                field: string;
+                kind: "timestamp";
+            } | {
+                field: string;
+                kind: "eventId";
+            } | {
+                field: string;
+                kind: "historyId";
+            } | {
+                field: string;
+                kind: "syncToken";
+            };
+            provenance?: "poll" | "cdc" | undefined;
+        };
+        mode: "poll";
+        mapping: {
+            source: string;
+            target: string;
+            transform?: string | undefined;
+        }[];
+        filters?: {
+            field: string;
+            op: "eq" | "neq" | "in" | "nin" | "gt" | "gte" | "lt" | "lte";
+            value?: unknown;
+        }[] | undefined;
+    } | {
+        webhook: {
+            eventIdField?: string | undefined;
+        };
+        mode: "webhook";
+        mapping: {
+            source: string;
+            target: string;
+            transform?: string | undefined;
+        }[];
+        filters?: {
+            field: string;
+            op: "eq" | "neq" | "in" | "nin" | "gt" | "gte" | "lt" | "lte";
+            value?: unknown;
+        }[] | undefined;
+    }> | undefined;
+    events?: {
+        name: string;
+        queue: string;
+        body: Record<string, string>;
+        generate_handler?: boolean | undefined;
+    }[] | undefined;
+    emits?: string[] | undefined;
+    analytics?: {
+        metrics?: Record<string, {
+            type: "simple";
+            measure: string;
+            filter?: string | undefined;
+            description?: string | undefined;
+            agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+            label?: string | undefined;
+        } | {
+            type: "derived";
+            expr: string;
+            metrics: string[];
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "ratio";
+            numerator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                description?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                label?: string | undefined;
+            };
+            denominator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                description?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                label?: string | undefined;
+            };
+            filter?: string | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "cumulative";
+            measure: string;
+            description?: string | undefined;
+            label?: string | undefined;
+            window?: string | undefined;
+            grain_to_date?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        }> | undefined;
+        measure_packs?: string[] | undefined;
+        cube_name?: string | undefined;
+    } | undefined;
+    unique_indexes?: {
+        fields: string[];
+        name?: string | undefined;
+    }[] | undefined;
+}>, {
+    fields: Record<string, {
+        type: "string" | "boolean" | "integer" | "date" | "json" | "decimal" | "uuid" | "datetime" | "entity_ref" | "string_array" | "enum";
+        required: boolean;
+        nullable: boolean;
+        default?: unknown;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "json" | "datetime" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>;
+    entity: {
+        name: string;
+        table: string;
+        plural: string;
+        expose: ("repository" | "rest" | "trpc" | "electric")[];
+        config?: Record<string, unknown> | undefined;
+        folder_structure?: "flat" | "nested" | undefined;
+        file_grouping?: "separate" | "grouped" | undefined;
+        behavior_strategy?: "base_class" | "inline" | undefined;
+        pattern?: string | undefined;
+        patterns?: string[] | undefined;
+        scopeable?: boolean | undefined;
+        surface?: string | undefined;
+        context?: string | undefined;
+        sync?: "electric" | "api" | undefined;
+    };
+    behaviors: (string | {
+        name: string;
+        options?: Record<string, unknown> | undefined;
+    })[];
+    eav: boolean;
+    eav_value_table: boolean;
+    relationships?: Record<string, {
+        type: "belongs_to" | "has_many" | "has_one";
+        target: string;
+        foreign_key: string;
+        on_delete: "cascade" | "restrict" | "set_null" | "no_action";
+        nullable?: boolean | undefined;
+        through?: string | undefined;
+        inverse?: string | undefined;
+    }> | undefined;
+    generate?: {
+        writes: boolean;
+    } | undefined;
+    eav_definition_table?: string | undefined;
+    queries?: ({
+        by: string[];
+        select?: string[] | undefined;
+        limit?: boolean | undefined;
+        unique?: boolean | undefined;
+        order?: string | undefined;
+        via?: string | undefined;
+    } | {
+        filters: string[];
+        name: "search";
+        paginate: boolean;
+        search?: string | undefined;
+        order?: string | undefined;
+    })[] | undefined;
+    integration?: {
+        electric: boolean;
+        providers?: Record<string, {
+            cdc: boolean;
+            direction: "inbound" | "outbound" | "bidirectional";
+            remote_entity: string;
+            field_mapping?: Record<string, string> | undefined;
+            read_only_fields?: string[] | undefined;
+        }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+    detection?: Record<string, {
+        poll: {
+            cursor: {
+                field: string;
+                kind: "systemModstamp";
+            } | {
+                field: string;
+                kind: "replayId";
+            } | {
+                field: string;
+                kind: "timestamp";
+            } | {
+                field: string;
+                kind: "eventId";
+            } | {
+                field: string;
+                kind: "historyId";
+            } | {
+                field: string;
+                kind: "syncToken";
+            };
+            provenance?: "poll" | "cdc" | undefined;
+        };
+        mode: "poll";
+        mapping: {
+            source: string;
+            target: string;
+            transform?: string | undefined;
+        }[];
+        filters: {
+            field: string;
+            op: "eq" | "neq" | "in" | "nin" | "gt" | "gte" | "lt" | "lte";
+            value?: unknown;
+        }[];
+    } | {
+        webhook: {
+            eventIdField?: string | undefined;
+        };
+        mode: "webhook";
+        mapping: {
+            source: string;
+            target: string;
+            transform?: string | undefined;
+        }[];
+        filters: {
+            field: string;
+            op: "eq" | "neq" | "in" | "nin" | "gt" | "gte" | "lt" | "lte";
+            value?: unknown;
+        }[];
+    }> | undefined;
+    events?: {
+        name: string;
+        queue: string;
+        body: Record<string, string>;
+        generate_handler: boolean;
+    }[] | undefined;
+    emits?: string[] | undefined;
+    analytics?: {
+        metrics?: Record<string, {
+            type: "simple";
+            measure: string;
+            filter?: string | undefined;
+            description?: string | undefined;
+            agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+            label?: string | undefined;
+        } | {
+            type: "derived";
+            expr: string;
+            metrics: string[];
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "ratio";
+            numerator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                description?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                label?: string | undefined;
+            };
+            denominator: string | {
+                type: "simple";
+                measure: string;
+                filter?: string | undefined;
+                description?: string | undefined;
+                agg?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+                label?: string | undefined;
+            };
+            filter?: string | undefined;
+            description?: string | undefined;
+            label?: string | undefined;
+        } | {
+            type: "cumulative";
+            measure: string;
+            description?: string | undefined;
+            label?: string | undefined;
+            window?: string | undefined;
+            grain_to_date?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        }> | undefined;
+        measure_packs?: string[] | undefined;
+        cube_name?: string | undefined;
+    } | undefined;
+    unique_indexes?: {
+        fields: string[];
+        name?: string | undefined;
+    }[] | undefined;
+}, {
+    fields: Record<string, {
+        type: "string" | "boolean" | "integer" | "date" | "json" | "decimal" | "uuid" | "datetime" | "entity_ref" | "string_array" | "enum";
+        required?: boolean | undefined;
+        default?: unknown;
+        entity_type?: "primary" | "unique" | "foreign" | "natural" | undefined;
+        nullable?: boolean | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        unique?: boolean | undefined;
+        measure?: boolean | undefined;
+        analytics_aggregation?: "sum" | "min" | "max" | "count" | "count_distinct" | "average" | "median" | "percentile" | "sum_boolean" | undefined;
+        agg_time_dimension?: string | undefined;
+        non_additive_dimension?: string | {
+            name: string;
+            window_choice?: string | undefined;
+            window_groupings?: string[] | undefined;
+        } | undefined;
+        dimension?: boolean | undefined;
+        dimension_type?: "categorical" | "time" | undefined;
+        time_granularity?: "day" | "week" | "month" | "quarter" | "year" | undefined;
+        is_partition?: boolean | undefined;
+        entity?: boolean | undefined;
+        entity_role?: string | undefined;
+        analytics_visibility?: "internal" | "agent" | "public" | undefined;
+        semantic_expr?: string | undefined;
+        semantic_label?: string | undefined;
+        ui_label?: string | undefined;
+        ui_type?: "number" | "boolean" | "date" | "json" | "datetime" | "enum" | "text" | "textarea" | "money" | "percentage" | "email" | "url" | "reference" | "badge" | "password" | undefined;
+        ui_importance?: "primary" | "secondary" | "tertiary" | undefined;
+        ui_group?: string | undefined;
+        ui_sortable?: boolean | undefined;
+        ui_filterable?: boolean | undefined;
+        ui_visible?: boolean | undefined;
+        ui_placeholder?: string | undefined;
+        ui_help?: string | undefined;
+        ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
+        max_length?: number | undefined;
+        min_length?: number | undefined;
+        choices?: string[] | undefined;
+        choices_from?: string | undefined;
+        allowed_types?: string[] | undefined;
+        index?: boolean | undefined;
+        foreign_key?: string | undefined;
+    }>;
+    entity: {
+        name: string;
+        table: string;
+        plural: string;
+        config?: Record<string, unknown> | undefined;
+        folder_structure?: "flat" | "nested" | undefined;
+        file_grouping?: "separate" | "grouped" | undefined;
+        behavior_strategy?: "base_class" | "inline" | undefined;
+        expose?: ("repository" | "rest" | "trpc" | "electric")[] | undefined;
+        pattern?: string | undefined;
+        patterns?: string[] | undefined;
+        scopeable?: boolean | undefined;
+        surface?: string | undefined;
+        context?: string | undefined;
+        sync?: "electric" | "api" | undefined;
+    };
+    relationships?: Record<string, {
+        type: "belongs_to" | "has_many" | "has_one";
+        target: string;
+        foreign_key: string;
+        nullable?: boolean | undefined;
+        through?: string | undefined;
+        inverse?: string | undefined;
+        on_delete?: "cascade" | "restrict" | "set_null" | "no_action" | undefined;
+    }> | undefined;
+    behaviors?: (string | {
+        name: string;
+        options?: Record<string, unknown> | undefined;
+    })[] | undefined;
+    generate?: {
+        writes?: boolean | undefined;
+    } | undefined;
+    eav?: boolean | undefined;
+    eav_value_table?: boolean | undefined;
+    eav_definition_table?: string | undefined;
+    queries?: ({
+        by: string[];
+        select?: string[] | undefined;
+        limit?: boolean | undefined;
+        unique?: boolean | undefined;
+        order?: string | undefined;
+        via?: string | undefined;
+    } | {
+        filters: string[];
+        name: "search";
+        search?: string | undefined;
+        order?: string | undefined;
+        paginate?: boolean | undefined;
+    })[] | undefined;
+    integration?: {
+        electric?: boolean | undefined;
+        providers?: Record<string, {
+            direction: "inbound" | "outbound" | "bidirectional";
+            remote_entity: string;
+            cdc?: boolean | undefined;
+            field_mapping?: Record<string, string> | undefined;
+            read_only_fields?: string[] | undefined;
+        }> | undefined;
+        sink?: {
+            delete?: "noop" | "soft" | "tombstone" | undefined;
+            exclude_fields?: string[] | undefined;
+        } | undefined;
     } | undefined;
     detection?: Record<string, {
         poll: {

package/dist/src/index.js

@@ -45,7 +45,7 @@ import {
   validateOrchestrationProject,
   validatePatternComposition,
   validatePatternProject
-} from "../chunk-6ECCJVYW.js";
+} from "../chunk-4M66MQYA.js";
 import "../chunk-KVOWSC5S.js";
 import "../chunk-QFUIE37H.js";
 import "../chunk-FFUDEIFF.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pattern-stack/codegen",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Entity-driven code generation for full-stack TypeScript applications",
   "license": "MIT",
   "type": "module",

package/runtime/subsystems/events/event-bus.drizzle-backend.ts

@@ -401,18 +401,34 @@ export class DrizzleEventBus implements IEventBus, IEventReadPort, OnModuleInit,
 
     // The idempotency guard is the partial UNIQUE expression index
     // `idx_domain_events_schedule_slot` on (type, metadata->>'scheduleSlot').
-    // Drizzle 0.45's typed `onConflictDoNothing({ target })` only accepts
-    // columns, so it can't name an expression index — we instead let the
-    // insert run and treat a unique-violation (SQLSTATE 23505) as the
-    // already-materialised no-op. This is the exactly-one-per-slot invariant:
-    // a concurrent or repeat materialise of the same slot loses the race at
-    // the DB and reports `created: false`.
+    // Use a BARE (no-target) `ON CONFLICT DO NOTHING`: Drizzle 0.45's typed
+    // `onConflictDoNothing({ target })` only accepts columns so it can't NAME
+    // the expression index, but the no-arg form emits target-less
+    // `ON CONFLICT DO NOTHING`, which Postgres applies to ANY unique
+    // constraint/index — including this expression index. `.returning({ id })`
+    // then gives us the rowcount discriminator: zero rows back == the slot was
+    // already materialised (DO NOTHING fired), so `created: false`. This keeps
+    // the happy path off the exception channel — a repeat materialise no longer
+    // raises SQLSTATE 23505, so Postgres logs no scary `duplicate key value
+    // violates unique constraint` ERROR line on every colliding boot/tick.
+    //
+    // The unique-violation catch is retained as a fallback for the genuine
+    // concurrent-insert race window (two sessions clear the conflict check and
+    // both attempt the insert in the same instant) and for backends whose
+    // driver surfaces a 23505 rather than honouring DO NOTHING; in both cases
+    // it collapses to the same `created: false` no-op.
+    let inserted: Array<{ id: string }>;
     try {
-      await this.db.insert(domainEvents).values(values);
+      inserted = await this.db
+        .insert(domainEvents)
+        .values(values)
+        .onConflictDoNothing()
+        .returning({ id: domainEvents.id });
     } catch (err) {
       if (isUniqueViolation(err)) return { created: false };
       throw err;
     }
+    if (inserted.length === 0) return { created: false };
 
     // Wake the drainer for an already-due tick. A future slot waits for polling.
     if (spec.slotStart.getTime() <= Date.now()) {

package/runtime/subsystems/jobs/job-worker.module.ts

@@ -261,6 +261,11 @@ export class JobWorkerOrchestrator implements OnModuleInit, OnModuleDestroy {
           this.options.shutdownTimeoutMs ?? DEFAULT_SHUTDOWN_TIMEOUT_MS,
         pollIntervalMs: drizzleExt?.pollIntervalMs,
         listenNotify: drizzleExt?.listenNotify,
+        // CLAIM-HB-1 — lease tuning knobs. All optional; the worker defaults
+        // claimHeartbeatIntervalMs to staleThresholdMs/3 when omitted.
+        staleSweeperIntervalMs: drizzleExt?.staleSweeperIntervalMs,
+        staleThresholdMs: drizzleExt?.staleThresholdMs,
+        claimHeartbeatIntervalMs: drizzleExt?.claimHeartbeatIntervalMs,
       };
       const worker = this.options.workerFactory
         ? this.options.workerFactory(workerOptions)