@kuralle-syrinx/browser-client 4.4.0 → 4.5.0

package/dist/turn-recorder.js

@@ -0,0 +1,168 @@
+// SPDX-License-Identifier: MIT
+//
+// TurnAudioRecorder — keeps the microphone PCM you already streamed, sliced per turn,
+// so a turn can be saved as a fixture. Without this the studio sends audio to the
+// server and keeps none of it, and the "capture a fixture" loop cannot close.
+//
+// Dependency-free and DOM-free, exported from the `/turn-recorder` subpath: it takes
+// Int16 frames and returns WAV bytes, so the same code runs in a browser, in Node, and
+// in CI. It holds no socket and no AudioContext — you push it the frames you were
+// sending anyway, and the server's own messages drive the turn boundaries.
+export const DEFAULT_RECORDER_OPTIONS = {
+    maxTurns: 10,
+    preRollMs: 300,
+    maxTurnMs: 60_000,
+};
+const DEFAULT_SAMPLE_RATE_HZ = 16_000;
+/** Minimal RIFF/WAVE header + samples. Mono PCM16 — the format every STT accepts. */
+export function encodeWav(samples, sampleRateHz) {
+    if (!Number.isFinite(sampleRateHz) || sampleRateHz <= 0) {
+        throw new Error(`encodeWav: invalid sampleRateHz ${String(sampleRateHz)}`);
+    }
+    const dataBytes = samples.length * 2;
+    const out = new Uint8Array(44 + dataBytes);
+    const view = new DataView(out.buffer);
+    const ascii = (offset, text) => {
+        for (let i = 0; i < text.length; i += 1)
+            out[offset + i] = text.charCodeAt(i);
+    };
+    ascii(0, "RIFF");
+    view.setUint32(4, 36 + dataBytes, true);
+    ascii(8, "WAVE");
+    ascii(12, "fmt ");
+    view.setUint32(16, 16, true); // PCM chunk size
+    view.setUint16(20, 1, true); // PCM
+    view.setUint16(22, 1, true); // mono
+    view.setUint32(24, sampleRateHz, true);
+    view.setUint32(28, sampleRateHz * 2, true); // byte rate
+    view.setUint16(32, 2, true); // block align
+    view.setUint16(34, 16, true); // bits per sample
+    ascii(36, "data");
+    view.setUint32(40, dataBytes, true);
+    // Copy through a DataView so the result is little-endian on every host, rather than
+    // inheriting the platform's byte order via Int16Array.set.
+    for (let i = 0; i < samples.length; i += 1) {
+        view.setInt16(44 + i * 2, samples[i] ?? 0, true);
+    }
+    return out;
+}
+export class TurnAudioRecorder {
+    options;
+    sampleRateHz = DEFAULT_SAMPLE_RATE_HZ;
+    /** Rolling pre-roll, trimmed to preRollMs on every push. */
+    preRoll = [];
+    preRollLength = 0;
+    open;
+    /** Sealed but not yet attributed to a turnId — turnId arrives with a later message. */
+    pending;
+    turns = new Map();
+    constructor(options = {}) {
+        this.options = { ...DEFAULT_RECORDER_OPTIONS, ...options };
+    }
+    /** Push the uplink frame you are already sending. Cheap: retains the reference, copies on seal. */
+    pushFrame(frame) {
+        if (frame.length === 0)
+            return;
+        if (this.open) {
+            const cap = Math.floor((this.options.maxTurnMs / 1000) * this.sampleRateHz);
+            if (this.open.length >= cap) {
+                this.open.truncated = true;
+                return;
+            }
+            this.open.samples.push(frame);
+            this.open.length += frame.length;
+            return;
+        }
+        this.preRoll.push(frame);
+        this.preRollLength += frame.length;
+        const keep = Math.floor((this.options.preRollMs / 1000) * this.sampleRateHz);
+        while (this.preRollLength - (this.preRoll[0]?.length ?? 0) >= keep && this.preRoll.length > 1) {
+            this.preRollLength -= this.preRoll.shift()?.length ?? 0;
+        }
+    }
+    /** Feed the same messages you feed the SessionRecord. Turn boundaries come from the server. */
+    onMessage(message) {
+        const type = message.type;
+        if (type === "ready") {
+            const rate = message.audio?.inputSampleRateHz;
+            if (typeof rate === "number" && Number.isFinite(rate) && rate > 0)
+                this.sampleRateHz = rate;
+            return;
+        }
+        const turnId = typeof message.turnId === "string"
+            ? message.turnId
+            : undefined;
+        if (type === "speech_started") {
+            // Start from the pre-roll so the onset is present.
+            this.open = { samples: [...this.preRoll], length: this.preRollLength, truncated: false };
+            this.preRoll = [];
+            this.preRollLength = 0;
+            if (turnId !== undefined)
+                this.attributeOnSeal = turnId;
+            return;
+        }
+        if (type === "speech_ended" || type === "stt_output" || type === "turn_complete") {
+            this.seal(turnId);
+            return;
+        }
+    }
+    attributeOnSeal;
+    seal(turnId) {
+        if (this.open) {
+            const merged = new Int16Array(this.open.length);
+            let offset = 0;
+            for (const chunk of this.open.samples) {
+                merged.set(chunk, offset);
+                offset += chunk.length;
+            }
+            this.pending = { samples: merged, truncated: this.open.truncated };
+            this.open = undefined;
+        }
+        if (!this.pending)
+            return;
+        const id = turnId ?? this.attributeOnSeal;
+        if (id === undefined)
+            return; // wait for a message that names the turn
+        this.attributeOnSeal = undefined;
+        this.turns.set(id, this.pending);
+        this.pending = undefined;
+        // Bounded by construction: audio blobs, not the records, are the memory risk.
+        while (this.turns.size > this.options.maxTurns) {
+            const oldest = this.turns.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.turns.delete(oldest);
+        }
+    }
+    /** WAV bytes for a turn, or undefined if it was never captured or has been evicted. */
+    getWav(turnId) {
+        const entry = this.turns.get(turnId);
+        return entry ? encodeWav(entry.samples, this.sampleRateHz) : undefined;
+    }
+    /** What audio is retained right now, oldest first. */
+    list() {
+        return [...this.turns.entries()].map(([turnId, entry]) => ({
+            turnId,
+            sampleRateHz: this.sampleRateHz,
+            durationMs: Math.round((entry.samples.length / this.sampleRateHz) * 1000),
+            byteLength: entry.samples.length * 2,
+            truncated: entry.truncated,
+        }));
+    }
+    /** Total retained audio in bytes — what a memory readout should show. */
+    retainedBytes() {
+        let total = 0;
+        for (const entry of this.turns.values())
+            total += entry.samples.length * 2;
+        return total;
+    }
+    reset() {
+        this.preRoll = [];
+        this.preRollLength = 0;
+        this.open = undefined;
+        this.pending = undefined;
+        this.attributeOnSeal = undefined;
+        this.turns.clear();
+    }
+}
+//# sourceMappingURL=turn-recorder.js.map

package/dist/turn-recorder.js.map

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

package/dist/turn-timeline.d.ts

@@ -0,0 +1,51 @@
+import type { TurnRecord } from "./session-record.js";
+export interface TimelineSegment {
+    readonly key: string;
+    /** Plain language. The reader does not know what `eos.turn_complete` is. */
+    readonly label: string;
+    readonly startMs: number;
+    readonly durationMs: number;
+    /** True for the longest segment — where the time actually went. */
+    readonly slowest: boolean;
+}
+export interface TurnTimeline {
+    readonly turnId: string;
+    readonly segments: readonly TimelineSegment[];
+    readonly totalMs: number;
+    /** Why there is nothing to draw, when there is nothing to draw. */
+    readonly unavailable?: "no-metrics" | "insufficient-marks";
+    /**
+     * Set when the agent replied implausibly fast, which almost always means the
+     * endpointer fired while the caller was still speaking. Most tools celebrate
+     * this number; it is usually a defect.
+     */
+    readonly suspiciouslyFast?: {
+        readonly totalMs: number;
+        readonly floorMs: number;
+    };
+}
+/**
+ * Below this, a reply is not "fast" — the endpointer almost certainly cut the
+ * caller off. Asserting a floor as well as a ceiling is the inversion no
+ * surveyed framework supports.
+ */
+export declare const FAST_TURN_FLOOR_MS = 700;
+export declare function buildTurnTimeline(turn: TurnRecord): TurnTimeline;
+export declare function buildTimelines(turns: readonly TurnRecord[]): readonly TurnTimeline[];
+export type EndpointingMarkerKind = "typed" | "endpoint" | "unknown";
+export interface EndpointingMarker {
+    readonly kind: EndpointingMarkerKind;
+    /** Plain language — never a packet or message name (`eos.turn_complete`, raw `provider_stt`, …). */
+    readonly text: string;
+}
+/**
+ * Turn an endpointing decision into the words a person reads. Internal type
+ * values (`provider_stt`, `smart_turn`, `timer`, `text`, `force_finalized`, …)
+ * stay internal; this is the only place they cross into user-facing text.
+ *
+ * A genuinely unknown decision is returned as `kind: "unknown"` rather than
+ * guessed — a debugging surface that fabricates a cause is worse than one that
+ * says it does not know.
+ */
+export declare function endpointingMarker(owner?: string, reason?: string): EndpointingMarker;
+//# sourceMappingURL=turn-timeline.d.ts.map

package/dist/turn-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-timeline.d.ts","sourceRoot":"","sources":["../src/turn-timeline.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,qBAAqB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,GAAG,oBAAoB,CAAC;IAC3D;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACpF;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAiBtC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CA+BhE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,YAAY,EAAE,CAEpF;AASD,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,oGAAoG;IACpG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CA0BpF"}

package/dist/turn-timeline.js

@@ -0,0 +1,92 @@
+// SPDX-License-Identifier: MIT
+//
+// Turn timeline — the per-turn latency waterfall, computed from the `metrics`
+// message the server already sends.
+//
+// "It cut me off" is not actionable; a lane showing speech ending at 2.1s and the
+// endpoint firing at 2.16s is. This is the view no competing playground ships,
+// and the data has been arriving in the browser all along.
+//
+// Pure and DOM-free, so a timeline can be rendered from a recorded fixture in a
+// test rather than only from a live provider.
+/**
+ * Below this, a reply is not "fast" — the endpointer almost certainly cut the
+ * caller off. Asserting a floor as well as a ceiling is the inversion no
+ * surveyed framework supports.
+ */
+export const FAST_TURN_FLOOR_MS = 700;
+// Ordered marks. Each segment spans one mark to the next, so a missing mark
+// collapses its segment rather than corrupting the ones around it.
+const MARKS = [
+    { field: "speechEndMs", label: "You stopped speaking" },
+    { field: "textReadyMs", label: "Deciding you're done, transcribing, and thinking" },
+    // Segments are labelled by the mark that ENDS them, so this one covers
+    // textReady -> firstAudioByte: the reply text already exists and we are waiting on
+    // speech. That is time-to-first-audio, which `session-metrics` reports as
+    // "Voice (to first audio)" from the same field. Calling it "Thinking" made the two
+    // panels name one quantity two different things.
+    { field: "firstAudioByteMs", label: "Voice (to first audio)" },
+    { field: "firstAudioPlayedMs", label: "First audio out" },
+    { field: "lastAudioPlayedMs", label: "Agent speaking" },
+];
+export function buildTurnTimeline(turn) {
+    const t = turn.timings;
+    if (!t) {
+        // The Workers path emits no `metrics` at all (proven by LDT-18). Say so
+        // rather than rendering an empty lane that looks like a zero-latency turn.
+        return { turnId: turn.turnId, segments: [], totalMs: 0, unavailable: "no-metrics" };
+    }
+    const points = MARKS.map(({ field, label }) => ({ label, at: t[field] })).filter((p) => typeof p.at === "number");
+    if (points.length < 2) {
+        return { turnId: turn.turnId, segments: [], totalMs: t.e2eMs ?? 0, unavailable: "insufficient-marks" };
+    }
+    const origin = points[0]?.at ?? 0;
+    const raw = points.slice(1).map((p, i) => {
+        const prev = points[i];
+        const startMs = (prev?.at ?? origin) - origin;
+        return { key: p.label, label: p.label, startMs, durationMs: Math.max(0, p.at - (prev?.at ?? origin)) };
+    });
+    const longest = raw.reduce((max, s) => Math.max(max, s.durationMs), 0);
+    const segments = raw.map((s) => ({ ...s, slowest: longest > 0 && s.durationMs === longest }));
+    const totalMs = t.e2eMs ?? (points[points.length - 1]?.at ?? origin) - origin;
+    const suspiciouslyFast = totalMs > 0 && totalMs < FAST_TURN_FLOOR_MS ? { totalMs, floorMs: FAST_TURN_FLOOR_MS } : undefined;
+    return { turnId: turn.turnId, segments, totalMs, ...(suspiciouslyFast ? { suspiciouslyFast } : {}) };
+}
+export function buildTimelines(turns) {
+    return turns.map(buildTurnTimeline);
+}
+/**
+ * Turn an endpointing decision into the words a person reads. Internal type
+ * values (`provider_stt`, `smart_turn`, `timer`, `text`, `force_finalized`, …)
+ * stay internal; this is the only place they cross into user-facing text.
+ *
+ * A genuinely unknown decision is returned as `kind: "unknown"` rather than
+ * guessed — a debugging surface that fabricates a cause is worse than one that
+ * says it does not know.
+ */
+export function endpointingMarker(owner, reason) {
+    if (owner === "text") {
+        return {
+            kind: "typed",
+            text: "You typed this turn — nothing transcribed you and nothing judged when you finished, so no endpointer ran.",
+        };
+    }
+    const who = owner === "provider_stt"
+        ? "The speech-to-text provider"
+        : owner === "smart_turn"
+            ? "The Smart Turn model"
+            : owner === "timer"
+                ? "A turn timer"
+                : undefined;
+    if (who === undefined) {
+        return {
+            kind: "unknown",
+            text: "This backend did not report what ended the turn, so the cause is unknown.",
+        };
+    }
+    const text = reason === "force_finalized"
+        ? `${who} force-finalized the transcript after a timeout, not a natural end of speech.`
+        : `${who} decided you had finished speaking.`;
+    return { kind: "endpoint", text };
+}
+//# sourceMappingURL=turn-timeline.js.map

package/dist/turn-timeline.js.map

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

package/dist/websocket-transport.d.ts

@@ -0,0 +1,20 @@
+import type { ClientTransport, ClientTransportHandlers } from "./transport.js";
+export interface WebSocketClientTransportOptions {
+    readonly protocols?: string | readonly string[];
+}
+export declare class WebSocketClientTransport implements ClientTransport {
+    private readonly options;
+    private socket;
+    private pendingUrl;
+    private handlers;
+    constructor(options?: WebSocketClientTransportOptions);
+    get connected(): boolean;
+    setHandlers(handlers: ClientTransportHandlers): void;
+    connect(url: string): void;
+    disconnect(code?: number, reason?: string): void;
+    sendAudio(data: Uint8Array | ArrayBuffer): void;
+    sendJson(value: unknown): void;
+    private requireOpenSocket;
+    private dispatchMessage;
+}
+//# sourceMappingURL=websocket-transport.d.ts.map

package/dist/websocket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.d.ts","sourceRoot":"","sources":["../src/websocket-transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACjD;AAED,qBAAa,wBAAyB,YAAW,eAAe;IAKlD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAA+B;gBAElB,OAAO,GAAE,+BAAoC;IAE1E,IAAI,SAAS,IAAI,OAAO,CAGvB;IAED,WAAW,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAIpD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAqC1B,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKhD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IAM/C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,eAAe;CAiBxB"}

package/dist/websocket-transport.js

@@ -0,0 +1,92 @@
+// SPDX-License-Identifier: MIT
+export class WebSocketClientTransport {
+    options;
+    socket = null;
+    pendingUrl = null;
+    handlers = {};
+    constructor(options = {}) {
+        this.options = options;
+    }
+    get connected() {
+        const state = this.socket?.readyState;
+        return state === WebSocket.OPEN;
+    }
+    setHandlers(handlers) {
+        this.handlers = handlers;
+    }
+    connect(url) {
+        const state = this.socket?.readyState;
+        if (state === WebSocket.OPEN)
+            return;
+        if (state === WebSocket.CLOSING) {
+            this.pendingUrl = url;
+            const closingSocket = this.socket;
+            const onClose = () => {
+                closingSocket.removeEventListener("close", onClose);
+                if (this.socket !== closingSocket)
+                    return;
+                const nextUrl = this.pendingUrl;
+                this.pendingUrl = null;
+                this.socket = null;
+                if (nextUrl)
+                    this.connect(nextUrl);
+            };
+            closingSocket.addEventListener("close", onClose);
+            return;
+        }
+        if (state === WebSocket.CONNECTING)
+            return;
+        this.pendingUrl = null;
+        const socket = new WebSocket(url, this.options.protocols);
+        socket.binaryType = "arraybuffer";
+        this.socket = socket;
+        socket.addEventListener("open", () => {
+            this.handlers.onOpen?.();
+        });
+        socket.addEventListener("close", (event) => {
+            this.handlers.onClose?.(event.code, event.reason);
+        });
+        socket.addEventListener("error", (event) => {
+            this.handlers.onError?.(event);
+        });
+        socket.addEventListener("message", (event) => {
+            this.dispatchMessage(event.data);
+        });
+    }
+    disconnect(code, reason) {
+        this.pendingUrl = null;
+        this.socket?.close(code, reason);
+    }
+    sendAudio(data) {
+        const socket = this.requireOpenSocket();
+        const bytes = data instanceof Uint8Array ? data : new Uint8Array(data);
+        socket.send(bytes);
+    }
+    sendJson(value) {
+        this.requireOpenSocket().send(JSON.stringify(value));
+    }
+    requireOpenSocket() {
+        if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
+            throw new Error("ClientTransport WebSocket is not open");
+        }
+        return this.socket;
+    }
+    dispatchMessage(data) {
+        if (typeof data === "string") {
+            this.handlers.onMessage?.(data);
+            return;
+        }
+        if (data instanceof Blob) {
+            void data.arrayBuffer().then((buffer) => {
+                this.handlers.onAudio?.(buffer);
+            }).catch((err) => {
+                this.handlers.onError?.(err instanceof Error ? err : new Error(String(err)));
+            });
+            return;
+        }
+        if (data instanceof ArrayBuffer) {
+            this.handlers.onAudio?.(data);
+        }
+    }
+}
+//# sourceMappingURL=websocket-transport.js.map

package/dist/websocket-transport.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuralle-syrinx/browser-client",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "private": false,
   "description": "Browser client for the Syrinx WebSocket audio protocol — mic capture, opus, jitter buffer, playout progress reporting, reconnect",
   "keywords": [
@@ -23,28 +23,52 @@
     "url": "https://github.com/kuralle/syrinx/issues"
   },
   "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./record": "./src/session-record.ts",
-    "./agent-state": "./src/agent-state.ts",
-    "./turn-timeline": "./src/turn-timeline.ts",
-    "./session-metrics": "./src/session-metrics.ts",
-    "./turn-recorder": "./src/turn-recorder.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./record": {
+      "types": "./dist/session-record.d.ts",
+      "default": "./dist/session-record.js"
+    },
+    "./agent-state": {
+      "types": "./dist/agent-state.d.ts",
+      "default": "./dist/agent-state.js"
+    },
+    "./turn-timeline": {
+      "types": "./dist/turn-timeline.d.ts",
+      "default": "./dist/turn-timeline.js"
+    },
+    "./session-metrics": {
+      "types": "./dist/session-metrics.d.ts",
+      "default": "./dist/session-metrics.js"
+    },
+    "./turn-recorder": {
+      "types": "./dist/turn-recorder.d.ts",
+      "default": "./dist/turn-recorder.js"
+    }
   },
   "dependencies": {
     "@evan/opus": "1.0.3",
-    "@kuralle-syrinx/core": "4.4.0"
+    "@kuralle-syrinx/core": "4.5.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
     "vite": "^6.4.3",
     "vitest": "^3.2.6"
   },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
   "scripts": {
     "dev": "vite --port 5173",
-    "build": "vite build",
+    "build": "tsc -p tsconfig.build.json",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"