@hainiva/agent-sdk 0.0.0-stage → 0.3.0

package/dist/esm/rest.js

@@ -0,0 +1,281 @@
+import { HainivaAgentError } from "./errors.js";
+import { safeLogger } from "./log.js";
+import { Redactor } from "./redact.js";
+import { assertSafeUrl } from "./url.js";
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const TENANT = /^[A-Za-z0-9_-]{1,64}$/;
+/** A random UUID v4: crypto.randomUUID where it exists (browsers, Node), else getRandomValues, else Math.random (Idempotency-Key only, not a secret). */
+export function newIdempotencyKey() {
+    const c = globalThis.crypto;
+    if (c?.randomUUID)
+        return c.randomUUID();
+    const b = new Uint8Array(16);
+    if (c?.getRandomValues)
+        c.getRandomValues(b);
+    else
+        for (let i = 0; i < 16; i++)
+            b[i] = Math.floor(Math.random() * 256);
+    b[6] = (b[6] & 0x0f) | 0x40;
+    b[8] = (b[8] & 0x3f) | 0x80;
+    const h = [...b].map((x) => x.toString(16).padStart(2, "0")).join("");
+    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
+}
+/** An id that goes into a path: a UUID, or the request is refused before it leaves (no path tricks). */
+function id(v, what) {
+    if (typeof v !== "string" || !UUID.test(v))
+        throw new HainivaAgentError(0, "invalid_id", { field: what });
+    return v.toLowerCase();
+}
+function isObject(v) {
+    return !!v && typeof v === "object" && !Array.isArray(v);
+}
+/** Pure: the error a non-2xx answer becomes. Exported for tests. */
+export function errorFromResponse(status, data, redactor, retryAfter) {
+    const e = isObject(data) ? data["error"] : undefined;
+    let code = status === 401 ? "unauthorized" : status === 403 ? "forbidden" : status === 404 ? "not_found" : status === 409 ? "conflict" : status === 429 ? "rate_limited" : status >= 500 ? "server_error" : "invalid_request";
+    let message;
+    if (isObject(e)) {
+        if (typeof e["code"] === "string" && e["code"])
+            code = e["code"].slice(0, 80);
+        if (typeof e["message"] === "string")
+            message = e["message"].slice(0, 500);
+    }
+    else if (typeof e === "string") {
+        message = e.slice(0, 500);
+    }
+    const body = {};
+    if (message)
+        body["message"] = message;
+    if (retryAfter && /^\d{1,6}$/.test(retryAfter))
+        body["retryAfterSec"] = Number(retryAfter);
+    return new HainivaAgentError(status, code, body, redactor);
+}
+/**
+ * The Agent API over fetch. `tokens` is normally the SessionManager; the
+ * client's own `sessions` transport is what that SessionManager signs in with.
+ */
+export class AgentRestClient {
+    constructor(o, tokens) {
+        this.o = o;
+        // ── Sessions (the SessionManager's transport) ───────────────────────────────
+        this.sessions = {
+            exchange: (assertion) => this.raw("POST", "/agent/v1/sessions", {
+                body: { tenantId: this.o.tenantId, assertion, ...(this.o.device ? { device: this.o.device } : {}) },
+            }, null).then((s) => s),
+            refresh: (refreshToken) => this.raw("POST", "/agent/v1/sessions/refresh", {
+                body: { tenantId: this.o.tenantId, refreshToken },
+            }, null).then((s) => s),
+            revoke: async (session) => {
+                await this.raw("DELETE", "/agent/v1/sessions/current", {}, session.accessToken);
+            },
+        };
+        const u = assertSafeUrl(o.baseUrl, { kind: "http", ...(o.allowInsecureLocalhost ? { allowInsecureLocalhost: true } : {}) });
+        if (u.search || u.hash)
+            throw new HainivaAgentError(0, "invalid_url", { hint: "baseUrl takes no query or fragment" });
+        if (typeof o.tenantId !== "string" || !TENANT.test(o.tenantId))
+            throw new HainivaAgentError(0, "invalid_tenant_id");
+        this.baseUrl = u.origin + u.pathname.replace(/\/+$/, "");
+        const f = o.fetch ?? globalThis.fetch;
+        if (!f)
+            throw new HainivaAgentError(0, "no_fetch", { hint: "pass options.fetch" });
+        this.fetchFn = f.bind(globalThis);
+        this.timeoutMs = o.timeoutMs ?? 15000;
+        this.redactor = o.redactor ?? new Redactor();
+        this.log = safeLogger(o.log, this.redactor);
+        this.tokens = tokens ?? null;
+    }
+    /** Attach the token source after construction (the SessionManager needs `sessions` first). */
+    useTokens(tokens) { this.tokens = tokens; }
+    /** The wss:// URL of the event stream, derived from baseUrl (never from a server answer). */
+    get wsUrl() {
+        return `${this.baseUrl.replace(/^http/, "ws")}/agent/v1/ws`;
+    }
+    // ── The generic request ─────────────────────────────────────────────────────
+    /** An authenticated request: refresh-and-retry once on an expired token. */
+    async request(method, path, opts = {}) {
+        if (!this.tokens)
+            throw new HainivaAgentError(0, "not_signed_in");
+        const idem = method === "POST" ? newIdempotencyKey() : undefined;
+        const token = await this.tokens.accessToken();
+        try {
+            return await this.raw(method, path, opts, token, idem);
+        }
+        catch (e) {
+            if (!(e instanceof HainivaAgentError) || e.status !== 401 || (e.code !== "token_expired" && e.code !== "token_invalid"))
+                throw e;
+            this.log("access_token_refused", { code: e.code });
+            this.tokens.invalidate(token);
+            const next = await this.tokens.accessToken();
+            return this.raw(method, path, opts, next, idem);
+        }
+    }
+    async raw(method, path, opts, token, idem) {
+        let url = `${this.baseUrl}${path}`;
+        if (opts.query) {
+            const q = new URLSearchParams();
+            for (const [k, v] of Object.entries(opts.query))
+                if (v !== undefined && v !== "")
+                    q.set(k, String(v));
+            const s = q.toString();
+            if (s)
+                url += `?${s}`;
+        }
+        const headers = { accept: "application/json" };
+        if (token) {
+            this.redactor.add(token);
+            headers["authorization"] = `Bearer ${token}`;
+        }
+        if (idem)
+            headers["idempotency-key"] = idem;
+        let body;
+        if (opts.body !== undefined) {
+            headers["content-type"] = "application/json";
+            body = JSON.stringify(opts.body);
+        }
+        const ctl = new AbortController();
+        const timeout = opts.timeoutMs ?? this.timeoutMs;
+        let timedOut = false;
+        const timer = setTimeout(() => { timedOut = true; ctl.abort(); }, timeout);
+        const onAbort = () => ctl.abort();
+        if (opts.signal) {
+            if (opts.signal.aborted) {
+                clearTimeout(timer);
+                throw new HainivaAgentError(0, "aborted");
+            }
+            opts.signal.addEventListener("abort", onAbort, { once: true });
+        }
+        let res;
+        try {
+            res = await this.fetchFn(url, { method, headers, ...(body !== undefined ? { body } : {}), signal: ctl.signal });
+        }
+        catch (e) {
+            if (timedOut)
+                throw new HainivaAgentError(0, "timeout", { timeoutMs: timeout });
+            if (opts.signal?.aborted)
+                throw new HainivaAgentError(0, "aborted");
+            throw HainivaAgentError.from(e, "network_error", this.redactor);
+        }
+        finally {
+            clearTimeout(timer);
+            opts.signal?.removeEventListener("abort", onAbort);
+        }
+        if (res.status === 204)
+            return undefined;
+        let data = null;
+        const text = await res.text().catch(() => "");
+        if (text) {
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                data = null;
+            }
+        }
+        if (!res.ok)
+            throw errorFromResponse(res.status, data, this.redactor, res.headers?.get?.("retry-after") ?? null);
+        if (data === null || typeof data !== "object")
+            throw new HainivaAgentError(res.status, "invalid_response", {}, this.redactor);
+        return data;
+    }
+    // ── Me ──────────────────────────────────────────────────────────────────────
+    async me(o) { return this.request("GET", "/agent/v1/me", o); }
+    async setStatus(status, o) {
+        return this.request("PUT", "/agent/v1/me/status", { ...o, body: { status } });
+    }
+    /** Rings for this member now (after a cold start, a missed push or a resync). */
+    async pendingRings(o) {
+        const r = await this.request("GET", "/agent/v1/rings/pending", o);
+        return Array.isArray(r.data) ? r.data : [];
+    }
+    // ── Calls ───────────────────────────────────────────────────────────────────
+    async getCall(callId, o) { return this.request("GET", `/agent/v1/calls/${id(callId, "callId")}`, o); }
+    async acceptCall(callId, o) { return this.request("POST", `/agent/v1/calls/${id(callId, "callId")}/accept`, { ...o, body: {} }); }
+    async declineCall(callId, o) { return this.request("POST", `/agent/v1/calls/${id(callId, "callId")}/decline`, { ...o, body: {} }); }
+    async endCall(callId, o) { return this.request("POST", `/agent/v1/calls/${id(callId, "callId")}/end`, { ...o, body: {} }); }
+    async holdCall(callId, on, o) {
+        return this.request("POST", `/agent/v1/calls/${id(callId, "callId")}/hold`, { ...o, body: { on } });
+    }
+    async transferCall(callId, target, o) {
+        let body;
+        if ("agentId" in target)
+            body = { targetAgentId: id(target.agentId, "agentId"), mode: target.mode ?? "warm" };
+        else if ("queueId" in target)
+            body = { queueId: id(target.queueId, "queueId") };
+        else
+            body = { number: target.number, mode: target.mode ?? "warm" };
+        return this.request("POST", `/agent/v1/calls/${id(callId, "callId")}/transfer`, { ...o, body });
+    }
+    /**
+     * A 15-minute desk token for the embedded HAINIVA desk (S4): give it to the
+     * desk over postMessage only (`@hainiva/agent-sdk/embed` does). Never put it
+     * in a URL or storage. Ends with this session.
+     */
+    async deskSession(o) { return this.request("POST", "/agent/v1/desk-session", { ...o, body: {} }); }
+    /** Re-mint the LiveKit token while still a participant (reconnect, token near expiry). */
+    async mediaToken(callId, o) { return this.request("POST", `/agent/v1/calls/${id(callId, "callId")}/media-token`, { ...o, body: {} }); }
+    // ── Wrap-up ─────────────────────────────────────────────────────────────────
+    async dispositions(channel, o) {
+        const r = await this.request("GET", "/agent/v1/dispositions", { ...o, ...(channel ? { query: { channel } } : {}) });
+        return Array.isArray(r.data) ? r.data : [];
+    }
+    async wrapUp(callId, w = {}, o) {
+        return this.request("POST", `/agent/v1/calls/${id(callId, "callId")}/wrapup`, { ...o, body: w });
+    }
+    // ── Conversations and messages ──────────────────────────────────────────────
+    async listConversations(q = {}, o) {
+        return this.request("GET", "/agent/v1/conversations", { ...o, query: { scope: q.scope, status: q.status, cursor: q.cursor, limit: q.limit } }).then((page));
+    }
+    async getConversation(conversationId, o) {
+        return this.request("GET", `/agent/v1/conversations/${id(conversationId, "conversationId")}`, o);
+    }
+    /** Claim it (no agentId), or — a supervisor — assign it to a colleague. */
+    async assignConversation(conversationId, agentId, o) {
+        return this.request("POST", `/agent/v1/conversations/${id(conversationId, "conversationId")}/assign`, { ...o, body: agentId ? { agentId: id(agentId, "agentId") } : {} });
+    }
+    async releaseConversation(conversationId, note, o) {
+        return this.request("POST", `/agent/v1/conversations/${id(conversationId, "conversationId")}/release`, { ...o, body: note ? { note } : {} });
+    }
+    async transferConversation(conversationId, to, o) {
+        const body = "agentId" in to ? { agentId: id(to.agentId, "agentId") } : { queueId: id(to.queueId, "queueId"), ...(to.note ? { note: to.note } : {}) };
+        return this.request("POST", `/agent/v1/conversations/${id(conversationId, "conversationId")}/transfer`, { ...o, body });
+    }
+    async closeConversation(conversationId, o) {
+        return this.request("POST", `/agent/v1/conversations/${id(conversationId, "conversationId")}/close`, { ...o, body: {} });
+    }
+    async listMessages(conversationId, q = {}, o) {
+        return this.request("GET", `/agent/v1/conversations/${id(conversationId, "conversationId")}/messages`, { ...o, query: { after: q.after, limit: q.limit } }).then((page));
+    }
+    async sendMessage(conversationId, text, o) {
+        return this.request("POST", `/agent/v1/conversations/${id(conversationId, "conversationId")}/messages`, { ...o, body: { text } });
+    }
+    async typing(conversationId, o) {
+        return this.request("POST", `/agent/v1/conversations/${id(conversationId, "conversationId")}/typing`, { ...o, body: {} });
+    }
+    // ── Supervisor ──────────────────────────────────────────────────────────────
+    async liveCalls(o) {
+        const r = await this.request("GET", "/agent/v1/supervisor/live-calls", o);
+        return Array.isArray(r.data) ? r.data : [];
+    }
+    async teamAgents(o) {
+        const r = await this.request("GET", "/agent/v1/supervisor/agents", o);
+        return Array.isArray(r.data) ? r.data : [];
+    }
+    async supervise(callId, mode = "monitor", o) {
+        return this.request("POST", `/agent/v1/supervisor/calls/${id(callId, "callId")}/supervise`, { ...o, body: { mode } });
+    }
+    async setSuperviseMode(callId, mode, supervisorTrackSid, o) {
+        return this.request("PUT", `/agent/v1/supervisor/calls/${id(callId, "callId")}/supervise-mode`, { ...o, body: { mode, ...(supervisorTrackSid ? { supervisorTrackSid } : {}) } });
+    }
+    // ── Push (your app's own FCM / APNs credentials, uploaded by your admin) ─────
+    async registerPush(sub, o) {
+        return this.request("POST", "/agent/v1/push/subscriptions", { ...o, body: sub });
+    }
+    async unregisterPush(token, o) {
+        await this.request("DELETE", "/agent/v1/push/subscriptions", { ...o, body: { token } });
+    }
+}
+function page(r) {
+    const x = isObject(r) ? r : {};
+    return { data: Array.isArray(x["data"]) ? x["data"] : [], nextCursor: typeof x["nextCursor"] === "string" ? x["nextCursor"] : null };
+}
+//# sourceMappingURL=rest.js.map

package/dist/esm/rest.js.map

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

package/dist/esm/session.d.ts

@@ -0,0 +1,102 @@
+import { TypedEmitter } from "./emitter.js";
+import { type Logger } from "./log.js";
+import { Redactor } from "./redact.js";
+/**
+ * Where the session is kept between launches. Same shape as @hainiva/app-sdk's.
+ * The default is in memory (nothing persisted). On the web, `localStorageStore`
+ * (`@hainiva/agent-sdk/web`) is opt-in; in React Native use
+ * `secureStoreSessionStore` (`@hainiva/agent-sdk/react-native`) — the refresh
+ * token then lives only in the Keychain / Android Keystore.
+ */
+export interface SessionStore {
+    get(): Promise<string | null> | string | null;
+    set(value: string): Promise<void> | void;
+    remove(): Promise<void> | void;
+}
+/** Keeps the session for the life of the page / JS context only. The default. */
+export declare function memoryStore(): SessionStore;
+/** A staff session. Fields beyond these are kept as the server sent them. */
+export interface AgentSession {
+    accessToken: string;
+    /** ISO time. */
+    accessExpiresAt: string;
+    refreshToken: string;
+    /** ISO time. */
+    refreshExpiresAt: string;
+    [field: string]: unknown;
+}
+/**
+ * Ask YOUR backend for a fresh staff assertion (a short-lived JWT it signs with
+ * the agent app's private key). Called every time a new session is needed —
+ * the SDK never caches or stores an assertion, and you must not either: each
+ * one carries a single-use `jti` and expires in minutes.
+ */
+export type GetAssertion = () => Promise<string>;
+/**
+ * How sessions are created and refreshed — bound by the REST client.
+ * TODO(S3b): implemented against `/agent/v1/sessions` once the S2 contract is final.
+ */
+export interface SessionTransport<S extends AgentSession = AgentSession> {
+    /** Exchange an assertion for a session (POST /agent/v1/sessions). */
+    exchange(assertion: string): Promise<S>;
+    /** Rotate: a new access token and (rotating) refresh token. */
+    refresh(refreshToken: string): Promise<Pick<S, "accessToken" | "accessExpiresAt"> & Partial<S>>;
+    /** End the session on the server (best effort). */
+    revoke?(session: S): Promise<void>;
+}
+export interface SessionManagerOptions<S extends AgentSession> {
+    getAssertion: GetAssertion;
+    transport: SessionTransport<S>;
+    /** Default: memoryStore(). */
+    store?: SessionStore;
+    /** Refresh this long before the access token expires. Default 60 s. */
+    refreshSkewMs?: number;
+    now?: () => number;
+    redactor?: Redactor;
+    log?: Logger;
+}
+export interface SessionEvents<S extends AgentSession> {
+    /** A new access token (after sign-in or refresh): e.g. send it on the socket. */
+    token: string;
+    session: S | null;
+}
+/**
+ * The staff session: sign in with a fresh assertion, keep it in the store,
+ * refresh before expiry (single flight — one refresh however many callers),
+ * sign in again with a NEW assertion when the refresh is refused.
+ */
+export declare class SessionManager<S extends AgentSession = AgentSession> {
+    private readonly o;
+    readonly events: TypedEmitter<SessionEvents<S>>;
+    private session;
+    private readonly store;
+    private readonly skew;
+    private readonly now;
+    readonly redactor: Redactor;
+    private readonly log;
+    private readonly refreshOnce;
+    private forceNext;
+    constructor(o: SessionManagerOptions<S>);
+    get current(): S | null;
+    /** Restore the stored session if it can still be refreshed, else sign in afresh. */
+    signIn(): Promise<S>;
+    /** A valid access token, refreshing first when it is about to expire. */
+    accessToken(): Promise<string>;
+    /**
+     * The server refused the access token (401 / socket 4001): the next
+     * accessToken() refreshes. Pass the token that was refused: a refusal of an
+     * OLDER token (a request that was in flight while another caller already
+     * refreshed) is ignored, so ten parallel 401s cause one refresh, not ten.
+     */
+    invalidate(refused?: string): void;
+    /** Forget the session here only (the server already ended it): no revoke call. */
+    clear(): Promise<void>;
+    /** End the session here and (best effort) on the server. */
+    signOut(): Promise<void>;
+    private fresh;
+    private doRefresh;
+    private readonly freshSignIn;
+    private keep;
+    private adopt;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/esm/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChC;AAED,iFAAiF;AACjF,wBAAgB,WAAW,IAAI,YAAY,CAG1C;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACrE,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxC,+DAA+D;IAC/D,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,mDAAmD;IACnD,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,YAAY;IAC3D,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,YAAY;IACnD,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;CACnB;AAQD;;;;GAIG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAWnD,OAAO,CAAC,QAAQ,CAAC,CAAC;IAV9B,QAAQ,CAAC,MAAM,iCAAwC;IACvD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,SAAS,CAAS;gBAEG,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC;IASxD,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,CAAyB;IAEhD,oFAAoF;IAC9E,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;IAe1B,yEAAyE;IACnE,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAIpC;;;;;OAKG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAKlC,kFAAkF;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,4DAA4D;IACtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAQhB,KAAK;YAOL,SAAS;IAuBvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAmBzB;YAEW,IAAI;IAKlB,OAAO,CAAC,KAAK;CAQd"}

package/dist/esm/session.js

@@ -0,0 +1,155 @@
+import { TypedEmitter } from "./emitter.js";
+import { HainivaAgentError } from "./errors.js";
+import { safeLogger } from "./log.js";
+import { Redactor } from "./redact.js";
+import { singleFlight } from "./singleFlight.js";
+/** Keeps the session for the life of the page / JS context only. The default. */
+export function memoryStore() {
+    let v = null;
+    return { get: () => v, set: (x) => { v = x; }, remove: () => { v = null; } };
+}
+const isSession = (v) => {
+    const s = v;
+    return !!s && typeof s === "object" && typeof s["accessToken"] === "string" && typeof s["refreshToken"] === "string"
+        && typeof s["accessExpiresAt"] === "string" && typeof s["refreshExpiresAt"] === "string";
+};
+/**
+ * The staff session: sign in with a fresh assertion, keep it in the store,
+ * refresh before expiry (single flight — one refresh however many callers),
+ * sign in again with a NEW assertion when the refresh is refused.
+ */
+export class SessionManager {
+    constructor(o) {
+        this.o = o;
+        this.events = new TypedEmitter();
+        this.session = null;
+        this.forceNext = false;
+        this.freshSignIn = singleFlight(async () => {
+            // Always a new assertion: never cached, never stored, never reused.
+            let assertion;
+            try {
+                assertion = await this.o.getAssertion();
+            }
+            catch (e) {
+                throw HainivaAgentError.from(e, "assertion_failed", this.redactor);
+            }
+            if (typeof assertion !== "string" || assertion.split(".").length !== 3) {
+                throw new HainivaAgentError(0, "invalid_assertion", { hint: "getAssertion must resolve to a signed JWT from your backend" });
+            }
+            this.redactor.add(assertion);
+            try {
+                const s = await this.o.transport.exchange(assertion);
+                if (!isSession(s))
+                    throw new HainivaAgentError(0, "invalid_session", {}, this.redactor);
+                await this.keep(s);
+                return s;
+            }
+            catch (e) {
+                throw HainivaAgentError.from(e, "sign_in_failed", this.redactor);
+            }
+            finally {
+                this.redactor.remove(assertion);
+            }
+        });
+        this.store = o.store ?? memoryStore();
+        this.skew = o.refreshSkewMs ?? 60000;
+        this.now = o.now ?? Date.now;
+        this.redactor = o.redactor ?? new Redactor();
+        this.log = safeLogger(o.log, this.redactor);
+        this.refreshOnce = singleFlight(() => this.doRefresh());
+    }
+    get current() { return this.session; }
+    /** Restore the stored session if it can still be refreshed, else sign in afresh. */
+    async signIn() {
+        const saved = await Promise.resolve().then(() => this.store.get()).catch((e) => { this.log("store_read_failed", e); return null; });
+        if (saved) {
+            try {
+                const s = JSON.parse(saved);
+                if (isSession(s) && Date.parse(s.refreshExpiresAt) > this.now() + this.skew) {
+                    this.adopt(s);
+                    return await this.fresh();
+                }
+            }
+            catch { /* corrupt or refused: sign in afresh */ }
+            await Promise.resolve().then(() => this.store.remove()).catch(() => undefined);
+        }
+        return this.freshSignIn();
+    }
+    /** A valid access token, refreshing first when it is about to expire. */
+    async accessToken() {
+        return (await this.fresh()).accessToken;
+    }
+    /**
+     * The server refused the access token (401 / socket 4001): the next
+     * accessToken() refreshes. Pass the token that was refused: a refusal of an
+     * OLDER token (a request that was in flight while another caller already
+     * refreshed) is ignored, so ten parallel 401s cause one refresh, not ten.
+     */
+    invalidate(refused) {
+        if (refused && this.session && this.session.accessToken !== refused)
+            return;
+        this.forceNext = true;
+    }
+    /** Forget the session here only (the server already ended it): no revoke call. */
+    async clear() {
+        this.adopt(null);
+        await Promise.resolve().then(() => this.store.remove()).catch(() => undefined);
+    }
+    /** End the session here and (best effort) on the server. */
+    async signOut() {
+        const s = this.session;
+        this.adopt(null);
+        await Promise.resolve().then(() => this.store.remove()).catch(() => undefined);
+        if (s && this.o.transport.revoke)
+            await this.o.transport.revoke(s).catch((e) => this.log("revoke_failed", e));
+        this.redactor.clear();
+    }
+    async fresh() {
+        if (!this.session)
+            return this.freshSignIn();
+        const left = Date.parse(this.session.accessExpiresAt) - this.now();
+        if (!this.forceNext && left > this.skew)
+            return this.session;
+        return this.refreshOnce();
+    }
+    async doRefresh() {
+        const s = this.session;
+        if (!s)
+            return this.freshSignIn();
+        this.forceNext = false;
+        try {
+            const r = await this.o.transport.refresh(s.refreshToken);
+            if (!r || typeof r.accessToken !== "string" || !r.accessToken)
+                throw new HainivaAgentError(0, "refresh_failed", {}, this.redactor);
+            const next = { ...s, ...r };
+            await this.keep(next);
+            return next;
+        }
+        catch (e) {
+            // Refused (expired, revoked, reused): a new session from a NEW assertion.
+            if (e instanceof HainivaAgentError && (e.status === 401 || e.status === 403)) {
+                this.log("refresh_refused", { status: e.status });
+                await Promise.resolve().then(() => this.store.remove()).catch(() => undefined);
+                this.adopt(null);
+                return this.freshSignIn();
+            }
+            this.forceNext = true;
+            throw HainivaAgentError.from(e, "refresh_failed", this.redactor);
+        }
+    }
+    async keep(s) {
+        this.adopt(s);
+        await Promise.resolve().then(() => this.store.set(JSON.stringify(s))).catch((e) => this.log("store_write_failed", e));
+    }
+    adopt(s) {
+        const prev = this.session;
+        this.session = s;
+        // Old tokens stay redacted: they may still appear in an in-flight error.
+        if (s)
+            this.redactor.add(s.accessToken, s.refreshToken);
+        this.events.emit("session", s);
+        if (s && s.accessToken !== prev?.accessToken)
+            this.events.emit("token", s.accessToken);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/esm/session.js.map

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

package/dist/esm/singleFlight.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Calls `fn` at most once at a time: callers that arrive while it runs share its
+ * result (or its error). The next call after it settles runs `fn` again.
+ */
+export declare function singleFlight<T>(fn: () => Promise<T>): () => Promise<T>;
+export interface RefreshedToken {
+    token: string;
+    /** Epoch ms. */
+    expiresAt: number;
+}
+export interface TokenRefresherOptions {
+    /** Fetch a new token. Called once however many callers wait for it. */
+    refresh: () => Promise<RefreshedToken>;
+    /** Refresh this long before expiry. Default 60 s. */
+    skewMs?: number;
+    now?: () => number;
+}
+export interface TokenRefresher {
+    /** A token valid for at least `skewMs`, refreshing (once, shared) when needed. */
+    get(): Promise<string>;
+    /** Forget the current token (the server refused it): the next get() refreshes. */
+    invalidate(): void;
+    /** Whether a token is held that is still valid beyond the skew. */
+    readonly valid: boolean;
+}
+/**
+ * Single-flight token refresh with a pluggable refresh function. Ten requests that
+ * find the token expired cause one refresh, not ten — which also keeps a
+ * rotating refresh token from being spent twice (reuse detection would then
+ * revoke the whole session family).
+ */
+export declare function createTokenRefresher(o: TokenRefresherOptions): TokenRefresher;
+//# sourceMappingURL=singleFlight.d.ts.map

package/dist/esm/singleFlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleFlight.d.ts","sourceRoot":"","sources":["../../src/singleFlight.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,CAStE;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,OAAO,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,kFAAkF;IAClF,UAAU,IAAI,IAAI,CAAC;IACnB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAkB7E"}