tempest-react-sdk 0.78.0 → 0.80.0

package/dist/telemetry/app-error-reporter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-error-reporter.cjs","names":[],"sources":["../../src/telemetry/app-error-reporter.ts"],"sourcesContent":["import { ownerFingerprint } from \"@/utils/owner-fingerprint\";\nimport { createAppErrorQueue } from \"./app-error-queue\";\nimport type { AppErrorQueueEntry, AppErrorQueueStorage, AppErrorStamp } from \"./app-error-queue\";\nimport { fitAppErrorReport } from \"./app-error-schema\";\nimport type { AppErrorDeviceSchema } from \"./app-error-schema\";\nimport { readToken, sendOne } from \"./app-error-transport\";\nimport { describeAppError } from \"./describe-app-error\";\nimport { isDevBuild } from \"../utils/dev-mode\";\n\n/** Options for {@link createAppErrorReporter}. */\nexport interface CreateAppErrorReporterOptions {\n    /** Full URL of the backend route, e.g. `${API_URL}/api/app-errors`. */\n    endpoint: string;\n    /**\n     * Current access token, if any. Optional on purpose: the route is public,\n     * and an error raised before login — or with a stale session — still has\n     * to get through. A token that throws or resolves empty sends anonymously.\n     */\n    getToken?: () => string | null | undefined | Promise<string | null | undefined>;\n    /**\n     * Who is signed in right now — a stable, non-secret id such as the user id.\n     * Read **when the error is reported**, and stored in the queue only as a\n     * one-way fingerprint (`entry.owner`). A non-string (an `async` getter\n     * from untyped JS, an object) or a getter that throws reads as nobody.\n     *\n     * It never grants the bearer. The bearer goes out only when the token at\n     * send time is the very token that was in force at report time (its\n     * fingerprint is `entry.session`): the principal and the token come from\n     * two sources, and a principal store that lags behind a login would\n     * otherwise send A's report with B's token. The principal only tells\n     * {@link CreateAppErrorReporterOptions.foreignReports} `\"drop\"` whose\n     * report is whose.\n     */\n    getPrincipal?: () => string | number | null | undefined;\n    /**\n     * What to do with a queued report that cannot go out with the current\n     * bearer — raised under another token, or queued before 0.77.0. Default\n     * `\"anonymous\"`.\n     *\n     * - `\"anonymous\"` — send it without `Authorization`. The route is public,\n     *   so the error still reaches the backend; it is only not attributed to\n     *   anybody. This includes the user's own reports raised before a token\n     *   refresh: attribution is lost, never misplaced.\n     * - `\"drop\"` — discard every report not proven to be the current\n     *   principal's: another principal, nobody, or unknown (no principal at\n     *   report time, a legacy entry, or nobody signed in now). For apps where\n     *   a previous user's error text must not leave the device after they\n     *   signed out. **Needs `getPrincipal`**: without it the only identity is\n     *   the token fingerprint, and a refresh changes it, so a mismatch is no\n     *   proof the report is someone else's — the reporter then sends\n     *   anonymously instead of destroying the user's own reports.\n     *\n     * Never is a report sent with a bearer other than the one it was raised\n     * under: that would credit the previous user's error to whoever signed in\n     * next.\n     */\n    foreignReports?: \"anonymous\" | \"drop\";\n    /**\n     * Device facts, read **when the error is reported**, not when it is sent —\n     * a report queued offline on `1.4.0` must not go out labelled `1.5.0`.\n     */\n    device?: () => AppErrorDeviceSchema;\n    /** Where the queue persists. Defaults to `localStorage`; `null` keeps it in memory. */\n    storage?: AppErrorQueueStorage | null;\n    /** Storage key. Default `\"tempest:app-errors\"`. */\n    storageKey?: string;\n    /** Ceiling on distinct waiting reports; the oldest is evicted. Default `50`. */\n    maxEntries?: number;\n    /** `fetch` to send with. Defaults to the global one. */\n    fetch?: typeof fetch;\n    /** Send on every report and when the browser goes `online`. Default `true`. */\n    autoFlush?: boolean;\n}\n\n/** What one {@link AppErrorReporter.flush} did. */\nexport interface AppErrorFlushResult {\n    /** Reports the backend accepted. */\n    sent: number;\n    /** Reports the backend refused for good (a 4xx other than 408/429) and were dropped. */\n    dropped: number;\n    /** Reports still waiting. */\n    pending: number;\n    /** Milliseconds the backend asked to wait (429 `Retry-After`), or `null`. */\n    retryAfterMs: number | null;\n}\n\n/** The reporter {@link createAppErrorReporter} returns. */\nexport interface AppErrorReporter {\n    /** Queue an error with optional context, and try to send it. Never throws. */\n    report: (error: unknown, context?: Record<string, unknown>) => void;\n    /** Drain the queue now. Concurrent calls share one run. */\n    flush: () => Promise<AppErrorFlushResult>;\n    /**\n     * The waiting entries, oldest first. With an async `getToken` and no\n     * `getPrincipal`, a report joins them once its token resolves — `flush()`\n     * waits for that, `pending()` does not.\n     */\n    pending: () => AppErrorQueueEntry[];\n    /**\n     * Drop every waiting report. Call it on logout when reports raised in that\n     * session should not outlive it; even without it, a report never leaves\n     * with the next user's bearer.\n     *\n     * It also stops a flush in flight before its next send (the one already on\n     * the wire cannot be recalled), and discards reports still waiting for an\n     * async `getToken` to stamp them — both would otherwise refill the queue or\n     * keep sending what the logout meant to forget.\n     */\n    clear: () => void;\n    /** Remove the `online` listener and the retry timer. */\n    dispose: () => void;\n}\n\n/** Set once the warning has printed, so every reporter built after it stays quiet. */\nlet warnedDropWithoutPrincipal = false;\n\n/**\n * Reset the warn-once latch. Test-only: the latch is module state, so a suite\n * asserting the warning more than once would otherwise see it only the first time.\n */\nexport function resetDropWithoutPrincipalWarning(): void {\n    warnedDropWithoutPrincipal = false;\n}\n\n/**\n * Warn once, in development, that `foreignReports: \"drop\"` was asked for\n * without the `getPrincipal` it needs.\n *\n * Without a principal the only identity is the token fingerprint, which a\n * refresh changes, so the reporter cannot tell a foreign report from the\n * user's own and sends them anonymously instead of dropping them. The option\n * type-checks either way, so nothing else would tell the app its privacy\n * choice is not in force.\n *\n * @param options - The reporter's options.\n */\nfunction warnOnDropWithoutPrincipal(options: CreateAppErrorReporterOptions): void {\n    if (warnedDropWithoutPrincipal || options.foreignReports !== \"drop\") return;\n    if (options.getPrincipal !== undefined || !isDevBuild()) return;\n    warnedDropWithoutPrincipal = true;\n    console.warn(\n        '[tempest-react-sdk] createAppErrorReporter({ foreignReports: \"drop\" }) needs ' +\n            \"`getPrincipal`: without it the reporter cannot prove a queued report belongs \" +\n            \"to someone else, so it drops nothing and those reports go out anonymously. \" +\n            'Pass `getPrincipal` to make \"drop\" take effect.',\n    );\n}\n\n/**\n * Pick the default store, guarding hosts where touching `localStorage` throws.\n *\n * @returns `localStorage`, or `null` when there is none.\n */\nfunction defaultStorage(): AppErrorQueueStorage | null {\n    try {\n        return typeof localStorage === \"undefined\" ? null : localStorage;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Read the device facts, reporting without them when the getter throws.\n *\n * @param device - The caller's getter.\n * @returns The facts, or an empty object.\n */\nfunction readDevice(device: CreateAppErrorReporterOptions[\"device\"]): AppErrorDeviceSchema {\n    try {\n        return device?.() ?? {};\n    } catch {\n        return {};\n    }\n}\n\n/**\n * Fingerprint whoever `getPrincipal` says is signed in.\n *\n * @param getPrincipal - The app's principal getter.\n * @returns The owner, or `null` when nobody is signed in or the getter throws.\n */\nfunction principalOwner(getPrincipal: () => unknown): string | null {\n    try {\n        return ownerFingerprint(\"p\", getPrincipal());\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Stamp a report being raised now with its session and, when given, principal.\n *\n * @param getPrincipal - The app's principal getter, read synchronously.\n * @param token - The token read now, or a promise of it.\n * @returns The stamp, or a promise of it when the token is still arriving.\n */\nfunction stampNow(\n    getPrincipal: CreateAppErrorReporterOptions[\"getPrincipal\"],\n    token: string | null | Promise<string | null>,\n): AppErrorStamp | Promise<AppErrorStamp> {\n    const owner = getPrincipal ? { owner: principalOwner(getPrincipal) } : {};\n    if (typeof token === \"string\" || token === null) {\n        return { session: ownerFingerprint(\"t\", token), ...owner };\n    }\n    return token.then((value) => ({ session: ownerFingerprint(\"t\", value), ...owner }));\n}\n\n/**\n * Report client errors to a Tempest backend's `POST /api/app-errors`, surviving\n * the offline stretches where field errors actually happen.\n *\n * The client half of `tempest-fastapi-sdk`'s `app_errors` module. An error is\n * described ({@link describeAppError}), stamped with the device facts of that\n * moment, fitted to the backend's column limits and queued in `localStorage`\n * before anything goes over the network — so a report raised with no signal is\n * sent when the browser comes back `online`, not lost.\n *\n * What each answer does to the queue:\n *\n * - **2xx** — removed.\n * - **429** — kept; sending pauses for `Retry-After`, then resumes on its own.\n * - **5xx, 408, network failure** — kept; the next report, `online` event or\n *   `flush()` retries.\n * - **any other 4xx** — dropped: the backend will refuse that body forever, and\n *   keeping it would block every report queued behind it.\n *\n * Each report is stamped with a one-way fingerprint of the token in force when\n * it was raised, and goes out with a bearer only when the token at send time is\n * that same one — never with the token of whoever signed in next. The queue\n * never stores a token. `clear()` also stops a flush in flight and discards\n * reports still waiting for an async token.\n *\n * @example\n * import { createAppErrorReporter } from \"tempest-react-sdk\";\n *\n * const reporter = createAppErrorReporter({\n *     endpoint: `${import.meta.env.VITE_API_URL}/api/app-errors`,\n *     getToken: () => sessionStorage.getItem(\"access_token\"),\n *     device: () => ({ platform: \"web\", app_version: \"1.4.0\" }),\n * });\n *\n * reporter.report(new Error(\"crop failed\"), { step: \"crop\", size: 0 });\n *\n * @param options - Endpoint, token and device getters, storage and limits.\n * @returns The reporter.\n */\nexport function createAppErrorReporter(options: CreateAppErrorReporterOptions): AppErrorReporter {\n    const { endpoint, getToken, getPrincipal, device, autoFlush = true } = options;\n    warnOnDropWithoutPrincipal(options);\n    const strict = getPrincipal !== undefined && options.foreignReports === \"drop\";\n    const queue = createAppErrorQueue(\n        options.storage === undefined ? defaultStorage() : options.storage,\n        options.storageKey ?? \"tempest:app-errors\",\n        options.maxEntries ?? 50,\n    );\n    let running: Promise<AppErrorFlushResult> | null = null;\n    let pausedUntil = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const stamping = new Set<Promise<void>>();\n    let generation = 0;\n\n    const drain = async (): Promise<AppErrorFlushResult> => {\n        const send = options.fetch ?? globalThis.fetch.bind(globalThis);\n        await Promise.all(stamping);\n        const token = await readToken(getToken);\n        const session = ownerFingerprint(\"t\", token);\n        const current = getPrincipal ? principalOwner(getPrincipal) : null;\n        const started = generation;\n        const result: AppErrorFlushResult = { sent: 0, dropped: 0, pending: 0, retryAfterMs: null };\n        for (const entry of queue.entries()) {\n            if (!queue.has(entry)) continue;\n            if (strict && (entry.owner == null || entry.owner !== current)) {\n                queue.remove(entry);\n                result.dropped += 1;\n                continue;\n            }\n            const bearer = entry.session != null && entry.session === session ? token : null;\n            const outcome = await sendOne(send, endpoint, bearer, entry);\n            if (generation !== started) break;\n            if (outcome.kind === \"stop\") break;\n            if (outcome.kind === \"wait\") {\n                result.retryAfterMs = outcome.ms;\n                pausedUntil = Date.now() + outcome.ms;\n                timer ??= setTimeout(() => {\n                    timer = null;\n                    void flush();\n                }, outcome.ms);\n                break;\n            }\n            queue.remove(entry);\n            result[outcome.kind === \"sent\" ? \"sent\" : \"dropped\"] += 1;\n        }\n        result.pending = queue.entries().length;\n        return result;\n    };\n\n    const flush = (): Promise<AppErrorFlushResult> => {\n        running ??= drain().finally(() => {\n            running = null;\n        });\n        return running;\n    };\n\n    const shouldSend = (): boolean =>\n        autoFlush &&\n        Date.now() >= pausedUntil &&\n        (typeof navigator === \"undefined\" || navigator.onLine !== false);\n\n    const onOnline = (): void => {\n        if (shouldSend()) void flush();\n    };\n    if (autoFlush && typeof window !== \"undefined\") window.addEventListener(\"online\", onOnline);\n\n    return {\n        report(error, context) {\n            const description = describeAppError(error, context);\n            const report = fitAppErrorReport({ ...readDevice(device), ...description });\n            const stamp = stampNow(getPrincipal, readToken(getToken));\n            if (!(stamp instanceof Promise)) {\n                queue.push(report, stamp);\n                if (shouldSend()) void flush();\n                return;\n            }\n            const raisedIn = generation;\n            const stamped = stamp.then((value) => {\n                stamping.delete(stamped);\n                if (generation !== raisedIn) return;\n                queue.push(report, value);\n                if (shouldSend()) void flush();\n            });\n            stamping.add(stamped);\n        },\n        flush,\n        pending: () => queue.entries(),\n        clear() {\n            generation += 1;\n            queue.clear();\n        },\n        dispose() {\n            if (typeof window !== \"undefined\") window.removeEventListener(\"online\", onOnline);\n            if (timer) clearTimeout(timer);\n            timer = null;\n        },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-error-reporter.cjs","names":["isDevBuild","ownerFingerprint","createAppErrorQueue","readToken","sendOne","describeAppError","fitAppErrorReport","require_dev_mode","require_owner_fingerprint","require_app_error_queue","require_app_error_schema","require_app_error_transport","require_describe_app_error","warnedDropWithoutPrincipal","warnOnDropWithoutPrincipal","options","defaultStorage","readDevice","device","principalOwner","getPrincipal","stampNow","owner","token","value","createAppErrorReporter","strict","queue","running","pausedUntil","timer","stamping","generation","drain","send","getToken","session","current","started","result","entry","bearer","outcome","endpoint","flush","shouldSend","autoFlush","onOnline","description","error","context","report","stamp","raisedIn","stamped"],"sources":["../../src/telemetry/app-error-reporter.ts"],"sourcesContent":["import { ownerFingerprint } from \"@/utils/owner-fingerprint\";\nimport { createAppErrorQueue } from \"./app-error-queue\";\nimport type { AppErrorQueueEntry, AppErrorQueueStorage, AppErrorStamp } from \"./app-error-queue\";\nimport { fitAppErrorReport } from \"./app-error-schema\";\nimport type { AppErrorDeviceSchema } from \"./app-error-schema\";\nimport { readToken, sendOne } from \"./app-error-transport\";\nimport { describeAppError } from \"./describe-app-error\";\nimport { isDevBuild } from \"../utils/dev-mode\";\n\n/** Options for {@link createAppErrorReporter}. */\nexport interface CreateAppErrorReporterOptions {\n    /** Full URL of the backend route, e.g. `${API_URL}/api/app-errors`. */\n    endpoint: string;\n    /**\n     * Current access token, if any. Optional on purpose: the route is public,\n     * and an error raised before login — or with a stale session — still has\n     * to get through. A token that throws or resolves empty sends anonymously.\n     */\n    getToken?: () => string | null | undefined | Promise<string | null | undefined>;\n    /**\n     * Who is signed in right now — a stable, non-secret id such as the user id.\n     * Read **when the error is reported**, and stored in the queue only as a\n     * one-way fingerprint (`entry.owner`). A non-string (an `async` getter\n     * from untyped JS, an object) or a getter that throws reads as nobody.\n     *\n     * It never grants the bearer. The bearer goes out only when the token at\n     * send time is the very token that was in force at report time (its\n     * fingerprint is `entry.session`): the principal and the token come from\n     * two sources, and a principal store that lags behind a login would\n     * otherwise send A's report with B's token. The principal only tells\n     * {@link CreateAppErrorReporterOptions.foreignReports} `\"drop\"` whose\n     * report is whose.\n     */\n    getPrincipal?: () => string | number | null | undefined;\n    /**\n     * What to do with a queued report that cannot go out with the current\n     * bearer — raised under another token, or queued before 0.77.0. Default\n     * `\"anonymous\"`.\n     *\n     * - `\"anonymous\"` — send it without `Authorization`. The route is public,\n     *   so the error still reaches the backend; it is only not attributed to\n     *   anybody. This includes the user's own reports raised before a token\n     *   refresh: attribution is lost, never misplaced.\n     * - `\"drop\"` — discard every report not proven to be the current\n     *   principal's: another principal, nobody, or unknown (no principal at\n     *   report time, a legacy entry, or nobody signed in now). For apps where\n     *   a previous user's error text must not leave the device after they\n     *   signed out. **Needs `getPrincipal`**: without it the only identity is\n     *   the token fingerprint, and a refresh changes it, so a mismatch is no\n     *   proof the report is someone else's — the reporter then sends\n     *   anonymously instead of destroying the user's own reports.\n     *\n     * Never is a report sent with a bearer other than the one it was raised\n     * under: that would credit the previous user's error to whoever signed in\n     * next.\n     */\n    foreignReports?: \"anonymous\" | \"drop\";\n    /**\n     * Device facts, read **when the error is reported**, not when it is sent —\n     * a report queued offline on `1.4.0` must not go out labelled `1.5.0`.\n     */\n    device?: () => AppErrorDeviceSchema;\n    /** Where the queue persists. Defaults to `localStorage`; `null` keeps it in memory. */\n    storage?: AppErrorQueueStorage | null;\n    /** Storage key. Default `\"tempest:app-errors\"`. */\n    storageKey?: string;\n    /** Ceiling on distinct waiting reports; the oldest is evicted. Default `50`. */\n    maxEntries?: number;\n    /** `fetch` to send with. Defaults to the global one. */\n    fetch?: typeof fetch;\n    /** Send on every report and when the browser goes `online`. Default `true`. */\n    autoFlush?: boolean;\n}\n\n/** What one {@link AppErrorReporter.flush} did. */\nexport interface AppErrorFlushResult {\n    /** Reports the backend accepted. */\n    sent: number;\n    /** Reports the backend refused for good (a 4xx other than 408/429) and were dropped. */\n    dropped: number;\n    /** Reports still waiting. */\n    pending: number;\n    /** Milliseconds the backend asked to wait (429 `Retry-After`), or `null`. */\n    retryAfterMs: number | null;\n}\n\n/** The reporter {@link createAppErrorReporter} returns. */\nexport interface AppErrorReporter {\n    /** Queue an error with optional context, and try to send it. Never throws. */\n    report: (error: unknown, context?: Record<string, unknown>) => void;\n    /** Drain the queue now. Concurrent calls share one run. */\n    flush: () => Promise<AppErrorFlushResult>;\n    /**\n     * The waiting entries, oldest first. With an async `getToken` and no\n     * `getPrincipal`, a report joins them once its token resolves — `flush()`\n     * waits for that, `pending()` does not.\n     */\n    pending: () => AppErrorQueueEntry[];\n    /**\n     * Drop every waiting report. Call it on logout when reports raised in that\n     * session should not outlive it; even without it, a report never leaves\n     * with the next user's bearer.\n     *\n     * It also stops a flush in flight before its next send (the one already on\n     * the wire cannot be recalled), and discards reports still waiting for an\n     * async `getToken` to stamp them — both would otherwise refill the queue or\n     * keep sending what the logout meant to forget.\n     */\n    clear: () => void;\n    /** Remove the `online` listener and the retry timer. */\n    dispose: () => void;\n}\n\n/** Set once the warning has printed, so every reporter built after it stays quiet. */\nlet warnedDropWithoutPrincipal = false;\n\n/**\n * Reset the warn-once latch. Test-only: the latch is module state, so a suite\n * asserting the warning more than once would otherwise see it only the first time.\n */\nexport function resetDropWithoutPrincipalWarning(): void {\n    warnedDropWithoutPrincipal = false;\n}\n\n/**\n * Warn once, in development, that `foreignReports: \"drop\"` was asked for\n * without the `getPrincipal` it needs.\n *\n * Without a principal the only identity is the token fingerprint, which a\n * refresh changes, so the reporter cannot tell a foreign report from the\n * user's own and sends them anonymously instead of dropping them. The option\n * type-checks either way, so nothing else would tell the app its privacy\n * choice is not in force.\n *\n * @param options - The reporter's options.\n */\nfunction warnOnDropWithoutPrincipal(options: CreateAppErrorReporterOptions): void {\n    if (warnedDropWithoutPrincipal || options.foreignReports !== \"drop\") return;\n    if (options.getPrincipal !== undefined || !isDevBuild()) return;\n    warnedDropWithoutPrincipal = true;\n    console.warn(\n        '[tempest-react-sdk] createAppErrorReporter({ foreignReports: \"drop\" }) needs ' +\n            \"`getPrincipal`: without it the reporter cannot prove a queued report belongs \" +\n            \"to someone else, so it drops nothing and those reports go out anonymously. \" +\n            'Pass `getPrincipal` to make \"drop\" take effect.',\n    );\n}\n\n/**\n * Pick the default store, guarding hosts where touching `localStorage` throws.\n *\n * @returns `localStorage`, or `null` when there is none.\n */\nfunction defaultStorage(): AppErrorQueueStorage | null {\n    try {\n        return typeof localStorage === \"undefined\" ? null : localStorage;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Read the device facts, reporting without them when the getter throws.\n *\n * @param device - The caller's getter.\n * @returns The facts, or an empty object.\n */\nfunction readDevice(device: CreateAppErrorReporterOptions[\"device\"]): AppErrorDeviceSchema {\n    try {\n        return device?.() ?? {};\n    } catch {\n        return {};\n    }\n}\n\n/**\n * Fingerprint whoever `getPrincipal` says is signed in.\n *\n * @param getPrincipal - The app's principal getter.\n * @returns The owner, or `null` when nobody is signed in or the getter throws.\n */\nfunction principalOwner(getPrincipal: () => unknown): string | null {\n    try {\n        return ownerFingerprint(\"p\", getPrincipal());\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Stamp a report being raised now with its session and, when given, principal.\n *\n * @param getPrincipal - The app's principal getter, read synchronously.\n * @param token - The token read now, or a promise of it.\n * @returns The stamp, or a promise of it when the token is still arriving.\n */\nfunction stampNow(\n    getPrincipal: CreateAppErrorReporterOptions[\"getPrincipal\"],\n    token: string | null | Promise<string | null>,\n): AppErrorStamp | Promise<AppErrorStamp> {\n    const owner = getPrincipal ? { owner: principalOwner(getPrincipal) } : {};\n    if (typeof token === \"string\" || token === null) {\n        return { session: ownerFingerprint(\"t\", token), ...owner };\n    }\n    return token.then((value) => ({ session: ownerFingerprint(\"t\", value), ...owner }));\n}\n\n/**\n * Report client errors to a Tempest backend's `POST /api/app-errors`, surviving\n * the offline stretches where field errors actually happen.\n *\n * The client half of `tempest-fastapi-sdk`'s `app_errors` module. An error is\n * described ({@link describeAppError}), stamped with the device facts of that\n * moment, fitted to the backend's column limits and queued in `localStorage`\n * before anything goes over the network — so a report raised with no signal is\n * sent when the browser comes back `online`, not lost.\n *\n * What each answer does to the queue:\n *\n * - **2xx** — removed.\n * - **429** — kept; sending pauses for `Retry-After`, then resumes on its own.\n * - **5xx, 408, network failure** — kept; the next report, `online` event or\n *   `flush()` retries.\n * - **any other 4xx** — dropped: the backend will refuse that body forever, and\n *   keeping it would block every report queued behind it.\n *\n * Each report is stamped with a one-way fingerprint of the token in force when\n * it was raised, and goes out with a bearer only when the token at send time is\n * that same one — never with the token of whoever signed in next. The queue\n * never stores a token. `clear()` also stops a flush in flight and discards\n * reports still waiting for an async token.\n *\n * @example\n * import { createAppErrorReporter } from \"tempest-react-sdk\";\n *\n * const reporter = createAppErrorReporter({\n *     endpoint: `${import.meta.env.VITE_API_URL}/api/app-errors`,\n *     getToken: () => sessionStorage.getItem(\"access_token\"),\n *     device: () => ({ platform: \"web\", app_version: \"1.4.0\" }),\n * });\n *\n * reporter.report(new Error(\"crop failed\"), { step: \"crop\", size: 0 });\n *\n * @param options - Endpoint, token and device getters, storage and limits.\n * @returns The reporter.\n */\nexport function createAppErrorReporter(options: CreateAppErrorReporterOptions): AppErrorReporter {\n    const { endpoint, getToken, getPrincipal, device, autoFlush = true } = options;\n    warnOnDropWithoutPrincipal(options);\n    const strict = getPrincipal !== undefined && options.foreignReports === \"drop\";\n    const queue = createAppErrorQueue(\n        options.storage === undefined ? defaultStorage() : options.storage,\n        options.storageKey ?? \"tempest:app-errors\",\n        options.maxEntries ?? 50,\n    );\n    let running: Promise<AppErrorFlushResult> | null = null;\n    let pausedUntil = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const stamping = new Set<Promise<void>>();\n    let generation = 0;\n\n    const drain = async (): Promise<AppErrorFlushResult> => {\n        const send = options.fetch ?? globalThis.fetch.bind(globalThis);\n        await Promise.all(stamping);\n        const token = await readToken(getToken);\n        const session = ownerFingerprint(\"t\", token);\n        const current = getPrincipal ? principalOwner(getPrincipal) : null;\n        const started = generation;\n        const result: AppErrorFlushResult = { sent: 0, dropped: 0, pending: 0, retryAfterMs: null };\n        for (const entry of queue.entries()) {\n            if (!queue.has(entry)) continue;\n            if (strict && (entry.owner == null || entry.owner !== current)) {\n                queue.remove(entry);\n                result.dropped += 1;\n                continue;\n            }\n            const bearer = entry.session != null && entry.session === session ? token : null;\n            const outcome = await sendOne(send, endpoint, bearer, entry);\n            if (generation !== started) break;\n            if (outcome.kind === \"stop\") break;\n            if (outcome.kind === \"wait\") {\n                result.retryAfterMs = outcome.ms;\n                pausedUntil = Date.now() + outcome.ms;\n                timer ??= setTimeout(() => {\n                    timer = null;\n                    void flush();\n                }, outcome.ms);\n                break;\n            }\n            queue.remove(entry);\n            result[outcome.kind === \"sent\" ? \"sent\" : \"dropped\"] += 1;\n        }\n        result.pending = queue.entries().length;\n        return result;\n    };\n\n    const flush = (): Promise<AppErrorFlushResult> => {\n        running ??= drain().finally(() => {\n            running = null;\n        });\n        return running;\n    };\n\n    const shouldSend = (): boolean =>\n        autoFlush &&\n        Date.now() >= pausedUntil &&\n        (typeof navigator === \"undefined\" || navigator.onLine !== false);\n\n    const onOnline = (): void => {\n        if (shouldSend()) void flush();\n    };\n    if (autoFlush && typeof window !== \"undefined\") window.addEventListener(\"online\", onOnline);\n\n    return {\n        report(error, context) {\n            const description = describeAppError(error, context);\n            const report = fitAppErrorReport({ ...readDevice(device), ...description });\n            const stamp = stampNow(getPrincipal, readToken(getToken));\n            if (!(stamp instanceof Promise)) {\n                queue.push(report, stamp);\n                if (shouldSend()) void flush();\n                return;\n            }\n            const raisedIn = generation;\n            const stamped = stamp.then((value) => {\n                stamping.delete(stamped);\n                if (generation !== raisedIn) return;\n                queue.push(report, value);\n                if (shouldSend()) void flush();\n            });\n            stamping.add(stamped);\n        },\n        flush,\n        pending: () => queue.entries(),\n        clear() {\n            generation += 1;\n            queue.clear();\n        },\n        dispose() {\n            if (typeof window !== \"undefined\") window.removeEventListener(\"online\", onOnline);\n            if (timer) clearTimeout(timer);\n            timer = null;\n        },\n    };\n}\n"],"mappings":"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"}

package/dist/telemetry/app-error-reporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-error-reporter.js","names":[],"sources":["../../src/telemetry/app-error-reporter.ts"],"sourcesContent":["import { ownerFingerprint } from \"@/utils/owner-fingerprint\";\nimport { createAppErrorQueue } from \"./app-error-queue\";\nimport type { AppErrorQueueEntry, AppErrorQueueStorage, AppErrorStamp } from \"./app-error-queue\";\nimport { fitAppErrorReport } from \"./app-error-schema\";\nimport type { AppErrorDeviceSchema } from \"./app-error-schema\";\nimport { readToken, sendOne } from \"./app-error-transport\";\nimport { describeAppError } from \"./describe-app-error\";\nimport { isDevBuild } from \"../utils/dev-mode\";\n\n/** Options for {@link createAppErrorReporter}. */\nexport interface CreateAppErrorReporterOptions {\n    /** Full URL of the backend route, e.g. `${API_URL}/api/app-errors`. */\n    endpoint: string;\n    /**\n     * Current access token, if any. Optional on purpose: the route is public,\n     * and an error raised before login — or with a stale session — still has\n     * to get through. A token that throws or resolves empty sends anonymously.\n     */\n    getToken?: () => string | null | undefined | Promise<string | null | undefined>;\n    /**\n     * Who is signed in right now — a stable, non-secret id such as the user id.\n     * Read **when the error is reported**, and stored in the queue only as a\n     * one-way fingerprint (`entry.owner`). A non-string (an `async` getter\n     * from untyped JS, an object) or a getter that throws reads as nobody.\n     *\n     * It never grants the bearer. The bearer goes out only when the token at\n     * send time is the very token that was in force at report time (its\n     * fingerprint is `entry.session`): the principal and the token come from\n     * two sources, and a principal store that lags behind a login would\n     * otherwise send A's report with B's token. The principal only tells\n     * {@link CreateAppErrorReporterOptions.foreignReports} `\"drop\"` whose\n     * report is whose.\n     */\n    getPrincipal?: () => string | number | null | undefined;\n    /**\n     * What to do with a queued report that cannot go out with the current\n     * bearer — raised under another token, or queued before 0.77.0. Default\n     * `\"anonymous\"`.\n     *\n     * - `\"anonymous\"` — send it without `Authorization`. The route is public,\n     *   so the error still reaches the backend; it is only not attributed to\n     *   anybody. This includes the user's own reports raised before a token\n     *   refresh: attribution is lost, never misplaced.\n     * - `\"drop\"` — discard every report not proven to be the current\n     *   principal's: another principal, nobody, or unknown (no principal at\n     *   report time, a legacy entry, or nobody signed in now). For apps where\n     *   a previous user's error text must not leave the device after they\n     *   signed out. **Needs `getPrincipal`**: without it the only identity is\n     *   the token fingerprint, and a refresh changes it, so a mismatch is no\n     *   proof the report is someone else's — the reporter then sends\n     *   anonymously instead of destroying the user's own reports.\n     *\n     * Never is a report sent with a bearer other than the one it was raised\n     * under: that would credit the previous user's error to whoever signed in\n     * next.\n     */\n    foreignReports?: \"anonymous\" | \"drop\";\n    /**\n     * Device facts, read **when the error is reported**, not when it is sent —\n     * a report queued offline on `1.4.0` must not go out labelled `1.5.0`.\n     */\n    device?: () => AppErrorDeviceSchema;\n    /** Where the queue persists. Defaults to `localStorage`; `null` keeps it in memory. */\n    storage?: AppErrorQueueStorage | null;\n    /** Storage key. Default `\"tempest:app-errors\"`. */\n    storageKey?: string;\n    /** Ceiling on distinct waiting reports; the oldest is evicted. Default `50`. */\n    maxEntries?: number;\n    /** `fetch` to send with. Defaults to the global one. */\n    fetch?: typeof fetch;\n    /** Send on every report and when the browser goes `online`. Default `true`. */\n    autoFlush?: boolean;\n}\n\n/** What one {@link AppErrorReporter.flush} did. */\nexport interface AppErrorFlushResult {\n    /** Reports the backend accepted. */\n    sent: number;\n    /** Reports the backend refused for good (a 4xx other than 408/429) and were dropped. */\n    dropped: number;\n    /** Reports still waiting. */\n    pending: number;\n    /** Milliseconds the backend asked to wait (429 `Retry-After`), or `null`. */\n    retryAfterMs: number | null;\n}\n\n/** The reporter {@link createAppErrorReporter} returns. */\nexport interface AppErrorReporter {\n    /** Queue an error with optional context, and try to send it. Never throws. */\n    report: (error: unknown, context?: Record<string, unknown>) => void;\n    /** Drain the queue now. Concurrent calls share one run. */\n    flush: () => Promise<AppErrorFlushResult>;\n    /**\n     * The waiting entries, oldest first. With an async `getToken` and no\n     * `getPrincipal`, a report joins them once its token resolves — `flush()`\n     * waits for that, `pending()` does not.\n     */\n    pending: () => AppErrorQueueEntry[];\n    /**\n     * Drop every waiting report. Call it on logout when reports raised in that\n     * session should not outlive it; even without it, a report never leaves\n     * with the next user's bearer.\n     *\n     * It also stops a flush in flight before its next send (the one already on\n     * the wire cannot be recalled), and discards reports still waiting for an\n     * async `getToken` to stamp them — both would otherwise refill the queue or\n     * keep sending what the logout meant to forget.\n     */\n    clear: () => void;\n    /** Remove the `online` listener and the retry timer. */\n    dispose: () => void;\n}\n\n/** Set once the warning has printed, so every reporter built after it stays quiet. */\nlet warnedDropWithoutPrincipal = false;\n\n/**\n * Reset the warn-once latch. Test-only: the latch is module state, so a suite\n * asserting the warning more than once would otherwise see it only the first time.\n */\nexport function resetDropWithoutPrincipalWarning(): void {\n    warnedDropWithoutPrincipal = false;\n}\n\n/**\n * Warn once, in development, that `foreignReports: \"drop\"` was asked for\n * without the `getPrincipal` it needs.\n *\n * Without a principal the only identity is the token fingerprint, which a\n * refresh changes, so the reporter cannot tell a foreign report from the\n * user's own and sends them anonymously instead of dropping them. The option\n * type-checks either way, so nothing else would tell the app its privacy\n * choice is not in force.\n *\n * @param options - The reporter's options.\n */\nfunction warnOnDropWithoutPrincipal(options: CreateAppErrorReporterOptions): void {\n    if (warnedDropWithoutPrincipal || options.foreignReports !== \"drop\") return;\n    if (options.getPrincipal !== undefined || !isDevBuild()) return;\n    warnedDropWithoutPrincipal = true;\n    console.warn(\n        '[tempest-react-sdk] createAppErrorReporter({ foreignReports: \"drop\" }) needs ' +\n            \"`getPrincipal`: without it the reporter cannot prove a queued report belongs \" +\n            \"to someone else, so it drops nothing and those reports go out anonymously. \" +\n            'Pass `getPrincipal` to make \"drop\" take effect.',\n    );\n}\n\n/**\n * Pick the default store, guarding hosts where touching `localStorage` throws.\n *\n * @returns `localStorage`, or `null` when there is none.\n */\nfunction defaultStorage(): AppErrorQueueStorage | null {\n    try {\n        return typeof localStorage === \"undefined\" ? null : localStorage;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Read the device facts, reporting without them when the getter throws.\n *\n * @param device - The caller's getter.\n * @returns The facts, or an empty object.\n */\nfunction readDevice(device: CreateAppErrorReporterOptions[\"device\"]): AppErrorDeviceSchema {\n    try {\n        return device?.() ?? {};\n    } catch {\n        return {};\n    }\n}\n\n/**\n * Fingerprint whoever `getPrincipal` says is signed in.\n *\n * @param getPrincipal - The app's principal getter.\n * @returns The owner, or `null` when nobody is signed in or the getter throws.\n */\nfunction principalOwner(getPrincipal: () => unknown): string | null {\n    try {\n        return ownerFingerprint(\"p\", getPrincipal());\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Stamp a report being raised now with its session and, when given, principal.\n *\n * @param getPrincipal - The app's principal getter, read synchronously.\n * @param token - The token read now, or a promise of it.\n * @returns The stamp, or a promise of it when the token is still arriving.\n */\nfunction stampNow(\n    getPrincipal: CreateAppErrorReporterOptions[\"getPrincipal\"],\n    token: string | null | Promise<string | null>,\n): AppErrorStamp | Promise<AppErrorStamp> {\n    const owner = getPrincipal ? { owner: principalOwner(getPrincipal) } : {};\n    if (typeof token === \"string\" || token === null) {\n        return { session: ownerFingerprint(\"t\", token), ...owner };\n    }\n    return token.then((value) => ({ session: ownerFingerprint(\"t\", value), ...owner }));\n}\n\n/**\n * Report client errors to a Tempest backend's `POST /api/app-errors`, surviving\n * the offline stretches where field errors actually happen.\n *\n * The client half of `tempest-fastapi-sdk`'s `app_errors` module. An error is\n * described ({@link describeAppError}), stamped with the device facts of that\n * moment, fitted to the backend's column limits and queued in `localStorage`\n * before anything goes over the network — so a report raised with no signal is\n * sent when the browser comes back `online`, not lost.\n *\n * What each answer does to the queue:\n *\n * - **2xx** — removed.\n * - **429** — kept; sending pauses for `Retry-After`, then resumes on its own.\n * - **5xx, 408, network failure** — kept; the next report, `online` event or\n *   `flush()` retries.\n * - **any other 4xx** — dropped: the backend will refuse that body forever, and\n *   keeping it would block every report queued behind it.\n *\n * Each report is stamped with a one-way fingerprint of the token in force when\n * it was raised, and goes out with a bearer only when the token at send time is\n * that same one — never with the token of whoever signed in next. The queue\n * never stores a token. `clear()` also stops a flush in flight and discards\n * reports still waiting for an async token.\n *\n * @example\n * import { createAppErrorReporter } from \"tempest-react-sdk\";\n *\n * const reporter = createAppErrorReporter({\n *     endpoint: `${import.meta.env.VITE_API_URL}/api/app-errors`,\n *     getToken: () => sessionStorage.getItem(\"access_token\"),\n *     device: () => ({ platform: \"web\", app_version: \"1.4.0\" }),\n * });\n *\n * reporter.report(new Error(\"crop failed\"), { step: \"crop\", size: 0 });\n *\n * @param options - Endpoint, token and device getters, storage and limits.\n * @returns The reporter.\n */\nexport function createAppErrorReporter(options: CreateAppErrorReporterOptions): AppErrorReporter {\n    const { endpoint, getToken, getPrincipal, device, autoFlush = true } = options;\n    warnOnDropWithoutPrincipal(options);\n    const strict = getPrincipal !== undefined && options.foreignReports === \"drop\";\n    const queue = createAppErrorQueue(\n        options.storage === undefined ? defaultStorage() : options.storage,\n        options.storageKey ?? \"tempest:app-errors\",\n        options.maxEntries ?? 50,\n    );\n    let running: Promise<AppErrorFlushResult> | null = null;\n    let pausedUntil = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const stamping = new Set<Promise<void>>();\n    let generation = 0;\n\n    const drain = async (): Promise<AppErrorFlushResult> => {\n        const send = options.fetch ?? globalThis.fetch.bind(globalThis);\n        await Promise.all(stamping);\n        const token = await readToken(getToken);\n        const session = ownerFingerprint(\"t\", token);\n        const current = getPrincipal ? principalOwner(getPrincipal) : null;\n        const started = generation;\n        const result: AppErrorFlushResult = { sent: 0, dropped: 0, pending: 0, retryAfterMs: null };\n        for (const entry of queue.entries()) {\n            if (!queue.has(entry)) continue;\n            if (strict && (entry.owner == null || entry.owner !== current)) {\n                queue.remove(entry);\n                result.dropped += 1;\n                continue;\n            }\n            const bearer = entry.session != null && entry.session === session ? token : null;\n            const outcome = await sendOne(send, endpoint, bearer, entry);\n            if (generation !== started) break;\n            if (outcome.kind === \"stop\") break;\n            if (outcome.kind === \"wait\") {\n                result.retryAfterMs = outcome.ms;\n                pausedUntil = Date.now() + outcome.ms;\n                timer ??= setTimeout(() => {\n                    timer = null;\n                    void flush();\n                }, outcome.ms);\n                break;\n            }\n            queue.remove(entry);\n            result[outcome.kind === \"sent\" ? \"sent\" : \"dropped\"] += 1;\n        }\n        result.pending = queue.entries().length;\n        return result;\n    };\n\n    const flush = (): Promise<AppErrorFlushResult> => {\n        running ??= drain().finally(() => {\n            running = null;\n        });\n        return running;\n    };\n\n    const shouldSend = (): boolean =>\n        autoFlush &&\n        Date.now() >= pausedUntil &&\n        (typeof navigator === \"undefined\" || navigator.onLine !== false);\n\n    const onOnline = (): void => {\n        if (shouldSend()) void flush();\n    };\n    if (autoFlush && typeof window !== \"undefined\") window.addEventListener(\"online\", onOnline);\n\n    return {\n        report(error, context) {\n            const description = describeAppError(error, context);\n            const report = fitAppErrorReport({ ...readDevice(device), ...description });\n            const stamp = stampNow(getPrincipal, readToken(getToken));\n            if (!(stamp instanceof Promise)) {\n                queue.push(report, stamp);\n                if (shouldSend()) void flush();\n                return;\n            }\n            const raisedIn = generation;\n            const stamped = stamp.then((value) => {\n                stamping.delete(stamped);\n                if (generation !== raisedIn) return;\n                queue.push(report, value);\n                if (shouldSend()) void flush();\n            });\n            stamping.add(stamped);\n        },\n        flush,\n        pending: () => queue.entries(),\n        clear() {\n            generation += 1;\n            queue.clear();\n        },\n        dispose() {\n            if (typeof window !== \"undefined\") window.removeEventListener(\"online\", onOnline);\n            if (timer) clearTimeout(timer);\n            timer = null;\n        },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-error-reporter.js","names":["warnedDropWithoutPrincipal","warnOnDropWithoutPrincipal","options","isDevBuild","defaultStorage","readDevice","device","principalOwner","ownerFingerprint","getPrincipal","stampNow","owner","token","value","createAppErrorReporter","strict","queue","createAppErrorQueue","running","pausedUntil","timer","stamping","generation","drain","send","readToken","getToken","session","current","started","result","entry","bearer","outcome","sendOne","endpoint","flush","shouldSend","autoFlush","onOnline","description","describeAppError","error","context","report","fitAppErrorReport","stamp","raisedIn","stamped"],"sources":["../../src/telemetry/app-error-reporter.ts"],"sourcesContent":["import { ownerFingerprint } from \"@/utils/owner-fingerprint\";\nimport { createAppErrorQueue } from \"./app-error-queue\";\nimport type { AppErrorQueueEntry, AppErrorQueueStorage, AppErrorStamp } from \"./app-error-queue\";\nimport { fitAppErrorReport } from \"./app-error-schema\";\nimport type { AppErrorDeviceSchema } from \"./app-error-schema\";\nimport { readToken, sendOne } from \"./app-error-transport\";\nimport { describeAppError } from \"./describe-app-error\";\nimport { isDevBuild } from \"../utils/dev-mode\";\n\n/** Options for {@link createAppErrorReporter}. */\nexport interface CreateAppErrorReporterOptions {\n    /** Full URL of the backend route, e.g. `${API_URL}/api/app-errors`. */\n    endpoint: string;\n    /**\n     * Current access token, if any. Optional on purpose: the route is public,\n     * and an error raised before login — or with a stale session — still has\n     * to get through. A token that throws or resolves empty sends anonymously.\n     */\n    getToken?: () => string | null | undefined | Promise<string | null | undefined>;\n    /**\n     * Who is signed in right now — a stable, non-secret id such as the user id.\n     * Read **when the error is reported**, and stored in the queue only as a\n     * one-way fingerprint (`entry.owner`). A non-string (an `async` getter\n     * from untyped JS, an object) or a getter that throws reads as nobody.\n     *\n     * It never grants the bearer. The bearer goes out only when the token at\n     * send time is the very token that was in force at report time (its\n     * fingerprint is `entry.session`): the principal and the token come from\n     * two sources, and a principal store that lags behind a login would\n     * otherwise send A's report with B's token. The principal only tells\n     * {@link CreateAppErrorReporterOptions.foreignReports} `\"drop\"` whose\n     * report is whose.\n     */\n    getPrincipal?: () => string | number | null | undefined;\n    /**\n     * What to do with a queued report that cannot go out with the current\n     * bearer — raised under another token, or queued before 0.77.0. Default\n     * `\"anonymous\"`.\n     *\n     * - `\"anonymous\"` — send it without `Authorization`. The route is public,\n     *   so the error still reaches the backend; it is only not attributed to\n     *   anybody. This includes the user's own reports raised before a token\n     *   refresh: attribution is lost, never misplaced.\n     * - `\"drop\"` — discard every report not proven to be the current\n     *   principal's: another principal, nobody, or unknown (no principal at\n     *   report time, a legacy entry, or nobody signed in now). For apps where\n     *   a previous user's error text must not leave the device after they\n     *   signed out. **Needs `getPrincipal`**: without it the only identity is\n     *   the token fingerprint, and a refresh changes it, so a mismatch is no\n     *   proof the report is someone else's — the reporter then sends\n     *   anonymously instead of destroying the user's own reports.\n     *\n     * Never is a report sent with a bearer other than the one it was raised\n     * under: that would credit the previous user's error to whoever signed in\n     * next.\n     */\n    foreignReports?: \"anonymous\" | \"drop\";\n    /**\n     * Device facts, read **when the error is reported**, not when it is sent —\n     * a report queued offline on `1.4.0` must not go out labelled `1.5.0`.\n     */\n    device?: () => AppErrorDeviceSchema;\n    /** Where the queue persists. Defaults to `localStorage`; `null` keeps it in memory. */\n    storage?: AppErrorQueueStorage | null;\n    /** Storage key. Default `\"tempest:app-errors\"`. */\n    storageKey?: string;\n    /** Ceiling on distinct waiting reports; the oldest is evicted. Default `50`. */\n    maxEntries?: number;\n    /** `fetch` to send with. Defaults to the global one. */\n    fetch?: typeof fetch;\n    /** Send on every report and when the browser goes `online`. Default `true`. */\n    autoFlush?: boolean;\n}\n\n/** What one {@link AppErrorReporter.flush} did. */\nexport interface AppErrorFlushResult {\n    /** Reports the backend accepted. */\n    sent: number;\n    /** Reports the backend refused for good (a 4xx other than 408/429) and were dropped. */\n    dropped: number;\n    /** Reports still waiting. */\n    pending: number;\n    /** Milliseconds the backend asked to wait (429 `Retry-After`), or `null`. */\n    retryAfterMs: number | null;\n}\n\n/** The reporter {@link createAppErrorReporter} returns. */\nexport interface AppErrorReporter {\n    /** Queue an error with optional context, and try to send it. Never throws. */\n    report: (error: unknown, context?: Record<string, unknown>) => void;\n    /** Drain the queue now. Concurrent calls share one run. */\n    flush: () => Promise<AppErrorFlushResult>;\n    /**\n     * The waiting entries, oldest first. With an async `getToken` and no\n     * `getPrincipal`, a report joins them once its token resolves — `flush()`\n     * waits for that, `pending()` does not.\n     */\n    pending: () => AppErrorQueueEntry[];\n    /**\n     * Drop every waiting report. Call it on logout when reports raised in that\n     * session should not outlive it; even without it, a report never leaves\n     * with the next user's bearer.\n     *\n     * It also stops a flush in flight before its next send (the one already on\n     * the wire cannot be recalled), and discards reports still waiting for an\n     * async `getToken` to stamp them — both would otherwise refill the queue or\n     * keep sending what the logout meant to forget.\n     */\n    clear: () => void;\n    /** Remove the `online` listener and the retry timer. */\n    dispose: () => void;\n}\n\n/** Set once the warning has printed, so every reporter built after it stays quiet. */\nlet warnedDropWithoutPrincipal = false;\n\n/**\n * Reset the warn-once latch. Test-only: the latch is module state, so a suite\n * asserting the warning more than once would otherwise see it only the first time.\n */\nexport function resetDropWithoutPrincipalWarning(): void {\n    warnedDropWithoutPrincipal = false;\n}\n\n/**\n * Warn once, in development, that `foreignReports: \"drop\"` was asked for\n * without the `getPrincipal` it needs.\n *\n * Without a principal the only identity is the token fingerprint, which a\n * refresh changes, so the reporter cannot tell a foreign report from the\n * user's own and sends them anonymously instead of dropping them. The option\n * type-checks either way, so nothing else would tell the app its privacy\n * choice is not in force.\n *\n * @param options - The reporter's options.\n */\nfunction warnOnDropWithoutPrincipal(options: CreateAppErrorReporterOptions): void {\n    if (warnedDropWithoutPrincipal || options.foreignReports !== \"drop\") return;\n    if (options.getPrincipal !== undefined || !isDevBuild()) return;\n    warnedDropWithoutPrincipal = true;\n    console.warn(\n        '[tempest-react-sdk] createAppErrorReporter({ foreignReports: \"drop\" }) needs ' +\n            \"`getPrincipal`: without it the reporter cannot prove a queued report belongs \" +\n            \"to someone else, so it drops nothing and those reports go out anonymously. \" +\n            'Pass `getPrincipal` to make \"drop\" take effect.',\n    );\n}\n\n/**\n * Pick the default store, guarding hosts where touching `localStorage` throws.\n *\n * @returns `localStorage`, or `null` when there is none.\n */\nfunction defaultStorage(): AppErrorQueueStorage | null {\n    try {\n        return typeof localStorage === \"undefined\" ? null : localStorage;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Read the device facts, reporting without them when the getter throws.\n *\n * @param device - The caller's getter.\n * @returns The facts, or an empty object.\n */\nfunction readDevice(device: CreateAppErrorReporterOptions[\"device\"]): AppErrorDeviceSchema {\n    try {\n        return device?.() ?? {};\n    } catch {\n        return {};\n    }\n}\n\n/**\n * Fingerprint whoever `getPrincipal` says is signed in.\n *\n * @param getPrincipal - The app's principal getter.\n * @returns The owner, or `null` when nobody is signed in or the getter throws.\n */\nfunction principalOwner(getPrincipal: () => unknown): string | null {\n    try {\n        return ownerFingerprint(\"p\", getPrincipal());\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Stamp a report being raised now with its session and, when given, principal.\n *\n * @param getPrincipal - The app's principal getter, read synchronously.\n * @param token - The token read now, or a promise of it.\n * @returns The stamp, or a promise of it when the token is still arriving.\n */\nfunction stampNow(\n    getPrincipal: CreateAppErrorReporterOptions[\"getPrincipal\"],\n    token: string | null | Promise<string | null>,\n): AppErrorStamp | Promise<AppErrorStamp> {\n    const owner = getPrincipal ? { owner: principalOwner(getPrincipal) } : {};\n    if (typeof token === \"string\" || token === null) {\n        return { session: ownerFingerprint(\"t\", token), ...owner };\n    }\n    return token.then((value) => ({ session: ownerFingerprint(\"t\", value), ...owner }));\n}\n\n/**\n * Report client errors to a Tempest backend's `POST /api/app-errors`, surviving\n * the offline stretches where field errors actually happen.\n *\n * The client half of `tempest-fastapi-sdk`'s `app_errors` module. An error is\n * described ({@link describeAppError}), stamped with the device facts of that\n * moment, fitted to the backend's column limits and queued in `localStorage`\n * before anything goes over the network — so a report raised with no signal is\n * sent when the browser comes back `online`, not lost.\n *\n * What each answer does to the queue:\n *\n * - **2xx** — removed.\n * - **429** — kept; sending pauses for `Retry-After`, then resumes on its own.\n * - **5xx, 408, network failure** — kept; the next report, `online` event or\n *   `flush()` retries.\n * - **any other 4xx** — dropped: the backend will refuse that body forever, and\n *   keeping it would block every report queued behind it.\n *\n * Each report is stamped with a one-way fingerprint of the token in force when\n * it was raised, and goes out with a bearer only when the token at send time is\n * that same one — never with the token of whoever signed in next. The queue\n * never stores a token. `clear()` also stops a flush in flight and discards\n * reports still waiting for an async token.\n *\n * @example\n * import { createAppErrorReporter } from \"tempest-react-sdk\";\n *\n * const reporter = createAppErrorReporter({\n *     endpoint: `${import.meta.env.VITE_API_URL}/api/app-errors`,\n *     getToken: () => sessionStorage.getItem(\"access_token\"),\n *     device: () => ({ platform: \"web\", app_version: \"1.4.0\" }),\n * });\n *\n * reporter.report(new Error(\"crop failed\"), { step: \"crop\", size: 0 });\n *\n * @param options - Endpoint, token and device getters, storage and limits.\n * @returns The reporter.\n */\nexport function createAppErrorReporter(options: CreateAppErrorReporterOptions): AppErrorReporter {\n    const { endpoint, getToken, getPrincipal, device, autoFlush = true } = options;\n    warnOnDropWithoutPrincipal(options);\n    const strict = getPrincipal !== undefined && options.foreignReports === \"drop\";\n    const queue = createAppErrorQueue(\n        options.storage === undefined ? defaultStorage() : options.storage,\n        options.storageKey ?? \"tempest:app-errors\",\n        options.maxEntries ?? 50,\n    );\n    let running: Promise<AppErrorFlushResult> | null = null;\n    let pausedUntil = 0;\n    let timer: ReturnType<typeof setTimeout> | null = null;\n    const stamping = new Set<Promise<void>>();\n    let generation = 0;\n\n    const drain = async (): Promise<AppErrorFlushResult> => {\n        const send = options.fetch ?? globalThis.fetch.bind(globalThis);\n        await Promise.all(stamping);\n        const token = await readToken(getToken);\n        const session = ownerFingerprint(\"t\", token);\n        const current = getPrincipal ? principalOwner(getPrincipal) : null;\n        const started = generation;\n        const result: AppErrorFlushResult = { sent: 0, dropped: 0, pending: 0, retryAfterMs: null };\n        for (const entry of queue.entries()) {\n            if (!queue.has(entry)) continue;\n            if (strict && (entry.owner == null || entry.owner !== current)) {\n                queue.remove(entry);\n                result.dropped += 1;\n                continue;\n            }\n            const bearer = entry.session != null && entry.session === session ? token : null;\n            const outcome = await sendOne(send, endpoint, bearer, entry);\n            if (generation !== started) break;\n            if (outcome.kind === \"stop\") break;\n            if (outcome.kind === \"wait\") {\n                result.retryAfterMs = outcome.ms;\n                pausedUntil = Date.now() + outcome.ms;\n                timer ??= setTimeout(() => {\n                    timer = null;\n                    void flush();\n                }, outcome.ms);\n                break;\n            }\n            queue.remove(entry);\n            result[outcome.kind === \"sent\" ? \"sent\" : \"dropped\"] += 1;\n        }\n        result.pending = queue.entries().length;\n        return result;\n    };\n\n    const flush = (): Promise<AppErrorFlushResult> => {\n        running ??= drain().finally(() => {\n            running = null;\n        });\n        return running;\n    };\n\n    const shouldSend = (): boolean =>\n        autoFlush &&\n        Date.now() >= pausedUntil &&\n        (typeof navigator === \"undefined\" || navigator.onLine !== false);\n\n    const onOnline = (): void => {\n        if (shouldSend()) void flush();\n    };\n    if (autoFlush && typeof window !== \"undefined\") window.addEventListener(\"online\", onOnline);\n\n    return {\n        report(error, context) {\n            const description = describeAppError(error, context);\n            const report = fitAppErrorReport({ ...readDevice(device), ...description });\n            const stamp = stampNow(getPrincipal, readToken(getToken));\n            if (!(stamp instanceof Promise)) {\n                queue.push(report, stamp);\n                if (shouldSend()) void flush();\n                return;\n            }\n            const raisedIn = generation;\n            const stamped = stamp.then((value) => {\n                stamping.delete(stamped);\n                if (generation !== raisedIn) return;\n                queue.push(report, value);\n                if (shouldSend()) void flush();\n            });\n            stamping.add(stamped);\n        },\n        flush,\n        pending: () => queue.entries(),\n        clear() {\n            generation += 1;\n            queue.clear();\n        },\n        dispose() {\n            if (typeof window !== \"undefined\") window.removeEventListener(\"online\", onOnline);\n            if (timer) clearTimeout(timer);\n            timer = null;\n        },\n    };\n}\n"],"mappings":"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"}

package/dist/telemetry/app-error-schema.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-error-schema.cjs","names":[],"sources":["../../src/telemetry/app-error-schema.ts"],"sourcesContent":["/**\n * The client platform an error was reported from.\n *\n * The closed set the backend filters on, mirrored from `tempest-fastapi-sdk`'s\n * `AppPlatform`: an error that only shows up on iOS is not the same bug as one\n * that only shows up on Android, and a PWA reports `\"web\"`.\n */\nexport type AppErrorPlatform = \"ios\" | \"android\" | \"web\" | \"unknown\";\n\n/**\n * Device data travelling with a report — the wire shape of\n * `tempest-fastapi-sdk`'s `AppErrorDeviceSchema`, snake_case included.\n *\n * Every field is optional on purpose: the app sends whatever it managed to\n * collect at the moment of the failure, and requiring any of them would turn an\n * incomplete collection into a lost report.\n */\nexport interface AppErrorDeviceSchema {\n    /** Reporting client's platform. The backend stores `\"unknown\"` when absent. */\n    platform?: AppErrorPlatform;\n    /** Operating system version, e.g. `\"Android 14\"`. */\n    os_version?: string;\n    /** Application version or build — with `code`, the cut that isolates one defect. */\n    app_version?: string;\n    /** Device model, e.g. `\"SM-A105M\"`. */\n    device_model?: string;\n    /** Anonymous device identifier, used to group reports from one device. */\n    device_id?: string;\n}\n\n/**\n * The body of `POST /api/app-errors` — `tempest-fastapi-sdk`'s\n * `AppErrorReportSchema`. There is deliberately no `user_id`: the backend takes\n * it from the bearer token, never from the body, so a client cannot attribute a\n * report to somebody else.\n */\nexport interface AppErrorReportSchema extends AppErrorDeviceSchema {\n    /** Stable error identifier — the first thing anyone groups by. */\n    code: string;\n    /** Message, cause chain, context and stack, as one text. */\n    message: string;\n}\n\n/**\n * Longest `code` the backend column holds.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_CODE_MAX_LENGTH`.\n */\nexport const APP_ERROR_CODE_MAX_LENGTH = 120;\n\n/**\n * Longest `message` the backend keeps.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_MESSAGE_MAX_LENGTH`. The server\n * truncates on its own; cutting here too is what keeps a queue of fifty stack\n * traces from filling `localStorage` while the device is offline.\n */\nexport const APP_ERROR_MESSAGE_MAX_LENGTH = 4000;\n\n/**\n * Longest device text field (`os_version`, `app_version`, …) the backend holds.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_TEXT_FIELD_MAX_LENGTH`.\n */\nexport const APP_ERROR_TEXT_FIELD_MAX_LENGTH = 200;\n\n/**\n * Marker appended where a value was cut.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_TRUNCATION_SUFFIX`, so a report\n * cut on the device reads exactly like one cut by the server.\n */\nexport const APP_ERROR_TRUNCATION_SUFFIX = \"…[truncado]\";\n\n/**\n * Shorten `value` to `limit` characters, marking the cut.\n *\n * Same rule as the backend's `AppErrorService.truncate`: shortened, never\n * refused, because the sender has just failed and has no way to handle a\n * rejection.\n *\n * @param value - The text to fit.\n * @param limit - Maximum length, suffix included.\n * @returns `value` unchanged when it fits, the cut version with the suffix otherwise.\n */\nexport function truncateAppErrorText(value: string, limit: number): string {\n    if (value.length <= limit) return value;\n    const keep = Math.max(limit - APP_ERROR_TRUNCATION_SUFFIX.length, 0);\n    return `${value.slice(0, keep)}${APP_ERROR_TRUNCATION_SUFFIX}`.slice(0, limit);\n}\n\nconst DEVICE_TEXT_FIELDS = [\"os_version\", \"app_version\", \"device_model\", \"device_id\"] as const;\n\n/**\n * Fit every field of a report to the backend's column limits.\n *\n * @param report - The report as built.\n * @returns A copy with `code`, `message` and the device text fields truncated.\n */\nexport function fitAppErrorReport(report: AppErrorReportSchema): AppErrorReportSchema {\n    const fitted: AppErrorReportSchema = {\n        ...report,\n        code: truncateAppErrorText(report.code, APP_ERROR_CODE_MAX_LENGTH),\n        message: truncateAppErrorText(report.message, APP_ERROR_MESSAGE_MAX_LENGTH),\n    };\n    for (const field of DEVICE_TEXT_FIELDS) {\n        const value = fitted[field];\n        if (value !== undefined) {\n            fitted[field] = truncateAppErrorText(value, APP_ERROR_TEXT_FIELD_MAX_LENGTH);\n        }\n    }\n    return fitted;\n}\n"],"mappings":"AAyDA,IAAa,EAA+B,IAe/B,EAA8B,cAa3C,SAAgB,EAAqB,EAAe,EAAuB,CACvE,GAAI,EAAM,QAAU,EAAO,OAAO,EAClC,IAAM,EAAO,KAAK,IAAI,EAAQ,GAAoC,CAAC,EACnE,MAAO,GAAG,EAAM,MAAM,EAAG,CAAI,IAAI,IAA8B,MAAM,EAAG,CAAK,CACjF,CAEA,IAAM,EAAqB,CAAC,aAAc,cAAe,eAAgB,WAAW,EAQpF,SAAgB,EAAkB,EAAoD,CAClF,IAAM,EAA+B,CACjC,GAAG,EACH,KAAM,EAAqB,EAAO,KAAA,GAA+B,EACjE,QAAS,EAAqB,EAAO,QAAS,CAA4B,CAC9E,EACA,IAAK,IAAM,KAAS,EAAoB,CACpC,IAAM,EAAQ,EAAO,GACjB,IAAU,IAAA,KACV,EAAO,GAAS,EAAqB,EAAA,GAAsC,EAEnF,CACA,OAAO,CACX"}
+{"version":3,"file":"app-error-schema.cjs","names":["APP_ERROR_MESSAGE_MAX_LENGTH","APP_ERROR_TRUNCATION_SUFFIX","truncateAppErrorText","value","limit","keep","DEVICE_TEXT_FIELDS","fitAppErrorReport","fitted","report","field"],"sources":["../../src/telemetry/app-error-schema.ts"],"sourcesContent":["/**\n * The client platform an error was reported from.\n *\n * The closed set the backend filters on, mirrored from `tempest-fastapi-sdk`'s\n * `AppPlatform`: an error that only shows up on iOS is not the same bug as one\n * that only shows up on Android, and a PWA reports `\"web\"`.\n */\nexport type AppErrorPlatform = \"ios\" | \"android\" | \"web\" | \"unknown\";\n\n/**\n * Device data travelling with a report — the wire shape of\n * `tempest-fastapi-sdk`'s `AppErrorDeviceSchema`, snake_case included.\n *\n * Every field is optional on purpose: the app sends whatever it managed to\n * collect at the moment of the failure, and requiring any of them would turn an\n * incomplete collection into a lost report.\n */\nexport interface AppErrorDeviceSchema {\n    /** Reporting client's platform. The backend stores `\"unknown\"` when absent. */\n    platform?: AppErrorPlatform;\n    /** Operating system version, e.g. `\"Android 14\"`. */\n    os_version?: string;\n    /** Application version or build — with `code`, the cut that isolates one defect. */\n    app_version?: string;\n    /** Device model, e.g. `\"SM-A105M\"`. */\n    device_model?: string;\n    /** Anonymous device identifier, used to group reports from one device. */\n    device_id?: string;\n}\n\n/**\n * The body of `POST /api/app-errors` — `tempest-fastapi-sdk`'s\n * `AppErrorReportSchema`. There is deliberately no `user_id`: the backend takes\n * it from the bearer token, never from the body, so a client cannot attribute a\n * report to somebody else.\n */\nexport interface AppErrorReportSchema extends AppErrorDeviceSchema {\n    /** Stable error identifier — the first thing anyone groups by. */\n    code: string;\n    /** Message, cause chain, context and stack, as one text. */\n    message: string;\n}\n\n/**\n * Longest `code` the backend column holds.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_CODE_MAX_LENGTH`.\n */\nexport const APP_ERROR_CODE_MAX_LENGTH = 120;\n\n/**\n * Longest `message` the backend keeps.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_MESSAGE_MAX_LENGTH`. The server\n * truncates on its own; cutting here too is what keeps a queue of fifty stack\n * traces from filling `localStorage` while the device is offline.\n */\nexport const APP_ERROR_MESSAGE_MAX_LENGTH = 4000;\n\n/**\n * Longest device text field (`os_version`, `app_version`, …) the backend holds.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_TEXT_FIELD_MAX_LENGTH`.\n */\nexport const APP_ERROR_TEXT_FIELD_MAX_LENGTH = 200;\n\n/**\n * Marker appended where a value was cut.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_TRUNCATION_SUFFIX`, so a report\n * cut on the device reads exactly like one cut by the server.\n */\nexport const APP_ERROR_TRUNCATION_SUFFIX = \"…[truncado]\";\n\n/**\n * Shorten `value` to `limit` characters, marking the cut.\n *\n * Same rule as the backend's `AppErrorService.truncate`: shortened, never\n * refused, because the sender has just failed and has no way to handle a\n * rejection.\n *\n * @param value - The text to fit.\n * @param limit - Maximum length, suffix included.\n * @returns `value` unchanged when it fits, the cut version with the suffix otherwise.\n */\nexport function truncateAppErrorText(value: string, limit: number): string {\n    if (value.length <= limit) return value;\n    const keep = Math.max(limit - APP_ERROR_TRUNCATION_SUFFIX.length, 0);\n    return `${value.slice(0, keep)}${APP_ERROR_TRUNCATION_SUFFIX}`.slice(0, limit);\n}\n\nconst DEVICE_TEXT_FIELDS = [\"os_version\", \"app_version\", \"device_model\", \"device_id\"] as const;\n\n/**\n * Fit every field of a report to the backend's column limits.\n *\n * @param report - The report as built.\n * @returns A copy with `code`, `message` and the device text fields truncated.\n */\nexport function fitAppErrorReport(report: AppErrorReportSchema): AppErrorReportSchema {\n    const fitted: AppErrorReportSchema = {\n        ...report,\n        code: truncateAppErrorText(report.code, APP_ERROR_CODE_MAX_LENGTH),\n        message: truncateAppErrorText(report.message, APP_ERROR_MESSAGE_MAX_LENGTH),\n    };\n    for (const field of DEVICE_TEXT_FIELDS) {\n        const value = fitted[field];\n        if (value !== undefined) {\n            fitted[field] = truncateAppErrorText(value, APP_ERROR_TEXT_FIELD_MAX_LENGTH);\n        }\n    }\n    return fitted;\n}\n"],"mappings":"AAyDA,IAAaA,EAA+B,IAe/BC,EAA8B,cAa3C,SAAgBC,EAAqB,EAAe,EAAuB,CACvE,GAAIC,EAAM,QAAUC,EAAO,OAAOD,EAClC,IAAME,EAAO,KAAK,IAAID,EAAQ,GAAoC,CAAC,EACnE,MAAO,GAAGD,EAAM,MAAM,EAAGE,CAAI,IAAIJ,IAA8B,MAAM,EAAGG,CAAK,CACjF,CAEA,IAAME,EAAqB,CAAC,aAAc,cAAe,eAAgB,WAAW,EAQpF,SAAgBC,EAAkB,EAAoD,CAClF,IAAMC,EAA+B,CACjC,GAAGC,EACH,KAAMP,EAAqBO,EAAO,KAAA,GAA+B,EACjE,QAASP,EAAqBO,EAAO,QAAST,CAA4B,CAC9E,EACA,IAAK,IAAMU,KAASJ,EAAoB,CACpC,IAAMH,EAAQK,EAAOE,GACjBP,IAAU,IAAA,KACV,EAAOO,GAASR,EAAqBC,EAAA,GAAsC,EAEnF,CACA,OAAOK,CACX,C"}

package/dist/telemetry/app-error-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-error-schema.js","names":[],"sources":["../../src/telemetry/app-error-schema.ts"],"sourcesContent":["/**\n * The client platform an error was reported from.\n *\n * The closed set the backend filters on, mirrored from `tempest-fastapi-sdk`'s\n * `AppPlatform`: an error that only shows up on iOS is not the same bug as one\n * that only shows up on Android, and a PWA reports `\"web\"`.\n */\nexport type AppErrorPlatform = \"ios\" | \"android\" | \"web\" | \"unknown\";\n\n/**\n * Device data travelling with a report — the wire shape of\n * `tempest-fastapi-sdk`'s `AppErrorDeviceSchema`, snake_case included.\n *\n * Every field is optional on purpose: the app sends whatever it managed to\n * collect at the moment of the failure, and requiring any of them would turn an\n * incomplete collection into a lost report.\n */\nexport interface AppErrorDeviceSchema {\n    /** Reporting client's platform. The backend stores `\"unknown\"` when absent. */\n    platform?: AppErrorPlatform;\n    /** Operating system version, e.g. `\"Android 14\"`. */\n    os_version?: string;\n    /** Application version or build — with `code`, the cut that isolates one defect. */\n    app_version?: string;\n    /** Device model, e.g. `\"SM-A105M\"`. */\n    device_model?: string;\n    /** Anonymous device identifier, used to group reports from one device. */\n    device_id?: string;\n}\n\n/**\n * The body of `POST /api/app-errors` — `tempest-fastapi-sdk`'s\n * `AppErrorReportSchema`. There is deliberately no `user_id`: the backend takes\n * it from the bearer token, never from the body, so a client cannot attribute a\n * report to somebody else.\n */\nexport interface AppErrorReportSchema extends AppErrorDeviceSchema {\n    /** Stable error identifier — the first thing anyone groups by. */\n    code: string;\n    /** Message, cause chain, context and stack, as one text. */\n    message: string;\n}\n\n/**\n * Longest `code` the backend column holds.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_CODE_MAX_LENGTH`.\n */\nexport const APP_ERROR_CODE_MAX_LENGTH = 120;\n\n/**\n * Longest `message` the backend keeps.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_MESSAGE_MAX_LENGTH`. The server\n * truncates on its own; cutting here too is what keeps a queue of fifty stack\n * traces from filling `localStorage` while the device is offline.\n */\nexport const APP_ERROR_MESSAGE_MAX_LENGTH = 4000;\n\n/**\n * Longest device text field (`os_version`, `app_version`, …) the backend holds.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_TEXT_FIELD_MAX_LENGTH`.\n */\nexport const APP_ERROR_TEXT_FIELD_MAX_LENGTH = 200;\n\n/**\n * Marker appended where a value was cut.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_TRUNCATION_SUFFIX`, so a report\n * cut on the device reads exactly like one cut by the server.\n */\nexport const APP_ERROR_TRUNCATION_SUFFIX = \"…[truncado]\";\n\n/**\n * Shorten `value` to `limit` characters, marking the cut.\n *\n * Same rule as the backend's `AppErrorService.truncate`: shortened, never\n * refused, because the sender has just failed and has no way to handle a\n * rejection.\n *\n * @param value - The text to fit.\n * @param limit - Maximum length, suffix included.\n * @returns `value` unchanged when it fits, the cut version with the suffix otherwise.\n */\nexport function truncateAppErrorText(value: string, limit: number): string {\n    if (value.length <= limit) return value;\n    const keep = Math.max(limit - APP_ERROR_TRUNCATION_SUFFIX.length, 0);\n    return `${value.slice(0, keep)}${APP_ERROR_TRUNCATION_SUFFIX}`.slice(0, limit);\n}\n\nconst DEVICE_TEXT_FIELDS = [\"os_version\", \"app_version\", \"device_model\", \"device_id\"] as const;\n\n/**\n * Fit every field of a report to the backend's column limits.\n *\n * @param report - The report as built.\n * @returns A copy with `code`, `message` and the device text fields truncated.\n */\nexport function fitAppErrorReport(report: AppErrorReportSchema): AppErrorReportSchema {\n    const fitted: AppErrorReportSchema = {\n        ...report,\n        code: truncateAppErrorText(report.code, APP_ERROR_CODE_MAX_LENGTH),\n        message: truncateAppErrorText(report.message, APP_ERROR_MESSAGE_MAX_LENGTH),\n    };\n    for (const field of DEVICE_TEXT_FIELDS) {\n        const value = fitted[field];\n        if (value !== undefined) {\n            fitted[field] = truncateAppErrorText(value, APP_ERROR_TEXT_FIELD_MAX_LENGTH);\n        }\n    }\n    return fitted;\n}\n"],"mappings":"AAyDA,IAAa,IAA+B,KAe/B,IAA8B;AAa3C,SAAgB,EAAqB,GAAe,GAAuB;CACvE,IAAI,EAAM,UAAU,GAAO,OAAO;CAClC,IAAM,IAAO,KAAK,IAAI,IAAQ,IAAoC,CAAC;CACnE,OAAO,GAAG,EAAM,MAAM,GAAG,CAAI,IAAI,IAA8B,MAAM,GAAG,CAAK;AACjF;AAEA,IAAM,IAAqB;CAAC;CAAc;CAAe;CAAgB;AAAW;AAQpF,SAAgB,EAAkB,GAAoD;CAClF,IAAM,IAA+B;EACjC,GAAG;EACH,MAAM,EAAqB,EAAO,MAAA,GAA+B;EACjE,SAAS,EAAqB,EAAO,SAAS,CAA4B;CAC9E;CACA,KAAK,IAAM,KAAS,GAAoB;EACpC,IAAM,IAAQ,EAAO;EACrB,AAAI,MAAU,KAAA,MACV,EAAO,KAAS,EAAqB,GAAA,GAAsC;CAEnF;CACA,OAAO;AACX"}
+{"version":3,"file":"app-error-schema.js","names":["APP_ERROR_MESSAGE_MAX_LENGTH","APP_ERROR_TRUNCATION_SUFFIX","truncateAppErrorText","value","limit","keep","DEVICE_TEXT_FIELDS","fitAppErrorReport","fitted","report","field"],"sources":["../../src/telemetry/app-error-schema.ts"],"sourcesContent":["/**\n * The client platform an error was reported from.\n *\n * The closed set the backend filters on, mirrored from `tempest-fastapi-sdk`'s\n * `AppPlatform`: an error that only shows up on iOS is not the same bug as one\n * that only shows up on Android, and a PWA reports `\"web\"`.\n */\nexport type AppErrorPlatform = \"ios\" | \"android\" | \"web\" | \"unknown\";\n\n/**\n * Device data travelling with a report — the wire shape of\n * `tempest-fastapi-sdk`'s `AppErrorDeviceSchema`, snake_case included.\n *\n * Every field is optional on purpose: the app sends whatever it managed to\n * collect at the moment of the failure, and requiring any of them would turn an\n * incomplete collection into a lost report.\n */\nexport interface AppErrorDeviceSchema {\n    /** Reporting client's platform. The backend stores `\"unknown\"` when absent. */\n    platform?: AppErrorPlatform;\n    /** Operating system version, e.g. `\"Android 14\"`. */\n    os_version?: string;\n    /** Application version or build — with `code`, the cut that isolates one defect. */\n    app_version?: string;\n    /** Device model, e.g. `\"SM-A105M\"`. */\n    device_model?: string;\n    /** Anonymous device identifier, used to group reports from one device. */\n    device_id?: string;\n}\n\n/**\n * The body of `POST /api/app-errors` — `tempest-fastapi-sdk`'s\n * `AppErrorReportSchema`. There is deliberately no `user_id`: the backend takes\n * it from the bearer token, never from the body, so a client cannot attribute a\n * report to somebody else.\n */\nexport interface AppErrorReportSchema extends AppErrorDeviceSchema {\n    /** Stable error identifier — the first thing anyone groups by. */\n    code: string;\n    /** Message, cause chain, context and stack, as one text. */\n    message: string;\n}\n\n/**\n * Longest `code` the backend column holds.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_CODE_MAX_LENGTH`.\n */\nexport const APP_ERROR_CODE_MAX_LENGTH = 120;\n\n/**\n * Longest `message` the backend keeps.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_MESSAGE_MAX_LENGTH`. The server\n * truncates on its own; cutting here too is what keeps a queue of fifty stack\n * traces from filling `localStorage` while the device is offline.\n */\nexport const APP_ERROR_MESSAGE_MAX_LENGTH = 4000;\n\n/**\n * Longest device text field (`os_version`, `app_version`, …) the backend holds.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_TEXT_FIELD_MAX_LENGTH`.\n */\nexport const APP_ERROR_TEXT_FIELD_MAX_LENGTH = 200;\n\n/**\n * Marker appended where a value was cut.\n *\n * Ported from tempest-fastapi-sdk's `APP_ERROR_TRUNCATION_SUFFIX`, so a report\n * cut on the device reads exactly like one cut by the server.\n */\nexport const APP_ERROR_TRUNCATION_SUFFIX = \"…[truncado]\";\n\n/**\n * Shorten `value` to `limit` characters, marking the cut.\n *\n * Same rule as the backend's `AppErrorService.truncate`: shortened, never\n * refused, because the sender has just failed and has no way to handle a\n * rejection.\n *\n * @param value - The text to fit.\n * @param limit - Maximum length, suffix included.\n * @returns `value` unchanged when it fits, the cut version with the suffix otherwise.\n */\nexport function truncateAppErrorText(value: string, limit: number): string {\n    if (value.length <= limit) return value;\n    const keep = Math.max(limit - APP_ERROR_TRUNCATION_SUFFIX.length, 0);\n    return `${value.slice(0, keep)}${APP_ERROR_TRUNCATION_SUFFIX}`.slice(0, limit);\n}\n\nconst DEVICE_TEXT_FIELDS = [\"os_version\", \"app_version\", \"device_model\", \"device_id\"] as const;\n\n/**\n * Fit every field of a report to the backend's column limits.\n *\n * @param report - The report as built.\n * @returns A copy with `code`, `message` and the device text fields truncated.\n */\nexport function fitAppErrorReport(report: AppErrorReportSchema): AppErrorReportSchema {\n    const fitted: AppErrorReportSchema = {\n        ...report,\n        code: truncateAppErrorText(report.code, APP_ERROR_CODE_MAX_LENGTH),\n        message: truncateAppErrorText(report.message, APP_ERROR_MESSAGE_MAX_LENGTH),\n    };\n    for (const field of DEVICE_TEXT_FIELDS) {\n        const value = fitted[field];\n        if (value !== undefined) {\n            fitted[field] = truncateAppErrorText(value, APP_ERROR_TEXT_FIELD_MAX_LENGTH);\n        }\n    }\n    return fitted;\n}\n"],"mappings":"AAyDA,IAAaA,IAA+B,KAe/BC,IAA8B;AAa3C,SAAgBC,EAAqB,GAAe,GAAuB;CACvE,IAAIC,EAAM,UAAUC,GAAO,OAAOD;CAClC,IAAME,IAAO,KAAK,IAAID,IAAQ,IAAoC,CAAC;CACnE,OAAO,GAAGD,EAAM,MAAM,GAAGE,CAAI,IAAIJ,IAA8B,MAAM,GAAGG,CAAK;AACjF;AAEA,IAAME,IAAqB;CAAC;CAAc;CAAe;CAAgB;AAAW;AAQpF,SAAgBC,EAAkB,GAAoD;CAClF,IAAMC,IAA+B;EACjC,GAAGC;EACH,MAAMP,EAAqBO,EAAO,MAAA,GAA+B;EACjE,SAASP,EAAqBO,EAAO,SAAST,CAA4B;CAC9E;CACA,KAAK,IAAMU,KAASJ,GAAoB;EACpC,IAAMH,IAAQK,EAAOE;EACrB,AAAIP,MAAU,KAAA,MACV,EAAOO,KAASR,EAAqBC,GAAA,GAAsC;CAEnF;CACA,OAAOK;AACX"}

package/dist/telemetry/app-error-transport.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-error-transport.cjs","names":[],"sources":["../../src/telemetry/app-error-transport.ts"],"sourcesContent":["import type { AppErrorQueueEntry } from \"./app-error-queue\";\nimport { fitAppErrorReport } from \"./app-error-schema\";\nimport type { AppErrorReportSchema } from \"./app-error-schema\";\n\n/** What the backend's answer to one send means for the queue. */\nexport type SendOutcome = { kind: \"sent\" | \"drop\" | \"stop\" } | { kind: \"wait\"; ms: number };\n\n/**\n * Read a `Retry-After` header as milliseconds.\n *\n * @param header - The header value: delay-seconds or an HTTP date.\n * @returns The delay, at least one second.\n */\nexport function retryAfterMs(header: string | null): number {\n    const seconds = Number(header);\n    if (header !== null && Number.isFinite(seconds)) return Math.max(seconds, 1) * 1000;\n    const date = header ? Date.parse(header) : Number.NaN;\n    return Number.isNaN(date) ? 60_000 : Math.max(date - Date.now(), 1000);\n}\n\n/**\n * Build the body for one queued entry, marking how often it repeated.\n *\n * @param entry - The queued entry.\n * @returns The report to send.\n */\nexport function bodyFor(entry: AppErrorQueueEntry): AppErrorReportSchema {\n    if (entry.count <= 1) return entry.report;\n    const message = `[repeated ${entry.count}×]\\n${entry.report.message}`;\n    return fitAppErrorReport({ ...entry.report, message });\n}\n\n/**\n * Send one entry and classify what the backend answered.\n *\n * @param send - The `fetch` to use.\n * @param endpoint - Route URL.\n * @param token - Bearer token, or `null`.\n * @param entry - What to send.\n * @returns `sent` (2xx), `wait` (429), `drop` (other 4xx) or `stop` (5xx, 408, network).\n *   Anything unexpected — a rejected `fetch`, a wrapper that resolves without a\n *   `Response` — is `stop`: the report stays queued, and the flush that\n *   `report()` fires in the background never becomes an unhandled rejection.\n */\nexport async function sendOne(\n    send: typeof fetch,\n    endpoint: string,\n    token: string | null,\n    entry: AppErrorQueueEntry,\n): Promise<SendOutcome> {\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (token) headers.Authorization = `Bearer ${token}`;\n    try {\n        const response = await send(endpoint, {\n            method: \"POST\",\n            headers,\n            body: JSON.stringify(bodyFor(entry)),\n        });\n        if (response.ok) return { kind: \"sent\" };\n        if (response.status === 429) {\n            return { kind: \"wait\", ms: retryAfterMs(response.headers.get(\"Retry-After\")) };\n        }\n        if (response.status === 408 || response.status >= 500) return { kind: \"stop\" };\n        return { kind: \"drop\" };\n    } catch {\n        return { kind: \"stop\" };\n    }\n}\n\n/**\n * How long a report or a flush waits for an async `getToken` before giving up\n * and going without a token.\n *\n * A getter that never settles — a refresh stuck on a dead network, a promise\n * nobody resolves — must not hold the report out of the queue, nor the flush\n * (and every later one, which shares its run) forever. Five seconds covers a\n * slow refresh round trip on a weak connection; past it the report is stamped\n * with no session and leaves anonymously, which never misattributes.\n */\nexport const APP_ERROR_TOKEN_TIMEOUT_MS = 5_000;\n\n/** The token getter's shape, as {@link readToken} accepts it. */\nexport type AppErrorTokenGetter = () =>\n    string | null | undefined | Promise<string | null | undefined>;\n\n/**\n * Keep only a usable token: a non-empty string.\n *\n * @param value - Whatever the getter produced, possibly from untyped JS.\n * @returns The token, or `null`.\n */\nfunction asToken(value: unknown): string | null {\n    return typeof value === \"string\" && value !== \"\" ? value : null;\n}\n\n/**\n * Read the token, synchronously when the getter is synchronous.\n *\n * Staying synchronous for a synchronous getter is what lets `report()` queue\n * the report before it returns; an async getter is bounded by\n * {@link APP_ERROR_TOKEN_TIMEOUT_MS}. A getter that throws, rejects, times out\n * or produces anything but a non-empty string reads as no token.\n *\n * @param getToken - The caller's token getter.\n * @returns The token or `null`, directly or as a promise that always settles.\n */\nexport function readToken(\n    getToken: AppErrorTokenGetter | undefined,\n): string | null | Promise<string | null> {\n    let value: unknown;\n    try {\n        value = getToken?.();\n    } catch {\n        return null;\n    }\n    if (typeof value !== \"object\" || value === null) return asToken(value);\n    return new Promise<string | null>((resolve) => {\n        const timer = setTimeout(() => resolve(null), APP_ERROR_TOKEN_TIMEOUT_MS);\n        Promise.resolve(value).then(\n            (token) => {\n                clearTimeout(timer);\n                resolve(asToken(token));\n            },\n            () => {\n                clearTimeout(timer);\n                resolve(null);\n            },\n        );\n    });\n}\n"],"mappings":"0CAaA,SAAgB,EAAa,EAA+B,CACxD,IAAM,EAAU,OAAO,CAAM,EAC7B,GAAI,IAAW,MAAQ,OAAO,SAAS,CAAO,EAAG,OAAO,KAAK,IAAI,EAAS,CAAC,EAAI,IAC/E,IAAM,EAAO,EAAS,KAAK,MAAM,CAAM,EAAI,IAC3C,OAAO,OAAO,MAAM,CAAI,EAAI,IAAS,KAAK,IAAI,EAAO,KAAK,IAAI,EAAG,GAAI,CACzE,CAQA,SAAgB,EAAQ,EAAiD,CACrE,GAAI,EAAM,OAAS,EAAG,OAAO,EAAM,OACnC,IAAM,EAAU,aAAa,EAAM,MAAM,MAAM,EAAM,OAAO,UAC5D,OAAO,EAAA,kBAAkB,CAAE,GAAG,EAAM,OAAQ,SAAQ,CAAC,CACzD,CAcA,eAAsB,EAClB,EACA,EACA,EACA,EACoB,CACpB,IAAM,EAAkC,CAAE,eAAgB,kBAAmB,EACzE,IAAO,EAAQ,cAAgB,UAAU,KAC7C,GAAI,CACA,IAAM,EAAW,MAAM,EAAK,EAAU,CAClC,OAAQ,OACR,UACA,KAAM,KAAK,UAAU,EAAQ,CAAK,CAAC,CACvC,CAAC,EAMD,OALI,EAAS,GAAW,CAAE,KAAM,MAAO,EACnC,EAAS,SAAW,IACb,CAAE,KAAM,OAAQ,GAAI,EAAa,EAAS,QAAQ,IAAI,aAAa,CAAC,CAAE,EAE7E,EAAS,SAAW,KAAO,EAAS,QAAU,IAAY,CAAE,KAAM,MAAO,EACtE,CAAE,KAAM,MAAO,CAC1B,MAAQ,CACJ,MAAO,CAAE,KAAM,MAAO,CAC1B,CACJ,CAYA,IAAa,EAA6B,IAY1C,SAAS,EAAQ,EAA+B,CAC5C,OAAO,OAAO,GAAU,UAAY,IAAU,GAAK,EAAQ,IAC/D,CAaA,SAAgB,EACZ,EACsC,CACtC,IAAI,EACJ,GAAI,CACA,EAAQ,IAAW,CACvB,MAAQ,CACJ,OAAO,IACX,CAEA,OADI,OAAO,GAAU,WAAY,EAAuB,EAAQ,CAAK,EAC9D,IAAI,QAAwB,GAAY,CAC3C,IAAM,EAAQ,eAAiB,EAAQ,IAAI,EAAG,CAA0B,EACxE,QAAQ,QAAQ,CAAK,CAAC,CAAC,KAClB,GAAU,CACP,aAAa,CAAK,EAClB,EAAQ,EAAQ,CAAK,CAAC,CAC1B,MACM,CACF,aAAa,CAAK,EAClB,EAAQ,IAAI,CAChB,CACJ,CACJ,CAAC,CACL"}
+{"version":3,"file":"app-error-transport.cjs","names":["fitAppErrorReport","require_app_error_schema","retryAfterMs","seconds","header","date","bodyFor","entry","message","sendOne","headers","token","response","send","endpoint","APP_ERROR_TOKEN_TIMEOUT_MS","asToken","value","readToken","getToken","timer","resolve"],"sources":["../../src/telemetry/app-error-transport.ts"],"sourcesContent":["import type { AppErrorQueueEntry } from \"./app-error-queue\";\nimport { fitAppErrorReport } from \"./app-error-schema\";\nimport type { AppErrorReportSchema } from \"./app-error-schema\";\n\n/** What the backend's answer to one send means for the queue. */\nexport type SendOutcome = { kind: \"sent\" | \"drop\" | \"stop\" } | { kind: \"wait\"; ms: number };\n\n/**\n * Read a `Retry-After` header as milliseconds.\n *\n * @param header - The header value: delay-seconds or an HTTP date.\n * @returns The delay, at least one second.\n */\nexport function retryAfterMs(header: string | null): number {\n    const seconds = Number(header);\n    if (header !== null && Number.isFinite(seconds)) return Math.max(seconds, 1) * 1000;\n    const date = header ? Date.parse(header) : Number.NaN;\n    return Number.isNaN(date) ? 60_000 : Math.max(date - Date.now(), 1000);\n}\n\n/**\n * Build the body for one queued entry, marking how often it repeated.\n *\n * @param entry - The queued entry.\n * @returns The report to send.\n */\nexport function bodyFor(entry: AppErrorQueueEntry): AppErrorReportSchema {\n    if (entry.count <= 1) return entry.report;\n    const message = `[repeated ${entry.count}×]\\n${entry.report.message}`;\n    return fitAppErrorReport({ ...entry.report, message });\n}\n\n/**\n * Send one entry and classify what the backend answered.\n *\n * @param send - The `fetch` to use.\n * @param endpoint - Route URL.\n * @param token - Bearer token, or `null`.\n * @param entry - What to send.\n * @returns `sent` (2xx), `wait` (429), `drop` (other 4xx) or `stop` (5xx, 408, network).\n *   Anything unexpected — a rejected `fetch`, a wrapper that resolves without a\n *   `Response` — is `stop`: the report stays queued, and the flush that\n *   `report()` fires in the background never becomes an unhandled rejection.\n */\nexport async function sendOne(\n    send: typeof fetch,\n    endpoint: string,\n    token: string | null,\n    entry: AppErrorQueueEntry,\n): Promise<SendOutcome> {\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (token) headers.Authorization = `Bearer ${token}`;\n    try {\n        const response = await send(endpoint, {\n            method: \"POST\",\n            headers,\n            body: JSON.stringify(bodyFor(entry)),\n        });\n        if (response.ok) return { kind: \"sent\" };\n        if (response.status === 429) {\n            return { kind: \"wait\", ms: retryAfterMs(response.headers.get(\"Retry-After\")) };\n        }\n        if (response.status === 408 || response.status >= 500) return { kind: \"stop\" };\n        return { kind: \"drop\" };\n    } catch {\n        return { kind: \"stop\" };\n    }\n}\n\n/**\n * How long a report or a flush waits for an async `getToken` before giving up\n * and going without a token.\n *\n * A getter that never settles — a refresh stuck on a dead network, a promise\n * nobody resolves — must not hold the report out of the queue, nor the flush\n * (and every later one, which shares its run) forever. Five seconds covers a\n * slow refresh round trip on a weak connection; past it the report is stamped\n * with no session and leaves anonymously, which never misattributes.\n */\nexport const APP_ERROR_TOKEN_TIMEOUT_MS = 5_000;\n\n/** The token getter's shape, as {@link readToken} accepts it. */\nexport type AppErrorTokenGetter = () =>\n    string | null | undefined | Promise<string | null | undefined>;\n\n/**\n * Keep only a usable token: a non-empty string.\n *\n * @param value - Whatever the getter produced, possibly from untyped JS.\n * @returns The token, or `null`.\n */\nfunction asToken(value: unknown): string | null {\n    return typeof value === \"string\" && value !== \"\" ? value : null;\n}\n\n/**\n * Read the token, synchronously when the getter is synchronous.\n *\n * Staying synchronous for a synchronous getter is what lets `report()` queue\n * the report before it returns; an async getter is bounded by\n * {@link APP_ERROR_TOKEN_TIMEOUT_MS}. A getter that throws, rejects, times out\n * or produces anything but a non-empty string reads as no token.\n *\n * @param getToken - The caller's token getter.\n * @returns The token or `null`, directly or as a promise that always settles.\n */\nexport function readToken(\n    getToken: AppErrorTokenGetter | undefined,\n): string | null | Promise<string | null> {\n    let value: unknown;\n    try {\n        value = getToken?.();\n    } catch {\n        return null;\n    }\n    if (typeof value !== \"object\" || value === null) return asToken(value);\n    return new Promise<string | null>((resolve) => {\n        const timer = setTimeout(() => resolve(null), APP_ERROR_TOKEN_TIMEOUT_MS);\n        Promise.resolve(value).then(\n            (token) => {\n                clearTimeout(timer);\n                resolve(asToken(token));\n            },\n            () => {\n                clearTimeout(timer);\n                resolve(null);\n            },\n        );\n    });\n}\n"],"mappings":"A,0CAaA,SAAgBE,EAAa,EAA+B,CACxD,IAAMC,EAAU,OAAOC,CAAM,EAC7B,GAAIA,IAAW,MAAQ,OAAO,SAASD,CAAO,EAAG,OAAO,KAAK,IAAIA,EAAS,CAAC,EAAI,IAC/E,IAAME,EAAOD,EAAS,KAAK,MAAMA,CAAM,EAAI,IAC3C,OAAO,OAAO,MAAMC,CAAI,EAAI,IAAS,KAAK,IAAIA,EAAO,KAAK,IAAI,EAAG,GAAI,CACzE,CAQA,SAAgBC,EAAQ,EAAiD,CACrE,GAAIC,EAAM,OAAS,EAAG,OAAOA,EAAM,OACnC,IAAMC,EAAU,aAAaD,EAAM,MAAM,MAAMA,EAAM,OAAO,UAC5D,OAAOP,EAAAA,kBAAkB,CAAE,GAAGO,EAAM,OAAQ,SAAQ,CAAC,CACzD,CAcA,eAAsBE,EAClB,EACA,EACA,EACA,EACoB,CACpB,IAAMC,EAAkC,CAAE,eAAgB,kBAAmB,EACzEC,IAAO,EAAQ,cAAgB,UAAUA,KAC7C,GAAI,CACA,IAAMC,EAAW,MAAMC,EAAKC,EAAU,CAClC,OAAQ,OACR,UACA,KAAM,KAAK,UAAUR,EAAQC,CAAK,CAAC,CACvC,CAAC,EAMD,OALIK,EAAS,GAAW,CAAE,KAAM,MAAO,EACnCA,EAAS,SAAW,IACb,CAAE,KAAM,OAAQ,GAAIV,EAAaU,EAAS,QAAQ,IAAI,aAAa,CAAC,CAAE,EAE7EA,EAAS,SAAW,KAAOA,EAAS,QAAU,IAAY,CAAE,KAAM,MAAO,EACtE,CAAE,KAAM,MAAO,CAC1B,MAAQ,CACJ,MAAO,CAAE,KAAM,MAAO,CAC1B,CACJ,CAYA,IAAaG,EAA6B,IAY1C,SAASC,EAAQ,EAA+B,CAC5C,OAAO,OAAOC,GAAU,UAAYA,IAAU,GAAKA,EAAQ,IAC/D,CAaA,SAAgBC,EACZ,EACsC,CACtC,IAAID,EACJ,GAAI,CACA,EAAQE,IAAW,CACvB,MAAQ,CACJ,OAAO,IACX,CAEA,OADI,OAAOF,GAAU,WAAYA,EAAuBD,EAAQC,CAAK,EAC9D,IAAI,QAAwB,GAAY,CAC3C,IAAMG,EAAQ,eAAiBC,EAAQ,IAAI,EAAGN,CAA0B,EACxE,QAAQ,QAAQE,CAAK,CAAC,CAAC,KAClB,GAAU,CACP,aAAaG,CAAK,EAClBC,EAAQL,EAAQL,CAAK,CAAC,CAC1B,MACM,CACF,aAAaS,CAAK,EAClBC,EAAQ,IAAI,CAChB,CACJ,CACJ,CAAC,CACL,C"}

package/dist/telemetry/app-error-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-error-transport.js","names":[],"sources":["../../src/telemetry/app-error-transport.ts"],"sourcesContent":["import type { AppErrorQueueEntry } from \"./app-error-queue\";\nimport { fitAppErrorReport } from \"./app-error-schema\";\nimport type { AppErrorReportSchema } from \"./app-error-schema\";\n\n/** What the backend's answer to one send means for the queue. */\nexport type SendOutcome = { kind: \"sent\" | \"drop\" | \"stop\" } | { kind: \"wait\"; ms: number };\n\n/**\n * Read a `Retry-After` header as milliseconds.\n *\n * @param header - The header value: delay-seconds or an HTTP date.\n * @returns The delay, at least one second.\n */\nexport function retryAfterMs(header: string | null): number {\n    const seconds = Number(header);\n    if (header !== null && Number.isFinite(seconds)) return Math.max(seconds, 1) * 1000;\n    const date = header ? Date.parse(header) : Number.NaN;\n    return Number.isNaN(date) ? 60_000 : Math.max(date - Date.now(), 1000);\n}\n\n/**\n * Build the body for one queued entry, marking how often it repeated.\n *\n * @param entry - The queued entry.\n * @returns The report to send.\n */\nexport function bodyFor(entry: AppErrorQueueEntry): AppErrorReportSchema {\n    if (entry.count <= 1) return entry.report;\n    const message = `[repeated ${entry.count}×]\\n${entry.report.message}`;\n    return fitAppErrorReport({ ...entry.report, message });\n}\n\n/**\n * Send one entry and classify what the backend answered.\n *\n * @param send - The `fetch` to use.\n * @param endpoint - Route URL.\n * @param token - Bearer token, or `null`.\n * @param entry - What to send.\n * @returns `sent` (2xx), `wait` (429), `drop` (other 4xx) or `stop` (5xx, 408, network).\n *   Anything unexpected — a rejected `fetch`, a wrapper that resolves without a\n *   `Response` — is `stop`: the report stays queued, and the flush that\n *   `report()` fires in the background never becomes an unhandled rejection.\n */\nexport async function sendOne(\n    send: typeof fetch,\n    endpoint: string,\n    token: string | null,\n    entry: AppErrorQueueEntry,\n): Promise<SendOutcome> {\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (token) headers.Authorization = `Bearer ${token}`;\n    try {\n        const response = await send(endpoint, {\n            method: \"POST\",\n            headers,\n            body: JSON.stringify(bodyFor(entry)),\n        });\n        if (response.ok) return { kind: \"sent\" };\n        if (response.status === 429) {\n            return { kind: \"wait\", ms: retryAfterMs(response.headers.get(\"Retry-After\")) };\n        }\n        if (response.status === 408 || response.status >= 500) return { kind: \"stop\" };\n        return { kind: \"drop\" };\n    } catch {\n        return { kind: \"stop\" };\n    }\n}\n\n/**\n * How long a report or a flush waits for an async `getToken` before giving up\n * and going without a token.\n *\n * A getter that never settles — a refresh stuck on a dead network, a promise\n * nobody resolves — must not hold the report out of the queue, nor the flush\n * (and every later one, which shares its run) forever. Five seconds covers a\n * slow refresh round trip on a weak connection; past it the report is stamped\n * with no session and leaves anonymously, which never misattributes.\n */\nexport const APP_ERROR_TOKEN_TIMEOUT_MS = 5_000;\n\n/** The token getter's shape, as {@link readToken} accepts it. */\nexport type AppErrorTokenGetter = () =>\n    string | null | undefined | Promise<string | null | undefined>;\n\n/**\n * Keep only a usable token: a non-empty string.\n *\n * @param value - Whatever the getter produced, possibly from untyped JS.\n * @returns The token, or `null`.\n */\nfunction asToken(value: unknown): string | null {\n    return typeof value === \"string\" && value !== \"\" ? value : null;\n}\n\n/**\n * Read the token, synchronously when the getter is synchronous.\n *\n * Staying synchronous for a synchronous getter is what lets `report()` queue\n * the report before it returns; an async getter is bounded by\n * {@link APP_ERROR_TOKEN_TIMEOUT_MS}. A getter that throws, rejects, times out\n * or produces anything but a non-empty string reads as no token.\n *\n * @param getToken - The caller's token getter.\n * @returns The token or `null`, directly or as a promise that always settles.\n */\nexport function readToken(\n    getToken: AppErrorTokenGetter | undefined,\n): string | null | Promise<string | null> {\n    let value: unknown;\n    try {\n        value = getToken?.();\n    } catch {\n        return null;\n    }\n    if (typeof value !== \"object\" || value === null) return asToken(value);\n    return new Promise<string | null>((resolve) => {\n        const timer = setTimeout(() => resolve(null), APP_ERROR_TOKEN_TIMEOUT_MS);\n        Promise.resolve(value).then(\n            (token) => {\n                clearTimeout(timer);\n                resolve(asToken(token));\n            },\n            () => {\n                clearTimeout(timer);\n                resolve(null);\n            },\n        );\n    });\n}\n"],"mappings":";;AAaA,SAAgB,EAAa,GAA+B;CACxD,IAAM,IAAU,OAAO,CAAM;CAC7B,IAAI,MAAW,QAAQ,OAAO,SAAS,CAAO,GAAG,OAAO,KAAK,IAAI,GAAS,CAAC,IAAI;CAC/E,IAAM,IAAO,IAAS,KAAK,MAAM,CAAM,IAAI;CAC3C,OAAO,OAAO,MAAM,CAAI,IAAI,MAAS,KAAK,IAAI,IAAO,KAAK,IAAI,GAAG,GAAI;AACzE;AAQA,SAAgB,EAAQ,GAAiD;CACrE,IAAI,EAAM,SAAS,GAAG,OAAO,EAAM;CACnC,IAAM,IAAU,aAAa,EAAM,MAAM,MAAM,EAAM,OAAO;CAC5D,OAAO,EAAkB;EAAE,GAAG,EAAM;EAAQ;CAAQ,CAAC;AACzD;AAcA,eAAsB,EAClB,GACA,GACA,GACA,GACoB;CACpB,IAAM,IAAkC,EAAE,gBAAgB,mBAAmB;CAC7E,AAAI,MAAO,EAAQ,gBAAgB,UAAU;CAC7C,IAAI;EACA,IAAM,IAAW,MAAM,EAAK,GAAU;GAClC,QAAQ;GACR;GACA,MAAM,KAAK,UAAU,EAAQ,CAAK,CAAC;EACvC,CAAC;EAMD,OALI,EAAS,KAAW,EAAE,MAAM,OAAO,IACnC,EAAS,WAAW,MACb;GAAE,MAAM;GAAQ,IAAI,EAAa,EAAS,QAAQ,IAAI,aAAa,CAAC;EAAE,IAE7E,EAAS,WAAW,OAAO,EAAS,UAAU,MAAY,EAAE,MAAM,OAAO,IACtE,EAAE,MAAM,OAAO;CAC1B,QAAQ;EACJ,OAAO,EAAE,MAAM,OAAO;CAC1B;AACJ;AAYA,IAAa,IAA6B;AAY1C,SAAS,EAAQ,GAA+B;CAC5C,OAAO,OAAO,KAAU,YAAY,MAAU,KAAK,IAAQ;AAC/D;AAaA,SAAgB,EACZ,GACsC;CACtC,IAAI;CACJ,IAAI;EACA,IAAQ,IAAW;CACvB,QAAQ;EACJ,OAAO;CACX;CAEA,OADI,OAAO,KAAU,aAAY,IAAuB,EAAQ,CAAK,IAC9D,IAAI,SAAwB,MAAY;EAC3C,IAAM,IAAQ,iBAAiB,EAAQ,IAAI,GAAG,CAA0B;EACxE,QAAQ,QAAQ,CAAK,CAAC,CAAC,MAClB,MAAU;GAEP,AADA,aAAa,CAAK,GAClB,EAAQ,EAAQ,CAAK,CAAC;EAC1B,SACM;GAEF,AADA,aAAa,CAAK,GAClB,EAAQ,IAAI;EAChB,CACJ;CACJ,CAAC;AACL"}
+{"version":3,"file":"app-error-transport.js","names":["retryAfterMs","seconds","header","date","bodyFor","entry","message","fitAppErrorReport","sendOne","headers","token","response","send","endpoint","APP_ERROR_TOKEN_TIMEOUT_MS","asToken","value","readToken","getToken","timer","resolve"],"sources":["../../src/telemetry/app-error-transport.ts"],"sourcesContent":["import type { AppErrorQueueEntry } from \"./app-error-queue\";\nimport { fitAppErrorReport } from \"./app-error-schema\";\nimport type { AppErrorReportSchema } from \"./app-error-schema\";\n\n/** What the backend's answer to one send means for the queue. */\nexport type SendOutcome = { kind: \"sent\" | \"drop\" | \"stop\" } | { kind: \"wait\"; ms: number };\n\n/**\n * Read a `Retry-After` header as milliseconds.\n *\n * @param header - The header value: delay-seconds or an HTTP date.\n * @returns The delay, at least one second.\n */\nexport function retryAfterMs(header: string | null): number {\n    const seconds = Number(header);\n    if (header !== null && Number.isFinite(seconds)) return Math.max(seconds, 1) * 1000;\n    const date = header ? Date.parse(header) : Number.NaN;\n    return Number.isNaN(date) ? 60_000 : Math.max(date - Date.now(), 1000);\n}\n\n/**\n * Build the body for one queued entry, marking how often it repeated.\n *\n * @param entry - The queued entry.\n * @returns The report to send.\n */\nexport function bodyFor(entry: AppErrorQueueEntry): AppErrorReportSchema {\n    if (entry.count <= 1) return entry.report;\n    const message = `[repeated ${entry.count}×]\\n${entry.report.message}`;\n    return fitAppErrorReport({ ...entry.report, message });\n}\n\n/**\n * Send one entry and classify what the backend answered.\n *\n * @param send - The `fetch` to use.\n * @param endpoint - Route URL.\n * @param token - Bearer token, or `null`.\n * @param entry - What to send.\n * @returns `sent` (2xx), `wait` (429), `drop` (other 4xx) or `stop` (5xx, 408, network).\n *   Anything unexpected — a rejected `fetch`, a wrapper that resolves without a\n *   `Response` — is `stop`: the report stays queued, and the flush that\n *   `report()` fires in the background never becomes an unhandled rejection.\n */\nexport async function sendOne(\n    send: typeof fetch,\n    endpoint: string,\n    token: string | null,\n    entry: AppErrorQueueEntry,\n): Promise<SendOutcome> {\n    const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (token) headers.Authorization = `Bearer ${token}`;\n    try {\n        const response = await send(endpoint, {\n            method: \"POST\",\n            headers,\n            body: JSON.stringify(bodyFor(entry)),\n        });\n        if (response.ok) return { kind: \"sent\" };\n        if (response.status === 429) {\n            return { kind: \"wait\", ms: retryAfterMs(response.headers.get(\"Retry-After\")) };\n        }\n        if (response.status === 408 || response.status >= 500) return { kind: \"stop\" };\n        return { kind: \"drop\" };\n    } catch {\n        return { kind: \"stop\" };\n    }\n}\n\n/**\n * How long a report or a flush waits for an async `getToken` before giving up\n * and going without a token.\n *\n * A getter that never settles — a refresh stuck on a dead network, a promise\n * nobody resolves — must not hold the report out of the queue, nor the flush\n * (and every later one, which shares its run) forever. Five seconds covers a\n * slow refresh round trip on a weak connection; past it the report is stamped\n * with no session and leaves anonymously, which never misattributes.\n */\nexport const APP_ERROR_TOKEN_TIMEOUT_MS = 5_000;\n\n/** The token getter's shape, as {@link readToken} accepts it. */\nexport type AppErrorTokenGetter = () =>\n    string | null | undefined | Promise<string | null | undefined>;\n\n/**\n * Keep only a usable token: a non-empty string.\n *\n * @param value - Whatever the getter produced, possibly from untyped JS.\n * @returns The token, or `null`.\n */\nfunction asToken(value: unknown): string | null {\n    return typeof value === \"string\" && value !== \"\" ? value : null;\n}\n\n/**\n * Read the token, synchronously when the getter is synchronous.\n *\n * Staying synchronous for a synchronous getter is what lets `report()` queue\n * the report before it returns; an async getter is bounded by\n * {@link APP_ERROR_TOKEN_TIMEOUT_MS}. A getter that throws, rejects, times out\n * or produces anything but a non-empty string reads as no token.\n *\n * @param getToken - The caller's token getter.\n * @returns The token or `null`, directly or as a promise that always settles.\n */\nexport function readToken(\n    getToken: AppErrorTokenGetter | undefined,\n): string | null | Promise<string | null> {\n    let value: unknown;\n    try {\n        value = getToken?.();\n    } catch {\n        return null;\n    }\n    if (typeof value !== \"object\" || value === null) return asToken(value);\n    return new Promise<string | null>((resolve) => {\n        const timer = setTimeout(() => resolve(null), APP_ERROR_TOKEN_TIMEOUT_MS);\n        Promise.resolve(value).then(\n            (token) => {\n                clearTimeout(timer);\n                resolve(asToken(token));\n            },\n            () => {\n                clearTimeout(timer);\n                resolve(null);\n            },\n        );\n    });\n}\n"],"mappings":";;AAaA,SAAgBA,EAAa,GAA+B;CACxD,IAAMC,IAAU,OAAOC,CAAM;CAC7B,IAAIA,MAAW,QAAQ,OAAO,SAASD,CAAO,GAAG,OAAO,KAAK,IAAIA,GAAS,CAAC,IAAI;CAC/E,IAAME,IAAOD,IAAS,KAAK,MAAMA,CAAM,IAAI;CAC3C,OAAO,OAAO,MAAMC,CAAI,IAAI,MAAS,KAAK,IAAIA,IAAO,KAAK,IAAI,GAAG,GAAI;AACzE;AAQA,SAAgBC,EAAQ,GAAiD;CACrE,IAAIC,EAAM,SAAS,GAAG,OAAOA,EAAM;CACnC,IAAMC,IAAU,aAAaD,EAAM,MAAM,MAAMA,EAAM,OAAO;CAC5D,OAAOE,EAAkB;EAAE,GAAGF,EAAM;EAAQ;CAAQ,CAAC;AACzD;AAcA,eAAsBG,EAClB,GACA,GACA,GACA,GACoB;CACpB,IAAMC,IAAkC,EAAE,gBAAgB,mBAAmB;CAC7E,AAAIC,MAAO,EAAQ,gBAAgB,UAAUA;CAC7C,IAAI;EACA,IAAMC,IAAW,MAAMC,EAAKC,GAAU;GAClC,QAAQ;GACR;GACA,MAAM,KAAK,UAAUT,EAAQC,CAAK,CAAC;EACvC,CAAC;EAMD,OALIM,EAAS,KAAW,EAAE,MAAM,OAAO,IACnCA,EAAS,WAAW,MACb;GAAE,MAAM;GAAQ,IAAIX,EAAaW,EAAS,QAAQ,IAAI,aAAa,CAAC;EAAE,IAE7EA,EAAS,WAAW,OAAOA,EAAS,UAAU,MAAY,EAAE,MAAM,OAAO,IACtE,EAAE,MAAM,OAAO;CAC1B,QAAQ;EACJ,OAAO,EAAE,MAAM,OAAO;CAC1B;AACJ;AAYA,IAAaG,IAA6B;AAY1C,SAASC,EAAQ,GAA+B;CAC5C,OAAO,OAAOC,KAAU,YAAYA,MAAU,KAAKA,IAAQ;AAC/D;AAaA,SAAgBC,EACZ,GACsC;CACtC,IAAID;CACJ,IAAI;EACA,IAAQE,IAAW;CACvB,QAAQ;EACJ,OAAO;CACX;CAEA,OADI,OAAOF,KAAU,aAAYA,IAAuBD,EAAQC,CAAK,IAC9D,IAAI,SAAwB,MAAY;EAC3C,IAAMG,IAAQ,iBAAiBC,EAAQ,IAAI,GAAGN,CAA0B;EACxE,QAAQ,QAAQE,CAAK,CAAC,CAAC,MAClB,MAAU;GAEP,AADA,aAAaG,CAAK,GAClBC,EAAQL,EAAQL,CAAK,CAAC;EAC1B,SACM;GAEF,AADA,aAAaS,CAAK,GAClBC,EAAQ,IAAI;EAChB,CACJ;CACJ,CAAC;AACL"}

package/dist/telemetry/console-adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"console-adapter.cjs","names":[],"sources":["../../src/telemetry/console-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter } from \"./types\";\n\n/**\n * Dev-friendly adapter that logs every call to `console`. Use as a default\n * before plugging the real provider (Sentry / Datadog / PostHog).\n */\nexport const consoleTelemetryAdapter: TelemetryAdapter = {\n    identify(user) {\n        console.info(\"[telemetry] identify\", user);\n    },\n    track(event) {\n        console.info(\"[telemetry] track\", event.name, event.properties);\n    },\n    captureException(error, context) {\n        console.error(\"[telemetry] exception\", error, context);\n    },\n};\n"],"mappings":"AAMA,IAAa,EAA4C,CACrD,SAAS,EAAM,CACX,QAAQ,KAAK,uBAAwB,CAAI,CAC7C,EACA,MAAM,EAAO,CACT,QAAQ,KAAK,oBAAqB,EAAM,KAAM,EAAM,UAAU,CAClE,EACA,iBAAiB,EAAO,EAAS,CAC7B,QAAQ,MAAM,wBAAyB,EAAO,CAAO,CACzD,CACJ"}
+{"version":3,"file":"console-adapter.cjs","names":["consoleTelemetryAdapter","user","event","error","context"],"sources":["../../src/telemetry/console-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter } from \"./types\";\n\n/**\n * Dev-friendly adapter that logs every call to `console`. Use as a default\n * before plugging the real provider (Sentry / Datadog / PostHog).\n */\nexport const consoleTelemetryAdapter: TelemetryAdapter = {\n    identify(user) {\n        console.info(\"[telemetry] identify\", user);\n    },\n    track(event) {\n        console.info(\"[telemetry] track\", event.name, event.properties);\n    },\n    captureException(error, context) {\n        console.error(\"[telemetry] exception\", error, context);\n    },\n};\n"],"mappings":"AAMA,IAAaA,EAA4C,CACrD,SAAS,EAAM,CACX,QAAQ,KAAK,uBAAwBC,CAAI,CAC7C,EACA,MAAM,EAAO,CACT,QAAQ,KAAK,oBAAqBC,EAAM,KAAMA,EAAM,UAAU,CAClE,EACA,iBAAiB,EAAO,EAAS,CAC7B,QAAQ,MAAM,wBAAyBC,EAAOC,CAAO,CACzD,CACJ,E"}

package/dist/telemetry/console-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"console-adapter.js","names":[],"sources":["../../src/telemetry/console-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter } from \"./types\";\n\n/**\n * Dev-friendly adapter that logs every call to `console`. Use as a default\n * before plugging the real provider (Sentry / Datadog / PostHog).\n */\nexport const consoleTelemetryAdapter: TelemetryAdapter = {\n    identify(user) {\n        console.info(\"[telemetry] identify\", user);\n    },\n    track(event) {\n        console.info(\"[telemetry] track\", event.name, event.properties);\n    },\n    captureException(error, context) {\n        console.error(\"[telemetry] exception\", error, context);\n    },\n};\n"],"mappings":";AAMA,IAAa,IAA4C;CACrD,SAAS,GAAM;EACX,QAAQ,KAAK,wBAAwB,CAAI;CAC7C;CACA,MAAM,GAAO;EACT,QAAQ,KAAK,qBAAqB,EAAM,MAAM,EAAM,UAAU;CAClE;CACA,iBAAiB,GAAO,GAAS;EAC7B,QAAQ,MAAM,yBAAyB,GAAO,CAAO;CACzD;AACJ"}
+{"version":3,"file":"console-adapter.js","names":["consoleTelemetryAdapter","user","event","error","context"],"sources":["../../src/telemetry/console-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter } from \"./types\";\n\n/**\n * Dev-friendly adapter that logs every call to `console`. Use as a default\n * before plugging the real provider (Sentry / Datadog / PostHog).\n */\nexport const consoleTelemetryAdapter: TelemetryAdapter = {\n    identify(user) {\n        console.info(\"[telemetry] identify\", user);\n    },\n    track(event) {\n        console.info(\"[telemetry] track\", event.name, event.properties);\n    },\n    captureException(error, context) {\n        console.error(\"[telemetry] exception\", error, context);\n    },\n};\n"],"mappings":";AAMA,IAAaA,IAA4C;CACrD,SAAS,GAAM;EACX,QAAQ,KAAK,wBAAwBC,CAAI;CAC7C;CACA,MAAM,GAAO;EACT,QAAQ,KAAK,qBAAqBC,EAAM,MAAMA,EAAM,UAAU;CAClE;CACA,iBAAiB,GAAO,GAAS;EAC7B,QAAQ,MAAM,yBAAyBC,GAAOC,CAAO;CACzD;AACJ"}

package/dist/telemetry/describe-app-error.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"describe-app-error.cjs","names":[],"sources":["../../src/telemetry/describe-app-error.ts"],"sourcesContent":["/** How deep the `cause` chain is followed before the rest is elided. */\nconst MAX_CAUSE_DEPTH = 5;\n\n/**\n * The `code` and `message` a thrown value becomes on the wire.\n */\nexport interface AppErrorDescription {\n    /** The error's `name` — `\"UnreadableFileError\"`, `\"TypeError\"` — or `\"Error\"`. */\n    code: string;\n    /** Header, cause chain, context and stack, in that order. */\n    message: string;\n}\n\n/** The shape every thrown error shares, whichever realm built it. */\ninterface ErrorLike {\n    name?: unknown;\n    message: string;\n    stack?: unknown;\n    cause?: unknown;\n}\n\n/**\n * Whether a value carries an error's `message`, `instanceof` or not.\n *\n * `instanceof Error` is not enough: a `DOMException` — the `NotReadableError`\n * a picker raises for a file that only lives in the cloud — fails it in jsdom\n * and across realms, and was being rendered as `{}`, losing exactly the cause\n * a field report exists to carry.\n *\n * @param value - The thrown value.\n * @returns `true` for anything with a string `message`.\n */\nfunction isErrorLike(value: unknown): value is ErrorLike {\n    return (\n        value instanceof Error ||\n        (typeof value === \"object\" &&\n            value !== null &&\n            typeof (value as { message?: unknown }).message === \"string\")\n    );\n}\n\n/**\n * The identifier a thrown value reports as, including a `DOMException`, which\n * is not always an `Error` instance across realms.\n *\n * @param value - The thrown value.\n * @returns Its `name`, or `\"Error\"`.\n */\nfunction nameOf(value: unknown): string {\n    if (value instanceof Error && value.name) return value.name;\n    if (typeof value === \"object\" && value !== null && \"name\" in value) {\n        const name = (value as { name: unknown }).name;\n        if (typeof name === \"string\" && name) return name;\n    }\n    return \"Error\";\n}\n\n/**\n * One line naming the value: `Name: message` for an error.\n *\n * @param value - The thrown value or a cause.\n * @returns The line.\n */\nfunction headline(value: unknown): string {\n    if (isErrorLike(value)) return `${nameOf(value)}: ${value.message}`;\n    if (typeof value === \"string\") return value;\n    try {\n        return JSON.stringify(value) ?? String(value);\n    } catch {\n        return String(value);\n    }\n}\n\n/**\n * Follow `error.cause` into one line per link, bounded and cycle-safe.\n *\n * @param error - The top-level error.\n * @returns `caused by: …` lines, outermost first.\n */\nfunction causeLines(error: unknown): string[] {\n    const lines: string[] = [];\n    const seen = new Set<unknown>([error]);\n    let current: unknown = isErrorLike(error) ? error.cause : undefined;\n    while (current !== undefined && current !== null) {\n        if (seen.has(current)) {\n            lines.push(\"caused by: [circular]\");\n            break;\n        }\n        if (lines.length === MAX_CAUSE_DEPTH) {\n            lines.push(\"caused by: […]\");\n            break;\n        }\n        seen.add(current);\n        lines.push(`caused by: ${headline(current)}`);\n        current = isErrorLike(current) ? current.cause : undefined;\n    }\n    return lines;\n}\n\n/**\n * Render the caller's context as one JSON line.\n *\n * @param context - Extra facts, or nothing.\n * @returns The line, or `null` when there is no context.\n */\nfunction contextLine(context: Record<string, unknown> | undefined): string | null {\n    if (!context || Object.keys(context).length === 0) return null;\n    try {\n        return `context: ${JSON.stringify(context)}`;\n    } catch {\n        return \"context: [unserializable]\";\n    }\n}\n\n/**\n * Turn any thrown value into the `code` + `message` pair the backend stores.\n *\n * The message is ordered by how much each part is worth when the backend cuts\n * it at 4000 characters: the headline, then the **`cause` chain** — where the\n * real failure usually is (`UnreadableFileError` caused by `NotReadableError`)\n * — then the caller's context, and the stack last, since it is the longest and\n * the first thing worth losing.\n *\n * @example\n * describeAppError(new Error(\"boom\", { cause: new TypeError(\"x\") }), { step: \"crop\" });\n * // { code: \"Error\", message: \"Error: boom\\ncaused by: TypeError: x\\ncontext: {\\\"step\\\":\\\"crop\\\"}\\n…\" }\n *\n * @param error - Whatever was thrown — an `Error`, a `DOMException`, a string.\n * @param context - Extra facts to keep with it (file size, MIME, step).\n * @returns The wire `code` and `message`.\n */\nexport function describeAppError(\n    error: unknown,\n    context?: Record<string, unknown>,\n): AppErrorDescription {\n    const parts: string[] = [headline(error), ...causeLines(error)];\n    const ctx = contextLine(context);\n    if (ctx) parts.push(ctx);\n    if (isErrorLike(error) && typeof error.stack === \"string\") parts.push(error.stack);\n    return { code: nameOf(error), message: parts.join(\"\\n\") };\n}\n"],"mappings":"AAgCA,SAAS,EAAY,EAAoC,CACrD,OACI,aAAiB,OAChB,OAAO,GAAU,YACd,GACA,OAAQ,EAAgC,SAAY,QAEhE,CASA,SAAS,EAAO,EAAwB,CACpC,GAAI,aAAiB,OAAS,EAAM,KAAM,OAAO,EAAM,KACvD,GAAI,OAAO,GAAU,UAAY,GAAkB,SAAU,EAAO,CAChE,IAAM,EAAQ,EAA4B,KAC1C,GAAI,OAAO,GAAS,UAAY,EAAM,OAAO,CACjD,CACA,MAAO,OACX,CAQA,SAAS,EAAS,EAAwB,CACtC,GAAI,EAAY,CAAK,EAAG,MAAO,GAAG,EAAO,CAAK,EAAE,IAAI,EAAM,UAC1D,GAAI,OAAO,GAAU,SAAU,OAAO,EACtC,GAAI,CACA,OAAO,KAAK,UAAU,CAAK,GAAK,OAAO,CAAK,CAChD,MAAQ,CACJ,OAAO,OAAO,CAAK,CACvB,CACJ,CAQA,SAAS,EAAW,EAA0B,CAC1C,IAAM,EAAkB,CAAC,EACnB,EAAO,IAAI,IAAa,CAAC,CAAK,CAAC,EACjC,EAAmB,EAAY,CAAK,EAAI,EAAM,MAAQ,IAAA,GAC1D,KAAO,GAAqC,MAAM,CAC9C,GAAI,EAAK,IAAI,CAAO,EAAG,CACnB,EAAM,KAAK,uBAAuB,EAClC,KACJ,CACA,GAAI,EAAM,SAAW,EAAiB,CAClC,EAAM,KAAK,gBAAgB,EAC3B,KACJ,CACA,EAAK,IAAI,CAAO,EAChB,EAAM,KAAK,cAAc,EAAS,CAAO,GAAG,EAC5C,EAAU,EAAY,CAAO,EAAI,EAAQ,MAAQ,IAAA,EACrD,CACA,OAAO,CACX,CAQA,SAAS,EAAY,EAA6D,CAC9E,GAAI,CAAC,GAAW,OAAO,KAAK,CAAO,CAAC,CAAC,SAAW,EAAG,OAAO,KAC1D,GAAI,CACA,MAAO,YAAY,KAAK,UAAU,CAAO,GAC7C,MAAQ,CACJ,MAAO,2BACX,CACJ,CAmBA,SAAgB,EACZ,EACA,EACmB,CACnB,IAAM,EAAkB,CAAC,EAAS,CAAK,EAAG,GAAG,EAAW,CAAK,CAAC,EACxD,EAAM,EAAY,CAAO,EAG/B,OAFI,GAAK,EAAM,KAAK,CAAG,EACnB,EAAY,CAAK,GAAK,OAAO,EAAM,OAAU,UAAU,EAAM,KAAK,EAAM,KAAK,EAC1E,CAAE,KAAM,EAAO,CAAK,EAAG,QAAS,EAAM,KAAK;CAAI,CAAE,CAC5D"}
+{"version":3,"file":"describe-app-error.cjs","names":["isErrorLike","value","nameOf","name","headline","causeLines","lines","seen","error","current","contextLine","context","describeAppError","parts","ctx"],"sources":["../../src/telemetry/describe-app-error.ts"],"sourcesContent":["/** How deep the `cause` chain is followed before the rest is elided. */\nconst MAX_CAUSE_DEPTH = 5;\n\n/**\n * The `code` and `message` a thrown value becomes on the wire.\n */\nexport interface AppErrorDescription {\n    /** The error's `name` — `\"UnreadableFileError\"`, `\"TypeError\"` — or `\"Error\"`. */\n    code: string;\n    /** Header, cause chain, context and stack, in that order. */\n    message: string;\n}\n\n/** The shape every thrown error shares, whichever realm built it. */\ninterface ErrorLike {\n    name?: unknown;\n    message: string;\n    stack?: unknown;\n    cause?: unknown;\n}\n\n/**\n * Whether a value carries an error's `message`, `instanceof` or not.\n *\n * `instanceof Error` is not enough: a `DOMException` — the `NotReadableError`\n * a picker raises for a file that only lives in the cloud — fails it in jsdom\n * and across realms, and was being rendered as `{}`, losing exactly the cause\n * a field report exists to carry.\n *\n * @param value - The thrown value.\n * @returns `true` for anything with a string `message`.\n */\nfunction isErrorLike(value: unknown): value is ErrorLike {\n    return (\n        value instanceof Error ||\n        (typeof value === \"object\" &&\n            value !== null &&\n            typeof (value as { message?: unknown }).message === \"string\")\n    );\n}\n\n/**\n * The identifier a thrown value reports as, including a `DOMException`, which\n * is not always an `Error` instance across realms.\n *\n * @param value - The thrown value.\n * @returns Its `name`, or `\"Error\"`.\n */\nfunction nameOf(value: unknown): string {\n    if (value instanceof Error && value.name) return value.name;\n    if (typeof value === \"object\" && value !== null && \"name\" in value) {\n        const name = (value as { name: unknown }).name;\n        if (typeof name === \"string\" && name) return name;\n    }\n    return \"Error\";\n}\n\n/**\n * One line naming the value: `Name: message` for an error.\n *\n * @param value - The thrown value or a cause.\n * @returns The line.\n */\nfunction headline(value: unknown): string {\n    if (isErrorLike(value)) return `${nameOf(value)}: ${value.message}`;\n    if (typeof value === \"string\") return value;\n    try {\n        return JSON.stringify(value) ?? String(value);\n    } catch {\n        return String(value);\n    }\n}\n\n/**\n * Follow `error.cause` into one line per link, bounded and cycle-safe.\n *\n * @param error - The top-level error.\n * @returns `caused by: …` lines, outermost first.\n */\nfunction causeLines(error: unknown): string[] {\n    const lines: string[] = [];\n    const seen = new Set<unknown>([error]);\n    let current: unknown = isErrorLike(error) ? error.cause : undefined;\n    while (current !== undefined && current !== null) {\n        if (seen.has(current)) {\n            lines.push(\"caused by: [circular]\");\n            break;\n        }\n        if (lines.length === MAX_CAUSE_DEPTH) {\n            lines.push(\"caused by: […]\");\n            break;\n        }\n        seen.add(current);\n        lines.push(`caused by: ${headline(current)}`);\n        current = isErrorLike(current) ? current.cause : undefined;\n    }\n    return lines;\n}\n\n/**\n * Render the caller's context as one JSON line.\n *\n * @param context - Extra facts, or nothing.\n * @returns The line, or `null` when there is no context.\n */\nfunction contextLine(context: Record<string, unknown> | undefined): string | null {\n    if (!context || Object.keys(context).length === 0) return null;\n    try {\n        return `context: ${JSON.stringify(context)}`;\n    } catch {\n        return \"context: [unserializable]\";\n    }\n}\n\n/**\n * Turn any thrown value into the `code` + `message` pair the backend stores.\n *\n * The message is ordered by how much each part is worth when the backend cuts\n * it at 4000 characters: the headline, then the **`cause` chain** — where the\n * real failure usually is (`UnreadableFileError` caused by `NotReadableError`)\n * — then the caller's context, and the stack last, since it is the longest and\n * the first thing worth losing.\n *\n * @example\n * describeAppError(new Error(\"boom\", { cause: new TypeError(\"x\") }), { step: \"crop\" });\n * // { code: \"Error\", message: \"Error: boom\\ncaused by: TypeError: x\\ncontext: {\\\"step\\\":\\\"crop\\\"}\\n…\" }\n *\n * @param error - Whatever was thrown — an `Error`, a `DOMException`, a string.\n * @param context - Extra facts to keep with it (file size, MIME, step).\n * @returns The wire `code` and `message`.\n */\nexport function describeAppError(\n    error: unknown,\n    context?: Record<string, unknown>,\n): AppErrorDescription {\n    const parts: string[] = [headline(error), ...causeLines(error)];\n    const ctx = contextLine(context);\n    if (ctx) parts.push(ctx);\n    if (isErrorLike(error) && typeof error.stack === \"string\") parts.push(error.stack);\n    return { code: nameOf(error), message: parts.join(\"\\n\") };\n}\n"],"mappings":"AAgCA,SAASA,EAAY,EAAoC,CACrD,OACIC,aAAiB,OAChB,OAAOA,GAAU,YACdA,GACA,OAAQA,EAAgC,SAAY,QAEhE,CASA,SAASC,EAAO,EAAwB,CACpC,GAAID,aAAiB,OAASA,EAAM,KAAM,OAAOA,EAAM,KACvD,GAAI,OAAOA,GAAU,UAAYA,GAAkB,SAAUA,EAAO,CAChE,IAAME,EAAQF,EAA4B,KAC1C,GAAI,OAAOE,GAAS,UAAYA,EAAM,OAAOA,CACjD,CACA,MAAO,OACX,CAQA,SAASC,EAAS,EAAwB,CACtC,GAAIJ,EAAYC,CAAK,EAAG,MAAO,GAAGC,EAAOD,CAAK,EAAE,IAAIA,EAAM,UAC1D,GAAI,OAAOA,GAAU,SAAU,OAAOA,EACtC,GAAI,CACA,OAAO,KAAK,UAAUA,CAAK,GAAK,OAAOA,CAAK,CAChD,MAAQ,CACJ,OAAO,OAAOA,CAAK,CACvB,CACJ,CAQA,SAASI,EAAW,EAA0B,CAC1C,IAAMC,EAAkB,CAAC,EACnBC,EAAO,IAAI,IAAa,CAACC,CAAK,CAAC,EACjCC,EAAmBT,EAAYQ,CAAK,EAAIA,EAAM,MAAQ,IAAA,GAC1D,KAAOC,GAAqC,MAAM,CAC9C,GAAIF,EAAK,IAAIE,CAAO,EAAG,CACnBH,EAAM,KAAK,uBAAuB,EAClC,KACJ,CACA,GAAIA,EAAM,SAAW,EAAiB,CAClCA,EAAM,KAAK,gBAAgB,EAC3B,KACJ,CACAC,EAAK,IAAIE,CAAO,EAChBH,EAAM,KAAK,cAAcF,EAASK,CAAO,GAAG,EAC5C,EAAUT,EAAYS,CAAO,EAAIA,EAAQ,MAAQ,IAAA,EACrD,CACA,OAAOH,CACX,CAQA,SAASI,EAAY,EAA6D,CAC9E,GAAI,CAACC,GAAW,OAAO,KAAKA,CAAO,CAAC,CAAC,SAAW,EAAG,OAAO,KAC1D,GAAI,CACA,MAAO,YAAY,KAAK,UAAUA,CAAO,GAC7C,MAAQ,CACJ,MAAO,2BACX,CACJ,CAmBA,SAAgBC,EACZ,EACA,EACmB,CACnB,IAAMC,EAAkB,CAACT,EAASI,CAAK,EAAG,GAAGH,EAAWG,CAAK,CAAC,EACxDM,EAAMJ,EAAYC,CAAO,EAG/B,OAFIG,GAAKD,EAAM,KAAKC,CAAG,EACnBd,EAAYQ,CAAK,GAAK,OAAOA,EAAM,OAAU,UAAUK,EAAM,KAAKL,EAAM,KAAK,EAC1E,CAAE,KAAMN,EAAOM,CAAK,EAAG,QAASK,EAAM,KAAK;CAAI,CAAE,CAC5D,C"}

package/dist/telemetry/describe-app-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe-app-error.js","names":[],"sources":["../../src/telemetry/describe-app-error.ts"],"sourcesContent":["/** How deep the `cause` chain is followed before the rest is elided. */\nconst MAX_CAUSE_DEPTH = 5;\n\n/**\n * The `code` and `message` a thrown value becomes on the wire.\n */\nexport interface AppErrorDescription {\n    /** The error's `name` — `\"UnreadableFileError\"`, `\"TypeError\"` — or `\"Error\"`. */\n    code: string;\n    /** Header, cause chain, context and stack, in that order. */\n    message: string;\n}\n\n/** The shape every thrown error shares, whichever realm built it. */\ninterface ErrorLike {\n    name?: unknown;\n    message: string;\n    stack?: unknown;\n    cause?: unknown;\n}\n\n/**\n * Whether a value carries an error's `message`, `instanceof` or not.\n *\n * `instanceof Error` is not enough: a `DOMException` — the `NotReadableError`\n * a picker raises for a file that only lives in the cloud — fails it in jsdom\n * and across realms, and was being rendered as `{}`, losing exactly the cause\n * a field report exists to carry.\n *\n * @param value - The thrown value.\n * @returns `true` for anything with a string `message`.\n */\nfunction isErrorLike(value: unknown): value is ErrorLike {\n    return (\n        value instanceof Error ||\n        (typeof value === \"object\" &&\n            value !== null &&\n            typeof (value as { message?: unknown }).message === \"string\")\n    );\n}\n\n/**\n * The identifier a thrown value reports as, including a `DOMException`, which\n * is not always an `Error` instance across realms.\n *\n * @param value - The thrown value.\n * @returns Its `name`, or `\"Error\"`.\n */\nfunction nameOf(value: unknown): string {\n    if (value instanceof Error && value.name) return value.name;\n    if (typeof value === \"object\" && value !== null && \"name\" in value) {\n        const name = (value as { name: unknown }).name;\n        if (typeof name === \"string\" && name) return name;\n    }\n    return \"Error\";\n}\n\n/**\n * One line naming the value: `Name: message` for an error.\n *\n * @param value - The thrown value or a cause.\n * @returns The line.\n */\nfunction headline(value: unknown): string {\n    if (isErrorLike(value)) return `${nameOf(value)}: ${value.message}`;\n    if (typeof value === \"string\") return value;\n    try {\n        return JSON.stringify(value) ?? String(value);\n    } catch {\n        return String(value);\n    }\n}\n\n/**\n * Follow `error.cause` into one line per link, bounded and cycle-safe.\n *\n * @param error - The top-level error.\n * @returns `caused by: …` lines, outermost first.\n */\nfunction causeLines(error: unknown): string[] {\n    const lines: string[] = [];\n    const seen = new Set<unknown>([error]);\n    let current: unknown = isErrorLike(error) ? error.cause : undefined;\n    while (current !== undefined && current !== null) {\n        if (seen.has(current)) {\n            lines.push(\"caused by: [circular]\");\n            break;\n        }\n        if (lines.length === MAX_CAUSE_DEPTH) {\n            lines.push(\"caused by: […]\");\n            break;\n        }\n        seen.add(current);\n        lines.push(`caused by: ${headline(current)}`);\n        current = isErrorLike(current) ? current.cause : undefined;\n    }\n    return lines;\n}\n\n/**\n * Render the caller's context as one JSON line.\n *\n * @param context - Extra facts, or nothing.\n * @returns The line, or `null` when there is no context.\n */\nfunction contextLine(context: Record<string, unknown> | undefined): string | null {\n    if (!context || Object.keys(context).length === 0) return null;\n    try {\n        return `context: ${JSON.stringify(context)}`;\n    } catch {\n        return \"context: [unserializable]\";\n    }\n}\n\n/**\n * Turn any thrown value into the `code` + `message` pair the backend stores.\n *\n * The message is ordered by how much each part is worth when the backend cuts\n * it at 4000 characters: the headline, then the **`cause` chain** — where the\n * real failure usually is (`UnreadableFileError` caused by `NotReadableError`)\n * — then the caller's context, and the stack last, since it is the longest and\n * the first thing worth losing.\n *\n * @example\n * describeAppError(new Error(\"boom\", { cause: new TypeError(\"x\") }), { step: \"crop\" });\n * // { code: \"Error\", message: \"Error: boom\\ncaused by: TypeError: x\\ncontext: {\\\"step\\\":\\\"crop\\\"}\\n…\" }\n *\n * @param error - Whatever was thrown — an `Error`, a `DOMException`, a string.\n * @param context - Extra facts to keep with it (file size, MIME, step).\n * @returns The wire `code` and `message`.\n */\nexport function describeAppError(\n    error: unknown,\n    context?: Record<string, unknown>,\n): AppErrorDescription {\n    const parts: string[] = [headline(error), ...causeLines(error)];\n    const ctx = contextLine(context);\n    if (ctx) parts.push(ctx);\n    if (isErrorLike(error) && typeof error.stack === \"string\") parts.push(error.stack);\n    return { code: nameOf(error), message: parts.join(\"\\n\") };\n}\n"],"mappings":"AAgCA,SAAS,EAAY,GAAoC;CACrD,OACI,aAAiB,SAChB,OAAO,KAAU,cACd,KACA,OAAQ,EAAgC,WAAY;AAEhE;AASA,SAAS,EAAO,GAAwB;CACpC,IAAI,aAAiB,SAAS,EAAM,MAAM,OAAO,EAAM;CACvD,IAAI,OAAO,KAAU,YAAY,KAAkB,UAAU,GAAO;EAChE,IAAM,IAAQ,EAA4B;EAC1C,IAAI,OAAO,KAAS,YAAY,GAAM,OAAO;CACjD;CACA,OAAO;AACX;AAQA,SAAS,EAAS,GAAwB;CACtC,IAAI,EAAY,CAAK,GAAG,OAAO,GAAG,EAAO,CAAK,EAAE,IAAI,EAAM;CAC1D,IAAI,OAAO,KAAU,UAAU,OAAO;CACtC,IAAI;EACA,OAAO,KAAK,UAAU,CAAK,KAAK,OAAO,CAAK;CAChD,QAAQ;EACJ,OAAO,OAAO,CAAK;CACvB;AACJ;AAQA,SAAS,EAAW,GAA0B;CAC1C,IAAM,IAAkB,CAAC,GACnB,oBAAO,IAAI,IAAa,CAAC,CAAK,CAAC,GACjC,IAAmB,EAAY,CAAK,IAAI,EAAM,QAAQ,KAAA;CAC1D,OAAO,KAAqC,OAAM;EAC9C,IAAI,EAAK,IAAI,CAAO,GAAG;GACnB,EAAM,KAAK,uBAAuB;GAClC;EACJ;EACA,IAAI,EAAM,WAAW,GAAiB;GAClC,EAAM,KAAK,gBAAgB;GAC3B;EACJ;EAGA,AAFA,EAAK,IAAI,CAAO,GAChB,EAAM,KAAK,cAAc,EAAS,CAAO,GAAG,GAC5C,IAAU,EAAY,CAAO,IAAI,EAAQ,QAAQ,KAAA;CACrD;CACA,OAAO;AACX;AAQA,SAAS,EAAY,GAA6D;CAC9E,IAAI,CAAC,KAAW,OAAO,KAAK,CAAO,CAAC,CAAC,WAAW,GAAG,OAAO;CAC1D,IAAI;EACA,OAAO,YAAY,KAAK,UAAU,CAAO;CAC7C,QAAQ;EACJ,OAAO;CACX;AACJ;AAmBA,SAAgB,EACZ,GACA,GACmB;CACnB,IAAM,IAAkB,CAAC,EAAS,CAAK,GAAG,GAAG,EAAW,CAAK,CAAC,GACxD,IAAM,EAAY,CAAO;CAG/B,OAFI,KAAK,EAAM,KAAK,CAAG,GACnB,EAAY,CAAK,KAAK,OAAO,EAAM,SAAU,YAAU,EAAM,KAAK,EAAM,KAAK,GAC1E;EAAE,MAAM,EAAO,CAAK;EAAG,SAAS,EAAM,KAAK,IAAI;CAAE;AAC5D"}
+{"version":3,"file":"describe-app-error.js","names":["isErrorLike","value","nameOf","name","headline","causeLines","lines","seen","error","current","contextLine","context","describeAppError","parts","ctx"],"sources":["../../src/telemetry/describe-app-error.ts"],"sourcesContent":["/** How deep the `cause` chain is followed before the rest is elided. */\nconst MAX_CAUSE_DEPTH = 5;\n\n/**\n * The `code` and `message` a thrown value becomes on the wire.\n */\nexport interface AppErrorDescription {\n    /** The error's `name` — `\"UnreadableFileError\"`, `\"TypeError\"` — or `\"Error\"`. */\n    code: string;\n    /** Header, cause chain, context and stack, in that order. */\n    message: string;\n}\n\n/** The shape every thrown error shares, whichever realm built it. */\ninterface ErrorLike {\n    name?: unknown;\n    message: string;\n    stack?: unknown;\n    cause?: unknown;\n}\n\n/**\n * Whether a value carries an error's `message`, `instanceof` or not.\n *\n * `instanceof Error` is not enough: a `DOMException` — the `NotReadableError`\n * a picker raises for a file that only lives in the cloud — fails it in jsdom\n * and across realms, and was being rendered as `{}`, losing exactly the cause\n * a field report exists to carry.\n *\n * @param value - The thrown value.\n * @returns `true` for anything with a string `message`.\n */\nfunction isErrorLike(value: unknown): value is ErrorLike {\n    return (\n        value instanceof Error ||\n        (typeof value === \"object\" &&\n            value !== null &&\n            typeof (value as { message?: unknown }).message === \"string\")\n    );\n}\n\n/**\n * The identifier a thrown value reports as, including a `DOMException`, which\n * is not always an `Error` instance across realms.\n *\n * @param value - The thrown value.\n * @returns Its `name`, or `\"Error\"`.\n */\nfunction nameOf(value: unknown): string {\n    if (value instanceof Error && value.name) return value.name;\n    if (typeof value === \"object\" && value !== null && \"name\" in value) {\n        const name = (value as { name: unknown }).name;\n        if (typeof name === \"string\" && name) return name;\n    }\n    return \"Error\";\n}\n\n/**\n * One line naming the value: `Name: message` for an error.\n *\n * @param value - The thrown value or a cause.\n * @returns The line.\n */\nfunction headline(value: unknown): string {\n    if (isErrorLike(value)) return `${nameOf(value)}: ${value.message}`;\n    if (typeof value === \"string\") return value;\n    try {\n        return JSON.stringify(value) ?? String(value);\n    } catch {\n        return String(value);\n    }\n}\n\n/**\n * Follow `error.cause` into one line per link, bounded and cycle-safe.\n *\n * @param error - The top-level error.\n * @returns `caused by: …` lines, outermost first.\n */\nfunction causeLines(error: unknown): string[] {\n    const lines: string[] = [];\n    const seen = new Set<unknown>([error]);\n    let current: unknown = isErrorLike(error) ? error.cause : undefined;\n    while (current !== undefined && current !== null) {\n        if (seen.has(current)) {\n            lines.push(\"caused by: [circular]\");\n            break;\n        }\n        if (lines.length === MAX_CAUSE_DEPTH) {\n            lines.push(\"caused by: […]\");\n            break;\n        }\n        seen.add(current);\n        lines.push(`caused by: ${headline(current)}`);\n        current = isErrorLike(current) ? current.cause : undefined;\n    }\n    return lines;\n}\n\n/**\n * Render the caller's context as one JSON line.\n *\n * @param context - Extra facts, or nothing.\n * @returns The line, or `null` when there is no context.\n */\nfunction contextLine(context: Record<string, unknown> | undefined): string | null {\n    if (!context || Object.keys(context).length === 0) return null;\n    try {\n        return `context: ${JSON.stringify(context)}`;\n    } catch {\n        return \"context: [unserializable]\";\n    }\n}\n\n/**\n * Turn any thrown value into the `code` + `message` pair the backend stores.\n *\n * The message is ordered by how much each part is worth when the backend cuts\n * it at 4000 characters: the headline, then the **`cause` chain** — where the\n * real failure usually is (`UnreadableFileError` caused by `NotReadableError`)\n * — then the caller's context, and the stack last, since it is the longest and\n * the first thing worth losing.\n *\n * @example\n * describeAppError(new Error(\"boom\", { cause: new TypeError(\"x\") }), { step: \"crop\" });\n * // { code: \"Error\", message: \"Error: boom\\ncaused by: TypeError: x\\ncontext: {\\\"step\\\":\\\"crop\\\"}\\n…\" }\n *\n * @param error - Whatever was thrown — an `Error`, a `DOMException`, a string.\n * @param context - Extra facts to keep with it (file size, MIME, step).\n * @returns The wire `code` and `message`.\n */\nexport function describeAppError(\n    error: unknown,\n    context?: Record<string, unknown>,\n): AppErrorDescription {\n    const parts: string[] = [headline(error), ...causeLines(error)];\n    const ctx = contextLine(context);\n    if (ctx) parts.push(ctx);\n    if (isErrorLike(error) && typeof error.stack === \"string\") parts.push(error.stack);\n    return { code: nameOf(error), message: parts.join(\"\\n\") };\n}\n"],"mappings":"AAgCA,SAASA,EAAY,GAAoC;CACrD,OACIC,aAAiB,SAChB,OAAOA,KAAU,cACdA,KACA,OAAQA,EAAgC,WAAY;AAEhE;AASA,SAASC,EAAO,GAAwB;CACpC,IAAID,aAAiB,SAASA,EAAM,MAAM,OAAOA,EAAM;CACvD,IAAI,OAAOA,KAAU,YAAYA,KAAkB,UAAUA,GAAO;EAChE,IAAME,IAAQF,EAA4B;EAC1C,IAAI,OAAOE,KAAS,YAAYA,GAAM,OAAOA;CACjD;CACA,OAAO;AACX;AAQA,SAASC,EAAS,GAAwB;CACtC,IAAIJ,EAAYC,CAAK,GAAG,OAAO,GAAGC,EAAOD,CAAK,EAAE,IAAIA,EAAM;CAC1D,IAAI,OAAOA,KAAU,UAAU,OAAOA;CACtC,IAAI;EACA,OAAO,KAAK,UAAUA,CAAK,KAAK,OAAOA,CAAK;CAChD,QAAQ;EACJ,OAAO,OAAOA,CAAK;CACvB;AACJ;AAQA,SAASI,EAAW,GAA0B;CAC1C,IAAMC,IAAkB,CAAC,GACnBC,oBAAO,IAAI,IAAa,CAACC,CAAK,CAAC,GACjCC,IAAmBT,EAAYQ,CAAK,IAAIA,EAAM,QAAQ,KAAA;CAC1D,OAAOC,KAAqC,OAAM;EAC9C,IAAIF,EAAK,IAAIE,CAAO,GAAG;GACnB,EAAM,KAAK,uBAAuB;GAClC;EACJ;EACA,IAAIH,EAAM,WAAW,GAAiB;GAClC,EAAM,KAAK,gBAAgB;GAC3B;EACJ;EAGA,AAFAC,EAAK,IAAIE,CAAO,GAChBH,EAAM,KAAK,cAAcF,EAASK,CAAO,GAAG,GAC5C,IAAUT,EAAYS,CAAO,IAAIA,EAAQ,QAAQ,KAAA;CACrD;CACA,OAAOH;AACX;AAQA,SAASI,EAAY,GAA6D;CAC9E,IAAI,CAACC,KAAW,OAAO,KAAKA,CAAO,CAAC,CAAC,WAAW,GAAG,OAAO;CAC1D,IAAI;EACA,OAAO,YAAY,KAAK,UAAUA,CAAO;CAC7C,QAAQ;EACJ,OAAO;CACX;AACJ;AAmBA,SAAgBC,EACZ,GACA,GACmB;CACnB,IAAMC,IAAkB,CAACT,EAASI,CAAK,GAAG,GAAGH,EAAWG,CAAK,CAAC,GACxDM,IAAMJ,EAAYC,CAAO;CAG/B,OAFIG,KAAKD,EAAM,KAAKC,CAAG,GACnBd,EAAYQ,CAAK,KAAK,OAAOA,EAAM,SAAU,YAAUK,EAAM,KAAKL,EAAM,KAAK,GAC1E;EAAE,MAAMN,EAAOM,CAAK;EAAG,SAASK,EAAM,KAAK,IAAI;CAAE;AAC5D"}

package/dist/telemetry/posthog-adapter.cjs

@@ -1,2 +1,2 @@
-function e(e){let{email:t,name:n,traits:r}=e;return{...t===void 0?null:{email:t},...n===void 0?null:{name:n},...r??null}}function t(t){let{posthog:n,init:r}=t;return{init(){r&&n.init&&n.init(r.apiKey,r.options)},identify(t){if(t===null){n.reset?.();return}t.id!==void 0&&n.identify(t.id,e(t))},track(e){n.capture(e.name,e.properties)},captureException(e,t){if(n.captureException){n.captureException(e,t);return}let r=e instanceof Error?e:Error(String(e));n.capture(`$exception`,{$exception_message:r.message,$exception_type:r.name,$exception_stack_trace_raw:r.stack,...t})}}}exports.createPostHogTelemetryAdapter=t;
+function e(e){let{email:t,name:n,traits:r}=e;return{...t===void 0?null:{email:t},...n===void 0?null:{name:n},...r??null}}function t(t){let{posthog:n,init:r}=t;return{init(){r&&n.init&&n.init(r.apiKey,r.options)},identify(t){t===null?n.reset?.():t.id!==void 0&&n.identify(t.id,e(t))},track(e){n.capture(e.name,e.properties)},captureException(e,t){if(n.captureException){n.captureException(e,t);return}let r=e instanceof Error?e:Error(String(e));n.capture(`$exception`,{$exception_message:r.message,$exception_type:r.name,$exception_stack_trace_raw:r.stack,...t})}}}exports.createPostHogTelemetryAdapter=t;
 //# sourceMappingURL=posthog-adapter.cjs.map

package/dist/telemetry/posthog-adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"posthog-adapter.cjs","names":[],"sources":["../../src/telemetry/posthog-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter, TelemetryEvent, TelemetryUser } from \"./types\";\n\n/**\n * Minimal subset of `posthog-js` used by the adapter. Pass either the real\n * default export (`import posthog from \"posthog-js\"`) or a stubbed object\n * in tests.\n */\nexport interface PostHogLike {\n    init?: (apiKey: string, options?: Record<string, unknown>) => void;\n    identify: (distinctId: string, properties?: Record<string, unknown>) => void;\n    capture: (eventName: string, properties?: Record<string, unknown>) => void;\n    captureException?: (error: unknown, properties?: Record<string, unknown>) => void;\n    reset?: () => void;\n}\n\nexport interface CreatePostHogTelemetryAdapterOptions {\n    /** The PostHog JS client (the default export of `posthog-js`). Required. */\n    posthog: PostHogLike;\n    /** Project API key + options. When provided, `Provider.init` calls `posthog.init(apiKey, options)`. */\n    init?: { apiKey: string; options?: Record<string, unknown> };\n}\n\nfunction userToProperties(user: TelemetryUser): Record<string, unknown> {\n    const { email, name, traits } = user;\n    return {\n        ...(email !== undefined ? { email } : null),\n        ...(name !== undefined ? { name } : null),\n        ...(traits ?? null),\n    };\n}\n\n/**\n * Build a [[TelemetryAdapter]] backed by [`posthog-js`](https://posthog.com/docs/libraries/js).\n * The PostHog client is supplied by the caller (not bundled).\n *\n * Mapping:\n * - `identify(user)` → `posthog.identify(user.id, { email, name, ...traits })` (or `posthog.reset()` when `null`)\n * - `track({ name, properties })` → `posthog.capture(name, properties)`\n * - `captureException(err, ctx)` → `posthog.captureException(err, ctx)` when available, otherwise `posthog.capture(\"$exception\", { …err, …ctx })`\n * - `flush()` → no-op (PostHog batches automatically)\n *\n * @example\n * import posthog from \"posthog-js\";\n * import { createPostHogTelemetryAdapter, TelemetryProvider } from \"tempest-react-sdk\";\n *\n * const adapter = createPostHogTelemetryAdapter({\n *     posthog,\n *     init: { apiKey: import.meta.env.VITE_POSTHOG_KEY, options: { api_host: \"https://us.i.posthog.com\" } },\n * });\n *\n * <TelemetryProvider adapter={adapter}><App /></TelemetryProvider>;\n */\nexport function createPostHogTelemetryAdapter(\n    options: CreatePostHogTelemetryAdapterOptions,\n): TelemetryAdapter {\n    const { posthog, init } = options;\n\n    return {\n        init() {\n            if (init && posthog.init) {\n                posthog.init(init.apiKey, init.options);\n            }\n        },\n        identify(user: TelemetryUser | null) {\n            if (user === null) {\n                posthog.reset?.();\n                return;\n            }\n            if (user.id === undefined) return;\n            posthog.identify(user.id, userToProperties(user));\n        },\n        track(event: TelemetryEvent) {\n            posthog.capture(event.name, event.properties);\n        },\n        captureException(error: unknown, context?: Record<string, unknown>) {\n            if (posthog.captureException) {\n                posthog.captureException(error, context);\n                return;\n            }\n            const err = error instanceof Error ? error : new Error(String(error));\n            posthog.capture(\"$exception\", {\n                $exception_message: err.message,\n                $exception_type: err.name,\n                $exception_stack_trace_raw: err.stack,\n                ...context,\n            });\n        },\n    };\n}\n"],"mappings":"AAsBA,SAAS,EAAiB,EAA8C,CACpE,GAAM,CAAE,QAAO,OAAM,UAAW,EAChC,MAAO,CACH,GAAI,IAAU,IAAA,GAAwB,KAAZ,CAAE,OAAM,EAClC,GAAI,IAAS,IAAA,GAAuB,KAAX,CAAE,MAAK,EAChC,GAAI,GAAU,IAClB,CACJ,CAuBA,SAAgB,EACZ,EACgB,CAChB,GAAM,CAAE,UAAS,QAAS,EAE1B,MAAO,CACH,MAAO,CACC,GAAQ,EAAQ,MAChB,EAAQ,KAAK,EAAK,OAAQ,EAAK,OAAO,CAE9C,EACA,SAAS,EAA4B,CACjC,GAAI,IAAS,KAAM,CACf,EAAQ,QAAQ,EAChB,MACJ,CACI,EAAK,KAAO,IAAA,IAChB,EAAQ,SAAS,EAAK,GAAI,EAAiB,CAAI,CAAC,CACpD,EACA,MAAM,EAAuB,CACzB,EAAQ,QAAQ,EAAM,KAAM,EAAM,UAAU,CAChD,EACA,iBAAiB,EAAgB,EAAmC,CAChE,GAAI,EAAQ,iBAAkB,CAC1B,EAAQ,iBAAiB,EAAO,CAAO,EACvC,MACJ,CACA,IAAM,EAAM,aAAiB,MAAQ,EAAY,MAAM,OAAO,CAAK,CAAC,EACpE,EAAQ,QAAQ,aAAc,CAC1B,mBAAoB,EAAI,QACxB,gBAAiB,EAAI,KACrB,2BAA4B,EAAI,MAChC,GAAG,CACP,CAAC,CACL,CACJ,CACJ"}
+{"version":3,"file":"posthog-adapter.cjs","names":["userToProperties","user","email","name","traits","createPostHogTelemetryAdapter","options","init","posthog","event","error","context","err"],"sources":["../../src/telemetry/posthog-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter, TelemetryEvent, TelemetryUser } from \"./types\";\n\n/**\n * Minimal subset of `posthog-js` used by the adapter. Pass either the real\n * default export (`import posthog from \"posthog-js\"`) or a stubbed object\n * in tests.\n */\nexport interface PostHogLike {\n    init?: (apiKey: string, options?: Record<string, unknown>) => void;\n    identify: (distinctId: string, properties?: Record<string, unknown>) => void;\n    capture: (eventName: string, properties?: Record<string, unknown>) => void;\n    captureException?: (error: unknown, properties?: Record<string, unknown>) => void;\n    reset?: () => void;\n}\n\nexport interface CreatePostHogTelemetryAdapterOptions {\n    /** The PostHog JS client (the default export of `posthog-js`). Required. */\n    posthog: PostHogLike;\n    /** Project API key + options. When provided, `Provider.init` calls `posthog.init(apiKey, options)`. */\n    init?: { apiKey: string; options?: Record<string, unknown> };\n}\n\nfunction userToProperties(user: TelemetryUser): Record<string, unknown> {\n    const { email, name, traits } = user;\n    return {\n        ...(email !== undefined ? { email } : null),\n        ...(name !== undefined ? { name } : null),\n        ...(traits ?? null),\n    };\n}\n\n/**\n * Build a [[TelemetryAdapter]] backed by [`posthog-js`](https://posthog.com/docs/libraries/js).\n * The PostHog client is supplied by the caller (not bundled).\n *\n * Mapping:\n * - `identify(user)` → `posthog.identify(user.id, { email, name, ...traits })` (or `posthog.reset()` when `null`)\n * - `track({ name, properties })` → `posthog.capture(name, properties)`\n * - `captureException(err, ctx)` → `posthog.captureException(err, ctx)` when available, otherwise `posthog.capture(\"$exception\", { …err, …ctx })`\n * - `flush()` → no-op (PostHog batches automatically)\n *\n * @example\n * import posthog from \"posthog-js\";\n * import { createPostHogTelemetryAdapter, TelemetryProvider } from \"tempest-react-sdk\";\n *\n * const adapter = createPostHogTelemetryAdapter({\n *     posthog,\n *     init: { apiKey: import.meta.env.VITE_POSTHOG_KEY, options: { api_host: \"https://us.i.posthog.com\" } },\n * });\n *\n * <TelemetryProvider adapter={adapter}><App /></TelemetryProvider>;\n */\nexport function createPostHogTelemetryAdapter(\n    options: CreatePostHogTelemetryAdapterOptions,\n): TelemetryAdapter {\n    const { posthog, init } = options;\n\n    return {\n        init() {\n            if (init && posthog.init) {\n                posthog.init(init.apiKey, init.options);\n            }\n        },\n        identify(user: TelemetryUser | null) {\n            if (user === null) {\n                posthog.reset?.();\n                return;\n            }\n            if (user.id === undefined) return;\n            posthog.identify(user.id, userToProperties(user));\n        },\n        track(event: TelemetryEvent) {\n            posthog.capture(event.name, event.properties);\n        },\n        captureException(error: unknown, context?: Record<string, unknown>) {\n            if (posthog.captureException) {\n                posthog.captureException(error, context);\n                return;\n            }\n            const err = error instanceof Error ? error : new Error(String(error));\n            posthog.capture(\"$exception\", {\n                $exception_message: err.message,\n                $exception_type: err.name,\n                $exception_stack_trace_raw: err.stack,\n                ...context,\n            });\n        },\n    };\n}\n"],"mappings":"AAsBA,SAASA,EAAiB,EAA8C,CACpE,GAAM,CAAE,QAAO,OAAM,UAAWC,EAChC,MAAO,CACH,GAAIC,IAAU,IAAA,GAAwB,KAAZ,CAAE,OAAM,EAClC,GAAIC,IAAS,IAAA,GAAuB,KAAX,CAAE,MAAK,EAChC,GAAIC,GAAU,IAClB,CACJ,CAuBA,SAAgBC,EACZ,EACgB,CAChB,GAAM,CAAE,UAAS,QAASC,EAE1B,MAAO,CACH,MAAO,CACCC,GAAQC,EAAQ,MAChBA,EAAQ,KAAKD,EAAK,OAAQA,EAAK,OAAO,CAE9C,EACA,SAAS,EAA4B,CAC7BN,IAAS,KACTO,EAAQ,QAAQ,EAGhBP,EAAK,KAAO,IAAA,IAChBO,EAAQ,SAASP,EAAK,GAAID,EAAiBC,CAAI,CAAC,CACpD,EACA,MAAM,EAAuB,CACzBO,EAAQ,QAAQC,EAAM,KAAMA,EAAM,UAAU,CAChD,EACA,iBAAiB,EAAgB,EAAmC,CAChE,GAAID,EAAQ,iBAAkB,CAC1BA,EAAQ,iBAAiBE,EAAOC,CAAO,EACvC,MACJ,CACA,IAAMC,EAAMF,aAAiB,MAAQA,EAAY,MAAM,OAAOA,CAAK,CAAC,EACpEF,EAAQ,QAAQ,aAAc,CAC1B,mBAAoBI,EAAI,QACxB,gBAAiBA,EAAI,KACrB,2BAA4BA,EAAI,MAChC,GAAGD,CACP,CAAC,CACL,CACJ,CACJ,C"}

package/dist/telemetry/posthog-adapter.js

@@ -14,11 +14,7 @@ function t(t) {
 			r && n.init && n.init(r.apiKey, r.options);
 		},
 		identify(t) {
-			if (t === null) {
-				n.reset?.();
-				return;
-			}
-			t.id !== void 0 && n.identify(t.id, e(t));
+			t === null ? n.reset?.() : t.id !== void 0 && n.identify(t.id, e(t));
 		},
 		track(e) {
 			n.capture(e.name, e.properties);

package/dist/telemetry/posthog-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"posthog-adapter.js","names":[],"sources":["../../src/telemetry/posthog-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter, TelemetryEvent, TelemetryUser } from \"./types\";\n\n/**\n * Minimal subset of `posthog-js` used by the adapter. Pass either the real\n * default export (`import posthog from \"posthog-js\"`) or a stubbed object\n * in tests.\n */\nexport interface PostHogLike {\n    init?: (apiKey: string, options?: Record<string, unknown>) => void;\n    identify: (distinctId: string, properties?: Record<string, unknown>) => void;\n    capture: (eventName: string, properties?: Record<string, unknown>) => void;\n    captureException?: (error: unknown, properties?: Record<string, unknown>) => void;\n    reset?: () => void;\n}\n\nexport interface CreatePostHogTelemetryAdapterOptions {\n    /** The PostHog JS client (the default export of `posthog-js`). Required. */\n    posthog: PostHogLike;\n    /** Project API key + options. When provided, `Provider.init` calls `posthog.init(apiKey, options)`. */\n    init?: { apiKey: string; options?: Record<string, unknown> };\n}\n\nfunction userToProperties(user: TelemetryUser): Record<string, unknown> {\n    const { email, name, traits } = user;\n    return {\n        ...(email !== undefined ? { email } : null),\n        ...(name !== undefined ? { name } : null),\n        ...(traits ?? null),\n    };\n}\n\n/**\n * Build a [[TelemetryAdapter]] backed by [`posthog-js`](https://posthog.com/docs/libraries/js).\n * The PostHog client is supplied by the caller (not bundled).\n *\n * Mapping:\n * - `identify(user)` → `posthog.identify(user.id, { email, name, ...traits })` (or `posthog.reset()` when `null`)\n * - `track({ name, properties })` → `posthog.capture(name, properties)`\n * - `captureException(err, ctx)` → `posthog.captureException(err, ctx)` when available, otherwise `posthog.capture(\"$exception\", { …err, …ctx })`\n * - `flush()` → no-op (PostHog batches automatically)\n *\n * @example\n * import posthog from \"posthog-js\";\n * import { createPostHogTelemetryAdapter, TelemetryProvider } from \"tempest-react-sdk\";\n *\n * const adapter = createPostHogTelemetryAdapter({\n *     posthog,\n *     init: { apiKey: import.meta.env.VITE_POSTHOG_KEY, options: { api_host: \"https://us.i.posthog.com\" } },\n * });\n *\n * <TelemetryProvider adapter={adapter}><App /></TelemetryProvider>;\n */\nexport function createPostHogTelemetryAdapter(\n    options: CreatePostHogTelemetryAdapterOptions,\n): TelemetryAdapter {\n    const { posthog, init } = options;\n\n    return {\n        init() {\n            if (init && posthog.init) {\n                posthog.init(init.apiKey, init.options);\n            }\n        },\n        identify(user: TelemetryUser | null) {\n            if (user === null) {\n                posthog.reset?.();\n                return;\n            }\n            if (user.id === undefined) return;\n            posthog.identify(user.id, userToProperties(user));\n        },\n        track(event: TelemetryEvent) {\n            posthog.capture(event.name, event.properties);\n        },\n        captureException(error: unknown, context?: Record<string, unknown>) {\n            if (posthog.captureException) {\n                posthog.captureException(error, context);\n                return;\n            }\n            const err = error instanceof Error ? error : new Error(String(error));\n            posthog.capture(\"$exception\", {\n                $exception_message: err.message,\n                $exception_type: err.name,\n                $exception_stack_trace_raw: err.stack,\n                ...context,\n            });\n        },\n    };\n}\n"],"mappings":";AAsBA,SAAS,EAAiB,GAA8C;CACpE,IAAM,EAAE,UAAO,SAAM,cAAW;CAChC,OAAO;EACH,GAAI,MAAU,KAAA,IAAwB,OAAZ,EAAE,SAAM;EAClC,GAAI,MAAS,KAAA,IAAuB,OAAX,EAAE,QAAK;EAChC,GAAI,KAAU;CAClB;AACJ;AAuBA,SAAgB,EACZ,GACgB;CAChB,IAAM,EAAE,YAAS,YAAS;CAE1B,OAAO;EACH,OAAO;GACH,AAAI,KAAQ,EAAQ,QAChB,EAAQ,KAAK,EAAK,QAAQ,EAAK,OAAO;EAE9C;EACA,SAAS,GAA4B;GACjC,IAAI,MAAS,MAAM;IACf,EAAQ,QAAQ;IAChB;GACJ;GACI,EAAK,OAAO,KAAA,KAChB,EAAQ,SAAS,EAAK,IAAI,EAAiB,CAAI,CAAC;EACpD;EACA,MAAM,GAAuB;GACzB,EAAQ,QAAQ,EAAM,MAAM,EAAM,UAAU;EAChD;EACA,iBAAiB,GAAgB,GAAmC;GAChE,IAAI,EAAQ,kBAAkB;IAC1B,EAAQ,iBAAiB,GAAO,CAAO;IACvC;GACJ;GACA,IAAM,IAAM,aAAiB,QAAQ,IAAY,MAAM,OAAO,CAAK,CAAC;GACpE,EAAQ,QAAQ,cAAc;IAC1B,oBAAoB,EAAI;IACxB,iBAAiB,EAAI;IACrB,4BAA4B,EAAI;IAChC,GAAG;GACP,CAAC;EACL;CACJ;AACJ"}
+{"version":3,"file":"posthog-adapter.js","names":["userToProperties","user","email","name","traits","createPostHogTelemetryAdapter","options","init","posthog","event","error","context","err"],"sources":["../../src/telemetry/posthog-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter, TelemetryEvent, TelemetryUser } from \"./types\";\n\n/**\n * Minimal subset of `posthog-js` used by the adapter. Pass either the real\n * default export (`import posthog from \"posthog-js\"`) or a stubbed object\n * in tests.\n */\nexport interface PostHogLike {\n    init?: (apiKey: string, options?: Record<string, unknown>) => void;\n    identify: (distinctId: string, properties?: Record<string, unknown>) => void;\n    capture: (eventName: string, properties?: Record<string, unknown>) => void;\n    captureException?: (error: unknown, properties?: Record<string, unknown>) => void;\n    reset?: () => void;\n}\n\nexport interface CreatePostHogTelemetryAdapterOptions {\n    /** The PostHog JS client (the default export of `posthog-js`). Required. */\n    posthog: PostHogLike;\n    /** Project API key + options. When provided, `Provider.init` calls `posthog.init(apiKey, options)`. */\n    init?: { apiKey: string; options?: Record<string, unknown> };\n}\n\nfunction userToProperties(user: TelemetryUser): Record<string, unknown> {\n    const { email, name, traits } = user;\n    return {\n        ...(email !== undefined ? { email } : null),\n        ...(name !== undefined ? { name } : null),\n        ...(traits ?? null),\n    };\n}\n\n/**\n * Build a [[TelemetryAdapter]] backed by [`posthog-js`](https://posthog.com/docs/libraries/js).\n * The PostHog client is supplied by the caller (not bundled).\n *\n * Mapping:\n * - `identify(user)` → `posthog.identify(user.id, { email, name, ...traits })` (or `posthog.reset()` when `null`)\n * - `track({ name, properties })` → `posthog.capture(name, properties)`\n * - `captureException(err, ctx)` → `posthog.captureException(err, ctx)` when available, otherwise `posthog.capture(\"$exception\", { …err, …ctx })`\n * - `flush()` → no-op (PostHog batches automatically)\n *\n * @example\n * import posthog from \"posthog-js\";\n * import { createPostHogTelemetryAdapter, TelemetryProvider } from \"tempest-react-sdk\";\n *\n * const adapter = createPostHogTelemetryAdapter({\n *     posthog,\n *     init: { apiKey: import.meta.env.VITE_POSTHOG_KEY, options: { api_host: \"https://us.i.posthog.com\" } },\n * });\n *\n * <TelemetryProvider adapter={adapter}><App /></TelemetryProvider>;\n */\nexport function createPostHogTelemetryAdapter(\n    options: CreatePostHogTelemetryAdapterOptions,\n): TelemetryAdapter {\n    const { posthog, init } = options;\n\n    return {\n        init() {\n            if (init && posthog.init) {\n                posthog.init(init.apiKey, init.options);\n            }\n        },\n        identify(user: TelemetryUser | null) {\n            if (user === null) {\n                posthog.reset?.();\n                return;\n            }\n            if (user.id === undefined) return;\n            posthog.identify(user.id, userToProperties(user));\n        },\n        track(event: TelemetryEvent) {\n            posthog.capture(event.name, event.properties);\n        },\n        captureException(error: unknown, context?: Record<string, unknown>) {\n            if (posthog.captureException) {\n                posthog.captureException(error, context);\n                return;\n            }\n            const err = error instanceof Error ? error : new Error(String(error));\n            posthog.capture(\"$exception\", {\n                $exception_message: err.message,\n                $exception_type: err.name,\n                $exception_stack_trace_raw: err.stack,\n                ...context,\n            });\n        },\n    };\n}\n"],"mappings":";AAsBA,SAASA,EAAiB,GAA8C;CACpE,IAAM,EAAE,UAAO,SAAM,cAAWC;CAChC,OAAO;EACH,GAAIC,MAAU,KAAA,IAAwB,OAAZ,EAAE,SAAM;EAClC,GAAIC,MAAS,KAAA,IAAuB,OAAX,EAAE,QAAK;EAChC,GAAIC,KAAU;CAClB;AACJ;AAuBA,SAAgBC,EACZ,GACgB;CAChB,IAAM,EAAE,YAAS,YAASC;CAE1B,OAAO;EACH,OAAO;GACH,AAAIC,KAAQC,EAAQ,QAChBA,EAAQ,KAAKD,EAAK,QAAQA,EAAK,OAAO;EAE9C;EACA,SAAS,GAA4B;GACjC,AAAIN,MAAS,OACTO,EAAQ,QAAQ,IAGhBP,EAAK,OAAO,KAAA,KAChBO,EAAQ,SAASP,EAAK,IAAID,EAAiBC,CAAI,CAAC;EACpD;EACA,MAAM,GAAuB;GACzB,EAAQ,QAAQQ,EAAM,MAAMA,EAAM,UAAU;EAChD;EACA,iBAAiB,GAAgB,GAAmC;GAChE,IAAID,EAAQ,kBAAkB;IAC1B,EAAQ,iBAAiBE,GAAOC,CAAO;IACvC;GACJ;GACA,IAAMC,IAAMF,aAAiB,QAAQA,IAAY,MAAM,OAAOA,CAAK,CAAC;GACpE,EAAQ,QAAQ,cAAc;IAC1B,oBAAoBE,EAAI;IACxB,iBAAiBA,EAAI;IACrB,4BAA4BA,EAAI;IAChC,GAAGD;GACP,CAAC;EACL;CACJ;AACJ"}

package/dist/telemetry/sentry-adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sentry-adapter.cjs","names":[],"sources":["../../src/telemetry/sentry-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter, TelemetryEvent, TelemetryUser } from \"./types\";\n\n/**\n * Minimal subset of `@sentry/browser` used by the adapter. Lets you pass\n * either the real SDK module (`import * as Sentry from \"@sentry/browser\"`)\n * or a stubbed object in tests.\n */\nexport interface SentryLike {\n    init?: (options: Record<string, unknown>) => void;\n    setUser: (user: Record<string, unknown> | null) => void;\n    addBreadcrumb: (breadcrumb: {\n        category?: string;\n        message?: string;\n        level?: string;\n        data?: Record<string, unknown>;\n    }) => void;\n    captureException: (\n        error: unknown,\n        hint?: { extra?: Record<string, unknown>; contexts?: Record<string, unknown> },\n    ) => void;\n    flush?: (timeout?: number) => Promise<boolean>;\n}\n\nexport interface CreateSentryTelemetryAdapterOptions {\n    /** The Sentry browser SDK namespace. Required. */\n    sentry: SentryLike;\n    /** Optional init payload — passed verbatim to `Sentry.init` when the provider mounts. */\n    initOptions?: Record<string, unknown>;\n    /** Flush timeout in ms (default `2000`). */\n    flushTimeout?: number;\n    /** Breadcrumb category for `track` events (default `\"app\"`). */\n    breadcrumbCategory?: string;\n}\n\nfunction userToSentry(user: TelemetryUser | null): Record<string, unknown> | null {\n    if (user === null) return null;\n    const { id, email, name, traits } = user;\n    return {\n        ...(id !== undefined ? { id } : null),\n        ...(email !== undefined ? { email } : null),\n        ...(name !== undefined ? { username: name } : null),\n        ...(traits ?? null),\n    };\n}\n\n/**\n * Build a [[TelemetryAdapter]] backed by `@sentry/browser`. The Sentry SDK\n * is supplied by the caller (not bundled) so apps that already initialise\n * Sentry at startup can share that instance — and apps that don't use\n * Sentry never pay for it.\n *\n * Mapping:\n * - `identify(user)` → `Sentry.setUser`\n * - `track(event)` → `Sentry.addBreadcrumb({ category, message: event.name, data })`\n * - `captureException(err, ctx)` → `Sentry.captureException(err, { extra: ctx })`\n * - `flush()` → `Sentry.flush(flushTimeout)`\n *\n * @example\n * import * as Sentry from \"@sentry/browser\";\n * import { createSentryTelemetryAdapter, TelemetryProvider } from \"tempest-react-sdk\";\n *\n * const adapter = createSentryTelemetryAdapter({\n *     sentry: Sentry,\n *     initOptions: { dsn: import.meta.env.VITE_SENTRY_DSN, tracesSampleRate: 0.1 },\n * });\n *\n * <TelemetryProvider adapter={adapter}><App /></TelemetryProvider>;\n */\nexport function createSentryTelemetryAdapter(\n    options: CreateSentryTelemetryAdapterOptions,\n): TelemetryAdapter {\n    const { sentry, initOptions, flushTimeout = 2000, breadcrumbCategory = \"app\" } = options;\n\n    return {\n        init() {\n            if (initOptions && sentry.init) {\n                sentry.init(initOptions);\n            }\n        },\n        identify(user: TelemetryUser | null) {\n            sentry.setUser(userToSentry(user));\n        },\n        track(event: TelemetryEvent) {\n            sentry.addBreadcrumb({\n                category: breadcrumbCategory,\n                message: event.name,\n                level: \"info\",\n                ...(event.properties ? { data: event.properties } : null),\n            });\n        },\n        captureException(error: unknown, context?: Record<string, unknown>) {\n            sentry.captureException(error, context ? { extra: context } : undefined);\n        },\n        async flush() {\n            if (sentry.flush) {\n                await sentry.flush(flushTimeout);\n            }\n        },\n    };\n}\n"],"mappings":"AAkCA,SAAS,EAAa,EAA4D,CAC9E,GAAI,IAAS,KAAM,OAAO,KAC1B,GAAM,CAAE,KAAI,QAAO,OAAM,UAAW,EACpC,MAAO,CACH,GAAI,IAAO,IAAA,GAAqB,KAAT,CAAE,IAAG,EAC5B,GAAI,IAAU,IAAA,GAAwB,KAAZ,CAAE,OAAM,EAClC,GAAI,IAAS,IAAA,GAAiC,KAArB,CAAE,SAAU,CAAK,EAC1C,GAAI,GAAU,IAClB,CACJ,CAyBA,SAAgB,EACZ,EACgB,CAChB,GAAM,CAAE,SAAQ,cAAa,eAAe,IAAM,qBAAqB,OAAU,EAEjF,MAAO,CACH,MAAO,CACC,GAAe,EAAO,MACtB,EAAO,KAAK,CAAW,CAE/B,EACA,SAAS,EAA4B,CACjC,EAAO,QAAQ,EAAa,CAAI,CAAC,CACrC,EACA,MAAM,EAAuB,CACzB,EAAO,cAAc,CACjB,SAAU,EACV,QAAS,EAAM,KACf,MAAO,OACP,GAAI,EAAM,WAAa,CAAE,KAAM,EAAM,UAAW,EAAI,IACxD,CAAC,CACL,EACA,iBAAiB,EAAgB,EAAmC,CAChE,EAAO,iBAAiB,EAAO,EAAU,CAAE,MAAO,CAAQ,EAAI,IAAA,EAAS,CAC3E,EACA,MAAM,OAAQ,CACN,EAAO,OACP,MAAM,EAAO,MAAM,CAAY,CAEvC,CACJ,CACJ"}
+{"version":3,"file":"sentry-adapter.cjs","names":["userToSentry","user","id","email","name","traits","createSentryTelemetryAdapter","options","initOptions","sentry","breadcrumbCategory","event","error","context","flushTimeout"],"sources":["../../src/telemetry/sentry-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter, TelemetryEvent, TelemetryUser } from \"./types\";\n\n/**\n * Minimal subset of `@sentry/browser` used by the adapter. Lets you pass\n * either the real SDK module (`import * as Sentry from \"@sentry/browser\"`)\n * or a stubbed object in tests.\n */\nexport interface SentryLike {\n    init?: (options: Record<string, unknown>) => void;\n    setUser: (user: Record<string, unknown> | null) => void;\n    addBreadcrumb: (breadcrumb: {\n        category?: string;\n        message?: string;\n        level?: string;\n        data?: Record<string, unknown>;\n    }) => void;\n    captureException: (\n        error: unknown,\n        hint?: { extra?: Record<string, unknown>; contexts?: Record<string, unknown> },\n    ) => void;\n    flush?: (timeout?: number) => Promise<boolean>;\n}\n\nexport interface CreateSentryTelemetryAdapterOptions {\n    /** The Sentry browser SDK namespace. Required. */\n    sentry: SentryLike;\n    /** Optional init payload — passed verbatim to `Sentry.init` when the provider mounts. */\n    initOptions?: Record<string, unknown>;\n    /** Flush timeout in ms (default `2000`). */\n    flushTimeout?: number;\n    /** Breadcrumb category for `track` events (default `\"app\"`). */\n    breadcrumbCategory?: string;\n}\n\nfunction userToSentry(user: TelemetryUser | null): Record<string, unknown> | null {\n    if (user === null) return null;\n    const { id, email, name, traits } = user;\n    return {\n        ...(id !== undefined ? { id } : null),\n        ...(email !== undefined ? { email } : null),\n        ...(name !== undefined ? { username: name } : null),\n        ...(traits ?? null),\n    };\n}\n\n/**\n * Build a [[TelemetryAdapter]] backed by `@sentry/browser`. The Sentry SDK\n * is supplied by the caller (not bundled) so apps that already initialise\n * Sentry at startup can share that instance — and apps that don't use\n * Sentry never pay for it.\n *\n * Mapping:\n * - `identify(user)` → `Sentry.setUser`\n * - `track(event)` → `Sentry.addBreadcrumb({ category, message: event.name, data })`\n * - `captureException(err, ctx)` → `Sentry.captureException(err, { extra: ctx })`\n * - `flush()` → `Sentry.flush(flushTimeout)`\n *\n * @example\n * import * as Sentry from \"@sentry/browser\";\n * import { createSentryTelemetryAdapter, TelemetryProvider } from \"tempest-react-sdk\";\n *\n * const adapter = createSentryTelemetryAdapter({\n *     sentry: Sentry,\n *     initOptions: { dsn: import.meta.env.VITE_SENTRY_DSN, tracesSampleRate: 0.1 },\n * });\n *\n * <TelemetryProvider adapter={adapter}><App /></TelemetryProvider>;\n */\nexport function createSentryTelemetryAdapter(\n    options: CreateSentryTelemetryAdapterOptions,\n): TelemetryAdapter {\n    const { sentry, initOptions, flushTimeout = 2000, breadcrumbCategory = \"app\" } = options;\n\n    return {\n        init() {\n            if (initOptions && sentry.init) {\n                sentry.init(initOptions);\n            }\n        },\n        identify(user: TelemetryUser | null) {\n            sentry.setUser(userToSentry(user));\n        },\n        track(event: TelemetryEvent) {\n            sentry.addBreadcrumb({\n                category: breadcrumbCategory,\n                message: event.name,\n                level: \"info\",\n                ...(event.properties ? { data: event.properties } : null),\n            });\n        },\n        captureException(error: unknown, context?: Record<string, unknown>) {\n            sentry.captureException(error, context ? { extra: context } : undefined);\n        },\n        async flush() {\n            if (sentry.flush) {\n                await sentry.flush(flushTimeout);\n            }\n        },\n    };\n}\n"],"mappings":"AAkCA,SAASA,EAAa,EAA4D,CAC9E,GAAIC,IAAS,KAAM,OAAO,KAC1B,GAAM,CAAE,KAAI,QAAO,OAAM,UAAWA,EACpC,MAAO,CACH,GAAIC,IAAO,IAAA,GAAqB,KAAT,CAAE,IAAG,EAC5B,GAAIC,IAAU,IAAA,GAAwB,KAAZ,CAAE,OAAM,EAClC,GAAIC,IAAS,IAAA,GAAiC,KAArB,CAAE,SAAUA,CAAK,EAC1C,GAAIC,GAAU,IAClB,CACJ,CAyBA,SAAgBC,EACZ,EACgB,CAChB,GAAM,CAAE,SAAQ,cAAa,eAAe,IAAM,qBAAqB,OAAUC,EAEjF,MAAO,CACH,MAAO,CACCC,GAAeC,EAAO,MACtBA,EAAO,KAAKD,CAAW,CAE/B,EACA,SAAS,EAA4B,CACjCC,EAAO,QAAQT,EAAaC,CAAI,CAAC,CACrC,EACA,MAAM,EAAuB,CACzBQ,EAAO,cAAc,CACjB,SAAUC,EACV,QAASC,EAAM,KACf,MAAO,OACP,GAAIA,EAAM,WAAa,CAAE,KAAMA,EAAM,UAAW,EAAI,IACxD,CAAC,CACL,EACA,iBAAiB,EAAgB,EAAmC,CAChEF,EAAO,iBAAiBG,EAAOC,EAAU,CAAE,MAAOA,CAAQ,EAAI,IAAA,EAAS,CAC3E,EACA,MAAM,OAAQ,CACNJ,EAAO,OACP,MAAMA,EAAO,MAAMK,CAAY,CAEvC,CACJ,CACJ,C"}

package/dist/telemetry/sentry-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"sentry-adapter.js","names":[],"sources":["../../src/telemetry/sentry-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter, TelemetryEvent, TelemetryUser } from \"./types\";\n\n/**\n * Minimal subset of `@sentry/browser` used by the adapter. Lets you pass\n * either the real SDK module (`import * as Sentry from \"@sentry/browser\"`)\n * or a stubbed object in tests.\n */\nexport interface SentryLike {\n    init?: (options: Record<string, unknown>) => void;\n    setUser: (user: Record<string, unknown> | null) => void;\n    addBreadcrumb: (breadcrumb: {\n        category?: string;\n        message?: string;\n        level?: string;\n        data?: Record<string, unknown>;\n    }) => void;\n    captureException: (\n        error: unknown,\n        hint?: { extra?: Record<string, unknown>; contexts?: Record<string, unknown> },\n    ) => void;\n    flush?: (timeout?: number) => Promise<boolean>;\n}\n\nexport interface CreateSentryTelemetryAdapterOptions {\n    /** The Sentry browser SDK namespace. Required. */\n    sentry: SentryLike;\n    /** Optional init payload — passed verbatim to `Sentry.init` when the provider mounts. */\n    initOptions?: Record<string, unknown>;\n    /** Flush timeout in ms (default `2000`). */\n    flushTimeout?: number;\n    /** Breadcrumb category for `track` events (default `\"app\"`). */\n    breadcrumbCategory?: string;\n}\n\nfunction userToSentry(user: TelemetryUser | null): Record<string, unknown> | null {\n    if (user === null) return null;\n    const { id, email, name, traits } = user;\n    return {\n        ...(id !== undefined ? { id } : null),\n        ...(email !== undefined ? { email } : null),\n        ...(name !== undefined ? { username: name } : null),\n        ...(traits ?? null),\n    };\n}\n\n/**\n * Build a [[TelemetryAdapter]] backed by `@sentry/browser`. The Sentry SDK\n * is supplied by the caller (not bundled) so apps that already initialise\n * Sentry at startup can share that instance — and apps that don't use\n * Sentry never pay for it.\n *\n * Mapping:\n * - `identify(user)` → `Sentry.setUser`\n * - `track(event)` → `Sentry.addBreadcrumb({ category, message: event.name, data })`\n * - `captureException(err, ctx)` → `Sentry.captureException(err, { extra: ctx })`\n * - `flush()` → `Sentry.flush(flushTimeout)`\n *\n * @example\n * import * as Sentry from \"@sentry/browser\";\n * import { createSentryTelemetryAdapter, TelemetryProvider } from \"tempest-react-sdk\";\n *\n * const adapter = createSentryTelemetryAdapter({\n *     sentry: Sentry,\n *     initOptions: { dsn: import.meta.env.VITE_SENTRY_DSN, tracesSampleRate: 0.1 },\n * });\n *\n * <TelemetryProvider adapter={adapter}><App /></TelemetryProvider>;\n */\nexport function createSentryTelemetryAdapter(\n    options: CreateSentryTelemetryAdapterOptions,\n): TelemetryAdapter {\n    const { sentry, initOptions, flushTimeout = 2000, breadcrumbCategory = \"app\" } = options;\n\n    return {\n        init() {\n            if (initOptions && sentry.init) {\n                sentry.init(initOptions);\n            }\n        },\n        identify(user: TelemetryUser | null) {\n            sentry.setUser(userToSentry(user));\n        },\n        track(event: TelemetryEvent) {\n            sentry.addBreadcrumb({\n                category: breadcrumbCategory,\n                message: event.name,\n                level: \"info\",\n                ...(event.properties ? { data: event.properties } : null),\n            });\n        },\n        captureException(error: unknown, context?: Record<string, unknown>) {\n            sentry.captureException(error, context ? { extra: context } : undefined);\n        },\n        async flush() {\n            if (sentry.flush) {\n                await sentry.flush(flushTimeout);\n            }\n        },\n    };\n}\n"],"mappings":";AAkCA,SAAS,EAAa,GAA4D;CAC9E,IAAI,MAAS,MAAM,OAAO;CAC1B,IAAM,EAAE,OAAI,UAAO,SAAM,cAAW;CACpC,OAAO;EACH,GAAI,MAAO,KAAA,IAAqB,OAAT,EAAE,MAAG;EAC5B,GAAI,MAAU,KAAA,IAAwB,OAAZ,EAAE,SAAM;EAClC,GAAI,MAAS,KAAA,IAAiC,OAArB,EAAE,UAAU,EAAK;EAC1C,GAAI,KAAU;CAClB;AACJ;AAyBA,SAAgB,EACZ,GACgB;CAChB,IAAM,EAAE,WAAQ,gBAAa,kBAAe,KAAM,wBAAqB,UAAU;CAEjF,OAAO;EACH,OAAO;GACH,AAAI,KAAe,EAAO,QACtB,EAAO,KAAK,CAAW;EAE/B;EACA,SAAS,GAA4B;GACjC,EAAO,QAAQ,EAAa,CAAI,CAAC;EACrC;EACA,MAAM,GAAuB;GACzB,EAAO,cAAc;IACjB,UAAU;IACV,SAAS,EAAM;IACf,OAAO;IACP,GAAI,EAAM,aAAa,EAAE,MAAM,EAAM,WAAW,IAAI;GACxD,CAAC;EACL;EACA,iBAAiB,GAAgB,GAAmC;GAChE,EAAO,iBAAiB,GAAO,IAAU,EAAE,OAAO,EAAQ,IAAI,KAAA,CAAS;EAC3E;EACA,MAAM,QAAQ;GACV,AAAI,EAAO,SACP,MAAM,EAAO,MAAM,CAAY;EAEvC;CACJ;AACJ"}
+{"version":3,"file":"sentry-adapter.js","names":["userToSentry","user","id","email","name","traits","createSentryTelemetryAdapter","options","initOptions","sentry","breadcrumbCategory","event","error","context","flushTimeout"],"sources":["../../src/telemetry/sentry-adapter.ts"],"sourcesContent":["import type { TelemetryAdapter, TelemetryEvent, TelemetryUser } from \"./types\";\n\n/**\n * Minimal subset of `@sentry/browser` used by the adapter. Lets you pass\n * either the real SDK module (`import * as Sentry from \"@sentry/browser\"`)\n * or a stubbed object in tests.\n */\nexport interface SentryLike {\n    init?: (options: Record<string, unknown>) => void;\n    setUser: (user: Record<string, unknown> | null) => void;\n    addBreadcrumb: (breadcrumb: {\n        category?: string;\n        message?: string;\n        level?: string;\n        data?: Record<string, unknown>;\n    }) => void;\n    captureException: (\n        error: unknown,\n        hint?: { extra?: Record<string, unknown>; contexts?: Record<string, unknown> },\n    ) => void;\n    flush?: (timeout?: number) => Promise<boolean>;\n}\n\nexport interface CreateSentryTelemetryAdapterOptions {\n    /** The Sentry browser SDK namespace. Required. */\n    sentry: SentryLike;\n    /** Optional init payload — passed verbatim to `Sentry.init` when the provider mounts. */\n    initOptions?: Record<string, unknown>;\n    /** Flush timeout in ms (default `2000`). */\n    flushTimeout?: number;\n    /** Breadcrumb category for `track` events (default `\"app\"`). */\n    breadcrumbCategory?: string;\n}\n\nfunction userToSentry(user: TelemetryUser | null): Record<string, unknown> | null {\n    if (user === null) return null;\n    const { id, email, name, traits } = user;\n    return {\n        ...(id !== undefined ? { id } : null),\n        ...(email !== undefined ? { email } : null),\n        ...(name !== undefined ? { username: name } : null),\n        ...(traits ?? null),\n    };\n}\n\n/**\n * Build a [[TelemetryAdapter]] backed by `@sentry/browser`. The Sentry SDK\n * is supplied by the caller (not bundled) so apps that already initialise\n * Sentry at startup can share that instance — and apps that don't use\n * Sentry never pay for it.\n *\n * Mapping:\n * - `identify(user)` → `Sentry.setUser`\n * - `track(event)` → `Sentry.addBreadcrumb({ category, message: event.name, data })`\n * - `captureException(err, ctx)` → `Sentry.captureException(err, { extra: ctx })`\n * - `flush()` → `Sentry.flush(flushTimeout)`\n *\n * @example\n * import * as Sentry from \"@sentry/browser\";\n * import { createSentryTelemetryAdapter, TelemetryProvider } from \"tempest-react-sdk\";\n *\n * const adapter = createSentryTelemetryAdapter({\n *     sentry: Sentry,\n *     initOptions: { dsn: import.meta.env.VITE_SENTRY_DSN, tracesSampleRate: 0.1 },\n * });\n *\n * <TelemetryProvider adapter={adapter}><App /></TelemetryProvider>;\n */\nexport function createSentryTelemetryAdapter(\n    options: CreateSentryTelemetryAdapterOptions,\n): TelemetryAdapter {\n    const { sentry, initOptions, flushTimeout = 2000, breadcrumbCategory = \"app\" } = options;\n\n    return {\n        init() {\n            if (initOptions && sentry.init) {\n                sentry.init(initOptions);\n            }\n        },\n        identify(user: TelemetryUser | null) {\n            sentry.setUser(userToSentry(user));\n        },\n        track(event: TelemetryEvent) {\n            sentry.addBreadcrumb({\n                category: breadcrumbCategory,\n                message: event.name,\n                level: \"info\",\n                ...(event.properties ? { data: event.properties } : null),\n            });\n        },\n        captureException(error: unknown, context?: Record<string, unknown>) {\n            sentry.captureException(error, context ? { extra: context } : undefined);\n        },\n        async flush() {\n            if (sentry.flush) {\n                await sentry.flush(flushTimeout);\n            }\n        },\n    };\n}\n"],"mappings":";AAkCA,SAASA,EAAa,GAA4D;CAC9E,IAAIC,MAAS,MAAM,OAAO;CAC1B,IAAM,EAAE,OAAI,UAAO,SAAM,cAAWA;CACpC,OAAO;EACH,GAAIC,MAAO,KAAA,IAAqB,OAAT,EAAE,MAAG;EAC5B,GAAIC,MAAU,KAAA,IAAwB,OAAZ,EAAE,SAAM;EAClC,GAAIC,MAAS,KAAA,IAAiC,OAArB,EAAE,UAAUA,EAAK;EAC1C,GAAIC,KAAU;CAClB;AACJ;AAyBA,SAAgBC,EACZ,GACgB;CAChB,IAAM,EAAE,WAAQ,gBAAa,kBAAe,KAAM,wBAAqB,UAAUC;CAEjF,OAAO;EACH,OAAO;GACH,AAAIC,KAAeC,EAAO,QACtBA,EAAO,KAAKD,CAAW;EAE/B;EACA,SAAS,GAA4B;GACjC,EAAO,QAAQR,EAAaC,CAAI,CAAC;EACrC;EACA,MAAM,GAAuB;GACzB,EAAO,cAAc;IACjB,UAAUS;IACV,SAASC,EAAM;IACf,OAAO;IACP,GAAIA,EAAM,aAAa,EAAE,MAAMA,EAAM,WAAW,IAAI;GACxD,CAAC;EACL;EACA,iBAAiB,GAAgB,GAAmC;GAChE,EAAO,iBAAiBC,GAAOC,IAAU,EAAE,OAAOA,EAAQ,IAAI,KAAA,CAAS;EAC3E;EACA,MAAM,QAAQ;GACV,AAAIJ,EAAO,SACP,MAAMA,EAAO,MAAMK,CAAY;EAEvC;CACJ;AACJ"}