@nanobpm/nano-sdk 1.0.0

package/README.md

@@ -0,0 +1,45 @@
+# @nanobpm/nano-sdk
+
+A **drop-in replacement** for [`@camunda8/orchestration-cluster-api`](https://www.npmjs.com/package/@camunda8/orchestration-cluster-api) that transparently upgrades to Nano's **command-stream** protocol when connected to a [Nano](../nanobpmn) server. Against stock Camunda 8 it behaves exactly like the upstream SDK.
+
+```diff
+- import { createCamundaClient } from "@camunda8/orchestration-cluster-api";
++ import { createCamundaClient } from "@nanobpm/nano-sdk";
+```
+
+Everything else is re-exported unchanged — same types, same client, same API.
+
+## What gets upgraded
+
+When the client detects a Nano server, two hot paths move from REST onto a single persistent WebSocket (`/command-stream`):
+
+- **`createProcessInstance`** → `createInstance` frame (with `awaitCompletion` resolved via `instanceCompleted`).
+- **`createJobWorker`** → `subscribe` + pushed `job` frames, acked with `completeJob`/`failJob`/`throwError` and credit-replenished.
+
+This avoids the ~125 creates/s/conn ceiling of the REST long-poll path.
+
+## Detection & override
+
+Detection is automatic: the SDK probes `GET /v2/topology` once and looks for the Nano `commandStreamPath` advertisement. Control it via the `CAMUNDA_TRANSPORT` config (or env var):
+
+| value            | behaviour                                   |
+| ---------------- | ------------------------------------------- |
+| `auto` (default) | command-stream on Nano, REST elsewhere      |
+| `command-stream` | force the stream (assume Nano)              |
+| `rest`           | never upgrade — pure upstream behaviour     |
+
+```ts
+const client = createCamundaClient({
+  config: { CAMUNDA_REST_ADDRESS: "http://localhost:8080", CAMUNDA_TRANSPORT: "auto" },
+});
+```
+
+## Build & verify
+
+```sh
+npm install
+npm run build
+npm run verify   # against a running Nano server on :8080
+```
+
+`upstream-ref/` holds the cloned upstream SDK source for reference; the published package is the thin wrapper in `src/`.

package/dist/index.cjs

@@ -0,0 +1,423 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CommandStreamTransport: () => CommandStreamTransport,
+  NanoJobWorker: () => NanoJobWorker,
+  createCamundaClient: () => createCamundaClient,
+  default: () => index_default,
+  detectNano: () => detectNano
+});
+module.exports = __toCommonJS(index_exports);
+var import_orchestration_cluster_api2 = require("@camunda8/orchestration-cluster-api");
+
+// src/detect.ts
+var cache = /* @__PURE__ */ new Map();
+function normalizeBase(url) {
+  return url.replace(/\/+$/, "");
+}
+async function detectNano(restAddress, fetchImpl = fetch) {
+  const base = normalizeBase(restAddress);
+  if (cache.has(base)) return cache.get(base) ?? null;
+  let info = null;
+  try {
+    const res = await fetchImpl(`${base}/v2/topology`, {
+      headers: { accept: "application/json" }
+    });
+    if (res.ok) {
+      const body = await res.json().catch(() => ({}));
+      const nano = body?.nano;
+      if (nano && typeof nano.commandStreamPath === "string") {
+        info = {
+          engine: String(nano.engine ?? "nanobpmn"),
+          version: nano.version ? String(nano.version) : void 0,
+          commandStreamPath: nano.commandStreamPath
+        };
+      }
+    }
+  } catch {
+    info = null;
+  }
+  cache.set(base, info);
+  return info;
+}
+function commandStreamUrl(restAddress, path) {
+  let base = normalizeBase(restAddress);
+  if (base.startsWith("https://")) base = "wss://" + base.slice("https://".length);
+  else if (base.startsWith("http://")) base = "ws://" + base.slice("http://".length);
+  return base + path;
+}
+
+// src/ws.ts
+var cached = null;
+async function getWebSocket() {
+  if (cached) return cached;
+  const g = globalThis;
+  if (typeof g.WebSocket === "function") {
+    cached = g.WebSocket;
+    return cached;
+  }
+  const mod = await import("ws");
+  cached = mod.default ?? mod.WebSocket;
+  return cached;
+}
+
+// src/transport.ts
+var CommandStreamTransport = class {
+  url;
+  ws = null;
+  open = false;
+  corr = 0;
+  pending = /* @__PURE__ */ new Map();
+  awaits = /* @__PURE__ */ new Map();
+  subs = /* @__PURE__ */ new Map();
+  heartbeat = null;
+  connectPromise = null;
+  closed = false;
+  constructor(restAddress, path) {
+    this.url = commandStreamUrl(restAddress, path);
+  }
+  nextCorr() {
+    this.corr += 1;
+    return this.corr;
+  }
+  send(frame) {
+    if (this.ws && this.open) this.ws.send(JSON.stringify(frame));
+  }
+  async connect() {
+    if (this.open) return;
+    if (this.connectPromise) return this.connectPromise;
+    this.connectPromise = new Promise((resolve, reject) => {
+      void getWebSocket().then((WS) => {
+        const ws = new WS(this.url);
+        this.ws = ws;
+        ws.onopen = () => {
+        };
+        ws.onmessage = (ev) => {
+          let f;
+          try {
+            f = JSON.parse(typeof ev.data === "string" ? ev.data : String(ev.data));
+          } catch {
+            return;
+          }
+          this.handle(f, resolve);
+        };
+        ws.onerror = () => {
+          if (!this.open) reject(new Error(`command-stream connect failed: ${this.url}`));
+        };
+        ws.onclose = () => {
+          this.open = false;
+          if (this.heartbeat) clearInterval(this.heartbeat);
+          for (const p of this.pending.values()) p.reject(new Error("command-stream closed"));
+          this.pending.clear();
+          if (!this.closed) setTimeout(() => void this.reconnect(), 1e3);
+        };
+      });
+    });
+    return this.connectPromise;
+  }
+  async reconnect() {
+    this.connectPromise = null;
+    this.open = false;
+    await this.connect();
+    for (const sub of this.subs.values()) this.sendSubscribe(sub);
+  }
+  handle(f, resolveConnect) {
+    switch (f.type) {
+      case "welcome": {
+        this.open = true;
+        const hb = Number(f.heartbeatMs ?? 0);
+        if (hb > 0) {
+          if (this.heartbeat) clearInterval(this.heartbeat);
+          this.heartbeat = setInterval(() => this.send({ type: "heartbeat" }), hb);
+        }
+        for (const sub of this.subs.values()) this.sendSubscribe(sub);
+        resolveConnect();
+        break;
+      }
+      case "job": {
+        const job = f.job ?? {};
+        const sub = this.subs.get(job.type);
+        if (sub) sub.onJob(job);
+        break;
+      }
+      case "commandResult": {
+        const corr = Number(f.corr ?? 0);
+        const p = this.pending.get(corr);
+        if (p) {
+          this.pending.delete(corr);
+          p.resolve({ status: Number(f.status ?? 0), body: f.body ?? null });
+        }
+        break;
+      }
+      case "instanceCompleted": {
+        const corr = Number(f.corr ?? 0);
+        const cb = this.awaits.get(corr);
+        if (cb) {
+          this.awaits.delete(corr);
+          cb({
+            processCompleted: Boolean(f.processCompleted),
+            variables: f.variables ?? {},
+            processInstanceKey: String(f.processInstanceKey ?? "")
+          });
+        }
+        break;
+      }
+    }
+  }
+  sendSubscribe(sub) {
+    this.send({
+      type: "subscribe",
+      jobType: sub.jobType,
+      jobCredits: sub.credits,
+      worker: sub.worker,
+      timeout: sub.timeoutMs,
+      fetchVariable: sub.fetchVariables
+    });
+  }
+  /** Create a process instance over the stream. */
+  async createInstance(input) {
+    await this.connect();
+    const corr = this.nextCorr();
+    let completionResolve = null;
+    const completion = input.awaitCompletion ? new Promise((r) => completionResolve = r) : null;
+    if (completionResolve) this.awaits.set(corr, completionResolve);
+    const result = await new Promise((resolve, reject) => {
+      this.pending.set(corr, { resolve, reject });
+      this.send({
+        type: "createInstance",
+        corr,
+        processDefinitionId: input.processDefinitionId ?? null,
+        processDefinitionKey: input.processDefinitionKey ?? null,
+        variables: input.variables ?? null,
+        awaitCompletion: input.awaitCompletion ?? false,
+        fetchVariables: input.fetchVariables ?? null,
+        requestTimeout: input.requestTimeoutMs ?? null
+      });
+    });
+    const done = completion ? await completion : void 0;
+    return { ...result, completion: done };
+  }
+  /** Subscribe a worker; jobs arrive via sub.onJob, credits replenished by ack helpers. */
+  async subscribe(sub) {
+    this.subs.set(sub.jobType, sub);
+    await this.connect();
+    this.sendSubscribe(sub);
+  }
+  unsubscribe(jobType) {
+    this.subs.delete(jobType);
+  }
+  completeJob(jobKey, variables) {
+    this.send({ type: "completeJob", corr: this.nextCorr(), jobKey, variables: variables ?? null });
+  }
+  failJob(jobKey, retries, errorMessage) {
+    this.send({ type: "failJob", corr: this.nextCorr(), jobKey, retries: retries ?? 0, errorMessage: errorMessage ?? null });
+  }
+  throwError(jobKey, errorCode, errorMessage) {
+    this.send({ type: "throwError", corr: this.nextCorr(), jobKey, errorCode, errorMessage: errorMessage ?? null });
+  }
+  grantCredits(jobType, n) {
+    this.send({ type: "jobCredits", jobType, n });
+  }
+  close() {
+    this.closed = true;
+    if (this.heartbeat) clearInterval(this.heartbeat);
+    try {
+      this.ws?.close(1e3, "shutdown");
+    } catch {
+    }
+  }
+};
+
+// src/nanoWorker.ts
+var import_orchestration_cluster_api = require("@camunda8/orchestration-cluster-api");
+var NanoJobWorker = class {
+  transport;
+  cfg;
+  credits;
+  stopped = false;
+  jobType;
+  name;
+  constructor(transport, cfg) {
+    this.transport = transport;
+    this.cfg = cfg;
+    this.jobType = cfg.jobType;
+    this.credits = cfg.maxParallelJobs ?? 10;
+    this.name = cfg.workerName || `worker-${cfg.jobType}`;
+    if (cfg.autoStart !== false) void this.start();
+  }
+  /** Bind the transport after async Nano detection. */
+  bindTransport(transport) {
+    this.transport = transport;
+  }
+  async start() {
+    this.stopped = false;
+    await this.transport.subscribe({
+      jobType: this.jobType,
+      worker: this.name,
+      credits: this.credits,
+      timeoutMs: this.cfg.jobTimeoutMs ?? 6e4,
+      fetchVariables: this.cfg.fetchVariables ?? null,
+      onJob: (raw) => void this.dispatch(raw)
+    });
+  }
+  enrich(raw) {
+    let acted = false;
+    const ack = (replenish = true) => {
+      if (!acted) {
+        acted = true;
+        if (replenish) this.transport.grantCredits(this.jobType, 1);
+      }
+    };
+    return {
+      ...raw,
+      complete: async (variables = {}) => {
+        this.transport.completeJob(raw.jobKey, variables);
+        ack();
+        return import_orchestration_cluster_api.JobActionReceiptSymbol;
+      },
+      fail: async (reason = {}) => {
+        this.transport.failJob(raw.jobKey, reason.retries, reason.errorMessage);
+        ack();
+        return import_orchestration_cluster_api.JobActionReceiptSymbol;
+      },
+      error: async (e) => {
+        this.transport.throwError(raw.jobKey, e.errorCode, e.errorMessage);
+        ack();
+        return import_orchestration_cluster_api.JobActionReceiptSymbol;
+      },
+      ignore: async () => {
+        ack();
+        return import_orchestration_cluster_api.JobActionReceiptSymbol;
+      }
+    };
+  }
+  async dispatch(raw) {
+    if (this.stopped) return;
+    const job = this.enrich(raw);
+    try {
+      await this.cfg.jobHandler(job);
+    } catch (err) {
+      try {
+        this.transport.failJob(raw.jobKey, 0, String(err));
+      } finally {
+        this.transport.grantCredits(this.jobType, 1);
+      }
+    }
+  }
+  stop() {
+    this.stopped = true;
+    this.transport.unsubscribe(this.jobType);
+  }
+  close() {
+    this.stop();
+  }
+};
+
+// src/index.ts
+__reExport(index_exports, require("@camunda8/orchestration-cluster-api"), module.exports);
+function resolveMode(opts) {
+  const fromOpts = opts?.config?.CAMUNDA_TRANSPORT;
+  const fromEnv = typeof process !== "undefined" ? process.env?.CAMUNDA_TRANSPORT : void 0;
+  return fromOpts ?? fromEnv ?? "auto";
+}
+function baseFrom(restAddress) {
+  return normalizeBase(restAddress).replace(/\/v2$/, "");
+}
+function createCamundaClient(opts) {
+  const client = (0, import_orchestration_cluster_api2.createCamundaClient)(opts);
+  const mode = resolveMode(opts);
+  if (mode === "rest") return client;
+  const restAddress = client.getConfig().restAddress;
+  const base = baseFrom(restAddress);
+  let transport = null;
+  let nano;
+  const ensure = async () => {
+    if (nano === void 0) {
+      nano = mode === "command-stream" ? { engine: "nanobpmn", commandStreamPath: "/command-stream" } : await detectNano(base);
+    }
+    if (!nano) return null;
+    if (!transport) transport = new CommandStreamTransport(base, nano.commandStreamPath);
+    return transport;
+  };
+  return new Proxy(client, {
+    get(target, prop, receiver) {
+      if (prop === "createProcessInstance") {
+        return (input, options) => {
+          const useStream = ensure();
+          return useStream.then(async (t) => {
+            if (!t) return target.createProcessInstance(input, options);
+            const r = await t.createInstance({
+              processDefinitionId: input?.processDefinitionId,
+              processDefinitionKey: input?.processDefinitionKey,
+              variables: input?.variables,
+              awaitCompletion: input?.awaitCompletion ?? false,
+              fetchVariables: input?.fetchVariables
+            });
+            if (r.status >= 400) throw new Error(`createInstance failed: ${r.status} ${JSON.stringify(r.body)}`);
+            const body = r.body ?? {};
+            return r.completion ? { ...body, variables: r.completion.variables, processInstanceKey: r.completion.processInstanceKey } : body;
+          });
+        };
+      }
+      if (prop === "createJobWorker") {
+        return (cfg) => {
+          const w = new NanoJobWorker(null, { ...cfg, autoStart: false });
+          void ensure().then((t) => {
+            if (t) {
+              w.bindTransport(t);
+              void w.start();
+            } else target.createJobWorker(cfg);
+          });
+          return w;
+        };
+      }
+      if (prop === "stopAllWorkers") {
+        return () => {
+          transport?.close();
+          return target.stopAllWorkers();
+        };
+      }
+      return Reflect.get(target, prop, receiver);
+    }
+  });
+}
+var index_default = createCamundaClient;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CommandStreamTransport,
+  NanoJobWorker,
+  createCamundaClient,
+  detectNano,
+  ...require("@camunda8/orchestration-cluster-api")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/detect.ts","../src/ws.ts","../src/transport.ts","../src/nanoWorker.ts"],"sourcesContent":["// @nanobpm/nano-sdk — a drop-in replacement for @camunda8/orchestration-cluster-api.\n//\n// It re-exports the entire upstream SDK surface, then overrides\n// `createCamundaClient` (and the default export) so that, when connected to a\n// Nano server, process-instance creation and job workers transparently upgrade\n// to Nano's command-stream protocol. Against stock Camunda 8 it is a no-op: the\n// upstream REST behaviour is used unchanged.\nimport {\n  createCamundaClient as createCamundaClientBase,\n} from \"@camunda8/orchestration-cluster-api\";\nimport { detectNano, normalizeBase, type NanoInfo } from \"./detect.js\";\nimport { CommandStreamTransport } from \"./transport.js\";\nimport { NanoJobWorker } from \"./nanoWorker.js\";\n\n// Re-export everything else so consumers can swap the import path and nothing\n// breaks.\nexport * from \"@camunda8/orchestration-cluster-api\";\nexport { detectNano, type NanoInfo } from \"./detect.js\";\nexport { CommandStreamTransport } from \"./transport.js\";\nexport { NanoJobWorker } from \"./nanoWorker.js\";\n\n/** auto: upgrade only on Nano. command-stream: force. rest: never upgrade. */\nexport type NanoTransport = \"auto\" | \"command-stream\" | \"rest\";\n\ntype AnyOpts = Parameters<typeof createCamundaClientBase>[0] & {\n  config?: Record<string, unknown> & { CAMUNDA_TRANSPORT?: NanoTransport; CAMUNDA_REST_ADDRESS?: string };\n};\n\nfunction resolveMode(opts?: AnyOpts): NanoTransport {\n  const fromOpts = opts?.config?.CAMUNDA_TRANSPORT as NanoTransport | undefined;\n  const fromEnv = (typeof process !== \"undefined\" ? process.env?.CAMUNDA_TRANSPORT : undefined) as NanoTransport | undefined;\n  return fromOpts ?? fromEnv ?? \"auto\";\n}\n\n/** restAddress is normalized by the SDK to end with /v2; strip it for base. */\nfunction baseFrom(restAddress: string): string {\n  return normalizeBase(restAddress).replace(/\\/v2$/, \"\");\n}\n\n/**\n * Drop-in replacement for the upstream createCamundaClient. Returns the upstream\n * client wrapped in a Proxy that upgrades createProcessInstance + createJobWorker\n * to the command stream when connected to a Nano server (overridable via the\n * CAMUNDA_TRANSPORT config: \"auto\" | \"command-stream\" | \"rest\").\n */\nexport function createCamundaClient(opts?: AnyOpts): ReturnType<typeof createCamundaClientBase> {\n  const client = createCamundaClientBase(opts as any);\n  const mode = resolveMode(opts);\n  if (mode === \"rest\") return client;\n\n  const restAddress = client.getConfig().restAddress;\n  const base = baseFrom(restAddress);\n\n  let transport: CommandStreamTransport | null = null;\n  let nano: NanoInfo | null | undefined; // undefined = not yet probed\n\n  const ensure = async (): Promise<CommandStreamTransport | null> => {\n    if (nano === undefined) {\n      nano = mode === \"command-stream\"\n        ? { engine: \"nanobpmn\", commandStreamPath: \"/command-stream\" }\n        : await detectNano(base);\n    }\n    if (!nano) return null;\n    if (!transport) transport = new CommandStreamTransport(base, nano.commandStreamPath);\n    return transport;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, receiver) {\n      if (prop === \"createProcessInstance\") {\n        return (input: any, options?: any) => {\n          const useStream = ensure();\n          return useStream.then(async (t) => {\n            if (!t) return (target as any).createProcessInstance(input, options);\n            const r = await t.createInstance({\n              processDefinitionId: input?.processDefinitionId,\n              processDefinitionKey: input?.processDefinitionKey,\n              variables: input?.variables,\n              awaitCompletion: input?.awaitCompletion ?? false,\n              fetchVariables: input?.fetchVariables,\n            });\n            if (r.status >= 400) throw new Error(`createInstance failed: ${r.status} ${JSON.stringify(r.body)}`);\n            const body: any = r.body ?? {};\n            return r.completion ? { ...body, variables: r.completion.variables, processInstanceKey: r.completion.processInstanceKey } : body;\n          });\n        };\n      }\n      if (prop === \"createJobWorker\") {\n        return (cfg: any) => {\n          const w = new NanoJobWorker(null as any, { ...cfg, autoStart: false });\n          void ensure().then((t) => {\n            if (t) { w.bindTransport(t); void w.start(); }\n            else (target as any).createJobWorker(cfg);\n          });\n          return w as any;\n        };\n      }\n      if (prop === \"stopAllWorkers\") {\n        return () => {\n          transport?.close();\n          return (target as any).stopAllWorkers();\n        };\n      }\n      return Reflect.get(target, prop, receiver);\n    },\n  });\n}\n\nexport default createCamundaClient;\n","// Nano server detection. A nanobpmn gateway advertises itself on GET /v2/topology\n// via a `nano` block carrying `commandStreamPath`. Detecting it lets the SDK\n// upgrade to the command-stream protocol transparently.\n\nexport interface NanoInfo {\n  engine: string;\n  version?: string;\n  commandStreamPath: string;\n}\n\nconst cache = new Map<string, NanoInfo | null>();\n\n/** Strip trailing slashes for a tidy REST base. */\nexport function normalizeBase(url: string): string {\n  return url.replace(/\\/+$/, \"\");\n}\n\n/**\n * Probes a REST address once (cached) and returns the Nano engine info if the\n * server is a nanobpmn gateway, or null for stock Camunda 8.\n */\nexport async function detectNano(\n  restAddress: string,\n  fetchImpl: typeof fetch = fetch,\n): Promise<NanoInfo | null> {\n  const base = normalizeBase(restAddress);\n  if (cache.has(base)) return cache.get(base) ?? null;\n  let info: NanoInfo | null = null;\n  try {\n    const res = await fetchImpl(`${base}/v2/topology`, {\n      headers: { accept: \"application/json\" },\n    });\n    if (res.ok) {\n      const body: any = await res.json().catch(() => ({}));\n      const nano = body?.nano;\n      if (nano && typeof nano.commandStreamPath === \"string\") {\n        info = {\n          engine: String(nano.engine ?? \"nanobpmn\"),\n          version: nano.version ? String(nano.version) : undefined,\n          commandStreamPath: nano.commandStreamPath,\n        };\n      }\n    }\n  } catch {\n    info = null; // unreachable or non-Nano: stay on REST\n  }\n  cache.set(base, info);\n  return info;\n}\n\n/** Test seam: clear the detection cache. */\nexport function _clearDetectionCache(): void {\n  cache.clear();\n}\n\n/** Build the ws:// or wss:// command-stream URL from a REST base + path. */\nexport function commandStreamUrl(restAddress: string, path: string): string {\n  let base = normalizeBase(restAddress);\n  if (base.startsWith(\"https://\")) base = \"wss://\" + base.slice(\"https://\".length);\n  else if (base.startsWith(\"http://\")) base = \"ws://\" + base.slice(\"http://\".length);\n  return base + path;\n}\n","// Picks a WebSocket implementation: native global (browser/Deno/Node>=22) or the\n// `ws` package (Node). Kept tiny so the transport stays runtime-agnostic.\nexport type WSImpl = new (url: string) => WebSocket;\n\nlet cached: WSImpl | null = null;\n\nexport async function getWebSocket(): Promise<WSImpl> {\n  if (cached) return cached;\n  const g = globalThis as { WebSocket?: WSImpl };\n  if (typeof g.WebSocket === \"function\") {\n    cached = g.WebSocket;\n    return cached;\n  }\n  const mod = await import(\"ws\");\n  cached = (mod.default ?? mod.WebSocket) as unknown as WSImpl;\n  return cached;\n}\n","// Command-stream transport. One persistent WebSocket per client multiplexes:\n//   * createInstance (corr-correlated CommandResult, awaitCompletion via\n//     InstanceCompleted), and\n//   * job subscriptions (welcome -> subscribe -> job push, replenished by\n//     jobCredits; completeJob/failJob/throwError as unmetered drains).\n// Mirrors the protocol implemented by the engine (server/src/command_stream.rs)\n// and the embedded worker SDK (server/src/console/worker_sdk.ts).\nimport { commandStreamUrl } from \"./detect.js\";\nimport { getWebSocket } from \"./ws.js\";\n\ntype Json = Record<string, unknown>;\n\nexport interface JobFrame {\n  jobKey: string;\n  type: string;\n  processInstanceKey: string;\n  variables?: Record<string, unknown>;\n  customHeaders?: Record<string, unknown>;\n  retries?: number;\n  [k: string]: unknown;\n}\n\nexport interface Subscription {\n  jobType: string;\n  worker: string;\n  credits: number;\n  timeoutMs: number;\n  fetchVariables: string[] | null;\n  onJob: (job: JobFrame) => void;\n}\n\ninterface Pending {\n  resolve: (v: { status: number; body: unknown }) => void;\n  reject: (e: unknown) => void;\n}\n\nexport class CommandStreamTransport {\n  private url: string;\n  private ws: WebSocket | null = null;\n  private open = false;\n  private corr = 0;\n  private pending = new Map<number, Pending>();\n  private awaits = new Map<number, (v: { processCompleted: boolean; variables: unknown; processInstanceKey: string }) => void>();\n  private subs = new Map<string, Subscription>();\n  private heartbeat: ReturnType<typeof setInterval> | null = null;\n  private connectPromise: Promise<void> | null = null;\n  private closed = false;\n\n  constructor(restAddress: string, path: string) {\n    this.url = commandStreamUrl(restAddress, path);\n  }\n\n  private nextCorr(): number {\n    this.corr += 1;\n    return this.corr;\n  }\n\n  private send(frame: Json): void {\n    if (this.ws && this.open) this.ws.send(JSON.stringify(frame));\n  }\n\n  async connect(): Promise<void> {\n    if (this.open) return;\n    if (this.connectPromise) return this.connectPromise;\n    this.connectPromise = new Promise<void>((resolve, reject) => {\n      void getWebSocket().then((WS) => {\n        const ws = new WS(this.url);\n        this.ws = ws;\n        ws.onopen = () => {};\n        ws.onmessage = (ev: MessageEvent) => {\n          let f: Json;\n          try {\n            f = JSON.parse(typeof ev.data === \"string\" ? ev.data : String(ev.data));\n          } catch {\n            return;\n          }\n          this.handle(f, resolve);\n        };\n        ws.onerror = () => {\n          if (!this.open) reject(new Error(`command-stream connect failed: ${this.url}`));\n        };\n        ws.onclose = () => {\n          this.open = false;\n          if (this.heartbeat) clearInterval(this.heartbeat);\n          // Reject in-flight commands; resubscribe on reconnect.\n          for (const p of this.pending.values()) p.reject(new Error(\"command-stream closed\"));\n          this.pending.clear();\n          if (!this.closed) setTimeout(() => void this.reconnect(), 1000);\n        };\n      });\n    });\n    return this.connectPromise;\n  }\n\n  private async reconnect(): Promise<void> {\n    this.connectPromise = null;\n    this.open = false;\n    await this.connect();\n    for (const sub of this.subs.values()) this.sendSubscribe(sub);\n  }\n\n  private handle(f: Json, resolveConnect: () => void): void {\n    switch (f.type) {\n      case \"welcome\": {\n        this.open = true;\n        const hb = Number(f.heartbeatMs ?? 0);\n        if (hb > 0) {\n          if (this.heartbeat) clearInterval(this.heartbeat);\n          this.heartbeat = setInterval(() => this.send({ type: \"heartbeat\" }), hb);\n        }\n        for (const sub of this.subs.values()) this.sendSubscribe(sub);\n        resolveConnect();\n        break;\n      }\n      case \"job\": {\n        const job = (f.job as JobFrame) ?? ({} as JobFrame);\n        const sub = this.subs.get(job.type);\n        if (sub) sub.onJob(job);\n        break;\n      }\n      case \"commandResult\": {\n        const corr = Number(f.corr ?? 0);\n        const p = this.pending.get(corr);\n        if (p) {\n          this.pending.delete(corr);\n          p.resolve({ status: Number(f.status ?? 0), body: f.body ?? null });\n        }\n        break;\n      }\n      case \"instanceCompleted\": {\n        const corr = Number(f.corr ?? 0);\n        const cb = this.awaits.get(corr);\n        if (cb) {\n          this.awaits.delete(corr);\n          cb({\n            processCompleted: Boolean(f.processCompleted),\n            variables: f.variables ?? {},\n            processInstanceKey: String(f.processInstanceKey ?? \"\"),\n          });\n        }\n        break;\n      }\n      // submissionCredits / pressure / heartbeat: no client action needed yet.\n    }\n  }\n\n  private sendSubscribe(sub: Subscription): void {\n    this.send({\n      type: \"subscribe\",\n      jobType: sub.jobType,\n      jobCredits: sub.credits,\n      worker: sub.worker,\n      timeout: sub.timeoutMs,\n      fetchVariable: sub.fetchVariables,\n    });\n  }\n\n  /** Create a process instance over the stream. */\n  async createInstance(input: {\n    processDefinitionId?: string;\n    processDefinitionKey?: string;\n    variables?: Record<string, unknown>;\n    awaitCompletion?: boolean;\n    fetchVariables?: string[];\n    requestTimeoutMs?: number;\n  }): Promise<{ status: number; body: unknown; completion?: { processCompleted: boolean; variables: unknown; processInstanceKey: string } }> {\n    await this.connect();\n    const corr = this.nextCorr();\n    let completionResolve: ((v: { processCompleted: boolean; variables: unknown; processInstanceKey: string }) => void) | null = null;\n    const completion = input.awaitCompletion\n      ? new Promise<{ processCompleted: boolean; variables: unknown; processInstanceKey: string }>((r) => (completionResolve = r))\n      : null;\n    if (completionResolve) this.awaits.set(corr, completionResolve);\n    const result = await new Promise<{ status: number; body: unknown }>((resolve, reject) => {\n      this.pending.set(corr, { resolve, reject });\n      this.send({\n        type: \"createInstance\",\n        corr,\n        processDefinitionId: input.processDefinitionId ?? null,\n        processDefinitionKey: input.processDefinitionKey ?? null,\n        variables: input.variables ?? null,\n        awaitCompletion: input.awaitCompletion ?? false,\n        fetchVariables: input.fetchVariables ?? null,\n        requestTimeout: input.requestTimeoutMs ?? null,\n      });\n    });\n    const done = completion ? await completion : undefined;\n    return { ...result, completion: done };\n  }\n\n  /** Subscribe a worker; jobs arrive via sub.onJob, credits replenished by ack helpers. */\n  async subscribe(sub: Subscription): Promise<void> {\n    this.subs.set(sub.jobType, sub);\n    await this.connect();\n    this.sendSubscribe(sub);\n  }\n\n  unsubscribe(jobType: string): void {\n    this.subs.delete(jobType);\n  }\n\n  completeJob(jobKey: string, variables?: Record<string, unknown>): void {\n    this.send({ type: \"completeJob\", corr: this.nextCorr(), jobKey, variables: variables ?? null });\n  }\n  failJob(jobKey: string, retries?: number, errorMessage?: string): void {\n    this.send({ type: \"failJob\", corr: this.nextCorr(), jobKey, retries: retries ?? 0, errorMessage: errorMessage ?? null });\n  }\n  throwError(jobKey: string, errorCode: string, errorMessage?: string): void {\n    this.send({ type: \"throwError\", corr: this.nextCorr(), jobKey, errorCode, errorMessage: errorMessage ?? null });\n  }\n  grantCredits(jobType: string, n: number): void {\n    this.send({ type: \"jobCredits\", jobType, n });\n  }\n\n  close(): void {\n    this.closed = true;\n    if (this.heartbeat) clearInterval(this.heartbeat);\n    try {\n      this.ws?.close(1000, \"shutdown\");\n    } catch {\n      /* ignore */\n    }\n  }\n}\n","// A drop-in JobWorker that drains jobs over the command stream. Mirrors the\n// upstream JobWorker surface (close/stop/start) but receives pushed jobs instead\n// of long-polling. Each handled job replenishes one credit, keeping demand at\n// maxParallelJobs.\nimport { JobActionReceiptSymbol as JobActionReceipt } from \"@camunda8/orchestration-cluster-api\";\nimport type { CommandStreamTransport, JobFrame } from \"./transport.js\";\n\nexport interface NanoJobWorkerConfig {\n  jobType: string;\n  workerName?: string;\n  maxParallelJobs?: number;\n  jobTimeoutMs?: number;\n  fetchVariables?: string[];\n  jobHandler: (job: any) => Promise<typeof JobActionReceipt> | typeof JobActionReceipt;\n  autoStart?: boolean;\n}\n\nexport class NanoJobWorker {\n  private transport: CommandStreamTransport;\n  private cfg: NanoJobWorkerConfig;\n  private credits: number;\n  private stopped = false;\n  readonly jobType: string;\n  readonly name: string;\n\n  constructor(transport: CommandStreamTransport, cfg: NanoJobWorkerConfig) {\n    this.transport = transport;\n    this.cfg = cfg;\n    this.jobType = cfg.jobType;\n    this.credits = cfg.maxParallelJobs ?? 10;\n    this.name = cfg.workerName || `worker-${cfg.jobType}`;\n    if (cfg.autoStart !== false) void this.start();\n  }\n\n  /** Bind the transport after async Nano detection. */\n  bindTransport(transport: CommandStreamTransport): void {\n    this.transport = transport;\n  }\n\n  async start(): Promise<void> {\n    this.stopped = false;\n    await this.transport.subscribe({\n      jobType: this.jobType,\n      worker: this.name,\n      credits: this.credits,\n      timeoutMs: this.cfg.jobTimeoutMs ?? 60_000,\n      fetchVariables: this.cfg.fetchVariables ?? null,\n      onJob: (raw) => void this.dispatch(raw),\n    });\n  }\n\n  private enrich(raw: JobFrame) {\n    let acted = false;\n    const ack = (replenish = true) => {\n      if (!acted) {\n        acted = true;\n        if (replenish) this.transport.grantCredits(this.jobType, 1);\n      }\n    };\n    return {\n      ...raw,\n      complete: async (variables: Record<string, unknown> = {}) => {\n        this.transport.completeJob(raw.jobKey, variables);\n        ack();\n        return JobActionReceipt;\n      },\n      fail: async (reason: { errorMessage?: string; retries?: number } = {}) => {\n        this.transport.failJob(raw.jobKey, reason.retries, reason.errorMessage);\n        ack();\n        return JobActionReceipt;\n      },\n      error: async (e: { errorCode: string; errorMessage?: string }) => {\n        this.transport.throwError(raw.jobKey, e.errorCode, e.errorMessage);\n        ack();\n        return JobActionReceipt;\n      },\n      ignore: async () => {\n        ack();\n        return JobActionReceipt;\n      },\n    };\n  }\n\n  private async dispatch(raw: JobFrame): Promise<void> {\n    if (this.stopped) return;\n    const job = this.enrich(raw);\n    try {\n      await this.cfg.jobHandler(job);\n    } catch (err) {\n      try {\n        this.transport.failJob(raw.jobKey, 0, String(err));\n      } finally {\n        this.transport.grantCredits(this.jobType, 1);\n      }\n    }\n  }\n\n  stop(): void {\n    this.stopped = true;\n    this.transport.unsubscribe(this.jobType);\n  }\n  close(): void {\n    this.stop();\n  }\n}\n"],"mappings":"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","names":["import_orchestration_cluster_api","JobActionReceipt","createCamundaClientBase"]}

package/dist/index.d.cts

@@ -0,0 +1,119 @@
+import { JobActionReceiptSymbol, createCamundaClient as createCamundaClient$1 } from '@camunda8/orchestration-cluster-api';
+export * from '@camunda8/orchestration-cluster-api';
+
+interface NanoInfo {
+    engine: string;
+    version?: string;
+    commandStreamPath: string;
+}
+/**
+ * Probes a REST address once (cached) and returns the Nano engine info if the
+ * server is a nanobpmn gateway, or null for stock Camunda 8.
+ */
+declare function detectNano(restAddress: string, fetchImpl?: typeof fetch): Promise<NanoInfo | null>;
+
+interface JobFrame {
+    jobKey: string;
+    type: string;
+    processInstanceKey: string;
+    variables?: Record<string, unknown>;
+    customHeaders?: Record<string, unknown>;
+    retries?: number;
+    [k: string]: unknown;
+}
+interface Subscription {
+    jobType: string;
+    worker: string;
+    credits: number;
+    timeoutMs: number;
+    fetchVariables: string[] | null;
+    onJob: (job: JobFrame) => void;
+}
+declare class CommandStreamTransport {
+    private url;
+    private ws;
+    private open;
+    private corr;
+    private pending;
+    private awaits;
+    private subs;
+    private heartbeat;
+    private connectPromise;
+    private closed;
+    constructor(restAddress: string, path: string);
+    private nextCorr;
+    private send;
+    connect(): Promise<void>;
+    private reconnect;
+    private handle;
+    private sendSubscribe;
+    /** Create a process instance over the stream. */
+    createInstance(input: {
+        processDefinitionId?: string;
+        processDefinitionKey?: string;
+        variables?: Record<string, unknown>;
+        awaitCompletion?: boolean;
+        fetchVariables?: string[];
+        requestTimeoutMs?: number;
+    }): Promise<{
+        status: number;
+        body: unknown;
+        completion?: {
+            processCompleted: boolean;
+            variables: unknown;
+            processInstanceKey: string;
+        };
+    }>;
+    /** Subscribe a worker; jobs arrive via sub.onJob, credits replenished by ack helpers. */
+    subscribe(sub: Subscription): Promise<void>;
+    unsubscribe(jobType: string): void;
+    completeJob(jobKey: string, variables?: Record<string, unknown>): void;
+    failJob(jobKey: string, retries?: number, errorMessage?: string): void;
+    throwError(jobKey: string, errorCode: string, errorMessage?: string): void;
+    grantCredits(jobType: string, n: number): void;
+    close(): void;
+}
+
+interface NanoJobWorkerConfig {
+    jobType: string;
+    workerName?: string;
+    maxParallelJobs?: number;
+    jobTimeoutMs?: number;
+    fetchVariables?: string[];
+    jobHandler: (job: any) => Promise<typeof JobActionReceiptSymbol> | typeof JobActionReceiptSymbol;
+    autoStart?: boolean;
+}
+declare class NanoJobWorker {
+    private transport;
+    private cfg;
+    private credits;
+    private stopped;
+    readonly jobType: string;
+    readonly name: string;
+    constructor(transport: CommandStreamTransport, cfg: NanoJobWorkerConfig);
+    /** Bind the transport after async Nano detection. */
+    bindTransport(transport: CommandStreamTransport): void;
+    start(): Promise<void>;
+    private enrich;
+    private dispatch;
+    stop(): void;
+    close(): void;
+}
+
+/** auto: upgrade only on Nano. command-stream: force. rest: never upgrade. */
+type NanoTransport = "auto" | "command-stream" | "rest";
+type AnyOpts = Parameters<typeof createCamundaClient$1>[0] & {
+    config?: Record<string, unknown> & {
+        CAMUNDA_TRANSPORT?: NanoTransport;
+        CAMUNDA_REST_ADDRESS?: string;
+    };
+};
+/**
+ * Drop-in replacement for the upstream createCamundaClient. Returns the upstream
+ * client wrapped in a Proxy that upgrades createProcessInstance + createJobWorker
+ * to the command stream when connected to a Nano server (overridable via the
+ * CAMUNDA_TRANSPORT config: "auto" | "command-stream" | "rest").
+ */
+declare function createCamundaClient(opts?: AnyOpts): ReturnType<typeof createCamundaClient$1>;
+
+export { CommandStreamTransport, type NanoInfo, NanoJobWorker, type NanoTransport, createCamundaClient, createCamundaClient as default, detectNano };

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+import { JobActionReceiptSymbol, createCamundaClient as createCamundaClient$1 } from '@camunda8/orchestration-cluster-api';
+export * from '@camunda8/orchestration-cluster-api';
+
+interface NanoInfo {
+    engine: string;
+    version?: string;
+    commandStreamPath: string;
+}
+/**
+ * Probes a REST address once (cached) and returns the Nano engine info if the
+ * server is a nanobpmn gateway, or null for stock Camunda 8.
+ */
+declare function detectNano(restAddress: string, fetchImpl?: typeof fetch): Promise<NanoInfo | null>;
+
+interface JobFrame {
+    jobKey: string;
+    type: string;
+    processInstanceKey: string;
+    variables?: Record<string, unknown>;
+    customHeaders?: Record<string, unknown>;
+    retries?: number;
+    [k: string]: unknown;
+}
+interface Subscription {
+    jobType: string;
+    worker: string;
+    credits: number;
+    timeoutMs: number;
+    fetchVariables: string[] | null;
+    onJob: (job: JobFrame) => void;
+}
+declare class CommandStreamTransport {
+    private url;
+    private ws;
+    private open;
+    private corr;
+    private pending;
+    private awaits;
+    private subs;
+    private heartbeat;
+    private connectPromise;
+    private closed;
+    constructor(restAddress: string, path: string);
+    private nextCorr;
+    private send;
+    connect(): Promise<void>;
+    private reconnect;
+    private handle;
+    private sendSubscribe;
+    /** Create a process instance over the stream. */
+    createInstance(input: {
+        processDefinitionId?: string;
+        processDefinitionKey?: string;
+        variables?: Record<string, unknown>;
+        awaitCompletion?: boolean;
+        fetchVariables?: string[];
+        requestTimeoutMs?: number;
+    }): Promise<{
+        status: number;
+        body: unknown;
+        completion?: {
+            processCompleted: boolean;
+            variables: unknown;
+            processInstanceKey: string;
+        };
+    }>;
+    /** Subscribe a worker; jobs arrive via sub.onJob, credits replenished by ack helpers. */
+    subscribe(sub: Subscription): Promise<void>;
+    unsubscribe(jobType: string): void;
+    completeJob(jobKey: string, variables?: Record<string, unknown>): void;
+    failJob(jobKey: string, retries?: number, errorMessage?: string): void;
+    throwError(jobKey: string, errorCode: string, errorMessage?: string): void;
+    grantCredits(jobType: string, n: number): void;
+    close(): void;
+}
+
+interface NanoJobWorkerConfig {
+    jobType: string;
+    workerName?: string;
+    maxParallelJobs?: number;
+    jobTimeoutMs?: number;
+    fetchVariables?: string[];
+    jobHandler: (job: any) => Promise<typeof JobActionReceiptSymbol> | typeof JobActionReceiptSymbol;
+    autoStart?: boolean;
+}
+declare class NanoJobWorker {
+    private transport;
+    private cfg;
+    private credits;
+    private stopped;
+    readonly jobType: string;
+    readonly name: string;
+    constructor(transport: CommandStreamTransport, cfg: NanoJobWorkerConfig);
+    /** Bind the transport after async Nano detection. */
+    bindTransport(transport: CommandStreamTransport): void;
+    start(): Promise<void>;
+    private enrich;
+    private dispatch;
+    stop(): void;
+    close(): void;
+}
+
+/** auto: upgrade only on Nano. command-stream: force. rest: never upgrade. */
+type NanoTransport = "auto" | "command-stream" | "rest";
+type AnyOpts = Parameters<typeof createCamundaClient$1>[0] & {
+    config?: Record<string, unknown> & {
+        CAMUNDA_TRANSPORT?: NanoTransport;
+        CAMUNDA_REST_ADDRESS?: string;
+    };
+};
+/**
+ * Drop-in replacement for the upstream createCamundaClient. Returns the upstream
+ * client wrapped in a Proxy that upgrades createProcessInstance + createJobWorker
+ * to the command stream when connected to a Nano server (overridable via the
+ * CAMUNDA_TRANSPORT config: "auto" | "command-stream" | "rest").
+ */
+declare function createCamundaClient(opts?: AnyOpts): ReturnType<typeof createCamundaClient$1>;
+
+export { CommandStreamTransport, type NanoInfo, NanoJobWorker, type NanoTransport, createCamundaClient, createCamundaClient as default, detectNano };

package/dist/index.js

@@ -0,0 +1,385 @@
+// src/index.ts
+import {
+  createCamundaClient as createCamundaClientBase
+} from "@camunda8/orchestration-cluster-api";
+
+// src/detect.ts
+var cache = /* @__PURE__ */ new Map();
+function normalizeBase(url) {
+  return url.replace(/\/+$/, "");
+}
+async function detectNano(restAddress, fetchImpl = fetch) {
+  const base = normalizeBase(restAddress);
+  if (cache.has(base)) return cache.get(base) ?? null;
+  let info = null;
+  try {
+    const res = await fetchImpl(`${base}/v2/topology`, {
+      headers: { accept: "application/json" }
+    });
+    if (res.ok) {
+      const body = await res.json().catch(() => ({}));
+      const nano = body?.nano;
+      if (nano && typeof nano.commandStreamPath === "string") {
+        info = {
+          engine: String(nano.engine ?? "nanobpmn"),
+          version: nano.version ? String(nano.version) : void 0,
+          commandStreamPath: nano.commandStreamPath
+        };
+      }
+    }
+  } catch {
+    info = null;
+  }
+  cache.set(base, info);
+  return info;
+}
+function commandStreamUrl(restAddress, path) {
+  let base = normalizeBase(restAddress);
+  if (base.startsWith("https://")) base = "wss://" + base.slice("https://".length);
+  else if (base.startsWith("http://")) base = "ws://" + base.slice("http://".length);
+  return base + path;
+}
+
+// src/ws.ts
+var cached = null;
+async function getWebSocket() {
+  if (cached) return cached;
+  const g = globalThis;
+  if (typeof g.WebSocket === "function") {
+    cached = g.WebSocket;
+    return cached;
+  }
+  const mod = await import("ws");
+  cached = mod.default ?? mod.WebSocket;
+  return cached;
+}
+
+// src/transport.ts
+var CommandStreamTransport = class {
+  url;
+  ws = null;
+  open = false;
+  corr = 0;
+  pending = /* @__PURE__ */ new Map();
+  awaits = /* @__PURE__ */ new Map();
+  subs = /* @__PURE__ */ new Map();
+  heartbeat = null;
+  connectPromise = null;
+  closed = false;
+  constructor(restAddress, path) {
+    this.url = commandStreamUrl(restAddress, path);
+  }
+  nextCorr() {
+    this.corr += 1;
+    return this.corr;
+  }
+  send(frame) {
+    if (this.ws && this.open) this.ws.send(JSON.stringify(frame));
+  }
+  async connect() {
+    if (this.open) return;
+    if (this.connectPromise) return this.connectPromise;
+    this.connectPromise = new Promise((resolve, reject) => {
+      void getWebSocket().then((WS) => {
+        const ws = new WS(this.url);
+        this.ws = ws;
+        ws.onopen = () => {
+        };
+        ws.onmessage = (ev) => {
+          let f;
+          try {
+            f = JSON.parse(typeof ev.data === "string" ? ev.data : String(ev.data));
+          } catch {
+            return;
+          }
+          this.handle(f, resolve);
+        };
+        ws.onerror = () => {
+          if (!this.open) reject(new Error(`command-stream connect failed: ${this.url}`));
+        };
+        ws.onclose = () => {
+          this.open = false;
+          if (this.heartbeat) clearInterval(this.heartbeat);
+          for (const p of this.pending.values()) p.reject(new Error("command-stream closed"));
+          this.pending.clear();
+          if (!this.closed) setTimeout(() => void this.reconnect(), 1e3);
+        };
+      });
+    });
+    return this.connectPromise;
+  }
+  async reconnect() {
+    this.connectPromise = null;
+    this.open = false;
+    await this.connect();
+    for (const sub of this.subs.values()) this.sendSubscribe(sub);
+  }
+  handle(f, resolveConnect) {
+    switch (f.type) {
+      case "welcome": {
+        this.open = true;
+        const hb = Number(f.heartbeatMs ?? 0);
+        if (hb > 0) {
+          if (this.heartbeat) clearInterval(this.heartbeat);
+          this.heartbeat = setInterval(() => this.send({ type: "heartbeat" }), hb);
+        }
+        for (const sub of this.subs.values()) this.sendSubscribe(sub);
+        resolveConnect();
+        break;
+      }
+      case "job": {
+        const job = f.job ?? {};
+        const sub = this.subs.get(job.type);
+        if (sub) sub.onJob(job);
+        break;
+      }
+      case "commandResult": {
+        const corr = Number(f.corr ?? 0);
+        const p = this.pending.get(corr);
+        if (p) {
+          this.pending.delete(corr);
+          p.resolve({ status: Number(f.status ?? 0), body: f.body ?? null });
+        }
+        break;
+      }
+      case "instanceCompleted": {
+        const corr = Number(f.corr ?? 0);
+        const cb = this.awaits.get(corr);
+        if (cb) {
+          this.awaits.delete(corr);
+          cb({
+            processCompleted: Boolean(f.processCompleted),
+            variables: f.variables ?? {},
+            processInstanceKey: String(f.processInstanceKey ?? "")
+          });
+        }
+        break;
+      }
+    }
+  }
+  sendSubscribe(sub) {
+    this.send({
+      type: "subscribe",
+      jobType: sub.jobType,
+      jobCredits: sub.credits,
+      worker: sub.worker,
+      timeout: sub.timeoutMs,
+      fetchVariable: sub.fetchVariables
+    });
+  }
+  /** Create a process instance over the stream. */
+  async createInstance(input) {
+    await this.connect();
+    const corr = this.nextCorr();
+    let completionResolve = null;
+    const completion = input.awaitCompletion ? new Promise((r) => completionResolve = r) : null;
+    if (completionResolve) this.awaits.set(corr, completionResolve);
+    const result = await new Promise((resolve, reject) => {
+      this.pending.set(corr, { resolve, reject });
+      this.send({
+        type: "createInstance",
+        corr,
+        processDefinitionId: input.processDefinitionId ?? null,
+        processDefinitionKey: input.processDefinitionKey ?? null,
+        variables: input.variables ?? null,
+        awaitCompletion: input.awaitCompletion ?? false,
+        fetchVariables: input.fetchVariables ?? null,
+        requestTimeout: input.requestTimeoutMs ?? null
+      });
+    });
+    const done = completion ? await completion : void 0;
+    return { ...result, completion: done };
+  }
+  /** Subscribe a worker; jobs arrive via sub.onJob, credits replenished by ack helpers. */
+  async subscribe(sub) {
+    this.subs.set(sub.jobType, sub);
+    await this.connect();
+    this.sendSubscribe(sub);
+  }
+  unsubscribe(jobType) {
+    this.subs.delete(jobType);
+  }
+  completeJob(jobKey, variables) {
+    this.send({ type: "completeJob", corr: this.nextCorr(), jobKey, variables: variables ?? null });
+  }
+  failJob(jobKey, retries, errorMessage) {
+    this.send({ type: "failJob", corr: this.nextCorr(), jobKey, retries: retries ?? 0, errorMessage: errorMessage ?? null });
+  }
+  throwError(jobKey, errorCode, errorMessage) {
+    this.send({ type: "throwError", corr: this.nextCorr(), jobKey, errorCode, errorMessage: errorMessage ?? null });
+  }
+  grantCredits(jobType, n) {
+    this.send({ type: "jobCredits", jobType, n });
+  }
+  close() {
+    this.closed = true;
+    if (this.heartbeat) clearInterval(this.heartbeat);
+    try {
+      this.ws?.close(1e3, "shutdown");
+    } catch {
+    }
+  }
+};
+
+// src/nanoWorker.ts
+import { JobActionReceiptSymbol as JobActionReceipt } from "@camunda8/orchestration-cluster-api";
+var NanoJobWorker = class {
+  transport;
+  cfg;
+  credits;
+  stopped = false;
+  jobType;
+  name;
+  constructor(transport, cfg) {
+    this.transport = transport;
+    this.cfg = cfg;
+    this.jobType = cfg.jobType;
+    this.credits = cfg.maxParallelJobs ?? 10;
+    this.name = cfg.workerName || `worker-${cfg.jobType}`;
+    if (cfg.autoStart !== false) void this.start();
+  }
+  /** Bind the transport after async Nano detection. */
+  bindTransport(transport) {
+    this.transport = transport;
+  }
+  async start() {
+    this.stopped = false;
+    await this.transport.subscribe({
+      jobType: this.jobType,
+      worker: this.name,
+      credits: this.credits,
+      timeoutMs: this.cfg.jobTimeoutMs ?? 6e4,
+      fetchVariables: this.cfg.fetchVariables ?? null,
+      onJob: (raw) => void this.dispatch(raw)
+    });
+  }
+  enrich(raw) {
+    let acted = false;
+    const ack = (replenish = true) => {
+      if (!acted) {
+        acted = true;
+        if (replenish) this.transport.grantCredits(this.jobType, 1);
+      }
+    };
+    return {
+      ...raw,
+      complete: async (variables = {}) => {
+        this.transport.completeJob(raw.jobKey, variables);
+        ack();
+        return JobActionReceipt;
+      },
+      fail: async (reason = {}) => {
+        this.transport.failJob(raw.jobKey, reason.retries, reason.errorMessage);
+        ack();
+        return JobActionReceipt;
+      },
+      error: async (e) => {
+        this.transport.throwError(raw.jobKey, e.errorCode, e.errorMessage);
+        ack();
+        return JobActionReceipt;
+      },
+      ignore: async () => {
+        ack();
+        return JobActionReceipt;
+      }
+    };
+  }
+  async dispatch(raw) {
+    if (this.stopped) return;
+    const job = this.enrich(raw);
+    try {
+      await this.cfg.jobHandler(job);
+    } catch (err) {
+      try {
+        this.transport.failJob(raw.jobKey, 0, String(err));
+      } finally {
+        this.transport.grantCredits(this.jobType, 1);
+      }
+    }
+  }
+  stop() {
+    this.stopped = true;
+    this.transport.unsubscribe(this.jobType);
+  }
+  close() {
+    this.stop();
+  }
+};
+
+// src/index.ts
+export * from "@camunda8/orchestration-cluster-api";
+function resolveMode(opts) {
+  const fromOpts = opts?.config?.CAMUNDA_TRANSPORT;
+  const fromEnv = typeof process !== "undefined" ? process.env?.CAMUNDA_TRANSPORT : void 0;
+  return fromOpts ?? fromEnv ?? "auto";
+}
+function baseFrom(restAddress) {
+  return normalizeBase(restAddress).replace(/\/v2$/, "");
+}
+function createCamundaClient(opts) {
+  const client = createCamundaClientBase(opts);
+  const mode = resolveMode(opts);
+  if (mode === "rest") return client;
+  const restAddress = client.getConfig().restAddress;
+  const base = baseFrom(restAddress);
+  let transport = null;
+  let nano;
+  const ensure = async () => {
+    if (nano === void 0) {
+      nano = mode === "command-stream" ? { engine: "nanobpmn", commandStreamPath: "/command-stream" } : await detectNano(base);
+    }
+    if (!nano) return null;
+    if (!transport) transport = new CommandStreamTransport(base, nano.commandStreamPath);
+    return transport;
+  };
+  return new Proxy(client, {
+    get(target, prop, receiver) {
+      if (prop === "createProcessInstance") {
+        return (input, options) => {
+          const useStream = ensure();
+          return useStream.then(async (t) => {
+            if (!t) return target.createProcessInstance(input, options);
+            const r = await t.createInstance({
+              processDefinitionId: input?.processDefinitionId,
+              processDefinitionKey: input?.processDefinitionKey,
+              variables: input?.variables,
+              awaitCompletion: input?.awaitCompletion ?? false,
+              fetchVariables: input?.fetchVariables
+            });
+            if (r.status >= 400) throw new Error(`createInstance failed: ${r.status} ${JSON.stringify(r.body)}`);
+            const body = r.body ?? {};
+            return r.completion ? { ...body, variables: r.completion.variables, processInstanceKey: r.completion.processInstanceKey } : body;
+          });
+        };
+      }
+      if (prop === "createJobWorker") {
+        return (cfg) => {
+          const w = new NanoJobWorker(null, { ...cfg, autoStart: false });
+          void ensure().then((t) => {
+            if (t) {
+              w.bindTransport(t);
+              void w.start();
+            } else target.createJobWorker(cfg);
+          });
+          return w;
+        };
+      }
+      if (prop === "stopAllWorkers") {
+        return () => {
+          transport?.close();
+          return target.stopAllWorkers();
+        };
+      }
+      return Reflect.get(target, prop, receiver);
+    }
+  });
+}
+var index_default = createCamundaClient;
+export {
+  CommandStreamTransport,
+  NanoJobWorker,
+  createCamundaClient,
+  index_default as default,
+  detectNano
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/detect.ts","../src/ws.ts","../src/transport.ts","../src/nanoWorker.ts"],"sourcesContent":["// @nanobpm/nano-sdk — a drop-in replacement for @camunda8/orchestration-cluster-api.\n//\n// It re-exports the entire upstream SDK surface, then overrides\n// `createCamundaClient` (and the default export) so that, when connected to a\n// Nano server, process-instance creation and job workers transparently upgrade\n// to Nano's command-stream protocol. Against stock Camunda 8 it is a no-op: the\n// upstream REST behaviour is used unchanged.\nimport {\n  createCamundaClient as createCamundaClientBase,\n} from \"@camunda8/orchestration-cluster-api\";\nimport { detectNano, normalizeBase, type NanoInfo } from \"./detect.js\";\nimport { CommandStreamTransport } from \"./transport.js\";\nimport { NanoJobWorker } from \"./nanoWorker.js\";\n\n// Re-export everything else so consumers can swap the import path and nothing\n// breaks.\nexport * from \"@camunda8/orchestration-cluster-api\";\nexport { detectNano, type NanoInfo } from \"./detect.js\";\nexport { CommandStreamTransport } from \"./transport.js\";\nexport { NanoJobWorker } from \"./nanoWorker.js\";\n\n/** auto: upgrade only on Nano. command-stream: force. rest: never upgrade. */\nexport type NanoTransport = \"auto\" | \"command-stream\" | \"rest\";\n\ntype AnyOpts = Parameters<typeof createCamundaClientBase>[0] & {\n  config?: Record<string, unknown> & { CAMUNDA_TRANSPORT?: NanoTransport; CAMUNDA_REST_ADDRESS?: string };\n};\n\nfunction resolveMode(opts?: AnyOpts): NanoTransport {\n  const fromOpts = opts?.config?.CAMUNDA_TRANSPORT as NanoTransport | undefined;\n  const fromEnv = (typeof process !== \"undefined\" ? process.env?.CAMUNDA_TRANSPORT : undefined) as NanoTransport | undefined;\n  return fromOpts ?? fromEnv ?? \"auto\";\n}\n\n/** restAddress is normalized by the SDK to end with /v2; strip it for base. */\nfunction baseFrom(restAddress: string): string {\n  return normalizeBase(restAddress).replace(/\\/v2$/, \"\");\n}\n\n/**\n * Drop-in replacement for the upstream createCamundaClient. Returns the upstream\n * client wrapped in a Proxy that upgrades createProcessInstance + createJobWorker\n * to the command stream when connected to a Nano server (overridable via the\n * CAMUNDA_TRANSPORT config: \"auto\" | \"command-stream\" | \"rest\").\n */\nexport function createCamundaClient(opts?: AnyOpts): ReturnType<typeof createCamundaClientBase> {\n  const client = createCamundaClientBase(opts as any);\n  const mode = resolveMode(opts);\n  if (mode === \"rest\") return client;\n\n  const restAddress = client.getConfig().restAddress;\n  const base = baseFrom(restAddress);\n\n  let transport: CommandStreamTransport | null = null;\n  let nano: NanoInfo | null | undefined; // undefined = not yet probed\n\n  const ensure = async (): Promise<CommandStreamTransport | null> => {\n    if (nano === undefined) {\n      nano = mode === \"command-stream\"\n        ? { engine: \"nanobpmn\", commandStreamPath: \"/command-stream\" }\n        : await detectNano(base);\n    }\n    if (!nano) return null;\n    if (!transport) transport = new CommandStreamTransport(base, nano.commandStreamPath);\n    return transport;\n  };\n\n  return new Proxy(client, {\n    get(target, prop, receiver) {\n      if (prop === \"createProcessInstance\") {\n        return (input: any, options?: any) => {\n          const useStream = ensure();\n          return useStream.then(async (t) => {\n            if (!t) return (target as any).createProcessInstance(input, options);\n            const r = await t.createInstance({\n              processDefinitionId: input?.processDefinitionId,\n              processDefinitionKey: input?.processDefinitionKey,\n              variables: input?.variables,\n              awaitCompletion: input?.awaitCompletion ?? false,\n              fetchVariables: input?.fetchVariables,\n            });\n            if (r.status >= 400) throw new Error(`createInstance failed: ${r.status} ${JSON.stringify(r.body)}`);\n            const body: any = r.body ?? {};\n            return r.completion ? { ...body, variables: r.completion.variables, processInstanceKey: r.completion.processInstanceKey } : body;\n          });\n        };\n      }\n      if (prop === \"createJobWorker\") {\n        return (cfg: any) => {\n          const w = new NanoJobWorker(null as any, { ...cfg, autoStart: false });\n          void ensure().then((t) => {\n            if (t) { w.bindTransport(t); void w.start(); }\n            else (target as any).createJobWorker(cfg);\n          });\n          return w as any;\n        };\n      }\n      if (prop === \"stopAllWorkers\") {\n        return () => {\n          transport?.close();\n          return (target as any).stopAllWorkers();\n        };\n      }\n      return Reflect.get(target, prop, receiver);\n    },\n  });\n}\n\nexport default createCamundaClient;\n","// Nano server detection. A nanobpmn gateway advertises itself on GET /v2/topology\n// via a `nano` block carrying `commandStreamPath`. Detecting it lets the SDK\n// upgrade to the command-stream protocol transparently.\n\nexport interface NanoInfo {\n  engine: string;\n  version?: string;\n  commandStreamPath: string;\n}\n\nconst cache = new Map<string, NanoInfo | null>();\n\n/** Strip trailing slashes for a tidy REST base. */\nexport function normalizeBase(url: string): string {\n  return url.replace(/\\/+$/, \"\");\n}\n\n/**\n * Probes a REST address once (cached) and returns the Nano engine info if the\n * server is a nanobpmn gateway, or null for stock Camunda 8.\n */\nexport async function detectNano(\n  restAddress: string,\n  fetchImpl: typeof fetch = fetch,\n): Promise<NanoInfo | null> {\n  const base = normalizeBase(restAddress);\n  if (cache.has(base)) return cache.get(base) ?? null;\n  let info: NanoInfo | null = null;\n  try {\n    const res = await fetchImpl(`${base}/v2/topology`, {\n      headers: { accept: \"application/json\" },\n    });\n    if (res.ok) {\n      const body: any = await res.json().catch(() => ({}));\n      const nano = body?.nano;\n      if (nano && typeof nano.commandStreamPath === \"string\") {\n        info = {\n          engine: String(nano.engine ?? \"nanobpmn\"),\n          version: nano.version ? String(nano.version) : undefined,\n          commandStreamPath: nano.commandStreamPath,\n        };\n      }\n    }\n  } catch {\n    info = null; // unreachable or non-Nano: stay on REST\n  }\n  cache.set(base, info);\n  return info;\n}\n\n/** Test seam: clear the detection cache. */\nexport function _clearDetectionCache(): void {\n  cache.clear();\n}\n\n/** Build the ws:// or wss:// command-stream URL from a REST base + path. */\nexport function commandStreamUrl(restAddress: string, path: string): string {\n  let base = normalizeBase(restAddress);\n  if (base.startsWith(\"https://\")) base = \"wss://\" + base.slice(\"https://\".length);\n  else if (base.startsWith(\"http://\")) base = \"ws://\" + base.slice(\"http://\".length);\n  return base + path;\n}\n","// Picks a WebSocket implementation: native global (browser/Deno/Node>=22) or the\n// `ws` package (Node). Kept tiny so the transport stays runtime-agnostic.\nexport type WSImpl = new (url: string) => WebSocket;\n\nlet cached: WSImpl | null = null;\n\nexport async function getWebSocket(): Promise<WSImpl> {\n  if (cached) return cached;\n  const g = globalThis as { WebSocket?: WSImpl };\n  if (typeof g.WebSocket === \"function\") {\n    cached = g.WebSocket;\n    return cached;\n  }\n  const mod = await import(\"ws\");\n  cached = (mod.default ?? mod.WebSocket) as unknown as WSImpl;\n  return cached;\n}\n","// Command-stream transport. One persistent WebSocket per client multiplexes:\n//   * createInstance (corr-correlated CommandResult, awaitCompletion via\n//     InstanceCompleted), and\n//   * job subscriptions (welcome -> subscribe -> job push, replenished by\n//     jobCredits; completeJob/failJob/throwError as unmetered drains).\n// Mirrors the protocol implemented by the engine (server/src/command_stream.rs)\n// and the embedded worker SDK (server/src/console/worker_sdk.ts).\nimport { commandStreamUrl } from \"./detect.js\";\nimport { getWebSocket } from \"./ws.js\";\n\ntype Json = Record<string, unknown>;\n\nexport interface JobFrame {\n  jobKey: string;\n  type: string;\n  processInstanceKey: string;\n  variables?: Record<string, unknown>;\n  customHeaders?: Record<string, unknown>;\n  retries?: number;\n  [k: string]: unknown;\n}\n\nexport interface Subscription {\n  jobType: string;\n  worker: string;\n  credits: number;\n  timeoutMs: number;\n  fetchVariables: string[] | null;\n  onJob: (job: JobFrame) => void;\n}\n\ninterface Pending {\n  resolve: (v: { status: number; body: unknown }) => void;\n  reject: (e: unknown) => void;\n}\n\nexport class CommandStreamTransport {\n  private url: string;\n  private ws: WebSocket | null = null;\n  private open = false;\n  private corr = 0;\n  private pending = new Map<number, Pending>();\n  private awaits = new Map<number, (v: { processCompleted: boolean; variables: unknown; processInstanceKey: string }) => void>();\n  private subs = new Map<string, Subscription>();\n  private heartbeat: ReturnType<typeof setInterval> | null = null;\n  private connectPromise: Promise<void> | null = null;\n  private closed = false;\n\n  constructor(restAddress: string, path: string) {\n    this.url = commandStreamUrl(restAddress, path);\n  }\n\n  private nextCorr(): number {\n    this.corr += 1;\n    return this.corr;\n  }\n\n  private send(frame: Json): void {\n    if (this.ws && this.open) this.ws.send(JSON.stringify(frame));\n  }\n\n  async connect(): Promise<void> {\n    if (this.open) return;\n    if (this.connectPromise) return this.connectPromise;\n    this.connectPromise = new Promise<void>((resolve, reject) => {\n      void getWebSocket().then((WS) => {\n        const ws = new WS(this.url);\n        this.ws = ws;\n        ws.onopen = () => {};\n        ws.onmessage = (ev: MessageEvent) => {\n          let f: Json;\n          try {\n            f = JSON.parse(typeof ev.data === \"string\" ? ev.data : String(ev.data));\n          } catch {\n            return;\n          }\n          this.handle(f, resolve);\n        };\n        ws.onerror = () => {\n          if (!this.open) reject(new Error(`command-stream connect failed: ${this.url}`));\n        };\n        ws.onclose = () => {\n          this.open = false;\n          if (this.heartbeat) clearInterval(this.heartbeat);\n          // Reject in-flight commands; resubscribe on reconnect.\n          for (const p of this.pending.values()) p.reject(new Error(\"command-stream closed\"));\n          this.pending.clear();\n          if (!this.closed) setTimeout(() => void this.reconnect(), 1000);\n        };\n      });\n    });\n    return this.connectPromise;\n  }\n\n  private async reconnect(): Promise<void> {\n    this.connectPromise = null;\n    this.open = false;\n    await this.connect();\n    for (const sub of this.subs.values()) this.sendSubscribe(sub);\n  }\n\n  private handle(f: Json, resolveConnect: () => void): void {\n    switch (f.type) {\n      case \"welcome\": {\n        this.open = true;\n        const hb = Number(f.heartbeatMs ?? 0);\n        if (hb > 0) {\n          if (this.heartbeat) clearInterval(this.heartbeat);\n          this.heartbeat = setInterval(() => this.send({ type: \"heartbeat\" }), hb);\n        }\n        for (const sub of this.subs.values()) this.sendSubscribe(sub);\n        resolveConnect();\n        break;\n      }\n      case \"job\": {\n        const job = (f.job as JobFrame) ?? ({} as JobFrame);\n        const sub = this.subs.get(job.type);\n        if (sub) sub.onJob(job);\n        break;\n      }\n      case \"commandResult\": {\n        const corr = Number(f.corr ?? 0);\n        const p = this.pending.get(corr);\n        if (p) {\n          this.pending.delete(corr);\n          p.resolve({ status: Number(f.status ?? 0), body: f.body ?? null });\n        }\n        break;\n      }\n      case \"instanceCompleted\": {\n        const corr = Number(f.corr ?? 0);\n        const cb = this.awaits.get(corr);\n        if (cb) {\n          this.awaits.delete(corr);\n          cb({\n            processCompleted: Boolean(f.processCompleted),\n            variables: f.variables ?? {},\n            processInstanceKey: String(f.processInstanceKey ?? \"\"),\n          });\n        }\n        break;\n      }\n      // submissionCredits / pressure / heartbeat: no client action needed yet.\n    }\n  }\n\n  private sendSubscribe(sub: Subscription): void {\n    this.send({\n      type: \"subscribe\",\n      jobType: sub.jobType,\n      jobCredits: sub.credits,\n      worker: sub.worker,\n      timeout: sub.timeoutMs,\n      fetchVariable: sub.fetchVariables,\n    });\n  }\n\n  /** Create a process instance over the stream. */\n  async createInstance(input: {\n    processDefinitionId?: string;\n    processDefinitionKey?: string;\n    variables?: Record<string, unknown>;\n    awaitCompletion?: boolean;\n    fetchVariables?: string[];\n    requestTimeoutMs?: number;\n  }): Promise<{ status: number; body: unknown; completion?: { processCompleted: boolean; variables: unknown; processInstanceKey: string } }> {\n    await this.connect();\n    const corr = this.nextCorr();\n    let completionResolve: ((v: { processCompleted: boolean; variables: unknown; processInstanceKey: string }) => void) | null = null;\n    const completion = input.awaitCompletion\n      ? new Promise<{ processCompleted: boolean; variables: unknown; processInstanceKey: string }>((r) => (completionResolve = r))\n      : null;\n    if (completionResolve) this.awaits.set(corr, completionResolve);\n    const result = await new Promise<{ status: number; body: unknown }>((resolve, reject) => {\n      this.pending.set(corr, { resolve, reject });\n      this.send({\n        type: \"createInstance\",\n        corr,\n        processDefinitionId: input.processDefinitionId ?? null,\n        processDefinitionKey: input.processDefinitionKey ?? null,\n        variables: input.variables ?? null,\n        awaitCompletion: input.awaitCompletion ?? false,\n        fetchVariables: input.fetchVariables ?? null,\n        requestTimeout: input.requestTimeoutMs ?? null,\n      });\n    });\n    const done = completion ? await completion : undefined;\n    return { ...result, completion: done };\n  }\n\n  /** Subscribe a worker; jobs arrive via sub.onJob, credits replenished by ack helpers. */\n  async subscribe(sub: Subscription): Promise<void> {\n    this.subs.set(sub.jobType, sub);\n    await this.connect();\n    this.sendSubscribe(sub);\n  }\n\n  unsubscribe(jobType: string): void {\n    this.subs.delete(jobType);\n  }\n\n  completeJob(jobKey: string, variables?: Record<string, unknown>): void {\n    this.send({ type: \"completeJob\", corr: this.nextCorr(), jobKey, variables: variables ?? null });\n  }\n  failJob(jobKey: string, retries?: number, errorMessage?: string): void {\n    this.send({ type: \"failJob\", corr: this.nextCorr(), jobKey, retries: retries ?? 0, errorMessage: errorMessage ?? null });\n  }\n  throwError(jobKey: string, errorCode: string, errorMessage?: string): void {\n    this.send({ type: \"throwError\", corr: this.nextCorr(), jobKey, errorCode, errorMessage: errorMessage ?? null });\n  }\n  grantCredits(jobType: string, n: number): void {\n    this.send({ type: \"jobCredits\", jobType, n });\n  }\n\n  close(): void {\n    this.closed = true;\n    if (this.heartbeat) clearInterval(this.heartbeat);\n    try {\n      this.ws?.close(1000, \"shutdown\");\n    } catch {\n      /* ignore */\n    }\n  }\n}\n","// A drop-in JobWorker that drains jobs over the command stream. Mirrors the\n// upstream JobWorker surface (close/stop/start) but receives pushed jobs instead\n// of long-polling. Each handled job replenishes one credit, keeping demand at\n// maxParallelJobs.\nimport { JobActionReceiptSymbol as JobActionReceipt } from \"@camunda8/orchestration-cluster-api\";\nimport type { CommandStreamTransport, JobFrame } from \"./transport.js\";\n\nexport interface NanoJobWorkerConfig {\n  jobType: string;\n  workerName?: string;\n  maxParallelJobs?: number;\n  jobTimeoutMs?: number;\n  fetchVariables?: string[];\n  jobHandler: (job: any) => Promise<typeof JobActionReceipt> | typeof JobActionReceipt;\n  autoStart?: boolean;\n}\n\nexport class NanoJobWorker {\n  private transport: CommandStreamTransport;\n  private cfg: NanoJobWorkerConfig;\n  private credits: number;\n  private stopped = false;\n  readonly jobType: string;\n  readonly name: string;\n\n  constructor(transport: CommandStreamTransport, cfg: NanoJobWorkerConfig) {\n    this.transport = transport;\n    this.cfg = cfg;\n    this.jobType = cfg.jobType;\n    this.credits = cfg.maxParallelJobs ?? 10;\n    this.name = cfg.workerName || `worker-${cfg.jobType}`;\n    if (cfg.autoStart !== false) void this.start();\n  }\n\n  /** Bind the transport after async Nano detection. */\n  bindTransport(transport: CommandStreamTransport): void {\n    this.transport = transport;\n  }\n\n  async start(): Promise<void> {\n    this.stopped = false;\n    await this.transport.subscribe({\n      jobType: this.jobType,\n      worker: this.name,\n      credits: this.credits,\n      timeoutMs: this.cfg.jobTimeoutMs ?? 60_000,\n      fetchVariables: this.cfg.fetchVariables ?? null,\n      onJob: (raw) => void this.dispatch(raw),\n    });\n  }\n\n  private enrich(raw: JobFrame) {\n    let acted = false;\n    const ack = (replenish = true) => {\n      if (!acted) {\n        acted = true;\n        if (replenish) this.transport.grantCredits(this.jobType, 1);\n      }\n    };\n    return {\n      ...raw,\n      complete: async (variables: Record<string, unknown> = {}) => {\n        this.transport.completeJob(raw.jobKey, variables);\n        ack();\n        return JobActionReceipt;\n      },\n      fail: async (reason: { errorMessage?: string; retries?: number } = {}) => {\n        this.transport.failJob(raw.jobKey, reason.retries, reason.errorMessage);\n        ack();\n        return JobActionReceipt;\n      },\n      error: async (e: { errorCode: string; errorMessage?: string }) => {\n        this.transport.throwError(raw.jobKey, e.errorCode, e.errorMessage);\n        ack();\n        return JobActionReceipt;\n      },\n      ignore: async () => {\n        ack();\n        return JobActionReceipt;\n      },\n    };\n  }\n\n  private async dispatch(raw: JobFrame): Promise<void> {\n    if (this.stopped) return;\n    const job = this.enrich(raw);\n    try {\n      await this.cfg.jobHandler(job);\n    } catch (err) {\n      try {\n        this.transport.failJob(raw.jobKey, 0, String(err));\n      } finally {\n        this.transport.grantCredits(this.jobType, 1);\n      }\n    }\n  }\n\n  stop(): void {\n    this.stopped = true;\n    this.transport.unsubscribe(this.jobType);\n  }\n  close(): void {\n    this.stop();\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@nanobpm/nano-sdk",
+  "version": "1.0.0",
+  "description": "Drop-in replacement for @camunda8/orchestration-cluster-api that upgrades to the Nano command-stream protocol when connected to a Nano server.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jwulf/nano-sdk-js.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "verify": "node scripts/verify.mjs"
+  },
+  "dependencies": {
+    "@camunda8/orchestration-cluster-api": "10.0.0-alpha.13",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.5.10",
+    "semantic-release": "^25.0.5",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}