experimental-ash 0.26.0 → 0.28.0

package/dist/src/internal/workflow-bundle/workflow-builders.js

@@ -1,292 +1 @@
-import { existsSync, readFileSync } from "node:fs";
-import { readFile } from "node:fs/promises";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { STABLE_WORKFLOW_NAMES } from "#execution/workflow-runtime.js";
-import { transformWorkflowDirectives } from "./workflow-transformer.js";
-export const WORKFLOW_QUEUE_TRIGGER = {
-    type: "queue/v2beta",
-    topic: "__wkf_workflow_*",
-    consumer: "default",
-    retryAfterSeconds: 5,
-    initialDelaySeconds: 0,
-};
-const packageJsonCache = new Map();
-const projectDepsCache = new Map();
-export async function applyWorkflowTransform(filename, source, mode, absolutePath, projectRoot, stableWorkflowNames = STABLE_WORKFLOW_NAMES) {
-    const resolvedProjectRoot = projectRoot ?? process.cwd();
-    const absoluteFilename = absolutePath === undefined
-        ? isAbsolute(filename)
-            ? filename
-            : join(resolvedProjectRoot, filename)
-        : absolutePath;
-    const { moduleSpecifier, stableModuleSpecifier } = resolveModuleSpecifier(absoluteFilename, resolvedProjectRoot);
-    return transformWorkflowDirectives({
-        filename,
-        mode,
-        moduleSpecifier,
-        source,
-        stableModuleSpecifier,
-        stableWorkflowNames,
-    });
-}
-export function detectWorkflowPatterns(source) {
-    return {
-        hasSerde: source.includes("workflow.serde") ||
-            source.includes("@serde") ||
-            source.includes("workflowSerde") ||
-            source.includes("__workflow_serde"),
-        hasUseStep: /["']use step["']/.test(source),
-        hasUseWorkflow: /["']use workflow["']/.test(source),
-    };
-}
-export function getImportPath(filePath, projectRoot) {
-    const inNodeModules = isInNodeModules(filePath);
-    const inWorkspace = !inNodeModules && isWorkspacePackage(filePath, projectRoot);
-    if (inNodeModules || inWorkspace) {
-        const pkg = findPackageJson(filePath);
-        if (pkg !== null) {
-            const isDirectProjectDependency = getProjectDependencies(projectRoot).has(pkg.name);
-            const canUsePackageSpecifier = inWorkspace || isDirectProjectDependency;
-            if (!canUsePackageSpecifier) {
-                return { importPath: toRelativeImportPath(filePath, projectRoot), isPackage: false };
-            }
-            const subpath = resolveExportSubpath(filePath, pkg);
-            if (subpath) {
-                return { importPath: `${pkg.name}${subpath}`, isPackage: true };
-            }
-            if (!isRootEntrypointFile(filePath, pkg)) {
-                return { importPath: toRelativeImportPath(filePath, projectRoot), isPackage: false };
-            }
-            return { importPath: pkg.name, isPackage: true };
-        }
-    }
-    return { importPath: toRelativeImportPath(filePath, projectRoot), isPackage: false };
-}
-function resolveModuleSpecifier(filePath, projectRoot) {
-    const inNodeModules = isInNodeModules(filePath);
-    const inWorkspace = !inNodeModules && isWorkspacePackage(filePath, projectRoot);
-    if (!inNodeModules && !inWorkspace) {
-        return { moduleSpecifier: undefined, stableModuleSpecifier: undefined };
-    }
-    const pkg = findPackageJson(filePath);
-    if (pkg === null) {
-        return { moduleSpecifier: undefined, stableModuleSpecifier: undefined };
-    }
-    const subpath = resolveExportSubpath(filePath, pkg);
-    // The default specifier is version-stamped for normal workflow/step
-    // ids; the stable variant drops the `@<pkg.version>` suffix so
-    // {@link STABLE_WORKFLOW_NAMES} functions emit cross-deployment
-    // routable ids.
-    const base = subpath ? `${pkg.name}${subpath}` : pkg.name;
-    return {
-        moduleSpecifier: `${base}@${pkg.version}`,
-        stableModuleSpecifier: base,
-    };
-}
-function findPackageJson(filePath) {
-    let dir = dirname(filePath);
-    const visitedDirs = [];
-    while (dir !== dirname(dir)) {
-        const cached = packageJsonCache.get(dir);
-        if (cached !== undefined) {
-            for (const visitedDir of visitedDirs) {
-                packageJsonCache.set(visitedDir, cached);
-            }
-            return cached;
-        }
-        visitedDirs.push(dir);
-        const packageJsonPath = join(dir, "package.json");
-        if (existsSync(packageJsonPath)) {
-            try {
-                const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8"));
-                if (typeof parsed.name === "string" && typeof parsed.version === "string") {
-                    const result = {
-                        dir,
-                        exports: parsed.exports,
-                        main: parsed.main,
-                        module: parsed.module,
-                        name: parsed.name,
-                        version: parsed.version,
-                    };
-                    packageJsonCache.set(dir, result);
-                    for (const visitedDir of visitedDirs) {
-                        packageJsonCache.set(visitedDir, result);
-                    }
-                    return result;
-                }
-            }
-            catch {
-                // Continue searching ancestors.
-            }
-        }
-        dir = dirname(dir);
-    }
-    for (const visitedDir of visitedDirs) {
-        packageJsonCache.set(visitedDir, null);
-    }
-    return null;
-}
-function resolveExportSubpath(filePath, pkg) {
-    if (pkg.exports === null || typeof pkg.exports !== "object" || Array.isArray(pkg.exports)) {
-        return "";
-    }
-    const normalizedFilePath = filePath.replace(/\\/g, "/");
-    const normalizedPkgDir = pkg.dir.replace(/\\/g, "/");
-    const relativePath = normalizedFilePath.startsWith(`${normalizedPkgDir}/`)
-        ? `./${normalizedFilePath.substring(normalizedPkgDir.length + 1)}`
-        : null;
-    if (relativePath === null) {
-        return "";
-    }
-    for (const [subpath, target] of Object.entries(pkg.exports)) {
-        const resolvedTarget = resolveExportTarget(target);
-        if (resolvedTarget !== null && normalizeExportPath(resolvedTarget) === relativePath) {
-            return subpath === "." ? "" : subpath.substring(1);
-        }
-    }
-    return "";
-}
-function resolveExportTarget(target) {
-    if (typeof target === "string") {
-        return target;
-    }
-    if (Array.isArray(target)) {
-        for (const item of target) {
-            const resolved = resolveExportTarget(item);
-            if (resolved !== null) {
-                return resolved;
-            }
-        }
-        return null;
-    }
-    if (target !== null && typeof target === "object") {
-        for (const condition of ["workflow", "default", "require", "import", "node"]) {
-            const value = target[condition];
-            const resolved = resolveExportTarget(value);
-            if (resolved !== null) {
-                return resolved;
-            }
-        }
-    }
-    return null;
-}
-function normalizeExportPath(path) {
-    return path.startsWith("./") ? path : `./${path}`;
-}
-function isInNodeModules(filePath) {
-    return filePath.split(sep).join("/").includes("/node_modules/");
-}
-function getProjectDependencies(projectRoot) {
-    const cached = projectDepsCache.get(projectRoot);
-    if (cached !== undefined) {
-        return cached;
-    }
-    const deps = new Set();
-    const pkgPath = join(projectRoot, "package.json");
-    if (existsSync(pkgPath)) {
-        try {
-            const parsed = JSON.parse(readFileSync(pkgPath, "utf8"));
-            for (const depType of [
-                "dependencies",
-                "devDependencies",
-                "peerDependencies",
-                "optionalDependencies",
-            ]) {
-                const depObj = parsed[depType];
-                if (depObj !== null && typeof depObj === "object" && !Array.isArray(depObj)) {
-                    for (const name of Object.keys(depObj)) {
-                        deps.add(name);
-                    }
-                }
-            }
-        }
-        catch {
-            // Ignore invalid package metadata.
-        }
-    }
-    projectDepsCache.set(projectRoot, deps);
-    return deps;
-}
-function isWorkspacePackage(filePath, projectRoot) {
-    if (isInNodeModules(filePath)) {
-        return false;
-    }
-    const pkg = findPackageJson(filePath);
-    if (pkg === null) {
-        return false;
-    }
-    if (resolve(pkg.dir) === resolve(projectRoot)) {
-        return false;
-    }
-    return getProjectDependencies(projectRoot).has(pkg.name);
-}
-function toRelativeImportPath(filePath, projectRoot) {
-    const normalizedProjectRoot = projectRoot.replace(/\\/g, "/");
-    const normalizedFilePath = filePath.replace(/\\/g, "/");
-    let relativePath = normalizedFilePath.startsWith(`${normalizedProjectRoot}/`)
-        ? normalizedFilePath.substring(normalizedProjectRoot.length + 1)
-        : relative(projectRoot, filePath).replace(/\\/g, "/");
-    if (!relativePath.startsWith(".")) {
-        relativePath = `./${relativePath}`;
-    }
-    return relativePath;
-}
-function hasRootExport(exportsField) {
-    if (typeof exportsField === "string" || Array.isArray(exportsField)) {
-        return true;
-    }
-    if (exportsField === null || typeof exportsField !== "object") {
-        return false;
-    }
-    const keys = Object.keys(exportsField);
-    if (keys.length > 0 && keys.every((key) => !key.startsWith("."))) {
-        return true;
-    }
-    return "." in exportsField;
-}
-function normalizePackageTargetPath(path) {
-    const normalized = path.replace(/\\/g, "/");
-    if (normalized.startsWith("./")) {
-        return normalized.substring(2);
-    }
-    if (normalized.startsWith("/")) {
-        return normalized.substring(1);
-    }
-    return normalized;
-}
-function isRootEntrypointFile(filePath, pkg) {
-    const normalizedFilePath = filePath.replace(/\\/g, "/");
-    const normalizedPkgDir = pkg.dir.replace(/\\/g, "/");
-    if (!normalizedFilePath.startsWith(`${normalizedPkgDir}/`)) {
-        return false;
-    }
-    const relativeFilePath = normalizedFilePath.substring(normalizedPkgDir.length + 1);
-    if (pkg.exports !== undefined) {
-        let rootTarget;
-        if (pkg.exports !== null && typeof pkg.exports === "object" && "." in pkg.exports) {
-            rootTarget = pkg.exports["."];
-        }
-        else if (hasRootExport(pkg.exports)) {
-            rootTarget = pkg.exports;
-        }
-        else {
-            return false;
-        }
-        const resolvedTarget = resolveExportTarget(rootTarget);
-        return (resolvedTarget !== null && normalizePackageTargetPath(resolvedTarget) === relativeFilePath);
-    }
-    const rootCandidates = [
-        pkg.module,
-        pkg.main,
-        "index.js",
-        "index.mjs",
-        "index.cjs",
-        "index.ts",
-        "index.mts",
-        "index.cts",
-    ].flatMap((candidate) => typeof candidate === "string" ? [normalizePackageTargetPath(candidate)] : []);
-    return rootCandidates.includes(relativeFilePath);
-}
-export async function readSourceFile(path) {
-    return await readFile(path, "utf8");
-}
+import{transformWorkflowDirectives}from"./workflow-transformer.js";import{dirname,isAbsolute,join,relative,resolve,sep}from"node:path";import{readFile}from"node:fs/promises";import{existsSync,readFileSync}from"node:fs";import{STABLE_WORKFLOW_NAMES}from"#execution/workflow-runtime.js";var WORKFLOW_QUEUE_TRIGGER={type:`queue/v2beta`,topic:`__wkf_workflow_*`,consumer:`default`,retryAfterSeconds:5,initialDelaySeconds:0},packageJsonCache=new Map,projectDepsCache=new Map;async function applyWorkflowTransform(t,i,a,o,s,c=STABLE_WORKFLOW_NAMES){let l=s??process.cwd(),{moduleSpecifier:u,stableModuleSpecifier:d}=resolveModuleSpecifier(o===void 0?isAbsolute(t)?t:join(l,t):o,l);return transformWorkflowDirectives({filename:t,mode:a,moduleSpecifier:u,source:i,stableModuleSpecifier:d,stableWorkflowNames:c})}function detectWorkflowPatterns(e){return{hasSerde:e.includes(`workflow.serde`)||e.includes(`@serde`)||e.includes(`workflowSerde`)||e.includes(`__workflow_serde`),hasUseStep:/["']use step["']/.test(e),hasUseWorkflow:/["']use workflow["']/.test(e)}}function getImportPath(e,t){let n=isInNodeModules(e),r=!n&&isWorkspacePackage(e,t);if(n||r){let n=findPackageJson(e);if(n!==null){let i=getProjectDependencies(t).has(n.name);if(!(r||i))return{importPath:toRelativeImportPath(e,t),isPackage:!1};let a=resolveExportSubpath(e,n);return a?{importPath:`${n.name}${a}`,isPackage:!0}:isRootEntrypointFile(e,n)?{importPath:n.name,isPackage:!0}:{importPath:toRelativeImportPath(e,t),isPackage:!1}}}return{importPath:toRelativeImportPath(e,t),isPackage:!1}}function resolveModuleSpecifier(e,t){let n=isInNodeModules(e),r=!n&&isWorkspacePackage(e,t);if(!n&&!r)return{moduleSpecifier:void 0,stableModuleSpecifier:void 0};let i=findPackageJson(e);if(i===null)return{moduleSpecifier:void 0,stableModuleSpecifier:void 0};let a=resolveExportSubpath(e,i),o=a?`${i.name}${a}`:i.name;return{moduleSpecifier:`${o}@${i.version}`,stableModuleSpecifier:o}}function findPackageJson(e){let n=dirname(e),i=[];for(;n!==dirname(n);){let e=packageJsonCache.get(n);if(e!==void 0){for(let t of i)packageJsonCache.set(t,e);return e}i.push(n);let a=join(n,`package.json`);if(existsSync(a))try{let e=JSON.parse(readFileSync(a,`utf8`));if(typeof e.name==`string`&&typeof e.version==`string`){let t={dir:n,exports:e.exports,main:e.main,module:e.module,name:e.name,version:e.version};packageJsonCache.set(n,t);for(let e of i)packageJsonCache.set(e,t);return t}}catch{}n=dirname(n)}for(let e of i)packageJsonCache.set(e,null);return null}function resolveExportSubpath(e,t){if(t.exports===null||typeof t.exports!=`object`||Array.isArray(t.exports))return``;let n=e.replace(/\\/g,`/`),r=t.dir.replace(/\\/g,`/`),i=n.startsWith(`${r}/`)?`./${n.substring(r.length+1)}`:null;if(i===null)return``;for(let[e,n]of Object.entries(t.exports)){let t=resolveExportTarget(n);if(t!==null&&normalizeExportPath(t)===i)return e===`.`?``:e.substring(1)}return``}function resolveExportTarget(e){if(typeof e==`string`)return e;if(Array.isArray(e)){for(let t of e){let e=resolveExportTarget(t);if(e!==null)return e}return null}if(typeof e==`object`&&e)for(let t of[`workflow`,`default`,`require`,`import`,`node`]){let n=e[t],r=resolveExportTarget(n);if(r!==null)return r}return null}function normalizeExportPath(e){return e.startsWith(`./`)?e:`./${e}`}function isInNodeModules(e){return e.split(sep).join(`/`).includes(`/node_modules/`)}function getProjectDependencies(e){let t=projectDepsCache.get(e);if(t!==void 0)return t;let n=new Set,i=join(e,`package.json`);if(existsSync(i))try{let e=JSON.parse(readFileSync(i,`utf8`));for(let t of[`dependencies`,`devDependencies`,`peerDependencies`,`optionalDependencies`]){let r=e[t];if(typeof r==`object`&&r&&!Array.isArray(r))for(let e of Object.keys(r))n.add(e)}}catch{}return projectDepsCache.set(e,n),n}function isWorkspacePackage(e,t){if(isInNodeModules(e))return!1;let n=findPackageJson(e);return n===null||resolve(n.dir)===resolve(t)?!1:getProjectDependencies(t).has(n.name)}function toRelativeImportPath(e,t){let n=t.replace(/\\/g,`/`),r=e.replace(/\\/g,`/`),a=r.startsWith(`${n}/`)?r.substring(n.length+1):relative(t,e).replace(/\\/g,`/`);return a.startsWith(`.`)||(a=`./${a}`),a}function hasRootExport(e){if(typeof e==`string`||Array.isArray(e))return!0;if(typeof e!=`object`||!e)return!1;let t=Object.keys(e);return t.length>0&&t.every(e=>!e.startsWith(`.`))?!0:`.`in e}function normalizePackageTargetPath(e){let t=e.replace(/\\/g,`/`);return t.startsWith(`./`)?t.substring(2):t.startsWith(`/`)?t.substring(1):t}function isRootEntrypointFile(e,t){let n=e.replace(/\\/g,`/`),r=t.dir.replace(/\\/g,`/`);if(!n.startsWith(`${r}/`))return!1;let i=n.substring(r.length+1);if(t.exports!==void 0){let e;if(t.exports!==null&&typeof t.exports==`object`&&`.`in t.exports)e=t.exports[`.`];else if(hasRootExport(t.exports))e=t.exports;else return!1;let n=resolveExportTarget(e);return n!==null&&normalizePackageTargetPath(n)===i}return[t.module,t.main,`index.js`,`index.mjs`,`index.cjs`,`index.ts`,`index.mts`,`index.cts`].flatMap(e=>typeof e==`string`?[normalizePackageTargetPath(e)]:[]).includes(i)}async function readSourceFile(e){return await readFile(e,`utf8`)}export{WORKFLOW_QUEUE_TRIGGER,applyWorkflowTransform,detectWorkflowPatterns,getImportPath,readSourceFile};

package/dist/src/internal/workflow-bundle/workflow-core-shim.js

@@ -1,84 +1 @@
-const WORKFLOW_CONTEXT_SYMBOL = Symbol.for("WORKFLOW_CONTEXT");
-const WORKFLOW_CREATE_HOOK = Symbol.for("WORKFLOW_CREATE_HOOK");
-const WORKFLOW_GET_STREAM_ID = Symbol.for("WORKFLOW_GET_STREAM_ID");
-const STREAM_NAME_SYMBOL = Symbol.for("WORKFLOW_STREAM_NAME");
-const workflowGlobal = globalThis;
-export class RetryableError extends Error {
-}
-export class FatalError extends Error {
-}
-/**
- * Creates a Workflow hook from inside a durable workflow body.
- */
-export function createHook(options) {
-    const createHookFn = workflowGlobal[WORKFLOW_CREATE_HOOK];
-    if (createHookFn === undefined) {
-        throw new Error("`createHook()` can only be called inside a workflow function");
-    }
-    return createHookFn(options);
-}
-/**
- * Returns metadata for the current durable workflow body.
- */
-export function getWorkflowMetadata() {
-    const ctx = workflowGlobal[WORKFLOW_CONTEXT_SYMBOL];
-    if (ctx === undefined) {
-        throw new Error("`getWorkflowMetadata()` can only be called inside a workflow or step function");
-    }
-    return ctx;
-}
-/**
- * Creates a Workflow writable stream handle from inside a durable workflow body.
- */
-export function getWritable(options = {}) {
-    const getStreamId = workflowGlobal[WORKFLOW_GET_STREAM_ID];
-    if (getStreamId === undefined) {
-        throw new Error("`getWritable()` can only be called inside a workflow function");
-    }
-    const name = getStreamId(options.namespace);
-    return Object.create(globalThis.WritableStream.prototype, {
-        [STREAM_NAME_SYMBOL]: {
-            value: name,
-            writable: false,
-        },
-    });
-}
-/**
- * Creates a Workflow webhook from inside a durable workflow body.
- */
-export function createWebhook(options) {
-    const hook = createHook(options);
-    const metadata = getWorkflowMetadata();
-    const baseUrl = typeof metadata.url === "string" ? metadata.url : "";
-    hook.url = `${baseUrl}/.well-known/workflow/v1/webhook/${encodeURIComponent(hook.token)}`;
-    return hook;
-}
-/**
- * Defines a Workflow hook factory for workflow-body code.
- */
-export function defineHook() {
-    return {
-        create: createHook,
-        resume() {
-            throw new Error("`defineHook().resume()` can only be called from external contexts.");
-        },
-    };
-}
-/**
- * Sleeps from inside workflow-body code.
- */
-export function sleep() {
-    throw new Error("`sleep()` is not available in Ash workflow body bundles");
-}
-/**
- * `resumeHook()` is an external/runtime API and must not run in workflow bodies.
- */
-export function resumeHook() {
-    throw new Error("`resumeHook()` can only be called from outside a workflow function");
-}
-/**
- * Step metadata is only available in step functions.
- */
-export function getStepMetadata() {
-    throw new Error("`getStepMetadata()` can only be called inside a step function");
-}
+var WORKFLOW_CONTEXT_SYMBOL=Symbol.for(`WORKFLOW_CONTEXT`),WORKFLOW_CREATE_HOOK=Symbol.for(`WORKFLOW_CREATE_HOOK`),WORKFLOW_GET_STREAM_ID=Symbol.for(`WORKFLOW_GET_STREAM_ID`),STREAM_NAME_SYMBOL=Symbol.for(`WORKFLOW_STREAM_NAME`),workflowGlobal=globalThis,RetryableError=class extends Error{},FatalError=class extends Error{};function createHook(e){let n=workflowGlobal[WORKFLOW_CREATE_HOOK];if(n===void 0)throw Error("`createHook()` can only be called inside a workflow function");return n(e)}function getWorkflowMetadata(){let t=workflowGlobal[WORKFLOW_CONTEXT_SYMBOL];if(t===void 0)throw Error("`getWorkflowMetadata()` can only be called inside a workflow or step function");return t}function getWritable(e={}){let t=workflowGlobal[WORKFLOW_GET_STREAM_ID];if(t===void 0)throw Error("`getWritable()` can only be called inside a workflow function");let r=t(e.namespace);return Object.create(globalThis.WritableStream.prototype,{[STREAM_NAME_SYMBOL]:{value:r,writable:!1}})}function createWebhook(e){let t=createHook(e),n=getWorkflowMetadata();return t.url=`${typeof n.url==`string`?n.url:``}/.well-known/workflow/v1/webhook/${encodeURIComponent(t.token)}`,t}function defineHook(){return{create:createHook,resume(){throw Error("`defineHook().resume()` can only be called from external contexts.")}}}function sleep(){throw Error("`sleep()` is not available in Ash workflow body bundles")}function resumeHook(){throw Error("`resumeHook()` can only be called from outside a workflow function")}function getStepMetadata(){throw Error("`getStepMetadata()` can only be called inside a step function")}export{FatalError,RetryableError,createHook,createWebhook,defineHook,getStepMetadata,getWorkflowMetadata,getWritable,resumeHook,sleep};