Skip to content

docs: sync package docs to sdk.host.getBridgeAddress - #21

Merged
MattDHill merged 1 commit into
masterfrom
docs/sync-bridge-address
Jul 25, 2026
Merged

docs: sync package docs to sdk.host.getBridgeAddress#21
MattDHill merged 1 commit into
masterfrom
docs/sync-bridge-address

Conversation

@MattDHill

Copy link
Copy Markdown
Member

Why

Follow-up to the sdk.host.getBridgeAddress adoption, which left this package's docs describing code it no longer has.

The prose still referenced the local bridgeAddress helper that was deleted, and in several packages went further — asserting that resolution "reads net.assignedPort" and uses "never addressInfo hostnames". That is the opposite of what sdk.host.getBridgeAddress does: it resolves the binding's own derived address, which is addressInfo-derived, precisely so it stays correct whichever port field the dependency populates.

Leaving that in place would have taught the next reader the pattern the change removed.

What changed

  • Doc prose re-pointed at sdk.host.getBridgeAddress, and any description of the old internals corrected.
  • Imports left dead by the helper's removal dropped — an unused import { sdk } (tsc does not flag unused imports, which is how these survived) and, in a few packages, an import {} from './utils' left with empty braces.

No behaviour change; docs and dead code only.

Verification

tsc and prettier clean.

🤖 Generated with Claude Code

The docs still described the local helper this package no longer has, and
in places asserted its internals — reading `net.assignedPort`, "never
`addressInfo` hostnames" — which is the opposite of what
`sdk.host.getBridgeAddress` does. Also drops imports left dead by the
helper's removal.

@helix-nine helix-nine left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docs-and-dead-code only. Corrects prose that still described the removed local helper — and in places asserted its internals, which the SDK helper does not do.

@MattDHill
MattDHill merged commit 47b763e into master Jul 25, 2026
3 checks passed
@MattDHill
MattDHill deleted the docs/sync-bridge-address branch July 25, 2026 04:30
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.

2 participants