@nest-batch/core 0.2.0

package/dist/src/core/ir/decider-definition.d.ts

@@ -0,0 +1,20 @@
+import type { JobExecution } from '../repository/types';
+import type { StepStatus } from '../status';
+export interface JobExecutionDeciderContext {
+    readonly jobExecution: JobExecution;
+    readonly stepId: string;
+    readonly stepExecutionId: string;
+    readonly stepStatus: StepStatus;
+    readonly exitCode: string;
+    readonly exitMessage: string;
+}
+export type JobExecutionDecider = (context: JobExecutionDeciderContext) => string | Promise<string>;
+export interface DeciderDefinition {
+    readonly afterStepId: string;
+    readonly decide: JobExecutionDecider;
+}
+export interface ReusableFlowDefinition {
+    readonly transitions: readonly import('./transition-definition').TransitionDefinition[];
+    readonly deciders?: readonly DeciderDefinition[];
+}
+//# sourceMappingURL=decider-definition.d.ts.map

package/dist/src/core/ir/decider-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decider-definition.d.ts","sourceRoot":"","sources":["../../../../src/core/ir/decider-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,0BAA0B,KAChC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS,OAAO,yBAAyB,EAAE,oBAAoB,EAAE,CAAC;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD"}

package/dist/src/core/ir/decider-definition.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=decider-definition.js.map

package/dist/src/core/ir/decider-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/ir/decider-definition.ts"],"names":[],"mappings":""}

package/dist/src/core/ir/index.d.ts

@@ -0,0 +1,8 @@
+export * from './job-definition';
+export * from './step-definition';
+export * from './transition-definition';
+export * from './decider-definition';
+export * from './listener-definition';
+export * from './policy-config';
+export * from './refs';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/ir/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC"}

package/dist/src/core/ir/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./job-definition"), exports);
+_export_star(require("./step-definition"), exports);
+_export_star(require("./transition-definition"), exports);
+_export_star(require("./decider-definition"), exports);
+_export_star(require("./listener-definition"), exports);
+_export_star(require("./policy-config"), exports);
+_export_star(require("./refs"), 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/core/ir/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/ir/index.ts"],"sourcesContent":["export * from './job-definition';\nexport * from './step-definition';\nexport * from './transition-definition';\nexport * from './decider-definition';\nexport * from './listener-definition';\nexport * from './policy-config';\nexport * from './refs';\n"],"names":[],"mappings":";;;;qBAAc;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA"}

package/dist/src/core/ir/job-definition.d.ts

@@ -0,0 +1,15 @@
+import type { StepDefinition } from './step-definition';
+import type { TransitionDefinition } from './transition-definition';
+import type { ListenerDefinition } from './listener-definition';
+import type { DeciderDefinition } from './decider-definition';
+export interface JobDefinition {
+    id: string;
+    steps: Record<string, StepDefinition>;
+    startStepId: string;
+    transitions: TransitionDefinition[];
+    deciders?: DeciderDefinition[];
+    listeners: ListenerDefinition[];
+    restartable: boolean;
+    allowDuplicateInstances: boolean;
+}
+//# sourceMappingURL=job-definition.d.ts.map

package/dist/src/core/ir/job-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-definition.d.ts","sourceRoot":"","sources":["../../../../src/core/ir/job-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,uBAAuB,EAAE,OAAO,CAAC;CAClC"}

package/dist/src/core/ir/job-definition.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=job-definition.js.map

package/dist/src/core/ir/job-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/ir/job-definition.ts"],"names":[],"mappings":""}

package/dist/src/core/ir/listener-definition.d.ts

@@ -0,0 +1,10 @@
+import type { ListenerRef } from './refs';
+export type ListenerKind = 'job' | 'step' | 'chunk' | 'item-read' | 'item-process' | 'item-write' | 'skip' | 'transition';
+export type ListenerPhase = 'before' | 'after' | 'on-error';
+export interface ListenerDefinition {
+    kind: ListenerKind;
+    ref: ListenerRef;
+    phase: ListenerPhase;
+    nonCritical?: boolean;
+}
+//# sourceMappingURL=listener-definition.d.ts.map

package/dist/src/core/ir/listener-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener-definition.d.ts","sourceRoot":"","sources":["../../../../src/core/ir/listener-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,MAAM,GACN,OAAO,GACP,WAAW,GACX,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,CAAC;AACjB,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/src/core/ir/listener-definition.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=listener-definition.js.map

package/dist/src/core/ir/listener-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/ir/listener-definition.ts"],"names":[],"mappings":""}

package/dist/src/core/ir/policy-config.d.ts

@@ -0,0 +1,24 @@
+export type ErrorClass = new (...args: any[]) => Error;
+export type ErrorPredicate = (err: unknown) => boolean;
+export type Skippable = ErrorClass | ErrorPredicate;
+export interface SkipPolicyConfig {
+    limit: number;
+    skippable: Skippable[];
+}
+export type BackoffConfig = {
+    type: 'fixed';
+    ms: number;
+} | {
+    type: 'exponential';
+    initialMs: number;
+    maxMs?: number;
+    factor?: number;
+} | {
+    type: 'none';
+};
+export interface RetryPolicyConfig {
+    limit: number;
+    retryable: Skippable[];
+    backoff: BackoffConfig;
+}
+//# sourceMappingURL=policy-config.d.ts.map

package/dist/src/core/ir/policy-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-config.d.ts","sourceRoot":"","sources":["../../../../src/core/ir/policy-config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;AACvD,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,cAAc,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;CACxB"}

package/dist/src/core/ir/policy-config.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=policy-config.js.map

package/dist/src/core/ir/policy-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/ir/policy-config.ts"],"names":[],"mappings":""}

package/dist/src/core/ir/refs.d.ts

@@ -0,0 +1,42 @@
+export declare enum RefKind {
+    ProviderToken = "provider-token",
+    BuilderLambda = "builder-lambda",
+    Method = "method"
+}
+export interface ReaderRef {
+    kind: RefKind;
+    token?: string;
+    fn?: (...args: any[]) => unknown;
+    classToken?: string;
+    methodName?: string;
+}
+export interface ProcessorRef {
+    kind: RefKind;
+    token?: string;
+    fn?: (...args: any[]) => unknown;
+    classToken?: string;
+    methodName?: string;
+}
+export interface WriterRef {
+    kind: RefKind;
+    token?: string;
+    fn?: (...args: any[]) => unknown;
+    classToken?: string;
+    methodName?: string;
+}
+export interface TaskletRef {
+    kind: RefKind;
+    token?: string;
+    fn?: (...args: any[]) => unknown;
+    classToken?: string;
+    methodName?: string;
+}
+export interface ListenerRef {
+    kind: RefKind;
+    token?: string;
+    fn?: (...args: any[]) => unknown;
+    classToken?: string;
+    methodName?: string;
+}
+export type ItemListenerRef = ListenerRef;
+//# sourceMappingURL=refs.d.ts.map

package/dist/src/core/ir/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../../src/core/ir/refs.ts"],"names":[],"mappings":"AAAA,oBAAY,OAAO;IACjB,aAAa,mBAAmB;IAChC,aAAa,mBAAmB;IAChC,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC"}

package/dist/src/core/ir/refs.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "RefKind", {
+    enumerable: true,
+    get: function() {
+        return RefKind;
+    }
+});
+var RefKind = /*#__PURE__*/ function(RefKind) {
+    RefKind["ProviderToken"] = "provider-token";
+    RefKind["BuilderLambda"] = "builder-lambda";
+    RefKind["Method"] = "method";
+    return RefKind;
+}({});
+
+//# sourceMappingURL=refs.js.map

package/dist/src/core/ir/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/ir/refs.ts"],"sourcesContent":["export enum RefKind {\n  ProviderToken = 'provider-token',\n  BuilderLambda = 'builder-lambda',\n  Method = 'method',\n}\n\nexport interface ReaderRef {\n  kind: RefKind;\n  token?: string;\n  fn?: (...args: any[]) => unknown;\n  classToken?: string;\n  methodName?: string;\n}\nexport interface ProcessorRef {\n  kind: RefKind;\n  token?: string;\n  fn?: (...args: any[]) => unknown;\n  classToken?: string;\n  methodName?: string;\n}\nexport interface WriterRef {\n  kind: RefKind;\n  token?: string;\n  fn?: (...args: any[]) => unknown;\n  classToken?: string;\n  methodName?: string;\n}\nexport interface TaskletRef {\n  kind: RefKind;\n  token?: string;\n  fn?: (...args: any[]) => unknown;\n  classToken?: string;\n  methodName?: string;\n}\nexport interface ListenerRef {\n  kind: RefKind;\n  token?: string;\n  fn?: (...args: any[]) => unknown;\n  classToken?: string;\n  methodName?: string;\n}\nexport type ItemListenerRef = ListenerRef;\n"],"names":["RefKind"],"mappings":";;;;+BAAYA;;;eAAAA;;;AAAL,IAAA,AAAKA,iCAAAA;;;;WAAAA"}

package/dist/src/core/ir/step-definition.d.ts

@@ -0,0 +1,59 @@
+import type { ReaderRef, ProcessorRef, WriterRef, TaskletRef, ItemListenerRef } from './refs';
+import type { SkipPolicyConfig, RetryPolicyConfig } from './policy-config';
+export type StepDefinition = ChunkStepDefinition | TaskletStepDefinition;
+/**
+ * v1 partition configuration for a chunk step. Pinned by
+ * `docs/RELEASE-0.2.0.md §6.1` and the T-AC-3 acceptance test.
+ *
+ * - `count` is the number of partitions. `count === 1` (or the
+ *   field being absent) preserves the 0.1.0 "one job per step"
+ *   behaviour. `count >= 2` activates the partition-aware runtime:
+ *   the transport enqueues `count` jobs, each with a distinct
+ *   `partitionIndex`, and the worker body offsets the chunk loop
+ *   by the partition's range.
+ * - `range` is an optional half-open `[from, to]` resolver. When
+ *   omitted, the runtime treats each partition as "reads from the
+ *   start" (the host's reader is responsible for not
+ *   double-processing). When provided, the chunk executor bounds
+ *   its read loop to `to - from` items.
+ */
+export interface ChunkPartitionConfig {
+    /** Number of partitions; must be a positive integer. */
+    readonly count: number;
+    /**
+     * Optional partition-range resolver. Given the partition index
+     * `i` and the total `n`, return a half-open `[from, to]` range
+     * that the partition consumes. The default behaviour (when
+     * omitted) is to read until EOF on every partition; hosts that
+     * want an even split should provide a closure that captures the
+     * total item count (the runtime has no generic "even split"
+     * because the total is host-known).
+     */
+    readonly range?: (i: number, n: number) => readonly [from: number, to: number];
+}
+export interface ChunkStepDefinition {
+    kind: 'chunk';
+    id: string;
+    chunkSize: number;
+    reader: ReaderRef;
+    processor?: ProcessorRef;
+    writer: WriterRef;
+    skipPolicy?: SkipPolicyConfig;
+    retryPolicy?: RetryPolicyConfig;
+    listeners: ItemListenerRef[];
+    /**
+     * Optional partition configuration. When absent, the step
+     * runs as a single non-partitioned unit (the 0.1.0 behaviour).
+     * When present with `count >= 2`, the transport activates
+     * partition orchestration — see `docs/RELEASE-0.2.0.md §6` and
+     * `packages/core/src/partition-helpers.ts` for the contract.
+     */
+    readonly partitions?: ChunkPartitionConfig;
+}
+export interface TaskletStepDefinition {
+    kind: 'tasklet';
+    id: string;
+    tasklet: TaskletRef;
+    listeners: ItemListenerRef[];
+}
+//# sourceMappingURL=step-definition.d.ts.map

package/dist/src/core/ir/step-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-definition.d.ts","sourceRoot":"","sources":["../../../../src/core/ir/step-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAEzE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B"}

package/dist/src/core/ir/step-definition.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=step-definition.js.map

package/dist/src/core/ir/step-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/ir/step-definition.ts"],"names":[],"mappings":""}

package/dist/src/core/ir/transition-definition.d.ts

@@ -0,0 +1,8 @@
+import type { FlowExecutionStatus } from '../status';
+export type FlowTransitionPattern = FlowExecutionStatus | string;
+export interface TransitionDefinition {
+    fromStepId: string;
+    onStatus: FlowTransitionPattern;
+    toStepId: string | null;
+}
+//# sourceMappingURL=transition-definition.d.ts.map

package/dist/src/core/ir/transition-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-definition.d.ts","sourceRoot":"","sources":["../../../../src/core/ir/transition-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/src/core/ir/transition-definition.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=transition-definition.js.map

package/dist/src/core/ir/transition-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/ir/transition-definition.ts"],"names":[],"mappings":""}

package/dist/src/core/item/index.d.ts

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

package/dist/src/core/item/index.d.ts.map

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

package/dist/src/core/item/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./interfaces"), 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/core/item/index.js.map

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

package/dist/src/core/item/interfaces.d.ts

@@ -0,0 +1,64 @@
+import type { ExecutionContext } from '../repository/types';
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Reads one item at a time. Returns `null` to signal EOF.
+ * For async iteration, use `AsyncIterable.read()` (not yet supported in MVP).
+ */
+export interface ItemReader<T = unknown> {
+    read(): Promise<T | null>;
+}
+/**
+ * Processes one item. Returns `null`/`undefined` to filter the item out of the chunk.
+ * Throws to indicate the item should be skipped (via SkipPolicy) or retried (via RetryPolicy).
+ */
+export interface ItemProcessor<I = unknown, O = unknown> {
+    process(item: I): Promise<O | null | undefined>;
+}
+/**
+ * Writes a batch of items. Called once per chunk (after processing).
+ *
+ * May return a `WriterResult` to report partial success — e.g. a
+ * `ProductWriter` that drops duplicate-SKU rows internally. Returning
+ * `void` (or `undefined`) means the writer assumed all `items` were
+ * persisted; the chunk executor then uses `items.length` as the write
+ * count and assumes no per-item skips.
+ */
+export interface ItemWriter<T = unknown> {
+    write(items: T[]): Promise<WriterResult | void>;
+}
+export interface WriterResult {
+    written: number;
+    skipped: number;
+}
+/**
+ * Optional lifecycle contract for stateful chunk components.
+ *
+ * The chunk executor passes the step-scoped ExecutionContext to
+ * `open()` before the first read, calls `update()` after every committed
+ * chunk, persists the returned or mutated context, and calls `close()`
+ * before the step returns. Errors from any hook fail the step.
+ */
+export interface ItemStream {
+    open(context: ExecutionContext): MaybePromise<void>;
+    update(context: ExecutionContext): MaybePromise<ExecutionContext | void>;
+    close(): MaybePromise<void>;
+}
+/**
+ * Tasklet context: lets the tasklet access the execution context for
+ * cross-chunk state.
+ */
+export interface TaskletContext {
+    readonly jobExecutionId: string;
+    readonly stepExecutionId: string;
+    getExecutionContext(): Promise<ExecutionContext>;
+    saveExecutionContext(ctx: ExecutionContext): Promise<void>;
+}
+/**
+ * Tasklet: a single-execution step (no chunk loop).
+ * Return value is informational; throws signal failure.
+ */
+export interface Tasklet {
+    execute(ctx: TaskletContext): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/src/core/item/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/core/item/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,qBAAqB,CAAC;AAE5E,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACrD,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACjD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACzE,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjD,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD"}

package/dist/src/core/item/interfaces.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=interfaces.js.map

package/dist/src/core/item/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/item/interfaces.ts"],"names":[],"mappings":""}

package/dist/src/core/repository/index.d.ts

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

package/dist/src/core/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/repository/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC"}

package/dist/src/core/repository/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./types"), exports);
+_export_star(require("./job-repository"), 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/core/repository/index.js.map

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

package/dist/src/core/repository/job-repository.d.ts

@@ -0,0 +1,60 @@
+import type { JobInstance, JobExecution, JobExecutionPatch, JobParameters, StepExecution, StepExecutionPatch, ExecutionContext, ExecutionScope, JobInstanceFilter, JobExecutionFilter } from './types';
+export interface IJobRepository {
+    getOrCreateJobInstance(name: string, jobKey: string): Promise<JobInstance>;
+    createJobExecution(jobInstanceId: string, params: JobParameters): Promise<JobExecution>;
+    /**
+     * Atomically: ensure a `JobInstance` for `(name, jobKey)` exists, lock
+     * the instance row (skipping if another concurrent launch already
+     * holds the lock), verify no running execution, and create a new
+     * execution in STARTING state. The PostgreSQL implementation uses
+     * `INSERT ... ON CONFLICT DO NOTHING` + `SELECT ... FOR UPDATE SKIP
+     * LOCKED` inside a single transaction. The in-memory implementation
+     * uses an in-process mutex (Node is single-threaded so the lock is
+     * effectively a serialization point rather than a true blocker).
+     *
+     * Throws `JobExecutionAlreadyRunningError` if another launch is in
+     * progress (FOR UPDATE returned no row) or if an execution is already
+     * STARTING/STARTED for this instance.
+     */
+    createExecutionAtomic(name: string, jobKey: string, params: JobParameters): Promise<JobExecution>;
+    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[]>;
+    getRunningJobExecution(jobInstanceId: string): Promise<JobExecution | null>;
+    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>;
+    /**
+     * Find the most recently created StepExecution for a given
+     * (jobExecutionId, stepName) pair regardless of status. Returns `null`
+     * if no matching step execution exists. Used by the restart path to
+     * locate the prior (typically FAILED) step execution so its execution
+     * context — which holds the last-committed-chunk checkpoint — can be
+     * loaded.
+     */
+    findLatestStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution | null>;
+}
+export declare abstract class JobRepository implements IJobRepository {
+    abstract getOrCreateJobInstance(name: string, jobKey: string): Promise<JobInstance>;
+    abstract createJobExecution(jobInstanceId: string, params: JobParameters): Promise<JobExecution>;
+    abstract createExecutionAtomic(name: string, jobKey: string, params: JobParameters): Promise<JobExecution>;
+    abstract updateJobExecution(executionId: string, patch: JobExecutionPatch): Promise<void>;
+    abstract getJobExecution(executionId: string): Promise<JobExecution | null>;
+    getJobInstance(_jobInstanceId: string): Promise<JobInstance | null>;
+    findJobInstances(_filter?: JobInstanceFilter): Promise<JobInstance[]>;
+    findJobExecutions(_filter?: JobExecutionFilter): Promise<JobExecution[]>;
+    abstract getRunningJobExecution(jobInstanceId: string): Promise<JobExecution | null>;
+    abstract createStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution>;
+    abstract updateStepExecution(stepExecutionId: string, patch: StepExecutionPatch): Promise<void>;
+    abstract getStepExecution(stepExecutionId: string): Promise<StepExecution | null>;
+    findStepExecutions(_jobExecutionId: string): Promise<StepExecution[]>;
+    abstract getExecutionContext(scope: ExecutionScope): Promise<ExecutionContext>;
+    abstract saveExecutionContext(scope: ExecutionScope, ctx: ExecutionContext, version?: number): Promise<void>;
+    abstract findLatestStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution | null>;
+}
+//# sourceMappingURL=job-repository.d.ts.map

package/dist/src/core/repository/job-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-repository.d.ts","sourceRoot":"","sources":["../../../../src/core/repository/job-repository.ts"],"names":[],"mappings":"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"}

package/dist/src/core/repository/job-repository.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "JobRepository", {
+    enumerable: true,
+    get: function() {
+        return JobRepository;
+    }
+});
+const _errors = require("../errors");
+let JobRepository = class JobRepository {
+    getJobInstance(_jobInstanceId) {
+        throw new _errors.UnsupportedJobRepositoryOperationError('getJobInstance');
+    }
+    findJobInstances(_filter = {}) {
+        throw new _errors.UnsupportedJobRepositoryOperationError('findJobInstances');
+    }
+    findJobExecutions(_filter = {}) {
+        throw new _errors.UnsupportedJobRepositoryOperationError('findJobExecutions');
+    }
+    findStepExecutions(_jobExecutionId) {
+        throw new _errors.UnsupportedJobRepositoryOperationError('findStepExecutions');
+    }
+};
+
+//# sourceMappingURL=job-repository.js.map

package/dist/src/core/repository/job-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/repository/job-repository.ts"],"sourcesContent":["import type {\n  JobInstance,\n  JobExecution,\n  JobExecutionPatch,\n  JobParameters,\n  StepExecution,\n  StepExecutionPatch,\n  ExecutionContext,\n  ExecutionScope,\n  JobInstanceFilter,\n  JobExecutionFilter,\n} from './types';\nimport { UnsupportedJobRepositoryOperationError } from '../errors';\n\nexport interface IJobRepository {\n  getOrCreateJobInstance(name: string, jobKey: string): Promise<JobInstance>;\n  createJobExecution(jobInstanceId: string, params: JobParameters): Promise<JobExecution>;\n  /**\n   * Atomically: ensure a `JobInstance` for `(name, jobKey)` exists, lock\n   * the instance row (skipping if another concurrent launch already\n   * holds the lock), verify no running execution, and create a new\n   * execution in STARTING state. The PostgreSQL implementation uses\n   * `INSERT ... ON CONFLICT DO NOTHING` + `SELECT ... FOR UPDATE SKIP\n   * LOCKED` inside a single transaction. The in-memory implementation\n   * uses an in-process mutex (Node is single-threaded so the lock is\n   * effectively a serialization point rather than a true blocker).\n   *\n   * Throws `JobExecutionAlreadyRunningError` if another launch is in\n   * progress (FOR UPDATE returned no row) or if an execution is already\n   * STARTING/STARTED for this instance.\n   */\n  createExecutionAtomic(\n    name: string,\n    jobKey: string,\n    params: JobParameters,\n  ): Promise<JobExecution>;\n  updateJobExecution(executionId: string, patch: JobExecutionPatch): Promise<void>;\n  getJobExecution(executionId: string): Promise<JobExecution | null>;\n  getJobInstance(jobInstanceId: string): Promise<JobInstance | null>;\n  findJobInstances(filter?: JobInstanceFilter): Promise<JobInstance[]>;\n  findJobExecutions(filter?: JobExecutionFilter): Promise<JobExecution[]>;\n  getRunningJobExecution(jobInstanceId: string): Promise<JobExecution | null>;\n  createStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution>;\n  updateStepExecution(stepExecutionId: string, patch: StepExecutionPatch): Promise<void>;\n  getStepExecution(stepExecutionId: string): Promise<StepExecution | null>;\n  findStepExecutions(jobExecutionId: string): Promise<StepExecution[]>;\n  getExecutionContext(scope: ExecutionScope): Promise<ExecutionContext>;\n  saveExecutionContext(\n    scope: ExecutionScope,\n    ctx: ExecutionContext,\n    version?: number,\n  ): Promise<void>;\n  /**\n   * Find the most recently created StepExecution for a given\n   * (jobExecutionId, stepName) pair regardless of status. Returns `null`\n   * if no matching step execution exists. Used by the restart path to\n   * locate the prior (typically FAILED) step execution so its execution\n   * context — which holds the last-committed-chunk checkpoint — can be\n   * loaded.\n   */\n  findLatestStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution | null>;\n}\n\nexport abstract class JobRepository implements IJobRepository {\n  abstract getOrCreateJobInstance(name: string, jobKey: string): Promise<JobInstance>;\n  abstract createJobExecution(jobInstanceId: string, params: JobParameters): Promise<JobExecution>;\n  abstract createExecutionAtomic(\n    name: string,\n    jobKey: string,\n    params: JobParameters,\n  ): Promise<JobExecution>;\n  abstract updateJobExecution(executionId: string, patch: JobExecutionPatch): Promise<void>;\n  abstract getJobExecution(executionId: string): Promise<JobExecution | null>;\n  getJobInstance(_jobInstanceId: string): Promise<JobInstance | null> {\n    throw new UnsupportedJobRepositoryOperationError('getJobInstance');\n  }\n  findJobInstances(_filter: JobInstanceFilter = {}): Promise<JobInstance[]> {\n    throw new UnsupportedJobRepositoryOperationError('findJobInstances');\n  }\n  findJobExecutions(_filter: JobExecutionFilter = {}): Promise<JobExecution[]> {\n    throw new UnsupportedJobRepositoryOperationError('findJobExecutions');\n  }\n  abstract getRunningJobExecution(jobInstanceId: string): Promise<JobExecution | null>;\n  abstract createStepExecution(jobExecutionId: string, stepName: string): Promise<StepExecution>;\n  abstract updateStepExecution(stepExecutionId: string, patch: StepExecutionPatch): Promise<void>;\n  abstract getStepExecution(stepExecutionId: string): Promise<StepExecution | null>;\n  findStepExecutions(_jobExecutionId: string): Promise<StepExecution[]> {\n    throw new UnsupportedJobRepositoryOperationError('findStepExecutions');\n  }\n  abstract getExecutionContext(scope: ExecutionScope): Promise<ExecutionContext>;\n  abstract saveExecutionContext(\n    scope: ExecutionScope,\n    ctx: ExecutionContext,\n    version?: number,\n  ): Promise<void>;\n  abstract findLatestStepExecution(\n    jobExecutionId: string,\n    stepName: string,\n  ): Promise<StepExecution | null>;\n}\n"],"names":["JobRepository","getJobInstance","_jobInstanceId","UnsupportedJobRepositoryOperationError","findJobInstances","_filter","findJobExecutions","findStepExecutions","_jobExecutionId"],"mappings":";;;;+BA+DsBA;;;eAAAA;;;wBAnDiC;AAmDhD,IAAA,AAAeA,gBAAf,MAAeA;IAUpBC,eAAeC,cAAsB,EAA+B;QAClE,MAAM,IAAIC,8CAAsC,CAAC;IACnD;IACAC,iBAAiBC,UAA6B,CAAC,CAAC,EAA0B;QACxE,MAAM,IAAIF,8CAAsC,CAAC;IACnD;IACAG,kBAAkBD,UAA8B,CAAC,CAAC,EAA2B;QAC3E,MAAM,IAAIF,8CAAsC,CAAC;IACnD;IAKAI,mBAAmBC,eAAuB,EAA4B;QACpE,MAAM,IAAIL,8CAAsC,CAAC;IACnD;AAWF"}