@steve31415/baselib 3.24.0 → 3.25.0

package/dist/log-browser.d.ts

@@ -10,6 +10,19 @@ export interface BrowserLoggerOptions {
     /** Also mirror events to the devtools console (default false). */
     console?: boolean;
 }
+/** One random id per page load, stamped on every browser event as
+ *  `page_id`. Exported so an app can send the same id to its server (e.g. a
+ *  socket's client id) and join the two sides in one query. */
+export declare const pageId: string;
+/**
+ * A coarse `<os>-<browser>` label from a user-agent string — enough to tell
+ * Steve's devices apart in a query, deliberately nothing finer (no versions,
+ * no model). os: android | ios | mac | windows | chromeos | linux | other;
+ * browser: edge | opera | firefox | chrome | safari | other. An iPad asking for
+ * the desktop site reports itself as a Mac; pass `touchPoints`
+ * (`navigator.maxTouchPoints`) to tell it apart.
+ */
+export declare function deviceLabel(userAgent: string, touchPoints?: number): string;
 export declare function createBrowserLogger(opts?: BrowserLoggerOptions): Logger;
 /**
  * Make the shared `logger` forward to `instance`. Call once at boot, right

package/dist/log-browser.js

@@ -10,8 +10,61 @@
 //
 // The token is ingest-only and dataset-scoped by design — visible to any
 // signed-in user, able to do nothing but add log events.
+//
+// Every event also carries two top-level fields saying where it came from,
+// because browser events have no request to join on (2026-10-03, radar: telling
+// a phone put down from a sleeping Mac from a server fault took the
+// load-balancer log): `page_id`, one random id per page load, and `device`, a
+// coarse `<os>-<browser>` label such as `mac-chrome` or `android-chrome`.
 import { LogShipper, makeEvents } from './log-core.js';
 export { serializeError } from './log-core.js';
+/** One random id per page load, stamped on every browser event as
+ *  `page_id`. Exported so an app can send the same id to its server (e.g. a
+ *  socket's client id) and join the two sides in one query. */
+export const pageId = newPageId();
+function newPageId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function')
+        return crypto.randomUUID();
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`;
+}
+/**
+ * A coarse `<os>-<browser>` label from a user-agent string — enough to tell
+ * Steve's devices apart in a query, deliberately nothing finer (no versions,
+ * no model). os: android | ios | mac | windows | chromeos | linux | other;
+ * browser: edge | opera | firefox | chrome | safari | other. An iPad asking for
+ * the desktop site reports itself as a Mac; pass `touchPoints`
+ * (`navigator.maxTouchPoints`) to tell it apart.
+ */
+export function deviceLabel(userAgent, touchPoints = 0) {
+    const ua = userAgent;
+    const os = /Android/.test(ua)
+        ? 'android'
+        : /iPhone|iPad|iPod/.test(ua)
+            ? 'ios'
+            : /Macintosh|Mac OS X/.test(ua)
+                ? touchPoints > 1
+                    ? 'ios'
+                    : 'mac'
+                : /Windows/.test(ua)
+                    ? 'windows'
+                    : /CrOS/.test(ua)
+                        ? 'chromeos'
+                        : /Linux/.test(ua)
+                            ? 'linux'
+                            : 'other';
+    const browser = /Edg(e|A|iOS)?\//.test(ua)
+        ? 'edge'
+        : /OPR\/|OPiOS\//.test(ua)
+            ? 'opera'
+            : /Firefox\/|FxiOS\//.test(ua)
+                ? 'firefox'
+                : /Chrome\/|CriOS\//.test(ua)
+                    ? 'chrome'
+                    : /Safari\//.test(ua)
+                        ? 'safari'
+                        : 'other';
+    return `${os}-${browser}`;
+}
 function metaContent(name) {
     return document.querySelector(`meta[name="${name}"]`)?.content || undefined;
 }
@@ -68,7 +121,12 @@ export function createBrowserLogger(opts = {}) {
             flush: () => shipper?.flush() ?? Promise.resolve(),
         };
     }
-    const logger = build({ ...(buildId ? { build_id: buildId } : {}), ...opts.context });
+    const logger = build({
+        ...(buildId ? { build_id: buildId } : {}),
+        page_id: pageId,
+        device: deviceLabel(navigator.userAgent, navigator.maxTouchPoints ?? 0),
+        ...opts.context,
+    });
     // Ship what's pending whenever the page may be going away.
     const flushNow = () => void logger.flush();
     addEventListener('pagehide', flushNow);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steve31415/baselib",
-  "version": "3.24.0",
+  "version": "3.25.0",
   "description": "Plasticine new-world shared platform library: logging, auth, service-to-service auth, db, HTTP, sync, app updates",
   "type": "module",
   "license": "MIT",