@powerhousedao/connect-core 6.2.3-dev.81 → 6.2.3-dev.83

package/dist/runtime-LvAkxbdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-LvAkxbdf.js","names":[],"sources":["../src/runtime/multi-reactor-flag.ts","../src/runtime/reactor-worker-flag.ts","../src/runtime/reactor-client-mode.ts","../src/runtime/app-reactor-client.ts","../src/runtime/drive-placement.ts","../src/runtime/drive-placements.ts","../src/runtime/ph-store.ts","../src/runtime/local-package.ts"],"sourcesContent":["import { getRuntimeConfig } from \"./runtime-config.js\";\n\n// Config only: the flag is in the worker fingerprint, so a per-tab value would split tabs.\nexport function isMultiReactorEnabled(): boolean {\n  return getRuntimeConfig().connect.instance?.multiReactor ?? false;\n}\n","import { getRuntimeConfig } from \"./runtime-config.js\";\nimport {\n  isRuntimeFlagEnabled,\n  resolveRuntimeFlag,\n  type RuntimeFlagInput,\n} from \"./runtime-flag.js\";\n\nexport const REACTOR_WORKER_QUERY_KEY = \"reactorWorker\";\nexport const REACTOR_WORKER_STORAGE_KEY = \"ph:reactorWorker\";\n\nexport type ReactorWorkerFlagInput = RuntimeFlagInput;\n\nexport function resolveReactorWorkerEnabled(\n  input: ReactorWorkerFlagInput,\n): boolean {\n  return resolveRuntimeFlag(input);\n}\n\nexport function isReactorWorkerEnabled(): boolean {\n  return isRuntimeFlagEnabled({\n    queryKey: REACTOR_WORKER_QUERY_KEY,\n    storageKey: REACTOR_WORKER_STORAGE_KEY,\n    readConfigFlag: () =>\n      getRuntimeConfig().connect.instance?.reactorWorker ?? false,\n  });\n}\n","import type { PHReactorClientMode } from \"@powerhousedao/shared/clis\";\nimport { getRuntimeConfig } from \"./runtime-config.js\";\nimport { isMultiReactorEnabled } from \"./multi-reactor-flag.js\";\nimport { isReactorWorkerEnabled } from \"./reactor-worker-flag.js\";\n\n/**\n * Which of the four reactor clients Connect boots. Standardized by the\n * multi-reactor work; this resolves the single selector Connect acts on:\n *\n *   in-process | worker | remote | router\n *\n * Precedence: an explicit `?reactorClient=` query override (kept in\n * localStorage so it survives a reload), then a stored override, then the\n * served `connect.instance.reactorClient` (projected from the host's reactor\n * backends), then the LEGACY booleans — so a config that only sets\n * reactorWorker/multiReactor behaves exactly as before.\n *\n * `remote` is the only mode that builds NO local reactor (no PGlite): it is a\n * pure client to a remote Switchboard. `router` keeps the local reactor and\n * adds remote backends; `worker`/`in-process` are the local reactor alone.\n */\nexport type ReactorClientMode = PHReactorClientMode;\n\nconst MODES: ReadonlySet<string> = new Set([\n  \"in-process\",\n  \"worker\",\n  \"remote\",\n  \"router\",\n]);\n\nexport const REACTOR_CLIENT_QUERY_KEY = \"reactorClient\";\nexport const REACTOR_CLIENT_STORAGE_KEY = \"ph:reactorClient\";\n\nconst asMode = (value: string | null | undefined) =>\n  value && MODES.has(value) ? (value as ReactorClientMode) : undefined;\n\nfunction fromTab(): ReactorClientMode | undefined {\n  if (typeof window === \"undefined\") return undefined;\n  let query: ReactorClientMode | undefined;\n  try {\n    query = asMode(\n      new URLSearchParams(window.location.search).get(REACTOR_CLIENT_QUERY_KEY),\n    );\n  } catch {\n    return undefined;\n  }\n  try {\n    if (query) {\n      window.localStorage.setItem(REACTOR_CLIENT_STORAGE_KEY, query);\n      return query;\n    }\n    return asMode(window.localStorage.getItem(REACTOR_CLIENT_STORAGE_KEY));\n  } catch {\n    // Blocked storage: the query still applies for this page load.\n    return query;\n  }\n}\n\nexport function resolveReactorClientMode(): ReactorClientMode {\n  const override = fromTab();\n  if (override) return override;\n  const configured = getRuntimeConfig().connect.instance?.reactorClient;\n  if (configured && MODES.has(configured)) return configured;\n  // Legacy fallback — unchanged behaviour for configs without reactorClient.\n  if (isMultiReactorEnabled()) return \"router\";\n  if (isReactorWorkerEnabled()) return \"worker\";\n  return \"in-process\";\n}\n","import type { IReactorClient } from \"@powerhousedao/reactor\";\nimport {\n  getDrives,\n  getFullReactorClient,\n  getPHStore,\n  recordBackendAuthError,\n  setBackendAuth,\n  setDrives,\n  setFullReactorClient,\n} from \"@powerhousedao/reactor-browser\";\nimport type { DocumentDriveDocument } from \"@powerhousedao/shared/document-drive\";\nimport type { ISigner } from \"@powerhousedao/shared/document-model\";\nimport { logger } from \"document-model\";\nimport { switchboardOfDrive } from \"@powerhousedao/shared/host-tokens\";\nimport type * as MultiReactor from \"./multi-reactor.js\";\nimport type {\n  LoadedDocumentModels,\n  LocalReactorModule,\n} from \"./multi-reactor.js\";\nimport type { ReactorClientMode } from \"./reactor-client-mode.js\";\nimport { resolveReactorClientMode } from \"./reactor-client-mode.js\";\nimport { isReactorWorkerEnabled } from \"./reactor-worker-flag.js\";\nimport { setDriveRelister } from \"./drive-relist.js\";\n\n// Kept here: multi-reactor.ts is loaded lazily.\nconst REMOTE_BACKEND_NAME = \"switchboard-remote\";\n\ntype MultiReactorModule = typeof MultiReactor;\n\nexport type AppReactorClientParams = {\n  mode: ReactorClientMode;\n  /** Built, and ready (the worker has started up). Undefined in `remote`\n   * mode, where no local reactor is built. */\n  module: LocalReactorModule | undefined;\n  /** The fallback switchboard when `remoteBackends` is empty. */\n  remoteDriveUrl: string | undefined;\n  /** One per switchboard, by host key; `url` is a drive address on it. */\n  remoteBackends?: readonly { name: string; url: string }[];\n  /** Config placements known at build time; later ones go through `setConfiguredPlacement`. */\n  collections?: Readonly<Record<string, string>>;\n  /** Signs routed writes; unsigned (anonymous) without one. */\n  signer?: ISigner;\n  documentModelModules: LoadedDocumentModels;\n  loadRouter?: () => Promise<MultiReactorModule>;\n};\n\nconst loadMultiReactor = (): Promise<MultiReactorModule> =>\n  import(\"./multi-reactor.js\");\n\n/** What a mode builds in the tab; `remote` builds no local reactor (no PGlite). */\nexport type ReactorClientPlan = {\n  mode: ReactorClientMode;\n  /** `router`: the local reactor plus remote backends. */\n  multiReactor: boolean;\n  needsLocalReactor: boolean;\n  /** The local reactor runs in the shared worker. */\n  localAsWorker: boolean;\n};\n\nexport function planReactorClient(\n  mode: ReactorClientMode = resolveReactorClientMode(),\n): ReactorClientPlan {\n  const needsLocalReactor = mode !== \"remote\";\n  return {\n    mode,\n    multiReactor: mode === \"router\",\n    needsLocalReactor,\n    localAsWorker:\n      needsLocalReactor &&\n      (mode === \"worker\" || (mode === \"router\" && isReactorWorkerEnabled())),\n  };\n}\n\n/** Builds the tab's reactor, e.g. Connect's PGlite or worker reactor. */\nexport type LocalReactorFactory = (\n  plan: ReactorClientPlan,\n) => Promise<LocalReactorModule>;\n\nexport type CreateAppReactorClientOptions = Omit<\n  AppReactorClientParams,\n  \"mode\" | \"module\"\n> & {\n  plan?: ReactorClientPlan;\n  /** Called only when the plan needs a local reactor. */\n  localReactor?: LocalReactorFactory;\n};\n\n/** Builds the local reactor the plan needs, then selects the app's client. */\nexport async function createAppReactorClient(\n  options: CreateAppReactorClientOptions,\n) {\n  const { localReactor, ...params } = options;\n  const plan = options.plan ?? planReactorClient();\n  let module: LocalReactorModule | undefined;\n  if (plan.needsLocalReactor) {\n    if (!localReactor) {\n      throw new Error(\n        `reactorClient mode \"${plan.mode}\" needs a local reactor; pass localReactor`,\n      );\n    }\n    module = await localReactor(plan);\n  }\n  const { client, router } = await selectClient({\n    ...params,\n    mode: plan.mode,\n    module,\n  });\n  return { plan, module, client, router };\n}\n\n/**\n * Pick the client for the resolved mode:\n *  - `in-process` / `worker`: the local client, router module never loaded.\n *  - `router`: the local reactor plus remote backends.\n *  - `remote`: a remote-only router — a full IReactorClient that proxies to\n *    the Switchboard over GraphQL with NO local reactor (no PGlite).\n */\nexport async function selectAppReactorClient(\n  params: AppReactorClientParams,\n): Promise<IReactorClient> {\n  return (await selectClient(params)).client;\n}\n\n/** The app's client, and the router when it is one. */\nasync function selectClient(params: AppReactorClientParams): Promise<{\n  client: IReactorClient;\n  router?: MultiReactor.ConnectRoutingClient;\n}> {\n  if (params.mode === \"remote\") {\n    setFullReactorClient(undefined);\n    const remote = await buildRemoteOnly(params);\n    setFullReactorClient(remote);\n    return { client: remote, router: remote };\n  }\n  if (params.mode !== \"router\") {\n    if (getPHStore()?.fullReactorClient) {\n      setFullReactorClient(undefined);\n    }\n    return { client: requireModule(params).client };\n  }\n  setFullReactorClient(undefined);\n  const routed = await buildRouter(params);\n  setFullReactorClient(routed);\n  return routed\n    ? { client: routed, router: routed }\n    : { client: requireModule(params).client };\n}\n\nfunction requireModule(params: AppReactorClientParams): LocalReactorModule {\n  if (!params.module) {\n    throw new Error(\n      `reactorClient mode \"${params.mode}\" needs a local reactor, but none was built`,\n    );\n  }\n  return params.module;\n}\n\n/**\n * A Switchboard that cannot answer must not fail boot: list the tab's drives.\n *\n * A Switchboard that REFUSES the caller (401/403) must not fail boot either:\n * the refusal is recorded (`backendAuth`) so the root view shows the sign-in\n * gate, and the drive list is empty until the user is someone the backend\n * accepts. A remote-only client has no local drives to fall back on.\n */\nexport async function getAppDrives(\n  client: IReactorClient,\n  local: IReactorClient,\n): Promise<DocumentDriveDocument[]> {\n  if (client === local) {\n    try {\n      const drives = await getDrives(local);\n      setBackendAuth(undefined);\n      return drives;\n    } catch (error) {\n      if (recordBackendAuthError(error, \"switchboard\")) {\n        logger.warn(\n          \"The Switchboard refused this caller; showing the sign-in gate: @error\",\n          error,\n        );\n        return [];\n      }\n      throw error;\n    }\n  }\n  try {\n    const drives = await getDrives(client);\n    setBackendAuth(undefined);\n    return drives;\n  } catch (error) {\n    if (recordBackendAuthError(error, \"switchboard\")) {\n      logger.warn(\n        \"A remote backend refused this caller; listing the local reactor's drives: @error\",\n        error,\n      );\n    } else {\n      logger.warn(\n        \"Could not list drives through the router; listing the local reactor's: @error\",\n        error,\n      );\n    }\n    return getDrives(local);\n  }\n}\n\n/**\n * The boot refresh of the drives store. It lists through `getAppDrives`\n * whichever client is in use, so a Switchboard that refuses the caller is\n * recorded for the sign-in gate here too: the remote-only client is its own\n * `local`, and a bare `refreshReactorDataClient` would let the 401 escape\n * and fail the boot before the gate can render.\n */\nexport async function refreshAppDrives(\n  client: IReactorClient,\n  local: IReactorClient,\n): Promise<void> {\n  setDrives(await getAppDrives(client, local));\n}\n\n/**\n * Lists the drives again as the caller the tab now is, through the clients\n * boot left in the store: after a sign-in landing or a sign-out that followed\n * a backend's refusal. Nothing to do before boot has set a client.\n */\nexport async function relistAppDrives(): Promise<void> {\n  const client = getFullReactorClient();\n  if (!client) return;\n  const local = getPHStore()?.reactorClientModule?.client ?? client;\n  await refreshAppDrives(client, local);\n}\n\n// The backend auth gate relists through drive-relist (see there)\nsetDriveRelister(relistAppDrives);\n\n/** The switchboards to route to: the host's remote backends, else the default drive's. */\nfunction switchboardRemotes(params: AppReactorClientParams): {\n  remotes: MultiReactor.SwitchboardRemote[];\n  unparsed: string[];\n} {\n  const listed = params.remoteBackends?.length\n    ? params.remoteBackends\n    : params.remoteDriveUrl\n      ? [{ name: REMOTE_BACKEND_NAME, url: params.remoteDriveUrl }]\n      : [];\n  const remotes: MultiReactor.SwitchboardRemote[] = [];\n  const unparsed: string[] = [];\n  for (const { name, url } of listed) {\n    const graphqlUrl = switchboardOfDrive(url)?.graphql;\n    if (graphqlUrl) remotes.push({ name, graphqlUrl });\n    else unparsed.push(url);\n  }\n  return { remotes, unparsed };\n}\n\nasync function buildRouter(\n  params: AppReactorClientParams,\n): Promise<MultiReactor.ConnectRoutingClient | undefined> {\n  const { remotes, unparsed } = switchboardRemotes(params);\n  for (const url of unparsed) {\n    logger.warn(\n      \"multiReactor is on but the remote drive URL @url does not parse; skipping it\",\n      url,\n    );\n  }\n  if (remotes.length === 0) {\n    logger.warn(\n      \"multiReactor is on but no remote drive URL is configured; using the local reactor only\",\n    );\n    return undefined;\n  }\n  let multiReactor: MultiReactorModule;\n  try {\n    multiReactor = await (params.loadRouter ?? loadMultiReactor)();\n  } catch (error) {\n    logger.error(\"Could not load the multi-reactor router: @error\", error);\n    return undefined;\n  }\n  logger.info(\n    \"Multi-reactor routing to @urls\",\n    remotes.map((remote) => remote.graphqlUrl).join(\", \"),\n  );\n  return multiReactor.buildMultiReactorClient({\n    module: requireModule(params),\n    remotes,\n    collections: params.collections,\n    signer: params.signer,\n    documentModelModules: params.documentModelModules,\n  });\n}\n\n/**\n * The `remote` mode: a remote-only router — a full IReactorClient that proxies\n * to the Switchboard over GraphQL with NO local backend, so no local reactor\n * and no PGlite are ever built. A missing/unparseable remote URL is a hard\n * config error here (unlike `router`, there is no local reactor to fall back\n * to).\n */\nasync function buildRemoteOnly(\n  params: AppReactorClientParams,\n): Promise<MultiReactor.ConnectRoutingClient> {\n  const { remotes, unparsed } = switchboardRemotes(params);\n  if (unparsed.length > 0) {\n    throw new Error(\n      `reactorClient \"remote\": the remote drive URL \"${unparsed[0]}\" does not resolve to a Switchboard GraphQL endpoint`,\n    );\n  }\n  if (remotes.length === 0) {\n    throw new Error(\n      'reactorClient \"remote\" needs a remote drive URL — declare a remote backend / default drive the client can proxy to',\n    );\n  }\n  const multiReactor = await (params.loadRouter ?? loadMultiReactor)();\n  logger.info(\n    \"Remote reactor client → @urls\",\n    remotes.map((remote) => remote.graphqlUrl).join(\", \"),\n  );\n  return multiReactor.buildMultiReactorClient({\n    module: undefined,\n    remotes,\n    collections: params.collections,\n    signer: params.signer,\n    documentModelModules: params.documentModelModules,\n  });\n}\n","import { DriveCollectionId } from \"@powerhousedao/reactor\";\nimport type {\n  PHConnectCollection,\n  PHConnectRemoteBackend,\n  PHConnectRuntimeDefaultDrive,\n} from \"@powerhousedao/shared/clis\";\nimport { switchboardOfDrive } from \"@powerhousedao/shared/host-tokens\";\nimport { logger } from \"document-model\";\n\n/** The router backend of the reactor in this browser. */\nexport const LOCAL_BACKEND_NAME = \"connect-local\";\n\n/** A drive the host keeps on a switchboard, and where its config opens it. */\nexport type SwitchboardDrive = {\n  /** The host's name for it: its address's slug, or a collection's key. */\n  slug: string;\n  url: string;\n  /** The switchboard's backend. */\n  remote: string;\n  /** `remote` (no copy here) or `LOCAL_BACKEND_NAME` (a synced copy). */\n  configured: string;\n  /** Not a default drive: its address may not be the one it is served at. */\n  collection: boolean;\n};\n\n/** A switchboard drive with the names callers reach it by. */\nexport type ResolvedSwitchboardDrive = SwitchboardDrive & {\n  id?: string;\n  servedSlug?: string;\n};\n\n/** A drive this browser moved away from its host config. */\nexport type PlacementEntry = {\n  slug: string;\n  backend: string;\n  configWas: string;\n};\n\ntype PlacementConfig = {\n  drives?: { defaultDrives?: readonly PHConnectRuntimeDefaultDrive[] };\n  instance?: {\n    remoteBackends?: readonly PHConnectRemoteBackend[];\n    collections?: Record<string, PHConnectCollection>;\n  };\n};\n\nexport function keepsLocalCopy(drive: PHConnectRuntimeDefaultDrive): boolean {\n  return !(\"url\" in drive) || drive.sync !== false;\n}\n\n/** Remote default drives with a backend, then collections. */\nexport function switchboardDrives(config: PlacementConfig): SwitchboardDrive[] {\n  const drives: SwitchboardDrive[] = [];\n  for (const drive of config.drives?.defaultDrives ?? []) {\n    if (!(\"url\" in drive) || !drive.backend) continue;\n    const slug = switchboardOfDrive(drive.url)?.slug;\n    if (slug === undefined) continue;\n    drives.push({\n      slug,\n      url: drive.url,\n      remote: drive.backend,\n      configured: drive.sync === false ? drive.backend : LOCAL_BACKEND_NAME,\n      collection: false,\n    });\n  }\n  const remotes = config.instance?.remoteBackends ?? [];\n  for (const [slug, entry] of Object.entries(\n    config.instance?.collections ?? {},\n  )) {\n    const remote = remotes.find((r) => r.name === entry.backend);\n    const base = remote && switchboardOfDrive(remote.url)?.base;\n    if (!base || drives.some((drive) => drive.slug === slug)) continue;\n    drives.push({\n      slug,\n      url: `${base}/d/${encodeURIComponent(slug)}`,\n      remote: entry.backend,\n      configured: entry.sync === false ? entry.backend : LOCAL_BACKEND_NAME,\n      collection: true,\n    });\n  }\n  return drives;\n}\n\n/** Stale: no such drive, a backend it can't open on, back to config, or a changed config value. */\nexport function applyPlacementEntries(\n  drives: readonly SwitchboardDrive[],\n  entries: readonly PlacementEntry[],\n): { applied: PlacementEntry[]; stale: PlacementEntry[] } {\n  const applied: PlacementEntry[] = [];\n  const stale: PlacementEntry[] = [];\n  for (const entry of entries) {\n    const drive = drives.find((d) => d.slug === entry.slug);\n    const holds =\n      drive !== undefined &&\n      entry.configWas === drive.configured &&\n      entry.backend !== drive.configured &&\n      (entry.backend === drive.remote || entry.backend === LOCAL_BACKEND_NAME);\n    (holds ? applied : stale).push(entry);\n  }\n  return { applied, stale };\n}\n\n/** A served slug names a declared one as is, or hashed (`<slug>-<8 hex>`). */\nexport function servesSlug(declared: string, served: string): boolean {\n  return (\n    served === declared ||\n    (served.startsWith(`${declared}-`) &&\n      /^[0-9a-f]{8}$/.test(served.slice(declared.length + 1)))\n  );\n}\n\ntype DriveNames = { id: string; slug: string };\n\nfunction withinDeadline<T>(work: Promise<T>, timeoutMs: number): Promise<T> {\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const deadline = new Promise<never>((_, reject) => {\n    timer = setTimeout(\n      () => reject(new Error(`no answer in ${timeoutMs} ms`)),\n      timeoutMs,\n    );\n  });\n  return Promise.race([work, deadline]).finally(() => clearTimeout(timer));\n}\n\nexport type ResolveSwitchboardDrivesOptions = {\n  timeoutMs?: number;\n  /** A collection whose address does not answer: find it among its switchboard's drives. */\n  findServed?: (drive: SwitchboardDrive) => Promise<DriveNames | undefined>;\n};\n\n/** An unreachable drive keeps only the slug in its address. */\nexport async function resolveSwitchboardDrives(\n  drives: readonly SwitchboardDrive[],\n  fetchInfo: (url: string) => Promise<DriveNames>,\n  { timeoutMs = 5_000, findServed }: ResolveSwitchboardDrivesOptions = {},\n): Promise<ResolvedSwitchboardDrive[]> {\n  return Promise.all(\n    drives.map(async (drive): Promise<ResolvedSwitchboardDrive> => {\n      try {\n        const { id, slug } = await withinDeadline(\n          fetchInfo(drive.url),\n          timeoutMs,\n        );\n        return { ...drive, id, servedSlug: slug };\n      } catch (error) {\n        if (drive.collection && findServed) {\n          try {\n            const served = await withinDeadline(findServed(drive), timeoutMs);\n            if (served) {\n              return { ...drive, id: served.id, servedSlug: served.slug };\n            }\n          } catch (findError) {\n            logger.warn(\n              \"Could not find drive @slug on @remote: @error\",\n              drive.slug,\n              drive.remote,\n              findError,\n            );\n          }\n        }\n        logger.warn(\n          \"Could not read drive @url; routing it by its address only: @error\",\n          drive.url,\n          error,\n        );\n        const slug = switchboardOfDrive(drive.url)?.slug;\n        return slug === undefined ? drive : { ...drive, servedSlug: slug };\n      }\n    }),\n  );\n}\n\n/** The address the drive is served at. */\nexport function servedUrl(drive: ResolvedSwitchboardDrive): string {\n  const at = switchboardOfDrive(drive.url);\n  return at && drive.servedSlug && drive.servedSlug !== at.slug\n    ? `${at.base}/d/${encodeURIComponent(drive.servedSlug)}`\n    : drive.url;\n}\n\n/** The keys a placement is installed under: the id and the served slug. */\nexport function placementKeys(drive: ResolvedSwitchboardDrive): string[] {\n  return [drive.id, drive.servedSlug].filter(\n    (key): key is string => key !== undefined && key !== \"\",\n  );\n}\n\nexport type SyncRemotes = {\n  list(): readonly {\n    meta: { name: string; collectionId: DriveCollectionId };\n  }[];\n  remove(name: string): Promise<void>;\n};\n\n/** Drops the sync remote of every given drive; its local data is left unread. */\nexport async function removeLocalCopies(\n  sync: SyncRemotes,\n  resolved: readonly { id?: string }[],\n): Promise<void> {\n  for (const drive of resolved) {\n    if (!drive.id) continue;\n    const collectionId = DriveCollectionId.forDrive(drive.id);\n    const remotes = sync\n      .list()\n      .filter((remote) => remote.meta.collectionId.equals(collectionId));\n    for (const remote of remotes) {\n      await sync.remove(remote.meta.name);\n    }\n  }\n}\n","import type { RoutingReactorClient } from \"@powerhousedao/reactor-router\";\nimport { driveDocumentType } from \"@powerhousedao/shared/document-drive\";\nimport { logger } from \"document-model\";\nimport {\n  applyPlacementEntries,\n  servesSlug,\n  LOCAL_BACKEND_NAME,\n  placementKeys,\n  removeLocalCopies,\n  servedUrl,\n  type PlacementEntry,\n  type ResolvedSwitchboardDrive,\n  type SwitchboardDrive,\n  type SyncRemotes,\n} from \"./drive-placement.js\";\n\n/** A collection by its declared slug among its switchboard's drives, e.g. one served hashed. */\nexport async function findServedDrive(\n  router: Pick<RoutingReactorClient, \"backends\">,\n  drive: SwitchboardDrive,\n): Promise<{ id: string; slug: string } | undefined> {\n  const backend = router.backends.find((b) => b.name === drive.remote);\n  if (!backend) return undefined;\n  const { results } = await backend.api.find({ type: driveDocumentType });\n  const served = results.find(\n    (doc) => doc.header.slug && servesSlug(drive.slug, doc.header.slug),\n  );\n  return served && { id: served.header.id, slug: served.header.slug };\n}\n\n/** Where a drive opens given its stored move, if any: the move, else the host config. */\nexport function effectiveBackend(\n  drive: SwitchboardDrive,\n  entry: PlacementEntry | undefined,\n): string {\n  return entry?.backend ?? drive.configured;\n}\n\n/** A drive opening on `backend` reads its copy here, which must arrive first. */\nexport function needsCopy(backend: string): boolean {\n  return backend === LOCAL_BACKEND_NAME;\n}\n\n/** A copy has caught up once every scope is at least at the source's revision. */\nexport function caughtUp(\n  local: Readonly<Record<string, number>>,\n  source: Readonly<Record<string, number>>,\n): boolean {\n  return Object.entries(source).every(\n    ([scope, revision]) => (local[scope] ?? -1) >= revision,\n  );\n}\n\n/** Where this browser keeps its moves; per origin, so every tab shares it. */\nexport interface PlacementStore {\n  list(): Promise<PlacementEntry[]>;\n  put(entry: PlacementEntry): Promise<void>;\n  delete(slug: string): Promise<void>;\n}\n\n/** The router's two placement layers. */\nexport type PlacementRouter = {\n  setPlacement(key: string, backend: string | undefined): void;\n  setConfiguredPlacement(key: string, backend: string | undefined): void;\n};\n\nexport type PlacementSync = SyncRemotes & {\n  /** Adds a sync remote for the drive. */\n  add(url: string, driveId: string): Promise<void>;\n  /** Bounded wait until the local copy holds what `remote` holds; rejects when it does not. */\n  untilCopied(driveId: string, remote: string): Promise<void>;\n};\n\nexport type DrivePlacement = {\n  drive: ResolvedSwitchboardDrive;\n  /** Where the drive opens in this browser now. */\n  backend: string;\n  /** This browser moved it away from the host config. */\n  moved: boolean;\n  /** A move is running. */\n  busy: boolean;\n  /** Where a running move takes the drive. */\n  movingTo?: string;\n};\n\n/** Config placement plus this browser's moves: store, then sync remote, then router. */\nexport class DrivePlacements {\n  private applied = new Map<string, PlacementEntry>();\n  private resolved: ResolvedSwitchboardDrive[] = [];\n  private router: PlacementRouter | undefined;\n  private readonly busy = new Map<string, string>();\n  private attached = false;\n  private readonly listeners = new Set<() => void>();\n  private snapshot = new Map<string, DrivePlacement>();\n\n  constructor(\n    readonly drives: readonly SwitchboardDrive[],\n    applied: readonly PlacementEntry[],\n    private readonly store: PlacementStore,\n    private readonly sync: PlacementSync,\n  ) {\n    for (const entry of applied) this.applied.set(entry.slug, entry);\n  }\n\n  /** Reads the store and drops the entries the config has overtaken (O2). */\n  static async load(\n    drives: readonly SwitchboardDrive[],\n    store: PlacementStore,\n    sync: PlacementSync,\n  ): Promise<DrivePlacements> {\n    let entries: PlacementEntry[] = [];\n    try {\n      entries = await store.list();\n    } catch (error) {\n      logger.warn(\"Could not read this browser's drive moves: @error\", error);\n    }\n    const { applied, stale } = applyPlacementEntries(drives, entries);\n    for (const entry of stale) {\n      store.delete(entry.slug).catch((error: unknown) => {\n        logger.warn(\n          \"Could not drop drive move @slug: @error\",\n          entry.slug,\n          error,\n        );\n      });\n    }\n    return new DrivePlacements(drives, applied, store, sync);\n  }\n\n  /** Where `drive` opens in this browser: a move, else the config. */\n  backendOf(drive: SwitchboardDrive): string {\n    return effectiveBackend(drive, this.applied.get(drive.slug));\n  }\n\n  /** Whether a remote default drive at `url` keeps a copy here. */\n  keepsCopy(url: string): boolean {\n    const drive = this.drives.find((d) => d.url === url);\n    return !drive || this.backendOf(drive) === LOCAL_BACKEND_NAME;\n  }\n\n  /** Drives that open on their switchboard with no copy here. */\n  placed(): SwitchboardDrive[] {\n    return this.drives.filter(\n      (drive) => this.backendOf(drive) !== LOCAL_BACKEND_NAME,\n    );\n  }\n\n  /** Collections this browser keeps a copy of; default drives are added with the others. */\n  keptCollections(): ResolvedSwitchboardDrive[] {\n    return this.resolved.filter(\n      (drive) =>\n        drive.collection &&\n        drive.id !== undefined &&\n        this.backendOf(drive) === LOCAL_BACKEND_NAME,\n    );\n  }\n\n  /** Installs both layers for every drive the router can be told about. */\n  attach(\n    router: PlacementRouter | undefined,\n    resolved: readonly ResolvedSwitchboardDrive[],\n  ): void {\n    this.router = router;\n    this.resolved = [...resolved];\n    this.attached = true;\n    for (const drive of this.resolved) this.install(drive);\n    this.notify();\n  }\n\n  /**\n   * Attaches, follows the moves other tabs made since `load`, then brings\n   * the sync remotes in line; returns the collections to keep a copy of.\n   */\n  async start(\n    router: PlacementRouter | undefined,\n    resolved: readonly ResolvedSwitchboardDrive[],\n    syncsDrives: boolean,\n  ): Promise<ResolvedSwitchboardDrive[]> {\n    this.attach(router, resolved);\n    await this.reload();\n    if (!syncsDrives) return [];\n    const placed = new Set(this.placed().map((drive) => drive.slug));\n    await removeLocalCopies(\n      this.sync,\n      this.resolved.filter(\n        (drive) => placed.has(drive.slug) && !this.busy.has(drive.slug),\n      ),\n    );\n    return this.keptCollections();\n  }\n\n  /** The drive's placement in this browser; undefined for a drive the host does not place on a switchboard. */\n  placementOf(driveId: string): DrivePlacement | undefined {\n    return this.snapshot.get(driveId);\n  }\n\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  /** Opens the drive on `backend` in this browser: its switchboard, or a copy here. */\n  async move(driveId: string, backend: string): Promise<void> {\n    const drive = this.resolved.find((d) => d.id === driveId);\n    if (!drive?.id) {\n      throw new Error(\n        `Drive ${driveId} is not on a switchboard this app links`,\n      );\n    }\n    if (backend !== drive.remote && backend !== LOCAL_BACKEND_NAME) {\n      throw new Error(`Drive ${drive.slug} can't open on ${backend}`);\n    }\n    if (this.busy.has(drive.slug) || this.backendOf(drive) === backend) return;\n    const previous = this.applied.get(drive.slug);\n    const entry: PlacementEntry | undefined =\n      backend === drive.configured\n        ? undefined\n        : { slug: drive.slug, backend, configWas: drive.configured };\n    const id = drive.id;\n    this.busy.set(drive.slug, backend);\n    this.notify();\n    try {\n      await this.record(drive.slug, entry);\n      if (needsCopy(backend)) {\n        try {\n          await this.sync.add(servedUrl(drive), id);\n          await this.sync.untilCopied(id, drive.remote);\n        } catch (error) {\n          // Store first: the removal's broadcast makes other tabs re-read it.\n          await this.record(drive.slug, previous);\n          await removeLocalCopies(this.sync, [drive]);\n          throw error;\n        }\n      } else {\n        try {\n          await removeLocalCopies(this.sync, [drive]);\n        } catch (error) {\n          await this.record(drive.slug, previous);\n          throw error;\n        }\n      }\n      this.install(drive);\n    } finally {\n      this.busy.delete(drive.slug);\n      this.notify();\n    }\n  }\n\n  /** Back to where the host config opens the drive. */\n  reset(driveId: string): Promise<void> {\n    const drive = this.resolved.find((d) => d.id === driveId);\n    return drive ? this.move(driveId, drive.configured) : Promise.resolve();\n  }\n\n  /** Re-reads the store after another tab moved a drive; true when something changed. */\n  async reload(): Promise<boolean> {\n    if (!this.attached) return false;\n    const next = await this.readMoves();\n    if (!next) return false;\n    const changed = this.drives.filter(\n      (drive) =>\n        !this.busy.has(drive.slug) &&\n        effectiveBackend(drive, next.get(drive.slug)) !== this.backendOf(drive),\n    );\n    if (changed.length === 0) return false;\n    await Promise.all(\n      changed.map((drive) => this.follow(drive, next.get(drive.slug))),\n    );\n    this.notify();\n    return true;\n  }\n\n  /** A copy kept by another tab is routed here only once it has arrived. */\n  private async follow(\n    drive: SwitchboardDrive,\n    entry: PlacementEntry | undefined,\n  ): Promise<void> {\n    const resolved = this.resolved.find((d) => d.slug === drive.slug);\n    if (needsCopy(effectiveBackend(drive, entry)) && resolved?.id) {\n      this.busy.set(drive.slug, LOCAL_BACKEND_NAME);\n      this.notify();\n      try {\n        await this.sync.untilCopied(resolved.id, resolved.remote);\n      } catch (error) {\n        logger.warn(\n          \"Drive @slug was not copied into this browser; leaving it where it opens: @error\",\n          drive.slug,\n          error,\n        );\n        return;\n      } finally {\n        this.busy.delete(drive.slug);\n      }\n      // The mover may have rolled back while this tab waited.\n      const latest = await this.readMoves();\n      if (!latest) return;\n      entry = latest.get(drive.slug);\n    }\n    if (entry) this.applied.set(drive.slug, entry);\n    else this.applied.delete(drive.slug);\n    if (resolved) this.install(resolved);\n  }\n\n  private async readMoves(): Promise<Map<string, PlacementEntry> | undefined> {\n    let entries: PlacementEntry[];\n    try {\n      entries = await this.store.list();\n    } catch (error) {\n      logger.warn(\"Could not read this browser's drive moves: @error\", error);\n      return undefined;\n    }\n    const { applied } = applyPlacementEntries(this.drives, entries);\n    return new Map(applied.map((entry) => [entry.slug, entry]));\n  }\n\n  private async record(\n    slug: string,\n    entry: PlacementEntry | undefined,\n  ): Promise<void> {\n    if (entry) {\n      await this.store.put(entry);\n      this.applied.set(slug, entry);\n    } else {\n      await this.store.delete(slug);\n      this.applied.delete(slug);\n    }\n  }\n\n  private install(drive: ResolvedSwitchboardDrive): void {\n    const router = this.router;\n    if (!router) return;\n    const configured =\n      drive.configured === drive.remote ? drive.remote : undefined;\n    const runtime = this.applied.get(drive.slug)?.backend;\n    for (const key of placementKeys(drive)) {\n      router.setConfiguredPlacement(key, configured);\n      router.setPlacement(key, runtime);\n    }\n  }\n\n  private notify(): void {\n    const snapshot = new Map<string, DrivePlacement>();\n    for (const drive of this.resolved) {\n      if (!drive.id) continue;\n      const backend = this.backendOf(drive);\n      snapshot.set(drive.id, {\n        drive,\n        backend,\n        moved: backend !== drive.configured,\n        busy: this.busy.has(drive.slug),\n        ...(this.busy.has(drive.slug)\n          ? { movingTo: this.busy.get(drive.slug) }\n          : {}),\n      });\n    }\n    this.snapshot = snapshot;\n    for (const listener of [...this.listeners]) listener();\n  }\n}\n","import type { PHStore } from \"@powerhousedao/reactor-browser\";\nimport {\n  bindPHStoreToWindow,\n  createPHStore,\n  getActivePHStore,\n} from \"@powerhousedao/reactor-browser\";\n\n/** The app's PH store: the active one, else a new one bound to `window.ph`.\n * Values set on `window.ph` before carry over. */\nexport function getConnectPHStore(): PHStore {\n  const active = getActivePHStore();\n  if (active) return active;\n  const store = createPHStore();\n  bindPHStoreToWindow(store);\n  return store;\n}\n","import type { DocumentModelLib } from \"document-model\";\n\n/** A module namespace, as `import * as pkg` or Vite HMR hands it over. */\nexport type ModuleNamespace = Record<string, any> & {\n  [Symbol.toStringTag]: \"Module\";\n};\n\nexport type LocalPackage = DocumentModelLib<any> | ModuleNamespace;\n\n/** The package itself, or a loader (`() => import(\"./index.js\")`) that keeps it off the boot path. */\nexport type LocalPackageSource = LocalPackage | (() => Promise<LocalPackage>);\n\n/** Starts loading the project's package; a loader runs once, here. */\nexport function loadLocalPackage(\n  source: LocalPackageSource | undefined,\n): DocumentModelLib | Promise<DocumentModelLib> | undefined {\n  const pkg = (typeof source === \"function\" ? source() : source) as\n    | DocumentModelLib\n    | Promise<DocumentModelLib>\n    | undefined;\n  // Consumers await it; this only stops an early rejection being reported as unhandled.\n  if (pkg instanceof Promise) pkg.catch(() => undefined);\n  return pkg;\n}\n"],"mappings":"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"}

package/dist/runtime.d.ts

@@ -1,6 +1,6 @@
-import { A as isRuntimeFlagEnabled, C as REACTOR_WORKER_STORAGE_KEY, D as isMultiReactorEnabled, E as resolveReactorWorkerEnabled, O as RuntimeFlagInput, S as REACTOR_WORKER_QUERY_KEY, T as isReactorWorkerEnabled, _ as LocalReactorModule, a as getConnectPHStore, b as ReactorClientMode, c as LocalReactorFactory, d as getAppDrives, f as planReactorClient, g as LoadedDocumentModels, h as selectAppReactorClient, i as loadLocalPackage, j as resolveRuntimeFlag, k as RuntimeFlagKeys, l as ReactorClientPlan, m as relistAppDrives, n as LocalPackageSource, o as AppReactorClientParams, p as refreshAppDrives, r as ModuleNamespace, s as CreateAppReactorClientOptions, t as LocalPackage, u as createAppReactorClient, v as REACTOR_CLIENT_QUERY_KEY, w as ReactorWorkerFlagInput, x as resolveReactorClientMode, y as REACTOR_CLIENT_STORAGE_KEY } from "./index-BMlma368.js";
+import { $ as resolveRuntimeFlag, A as ResolvedSwitchboardDrive, B as REACTOR_CLIENT_QUERY_KEY, C as relistAppDrives, D as LOCAL_BACKEND_NAME, E as LocalReactorModule, F as removeLocalCopies, G as REACTOR_WORKER_STORAGE_KEY, H as ReactorClientMode, I as resolveSwitchboardDrives, J as resolveReactorWorkerEnabled, K as ReactorWorkerFlagInput, L as servedUrl, M as applyPlacementEntries, N as keepsLocalCopy, O as PlacementEntry, P as placementKeys, Q as isRuntimeFlagEnabled, R as servesSlug, S as refreshAppDrives, T as LoadedDocumentModels, U as resolveReactorClientMode, V as REACTOR_CLIENT_STORAGE_KEY, W as REACTOR_WORKER_QUERY_KEY, X as RuntimeFlagInput, Y as isMultiReactorEnabled, Z as RuntimeFlagKeys, _ as LocalReactorFactory, a as getConnectPHStore, b as getAppDrives, c as PlacementRouter, d as caughtUp, f as effectiveBackend, g as CreateAppReactorClientOptions, h as AppReactorClientParams, i as loadLocalPackage, j as SwitchboardDrive, k as ResolveSwitchboardDrivesOptions, l as PlacementStore, m as needsCopy, n as LocalPackageSource, o as DrivePlacement, p as findServedDrive, q as isReactorWorkerEnabled, r as ModuleNamespace, s as DrivePlacements, t as LocalPackage, u as PlacementSync, v as ReactorClientPlan, w as selectAppReactorClient, x as planReactorClient, y as createAppReactorClient, z as switchboardDrives } from "./index-ZFFeYX4A.js";
 import { i as primeRuntimeConfig, n as getRuntimeConfig, r as loadRuntimeConfig } from "./runtime-config-D3YPhYyj.js";
 import { n as useBackendAuthGate, t as BackendAuthGateMode } from "./backend-auth-gate-DiFpY5rt.js";
 import { n as useIsEmbedded, t as getIsEmbedded } from "./embedded-DT1C47F0.js";
-export { type AppReactorClientParams, type BackendAuthGateMode, type CreateAppReactorClientOptions, type LoadedDocumentModels, type LocalPackage, type LocalPackageSource, type LocalReactorFactory, type LocalReactorModule, type ModuleNamespace, REACTOR_CLIENT_QUERY_KEY, REACTOR_CLIENT_STORAGE_KEY, REACTOR_WORKER_QUERY_KEY, REACTOR_WORKER_STORAGE_KEY, type ReactorClientMode, type ReactorClientPlan, type ReactorWorkerFlagInput, type RuntimeFlagInput, type RuntimeFlagKeys, createAppReactorClient, getAppDrives, getConnectPHStore, getIsEmbedded, getRuntimeConfig, isMultiReactorEnabled, isReactorWorkerEnabled, isRuntimeFlagEnabled, loadLocalPackage, loadRuntimeConfig, planReactorClient, primeRuntimeConfig, refreshAppDrives, relistAppDrives, resolveReactorClientMode, resolveReactorWorkerEnabled, resolveRuntimeFlag, selectAppReactorClient, useBackendAuthGate, useIsEmbedded };
+export { type AppReactorClientParams, type BackendAuthGateMode, type CreateAppReactorClientOptions, type DrivePlacement, DrivePlacements, LOCAL_BACKEND_NAME, type LoadedDocumentModels, type LocalPackage, type LocalPackageSource, type LocalReactorFactory, type LocalReactorModule, type ModuleNamespace, type PlacementEntry, type PlacementRouter, type PlacementStore, type PlacementSync, REACTOR_CLIENT_QUERY_KEY, REACTOR_CLIENT_STORAGE_KEY, REACTOR_WORKER_QUERY_KEY, REACTOR_WORKER_STORAGE_KEY, type ReactorClientMode, type ReactorClientPlan, type ReactorWorkerFlagInput, type ResolveSwitchboardDrivesOptions, type ResolvedSwitchboardDrive, type RuntimeFlagInput, type RuntimeFlagKeys, type SwitchboardDrive, applyPlacementEntries, caughtUp, createAppReactorClient, effectiveBackend, findServedDrive, getAppDrives, getConnectPHStore, getIsEmbedded, getRuntimeConfig, isMultiReactorEnabled, isReactorWorkerEnabled, isRuntimeFlagEnabled, keepsLocalCopy, loadLocalPackage, loadRuntimeConfig, needsCopy, placementKeys, planReactorClient, primeRuntimeConfig, refreshAppDrives, relistAppDrives, removeLocalCopies, resolveReactorClientMode, resolveReactorWorkerEnabled, resolveRuntimeFlag, resolveSwitchboardDrives, selectAppReactorClient, servedUrl, servesSlug, switchboardDrives, useBackendAuthGate, useIsEmbedded };
 export {};

package/dist/runtime.js

@@ -1,6 +1,6 @@
 import { getIsEmbedded, useIsEmbedded } from "./embedded.js";
 import { getRuntimeConfig, loadRuntimeConfig, primeRuntimeConfig } from "./runtime-config.js";
 import { n as resolveRuntimeFlag, t as isRuntimeFlagEnabled } from "./runtime-flag-DvxW_SD4.js";
-import { a as planReactorClient, c as selectAppReactorClient, d as resolveReactorClientMode, f as REACTOR_WORKER_QUERY_KEY, g as isMultiReactorEnabled, h as resolveReactorWorkerEnabled, i as getAppDrives, l as REACTOR_CLIENT_QUERY_KEY, m as isReactorWorkerEnabled, n as getConnectPHStore, o as refreshAppDrives, p as REACTOR_WORKER_STORAGE_KEY, r as createAppReactorClient, s as relistAppDrives, t as loadLocalPackage, u as REACTOR_CLIENT_STORAGE_KEY } from "./runtime-D20_LlB_.js";
+import { A as isMultiReactorEnabled, C as REACTOR_CLIENT_QUERY_KEY, D as REACTOR_WORKER_STORAGE_KEY, E as REACTOR_WORKER_QUERY_KEY, O as isReactorWorkerEnabled, S as selectAppReactorClient, T as resolveReactorClientMode, _ as createAppReactorClient, a as effectiveBackend, b as refreshAppDrives, c as LOCAL_BACKEND_NAME, d as placementKeys, f as removeLocalCopies, g as switchboardDrives, h as servesSlug, i as caughtUp, k as resolveReactorWorkerEnabled, l as applyPlacementEntries, m as servedUrl, n as getConnectPHStore, o as findServedDrive, p as resolveSwitchboardDrives, r as DrivePlacements, s as needsCopy, t as loadLocalPackage, u as keepsLocalCopy, v as getAppDrives, w as REACTOR_CLIENT_STORAGE_KEY, x as relistAppDrives, y as planReactorClient } from "./runtime-LvAkxbdf.js";
 import { t as useBackendAuthGate } from "./backend-auth-gate-DNKg_v4Y.js";
-export { REACTOR_CLIENT_QUERY_KEY, REACTOR_CLIENT_STORAGE_KEY, REACTOR_WORKER_QUERY_KEY, REACTOR_WORKER_STORAGE_KEY, createAppReactorClient, getAppDrives, getConnectPHStore, getIsEmbedded, getRuntimeConfig, isMultiReactorEnabled, isReactorWorkerEnabled, isRuntimeFlagEnabled, loadLocalPackage, loadRuntimeConfig, planReactorClient, primeRuntimeConfig, refreshAppDrives, relistAppDrives, resolveReactorClientMode, resolveReactorWorkerEnabled, resolveRuntimeFlag, selectAppReactorClient, useBackendAuthGate, useIsEmbedded };
+export { DrivePlacements, LOCAL_BACKEND_NAME, REACTOR_CLIENT_QUERY_KEY, REACTOR_CLIENT_STORAGE_KEY, REACTOR_WORKER_QUERY_KEY, REACTOR_WORKER_STORAGE_KEY, applyPlacementEntries, caughtUp, createAppReactorClient, effectiveBackend, findServedDrive, getAppDrives, getConnectPHStore, getIsEmbedded, getRuntimeConfig, isMultiReactorEnabled, isReactorWorkerEnabled, isRuntimeFlagEnabled, keepsLocalCopy, loadLocalPackage, loadRuntimeConfig, needsCopy, placementKeys, planReactorClient, primeRuntimeConfig, refreshAppDrives, relistAppDrives, removeLocalCopies, resolveReactorClientMode, resolveReactorWorkerEnabled, resolveRuntimeFlag, resolveSwitchboardDrives, selectAppReactorClient, servedUrl, servesSlug, switchboardDrives, useBackendAuthGate, useIsEmbedded };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/connect-core",
-  "version": "6.2.3-dev.81",
+  "version": "6.2.3-dev.83",
   "publishConfig": {
     "access": "public"
   },
@@ -73,17 +73,17 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@powerhousedao/host-core": "6.2.3-dev.81",
-    "@powerhousedao/reactor": "6.2.3-dev.81",
-    "@powerhousedao/reactor-browser": "6.2.3-dev.81",
-    "@powerhousedao/reactor-router": "6.2.3-dev.81",
-    "@powerhousedao/shared": "6.2.3-dev.81",
-    "document-model": "6.2.3-dev.81"
+    "@powerhousedao/host-core": "6.2.3-dev.83",
+    "@powerhousedao/reactor": "6.2.3-dev.83",
+    "@powerhousedao/reactor-browser": "6.2.3-dev.83",
+    "@powerhousedao/reactor-router": "6.2.3-dev.83",
+    "@powerhousedao/shared": "6.2.3-dev.83",
+    "document-model": "6.2.3-dev.83"
   },
   "devDependencies": {
     "@electric-sql/pglite": "0.3.15",
     "@playwright/test": "^1.60.0",
-    "@renown/sdk": "6.2.3-dev.81",
+    "@renown/sdk": "6.2.3-dev.83",
     "@tanstack/react-router": "^1.170.41",
     "@tanstack/router-cli": "1.167.40",
     "@tanstack/router-core": "1.171.34",

package/src/runtime/app-reactor-client.ts

@@ -11,6 +11,7 @@ import {
 import type { DocumentDriveDocument } from "@powerhousedao/shared/document-drive";
 import type { ISigner } from "@powerhousedao/shared/document-model";
 import { logger } from "document-model";
+import { switchboardOfDrive } from "@powerhousedao/shared/host-tokens";
 import type * as MultiReactor from "./multi-reactor.js";
 import type {
   LoadedDocumentModels,
@@ -21,6 +22,9 @@ import { resolveReactorClientMode } from "./reactor-client-mode.js";
 import { isReactorWorkerEnabled } from "./reactor-worker-flag.js";
 import { setDriveRelister } from "./drive-relist.js";
 
+// Kept here: multi-reactor.ts is loaded lazily.
+const REMOTE_BACKEND_NAME = "switchboard-remote";
+
 type MultiReactorModule = typeof MultiReactor;
 
 export type AppReactorClientParams = {
@@ -28,7 +32,12 @@ export type AppReactorClientParams = {
   /** Built, and ready (the worker has started up). Undefined in `remote`
    * mode, where no local reactor is built. */
   module: LocalReactorModule | undefined;
+  /** The fallback switchboard when `remoteBackends` is empty. */
   remoteDriveUrl: string | undefined;
+  /** One per switchboard, by host key; `url` is a drive address on it. */
+  remoteBackends?: readonly { name: string; url: string }[];
+  /** Config placements known at build time; later ones go through `setConfiguredPlacement`. */
+  collections?: Readonly<Record<string, string>>;
   /** Signs routed writes; unsigned (anonymous) without one. */
   signer?: ISigner;
   documentModelModules: LoadedDocumentModels;
@@ -91,12 +100,12 @@ export async function createAppReactorClient(
     }
     module = await localReactor(plan);
   }
-  const client = await selectAppReactorClient({
+  const { client, router } = await selectClient({
     ...params,
     mode: plan.mode,
     module,
   });
-  return { plan, module, client };
+  return { plan, module, client, router };
 }
 
 /**
@@ -109,22 +118,32 @@ export async function createAppReactorClient(
 export async function selectAppReactorClient(
   params: AppReactorClientParams,
 ): Promise<IReactorClient> {
+  return (await selectClient(params)).client;
+}
+
+/** The app's client, and the router when it is one. */
+async function selectClient(params: AppReactorClientParams): Promise<{
+  client: IReactorClient;
+  router?: MultiReactor.ConnectRoutingClient;
+}> {
   if (params.mode === "remote") {
     setFullReactorClient(undefined);
     const remote = await buildRemoteOnly(params);
     setFullReactorClient(remote);
-    return remote;
+    return { client: remote, router: remote };
   }
   if (params.mode !== "router") {
     if (getPHStore()?.fullReactorClient) {
       setFullReactorClient(undefined);
     }
-    return requireModule(params).client;
+    return { client: requireModule(params).client };
   }
   setFullReactorClient(undefined);
   const routed = await buildRouter(params);
   setFullReactorClient(routed);
-  return routed ?? requireModule(params).client;
+  return routed
+    ? { client: routed, router: routed }
+    : { client: requireModule(params).client };
 }
 
 function requireModule(params: AppReactorClientParams): LocalReactorModule {
@@ -213,10 +232,37 @@ export async function relistAppDrives(): Promise<void> {
 // The backend auth gate relists through drive-relist (see there)
 setDriveRelister(relistAppDrives);
 
+/** The switchboards to route to: the host's remote backends, else the default drive's. */
+function switchboardRemotes(params: AppReactorClientParams): {
+  remotes: MultiReactor.SwitchboardRemote[];
+  unparsed: string[];
+} {
+  const listed = params.remoteBackends?.length
+    ? params.remoteBackends
+    : params.remoteDriveUrl
+      ? [{ name: REMOTE_BACKEND_NAME, url: params.remoteDriveUrl }]
+      : [];
+  const remotes: MultiReactor.SwitchboardRemote[] = [];
+  const unparsed: string[] = [];
+  for (const { name, url } of listed) {
+    const graphqlUrl = switchboardOfDrive(url)?.graphql;
+    if (graphqlUrl) remotes.push({ name, graphqlUrl });
+    else unparsed.push(url);
+  }
+  return { remotes, unparsed };
+}
+
 async function buildRouter(
   params: AppReactorClientParams,
-): Promise<IReactorClient | undefined> {
-  if (!params.remoteDriveUrl) {
+): Promise<MultiReactor.ConnectRoutingClient | undefined> {
+  const { remotes, unparsed } = switchboardRemotes(params);
+  for (const url of unparsed) {
+    logger.warn(
+      "multiReactor is on but the remote drive URL @url does not parse; skipping it",
+      url,
+    );
+  }
+  if (remotes.length === 0) {
     logger.warn(
       "multiReactor is on but no remote drive URL is configured; using the local reactor only",
     );
@@ -229,20 +275,14 @@ async function buildRouter(
     logger.error("Could not load the multi-reactor router: @error", error);
     return undefined;
   }
-  const remoteGraphqlUrl = multiReactor.deriveSwitchboardGraphqlUrl(
-    params.remoteDriveUrl,
+  logger.info(
+    "Multi-reactor routing to @urls",
+    remotes.map((remote) => remote.graphqlUrl).join(", "),
   );
-  if (!remoteGraphqlUrl) {
-    logger.warn(
-      "multiReactor is on but the remote drive URL @url does not parse; using the local reactor only",
-      params.remoteDriveUrl,
-    );
-    return undefined;
-  }
-  logger.info("Multi-reactor routing to @url", remoteGraphqlUrl);
   return multiReactor.buildMultiReactorClient({
     module: requireModule(params),
-    remoteGraphqlUrl,
+    remotes,
+    collections: params.collections,
     signer: params.signer,
     documentModelModules: params.documentModelModules,
   });
@@ -257,25 +297,27 @@ async function buildRouter(
  */
 async function buildRemoteOnly(
   params: AppReactorClientParams,
-): Promise<IReactorClient> {
-  if (!params.remoteDriveUrl) {
+): Promise<MultiReactor.ConnectRoutingClient> {
+  const { remotes, unparsed } = switchboardRemotes(params);
+  if (unparsed.length > 0) {
     throw new Error(
-      'reactorClient "remote" needs a remote drive URL — declare a remote backend / default drive the client can proxy to',
+      `reactorClient "remote": the remote drive URL "${unparsed[0]}" does not resolve to a Switchboard GraphQL endpoint`,
     );
   }
-  const multiReactor = await (params.loadRouter ?? loadMultiReactor)();
-  const remoteGraphqlUrl = multiReactor.deriveSwitchboardGraphqlUrl(
-    params.remoteDriveUrl,
-  );
-  if (!remoteGraphqlUrl) {
+  if (remotes.length === 0) {
     throw new Error(
-      `reactorClient "remote": the remote drive URL "${params.remoteDriveUrl}" does not resolve to a Switchboard GraphQL endpoint`,
+      'reactorClient "remote" needs a remote drive URL — declare a remote backend / default drive the client can proxy to',
     );
   }
-  logger.info("Remote reactor client → @url", remoteGraphqlUrl);
+  const multiReactor = await (params.loadRouter ?? loadMultiReactor)();
+  logger.info(
+    "Remote reactor client → @urls",
+    remotes.map((remote) => remote.graphqlUrl).join(", "),
+  );
   return multiReactor.buildMultiReactorClient({
     module: undefined,
-    remoteGraphqlUrl,
+    remotes,
+    collections: params.collections,
     signer: params.signer,
     documentModelModules: params.documentModelModules,
   });

package/src/runtime/drive-placement.ts

@@ -0,0 +1,210 @@
+import { DriveCollectionId } from "@powerhousedao/reactor";
+import type {
+  PHConnectCollection,
+  PHConnectRemoteBackend,
+  PHConnectRuntimeDefaultDrive,
+} from "@powerhousedao/shared/clis";
+import { switchboardOfDrive } from "@powerhousedao/shared/host-tokens";
+import { logger } from "document-model";
+
+/** The router backend of the reactor in this browser. */
+export const LOCAL_BACKEND_NAME = "connect-local";
+
+/** A drive the host keeps on a switchboard, and where its config opens it. */
+export type SwitchboardDrive = {
+  /** The host's name for it: its address's slug, or a collection's key. */
+  slug: string;
+  url: string;
+  /** The switchboard's backend. */
+  remote: string;
+  /** `remote` (no copy here) or `LOCAL_BACKEND_NAME` (a synced copy). */
+  configured: string;
+  /** Not a default drive: its address may not be the one it is served at. */
+  collection: boolean;
+};
+
+/** A switchboard drive with the names callers reach it by. */
+export type ResolvedSwitchboardDrive = SwitchboardDrive & {
+  id?: string;
+  servedSlug?: string;
+};
+
+/** A drive this browser moved away from its host config. */
+export type PlacementEntry = {
+  slug: string;
+  backend: string;
+  configWas: string;
+};
+
+type PlacementConfig = {
+  drives?: { defaultDrives?: readonly PHConnectRuntimeDefaultDrive[] };
+  instance?: {
+    remoteBackends?: readonly PHConnectRemoteBackend[];
+    collections?: Record<string, PHConnectCollection>;
+  };
+};
+
+export function keepsLocalCopy(drive: PHConnectRuntimeDefaultDrive): boolean {
+  return !("url" in drive) || drive.sync !== false;
+}
+
+/** Remote default drives with a backend, then collections. */
+export function switchboardDrives(config: PlacementConfig): SwitchboardDrive[] {
+  const drives: SwitchboardDrive[] = [];
+  for (const drive of config.drives?.defaultDrives ?? []) {
+    if (!("url" in drive) || !drive.backend) continue;
+    const slug = switchboardOfDrive(drive.url)?.slug;
+    if (slug === undefined) continue;
+    drives.push({
+      slug,
+      url: drive.url,
+      remote: drive.backend,
+      configured: drive.sync === false ? drive.backend : LOCAL_BACKEND_NAME,
+      collection: false,
+    });
+  }
+  const remotes = config.instance?.remoteBackends ?? [];
+  for (const [slug, entry] of Object.entries(
+    config.instance?.collections ?? {},
+  )) {
+    const remote = remotes.find((r) => r.name === entry.backend);
+    const base = remote && switchboardOfDrive(remote.url)?.base;
+    if (!base || drives.some((drive) => drive.slug === slug)) continue;
+    drives.push({
+      slug,
+      url: `${base}/d/${encodeURIComponent(slug)}`,
+      remote: entry.backend,
+      configured: entry.sync === false ? entry.backend : LOCAL_BACKEND_NAME,
+      collection: true,
+    });
+  }
+  return drives;
+}
+
+/** Stale: no such drive, a backend it can't open on, back to config, or a changed config value. */
+export function applyPlacementEntries(
+  drives: readonly SwitchboardDrive[],
+  entries: readonly PlacementEntry[],
+): { applied: PlacementEntry[]; stale: PlacementEntry[] } {
+  const applied: PlacementEntry[] = [];
+  const stale: PlacementEntry[] = [];
+  for (const entry of entries) {
+    const drive = drives.find((d) => d.slug === entry.slug);
+    const holds =
+      drive !== undefined &&
+      entry.configWas === drive.configured &&
+      entry.backend !== drive.configured &&
+      (entry.backend === drive.remote || entry.backend === LOCAL_BACKEND_NAME);
+    (holds ? applied : stale).push(entry);
+  }
+  return { applied, stale };
+}
+
+/** A served slug names a declared one as is, or hashed (`<slug>-<8 hex>`). */
+export function servesSlug(declared: string, served: string): boolean {
+  return (
+    served === declared ||
+    (served.startsWith(`${declared}-`) &&
+      /^[0-9a-f]{8}$/.test(served.slice(declared.length + 1)))
+  );
+}
+
+type DriveNames = { id: string; slug: string };
+
+function withinDeadline<T>(work: Promise<T>, timeoutMs: number): Promise<T> {
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const deadline = new Promise<never>((_, reject) => {
+    timer = setTimeout(
+      () => reject(new Error(`no answer in ${timeoutMs} ms`)),
+      timeoutMs,
+    );
+  });
+  return Promise.race([work, deadline]).finally(() => clearTimeout(timer));
+}
+
+export type ResolveSwitchboardDrivesOptions = {
+  timeoutMs?: number;
+  /** A collection whose address does not answer: find it among its switchboard's drives. */
+  findServed?: (drive: SwitchboardDrive) => Promise<DriveNames | undefined>;
+};
+
+/** An unreachable drive keeps only the slug in its address. */
+export async function resolveSwitchboardDrives(
+  drives: readonly SwitchboardDrive[],
+  fetchInfo: (url: string) => Promise<DriveNames>,
+  { timeoutMs = 5_000, findServed }: ResolveSwitchboardDrivesOptions = {},
+): Promise<ResolvedSwitchboardDrive[]> {
+  return Promise.all(
+    drives.map(async (drive): Promise<ResolvedSwitchboardDrive> => {
+      try {
+        const { id, slug } = await withinDeadline(
+          fetchInfo(drive.url),
+          timeoutMs,
+        );
+        return { ...drive, id, servedSlug: slug };
+      } catch (error) {
+        if (drive.collection && findServed) {
+          try {
+            const served = await withinDeadline(findServed(drive), timeoutMs);
+            if (served) {
+              return { ...drive, id: served.id, servedSlug: served.slug };
+            }
+          } catch (findError) {
+            logger.warn(
+              "Could not find drive @slug on @remote: @error",
+              drive.slug,
+              drive.remote,
+              findError,
+            );
+          }
+        }
+        logger.warn(
+          "Could not read drive @url; routing it by its address only: @error",
+          drive.url,
+          error,
+        );
+        const slug = switchboardOfDrive(drive.url)?.slug;
+        return slug === undefined ? drive : { ...drive, servedSlug: slug };
+      }
+    }),
+  );
+}
+
+/** The address the drive is served at. */
+export function servedUrl(drive: ResolvedSwitchboardDrive): string {
+  const at = switchboardOfDrive(drive.url);
+  return at && drive.servedSlug && drive.servedSlug !== at.slug
+    ? `${at.base}/d/${encodeURIComponent(drive.servedSlug)}`
+    : drive.url;
+}
+
+/** The keys a placement is installed under: the id and the served slug. */
+export function placementKeys(drive: ResolvedSwitchboardDrive): string[] {
+  return [drive.id, drive.servedSlug].filter(
+    (key): key is string => key !== undefined && key !== "",
+  );
+}
+
+export type SyncRemotes = {
+  list(): readonly {
+    meta: { name: string; collectionId: DriveCollectionId };
+  }[];
+  remove(name: string): Promise<void>;
+};
+
+/** Drops the sync remote of every given drive; its local data is left unread. */
+export async function removeLocalCopies(
+  sync: SyncRemotes,
+  resolved: readonly { id?: string }[],
+): Promise<void> {
+  for (const drive of resolved) {
+    if (!drive.id) continue;
+    const collectionId = DriveCollectionId.forDrive(drive.id);
+    const remotes = sync
+      .list()
+      .filter((remote) => remote.meta.collectionId.equals(collectionId));
+    for (const remote of remotes) {
+      await sync.remove(remote.meta.name);
+    }
+  }
+}