docs: migrate to latest nitro v3

Signed-off-by:  Pooya Parsa <pooya@pi0.io>

Author: pi0

docs/content/docs/getting-started/nitro.mdx

@@ -4,7 +4,7 @@ title: Nitro
 
 # Nitro
 
-This guide will walk through setting up your first workflow in a Nitro app. Along the way, you'll learn more about the concepts that are fundamental to using the development kit in your own projects.
+This guide will walk through setting up your first workflow in a [Nitro v3](https://v3.nitro.build/) project. Along the way, you'll learn more about the concepts that are fundamental to using the development kit in your own projects.
 
 ---
 
@@ -16,7 +16,7 @@ This guide will walk through setting up your first workflow in a Nitro app. Alon
 Start by creating a new Nitro project. This command will create a new directory named `nitro-app` and setup a Nitro project inside it.
 
 ```bash
-npx giget@latest nitro nitro-app --install
+npx create-nitro-app
 ```
 
 Enter the newly made directory:
@@ -44,16 +44,16 @@ cd nitro-app
 
 ### Configure Nitro
 
-Add `workflow/nitro` to your `nitro.config.ts` This enables usage of the `"use workflow"` and `"use step"` directives.
+Add `workflow/nitro` module to your `nitro.config.ts` This enables usage of the `"use workflow"` and `"use step"` directives.
 
 ```typescript title="nitro.config.ts" lineNumbers
-import { defineNitroConfig } from "nitropack/config";
+import { defineConfig } from "nitro";
 
-export default defineNitroConfig({
-  compatibilityDate: "latest",
-  srcDir: "server",
+export default defineConfig({
+  serverDir: "./server",
   modules: ["workflow/nitro"],
 });
+
 ```
 
 <Accordion type="single" collapsible>
@@ -173,18 +173,16 @@ To invoke your new workflow, we'll create a new API route handler at `server/api
 
 ```typescript title="server/api/signup.post.ts"
 import { start } from 'workflow/api';
-import { defineEventHandler, readBody } from 'h3';
+import { defineEventHandler } from 'nitro/h3';
 import { handleUserSignup } from "../../workflows/user-signup";
 
-export default defineEventHandler(async (event) => {
-  const { email } = await readBody(event);
-
+export default defineEventHandler(async ({ req }) => {
+  const { email } = await req.json() as { email: string };
   // Executes asynchronously and doesn't block your app
   await start(handleUserSignup, [email]);
-
-  return Response.json({
+  return {
     message: "User signup workflow started",
-  });
+  }
 });
 ```
 

packages/nitro/src/vite.ts

@@ -1,16 +1,16 @@
+import type {} from 'nitro/vite'
 import type { Nitro } from 'nitro/types';
 import type { Plugin } from 'vite';
 import type { ModuleOptions } from './index.js';
 import nitroModule from './index.js';
 import { workflowRollupPlugin } from './rollup.js';
 
+
 export function workflow(options?: ModuleOptions): Plugin[] {
   return [
     workflowRollupPlugin(),
     {
       name: 'workflow:nitro',
-      // Requires https://github.com/nitrojs/nitro/discussions/3680
-      // @ts-expect-error
       nitro: {
         setup: (nitro: Nitro) => {
           nitro.options.workflow = {

pnpm-lock.yaml

@@ -10,7 +10,7 @@ catalog:
   '@vercel/functions': ^3.1.4
   '@vercel/oidc': ^3.0.3
   '@vitest/coverage-v8': ^3.2.4
-  "nitro": "npm:nitro-nightly@3.0.1-20251031-202656-883af4f9"
+  "nitro": "^3.0.1-alpha.1"
   ai: 5.0.76
   esbuild: ^0.25.11
   typescript: ^5.9.3

pnpm-workspace.yaml

@@ -1,5 +1,12 @@
 import { defineNitroConfig } from 'nitro/config';
 
 export default defineNitroConfig({
-  modules: ['workflow/nitro'],
+  serverDir: './',
+  modules: [
+    'workflow/nitro'
+  ],
+  // Workaround for monorepo symlinked packages
+  externals: {
+    external: [id => id.includes('.nitro/workflow')]
+  },
 });

workbench/nitro-v3/nitro.config.ts

@@ -14,6 +14,7 @@
     "lodash.chunk": "^4.2.0",
     "nitro": "catalog:",
     "openai": "^6.1.0",
+    "rollup": "^4.53.2",
     "workflow": "workspace:*",
     "zod": "catalog:"
   },

workbench/nitro-v3/package.json

@@ -4,4 +4,7 @@ import { workflow } from 'workflow/vite';
 
 export default defineConfig({
   plugins: [nitro(), workflow()],
+  nitro: {
+    serverDir: "./",
+  }
 });