@sansavision/yousaid 0.0.0-stage → 0.2.0

package/dist/index.js

@@ -0,0 +1,383 @@
+import { YouSaidProofClient } from "./proof.js";
+import { RoomRealtimeClient } from "./realtime.js";
+export { YouSaidProofClient };
+export { mentionAtCaret, reconnectDelay, RoomRealtimeClient } from "./realtime.js";
+export const YOUSAID_SDK_VERSION = "0.2.0";
+export const SIGNAL_ATTACHMENT_LIMITS = { maxFiles: 3, maxFileBytes: 5 * 1024 * 1024, types: ["image/png", "image/jpeg", "image/webp", "image/gif", "application/pdf", "text/plain", "text/csv", "application/json"] };
+/**
+ * Builds a diagnostic capsule from the current page. Query strings are never
+ * included. Pass `consent: true` only after the user saw what will be shared.
+ */
+export function collectDiagnostics(options) {
+    const hasWindow = typeof window !== "undefined";
+    const capsule = { consent: true, sdkVersion: YOUSAID_SDK_VERSION };
+    if (hasWindow) {
+        capsule.route = window.location.pathname;
+        if (document.referrer) {
+            try {
+                const referrer = new URL(document.referrer);
+                capsule.referrer = `${referrer.origin}${referrer.pathname}`;
+            }
+            catch { /* ignore malformed referrer */ }
+        }
+        capsule.viewport = `${window.innerWidth}x${window.innerHeight}`;
+    }
+    if (typeof navigator !== "undefined") {
+        capsule.userAgent = navigator.userAgent.slice(0, 400);
+        capsule.locale = navigator.language;
+        const platform = navigator.userAgentData?.platform;
+        if (platform)
+            capsule.platform = platform;
+    }
+    try {
+        capsule.timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    }
+    catch { /* ignore */ }
+    if (options.appVersion)
+        capsule.appVersion = options.appVersion;
+    if (options.featureFlags?.length)
+        capsule.featureFlags = options.featureFlags.slice(0, 50);
+    if (options.breadcrumbs?.length)
+        capsule.breadcrumbs = options.breadcrumbs.slice(-30);
+    if (options.errors?.length)
+        capsule.errors = options.errors.slice(-20);
+    if (options.network?.length)
+        capsule.network = options.network.slice(-30).map((entry) => ({ ...entry, url: entry.url.split(/[?#]/)[0] ?? "" }));
+    if (options.correlationIds?.length)
+        capsule.correlationIds = options.correlationIds.slice(0, 10);
+    if (options.annotation)
+        capsule.annotation = options.annotation.slice(0, 1_000);
+    return capsule;
+}
+const VISITOR_KEY = "yousaid-visitor-id";
+/**
+ * Installation-scoped pseudonymous visitor id, stored in the host app's
+ * localStorage. Append it to hosted YouSaid links as `?visitor=` while the user
+ * is anonymous, then call `client.mergeAnonymousHistory()` after sign-in.
+ */
+export function anonymousVisitorId() {
+    try {
+        const existing = globalThis.localStorage?.getItem(VISITOR_KEY);
+        if (existing && /^[a-f0-9-]{20,64}$/i.test(existing))
+            return existing;
+        const value = crypto.randomUUID();
+        globalThis.localStorage?.setItem(VISITOR_KEY, value);
+        return value;
+    }
+    catch {
+        return crypto.randomUUID();
+    }
+}
+/**
+ * Incremental Server-Sent Events parser. Feed decoded text; returns complete events.
+ * @experimental
+ */
+export function createSseParser() {
+    let buffer = "";
+    return (chunk) => {
+        buffer += chunk.replace(/\r\n/g, "\n");
+        const events = [];
+        let boundary = buffer.indexOf("\n\n");
+        while (boundary !== -1) {
+            const block = buffer.slice(0, boundary);
+            buffer = buffer.slice(boundary + 2);
+            let event = "message";
+            const data = [];
+            for (const line of block.split("\n")) {
+                if (!line || line.startsWith(":"))
+                    continue;
+                const colon = line.indexOf(":");
+                const field = colon === -1 ? line : line.slice(0, colon);
+                const value = colon === -1 ? "" : line.slice(colon + 1).replace(/^ /, "");
+                if (field === "event")
+                    event = value;
+                else if (field === "data")
+                    data.push(value);
+            }
+            if (data.length)
+                events.push({ event, data: data.join("\n") });
+            boundary = buffer.indexOf("\n\n");
+        }
+        return events;
+    };
+}
+/**
+ * A failed YouSaid API call. `code` is the typed error code when the endpoint returns one.
+ * @experimental
+ */
+export class YouSaidApiError extends Error {
+    status;
+    code;
+    constructor(message, status, code = "") {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "YouSaidApiError";
+    }
+}
+export class YouSaidClient {
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    async sendSignal(input) {
+        const token = typeof this.#options.token === "function" ? await this.#options.token() : this.#options.token;
+        const request = this.#options.fetch ?? globalThis.fetch;
+        const endpoint = this.#options.endpoint ?? "https://yousaid.dev/api/signals";
+        const signalJson = JSON.stringify({
+            kind: input.kind ?? "support",
+            title: input.title,
+            body: input.body,
+            idempotencyKey: input.idempotencyKey ?? crypto.randomUUID(),
+            context: input.context,
+            ...(input.diagnostics ? { diagnostics: input.diagnostics } : {}),
+            ...(input.visitorId ? { visitorId: input.visitorId } : {}),
+        });
+        const files = input.attachments ?? [];
+        let response;
+        if (files.length || input.screenshot) {
+            // Multipart: the signal JSON travels in `payload`; never set content-type so the boundary is added.
+            const form = new FormData();
+            form.set("payload", signalJson);
+            for (const file of files)
+                form.append("files", file, file.name);
+            if (input.screenshot)
+                form.set("screenshot", input.screenshot, input.screenshot.name || "screenshot.png");
+            response = await request(endpoint, { method: "POST", headers: { authorization: `Bearer ${token}` }, body: form });
+        }
+        else {
+            response = await request(endpoint, {
+                method: "POST",
+                headers: {
+                    authorization: `Bearer ${token}`,
+                    "content-type": "application/json",
+                },
+                body: signalJson,
+            });
+        }
+        const payload = await response.json();
+        if (!response.ok)
+            throw new Error("error" in payload && payload.error ? payload.error : "YouSaid could not accept the signal.");
+        return payload;
+    }
+    /** Install check: verifies the signed user and records SDK health for the onboarding "verify install" step. */
+    async verifyInstallation() {
+        return this.#request(`/api/v1/installation?sdk=${encodeURIComponent(YOUSAID_SDK_VERSION)}`);
+    }
+    /** Links this browser's anonymous history (hosted forms, surveys) to the signed user. */
+    async mergeAnonymousHistory(visitorId = anonymousVisitorId()) {
+        return this.#request("/api/v1/identity/merge", { method: "POST", body: JSON.stringify({ visitorId }) });
+    }
+    /** End-user confirmation after a release: did it resolve their problem? */
+    async confirmRelease(releaseId, outcome, note) {
+        return this.#request(`/api/v1/releases/${encodeURIComponent(releaseId)}/confirmation`, { method: "POST", body: JSON.stringify({ outcome, ...(note ? { note } : {}) }) });
+    }
+    /** @experimental */
+    async listRooms() {
+        const payload = await this.#request("/api/v1/rooms");
+        return payload.rooms;
+    }
+    /** @experimental */
+    async createRoom(input) {
+        return this.#request("/api/v1/rooms", { method: "POST", body: JSON.stringify({ ...input, idempotencyKey: input.idempotencyKey ?? crypto.randomUUID() }) });
+    }
+    /** @experimental */
+    async getRoom(roomId) {
+        return this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}`);
+    }
+    /** @experimental */
+    async postRoomMessage(roomId, body, options = {}) {
+        return this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/messages`, { method: "POST", body: JSON.stringify({ body, threadRootId: options.threadRootId ?? null, idempotencyKey: options.idempotencyKey ?? crypto.randomUUID() }) });
+    }
+    /** @experimental */
+    async editRoomMessage(roomId, messageId, body) {
+        return this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/messages/${encodeURIComponent(messageId)}`, { method: "PATCH", body: JSON.stringify({ body, idempotencyKey: crypto.randomUUID() }) });
+    }
+    /** @experimental */
+    async deleteRoomMessage(roomId, messageId) {
+        await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/messages/${encodeURIComponent(messageId)}`, { method: "DELETE", headers: { "idempotency-key": crypto.randomUUID() } });
+    }
+    /** @experimental */
+    async uploadRoomAttachment(roomId, file) {
+        const form = new FormData();
+        form.set("file", file);
+        return this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/attachments`, { method: "POST", body: form, headers: { "idempotency-key": crypto.randomUUID() } });
+    }
+    /** @experimental */
+    async downloadRoomAttachment(roomId, attachmentId) {
+        const token = typeof this.#options.token === "function" ? await this.#options.token() : this.#options.token;
+        const request = this.#options.fetch ?? globalThis.fetch;
+        const response = await request(this.#apiUrl(`/api/v1/rooms/${encodeURIComponent(roomId)}/attachments/${encodeURIComponent(attachmentId)}`), { headers: { authorization: `Bearer ${token}` } });
+        if (!response.ok)
+            throw new Error("The Room attachment is unavailable.");
+        return response.blob();
+    }
+    /** @experimental */
+    async reactToRoomMessage(roomId, messageId, emoji, active = true) {
+        await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/messages/${encodeURIComponent(messageId)}/reactions`, { method: "POST", body: JSON.stringify({ emoji, active, idempotencyKey: crypto.randomUUID() }) });
+    }
+    /** @experimental */
+    async updateRoomNotifications(roomId, notificationMode, timezone = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC") {
+        await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}`, { method: "PATCH", body: JSON.stringify({ notificationMode, timezone }) });
+    }
+    /**
+     * Catch up by sequence over HTTP. When far behind, `snapshot` carries the collapsed state to rebuild from.
+     * @experimental
+     */
+    async roomEvents(roomId, afterSequence = 0, limit = 200) {
+        return this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/events?after_seq=${Math.max(0, afterSequence)}&limit=${Math.min(500, Math.max(1, limit))}`);
+    }
+    /**
+     * A realtime connection that reconnects with backoff and catches up by sequence. Call start() to connect.
+     * @experimental
+     */
+    realtime(roomId, options = {}) {
+        const origin = new URL(this.#options.endpoint ?? "https://yousaid.dev", "https://yousaid.dev").origin;
+        return new RoomRealtimeClient({ origin, ...options, roomId, connect: options.connect ?? (async () => (await this.getRoom(roomId)).realtime) });
+    }
+    /** @experimental */
+    async getRoomCanvas(roomId) {
+        return (await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/canvas`)).data;
+    }
+    /** @experimental */
+    async listRoomMembers(roomId) {
+        const payload = await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/members`);
+        return { members: payload.data, memberCount: payload.memberCount };
+    }
+    /**
+     * "Talk to a person": acknowledged immediately, pauses agent replies to you, and notifies the team.
+     * @experimental
+     */
+    async requestHuman(roomId, reason = "", idempotencyKey = crypto.randomUUID()) {
+        return (await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/handoff`, { method: "POST", body: JSON.stringify({ reason }), headers: { "idempotency-key": idempotencyKey } })).data;
+    }
+    /** @experimental */
+    async getHumanHandoff(roomId) {
+        return (await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/handoff`)).data;
+    }
+    /** @experimental */
+    async withdrawHumanHandoff(roomId) {
+        return (await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/handoff`, { method: "DELETE" })).data;
+    }
+    /** @experimental */
+    async invokeAgent(roomId, alias, request, idempotencyKey = crypto.randomUUID()) {
+        return (await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/agents/${alias}/invoke`, { method: "POST", body: JSON.stringify({ request }), headers: { "idempotency-key": idempotencyKey } })).data;
+    }
+    /** @experimental */
+    async getAgentRun(runId) {
+        return (await this.#request(`/api/v1/agent-runs/${encodeURIComponent(runId)}`)).data;
+    }
+    /** @experimental */
+    async cancelAgentRun(runId) {
+        return (await this.#request(`/api/v1/agent-runs/${encodeURIComponent(runId)}/cancel`, { method: "POST", body: "{}", headers: { "idempotency-key": `cancel-${runId}` } })).data;
+    }
+    /** @experimental */
+    async listPendingApprovals(roomId) {
+        return (await this.#request(`/api/v1/approvals?status=pending${roomId ? `&room_id=${encodeURIComponent(roomId)}` : ""}`)).data;
+    }
+    /** @experimental */
+    async searchRooms(query, options = {}) {
+        const params = new URLSearchParams({ q: query });
+        if (options.roomId)
+            params.set("room_id", options.roomId);
+        if (options.types?.length)
+            params.set("type", options.types.join(","));
+        if (options.limit)
+            params.set("limit", String(options.limit));
+        const payload = await this.#request(`/api/v1/rooms/search?${params}`);
+        return { results: payload.data, mode: payload.mode };
+    }
+    /** @experimental */
+    async joinRoom(roomId, invitationToken) {
+        await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/join`, { method: "POST", body: JSON.stringify({ invitationToken: invitationToken ?? null }) });
+    }
+    /** @experimental */
+    async leaveRoom(roomId) {
+        await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/leave`, { method: "POST", body: "{}" });
+    }
+    /** @experimental */
+    async respondToRoomPoll(roomId, pollId, input) {
+        await this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/polls/${encodeURIComponent(pollId)}/responses`, { method: "PUT", body: JSON.stringify({ optionIds: input.optionIds ?? [], answer: input.answer ?? null, ranking: input.ranking ?? [] }), headers: { "idempotency-key": crypto.randomUUID() } });
+    }
+    /** @experimental */
+    async joinSolveSession(roomId, sessionId) {
+        return this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/solve-sessions/${encodeURIComponent(sessionId)}/join`, { method: "POST", body: "{}" });
+    }
+    /** @experimental */
+    async reportRoomContent(roomId, input, idempotencyKey = crypto.randomUUID()) {
+        return this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/moderation/reports`, { method: "POST", body: JSON.stringify(input), headers: { "idempotency-key": idempotencyKey } });
+    }
+    /** @experimental */
+    async appealModerationCase(roomId, caseId, statement, idempotencyKey = crypto.randomUUID()) {
+        return this.#request(`/api/v1/rooms/${encodeURIComponent(roomId)}/moderation/${encodeURIComponent(caseId)}/appeals`, { method: "POST", body: JSON.stringify({ statement }), headers: { "idempotency-key": idempotencyKey } });
+    }
+    async listInbox(options = {}) {
+        const query = new URLSearchParams();
+        if (options.limit)
+            query.set("limit", String(options.limit));
+        if (options.before)
+            query.set("before", options.before);
+        return this.#request(`/api/v1/inbox${query.size ? `?${query}` : ""}`);
+    }
+    async markInboxRead(ids) {
+        return this.#request("/api/v1/inbox/read", { method: "POST", body: JSON.stringify(ids ? { ids } : {}) });
+    }
+    /** Stream live inbox events until `signal` aborts. Resolves when the server closes the stream. */
+    async streamInbox(onEvent, signal) {
+        const token = typeof this.#options.token === "function" ? await this.#options.token() : this.#options.token;
+        const request = this.#options.fetch ?? globalThis.fetch;
+        const response = await request(this.#apiUrl("/api/v1/inbox/stream"), { headers: { authorization: `Bearer ${token}`, accept: "text/event-stream" }, ...(signal ? { signal } : {}) });
+        if (!response.ok || !response.body)
+            throw new Error("The inbox stream is unavailable.");
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        const parse = createSseParser();
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                return;
+            for (const event of parse(decoder.decode(value, { stream: true }))) {
+                try {
+                    onEvent({ type: event.event, ...JSON.parse(event.data) });
+                }
+                catch { /* ignore malformed frames */ }
+            }
+        }
+    }
+    /**
+     * Proof collection (in-app prompt, known-customer sessions, preferences).
+     * @experimental
+     */
+    proof() {
+        return new YouSaidProofClient(this.#options);
+    }
+    async #request(path, init = {}) {
+        const token = typeof this.#options.token === "function" ? await this.#options.token() : this.#options.token;
+        const request = this.#options.fetch ?? globalThis.fetch;
+        const headers = new Headers(init.headers);
+        headers.set("authorization", `Bearer ${token}`);
+        if (!(init.body instanceof FormData))
+            headers.set("content-type", "application/json");
+        const response = await request(this.#apiUrl(path), { ...init, headers });
+        if (response.status === 204)
+            return undefined;
+        const payload = await response.json();
+        if (!response.ok) {
+            const error = payload.error;
+            if (typeof error === "string")
+                throw new YouSaidApiError(error, response.status);
+            if (error && typeof error === "object")
+                throw new YouSaidApiError(String(error.message ?? "YouSaid could not complete the Room request."), response.status, String(error.code ?? ""));
+            throw new YouSaidApiError("YouSaid could not complete the Room request.", response.status);
+        }
+        return payload;
+    }
+    #apiUrl(path) {
+        const configured = this.#options.endpoint ?? "https://yousaid.dev";
+        const url = new URL(configured, "https://yousaid.dev");
+        return `${url.origin}${path}`;
+    }
+}
+export * from "./proof.js";
+export * from "./proof-upload.js";
+export * from "./proof-strings.js";

package/dist/proof-strings.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Widget text and the world outline shared by the React SDK and the
+ * <yousaid-proof> Web Component (public/embed/yousaid-proof.js keeps its own
+ * copy because it has no build step; tests/r5-map-bubble.test.ts checks that
+ * both stay identical). Plain data: no network, no storage.
+ */
+/** @experimental */
+export type ProofStringKey = "about" | "approved" | "imported" | "permission" | "customer" | "stories" | "prev" | "next" | "pauseRotation" | "rated" | "storyOne" | "storyMany" | "from" | "via" | "videoFrom" | "video" | "audio" | "strip" | "map" | "places" | "allPlaces" | "storiesFrom" | "fromPlace" | "watch" | "watchFrom" | "close" | "dismiss" | "pause" | "play";
+/**
+ * Supported widget languages; anything else falls back to English.
+ * @experimental
+ */
+export declare const PROOF_STRINGS: Record<string, Record<ProofStringKey, string>>;
+/**
+ * The first supported base language among the candidates (a locale prop, the page language, the browser), else "en".
+ * @experimental
+ */
+export declare function proofLanguage(...candidates: Array<string | null | undefined>): string;
+/** @experimental */
+export declare function proofText(language: string, key: ProofStringKey, vars?: Record<string, string | number>): string;
+/**
+ * Stylized world outline: polygons of "longitude latitude" pairs. No tiles, no third-party data.
+ * @experimental
+ */
+export declare const WORLD_OUTLINE = "-167 66,-156 71,-130 70,-110 72,-85 72,-68 62,-60 55,-55 48,-66 45,-70 41,-76 35,-81 31,-80 25,-83 29,-90 29,-97 26,-97 21,-92 18,-88 21,-87 16,-83 10,-78 8,-80 7,-85 11,-92 14,-105 20,-110 24,-112 31,-117 32,-124 40,-124 48,-133 55,-146 60,-153 57,-165 60;-73 78,-60 82,-30 83,-20 76,-22 70,-42 60,-50 64,-55 70,-66 76;-85 22,-80 23,-74 20,-78 20;-74 19,-69 19,-68 18,-72 18;-80 8,-72 12,-62 10,-52 5,-44 -2,-35 -6,-39 -15,-41 -22,-48 -26,-53 -34,-58 -38,-62 -40,-65 -45,-68 -52,-73 -53,-75 -46,-73 -37,-71 -28,-70 -18,-76 -14,-81 -5,-80 0,-77 4;-10 36,-9 43,-2 44,-4 48,2 51,5 53,8 54,9 57,5 58,5 62,12 65,18 70,28 71,40 68,45 68,60 70,60 55,50 47,40 45,36 45,28 41,26 40,23 36,21 40,19 42,14 45,12 44,16 41,18 40,16 38,15 40,12 42,9 44,3 43,-1 37,-6 36;-6 50,-5 58,-3 59,0 53,1 51;-10 52,-8 55,-6 54,-6 52;-24 64,-22 66,-14 66,-14 64;-17 21,-16 28,-10 30,-6 36,10 37,11 33,20 31,30 31,33 30,36 22,39 15,43 12,51 12,48 5,40 -3,40 -10,35 -20,33 -26,27 -34,20 -35,18 -30,12 -17,13 -8,9 0,9 4,4 6,-8 4,-13 8,-17 15;44 -25,47 -25,50 -15,48 -13,44 -17;28 41,36 37,35 33,34 28,39 21,43 13,45 13,52 16,55 17,58 21,56 24,52 24,50 26,48 30,51 28,56 27,58 25,62 25,67 24,72 21,77 8,80 10,80 16,87 22,92 22,98 16,98 9,100 6,101 3,104 1,103 5,100 13,103 12,105 9,109 11,108 16,106 20,110 21,117 24,122 31,119 35,122 40,126 37,129 35,129 42,135 43,141 48,140 53,135 55,143 59,155 59,163 62,172 65,180 66,180 71,160 70,140 73,113 74,100 77,80 73,70 73,60 70,60 55,50 47,40 45,36 45;80 6,82 7,81 9,80 9;120 22,121 25,122 25,121 22;130 31,132 34,135 34,140 36,142 40,141 45,145 44,140 42,139 38,136 36,133 36,130 34;95 5,98 4,104 -2,106 -6,101 -3,96 2;109 1,113 3,117 7,119 5,117 1,116 -4,111 -3,109 -1;105 -6,110 -7,114 -8,110 -8,106 -7;120 18,122 18,124 12,126 7,122 7,120 14;131 -1,141 -2,147 -6,150 -10,141 -9,138 -8,132 -4;114 -22,114 -34,117 -35,123 -34,131 -31,138 -35,141 -38,147 -39,150 -37,153 -32,153 -25,146 -19,145 -15,142 -11,141 -17,136 -12,132 -11,129 -15,126 -14,122 -18;145 -41,148 -41,148 -43,146 -44;172 -34,175 -37,178 -38,176 -41,174 -41,173 -38;172 -41,174 -41,171 -44,167 -46,168 -44";
+/**
+ * SVG path for WORLD_OUTLINE in a 360 x 142 equirectangular box cropped to 84N..58S (x = lon + 180, y = 84 - lat).
+ * @experimental
+ */
+export declare function worldOutlinePath(): string;
+/**
+ * Marker position for a coarse location in the same box.
+ * @experimental
+ */
+export declare function mapPoint(lat: number, lon: number): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=proof-strings.d.ts.map

package/dist/proof-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-strings.d.ts","sourceRoot":"","sources":["../src/proof-strings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAoB;AACpB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7W;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAQxE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAMrF;AAED,oBAAoB;AACpB,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAG/G;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,kjEAAkjE,CAAC;AAE7kE;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAG3E"}

package/dist/proof-strings.js

@@ -0,0 +1,56 @@
+/**
+ * Widget text and the world outline shared by the React SDK and the
+ * <yousaid-proof> Web Component (public/embed/yousaid-proof.js keeps its own
+ * copy because it has no build step; tests/r5-map-bubble.test.ts checks that
+ * both stay identical). Plain data: no network, no storage.
+ */
+/**
+ * Supported widget languages; anything else falls back to English.
+ * @experimental
+ */
+export const PROOF_STRINGS = {
+    "en": { "about": "About this proof", "approved": "Approved by the customer", "imported": "Imported public review", "permission": "Shared with permission", "customer": "Customer", "stories": "Customer stories", "prev": "Previous story", "next": "Next story", "pauseRotation": "Pause rotation", "rated": "Rated {n} out of 5", "storyOne": "customer story", "storyMany": "customer stories", "from": "from", "via": "Shared with permission via", "videoFrom": "Video story from {name}", "video": "Customer video story", "audio": "Customer audio story", "strip": "Customers who shared their story", "map": "Map of customer stories by country or region", "places": "Places", "allPlaces": "All places", "storiesFrom": "Stories from {place}", "fromPlace": "From {place}", "watch": "Watch a customer video story", "watchFrom": "Watch a video story from {name}", "close": "Close video", "dismiss": "Hide video stories", "pause": "Pause scrolling", "play": "Resume scrolling" },
+    "es": { "about": "Sobre esta opinión", "approved": "Aprobado por el cliente", "imported": "Reseña pública importada", "permission": "Compartido con permiso", "customer": "Cliente", "stories": "Historias de clientes", "prev": "Historia anterior", "next": "Historia siguiente", "pauseRotation": "Pausar rotación", "rated": "Valoración: {n} de 5", "storyOne": "historia de cliente", "storyMany": "historias de clientes", "from": "de", "via": "Compartido con permiso mediante", "videoFrom": "Historia en video de {name}", "video": "Historia en video de un cliente", "audio": "Historia en audio de un cliente", "strip": "Clientes que compartieron su historia", "map": "Mapa de historias de clientes por país o región", "places": "Lugares", "allPlaces": "Todos los lugares", "storiesFrom": "Historias de {place}", "fromPlace": "Desde {place}", "watch": "Ver una historia en video de un cliente", "watchFrom": "Ver la historia en video de {name}", "close": "Cerrar video", "dismiss": "Ocultar historias en video", "pause": "Pausar desplazamiento", "play": "Reanudar desplazamiento" },
+    "fr": { "about": "À propos de ce témoignage", "approved": "Approuvé par le client", "imported": "Avis public importé", "permission": "Partagé avec autorisation", "customer": "Client", "stories": "Témoignages clients", "prev": "Témoignage précédent", "next": "Témoignage suivant", "pauseRotation": "Mettre la rotation en pause", "rated": "Noté {n} sur 5", "storyOne": "témoignage client", "storyMany": "témoignages clients", "from": "sur", "via": "Partagé avec autorisation via", "videoFrom": "Témoignage vidéo de {name}", "video": "Témoignage vidéo d'un client", "audio": "Témoignage audio d'un client", "strip": "Clients qui ont partagé leur témoignage", "map": "Carte des témoignages clients par pays ou région", "places": "Lieux", "allPlaces": "Tous les lieux", "storiesFrom": "Témoignages de {place}", "fromPlace": "Depuis {place}", "watch": "Regarder un témoignage vidéo", "watchFrom": "Regarder le témoignage vidéo de {name}", "close": "Fermer la vidéo", "dismiss": "Masquer les témoignages vidéo", "pause": "Mettre le défilement en pause", "play": "Reprendre le défilement" },
+    "de": { "about": "Über diesen Nachweis", "approved": "Vom Kunden freigegeben", "imported": "Importierte öffentliche Bewertung", "permission": "Mit Erlaubnis geteilt", "customer": "Kunde", "stories": "Kundenstimmen", "prev": "Vorherige Stimme", "next": "Nächste Stimme", "pauseRotation": "Wechsel anhalten", "rated": "Bewertet mit {n} von 5", "storyOne": "Kundenstimme", "storyMany": "Kundenstimmen", "from": "aus", "via": "Mit Erlaubnis geteilt über", "videoFrom": "Videostimme von {name}", "video": "Video einer Kundenstimme", "audio": "Audio einer Kundenstimme", "strip": "Kunden, die ihre Erfahrung geteilt haben", "map": "Karte der Kundenstimmen nach Land oder Region", "places": "Orte", "allPlaces": "Alle Orte", "storiesFrom": "Stimmen aus {place}", "fromPlace": "Aus {place}", "watch": "Video einer Kundenstimme ansehen", "watchFrom": "Videostimme von {name} ansehen", "close": "Video schließen", "dismiss": "Videostimmen ausblenden", "pause": "Laufband anhalten", "play": "Laufband fortsetzen" },
+    "pt": { "about": "Sobre este depoimento", "approved": "Aprovado pelo cliente", "imported": "Avaliação pública importada", "permission": "Compartilhado com permissão", "customer": "Cliente", "stories": "Histórias de clientes", "prev": "História anterior", "next": "Próxima história", "pauseRotation": "Pausar rotação", "rated": "Nota {n} de 5", "storyOne": "história de cliente", "storyMany": "histórias de clientes", "from": "de", "via": "Compartilhado com permissão via", "videoFrom": "História em vídeo de {name}", "video": "História em vídeo de um cliente", "audio": "História em áudio de um cliente", "strip": "Clientes que compartilharam sua história", "map": "Mapa de histórias de clientes por país ou região", "places": "Lugares", "allPlaces": "Todos os lugares", "storiesFrom": "Histórias de {place}", "fromPlace": "De {place}", "watch": "Assistir a uma história em vídeo", "watchFrom": "Assistir à história em vídeo de {name}", "close": "Fechar vídeo", "dismiss": "Ocultar histórias em vídeo", "pause": "Pausar rolagem", "play": "Retomar rolagem" },
+    "it": { "about": "Informazioni su questa testimonianza", "approved": "Approvato dal cliente", "imported": "Recensione pubblica importata", "permission": "Condiviso con permesso", "customer": "Cliente", "stories": "Storie dei clienti", "prev": "Storia precedente", "next": "Storia successiva", "pauseRotation": "Metti in pausa la rotazione", "rated": "Valutazione {n} su 5", "storyOne": "storia di un cliente", "storyMany": "storie di clienti", "from": "da", "via": "Condiviso con permesso tramite", "videoFrom": "Storia video di {name}", "video": "Storia video di un cliente", "audio": "Storia audio di un cliente", "strip": "Clienti che hanno condiviso la loro storia", "map": "Mappa delle storie dei clienti per paese o regione", "places": "Luoghi", "allPlaces": "Tutti i luoghi", "storiesFrom": "Storie da {place}", "fromPlace": "Da {place}", "watch": "Guarda una storia video di un cliente", "watchFrom": "Guarda la storia video di {name}", "close": "Chiudi video", "dismiss": "Nascondi le storie video", "pause": "Metti in pausa lo scorrimento", "play": "Riprendi lo scorrimento" },
+    "nl": { "about": "Over dit bewijs", "approved": "Goedgekeurd door de klant", "imported": "Geïmporteerde openbare review", "permission": "Gedeeld met toestemming", "customer": "Klant", "stories": "Klantverhalen", "prev": "Vorig verhaal", "next": "Volgend verhaal", "pauseRotation": "Wisselen pauzeren", "rated": "Beoordeeld met {n} van 5", "storyOne": "klantverhaal", "storyMany": "klantverhalen", "from": "uit", "via": "Gedeeld met toestemming via", "videoFrom": "Videoverhaal van {name}", "video": "Videoverhaal van een klant", "audio": "Audioverhaal van een klant", "strip": "Klanten die hun verhaal deelden", "map": "Kaart van klantverhalen per land of regio", "places": "Plaatsen", "allPlaces": "Alle plaatsen", "storiesFrom": "Verhalen uit {place}", "fromPlace": "Uit {place}", "watch": "Bekijk een videoverhaal van een klant", "watchFrom": "Bekijk het videoverhaal van {name}", "close": "Video sluiten", "dismiss": "Videoverhalen verbergen", "pause": "Scrollen pauzeren", "play": "Scrollen hervatten" },
+};
+/**
+ * The first supported base language among the candidates (a locale prop, the page language, the browser), else "en".
+ * @experimental
+ */
+export function proofLanguage(...candidates) {
+    for (const candidate of candidates) {
+        const base = String(candidate ?? "").toLowerCase().split(/[-_]/)[0] ?? "";
+        if (PROOF_STRINGS[base])
+            return base;
+    }
+    return "en";
+}
+/** @experimental */
+export function proofText(language, key, vars) {
+    const text = PROOF_STRINGS[language]?.[key] ?? PROOF_STRINGS.en[key] ?? key;
+    return text.replace(/\{(\w+)\}/g, (all, name) => (vars && vars[name] !== undefined ? String(vars[name]) : all));
+}
+/**
+ * Stylized world outline: polygons of "longitude latitude" pairs. No tiles, no third-party data.
+ * @experimental
+ */
+export const WORLD_OUTLINE = "-167 66,-156 71,-130 70,-110 72,-85 72,-68 62,-60 55,-55 48,-66 45,-70 41,-76 35,-81 31,-80 25,-83 29,-90 29,-97 26,-97 21,-92 18,-88 21,-87 16,-83 10,-78 8,-80 7,-85 11,-92 14,-105 20,-110 24,-112 31,-117 32,-124 40,-124 48,-133 55,-146 60,-153 57,-165 60;-73 78,-60 82,-30 83,-20 76,-22 70,-42 60,-50 64,-55 70,-66 76;-85 22,-80 23,-74 20,-78 20;-74 19,-69 19,-68 18,-72 18;-80 8,-72 12,-62 10,-52 5,-44 -2,-35 -6,-39 -15,-41 -22,-48 -26,-53 -34,-58 -38,-62 -40,-65 -45,-68 -52,-73 -53,-75 -46,-73 -37,-71 -28,-70 -18,-76 -14,-81 -5,-80 0,-77 4;-10 36,-9 43,-2 44,-4 48,2 51,5 53,8 54,9 57,5 58,5 62,12 65,18 70,28 71,40 68,45 68,60 70,60 55,50 47,40 45,36 45,28 41,26 40,23 36,21 40,19 42,14 45,12 44,16 41,18 40,16 38,15 40,12 42,9 44,3 43,-1 37,-6 36;-6 50,-5 58,-3 59,0 53,1 51;-10 52,-8 55,-6 54,-6 52;-24 64,-22 66,-14 66,-14 64;-17 21,-16 28,-10 30,-6 36,10 37,11 33,20 31,30 31,33 30,36 22,39 15,43 12,51 12,48 5,40 -3,40 -10,35 -20,33 -26,27 -34,20 -35,18 -30,12 -17,13 -8,9 0,9 4,4 6,-8 4,-13 8,-17 15;44 -25,47 -25,50 -15,48 -13,44 -17;28 41,36 37,35 33,34 28,39 21,43 13,45 13,52 16,55 17,58 21,56 24,52 24,50 26,48 30,51 28,56 27,58 25,62 25,67 24,72 21,77 8,80 10,80 16,87 22,92 22,98 16,98 9,100 6,101 3,104 1,103 5,100 13,103 12,105 9,109 11,108 16,106 20,110 21,117 24,122 31,119 35,122 40,126 37,129 35,129 42,135 43,141 48,140 53,135 55,143 59,155 59,163 62,172 65,180 66,180 71,160 70,140 73,113 74,100 77,80 73,70 73,60 70,60 55,50 47,40 45,36 45;80 6,82 7,81 9,80 9;120 22,121 25,122 25,121 22;130 31,132 34,135 34,140 36,142 40,141 45,145 44,140 42,139 38,136 36,133 36,130 34;95 5,98 4,104 -2,106 -6,101 -3,96 2;109 1,113 3,117 7,119 5,117 1,116 -4,111 -3,109 -1;105 -6,110 -7,114 -8,110 -8,106 -7;120 18,122 18,124 12,126 7,122 7,120 14;131 -1,141 -2,147 -6,150 -10,141 -9,138 -8,132 -4;114 -22,114 -34,117 -35,123 -34,131 -31,138 -35,141 -38,147 -39,150 -37,153 -32,153 -25,146 -19,145 -15,142 -11,141 -17,136 -12,132 -11,129 -15,126 -14,122 -18;145 -41,148 -41,148 -43,146 -44;172 -34,175 -37,178 -38,176 -41,174 -41,173 -38;172 -41,174 -41,171 -44,167 -46,168 -44";
+/**
+ * SVG path for WORLD_OUTLINE in a 360 x 142 equirectangular box cropped to 84N..58S (x = lon + 180, y = 84 - lat).
+ * @experimental
+ */
+export function worldOutlinePath() {
+    return WORLD_OUTLINE.split(";").map((shape) => `M${shape.split(",").map((pair) => { const [lon, lat] = pair.split(" ").map(Number); return `${lon + 180} ${84 - lat}`; }).join("L")}Z`).join("");
+}
+/**
+ * Marker position for a coarse location in the same box.
+ * @experimental
+ */
+export function mapPoint(lat, lon) {
+    const clamp = (value, min, max) => Math.max(min, Math.min(max, value));
+    return { x: Math.round((clamp(lon, -180, 180) + 180) * 10) / 10, y: Math.round((84 - clamp(lat, -58, 84)) * 10) / 10 };
+}

package/dist/proof-upload.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Resumable media upload for YouSaid Proof collection drafts.
+ *
+ * Protocol (same for the hosted page, the in-app prompt and headless API
+ * sessions; the draft session secret comes from startSession or
+ * POST /api/v1/proof/submissions/sessions):
+ *   POST   /api/proof/collect/drafts/{draftId}/uploads              -> { sessionId, token, partBytes, parts }
+ *   PUT    /api/proof/collect/drafts/{draftId}/uploads/{id}?part=n  (exactly partBytes; last part = remainder)
+ *   GET    /api/proof/collect/drafts/{draftId}/uploads/{id}         -> { received: number[], state }
+ *   POST   /api/proof/collect/drafts/{draftId}/uploads/{id}         -> { media, draft }
+ * Bytes stream to R2 as a multipart upload (video up to 500 MB). Each part
+ * retries with backoff; after a dropped connection, or a reload with the same
+ * file, the upload continues from the parts the server already has.
+ */
+/**
+ * `screen_recording` is stored as a video; it needs `screenConsent` (see ProofUploadOptions).
+ * @experimental
+ */
+export type ProofUploadMode = "video" | "audio" | "image" | "screenshot" | "screen_recording";
+/** @experimental */
+export type ProofUploadProgress = {
+    sent: number;
+    total: number;
+    state: "starting" | "uploading" | "retrying" | "finalizing" | "done";
+};
+/** @experimental */
+export type ProofMediaRef = {
+    uploadSessionId: string;
+    kind: "video" | "audio" | "image";
+    mode: ProofUploadMode;
+    mimeType: string;
+    bytes: number;
+    sha256: string;
+    durationMs?: number;
+};
+/** @experimental */
+export type ProofUploadResult<Draft = unknown> = {
+    media: ProofMediaRef;
+    draft: Draft;
+    previewToken?: string;
+};
+/**
+ * Where an in-progress upload is remembered so it can resume after a reload. Defaults to localStorage.
+ * @experimental
+ */
+export type ProofUploadResumeStore = {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+};
+/** @experimental */
+export type ProofUploadOptions = {
+    /** Origin of the YouSaid deployment; defaults to the current page's origin (hosted page) or https://yousaid.dev. */
+    endpoint?: string;
+    fetch?: typeof globalThis.fetch;
+    durationMs?: number;
+    /** How the file was captured; stored with the original's metadata. */
+    source?: "recorder" | "file" | "api";
+    onProgress?: (progress: ProofUploadProgress) => void;
+    signal?: AbortSignal;
+    resume?: ProofUploadResumeStore | null;
+    /** Maximum attempts per part before giving up (the upload can still be resumed later). */
+    maxAttempts?: number;
+    /**
+     * Up to three still frames of a recording (data URLs, for example from
+     * extractVideoFrames). Used only for the unsafe-media check and never
+     * stored; without frames the recording is held for a person to review.
+     */
+    frames?: string[] | (() => Promise<string[]>);
+    /**
+     * Required for mode `screen_recording`: the customer ticked the screen
+     * consent box before the screen picker opened. `version` names the consent
+     * wording they saw; it is stored with the original as evidence.
+     */
+    screenConsent?: {
+        version: string;
+        microphone?: boolean;
+    };
+};
+/** @experimental */
+export declare class ProofUploadError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(message: string, status: number, code?: string | undefined);
+}
+/**
+ * Uploads one recording or image into a draft, resumably.
+ * @experimental
+ */
+export declare function uploadProofMedia<Draft = unknown>(draftId: string, sessionToken: string, blob: Blob, mode: ProofUploadMode, options?: ProofUploadOptions): Promise<ProofUploadResult<Draft>>;
+/**
+ * Cancels an in-progress upload (for example when the customer re-records).
+ * @experimental
+ */
+export declare function abortProofUpload(draftId: string, sessionToken: string, uploadSessionId: string, uploadToken: string, options?: Pick<ProofUploadOptions, "endpoint" | "fetch">): Promise<void>;
+//# sourceMappingURL=proof-upload.d.ts.map

package/dist/proof-upload.d.ts.map

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