@bravely-studios/account-web 0.3.4

package/dist/displayName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayName.d.ts","sourceRoot":"","sources":["../src/displayName.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAUjD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD"}

package/dist/displayName.js

@@ -0,0 +1,41 @@
+// Slug → user-facing display name lookup.
+//
+// Source of truth: the H1 of each `<app>-free-vs-pro.md` in
+// `00 - AI Instructions/`. The display name is what the user sees in the
+// activation ladder copy (`Activating PrintScreen.ly Pro…`), in the cross-app
+// card (`You own 3 Bravely Pro apps on this account.`), and any other
+// product-facing string the facade renders.
+//
+// Lookup is exhaustive over the `AppSlug` union — adding a new utility means
+// adding a row here. Unknown slugs fall through to a Title-cased fallback so
+// host pages never crash; observability surface logs the lookup miss.
+/**
+ * Canonical slug → display name map. Sourced from the H1 of each
+ * `<app>-free-vs-pro.md`. Branding owners: keep this in lockstep with the
+ * marketing pages on `bravely.dev/<slug>` and the Settings strings inside
+ * each utility.
+ */
+export const DISPLAY_NAMES = {
+    diskaroo: "Diskaroo",
+    markdly: "Markd.ly",
+    printscreenly: "PrintScreen.ly",
+    prodjectly: "Prodject.ly",
+    saycopypaste: "SayCopyPaste",
+    scry: "Scry",
+    stickily: "Sticki.ly",
+    terminaltags: "Terminal Tags",
+    todoingly: "Todoing.ly",
+};
+/**
+ * Returns the display name for a slug. Unknown slugs fall back to a
+ * naive Title-case rendering so host pages never crash on an unrecognized
+ * slug (e.g. a new utility added before this lib version ships).
+ */
+export function displayNameFor(slug) {
+    if (slug in DISPLAY_NAMES)
+        return DISPLAY_NAMES[slug];
+    if (slug.length === 0)
+        return slug;
+    return slug.charAt(0).toUpperCase() + slug.slice(1);
+}
+//# sourceMappingURL=displayName.js.map

package/dist/displayName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayName.js","sourceRoot":"","sources":["../src/displayName.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,4DAA4D;AAC5D,yEAAyE;AACzE,8EAA8E;AAC9E,sEAAsE;AACtE,4CAA4C;AAC5C,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,sEAAsE;AAItE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAA4B;IACpD,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,UAAU;IACnB,aAAa,EAAE,gBAAgB;IAC/B,UAAU,EAAE,aAAa;IACzB,YAAY,EAAE,cAAc;IAC5B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,eAAe;IAC7B,SAAS,EAAE,YAAY;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC,IAAe,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/dpop.d.ts

@@ -0,0 +1,30 @@
+export interface DPoPKeypair {
+    publicJwk: JsonWebKey;
+    /** RFC 7638 thumbprint of the public JWK. */
+    jktThumbprint: string;
+    /** Private key handle. Not serialisable. */
+    privateKey: CryptoKey;
+}
+/** Generate a fresh ES256 keypair with `extractable: false` on the private key. */
+export declare function generateKeypair(): Promise<DPoPKeypair>;
+/**
+ * RFC 7638 JWK thumbprint. EC keys hash the canonical-JSON of
+ * `{ crv, kty, x, y }` (lexicographically sorted, no whitespace).
+ */
+export declare function computeJwkThumbprint(jwk: JsonWebKey): Promise<string>;
+/** SHA-256(access_token), base64url-encoded — for the `ath` claim. */
+export declare function accessTokenHash(accessToken: string): Promise<string>;
+/**
+ * Build a DPoP proof JWT for the given HTTP method + URL. If an access token
+ * is supplied, includes the `ath` claim (access-token hash) per §4.2.
+ *
+ * Gate 1: function returns a real JWT; the server simply does not require
+ * the `DPoP` header. Host pages may still attach the header to seed traffic.
+ */
+export declare function generateProof(args: {
+    keypair: DPoPKeypair;
+    htm: string;
+    htu: string;
+    accessToken?: string;
+}): Promise<string>;
+//# sourceMappingURL=dpop.d.ts.map

package/dist/dpop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dpop.d.ts","sourceRoot":"","sources":["../src/dpop.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,UAAU,CAAC;IACtB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,mFAAmF;AACnF,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAU5D;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3E;AAED,sEAAsE;AACtE,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1E;AAQD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBlB"}

package/dist/dpop.js

@@ -0,0 +1,87 @@
+// RFC 9449 DPoP proof helpers.
+//
+// **Gate status:** lib SHIPS this code at Gate 1 but the server runs in
+// `off` mode and ignores DPoP. The function call surface is finalised here
+// so the Gate 2 transition is a one-line server flip; client code does not
+// rewrite.
+//
+// Key lifecycle:
+//   - ES256 (P-256 ECDSA) keypair, `extractable: false`. Private key is a
+//     WebCrypto handle stored in IndexedDB (handle reference; bytes never
+//     leave the subtle worker).
+//   - Public key JWK + RFC 7638 thumbprint = `jkt` claim baked into BAS rows
+//     for binding.
+//
+// Proof JWT (per §4.2):
+//   header: { alg: "ES256", typ: "dpop+jwt", jwk: <public JWK> }
+//   payload: { jti: <random>, htm: <method>, htu: <url>, iat: <epoch> [, ath: <hash(at)>] }
+//   signature: ES256 over `${b64(header)}.${b64(payload)}`
+import { base64urlEncode } from "./oauth.js";
+const ALG = { name: "ECDSA", namedCurve: "P-256" };
+const SIGN_ALG = { name: "ECDSA", hash: "SHA-256" };
+/** Generate a fresh ES256 keypair with `extractable: false` on the private key. */
+export async function generateKeypair() {
+    const kp = await crypto.subtle.generateKey(ALG, false, ["sign", "verify"]);
+    const publicJwk = await crypto.subtle.exportKey("jwk", kp.publicKey);
+    // Make sure only the public-portion fields are kept (sanity strip; private
+    // can't actually be exported since extractable=false).
+    delete publicJwk.d;
+    delete publicJwk.key_ops;
+    delete publicJwk.ext;
+    const jktThumbprint = await computeJwkThumbprint(publicJwk);
+    return { publicJwk, jktThumbprint, privateKey: kp.privateKey };
+}
+/**
+ * RFC 7638 JWK thumbprint. EC keys hash the canonical-JSON of
+ * `{ crv, kty, x, y }` (lexicographically sorted, no whitespace).
+ */
+export async function computeJwkThumbprint(jwk) {
+    if (jwk.kty !== "EC")
+        throw new Error(`Unsupported jwk.kty: ${jwk.kty}`);
+    const canonical = { crv: jwk.crv, kty: jwk.kty, x: jwk.x, y: jwk.y };
+    const bytes = new TextEncoder().encode(JSON.stringify(canonical));
+    const digest = await crypto.subtle.digest("SHA-256", bytes);
+    return base64urlEncode(new Uint8Array(digest));
+}
+/** SHA-256(access_token), base64url-encoded — for the `ath` claim. */
+export async function accessTokenHash(accessToken) {
+    const bytes = new TextEncoder().encode(accessToken);
+    const digest = await crypto.subtle.digest("SHA-256", bytes);
+    return base64urlEncode(new Uint8Array(digest));
+}
+function randomJti() {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    return base64urlEncode(bytes);
+}
+/**
+ * Build a DPoP proof JWT for the given HTTP method + URL. If an access token
+ * is supplied, includes the `ath` claim (access-token hash) per §4.2.
+ *
+ * Gate 1: function returns a real JWT; the server simply does not require
+ * the `DPoP` header. Host pages may still attach the header to seed traffic.
+ */
+export async function generateProof(args) {
+    const header = {
+        alg: "ES256",
+        typ: "dpop+jwt",
+        jwk: args.keypair.publicJwk,
+    };
+    const payload = {
+        jti: randomJti(),
+        htm: args.htm.toUpperCase(),
+        htu: args.htu,
+        iat: Math.floor(Date.now() / 1000),
+    };
+    if (args.accessToken)
+        payload.ath = await accessTokenHash(args.accessToken);
+    const encH = base64urlEncode(new TextEncoder().encode(JSON.stringify(header)));
+    const encP = base64urlEncode(new TextEncoder().encode(JSON.stringify(payload)));
+    const signingInput = `${encH}.${encP}`;
+    const sig = await crypto.subtle.sign(SIGN_ALG, args.keypair.privateKey, new TextEncoder().encode(signingInput));
+    // WebCrypto returns raw r||s for ECDSA; that's already the JOSE-mandated
+    // shape (no DER-unwrap needed).
+    const encS = base64urlEncode(new Uint8Array(sig));
+    return `${signingInput}.${encS}`;
+}
+//# sourceMappingURL=dpop.js.map

package/dist/dpop.js.map

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

package/dist/hooks/useActivationLaneFromUrl.d.ts

@@ -0,0 +1,54 @@
+import type { BravelyAccountManager } from "../BravelyAccountManager.js";
+export type ActivationLaneSource = "upgraded" | "checkout" | "subscription" | null;
+export interface ActivationLaneResult {
+    /** True iff any recognized post-checkout return param is present. */
+    inActivationLane: boolean;
+    /** Which param was detected (or null). */
+    source: ActivationLaneSource;
+    /** The raw query param value (e.g. `"true"`, `"complete"`, `"success"`). */
+    rawValue: string | null;
+    /**
+     * Removes the recognized post-checkout query param via
+     * `history.replaceState`. Idempotent. Host pages should call this once
+     * they have observed the activation lane is engaged.
+     */
+    clearUrlParam: () => void;
+}
+interface DetectedLane {
+    source: Exclude<ActivationLaneSource, null>;
+    paramName: string;
+    rawValue: string;
+}
+/** Pure detector — used by the hook and unit-testable on its own. */
+export declare function detectActivationLane(search: string | URLSearchParams): DetectedLane | null;
+export interface UseActivationLaneFromUrlOptions {
+    /**
+     * If supplied, the hook will call `manager.notifyCheckoutCompleted()`
+     * once when the lane is engaged.
+     */
+    manager?: BravelyAccountManager | null;
+    /**
+     * If true (default false) AND a manager is supplied AND it exposes
+     * `pollForActivation()`, the hook will start the polling loop in the
+     * background once the lane is engaged. Failures are swallowed; the
+     * caller is responsible for surfacing them via the manager's state.
+     */
+    autoStartPolling?: boolean;
+    /**
+     * Override the URL source. Defaults to `window.location.search`. Useful
+     * for SSR / testing.
+     */
+    urlSearch?: string;
+    /**
+     * Override the URL clearer. Defaults to `window.history.replaceState`.
+     */
+    onClearParam?: (paramName: string) => void;
+}
+/**
+ * React hook surfacing the post-checkout activation lane state. Stable
+ * across re-renders. Calls `manager.notifyCheckoutCompleted()` exactly
+ * once per detected lane.
+ */
+export declare function useActivationLaneFromUrl(opts?: UseActivationLaneFromUrlOptions): ActivationLaneResult;
+export {};
+//# sourceMappingURL=useActivationLaneFromUrl.d.ts.map

package/dist/hooks/useActivationLaneFromUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useActivationLaneFromUrl.d.ts","sourceRoot":"","sources":["../../src/hooks/useActivationLaneFromUrl.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,UAAU,GACV,cAAc,GACd,IAAI,CAAC;AAET,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,OAAO,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AASD,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,IAAI,CAc1F;AAED,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACvC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,GAAE,+BAAoC,GACzC,oBAAoB,CAuEtB"}

package/dist/hooks/useActivationLaneFromUrl.js

@@ -0,0 +1,105 @@
+// `useActivationLaneFromUrl()` — detect post-checkout return URL params.
+//
+// Three patterns observed across the 4 web variants per the rollout plan:
+//   - `?upgraded=true`         (prodjectly)
+//   - `?checkout=complete`     (scry-web)
+//   - `?subscription=success`  (todoingly-web)
+//
+// The hook reports whether any of those signals is present, which one fired,
+// and exposes a `clearUrlParam()` callback that removes the param via
+// `window.history.replaceState` so a refresh doesn't re-trigger the
+// activation lane. As a side effect, when `inActivationLane === true`, it
+// also fires `manager.notifyCheckoutCompleted()` once, then optionally
+// starts the `pollForActivation()` runner if `autoStartPolling` is set.
+import { useEffect, useMemo, useRef, useState } from "react";
+/** Maps each recognized param to its `source` label. */
+const PATTERNS = [
+    { param: "upgraded", source: "upgraded" },
+    { param: "checkout", source: "checkout" },
+    { param: "subscription", source: "subscription" },
+];
+/** Pure detector — used by the hook and unit-testable on its own. */
+export function detectActivationLane(search) {
+    const params = typeof search === "string"
+        ? new URLSearchParams(search.startsWith("?") ? search.slice(1) : search)
+        : search;
+    for (const { param, source } of PATTERNS) {
+        const value = params.get(param);
+        if (value === null)
+            continue;
+        // Treat any truthy / completion-style value as engaged. The three
+        // variants use `true`, `complete`, `success` respectively. Empty string
+        // is treated as "engaged" since some checkout providers send `?foo=`.
+        return { source, paramName: param, rawValue: value };
+    }
+    return null;
+}
+/**
+ * React hook surfacing the post-checkout activation lane state. Stable
+ * across re-renders. Calls `manager.notifyCheckoutCompleted()` exactly
+ * once per detected lane.
+ */
+export function useActivationLaneFromUrl(opts = {}) {
+    const { manager, autoStartPolling, urlSearch, onClearParam } = opts;
+    const detected = useMemo(() => {
+        const source = urlSearch !== undefined
+            ? urlSearch
+            : typeof window !== "undefined"
+                ? window.location.search
+                : "";
+        return detectActivationLane(source);
+    }, [urlSearch]);
+    // We hold a separate piece of state so `clearUrlParam()` calls can reset
+    // it (the hook should report `inActivationLane === false` after the
+    // caller has cleared the param). But re-deriving from `urlSearch` makes
+    // the hook deterministic.
+    const [lane, setLane] = useState(detected);
+    // Track whether we've already fired the notify side-effect for this lane.
+    const notifiedRef = useRef(null);
+    useEffect(() => {
+        setLane(detected);
+    }, [detected]);
+    useEffect(() => {
+        if (!lane)
+            return;
+        if (notifiedRef.current === lane)
+            return;
+        notifiedRef.current = lane;
+        if (manager) {
+            try {
+                manager.notifyCheckoutCompleted();
+            }
+            catch {
+                // Manager state machine may reject the event from the current
+                // state; that's a no-op by design.
+            }
+            if (autoStartPolling) {
+                // Fire-and-forget; manager surfaces results via state change.
+                const m = manager;
+                if (typeof m.pollForActivation === "function") {
+                    void m.pollForActivation().catch(() => undefined);
+                }
+            }
+        }
+    }, [lane, manager, autoStartPolling]);
+    const clearUrlParam = () => {
+        if (!lane)
+            return;
+        if (onClearParam) {
+            onClearParam(lane.paramName);
+        }
+        else if (typeof window !== "undefined" && window.history?.replaceState) {
+            const url = new URL(window.location.href);
+            url.searchParams.delete(lane.paramName);
+            window.history.replaceState(window.history.state, "", url.pathname + (url.search ? url.search : "") + url.hash);
+        }
+        setLane(null);
+    };
+    return {
+        inActivationLane: lane !== null,
+        source: lane?.source ?? null,
+        rawValue: lane?.rawValue ?? null,
+        clearUrlParam,
+    };
+}
+//# sourceMappingURL=useActivationLaneFromUrl.js.map

package/dist/hooks/useActivationLaneFromUrl.js.map

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

package/dist/hooks/useFreshLaunchRestoration.d.ts

@@ -0,0 +1,62 @@
+import type { BravelyAccountManager } from "../BravelyAccountManager.js";
+/**
+ * Returned shape from `useFreshLaunchRestoration()`. `shouldShowToast`
+ * flips true after the 3 s timer when this is a first launch with a
+ * successfully-hydrated entitlement; flips back to false when the host
+ * page calls `dismissToast()`.
+ */
+export interface FreshLaunchRestorationResult {
+    /** Count of items synced (host page provides via `setSyncedCount`). */
+    syncedCount: number | null;
+    /** Resolved name of the other device (Gate 2). Always null in Gate 1. */
+    otherDeviceName: string | null;
+    /** True iff the toast should currently render. */
+    shouldShowToast: boolean;
+    /** Plural-aware item label. Defaults to `items`. */
+    itemsLabel: string;
+    /**
+     * Fully-rendered toast copy ready to mount. Drops the `[other-device]`
+     * anchor when null (Gate 1 fallback per plan doc decision #2). Empty
+     * string when nothing should render.
+     */
+    toastText: string;
+    /** Host page reports how many items were synced (tasks, notes, etc.). */
+    setSyncedCount: (n: number) => void;
+    /** Host page closes the toast (UI dismiss). */
+    dismissToast: () => void;
+}
+export interface UseFreshLaunchRestorationOptions {
+    /** Manager singleton. Required for the entitlement-cache check. */
+    manager: BravelyAccountManager;
+    /**
+     * Storage key holding the boolean first-launch marker. Defaults to
+     * `bravely:fresh_launch_marker_v1`. Bump the suffix if the meaning of
+     * "first launch" changes.
+     */
+    markerKey?: string;
+    /** Item-label shown in the toast (e.g. "tasks", "stickies"). */
+    itemsLabel?: string;
+    /**
+     * ms after detection until the toast fires. Defaults to 3000 per the
+     * state machine `fresh_launch_restoration` 0-3s window.
+     */
+    toastDelayMs?: number;
+    /**
+     * Resolver for the "other device" string (Gate 2). Pass a function that
+     * returns the most-recent OTHER device fingerprint -> human name (e.g.
+     * "iPad" / "Mac mini"). When null, copy drops the anchor.
+     */
+    resolveOtherDeviceName?: () => string | null;
+    /** Override the localStorage / sessionStorage accessor for tests. */
+    storage?: {
+        getItem(k: string): string | null;
+        setItem(k: string, v: string): void;
+    };
+}
+/**
+ * Pure-function copy renderer for the M2 toast. Drops the `[other-device]`
+ * anchor when null. Banned: the entire "Welcome back" phrase family.
+ */
+export declare function renderFreshLaunchToastCopy(syncedCount: number | null, otherDeviceName: string | null, itemsLabel?: string): string;
+export declare function useFreshLaunchRestoration(opts: UseFreshLaunchRestorationOptions): FreshLaunchRestorationResult;
+//# sourceMappingURL=useFreshLaunchRestoration.d.ts.map

package/dist/hooks/useFreshLaunchRestoration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFreshLaunchRestoration.d.ts","sourceRoot":"","sources":["../../src/hooks/useFreshLaunchRestoration.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGzE;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C,uEAAuE;IACvE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kDAAkD;IAClD,eAAe,EAAE,OAAO,CAAC;IACzB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,cAAc,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,gCAAgC;IAC/C,mEAAmE;IACnE,OAAO,EAAE,qBAAqB,CAAC;IAC/B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC7C,qEAAqE;IACrE,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;QAClC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrC,CAAC;CACH;AAMD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,UAAU,GAAE,MAA4B,GACvC,MAAM,CAOR;AA2BD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,gCAAgC,GACrC,4BAA4B,CAuF9B"}

package/dist/hooks/useFreshLaunchRestoration.js

@@ -0,0 +1,135 @@
+// `useFreshLaunchRestoration()` — M2 silent rehydrate + brief toast.
+//
+// Detects a "fresh launch on this device" — i.e. the user signed in on a
+// new device (or cleared the cache) and we just hydrated an entitlement
+// from the server. UI is silent for the first 3 s while data loads; after
+// 3 s a bottom-edge toast surfaces with `Synced [N] [items] from your
+// [other-device].` (or the device-anchor-less variant when the resolver
+// is not available yet — Gate 1 fallback per plan doc decision #2).
+//
+// Banned: NO "Welcome back. Restoring your Pro features." Anywhere. Anti-
+// pattern #3 from the journey doc.
+//
+// First-launch detection uses a single boolean key in storage (set on first
+// hydrate). Subsequent launches see `first-launch-marker !== null` and the
+// hook returns `shouldShowToast = false`.
+import { useEffect, useRef, useState } from "react";
+const DEFAULT_MARKER_KEY = "bravely:fresh_launch_marker_v1";
+const DEFAULT_TOAST_DELAY_MS = 3000;
+const DEFAULT_ITEMS_LABEL = "items";
+/**
+ * Pure-function copy renderer for the M2 toast. Drops the `[other-device]`
+ * anchor when null. Banned: the entire "Welcome back" phrase family.
+ */
+export function renderFreshLaunchToastCopy(syncedCount, otherDeviceName, itemsLabel = DEFAULT_ITEMS_LABEL) {
+    if (syncedCount === null || syncedCount <= 0)
+        return "";
+    const label = itemsLabel || DEFAULT_ITEMS_LABEL;
+    if (otherDeviceName && otherDeviceName.length > 0) {
+        return `Synced ${syncedCount} ${label} from your ${otherDeviceName}.`;
+    }
+    return `Synced ${syncedCount} ${label}.`;
+}
+/**
+ * Choose which storage to use. localStorage on browser; in-memory shim on
+ * SSR/test. The host page's preferences in `manager.storage` are ignored
+ * here because the marker is a UI-only signal (resetting it on sign-out
+ * is undesirable — the user is still on a "fresh device" mathematically).
+ */
+function pickStorage(override) {
+    if (override)
+        return override;
+    if (typeof window !== "undefined" && window.localStorage) {
+        return {
+            getItem: (k) => window.localStorage.getItem(k),
+            setItem: (k, v) => window.localStorage.setItem(k, v),
+        };
+    }
+    const m = new Map();
+    return {
+        getItem: (k) => m.get(k) ?? null,
+        setItem: (k, v) => {
+            m.set(k, v);
+        },
+    };
+}
+export function useFreshLaunchRestoration(opts) {
+    const { manager, markerKey = DEFAULT_MARKER_KEY, itemsLabel = DEFAULT_ITEMS_LABEL, toastDelayMs = DEFAULT_TOAST_DELAY_MS, resolveOtherDeviceName, storage, } = opts;
+    const store = pickStorage(storage);
+    const [syncedCount, setSyncedCountState] = useState(null);
+    const [shouldShowToast, setShouldShowToast] = useState(false);
+    const [otherDeviceName, setOtherDeviceName] = useState(() => {
+        try {
+            return resolveOtherDeviceName ? resolveOtherDeviceName() ?? null : null;
+        }
+        catch {
+            return null;
+        }
+    });
+    // Track whether we've armed the toast for this hook lifetime so we don't
+    // double-fire on re-render.
+    const armedRef = useRef(false);
+    const timerRef = useRef(null);
+    // Track whether we've already marked first-launch so subsequent calls
+    // (e.g. React strict mode double-mount in dev) don't re-arm.
+    const markedRef = useRef(false);
+    useEffect(() => {
+        // Listen for the manager state to flip to `signed_in`. The first time
+        // that happens on a "fresh" device (no marker in storage), we arm the
+        // toast for `toastDelayMs` ms.
+        const handleState = (state) => {
+            if (state.kind !== "signed_in")
+                return;
+            if (markedRef.current)
+                return;
+            const marker = store.getItem(markerKey);
+            if (marker !== null) {
+                // Not a fresh launch; do nothing.
+                markedRef.current = true;
+                return;
+            }
+            // Fresh launch. Mark it now so a subsequent sign-out + sign-in in
+            // the same tab doesn't re-trigger.
+            store.setItem(markerKey, new Date().toISOString());
+            markedRef.current = true;
+            if (armedRef.current)
+                return;
+            armedRef.current = true;
+            timerRef.current = setTimeout(() => {
+                setShouldShowToast(true);
+            }, toastDelayMs);
+        };
+        // Fire once for the current state in case we mounted post-restore.
+        handleState(manager.getState());
+        const off = manager.onStateChange(handleState);
+        return () => {
+            off();
+            if (timerRef.current !== null)
+                clearTimeout(timerRef.current);
+        };
+    }, [manager, markerKey, store, toastDelayMs]);
+    // Re-resolve the device name if the resolver itself changes (e.g. Gate
+    // 2 plug-in mounts after first paint).
+    useEffect(() => {
+        try {
+            setOtherDeviceName(resolveOtherDeviceName ? resolveOtherDeviceName() ?? null : null);
+        }
+        catch {
+            setOtherDeviceName(null);
+        }
+    }, [resolveOtherDeviceName]);
+    const toastText = renderFreshLaunchToastCopy(syncedCount, otherDeviceName, itemsLabel);
+    // Suppress the toast surface when the copy is empty (no items, or
+    // negative count) — there is nothing to say.
+    const effectiveShow = shouldShowToast && toastText.length > 0;
+    return {
+        syncedCount,
+        otherDeviceName,
+        shouldShowToast: effectiveShow,
+        itemsLabel,
+        toastText,
+        setSyncedCount: setSyncedCountState,
+        dismissToast: () => setShouldShowToast(false),
+    };
+}
+//# sourceMappingURL=useFreshLaunchRestoration.js.map

package/dist/hooks/useFreshLaunchRestoration.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { BravelyAccountManager, BravelyClientKilledError, OAuthError } from "./BravelyAccountManager.js";
+export type { ActivationResult } from "./BravelyAccountManager.js";
+export { EntitlementCache, ENTITLEMENT_CACHE_TTL_SECONDS } from "./EntitlementCache.js";
+export { ActivationStateMachine, AUTO_ADVANCE_MS, AUTO_ADVANCE_TO, POST_CHECKOUT_RETRY, type ActivationEvent, } from "./ActivationStateMachine.js";
+export { parseDeprecation } from "./deprecation.js";
+export { generateCodeVerifier, generateCodeChallenge, generateState, buildAuthorizeUrl, parseCallback, preparePkce, base64urlEncode, base64urlDecode, } from "./oauth.js";
+export { defaultStorage, memoryStorage, sessionStorageBacked, indexedDbBacked, CompositeStorage } from "./storage.js";
+export type { Storage } from "./storage.js";
+export { generateKeypair, computeJwkThumbprint, generateProof, accessTokenHash, type DPoPKeypair, } from "./dpop.js";
+export type { AppSlug, Entitlement, EntitlementSnapshot, OAuthTokenResponse, BasResponse, BravelyAccountState, ActivationState, ActivationStateName, ManagerConfig, LibVersionPolicy, DeprecationDirective, DeprecationEndpoint, DeprecationClient, CheckoutPlan, PaddlePortalSession, CachedEntitlements, DPoPProof, } from "./types.js";
+export { ActivationLadder, ACTIVATION_LADDER_PHASE_TEMPLATES, ladderPhaseForElapsed, renderLadderCopy, buildResolvedLadder, type ActivationLadderProps, type ActivationLadderPhase, } from "./components/ActivationLadder.js";
+export { CrossAppCard, filterCrossAppEntitlements, countCrossAppEntitlements, renderCrossAppCopy, type CrossAppCardProps, } from "./components/CrossAppCard.js";
+export { useActivationLaneFromUrl, detectActivationLane, type ActivationLaneResult, type ActivationLaneSource, type UseActivationLaneFromUrlOptions, } from "./hooks/useActivationLaneFromUrl.js";
+export { useFreshLaunchRestoration, renderFreshLaunchToastCopy, type FreshLaunchRestorationResult, type UseFreshLaunchRestorationOptions, } from "./hooks/useFreshLaunchRestoration.js";
+export { displayNameFor, DISPLAY_NAMES } from "./displayName.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACzG,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtH,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,iCAAiC,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,GACrC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,GACtC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// Barrel re-exports for `@bravely-studios/account-web`.
+export { BravelyAccountManager, BravelyClientKilledError, OAuthError } from "./BravelyAccountManager.js";
+export { EntitlementCache, ENTITLEMENT_CACHE_TTL_SECONDS } from "./EntitlementCache.js";
+export { ActivationStateMachine, AUTO_ADVANCE_MS, AUTO_ADVANCE_TO, POST_CHECKOUT_RETRY, } from "./ActivationStateMachine.js";
+export { parseDeprecation } from "./deprecation.js";
+export { generateCodeVerifier, generateCodeChallenge, generateState, buildAuthorizeUrl, parseCallback, preparePkce, base64urlEncode, base64urlDecode, } from "./oauth.js";
+export { defaultStorage, memoryStorage, sessionStorageBacked, indexedDbBacked, CompositeStorage } from "./storage.js";
+export { generateKeypair, computeJwkThumbprint, generateProof, accessTokenHash, } from "./dpop.js";
+// ---- C-ux M2/M3/M4 surfaces (Wave A) ---------------------------------------
+export { ActivationLadder, ACTIVATION_LADDER_PHASE_TEMPLATES, ladderPhaseForElapsed, renderLadderCopy, buildResolvedLadder, } from "./components/ActivationLadder.js";
+export { CrossAppCard, filterCrossAppEntitlements, countCrossAppEntitlements, renderCrossAppCopy, } from "./components/CrossAppCard.js";
+export { useActivationLaneFromUrl, detectActivationLane, } from "./hooks/useActivationLaneFromUrl.js";
+export { useFreshLaunchRestoration, renderFreshLaunchToastCopy, } from "./hooks/useFreshLaunchRestoration.js";
+export { displayNameFor, DISPLAY_NAMES } from "./displayName.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEzG,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,mBAAmB,GAEpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEtH,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,eAAe,GAEhB,MAAM,WAAW,CAAC;AAqBnB,+EAA+E;AAC/E,OAAO,EACL,gBAAgB,EAChB,iCAAiC,EACjC,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GAGpB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GAIrB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,yBAAyB,EACzB,0BAA0B,GAG3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}