@depup/base44__sdk 0.8.22-depup.0

package/dist/modules/connectors.js

@@ -0,0 +1,71 @@
+/**
+ * Creates the Connectors module for the Base44 SDK.
+ *
+ * @param axios - Axios instance (should be service role client)
+ * @param appId - Application ID
+ * @returns Connectors module with methods to retrieve OAuth tokens
+ * @internal
+ */
+export function createConnectorsModule(axios, appId) {
+    return {
+        /**
+         * Retrieve an OAuth access token for a specific external integration type.
+         * @deprecated Use getConnection(integrationType) and use the returned accessToken (and connectionConfig when needed) instead.
+         */
+        // @ts-expect-error Return type mismatch with interface - implementation returns string, interface expects string but implementation is typed as ConnectorAccessTokenResponse
+        async getAccessToken(integrationType) {
+            if (!integrationType || typeof integrationType !== "string") {
+                throw new Error("Integration type is required and must be a string");
+            }
+            const response = await axios.get(`/apps/${appId}/external-auth/tokens/${integrationType}`);
+            // @ts-expect-error
+            return response.access_token;
+        },
+        async getConnection(integrationType) {
+            var _a;
+            if (!integrationType || typeof integrationType !== "string") {
+                throw new Error("Integration type is required and must be a string");
+            }
+            const response = await axios.get(`/apps/${appId}/external-auth/tokens/${integrationType}`);
+            const data = response;
+            return {
+                accessToken: data.access_token,
+                connectionConfig: (_a = data.connection_config) !== null && _a !== void 0 ? _a : null,
+            };
+        },
+    };
+}
+/**
+ * Creates the user-scoped Connectors module (app-user OAuth flows).
+ *
+ * @param axios - Axios instance (user-scoped client)
+ * @param appId - Application ID
+ * @returns User connectors module with app-user OAuth methods
+ * @internal
+ */
+export function createUserConnectorsModule(axios, appId) {
+    return {
+        async getCurrentAppUserAccessToken(connectorId) {
+            if (!connectorId || typeof connectorId !== "string") {
+                throw new Error("Connector ID is required and must be a string");
+            }
+            const response = await axios.get(`/apps/${appId}/app-user-auth/connectors/${connectorId}/token`);
+            const data = response;
+            return data.access_token;
+        },
+        async connectAppUser(connectorId) {
+            if (!connectorId || typeof connectorId !== "string") {
+                throw new Error("Connector ID is required and must be a string");
+            }
+            const response = await axios.post(`/apps/${appId}/app-user-auth/connectors/${connectorId}/initiate`);
+            const data = response;
+            return data.redirect_url;
+        },
+        async disconnectAppUser(connectorId) {
+            if (!connectorId || typeof connectorId !== "string") {
+                throw new Error("Connector ID is required and must be a string");
+            }
+            await axios.delete(`/apps/${appId}/app-user-auth/connectors/${connectorId}`);
+        },
+    };
+}

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

@@ -0,0 +1,296 @@
+/**
+ * Registry of connector integration type names. The [`types generate`](/developers/references/cli/commands/types-generate) command fills this registry, then [`ConnectorIntegrationType`](#connectorintegrationtype) resolves to a union of the keys.
+ */
+export interface ConnectorIntegrationTypeRegistry {
+}
+/**
+ * Union of all connector integration type names from the [`ConnectorIntegrationTypeRegistry`](#connectorintegrationtyperegistry). Defaults to `string` when no types have been generated.
+ *
+ * @example
+ * ```typescript
+ * // Using generated connector type names
+ * // With generated types, you get autocomplete on integration types
+ * const connection = await base44.asServiceRole.connectors.getConnection('googlecalendar');
+ * const token = connection.accessToken;
+ * ```
+ */
+export type ConnectorIntegrationType = keyof ConnectorIntegrationTypeRegistry extends never ? string : keyof ConnectorIntegrationTypeRegistry;
+/**
+ * Response from the connectors access token endpoint.
+ */
+export interface ConnectorAccessTokenResponse {
+    access_token: string;
+    integration_type: string;
+    connection_config: Record<string, string> | null;
+}
+/**
+ * Connection details.
+ */
+export interface ConnectorConnectionResponse {
+    /** The OAuth access token for the external service. */
+    accessToken: string;
+    /** Key-value configuration for the connection, or `null` if the connector does not provide one. */
+    connectionConfig: Record<string, string> | null;
+}
+/**
+ * Connectors module for managing app-scoped OAuth tokens for external services.
+ *
+ * This module allows you to retrieve OAuth access tokens for external services that the app has connected to. Connectors are app-scoped. When an app builder connects an integration like Google Calendar, Slack, or GitHub, all users of the app share that same connection.
+ *
+ * Unlike the integrations module that provides pre-built functions, connectors give you
+ * raw OAuth tokens so you can call external service APIs directly with full control over
+ * the API calls you make. This is useful when you need custom API interactions that aren't
+ * covered by Base44's pre-built integrations.
+ *
+ * ## Available connectors
+ *
+ * All connectors work through [`getConnection()`](#getconnection). Pass the integration type string and use the returned OAuth token to call the external service's API directly.
+ *
+ * | Service | Type identifier |
+ * |---|---|
+ * | Airtable | `airtable` |
+ * | Box | `box` |
+ * | ClickUp | `clickup` |
+ * | Discord | `discord` |
+ * | Dropbox | `dropbox` |
+ * | GitHub | `github` |
+ * | Gmail | `gmail` |
+ * | Google Analytics | `google_analytics` |
+ * | Google BigQuery | `googlebigquery` |
+ * | Google Calendar | `googlecalendar` |
+ * | Google Classroom | `google_classroom` |
+ * | Google Docs | `googledocs` |
+ * | Google Drive | `googledrive` |
+ * | Google Search Console | `google_search_console` |
+ * | Google Sheets | `googlesheets` |
+ * | Google Slides | `googleslides` |
+ * | HubSpot | `hubspot` |
+ * | Linear | `linear` |
+ * | LinkedIn | `linkedin` |
+ * | Microsoft Teams | `microsoft_teams` |
+ * | Microsoft OneDrive | `one_drive` |
+ * | Notion | `notion` |
+ * | Outlook | `outlook` |
+ * | Salesforce | `salesforce` |
+ * | SharePoint | `share_point` |
+ * | Slack User | `slack` |
+ * | Slack Bot | `slackbot` |
+ * | Splitwise | `splitwise` |
+ * | TikTok | `tiktok` |
+ * | Typeform | `typeform` |
+ * | Wix | `wix` |
+ * | Wrike | `wrike` |
+ *
+ * See the integration guides for more details:
+ *
+ * - **Scopes and permissions**: {@link https://docs.base44.com/Integrations/gmail-connector#gmail-scopes-and-permissions | Gmail}, {@link https://docs.base44.com/Integrations/linkedin-connector#linkedin-scopes-and-permissions | LinkedIn}, {@link https://docs.base44.com/Integrations/slack-connector#slack-scopes-and-permissions | Slack}, {@link https://docs.base44.com/Integrations/github-connector#github-scopes-and-permissions | GitHub}
+ * - **Slack connector types**: {@link https://docs.base44.com/Integrations/slack-connector#about-the-slack-connectors | About the Slack connectors} explains the difference between `slack` and `slackbot`
+ *
+ * ## Authentication Modes
+ *
+ * This module is only available to use with a client in service role authentication mode, which means it can only be used in backend environments.
+ *
+ * ## Dynamic Types
+ *
+ * If you're working in a TypeScript project, you can generate types from your app's connector configurations to get autocomplete on integration type names when calling `getConnection()`. See the [Dynamic Types](/developers/references/sdk/getting-started/dynamic-types) guide to get started.
+ */
+export interface ConnectorsModule {
+    /**
+     * Retrieves an OAuth access token for a specific [external integration type](#available-connectors).
+     *
+     * @deprecated Use {@link getConnection} instead.
+     *
+     * Returns the OAuth token string for an external service that an app builder
+     * has connected to. This token represents the connected app builder's account
+     * and can be used to make authenticated API calls to that external service on behalf of the app.
+     *
+     * @param integrationType - The type of integration, such as `'googlecalendar'`, `'slack'`, `'slackbot'`, `'github'`, or `'discord'`. See [Available connectors](#available-connectors) for the full list.
+     * @returns Promise resolving to the access token string.
+     *
+     * @example
+     * ```typescript
+     * // Google Calendar connection
+     * // Get Google Calendar OAuth token and fetch upcoming events
+     * const googleToken = await base44.asServiceRole.connectors.getAccessToken('googlecalendar');
+     *
+     * // Fetch upcoming 10 events
+     * const timeMin = new Date().toISOString();
+     * const url = `https://www.googleapis.com/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=${timeMin}`;
+     *
+     * const calendarResponse = await fetch(url, {
+     *   headers: { 'Authorization': `Bearer ${googleToken}` }
+     * });
+     *
+     * const events = await calendarResponse.json();
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Slack User connection
+     * // Get Slack user token and list channels
+     * const slackToken = await base44.asServiceRole.connectors.getAccessToken('slack');
+     *
+     * // List all public and private channels
+     * const url = 'https://slack.com/api/conversations.list?types=public_channel,private_channel&limit=100';
+     *
+     * const slackResponse = await fetch(url, {
+     *   headers: { 'Authorization': `Bearer ${slackToken}` }
+     * });
+     *
+     * const data = await slackResponse.json();
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Slack Bot connection
+     * // Get Slack bot token and post a message with a custom bot identity
+     * const botToken = await base44.asServiceRole.connectors.getAccessToken('slackbot');
+     *
+     * const response = await fetch('https://slack.com/api/chat.postMessage', {
+     *   method: 'POST',
+     *   headers: {
+     *     'Authorization': `Bearer ${botToken}`,
+     *     'Content-Type': 'application/json'
+     *   },
+     *   body: JSON.stringify({
+     *     channel: '#alerts',
+     *     text: 'Deployment to production completed successfully.',
+     *     username: 'Deploy Bot',
+     *     icon_emoji: ':rocket:'
+     *   })
+     * });
+     *
+     * const result = await response.json();
+     * ```
+     */
+    getAccessToken(integrationType: ConnectorIntegrationType): Promise<string>;
+    /**
+     * Retrieves the OAuth access token and connection configuration for a specific [external integration type](#available-connectors).
+     *
+     * Some connectors require connection-specific parameters to build API calls.
+     * In such cases, the returned `connectionConfig` is an object with the additional parameters. If there are no extra parameters needed for the connection, the `connectionConfig` is `null`.
+     *
+     * For example, a service might need a subdomain to construct the API URL in
+     * the form of `{subdomain}.example.com`. In such a case the subdomain will be available as a property of the `connectionConfig` object.
+     *
+     * @param integrationType - The type of integration, such as `'googlecalendar'`, `'slack'`, `'slackbot'`, `'github'`, or `'discord'`. See [Available connectors](#available-connectors) for the full list.
+     * @returns Promise resolving to a {@link ConnectorConnectionResponse} with `accessToken` and `connectionConfig`.
+     *
+     * @example
+     * ```typescript
+     * // Google Calendar connection
+     * // Get Google Calendar OAuth token and fetch upcoming events
+     * const { accessToken } = await base44.asServiceRole.connectors.getConnection('googlecalendar');
+     *
+     * const timeMin = new Date().toISOString();
+     * const url = `https://www.googleapis.com/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=${timeMin}`;
+     *
+     * const calendarResponse = await fetch(url, {
+     *   headers: { Authorization: `Bearer ${accessToken}` }
+     * });
+     *
+     * const events = await calendarResponse.json();
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Slack connection
+     * // Get Slack OAuth token and list channels
+     * const { accessToken } = await base44.asServiceRole.connectors.getConnection('slack');
+     *
+     * const url = 'https://slack.com/api/conversations.list?types=public_channel,private_channel&limit=100';
+     *
+     * const slackResponse = await fetch(url, {
+     *   headers: { Authorization: `Bearer ${accessToken}` }
+     * });
+     *
+     * const data = await slackResponse.json();
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Using connectionConfig
+     * // Some connectors return a subdomain or other params needed to build the API URL
+     * const { accessToken, connectionConfig } = await base44.asServiceRole.connectors.getConnection('myservice');
+     *
+     * const subdomain = connectionConfig?.subdomain;
+     * const response = await fetch(
+     *   `https://${subdomain}.example.com/api/v1/resources`,
+     *   { headers: { Authorization: `Bearer ${accessToken}` } }
+     * );
+     *
+     * const data = await response.json();
+     * ```
+     */
+    getConnection(integrationType: ConnectorIntegrationType): Promise<ConnectorConnectionResponse>;
+}
+/**
+ * User-scoped connectors module for managing app-user OAuth connections.
+ *
+ * This module provides methods for app-user OAuth flows: initiating an OAuth connection,
+ * retrieving the end user's access token, and disconnecting the end user's connection.
+ *
+ * Unlike {@link ConnectorsModule | ConnectorsModule} which manages app-scoped tokens,
+ * this module manages tokens scoped to individual end users. Methods are keyed on
+ * the connector ID (the OrgConnector's database ID) rather than the integration type.
+ *
+ * Available via `base44.connectors`.
+ */
+export interface UserConnectorsModule {
+    /**
+     * Retrieves an OAuth access token for an end user's connection to a specific connector.
+     *
+     * Returns the OAuth token string that belongs to the currently authenticated end user
+     * for the specified connector.
+     *
+     * @param connectorId - The connector ID (OrgConnector database ID).
+     * @returns Promise resolving to the access token string.
+     *
+     * @example
+     * ```typescript
+     * // Get the end user's access token for a connector
+     * const token = await base44.connectors.getCurrentAppUserAccessToken('abc123def');
+     *
+     * const response = await fetch('https://www.googleapis.com/calendar/v3/calendars/primary/events', {
+     *   headers: { 'Authorization': `Bearer ${token}` }
+     * });
+     * ```
+     */
+    getCurrentAppUserAccessToken(connectorId: string): Promise<string>;
+    /**
+     * Initiates the app-user OAuth flow for a specific connector.
+     *
+     * Returns a redirect URL that the end user should be navigated to in order to
+     * authenticate with the external service. The scopes and integration type are
+     * derived from the connector configuration server-side.
+     *
+     * @param connectorId - The connector ID (OrgConnector database ID).
+     * @returns Promise resolving to the redirect URL string.
+     *
+     * @example
+     * ```typescript
+     * // Start OAuth for the end user
+     * const redirectUrl = await base44.connectors.connectAppUser('abc123def');
+     *
+     * // Redirect the user to the OAuth provider
+     * window.location.href = redirectUrl;
+     * ```
+     */
+    connectAppUser(connectorId: string): Promise<string>;
+    /**
+     * Disconnects an end user's OAuth connection for a specific connector.
+     *
+     * Removes the stored OAuth credentials for the currently authenticated end user's
+     * connection to the specified connector.
+     *
+     * @param connectorId - The connector ID (OrgConnector database ID).
+     * @returns Promise resolving when the connection has been removed.
+     *
+     * @example
+     * ```typescript
+     * // Disconnect the end user's connection
+     * await base44.connectors.disconnectAppUser('abc123def');
+     * ```
+     */
+    disconnectAppUser(connectorId: string): Promise<void>;
+}

package/dist/modules/connectors.types.js

@@ -0,0 +1 @@
+export {};

package/dist/modules/custom-integrations.d.ts

@@ -0,0 +1,11 @@
+import { AxiosInstance } from "axios";
+import { CustomIntegrationsModule } from "./custom-integrations.types.js";
+/**
+ * Creates the custom integrations module for the Base44 SDK.
+ *
+ * @param axios - Axios instance for making HTTP requests
+ * @param appId - Application ID
+ * @returns Custom integrations module with `call()` method
+ * @internal
+ */
+export declare function createCustomIntegrationsModule(axios: AxiosInstance, appId: string): CustomIntegrationsModule;

package/dist/modules/custom-integrations.js

@@ -0,0 +1,32 @@
+/**
+ * Creates the custom integrations module for the Base44 SDK.
+ *
+ * @param axios - Axios instance for making HTTP requests
+ * @param appId - Application ID
+ * @returns Custom integrations module with `call()` method
+ * @internal
+ */
+export function createCustomIntegrationsModule(axios, appId) {
+    return {
+        async call(slug, operationId, params) {
+            // Validate required parameters
+            if (!(slug === null || slug === void 0 ? void 0 : slug.trim())) {
+                throw new Error("Integration slug is required and cannot be empty");
+            }
+            if (!(operationId === null || operationId === void 0 ? void 0 : operationId.trim())) {
+                throw new Error("Operation ID is required and cannot be empty");
+            }
+            // Convert camelCase to snake_case for Python backend
+            const { pathParams, queryParams, ...rest } = params !== null && params !== void 0 ? params : {};
+            const body = {
+                ...rest,
+                ...(pathParams && { path_params: pathParams }),
+                ...(queryParams && { query_params: queryParams }),
+            };
+            // Make the API call
+            const response = await axios.post(`/apps/${appId}/integrations/custom/${slug}/${operationId}`, body);
+            // The axios interceptor extracts response.data, so we get the payload directly
+            return response;
+        },
+    };
+}

package/dist/modules/custom-integrations.types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Parameters for calling a custom integration endpoint.
+ * @internal
+ */
+export interface CustomIntegrationCallParams {
+    /**
+     * Request body payload to send to the external API.
+     */
+    payload?: Record<string, any>;
+    /**
+     * Path parameters to substitute in the URL. For example, `{ owner: "user", repo: "repo" }`.
+     */
+    pathParams?: Record<string, string>;
+    /**
+     * Query string parameters to append to the URL.
+     */
+    queryParams?: Record<string, any>;
+}
+/**
+ * Response from a custom integration call.
+ * @internal
+ */
+export interface CustomIntegrationCallResponse {
+    /**
+     * Whether the external API returned a 2xx status code.
+     */
+    success: boolean;
+    /**
+     * The HTTP status code returned by the external API.
+     */
+    status_code: number;
+    /**
+     * The response data from the external API.
+     * Can be any JSON-serializable value depending on the external API's response.
+     */
+    data: any;
+}
+/**
+ * Module for calling custom pre-configured API integrations.
+ *
+ * Custom integrations allow workspace administrators to connect any external API by importing an OpenAPI specification. Apps in the workspace can then call these integrations using this module.
+ */
+export interface CustomIntegrationsModule {
+    /**
+     * Call a custom integration endpoint.
+     *
+     * @param slug - The integration's unique identifier, as defined by the workspace admin.
+     * @param operationId - The endpoint in `method:path` format. For example, `"get:/contacts"`, or `"post:/users/{id}"`. The method is the HTTP verb in lowercase and the path matches the OpenAPI specification.
+     * @param params - Optional parameters including payload, pathParams, and queryParams.
+     * @returns Promise resolving to the integration call response.
+     *
+     * @throws {Error} If slug is not provided.
+     * @throws {Error} If operationId is not provided.
+     * @throws {Base44Error} If the integration or operation is not found (404).
+     * @throws {Base44Error} If the external API call fails (502).
+     * @throws {Base44Error} If the request times out (504).
+     *
+     * @example
+     * ```typescript
+     * // Call a custom CRM integration
+     * const response = await base44.integrations.custom.call(
+     *   "my-crm",
+     *   "get:/contacts",
+     *   { queryParams: { limit: 10 } }
+     * );
+     *
+     * if (response.success) {
+     *   console.log("Contacts:", response.data);
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Call with path params and request body
+     * const response = await base44.integrations.custom.call(
+     *   "github",
+     *   "post:/repos/{owner}/{repo}/issues",
+     *   {
+     *     pathParams: { owner: "myorg", repo: "myrepo" },
+     *     payload: {
+     *       title: "Bug report",
+     *       body: "Something is broken"
+     *     }
+     *   }
+     * );
+     * ```
+     */
+    call(slug: string, operationId: string, params?: CustomIntegrationCallParams): Promise<CustomIntegrationCallResponse>;
+}

package/dist/modules/custom-integrations.types.js

@@ -0,0 +1 @@
+export {};

package/dist/modules/entities.d.ts

@@ -0,0 +1,20 @@
+import { AxiosInstance } from "axios";
+import { EntitiesModule } from "./entities.types";
+import { RoomsSocket } from "../utils/socket-utils.js";
+/**
+ * Configuration for the entities module.
+ * @internal
+ */
+export interface EntitiesModuleConfig {
+    axios: AxiosInstance;
+    appId: string;
+    getSocket: () => ReturnType<typeof RoomsSocket>;
+}
+/**
+ * Creates the entities module for the Base44 SDK.
+ *
+ * @param config - Configuration object containing axios, appId, and getSocket
+ * @returns Entities module with dynamic entity access
+ * @internal
+ */
+export declare function createEntitiesModule(config: EntitiesModuleConfig): EntitiesModule;

package/dist/modules/entities.js

@@ -0,0 +1,149 @@
+/**
+ * Creates the entities module for the Base44 SDK.
+ *
+ * @param config - Configuration object containing axios, appId, and getSocket
+ * @returns Entities module with dynamic entity access
+ * @internal
+ */
+export function createEntitiesModule(config) {
+    const { axios, appId, getSocket } = config;
+    // Using Proxy to dynamically handle entity names
+    return new Proxy({}, {
+        get(target, entityName) {
+            // Don't create handlers for internal properties
+            if (typeof entityName !== "string" ||
+                entityName === "then" ||
+                entityName.startsWith("_")) {
+                return undefined;
+            }
+            // Create entity handler
+            return createEntityHandler(axios, appId, entityName, getSocket);
+        },
+    });
+}
+/**
+ * Parses the realtime message data and extracts event information.
+ * @internal
+ */
+function parseRealtimeMessage(dataStr) {
+    var _a;
+    try {
+        const parsed = JSON.parse(dataStr);
+        return {
+            type: parsed.type,
+            data: parsed.data,
+            id: parsed.id || ((_a = parsed.data) === null || _a === void 0 ? void 0 : _a.id),
+            timestamp: parsed.timestamp || new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        console.warn("[Base44 SDK] Failed to parse realtime message:", error);
+        return null;
+    }
+}
+/**
+ * Creates a handler for a specific entity.
+ *
+ * @param axios - Axios instance
+ * @param appId - Application ID
+ * @param entityName - Entity name
+ * @param getSocket - Function to get the socket instance
+ * @returns Entity handler with CRUD methods
+ * @internal
+ */
+function createEntityHandler(axios, appId, entityName, getSocket) {
+    const baseURL = `/apps/${appId}/entities/${entityName}`;
+    return {
+        // List entities with optional pagination and sorting
+        async list(sort, limit, skip, fields) {
+            const params = {};
+            if (sort)
+                params.sort = sort;
+            if (limit)
+                params.limit = limit;
+            if (skip)
+                params.skip = skip;
+            if (fields)
+                params.fields = Array.isArray(fields) ? fields.join(",") : fields;
+            return axios.get(baseURL, { params });
+        },
+        // Filter entities based on query
+        async filter(query, sort, limit, skip, fields) {
+            const params = {
+                q: JSON.stringify(query),
+            };
+            if (sort)
+                params.sort = sort;
+            if (limit)
+                params.limit = limit;
+            if (skip)
+                params.skip = skip;
+            if (fields)
+                params.fields = Array.isArray(fields) ? fields.join(",") : fields;
+            return axios.get(baseURL, { params });
+        },
+        // Get entity by ID
+        async get(id) {
+            return axios.get(`${baseURL}/${id}`);
+        },
+        // Create new entity
+        async create(data) {
+            return axios.post(baseURL, data);
+        },
+        // Update entity by ID
+        async update(id, data) {
+            return axios.put(`${baseURL}/${id}`, data);
+        },
+        // Delete entity by ID
+        async delete(id) {
+            return axios.delete(`${baseURL}/${id}`);
+        },
+        // Delete multiple entities based on query
+        async deleteMany(query) {
+            return axios.delete(baseURL, { data: query });
+        },
+        // Create multiple entities in a single request
+        async bulkCreate(data) {
+            return axios.post(`${baseURL}/bulk`, data);
+        },
+        // Update multiple entities matching a query using a MongoDB update operator
+        async updateMany(query, data) {
+            return axios.patch(`${baseURL}/update-many`, { query, data });
+        },
+        // Update multiple entities by ID, each with its own update data
+        async bulkUpdate(data) {
+            return axios.put(`${baseURL}/bulk`, data);
+        },
+        // Import entities from a file
+        async importEntities(file) {
+            const formData = new FormData();
+            formData.append("file", file, file.name);
+            return axios.post(`${baseURL}/import`, formData, {
+                headers: {
+                    "Content-Type": "multipart/form-data",
+                },
+            });
+        },
+        // Subscribe to realtime updates
+        subscribe(callback) {
+            const room = `entities:${appId}:${entityName}`;
+            // Get the socket and subscribe to the room
+            const socket = getSocket();
+            const unsubscribe = socket.subscribeToRoom(room, {
+                update_model: (msg) => {
+                    const event = parseRealtimeMessage(msg.data);
+                    if (!event) {
+                        return;
+                    }
+                    try {
+                        callback(event);
+                    }
+                    catch (error) {
+                        console.error("[Base44 SDK] Subscription callback error:", error);
+                    }
+                },
+            });
+            return unsubscribe;
+        },
+    };
+}