@base44-preview/sdk 0.8.50-pr.290.e7ccb0e → 0.8.50-pr.291.10ee07f

package/dist/modules/ai-gateway.types.d.ts

@@ -33,7 +33,7 @@ export interface AiGatewayModuleConfig {
  * `connection()` hands you a `baseURL` and `token` that authenticate as your
  * Base44 app. An OpenAI-compatible client is any library, such as the `openai`
  * SDK or the Vercel AI SDK, that has the same request and response format
- * as OpenAI's Chat Completions API and lets you point it at a custom `baseURL`
+ * as OpenAI's API and lets you point it at a custom `baseURL`
  * instead of OpenAI's own servers. Pass `connection()`'s values to one of
  * these clients and it works against Base44's gateway exactly as it would
  * against the provider directly, no separate account, API key, or billing
@@ -55,6 +55,15 @@ export interface AiGatewayModuleConfig {
  * Pass `'automatic'` to let Base44 choose one, or pin a specific model such
  * as `'claude_sonnet_4_6'`, `'gpt_5_5'`, or `'gemini_3_1_pro'`.
  *
+ * ## Images
+ *
+ * The gateway also serves OpenAI's image endpoints, `/images/generations`
+ * and `/images/edits`, so you can generate images and edit them using
+ * reference images. Image requests use their own set of models: pass
+ * `'automatic'` to let Base44 choose one, or pin a model such as
+ * `'gemini_3_1_flash_image'` or `'gpt_image_2'`. For request options, the
+ * full model list, and limits, see [Generate images with the AI Gateway](/developers/references/sdk/getting-started/ai-gateway-images).
+ *
  * ## Authentication Modes
  *
  * There's no permission difference between modes. Both just determine which
@@ -145,6 +154,29 @@ export interface AiGatewayModule {
      *
      * await agent.generate({ prompt: `Review this return request: ${JSON.stringify(returnRequest)}` });
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Generate an image
+     * import { createClientFromRequest } from "@base44/sdk";
+     * import { generateImage } from "ai";
+     * import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+     *
+     * // Runs inside a backend function
+     * const base44 = createClientFromRequest(request);
+     * const { baseURL, token } = base44.aiGateway.connection();
+     * const models = createOpenAICompatible({ name: "base44", baseURL, apiKey: token });
+     *
+     * const { image } = await generateImage({
+     *   model: models.imageModel("automatic"),
+     *   prompt: "A watercolor illustration of a lighthouse at dawn",
+     *   // Base44 options go under the provider name you passed above
+     *   providerOptions: { base44: { aspect_ratio: "16:9" } },
+     * });
+     *
+     * const file = new File([image.uint8Array], "lighthouse.png", { type: image.mediaType });
+     * const { file_url } = await base44.integrations.Core.UploadFile({ file });
+     * ```
      */
     connection(options?: AiGatewayConnectionOptions): AiGatewayConnection;
 }

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

@@ -341,9 +341,6 @@ export interface EntityHandler<T = any> {
      * and records deleted between pages never shift the boundary. `skip` is kept
      * for existing code and is deprecated for loops.
      *
-     * **Note:** Returns an empty result if a row-level security rule denies
-     * this call. See {@link EntitiesModule | Denied reads and writes}.
-     *
      * @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 `5000`.
@@ -409,9 +406,6 @@ export interface EntityHandler<T = any> {
      * and records deleted between pages never shift the boundary. `skip` is kept
      * for existing code and is deprecated for loops.
      *
-     * **Note:** Returns an empty result if a row-level security rule denies
-     * this call. See {@link EntitiesModule | Denied reads and writes}.
-     *
      * @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
@@ -532,10 +526,6 @@ export interface EntityHandler<T = any> {
      *
      * Retrieves a specific record using its unique identifier.
      *
-     * **Note:** Throws a not-found error, whether or not the record exists,
-     * if a row-level security rule denies this call. See
-     * {@link EntitiesModule | Denied reads and writes}.
-     *
      * @param id - The unique identifier of the record.
      * @returns Promise resolving to the record.
      *
@@ -552,9 +542,6 @@ export interface EntityHandler<T = any> {
      *
      * Creates a new record with the provided data.
      *
-     * **Note:** Throws a permission error if a row-level security rule
-     * denies this call. See {@link EntitiesModule | Denied reads and writes}.
-     *
      * @param data - Object containing the record data.
      * @returns Promise resolving to the created record.
      *
@@ -581,9 +568,6 @@ export interface EntityHandler<T = any> {
      * To update multiple specific records with different data each, use
      * {@linkcode bulkUpdate | bulkUpdate()}.
      *
-     * **Note:** Throws a permission error if a row-level security rule
-     * denies this call. See {@link EntitiesModule | Denied reads and writes}.
-     *
      * @param id - The unique identifier of the record to update.
      * @param data - Object containing the fields to update.
      * @returns Promise resolving to the updated record.
@@ -980,17 +964,6 @@ type DynamicEntitiesModule = {
  *
  * Regular users can only read and update their own user record. With service role authentication, you can read, update, and delete any user. You can't create users using the entities module. Instead, use the functions of the {@link AuthModule | auth module} to invite or register new users.
  *
- * ## Denied reads and writes
- *
- * Denied reads behave as if the data doesn't exist, so they don't reveal
- * what's there. Denied writes throw, so a blocked change never fails silently.
- *
- * | Operation | When a rule denies it |
- * | --- | --- |
- * | `list()`, `filter()` | Returns an empty result, the same as if nothing matched. No error is thrown. |
- * | `get()` | Throws a not-found error (HTTP 404), whether or not the record exists. |
- * | `create()`, `update()` | Throws a permission error (HTTP 403). |
- *
  * ## Generated Types
  *
  * If you're working in a TypeScript project, you can generate types from your entity schemas to get autocomplete and type checking on all entity methods. See the [Dynamic Types](/developers/references/sdk/getting-started/dynamic-types) guide to get started.

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

@@ -59,8 +59,17 @@ export interface InvokeLLMParams {
  * Parameters for the GenerateImage function.
  */
 export interface GenerateImageParams {
-    /** Description of the image to generate. */
+    /**
+     * Description of the image to generate. When you pass `existing_image_urls`,
+     * describe what to do with the reference images instead.
+     */
     prompt: string;
+    /**
+     * URLs of images to use as references, for example to edit an existing
+     * image, match a style, or add visual context. Images that can't be read are
+     * skipped. If none of them can be read, the request fails.
+     */
+    existing_image_urls?: string[];
 }
 export interface GenerateImageResult {
     /** URL of the generated image. */
@@ -173,12 +182,17 @@ export interface CoreIntegrations {
      */
     InvokeLLM(params: InvokeLLMParams): Promise<string | object>;
     /**
-     * Create AI-generated images from text prompts.
+     * Create AI-generated images from text prompts, optionally guided by reference images.
      *
      * Images are generated as PNG files at approximately 1024px on the shorter side. The
      * exact dimensions vary by aspect ratio.
      *
-     * Prompts that violate the AI provider's content policy will be refused.
+     * Pass `existing_image_urls` to edit an existing image or to guide the result
+     * with reference images. To choose the model, aspect ratio, resolution, or
+     * quality, use the [AI Gateway image endpoints](/developers/references/sdk/getting-started/ai-gateway-images)
+     * instead.
+     *
+     * Prompts that violate the AI provider's content policy are refused.
      *
      * @param params - Parameters for image generation
      * @returns Promise resolving to an object containing the URL of the generated PNG image.
@@ -191,6 +205,15 @@ export interface CoreIntegrations {
      * });
      * console.log(url); // https://...generated_image.png
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Edit an existing image
+     * const {url} = await base44.integrations.Core.GenerateImage({
+     *   prompt: "Replace the background with a sunset beach",
+     *   existing_image_urls: [productPhotoUrl]
+     * });
+     * ```
      */
     GenerateImage(params: GenerateImageParams): Promise<GenerateImageResult>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.50-pr.290.e7ccb0e",
+  "version": "0.8.50-pr.291.10ee07f",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",