@polymorfa/browser 0.1.0-dev.20260922094209

package/dist/dropin/client.js

@@ -0,0 +1,314 @@
+import { ObservableController, } from "../controller.js";
+import { BrowserConfigurationError, BrowserHttpError } from "../errors.js";
+import { BrowserMessagingClient } from "../messaging/client.js";
+import { isPolymorfaGrant, } from "./permissions.js";
+/**
+ * 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 class PolymorfaClient extends ObservableController {
+    tokenEndpoint;
+    /** The handler path the other routes share, for example `/api/polymorfa`. */
+    handlerPath;
+    baseUrl;
+    #fetch;
+    #now;
+    #random;
+    #refreshBeforeMs;
+    #maxBackoffMs;
+    #setTimeout;
+    #clearTimeout;
+    #token;
+    #pending;
+    #timer;
+    #started = false;
+    #messaging = new Map();
+    constructor(options = {}) {
+        const now = options.now ?? Date.now;
+        super({ status: "idle", failures: 0 }, now);
+        const endpoint = options.tokenEndpoint ?? "/api/polymorfa/token";
+        assertSameOriginPath(endpoint);
+        this.tokenEndpoint = endpoint;
+        this.handlerPath = endpoint.replace(/\/token\/?$/, "");
+        this.baseUrl = options.baseUrl;
+        const fetch = options.fetch ?? globalThis.fetch?.bind(globalThis);
+        if (typeof fetch !== "function")
+            throw new BrowserConfigurationError("A fetch implementation is required.", "missing_fetch");
+        this.#fetch = fetch;
+        this.#now = now;
+        this.#random = options.random ?? Math.random;
+        this.#refreshBeforeMs = options.refreshBeforeMs ?? 60_000;
+        this.#maxBackoffMs = options.maxBackoffMs ?? 30_000;
+        this.#setTimeout =
+            options.setTimeout ??
+                ((callback, ms) => globalThis.setTimeout(callback, ms));
+        this.#clearTimeout =
+            options.clearTimeout ??
+                ((handle) => globalThis.clearTimeout(handle));
+    }
+    /** Fetch the first token. Safe to call more than once. */
+    start() {
+        if (this.#started)
+            return;
+        this.#started = true;
+        void this.#fetchToken().catch(() => undefined);
+    }
+    /** Whether the current grant allows `permission`. False until minted. */
+    can(permission) {
+        return this.getSnapshot().grant?.allow.includes(permission) === true;
+    }
+    /** Whether the grant covers a conversation. */
+    canRead(conversationId) {
+        const grant = this.getSnapshot().grant;
+        if (grant === undefined || !grant.allow.includes("read_messages"))
+            return false;
+        return (grant.conversations === "all" ||
+            grant.conversations.includes(conversationId));
+    }
+    /**
+     * Token provider for `BrowserTransport` and the Calls client. Returns the
+     * cached token while it is valid and waits for a fetch otherwise.
+     */
+    getClientToken = async () => {
+        const current = this.#token;
+        if (current !== undefined && current.expiresAt - 5_000 > this.#now())
+            return current;
+        return this.#fetchToken();
+    };
+    /** Fetch a new token now, for example after the API answered `403`. */
+    async refresh() {
+        await this.#fetchToken(true);
+    }
+    /** Absolute URL path for a handler route, for example `url("events")`. */
+    url(route) {
+        return `${this.handlerPath}/${route.replace(/^\/+/, "")}`;
+    }
+    /**
+     * 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.
+     */
+    async request(route, init = {}) {
+        const response = await this.#fetch(this.url(route), {
+            method: init.method ?? "GET",
+            credentials: "same-origin",
+            headers: {
+                accept: "application/json",
+                ...(init.body === undefined
+                    ? {}
+                    : { "content-type": "application/json" }),
+            },
+            ...(init.body === undefined ? {} : { body: JSON.stringify(init.body) }),
+            ...(init.signal === undefined ? {} : { signal: init.signal }),
+        });
+        return readJson(response, route);
+    }
+    /** The fetch implementation this client uses, for same-origin helpers. */
+    get fetch() {
+        return this.#fetch;
+    }
+    /** A browser Messaging client for `session`, sharing this client's tokens. */
+    messaging(session) {
+        const resolved = session ?? this.getSnapshot().grant?.session;
+        if (resolved === undefined)
+            throw new BrowserConfigurationError("The grant names no session. Pass the conversation's session.", "missing_session");
+        let client = this.#messaging.get(resolved);
+        if (client === undefined) {
+            client = new BrowserMessagingClient({
+                session: resolved,
+                getClientToken: this.getClientToken,
+                fetch: this.#fetch,
+                ...(this.baseUrl === undefined ? {} : { baseUrl: this.baseUrl }),
+            });
+            this.#messaging.set(resolved, client);
+        }
+        return client;
+    }
+    onDispose() {
+        if (this.#timer !== undefined)
+            this.#clearTimeout(this.#timer);
+        this.#timer = undefined;
+        this.#messaging.clear();
+    }
+    #fetchToken(force = false) {
+        if (this.#pending !== undefined && !force)
+            return this.#pending;
+        const promise = this.#load().finally(() => {
+            if (this.#pending === promise)
+                this.#pending = undefined;
+        });
+        this.#pending = promise;
+        return promise;
+    }
+    async #load() {
+        this.#started = true;
+        if (this.#timer !== undefined)
+            this.#clearTimeout(this.#timer);
+        this.#timer = undefined;
+        const previous = this.getSnapshot();
+        this.#safeTransition({
+            ...fields(previous),
+            status: this.#token === undefined ? "loading" : "refreshing",
+        });
+        try {
+            const response = await this.#fetch(this.tokenEndpoint, {
+                method: "POST",
+                credentials: "same-origin",
+                headers: { accept: "application/json" },
+            });
+            const body = await readJson(response, "token");
+            const token = readToken(body, this.#now());
+            this.#token = token;
+            const refreshAt = this.#refreshAt(token.expiresAt);
+            this.#safeTransition({
+                status: "ready",
+                grant: token.grant,
+                expiresAt: token.expiresAt,
+                nextFetchAt: refreshAt,
+                failures: 0,
+            });
+            this.#schedule(refreshAt - this.#now());
+            return token;
+        }
+        catch (cause) {
+            const status = cause.status;
+            const failures = this.getSnapshot().failures + 1;
+            const message = cause instanceof Error ? cause.message : String(cause);
+            const current = fields(this.getSnapshot());
+            if (status === 401 || status === 403) {
+                // Signed out or refused: retrying would not change the answer.
+                this.#token = undefined;
+                this.#safeTransition({
+                    status: "unauthenticated",
+                    failures,
+                    error: message,
+                });
+            }
+            else {
+                const delay = this.#backoff(failures);
+                this.#safeTransition({
+                    ...current,
+                    status: "retrying",
+                    failures,
+                    nextFetchAt: this.#now() + delay,
+                    error: message,
+                });
+                this.#schedule(delay);
+            }
+            throw cause;
+        }
+    }
+    #refreshAt(expiresAt) {
+        const now = this.#now();
+        const lifetime = expiresAt - now;
+        // Short-lived tokens refresh at 80 % of their lifetime.
+        const lead = Math.min(this.#refreshBeforeMs, lifetime * 0.2);
+        return Math.max(now + 1_000, expiresAt - lead);
+    }
+    /** Exponential backoff with equal jitter: 1 s, 2 s, 4 s … capped. */
+    #backoff(failures) {
+        const ceiling = Math.min(this.#maxBackoffMs, 1_000 * 2 ** Math.min(failures - 1, 16));
+        return Math.round(ceiling / 2 + (this.#random() * ceiling) / 2);
+    }
+    #schedule(delay) {
+        if (this.#timer !== undefined)
+            this.#clearTimeout(this.#timer);
+        this.#timer = this.#setTimeout(() => {
+            this.#timer = undefined;
+            void this.#fetchToken(true).catch(() => undefined);
+        }, Math.max(0, delay));
+    }
+    #safeTransition(next) {
+        try {
+            this.transition(next);
+        }
+        catch {
+            // Disposed while a fetch was in flight.
+        }
+    }
+}
+function fields(snapshot) {
+    const { revision: _revision, updatedAt: _updatedAt, ...rest } = snapshot;
+    void _revision;
+    void _updatedAt;
+    return rest;
+}
+function readToken(value, now) {
+    const token = value;
+    if (token === null ||
+        typeof token !== "object" ||
+        typeof token.value !== "string" ||
+        !token.value.startsWith("pmfa_ct_") ||
+        token.value.length <= "pmfa_ct_".length ||
+        token.audience !== "browser" ||
+        typeof token.expiresAt !== "number" ||
+        !Number.isFinite(token.expiresAt))
+        throw new BrowserConfigurationError("The token route returned an invalid client token.", "invalid_token_response");
+    if (token.expiresAt <= now)
+        throw new BrowserConfigurationError("The token route returned an expired client token.", "expired_client_token");
+    if (!isPolymorfaGrant(token.grant))
+        throw new BrowserConfigurationError("The token route returned no grant. Serve it with createPolymorfaHandler.", "invalid_token_response");
+    return Object.freeze({
+        value: token.value,
+        audience: "browser",
+        expiresAt: token.expiresAt,
+        scopes: Object.freeze([...token.grant.allow]),
+        grant: Object.freeze({
+            ...token.grant,
+            allow: Object.freeze([...token.grant.allow]),
+            conversations: token.grant.conversations === "all"
+                ? "all"
+                : Object.freeze([...token.grant.conversations]),
+        }),
+    });
+}
+/** Reads a JSON handler response, rejecting HTML and non-2xx answers. */
+export async function readJson(response, route) {
+    const type = response.headers.get("content-type") ?? "";
+    const isJson = /^application\/([a-z0-9.+-]*\+)?json\b/i.test(type);
+    let body;
+    if (isJson) {
+        try {
+            body = await response.json();
+        }
+        catch {
+            body = undefined;
+        }
+    }
+    if (!response.ok) {
+        const error = body
+            ?.error;
+        throw new BrowserHttpError(typeof error?.message === "string"
+            ? error.message
+            : `The ${route} route answered ${response.status}.`, {
+            category: response.status === 401
+                ? "authentication"
+                : response.status === 403
+                    ? "authorization"
+                    : response.status === 404
+                        ? "not_found"
+                        : response.status >= 500
+                            ? "server"
+                            : "http",
+            status: response.status,
+            code: typeof error?.code === "string" ? error.code : "route_failed",
+        });
+    }
+    if (!isJson)
+        throw new BrowserConfigurationError(`The ${route} route returned ${type || "no content type"} instead of JSON. Check that the handler is mounted at this path.`, "invalid_route_response");
+    return body;
+}
+function assertSameOriginPath(path) {
+    if (!path.startsWith("/") ||
+        path.startsWith("//") ||
+        path.includes("\\") ||
+        URL.canParse(path))
+        throw new BrowserConfigurationError("tokenEndpoint must be a same-origin path such as /api/polymorfa/token.", "invalid_token_route");
+}
+/** Creates a client and starts fetching its first token. */
+export function createPolymorfaClient(options = {}) {
+    const client = new PolymorfaClient(options);
+    client.start();
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/dropin/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/dropin/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAErB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EACL,gBAAgB,GAGjB,MAAM,kBAAkB,CAAC;AA+C1B;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,oBAA6C;IACvE,aAAa,CAAS;IAC/B,6EAA6E;IACpE,WAAW,CAAS;IACpB,OAAO,CAAqB;IAC5B,MAAM,CAA0B;IAChC,IAAI,CAAe;IACnB,OAAO,CAAe;IACtB,gBAAgB,CAAS;IACzB,aAAa,CAAS;IACtB,WAAW,CAAgD;IAC3D,aAAa,CAA4B;IAClD,MAAM,CAAyB;IAC/B,QAAQ,CAAkC;IAC1C,MAAM,CAAU;IAChB,QAAQ,GAAG,KAAK,CAAC;IACjB,UAAU,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEvD,YAAY,UAAkC,EAAE;QAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACpC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;QACjE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,KAAK,UAAU;YAC7B,MAAM,IAAI,yBAAyB,CACjC,qCAAqC,EACrC,eAAe,CAChB,CAAC;QACJ,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QAC7C,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe,IAAI,MAAM,CAAC;QAC1D,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC;QACpD,IAAI,CAAC,WAAW;YACd,OAAO,CAAC,UAAU;gBAClB,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,aAAa;YAChB,OAAO,CAAC,YAAY;gBACpB,CAAC,CAAC,MAAM,EAAE,EAAE,CACV,UAAU,CAAC,YAAY,CAAC,MAAuC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,0DAA0D;IAC1D,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,yEAAyE;IACzE,GAAG,CAAC,UAA+B;QACjC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACvE,CAAC;IAED,+CAA+C;IAC/C,OAAO,CAAC,cAAsB;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,OAAO,CACL,KAAK,CAAC,aAAa,KAAK,KAAK;YAC7B,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,cAAc,CAAC,CAC7C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,cAAc,GAAG,KAAK,IAA0B,EAAE;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE;YAClE,OAAO,OAAO,CAAC;QACjB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC,CAAC;IAEF,uEAAuE;IACvE,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,0EAA0E;IAC1E,GAAG,CAAC,KAAa;QACf,OAAO,GAAG,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CACX,KAAa,EACb,OAII,EAAE;QAEN,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YAClD,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,WAAW,EAAE,aAAa;YAC1B,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS;oBACzB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;aAC5C;YACD,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,QAAQ,CAAI,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,0EAA0E;IAC1E,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,8EAA8E;IAC9E,SAAS,CAAC,OAAgB;QACxB,MAAM,QAAQ,GAAG,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;QAC9D,IAAI,QAAQ,KAAK,SAAS;YACxB,MAAM,IAAI,yBAAyB,CACjC,8DAA8D,EAC9D,iBAAiB,CAClB,CAAC;QACJ,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,IAAI,sBAAsB,CAAC;gBAClC,OAAO,EAAE,QAAQ;gBACjB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,KAAK,EAAE,IAAI,CAAC,MAAM;gBAClB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;aACjE,CAAC,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEkB,SAAS;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,WAAW,CAAC,KAAK,GAAG,KAAK;QACvB,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACxC,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO;gBAAE,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC3D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,CAAC,eAAe,CAAC;YACnB,GAAG,MAAM,CAAC,QAAQ,CAAC;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;SAC7D,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE;gBACrD,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,aAAa;gBAC1B,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;aACxC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAU,QAAQ,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,CAAC,eAAe,CAAC;gBACnB,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,WAAW,EAAE,SAAS;gBACtB,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;YACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3C,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACrC,+DAA+D;gBAC/D,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;gBACxB,IAAI,CAAC,eAAe,CAAC;oBACnB,MAAM,EAAE,iBAAiB;oBACzB,QAAQ;oBACR,KAAK,EAAE,OAAO;iBACf,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACtC,IAAI,CAAC,eAAe,CAAC;oBACnB,GAAG,OAAO;oBACV,MAAM,EAAE,UAAU;oBAClB,QAAQ;oBACR,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK;oBAChC,KAAK,EAAE,OAAO;iBACf,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,SAAS,GAAG,GAAG,CAAC;QACjC,wDAAwD;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,GAAG,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,qEAAqE;IACrE,QAAQ,CAAC,QAAgB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,IAAI,CAAC,aAAa,EAClB,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,EAAE,CAAC,CACxC,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAC5B,GAAG,EAAE;YACH,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,KAAK,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CACnB,CAAC;IACJ,CAAC;IAED,eAAe,CACb,IAA6D;QAE7D,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;CACF;AAED,SAAS,MAAM,CACb,QAAiC;IAEjC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;IACzE,KAAK,SAAS,CAAC;IACf,KAAK,UAAU,CAAC;IAChB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,GAAW;IAC5C,MAAM,KAAK,GAAG,KAAyD,CAAC;IACxE,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;QACnC,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM;QACvC,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;QAEjC,MAAM,IAAI,yBAAyB,CACjC,mDAAmD,EACnD,wBAAwB,CACzB,CAAC;IACJ,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG;QACxB,MAAM,IAAI,yBAAyB,CACjC,mDAAmD,EACnD,sBAAsB,CACvB,CAAC;IACJ,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC;QAChC,MAAM,IAAI,yBAAyB,CACjC,0EAA0E,EAC1E,wBAAwB,CACzB,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,KAAK,CAAC,KAAK;YACd,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5C,aAAa,EACX,KAAK,CAAC,KAAK,CAAC,aAAa,KAAK,KAAK;gBACjC,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;SACpD,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAkB,EAClB,KAAa;IAEb,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,IAAa,CAAC;IAClB,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,KAAK,GAAI,IAA0D;YACvE,EAAE,KAAK,CAAC;QACV,MAAM,IAAI,gBAAgB,CACxB,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ;YAChC,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,OAAO,KAAK,mBAAmB,QAAQ,CAAC,MAAM,GAAG,EACrD;YACE,QAAQ,EACN,QAAQ,CAAC,MAAM,KAAK,GAAG;gBACrB,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG;oBACvB,CAAC,CAAC,eAAe;oBACjB,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG;wBACvB,CAAC,CAAC,WAAW;wBACb,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG;4BACtB,CAAC,CAAC,QAAQ;4BACV,CAAC,CAAC,MAAM;YAClB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc;SACpE,CACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM;QACT,MAAM,IAAI,yBAAyB,CACjC,OAAO,KAAK,mBAAmB,IAAI,IAAI,iBAAiB,mEAAmE,EAC3H,wBAAwB,CACzB,CAAC;IACJ,OAAO,IAAS,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,IACE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAElB,MAAM,IAAI,yBAAyB,CACjC,wEAAwE,EACxE,qBAAqB,CACtB,CAAC;AACN,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,qBAAqB,CACnC,UAAkC,EAAE;IAEpC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/dropin/connect.d.ts

@@ -0,0 +1,23 @@
+import type { PolymorfaClient } from "./client.js";
+export interface ConnectWhatsAppResult {
+    /** Hosted QuickLink URL. Polymorfa hosts the pairing UI. */
+    readonly url: string;
+    readonly id: string;
+    readonly expiresAt: string | null;
+}
+export interface ConnectWhatsAppOptions {
+    /**
+     * `redirect` (default) navigates this tab, `popup` opens a new tab. Open
+     * the popup in the click handler so browsers do not block it.
+     */
+    readonly target?: "redirect" | "popup";
+    readonly signal?: AbortSignal;
+    /** Replaces navigation, for tests and custom flows. */
+    readonly open?: (url: string) => void;
+}
+/**
+ * Asks your handler to create a QuickLink on the server, then opens the
+ * hosted URL. The pairing UI is never embedded in your page.
+ */
+export declare function connectWhatsApp(client: PolymorfaClient, options?: ConnectWhatsAppOptions): Promise<ConnectWhatsAppResult>;
+//# sourceMappingURL=connect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/dropin/connect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAuChC"}

package/dist/dropin/connect.js

@@ -0,0 +1,54 @@
+import { BrowserConfigurationError } from "../errors.js";
+/**
+ * Asks your handler to create a QuickLink on the server, then opens the
+ * hosted URL. The pairing UI is never embedded in your page.
+ */
+export async function connectWhatsApp(client, options = {}) {
+    // Open the popup synchronously so it counts as user-initiated.
+    const popup = options.target === "popup" && options.open === undefined
+        ? globalThis.open?.("about:blank", "_blank")
+        : undefined;
+    try {
+        const result = await client.request("connect", {
+            method: "POST",
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        });
+        const link = result.data;
+        if (link === undefined ||
+            typeof link.url !== "string" ||
+            !isHttpsUrl(link.url) ||
+            typeof link.id !== "string")
+            throw new BrowserConfigurationError("The connect route returned an invalid QuickLink.", "invalid_connect_response");
+        const value = {
+            url: link.url,
+            id: link.id,
+            expiresAt: typeof link.expiresAt === "string" ? link.expiresAt : null,
+        };
+        if (options.open !== undefined)
+            options.open(value.url);
+        else if (popup) {
+            popup.opener = null;
+            popup.location.href = value.url;
+        }
+        else
+            globalThis.location?.assign(value.url);
+        return value;
+    }
+    catch (cause) {
+        popup?.close();
+        throw cause;
+    }
+}
+function isHttpsUrl(value) {
+    try {
+        const url = new URL(value);
+        return (url.protocol === "https:" ||
+            // Local development against a sandbox API.
+            (url.protocol === "http:" &&
+                (url.hostname === "localhost" || url.hostname === "127.0.0.1")));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=connect.js.map

package/dist/dropin/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/dropin/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAqBzD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAuB,EACvB,UAAkC,EAAE;IAEpC,+DAA+D;IAC/D,MAAM,KAAK,GACT,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QACtD,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAEhC,SAAS,EAAE;YACZ,MAAM,EAAE,MAAM;YACd,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SACpE,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IACE,IAAI,KAAK,SAAS;YAClB,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;YAC5B,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;YACrB,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;YAE3B,MAAM,IAAI,yBAAyB,CACjC,kDAAkD,EAClD,0BAA0B,CAC3B,CAAC;QACJ,MAAM,KAAK,GAA0B;YACnC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,SAAS,EAAE,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;SACtE,CAAC;QACF,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;aACnD,IAAI,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;YACpB,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC;QAClC,CAAC;;YAAM,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,EAAE,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,CACL,GAAG,CAAC,QAAQ,KAAK,QAAQ;YACzB,2CAA2C;YAC3C,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO;gBACvB,CAAC,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,CAClE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/dropin/inbox.d.ts

@@ -0,0 +1,131 @@
+import type { ConversationDataSource } from "../chat/conversation.js";
+import { ConversationController } from "../chat/conversation.js";
+import { ObservableController, type ControllerSnapshot } from "../controller.js";
+import type { PolymorfaClient } from "./client.js";
+/** One row of the conversation list. */
+export interface InboxConversation {
+    readonly id: string;
+    /** Session that owns the conversation; defaults to the grant's session. */
+    readonly session?: string;
+    readonly name?: string;
+    readonly phoneNumber?: string;
+    readonly avatarUrl?: string;
+    readonly lastMessage?: {
+        readonly text: string;
+        readonly createdAt: number;
+        readonly direction: "inbound" | "outbound";
+    };
+    /** Epoch milliseconds of the newest activity. */
+    readonly lastActivity: number;
+    readonly unreadCount: number;
+}
+/** What the contact panel shows. */
+export interface InboxContact {
+    readonly id: string;
+    readonly name?: string;
+    readonly phoneNumber?: string;
+    readonly avatarUrl?: string;
+    readonly about?: string;
+    readonly email?: string;
+    /** Your own fields, shown as label and value rows. */
+    readonly fields?: readonly {
+        readonly label: string;
+        readonly value: string;
+    }[];
+}
+export interface InboxConversationPage {
+    readonly conversations: readonly InboxConversation[];
+    readonly nextCursor?: string;
+}
+export type InboxChange = 
+/** Replace or add a whole row. */
+{
+    readonly type: "conversation";
+    readonly conversation: InboxConversation;
+}
+/** A new message: moves the row to the top and bumps its unread count. */
+ | {
+    readonly type: "activity";
+    readonly conversationId: string;
+    readonly session?: string;
+    readonly name?: string;
+    readonly phoneNumber?: string;
+    readonly lastMessage: NonNullable<InboxConversation["lastMessage"]>;
+} | {
+    readonly type: "remove";
+    readonly conversationId: string;
+};
+/**
+ * Where `<Inbox/>` reads from. `createHandlerInboxSource` reads your
+ * handler's history and events routes; `@polymorfa/store` offers a local
+ * cache on top of it. Implement it yourself for any other backend.
+ */
+export interface InboxDataSource {
+    listConversations(cursor?: string, signal?: AbortSignal): Promise<InboxConversationPage>;
+    /** The message source for one conversation. Called once per open. */
+    conversation(conversation: InboxConversation): ConversationDataSource;
+    contact?(conversation: InboxConversation, signal?: AbortSignal): Promise<InboxContact | undefined>;
+    subscribe?(listener: (change: InboxChange) => void): () => void;
+    /** Release shared connections. */
+    close?(): void;
+}
+export interface InboxSnapshot extends ControllerSnapshot {
+    readonly status: "idle" | "loading" | "ready" | "loading_more" | "error";
+    readonly conversations: readonly InboxConversation[];
+    readonly selectedId?: string;
+    readonly hasMore: boolean;
+    readonly cursor?: string;
+    readonly error?: string;
+}
+/**
+ * Framework-neutral state for an inbox: the conversation list, the selected
+ * conversation and one `ConversationController` per opened conversation.
+ */
+export declare class InboxController extends ObservableController<InboxSnapshot> {
+    #private;
+    readonly source: InboxDataSource;
+    constructor(source: InboxDataSource, options?: {
+        now?: () => number;
+    });
+    load(): Promise<void>;
+    loadMore(): Promise<void>;
+    /** Select a conversation, or pass `undefined` to go back to the list. */
+    select(conversationId: string | undefined): void;
+    get selected(): InboxConversation | undefined;
+    /** The shared controller for a conversation, created and loaded on first use. */
+    conversation(conversation: InboxConversation): ConversationController;
+    protected onDispose(): void;
+}
+/** A webhook event envelope as the handler's events route relays it. */
+export interface RelayedEvent {
+    readonly id: string;
+    readonly session: string;
+    readonly event: string;
+    readonly timestamp: string;
+    readonly payload: unknown;
+}
+export interface HandlerInboxSourceOptions {
+    /** Read live updates from the handler's `events` route. Default true. */
+    readonly live?: boolean;
+    /** `EventSource` constructor, for tests and non-browser runtimes. */
+    readonly EventSource?: new (url: string, init?: {
+        withCredentials?: boolean;
+    }) => EventSourceLike;
+}
+export interface EventSourceLike {
+    addEventListener(type: string, listener: (event: {
+        data: string;
+        lastEventId?: string;
+    }) => void): void;
+    close(): void;
+    onerror?: ((event: unknown) => void) | null;
+}
+/**
+ * The default `<Inbox/>` source: history from your handler's `history`
+ * routes, live changes from its `events` route, and sends straight to the
+ * Polymorfa API with the client token (the API enforces `send_message`).
+ */
+export declare function createHandlerInboxSource(client: PolymorfaClient, options?: HandlerInboxSourceOptions): InboxDataSource;
+/** The conversation an event belongs to, as the store reducers read it. */
+export declare function relayedConversationId(event: RelayedEvent): string | undefined;
+//# sourceMappingURL=inbox.d.ts.map

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

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