@stepflowjs/adapter-nitric 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+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';
+
+/** Nitric-specific request type for auth handlers */
+type NitricRequest = {
+    header(name: string): string | undefined;
+    headers: Record<string, string>;
+    url: string;
+    method: string;
+    query: Record<string, string>;
+};
+/** Nitric-specific auth context */
+type NitricAuthContext = AuthContext<NitricRequest, NitricHttpContext>;
+/** Nitric-specific auth config */
+type NitricAuthConfig = AuthConfig<NitricRequest, NitricHttpContext>;
+interface HandlerOptions {
+    /** Base path prefix for all routes (e.g., "/api/stepflow"). */
+    basePath?: string;
+    /** Custom health check function. Defaults to stepflow.healthCheck(). */
+    healthCheck?: () => Promise<boolean>;
+    /** Endpoint configuration - preset or fine-grained */
+    endpoints?: EndpointOption;
+    /** Authorization configuration */
+    auth?: NitricAuthConfig;
+    /** Callback when authorization fails */
+    onAuthFailure?: BaseAdapterOptions<NitricRequest, NitricHttpContext>["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;
+}
+/**
+ * Nitric HTTP context (simplified version for adapter compatibility)
+ */
+interface NitricHttpContext {
+    req: {
+        method: string;
+        path: string;
+        params: Record<string, string>;
+        query: Record<string, string>;
+        headers: Record<string, string>;
+        json: () => Promise<unknown>;
+        text: () => Promise<string>;
+    };
+    res: {
+        status: number;
+        headers: Record<string, string>;
+        body: string | Uint8Array;
+    };
+}
+type NitricHandler = (ctx: NitricHttpContext) => Promise<NitricHttpContext>;
+interface StepflowHandlers {
+    /** Handler for POST /trigger/:workflowId */
+    triggerHandler: NitricHandler;
+    /** Handler for GET /runs/:runId */
+    runHandler: NitricHandler;
+    /** Handler for GET /runs/:runId/stream */
+    streamHandler: NitricHandler;
+    /** Handler for POST /notify/:eventId */
+    notifyHandler: NitricHandler;
+    /** Handler for GET /health */
+    healthHandler: NitricHandler;
+}
+
+/**
+ * Create Nitric HTTP handlers for Stepflow
+ *
+ * @example
+ * ```typescript
+ * import { api } from '@nitric/sdk';
+ * import { Stepflow } from '@stepflowjs/core';
+ * import { createStepflowHandlers } from '@stepflowjs/adapter-nitric';
+ *
+ * const stepflow = new Stepflow({ storage: ... });
+ * const { triggerHandler, runHandler, healthHandler } = createStepflowHandlers(stepflow);
+ *
+ * const mainApi = api('main');
+ *
+ * mainApi.post('/stepflow/trigger/:workflowId', triggerHandler);
+ * mainApi.get('/stepflow/runs/:runId', runHandler);
+ * mainApi.get('/stepflow/health', healthHandler);
+ * ```
+ */
+declare function createStepflowHandlers(stepflow: Stepflow, options?: HandlerOptions): StepflowHandlers;
+/**
+ * Create a combined Nitric handler that routes to the appropriate handler
+ * based on the request path and method.
+ *
+ * @example
+ * ```typescript
+ * import { api } from '@nitric/sdk';
+ * import { Stepflow } from '@stepflowjs/core';
+ * import { createStepflowRouter } from '@stepflowjs/adapter-nitric';
+ *
+ * const stepflow = new Stepflow({ storage: ... });
+ * const router = createStepflowRouter(stepflow, { basePath: '/stepflow' });
+ *
+ * const mainApi = api('main');
+ * mainApi.all('/stepflow/*', router);
+ * ```
+ */
+declare function createStepflowRouter(stepflow: Stepflow, options?: HandlerOptions): NitricHandler;
+
+export { type ErrorResponseBody, type HandlerOptions, type NitricAuthConfig, type NitricAuthContext, type NitricHandler, type NitricHttpContext, type NitricRequest, type NotifyRequestBody, type StepflowHandlers, type TriggerRequestBody, createStepflowHandlers, createStepflowRouter };

package/dist/index.js

@@ -0,0 +1,280 @@
+// src/index.ts
+import {
+  isRouteEnabled,
+  runAuth,
+  getAuthFailureResponse,
+  createErrorBody
+} from "@stepflowjs/adapter-shared";
+import {
+  createApiKeyAuth,
+  createBearerAuth,
+  anyOf,
+  allOf,
+  isRouteEnabled as isRouteEnabled2,
+  resolveEndpoints
+} from "@stepflowjs/adapter-shared";
+function getAccessToken(ctx) {
+  const queryToken = ctx.req.query["token"];
+  if (queryToken) return queryToken;
+  const authHeader = ctx.req.headers["authorization"] || ctx.req.headers["Authorization"];
+  if (!authHeader) return void 0;
+  const match = authHeader.match(/^Bearer\s+(.+)$/i);
+  return match?.[1];
+}
+function jsonResponse(ctx, data, status = 200) {
+  ctx.res.status = status;
+  ctx.res.headers["Content-Type"] = "application/json";
+  ctx.res.body = JSON.stringify(data);
+  return ctx;
+}
+function jsonError(ctx, status, error, message) {
+  const body = message ? { error, message } : { error };
+  ctx.res.status = status;
+  ctx.res.headers["Content-Type"] = "application/json";
+  ctx.res.body = JSON.stringify(body);
+  return ctx;
+}
+function jsonAuthError(ctx, status, code, message) {
+  const body = createErrorBody(code, message);
+  ctx.res.status = status;
+  ctx.res.headers["Content-Type"] = "application/json";
+  ctx.res.body = JSON.stringify(body);
+  return ctx;
+}
+async function parseJsonBody(ctx) {
+  try {
+    return await ctx.req.json();
+  } catch {
+    throw new Error("Invalid JSON body");
+  }
+}
+function createNitricRequest(ctx) {
+  return {
+    header: (name) => ctx.req.headers[name] || ctx.req.headers[name.toLowerCase()],
+    headers: ctx.req.headers,
+    url: ctx.req.path,
+    method: ctx.req.method,
+    query: ctx.req.query
+  };
+}
+async function checkAuth(ctx, route, options, params = {}) {
+  const authCtx = {
+    route,
+    request: createNitricRequest(ctx),
+    extra: ctx,
+    ...params
+  };
+  const result = await runAuth(authCtx, options.auth);
+  if (!result.ok) {
+    const { status, code, message } = getAuthFailureResponse(result);
+    await options.onAuthFailure?.(authCtx, result);
+    return jsonAuthError(ctx, status, code, message);
+  }
+  return null;
+}
+function createStepflowHandlers(stepflow, options = {}) {
+  const triggerHandler = async (ctx) => {
+    const workflowId = ctx.req.params["workflowId"];
+    if (!workflowId) {
+      return jsonError(ctx, 400, "Bad request", "Missing workflowId parameter");
+    }
+    const authError = await checkAuth(ctx, "trigger", options, { workflowId });
+    if (authError) return authError;
+    try {
+      const body = await parseJsonBody(ctx);
+      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(ctx, response);
+    } catch (error) {
+      const message = error.message;
+      if (message.includes("Workflow") && message.includes("not found")) {
+        return jsonError(ctx, 404, "Not found", message);
+      }
+      if (message === "Invalid JSON body") {
+        return jsonError(ctx, 400, "Bad request", message);
+      }
+      return jsonError(ctx, 500, "Internal server error", message);
+    }
+  };
+  const runHandler = async (ctx) => {
+    const runId = ctx.req.params["runId"];
+    if (!runId) {
+      return jsonError(ctx, 400, "Bad request", "Missing runId parameter");
+    }
+    const authError = await checkAuth(ctx, "runs", options, { runId });
+    if (authError) return authError;
+    try {
+      const accessToken = getAccessToken(ctx);
+      const run = await stepflow.getRun(runId, { accessToken });
+      if (!run) {
+        return jsonError(ctx, 404, "Not found", `Run "${runId}" not found`);
+      }
+      const response = run;
+      return jsonResponse(ctx, response);
+    } catch (error) {
+      const message = error.message;
+      if (message === "Invalid access token") {
+        return jsonError(ctx, 401, "Unauthorized", message);
+      }
+      return jsonError(ctx, 500, "Internal server error", message);
+    }
+  };
+  const streamHandler = async (ctx) => {
+    const runId = ctx.req.params["runId"];
+    if (!runId) {
+      return jsonError(ctx, 400, "Bad request", "Missing runId parameter");
+    }
+    const authError = await checkAuth(ctx, "runsStream", options, { runId });
+    if (authError) return authError;
+    const accessToken = getAccessToken(ctx);
+    if (accessToken) {
+      try {
+        await stepflow.getRun(runId, { accessToken });
+      } catch (error) {
+        const message = error.message;
+        if (message === "Invalid access token") {
+          return jsonError(ctx, 401, "Unauthorized", message);
+        }
+        return jsonError(ctx, 500, "Internal server error", message);
+      }
+    }
+    try {
+      const run = await stepflow.getRun(runId);
+      if (!run) {
+        return jsonError(ctx, 404, "Not found", `Run "${runId}" not found`);
+      }
+      ctx.res.status = 200;
+      ctx.res.headers["Content-Type"] = "text/event-stream";
+      ctx.res.headers["Cache-Control"] = "no-cache";
+      ctx.res.headers["Connection"] = "keep-alive";
+      ctx.res.body = `event: update
+data: ${JSON.stringify(run)}
+
+`;
+      return ctx;
+    } catch (error) {
+      return jsonError(
+        ctx,
+        500,
+        "Internal server error",
+        error.message
+      );
+    }
+  };
+  const notifyHandler = async (ctx) => {
+    const eventId = ctx.req.params["eventId"];
+    if (!eventId) {
+      return jsonError(ctx, 400, "Bad request", "Missing eventId parameter");
+    }
+    const authError = await checkAuth(ctx, "notify", options, { eventId });
+    if (authError) return authError;
+    try {
+      const body = await parseJsonBody(ctx);
+      const result = await stepflow.notify(eventId, body.data);
+      const response = result;
+      return jsonResponse(ctx, response);
+    } catch (error) {
+      const message = error.message;
+      if (message === "Invalid JSON body") {
+        return jsonError(ctx, 400, "Bad request", message);
+      }
+      return jsonError(ctx, 500, "Internal server error", message);
+    }
+  };
+  const healthHandler = async (ctx) => {
+    const authError = await checkAuth(ctx, "health", options);
+    if (authError) return authError;
+    try {
+      const ok = await (options.healthCheck?.() ?? stepflow.healthCheck());
+      return jsonResponse(ctx, { ok });
+    } catch (error) {
+      return jsonError(
+        ctx,
+        500,
+        "Internal server error",
+        error.message
+      );
+    }
+  };
+  return {
+    triggerHandler,
+    runHandler,
+    streamHandler,
+    notifyHandler,
+    healthHandler
+  };
+}
+function createStepflowRouter(stepflow, options = {}) {
+  const handlers = createStepflowHandlers(stepflow, options);
+  const basePath = options.basePath?.replace(/\/$/, "") || "";
+  return async (ctx) => {
+    const path = basePath ? ctx.req.path.slice(basePath.length) : ctx.req.path;
+    const method = ctx.req.method.toUpperCase();
+    if (isRouteEnabled("health", options.endpoints)) {
+      if (path === "/health" && method === "GET") {
+        return handlers.healthHandler(ctx);
+      }
+    }
+    if (isRouteEnabled("trigger", options.endpoints)) {
+      const triggerMatch = path.match(/^\/trigger\/([^/]+)$/);
+      if (triggerMatch && method === "POST") {
+        ctx.req.params["workflowId"] = triggerMatch[1];
+        return handlers.triggerHandler(ctx);
+      }
+    }
+    if (isRouteEnabled("runsStream", options.endpoints)) {
+      const streamMatch = path.match(/^\/runs\/([^/]+)\/stream$/);
+      if (streamMatch && method === "GET") {
+        ctx.req.params["runId"] = streamMatch[1];
+        return handlers.streamHandler(ctx);
+      }
+    }
+    if (isRouteEnabled("runs", options.endpoints)) {
+      const runMatch = path.match(/^\/runs\/([^/]+)$/);
+      if (runMatch && method === "GET") {
+        ctx.req.params["runId"] = runMatch[1];
+        return handlers.runHandler(ctx);
+      }
+    }
+    if (isRouteEnabled("notify", options.endpoints)) {
+      const notifyMatch = path.match(/^\/notify\/([^/]+)$/);
+      if (notifyMatch && method === "POST") {
+        ctx.req.params["eventId"] = notifyMatch[1];
+        return handlers.notifyHandler(ctx);
+      }
+    }
+    if (isRouteEnabled("workflowsTrigger", options.endpoints)) {
+      const workflowTriggerMatch = path.match(
+        /^\/workflows\/([^/]+)\/trigger$/
+      );
+      if (workflowTriggerMatch && method === "POST") {
+        ctx.req.params["workflowId"] = workflowTriggerMatch[1];
+        return handlers.triggerHandler(ctx);
+      }
+    }
+    if (isRouteEnabled("eventsNotify", options.endpoints)) {
+      const eventNotifyMatch = path.match(/^\/events\/([^/]+)\/notify$/);
+      if (eventNotifyMatch && method === "POST") {
+        ctx.req.params["eventId"] = eventNotifyMatch[1];
+        return handlers.notifyHandler(ctx);
+      }
+    }
+    return jsonError(ctx, 404, "Not found");
+  };
+}
+export {
+  allOf,
+  anyOf,
+  createApiKeyAuth,
+  createBearerAuth,
+  createStepflowHandlers,
+  createStepflowRouter,
+  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\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** Nitric-specific request type for auth handlers */\nexport type NitricRequest = {\n  header(name: string): string | undefined;\n  headers: Record<string, string>;\n  url: string;\n  method: string;\n  query: Record<string, string>;\n};\n\n/** Nitric-specific auth context */\nexport type NitricAuthContext = AuthContext<NitricRequest, NitricHttpContext>;\n\n/** Nitric-specific auth config */\nexport type NitricAuthConfig = AuthConfig<NitricRequest, NitricHttpContext>;\n\nexport interface HandlerOptions {\n  /** Base path prefix for all routes (e.g., \"/api/stepflow\"). */\n  basePath?: string;\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?: NitricAuthConfig;\n  /** Callback when authorization fails */\n  onAuthFailure?: BaseAdapterOptions<\n    NitricRequest,\n    NitricHttpContext\n  >[\"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/**\n * Nitric HTTP context (simplified version for adapter compatibility)\n */\nexport interface NitricHttpContext {\n  req: {\n    method: string;\n    path: string;\n    params: Record<string, string>;\n    query: Record<string, string>;\n    headers: Record<string, string>;\n    json: () => Promise<unknown>;\n    text: () => Promise<string>;\n  };\n  res: {\n    status: number;\n    headers: Record<string, string>;\n    body: string | Uint8Array;\n  };\n}\n\nexport type NitricHandler = (\n  ctx: NitricHttpContext,\n) => Promise<NitricHttpContext>;\n\nexport interface StepflowHandlers {\n  /** Handler for POST /trigger/:workflowId */\n  triggerHandler: NitricHandler;\n  /** Handler for GET /runs/:runId */\n  runHandler: NitricHandler;\n  /** Handler for GET /runs/:runId/stream */\n  streamHandler: NitricHandler;\n  /** Handler for POST /notify/:eventId */\n  notifyHandler: NitricHandler;\n  /** Handler for GET /health */\n  healthHandler: NitricHandler;\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(ctx: NitricHttpContext): string | undefined {\n  const queryToken = ctx.req.query[\"token\"];\n  if (queryToken) return queryToken;\n\n  const authHeader =\n    ctx.req.headers[\"authorization\"] || ctx.req.headers[\"Authorization\"];\n  if (!authHeader) return undefined;\n\n  const match = authHeader.match(/^Bearer\\s+(.+)$/i);\n  return match?.[1];\n}\n\nfunction jsonResponse<T>(\n  ctx: NitricHttpContext,\n  data: T,\n  status = 200,\n): NitricHttpContext {\n  ctx.res.status = status;\n  ctx.res.headers[\"Content-Type\"] = \"application/json\";\n  ctx.res.body = JSON.stringify(data);\n  return ctx;\n}\n\nfunction jsonError(\n  ctx: NitricHttpContext,\n  status: number,\n  error: string,\n  message?: string,\n): NitricHttpContext {\n  const body: ErrorResponseBody = message ? { error, message } : { error };\n  ctx.res.status = status;\n  ctx.res.headers[\"Content-Type\"] = \"application/json\";\n  ctx.res.body = JSON.stringify(body);\n  return ctx;\n}\n\nfunction jsonAuthError(\n  ctx: NitricHttpContext,\n  status: number,\n  code: string,\n  message: string,\n): NitricHttpContext {\n  const body = createErrorBody(code, message);\n  ctx.res.status = status;\n  ctx.res.headers[\"Content-Type\"] = \"application/json\";\n  ctx.res.body = JSON.stringify(body);\n  return ctx;\n}\n\nasync function parseJsonBody<T>(ctx: NitricHttpContext): Promise<T> {\n  try {\n    return (await ctx.req.json()) as T;\n  } catch {\n    throw new Error(\"Invalid JSON body\");\n  }\n}\n\n/**\n * Creates a NitricRequest object from Nitric context for auth handlers\n */\nfunction createNitricRequest(ctx: NitricHttpContext): NitricRequest {\n  return {\n    header: (name: string) =>\n      ctx.req.headers[name] || ctx.req.headers[name.toLowerCase()],\n    headers: ctx.req.headers,\n    url: ctx.req.path,\n    method: ctx.req.method,\n    query: ctx.req.query,\n  };\n}\n\n/**\n * Runs authorization check and returns error response if denied\n */\nasync function checkAuth(\n  ctx: NitricHttpContext,\n  route: RouteName,\n  options: HandlerOptions,\n  params: { workflowId?: string; eventId?: string; runId?: string } = {},\n): Promise<NitricHttpContext | null> {\n  const authCtx: NitricAuthContext = {\n    route,\n    request: createNitricRequest(ctx),\n    extra: ctx,\n    ...params,\n  };\n\n  const result = await runAuth(authCtx, options.auth);\n\n  if (!result.ok) {\n    const { status, code, message } = getAuthFailureResponse(result);\n    await options.onAuthFailure?.(authCtx, result);\n    return jsonAuthError(ctx, status, code, message);\n  }\n\n  return null;\n}\n\n// ============================================================================\n// Handler Factory\n// ============================================================================\n\n/**\n * Create Nitric HTTP handlers for Stepflow\n *\n * @example\n * ```typescript\n * import { api } from '@nitric/sdk';\n * import { Stepflow } from '@stepflowjs/core';\n * import { createStepflowHandlers } from '@stepflowjs/adapter-nitric';\n *\n * const stepflow = new Stepflow({ storage: ... });\n * const { triggerHandler, runHandler, healthHandler } = createStepflowHandlers(stepflow);\n *\n * const mainApi = api('main');\n *\n * mainApi.post('/stepflow/trigger/:workflowId', triggerHandler);\n * mainApi.get('/stepflow/runs/:runId', runHandler);\n * mainApi.get('/stepflow/health', healthHandler);\n * ```\n */\nexport function createStepflowHandlers(\n  stepflow: Stepflow,\n  options: HandlerOptions = {},\n): StepflowHandlers {\n  // -------------------------------------------------------------------------\n  // Trigger Handler - POST /trigger/:workflowId\n  // -------------------------------------------------------------------------\n  const triggerHandler: NitricHandler = async (ctx) => {\n    const workflowId = ctx.req.params[\"workflowId\"];\n\n    if (!workflowId) {\n      return jsonError(ctx, 400, \"Bad request\", \"Missing workflowId parameter\");\n    }\n\n    const authError = await checkAuth(ctx, \"trigger\", options, { workflowId });\n    if (authError) return authError;\n\n    try {\n      const body = await parseJsonBody<TriggerRequestBody>(ctx);\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(ctx, response);\n    } catch (error) {\n      const message = (error as Error).message;\n      if (message.includes(\"Workflow\") && message.includes(\"not found\")) {\n        return jsonError(ctx, 404, \"Not found\", message);\n      }\n      if (message === \"Invalid JSON body\") {\n        return jsonError(ctx, 400, \"Bad request\", message);\n      }\n      return jsonError(ctx, 500, \"Internal server error\", message);\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Run Handler - GET /runs/:runId\n  // -------------------------------------------------------------------------\n  const runHandler: NitricHandler = async (ctx) => {\n    const runId = ctx.req.params[\"runId\"];\n\n    if (!runId) {\n      return jsonError(ctx, 400, \"Bad request\", \"Missing runId parameter\");\n    }\n\n    const authError = await checkAuth(ctx, \"runs\", options, { runId });\n    if (authError) return authError;\n\n    try {\n      const accessToken = getAccessToken(ctx);\n      const run = await stepflow.getRun(runId, { accessToken });\n\n      if (!run) {\n        return jsonError(ctx, 404, \"Not found\", `Run \"${runId}\" not found`);\n      }\n\n      const response: Execution = run;\n      return jsonResponse(ctx, response);\n    } catch (error) {\n      const message = (error as Error).message;\n      if (message === \"Invalid access token\") {\n        return jsonError(ctx, 401, \"Unauthorized\", message);\n      }\n      return jsonError(ctx, 500, \"Internal server error\", message);\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Stream Handler - GET /runs/:runId/stream\n  // -------------------------------------------------------------------------\n  const streamHandler: NitricHandler = async (ctx) => {\n    const runId = ctx.req.params[\"runId\"];\n\n    if (!runId) {\n      return jsonError(ctx, 400, \"Bad request\", \"Missing runId parameter\");\n    }\n\n    const authError = await checkAuth(ctx, \"runsStream\", options, { runId });\n    if (authError) return authError;\n\n    // Validate access token if provided\n    const accessToken = getAccessToken(ctx);\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(ctx, 401, \"Unauthorized\", message);\n        }\n        return jsonError(ctx, 500, \"Internal server error\", message);\n      }\n    }\n\n    // For Nitric, SSE streaming is not directly supported in the same way\n    // Instead, we return the current state as JSON\n    // Real-time updates should be implemented using Nitric's websocket or pub/sub features\n    try {\n      const run = await stepflow.getRun(runId);\n\n      if (!run) {\n        return jsonError(ctx, 404, \"Not found\", `Run \"${runId}\" not found`);\n      }\n\n      // Return SSE-style headers but with current state as JSON\n      // Note: True SSE streaming requires different Nitric patterns (websockets/pub-sub)\n      ctx.res.status = 200;\n      ctx.res.headers[\"Content-Type\"] = \"text/event-stream\";\n      ctx.res.headers[\"Cache-Control\"] = \"no-cache\";\n      ctx.res.headers[\"Connection\"] = \"keep-alive\";\n      ctx.res.body = `event: update\\ndata: ${JSON.stringify(run)}\\n\\n`;\n\n      return ctx;\n    } catch (error) {\n      return jsonError(\n        ctx,\n        500,\n        \"Internal server error\",\n        (error as Error).message,\n      );\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Notify Handler - POST /notify/:eventId\n  // -------------------------------------------------------------------------\n  const notifyHandler: NitricHandler = async (ctx) => {\n    const eventId = ctx.req.params[\"eventId\"];\n\n    if (!eventId) {\n      return jsonError(ctx, 400, \"Bad request\", \"Missing eventId parameter\");\n    }\n\n    const authError = await checkAuth(ctx, \"notify\", options, { eventId });\n    if (authError) return authError;\n\n    try {\n      const body = await parseJsonBody<NotifyRequestBody>(ctx);\n      const result = await stepflow.notify(eventId, body.data);\n      const response: NotifyResult = result;\n      return jsonResponse(ctx, response);\n    } catch (error) {\n      const message = (error as Error).message;\n      if (message === \"Invalid JSON body\") {\n        return jsonError(ctx, 400, \"Bad request\", message);\n      }\n      return jsonError(ctx, 500, \"Internal server error\", message);\n    }\n  };\n\n  // -------------------------------------------------------------------------\n  // Health Handler - GET /health\n  // -------------------------------------------------------------------------\n  const healthHandler: NitricHandler = async (ctx) => {\n    const authError = await checkAuth(ctx, \"health\", options);\n    if (authError) return authError;\n\n    try {\n      const ok = await (options.healthCheck?.() ?? stepflow.healthCheck());\n      return jsonResponse(ctx, { ok });\n    } catch (error) {\n      return jsonError(\n        ctx,\n        500,\n        \"Internal server error\",\n        (error as Error).message,\n      );\n    }\n  };\n\n  return {\n    triggerHandler,\n    runHandler,\n    streamHandler,\n    notifyHandler,\n    healthHandler,\n  };\n}\n\n/**\n * Create a combined Nitric handler that routes to the appropriate handler\n * based on the request path and method.\n *\n * @example\n * ```typescript\n * import { api } from '@nitric/sdk';\n * import { Stepflow } from '@stepflowjs/core';\n * import { createStepflowRouter } from '@stepflowjs/adapter-nitric';\n *\n * const stepflow = new Stepflow({ storage: ... });\n * const router = createStepflowRouter(stepflow, { basePath: '/stepflow' });\n *\n * const mainApi = api('main');\n * mainApi.all('/stepflow/*', router);\n * ```\n */\nexport function createStepflowRouter(\n  stepflow: Stepflow,\n  options: HandlerOptions = {},\n): NitricHandler {\n  const handlers = createStepflowHandlers(stepflow, options);\n  const basePath = options.basePath?.replace(/\\/$/, \"\") || \"\";\n\n  return async (ctx) => {\n    const path = basePath ? ctx.req.path.slice(basePath.length) : ctx.req.path;\n    const method = ctx.req.method.toUpperCase();\n\n    // Health check\n    if (isRouteEnabled(\"health\", options.endpoints)) {\n      if (path === \"/health\" && method === \"GET\") {\n        return handlers.healthHandler(ctx);\n      }\n    }\n\n    // Trigger workflow\n    if (isRouteEnabled(\"trigger\", options.endpoints)) {\n      const triggerMatch = path.match(/^\\/trigger\\/([^/]+)$/);\n      if (triggerMatch && method === \"POST\") {\n        ctx.req.params[\"workflowId\"] = triggerMatch[1];\n        return handlers.triggerHandler(ctx);\n      }\n    }\n\n    // Run stream\n    if (isRouteEnabled(\"runsStream\", options.endpoints)) {\n      const streamMatch = path.match(/^\\/runs\\/([^/]+)\\/stream$/);\n      if (streamMatch && method === \"GET\") {\n        ctx.req.params[\"runId\"] = streamMatch[1];\n        return handlers.streamHandler(ctx);\n      }\n    }\n\n    // Run status\n    if (isRouteEnabled(\"runs\", options.endpoints)) {\n      const runMatch = path.match(/^\\/runs\\/([^/]+)$/);\n      if (runMatch && method === \"GET\") {\n        ctx.req.params[\"runId\"] = runMatch[1];\n        return handlers.runHandler(ctx);\n      }\n    }\n\n    // Notify event\n    if (isRouteEnabled(\"notify\", options.endpoints)) {\n      const notifyMatch = path.match(/^\\/notify\\/([^/]+)$/);\n      if (notifyMatch && method === \"POST\") {\n        ctx.req.params[\"eventId\"] = notifyMatch[1];\n        return handlers.notifyHandler(ctx);\n      }\n    }\n\n    // Client SDK compatibility routes\n    if (isRouteEnabled(\"workflowsTrigger\", options.endpoints)) {\n      const workflowTriggerMatch = path.match(\n        /^\\/workflows\\/([^/]+)\\/trigger$/,\n      );\n      if (workflowTriggerMatch && method === \"POST\") {\n        ctx.req.params[\"workflowId\"] = workflowTriggerMatch[1];\n        return handlers.triggerHandler(ctx);\n      }\n    }\n\n    if (isRouteEnabled(\"eventsNotify\", options.endpoints)) {\n      const eventNotifyMatch = path.match(/^\\/events\\/([^/]+)\\/notify$/);\n      if (eventNotifyMatch && method === \"POST\") {\n        ctx.req.params[\"eventId\"] = eventNotifyMatch[1];\n        return handlers.notifyHandler(ctx);\n      }\n    }\n\n    // Not found\n    return jsonError(ctx, 404, \"Not found\");\n  };\n}\n\n// Re-export types\nexport type { Execution, TriggerResult, NotifyResult } from \"@stepflowjs/core\";\n"],"mappings":"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","names":["isRouteEnabled"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@stepflowjs/adapter-nitric",
+  "version": "0.0.1",
+  "description": "Nitric.io 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/core": "0.0.1",
+    "@stepflowjs/adapter-shared": "0.0.1"
+  },
+  "devDependencies": {
+    "@nitric/sdk": "^1.4.2",
+    "tsup": "^8.5.1",
+    "vitest": "^4.0.17"
+  },
+  "peerDependencies": {
+    "@nitric/sdk": "^1.0.0",
+    "typescript": "^5.0.0"
+  },
+  "license": "MIT",
+  "author": "Stepflow Contributors",
+  "repository": {
+    "type": "git",
+    "url": "https://stepflow-production.up.railway.app",
+    "directory": "packages/adapters/nitric"
+  },
+  "homepage": "https://stepflow-production.up.railway.app",
+  "bugs": {
+    "url": "https://stepflow-production.up.railway.app"
+  },
+  "keywords": [
+    "stepflow",
+    "adapter",
+    "nitric",
+    "framework",
+    "workflow",
+    "orchestration"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "clean": "rm -rf dist"
+  }
+}