experimental-ash 0.26.0 → 0.28.0

package/dist/src/internal/nitro/host/create-application-nitro.js

@@ -1,491 +1 @@
-import { readFile } from "node:fs/promises";
-import { dirname, isAbsolute, join, relative, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { createNitro } from "nitro/builder";
-import { ASH_PACKAGE_NAME } from "#internal/package-name.js";
-import { resolvePackageSourceDirectoryPath, resolvePackageSourceFilePath, resolveWorkflowModulePath, } from "#internal/application/package.js";
-import { prepareAshVersionedCacheDirectory, writeAshVersionedCacheMetadata, } from "#internal/application/cache-metadata.js";
-import { resolveNitroBuildDirectory } from "#internal/application/paths.js";
-import { createNitroArtifactsConfig, } from "#internal/nitro/host/artifacts-config.js";
-import { createCompiledSandboxBackendPrunePlugin } from "#internal/nitro/host/compiled-sandbox-backend-prune-plugin.js";
-import { configureNitroRoutes } from "#internal/nitro/host/configure-nitro-routes.js";
-import { applyAshCronHandlerRoute } from "#internal/nitro/host/cron-handler-route.js";
-import { createNitroBundlerConfig } from "#internal/nitro/host/nitro-bundler-config.js";
-import { addNitroRoutingImportSpecifierPlugin } from "#internal/nitro/host/nitro-routing-import-specifier-plugin.js";
-import { registerScheduleTaskHandlers } from "#internal/nitro/host/schedule-task-routes.js";
-import { SERVER_EXTERNAL_PACKAGES } from "#internal/nitro/host/server-external-packages.js";
-import { createAshVercelOptions } from "#internal/nitro/host/vercel-build-output-config.js";
-import { applyWorkflowTransform } from "#internal/workflow-bundle/workflow-builders.js";
-/**
- * Bare `workflow/*` specifiers that appear in pre-built workflow bundles.
- * Nitro's alias system resolves these at Rollup build time for production,
- * replacing the import-rewriting post-processing that previously ran after
- * each builder invocation.
- */
-const WORKFLOW_ALIAS_SPECIFIERS = [
-    "workflow",
-    "workflow/api",
-    "workflow/errors",
-    "workflow/internal/builtins",
-    "workflow/internal/private",
-    "workflow/runtime",
-];
-const WORKFLOW_TRANSFORM_PATCHED = Symbol("ash.workflow-transform-patched");
-const WORKFLOW_CACHE_PATH_FRAGMENT = "/.ash/workflow-cache/";
-/**
- * Packages Ash itself pulls into hosted application output that must stay
- * external so Nitro/rolldown does not try to inline platform-specific
- * `.node` binaries (which would fail with a UTF-8 decode error).
- *
- * `@napi-rs/keyring` reaches the hosted bundle transitively through
- * `@vercel/oidc` → `@vercel/cli-auth` and ships native `keyring.<platform>.node`
- * binaries. App authors should not have to know about this; the framework
- * traces it into `server/node_modules` automatically.
- */
-const FRAMEWORK_HOSTED_EXTERNAL_PACKAGES = ["@napi-rs/keyring"];
-function resolveWorkflowAliases() {
-    const aliases = {};
-    for (const specifier of WORKFLOW_ALIAS_SPECIFIERS) {
-        aliases[specifier] = resolveWorkflowModulePath(specifier);
-    }
-    return aliases;
-}
-function resolveNitroPreset(dev) {
-    if (!dev && process.env.VERCEL) {
-        return "vercel";
-    }
-    return undefined;
-}
-function includesApplicationSurface(surface) {
-    return surface === "all" || surface === "app";
-}
-function includesWorkflowSurface(surface) {
-    return surface === "all" || surface === "flow";
-}
-function includesWorkflowStepRegistrations(surface) {
-    return includesWorkflowSurface(surface);
-}
-function resolveWorkflowStepEntrypointPath(nitro, preparedHost) {
-    return nitro.options.dev
-        ? join(nitro.options.buildDir, "workflow", "steps.mjs")
-        : join(preparedHost.workflowBuildDir, "steps.mjs");
-}
-function collectHostedTraceDependencies(preparedHost) {
-    const configuredBuildDependencies = preparedHost.compileResult.manifest.config.build;
-    const merged = new Set([
-        ...FRAMEWORK_HOSTED_EXTERNAL_PACKAGES,
-        ...SERVER_EXTERNAL_PACKAGES,
-        ...(configuredBuildDependencies?.externalDependencies ?? []),
-    ]);
-    return [...merged].filter((dependencyName) => dependencyName !== ASH_PACKAGE_NAME);
-}
-function normalizePath(path) {
-    return path.replaceAll("\\", "/");
-}
-function stripPathQueryAndHash(path) {
-    const queryIndex = path.indexOf("?");
-    const hashIndex = path.indexOf("#");
-    const cutoff = queryIndex === -1 ? hashIndex : hashIndex === -1 ? queryIndex : Math.min(queryIndex, hashIndex);
-    return cutoff === -1 ? path : path.slice(0, cutoff);
-}
-function stripFileSystemPrefix(path) {
-    return path.startsWith("/@fs/") ? path.slice("/@fs".length) : path;
-}
-function resolveNitroModuleComparisonPath(rootDir, path) {
-    if (path.startsWith("file://")) {
-        return normalizePath(stripFileSystemPrefix(stripPathQueryAndHash(fileURLToPath(path))));
-    }
-    if (isAbsolute(path)) {
-        return normalizePath(stripFileSystemPrefix(stripPathQueryAndHash(path)));
-    }
-    return normalizePath(stripFileSystemPrefix(stripPathQueryAndHash(resolve(rootDir, path))));
-}
-function isWorkflowBundlePath(path, normalizedWorkflowBuildDir) {
-    const normalizedPath = normalizePath(path);
-    return (normalizedPath.startsWith(normalizedWorkflowBuildDir) ||
-        normalizedPath.includes(WORKFLOW_CACHE_PATH_FRAGMENT));
-}
-function normalizeStepTransformComparisonPath(path) {
-    const normalizedPath = normalizePath(path);
-    return process.platform === "win32" ? normalizedPath.toLowerCase() : normalizedPath;
-}
-function parseImportedModuleSpecifiers(source) {
-    const importSpecifierPattern = /^\s*import\s+(?:.+?\s+from\s+)?["']([^"']+)["'];?\s*$/gm;
-    const importedSpecifiers = [];
-    for (const match of source.matchAll(importSpecifierPattern)) {
-        const importedSpecifier = match[1];
-        if (importedSpecifier !== undefined) {
-            importedSpecifiers.push(importedSpecifier);
-        }
-    }
-    return importedSpecifiers;
-}
-function resolveNitroImportPath(rootDir, importSpecifier, importer) {
-    if (importSpecifier.startsWith("workflow")) {
-        return resolveWorkflowModulePath(importSpecifier);
-    }
-    if (importSpecifier.startsWith(".") ||
-        importSpecifier.startsWith("/") ||
-        importSpecifier.startsWith("file://")) {
-        const importerDirectory = importer === undefined
-            ? rootDir
-            : dirname(resolveNitroModuleComparisonPath(rootDir, importer));
-        return resolveNitroModuleComparisonPath(importerDirectory, importSpecifier);
-    }
-    return null;
-}
-async function collectNitroStepTransformTargets(stepEntrypointPath, rootDir) {
-    const stepEntrypointSource = await readFile(stepEntrypointPath, "utf8");
-    const stepTransformTargets = new Set();
-    for (const importSpecifier of parseImportedModuleSpecifiers(stepEntrypointSource)) {
-        const resolvedImportPath = resolveNitroImportPath(rootDir, importSpecifier, stepEntrypointPath);
-        if (resolvedImportPath !== null) {
-            stepTransformTargets.add(normalizeStepTransformComparisonPath(resolvedImportPath));
-        }
-    }
-    return stepTransformTargets;
-}
-async function addNitroStepNoExternals(nitro, stepEntrypointPath) {
-    if (nitro.options.noExternals === true) {
-        return;
-    }
-    let stepTransformTargets;
-    try {
-        stepTransformTargets = await collectNitroStepTransformTargets(stepEntrypointPath, nitro.options.rootDir);
-    }
-    catch (error) {
-        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-            return;
-        }
-        throw error;
-    }
-    const existingNoExternals = Array.isArray(nitro.options.noExternals)
-        ? [...nitro.options.noExternals]
-        : [];
-    nitro.options.noExternals = [...new Set([...existingNoExternals, ...stepTransformTargets])];
-}
-function createRelativeTransformFilename(workingDir, path) {
-    const normalizedWorkingDir = normalizePath(workingDir).replace(/\/$/, "");
-    const normalizedPath = normalizePath(path);
-    const lowerWorkingDir = normalizedWorkingDir.toLowerCase();
-    const lowerPath = normalizedPath.toLowerCase();
-    if (lowerPath.startsWith(`${lowerWorkingDir}/`)) {
-        return normalizedPath.slice(normalizedWorkingDir.length + 1);
-    }
-    if (lowerPath === lowerWorkingDir) {
-        return ".";
-    }
-    let relativePath = relative(normalizedWorkingDir, normalizedPath).replaceAll("\\", "/");
-    if (relativePath.startsWith("../")) {
-        relativePath = relativePath
-            .split("/")
-            .filter((part) => part !== "..")
-            .join("/");
-    }
-    if (relativePath.includes(":") || relativePath.startsWith("/")) {
-        const filename = normalizedPath.split("/").pop();
-        return filename === undefined || filename.length === 0 ? "unknown.ts" : filename;
-    }
-    return relativePath;
-}
-function addWorkflowModuleSideEffectsPlugin(nitro, workflowBuildDir) {
-    const workflowBundleDirectories = [
-        workflowBuildDir,
-        join(nitro.options.buildDir, "workflow"),
-    ].map((directoryPath) => resolveNitroModuleComparisonPath(nitro.options.rootDir, directoryPath));
-    nitro.hooks.hook("rollup:before", (_nitro, config) => {
-        if (!Array.isArray(config.plugins)) {
-            return;
-        }
-        config.plugins.unshift({
-            name: "ash:workflow-module-side-effects",
-            resolveId(source, importer) {
-                const resolvedSource = resolveNitroImportPath(nitro.options.rootDir, source, importer) ??
-                    resolveNitroModuleComparisonPath(nitro.options.rootDir, source);
-                if (!workflowBundleDirectories.some((workflowBundleDirectory) => isWorkflowBundlePath(resolvedSource, workflowBundleDirectory))) {
-                    return null;
-                }
-                return {
-                    id: resolvedSource,
-                    moduleSideEffects: "no-treeshake",
-                };
-            },
-        });
-    });
-}
-function addNitroStepModuleSideEffectsPlugin(nitro, input) {
-    let cachedStepTransformTargets = null;
-    const getStepTransformTargets = async () => {
-        if (cachedStepTransformTargets !== null) {
-            return cachedStepTransformTargets;
-        }
-        cachedStepTransformTargets = await collectNitroStepTransformTargets(input.stepEntrypointPath, nitro.options.rootDir);
-        return cachedStepTransformTargets;
-    };
-    nitro.hooks.hook("build:before", () => {
-        cachedStepTransformTargets = null;
-    });
-    if (nitro.options.dev) {
-        nitro.hooks.hook("dev:reload", () => {
-            cachedStepTransformTargets = null;
-        });
-    }
-    nitro.hooks.hook("rollup:before", (_nitro, config) => {
-        if (!Array.isArray(config.plugins)) {
-            return;
-        }
-        config.plugins.unshift({
-            name: "ash:workflow-step-module-side-effects",
-            async resolveId(source, importer) {
-                const resolvedSource = resolveNitroImportPath(nitro.options.rootDir, source, importer);
-                if (resolvedSource === null) {
-                    return null;
-                }
-                const stepTransformTargets = await getStepTransformTargets();
-                if (!stepTransformTargets.has(normalizeStepTransformComparisonPath(resolvedSource))) {
-                    return null;
-                }
-                return {
-                    id: resolvedSource,
-                    moduleSideEffects: "no-treeshake",
-                };
-            },
-        });
-    });
-}
-/**
- * Transforms package-owned execution sources in step mode so the generated
- * Nitro `steps.mjs` entry can import raw source files while still registering
- * durable step handlers with the Workflow runtime.
- */
-function addNitroStepTransformPlugin(nitro, input) {
-    let cachedStepTransformTargets = null;
-    const getStepTransformTargets = async () => {
-        if (cachedStepTransformTargets !== null) {
-            return cachedStepTransformTargets;
-        }
-        cachedStepTransformTargets = await collectNitroStepTransformTargets(input.stepEntrypointPath, nitro.options.rootDir);
-        return cachedStepTransformTargets;
-    };
-    nitro.hooks.hook("build:before", () => {
-        cachedStepTransformTargets = null;
-    });
-    if (nitro.options.dev) {
-        nitro.hooks.hook("dev:reload", () => {
-            cachedStepTransformTargets = null;
-        });
-    }
-    nitro.hooks.hook("rollup:before", (_nitro, config) => {
-        if (!Array.isArray(config.plugins)) {
-            return;
-        }
-        config.plugins.unshift({
-            async transform(code, id) {
-                const stepTransformTargets = await getStepTransformTargets();
-                const resolvedId = resolveNitroModuleComparisonPath(nitro.options.rootDir, id);
-                if (!stepTransformTargets.has(normalizeStepTransformComparisonPath(resolvedId))) {
-                    return null;
-                }
-                const result = await applyWorkflowTransform(createRelativeTransformFilename(nitro.options.rootDir, resolvedId), code, "step", resolvedId, nitro.options.rootDir);
-                return {
-                    code: result.code,
-                    map: null,
-                };
-            },
-            name: "ash:workflow-step-transform",
-        });
-    });
-}
-/**
- * Marks the authored instrumentation module as side-effectful so Nitro's final
- * Rollup/Rolldown pass preserves its eager evaluation from the generated
- * instrumentation plugin.
- */
-function addInstrumentationModuleSideEffectsPlugin(nitro, instrumentationModulePath) {
-    const normalizedInstrumentationModulePath = normalizePath(instrumentationModulePath);
-    nitro.hooks.hook("rollup:before", (_nitro, config) => {
-        if (!Array.isArray(config.plugins)) {
-            return;
-        }
-        config.plugins.unshift({
-            name: "ash:instrumentation-module-side-effects",
-            resolveId(source) {
-                if (normalizePath(source) !== normalizedInstrumentationModulePath) {
-                    return null;
-                }
-                return {
-                    id: source,
-                    moduleSideEffects: "no-treeshake",
-                };
-            },
-        });
-    });
-}
-/**
- * Extends the Workflow Nitro transform exclusion list to include Ash's
- * package-owned workflow cache directory.
- *
- * Without this patch, the Workflow transform can re-process the already-built
- * `steps.mjs` bundle and strip top-level step registrations from hosted output.
- */
-function patchWorkflowTransformExcludePath(nitro, workflowBuildDir) {
-    const normalizedWorkflowBuildDir = normalizePath(workflowBuildDir);
-    nitro.hooks.hook("rollup:before", (_nitro, config) => {
-        if (!Array.isArray(config.plugins)) {
-            return;
-        }
-        for (const plugin of config.plugins) {
-            if (plugin === null || plugin === undefined || typeof plugin !== "object") {
-                continue;
-            }
-            const workflowTransformPlugin = plugin;
-            if (workflowTransformPlugin.name !== "workflow:transform") {
-                continue;
-            }
-            if (workflowTransformPlugin[WORKFLOW_TRANSFORM_PATCHED] === true) {
-                continue;
-            }
-            if (typeof workflowTransformPlugin.transform !== "function") {
-                continue;
-            }
-            const originalTransform = workflowTransformPlugin.transform;
-            workflowTransformPlugin.transform = function (code, id, ...rest) {
-                if (isWorkflowBundlePath(id, normalizedWorkflowBuildDir)) {
-                    return null;
-                }
-                return originalTransform.call(this, code, id, ...rest);
-            };
-            workflowTransformPlugin[WORKFLOW_TRANSFORM_PATCHED] = true;
-        }
-    });
-}
-/**
- * Creates one configured Nitro instance for either production build or dev
- * hosting of an Ash application.
- *
- * `surface` narrows the mounted routes for isolated production builds.
- * `outputDir` lets callers stage those isolated builds into separate Nitro
- * output roots before assembling the final hosted deployment.
- */
-export async function createApplicationNitro(preparedHost, dev, options = {}) {
-    const surface = options.surface ?? "all";
-    // In dev mode, schedules are skipped unless explicitly enabled via
-    // `ash dev --schedules`. Production builds always register schedules.
-    const schedulesAllowed = !dev || options.schedules === true;
-    const shouldRegisterScheduleTasks = schedulesAllowed &&
-        includesApplicationSurface(surface) &&
-        preparedHost.scheduleRegistrations.length > 0;
-    const preset = resolveNitroPreset(dev);
-    const compiledSandboxBackendPrunePlugin = preset === "vercel" ? createCompiledSandboxBackendPrunePlugin() : null;
-    const nitroBundlerPlugins = compiledSandboxBackendPrunePlugin === null ? [] : [compiledSandboxBackendPrunePlugin];
-    const nitroRolldownConfig = createNitroBundlerConfig(nitroBundlerPlugins);
-    const nitroRollupConfig = createNitroBundlerConfig(nitroBundlerPlugins);
-    const tracedAppDependencies = collectHostedTraceDependencies(preparedHost);
-    const nitroBuildDir = resolveNitroBuildDirectory(preparedHost.appRoot, surface);
-    const nitroPlugins = preparedHost.compiledArtifacts.instrumentationPluginPath === undefined
-        ? [preparedHost.compiledArtifacts.bootstrapPath]
-        : [
-            preparedHost.compiledArtifacts.instrumentationPluginPath,
-            preparedHost.compiledArtifacts.bootstrapPath,
-        ];
-    await prepareAshVersionedCacheDirectory(nitroBuildDir);
-    const nitro = await createNitro({
-        _cli: {
-            command: dev ? "dev" : "build",
-        },
-        buildDir: nitroBuildDir,
-        dev,
-        logLevel: dev ? 1 : undefined,
-        output: options.outputDir === undefined
-            ? undefined
-            : {
-                dir: options.outputDir,
-            },
-        preset,
-        plugins: nitroPlugins,
-        publicAssets: [],
-        scanDirs: includesWorkflowStepRegistrations(surface)
-            ? [resolvePackageSourceDirectoryPath("src/execution")]
-            : undefined,
-        rolldownConfig: nitroRolldownConfig,
-        rollupConfig: nitroRollupConfig,
-        rootDir: preparedHost.appRoot,
-        serverDir: false,
-        traceDeps: tracedAppDependencies,
-        vercel: createAshVercelOptions(preset === "vercel" && includesApplicationSurface(surface)),
-    }, dev
-        ? {
-            watch: true,
-        }
-        : undefined);
-    await writeAshVersionedCacheMetadata(nitroBuildDir);
-    addNitroRoutingImportSpecifierPlugin(nitro);
-    // Resolve bare `workflow/*` specifiers during Nitro's Rollup bundling so
-    // pre-built workflow modules (whose imports target Ash's installed copies)
-    // resolve correctly in production builds where Node resolution from the
-    // workflow cache directory is not available.
-    if (includesWorkflowSurface(surface)) {
-        const workflowAliases = resolveWorkflowAliases();
-        for (const [specifier, resolvedPath] of Object.entries(workflowAliases)) {
-            nitro.options.alias[specifier] = resolvedPath;
-        }
-        addWorkflowModuleSideEffectsPlugin(nitro, preparedHost.workflowBuildDir);
-        patchWorkflowTransformExcludePath(nitro, preparedHost.workflowBuildDir);
-    }
-    if (includesWorkflowStepRegistrations(surface)) {
-        const stepEntrypointPath = resolveWorkflowStepEntrypointPath(nitro, preparedHost);
-        addNitroStepModuleSideEffectsPlugin(nitro, {
-            stepEntrypointPath,
-        });
-        addNitroStepTransformPlugin(nitro, {
-            stepEntrypointPath,
-        });
-    }
-    if (preparedHost.compiledArtifacts.instrumentationSourcePath !== undefined) {
-        addInstrumentationModuleSideEffectsPlugin(nitro, preparedHost.compiledArtifacts.instrumentationSourcePath);
-    }
-    // Prevent Nitro from re-bundling the pre-built workflow bundle in dev
-    // mode. `steps.mjs` is now a source entry that Nitro must still bundle
-    // so its imported TypeScript step files are transformed.
-    if (dev && includesWorkflowSurface(surface)) {
-        const workflowBuildDir = preparedHost.workflowBuildDir;
-        const externalWorkflowModules = new Set([
-            normalizePath(join(workflowBuildDir, "workflows.mjs")),
-        ]);
-        nitro.hooks.hook("rollup:before", (_nitro, config) => {
-            const existingExternal = config.external;
-            config.external = (id, ...rest) => {
-                if (externalWorkflowModules.has(normalizePath(id))) {
-                    return true;
-                }
-                if (typeof existingExternal === "function") {
-                    return existingExternal(id, ...rest);
-                }
-                return undefined;
-            };
-        });
-    }
-    if (shouldRegisterScheduleTasks) {
-        // Replace Vercel's default `/_vercel/cron` path with an unguessable
-        // per-build route so users do not need to configure `CRON_SECRET` to
-        // protect the cron endpoint. No-op when the Vercel preset is not in
-        // use (e.g. dev mode), where the cron route is never registered.
-        applyAshCronHandlerRoute(nitro);
-        const artifactsConfig = createNitroArtifactsConfig({
-            appRoot: preparedHost.appRoot,
-            dev: nitro.options.dev,
-        });
-        registerScheduleTaskHandlers(nitro, {
-            artifactsConfig,
-            dispatchModulePath: resolvePackageSourceFilePath("src/internal/nitro/routes/schedule-task.ts"),
-            registrations: preparedHost.scheduleRegistrations,
-        });
-    }
-    await configureNitroRoutes(nitro, preparedHost, {
-        surface,
-    });
-    if (includesWorkflowStepRegistrations(surface)) {
-        await addNitroStepNoExternals(nitro, resolveWorkflowStepEntrypointPath(nitro, preparedHost));
-    }
-    return nitro;
-}
+import{dirname,isAbsolute,join,relative,resolve}from"node:path";import{readFile}from"node:fs/promises";import{resolveNitroBuildDirectory}from"#internal/application/paths.js";import{resolvePackageSourceDirectoryPath,resolvePackageSourceFilePath,resolveWorkflowModulePath}from"#internal/application/package.js";import{ASH_PACKAGE_NAME}from"#internal/package-name.js";import{fileURLToPath}from"node:url";import{createNitro}from"nitro/builder";import{prepareAshVersionedCacheDirectory,writeAshVersionedCacheMetadata}from"#internal/application/cache-metadata.js";import{createNitroArtifactsConfig}from"#internal/nitro/host/artifacts-config.js";import{createCompiledSandboxBackendPrunePlugin}from"#internal/nitro/host/compiled-sandbox-backend-prune-plugin.js";import{configureNitroRoutes}from"#internal/nitro/host/configure-nitro-routes.js";import{applyAshCronHandlerRoute}from"#internal/nitro/host/cron-handler-route.js";import{createNitroBundlerConfig}from"#internal/nitro/host/nitro-bundler-config.js";import{addNitroRoutingImportSpecifierPlugin}from"#internal/nitro/host/nitro-routing-import-specifier-plugin.js";import{registerScheduleTaskHandlers}from"#internal/nitro/host/schedule-task-routes.js";import{SERVER_EXTERNAL_PACKAGES}from"#internal/nitro/host/server-external-packages.js";import{createAshVercelOptions}from"#internal/nitro/host/vercel-build-output-config.js";import{applyWorkflowTransform}from"#internal/workflow-bundle/workflow-builders.js";var WORKFLOW_ALIAS_SPECIFIERS=[`workflow`,`workflow/api`,`workflow/errors`,`workflow/internal/builtins`,`workflow/internal/private`,`workflow/runtime`],WORKFLOW_TRANSFORM_PATCHED=Symbol(`ash.workflow-transform-patched`),WORKFLOW_CACHE_PATH_FRAGMENT=`/.ash/workflow-cache/`,FRAMEWORK_HOSTED_EXTERNAL_PACKAGES=[`@napi-rs/keyring`];function resolveWorkflowAliases(){let e={};for(let t of WORKFLOW_ALIAS_SPECIFIERS)e[t]=resolveWorkflowModulePath(t);return e}function resolveNitroPreset(e){if(!e&&process.env.VERCEL)return`vercel`}function includesApplicationSurface(e){return e===`all`||e===`app`}function includesWorkflowSurface(e){return e===`all`||e===`flow`}function includesWorkflowStepRegistrations(e){return includesWorkflowSurface(e)}function resolveWorkflowStepEntrypointPath(e,t){return e.options.dev?join(e.options.buildDir,`workflow`,`steps.mjs`):join(t.workflowBuildDir,`steps.mjs`)}function collectHostedTraceDependencies(e){let t=e.compileResult.manifest.config.build;return[...new Set([...FRAMEWORK_HOSTED_EXTERNAL_PACKAGES,...SERVER_EXTERNAL_PACKAGES,...t?.externalDependencies??[]])].filter(e=>e!==ASH_PACKAGE_NAME)}function normalizePath(e){return e.replaceAll(`\\`,`/`)}function stripPathQueryAndHash(e){let t=e.indexOf(`?`),n=e.indexOf(`#`),r=t===-1?n:n===-1?t:Math.min(t,n);return r===-1?e:e.slice(0,r)}function stripFileSystemPrefix(e){return e.startsWith(`/@fs/`)?e.slice(4):e}function resolveNitroModuleComparisonPath(e,n){return n.startsWith(`file://`)?normalizePath(stripFileSystemPrefix(stripPathQueryAndHash(fileURLToPath(n)))):isAbsolute(n)?normalizePath(stripFileSystemPrefix(stripPathQueryAndHash(n))):normalizePath(stripFileSystemPrefix(stripPathQueryAndHash(resolve(e,n))))}function isWorkflowBundlePath(e,t){let n=normalizePath(e);return n.startsWith(t)||n.includes(WORKFLOW_CACHE_PATH_FRAGMENT)}function normalizeStepTransformComparisonPath(e){let t=normalizePath(e);return process.platform===`win32`?t.toLowerCase():t}function parseImportedModuleSpecifiers(e){let t=/^\s*import\s+(?:.+?\s+from\s+)?["']([^"']+)["'];?\s*$/gm,n=[];for(let r of e.matchAll(t)){let e=r[1];e!==void 0&&n.push(e)}return n}function resolveNitroImportPath(t,n,r){return n.startsWith(`workflow`)?resolveWorkflowModulePath(n):n.startsWith(`.`)||n.startsWith(`/`)||n.startsWith(`file://`)?resolveNitroModuleComparisonPath(r===void 0?t:dirname(resolveNitroModuleComparisonPath(t,r)),n):null}async function collectNitroStepTransformTargets(e,t){let n=await readFile(e,`utf8`),r=new Set;for(let i of parseImportedModuleSpecifiers(n)){let n=resolveNitroImportPath(t,i,e);n!==null&&r.add(normalizeStepTransformComparisonPath(n))}return r}async function addNitroStepNoExternals(e,t){if(e.options.noExternals===!0)return;let n;try{n=await collectNitroStepTransformTargets(t,e.options.rootDir)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return;throw e}let r=Array.isArray(e.options.noExternals)?[...e.options.noExternals]:[];e.options.noExternals=[...new Set([...r,...n])]}function createRelativeTransformFilename(e,t){let n=normalizePath(e).replace(/\/$/,``),i=normalizePath(t),a=n.toLowerCase(),o=i.toLowerCase();if(o.startsWith(`${a}/`))return i.slice(n.length+1);if(o===a)return`.`;let s=relative(n,i).replaceAll(`\\`,`/`);if(s.startsWith(`../`)&&(s=s.split(`/`).filter(e=>e!==`..`).join(`/`)),s.includes(`:`)||s.startsWith(`/`)){let e=i.split(`/`).pop();return e===void 0||e.length===0?`unknown.ts`:e}return s}function addWorkflowModuleSideEffectsPlugin(e,t){let r=[t,join(e.options.buildDir,`workflow`)].map(t=>resolveNitroModuleComparisonPath(e.options.rootDir,t));e.hooks.hook(`rollup:before`,(t,n)=>{Array.isArray(n.plugins)&&n.plugins.unshift({name:`ash:workflow-module-side-effects`,resolveId(t,n){let i=resolveNitroImportPath(e.options.rootDir,t,n)??resolveNitroModuleComparisonPath(e.options.rootDir,t);return r.some(e=>isWorkflowBundlePath(i,e))?{id:i,moduleSideEffects:`no-treeshake`}:null}})})}function addNitroStepModuleSideEffectsPlugin(e,t){let n=null,getStepTransformTargets=async()=>(n===null&&(n=await collectNitroStepTransformTargets(t.stepEntrypointPath,e.options.rootDir)),n);e.hooks.hook(`build:before`,()=>{n=null}),e.options.dev&&e.hooks.hook(`dev:reload`,()=>{n=null}),e.hooks.hook(`rollup:before`,(t,n)=>{Array.isArray(n.plugins)&&n.plugins.unshift({name:`ash:workflow-step-module-side-effects`,async resolveId(t,n){let r=resolveNitroImportPath(e.options.rootDir,t,n);return r===null||!(await getStepTransformTargets()).has(normalizeStepTransformComparisonPath(r))?null:{id:r,moduleSideEffects:`no-treeshake`}}})})}function addNitroStepTransformPlugin(e,t){let n=null,getStepTransformTargets=async()=>(n===null&&(n=await collectNitroStepTransformTargets(t.stepEntrypointPath,e.options.rootDir)),n);e.hooks.hook(`build:before`,()=>{n=null}),e.options.dev&&e.hooks.hook(`dev:reload`,()=>{n=null}),e.hooks.hook(`rollup:before`,(t,n)=>{Array.isArray(n.plugins)&&n.plugins.unshift({async transform(t,n){let r=await getStepTransformTargets(),i=resolveNitroModuleComparisonPath(e.options.rootDir,n);return r.has(normalizeStepTransformComparisonPath(i))?{code:(await applyWorkflowTransform(createRelativeTransformFilename(e.options.rootDir,i),t,`step`,i,e.options.rootDir)).code,map:null}:null},name:`ash:workflow-step-transform`})})}function addInstrumentationModuleSideEffectsPlugin(e,t){let n=normalizePath(t);e.hooks.hook(`rollup:before`,(e,t)=>{Array.isArray(t.plugins)&&t.plugins.unshift({name:`ash:instrumentation-module-side-effects`,resolveId(e){return normalizePath(e)===n?{id:e,moduleSideEffects:`no-treeshake`}:null}})})}function patchWorkflowTransformExcludePath(e,t){let n=normalizePath(t);e.hooks.hook(`rollup:before`,(e,t)=>{if(Array.isArray(t.plugins))for(let e of t.plugins){if(typeof e!=`object`||!e)continue;let t=e;if(t.name!==`workflow:transform`||t[WORKFLOW_TRANSFORM_PATCHED]===!0||typeof t.transform!=`function`)continue;let r=t.transform;t.transform=function(e,t,...i){return isWorkflowBundlePath(t,n)?null:r.call(this,e,t,...i)},t[WORKFLOW_TRANSFORM_PATCHED]=!0}})}async function createApplicationNitro(e,t,r={}){let i=r.surface??`all`,a=(!t||r.schedules===!0)&&includesApplicationSurface(i)&&e.scheduleRegistrations.length>0,c=resolveNitroPreset(t),l=c===`vercel`?createCompiledSandboxBackendPrunePlugin():null,u=l===null?[]:[l],d=createNitroBundlerConfig(u),f=createNitroBundlerConfig(u),p=collectHostedTraceDependencies(e),m=resolveNitroBuildDirectory(e.appRoot,i),h=e.compiledArtifacts.instrumentationPluginPath===void 0?[e.compiledArtifacts.bootstrapPath]:[e.compiledArtifacts.instrumentationPluginPath,e.compiledArtifacts.bootstrapPath];await prepareAshVersionedCacheDirectory(m);let g=await createNitro({_cli:{command:t?`dev`:`build`},buildDir:m,dev:t,logLevel:t?1:void 0,output:r.outputDir===void 0?void 0:{dir:r.outputDir},preset:c,plugins:h,publicAssets:[],scanDirs:includesWorkflowStepRegistrations(i)?[resolvePackageSourceDirectoryPath(`src/execution`)]:void 0,rolldownConfig:d,rollupConfig:f,rootDir:e.appRoot,serverDir:!1,traceDeps:p,vercel:createAshVercelOptions(c===`vercel`&&includesApplicationSurface(i))},t?{watch:!0}:void 0);if(await writeAshVersionedCacheMetadata(m),addNitroRoutingImportSpecifierPlugin(g),includesWorkflowSurface(i)){let t=resolveWorkflowAliases();for(let[e,n]of Object.entries(t))g.options.alias[e]=n;addWorkflowModuleSideEffectsPlugin(g,e.workflowBuildDir),patchWorkflowTransformExcludePath(g,e.workflowBuildDir)}if(includesWorkflowStepRegistrations(i)){let t=resolveWorkflowStepEntrypointPath(g,e);addNitroStepModuleSideEffectsPlugin(g,{stepEntrypointPath:t}),addNitroStepTransformPlugin(g,{stepEntrypointPath:t})}if(e.compiledArtifacts.instrumentationSourcePath!==void 0&&addInstrumentationModuleSideEffectsPlugin(g,e.compiledArtifacts.instrumentationSourcePath),t&&includesWorkflowSurface(i)){let t=e.workflowBuildDir,r=new Set([normalizePath(join(t,`workflows.mjs`))]);g.hooks.hook(`rollup:before`,(e,t)=>{let n=t.external;t.external=(e,...t)=>{if(r.has(normalizePath(e)))return!0;if(typeof n==`function`)return n(e,...t)}})}return a&&(applyAshCronHandlerRoute(g),registerScheduleTaskHandlers(g,{artifactsConfig:createNitroArtifactsConfig({appRoot:e.appRoot,dev:g.options.dev}),dispatchModulePath:resolvePackageSourceFilePath(`src/internal/nitro/routes/schedule-task.ts`),registrations:e.scheduleRegistrations})),await configureNitroRoutes(g,e,{surface:i}),includesWorkflowStepRegistrations(i)&&await addNitroStepNoExternals(g,resolveWorkflowStepEntrypointPath(g,e)),g}export{createApplicationNitro};

package/dist/src/internal/nitro/host/cron-handler-route.js

@@ -1,49 +1 @@
-import { randomUUID } from "node:crypto";
-import { ASH_ROUTE_PREFIX } from "#protocol/routes.js";
-/**
- * Builds an unguessable route path for Ash's Vercel cron handler.
- *
- * Vercel cron jobs hit a single configurable path (default `/_vercel/cron`)
- * for every scheduled tick, identifying the schedule via the
- * `x-vercel-cron-schedule` header. The default path is publicly known and
- * relies on the user setting a `CRON_SECRET` env var to authenticate
- * incoming requests.
- *
- * Ash sidesteps the manual env var by giving each build a unique random
- * handler path under the framework's protocol prefix — the path itself is
- * the secret. Vercel's cron infra reads the path from the deploy's
- * `config.crons[]` so the platform always knows where to POST, and the same
- * path is registered as a Nitro route handler in the function. The path is
- * never logged, exposed in HTTP responses, or persisted, so it is
- * unguessable to anyone without access to the deploy's build artifacts.
- *
- * If `CRON_SECRET` is also set, Nitro's preset will additionally validate
- * the `Authorization` header — the unguessable path replaces a required
- * `CRON_SECRET` and acts as defense in depth when both are configured.
- */
-export function createAshCronHandlerRoute() {
-    return `${ASH_ROUTE_PREFIX}/cron/${randomUUID()}`;
-}
-/**
- * Applies Ash's unguessable cron handler route to a Nitro instance built
- * with the Vercel preset.
- *
- * The Vercel preset reads `nitro.options.vercel.cronHandlerRoute` at two
- * later moments in the build:
- *   - the `build:before` hook registers the Nitro handler at that path,
- *   - the build output writer emits `config.crons[].path` from the same
- *     value.
- *
- * Both reads happen after `createNitro()` returns, so a one-time mutation
- * before the first build hook fires keeps the handler and the published
- * cron path in sync.
- *
- * No-op for non-Vercel presets, which never populate
- * `nitro.options.vercel`.
- */
-export function applyAshCronHandlerRoute(nitro) {
-    if (nitro.options.vercel === undefined) {
-        return;
-    }
-    nitro.options.vercel.cronHandlerRoute = createAshCronHandlerRoute();
-}
+import{ASH_ROUTE_PREFIX}from"#protocol/routes.js";import{randomUUID}from"node:crypto";function createAshCronHandlerRoute(){return`${ASH_ROUTE_PREFIX}/cron/${randomUUID()}`}function applyAshCronHandlerRoute(e){e.options.vercel!==void 0&&(e.options.vercel.cronHandlerRoute=createAshCronHandlerRoute())}export{applyAshCronHandlerRoute,createAshCronHandlerRoute};