paired-devices.ts

1// Paired-device registry — v3 chirp-sync.2//3// Long-term records live in `chrome.storage.local`. Keys must not leave4// the device via a third-party sync service — `longTermPublicKeyHex` and5// `signingPublicKeyHex` are cryptographic keys; routing them through6// Google's or Mozilla's sync back-end violates the local-only trust model.7//8// `lastKnownIp` is network-specific and also lives in `chrome.storage.local`,9// keyed by `longTermPublicKeyHex` (not on the device record itself) so10// network-specific addresses don't roam across profiles.11//12// `deviceId` is the canonical primary key (UUID v4, stable for the13// lifetime of the installation). `longTermPublicKeyHex` is also unique14// per device but rotates if the user reinstalls before re-pairing, so we15// key on deviceId and update the key in place during re-pair.16//17// The registry has only ever lived in `chrome.storage.local` for released18// builds, so no cross-profile evacuation path is needed — the public keys19// never leave the device via a third-party sync back-end. Unpairing is20// local-only; Noise XX rejection on the next connection is the security21// boundary (see removePairedDeviceById).2223import type { PairedDevice } from "../shared/sync-types";2425const REGISTRY_KEY = "peach_paired_devices_v3";26const LAST_IP_KEY_PREFIX = "peach_last_known_ip_v3:";27const LAST_SYNC_AT_KEY = "peach_last_sync_at";28const LAST_SYNC_RESULT_KEY = "peach_last_sync_result";2930export async function listPairedDevices(): Promise<PairedDevice[]> {31  try {32    const result = await chrome.storage.local.get(REGISTRY_KEY);33    const devices = (result as Record<string, unknown>)[REGISTRY_KEY];34    if (Array.isArray(devices)) return devices.filter(isPairedDevice);35    return [];36  } catch {37    return [];38  }39}4041export async function findPairedDeviceById(deviceId: string): Promise<PairedDevice | null> {42  const devices = await listPairedDevices();43  return devices.find((d) => d.deviceId === deviceId) ?? null;44}4546export async function findPairedDeviceByPubkey(pubkeyHex: string): Promise<PairedDevice | null> {47  const devices = await listPairedDevices();48  return devices.find((d) => d.longTermPublicKeyHex === pubkeyHex) ?? null;49}5051/**52 * Add or update a device by `deviceId`. On re-pair the new pubkey53 * silently replaces the old one; the deviceId is stable across the54 * other device's reinstall.55 */56export async function upsertPairedDevice(device: PairedDevice): Promise<void> {57  if (!device.deviceId) throw new Error("device.deviceId is required");58  if (!device.longTermPublicKeyHex) throw new Error("device.longTermPublicKeyHex is required");59  if (!device.deviceName) throw new Error("device.deviceName is required");60  if (!device.deviceType) throw new Error("device.deviceType is required");6162  const devices = await listPairedDevices();63  const idx = devices.findIndex((d) => d.deviceId === device.deviceId);64  if (idx >= 0) {65    devices[idx] = { ...devices[idx], ...device };66  } else {67    devices.push(device);68  }69  await chrome.storage.local.set({ [REGISTRY_KEY]: devices });70}7172/**73 * Removes the device from the LOCAL paired-devices registry only.74 *75 * SECURITY NOTE (MV-8): this does NOT prevent the removed device from76 * syncing with OTHER peers in the device graph, and the device RETAINS77 * its copy of the vault root key (syncMasterKey) — it can still decrypt78 * anything it already holds and anything other peers send it. For a79 * lost or stolen device, removal is insufficient: use "Rotate sync80 * identity" (vault.ts rotateSyncIdentity), which re-keys the vault so81 * the old device's key material is useless.82 */83export async function removePairedDeviceById(deviceId: string): Promise<void> {84  const devices = await listPairedDevices();85  const filtered = devices.filter((d) => d.deviceId !== deviceId);86  // Unpairing is local-only — there is no remote unpair RPC. The remote87  // device retains this device in its own registry. Noise XX rejection on88  // the next connection attempt is the security boundary.89  await chrome.storage.local.set({ [REGISTRY_KEY]: filtered });90  // Also clear the per-network IP cache for this device.91  const device = devices.find((d) => d.deviceId === deviceId);92  if (device?.longTermPublicKeyHex) {93    await chrome.storage.local.remove(LAST_IP_KEY_PREFIX + device.longTermPublicKeyHex);94  }95}9697export async function clearPairedDevices(): Promise<void> {98  await chrome.storage.local.remove(REGISTRY_KEY);99}100101export async function markLastSyncedAt(deviceId: string, when: number): Promise<void> {102  const devices = await listPairedDevices();103  const idx = devices.findIndex((d) => d.deviceId === deviceId);104  if (idx < 0) return;105  devices[idx] = { ...devices[idx], lastSyncedAt: when };106  await chrome.storage.local.set({ [REGISTRY_KEY]: devices });107}108109export async function getLastKnownIp(pubkeyHex: string): Promise<string | null> {110  try {111    const key = LAST_IP_KEY_PREFIX + pubkeyHex;112    const result = await chrome.storage.local.get(key);113    const value = (result as Record<string, unknown>)[key];114    return typeof value === "string" ? value : null;115  } catch {116    return null;117  }118}119120export async function setLastKnownIp(pubkeyHex: string, ip: string): Promise<void> {121  await chrome.storage.local.set({ [LAST_IP_KEY_PREFIX + pubkeyHex]: ip });122}123124export async function clearLastKnownIp(pubkeyHex: string): Promise<void> {125  await chrome.storage.local.remove(LAST_IP_KEY_PREFIX + pubkeyHex);126}127128export async function getLastSyncAt(): Promise<number | null> {129  try {130    const result = await chrome.storage.local.get(LAST_SYNC_AT_KEY);131    const value = (result as Record<string, unknown>)[LAST_SYNC_AT_KEY];132    if (typeof value === "number") return value;133    if (typeof value === "string" && value !== "") {134      const n = Number.parseInt(value, 10);135      return Number.isFinite(n) ? n : null;136    }137    return null;138  } catch {139    return null;140  }141}142143export async function setLastSyncAt(when: number): Promise<void> {144  await chrome.storage.local.set({ [LAST_SYNC_AT_KEY]: when });145}146147export interface SyncResult {148  entriesReceived: number;149  entriesSent: number;150}151152export async function getLastSyncResult(): Promise<SyncResult | null> {153  try {154    const result = await chrome.storage.local.get(LAST_SYNC_RESULT_KEY);155    const value = (result as Record<string, unknown>)[LAST_SYNC_RESULT_KEY];156    if (157      value &&158      typeof value === "object" &&159      typeof (value as Record<string, unknown>).entriesReceived === "number" &&160      typeof (value as Record<string, unknown>).entriesSent === "number"161    ) {162      return value as SyncResult;163    }164    return null;165  } catch {166    return null;167  }168}169170export async function setLastSyncResult(result: SyncResult): Promise<void> {171  await chrome.storage.local.set({ [LAST_SYNC_RESULT_KEY]: result });172}173174function isPairedDevice(x: unknown): x is PairedDevice {175  if (typeof x !== "object" || x === null) return false;176  const r = x as Record<string, unknown>;177  if (typeof r.deviceId !== "string" || !r.deviceId) return false;178  if (typeof r.pairedAt !== "number") return false;179  return true;180}