tubeless 0.2.5 → 0.2.7

package/README.md

@@ -36,8 +36,8 @@ Tubeless is pre-1.0, so the public API may change between releases.
 
 ## Quick start
 
-This pipeline loads a list of strings, normalizes them, and returns the result.
-Declaring `load` as a dependency gives `normalize` a typed input.
+This pipeline loads and normalizes strings. `step` creates a step; dependencies give typed
+inputs. Adding `skip` makes it skippable and widens its output to include `undefined`.
 
 ```ts
 import { createSteps, definePipeline, requireOutputs } from "tubeless";
@@ -46,7 +46,7 @@ interface ImportOptions {
   lines: readonly string[];
 }
 
-const step = createSteps<ImportOptions>();
+const { step } = createSteps<ImportOptions>();
 
 const load = step("load", {
   run: (_inputs, context) => context.options.lines,

package/dist/core/pipeline-steps.d.ts

@@ -117,67 +117,6 @@ type PlainStepFields<TOptions extends object, TDeps extends readonly AnyStep<TOp
 type SchemaStepFields<TOptions extends object, TDeps extends readonly AnyStep<TOptions>[], TOptionalDeps extends readonly AnyStep<TOptions>[], TSchema extends StandardSchemaV1> = Omit<PlainStepFields<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>, "outputSchema"> & {
     outputSchema: TSchema;
 };
-interface StepConstructor<TOptions extends object, TInputOptions extends object = TOptions> {
-    /** Ordinary steps never policy-skip, so dependents receive their full output. */
-    <TId extends string, TSchema extends StandardSchemaV1, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & {
-        skip?: never;
-    }): Step<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;
-    <TId extends string, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = [], TOut = unknown>(id: TId, definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & {
-        skip?: never;
-    }): Step<TId, TOut, TOptions, TInputOptions>;
-    /** Explicit policy-skip constructor; dependents receive `TOut | undefined`. */
-    skippable: SkippableStepConstructor<TOptions, TInputOptions>;
-}
-interface SkippableStepConstructor<TOptions extends object, TInputOptions extends object = TOptions> {
-    <TId extends string, TSchema extends StandardSchemaV1, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & {
-        skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>> | undefined;
-    }): Step<TId, InferSchemaOutput<TSchema> | undefined, TOptions, TInputOptions, InferSchemaInput<TSchema>>;
-    <TId extends string, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = [], TOut = unknown>(id: TId, definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & {
-        skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, TOut> | undefined;
-    }): Step<TId, TOut | undefined, TOptions, TInputOptions>;
-}
-interface FromPipelineConstructor<TOptions extends object, TInputOptions extends object = TOptions> {
-    <TId extends string, TChildPipeline extends Pipeline<object, unknown>, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
-        skip?: never;
-        mapResult?: undefined;
-    }): Step<TId, PipelineResultOf<TChildPipeline>, TOptions, TInputOptions>;
-    <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TOut, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
-        skip?: never;
-        mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, context: PipelineStepContext<TOptions>): TOut;
-    }): Step<TId, Awaited<TOut>, TOptions, TInputOptions>;
-    skippable: SkippableFromPipelineConstructor<TOptions, TInputOptions>;
-}
-interface SkippableFromPipelineConstructor<TOptions extends object, TInputOptions extends object = TOptions> {
-    <TId extends string, TChildPipeline extends Pipeline<object, unknown>, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
-        skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, PipelineResultOf<TChildPipeline>> | undefined;
-        mapResult?: undefined;
-    }): Step<TId, PipelineResultOf<TChildPipeline> | undefined, TOptions, TInputOptions>;
-    <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TOut, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
-        skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<Awaited<TOut>>> | undefined;
-        mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, context: PipelineStepContext<TOptions>): TOut;
-    }): Step<TId, Awaited<TOut> | undefined, TOptions, TInputOptions>;
-}
-interface ForEachPipelineConstructor<TOptions extends object, TInputOptions extends object = TOptions> {
-    <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TItem, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: MappedChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline, TItem> & {
-        skip?: never;
-        mapResult?: undefined;
-    }): Step<TId, readonly PipelineResultOf<TChildPipeline>[], TOptions, TInputOptions>;
-    <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TItem, TOut, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: MappedChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline, TItem> & {
-        skip?: never;
-        mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, item: TItem, index: number, context: PipelineStepContext<TOptions>): TOut;
-    }): Step<TId, readonly TOut[], TOptions, TInputOptions>;
-    skippable: SkippableForEachPipelineConstructor<TOptions, TInputOptions>;
-}
-interface SkippableForEachPipelineConstructor<TOptions extends object, TInputOptions extends object = TOptions> {
-    <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TItem, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: MappedChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline, TItem> & {
-        skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, readonly PipelineResultOf<TChildPipeline>[]> | undefined;
-        mapResult?: undefined;
-    }): Step<TId, readonly PipelineResultOf<TChildPipeline>[] | undefined, TOptions, TInputOptions>;
-    <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TItem, TOut, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: MappedChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline, TItem> & {
-        skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<readonly TOut[]>> | undefined;
-        mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, item: TItem, index: number, context: PipelineStepContext<TOptions>): TOut;
-    }): Step<TId, readonly TOut[] | undefined, TOptions, TInputOptions>;
-}
 type RemoteStepDefinitionBase<TParentOptions extends object, TDeps extends readonly AnyStep<TParentOptions>[], TOptionalDeps extends readonly AnyStep<TParentOptions>[], TPayload, TSchema extends StandardSchemaV1> = {
     adapter: RemoteStepAdapter<TParentOptions, TPayload, InferSchemaInput<TSchema>>;
     mapInput(inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>, context: PipelineStepContext<TParentOptions>): TPayload;
@@ -189,22 +128,7 @@ type RemoteStepDefinitionBase<TParentOptions extends object, TDeps extends reado
     description?: string;
     dryRun?: StepDryRunPolicy<TParentOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>;
 };
-interface FromRemoteConstructor<TOptions extends object, TInputOptions extends object = TOptions> {
-    <TId extends string, TSchema extends StandardSchemaV1, TPayload, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {
-        skip?: never;
-    }): Step<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;
-    skippable: SkippableFromRemoteConstructor<TOptions, TInputOptions>;
-}
-interface SkippableFromRemoteConstructor<TOptions extends object, TInputOptions extends object = TOptions> {
-    <TId extends string, TSchema extends StandardSchemaV1, TPayload, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {
-        skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>> | undefined;
-    }): Step<TId, InferSchemaOutput<TSchema> | undefined, TOptions, TInputOptions, InferSchemaInput<TSchema>>;
-}
-export interface StepFactory<TOptions extends object, TInputOptions extends object = TOptions> extends StepConstructor<TOptions, TInputOptions> {
-    fromPipeline: FromPipelineConstructor<TOptions, TInputOptions>;
-    fromRemote: FromRemoteConstructor<TOptions, TInputOptions>;
-    forEachPipeline: ForEachPipelineConstructor<TOptions, TInputOptions>;
-}
+export type StepFactory<TOptions extends object, TInputOptions extends object = TOptions> = ReturnType<typeof createStepFactory<TOptions, TInputOptions>>;
 /**
  * Returns a step factory scoped to one pipeline's domain options. Pass built-in
  * run controls as the second argument to `run` / `runOrThrow`. Child
@@ -212,4 +136,64 @@ export interface StepFactory<TOptions extends object, TInputOptions extends obje
  */
 export declare function createSteps<TOptions extends object = {}>(): StepFactory<TOptions>;
 export declare function createSteps<const TSchema extends StandardSchemaV1<object, object>>(optionsSchema: TSchema): StepFactory<InferSchemaOutput<TSchema>, InferSchemaInput<TSchema>>;
+declare function createStepFactory<TOptions extends object, TInputOptions extends object = TOptions>(optionsSchema?: StandardSchemaV1): {
+    step: {
+        <TId extends string, TSchema extends StandardSchemaV1, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & {
+            skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>> | undefined;
+        }): Step<TId, InferSchemaOutput<TSchema> | undefined, TOptions, TInputOptions, InferSchemaInput<TSchema>>;
+        <TId extends string, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = [], TOut = unknown>(id: TId, definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & {
+            skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, TOut> | undefined;
+        }): Step<TId, TOut | undefined, TOptions, TInputOptions>;
+        <TId extends string, TSchema extends StandardSchemaV1, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & {
+            skip?: never;
+        }): Step<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;
+        <TId extends string, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = [], TOut = unknown>(id: TId, definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & {
+            skip?: never;
+        }): Step<TId, TOut, TOptions, TInputOptions>;
+    };
+    fromPipeline: {
+        <TId extends string, TChildPipeline extends Pipeline<object, unknown>, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
+            skip?: never;
+            mapResult?: undefined;
+        }): Step<TId, PipelineResultOf<TChildPipeline>, TOptions, TInputOptions>;
+        <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TOut, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
+            skip?: never;
+            mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, context: PipelineStepContext<TOptions>): TOut;
+        }): Step<TId, Awaited<TOut>, TOptions, TInputOptions>;
+        <TId extends string, TChildPipeline extends Pipeline<object, unknown>, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
+            skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, PipelineResultOf<TChildPipeline>> | undefined;
+            mapResult?: undefined;
+        }): Step<TId, PipelineResultOf<TChildPipeline> | undefined, TOptions, TInputOptions>;
+        <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TOut, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
+            skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<Awaited<TOut>>> | undefined;
+            mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, context: PipelineStepContext<TOptions>): TOut;
+        }): Step<TId, Awaited<TOut> | undefined, TOptions, TInputOptions>;
+    };
+    fromRemote: {
+        <TId extends string, TSchema extends StandardSchemaV1, TPayload, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {
+            skip?: never;
+        }): Step<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;
+        <TId extends string, TSchema extends StandardSchemaV1, TPayload, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {
+            skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>> | undefined;
+        }): Step<TId, InferSchemaOutput<TSchema> | undefined, TOptions, TInputOptions, InferSchemaInput<TSchema>>;
+    };
+    forEachPipeline: {
+        <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TItem, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: MappedChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline, TItem> & {
+            skip?: never;
+            mapResult?: undefined;
+        }): Step<TId, readonly PipelineResultOf<TChildPipeline>[], TOptions, TInputOptions>;
+        <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TItem, TOut, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: MappedChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline, TItem> & {
+            skip?: never;
+            mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, item: TItem, index: number, context: PipelineStepContext<TOptions>): TOut;
+        }): Step<TId, readonly TOut[], TOptions, TInputOptions>;
+        <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TItem, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: MappedChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline, TItem> & {
+            skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, readonly PipelineResultOf<TChildPipeline>[]> | undefined;
+            mapResult?: undefined;
+        }): Step<TId, readonly PipelineResultOf<TChildPipeline>[] | undefined, TOptions, TInputOptions>;
+        <TId extends string, TChildPipeline extends Pipeline<object, unknown>, TItem, TOut, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: MappedChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline, TItem> & {
+            skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<readonly TOut[]>> | undefined;
+            mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, item: TItem, index: number, context: PipelineStepContext<TOptions>): TOut;
+        }): Step<TId, readonly TOut[] | undefined, TOptions, TInputOptions>;
+    };
+};
 export {};

package/dist/core/pipeline-steps.js

@@ -1,24 +1,21 @@
-import { createMappedChildRunner, createSingleChildRunner, } from "./child-execution.js";
+import { createMappedChildRunner, createSingleChildRunner } from "./child-execution.js";
 import { isPipelineCancellation, PipelineExecutionError } from "./pipeline-execute.js";
 import { STEP_NESTED_PIPELINE, STEP_OPTIONS_SCHEMA, STEP_REMOTE, } from "./pipeline-step-metadata.js";
 export function createSteps(optionsSchema) {
     return createStepFactory(optionsSchema);
 }
 function createStepFactory(optionsSchema) {
-    // Runtime construction is deliberately simple; the public factory owns the
-    // distinction between ordinary and explicitly skippable constructors.
     const buildStep = (id, definition) => {
-        // SAFETY: `definition` carries the step's own fields; spreading it onto the
-        // id-bearing shell yields a value whose shape matches `AnyStep<TOptions>`.
         const built = { id, ...definition };
         if (optionsSchema) {
             Object.defineProperty(built, STEP_OPTIONS_SCHEMA, { value: optionsSchema });
         }
         return built;
     };
-    // SAFETY: the closure's parameter and return shapes match the
-    // `fromPipeline` constructor signature it is assigned to.
-    const fromPipeline = ((id, config) => {
+    function step(id, definition) {
+        return buildStep(id, definition);
+    }
+    const buildPipelineStep = (id, config) => {
         const definition = {
             [STEP_NESTED_PIPELINE]: {
                 mode: "single",
@@ -31,9 +28,6 @@ function createStepFactory(optionsSchema) {
             name: config.name,
             description: config.description,
             dryRun: config.dryRun,
-            // SAFETY: the config carries `pipeline` and `mapResult`; the runner
-            // derives `mapOptions` from the same fields, so the config is a valid
-            // single-child execution config at runtime.
             run: createSingleChildRunner(config, {
                 createExecutionError: (result, message) => new PipelineExecutionError(result, message),
                 isCancellation: (error, childContext) => isPipelineCancellation(error, childContext),
@@ -41,14 +35,14 @@ function createStepFactory(optionsSchema) {
         };
         const skip = config.skip;
         if (skip !== undefined) {
-            // SAFETY: each constructor preserves the skip predicate's dependency inputs and context.
-            definition.skip = (inputs, context) => skip(inputs, context);
+            definition.skip = skip;
         }
         return buildStep(id, definition);
-    });
-    // SAFETY: the closure's parameter and return shapes match the
-    // `fromRemote` constructor signature it is assigned to.
-    const fromRemote = ((id, config) => {
+    };
+    function fromPipeline(id, definition) {
+        return buildPipelineStep(id, definition);
+    }
+    const buildRemoteStep = (id, config) => {
         const remote = { engine: config.adapter.engine };
         if (config.adapter.target !== undefined)
             remote.target = config.adapter.target;
@@ -65,14 +59,14 @@ function createStepFactory(optionsSchema) {
         };
         const skip = config.skip;
         if (skip !== undefined) {
-            // SAFETY: each constructor preserves the skip predicate's dependency inputs and context.
-            definition.skip = (inputs, context) => skip(inputs, context);
+            definition.skip = skip;
         }
         return buildStep(id, definition);
-    });
-    // SAFETY: the closure's parameter and return shapes match the
-    // `forEachPipeline` constructor signature it is assigned to.
-    const forEachPipeline = ((id, config) => {
+    };
+    function fromRemote(id, definition) {
+        return buildRemoteStep(id, definition);
+    }
+    const buildMappedPipelineStep = (id, config) => {
         const definition = {
             [STEP_NESTED_PIPELINE]: {
                 mode: "for-each",
@@ -85,9 +79,6 @@ function createStepFactory(optionsSchema) {
             name: config.name,
             description: config.description,
             dryRun: config.dryRun,
-            // SAFETY: the config carries `pipeline`, `items`, `key`, and `mapResult`;
-            // the runner derives the rest from those fields, so the config is a valid
-            // mapped-child execution config at runtime.
             run: createMappedChildRunner(config, {
                 createExecutionError: (result, message) => new PipelineExecutionError(result, message),
                 isCancellation: (error, childContext) => isPipelineCancellation(error, childContext),
@@ -95,29 +86,19 @@ function createStepFactory(optionsSchema) {
         };
         const skip = config.skip;
         if (skip !== undefined) {
-            // SAFETY: each constructor preserves the skip predicate's dependency inputs and context.
-            definition.skip = (inputs, context) => skip(inputs, context);
+            definition.skip = skip;
         }
         return buildStep(id, definition);
-    });
-    // SAFETY: `buildStep` is a callable; attaching the constructor properties
-    // yields exactly the `StepFactory` surface (call + skippable + fromPipeline +
-    // forEachPipeline), so the single assertion is sound.
-    const factory = Object.assign(buildStep, {
-        skippable: buildStep,
+    };
+    function forEachPipeline(id, definition) {
+        return buildMappedPipelineStep(id, definition);
+    }
+    const factory = {
+        step,
         fromPipeline,
         fromRemote,
         forEachPipeline,
-    });
-    // SAFETY: `fromPipeline` is the same callable as `factory.fromPipeline`; it
-    // carries the skippable variant, so the assignment is sound.
-    factory.fromPipeline.skippable = fromPipeline;
-    // SAFETY: `fromRemote` is the same callable as `factory.fromRemote`; it
-    // carries the skippable variant, so the assignment is sound.
-    factory.fromRemote.skippable = fromRemote;
-    // SAFETY: `forEachPipeline` is the same callable as `factory.forEachPipeline`;
-    // it carries the skippable variant, so the assignment is sound.
-    factory.forEachPipeline.skippable = forEachPipeline;
+    };
     return factory;
 }
 //# sourceMappingURL=pipeline-steps.js.map

package/dist/core/pipeline-steps.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-steps.js","sourceRoot":"","sources":["../../src/core/pipeline-steps.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GAGxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,GACZ,MAAM,6BAA6B,CAAC;AA+jBrC,MAAM,UAAU,WAAW,CAAC,aAAgD;IAC1E,OAAO,iBAAiB,CAAS,aAAa,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CACxB,aAAgC;IAEhC,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,SAAS,GAAG,CAAC,EAAU,EAAE,UAAwC,EAAqB,EAAE;QAC5F,4EAA4E;QAC5E,2EAA2E;QAC3E,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,GAAG,UAAU,EAAuB,CAAC;QACzD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,8DAA8D;IAC9D,0DAA0D;IAC1D,MAAM,YAAY,GAAG,CAAC,CACpB,EAAU,EACV,MAiBC,EACD,EAAE;QACF,MAAM,UAAU,GAAiC;YAC/C,CAAC,oBAAoB,CAAC,EAAE;gBACtB,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;gBAC9B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;aACjC;YACD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,oEAAoE;YACpE,sEAAsE;YACtE,4CAA4C;YAC5C,GAAG,EAAE,uBAAuB,CAAC,MAA8C,EAAE;gBAC3E,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC;gBACtF,cAAc,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC;aACrF,CAAC;SACH,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,yFAAyF;YACzF,UAAU,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAe,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC,CAAyD,CAAC;IAE3D,8DAA8D;IAC9D,wDAAwD;IACxD,MAAM,UAAU,GAAG,CAAC,CAClB,EAAU,EACV,MAmBC,EACD,EAAE;QACF,MAAM,MAAM,GAA4C,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1F,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/E,MAAM,UAAU,GAAiC;YAC/C,CAAC,WAAW,CAAC,EAAE,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,GAAG,EAAE,CAAC,MAA+B,EAAE,OAAsC,EAAE,EAAE,CAC/E,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC;SACnE,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,yFAAyF;YACzF,UAAU,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAe,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC,CAAuD,CAAC;IAEzD,8DAA8D;IAC9D,6DAA6D;IAC7D,MAAM,eAAe,GAAG,CAAC,CACvB,EAAU,EACV,MAoBC,EACD,EAAE;QACF,MAAM,UAAU,GAAiC;YAC/C,CAAC,oBAAoB,CAAC,EAAE;gBACtB,IAAI,EAAE,UAAmB;gBACzB,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;gBAC9B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;aACjC;YACD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,0EAA0E;YAC1E,0EAA0E;YAC1E,4CAA4C;YAC5C,GAAG,EAAE,uBAAuB,CAAC,MAA8C,EAAE;gBAC3E,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC;gBACtF,cAAc,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC;aACrF,CAAC;SACH,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,yFAAyF;YACzF,UAAU,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAe,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC,CAA4D,CAAC;IAE9D,0EAA0E;IAC1E,8EAA8E;IAC9E,sDAAsD;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;QACvC,SAAS,EAAE,SAAS;QACpB,YAAY;QACZ,UAAU;QACV,eAAe;KAChB,CAAyC,CAAC;IAC3C,4EAA4E;IAC5E,6DAA6D;IAC7D,OAAO,CAAC,YAAY,CAAC,SAAS,GAAG,YAGH,CAAC;IAC/B,wEAAwE;IACxE,6DAA6D;IAC7D,OAAO,CAAC,UAAU,CAAC,SAAS,GAAG,UAGH,CAAC;IAC7B,+EAA+E;IAC/E,gEAAgE;IAChE,OAAO,CAAC,eAAe,CAAC,SAAS,GAAG,eAGH,CAAC;IAElC,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import {\n  createMappedChildRunner,\n  createSingleChildRunner,\n  type MappedChildExecutionConfig,\n  type SingleChildExecutionConfig,\n} from \"./child-execution.js\";\nimport type { ToMappedChildStepProgressOptions } from \"./mapped-child-progress.js\";\nimport { isPipelineCancellation, PipelineExecutionError } from \"./pipeline-execute.js\";\nimport {\n  STEP_NESTED_PIPELINE,\n  STEP_OPTIONS_SCHEMA,\n  STEP_REMOTE,\n} from \"./pipeline-step-metadata.js\";\nimport type {\n  InferSchemaInput,\n  InferSchemaOutput,\n  Pipeline,\n  PipelineExecutionContext,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunOptions,\n  PipelineStepContext,\n  RemoteStepAdapter,\n  StandardSchemaV1,\n  StepSkipDecision,\n} from \"./pipeline-types.js\";\n\n/**\n * A step's dependencies are references to the dependency's own step object, not string ids\n * into a hand-maintained output-type map. This buys two things no amount of extra generics\n * on a string-keyed design could:\n *  - a step used before its dependency exists is a compile error (JS temporal dead zone on\n *    `const`), so out-of-order and self/cyclic dependencies are caught by the language, not\n *    a bespoke runtime check\n *  - each step only ever states its own id/deps; the output-type map is derived, never\n *    restated, and callers of `definePipeline`/`createSteps` never write out its generics\n */\ntype AnyStepDryRunHandler<TOptions extends object> = {\n  bivarianceHack(\n    inputs: Record<string, unknown>,\n    context: PipelineStepContext<TOptions>\n  ): unknown | Promise<unknown>;\n}[\"bivarianceHack\"];\n\nexport interface AnyStep<TOptions extends object = object> {\n  readonly [STEP_NESTED_PIPELINE]?: NonNullable<PipelinePlanStep[\"nestedPipeline\"]>;\n  readonly [STEP_REMOTE]?: NonNullable<PipelinePlanStep[\"remote\"]>;\n  readonly [STEP_OPTIONS_SCHEMA]?: StandardSchemaV1;\n  readonly id: string;\n  readonly dependsOn?: readonly AnyStep<TOptions>[];\n  readonly optionalDependsOn?: readonly AnyStep<TOptions>[];\n  readonly skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n  /** Optional human-facing display name. Stable machine identity remains `id`. */\n  readonly name?: string;\n  readonly description?: string;\n  /**\n   * Dry-run policy. Omitted runs the normal handler, `\"skip\"` structurally\n   * skips it, and a handler substitutes for `run` while preserving its output.\n   */\n  readonly dryRun?: \"skip\" | AnyStepDryRunHandler<TOptions>;\n  /** Optional Standard Schema for values published by this step. */\n  readonly outputSchema?: StandardSchemaV1;\n  /**\n   * Optional runtime skip. Return a non-empty reason (or `{ reason, value }`) to\n   * skip without calling `run`. Policy skips unlock dependents; structural skips\n   * (dry-run, filtered, …) do not use this hook.\n   */\n  skip?(\n    inputs: Record<string, unknown>,\n    context: PipelineExecutionContext<TOptions>\n  ): StepSkipDecision | Promise<StepSkipDecision>;\n  run(inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>): unknown;\n}\n\n/** The step fields that `buildStep` merges onto the id-bearing shell. */\ntype StepDefinitionBody<TOptions extends object> = Omit<AnyStep<TOptions>, \"id\">;\n\nexport interface Step<\n  TId extends string,\n  TOut,\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n  TRunOut = TOut,\n> extends AnyStep<TOptions> {\n  readonly id: TId;\n  run(\n    inputs: Record<string, unknown>,\n    context: PipelineStepContext<TOptions>\n  ): TRunOut | Promise<TRunOut>;\n  /** Type-only: carries this step's output type for sibling inference. Never set at runtime. */\n  readonly __outputType?: TOut;\n  /** Type-only: carries pre-validation run options for pipeline call-site inference. */\n  readonly __inputOptionsType?: TInputOptions;\n}\n\n/**\n * Extract a step's output type for dependency typing.\n * Prefer matching `Step<…, TOut, …>` over `{ __outputType?: infer T }`: optional-property\n * inference collapses `TOut | undefined` to `TOut`, which hides policy-skip widening.\n */\nexport type StepOutput<S> =\n  S extends Step<string, infer TOut, infer _TOptions, infer _TInputOptions, infer _TRunOut>\n    ? TOut\n    : never;\n\ninterface StepToken {\n  readonly id: string;\n  readonly __outputType?: unknown;\n}\n\ntype RequiredInputs<TDeps extends readonly StepToken[]> = {\n  [S in TDeps[number] as S[\"id\"]]: StepOutput<S>;\n};\n\ntype OptionalInputs<TDeps extends readonly StepToken[]> = {\n  [S in TDeps[number] as S[\"id\"]]?: StepOutput<S>;\n};\n\ntype PipelineResultOf<TPipeline> =\n  TPipeline extends Pipeline<object, infer TResult, infer _TStepId, infer _TTargetId>\n    ? TResult\n    : never;\n\ntype PipelineRunOptionsOf<TPipeline> =\n  TPipeline extends Pipeline<infer TOptions, unknown, infer TStepId, infer TTargetId>\n    ? PipelineRunOptions<TOptions, TStepId, TTargetId>\n    : never;\n\ntype ChildPipelineStepDefinitionBase<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n> = {\n  pipeline: TChildPipeline;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: \"skip\";\n  mapOptions(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineRunOptionsOf<TChildPipeline>;\n};\n\n/** Child step without policy skip (dependents see the full child result type). */\ntype ChildPipelineStepDefinition<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n> = ChildPipelineStepDefinitionBase<TParentOptions, TDeps, TOptionalDeps, TChildPipeline>;\n\n/**\n * Presentation options for opaque `forEachPipeline` progress.\n * Defaults are domain-neutral (`N/M items · K running · key/step`).\n * Override `formatMessage` when a domain wants its own noun (images, shards, …).\n */\nexport type MappedChildProgressOptions = ToMappedChildStepProgressOptions;\n\ntype MappedChildPipelineStepDefinition<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n  TItem,\n> = {\n  pipeline: TChildPipeline;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: \"skip\";\n  items(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): readonly TItem[] | Promise<readonly TItem[]>;\n  key(item: TItem, index: number): string;\n  concurrency?:\n    | number\n    | ((\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => number);\n  /**\n   * How the opaque parent step reports live fan-out progress.\n   * Purely presentational — does not change scheduling or results.\n   */\n  progress?: MappedChildProgressOptions;\n  mapOptions(\n    item: TItem,\n    index: number,\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineRunOptionsOf<TChildPipeline>;\n};\n\ntype StepSkipPredicate<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> = (\n  inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n  context: PipelineExecutionContext<TOptions>\n) => StepSkipDecision<TOut> | Promise<StepSkipDecision<TOut>>;\n\ntype StepDryRunPolicy<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> =\n  | \"skip\"\n  | ((\n      inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n      context: PipelineStepContext<TOptions>\n    ) => TOut | Promise<TOut>);\n\ntype PlainStepFields<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> = {\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: StepDryRunPolicy<TOptions, TDeps, TOptionalDeps, TOut>;\n  outputSchema?: never;\n  run(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineStepContext<TOptions>\n  ): TOut | Promise<TOut>;\n};\n\ntype SchemaStepFields<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TSchema extends StandardSchemaV1,\n> = Omit<\n  PlainStepFields<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>,\n  \"outputSchema\"\n> & {\n  outputSchema: TSchema;\n};\n\ninterface StepConstructor<TOptions extends object, TInputOptions extends object = TOptions> {\n  /** Ordinary steps never policy-skip, so dependents receive their full output. */\n  <\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & { skip?: never }\n  ): Step<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;\n\n  <\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TOut = unknown,\n  >(\n    id: TId,\n    definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & { skip?: never }\n  ): Step<TId, TOut, TOptions, TInputOptions>;\n\n  /** Explicit policy-skip constructor; dependents receive `TOut | undefined`. */\n  skippable: SkippableStepConstructor<TOptions, TInputOptions>;\n}\n\ninterface SkippableStepConstructor<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n> {\n  <\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>\n        | undefined;\n    }\n  ): Step<\n    TId,\n    InferSchemaOutput<TSchema> | undefined,\n    TOptions,\n    TInputOptions,\n    InferSchemaInput<TSchema>\n  >;\n\n  <\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TOut = unknown,\n  >(\n    id: TId,\n    definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & {\n      skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, TOut> | undefined;\n    }\n  ): Step<TId, TOut | undefined, TOptions, TInputOptions>;\n}\n\ninterface FromPipelineConstructor<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n> {\n  <\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip?: never;\n      mapResult?: undefined;\n    }\n  ): Step<TId, PipelineResultOf<TChildPipeline>, TOptions, TInputOptions>;\n\n  <\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip?: never;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): Step<TId, Awaited<TOut>, TOptions, TInputOptions>;\n\n  skippable: SkippableFromPipelineConstructor<TOptions, TInputOptions>;\n}\n\ninterface SkippableFromPipelineConstructor<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n> {\n  <\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, PipelineResultOf<TChildPipeline>>\n        | undefined;\n      mapResult?: undefined;\n    }\n  ): Step<TId, PipelineResultOf<TChildPipeline> | undefined, TOptions, TInputOptions>;\n\n  <\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<Awaited<TOut>>> | undefined;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): Step<TId, Awaited<TOut> | undefined, TOptions, TInputOptions>;\n}\n\ninterface ForEachPipelineConstructor<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n> {\n  <\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip?: never;\n      mapResult?: undefined;\n    }\n  ): Step<TId, readonly PipelineResultOf<TChildPipeline>[], TOptions, TInputOptions>;\n\n  <\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip?: never;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        item: TItem,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): Step<TId, readonly TOut[], TOptions, TInputOptions>;\n\n  skippable: SkippableForEachPipelineConstructor<TOptions, TInputOptions>;\n}\n\ninterface SkippableForEachPipelineConstructor<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n> {\n  <\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip:\n        | StepSkipPredicate<\n            TOptions,\n            TDeps,\n            TOptionalDeps,\n            readonly PipelineResultOf<TChildPipeline>[]\n          >\n        | undefined;\n      mapResult?: undefined;\n    }\n  ): Step<TId, readonly PipelineResultOf<TChildPipeline>[] | undefined, TOptions, TInputOptions>;\n\n  <\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<readonly TOut[]>> | undefined;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        item: TItem,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): Step<TId, readonly TOut[] | undefined, TOptions, TInputOptions>;\n}\n\ntype RemoteStepDefinitionBase<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TPayload,\n  TSchema extends StandardSchemaV1,\n> = {\n  adapter: RemoteStepAdapter<TParentOptions, TPayload, InferSchemaInput<TSchema>>;\n  mapInput(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineStepContext<TParentOptions>\n  ): TPayload;\n  outputSchema: TSchema;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: StepDryRunPolicy<TParentOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>;\n};\n\ninterface FromRemoteConstructor<TOptions extends object, TInputOptions extends object = TOptions> {\n  <\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    TPayload,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {\n      skip?: never;\n    }\n  ): Step<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;\n\n  skippable: SkippableFromRemoteConstructor<TOptions, TInputOptions>;\n}\n\ninterface SkippableFromRemoteConstructor<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n> {\n  <\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    TPayload,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>\n        | undefined;\n    }\n  ): Step<\n    TId,\n    InferSchemaOutput<TSchema> | undefined,\n    TOptions,\n    TInputOptions,\n    InferSchemaInput<TSchema>\n  >;\n}\n\nexport interface StepFactory<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n> extends StepConstructor<TOptions, TInputOptions> {\n  fromPipeline: FromPipelineConstructor<TOptions, TInputOptions>;\n  fromRemote: FromRemoteConstructor<TOptions, TInputOptions>;\n  forEachPipeline: ForEachPipelineConstructor<TOptions, TInputOptions>;\n}\n\n/**\n * Returns a step factory scoped to one pipeline's domain options. Pass built-in\n * run controls as the second argument to `run` / `runOrThrow`. Child\n * `mapOptions` may still return domain options plus those controls.\n */\nexport function createSteps<TOptions extends object = {}>(): StepFactory<TOptions>;\nexport function createSteps<const TSchema extends StandardSchemaV1<object, object>>(\n  optionsSchema: TSchema\n): StepFactory<InferSchemaOutput<TSchema>, InferSchemaInput<TSchema>>;\nexport function createSteps(optionsSchema?: StandardSchemaV1<object, object>): StepFactory<object> {\n  return createStepFactory<object>(optionsSchema);\n}\n\nfunction createStepFactory<TOptions extends object, TInputOptions extends object = TOptions>(\n  optionsSchema?: StandardSchemaV1\n): StepFactory<TOptions, TInputOptions> {\n  // Runtime construction is deliberately simple; the public factory owns the\n  // distinction between ordinary and explicitly skippable constructors.\n  const buildStep = (id: string, definition: StepDefinitionBody<TOptions>): AnyStep<TOptions> => {\n    // SAFETY: `definition` carries the step's own fields; spreading it onto the\n    // id-bearing shell yields a value whose shape matches `AnyStep<TOptions>`.\n    const built = { id, ...definition } as AnyStep<TOptions>;\n    if (optionsSchema) {\n      Object.defineProperty(built, STEP_OPTIONS_SCHEMA, { value: optionsSchema });\n    }\n    return built;\n  };\n\n  // SAFETY: the closure's parameter and return shapes match the\n  // `fromPipeline` constructor signature it is assigned to.\n  const fromPipeline = ((\n    id: string,\n    config: ChildPipelineStepDefinitionBase<\n      TOptions,\n      readonly AnyStep<TOptions>[],\n      readonly AnyStep<TOptions>[],\n      Pipeline<object, unknown>\n    > & {\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n      mapResult?: (\n        value: unknown,\n        result: PipelineRun<unknown>,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n    }\n  ) => {\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"single\" as const,\n        pipelineId: config.pipeline.id,\n        stepIds: config.pipeline.stepIds,\n      },\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      // SAFETY: the config carries `pipeline` and `mapResult`; the runner\n      // derives `mapOptions` from the same fields, so the config is a valid\n      // single-child execution config at runtime.\n      run: createSingleChildRunner(config as SingleChildExecutionConfig<TOptions>, {\n        createExecutionError: (result, message) => new PipelineExecutionError(result, message),\n        isCancellation: (error, childContext) => isPipelineCancellation(error, childContext),\n      }),\n    };\n\n    const skip = config.skip;\n    if (skip !== undefined) {\n      // SAFETY: each constructor preserves the skip predicate's dependency inputs and context.\n      definition.skip = (inputs, context) => skip(inputs as never, context);\n    }\n    return buildStep(id, definition);\n  }) as StepFactory<TOptions, TInputOptions>[\"fromPipeline\"];\n\n  // SAFETY: the closure's parameter and return shapes match the\n  // `fromRemote` constructor signature it is assigned to.\n  const fromRemote = ((\n    id: string,\n    config: {\n      adapter: RemoteStepAdapter<object, unknown, unknown>;\n      mapInput: (\n        inputs: Record<string, unknown>,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n      outputSchema: StandardSchemaV1;\n      dependsOn?: readonly AnyStep<TOptions>[];\n      optionalDependsOn?: readonly AnyStep<TOptions>[];\n      skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n      name?: string;\n      description?: string;\n      dryRun?: \"skip\" | AnyStepDryRunHandler<TOptions>;\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n    }\n  ) => {\n    const remote: NonNullable<PipelinePlanStep[\"remote\"]> = { engine: config.adapter.engine };\n    if (config.adapter.target !== undefined) remote.target = config.adapter.target;\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_REMOTE]: remote,\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      outputSchema: config.outputSchema,\n      run: (inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>) =>\n        config.adapter.invoke(config.mapInput(inputs, context), context),\n    };\n    const skip = config.skip;\n    if (skip !== undefined) {\n      // SAFETY: each constructor preserves the skip predicate's dependency inputs and context.\n      definition.skip = (inputs, context) => skip(inputs as never, context);\n    }\n    return buildStep(id, definition);\n  }) as StepFactory<TOptions, TInputOptions>[\"fromRemote\"];\n\n  // SAFETY: the closure's parameter and return shapes match the\n  // `forEachPipeline` constructor signature it is assigned to.\n  const forEachPipeline = ((\n    id: string,\n    config: MappedChildPipelineStepDefinition<\n      TOptions,\n      readonly AnyStep<TOptions>[],\n      readonly AnyStep<TOptions>[],\n      Pipeline<object, unknown>,\n      unknown\n    > & {\n      mapResult?: (\n        value: unknown,\n        result: PipelineRun<unknown>,\n        item: unknown,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n    }\n  ) => {\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"for-each\" as const,\n        pipelineId: config.pipeline.id,\n        stepIds: config.pipeline.stepIds,\n      },\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      // SAFETY: the config carries `pipeline`, `items`, `key`, and `mapResult`;\n      // the runner derives the rest from those fields, so the config is a valid\n      // mapped-child execution config at runtime.\n      run: createMappedChildRunner(config as MappedChildExecutionConfig<TOptions>, {\n        createExecutionError: (result, message) => new PipelineExecutionError(result, message),\n        isCancellation: (error, childContext) => isPipelineCancellation(error, childContext),\n      }),\n    };\n\n    const skip = config.skip;\n    if (skip !== undefined) {\n      // SAFETY: each constructor preserves the skip predicate's dependency inputs and context.\n      definition.skip = (inputs, context) => skip(inputs as never, context);\n    }\n    return buildStep(id, definition);\n  }) as StepFactory<TOptions, TInputOptions>[\"forEachPipeline\"];\n\n  // SAFETY: `buildStep` is a callable; attaching the constructor properties\n  // yields exactly the `StepFactory` surface (call + skippable + fromPipeline +\n  // forEachPipeline), so the single assertion is sound.\n  const factory = Object.assign(buildStep, {\n    skippable: buildStep,\n    fromPipeline,\n    fromRemote,\n    forEachPipeline,\n  }) as StepFactory<TOptions, TInputOptions>;\n  // SAFETY: `fromPipeline` is the same callable as `factory.fromPipeline`; it\n  // carries the skippable variant, so the assignment is sound.\n  factory.fromPipeline.skippable = fromPipeline as StepFactory<\n    TOptions,\n    TInputOptions\n  >[\"fromPipeline\"][\"skippable\"];\n  // SAFETY: `fromRemote` is the same callable as `factory.fromRemote`; it\n  // carries the skippable variant, so the assignment is sound.\n  factory.fromRemote.skippable = fromRemote as StepFactory<\n    TOptions,\n    TInputOptions\n  >[\"fromRemote\"][\"skippable\"];\n  // SAFETY: `forEachPipeline` is the same callable as `factory.forEachPipeline`;\n  // it carries the skippable variant, so the assignment is sound.\n  factory.forEachPipeline.skippable = forEachPipeline as StepFactory<\n    TOptions,\n    TInputOptions\n  >[\"forEachPipeline\"][\"skippable\"];\n\n  return factory;\n}\n"]}
+{"version":3,"file":"pipeline-steps.js","sourceRoot":"","sources":["../../src/core/pipeline-steps.ts"],"names":[],"mappings":"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","sourcesContent":["import { createMappedChildRunner, createSingleChildRunner } from \"./child-execution.js\";\nimport type { ToMappedChildStepProgressOptions } from \"./mapped-child-progress.js\";\nimport { isPipelineCancellation, PipelineExecutionError } from \"./pipeline-execute.js\";\nimport {\n  STEP_NESTED_PIPELINE,\n  STEP_OPTIONS_SCHEMA,\n  STEP_REMOTE,\n} from \"./pipeline-step-metadata.js\";\nimport type {\n  InferSchemaInput,\n  InferSchemaOutput,\n  Pipeline,\n  PipelineExecutionContext,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunOptions,\n  PipelineStepContext,\n  RemoteStepAdapter,\n  StandardSchemaV1,\n  StepSkipDecision,\n} from \"./pipeline-types.js\";\n\n/**\n * A step's dependencies are references to the dependency's own step object, not string ids\n * into a hand-maintained output-type map. This buys two things no amount of extra generics\n * on a string-keyed design could:\n *  - a step used before its dependency exists is a compile error (JS temporal dead zone on\n *    `const`), so out-of-order and self/cyclic dependencies are caught by the language, not\n *    a bespoke runtime check\n *  - each step only ever states its own id/deps; the output-type map is derived, never\n *    restated, and callers of `definePipeline`/`createSteps` never write out its generics\n */\ntype AnyStepDryRunHandler<TOptions extends object> = {\n  bivarianceHack(\n    inputs: Record<string, unknown>,\n    context: PipelineStepContext<TOptions>\n  ): unknown | Promise<unknown>;\n}[\"bivarianceHack\"];\n\nexport interface AnyStep<TOptions extends object = object> {\n  readonly [STEP_NESTED_PIPELINE]?: NonNullable<PipelinePlanStep[\"nestedPipeline\"]>;\n  readonly [STEP_REMOTE]?: NonNullable<PipelinePlanStep[\"remote\"]>;\n  readonly [STEP_OPTIONS_SCHEMA]?: StandardSchemaV1;\n  readonly id: string;\n  readonly dependsOn?: readonly AnyStep<TOptions>[];\n  readonly optionalDependsOn?: readonly AnyStep<TOptions>[];\n  readonly skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n  /** Optional human-facing display name. Stable machine identity remains `id`. */\n  readonly name?: string;\n  readonly description?: string;\n  /**\n   * Dry-run policy. Omitted runs the normal handler, `\"skip\"` structurally\n   * skips it, and a handler substitutes for `run` while preserving its output.\n   */\n  readonly dryRun?: \"skip\" | AnyStepDryRunHandler<TOptions>;\n  /** Optional Standard Schema for values published by this step. */\n  readonly outputSchema?: StandardSchemaV1;\n  /**\n   * Optional runtime skip. Return a non-empty reason (or `{ reason, value }`) to\n   * skip without calling `run`. Policy skips unlock dependents; structural skips\n   * (dry-run, filtered, …) do not use this hook.\n   */\n  skip?(\n    inputs: Record<string, unknown>,\n    context: PipelineExecutionContext<TOptions>\n  ): StepSkipDecision | Promise<StepSkipDecision>;\n  run(inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>): unknown;\n}\n\n/** The step fields that `buildStep` merges onto the id-bearing shell. */\ntype StepDefinitionBody<TOptions extends object> = Omit<AnyStep<TOptions>, \"id\">;\n\nexport interface Step<\n  TId extends string,\n  TOut,\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n  TRunOut = TOut,\n> extends AnyStep<TOptions> {\n  readonly id: TId;\n  run(\n    inputs: Record<string, unknown>,\n    context: PipelineStepContext<TOptions>\n  ): TRunOut | Promise<TRunOut>;\n  /** Type-only: carries this step's output type for sibling inference. Never set at runtime. */\n  readonly __outputType?: TOut;\n  /** Type-only: carries pre-validation run options for pipeline call-site inference. */\n  readonly __inputOptionsType?: TInputOptions;\n}\n\n/**\n * Extract a step's output type for dependency typing.\n * Prefer matching `Step<…, TOut, …>` over `{ __outputType?: infer T }`: optional-property\n * inference collapses `TOut | undefined` to `TOut`, which hides policy-skip widening.\n */\nexport type StepOutput<S> =\n  S extends Step<string, infer TOut, infer _TOptions, infer _TInputOptions, infer _TRunOut>\n    ? TOut\n    : never;\n\ninterface StepToken {\n  readonly id: string;\n  readonly __outputType?: unknown;\n}\n\ntype RequiredInputs<TDeps extends readonly StepToken[]> = {\n  [S in TDeps[number] as S[\"id\"]]: StepOutput<S>;\n};\n\ntype OptionalInputs<TDeps extends readonly StepToken[]> = {\n  [S in TDeps[number] as S[\"id\"]]?: StepOutput<S>;\n};\n\ntype PipelineResultOf<TPipeline> =\n  TPipeline extends Pipeline<object, infer TResult, infer _TStepId, infer _TTargetId>\n    ? TResult\n    : never;\n\ntype PipelineRunOptionsOf<TPipeline> =\n  TPipeline extends Pipeline<infer TOptions, unknown, infer TStepId, infer TTargetId>\n    ? PipelineRunOptions<TOptions, TStepId, TTargetId>\n    : never;\n\ntype ChildPipelineStepDefinitionBase<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n> = {\n  pipeline: TChildPipeline;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: \"skip\";\n  mapOptions(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineRunOptionsOf<TChildPipeline>;\n};\n\n/** Child step without policy skip (dependents see the full child result type). */\ntype ChildPipelineStepDefinition<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n> = ChildPipelineStepDefinitionBase<TParentOptions, TDeps, TOptionalDeps, TChildPipeline>;\n\n/**\n * Presentation options for opaque `forEachPipeline` progress.\n * Defaults are domain-neutral (`N/M items · K running · key/step`).\n * Override `formatMessage` when a domain wants its own noun (images, shards, …).\n */\nexport type MappedChildProgressOptions = ToMappedChildStepProgressOptions;\n\ntype MappedChildPipelineStepDefinition<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n  TItem,\n> = {\n  pipeline: TChildPipeline;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: \"skip\";\n  items(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): readonly TItem[] | Promise<readonly TItem[]>;\n  key(item: TItem, index: number): string;\n  concurrency?:\n    | number\n    | ((\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => number);\n  /**\n   * How the opaque parent step reports live fan-out progress.\n   * Purely presentational — does not change scheduling or results.\n   */\n  progress?: MappedChildProgressOptions;\n  mapOptions(\n    item: TItem,\n    index: number,\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineRunOptionsOf<TChildPipeline>;\n};\n\ntype StepSkipPredicate<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> = (\n  inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n  context: PipelineExecutionContext<TOptions>\n) => StepSkipDecision<TOut> | Promise<StepSkipDecision<TOut>>;\n\ntype StepDryRunPolicy<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> =\n  | \"skip\"\n  | ((\n      inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n      context: PipelineStepContext<TOptions>\n    ) => TOut | Promise<TOut>);\n\ntype PlainStepFields<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> = {\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: StepDryRunPolicy<TOptions, TDeps, TOptionalDeps, TOut>;\n  outputSchema?: never;\n  run(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineStepContext<TOptions>\n  ): TOut | Promise<TOut>;\n};\n\ntype SchemaStepFields<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TSchema extends StandardSchemaV1,\n> = Omit<\n  PlainStepFields<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>,\n  \"outputSchema\"\n> & {\n  outputSchema: TSchema;\n};\n\ntype RemoteStepDefinitionBase<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TPayload,\n  TSchema extends StandardSchemaV1,\n> = {\n  adapter: RemoteStepAdapter<TParentOptions, TPayload, InferSchemaInput<TSchema>>;\n  mapInput(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineStepContext<TParentOptions>\n  ): TPayload;\n  outputSchema: TSchema;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: StepDryRunPolicy<TParentOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>;\n};\n\nexport type StepFactory<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n> = ReturnType<typeof createStepFactory<TOptions, TInputOptions>>;\n\n/**\n * Returns a step factory scoped to one pipeline's domain options. Pass built-in\n * run controls as the second argument to `run` / `runOrThrow`. Child\n * `mapOptions` may still return domain options plus those controls.\n */\nexport function createSteps<TOptions extends object = {}>(): StepFactory<TOptions>;\nexport function createSteps<const TSchema extends StandardSchemaV1<object, object>>(\n  optionsSchema: TSchema\n): StepFactory<InferSchemaOutput<TSchema>, InferSchemaInput<TSchema>>;\nexport function createSteps(optionsSchema?: StandardSchemaV1<object, object>): StepFactory<object> {\n  return createStepFactory<object>(optionsSchema);\n}\n\nfunction createStepFactory<TOptions extends object, TInputOptions extends object = TOptions>(\n  optionsSchema?: StandardSchemaV1\n) {\n  const buildStep = (id: string, definition: StepDefinitionBody<TOptions>): AnyStep<TOptions> => {\n    const built: AnyStep<TOptions> = { id, ...definition };\n    if (optionsSchema) {\n      Object.defineProperty(built, STEP_OPTIONS_SCHEMA, { value: optionsSchema });\n    }\n    return built;\n  };\n\n  function step<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>\n        | undefined;\n    }\n  ): Step<\n    TId,\n    InferSchemaOutput<TSchema> | undefined,\n    TOptions,\n    TInputOptions,\n    InferSchemaInput<TSchema>\n  >;\n  function step<\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TOut = unknown,\n  >(\n    id: TId,\n    definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & {\n      skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, TOut> | undefined;\n    }\n  ): Step<TId, TOut | undefined, TOptions, TInputOptions>;\n  function step<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & { skip?: never }\n  ): Step<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;\n  function step<\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TOut = unknown,\n  >(\n    id: TId,\n    definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & { skip?: never }\n  ): Step<TId, TOut, TOptions, TInputOptions>;\n  function step(id: string, definition: StepDefinitionBody<TOptions>): AnyStep<TOptions> {\n    return buildStep(id, definition);\n  }\n\n  const buildPipelineStep = (\n    id: string,\n    config: ChildPipelineStepDefinitionBase<\n      TOptions,\n      readonly AnyStep<TOptions>[],\n      readonly AnyStep<TOptions>[],\n      Pipeline<object, unknown>\n    > & {\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n      mapResult?: (\n        value: unknown,\n        result: PipelineRun<unknown>,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n    }\n  ) => {\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"single\" as const,\n        pipelineId: config.pipeline.id,\n        stepIds: config.pipeline.stepIds,\n      },\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      run: createSingleChildRunner(config, {\n        createExecutionError: (result, message) => new PipelineExecutionError(result, message),\n        isCancellation: (error, childContext) => isPipelineCancellation(error, childContext),\n      }),\n    };\n\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip?: never;\n      mapResult?: undefined;\n    }\n  ): Step<TId, PipelineResultOf<TChildPipeline>, TOptions, TInputOptions>;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip?: never;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): Step<TId, Awaited<TOut>, TOptions, TInputOptions>;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, PipelineResultOf<TChildPipeline>>\n        | undefined;\n      mapResult?: undefined;\n    }\n  ): Step<TId, PipelineResultOf<TChildPipeline> | undefined, TOptions, TInputOptions>;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<Awaited<TOut>>> | undefined;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): Step<TId, Awaited<TOut> | undefined, TOptions, TInputOptions>;\n  function fromPipeline(\n    id: string,\n    definition: Parameters<typeof buildPipelineStep>[1]\n  ): AnyStep<TOptions> {\n    return buildPipelineStep(id, definition);\n  }\n\n  const buildRemoteStep = (\n    id: string,\n    config: {\n      adapter: RemoteStepAdapter<object, unknown, unknown>;\n      mapInput(inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>): unknown;\n      outputSchema: StandardSchemaV1;\n      dependsOn?: readonly AnyStep<TOptions>[];\n      optionalDependsOn?: readonly AnyStep<TOptions>[];\n      skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n      name?: string;\n      description?: string;\n      dryRun?: \"skip\" | AnyStepDryRunHandler<TOptions>;\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n    }\n  ) => {\n    const remote: NonNullable<PipelinePlanStep[\"remote\"]> = { engine: config.adapter.engine };\n    if (config.adapter.target !== undefined) remote.target = config.adapter.target;\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_REMOTE]: remote,\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      outputSchema: config.outputSchema,\n      run: (inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>) =>\n        config.adapter.invoke(config.mapInput(inputs, context), context),\n    };\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function fromRemote<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    TPayload,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {\n      skip?: never;\n    }\n  ): Step<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;\n  function fromRemote<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    TPayload,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>\n        | undefined;\n    }\n  ): Step<\n    TId,\n    InferSchemaOutput<TSchema> | undefined,\n    TOptions,\n    TInputOptions,\n    InferSchemaInput<TSchema>\n  >;\n  function fromRemote(\n    id: string,\n    definition: Parameters<typeof buildRemoteStep>[1]\n  ): AnyStep<TOptions> {\n    return buildRemoteStep(id, definition);\n  }\n\n  const buildMappedPipelineStep = (\n    id: string,\n    config: MappedChildPipelineStepDefinition<\n      TOptions,\n      readonly AnyStep<TOptions>[],\n      readonly AnyStep<TOptions>[],\n      Pipeline<object, unknown>,\n      unknown\n    > & {\n      mapResult?: (\n        value: unknown,\n        result: PipelineRun<unknown>,\n        item: unknown,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n    }\n  ) => {\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"for-each\" as const,\n        pipelineId: config.pipeline.id,\n        stepIds: config.pipeline.stepIds,\n      },\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      run: createMappedChildRunner(config, {\n        createExecutionError: (result, message) => new PipelineExecutionError(result, message),\n        isCancellation: (error, childContext) => isPipelineCancellation(error, childContext),\n      }),\n    };\n\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip?: never;\n      mapResult?: undefined;\n    }\n  ): Step<TId, readonly PipelineResultOf<TChildPipeline>[], TOptions, TInputOptions>;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip?: never;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        item: TItem,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): Step<TId, readonly TOut[], TOptions, TInputOptions>;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip:\n        | StepSkipPredicate<\n            TOptions,\n            TDeps,\n            TOptionalDeps,\n            readonly PipelineResultOf<TChildPipeline>[]\n          >\n        | undefined;\n      mapResult?: undefined;\n    }\n  ): Step<TId, readonly PipelineResultOf<TChildPipeline>[] | undefined, TOptions, TInputOptions>;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<readonly TOut[]>> | undefined;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        item: TItem,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): Step<TId, readonly TOut[] | undefined, TOptions, TInputOptions>;\n  function forEachPipeline(\n    id: string,\n    definition: Parameters<typeof buildMappedPipelineStep>[1]\n  ): AnyStep<TOptions> {\n    return buildMappedPipelineStep(id, definition);\n  }\n\n  const factory = {\n    step,\n    fromPipeline,\n    fromRemote,\n    forEachPipeline,\n  };\n\n  return factory;\n}\n"]}

package/dist/node/atomic-text.js

@@ -1,9 +1,10 @@
 import * as fs from "fs";
 import * as path from "path";
+import { randomUUID } from "node:crypto";
 export function writeAtomicText(filePath, text) {
     fs.mkdirSync(path.dirname(filePath), { recursive: true });
-    // Rename a sibling temp file so readers see only complete writes.
-    const tmpPath = `${filePath}.tmp-${process.pid}`;
+    // Each call owns its sibling temp file, including writers on same-PID workers.
+    const tmpPath = `${filePath}.tmp-${process.pid}-${randomUUID()}`;
     try {
         fs.writeFileSync(tmpPath, text);
         fs.renameSync(tmpPath, filePath);

package/dist/node/atomic-text.js.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-text.js","sourceRoot":"","sources":["../../src/node/atomic-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAY;IAC5D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,kEAAkE;IAClE,MAAM,OAAO,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\n\nexport function writeAtomicText(filePath: string, text: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  // Rename a sibling temp file so readers see only complete writes.\n  const tmpPath = `${filePath}.tmp-${process.pid}`;\n  try {\n    fs.writeFileSync(tmpPath, text);\n    fs.renameSync(tmpPath, filePath);\n  } catch (error) {\n    try {\n      fs.rmSync(tmpPath, { force: true });\n    } catch {\n      // Best-effort cleanup; surface the original write/rename error.\n    }\n    throw error;\n  }\n}\n"]}
+{"version":3,"file":"atomic-text.js","sourceRoot":"","sources":["../../src/node/atomic-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAY;IAC5D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,+EAA+E;IAC/E,MAAM,OAAO,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,EAAE,CAAC;IACjE,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport { randomUUID } from \"node:crypto\";\n\nexport function writeAtomicText(filePath: string, text: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  // Each call owns its sibling temp file, including writers on same-PID workers.\n  const tmpPath = `${filePath}.tmp-${process.pid}-${randomUUID()}`;\n  try {\n    fs.writeFileSync(tmpPath, text);\n    fs.renameSync(tmpPath, filePath);\n  } catch (error) {\n    try {\n      fs.rmSync(tmpPath, { force: true });\n    } catch {\n      // Best-effort cleanup; surface the original write/rename error.\n    }\n    throw error;\n  }\n}\n"]}

package/dist/node/env.d.ts

@@ -0,0 +1 @@
+export declare function requireEnv(varName: string, usedBy: string): string;

package/dist/node/env.js

@@ -0,0 +1,8 @@
+export function requireEnv(varName, usedBy) {
+    const value = process.env[varName];
+    if (!value) {
+        throw new Error(`${varName} is required for ${usedBy}`);
+    }
+    return value;
+}
+//# sourceMappingURL=env.js.map

package/dist/node/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/node/env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,MAAc;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,oBAAoB,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["export function requireEnv(varName: string, usedBy: string): string {\n  const value = process.env[varName];\n  if (!value) {\n    throw new Error(`${varName} is required for ${usedBy}`);\n  }\n  return value;\n}\n"]}

package/dist/node/file-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function writeJson(filePath: string, value: unknown): void;
+export declare function readJson<T>(filePath: string): T;
+export declare function resetDir(dirPath: string): void;

package/dist/node/file-utils.js

@@ -0,0 +1,21 @@
+import * as fs from "fs";
+import { writeAtomicText } from "./atomic-text.js";
+export function writeJson(filePath, value) {
+    const serialized = JSON.stringify(value, null, 2);
+    if (serialized === undefined) {
+        throw new TypeError("Value cannot be serialized as JSON");
+    }
+    writeAtomicText(filePath, `${serialized}\n`);
+}
+export function readJson(filePath) {
+    // SAFETY: the caller's type parameter T is the contract for the file's
+    // contents; the file is expected to hold JSON matching T (files written by
+    // writeJson round-trip). JSON.parse returns `any`, so the assertion only
+    // documents the caller's guarantee — it performs no runtime narrowing.
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+}
+export function resetDir(dirPath) {
+    fs.rmSync(dirPath, { recursive: true, force: true });
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/node/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../src/node/file-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,KAAc;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IACD,eAAe,CAAC,QAAQ,EAAE,GAAG,UAAU,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,QAAgB;IAC1C,uEAAuE;IACvE,2EAA2E;IAC3E,yEAAyE;IACzE,uEAAuE;IACvE,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAM,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import * as fs from \"fs\";\nimport { writeAtomicText } from \"./atomic-text.js\";\n\nexport function writeJson(filePath: string, value: unknown): void {\n  const serialized = JSON.stringify(value, null, 2);\n  if (serialized === undefined) {\n    throw new TypeError(\"Value cannot be serialized as JSON\");\n  }\n  writeAtomicText(filePath, `${serialized}\\n`);\n}\n\nexport function readJson<T>(filePath: string): T {\n  // SAFETY: the caller's type parameter T is the contract for the file's\n  // contents; the file is expected to hold JSON matching T (files written by\n  // writeJson round-trip). JSON.parse returns `any`, so the assertion only\n  // documents the caller's guarantee — it performs no runtime narrowing.\n  return JSON.parse(fs.readFileSync(filePath, \"utf-8\")) as T;\n}\n\nexport function resetDir(dirPath: string): void {\n  fs.rmSync(dirPath, { recursive: true, force: true });\n  fs.mkdirSync(dirPath, { recursive: true });\n}\n"]}

package/dist/node/node.d.ts

@@ -1 +1,4 @@
 export { openCheckpoint, withCheckpointedBatch, type CheckpointStore } from "./checkpoint.js";
+export { requireEnv } from "./env.js";
+export { readJson, resetDir, writeJson } from "./file-utils.js";
+export { definePaths } from "./paths.js";

package/dist/node/node.js

@@ -1,2 +1,5 @@
 export { openCheckpoint, withCheckpointedBatch } from "./checkpoint.js";
+export { requireEnv } from "./env.js";
+export { readJson, resetDir, writeJson } from "./file-utils.js";
+export { definePaths } from "./paths.js";
 //# sourceMappingURL=node.js.map

package/dist/node/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/node/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAwB,MAAM,iBAAiB,CAAC","sourcesContent":["export { openCheckpoint, withCheckpointedBatch, type CheckpointStore } from \"./checkpoint.js\";\n"]}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/node/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAwB,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { openCheckpoint, withCheckpointedBatch, type CheckpointStore } from \"./checkpoint.js\";\nexport { requireEnv } from \"./env.js\";\nexport { readJson, resetDir, writeJson } from \"./file-utils.js\";\nexport { definePaths } from \"./paths.js\";\n"]}

package/dist/node/paths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Declares a set of workspace-relative default paths as one factory instead of one
+ * `function defaultXDir(cwd) { return path.join(cwd, "...") }` per path. The returned
+ * function re-resolves against `cwd` on every call — nothing is computed or cached at
+ * module-load time, so a frozen-`process.cwd()` bug cannot be reintroduced by
+ * construction.
+ */
+export declare function definePaths<T extends Record<string, string>>(relativePaths: T): (cwd: string) => {
+    [K in keyof T]: string;
+};

package/dist/node/paths.js

@@ -0,0 +1,19 @@
+import * as path from "path";
+/**
+ * Declares a set of workspace-relative default paths as one factory instead of one
+ * `function defaultXDir(cwd) { return path.join(cwd, "...") }` per path. The returned
+ * function re-resolves against `cwd` on every call — nothing is computed or cached at
+ * module-load time, so a frozen-`process.cwd()` bug cannot be reintroduced by
+ * construction.
+ */
+export function definePaths(relativePaths) {
+    return (cwd) => 
+    // SAFETY: Object.entries(relativePaths) yields exactly T's keys, and every
+    // value is a resolved string, so the result preserves T's keys while widening
+    // relative path literals to string.
+    Object.fromEntries(Object.entries(relativePaths).map(([key, relativePath]) => [
+        key,
+        path.join(cwd, relativePath),
+    ]));
+}
+//# sourceMappingURL=paths.js.map

package/dist/node/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/node/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,aAAgB;IAEhB,OAAO,CAAC,GAAW,EAAE,EAAE;IACrB,2EAA2E;IAC3E,8EAA8E;IAC9E,oCAAoC;IACpC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC;QACzD,GAAG;QACH,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC;KAC7B,CAAC,CAC2B,CAAC;AACpC,CAAC","sourcesContent":["import * as path from \"path\";\n\n/**\n * Declares a set of workspace-relative default paths as one factory instead of one\n * `function defaultXDir(cwd) { return path.join(cwd, \"...\") }` per path. The returned\n * function re-resolves against `cwd` on every call — nothing is computed or cached at\n * module-load time, so a frozen-`process.cwd()` bug cannot be reintroduced by\n * construction.\n */\nexport function definePaths<T extends Record<string, string>>(\n  relativePaths: T\n): (cwd: string) => { [K in keyof T]: string } {\n  return (cwd: string) =>\n    // SAFETY: Object.entries(relativePaths) yields exactly T's keys, and every\n    // value is a resolved string, so the result preserves T's keys while widening\n    // relative path literals to string.\n    Object.fromEntries(\n      Object.entries(relativePaths).map(([key, relativePath]) => [\n        key,\n        path.join(cwd, relativePath),\n      ])\n    ) as { [K in keyof T]: string };\n}\n"]}