@buoy-gg/core 7.0.41 → 7.0.43

package/lib/commonjs/floatingMenu/deviceIdentity.js

@@ -1,173 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.INSTALL_ID_LENGTH = void 0;
-exports.buildDeviceIdentity = buildDeviceIdentity;
-exports.generateInstallId = generateInstallId;
-exports.getInstallId = getInstallId;
-exports.loadInstallId = loadInstallId;
-exports.resetInstallIdForTests = resetInstallIdForTests;
-exports.useDeviceIdentity = useDeviceIdentity;
-var _react = require("react");
-var _reactNative = require("react-native");
-var _sharedUi = require("@buoy-gg/shared-ui");
-/**
- * How a device introduces itself to the Buoy Desktop broker.
- *
- * The id used to be `<app-slug>-<platform>` — a BUILD identity, not a device
- * identity. Every phone and simulator running the same app registered under
- * the same id, and the broker (which deliberately lets one device hold
- * several sockets for Fast Refresh) treated each newcomer as a reconnect and
- * handed it the identity. Actions then landed on whichever device connected
- * most recently, silently. See DEVICE_IDENTITY_COLLISION.md.
- *
- * Now the id carries a per-install tail minted once and persisted:
- *
- *   deviceId   = "<app-slug>-<platform>-<8 hex>"      e.g. acme-app-ios-3f9a2c1d
- *   deviceName = "<App Name> (<hardware> · <last 4>)" e.g. Acme App (iPhone 17 Pro · 2c1d)
- *
- * The tail is what makes two devices on one build two devices. The name's
- * hardware label comes from expo-constants' `deviceName` when available (the
- * simulator's own name on a sim, "iPhone" on iOS 16+ hardware, the model on
- * Android) and falls back to the platform; the 4-char tail is always on so
- * two identical simulators never share a label.
- *
- * Persistence: native goes through shared's `persistentStorage` (file system
- * → AsyncStorage → memory); web uses `sessionStorage` so every browser TAB
- * is its own device — `localStorage` is shared across tabs and would collide
- * exactly the way the old default did. The id does not survive a reinstall
- * on purpose: it crosses an unauthenticated LAN socket, and deleting the app
- * should reset it.
- *
- * An explicit `externalSync.deviceId` bypasses all of this; whoever pins an
- * id owns its uniqueness.
- */
-
-/** Minimal getItem/setItem surface, so storage can be injected in tests. */
-
-const INSTALL_ID_LENGTH = exports.INSTALL_ID_LENGTH = 8;
-
-/** 8 lowercase hex chars — short enough to read, random enough for a LAN. */
-function generateInstallId() {
-  let out = "";
-  while (out.length < INSTALL_ID_LENGTH) {
-    out += (Math.random() * 16 | 0).toString(16);
-  }
-  return out;
-}
-function slugify(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-/** Pure: turns the inputs into the id/name pair the broker sees. */
-function buildDeviceIdentity({
-  appName,
-  hardwareName,
-  platform,
-  installId,
-  deviceId
-}) {
-  const slug = slugify(appName ?? "buoy") || "buoy";
-  const label = appName ?? "Buoy Device";
-  const hardware = hardwareName?.trim() || platform;
-  if (deviceId) {
-    // The app pinned its own id: it can also pin its own name, so keep the
-    // default name free of a tail that would refer to an id nobody sees.
-    return {
-      deviceId,
-      deviceName: `${label} (${hardware})`
-    };
-  }
-  const id = `${slug}-${platform}-${installId}`;
-  return {
-    deviceId: id,
-    deviceName: `${label} (${hardware} · ${installId.slice(-4)})`
-  };
-}
-
-// Web: every tab is a device, so the id lives in the tab's sessionStorage.
-function sessionStore() {
-  const g = globalThis;
-  try {
-    return g.sessionStorage ?? null;
-  } catch {
-    return null;
-  }
-}
-/**
- * The persisted per-install tail: read it, or mint and store it on the first
- * dial. Storage failures degrade to a fresh in-memory id rather than blocking
- * the socket — a per-launch id still beats the old colliding one.
- */
-async function loadInstallId({
-  platform = _reactNative.Platform.OS,
-  store,
-  mint = generateInstallId
-} = {}) {
-  const key = _sharedUi.devToolsStorageKeys.sync.deviceId();
-  const target = store === undefined ? platform === "web" ? sessionStore() : _sharedUi.persistentStorage : store;
-  if (!target) return mint();
-  try {
-    const existing = await target.getItem(key);
-    if (existing && existing.length > 0) return existing;
-    const fresh = mint();
-    await target.setItem(key, fresh);
-    return fresh;
-  } catch {
-    return mint();
-  }
-}
-let installIdPromise = null;
-
-/**
- * Process-wide memo so every mount (and every Fast Refresh of the component
- * that calls it) shares one storage round-trip and one id.
- */
-function getInstallId() {
-  if (!installIdPromise) installIdPromise = loadInstallId();
-  return installIdPromise;
-}
-
-/** Tests only. */
-function resetInstallIdForTests() {
-  installIdPromise = null;
-}
-/**
- * The identity to dial with. Null until the per-install id is read from
- * storage (one round-trip on first mount; memoized process-wide after) —
- * both sync hooks no-op on a null id, so the socket simply dials a beat
- * later. An explicit `deviceId` skips the read entirely; an explicit
- * `deviceName` is used verbatim.
- */
-function useDeviceIdentity(options, env) {
-  const pinnedId = options?.deviceId;
-  const pinnedName = options?.deviceName;
-  const loadId = env.loadId ?? getInstallId;
-  const platform = env.platform ?? _reactNative.Platform.OS;
-  const [installId, setInstallId] = (0, _react.useState)(null);
-  (0, _react.useEffect)(() => {
-    if (pinnedId) return;
-    let cancelled = false;
-    loadId().then(id => {
-      if (!cancelled) setInstallId(id);
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [pinnedId, loadId]);
-  return (0, _react.useMemo)(() => {
-    if (!pinnedId && !installId) return null;
-    const identity = buildDeviceIdentity({
-      appName: env.appName,
-      hardwareName: env.hardwareName,
-      platform,
-      installId: installId ?? "",
-      deviceId: pinnedId
-    });
-    return pinnedName ? {
-      ...identity,
-      deviceName: pinnedName
-    } : identity;
-  }, [pinnedId, pinnedName, installId, env.appName, env.hardwareName, platform]);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.INSTALL_ID_LENGTH=void 0;exports.buildDeviceIdentity=buildDeviceIdentity;exports.generateInstallId=generateInstallId;exports.getInstallId=getInstallId;exports.loadInstallId=loadInstallId;exports.resetInstallIdForTests=resetInstallIdForTests;exports.useDeviceIdentity=useDeviceIdentity;var _react=require("react");var _reactNative=require("react-native");var _sharedUi=require("@buoy-gg/shared-ui");const INSTALL_ID_LENGTH=exports.INSTALL_ID_LENGTH=8;function generateInstallId(){let e="";while(e.length<INSTALL_ID_LENGTH){e+=(Math.random()*16|0).toString(16)}return e}function slugify(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/(^-|-$)/g,"")}function buildDeviceIdentity({appName:e,hardwareName:r,platform:t,installId:n,deviceId:a}){const l=slugify(e??"buoy")||"buoy";const s=e??"Buoy Device";const o=r?.trim()||t;if(a){return{deviceId:a,deviceName:`${s} (${o})`}}const i=`${l}-${t}-${n}`;return{deviceId:i,deviceName:`${s} (${o} \xB7 ${n.slice(-4)})`}}function sessionStore(){const e=globalThis;try{return e.sessionStorage??null}catch{return null}}async function loadInstallId({platform:e=_reactNative.Platform.OS,store:r,mint:t=generateInstallId}={}){const n=_sharedUi.devToolsStorageKeys.sync.deviceId();const a=r===void 0?e==="web"?sessionStore():_sharedUi.persistentStorage:r;if(!a)return t();try{const l=await a.getItem(n);if(l&&l.length>0)return l;const s=t();await a.setItem(n,s);return s}catch{return t()}}let installIdPromise=null;function getInstallId(){if(!installIdPromise)installIdPromise=loadInstallId();return installIdPromise}function resetInstallIdForTests(){installIdPromise=null}function useDeviceIdentity(e,r){const t=e?.deviceId;const n=e?.deviceName;const a=r.loadId??getInstallId;const l=r.platform??_reactNative.Platform.OS;const[s,o]=(0,_react.useState)(null);(0,_react.useEffect)(()=>{if(t)return;let i=false;a().then(c=>{if(!i)o(c)});return()=>{i=true}},[t,a]);return(0,_react.useMemo)(()=>{if(!t&&!s)return null;const i=buildDeviceIdentity({appName:r.appName,hardwareName:r.hardwareName,platform:l,installId:s??"",deviceId:t});return n?{...i,deviceName:n}:i},[t,n,s,r.appName,r.hardwareName,l])}