Block a user
@shade/transport-bridge (4.1.0)
Published 2026-05-03 22:08:31 +02:00 by Stian
Installation
@shade:registry=npm install @shade/transport-bridge@4.1.0"@shade/transport-bridge": "4.1.0"About this package
@shade/transport-bridge
Transport-agnostic delivery for Shade: WS → SSE → long-poll, in priority
order, behind a single IncomingMessage interface.
import {
FallbackBridgeTransport,
WsBridge,
SseBridge,
LongPollBridge,
} from '@shade/transport-bridge';
const auth = { crypto, signingPrivateKey, address: 'bob' };
const bridge = new FallbackBridgeTransport([
new WsBridge({ baseUrl, auth }),
new SseBridge({ baseUrl, auth }),
new LongPollBridge({ baseUrl, auth }),
]);
await bridge.connect({
onMessage: (msg) => {
// msg: { from: string; bytes: Uint8Array; receivedAt: number; msgId?: string }
},
});
console.log(bridge.activeKind); // "ws" | "sse" | "long-poll"
Pair with createBridgeRoutes in @shade/inbox-server to expose the
matching /v1/bridge/{stream,poll,ws} endpoints. Full design + threat
model in docs/transport.md.
What it solves
Browser extensions, strict corporate proxies, and edge runtimes routinely block long-lived WebSockets. Apps that already use the Shade inbox shouldn't have to write three custom delivery paths to handle the realistic mix of hostile networks they ship into. This package is the canonical answer.
Status
V3.7. Stable wire format, additive change to @shade/inbox-server. See
CHANGELOG.
Dependencies
Dependencies
| ID | Version |
|---|---|
| @shade/core | ^4.1.0 |
| @shade/server | ^4.1.0 |
Development Dependencies
| ID | Version |
|---|---|
| @shade/crypto-web | workspace:* |
| @shade/inbox-server | workspace:* |
| hono | ^4.12.12 |
Peer Dependencies
| ID | Version |
|---|---|
| hono | ^4 |
Optional Dependencies
| ID | Version |
|---|---|
| @shade/inbox-server | ^4.1.0 |