@compozy/client 0.0.0-stage → 0.3.0-beta.36

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NauckGroup LTDA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# @compozy/client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A zero-dependency TypeScript client for applications built on CompozyOS. Supports Node 18+, Bun,
+Deno, browsers, and edge runtimes. The daemon remains a separate service.
+
+> Experimental in this release: names and shapes may change in the next release without a deprecation window. Pin the exact version.
+
+```ts
+import { Compozy } from "@compozy/client";
+
+const compozy = await Compozy.connect();
+const { workspace } = await compozy.workspaces.resolveWorkspace({ body: { path: process.cwd() } });
+const { session } = await compozy.sessions.createSession({
+  body: { workspace: workspace.id, agent_name: "claude" },
+});
+const reply = await compozy.prompt({
+  workspaceId: workspace.id,
+  sessionId: session.id,
+  message: "Summarize this repository.",
+});
+if (reply.kind === "stream") {
+  for await (const chunk of reply.chunks) {
+    if (chunk.type === "text-delta") process.stdout.write(chunk.delta);
+  }
+}
+```
+
+Node discovery checks `baseUrl`, `COMPOZY_URL`, the `daemon.json` in `home`/`COMPOZY_HOME`/`~/.compozy`,
+then `http://127.0.0.1:2123`. Browsers default to `http://localhost:2123`. Pass `token` for an app token;
+Node also reads `COMPOZY_APP_TOKEN`. All operations accept an abort signal.
+
+Use `promptResponse()` in a server route to forward the AI SDK UI message stream unchanged. Read
+other SSE operations through `events(operationId, options)`, which reconnects with `Last-Event-ID`
+after network or server failures. Client errors stop immediately; 20 consecutive failures stop the
+stream. Aborting a prompt stops reading without canceling the daemon's turn.
+
+Prompt helpers generate a command identity when `idempotencyKey` is omitted. Supply the same key
+when retrying the same input to preserve its message identity and replay the daemon's receipt.
+
+The Node-only `@compozy/client/node` entry adds `Compozy.start({ home })` and
+`close({ stopDaemon: true })`. It only stops the daemon this instance started while the same home
+still names the owned process. Shutdown signals the retained child handle and waits for its exit,
+so a daemon that replaces it cannot become the stop target. The main browser entry contains no Node modules.
+
+Generated resource methods cover JSON operations. Exported `paths`, `operations`, `components`, and
+`Operation*` helpers also work with other HTTP clients. There is no dependency on React or `ai`.
+
+See [Build an app](https://compozy.com/docs/apps), [chat UI](https://compozy.com/docs/apps/chat-ui), and
+[browser access](https://compozy.com/docs/apps/browser) for tutorials and API reference samples.

package/dist/cjs/browser-discovery.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discover = discover;
+const errors_js_1 = require("./errors.js");
+/** Replaces Node discovery in browser bundles; this module never reads process or files. */
+async function discover(options) {
+    const value = options.baseUrl ?? "http://localhost:2123";
+    try {
+        const url = new URL(value);
+        if (!["http:", "https:"].includes(url.protocol) ||
+            url.username ||
+            url.password ||
+            url.search ||
+            url.hash) {
+            throw new Error("expected an HTTP(S) URL without credentials, query, or fragment");
+        }
+        return { baseUrl: url.href.replace(/\/$/, "") };
+    }
+    catch (cause) {
+        throw new errors_js_1.CompozyConfigError("Invalid baseUrl: expected an absolute HTTP(S) URL", { cause });
+    }
+}
+//# sourceMappingURL=browser-discovery.js.map

package/dist/cjs/browser-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-discovery.js","sourceRoot":"","sources":["../../src/browser-discovery.ts"],"names":[],"mappings":";;;AAAA,2CAAiD;AAEjD,4FAA4F;AACrF,KAAK,mBAAmB,OAG9B;IACC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,IAAI,uBAAuB,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,IACE,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC3C,GAAG,CAAC,QAAQ;YACZ,GAAG,CAAC,QAAQ;YACZ,GAAG,CAAC,MAAM;YACV,GAAG,CAAC,IAAI,EACR,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,8BAAkB,CAAC,mDAAmD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC"}

package/dist/cjs/client.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Compozy = void 0;
+const browser_discovery_js_1 = require("./browser-discovery.js");
+const connect_js_1 = require("./connect.js");
+const errors_js_1 = require("./errors.js");
+const events_js_1 = require("./events.js");
+const index_js_1 = require("./generated/sdk/client/index.js");
+const sdk_gen_js_1 = require("./generated/sdk/sdk.gen.js");
+const prompt_js_1 = require("./prompt.js");
+/** Public application client. Construct a connected instance with Compozy.connect(). */
+class Compozy extends sdk_gen_js_1.Compozy {
+    static discovery = browser_discovery_js_1.discover;
+    createPromptId = prompt_js_1.createPromptId;
+    daemon;
+    state;
+    constructor(state) {
+        const client = (0, index_js_1.createClient)({
+            baseUrl: state.baseUrl,
+            headers: state.headers,
+            fetch: state.fetch,
+            throwOnError: true,
+            responseStyle: "data",
+        });
+        client.interceptors.error.use((error, response) => {
+            if (error instanceof Error)
+                return error;
+            return response ? new errors_js_1.CompozyApiError(response.status, error, response.statusText) : error;
+        });
+        super({ client });
+        this.state = state;
+        this.daemon = state.daemon;
+    }
+    static connection(options) {
+        return (0, connect_js_1.connect)(options, this.discovery);
+    }
+    static async connect(options = {}) {
+        return new this(await this.connection(options));
+    }
+    prompt(input) {
+        return (0, prompt_js_1.prompt)(this.state, input, this.createPromptId);
+    }
+    promptResponse(input) {
+        return (0, prompt_js_1.promptResponse)(this.state, input, this.createPromptId);
+    }
+    events(operationId, options) {
+        return (0, events_js_1.events)(this.state, operationId, options);
+    }
+}
+exports.Compozy = Compozy;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;;AAAA,iEAAkD;AAClD,6CAMsB;AACtB,2CAA8C;AAC9C,2CAMqB;AACrB,8DAA+D;AAC/D,2DAAyE;AACzE,2CAMqB;AAIrB,wFAAwF;AACxF,aAAqB,SAAQ,oBAAgB;IACjC,MAAM,CAAC,SAAS,GAAc,+BAAQ,CAAC;IACvC,cAAc,GAAG,0BAAc,CAAC;IACjC,MAAM,CAAiB;IACb,KAAK,CAAiB;IAEzC,YAAsB,KAAqB;QACzC,MAAM,MAAM,GAAG,IAAA,uBAAY,EAAC;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,MAAM;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAChD,IAAI,KAAK,YAAY,KAAK;gBAAE,OAAO,KAAK,CAAC;YACzC,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,2BAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7F,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAES,MAAM,CAAC,UAAU,CAAC,OAAuB;QACjD,OAAO,IAAA,oBAAO,EAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,GAAmB,EAAE;QAC/C,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,KAAkB;QACvB,OAAO,IAAA,kBAAM,EAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACxD,CAAC;IAED,cAAc,CAAC,KAAkB;QAC/B,OAAO,IAAA,0BAAc,EAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CACJ,WAAe,EACf,OAAuB;QAEvB,OAAO,IAAA,kBAAM,EAAC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/cjs/connect.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connect = connect;
+exports.checkVersion = checkVersion;
+const errors_js_1 = require("./errors.js");
+const version_js_1 = require("./version.js");
+async function connect(options, discover) {
+    const target = await discover(options);
+    const timeoutMs = options.timeoutMs ?? 5000;
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new errors_js_1.CompozyConfigError("connect timeoutMs must be a positive number.");
+    }
+    const headers = new Headers({ "X-Compozy-Client-ID": options.clientId ?? "sdk-ts" });
+    const token = options.token ?? target.token;
+    if (token)
+        headers.set("Authorization", `Bearer ${token}`);
+    const transport = options.fetch ?? globalThis.fetch;
+    if (!transport)
+        throw new errors_js_1.CompozyConfigError("This runtime must provide fetch or a fetch option.");
+    const fetch = async (input, init) => {
+        try {
+            return await transport(input, init);
+        }
+        catch (cause) {
+            if (init?.signal?.aborted || (input instanceof Request && input.signal.aborted))
+                throw cause;
+            throw new errors_js_1.CompozyUnavailableError("CompozyOS daemon is unavailable. Run `compozy daemon start`.", { cause });
+        }
+    };
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(`${target.baseUrl}/api/status/identity`, {
+            headers,
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            throw await (0, errors_js_1.responseError)(response);
+        const identity = decodeIdentity(await response.json());
+        checkVersion(identity.version, options.onVersionMismatch);
+        return { baseUrl: target.baseUrl, headers, fetch, daemon: identity };
+    }
+    catch (cause) {
+        if (cause instanceof errors_js_1.CompozyApiError || cause instanceof errors_js_1.CompozyConfigError)
+            throw cause;
+        throw new errors_js_1.CompozyUnavailableError("CompozyOS daemon is unavailable. Run `compozy daemon start`.", { cause });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function decodeIdentity(body) {
+    if (!body ||
+        typeof body !== "object" ||
+        !("daemon" in body) ||
+        !body.daemon ||
+        typeof body.daemon !== "object") {
+        throw new errors_js_1.CompozyConfigError("Daemon identity response is invalid.");
+    }
+    const daemon = body.daemon;
+    if (typeof daemon.version !== "string" ||
+        typeof daemon.http_host !== "string" ||
+        typeof daemon.http_port !== "number" ||
+        typeof daemon.pid !== "number") {
+        throw new errors_js_1.CompozyConfigError("Daemon identity response is missing its version or listener identity.");
+    }
+    return {
+        version: daemon.version,
+        httpHost: daemon.http_host,
+        httpPort: daemon.http_port,
+        pid: daemon.pid,
+        userHomeDir: typeof daemon.user_home_dir === "string" ? daemon.user_home_dir : "",
+        startedAt: typeof daemon.started_at === "string" ? daemon.started_at : "",
+    };
+}
+function checkVersion(daemon, onMismatch, client = version_js_1.CLIENT_VERSION) {
+    if (!client || !daemon || client === "0.0.0-dev" || daemon === "0.0.0-dev")
+        return;
+    const majorMinor = (version) => /^v?(\d+)\.(\d+)(?:\.|$)/.exec(version)?.slice(1).join(".");
+    const clientVersion = majorMinor(client);
+    const daemonVersion = majorMinor(daemon);
+    if (!clientVersion || !daemonVersion || clientVersion === daemonVersion)
+        return;
+    (onMismatch ??
+        (versions => console.warn(`CompozyOS client ${versions.client} differs from daemon ${versions.daemon}.`)))({ client, daemon });
+}
+//# sourceMappingURL=connect.js.map

package/dist/cjs/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/connect.ts"],"names":[],"mappings":"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"}

package/dist/cjs/errors.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompozyBinaryNotFoundError = exports.CompozyStreamError = exports.CompozyConfigError = exports.CompozyUnavailableError = exports.CompozyApiError = void 0;
+exports.responseError = responseError;
+/** The daemon returned an HTTP error. Secrets and request headers are never retained. */
+class CompozyApiError extends Error {
+    status;
+    code;
+    details;
+    currentTurnId;
+    constructor(status, body, statusText = "") {
+        const payload = body !== null && typeof body === "object" ? body : {};
+        const field = (key) => {
+            const value = Reflect.get(payload, key);
+            return typeof value === "string" && value.length > 0 ? value : undefined;
+        };
+        super(field("error") ?? field("message") ?? (statusText || `HTTP ${status}`));
+        this.name = "CompozyApiError";
+        this.status = status;
+        this.code = field("code") ?? `http_${status}`;
+        this.details = Reflect.get(payload, "details");
+        this.currentTurnId = field("current_turn_id");
+    }
+}
+exports.CompozyApiError = CompozyApiError;
+class CompozyUnavailableError extends Error {
+    name = "CompozyUnavailableError";
+}
+exports.CompozyUnavailableError = CompozyUnavailableError;
+class CompozyConfigError extends Error {
+    name = "CompozyConfigError";
+}
+exports.CompozyConfigError = CompozyConfigError;
+class CompozyStreamError extends Error {
+    name = "CompozyStreamError";
+}
+exports.CompozyStreamError = CompozyStreamError;
+class CompozyBinaryNotFoundError extends Error {
+    name = "CompozyBinaryNotFoundError";
+}
+exports.CompozyBinaryNotFoundError = CompozyBinaryNotFoundError;
+async function responseError(response) {
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        // A proxy's non-JSON error still has a useful HTTP status.
+    }
+    return new CompozyApiError(response.status, body, response.statusText);
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;;AAAA,yFAAyF;AACzF,qBAA6B,SAAQ,KAAK;IAC/B,MAAM,CAAS;IACf,IAAI,CAAS;IACb,OAAO,CAAU;IACjB,aAAa,CAAqB;IAE3C,YAAY,MAAc,EAAE,IAAa,EAAE,UAAU,GAAG,EAAE;QACxD,MAAM,OAAO,GAAG,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,KAAK,GAAG,CAAC,GAAW,EAAsB,EAAE;YAChD,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,CAAC,CAAC;QACF,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,IAAI,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,QAAQ,MAAM,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAChD,CAAC;CACF;;AAED,6BAAqC,SAAQ,KAAK;IACvC,IAAI,GAAG,yBAAyB,CAAC;CAC3C;;AAED,wBAAgC,SAAQ,KAAK;IAClC,IAAI,GAAG,oBAAoB,CAAC;CACtC;;AAED,wBAAgC,SAAQ,KAAK;IAClC,IAAI,GAAG,oBAAoB,CAAC;CACtC;;AAED,gCAAwC,SAAQ,KAAK;IAC1C,IAAI,GAAG,4BAA4B,CAAC;CAC9C;;AAEM,KAAK,wBAAwB,QAAkB;IACpD,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;IACD,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;AACzE,CAAC"}

package/dist/cjs/events.js

@@ -0,0 +1,173 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.events = events;
+const errors_js_1 = require("./errors.js");
+const index_js_1 = require("./generated/sse/client/index.js");
+const operations = __importStar(require("./generated/sse/sdk.gen.js"));
+/** All event feeds use the same bounded reconnect and typed-error policy. */
+async function* events(state, operationId, options) {
+    const signal = options.signal ?? undefined;
+    let failures = 0;
+    let delay = 500;
+    let lastEventId;
+    let transcriptFence;
+    const transcriptStream = operationId === "streamSession" || operationId === "streamGlobalSession";
+    while (!signal?.aborted) {
+        const controller = new AbortController();
+        const abort = () => controller.abort();
+        signal?.addEventListener("abort", abort, { once: true });
+        if (signal?.aborted)
+            abort();
+        let failure;
+        let parsedJSON = false;
+        let receivedFrame = false;
+        let frame;
+        let activeStream;
+        const headers = new Headers(state.headers);
+        headers.set("Accept", "text/event-stream");
+        if (lastEventId !== undefined)
+            headers.set("Last-Event-ID", lastEventId);
+        const client = (0, index_js_1.createClient)({
+            baseUrl: state.baseUrl,
+            headers,
+            fetch: async (input, init) => {
+                let request = new Request(input, init);
+                if (transcriptStream && transcriptFence) {
+                    const url = new URL(request.url);
+                    url.searchParams.set("epoch", String(transcriptFence.epoch));
+                    url.searchParams.set("generation", String(transcriptFence.generation));
+                    request = new Request(url, request);
+                }
+                const response = await state.fetch(request);
+                if (!response.ok)
+                    throw await (0, errors_js_1.responseError)(response);
+                return response;
+            },
+        });
+        try {
+            // The operation id and its path/query remain correlated at the public boundary.
+            const invoke = operations[operationId];
+            const result = await invoke({
+                ...options,
+                client,
+                signal: controller.signal,
+                sseMaxRetryAttempts: 1,
+                responseValidator: () => {
+                    parsedJSON = true;
+                    return Promise.resolve();
+                },
+                onSseEvent: received => {
+                    if (received.id !== undefined)
+                        lastEventId = received.id;
+                    if (received.data === undefined)
+                        return;
+                    if (!parsedJSON)
+                        throw new errors_js_1.CompozyStreamError(`Malformed JSON frame from ${operationId}.`);
+                    parsedJSON = false;
+                    if (transcriptStream &&
+                        (received.event === "transcript_snapshot" || received.event === "transcript_delta") &&
+                        received.data &&
+                        typeof received.data === "object" &&
+                        "epoch" in received.data &&
+                        "generation" in received.data &&
+                        typeof received.data.epoch === "number" &&
+                        Number.isInteger(received.data.epoch) &&
+                        received.data.epoch >= 0 &&
+                        typeof received.data.generation === "number" &&
+                        Number.isInteger(received.data.generation) &&
+                        received.data.generation >= 0) {
+                        transcriptFence = { epoch: received.data.epoch, generation: received.data.generation };
+                    }
+                    receivedFrame = true;
+                    failures = 0;
+                    delay = 500;
+                    frame = {
+                        data: received.data,
+                        ...(received.event !== undefined && { event: received.event }),
+                        ...(received.id !== undefined && { id: received.id }),
+                    };
+                },
+                onSseError: error => {
+                    failure = error;
+                    controller.abort();
+                },
+            });
+            activeStream = result.stream;
+            for await (const _data of activeStream) {
+                if (signal?.aborted)
+                    return;
+                if (frame) {
+                    yield frame;
+                    frame = undefined;
+                }
+            }
+        }
+        catch (error) {
+            failure = error;
+        }
+        finally {
+            controller.abort();
+            signal?.removeEventListener("abort", abort);
+            await activeStream?.return(undefined);
+        }
+        if (signal?.aborted)
+            return;
+        if (failure instanceof errors_js_1.CompozyStreamError ||
+            (failure instanceof errors_js_1.CompozyApiError && failure.status >= 400 && failure.status < 500))
+            throw failure;
+        if (!receivedFrame && ++failures >= 20) {
+            throw new errors_js_1.CompozyStreamError(`${operationId} failed after 20 consecutive stream attempts.`, {
+                cause: failure,
+            });
+        }
+        await backoff(delay, signal);
+        delay = Math.min(delay * 2, 8000);
+    }
+}
+function backoff(ms, signal) {
+    return new Promise(resolve => {
+        const finish = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", finish);
+            resolve();
+        };
+        const timer = setTimeout(finish, ms);
+        signal?.addEventListener("abort", finish, { once: true });
+        if (signal?.aborted)
+            finish();
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/cjs/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"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"}