@workflow/world-local 4.0.1-beta.6 → 4.1.0-beta.28

package/dist/storage/helpers.js

@@ -0,0 +1,34 @@
+import { monotonicFactory } from 'ulid';
+import { ulidToDate } from '../fs.js';
+/**
+ * Create a monotonic ULID factory that ensures ULIDs are always increasing
+ * even when generated within the same millisecond.
+ */
+export const monotonicUlid = monotonicFactory(() => Math.random());
+/**
+ * Creates a function to extract createdAt date from a filename based on ULID.
+ * Used for efficient pagination without reading file contents.
+ *
+ * @param idPrefix - The prefix to strip from filenames (e.g., 'wrun', 'evnt', 'step')
+ * @returns A function that extracts Date from filename, or null if not extractable
+ */
+export const getObjectCreatedAt = (idPrefix) => (filename) => {
+    const replaceRegex = new RegExp(`^${idPrefix}_`, 'g');
+    const dashIndex = filename.indexOf('-');
+    if (dashIndex === -1) {
+        // No dash - extract ULID from the filename (e.g., wrun_ULID.json, evnt_ULID.json)
+        const ulid = filename.replace(/\.json$/, '').replace(replaceRegex, '');
+        return ulidToDate(ulid);
+    }
+    // For composite keys like {runId}-{stepId}, extract from the appropriate part
+    if (idPrefix === 'step') {
+        // Steps use sequential IDs (step_0, step_1, etc.) - no timestamp in filename.
+        // Return null to skip filename-based optimization and defer to JSON-based filtering.
+        return null;
+    }
+    // For events: wrun_ULID-evnt_ULID.json - extract from the eventId part
+    const id = filename.substring(dashIndex + 1).replace(/\.json$/, '');
+    const ulid = id.replace(replaceRegex, '');
+    return ulidToDate(ulid);
+};
+//# sourceMappingURL=helpers.js.map

package/dist/storage/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/storage/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,CAAC,QAAgB,EAAE,EAAE,CACrB,CAAC,QAAgB,EAAe,EAAE;IAChC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,kFAAkF;QAClF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACvE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,8EAA8E;IAC9E,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,8EAA8E;QAC9E,qFAAqF;QACrF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uEAAuE;IACvE,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC,CAAC"}

package/dist/storage/hooks-storage.d.ts

@@ -0,0 +1,12 @@
+import type { Storage } from '@workflow/world';
+/**
+ * Creates a hooks storage implementation using the filesystem.
+ * Implements the Storage['hooks'] interface with hook CRUD operations.
+ */
+export declare function createHooksStorage(basedir: string): Storage['hooks'];
+/**
+ * Helper function to delete all hooks associated with a workflow run.
+ * Called when a run reaches a terminal state.
+ */
+export declare function deleteAllHooksForRun(basedir: string, runId: string): Promise<void>;
+//# sourceMappingURL=hooks-storage.d.ts.map

package/dist/storage/hooks-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-storage.d.ts","sourceRoot":"","sources":["../../src/storage/hooks-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAKV,OAAO,EACR,MAAM,iBAAiB,CAAC;AAWzB;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyEpE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/storage/hooks-storage.js

@@ -0,0 +1,89 @@
+import path from 'node:path';
+import { HookSchema } from '@workflow/world';
+import { DEFAULT_RESOLVE_DATA_OPTION } from '../config.js';
+import { deleteJSON, listJSONFiles, paginatedFileSystemQuery, readJSON, } from '../fs.js';
+import { filterHookData } from './filters.js';
+/**
+ * Creates a hooks storage implementation using the filesystem.
+ * Implements the Storage['hooks'] interface with hook CRUD operations.
+ */
+export function createHooksStorage(basedir) {
+    // Helper function to find a hook by token (shared between getByToken)
+    async function findHookByToken(token) {
+        const hooksDir = path.join(basedir, 'hooks');
+        const files = await listJSONFiles(hooksDir);
+        for (const file of files) {
+            const hookPath = path.join(hooksDir, `${file}.json`);
+            const hook = await readJSON(hookPath, HookSchema);
+            if (hook && hook.token === token) {
+                return hook;
+            }
+        }
+        return null;
+    }
+    async function get(hookId, params) {
+        const hookPath = path.join(basedir, 'hooks', `${hookId}.json`);
+        const hook = await readJSON(hookPath, HookSchema);
+        if (!hook) {
+            throw new Error(`Hook ${hookId} not found`);
+        }
+        const resolveData = params?.resolveData || DEFAULT_RESOLVE_DATA_OPTION;
+        return filterHookData(hook, resolveData);
+    }
+    async function getByToken(token) {
+        const hook = await findHookByToken(token);
+        if (!hook) {
+            throw new Error(`Hook with token ${token} not found`);
+        }
+        return hook;
+    }
+    async function list(params) {
+        const hooksDir = path.join(basedir, 'hooks');
+        const resolveData = params.resolveData || DEFAULT_RESOLVE_DATA_OPTION;
+        const result = await paginatedFileSystemQuery({
+            directory: hooksDir,
+            schema: HookSchema,
+            sortOrder: params.pagination?.sortOrder,
+            limit: params.pagination?.limit,
+            cursor: params.pagination?.cursor,
+            filePrefix: undefined, // Hooks don't have ULIDs, so we can't optimize by filename
+            filter: (hook) => {
+                // Filter by runId if provided
+                if (params.runId && hook.runId !== params.runId) {
+                    return false;
+                }
+                return true;
+            },
+            getCreatedAt: () => {
+                // Hook files don't have ULID timestamps in filename
+                // We need to read the file to get createdAt, but that's inefficient
+                // So we return the hook's createdAt directly (item.createdAt will be used for sorting)
+                // Return a dummy date to pass the null check, actual sorting uses item.createdAt
+                return new Date(0);
+            },
+            getId: (hook) => hook.hookId,
+        });
+        // Transform the data after pagination
+        return {
+            ...result,
+            data: result.data.map((hook) => filterHookData(hook, resolveData)),
+        };
+    }
+    return { get, getByToken, list };
+}
+/**
+ * Helper function to delete all hooks associated with a workflow run.
+ * Called when a run reaches a terminal state.
+ */
+export async function deleteAllHooksForRun(basedir, runId) {
+    const hooksDir = path.join(basedir, 'hooks');
+    const files = await listJSONFiles(hooksDir);
+    for (const file of files) {
+        const hookPath = path.join(hooksDir, `${file}.json`);
+        const hook = await readJSON(hookPath, HookSchema);
+        if (hook && hook.runId === runId) {
+            await deleteJSON(hookPath);
+        }
+    }
+}
+//# sourceMappingURL=hooks-storage.js.map

package/dist/storage/hooks-storage.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,10 @@
+import type { Storage } from '@workflow/world';
+/**
+ * Creates a complete storage implementation using the filesystem.
+ * This is the main entry point that composes all storage implementations.
+ *
+ * @param basedir - The base directory for storing workflow data
+ * @returns A complete Storage implementation
+ */
+export declare function createStorage(basedir: string): Storage;
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAM/C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOtD"}

package/dist/storage/index.js

@@ -0,0 +1,20 @@
+import { createEventsStorage } from './events-storage.js';
+import { createHooksStorage } from './hooks-storage.js';
+import { createRunsStorage } from './runs-storage.js';
+import { createStepsStorage } from './steps-storage.js';
+/**
+ * Creates a complete storage implementation using the filesystem.
+ * This is the main entry point that composes all storage implementations.
+ *
+ * @param basedir - The base directory for storing workflow data
+ * @returns A complete Storage implementation
+ */
+export function createStorage(basedir) {
+    return {
+        runs: createRunsStorage(basedir),
+        steps: createStepsStorage(basedir),
+        events: createEventsStorage(basedir),
+        hooks: createHooksStorage(basedir),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;QAChC,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC;QAClC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC;QACpC,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/storage/legacy.d.ts

@@ -0,0 +1,13 @@
+import type { EventResult, WorkflowRun } from '@workflow/world';
+/**
+ * Handle events for legacy runs (pre-event-sourcing, specVersion < 2).
+ * Legacy runs use different behavior:
+ * - run_cancelled: Skip event storage, directly update run
+ * - wait_completed: Store event only (no entity mutation)
+ * - hook_received: Store event only (hooks exist via old system, no entity mutation)
+ * - Other events: Throw error (not supported for legacy runs)
+ */
+export declare function handleLegacyEvent(basedir: string, runId: string, data: any, currentRun: WorkflowRun, params?: {
+    resolveData?: 'none' | 'all';
+}): Promise<EventResult>;
+//# sourceMappingURL=legacy.d.ts.map

package/dist/storage/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../src/storage/legacy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAS,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAQvE;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,GAAG,EACT,UAAU,EAAE,WAAW,EACvB,MAAM,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CAAE,GACxC,OAAO,CAAC,WAAW,CAAC,CA6DtB"}

package/dist/storage/legacy.js

@@ -0,0 +1,73 @@
+import path from 'node:path';
+import { SPEC_VERSION_CURRENT } from '@workflow/world';
+import { DEFAULT_RESOLVE_DATA_OPTION } from '../config.js';
+import { writeJSON } from '../fs.js';
+import { filterEventData, filterRunData } from './filters.js';
+import { monotonicUlid } from './helpers.js';
+import { deleteAllHooksForRun } from './hooks-storage.js';
+/**
+ * Handle events for legacy runs (pre-event-sourcing, specVersion < 2).
+ * Legacy runs use different behavior:
+ * - run_cancelled: Skip event storage, directly update run
+ * - wait_completed: Store event only (no entity mutation)
+ * - hook_received: Store event only (hooks exist via old system, no entity mutation)
+ * - Other events: Throw error (not supported for legacy runs)
+ */
+export async function handleLegacyEvent(basedir, runId, data, currentRun, params) {
+    const resolveData = params?.resolveData ?? DEFAULT_RESOLVE_DATA_OPTION;
+    switch (data.eventType) {
+        case 'run_cancelled': {
+            // Legacy: Skip event storage, directly update run to cancelled
+            const now = new Date();
+            const run = {
+                runId: currentRun.runId,
+                deploymentId: currentRun.deploymentId,
+                workflowName: currentRun.workflowName,
+                specVersion: currentRun.specVersion,
+                executionContext: currentRun.executionContext,
+                input: currentRun.input,
+                createdAt: currentRun.createdAt,
+                expiredAt: currentRun.expiredAt,
+                startedAt: currentRun.startedAt,
+                status: 'cancelled',
+                output: undefined,
+                error: undefined,
+                completedAt: now,
+                updatedAt: now,
+            };
+            const runPath = path.join(basedir, 'runs', `${runId}.json`);
+            await writeJSON(runPath, run, { overwrite: true });
+            await deleteAllHooksForRun(basedir, runId);
+            // Return without event (legacy behavior skips event storage)
+            // Type assertion: EventResult expects WorkflowRun, filterRunData may return WorkflowRunWithoutData
+            return {
+                event: undefined,
+                run: filterRunData(run, resolveData),
+            };
+        }
+        case 'wait_completed':
+        case 'hook_received': {
+            // Legacy: Store event only (no entity mutation)
+            // - wait_completed: for replay purposes
+            // - hook_received: hooks exist via old system, just record the event
+            const eventId = `evnt_${monotonicUlid()}`;
+            const now = new Date();
+            const event = {
+                ...data,
+                runId,
+                eventId,
+                createdAt: now,
+                specVersion: SPEC_VERSION_CURRENT,
+            };
+            const compositeKey = `${runId}-${eventId}`;
+            const eventPath = path.join(basedir, 'events', `${compositeKey}.json`);
+            await writeJSON(eventPath, event);
+            return { event: filterEventData(event, resolveData) };
+        }
+        default:
+            throw new Error(`Event type '${data.eventType}' not supported for legacy runs ` +
+                `(specVersion: ${currentRun.specVersion || 'undefined'}). ` +
+                `Please upgrade 'workflow' package.`);
+    }
+}
+//# sourceMappingURL=legacy.js.map

package/dist/storage/legacy.js.map

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

package/dist/storage/runs-storage.d.ts

@@ -0,0 +1,7 @@
+import type { Storage } from '@workflow/world';
+/**
+ * Creates the runs storage implementation using the filesystem.
+ * Implements the Storage['runs'] interface with get and list operations.
+ */
+export declare function createRunsStorage(basedir: string): Storage['runs'];
+//# sourceMappingURL=runs-storage.d.ts.map

package/dist/storage/runs-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs-storage.d.ts","sourceRoot":"","sources":["../../src/storage/runs-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAA0B,MAAM,iBAAiB,CAAC;AAOvE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDlE"}

package/dist/storage/runs-storage.js

@@ -0,0 +1,59 @@
+import path from 'node:path';
+import { WorkflowRunNotFoundError } from '@workflow/errors';
+import { WorkflowRunSchema } from '@workflow/world';
+import { DEFAULT_RESOLVE_DATA_OPTION } from '../config.js';
+import { paginatedFileSystemQuery, readJSON } from '../fs.js';
+import { filterRunData } from './filters.js';
+import { getObjectCreatedAt } from './helpers.js';
+/**
+ * Creates the runs storage implementation using the filesystem.
+ * Implements the Storage['runs'] interface with get and list operations.
+ */
+export function createRunsStorage(basedir) {
+    return {
+        get: (async (id, params) => {
+            const runPath = path.join(basedir, 'runs', `${id}.json`);
+            const run = await readJSON(runPath, WorkflowRunSchema);
+            if (!run) {
+                throw new WorkflowRunNotFoundError(id);
+            }
+            const resolveData = params?.resolveData ?? DEFAULT_RESOLVE_DATA_OPTION;
+            return filterRunData(run, resolveData);
+        }),
+        list: (async (params) => {
+            const resolveData = params?.resolveData ?? DEFAULT_RESOLVE_DATA_OPTION;
+            const result = await paginatedFileSystemQuery({
+                directory: path.join(basedir, 'runs'),
+                schema: WorkflowRunSchema,
+                filter: (run) => {
+                    if (params?.workflowName &&
+                        run.workflowName !== params.workflowName) {
+                        return false;
+                    }
+                    if (params?.status && run.status !== params.status) {
+                        return false;
+                    }
+                    return true;
+                },
+                sortOrder: params?.pagination?.sortOrder ?? 'desc',
+                limit: params?.pagination?.limit,
+                cursor: params?.pagination?.cursor,
+                getCreatedAt: getObjectCreatedAt('wrun'),
+                getId: (run) => run.runId,
+            });
+            // If resolveData is "none", replace input/output with undefined
+            if (resolveData === 'none') {
+                return {
+                    ...result,
+                    data: result.data.map((run) => ({
+                        ...run,
+                        input: undefined,
+                        output: undefined,
+                    })),
+                };
+            }
+            return result;
+        }),
+    };
+}
+//# sourceMappingURL=runs-storage.js.map

package/dist/storage/runs-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs-storage.js","sourceRoot":"","sources":["../../src/storage/runs-storage.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO;QACL,GAAG,EAAE,CAAC,KAAK,EAAE,EAAU,EAAE,MAAY,EAAE,EAAE;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YACvD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,IAAI,wBAAwB,CAAC,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,EAAE,WAAW,IAAI,2BAA2B,CAAC;YACvE,OAAO,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACzC,CAAC,CAA2B;QAE5B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAY,EAAE,EAAE;YAC5B,MAAM,WAAW,GAAG,MAAM,EAAE,WAAW,IAAI,2BAA2B,CAAC;YACvE,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC;gBAC5C,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;gBACrC,MAAM,EAAE,iBAAiB;gBACzB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;oBACd,IACE,MAAM,EAAE,YAAY;wBACpB,GAAG,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY,EACxC,CAAC;wBACD,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,IAAI,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;wBACnD,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,IAAI,MAAM;gBAClD,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK;gBAChC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;gBAClC,YAAY,EAAE,kBAAkB,CAAC,MAAM,CAAC;gBACxC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK;aAC1B,CAAC,CAAC;YAEH,gEAAgE;YAChE,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;gBAC3B,OAAO;oBACL,GAAG,MAAM;oBACT,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBAC9B,GAAG,GAAG;wBACN,KAAK,EAAE,SAAS;wBAChB,MAAM,EAAE,SAAS;qBAClB,CAAC,CAA6B;iBAChC,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,CAA4B;KAC9B,CAAC;AACJ,CAAC"}

package/dist/storage/steps-storage.d.ts

@@ -0,0 +1,7 @@
+import type { Storage } from '@workflow/world';
+/**
+ * Creates the steps storage implementation using the filesystem.
+ * Implements the Storage['steps'] interface with get and list operations.
+ */
+export declare function createStepsStorage(basedir: string): Storage['steps'];
+//# sourceMappingURL=steps-storage.d.ts.map

package/dist/storage/steps-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps-storage.d.ts","sourceRoot":"","sources":["../../src/storage/steps-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAmB,MAAM,iBAAiB,CAAC;AAOhE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiDpE"}

package/dist/storage/steps-storage.js

@@ -0,0 +1,58 @@
+import path from 'node:path';
+import { StepSchema } from '@workflow/world';
+import { DEFAULT_RESOLVE_DATA_OPTION } from '../config.js';
+import { listJSONFiles, paginatedFileSystemQuery, readJSON } from '../fs.js';
+import { filterStepData } from './filters.js';
+import { getObjectCreatedAt } from './helpers.js';
+/**
+ * Creates the steps storage implementation using the filesystem.
+ * Implements the Storage['steps'] interface with get and list operations.
+ */
+export function createStepsStorage(basedir) {
+    return {
+        get: (async (runId, stepId, params) => {
+            if (!runId) {
+                const fileIds = await listJSONFiles(path.join(basedir, 'steps'));
+                const fileId = fileIds.find((fileId) => fileId.endsWith(`-${stepId}`));
+                if (!fileId) {
+                    throw new Error(`Step ${stepId} not found`);
+                }
+                runId = fileId.split('-')[0];
+            }
+            const compositeKey = `${runId}-${stepId}`;
+            const stepPath = path.join(basedir, 'steps', `${compositeKey}.json`);
+            const step = await readJSON(stepPath, StepSchema);
+            if (!step) {
+                throw new Error(`Step ${stepId} in run ${runId} not found`);
+            }
+            const resolveData = params?.resolveData ?? DEFAULT_RESOLVE_DATA_OPTION;
+            return filterStepData(step, resolveData);
+        }),
+        list: (async (params) => {
+            const resolveData = params.resolveData ?? DEFAULT_RESOLVE_DATA_OPTION;
+            const result = await paginatedFileSystemQuery({
+                directory: path.join(basedir, 'steps'),
+                schema: StepSchema,
+                filePrefix: `${params.runId}-`,
+                sortOrder: params.pagination?.sortOrder ?? 'desc',
+                limit: params.pagination?.limit,
+                cursor: params.pagination?.cursor,
+                getCreatedAt: getObjectCreatedAt('step'),
+                getId: (step) => step.stepId,
+            });
+            // If resolveData is "none", replace input/output with undefined
+            if (resolveData === 'none') {
+                return {
+                    ...result,
+                    data: result.data.map((step) => ({
+                        ...step,
+                        input: undefined,
+                        output: undefined,
+                    })),
+                };
+            }
+            return result;
+        }),
+    };
+}
+//# sourceMappingURL=steps-storage.js.map

package/dist/storage/steps-storage.js.map

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

package/dist/storage.d.ts

@@ -1,3 +1,10 @@
-import { type Storage } from '@workflow/world';
-export declare function createStorage(basedir: string): Storage;
+/**
+ * Filesystem-based storage implementation for workflow data.
+ *
+ * This module provides a complete Storage implementation that persists
+ * workflow runs, steps, events, and hooks to the local filesystem.
+ *
+ * @module
+ */
+export { createStorage } from './storage/index.js';
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,OAAO,EAGb,MAAM,iBAAiB,CAAC;AAoFzB,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA8ZtD"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}