@base44-preview/sdk 0.8.13-pr.58.bc6cdc5 → 0.8.13-pr.58.f5a13ad

package/dist/modules/entities.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from "axios";
 import { EntitiesModule } from "./entities.types";
-import { RoomsSocket } from "../utils/socket-utils";
+import { RoomsSocket } from "../utils/socket-utils.js";
 /**
  * Configuration for the entities module.
  * @internal

package/dist/modules/entities.js

@@ -39,7 +39,8 @@ function parseRealtimeMessage(dataStr) {
             timestamp: parsed.timestamp || new Date().toISOString(),
         };
     }
-    catch (_b) {
+    catch (error) {
+        console.warn("[Base44 SDK] Failed to parse realtime message:", error);
         return null;
     }
 }
@@ -119,7 +120,7 @@ function createEntityHandler(axios, appId, entityName, getSocket) {
             });
         },
         // Subscribe to realtime updates
-        subscribe(callback) {
+        async subscribe(callback) {
             const room = `entities:${appId}:${entityName}`;
             // Get the socket and subscribe to the room
             const socket = getSocket();
@@ -129,7 +130,12 @@ function createEntityHandler(axios, appId, entityName, getSocket) {
                     if (!event) {
                         return;
                     }
-                    callback(event);
+                    try {
+                        callback(event);
+                    }
+                    catch (error) {
+                        console.error("[Base44 SDK] Subscription callback error:", error);
+                    }
                 },
             });
             return unsubscribe;

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

@@ -5,11 +5,11 @@ export type RealtimeEventType = "create" | "update" | "delete";
 /**
  * Payload received when a realtime event occurs.
  */
-export interface RealtimeEvent<T = Record<string, any>> {
+export interface RealtimeEvent {
     /** The type of change that occurred */
     type: RealtimeEventType;
-    /** The entity data (new/updated for create/update, previous for delete) */
-    data: T;
+    /** The entity data */
+    data: any;
     /** The unique identifier of the affected entity */
     id: string;
     /** ISO 8601 timestamp of when the event occurred */
@@ -18,7 +18,7 @@ export interface RealtimeEvent<T = Record<string, any>> {
 /**
  * Callback function invoked when a realtime event occurs.
  */
-export type RealtimeCallback<T = Record<string, any>> = (event: RealtimeEvent<T>) => void;
+export type RealtimeCallback = (event: RealtimeEvent) => void;
 /**
  * Function returned from subscribe, call it to unsubscribe.
  */
@@ -273,12 +273,12 @@ export interface EntityHandler {
      * Receives notifications whenever any record is created, updated, or deleted.
      *
      * @param callback - Function called when an entity changes.
-     * @returns Unsubscribe function to stop listening.
+     * @returns Promise resolving to an unsubscribe function to stop listening.
      *
      * @example
      * ```typescript
      * // Subscribe to all Task changes
-     * const unsubscribe = base44.entities.Task.subscribe((event) => {
+     * const unsubscribe = await base44.entities.Task.subscribe((event) => {
      *   console.log(`Task ${event.id} was ${event.type}d:`, event.data);
      * });
      *
@@ -286,7 +286,7 @@ export interface EntityHandler {
      * unsubscribe();
      * ```
      */
-    subscribe(callback: RealtimeCallback): Subscription;
+    subscribe(callback: RealtimeCallback): Promise<Subscription>;
 }
 /**
  * Entities module for managing app data.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.13-pr.58.bc6cdc5",
+  "version": "0.8.13-pr.58.f5a13ad",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",