onelobby 0.4.1 → 0.6.0

package/dist/index.d.ts

@@ -4,9 +4,11 @@
  * WebRTC/signaling classes, clocks, the gridpaint demo game) live in `onelobby/internals`.
  */
 export { OneLobby, LIB_NAME, LIB_VERSION } from "./onelobby.js";
-export type { OneLobbyOptions, HostOptions, ListOptions, OneLobbyEvents, JoinDirectOptions } from "./onelobby.js";
+export type { OneLobbyOptions, FromConfigOverrides, HostOptions, ListOptions, OneLobbyEvents, JoinDirectOptions } from "./onelobby.js";
 export { DEFAULT_READY_TIMEOUT_MS } from "./onelobby.js";
 export type { AdvancedOptions, SeatStorage } from "./onelobby.js";
+export { parseBlueprint, defineBlueprint, BlueprintError } from "./blueprint.js";
+export type { Blueprint, BlueprintInput, BlueprintEngine } from "./blueprint.js";
 export { Lobby } from "./lobby.js";
 export type { LobbyEvents, LobbyConfig, Peer, Phase, RateLimit } from "./lobby.js";
 export { MIN_PEER_TIMEOUT_MS } from "./lobby.js";
@@ -15,6 +17,8 @@ export type { LobbySocket, LobbySocketOptions } from "./socket.js";
 export { Lockstep } from "./lockstep.js";
 export type { Frame, DesyncInfo, LockstepEvents } from "./lockstep.js";
 export { Chat, CHAT_MAX_BYTES } from "./chat.js";
+export { Pause } from "./pause.js";
+export type { PauseState, PauseEvents, PauseMode, PauseRefusal } from "./pause.js";
 export type { ChatMessage, ChatEvents } from "./chat.js";
 export { Voice } from "./voice.js";
 export type { VoiceEvents, VoiceDeps } from "./voice.js";
@@ -29,7 +33,11 @@ export { OneLobbyError } from "./signaling.js";
 export type { LobbySummary, LobbyState, PeerInfo } from "./signaling.js";
 export type { PeerLink, LinkFactory, SocketFactory, SocketLike, IceServer, ChannelName } from "./transport.js";
 export type { Clock } from "./clock.js";
-export { describeError, shareUrl, codeFromUrl, ErrorCodes } from "./friendly.js";
-export type { FriendlyError, ErrorCode } from "./friendly.js";
+export { describeError, shareUrl, codeFromUrl, directJoinInfo, ErrorCodes } from "./friendly.js";
+export type { FriendlyError, ErrorCode, JoinInfo } from "./friendly.js";
 export { Keepalive, KeepaliveError } from "./deprecated.js";
 export type { KeepaliveOptions, KeepaliveEvents } from "./deprecated.js";
+export { checkNostrRelays, DEFAULT_NOSTR_RELAYS, DEFAULT_NOSTR_STUN } from "./nostr/relays.js";
+export type { RelayCheck, RelayConnect } from "./nostr/relays.js";
+export { encodeRoomCode } from "./joincode.js";
+export type { BrowserHostOptions, VisibilityDoc } from "./direct/browser-host.js";

package/dist/index.js

@@ -5,21 +5,27 @@
  */
 export { OneLobby, LIB_NAME, LIB_VERSION } from "./onelobby.js";
 export { DEFAULT_READY_TIMEOUT_MS } from "./onelobby.js";
+// Blueprint v1: onelobby.json (docs/design/blueprint.md). OneLobby.fromConfig(json) builds a kit from it.
+export { parseBlueprint, defineBlueprint, BlueprintError } from "./blueprint.js";
 export { Lobby } from "./lobby.js";
 export { MIN_PEER_TIMEOUT_MS } from "./lobby.js";
 // WebSocket-shaped sockets over a lobby: lobby.asWebSocket() (joiner), lobby.onConnection(conn => ...) (host).
 export { closeCodeFor } from "./socket.js";
 export { Lockstep } from "./lockstep.js";
 export { Chat, CHAT_MAX_BYTES } from "./chat.js";
+export { Pause } from "./pause.js";
 export { Voice } from "./voice.js";
 export { webCodecsOpusAvailable } from "./voice-browser.js";
 export { normalizeCode, formatCode } from "./crockford.js";
-// Direct IP (docs/direct-ip.md): kit.joinDirect(code); the code is the host's address in disguise. Hosting is in
+// Direct IP (docs/design/direct-ip.md): kit.joinDirect(code); the code is the host's address in disguise. Hosting is in
 // onelobby/direct (Node). webRtcLinkFactoryFor gives Node joiners a WebRTC stack (node-datachannel/polyfill).
 export { decodeJoinCode, looksLikeJoinCode } from "./joincode.js";
 export { webRtcLinkFactoryFor } from "./webrtc.js";
 export { OneLobbyError } from "./signaling.js";
-export { describeError, shareUrl, codeFromUrl, ErrorCodes } from "./friendly.js";
+export { describeError, shareUrl, codeFromUrl, directJoinInfo, ErrorCodes } from "./friendly.js";
 // Pre-rename names, kept for one version so existing games keep working.
 export { Keepalive, KeepaliveError } from "./deprecated.js";
+// Nostr signaling for direct hosts (spec/nostr-signaling.md): relay probe for picking hosting.nostrRelays.
+export { checkNostrRelays, DEFAULT_NOSTR_RELAYS, DEFAULT_NOSTR_STUN } from "./nostr/relays.js";
+export { encodeRoomCode } from "./joincode.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,+GAA+G;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,iHAAiH;AACjH,8GAA8G;AAC9G,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAK/C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEjF,yEAAyE;AACzE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["/**\n * Public API of `onelobby`: create a `OneLobby`, `host()` / `join(code)` / `list()` lobbies, then use the\n * `Lobby`'s lockstep, raw messages, chat and voice. Lower-level pieces (codec, chunking, migration, jitter buffer,\n * WebRTC/signaling classes, clocks, the gridpaint demo game) live in `onelobby/internals`.\n */\nexport { OneLobby, LIB_NAME, LIB_VERSION } from \"./onelobby.js\";\nexport type { OneLobbyOptions, HostOptions, ListOptions, OneLobbyEvents, JoinDirectOptions } from \"./onelobby.js\";\nexport { DEFAULT_READY_TIMEOUT_MS } from \"./onelobby.js\";\nexport type { AdvancedOptions, SeatStorage } from \"./onelobby.js\";\nexport { Lobby } from \"./lobby.js\";\nexport type { LobbyEvents, LobbyConfig, Peer, Phase, RateLimit } from \"./lobby.js\";\nexport { MIN_PEER_TIMEOUT_MS } from \"./lobby.js\";\n// WebSocket-shaped sockets over a lobby: lobby.asWebSocket() (joiner), lobby.onConnection(conn => ...) (host).\nexport { closeCodeFor } from \"./socket.js\";\nexport type { LobbySocket, LobbySocketOptions } from \"./socket.js\";\nexport { Lockstep } from \"./lockstep.js\";\nexport type { Frame, DesyncInfo, LockstepEvents } from \"./lockstep.js\";\nexport { Chat, CHAT_MAX_BYTES } from \"./chat.js\";\nexport type { ChatMessage, ChatEvents } from \"./chat.js\";\nexport { Voice } from \"./voice.js\";\nexport type { VoiceEvents, VoiceDeps } from \"./voice.js\";\nexport type { VoiceMode } from \"./voice-core.js\";\nexport type { VoiceCodec, VoiceEncoderHandle, VoiceDecoderHandle, FrameSource, AudioSink, VoiceError } from \"./voice-types.js\";\nexport { webCodecsOpusAvailable } from \"./voice-browser.js\";\nexport { normalizeCode, formatCode } from \"./crockford.js\";\n// Direct IP (docs/direct-ip.md): kit.joinDirect(code); the code is the host's address in disguise. Hosting is in\n// onelobby/direct (Node). webRtcLinkFactoryFor gives Node joiners a WebRTC stack (node-datachannel/polyfill).\nexport { decodeJoinCode, looksLikeJoinCode } from \"./joincode.js\";\nexport type { DecodedJoinCode, JoinCodeError } from \"./joincode.js\";\nexport { webRtcLinkFactoryFor } from \"./webrtc.js\";\nexport { OneLobbyError } from \"./signaling.js\";\nexport type { LobbySummary, LobbyState, PeerInfo } from \"./signaling.js\";\n// Types for the seams in OneLobbyOptions (ChannelName also tags raw messages).\nexport type { PeerLink, LinkFactory, SocketFactory, SocketLike, IceServer, ChannelName } from \"./transport.js\";\nexport type { Clock } from \"./clock.js\";\nexport { describeError, shareUrl, codeFromUrl, ErrorCodes } from \"./friendly.js\";\nexport type { FriendlyError, ErrorCode } from \"./friendly.js\";\n// Pre-rename names, kept for one version so existing games keep working.\nexport { Keepalive, KeepaliveError } from \"./deprecated.js\";\nexport type { KeepaliveOptions, KeepaliveEvents } from \"./deprecated.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,0GAA0G;AAC1G,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,+GAA+G;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInC,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,wHAAwH;AACxH,8GAA8G;AAC9G,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAK/C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEjG,yEAAyE;AACzE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5D,2GAA2G;AAC3G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE/F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/**\n * Public API of `onelobby`: create a `OneLobby`, `host()` / `join(code)` / `list()` lobbies, then use the\n * `Lobby`'s lockstep, raw messages, chat and voice. Lower-level pieces (codec, chunking, migration, jitter buffer,\n * WebRTC/signaling classes, clocks, the gridpaint demo game) live in `onelobby/internals`.\n */\nexport { OneLobby, LIB_NAME, LIB_VERSION } from \"./onelobby.js\";\nexport type { OneLobbyOptions, FromConfigOverrides, HostOptions, ListOptions, OneLobbyEvents, JoinDirectOptions } from \"./onelobby.js\";\nexport { DEFAULT_READY_TIMEOUT_MS } from \"./onelobby.js\";\nexport type { AdvancedOptions, SeatStorage } from \"./onelobby.js\";\n// Blueprint v1: onelobby.json (docs/design/blueprint.md). OneLobby.fromConfig(json) builds a kit from it.\nexport { parseBlueprint, defineBlueprint, BlueprintError } from \"./blueprint.js\";\nexport type { Blueprint, BlueprintInput, BlueprintEngine } from \"./blueprint.js\";\nexport { Lobby } from \"./lobby.js\";\nexport type { LobbyEvents, LobbyConfig, Peer, Phase, RateLimit } from \"./lobby.js\";\nexport { MIN_PEER_TIMEOUT_MS } from \"./lobby.js\";\n// WebSocket-shaped sockets over a lobby: lobby.asWebSocket() (joiner), lobby.onConnection(conn => ...) (host).\nexport { closeCodeFor } from \"./socket.js\";\nexport type { LobbySocket, LobbySocketOptions } from \"./socket.js\";\nexport { Lockstep } from \"./lockstep.js\";\nexport type { Frame, DesyncInfo, LockstepEvents } from \"./lockstep.js\";\nexport { Chat, CHAT_MAX_BYTES } from \"./chat.js\";\nexport { Pause } from \"./pause.js\";\nexport type { PauseState, PauseEvents, PauseMode, PauseRefusal } from \"./pause.js\";\nexport type { ChatMessage, ChatEvents } from \"./chat.js\";\nexport { Voice } from \"./voice.js\";\nexport type { VoiceEvents, VoiceDeps } from \"./voice.js\";\nexport type { VoiceMode } from \"./voice-core.js\";\nexport type { VoiceCodec, VoiceEncoderHandle, VoiceDecoderHandle, FrameSource, AudioSink, VoiceError } from \"./voice-types.js\";\nexport { webCodecsOpusAvailable } from \"./voice-browser.js\";\nexport { normalizeCode, formatCode } from \"./crockford.js\";\n// Direct IP (docs/design/direct-ip.md): kit.joinDirect(code); the code is the host's address in disguise. Hosting is in\n// onelobby/direct (Node). webRtcLinkFactoryFor gives Node joiners a WebRTC stack (node-datachannel/polyfill).\nexport { decodeJoinCode, looksLikeJoinCode } from \"./joincode.js\";\nexport type { DecodedJoinCode, JoinCodeError } from \"./joincode.js\";\nexport { webRtcLinkFactoryFor } from \"./webrtc.js\";\nexport { OneLobbyError } from \"./signaling.js\";\nexport type { LobbySummary, LobbyState, PeerInfo } from \"./signaling.js\";\n// Types for the seams in OneLobbyOptions (ChannelName also tags raw messages).\nexport type { PeerLink, LinkFactory, SocketFactory, SocketLike, IceServer, ChannelName } from \"./transport.js\";\nexport type { Clock } from \"./clock.js\";\nexport { describeError, shareUrl, codeFromUrl, directJoinInfo, ErrorCodes } from \"./friendly.js\";\nexport type { FriendlyError, ErrorCode, JoinInfo } from \"./friendly.js\";\n// Pre-rename names, kept for one version so existing games keep working.\nexport { Keepalive, KeepaliveError } from \"./deprecated.js\";\nexport type { KeepaliveOptions, KeepaliveEvents } from \"./deprecated.js\";\n// Nostr signaling for direct hosts (spec/nostr-signaling.md): relay probe for picking hosting.nostrRelays.\nexport { checkNostrRelays, DEFAULT_NOSTR_RELAYS, DEFAULT_NOSTR_STUN } from \"./nostr/relays.js\";\nexport type { RelayCheck, RelayConnect } from \"./nostr/relays.js\";\nexport { encodeRoomCode } from \"./joincode.js\";\n// Browser host (no Node process, no port): kit.hostNostr(options).\nexport type { BrowserHostOptions, VisibilityDoc } from \"./direct/browser-host.js\";\n"]}

package/dist/internals.d.ts

@@ -7,6 +7,8 @@
 export * from "./index.js";
 export { MAX_DESYNCS, HOST_SILENCE_MS } from "./lockstep.js";
 export { ChatLimiter, sanitizeChat, CHAT_HISTORY_LINES } from "./chat.js";
+export { PAUSE_MIN_REQUEST_GAP_MS } from "./pause.js";
+export { PAUSE_FLAG_PAUSER_LEFT, PAUSE_REFUSE } from "./codec.js";
 export { JitterBuffer, VoiceGate, VoicePacketizer, VoiceRelayPolicy, FRAME_SAMPLES, SAMPLE_RATE, MAX_SPEAKERS, } from "./voice-core.js";
 export type { VoicePacket } from "./voice-core.js";
 export { webCodecsOpus, WorkletMic, WebAudioSink } from "./voice-browser.js";
@@ -26,3 +28,10 @@ export { encodeJoinCode, decodeJoinCode, normalizeJoinCode, looksLikeJoinCode, J
 export { parseDirectAddress, DEFAULT_DIRECT_PORT } from "./direct-address.js";
 export type { DirectAddress } from "./direct-address.js";
 export { webRtcLinkFactoryFor } from "./webrtc.js";
+export { NostrSocket } from "./nostr/socket.js";
+export { NostrRoom } from "./nostr/room.js";
+export { ReliableLink } from "./nostr/link.js";
+export { RelayPool, makeEvent, NOSTR_KIND } from "./nostr/relays.js";
+export { schnorrSign, schnorrVerify, schnorrPublicKey } from "./nostr/secp256k1.js";
+export { deriveRoomKeys } from "./nostr/crypto.js";
+export { encodeRoomCodeFor } from "./joincode.js";

package/dist/internals.js

@@ -7,6 +7,8 @@
 export * from "./index.js";
 export { MAX_DESYNCS, HOST_SILENCE_MS } from "./lockstep.js";
 export { ChatLimiter, sanitizeChat, CHAT_HISTORY_LINES } from "./chat.js";
+export { PAUSE_MIN_REQUEST_GAP_MS } from "./pause.js";
+export { PAUSE_FLAG_PAUSER_LEFT, PAUSE_REFUSE } from "./codec.js";
 export { JitterBuffer, VoiceGate, VoicePacketizer, VoiceRelayPolicy, FRAME_SAMPLES, SAMPLE_RATE, MAX_SPEAKERS, } from "./voice-core.js";
 export { webCodecsOpus, WorkletMic, WebAudioSink } from "./voice-browser.js";
 export { pickNewHost, claimWins, claimWinsWrapped } from "./migration.js";
@@ -21,4 +23,11 @@ export { Gridpaint, paintCmd, colourOf, PALETTE, GRID_W, GRID_H, seedFromCode, f
 export { encodeJoinCode, decodeJoinCode, normalizeJoinCode, looksLikeJoinCode, JOIN_CODE_LENGTH } from "./joincode.js";
 export { parseDirectAddress, DEFAULT_DIRECT_PORT } from "./direct-address.js";
 export { webRtcLinkFactoryFor } from "./webrtc.js";
+export { NostrSocket } from "./nostr/socket.js";
+export { NostrRoom } from "./nostr/room.js";
+export { ReliableLink } from "./nostr/link.js";
+export { RelayPool, makeEvent, NOSTR_KIND } from "./nostr/relays.js";
+export { schnorrSign, schnorrVerify, schnorrPublicKey } from "./nostr/secp256k1.js";
+export { deriveRoomKeys } from "./nostr/crypto.js";
+export { encodeRoomCodeFor } from "./joincode.js";
 //# sourceMappingURL=internals.js.map

package/dist/internals.js.map

@@ -1 +1 @@
-{"version":3,"file":"internals.js","sourceRoot":"","sources":["../src/internals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EACL,YAAY,EACZ,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEhG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE/G,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["/**\n * Everything the package has, including the building blocks apps normally never call: wire codec, chunking, deflate,\n * host-migration rule, jitter buffer and voice packetizer, signaling and WebRTC classes, clocks, and the gridpaint demo\n * game. Exported as `onelobby/internals`. No stability promise: these can change in any release.\n * The public API is the root export (`onelobby`); it is re-exported here too.\n */\nexport * from \"./index.js\";\nexport { MAX_DESYNCS, HOST_SILENCE_MS } from \"./lockstep.js\";\nexport { ChatLimiter, sanitizeChat, CHAT_HISTORY_LINES } from \"./chat.js\";\nexport {\n  JitterBuffer,\n  VoiceGate,\n  VoicePacketizer,\n  VoiceRelayPolicy,\n  FRAME_SAMPLES,\n  SAMPLE_RATE,\n  MAX_SPEAKERS,\n} from \"./voice-core.js\";\nexport type { VoicePacket } from \"./voice-core.js\";\nexport { webCodecsOpus, WorkletMic, WebAudioSink } from \"./voice-browser.js\";\nexport { pickNewHost, claimWins, claimWinsWrapped } from \"./migration.js\";\nexport type { Claim } from \"./migration.js\";\nexport { decodeCrockford, encodeCrockford, CROCKFORD_ALPHABET } from \"./crockford.js\";\nexport { encodeMessage, decodeMessage, CodecError, MAX_FRAME_BYTES, MsgType } from \"./codec.js\";\nexport type { Message, Decoded } from \"./codec.js\";\nexport { splitChunks, Reassembler, CHUNK_PAYLOAD } from \"./chunking.js\";\nexport { deflate, inflate, deflateAvailable } from \"./deflate.js\";\nexport { SignalingClient } from \"./signaling.js\";\nexport { WebRtcLink, webRtcLinkFactory } from \"./webrtc.js\";\nexport { systemClock } from \"./clock.js\";\nexport { Gridpaint, paintCmd, colourOf, PALETTE, GRID_W, GRID_H, seedFromCode, fnv1a64 } from \"./gridpaint.js\";\nexport type { Hub } from \"./hub.js\";\nexport { encodeJoinCode, decodeJoinCode, normalizeJoinCode, looksLikeJoinCode, JOIN_CODE_LENGTH } from \"./joincode.js\";\nexport { parseDirectAddress, DEFAULT_DIRECT_PORT } from \"./direct-address.js\";\nexport type { DirectAddress } from \"./direct-address.js\";\nexport { webRtcLinkFactoryFor } from \"./webrtc.js\";\n"]}
+{"version":3,"file":"internals.js","sourceRoot":"","sources":["../src/internals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEhG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE/G,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["/**\n * Everything the package has, including the building blocks apps normally never call: wire codec, chunking, deflate,\n * host-migration rule, jitter buffer and voice packetizer, signaling and WebRTC classes, clocks, and the gridpaint demo\n * game. Exported as `onelobby/internals`. No stability promise: these can change in any release.\n * The public API is the root export (`onelobby`); it is re-exported here too.\n */\nexport * from \"./index.js\";\nexport { MAX_DESYNCS, HOST_SILENCE_MS } from \"./lockstep.js\";\nexport { ChatLimiter, sanitizeChat, CHAT_HISTORY_LINES } from \"./chat.js\";\nexport { PAUSE_MIN_REQUEST_GAP_MS } from \"./pause.js\";\nexport { PAUSE_FLAG_PAUSER_LEFT, PAUSE_REFUSE } from \"./codec.js\";\nexport {\n  JitterBuffer,\n  VoiceGate,\n  VoicePacketizer,\n  VoiceRelayPolicy,\n  FRAME_SAMPLES,\n  SAMPLE_RATE,\n  MAX_SPEAKERS,\n} from \"./voice-core.js\";\nexport type { VoicePacket } from \"./voice-core.js\";\nexport { webCodecsOpus, WorkletMic, WebAudioSink } from \"./voice-browser.js\";\nexport { pickNewHost, claimWins, claimWinsWrapped } from \"./migration.js\";\nexport type { Claim } from \"./migration.js\";\nexport { decodeCrockford, encodeCrockford, CROCKFORD_ALPHABET } from \"./crockford.js\";\nexport { encodeMessage, decodeMessage, CodecError, MAX_FRAME_BYTES, MsgType } from \"./codec.js\";\nexport type { Message, Decoded } from \"./codec.js\";\nexport { splitChunks, Reassembler, CHUNK_PAYLOAD } from \"./chunking.js\";\nexport { deflate, inflate, deflateAvailable } from \"./deflate.js\";\nexport { SignalingClient } from \"./signaling.js\";\nexport { WebRtcLink, webRtcLinkFactory } from \"./webrtc.js\";\nexport { systemClock } from \"./clock.js\";\nexport { Gridpaint, paintCmd, colourOf, PALETTE, GRID_W, GRID_H, seedFromCode, fnv1a64 } from \"./gridpaint.js\";\nexport type { Hub } from \"./hub.js\";\nexport { encodeJoinCode, decodeJoinCode, normalizeJoinCode, looksLikeJoinCode, JOIN_CODE_LENGTH } from \"./joincode.js\";\nexport { parseDirectAddress, DEFAULT_DIRECT_PORT } from \"./direct-address.js\";\nexport type { DirectAddress } from \"./direct-address.js\";\nexport { webRtcLinkFactoryFor } from \"./webrtc.js\";\nexport { NostrSocket } from \"./nostr/socket.js\";\nexport { NostrRoom } from \"./nostr/room.js\";\nexport { ReliableLink } from \"./nostr/link.js\";\nexport { RelayPool, makeEvent, NOSTR_KIND } from \"./nostr/relays.js\";\nexport { schnorrSign, schnorrVerify, schnorrPublicKey } from \"./nostr/secp256k1.js\";\nexport { deriveRoomKeys } from \"./nostr/crypto.js\";\nexport { encodeRoomCodeFor } from \"./joincode.js\";\n"]}

package/dist/join-code-kind.d.ts

@@ -0,0 +1,10 @@
+/**
+ * What a direct host's join code is. One tuple for the whole client; C# has the `JoinCodeKind` enum and
+ * `DirectLobby.KindName`, and `spec/vectors/join-code-kinds.json` pins that both spell each kind alike.
+ */
+export declare const JOIN_CODE_KINDS: readonly ["nostr", "internet", "same_network", "none"];
+export type JoinCodeKind = (typeof JOIN_CODE_KINDS)[number];
+/** An IP code (the host's address): everything but `nostr`. */
+export type IpCodeKind = Exclude<JoinCodeKind, "nostr">;
+/** The kind as the startup line spells it (C# `JoinCodeKind.ToString()`): `same_network` -> `SameNetwork`. */
+export declare function joinCodeKindName(k: JoinCodeKind): string;

package/dist/join-code-kind.js

@@ -0,0 +1,10 @@
+/**
+ * What a direct host's join code is. One tuple for the whole client; C# has the `JoinCodeKind` enum and
+ * `DirectLobby.KindName`, and `spec/vectors/join-code-kinds.json` pins that both spell each kind alike.
+ */
+export const JOIN_CODE_KINDS = ["nostr", "internet", "same_network", "none"];
+/** The kind as the startup line spells it (C# `JoinCodeKind.ToString()`): `same_network` -> `SameNetwork`. */
+export function joinCodeKindName(k) {
+    return k === "internet" ? "Internet" : k === "same_network" ? "SameNetwork" : k === "nostr" ? "Nostr" : "None";
+}
+//# sourceMappingURL=join-code-kind.js.map

package/dist/join-code-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-code-kind.js","sourceRoot":"","sources":["../src/join-code-kind.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,CAAU,CAAC;AAKtF,8GAA8G;AAC9G,MAAM,UAAU,gBAAgB,CAAC,CAAe;IAC9C,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACjH,CAAC","sourcesContent":["/**\n * What a direct host's join code is. One tuple for the whole client; C# has the `JoinCodeKind` enum and\n * `DirectLobby.KindName`, and `spec/vectors/join-code-kinds.json` pins that both spell each kind alike.\n */\nexport const JOIN_CODE_KINDS = [\"nostr\", \"internet\", \"same_network\", \"none\"] as const;\nexport type JoinCodeKind = (typeof JOIN_CODE_KINDS)[number];\n/** An IP code (the host's address): everything but `nostr`. */\nexport type IpCodeKind = Exclude<JoinCodeKind, \"nostr\">;\n\n/** The kind as the startup line spells it (C# `JoinCodeKind.ToString()`): `same_network` -> `SameNetwork`. */\nexport function joinCodeKindName(k: JoinCodeKind): string {\n  return k === \"internet\" ? \"Internet\" : k === \"same_network\" ? \"SameNetwork\" : k === \"nostr\" ? \"Nostr\" : \"None\";\n}\n"]}

package/dist/joincode.d.ts

@@ -1,5 +1,5 @@
 /**
- * `dc1` join codes (docs/direct-ip.md s.2a, spec/reference/joincode.mjs): a direct-IP host's IPv4 address and port in
+ * `dc1` join codes (docs/design/direct-ip.md s.2a, spec/reference/joincode.mjs): a direct-IP host's IPv4 address and port in
  * 11 Crockford characters, shown `6B01-RGFE-P2B`. The code is the address in disguise, so decoding asks nobody.
  * Bits, most significant first: version:2 (0 = IPv4) | ipv4:32 | port:16 | crc:5 (CRC-5, polynomial 0x05, over the 50
  * bits before it). One mistyped character always fails the check.
@@ -9,11 +9,20 @@ export type JoinCodeError = "bad_code" | "unknown_version";
 export type DecodedJoinCode = {
     ip: string;
     port: number;
+} | {
+    room: string;
 } | {
     error: JoinCodeError;
 };
 /** Display form (`6B01-RGFE-P2B`) for an IPv4 address and port 1-65535. Throws on anything else. */
 export declare function encodeJoinCode(ipv4: string, port: number): string;
+/**
+ * Version 1 code (a Nostr room, spec/nostr-signaling.md s.1): version:2 = 1 | room:48 | crc:5. `roomHex` is 12 hex
+ * digits. The room is only a secret both sides derive keys from.
+ */
+export declare function encodeRoomCodeFor(roomHex: string): string;
+/** A new version 1 code with a random 48-bit room from the platform's CSPRNG. */
+export declare function encodeRoomCode(): string;
 /** Upper case, spaces and hyphens dropped, i/l -> 1, o -> 0; null unless 11 alphabet characters. */
 export declare function normalizeJoinCode(input: string): string | null;
 export declare function decodeJoinCode(input: string): DecodedJoinCode;

package/dist/joincode.js

@@ -1,6 +1,6 @@
 import { CROCKFORD_ALPHABET } from "./crockford.js";
 /**
- * `dc1` join codes (docs/direct-ip.md s.2a, spec/reference/joincode.mjs): a direct-IP host's IPv4 address and port in
+ * `dc1` join codes (docs/design/direct-ip.md s.2a, spec/reference/joincode.mjs): a direct-IP host's IPv4 address and port in
  * 11 Crockford characters, shown `6B01-RGFE-P2B`. The code is the address in disguise, so decoding asks nobody.
  * Bits, most significant first: version:2 (0 = IPv4) | ipv4:32 | port:16 | crc:5 (CRC-5, polynomial 0x05, over the 50
  * bits before it). One mistyped character always fails the check.
@@ -36,7 +36,9 @@ export function encodeJoinCode(ipv4, port) {
         throw new Error(`not an IPv4 address: ${ipv4}`);
     if (!Number.isInteger(port) || port < 1 || port > 65535)
         throw new Error(`bad port ${port}`);
-    const data = (BigInt(ip) << 16n) | BigInt(port); // version 0
+    return encodeData((BigInt(ip) << 16n) | BigInt(port)); // version 0
+}
+function encodeData(data) {
     let v = (data << 5n) | BigInt(crc5(data, 50));
     let s = "";
     for (let i = 0; i < JOIN_CODE_LENGTH; i++) {
@@ -45,6 +47,21 @@ export function encodeJoinCode(ipv4, port) {
     }
     return `${s.slice(0, 4)}-${s.slice(4, 8)}-${s.slice(8)}`;
 }
+/**
+ * Version 1 code (a Nostr room, spec/nostr-signaling.md s.1): version:2 = 1 | room:48 | crc:5. `roomHex` is 12 hex
+ * digits. The room is only a secret both sides derive keys from.
+ */
+export function encodeRoomCodeFor(roomHex) {
+    if (!/^[0-9a-fA-F]{12}$/.test(roomHex))
+        throw new Error(`room must be 12 hex digits: ${roomHex}`);
+    return encodeData((1n << 48n) | BigInt("0x" + roomHex));
+}
+/** A new version 1 code with a random 48-bit room from the platform's CSPRNG. */
+export function encodeRoomCode() {
+    const b = new Uint8Array(6);
+    globalThis.crypto.getRandomValues(b);
+    return encodeRoomCodeFor([...b].map((x) => x.toString(16).padStart(2, "0")).join(""));
+}
 /** Upper case, spaces and hyphens dropped, i/l -> 1, o -> 0; null unless 11 alphabet characters. */
 export function normalizeJoinCode(input) {
     const s = input
@@ -69,7 +86,10 @@ export function decodeJoinCode(input) {
     const data = v >> 5n;
     if (crc5(data, 50) !== Number(v & 31n))
         return { error: "bad_code" };
-    if (data >> 48n !== 0n)
+    const version = data >> 48n;
+    if (version === 1n)
+        return { room: (data & 0xffffffffffffn).toString(16).padStart(12, "0") };
+    if (version !== 0n)
         return { error: "unknown_version" };
     const port = Number(data & 0xffffn);
     if (port === 0)

package/dist/joincode.js.map

@@ -1 +1 @@
-{"version":3,"file":"joincode.js","sourceRoot":"","sources":["../src/joincode.ts"],"names":[],"mappings":"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","sourcesContent":["import { CROCKFORD_ALPHABET } from \"./crockford.js\";\n\n/**\n * `dc1` join codes (docs/direct-ip.md s.2a, spec/reference/joincode.mjs): a direct-IP host's IPv4 address and port in\n * 11 Crockford characters, shown `6B01-RGFE-P2B`. The code is the address in disguise, so decoding asks nobody.\n * Bits, most significant first: version:2 (0 = IPv4) | ipv4:32 | port:16 | crc:5 (CRC-5, polynomial 0x05, over the 50\n * bits before it). One mistyped character always fails the check.\n */\nexport const JOIN_CODE_LENGTH = 11;\n\nexport type JoinCodeError = \"bad_code\" | \"unknown_version\";\nexport type DecodedJoinCode = { ip: string; port: number } | { error: JoinCodeError };\n\nfunction crc5(value: bigint, bits: number): number {\n  let crc = 0;\n  for (let i = bits - 1; i >= 0; i--) {\n    const bit = Number((value >> BigInt(i)) & 1n);\n    const top = (crc >> 4) & 1;\n    crc = (crc << 1) & 0x1f;\n    if (top ^ bit) crc ^= 0x05;\n  }\n  return crc;\n}\n\nfunction parseIPv4(ip: string): number | null {\n  const parts = ip.split(\".\");\n  if (parts.length !== 4) return null;\n  let n = 0;\n  for (const p of parts) {\n    if (!/^\\d{1,3}$/.test(p) || Number(p) > 255) return null;\n    n = n * 256 + Number(p);\n  }\n  return n;\n}\n\n/** Display form (`6B01-RGFE-P2B`) for an IPv4 address and port 1-65535. Throws on anything else. */\nexport function encodeJoinCode(ipv4: string, port: number): string {\n  const ip = parseIPv4(ipv4);\n  if (ip === null) throw new Error(`not an IPv4 address: ${ipv4}`);\n  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error(`bad port ${port}`);\n  const data = (BigInt(ip) << 16n) | BigInt(port); // version 0\n  let v = (data << 5n) | BigInt(crc5(data, 50));\n  let s = \"\";\n  for (let i = 0; i < JOIN_CODE_LENGTH; i++) {\n    s = CROCKFORD_ALPHABET[Number(v & 31n)] + s;\n    v >>= 5n;\n  }\n  return `${s.slice(0, 4)}-${s.slice(4, 8)}-${s.slice(8)}`;\n}\n\n/** Upper case, spaces and hyphens dropped, i/l -> 1, o -> 0; null unless 11 alphabet characters. */\nexport function normalizeJoinCode(input: string): string | null {\n  const s = input\n    .replace(/[ \\-]/g, \"\")\n    .replace(/[a-z]/g, (c) => c.toUpperCase())\n    .replace(/[IL]/g, \"1\")\n    .replace(/O/g, \"0\");\n  if (s.length !== JOIN_CODE_LENGTH) return null;\n  for (const c of s) if (CROCKFORD_ALPHABET.indexOf(c) < 0) return null;\n  return s;\n}\n\nexport function decodeJoinCode(input: string): DecodedJoinCode {\n  const s = normalizeJoinCode(input);\n  if (!s) return { error: \"bad_code\" };\n  let v = 0n;\n  for (const c of s) v = (v << 5n) | BigInt(CROCKFORD_ALPHABET.indexOf(c));\n  const data = v >> 5n;\n  if (crc5(data, 50) !== Number(v & 31n)) return { error: \"bad_code\" };\n  if (data >> 48n !== 0n) return { error: \"unknown_version\" };\n  const port = Number(data & 0xffffn);\n  if (port === 0) return { error: \"bad_code\" };\n  const a = Number((data >> 16n) & 0xffffffffn);\n  return { ip: [a >>> 24, (a >>> 16) & 255, (a >>> 8) & 255, a & 255].join(\".\"), port };\n}\n\n/** Shaped like a join code (no dots or colons, 11 alphabet characters): a failed decode is `bad_code`, not a host name. */\nexport function looksLikeJoinCode(input: string): boolean {\n  return !/[.:]/.test(input) && normalizeJoinCode(input) !== null;\n}\n"]}
+{"version":3,"file":"joincode.js","sourceRoot":"","sources":["../src/joincode.ts"],"names":[],"mappings":"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","sourcesContent":["import { CROCKFORD_ALPHABET } from \"./crockford.js\";\n\n/**\n * `dc1` join codes (docs/design/direct-ip.md s.2a, spec/reference/joincode.mjs): a direct-IP host's IPv4 address and port in\n * 11 Crockford characters, shown `6B01-RGFE-P2B`. The code is the address in disguise, so decoding asks nobody.\n * Bits, most significant first: version:2 (0 = IPv4) | ipv4:32 | port:16 | crc:5 (CRC-5, polynomial 0x05, over the 50\n * bits before it). One mistyped character always fails the check.\n */\nexport const JOIN_CODE_LENGTH = 11;\n\nexport type JoinCodeError = \"bad_code\" | \"unknown_version\";\nexport type DecodedJoinCode = { ip: string; port: number } | { room: string } | { error: JoinCodeError };\n\nfunction crc5(value: bigint, bits: number): number {\n  let crc = 0;\n  for (let i = bits - 1; i >= 0; i--) {\n    const bit = Number((value >> BigInt(i)) & 1n);\n    const top = (crc >> 4) & 1;\n    crc = (crc << 1) & 0x1f;\n    if (top ^ bit) crc ^= 0x05;\n  }\n  return crc;\n}\n\nfunction parseIPv4(ip: string): number | null {\n  const parts = ip.split(\".\");\n  if (parts.length !== 4) return null;\n  let n = 0;\n  for (const p of parts) {\n    if (!/^\\d{1,3}$/.test(p) || Number(p) > 255) return null;\n    n = n * 256 + Number(p);\n  }\n  return n;\n}\n\n/** Display form (`6B01-RGFE-P2B`) for an IPv4 address and port 1-65535. Throws on anything else. */\nexport function encodeJoinCode(ipv4: string, port: number): string {\n  const ip = parseIPv4(ipv4);\n  if (ip === null) throw new Error(`not an IPv4 address: ${ipv4}`);\n  if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error(`bad port ${port}`);\n  return encodeData((BigInt(ip) << 16n) | BigInt(port)); // version 0\n}\n\nfunction encodeData(data: bigint): string {\n  let v = (data << 5n) | BigInt(crc5(data, 50));\n  let s = \"\";\n  for (let i = 0; i < JOIN_CODE_LENGTH; i++) {\n    s = CROCKFORD_ALPHABET[Number(v & 31n)] + s;\n    v >>= 5n;\n  }\n  return `${s.slice(0, 4)}-${s.slice(4, 8)}-${s.slice(8)}`;\n}\n\n/**\n * Version 1 code (a Nostr room, spec/nostr-signaling.md s.1): version:2 = 1 | room:48 | crc:5. `roomHex` is 12 hex\n * digits. The room is only a secret both sides derive keys from.\n */\nexport function encodeRoomCodeFor(roomHex: string): string {\n  if (!/^[0-9a-fA-F]{12}$/.test(roomHex)) throw new Error(`room must be 12 hex digits: ${roomHex}`);\n  return encodeData((1n << 48n) | BigInt(\"0x\" + roomHex));\n}\n\n/** A new version 1 code with a random 48-bit room from the platform's CSPRNG. */\nexport function encodeRoomCode(): string {\n  const b = new Uint8Array(6);\n  globalThis.crypto.getRandomValues(b);\n  return encodeRoomCodeFor([...b].map((x) => x.toString(16).padStart(2, \"0\")).join(\"\"));\n}\n\n/** Upper case, spaces and hyphens dropped, i/l -> 1, o -> 0; null unless 11 alphabet characters. */\nexport function normalizeJoinCode(input: string): string | null {\n  const s = input\n    .replace(/[ \\-]/g, \"\")\n    .replace(/[a-z]/g, (c) => c.toUpperCase())\n    .replace(/[IL]/g, \"1\")\n    .replace(/O/g, \"0\");\n  if (s.length !== JOIN_CODE_LENGTH) return null;\n  for (const c of s) if (CROCKFORD_ALPHABET.indexOf(c) < 0) return null;\n  return s;\n}\n\nexport function decodeJoinCode(input: string): DecodedJoinCode {\n  const s = normalizeJoinCode(input);\n  if (!s) return { error: \"bad_code\" };\n  let v = 0n;\n  for (const c of s) v = (v << 5n) | BigInt(CROCKFORD_ALPHABET.indexOf(c));\n  const data = v >> 5n;\n  if (crc5(data, 50) !== Number(v & 31n)) return { error: \"bad_code\" };\n  const version = data >> 48n;\n  if (version === 1n) return { room: (data & 0xffffffffffffn).toString(16).padStart(12, \"0\") };\n  if (version !== 0n) return { error: \"unknown_version\" };\n  const port = Number(data & 0xffffn);\n  if (port === 0) return { error: \"bad_code\" };\n  const a = Number((data >> 16n) & 0xffffffffn);\n  return { ip: [a >>> 24, (a >>> 16) & 255, (a >>> 8) & 255, a & 255].join(\".\"), port };\n}\n\n/** Shaped like a join code (no dots or colons, 11 alphabet characters): a failed decode is `bad_code`, not a host name. */\nexport function looksLikeJoinCode(input: string): boolean {\n  return !/[.:]/.test(input) && normalizeJoinCode(input) !== null;\n}\n"]}

package/dist/lobby.d.ts

@@ -1,8 +1,10 @@
 import { Chat } from "./chat.js";
+import type { IpCodeKind, JoinCodeKind } from "./join-code-kind.js";
 import type { Clock } from "./clock.js";
 import { PROTO } from "./codec.js";
 import { Emitter } from "./emitter.js";
 import { Lockstep } from "./lockstep.js";
+import { Pause } from "./pause.js";
 import { type LobbyState, type PeerInfo, type SignalingClient } from "./signaling.js";
 import type { ChannelName, IceServer, LinkFactory, PeerLink } from "./transport.js";
 import { Voice, type VoiceDeps } from "./voice.js";
@@ -23,6 +25,8 @@ export interface KickOptions {
     reason?: string;
 }
 export type Peer = PeerInfo;
+/** What a direct host's `joinCode` is: see {@link Lobby.joinCodeKind}. */
+export type { JoinCodeKind };
 export type LobbyEvents = {
     peerJoined: [Peer];
     /** The peer's data channels are open and the handshake is done: reliable sends reach it now (earlier ones were queued and flushed). */
@@ -31,6 +35,13 @@ export type LobbyEvents = {
     ready: [];
     /** reason "left", "kicked", "disconnected" (kick with ban false), "timeout", ...; `close` when the host gave one. */
     peerLeft: [Peer, reason: string, close?: CloseInfo];
+    /**
+     * Host only: a joiner never got its link to the host open ("a friend could not connect"). reason "timeout" when it is
+     * not ready `readyTimeoutMs` after joining (it may still connect: `peerReady` then fires as usual), else the
+     * `peerLeft` reason when it leaves before it was ready (a joiner's own `ice_failed` ends that way). Fires at most once
+     * per peer, just before that `peerLeft`; not for peers the host kicks or disconnects.
+     */
+    peerFailed: [Peer, reason: string];
     joinRequested: [Peer];
     hostChanged: [hostId: number];
     phase: [Phase];
@@ -40,6 +51,16 @@ export type LobbyEvents = {
     /** The signaling server went away. The game continues on the data channels (s.9). */
     serverLost: [];
     metaChanged: [Record<string, string>];
+    /**
+     * Direct-IP host only: the join code changed after `hostDirect` resolved, e.g. the router answered a later port-mapping
+     * retry and the code went from "same_network" to "internet". Show the new code (and `joinUrl`).
+     */
+    joinCodeChanged: [code: string, kind: JoinCodeKind];
+    /**
+     * Browser host only (`kit.hostNostr`): the host tab went hidden (`true`) or visible again (`false`). Browsers throttle
+     * timers in hidden tabs, so joiners may see lag or drop; ask the host to keep the tab visible.
+     */
+    hostHiddenChanged: [hidden: boolean];
 };
 export interface LobbyConfig {
     signaling: SignalingClient;
@@ -59,7 +80,7 @@ export interface LobbyConfig {
      */
     readyTimeoutMs?: number;
     /**
-     * Direct IP (docs/direct-ip.md): the hub lives in the host, so there is no migration. A joiner that loses the host
+     * Direct IP (docs/design/direct-ip.md): the hub lives in the host, so there is no migration. A joiner that loses the host
      * (link, peer_left, a host_changed from the hub as it shuts down, or the signaling socket) ends with "host_left".
      */
     direct?: boolean;
@@ -91,31 +112,55 @@ export declare class Lobby extends Emitter<LobbyEvents> {
     readonly tickRate: number;
     readonly lockstep: Lockstep;
     readonly chat: Chat;
+    /** The shared co-op pause (docs/recipes/pause.md). */
+    readonly pause: Pause;
     readonly voice: Voice;
     localPeerId: number;
     hostPeerId: number;
     phase: Phase;
     meta: Record<string, string>;
+    /** The lobby's name as the server keeps it (host()'s `name`, sanitised); "" if the server sends none. */
+    name: string;
     resumeToken: string;
     /** Last measured round trip to the host in ms (joiners), or 0. */
     rtt: number;
     /**
-     * Direct-IP host only (onelobby/direct): the code friends paste to join, e.g. "6B01-RGFE-P2B" (docs/direct-ip.md
+     * Direct-IP host only (onelobby/direct): the code friends paste to join, e.g. "6B01-RGFE-P2B" (docs/design/direct-ip.md
      * s.2a). Show it with joinCodeKind. Empty when the machine has no IPv4 address, and on joiners.
      */
     joinCode: string;
-    /** "internet": the router forwarded the port and the code carries its public address; "same_network": the LAN address. */
-    joinCodeKind: "internet" | "same_network" | "none";
+    /**
+     * "nostr": a version 1 code that works through public Nostr relays (spec/nostr-signaling.md; the default for a direct
+     * host). "internet": the router forwarded the port and the code carries its public address; "same_network": the LAN
+     * address. "none": no code.
+     */
+    joinCodeKind: JoinCodeKind;
+    /**
+     * Direct-IP host only: the IP code (address and port, version 0), with `directCodeKind` "internet" or "same_network".
+     * Equal to `joinCode` when Nostr is off; otherwise the code to hand out for LAN play or when the router port is open.
+     */
+    directCode: string;
+    directCodeKind: IpCodeKind;
     /** Direct-IP host only: this machine's addresses with the port, for an "Advanced" fold-out. */
     directAddresses: string[];
     /** Direct-IP host only: how the router port-open went ("UPnP", "no UPnP gateway answered; ...", "off"). */
     portMapping: string;
+    /** Direct-IP host only: the one startup line (bound port, join code, port mapping); see `formatHostLog` in onelobby/direct. */
+    directHostLog: string;
+    /** Browser host only (`kit.hostNostr`): true while the host tab is hidden (see the `hostHiddenChanged` event). */
+    hostHidden: boolean;
+    /** @internal kit.hostNostr: the tab's visibility changed. */
+    setHostHidden(hidden: boolean): void;
+    /** @internal onelobby/direct: fires `joinCodeChanged` with the current code. */
+    notifyJoinCodeChanged(): void;
     private signaling;
     private cfg;
     private roster;
     private links;
     /** ICE from a peer that has no link yet: its candidates can overtake its offer (node-datachannel). */
     private earlyIce;
+    /** Offers from roster members that arrived while the host link was open (see offerVerdict), by sender. */
+    private heldOffers;
     private connected;
     private hiSentTo;
     private epoch;
@@ -137,6 +182,8 @@ export declare class Lobby extends Emitter<LobbyEvents> {
     private lastHeard;
     /** Host: links of kicked / disconnected peers, kept open briefly (removePeer `linger`). */
     private readonly lingering;
+    /** Host: joiners that joined but are not ready yet, with the cancel of their readyTimeoutMs timer (peerFailed). */
+    private notReady;
     /** Host: per-peer fixed window for rateLimit. */
     private rate;
     /**
@@ -203,6 +250,8 @@ export declare class Lobby extends Emitter<LobbyEvents> {
     /** The direct attempt stalled: dial the host ourselves through the TURN relay (a host answers any offer). */
     private retryRelayed;
     private giveUpConnecting;
+    /** @internal A direct host's hub learns where each joiner's link comes from (Nostr kick bans the address too). */
+    linkAddressSink: ((peerId: number, ip: string) => void) | null;
     private makeLink;
     /** Host side: offer to a joiner. */
     private offerTo;
@@ -217,10 +266,20 @@ export declare class Lobby extends Emitter<LobbyEvents> {
     private setHost;
     /** The host is gone (link closed, no frames for 3 s, or the server said so): run the s.9 rule. */
     private handleHostLost;
+    /** Offers that came from roster members while the host link was still open: now the host is lost, answer them. */
+    private replayHeldOffers;
     private becomeHost;
     private onHostClaim;
     private onSignaling;
     private onSignal;
+    /**
+     * Whether an SDP offer from `from` may be answered. The host (or a joiner's host) always may. Direct lobbies have no
+     * migration, so nobody else. In a server lobby a roster member may dial us when we are the host (a claim race decides
+     * who wins) or when our own link to the host is gone (the migration window); while that link is open the offer is
+     * held, to be answered if the host turns out to be lost a moment later.
+     */
+    private offerVerdict;
+    private acceptOffer;
     /**
      * `linger` (host kick / disconnect): stop using the peer's link at once but leave it open until that peer closes it
      * or KICK_LINGER_MS pass. The hub tells the peer over its WebSocket; closing the data link first would make it look
@@ -235,6 +294,8 @@ export declare class Lobby extends Emitter<LobbyEvents> {
     /** peerTimeoutMs: the host drops joiners it has not heard from; a joiner handles a silent host as lost. */
     private dropSilent;
     private pingHost;
+    /** Host: report a joiner that is not ready `readyTimeoutMs` after joining as peerFailed("timeout"), once. */
+    private watchReady;
     private teardown;
     /** Total in-flight links (diagnostics and tests). */
     get linkCount(): number;