@oyna360/lobby-sdk 0.1.0

package/dist/voice-chat.js

@@ -0,0 +1,321 @@
+const ICE_SERVERS = [
+    { urls: 'stun:stun.l.google.com:19302' },
+    { urls: 'stun:stun1.l.google.com:19302' },
+];
+/** Default mesh cap — keep in sync with server LOBBY_VOICE_PEER_CAP (roadmap 3.4). */
+export const DEFAULT_VOICE_PEER_CAP = 6;
+export class LobbyVoiceChat {
+    signaling;
+    localStream = null;
+    peers = new Map();
+    remoteAudio = new Map();
+    voicePeers = new Map();
+    /** Peers we created an offer toward (vs inbound-only). */
+    offerInitiated = new Set();
+    active = false;
+    mode = 'friends';
+    micMuted = false;
+    selfUserId = '';
+    friendIds = new Set();
+    listeners = new Set();
+    disposed = false;
+    peerCap = DEFAULT_VOICE_PEER_CAP;
+    getPosition = null;
+    lastMeshRefreshMs = 0;
+    constructor(signaling) {
+        this.signaling = signaling;
+    }
+    onStateChange(listener) {
+        this.listeners.add(listener);
+        listener(this.snapshot());
+        return () => this.listeners.delete(listener);
+    }
+    setContext(selfUserId, friendUserIds) {
+        this.selfUserId = selfUserId;
+        this.friendIds = new Set(friendUserIds);
+    }
+    /** Optional world positions for nearest-N mesh selection. */
+    setPositionProvider(fn) {
+        this.getPosition = fn;
+    }
+    setPeerCap(cap) {
+        this.peerCap = Math.max(1, Math.floor(cap));
+    }
+    getState() {
+        return this.snapshot();
+    }
+    /**
+     * Re-evaluate nearest peers (e.g. after movement). Throttled to ~2Hz by default.
+     */
+    refreshMesh(force = false) {
+        if (!this.active || this.disposed)
+            return;
+        const now = performance.now();
+        if (!force && now - this.lastMeshRefreshMs < 500)
+            return;
+        this.lastMeshRefreshMs = now;
+        void this.syncPeerConnections(true);
+    }
+    async enable(mode) {
+        if (this.disposed || this.active)
+            return;
+        if (!navigator.mediaDevices?.getUserMedia) {
+            throw new Error('Microphone is not supported in this browser');
+        }
+        this.mode = mode;
+        this.localStream = await navigator.mediaDevices.getUserMedia({
+            audio: {
+                echoCancellation: true,
+                noiseSuppression: true,
+                autoGainControl: true,
+            },
+            video: false,
+        });
+        this.applyMicTrackState();
+        this.active = true;
+        this.emitState();
+        this.signaling.sendJoin(mode);
+    }
+    async disable() {
+        if (!this.active)
+            return;
+        this.signaling.sendLeave();
+        this.teardownPeers();
+        this.stopLocalStream();
+        this.active = false;
+        this.voicePeers.clear();
+        this.emitState();
+    }
+    async setMode(mode) {
+        if (!this.active) {
+            this.mode = mode;
+            this.emitState();
+            return;
+        }
+        if (mode === this.mode)
+            return;
+        await this.disable();
+        await this.enable(mode);
+    }
+    setMicMuted(muted) {
+        this.micMuted = muted;
+        this.applyMicTrackState();
+        if (this.active)
+            this.signaling.sendMute(muted);
+        this.emitState();
+    }
+    toggleMicMuted() {
+        this.setMicMuted(!this.micMuted);
+    }
+    handleVoiceState(peers, friendUserIds) {
+        this.friendIds = new Set(friendUserIds);
+        this.voicePeers.clear();
+        for (const peer of peers) {
+            if (peer.userId === this.selfUserId)
+                continue;
+            this.voicePeers.set(peer.userId, peer);
+        }
+        if (!this.active)
+            return;
+        void this.syncPeerConnections(true);
+        this.emitState();
+    }
+    handleVoiceJoined(peer) {
+        if (peer.userId === this.selfUserId)
+            return;
+        this.voicePeers.set(peer.userId, peer);
+        if (!this.active)
+            return;
+        // Existing participants wait for offers from the joiner.
+        this.emitState();
+    }
+    handleVoiceLeft(userId) {
+        this.voicePeers.delete(userId);
+        this.closePeer(userId);
+        this.emitState();
+    }
+    handleVoiceMute(userId, muted) {
+        const peer = this.voicePeers.get(userId);
+        if (!peer)
+            return;
+        peer.muted = muted;
+        const audio = this.remoteAudio.get(userId);
+        if (audio)
+            audio.muted = muted;
+    }
+    async handleOffer(fromUserId, sdp) {
+        if (!this.active || fromUserId === this.selfUserId)
+            return;
+        const peerState = this.voicePeers.get(fromUserId);
+        // Mode gate only — accept inbound offers outside nearest-N (asymmetric mesh).
+        if (!peerState || !this.canConnectTo(peerState))
+            return;
+        const pc = await this.ensurePeer(fromUserId);
+        await pc.setRemoteDescription(sdp);
+        const answer = await pc.createAnswer();
+        await pc.setLocalDescription(answer);
+        if (pc.localDescription) {
+            this.signaling.sendAnswer(fromUserId, pc.localDescription);
+        }
+    }
+    async handleAnswer(fromUserId, sdp) {
+        const pc = this.peers.get(fromUserId);
+        if (!pc)
+            return;
+        await pc.setRemoteDescription(sdp);
+    }
+    async handleIce(fromUserId, candidate) {
+        const pc = this.peers.get(fromUserId);
+        if (!pc || !candidate.candidate)
+            return;
+        try {
+            await pc.addIceCandidate(candidate);
+        }
+        catch {
+            // Ignore late ICE after close.
+        }
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        void this.disable();
+        this.listeners.clear();
+    }
+    async syncPeerConnections(asOfferer) {
+        const meshIds = this.nearestEligiblePeerIds();
+        for (const userId of [...this.peers.keys()]) {
+            const peer = this.voicePeers.get(userId);
+            if (!peer || !this.canConnectTo(peer)) {
+                this.closePeer(userId);
+                continue;
+            }
+            // Drop outbound links that fell outside nearest-N; keep inbound replies.
+            if (!meshIds.has(userId) && this.offerInitiated.has(userId)) {
+                this.closePeer(userId);
+            }
+        }
+        for (const peer of this.voicePeers.values()) {
+            if (!meshIds.has(peer.userId))
+                continue;
+            if (asOfferer && !this.peers.has(peer.userId)) {
+                await this.createOffer(peer.userId);
+            }
+        }
+    }
+    canConnectTo(peer) {
+        if (peer.userId === this.selfUserId)
+            return false;
+        const iAllow = this.mode === 'all' || this.friendIds.has(peer.userId);
+        const theyAllow = peer.mode === 'all' || this.friendIds.has(this.selfUserId);
+        return iAllow && theyAllow;
+    }
+    nearestEligiblePeerIds() {
+        const eligible = [...this.voicePeers.values()].filter((p) => this.canConnectTo(p));
+        if (eligible.length <= this.peerCap) {
+            return new Set(eligible.map((p) => p.userId));
+        }
+        const selfPos = this.getPosition?.(this.selfUserId) ?? null;
+        const ranked = eligible.map((peer) => {
+            const pos = this.getPosition?.(peer.userId);
+            let dist = Number.POSITIVE_INFINITY;
+            if (selfPos && pos) {
+                const dx = pos.x - selfPos.x;
+                const dz = pos.z - selfPos.z;
+                dist = Math.hypot(dx, dz);
+            }
+            return { userId: peer.userId, dist };
+        });
+        ranked.sort((a, b) => a.dist - b.dist || a.userId.localeCompare(b.userId));
+        return new Set(ranked.slice(0, this.peerCap).map((r) => r.userId));
+    }
+    async createOffer(userId) {
+        this.offerInitiated.add(userId);
+        const pc = await this.ensurePeer(userId);
+        const offer = await pc.createOffer();
+        await pc.setLocalDescription(offer);
+        if (pc.localDescription) {
+            this.signaling.sendOffer(userId, pc.localDescription);
+        }
+    }
+    async ensurePeer(userId) {
+        const existing = this.peers.get(userId);
+        if (existing)
+            return existing;
+        const pc = new RTCPeerConnection({ iceServers: ICE_SERVERS });
+        this.peers.set(userId, pc);
+        pc.onicecandidate = (event) => {
+            if (event.candidate) {
+                this.signaling.sendIce(userId, event.candidate.toJSON());
+            }
+        };
+        pc.ontrack = (event) => {
+            const [stream] = event.streams;
+            if (!stream)
+                return;
+            let audio = this.remoteAudio.get(userId);
+            if (!audio) {
+                audio = document.createElement('audio');
+                audio.autoplay = true;
+                audio.setAttribute('playsinline', 'true');
+                audio.style.display = 'none';
+                document.body.append(audio);
+                this.remoteAudio.set(userId, audio);
+            }
+            audio.srcObject = stream;
+            const peer = this.voicePeers.get(userId);
+            if (peer)
+                audio.muted = peer.muted;
+        };
+        pc.onconnectionstatechange = () => {
+            if (pc.connectionState === 'failed' || pc.connectionState === 'closed') {
+                this.closePeer(userId);
+            }
+        };
+        if (this.localStream) {
+            for (const track of this.localStream.getTracks()) {
+                pc.addTrack(track, this.localStream);
+            }
+        }
+        return pc;
+    }
+    closePeer(userId) {
+        this.peers.get(userId)?.close();
+        this.peers.delete(userId);
+        this.offerInitiated.delete(userId);
+        const audio = this.remoteAudio.get(userId);
+        if (audio) {
+            audio.srcObject = null;
+            audio.remove();
+        }
+        this.remoteAudio.delete(userId);
+    }
+    teardownPeers() {
+        for (const userId of [...this.peers.keys()])
+            this.closePeer(userId);
+    }
+    stopLocalStream() {
+        for (const track of this.localStream?.getTracks() ?? [])
+            track.stop();
+        this.localStream = null;
+    }
+    applyMicTrackState() {
+        for (const track of this.localStream?.getAudioTracks() ?? []) {
+            track.enabled = !this.micMuted;
+        }
+    }
+    snapshot() {
+        return {
+            active: this.active,
+            mode: this.mode,
+            muted: this.micMuted,
+            peerCount: this.peers.size,
+        };
+    }
+    emitState() {
+        const state = this.snapshot();
+        for (const listener of this.listeners)
+            listener(state);
+    }
+}
+//# sourceMappingURL=voice-chat.js.map

package/dist/voice-chat.js.map

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

package/dist/yield-to-render.d.ts

@@ -0,0 +1,3 @@
+/** Yield so the Babylon render loop can paint (placeholder / prior frame) before heavy sync work. */
+export declare function yieldToRenderLoop(): Promise<void>;
+//# sourceMappingURL=yield-to-render.d.ts.map

package/dist/yield-to-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield-to-render.d.ts","sourceRoot":"","sources":["../src/yield-to-render.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQjD"}

package/dist/yield-to-render.js

@@ -0,0 +1,11 @@
+/** Yield so the Babylon render loop can paint (placeholder / prior frame) before heavy sync work. */
+export function yieldToRenderLoop() {
+    return new Promise((resolve) => {
+        if (typeof requestAnimationFrame === 'function') {
+            requestAnimationFrame(() => requestAnimationFrame(() => resolve()));
+            return;
+        }
+        setTimeout(resolve, 0);
+    });
+}
+//# sourceMappingURL=yield-to-render.js.map

package/dist/yield-to-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yield-to-render.js","sourceRoot":"","sources":["../src/yield-to-render.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,OAAO,qBAAqB,KAAK,UAAU,EAAE,CAAC;YAChD,qBAAqB,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/zones.d.ts

@@ -0,0 +1,36 @@
+import type { Vector3 } from './types';
+export declare class ZoneManager {
+    private readonly zones;
+    addZone(options: {
+        id: string;
+        bounds: {
+            min: Vector3;
+            max: Vector3;
+        };
+        onEnter?: (playerId: string) => void;
+        onExit?: (playerId: string) => void;
+    }): void;
+    updatePlayer(playerId: string, position: Vector3): void;
+    private isInside;
+    clear(): void;
+}
+export declare class PortalManager {
+    private readonly portals;
+    /** Registers a portal. Hits fire `onTrigger` only — no browser navigation. */
+    addPortal(options: {
+        id: string;
+        position: Vector3;
+        radius?: number;
+        toGameSlug?: string;
+        toScene?: string;
+        onTrigger?: () => void;
+    }): void;
+    updatePlayer(playerId: string, position: Vector3): Array<{
+        portalId: string;
+        toGameSlug?: string;
+        toScene?: string;
+        onTrigger?: () => void;
+    }>;
+    clear(): void;
+}
+//# sourceMappingURL=zones.d.ts.map

package/dist/zones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zones.d.ts","sourceRoot":"","sources":["../src/zones.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAMd;IAER,OAAO,CAAC,OAAO,EAAE;QACf,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE;YAAE,GAAG,EAAE,OAAO,CAAC;YAAC,GAAG,EAAE,OAAO,CAAA;SAAE,CAAC;QACvC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QACrC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;KACrC;IAID,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;IAehD,OAAO,CAAC,QAAQ;IAWhB,KAAK;CAGN;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAQhB;IAER,8EAA8E;IAC9E,SAAS,CAAC,OAAO,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;KACxB;IAQD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC;QACvD,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;KACxB,CAAC;IA8BF,KAAK;CAGN"}

package/dist/zones.js

@@ -0,0 +1,68 @@
+export class ZoneManager {
+    zones = [];
+    addZone(options) {
+        this.zones.push({ ...options, inside: new Set() });
+    }
+    updatePlayer(playerId, position) {
+        for (const zone of this.zones) {
+            const inside = this.isInside(position, zone.bounds);
+            const wasInside = zone.inside.has(playerId);
+            if (inside && !wasInside) {
+                zone.inside.add(playerId);
+                zone.onEnter?.(playerId);
+            }
+            else if (!inside && wasInside) {
+                zone.inside.delete(playerId);
+                zone.onExit?.(playerId);
+            }
+        }
+    }
+    isInside(pos, bounds) {
+        return (pos.x >= bounds.min.x &&
+            pos.x <= bounds.max.x &&
+            pos.y >= bounds.min.y &&
+            pos.y <= bounds.max.y &&
+            pos.z >= bounds.min.z &&
+            pos.z <= bounds.max.z);
+    }
+    clear() {
+        this.zones.length = 0;
+    }
+}
+export class PortalManager {
+    portals = [];
+    /** Registers a portal. Hits fire `onTrigger` only — no browser navigation. */
+    addPortal(options) {
+        this.portals.push({
+            ...options,
+            radius: options.radius ?? 1.5,
+            triggered: new Set(),
+        });
+    }
+    updatePlayer(playerId, position) {
+        const hits = [];
+        for (const portal of this.portals) {
+            const dx = position.x - portal.position.x;
+            const dz = position.z - portal.position.z;
+            const dist = Math.hypot(dx, dz);
+            const inside = dist <= portal.radius;
+            if (inside && !portal.triggered.has(playerId)) {
+                portal.triggered.add(playerId);
+                hits.push({
+                    portalId: portal.id,
+                    toGameSlug: portal.toGameSlug,
+                    toScene: portal.toScene,
+                    onTrigger: portal.onTrigger,
+                });
+            }
+            else if (!inside) {
+                portal.triggered.delete(playerId);
+            }
+        }
+        return hits;
+    }
+    clear() {
+        this.portals.length = 0;
+    }
+}
+//# sourceMappingURL=zones.js.map

package/dist/zones.js.map

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

package/docs/00-overview.md

@@ -0,0 +1,47 @@
+# نمای کلی — `@oyna360/lobby-sdk`
+
+برای بازی‌سازی که می‌خواهد **لابی ۳D مشترک** قبل از مسابقه داشته باشد.
+
+---
+
+## مسئولیت‌ها
+
+| این SDK | پلتفرم / game-sdk | بازی شما |
+|---------|-------------------|----------|
+| رندر لابی، آواتار، حرکت | هویت، سشن، `platform:init` / Direct Auth | تم، پورتال، قوانین شروع مسابقه |
+| WebSocket `/lobby` | ساخت اتاق و اعتبار سشن | سرور گیم‌پلی بعد از `destroy()` |
+| چت / voice لابی | فلگ‌ها و moderation سمت سرور | UI اختصاصی مسابقه |
+
+**لاگین و Authorize کار lobby-sdk نیست.** همیشه Context را از game-sdk یا parent پلتفرم بگیرید.
+
+---
+
+## وابستگی‌ها
+
+- peer: `@babylonjs/core` ^7
+- همراه پکیج: `socket.io-client`, `@babylonjs/loaders`
+- پروتکل پیام‌ها داخل `dist` bundle شده
+
+---
+
+## جریان کلی
+
+```text
+PlatformSDK.init()  →  SdkInitPayload (user, session, avatar, lobby)
+        ↓
+PlatformLobby.create({ platformInit, wsUrl, roomId })
+        ↓
+بازیکن در لابی حرکت / چت می‌کند
+        ↓
+پورتال یا شمارش اتاق → callback شما
+        ↓
+lobby.destroy() → گیم‌پلی خودتان
+```
+
+---
+
+## چه چیزهایی export می‌شود؟
+
+علاوه بر `PlatformLobby`: کارخانه آواتار، انیماتور، دوربین، collider، pluginهای نمونه، ابزار diag — برای سفارشی‌سازی پیشرفته. برای اکثر بازی‌ها همان `PlatformLobby` کافی است.
+
+بعدی: [01-connect.md](./01-connect.md)

package/docs/01-connect.md

@@ -0,0 +1,85 @@
+# وصل کردن لابی به بازی
+
+## قرارداد
+
+| پلتفرم می‌دهد | شما می‌سازید |
+|---------------|--------------|
+| `user`, `session`, `avatar` | صحنه / تم / پورتال |
+| `lobby.wsUrl`, `lobby.roomId` | منطق «شروع مسابقه» |
+| همگام‌سازی بازیکنان روی سوکت | گیم‌پلی بعد از خروج از لابی |
+
+SDK صفحه را عوض نمی‌کند و چت را ذخیره نمی‌کند.
+
+---
+
+## پیش‌نیاز
+
+1. `@oyna360/lobby-sdk` + `@babylonjs/core`
+2. ترجیحاً `@oyna360/game-sdk` برای گرفتن Context
+3. بازی در ادمین: `slug`, `entryUrl`, `allowedOrigins`
+4. یک `<canvas>` اختصاصی لابی (اگر موتور دیگری دارید، canvas جدا)
+
+---
+
+## الگوی توصیه‌شده
+
+```ts
+import { PlatformSDK } from '@oyna360/game-sdk';
+import { PlatformLobby } from '@oyna360/lobby-sdk';
+
+const init = await PlatformSDK.init(/* Production: خالی | Direct: urls + slug */);
+
+const lobby = await PlatformLobby.create({
+  canvas,
+  platformInit: init,
+  roomId: init.lobby!.roomId,
+  wsUrl: init.lobby!.wsUrl,
+  config: {
+    enableChat: true,
+    enableVoice: true,
+    locale: 'fa',
+  },
+});
+
+lobby.applyPlazaLayout({
+  onRoomStart: (room) => {
+    lobby.destroy();
+    startMatch(room.id);
+  },
+});
+```
+
+### جایگزین: `createFromPlatform`
+
+فقط وقتی Context از قبل روی window/`platform:init` آمده (مثلاً بعد از `PlatformSDK.init()` یا parent iframe):
+
+```ts
+const lobby = await PlatformLobby.createFromPlatform(canvas, {
+  spawnPoint: { x: 0, y: 0, z: 3 },
+});
+```
+
+اگر نه iframe هستید و نه `init` زده‌اید، این متد timeout می‌دهد.
+
+---
+
+## ثبت در ادمین
+
+| فیلد | Development | Production |
+|------|-------------|------------|
+| entryUrl | مثلاً `http://localhost:5180` | `https://games.example.com/` |
+| allowedOrigins | همان origin کامل | همان |
+
+برای Direct Development، origin را در `DEV_GAME_ORIGINS` / `allowedOrigins` هم مجاز کنید. جزئیات در مستندات game-sdk.
+
+---
+
+## اشتباهات تکراری
+
+- هاردکد `http://localhost:3001/lobby`
+- صدا زدن تابع export به نام `applyPlazaLayout` به‌جای **متد** `lobby.applyPlazaLayout`
+- فراموش کردن `destroy()` قبل از گیم‌پلی سنگین
+- استفاده از `createDev()` به‌جای اتصال واقعی
+- نصب جداگانه `lobby-protocol` و shim دستی
+
+بعدی: [03-modes.md](./03-modes.md)

package/docs/02-github.md

@@ -0,0 +1,43 @@
+# نصب از GitHub
+
+پکیج برای بازی‌سازان از ریپوی عمومی منتشر می‌شود:
+
+`https://github.com/mamadjavadrasti/oyna360-lobby-sdk`
+
+## نصب پایدار
+
+```bash
+npm install github:mamadjavadrasti/oyna360-lobby-sdk#master
+# بهتر: تگ نسخه وقتی توسط تیم پلتفرم زده شد
+npm install github:mamadjavadrasti/oyna360-lobby-sdk#v0.x.x
+```
+
+همیشه `@babylonjs/core` را جدا نصب کنید.
+
+## بررسی سلامت `dist`
+
+بعد از نصب، در `node_modules/@oyna360/lobby-sdk/dist/index.js`:
+
+- نباید `from '@platform/lobby-protocol'` دیده شود
+- باید فایل‌هایی مثل `platform-lobby.js`, `protocol.js`, `avatar-factory.js` وجود داشته باشد
+
+## به‌روزرسانی
+
+```bash
+npm install github:mamadjavadrasti/oyna360-lobby-sdk#master --force
+# کش Vite را پاک کنید
+rm -rf node_modules/.vite
+```
+
+یا کپی دستی `dist` از maintainer (pack) داخل `node_modules/@oyna360/lobby-sdk`.
+
+## ارتباط با game-sdk
+
+lobby-sdk وابسته به game-sdk نیست؛ ولی در عمل برای Context واقعی هر دو را نصب کنید:
+
+```bash
+npm install github:mamadjavadrasti/oyna360-game-sdk#v0.5.1
+npm install github:mamadjavadrasti/oyna360-lobby-sdk#master @babylonjs/core
+```
+
+نام پکیج‌ها: `@oyna360/game-sdk` و `@oyna360/lobby-sdk`.