@base44-preview/sdk 0.8.50-pr.292.d7cb5e4 → 0.8.51-pr.294.a7ae332

package/dist/client.js

@@ -77,6 +77,12 @@ export function createClient(config) {
         ...optionalHeaders,
         "X-App-Id": String(appId),
     };
+    // Base44-State is the platform's signed proof that the caller passed the
+    // workspace IP allowlist; the gateway checks it like any other app route.
+    const stateHeader = optionalHeaders === null || optionalHeaders === void 0 ? void 0 : optionalHeaders["Base44-State"];
+    const aiGatewayHeaders = stateHeader
+        ? { "Base44-State": stateHeader }
+        : {};
     const functionHeaders = functionsVersion
         ? {
             ...headers,
@@ -187,7 +193,12 @@ export function createClient(config) {
             serverUrl,
             token,
         }),
-        aiGateway: createAiGatewayModule({ serverUrl, token, appId }),
+        aiGateway: createAiGatewayModule({
+            serverUrl,
+            token,
+            appId,
+            headers: aiGatewayHeaders,
+        }),
         appLogs: createAppLogsModule(axiosClient, appId),
         app: createAppModule(axiosClient, appId),
         users: createUsersModule(axiosClient, appId),
@@ -234,7 +245,12 @@ export function createClient(config) {
             serverUrl,
             token,
         }),
-        aiGateway: createAiGatewayModule({ serverUrl, token: serviceToken, appId }),
+        aiGateway: createAiGatewayModule({
+            serverUrl,
+            token: serviceToken,
+            appId,
+            headers: aiGatewayHeaders,
+        }),
         appLogs: createAppLogsModule(serviceRoleAxiosClient, appId),
         cleanup: () => {
             if (socket) {

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

@@ -1,2 +1,2 @@
 import { AiGatewayModule, AiGatewayModuleConfig } from "./ai-gateway.types.js";
-export declare function createAiGatewayModule({ serverUrl, token, appId, }: AiGatewayModuleConfig): AiGatewayModule;
+export declare function createAiGatewayModule({ serverUrl, token, appId, headers, }: AiGatewayModuleConfig): AiGatewayModule;

package/dist/modules/ai-gateway.js

@@ -3,7 +3,7 @@ const PROVIDER_PATHS = {
     openai: "openai",
     typesafe: "typesafe",
 };
-export function createAiGatewayModule({ serverUrl, token, appId, }) {
+export function createAiGatewayModule({ serverUrl, token, appId, headers = {}, }) {
     const connection = ({ provider = "openai" } = {}) => {
         var _a;
         if (!Object.prototype.hasOwnProperty.call(PROVIDER_PATHS, provider)) {
@@ -13,6 +13,7 @@ export function createAiGatewayModule({ serverUrl, token, appId, }) {
         return {
             baseURL: `${serverUrl}/api/apps/${appId}/ai/${providerPath}/v1`,
             token: (_a = token !== null && token !== void 0 ? token : getAccessToken()) !== null && _a !== void 0 ? _a : "",
+            headers: { ...headers },
         };
     };
     return {

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

@@ -9,6 +9,16 @@ export interface AiGatewayConnection {
      * unauthenticated.
      */
     token: string;
+    /**
+     * Extra headers to send with every gateway request. Pass them to your client's
+     * header option, such as `defaultHeaders` for the `openai` SDK and TanStack AI,
+     * or `headers` for the Vercel AI SDK.
+     *
+     * On a client from {@linkcode createClientFromRequest | createClientFromRequest()},
+     * this carries the signed `Base44-State` the platform attached to the request,
+     * which a workspace IP allowlist requires. Otherwise it's empty.
+     */
+    headers: Record<string, string>;
 }
 /** Options for selecting an AI Gateway provider. */
 export interface AiGatewayConnectionOptions {
@@ -26,14 +36,16 @@ export interface AiGatewayModuleConfig {
     token?: string;
     /** Application ID */
     appId: string;
+    /** Platform headers to forward on gateway requests */
+    headers?: Record<string, string>;
 }
 /**
  * AI Gateway module for calling Base44's managed AI models from your own code.
  *
- * `connection()` hands you a `baseURL` and `token` that authenticate as your
- * Base44 app. An OpenAI-compatible client is any library, such as the `openai`
+ * `connection()` hands you a `baseURL`, `token`, and `headers` 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 +67,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
@@ -71,18 +92,16 @@ export interface AiGatewayModuleConfig {
  * app until the quota resets. A request is rejected before the model runs if
  * the app is out of credits. If you need to cap usage per user, build that
  * check yourself, for example by tracking calls per user in your own entity.
- *
- * Streaming responses aren't supported yet, so leave `stream` unset on your requests.
  */
 export interface AiGatewayModule {
     /**
      * Gets the connection details for the Base44 AI Gateway.
      *
-     * Returns the `baseURL` and `token` to pass to the selected provider client.
+     * Returns the `baseURL`, `token`, and `headers` to pass to the selected provider client.
      *
      * @param options - Provider selection. Omit it to use the OpenAI-compatible gateway.
      *
-     * @returns The gateway {@linkcode AiGatewayConnection | connection} (`baseURL` and `token`).
+     * @returns The gateway {@linkcode AiGatewayConnection | connection} (`baseURL`, `token`, and `headers`).
      *
      * @example
      * ```typescript
@@ -92,8 +111,8 @@ export interface AiGatewayModule {
      *
      * // Runs inside a backend function
      * const base44 = createClientFromRequest(request);
-     * const { baseURL, token } = base44.aiGateway.connection();
-     * const openai = new OpenAI({ baseURL, apiKey: token });
+     * const { baseURL, token, headers } = base44.aiGateway.connection();
+     * const openai = new OpenAI({ baseURL, apiKey: token, defaultHeaders: headers });
      *
      * const response = await openai.chat.completions.create({
      *   model: "automatic",
@@ -114,9 +133,9 @@ export interface AiGatewayModule {
      * // Runs inside a backend function, reviewing a return request
      * const base44 = createClientFromRequest(request);
      * const returnRequest = await base44.entities.ReturnRequest.get(returnId);
-     * const { baseURL, token } = base44.aiGateway.connection();
-     * // Point any OpenAI-compatible client at `baseURL` with `apiKey: token`.
-     * const models = createOpenAICompatible({ name: "base44", baseURL, apiKey: token });
+     * const { baseURL, token, headers } = base44.aiGateway.connection();
+     * // Point any OpenAI-compatible client at `baseURL` with `apiKey: token` and `headers`.
+     * const models = createOpenAICompatible({ name: "base44", baseURL, apiKey: token, headers });
      *
      * const agent = new ToolLoopAgent({
      *   model: models("automatic"),
@@ -145,6 +164,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, headers } = base44.aiGateway.connection();
+     * const models = createOpenAICompatible({ name: "base44", baseURL, apiKey: token, headers });
+     *
+     * 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/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.292.d7cb5e4",
+  "version": "0.8.51-pr.294.a7ae332",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",