Skip to content

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

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

MattDHill merged 1 commit into
masterfrom
docs/sync-bridge-address

Conversation

@helix-a

@helix-a helix-a commented Jul 25, 2026 •

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.

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.

@MattDHill MattDHill left a comment

Copy link
Copy Markdown
Member

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 6ab1b02 into master Jul 25, 2026
3 checks passed
@MattDHill
MattDHill deleted the docs/sync-bridge-address branch July 25, 2026 04:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants