@base44-preview/sdk 0.8.18-pr.116.3508d64 → 0.8.18-pr.117.1fc9d15

package/dist/index.d.ts

@@ -4,11 +4,11 @@ import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl } from
 export { createClient, createClientFromRequest, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
 export type { Base44Client, CreateClientConfig, CreateClientOptions, Base44ErrorJSON, };
 export * from "./types.js";
-export type { EntitiesModule, EntityHandler, RealtimeEventType, RealtimeEvent, RealtimeCallback, } from "./modules/entities.types.js";
+export type { EntitiesModule, EntityHandler, EntityTypeRegistry, RealtimeEventType, RealtimeEvent, RealtimeCallback, } from "./modules/entities.types.js";
 export type { AuthModule, LoginResponse, RegisterParams, VerifyOtpParams, ChangePasswordParams, ResetPasswordParams, User, } from "./modules/auth.types.js";
 export type { IntegrationsModule, IntegrationPackage, IntegrationEndpointFunction, CoreIntegrations, InvokeLLMParams, GenerateImageParams, GenerateImageResult, UploadFileParams, UploadFileResult, SendEmailParams, SendEmailResult, ExtractDataFromUploadedFileParams, ExtractDataFromUploadedFileResult, UploadPrivateFileParams, UploadPrivateFileResult, CreateFileSignedUrlParams, CreateFileSignedUrlResult, } from "./modules/integrations.types.js";
-export type { FunctionsModule } from "./modules/functions.types.js";
-export type { AgentsModule, AgentConversation, AgentMessage, AgentMessageReasoning, AgentMessageToolCall, AgentMessageUsage, AgentMessageCustomContext, AgentMessageMetadata, CreateConversationParams, } from "./modules/agents.types.js";
+export type { FunctionsModule, FunctionNameRegistry, } from "./modules/functions.types.js";
+export type { AgentsModule, 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 { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 export type { ConnectorsModule } from "./modules/connectors.types.js";

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

@@ -1,6 +1,34 @@
 import { AxiosInstance } from "axios";
 import { RoomsSocket } from "../utils/socket-utils.js";
 import { ModelFilterParams } from "../types.js";
+/**
+ * Registry of agent names.
+ *
+ * This interface is designed to be augmented by generated type declaration files.
+ * When augmented, it enables autocomplete for agent names in methods like `createConversation`.
+ *
+ * @example
+ * ```typescript
+ * // In your generated types.d.ts file:
+ * declare module '@base44/sdk' {
+ *   interface AgentNameRegistry {
+ *     support_agent: true;
+ *     sales_bot: true;
+ *   }
+ * }
+ *
+ * // Then in your code:
+ * await base44.agents.createConversation({
+ *   agent_name: 'support_agent'  // ✅ Autocomplete shows: 'support_agent' | 'sales_bot'
+ * });
+ * ```
+ */
+export interface AgentNameRegistry {
+}
+/**
+ * Agent name type - uses registry keys if augmented, otherwise falls back to string.
+ */
+export type AgentName = keyof AgentNameRegistry extends never ? string : keyof AgentNameRegistry;
 /**
  * Reasoning information for an agent message.
  *
@@ -126,8 +154,8 @@ export interface AgentMessage {
  * Parameters for creating a new conversation.
  */
 export interface CreateConversationParams {
-    /** The name of the agent to create a conversation with. */
-    agent_name: string;
+    /** The name of the agent to create a conversation with. When AgentNameRegistry is augmented, provides autocomplete. */
+    agent_name: AgentName;
     /** Optional metadata to attach to the conversation. */
     metadata?: Record<string, any>;
 }
@@ -331,7 +359,7 @@ export interface AgentsModule {
      * Generates a URL that users can use to connect with the agent through WhatsApp.
      * The URL includes authentication if a token is available.
      *
-     * @param agentName - The name of the agent.
+     * @param agentName - The name of the agent. When AgentNameRegistry is augmented, provides autocomplete.
      * @returns WhatsApp connection URL.
      *
      * @example
@@ -342,5 +370,5 @@ export interface AgentsModule {
      * // User can open this URL to start a WhatsApp conversation
      * ```
      */
-    getWhatsAppConnectURL(agentName: string): string;
+    getWhatsAppConnectURL(agentName: AgentName): string;
 }

package/dist/modules/auth.js

@@ -26,23 +26,9 @@ export function createAuthModule(axios, functionsAxiosClient, appId, options) {
                 throw new Error("Login method can only be used in a browser environment");
             }
             // If nextUrl is not provided, use the current URL
-            let redirectUrl = nextUrl
+            const redirectUrl = nextUrl
                 ? new URL(nextUrl, window.location.origin).toString()
                 : window.location.href;
-            // Prevent redirect loops: if redirectUrl is already a login URL, extract the original from_url
-            try {
-                const parsedUrl = new URL(redirectUrl);
-                if (parsedUrl.pathname.endsWith("/login")) {
-                    const originalFromUrl = parsedUrl.searchParams.get("from_url");
-                    if (originalFromUrl) {
-                        // Use the original destination instead of nesting login URLs
-                        redirectUrl = originalFromUrl;
-                    }
-                }
-            }
-            catch (_b) {
-                // If URL parsing fails, continue with the original redirectUrl
-            }
             // Build the login URL
             const loginUrl = `${(_a = options.appBaseUrl) !== null && _a !== void 0 ? _a : ""}/login?from_url=${encodeURIComponent(redirectUrl)}`;
             // Redirect to the login page

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

@@ -4,12 +4,14 @@
 export type RealtimeEventType = "create" | "update" | "delete";
 /**
  * Payload received when a realtime event occurs.
+ *
+ * @typeParam T - The entity type for the data field. Defaults to `any`.
  */
-export interface RealtimeEvent {
+export interface RealtimeEvent<T = any> {
     /** The type of change that occurred */
     type: RealtimeEventType;
     /** The entity data */
-    data: any;
+    data: T;
     /** The unique identifier of the affected entity */
     id: string;
     /** ISO 8601 timestamp of when the event occurred */
@@ -17,14 +19,90 @@ export interface RealtimeEvent {
 }
 /**
  * Callback function invoked when a realtime event occurs.
+ *
+ * @typeParam T - The entity type for the event data. Defaults to `any`.
+ */
+export type RealtimeCallback<T = any> = (event: RealtimeEvent<T>) => void;
+/**
+ * Result returned when deleting a single entity.
+ */
+export interface DeleteResult {
+    /** Whether the deletion was successful */
+    success: boolean;
+}
+/**
+ * Result returned when deleting multiple entities.
+ */
+export interface DeleteManyResult {
+    /** Whether the deletion was successful */
+    success: boolean;
+    /** Number of entities that were deleted */
+    deleted: number;
+}
+/**
+ * Result returned when importing entities from a file.
+ *
+ * @typeParam T - The entity type for imported records. Defaults to `any`.
  */
-export type RealtimeCallback = (event: RealtimeEvent) => void;
+export interface ImportResult<T = any> {
+    /** Status of the import operation */
+    status: "success" | "error";
+    /** Details message, e.g., "Successfully imported 3 entities with RLS enforcement" */
+    details: string | null;
+    /** Array of created entity objects when successful, or null on error */
+    output: T[] | null;
+}
+/**
+ * Sort field type for entity queries.
+ *
+ * Supports ascending (no prefix or `'+'`) and descending (`'-'`) sorting.
+ *
+ * @typeParam T - The entity type to derive sortable fields from.
+ *
+ * @example
+ * ```typescript
+ * // Ascending sort (default)
+ * 'created_date'
+ * '+created_date'
+ *
+ * // Descending sort
+ * '-created_date'
+ * ```
+ */
+export type SortField<T> = (keyof T & string) | `+${keyof T & string}` | `-${keyof T & string}`;
+/**
+ * Registry mapping entity names to their TypeScript types.
+ *
+ * This interface is designed to be augmented by generated type declaration files.
+ * When augmented, it enables type-safe entity access throughout your application.
+ *
+ * @example
+ * ```typescript
+ * // In your generated types.d.ts file:
+ * declare module '@base44/sdk' {
+ *   interface EntityTypeRegistry {
+ *     Task: { title: string; completed: boolean };
+ *     User: { email: string; name: string };
+ *   }
+ * }
+ *
+ * // Then in your code:
+ * const task = await base44.entities.Task.create({
+ *   title: 'Buy groceries',  // ✅ Type-checked
+ *   completed: false
+ * });
+ * ```
+ */
+export interface EntityTypeRegistry {
+}
 /**
  * Entity handler providing CRUD operations for a specific entity type.
  *
  * Each entity in the app gets a handler with these methods for managing data.
+ *
+ * @typeParam T - The entity type. Defaults to `any` for backward compatibility.
  */
-export interface EntityHandler {
+export interface EntityHandler<T = any> {
     /**
      * Lists records with optional pagination and sorting.
      *
@@ -33,11 +111,12 @@ export interface EntityHandler {
      *
      * **Note:** The maximum limit is 5,000 items per request.
      *
+     * @typeParam K - The fields to include in the response. Defaults to all fields.
      * @param sort - Sort parameter, such as `'-created_date'` for descending. Defaults to `'-created_date'`.
      * @param limit - Maximum number of results to return. Defaults to `50`.
      * @param skip - Number of results to skip for pagination. Defaults to `0`.
      * @param fields - Array of field names to include in the response. Defaults to all fields.
-     * @returns Promise resolving to an array of records.
+     * @returns Promise resolving to an array of records with selected fields.
      *
      * @example
      * ```typescript
@@ -64,7 +143,7 @@ export interface EntityHandler {
      * const fields = await base44.entities.MyEntity.list('-created_date', 10, 0, ['name', 'status']);
      * ```
      */
-    list(sort?: string, limit?: number, skip?: number, fields?: string[]): Promise<any>;
+    list<K extends keyof T = keyof T>(sort?: SortField<T>, limit?: number, skip?: number, fields?: K[]): Promise<Pick<T, K>[]>;
     /**
      * Filters records based on a query.
      *
@@ -73,6 +152,7 @@ export interface EntityHandler {
      *
      * **Note:** The maximum limit is 5,000 items per request.
      *
+     * @typeParam K - The fields to include in the response. Defaults to all fields.
      * @param query - Query object with field-value pairs. Each key should be a field name
      * from your entity schema, and each value is the criteria to match. Records matching all
      * specified criteria are returned. Field names are case-sensitive.
@@ -80,7 +160,7 @@ export interface EntityHandler {
      * @param limit - Maximum number of results to return. Defaults to `50`.
      * @param skip - Number of results to skip for pagination. Defaults to `0`.
      * @param fields - Array of field names to include in the response. Defaults to all fields.
-     * @returns Promise resolving to an array of filtered records.
+     * @returns Promise resolving to an array of filtered records with selected fields.
      *
      * @example
      * ```typescript
@@ -122,7 +202,7 @@ export interface EntityHandler {
      * );
      * ```
      */
-    filter(query: Record<string, any>, sort?: string, limit?: number, skip?: number, fields?: string[]): Promise<any>;
+    filter<K extends keyof T = keyof T>(query: Partial<T>, sort?: SortField<T>, limit?: number, skip?: number, fields?: K[]): Promise<Pick<T, K>[]>;
     /**
      * Gets a single record by ID.
      *
@@ -138,7 +218,7 @@ export interface EntityHandler {
      * console.log(record.name);
      * ```
      */
-    get(id: string): Promise<any>;
+    get(id: string): Promise<T>;
     /**
      * Creates a new record.
      *
@@ -158,7 +238,7 @@ export interface EntityHandler {
      * console.log('Created record with ID:', newRecord.id);
      * ```
      */
-    create(data: Record<string, any>): Promise<any>;
+    create(data: Partial<T>): Promise<T>;
     /**
      * Updates an existing record.
      *
@@ -187,7 +267,7 @@ export interface EntityHandler {
      * });
      * ```
      */
-    update(id: string, data: Record<string, any>): Promise<any>;
+    update(id: string, data: Partial<T>): Promise<T>;
     /**
      * Deletes a single record by ID.
      *
@@ -200,10 +280,10 @@ export interface EntityHandler {
      * ```typescript
      * // Delete a record
      * const result = await base44.entities.MyEntity.delete('entity-123');
-     * console.log('Deleted:', result);
+     * console.log('Deleted:', result.success);
      * ```
      */
-    delete(id: string): Promise<any>;
+    delete(id: string): Promise<DeleteResult>;
     /**
      * Deletes multiple records matching a query.
      *
@@ -224,7 +304,7 @@ export interface EntityHandler {
      * console.log('Deleted:', result);
      * ```
      */
-    deleteMany(query: Record<string, any>): Promise<any>;
+    deleteMany(query: Partial<T>): Promise<DeleteManyResult>;
     /**
      * Creates multiple records in a single request.
      *
@@ -244,7 +324,7 @@ export interface EntityHandler {
      * ]);
      * ```
      */
-    bulkCreate(data: Record<string, any>[]): Promise<any>;
+    bulkCreate(data: Partial<T>[]): Promise<T[]>;
     /**
      * Imports records from a file.
      *
@@ -252,7 +332,7 @@ export interface EntityHandler {
      * The file format should match your entity structure. Requires a browser environment and can't be used in the backend.
      *
      * @param file - File object to import.
-     * @returns Promise resolving to the import result.
+     * @returns Promise resolving to the import result containing status, details, and created records.
      *
      * @example
      * ```typescript
@@ -261,12 +341,14 @@ export interface EntityHandler {
      *   const file = event.target.files?.[0];
      *   if (file) {
      *     const result = await base44.entities.MyEntity.importEntities(file);
-     *     console.log(`Imported ${result.count} records`);
+     *     if (result.status === 'success' && result.output) {
+     *       console.log(`Imported ${result.output.length} records`);
+     *     }
      *   }
      * };
      * ```
      */
-    importEntities(file: File): Promise<any>;
+    importEntities(file: File): Promise<ImportResult<T>>;
     /**
      * Subscribes to realtime updates for all records of this entity type.
      *
@@ -292,8 +374,22 @@ export interface EntityHandler {
      * unsubscribe();
      * ```
      */
-    subscribe(callback: RealtimeCallback): () => void;
+    subscribe(callback: RealtimeCallback<T>): () => void;
 }
+/**
+ * Typed entities module - maps registry keys to typed handlers.
+ * Only used when EntityTypeRegistry is augmented.
+ */
+type TypedEntitiesModule = {
+    [K in keyof EntityTypeRegistry]: EntityHandler<EntityTypeRegistry[K]>;
+};
+/**
+ * Dynamic entities module - allows any entity name with untyped handler.
+ * Used as fallback and for entities not in the registry.
+ */
+type DynamicEntitiesModule = {
+    [entityName: string]: EntityHandler<any>;
+};
 /**
  * Entities module for managing app data.
  *
@@ -303,6 +399,9 @@ export interface EntityHandler {
  * Entities are accessed dynamically using the pattern:
  * `base44.entities.EntityName.method()`
  *
+ * When {@link EntityTypeRegistry} is augmented (via generated types.d.ts),
+ * entity access becomes type-safe with autocomplete and type checking.
+ *
  * This module is available to use with a client in all three authentication modes:
  *
  * - **Anonymous or User authentication** (`base44.entities`): Access is scoped to the current user's permissions. Anonymous users can only access public entities, while authenticated users can access entities they have permission to view or modify.
@@ -327,18 +426,5 @@ export interface EntityHandler {
  * const allUsers = await base44.asServiceRole.entities.User.list();
  * ```
  */
-export interface EntitiesModule {
-    /**
-     * Access any entity by name.
-     *
-     * Use this to access entities defined in the app.
-     *
-     * @example
-     * ```typescript
-     * // Access entities dynamically
-     * base44.entities.MyEntity
-     * base44.entities.AnotherEntity
-     * ```
-     */
-    [entityName: string]: EntityHandler;
-}
+export type EntitiesModule = TypedEntitiesModule & DynamicEntitiesModule;
+export {};

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

@@ -1,3 +1,31 @@
+/**
+ * Registry of function names.
+ *
+ * This interface is designed to be augmented by generated type declaration files.
+ * When augmented, it enables autocomplete for function names in the `invoke` method.
+ *
+ * @example
+ * ```typescript
+ * // In your generated types.d.ts file:
+ * declare module '@base44/sdk' {
+ *   interface FunctionNameRegistry {
+ *     calculateTotal: true;
+ *     processImage: true;
+ *   }
+ * }
+ *
+ * // Then in your code:
+ * await base44.functions.invoke('calculateTotal', { ... });
+ * //                            ^^^^^^^^^^^^^^^^
+ * //                            ✅ Autocomplete shows: 'calculateTotal' | 'processImage'
+ * ```
+ */
+export interface FunctionNameRegistry {
+}
+/**
+ * Function name type - uses registry keys if augmented, otherwise falls back to string.
+ */
+export type FunctionName = keyof FunctionNameRegistry extends never ? string : keyof FunctionNameRegistry;
 /**
  * Functions module for invoking custom backend functions.
  *
@@ -17,7 +45,7 @@ export interface FunctionsModule {
      * the result. If any parameter is a `File` object, the request will automatically be
      * sent as `multipart/form-data`. Otherwise, it will be sent as JSON.
      *
-     * @param functionName - The name of the function to invoke.
+     * @param functionName - The name of the function to invoke. When FunctionNameRegistry is augmented, provides autocomplete.
      * @param data - An object containing named parameters for the function.
      * @returns Promise resolving to the function's response. The `data` property contains the data returned by the function, if there is any.
      *
@@ -46,5 +74,5 @@ export interface FunctionsModule {
      * };
      * ```
      */
-    invoke(functionName: string, data: Record<string, any>): Promise<any>;
+    invoke(functionName: FunctionName, data?: Record<string, any>): Promise<any>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.18-pr.116.3508d64",
+  "version": "0.8.18-pr.117.1fc9d15",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",