@mrrocket/sdk 0.21.0 → 0.23.0

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core.ts"],"sourcesContent":["/**\n * The part of the SDK that runs anywhere: experiment config, variant assignment, preview links and event shapes.\n * No React, no browser APIs, so the server helper, the proxy helper and the client share it.\n */\nimport type { CancelFlowConfig, OnboardingFlow } from \"./flows\";\nimport type { PaywallConfig } from \"./paywall\";\n\nexport type VariantId = string;\n\n/** This build of the SDK. Sent with the config request so MRRocket knows what the site runs (error tracking, flags). */\nexport const SDK_VERSION = \"0.21.0\";\n\n/** One variant of an experiment. `changes` replaces texts that the page marks with `<Text id>`. */\nexport interface VariantConfig {\n    id: VariantId;\n    /** Share of traffic, 0 to 1. The weights of an experiment add up to 1. */\n    weight: number;\n    changes?: Record<string, string>;\n    /**\n     * A redirect test: where this variant sends the visitor instead of the test's page (a path like \"/pricing-b\" or a\n     * full address). Control has none and stays. SDK 0.7.0+.\n     */\n    url?: string;\n}\n\nexport interface ExperimentConfig {\n    /** The experiment's key, the same as in Cockpit. */\n    key: string;\n    status: \"running\" | \"draft\" | \"stopped\";\n    /** Control first. */\n    variants: VariantConfig[];\n    /** A winner that shipped: everyone gets it, and nobody is assigned anymore. */\n    winner?: VariantId;\n    /** A redirect test: the path of the page it runs on (\"/pricing\"). Visitors there are sent to their variant's `url`. */\n    path?: string;\n}\n\n/** A page redirect set in MRRocket (Conversion › Landing pages › Redirect): everyone on `from` goes to `to`. SDK 0.7.0+. */\nexport interface RedirectConfig {\n    /** A path of the site, like \"/old-pricing\". */\n    from: string;\n    /** A path or a full address. */\n    to: string;\n}\n\nexport interface CockpitConfig {\n    /** The product the public key belongs to. */\n    project: string;\n    /** The language the server chose for the words below, like \"de\" (`lang` on the request). SDK 0.21.0+. */\n    lang?: string;\n    /** The SDK's own words: English source word to translation (see words.ts). Absent for English. SDK 0.21.0+. */\n    words?: Record<string, string>;\n    experiments: ExperimentConfig[];\n    /** The product's affiliate program: how many days a partner's referral is kept. Missing without a program. */\n    referral?: { cookieDays: number };\n    /** Session recordings: present only while the product records (Cockpit › Sessions). See `ReplayConfig`. */\n    replay?: ReplayConfig;\n    /** Feature flags of the product in Production (MRRocket › Build › Feature flags), evaluated by `useFlag` and `getFlag`. */\n    flags?: FlagConfig[];\n    /**\n     * Published copy for texts the site marks (`<Text id>`, `data-ck-text`): a landing page's headline, subheadline and\n     * button (`pricing.headline` …) and a paywall's (`paywall.<placement>.headline` …) as published in MRRocket. A\n     * running test's variant changes them on top. Missing when nothing is published. SDK 0.5.0+.\n     */\n    texts?: Record<string, string>;\n    /** The product's live cancel flow (MRRocket › Churn › Cancel flow), for `cancelFlow.open()`. SDK 0.7.0+. */\n    cancelFlow?: CancelFlowConfig;\n    /** The in-app steps of live onboarding flows (tours, checklists, modals). SDK 0.7.0+. */\n    onboarding?: OnboardingFlow[];\n    /** The product's brand color (\"#rrggbb\") for the onboarding dialogs when the app passes no accent. SDK 0.18.0+. */\n    onboardingAccent?: string;\n    /** A live Lifecycle journey has in-app messages: signed-in people ask `/api/sdk/inapp` for theirs. SDK 0.7.0+. */\n    messages?: boolean;\n    /** Page redirects set in MRRocket; the SDK sends visitors on before the page shows (`redirectFor`). SDK 0.7.0+. */\n    redirects?: RedirectConfig[];\n    /** Published paywalls with their pages, per placement (MRRocket › Conversion › Paywalls), for `paywall.open()`. SDK 0.14.0+. */\n    paywalls?: PaywallConfig[];\n}\n\n/** One condition of a flag's audience, on a property of the person (`identify(id, props)`), the id or the page. */\nexport interface FlagCondition {\n    /** \"Email\", \"Plan\", \"Country\", \"id\", \"path\" … Matched against the person's properties without regard to case. */\n    property: string;\n    op: \"is\" | \"is not\" | \"in\" | \"not in\" | \"≥\" | \"in cohort\";\n    values: string[];\n}\n\n/** Users who match every condition, of whom `rollout` percent get the flag. No conditions: everyone. */\nexport interface FlagConditionSet {\n    conditions: FlagCondition[];\n    /** 0 to 100. */\n    rollout: number;\n}\n\nexport interface FlagConfig {\n    key: string;\n    /** Off: everyone gets the off side. */\n    on: boolean;\n    /** The first set a person matches decides; none matched: off. */\n    sets: FlagConditionSet[];\n    /** Multivariate flags: the variants and their split in percent (control included). Missing for an on/off flag. */\n    variants?: { key: string; split: number; payload?: string }[];\n}\n\n/** What a person is for flag conditions: their properties from identify(), their id and the page they are on. */\nexport type FlagPerson = Record<string, unknown>;\n\nconst propOf = (person: FlagPerson, name: string) => {\n    const want = name.trim().toLowerCase();\n    for (const [k, v] of Object.entries(person)) if (k.toLowerCase() === want) return v;\n    return undefined;\n};\n\n/** `\"@acme.com\"` matches every address at that domain; anything else matches the whole value, without regard to case. */\nconst same = (actual: string, value: string) => {\n    const a = actual.trim().toLowerCase();\n    const v = value.trim().toLowerCase();\n    return v.startsWith(\"@\") ? a.endsWith(v) : a === v;\n};\n\nconst matchesCondition = (c: FlagCondition, person: FlagPerson) => {\n    // Cohorts live in MRRocket; a browser cannot know them, so a cohort condition never matches here.\n    if (c.op === \"in cohort\") return false;\n    const raw = propOf(person, c.property);\n    const actual = raw === undefined || raw === null ? \"\" : String(raw);\n    if (c.op === \"≥\") {\n        const a = Number(actual);\n        const b = Number(c.values[0]);\n        return actual !== \"\" && Number.isFinite(a) && Number.isFinite(b) && a >= b;\n    }\n    const hit = actual !== \"\" && c.values.some((v) => same(actual, v));\n    return c.op === \"is\" || c.op === \"in\" ? hit : !hit;\n};\n\n/**\n * The flag for one person: `false` (off), `true` (on, an on/off flag) or the variant's key (a multivariate flag). The\n * bucket is a stable hash of flag and person, so a person keeps their side as the rollout grows.\n */\nexport const evaluateFlag = (flag: FlagConfig, distinctId: string, person: FlagPerson = {}): boolean | string => {\n    if (!flag.on) return false;\n    const subject = { id: distinctId, ...person };\n    const set = flag.sets.length ? flag.sets.find((s) => s.conditions.every((c) => matchesCondition(c, subject))) : { conditions: [], rollout: 100 };\n    if (!set) return false;\n    if (flagUnit(`${flag.key}:rollout:${distinctId}`) * 100 >= set.rollout) return false;\n    if (!flag.variants?.length) return true;\n    const u = flagUnit(`${flag.key}:variant:${distinctId}`) * 100;\n    let acc = 0;\n    for (const v of flag.variants) {\n        acc += v.split;\n        if (u < acc) return v.key;\n    }\n    return flag.variants[flag.variants.length - 1].key;\n};\n\n/** A flag of the config for this person; an unknown flag (or no config) is off. */\nexport const flagFor = (key: string, config: CockpitConfig | null, distinctId: string, person: FlagPerson = {}) => {\n    const flag = config?.flags?.find((f) => f.key === key);\n    return flag ? evaluateFlag(flag, distinctId, person) : false;\n};\n\n/** One JavaScript error as it goes over the wire to `POST /api/sdk/errors`. */\nexport interface ErrorReport {\n    /** \"TypeError\", \"Error\" … */\n    type: string;\n    message: string;\n    /** The raw stack, at most 8 KB. MRRocket parses it into frames. */\n    stack?: string;\n    /** \"onerror\" (uncaught), \"onunhandledrejection\" (a rejected promise nobody caught) or \"manual\" (captureError). */\n    mechanism: \"onerror\" | \"onunhandledrejection\" | \"manual\";\n    handled: boolean;\n    url: string;\n    ts: number;\n    /** What happened just before: pages and clicks, newest last, at most 20. */\n    crumbs?: { ts: number; type: \"navigation\" | \"click\" | \"lifecycle\"; message: string }[];\n    /** Your release (a version or commit), from the provider's `release` prop. */\n    release?: string;\n    distinctId?: string;\n    sessionId?: string;\n}\n\n/**\n * Session recordings of a product, from the config. Recording also needs the visitor's own replay consent\n * (`<CockpitProvider replay>` or `setConsent({ replay: true })`); without it nothing is recorded or buffered.\n */\nexport interface ReplayConfig {\n    /**\n     * Share of sessions uploaded from their start, 0 to 1 (default 0.1). The others keep only the last minute in\n     * memory and upload it when something goes wrong: a JS error, a rage click, a `purchase…` or `checkout…` event.\n     */\n    sampleRate: number;\n}\n\n/**\n * What the SDK may send and store.\n * - \"cookieless\" (default): no cookie, no localStorage. Events go without a visitor id; the server counts visitors\n *   with a hash of key, date, IP and user agent that changes every day.\n * - \"cookies\": a persistent `ck_id` cookie identifies the visitor across visits, `ck_sid` holds the session.\n * - \"off\": nothing is sent and nothing is stored.\n */\nexport type ConsentMode = \"cookieless\" | \"cookies\" | \"off\";\n\n/**\n * What `setConsent` takes: a mode as before, or the parts to change. `replay` is the separate consent for session\n * recordings (default false); it applies only while analytics is not \"off\".\n *\n *     setConsent(\"cookies\");\n *     setConsent({ replay: true });\n *     setConsent({ analytics: \"cookieless\", replay: false });\n */\nexport type ConsentChoice = ConsentMode | { analytics?: ConsentMode; replay?: boolean };\n\n/** The campaign parameters the SDK reads from the landing URL. */\nexport const UTM_KEYS = [\"utm_source\", \"utm_medium\", \"utm_campaign\", \"utm_term\", \"utm_content\"] as const;\nexport type UtmKey = (typeof UTM_KEYS)[number];\n\n/** One event as it goes over the wire to `POST /api/sdk/events`. */\nexport interface CockpitEvent {\n    event: string;\n    /** The visitor. Missing in \"cookieless\" mode until identify(): the server then uses its daily visitor hash. */\n    distinctId?: string;\n    /** Ends after 30 minutes without an event. */\n    sessionId?: string;\n    props?: Record<string, unknown>;\n    /** Milliseconds since the epoch. */\n    ts: number;\n    url?: string;\n    /** `document.referrer` on the first page of a page load, the previous in-app URL after client-side navigation. */\n    referrer?: string;\n    utm_source?: string;\n    utm_medium?: string;\n    utm_campaign?: string;\n    utm_term?: string;\n    utm_content?: string;\n    /** The screen size in CSS pixels (points on a phone). */\n    screen?: { w: number; h: number };\n    /** The app that sent it (React Native only): MRRocket stores it with the event and fills OS and device from it. */\n    app?: AppContext;\n}\n\n/** Where a React Native event comes from. Every field is optional except the platform; nothing identifies the person. */\nexport interface AppContext {\n    /** \"ios\" or \"android\" (React Native's `Platform.OS`). */\n    platform: string;\n    /** The app's version, like \"1.4.0\" (`expo-application`'s `nativeApplicationVersion`). */\n    appVersion?: string;\n    /** The build number, like \"42\". */\n    build?: string;\n    /** The OS version, like \"17.4\". */\n    osVersion?: string;\n    /** The device model, like \"iPhone 15 Pro\" (`expo-device`). */\n    deviceModel?: string;\n    /** \"phone\", \"tablet\", \"desktop\" or \"tv\" when `expo-device` knows it. */\n    deviceType?: string;\n    /** The first preferred locale, like \"de-DE\". */\n    locale?: string;\n}\n\n/** The query parameter that forces variants, for previews in Cockpit: `?ck_preview=pricing-annual:a,home-hero:control`. */\nexport const PREVIEW_PARAM = \"ck_preview\";\n/** Set when Cockpit embeds the page: nothing is tracked, so previews never count as visits. */\nexport const EMBED_PARAM = \"ck_embed\";\n/** The cookie that keeps a visitor in the same variant across visits. Only written in \"cookies\" mode. */\nexport const ID_COOKIE = \"ck_id\";\n/** The cookie that holds the session id in \"cookies\" mode. */\nexport const SESSION_COOKIE = \"ck_sid\";\n/** A session ends after this long without an event. */\nexport const SESSION_TIMEOUT_MS = 30 * 60 * 1000;\n\n/** The UTM parameters from a parameter lookup (`URLSearchParams.get` in a browser). Empty values are left out. */\nexport const utmFrom = (get: (name: string) => string | null | undefined): Partial<Record<UtmKey, string>> => {\n    const out: Partial<Record<UtmKey, string>> = {};\n    for (const key of UTM_KEYS) {\n        const value = get(key)?.trim();\n        if (value) out[key] = value.slice(0, 150);\n    }\n    return out;\n};\n\n/** The UTM parameters of a query string, like `\"?utm_source=x\"`. Empty values are left out. */\nexport const readUtm = (search: string): Partial<Record<UtmKey, string>> => {\n    const params = new URLSearchParams(search);\n    return utmFrom((k) => params.get(k));\n};\n\n/**\n * The query parameters of a URL or query string, without `URLSearchParams` (React Native's is incomplete): `+` is a\n * space, values are percent-decoded, the first of a repeated name wins.\n */\nexport const parseQuery = (url: string): Record<string, string> => {\n    const out: Record<string, string> = {};\n    const q = url.split(\"#\")[0];\n    const at = q.indexOf(\"?\");\n    if (at < 0) return out;\n    const dec = (s: string) => {\n        try {\n            return decodeURIComponent(s.replace(/\\+/g, \" \"));\n        } catch {\n            return s;\n        }\n    };\n    for (const pair of q.slice(at + 1).split(\"&\")) {\n        if (!pair) continue;\n        const eq = pair.indexOf(\"=\");\n        const k = dec(eq < 0 ? pair : pair.slice(0, eq));\n        if (k && !(k in out)) out[k] = eq < 0 ? \"\" : dec(pair.slice(eq + 1));\n    }\n    return out;\n};\n\n/** FNV-1a, 32 bit, mapped to [0, 1). Stable across server and browser. */\nexport const hashUnit = (input: string) => {\n    let h = 0x811c9dc5;\n    for (let i = 0; i < input.length; i++) {\n        h ^= input.charCodeAt(i);\n        h = Math.imul(h, 0x01000193);\n    }\n    return (h >>> 0) / 4294967296;\n};\n\n/**\n * FNV-1a with murmur3's finalizer, mapped to [0, 1): ids that differ only at the end (\"user-1\", \"user-2\") still spread\n * evenly, so a 30 % rollout reaches about 30 % of people. Flags only; experiments keep `hashUnit` so nobody switches.\n */\nexport const flagUnit = (input: string) => {\n    let h = 0x811c9dc5;\n    for (let i = 0; i < input.length; i++) {\n        h ^= input.charCodeAt(i);\n        h = Math.imul(h, 0x01000193);\n    }\n    h ^= h >>> 16;\n    h = Math.imul(h, 0x85ebca6b);\n    h ^= h >>> 13;\n    h = Math.imul(h, 0xc2b2ae35);\n    h ^= h >>> 16;\n    return (h >>> 0) / 4294967296;\n};\n\n/** The variant a visitor sees: a shipped winner, control while the experiment does not run, else a stable bucket by visitor. */\nexport const assign = (experiment: ExperimentConfig, distinctId: string): VariantId => {\n    const control = experiment.variants[0]?.id ?? \"control\";\n    if (experiment.winner) return experiment.winner;\n    if (experiment.status !== \"running\") return control;\n    const u = hashUnit(`${experiment.key}:${distinctId}`);\n    let acc = 0;\n    for (const v of experiment.variants) {\n        acc += v.weight;\n        if (u < acc) return v.id;\n    }\n    return experiment.variants[experiment.variants.length - 1]?.id ?? control;\n};\n\n/** `\"a:b,c:d\"` → `{ a: \"b\", c: \"d\" }`. Ignores anything malformed. */\nexport const parsePreview = (value: string | string[] | null | undefined): Record<string, VariantId> => {\n    const raw = Array.isArray(value) ? value[0] : value;\n    if (!raw) return {};\n    const out: Record<string, VariantId> = {};\n    for (const pair of raw.split(\",\")) {\n        const [key, variant] = pair.split(\":\");\n        if (key && variant) out[key.trim()] = variant.trim();\n    }\n    return out;\n};\n\n/** A link that shows one variant of a page, for example in Cockpit's preview frames. */\nexport const previewHref = (url: string, forced: Record<string, VariantId>, embed = true) => {\n    const [path, query = \"\"] = url.split(\"?\");\n    const params = new URLSearchParams(query);\n    const value = Object.entries(forced)\n        .map(([k, v]) => `${k}:${v}`)\n        .join(\",\");\n    if (value) params.set(PREVIEW_PARAM, value);\n    if (embed) params.set(EMBED_PARAM, \"1\");\n    return `${path}?${params.toString()}`;\n};\n\n/** The variant for one experiment, from a forced preview first, then the config. Unknown experiments get control. */\n/** The experiments whose variants change the text `id`: showing that text is an exposure to them. */\nexport const experimentsOfText = (config: CockpitConfig | null, id: string) =>\n    (config?.experiments ?? []).filter((e) => e.variants.some((v) => v.changes && id in v.changes)).map((e) => e.key);\n\nexport const resolveVariant = (key: string, config: CockpitConfig | null, distinctId: string, preview: Record<string, VariantId>): VariantId => {\n    if (preview[key]) return preview[key];\n    const experiment = config?.experiments.find((e) => e.key === key);\n    return experiment ? assign(experiment, distinctId) : \"control\";\n};\n\n/**\n * Every text change that applies to this visitor: the published texts first, then each experiment's in config order.\n * Control keeps the published (or the page's own) words, so only a non-control variant (assigned, forced in a preview,\n * or a shipped winner) changes them further.\n */\nexport const textChanges = (config: CockpitConfig | null, distinctId: string, preview: Record<string, VariantId>) => {\n    const out: Record<string, string> = { ...(config?.texts ?? {}) };\n    for (const experiment of config?.experiments ?? []) {\n        const id = resolveVariant(experiment.key, config, distinctId, preview);\n        if (id === (experiment.variants[0]?.id ?? \"control\")) continue;\n        Object.assign(out, experiment.variants.find((v) => v.id === id)?.changes ?? {});\n    }\n    return out;\n};\n\n/**\n * The query parameter a redirect test adds to the variant's address (`ck_x=<test>:<variant>`): the page there records\n * the exposure and takes it out of the address bar. It also keeps that page from redirecting again.\n */\nexport const EXPOSURE_PARAM = \"ck_x\";\n\n/** What `redirectFor` decided: go to `to`, and/or the redirect test this page belongs to and the visitor's variant. */\nexport interface RedirectDecision {\n    /** Where to send the visitor now. Missing for control, which stays on the page. */\n    to?: string;\n    /** The redirect test, while it runs: record `$exposure` for it (on this page for control, on `to` otherwise). */\n    experiment?: string;\n    variant?: VariantId;\n}\n\nconst pathOf = (p: string) => p.replace(/\\/+$/, \"\") || \"/\";\n\n/**\n * Where a page sends the visitor, before it shows: a page redirect set in MRRocket first, else a redirect test that runs\n * on this path (the visitor's variant, by the same stable assignment as every test). Null when nothing applies.\n *\n * - The new address keeps the page's query (UTM parameters) and its hash; a running test adds `ck_x=<test>:<variant>`,\n *   so the page it lands on records the exposure (and never redirects again).\n * - `distinctId` null (no stable id, as on a server without the `ck_id` cookie): running tests are left to the browser,\n *   page redirects and shipped winners still apply.\n * - A redirect to the page itself is ignored.\n */\nexport const redirectFor = (config: CockpitConfig | null, href: string, distinctId: string | null, preview: Record<string, VariantId> = {}): RedirectDecision | null => {\n    if (!config) return null;\n    let here: URL;\n    try {\n        here = new URL(href);\n    } catch {\n        return null;\n    }\n    if (here.searchParams.has(EXPOSURE_PARAM)) return null;\n    const path = pathOf(here.pathname);\n    const go = (to: string, mark?: string) => {\n        let t: URL;\n        try {\n            t = new URL(to, here);\n        } catch {\n            return undefined;\n        }\n        if (!/^https?:$/.test(t.protocol) || (t.origin === here.origin && pathOf(t.pathname) === path)) return undefined;\n        here.searchParams.forEach((v, k) => {\n            if (!t.searchParams.has(k)) t.searchParams.set(k, v);\n        });\n        if (mark) t.searchParams.set(EXPOSURE_PARAM, mark);\n        if (!t.hash) t.hash = here.hash;\n        return t.href;\n    };\n    for (const r of config.redirects ?? []) {\n        const to = r.from && pathOf(r.from) === path ? go(r.to) : undefined;\n        if (to) return { to };\n    }\n    for (const e of config.experiments) {\n        if (!e.path || pathOf(e.path) !== path) continue;\n        const running = e.status === \"running\" && !e.winner;\n        if (running && distinctId === null && !preview[e.key]) return null;\n        const variant = resolveVariant(e.key, config, distinctId ?? \"\", preview);\n        const url = e.variants.find((v) => v.id === variant)?.url;\n        const to = url ? go(url, running ? `${e.key}:${variant}` : undefined) : undefined;\n        return running ? { to, experiment: e.key, variant } : to ? { to } : null;\n    }\n    return null;\n};\n\n/** The test and variant a redirect test's `ck_x` names, when the config has them; null otherwise. */\nexport const exposureFrom = (config: CockpitConfig | null, value: string | null | undefined) => {\n    const [key, variant] = (value ?? \"\").split(\":\");\n    const e = config?.experiments.find((x) => x.key === key);\n    return e && e.variants.some((v) => v.id === variant) ? { experiment: key, variant } : null;\n};\n\n/**\n * The MRRocket API host from `NEXT_PUBLIC_MRROCKET_HOST`. Written as a literal property access on purpose: Next.js\n * inlines `process.env.NEXT_PUBLIC_*` at build time, in the browser bundle and in the server bundle (also on\n * Cloudflare Workers), and only replaces the literal form. Without a bundler (or a `process`) it is undefined.\n */\nexport const envHost = (): string | undefined => {\n    try {\n        return process.env.NEXT_PUBLIC_MRROCKET_HOST || undefined;\n    } catch {\n        return undefined;\n    }\n};\n\n/** The public key from `NEXT_PUBLIC_MRROCKET_KEY`, the default for the `apiKey` prop. Same literal-access rule as `envHost`. */\nexport const envKey = (): string | undefined => {\n    try {\n        return process.env.NEXT_PUBLIC_MRROCKET_KEY || undefined;\n    } catch {\n        return undefined;\n    }\n};\n\n/**\n * Where the API lives: the `host` prop, else `NEXT_PUBLIC_MRROCKET_HOST`, else \"\" (the page's own origin, which is how\n * MRRocket's own demo pages call it). Without a trailing slash.\n */\nexport const resolveHost = (host?: string) => (host ?? envHost() ?? \"\").trim().replace(/\\/+$/, \"\");\n\n/** A random visitor id. */\nexport const newDistinctId = () =>\n    typeof crypto !== \"undefined\" && \"randomUUID\" in crypto ? crypto.randomUUID() : `ck_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/core.ts"],"sourcesContent":["/**\n * The part of the SDK that runs anywhere: experiment config, variant assignment, preview links and event shapes.\n * No React, no browser APIs, so the server helper, the proxy helper and the client share it.\n */\nimport type { CancelFlowConfig, OnboardingFlow } from \"./flows\";\nimport type { PaywallConfig } from \"./paywall\";\n\nexport type VariantId = string;\n\n/** This build of the SDK. Sent with the config request so MRRocket knows what the site runs (error tracking, flags). */\nexport const SDK_VERSION = \"0.23.0\";\n\n/** One variant of an experiment. `changes` replaces texts that the page marks with `<Text id>`. */\nexport interface VariantConfig {\n    id: VariantId;\n    /** Share of traffic, 0 to 1. The weights of an experiment add up to 1. */\n    weight: number;\n    changes?: Record<string, string>;\n    /**\n     * A redirect test: where this variant sends the visitor instead of the test's page (a path like \"/pricing-b\" or a\n     * full address). Control has none and stays. SDK 0.7.0+.\n     */\n    url?: string;\n}\n\nexport interface ExperimentConfig {\n    /** The experiment's key, the same as in Cockpit. */\n    key: string;\n    status: \"running\" | \"draft\" | \"stopped\";\n    /** Control first. */\n    variants: VariantConfig[];\n    /** A winner that shipped: everyone gets it, and nobody is assigned anymore. */\n    winner?: VariantId;\n    /** A redirect test: the path of the page it runs on (\"/pricing\"). Visitors there are sent to their variant's `url`. */\n    path?: string;\n}\n\n/** A page redirect set in MRRocket (Conversion › Landing pages › Redirect): everyone on `from` goes to `to`. SDK 0.7.0+. */\nexport interface RedirectConfig {\n    /** A path of the site, like \"/old-pricing\". */\n    from: string;\n    /** A path or a full address. */\n    to: string;\n}\n\nexport interface CockpitConfig {\n    /** The product the public key belongs to. */\n    project: string;\n    /** The language the server chose for the words below, like \"de\" (`lang` on the request). SDK 0.21.0+. */\n    lang?: string;\n    /** The SDK's own words: English source word to translation (see words.ts). Absent for English. SDK 0.21.0+. */\n    words?: Record<string, string>;\n    experiments: ExperimentConfig[];\n    /** The product's affiliate program: how many days a partner's referral is kept. Missing without a program. */\n    referral?: { cookieDays: number };\n    /** Session recordings: present only while the product records (Cockpit › Sessions). See `ReplayConfig`. */\n    replay?: ReplayConfig;\n    /** Feature flags of the product in Production (MRRocket › Build › Feature flags), evaluated by `useFlag` and `getFlag`. */\n    flags?: FlagConfig[];\n    /**\n     * Published copy for texts the site marks (`<Text id>`, `data-ck-text`): a landing page's headline, subheadline and\n     * button (`pricing.headline` …) and a paywall's (`paywall.<placement>.headline` …) as published in MRRocket. A\n     * running test's variant changes them on top. Missing when nothing is published. SDK 0.5.0+.\n     */\n    texts?: Record<string, string>;\n    /** The product's live cancel flow (MRRocket › Churn › Cancel flow), for `cancelFlow.open()`. SDK 0.7.0+. */\n    cancelFlow?: CancelFlowConfig;\n    /** The in-app steps of live onboarding flows (tours, checklists, modals). SDK 0.7.0+. */\n    onboarding?: OnboardingFlow[];\n    /** The product's brand color (\"#rrggbb\") for the onboarding dialogs when the app passes no accent. SDK 0.18.0+. */\n    onboardingAccent?: string;\n    /** A live Lifecycle journey has in-app messages: signed-in people ask `/api/sdk/inapp` for theirs. SDK 0.7.0+. */\n    messages?: boolean;\n    /** Page redirects set in MRRocket; the SDK sends visitors on before the page shows (`redirectFor`). SDK 0.7.0+. */\n    redirects?: RedirectConfig[];\n    /** Published paywalls with their pages, per placement (MRRocket › Conversion › Paywalls), for `paywall.open()`. SDK 0.14.0+. */\n    paywalls?: PaywallConfig[];\n}\n\n/** One condition of a flag's audience, on a property of the person (`identify(id, props)`), the id or the page. */\nexport interface FlagCondition {\n    /** \"Email\", \"Plan\", \"Country\", \"id\", \"path\" … Matched against the person's properties without regard to case. */\n    property: string;\n    op: \"is\" | \"is not\" | \"in\" | \"not in\" | \"≥\" | \"in cohort\";\n    values: string[];\n}\n\n/** Users who match every condition, of whom `rollout` percent get the flag. No conditions: everyone. */\nexport interface FlagConditionSet {\n    conditions: FlagCondition[];\n    /** 0 to 100. */\n    rollout: number;\n}\n\nexport interface FlagConfig {\n    key: string;\n    /** Off: everyone gets the off side. */\n    on: boolean;\n    /** The first set a person matches decides; none matched: off. */\n    sets: FlagConditionSet[];\n    /** Multivariate flags: the variants and their split in percent (control included). Missing for an on/off flag. */\n    variants?: { key: string; split: number; payload?: string }[];\n}\n\n/** What a person is for flag conditions: their properties from identify(), their id and the page they are on. */\nexport type FlagPerson = Record<string, unknown>;\n\nconst propOf = (person: FlagPerson, name: string) => {\n    const want = name.trim().toLowerCase();\n    for (const [k, v] of Object.entries(person)) if (k.toLowerCase() === want) return v;\n    return undefined;\n};\n\n/** `\"@acme.com\"` matches every address at that domain; anything else matches the whole value, without regard to case. */\nconst same = (actual: string, value: string) => {\n    const a = actual.trim().toLowerCase();\n    const v = value.trim().toLowerCase();\n    return v.startsWith(\"@\") ? a.endsWith(v) : a === v;\n};\n\nconst matchesCondition = (c: FlagCondition, person: FlagPerson) => {\n    // Cohorts live in MRRocket; a browser cannot know them, so a cohort condition never matches here.\n    if (c.op === \"in cohort\") return false;\n    const raw = propOf(person, c.property);\n    const actual = raw === undefined || raw === null ? \"\" : String(raw);\n    if (c.op === \"≥\") {\n        const a = Number(actual);\n        const b = Number(c.values[0]);\n        return actual !== \"\" && Number.isFinite(a) && Number.isFinite(b) && a >= b;\n    }\n    const hit = actual !== \"\" && c.values.some((v) => same(actual, v));\n    return c.op === \"is\" || c.op === \"in\" ? hit : !hit;\n};\n\n/**\n * The flag for one person: `false` (off), `true` (on, an on/off flag) or the variant's key (a multivariate flag). The\n * bucket is a stable hash of flag and person, so a person keeps their side as the rollout grows.\n */\nexport const evaluateFlag = (flag: FlagConfig, distinctId: string, person: FlagPerson = {}): boolean | string => {\n    if (!flag.on) return false;\n    const subject = { id: distinctId, ...person };\n    const set = flag.sets.length ? flag.sets.find((s) => s.conditions.every((c) => matchesCondition(c, subject))) : { conditions: [], rollout: 100 };\n    if (!set) return false;\n    if (flagUnit(`${flag.key}:rollout:${distinctId}`) * 100 >= set.rollout) return false;\n    if (!flag.variants?.length) return true;\n    const u = flagUnit(`${flag.key}:variant:${distinctId}`) * 100;\n    let acc = 0;\n    for (const v of flag.variants) {\n        acc += v.split;\n        if (u < acc) return v.key;\n    }\n    return flag.variants[flag.variants.length - 1].key;\n};\n\n/** A flag of the config for this person; an unknown flag (or no config) is off. */\nexport const flagFor = (key: string, config: CockpitConfig | null, distinctId: string, person: FlagPerson = {}) => {\n    const flag = config?.flags?.find((f) => f.key === key);\n    return flag ? evaluateFlag(flag, distinctId, person) : false;\n};\n\n/** One JavaScript error as it goes over the wire to `POST /api/sdk/errors`. */\nexport interface ErrorReport {\n    /** \"TypeError\", \"Error\" … */\n    type: string;\n    message: string;\n    /** The raw stack, at most 8 KB. MRRocket parses it into frames. */\n    stack?: string;\n    /** \"onerror\" (uncaught), \"onunhandledrejection\" (a rejected promise nobody caught) or \"manual\" (captureError). */\n    mechanism: \"onerror\" | \"onunhandledrejection\" | \"manual\";\n    handled: boolean;\n    url: string;\n    ts: number;\n    /** What happened just before: pages and clicks, newest last, at most 20. */\n    crumbs?: { ts: number; type: \"navigation\" | \"click\" | \"lifecycle\"; message: string }[];\n    /** Your release (a version or commit), from the provider's `release` prop. */\n    release?: string;\n    distinctId?: string;\n    sessionId?: string;\n}\n\n/**\n * Session recordings of a product, from the config. Recording also needs the visitor's own replay consent\n * (`<CockpitProvider replay>` or `setConsent({ replay: true })`); without it nothing is recorded or buffered.\n */\nexport interface ReplayConfig {\n    /**\n     * Share of sessions uploaded from their start, 0 to 1 (default 0.1). The others keep only the last minute in\n     * memory and upload it when something goes wrong: a JS error, a rage click, a `purchase…` or `checkout…` event.\n     */\n    sampleRate: number;\n}\n\n/**\n * What the SDK may send and store.\n * - \"cookieless\" (default): no cookie, no localStorage. Events go without a visitor id; the server counts visitors\n *   with a hash of key, date, IP and user agent that changes every day.\n * - \"cookies\": a persistent `ck_id` cookie identifies the visitor across visits, `ck_sid` holds the session.\n * - \"off\": nothing is sent and nothing is stored.\n */\nexport type ConsentMode = \"cookieless\" | \"cookies\" | \"off\";\n\n/** Sent once when a signed-in person withdraws analytics consent, and stored as nothing but that fact on their record. */\nexport const CONSENT_OFF_EVENT = \"$consent_off\";\n\n/**\n * What `setConsent` takes: a mode as before, or the parts to change. `replay` is the separate consent for session\n * recordings (default false); it applies only while analytics is not \"off\".\n *\n *     setConsent(\"cookies\");\n *     setConsent({ replay: true });\n *     setConsent({ analytics: \"cookieless\", replay: false });\n */\nexport type ConsentChoice = ConsentMode | { analytics?: ConsentMode; replay?: boolean };\n\n/** The campaign parameters the SDK reads from the landing URL. */\nexport const UTM_KEYS = [\"utm_source\", \"utm_medium\", \"utm_campaign\", \"utm_term\", \"utm_content\"] as const;\nexport type UtmKey = (typeof UTM_KEYS)[number];\n\n/** One event as it goes over the wire to `POST /api/sdk/events`. */\nexport interface CockpitEvent {\n    event: string;\n    /** The visitor. Missing in \"cookieless\" mode until identify(): the server then uses its daily visitor hash. */\n    distinctId?: string;\n    /** Ends after 30 minutes without an event. */\n    sessionId?: string;\n    props?: Record<string, unknown>;\n    /** Milliseconds since the epoch. */\n    ts: number;\n    url?: string;\n    /** `document.referrer` on the first page of a page load, the previous in-app URL after client-side navigation. */\n    referrer?: string;\n    utm_source?: string;\n    utm_medium?: string;\n    utm_campaign?: string;\n    utm_term?: string;\n    utm_content?: string;\n    /** The screen size in CSS pixels (points on a phone). */\n    screen?: { w: number; h: number };\n    /** The app that sent it (React Native only): MRRocket stores it with the event and fills OS and device from it. */\n    app?: AppContext;\n}\n\n/** Where a React Native event comes from. Every field is optional except the platform; nothing identifies the person. */\nexport interface AppContext {\n    /** \"ios\" or \"android\" (React Native's `Platform.OS`). */\n    platform: string;\n    /** The app's version, like \"1.4.0\" (`expo-application`'s `nativeApplicationVersion`). */\n    appVersion?: string;\n    /** The build number, like \"42\". */\n    build?: string;\n    /** The OS version, like \"17.4\". */\n    osVersion?: string;\n    /** The device model, like \"iPhone 15 Pro\" (`expo-device`). */\n    deviceModel?: string;\n    /** \"phone\", \"tablet\", \"desktop\" or \"tv\" when `expo-device` knows it. */\n    deviceType?: string;\n    /** The first preferred locale, like \"de-DE\". */\n    locale?: string;\n}\n\n/** The query parameter that forces variants, for previews in Cockpit: `?ck_preview=pricing-annual:a,home-hero:control`. */\nexport const PREVIEW_PARAM = \"ck_preview\";\n/** Set when Cockpit embeds the page: nothing is tracked, so previews never count as visits. */\nexport const EMBED_PARAM = \"ck_embed\";\n/** The cookie that keeps a visitor in the same variant across visits. Only written in \"cookies\" mode. */\nexport const ID_COOKIE = \"ck_id\";\n/** The cookie that holds the session id in \"cookies\" mode. */\nexport const SESSION_COOKIE = \"ck_sid\";\n/** A session ends after this long without an event. */\nexport const SESSION_TIMEOUT_MS = 30 * 60 * 1000;\n\n/** The UTM parameters from a parameter lookup (`URLSearchParams.get` in a browser). Empty values are left out. */\nexport const utmFrom = (get: (name: string) => string | null | undefined): Partial<Record<UtmKey, string>> => {\n    const out: Partial<Record<UtmKey, string>> = {};\n    for (const key of UTM_KEYS) {\n        const value = get(key)?.trim();\n        if (value) out[key] = value.slice(0, 150);\n    }\n    return out;\n};\n\n/** The UTM parameters of a query string, like `\"?utm_source=x\"`. Empty values are left out. */\nexport const readUtm = (search: string): Partial<Record<UtmKey, string>> => {\n    const params = new URLSearchParams(search);\n    return utmFrom((k) => params.get(k));\n};\n\n/**\n * The query parameters of a URL or query string, without `URLSearchParams` (React Native's is incomplete): `+` is a\n * space, values are percent-decoded, the first of a repeated name wins.\n */\nexport const parseQuery = (url: string): Record<string, string> => {\n    const out: Record<string, string> = {};\n    const q = url.split(\"#\")[0];\n    const at = q.indexOf(\"?\");\n    if (at < 0) return out;\n    const dec = (s: string) => {\n        try {\n            return decodeURIComponent(s.replace(/\\+/g, \" \"));\n        } catch {\n            return s;\n        }\n    };\n    for (const pair of q.slice(at + 1).split(\"&\")) {\n        if (!pair) continue;\n        const eq = pair.indexOf(\"=\");\n        const k = dec(eq < 0 ? pair : pair.slice(0, eq));\n        if (k && !(k in out)) out[k] = eq < 0 ? \"\" : dec(pair.slice(eq + 1));\n    }\n    return out;\n};\n\n/** FNV-1a, 32 bit, mapped to [0, 1). Stable across server and browser. */\nexport const hashUnit = (input: string) => {\n    let h = 0x811c9dc5;\n    for (let i = 0; i < input.length; i++) {\n        h ^= input.charCodeAt(i);\n        h = Math.imul(h, 0x01000193);\n    }\n    return (h >>> 0) / 4294967296;\n};\n\n/**\n * FNV-1a with murmur3's finalizer, mapped to [0, 1): ids that differ only at the end (\"user-1\", \"user-2\") still spread\n * evenly, so a 30 % rollout reaches about 30 % of people. Flags only; experiments keep `hashUnit` so nobody switches.\n */\nexport const flagUnit = (input: string) => {\n    let h = 0x811c9dc5;\n    for (let i = 0; i < input.length; i++) {\n        h ^= input.charCodeAt(i);\n        h = Math.imul(h, 0x01000193);\n    }\n    h ^= h >>> 16;\n    h = Math.imul(h, 0x85ebca6b);\n    h ^= h >>> 13;\n    h = Math.imul(h, 0xc2b2ae35);\n    h ^= h >>> 16;\n    return (h >>> 0) / 4294967296;\n};\n\n/** The variant a visitor sees: a shipped winner, control while the experiment does not run, else a stable bucket by visitor. */\nexport const assign = (experiment: ExperimentConfig, distinctId: string): VariantId => {\n    const control = experiment.variants[0]?.id ?? \"control\";\n    if (experiment.winner) return experiment.winner;\n    if (experiment.status !== \"running\") return control;\n    const u = hashUnit(`${experiment.key}:${distinctId}`);\n    let acc = 0;\n    for (const v of experiment.variants) {\n        acc += v.weight;\n        if (u < acc) return v.id;\n    }\n    return experiment.variants[experiment.variants.length - 1]?.id ?? control;\n};\n\n/** `\"a:b,c:d\"` → `{ a: \"b\", c: \"d\" }`. Ignores anything malformed. */\nexport const parsePreview = (value: string | string[] | null | undefined): Record<string, VariantId> => {\n    const raw = Array.isArray(value) ? value[0] : value;\n    if (!raw) return {};\n    const out: Record<string, VariantId> = {};\n    for (const pair of raw.split(\",\")) {\n        const [key, variant] = pair.split(\":\");\n        if (key && variant) out[key.trim()] = variant.trim();\n    }\n    return out;\n};\n\n/** A link that shows one variant of a page, for example in Cockpit's preview frames. */\nexport const previewHref = (url: string, forced: Record<string, VariantId>, embed = true) => {\n    const [path, query = \"\"] = url.split(\"?\");\n    const params = new URLSearchParams(query);\n    const value = Object.entries(forced)\n        .map(([k, v]) => `${k}:${v}`)\n        .join(\",\");\n    if (value) params.set(PREVIEW_PARAM, value);\n    if (embed) params.set(EMBED_PARAM, \"1\");\n    return `${path}?${params.toString()}`;\n};\n\n/** The variant for one experiment, from a forced preview first, then the config. Unknown experiments get control. */\n/** The experiments whose variants change the text `id`: showing that text is an exposure to them. */\nexport const experimentsOfText = (config: CockpitConfig | null, id: string) =>\n    (config?.experiments ?? []).filter((e) => e.variants.some((v) => v.changes && id in v.changes)).map((e) => e.key);\n\nexport const resolveVariant = (key: string, config: CockpitConfig | null, distinctId: string, preview: Record<string, VariantId>): VariantId => {\n    if (preview[key]) return preview[key];\n    const experiment = config?.experiments.find((e) => e.key === key);\n    return experiment ? assign(experiment, distinctId) : \"control\";\n};\n\n/**\n * Every text change that applies to this visitor: the published texts first, then each experiment's in config order.\n * Control keeps the published (or the page's own) words, so only a non-control variant (assigned, forced in a preview,\n * or a shipped winner) changes them further.\n */\nexport const textChanges = (config: CockpitConfig | null, distinctId: string, preview: Record<string, VariantId>) => {\n    const out: Record<string, string> = { ...(config?.texts ?? {}) };\n    for (const experiment of config?.experiments ?? []) {\n        const id = resolveVariant(experiment.key, config, distinctId, preview);\n        if (id === (experiment.variants[0]?.id ?? \"control\")) continue;\n        Object.assign(out, experiment.variants.find((v) => v.id === id)?.changes ?? {});\n    }\n    return out;\n};\n\n/**\n * The query parameter a redirect test adds to the variant's address (`ck_x=<test>:<variant>`): the page there records\n * the exposure and takes it out of the address bar. It also keeps that page from redirecting again.\n */\nexport const EXPOSURE_PARAM = \"ck_x\";\n\n/** What `redirectFor` decided: go to `to`, and/or the redirect test this page belongs to and the visitor's variant. */\nexport interface RedirectDecision {\n    /** Where to send the visitor now. Missing for control, which stays on the page. */\n    to?: string;\n    /** The redirect test, while it runs: record `$exposure` for it (on this page for control, on `to` otherwise). */\n    experiment?: string;\n    variant?: VariantId;\n}\n\nconst pathOf = (p: string) => p.replace(/\\/+$/, \"\") || \"/\";\n\n/**\n * Where a page sends the visitor, before it shows: a page redirect set in MRRocket first, else a redirect test that runs\n * on this path (the visitor's variant, by the same stable assignment as every test). Null when nothing applies.\n *\n * - The new address keeps the page's query (UTM parameters) and its hash; a running test adds `ck_x=<test>:<variant>`,\n *   so the page it lands on records the exposure (and never redirects again).\n * - `distinctId` null (no stable id, as on a server without the `ck_id` cookie): running tests are left to the browser,\n *   page redirects and shipped winners still apply.\n * - A redirect to the page itself is ignored.\n */\nexport const redirectFor = (config: CockpitConfig | null, href: string, distinctId: string | null, preview: Record<string, VariantId> = {}): RedirectDecision | null => {\n    if (!config) return null;\n    let here: URL;\n    try {\n        here = new URL(href);\n    } catch {\n        return null;\n    }\n    if (here.searchParams.has(EXPOSURE_PARAM)) return null;\n    const path = pathOf(here.pathname);\n    const go = (to: string, mark?: string) => {\n        let t: URL;\n        try {\n            t = new URL(to, here);\n        } catch {\n            return undefined;\n        }\n        if (!/^https?:$/.test(t.protocol) || (t.origin === here.origin && pathOf(t.pathname) === path)) return undefined;\n        here.searchParams.forEach((v, k) => {\n            if (!t.searchParams.has(k)) t.searchParams.set(k, v);\n        });\n        if (mark) t.searchParams.set(EXPOSURE_PARAM, mark);\n        if (!t.hash) t.hash = here.hash;\n        return t.href;\n    };\n    for (const r of config.redirects ?? []) {\n        const to = r.from && pathOf(r.from) === path ? go(r.to) : undefined;\n        if (to) return { to };\n    }\n    for (const e of config.experiments) {\n        if (!e.path || pathOf(e.path) !== path) continue;\n        const running = e.status === \"running\" && !e.winner;\n        if (running && distinctId === null && !preview[e.key]) return null;\n        const variant = resolveVariant(e.key, config, distinctId ?? \"\", preview);\n        const url = e.variants.find((v) => v.id === variant)?.url;\n        const to = url ? go(url, running ? `${e.key}:${variant}` : undefined) : undefined;\n        return running ? { to, experiment: e.key, variant } : to ? { to } : null;\n    }\n    return null;\n};\n\n/** The test and variant a redirect test's `ck_x` names, when the config has them; null otherwise. */\nexport const exposureFrom = (config: CockpitConfig | null, value: string | null | undefined) => {\n    const [key, variant] = (value ?? \"\").split(\":\");\n    const e = config?.experiments.find((x) => x.key === key);\n    return e && e.variants.some((v) => v.id === variant) ? { experiment: key, variant } : null;\n};\n\n/**\n * The MRRocket API host from `NEXT_PUBLIC_MRROCKET_HOST`. Written as a literal property access on purpose: Next.js\n * inlines `process.env.NEXT_PUBLIC_*` at build time, in the browser bundle and in the server bundle (also on\n * Cloudflare Workers), and only replaces the literal form. Without a bundler (or a `process`) it is undefined.\n */\nexport const envHost = (): string | undefined => {\n    try {\n        return process.env.NEXT_PUBLIC_MRROCKET_HOST || undefined;\n    } catch {\n        return undefined;\n    }\n};\n\n/** The public key from `NEXT_PUBLIC_MRROCKET_KEY`, the default for the `apiKey` prop. Same literal-access rule as `envHost`. */\nexport const envKey = (): string | undefined => {\n    try {\n        return process.env.NEXT_PUBLIC_MRROCKET_KEY || undefined;\n    } catch {\n        return undefined;\n    }\n};\n\n/**\n * Where the API lives: the `host` prop, else `NEXT_PUBLIC_MRROCKET_HOST`, else \"\" (the page's own origin, which is how\n * MRRocket's own demo pages call it). Without a trailing slash.\n */\nexport const resolveHost = (host?: string) => (host ?? envHost() ?? \"\").trim().replace(/\\/+$/, \"\");\n\n/** A random visitor id. */\nexport const newDistinctId = () =>\n    typeof crypto !== \"undefined\" && \"randomUUID\" in crypto ? crypto.randomUUID() : `ck_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { type ChangelogEntry, type ChatMessage, type ChatSummary, type ChatThread, type CockpitProviderProps, type CockpitUser, type FeedbackBoardInfo, type FeedbackBoardProps, type FeedbackComment, type FeedbackList, type FeedbackPost, type FeedbackRoadmap, type FeedbackWidgetProps, type MessengerProps, type PostStatus, type SurveyAnswer, type SurveyDefinition, type SurveyQuestion, type SurveyQuestionKind, CockpitProvider, Experiment, FeedbackBoard, FeedbackWidget, Messenger, Survey, Text, WIDGET_CSS, createApi, useCancelFlow, useCockpit, useFeedback, useFlag, useFlagVariant, useMessenger, useOnboarding, usePaywall, usePush, useStyles, useVariant, } from "./browser.js";
+export { type ChangelogEntry, type ChatMessage, type ChatSummary, type ChatThread, type CockpitProviderProps, type CockpitUser, type FeedbackBoardInfo, type FeedbackBoardProps, type FeedbackComment, type FeedbackList, type FeedbackPost, type FeedbackRoadmap, type FeedbackWidgetProps, type MessengerProps, type PostStatus, type SurveyAnswer, type SurveyDefinition, type SurveyQuestion, type SurveyQuestionKind, CockpitProvider, Experiment, FeedbackBoard, FeedbackWidget, Messenger, Survey, Text, WIDGET_CSS, createApi, useCancelFlow, useCockpit, useFeedback, useFlag, useFlagVariant, useMessenger, useOnboarding, useOnboardingReport, usePaywall, usePush, useStyles, useVariant, } from "./browser.js";
 export type { PushResult, PushStatus, WebPushOptions } from "./push-web.js";
 /** 0.21.0: the language of the SDK's words, for an app with its own language switch. */
 export { currentLocale, setLocale } from "./i18n.js";
@@ -7,6 +7,7 @@ export type { IdentifyOptions } from "./identity.js";
 export { type CockpitConfig, type CockpitEvent, type ConsentChoice, type ConsentMode, type ReplayConfig, type ErrorReport, type ExperimentConfig, type FlagCondition, type FlagConditionSet, type FlagConfig, type FlagPerson, type RedirectConfig, type RedirectDecision, type VariantConfig, type VariantId, EMBED_PARAM, EXPOSURE_PARAM, SDK_VERSION, ID_COOKIE, PREVIEW_PARAM, SESSION_COOKIE, assign, evaluateFlag, parsePreview, previewHref, redirectFor, } from "./core.js";
 export { type CancelFlowConfig, type CancelFlowOptions, type CancelFlowResult, type CancelOffer, type InAppMessage, type OnboardingFlow, type OnboardingStep, type FlowMedia, type TourPlacement, type TaskOpens, type FlowIcon, type FinishAnimation, type OnboardingQuestion, type OnboardingItemState, videoEmbed, } from "./flows.js";
 export type { UseOnboarding } from "./onboarding-state.js";
+export type { OnboardingReport, OnboardingReportOptions, OnboardingReportType } from "./onboarding-report.js";
 export { FLOW_ICONS, FLOW_ICON_NAMES, type BuiltinIcon } from "./icons.js";
 export type { FlowsTheme } from "./flows-ui.js";
 export { PAYWALL_EVENT, type PaywallConfig, type PaywallOptions, type PaywallPage, type PaywallPlan, type PaywallResult } from "./paywall.js";

package/dist/index.js

@@ -16,6 +16,7 @@ import {
   useFlagVariant,
   useMessenger,
   useOnboarding,
+  useOnboardingReport,
   usePaywall,
   usePush,
   useStyles,
@@ -85,6 +86,7 @@ export {
   useFlagVariant,
   useMessenger,
   useOnboarding,
+  useOnboardingReport,
   usePaywall,
   usePush,
   useStyles,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n    type ChangelogEntry,\n    type ChatMessage,\n    type ChatSummary,\n    type ChatThread,\n    type CockpitProviderProps,\n    type CockpitUser,\n    type FeedbackBoardInfo,\n    type FeedbackBoardProps,\n    type FeedbackComment,\n    type FeedbackList,\n    type FeedbackPost,\n    type FeedbackRoadmap,\n    type FeedbackWidgetProps,\n    type MessengerProps,\n    type PostStatus,\n    type SurveyAnswer,\n    type SurveyDefinition,\n    type SurveyQuestion,\n    type SurveyQuestionKind,\n    CockpitProvider,\n    Experiment,\n    FeedbackBoard,\n    FeedbackWidget,\n    Messenger,\n    Survey,\n    Text,\n    WIDGET_CSS,\n    createApi,\n    useCancelFlow,\n    useCockpit,\n    useFeedback,\n    useFlag,\n    useFlagVariant,\n    useMessenger,\n    useOnboarding,\n    usePaywall,\n    usePush,\n    useStyles,\n    useVariant,\n} from \"./browser\";\nexport type { PushResult, PushStatus, WebPushOptions } from \"./push-web\";\n/** 0.21.0: the language of the SDK's words, for an app with its own language switch. */\nexport { currentLocale, setLocale } from \"./i18n\";\n/** `identify(id, props, { hash })` (0.16.0); the hash comes from `userHash()` in `@mrrocket/sdk/next/server`. */\nexport type { IdentifyOptions } from \"./identity\";\nexport {\n    type CockpitConfig,\n    type CockpitEvent,\n    type ConsentChoice,\n    type ConsentMode,\n    type ReplayConfig,\n    type ErrorReport,\n    type ExperimentConfig,\n    type FlagCondition,\n    type FlagConditionSet,\n    type FlagConfig,\n    type FlagPerson,\n    type RedirectConfig,\n    type RedirectDecision,\n    type VariantConfig,\n    type VariantId,\n    EMBED_PARAM,\n    EXPOSURE_PARAM,\n    SDK_VERSION,\n    ID_COOKIE,\n    PREVIEW_PARAM,\n    SESSION_COOKIE,\n    assign,\n    evaluateFlag,\n    parsePreview,\n    previewHref,\n    redirectFor,\n} from \"./core\";\nexport {\n    type CancelFlowConfig,\n    type CancelFlowOptions,\n    type CancelFlowResult,\n    type CancelOffer,\n    type InAppMessage,\n    type OnboardingFlow,\n    type OnboardingStep,\n    type FlowMedia,\n    type TourPlacement,\n    type TaskOpens,\n    type FlowIcon,\n    type FinishAnimation,\n    type OnboardingQuestion,\n    type OnboardingItemState,\n    videoEmbed,\n} from \"./flows\";\nexport type { UseOnboarding } from \"./onboarding-state\";\nexport { FLOW_ICONS, FLOW_ICON_NAMES, type BuiltinIcon } from \"./icons\";\nexport type { FlowsTheme } from \"./flows-ui\";\nexport { PAYWALL_EVENT, type PaywallConfig, type PaywallOptions, type PaywallPage, type PaywallPlan, type PaywallResult } from \"./paywall\";\nexport {\n    type AttributionMode,\n    type CheckoutReferral,\n    type Referral,\n    REFERRAL_COOKIE,\n    getReferral,\n    readReferralCookie,\n    referralForCheckout,\n    referralLink,\n} from \"./referral\";\n"],"mappings":";AAAA;AAAA,EAoBI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AAGP,SAAS,eAAe,iBAAiB;AAGzC;AAAA,EAgBI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP;AAAA,EAeI;AAAA,OACG;AAEP,SAAS,YAAY,uBAAyC;AAE9D,SAAS,qBAAsH;AAC/H;AAAA,EAII;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n    type ChangelogEntry,\n    type ChatMessage,\n    type ChatSummary,\n    type ChatThread,\n    type CockpitProviderProps,\n    type CockpitUser,\n    type FeedbackBoardInfo,\n    type FeedbackBoardProps,\n    type FeedbackComment,\n    type FeedbackList,\n    type FeedbackPost,\n    type FeedbackRoadmap,\n    type FeedbackWidgetProps,\n    type MessengerProps,\n    type PostStatus,\n    type SurveyAnswer,\n    type SurveyDefinition,\n    type SurveyQuestion,\n    type SurveyQuestionKind,\n    CockpitProvider,\n    Experiment,\n    FeedbackBoard,\n    FeedbackWidget,\n    Messenger,\n    Survey,\n    Text,\n    WIDGET_CSS,\n    createApi,\n    useCancelFlow,\n    useCockpit,\n    useFeedback,\n    useFlag,\n    useFlagVariant,\n    useMessenger,\n    useOnboarding,\n    useOnboardingReport,\n    usePaywall,\n    usePush,\n    useStyles,\n    useVariant,\n} from \"./browser\";\nexport type { PushResult, PushStatus, WebPushOptions } from \"./push-web\";\n/** 0.21.0: the language of the SDK's words, for an app with its own language switch. */\nexport { currentLocale, setLocale } from \"./i18n\";\n/** `identify(id, props, { hash })` (0.16.0); the hash comes from `userHash()` in `@mrrocket/sdk/next/server`. */\nexport type { IdentifyOptions } from \"./identity\";\nexport {\n    type CockpitConfig,\n    type CockpitEvent,\n    type ConsentChoice,\n    type ConsentMode,\n    type ReplayConfig,\n    type ErrorReport,\n    type ExperimentConfig,\n    type FlagCondition,\n    type FlagConditionSet,\n    type FlagConfig,\n    type FlagPerson,\n    type RedirectConfig,\n    type RedirectDecision,\n    type VariantConfig,\n    type VariantId,\n    EMBED_PARAM,\n    EXPOSURE_PARAM,\n    SDK_VERSION,\n    ID_COOKIE,\n    PREVIEW_PARAM,\n    SESSION_COOKIE,\n    assign,\n    evaluateFlag,\n    parsePreview,\n    previewHref,\n    redirectFor,\n} from \"./core\";\nexport {\n    type CancelFlowConfig,\n    type CancelFlowOptions,\n    type CancelFlowResult,\n    type CancelOffer,\n    type InAppMessage,\n    type OnboardingFlow,\n    type OnboardingStep,\n    type FlowMedia,\n    type TourPlacement,\n    type TaskOpens,\n    type FlowIcon,\n    type FinishAnimation,\n    type OnboardingQuestion,\n    type OnboardingItemState,\n    videoEmbed,\n} from \"./flows\";\nexport type { UseOnboarding } from \"./onboarding-state\";\nexport type { OnboardingReport, OnboardingReportOptions, OnboardingReportType } from \"./onboarding-report\";\nexport { FLOW_ICONS, FLOW_ICON_NAMES, type BuiltinIcon } from \"./icons\";\nexport type { FlowsTheme } from \"./flows-ui\";\nexport { PAYWALL_EVENT, type PaywallConfig, type PaywallOptions, type PaywallPage, type PaywallPlan, type PaywallResult } from \"./paywall\";\nexport {\n    type AttributionMode,\n    type CheckoutReferral,\n    type Referral,\n    REFERRAL_COOKIE,\n    getReferral,\n    readReferralCookie,\n    referralForCheckout,\n    referralLink,\n} from \"./referral\";\n"],"mappings":";AAAA;AAAA,EAoBI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AAGP,SAAS,eAAe,iBAAiB;AAGzC;AAAA,EAgBI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP;AAAA,EAeI;AAAA,OACG;AAGP,SAAS,YAAY,uBAAyC;AAE9D,SAAS,qBAAsH;AAC/H;AAAA,EAII;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;","names":[]}

package/dist/messenger-ui.d.ts

@@ -87,6 +87,8 @@ export interface MessengerHandle {
     }): void;
     close(): void;
     toggle(): void;
+    /** The visitor changed (identify, reset, a signature that came later): reads for them at once. */
+    refresh(): void;
     /** Removes the launcher and the panel from the page. */
     destroy(): void;
 }

package/dist/messenger-ui.js

@@ -6,12 +6,14 @@ import {
   CHAT_FILE_TYPES,
   createApi,
   inkOn,
-  replyLine
+  replyLine,
+  stillThere
 } from "./api-client.js";
 import { currentLocale, onWords, t, tf, wordsLang, wordsVersion } from "./i18n.js";
 import { injectStyles } from "./styles-css.js";
 var UPDATES_SHOWN = 20;
 var POLL_OPEN_MS = 4e3;
+var READ_PATIENCE_MS = 5e3;
 var POLL_WAITING_MS = 8e3;
 var POLL_IDLE_MS = 3e4;
 var POLL_QUIET_MS = 6e4;
@@ -188,6 +190,23 @@ var writeCachedLook = (apiKey, look) => {
   } catch {
   }
 };
+var CHATS_KEY = "ckw_msgr_chats:";
+var PRODUCT_KEY = "ckw_msgr_product:";
+var KEPT = 20;
+var kept = (key) => {
+  try {
+    return JSON.parse(window.localStorage.getItem(key) ?? "null");
+  } catch {
+    return null;
+  }
+};
+var keep = (key, value) => {
+  try {
+    if (value) window.localStorage.setItem(key, JSON.stringify(value));
+    else window.localStorage.removeItem(key);
+  } catch {
+  }
+};
 var mountMessenger = (o) => {
   let real = null;
   let shown = "";
@@ -233,6 +252,7 @@ var mountMessenger = (o) => {
     open: (v) => later((h) => h.open(v)),
     close: () => real?.close(),
     toggle: () => later((h) => h.toggle()),
+    refresh: () => real?.refresh(),
     destroy: () => {
       gone = true;
       offWords();
@@ -252,7 +272,7 @@ var build = (o) => {
   const label = o.label ?? "";
   const reply = replyLine(o.replyTime);
   const initial = (title.trim()[0] ?? "?").toUpperCase();
-  const whoLabel = { visitor: t("You"), team: t("Team"), ai: o.agentName?.trim() || t("AI agent"), auto: t("Team") };
+  const whoLabel = { visitor: t("You"), team: t("Team"), ai: o.agentName?.trim() ? `${o.agentName.trim()} \xB7 ${t("AI agent")}` : t("AI agent"), auto: t("Team") };
   const launcherOn = o.launcher ?? true;
   const helpOn = o.help ?? true;
   const updatesOn = o.updates ?? true;
@@ -302,10 +322,40 @@ var build = (o) => {
   let query = "";
   let rated = /* @__PURE__ */ new Set();
   let hasArticles = null;
+  let homeArticles = [];
+  let misses = 0;
   let updates = null;
+  let hasUpdates = false;
   let updatesNode = null;
   let collection = null;
   let wide = false;
+  const remembers = !o.client && !!o.apiKey;
+  const chatsKey = CHATS_KEY + o.apiKey;
+  const productKey = PRODUCT_KEY + o.apiKey;
+  let visitor = o.distinctId();
+  let person = o.user()?.id;
+  const recall = () => {
+    const m = remembers ? kept(chatsKey) : null;
+    chats = m?.who === visitor && Array.isArray(m.chats) ? m.chats : [];
+  };
+  recall();
+  if (remembers) {
+    const m = kept(productKey);
+    if (m?.articles?.length) {
+      homeArticles = m.articles;
+      articles = m.articles;
+      hasArticles = true;
+    }
+    hasUpdates = !!m?.updates;
+  }
+  const rememberChats = (who) => {
+    if (!remembers || o.distinctId() !== who) return;
+    if (chats.length) keep(chatsKey, { who, chats: chats.slice(0, KEPT) });
+    else if (kept(chatsKey)?.who === who) keep(chatsKey, null);
+  };
+  const rememberProduct = () => {
+    if (remembers) keep(productKey, homeArticles.length || hasUpdates ? { articles: homeArticles.slice(0, KEPT), updates: hasUpdates } : null);
+  };
   const isAnswer = (m) => m.from === "team" || m.from === "ai";
   const watching = () => open && view === "messages" && document.visibilityState !== "hidden";
   const shownChat = () => listing || draft !== null ? null : chatId ?? thread?.conversation?.id ?? null;
@@ -342,6 +392,7 @@ var build = (o) => {
       if (c.id !== read?.id) learn(c.id, c.last && isAnswer(c.last) ? [c.last] : [], c.last?.at, c.status === "solved" && i > 0);
     });
     if (read) learn(read.id, t2.messages.filter(isAnswer), last?.at, read.status === "solved" && chats[0]?.id !== read.id);
+    unseen = unseen.filter(stillThere(t2, chats));
     if (chatId === null || read?.id === chatId) thread = t2;
     if (watching()) markSeen();
   };
@@ -351,8 +402,8 @@ var build = (o) => {
     unseen = unseen.filter((m) => m.chat !== chat);
     const at = known.get(chat);
     if (!at || seen.chats[chat] === at) return;
-    const kept = Object.fromEntries(Object.entries(seen.chats).filter(([c]) => chats.some((x) => x.id === c)));
-    seen = { ...seen, chats: { ...kept, [chat]: at } };
+    const kept2 = Object.fromEntries(Object.entries(seen.chats).filter(([c]) => chats.some((x) => x.id === c)));
+    seen = { ...seen, chats: { ...kept2, [chat]: at } };
     writeSeen(seen.chats);
   };
   const enterChat = (id, d, list2 = false) => {
@@ -555,7 +606,7 @@ var build = (o) => {
     else if (view === "help") mid.replaceChildren(el("b", {}, t("Help")));
     else if (view === "updates") mid.replaceChildren(el("b", {}, t("Updates")));
     else mid.replaceChildren();
-    const items = [homeTab, chatTab, ...helpOn && hasArticles !== false ? [helpTab] : [], ...updatesOn && updates?.length ? [updatesTab] : []];
+    const items = [homeTab, chatTab, ...helpOn && hasArticles ? [helpTab] : [], ...updatesOn && (updates ? updates.length : hasUpdates) ? [updatesTab] : []];
     if (tabs.childNodes.length !== items.length || items.some((t2, i) => tabs.childNodes[i] !== t2)) tabs.replaceChildren(...items);
     tabs.toggleAttribute("data-four", items.length > 3);
     homeTab.setAttribute("aria-current", view === "home" ? "page" : "false");
@@ -827,7 +878,11 @@ var build = (o) => {
       const r = await api().articles(q || void 0);
       if (q !== query.trim()) return;
       articles = r.articles;
-      if (!q) hasArticles = r.articles.length > 0;
+      if (!q) {
+        homeArticles = r.articles;
+        hasArticles = r.articles.length > 0;
+        rememberProduct();
+      }
     } catch {
       articles = articles ?? [];
     } finally {
@@ -838,6 +893,8 @@ var build = (o) => {
   const loadUpdates = async () => {
     try {
       updates = (await api().changelog()).entries.slice(0, UPDATES_SHOWN);
+      hasUpdates = updates.length > 0;
+      rememberProduct();
     } catch {
       updates = [];
     }
@@ -862,6 +919,25 @@ var build = (o) => {
     go("messages");
     if (canSend()) submit();
   });
+  const shapes = (rows, card = false) => el(
+    "div",
+    { class: "ckw-msgr-shapes", "aria-hidden": "true" },
+    ...Array.from(
+      { length: rows },
+      () => el(
+        "div",
+        { class: card ? "ckw-msgr-card ckw-msgr-recent" : "ckw-msgr-shape" },
+        el("span", { class: "ckw-msgr-recent-row" }, card ? el("span", { class: "ckw-msgr-av ckw-msgr-av-sm ckw-msgr-sk" }) : null, el("span", { class: "ckw-msgr-card-main" }, el("span", { class: "ckw-msgr-sk" }), el("span", { class: "ckw-msgr-sk" })))
+      )
+    )
+  );
+  const still = (node) => {
+    if (node.isConnected) node.setAttribute("data-still", "");
+    return node;
+  };
+  const chatShape = shapes(1, true);
+  const listShape = shapes(3);
+  let homeSeen = null;
   const chatRow = (c) => {
     const m = c.last;
     const n = unseenIn(c.id);
@@ -911,9 +987,16 @@ var build = (o) => {
       el("span", { class: "ckw-msgr-hello-sub" }, rest)
     );
     const parts = [hero, askForm];
+    const shown = /* @__PURE__ */ new Set();
+    const arriving = (node, key) => {
+      shown.add(key);
+      if (homeSeen && !homeSeen.has(key)) node.setAttribute("data-arrive", "");
+      return node;
+    };
     const running = chats.filter((c) => c.status !== "solved");
     const rows = (running.length ? running : chats).slice(0, 2);
-    parts.push(...rows.map(chatRow));
+    parts.push(...rows.map((c) => arriving(chatRow(c), c.id)));
+    if (!rows.length && !loaded && misses < 3 && o.user()?.id) parts.push(still(chatShape));
     if (chats.length > rows.length) {
       const all = el("button", { type: "button", class: "ckw-msgr-all" }, tf("All conversations ({n})", { n: chats.length }), icon(I.next, 14));
       all.addEventListener("click", () => {
@@ -922,13 +1005,9 @@ var build = (o) => {
       });
       parts.push(all);
     }
-    if (helpOn && hasArticles !== false) {
-      const helpCard = el("div", { class: "ckw-msgr-card ckw-msgr-card-col" });
-      const top = (articles ?? []).slice(0, 3);
-      if (top.length) helpCard.append(...top.map(articleRow));
-      else if (articles === null) helpCard.append(el("div", { class: "ckw-skel ckw-msgr-skel" }));
-      parts.push(helpCard);
-    }
+    const top = helpOn ? homeArticles.slice(0, 3) : [];
+    if (top.length) parts.push(arriving(el("div", { class: "ckw-msgr-card ckw-msgr-card-col" }, ...top.map(articleRow)), "help"));
+    homeSeen = shown;
     body.replaceChildren(...parts);
   };
   const drawHelp = () => {
@@ -940,7 +1019,7 @@ var build = (o) => {
     const inside = !q && collection !== null ? groups.get(collection) ?? [] : null;
     const heading = q ? t("Search results") : inside ? collection ?? "" : t("Most read articles");
     const parts = [el("h2", { class: "ckw-msgr-help-h" }, heading), helpSearch];
-    if (articles === null) parts.push(el("div", { class: "ckw-skel" }));
+    if (articles === null) parts.push(still(listShape));
     else if (!all.length) {
       const ask = el("button", { type: "button", class: "ckw-btn ckw-btn-primary" }, t("Send us a message"));
       ask.addEventListener("click", askAnew);
@@ -975,7 +1054,7 @@ var build = (o) => {
     }
   };
   const drawUpdates = () => {
-    updatesNode ??= !updates ? el("div", { class: "ckw-skel" }) : !updates.length ? el("div", { class: "ckw-msgr-empty" }, el("p", {}, t("No updates yet."))) : el(
+    updatesNode ??= !updates ? shapes(3) : !updates.length ? el("div", { class: "ckw-msgr-empty" }, el("p", {}, t("No updates yet."))) : el(
       "div",
       { class: "ckw-msgr-updates" },
       ...updates.map((e) => el("article", { class: "ckw-msgr-update" }, el("p", { class: "ckw-msgr-doc-c" }, timeAgo(e.publishedAt)), el("h2", { class: "ckw-msgr-update-t" }, e.title), e.body ? el("p", { class: "ckw-msgr-update-b" }, e.body) : null))
@@ -985,7 +1064,7 @@ var build = (o) => {
   let articleShown = null;
   const drawArticle = (id) => {
     if (articleShown?.id === id) return body.replaceChildren(articleShown.node);
-    const node = el("article", { class: "ckw-msgr-doc" }, el("div", { class: "ckw-skel" }));
+    const node = el("article", { class: "ckw-msgr-doc" }, shapes(4));
     articleShown = { id, node };
     body.replaceChildren(node);
     api().article(id).then((a) => {
@@ -1091,27 +1170,59 @@ var build = (o) => {
   const tick = async () => {
     if (ctrl) return;
     const mine = ctrl = new AbortController();
+    const asked = o.distinctId();
+    let late = false;
+    const patience = setTimeout(() => {
+      late = true;
+      mine.abort();
+    }, Math.min(READ_PATIENCE_MS * 2 ** misses, POLL_IDLE_MS));
+    let again;
     try {
       take(await api().chat(mine.signal, chatId ?? void 0));
       error = "";
       refused = false;
+      misses = 0;
+      rememberChats(asked);
     } catch (e) {
-      if (e.name === "AbortError") return;
+      if (e.name === "AbortError" && !late) return;
       const status = e.status;
       refused = status === 401 || status === 403;
       if (status === 404 && chatId) enterMessages();
-      else if (open && view === "messages") error = sayable(e);
+      else if (open && view === "messages" && !late) error = sayable(e);
+      if (late || status === void 0 || status >= 500) {
+        misses += 1;
+        again = late ? 0 : Math.min(1e3 * 2 ** (misses - 1), POLL_IDLE_MS);
+      }
     } finally {
+      clearTimeout(patience);
       if (ctrl === mine) ctrl = null;
     }
-    if (!loaded) {
+    if (!loaded && again === void 0) {
       listCount = -1;
       if (view === "messages" && chatId === null && draft === null && !text.value.trim() && !outbox.length && !picked.length) enterMessages();
+      loaded = true;
     }
-    loaded = true;
     draw();
     drawFab();
-    schedule();
+    schedule(open && document.visibilityState !== "hidden" ? again : void 0);
+  };
+  const refresh = () => {
+    const who = o.distinctId();
+    if (who === visitor && !refused) return;
+    if (who !== visitor) {
+      if (person && !o.user()?.id && remembers) keep(chatsKey, null);
+      visitor = who;
+      ctrl?.abort();
+      ctrl = null;
+      unseen = [];
+      loaded = false;
+      misses = 0;
+      recall();
+    }
+    person = o.user()?.id;
+    draw();
+    drawFab();
+    schedule(0);
   };
   function schedule(now) {
     clearTimeout(poll);
@@ -1239,16 +1350,17 @@ var build = (o) => {
     addFiles([...e.dataTransfer?.files ?? []]);
   });
   email.addEventListener("input", () => draw());
-  function show(v = "home", still = false) {
+  function show(v = "home", still2 = false) {
     const was = open;
     open = true;
     view = v === "help" && !helpOn || v === "updates" && !updatesOn ? "home" : v;
     drawn = -1;
     previewGone = true;
-    pop.toggleAttribute("data-still", still);
+    homeSeen = null;
+    pop.toggleAttribute("data-still", still2);
     enter(pop);
     if (was) replay(body, "ckw-msgr-enter");
-    if (articles === null || view === "help" && query) void loadArticles();
+    if (articles === null || hasArticles === null || view === "help" && query) void loadArticles();
     draw();
     drawFab();
     if (view === "messages") {
@@ -1293,6 +1405,7 @@ var build = (o) => {
     },
     close,
     toggle: () => open ? close() : show(),
+    refresh,
     isOpen: () => open,
     onClose: (fn) => {
       afterClose = fn;