@peers-app/peers-ui 0.23.14 → 0.25.0

package/dist/screens/contacts/user-connect-invite.js

@@ -1,264 +0,0 @@
-"use strict";
-/**
- * Invite URL and pending-intent helpers for the user-connect QR/link flow.
- *
- * Invite codes stay in the URL fragment (never the HTTP query) and are moved
- * into tab-scoped sessionStorage before startup route restoration can persist
- * them into `mainContentPath`.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_USER_CONNECT_BASE_URL = exports.USER_CONNECT_INVITE_STORAGE_KEY = void 0;
-exports.buildUserConnectInviteUrl = buildUserConnectInviteUrl;
-exports.extractUserConnectCodeFromFragment = extractUserConnectCodeFromFragment;
-exports.normalizeUserConnectCode = normalizeUserConnectCode;
-exports.isUserConnectIntentFresh = isUserConnectIntentFresh;
-exports.stripUserConnectCodeFromUrl = stripUserConnectCodeFromUrl;
-exports.writeUserConnectPendingIntent = writeUserConnectPendingIntent;
-exports.readUserConnectPendingIntent = readUserConnectPendingIntent;
-exports.consumeUserConnectPendingIntent = consumeUserConnectPendingIntent;
-exports.clearUserConnectPendingIntent = clearUserConnectPendingIntent;
-exports.captureUserConnectInviteFromLocation = captureUserConnectInviteFromLocation;
-exports.hasPendingUserConnectInvite = hasPendingUserConnectInvite;
-exports.buildUserConnectShareText = buildUserConnectShareText;
-const peers_sdk_1 = require("@peers-app/peers-sdk");
-/** sessionStorage key for a captured inbound invite. */
-exports.USER_CONNECT_INVITE_STORAGE_KEY = "peers.userConnectInvite";
-/** Default production launch origin used when building shareable invite links. */
-exports.DEFAULT_USER_CONNECT_BASE_URL = "https://peers.app";
-/**
- * Build the canonical shareable invite URL.
- * Keeps the bearer code in the fragment and uses `?app` so signed-out PWA
- * recipients receive the app shell instead of the marketing landing page.
- * @param code Connection code (formatted or raw)
- * @param baseUrl Launch origin (no trailing slash); defaults to peers.app
- * @returns Absolute invite URL
- */
-function buildUserConnectInviteUrl(code, baseUrl = exports.DEFAULT_USER_CONNECT_BASE_URL) {
-    const normalized = normalizeUserConnectCode(code);
-    if (!normalized) {
-        throw new Error("Invalid connection code");
-    }
-    const formatted = (0, peers_sdk_1.formatConnectionCode)(normalized);
-    const origin = baseUrl.replace(/\/$/, "");
-    return `${origin}/?app#contacts/connect?code=${encodeURIComponent(formatted)}`;
-}
-/**
- * Extract a connection code from a `contacts/connect` hash fragment.
- * Accepts `#contacts/connect?code=…` or `contacts/connect?code=…`.
- * @param hashOrPath Hash or path fragment from `location.hash` / a full URL
- * @returns Raw code string from the query, or null when the route is not an invite
- */
-function extractUserConnectCodeFromFragment(hashOrPath) {
-    const raw = hashOrPath.startsWith("#") ? hashOrPath.slice(1) : hashOrPath;
-    const [pathPart, queryPart] = raw.split("?");
-    if (pathPart !== "contacts/connect") {
-        return null;
-    }
-    if (!queryPart) {
-        return null;
-    }
-    const params = new URLSearchParams(queryPart);
-    const code = params.get("code");
-    if (code === null) {
-        return null;
-    }
-    const decoded = code.trim();
-    return decoded.length > 0 ? decoded : null;
-}
-/**
- * Validate and normalize a connection code to 12 Crockford characters.
- * @param code Candidate code (formatted or raw)
- * @returns Normalized code, or null when invalid
- */
-function normalizeUserConnectCode(code) {
-    const trimmed = code.trim().toUpperCase();
-    const isRaw = /^[0-9ABCDEFGHJKMNPQRSTVWXYZ]{12}$/.test(trimmed);
-    const isFormatted = /^[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$/.test(trimmed);
-    if (!isRaw && !isFormatted) {
-        return null;
-    }
-    const compact = trimmed.replaceAll("-", "");
-    if (!(0, peers_sdk_1.isValidConnectionCode)(compact)) {
-        return null;
-    }
-    try {
-        return (0, peers_sdk_1.parseConnectionCode)(compact).code;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Whether a pending intent is still within the local invite TTL.
- * @param intent Captured intent
- * @param nowMs Current epoch ms (injectable for tests)
- * @returns True when the intent has not expired
- */
-function isUserConnectIntentFresh(intent, nowMs = Date.now()) {
-    return intent.capturedAt <= nowMs && nowMs - intent.capturedAt < peers_sdk_1.USER_CONNECT_TTL_MS;
-}
-/**
- * Replace the visible URL so the bearer code is no longer in the address bar.
- * Leaves `?app` and a non-sensitive `#contacts/connect` route shell when present.
- * @param locationLike Browser location (defaults to `window.location`)
- * @param historyLike History API (defaults to `window.history`)
- */
-function stripUserConnectCodeFromUrl(locationLike = window.location, historyLike = window.history) {
-    if (!locationLike.hash.includes("code=")) {
-        return;
-    }
-    const path = locationLike.hash.startsWith("#")
-        ? locationLike.hash.slice(1).split("?")[0]
-        : locationLike.hash.split("?")[0];
-    const nextHash = path === "contacts/connect" ? "#contacts/connect" : "";
-    const nextUrl = `${locationLike.pathname}${locationLike.search}${nextHash}`;
-    historyLike.replaceState(historyLike.state ?? null, "", nextUrl);
-}
-/**
- * Persist a pending invite in tab-scoped sessionStorage.
- * @param intent Valid intent to store
- * @param storage Storage backend (defaults to sessionStorage)
- */
-function writeUserConnectPendingIntent(intent, storage = sessionStorage) {
-    const payload = intent;
-    storage.setItem(exports.USER_CONNECT_INVITE_STORAGE_KEY, JSON.stringify(payload));
-}
-function writeErrorMarker(error, capturedAt, storage) {
-    const payload = { error, capturedAt };
-    storage.setItem(exports.USER_CONNECT_INVITE_STORAGE_KEY, JSON.stringify(payload));
-}
-function parseStoredPayload(raw) {
-    try {
-        const parsed = JSON.parse(raw);
-        const marker = parsed;
-        if (marker.error === "invalid" || marker.error === "expired") {
-            const capturedAt = marker.capturedAt;
-            if (typeof capturedAt !== "number" || !Number.isFinite(capturedAt)) {
-                return null;
-            }
-            return { error: marker.error, capturedAt };
-        }
-        if (typeof parsed.code === "string" &&
-            typeof parsed.capturedAt === "number" &&
-            Number.isFinite(parsed.capturedAt)) {
-            return {
-                code: parsed.code,
-                capturedAt: parsed.capturedAt,
-            };
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Read a pending invite without consuming it.
- * Expired entries are cleared. Invalid markers remain until consumed/cleared
- * so the connection screen can show recovery UI.
- * @param storage Storage backend
- * @param nowMs Current epoch ms
- * @returns Capture result
- */
-function readUserConnectPendingIntent(storage = sessionStorage, nowMs = Date.now()) {
-    const raw = storage.getItem(exports.USER_CONNECT_INVITE_STORAGE_KEY);
-    if (!raw) {
-        return { ok: false, reason: "none" };
-    }
-    const parsed = parseStoredPayload(raw);
-    if (!parsed) {
-        writeErrorMarker("invalid", nowMs, storage);
-        return { ok: false, reason: "invalid" };
-    }
-    if ("error" in parsed) {
-        return { ok: false, reason: parsed.error };
-    }
-    const normalized = normalizeUserConnectCode(parsed.code);
-    if (!normalized) {
-        writeErrorMarker("invalid", parsed.capturedAt, storage);
-        return { ok: false, reason: "invalid" };
-    }
-    const intent = {
-        code: normalized,
-        capturedAt: parsed.capturedAt,
-    };
-    if (!isUserConnectIntentFresh(intent, nowMs)) {
-        writeErrorMarker("expired", parsed.capturedAt, storage);
-        return { ok: false, reason: "expired" };
-    }
-    return { ok: true, intent };
-}
-/**
- * Read and remove a pending invite in one step (one-time consumption).
- * @param storage Storage backend
- * @param nowMs Current epoch ms
- * @returns Capture result for the consumed intent
- */
-function consumeUserConnectPendingIntent(storage = sessionStorage, nowMs = Date.now()) {
-    const result = readUserConnectPendingIntent(storage, nowMs);
-    storage.removeItem(exports.USER_CONNECT_INVITE_STORAGE_KEY);
-    return result;
-}
-/**
- * Remove any pending invite from sessionStorage.
- * @param storage Storage backend
- */
-function clearUserConnectPendingIntent(storage = sessionStorage) {
-    storage.removeItem(exports.USER_CONNECT_INVITE_STORAGE_KEY);
-}
-/**
- * Capture an inbound invite from the current location into sessionStorage and
- * strip the code from the address bar. Safe to call multiple times; a second
- * call with no code in the URL leaves existing storage alone.
- * @param options Optional location/history/storage/clock overrides for tests
- * @returns Capture result
- */
-function captureUserConnectInviteFromLocation(options) {
-    const locationLike = options?.locationLike ?? window.location;
-    const historyLike = options?.historyLike ?? window.history;
-    const storage = options?.storage ?? sessionStorage;
-    const nowMs = options?.nowMs ?? Date.now();
-    const extracted = extractUserConnectCodeFromFragment(locationLike.hash);
-    if (extracted === null) {
-        const rawFragment = locationLike.hash.startsWith("#")
-            ? locationLike.hash.slice(1)
-            : locationLike.hash;
-        const [path, query = ""] = rawFragment.split("?");
-        if (path === "contacts/connect" && new URLSearchParams(query).has("code")) {
-            stripUserConnectCodeFromUrl(locationLike, historyLike);
-            writeErrorMarker("invalid", nowMs, storage);
-            return { ok: false, reason: "invalid" };
-        }
-        return readUserConnectPendingIntent(storage, nowMs);
-    }
-    stripUserConnectCodeFromUrl(locationLike, historyLike);
-    const normalized = normalizeUserConnectCode(extracted);
-    if (!normalized) {
-        writeErrorMarker("invalid", nowMs, storage);
-        return { ok: false, reason: "invalid" };
-    }
-    const intent = { code: normalized, capturedAt: nowMs };
-    writeUserConnectPendingIntent(intent, storage);
-    return { ok: true, intent };
-}
-/**
- * Whether sessionStorage currently holds a fresh, valid pending invite.
- * @param storage Storage backend
- * @param nowMs Current epoch ms
- */
-function hasPendingUserConnectInvite(storage = sessionStorage, nowMs = Date.now()) {
-    return readUserConnectPendingIntent(storage, nowMs).ok;
-}
-/**
- * Share text for the Web Share API / clipboard companion copy.
- * @param inviteUrl Canonical invite URL
- * @returns Human-readable share body
- */
-function buildUserConnectShareText(inviteUrl) {
-    return [
-        "Connect with me on Peers:",
-        inviteUrl,
-        "",
-        "Both of us need Peers open. This invite expires in 10 minutes.",
-    ].join("\n");
-}

package/dist/screens/contacts/user-connect-invite.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/screens/contacts/user-connect-invite.test.js

@@ -1,215 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const peers_sdk_1 = require("@peers-app/peers-sdk");
-const user_connect_invite_1 = require("./user-connect-invite");
-function createMemoryStorage() {
-    const map = new Map();
-    return {
-        get length() {
-            return map.size;
-        },
-        clear() {
-            map.clear();
-        },
-        getItem(key) {
-            return map.get(key) ?? null;
-        },
-        key(index) {
-            return [...map.keys()][index] ?? null;
-        },
-        removeItem(key) {
-            map.delete(key);
-        },
-        setItem(key, value) {
-            map.set(key, value);
-        },
-    };
-}
-describe("user-connect-invite", () => {
-    const validCode = "ABCD1234EFGH";
-    const formattedCode = "ABCD-1234-EFGH";
-    describe("normalizeUserConnectCode", () => {
-        it("accepts formatted and unformatted valid codes", () => {
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)(validCode)).toBe(validCode);
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)(formattedCode)).toBe(validCode);
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)("abcd-1234-efgh")).toBe(validCode);
-        });
-        it("rejects invalid alphabet and length", () => {
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)("ABCD1234EFG")).toBeNull();
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)("ABCD1234EFGHI")).toBeNull();
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)("ABCD1234EFGI")).toBeNull(); // I invalid in Crockford
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)("A-B-C-D-1-2-3-4-E-F-G-H")).toBeNull();
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)("ABCD 1234 EFGH")).toBeNull();
-            expect((0, user_connect_invite_1.normalizeUserConnectCode)("")).toBeNull();
-        });
-    });
-    describe("extractUserConnectCodeFromFragment", () => {
-        it("extracts codes from contacts/connect fragments", () => {
-            expect((0, user_connect_invite_1.extractUserConnectCodeFromFragment)(`#contacts/connect?code=${formattedCode}`)).toBe(formattedCode);
-            expect((0, user_connect_invite_1.extractUserConnectCodeFromFragment)(`contacts/connect?code=${validCode}`)).toBe(validCode);
-        });
-        it("returns null for unrelated routes", () => {
-            expect((0, user_connect_invite_1.extractUserConnectCodeFromFragment)("#contacts/list")).toBeNull();
-            expect((0, user_connect_invite_1.extractUserConnectCodeFromFragment)("#home")).toBeNull();
-            expect((0, user_connect_invite_1.extractUserConnectCodeFromFragment)("#contacts/connect")).toBeNull();
-            expect((0, user_connect_invite_1.extractUserConnectCodeFromFragment)("")).toBeNull();
-        });
-    });
-    describe("buildUserConnectInviteUrl", () => {
-        it("builds the canonical peers.app URL with ?app and fragment code", () => {
-            const url = (0, user_connect_invite_1.buildUserConnectInviteUrl)(validCode);
-            expect(url).toBe(`https://peers.app/?app#contacts/connect?code=${encodeURIComponent(formattedCode)}`);
-            expect(url.includes("?app#")).toBe(true);
-            expect(url.split("?")[1]?.startsWith("app#")).toBe(true);
-            const beforeHash = url.split("#")[0];
-            expect(beforeHash.includes(validCode)).toBe(false);
-            expect(beforeHash.includes(formattedCode)).toBe(false);
-        });
-        it("accepts an explicit base URL without putting the code in the HTTP query", () => {
-            const url = (0, user_connect_invite_1.buildUserConnectInviteUrl)(formattedCode, "https://example.test/");
-            expect(url.startsWith("https://example.test/?app#")).toBe(true);
-            expect(url).toContain(`code=${encodeURIComponent(formattedCode)}`);
-            const query = new URL(url.split("#")[0]).searchParams;
-            expect(query.has("code")).toBe(false);
-            expect(query.has("app")).toBe(true);
-        });
-    });
-    describe("sessionStorage intent lifecycle", () => {
-        it("writes, reads, and one-time consumes a pending intent", () => {
-            const storage = createMemoryStorage();
-            const now = 1_000_000;
-            (0, user_connect_invite_1.writeUserConnectPendingIntent)({ code: validCode, capturedAt: now }, storage);
-            const read = (0, user_connect_invite_1.readUserConnectPendingIntent)(storage, now + 1000);
-            expect(read).toEqual({
-                ok: true,
-                intent: { code: validCode, capturedAt: now },
-            });
-            expect((0, user_connect_invite_1.hasPendingUserConnectInvite)(storage, now + 1000)).toBe(true);
-            const consumed = (0, user_connect_invite_1.consumeUserConnectPendingIntent)(storage, now + 1000);
-            expect(consumed).toEqual({
-                ok: true,
-                intent: { code: validCode, capturedAt: now },
-            });
-            expect(storage.getItem(user_connect_invite_1.USER_CONNECT_INVITE_STORAGE_KEY)).toBeNull();
-            expect((0, user_connect_invite_1.consumeUserConnectPendingIntent)(storage, now + 1000)).toEqual({
-                ok: false,
-                reason: "none",
-            });
-        });
-        it("expires stale intents using the shared TTL", () => {
-            const storage = createMemoryStorage();
-            const now = 1_000_000;
-            (0, user_connect_invite_1.writeUserConnectPendingIntent)({ code: validCode, capturedAt: now }, storage);
-            expect((0, user_connect_invite_1.readUserConnectPendingIntent)(storage, now + peers_sdk_1.USER_CONNECT_TTL_MS)).toEqual({
-                ok: false,
-                reason: "expired",
-            });
-            expect((0, user_connect_invite_1.consumeUserConnectPendingIntent)(storage, now + peers_sdk_1.USER_CONNECT_TTL_MS)).toEqual({
-                ok: false,
-                reason: "expired",
-            });
-            expect(storage.getItem(user_connect_invite_1.USER_CONNECT_INVITE_STORAGE_KEY)).toBeNull();
-        });
-        it("rejects implausible future capture timestamps", () => {
-            const storage = createMemoryStorage();
-            (0, user_connect_invite_1.writeUserConnectPendingIntent)({ code: validCode, capturedAt: 20_000 }, storage);
-            expect((0, user_connect_invite_1.readUserConnectPendingIntent)(storage, 10_000)).toEqual({
-                ok: false,
-                reason: "expired",
-            });
-        });
-        it("treats malformed stored data as invalid", () => {
-            const storage = createMemoryStorage();
-            storage.setItem(user_connect_invite_1.USER_CONNECT_INVITE_STORAGE_KEY, "{not-json");
-            expect((0, user_connect_invite_1.readUserConnectPendingIntent)(storage)).toEqual({ ok: false, reason: "invalid" });
-            expect((0, user_connect_invite_1.consumeUserConnectPendingIntent)(storage)).toEqual({
-                ok: false,
-                reason: "invalid",
-            });
-            expect(storage.getItem(user_connect_invite_1.USER_CONNECT_INVITE_STORAGE_KEY)).toBeNull();
-        });
-        it("clears pending intent explicitly", () => {
-            const storage = createMemoryStorage();
-            (0, user_connect_invite_1.writeUserConnectPendingIntent)({ code: validCode, capturedAt: Date.now() }, storage);
-            (0, user_connect_invite_1.clearUserConnectPendingIntent)(storage);
-            expect((0, user_connect_invite_1.readUserConnectPendingIntent)(storage)).toEqual({ ok: false, reason: "none" });
-        });
-    });
-    describe("capture and URL cleanup", () => {
-        it("captures a valid invite, stores it, and strips the code from the URL", () => {
-            const storage = createMemoryStorage();
-            let replacedUrl = "";
-            const locationLike = {
-                pathname: "/",
-                search: "?app",
-                hash: `#contacts/connect?code=${formattedCode}`,
-            };
-            const historyLike = {
-                state: null,
-                replaceState: (_state, _title, url) => {
-                    replacedUrl = String(url ?? "");
-                    locationLike.hash = replacedUrl.includes("#") ? `#${replacedUrl.split("#")[1]}` : "";
-                },
-            };
-            const result = (0, user_connect_invite_1.captureUserConnectInviteFromLocation)({
-                locationLike,
-                historyLike,
-                storage,
-                nowMs: 5_000,
-            });
-            expect(result).toEqual({
-                ok: true,
-                intent: { code: validCode, capturedAt: 5_000 },
-            });
-            expect(replacedUrl).toBe("/?app#contacts/connect");
-            expect(locationLike.hash).toBe("#contacts/connect");
-            expect((0, user_connect_invite_1.hasPendingUserConnectInvite)(storage, 5_000)).toBe(true);
-        });
-        it("stores an invalid marker for malformed codes and still cleans the URL", () => {
-            const storage = createMemoryStorage();
-            const locationLike = {
-                pathname: "/",
-                search: "?app",
-                hash: "#contacts/connect?code=BAD",
-            };
-            const historyLike = {
-                state: null,
-                replaceState: (_state, _title, url) => {
-                    locationLike.hash = String(url ?? "").includes("#")
-                        ? `#${String(url).split("#")[1]}`
-                        : "";
-                },
-            };
-            expect((0, user_connect_invite_1.captureUserConnectInviteFromLocation)({
-                locationLike,
-                historyLike,
-                storage,
-                nowMs: 9_000,
-            })).toEqual({ ok: false, reason: "invalid" });
-            expect(locationLike.hash).toBe("#contacts/connect");
-            expect((0, user_connect_invite_1.readUserConnectPendingIntent)(storage, 9_000)).toEqual({
-                ok: false,
-                reason: "invalid",
-            });
-        });
-        it("stripUserConnectCodeFromUrl is a no-op without a code", () => {
-            const locationLike = { pathname: "/", search: "", hash: "#home" };
-            let calls = 0;
-            (0, user_connect_invite_1.stripUserConnectCodeFromUrl)(locationLike, {
-                state: null,
-                replaceState: () => {
-                    calls += 1;
-                },
-            });
-            expect(calls).toBe(0);
-        });
-    });
-    describe("buildUserConnectShareText", () => {
-        it("mentions expiry and that both people need Peers open", () => {
-            const text = (0, user_connect_invite_1.buildUserConnectShareText)("https://peers.app/?app#contacts/connect?code=X");
-            expect(text).toContain("https://peers.app/?app#contacts/connect?code=X");
-            expect(text.toLowerCase()).toContain("expire");
-            expect(text.toLowerCase()).toContain("peers open");
-        });
-    });
-});

package/dist/screens/contacts/user-connect.d.ts

@@ -1,8 +0,0 @@
-/**
- * Connect-to-user screen: QR invite, link share, manual code entry, and trust confirmation.
- */
-/**
- * Polished Connect to user screen. Creating an invite is the default path;
- * inbound links open a review state before connecting.
- */
-export declare function UserConnect(): import("react/jsx-runtime").JSX.Element;