cocobase 1.3.5 → 1.4.0

package/dist/realtime/multiplayer.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Player information in a game room
+ */
+export interface Player {
+    id: string;
+    name?: string;
+    [key: string]: any;
+}
+/**
+ * Room information from room discovery
+ */
+export interface RoomInfo {
+    room_id: string;
+    player_count: number;
+    max_players?: number;
+    metadata?: Record<string, any>;
+    [key: string]: any;
+}
+/**
+ * Room discovery response
+ */
+export interface RoomListResponse {
+    rooms: RoomInfo[];
+    total: number;
+}
+/**
+ * Game event types
+ */
+export type GameEventType = "connected" | "player_joined" | "player_left" | "state" | "message" | "error" | "disconnected" | string;
+/**
+ * Game event callback
+ */
+export type GameEventCallback<T = any> = (data: T) => void;
+/**
+ * Options for connecting to a game
+ */
+export interface GameConnectOptions {
+    /** Room ID to join */
+    roomId: string;
+    /** JWT token for authentication (optional) */
+    token?: string;
+    /** Additional data to send on connect */
+    metadata?: Record<string, any>;
+}
+/**
+ * GameClient - Easy-to-use multiplayer game client
+ *
+ * @example
+ * ```typescript
+ * const game = db.realtime.game('my-game-function');
+ *
+ * // Set up event handlers
+ * game.on('connected', (data) => {
+ *   console.log('Connected! My player ID:', data.your_id);
+ * });
+ *
+ * game.on('player_joined', (data) => {
+ *   console.log('Player joined:', data.player_id);
+ * });
+ *
+ * game.on('state', (data) => {
+ *   // Update game state
+ *   renderPlayers(data.players);
+ * });
+ *
+ * // Connect to a room
+ * await game.connect({ roomId: 'game-room-1' });
+ *
+ * // Send actions
+ * game.send({ action: 'move', x: 100, y: 200 });
+ *
+ * // Disconnect when done
+ * game.disconnect();
+ * ```
+ */
+export declare class GameClient {
+    private projectId;
+    private functionName;
+    private baseURL;
+    private ws;
+    private token?;
+    private listeners;
+    private reconnectEnabled;
+    private reconnectDelay;
+    private maxReconnectDelay;
+    private currentReconnectDelay;
+    private reconnectTimeout?;
+    private lastConnectOptions?;
+    private pingInterval?;
+    private _isConnected;
+    private _playerId?;
+    constructor(projectId: string, functionName: string, token?: string);
+    /**
+     * Whether the client is currently connected
+     */
+    get isConnected(): boolean;
+    /**
+     * The current player's ID (available after connection)
+     */
+    get playerId(): string | undefined;
+    /**
+     * Connect to a game room
+     *
+     * @param options - Connection options
+     * @returns Promise that resolves when connected
+     *
+     * @example
+     * ```typescript
+     * await game.connect({ roomId: 'lobby' });
+     *
+     * // With authentication
+     * await game.connect({
+     *   roomId: 'private-game',
+     *   token: userJwtToken
+     * });
+     *
+     * // With metadata
+     * await game.connect({
+     *   roomId: 'game-1',
+     *   metadata: { playerName: 'John', team: 'red' }
+     * });
+     * ```
+     */
+    connect(options: GameConnectOptions): Promise<void>;
+    /**
+     * Send a message/action to the game server
+     *
+     * @param data - Data to send (will be JSON serialized)
+     *
+     * @example
+     * ```typescript
+     * // Send a move action
+     * game.send({ action: 'move', x: 100, y: 200 });
+     *
+     * // Send a chat message
+     * game.send({ action: 'chat', message: 'Hello!' });
+     *
+     * // Send any game action
+     * game.send({ action: 'shoot', angle: 45, power: 80 });
+     * ```
+     */
+    send(data: Record<string, any>): void;
+    /**
+     * Register an event listener
+     *
+     * @param event - Event type to listen for
+     * @param callback - Callback function
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * // Listen for player joining
+     * const unsub = game.on('player_joined', (data) => {
+     *   console.log('Player joined:', data.player_id);
+     * });
+     *
+     * // Later, unsubscribe
+     * unsub();
+     *
+     * // Common events:
+     * game.on('connected', (data) => { ... });
+     * game.on('player_joined', (data) => { ... });
+     * game.on('player_left', (data) => { ... });
+     * game.on('state', (data) => { ... });
+     * game.on('tick', (data) => { ... });
+     * game.on('error', (data) => { ... });
+     * game.on('disconnected', (data) => { ... });
+     * ```
+     */
+    on<T = any>(event: GameEventType, callback: GameEventCallback<T>): () => void;
+    /**
+     * Register a one-time event listener
+     *
+     * @param event - Event type to listen for
+     * @param callback - Callback function (called once then removed)
+     *
+     * @example
+     * ```typescript
+     * game.once('connected', (data) => {
+     *   console.log('Connected with ID:', data.your_id);
+     * });
+     * ```
+     */
+    once<T = any>(event: GameEventType, callback: GameEventCallback<T>): void;
+    /**
+     * Remove an event listener
+     *
+     * @param event - Event type
+     * @param callback - Callback to remove
+     */
+    off(event: GameEventType, callback: GameEventCallback): void;
+    /**
+     * Remove all listeners for an event (or all events)
+     *
+     * @param event - Optional event type. If not provided, removes all listeners.
+     */
+    removeAllListeners(event?: GameEventType): void;
+    /**
+     * Disconnect from the game server
+     *
+     * @param disableReconnect - If true, prevents auto-reconnect
+     */
+    disconnect(disableReconnect?: boolean): void;
+    /**
+     * Enable or disable auto-reconnect
+     */
+    setAutoReconnect(enabled: boolean): void;
+    private emit;
+    private scheduleReconnect;
+}
+/**
+ * List available game rooms for a function
+ *
+ * @param projectId - Project ID
+ * @param apiKey - API key (optional)
+ * @param publicOnly - Only list public rooms (default: true)
+ * @returns Promise resolving to room list
+ *
+ * @example
+ * ```typescript
+ * const { rooms, total } = await listGameRooms('my-project');
+ * rooms.forEach(room => {
+ *   console.log(`${room.room_id}: ${room.player_count}/${room.max_players} players`);
+ * });
+ * ```
+ */
+export declare function listGameRooms(projectId: string, apiKey?: string, publicOnly?: boolean): Promise<RoomListResponse>;
+//# sourceMappingURL=multiplayer.d.ts.map

package/dist/realtime/multiplayer.d.ts.map

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

package/dist/realtime/multiplayer.js

@@ -0,0 +1,399 @@
+import { BASEURL } from "../utils/utils.js";
+/**
+ * GameClient - Easy-to-use multiplayer game client
+ *
+ * @example
+ * ```typescript
+ * const game = db.realtime.game('my-game-function');
+ *
+ * // Set up event handlers
+ * game.on('connected', (data) => {
+ *   console.log('Connected! My player ID:', data.your_id);
+ * });
+ *
+ * game.on('player_joined', (data) => {
+ *   console.log('Player joined:', data.player_id);
+ * });
+ *
+ * game.on('state', (data) => {
+ *   // Update game state
+ *   renderPlayers(data.players);
+ * });
+ *
+ * // Connect to a room
+ * await game.connect({ roomId: 'game-room-1' });
+ *
+ * // Send actions
+ * game.send({ action: 'move', x: 100, y: 200 });
+ *
+ * // Disconnect when done
+ * game.disconnect();
+ * ```
+ */
+export class GameClient {
+    constructor(projectId, functionName, token) {
+        this.ws = null;
+        this.listeners = new Map();
+        this.reconnectEnabled = true;
+        this.reconnectDelay = 1000;
+        this.maxReconnectDelay = 30000;
+        this.currentReconnectDelay = 1000;
+        this._isConnected = false;
+        this.projectId = projectId;
+        this.functionName = functionName;
+        this.token = token;
+        this.baseURL = BASEURL.replace(/^http/, "ws");
+    }
+    /**
+     * Whether the client is currently connected
+     */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * The current player's ID (available after connection)
+     */
+    get playerId() {
+        return this._playerId;
+    }
+    /**
+     * Connect to a game room
+     *
+     * @param options - Connection options
+     * @returns Promise that resolves when connected
+     *
+     * @example
+     * ```typescript
+     * await game.connect({ roomId: 'lobby' });
+     *
+     * // With authentication
+     * await game.connect({
+     *   roomId: 'private-game',
+     *   token: userJwtToken
+     * });
+     *
+     * // With metadata
+     * await game.connect({
+     *   roomId: 'game-1',
+     *   metadata: { playerName: 'John', team: 'red' }
+     * });
+     * ```
+     */
+    connect(options) {
+        return new Promise((resolve, reject) => {
+            this.lastConnectOptions = options;
+            const authToken = options.token || this.token;
+            // Build WebSocket URL
+            let wsUrl = `${this.baseURL}/ws/${this.projectId}/${this.functionName}`;
+            if (authToken) {
+                wsUrl += `?token=${encodeURIComponent(authToken)}`;
+            }
+            try {
+                this.ws = new WebSocket(wsUrl);
+            }
+            catch (err) {
+                reject(err);
+                return;
+            }
+            this.ws.onopen = () => {
+                this.currentReconnectDelay = this.reconnectDelay;
+                // Send initial message with room_id and metadata
+                const initMessage = {
+                    room_id: options.roomId,
+                };
+                if (options.metadata) {
+                    Object.assign(initMessage, options.metadata);
+                }
+                this.ws?.send(JSON.stringify(initMessage));
+                // Start ping interval
+                this.pingInterval = globalThis.setInterval(() => {
+                    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                        this.ws.send(JSON.stringify({ type: "ping" }));
+                    }
+                }, 30000);
+            };
+            this.ws.onmessage = (event) => {
+                try {
+                    const data = JSON.parse(event.data);
+                    // Handle pong silently
+                    if (data.type === "pong")
+                        return;
+                    // Extract event type from various possible fields
+                    const eventType = data.type || data.event || "message";
+                    // Handle connection confirmation
+                    if (eventType === "connected" ||
+                        eventType === "welcome" ||
+                        data.your_id) {
+                        this._isConnected = true;
+                        if (data.your_id) {
+                            this._playerId = data.your_id;
+                        }
+                        this.emit("connected", data);
+                        resolve();
+                        return;
+                    }
+                    // Handle errors
+                    if (eventType === "error" || data.error) {
+                        this.emit("error", data);
+                        if (!this._isConnected) {
+                            reject(new Error(data.error || data.message || "Connection error"));
+                        }
+                        return;
+                    }
+                    // Emit the event
+                    this.emit(eventType, data);
+                }
+                catch (err) {
+                    this.emit("error", { error: err });
+                }
+            };
+            this.ws.onclose = (event) => {
+                this._isConnected = false;
+                if (this.pingInterval) {
+                    clearInterval(this.pingInterval);
+                    this.pingInterval = undefined;
+                }
+                this.emit("disconnected", {
+                    code: event.code,
+                    reason: event.reason,
+                    wasClean: event.wasClean,
+                });
+                // Auto-reconnect if enabled and not a clean close
+                if (this.reconnectEnabled && !event.wasClean && this.lastConnectOptions) {
+                    this.scheduleReconnect();
+                }
+            };
+            this.ws.onerror = (err) => {
+                this.emit("error", { error: err });
+                if (!this._isConnected) {
+                    reject(new Error("WebSocket connection failed"));
+                }
+            };
+            // Timeout for initial connection
+            setTimeout(() => {
+                if (!this._isConnected) {
+                    this.ws?.close();
+                    reject(new Error("Connection timeout"));
+                }
+            }, 10000);
+        });
+    }
+    /**
+     * Send a message/action to the game server
+     *
+     * @param data - Data to send (will be JSON serialized)
+     *
+     * @example
+     * ```typescript
+     * // Send a move action
+     * game.send({ action: 'move', x: 100, y: 200 });
+     *
+     * // Send a chat message
+     * game.send({ action: 'chat', message: 'Hello!' });
+     *
+     * // Send any game action
+     * game.send({ action: 'shoot', angle: 45, power: 80 });
+     * ```
+     */
+    send(data) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error("Not connected to game server");
+        }
+        this.ws.send(JSON.stringify(data));
+    }
+    /**
+     * Register an event listener
+     *
+     * @param event - Event type to listen for
+     * @param callback - Callback function
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * // Listen for player joining
+     * const unsub = game.on('player_joined', (data) => {
+     *   console.log('Player joined:', data.player_id);
+     * });
+     *
+     * // Later, unsubscribe
+     * unsub();
+     *
+     * // Common events:
+     * game.on('connected', (data) => { ... });
+     * game.on('player_joined', (data) => { ... });
+     * game.on('player_left', (data) => { ... });
+     * game.on('state', (data) => { ... });
+     * game.on('tick', (data) => { ... });
+     * game.on('error', (data) => { ... });
+     * game.on('disconnected', (data) => { ... });
+     * ```
+     */
+    on(event, callback) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, []);
+        }
+        this.listeners.get(event).push(callback);
+        // Return unsubscribe function
+        return () => {
+            const callbacks = this.listeners.get(event);
+            if (callbacks) {
+                const index = callbacks.indexOf(callback);
+                if (index !== -1) {
+                    callbacks.splice(index, 1);
+                }
+            }
+        };
+    }
+    /**
+     * Register a one-time event listener
+     *
+     * @param event - Event type to listen for
+     * @param callback - Callback function (called once then removed)
+     *
+     * @example
+     * ```typescript
+     * game.once('connected', (data) => {
+     *   console.log('Connected with ID:', data.your_id);
+     * });
+     * ```
+     */
+    once(event, callback) {
+        const wrapper = (data) => {
+            this.off(event, wrapper);
+            callback(data);
+        };
+        this.on(event, wrapper);
+    }
+    /**
+     * Remove an event listener
+     *
+     * @param event - Event type
+     * @param callback - Callback to remove
+     */
+    off(event, callback) {
+        const callbacks = this.listeners.get(event);
+        if (callbacks) {
+            const index = callbacks.indexOf(callback);
+            if (index !== -1) {
+                callbacks.splice(index, 1);
+            }
+        }
+    }
+    /**
+     * Remove all listeners for an event (or all events)
+     *
+     * @param event - Optional event type. If not provided, removes all listeners.
+     */
+    removeAllListeners(event) {
+        if (event) {
+            this.listeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+        }
+    }
+    /**
+     * Disconnect from the game server
+     *
+     * @param disableReconnect - If true, prevents auto-reconnect
+     */
+    disconnect(disableReconnect = true) {
+        if (disableReconnect) {
+            this.reconnectEnabled = false;
+        }
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = undefined;
+        }
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = undefined;
+        }
+        if (this.ws) {
+            this.ws.close(1000, "Client disconnect");
+            this.ws = null;
+        }
+        this._isConnected = false;
+        this._playerId = undefined;
+    }
+    /**
+     * Enable or disable auto-reconnect
+     */
+    setAutoReconnect(enabled) {
+        this.reconnectEnabled = enabled;
+        if (!enabled && this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = undefined;
+        }
+    }
+    emit(event, data) {
+        const callbacks = this.listeners.get(event);
+        if (callbacks) {
+            callbacks.forEach((cb) => {
+                try {
+                    cb(data);
+                }
+                catch (err) {
+                    console.error(`Error in ${event} handler:`, err);
+                }
+            });
+        }
+        // Also emit to wildcard listeners
+        const wildcardCallbacks = this.listeners.get("*");
+        if (wildcardCallbacks) {
+            wildcardCallbacks.forEach((cb) => {
+                try {
+                    cb({ event, data });
+                }
+                catch (err) {
+                    console.error("Error in wildcard handler:", err);
+                }
+            });
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimeout)
+            return;
+        this.reconnectTimeout = setTimeout(async () => {
+            this.reconnectTimeout = undefined;
+            if (this.lastConnectOptions && this.reconnectEnabled) {
+                try {
+                    await this.connect(this.lastConnectOptions);
+                }
+                catch {
+                    // Exponential backoff
+                    this.currentReconnectDelay = Math.min(this.currentReconnectDelay * 2, this.maxReconnectDelay);
+                    this.scheduleReconnect();
+                }
+            }
+        }, this.currentReconnectDelay);
+    }
+}
+/**
+ * List available game rooms for a function
+ *
+ * @param projectId - Project ID
+ * @param apiKey - API key (optional)
+ * @param publicOnly - Only list public rooms (default: true)
+ * @returns Promise resolving to room list
+ *
+ * @example
+ * ```typescript
+ * const { rooms, total } = await listGameRooms('my-project');
+ * rooms.forEach(room => {
+ *   console.log(`${room.room_id}: ${room.player_count}/${room.max_players} players`);
+ * });
+ * ```
+ */
+export async function listGameRooms(projectId, apiKey, publicOnly = true) {
+    const url = `${BASEURL}/ws/rooms/${projectId}?public_only=${publicOnly}`;
+    const res = await fetch(url, {
+        headers: apiKey ? { "X-API-Key": apiKey } : {},
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Failed to list game rooms: ${text}`);
+    }
+    return res.json();
+}
+//# sourceMappingURL=multiplayer.js.map

package/dist/realtime/multiplayer.js.map

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

package/dist/types/types.d.ts

@@ -9,6 +9,9 @@ export interface CocobaseConfig {
     /** Your Cocobase project ID (required for cloud functions) */
     projectId?: string;
 }
+export interface Response {
+    message: string;
+}
 /**
  * Represents a collection in the database.
  */
@@ -91,9 +94,36 @@ export interface Query {
  * Response from authentication operations containing the access token.
  */
 export interface TokenResponse {
-    /** JWT access token for authenticated requests */
+    /** JWT access token for authenticated requests (undefined if 2FA required) */
+    access_token?: string;
+    /** User object (undefined if 2FA required) */
+    user?: AppUser;
+    /** Whether 2FA verification is required to complete login */
+    requires_2fa?: boolean;
+    /** Message from the server (e.g., "2FA code sent to your email") */
+    message?: string;
+}
+/**
+ * Response from 2FA verification endpoint.
+ */
+export interface TwoFAVerifyResponse {
+    /** JWT access token after successful 2FA verification */
     access_token: string;
+    /** User object */
     user: AppUser;
+    /** Success message */
+    message: string;
+}
+/**
+ * Login result that clearly indicates whether 2FA is required.
+ */
+export interface LoginResult {
+    /** Whether 2FA verification is required */
+    requires_2fa: boolean;
+    /** User object (only present if login succeeded without 2FA) */
+    user?: AppUser;
+    /** Message from server (present when 2FA is required) */
+    message?: string;
 }
 /**
  * Paginated list of users with metadata.