@voyantjs/workflows-orchestrator-cloudflare 0.28.1 → 0.29.0

package/dist/manifest-kv-store.js

@@ -0,0 +1,134 @@
+// KV-backed manifest store for the Cloudflare orchestrator.
+//
+// Mirrors the Mode 2 ManifestStore contract from
+// `@voyantjs/workflows-orchestrator-node`'s `createPostgresManifestStore`,
+// just against KV instead of Postgres. Both are consumed by their
+// respective driver factories — the orchestrator's `WorkflowDriver`
+// shape is identical.
+//
+// Layout in KV:
+//
+//   manifest:<environment>:<versionId>      → JSON-serialized manifest
+//   manifest:<environment>:current          → versionId of the active manifest
+//
+// Idempotent: same `(environment, versionId)` overwrite is fine.
+// Latest N versions retained via `pruneToVersions(env, n)`. KV is
+// eventually consistent (~60s globally), which is acceptable for the
+// manifest read path (manifests change at deploy boundaries, not per
+// event).
+// ---- Public factory ----
+/**
+ * Build a KV-backed `CfManifestStore`. Stateless — every call hits KV.
+ */
+export function createKvManifestStore(opts) {
+    const kv = opts.kv;
+    return {
+        async registerManifest(envelope) {
+            const versionKey = manifestVersionKey(envelope.environment, envelope.versionId);
+            const currentKey = manifestCurrentKey(envelope.environment);
+            // Idempotent overwrite — same body produces the same byte content
+            // because manifests are content-addressed (versionId derives from
+            // a sha256 of the canonicalized manifest in the SDK).
+            await kv.put(versionKey, JSON.stringify(envelope.manifest));
+            await kv.put(currentKey, envelope.versionId);
+            return { versionId: envelope.versionId };
+        },
+        async getCurrent(environment) {
+            const currentKey = manifestCurrentKey(environment);
+            const versionId = await kv.get(currentKey);
+            if (!versionId)
+                return null;
+            const versionKey = manifestVersionKey(environment, versionId);
+            const raw = await kv.get(versionKey);
+            if (!raw)
+                return null;
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                return null;
+            }
+            return {
+                environment,
+                versionId,
+                manifest: parsed,
+            };
+        },
+        async pruneToVersions(environment, keep) {
+            if (keep < 1) {
+                throw new Error(`pruneToVersions: keep must be >= 1, got ${keep}`);
+            }
+            // List every version key for this environment; sort so we can drop
+            // older entries. Lexicographic sort is fine because the SDK's
+            // versionId is a hex string of the same length, and KV's natural
+            // order is also lexicographic. For deterministic semantics we
+            // additionally fetch the `current` pointer and always keep that.
+            const prefix = `manifest:${environment}:`;
+            const list = await kv.list({ prefix, limit: 1000 });
+            const versionKeys = list.keys.map((k) => k.name).filter((name) => !name.endsWith(":current"));
+            // Sort newest-first (lexicographic descending).
+            versionKeys.sort((a, b) => (a < b ? 1 : a > b ? -1 : 0));
+            const currentVersion = await kv.get(manifestCurrentKey(environment));
+            const currentKey = currentVersion
+                ? manifestVersionKey(environment, currentVersion)
+                : undefined;
+            const keepers = new Set();
+            if (currentKey)
+                keepers.add(currentKey);
+            for (const k of versionKeys) {
+                if (keepers.size >= keep)
+                    break;
+                keepers.add(k);
+            }
+            let deleted = 0;
+            for (const k of versionKeys) {
+                if (keepers.has(k))
+                    continue;
+                await kv.delete(k);
+                deleted++;
+            }
+            return { deleted };
+        },
+    };
+}
+// ---- Key helpers ----
+function manifestVersionKey(environment, versionId) {
+    return `manifest:${environment}:${versionId}`;
+}
+function manifestCurrentKey(environment) {
+    return `manifest:${environment}:current`;
+}
+// ---- In-memory KV fake (test-only) ----
+/**
+ * Tiny in-memory implementation of `KvNamespaceLike` for tests + the CF
+ * compliance suite run that doesn't go through wrangler. Mirrors the
+ * subset of CF KV semantics we use (list returns matching prefix in
+ * lexicographic order; get returns null for missing keys).
+ */
+export function createInMemoryKv() {
+    const map = new Map();
+    return {
+        async get(key) {
+            return map.has(key) ? map.get(key) : null;
+        },
+        async put(key, value) {
+            map.set(key, value);
+        },
+        async delete(key) {
+            map.delete(key);
+        },
+        async list(opts) {
+            const prefix = opts?.prefix ?? "";
+            const limit = opts?.limit ?? 1000;
+            const matching = [...map.keys()]
+                .filter((k) => k.startsWith(prefix))
+                .sort()
+                .slice(0, limit);
+            return {
+                keys: matching.map((name) => ({ name })),
+                list_complete: true,
+            };
+        },
+    };
+}

package/dist/types.d.ts

@@ -24,16 +24,6 @@ export interface DurableObjectStorageLike {
     /** Cancel any pending alarm. */
     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";
@@ -52,8 +42,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[];
@@ -67,10 +61,8 @@ 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;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAE1E;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAC3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;IAC/E,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,gCAAgC;IAChC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B;QACD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAC3C,CAAA;CACF;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,kBAAkB,CAAA;CAC9B;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB,2DAA2D;QAC3D,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,WAAW,GAAG,OAAO,EAAE,UAAU,GAAG,qBAAqB;IACnF,8FAA8F;IAC9F,eAAe,EAAE,WAAW,CAAA;IAC5B,oDAAoD;IACpD,UAAU,EAAE,UAAU,CAAA;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAE1E;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAC3C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;IAC/E,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,gCAAgC;IAChC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,kBAAkB,CAAA;CAC9B;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB;;;;WAIG;QACH,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;IACtD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,WAAW,GAAG,OAAO;IAC/C,8FAA8F;IAC9F,eAAe,EAAE,WAAW,CAAA;CAC7B"}

package/dist/worker.d.ts

@@ -1,3 +1,4 @@
+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).
@@ -22,6 +23,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 declare function handleWorkerRequest<Id>(req: Request, deps: WorkerFetchDeps<Id>): Promise<Response>;
 //# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,WAAW,0BAA0B,CAAC,EAAE,GAAG,OAAO;IACtD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAA;IAC5B,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG;QAAE,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;CACxD;AAED,MAAM,WAAW,eAAe,CAAC,EAAE,GAAG,OAAO;IAC3C,KAAK,EAAE,0BAA0B,CAAC,EAAE,CAAC,CAAA;IACrC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,uBAAuB;IACvB,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,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,MAAM,CAAA;IAC1B,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAED,wBAAsB,mBAAmB,CAAC,EAAE,EAC1C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC,GACxB,OAAO,CAAC,QAAQ,CAAC,CA6EnB"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D;;;;GAIG;AACH,MAAM,WAAW,0BAA0B,CAAC,EAAE,GAAG,OAAO;IACtD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAAA;IAC5B,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG;QAAE,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;CACxD;AAED,MAAM,WAAW,eAAe,CAAC,EAAE,GAAG,OAAO;IAC3C,KAAK,EAAE,0BAA0B,CAAC,EAAE,CAAC,CAAA;IACrC;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,uBAAuB;IACvB,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,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,MAAM,CAAA;IAC1B,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,eAAe,CAAA;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACF;AAED,wBAAsB,mBAAmB,CAAC,EAAE,EAC1C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC,GACxB,OAAO,CAAC,QAAQ,CAAC,CAuHnB"}

package/dist/worker.js

@@ -10,6 +10,8 @@
 //   POST /api/runs/:id/events          → inject an EVENT waitpoint
 //   POST /api/runs/:id/tokens/:token   → inject a MANUAL (token) waitpoint
 //   POST /api/runs/:id/cancel          → cancel a run
+import { handleIngestEvent } from "./event-handler.js";
+import { handleGetManifest, handleRegisterManifest } from "./manifest-handler.js";
 export async function handleWorkerRequest(req, deps) {
     const url = new URL(req.url);
     if (req.method === "OPTIONS") {
@@ -28,6 +30,45 @@ export async function handleWorkerRequest(req, deps) {
             message: err instanceof Error ? err.message : String(err),
         });
     }
+    // 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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/workflows-orchestrator-cloudflare",
-  "version": "0.28.1",
+  "version": "0.29.0",
   "description": "Cloudflare Worker + Durable Object adapter for @voyantjs/workflows-orchestrator. Dispatches workflow-step requests to tenant Workers via a Workers-for-Platforms dispatch namespace.",
   "license": "Apache-2.0",
   "repository": {
@@ -26,8 +26,8 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@voyantjs/workflows-orchestrator": "0.28.1",
-    "@voyantjs/workflows": "0.28.1"
+    "@voyantjs/workflows-orchestrator": "0.29.0",
+    "@voyantjs/workflows": "0.29.0"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.15.1",