@tscomfy/client 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 the tscomfy authors
+
+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,77 @@
-# Temporary Holding Version
+# @tscomfy/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.
+[![npm](https://img.shields.io/npm/v/@tscomfy/client)](https://www.npmjs.com/package/@tscomfy/client)
+
+Runs tscomfy workflows on a ComfyUI server. It queues a workflow, streams progress, live
+previews and outputs, and tells you how the job ended. It uses only `fetch` and `WebSocket`, with
+no runtime dependencies, and runs on Node 24+, Bun 1.4+, Deno and browsers.
+
+```sh
+npm install @tscomfy/client @tscomfy/core
+```
+
+```ts
+import { workflow } from "@tscomfy/core";
+import { connect, fetchFile, outputFiles, submit } from "@tscomfy/client";
+import { local } from "./comfy/local/index.ts"; // generated by `tscomfy generate`
+
+const wf = workflow(local, ({ n }) => {
+  const [model, clip, vae] = n.CheckpointLoaderSimple({ ckpt_name: "sdxl.safetensors" });
+  const latent = n.KSampler({
+    model,
+    positive: n.CLIPTextEncode({ clip, text: "a lighthouse at dusk" }),
+    negative: n.CLIPTextEncode({ clip, text: "" }),
+    latent_image: n.EmptyLatentImage({ width: 1024, height: 1024 }),
+    seed: 42n,
+    sampler_name: "euler",
+    scheduler: "normal",
+  });
+  const save = n.SaveImage({ images: n.VAEDecode({ samples: latent, vae }) });
+  return { save }; // kept as wf.handles
+});
+
+const comfy = await connect({ url: "http://127.0.0.1:8188" });
+const job = submit(comfy, wf, { previews: "taesd" });
+for await (const event of job.events) {
+  if (event.type === "progress") console.log(`${event.node}: ${event.value}/${event.max}`);
+  if (event.type === "preview") showPreview(event.mime, event.bytes);
+}
+const outcome = await job.outcome;
+if (outcome.status === "success") {
+  for (const file of outputFiles(outcome, wf.handles.save)) {
+    const { bytes } = await fetchFile(comfy, file);
+    // write bytes to disk, show them, upload them…
+  }
+}
+await comfy.close();
+```
+
+**Reliable by design.**
+- **No missed events.** The client chooses the prompt id and subscribes before it queues.
+- **The server's record decides.** The outcome comes from the server's record of the job, so a
+  dropped websocket costs a moment of progress, never a wrong or missing result.
+- **Outcomes are data.** The outcome is `success`, `rejected` (the server's validation errors as
+  diagnostics), `failed` (the node's error) or `cancelled`.
+- **What rejects.** The outcome promise rejects only when you abort (`signal`) or the server
+  can't be reached (`ClientError`).
+- **Exact seeds.** Seeds beyond 2⁵³ arrive exactly as written.
+
+**Also:** `job.cancel()`, `uploadFile` for loader inputs, `fileUrl` for `<img src>`, and
+`outputOf(outcome, node)` for a node's text output.
+
+## Requirements
+
+- **Servers:** ComfyUI 0.26 or later.
+- **TypeScript:** your project needs a runtime's web types (`@types/node`, Bun's types, Deno, or
+  the DOM lib). The package's declarations name `fetch`, `WebSocket` and `AbortSignal`.
+- **Browsers:** a page needs the server's permission. Start ComfyUI with
+  `--enable-cors-header <origin>`, or serve the page from the same origin.
+
+## Documentation
+
+[Running workflows](https://github.com/TheeKia/tscomfy/blob/main/docs/guides/running-workflows.md)
+and [the API reference](https://github.com/TheeKia/tscomfy/blob/main/docs/api/client.md).
+
+## License
+
+MIT

package/dist/channel.d.ts

@@ -0,0 +1,54 @@
+import { type JsonObject } from "@tscomfy/core";
+import { ClientError } from "./client-error.ts";
+import type { Connection } from "./connection.ts";
+import { type PreviewFrame, type TextFrame } from "./frames.ts";
+import type { Server } from "./server.ts";
+/** Ties a connection to its channel. */
+export declare function attach(connection: Connection, channel: Channel): void;
+/** The channel behind a connection. Throws a `TypeError` for anything `connect` didn't return. */
+export declare function channelOf(connection: Connection): Channel;
+/** What a job hears from the channel. */
+export interface JobListener {
+    readonly id: string;
+    /** A JSON event carrying this job's prompt id. */
+    message(type: string, data: JsonObject): void;
+    /** A preview or progress text of this job. */
+    frame(frame: PreviewFrame | TextFrame): void;
+    /** The server's queue changed (a `status` broadcast). */
+    queueChanged(): void;
+    /** The websocket reopened after a drop: events may have been lost. */
+    reconnected(): void;
+    /** The channel is gone for good: closed, or the server stayed unreachable. */
+    fail(error: ClientError): void;
+}
+/**
+ * One websocket and the jobs listening on it. Opens one socket at a time, shared by every
+ * caller; reconnects only while jobs are open, after the old socket has closed (two live sockets
+ * with one client id lose events on the server), and re-sends the feature flags first. `close()`
+ * stops everything it started: sockets, handshakes, backoff waits.
+ */
+export declare class Channel {
+    #private;
+    readonly server: Server;
+    readonly clientId: string;
+    features: JsonObject;
+    constructor(server: Server, clientId: string);
+    /** Whether `close()` was called. */
+    get closed(): boolean;
+    /**
+     * Waits until the websocket is open, opening it (once, for every caller) if it isn't. Rejects
+     * with the signal's reason when `signal` aborts, and with a {@link ClientError} when the
+     * channel is closed or the socket can't be opened.
+     */
+    ready(signal?: AbortSignal): Promise<void>;
+    /**
+     * Checks that the server is one the client supports: ComfyUI 0.26 or later by its version
+     * (when it reports one it can parse), and with the job API. Rejects with a {@link ClientError}.
+     */
+    checkServer(signal?: AbortSignal): Promise<void>;
+    register(job: JobListener): void;
+    unregister(job: JobListener): void;
+    /** Closes every socket and fails every open job; waits until the sockets have closed. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAoB,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO1C,wCAAwC;AACxC,wBAAgB,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAErE;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAMzD;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9C,8CAA8C;IAC9C,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7C,yDAAyD;IACzD,YAAY,IAAI,IAAI,CAAC;IACrB,sEAAsE;IACtE,WAAW,IAAI,IAAI,CAAC;IACpB,8EAA8E;IAC9E,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAChC;AAsBD;;;;;GAKG;AACH,qBAAa,OAAO;;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,UAAU,CAAM;IAa1B,YAAY,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAG3C;IAED,oCAAoC;IACpC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;OAIG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/C;IAED;;;OAGG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrD;IAED,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAG/B;IAED,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAGjC;IAED,yFAAyF;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrB;CAyIF"}

package/dist/channel.js

@@ -0,0 +1,307 @@
+import { parse, stringify } from "@tscomfy/core";
+import { ClientError } from "./client-error.js";
+import { decodeFrame } from "./frames.js";
+import { isObject, readObject, send } from "./http.js";
+import { abortable, sleep } from "./timers.js";
+import { baseUrl, endpoint, shownUrl } from "./url.js";
+/** Connections and the channels behind them. */
+const channels = new WeakMap();
+/** Ties a connection to its channel. */
+export function attach(connection, channel) {
+    channels.set(connection, channel);
+}
+/** The channel behind a connection. Throws a `TypeError` for anything `connect` didn't return. */
+export function channelOf(connection) {
+    const channel = channels.get(connection);
+    if (channel === undefined) {
+        throw new TypeError("Expected a connection returned by connect()");
+    }
+    return channel;
+}
+/** How long the server gets to answer the feature flags. */
+const HANDSHAKE_MS = 10_000;
+/** Delays between reconnect attempts, before jitter: about two minutes in all. */
+const BACKOFF_MS = [250, 500, 1000, 2000, 4000, 8000, 15_000, 30_000, 30_000, 30_000];
+/** The lowest server version the client supports: the per-job cancel came in 0.26.0. */
+const MIN_VERSION = [0, 26, 0];
+/**
+ * The flags the client announces as its first message: previews and progress text that say
+ * which prompt they belong to, as the frontend announces them.
+ */
+const CLIENT_FLAGS = { supports_preview_metadata: true, supports_progress_text_metadata: true };
+/** A websocket's `readyState` once closed; the global `WebSocket` may not exist. */
+const CLOSED = 3;
+const closedError = () => new ClientError("The connection is closed");
+/**
+ * One websocket and the jobs listening on it. Opens one socket at a time, shared by every
+ * caller; reconnects only while jobs are open, after the old socket has closed (two live sockets
+ * with one client id lose events on the server), and re-sends the feature flags first. `close()`
+ * stops everything it started: sockets, handshakes, backoff waits.
+ */
+export class Channel {
+    server;
+    clientId;
+    features = {};
+    #jobs = new Map();
+    /** Every socket this channel opened and that hasn't closed yet. */
+    #sockets = new Set();
+    /** Aborted by `close()`: ends handshakes and backoff waits. */
+    #life = new AbortController();
+    #socket;
+    #opening;
+    #reconnecting;
+    #closing;
+    /** The job whose prompt the server is running, for progress text without a prompt id. */
+    #running;
+    constructor(server, clientId) {
+        this.server = server;
+        this.clientId = clientId;
+    }
+    /** Whether `close()` was called. */
+    get closed() {
+        return this.#life.signal.aborted;
+    }
+    /**
+     * Waits until the websocket is open, opening it (once, for every caller) if it isn't. Rejects
+     * with the signal's reason when `signal` aborts, and with a {@link ClientError} when the
+     * channel is closed or the socket can't be opened.
+     */
+    async ready(signal) {
+        for (;;) {
+            if (this.closed)
+                throw closedError();
+            if (this.#reconnecting !== undefined) {
+                // oxlint-disable-next-line no-await-in-loop -- the state changes while it waits
+                await abortable(this.#reconnecting, signal);
+                continue;
+            }
+            if (this.#socket !== undefined)
+                return;
+            this.#opening ??= this.#open().finally(() => {
+                this.#opening = undefined;
+            });
+            // oxlint-disable-next-line no-await-in-loop -- the state changes while it waits
+            await abortable(this.#opening, signal);
+        }
+    }
+    /**
+     * Checks that the server is one the client supports: ComfyUI 0.26 or later by its version
+     * (when it reports one it can parse), and with the job API. Rejects with a {@link ClientError}.
+     */
+    async checkServer(signal) {
+        const stats = await send(this.server, { method: "GET", path: "system_stats", signal });
+        if (stats.ok) {
+            const body = await readObject(stats).catch(() => undefined);
+            const system = body?.["system"];
+            const version = isObject(system) ? system["comfyui_version"] : undefined;
+            if (typeof version === "string" && isOlder(version, MIN_VERSION)) {
+                throw new ClientError(`The server runs ComfyUI ${version}; @tscomfy/client needs ComfyUI ${MIN_VERSION.join(".")} or later`);
+            }
+        }
+        else {
+            await stats.body?.cancel();
+        }
+        const jobs = await send(this.server, {
+            method: "GET",
+            path: "api/jobs",
+            query: { limit: "1" },
+            signal,
+        });
+        await jobs.body?.cancel();
+        if (!jobs.ok) {
+            throw new ClientError(`The server has no job API (GET /api/jobs answered ${String(jobs.status)}); @tscomfy/client needs ComfyUI ${MIN_VERSION.join(".")} or later`, { status: jobs.status });
+        }
+    }
+    register(job) {
+        if (this.closed)
+            throw closedError();
+        this.#jobs.set(job.id, job);
+    }
+    unregister(job) {
+        if (this.#jobs.get(job.id) === job)
+            this.#jobs.delete(job.id);
+        if (this.#running === job)
+            this.#running = undefined;
+    }
+    /** Closes every socket and fails every open job; waits until the sockets have closed. */
+    close() {
+        this.#closing ??= this.#close();
+        return this.#closing;
+    }
+    async #close() {
+        this.#life.abort(closedError());
+        this.#socket = undefined;
+        const jobs = [...this.#jobs.values()];
+        this.#jobs.clear();
+        for (const job of jobs)
+            job.fail(new ClientError("The connection was closed"));
+        await Promise.all([...this.#sockets].map((socket) => closeSocket(socket)));
+    }
+    /** Opens a socket and negotiates the feature flags; the socket becomes the channel's. */
+    async #open() {
+        const url = endpoint(baseUrl(this.server), "ws", { clientId: this.clientId });
+        url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+        const shown = shownUrl(url);
+        const life = this.#life.signal;
+        const socket = this.server.webSocket?.(url.href) ?? new WebSocket(url.href);
+        socket.binaryType = "arraybuffer";
+        this.#sockets.add(socket);
+        socket.addEventListener("close", () => {
+            this.#sockets.delete(socket);
+            this.#dropped(socket);
+        });
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                fail(new ClientError(`${shown} didn't answer the websocket handshake in time`));
+            }, HANDSHAKE_MS);
+            const done = () => {
+                clearTimeout(timer);
+                life.removeEventListener("abort", aborted);
+                socket.removeEventListener("close", closed);
+            };
+            const fail = (error) => {
+                done();
+                socket.close();
+                reject(error);
+            };
+            const aborted = () => {
+                fail(closedError());
+            };
+            const closed = () => {
+                fail(new ClientError(`Could not open a websocket to ${shown}`));
+            };
+            if (life.aborted) {
+                aborted();
+                return;
+            }
+            life.addEventListener("abort", aborted, { once: true });
+            socket.addEventListener("close", closed);
+            socket.addEventListener("open", () => {
+                socket.send(stringify({ type: "feature_flags", data: CLIENT_FLAGS }));
+            });
+            let negotiated = false;
+            socket.addEventListener("message", (event) => {
+                if (!negotiated && typeof event.data === "string") {
+                    const message = readMessage(event.data);
+                    if (message?.type === "feature_flags") {
+                        negotiated = true;
+                        done();
+                        this.features = message.data;
+                        this.#socket = socket;
+                        resolve();
+                        return;
+                    }
+                }
+                this.#receive(event.data);
+            });
+        });
+    }
+    #receive(data) {
+        if (typeof data === "string") {
+            const message = readMessage(data);
+            if (message !== undefined)
+                this.#dispatch(message.type, message.data);
+            return;
+        }
+        if (!(data instanceof ArrayBuffer))
+            return;
+        const frame = decodeFrame(data, this.features["supports_progress_text_metadata"] === true);
+        if (frame === undefined)
+            return;
+        const job = frame.promptId === undefined ? this.#running : this.#jobs.get(frame.promptId);
+        job?.frame(frame);
+    }
+    #dispatch(type, data) {
+        if (type === "status") {
+            for (const job of this.#jobs.values())
+                job.queueChanged();
+            return;
+        }
+        const promptId = data["prompt_id"];
+        if (typeof promptId !== "string")
+            return;
+        const job = this.#jobs.get(promptId);
+        if (job === undefined) {
+            // Another client's prompt, or one of ours that settled: it isn't running ours.
+            if (type === "execution_start")
+                this.#running = undefined;
+            return;
+        }
+        if (type === "execution_start")
+            this.#running = job;
+        if (type === "executing" && data["node"] === null && this.#running === job) {
+            this.#running = undefined;
+        }
+        job.message(type, data);
+    }
+    #dropped(socket) {
+        if (this.#socket !== socket)
+            return;
+        this.#socket = undefined;
+        this.#running = undefined;
+        // With no job open, the next submit reopens it.
+        if (this.closed || this.#jobs.size === 0)
+            return;
+        this.#reconnecting = this.#reconnect().finally(() => {
+            this.#reconnecting = undefined;
+        });
+    }
+    async #reconnect() {
+        const life = this.#life.signal;
+        for (const delay of BACKOFF_MS) {
+            // oxlint-disable-next-line no-await-in-loop -- attempts are sequential, with growing waits
+            await sleep(delay * (0.5 + Math.random() / 2), life);
+            if (life.aborted)
+                return;
+            try {
+                // oxlint-disable-next-line no-await-in-loop -- attempts are sequential, with growing waits
+                await this.#open();
+                for (const job of this.#jobs.values())
+                    job.reconnected();
+                return;
+            }
+            catch {
+                // The next attempt, after a longer wait; none after close().
+            }
+        }
+        const error = new ClientError(`Lost the websocket to ${shownUrl(baseUrl(this.server))} and couldn't reopen it`);
+        const jobs = [...this.#jobs.values()];
+        this.#jobs.clear();
+        for (const job of jobs)
+            job.fail(error);
+    }
+}
+/** Closes a socket and waits for its close, a second at most. */
+function closeSocket(socket) {
+    if (socket.readyState === CLOSED)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, 1000);
+        socket.addEventListener("close", () => {
+            clearTimeout(timer);
+            resolve();
+        });
+        socket.close();
+    });
+}
+/** Whether a `major.minor.patch` version (anything after it ignored) is below `minimum`. */
+function isOlder(version, minimum) {
+    const match = /^v?(\d+)\.(\d+)\.(\d+)/.exec(version);
+    if (match === null)
+        return false;
+    const parts = [Number(match[1]), Number(match[2]), Number(match[3])];
+    for (const [index, part] of parts.entries()) {
+        const least = minimum[index] ?? 0;
+        if (part !== least)
+            return part < least;
+    }
+    return false;
+}
+/** A JSON message `{ type, data }`, read losslessly; anything else is ignored. */
+function readMessage(text) {
+    const value = parse(text).value;
+    if (!isObject(value) || typeof value["type"] !== "string")
+        return undefined;
+    return { type: value["type"], data: isObject(value["data"]) ? value["data"] : {} };
+}
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

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

package/dist/client-error.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The server couldn't be reached, or answered in a way the protocol doesn't allow. Thrown by the
+ * HTTP functions and used to reject a job's outcome; what the server decides about a job (a
+ * rejection, a failure) is data instead, in the {@link Outcome}. The underlying error, if any, is
+ * the `cause`.
+ */
+export declare class ClientError extends Error {
+    /** The HTTP status of the answer that caused it, when there was one. */
+    readonly status: number | undefined;
+    constructor(message: string, options?: {
+        readonly cause?: unknown;
+        readonly status?: number;
+    });
+}
+//# sourceMappingURL=client-error.d.ts.map

package/dist/client-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-error.d.ts","sourceRoot":"","sources":["../src/client-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,EAKrE;CACF"}

package/dist/client-error.js

@@ -0,0 +1,16 @@
+/**
+ * The server couldn't be reached, or answered in a way the protocol doesn't allow. Thrown by the
+ * HTTP functions and used to reject a job's outcome; what the server decides about a job (a
+ * rejection, a failure) is data instead, in the {@link Outcome}. The underlying error, if any, is
+ * the `cause`.
+ */
+export class ClientError extends Error {
+    /** The HTTP status of the answer that caused it, when there was one. */
+    status;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = "ClientError";
+        this.status = options.status;
+    }
+}
+//# sourceMappingURL=client-error.js.map

package/dist/client-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-error.js","sourceRoot":"","sources":["../src/client-error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,wEAAwE;IAC/D,MAAM,CAAqB;IAEpC,YACE,OAAe,EACf,OAAO,GAA2D,EAAE;QAEpE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF"}

package/dist/connection.d.ts

@@ -0,0 +1,33 @@
+import type { JsonObject } from "@tscomfy/core";
+import type { Server } from "./server.ts";
+/**
+ * An open connection to a server: a {@link Server} with a websocket that delivers the events of
+ * the jobs submitted through it. Several jobs share it. Close it when done: an open websocket
+ * keeps a Node or Bun process running.
+ */
+export interface Connection extends Server {
+    /** The id the server sends this connection's events to; fresh for every connection. */
+    readonly clientId: string;
+    /** The server's feature flags, as it answered them when the connection opened. */
+    readonly features: JsonObject;
+    /**
+     * Closes the websocket. Jobs still open reject their outcome with a {@link ClientError}; they
+     * keep running on the server.
+     */
+    close(): Promise<void>;
+}
+/** Options for {@link connect}. */
+export interface ConnectOptions {
+    /** Aborts opening the connection; rejects with the signal's reason. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Opens a connection: a websocket with a fresh client id, which announces
+ * `supports_preview_metadata` (so previews say which job and node they belong to) and waits for
+ * the server's feature flags. Also checks that the server is ComfyUI 0.26 or later with the job
+ * API. Rejects with a {@link ClientError} when the server can't be reached or is too old, and
+ * with the signal's reason when `signal` aborts; either way nothing is left open. Throws a
+ * `TypeError` for an invalid `server.url`.
+ */
+export declare function connect(server: Server, options?: ConnectOptions): Promise<Connection>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAI1C;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,MAAM;IACxC,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqB/F"}

package/dist/connection.js

@@ -0,0 +1,35 @@
+import { attach, Channel } from "./channel.js";
+import { baseUrl } from "./url.js";
+import { randomUuid } from "./uuid.js";
+/**
+ * Opens a connection: a websocket with a fresh client id, which announces
+ * `supports_preview_metadata` (so previews say which job and node they belong to) and waits for
+ * the server's feature flags. Also checks that the server is ComfyUI 0.26 or later with the job
+ * API. Rejects with a {@link ClientError} when the server can't be reached or is too old, and
+ * with the signal's reason when `signal` aborts; either way nothing is left open. Throws a
+ * `TypeError` for an invalid `server.url`.
+ */
+export async function connect(server, options = {}) {
+    baseUrl(server);
+    const channel = new Channel(server, randomUuid());
+    try {
+        await channel.ready(options.signal);
+        await channel.checkServer(options.signal);
+    }
+    catch (error) {
+        await channel.close();
+        throw error;
+    }
+    const connection = Object.freeze({
+        url: server.url,
+        ...(server.headers === undefined ? {} : { headers: server.headers }),
+        ...(server.fetch === undefined ? {} : { fetch: server.fetch }),
+        ...(server.webSocket === undefined ? {} : { webSocket: server.webSocket }),
+        clientId: channel.clientId,
+        features: channel.features,
+        close: () => channel.close(),
+    });
+    attach(connection, channel);
+    return connection;
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAyBvC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,OAAO,GAAmB,EAAE;IACxE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAe,MAAM,CAAC,MAAM,CAAC;QAC3C,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACpE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9D,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAC1E,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;KAC7B,CAAC,CAAC;IACH,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/event-queue.d.ts

@@ -0,0 +1,16 @@
+import type { JobEvent } from "./events.ts";
+/**
+ * A job's events, for one consumer. Buffered from the start, so none is missed before the
+ * consumer starts reading; while it lags, a newer progress or preview of a node replaces the
+ * unread one where it stands, so the buffer stays bounded by the number of nodes and keeps its
+ * order.
+ */
+export declare class EventQueue implements AsyncIterable<JobEvent> {
+    #private;
+    /** Adds an event, unless the queue has ended or its consumer stopped. */
+    push(event: JobEvent): void;
+    /** Ends the queue: the consumer reads what is buffered, then stops. */
+    end(): void;
+    [Symbol.asyncIterator](): AsyncIterator<JobEvent, undefined>;
+}
+//# sourceMappingURL=event-queue.d.ts.map

package/dist/event-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-queue.d.ts","sourceRoot":"","sources":["../src/event-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAU5C;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,aAAa,CAAC,QAAQ,CAAC;;IAOxD,yEAAyE;IACzE,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAiB1B;IAED,uEAAuE;IACvE,GAAG,IAAI,IAAI,CAGV;IAED,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAmB3D;CACF"}