@adonis-agora/durable 0.49.0 → 0.50.0

package/dist/src/singleton-gate.js

@@ -1,4 +1,5 @@
 import { SingletonQueueFullError } from './errors.js';
+import { SINGLETON_ACTIVE_STATUSES, SINGLETON_ADMITTED_TAG, SINGLETON_TRACKED_TAG, } from './singleton-admission.js';
 const SINGLETON_RETRY_MS = 1000;
 /**
  * Max jitter (ms, each direction) added to {@link SINGLETON_RETRY_MS} so a queue of N gated runs
@@ -7,13 +8,15 @@ const SINGLETON_RETRY_MS = 1000;
  */
 const SINGLETON_RETRY_JITTER_MS = 250;
 /**
- * Per-key serialization for singleton workflows — start-time back-pressure, FIFO race-free
- * admission, and notify-on-release wakeups. Extracted from {@link WorkflowEngine} so the whole
+ * Per-key serialization for singleton workflows — start-time back-pressure, durable atomic FIFO
+ * admission (claimed by the store's {@link StateStore.tryAdmitSingleton}), and notify-on-release wakeups. Extracted from {@link WorkflowEngine} so the whole
  * singleton feature lives in one place instead of being smeared across `start`, `execute`, both run
  * loops, and `cancel`.
  */
 export class SingletonGate {
     deps;
+    /** The non-atomic-store warning is printed once per engine, not once per admission. */
+    warnedNonAtomic = false;
     constructor(deps) {
         this.deps = deps;
     }
@@ -29,8 +32,8 @@ export class SingletonGate {
     }
     /**
      * Reject a start that would grow the same-key backlog past `limit + maxQueueDepth` (counting
-     * `pending`/`running`/`suspended` runs sharing the key in one scan). No-op when no `maxQueueDepth`
-     * is configured.
+     * `pending`/`running`/`suspended`/`blocked` runs sharing the key in one scan). No-op when no
+     * `maxQueueDepth` is configured.
      */
     async assertCapacity(workflow, cfg, input) {
         if (cfg.maxQueueDepth == null)
@@ -39,27 +42,68 @@ export class SingletonGate {
         const queued = await this.deps.store.listRuns({
             tag: this.tag(cfg, input),
             workflow,
-            statuses: ['pending', 'running', 'suspended'],
+            statuses: SINGLETON_ACTIVE_STATUSES,
         });
         if (queued.length >= cap) {
             throw new SingletonQueueFullError(workflow, cfg.key(input), cfg.maxQueueDepth);
         }
     }
     /**
-     * Whether `run` may run now under its key: it's among the `limit` oldest in-flight (running or
-     * suspended) runs sharing the key, by `(createdAt, id)` order. A consistent store gives every
-     * instance the same ordering, so admission is race-free + FIFO.
+     * Claim (or confirm) a slot for `run` under its key, atomically in the store: runs already holding
+     * a slot keep it, and free slots go to the oldest waiters by `(createdAt, id)`. A denied run is
+     * parked `suspended` on a jittered retry timer by the store, in the same critical section — never
+     * over a run a concurrent cancel already settled. Holding a slot is durable (a reserved tag), so a
+     * holder that sleeps, waits, is recovered on another instance or loses its lease keeps it until it
+     * settles terminally.
      */
     async admit(run, cfg) {
-        // ONE scan for both in-flight statuses; the total `(createdAt, id)` sort makes admission order
-        // independent of the store's row order, preserving the FIFO + race-free-across-instances contract.
+        const store = this.deps.store;
+        if (!store.tryAdmitSingleton)
+            return this.admitByScan(run, cfg);
+        const admitted = await store.tryAdmitSingleton(run.id, this.tag(cfg, run.input), run.workflow, cfg.limit ?? 1, this.retryWakeAt());
+        if (admitted && !run.tags?.includes(SINGLETON_ADMITTED_TAG)) {
+            run.tags = [
+                ...(run.tags ?? []).filter((t) => t !== SINGLETON_TRACKED_TAG),
+                SINGLETON_ADMITTED_TAG,
+            ];
+        }
+        return admitted;
+    }
+    /**
+     * The pre-atomic admission, kept for a custom store without {@link StateStore.tryAdmitSingleton}
+     * so an upgrade doesn't break it: `run` is admitted while it is among the `limit` oldest
+     * `running`/`suspended` runs sharing its key by `(createdAt, id)`. It is a read followed by a
+     * decision, not a claim, so replicas can briefly over-admit and a same-millisecond start can
+     * displace a holder — hence the one-time warning. A denied run is parked on the retry timer here,
+     * conditionally, so a concurrent cancel is not overwritten.
+     */
+    async admitByScan(run, cfg) {
+        this.warnNonAtomic();
         const inflight = (await this.deps.store.listRuns({
             tag: this.tag(cfg, run.input),
             workflow: run.workflow,
             statuses: ['running', 'suspended'],
         })).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime() || a.id.localeCompare(b.id));
         const idx = inflight.findIndex((r) => r.id === run.id);
-        return idx >= 0 && idx < (cfg.limit ?? 1);
+        if (idx >= 0 && idx < (cfg.limit ?? 1))
+            return true;
+        await this.deps.store.updateRunIf(run.id, SINGLETON_ACTIVE_STATUSES, {
+            status: 'suspended',
+            wakeAt: this.retryWakeAt(),
+            updatedAt: new Date(),
+        });
+        return false;
+    }
+    warnNonAtomic() {
+        if (this.warnedNonAtomic)
+            return;
+        this.warnedNonAtomic = true;
+        console.warn('[adonis-durable] singleton admission is NOT atomic on this state store: it does not implement ' +
+            'StateStore.tryAdmitSingleton, so the engine falls back to a scan of running/suspended runs. ' +
+            'Replicas can briefly admit more than `limit` runs per key, and a same-millisecond start can ' +
+            'displace a holder. Implement tryAdmitSingleton (see the exported singletonAdmissionTags / ' +
+            'singletonAdmissionDenialPatch helpers and the "Store support" section of the singleton docs) ' +
+            'to make admission atomic.');
     }
     /**
      * Notify-on-release: a singleton run settled (freeing a slot), so dispatch the oldest gated
@@ -74,7 +118,10 @@ export class SingletonGate {
         const tag = settled.tags?.find((t) => t.startsWith('singleton:'));
         if (!tag)
             return;
-        const gated = (await this.deps.store.listRuns({ tag, workflow: settled.workflow, statuses: ['suspended'] })).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime() || a.id.localeCompare(b.id));
+        const gated = (await this.deps.store.listRuns({ tag, workflow: settled.workflow, statuses: ['suspended'] }))
+            // A suspended HOLDER (sleeping, waiting on a signal) is not waiting for a slot — leave it be.
+            .filter((r) => !r.tags?.includes(SINGLETON_ADMITTED_TAG))
+            .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime() || a.id.localeCompare(b.id));
         for (const next of gated.slice(0, cfg.limit ?? 1)) {
             // Make the run due NOW rather than clearing its retry timer. The dispatch below goes through
             // the configured runDispatcher, which may legitimately be a NO-OP (a poll-only deployment

package/dist/src/singleton-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"singleton-gate.js","sourceRoot":"","sources":["../../src/singleton-gate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"singleton-gate.js","sourceRoot":"","sources":["../../src/singleton-gate.ts"],"names":[],"mappings":"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"}

package/dist/src/standard-schema.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Vendored subset of the Standard Schema spec (https://standardschema.dev) — the `~standard`
+ * property protocol implemented by zod (3.24+ / 4), valibot, arktype, effect schema and others.
+ * Vendored (rather than taken as a dependency) as the spec recommends, so the package stays free of
+ * any schema library at runtime: the interface is types only, erased by the build. Source:
+ * https://github.com/standard-schema/standard-schema (MIT) — trimmed to the `StandardSchemaV1` shape
+ * this package consumes, identical to the copy in the NestJS sibling (`@dudousxd/nestjs-durable-core`).
+ *
+ * Used by `@Step({ input, output })` / `defineStep`, `register(..., { inputSchema })` /
+ * `static workflow = { inputSchema }` and the typed `searchAttributes` schema, so each accepts
+ * whichever schema library the app already uses.
+ */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+export declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /** Validates unknown input values. */
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** A falsy value for `issues` indicates success. */
+        readonly issues?: undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+/**
+ * Validate `value` against any Standard Schema and return the schema's OUTPUT value (parsed /
+ * coerced / defaulted — e.g. zod's `.transform`, valibot's `pipe`, arktype morphs). Both a sync and
+ * an async (`Promise`-returning) `~standard.validate` are supported. On failure throws a
+ * {@link SchemaValidationError} — a non-retryable `FatalError` (code `schema_validation`) carrying the
+ * issues in `details`, so a bad payload fails fast instead of being retried forever.
+ *
+ * `label` names what was validated in the error message, e.g. `step "billing:charge" input`.
+ */
+export declare function validateStandard<S extends StandardSchemaV1>(schema: S, value: unknown, label: string): Promise<StandardSchemaV1.InferOutput<S>>;
+/**
+ * Synchronous {@link validateStandard}, for call sites that must not await a validator (the typed
+ * search-attributes write, where an async refinement could make replay nondeterministic). A schema
+ * whose `validate` returns a `Promise` throws a clear error instead of being silently awaited.
+ */
+export declare function validateStandardSync<S extends StandardSchemaV1>(schema: S, value: unknown, label: string): StandardSchemaV1.InferOutput<S>;
+//# sourceMappingURL=standard-schema.d.ts.map

package/dist/src/standard-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../../src/standard-schema.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;IAC/D,sCAAsC;IACtC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;CAC7D;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,gDAAgD;IAChD,UAAU,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;QAC7C,0CAA0C;QAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpB,6CAA6C;QAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,sCAAsC;QACtC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,iDAAiD;QACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;KACnD;IAED,qDAAqD;IACrD,KAAK,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC;IAE5D,mDAAmD;IACnD,UAAU,aAAa,CAAC,MAAM;QAC5B,8BAA8B;QAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,oDAAoD;QACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;KAC7B;IAED,gDAAgD;IAChD,UAAU,aAAa;QACrB,uCAAuC;QACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;KACvC;IAED,iDAAiD;IACjD,UAAU,KAAK;QACb,sCAAsC;QACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,qCAAqC;QACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,SAAS,CAAC;KACtE;IAED,+CAA+C;IAC/C,UAAU,WAAW;QACnB,2CAA2C;QAC3C,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;KAC3B;IAED,2CAA2C;IAC3C,UAAU,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;QAC7C,oCAAoC;QACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QACtB,qCAAqC;QACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB;IAED,kDAAkD;IAClD,KAAK,UAAU,CAAC,MAAM,SAAS,gBAAgB,IAAI,WAAW,CAC5D,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAC7B,CAAC,OAAO,CAAC,CAAC;IAEX,mDAAmD;IACnD,KAAK,WAAW,CAAC,MAAM,SAAS,gBAAgB,IAAI,WAAW,CAC7D,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAC7B,CAAC,QAAQ,CAAC,CAAC;CACb;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EAC/D,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAI1C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,EAC7D,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CASjC"}

package/dist/src/standard-schema.js

@@ -0,0 +1,31 @@
+import { SchemaValidationError } from './errors.js';
+/**
+ * Validate `value` against any Standard Schema and return the schema's OUTPUT value (parsed /
+ * coerced / defaulted — e.g. zod's `.transform`, valibot's `pipe`, arktype morphs). Both a sync and
+ * an async (`Promise`-returning) `~standard.validate` are supported. On failure throws a
+ * {@link SchemaValidationError} — a non-retryable `FatalError` (code `schema_validation`) carrying the
+ * issues in `details`, so a bad payload fails fast instead of being retried forever.
+ *
+ * `label` names what was validated in the error message, e.g. `step "billing:charge" input`.
+ */
+export async function validateStandard(schema, value, label) {
+    const result = await schema['~standard'].validate(value);
+    if (result.issues)
+        throw new SchemaValidationError(label, result.issues);
+    return result.value;
+}
+/**
+ * Synchronous {@link validateStandard}, for call sites that must not await a validator (the typed
+ * search-attributes write, where an async refinement could make replay nondeterministic). A schema
+ * whose `validate` returns a `Promise` throws a clear error instead of being silently awaited.
+ */
+export function validateStandardSync(schema, value, label) {
+    const result = schema['~standard'].validate(value);
+    if (result instanceof Promise) {
+        throw new TypeError(`${label}: schema validation must be synchronous (the schema's \`~standard.validate\` returned a Promise) — drop any async refinement from it.`);
+    }
+    if (result.issues)
+        throw new SchemaValidationError(label, result.issues);
+    return result.value;
+}
+//# sourceMappingURL=standard-schema.js.map

package/dist/src/standard-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.js","sourceRoot":"","sources":["../../src/standard-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAkFpD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAS,EACT,KAAc,EACd,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,KAAwC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAS,EACT,KAAc,EACd,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CACjB,GAAG,KAAK,uIAAuI,CAChJ,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,KAAwC,CAAC;AACzD,CAAC"}

package/dist/src/step-discovery.d.ts

@@ -1,3 +1,4 @@
+import { type BarrelTree, type RootedBarrel } from './discovery-roots.js';
 import type { StepLogger } from './interfaces.js';
 import type { StepHandler } from './protocol.js';
 import { type DurableStepMeta } from './step-ref.js';
@@ -13,7 +14,7 @@ export interface DiscoveredStep {
 }
 /**
  * Register a single discovered step on `server` under its stamped name, wrapping it with any
- * declared zod validation. The low-level `transport.handle(name, fn)` stays the escape hatch — this
+ * declared schema validation. The low-level `transport.handle(name, fn)` stays the escape hatch — this
  * is the convention the `app/steps` discovery builds on.
  */
 export declare function registerStep(server: StepServer, step: DiscoveredStep): void;
@@ -28,16 +29,25 @@ export declare function collectSteps(exported: unknown): DiscoveredStep[];
  *  onto `server`. De-duplicated by routing name (last wins). Returns the registered metadata. */
 export declare function registerSteps(server: StepServer, exports: Iterable<unknown>): DurableStepMeta[];
 /**
- * Scan `dir` RECURSIVELY for modules and register every exported `@Step` class / `defineStep`
- * handler on `server` — the `app/steps` convention, mirroring `app/workflows` discovery. Only the
- * extension present in `dir` is imported (see {@link pickModuleExt}). Missing directory → no-op
- * (the convention is opt-in). Returns the registered metadata.
+ * Scan `dir` — one directory or several — RECURSIVELY and register every exported `@Step` class /
+ * `defineStep` handler on `server`: the `app/steps` convention, mirroring `app/workflows` discovery.
+ * Only the extension present in each directory is imported (see `pickModuleExt`). Missing
+ * directory → nothing from it (the convention is opt-in). With several directories the same step
+ * name defined by different handlers in two of them throws a {@link DuplicateDiscoveryError}.
+ * Returns the registered metadata.
+ *
+ * `server` is anything with `handle(name, fn)`: a transport, the store-less `WorkerRuntime`, or the
+ * `WorkflowEngine` itself (it forwards to its primary transport) — the latter is how app code
+ * serves an extra directory from a preload: `await registerStepsFromDir(engine, dir)`.
  */
-export declare function registerStepsFromDir(server: StepServer, dir: string): Promise<DurableStepMeta[]>;
+export declare function registerStepsFromDir(server: StepServer, dir: string | readonly string[]): Promise<DurableStepMeta[]>;
 /** The build-time barrel shape the Assembler `init` hook generates for `app/steps` (key → lazy
- *  module import), mirroring {@link import('./workflow-discovery.js').WorkflowsBarrel}. */
-export type StepsBarrel = Record<string, () => Promise<Record<string, unknown>>>;
-/** Register every `@Step`/`defineStep` reachable from a generated {@link StepsBarrel} onto `server`
- *  — the build-time equivalent of {@link registerStepsFromDir} with no runtime `readdir`. */
-export declare function registerStepsFromBarrel(server: StepServer, barrel: StepsBarrel): Promise<DurableStepMeta[]>;
+ *  module import, nested per sub-directory), mirroring
+ *  {@link import('./workflow-discovery.js').WorkflowsBarrel}. A multi-root hook writes a
+ *  {@link RootedBarrel} array instead. */
+export type StepsBarrel = BarrelTree;
+/** Register every `@Step`/`defineStep` reachable from a generated {@link StepsBarrel} (or a
+ *  multi-root {@link RootedBarrel} array) onto `server` — the build-time equivalent of
+ *  {@link registerStepsFromDir} with no runtime `readdir`, same cross-root duplicate rule. */
+export declare function registerStepsFromBarrel(server: StepServer, barrel: StepsBarrel | readonly RootedBarrel[]): Promise<DurableStepMeta[]>;
 //# sourceMappingURL=step-discovery.d.ts.map

package/dist/src/step-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-discovery.d.ts","sourceRoot":"","sources":["../../src/step-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAGjE;uFACuF;AACvF,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7C;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAeD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,EAAE,CA8BhE;AAED;iGACiG;AACjG,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,eAAe,EAAE,CAY/F;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,EAAE,CAAC,CAsB5B;AAED;2FAC2F;AAC3F,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjF;6FAC6F;AAC7F,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,eAAe,EAAE,CAAC,CAY5B"}
+{"version":3,"file":"step-discovery.d.ts","sourceRoot":"","sources":["../../src/step-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,YAAY,EAElB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EAAE,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAEjE;uFACuF;AACvF,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7C;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAoBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,EAAE,CA8BhE;AAED;iGACiG;AACjG,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,eAAe,EAAE,CAY/F;AAmED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AAED;;;0CAG0C;AAC1C,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC;AAErC;;8FAE8F;AAC9F,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,WAAW,GAAG,SAAS,YAAY,EAAE,GAC5C,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B"}

package/dist/src/step-discovery.js

@@ -1,25 +1,28 @@
-import { readdir } from 'node:fs/promises';
-import { extname, join } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { barrelModules, DuplicateDiscoveryError, scanDirsModules, } from './discovery-roots.js';
+import { validateStandard } from './standard-schema.js';
 import { DURABLE_STEP_NAME } from './step-name-symbol.js';
 import { stepMetaOf } from './step-ref.js';
-import { pickModuleExt } from './workflow-discovery.js';
-/** Wrap a handler with the opt-in zod validation its `@Step`/`defineStep` metadata declared: `input`
- *  is parsed before the body runs, `output` before the result is handed back. A handler with neither
- *  schema is served as-is (compile-time types only). */
+/** Wrap a handler with the opt-in Standard Schema validation its `@Step`/`defineStep` metadata
+ *  declared: `input` is validated before the body runs (the body receives the schema's OUTPUT value),
+ *  `output` before the result is handed back. A failure throws a non-retryable
+ *  `SchemaValidationError`. A handler with neither schema is served as-is (compile-time types only). */
 function validating(step) {
     const { meta, handler } = step;
     if (!meta.input && !meta.output)
         return handler;
     return async (input, log) => {
-        const parsed = meta.input ? meta.input.parse(input) : input;
+        const parsed = meta.input
+            ? await validateStandard(meta.input, input, `step "${meta.name}" input`)
+            : input;
         const output = await handler(parsed, log);
-        return meta.output ? meta.output.parse(output) : output;
+        return meta.output
+            ? validateStandard(meta.output, output, `step "${meta.name}" output`)
+            : output;
     };
 }
 /**
  * Register a single discovered step on `server` under its stamped name, wrapping it with any
- * declared zod validation. The low-level `transport.handle(name, fn)` stays the escape hatch — this
+ * declared schema validation. The low-level `transport.handle(name, fn)` stays the escape hatch — this
  * is the convention the `app/steps` discovery builds on.
  */
 export function registerStep(server, step) {
@@ -77,32 +80,65 @@ export function registerSteps(server, exports) {
     }
     return registered;
 }
+/** The routing names an export would serve, read off its stamps WITHOUT instantiating anything. */
+function stepNamesOf(exported) {
+    const direct = stepMetaOf(exported);
+    if (direct)
+        return [direct.name];
+    if (typeof exported !== 'function' || !exported.prototype)
+        return [];
+    const proto = exported.prototype;
+    const names = [];
+    for (const key of Object.getOwnPropertyNames(proto)) {
+        const value = proto[key];
+        if (typeof value !== 'function')
+            continue;
+        const name = stepMetaOf(value)?.name;
+        if (name)
+            names.push(name);
+    }
+    return names;
+}
 /**
- * Scan `dir` RECURSIVELY for modules and register every exported `@Step` class / `defineStep`
- * handler on `server` — the `app/steps` convention, mirroring `app/workflows` discovery. Only the
- * extension present in `dir` is imported (see {@link pickModuleExt}). Missing directory → no-op
- * (the convention is opt-in). Returns the registered metadata.
+ * Register every step reachable from `modules`, in order. Per module this is exactly
+ * {@link registerSteps} — the single-directory behaviour, kept as-is: inside one root a name served
+ * twice is served by the later module.
+ *
+ * Across roots, a step name already served from another root by a DIFFERENT export throws a
+ * {@link DuplicateDiscoveryError} naming both files — checked for every module BEFORE any handler is
+ * registered, so a clash never leaves a half-served transport. The same export reachable from two
+ * roots (a re-export, or overlapping roots) is served once.
  */
-export async function registerStepsFromDir(server, dir) {
-    let entries;
-    try {
-        entries = await readdir(dir, { recursive: true });
-    }
-    catch (err) {
-        if (err.code === 'ENOENT')
-            return [];
-        throw err;
+async function registerStepModules(server, modules) {
+    const owners = new Map();
+    const plan = [];
+    for (const { root, file, load } of modules) {
+        const mod = await load();
+        const exports = [];
+        for (const exported of Object.values(mod)) {
+            let servedElsewhere = false;
+            for (const name of stepNamesOf(exported)) {
+                const owner = owners.get(name);
+                if (!owner) {
+                    owners.set(name, { root, file, source: exported });
+                    continue;
+                }
+                if (owner.root === root)
+                    continue;
+                if (owner.source !== exported) {
+                    throw new DuplicateDiscoveryError('step', name, [owner.file, file]);
+                }
+                servedElsewhere = true;
+            }
+            if (!servedElsewhere)
+                exports.push(exported);
+        }
+        plan.push(exports);
     }
-    const moduleExt = pickModuleExt(entries);
     const registered = [];
-    if (moduleExt === null)
-        return registered;
     const seen = new Set();
-    for (const entry of entries.sort()) {
-        if (extname(entry) !== moduleExt || entry.endsWith(`.d${moduleExt}`))
-            continue;
-        const mod = (await import(pathToFileURL(join(dir, entry)).href));
-        for (const meta of registerSteps(server, Object.values(mod))) {
+    for (const exports of plan) {
+        for (const meta of registerSteps(server, exports)) {
             if (seen.has(meta.name))
                 continue;
             seen.add(meta.name);
@@ -111,20 +147,25 @@ export async function registerStepsFromDir(server, dir) {
     }
     return registered;
 }
-/** Register every `@Step`/`defineStep` reachable from a generated {@link StepsBarrel} onto `server`
- *  — the build-time equivalent of {@link registerStepsFromDir} with no runtime `readdir`. */
+/**
+ * Scan `dir` — one directory or several — RECURSIVELY and register every exported `@Step` class /
+ * `defineStep` handler on `server`: the `app/steps` convention, mirroring `app/workflows` discovery.
+ * Only the extension present in each directory is imported (see `pickModuleExt`). Missing
+ * directory → nothing from it (the convention is opt-in). With several directories the same step
+ * name defined by different handlers in two of them throws a {@link DuplicateDiscoveryError}.
+ * Returns the registered metadata.
+ *
+ * `server` is anything with `handle(name, fn)`: a transport, the store-less `WorkerRuntime`, or the
+ * `WorkflowEngine` itself (it forwards to its primary transport) — the latter is how app code
+ * serves an extra directory from a preload: `await registerStepsFromDir(engine, dir)`.
+ */
+export async function registerStepsFromDir(server, dir) {
+    return registerStepModules(server, await scanDirsModules(typeof dir === 'string' ? [dir] : dir));
+}
+/** Register every `@Step`/`defineStep` reachable from a generated {@link StepsBarrel} (or a
+ *  multi-root {@link RootedBarrel} array) onto `server` — the build-time equivalent of
+ *  {@link registerStepsFromDir} with no runtime `readdir`, same cross-root duplicate rule. */
 export async function registerStepsFromBarrel(server, barrel) {
-    const registered = [];
-    const seen = new Set();
-    for (const load of Object.values(barrel)) {
-        const mod = await load();
-        for (const meta of registerSteps(server, Object.values(mod))) {
-            if (seen.has(meta.name))
-                continue;
-            seen.add(meta.name);
-            registered.push(meta);
-        }
-    }
-    return registered;
+    return registerStepModules(server, barrelModules(barrel));
 }
 //# sourceMappingURL=step-discovery.js.map

package/dist/src/step-discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-discovery.js","sourceRoot":"","sources":["../../src/step-discovery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"step-discovery.js","sourceRoot":"","sources":["../../src/step-discovery.ts"],"names":[],"mappings":"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"}

package/dist/src/step-ref.d.ts

@@ -1,30 +1,33 @@
-import type { z } from 'zod';
 import type { BackoffStrategy, StepLogger } from './interfaces.js';
+import type { StandardSchemaV1 } from './standard-schema.js';
 import { type StepRef } from './step-name-symbol.js';
 /**
  * The full metadata a `@Step` / {@link defineStep} stamps on a step handler for discovery: its
- * resolved routing `name` plus the opt-in runtime zod schemas an authoring layer attached. Stamped
+ * resolved routing `name` plus the opt-in runtime Standard Schemas (zod, valibot, arktype, …) an
+ * authoring layer attached. Stamped
  * under {@link DURABLE_STEP_META} on the handler function so step discovery can wrap it with
  * validation at the serve boundary. A global-registry symbol so it survives duplicate copies.
  */
 export declare const DURABLE_STEP_META: unique symbol;
-/** Discovery metadata a decorated/`defineStep` handler carries: routing name + optional zod schemas. */
+/** Discovery metadata a decorated/`defineStep` handler carries: routing name + optional schemas. */
 export interface DurableStepMeta {
     /** The resolved routing name — derived (`Class.method`) or explicit, always present. */
     name: string;
     /** Opt-in runtime input schema, validated when the handler is served. Absent on a bare `@Step()`. */
-    input?: z.ZodType | undefined;
+    input?: StandardSchemaV1 | undefined;
     /** Opt-in runtime output schema, validated before the handler's result is handed back. */
-    output?: z.ZodType | undefined;
+    output?: StandardSchemaV1 | undefined;
 }
 /** Options for the object call form of {@link Step} / {@link defineStep}. */
 export interface StepDecoratorOptions {
     /** Explicit routing name, overriding the derived `Class.method`. */
     name?: string;
-    /** Runtime input schema, validated at the serve boundary (opt-in — a bare `@Step()` skips it). */
-    input?: z.ZodType;
-    /** Runtime output schema, validated before the result is returned (opt-in). */
-    output?: z.ZodType;
+    /** Runtime input schema — any Standard Schema (zod, valibot, arktype, …) — validated at the serve
+     *  boundary (opt-in — a bare `@Step()` skips it). The handler receives the schema's OUTPUT value. */
+    input?: StandardSchemaV1;
+    /** Runtime output schema (any Standard Schema), validated before the result is returned (opt-in).
+     *  The caller receives the schema's OUTPUT value. */
+    output?: StandardSchemaV1;
     /** Def-level policy: max attempts before the step (and run) fails. Read by `ctx.step` via `stepConfigOf`. */
     retries?: number;
     /** How the delay between retries grows: `fixed` (constant) or `exp` (doubles each attempt). */
@@ -45,6 +48,8 @@ export interface StepDecoratorOptions {
      *  protocol-compatible the run parks `blocked` with a precise reason. Absent/empty = runs anywhere. */
     requires?: string[];
 }
+/** {@link defineStep}'s options minus the schemas — the overloads add `input`/`output` typed. */
+export type DefineStepOptions = Omit<StepDecoratorOptions, 'name' | 'input' | 'output'>;
 /**
  * Marks a class method as a durable **step handler**. A dispatched task is routed to it BY NAME —
  * `ctx.step(this.svc.method, input)` reads that same name off the method reference (the shared
@@ -56,21 +61,42 @@ export interface StepDecoratorOptions {
  * - `@Step()` — bare: the routing name is DERIVED as `` `${ClassName}.${method}` `` — refactor-safe.
  * - `@Step('custom:name')` — explicit name override (a stable cross-runtime contract).
  * - `@Step({ name?, input?, output?, retries?, backoff?, backoffMs?, backoffMaxMs?, jitter?,
- *   timeoutMs? })` — optional name override, opt-in RUNTIME zod schemas (validated at the serve
- *   boundary by step discovery), and a def-level durable-retry/liveness policy `ctx.step` reads via
+ *   timeoutMs? })` — optional name override, opt-in RUNTIME Standard Schemas (zod, valibot,
+ *   arktype, … — validated at the serve boundary by step discovery; a failure is a non-retryable
+ *   `SchemaValidationError`), and a def-level durable-retry/liveness policy `ctx.step` reads via
  *   `stepConfigOf` (a per-call `opts` overrides it field-by-field).
  */
 export declare function Step(nameOrOptions?: string | StepDecoratorOptions): MethodDecorator;
 /**
  * Build a durable step handler WITHOUT a class/decorator: stamps `fn` with the routing `name` (and
- * optional zod schemas + dispatch policy) so it works as a typed {@link StepRef} for
+ * optional Standard Schemas + dispatch policy) so it works as a typed {@link StepRef} for
  * `ctx.step(fn, input)` AND is discoverable/registerable by name. The cross-runtime baseline — pass
  * the returned ref to `ctx.step`, or register it on a transport via `registerStep`.
  *
  * ```ts
  * export const charge = defineStep('billing:charge', async (input: ChargeInput) => { ... })
  * ```
+ *
+ * With an `input` / `output` Standard Schema the types are INFERRED from it: the handler receives
+ * the input schema's output type (parsed/coerced), and the returned ref takes the input schema's
+ * input type and resolves to the output schema's output type — no hand-written annotation needed.
+ *
+ * ```ts
+ * const charge = defineStep('billing:charge', async (input) => ({ id: `ch_${input.amount}` }), {
+ *   input: v.object({ amount: v.number() }), // valibot, zod, arktype, …
+ * })
+ * ```
  */
+export declare function defineStep<SI extends StandardSchemaV1, SO extends StandardSchemaV1>(name: string, fn: (input: StandardSchemaV1.InferOutput<SI>, log: StepLogger) => StandardSchemaV1.InferInput<SO> | Promise<StandardSchemaV1.InferInput<SO>>, config: DefineStepOptions & {
+    input: SI;
+    output: SO;
+}): StepRef<StandardSchemaV1.InferInput<SI>, StandardSchemaV1.InferOutput<SO>>;
+export declare function defineStep<SI extends StandardSchemaV1, TOutput>(name: string, fn: (input: StandardSchemaV1.InferOutput<SI>, log: StepLogger) => TOutput | Promise<TOutput>, config: DefineStepOptions & {
+    input: SI;
+}): StepRef<StandardSchemaV1.InferInput<SI>, TOutput>;
+export declare function defineStep<TInput, SO extends StandardSchemaV1>(name: string, fn: (input: TInput, log: StepLogger) => StandardSchemaV1.InferInput<SO> | Promise<StandardSchemaV1.InferInput<SO>>, config: DefineStepOptions & {
+    output: SO;
+}): StepRef<TInput, StandardSchemaV1.InferOutput<SO>>;
 export declare function defineStep<TInput, TOutput>(name: string, fn: (input: TInput, log: StepLogger) => TOutput | Promise<TOutput>, config?: Omit<StepDecoratorOptions, 'name'>): StepRef<TInput, TOutput>;
 /** Read the {@link DurableStepMeta} a `@Step`/`defineStep` stamped on a handler, or `undefined`. */
 export declare function stepMetaOf(ref: unknown): DurableStepMeta | undefined;