@adonis-agora/durable 0.1.0

package/dist/src/scheduler.js.map

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

package/dist/src/search-attributes.d.ts

@@ -0,0 +1,48 @@
+import type { AttributeFilter, AttributeOp, RunQuery, WorkflowRun } from './interfaces.js';
+import type { SearchAttributes } from './interfaces.js';
+/**
+ * Does a run's search attributes satisfy EVERY filter (AND)? A missing key never matches (so `ne`
+ * on an absent key is false too — the attribute simply isn't there to compare). Empty/undefined
+ * filters match everything. Shared by every store so typed/range queries behave identically across
+ * adapters (applied in-process after the coarse workflow/status/tag filters).
+ */
+export declare function matchesAttributes(attributes: SearchAttributes | undefined, filters: AttributeFilter[] | undefined): boolean;
+/**
+ * Apply a query's attribute predicates then its `offset`/`limit`, in-process — for store adapters
+ * that can't express typed/range predicates in SQL. Pass rows already coarse-filtered (workflow /
+ * status / tag) and sorted newest-first; this filters by `attributes` and paginates. Only call it
+ * when `query.attributes` is set (otherwise let the DB do `LIMIT`/`OFFSET`).
+ */
+export declare function applyAttributeQuery(rows: WorkflowRun[], query: RunQuery): WorkflowRun[];
+/**
+ * One normalized row of the `durable_run_attributes` side-table: a single (key → value) pair of a
+ * run's search attributes, split into typed columns so SQL can index/range-scan it. Exactly one of
+ * `strValue`/`numValue` is set per row (booleans normalize to a string `"true"`/`"false"` so `eq`/`ne`
+ * still match). NULL for the column that doesn't apply, which keeps `(key, numValue)` /
+ * `(key, strValue)` indexes selective.
+ */
+export interface RunAttributeRow {
+    runId: string;
+    key: string;
+    strValue: string | null;
+    numValue: number | null;
+}
+/**
+ * Explode a run's search attributes into normalized side-table rows (one per key). Used by SQL stores
+ * to maintain `durable_run_attributes` on every create/update and by the in-memory store's index, so
+ * attribute predicates can be pushed DOWN into a join/EXISTS instead of scanned in-process. Numbers go
+ * to `numValue`; strings to `strValue`; booleans to `strValue` as `"true"`/`"false"` (matching how the
+ * in-process `compare` treats `eq`/`ne` on booleans). Returns `[]` for a run with no attributes.
+ */
+export declare function normalizeAttributeRows(runId: string, attributes: SearchAttributes | undefined): RunAttributeRow[];
+/** SQL comparison operator for an {@link AttributeOp} (used to build pushdown predicates). */
+export declare function sqlComparator(op: AttributeOp): string;
+/**
+ * Which side-table column an attribute filter compares against: numeric operands (and range ops on
+ * numbers) hit `numValue`; everything else hits `strValue` (booleans are stored as `"true"`/`"false"`).
+ * Keeping this in core means every SQL adapter pushes predicates down identically.
+ */
+export declare function attributeColumnFor(filter: AttributeFilter): 'numValue' | 'strValue';
+/** The literal a side-table predicate compares against (booleans → `"true"`/`"false"` strings). */
+export declare function attributeOperand(filter: AttributeFilter): string | number;
+//# sourceMappingURL=search-attributes.d.ts.map

package/dist/src/search-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-attributes.d.ts","sourceRoot":"","sources":["../../src/search-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAoBxD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,GAAG,SAAS,EACxC,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS,GACrC,OAAO,CAIT;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,WAAW,EAAE,CAKvF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,gBAAgB,GAAG,SAAS,GACvC,eAAe,EAAE,CAanB;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAerD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU,GAAG,UAAU,CAEnF;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,CAGzE"}

package/dist/src/search-attributes.js

@@ -0,0 +1,98 @@
+/** Compare one attribute value against a filter operand. Range ops need both sides comparable. */
+function compare(actual, op, expected) {
+    switch (op) {
+        case 'eq':
+            return actual === expected;
+        case 'ne':
+            return actual !== expected;
+        case 'gt':
+            return actual != null && actual > expected;
+        case 'gte':
+            return actual != null && actual >= expected;
+        case 'lt':
+            return actual != null && actual < expected;
+        case 'lte':
+            return actual != null && actual <= expected;
+    }
+}
+/**
+ * Does a run's search attributes satisfy EVERY filter (AND)? A missing key never matches (so `ne`
+ * on an absent key is false too — the attribute simply isn't there to compare). Empty/undefined
+ * filters match everything. Shared by every store so typed/range queries behave identically across
+ * adapters (applied in-process after the coarse workflow/status/tag filters).
+ */
+export function matchesAttributes(attributes, filters) {
+    if (!filters?.length)
+        return true;
+    if (!attributes)
+        return false;
+    return filters.every((f) => f.key in attributes && compare(attributes[f.key], f.op, f.value));
+}
+/**
+ * Apply a query's attribute predicates then its `offset`/`limit`, in-process — for store adapters
+ * that can't express typed/range predicates in SQL. Pass rows already coarse-filtered (workflow /
+ * status / tag) and sorted newest-first; this filters by `attributes` and paginates. Only call it
+ * when `query.attributes` is set (otherwise let the DB do `LIMIT`/`OFFSET`).
+ */
+export function applyAttributeQuery(rows, query) {
+    const filtered = rows.filter((r) => matchesAttributes(r.searchAttributes, query.attributes));
+    const offset = query.offset ?? 0;
+    const limit = query.limit ?? filtered.length;
+    return filtered.slice(offset, offset + limit);
+}
+/**
+ * Explode a run's search attributes into normalized side-table rows (one per key). Used by SQL stores
+ * to maintain `durable_run_attributes` on every create/update and by the in-memory store's index, so
+ * attribute predicates can be pushed DOWN into a join/EXISTS instead of scanned in-process. Numbers go
+ * to `numValue`; strings to `strValue`; booleans to `strValue` as `"true"`/`"false"` (matching how the
+ * in-process `compare` treats `eq`/`ne` on booleans). Returns `[]` for a run with no attributes.
+ */
+export function normalizeAttributeRows(runId, attributes) {
+    if (!attributes)
+        return [];
+    const out = [];
+    for (const [key, value] of Object.entries(attributes)) {
+        if (typeof value === 'number') {
+            out.push({ runId, key, strValue: null, numValue: value });
+        }
+        else if (typeof value === 'boolean') {
+            out.push({ runId, key, strValue: value ? 'true' : 'false', numValue: null });
+        }
+        else {
+            out.push({ runId, key, strValue: value, numValue: null });
+        }
+    }
+    return out;
+}
+/** SQL comparison operator for an {@link AttributeOp} (used to build pushdown predicates). */
+export function sqlComparator(op) {
+    switch (op) {
+        case 'eq':
+            return '=';
+        case 'ne':
+            return '<>';
+        case 'gt':
+            return '>';
+        case 'gte':
+            return '>=';
+        case 'lt':
+            return '<';
+        case 'lte':
+            return '<=';
+    }
+}
+/**
+ * Which side-table column an attribute filter compares against: numeric operands (and range ops on
+ * numbers) hit `numValue`; everything else hits `strValue` (booleans are stored as `"true"`/`"false"`).
+ * Keeping this in core means every SQL adapter pushes predicates down identically.
+ */
+export function attributeColumnFor(filter) {
+    return typeof filter.value === 'number' ? 'numValue' : 'strValue';
+}
+/** The literal a side-table predicate compares against (booleans → `"true"`/`"false"` strings). */
+export function attributeOperand(filter) {
+    if (typeof filter.value === 'boolean')
+        return filter.value ? 'true' : 'false';
+    return filter.value;
+}
+//# sourceMappingURL=search-attributes.js.map

package/dist/src/search-attributes.js.map

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

package/dist/src/singleton-gate.d.ts

@@ -0,0 +1,44 @@
+import type { SingletonConfig } from './engine.js';
+import type { StateStore, WorkflowRun } from './interfaces.js';
+export interface SingletonGateDeps {
+    store: Pick<StateStore, 'listRuns' | 'updateRun'>;
+    clock: () => number;
+    /** Hand a gated run to the run dispatcher (fire-and-forget, like the engine's other dispatches). */
+    dispatch: (runId: string) => void;
+    /** Resolve a settled run's singleton config from the engine's workflow registry. */
+    configFor: (run: WorkflowRun) => SingletonConfig | undefined;
+}
+/**
+ * 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
+ * singleton feature lives in one place instead of being smeared across `start`, `execute`, both run
+ * loops, and `cancel`.
+ */
+export declare class SingletonGate {
+    private readonly deps;
+    constructor(deps: SingletonGateDeps);
+    /** The tag a singleton run carries, so the gate can find others sharing its key. */
+    tag(cfg: SingletonConfig, input: unknown): string;
+    /** Next wake time for a gated run: the base retry delay jittered to avoid a wakeup stampede. */
+    retryWakeAt(): number;
+    /**
+     * 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.
+     */
+    assertCapacity(workflow: string, cfg: SingletonConfig, input: unknown): Promise<void>;
+    /**
+     * 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.
+     */
+    admit(run: WorkflowRun, cfg: SingletonConfig): Promise<boolean>;
+    /**
+     * Notify-on-release: a singleton run settled (freeing a slot), so dispatch the oldest gated
+     * (`suspended` + same tag) waiters now instead of waiting for their ~1s retry timer. Each re-checks
+     * admission in the executor and runs only if it actually wins a slot, so FIFO/race-free guarantees
+     * hold; the durable timer remains the cross-instance/crash fallback.
+     */
+    wakeNext(settled: WorkflowRun): Promise<void>;
+}
+//# sourceMappingURL=singleton-gate.d.ts.map

package/dist/src/singleton-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton-gate.d.ts","sourceRoot":"","sources":["../../src/singleton-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAU/D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC;IAClD,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,oGAAoG;IACpG,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,oFAAoF;IACpF,SAAS,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,eAAe,GAAG,SAAS,CAAC;CAC9D;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,iBAAiB;IAEpD,oFAAoF;IACpF,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;IAIjD,gGAAgG;IAChG,WAAW,IAAI,MAAM;IAQrB;;;;OAIG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3F;;;;OAIG;IACG,KAAK,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrE;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBpD"}

package/dist/src/singleton-gate.js

@@ -0,0 +1,90 @@
+import { SingletonQueueFullError } from './errors.js';
+const SINGLETON_RETRY_MS = 1000;
+/**
+ * Max jitter (ms, each direction) added to {@link SINGLETON_RETRY_MS} so a queue of N gated runs
+ * doesn't wake in lockstep and stampede the admission scan. Each retry picks an independent offset
+ * in `[-SINGLETON_RETRY_JITTER_MS, +SINGLETON_RETRY_JITTER_MS]`.
+ */
+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
+ * singleton feature lives in one place instead of being smeared across `start`, `execute`, both run
+ * loops, and `cancel`.
+ */
+export class SingletonGate {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** The tag a singleton run carries, so the gate can find others sharing its key. */
+    tag(cfg, input) {
+        return `singleton:${cfg.key(input)}`;
+    }
+    /** Next wake time for a gated run: the base retry delay jittered to avoid a wakeup stampede. */
+    retryWakeAt() {
+        return (this.deps.clock() +
+            SINGLETON_RETRY_MS +
+            Math.floor((Math.random() * 2 - 1) * SINGLETON_RETRY_JITTER_MS));
+    }
+    /**
+     * 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.
+     */
+    async assertCapacity(workflow, cfg, input) {
+        if (cfg.maxQueueDepth == null)
+            return;
+        const cap = (cfg.limit ?? 1) + cfg.maxQueueDepth;
+        const queued = await this.deps.store.listRuns({
+            tag: this.tag(cfg, input),
+            workflow,
+            statuses: ['pending', 'running', 'suspended'],
+        });
+        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.
+     */
+    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 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);
+    }
+    /**
+     * Notify-on-release: a singleton run settled (freeing a slot), so dispatch the oldest gated
+     * (`suspended` + same tag) waiters now instead of waiting for their ~1s retry timer. Each re-checks
+     * admission in the executor and runs only if it actually wins a slot, so FIFO/race-free guarantees
+     * hold; the durable timer remains the cross-instance/crash fallback.
+     */
+    async wakeNext(settled) {
+        const cfg = this.deps.configFor(settled);
+        if (!cfg)
+            return;
+        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));
+        for (const next of gated.slice(0, cfg.limit ?? 1)) {
+            // Clear the durable retry timer as we hand the run over, so the timer poller can't also pick it
+            // up and double-dispatch. Only for runs that carry a wakeAt; dispatch after the clear commits.
+            if (next.wakeAt != null) {
+                await this.deps.store
+                    .updateRun(next.id, { wakeAt: undefined, updatedAt: new Date() })
+                    .catch(() => undefined);
+            }
+            this.deps.dispatch(next.id);
+        }
+    }
+}
+//# sourceMappingURL=singleton-gate.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { StepEvent, StepLogger } from './interfaces.js';
+/**
+ * A {@link StepLogger} that appends to `events`, stamping each line with `now()`. Shared by the
+ * local-step path (`ctx.step`) and the remote-worker path (`runStepHandler`) so a step records
+ * the same {@link StepEvent} shape wherever it runs — the TypeScript twin of the Python SDK's
+ * `StepContext`.
+ */
+export declare function createStepLogger(events: StepEvent[], now: () => number): StepLogger;
+//# sourceMappingURL=step-logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"step-logger.d.ts","sourceRoot":"","sources":["../../src/step-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAC;AAW/E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,UAAU,CAwEnF"}

package/dist/src/step-logger.js

@@ -0,0 +1,89 @@
+/** Attach the elapsed `durationMs` (from `start`) to `data`, unless the caller already set one. */
+function withDuration(start, now, data) {
+    if (data && typeof data === 'object' && 'durationMs' in data) {
+        return data;
+    }
+    const base = data && typeof data === 'object' ? data : {};
+    return { ...base, durationMs: now() - start };
+}
+/**
+ * A {@link StepLogger} that appends to `events`, stamping each line with `now()`. Shared by the
+ * local-step path (`ctx.step`) and the remote-worker path (`runStepHandler`) so a step records
+ * the same {@link StepEvent} shape wherever it runs — the TypeScript twin of the Python SDK's
+ * `StepContext`.
+ */
+export function createStepLogger(events, now) {
+    // The sub-process a `subProcess(...)` body is currently inside; debug/info/warn/error emitted while
+    // inside get tagged with its id, so the dashboard groups that log trail under the sub-process.
+    let currentSub;
+    const push = (level, message, data) => events.push({
+        at: now(),
+        level,
+        message,
+        ...(currentSub ? { subId: currentSub.id } : {}),
+        ...(data === undefined ? {} : { data }),
+    });
+    const subEvent = (e) => events.push({
+        at: now(),
+        level: e.status === 'failed' ? 'error' : e.status === 'skipped' ? 'warn' : 'info',
+        message: e.message ?? e.phase ?? e.name,
+        subId: e.id,
+        name: e.name,
+        ...(e.group === undefined ? {} : { group: e.group }),
+        ...(e.phase === undefined ? {} : { phase: e.phase }),
+        ...(e.status === undefined ? {} : { status: e.status }),
+        ...(e.data === undefined ? {} : { data: e.data }),
+    });
+    const subProcess = async (name, body, opts) => {
+        const id = opts?.id ?? globalThis.crypto.randomUUID();
+        const group = opts?.group;
+        const start = now();
+        const prevSub = currentSub;
+        currentSub = { id };
+        let terminal = false;
+        const emit = (status, message, data) => {
+            if (terminal)
+                return;
+            terminal = true;
+            subEvent({ id, name, group, status, message, data: withDuration(start, now, data) });
+        };
+        const handle = {
+            phase: (phase, data) => {
+                if (!terminal)
+                    subEvent({ id, name, group, phase, data });
+                return handle;
+            },
+            skip: (reason, data) => emit('skipped', reason, data),
+            fail: (reason, data) => emit('failed', reason, data),
+        };
+        try {
+            const result = await body(handle);
+            emit('ok'); // no-op if the body already called skip()/fail()
+            return result;
+        }
+        catch (err) {
+            emit('failed', err instanceof Error ? err.message : String(err));
+            throw err;
+        }
+        finally {
+            currentSub = prevSub;
+        }
+    };
+    return {
+        debug: (m, d) => push('debug', m, d),
+        info: (m, d) => push('info', m, d),
+        warn: (m, d) => push('warn', m, d),
+        error: (m, d) => push('error', m, d),
+        sub: (name, status, message, data) => events.push({
+            at: now(),
+            level: status === 'failed' ? 'error' : status === 'skipped' ? 'warn' : 'info',
+            message: message ?? name,
+            name,
+            status,
+            ...(data === undefined ? {} : { data }),
+        }),
+        subEvent,
+        subProcess,
+    };
+}
+//# sourceMappingURL=step-logger.js.map

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

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

package/dist/src/stores/factory.d.ts

@@ -0,0 +1,42 @@
+import type { StateStore } from '../interfaces.js';
+import type { TransportContext } from '../transports/factory.js';
+/**
+ * The runtime context a {@link StoreFactory} thunk receives when the durable provider builds the
+ * configured state store at boot. Shares {@link TransportContext} so a driver can resolve a peer's
+ * service (the Lucid `db`) from the booted application if it needs to.
+ */
+export type StoreContext = TransportContext;
+/**
+ * A configured state store: a thunk the durable provider calls at boot to build the {@link StateStore}.
+ * Each factory lazily imports its peer dependency (`@adonisjs/lucid`) inside the thunk, so the driver
+ * is only loaded when it is actually selected — keeping that package optional.
+ */
+export type StoreFactory = (ctx: StoreContext) => Promise<StateStore>;
+/** Options for the Lucid-backed persistent store. */
+export interface LucidStoreConfig {
+    /** Lucid connection name to use. Defaults to the `Database` default connection. */
+    connection?: string;
+}
+/**
+ * The store factory namespace used in `config/durable.ts`:
+ *
+ * ```ts
+ * import { defineConfig, stores } from '@adonis-agora/durable'
+ *
+ * export default defineConfig({
+ *   store: 'lucid',
+ *   stores: {
+ *     lucid: stores.lucid({ connection: 'pg' }),
+ *   },
+ * })
+ * ```
+ *
+ * Each factory returns a {@link StoreFactory} — a lazy thunk. Calling it in the config file costs
+ * nothing; the peer dependency is only imported when the provider builds the selected store at boot.
+ * Omit `store` entirely to use the in-process `InMemoryStateStore` (single-process, no extra infra).
+ */
+export declare const stores: {
+    /** Persist runs/checkpoints/timers/signals in SQL via `@adonisjs/lucid`. */
+    lucid(config?: LucidStoreConfig): StoreFactory;
+};
+//# sourceMappingURL=factory.d.ts.map

package/dist/src/stores/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtE,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM;IACjB,4EAA4E;mBAC9D,gBAAgB,GAAQ,YAAY;CAUnD,CAAC"}

package/dist/src/stores/factory.js

@@ -0,0 +1,29 @@
+/**
+ * The store factory namespace used in `config/durable.ts`:
+ *
+ * ```ts
+ * import { defineConfig, stores } from '@adonis-agora/durable'
+ *
+ * export default defineConfig({
+ *   store: 'lucid',
+ *   stores: {
+ *     lucid: stores.lucid({ connection: 'pg' }),
+ *   },
+ * })
+ * ```
+ *
+ * Each factory returns a {@link StoreFactory} — a lazy thunk. Calling it in the config file costs
+ * nothing; the peer dependency is only imported when the provider builds the selected store at boot.
+ * Omit `store` entirely to use the in-process `InMemoryStateStore` (single-process, no extra infra).
+ */
+export const stores = {
+    /** Persist runs/checkpoints/timers/signals in SQL via `@adonisjs/lucid`. */
+    lucid(config = {}) {
+        return async () => {
+            const db = (await import('@adonisjs/lucid/services/db')).default;
+            const { LucidStateStore } = await import('./lucid.js');
+            return new LucidStateStore(db, config.connection !== undefined ? { connectionName: config.connection } : {});
+        };
+    },
+};
+//# sourceMappingURL=factory.js.map

package/dist/src/stores/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,4EAA4E;IAC5E,KAAK,CAAC,SAA2B,EAAE;QACjC,OAAO,KAAK,IAAI,EAAE;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC,OAAO,CAAC;YACjE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YACvD,OAAO,IAAI,eAAe,CACxB,EAAE,EACF,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAC7E,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/stores/lucid-helpers.d.ts

@@ -0,0 +1,11 @@
+import { Database } from '@adonisjs/lucid/database';
+/**
+ * Build a standalone Lucid `Database` pointed at an in-memory SQLite (`better-sqlite3`) — the
+ * "using Lucid outside an app" pattern. We construct `Database(config, logger, emitter)` directly
+ * (the same three args Lucid's provider passes) so the store can be exercised against real SQL with
+ * no AdonisJS app boot.
+ */
+export declare function makeMemoryDb(): Database;
+/** A fresh in-memory db with the durable tables already created. */
+export declare function makeStoreDb(): Promise<Database>;
+//# sourceMappingURL=lucid-helpers.d.ts.map

package/dist/src/stores/lucid-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid-helpers.d.ts","sourceRoot":"","sources":["../../../src/stores/lucid-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAwBvC;AAED,oEAAoE;AACpE,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CAIrD"}

package/dist/src/stores/lucid-helpers.js

@@ -0,0 +1,38 @@
+import { Emitter } from '@adonisjs/core/events';
+import { Logger } from '@adonisjs/core/logger';
+import { Database } from '@adonisjs/lucid/database';
+import { createDurableTables } from './lucid-schema.js';
+/**
+ * Build a standalone Lucid `Database` pointed at an in-memory SQLite (`better-sqlite3`) — the
+ * "using Lucid outside an app" pattern. We construct `Database(config, logger, emitter)` directly
+ * (the same three args Lucid's provider passes) so the store can be exercised against real SQL with
+ * no AdonisJS app boot.
+ */
+export function makeMemoryDb() {
+    const logger = new Logger({ enabled: false });
+    // Database needs an Emitter; in standalone use a minimal app stand-in is enough (the emitter only
+    // fans out `db:query` events, which we don't subscribe to here).
+    const emitter = new Emitter(undefined);
+    const db = new Database({
+        connection: 'sqlite',
+        connections: {
+            sqlite: {
+                client: 'better-sqlite3',
+                connection: { filename: ':memory:' },
+                useNullAsDefault: true,
+                // A `:memory:` SQLite db is per-connection: a pool of N would give N independent empty
+                // databases. Pin the pool to a single connection so every query (and the schema we create)
+                // hits the same in-memory db.
+                pool: { min: 1, max: 1 },
+            },
+        },
+    }, logger, emitter);
+    return db;
+}
+/** A fresh in-memory db with the durable tables already created. */
+export async function makeStoreDb() {
+    const db = makeMemoryDb();
+    await createDurableTables(db);
+    return db;
+}
+//# sourceMappingURL=lucid-helpers.js.map

package/dist/src/stores/lucid-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid-helpers.js","sourceRoot":"","sources":["../../../src/stores/lucid-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,kGAAkG;IAClG,iEAAiE;IACjE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAkB,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,IAAI,QAAQ,CACrB;QACE,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE;YACX,MAAM,EAAE;gBACN,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE;gBACpC,gBAAgB,EAAE,IAAI;gBACtB,uFAAuF;gBACvF,2FAA2F;gBAC3F,8BAA8B;gBAC9B,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;aACzB;SACF;KACF,EACD,MAAM,EACN,OAAO,CACR,CAAC;IACF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAC1B,MAAM,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/src/stores/lucid-mappers.d.ts

@@ -0,0 +1,58 @@
+import type { StepCheckpoint, WorkflowRun } from '../interfaces.js';
+/**
+ * Row shapes as they live in the durable tables: snake_case columns, JSON payloads stored as TEXT
+ * (we (de)serialize them here rather than relying on a driver's JSON column type, so the schema is
+ * portable across SQLite / Postgres / MySQL). Timestamps are epoch-ms numbers.
+ *
+ * NOTE: drivers can return numeric columns as strings (e.g. `bigInteger` over some dialects) and
+ * booleans/ints loosely typed, so every read goes through the guarded coercers below — never trust a
+ * raw row field's static type.
+ */
+export interface RunRow {
+    id: string;
+    workflow: string;
+    workflow_version: string;
+    status: string;
+    input: string | null;
+    output: string | null;
+    error: string | null;
+    wake_at: number | string | null;
+    locked_by: string | null;
+    locked_until: number | string | null;
+    recovery_attempts: number | string | null;
+    tags: string | null;
+    search_attributes: string | null;
+    priority: number | string | null;
+    created_at: number | string;
+    updated_at: number | string;
+}
+export interface CheckpointRow {
+    run_id: string;
+    seq: number | string;
+    name: string;
+    kind: string;
+    step_id: string;
+    status: string;
+    input: string | null;
+    output: string | null;
+    error: string | null;
+    events: string | null;
+    attempts: number | string;
+    worker_group: string | null;
+    wake_at: number | string | null;
+    enqueued_at: number | string | null;
+    started_at: number | string;
+    finished_at: number | string;
+}
+export declare function runToRow(run: WorkflowRun): RunRow;
+/**
+ * Map a run patch to a column patch using presence (`'x' in patch`) semantics for nullable fields, so
+ * a patch can CLEAR a column (e.g. `{ error: undefined }` on completion → NULL), matching the
+ * in-memory store's `{ ...existing, ...patch }` semantics. The two required Date fields use a
+ * defined-guard since they're never cleared.
+ */
+export declare function runPatchToRow(patch: Partial<WorkflowRun>): Partial<RunRow>;
+export declare function rowToRun(row: RunRow): WorkflowRun;
+export declare function checkpointToRow(cp: StepCheckpoint): CheckpointRow;
+export declare function rowToCheckpoint(row: CheckpointRow): StepCheckpoint;
+//# sourceMappingURL=lucid-mappers.d.ts.map

package/dist/src/stores/lucid-mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid-mappers.d.ts","sourceRoot":"","sources":["../../../src/stores/lucid-mappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAwB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE1F;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AA4BD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAmBjD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB1E;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA4BjD;AAID,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,aAAa,CAmBjE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAwBlE"}