Sterister
594992a183
Adds the bridge-connection-lifecycle signal that closes Prism's
~45s revoke window down to one server→client round-trip (~50ms).
Server (`@shade/inbox-server`):
- `inbox.peer_connected` / `inbox.peer_disconnected` events on the
0↔1 boundary across WS + SSE bridges. Long-poll deliberately not
tracked (every poll boundary would flap; push transports are also
the only ones where instant revoke matters).
- `PresenceTracker` collapses two parallel bridges (e.g. WS + SSE
during fallback handover) into one connect/disconnect pair.
- `GET /v1/bridge/presence` SSE endpoint: signed query with
`kind: 'presence'`, `watched: string[]`; on open streams a
per-address snapshot, then change frames filtered server-side.
MAX_WATCHED_ADDRESSES = 64. Subscribing does not itself count as
a peer-bridge connection.
- `createBridgeRoutes` now returns `{ app, websocket, presence }`.
Client (`@shade/transport-bridge`):
- `PresenceBridge.subscribe({ watch, onPresenceChange })` →
`{ addPeer, removePeer, watching, unsubscribe }`. addPeer/removePeer
mutate via reconnect with a fresh signed query.
- `signPresenceQuery` helper for non-PresenceBridge consumers.
Tests cover all four acceptance criteria from the Prism request:
server-event smoke, online→offline subscription, address scoping
(carol invisible to a [alice]-only sub), reconnect, plus an
addPeer/removePeer regression.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
63 lines
2.2 KiB
TypeScript
63 lines
2.2 KiB
TypeScript
import type { Hono } from 'hono';
|
|
import type { CryptoProvider } from '@shade/core';
|
|
import { createInboxRoutes, type InboxRoutesOptions } from './routes.js';
|
|
import { MemoryInboxStore } from './memory-store.js';
|
|
import type { InboxStore } from './store.js';
|
|
import { InboxServerEvents } from './events.js';
|
|
|
|
export { createInboxRoutes } from './routes.js';
|
|
export type { InboxRoutesOptions } from './routes.js';
|
|
export { MemoryInboxStore } from './memory-store.js';
|
|
export type { InboxStore } from './store.js';
|
|
export {
|
|
InboxServerEvents,
|
|
shortHash as inboxShortHash,
|
|
} from './events.js';
|
|
export type {
|
|
InboxServerEvent,
|
|
InboxServerEventName,
|
|
InboxServerEventMap,
|
|
InboxServerEventListener,
|
|
} from './events.js';
|
|
export { InboxPruneTask } from './cleanup.js';
|
|
export {
|
|
computeMsgId,
|
|
isValidMsgId,
|
|
constantTimeStringEqual,
|
|
} from './msg-id.js';
|
|
export {
|
|
DEFAULT_INBOX_QUOTA,
|
|
clampTtl,
|
|
} from './quota.js';
|
|
export type { InboxQuotaConfig } from './quota.js';
|
|
export { createBridgeRoutes } from './bridge.js';
|
|
export type { BridgeRoutesOptions, BridgeKind } from './bridge.js';
|
|
export { PresenceTracker } from './presence.js';
|
|
export type { TrackedBridgeKind } from './presence.js';
|
|
|
|
/**
|
|
* Create a standalone Shade Inbox Server.
|
|
*
|
|
* const crypto = new SubtleCryptoProvider();
|
|
* const inbox = createInboxServer({ crypto });
|
|
* export default { port: 3901, fetch: inbox.fetch };
|
|
*
|
|
* Or compose into an existing Hono app:
|
|
* const app = new Hono();
|
|
* app.route('/', createInboxServer({ crypto }));
|
|
*/
|
|
export function createInboxServer(options: {
|
|
crypto: CryptoProvider;
|
|
store?: InboxStore;
|
|
disableRateLimit?: boolean;
|
|
events?: InboxServerEvents;
|
|
} & Pick<InboxRoutesOptions, 'observability' | 'quota'>): Hono {
|
|
const store = options.store ?? new MemoryInboxStore();
|
|
const routesOptions: InboxRoutesOptions = {};
|
|
if (options.disableRateLimit !== undefined) routesOptions.disableRateLimit = options.disableRateLimit;
|
|
if (options.events !== undefined) routesOptions.events = options.events;
|
|
if (options.observability !== undefined) routesOptions.observability = options.observability;
|
|
if (options.quota !== undefined) routesOptions.quota = options.quota;
|
|
return createInboxRoutes(store, options.crypto, routesOptions);
|
|
}
|