@base44-preview/sdk 0.8.40-pr.212.8f46be9 → 0.8.40-pr.212.ae9a5d0

package/dist/actor.d.ts

@@ -8,6 +8,7 @@
  * At deploy time the bundler replaces this import with the compiled
  * Cloudflare Durable Object implementation — this file provides types only.
  */
+import type { Base44Client } from "./client";
 /**
  * A single client connection. `Send` is the message type this connection accepts
  * via {@link send} — the actor's *outgoing* (server→client) messages.
@@ -74,4 +75,10 @@ export declare abstract class Actor<Incoming = unknown, Outgoing = unknown> {
     protected stopLoop(): Promise<void>;
     protected get instanceId(): string;
     protected get storage(): Storage;
+    /**
+     * Anonymous Base44 client scoped to this actor instance — no user or service
+     * auth, so entity access is RLS-gated (same as a logged-out visitor).
+     * Example: `const rows = await this.client.entities.Score.list();`
+     */
+    protected get client(): Base44Client;
 }

package/dist/actor.js

@@ -60,4 +60,12 @@ export class Actor {
     get storage() {
         throw new Error("Actor.storage is only available inside a deployed actor");
     }
+    /**
+     * Anonymous Base44 client scoped to this actor instance — no user or service
+     * auth, so entity access is RLS-gated (same as a logged-out visitor).
+     * Example: `const rows = await this.client.entities.Score.list();`
+     */
+    get client() {
+        throw new Error("Actor.client is only available inside a deployed actor");
+    }
 }

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, resolveActorsHost } from "./modules/actors.js";
 /**
  * Creates a Base44 client.
  *
@@ -51,28 +51,10 @@ import { createActorsModule } from "./modules/actors.js";
  * ```
  */
 export function createClient(config) {
-    var _a, _b;
-    const { serverUrl = "https://base44.app", appId, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, actorsWsUrl, } = config;
+    var _a, _b, _c;
+    const { serverUrl = "https://base44.app", appId, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, } = 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://");
-    })();
     const socketConfig = {
         serverUrl,
         mountPath: "/ws-user-apps/socket.io/",
@@ -142,6 +124,14 @@ export function createClient(config) {
             userAuthModule.setToken(accessToken);
         }
     }
+    const actorsModule = createActorsModule({
+        appId,
+        // serverUrl is often relative/empty (same-origin app); PartySocket needs an
+        // absolute host, so fall back to the page origin.
+        host: resolveActorsHost(serverUrl, typeof window !== "undefined" ? (_a = window.location) === null || _a === void 0 ? void 0 : _a.origin : undefined),
+        functionsVersion,
+        getAuthToken: () => token || getAccessToken(),
+    });
     const userModules = {
         entities: createEntitiesModule({
             axios: axiosClient,
@@ -161,7 +151,7 @@ export function createClient(config) {
                 }
                 return headers;
             },
-            baseURL: (_a = functionsAxiosClient.defaults) === null || _a === void 0 ? void 0 : _a.baseURL,
+            baseURL: (_b = functionsAxiosClient.defaults) === null || _b === void 0 ? void 0 : _b.baseURL,
         }),
         agents: createAgentsModule({
             axios: axiosClient,
@@ -179,16 +169,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 +196,7 @@ export function createClient(config) {
                 }
                 return headers;
             },
-            baseURL: (_b = serviceRoleFunctionsAxiosClient.defaults) === null || _b === void 0 ? void 0 : _b.baseURL,
+            baseURL: (_c = serviceRoleFunctionsAxiosClient.defaults) === null || _c === void 0 ? void 0 : _c.baseURL,
         }),
         agents: createAgentsModule({
             axios: serviceRoleAxiosClient,

package/dist/client.types.d.ts

@@ -74,16 +74,6 @@ export interface CreateClientConfig {
      * Additional client options.
      */
     options?: CreateClientOptions;
-    /**
-     * Base WebSocket URL for Actor connections.
-     *
-     * Defaults to the app's own origin (`appBaseUrl`, else the browser's
-     * `window.location.origin`, else `serverUrl`) with `https://` replaced by
-     * `wss://` (or `http://` by `ws://`) — so the Actor socket is same-origin
-     * with the running app, which proxies `/parties` to the backend dispatcher.
-     * Override only when the Actor host differs from the app origin.
-     */
-    actorsWsUrl?: string;
 }
 /**
  * The Base44 client instance.

package/dist/modules/actors.d.ts

@@ -7,7 +7,19 @@ interface ActorsConfig {
     /** Same semantics as function calls: editors with a non-prod version get the
      * draft actor script; everyone else gets the published one. */
     functionsVersion?: string;
-    actorsWsUrl: string;
+    /** Absolute host PartySocket dials (it strips the scheme and connects wss, ws
+     * for localhost). Resolved by {@link resolveActorsHost}. */
+    host: string;
 }
-export declare function createActorsModule(config: ActorsConfig): Record<string, (instanceId: string) => ActorRoom>;
+/**
+ * Absolute host for the actor WebSocket. PartySocket needs an absolute host and
+ * can't resolve a relative/empty `serverUrl` (same-origin apps use a relative
+ * `/api`, so `serverUrl` is often `""`), so fall back to the page origin.
+ * PartySocket handles the scheme (https→wss, ws for localhost).
+ */
+export declare function resolveActorsHost(serverUrl: string, browserOrigin?: 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;
@@ -27,7 +28,7 @@ class Room {
         const connId = (_a = options === null || options === void 0 ? void 0 : options.id) !== null && _a !== void 0 ? _a : crypto.randomUUID();
         this.connId = connId;
         const ws = new PartySocket({
-            host: this.config.actorsWsUrl,
+            host: this.config.host,
             party: this.actorName,
             room: this.instanceId,
             id: connId,
@@ -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,41 @@ 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);
     }
 }
+/**
+ * Absolute host for the actor WebSocket. PartySocket needs an absolute host and
+ * can't resolve a relative/empty `serverUrl` (same-origin apps use a relative
+ * `/api`, so `serverUrl` is often `""`), so fall back to the page origin.
+ * PartySocket handles the scheme (https→wss, ws for localhost).
+ */
+export function resolveActorsHost(serverUrl, browserOrigin) {
+    return serverUrl && !serverUrl.startsWith("/") ? serverUrl : browserOrigin !== null && browserOrigin !== void 0 ? browserOrigin : serverUrl;
+}
 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.8f46be9",
+  "version": "0.8.40-pr.212.ae9a5d0",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",