@base44-preview/sdk 0.8.35-pr.212.48756fd → 0.8.35-pr.212.4e8e6d7

package/dist/client.js

@@ -172,9 +172,11 @@ export function createClient(config) {
         realtime: createRealtimeModule({
             appId,
             dispatcherWsUrl: resolvedDispatcherWsUrl,
-            getToken: async (handlerName, instanceId) => {
-                // axiosClient interceptors unwrap response.data, so the result is the body directly
-                const data = await axiosClient.post(`/apps/${appId}/realtime-token`, { handler_name: handlerName, instance_id: instanceId });
+            getToken: async (handlerName, instanceId, connId) => {
+                // axiosClient interceptors unwrap response.data, so the result is the body directly.
+                // conn_id rides inside the signed token (not a WS query param) so it survives
+                // proxies that strip params; the dispatcher forwards it as the handler's conn.id.
+                const data = await axiosClient.post(`/apps/${appId}/realtime-token`, { handler_name: handlerName, instance_id: instanceId, conn_id: connId });
                 return data.token;
             },
         }),

package/dist/modules/realtime.d.ts

@@ -1,6 +1,6 @@
 export declare function createRealtimeModule(config: {
     appId: string;
-    getToken(handlerName: string, instanceId: string): Promise<string>;
+    getToken(handlerName: string, instanceId: string, connId: string): Promise<string>;
     dispatcherWsUrl: string;
 }): Record<string, RealtimeHandler>;
 /** Handle for an active realtime subscription. */

package/dist/modules/realtime.js

@@ -9,19 +9,23 @@ export function createRealtimeModule(config) {
         get(_, handlerName) {
             return {
                 subscribe(instanceId, callback, options) {
-                    var _a;
+                    var _a, _b;
                     const key = socketKey(handlerName, instanceId);
                     // close existing if any
                     (_a = activeSockets.get(key)) === null || _a === void 0 ? void 0 : _a.close();
+                    // Connection id: caller-supplied (stable — reuse across reconnects/tabs as
+                    // you see fit) or auto-generated per subscription. It travels INSIDE the
+                    // signed realtime token (never as a WS query param, which proxies strip);
+                    // the dispatcher forwards the verified claim as partyserver's _pk, so the
+                    // handler sees this exact value as conn.id. Reconnects re-mint the token
+                    // with the same id, so conn.id is stable across reconnects.
+                    const connId = (_b = options === null || options === void 0 ? void 0 : options.id) !== null && _b !== void 0 ? _b : crypto.randomUUID();
                     // query as async fn: called on every (re)connect, fetches a fresh token each time
                     const ws = new PartySocket({
                         host: config.dispatcherWsUrl,
                         party: handlerName,
                         room: instanceId,
-                        // Connection id: caller-supplied (stable — reuse across reconnects/tabs as
-                        // you see fit) or auto-generated per connection. Server sees it as conn.id.
-                        id: options === null || options === void 0 ? void 0 : options.id,
-                        query: () => config.getToken(handlerName, instanceId).then((token) => ({ token })),
+                        query: () => config.getToken(handlerName, instanceId, connId).then((token) => ({ token })),
                     });
                     activeSockets.set(key, ws);
                     // Heartbeat / half-open detection. PartySocket only reconnects on a
@@ -64,7 +68,7 @@ export function createRealtimeModule(config) {
                         }
                     }, PING_MS);
                     return {
-                        id: ws.id, // the connection id (same value the handler sees as conn.id)
+                        id: connId, // the connection id (same value the handler sees as conn.id)
                         unsubscribe() {
                             clearInterval(heartbeat);
                             activeSockets.delete(key);

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

@@ -10,8 +10,8 @@
  * declare module "@base44/sdk" {
  *   interface RealtimeHandlerRegistry {
  *     ChatRoom: {
- *       inbound:  { type: "joined" | "left" | "message"; userId?: string; from?: string; text?: string };
- *       outbound: { text: string };
+ *       toClient: { type: "joined" | "left" | "message"; userId?: string; from?: string; text?: string };
+ *       toServer: { type: "message"; text: string };
  *     };
  *   }
  * }
@@ -26,11 +26,11 @@ export interface RealtimeHandlerRegistry {
 export interface RealtimeHandlerNameRegistry {
 }
 type AllHandlerNames = keyof RealtimeHandlerRegistry | keyof RealtimeHandlerNameRegistry;
-type InboundFor<N extends string> = N extends keyof RealtimeHandlerRegistry ? RealtimeHandlerRegistry[N] extends {
-    inbound: infer I;
+type ToClientFor<N extends string> = N extends keyof RealtimeHandlerRegistry ? RealtimeHandlerRegistry[N] extends {
+    toClient: infer I;
 } ? I : unknown : unknown;
-type OutboundFor<N extends string> = N extends keyof RealtimeHandlerRegistry ? RealtimeHandlerRegistry[N] extends {
-    outbound: infer O;
+type ToServerFor<N extends string> = N extends keyof RealtimeHandlerRegistry ? RealtimeHandlerRegistry[N] extends {
+    toServer: infer O;
 } ? O : unknown : unknown;
 /**
  * Client for a single named RealtimeHandler.
@@ -45,11 +45,11 @@ export interface RealtimeHandlerClient<N extends string = string> {
      * reconnect reuses the same server-side connection); omit it for an auto-generated
      * per-connection id.
      */
-    subscribe(instanceId: string, callback: (data: InboundFor<N>) => void, options?: {
+    subscribe(instanceId: string, callback: (data: ToClientFor<N>) => void, options?: {
         id?: string;
     }): RealtimeSubscription;
     /** Send a message over the open socket. Throws if not subscribed. */
-    send(instanceId: string, data: OutboundFor<N>): void;
+    send(instanceId: string, data: ToServerFor<N>): void;
 }
 /** Handle for an active realtime subscription. */
 export interface RealtimeSubscription {

package/dist/realtime-handler.d.ts

@@ -9,7 +9,11 @@
  * Cloudflare Durable Object implementation — this file provides types only.
  */
 import type { Base44Client } from "./client.types.js";
-export interface Conn {
+/**
+ * A single client connection. `Send` is the message type this connection accepts
+ * via {@link send} — the handler's *outgoing* (server→client) messages.
+ */
+export interface Conn<Send = unknown> {
     /** Unique per-connection id (one per socket/tab), the same value the client
      *  receives from `subscribe()`. Use this — not userId — to identify a distinct
      *  client, so multiple tabs of the same user are separate connections. */
@@ -17,7 +21,7 @@ export interface Conn {
     userId: string;
     appId: string;
     instanceId: string;
-    send(data: unknown): void;
+    send(data: Send): void;
     reject(code: number, reason: string): void;
 }
 export interface Storage {
@@ -25,10 +29,25 @@ export interface Storage {
     put(key: string, value: unknown): Promise<void>;
     delete(key: string): Promise<boolean>;
 }
-export declare abstract class RealtimeHandler<_State = unknown, Message = unknown> {
-    abstract handleConnect(conn: Conn): void | Promise<void>;
-    abstract handleMessage(conn: Conn, msg: Message): void | Promise<void>;
-    abstract handleClose(conn: Conn): void | Promise<void>;
+/**
+ * Base class for a Realtime Handler.
+ *
+ * @typeParam Incoming - messages this handler *receives* from clients
+ *   (`handleMessage`'s `msg`) — the schema's `toServer` section.
+ * @typeParam Outgoing - messages this handler *sends* to clients
+ *   (`conn.send`/`broadcast`) — the schema's `toClient` section.
+ *
+ * With a generated `schema.jsonc`, wire both from the registry so they can't drift
+ * from the client's types:
+ * ```ts
+ * type Reg = RealtimeHandlerRegistry["MyHandler"];
+ * class MyHandler extends RealtimeHandler<Reg["toServer"], Reg["toClient"]> { ... }
+ * ```
+ */
+export declare abstract class RealtimeHandler<Incoming = unknown, Outgoing = unknown> {
+    abstract handleConnect(conn: Conn<Outgoing>): void | Promise<void>;
+    abstract handleMessage(conn: Conn<Outgoing>, msg: Incoming): void | Promise<void>;
+    abstract handleClose(conn: Conn<Outgoing>): void | Promise<void>;
     abstract handleTick(): void | Promise<void>;
     onStart(): void | Promise<void>;
     /**
@@ -43,8 +62,8 @@ export declare abstract class RealtimeHandler<_State = unknown, Message = unknow
      */
     protected tickIntervalMs: number;
     protected shouldTick?(): boolean;
-    protected broadcast(_data: unknown): void;
-    protected getConnections(): Conn[];
+    protected broadcast(_data: Outgoing): void;
+    protected getConnections(): Conn<Outgoing>[];
     protected startLoop(_ms: number): Promise<void>;
     protected stopLoop(): Promise<void>;
     protected get instanceId(): string;

package/dist/realtime-handler.js

@@ -8,6 +8,21 @@
  * At deploy time the bundler replaces this import with the compiled
  * Cloudflare Durable Object implementation — this file provides types only.
  */
+/**
+ * Base class for a Realtime Handler.
+ *
+ * @typeParam Incoming - messages this handler *receives* from clients
+ *   (`handleMessage`'s `msg`) — the schema's `toServer` section.
+ * @typeParam Outgoing - messages this handler *sends* to clients
+ *   (`conn.send`/`broadcast`) — the schema's `toClient` section.
+ *
+ * With a generated `schema.jsonc`, wire both from the registry so they can't drift
+ * from the client's types:
+ * ```ts
+ * type Reg = RealtimeHandlerRegistry["MyHandler"];
+ * class MyHandler extends RealtimeHandler<Reg["toServer"], Reg["toClient"]> { ... }
+ * ```
+ */
 export class RealtimeHandler {
     constructor() {
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.35-pr.212.48756fd",
+  "version": "0.8.35-pr.212.4e8e6d7",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",