@ai-sdk/luma 3.0.8 → 3.0.11

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @ai-sdk/luma
 
+## 3.0.11
+
+### Patch Changes
+
+- Updated dependencies [31c7be8]
+  - @ai-sdk/provider-utils@5.0.10
+
+## 3.0.10
+
+### Patch Changes
+
+- 4be62c1: fix(provider-utils): validate provider-response URLs in `getFromApi`
+
+  `getFromApi` now has a `validateUrl` flag. It is optional so existing callers keep compiling (omitting it behaves like `false`, i.e. no validation), but all AI SDK provider packages set it explicitly at every call site so each one makes a visible trust decision. When `true`, the URL is routed through `fetchWithValidatedRedirects` — the same guard used by `downloadBlob` — which rejects private/loopback/link-local targets, re-validates every redirect hop, strips proxy/metadata/cookie request headers, and drops all caller headers except the user-agent on cross-origin redirects (custom API-key headers must not follow a redirect off-origin any more than `Authorization` may); blocked URLs throw `DownloadError`. It is enabled at the image/video/audio download and polling call sites where the URL comes from a provider response body; URLs built from developer-configured endpoints pass `validateUrl: false` and are unaffected.
+
+  A new optional `credentialedOrigin` withholds caller headers unless the URL is same-origin with it, so the API key is not sent to a response-supplied host on a different origin.
+
+  A new optional `trustedOrigin` exempts URLs (and redirect hops) that are same-origin with the developer-configured provider endpoint from target validation, so self-hosted and localhost deployments whose response URLs point back at the configured host keep working; all other hops are still validated.
+
+  Also closes range gaps in `validateDownloadUrl` (IPv4 `224.0.0.0/4` multicast and the TEST-NET documentation ranges `192.0.2.0/24`, `198.51.100.0/24`, `203.0.113.0/24`; IPv6 documentation ranges `2001:db8::/32` and `3fff::/20`), and follows only the fetch-spec redirect status codes (301/302/303/307/308) — a `Location` header on any other status is not followed. This guard performs string/literal checks only and does not resolve DNS; hostnames that resolve to private addresses and DNS rebinding remain out of scope and must be constrained at the network layer (or by injecting a Node `fetch` that pins the resolved IP at connect time) for server deployments handling untrusted URLs. See `contributing/secure-url-handling.md`.
+
+- Updated dependencies [4be62c1]
+- Updated dependencies [7805e4a]
+- Updated dependencies [cd12954]
+  - @ai-sdk/provider-utils@5.0.9
+
+## 3.0.9
+
+### Patch Changes
+
+- Updated dependencies [e193290]
+  - @ai-sdk/provider-utils@5.0.8
+
 ## 3.0.8
 
 ### Patch Changes

package/dist/index.js

@@ -198,6 +198,7 @@ var LumaImageModel = class _LumaImageModel {
     for (let i = 0; i < maxPollAttempts; i++) {
       const { value: statusResponse } = await getFromApi({
         url,
+        validateUrl: false,
         headers,
         abortSignal,
         fetch: this.config.fetch,
@@ -330,6 +331,9 @@ var LumaImageModel = class _LumaImageModel {
   async downloadImage(url, abortSignal) {
     const { value: response } = await getFromApi({
       url,
+      // url is a generated-image URL from the provider response; validate it.
+      validateUrl: true,
+      trustedOrigin: this.config.baseURL,
       // No specific headers should be needed for this request as it's a
       // generated image provided by Luma.
       abortSignal,
@@ -368,7 +372,7 @@ var lumaErrorSchema = z2.object({
 });
 
 // src/version.ts
-var VERSION = true ? "3.0.8" : "0.0.0-test";
+var VERSION = true ? "3.0.11" : "0.0.0-test";
 
 // src/luma-provider.ts
 var defaultBaseURL = "https://api.lumalabs.ai";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/luma-provider.ts","../src/luma-image-model.ts","../src/luma-image-model-options.ts","../src/version.ts"],"sourcesContent":["import {\n  NoSuchModelError,\n  type ImageModelV4,\n  type ProviderV4,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  withoutTrailingSlash,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { LumaImageModel } from './luma-image-model';\nimport type { LumaImageModelId } from './luma-image-settings';\nimport { VERSION } from './version';\n\nexport interface LumaProviderSettings {\n  /**\n   * Luma API key. Default value is taken from the `LUMA_API_KEY` environment\n   * variable.\n   */\n  apiKey?: string;\n  /**\n   * Base URL for the API calls.\n   */\n  baseURL?: string;\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept requests,\n   * or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\nexport interface LumaProvider extends ProviderV4 {\n  /**\n   * Creates a model for image generation.\n   */\n  image(modelId: LumaImageModelId): ImageModelV4;\n\n  /**\n   * Creates a model for image generation.\n   */\n  imageModel(modelId: LumaImageModelId): ImageModelV4;\n\n  /**\n   * @deprecated Use `embeddingModel` instead.\n   */\n  textEmbeddingModel(modelId: string): never;\n}\n\nconst defaultBaseURL = 'https://api.lumalabs.ai';\n\nexport function createLuma(options: LumaProviderSettings = {}): LumaProvider {\n  const baseURL = withoutTrailingSlash(options.baseURL ?? defaultBaseURL);\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        Authorization: `Bearer ${loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'LUMA_API_KEY',\n          description: 'Luma',\n        })}`,\n        ...options.headers,\n      },\n      `ai-sdk/luma/${VERSION}`,\n    );\n\n  const createImageModel = (modelId: LumaImageModelId) =>\n    new LumaImageModel(modelId, {\n      provider: 'luma.image',\n      baseURL: baseURL ?? defaultBaseURL,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'embeddingModel',\n    });\n  };\n\n  return {\n    specificationVersion: 'v4' as const,\n    image: createImageModel,\n    imageModel: createImageModel,\n    languageModel: (modelId: string) => {\n      throw new NoSuchModelError({\n        modelId,\n        modelType: 'languageModel',\n      });\n    },\n    embeddingModel,\n    textEmbeddingModel: embeddingModel,\n  };\n}\n\nexport const luma = createLuma();\n","import {\n  InvalidResponseDataError,\n  type ImageModelV4,\n  type ImageModelV4File,\n  type SharedV4Warning,\n} from '@ai-sdk/provider';\nimport {\n  combineHeaders,\n  createBinaryResponseHandler,\n  createJsonResponseHandler,\n  createJsonErrorResponseHandler,\n  createStatusCodeErrorResponseHandler,\n  delay,\n  getFromApi,\n  postJsonToApi,\n  lazySchema,\n  parseProviderOptions,\n  zodSchema,\n  serializeModelOptions,\n  WORKFLOW_SERIALIZE,\n  WORKFLOW_DESERIALIZE,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { lumaImageModelOptionsSchema } from './luma-image-model-options';\nimport type { LumaReferenceType } from './luma-image-settings';\nimport { z } from 'zod/v4';\n\nconst DEFAULT_POLL_INTERVAL_MILLIS = 500;\nconst DEFAULT_MAX_POLL_ATTEMPTS = 60000 / DEFAULT_POLL_INTERVAL_MILLIS;\n\ninterface LumaImageModelConfig {\n  provider: string;\n  baseURL: string;\n  headers?: () => Record<string, string>;\n  fetch?: FetchFunction;\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class LumaImageModel implements ImageModelV4 {\n  readonly specificationVersion = 'v4';\n  readonly maxImagesPerCall = 1;\n  readonly pollIntervalMillis = DEFAULT_POLL_INTERVAL_MILLIS;\n  readonly maxPollAttempts = DEFAULT_MAX_POLL_ATTEMPTS;\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  static [WORKFLOW_SERIALIZE](model: LumaImageModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: string;\n    config: LumaImageModelConfig;\n  }) {\n    return new LumaImageModel(options.modelId, options.config);\n  }\n\n  constructor(\n    readonly modelId: string,\n    private readonly config: LumaImageModelConfig,\n  ) {}\n\n  async doGenerate({\n    prompt,\n    size,\n    aspectRatio,\n    seed,\n    providerOptions,\n    headers,\n    abortSignal,\n    files,\n    mask,\n  }: Parameters<ImageModelV4['doGenerate']>[0]): Promise<\n    Awaited<ReturnType<ImageModelV4['doGenerate']>>\n  > {\n    const warnings: Array<SharedV4Warning> = [];\n\n    if (seed != null) {\n      warnings.push({\n        type: 'unsupported',\n        feature: 'seed',\n        details: 'This model does not support the `seed` option.',\n      });\n    }\n\n    if (size != null) {\n      warnings.push({\n        type: 'unsupported',\n        feature: 'size',\n        details:\n          'This model does not support the `size` option. Use `aspectRatio` instead.',\n      });\n    }\n\n    // Parse and validate provider options\n    const lumaOptions = await parseProviderOptions({\n      provider: 'luma',\n      providerOptions,\n      schema: lumaImageModelOptionsSchema,\n    });\n\n    // Extract non-request options\n    const {\n      pollIntervalMillis,\n      maxPollAttempts,\n      referenceType,\n      images: imageConfigs,\n      ...providerRequestOptions\n    } = lumaOptions ?? {};\n\n    // Handle image editing via files with reference type support\n    const editingOptions = this.getEditingOptions(\n      files,\n      mask,\n      referenceType ?? undefined,\n      imageConfigs ?? [],\n    );\n\n    const currentDate = this.config._internal?.currentDate?.() ?? new Date();\n    const fullHeaders = combineHeaders(this.config.headers?.(), headers);\n    const { value: generationResponse, responseHeaders } = await postJsonToApi({\n      url: this.getLumaGenerationsUrl(),\n      headers: fullHeaders,\n      body: {\n        prompt,\n        ...(aspectRatio ? { aspect_ratio: aspectRatio } : {}),\n        model: this.modelId,\n        ...editingOptions,\n        ...providerRequestOptions,\n      },\n      abortSignal,\n      fetch: this.config.fetch,\n      failedResponseHandler: this.createLumaErrorHandler(),\n      successfulResponseHandler: createJsonResponseHandler(\n        lumaGenerationResponseSchema,\n      ),\n    });\n\n    const imageUrl = await this.pollForImageUrl(\n      generationResponse.id,\n      fullHeaders,\n      abortSignal,\n      {\n        pollIntervalMillis: pollIntervalMillis ?? undefined,\n        maxPollAttempts: maxPollAttempts ?? undefined,\n      },\n    );\n\n    const downloadedImage = await this.downloadImage(imageUrl, abortSignal);\n\n    return {\n      images: [downloadedImage],\n      warnings,\n      response: {\n        modelId: this.modelId,\n        timestamp: currentDate,\n        headers: responseHeaders,\n      },\n    };\n  }\n\n  private async pollForImageUrl(\n    generationId: string,\n    headers: Record<string, string | undefined>,\n    abortSignal: AbortSignal | undefined,\n    pollSettings?: { pollIntervalMillis?: number; maxPollAttempts?: number },\n  ): Promise<string> {\n    const url = this.getLumaGenerationsUrl(generationId);\n    const maxPollAttempts =\n      pollSettings?.maxPollAttempts ?? this.maxPollAttempts;\n    const pollIntervalMillis =\n      pollSettings?.pollIntervalMillis ?? this.pollIntervalMillis;\n\n    for (let i = 0; i < maxPollAttempts; i++) {\n      const { value: statusResponse } = await getFromApi({\n        url,\n        headers,\n        abortSignal,\n        fetch: this.config.fetch,\n        failedResponseHandler: this.createLumaErrorHandler(),\n        successfulResponseHandler: createJsonResponseHandler(\n          lumaGenerationResponseSchema,\n        ),\n      });\n\n      switch (statusResponse.state) {\n        case 'completed':\n          if (!statusResponse.assets?.image) {\n            throw new InvalidResponseDataError({\n              data: statusResponse,\n              message: `Image generation completed but no image was found.`,\n            });\n          }\n          return statusResponse.assets.image;\n        case 'failed':\n          throw new InvalidResponseDataError({\n            data: statusResponse,\n            message: `Image generation failed.`,\n          });\n      }\n      await delay(pollIntervalMillis);\n    }\n\n    throw new Error(\n      `Image generation timed out after ${this.maxPollAttempts} attempts.`,\n    );\n  }\n\n  private createLumaErrorHandler() {\n    return createJsonErrorResponseHandler({\n      errorSchema: lumaErrorSchema,\n      errorToMessage: (error: LumaErrorData) =>\n        error.detail[0].msg ?? 'Unknown error',\n    });\n  }\n\n  private getEditingOptions(\n    files: ImageModelV4File[] | undefined,\n    mask: ImageModelV4File | undefined,\n    referenceType: LumaReferenceType = 'image',\n    imageConfigs: Array<{ weight?: number | null; id?: string | null }> = [],\n  ): Record<string, unknown> {\n    const options: Record<string, unknown> = {};\n\n    // Luma does not support mask-based inpainting\n    if (mask != null) {\n      throw new Error(\n        'Luma AI does not support mask-based image editing. ' +\n          'Use the prompt to describe the changes you want to make, along with ' +\n          '`prompt.images` containing the source image URL.',\n      );\n    }\n\n    if (files == null || files.length === 0) {\n      return options;\n    }\n\n    // Validate all files are URL-based\n    for (const file of files) {\n      if (file.type !== 'url') {\n        throw new Error(\n          'Luma AI only supports URL-based images. ' +\n            'Please provide image URLs using `prompt.images` with publicly accessible URLs. ' +\n            'Base64 and Uint8Array data are not supported.',\n        );\n      }\n    }\n\n    // Default weights per reference type\n    const defaultWeights: Record<LumaReferenceType, number> = {\n      image: 0.85,\n      style: 0.8,\n      character: 1.0, // Not used, but defined for completeness\n      modify_image: 1.0,\n    };\n\n    switch (referenceType) {\n      case 'image': {\n        // Supports up to 4 images\n        if (files.length > 4) {\n          throw new Error(\n            'Luma AI image supports up to 4 reference images. ' +\n              `You provided ${files.length} images.`,\n          );\n        }\n        options.image = files.map((file, index) => ({\n          url: (file as { type: 'url'; url: string }).url,\n          weight: imageConfigs[index]?.weight ?? defaultWeights.image,\n        }));\n        break;\n      }\n\n      case 'style': {\n        // Style ref accepts an array but typically uses one style image\n        options.style = files.map((file, index) => ({\n          url: (file as { type: 'url'; url: string }).url,\n          weight: imageConfigs[index]?.weight ?? defaultWeights.style,\n        }));\n        break;\n      }\n\n      case 'character': {\n        // Group images by identity id\n        const identities: Record<string, string[]> = {};\n        for (let i = 0; i < files.length; i++) {\n          const file = files[i] as { type: 'url'; url: string };\n          const identityId = imageConfigs[i]?.id ?? 'identity0';\n          if (!identities[identityId]) {\n            identities[identityId] = [];\n          }\n          identities[identityId].push(file.url);\n        }\n\n        // Validate each identity has at most 4 images\n        for (const [identityId, images] of Object.entries(identities)) {\n          if (images.length > 4) {\n            throw new Error(\n              `Luma AI character supports up to 4 images per identity. ` +\n                `Identity '${identityId}' has ${images.length} images.`,\n            );\n          }\n        }\n\n        options.character = Object.fromEntries(\n          Object.entries(identities).map(([id, images]) => [id, { images }]),\n        );\n        break;\n      }\n\n      case 'modify_image': {\n        // Only supports a single image\n        if (files.length > 1) {\n          throw new Error(\n            'Luma AI modify_image only supports a single input image. ' +\n              `You provided ${files.length} images.`,\n          );\n        }\n        options.modify_image = {\n          url: (files[0] as { type: 'url'; url: string }).url,\n          weight: imageConfigs[0]?.weight ?? defaultWeights.modify_image,\n        };\n        break;\n      }\n    }\n\n    return options;\n  }\n\n  private getLumaGenerationsUrl(generationId?: string) {\n    return `${this.config.baseURL}/dream-machine/v1/generations/${\n      generationId ?? 'image'\n    }`;\n  }\n\n  private async downloadImage(\n    url: string,\n    abortSignal: AbortSignal | undefined,\n  ): Promise<Uint8Array> {\n    const { value: response } = await getFromApi({\n      url,\n      // No specific headers should be needed for this request as it's a\n      // generated image provided by Luma.\n      abortSignal,\n      failedResponseHandler: createStatusCodeErrorResponseHandler(),\n      successfulResponseHandler: createBinaryResponseHandler(),\n      fetch: this.config.fetch,\n    });\n    return response;\n  }\n}\n\n// limited version of the schema, focussed on what is needed for the implementation\n// this approach limits breakages when the API changes and increases efficiency\nconst lumaGenerationResponseSchema = lazySchema(() =>\n  zodSchema(\n    z.object({\n      id: z.string(),\n      state: z.enum(['queued', 'dreaming', 'completed', 'failed']),\n      failure_reason: z.string().nullish(),\n      assets: z\n        .object({\n          image: z.string(), // URL of the generated image\n        })\n        .nullish(),\n    }),\n  ),\n);\n\nconst lumaErrorSchema = z.object({\n  detail: z.array(\n    z.object({\n      type: z.string(),\n      loc: z.array(z.string()),\n      msg: z.string(),\n      input: z.string(),\n      ctx: z\n        .object({\n          expected: z.string(),\n        })\n        .nullish(),\n    }),\n  ),\n});\n\nexport type LumaErrorData = z.infer<typeof lumaErrorSchema>;\n\n/**\n * Provider options schema for Luma image generation.\n *\n * @see https://docs.lumalabs.ai/docs/image-generation\n */\n","import {\n  lazySchema,\n  zodSchema,\n  type InferSchema,\n} from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\n\n/**\n * Provider options schema for Luma image generation.\n *\n * @see https://docs.lumalabs.ai/docs/image-generation\n */\nexport const lumaImageModelOptionsSchema = lazySchema(() =>\n  zodSchema(\n    z.looseObject({\n      /**\n       * The type of image reference to use when providing input images.\n       * - `image`: Guide generation using reference images (up to 4). Default.\n       * - `style`: Apply a specific style from reference image(s).\n       * - `character`: Create consistent characters from reference images (up to 4).\n       * - `modify_image`: Transform a single input image with prompt guidance.\n       */\n      referenceType: z\n        .enum(['image', 'style', 'character', 'modify_image'])\n        .nullish(),\n\n      /**\n       * Per-image configuration array. Each entry corresponds to an image in `prompt.images`.\n       * Allows setting individual weights for each reference image.\n       */\n      images: z\n        .array(\n          z.object({\n            /**\n             * The weight of this image's influence on the generation.\n             * - For `image`: Higher weight = closer to reference (default: 0.85)\n             * - For `style`: Higher weight = stronger style influence (default: 0.8)\n             * - For `modify_image`: Higher weight = closer to input, lower = more creative (default: 1.0)\n             */\n            weight: z.number().min(0).max(1).nullish(),\n\n            /**\n             * The identity name for character references.\n             * Used with `character` to specify which identity group the image belongs to.\n             * Luma supports multiple identities (e.g., 'identity0', 'identity1') for generating\n             * images with multiple consistent characters.\n             * Default: 'identity0'\n             */\n            id: z.string().nullish(),\n          }),\n        )\n        .nullish(),\n\n      /**\n       * Override the polling interval in milliseconds (default 500).\n       */\n      pollIntervalMillis: z.number().nullish(),\n\n      /**\n       * Override the maximum number of polling attempts (default 120).\n       */\n      maxPollAttempts: z.number().nullish(),\n    }),\n  ),\n);\n\nexport type LumaImageModelOptions = InferSchema<\n  typeof lumaImageModelOptionsSchema\n>;\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n"],"mappings":"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","names":["lazySchema","zodSchema","z","_a","_b","lazySchema","zodSchema"]}
+{"version":3,"sources":["../src/luma-provider.ts","../src/luma-image-model.ts","../src/luma-image-model-options.ts","../src/version.ts"],"sourcesContent":["import {\n  NoSuchModelError,\n  type ImageModelV4,\n  type ProviderV4,\n} from '@ai-sdk/provider';\nimport {\n  loadApiKey,\n  withoutTrailingSlash,\n  withUserAgentSuffix,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { LumaImageModel } from './luma-image-model';\nimport type { LumaImageModelId } from './luma-image-settings';\nimport { VERSION } from './version';\n\nexport interface LumaProviderSettings {\n  /**\n   * Luma API key. Default value is taken from the `LUMA_API_KEY` environment\n   * variable.\n   */\n  apiKey?: string;\n  /**\n   * Base URL for the API calls.\n   */\n  baseURL?: string;\n  /**\n   * Custom headers to include in the requests.\n   */\n  headers?: Record<string, string>;\n  /**\n   * Custom fetch implementation. You can use it as a middleware to intercept requests,\n   * or to provide a custom fetch implementation for e.g. testing.\n   */\n  fetch?: FetchFunction;\n}\n\nexport interface LumaProvider extends ProviderV4 {\n  /**\n   * Creates a model for image generation.\n   */\n  image(modelId: LumaImageModelId): ImageModelV4;\n\n  /**\n   * Creates a model for image generation.\n   */\n  imageModel(modelId: LumaImageModelId): ImageModelV4;\n\n  /**\n   * @deprecated Use `embeddingModel` instead.\n   */\n  textEmbeddingModel(modelId: string): never;\n}\n\nconst defaultBaseURL = 'https://api.lumalabs.ai';\n\nexport function createLuma(options: LumaProviderSettings = {}): LumaProvider {\n  const baseURL = withoutTrailingSlash(options.baseURL ?? defaultBaseURL);\n  const getHeaders = () =>\n    withUserAgentSuffix(\n      {\n        Authorization: `Bearer ${loadApiKey({\n          apiKey: options.apiKey,\n          environmentVariableName: 'LUMA_API_KEY',\n          description: 'Luma',\n        })}`,\n        ...options.headers,\n      },\n      `ai-sdk/luma/${VERSION}`,\n    );\n\n  const createImageModel = (modelId: LumaImageModelId) =>\n    new LumaImageModel(modelId, {\n      provider: 'luma.image',\n      baseURL: baseURL ?? defaultBaseURL,\n      headers: getHeaders,\n      fetch: options.fetch,\n    });\n\n  const embeddingModel = (modelId: string) => {\n    throw new NoSuchModelError({\n      modelId,\n      modelType: 'embeddingModel',\n    });\n  };\n\n  return {\n    specificationVersion: 'v4' as const,\n    image: createImageModel,\n    imageModel: createImageModel,\n    languageModel: (modelId: string) => {\n      throw new NoSuchModelError({\n        modelId,\n        modelType: 'languageModel',\n      });\n    },\n    embeddingModel,\n    textEmbeddingModel: embeddingModel,\n  };\n}\n\nexport const luma = createLuma();\n","import {\n  InvalidResponseDataError,\n  type ImageModelV4,\n  type ImageModelV4File,\n  type SharedV4Warning,\n} from '@ai-sdk/provider';\nimport {\n  combineHeaders,\n  createBinaryResponseHandler,\n  createJsonResponseHandler,\n  createJsonErrorResponseHandler,\n  createStatusCodeErrorResponseHandler,\n  delay,\n  getFromApi,\n  postJsonToApi,\n  lazySchema,\n  parseProviderOptions,\n  zodSchema,\n  serializeModelOptions,\n  WORKFLOW_SERIALIZE,\n  WORKFLOW_DESERIALIZE,\n  type FetchFunction,\n} from '@ai-sdk/provider-utils';\nimport { lumaImageModelOptionsSchema } from './luma-image-model-options';\nimport type { LumaReferenceType } from './luma-image-settings';\nimport { z } from 'zod/v4';\n\nconst DEFAULT_POLL_INTERVAL_MILLIS = 500;\nconst DEFAULT_MAX_POLL_ATTEMPTS = 60000 / DEFAULT_POLL_INTERVAL_MILLIS;\n\ninterface LumaImageModelConfig {\n  provider: string;\n  baseURL: string;\n  headers?: () => Record<string, string>;\n  fetch?: FetchFunction;\n  _internal?: {\n    currentDate?: () => Date;\n  };\n}\n\nexport class LumaImageModel implements ImageModelV4 {\n  readonly specificationVersion = 'v4';\n  readonly maxImagesPerCall = 1;\n  readonly pollIntervalMillis = DEFAULT_POLL_INTERVAL_MILLIS;\n  readonly maxPollAttempts = DEFAULT_MAX_POLL_ATTEMPTS;\n\n  get provider(): string {\n    return this.config.provider;\n  }\n\n  static [WORKFLOW_SERIALIZE](model: LumaImageModel) {\n    return serializeModelOptions({\n      modelId: model.modelId,\n      config: model.config,\n    });\n  }\n\n  static [WORKFLOW_DESERIALIZE](options: {\n    modelId: string;\n    config: LumaImageModelConfig;\n  }) {\n    return new LumaImageModel(options.modelId, options.config);\n  }\n\n  constructor(\n    readonly modelId: string,\n    private readonly config: LumaImageModelConfig,\n  ) {}\n\n  async doGenerate({\n    prompt,\n    size,\n    aspectRatio,\n    seed,\n    providerOptions,\n    headers,\n    abortSignal,\n    files,\n    mask,\n  }: Parameters<ImageModelV4['doGenerate']>[0]): Promise<\n    Awaited<ReturnType<ImageModelV4['doGenerate']>>\n  > {\n    const warnings: Array<SharedV4Warning> = [];\n\n    if (seed != null) {\n      warnings.push({\n        type: 'unsupported',\n        feature: 'seed',\n        details: 'This model does not support the `seed` option.',\n      });\n    }\n\n    if (size != null) {\n      warnings.push({\n        type: 'unsupported',\n        feature: 'size',\n        details:\n          'This model does not support the `size` option. Use `aspectRatio` instead.',\n      });\n    }\n\n    // Parse and validate provider options\n    const lumaOptions = await parseProviderOptions({\n      provider: 'luma',\n      providerOptions,\n      schema: lumaImageModelOptionsSchema,\n    });\n\n    // Extract non-request options\n    const {\n      pollIntervalMillis,\n      maxPollAttempts,\n      referenceType,\n      images: imageConfigs,\n      ...providerRequestOptions\n    } = lumaOptions ?? {};\n\n    // Handle image editing via files with reference type support\n    const editingOptions = this.getEditingOptions(\n      files,\n      mask,\n      referenceType ?? undefined,\n      imageConfigs ?? [],\n    );\n\n    const currentDate = this.config._internal?.currentDate?.() ?? new Date();\n    const fullHeaders = combineHeaders(this.config.headers?.(), headers);\n    const { value: generationResponse, responseHeaders } = await postJsonToApi({\n      url: this.getLumaGenerationsUrl(),\n      headers: fullHeaders,\n      body: {\n        prompt,\n        ...(aspectRatio ? { aspect_ratio: aspectRatio } : {}),\n        model: this.modelId,\n        ...editingOptions,\n        ...providerRequestOptions,\n      },\n      abortSignal,\n      fetch: this.config.fetch,\n      failedResponseHandler: this.createLumaErrorHandler(),\n      successfulResponseHandler: createJsonResponseHandler(\n        lumaGenerationResponseSchema,\n      ),\n    });\n\n    const imageUrl = await this.pollForImageUrl(\n      generationResponse.id,\n      fullHeaders,\n      abortSignal,\n      {\n        pollIntervalMillis: pollIntervalMillis ?? undefined,\n        maxPollAttempts: maxPollAttempts ?? undefined,\n      },\n    );\n\n    const downloadedImage = await this.downloadImage(imageUrl, abortSignal);\n\n    return {\n      images: [downloadedImage],\n      warnings,\n      response: {\n        modelId: this.modelId,\n        timestamp: currentDate,\n        headers: responseHeaders,\n      },\n    };\n  }\n\n  private async pollForImageUrl(\n    generationId: string,\n    headers: Record<string, string | undefined>,\n    abortSignal: AbortSignal | undefined,\n    pollSettings?: { pollIntervalMillis?: number; maxPollAttempts?: number },\n  ): Promise<string> {\n    const url = this.getLumaGenerationsUrl(generationId);\n    const maxPollAttempts =\n      pollSettings?.maxPollAttempts ?? this.maxPollAttempts;\n    const pollIntervalMillis =\n      pollSettings?.pollIntervalMillis ?? this.pollIntervalMillis;\n\n    for (let i = 0; i < maxPollAttempts; i++) {\n      const { value: statusResponse } = await getFromApi({\n        url,\n        validateUrl: false,\n        headers,\n        abortSignal,\n        fetch: this.config.fetch,\n        failedResponseHandler: this.createLumaErrorHandler(),\n        successfulResponseHandler: createJsonResponseHandler(\n          lumaGenerationResponseSchema,\n        ),\n      });\n\n      switch (statusResponse.state) {\n        case 'completed':\n          if (!statusResponse.assets?.image) {\n            throw new InvalidResponseDataError({\n              data: statusResponse,\n              message: `Image generation completed but no image was found.`,\n            });\n          }\n          return statusResponse.assets.image;\n        case 'failed':\n          throw new InvalidResponseDataError({\n            data: statusResponse,\n            message: `Image generation failed.`,\n          });\n      }\n      await delay(pollIntervalMillis);\n    }\n\n    throw new Error(\n      `Image generation timed out after ${this.maxPollAttempts} attempts.`,\n    );\n  }\n\n  private createLumaErrorHandler() {\n    return createJsonErrorResponseHandler({\n      errorSchema: lumaErrorSchema,\n      errorToMessage: (error: LumaErrorData) =>\n        error.detail[0].msg ?? 'Unknown error',\n    });\n  }\n\n  private getEditingOptions(\n    files: ImageModelV4File[] | undefined,\n    mask: ImageModelV4File | undefined,\n    referenceType: LumaReferenceType = 'image',\n    imageConfigs: Array<{ weight?: number | null; id?: string | null }> = [],\n  ): Record<string, unknown> {\n    const options: Record<string, unknown> = {};\n\n    // Luma does not support mask-based inpainting\n    if (mask != null) {\n      throw new Error(\n        'Luma AI does not support mask-based image editing. ' +\n          'Use the prompt to describe the changes you want to make, along with ' +\n          '`prompt.images` containing the source image URL.',\n      );\n    }\n\n    if (files == null || files.length === 0) {\n      return options;\n    }\n\n    // Validate all files are URL-based\n    for (const file of files) {\n      if (file.type !== 'url') {\n        throw new Error(\n          'Luma AI only supports URL-based images. ' +\n            'Please provide image URLs using `prompt.images` with publicly accessible URLs. ' +\n            'Base64 and Uint8Array data are not supported.',\n        );\n      }\n    }\n\n    // Default weights per reference type\n    const defaultWeights: Record<LumaReferenceType, number> = {\n      image: 0.85,\n      style: 0.8,\n      character: 1.0, // Not used, but defined for completeness\n      modify_image: 1.0,\n    };\n\n    switch (referenceType) {\n      case 'image': {\n        // Supports up to 4 images\n        if (files.length > 4) {\n          throw new Error(\n            'Luma AI image supports up to 4 reference images. ' +\n              `You provided ${files.length} images.`,\n          );\n        }\n        options.image = files.map((file, index) => ({\n          url: (file as { type: 'url'; url: string }).url,\n          weight: imageConfigs[index]?.weight ?? defaultWeights.image,\n        }));\n        break;\n      }\n\n      case 'style': {\n        // Style ref accepts an array but typically uses one style image\n        options.style = files.map((file, index) => ({\n          url: (file as { type: 'url'; url: string }).url,\n          weight: imageConfigs[index]?.weight ?? defaultWeights.style,\n        }));\n        break;\n      }\n\n      case 'character': {\n        // Group images by identity id\n        const identities: Record<string, string[]> = {};\n        for (let i = 0; i < files.length; i++) {\n          const file = files[i] as { type: 'url'; url: string };\n          const identityId = imageConfigs[i]?.id ?? 'identity0';\n          if (!identities[identityId]) {\n            identities[identityId] = [];\n          }\n          identities[identityId].push(file.url);\n        }\n\n        // Validate each identity has at most 4 images\n        for (const [identityId, images] of Object.entries(identities)) {\n          if (images.length > 4) {\n            throw new Error(\n              `Luma AI character supports up to 4 images per identity. ` +\n                `Identity '${identityId}' has ${images.length} images.`,\n            );\n          }\n        }\n\n        options.character = Object.fromEntries(\n          Object.entries(identities).map(([id, images]) => [id, { images }]),\n        );\n        break;\n      }\n\n      case 'modify_image': {\n        // Only supports a single image\n        if (files.length > 1) {\n          throw new Error(\n            'Luma AI modify_image only supports a single input image. ' +\n              `You provided ${files.length} images.`,\n          );\n        }\n        options.modify_image = {\n          url: (files[0] as { type: 'url'; url: string }).url,\n          weight: imageConfigs[0]?.weight ?? defaultWeights.modify_image,\n        };\n        break;\n      }\n    }\n\n    return options;\n  }\n\n  private getLumaGenerationsUrl(generationId?: string) {\n    return `${this.config.baseURL}/dream-machine/v1/generations/${\n      generationId ?? 'image'\n    }`;\n  }\n\n  private async downloadImage(\n    url: string,\n    abortSignal: AbortSignal | undefined,\n  ): Promise<Uint8Array> {\n    const { value: response } = await getFromApi({\n      url,\n      // url is a generated-image URL from the provider response; validate it.\n      validateUrl: true,\n      trustedOrigin: this.config.baseURL,\n      // No specific headers should be needed for this request as it's a\n      // generated image provided by Luma.\n      abortSignal,\n      failedResponseHandler: createStatusCodeErrorResponseHandler(),\n      successfulResponseHandler: createBinaryResponseHandler(),\n      fetch: this.config.fetch,\n    });\n    return response;\n  }\n}\n\n// limited version of the schema, focussed on what is needed for the implementation\n// this approach limits breakages when the API changes and increases efficiency\nconst lumaGenerationResponseSchema = lazySchema(() =>\n  zodSchema(\n    z.object({\n      id: z.string(),\n      state: z.enum(['queued', 'dreaming', 'completed', 'failed']),\n      failure_reason: z.string().nullish(),\n      assets: z\n        .object({\n          image: z.string(), // URL of the generated image\n        })\n        .nullish(),\n    }),\n  ),\n);\n\nconst lumaErrorSchema = z.object({\n  detail: z.array(\n    z.object({\n      type: z.string(),\n      loc: z.array(z.string()),\n      msg: z.string(),\n      input: z.string(),\n      ctx: z\n        .object({\n          expected: z.string(),\n        })\n        .nullish(),\n    }),\n  ),\n});\n\nexport type LumaErrorData = z.infer<typeof lumaErrorSchema>;\n\n/**\n * Provider options schema for Luma image generation.\n *\n * @see https://docs.lumalabs.ai/docs/image-generation\n */\n","import {\n  lazySchema,\n  zodSchema,\n  type InferSchema,\n} from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\n\n/**\n * Provider options schema for Luma image generation.\n *\n * @see https://docs.lumalabs.ai/docs/image-generation\n */\nexport const lumaImageModelOptionsSchema = lazySchema(() =>\n  zodSchema(\n    z.looseObject({\n      /**\n       * The type of image reference to use when providing input images.\n       * - `image`: Guide generation using reference images (up to 4). Default.\n       * - `style`: Apply a specific style from reference image(s).\n       * - `character`: Create consistent characters from reference images (up to 4).\n       * - `modify_image`: Transform a single input image with prompt guidance.\n       */\n      referenceType: z\n        .enum(['image', 'style', 'character', 'modify_image'])\n        .nullish(),\n\n      /**\n       * Per-image configuration array. Each entry corresponds to an image in `prompt.images`.\n       * Allows setting individual weights for each reference image.\n       */\n      images: z\n        .array(\n          z.object({\n            /**\n             * The weight of this image's influence on the generation.\n             * - For `image`: Higher weight = closer to reference (default: 0.85)\n             * - For `style`: Higher weight = stronger style influence (default: 0.8)\n             * - For `modify_image`: Higher weight = closer to input, lower = more creative (default: 1.0)\n             */\n            weight: z.number().min(0).max(1).nullish(),\n\n            /**\n             * The identity name for character references.\n             * Used with `character` to specify which identity group the image belongs to.\n             * Luma supports multiple identities (e.g., 'identity0', 'identity1') for generating\n             * images with multiple consistent characters.\n             * Default: 'identity0'\n             */\n            id: z.string().nullish(),\n          }),\n        )\n        .nullish(),\n\n      /**\n       * Override the polling interval in milliseconds (default 500).\n       */\n      pollIntervalMillis: z.number().nullish(),\n\n      /**\n       * Override the maximum number of polling attempts (default 120).\n       */\n      maxPollAttempts: z.number().nullish(),\n    }),\n  ),\n);\n\nexport type LumaImageModelOptions = InferSchema<\n  typeof lumaImageModelOptionsSchema\n>;\n","// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n"],"mappings":"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","names":["lazySchema","zodSchema","z","_a","_b","lazySchema","zodSchema"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/luma",
-  "version": "3.0.8",
+  "version": "3.0.11",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -30,15 +30,15 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "4.0.3",
-    "@ai-sdk/provider-utils": "5.0.7"
+    "@ai-sdk/provider-utils": "5.0.10"
   },
   "devDependencies": {
     "@types/node": "22.19.19",
     "tsup": "^8.5.1",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@ai-sdk/test-server": "2.0.0",
-    "@vercel/ai-tsconfig": "0.0.0"
+    "@vercel/ai-tsconfig": "0.0.0",
+    "@ai-sdk/test-server": "2.0.0"
   },
   "peerDependencies": {
     "zod": "^3.25.76 || ^4.1.8"

package/src/luma-image-model.ts

@@ -181,6 +181,7 @@ export class LumaImageModel implements ImageModelV4 {
     for (let i = 0; i < maxPollAttempts; i++) {
       const { value: statusResponse } = await getFromApi({
         url,
+        validateUrl: false,
         headers,
         abortSignal,
         fetch: this.config.fetch,
@@ -345,6 +346,9 @@ export class LumaImageModel implements ImageModelV4 {
   ): Promise<Uint8Array> {
     const { value: response } = await getFromApi({
       url,
+      // url is a generated-image URL from the provider response; validate it.
+      validateUrl: true,
+      trustedOrigin: this.config.baseURL,
       // No specific headers should be needed for this request as it's a
       // generated image provided by Luma.
       abortSignal,