@workflow/nitro 4.0.1-beta.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Vercel, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# workflow/nitro
+
+The docs have moved! Refer to them [here](https://useworkflow.dev/)

package/dist/builders.d.ts

@@ -0,0 +1,13 @@
+import { BaseBuilder } from '@workflow/cli/dist/lib/builders/base-builder';
+import { VercelBuildOutputAPIBuilder } from '@workflow/cli/dist/lib/builders/vercel-build-output-api';
+import type { Nitro } from 'nitro/types';
+export declare class VercelBuilder extends VercelBuildOutputAPIBuilder {
+    constructor(nitro: Nitro);
+    build(): Promise<void>;
+}
+export declare class LocalBuilder extends BaseBuilder {
+    #private;
+    constructor(nitro: Nitro);
+    build(): Promise<void>;
+}
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,yDAAyD,CAAC;AACtG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AASzC,qBAAa,aAAc,SAAQ,2BAA2B;gBAChD,KAAK,EAAE,KAAK;IAMT,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAWtC;AAED,qBAAa,YAAa,SAAQ,WAAW;;gBAE/B,KAAK,EAAE,KAAK;IAUT,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBtC"}

package/dist/builders.js

@@ -0,0 +1,59 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { BaseBuilder } from '@workflow/cli/dist/lib/builders/base-builder';
+import { VercelBuildOutputAPIBuilder } from '@workflow/cli/dist/lib/builders/vercel-build-output-api';
+const CommonBuildOptions = {
+    dirs: ['workflows'],
+    buildTarget: 'next', // unused in base
+    stepsBundlePath: '', // unused in base
+    workflowsBundlePath: '', // unused in base
+};
+export class VercelBuilder extends VercelBuildOutputAPIBuilder {
+    constructor(nitro) {
+        super({
+            ...CommonBuildOptions,
+            workingDir: nitro.options.rootDir,
+        });
+    }
+    async build() {
+        const configPath = join(this.config.workingDir, '.vercel/output/config.json');
+        const originalConfig = JSON.parse(await readFile(configPath, 'utf-8'));
+        await super.build();
+        const newConfig = JSON.parse(await readFile(configPath, 'utf-8'));
+        originalConfig.routes.unshift(...newConfig.routes);
+        await writeFile(configPath, JSON.stringify(originalConfig, null, 2));
+    }
+}
+export class LocalBuilder extends BaseBuilder {
+    #outDir;
+    constructor(nitro) {
+        const outDir = join(nitro.options.buildDir, 'workflow');
+        super({
+            ...CommonBuildOptions,
+            workingDir: nitro.options.rootDir,
+            watch: nitro.options.dev,
+        });
+        this.#outDir = outDir;
+    }
+    async build() {
+        const inputFiles = await this.getInputFiles();
+        await mkdir(this.#outDir, { recursive: true });
+        await this.createWorkflowsBundle({
+            outfile: join(this.#outDir, 'workflows.mjs'),
+            bundleFinalOutput: false,
+            format: 'esm',
+            inputFiles,
+        });
+        await this.createStepsBundle({
+            outfile: join(this.#outDir, 'steps.mjs'),
+            externalizeNonSteps: true,
+            format: 'esm',
+            inputFiles,
+        });
+        await this.createWebhookBundle({
+            outfile: join(this.#outDir, 'webhook.mjs'),
+            bundle: false,
+        });
+    }
+}
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,yDAAyD,CAAC;AAGtG,MAAM,kBAAkB,GAAG;IACzB,IAAI,EAAE,CAAC,WAAW,CAAC;IACnB,WAAW,EAAE,MAAe,EAAE,iBAAiB;IAC/C,eAAe,EAAE,EAAE,EAAE,iBAAiB;IACtC,mBAAmB,EAAE,EAAE,EAAE,iBAAiB;CAC3C,CAAC;AAEF,MAAM,OAAO,aAAc,SAAQ,2BAA2B;IAC5D,YAAY,KAAY;QACtB,KAAK,CAAC;YACJ,GAAG,kBAAkB;YACrB,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO;SAClC,CAAC,CAAC;IACL,CAAC;IACQ,KAAK,CAAC,KAAK;QAClB,MAAM,UAAU,GAAG,IAAI,CACrB,IAAI,CAAC,MAAM,CAAC,UAAU,EACtB,4BAA4B,CAC7B,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C,OAAO,CAAS;IAChB,YAAY,KAAY;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxD,KAAK,CAAC;YACJ,GAAG,kBAAkB;YACrB,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO;YACjC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAEQ,KAAK,CAAC,KAAK;QAClB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,MAAM,IAAI,CAAC,qBAAqB,CAAC;YAC/B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC;YAC5C,iBAAiB,EAAE,KAAK;YACxB,MAAM,EAAE,KAAK;YACb,UAAU;SACX,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,iBAAiB,CAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;YACxC,mBAAmB,EAAE,IAAI;YACzB,MAAM,EAAE,KAAK;YACb,UAAU;SACX,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,mBAAmB,CAAC;YAC7B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;YAC1C,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { Nitro } from 'nitro/types';
+declare const _default: {
+    name: string;
+    setup(this: void, nitro: Nitro): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAA6B,MAAM,aAAa,CAAC;;;6BAM/C,KAAK;;AAF1B,wBA8CwB"}

package/dist/index.js

@@ -0,0 +1,52 @@
+import { posix } from 'node:path';
+import { LocalBuilder, VercelBuilder } from './builders';
+import { workflowRollupPlugin } from './rollup-plugin';
+export default {
+    name: 'workflow/nitro',
+    async setup(nitro) {
+        const isVercelDeploy = !nitro.options.dev && nitro.options.preset === 'vercel';
+        // Add transform plugin
+        nitro.hooks.hook('rollup:before', (_nitro, config) => {
+            config.plugins.push(workflowRollupPlugin());
+        });
+        // Temporary workaround for debug unenv mock
+        nitro.options.alias['debug'] ??= 'debug';
+        // Generate functions for vercel build
+        if (isVercelDeploy) {
+            nitro.hooks.hook('compiled', async () => {
+                await new VercelBuilder(nitro).build();
+            });
+        }
+        // Generate local bundles for dev and local prod
+        if (!isVercelDeploy) {
+            nitro.hooks.hook('build:before', async () => {
+                await new LocalBuilder(nitro).build();
+            });
+            addVirtualHandler(nitro, '/.well-known/workflow/v1/webhook/:token', 'workflow/webhook.mjs');
+            addVirtualHandler(nitro, '/.well-known/workflow/v1/step', 'workflow/steps.mjs');
+            addVirtualHandler(nitro, '/.well-known/workflow/v1/flow', 'workflow/workflows.mjs');
+        }
+    },
+};
+function addVirtualHandler(nitro, route, buildPath) {
+    nitro.options.handlers.push({
+        route,
+        handler: `#${buildPath}`,
+    });
+    if (!nitro.routing) {
+        // Nitro v2 (legacy)
+        nitro.options.virtual[`#${buildPath}`] = /* js */ `
+    import { fromWebHandler } from "h3";
+    import { POST } from "${posix.join(nitro.options.buildDir, buildPath)}";
+    export default fromWebHandler(POST);
+  `;
+    }
+    else {
+        // Nitro v3+ (native web handlers)
+        nitro.options.virtual[`#${buildPath}`] = /* js */ `
+    import { POST } from "${posix.join(nitro.options.buildDir, buildPath)}";
+    export default ({ req }) => POST(req);
+  `;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,eAAe;IACb,IAAI,EAAE,gBAAgB;IACtB,KAAK,CAAC,KAAK,CAAC,KAAY;QACtB,MAAM,cAAc,GAClB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC;QAE1D,uBAAuB;QACvB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,MAAa,EAAE,MAAoB,EAAE,EAAE;YACvE,MAAM,CAAC,OAA0B,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,4CAA4C;QAC5C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;QAEzC,sCAAsC;QACtC,IAAI,cAAc,EAAE,CAAC;YACnB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;gBACtC,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,gDAAgD;QAChD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;gBAC1C,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC;YAEH,iBAAiB,CACf,KAAK,EACL,yCAAyC,EACzC,sBAAsB,CACvB,CAAC;YAEF,iBAAiB,CACf,KAAK,EACL,+BAA+B,EAC/B,oBAAoB,CACrB,CAAC;YAEF,iBAAiB,CACf,KAAK,EACL,+BAA+B,EAC/B,wBAAwB,CACzB,CAAC;QACJ,CAAC;IACH,CAAC;CACoB,CAAC;AAExB,SAAS,iBAAiB,CAAC,KAAY,EAAE,KAAa,EAAE,SAAiB;IACvE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC1B,KAAK;QACL,OAAO,EAAE,IAAI,SAAS,EAAE;KACzB,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,oBAAoB;QACpB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC;;4BAE1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC;;GAEtE,CAAC;IACF,CAAC;SAAM,CAAC;QACN,kCAAkC;QAClC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC;4BAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC;;GAEtE,CAAC;IACF,CAAC;AACH,CAAC"}

package/dist/rollup-plugin.d.ts

@@ -0,0 +1,5 @@
+import type { RollupConfig } from 'nitro/types';
+type RollupPlugin = Exclude<RollupConfig['plugins'], undefined | void | null | false | Promise<unknown> | Array<unknown>>;
+export declare function workflowRollupPlugin(): RollupPlugin;
+export {};
+//# sourceMappingURL=rollup-plugin.d.ts.map

package/dist/rollup-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup-plugin.d.ts","sourceRoot":"","sources":["../src/rollup-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,KAAK,YAAY,GAAG,OAAO,CACzB,YAAY,CAAC,SAAS,CAAC,EACvB,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CACpE,CAAC;AAIF,wBAAgB,oBAAoB,IAAI,YAAY,CA0CnD"}

package/dist/rollup-plugin.js

@@ -0,0 +1,43 @@
+import { transform } from '@swc/core';
+import { resolveModulePath } from 'exsolve';
+// https://github.com/vercel/workflow/blob/feat/nitro/packages/next/src/loader.ts
+export function workflowRollupPlugin() {
+    return {
+        name: 'workflow-rollup-plugin',
+        // This transform applies the "use workflow"/"use step"
+        // client transformation
+        async transform(code, id) {
+            // only apply the transform if file needs it
+            if (!code.match(/(use step|use workflow)/)) {
+                return null;
+            }
+            const isTypeScript = id.endsWith('.ts') || id.endsWith('.tsx');
+            const isTsx = id.endsWith('.tsx');
+            const swcPlugin = resolveModulePath('@workflow/swc-plugin', {
+                from: [import.meta.url],
+            });
+            // Transform with SWC
+            const result = await transform(code, {
+                filename: id,
+                jsc: {
+                    parser: {
+                        syntax: isTypeScript ? 'typescript' : 'ecmascript',
+                        tsx: isTsx,
+                    },
+                    target: 'es2022',
+                    experimental: {
+                        plugins: [[swcPlugin, { mode: 'client' }]],
+                    },
+                },
+                minify: false,
+                sourceMaps: true,
+                inlineSourcesContent: true,
+            });
+            return {
+                code: result.code,
+                map: result.map ? JSON.parse(result.map) : null,
+            };
+        },
+    };
+}
+//# sourceMappingURL=rollup-plugin.js.map

package/dist/rollup-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup-plugin.js","sourceRoot":"","sources":["../src/rollup-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAQ5C,iFAAiF;AAEjF,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,uDAAuD;QACvD,wBAAwB;QACxB,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,EAAU;YACtC,4CAA4C;YAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;gBAC3C,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,YAAY,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/D,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAElC,MAAM,SAAS,GAAG,iBAAiB,CAAC,sBAAsB,EAAE;gBAC1D,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;aACxB,CAAC,CAAC;YAEH,qBAAqB;YACrB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE;gBACnC,QAAQ,EAAE,EAAE;gBACZ,GAAG,EAAE;oBACH,MAAM,EAAE;wBACN,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY;wBAClD,GAAG,EAAE,KAAK;qBACX;oBACD,MAAM,EAAE,QAAQ;oBAChB,YAAY,EAAE;wBACZ,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;qBAC3C;iBACF;gBACD,MAAM,EAAE,KAAK;gBACb,UAAU,EAAE,IAAI;gBAChB,oBAAoB,EAAE,IAAI;aAC3B,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;aAChD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@workflow/nitro",
+  "version": "4.0.1-beta.1",
+  "description": "Nitro integration for Workflow DevKit",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vercel/workflow.git",
+    "directory": "packages/nitro"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./rollup-plugin": "./dist/rollup-plugin.js"
+  },
+  "dependencies": {
+    "@swc/core": "1.11.24",
+    "exsolve": "^1.0.7",
+    "@workflow/swc-plugin": "4.0.1-beta.1",
+    "@workflow/cli": "4.0.1-beta.1",
+    "@workflow/core": "4.0.1-beta.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.6.2",
+    "nitro": "latest",
+    "@workflow/tsconfig": "4.0.1-beta.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "tsc --build --clean"
+  }
+}