@playcademy/sdk 0.0.1-beta.32 → 0.0.1-beta.34

package/dist/core/client.d.ts

@@ -433,7 +433,7 @@ export declare class PlaycademyClient {
         token: {
             get: () => Promise<import("./namespaces/realtime").RealtimeTokenResponse>;
         };
-        open(channel?: string): Promise<import("@playcademy/realtime/server/types").RealtimeChannel>;
+        open(channel?: string, url?: string): Promise<import("@playcademy/realtime/server/types").RealtimeChannel>;
     };
     /** Auto-initializes a PlaycademyClient with context from the environment */
     static init: typeof init;

package/dist/core/namespaces/realtime.d.ts

@@ -43,7 +43,7 @@ export declare function createRealtimeNamespace(client: PlaycademyClient): {
      *
      * **Channel Naming**:
      * - Channels are automatically scoped to the current game
-     * - Channel names should be descriptive (e.g., "chat", "lobby", "map_forest")
+     * - Channel names should be descriptive (e.g. "chat", "lobby", "map_forest")
      * - The "default" channel is used if no name is specified
      *
      * **Connection Management**:
@@ -52,12 +52,15 @@ export declare function createRealtimeNamespace(client: PlaycademyClient): {
      * - Remember to call `channel.close()` when done to prevent resource leaks
      *
      * **Error Handling**:
-     * - Throws if no gameId is configured on the client
+     * - Throws if no `gameId` is configured on the client
      * - Throws if token retrieval fails
      * - Throws if WebSocket connection fails
      *
      * @param channel - Channel name (defaults to "default")
-     * @returns Promise resolving to a RealtimeChannel instance
+     * @param url - Optional WebSocket **base** URL (e.g. `ws://localhost:3000`).
+     *   If omitted, the client's `baseUrl` is used and automatically converted to
+     *   a WebSocket URL (`http` → `ws`, `https` → `wss`).
+     * @returns Promise resolving to a `RealtimeChannel` instance
      *
      * @example
      * ```typescript
@@ -78,7 +81,10 @@ export declare function createRealtimeNamespace(client: PlaycademyClient): {
      *
      * // Open a named channel
      * const chatChannel = await client.realtime.open('chat')
+     *
+     * // Open a channel against a custom realtime endpoint
+     * const localChannel = await client.realtime.open('dev', 'ws://localhost:3000')
      * ```
      */
-    open(channel?: string): Promise<RealtimeChannel>;
+    open(channel?: string, url?: string): Promise<RealtimeChannel>;
 };

package/dist/index.js

@@ -1499,8 +1499,23 @@ class RealtimeChannelClient {
   async connect() {
     try {
       const token = await this.getToken();
-      const wsUrl = this.baseUrl.replace(/^http/, "ws");
-      const url = `${wsUrl}?token=${encodeURIComponent(token)}&c=${encodeURIComponent(this._channelName)}`;
+      let wsBase;
+      if (/^ws(s)?:\/\//.test(this.baseUrl)) {
+        wsBase = this.baseUrl;
+      } else if (/^http(s)?:\/\//.test(this.baseUrl)) {
+        wsBase = this.baseUrl.replace(/^http/, "ws");
+      } else {
+        const isBrowser2 = typeof window !== "undefined";
+        if (isBrowser2) {
+          const proto = window.location.protocol === "https:" ? "wss" : "ws";
+          wsBase = `${proto}://${window.location.host}${this.baseUrl}`;
+        } else {
+          wsBase = `ws://${this.baseUrl.replace(/^\//, "")}`;
+        }
+      }
+      const url = new URL(wsBase);
+      url.searchParams.set("token", token);
+      url.searchParams.set("c", this._channelName);
       this.ws = new WebSocket(url);
       this.setupEventHandlers();
       this.setupTokenRefreshListener();
@@ -1680,11 +1695,18 @@ function createRealtimeNamespace(client) {
         return client["request"]("/realtime/token", "POST");
       }
     },
-    async open(channel = "default") {
+    async open(channel = "default", url) {
       if (!client["gameId"]) {
         throw new Error("gameId is required for realtime channels");
       }
-      const realtimeClient = new RealtimeChannelClient(client["gameId"], channel, () => client.realtime.token.get().then((r) => r.token), client.getBaseUrl());
+      let wsBaseUrl = url;
+      if (!wsBaseUrl && typeof window !== "undefined") {
+        const ctx = window.PLAYCADEMY;
+        if (ctx?.realtimeUrl) {
+          wsBaseUrl = ctx.realtimeUrl;
+        }
+      }
+      const realtimeClient = new RealtimeChannelClient(client["gameId"], channel, () => client.realtime.token.get().then((r) => r.token), wsBaseUrl ?? client.getBaseUrl());
       return realtimeClient.connect();
     }
   };
@@ -1739,7 +1761,8 @@ function createStandaloneConfig() {
   const mockConfig = {
     baseUrl: "/api",
     token: "mock-game-token-for-local-dev",
-    gameId: "mock-game-id-from-template"
+    gameId: "mock-game-id-from-template",
+    realtimeUrl: undefined
   };
   window.PLAYCADEMY = mockConfig;
   return mockConfig;

package/dist/types.d.ts

@@ -29,6 +29,7 @@ export interface ClientEvents {
 export type GameContextPayload = {
     token: string;
     baseUrl: string;
+    realtimeUrl: string;
     gameId: string;
     forwardKeys?: string[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.0.1-beta.32",
+    "version": "0.0.1-beta.34",
     "type": "module",
     "exports": {
         ".": {
@@ -27,16 +27,14 @@
         "test": "bun test",
         "test:watch": "bun test --watch"
     },
-    "dependencies": {
-        "@playcademy/logger": "0.0.1"
-    },
     "devDependencies": {
         "@playcademy/data": "0.0.1",
         "@playcademy/sandbox": "0.1.0-beta.14",
         "@playcademy/test": "0.0.1",
         "@types/bun": "latest",
         "typescript": "^5.7.2",
-        "yocto-spinner": "^0.2.2"
+        "yocto-spinner": "^0.2.2",
+        "@playcademy/logger": "0.0.1"
     },
     "peerDependencies": {
         "drizzle-orm": "^0.42.0",