feat(expo): system info collector assembling mobile device context

Author: Ripwords

packages/expo/src/collectors/system-info.test.ts

@@ -0,0 +1,40 @@
+import { test, expect, mock } from "bun:test"
+
+// Mock the native modules BEFORE importing the collector.
+mock.module("react-native", () => ({
+  Platform: { OS: "ios", Version: "17.4" },
+  Dimensions: {
+    get: (k: "window" | "screen") =>
+      k === "window" ? { width: 390, height: 844 } : { width: 1179, height: 2556 },
+  },
+  PixelRatio: { get: () => 3 },
+}))
+mock.module("expo-device", () => ({
+  modelName: "iPhone 15",
+}))
+mock.module("expo-constants", () => ({
+  default: { expoConfig: { version: "1.2.3" }, nativeBuildVersion: "42" },
+}))
+mock.module("@react-native-community/netinfo", () => ({
+  fetch: async () => ({
+    isConnected: true,
+    details: { effectiveType: "4g", rtt: 50, downlink: 10 },
+  }),
+}))
+
+test("assembles a mobile SystemInfo record", async () => {
+  const { collectSystemInfo } = await import("./system-info")
+  const info = await collectSystemInfo({ pageUrl: "myapp://home" })
+  expect(info.devicePlatform).toBe("ios")
+  expect(info.deviceModel).toBe("iPhone 15")
+  expect(info.appVersion).toBe("1.2.3")
+  expect(info.appBuild).toBe("42")
+  expect(info.osVersion).toBe("17.4")
+  expect(info.viewport).toEqual({ w: 390, h: 844 })
+  expect(info.screen).toEqual({ w: 1179, h: 2556 })
+  expect(info.dpr).toBe(3)
+  expect(info.online).toBe(true)
+  expect(info.connection?.effectiveType).toBe("4g")
+  expect(info.pageUrl).toBe("myapp://home")
+  expect(info.userAgent).toMatch(/Expo/)
+})

packages/expo/src/collectors/system-info.ts

@@ -0,0 +1,49 @@
+import { Platform, Dimensions, PixelRatio } from "react-native"
+import * as Device from "expo-device"
+import Constants from "expo-constants"
+import { fetch as fetchNetInfo } from "@react-native-community/netinfo"
+import type { SystemInfo } from "@reprojs/shared"
+
+export async function collectSystemInfo(opts: { pageUrl: string }): Promise<SystemInfo> {
+  const os = Platform.OS
+  const devicePlatform = os === "ios" ? "ios" : os === "android" ? "android" : undefined
+  const windowDims = Dimensions.get("window")
+  const screenDims = Dimensions.get("screen")
+  const net = await fetchNetInfo().catch(() => null)
+  const language =
+    (typeof Intl !== "undefined" && Intl.DateTimeFormat().resolvedOptions().locale) || "en"
+  const timezone =
+    (typeof Intl !== "undefined" && Intl.DateTimeFormat().resolvedOptions().timeZone) || "UTC"
+  const timezoneOffset = -new Date().getTimezoneOffset()
+  const appVersion = (Constants.expoConfig?.version as string | undefined) ?? undefined
+  const appBuild =
+    ((Constants as unknown as { nativeBuildVersion?: string }).nativeBuildVersion as
+      | string
+      | undefined) ?? undefined
+
+  return {
+    userAgent: `Expo/${(Constants as unknown as { expoVersion?: string }).expoVersion ?? "unknown"} ${os} ${Platform.Version}`,
+    platform: os,
+    devicePlatform,
+    appVersion,
+    appBuild,
+    deviceModel: Device.modelName ?? undefined,
+    osVersion: String(Platform.Version),
+    language,
+    timezone,
+    timezoneOffset,
+    viewport: { w: Math.round(windowDims.width), h: Math.round(windowDims.height) },
+    screen: { w: Math.round(screenDims.width), h: Math.round(screenDims.height) },
+    dpr: PixelRatio.get(),
+    online: !!net?.isConnected,
+    connection: net?.details
+      ? {
+          effectiveType: (net.details as { effectiveType?: string }).effectiveType ?? undefined,
+          rtt: (net.details as { rtt?: number }).rtt,
+          downlink: (net.details as { downlink?: number }).downlink,
+        }
+      : undefined,
+    pageUrl: opts.pageUrl,
+    timestamp: new Date().toISOString(),
+  }
+}