@workflow/builders 5.0.0-beta.3 → 5.0.0-beta.5

package/dist/base-builder.js

@@ -1,7 +1,9 @@
 import { randomUUID } from 'node:crypto';
 import { mkdir, readFile, realpath, rename, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
 import { basename, dirname, join, relative, resolve } from 'node:path';
 import { promisify } from 'node:util';
+import { WorkflowBuildError } from '@workflow/errors';
 import { pluralize } from '@workflow/utils';
 import chalk from 'chalk';
 import enhancedResolveOriginal from 'enhanced-resolve';
@@ -15,9 +17,47 @@ import { getImportPath } from './module-specifier.js';
 import { createNodeModuleErrorPlugin } from './node-module-esbuild-plugin.js';
 import { createPseudoPackagePlugin } from './pseudo-package-esbuild-plugin.js';
 import { createSwcPlugin } from './swc-esbuild-plugin.js';
+import { detectWorkflowPatterns } from './transform-utils.js';
 import { extractWorkflowGraphs } from './workflows-extractor.js';
 const enhancedResolve = promisify(enhancedResolveOriginal);
+const require = createRequire(import.meta.url);
+/**
+ * Legacy opt-in for source maps on the final workflow wrapper + webhook
+ * bundles (which default to off, unlike the step/interim workflow bundles
+ * that default to inline). Superseded by the `sourcemap` config option and
+ * the `WORKFLOW_SOURCEMAP` environment variable; kept for back-compat.
+ */
 const EMIT_SOURCEMAPS_FOR_DEBUGGING = process.env.WORKFLOW_EMIT_SOURCEMAPS_FOR_DEBUGGING === '1';
+const VALID_SOURCEMAP_STRINGS = new Set([
+    'inline',
+    'linked',
+    'external',
+    'both',
+]);
+/**
+ * Parse the value of the `WORKFLOW_SOURCEMAP` environment variable into a
+ * `SourcemapMode`. Returns `undefined` if the env var is unset, empty, or
+ * unrecognized (a warning is emitted for unrecognized values).
+ */
+function parseSourcemapEnv(value) {
+    if (value === undefined || value === '')
+        return undefined;
+    switch (value) {
+        case '0':
+        case 'false':
+            return false;
+        case '1':
+        case 'true':
+            return true;
+        default:
+            if (VALID_SOURCEMAP_STRINGS.has(value)) {
+                return value;
+            }
+            console.warn(`Ignoring unrecognized WORKFLOW_SOURCEMAP=${value}. ` +
+                `Expected one of: true, false, 0, 1, inline, linked, external, both.`);
+            return undefined;
+    }
+}
 /**
  * Normalize an array of file paths by appending the `realpath()` of each entry
  * (to handle symlinks, e.g. pnpm/workspace layouts) and deduplicating.
@@ -36,6 +76,11 @@ async function withRealpaths(entries) {
  */
 export class BaseBuilder {
     config;
+    /**
+     * Tracks which external packages have already been warned about
+     * to avoid duplicate warnings across multiple discoverEntries() calls.
+     */
+    warnedExternalPackages = new Set();
     constructor(config) {
         this.config = config;
     }
@@ -152,6 +197,105 @@ export class BaseBuilder {
      * (e.g., when files are added/removed during watch mode).
      */
     discoveredEntries = new WeakMap();
+    /**
+     * Pseudo-packages that should not be checked for workflow patterns.
+     */
+    static PSEUDO_PACKAGES = new Set([
+        'server-only',
+        'client-only',
+    ]);
+    /**
+     * Checks each package in externalPackages for workflow patterns and emits
+     * warnings if any contain "use step", "use workflow" directives, or
+     * serialization classes. These patterns will not be transformed by the
+     * workflow compiler when the package is externalized.
+     */
+    async warnAboutExternalWorkflowPackages() {
+        const externalPackages = this.config.externalPackages;
+        if (!externalPackages?.length)
+            return;
+        for (const pkg of externalPackages) {
+            if (BaseBuilder.PSEUDO_PACKAGES.has(pkg))
+                continue;
+            if (this.warnedExternalPackages.has(pkg))
+                continue;
+            if (pkg.startsWith('.') ||
+                pkg.startsWith('/') ||
+                pkg.startsWith('$') ||
+                pkg.includes('*') ||
+                pkg.includes(':')) {
+                continue;
+            }
+            try {
+                // Check package.json dependencies for @workflow/serde (fast path)
+                let hasWorkflowSerdeDep = false;
+                try {
+                    const pkgJsonPath = require.resolve(`${pkg}/package.json`, {
+                        paths: [this.config.workingDir],
+                    });
+                    const pkgJsonSource = await readFile(pkgJsonPath, 'utf-8');
+                    const pkgJson = JSON.parse(pkgJsonSource);
+                    const dependencies = typeof pkgJson.dependencies === 'object' &&
+                        pkgJson.dependencies !== null &&
+                        !Array.isArray(pkgJson.dependencies)
+                        ? pkgJson.dependencies
+                        : {};
+                    const peerDependencies = typeof pkgJson.peerDependencies === 'object' &&
+                        pkgJson.peerDependencies !== null &&
+                        !Array.isArray(pkgJson.peerDependencies)
+                        ? pkgJson.peerDependencies
+                        : {};
+                    hasWorkflowSerdeDep =
+                        Object.hasOwn(dependencies, '@workflow/serde') ||
+                            Object.hasOwn(peerDependencies, '@workflow/serde');
+                }
+                catch {
+                    // package.json not resolvable - continue to source check
+                }
+                // Check source patterns (thorough path).
+                // Note: require.resolve only inspects the package's main entry point.
+                // If workflow constructs live in sub-paths (e.g. `my-pkg/workflows`),
+                // they won't be detected here. The @workflow/serde dep check above
+                // partially covers serde cases. This is acceptable as a best-effort
+                // heuristic — the primary fix is auto-removal in withWorkflow().
+                let hasUseStep = false;
+                let hasUseWorkflow = false;
+                let hasSerde = hasWorkflowSerdeDep;
+                try {
+                    const entryPath = require.resolve(pkg, {
+                        paths: [this.config.workingDir],
+                    });
+                    const source = await readFile(entryPath, 'utf-8');
+                    const patterns = detectWorkflowPatterns(source);
+                    hasUseStep = patterns.hasUseStep;
+                    hasUseWorkflow = patterns.hasUseWorkflow;
+                    if (!hasSerde) {
+                        hasSerde = patterns.hasSerde;
+                    }
+                }
+                catch {
+                    // Entry file not resolvable or not readable - use what we have
+                }
+                if (!hasUseStep && !hasUseWorkflow && !hasSerde)
+                    continue;
+                // Build a specific description of what was found
+                const issues = [];
+                if (hasUseWorkflow)
+                    issues.push('"use workflow" functions');
+                if (hasUseStep)
+                    issues.push('"use step" functions');
+                if (hasSerde)
+                    issues.push('serialization classes');
+                this.warnedExternalPackages.add(pkg);
+                console.warn(`\n${chalk.yellow('⚠')} Warning: ${chalk.bold(`"${pkg}"`)} is listed in ${chalk.bold('externalPackages')} (${chalk.bold('serverExternalPackages')} in Next.js) but contains workflow code (${issues.join(', ')}).` +
+                    `\n  This code will ${chalk.bold('not')} be transformed by the workflow compiler, which can cause runtime failures.` +
+                    `\n  Remove ${chalk.bold(`"${pkg}"`)} from ${chalk.bold('externalPackages')} (${chalk.bold('serverExternalPackages')} in Next.js) to fix this.\n`);
+            }
+            catch {
+                // Best-effort: if anything goes wrong, skip this package silently
+            }
+        }
+    }
     async discoverEntries(inputs, outdir, tsconfigPath) {
         const previousResult = this.discoveredEntries.get(inputs);
         if (previousResult) {
@@ -198,6 +342,8 @@ export class BaseBuilder {
         }
         catch (_) { }
         this.logBaseBuilderInfo(`Discovering workflow directives`, `${Date.now() - discoverStart}ms`);
+        // Warn about external packages that contain workflow code
+        await this.warnAboutExternalWorkflowPackages();
         this.discoveredEntries.set(inputs, state);
         return state;
     }
@@ -257,7 +403,9 @@ export class BaseBuilder {
                 }
             }
             if (throwOnError) {
-                throw new Error(`Build failed during ${phase}:\n${errorMessages.join('\n')}`);
+                throw new WorkflowBuildError(`Build failed during ${phase}:\n${errorMessages.join('\n')}`, {
+                    hint: `Review the esbuild errors above — they come from the ${phase} bundle. Fix the offending source files and re-run the build.`,
+                });
             }
         }
         if (!options?.suppressWarnings &&
@@ -293,19 +441,18 @@ export class BaseBuilder {
      * Steps have full Node.js runtime access and handle side effects, API calls, etc.
      *
      * @param externalizeNonSteps - If true, only bundles step entry points and externalizes other code
+     * @param bundleTransitiveLocalStepDependencies - If true, also bundles project-local files imported by step entries for direct runtime loading
      * @returns Build context (for watch mode) and the collected workflow manifest
      */
-    async createStepsBundle({ inputFiles, format = 'esm', outfile, externalizeNonSteps, rewriteTsExtensions, tsconfigPath, discoveredEntries, }) {
+    async createStepsBundle({ inputFiles, format = 'esm', outfile, externalizeNonSteps, bundleTransitiveLocalStepDependencies, rewriteTsExtensions, tsconfigPath, discoveredEntries, skipEsmRequireBanner = false, }) {
         const stepsBundleStart = Date.now();
         const workflowManifest = {};
         const builtInSteps = 'workflow/internal/builtins';
         const resolvedBuiltInSteps = await enhancedResolve(dirname(outfile), 'workflow/internal/builtins').catch((err) => {
-            throw new Error([
-                chalk.red('Failed to resolve built-in steps sources.'),
-                `${chalk.yellow.bold('hint:')} run \`${chalk.cyan.italic('npm install workflow')}\` to resolve this issue.`,
-                '',
-                `Caused by: ${chalk.red(String(err))}`,
-            ].join('\n'));
+            throw new WorkflowBuildError(`Failed to resolve built-in steps sources.\n\nCaused by: ${String(err)}`, {
+                hint: 'run `pnpm install workflow` to resolve this issue.',
+                cause: err,
+            });
         });
         // Discovery of workflow/step/serde entries. The SDK runtime entry point
         // (workflow/runtime) is resolved inside discoverEntries() itself so that
@@ -331,6 +478,28 @@ export class BaseBuilder {
         // For workspace/node_modules packages, uses the package name so esbuild
         // will resolve through package.json exports with the appropriate conditions
         const createImport = (file) => {
+            const normalizedWorkspaceRoot = this.config.workingDir
+                .replace(/\\/g, '/')
+                .replace(/\/$/, '');
+            const normalizedWorkspaceFile = file.replace(/\\/g, '/');
+            // Only use relative source paths for workspace symlinks (files
+            // outside node_modules in a packages/*/src/ directory). For tarball-
+            // installed packages (files inside node_modules/), fall through to
+            // getImportPath which returns package specifiers — this allows the
+            // SWC plugin's externalizeNonSteps to work correctly.
+            const isWorkspaceSourceBackedPackageFile = normalizedWorkspaceFile.includes('/packages/') &&
+                normalizedWorkspaceFile.includes('/src/') &&
+                !normalizedWorkspaceFile.includes('/node_modules/') &&
+                !(normalizedWorkspaceFile === normalizedWorkspaceRoot ||
+                    normalizedWorkspaceFile.startsWith(`${normalizedWorkspaceRoot}/`));
+            const isSourceBackedPackageFile = isWorkspaceSourceBackedPackageFile;
+            if (isSourceBackedPackageFile) {
+                let relativePath = relative(normalizedWorkspaceRoot, normalizedWorkspaceFile).replace(/\\/g, '/');
+                if (!relativePath.startsWith('./') && !relativePath.startsWith('../')) {
+                    relativePath = `./${relativePath}`;
+                }
+                return `import '${relativePath}';`;
+            }
             const { importPath, isPackage } = getImportPath(file, this.config.workingDir);
             if (isPackage) {
                 // Use package name - esbuild will resolve via package.json exports
@@ -363,8 +532,9 @@ export class BaseBuilder {
     ${stepImports}
     // Serde files for cross-context class registration
     ${serdeImports}
-    // API entrypoint
-    export { stepEntrypoint as POST } from 'workflow/runtime';`;
+    // Sentinel export so bundlers (rollup) don't tree-shake this module
+    // when it's imported as a side-effect-only dependency.
+    export const __steps_registered = true;`;
         // Bundle with esbuild and our custom SWC plugin
         const entriesToBundle = externalizeNonSteps
             ? [
@@ -383,7 +553,9 @@ export class BaseBuilder {
         ]);
         const esbuildTsconfigOptions = await getEsbuildTsconfigOptions(tsconfigPath);
         const { banner: importMetaBanner, define: importMetaDefine } = this.getCjsImportMetaPolyfill(format);
-        const esmRequireBanner = this.getEsmRequireBanner(format);
+        const esmRequireBanner = skipEsmRequireBanner
+            ? ''
+            : this.getEsmRequireBanner(format);
         const esbuildCtx = await esbuild.context({
             banner: {
                 js: `// biome-ignore-all lint: generated file\n/* eslint-disable */\n${importMetaBanner}${esmRequireBanner}`,
@@ -425,7 +597,7 @@ export class BaseBuilder {
             // Steps execute in Node.js context and inline sourcemaps ensure we get
             // meaningful stack traces with proper file names and line numbers when errors
             // occur in deeply nested function calls across multiple files.
-            sourcemap: 'inline',
+            sourcemap: this.resolveSourcemap('inline'),
             plugins: [
                 // Handle pseudo-packages like 'server-only' and 'client-only' by providing
                 // empty modules. Must run first to intercept these before other resolution.
@@ -436,6 +608,7 @@ export class BaseBuilder {
                     outdir: outfile ? dirname(outfile) : undefined,
                     projectRoot: this.transformProjectRoot,
                     workflowManifest,
+                    bundleTransitiveLocalStepDependencies,
                     rewriteTsExtensions,
                     sideEffectEntries: normalizedSideEffectEntries,
                 }),
@@ -564,7 +737,7 @@ export class BaseBuilder {
             // Inline source maps for better stack traces in workflow VM execution.
             // This intermediate bundle is executed via runInContext() in a VM, so we need
             // inline source maps to get meaningful stack traces instead of "evalmachine.<anonymous>".
-            sourcemap: 'inline',
+            sourcemap: this.resolveSourcemap('inline'),
             // Use tsconfig for path alias resolution.
             // For symlinked configs this uses tsconfigRaw to preserve cwd-relative aliases.
             ...esbuildTsconfigOptions,
@@ -625,7 +798,9 @@ export class BaseBuilder {
             await this.createSwcGitignore();
             if (!interimBundle.outputFiles ||
                 interimBundle.outputFiles.length === 0) {
-                throw new Error('No output files generated from esbuild');
+                throw new WorkflowBuildError('No output files generated from esbuild', {
+                    hint: 'This usually indicates a misconfigured entry point or an empty workflow directory. Check that your workflow files contain a `"use workflow"` or `"use step"` directive.',
+                });
             }
             // Serde compliance warnings: check if workflow bundle has Node.js imports
             // alongside serde-registered classes (these will fail at runtime in the sandbox)
@@ -701,7 +876,7 @@ export const POST = workflowEntrypoint(workflowCode);`;
                     outfile,
                     // Source maps for the final workflow bundle wrapper (not important since this code
                     // doesn't run in the VM - only the intermediate bundle sourcemap is relevant)
-                    sourcemap: EMIT_SOURCEMAPS_FOR_DEBUGGING,
+                    sourcemap: this.resolveSourcemap(EMIT_SOURCEMAPS_FOR_DEBUGGING),
                     absWorkingDir: this.config.workingDir,
                     bundle: true,
                     format,
@@ -717,16 +892,18 @@ export const POST = workflowEntrypoint(workflowCode);`;
                 });
                 this.logCreateWorkflowsBundleInfo('Created final workflow bundle', `${Date.now() - bundleStartTime}ms`);
             };
-            await bundleFinal(interimBundle.outputFiles[0].text);
+            const interimBundleText = interimBundle.outputFiles[0].text;
+            await bundleFinal(interimBundleText);
             if (keepInterimBundleContext) {
                 shouldDisposeInterimBundleCtx = false;
                 return {
                     manifest: workflowManifest,
                     interimBundleCtx,
                     bundleFinal,
+                    interimBundleText,
                 };
             }
-            return { manifest: workflowManifest };
+            return { manifest: workflowManifest, interimBundleText };
         }
         catch (error) {
             shouldDisposeInterimBundleCtx = true;
@@ -743,6 +920,153 @@ export const POST = workflowEntrypoint(workflowCode);`;
             }
         }
     }
+    /**
+     * V2: Creates a combined bundle that includes both step registrations and
+     * workflow orchestration in a single route. The combined entrypoint executes
+     * steps inline when possible, reducing function invocations and queue overhead.
+     *
+     * This method reuses createStepsBundle (for step registrations) and
+     * createWorkflowsBundle (for workflow VM code), then combines them into
+     * a single route file using workflowEntrypoint().
+     */
+    async createCombinedBundle({ inputFiles, stepsOutfile, flowOutfile, format = 'esm', bundleFinalOutput = true, tsconfigPath, externalizeNonSteps, bundleTransitiveLocalStepDependencies, discoveredEntries, }) {
+        // 1. Build step registrations bundle (used as separate file for
+        // bundleFinalOutput: false, or read back for inline content when true)
+        const { context: stepsContext, manifest: stepsManifest } = await this.createStepsBundle({
+            inputFiles,
+            outfile: stepsOutfile,
+            // When bundleFinalOutput is true, use ESM for the steps bundle
+            // regardless of the final output format. The final esbuild pass
+            // converts everything to the target format. Using CJS here causes
+            // a module.exports collision: the steps bundle's top-level
+            // module.exports overwrites the combined route's module.exports
+            // when esbuild inlines the steps without a __commonJS wrapper.
+            format: bundleFinalOutput ? 'esm' : format,
+            externalizeNonSteps,
+            bundleTransitiveLocalStepDependencies,
+            tsconfigPath,
+            discoveredEntries,
+            // Skip the createRequire banner here — when bundleFinalOutput is true
+            // the outer esbuild pass will inline this bundle and add its own
+            // banner. Emitting it twice declares __createRequire twice.
+            skipEsmRequireBanner: bundleFinalOutput,
+        });
+        // 2. Build workflow VM code
+        const tempWorkflowOutfile = `${flowOutfile}.__wf_tmp.js`;
+        const workflowsResult = await this.createWorkflowsBundle({
+            inputFiles,
+            outfile: tempWorkflowOutfile,
+            format,
+            bundleFinalOutput: false,
+            tsconfigPath,
+            discoveredEntries,
+        });
+        const workflowVMCode = workflowsResult.interimBundleText;
+        if (!workflowVMCode) {
+            throw new Error('createWorkflowsBundle did not return interimBundleText');
+        }
+        // Clean up the wrapper file
+        try {
+            const { unlink } = await import('node:fs/promises');
+            await unlink(tempWorkflowOutfile);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        // 3. Generate combined route file
+        const stepsRelativePath = './' + basename(stepsOutfile).replace(/\\/g, '/');
+        const escapedVMCode = workflowVMCode.replace(/[\\`$]/g, '\\$&');
+        const combinedFunctionCode = `// biome-ignore-all lint: generated file
+/* eslint-disable */
+import { __steps_registered } from '${stepsRelativePath}';
+import { workflowEntrypoint } from 'workflow/runtime';
+
+// Prevent rollup from tree-shaking the steps side-effect import
+void __steps_registered;
+
+const workflowCode = \`${escapedVMCode}\`;
+
+export const POST = workflowEntrypoint(workflowCode);`;
+        if (!bundleFinalOutput) {
+            // Write directly (Next.js will bundle)
+            const tempPath = `${flowOutfile}.${randomUUID()}.tmp`;
+            await writeFile(tempPath, combinedFunctionCode);
+            await rename(tempPath, flowOutfile);
+        }
+        else {
+            // Bundle the combined code for standalone use
+            const bundleStartTime = Date.now();
+            const { banner: importMetaBanner, define: importMetaDefine } = this.getCjsImportMetaPolyfill(format);
+            // ESM banner provides `require` via createRequire(import.meta.url) so
+            // CJS dependencies that call require() for Node.js builtins keep working
+            // in the ESM output produced by bundleFinalOutput: true.
+            const finalEsmRequireBanner = this.getEsmRequireBanner(format);
+            const finalResult = await esbuild.build({
+                banner: {
+                    js: `// biome-ignore-all lint: generated file\n/* eslint-disable */\n${importMetaBanner}${finalEsmRequireBanner}`,
+                },
+                stdin: {
+                    contents: combinedFunctionCode,
+                    resolveDir: dirname(flowOutfile),
+                    sourcefile: 'virtual-entry.js',
+                    loader: 'js',
+                },
+                outfile: flowOutfile,
+                absWorkingDir: this.config.workingDir,
+                bundle: true,
+                format,
+                platform: 'node',
+                target: 'es2022',
+                write: true,
+                keepNames: true,
+                minify: false,
+                define: importMetaDefine,
+                external: ['@aws-sdk/credential-provider-web-identity'],
+            });
+            this.logEsbuildMessages(finalResult, 'combined bundle', true);
+            this.logBaseBuilderInfo('Created combined bundle', `${Date.now() - bundleStartTime}ms`);
+        }
+        // Merge manifests
+        const manifest = {
+            ...stepsManifest,
+            workflows: {
+                ...stepsManifest.workflows,
+                ...workflowsResult.manifest.workflows,
+            },
+            classes: {
+                ...stepsManifest.classes,
+                ...workflowsResult.manifest.classes,
+            },
+        };
+        // Create a custom bundleFinal for watch mode that uses workflowEntrypoint
+        const combinedBundleFinal = async (interimBundleText) => {
+            const escaped = interimBundleText.replace(/[\\`$]/g, '\\$&');
+            const code = `// biome-ignore-all lint: generated file
+/* eslint-disable */
+import { __steps_registered } from '${stepsRelativePath}';
+import { workflowEntrypoint } from 'workflow/runtime';
+
+void __steps_registered;
+
+const workflowCode = \`${escaped}\`;
+
+export const POST = workflowEntrypoint(workflowCode);`;
+            const outputDir = dirname(flowOutfile);
+            await mkdir(outputDir, { recursive: true });
+            const tempPath = `${flowOutfile}.${randomUUID()}.tmp`;
+            await writeFile(tempPath, code);
+            await rename(tempPath, flowOutfile);
+        };
+        if (this.config.watch) {
+            return {
+                manifest,
+                stepsContext,
+                interimBundleCtx: workflowsResult.interimBundleCtx,
+                bundleFinal: combinedBundleFinal,
+            };
+        }
+        return { manifest };
+    }
     /**
      * Creates a client library bundle for workflow execution.
      * The client library allows importing and calling workflows from application code.
@@ -850,7 +1174,10 @@ export const POST = workflowEntrypoint(workflowCode);`;
         await mkdir(dirname(outfile), { recursive: true });
         // Create a static route that calls resumeWebhook
         // This route works for both Next.js and Vercel Build Output API
-        const routeContent = `import { resumeWebhook } from 'workflow/api';
+        // Bundled Build Output API webhook functions need world.ts statically
+        // present so getWorldLazy() can use the global getWorld registration
+        // instead of falling back to a missing sibling import("./world.js").
+        const routeContent = `${bundle ? "import 'workflow/runtime';\n" : ''}import { resumeWebhook } from 'workflow/api';
 
 async function handler(request) {
   const url = new URL(request.url);
@@ -919,7 +1246,7 @@ export const OPTIONS = handler;`;
                 '.mjs',
                 '.cjs',
             ],
-            sourcemap: EMIT_SOURCEMAPS_FOR_DEBUGGING,
+            sourcemap: this.resolveSourcemap(EMIT_SOURCEMAPS_FOR_DEBUGGING),
             mainFields: ['module', 'main'],
             // Don't externalize anything - bundle everything including workflow packages
             external: [],
@@ -995,6 +1322,28 @@ export const OPTIONS = handler;`;
             return this.resolvePath('.vercel/output/diagnostics/workflows-manifest.json');
         }
     }
+    /**
+     * Resolve the effective source map mode for a given call site. Precedence:
+     * explicit `sourcemap` config > `WORKFLOW_SOURCEMAP` env var > the call
+     * site's default. Returned value is passed directly to esbuild's
+     * `sourcemap` option.
+     */
+    resolveSourcemap(defaultMode) {
+        if (this.config.sourcemap !== undefined)
+            return this.config.sourcemap;
+        const envMode = parseSourcemapEnv(process.env.WORKFLOW_SOURCEMAP);
+        if (envMode !== undefined)
+            return envMode;
+        return defaultMode;
+    }
+    /**
+     * Whether the resolved source map mode emits any source maps at all.
+     * Used by consumers like the Vercel builder to decide whether to include
+     * the source-map-support runtime shim in generated functions.
+     */
+    get sourcemapsEnabled() {
+        return this.resolveSourcemap(true) !== false;
+    }
     /**
      * Creates a manifest JSON file containing step/workflow/class metadata
      * and graph data for visualization.