@workflow/utils 4.0.1-beta.7 → 4.0.1-beta.8

package/dist/check-data-dir.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Known paths where workflow data might be stored, relative to the project root.
+ */
+export declare const possibleWorkflowDataPaths: readonly [".next/workflow-data", ".workflow-data", "workflow-data"];
+export interface WorkflowDataDirInfo {
+    /** Absolute path to the project root (parent of the workflow data folder) */
+    projectDir: string;
+    /** Absolute path to the workflow data directory */
+    dataDir: string;
+    /** Short name for display: up to last two folder names of projectDir */
+    shortName: string;
+}
+/**
+ * Finds the workflow data directory starting from the given path.
+ *
+ * This function handles several cases:
+ * 1. The path itself is a workflow data directory
+ * 2. The path contains one of the known workflow data directories
+ * 3. The path is somewhere inside a project with workflow data
+ *
+ * @param cwd - The directory to start searching from (can be relative, absolute, or use ~)
+ * @returns Information about the found workflow data directory, or null if not found
+ */
+export declare function findWorkflowDataDir(cwd: string): Promise<WorkflowDataDirInfo | null>;
+//# sourceMappingURL=check-data-dir.d.ts.map

package/dist/check-data-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-data-dir.d.ts","sourceRoot":"","sources":["../src/check-data-dir.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,yBAAyB,qEAI5B,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AA+ED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAkDrC"}

package/dist/check-data-dir.js

@@ -0,0 +1,139 @@
+import { access } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, isAbsolute, join, resolve, sep } from 'node:path';
+/**
+ * Known paths where workflow data might be stored, relative to the project root.
+ */
+export const possibleWorkflowDataPaths = [
+    '.next/workflow-data',
+    '.workflow-data',
+    'workflow-data',
+];
+/**
+ * Expands a path that starts with ~ to use the user's home directory.
+ */
+function expandTilde(path) {
+    if (path.startsWith('~')) {
+        return join(homedir(), path.slice(1));
+    }
+    return path;
+}
+/**
+ * Normalizes a path to an absolute path.
+ */
+function toAbsolutePath(path, basePath) {
+    const expanded = expandTilde(path);
+    if (isAbsolute(expanded)) {
+        return resolve(expanded);
+    }
+    return resolve(basePath || process.cwd(), expanded);
+}
+/**
+ * Extracts up to the last two folder names from a path for a short display name.
+ *
+ * Examples:
+ * - `/Users/peter/code/myproject` → `code/myproject`
+ * - `/myproject` → `myproject`
+ * - `/` → ``
+ */
+function getShortName(projectDir) {
+    const parts = projectDir.split(sep).filter(Boolean);
+    if (parts.length === 0) {
+        return '';
+    }
+    if (parts.length === 1) {
+        return parts[0];
+    }
+    return parts.slice(-2).join('/');
+}
+/**
+ * Checks if a directory exists.
+ */
+async function directoryExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Checks if the given path is itself a workflow data directory
+ * (ends with one of the possibleWorkflowDataPaths).
+ *
+ * Returns the matching suffix and the projectDir if found.
+ */
+function checkIfPathIsWorkflowDataDir(absolutePath) {
+    for (const suffix of possibleWorkflowDataPaths) {
+        // Handle both forward slashes and the platform's separator
+        const normalizedSuffix = suffix.split('/').join(sep);
+        if (absolutePath.endsWith(normalizedSuffix)) {
+            // Calculate how many directories up we need to go
+            const suffixParts = suffix.split('/').length;
+            let projectDir = absolutePath;
+            for (let i = 0; i < suffixParts; i++) {
+                projectDir = dirname(projectDir);
+            }
+            return { suffix, projectDir };
+        }
+    }
+    return null;
+}
+/**
+ * Finds the workflow data directory starting from the given path.
+ *
+ * This function handles several cases:
+ * 1. The path itself is a workflow data directory
+ * 2. The path contains one of the known workflow data directories
+ * 3. The path is somewhere inside a project with workflow data
+ *
+ * @param cwd - The directory to start searching from (can be relative, absolute, or use ~)
+ * @returns Information about the found workflow data directory, or null if not found
+ */
+export async function findWorkflowDataDir(cwd) {
+    const absoluteCwd = toAbsolutePath(cwd);
+    // Case 1: Check if the path itself is already a workflow data directory
+    const isDataDir = checkIfPathIsWorkflowDataDir(absoluteCwd);
+    if (isDataDir && (await directoryExists(absoluteCwd))) {
+        return {
+            projectDir: isDataDir.projectDir,
+            dataDir: absoluteCwd,
+            shortName: getShortName(isDataDir.projectDir),
+        };
+    }
+    // Case 2: Check if cwd contains one of the workflow data directories
+    for (const path of possibleWorkflowDataPaths) {
+        const fullPath = join(absoluteCwd, path);
+        if (await directoryExists(fullPath)) {
+            return {
+                projectDir: absoluteCwd,
+                dataDir: resolve(fullPath),
+                shortName: getShortName(absoluteCwd),
+            };
+        }
+    }
+    // Case 3: Walk up the directory tree to find the project root
+    let currentDir = absoluteCwd;
+    const root = resolve('/');
+    while (currentDir !== root) {
+        // Check if any workflow data path exists here
+        for (const path of possibleWorkflowDataPaths) {
+            const fullPath = join(currentDir, path);
+            if (await directoryExists(fullPath)) {
+                return {
+                    projectDir: currentDir,
+                    dataDir: resolve(fullPath),
+                    shortName: getShortName(currentDir),
+                };
+            }
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            break; // Reached the filesystem root
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+//# sourceMappingURL=check-data-dir.js.map

package/dist/check-data-dir.js.map

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

package/dist/index.d.ts

@@ -1,39 +1,3 @@
-import type { StringValue } from 'ms';
-export interface PromiseWithResolvers<T> {
-    promise: Promise<T>;
-    resolve: (value: T) => void;
-    reject: (reason?: any) => void;
-}
-/**
- * Polyfill for `Promise.withResolvers()`.
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
- */
-export declare function withResolvers<T>(): PromiseWithResolvers<T>;
-/**
- * Creates a lazily-evaluated, memoized version of the provided function.
- *
- * The returned object exposes a `value` getter that calls `fn` only once,
- * caches its result, and returns the cached value on subsequent accesses.
- *
- * @typeParam T - The return type of the provided function.
- * @param fn - The function to be called once and whose result will be cached.
- * @returns An object with a `value` property that returns the memoized result of `fn`.
- */
-export declare function once<T>(fn: () => T): {
-    readonly value: T;
-};
-/**
- * Parses a duration parameter (string, number, or Date) and returns a Date object
- * representing when the duration should elapse.
- *
- * - For strings: Parses duration strings like "1s", "5m", "1h", etc. using the `ms` library
- * - For numbers: Treats as milliseconds from now
- * - For Date objects: Returns the date directly (handles both Date instances and date-like objects from deserialization)
- *
- * @param param - The duration parameter (StringValue, Date, or number of milliseconds)
- * @returns A Date object representing when the duration should elapse
- * @throws {Error} If the parameter is invalid or cannot be parsed
- */
-export declare function parseDurationToDate(param: StringValue | Date | number): Date;
+export { once, type PromiseWithResolvers, withResolvers } from './promise.js';
+export { parseDurationToDate } from './time.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAGtC,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,KAAK,oBAAoB,CAAC,CAAC,CAAC,CAQ1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC;;EASlC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA6B5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,73 +1,3 @@
-import ms from 'ms';
-/**
- * Polyfill for `Promise.withResolvers()`.
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
- */
-export function withResolvers() {
-    let resolve;
-    let reject;
-    const promise = new Promise((_resolve, _reject) => {
-        resolve = _resolve;
-        reject = _reject;
-    });
-    return { promise, resolve, reject };
-}
-/**
- * Creates a lazily-evaluated, memoized version of the provided function.
- *
- * The returned object exposes a `value` getter that calls `fn` only once,
- * caches its result, and returns the cached value on subsequent accesses.
- *
- * @typeParam T - The return type of the provided function.
- * @param fn - The function to be called once and whose result will be cached.
- * @returns An object with a `value` property that returns the memoized result of `fn`.
- */
-export function once(fn) {
-    const result = {
-        get value() {
-            const value = fn();
-            Object.defineProperty(result, 'value', { value });
-            return value;
-        },
-    };
-    return result;
-}
-/**
- * Parses a duration parameter (string, number, or Date) and returns a Date object
- * representing when the duration should elapse.
- *
- * - For strings: Parses duration strings like "1s", "5m", "1h", etc. using the `ms` library
- * - For numbers: Treats as milliseconds from now
- * - For Date objects: Returns the date directly (handles both Date instances and date-like objects from deserialization)
- *
- * @param param - The duration parameter (StringValue, Date, or number of milliseconds)
- * @returns A Date object representing when the duration should elapse
- * @throws {Error} If the parameter is invalid or cannot be parsed
- */
-export function parseDurationToDate(param) {
-    if (typeof param === 'string') {
-        const durationMs = ms(param);
-        if (typeof durationMs !== 'number' || durationMs < 0) {
-            throw new Error(`Invalid duration: "${param}". Expected a valid duration string like "1s", "1m", "1h", etc.`);
-        }
-        return new Date(Date.now() + durationMs);
-    }
-    else if (typeof param === 'number') {
-        if (param < 0 || !Number.isFinite(param)) {
-            throw new Error(`Invalid duration: ${param}. Expected a non-negative finite number of milliseconds.`);
-        }
-        return new Date(Date.now() + param);
-    }
-    else if (param instanceof Date ||
-        (param &&
-            typeof param === 'object' &&
-            typeof param.getTime === 'function')) {
-        // Handle both Date instances and date-like objects (from deserialization)
-        return param instanceof Date ? param : new Date(param.getTime());
-    }
-    else {
-        throw new Error(`Invalid duration parameter. Expected a duration string, number (milliseconds), or Date object.`);
-    }
-}
+export { once, withResolvers } from './promise.js';
+export { parseDurationToDate } from './time.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,CAAC;AAQpB;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAA4B,CAAC;IACjC,IAAI,MAA+B,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QACnD,OAAO,GAAG,QAAQ,CAAC;QACnB,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAI,EAAW;IACjC,MAAM,MAAM,GAAG;QACb,IAAI,KAAK;YACP,MAAM,KAAK,GAAG,EAAE,EAAE,CAAC;YACnB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkC;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,iEAAiE,CAC7F,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,0DAA0D,CACrF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IACtC,CAAC;SAAM,IACL,KAAK,YAAY,IAAI;QACrB,CAAC,KAAK;YACJ,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAQ,KAAa,CAAC,OAAO,KAAK,UAAU,CAAC,EAC/C,CAAC;QACD,0EAA0E;QAC1E,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAE,KAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA6B,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/promise.d.ts

@@ -0,0 +1,25 @@
+export interface PromiseWithResolvers<T> {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason?: any) => void;
+}
+/**
+ * Polyfill for `Promise.withResolvers()`.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
+ */
+export declare function withResolvers<T>(): PromiseWithResolvers<T>;
+/**
+ * Creates a lazily-evaluated, memoized version of the provided function.
+ *
+ * The returned object exposes a `value` getter that calls `fn` only once,
+ * caches its result, and returns the cached value on subsequent accesses.
+ *
+ * @typeParam T - The return type of the provided function.
+ * @param fn - The function to be called once and whose result will be cached.
+ * @returns An object with a `value` property that returns the memoized result of `fn`.
+ */
+export declare function once<T>(fn: () => T): {
+    readonly value: T;
+};
+//# sourceMappingURL=promise.d.ts.map

package/dist/promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../src/promise.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,KAAK,oBAAoB,CAAC,CAAC,CAAC,CAQ1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC;;EASlC"}

package/dist/promise.js

@@ -0,0 +1,35 @@
+/**
+ * Polyfill for `Promise.withResolvers()`.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
+ */
+export function withResolvers() {
+    let resolve;
+    let reject;
+    const promise = new Promise((_resolve, _reject) => {
+        resolve = _resolve;
+        reject = _reject;
+    });
+    return { promise, resolve, reject };
+}
+/**
+ * Creates a lazily-evaluated, memoized version of the provided function.
+ *
+ * The returned object exposes a `value` getter that calls `fn` only once,
+ * caches its result, and returns the cached value on subsequent accesses.
+ *
+ * @typeParam T - The return type of the provided function.
+ * @param fn - The function to be called once and whose result will be cached.
+ * @returns An object with a `value` property that returns the memoized result of `fn`.
+ */
+export function once(fn) {
+    const result = {
+        get value() {
+            const value = fn();
+            Object.defineProperty(result, 'value', { value });
+            return value;
+        },
+    };
+    return result;
+}
+//# sourceMappingURL=promise.js.map

package/dist/promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.js","sourceRoot":"","sources":["../src/promise.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,OAA4B,CAAC;IACjC,IAAI,MAA+B,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QACnD,OAAO,GAAG,QAAQ,CAAC;QACnB,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAI,EAAW;IACjC,MAAM,MAAM,GAAG;QACb,IAAI,KAAK;YACP,MAAM,KAAK,GAAG,EAAE,EAAE,CAAC;YACnB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/time.d.ts

@@ -0,0 +1,15 @@
+import type { StringValue } from 'ms';
+/**
+ * Parses a duration parameter (string, number, or Date) and returns a Date object
+ * representing when the duration should elapse.
+ *
+ * - For strings: Parses duration strings like "1s", "5m", "1h", etc. using the `ms` library
+ * - For numbers: Treats as milliseconds from now
+ * - For Date objects: Returns the date directly (handles both Date instances and date-like objects from deserialization)
+ *
+ * @param param - The duration parameter (StringValue, Date, or number of milliseconds)
+ * @returns A Date object representing when the duration should elapse
+ * @throws {Error} If the parameter is invalid or cannot be parsed
+ */
+export declare function parseDurationToDate(param: StringValue | Date | number): Date;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAGtC;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA6B5E"}

package/dist/time.js

@@ -0,0 +1,39 @@
+import ms from 'ms';
+/**
+ * Parses a duration parameter (string, number, or Date) and returns a Date object
+ * representing when the duration should elapse.
+ *
+ * - For strings: Parses duration strings like "1s", "5m", "1h", etc. using the `ms` library
+ * - For numbers: Treats as milliseconds from now
+ * - For Date objects: Returns the date directly (handles both Date instances and date-like objects from deserialization)
+ *
+ * @param param - The duration parameter (StringValue, Date, or number of milliseconds)
+ * @returns A Date object representing when the duration should elapse
+ * @throws {Error} If the parameter is invalid or cannot be parsed
+ */
+export function parseDurationToDate(param) {
+    if (typeof param === 'string') {
+        const durationMs = ms(param);
+        if (typeof durationMs !== 'number' || durationMs < 0) {
+            throw new Error(`Invalid duration: "${param}". Expected a valid duration string like "1s", "1m", "1h", etc.`);
+        }
+        return new Date(Date.now() + durationMs);
+    }
+    else if (typeof param === 'number') {
+        if (param < 0 || !Number.isFinite(param)) {
+            throw new Error(`Invalid duration: ${param}. Expected a non-negative finite number of milliseconds.`);
+        }
+        return new Date(Date.now() + param);
+    }
+    else if (param instanceof Date ||
+        (param &&
+            typeof param === 'object' &&
+            typeof param.getTime === 'function')) {
+        // Handle both Date instances and date-like objects (from deserialization)
+        return param instanceof Date ? param : new Date(param.getTime());
+    }
+    else {
+        throw new Error(`Invalid duration parameter. Expected a duration string, number (milliseconds), or Date object.`);
+    }
+}
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAkC;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,iEAAiE,CAC7F,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,0DAA0D,CACrF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IACtC,CAAC;SAAM,IACL,KAAK,YAAY,IAAI;QACrB,CAAC,KAAK;YACJ,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAQ,KAAa,CAAC,OAAO,KAAK,UAAU,CAAC,EAC/C,CAAC;QACD,0EAA0E;QAC1E,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAE,KAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@workflow/utils",
   "description": "Utility functions for Workflow DevKit",
-  "version": "4.0.1-beta.7",
+  "version": "4.0.1-beta.8",
   "type": "module",
   "main": "dist/index.js",
   "files": [
@@ -24,6 +24,10 @@
     "./get-port": {
       "types": "./dist/get-port.d.ts",
       "default": "./dist/get-port.js"
+    },
+    "./check-data-dir": {
+      "types": "./dist/check-data-dir.d.ts",
+      "default": "./dist/check-data-dir.js"
     }
   },
   "devDependencies": {