+1 -1

.env.example

··· 15 15 # APPVIEW_DID=did:web:api.bsky.app 16 16 17 17 # Optional: Relay for firehose 18 18 - # RELAY_HOST=https://bsky.network 18 18 + # RELAY_URL=https://bsky.network 19 19 20 20 # Cloudflare-specific (not needed for Node.js) 21 21 # CLOUDFLARE_API_TOKEN=your_api_token_here

+1 -1

README.md

··· 51 51 | HOSTNAME | No | Public hostname for the PDS | 52 52 | APPVIEW_URL | No | AppView URL for proxying | 53 53 | APPVIEW_DID | No | AppView DID for service auth | 54 54 - | RELAY_HOST | No | Relay URL for firehose notifications | 54 54 + | RELAY_URL | No | Relay URL for firehose notifications | 55 55 56 56 ## Deploy: Node.js 57 57

+3 -3

docs/plans/2026-01-11-e2e-local-relay-integration.md

··· 4 4 5 5 **Goal:** Integrate local PLC and relay from docker-compose into e2e tests for debugging sync issues and comprehensive federation testing. 6 6 7 7 - **Architecture:** Tests use a hybrid docker management approach - check if services are running, start them if not, reset volumes for clean state. The Node.js PDS is configured with `relayHost` to notify the local relay after commits. New test suite verifies events flow through the relay correctly. 7 7 + **Architecture:** Tests use a hybrid docker management approach - check if services are running, start them if not, reset volumes for clean state. The Node.js PDS is configured with `relayUrl` to notify the local relay after commits. New test suite verifies events flow through the relay correctly. 8 8 9 9 **Tech Stack:** Docker Compose, Vitest, Node.js `child_process` for docker management, WebSocket for firehose tests. 10 10 ··· 175 175 **Files:** 176 176 - Modify: `test/helpers/node-server.js` 177 177 178 178 - **Step 1: Add USE_LOCAL_INFRA constant and relayHost config** 178 178 + **Step 1: Add USE_LOCAL_INFRA constant and relayUrl config** 179 179 180 180 Replace the entire file with: 181 181 ··· 206 206 hostname: USE_LOCAL_INFRA ? 'host.docker.internal:3000' : `localhost:${TEST_PORT}`, 207 207 password: 'test-password', 208 208 // Use local relay when docker infrastructure is available 209 209 - relayHost: USE_LOCAL_INFRA ? 'localhost:2470' : undefined, 209 209 + relayUrl: USE_LOCAL_INFRA ? 'localhost:2470' : undefined, 210 210 // Keep appview pointing to production (for proxy tests) 211 211 appviewUrl: 'https://api.bsky.app', 212 212 appviewDid: 'did:web:api.bsky.app',

+5 -5

docs/plans/2026-01-11-subscribe-repos-websocket.md

··· 61 61 hostname, 62 62 appviewUrl, 63 63 appviewDid, 64 64 - relayHost, 64 64 + relayUrl, 65 65 password, 66 66 webSocket, // Add this 67 67 }) { ··· 71 71 this.hostname = hostname; 72 72 this.appviewUrl = appviewUrl || BSKY_APPVIEW_URL; 73 73 this.appviewDid = appviewDid; 74 74 - this.relayHost = relayHost; 74 74 + this.relayUrl = relayUrl; 75 75 this.password = password; 76 76 this.webSocket = webSocket; // Add this 77 77 this.lastCrawlNotify = 0; ··· 253 253 hostname: env.HOSTNAME, 254 254 appviewUrl: env.APPVIEW_URL, 255 255 appviewDid: env.APPVIEW_DID, 256 256 - relayHost: env.RELAY_HOST, 256 256 + relayUrl: env.RELAY_URL, 257 257 password: env.PDS_PASSWORD, 258 258 }); 259 259 } ··· 339 339 hostname, 340 340 appviewUrl, 341 341 appviewDid, 342 342 - relayHost, 342 342 + relayUrl, 343 343 password, 344 344 }) { 345 345 const Database = (await import('better-sqlite3')).default; ··· 361 361 hostname, 362 362 appviewUrl, 363 363 appviewDid, 364 364 - relayHost, 364 364 + relayUrl, 365 365 password, 366 366 }); 367 367

+1 -1

examples/node/.env.example

··· 12 12 # APPVIEW_DID=did:web:api.bsky.app 13 13 14 14 # Optional: Relay for firehose 15 15 - # RELAY_HOST=wss://bsky.network 15 15 + # RELAY_URL=wss://bsky.network 16 16 17 17 # Optional: Password for createSession 18 18 # PDS_PASSWORD=