@base44-preview/sdk 0.8.40-pr.212.d742832 → 0.8.40-pr.212.f89ce7f

package/dist/client.js

@@ -12,7 +12,7 @@ import { createAppLogsModule } from "./modules/app-logs.js";
 import { createUsersModule } from "./modules/users.js";
 import { RoomsSocket } from "./utils/socket-utils.js";
 import { createAnalyticsModule } from "./modules/analytics.js";
-import { createActorsModule } from "./modules/actors.js";
+import { createActorsModule, resolveActorsWsUrl } from "./modules/actors.js";
 /**
  * Creates a Base44 client.
  *
@@ -51,28 +51,18 @@ import { createActorsModule } from "./modules/actors.js";
  * ```
  */
 export function createClient(config) {
-    var _a, _b;
+    var _a, _b, _c, _d;
     const { serverUrl = "https://base44.app", appId, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, actorsWsUrl, } = config;
     // Normalize appBaseUrl to always be a string (empty if not provided or invalid)
     const normalizedAppBaseUrl = typeof appBaseUrl === "string" ? appBaseUrl : "";
-    // Derive the Actor WebSocket URL if not explicitly provided. Default to
-    // the app's OWN origin (the app URL proxies /parties to the backend) so the
-    // socket is same-origin with the running app, not the API host: prefer an
-    // explicit appBaseUrl, then the browser origin, then fall back to serverUrl
-    // (Node/SSR, where there's no window). Convert https:// → wss:// (http → ws)
-    // and strip the trailing slash.
-    const resolvedActorsWsUrl = (() => {
-        var _a, _b;
-        if (actorsWsUrl)
-            return actorsWsUrl.replace(/\/$/, "");
-        const appOrigin = normalizedAppBaseUrl ||
-            // React Native has a bare `window` with no `location`, so guard both.
-            (typeof window !== "undefined" ? (_b = (_a = window.location) === null || _a === void 0 ? void 0 : _a.origin) !== null && _b !== void 0 ? _b : "" : "");
-        return (appOrigin || serverUrl)
-            .replace(/\/$/, "")
-            .replace(/^https:\/\//, "wss://")
-            .replace(/^http:\/\//, "ws://");
-    })();
+    // Same-origin with the running app (it proxies /parties to the backend), not
+    // the API host. React Native has a bare `window` with no `location`, so guard both.
+    const resolvedActorsWsUrl = resolveActorsWsUrl({
+        actorsWsUrl,
+        appBaseUrl: normalizedAppBaseUrl,
+        browserOrigin: typeof window !== "undefined" ? (_b = (_a = window.location) === null || _a === void 0 ? void 0 : _a.origin) !== null && _b !== void 0 ? _b : "" : "",
+        serverUrl,
+    });
     const socketConfig = {
         serverUrl,
         mountPath: "/ws-user-apps/socket.io/",
@@ -142,6 +132,12 @@ export function createClient(config) {
             userAuthModule.setToken(accessToken);
         }
     }
+    const actorsModule = createActorsModule({
+        appId,
+        actorsWsUrl: resolvedActorsWsUrl,
+        functionsVersion,
+        getAuthToken: () => token || getAccessToken(),
+    });
     const userModules = {
         entities: createEntitiesModule({
             axios: axiosClient,
@@ -161,7 +157,7 @@ export function createClient(config) {
                 }
                 return headers;
             },
-            baseURL: (_a = functionsAxiosClient.defaults) === null || _a === void 0 ? void 0 : _a.baseURL,
+            baseURL: (_c = functionsAxiosClient.defaults) === null || _c === void 0 ? void 0 : _c.baseURL,
         }),
         agents: createAgentsModule({
             axios: axiosClient,
@@ -179,16 +175,10 @@ export function createClient(config) {
             appId,
             userAuthModule,
         }),
-        actors: createActorsModule({
-            appId,
-            actorsWsUrl: resolvedActorsWsUrl,
-            functionsVersion,
-            // Same credential as function calls; the platform proxy authenticates the
-            // WS connection with it (anonymous when absent) — no pre-connect token mint.
-            getAuthToken: () => token || getAccessToken(),
-        }),
+        actors: actorsModule.module,
         cleanup: () => {
             userModules.analytics.cleanup();
+            actorsModule.closeAll();
             if (socket) {
                 socket.disconnect();
             }
@@ -212,7 +202,7 @@ export function createClient(config) {
                 }
                 return headers;
             },
-            baseURL: (_b = serviceRoleFunctionsAxiosClient.defaults) === null || _b === void 0 ? void 0 : _b.baseURL,
+            baseURL: (_d = serviceRoleFunctionsAxiosClient.defaults) === null || _d === void 0 ? void 0 : _d.baseURL,
         }),
         agents: createAgentsModule({
             axios: serviceRoleAxiosClient,

package/dist/modules/actors.d.ts

@@ -9,5 +9,20 @@ interface ActorsConfig {
     functionsVersion?: string;
     actorsWsUrl: string;
 }
-export declare function createActorsModule(config: ActorsConfig): Record<string, (instanceId: string) => ActorRoom>;
+/**
+ * Base WebSocket URL for Actor connections. An explicit `actorsWsUrl` wins;
+ * otherwise the app's own origin (`appBaseUrl`, else the browser origin, else
+ * `serverUrl`) with `https://`→`wss://` / `http://`→`ws://` and no trailing
+ * slash — the app proxies `/parties` to the backend dispatcher.
+ */
+export declare function resolveActorsWsUrl(opts: {
+    actorsWsUrl?: string;
+    appBaseUrl?: string;
+    browserOrigin?: string;
+    serverUrl: string;
+}): string;
+export declare function createActorsModule(config: ActorsConfig): {
+    module: Record<string, (instanceId: string) => ActorRoom>;
+    closeAll: () => void;
+};
 export {};

package/dist/modules/actors.js

@@ -4,10 +4,11 @@ import PartySocket from "partysocket";
 const PING_MS = 1000;
 const DEAD_MS = 3000;
 class Room {
-    constructor(actorName, instanceId, config) {
+    constructor(actorName, instanceId, config, onClose) {
         this.actorName = actorName;
         this.instanceId = instanceId;
         this.config = config;
+        this.onClose = onClose;
         this.ws = null;
         this.listeners = new Set();
         this.heartbeat = null;
@@ -53,11 +54,11 @@ class Room {
                 data = JSON.parse(ev.data);
             }
             catch (_a) {
-                return; // ignore malformed
+                return;
             }
             const msgType = data && typeof data === "object" ? data.type : undefined;
             if (msgType === "__pong")
-                return; // platform message — never surface it
+                return;
             for (const listener of this.listeners)
                 listener(data);
         });
@@ -68,13 +69,12 @@ class Room {
                 return;
             }
             try {
-                // Server contract: the deployed Actor shim echoes __ping with __pong
-                // (see base44-userapp-bundler shim/actor.ts). If that ever stops, an
-                // idle room's lastMsg goes stale and this watchdog reconnects every DEAD_MS.
+                // The deployed shim echoes __ping → __pong (base44-userapp-bundler
+                // shim/actor.ts); without that, an idle room reconnects every DEAD_MS.
                 ws.send(JSON.stringify({ type: "__ping" }));
             }
             catch (_a) {
-                // socket not open; the watchdog above will force a reconnect
+                // not open; the watchdog above will reconnect
             }
         }, PING_MS);
         return this;
@@ -95,7 +95,7 @@ class Room {
         this.ws.send(JSON.stringify(data));
     }
     close() {
-        var _a;
+        var _a, _b;
         if (this.heartbeat) {
             clearInterval(this.heartbeat);
             this.heartbeat = null;
@@ -103,12 +103,47 @@ class Room {
         this.listeners.clear();
         (_a = this.ws) === null || _a === void 0 ? void 0 : _a.close();
         this.ws = null;
+        this.connId = null;
+        (_b = this.onClose) === null || _b === void 0 ? void 0 : _b.call(this);
     }
 }
+/**
+ * Base WebSocket URL for Actor connections. An explicit `actorsWsUrl` wins;
+ * otherwise the app's own origin (`appBaseUrl`, else the browser origin, else
+ * `serverUrl`) with `https://`→`wss://` / `http://`→`ws://` and no trailing
+ * slash — the app proxies `/parties` to the backend dispatcher.
+ */
+export function resolveActorsWsUrl(opts) {
+    if (opts.actorsWsUrl)
+        return opts.actorsWsUrl.replace(/\/$/, "");
+    const appOrigin = opts.appBaseUrl || opts.browserOrigin || "";
+    return (appOrigin || opts.serverUrl)
+        .replace(/\/$/, "")
+        .replace(/^https:\/\//, "wss://")
+        .replace(/^http:\/\//, "ws://");
+}
 export function createActorsModule(config) {
-    return new Proxy({}, {
-        get(_, actorName) {
-            return (instanceId) => new Room(actorName, instanceId, config);
+    // Live rooms this client opened, so client.cleanup() can reclaim any the app
+    // forgot to close() (each room removes itself here on close).
+    const rooms = new Set();
+    const module = new Proxy({}, {
+        get(_, key) {
+            // Symbols and `then` resolve to undefined (so the module isn't mistaken
+            // for a thenable when awaited); any string key is an actor name.
+            if (typeof key !== "string" || key === "then")
+                return undefined;
+            return (instanceId) => {
+                const room = new Room(key, instanceId, config, () => rooms.delete(room));
+                rooms.add(room);
+                return room;
+            };
         },
     });
+    return {
+        module,
+        closeAll: () => {
+            for (const room of [...rooms])
+                room.close();
+        },
+    };
 }

package/dist/modules/actors.types.d.ts

@@ -58,7 +58,7 @@ export interface ActorRoom<N extends string = string> {
     connect(options?: ActorConnectOptions): this;
     /** Register a message listener. Multiple are allowed; returns a per-listener unsubscribe. */
     subscribe(callback: (data: ToClientFor<N>) => void): ActorSubscription;
-    /** Send a message. Throws before {@link connect}; buffered by the socket until open. */
+    /** Send a message. Throws before {@link connect}; buffered by the socket once connecting. */
     send(data: ToServerFor<N>): void;
     /** Tear down the socket, heartbeat, and all listeners. */
     close(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.40-pr.212.d742832",
+  "version": "0.8.40-pr.212.f89ce7f",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",