@flighthq/device 0.1.0

package/README.md

@@ -0,0 +1,104 @@
+# @flighthq/device
+
+Device identity, hardware, and safe-area insets over a swappable web/native backend.
+
+`device` is a host-identity leaf in the platform-integration suite. Every public function is a free function that delegates to the active `DeviceBackend`. A web/DOM backend is lazily available, so every function works on the web; a native host (Electron, Tauri, Capacitor, a C/C++ shell) replaces it via `setDeviceBackend`. Snapshot reads fill an `out` value and return it. Unknown or unavailable fields resolve to sentinels (`''` / `-1` / `false`), never throwing.
+
+Battery state is **not** here — it is a live, event-bearing concern owned by `@flighthq/power`. `DeviceInfo` is a static identity snapshot. Live multi-display enumeration and work-area geometry belong to `@flighthq/screen`; `DeviceDisplayMetrics` describes only the built-in display.
+
+## Functions
+
+| Function | Purpose |
+| --- | --- |
+| `createDeviceCapabilities()` | Allocate a zeroed `DeviceCapabilities` (all `false`) to pass as `out`. |
+| `createDeviceDisplayMetrics()` | Allocate a zeroed `DeviceDisplayMetrics` (all `-1`) to pass as `out`. |
+| `createDeviceInfo()` | Allocate a zeroed `DeviceInfo` (strings `''`, booleans `false`, arrays `[]`, numbers `-1`) to pass as `out`. |
+| `createSafeAreaInsets()` | Allocate a zeroed `SafeAreaInsets` (all edges `0`) to pass as `out`. |
+| `createWebDeviceBackend()` | Build the default web backend. |
+| `enableWebSafeAreaInsets()` | Mount a CSS `env(safe-area-inset-*)` probe; returns a dispose function. Opt-in (touches the DOM). |
+| `getDeviceBackend()` | Return the active backend, lazily creating the web default. There is always a backend. |
+| `getDeviceCapabilities(out)` | Fill `out` with input/hardware capability flags. |
+| `getDeviceDisplayMetrics(out)` | Fill `out` with the built-in display metrics. |
+| `getDeviceId()` | Return a stable install identifier (resettable, not a hardware serial). |
+| `getDeviceInfo(out)` | Fill `out` with the device's identity snapshot. |
+| `getSafeAreaInsets(out)` | Fill `out` with safe-area insets, in CSS pixels. |
+| `refreshDeviceInfo()` | Invalidate a backend snapshot cache so the next read is fresh. No-op on the stateless web default. |
+| `setDeviceBackend(backend)` | Install a native host backend; pass `null` to fall back to the web default. |
+
+## `DeviceInfo` fields
+
+| Field | Type | Unit | Sentinel | Web backend |
+| --- | --- | --- | --- | --- |
+| `arch` | `string` | CPU architecture token (e.g. `x86_64`, `arm64`) | `''` | Parsed from the UA / `userAgentData.platform`. Best-effort. |
+| `availableMemory` | `number` | bytes of currently-available RAM | `-1` | Not exposed by browsers — always `-1`. |
+| `boardName` | `string` | hardware board / mainboard name | `''` | Not exposed — always `''`. |
+| `colorGamut` | `string` | display color gamut token | `''` | Not exposed — always `''`. |
+| `cpuCores` | `number` | logical CPU core count | `-1` | `navigator.hardwareConcurrency` when present. |
+| `fontScale` | `number` | OS font-scale multiplier (`1.0` = default) | `-1` | Not exposed — always `-1`. |
+| `formFactor` | `DeviceFormFactor` | physical device class (open string-kind: `Desktop`, `Phone`, `Tablet`, `TV`, `Watch`, `Car`, `Unknown`, or vendor-prefixed) | `'Unknown'` | Parsed from the UA + `maxTouchPoints`. |
+| `gpuRenderer` | `string` | GPU renderer string | `''` | `WEBGL_debug_renderer_info`; may be masked/randomized by browser privacy budget. |
+| `gpuVendor` | `string` | GPU vendor string | `''` | `WEBGL_debug_renderer_info`; same caveat. |
+| `isHdr` | `boolean` | display is HDR-capable | `false` | Not exposed — always `false`. |
+| `isJailbroken` | `boolean` | iOS jailbreak detected | `false` | No web detection — always `false`. |
+| `isLowEndDevice` | `boolean` | heuristically a low-end device | `false` | Heuristic: `≤ 1 GiB` RAM or `≤ 2` cores. Unknown inputs → `false`. |
+| `isRooted` | `boolean` | Android root detected | `false` | No web detection — always `false`. |
+| `isVirtual` | `boolean` | running on an emulator / VM | `false` | No web detection — always `false`. |
+| `manufacturer` | `string` | hardware manufacturer | `''` | Not exposed — always `''`. |
+| `marketingName` | `string` | consumer marketing name | `''` | Not exposed — always `''`. |
+| `model` | `string` | hardware model identifier | `''` | Not exposed — always `''`. |
+| `osBuild` | `string` | OS build number | `''` | Not exposed — always `''`. |
+| `osName` | `string` | OS name | `''` | Parsed from the UA. |
+| `osVersion` | `string` | OS version string | `''` | Parsed from the UA. |
+| `platformString` | `string` | raw platform identifier | `''` | The full UA string. |
+| `productName` | `string` | product / device codename | `''` | Not exposed — always `''`. |
+| `supportedAbis` | `readonly string[]` | supported native ABIs | `[]` | Not exposed — always `[]`. |
+| `totalMemory` | `number` | bytes of total RAM | `-1` | `navigator.deviceMemory` (GiB) converted to bytes; coarse, privacy-clamped. |
+| `webViewVersion` | `string` | host WebView version | `''` | Not applicable (we are the browser) — always `''`. |
+
+## `DeviceCapabilities` fields
+
+| Field | Type | Sentinel | Web backend |
+| --- | --- | --- | --- |
+| `hasKeyboard` | `boolean` | `false` | Heuristic: desktop UA likely has a physical keyboard. Cannot distinguish hybrid (Surface, iPad + keyboard). |
+| `hasMouse` | `boolean` | `false` | Heuristic: `maxTouchPoints === 0` is a strong pointer-device signal. Cannot confirm a physical mouse. |
+| `hasStylus` | `boolean` | `false` | No reliable browser signal — always `false`. |
+
+Richer pointer/keyboard event handling lives in `@flighthq/input` and `@flighthq/interaction`; `DeviceCapabilities` only surfaces capabilities with no dedicated package owner.
+
+## `DeviceDisplayMetrics` fields
+
+| Field | Type | Unit | Sentinel | Web backend |
+| --- | --- | --- | --- | --- |
+| `colorDepth` | `number` | bits per pixel | `-1` | `screen.colorDepth`. |
+| `densityDpi` | `number` | dots per inch | `-1` | Not exposed by browsers — always `-1`. |
+| `logicalHeight` | `number` | CSS pixels | `-1` | `screen.height`. |
+| `logicalWidth` | `number` | CSS pixels | `-1` | `screen.width`. |
+| `physicalHeight` | `number` | device pixels | `-1` | `screen.height × devicePixelRatio` when the ratio is known. |
+| `physicalWidth` | `number` | device pixels | `-1` | `screen.width × devicePixelRatio` when the ratio is known. |
+| `pixelRatio` | `number` | device pixels per CSS pixel | `-1` | `window.devicePixelRatio`. |
+
+## `SafeAreaInsets` fields
+
+| Field | Type | Unit | Sentinel | Web backend |
+| --- | --- | --- | --- | --- |
+| `top` | `number` | CSS pixels | `0` | `0` by default; real `env(safe-area-inset-top)` after `enableWebSafeAreaInsets()`. |
+| `right` | `number` | CSS pixels | `0` | `0` by default; real `env(safe-area-inset-right)` after `enableWebSafeAreaInsets()`. |
+| `bottom` | `number` | CSS pixels | `0` | `0` by default; real `env(safe-area-inset-bottom)` after `enableWebSafeAreaInsets()`. |
+| `left` | `number` | CSS pixels | `0` | `0` by default; real `env(safe-area-inset-left)` after `enableWebSafeAreaInsets()`. |
+
+Edge insets keep content clear of notches, rounded corners, and system bars. The web backend returns zeros until `enableWebSafeAreaInsets()` mounts a live CSS-var probe (one hidden element, no polling).
+
+## `getDeviceId`
+
+The web default generates a `crypto.randomUUID()` and persists it to `localStorage` as a stable install id. It returns `''` when no stable id can be formed (SSR, blocked storage, privacy mode). This is an **install** id — it resets when storage is cleared — not a hardware serial.
+
+## Usage
+
+```ts
+import { createDeviceInfo, getDeviceInfo, getDeviceId } from '@flighthq/device';
+
+const info = getDeviceInfo(createDeviceInfo());
+console.log(info.formFactor, info.osName, info.cpuCores);
+
+const installId = getDeviceId();
+```

package/dist/device.d.ts

@@ -0,0 +1,16 @@
+import type { DeviceBackend, DeviceCapabilities, DeviceDisplayMetrics, DeviceInfo, SafeAreaInsets } from '@flighthq/types';
+export declare function createDeviceCapabilities(): DeviceCapabilities;
+export declare function createDeviceDisplayMetrics(): DeviceDisplayMetrics;
+export declare function createDeviceInfo(): DeviceInfo;
+export declare function createSafeAreaInsets(): SafeAreaInsets;
+export declare function createWebDeviceBackend(): DeviceBackend;
+export declare function enableWebSafeAreaInsets(): () => void;
+export declare function getDeviceBackend(): DeviceBackend;
+export declare function getDeviceCapabilities(out: DeviceCapabilities): DeviceCapabilities;
+export declare function getDeviceDisplayMetrics(out: DeviceDisplayMetrics): DeviceDisplayMetrics;
+export declare function getDeviceId(): string;
+export declare function getDeviceInfo(out: DeviceInfo): DeviceInfo;
+export declare function getSafeAreaInsets(out: SafeAreaInsets): SafeAreaInsets;
+export declare function refreshDeviceInfo(): void;
+export declare function setDeviceBackend(backend: DeviceBackend | null): void;
+//# sourceMappingURL=device.d.ts.map

package/dist/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,cAAc,EACf,MAAM,iBAAiB,CAAC;AAWzB,wBAAgB,wBAAwB,IAAI,kBAAkB,CAM7D;AAID,wBAAgB,0BAA0B,IAAI,oBAAoB,CAUjE;AAID,wBAAgB,gBAAgB,IAAI,UAAU,CA4B7C;AAGD,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAID,wBAAgB,sBAAsB,IAAI,aAAa,CA4GtD;AAOD,wBAAgB,uBAAuB,IAAI,MAAM,IAAI,CA+BpD;AAGD,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,kBAAkB,CAEjF;AAID,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,oBAAoB,GAAG,oBAAoB,CAEvF;AAMD,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAGD,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAEzD;AAID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,cAAc,CAErE;AAOD,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAGD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAEpE"}

package/dist/device.js

@@ -0,0 +1,296 @@
+import { DeviceFormFactorUnknown } from '@flighthq/types';
+import { parseUserAgentArch, parseUserAgentFormFactor, parseUserAgentOsName, parseUserAgentOsVersion, } from '@flighthq/useragent';
+// Allocates a zeroed DeviceCapabilities; use as the `out` for getDeviceCapabilities.
+// All boolean fields default to false (unknown).
+export function createDeviceCapabilities() {
+    return {
+        hasKeyboard: false,
+        hasMouse: false,
+        hasStylus: false,
+    };
+}
+// Allocates a zeroed DeviceDisplayMetrics; use as the `out` for getDeviceDisplayMetrics.
+// All numeric fields default to -1 when unknown.
+export function createDeviceDisplayMetrics() {
+    return {
+        colorDepth: -1,
+        densityDpi: -1,
+        logicalHeight: -1,
+        logicalWidth: -1,
+        physicalHeight: -1,
+        physicalWidth: -1,
+        pixelRatio: -1,
+    };
+}
+// Allocates a zeroed DeviceInfo; use as the `out` for getDeviceInfo or when building a backend.
+// Strings default to '', booleans to false, arrays to [], and unknown-numeric fields to -1.
+export function createDeviceInfo() {
+    return {
+        arch: '',
+        availableMemory: -1,
+        boardName: '',
+        colorGamut: '',
+        cpuCores: -1,
+        fontScale: -1,
+        formFactor: DeviceFormFactorUnknown,
+        gpuRenderer: '',
+        gpuVendor: '',
+        isHdr: false,
+        isJailbroken: false,
+        isLowEndDevice: false,
+        isRooted: false,
+        isVirtual: false,
+        manufacturer: '',
+        marketingName: '',
+        model: '',
+        osBuild: '',
+        osName: '',
+        osVersion: '',
+        platformString: '',
+        productName: '',
+        supportedAbis: [],
+        totalMemory: -1,
+        webViewVersion: '',
+    };
+}
+// Allocates a zeroed SafeAreaInsets (all edges 0); use as the `out` for getSafeAreaInsets.
+export function createSafeAreaInsets() {
+    return { bottom: 0, left: 0, right: 0, top: 0 };
+}
+// Builds the default web backend. Reads what the browser exposes and returns sentinels for
+// everything a web page cannot know (model/manufacturer, OS version, safe area, DPI).
+export function createWebDeviceBackend() {
+    return {
+        getCapabilities(out) {
+            const nav = typeof navigator !== 'undefined' ? navigator : null;
+            // hasMouse: weak heuristic — no touch points is a strong desktop / pointer-device signal.
+            // This is best-effort; the browser cannot confirm whether a physical mouse is attached.
+            const maxTouch = nav !== null && 'maxTouchPoints' in nav ? nav.maxTouchPoints : -1;
+            out.hasMouse = maxTouch === 0;
+            // hasKeyboard: desktop UAs very likely have a physical keyboard; mobile UAs likely do not.
+            // Cannot distinguish virtual + physical keyboard on hybrid devices (Surface, iPad with keyboard).
+            const ua = nav?.userAgent ?? '';
+            out.hasKeyboard = detectDesktopUa(ua);
+            // hasStylus: no reliable UA or API signal in browsers — always false.
+            out.hasStylus = false;
+            return out;
+        },
+        getDisplayMetrics(out) {
+            const win = typeof window !== 'undefined' ? window : null;
+            const scr = typeof screen !== 'undefined' ? screen : null;
+            out.colorDepth = scr !== null ? scr.colorDepth : -1;
+            // DPI is not exposed by browsers — always sentinel.
+            out.densityDpi = -1;
+            out.logicalHeight = scr !== null ? scr.height : -1;
+            out.logicalWidth = scr !== null ? scr.width : -1;
+            const pixelRatio = win !== null ? win.devicePixelRatio : -1;
+            out.pixelRatio = pixelRatio;
+            out.physicalWidth = scr !== null && pixelRatio > 0 ? Math.round(scr.width * pixelRatio) : -1;
+            out.physicalHeight = scr !== null && pixelRatio > 0 ? Math.round(scr.height * pixelRatio) : -1;
+            return out;
+        },
+        getId() {
+            // Web: crypto.randomUUID() persisted to localStorage as a stable install id.
+            // Returns '' when storage is unavailable (SSR, private browsing with blocked storage).
+            // This is an install id — it resets if localStorage is cleared. Not a hardware serial.
+            // For a durable cross-storage id, use @flighthq/storage as the backend's persistence layer.
+            try {
+                const key = '__flighthq_device_id';
+                const existing = typeof localStorage !== 'undefined' ? localStorage.getItem(key) : null;
+                if (existing !== null)
+                    return existing;
+                if (typeof crypto === 'undefined' || typeof crypto.randomUUID !== 'function')
+                    return '';
+                const id = crypto.randomUUID();
+                if (typeof localStorage !== 'undefined')
+                    localStorage.setItem(key, id);
+                return id;
+            }
+            catch {
+                return '';
+            }
+        },
+        getInfo(out) {
+            const nav = typeof navigator !== 'undefined' ? navigator : null;
+            const ua = nav?.userAgent ?? '';
+            const uadPlatform = nav?.userAgentData
+                ?.platform;
+            out.arch = parseUserAgentArch(ua, uadPlatform);
+            // availableMemory is not exposed by browsers — always -1.
+            out.availableMemory = -1;
+            // boardName, marketingName, productName, supportedAbis — not exposed by browsers.
+            out.boardName = '';
+            // colorGamut, fontScale, isHdr — not exposed by browsers.
+            out.colorGamut = '';
+            const cores = nav !== null && 'hardwareConcurrency' in nav ? (nav.hardwareConcurrency ?? -1) : -1;
+            out.cpuCores = cores;
+            out.fontScale = -1;
+            out.formFactor = parseUserAgentFormFactor(ua, nav !== null && 'maxTouchPoints' in nav ? nav.maxTouchPoints : -1);
+            const gpuInfo = readWebGpuInfo();
+            out.gpuRenderer = gpuInfo.renderer;
+            out.gpuVendor = gpuInfo.vendor;
+            out.isHdr = false;
+            // isJailbroken and isRooted are always false on web — no detection available.
+            out.isJailbroken = false;
+            const devMem = nav !== null && 'deviceMemory' in nav ? (nav.deviceMemory ?? -1) : -1;
+            out.isLowEndDevice = detectLowEndDevice(devMem, cores);
+            out.isRooted = false;
+            out.isVirtual = false;
+            out.manufacturer = '';
+            out.marketingName = '';
+            out.model = '';
+            out.osBuild = '';
+            out.osName = parseUserAgentOsName(ua);
+            out.osVersion = parseUserAgentOsVersion(ua);
+            out.platformString = ua;
+            out.productName = '';
+            out.supportedAbis = [];
+            // totalMemory: navigator.deviceMemory is in GiB; convert to bytes. -1 when absent.
+            out.totalMemory = devMem >= 0 ? devMem * 1024 * 1024 * 1024 : -1;
+            // webViewVersion is not exposed by browsers (we are the browser).
+            out.webViewVersion = '';
+            return out;
+        },
+        getSafeAreaInsets(out) {
+            // Reading CSS env(safe-area-inset-*) requires a probe element in the DOM. The web backend
+            // returns zero insets by default. Call enableWebSafeAreaInsets() to mount a live CSS-var probe
+            // that updates this when the device reports real insets (notched PWAs).
+            const insets = _safeAreaInsets;
+            if (insets !== null) {
+                out.bottom = insets.bottom;
+                out.left = insets.left;
+                out.right = insets.right;
+                out.top = insets.top;
+            }
+            else {
+                out.bottom = 0;
+                out.left = 0;
+                out.right = 0;
+                out.top = 0;
+            }
+            return out;
+        },
+    };
+}
+// Mounts a CSS env(safe-area-inset-*) probe element in the DOM and keeps the active web backend's
+// safe-area values live. Call once after the page is ready; unmount by calling the returned dispose
+// function. Has no effect when called outside of a browser context (SSR, workers). The probe is
+// cheap: one hidden element, no polling — a ResizeObserver detects viewport changes.
+// Returns a dispose function that removes the probe element and stops the observer.
+export function enableWebSafeAreaInsets() {
+    if (typeof document === 'undefined')
+        return () => { };
+    const el = document.createElement('div');
+    el.style.cssText =
+        'position:fixed;top:env(safe-area-inset-top,0px);right:env(safe-area-inset-right,0px);' +
+            'bottom:env(safe-area-inset-bottom,0px);left:env(safe-area-inset-left,0px);' +
+            'pointer-events:none;visibility:hidden;';
+    document.body.appendChild(el);
+    function readInsets() {
+        const style = getComputedStyle(el);
+        _safeAreaInsets = {
+            bottom: parseFloat(style.bottom) || 0,
+            left: parseFloat(style.left) || 0,
+            right: parseFloat(style.right) || 0,
+            top: parseFloat(style.top) || 0,
+        };
+    }
+    readInsets();
+    // ResizeObserver may be absent in older browsers or test environments; fall back to a no-op.
+    const observer = typeof ResizeObserver !== 'undefined' ? new ResizeObserver(readInsets) : null;
+    if (observer !== null)
+        observer.observe(document.documentElement);
+    return () => {
+        if (observer !== null)
+            observer.disconnect();
+        el.parentNode?.removeChild(el);
+        _safeAreaInsets = null;
+    };
+}
+// Returns the active device backend, or a lazily-created web default. There is always a backend.
+export function getDeviceBackend() {
+    if (_backend === null)
+        _backend = createWebDeviceBackend();
+    return _backend;
+}
+// Fills `out` with the device's input/hardware capability flags and returns it.
+// Only surfaces capabilities with no dedicated package owner; see DeviceCapabilities for cross-refs.
+export function getDeviceCapabilities(out) {
+    return getDeviceBackend().getCapabilities(out);
+}
+// Fills `out` with the device's built-in display metrics and returns it. Reads the active backend.
+// For live multi-display enumeration and work-area geometry, use @flighthq/screen.
+export function getDeviceDisplayMetrics(out) {
+    return getDeviceBackend().getDisplayMetrics(out);
+}
+// Returns a stable install identifier for this device/app install. Backed by DeviceBackend.getId().
+// Web default: crypto.randomUUID() persisted to localStorage. Returns '' when no stable id can be
+// formed (SSR, blocked storage, privacy mode). This is an _install_ id — resettable by clearing
+// storage — not a hardware serial.
+export function getDeviceId() {
+    return getDeviceBackend().getId();
+}
+// Fills `out` with the running device's identity and returns it. Reads the active backend.
+export function getDeviceInfo(out) {
+    return getDeviceBackend().getInfo(out);
+}
+// Fills `out` with the device's safe-area insets, in CSS pixels, and returns it.
+// Web: returns zeros by default; call enableWebSafeAreaInsets() for real CSS env() values.
+export function getSafeAreaInsets(out) {
+    return getDeviceBackend().getSafeAreaInsets(out);
+}
+// Invalidates any snapshot cached in the active backend and triggers a fresh read on the next call
+// to getDeviceInfo / getSafeAreaInsets / getDeviceDisplayMetrics. Useful for orientation-affected
+// safe-area insets and available-memory reads that may change at runtime.
+// The web default backend is stateless (no cache), so this is a no-op there; native backends that
+// cache a snapshot must listen for this signal and invalidate their cache.
+export function refreshDeviceInfo() {
+    const backend = getDeviceBackend();
+    const maybeRefreshable = backend;
+    if (typeof maybeRefreshable.refresh === 'function') {
+        maybeRefreshable.refresh();
+    }
+}
+// Installs a native host device backend; pass null to fall back to the web default.
+export function setDeviceBackend(backend) {
+    _backend = backend;
+}
+let _backend = null;
+let _safeAreaInsets = null;
+// ---------------------------------------------------------------------------
+// Web-backend detection helpers (private)
+// ---------------------------------------------------------------------------
+function detectDesktopUa(ua) {
+    return /win(?:dows)?nt|macintosh|mac os x|linux(?!.*android)|cros|x11/i.test(ua);
+}
+function detectLowEndDevice(deviceMemoryGib, cores) {
+    // Low-end heuristic: <= 1 GiB RAM or <= 2 cores. Both sentinels (-1) = unknown = false.
+    if (deviceMemoryGib > 0 && deviceMemoryGib <= 1)
+        return true;
+    if (cores > 0 && cores <= 2)
+        return true;
+    return false;
+}
+function readWebGpuInfo() {
+    // Reads WEBGL_debug_renderer_info from a transient WebGL context. Returns '' when unavailable or
+    // blocked by browser privacy budget. This is best-effort — modern browsers may mask or randomize.
+    try {
+        if (typeof document === 'undefined')
+            return { renderer: '', vendor: '' };
+        const canvas = document.createElement('canvas');
+        const gl = canvas.getContext('webgl') ??
+            canvas.getContext('experimental-webgl');
+        if (gl === null)
+            return { renderer: '', vendor: '' };
+        const ext = gl.getExtension('WEBGL_debug_renderer_info');
+        if (ext === null)
+            return { renderer: '', vendor: '' };
+        const vendor = gl.getParameter(ext.UNMASKED_VENDOR_WEBGL) ?? '';
+        const renderer = gl.getParameter(ext.UNMASKED_RENDERER_WEBGL) ?? '';
+        return { renderer, vendor };
+    }
+    catch {
+        return { renderer: '', vendor: '' };
+    }
+}
+//# sourceMappingURL=device.js.map

package/dist/device.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './device';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './device';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/device",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.1.0",
+    "@flighthq/useragent": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Device identity, hardware, and safe-area insets over a swappable web/native backend",
+  "sideEffects": false
+}

package/src/device.test.ts

@@ -0,0 +1,384 @@
+import type {
+  DeviceBackend,
+  DeviceCapabilities,
+  DeviceDisplayMetrics,
+  DeviceInfo,
+  SafeAreaInsets,
+} from '@flighthq/types';
+import { DeviceFormFactorDesktop, DeviceFormFactorPhone, DeviceFormFactorUnknown } from '@flighthq/types';
+
+import {
+  createDeviceCapabilities,
+  createDeviceDisplayMetrics,
+  createDeviceInfo,
+  createSafeAreaInsets,
+  createWebDeviceBackend,
+  enableWebSafeAreaInsets,
+  getDeviceBackend,
+  getDeviceCapabilities,
+  getDeviceDisplayMetrics,
+  getDeviceId,
+  getDeviceInfo,
+  getSafeAreaInsets,
+  refreshDeviceInfo,
+  setDeviceBackend,
+} from './device';
+
+function fakeBackend(): DeviceBackend {
+  return {
+    getCapabilities(out: DeviceCapabilities): DeviceCapabilities {
+      out.hasKeyboard = true;
+      out.hasMouse = true;
+      out.hasStylus = false;
+      return out;
+    },
+    getDisplayMetrics(out: DeviceDisplayMetrics): DeviceDisplayMetrics {
+      out.colorDepth = 8;
+      out.densityDpi = 440;
+      out.logicalHeight = 800;
+      out.logicalWidth = 360;
+      out.physicalHeight = 1600;
+      out.physicalWidth = 720;
+      out.pixelRatio = 2;
+      return out;
+    },
+    getId(): string {
+      return 'test-device-id';
+    },
+    getInfo(out: DeviceInfo): DeviceInfo {
+      out.arch = 'arm64';
+      out.availableMemory = 3_000_000_000;
+      out.boardName = 'msm8998';
+      out.colorGamut = 'display-p3';
+      out.cpuCores = 8;
+      out.fontScale = 1.2;
+      out.formFactor = 'Phone';
+      out.gpuRenderer = 'Adreno 650';
+      out.gpuVendor = 'Qualcomm';
+      out.isHdr = true;
+      out.isJailbroken = false;
+      out.isLowEndDevice = false;
+      out.isRooted = false;
+      out.isVirtual = true;
+      out.manufacturer = 'Google';
+      out.marketingName = 'Pixel 8 Pro';
+      out.model = 'Pixel';
+      out.osBuild = 'TP1A.220624.014';
+      out.osName = 'Android';
+      out.osVersion = '14';
+      out.platformString = 'Linux armv8l';
+      out.productName = 'husky';
+      out.supportedAbis = ['arm64-v8a', 'armeabi-v7a'];
+      out.totalMemory = 8_000_000_000;
+      out.webViewVersion = '120.0.6099.230';
+      return out;
+    },
+    getSafeAreaInsets(out: SafeAreaInsets): SafeAreaInsets {
+      out.bottom = 16;
+      out.left = 0;
+      out.right = 0;
+      out.top = 24;
+      return out;
+    },
+  };
+}
+
+afterEach(() => setDeviceBackend(null));
+
+describe('createDeviceCapabilities', () => {
+  it('allocates a zeroed snapshot with all false capability flags', () => {
+    const caps = createDeviceCapabilities();
+    expect(caps.hasKeyboard).toBe(false);
+    expect(caps.hasMouse).toBe(false);
+    expect(caps.hasStylus).toBe(false);
+  });
+});
+
+describe('createDeviceDisplayMetrics', () => {
+  it('allocates a zeroed snapshot with -1 numeric sentinels', () => {
+    const metrics = createDeviceDisplayMetrics();
+    expect(metrics.colorDepth).toBe(-1);
+    expect(metrics.densityDpi).toBe(-1);
+    expect(metrics.logicalHeight).toBe(-1);
+    expect(metrics.logicalWidth).toBe(-1);
+    expect(metrics.physicalHeight).toBe(-1);
+    expect(metrics.physicalWidth).toBe(-1);
+    expect(metrics.pixelRatio).toBe(-1);
+  });
+});
+
+describe('createDeviceInfo', () => {
+  it('allocates zeroed snapshot with string, boolean, and -1 numeric sentinels', () => {
+    const info = createDeviceInfo();
+    expect(info.arch).toBe('');
+    expect(info.availableMemory).toBe(-1);
+    expect(info.boardName).toBe('');
+    expect(info.colorGamut).toBe('');
+    expect(info.cpuCores).toBe(-1);
+    expect(info.fontScale).toBe(-1);
+    expect(info.formFactor).toBe(DeviceFormFactorUnknown);
+    expect(info.gpuRenderer).toBe('');
+    expect(info.gpuVendor).toBe('');
+    expect(info.isHdr).toBe(false);
+    expect(info.isJailbroken).toBe(false);
+    expect(info.isLowEndDevice).toBe(false);
+    expect(info.isRooted).toBe(false);
+    expect(info.isVirtual).toBe(false);
+    expect(info.manufacturer).toBe('');
+    expect(info.marketingName).toBe('');
+    expect(info.model).toBe('');
+    expect(info.osBuild).toBe('');
+    expect(info.osName).toBe('');
+    expect(info.osVersion).toBe('');
+    expect(info.platformString).toBe('');
+    expect(info.productName).toBe('');
+    expect(info.supportedAbis).toEqual([]);
+    expect(info.totalMemory).toBe(-1);
+    expect(info.webViewVersion).toBe('');
+  });
+});
+
+describe('createSafeAreaInsets', () => {
+  it('allocates zeroed edges', () => {
+    expect(createSafeAreaInsets()).toEqual({ bottom: 0, left: 0, right: 0, top: 0 });
+  });
+});
+
+describe('createWebDeviceBackend', () => {
+  it('fills the snapshot with sentinels without throwing (jsdom)', () => {
+    const backend = createWebDeviceBackend();
+    const info = backend.getInfo(createDeviceInfo());
+    expect(info.model).toBe('');
+    expect(info.manufacturer).toBe('');
+    expect(info.marketingName).toBe('');
+    expect(info.productName).toBe('');
+    expect(info.boardName).toBe('');
+    expect(info.webViewVersion).toBe('');
+    expect(info.colorGamut).toBe('');
+    expect(info.fontScale).toBe(-1);
+    expect(info.isHdr).toBe(false);
+    expect(typeof info.totalMemory).toBe('number');
+    expect(info.availableMemory).toBe(-1);
+    expect(typeof info.cpuCores).toBe('number');
+    expect(info.isJailbroken).toBe(false);
+    expect(info.isRooted).toBe(false);
+    expect(info.osBuild).toBe('');
+    expect(typeof info.formFactor).toBe('string');
+    expect(typeof info.arch).toBe('string');
+    expect(info.platformString).toBe(navigator.userAgent);
+    expect(Array.isArray(info.supportedAbis)).toBe(true);
+    expect(info.supportedAbis.length).toBe(0);
+  });
+
+  it('returns zero safe-area insets on plain web (no CSS probe)', () => {
+    const backend = createWebDeviceBackend();
+    expect(backend.getSafeAreaInsets(createSafeAreaInsets())).toEqual({ bottom: 0, left: 0, right: 0, top: 0 });
+  });
+
+  it('getId returns a string (empty or a UUID) without throwing', () => {
+    const backend = createWebDeviceBackend();
+    const id = backend.getId();
+    expect(typeof id).toBe('string');
+  });
+
+  it('getId returns the same value on repeated calls (stable install id)', () => {
+    const backend = createWebDeviceBackend();
+    const id1 = backend.getId();
+    const id2 = backend.getId();
+    if (id1 !== '') {
+      expect(id1).toBe(id2);
+    }
+  });
+
+  it('returns display metrics with a valid pixel ratio from jsdom', () => {
+    const backend = createWebDeviceBackend();
+    const metrics = backend.getDisplayMetrics(createDeviceDisplayMetrics());
+    // jsdom exposes window.devicePixelRatio = 1 and screen.width/height
+    expect(typeof metrics.pixelRatio).toBe('number');
+    expect(typeof metrics.logicalWidth).toBe('number');
+  });
+
+  it('totalMemory converts deviceMemory GiB to bytes', () => {
+    // Patch navigator.deviceMemory to a known value
+    const nav = navigator as unknown as Record<string, unknown>;
+    const original = nav['deviceMemory'];
+    try {
+      Object.defineProperty(navigator, 'deviceMemory', { configurable: true, value: 4 });
+      const backend = createWebDeviceBackend();
+      const info = backend.getInfo(createDeviceInfo());
+      expect(info.totalMemory).toBe(4 * 1024 * 1024 * 1024);
+    } finally {
+      if (original !== undefined) {
+        Object.defineProperty(navigator, 'deviceMemory', { configurable: true, value: original });
+      } else {
+        // jsdom has no deviceMemory; delete the injected one so it does not leak into a shared worker.
+        delete (navigator as unknown as Record<string, unknown>)['deviceMemory'];
+      }
+    }
+  });
+
+  it('osVersion parses Android version from UA', () => {
+    const backend = createWebDeviceBackend();
+    const result = backend.getInfo(createDeviceInfo());
+    // jsdom UA results in a string; actual parsing is covered by useragent unit tests
+    expect(typeof result.osVersion).toBe('string');
+  });
+
+  it('getCapabilities returns a capability snapshot without throwing', () => {
+    const backend = createWebDeviceBackend();
+    const caps = backend.getCapabilities(createDeviceCapabilities());
+    expect(typeof caps.hasKeyboard).toBe('boolean');
+    expect(typeof caps.hasMouse).toBe('boolean');
+    expect(caps.hasStylus).toBe(false);
+  });
+});
+
+describe('enableWebSafeAreaInsets', () => {
+  it('returns a dispose function and does not throw in jsdom', () => {
+    const dispose = enableWebSafeAreaInsets();
+    expect(typeof dispose).toBe('function');
+    dispose();
+  });
+});
+
+describe('getDeviceBackend', () => {
+  it('falls back to a web backend when none is set', () => {
+    expect(getDeviceBackend()).not.toBeNull();
+  });
+
+  it('returns the registered backend', () => {
+    const backend = fakeBackend();
+    setDeviceBackend(backend);
+    expect(getDeviceBackend()).toBe(backend);
+  });
+});
+
+describe('getDeviceCapabilities', () => {
+  it('fills and returns out via the active backend', () => {
+    setDeviceBackend(fakeBackend());
+    const out = createDeviceCapabilities();
+    const result = getDeviceCapabilities(out);
+    expect(result).toBe(out);
+    expect(out.hasKeyboard).toBe(true);
+    expect(out.hasMouse).toBe(true);
+    expect(out.hasStylus).toBe(false);
+  });
+});
+
+describe('getDeviceDisplayMetrics', () => {
+  it('fills and returns out via the active backend', () => {
+    setDeviceBackend(fakeBackend());
+    const out = createDeviceDisplayMetrics();
+    const result = getDeviceDisplayMetrics(out);
+    expect(result).toBe(out);
+    expect(out.colorDepth).toBe(8);
+    expect(out.densityDpi).toBe(440);
+    expect(out.logicalHeight).toBe(800);
+    expect(out.logicalWidth).toBe(360);
+    expect(out.physicalHeight).toBe(1600);
+    expect(out.physicalWidth).toBe(720);
+    expect(out.pixelRatio).toBe(2);
+  });
+});
+
+describe('getDeviceId', () => {
+  it('returns a string without throwing', () => {
+    expect(typeof getDeviceId()).toBe('string');
+  });
+
+  it('returns the value from a registered backend', () => {
+    setDeviceBackend(fakeBackend());
+    expect(getDeviceId()).toBe('test-device-id');
+  });
+
+  it('returns a stable value across two reads (web fallback)', () => {
+    const id1 = getDeviceId();
+    const id2 = getDeviceId();
+    if (id1 !== '') {
+      expect(id1).toBe(id2);
+    }
+  });
+});
+
+describe('getDeviceInfo', () => {
+  it('fills and returns out via the active backend', () => {
+    setDeviceBackend(fakeBackend());
+    const out = createDeviceInfo();
+    const result = getDeviceInfo(out);
+    expect(result).toBe(out);
+    expect(out.arch).toBe('arm64');
+    expect(out.availableMemory).toBe(3_000_000_000);
+    expect(out.boardName).toBe('msm8998');
+    expect(out.colorGamut).toBe('display-p3');
+    expect(out.cpuCores).toBe(8);
+    expect(out.fontScale).toBe(1.2);
+    expect(out.formFactor).toBe(DeviceFormFactorPhone);
+    expect(out.gpuRenderer).toBe('Adreno 650');
+    expect(out.gpuVendor).toBe('Qualcomm');
+    expect(out.isHdr).toBe(true);
+    expect(out.isJailbroken).toBe(false);
+    expect(out.isLowEndDevice).toBe(false);
+    expect(out.isRooted).toBe(false);
+    expect(out.isVirtual).toBe(true);
+    expect(out.manufacturer).toBe('Google');
+    expect(out.marketingName).toBe('Pixel 8 Pro');
+    expect(out.model).toBe('Pixel');
+    expect(out.osBuild).toBe('TP1A.220624.014');
+    expect(out.osName).toBe('Android');
+    expect(out.osVersion).toBe('14');
+    expect(out.platformString).toBe('Linux armv8l');
+    expect(out.productName).toBe('husky');
+    expect(out.supportedAbis).toEqual(['arm64-v8a', 'armeabi-v7a']);
+    expect(out.totalMemory).toBe(8_000_000_000);
+    expect(out.webViewVersion).toBe('120.0.6099.230');
+  });
+
+  it('web backend returns Desktop formFactor for desktop UA', () => {
+    const backend = createWebDeviceBackend();
+    const info = backend.getInfo(createDeviceInfo());
+    // jsdom uses a desktop UA, so formFactor should be Desktop or Unknown
+    expect([DeviceFormFactorDesktop, DeviceFormFactorUnknown]).toContain(info.formFactor);
+  });
+});
+
+describe('getSafeAreaInsets', () => {
+  it('fills and returns out via the active backend', () => {
+    setDeviceBackend(fakeBackend());
+    const out = createSafeAreaInsets();
+    const result = getSafeAreaInsets(out);
+    expect(result).toBe(out);
+    expect(out.top).toBe(24);
+    expect(out.bottom).toBe(16);
+  });
+});
+
+describe('refreshDeviceInfo', () => {
+  it('does not throw on the default web backend', () => {
+    expect(() => refreshDeviceInfo()).not.toThrow();
+  });
+
+  it('calls refresh() on backends that expose it', () => {
+    let refreshed = false;
+    const backend = {
+      ...fakeBackend(),
+      refresh() {
+        refreshed = true;
+      },
+    };
+    setDeviceBackend(backend);
+    refreshDeviceInfo();
+    expect(refreshed).toBe(true);
+  });
+});
+
+describe('setDeviceBackend', () => {
+  it('clears back to the web fallback when passed null', () => {
+    setDeviceBackend(fakeBackend());
+    setDeviceBackend(null);
+    expect(getDeviceBackend()).not.toBeNull();
+    // After reset, should be the web backend (not the fake)
+    const out = createDeviceInfo();
+    getDeviceInfo(out);
+    expect(out.model).toBe('');
+  });
+});