hci-atrium 0.1.0

package/dist/shaping/structured.js

@@ -0,0 +1,115 @@
+/**
+ * Structured-output plumbing — the mirror of ``_structured.py``, using **Zod** as the OpenAI TS SDK
+ * does (decision 3). Zod is an *optional* peer dependency: nothing here imports it at module top;
+ * a schema is duck-typed at runtime and the module is loaded lazily only to derive its JSON Schema.
+ *
+ * The flow (client-orchestrated, like Python's): send the schema as OpenAI's ``json_schema``
+ * response_format, validate the reply, and on failure run ONE repair turn before throwing
+ * {@link StructuredOutputError}. The pure pieces (JSON extraction, validation, repair messages) live
+ * here; the client owns the two ``chat`` calls.
+ */
+import { InvalidArgumentError, StructuredOutputError } from "../errors.js";
+/** A safe, universally-supported response_format for the repair turn: plain JSON mode. */
+export const JSON_OBJECT = { type: "json_object" };
+// Sentinel: no JSON value at all in the reply — distinct from a parsed literal ``null``.
+const NO_JSON = Symbol("no-json");
+/** True when ``value`` looks like a Zod schema (the structured-output path). */
+export function isZodSchema(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "safeParse" in value &&
+        typeof value.safeParse === "function");
+}
+/**
+ * Build the OpenAI ``json_schema`` response_format for a Zod schema. Async because it lazily loads
+ * Zod (v4's ``z.toJSONSchema``) — never imported at module top so the SDK installs without Zod.
+ * Throws {@link InvalidArgumentError} when Zod (v4+) isn't resolvable.
+ */
+export async function responseFormatParam(schema, name = "response") {
+    // Non-literal specifier: TS treats the import as ``any`` and skips resolving "zod" at build time,
+    // so the optional peer dep need not be installed to compile the SDK.
+    const specifier = "zod";
+    let jsonSchema;
+    try {
+        const zod = (await import(specifier));
+        if (typeof zod.toJSONSchema !== "function") {
+            throw new Error("z.toJSONSchema is unavailable (Zod v4+ required)");
+        }
+        jsonSchema = zod.toJSONSchema(schema);
+    }
+    catch (err) {
+        throw new InvalidArgumentError("structured output needs Zod v4+ installed (npm i zod); " +
+            `could not derive a JSON schema: ${err.message}`);
+    }
+    return { type: "json_schema", json_schema: { name, schema: jsonSchema } };
+}
+/**
+ * Parse a JSON value out of a model reply — the whole string, else the outermost ``{…}`` or
+ * ``[…]`` (tolerating code fences / surrounding chatter). {@link NO_JSON} when nothing parses.
+ */
+function extractJson(text) {
+    const stripped = text.trim();
+    try {
+        return JSON.parse(stripped);
+    }
+    catch {
+        // fall through to the bracket-slice fallback
+    }
+    // Try the EARLIEST opener first (it's the outermost structure).
+    const slices = [];
+    for (const [opener, closer] of [
+        ["{", "}"],
+        ["[", "]"],
+    ]) {
+        const start = stripped.indexOf(opener);
+        const end = stripped.lastIndexOf(closer);
+        if (start !== -1 && end > start) {
+            slices.push([start, stripped.slice(start, end + 1)]);
+        }
+    }
+    slices.sort((a, b) => a[0] - b[0]);
+    for (const [, blob] of slices) {
+        try {
+            return JSON.parse(blob);
+        }
+        catch {
+            // try the next slice
+        }
+    }
+    return NO_JSON;
+}
+/**
+ * Validate ``text`` into ``schema``. Returns ``[value, ""]`` on success or ``[null, detail]`` with
+ * a human-readable reason on failure (never throws).
+ */
+export function tryParse(schema, text) {
+    const payload = extractJson(text);
+    if (payload === NO_JSON) {
+        return [null, "no JSON value found in the reply"];
+    }
+    const result = schema.safeParse(payload);
+    if (result.success) {
+        return [result.data, ""];
+    }
+    return [null, String(result.error?.message ?? result.error)];
+}
+/**
+ * The message list for the single repair turn: the prior turns, the model's bad reply, and a
+ * correction quoting the error and the JSON schema to conform to.
+ */
+export function repairMessages(messages, badReply, detail, jsonSchema) {
+    const correction = "Your previous reply was not valid JSON for the required schema.\n" +
+        `Error: ${detail}\n` +
+        "Return ONLY a JSON object matching this schema — no prose, no code fences:\n" +
+        JSON.stringify(jsonSchema);
+    return [
+        ...messages,
+        { role: "assistant", content: badReply },
+        { role: "user", content: correction },
+    ];
+}
+/** Build the terminal error raised when the repair turn still didn't yield valid output. */
+export function structuredError(schemaName, raw, detail) {
+    return new StructuredOutputError(schemaName, raw, detail);
+}
+//# sourceMappingURL=structured.js.map

package/dist/shaping/structured.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Browser-storage helpers, namespaced per ``(baseUrl, clientId)`` so multiple ``Atrium`` instances
+ * never collide.
+ *
+ * Every access is guarded: on a server, in private-mode browsers, or wherever storage throws, the
+ * stores degrade to no-ops rather than throwing — importing and constructing the SDK stays safe.
+ */
+/** Persisted OAuth tokens. ``expiresAt`` is an epoch-millisecond timestamp. */
+export interface StoredTokens {
+    accessToken: string;
+    refreshToken: string | null;
+    expiresAt: number;
+}
+/** The transient PKCE state stashed across the authorize redirect. */
+export interface PkceStash {
+    verifier: string;
+    state: string;
+    redirectUri: string;
+}
+/** Long-lived token cache in ``localStorage``. */
+export declare class TokenStore {
+    private readonly key;
+    constructor(baseUrl: string, clientId: string);
+    load(): StoredTokens | null;
+    save(tokens: StoredTokens): void;
+    clear(): void;
+}
+/** Short-lived PKCE stash in ``sessionStorage`` (survives the authorize redirect, not a new tab). */
+export declare class PkceStore {
+    private readonly key;
+    constructor(baseUrl: string, clientId: string);
+    save(stash: PkceStash): void;
+    load(): PkceStash | null;
+    clear(): void;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAqBD,kDAAkD;AAClD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;gBAEhB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAI7C,IAAI,IAAI,YAAY,GAAG,IAAI;IAiB3B,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIhC,KAAK,IAAI,IAAI;CAGd;AAED,qGAAqG;AACrG,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;gBAEhB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAI7C,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI5B,IAAI,IAAI,SAAS,GAAG,IAAI;IAiBxB,KAAK,IAAI,IAAI;CAGd"}

package/dist/storage.js

@@ -0,0 +1,86 @@
+/**
+ * Browser-storage helpers, namespaced per ``(baseUrl, clientId)`` so multiple ``Atrium`` instances
+ * never collide.
+ *
+ * Every access is guarded: on a server, in private-mode browsers, or wherever storage throws, the
+ * stores degrade to no-ops rather than throwing — importing and constructing the SDK stays safe.
+ */
+function safeStorage(kind) {
+    try {
+        const store = kind === "local" ? globalThis.localStorage : globalThis.sessionStorage;
+        if (!store) {
+            return null;
+        }
+        const probe = "__atrium_probe__";
+        store.setItem(probe, "1");
+        store.removeItem(probe);
+        return store;
+    }
+    catch {
+        return null;
+    }
+}
+function namespaced(prefix, baseUrl, clientId) {
+    return `${prefix}:${baseUrl}|${clientId}`;
+}
+/** Long-lived token cache in ``localStorage``. */
+export class TokenStore {
+    key;
+    constructor(baseUrl, clientId) {
+        this.key = namespaced("atrium.tokens", baseUrl, clientId);
+    }
+    load() {
+        const store = safeStorage("local");
+        if (!store) {
+            return null;
+        }
+        const raw = store.getItem(this.key);
+        if (!raw) {
+            return null;
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            return typeof parsed?.accessToken === "string" ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    save(tokens) {
+        safeStorage("local")?.setItem(this.key, JSON.stringify(tokens));
+    }
+    clear() {
+        safeStorage("local")?.removeItem(this.key);
+    }
+}
+/** Short-lived PKCE stash in ``sessionStorage`` (survives the authorize redirect, not a new tab). */
+export class PkceStore {
+    key;
+    constructor(baseUrl, clientId) {
+        this.key = namespaced("atrium.pkce", baseUrl, clientId);
+    }
+    save(stash) {
+        safeStorage("session")?.setItem(this.key, JSON.stringify(stash));
+    }
+    load() {
+        const store = safeStorage("session");
+        if (!store) {
+            return null;
+        }
+        const raw = store.getItem(this.key);
+        if (!raw) {
+            return null;
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            return typeof parsed?.verifier === "string" ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    clear() {
+        safeStorage("session")?.removeItem(this.key);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/transcribe-stream.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A narrow WebSocket client for the live transcription route (``WS /v1/audio/transcriptions/stream``)
+ * — the TypeScript port of Python's ``hci_atrium._transcribe_stream``.
+ *
+ * That route speaks the ``atrium.stt.v1`` *superset* dialect: a JSON ``start`` handshake, binary audio
+ * frames, a ``stop``, and ``ready`` / ``partial`` / ``final`` / ``done`` / ``error`` events down. The
+ * dispatch brain (streaming relay vs rolling-buffer re-transcription) lives in the backend; this
+ * client is dumb by design — connect, ``start``, send bytes / stop, iterate events, close.
+ *
+ * **Auth divergence from Python (browser-safe):** Python rides an ``Authorization: Bearer`` header on
+ * the handshake, which browsers can't set on a ``WebSocket``. So this client carries the credential
+ * in-band as an ``api_key`` field on the ``start`` frame — the backend's browser-safe first-frame path:
+ * it accepts the socket, reads ``start``, pops ``api_key`` (never logged), and validates it exactly
+ * like the header path. This keeps the long-lived credential out of the URL (and so out of every proxy
+ * and access log on the path), unlike the legacy ``?api_key=`` query the backend still tolerates. An
+ * invalid/missing key closes ``4401`` — arriving *after* the socket opened, but still surfaced as
+ * {@link AuthError}, never a silent fallback.
+ */
+import type { WebSocketCtor } from "./rooms/transport.js";
+/**
+ * Internal signal: the stream route isn't reachable *as a stream* for this caller — a refused
+ * connection, a proxy that strips the WebSocket upgrade, a non-``ready`` first frame, or a handshake
+ * timeout. The caller degrades to per-clip batch transcription. **Not** raised for an auth rejection
+ * ({@link AUTH_CLOSE_CODE}), which surfaces as {@link AuthError} since a silent fallback would just
+ * mask a fixable credential problem.
+ */
+export declare class StreamUnavailable extends Error {
+    constructor(message: string);
+}
+/** Options for opening a {@link TranscriptionStream}. */
+export interface TranscriptionStreamOptions {
+    /** Bearer/API-key credential — rides the ``start`` frame's ``api_key`` field (browsers can't set WS
+     * headers; the in-band path keeps it out of the URL and so out of proxy/access logs). */
+    token: string;
+    model?: string;
+    language?: string;
+    /** ``"pcm16"`` for a raw headerless stream (needs ``sampleRate``), else a container format. */
+    format: string;
+    sampleRate?: number;
+    /** Injected ``WebSocket`` constructor (defaults to the runtime global) — the test seam / Node <22. */
+    WebSocketCtor?: WebSocketCtor;
+}
+/** One open live-transcription WebSocket. Construct via {@link TranscriptionStream.open}. */
+export declare class TranscriptionStream {
+    private readonly ws;
+    private readonly inbox;
+    private closedItem;
+    private notify;
+    private opened;
+    private openResolve;
+    private openReject;
+    private constructor();
+    /**
+     * Connect, send ``start``, and wait for the server's ``ready`` frame. Rejects with {@link AuthError}
+     * on a rejected credential ({@link AUTH_CLOSE_CODE}) and {@link StreamUnavailable} for every other
+     * handshake failure — the caller turns the latter into a per-clip batch fallback.
+     */
+    static open(baseUrl: string, opts: TranscriptionStreamOptions): Promise<TranscriptionStream>;
+    /** Send one binary audio frame (a PCM16 slice, or a self-contained container clip). */
+    sendBytes(data: ArrayBuffer): void;
+    /** Signal end-of-input — the server flushes, sends ``done``, and closes. */
+    sendStop(): void;
+    /**
+     * Iterate inbound JSON events until the connection closes. Binary frames and unparseable text are
+     * skipped; unknown ``type``s are yielded as-is (the caller ignores what it doesn't know).
+     *
+     * The close code is *not* swallowed: a mid-session {@link AUTH_CLOSE_CODE} throws {@link AuthError},
+     * a clean ``1000`` returns normally (the caller then checks whether a ``done`` actually arrived), and
+     * any other (abnormal) close throws {@link AtriumError} — a server crash / proxy kill / dropped
+     * connection must never read as a clean end.
+     */
+    events(): AsyncGenerator<Record<string, unknown>>;
+    /** Close the underlying socket (never throws). */
+    close(): void;
+    private attach;
+    private push;
+    private recv;
+    private recvWithin;
+    private waitOpen;
+}
+//# sourceMappingURL=transcribe-stream.d.ts.map

package/dist/transcribe-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe-stream.d.ts","sourceRoot":"","sources":["../src/transcribe-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,sBAAsB,CAAA;AAYxE;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAK5B;AAED,yDAAyD;AACzD,MAAM,WAAW,0BAA0B;IACzC;6FACyF;IACzF,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sGAAsG;IACtG,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAaD,6FAA6F;AAC7F,qBAAa,mBAAmB;IAQV,OAAO,CAAC,QAAQ,CAAC,EAAE;IAPvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAA2C;IAE7D,OAAO;IAEP;;;;OAIG;WACU,IAAI,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,mBAAmB,CAAC;IAkD/B,uFAAuF;IACvF,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAIlC,4EAA4E;IAC5E,QAAQ,IAAI,IAAI;IAIhB;;;;;;;;OAQG;IACI,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAgBxD,kDAAkD;IAClD,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,MAAM;IAwBd,OAAO,CAAC,IAAI;YAUE,IAAI;IASlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;CAajB"}

package/dist/transcribe-stream.js

@@ -0,0 +1,253 @@
+/**
+ * A narrow WebSocket client for the live transcription route (``WS /v1/audio/transcriptions/stream``)
+ * — the TypeScript port of Python's ``hci_atrium._transcribe_stream``.
+ *
+ * That route speaks the ``atrium.stt.v1`` *superset* dialect: a JSON ``start`` handshake, binary audio
+ * frames, a ``stop``, and ``ready`` / ``partial`` / ``final`` / ``done`` / ``error`` events down. The
+ * dispatch brain (streaming relay vs rolling-buffer re-transcription) lives in the backend; this
+ * client is dumb by design — connect, ``start``, send bytes / stop, iterate events, close.
+ *
+ * **Auth divergence from Python (browser-safe):** Python rides an ``Authorization: Bearer`` header on
+ * the handshake, which browsers can't set on a ``WebSocket``. So this client carries the credential
+ * in-band as an ``api_key`` field on the ``start`` frame — the backend's browser-safe first-frame path:
+ * it accepts the socket, reads ``start``, pops ``api_key`` (never logged), and validates it exactly
+ * like the header path. This keeps the long-lived credential out of the URL (and so out of every proxy
+ * and access log on the path), unlike the legacy ``?api_key=`` query the backend still tolerates. An
+ * invalid/missing key closes ``4401`` — arriving *after* the socket opened, but still surfaced as
+ * {@link AuthError}, never a silent fallback.
+ */
+import { AtriumError, AuthError } from "./errors.js";
+const STREAM_PATH = "/v1/audio/transcriptions/stream";
+/** The server closes with this application code when the credential is rejected — distinct from a
+ * "route not here" failure because retrying won't heal it (so it surfaces as {@link AuthError}, not a
+ * {@link StreamUnavailable} fallback). */
+const AUTH_CLOSE_CODE = 4401;
+/** Budget for the whole handshake (connect + the ``ready`` reply). Python leans on ``websockets``'
+ * default ``open_timeout`` (~10s); a browser ``WebSocket`` can't separate connect from the first read,
+ * so one budget covers both — a hung route degrades to the per-clip fallback rather than hanging. */
+const HANDSHAKE_TIMEOUT_MS = 10_000;
+/**
+ * Internal signal: the stream route isn't reachable *as a stream* for this caller — a refused
+ * connection, a proxy that strips the WebSocket upgrade, a non-``ready`` first frame, or a handshake
+ * timeout. The caller degrades to per-clip batch transcription. **Not** raised for an auth rejection
+ * ({@link AUTH_CLOSE_CODE}), which surfaces as {@link AuthError} since a silent fallback would just
+ * mask a fixable credential problem.
+ */
+export class StreamUnavailable extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "StreamUnavailable";
+        Object.setPrototypeOf(this, StreamUnavailable.prototype);
+    }
+}
+function toWsScheme(baseUrl) {
+    return baseUrl.replace(/^http/, "ws").replace(/\/+$/, "");
+}
+function streamUrl(baseUrl) {
+    // No query params: the credential rides the ``start`` frame, everything else the ``start`` message.
+    return `${toWsScheme(baseUrl)}${STREAM_PATH}`;
+}
+/** One open live-transcription WebSocket. Construct via {@link TranscriptionStream.open}. */
+export class TranscriptionStream {
+    ws;
+    inbox = [];
+    closedItem = null;
+    notify = null;
+    opened = false;
+    openResolve = null;
+    openReject = null;
+    constructor(ws) {
+        this.ws = ws;
+    }
+    /**
+     * Connect, send ``start``, and wait for the server's ``ready`` frame. Rejects with {@link AuthError}
+     * on a rejected credential ({@link AUTH_CLOSE_CODE}) and {@link StreamUnavailable} for every other
+     * handshake failure — the caller turns the latter into a per-clip batch fallback.
+     */
+    static async open(baseUrl, opts) {
+        const Ctor = opts.WebSocketCtor ?? globalThis.WebSocket;
+        if (!Ctor) {
+            throw new Error("Atrium: no WebSocket implementation — pass { webSocketCtor } (Node <22 has none global)");
+        }
+        const ws = new Ctor(streamUrl(baseUrl));
+        const stream = new TranscriptionStream(ws);
+        stream.attach();
+        try {
+            await stream.waitOpen();
+        }
+        catch (reason) {
+            stream.close();
+            if (isCloseItem(reason) && reason.code === AUTH_CLOSE_CODE) {
+                throw new AuthError(401, "transcription stream rejected the credential (close 4401)");
+            }
+            throw new StreamUnavailable(`transcription stream handshake failed: ${describe(reason)}`);
+        }
+        // The credential rides here (the browser-safe first-frame path), so the server pops it before any
+        // processing. A rejected key closes 4401 *after* the socket opened — caught below as AuthError.
+        const start = {
+            type: "start",
+            protocol: 1,
+            format: opts.format,
+            api_key: opts.token,
+        };
+        if (opts.language != null)
+            start.language = opts.language;
+        if (opts.model != null)
+            start.model = opts.model;
+        if (opts.format === "pcm16")
+            start.sample_rate = opts.sampleRate;
+        ws.send(JSON.stringify(start));
+        const first = await stream.recvWithin(HANDSHAKE_TIMEOUT_MS);
+        if (first.kind === "close") {
+            stream.close();
+            // A post-open 4401 is the rejected first-frame credential — AuthError, never a degrade-to-batch
+            // fallback (a fixable credential problem must not silently mask itself).
+            if (first.code === AUTH_CLOSE_CODE) {
+                throw new AuthError(401, "transcription stream rejected the credential (close 4401)");
+            }
+            throw new StreamUnavailable(`stream closed during handshake (close ${first.code ?? "?"})`);
+        }
+        const msg = parseJson(first.data);
+        if (msg && msg.type === "ready")
+            return stream;
+        stream.close();
+        throw new StreamUnavailable(`expected a 'ready' frame, got: ${JSON.stringify(first.data)}`);
+    }
+    /** Send one binary audio frame (a PCM16 slice, or a self-contained container clip). */
+    sendBytes(data) {
+        this.ws.send(data);
+    }
+    /** Signal end-of-input — the server flushes, sends ``done``, and closes. */
+    sendStop() {
+        this.ws.send(JSON.stringify({ type: "stop" }));
+    }
+    /**
+     * Iterate inbound JSON events until the connection closes. Binary frames and unparseable text are
+     * skipped; unknown ``type``s are yielded as-is (the caller ignores what it doesn't know).
+     *
+     * The close code is *not* swallowed: a mid-session {@link AUTH_CLOSE_CODE} throws {@link AuthError},
+     * a clean ``1000`` returns normally (the caller then checks whether a ``done`` actually arrived), and
+     * any other (abnormal) close throws {@link AtriumError} — a server crash / proxy kill / dropped
+     * connection must never read as a clean end.
+     */
+    async *events() {
+        while (true) {
+            const item = await this.recv();
+            if (item.kind === "close") {
+                if (item.code === AUTH_CLOSE_CODE) {
+                    throw new AuthError(401, "transcription stream rejected the credential (close 4401)");
+                }
+                if (item.code === 1000)
+                    return;
+                throw new AtriumError(`transcription stream closed abnormally (close ${item.code ?? "?"})`);
+            }
+            if (typeof item.data !== "string")
+                continue; // binary — skip
+            const msg = parseJson(item.data);
+            if (msg)
+                yield msg;
+        }
+    }
+    /** Close the underlying socket (never throws). */
+    close() {
+        try {
+            this.ws.close();
+        }
+        catch {
+            // Closing a half-broken socket must never mask the real error.
+        }
+    }
+    // --- internals ---------------------------------------------------------------------------------
+    attach() {
+        this.ws.binaryType = "arraybuffer";
+        this.ws.onopen = () => {
+            this.opened = true;
+            const resolve = this.openResolve;
+            this.openResolve = null;
+            this.openReject = null;
+            resolve?.();
+        };
+        this.ws.onmessage = (ev) => this.push({ kind: "message", data: ev.data });
+        this.ws.onclose = (ev) => {
+            const code = ev?.code;
+            const item = { kind: "close", code };
+            this.push(item);
+            if (!this.opened) {
+                const reject = this.openReject;
+                this.openResolve = null;
+                this.openReject = null;
+                reject?.(item);
+            }
+        };
+        this.ws.onerror = () => { };
+    }
+    push(item) {
+        // A close is sticky (delivered once buffered messages drain, then repeatedly) so a late reader
+        // still sees the end; messages queue in order.
+        if (item.kind === "close")
+            this.closedItem = item;
+        else
+            this.inbox.push(item);
+        const wake = this.notify;
+        this.notify = null;
+        wake?.();
+    }
+    async recv() {
+        while (this.inbox.length === 0 && this.closedItem === null) {
+            await new Promise((resolve) => {
+                this.notify = resolve;
+            });
+        }
+        return this.inbox.shift() ?? this.closedItem;
+    }
+    recvWithin(ms) {
+        return withTimeout(this.recv(), ms, () => new StreamUnavailable("handshake timed out"));
+    }
+    waitOpen() {
+        if (this.opened)
+            return Promise.resolve();
+        if (this.closedItem)
+            return Promise.reject(this.closedItem);
+        const gate = new Promise((resolve, reject) => {
+            this.openResolve = resolve;
+            this.openReject = reject;
+        });
+        return withTimeout(gate, HANDSHAKE_TIMEOUT_MS, () => new StreamUnavailable("handshake timed out"));
+    }
+}
+function withTimeout(promise, ms, onTimeout) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(onTimeout()), ms);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (reason) => {
+            clearTimeout(timer);
+            reject(reason);
+        });
+    });
+}
+function isCloseItem(value) {
+    return typeof value === "object" && value !== null && value.kind === "close";
+}
+function describe(reason) {
+    if (isCloseItem(reason))
+        return `closed before ready (close ${reason.code ?? "?"})`;
+    if (reason instanceof Error)
+        return reason.message;
+    return String(reason);
+}
+function parseJson(raw) {
+    if (typeof raw !== "string")
+        return null;
+    try {
+        const value = JSON.parse(raw);
+        return value && typeof value === "object" && !Array.isArray(value)
+            ? value
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=transcribe-stream.js.map

package/dist/transcribe-stream.js.map

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