@base44-preview/sdk 0.8.35-pr.212.1d74ede → 0.8.35-pr.212.2fe0031

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export type { IntegrationsModule, IntegrationEndpointFunction, CoreIntegrations,
 export type { FunctionsModule, FunctionName, FunctionNameRegistry, } from "./modules/functions.types.js";
 export type { AgentsModule, AgentName, AgentNameRegistry, AgentConversation, AgentMessage, AgentMessageReasoning, AgentMessageToolCall, AgentMessageUsage, AgentMessageCustomContext, AgentMessageMetadata, CreateConversationParams, } from "./modules/agents.types.js";
 export type { AppLogsModule } from "./modules/app-logs.types.js";
-export type { RealtimeModule, RealtimeHandlerClient, RealtimeHandlerNameRegistry, RealtimeHandlerRegistry, } from "./modules/realtime.types.js";
+export type { RealtimeModule, RealtimeHandlerClient, RealtimeSubscription, } from "./modules/realtime.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 export { RealtimeHandler, type Conn } from "./realtime-handler.js";
 export type { ConnectorsModule, UserConnectorsModule, } from "./modules/connectors.types.js";

package/dist/modules/realtime.d.ts

@@ -4,7 +4,10 @@ export declare function createRealtimeModule(config: {
     dispatcherWsUrl: string;
 }): Record<string, RealtimeHandler>;
 interface RealtimeHandler {
-    subscribe(instanceId: string, callback: (data: unknown) => void): () => void;
+    subscribe(instanceId: string, callback: (data: unknown) => void): Promise<{
+        send(data: unknown): void;
+        close(): void;
+    }>;
     send(instanceId: string, data: unknown): void;
 }
 export {};

package/dist/modules/realtime.js

@@ -8,21 +8,19 @@ export function createRealtimeModule(config) {
     return new Proxy({}, {
         get(_, handlerName) {
             return {
-                subscribe(instanceId, callback) {
+                async subscribe(instanceId, callback) {
                     var _a;
                     const key = socketKey(handlerName, instanceId);
                     // close existing if any
                     (_a = activeSockets.get(key)) === null || _a === void 0 ? void 0 : _a.close();
+                    const token = await config.getToken(handlerName, instanceId);
                     const ws = new PartySocket({
                         host: config.dispatcherWsUrl,
                         party: handlerName,
                         room: instanceId,
+                        query: { token },
                     });
                     activeSockets.set(key, ws);
-                    // Fetch token and attach on connect
-                    config.getToken(handlerName, instanceId).then((token) => {
-                        ws.updateProperties({ party: handlerName, room: instanceId, query: { token } });
-                    });
                     ws.addEventListener("message", (ev) => {
                         try {
                             callback(JSON.parse(ev.data));
@@ -37,15 +35,20 @@ export function createRealtimeModule(config) {
                             return; // replaced
                         try {
                             const newToken = await config.getToken(handlerName, instanceId);
-                            ws.updateProperties({ party: handlerName, room: instanceId, query: { token: newToken } });
+                            ws.updateProperties({ query: { token: newToken } });
                         }
                         catch (_a) {
                             // ignore token refresh failure
                         }
                     });
-                    return () => {
-                        activeSockets.delete(key);
-                        ws.close();
+                    return {
+                        send(data) {
+                            ws.send(JSON.stringify(data));
+                        },
+                        close() {
+                            activeSockets.delete(key);
+                            ws.close();
+                        },
                     };
                 },
                 send(instanceId, data) {

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

@@ -1,46 +1,32 @@
 /**
- * Extend this interface to add typed `subscribe` callbacks and `send` payloads
- * for your deployed RealtimeHandlers.
- *
- * This is separate from {@link RealtimeHandlerNameRegistry} (which is auto-generated
- * by `base44 types generate`), so there are no conflicts.
- *
- * @example
- * ```typescript
- * declare module "@base44/sdk" {
- *   interface RealtimeHandlerRegistry {
- *     ChatRoom: {
- *       inbound:  { type: "joined" | "left" | "message"; userId?: string; from?: string; text?: string };
- *       outbound: { text: string };
- *     };
- *   }
- * }
- * ```
- */
-export interface RealtimeHandlerRegistry {
-}
-/**
- * Auto-populated by `base44 types generate` with the names of your deployed handlers.
- * Do not edit this interface manually — use {@link RealtimeHandlerRegistry} for message types.
+ * A subscription handle returned by {@link RealtimeHandlerClient.subscribe}.
  */
-export interface RealtimeHandlerNameRegistry {
+export interface RealtimeSubscription {
+    /** Send a message to all subscribers of this instance. */
+    send(data: unknown): void;
+    /** Close the WebSocket connection and remove the subscription. */
+    close(): void;
 }
-type AllHandlerNames = keyof RealtimeHandlerRegistry | keyof RealtimeHandlerNameRegistry;
-type InboundFor<N extends string> = N extends keyof RealtimeHandlerRegistry ? RealtimeHandlerRegistry[N] extends {
-    inbound: infer I;
-} ? I : unknown : unknown;
-type OutboundFor<N extends string> = N extends keyof RealtimeHandlerRegistry ? RealtimeHandlerRegistry[N] extends {
-    outbound: infer O;
-} ? O : unknown : unknown;
 /**
  * Client for a single named RealtimeHandler.
- * Typed automatically when the handler is registered in {@link RealtimeHandlerRegistry}.
  */
-export interface RealtimeHandlerClient<N extends string = string> {
-    /** Open a WebSocket subscription. Returns a synchronous unsubscribe function. */
-    subscribe(instanceId: string, callback: (data: InboundFor<N>) => void): () => void;
-    /** Send a message over the open socket. Throws if not subscribed. */
-    send(instanceId: string, data: OutboundFor<N>): void;
+export interface RealtimeHandlerClient {
+    /**
+     * Subscribe to messages from a specific RealtimeHandler instance.
+     *
+     * @param instanceId - The instance ID of the Durable Object.
+     * @param callback - Called with each parsed message payload.
+     * @returns A subscription handle with `send` and `close` methods.
+     */
+    subscribe(instanceId: string, callback: (data: unknown) => void): Promise<RealtimeSubscription>;
+    /**
+     * Send a message to an existing active subscription.
+     *
+     * @param instanceId - The instance ID of the Durable Object.
+     * @param data - The data to send (will be JSON-serialized).
+     * @throws {Error} When no active subscription exists for this handler/instance pair.
+     */
+    send(instanceId: string, data: unknown): void;
 }
 /**
  * The realtime module provides access to Cloudflare Durable Object-backed
@@ -49,13 +35,10 @@ export interface RealtimeHandlerClient<N extends string = string> {
  * Handler names are accessed as dynamic properties on this module:
  * ```typescript
  * const sub = await base44.realtime.MyHandler.subscribe("room-1", (msg) => {
- *   console.log(msg); // typed if MyHandler is in RealtimeHandlerRegistry
+ *   console.log(msg);
  * });
  * sub.send({ text: "hello" });
  * sub.close();
  * ```
  */
-export type RealtimeModule = {
-    [K in AllHandlerNames]: K extends keyof RealtimeHandlerRegistry ? RealtimeHandlerClient<string & K> : RealtimeHandlerClient;
-} & Record<string, RealtimeHandlerClient>;
-export {};
+export type RealtimeModule = Record<string, RealtimeHandlerClient>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.35-pr.212.1d74ede",
+  "version": "0.8.35-pr.212.2fe0031",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",