@lib-acr/browser 0.0.0-stage → 0.0.2

package/dist/esm/control/command-runner.js

@@ -0,0 +1,284 @@
+import { clearCacheParams, planCommands, reloadParams } from '@lib-acr/core';
+/** Ids of commands already applied on this browser, newest last. */
+export const COMMANDS_KEY = 'acr.cmds';
+/** sessionStorage: epoch ms of the last reload the SDK triggered, a second guard against reload loops. */
+export const RELOAD_GUARD_KEY = 'acr.reloadAt';
+/** Storage keys starting with this prefix belong to the SDK and survive `clear_cache`. */
+export const RESERVED_PREFIX = 'acr.';
+export const COMMAND_APPLIED_EVENT = 'acr.command_applied';
+const MAX_APPLIED_IDS = 50;
+const RELOAD_GUARD_MS = 30000;
+const FLUSH_BEFORE_RELOAD_MS = 2000;
+const IDB_DELETE_TIMEOUT_MS = 3000;
+const CATEGORIES = ['cacheStorage', 'serviceWorkers', 'localStorage', 'sessionStorage', 'indexedDb', 'cookies'];
+/**
+ * Runs remote commands at most once per browser (docs/SDK-PROTOCOL.md §5): plans them with planCommands(), records
+ * each id in `localStorage['acr.cmds']` before acting (a command whose id cannot be recorded is not run, so a reload
+ * can never loop), acts, sends `acr.command_applied` and flushes. A reload, if any command asked for one, happens once
+ * at the end, after the acknowledgements were sent.
+ */
+export class CommandRunner {
+    constructor(deps) {
+        this.deps = deps;
+        this.chain = Promise.resolve();
+    }
+    /** Runs are serialised: a run started while another is in progress waits for it. Never rejects. */
+    run(commands) {
+        const next = this.chain.then(() => this.execute(commands)).catch(() => []);
+        this.chain = next;
+        return next;
+    }
+    /** Ids recorded in `acr.cmds`. */
+    appliedIds() {
+        try {
+            const raw = this.deps.localStorage()?.getItem(COMMANDS_KEY);
+            const parsed = raw ? JSON.parse(raw) : [];
+            return Array.isArray(parsed) ? parsed.filter((v) => typeof v === 'string') : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    async execute(commands) {
+        const now = this.deps.now?.() ?? Date.now();
+        const plan = planCommands(commands, { appliedIds: this.appliedIds(), firstSeenAt: this.deps.firstSeen(), now });
+        const outcomes = [];
+        let reload = false;
+        for (const decision of plan) {
+            if (decision.action !== 'apply')
+                continue;
+            const { command } = decision;
+            if (!this.record(command.id))
+                continue;
+            let outcome;
+            if (command.type === 'clear_cache') {
+                const params = clearCacheParams(command);
+                const { result, cleared } = await clearCaches(params, this.deps);
+                outcome = { commandId: command.id, type: command.type, result, cleared };
+                if (params.reload)
+                    reload = true;
+            }
+            else {
+                if (reloadParams(command).mode === 'immediate')
+                    reload = true;
+                else
+                    this.deps.promptReload();
+                outcome = { commandId: command.id, type: command.type, result: 'ok', cleared: [] };
+            }
+            outcomes.push(outcome);
+            try {
+                this.deps.track(COMMAND_APPLIED_EVENT, {
+                    commandId: outcome.commandId,
+                    type: outcome.type,
+                    result: outcome.result,
+                    cleared: outcome.cleared.join(','),
+                });
+            }
+            catch {
+                /* acknowledgements are best effort */
+            }
+        }
+        if (outcomes.length > 0)
+            await withTimeout(this.deps.flush(), FLUSH_BEFORE_RELOAD_MS);
+        if (reload) {
+            if (this.reloadAllowed(now))
+                this.deps.reload();
+            else
+                this.deps.promptReload();
+        }
+        return outcomes;
+    }
+    /** Appends the id to `acr.cmds` (last 50 kept) and reads it back. False when storage is unavailable. */
+    record(id) {
+        try {
+            const store = this.deps.localStorage();
+            if (!store)
+                return false;
+            const ids = this.appliedIds().filter((v) => v !== id);
+            ids.push(id);
+            store.setItem(COMMANDS_KEY, JSON.stringify(ids.slice(-MAX_APPLIED_IDS)));
+            return this.appliedIds().includes(id);
+        }
+        catch {
+            return false;
+        }
+    }
+    /** No second SDK-triggered reload within 30 s in this tab. */
+    reloadAllowed(now) {
+        try {
+            const store = this.deps.sessionStorage();
+            const last = Number(store?.getItem(RELOAD_GUARD_KEY) ?? 0);
+            if (Number.isFinite(last) && now - last < RELOAD_GUARD_MS && now >= last)
+                return false;
+            store?.setItem(RELOAD_GUARD_KEY, String(now));
+        }
+        catch {
+            /* the id in acr.cmds already prevents a loop */
+        }
+        return true;
+    }
+}
+/** Clears the categories set in `params`. Returns the overall result and the categories cleared completely. */
+export async function clearCaches(params, stores) {
+    const requested = CATEGORIES.filter((c) => params[c]);
+    const results = [];
+    for (const category of requested) {
+        let result;
+        try {
+            result = await clearCategory(category, stores);
+        }
+        catch {
+            result = 'failed';
+        }
+        results.push([category, result]);
+    }
+    const cleared = results.filter(([, r]) => r === 'ok').map(([c]) => c);
+    let result = 'ok';
+    if (results.some(([, r]) => r !== 'ok'))
+        result = results.every(([, r]) => r === 'failed') ? 'failed' : 'partial';
+    return { result, cleared };
+}
+function clearCategory(category, stores) {
+    switch (category) {
+        case 'cacheStorage':
+            return clearCacheStorage();
+        case 'serviceWorkers':
+            return unregisterServiceWorkers();
+        case 'localStorage':
+            return clearStorage(stores.localStorage());
+        case 'sessionStorage':
+            return clearStorage(stores.sessionStorage());
+        case 'indexedDb':
+            return clearIndexedDb();
+        case 'cookies':
+            return clearCookies();
+    }
+}
+async function clearCacheStorage() {
+    const cacheStorage = globalThis.caches;
+    if (!cacheStorage)
+        return 'ok'; // no Cache Storage, nothing cached
+    const keys = await cacheStorage.keys();
+    const results = await Promise.all(keys.map((key) => cacheStorage.delete(key).catch(() => false)));
+    return aggregate(results.map((deleted) => deleted !== false));
+}
+async function unregisterServiceWorkers() {
+    const container = typeof navigator !== 'undefined' ? navigator.serviceWorker : undefined;
+    if (!container || typeof container.getRegistrations !== 'function')
+        return 'ok';
+    const registrations = await container.getRegistrations();
+    const results = await Promise.all(registrations.map((r) => r.unregister().catch(() => false)));
+    return aggregate(results);
+}
+/** Removes every key except the SDK's own `acr.*` keys (anonymous id, first seen, applied commands, opt-out, …). */
+function clearStorage(store) {
+    if (!store)
+        return 'failed';
+    const keys = [];
+    for (let i = 0; i < store.length; i++) {
+        const key = store.key(i);
+        if (key !== null && !key.startsWith(RESERVED_PREFIX))
+            keys.push(key);
+    }
+    for (const key of keys)
+        store.removeItem(key);
+    return keys.every((key) => store.getItem(key) === null) ? 'ok' : 'partial';
+}
+async function clearIndexedDb() {
+    const idb = globalThis.indexedDB;
+    if (!idb)
+        return 'ok'; // no IndexedDB, nothing stored
+    // Firefox before 126 and older Safari cannot list databases, so nothing can be deleted by name.
+    if (typeof idb.databases !== 'function')
+        return 'partial';
+    const databases = await idb.databases();
+    const results = await Promise.all(databases.filter((db) => db.name).map((db) => deleteDatabase(idb, db.name)));
+    return aggregate(results);
+}
+function deleteDatabase(idb, name) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve(false), IDB_DELETE_TIMEOUT_MS);
+        const done = (ok) => {
+            clearTimeout(timer);
+            resolve(ok);
+        };
+        try {
+            const request = idb.deleteDatabase(name);
+            request.onsuccess = () => done(true);
+            request.onerror = () => done(false);
+            // Blocked: another tab holds a connection. The deletion is queued and completes when it closes.
+            request.onblocked = () => done(true);
+        }
+        catch {
+            done(false);
+        }
+    });
+}
+/**
+ * Expires every cookie readable by script, for the current path and its parents and for the host and its parent
+ * domains (the attributes a cookie was set with cannot be read back). HttpOnly cookies are invisible to scripts and
+ * cannot be cleared by any SDK.
+ */
+function clearCookies() {
+    if (typeof document === 'undefined' || typeof location === 'undefined')
+        return 'failed';
+    const names = cookieNames();
+    if (names.length === 0)
+        return 'ok';
+    const paths = pathPrefixes(location.pathname);
+    const domains = [null, ...parentDomains(location.hostname)];
+    for (const name of names) {
+        for (const domain of domains) {
+            for (const path of paths) {
+                document.cookie = `${name}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; max-age=0; path=${path}${domain ? `; domain=${domain}` : ''}`;
+            }
+        }
+    }
+    const remaining = new Set(cookieNames());
+    return names.some((n) => remaining.has(n)) ? 'partial' : 'ok';
+}
+function cookieNames() {
+    return document.cookie
+        .split(';')
+        .map((part) => part.split('=')[0].trim())
+        .filter((name) => name !== '');
+}
+/** '/a/b/c' → ['/', '/a', '/a/b', '/a/b/c'] (at most 10 levels). */
+function pathPrefixes(pathname) {
+    const segments = pathname.split('/').filter(Boolean).slice(0, 10);
+    const out = ['/'];
+    let current = '';
+    for (const segment of segments) {
+        current += `/${segment}`;
+        out.push(current);
+    }
+    return out;
+}
+/** 'app.shop.example.com' → ['app.shop.example.com', 'shop.example.com', 'example.com']; IPs and 'localhost' → []. */
+function parentDomains(hostname) {
+    if (!hostname.includes('.') || /^[\d.]+$/.test(hostname) || hostname.includes(':'))
+        return [];
+    const labels = hostname.split('.');
+    const out = [];
+    for (let i = 0; i < labels.length - 1; i++)
+        out.push(labels.slice(i).join('.'));
+    return out;
+}
+function aggregate(results) {
+    if (results.every(Boolean))
+        return 'ok';
+    return results.some(Boolean) ? 'partial' : 'failed';
+}
+function withTimeout(promise, ms) {
+    let timer;
+    return Promise.race([
+        promise.then(() => undefined, () => undefined),
+        new Promise((resolve) => {
+            timer = setTimeout(resolve, ms);
+        }),
+    ]).finally(() => {
+        if (timer)
+            clearTimeout(timer);
+    });
+}
+//# sourceMappingURL=command-runner.js.map

package/dist/esm/control/command-runner.js.map

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

package/dist/esm/control/ui.js

@@ -0,0 +1,272 @@
+export function resolveUiOptions(ui) {
+    if (ui === false)
+        return { maintenance: false, announcement: false, release: false };
+    if (ui === true || ui === undefined)
+        return { maintenance: true, announcement: true, release: true };
+    return { maintenance: ui.maintenance ?? true, announcement: ui.announcement ?? true, release: ui.release ?? true };
+}
+/** Tag of the element that hosts the shadow root. */
+export const UI_HOST_TAG = 'acr-ui';
+const STYLES = `
+:host{all:initial}
+*{box-sizing:border-box}
+.wrap{--acr-bg:#ffffff;--acr-fg:#111827;--acr-muted:#4b5563;--acr-border:#e5e7eb;--acr-accent:#2563eb;--acr-accent-fg:#ffffff;
+--acr-info-bg:#eff6ff;--acr-info-fg:#1e3a8a;--acr-warn-bg:#fffbeb;--acr-warn-fg:#78350f;--acr-crit-bg:#fef2f2;--acr-crit-fg:#7f1d1d;
+font:14px/1.45 system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;color:var(--acr-fg)}
+@media (prefers-color-scheme:dark){.wrap{--acr-bg:#111827;--acr-fg:#f9fafb;--acr-muted:#9ca3af;--acr-border:#374151;--acr-accent:#3b82f6;
+--acr-info-bg:#172554;--acr-info-fg:#dbeafe;--acr-warn-bg:#451a03;--acr-warn-fg:#fef3c7;--acr-crit-bg:#450a0a;--acr-crit-fg:#fee2e2}}
+button{font:inherit;min-height:36px;padding:0 14px;border-radius:8px;border:1px solid var(--acr-border);background:transparent;color:inherit;cursor:pointer}
+button:focus-visible,a:focus-visible,[tabindex]:focus-visible{outline:2px solid var(--acr-accent);outline-offset:2px}
+.primary{background:var(--acr-accent);border-color:transparent;color:var(--acr-accent-fg)}
+.close{min-width:36px;padding:0;font-size:18px;line-height:1;border-color:transparent}
+.overlay{position:fixed;inset:0;z-index:2147483647;display:flex;align-items:center;justify-content:center;padding:16px;background:rgba(17,24,39,.72)}
+.dialog{width:100%;max-width:440px;padding:24px;border-radius:12px;background:var(--acr-bg);color:var(--acr-fg);box-shadow:0 20px 50px rgba(0,0,0,.35)}
+.dialog:focus{outline:none}
+.dialog h2{margin:0 0 8px;font-size:20px;line-height:1.3}
+.dialog p{margin:0 0 12px}
+.muted{color:var(--acr-muted);font-size:13px}
+.banner{position:fixed;top:0;left:0;right:0;z-index:2147483646;display:flex;flex-wrap:wrap;align-items:center;gap:8px 12px;padding:8px 8px 8px 16px;box-shadow:0 1px 3px rgba(0,0,0,.15)}
+.banner .msg{flex:1 1 200px}
+.banner a{color:inherit;font-weight:600}
+.sev-info{background:var(--acr-info-bg);color:var(--acr-info-fg)}
+.sev-warning{background:var(--acr-warn-bg);color:var(--acr-warn-fg)}
+.sev-critical{background:var(--acr-crit-bg);color:var(--acr-crit-fg)}
+.toast{position:fixed;right:16px;bottom:16px;z-index:2147483646;display:flex;flex-wrap:wrap;align-items:center;gap:8px 12px;max-width:min(420px,calc(100vw - 32px));
+padding:12px 12px 12px 16px;border:1px solid var(--acr-border);border-radius:12px;background:var(--acr-bg);color:var(--acr-fg);box-shadow:0 10px 30px rgba(0,0,0,.2)}
+.toast .msg{flex:1 1 160px}
+@media (max-width:480px){.toast{left:16px;right:16px;max-width:none}}
+@media (prefers-reduced-motion:no-preference){.toast,.banner{animation:acr-in .18s ease-out}}
+@keyframes acr-in{from{opacity:0;transform:translateY(6px)}to{opacity:1;transform:none}}
+`;
+/**
+ * The default remote-control UI: maintenance screen, announcement banner and "new version available" prompt. It lives
+ * in the shadow root of one `<acr-ui>` element, so the page's CSS cannot reach it and its CSS cannot leak out. Server
+ * text is always inserted as text, never as HTML. The element is added only while something is shown.
+ */
+export class ControlUI {
+    constructor(options, actions) {
+        this.options = options;
+        this.actions = actions;
+        this.host = null;
+        this.wrap = null;
+        this.keys = { maintenance: '', banner: '', toast: '' };
+        this.elements = {};
+        this.dismissedToast = null;
+        this.lastState = null;
+        this.restoreFocus = null;
+        this.savedOverflow = null;
+        this.waitingForBody = false;
+    }
+    render(state) {
+        this.lastState = state;
+        if (typeof document === 'undefined')
+            return;
+        const maintenance = this.options.maintenance && state.maintenance.active ? state.maintenance : null;
+        const announcement = this.options.announcement && state.announcement && !state.announcement.dismissed ? state.announcement : null;
+        let toast = this.options.release ? toastModel(state) : null;
+        if (toast && toast.key === this.dismissedToast)
+            toast = null;
+        if (!maintenance && !announcement && !toast) {
+            this.unmount();
+            return;
+        }
+        if (!this.mount())
+            return;
+        this.update('maintenance', maintenance ? JSON.stringify(maintenance) : '', () => this.buildMaintenance(maintenance));
+        this.update('banner', announcement ? JSON.stringify(announcement) : '', () => this.buildBanner(announcement));
+        this.update('toast', toast ? `${toast.key}|${toast.text}` : '', () => this.buildToast(toast));
+    }
+    /** Removes the element and everything it shows. */
+    destroy() {
+        this.unmount();
+        this.lastState = null;
+    }
+    mount() {
+        if (this.wrap)
+            return true;
+        if (!document.body) {
+            if (!this.waitingForBody) {
+                this.waitingForBody = true;
+                document.addEventListener('DOMContentLoaded', () => {
+                    this.waitingForBody = false;
+                    if (this.lastState)
+                        this.render(this.lastState);
+                }, { once: true });
+            }
+            return false;
+        }
+        const host = document.createElement(UI_HOST_TAG);
+        if (typeof host.attachShadow !== 'function')
+            return false;
+        // Open so tests and developer tools can inspect it; the page's styles are isolated either way.
+        const root = host.attachShadow({ mode: 'open' });
+        const style = document.createElement('style');
+        style.textContent = STYLES;
+        const wrap = document.createElement('div');
+        wrap.className = 'wrap';
+        root.append(style, wrap);
+        document.body.appendChild(host);
+        this.host = host;
+        this.wrap = wrap;
+        return true;
+    }
+    unmount() {
+        for (const section of ['maintenance', 'banner', 'toast'])
+            this.update(section, '', () => null);
+        this.host?.remove();
+        this.host = null;
+        this.wrap = null;
+    }
+    /** Replaces a section only when its content changes, so focus and animations are not disturbed. */
+    update(section, key, build) {
+        if (this.keys[section] === key)
+            return;
+        const previous = this.elements[section];
+        if (previous) {
+            previous.remove();
+            delete this.elements[section];
+            if (section === 'maintenance')
+                this.onMaintenanceHidden();
+        }
+        this.keys[section] = key;
+        if (!key || !this.wrap)
+            return;
+        const element = build();
+        this.elements[section] = element;
+        this.wrap.appendChild(element);
+        if (section === 'maintenance')
+            this.onMaintenanceShown(element);
+    }
+    buildMaintenance(m) {
+        const overlay = el('div', 'overlay');
+        const dialog = el('div', 'dialog');
+        dialog.setAttribute('role', 'dialog');
+        dialog.setAttribute('aria-modal', 'true');
+        dialog.setAttribute('aria-labelledby', 'acr-maintenance-title');
+        dialog.setAttribute('aria-describedby', 'acr-maintenance-message');
+        dialog.tabIndex = -1;
+        const title = el('h2', '', m.title || 'Down for maintenance');
+        title.id = 'acr-maintenance-title';
+        const message = el('p', '', m.message || 'We are making some improvements and will be back shortly.');
+        message.id = 'acr-maintenance-message';
+        dialog.append(title, message);
+        const ends = formatDate(m.endsAt);
+        if (ends)
+            dialog.append(el('p', 'muted', `Expected back ${ends}`));
+        const retry = el('button', 'primary', 'Check again');
+        retry.type = 'button';
+        retry.addEventListener('click', () => this.actions.refresh());
+        dialog.append(retry);
+        overlay.append(dialog);
+        // Focus trap: Tab and Shift+Tab stay inside the dialog; Escape does nothing (maintenance is not dismissible).
+        overlay.addEventListener('keydown', (event) => {
+            if (event.key !== 'Tab')
+                return;
+            event.preventDefault();
+            const focusables = [retry];
+            const active = overlay.getRootNode().activeElement;
+            const index = focusables.indexOf(active);
+            const next = focusables[(index + (event.shiftKey ? -1 : 1) + focusables.length) % focusables.length];
+            next.focus();
+        });
+        return overlay;
+    }
+    onMaintenanceShown(overlay) {
+        const active = document.activeElement;
+        this.restoreFocus = active instanceof HTMLElement && active !== this.host ? active : null;
+        this.savedOverflow = document.documentElement.style.overflow;
+        document.documentElement.style.overflow = 'hidden';
+        overlay.querySelector('button')?.focus();
+    }
+    onMaintenanceHidden() {
+        if (this.savedOverflow !== null)
+            document.documentElement.style.overflow = this.savedOverflow;
+        this.savedOverflow = null;
+        const target = this.restoreFocus;
+        this.restoreFocus = null;
+        if (target && target.isConnected)
+            target.focus();
+    }
+    buildBanner(a) {
+        const banner = el('div', `banner sev-${a.severity}`);
+        // Critical and warning announcements interrupt screen readers; informational ones are polite.
+        banner.setAttribute('role', a.severity === 'info' ? 'status' : 'alert');
+        banner.setAttribute('aria-label', 'Announcement');
+        banner.append(el('span', 'msg', a.message));
+        if (a.linkUrl) {
+            const link = el('a', '', 'Learn more');
+            link.href = a.linkUrl;
+            link.target = '_blank';
+            link.rel = 'noopener noreferrer';
+            banner.append(link);
+        }
+        if (a.dismissible) {
+            const close = el('button', 'close', '×');
+            close.type = 'button';
+            close.setAttribute('aria-label', 'Dismiss announcement');
+            close.addEventListener('click', () => this.actions.dismissAnnouncement(a.id));
+            banner.append(close);
+            banner.addEventListener('keydown', (event) => {
+                if (event.key === 'Escape')
+                    this.actions.dismissAnnouncement(a.id);
+            });
+        }
+        return banner;
+    }
+    buildToast(t) {
+        const toast = el('div', 'toast');
+        toast.setAttribute('role', 'status');
+        toast.setAttribute('aria-live', 'polite');
+        toast.append(el('span', 'msg', t.text));
+        const reload = el('button', 'primary', 'Reload');
+        reload.type = 'button';
+        reload.addEventListener('click', () => this.actions.reload());
+        const close = el('button', 'close', '×');
+        close.type = 'button';
+        close.setAttribute('aria-label', 'Dismiss');
+        const dismiss = () => {
+            this.dismissedToast = t.key;
+            if (this.lastState)
+                this.render(this.lastState);
+        };
+        close.addEventListener('click', dismiss);
+        toast.addEventListener('keydown', (event) => {
+            if (event.key === 'Escape')
+                dismiss();
+        });
+        toast.append(reload, close);
+        return toast;
+    }
+}
+function toastModel(state) {
+    const r = state.release;
+    if (r?.belowMinimum)
+        return { key: `min:${r.minimumVersion}`, text: 'An update is required. Reload to get the latest version.' };
+    if (state.reloadRequested)
+        return { key: 'reload', text: 'A new version is available.' };
+    if (r?.updateAvailable)
+        return { key: `latest:${r.latestVersion}`, text: 'A new version is available.' };
+    return null;
+}
+function el(tag, className, text) {
+    const node = document.createElement(tag);
+    if (className)
+        node.className = className;
+    if (text !== undefined)
+        node.textContent = text;
+    return node;
+}
+function formatDate(iso) {
+    if (!iso)
+        return null;
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return null;
+    try {
+        return new Intl.DateTimeFormat(undefined, { dateStyle: 'medium', timeStyle: 'short' }).format(date);
+    }
+    catch {
+        return date.toLocaleString();
+    }
+}
+//# sourceMappingURL=ui.js.map

package/dist/esm/control/ui.js.map

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

package/dist/esm/device.js

@@ -0,0 +1,50 @@
+/** Coarse browser, OS and device class from a user agent string. No version numbers are kept for the OS. */
+export function parseUserAgent(ua) {
+    const browser = /Edg\//.test(ua) ? 'Edge'
+        : /OPR\/|Opera/.test(ua) ? 'Opera'
+            : /Firefox\//.test(ua) ? 'Firefox'
+                : /Chrome\//.test(ua) ? 'Chrome'
+                    : /Safari\//.test(ua) ? 'Safari'
+                        : 'Other';
+    const os = /Windows/.test(ua) ? 'Windows'
+        : /Android/.test(ua) ? 'Android'
+            : /iPhone|iPad|iPod/.test(ua) ? 'iOS'
+                : /Mac OS X|Macintosh/.test(ua) ? 'macOS'
+                    : /CrOS/.test(ua) ? 'ChromeOS'
+                        : /Linux/.test(ua) ? 'Linux'
+                            : 'Other';
+    const deviceType = /iPad|Tablet/.test(ua) ? 'tablet'
+        : /Mobi|iPhone|Android.+Mobile/.test(ua) ? 'mobile'
+            : ua ? 'desktop'
+                : 'unknown';
+    return { browser, os, deviceType };
+}
+/** Device and locale facts for session_start. Reads only what the browser exposes without a permission prompt. */
+export function getDeviceInfo(env = typeof navigator !== 'undefined' ? readGlobals() : {}) {
+    const parsed = parseUserAgent(env.userAgent ?? '');
+    let timezone = null;
+    try {
+        timezone = Intl.DateTimeFormat().resolvedOptions().timeZone ?? null;
+    }
+    catch {
+        timezone = null;
+    }
+    return {
+        ...parsed,
+        language: env.language ?? null,
+        timezone,
+        screen: env.screen ? `${env.screen.width}x${env.screen.height}` : null,
+        viewport: env.viewport ? `${env.viewport.width}x${env.viewport.height}` : null,
+    };
+}
+function readGlobals() {
+    const nav = typeof navigator !== 'undefined' ? navigator : undefined;
+    const win = typeof window !== 'undefined' ? window : undefined;
+    return {
+        userAgent: nav?.userAgent,
+        language: nav?.language,
+        screen: win?.screen ? { width: win.screen.width, height: win.screen.height } : undefined,
+        viewport: win ? { width: win.innerWidth, height: win.innerHeight } : undefined,
+    };
+}
+//# sourceMappingURL=device.js.map

package/dist/esm/device.js.map

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