@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/transfer-source.d.ts

@@ -0,0 +1,29 @@
+import type { FilePart } from "./attachments.js";
+export type AttachmentTransferBody = {
+    readonly body: ReadableStream<Uint8Array>;
+    verify(): Promise<void>;
+    finish(): Promise<void>;
+    stop(): Promise<void>;
+};
+/** Marks reader finalization failures so the REST boundary does not present them as transport failures */
+export declare class AttachmentTransferCleanupError extends Error {
+    constructor(cause: unknown);
+}
+/** Keeps an exact-length failure separate from a source cleanup defect */
+export declare class AttachmentTransferVerificationCleanupError extends Error {
+    readonly verification: unknown;
+    readonly cleanup: unknown;
+    constructor(verification: unknown, cleanup: unknown);
+}
+/** One operation-owned exact-length source. Byte inputs are copied before construction, while file and stream sources remain caller-owned outside an acquired reader */
+export declare class AttachmentTransferSource {
+    #private;
+    private readonly file;
+    readonly size: number;
+    /** Byte inputs are snapshot-owned and can recreate a fully consumed inline body after a confirmed rate-limit rejection */
+    readonly replayable: boolean;
+    constructor(file: FilePart);
+    close(): Promise<void>;
+    open(offset: number, size: number): AttachmentTransferBody;
+}
+//# sourceMappingURL=transfer-source.d.ts.map

package/dist/internal/transfer-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-source.d.ts","sourceRoot":"","sources":["../../src/internal/transfer-source.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAIhD,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IACzC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB,CAAA;AAED,0GAA0G;AAC1G,qBAAa,8BAA+B,SAAQ,KAAK;IACrD,YAAY,KAAK,EAAE,OAAO,EAGzB;CACJ;AAED,0EAA0E;AAC1E,qBAAa,0CAA2C,SAAQ,KAAK;IAE7D,QAAQ,CAAC,YAAY,EAAE,OAAO;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO;IAF7B,YACa,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,OAAO,EAI5B;CACJ;AA+CD,wKAAwK;AACxK,qBAAa,wBAAwB;;IAUrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IATjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0HAA0H;IAC1H,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAO5B,YAA6B,IAAI,EAAE,QAAQ,EAG1C;IAYK,KAAK,kBAMV;IA0ND,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAazD;CACJ"}

package/dist/internal/transfer-source.js

@@ -0,0 +1,347 @@
+/**
+ * Attachment transfer sources: Exact-length readers over copied bytes, sized files and finite streams.
+ * Invariant: Each source verifies its exact byte count and awaits acquired reader cleanup without buffering unknown-length
+ * streams, and only copied byte sources can replay after an inline rate-limit rejection. Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import { setImmediate as yieldToHost } from "node:timers/promises";
+const chunkBytes = 65_536;
+/** Marks reader finalization failures so the REST boundary does not present them as transport failures */
+export class AttachmentTransferCleanupError extends Error {
+    constructor(cause) {
+        super("Closing the attachment file or stream reader failed", { cause });
+        this.name = "AttachmentTransferCleanupError";
+    }
+}
+/** Keeps an exact-length failure separate from a source cleanup defect */
+export class AttachmentTransferVerificationCleanupError extends Error {
+    verification;
+    cleanup;
+    constructor(verification, cleanup) {
+        super("The attachment did not supply its declared size, and closing its reader also failed", { cause: cleanup });
+        this.verification = verification;
+        this.cleanup = cleanup;
+        this.name = "AttachmentTransferVerificationCleanupError";
+    }
+}
+function validChunk(value) {
+    return value instanceof Uint8Array && value.buffer instanceof ArrayBuffer;
+}
+function readResult(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const done = "done" in value ? value.done : undefined;
+    if (done === true)
+        return { done: true, value: "value" in value && validChunk(value.value) ? value.value : undefined };
+    if (done !== false && done !== undefined)
+        return undefined;
+    if (!("value" in value) || !validChunk(value.value))
+        return undefined;
+    return { done: false, value: value.value };
+}
+async function readNonempty(reader, closed, invalid) {
+    let emptyReads = 0;
+    for (;;) {
+        if (closed())
+            throw new Error("Attachment source closed");
+        const next = readResult(await reader.read());
+        if (closed())
+            throw new Error("Attachment source closed");
+        if (!next)
+            throw new Error(invalid);
+        if (next.done)
+            return undefined;
+        if (next.value.byteLength !== 0)
+            return next.value;
+        // Empty chunks are valid, but immediately resolved reads must not starve
+        // host timers and cancellation, including during the final EOF check
+        if (++emptyReads === 256) {
+            emptyReads = 0;
+            await yieldToHost();
+        }
+    }
+}
+async function completeCleanup(actions) {
+    const failures = [];
+    for (const action of actions) {
+        try {
+            await action();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+    }
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length > 1)
+        throw new AggregateError(failures, "Attachment source cleanup failed");
+}
+/** One operation-owned exact-length source. Byte inputs are copied before construction, while file and stream sources remain caller-owned outside an acquired reader */
+export class AttachmentTransferSource {
+    file;
+    size;
+    /** Byte inputs are snapshot-owned and can recreate a fully consumed inline body after a confirmed rate-limit rejection */
+    replayable;
+    #streamReader;
+    #streamPending;
+    #streamOffset = 0;
+    #streamPosition = 0;
+    #closed = false;
+    constructor(file) {
+        this.file = file;
+        this.size = file.size;
+        this.replayable = file.source.kind === "bytes";
+    }
+    async #closeStream(cancel) {
+        this.#closed = !this.replayable;
+        const reader = this.#streamReader;
+        this.#streamReader = undefined;
+        this.#streamPending = undefined;
+        this.#streamOffset = 0;
+        if (!reader)
+            return;
+        await completeCleanup([...(cancel ? [() => reader.cancel()] : []), () => reader.releaseLock()]);
+    }
+    async close() {
+        // Copied bytes have no caller-owned reader or mutable source to release. They can
+        // recreate an inline multipart body after a confirmed 429, including when the server
+        // replied before reading the first body
+        if (!this.replayable)
+            this.#closed = true;
+        await this.#closeStream(true);
+    }
+    #streamReaderForRead() {
+        if (this.#closed)
+            throw new Error("Attachment source closed");
+        if (this.#streamReader)
+            return this.#streamReader;
+        if (this.file.source.kind !== "stream")
+            throw new Error("Attachment source is not a stream");
+        const reader = this.file.source.stream.getReader();
+        if (!isAttachmentStreamReader(reader))
+            throw new Error("The attachment stream getReader() result must have read, cancel, and releaseLock methods");
+        this.#streamReader = reader;
+        return reader;
+    }
+    async #nextStreamChunk() {
+        if (!this.#streamPending || this.#streamOffset === this.#streamPending.byteLength) {
+            this.#streamPending = undefined;
+            this.#streamOffset = 0;
+            this.#streamPending = await readNonempty(this.#streamReaderForRead(), () => this.#closed, "The attachment stream reader returned a result that is not { done, value } with Uint8Array bytes");
+        }
+        return this.#streamPending;
+    }
+    #streamRange(offset, size) {
+        const owner = this;
+        if (offset !== this.#streamPosition)
+            throw new Error("Attachment stream parts must remain sequential");
+        let remaining = size;
+        let ended = false;
+        let finished = false;
+        let controller;
+        const stream = new ReadableStream({
+            pull: async (value) => {
+                if (remaining === 0) {
+                    ended = true;
+                    value.close();
+                    return;
+                }
+                const chunk = await owner.#nextStreamChunk();
+                if (!chunk)
+                    throw new Error("Attachment stream ended before its declared size");
+                const available = chunk.byteLength - owner.#streamOffset;
+                const length = Math.min(available, remaining, chunkBytes);
+                const next = chunk.subarray(owner.#streamOffset, owner.#streamOffset + length);
+                owner.#streamOffset += length;
+                owner.#streamPosition += length;
+                remaining -= length;
+                value.enqueue(next);
+            },
+            cancel: async () => {
+                ended = true;
+                await owner.close();
+            },
+            start(value) {
+                controller = value;
+            },
+        }, { highWaterMark: 0 });
+        return {
+            body: stream,
+            async verify() {
+                if (!ended || remaining !== 0)
+                    throw new Error("Attachment stream did not finish its requested range");
+                if (owner.#streamPosition !== owner.size)
+                    return;
+                const extra = await owner.#nextStreamChunk();
+                if (extra)
+                    throw new Error("Attachment stream exceeded its declared size");
+            },
+            async finish() {
+                finished = true;
+                if (owner.#streamPosition !== owner.size)
+                    return;
+                try {
+                    await owner.#closeStream(false);
+                }
+                catch (error) {
+                    throw new AttachmentTransferCleanupError(error);
+                }
+            },
+            async stop() {
+                if (!ended) {
+                    ended = true;
+                    controller?.error(new Error("Attachment upload body closed"));
+                }
+                if (!finished)
+                    await owner.close();
+            },
+        };
+    }
+    #rangeStream(stream, size) {
+        let reader;
+        let closed = false;
+        let pending;
+        let pendingOffset = 0;
+        let remaining = size;
+        let ended = false;
+        let controller;
+        const take = async () => {
+            if (closed)
+                throw new Error("Attachment source closed");
+            if (!reader) {
+                const candidate = stream.getReader();
+                if (!isAttachmentStreamReader(candidate))
+                    throw new Error("The attachment file stream getReader() result must have read, cancel, and releaseLock methods");
+                reader = candidate;
+            }
+            if (!pending || pendingOffset === pending.byteLength) {
+                pending = undefined;
+                pendingOffset = 0;
+                pending = await readNonempty(reader, () => closed, "The attachment file stream reader returned a result that is not { done, value } with Uint8Array bytes");
+            }
+            return pending;
+        };
+        const body = new ReadableStream({
+            pull: async (value) => {
+                if (remaining === 0) {
+                    ended = true;
+                    value.close();
+                    return;
+                }
+                const next = await take();
+                if (!next)
+                    throw new Error("Attachment file ended before its reported size");
+                const length = Math.min(next.byteLength - pendingOffset, remaining, chunkBytes);
+                pendingOffset += length;
+                remaining -= length;
+                value.enqueue(next.subarray(pendingOffset - length, pendingOffset));
+            },
+            cancel: async () => {
+                ended = true;
+                await release(true);
+            },
+            start(value) {
+                controller = value;
+            },
+        }, { highWaterMark: 0 });
+        const release = async (cancel) => {
+            closed = true;
+            if (!reader)
+                return;
+            const current = reader;
+            reader = undefined;
+            await completeCleanup([...(cancel ? [() => current.cancel()] : []), () => current.releaseLock()]);
+        };
+        return {
+            body,
+            async verify() {
+                if (!ended || remaining !== 0)
+                    throw new Error("Attachment file did not finish its requested range");
+                if (pending && pendingOffset < pending.byteLength)
+                    throw new Error("Attachment file exceeded its reported size");
+                pending = undefined;
+                pendingOffset = 0;
+                const extra = await take();
+                if (extra)
+                    throw new Error("Attachment file exceeded its reported size");
+            },
+            async finish() {
+                try {
+                    await release(false);
+                }
+                catch (error) {
+                    throw new AttachmentTransferCleanupError(error);
+                }
+            },
+            async stop() {
+                if (!ended) {
+                    ended = true;
+                    controller?.error(new Error("Attachment upload body closed"));
+                }
+                await release(true);
+            },
+        };
+    }
+    #bytesRange(data, offset, size) {
+        let position = offset;
+        const end = offset + size;
+        let ended = false;
+        let controller;
+        const body = new ReadableStream({
+            pull(value) {
+                if (position === end) {
+                    ended = true;
+                    value.close();
+                    return;
+                }
+                const next = Math.min(position + chunkBytes, end);
+                value.enqueue(data.subarray(position, next));
+                position = next;
+            },
+            cancel() {
+                ended = true;
+            },
+            start(value) {
+                controller = value;
+            },
+        }, { highWaterMark: 0 });
+        return {
+            body,
+            async verify() {
+                if (!ended || position !== end)
+                    throw new Error("Attachment bytes did not finish their requested range");
+            },
+            async finish() { },
+            async stop() {
+                if (!ended) {
+                    ended = true;
+                    controller?.error(new Error("Attachment upload body closed"));
+                }
+            },
+        };
+    }
+    open(offset, size) {
+        if (this.#closed || offset < 0 || size < 0 || offset + size > this.size)
+            throw new Error("Invalid attachment range");
+        if (this.file.source.kind === "bytes") {
+            return this.#bytesRange(this.file.source.data, offset, size);
+        }
+        if (this.file.source.kind === "file") {
+            const slice = this.file.source.file.slice(offset, offset + size);
+            if (!slice || typeof slice.stream !== "function")
+                throw new Error("The attachment file slice() result must have a stream method");
+            return this.#rangeStream(slice.stream(), size);
+        }
+        return this.#streamRange(offset, size);
+    }
+}
+function isAttachmentStreamReader(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    return ("read" in value &&
+        typeof value.read === "function" &&
+        "cancel" in value &&
+        typeof value.cancel === "function" &&
+        "releaseLock" in value &&
+        typeof value.releaseLock === "function");
+}
+//# sourceMappingURL=transfer-source.js.map

package/dist/internal/transfer-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-source.js","sourceRoot":"","sources":["../../src/internal/transfer-source.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIlE,MAAM,UAAU,GAAG,MAAM,CAAA;AASzB,0GAA0G;AAC1G,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACrD,YAAY,KAAc;QACtB,KAAK,CAAC,qDAAqD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QACvE,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAA;IAChD,CAAC;CACJ;AAED,0EAA0E;AAC1E,MAAM,OAAO,0CAA2C,SAAQ,KAAK;IAEpD,YAAY;IACZ,OAAO;IAFpB,YACa,YAAqB,EACrB,OAAgB;QAEzB,KAAK,CAAC,qFAAqF,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;4BAHvG,YAAY;uBACZ,OAAO;QAGhB,IAAI,CAAC,IAAI,GAAG,4CAA4C,CAAA;IAC5D,CAAC;CACJ;AAED,SAAS,UAAU,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,MAAM,YAAY,WAAW,CAAA;AAC7E,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,IAAI,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IACrD,IAAI,IAAI,KAAK,IAAI;QACb,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAA;IACvG,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1D,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACrE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAA;AAC9C,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAA8B,EAAE,MAAqB,EAAE,OAAe;IAC9F,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,SAAS,CAAC;QACN,IAAI,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QACzD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5C,IAAI,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;QACnC,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAA;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAA;QAClD,yEAAyE;QACzE,qEAAqE;QACrE,IAAI,EAAE,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,UAAU,GAAG,CAAC,CAAA;YACd,MAAM,WAAW,EAAE,CAAA;QACvB,CAAC;IACL,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAoD;IAC/E,MAAM,QAAQ,GAAc,EAAE,CAAA;IAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC;YACD,MAAM,MAAM,EAAE,CAAA;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxB,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC5C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,kCAAkC,CAAC,CAAA;AACnG,CAAC;AAED,wKAAwK;AACxK,MAAM,OAAO,wBAAwB;IAUJ,IAAI;IATxB,IAAI,CAAQ;IACrB,0HAA0H;IACjH,UAAU,CAAS;IAC5B,aAAa,CAAoC;IACjD,cAAc,CAAwB;IACtC,aAAa,GAAG,CAAC,CAAA;IACjB,eAAe,GAAG,CAAC,CAAA;IACnB,OAAO,GAAG,KAAK,CAAA;IAEf,YAA6B,IAAc;oBAAd,IAAI;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAA;IAClD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAe;QAC9B,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,UAAU,CAAA;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAA;QACjC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAA;QAC9B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAA;QAC/B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAA;QACtB,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,MAAM,eAAe,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IACnG,CAAC;IAED,KAAK,CAAC,KAAK;QACP,kFAAkF;QAClF,qFAAqF;QACrF,wCAAwC;QACxC,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACzC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IAED,oBAAoB;QAChB,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC7D,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAA;QACjD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAA;QAClD,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAA;QAC/G,IAAI,CAAC,aAAa,GAAG,MAAM,CAAA;QAC3B,OAAO,MAAM,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,gBAAgB;QAClB,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;YAChF,IAAI,CAAC,cAAc,GAAG,SAAS,CAAA;YAC/B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAA;YACtB,IAAI,CAAC,cAAc,GAAG,MAAM,YAAY,CACpC,IAAI,CAAC,oBAAoB,EAAE,EAC3B,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAClB,kGAAkG,CACrG,CAAA;QACL,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAA;IAC9B,CAAC;IAED,YAAY,CAAC,MAAc,EAAE,IAAY;QACrC,MAAM,KAAK,GAAG,IAAI,CAAA;QAClB,IAAI,MAAM,KAAK,IAAI,CAAC,eAAe;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;QACtG,IAAI,SAAS,GAAG,IAAI,CAAA;QACpB,IAAI,KAAK,GAAG,KAAK,CAAA;QACjB,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,IAAI,UAAmE,CAAA;QACvE,MAAM,MAAM,GAAG,IAAI,cAAc,CAC7B;YACI,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAClB,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBAClB,KAAK,GAAG,IAAI,CAAA;oBACZ,KAAK,CAAC,KAAK,EAAE,CAAA;oBACb,OAAM;gBACV,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAA;gBAC5C,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;gBAC/E,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,aAAa,CAAA;gBACxD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;gBACzD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,CAAA;gBAC9E,KAAK,CAAC,aAAa,IAAI,MAAM,CAAA;gBAC7B,KAAK,CAAC,eAAe,IAAI,MAAM,CAAA;gBAC/B,SAAS,IAAI,MAAM,CAAA;gBACnB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACvB,CAAC;YACD,MAAM,EAAE,KAAK,IAAI,EAAE;gBACf,KAAK,GAAG,IAAI,CAAA;gBACZ,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;YACvB,CAAC;YACD,KAAK,CAAC,KAAK;gBACP,UAAU,GAAG,KAAK,CAAA;YACtB,CAAC;SACJ,EACD,EAAE,aAAa,EAAE,CAAC,EAAE,CACvB,CAAA;QACD,OAAO;YACH,IAAI,EAAE,MAAM;YACZ,KAAK,CAAC,MAAM;gBACR,IAAI,CAAC,KAAK,IAAI,SAAS,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;gBACtG,IAAI,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC,IAAI;oBAAE,OAAM;gBAChD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAA;gBAC5C,IAAI,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;YAC9E,CAAC;YACD,KAAK,CAAC,MAAM;gBACR,QAAQ,GAAG,IAAI,CAAA;gBACf,IAAI,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC,IAAI;oBAAE,OAAM;gBAChD,IAAI,CAAC;oBACD,MAAM,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;gBACnC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,MAAM,IAAI,8BAA8B,CAAC,KAAK,CAAC,CAAA;gBACnD,CAAC;YACL,CAAC;YACD,KAAK,CAAC,IAAI;gBACN,IAAI,CAAC,KAAK,EAAE,CAAC;oBACT,KAAK,GAAG,IAAI,CAAA;oBACZ,UAAU,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAA;gBACjE,CAAC;gBACD,IAAI,CAAC,QAAQ;oBAAE,MAAM,KAAK,CAAC,KAAK,EAAE,CAAA;YACtC,CAAC;SACJ,CAAA;IACL,CAAC;IAED,YAAY,CAAC,MAA8B,EAAE,IAAY;QACrD,IAAI,MAA0C,CAAA;QAC9C,IAAI,MAAM,GAAG,KAAK,CAAA;QAClB,IAAI,OAA+B,CAAA;QACnC,IAAI,aAAa,GAAG,CAAC,CAAA;QACrB,IAAI,SAAS,GAAG,IAAI,CAAA;QACpB,IAAI,KAAK,GAAG,KAAK,CAAA;QACjB,IAAI,UAAmE,CAAA;QACvE,MAAM,IAAI,GAAG,KAAK,IAAqC,EAAE;YACrD,IAAI,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;YACvD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,CAAA;gBACpC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC;oBACpC,MAAM,IAAI,KAAK,CACX,+FAA+F,CAClG,CAAA;gBACL,MAAM,GAAG,SAAS,CAAA;YACtB,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,aAAa,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;gBACnD,OAAO,GAAG,SAAS,CAAA;gBACnB,aAAa,GAAG,CAAC,CAAA;gBACjB,OAAO,GAAG,MAAM,YAAY,CACxB,MAAM,EACN,GAAG,EAAE,CAAC,MAAM,EACZ,uGAAuG,CAC1G,CAAA;YACL,CAAC;YACD,OAAO,OAAO,CAAA;QAClB,CAAC,CAAA;QACD,MAAM,IAAI,GAAG,IAAI,cAAc,CAC3B;YACI,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAClB,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBAClB,KAAK,GAAG,IAAI,CAAA;oBACZ,KAAK,CAAC,KAAK,EAAE,CAAA;oBACb,OAAM;gBACV,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,IAAI,EAAE,CAAA;gBACzB,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;gBAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,aAAa,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;gBAC/E,aAAa,IAAI,MAAM,CAAA;gBACvB,SAAS,IAAI,MAAM,CAAA;gBACnB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,GAAG,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;YACvE,CAAC;YACD,MAAM,EAAE,KAAK,IAAI,EAAE;gBACf,KAAK,GAAG,IAAI,CAAA;gBACZ,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;YACvB,CAAC;YACD,KAAK,CAAC,KAAK;gBACP,UAAU,GAAG,KAAK,CAAA;YACtB,CAAC;SACJ,EACD,EAAE,aAAa,EAAE,CAAC,EAAE,CACvB,CAAA;QACD,MAAM,OAAO,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YACtC,MAAM,GAAG,IAAI,CAAA;YACb,IAAI,CAAC,MAAM;gBAAE,OAAM;YACnB,MAAM,OAAO,GAAG,MAAM,CAAA;YACtB,MAAM,GAAG,SAAS,CAAA;YAClB,MAAM,eAAe,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;QACrG,CAAC,CAAA;QACD,OAAO;YACH,IAAI;YACJ,KAAK,CAAC,MAAM;gBACR,IAAI,CAAC,KAAK,IAAI,SAAS,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;gBACpG,IAAI,OAAO,IAAI,aAAa,GAAG,OAAO,CAAC,UAAU;oBAC7C,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;gBACjE,OAAO,GAAG,SAAS,CAAA;gBACnB,aAAa,GAAG,CAAC,CAAA;gBACjB,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,CAAA;gBAC1B,IAAI,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;YAC5E,CAAC;YACD,KAAK,CAAC,MAAM;gBACR,IAAI,CAAC;oBACD,MAAM,OAAO,CAAC,KAAK,CAAC,CAAA;gBACxB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,MAAM,IAAI,8BAA8B,CAAC,KAAK,CAAC,CAAA;gBACnD,CAAC;YACL,CAAC;YACD,KAAK,CAAC,IAAI;gBACN,IAAI,CAAC,KAAK,EAAE,CAAC;oBACT,KAAK,GAAG,IAAI,CAAA;oBACZ,UAAU,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAA;gBACjE,CAAC;gBACD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;YACvB,CAAC;SACJ,CAAA;IACL,CAAC;IAED,WAAW,CAAC,IAAgB,EAAE,MAAc,EAAE,IAAY;QACtD,IAAI,QAAQ,GAAG,MAAM,CAAA;QACrB,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAA;QACzB,IAAI,KAAK,GAAG,KAAK,CAAA;QACjB,IAAI,UAAmE,CAAA;QACvE,MAAM,IAAI,GAAG,IAAI,cAAc,CAC3B;YACI,IAAI,CAAC,KAAK;gBACN,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;oBACnB,KAAK,GAAG,IAAI,CAAA;oBACZ,KAAK,CAAC,KAAK,EAAE,CAAA;oBACb,OAAM;gBACV,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,UAAU,EAAE,GAAG,CAAC,CAAA;gBACjD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;gBAC5C,QAAQ,GAAG,IAAI,CAAA;YACnB,CAAC;YACD,MAAM;gBACF,KAAK,GAAG,IAAI,CAAA;YAChB,CAAC;YACD,KAAK,CAAC,KAAK;gBACP,UAAU,GAAG,KAAK,CAAA;YACtB,CAAC;SACJ,EACD,EAAE,aAAa,EAAE,CAAC,EAAE,CACvB,CAAA;QACD,OAAO;YACH,IAAI;YACJ,KAAK,CAAC,MAAM;gBACR,IAAI,CAAC,KAAK,IAAI,QAAQ,KAAK,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;YAC5G,CAAC;YACD,KAAK,CAAC,MAAM,KAAI,CAAC;YACjB,KAAK,CAAC,IAAI;gBACN,IAAI,CAAC,KAAK,EAAE,CAAC;oBACT,KAAK,GAAG,IAAI,CAAA;oBACZ,UAAU,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAA;gBACjE,CAAC;YACL,CAAC;SACJ,CAAA;IACL,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,IAAY;QAC7B,IAAI,IAAI,CAAC,OAAO,IAAI,MAAM,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI;YACnE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAC/C,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;QAChE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;YAChE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU;gBAC5C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;YACnF,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC1C,CAAC;CACJ;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC7D,OAAO,CACH,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU;QAChC,QAAQ,IAAI,KAAK;QACjB,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU;QAClC,aAAa,IAAI,KAAK;QACtB,OAAO,KAAK,CAAC,WAAW,KAAK,UAAU,CAC1C,CAAA;AACL,CAAC"}

package/dist/internal/transport/http.d.ts

@@ -0,0 +1,12 @@
+/** Fetch-shaped HTTP transport. It must honor init.signal and init.redirect like the platform fetch */
+export type HttpTransport = (url: string, init: RequestInit) => Promise<Response>;
+/** Platform fetch, resolved at call time */
+export declare const platformHttpTransport: HttpTransport;
+/**
+ * Send every request through a transport with the given User-Agent. A synchronous throw from the wrapped transport
+ * becomes a rejected promise, so callers see one failure path for replaced implementations
+ */
+export declare function withUserAgent(http: HttpTransport, userAgent: () => string): HttpTransport;
+/** Platform fetch with the SDK's default User-Agent, used by every owner created without a caller transport */
+export declare const defaultHttpTransport: HttpTransport;
+//# sourceMappingURL=http.d.ts.map

package/dist/internal/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/internal/transport/http.ts"],"names":[],"mappings":"AASA,uGAAuG;AACvG,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEjF,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,EAAE,aAA0D,CAAA;AAe9F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,MAAM,GAAG,aAAa,CAUzF;AAED,+GAA+G;AAC/G,eAAO,MAAM,oBAAoB,EAAE,aAAsE,CAAA"}

package/dist/internal/transport/http.js

@@ -0,0 +1,44 @@
+/**
+ * HTTP transport seam: The one fetch-shaped function that REST, instance discovery, OAuth and attachment transfers call.
+ * Invariant: The platform implementation looks up the global fetch on every request, so no module captures a transport
+ * at import time. Callers always pass their own redirect policy and abort signal, and every transport an SDK owner uses
+ * adds exactly one User-Agent header, replacing any caller-built value.
+ * Implements [SDK contracts: Connection and recovery](/docs/SDK-CONTRACTS.md#connection-and-recovery)
+ */
+import { defaultUserAgent } from "./user-agent.js";
+/** Platform fetch, resolved at call time */
+export const platformHttpTransport = (url, init) => globalThis.fetch(url, init);
+/** Copy request headers into a plain record without any User-Agent, keeping the SDK's header-name spelling */
+function headerRecord(headers) {
+    const result = {};
+    if (headers === undefined)
+        return result;
+    if (headers instanceof Headers || Array.isArray(headers)) {
+        new Headers(headers).forEach((value, name) => {
+            result[name] = value;
+        });
+    }
+    else
+        Object.assign(result, headers);
+    for (const name of Object.keys(result))
+        if (name.toLowerCase() === "user-agent")
+            delete result[name];
+    return result;
+}
+/**
+ * Send every request through a transport with the given User-Agent. A synchronous throw from the wrapped transport
+ * becomes a rejected promise, so callers see one failure path for replaced implementations
+ */
+export function withUserAgent(http, userAgent) {
+    return (url, init) => {
+        try {
+            return Promise.resolve(http(url, { ...init, headers: { ...headerRecord(init.headers), "User-Agent": userAgent() } }));
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+    };
+}
+/** Platform fetch with the SDK's default User-Agent, used by every owner created without a caller transport */
+export const defaultHttpTransport = withUserAgent(platformHttpTransport, defaultUserAgent);
+//# sourceMappingURL=http.js.map

package/dist/internal/transport/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/internal/transport/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAKlD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAE9F,8GAA8G;AAC9G,SAAS,YAAY,CAAC,OAA+B;IACjD,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACxC,IAAI,OAAO,YAAY,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACzC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QACxB,CAAC,CAAC,CAAA;IACN,CAAC;;QAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,YAAY;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;IACpG,OAAO,MAAM,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB,EAAE,SAAuB;IACtE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QACjB,IAAI,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAClB,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAChG,CAAA;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAChC,CAAC;IACL,CAAC,CAAA;AACL,CAAC;AAED,+GAA+G;AAC/G,MAAM,CAAC,MAAM,oBAAoB,GAAkB,aAAa,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAA"}

package/dist/internal/transport/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Transport seam entry: The HTTP and WebSocket implementations one SDK owner uses for all network I/O.
+ * Invariant: REST, instance discovery, OAuth and the gateway reach the network only through a Transport, every owner
+ * created without an explicit one uses the platform fetch and the selected ws library, and every Transport sends one
+ * User-Agent with each HTTP request and gateway handshake.
+ * Implements [SDK contracts: Connection and recovery](/docs/SDK-CONTRACTS.md#connection-and-recovery)
+ */
+import { type HttpTransport } from "./http.js";
+import { type SocketFactory } from "./socket.js";
+export { defaultHttpTransport, platformHttpTransport, withUserAgent, type HttpTransport } from "./http.js";
+export type { GatewaySocket, SocketData, SocketFactory } from "./socket.js";
+export { defaultSocketFactory, platformSocketFactory, SocketState, withSocketUserAgent } from "./socket.js";
+export { defaultUserAgent, userAgentMaxLength, validUserAgent } from "./user-agent.js";
+/** Network implementations shared by one client, OAuth client or webhook client */
+export interface Transport {
+    readonly http: HttpTransport;
+    readonly sockets: SocketFactory;
+}
+/** Platform fetch and the selected ws transport, both with the SDK's default User-Agent */
+export declare const defaultTransport: Transport;
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAEtE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AAC1G,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3E,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC3G,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEtF,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAClC;AAED,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,EAAE,SAAwF,CAAA"}

package/dist/internal/transport/index.js

@@ -0,0 +1,15 @@
+/**
+ * Transport seam entry: The HTTP and WebSocket implementations one SDK owner uses for all network I/O.
+ * Invariant: REST, instance discovery, OAuth and the gateway reach the network only through a Transport, every owner
+ * created without an explicit one uses the platform fetch and the selected ws library, and every Transport sends one
+ * User-Agent with each HTTP request and gateway handshake.
+ * Implements [SDK contracts: Connection and recovery](/docs/SDK-CONTRACTS.md#connection-and-recovery)
+ */
+import { defaultHttpTransport } from "./http.js";
+import { defaultSocketFactory } from "./socket.js";
+export { defaultHttpTransport, platformHttpTransport, withUserAgent } from "./http.js";
+export { defaultSocketFactory, platformSocketFactory, SocketState, withSocketUserAgent } from "./socket.js";
+export { defaultUserAgent, userAgentMaxLength, validUserAgent } from "./user-agent.js";
+/** Platform fetch and the selected ws transport, both with the SDK's default User-Agent */
+export const defaultTransport = Object.freeze({ http: defaultHttpTransport, sockets: defaultSocketFactory });
+//# sourceMappingURL=index.js.map

package/dist/internal/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAsB,MAAM,WAAW,CAAA;AACpE,OAAO,EAAE,oBAAoB,EAAsB,MAAM,aAAa,CAAA;AAEtE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,aAAa,EAAsB,MAAM,WAAW,CAAA;AAE1G,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC3G,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAQtF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAc,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAA"}

package/dist/internal/transport/socket.d.ts

@@ -0,0 +1,51 @@
+/** WebSocket ready states, matching the ws and WHATWG numbering */
+export declare const SocketState: Readonly<{
+    readonly connecting: 0;
+    readonly open: 1;
+    readonly closing: 2;
+    readonly closed: 3;
+}>;
+/** Received message data: The forms ws delivers (a Buffer is a Uint8Array), or a string from another WebSocket implementation */
+export type SocketData = Uint8Array | ArrayBuffer | readonly Uint8Array[] | string;
+/** Options the gateway passes to every socket it opens */
+export interface SocketOptions {
+    /** Compression is never negotiated, so received sizes are wire sizes */
+    readonly perMessageDeflate: false;
+    /** The gateway URL is trusted as given. Redirects are rejected */
+    readonly followRedirects: false;
+    /** Largest accepted message in bytes, enforced before decoding text or parsing JSON, including fragments */
+    readonly maxPayload: number;
+    /** Handshake headers. The owner's socket factory adds the User-Agent here */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/** Socket options after the owner's factory has added its handshake headers */
+export interface HeaderedSocketOptions extends SocketOptions {
+    readonly headers: Readonly<Record<string, string>>;
+}
+/** The subset of a ws WebSocket that the gateway session uses */
+export interface GatewaySocket {
+    readonly readyState: number;
+    send(data: string, callback: (error?: Error) => void): void;
+    close(code: number): void;
+    terminate(): void;
+    on(event: "message", listener: (data: SocketData, binary: boolean) => void): unknown;
+    on(event: "error", listener: (error: Error & {
+        code?: string;
+    }) => void): unknown;
+    on(event: "close", listener: (code: number) => void): unknown;
+    once(event: "close", listener: () => void): unknown;
+    off(event: "message", listener: (data: SocketData, binary: boolean) => void): unknown;
+    off(event: "error", listener: (error: Error & {
+        code?: string;
+    }) => void): unknown;
+    off(event: "close", listener: (() => void) | ((code: number) => void)): unknown;
+}
+/** Open one socket. Connection failures arrive as error or close events, and a synchronous throw is treated as an SDK defect */
+export type SocketFactory = (url: string, options: SocketOptions) => GatewaySocket;
+/** The ws library, sending exactly the given options */
+export declare const platformSocketFactory: (url: string, options: HeaderedSocketOptions) => GatewaySocket;
+/** Open every socket with the given User-Agent handshake header, replacing any other User-Agent value */
+export declare function withSocketUserAgent(sockets: (url: string, options: HeaderedSocketOptions) => GatewaySocket, userAgent: () => string): SocketFactory;
+/** The ws library with the SDK's default User-Agent */
+export declare const defaultSocketFactory: SocketFactory;
+//# sourceMappingURL=socket.d.ts.map

package/dist/internal/transport/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/internal/transport/socket.ts"],"names":[],"mappings":"AAUA,mEAAmE;AACnE,eAAO,MAAM,WAAW;yBAA+B,CAAC;mBAAQ,CAAC;sBAAW,CAAC;qBAAU,CAAC;EAAY,CAAA;AAEpG,iIAAiI;AACjI,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,UAAU,EAAE,GAAG,MAAM,CAAA;AAElF,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAA;IACjC,kEAAkE;IAClE,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAA;IAC/B,4GAA4G;IAC5G,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACtD;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IACxD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACrD;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,IAAI,IAAI,CAAA;IACjB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAA;IACpF,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAA;IACjF,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;IAC7D,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAA;IACnD,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAA;IACrF,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAA;IAClF,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,OAAO,CAAA;CAClF;AAED,gIAAgI;AAChI,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,KAAK,aAAa,CAAA;AAElF,wDAAwD;AACxD,eAAO,MAAM,qBAAqB,QAAS,MAAM,WAAW,qBAAqB,KAAG,aACrD,CAAA;AAE/B,yGAAyG;AACzG,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,KAAK,aAAa,EACvE,SAAS,EAAE,MAAM,MAAM,GACxB,aAAa,CAQf;AAED,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,EAAE,aAA4E,CAAA"}

package/dist/internal/transport/socket.js

@@ -0,0 +1,27 @@
+/**
+ * WebSocket transport seam: The ws-shaped socket factory the gateway session opens its connection through.
+ * Invariant: Only this module imports ws, so gateway code depends on the GatewaySocket shape rather than the library,
+ * and the default factory applies the SDK's receive limit, redirect policy and User-Agent handshake header exactly as
+ * supplied.
+ * Implements [SDK contracts: Connection and recovery](/docs/SDK-CONTRACTS.md#connection-and-recovery)
+ */
+import WebSocket from "ws";
+import { defaultUserAgent } from "./user-agent.js";
+/** WebSocket ready states, matching the ws and WHATWG numbering */
+export const SocketState = Object.freeze({ connecting: 0, open: 1, closing: 2, closed: 3 });
+/** The ws library, sending exactly the given options */
+export const platformSocketFactory = (url, options) => new WebSocket(url, options);
+/** Open every socket with the given User-Agent handshake header, replacing any other User-Agent value */
+export function withSocketUserAgent(sockets, userAgent) {
+    return (url, options) => {
+        const headers = {};
+        for (const [name, value] of Object.entries(options.headers ?? {}))
+            if (name.toLowerCase() !== "user-agent")
+                headers[name] = value;
+        headers["User-Agent"] = userAgent();
+        return sockets(url, { ...options, headers: Object.freeze(headers) });
+    };
+}
+/** The ws library with the SDK's default User-Agent */
+export const defaultSocketFactory = withSocketUserAgent(platformSocketFactory, defaultUserAgent);
+//# sourceMappingURL=socket.js.map

package/dist/internal/transport/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../../src/internal/transport/socket.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,SAAS,MAAM,IAAI,CAAA;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAElD,mEAAmE;AACnE,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAW,CAAC,CAAA;AAwCpG,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAE,OAA8B,EAAiB,EAAE,CAChG,IAAI,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AAE/B,yGAAyG;AACzG,MAAM,UAAU,mBAAmB,CAC/B,OAAuE,EACvE,SAAuB;IAEvB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACpB,MAAM,OAAO,GAA2B,EAAE,CAAA;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;YAC7D,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,YAAY;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QAClE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,CAAA;QACnC,OAAO,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACxE,CAAC,CAAA;AACL,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAkB,mBAAmB,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAA"}

package/dist/internal/transport/user-agent.d.ts

@@ -0,0 +1,7 @@
+/** Longest caller-supplied User-Agent */
+export declare const userAgentMaxLength = 512;
+/** `Fluxerly.js/<version> (+<homepage>)`, read once from the SDK manifest */
+export declare function defaultUserAgent(): string;
+/** Whether a caller value is a usable User-Agent: Printable ASCII, bounded, without surrounding spaces */
+export declare function validUserAgent(value: unknown): value is string;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/internal/transport/user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.d.ts","sourceRoot":"","sources":["../../../src/internal/transport/user-agent.ts"],"names":[],"mappings":"AAUA,yCAAyC;AACzC,eAAO,MAAM,kBAAkB,MAAM,CAAA;AAgBrC,6EAA6E;AAC7E,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,0GAA0G;AAC1G,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQ9D"}