@wovoon/polaris 0.5.0 → 0.6.0

package/dist/client.d.ts

@@ -82,6 +82,28 @@ export declare class PolarisClient {
         onPresence: (callback: (frame: unknown) => void) => void;
         onClose: (callback: (payload: unknown) => void) => void;
     };
+    /** 世界总线：全服事件流（权威房间 ctx.worldBroadcast 广播到此），用法同房间。 */
+    world(): {
+        send: (data: unknown) => void;
+        leave: () => void;
+        onMessage: (callback: (payload: {
+            from: string;
+            data: unknown;
+        }) => void) => void;
+        onPresence: (callback: (frame: unknown) => void) => void;
+        onClose: (callback: (payload: unknown) => void) => void;
+    };
+    /** 内置匹配：凑满 exports.matchSize 人成局 → resolve 目标房间号（再 room(roomId, {mode}) 进入）。 */
+    match(mode: string): Promise<string>;
+    /** 房间列表（大厅/分线选择）。 */
+    rooms(options?: {
+        mode?: string;
+    }): Promise<Array<{
+        roomId: string;
+        mode: string;
+        players: number;
+        world: boolean;
+    }>>;
     collection<T = Record<string, unknown>>(name: string): {
         query: (options?: PolarisQueryOptions) => Promise<PolarisDocumentView[]>;
         get: (id: string) => Promise<PolarisDocumentView>;

package/dist/client.js

@@ -184,6 +184,8 @@ export class PolarisClient {
                     emit("presence", frame);
                 else if (frame.type === "error")
                     emit("message", { error: frame.message });
+                else if (frame.type === "matched")
+                    emit("message", frame);
             };
             socket.onclose = () => {
                 if (this.activeRooms.get(roomId) === handle)
@@ -198,6 +200,48 @@ export class PolarisClient {
         }).catch((error) => emit("close", { error: error.message }));
         return handle;
     }
+    /** 世界总线：全服事件流（权威房间 ctx.worldBroadcast 广播到此），用法同房间。 */
+    world() {
+        return this.room("__world");
+    }
+    /** 内置匹配：凑满 exports.matchSize 人成局 → resolve 目标房间号（再 room(roomId, {mode}) 进入）。 */
+    match(mode) {
+        if (!mode)
+            throw new PolarisError("match(mode) 需要模式名", "WOVOON_ARGUMENT");
+        return new Promise((resolve, reject) => {
+            this.session().then(() => {
+                const queue = this.room(`__match_${mode}`);
+                let done = false;
+                const timer = setTimeout(() => {
+                    if (done)
+                        return;
+                    done = true;
+                    try {
+                        queue.leave();
+                    }
+                    catch { /* 已关 */ }
+                    reject(new PolarisError("匹配等待超时（120 秒）", "WOVOON_MATCH_TIMEOUT"));
+                }, 120000);
+                queue.onMessage((payload) => {
+                    const frame = payload;
+                    if (done || frame?.type !== "matched" || !frame.roomId)
+                        return;
+                    done = true;
+                    clearTimeout(timer);
+                    try {
+                        queue.leave();
+                    }
+                    catch { /* 已关 */ }
+                    resolve(frame.roomId);
+                });
+            }).catch(reject);
+        });
+    }
+    /** 房间列表（大厅/分线选择）。 */
+    rooms(options) {
+        const query = options?.mode ? `?mode=${encodeURIComponent(options.mode)}` : "";
+        return this.session().then((data) => this.request("GET", `/api/cloud/${data.appId}/rooms${query}`));
+    }
     collection(name) {
         if (!name)
             throw new PolarisError("collection(name) 需要集合名", "WOVOON_ARGUMENT");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wovoon/polaris",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "wovoon Polaris SDK——wovoon 大后台云能力客户端（身份/数据集合/云函数/房间实时），协议 1",
   "type": "module",
   "main": "dist/index.js",