Skip to content

docs(specs): add the popup transport specification - #26

Closed
Wondertan wants to merge 1 commit into
docs/popup-connection-architecturefrom
spec/popup-transport
Closed

Wondertan wants to merge 1 commit into
docs/popup-connection-architecturefrom
spec/popup-transport

Conversation

@Wondertan

Copy link
Copy Markdown
Member

Promotes the protocol-facing contract of the popup connection out of the @libid/popup implementation docs into a normative chapter that browser protocols can cite instead of restating opener, isolation, and continuity mechanics. Carrier wire formats, the port keeper, WebRTC, diagnostics, and the API stay with the implementation.

Rendered entry points:

Stacked on #22; the provenance table links into its package docs. Implementation in #25.

https://claude.ai/code/session_012SVAaP3Z7Haz18WJBjCZAw

Extract the protocol-facing contract of the popup connection from the
@libid/popup implementation documents into a normative chapter: endpoint
identity and admission, the message model, delivery guarantees, lifecycle
and control, continuity across popup-document replacement, and failure
semantics, with assumptions, security properties, conformance vectors,
and a provenance table back to the implementation sections. Carrier wire
formats, the keeper, WebRTC, diagnostics, and the API stay with the
implementation, which is not an interoperability boundary today.

Assisted-by: Claude Fable 5.1
Claude-Session: https://claude.ai/code/session_012SVAaP3Z7Haz18WJBjCZAw
Signed-off-by: Wondertan <hlibwondertan@gmail.com>
@Wondertan Wondertan closed this Sep 3, 2026
@Wondertan
Wondertan deleted the spec/popup-transport branch September 3, 2026 15:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant