@adonis-agora/durable 0.1.0

package/dist/src/workflow-ctx.js

@@ -0,0 +1,457 @@
+import { backoffDelay } from './backoff.js';
+import { instantCheckpoint } from './checkpoints.js';
+import { unwrapCompletion } from './completion.js';
+import { parseDuration } from './duration.js';
+import { ContinueAsNew, FatalError, NonDeterminismError, SignalTimeoutError, WorkflowSuspended, } from './errors.js';
+import { eventToken } from './events.js';
+import { breakpointToken } from './protocol.js';
+import { createStepLogger } from './step-logger.js';
+import { workflowName } from './workflow-ref.js';
+/** Normalize the `ctx.child`/`ctx.startChild` 3rd arg: a bare string is shorthand for `{ childId }`. */
+function normalizeChildOptions(options) {
+    return typeof options === 'string' ? { childId: options } : (options ?? {});
+}
+/** The per-run logical position counter. `rewind()` gives a position back (see `ctx.patched`). */
+class Position {
+    seq = -1;
+    next() {
+        this.seq += 1;
+        return this.seq;
+    }
+    rewind() {
+        this.seq -= 1;
+    }
+}
+/**
+ * Build the {@link WorkflowCtx} handed to a workflow body. Every primitive is a closure over the
+ * position counter (the per-run logical position) and the saga `compensations` stack, so `task`/
+ * `child` compose `step`/`waitForSignal` directly. All durability goes through {@link CtxHost}, so
+ * the workflow body stays deterministic.
+ */
+export function createWorkflowCtx(host, runId, compensations, workflow = '') {
+    const { store, replay } = host;
+    const pos = new Position();
+    // Read the checkpoint at `seq`: from the per-execution snapshot when present (no DB round-trip),
+    // otherwise from the live store. Absence in the snapshot means "written after the snapshot" (the
+    // signal/timer/child this resume wakes on, or nothing yet) — those MUST hit the store. Identical
+    // behaviour to a raw `store.getCheckpoint`, just memoized for the completed prefix.
+    const readCheckpoint = (seq) => {
+        const hit = replay?.get(seq);
+        if (hit !== undefined)
+            return hit;
+        return store.getCheckpoint(runId, seq);
+    };
+    // Persist a checkpoint AND reflect it in the snapshot, so a later same-execution read of this seq
+    // (e.g. a re-read within the same call) sees it instead of falling back to the store.
+    const writeCheckpoint = async (cp) => {
+        await store.saveCheckpoint(cp);
+        replay?.set(cp.seq, cp);
+    };
+    const step = async (name, fn, options) => {
+        const current = pos.next();
+        const existing = await readCheckpoint(current);
+        if (existing && existing.name !== name) {
+            throw new NonDeterminismError(runId, current, name, existing.name);
+        }
+        if (existing && existing.status === 'completed') {
+            // Register the compensation on replay too, so a saga undoes ALL completed steps — even
+            // those done in an earlier (since-suspended) pass — not just the ones run this pass.
+            if (options?.compensate)
+                compensations.push({ name, fn: options.compensate });
+            return existing.output;
+        }
+        const maxAttempts = Math.max(1, options?.retries ?? 1);
+        const startedAt = new Date();
+        // Announce the body has begun (and, when enabled, checkpoint it `running`) so the step is
+        // visible in flight — not only once it settles. Skipped on replay: a completed step returns
+        // above before reaching here, so this fires once, when the body actually first runs.
+        await host.startStep({
+            runId,
+            seq: current,
+            name,
+            kind: 'local',
+            attempts: 1,
+            enqueuedAt: startedAt,
+            startedAt,
+        });
+        for (let attempt = 1;; attempt += 1) {
+            // Events are scoped per attempt — a retry starts a clean log, so the checkpoint reflects
+            // only the attempt that actually completed (or the final failing one).
+            const events = [];
+            try {
+                const invocation = {
+                    runId,
+                    workflow,
+                    stepName: name,
+                    seq: current,
+                    attempt,
+                };
+                const body = () => fn(createStepLogger(events, host.clock));
+                const output = host.interceptStep
+                    ? await host.interceptStep(invocation, body)
+                    : await body();
+                await host.completeStep({
+                    runId,
+                    seq: current,
+                    name,
+                    kind: 'local',
+                    output,
+                    events,
+                    attempts: attempt,
+                    enqueuedAt: startedAt,
+                    startedAt,
+                });
+                if (options?.compensate)
+                    compensations.push({ name, fn: options.compensate });
+                return output;
+            }
+            catch (err) {
+                if (err instanceof FatalError || attempt >= maxAttempts) {
+                    await host.failStep({
+                        runId,
+                        seq: current,
+                        name,
+                        kind: 'local',
+                        error: {
+                            message: err instanceof Error ? err.message : String(err),
+                            stack: err instanceof Error ? err.stack : undefined,
+                        },
+                        events,
+                        attempts: attempt,
+                        enqueuedAt: startedAt,
+                        startedAt,
+                    });
+                    throw err;
+                }
+                // Wait out the backoff before the next attempt (no-op when backoffMs is unset).
+                const wait = backoffDelay(attempt, options);
+                if (wait > 0)
+                    await new Promise((resolve) => setTimeout(resolve, wait));
+            }
+        }
+    };
+    // Exactly-once DB step: run the body and write the step checkpoint in ONE store transaction, so the
+    // business write commits atomically with the "done" marker (a plain step checkpoints AFTER the body,
+    // so a crash in between re-runs it). Replay returns the recorded output without re-running.
+    const transaction = async (name, fn) => {
+        if (!store.transaction) {
+            throw new Error('ctx.transaction needs a store that supports transactions (the SQL adapters do). Use ctx.step for non-transactional work.');
+        }
+        const current = pos.next();
+        const existing = await readCheckpoint(current);
+        if (existing && existing.name !== name) {
+            throw new NonDeterminismError(runId, current, name, existing.name);
+        }
+        if (existing && existing.status === 'completed')
+            return existing.output;
+        return store.transaction(async (tx) => {
+            const output = await fn(tx.raw);
+            const cp = instantCheckpoint({ runId, seq: current, name, kind: 'local', output });
+            await tx.saveCheckpoint(cp);
+            // Reflect the committed checkpoint in the snapshot, keeping the writeback invariant uniform.
+            replay?.set(current, cp);
+            return output;
+        });
+    };
+    // Shared by sleep / sleepUntil: record a durable timer at this position and suspend until `wakeAt`
+    // (epoch ms). The wakeAt is computed by the caller — but only used on the first run; on replay the
+    // recorded checkpoint's wakeAt wins, so a clock change can't shift an already-scheduled timer.
+    const suspendUntil = async (wakeAt) => {
+        const current = pos.next();
+        const now = host.clock();
+        const existing = await readCheckpoint(current);
+        if (existing) {
+            // Timer already recorded: resume if due, otherwise re-suspend cheaply.
+            if (now >= (existing.wakeAt ?? 0))
+                return;
+            throw new WorkflowSuspended(existing.wakeAt ?? now);
+        }
+        const at = wakeAt();
+        await writeCheckpoint(instantCheckpoint({ runId, seq: current, name: 'sleep', kind: 'sleep', wakeAt: at }));
+        throw new WorkflowSuspended(at);
+    };
+    const sleep = (duration) => suspendUntil(() => host.clock() + parseDuration(duration));
+    const sleepUntil = (when) => suspendUntil(() => (typeof when === 'number' ? when : when.getTime()));
+    // End this run and hand off to a fresh execution (clean history) with the new input. Terminal —
+    // it always throws, so any code after it in the workflow is unreachable.
+    const continueAsNew = (input) => {
+        throw new ContinueAsNew(input);
+    };
+    // NOTE (determinism): a bounded wait consumes TWO logical positions (deadline + wait), an
+    // unbounded one consumes ONE. So adding or removing `{ timeoutMs }` on an existing `waitForSignal`
+    // shifts the seq of every later step — treat it as a workflow-version change for in-flight runs.
+    // Consume a buffered signal (one delivered before this run was waiting), recording it as the
+    // signal checkpoint at `seq` so it resumes immediately instead of suspending. Replay-safe: the
+    // checkpoint makes the consumption deterministic.
+    const consumeBuffered = async (token, seq) => {
+        const buffered = await store.takeBufferedSignal(token);
+        if (!buffered)
+            return null;
+        await writeCheckpoint(instantCheckpoint({
+            runId,
+            seq,
+            name: `signal:${token}`,
+            kind: 'signal',
+            output: buffered.payload,
+        }));
+        return { value: buffered.payload };
+    };
+    const waitForSignal = async (token, opts) => {
+        if (opts?.timeoutMs == null) {
+            const current = pos.next();
+            const existing = await readCheckpoint(current);
+            if (existing && existing.status === 'completed')
+                return existing.output;
+            const buffered = await consumeBuffered(token, current);
+            if (buffered)
+                return buffered.value;
+            await store.putSignalWaiter({ token, runId, seq: current });
+            throw new WorkflowSuspended();
+        }
+        const timeoutMs = opts.timeoutMs;
+        const deadlineSeq = pos.next();
+        const waitSeq = pos.next();
+        // The deadline is recorded durably as a timer checkpoint so replay knows it; the run also gets a
+        // run-level wakeAt (via WorkflowSuspended) so the timer poller resumes it at the deadline.
+        const recorded = await readCheckpoint(deadlineSeq);
+        const deadline = recorded?.wakeAt ?? host.clock() + timeoutMs;
+        if (!recorded) {
+            await writeCheckpoint(instantCheckpoint({
+                runId,
+                seq: deadlineSeq,
+                name: `timeout:${token}`,
+                kind: 'sleep',
+                wakeAt: deadline,
+            }));
+        }
+        const waited = await readCheckpoint(waitSeq);
+        if (waited && waited.status === 'completed')
+            return waited.output;
+        const buffered = await consumeBuffered(token, waitSeq);
+        if (buffered)
+            return buffered.value;
+        if (host.clock() >= deadline) {
+            await store.takeSignalWaiter(token).catch(() => undefined);
+            throw new SignalTimeoutError(token, timeoutMs);
+        }
+        await store.putSignalWaiter({ token, runId, seq: waitSeq });
+        throw new WorkflowSuspended(deadline);
+    };
+    // Wait for a named event delivered by engine.publishEvent(name, payload). Like waitForSignal, but
+    // name-based pub/sub with optional `match` filtering — the token embeds name + match (see events.ts),
+    // so a publish fans out to the runs whose match the payload satisfies.
+    const waitForEvent = async (name, opts) => {
+        if (opts?.timeoutMs == null) {
+            const current = pos.next();
+            const token = eventToken(name, opts?.match, runId, current);
+            const existing = await readCheckpoint(current);
+            if (existing && existing.status === 'completed')
+                return existing.output;
+            await store.putSignalWaiter({ token, runId, seq: current });
+            throw new WorkflowSuspended();
+        }
+        const timeoutMs = opts.timeoutMs;
+        const deadlineSeq = pos.next();
+        const waitSeq = pos.next();
+        const token = eventToken(name, opts.match, runId, waitSeq);
+        const recorded = await readCheckpoint(deadlineSeq);
+        const deadline = recorded?.wakeAt ?? host.clock() + timeoutMs;
+        if (!recorded) {
+            await writeCheckpoint(instantCheckpoint({
+                runId,
+                seq: deadlineSeq,
+                name: `timeout:event:${name}`,
+                kind: 'sleep',
+                wakeAt: deadline,
+            }));
+        }
+        const waited = await readCheckpoint(waitSeq);
+        if (waited && waited.status === 'completed')
+            return waited.output;
+        if (host.clock() >= deadline) {
+            await store.takeSignalWaiter(token).catch(() => undefined);
+            throw new SignalTimeoutError(`event:${name}`, timeoutMs);
+        }
+        await store.putSignalWaiter({ token, runId, seq: waitSeq });
+        throw new WorkflowSuspended(deadline);
+    };
+    // An external task = a checkpointed dispatch + a wait for its async-completion `Completion`
+    // (delivered by engine.completeTask/failTask). The whole "fire at a foreign system, suspend,
+    // resume when it reports back" pattern as one call.
+    const task = async (name, dispatch, options) => {
+        await step(`task:dispatch:${name}`, dispatch, options);
+        return unwrapCompletion(await waitForSignal(`task:${runId}:${name}`), `task "${name}"`);
+    };
+    // Child workflow (await result): start it once, then suspend on a `child:<id>` waiter the child
+    // signals on its terminal state (see engine.notifyParent).
+    const child = async (workflow, input, options) => {
+        const { childId, priority } = normalizeChildOptions(options);
+        const current = pos.next();
+        const id = childId ?? `${runId}.child.${current}`;
+        const existing = await readCheckpoint(current);
+        if (existing && existing.status === 'completed') {
+            return unwrapCompletion(existing.output, `child "${id}"`);
+        }
+        await store.putSignalWaiter({ token: `child:${id}`, runId, seq: current });
+        if (!(await store.getRun(id)))
+            host.startChild(workflowName(workflow), input, id, priority);
+        // Make the awaited child visible in the parent's timeline WHILE it runs: a `running` placeholder
+        // at this seq with the same `signal:child:<id>` name the signal resolution later overwrites as
+        // `completed`. So the dashboard shows the child node (and can inline-expand it) live, instead of
+        // it appearing only when it finishes. Written once (skipped on replay, where `existing` is set);
+        // `running` is ignored by replay history, so it never short-circuits determinism.
+        if (!existing) {
+            await writeCheckpoint(instantCheckpoint({
+                runId,
+                seq: current,
+                name: `signal:child:${id}`,
+                kind: 'signal',
+                status: 'running',
+            }));
+        }
+        throw new WorkflowSuspended();
+    };
+    // Child workflow (fire-and-forget): dispatch it once and return its id WITHOUT suspending. The
+    // start is checkpointed at this position so replay returns the same id without re-dispatching, and
+    // is idempotent by id, so `child(..., sameId)` later joins the same run rather than starting a new
+    // one (start + join scatter-gather).
+    const startChild = async (workflow, input, options) => {
+        const { childId, priority } = normalizeChildOptions(options);
+        const current = pos.next();
+        const id = childId ?? `${runId}.child.${current}`;
+        const existing = await readCheckpoint(current);
+        if (existing && existing.status === 'completed')
+            return existing.output;
+        if (!(await store.getRun(id)))
+            host.startChild(workflowName(workflow), input, id, priority);
+        await writeCheckpoint(instantCheckpoint({ runId, seq: current, name: `spawn:${id}`, kind: 'local', output: id }));
+        return id;
+    };
+    // Call a durable entity op and await its result: register a reply waiter at this position, dispatch
+    // the op with the reply token, and suspend until the entity signals the result back (checkpointed,
+    // so replay returns it without re-dispatching).
+    const callEntity = async (name, key, op, arg) => {
+        const current = pos.next();
+        const existing = await readCheckpoint(current);
+        if (existing && existing.status === 'completed')
+            return existing.output;
+        const reply = `entityreply:${runId}:${current}`;
+        await store.putSignalWaiter({ token: reply, runId, seq: current });
+        host.signalEntity?.(name, key, op, arg, reply);
+        throw new WorkflowSuspended();
+    };
+    // Send a durable entity op without awaiting a result — dispatched once (checkpointed, replay-safe).
+    const signalEntity = async (name, key, op, arg) => {
+        const current = pos.next();
+        const existing = await readCheckpoint(current);
+        if (existing && existing.status === 'completed')
+            return;
+        host.signalEntity?.(name, key, op, arg);
+        await writeCheckpoint(instantCheckpoint({ runId, seq: current, name: `entitysig:${name}:${key}`, kind: 'local' }));
+    };
+    // A breakpoint = a visible `pending` checkpoint + a signal waiter the dashboard resumes via
+    // `engine.continue`. Reuses the signal machinery, so resume overwrites the pending checkpoint
+    // with a completed one and the run replays past it.
+    const breakpoint = async (label) => {
+        const current = pos.next();
+        const existing = await readCheckpoint(current);
+        if (existing && existing.status === 'completed')
+            return;
+        if (!existing) {
+            await writeCheckpoint(instantCheckpoint({
+                runId,
+                seq: current,
+                name: label ? `breakpoint:${label}` : 'breakpoint',
+                kind: 'signal',
+                status: 'pending',
+            }));
+            await store.putSignalWaiter({ token: breakpointToken(runId, current), runId, seq: current });
+        }
+        throw new WorkflowSuspended();
+    };
+    // Guard an in-place change: a fresh run records a `patch:<id>` marker here and takes the new
+    // branch; a run recorded under the OLD code finds a real step at this position instead, so we
+    // rewind the logical position (the marker is transparent to it) and return false — its replay
+    // reads that old step next and follows the old branch. No position shift → no corruption.
+    const patched = async (id) => {
+        const marker = `patch:${id}`;
+        const current = pos.next();
+        const existing = await readCheckpoint(current);
+        if (existing) {
+            if (existing.name === marker)
+                return true;
+            if (existing.name.startsWith('patch:')) {
+                throw new NonDeterminismError(runId, current, marker, existing.name);
+            }
+            pos.rewind(); // not a marker: an old run's step lives here — give the position back to it
+            return false;
+        }
+        await writeCheckpoint(instantCheckpoint({ runId, seq: current, name: marker, kind: 'local', output: true }));
+        return true;
+    };
+    // An update point: suspend on a run-scoped `update:<runId>:<name>` token that engine.update
+    // delivers to (after its validator passes). Reuses the signal machinery; run-scoped like task/child.
+    const onUpdate = (name, opts) => waitForSignal(`update:${runId}:${name}`, opts);
+    // A queryable named value: a checkpoint whose `name` is `event:<key>`, so the latest value for a
+    // key is just the highest-seq such checkpoint (read by engine.getEvent). Replay-idempotent.
+    const setEvent = async (key, value) => {
+        const current = pos.next();
+        const name = `event:${key}`;
+        const existing = await readCheckpoint(current);
+        if (existing && existing.name !== name) {
+            throw new NonDeterminismError(runId, current, name, existing.name);
+        }
+        if (existing && existing.status === 'completed')
+            return; // replay: already published
+        await writeCheckpoint(instantCheckpoint({ runId, seq: current, name, kind: 'local', output: value }));
+    };
+    // A durable webhook reserves a logical position NOW to mint a stable token, so the url can be
+    // handed to a third party before `wait()` suspends. `wait()` then parks on that same position
+    // until the callback lands as engine.signal(token, body) — single position, replay-safe.
+    const webhook = () => {
+        const current = pos.next();
+        const token = `wh:${runId}:${current}`;
+        const wait = async () => {
+            const existing = await readCheckpoint(current);
+            if (existing && existing.status === 'completed')
+                return existing.output;
+            await store.putSignalWaiter({ token, runId, seq: current });
+            throw new WorkflowSuspended();
+        };
+        return { token, url: host.webhookUrl?.(token), wait };
+    };
+    // Deterministic non-deterministic sources: each is a checkpointed local step, so the value is
+    // captured on the first run and replayed verbatim (a raw Date.now()/Math.random() inside a
+    // workflow would differ across replays and corrupt the run).
+    const now = () => step('now', async () => host.clock());
+    const random = () => step('random', async () => Math.random());
+    const uuid = () => step('uuid', async () => globalThis.crypto.randomUUID());
+    return {
+        runId,
+        step,
+        transaction,
+        callEntity,
+        signalEntity,
+        sleep,
+        sleepUntil,
+        continueAsNew,
+        waitForSignal,
+        waitForEvent,
+        task,
+        child,
+        startChild,
+        breakpoint,
+        webhook,
+        setEvent,
+        onUpdate,
+        patched,
+        now,
+        random,
+        uuid,
+        call: (remote, input, opts) => host.callRemote(runId, pos.next(), remote, input, opts?.queue, opts?.transport, {
+            priority: opts?.priority,
+            fairnessKey: opts?.fairnessKey,
+        }),
+    };
+}
+//# sourceMappingURL=workflow-ctx.js.map

package/dist/src/workflow-ctx.js.map

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

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

@@ -0,0 +1,34 @@
+/**
+ * A **workflow reference** is how one workflow names another to call it: either a registered workflow
+ * **name** (a string — the only option across runtimes, e.g. a Python workflow) or, for a same-runtime
+ * TypeScript workflow, its **class**. The class carries the input/output types through the call, so
+ * `ctx.child(ShippingWorkflow, input)` type-checks the input and returns a typed result — while a
+ * string stays available for the cross-runtime case.
+ */
+/**
+ * The symbol the `@Workflow` decorator stamps a workflow's registered name onto, so a class ref can
+ * be resolved back to its name. A global-registry symbol (`Symbol.for`) so it survives duplicate
+ * copies of this package in a dependency tree.
+ */
+export declare const WORKFLOW_NAME_KEY: unique symbol;
+/** Structural shape of a `@Workflow` class — its `run(ctx, input)` carries the input/output types. */
+export type WorkflowClass<TInput = unknown, TOutput = unknown> = abstract new (...args: never[]) => {
+    run(ctx: never, input: TInput): Promise<TOutput> | TOutput;
+};
+/** A workflow reference: a registered name (cross-runtime) or a workflow class (typed, same-runtime). */
+export type WorkflowRef<TInput = unknown, TOutput = unknown> = string | WorkflowClass<TInput, TOutput>;
+/** The input type a workflow class's `run` accepts. */
+export type WorkflowInputOf<C> = C extends abstract new (...args: never[]) => {
+    run(ctx: never, input: infer I): unknown;
+} ? I : unknown;
+/** The output type a workflow class's `run` resolves to (Promise unwrapped). */
+export type WorkflowOutputOf<C> = C extends abstract new (...args: never[]) => {
+    run(ctx: never, input: never): infer R;
+} ? Awaited<R> : unknown;
+/**
+ * Resolve a {@link WorkflowRef} to its registered workflow name: a string is returned as-is; a
+ * `@Workflow` class is resolved via the name the decorator stamped on it. Throws if a class was
+ * never decorated (so it carries no registered name).
+ */
+export declare function workflowName(ref: WorkflowRef): string;
+//# sourceMappingURL=workflow-ref.d.ts.map

package/dist/src/workflow-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-ref.d.ts","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,MAAmD,CAAC;AAE3F,sGAAsG;AACtG,MAAM,MAAM,aAAa,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,MACvE,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,yGAAyG;AACzG,MAAM,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACvD,MAAM,GACN,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,uDAAuD;AACvD,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MACjD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;CAC1C,GACG,CAAC,GACD,OAAO,CAAC;AAEZ,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,MAClD,GAAG,IAAI,EAAE,KAAK,EAAE,KACb;IACH,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC;CACxC,GACG,OAAO,CAAC,CAAC,CAAC,GACV,OAAO,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASrD"}

package/dist/src/workflow-ref.js

@@ -0,0 +1,28 @@
+/**
+ * A **workflow reference** is how one workflow names another to call it: either a registered workflow
+ * **name** (a string — the only option across runtimes, e.g. a Python workflow) or, for a same-runtime
+ * TypeScript workflow, its **class**. The class carries the input/output types through the call, so
+ * `ctx.child(ShippingWorkflow, input)` type-checks the input and returns a typed result — while a
+ * string stays available for the cross-runtime case.
+ */
+/**
+ * The symbol the `@Workflow` decorator stamps a workflow's registered name onto, so a class ref can
+ * be resolved back to its name. A global-registry symbol (`Symbol.for`) so it survives duplicate
+ * copies of this package in a dependency tree.
+ */
+export const WORKFLOW_NAME_KEY = Symbol.for('@agora/durable:workflow-name');
+/**
+ * Resolve a {@link WorkflowRef} to its registered workflow name: a string is returned as-is; a
+ * `@Workflow` class is resolved via the name the decorator stamped on it. Throws if a class was
+ * never decorated (so it carries no registered name).
+ */
+export function workflowName(ref) {
+    if (typeof ref === 'string')
+        return ref;
+    const name = ref[WORKFLOW_NAME_KEY];
+    if (!name) {
+        throw new Error(`workflow class ${ref.name} has no registered name — is it decorated with @Workflow({ name })?`);
+    }
+    return name;
+}
+//# sourceMappingURL=workflow-ref.js.map

package/dist/src/workflow-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-ref.js","sourceRoot":"","sources":["../../src/workflow-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAgC3F;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAgB;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,IAAI,GAAI,GAAwC,CAAC,iBAAiB,CAAC,CAAC;IAC1E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,kBAAkB,GAAG,CAAC,IAAI,qEAAqE,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/stubs/config/durable.stub

@@ -0,0 +1,49 @@
+{{{
+  exports({ to: app.configPath('durable.ts') })
+}}}
+import { defineConfig, transports } from '@adonis-agora/durable'
+
+/**
+ * Configuration for @adonis-agora/durable. Pick a `transport` (and optionally a `store`) by name from the
+ * maps below; each driver's peer dependency is imported lazily, only when selected. The default is
+ * the in-process `memory` transport + the in-memory store — single-process, no extra infrastructure.
+ *
+ * For cross-process / production, select the `queue` (@adonisjs/queue) or `db` (@adonisjs/lucid)
+ * transport, and the `lucid` store, then run `node ace migration:run`:
+ *
+ * ```ts
+ * import { defineConfig, transports, stores } from '@adonis-agora/durable'
+ *
+ * export default defineConfig({
+ *   transport: 'queue',
+ *   transports: {
+ *     memory: transports.memory(),
+ *     // `connection` names an adapter from config/queue.ts (configure @adonisjs/queue first):
+ *     queue: transports.queue({ connection: 'redis', group: 'durable' }),
+ *     db: transports.db(),
+ *   },
+ *   store: 'lucid',
+ *   stores: {
+ *     lucid: stores.lucid(),
+ *   },
+ * })
+ * ```
+ */
+export default defineConfig({
+  transport: 'memory',
+  transports: {
+    memory: transports.memory(),
+  },
+  // leaseMs: 30_000,
+
+  /**
+   * Recurring workflows fired by the `durable:work` worker loop on every tick. Each window starts
+   * exactly once even with several worker instances racing (idempotent by the schedule's time-bucket
+   * run id). Use `everyMs` for a fixed interval, or `cron` + `timezone` for a calendar schedule (cron
+   * needs the optional `cron-parser` peer dependency). See docs/authoring/scheduling.
+   */
+  // schedules: [
+  //   { key: 'nightly-report', workflow: 'daily-report', cron: '0 2 * * *', timezone: 'America/Sao_Paulo' },
+  //   { key: 'cache-sync', workflow: 'cache-sync', everyMs: 5 * 60 * 1000 },
+  // ],
+})

package/dist/stubs/config/durable_dashboard.stub

@@ -0,0 +1,17 @@
+{{{
+  exports({ to: app.configPath('durable_dashboard.ts') })
+}}}
+import { defineConfig } from '@adonis-agora/durable/dashboard'
+
+/**
+ * Configuration for the @adonis-agora/durable dashboard.
+ *
+ * By default the dashboard is open OUTSIDE production, and in production it
+ * requires a bearer token equal to `DURABLE_DASHBOARD_TOKEN` (deny if unset).
+ * Replace `authorize` with your own guard (session, role, IP allow-list, …).
+ */
+export default defineConfig({
+  // enabled: true,
+  // path: '/durable',
+  // authorize: (ctx) => ctx.auth.user?.isAdmin === true,
+})