@stepflowjs/adapter-nextjs 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+import { Stepflow } from '@stepflowjs/core';
+export { Execution, NotifyResult, TriggerResult } from '@stepflowjs/core';
+import { AuthContext, AuthConfig, EndpointOption, BaseAdapterOptions } from '@stepflowjs/adapter-shared';
+export { AuthConfig, AuthContext, AuthHandler, AuthResult, EndpointConfig, EndpointOption, EndpointPreset, RouteName, allOf, anyOf, createApiKeyAuth, createBearerAuth, isRouteEnabled, resolveEndpoints } from '@stepflowjs/adapter-shared';
+
+/** Next.js-specific request type for auth handlers */
+type NextRequest = {
+    header(name: string): string | undefined;
+    headers: Headers;
+    url: string;
+    method: string;
+    query(name: string): string | undefined;
+};
+/** Next.js-specific auth context */
+type NextAuthContext = AuthContext<NextRequest, Request>;
+/** Next.js-specific auth config */
+type NextAuthConfig = AuthConfig<NextRequest, Request>;
+interface HandlerOptions {
+    /** Custom health check function. Defaults to stepflow.healthCheck(). */
+    healthCheck?: () => Promise<boolean>;
+    /** Endpoint configuration - preset or fine-grained */
+    endpoints?: EndpointOption;
+    /** Authorization configuration */
+    auth?: NextAuthConfig;
+    /** Callback when authorization fails */
+    onAuthFailure?: BaseAdapterOptions<NextRequest, Request>["onAuthFailure"];
+}
+interface TriggerRequestBody<TPayload = unknown> {
+    payload: TPayload;
+    metadata?: Record<string, unknown>;
+    runId?: string;
+    delay?: number;
+    idempotencyKey?: string;
+}
+interface NotifyRequestBody {
+    data: unknown;
+}
+interface ErrorResponseBody {
+    error: string;
+    message?: string;
+}
+/** Next.js App Router route context with params */
+interface RouteContext<TParams = Record<string, string>> {
+    params: Promise<TParams>;
+}
+type RouteHandler<TParams = Record<string, string>> = (request: Request, context: RouteContext<TParams>) => Promise<Response>;
+interface StepflowHandlers {
+    /** Handler for POST /api/stepflow/trigger/[workflowId] */
+    triggerHandler: RouteHandler<{
+        workflowId: string;
+    }>;
+    /** Handler for GET /api/stepflow/runs/[runId] */
+    runHandler: RouteHandler<{
+        runId: string;
+    }>;
+    /** Handler for GET /api/stepflow/runs/[runId]/stream */
+    streamHandler: RouteHandler<{
+        runId: string;
+    }>;
+    /** Handler for POST /api/stepflow/notify/[eventId] */
+    notifyHandler: RouteHandler<{
+        eventId: string;
+    }>;
+    /** Handler for GET /api/stepflow/health */
+    healthHandler: RouteHandler;
+}
+
+/**
+ * Create Next.js App Router route handlers for Stepflow
+ *
+ * @example
+ * ```typescript
+ * // app/api/stepflow/trigger/[workflowId]/route.ts
+ * import { stepflow } from '@/lib/stepflow';
+ * import { createStepflowHandlers } from '@stepflowjs/adapter-nextjs';
+ *
+ * const { triggerHandler } = createStepflowHandlers(stepflow);
+ * export const POST = triggerHandler;
+ * ```
+ */
+declare function createStepflowHandlers(stepflow: Stepflow, options?: HandlerOptions): StepflowHandlers;
+
+export { type ErrorResponseBody, type HandlerOptions, type NextAuthConfig, type NextAuthContext, type NextRequest, type NotifyRequestBody, type RouteContext, type RouteHandler, type StepflowHandlers, type TriggerRequestBody, createStepflowHandlers };

package/dist/index.js

@@ -0,0 +1,280 @@
+// src/index.ts
+import {
+  isRouteEnabled,
+  runAuth,
+  getAuthFailureResponse,
+  createErrorBody
+} from "@stepflowjs/adapter-shared";
+import { NextResponse } from "next/server";
+import {
+  createApiKeyAuth,
+  createBearerAuth,
+  anyOf,
+  allOf,
+  isRouteEnabled as isRouteEnabled2,
+  resolveEndpoints
+} from "@stepflowjs/adapter-shared";
+function getAccessToken(request) {
+  const url = new URL(request.url);
+  const queryToken = url.searchParams.get("token");
+  if (queryToken) return queryToken;
+  const authHeader = request.headers.get("authorization");
+  if (!authHeader) return void 0;
+  const match = authHeader.match(/^Bearer\s+(.+)$/i);
+  return match?.[1];
+}
+function jsonResponse(data, status = 200) {
+  return new Response(JSON.stringify(data), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+function jsonError(status, error, message) {
+  const body = message ? { error, message } : { error };
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+function jsonAuthError(status, code, message) {
+  const body = createErrorBody(code, message);
+  return NextResponse.json(body, { status });
+}
+async function parseJsonBody(request) {
+  try {
+    return await request.json();
+  } catch {
+    throw new Error("Invalid JSON body");
+  }
+}
+function createNextRequest(request) {
+  const url = new URL(request.url);
+  return {
+    header: (name) => request.headers.get(name) ?? void 0,
+    headers: request.headers,
+    url: request.url,
+    method: request.method,
+    query: (name) => url.searchParams.get(name) ?? void 0
+  };
+}
+async function checkAuth(request, route, options, params = {}) {
+  const ctx = {
+    route,
+    request: createNextRequest(request),
+    extra: request,
+    ...params
+  };
+  const result = await runAuth(ctx, options.auth);
+  if (!result.ok) {
+    const { status, code, message } = getAuthFailureResponse(result);
+    await options.onAuthFailure?.(ctx, result);
+    return jsonAuthError(status, code, message);
+  }
+  return null;
+}
+function createSSEStream() {
+  let controller;
+  const encoder = new TextEncoder();
+  const stream = new ReadableStream({
+    start(ctrl) {
+      controller = ctrl;
+    }
+  });
+  return { stream, controller, encoder };
+}
+function writeSSE(controller, encoder, event, data) {
+  const message = `event: ${event}
+data: ${JSON.stringify(data)}
+
+`;
+  controller.enqueue(encoder.encode(message));
+}
+function createStepflowHandlers(stepflow, options = {}) {
+  const triggerHandler = async (request, context) => {
+    if (!isRouteEnabled("trigger", options.endpoints)) {
+      return jsonError(404, "Not found", "Endpoint disabled");
+    }
+    const { workflowId } = await context.params;
+    const authError = await checkAuth(request, "trigger", options, {
+      workflowId
+    });
+    if (authError) return authError;
+    try {
+      const body = await parseJsonBody(request);
+      const result = await stepflow.trigger(workflowId, body.payload, {
+        runId: body.runId,
+        metadata: body.metadata,
+        delay: body.delay,
+        idempotencyKey: body.idempotencyKey
+      });
+      const response = result;
+      return jsonResponse(response);
+    } catch (error) {
+      const message = error.message;
+      if (message.includes("Workflow") && message.includes("not found")) {
+        return jsonError(404, "Not found", message);
+      }
+      if (message === "Invalid JSON body") {
+        return jsonError(400, "Bad request", message);
+      }
+      return jsonError(500, "Internal server error", message);
+    }
+  };
+  const runHandler = async (request, context) => {
+    if (!isRouteEnabled("runs", options.endpoints)) {
+      return jsonError(404, "Not found", "Endpoint disabled");
+    }
+    const { runId } = await context.params;
+    const authError = await checkAuth(request, "runs", options, { runId });
+    if (authError) return authError;
+    try {
+      const accessToken = getAccessToken(request);
+      const run = await stepflow.getRun(runId, { accessToken });
+      if (!run) {
+        return jsonError(404, "Not found", `Run "${runId}" not found`);
+      }
+      const response = run;
+      return jsonResponse(response);
+    } catch (error) {
+      const message = error.message;
+      if (message === "Invalid access token") {
+        return jsonError(401, "Unauthorized", message);
+      }
+      return jsonError(500, "Internal server error", message);
+    }
+  };
+  const streamHandler = async (request, context) => {
+    if (!isRouteEnabled("runsStream", options.endpoints)) {
+      return jsonError(404, "Not found", "Endpoint disabled");
+    }
+    const { runId } = await context.params;
+    const authError = await checkAuth(request, "runsStream", options, {
+      runId
+    });
+    if (authError) return authError;
+    const accessToken = getAccessToken(request);
+    if (accessToken) {
+      try {
+        await stepflow.getRun(runId, { accessToken });
+      } catch (error) {
+        const message = error.message;
+        if (message === "Invalid access token") {
+          return jsonError(401, "Unauthorized", message);
+        }
+        return jsonError(500, "Internal server error", message);
+      }
+    }
+    const url = new URL(request.url);
+    const throttleMsParam = url.searchParams.get("throttle");
+    const throttleMs = throttleMsParam ? Number(throttleMsParam) : void 0;
+    const effectiveThrottleMs = throttleMs !== void 0 && Number.isFinite(throttleMs) && throttleMs >= 0 ? throttleMs : void 0;
+    const { stream, controller, encoder } = createSSEStream();
+    let lastSentAt = 0;
+    const send = (event, data) => {
+      if (effectiveThrottleMs !== void 0) {
+        const now = Date.now();
+        if (now - lastSentAt < effectiveThrottleMs) {
+          return;
+        }
+        lastSentAt = now;
+      }
+      writeSSE(controller, encoder, event, data);
+    };
+    void (async () => {
+      try {
+        let run = await stepflow.getRun(runId);
+        while (!run) {
+          await new Promise((resolve) => setTimeout(resolve, 250));
+          run = await stepflow.getRun(runId);
+        }
+        const executionId = run.id;
+        send("update", run);
+        if (run.status === "completed") {
+          send("execution:complete", { result: run.result });
+        }
+        if (run.status === "failed") {
+          send("execution:failed", { error: run.error });
+        }
+        const unsubscribe = stepflow.subscribeToExecution(executionId, () => {
+          void (async () => {
+            const execution = await stepflow.getExecution(executionId);
+            if (execution) {
+              send("update", execution);
+              if (execution.status === "completed") {
+                send("execution:complete", { result: execution.result });
+              }
+              if (execution.status === "failed") {
+                send("execution:failed", { error: execution.error });
+              }
+            }
+          })();
+        });
+        await new Promise((resolve) => setTimeout(resolve, 60 * 60 * 1e3));
+        unsubscribe();
+      } catch {
+      } finally {
+        try {
+          controller.close();
+        } catch {
+        }
+      }
+    })();
+    return new Response(stream, {
+      headers: {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        Connection: "keep-alive"
+      }
+    });
+  };
+  const notifyHandler = async (request, context) => {
+    if (!isRouteEnabled("notify", options.endpoints)) {
+      return jsonError(404, "Not found", "Endpoint disabled");
+    }
+    const { eventId } = await context.params;
+    const authError = await checkAuth(request, "notify", options, { eventId });
+    if (authError) return authError;
+    try {
+      const body = await parseJsonBody(request);
+      const result = await stepflow.notify(eventId, body.data);
+      const response = result;
+      return jsonResponse(response);
+    } catch (error) {
+      const message = error.message;
+      if (message === "Invalid JSON body") {
+        return jsonError(400, "Bad request", message);
+      }
+      return jsonError(500, "Internal server error", message);
+    }
+  };
+  const healthHandler = async (request) => {
+    if (!isRouteEnabled("health", options.endpoints)) {
+      return jsonError(404, "Not found", "Endpoint disabled");
+    }
+    const authError = await checkAuth(request, "health", options);
+    if (authError) return authError;
+    try {
+      const ok = await (options.healthCheck?.() ?? stepflow.healthCheck());
+      return jsonResponse({ ok });
+    } catch (error) {
+      return jsonError(500, "Internal server error", error.message);
+    }
+  };
+  return {
+    triggerHandler,
+    runHandler,
+    streamHandler,
+    notifyHandler,
+    healthHandler
+  };
+}
+export {
+  allOf,
+  anyOf,
+  createApiKeyAuth,
+  createBearerAuth,
+  createStepflowHandlers,
+  isRouteEnabled2 as isRouteEnabled,
+  resolveEndpoints
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { Execution, TriggerResult, NotifyResult } from \"@stepflowjs/core\";\nimport type { Stepflow } from \"@stepflowjs/core\";\nimport {\n  type AuthConfig,\n  type AuthContext,\n  type BaseAdapterOptions,\n  type EndpointOption,\n  type RouteName,\n  isRouteEnabled,\n  runAuth,\n  getAuthFailureResponse,\n  createErrorBody,\n} from \"@stepflowjs/adapter-shared\";\nimport { NextResponse } from \"next/server\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** Next.js-specific request type for auth handlers */\nexport type NextRequest = {\n  header(name: string): string | undefined;\n  headers: Headers;\n  url: string;\n  method: string;\n  query(name: string): string | undefined;\n};\n\n/** Next.js-specific auth context */\nexport type NextAuthContext = AuthContext<NextRequest, Request>;\n\n/** Next.js-specific auth config */\nexport type NextAuthConfig = AuthConfig<NextRequest, Request>;\n\nexport interface HandlerOptions {\n  /** Custom health check function. Defaults to stepflow.healthCheck(). */\n  healthCheck?: () => Promise<boolean>;\n  /** Endpoint configuration - preset or fine-grained */\n  endpoints?: EndpointOption;\n  /** Authorization configuration */\n  auth?: NextAuthConfig;\n  /** Callback when authorization fails */\n  onAuthFailure?: BaseAdapterOptions<NextRequest, Request>[\"onAuthFailure\"];\n}\n\nexport interface TriggerRequestBody<TPayload = unknown> {\n  payload: TPayload;\n  metadata?: Record<string, unknown>;\n  runId?: string;\n  delay?: number;\n  idempotencyKey?: string;\n}\n\nexport interface NotifyRequestBody {\n  data: unknown;\n}\n\nexport interface ErrorResponseBody {\n  error: string;\n  message?: string;\n}\n\n/** Next.js App Router route context with params */\nexport interface RouteContext<TParams = Record<string, string>> {\n  params: Promise<TParams>;\n}\n\nexport type RouteHandler<TParams = Record<string, string>> = (\n  request: Request,\n  context: RouteContext<TParams>,\n) => Promise<Response>;\n\nexport interface StepflowHandlers {\n  /** Handler for POST /api/stepflow/trigger/[workflowId] */\n  triggerHandler: RouteHandler<{ workflowId: string }>;\n  /** Handler for GET /api/stepflow/runs/[runId] */\n  runHandler: RouteHandler<{ runId: string }>;\n  /** Handler for GET /api/stepflow/runs/[runId]/stream */\n  streamHandler: RouteHandler<{ runId: string }>;\n  /** Handler for POST /api/stepflow/notify/[eventId] */\n  notifyHandler: RouteHandler<{ eventId: string }>;\n  /** Handler for GET /api/stepflow/health */\n  healthHandler: RouteHandler;\n}\n\n// ============================================================================\n// Re-exports from shared\n// ============================================================================\n\nexport {\n  type AuthContext,\n  type AuthResult,\n  type AuthHandler,\n  type AuthConfig,\n  type EndpointConfig,\n  type EndpointOption,\n  type EndpointPreset,\n  type RouteName,\n  createApiKeyAuth,\n  createBearerAuth,\n  anyOf,\n  allOf,\n  isRouteEnabled,\n  resolveEndpoints,\n} from \"@stepflowjs/adapter-shared\";\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction getAccessToken(request: Request): string | undefined {\n  const url = new URL(request.url);\n  const queryToken = url.searchParams.get(\"token\");\n  if (queryToken) return queryToken;\n\n  const authHeader = request.headers.get(\"authorization\");\n  if (!authHeader) return undefined;\n\n  const match = authHeader.match(/^Bearer\\s+(.+)$/i);\n  return match?.[1];\n}\n\nfunction jsonResponse<T>(data: T, status = 200): Response {\n  return new Response(JSON.stringify(data), {\n    status,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n}\n\nfunction jsonError(status: number, error: string, message?: string): Response {\n  const body: ErrorResponseBody = message ? { error, message } : { error };\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n}\n\nfunction jsonAuthError(\n  status: number,\n  code: string,\n  message: string,\n): Response {\n  const body = createErrorBody(code, message);\n  return NextResponse.json(body, { status });\n}\n\nasync function parseJsonBody<T>(request: Request): Promise<T> {\n  try {\n    return (await request.json()) as T;\n  } catch {\n    throw new Error(\"Invalid JSON body\");\n  }\n}\n\n/**\n * Creates a NextRequest object from Request for auth handlers\n */\nfunction createNextRequest(request: Request): NextRequest {\n  const url = new URL(request.url);\n  return {\n    header: (name: string) => request.headers.get(name) ?? undefined,\n    headers: request.headers,\n    url: request.url,\n    method: request.method,\n    query: (name: string) => url.searchParams.get(name) ?? undefined,\n  };\n}\n\n/**\n * Runs authorization check and returns error response if denied\n */\nasync function checkAuth(\n  request: Request,\n  route: RouteName,\n  options: HandlerOptions,\n  params: { workflowId?: string; eventId?: string; runId?: string } = {},\n): Promise<Response | null> {\n  const ctx: NextAuthContext = {\n    route,\n    request: createNextRequest(request),\n    extra: request,\n    ...params,\n  };\n\n  const result = await runAuth(ctx, options.auth);\n\n  if (!result.ok) {\n    const { status, code, message } = getAuthFailureResponse(result);\n    await options.onAuthFailure?.(ctx, result);\n    return jsonAuthError(status, code, message);\n  }\n\n  return null;\n}\n\n// ============================================================================\n// SSE Helpers\n// ============================================================================\n\nfunction createSSEStream(): {\n  stream: ReadableStream<Uint8Array>;\n  controller: ReadableStreamDefaultController<Uint8Array>;\n  encoder: TextEncoder;\n} {\n  let controller: ReadableStreamDefaultController<Uint8Array>;\n  const encoder = new TextEncoder();\n\n  const stream = new ReadableStream<Uint8Array>({\n    start(ctrl) {\n      controller = ctrl;\n    },\n  });\n\n  return { stream, controller: controller!, encoder };\n}\n\nfunction writeSSE(\n  controller: ReadableStreamDefaultController<Uint8Array>,\n  encoder: TextEncoder,\n  event: string,\n  data: unknown,\n): void {\n  const message = `event: ${event}\\ndata: ${JSON.stringify(data)}\\n\\n`;\n  controller.enqueue(encoder.encode(message));\n}\n\n// ============================================================================\n// Handler Factory\n// ============================================================================\n\n/**\n * Create Next.js App Router route handlers for Stepflow\n *\n * @example\n * ```typescript\n * // app/api/stepflow/trigger/[workflowId]/route.ts\n * import { stepflow } from '@/lib/stepflow';\n * import { createStepflowHandlers } from '@stepflowjs/adapter-nextjs';\n *\n * const { triggerHandler } = createStepflowHandlers(stepflow);\n * export const POST = triggerHandler;\n * ```\n */\nexport function createStepflowHandlers(\n  stepflow: Stepflow,\n  options: HandlerOptions = {},\n): StepflowHandlers {\n  // -------------------------------------------------------------------------\n  // Trigger Handler - POST /api/stepflow/trigger/[workflowId]\n  // -------------------------------------------------------------------------\n  const triggerHandler: RouteHandler<{ workflowId: string }> = async (\n    request,\n    context,\n  ) => {\n    if (!isRouteEnabled(\"trigger\", options.endpoints)) {\n      return jsonError(404, \"Not found\", \"Endpoint disabled\");\n    }\n\n    const { workflowId } = await context.params;\n\n    const authError = await checkAuth(request, \"trigger\", options, {\n      workflowId,\n    });\n    if (authError) return authError;\n\n    try {\n      const body = await parseJsonBody<TriggerRequestBody>(request);\n      const result = await stepflow.trigger(workflowId, body.payload, {\n        runId: body.runId,\n        metadata: body.metadata,\n        delay: body.delay,\n        idempotencyKey: body.idempotencyKey,\n      });\n\n      const response: TriggerResult = result;\n      return jsonResponse(response);\n    } catch (error) {\n      const message = (error as Error).message;\n      if (message.includes(\"Workflow\") && message.includes(\"not found\")) {\n        return jsonError(404, \"Not found\", message);\n      }\n      if (message === \"Invalid JSON body\") {\n        return jsonError(400, \"Bad request\", message);\n      }\n      return jsonError(500, \"Internal server error\", message);\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Run Handler - GET /api/stepflow/runs/[runId]\n  // -------------------------------------------------------------------------\n  const runHandler: RouteHandler<{ runId: string }> = async (\n    request,\n    context,\n  ) => {\n    if (!isRouteEnabled(\"runs\", options.endpoints)) {\n      return jsonError(404, \"Not found\", \"Endpoint disabled\");\n    }\n\n    const { runId } = await context.params;\n\n    const authError = await checkAuth(request, \"runs\", options, { runId });\n    if (authError) return authError;\n\n    try {\n      const accessToken = getAccessToken(request);\n      const run = await stepflow.getRun(runId, { accessToken });\n\n      if (!run) {\n        return jsonError(404, \"Not found\", `Run \"${runId}\" not found`);\n      }\n\n      const response: Execution = run;\n      return jsonResponse(response);\n    } catch (error) {\n      const message = (error as Error).message;\n      if (message === \"Invalid access token\") {\n        return jsonError(401, \"Unauthorized\", message);\n      }\n      return jsonError(500, \"Internal server error\", message);\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Stream Handler - GET /api/stepflow/runs/[runId]/stream\n  // -------------------------------------------------------------------------\n  const streamHandler: RouteHandler<{ runId: string }> = async (\n    request,\n    context,\n  ) => {\n    if (!isRouteEnabled(\"runsStream\", options.endpoints)) {\n      return jsonError(404, \"Not found\", \"Endpoint disabled\");\n    }\n\n    const { runId } = await context.params;\n\n    const authError = await checkAuth(request, \"runsStream\", options, {\n      runId,\n    });\n    if (authError) return authError;\n\n    // Validate access token if provided\n    const accessToken = getAccessToken(request);\n    if (accessToken) {\n      try {\n        await stepflow.getRun(runId, { accessToken });\n      } catch (error) {\n        const message = (error as Error).message;\n        if (message === \"Invalid access token\") {\n          return jsonError(401, \"Unauthorized\", message);\n        }\n        return jsonError(500, \"Internal server error\", message);\n      }\n    }\n\n    // Parse throttle parameter\n    const url = new URL(request.url);\n    const throttleMsParam = url.searchParams.get(\"throttle\");\n    const throttleMs = throttleMsParam ? Number(throttleMsParam) : undefined;\n    const effectiveThrottleMs =\n      throttleMs !== undefined && Number.isFinite(throttleMs) && throttleMs >= 0\n        ? throttleMs\n        : undefined;\n\n    const { stream, controller, encoder } = createSSEStream();\n    let lastSentAt = 0;\n\n    const send = (event: string, data: unknown) => {\n      if (effectiveThrottleMs !== undefined) {\n        const now = Date.now();\n        if (now - lastSentAt < effectiveThrottleMs) {\n          return;\n        }\n        lastSentAt = now;\n      }\n      writeSSE(controller, encoder, event, data);\n    };\n\n    // Start async processing\n    void (async () => {\n      try {\n        // Get initial run state\n        let run = await stepflow.getRun(runId);\n\n        // Poll until run exists\n        while (!run) {\n          await new Promise((resolve) => setTimeout(resolve, 250));\n          run = await stepflow.getRun(runId);\n        }\n\n        const executionId = run.id;\n        send(\"update\", run);\n\n        if (run.status === \"completed\") {\n          send(\"execution:complete\", { result: run.result });\n        }\n        if (run.status === \"failed\") {\n          send(\"execution:failed\", { error: run.error });\n        }\n\n        // Subscribe to updates\n        const unsubscribe = stepflow.subscribeToExecution(executionId, () => {\n          void (async () => {\n            const execution = await stepflow.getExecution(executionId);\n            if (execution) {\n              send(\"update\", execution);\n\n              if (execution.status === \"completed\") {\n                send(\"execution:complete\", { result: execution.result });\n              }\n              if (execution.status === \"failed\") {\n                send(\"execution:failed\", { error: execution.error });\n              }\n            }\n          })();\n        });\n\n        // Keep connection open (Next.js will close on client disconnect)\n        await new Promise((resolve) => setTimeout(resolve, 60 * 60 * 1000));\n        unsubscribe();\n      } catch {\n        // Stream closed\n      } finally {\n        try {\n          controller.close();\n        } catch {\n          // Already closed\n        }\n      }\n    })();\n\n    return new Response(stream, {\n      headers: {\n        \"Content-Type\": \"text/event-stream\",\n        \"Cache-Control\": \"no-cache\",\n        Connection: \"keep-alive\",\n      },\n    });\n  };\n\n  // -------------------------------------------------------------------------\n  // Notify Handler - POST /api/stepflow/notify/[eventId]\n  // -------------------------------------------------------------------------\n  const notifyHandler: RouteHandler<{ eventId: string }> = async (\n    request,\n    context,\n  ) => {\n    if (!isRouteEnabled(\"notify\", options.endpoints)) {\n      return jsonError(404, \"Not found\", \"Endpoint disabled\");\n    }\n\n    const { eventId } = await context.params;\n\n    const authError = await checkAuth(request, \"notify\", options, { eventId });\n    if (authError) return authError;\n\n    try {\n      const body = await parseJsonBody<NotifyRequestBody>(request);\n      const result = await stepflow.notify(eventId, body.data);\n      const response: NotifyResult = result;\n      return jsonResponse(response);\n    } catch (error) {\n      const message = (error as Error).message;\n      if (message === \"Invalid JSON body\") {\n        return jsonError(400, \"Bad request\", message);\n      }\n      return jsonError(500, \"Internal server error\", message);\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Health Handler - GET /api/stepflow/health\n  // -------------------------------------------------------------------------\n  const healthHandler: RouteHandler = async (request) => {\n    if (!isRouteEnabled(\"health\", options.endpoints)) {\n      return jsonError(404, \"Not found\", \"Endpoint disabled\");\n    }\n\n    const authError = await checkAuth(request, \"health\", options);\n    if (authError) return authError;\n\n    try {\n      const ok = await (options.healthCheck?.() ?? stepflow.healthCheck());\n      return jsonResponse({ ok });\n    } catch (error) {\n      return jsonError(500, \"Internal server error\", (error as Error).message);\n    }\n  };\n\n  return {\n    triggerHandler,\n    runHandler,\n    streamHandler,\n    notifyHandler,\n    healthHandler,\n  };\n}\n\n// Re-export types\nexport type { Execution, TriggerResult, NotifyResult } from \"@stepflowjs/core\";\n"],"mappings":";AAEA;AAAA,EAME;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,oBAAoB;AA4E7B;AAAA,EASE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAAA;AAAA,EACA;AAAA,OACK;AAMP,SAAS,eAAe,SAAsC;AAC5D,QAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,QAAM,aAAa,IAAI,aAAa,IAAI,OAAO;AAC/C,MAAI,WAAY,QAAO;AAEvB,QAAM,aAAa,QAAQ,QAAQ,IAAI,eAAe;AACtD,MAAI,CAAC,WAAY,QAAO;AAExB,QAAM,QAAQ,WAAW,MAAM,kBAAkB;AACjD,SAAO,QAAQ,CAAC;AAClB;AAEA,SAAS,aAAgB,MAAS,SAAS,KAAe;AACxD,SAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;AAAA,IACxC;AAAA,IACA,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,EAChD,CAAC;AACH;AAEA,SAAS,UAAU,QAAgB,OAAe,SAA4B;AAC5E,QAAM,OAA0B,UAAU,EAAE,OAAO,QAAQ,IAAI,EAAE,MAAM;AACvE,SAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;AAAA,IACxC;AAAA,IACA,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,EAChD,CAAC;AACH;AAEA,SAAS,cACP,QACA,MACA,SACU;AACV,QAAM,OAAO,gBAAgB,MAAM,OAAO;AAC1C,SAAO,aAAa,KAAK,MAAM,EAAE,OAAO,CAAC;AAC3C;AAEA,eAAe,cAAiB,SAA8B;AAC5D,MAAI;AACF,WAAQ,MAAM,QAAQ,KAAK;AAAA,EAC7B,QAAQ;AACN,UAAM,IAAI,MAAM,mBAAmB;AAAA,EACrC;AACF;AAKA,SAAS,kBAAkB,SAA+B;AACxD,QAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,SAAO;AAAA,IACL,QAAQ,CAAC,SAAiB,QAAQ,QAAQ,IAAI,IAAI,KAAK;AAAA,IACvD,SAAS,QAAQ;AAAA,IACjB,KAAK,QAAQ;AAAA,IACb,QAAQ,QAAQ;AAAA,IAChB,OAAO,CAAC,SAAiB,IAAI,aAAa,IAAI,IAAI,KAAK;AAAA,EACzD;AACF;AAKA,eAAe,UACb,SACA,OACA,SACA,SAAoE,CAAC,GAC3C;AAC1B,QAAM,MAAuB;AAAA,IAC3B;AAAA,IACA,SAAS,kBAAkB,OAAO;AAAA,IAClC,OAAO;AAAA,IACP,GAAG;AAAA,EACL;AAEA,QAAM,SAAS,MAAM,QAAQ,KAAK,QAAQ,IAAI;AAE9C,MAAI,CAAC,OAAO,IAAI;AACd,UAAM,EAAE,QAAQ,MAAM,QAAQ,IAAI,uBAAuB,MAAM;AAC/D,UAAM,QAAQ,gBAAgB,KAAK,MAAM;AACzC,WAAO,cAAc,QAAQ,MAAM,OAAO;AAAA,EAC5C;AAEA,SAAO;AACT;AAMA,SAAS,kBAIP;AACA,MAAI;AACJ,QAAM,UAAU,IAAI,YAAY;AAEhC,QAAM,SAAS,IAAI,eAA2B;AAAA,IAC5C,MAAM,MAAM;AACV,mBAAa;AAAA,IACf;AAAA,EACF,CAAC;AAED,SAAO,EAAE,QAAQ,YAAyB,QAAQ;AACpD;AAEA,SAAS,SACP,YACA,SACA,OACA,MACM;AACN,QAAM,UAAU,UAAU,KAAK;AAAA,QAAW,KAAK,UAAU,IAAI,CAAC;AAAA;AAAA;AAC9D,aAAW,QAAQ,QAAQ,OAAO,OAAO,CAAC;AAC5C;AAmBO,SAAS,uBACd,UACA,UAA0B,CAAC,GACT;AAIlB,QAAM,iBAAuD,OAC3D,SACA,YACG;AACH,QAAI,CAAC,eAAe,WAAW,QAAQ,SAAS,GAAG;AACjD,aAAO,UAAU,KAAK,aAAa,mBAAmB;AAAA,IACxD;AAEA,UAAM,EAAE,WAAW,IAAI,MAAM,QAAQ;AAErC,UAAM,YAAY,MAAM,UAAU,SAAS,WAAW,SAAS;AAAA,MAC7D;AAAA,IACF,CAAC;AACD,QAAI,UAAW,QAAO;AAEtB,QAAI;AACF,YAAM,OAAO,MAAM,cAAkC,OAAO;AAC5D,YAAM,SAAS,MAAM,SAAS,QAAQ,YAAY,KAAK,SAAS;AAAA,QAC9D,OAAO,KAAK;AAAA,QACZ,UAAU,KAAK;AAAA,QACf,OAAO,KAAK;AAAA,QACZ,gBAAgB,KAAK;AAAA,MACvB,CAAC;AAED,YAAM,WAA0B;AAChC,aAAO,aAAa,QAAQ;AAAA,IAC9B,SAAS,OAAO;AACd,YAAM,UAAW,MAAgB;AACjC,UAAI,QAAQ,SAAS,UAAU,KAAK,QAAQ,SAAS,WAAW,GAAG;AACjE,eAAO,UAAU,KAAK,aAAa,OAAO;AAAA,MAC5C;AACA,UAAI,YAAY,qBAAqB;AACnC,eAAO,UAAU,KAAK,eAAe,OAAO;AAAA,MAC9C;AACA,aAAO,UAAU,KAAK,yBAAyB,OAAO;AAAA,IACxD;AAAA,EACF;AAKA,QAAM,aAA8C,OAClD,SACA,YACG;AACH,QAAI,CAAC,eAAe,QAAQ,QAAQ,SAAS,GAAG;AAC9C,aAAO,UAAU,KAAK,aAAa,mBAAmB;AAAA,IACxD;AAEA,UAAM,EAAE,MAAM,IAAI,MAAM,QAAQ;AAEhC,UAAM,YAAY,MAAM,UAAU,SAAS,QAAQ,SAAS,EAAE,MAAM,CAAC;AACrE,QAAI,UAAW,QAAO;AAEtB,QAAI;AACF,YAAM,cAAc,eAAe,OAAO;AAC1C,YAAM,MAAM,MAAM,SAAS,OAAO,OAAO,EAAE,YAAY,CAAC;AAExD,UAAI,CAAC,KAAK;AACR,eAAO,UAAU,KAAK,aAAa,QAAQ,KAAK,aAAa;AAAA,MAC/D;AAEA,YAAM,WAAsB;AAC5B,aAAO,aAAa,QAAQ;AAAA,IAC9B,SAAS,OAAO;AACd,YAAM,UAAW,MAAgB;AACjC,UAAI,YAAY,wBAAwB;AACtC,eAAO,UAAU,KAAK,gBAAgB,OAAO;AAAA,MAC/C;AACA,aAAO,UAAU,KAAK,yBAAyB,OAAO;AAAA,IACxD;AAAA,EACF;AAKA,QAAM,gBAAiD,OACrD,SACA,YACG;AACH,QAAI,CAAC,eAAe,cAAc,QAAQ,SAAS,GAAG;AACpD,aAAO,UAAU,KAAK,aAAa,mBAAmB;AAAA,IACxD;AAEA,UAAM,EAAE,MAAM,IAAI,MAAM,QAAQ;AAEhC,UAAM,YAAY,MAAM,UAAU,SAAS,cAAc,SAAS;AAAA,MAChE;AAAA,IACF,CAAC;AACD,QAAI,UAAW,QAAO;AAGtB,UAAM,cAAc,eAAe,OAAO;AAC1C,QAAI,aAAa;AACf,UAAI;AACF,cAAM,SAAS,OAAO,OAAO,EAAE,YAAY,CAAC;AAAA,MAC9C,SAAS,OAAO;AACd,cAAM,UAAW,MAAgB;AACjC,YAAI,YAAY,wBAAwB;AACtC,iBAAO,UAAU,KAAK,gBAAgB,OAAO;AAAA,QAC/C;AACA,eAAO,UAAU,KAAK,yBAAyB,OAAO;AAAA,MACxD;AAAA,IACF;AAGA,UAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,UAAM,kBAAkB,IAAI,aAAa,IAAI,UAAU;AACvD,UAAM,aAAa,kBAAkB,OAAO,eAAe,IAAI;AAC/D,UAAM,sBACJ,eAAe,UAAa,OAAO,SAAS,UAAU,KAAK,cAAc,IACrE,aACA;AAEN,UAAM,EAAE,QAAQ,YAAY,QAAQ,IAAI,gBAAgB;AACxD,QAAI,aAAa;AAEjB,UAAM,OAAO,CAAC,OAAe,SAAkB;AAC7C,UAAI,wBAAwB,QAAW;AACrC,cAAM,MAAM,KAAK,IAAI;AACrB,YAAI,MAAM,aAAa,qBAAqB;AAC1C;AAAA,QACF;AACA,qBAAa;AAAA,MACf;AACA,eAAS,YAAY,SAAS,OAAO,IAAI;AAAA,IAC3C;AAGA,UAAM,YAAY;AAChB,UAAI;AAEF,YAAI,MAAM,MAAM,SAAS,OAAO,KAAK;AAGrC,eAAO,CAAC,KAAK;AACX,gBAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,GAAG,CAAC;AACvD,gBAAM,MAAM,SAAS,OAAO,KAAK;AAAA,QACnC;AAEA,cAAM,cAAc,IAAI;AACxB,aAAK,UAAU,GAAG;AAElB,YAAI,IAAI,WAAW,aAAa;AAC9B,eAAK,sBAAsB,EAAE,QAAQ,IAAI,OAAO,CAAC;AAAA,QACnD;AACA,YAAI,IAAI,WAAW,UAAU;AAC3B,eAAK,oBAAoB,EAAE,OAAO,IAAI,MAAM,CAAC;AAAA,QAC/C;AAGA,cAAM,cAAc,SAAS,qBAAqB,aAAa,MAAM;AACnE,gBAAM,YAAY;AAChB,kBAAM,YAAY,MAAM,SAAS,aAAa,WAAW;AACzD,gBAAI,WAAW;AACb,mBAAK,UAAU,SAAS;AAExB,kBAAI,UAAU,WAAW,aAAa;AACpC,qBAAK,sBAAsB,EAAE,QAAQ,UAAU,OAAO,CAAC;AAAA,cACzD;AACA,kBAAI,UAAU,WAAW,UAAU;AACjC,qBAAK,oBAAoB,EAAE,OAAO,UAAU,MAAM,CAAC;AAAA,cACrD;AAAA,YACF;AAAA,UACF,GAAG;AAAA,QACL,CAAC;AAGD,cAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,KAAK,KAAK,GAAI,CAAC;AAClE,oBAAY;AAAA,MACd,QAAQ;AAAA,MAER,UAAE;AACA,YAAI;AACF,qBAAW,MAAM;AAAA,QACnB,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF,GAAG;AAEH,WAAO,IAAI,SAAS,QAAQ;AAAA,MAC1B,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,iBAAiB;AAAA,QACjB,YAAY;AAAA,MACd;AAAA,IACF,CAAC;AAAA,EACH;AAKA,QAAM,gBAAmD,OACvD,SACA,YACG;AACH,QAAI,CAAC,eAAe,UAAU,QAAQ,SAAS,GAAG;AAChD,aAAO,UAAU,KAAK,aAAa,mBAAmB;AAAA,IACxD;AAEA,UAAM,EAAE,QAAQ,IAAI,MAAM,QAAQ;AAElC,UAAM,YAAY,MAAM,UAAU,SAAS,UAAU,SAAS,EAAE,QAAQ,CAAC;AACzE,QAAI,UAAW,QAAO;AAEtB,QAAI;AACF,YAAM,OAAO,MAAM,cAAiC,OAAO;AAC3D,YAAM,SAAS,MAAM,SAAS,OAAO,SAAS,KAAK,IAAI;AACvD,YAAM,WAAyB;AAC/B,aAAO,aAAa,QAAQ;AAAA,IAC9B,SAAS,OAAO;AACd,YAAM,UAAW,MAAgB;AACjC,UAAI,YAAY,qBAAqB;AACnC,eAAO,UAAU,KAAK,eAAe,OAAO;AAAA,MAC9C;AACA,aAAO,UAAU,KAAK,yBAAyB,OAAO;AAAA,IACxD;AAAA,EACF;AAKA,QAAM,gBAA8B,OAAO,YAAY;AACrD,QAAI,CAAC,eAAe,UAAU,QAAQ,SAAS,GAAG;AAChD,aAAO,UAAU,KAAK,aAAa,mBAAmB;AAAA,IACxD;AAEA,UAAM,YAAY,MAAM,UAAU,SAAS,UAAU,OAAO;AAC5D,QAAI,UAAW,QAAO;AAEtB,QAAI;AACF,YAAM,KAAK,OAAO,QAAQ,cAAc,KAAK,SAAS,YAAY;AAClE,aAAO,aAAa,EAAE,GAAG,CAAC;AAAA,IAC5B,SAAS,OAAO;AACd,aAAO,UAAU,KAAK,yBAA0B,MAAgB,OAAO;AAAA,IACzE;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":["isRouteEnabled"]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@stepflowjs/adapter-nextjs",
+  "version": "0.0.1",
+  "description": "Next.js App Router adapter for Stepflow workflows",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@stepflowjs/adapter-shared": "0.0.1",
+    "@stepflowjs/core": "0.0.1"
+  },
+  "devDependencies": {
+    "next": "^15.3.3",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.5.1",
+    "vitest": "^4.0.17"
+  },
+  "peerDependencies": {
+    "next": "^14.0.0 || ^15.0.0",
+    "typescript": "^5.0.0"
+  },
+  "license": "MIT",
+  "author": "Stepflow Contributors",
+  "repository": {
+    "type": "git",
+    "url": "https://stepflow-production.up.railway.app",
+    "directory": "packages/adapters/nextjs"
+  },
+  "homepage": "https://stepflow-production.up.railway.app",
+  "bugs": {
+    "url": "https://stepflow-production.up.railway.app"
+  },
+  "keywords": [
+    "stepflow",
+    "adapter",
+    "nextjs",
+    "next.js",
+    "framework",
+    "workflow",
+    "orchestration"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "clean": "rm -rf dist"
+  }
+}