@polymorfa/browser 0.1.0-dev.20260922094209

package/dist/chat/voice-recorder.js

@@ -0,0 +1,346 @@
+import { ObservableController, } from "../controller.js";
+const CANDIDATE_TYPES = [
+    "audio/webm;codecs=opus",
+    "audio/webm",
+    "audio/ogg;codecs=opus",
+    "audio/ogg",
+    "audio/mp4",
+];
+function environment(options) {
+    const scope = globalThis;
+    return {
+        mediaDevices: options.mediaDevices ?? scope.navigator?.mediaDevices,
+        Recorder: options.MediaRecorder ?? scope.MediaRecorder,
+        Audio: options.AudioContext === null
+            ? undefined
+            : (options.AudioContext ??
+                scope.AudioContext ??
+                scope.webkitAudioContext),
+    };
+}
+function errorKind(cause) {
+    const name = cause?.name;
+    if (name === "NotAllowedError" || name === "SecurityError")
+        return "permission-denied";
+    if (name === "NotFoundError" || name === "OverconstrainedError")
+        return "unavailable";
+    return "failed";
+}
+/**
+ * Records a voice note from the microphone with `getUserMedia` and
+ * `MediaRecorder`, publishing status, elapsed time, and input level.
+ * `stop()` resolves with the recording as a `File`; `cancel()` discards it.
+ * Microphone tracks stop whenever recording ends and on `dispose()`.
+ */
+export class VoiceNoteRecorder extends ObservableController {
+    #options;
+    #clock;
+    #stream;
+    #recorder;
+    #audio;
+    #frame;
+    #timer;
+    #chunks = [];
+    #startedAt = 0;
+    #lastPublish = 0;
+    #attempt = 0;
+    #finish;
+    constructor(options = {}) {
+        super({ status: "idle", elapsed: 0, level: 0 }, options.now);
+        this.#options = options;
+        this.#clock = options.now ?? Date.now;
+    }
+    /** Whether this environment can record: `getUserMedia` and `MediaRecorder`. */
+    static isSupported(options = {}) {
+        const { mediaDevices, Recorder } = environment(options);
+        return (typeof mediaDevices?.getUserMedia === "function" &&
+            typeof Recorder === "function");
+    }
+    /** Ask for the microphone and start recording. Resolves once recording. */
+    async start() {
+        this.assertActive();
+        const status = this.getSnapshot().status;
+        if (status === "requesting" || status === "recording")
+            return;
+        const { mediaDevices, Recorder, Audio } = environment(this.#options);
+        if (typeof mediaDevices?.getUserMedia !== "function" || !Recorder) {
+            this.#fail("unavailable");
+            return;
+        }
+        const attempt = ++this.#attempt;
+        this.transition({ status: "requesting", elapsed: 0, level: 0 });
+        let stream;
+        try {
+            stream = await mediaDevices.getUserMedia({ audio: true });
+        }
+        catch (cause) {
+            if (attempt === this.#attempt && !this.#disposed())
+                this.#fail(errorKind(cause));
+            return;
+        }
+        if (attempt !== this.#attempt || this.#disposed()) {
+            stopTracks(stream);
+            return;
+        }
+        const mimeType = CANDIDATE_TYPES.find((type) => Recorder.isTypeSupported?.(type) === true);
+        let recorder;
+        try {
+            recorder = new Recorder(stream, mimeType === undefined ? undefined : { mimeType });
+        }
+        catch {
+            stopTracks(stream);
+            this.#fail("failed");
+            return;
+        }
+        this.#stream = stream;
+        this.#recorder = recorder;
+        this.#chunks = [];
+        recorder.ondataavailable = (event) => {
+            if (event.data.size > 0)
+                this.#chunks.push(event.data);
+        };
+        recorder.onstop = () => this.#finalize(recorder);
+        recorder.onerror = () => {
+            this.#release();
+            this.#resolve(undefined);
+            if (!this.#disposed())
+                this.#fail("failed");
+        };
+        try {
+            recorder.start(250);
+        }
+        catch {
+            this.#release();
+            this.#fail("failed");
+            return;
+        }
+        this.#startedAt = this.#clock();
+        const container = containerType(recorder.mimeType || mimeType);
+        this.transition({
+            status: "recording",
+            elapsed: 0,
+            level: 0,
+            ...(container === undefined ? {} : { mimeType: container }),
+        });
+        this.#startMeter(stream, Audio);
+    }
+    /**
+     * Stop recording and resolve with the voice note, or `undefined` when
+     * nothing was recording or the recorder produced no audio.
+     */
+    stop() {
+        const recorder = this.#recorder;
+        if (recorder === undefined || this.getSnapshot().status !== "recording")
+            return Promise.resolve(undefined);
+        const current = this.getSnapshot();
+        this.transition({
+            status: "stopping",
+            elapsed: this.#clock() - this.#startedAt,
+            level: 0,
+            ...(current.mimeType === undefined ? {} : { mimeType: current.mimeType }),
+        });
+        this.#stopMeter();
+        return new Promise((resolve) => {
+            this.#finish = resolve;
+            try {
+                if (recorder.state === "inactive")
+                    this.#finalize(recorder);
+                else
+                    recorder.stop();
+            }
+            catch {
+                this.#finalize(recorder);
+            }
+        });
+    }
+    /** Discard the recording, or abandon a pending permission request. */
+    cancel() {
+        this.#attempt += 1;
+        const recorder = this.#recorder;
+        this.#chunks = [];
+        if (recorder !== undefined) {
+            recorder.ondataavailable = null;
+            recorder.onstop = null;
+            recorder.onerror = null;
+            try {
+                if (recorder.state !== "inactive")
+                    recorder.stop();
+            }
+            catch {
+                // Already stopped.
+            }
+        }
+        this.#release();
+        this.#resolve(undefined);
+        if (!this.#disposed())
+            this.transition({ status: "idle", elapsed: 0, level: 0 });
+    }
+    onDispose() {
+        this.#attempt += 1;
+        const recorder = this.#recorder;
+        if (recorder !== undefined) {
+            recorder.onstop = null;
+            recorder.onerror = null;
+            recorder.ondataavailable = null;
+            try {
+                if (recorder.state !== "inactive")
+                    recorder.stop();
+            }
+            catch {
+                // Already stopped.
+            }
+        }
+        this.#release();
+        this.#resolve(undefined);
+    }
+    #disposedFlag = false;
+    #disposed() {
+        return this.#disposedFlag;
+    }
+    dispose() {
+        this.#disposedFlag = true;
+        super.dispose();
+    }
+    #finalize(recorder) {
+        if (this.#recorder !== recorder)
+            return;
+        const reported = recorder.mimeType;
+        const type = reported === undefined || reported === ""
+            ? (this.getSnapshot().mimeType ?? "audio/webm")
+            : containerType(reported);
+        if (type === undefined) {
+            // Never relabel audio in a container the upload path cannot name.
+            this.#chunks = [];
+            this.#release();
+            this.#resolve(undefined);
+            if (!this.#disposed())
+                this.#fail("failed");
+            return;
+        }
+        const blob = new Blob(this.#chunks, { type });
+        this.#chunks = [];
+        this.#release();
+        const file = blob.size === 0
+            ? undefined
+            : new File([blob], voiceNoteName(type, this.#clock()), { type });
+        if (!this.#disposed())
+            this.transition({ status: "idle", elapsed: 0, level: 0 });
+        this.#resolve(file);
+    }
+    #resolve(file) {
+        const finish = this.#finish;
+        this.#finish = undefined;
+        finish?.(file);
+    }
+    #fail(error) {
+        this.transition({ status: "error", elapsed: 0, level: 0, error });
+    }
+    #startMeter(stream, Audio) {
+        let read;
+        if (Audio !== undefined) {
+            try {
+                const audio = new Audio();
+                const analyser = audio.createAnalyser();
+                analyser.fftSize = 512;
+                audio.createMediaStreamSource(stream).connect(analyser);
+                const samples = new Uint8Array(analyser.frequencyBinCount);
+                this.#audio = audio;
+                read = () => {
+                    analyser.getByteTimeDomainData(samples);
+                    let sum = 0;
+                    for (const sample of samples) {
+                        const centered = (sample - 128) / 128;
+                        sum += centered * centered;
+                    }
+                    return Math.min(1, Math.sqrt(sum / samples.length) * 3);
+                };
+            }
+            catch {
+                read = undefined;
+            }
+        }
+        const raf = this.#options.requestAnimationFrame ??
+            (typeof requestAnimationFrame === "function"
+                ? (callback) => requestAnimationFrame(callback)
+                : undefined);
+        const interval = this.#options.updateInterval ?? 50;
+        const tick = () => {
+            if (this.getSnapshot().status !== "recording")
+                return;
+            const now = this.#clock();
+            if (now - this.#lastPublish >= interval) {
+                this.#lastPublish = now;
+                const current = this.getSnapshot();
+                this.transition({
+                    status: "recording",
+                    elapsed: now - this.#startedAt,
+                    level: read === undefined ? 0 : read(),
+                    ...(current.mimeType === undefined
+                        ? {}
+                        : { mimeType: current.mimeType }),
+                });
+            }
+        };
+        if (raf !== undefined) {
+            const loop = () => {
+                tick();
+                if (this.#recorder !== undefined && !this.#disposed())
+                    this.#frame = raf(loop);
+            };
+            this.#frame = raf(loop);
+        }
+        else
+            this.#timer = setInterval(tick, Math.max(interval, 250));
+    }
+    #stopMeter() {
+        if (this.#frame !== undefined) {
+            const cancel = this.#options.cancelAnimationFrame ??
+                (typeof cancelAnimationFrame === "function"
+                    ? (handle) => cancelAnimationFrame(handle)
+                    : undefined);
+            cancel?.(this.#frame);
+            this.#frame = undefined;
+        }
+        if (this.#timer !== undefined) {
+            clearInterval(this.#timer);
+            this.#timer = undefined;
+        }
+        const audio = this.#audio;
+        this.#audio = undefined;
+        audio?.close().catch(() => undefined);
+    }
+    #release() {
+        this.#stopMeter();
+        if (this.#stream !== undefined)
+            stopTracks(this.#stream);
+        this.#stream = undefined;
+        this.#recorder = undefined;
+    }
+}
+function stopTracks(stream) {
+    for (const track of stream.getTracks())
+        track.stop();
+}
+/** Recording containers the SDK can upload, with their file extensions. */
+const CONTAINER_EXTENSIONS = new Map([
+    ["audio/webm", "webm"],
+    ["audio/ogg", "ogg"],
+    ["audio/mp4", "m4a"],
+]);
+/** The allowlisted container for a reported type, or `undefined`. */
+function containerType(type) {
+    if (type === undefined || type === "")
+        return undefined;
+    const base = type.split(";", 1)[0]?.trim().toLowerCase() ?? "";
+    return CONTAINER_EXTENSIONS.has(base) ? base : undefined;
+}
+/**
+ * `voice-note-<ISO time>.webm` (`.ogg` or `.m4a` for those containers), with
+ * `:` replaced for portability.
+ */
+export function voiceNoteName(type, time = Date.now()) {
+    const stamp = new Date(time).toISOString().replace(/[:.]/g, "-");
+    const container = containerType(type) ?? "audio/webm";
+    return `voice-note-${stamp}.${CONTAINER_EXTENSIONS.get(container) ?? "webm"}`;
+}
+//# sourceMappingURL=voice-recorder.js.map

package/dist/chat/voice-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-recorder.js","sourceRoot":"","sources":["../../src/chat/voice-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAErB,MAAM,kBAAkB,CAAC;AAwD1B,MAAM,eAAe,GAAG;IACtB,wBAAwB;IACxB,YAAY;IACZ,uBAAuB;IACvB,WAAW;IACX,WAAW;CACH,CAAC;AAEX,SAAS,WAAW,CAAC,OAAiC;IACpD,MAAM,KAAK,GAAG,UAKb,CAAC;IACF,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC,SAAS,EAAE,YAAY;QACnE,QAAQ,EAAE,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC,aAAa;QACtD,KAAK,EACH,OAAO,CAAC,YAAY,KAAK,IAAI;YAC3B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY;gBACrB,KAAK,CAAC,YAAY;gBAClB,KAAK,CAAC,kBAAkB,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,IAAI,GAAI,KAAmC,EAAE,IAAI,CAAC;IACxD,IAAI,IAAI,KAAK,iBAAiB,IAAI,IAAI,KAAK,eAAe;QACxD,OAAO,mBAAmB,CAAC;IAC7B,IAAI,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,sBAAsB;QAC7D,OAAO,aAAa,CAAC;IACvB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,oBAA+C;IAC3E,QAAQ,CAA2B;IACnC,MAAM,CAAe;IAC9B,OAAO,CAA0B;IACjC,SAAS,CAAgC;IACzC,MAAM,CAA+B;IACrC,MAAM,CAAqB;IAC3B,MAAM,CAA6C;IACnD,OAAO,GAAW,EAAE,CAAC;IACrB,UAAU,GAAG,CAAC,CAAC;IACf,YAAY,GAAG,CAAC,CAAC;IACjB,QAAQ,GAAG,CAAC,CAAC;IACb,OAAO,CAAiD;IAExD,YAAY,UAAoC,EAAE;QAChD,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACxC,CAAC;IAED,+EAA+E;IAC/E,MAAM,CAAC,WAAW,CAAC,UAAoC,EAAE;QACvD,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,CACL,OAAO,YAAY,EAAE,YAAY,KAAK,UAAU;YAChD,OAAO,QAAQ,KAAK,UAAU,CAC/B,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC;QACzC,IAAI,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,WAAW;YAAE,OAAO;QAC9D,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrE,IAAI,OAAO,YAAY,EAAE,YAAY,KAAK,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,MAAmB,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,KAAK,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;gBAChD,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAClD,UAAU,CAAC,MAAM,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CACnC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,CACpD,CAAC;QACF,IAAI,QAA2B,CAAC;QAChC,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,QAAQ,CACrB,MAAM,EACN,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAClD,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,CAAC,MAAM,CAAC,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,QAAQ,CAAC,eAAe,GAAG,CAAC,KAAK,EAAE,EAAE;YACnC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjD,QAAQ,CAAC,OAAO,GAAG,GAAG,EAAE;YACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;gBAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC;QACF,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC;YACd,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;YACR,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;SAC5D,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,WAAW;YACrE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,CAAC,UAAU,CAAC;YACd,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU;YACxC,KAAK,EAAE,CAAC;YACR,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;SAC1E,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU;oBAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;;oBACvD,QAAQ,CAAC,IAAI,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,MAAM;QACJ,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC;YAChC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;YACvB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU;oBAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,mBAAmB;YACrB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACnB,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IAEkB,SAAS;QAC1B,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;YACvB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC;YAChC,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU;oBAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,mBAAmB;YACrB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,aAAa,GAAG,KAAK,CAAC;IACtB,SAAS;QACP,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IACQ,OAAO;QACd,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAED,SAAS,CAAC,QAA2B;QACnC,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO;QACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACnC,MAAM,IAAI,GACR,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;YACvC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,IAAI,YAAY,CAAC;YAC/C,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,kEAAkE;YAClE,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;gBAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,KAAK,CAAC;YACb,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YACnB,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,QAAQ,CAAC,IAAsB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAqB;QACzB,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,WAAW,CACT,MAAmB,EACnB,KAA+C;QAE/C,IAAI,IAAgC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;gBACxC,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAC;gBACvB,KAAK,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACxD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;gBAC3D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;gBACpB,IAAI,GAAG,GAAG,EAAE;oBACV,QAAQ,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;oBACxC,IAAI,GAAG,GAAG,CAAC,CAAC;oBACZ,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;wBAC7B,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;wBACtC,GAAG,IAAI,QAAQ,GAAG,QAAQ,CAAC;oBAC7B,CAAC;oBACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1D,CAAC,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,GAAG,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GACP,IAAI,CAAC,QAAQ,CAAC,qBAAqB;YACnC,CAAC,OAAO,qBAAqB,KAAK,UAAU;gBAC1C,CAAC,CAAC,CAAC,QAAoB,EAAE,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC;gBAC3D,CAAC,CAAC,SAAS,CAAC,CAAC;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO;YACtD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1B,IAAI,GAAG,GAAG,IAAI,CAAC,YAAY,IAAI,QAAQ,EAAE,CAAC;gBACxC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;gBACxB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnC,IAAI,CAAC,UAAU,CAAC;oBACd,MAAM,EAAE,WAAW;oBACnB,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC,UAAU;oBAC9B,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;oBACtC,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;wBAChC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QACF,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,GAAG,EAAE;gBAChB,IAAI,EAAE,CAAC;gBACP,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;oBACnD,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;;YAAM,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,MAAM,GACV,IAAI,CAAC,QAAQ,CAAC,oBAAoB;gBAClC,CAAC,OAAO,oBAAoB,KAAK,UAAU;oBACzC,CAAC,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC;oBAClD,CAAC,CAAC,SAAS,CAAC,CAAC;YACjB,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAC1B,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,SAAS,UAAU,CAAC,MAAmB;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,SAAS,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,2EAA2E;AAC3E,MAAM,oBAAoB,GAAgC,IAAI,GAAG,CAAC;IAChE,CAAC,YAAY,EAAE,MAAM,CAAC;IACtB,CAAC,WAAW,EAAE,KAAK,CAAC;IACpB,CAAC,WAAW,EAAE,KAAK,CAAC;CACrB,CAAC,CAAC;AAEH,qEAAqE;AACrE,SAAS,aAAa,CAAC,IAAwB;IAC7C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/D,OAAO,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAe,IAAI,CAAC,GAAG,EAAE;IACnE,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;IACtD,OAAO,cAAc,KAAK,IAAI,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;AAChF,CAAC"}

package/dist/controller.d.ts

@@ -0,0 +1,16 @@
+export interface ControllerSnapshot {
+    readonly revision: number;
+    readonly updatedAt: number;
+}
+export type ControllerListener = () => void;
+export declare abstract class ObservableController<TSnapshot extends ControllerSnapshot> {
+    #private;
+    protected constructor(initial: Omit<TSnapshot, "revision" | "updatedAt">, now?: () => number);
+    getSnapshot: () => TSnapshot;
+    subscribe: (listener: ControllerListener) => (() => void);
+    protected transition(next: Omit<TSnapshot, "revision" | "updatedAt">): void;
+    protected assertActive(): void;
+    dispose(): void;
+    protected onDispose(): void;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAE5C,8BAAsB,oBAAoB,CACxC,SAAS,SAAS,kBAAkB;;IAOpC,SAAS,aACP,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,WAAW,CAAC,EAClD,GAAG,GAAE,MAAM,MAAiB;IAU9B,WAAW,QAAO,SAAS,CAAmB;IAE9C,SAAS,GAAI,UAAU,kBAAkB,KAAG,CAAC,MAAM,IAAI,CAAC,CAItD;IAEF,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,WAAW,CAAC,GAAG,IAAI;IAU3E,SAAS,CAAC,YAAY,IAAI,IAAI;IAK9B,OAAO,IAAI,IAAI;IAOf,SAAS,CAAC,SAAS,IAAI,IAAI;CAC5B"}

package/dist/controller.js

@@ -0,0 +1,50 @@
+export class ObservableController {
+    #listeners = new Set();
+    #now;
+    #snapshot;
+    #disposed = false;
+    constructor(initial, now = Date.now) {
+        this.#now = now;
+        this.#snapshot = deepFreeze({
+            ...initial,
+            revision: 0,
+            updatedAt: now(),
+        });
+    }
+    getSnapshot = () => this.#snapshot;
+    subscribe = (listener) => {
+        this.assertActive();
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    };
+    transition(next) {
+        this.assertActive();
+        this.#snapshot = deepFreeze({
+            ...next,
+            revision: this.#snapshot.revision + 1,
+            updatedAt: this.#now(),
+        });
+        for (const listener of [...this.#listeners])
+            listener();
+    }
+    assertActive() {
+        if (this.#disposed)
+            throw new Error(`${this.constructor.name} is disposed.`);
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#listeners.clear();
+        this.onDispose();
+    }
+    onDispose() { }
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAOA,MAAM,OAAgB,oBAAoB;IAG/B,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC3C,IAAI,CAAe;IAC5B,SAAS,CAAY;IACrB,SAAS,GAAG,KAAK,CAAC;IAElB,YACE,OAAkD,EAClD,MAAoB,IAAI,CAAC,GAAG;QAE5B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC;YAC1B,GAAG,OAAO;YACV,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,GAAG,EAAE;SACjB,CAAc,CAAC;IAClB,CAAC;IAED,WAAW,GAAG,GAAc,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;IAE9C,SAAS,GAAG,CAAC,QAA4B,EAAgB,EAAE;QACzD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC,CAAC;IAEQ,UAAU,CAAC,IAA+C;QAClE,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC;YAC1B,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC;YACrC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE;SACvB,CAAc,CAAC;QAChB,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;YAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAES,YAAY;QACpB,IAAI,IAAI,CAAC,SAAS;YAChB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,eAAe,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAES,SAAS,KAAU,CAAC;CAC/B;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,27 @@
+import type { BrowserErrorCategory } from "./errors.js";
+interface BrowserDiagnosticBase {
+    readonly timestamp: number;
+    readonly method: string;
+    readonly path: string;
+    readonly attempt: number;
+}
+export interface BrowserRequestStartedDiagnostic extends BrowserDiagnosticBase {
+    readonly type: "request.started";
+}
+export interface BrowserRequestCompletedDiagnostic extends BrowserDiagnosticBase {
+    readonly type: "request.completed";
+    readonly status: number;
+    readonly durationMs: number;
+    readonly requestId?: string;
+}
+export interface BrowserRequestFailedDiagnostic extends BrowserDiagnosticBase {
+    readonly type: "request.failed";
+    readonly durationMs: number;
+    readonly category: BrowserErrorCategory;
+    readonly status?: number;
+    readonly requestId?: string;
+}
+export type BrowserDiagnosticEvent = BrowserRequestStartedDiagnostic | BrowserRequestCompletedDiagnostic | BrowserRequestFailedDiagnostic;
+export type BrowserDiagnosticSink = (event: BrowserDiagnosticEvent) => void;
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,+BAAgC,SAAQ,qBAAqB;IAC5E,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAClC;AAED,MAAM,WAAW,iCAAkC,SAAQ,qBAAqB;IAC9E,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA+B,SAAQ,qBAAqB;IAC3E,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,sBAAsB,GAC9B,+BAA+B,GAC/B,iCAAiC,GACjC,8BAA8B,CAAC;AAEnC,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC"}

package/dist/diagnostics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":""}

package/dist/dropin/client.d.ts

@@ -0,0 +1,82 @@
+import { ObservableController, type ControllerSnapshot } from "../controller.js";
+import { BrowserMessagingClient } from "../messaging/client.js";
+import type { ClientToken } from "../token.js";
+import { type PolymorfaGrant, type PolymorfaPermission } from "./permissions.js";
+export type PolymorfaClientStatus = "idle" | "loading" | "ready" | "refreshing" | "retrying" | "unauthenticated" | "error";
+export interface PolymorfaClientSnapshot extends ControllerSnapshot {
+    readonly status: PolymorfaClientStatus;
+    /** Present once a token has been minted. */
+    readonly grant?: PolymorfaGrant;
+    /** Epoch milliseconds when the current token expires. */
+    readonly expiresAt?: number;
+    /** Epoch milliseconds of the next scheduled fetch. */
+    readonly nextFetchAt?: number;
+    /** Failed attempts since the last success. */
+    readonly failures: number;
+    readonly error?: string;
+}
+export interface PolymorfaClientOptions {
+    /**
+     * Same-origin path of your handler's token route. Default
+     * `/api/polymorfa/token`. The other drop-in routes live next to it.
+     */
+    readonly tokenEndpoint?: string;
+    /** Polymorfa API origin for direct client-token calls. */
+    readonly baseUrl?: string;
+    /** Refresh this long before expiry. Default 60 s. */
+    readonly refreshBeforeMs?: number;
+    /** Longest wait between failed attempts. Default 30 s. */
+    readonly maxBackoffMs?: number;
+    readonly fetch?: typeof globalThis.fetch;
+    readonly now?: () => number;
+    readonly random?: () => number;
+    readonly setTimeout?: (callback: () => void, ms: number) => unknown;
+    readonly clearTimeout?: (handle: unknown) => void;
+}
+/**
+ * Fetches client tokens from your server, refreshes them before they expire,
+ * and backs off after failures. It never chooses permissions: the token
+ * route decides, and `can()` only reports what the route granted.
+ */
+export declare class PolymorfaClient extends ObservableController<PolymorfaClientSnapshot> {
+    #private;
+    readonly tokenEndpoint: string;
+    /** The handler path the other routes share, for example `/api/polymorfa`. */
+    readonly handlerPath: string;
+    readonly baseUrl: string | undefined;
+    constructor(options?: PolymorfaClientOptions);
+    /** Fetch the first token. Safe to call more than once. */
+    start(): void;
+    /** Whether the current grant allows `permission`. False until minted. */
+    can(permission: PolymorfaPermission): boolean;
+    /** Whether the grant covers a conversation. */
+    canRead(conversationId: string): boolean;
+    /**
+     * Token provider for `BrowserTransport` and the Calls client. Returns the
+     * cached token while it is valid and waits for a fetch otherwise.
+     */
+    getClientToken: () => Promise<ClientToken>;
+    /** Fetch a new token now, for example after the API answered `403`. */
+    refresh(): Promise<void>;
+    /** Absolute URL path for a handler route, for example `url("events")`. */
+    url(route: string): string;
+    /**
+     * GET or POST a JSON handler route. Checks the status and content type,
+     * so an HTML proxy error becomes a clear error instead of a parse failure.
+     */
+    request<T>(route: string, init?: {
+        readonly method?: "GET" | "POST";
+        readonly body?: unknown;
+        readonly signal?: AbortSignal;
+    }): Promise<T>;
+    /** The fetch implementation this client uses, for same-origin helpers. */
+    get fetch(): typeof globalThis.fetch;
+    /** A browser Messaging client for `session`, sharing this client's tokens. */
+    messaging(session?: string): BrowserMessagingClient;
+    protected onDispose(): void;
+}
+/** Reads a JSON handler response, rejecting HTML and non-2xx answers. */
+export declare function readJson<T>(response: Response, route: string): Promise<T>;
+/** Creates a client and starts fetching its first token. */
+export declare function createPolymorfaClient(options?: PolymorfaClientOptions): PolymorfaClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/dropin/client.d.ts.map

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