@base44-preview/sdk 0.8.26-pr.164.f8d1b0e → 0.8.26-pr.169.4ce3986

package/dist/index.d.ts

@@ -4,7 +4,7 @@ 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 { DeleteManyResult, DeleteResult, EntitiesModule, EntityHandler, EntityRecord, EntityTypeRegistry, ImportResult, RealtimeEventType, RealtimeEvent, RealtimeCallback, SortField, UpdateManyResult, } from "./modules/entities.types.js";
+export type { DeleteManyResult, DeleteResult, EntitiesModule, EntityFilterOperators, EntityFilterQuery, EntityFilterValue, EntityHandler, EntityRecord, EntityTypeRegistry, ImportResult, RealtimeEventType, RealtimeEvent, RealtimeCallback, SortField, UpdateManyResult, } from "./modules/entities.types.js";
 export type { AuthModule, LoginResponse, RegisterParams, VerifyOtpParams, ChangePasswordParams, ResetPasswordParams, User, } from "./modules/auth.types.js";
 export type { IntegrationsModule, IntegrationEndpointFunction, CoreIntegrations, InvokeLLMParams, GenerateImageParams, GenerateImageResult, UploadFileParams, UploadFileResult, SendEmailParams, SendEmailResult, ExtractDataFromUploadedFileParams, ExtractDataFromUploadedFileResult, UploadPrivateFileParams, UploadPrivateFileResult, CreateFileSignedUrlParams, CreateFileSignedUrlResult, } from "./modules/integrations.types.js";
 export type { FunctionsModule, FunctionName, FunctionNameRegistry, } from "./modules/functions.types.js";

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

@@ -43,7 +43,7 @@ export interface AgentMessageToolCall {
     /** Arguments passed to the tool as JSON string. */
     arguments_string: string;
     /** Status of the tool call. */
-    status: "running" | "success" | "error" | "stopped";
+    status: "running" | "success" | "error" | "stopped" | "waiting_for_user_input";
     /** Results from the tool call. */
     results?: string;
 }

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

@@ -84,6 +84,61 @@ export interface ImportResult<T = any> {
  * ```
  */
 export type SortField<T> = (keyof T & string) | `+${keyof T & string}` | `-${keyof T & string}`;
+/**
+ * Value accepted when filtering an entity field.
+ *
+ * Supports exact matches, `null`, array shorthand for matching any of the
+ * provided values, and documented MongoDB-style query operators.
+ *
+ * @typeParam T - Field value type.
+ */
+export type EntityFilterValue<T> = EntityFilterComparable<T> | EntityFilterComparable<T>[] | EntityFilterOperators<T>;
+/**
+ * MongoDB-style query operators accepted for a single entity field.
+ *
+ * @typeParam T - Field value type.
+ */
+export type EntityFilterOperators<T> = EntityFilterCommonOperators<T> & {
+    /** Negates another field-level filter expression. */
+    $not?: EntityFilterCommonOperators<T>;
+};
+type EntityFilterComparable<T> = Exclude<T, undefined> | null;
+type EntityFilterCommonOperators<T> = {
+    $eq?: EntityFilterComparable<T>;
+    $ne?: EntityFilterComparable<T>;
+    $gt?: EntityFilterComparable<T>;
+    $gte?: EntityFilterComparable<T>;
+    $lt?: EntityFilterComparable<T>;
+    $lte?: EntityFilterComparable<T>;
+    $in?: EntityFilterComparable<T>[];
+    $nin?: EntityFilterComparable<T>[];
+    $exists?: boolean;
+} & EntityFilterStringOperators<T> & EntityFilterArrayOperators<T>;
+type EntityFilterStringOperators<T> = Extract<Exclude<T, undefined | null>, string> extends never ? {} : {
+    $regex?: string;
+};
+type EntityFilterArrayElement<T> = T extends readonly (infer U)[] ? U : never;
+type EntityFilterArrayOperators<T> = [
+    EntityFilterArrayElement<Exclude<T, undefined | null>>
+] extends [never] ? {} : {
+    $all?: EntityFilterArrayElement<Exclude<T, undefined | null>>[];
+    $size?: number;
+};
+/**
+ * Query object accepted by entity filtering methods.
+ *
+ * Field keys are typed from the entity schema. `$and`, `$or`, and `$nor`
+ * combine nested filter queries at the root level.
+ *
+ * @typeParam T - Entity record type.
+ */
+export type EntityFilterQuery<T> = {
+    [K in keyof T]?: EntityFilterValue<T[K]>;
+} & {
+    $and?: EntityFilterQuery<T>[];
+    $or?: EntityFilterQuery<T>[];
+    $nor?: EntityFilterQuery<T>[];
+};
 /**
  * Fields added by the server to every entity record, such as `id`, `created_date`, `updated_date`, and `created_by`.
  */
@@ -189,7 +244,9 @@ export interface EntityHandler<T = any> {
      * @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.
+     * specified criteria are returned. Field names are case-sensitive. Use field-value pairs
+     * for exact matches, `null` for null values, arrays as shorthand for matching any of the
+     * provided values, or documented MongoDB query operators for advanced filtering.
      * @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`.
@@ -215,6 +272,42 @@ export interface EntityHandler<T = any> {
      *
      * @example
      * ```typescript
+     * // Filter by any matching value
+     * const records = await base44.entities.MyEntity.filter({
+     *   external_id: ['item-1', 'item-2']
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Filter with query operators
+     * const popularRecords = await base44.entities.MyEntity.filter({
+     *   count: { $gte: 100 },
+     *   external_id: { $in: ['item-1', 'item-2'] }
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Filter with logical operators
+     * const records = await base44.entities.MyEntity.filter({
+     *   $or: [
+     *     { name: 'Example item' },
+     *     { slug: 'example-item' }
+     *   ]
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Filter null values
+     * const recordsWithoutDescription = await base44.entities.MyEntity.filter({
+     *   description: null
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
      * // Filter with sorting and pagination
      * const results = await base44.entities.MyEntity.filter(
      *   { status: 'active' },
@@ -236,7 +329,7 @@ export interface EntityHandler<T = any> {
      * );
      * ```
      */
-    filter<K extends keyof T = keyof T>(query: Partial<T>, sort?: SortField<T>, limit?: number, skip?: number, fields?: K[]): Promise<Pick<T, K>[]>;
+    filter<K extends keyof T = keyof T>(query: EntityFilterQuery<T>, sort?: SortField<T>, limit?: number, skip?: number, fields?: K[]): Promise<Pick<T, K>[]>;
     /**
      * Gets a single record by ID.
      *

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

@@ -43,9 +43,9 @@ export interface InvokeLLMParams {
     prompt: string;
     /** Optionally specify a model to override the app-level model setting for this specific call.
      *
-     * Options: `"gpt_5_mini"`, `"gemini_3_flash"`, `"gpt_5"`, `"gpt_5_4"`, `"gemini_3_1_pro"`, `"claude_sonnet_4_6"`, `"claude_opus_4_6"`
+     * Options: `"gpt_5_mini"`, `"gemini_3_flash"`, `"gpt_5"`, `"gpt_5_4"`, `"gpt_5_5"`, `"gemini_3_1_pro"`, `"claude_sonnet_4_6"`, `"claude_opus_4_6"`, `"claude_opus_4_7"`
      */
-    model?: 'gpt_5_mini' | 'gemini_3_flash' | 'gpt_5' | 'gpt_5_4' | 'gemini_3_1_pro' | 'claude_sonnet_4_6' | 'claude_opus_4_6';
+    model?: 'gpt_5_mini' | 'gemini_3_flash' | 'gpt_5' | 'gpt_5_4' | 'gpt_5_5' | 'gemini_3_1_pro' | 'claude_sonnet_4_6' | 'claude_opus_4_6' | 'claude_opus_4_7';
     /** If set to `true`, the LLM will use Google Search, Maps, and News to gather real-time context before answering.
      * @default false
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.26-pr.164.f8d1b0e",
+  "version": "0.8.26-pr.169.4ce3986",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,8 @@
   "scripts": {
     "build": "tsc",
     "lint": "eslint src",
-    "test": "vitest run",
+    "test": "npm run test:types && vitest run",
+    "test:types": "tsc --noEmit -p tsconfig.type-tests.json",
     "test:unit": "vitest run tests/unit",
     "test:e2e": "vitest run tests/e2e",
     "test:watch": "vitest",