@flighthq/useragent 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { detectEndianness, parseUserAgentArch, parseUserAgentEngine, parseUserAgentEngineVersion, parseUserAgentKind, parseUserAgentName, parseUserAgentPointerWidth, parseUserAgentRuntime, parseUserAgentVersion, } from './userAgent';
+export { parseUserAgentFormFactor, parseUserAgentOsName, parseUserAgentOsVersion } from './userAgentParse';
+//# 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,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { detectEndianness, parseUserAgentArch, parseUserAgentEngine, parseUserAgentEngineVersion, parseUserAgentKind, parseUserAgentName, parseUserAgentPointerWidth, parseUserAgentRuntime, parseUserAgentVersion, } from './userAgent';
+export { parseUserAgentFormFactor, parseUserAgentOsName, parseUserAgentOsVersion } from './userAgentParse';
+//# 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,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/userAgent.d.ts

@@ -0,0 +1,11 @@
+import type { PlatformEndianness, PlatformEngine, PlatformKind, PlatformName, PlatformRuntime } from '@flighthq/types';
+export declare function detectEndianness(): PlatformEndianness;
+export declare function parseUserAgentArch(ua: string, uadPlatform?: string): string;
+export declare function parseUserAgentEngine(ua: string): PlatformEngine;
+export declare function parseUserAgentEngineVersion(ua: string, engine: PlatformEngine): string;
+export declare function parseUserAgentKind(name: PlatformName): PlatformKind;
+export declare function parseUserAgentName(ua: string): PlatformName;
+export declare function parseUserAgentPointerWidth(arch: string): 32 | 64 | -1;
+export declare function parseUserAgentRuntime(win: Record<string, unknown> | null | undefined): PlatformRuntime;
+export declare function parseUserAgentVersion(ua: string, name: PlatformName): string;
+//# sourceMappingURL=userAgent.d.ts.map

package/dist/userAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userAgent.d.ts","sourceRoot":"","sources":["../src/userAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAKvH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAWrD;AAWD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAsB3E;AAKD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAK/D;AAMD,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CA0BtF;AAKD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAGnE;AAID,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAO3D;AAID,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAIrE;AAKD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,CAUtG;AAKD,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CA4B5E"}

package/dist/userAgent.js

@@ -0,0 +1,185 @@
+// Probe host CPU byte order via a DataView write-then-read.
+// Overwhelmingly 'little' on all modern hardware (x86/x64/arm/arm64/wasm).
+// Returns 'unknown' if ArrayBuffer is unavailable.
+export function detectEndianness() {
+    try {
+        const buf = new ArrayBuffer(2);
+        new Uint16Array(buf)[0] = 0x0102;
+        const bytes = new Uint8Array(buf);
+        if (bytes[0] === 0x01)
+            return 'big';
+        if (bytes[0] === 0x02)
+            return 'little';
+    }
+    catch {
+        // ArrayBuffer unavailable — treat as unknown.
+    }
+    return 'unknown';
+}
+// Parse a browser user-agent string into the canonical CPU architecture token.
+// Canonical tokens: 'x64', 'arm64', 'x86', 'arm', 'riscv64', 'mips64', 'mips'. Returns '' when undetectable.
+// Note: arm64/aarch64 must be tested before arm to avoid false-positive partial matches.
+// The high-entropy navigator.userAgentData.architecture API is async and not used here;
+// this function operates on the synchronous UA string, plus an optional UA-CH platform hint.
+//
+// uadPlatform: pass navigator.userAgentData.platform (Chromium UA-CH) when available — it gives
+// cleaner arch detection than the UA string. 'Windows', 'Linux', 'macOS', 'Chrome OS' map to 'x64'
+// conservatively; Apple Silicon (M-series) is indistinguishable from x64 via this hint alone.
+export function parseUserAgentArch(ua, uadPlatform) {
+    if (uadPlatform) {
+        const p = uadPlatform.toLowerCase();
+        if (p.includes('arm'))
+            return 'arm64';
+        if (p.includes('x86') ||
+            p.includes('windows') ||
+            p.includes('linux') ||
+            p.includes('mac') ||
+            p.includes('chrome')) {
+            return 'x64';
+        }
+    }
+    if (/arm64|aarch64/i.test(ua))
+        return 'arm64';
+    if (/arm/i.test(ua))
+        return 'arm';
+    if (/x86_64|win64|wow64|x64/i.test(ua))
+        return 'x64';
+    if (/i[3-6]86|x86/i.test(ua))
+        return 'x86';
+    if (/riscv64/i.test(ua))
+        return 'riscv64';
+    if (/mips64/i.test(ua))
+        return 'mips64';
+    if (/mips/i.test(ua))
+        return 'mips';
+    return '';
+}
+// Parse a browser user-agent string into the canonical PlatformEngine token.
+// Order matters: Edg/Chrome UAs contain 'Safari'; Firefox UAs do not contain 'Chrome'.
+// Returns 'unknown' for unrecognized or native-host UAs.
+export function parseUserAgentEngine(ua) {
+    if (/firefox/i.test(ua))
+        return 'gecko';
+    if (/chrome|chromium|edg|opr|samsung/i.test(ua))
+        return 'blink';
+    if (/safari|webkit/i.test(ua))
+        return 'webkit';
+    return 'unknown';
+}
+// Extract the browser/engine version string from a user-agent string.
+// The engine parameter narrows which version pattern to extract.
+// Returns '' when the version is not present or the engine is 'unknown'.
+// The returned string is the raw version token — never parsed for semantics.
+export function parseUserAgentEngineVersion(ua, engine) {
+    switch (engine) {
+        case 'gecko': {
+            // 'Firefox/120.0' → '120.0'
+            const m = /firefox\/([\d.]+)/i.exec(ua);
+            return m ? m[1] : '';
+        }
+        case 'blink': {
+            // Prefer Edg/OPR over Chrome for Edge/Opera UAs to surface the product version.
+            const edg = /edg\/([\d.]+)/i.exec(ua);
+            if (edg)
+                return edg[1];
+            const opr = /opr\/([\d.]+)/i.exec(ua);
+            if (opr)
+                return opr[1];
+            const chrome = /chrome\/([\d.]+)/i.exec(ua);
+            return chrome ? chrome[1] : '';
+        }
+        case 'webkit': {
+            // 'Version/16.0' → '16.0' for Safari; fall back to AppleWebKit/<version>.
+            const ver = /version\/([\d.]+)/i.exec(ua);
+            if (ver)
+                return ver[1];
+            const wk = /applewebkit\/([\d.]+)/i.exec(ua);
+            return wk ? wk[1] : '';
+        }
+        default:
+            return '';
+    }
+}
+// Parse a browser user-agent string into the canonical PlatformKind token.
+// Derived from the platform name — mobile OSes yield 'mobile'; everything else yields 'web'.
+// Use parseUserAgentName to get the name, then this function to derive the kind.
+export function parseUserAgentKind(name) {
+    if (name === 'ios' || name === 'android')
+        return 'mobile';
+    return 'web';
+}
+// Parse a browser user-agent string into the canonical PlatformName token.
+// Returns 'web' when no known OS is detected (the web fallback).
+export function parseUserAgentName(ua) {
+    if (/android/i.test(ua))
+        return 'android';
+    if (/iphone|ipad|ipod/i.test(ua))
+        return 'ios';
+    if (/win/i.test(ua))
+        return 'windows';
+    if (/mac/i.test(ua))
+        return 'macos';
+    if (/linux/i.test(ua))
+        return 'linux';
+    return 'web';
+}
+// Infer the native pointer width in bits from a canonical arch token.
+// Returns 64 for 'x64'/'arm64', 32 for 'x86'/'arm', -1 when unknown (e.g. 'wasm' or '').
+export function parseUserAgentPointerWidth(arch) {
+    if (arch === 'x64' || arch === 'arm64')
+        return 64;
+    if (arch === 'x86' || arch === 'arm')
+        return 32;
+    return -1;
+}
+// Infer the host shell / runtime environment from browser-global probes.
+// Accepts the window-like object as a parameter for testability; pass `window` in production.
+// Returns 'unknown' when the window-like object is null/undefined (SSR, no-DOM contexts).
+export function parseUserAgentRuntime(win) {
+    if (win == null)
+        return 'unknown';
+    // Electron: window.process?.versions?.electron is set in the renderer process.
+    const proc = win.process;
+    if (proc?.versions && proc.versions.electron)
+        return 'electron';
+    // Tauri: window.__TAURI__ is injected by the Tauri runtime.
+    if (win.__TAURI__)
+        return 'tauri';
+    // Capacitor: window.Capacitor is set by the Capacitor bridge.
+    if (win.Capacitor)
+        return 'capacitor';
+    return 'web';
+}
+// Extract the OS version string from a browser user-agent string for the given platform name.
+// Returns the raw dotted version string. Returns '' when the version is not present in the UA.
+// Never parsed for semantics — the caller may use comparePlatformVersions for numeric comparison.
+export function parseUserAgentVersion(ua, name) {
+    switch (name) {
+        case 'windows': {
+            // 'Windows NT 10.0' → '10.0'
+            const m = /windows nt ([\d.]+)/i.exec(ua);
+            return m ? m[1] : '';
+        }
+        case 'macos': {
+            // 'Mac OS X 10_15_7' or 'Mac OS X 10.15.7' → '10.15.7'
+            const m = /mac os x ([\d_.]+)/i.exec(ua);
+            return m ? m[1].replace(/_/g, '.') : '';
+        }
+        case 'ios': {
+            // 'CPU OS 17_4_1' or 'CPU iPhone OS 17_4_1' → '17.4.1'
+            const m = /cpu(?: iphone)? os ([\d_]+)/i.exec(ua);
+            return m ? m[1].replace(/_/g, '.') : '';
+        }
+        case 'android': {
+            // 'Android 14' → '14'
+            const m = /android ([\d.]+)/i.exec(ua);
+            return m ? m[1] : '';
+        }
+        case 'linux':
+            // Linux does not embed a kernel version in the browser UA string.
+            return '';
+        default:
+            return '';
+    }
+}
+//# sourceMappingURL=userAgent.js.map

package/dist/userAgent.js.map

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

package/dist/userAgentParse.d.ts

@@ -0,0 +1,5 @@
+import type { DeviceFormFactor } from '@flighthq/types';
+export declare function parseUserAgentFormFactor(ua: string, maxTouchPoints: number): DeviceFormFactor;
+export declare function parseUserAgentOsName(ua: string): string;
+export declare function parseUserAgentOsVersion(ua: string): string;
+//# sourceMappingURL=userAgentParse.d.ts.map

package/dist/userAgentParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userAgentParse.d.ts","sourceRoot":"","sources":["../src/userAgentParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAqBxD,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,gBAAgB,CAsB7F;AAMD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYvD;AAID,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAiB1D"}

package/dist/userAgentParse.js

@@ -0,0 +1,93 @@
+import { DeviceFormFactorCar, DeviceFormFactorDesktop, DeviceFormFactorPhone, DeviceFormFactorTablet, DeviceFormFactorTV, DeviceFormFactorUnknown, DeviceFormFactorWatch, } from '@flighthq/types';
+// UA-string parsers for device identity fields.
+// All functions are pure and side-effect-free — no DOM access, no globals, no state.
+// Used by the @flighthq/device web backend; importable independently for testing or custom backends.
+//
+// Note: UA string parsing is inherently best-effort. Browsers freeze and spoof UAs regularly.
+// These parsers target the most common real-world patterns; they are not exhaustive.
+// Parses a device form factor from a user-agent string and optional touch-point hint.
+// Returns a DeviceFormFactor constant. Never returns '' — falls back to DeviceFormFactorUnknown.
+// maxTouchPoints: pass navigator.maxTouchPoints when available; -1 when unavailable.
+export function parseUserAgentFormFactor(ua, maxTouchPoints) {
+    // Automotive / in-vehicle
+    if (/android auto|car browser|automotive/i.test(ua))
+        return DeviceFormFactorCar;
+    // Smart TV / set-top box
+    if (/smart[-_]?tv|smarttv|googletv|appletv|hbbtv|netcast|webos.*tv|tizen.*tv|tv safari/i.test(ua)) {
+        return DeviceFormFactorTV;
+    }
+    // Wearable / watch
+    if (/watch\s*os|watch[_ ]?kit|wearable/i.test(ua))
+        return DeviceFormFactorWatch;
+    // Tablet: iPad explicitly; Android without 'Mobile' in UA; Windows tablet
+    if (/ipad/i.test(ua))
+        return DeviceFormFactorTablet;
+    if (/android/i.test(ua) && !/mobile/i.test(ua))
+        return DeviceFormFactorTablet;
+    if (/tablet\s*pc|silk|kindle fire/i.test(ua))
+        return DeviceFormFactorTablet;
+    // Phone: known mobile UA tokens
+    if (/iphone|ipod|android.*mobile|windows phone|blackberry|bb\d+|mobile safari/i.test(ua)) {
+        return DeviceFormFactorPhone;
+    }
+    // Desktop: known desktop OS tokens
+    if (/win(?:dows)?nt|macintosh|mac os x|linux(?!.*android)|x11/i.test(ua))
+        return DeviceFormFactorDesktop;
+    // Weak desktop signal: no touch points when the UA is otherwise inconclusive
+    if (maxTouchPoints === 0)
+        return DeviceFormFactorDesktop;
+    return DeviceFormFactorUnknown;
+}
+// Parses an OS name from a user-agent string.
+// Returns a canonical OS name or '' when unknown.
+// Common return values: 'Android', 'iOS', 'iPadOS', 'Windows', 'macOS', 'Linux', 'ChromeOS',
+// 'FreeBSD', 'OpenBSD', 'NetBSD'.
+export function parseUserAgentOsName(ua) {
+    if (/android/i.test(ua))
+        return 'Android';
+    if (/ipad/i.test(ua))
+        return 'iPadOS';
+    if (/iphone|ipod/i.test(ua))
+        return 'iOS';
+    if (/cros/i.test(ua))
+        return 'ChromeOS';
+    if (/windows nt|windows phone/i.test(ua))
+        return 'Windows';
+    if (/macintosh|mac os x/i.test(ua))
+        return 'macOS';
+    if (/freebsd/i.test(ua))
+        return 'FreeBSD';
+    if (/openbsd/i.test(ua))
+        return 'OpenBSD';
+    if (/netbsd/i.test(ua))
+        return 'NetBSD';
+    if (/linux/i.test(ua))
+        return 'Linux';
+    return '';
+}
+// Parses an OS version string from a user-agent string.
+// Returns a dotted version string, e.g. '14.0', '10.0', '13.5.1'. Returns '' when not found.
+export function parseUserAgentOsVersion(ua) {
+    // Android: "Android 14.0" or "Android 9"
+    const android = ua.match(/android\s+([\d.]+)/i);
+    if (android)
+        return android[1];
+    // iOS/iPadOS: "iPhone OS 17_0_1" or "CPU OS 16_0"
+    const ios = ua.match(/(?:iphone|ipad|ipod).*?os\s+([\d_]+)/i);
+    if (ios)
+        return ios[1].replace(/_/g, '.');
+    // Windows: "Windows NT 10.0" → "10.0"
+    const win = ua.match(/windows nt\s+([\d.]+)/i);
+    if (win)
+        return win[1];
+    // macOS: "Mac OS X 10_15_7" → "10.15.7" or "Mac OS X 13.0"
+    const mac = ua.match(/mac os x\s+([\d_.]+)/i);
+    if (mac)
+        return mac[1].replace(/_/g, '.');
+    // ChromeOS: "CrOS x86_64 14541.0.0"
+    const cros = ua.match(/cros\s+\S+\s+([\d.]+)/i);
+    if (cros)
+        return cros[1];
+    return '';
+}
+//# sourceMappingURL=userAgentParse.js.map

package/dist/userAgentParse.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@flighthq/useragent",
+  "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"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Pure user-agent string parsing to device and platform identity tokens.",
+  "sideEffects": false
+}

package/src/userAgent.test.ts

@@ -0,0 +1,304 @@
+import {
+  detectEndianness,
+  parseUserAgentArch,
+  parseUserAgentEngine,
+  parseUserAgentEngineVersion,
+  parseUserAgentKind,
+  parseUserAgentName,
+  parseUserAgentPointerWidth,
+  parseUserAgentRuntime,
+  parseUserAgentVersion,
+} from './userAgent';
+
+describe('detectEndianness', () => {
+  it('returns a known canonical value', () => {
+    expect(['little', 'big', 'unknown']).toContain(detectEndianness());
+  });
+
+  it('returns little on Node.js (x64 host)', () => {
+    // Node.js always runs on x64/arm64 hardware which is little-endian.
+    expect(detectEndianness()).toBe('little');
+  });
+});
+
+describe('parseUserAgentArch', () => {
+  it('detects arm64 from aarch64 token', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (Linux; aarch64) AppleWebKit/537.36')).toBe('arm64');
+  });
+
+  it('detects arm64 from arm64 token', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (iPhone; CPU arm64)')).toBe('arm64');
+  });
+
+  it('detects x64 from Win64 token', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36')).toBe('x64');
+  });
+
+  it('detects x64 from WOW64 token', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36')).toBe('x64');
+  });
+
+  it('detects x64 from x86_64 token', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36')).toBe('x64');
+  });
+
+  it('detects x86 from i686 token', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (X11; Linux i686; rv:109.0)')).toBe('x86');
+  });
+
+  it('detects arm before arm64 does not fire on plain arm token', () => {
+    // A UA with only 'arm' (not 'arm64'/'aarch64') should yield 'arm'.
+    expect(parseUserAgentArch('Mozilla/5.0 (Linux; armv7l)')).toBe('arm');
+  });
+
+  it('detects riscv64, mips64, and mips tokens', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (Linux; riscv64)')).toBe('riscv64');
+    expect(parseUserAgentArch('Mozilla/5.0 (Linux; mips64)')).toBe('mips64');
+    expect(parseUserAgentArch('Mozilla/5.0 (Linux; mips)')).toBe('mips');
+  });
+
+  it('prefers the UA-CH platform hint over the UA string', () => {
+    expect(parseUserAgentArch('', 'arm')).toBe('arm64');
+    expect(parseUserAgentArch('', 'Windows')).toBe('x64');
+    expect(parseUserAgentArch('', 'macOS')).toBe('x64');
+    expect(parseUserAgentArch('', 'Linux')).toBe('x64');
+    expect(parseUserAgentArch('', 'Chrome OS')).toBe('x64');
+  });
+
+  it('falls back to the UA string when the platform hint is inconclusive', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (X11; Linux x86_64)', 'SomeCustomPlatform')).toBe('x64');
+  });
+
+  it('returns empty string when arch is undetectable', () => {
+    expect(parseUserAgentArch('Mozilla/5.0 (X11; Linux) AppleWebKit/537.36')).toBe('');
+    expect(parseUserAgentArch('SomeCustomBrowser/1.0')).toBe('');
+  });
+});
+
+describe('parseUserAgentEngine', () => {
+  it('returns gecko for Firefox', () => {
+    expect(
+      parseUserAgentEngine('Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0'),
+    ).toBe('gecko');
+  });
+
+  it('returns blink for Chrome', () => {
+    expect(
+      parseUserAgentEngine(
+        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+      ),
+    ).toBe('blink');
+  });
+
+  it('returns blink for Edge (Edg/)', () => {
+    expect(
+      parseUserAgentEngine(
+        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.2210.133',
+      ),
+    ).toBe('blink');
+  });
+
+  it('returns webkit for Safari', () => {
+    expect(
+      parseUserAgentEngine(
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15',
+      ),
+    ).toBe('webkit');
+  });
+
+  it('returns unknown for unrecognized UA', () => {
+    expect(parseUserAgentEngine('')).toBe('unknown');
+    expect(parseUserAgentEngine('CustomBot/1.0')).toBe('unknown');
+  });
+});
+
+describe('parseUserAgentEngineVersion', () => {
+  it('extracts Firefox version', () => {
+    expect(
+      parseUserAgentEngineVersion(
+        'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0',
+        'gecko',
+      ),
+    ).toBe('120.0');
+  });
+
+  it('extracts Chrome version', () => {
+    expect(
+      parseUserAgentEngineVersion(
+        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.6099.109 Safari/537.36',
+        'blink',
+      ),
+    ).toBe('120.0.6099.109');
+  });
+
+  it('extracts Edge version (Edg/ token takes priority over Chrome/)', () => {
+    expect(
+      parseUserAgentEngineVersion(
+        'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.2210.133',
+        'blink',
+      ),
+    ).toBe('120.0.2210.133');
+  });
+
+  it('extracts Safari Version/ token', () => {
+    expect(
+      parseUserAgentEngineVersion(
+        'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Safari/605.1.15',
+        'webkit',
+      ),
+    ).toBe('16.0');
+  });
+
+  it('returns empty string for unknown engine', () => {
+    expect(parseUserAgentEngineVersion('any UA string', 'unknown')).toBe('');
+  });
+
+  it('returns empty string when version is absent', () => {
+    expect(parseUserAgentEngineVersion('', 'gecko')).toBe('');
+  });
+});
+
+describe('parseUserAgentKind', () => {
+  it('returns mobile for ios', () => {
+    expect(parseUserAgentKind('ios')).toBe('mobile');
+  });
+
+  it('returns mobile for android', () => {
+    expect(parseUserAgentKind('android')).toBe('mobile');
+  });
+
+  it('returns web for desktop names', () => {
+    expect(parseUserAgentKind('windows')).toBe('web');
+    expect(parseUserAgentKind('macos')).toBe('web');
+    expect(parseUserAgentKind('linux')).toBe('web');
+  });
+
+  it('returns web for unknown', () => {
+    expect(parseUserAgentKind('unknown')).toBe('web');
+  });
+});
+
+describe('parseUserAgentName', () => {
+  it('detects android', () => {
+    expect(parseUserAgentName('Mozilla/5.0 (Linux; Android 14; Pixel 8)')).toBe('android');
+  });
+
+  it('detects ios from iPhone', () => {
+    expect(parseUserAgentName('Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X)')).toBe('ios');
+  });
+
+  it('detects ios from iPad', () => {
+    expect(parseUserAgentName('Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X)')).toBe('ios');
+  });
+
+  it('detects windows', () => {
+    expect(parseUserAgentName('Mozilla/5.0 (Windows NT 10.0; Win64; x64)')).toBe('windows');
+  });
+
+  it('detects macos', () => {
+    expect(parseUserAgentName('Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0)')).toBe('macos');
+  });
+
+  it('detects linux', () => {
+    expect(parseUserAgentName('Mozilla/5.0 (X11; Linux x86_64)')).toBe('linux');
+  });
+
+  it('returns web when no OS is detected', () => {
+    expect(parseUserAgentName('')).toBe('web');
+    expect(parseUserAgentName('CustomBot/1.0')).toBe('web');
+  });
+});
+
+describe('parseUserAgentPointerWidth', () => {
+  it('returns 64 for x64', () => {
+    expect(parseUserAgentPointerWidth('x64')).toBe(64);
+  });
+
+  it('returns 64 for arm64', () => {
+    expect(parseUserAgentPointerWidth('arm64')).toBe(64);
+  });
+
+  it('returns 32 for x86', () => {
+    expect(parseUserAgentPointerWidth('x86')).toBe(32);
+  });
+
+  it('returns 32 for arm', () => {
+    expect(parseUserAgentPointerWidth('arm')).toBe(32);
+  });
+
+  it('returns -1 for wasm', () => {
+    expect(parseUserAgentPointerWidth('wasm')).toBe(-1);
+  });
+
+  it('returns -1 for empty string', () => {
+    expect(parseUserAgentPointerWidth('')).toBe(-1);
+  });
+});
+
+describe('parseUserAgentRuntime', () => {
+  it('returns unknown when window is null', () => {
+    expect(parseUserAgentRuntime(null)).toBe('unknown');
+  });
+
+  it('returns unknown when window is undefined', () => {
+    expect(parseUserAgentRuntime(undefined)).toBe('unknown');
+  });
+
+  it('returns web when no host shell globals are present', () => {
+    expect(parseUserAgentRuntime({})).toBe('web');
+  });
+
+  it('returns electron when process.versions.electron is present', () => {
+    expect(parseUserAgentRuntime({ process: { versions: { electron: '28.0.0' } } })).toBe('electron');
+  });
+
+  it('returns tauri when __TAURI__ is present', () => {
+    expect(parseUserAgentRuntime({ __TAURI__: {} })).toBe('tauri');
+  });
+
+  it('returns capacitor when Capacitor is present', () => {
+    expect(parseUserAgentRuntime({ Capacitor: {} })).toBe('capacitor');
+  });
+
+  it('prioritizes electron over tauri when both globals are present', () => {
+    expect(parseUserAgentRuntime({ __TAURI__: {}, process: { versions: { electron: '28.0.0' } } })).toBe('electron');
+  });
+});
+
+describe('parseUserAgentVersion', () => {
+  it('parses Windows NT version', () => {
+    expect(parseUserAgentVersion('Mozilla/5.0 (Windows NT 10.0; Win64; x64)', 'windows')).toBe('10.0');
+  });
+
+  it('parses macOS version with underscore separators', () => {
+    expect(parseUserAgentVersion('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)', 'macos')).toBe('10.15.7');
+  });
+
+  it('parses macOS version with dot separators', () => {
+    expect(parseUserAgentVersion('Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15.7)', 'macos')).toBe('10.15.7');
+  });
+
+  it('parses iOS version', () => {
+    expect(parseUserAgentVersion('Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X)', 'ios')).toBe('17.4.1');
+  });
+
+  it('parses iOS version without iPhone token', () => {
+    expect(parseUserAgentVersion('Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X)', 'ios')).toBe('17.0');
+  });
+
+  it('parses Android version', () => {
+    expect(parseUserAgentVersion('Mozilla/5.0 (Linux; Android 14; Pixel 8)', 'android')).toBe('14');
+  });
+
+  it('returns empty string for linux (no kernel in UA)', () => {
+    expect(parseUserAgentVersion('Mozilla/5.0 (X11; Linux x86_64)', 'linux')).toBe('');
+  });
+
+  it('returns empty string for unknown name', () => {
+    expect(parseUserAgentVersion('any UA', 'unknown')).toBe('');
+  });
+
+  it('returns empty string when version is absent', () => {
+    expect(parseUserAgentVersion('', 'windows')).toBe('');
+  });
+});

package/src/userAgentParse.test.ts

@@ -0,0 +1,137 @@
+import {
+  DeviceFormFactorCar,
+  DeviceFormFactorDesktop,
+  DeviceFormFactorPhone,
+  DeviceFormFactorTablet,
+  DeviceFormFactorTV,
+  DeviceFormFactorUnknown,
+  DeviceFormFactorWatch,
+} from '@flighthq/types';
+
+import { parseUserAgentFormFactor, parseUserAgentOsName, parseUserAgentOsVersion } from './userAgentParse';
+
+describe('parseUserAgentFormFactor', () => {
+  it('returns Automotive for Android Auto UA', () => {
+    expect(parseUserAgentFormFactor('Android Auto', -1)).toBe(DeviceFormFactorCar);
+  });
+
+  it('returns TV for smart TV UAs', () => {
+    expect(parseUserAgentFormFactor('Mozilla/5.0 (SmartTV; Linux)', -1)).toBe(DeviceFormFactorTV);
+    expect(parseUserAgentFormFactor('Mozilla/5.0 (SMART-TV; LINUX)', -1)).toBe(DeviceFormFactorTV);
+    expect(parseUserAgentFormFactor('Dalvik/2.1.0 (Linux; Android; GoogleTV)', -1)).toBe(DeviceFormFactorTV);
+  });
+
+  it('returns Watch for WatchOS UA', () => {
+    expect(parseUserAgentFormFactor('Mozilla/5.0 (Watch OS 10.0)', -1)).toBe(DeviceFormFactorWatch);
+    expect(parseUserAgentFormFactor('wearable/1.0', -1)).toBe(DeviceFormFactorWatch);
+  });
+
+  it('returns Tablet for iPad UA', () => {
+    const ipad = 'Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X)';
+    expect(parseUserAgentFormFactor(ipad, 5)).toBe(DeviceFormFactorTablet);
+  });
+
+  it('returns Tablet for Android tablet UA (no Mobile token)', () => {
+    const androidTablet = 'Mozilla/5.0 (Linux; Android 13; SM-T870) AppleWebKit/537.36';
+    expect(parseUserAgentFormFactor(androidTablet, 5)).toBe(DeviceFormFactorTablet);
+  });
+
+  it('returns Phone for iPhone UA', () => {
+    const iphone = 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)';
+    expect(parseUserAgentFormFactor(iphone, 5)).toBe(DeviceFormFactorPhone);
+  });
+
+  it('returns Phone for Android mobile UA', () => {
+    const android = 'Mozilla/5.0 (Linux; Android 14; Pixel 8) Mobile Safari/537.36';
+    expect(parseUserAgentFormFactor(android, 5)).toBe(DeviceFormFactorPhone);
+  });
+
+  it('returns Desktop for Windows UA', () => {
+    const win = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36';
+    expect(parseUserAgentFormFactor(win, 0)).toBe(DeviceFormFactorDesktop);
+  });
+
+  it('returns Desktop for macOS UA', () => {
+    const mac = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0) AppleWebKit/537.36';
+    expect(parseUserAgentFormFactor(mac, 0)).toBe(DeviceFormFactorDesktop);
+  });
+
+  it('returns Desktop when maxTouchPoints is 0 and UA is inconclusive', () => {
+    expect(parseUserAgentFormFactor('SomeBrowser/1.0', 0)).toBe(DeviceFormFactorDesktop);
+  });
+
+  it('returns Unknown for empty UA with touch points available', () => {
+    expect(parseUserAgentFormFactor('', -1)).toBe(DeviceFormFactorUnknown);
+  });
+});
+
+describe('parseUserAgentOsName', () => {
+  it('returns Android for Android UA', () => {
+    expect(parseUserAgentOsName('Mozilla/5.0 (Linux; Android 14; Pixel 8)')).toBe('Android');
+  });
+
+  it('returns iPadOS for iPad UA', () => {
+    expect(parseUserAgentOsName('Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X)')).toBe('iPadOS');
+  });
+
+  it('returns iOS for iPhone/iPod UA', () => {
+    expect(parseUserAgentOsName('Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X)')).toBe('iOS');
+    expect(parseUserAgentOsName('Mozilla/5.0 (iPod touch; CPU iPhone OS 16_0 like Mac OS X)')).toBe('iOS');
+  });
+
+  it('returns Windows for Windows UA', () => {
+    expect(parseUserAgentOsName('Mozilla/5.0 (Windows NT 10.0; Win64; x64)')).toBe('Windows');
+  });
+
+  it('returns macOS for Macintosh UA', () => {
+    expect(parseUserAgentOsName('Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0)')).toBe('macOS');
+  });
+
+  it('returns ChromeOS for CrOS UA', () => {
+    expect(parseUserAgentOsName('Mozilla/5.0 (X11; CrOS x86_64 14541.0.0)')).toBe('ChromeOS');
+  });
+
+  it('returns Linux for Linux UA', () => {
+    expect(parseUserAgentOsName('Mozilla/5.0 (X11; Linux x86_64)')).toBe('Linux');
+  });
+
+  it('returns FreeBSD for FreeBSD UA', () => {
+    expect(parseUserAgentOsName('Mozilla/5.0 (X11; FreeBSD amd64)')).toBe('FreeBSD');
+  });
+
+  it('returns empty string for unknown UA', () => {
+    expect(parseUserAgentOsName('')).toBe('');
+    expect(parseUserAgentOsName('CustomBot/1.0')).toBe('');
+  });
+});
+
+describe('parseUserAgentOsVersion', () => {
+  it('parses Android version', () => {
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (Linux; Android 14.0; Pixel)')).toBe('14.0');
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (Linux; Android 9; SM-G950F)')).toBe('9');
+  });
+
+  it('parses iOS version with underscore notation', () => {
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (iPhone; CPU iPhone OS 17_0_1 like Mac OS X)')).toBe('17.0.1');
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (iPad; CPU OS 16_0 like Mac OS X)')).toBe('16.0');
+  });
+
+  it('parses Windows NT version', () => {
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (Windows NT 10.0; Win64; x64)')).toBe('10.0');
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (Windows NT 6.1; WOW64)')).toBe('6.1');
+  });
+
+  it('parses macOS version with underscore and dot notation', () => {
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)')).toBe('10.15.7');
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (Macintosh; Intel Mac OS X 13.0)')).toBe('13.0');
+  });
+
+  it('parses ChromeOS version', () => {
+    expect(parseUserAgentOsVersion('Mozilla/5.0 (X11; CrOS x86_64 14541.0.0)')).toBe('14541.0.0');
+  });
+
+  it('returns empty string for unknown UA', () => {
+    expect(parseUserAgentOsVersion('')).toBe('');
+    expect(parseUserAgentOsVersion('CustomBot/1.0')).toBe('');
+  });
+});