refactor(discovery): trim bootstrap contract

Author: marcus-pousette

packages/discovery/src/types.ts

@@ -1,26 +1,20 @@
-export type DiscoveryTopology = 'relay' | 'regional-relay' | 'peer-mesh' | 'hybrid';
+export type DiscoveryTopology = 'relay';
 
-export type DiscoveryAttachmentProtocol = 'websocket' | 'https' | 'webrtc-signal';
+export type DiscoveryAttachmentProtocol = 'websocket' | 'https';
 
 export type DiscoveryAttachment = {
   protocol: DiscoveryAttachmentProtocol;
   url: string;
-  role?: 'preferred' | 'durable' | 'relay' | 'bootstrap' | 'signal';
-  label?: string;
+  role?: 'preferred' | 'bootstrap';
 };
 
 /**
- * Attachment plan returned by the discovery/bootstrap control plane.
- *
- * The plan is intentionally provider-neutral. A simple hosted sync service can
- * return one websocket attachment, while more advanced providers may return a
- * hybrid or peer-mesh bootstrap plan later.
+ * Attachment plan returned by the bootstrap layer.
  */
 export type DocAttachmentPlan = {
   topology: DiscoveryTopology;
   attachments: DiscoveryAttachment[];
   cacheTtlMs?: number;
-  routeVersion?: string;
 };
 
 export type ResolveDocRequest = {

packages/sync/server/postgres-node/README.md

@@ -64,7 +64,6 @@ Environment variables:
 - `TREECRDT_DISCOVERY_PUBLIC_HTTP_BASE_URL` (optional absolute base URL advertised to clients)
 - `TREECRDT_DISCOVERY_PUBLIC_WS_BASE_URL` (optional absolute websocket base URL advertised to clients)
 - `TREECRDT_DISCOVERY_CACHE_TTL_MS` (default: `3600000`)
-- `TREECRDT_DISCOVERY_ROUTE_VERSION` (optional opaque cache-busting string)
 
 Health check:
 

packages/sync/server/postgres-node/src/cli.ts

@@ -124,7 +124,6 @@ async function main() {
   const discoveryCacheTtlMs = Number(
     process.env.TREECRDT_DISCOVERY_CACHE_TTL_MS ?? String(60 * 60 * 1000),
   );
-  const discoveryRouteVersion = process.env.TREECRDT_DISCOVERY_ROUTE_VERSION?.trim() || undefined;
   const startedAt = new Date().toISOString();
 
   const backendModule =
@@ -191,7 +190,6 @@ async function main() {
       discoveryPublicHttpBaseUrl,
       discoveryPublicWebSocketBaseUrl,
       discoveryCacheTtlMs,
-      discoveryRouteVersion,
       startedAt,
     });
     const clientHost = clientHostForBindHost(handle.host);

packages/sync/server/postgres-node/src/server.ts

@@ -64,7 +64,6 @@ export type SyncServerOptions = {
   discoveryPublicHttpBaseUrl?: string;
   discoveryPublicWebSocketBaseUrl?: string;
   discoveryCacheTtlMs?: number;
-  discoveryRouteVersion?: string;
   hooks?: WebSocketSyncServerHooks;
 };
 
@@ -722,7 +721,6 @@ export async function startSyncServer(opts: SyncServerOptions): Promise<SyncServ
   );
   const discoveryCacheTtlMs =
     opts.discoveryCacheTtlMs == null ? 60 * 60 * 1000 : Number(opts.discoveryCacheTtlMs);
-  const discoveryRouteVersion = opts.discoveryRouteVersion?.trim() || undefined;
 
   if (!Number.isFinite(port) || port <= 0) throw new Error(`invalid port: ${opts.port}`);
   if (maxCodewords != null && (!Number.isFinite(maxCodewords) || maxCodewords <= 0)) {
@@ -889,7 +887,6 @@ export async function startSyncServer(opts: SyncServerOptions): Promise<SyncServ
                   },
                 ],
                 cacheTtlMs: discoveryCacheTtlMs,
-                ...(discoveryRouteVersion ? { routeVersion: discoveryRouteVersion } : {}),
               },
             },
           };
@@ -940,7 +937,6 @@ export async function startSyncServer(opts: SyncServerOptions): Promise<SyncServ
             discoveryPublicHttpBaseUrl: discoveryPublicHttpBaseUrl ?? null,
             discoveryPublicWebSocketBaseUrl: discoveryPublicWebSocketBaseUrl ?? null,
             discoveryCacheTtlMs,
-            discoveryRouteVersion: discoveryRouteVersion ?? null,
           };
         },
       });