[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_228":-5,"_231":232,"_233":234},"routes/shell",{"_40":41,"_227":-5,"_228":-5,"_229":230},"routes/repo",{"_33":-7,"_34":35,"_36":37,"_38":39,"_40":41,"_42":31,"_43":31,"_44":31,"_45":31,"_46":31,"_47":31,"_48":49,"_50":49,"_51":31,"_52":-7,"_53":-7,"_54":55,"_56":57,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68},"routes/repo.blob",{"_13":14,"_15":16,"_17":18,"_19":20,"_21":14,"_22":23,"_24":-5,"_25":26,"_27":28,"_28":29,"_30":31,"_32":14},"ref","88add35cbcbc5c6e2fc2ccf5cf3de9aced8ea77f","path","apps/web/src/wire.ts","oid","cf058cf5d36ee1e04485aaf573568a932ffd4dde","size",10871,"commit","mounts",[],"source","plain",{"_13":14,"_15":16},"kind","text","/**\n * The client end of the wire.\n *\n * Three verbs, because that is all anything needs: `on` to watch a kind, `send`\n * to say something, `ask` to say something and be answered. Replies correlate\n * by `rid`, so a request does not need its own reply kind and two requests of\n * the same kind cannot be confused for one another.\n *\n * The URL is derived from `location`, never configured. That is what makes the\n * same build work on localhost, over a LAN address, and through a tunnel.\n */\n\nexport type Status =\n\t| \"connecting\"\n\t| \"connected\"\n\t| \"reconnecting\"\n\t| \"denied\"\n\t| \"deleted\"\n\t| \"closed\";\n\nexport type Unsubscribe = () => void;\n\ntype Frame = { kind: string; ts: number; rid?: string; sender?: string };\n\ntype Listener = (frame: never) => void;\n\ntype Pending = {\n\tresolve: (frame: never) => void;\n\treject: (error: Error) => void;\n};\n\nexport type WireOptions = {\n\tchannelId: string;\n\tonStatus?: (status: Status, reason?: string) => void;\n\tonAuthenticationRequired?: () => void;\n\tonDeleted?: () => void;\n};\n\ntype Refusal = { reason: string; authentication: boolean };\n\nconst BASE_DELAY = 500;\nconst MAX_DELAY = 15_000;\n/** The least time between attempts that a wake may start. */\nconst WAKE_GAP = 1000;\n/**\n * When, after a loss, one attempt is guaranteed to start.\n *\n * Just inside the 1.5 s grace the page waits out before saying anything\n * (`CONNECTION_GRACE` in the editor), so a short outage reconnects before it\n * is shown rather than flashing a notice, and a lock, for a moment past it.\n */\nconst RESCUE_AT = 1200;\n\nfunction endpoint(options: WireOptions): string {\n\tlet url = new URL(\"/ws\", location.href);\n\turl.protocol = location.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n\turl.searchParams.set(\"channel\", options.channelId);\n\treturn url.href;\n}\n\nfunction rid(): string {\n\treturn crypto.randomUUID().slice(0, 8);\n}\n\nexport class Wire {\n\t#options: WireOptions;\n\t#socket: WebSocket | undefined;\n\t#listeners = new Map>();\n\t#pending = new Map();\n\t#attempts = 0;\n\t#attemptedAt = 0;\n\t/** When the current outage began, or undefined while connected. */\n\t#lostAt: number | undefined;\n\t#timer: ReturnType | undefined;\n\t/**\n\t * Undefined until the first transition, so the first one always announces.\n\t *\n\t * Started at `\"connecting\"` this would swallow its own opening state, and a\n\t * caller sharing one status across instances — React mounting, discarding\n\t * and remounting is exactly this — would keep displaying the dead\n\t * instance's last word until the new one happened to reach a different\n\t * state. A socket that never opens then reports the previous socket's\n\t * closure forever.\n\t */\n\t#status: Status | undefined;\n\t#everConnected = false;\n\t#disposed = false;\n\t#terminal = false;\n\t#connectionGeneration = 0;\n\n\tconstructor(options: WireOptions) {\n\t\tthis.#options = options;\n\t\taddEventListener(\"online\", this.#wake);\n\t\taddEventListener(\"focus\", this.#wake);\n\t\tglobalThis.document?.addEventListener(\"visibilitychange\", this.#wake);\n\t\tthis.#connect();\n\t}\n\n\t/**\n\t * Skip the rest of the backoff when the network or the person comes back.\n\t *\n\t * The timer alone can sit out most of its 15 s cap after the network has\n\t * already returned, with the page still saying it is offline. Only a wire\n\t * waiting on that timer is woken; an attempt already in flight is left to\n\t * finish.\n\t *\n\t * Focus and visibility say only that the person is back, not the network,\n\t * and they can fire in bursts. So they never wake the wire sooner than\n\t * `WAKE_GAP` after the last attempt, and only `online` forgets the\n\t * backoff: a deploy outage must not turn every tab switch on every client\n\t * into a fresh run of fast retries.\n\t */\n\t#wake = (event: Event) => {\n\t\tif (this.#disposed || this.#terminal || this.#timer === undefined) return;\n\t\tif (globalThis.document?.visibilityState === \"hidden\") return;\n\t\tlet online = event.type === \"online\";\n\t\tif (!online && Date.now() - this.#attemptedAt < WAKE_GAP) return;\n\t\tclearTimeout(this.#timer);\n\t\tthis.#timer = undefined;\n\t\tif (online) this.#attempts = 0;\n\t\tthis.#connect();\n\t};\n\n\t#unlisten(): void {\n\t\tremoveEventListener(\"online\", this.#wake);\n\t\tremoveEventListener(\"focus\", this.#wake);\n\t\tglobalThis.document?.removeEventListener(\"visibilitychange\", this.#wake);\n\t}\n\n\tget status(): Status {\n\t\treturn this.#status ?? \"connecting\";\n\t}\n\n\t/**\n\t * Whether a request can be carried right now.\n\t *\n\t * Not the same as the reported status: `connected` is published from the\n\t * socket's open event, and a caller may be asking before that has run.\n\t * This reads the socket itself, which is what `ask` will do a moment later.\n\t */\n\tget connected(): boolean {\n\t\treturn this.#socket?.readyState === WebSocket.OPEN;\n\t}\n\n\t/**\n\t * Try again now, at a person's request.\n\t *\n\t * The backoff starts over: someone who asks to reconnect is saying the\n\t * network may be back, and after a few failed asks the next automatic\n\t * attempt must not still be waiting out the cap.\n\t */\n\treconnect(): void {\n\t\tif (this.#disposed || this.#terminal) return;\n\t\tclearTimeout(this.#timer);\n\t\tthis.#timer = undefined;\n\t\tthis.#attempts = 0;\n\t\tlet previous = this.#socket;\n\t\tthis.#socket = undefined;\n\t\tthis.#abandon(\"connection restarted\");\n\t\tprevious?.close();\n\t\tthis.#connect();\n\t}\n\n\t#set(status: Status, reason?: string): void {\n\t\tif (this.#status === status) return;\n\t\tthis.#status = status;\n\t\tthis.#options.onStatus?.(status, reason);\n\t}\n\n\t#connect(): void {\n\t\tif (this.#disposed || this.#terminal) return;\n\t\tthis.#connectionGeneration++;\n\t\tthis.#attemptedAt = Date.now();\n\t\tthis.#set(this.#everConnected ? \"reconnecting\" : \"connecting\");\n\n\t\tlet socket = new WebSocket(endpoint(this.#options));\n\t\tthis.#socket = socket;\n\n\t\tsocket.addEventListener(\"open\", () => {\n\t\t\tif (this.#socket !== socket) return;\n\t\t\tthis.#everConnected = true;\n\t\t\tthis.#attempts = 0;\n\t\t\tthis.#lostAt = undefined;\n\t\t\tthis.#set(\"connected\");\n\t\t});\n\n\t\tsocket.addEventListener(\"message\", event => {\n\t\t\tif (this.#socket !== socket) return;\n\t\t\tif (typeof event.data !== \"string\") return;\n\t\t\tthis.#receive(event.data);\n\t\t});\n\n\t\tsocket.addEventListener(\"close\", event => {\n\t\t\t// A socket superseded by a reconnect must not drive status or retries.\n\t\t\tif (this.#socket !== socket) return;\n\t\t\tthis.#socket = undefined;\n\t\t\tif (event.code === 4404) {\n\t\t\t\tthis.#deleted();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthis.#lostAt ??= Date.now();\n\t\t\tthis.#abandon(\"connection lost\");\n\t\t\tvoid this.#retry();\n\t\t});\n\t}\n\n\t/**\n\t * Work out why a connection attempt was refused.\n\t *\n\t * A browser cannot see the status of a failed upgrade — a rejected access\n\t * key and an unreachable server both surface as a bare close. The endpoint\n\t * answers an ordinary request with the reason, so ask it once rather than\n\t * retrying eight times against a door that will not open.\n\t */\n\tasync #refusal(): Promise {\n\t\ttry {\n\t\t\tlet response = await fetch(endpoint(this.#options).replace(/^ws/, \"http\"), {\n\t\t\t\theaders: { \"x-chopin-socket-probe\": \"1\" },\n\t\t\t});\n\t\t\tif (response.status >= 400 && response.status < 500) {\n\t\t\t\treturn {\n\t\t\t\t\treason: await response.text(),\n\t\t\t\t\tauthentication: response.status === 401,\n\t\t\t\t};\n\t\t\t}\n\t\t} catch {\n\t\t\t// Unreachable rather than refused; the retry loop is the right answer.\n\t\t}\n\t\treturn undefined;\n\t}\n\n\tasync #retry(): Promise {\n\t\tif (this.#disposed || this.#terminal) return;\n\t\tlet generation = this.#connectionGeneration;\n\n\t\tlet refusal = await this.#refusal();\n\t\tif (this.#disposed || this.#terminal || generation !== this.#connectionGeneration) return;\n\t\tif (refusal) {\n\t\t\tif (refusal.authentication) this.#options.onAuthenticationRequired?.();\n\t\t\treturn this.#set(\"denied\", refusal.reason);\n\t\t}\n\n\t\tlet delay = Math.min(BASE_DELAY * 2 ** this.#attempts, MAX_DELAY) * (0.5 + Math.random());\n\t\tif (this.#lostAt !== undefined) {\n\t\t\tlet rescue = this.#lostAt + RESCUE_AT - Date.now();\n\t\t\tif (rescue > 0) delay = Math.min(delay, rescue);\n\t\t}\n\t\tthis.#attempts++;\n\t\tthis.#set(\"reconnecting\");\n\t\tthis.#timer = setTimeout(() => {\n\t\t\tthis.#timer = undefined;\n\t\t\tthis.#connect();\n\t\t}, delay);\n\t}\n\n\t#receive(raw: string): void {\n\t\tlet frame: Frame;\n\t\ttry {\n\t\t\tframe = JSON.parse(raw) as Frame;\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\n\t\tif (frame.rid) {\n\t\t\tlet waiting = this.#pending.get(frame.rid);\n\t\t\tif (waiting) {\n\t\t\t\tthis.#pending.delete(frame.rid);\n\t\t\t\tif (frame.kind === \"session:error\") {\n\t\t\t\t\twaiting.reject(new Error(String((frame as { message?: string }).message)));\n\t\t\t\t} else {\n\t\t\t\t\twaiting.resolve(frame as never);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t/*\n\t\t * One listener at a time.\n\t\t *\n\t\t * Frames are fanned out in a loop, so without this the first handler to\n\t\t * throw silences every handler registered after it for that kind — the\n\t\t * same failure Lexical's update listeners have, and just as quiet. A\n\t\t * broken sidecar must not stop the transcript from arriving.\n\t\t */\n\t\tfor (let listener of this.#listeners.get(frame.kind) ?? []) {\n\t\t\ttry {\n\t\t\t\tlistener(frame as never);\n\t\t\t} catch (err) {\n\t\t\t\tconsole.error(`[wire] ${frame.kind} listener failed:`, err);\n\t\t\t}\n\t\t}\n\t\tif (frame.kind === \"session:deleted\") this.#deleted();\n\t}\n\n\t#deleted(): void {\n\t\tif (this.#disposed || this.#terminal) return;\n\t\tthis.#terminal = true;\n\t\tthis.#unlisten();\n\t\tif (this.#timer) clearTimeout(this.#timer);\n\t\tthis.#timer = undefined;\n\t\tlet socket = this.#socket;\n\t\tthis.#socket = undefined;\n\t\tthis.#abandon(\"document deleted\");\n\t\tthis.#set(\"deleted\", \"document deleted\");\n\t\tsocket?.close();\n\t\tthis.#options.onDeleted?.();\n\t}\n\n\t/** Reject everything still waiting; a reply cannot survive its connection. */\n\t#abandon(reason: string): void {\n\t\tfor (let waiting of this.#pending.values()) waiting.reject(new Error(reason));\n\t\tthis.#pending.clear();\n\t}\n\n\ton(kind: string, listener: (frame: T) => void): Unsubscribe {\n\t\tlet set = this.#listeners.get(kind);\n\t\tif (!set) this.#listeners.set(kind, set = new Set());\n\t\tset.add(listener as Listener);\n\t\treturn () => set.delete(listener as Listener);\n\t}\n\n\tsend(kind: string, payload: Record = {}): void {\n\t\tif (this.#socket?.readyState !== WebSocket.OPEN) return;\n\t\tthis.#socket.send(JSON.stringify({\n\t\t\t...payload,\n\t\t\tkind,\n\t\t\tts: Math.floor(Date.now() / 1000),\n\t\t\trid: rid(),\n\t\t}));\n\t}\n\n\task(kind: string, payload: Record = {}): Promise {\n\t\tif (this.#socket?.readyState !== WebSocket.OPEN) {\n\t\t\treturn Promise.reject(new Error(\"not connected\"));\n\t\t}\n\t\tlet id = rid();\n\t\tlet task = Promise.withResolvers();\n\t\tthis.#pending.set(id, task as unknown as Pending);\n\t\tthis.#socket.send(JSON.stringify({\n\t\t\t...payload,\n\t\t\tkind,\n\t\t\tts: Math.floor(Date.now() / 1000),\n\t\t\trid: id,\n\t\t}));\n\t\treturn task.promise;\n\t}\n\n\tdispose(): void {\n\t\tthis.#disposed = true;\n\t\tthis.#unlisten();\n\t\tif (this.#timer) clearTimeout(this.#timer);\n\t\tthis.#abandon(\"disposed\");\n\t\tthis.#socket?.close();\n\t\tthis.#socket = undefined;\n\t\tif (!this.#terminal) this.#set(\"closed\");\n\t}\n}\n","editable",false,"branch","documentNavigation","repo","githubnext/chopin","repoId","7d1a8ac3-35b0-4dea-85d4-06a980f3bada","ownerId","org:89615882","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers","watching","pinned","notify","views",[183,184,185,186,187,188,189,190,191,192,193,194,195],"navigation",{"_54":55,"_139":140,"_141":142,"_143":144,"_145":146,"_147":148,"_149":150},"sources",[],"viewer","meta",{"_131":132,"_133":134,"_135":136,"_42":31,"_137":126,"_138":31,"_48":49,"_50":49},"branches",[73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130],"tags",[69,70,71,72],"cloneUrl","https://git.nexthub.sh/githubnext/chopin.git","color-controls-slice-1","color-controls-slice-2","color-controls-slice-3","color-controls-slice-4","Krzysztof-Cieslak-patch-1","Krzysztof-Cieslak-patch-2","Maggie/app-preview-toolkit","Maggie/ci-playwright-install-timeout","Maggie/collaborative-visual-decision","Maggie/design-audit","Maggie/generic-visual-decision-runtime","Maggie/impeccable-chopin-metadata","Maggie/jev-chat-product","Maggie/jev-composed-assessment","Maggie/native-document-layouts","Maggie/openui-composition-product","Maggie/openui-composition-trial","Maggie/planner-visual-authoring","Maggie/planner-visual-requests","Maggie/visual-selection-eval","artifacts/pr-419-live-preview-20261009","automation/pr-maintenance-state","automation/use-effect/callout-disabled-picker-8cf9e49ba5c09471","automation/use-effect/collaboration-options-ref-4e3a5a08a879a5ae","automation/use-effect/room-workspace-effective-access-a57d40866c71bed0","chore/bun-1.4.2","color-controls","color-controls-plan","comments","design-pr-assets","design/archived-decisions-badge","design/channel-route-remount","design/chat-decision-entry","design/conversation-analysis-markers","design/decision-evidence","design/settled-line-icon","dev/integration","diagram-step-controls","feat/liveapp-frontend-pilot","feat/local-experiments","feat/local-launcher-tracer","fix/autolink-mdx-crash","github-pills/2-pills","github-pills/3-hover-card","maggie/app-preview-toolkit","maggie/ci-playwright-install-timeout","maggie/collaborative-visual-decision","maggie/design-audit","maggie/generic-visual-decision-runtime","maggie/impeccable-chopin-metadata","maggie/jev-composed-assessment","maggie/native-document-layouts","maggie/openui-composition-product","maggie/openui-composition-trial","maggie/planner-visual-authoring","maggie/planner-visual-requests","maggie/visual-selection-eval","main","plain-text-fence-chrome","tokens/09-copy","wireframes/2-renderer","wireframes/3-planner","description","Let's compose rich plans together","owner","githubnext","section","","head","empty","pins",[165,166,167],"documents",{"_160":161,"_162":163},"code",{"_156":157,"_158":159},"automations",{"_153":154,"_155":-5},"delivery",{"_151":49,"_152":-5},"tag","04zvKQ8QOrDUF8TO1Ovz0Zy8_TT","releases","applications","workflows",3,"deployments","commits",1000,"changes",13,"counts",{"_164":163},"total",11,"issue",{"_168":158,"_170":181,"_15":158,"_172":182,"_52":174,"_175":31,"_176":174,"_177":159},{"_168":178,"_170":179,"_15":178,"_172":180,"_52":174,"_175":31,"_176":174,"_177":49},{"_168":169,"_170":171,"_15":169,"_172":173,"_52":174,"_175":31,"_176":174,"_177":163},"id","issues","name","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_168":158,"_170":181,"_15":158,"_172":226,"_52":174,"_175":31,"_176":174},{"_168":178,"_170":179,"_15":178,"_172":225,"_52":174,"_175":31,"_176":174},{"_168":169,"_170":171,"_15":169,"_172":224,"_52":174,"_175":31,"_176":174},{"_168":221,"_170":222,"_15":221,"_172":223,"_52":31,"_175":31,"_176":174},{"_168":218,"_170":219,"_15":218,"_172":220,"_52":31,"_175":31,"_176":174},{"_168":153,"_170":216,"_15":145,"_172":217,"_52":31,"_175":31,"_176":174},{"_168":155,"_170":213,"_15":214,"_172":215,"_52":31,"_175":31,"_176":174},{"_168":151,"_170":211,"_15":151,"_172":212,"_52":31,"_175":31,"_176":174},{"_168":207,"_170":208,"_15":209,"_172":210,"_52":31,"_175":31,"_176":174},{"_168":141,"_170":205,"_15":141,"_172":206,"_52":31,"_175":31,"_176":31},{"_168":202,"_170":203,"_15":202,"_172":204,"_52":31,"_175":31,"_176":31},{"_168":199,"_170":200,"_15":199,"_172":201,"_52":31,"_175":31,"_176":31},{"_168":196,"_170":197,"_15":196,"_172":198,"_52":31,"_175":31,"_176":31},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794440176563,"sidebar","expanded"]