@nest-batch/core 0.2.0

package/dist/src/policies/backoff.d.ts

@@ -0,0 +1,3 @@
+import type { BackoffConfig } from '../core/ir/policy-config';
+export declare function compileBackoff(config: BackoffConfig): (attempt: number) => number;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/src/policies/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../../../src/policies/backoff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAmBjF"}

package/dist/src/policies/backoff.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "compileBackoff", {
+    enumerable: true,
+    get: function() {
+        return compileBackoff;
+    }
+});
+function compileBackoff(config) {
+    switch(config.type){
+        case 'none':
+            return ()=>0;
+        case 'fixed':
+            return ()=>config.ms;
+        case 'exponential':
+            {
+                const factor = config.factor ?? 2;
+                const maxMs = config.maxMs;
+                return (attempt)=>{
+                    const ms = config.initialMs * Math.pow(factor, Math.max(0, attempt - 1));
+                    return maxMs !== undefined ? Math.min(ms, maxMs) : ms;
+                };
+            }
+        default:
+            {
+                const _exhaustive = config;
+                throw new Error(`Unknown backoff type: ${JSON.stringify(_exhaustive)}`);
+            }
+    }
+}
+
+//# sourceMappingURL=backoff.js.map

package/dist/src/policies/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/policies/backoff.ts"],"sourcesContent":["import type { BackoffConfig } from '../core/ir/policy-config';\n\nexport function compileBackoff(config: BackoffConfig): (attempt: number) => number {\n  switch (config.type) {\n    case 'none':\n      return () => 0;\n    case 'fixed':\n      return () => config.ms;\n    case 'exponential': {\n      const factor = config.factor ?? 2;\n      const maxMs = config.maxMs;\n      return (attempt: number) => {\n        const ms = config.initialMs * Math.pow(factor, Math.max(0, attempt - 1));\n        return maxMs !== undefined ? Math.min(ms, maxMs) : ms;\n      };\n    }\n    default: {\n      const _exhaustive: never = config;\n      throw new Error(`Unknown backoff type: ${JSON.stringify(_exhaustive)}`);\n    }\n  }\n}\n"],"names":["compileBackoff","config","type","ms","factor","maxMs","attempt","initialMs","Math","pow","max","undefined","min","_exhaustive","Error","JSON","stringify"],"mappings":";;;;+BAEgBA;;;eAAAA;;;AAAT,SAASA,eAAeC,MAAqB;IAClD,OAAQA,OAAOC,IAAI;QACjB,KAAK;YACH,OAAO,IAAM;QACf,KAAK;YACH,OAAO,IAAMD,OAAOE,EAAE;QACxB,KAAK;YAAe;gBAClB,MAAMC,SAASH,OAAOG,MAAM,IAAI;gBAChC,MAAMC,QAAQJ,OAAOI,KAAK;gBAC1B,OAAO,CAACC;oBACN,MAAMH,KAAKF,OAAOM,SAAS,GAAGC,KAAKC,GAAG,CAACL,QAAQI,KAAKE,GAAG,CAAC,GAAGJ,UAAU;oBACrE,OAAOD,UAAUM,YAAYH,KAAKI,GAAG,CAACT,IAAIE,SAASF;gBACrD;YACF;QACA;YAAS;gBACP,MAAMU,cAAqBZ;gBAC3B,MAAM,IAAIa,MAAM,CAAC,sBAAsB,EAAEC,KAAKC,SAAS,CAACH,cAAc;YACxE;IACF;AACF"}

package/dist/src/policies/index.d.ts

@@ -0,0 +1,4 @@
+export * from './skip-policy';
+export * from './retry-policy';
+export * from './backoff';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/policies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/policies/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}

package/dist/src/policies/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./skip-policy"), exports);
+_export_star(require("./retry-policy"), exports);
+_export_star(require("./backoff"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/src/policies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/policies/index.ts"],"sourcesContent":["export * from './skip-policy';\nexport * from './retry-policy';\nexport * from './backoff';\n"],"names":[],"mappings":";;;;qBAAc;qBACA;qBACA"}

package/dist/src/policies/retry-policy.d.ts

@@ -0,0 +1,13 @@
+import type { RetryPolicyConfig } from '../core/ir/policy-config';
+export interface RetryContext {
+    item: unknown | null;
+    phase: 'read' | 'process' | 'write';
+    attempt: number;
+    retryLimit: number;
+}
+export interface RetryPolicy {
+    canRetry(error: unknown, context: RetryContext): boolean;
+    backoffMs(attempt: number): number;
+}
+export declare function compileRetryPolicy(config: RetryPolicyConfig): RetryPolicy;
+//# sourceMappingURL=retry-policy.d.ts.map

package/dist/src/policies/retry-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../../src/policies/retry-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAA4B,MAAM,0BAA0B,CAAC;AAE5F,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IACzD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC;AAgBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CA4BzE"}

package/dist/src/policies/retry-policy.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "compileRetryPolicy", {
+    enumerable: true,
+    get: function() {
+        return compileRetryPolicy;
+    }
+});
+function matchesSkippable(err, skippable) {
+    if (typeof skippable === 'function') {
+        if (skippable.length === 1) {
+            try {
+                return skippable(err);
+            } catch  {
+                return false;
+            }
+        }
+        return err instanceof skippable;
+    }
+    return false;
+}
+function compileRetryPolicy(config) {
+    if (config.limit <= 0) {
+        throw new Error(`RetryPolicyConfig.limit must be > 0 (got ${config.limit})`);
+    }
+    const backoff = (cfg, attempt)=>{
+        switch(cfg.type){
+            case 'none':
+                return 0;
+            case 'fixed':
+                return cfg.ms;
+            case 'exponential':
+                {
+                    const factor = cfg.factor ?? 2;
+                    const ms = cfg.initialMs * Math.pow(factor, Math.max(0, attempt - 1));
+                    return cfg.maxMs !== undefined ? Math.min(ms, cfg.maxMs) : ms;
+                }
+            default:
+                return 0;
+        }
+    };
+    return {
+        canRetry (error, context) {
+            if (context.attempt > context.retryLimit) return false;
+            return config.retryable.some((s)=>matchesSkippable(error, s));
+        },
+        backoffMs (attempt) {
+            return backoff(config.backoff, attempt);
+        }
+    };
+}
+
+//# sourceMappingURL=retry-policy.js.map

package/dist/src/policies/retry-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/policies/retry-policy.ts"],"sourcesContent":["import type { RetryPolicyConfig, Skippable, BackoffConfig } from '../core/ir/policy-config';\n\nexport interface RetryContext {\n  item: unknown | null;\n  phase: 'read' | 'process' | 'write';\n  attempt: number; // 1-based\n  retryLimit: number;\n}\n\nexport interface RetryPolicy {\n  canRetry(error: unknown, context: RetryContext): boolean;\n  backoffMs(attempt: number): number;\n}\n\nfunction matchesSkippable(err: unknown, skippable: Skippable): boolean {\n  if (typeof skippable === 'function') {\n    if (skippable.length === 1) {\n      try {\n        return (skippable as (err: unknown) => boolean)(err);\n      } catch {\n        return false;\n      }\n    }\n    return err instanceof (skippable as new (...args: unknown[]) => Error);\n  }\n  return false;\n}\n\nexport function compileRetryPolicy(config: RetryPolicyConfig): RetryPolicy {\n  if (config.limit <= 0) {\n    throw new Error(`RetryPolicyConfig.limit must be > 0 (got ${config.limit})`);\n  }\n  const backoff = (cfg: BackoffConfig, attempt: number): number => {\n    switch (cfg.type) {\n      case 'none':\n        return 0;\n      case 'fixed':\n        return cfg.ms;\n      case 'exponential': {\n        const factor = cfg.factor ?? 2;\n        const ms = cfg.initialMs * Math.pow(factor, Math.max(0, attempt - 1));\n        return cfg.maxMs !== undefined ? Math.min(ms, cfg.maxMs) : ms;\n      }\n      default:\n        return 0;\n    }\n  };\n  return {\n    canRetry(error: unknown, context: RetryContext): boolean {\n      if (context.attempt > context.retryLimit) return false;\n      return config.retryable.some((s) => matchesSkippable(error, s));\n    },\n    backoffMs(attempt: number): number {\n      return backoff(config.backoff, attempt);\n    },\n  };\n}\n"],"names":["compileRetryPolicy","matchesSkippable","err","skippable","length","config","limit","Error","backoff","cfg","attempt","type","ms","factor","initialMs","Math","pow","max","maxMs","undefined","min","canRetry","error","context","retryLimit","retryable","some","s","backoffMs"],"mappings":";;;;+BA4BgBA;;;eAAAA;;;AAdhB,SAASC,iBAAiBC,GAAY,EAAEC,SAAoB;IAC1D,IAAI,OAAOA,cAAc,YAAY;QACnC,IAAIA,UAAUC,MAAM,KAAK,GAAG;YAC1B,IAAI;gBACF,OAAO,AAACD,UAAwCD;YAClD,EAAE,OAAM;gBACN,OAAO;YACT;QACF;QACA,OAAOA,eAAgBC;IACzB;IACA,OAAO;AACT;AAEO,SAASH,mBAAmBK,MAAyB;IAC1D,IAAIA,OAAOC,KAAK,IAAI,GAAG;QACrB,MAAM,IAAIC,MAAM,CAAC,yCAAyC,EAAEF,OAAOC,KAAK,CAAC,CAAC,CAAC;IAC7E;IACA,MAAME,UAAU,CAACC,KAAoBC;QACnC,OAAQD,IAAIE,IAAI;YACd,KAAK;gBACH,OAAO;YACT,KAAK;gBACH,OAAOF,IAAIG,EAAE;YACf,KAAK;gBAAe;oBAClB,MAAMC,SAASJ,IAAII,MAAM,IAAI;oBAC7B,MAAMD,KAAKH,IAAIK,SAAS,GAAGC,KAAKC,GAAG,CAACH,QAAQE,KAAKE,GAAG,CAAC,GAAGP,UAAU;oBAClE,OAAOD,IAAIS,KAAK,KAAKC,YAAYJ,KAAKK,GAAG,CAACR,IAAIH,IAAIS,KAAK,IAAIN;gBAC7D;YACA;gBACE,OAAO;QACX;IACF;IACA,OAAO;QACLS,UAASC,KAAc,EAAEC,OAAqB;YAC5C,IAAIA,QAAQb,OAAO,GAAGa,QAAQC,UAAU,EAAE,OAAO;YACjD,OAAOnB,OAAOoB,SAAS,CAACC,IAAI,CAAC,CAACC,IAAM1B,iBAAiBqB,OAAOK;QAC9D;QACAC,WAAUlB,OAAe;YACvB,OAAOF,QAAQH,OAAOG,OAAO,EAAEE;QACjC;IACF;AACF"}

package/dist/src/policies/skip-policy.d.ts

@@ -0,0 +1,12 @@
+import type { SkipPolicyConfig } from '../core/ir/policy-config';
+export interface SkipContext {
+    item: unknown;
+    phase: 'read' | 'process' | 'write';
+    skipCount: number;
+    skipLimit: number;
+}
+export interface SkipPolicy {
+    shouldSkip(error: unknown, context: SkipContext): boolean;
+}
+export declare function compileSkipPolicy(config: SkipPolicyConfig): SkipPolicy;
+//# sourceMappingURL=skip-policy.d.ts.map

package/dist/src/policies/skip-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-policy.d.ts","sourceRoot":"","sources":["../../../src/policies/skip-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,0BAA0B,CAAC;AAG5E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC;CAC3D;AAmBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAmBtE"}

package/dist/src/policies/skip-policy.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "compileSkipPolicy", {
+    enumerable: true,
+    get: function() {
+        return compileSkipPolicy;
+    }
+});
+const _errors = require("../core/errors");
+function matchesSkippable(err, skippable) {
+    if (typeof skippable === 'function') {
+        if (skippable.prototype !== undefined && skippable.prototype instanceof Error) {
+            return err instanceof skippable;
+        }
+        try {
+            return skippable(err);
+        } catch  {
+            return false;
+        }
+    }
+    return false;
+}
+function compileSkipPolicy(config) {
+    if (config.limit <= 0) {
+        throw new _errors.InvalidFlowGraphError('INVALID_SKIP_LIMIT', `SkipPolicyConfig.limit must be > 0 (got ${config.limit})`, {
+            limit: config.limit
+        });
+    }
+    return {
+        shouldSkip (error, context) {
+            if (context.skipCount >= context.skipLimit) {
+                // Limit reached; caller (ChunkProcessor) is expected to raise
+                // SkipLimitExceededError. From the policy's perspective we simply
+                // stop returning `true` for further candidate errors.
+                return false;
+            }
+            return config.skippable.some((s)=>matchesSkippable(error, s));
+        }
+    };
+}
+
+//# sourceMappingURL=skip-policy.js.map

package/dist/src/policies/skip-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/policies/skip-policy.ts"],"sourcesContent":["import type { SkipPolicyConfig, Skippable } from '../core/ir/policy-config';\nimport { InvalidFlowGraphError } from '../core/errors';\n\nexport interface SkipContext {\n  item: unknown;\n  phase: 'read' | 'process' | 'write';\n  skipCount: number;\n  skipLimit: number;\n}\n\nexport interface SkipPolicy {\n  shouldSkip(error: unknown, context: SkipContext): boolean;\n}\n\nfunction matchesSkippable(err: unknown, skippable: Skippable): boolean {\n  if (typeof skippable === 'function') {\n    if (\n      skippable.prototype !== undefined &&\n      skippable.prototype instanceof Error\n    ) {\n      return err instanceof (skippable as new (...args: unknown[]) => Error);\n    }\n    try {\n      return (skippable as (err: unknown) => boolean)(err);\n    } catch {\n      return false;\n    }\n  }\n  return false;\n}\n\nexport function compileSkipPolicy(config: SkipPolicyConfig): SkipPolicy {\n  if (config.limit <= 0) {\n    throw new InvalidFlowGraphError(\n      'INVALID_SKIP_LIMIT',\n      `SkipPolicyConfig.limit must be > 0 (got ${config.limit})`,\n      { limit: config.limit },\n    );\n  }\n  return {\n    shouldSkip(error: unknown, context: SkipContext): boolean {\n      if (context.skipCount >= context.skipLimit) {\n        // Limit reached; caller (ChunkProcessor) is expected to raise\n        // SkipLimitExceededError. From the policy's perspective we simply\n        // stop returning `true` for further candidate errors.\n        return false;\n      }\n      return config.skippable.some((s) => matchesSkippable(error, s));\n    },\n  };\n}\n"],"names":["compileSkipPolicy","matchesSkippable","err","skippable","prototype","undefined","Error","config","limit","InvalidFlowGraphError","shouldSkip","error","context","skipCount","skipLimit","some","s"],"mappings":";;;;+BA+BgBA;;;eAAAA;;;wBA9BsB;AAatC,SAASC,iBAAiBC,GAAY,EAAEC,SAAoB;IAC1D,IAAI,OAAOA,cAAc,YAAY;QACnC,IACEA,UAAUC,SAAS,KAAKC,aACxBF,UAAUC,SAAS,YAAYE,OAC/B;YACA,OAAOJ,eAAgBC;QACzB;QACA,IAAI;YACF,OAAO,AAACA,UAAwCD;QAClD,EAAE,OAAM;YACN,OAAO;QACT;IACF;IACA,OAAO;AACT;AAEO,SAASF,kBAAkBO,MAAwB;IACxD,IAAIA,OAAOC,KAAK,IAAI,GAAG;QACrB,MAAM,IAAIC,6BAAqB,CAC7B,sBACA,CAAC,wCAAwC,EAAEF,OAAOC,KAAK,CAAC,CAAC,CAAC,EAC1D;YAAEA,OAAOD,OAAOC,KAAK;QAAC;IAE1B;IACA,OAAO;QACLE,YAAWC,KAAc,EAAEC,OAAoB;YAC7C,IAAIA,QAAQC,SAAS,IAAID,QAAQE,SAAS,EAAE;gBAC1C,8DAA8D;gBAC9D,kEAAkE;gBAClE,sDAAsD;gBACtD,OAAO;YACT;YACA,OAAOP,OAAOJ,SAAS,CAACY,IAAI,CAAC,CAACC,IAAMf,iBAAiBU,OAAOK;QAC9D;IACF;AACF"}

package/dist/src/registry/index.d.ts

@@ -0,0 +1,2 @@
+export * from './job-registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/src/registry/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./job-registry"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/src/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/registry/index.ts"],"sourcesContent":["export * from './job-registry';\n"],"names":[],"mappings":";;;;qBAAc"}

package/dist/src/registry/job-registry.d.ts

@@ -0,0 +1,16 @@
+import type { JobDefinition } from '../core/ir';
+export declare class JobRegistry {
+    private readonly definitions;
+    private readonly validator;
+    /**
+     * Register a job definition. Validates the graph and throws on duplicates.
+     */
+    register(job: JobDefinition): void;
+    /**
+     * Look up a job definition by ID. Throws JobNotFoundError if missing.
+     */
+    get(jobId: string): JobDefinition;
+    has(jobId: string): boolean;
+    getAll(): JobDefinition[];
+}
+//# sourceMappingURL=job-registry.d.ts.map

package/dist/src/registry/job-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-registry.d.ts","sourceRoot":"","sources":["../../../src/registry/job-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhD,qBACa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAQlC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAMjC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3B,MAAM,IAAI,aAAa,EAAE;CAG1B"}

package/dist/src/registry/job-registry.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "JobRegistry", {
+    enumerable: true,
+    get: function() {
+        return JobRegistry;
+    }
+});
+const _common = require("@nestjs/common");
+const _definitionvalidator = require("../core/validation/definition-validator");
+const _errors = require("../core/errors");
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+let JobRegistry = class JobRegistry {
+    definitions = new Map();
+    validator = new _definitionvalidator.DefinitionValidator();
+    /**
+   * Register a job definition. Validates the graph and throws on duplicates.
+   */ register(job) {
+        if (this.definitions.has(job.id)) {
+            throw new _errors.DuplicateJobDefinitionError(job.id);
+        }
+        this.validator.validate(job);
+        this.definitions.set(job.id, job);
+    }
+    /**
+   * Look up a job definition by ID. Throws JobNotFoundError if missing.
+   */ get(jobId) {
+        const def = this.definitions.get(jobId);
+        if (!def) throw new _errors.JobNotFoundError(jobId);
+        return def;
+    }
+    has(jobId) {
+        return this.definitions.has(jobId);
+    }
+    getAll() {
+        return Array.from(this.definitions.values());
+    }
+};
+JobRegistry = _ts_decorate([
+    (0, _common.Injectable)()
+], JobRegistry);
+
+//# sourceMappingURL=job-registry.js.map

package/dist/src/registry/job-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/registry/job-registry.ts"],"sourcesContent":["import { Injectable } from '@nestjs/common';\nimport type { JobDefinition } from '../core/ir';\nimport { DefinitionValidator } from '../core/validation/definition-validator';\nimport {\n  JobNotFoundError,\n  DuplicateJobDefinitionError,\n  InvalidFlowGraphError,\n} from '../core/errors';\n\n@Injectable()\nexport class JobRegistry {\n  private readonly definitions = new Map<string, JobDefinition>();\n  private readonly validator = new DefinitionValidator();\n\n  /**\n   * Register a job definition. Validates the graph and throws on duplicates.\n   */\n  register(job: JobDefinition): void {\n    if (this.definitions.has(job.id)) {\n      throw new DuplicateJobDefinitionError(job.id);\n    }\n    this.validator.validate(job);\n    this.definitions.set(job.id, job);\n  }\n\n  /**\n   * Look up a job definition by ID. Throws JobNotFoundError if missing.\n   */\n  get(jobId: string): JobDefinition {\n    const def = this.definitions.get(jobId);\n    if (!def) throw new JobNotFoundError(jobId);\n    return def;\n  }\n\n  has(jobId: string): boolean {\n    return this.definitions.has(jobId);\n  }\n\n  getAll(): JobDefinition[] {\n    return Array.from(this.definitions.values());\n  }\n}\n"],"names":["JobRegistry","definitions","Map","validator","DefinitionValidator","register","job","has","id","DuplicateJobDefinitionError","validate","set","get","jobId","def","JobNotFoundError","getAll","Array","from","values"],"mappings":";;;;+BAUaA;;;eAAAA;;;wBAVc;qCAES;wBAK7B;;;;;;;AAGA,IAAA,AAAMA,cAAN,MAAMA;IACMC,cAAc,IAAIC,MAA6B;IAC/CC,YAAY,IAAIC,wCAAmB,GAAG;IAEvD;;GAEC,GACDC,SAASC,GAAkB,EAAQ;QACjC,IAAI,IAAI,CAACL,WAAW,CAACM,GAAG,CAACD,IAAIE,EAAE,GAAG;YAChC,MAAM,IAAIC,mCAA2B,CAACH,IAAIE,EAAE;QAC9C;QACA,IAAI,CAACL,SAAS,CAACO,QAAQ,CAACJ;QACxB,IAAI,CAACL,WAAW,CAACU,GAAG,CAACL,IAAIE,EAAE,EAAEF;IAC/B;IAEA;;GAEC,GACDM,IAAIC,KAAa,EAAiB;QAChC,MAAMC,MAAM,IAAI,CAACb,WAAW,CAACW,GAAG,CAACC;QACjC,IAAI,CAACC,KAAK,MAAM,IAAIC,wBAAgB,CAACF;QACrC,OAAOC;IACT;IAEAP,IAAIM,KAAa,EAAW;QAC1B,OAAO,IAAI,CAACZ,WAAW,CAACM,GAAG,CAACM;IAC9B;IAEAG,SAA0B;QACxB,OAAOC,MAAMC,IAAI,CAAC,IAAI,CAACjB,WAAW,CAACkB,MAAM;IAC3C;AACF"}

package/dist/src/repository/id-generator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generates unique IDs for JobInstances, JobExecutions, StepExecutions.
+ * The default implementation uses crypto.randomUUID() (v4).
+ * Tests can use DeterministicIdGenerator for predictable output.
+ */
+export interface IdGenerator {
+    next(): string;
+}
+export declare class UuidIdGenerator implements IdGenerator {
+    next(): string;
+}
+export declare class DeterministicIdGenerator implements IdGenerator {
+    private readonly prefix;
+    private counter;
+    constructor(prefix?: string);
+    next(): string;
+}
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/src/repository/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../../src/repository/id-generator.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,qBAAa,eAAgB,YAAW,WAAW;IACjD,IAAI,IAAI,MAAM;CAGf;AAED,qBAAa,wBAAyB,YAAW,WAAW;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,OAAO,CAAC,OAAO,CAAK;gBACS,MAAM,GAAE,MAAa;IAClD,IAAI,IAAI,MAAM;CAIf"}

package/dist/src/repository/id-generator.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get DeterministicIdGenerator () {
+        return DeterministicIdGenerator;
+    },
+    get UuidIdGenerator () {
+        return UuidIdGenerator;
+    }
+});
+const _crypto = require("crypto");
+let UuidIdGenerator = class UuidIdGenerator {
+    next() {
+        return (0, _crypto.randomUUID)();
+    }
+};
+let DeterministicIdGenerator = class DeterministicIdGenerator {
+    prefix;
+    counter = 0;
+    constructor(prefix = 'id'){
+        this.prefix = prefix;
+    }
+    next() {
+        this.counter += 1;
+        return `${this.prefix}-${this.counter}`;
+    }
+};
+
+//# sourceMappingURL=id-generator.js.map

package/dist/src/repository/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/repository/id-generator.ts"],"sourcesContent":["import { randomUUID } from 'crypto';\n\n/**\n * Generates unique IDs for JobInstances, JobExecutions, StepExecutions.\n * The default implementation uses crypto.randomUUID() (v4).\n * Tests can use DeterministicIdGenerator for predictable output.\n */\nexport interface IdGenerator {\n  next(): string;\n}\n\nexport class UuidIdGenerator implements IdGenerator {\n  next(): string {\n    return randomUUID();\n  }\n}\n\nexport class DeterministicIdGenerator implements IdGenerator {\n  private counter = 0;\n  constructor(private readonly prefix: string = 'id') {}\n  next(): string {\n    this.counter += 1;\n    return `${this.prefix}-${this.counter}`;\n  }\n}\n"],"names":["DeterministicIdGenerator","UuidIdGenerator","next","randomUUID","counter","prefix"],"mappings":";;;;;;;;;;;QAiBaA;eAAAA;;QANAC;eAAAA;;;wBAXc;AAWpB,IAAA,AAAMA,kBAAN,MAAMA;IACXC,OAAe;QACb,OAAOC,IAAAA,kBAAU;IACnB;AACF;AAEO,IAAA,AAAMH,2BAAN,MAAMA;;IACHI,UAAU,EAAE;IACpB,YAAY,AAAiBC,SAAiB,IAAI,CAAE;aAAvBA,SAAAA;IAAwB;IACrDH,OAAe;QACb,IAAI,CAACE,OAAO,IAAI;QAChB,OAAO,GAAG,IAAI,CAACC,MAAM,CAAC,CAAC,EAAE,IAAI,CAACD,OAAO,EAAE;IACzC;AACF"}

package/dist/src/repository/in-memory/in-memory-job-repository.d.ts

@@ -0,0 +1,49 @@
+import { JobRepository } from '@nest-batch/core';
+import type { JobInstance, JobExecution, JobExecutionPatch, JobParameters, StepExecution, StepExecutionPatch, ExecutionContext, ExecutionScope, JobInstanceFilter, JobExecutionFilter } from '@nest-batch/core';
+import type { IdGenerator } from '../id-generator';
+/**
+ * In-memory JobRepository with real-repo semantics:
+ * - deterministic IDs (configurable via IdGenerator)
+ * - deep clone on reads/writes to prevent mutation leaks
+ * - async signatures
+ * - uniqueness on (jobName, jobKey)
+ * - getOrCreateJobInstance / createJobExecution / getRunningJobExecution
+ *   share a single promise-chain lock, so the check-then-create sequence
+ *   used by JobLauncher is race-safe
+ *
+ * restartable: false by default (per Metis directive: in-memory repo is non-restartable
+ * because contexts are lost on process restart).
+ */
+export declare class InMemoryJobRepository extends JobRepository {
+    private readonly idGen;
+    private readonly state;
+    /** Promise-chain lock to serialize getOrCreateJobInstance calls. */
+    private lock;
+    constructor(idGen?: IdGenerator);
+    private withLock;
+    getOrCreateJobInstance(name: string, jobKey: string): Promise<JobInstance>;
+    createJobExecution(jobInstanceId: string, params: JobParameters): Promise<JobExecution>;
+    createExecutionAtomic(name: string, jobKey: string, params: JobParameters): Promise<JobExecution>;
+    getRunningJobExecution(jobInstanceId: string): Promise<JobExecution | null>;
+    updateJobExecution(executionId: string, patch: JobExecutionPatch): Promise<void>;
+    getJobExecution(executionId: string): Promise<JobExecution | null>;
+    getJobInstance(jobInstanceId: string): Promise<JobInstance | null>;
+    findJobInstances(filter?: JobInstanceFilter): Promise<JobInstance[]>;
+    findJobExecutions(filter?: JobExecutionFilter): Promise<JobExecution[]>;
+    createStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution>;
+    updateStepExecution(stepExecutionId: string, patch: StepExecutionPatch): Promise<void>;
+    getStepExecution(stepExecutionId: string): Promise<StepExecution | null>;
+    findStepExecutions(jobExecutionId: string): Promise<StepExecution[]>;
+    getExecutionContext(scope: ExecutionScope): Promise<ExecutionContext>;
+    saveExecutionContext(scope: ExecutionScope, ctx: ExecutionContext, version?: number): Promise<void>;
+    /**
+     * Returns the most recently created StepExecution for the given
+     * (jobExecutionId, stepName) pair, or `null` if none exists. Insertion
+     * order over `Map` is stable (ES2015+), so a reverse scan picks the
+     * latest entry that matches the filter. The restart path filters the
+     * result further by status (FAILED) at the call site.
+     */
+    findLatestStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution | null>;
+}
+export declare const RESTARTABLE_DEFAULT_INMEMORY = false;
+//# sourceMappingURL=in-memory-job-repository.d.ts.map

package/dist/src/repository/in-memory/in-memory-job-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-job-repository.d.ts","sourceRoot":"","sources":["../../../../src/repository/in-memory/in-memory-job-repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA2BnD;;;;;;;;;;;;GAYG;AACH,qBACa,qBAAsB,SAAQ,aAAa;IAW1C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAVlC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAMpB;IACF,oEAAoE;IACpE,OAAO,CAAC,IAAI,CAAuC;gBAEtB,KAAK,GAAE,WAAmC;YAIzD,QAAQ;IAchB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiB1E,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBvF,qBAAqB,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,CAAC;IAqClB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAc3E,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhF,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAKzD,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKlE,gBAAgB,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAUxE,iBAAiB,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAoCpF,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBrF,mBAAmB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtF,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK/D,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAU7E,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMrE,oBAAoB,CACxB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAWhB;;;;;;OAMG;IACG,uBAAuB,CAC3B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAcjC;AAED,eAAO,MAAM,4BAA4B,QAAQ,CAAC"}