@voyantjs/workflows-orchestrator-cloudflare 0.28.3 → 0.29.0

package/src/types.ts

@@ -27,20 +27,6 @@ export interface DurableObjectStorageLike {
   deleteAlarm?(): Promise<void>
 }
 
-/**
- * Subset of a Workers-for-Platforms dispatch namespace. `get(name)`
- * returns a binding whose `fetch` delivers to the tenant Worker
- * registered under that name.
- */
-export interface DispatchNamespaceLike {
-  get(
-    name: string,
-    args?: Record<string, unknown>,
-  ): {
-    fetch(request: Request): Promise<Response>
-  }
-}
-
 /** Args the Worker passes when routing to a run DO. */
 export interface RunOperation {
   op: "trigger" | "resume" | "cancel" | "get"
@@ -61,8 +47,12 @@ export interface TriggerPayload {
     tenantId: string
     projectId: string
     organizationId: string
-    /** Dispatch-namespace name to forward step requests to. */
-    tenantScript: string
+    /**
+     * Adapter-specific tenant identifier. Opaque to the OSS runtime —
+     * surfaces on `StepDispatcherContext` so custom dispatchers can
+     * use it as a routing key.
+     */
+    tenantScript?: string
   }
   environment?: "production" | "preview" | "development"
   tags?: string[]
@@ -78,9 +68,7 @@ export interface CancelPayload {
  * The Worker runtime env the adapter expects. Callers provide their
  * own wrangler config; this interface documents what we read.
  */
-export interface AdapterEnv<DONamespace = unknown, DispatchNS = DispatchNamespaceLike> {
+export interface AdapterEnv<DONamespace = unknown> {
   /** Durable Object namespace holding one DO per run. Typed loosely to avoid a CF types dep. */
   WORKFLOW_RUN_DO: DONamespace
-  /** Dispatch namespace containing tenant Workers. */
-  DISPATCHER: DispatchNS
 }

package/src/worker.ts

@@ -13,6 +13,10 @@
 
 import type { WaitpointInjection } from "@voyantjs/workflows-orchestrator"
 
+import { handleIngestEvent } from "./event-handler.js"
+import { handleGetManifest, handleRegisterManifest } from "./manifest-handler.js"
+import type { CfManifestStore } from "./manifest-kv-store.js"
+
 /**
  * Minimal shape of a DO namespace. `idFromName` returns an opaque id;
  * `get(id)` returns a stub with `fetch` (matching the CF DO API).
@@ -36,6 +40,24 @@ export interface WorkerFetchDeps<Id = unknown> {
   idGenerator?: () => string
   /** Injectable clock for id generation. */
   now?: () => number
+  /**
+   * Optional KV-backed manifest store. When set, the worker also serves
+   * `/api/manifests` and `/api/events`. When unset, those routes 404 —
+   * useful for orchestrators that only expose the run surface.
+   */
+  manifestStore?: CfManifestStore
+  /**
+   * Tenant metadata stamped on event-triggered runs. Defaults to
+   * `{ tenantId: "default", projectId: "default", organizationId: "default" }`.
+   * Voyant Cloud's wrapper layer overrides this with per-org values via
+   * the request-routing layer.
+   */
+  tenantMeta?: {
+    tenantId: string
+    projectId: string
+    organizationId: string
+    tenantScript?: string
+  }
 }
 
 export async function handleWorkerRequest<Id>(
@@ -60,6 +82,48 @@ export async function handleWorkerRequest<Id>(
     })
   }
 
+  // POST /api/manifests — register a manifest for an environment.
+  if (req.method === "POST" && url.pathname === "/api/manifests") {
+    if (!deps.manifestStore) {
+      return json(404, { error: "manifests_not_configured" })
+    }
+    return handleRegisterManifest(req, {
+      manifestStore: deps.manifestStore,
+      logger: deps.logger,
+    })
+  }
+
+  // GET /api/manifests/:env — read the current manifest.
+  if (req.method === "GET") {
+    const manifestMatch = url.pathname.match(/^\/api\/manifests\/([^/]+)$/)
+    if (manifestMatch) {
+      if (!deps.manifestStore) {
+        return json(404, { error: "manifests_not_configured" })
+      }
+      const env = decodeURIComponent(manifestMatch[1] ?? "")
+      return handleGetManifest(env, {
+        manifestStore: deps.manifestStore,
+        logger: deps.logger,
+      })
+    }
+  }
+
+  // POST /api/events — synchronous event ingest. Loads the manifest,
+  // routes filters, forwards each match to the run-DO trigger flow.
+  if (req.method === "POST" && url.pathname === "/api/events") {
+    if (!deps.manifestStore) {
+      return json(404, { error: "events_not_configured" })
+    }
+    return handleIngestEvent(req, {
+      manifestStore: deps.manifestStore,
+      runDO: deps.runDO,
+      idGenerator: deps.idGenerator,
+      now: deps.now,
+      tenantMeta: deps.tenantMeta,
+      logger: deps.logger,
+    })
+  }
+
   // POST /api/runs — trigger a new run.
   if (req.method === "POST" && url.pathname === "/api/runs") {
     let payload: Record<string, unknown>

package/dist/dispatch-handler.d.ts

@@ -1,20 +0,0 @@
-import { type StepHandler } from "@voyantjs/workflows-orchestrator";
-import type { DispatchNamespaceLike } from "./types.js";
-export interface DispatchHandlerDeps {
-    dispatcher: DispatchNamespaceLike;
-    /** Optional HMAC signer for the X-Voyant-Dispatch-Auth header. */
-    sign?: (body: string) => Promise<string> | string;
-    /** Optional logger for step-level observability. */
-    logger?: (level: "info" | "warn" | "error", msg: string, data?: object) => void;
-    /** Base URL to present to the tenant. Defaults to `https://tenant.voyant.internal`. */
-    baseUrl?: string;
-}
-/**
- * The dispatcher binding expects a name corresponding to the tenant
- * script slot. `createDispatchStepHandler` binds the step handler to
- * a specific tenant script; different tenants need different handlers
- * (trivial via `createDispatchStepHandler(...)` with the script name
- * resolved from the run's tenantMeta).
- */
-export declare function createDispatchStepHandler(tenantScript: string, deps: DispatchHandlerDeps): StepHandler;
-//# sourceMappingURL=dispatch-handler.d.ts.map

package/dist/dispatch-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch-handler.d.ts","sourceRoot":"","sources":["../src/dispatch-handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAEvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,qBAAqB,CAAA;IACjC,kEAAkE;IAClE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;IACjD,oDAAoD;IACpD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/E,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,mBAAmB,GACxB,WAAW,CAgBb"}

package/dist/dispatch-handler.js

@@ -1,31 +0,0 @@
-// Builds a `StepHandler` (the thing the orchestrator calls on every
-// invocation) by routing the request through a Workers-for-Platforms
-// dispatch namespace to the tenant's bundled Worker.
-//
-// The tenant Worker is expected to mount `@voyantjs/workflows/handler`
-// at `POST /__voyant/workflow-step` (see docs/runtime-protocol.md §2.1).
-import { createHttpStepHandler, } from "@voyantjs/workflows-orchestrator";
-/**
- * The dispatcher binding expects a name corresponding to the tenant
- * script slot. `createDispatchStepHandler` binds the step handler to
- * a specific tenant script; different tenants need different handlers
- * (trivial via `createDispatchStepHandler(...)` with the script name
- * resolved from the run's tenantMeta).
- */
-export function createDispatchStepHandler(tenantScript, deps) {
-    const baseUrl = deps.baseUrl ?? "https://tenant.voyant.internal";
-    return createHttpStepHandler({
-        sign: deps.sign ? (body) => deps.sign(body) : undefined,
-        logger: deps.logger,
-        resolveTarget(_req) {
-            const binding = deps.dispatcher.get(tenantScript);
-            return {
-                url: `${baseUrl}/__voyant/workflow-step`,
-                label: tenantScript,
-                fetch(request) {
-                    return binding.fetch(request);
-                },
-            };
-        },
-    });
-}

package/src/dispatch-handler.ts

@@ -1,51 +0,0 @@
-// Builds a `StepHandler` (the thing the orchestrator calls on every
-// invocation) by routing the request through a Workers-for-Platforms
-// dispatch namespace to the tenant's bundled Worker.
-//
-// The tenant Worker is expected to mount `@voyantjs/workflows/handler`
-// at `POST /__voyant/workflow-step` (see docs/runtime-protocol.md §2.1).
-
-import {
-  createHttpStepHandler,
-  type StepHandler,
-  type WorkflowStepRequest,
-} from "@voyantjs/workflows-orchestrator"
-import type { DispatchNamespaceLike } from "./types.js"
-
-export interface DispatchHandlerDeps {
-  dispatcher: DispatchNamespaceLike
-  /** Optional HMAC signer for the X-Voyant-Dispatch-Auth header. */
-  sign?: (body: string) => Promise<string> | string
-  /** Optional logger for step-level observability. */
-  logger?: (level: "info" | "warn" | "error", msg: string, data?: object) => void
-  /** Base URL to present to the tenant. Defaults to `https://tenant.voyant.internal`. */
-  baseUrl?: string
-}
-
-/**
- * The dispatcher binding expects a name corresponding to the tenant
- * script slot. `createDispatchStepHandler` binds the step handler to
- * a specific tenant script; different tenants need different handlers
- * (trivial via `createDispatchStepHandler(...)` with the script name
- * resolved from the run's tenantMeta).
- */
-export function createDispatchStepHandler(
-  tenantScript: string,
-  deps: DispatchHandlerDeps,
-): StepHandler {
-  const baseUrl = deps.baseUrl ?? "https://tenant.voyant.internal"
-  return createHttpStepHandler({
-    sign: deps.sign ? (body) => deps.sign!(body) : undefined,
-    logger: deps.logger,
-    resolveTarget(_req: WorkflowStepRequest) {
-      const binding = deps.dispatcher.get(tenantScript)
-      return {
-        url: `${baseUrl}/__voyant/workflow-step`,
-        label: tenantScript,
-        fetch(request: Request) {
-          return binding.fetch(request)
-        },
-      }
-    },
-  })
-}