@oyna360/lobby-sdk 0.1.0

package/dist/protocol.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Bundled lobby wire protocol — generated from @platform/lobby-protocol.
+ * Do not edit by hand. Run: node scripts/sync-lobby-protocol.mjs
+ * (scale roadmap 9.1)
+ */
+/** Lobby SDK protocol version — keep in sync with @oyna360/lobby-sdk */
+export declare const LOBBY_PROTOCOL_VERSION = "0.1.0";
+export type AvatarPresetKind = 'procedural' | 'glb';
+export interface Vector3 {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface LobbyAvatarConfig {
+    presetId: string;
+    presetKey: string;
+    presetKind: AvatarPresetKind;
+    presetConfig: Record<string, unknown>;
+    customConfig: Record<string, unknown>;
+}
+export interface SdkLobbyAvatar {
+    presetId: string;
+    presetKey: string;
+    presetKind: AvatarPresetKind;
+    customConfig: Record<string, unknown>;
+}
+export type LobbyAnimationState = 'idle' | 'walk' | 'run' | 'jump' | 'fall';
+export type LobbyEmoteKind = 'wave' | 'sit' | 'dance' | 'point';
+export interface LobbyPlayerState {
+    userId: string;
+    username: string;
+    displayName: string;
+    avatar: SdkLobbyAvatar;
+    position: Vector3;
+    rotationY: number;
+    animation: LobbyAnimationState;
+    emote: LobbyEmoteKind | null;
+    updatedAt: number;
+}
+/** Client → Server */
+export interface LobbyJoinMessage {
+    type: 'lobby:join';
+    roomId: string;
+    sessionToken: string;
+    position?: Vector3;
+    rotationY?: number;
+}
+export interface LobbyMoveMessage {
+    type: 'lobby:move';
+    position: Vector3;
+    rotationY: number;
+    animation: LobbyAnimationState;
+    seq: number;
+}
+export interface LobbyEmoteMessage {
+    type: 'lobby:emote';
+    emote: LobbyEmoteKind;
+}
+export interface LobbyLeaveMessage {
+    type: 'lobby:leave';
+}
+export interface LobbyPingMessage {
+    type: 'lobby:ping';
+}
+/** Ephemeral — never persisted. Only players currently in the room see it. */
+export interface LobbyChatMessage {
+    type: 'lobby:chat';
+    text: string;
+}
+/**
+ * Game/app data bus for the lobby room (matchmaking, pad rooms, sync, …).
+ * Not chat — never shown in chat UI. Prefer namespaced channels: `{game}.{feature}`.
+ */
+export interface LobbyDataMessage {
+    type: 'lobby:data';
+    channel: string;
+    payload: string;
+}
+export type LobbyVoiceMode = 'friends' | 'all';
+/** Serializable WebRTC session description (browser RTCSessionDescriptionInit). */
+export interface RtcSessionDescription {
+    type?: 'offer' | 'answer' | 'pranswer' | 'rollback';
+    sdp?: string;
+}
+/** Serializable ICE candidate (browser RTCIceCandidateInit). */
+export interface RtcIceCandidate {
+    candidate?: string;
+    sdpMid?: string | null;
+    sdpMLineIndex?: number | null;
+    usernameFragment?: string | null;
+}
+export interface LobbyVoiceJoinMessage {
+    type: 'lobby:voice:join';
+    mode: LobbyVoiceMode;
+}
+export interface LobbyVoiceLeaveMessage {
+    type: 'lobby:voice:leave';
+}
+export interface LobbyVoiceMuteMessage {
+    type: 'lobby:voice:mute';
+    muted: boolean;
+}
+export interface LobbyVoiceOfferMessage {
+    type: 'lobby:voice:offer';
+    toUserId: string;
+    sdp: RtcSessionDescription;
+}
+export interface LobbyVoiceAnswerMessage {
+    type: 'lobby:voice:answer';
+    toUserId: string;
+    sdp: RtcSessionDescription;
+}
+export interface LobbyVoiceIceMessage {
+    type: 'lobby:voice:ice';
+    toUserId: string;
+    candidate: RtcIceCandidate;
+}
+export declare const LOBBY_CHAT_MAX_LEN = 140;
+/** Max payload bytes for lobby:data (game control / sync). Independent of chat. */
+export declare const LOBBY_DATA_MAX_LEN = 512;
+export declare const LOBBY_DATA_CHANNEL_MAX_LEN = 64;
+export declare function sanitizeLobbyChat(text: unknown): string | null;
+/** Validate data channel id. Does not apply chat sanitization. */
+export declare function sanitizeLobbyDataChannel(channel: unknown): string | null;
+/**
+ * Validate data payload. Strips only dangerous control chars; preserves framing spaces.
+ * Does not trim or slice like chat.
+ */
+export declare function sanitizeLobbyDataPayload(payload: unknown): string | null;
+export type LobbyClientMessage = LobbyJoinMessage | LobbyMoveMessage | LobbyEmoteMessage | LobbyLeaveMessage | LobbyPingMessage | LobbyChatMessage | LobbyDataMessage | LobbyVoiceJoinMessage | LobbyVoiceLeaveMessage | LobbyVoiceMuteMessage | LobbyVoiceOfferMessage | LobbyVoiceAnswerMessage | LobbyVoiceIceMessage;
+/** Server → Client */
+export interface LobbyVoicePeerState {
+    userId: string;
+    username?: string;
+    mode: LobbyVoiceMode;
+    muted: boolean;
+}
+export interface LobbyFeatureFlags {
+    chatEnabled: boolean;
+    voiceEnabled: boolean;
+    chatAllowed: boolean;
+    voiceAllowed: boolean;
+    /**
+     * Game data channel (`lobby:data`). Omitted / undefined ⇒ enabled.
+     * Independent of chat — matchmaking must work when chat is banned/disabled.
+     */
+    dataEnabled?: boolean;
+    dataAllowed?: boolean;
+}
+export interface LobbyWelcomeMessage {
+    type: 'lobby:welcome';
+    roomId: string;
+    self: LobbyPlayerState;
+    players: LobbyPlayerState[];
+    maxPlayers: number;
+    /** Server protocol version (scale roadmap 9.4). */
+    protocolVersion: string;
+    /** Accepted friend user ids for voice filtering (friends mode). */
+    friendUserIds?: string[];
+    voicePeers?: LobbyVoicePeerState[];
+    lobbyFeatures?: LobbyFeatureFlags;
+}
+export interface LobbyStateMessage {
+    type: 'lobby:state';
+    players: LobbyPlayerState[];
+}
+export interface LobbyPlayerJoinedMessage {
+    type: 'lobby:player:joined';
+    player: LobbyPlayerState;
+}
+export interface LobbyPlayerLeftMessage {
+    type: 'lobby:player:left';
+    userId: string;
+    username?: string;
+    displayName?: string;
+}
+export interface LobbyPlayerMovedMessage {
+    type: 'lobby:player:moved';
+    userId: string;
+    position: Vector3;
+    rotationY: number;
+    animation: LobbyAnimationState;
+    seq: number;
+    serverTime: number;
+}
+/** Batched moves for a room tick (scale roadmap 4.1). Fields may be omitted when unchanged (4.3 delta). */
+export interface LobbyPlayersMovedMessage {
+    type: 'lobby:players:moved';
+    moves: Array<{
+        userId: string;
+        position?: Vector3;
+        rotationY?: number;
+        animation?: LobbyAnimationState;
+        seq: number;
+    }>;
+    serverTime: number;
+}
+export interface LobbyPlayerEmoteMessage {
+    type: 'lobby:player:emote';
+    userId: string;
+    emote: LobbyEmoteKind;
+}
+export interface LobbyErrorMessage {
+    type: 'lobby:error';
+    code: string;
+    message: string;
+}
+export interface LobbyPongMessage {
+    type: 'lobby:pong';
+}
+export interface LobbyChatBroadcastMessage {
+    type: 'lobby:chat';
+    userId: string;
+    username?: string;
+    displayName: string;
+    text: string;
+    at: number;
+}
+export interface LobbyDataBroadcastMessage {
+    type: 'lobby:data';
+    userId: string;
+    username?: string;
+    displayName?: string;
+    channel: string;
+    payload: string;
+    at: number;
+}
+export interface LobbyVoiceStateMessage {
+    type: 'lobby:voice:state';
+    peers: LobbyVoicePeerState[];
+    friendUserIds: string[];
+}
+export interface LobbyVoiceJoinedMessage {
+    type: 'lobby:voice:joined';
+    peer: LobbyVoicePeerState;
+}
+export interface LobbyVoiceLeftMessage {
+    type: 'lobby:voice:left';
+    userId: string;
+}
+export interface LobbyVoiceMuteBroadcastMessage {
+    type: 'lobby:voice:mute';
+    userId: string;
+    muted: boolean;
+}
+export interface LobbyVoiceOfferBroadcastMessage {
+    type: 'lobby:voice:offer';
+    fromUserId: string;
+    sdp: RtcSessionDescription;
+}
+export interface LobbyVoiceAnswerBroadcastMessage {
+    type: 'lobby:voice:answer';
+    fromUserId: string;
+    sdp: RtcSessionDescription;
+}
+export interface LobbyVoiceIceBroadcastMessage {
+    type: 'lobby:voice:ice';
+    fromUserId: string;
+    candidate: RtcIceCandidate;
+}
+export type LobbyServerMessage = LobbyWelcomeMessage | LobbyStateMessage | LobbyPlayerJoinedMessage | LobbyPlayerLeftMessage | LobbyPlayerMovedMessage | LobbyPlayersMovedMessage | LobbyPlayerEmoteMessage | LobbyChatBroadcastMessage | LobbyDataBroadcastMessage | LobbyVoiceStateMessage | LobbyVoiceJoinedMessage | LobbyVoiceLeftMessage | LobbyVoiceMuteBroadcastMessage | LobbyVoiceOfferBroadcastMessage | LobbyVoiceAnswerBroadcastMessage | LobbyVoiceIceBroadcastMessage | LobbyErrorMessage | LobbyPongMessage;
+export declare function parseLobbyClientMessage(data: unknown): LobbyClientMessage | null;
+/** Build per-game room id */
+export declare function gameRoomId(gameSlug: string, instance?: number): string;
+/** Global avatar hub room (phase 7) */
+export declare const GLOBAL_AVATAR_ROOM_ID = "global:avatars";
+export declare function isGlobalAvatarRoom(roomId: string): boolean;
+/**
+ * Best-effort slug from a room id. Slugs may contain hyphens (`game:fall-cars-2`),
+ * so a trailing `-<digits>` is read as an instance suffix. Ambiguous for slugs that
+ * genuinely end in `-<digits>` — prefer `isRoomForGame` when the slug is known.
+ */
+export declare function parseGameSlugFromRoom(roomId: string): string | null;
+/** True when roomId is the base room or a numbered instance of gameSlug. */
+export declare function isRoomForGame(roomId: string, gameSlug: string): boolean;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js

@@ -0,0 +1,107 @@
+/**
+ * Bundled lobby wire protocol — generated from @platform/lobby-protocol.
+ * Do not edit by hand. Run: node scripts/sync-lobby-protocol.mjs
+ * (scale roadmap 9.1)
+ */
+/** Lobby SDK protocol version — keep in sync with @oyna360/lobby-sdk */
+export const LOBBY_PROTOCOL_VERSION = '0.1.0';
+export const LOBBY_CHAT_MAX_LEN = 140;
+/** Max payload bytes for lobby:data (game control / sync). Independent of chat. */
+export const LOBBY_DATA_MAX_LEN = 512;
+export const LOBBY_DATA_CHANNEL_MAX_LEN = 64;
+const LOBBY_DATA_CHANNEL_RE = /^[a-zA-Z0-9._-]+$/;
+export function sanitizeLobbyChat(text) {
+    if (typeof text !== 'string')
+        return null;
+    const cleaned = text.replace(/[\u0000-\u001F\u007F]/g, '').replace(/\s+/g, ' ').trim();
+    if (!cleaned)
+        return null;
+    return cleaned.slice(0, LOBBY_CHAT_MAX_LEN);
+}
+/** Validate data channel id. Does not apply chat sanitization. */
+export function sanitizeLobbyDataChannel(channel) {
+    if (typeof channel !== 'string')
+        return null;
+    const cleaned = channel.trim();
+    if (!cleaned || cleaned.length > LOBBY_DATA_CHANNEL_MAX_LEN)
+        return null;
+    if (!LOBBY_DATA_CHANNEL_RE.test(cleaned))
+        return null;
+    return cleaned;
+}
+/**
+ * Validate data payload. Strips only dangerous control chars; preserves framing spaces.
+ * Does not trim or slice like chat.
+ */
+export function sanitizeLobbyDataPayload(payload) {
+    if (typeof payload !== 'string')
+        return null;
+    if (!payload || payload.length > LOBBY_DATA_MAX_LEN)
+        return null;
+    const cleaned = payload.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, '');
+    if (!cleaned || cleaned.length > LOBBY_DATA_MAX_LEN)
+        return null;
+    return cleaned;
+}
+export function parseLobbyClientMessage(data) {
+    if (!data || typeof data !== 'object')
+        return null;
+    const type = data.type;
+    switch (type) {
+        case 'lobby:join':
+        case 'lobby:move':
+        case 'lobby:emote':
+        case 'lobby:leave':
+        case 'lobby:ping':
+        case 'lobby:chat':
+        case 'lobby:data':
+        case 'lobby:voice:join':
+        case 'lobby:voice:leave':
+        case 'lobby:voice:mute':
+        case 'lobby:voice:offer':
+        case 'lobby:voice:answer':
+        case 'lobby:voice:ice':
+            return data;
+        default:
+            return null;
+    }
+}
+/** Build per-game room id */
+export function gameRoomId(gameSlug, instance = 1) {
+    return instance <= 1 ? `game:${gameSlug}` : `game:${gameSlug}-${instance}`;
+}
+/** Global avatar hub room (phase 7) */
+export const GLOBAL_AVATAR_ROOM_ID = 'global:avatars';
+export function isGlobalAvatarRoom(roomId) {
+    return roomId === GLOBAL_AVATAR_ROOM_ID;
+}
+const GAME_ROOM_PREFIX = 'game:';
+/**
+ * Best-effort slug from a room id. Slugs may contain hyphens (`game:fall-cars-2`),
+ * so a trailing `-<digits>` is read as an instance suffix. Ambiguous for slugs that
+ * genuinely end in `-<digits>` — prefer `isRoomForGame` when the slug is known.
+ */
+export function parseGameSlugFromRoom(roomId) {
+    if (roomId === GLOBAL_AVATAR_ROOM_ID)
+        return 'avatar-hub';
+    if (!roomId.startsWith(GAME_ROOM_PREFIX))
+        return null;
+    const rest = roomId.slice(GAME_ROOM_PREFIX.length);
+    if (!rest)
+        return null;
+    const instanced = /^(.+)-(\d+)$/.exec(rest);
+    return instanced ? instanced[1] : rest;
+}
+/** True when roomId is the base room or a numbered instance of gameSlug. */
+export function isRoomForGame(roomId, gameSlug) {
+    if (!gameSlug)
+        return false;
+    if (roomId === gameRoomId(gameSlug))
+        return true;
+    const prefix = `${GAME_ROOM_PREFIX}${gameSlug}-`;
+    if (!roomId.startsWith(prefix))
+        return false;
+    const instance = roomId.slice(prefix.length);
+    return /^\d+$/.test(instance) && Number(instance) > 1;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/quality.d.ts

@@ -0,0 +1,39 @@
+export type LobbyQualityLevel = 'low' | 'medium' | 'high';
+export interface LobbyQualitySettings {
+    pixelRatioCap: number;
+    antialias: boolean;
+    bloom: boolean;
+    bloomKernel: number;
+    bloomWeight: number;
+    fxaa: boolean;
+}
+export declare const LOBBY_QUALITY: Record<LobbyQualityLevel, LobbyQualitySettings>;
+export declare function isTouchDevice(): boolean;
+/** Lobby is lighter than a full match — mobile never starts on the desktop "high" preset. */
+export declare function detectLobbyQuality(): LobbyQualityLevel;
+export declare function resolveLobbyQuality(quality: LobbyQualityLevel | 'auto' | undefined): LobbyQualityLevel;
+export declare function lobbyQualitySettings(quality: LobbyQualityLevel | 'auto' | undefined): LobbyQualitySettings;
+/**
+ * Extra PBR maps are ~10MB VRAM each unique body. Phones and crowded rooms
+ * cannot hold that for dozens of players — albedo alone is enough at lobby scale.
+ */
+export declare function shouldTrimAvatarDetailMaps(opts: {
+    quality: LobbyQualityLevel;
+    touch: boolean;
+    avatarCount: number;
+}): boolean;
+export declare function shouldDisableLobbyBloom(opts: {
+    quality: LobbyQualityLevel;
+    touch: boolean;
+    avatarCount: number;
+}): boolean;
+/** Distance bands for remote avatar animation cadence (simple, not a LOD system). */
+export declare const LOBBY_AVATAR_ANIM_FULL_DIST = 20;
+export declare const LOBBY_AVATAR_ANIM_HALF_DIST = 34;
+export declare const LOBBY_AVATAR_ANIM_QUARTER_DIST = 48;
+/**
+ * How many frames between remote bone/anim updates.
+ * Near avatars stay at 1; far ones skip work without changing movement sync.
+ */
+export declare function remoteAvatarAnimStride(distSq: number): number;
+//# sourceMappingURL=quality.d.ts.map

package/dist/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../src/quality.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAyBzE,CAAC;AAEF,wBAAgB,aAAa,IAAI,OAAO,CAKvC;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,IAAI,iBAAiB,CAUtD;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAC9C,iBAAiB,CAGnB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAC9C,oBAAoB,CAEtB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAKV;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAIV;AAED,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7D"}

package/dist/quality.js

@@ -0,0 +1,95 @@
+export const LOBBY_QUALITY = {
+    low: {
+        pixelRatioCap: 1,
+        antialias: false,
+        bloom: false,
+        bloomKernel: 24,
+        bloomWeight: 0.12,
+        fxaa: true,
+    },
+    medium: {
+        pixelRatioCap: 1.5,
+        antialias: true,
+        bloom: true,
+        bloomKernel: 28,
+        bloomWeight: 0.14,
+        fxaa: false,
+    },
+    high: {
+        pixelRatioCap: 2,
+        antialias: true,
+        bloom: true,
+        bloomKernel: 32,
+        bloomWeight: 0.18,
+        fxaa: false,
+    },
+};
+export function isTouchDevice() {
+    if (typeof navigator !== 'undefined' && navigator.maxTouchPoints > 0)
+        return true;
+    if (typeof window !== 'undefined' && 'ontouchstart' in window)
+        return true;
+    if (typeof window !== 'undefined' && window.matchMedia('(pointer: coarse)').matches)
+        return true;
+    return false;
+}
+/** Lobby is lighter than a full match — mobile never starts on the desktop "high" preset. */
+export function detectLobbyQuality() {
+    if (typeof window === 'undefined')
+        return 'medium';
+    const cores = navigator.hardwareConcurrency ?? 4;
+    const memory = navigator.deviceMemory ?? 4;
+    if (isTouchDevice()) {
+        if (memory <= 2 || cores <= 4)
+            return 'low';
+        return 'medium';
+    }
+    if (cores >= 8 && memory >= 8)
+        return 'high';
+    return 'medium';
+}
+export function resolveLobbyQuality(quality) {
+    if (quality && quality !== 'auto')
+        return quality;
+    return detectLobbyQuality();
+}
+export function lobbyQualitySettings(quality) {
+    return LOBBY_QUALITY[resolveLobbyQuality(quality)];
+}
+/**
+ * Extra PBR maps are ~10MB VRAM each unique body. Phones and crowded rooms
+ * cannot hold that for dozens of players — albedo alone is enough at lobby scale.
+ */
+export function shouldTrimAvatarDetailMaps(opts) {
+    if (opts.quality === 'low')
+        return true;
+    if (opts.touch)
+        return true;
+    // Unique Meshy bodies burn VRAM fast once a few different presets show up.
+    return opts.avatarCount >= 6;
+}
+export function shouldDisableLobbyBloom(opts) {
+    if (opts.quality === 'low')
+        return true;
+    if (opts.touch && opts.avatarCount >= 4)
+        return true;
+    return opts.avatarCount >= 10;
+}
+/** Distance bands for remote avatar animation cadence (simple, not a LOD system). */
+export const LOBBY_AVATAR_ANIM_FULL_DIST = 20;
+export const LOBBY_AVATAR_ANIM_HALF_DIST = 34;
+export const LOBBY_AVATAR_ANIM_QUARTER_DIST = 48;
+/**
+ * How many frames between remote bone/anim updates.
+ * Near avatars stay at 1; far ones skip work without changing movement sync.
+ */
+export function remoteAvatarAnimStride(distSq) {
+    if (distSq <= LOBBY_AVATAR_ANIM_FULL_DIST * LOBBY_AVATAR_ANIM_FULL_DIST)
+        return 1;
+    if (distSq <= LOBBY_AVATAR_ANIM_HALF_DIST * LOBBY_AVATAR_ANIM_HALF_DIST)
+        return 2;
+    if (distSq <= LOBBY_AVATAR_ANIM_QUARTER_DIST * LOBBY_AVATAR_ANIM_QUARTER_DIST)
+        return 3;
+    return 4;
+}
+//# sourceMappingURL=quality.js.map

package/dist/quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.js","sourceRoot":"","sources":["../src/quality.ts"],"names":[],"mappings":"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"}

package/dist/remote-player-manager.d.ts

@@ -0,0 +1,48 @@
+import type { Scene } from '@babylonjs/core';
+import type { LobbyAnimationState, LobbyEmoteKind, LobbyPlayerState } from './protocol';
+import { type RemoteAvatarLifecycle } from './avatar-instance';
+export declare class RemotePlayerManager {
+    private readonly scene;
+    private readonly selfUserId;
+    private readonly remotes;
+    /** userId → in-flight generation (also used as "loading" flag). */
+    private readonly loadingGen;
+    private generationSeq;
+    constructor(scene: Scene, selfUserId: string);
+    upsert(player: LobbyPlayerState): void;
+    private spawnRemote;
+    private isSpawnCurrent;
+    applyMove(payload: {
+        userId: string;
+        position?: LobbyPlayerState['position'];
+        rotationY?: number;
+        animation?: LobbyAnimationState;
+    }): void;
+    applyEmote(userId: string, emote: LobbyEmoteKind): void;
+    remove(userId: string): void;
+    getIdentity(userId: string): {
+        displayName: string;
+        username: string;
+    } | null;
+    isRemoteReady(userId: string): boolean;
+    getLifecycle(userId: string): RemoteAvatarLifecycle;
+    private setDrawVisible;
+    update(dt: number): void;
+    getPosition(userId: string): LobbyPlayerState['position'] | null;
+    list(): {
+        userId: string;
+        displayName: string;
+        avatar: import("./protocol").SdkLobbyAvatar;
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        rotationY: number;
+        animation: LobbyAnimationState;
+        ready: boolean;
+        lifecycle: RemoteAvatarLifecycle;
+    }[];
+    dispose(): void;
+}
+//# sourceMappingURL=remote-player-manager.d.ts.map

package/dist/remote-player-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-player-manager.d.ts","sourceRoot":"","sources":["../src/remote-player-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGxF,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAkE/E,qBAAa,mBAAmB;IAO5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAP7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,aAAa,CAAK;gBAGP,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM;IAGrC,MAAM,CAAC,MAAM,EAAE,gBAAgB;YAmBjB,WAAW;IA2IzB,OAAO,CAAC,cAAc;IAItB,SAAS,CAAC,OAAO,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,mBAAmB,CAAC;KACjC;IASD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc;IAMhD,MAAM,CAAC,MAAM,EAAE,MAAM;IAWrB,WAAW,CAAC,MAAM,EAAE,MAAM;;;;IAS1B,aAAa,CAAC,MAAM,EAAE,MAAM;IAK5B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAInD,OAAO,CAAC,cAAc;IAStB,MAAM,CAAC,EAAE,EAAE,MAAM;IAkEjB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,GAAG,IAAI;IAMhE,IAAI;;;;;;;;;;;;;;IAaJ,OAAO;CASR"}