@base44-preview/sdk 0.8.18-pr.117.84e1a4f → 0.8.18-pr.120.baff2e3

package/README.md

@@ -9,31 +9,32 @@ You can use it in two ways:
 
 ## Installation
 
-Install the SDK via npm:
+**Inside Base44 apps**: The SDK is already available. No installation needed.
+
+**External apps**: Install the SDK via npm:
 
 ```bash
 npm install @base44/sdk
 ```
 
-> **Note**: In Base44-generated apps, the SDK is already installed for you.
-
 ## Modules
 
 The SDK provides access to Base44's functionality through the following modules:
 
 - **[`agents`](https://docs.base44.com/developers/references/sdk/docs/interfaces/agents)**: Interact with AI agents and manage conversations.
+- **[`analytics`](https://docs.base44.com/developers/references/sdk/docs/interfaces/analytics)**: Track custom events in your app.
 - **[`app-logs`](https://docs.base44.com/developers/references/sdk/docs/interfaces/app-logs)**: Access and query app logs.
 - **[`auth`](https://docs.base44.com/developers/references/sdk/docs/interfaces/auth)**: Manage user authentication, registration, and session handling.
 - **[`connectors`](https://docs.base44.com/developers/references/sdk/docs/interfaces/connectors)**: Manage OAuth connections and access tokens for third-party services.
 - **[`entities`](https://docs.base44.com/developers/references/sdk/docs/interfaces/entities)**: Work with your app's data entities using CRUD operations.
 - **[`functions`](https://docs.base44.com/developers/references/sdk/docs/interfaces/functions)**: Execute backend functions.
-- **[`integrations`](https://docs.base44.com/developers/references/sdk/docs/type-aliases/integrations)**: Pre-built integrations for external services.
+- **[`integrations`](https://docs.base44.com/developers/references/sdk/docs/type-aliases/integrations)**: Access pre-built and third-party integrations.
 
-## Quick starts
+## Quickstarts
 
-How you get started depends on your context:
+How you get started depends on whether you're working inside a Base44-generated app or building your own.
 
-### Inside a Base44 app
+### Inside Base44 apps
 
 In Base44-generated apps, the client is pre-configured. Just import and use it:
 
@@ -58,32 +59,32 @@ const tasks = await base44.entities.Task.list();
 
 ### External apps
 
-When using Base44 as a backend for your own app, create and configure the client yourself:
+When using Base44 as a backend for your own app, install the SDK and create the client yourself:
 
 ```typescript
-import { createClient } from '@base44/sdk';
+import { createClient } from "@base44/sdk";
 
 // Create a client for your Base44 app
 const base44 = createClient({
-  appId: 'your-app-id'  // Find this in the Base44 editor URL
+  appId: "your-app-id", // Find this in the Base44 editor URL
 });
 
-// Read public data (anonymous access)
+// Read public data
 const products = await base44.entities.Products.list();
 
 // Authenticate a user (token is automatically set)
-await base44.auth.loginViaEmailPassword('user@example.com', 'password');
+await base44.auth.loginViaEmailPassword("user@example.com", "password");
 
-// Now operations use the authenticated user's permissions
+// Access user's data
 const userOrders = await base44.entities.Orders.list();
 ```
 
 ### Service role
 
-For backend code that needs admin-level access, use the service role. Service role is only available in Base44-hosted backend functions:
+By default, the client operates with user-level permissions, limiting access to what the current user can see and do. The service role provides elevated permissions for backend operations and is only available in Base44-hosted backend functions. External backends can't use service role permissions.
 
 ```typescript
-import { createClientFromRequest } from 'npm:@base44/sdk';
+import { createClientFromRequest } from "npm:@base44/sdk";
 
 Deno.serve(async (req) => {
   const base44 = createClientFromRequest(req);
@@ -97,7 +98,15 @@ Deno.serve(async (req) => {
 
 ## Learn more
 
-For complete documentation, guides, and API reference, visit the **[Base44 SDK Documentation](https://docs.base44.com/developers/landing)**.
+The best way to get started with the JavaScript SDK is to have Base44 build an app for you. Once you have an app, you can explore the generated code and experiment with the SDK to see how it works in practice. You can also ask Base44 to demonstrate specific features of the SDK.
+
+For a deeper understanding, check out these guides:
+
+1. [Base44 client](https://docs.base44.com/developers/references/sdk/getting-started/client) - Work with the client in frontend, backend, and external app contexts.
+2. [Work with data](https://docs.base44.com/developers/references/sdk/getting-started/work-with-data) - Create, read, update, and delete data.
+3. [Common SDK patterns](https://docs.base44.com/developers/references/sdk/getting-started/work-with-sdk) - Authentication, integrations, functions, and error handling.
+
+For the complete documentation and API reference, visit the **[Base44 Developer Docs](https://docs.base44.com/developers/home)**.
 
 ## Development
 

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, EntityTypeRegistry, RealtimeEventType, RealtimeEvent, RealtimeCallback, } from "./modules/entities.types.js";
+export type { EntitiesModule, EntityHandler, 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, 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 { FunctionsModule } from "./modules/functions.types.js";
+export type { AgentsModule, 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,16 +1,6 @@
 import { AxiosInstance } from "axios";
 import { RoomsSocket } from "../utils/socket-utils.js";
 import { ModelFilterParams } from "../types.js";
-/**
- * Registry of agent names.
- * Augment this interface to enable autocomplete for agent names.
- */
-export interface AgentNameRegistry {
-}
-/**
- * Agent name type - uses registry keys if augmented, otherwise string.
- */
-export type AgentName = keyof AgentNameRegistry extends never ? string : keyof AgentNameRegistry;
 /**
  * Reasoning information for an agent message.
  *
@@ -137,7 +127,7 @@ export interface AgentMessage {
  */
 export interface CreateConversationParams {
     /** The name of the agent to create a conversation with. */
-    agent_name: AgentName;
+    agent_name: string;
     /** Optional metadata to attach to the conversation. */
     metadata?: Record<string, any>;
 }
@@ -352,5 +342,5 @@ export interface AgentsModule {
      * // User can open this URL to start a WhatsApp conversation
      * ```
      */
-    getWhatsAppConnectURL(agentName: AgentName): string;
+    getWhatsAppConnectURL(agentName: string): string;
 }

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

@@ -70,12 +70,6 @@ export interface ImportResult<T = any> {
  * ```
  */
 export type SortField<T> = (keyof T & string) | `+${keyof T & string}` | `-${keyof T & string}`;
-/**
- * Registry mapping entity names to their TypeScript types.
- * Augment this interface to enable type-safe entity access.
- */
-export interface EntityTypeRegistry {
-}
 /**
  * Entity handler providing CRUD operations for a specific entity type.
  *
@@ -282,7 +276,7 @@ export interface EntityHandler<T = any> {
      *   status: 'completed',
      *   priority: 'low'
      * });
-     * console.log('Deleted:', result.deleted);
+     * console.log('Deleted:', result);
      * ```
      */
     deleteMany(query: Partial<T>): Promise<DeleteManyResult>;
@@ -323,7 +317,7 @@ export interface EntityHandler<T = any> {
      *   if (file) {
      *     const result = await base44.entities.MyEntity.importEntities(file);
      *     if (result.status === 'success' && result.output) {
-     *       console.log(`Imported ${result.output?.length} records`);
+     *       console.log(`Imported ${result.output.length} records`);
      *     }
      *   }
      * };
@@ -357,18 +351,6 @@ export interface EntityHandler<T = any> {
      */
     subscribe(callback: RealtimeCallback<T>): () => void;
 }
-/**
- * Typed entities module - maps registry keys to typed handlers.
- */
-type TypedEntitiesModule = {
-    [K in keyof EntityTypeRegistry]: EntityHandler<EntityTypeRegistry[K]>;
-};
-/**
- * Dynamic entities module - allows any entity name with untyped handler.
- */
-type DynamicEntitiesModule = {
-    [entityName: string]: EntityHandler<any>;
-};
 /**
  * Entities module for managing app data.
  *
@@ -402,5 +384,18 @@ type DynamicEntitiesModule = {
  * const allUsers = await base44.asServiceRole.entities.User.list();
  * ```
  */
-export type EntitiesModule = TypedEntitiesModule & DynamicEntitiesModule;
-export {};
+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<any>;
+}

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

@@ -1,13 +1,3 @@
-/**
- * Registry of function names.
- * Augment this interface to enable autocomplete for function names.
- */
-export interface FunctionNameRegistry {
-}
-/**
- * Function name type - uses registry keys if augmented, otherwise string.
- */
-export type FunctionName = keyof FunctionNameRegistry extends never ? string : keyof FunctionNameRegistry;
 /**
  * Functions module for invoking custom backend functions.
  *
@@ -56,5 +46,5 @@ export interface FunctionsModule {
      * };
      * ```
      */
-    invoke(functionName: FunctionName, data?: Record<string, any>): Promise<any>;
+    invoke(functionName: string, data: Record<string, any>): Promise<any>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.18-pr.117.84e1a4f",
+  "version": "0.8.18-pr.120.baff2e3",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",