@tanstack/ai-grok 0.14.2 → 0.14.3

package/dist/esm/utils/audio.js

@@ -1,172 +0,0 @@
-function toAudioFile(audio, audioFormat) {
-  if (typeof File !== "undefined" && audio instanceof File) {
-    if (audioFormat) {
-      const mimeType = toMimeType(audioFormat);
-      return new File([audio], `audio.${extensionFor(mimeType)}`, {
-        type: mimeType
-      });
-    }
-    if (audio.type) {
-      return audio;
-    }
-    throw new Error(
-      'toAudioFile cannot infer type for File input with empty .type — pass an explicit audioFormat (e.g. "mp3", "wav", "audio/mpeg")'
-    );
-  }
-  if (typeof Blob !== "undefined" && audio instanceof Blob) {
-    const mimeType = audioFormat ? toMimeType(audioFormat) : audio.type || void 0;
-    if (!mimeType) {
-      throw new Error(
-        'toAudioFile cannot infer type for Blob input with empty .type — pass an explicit audioFormat (e.g. "mp3", "wav", "audio/mpeg")'
-      );
-    }
-    return new File([audio], `audio.${extensionFor(mimeType)}`, {
-      type: mimeType
-    });
-  }
-  if (audio instanceof ArrayBuffer) {
-    if (!audioFormat) {
-      throw new Error(
-        'toAudioFile cannot infer type for ArrayBuffer input — pass an explicit audioFormat (e.g. "mp3", "wav", "audio/mpeg")'
-      );
-    }
-    const mimeType = toMimeType(audioFormat);
-    return new File([audio], `audio.${extensionFor(mimeType)}`, {
-      type: mimeType
-    });
-  }
-  if (typeof audio === "string") {
-    if (audio.startsWith("data:")) {
-      const [header, base64Data] = audio.split(",");
-      const headerMatch = header?.match(/data:([^;]+)/);
-      const uriMimeType = headerMatch?.[1];
-      if (!uriMimeType) {
-        throw new Error(
-          "Malformed data: URI in toAudioFile: cannot parse MIME type — expected data:<mime>[;charset=…][;base64],<payload>"
-        );
-      }
-      if (base64Data === void 0 || base64Data.trim() === "") {
-        throw new Error(
-          "Malformed data: URI in toAudioFile: missing base64 payload after comma"
-        );
-      }
-      const mimeType2 = audioFormat ? toMimeType(audioFormat) : uriMimeType;
-      const buffer2 = base64ToArrayBuffer(base64Data);
-      return new File([buffer2], `audio.${extensionFor(mimeType2)}`, {
-        type: mimeType2
-      });
-    }
-    if (!audioFormat) {
-      throw new Error(
-        "toAudioFile requires a data: URI (e.g. data:audio/wav;base64,...) or an explicit audioFormat argument — bare base64 strings have no MIME type to infer"
-      );
-    }
-    const buffer = base64ToArrayBuffer(audio);
-    const mimeType = toMimeType(audioFormat);
-    return new File([buffer], `audio.${extensionFor(mimeType)}`, {
-      type: mimeType
-    });
-  }
-  throw new Error("Invalid audio input type");
-}
-function toMimeType(audioFormat) {
-  if (audioFormat.includes("/")) return audioFormat;
-  const ext = audioFormat.toLowerCase();
-  switch (ext) {
-    case "mp3":
-      return "audio/mpeg";
-    case "wav":
-      return "audio/wav";
-    case "ogg":
-      return "audio/ogg";
-    case "opus":
-      return "audio/opus";
-    case "flac":
-      return "audio/flac";
-    case "aac":
-      return "audio/aac";
-    case "mp4":
-      return "audio/mp4";
-    case "m4a":
-      return "audio/mp4";
-    case "webm":
-      return "audio/webm";
-    case "pcm":
-      return "audio/L16";
-    case "mulaw":
-      return "audio/basic";
-    case "alaw":
-      return "audio/x-alaw-basic";
-    default:
-      return `audio/${ext}`;
-  }
-}
-function extensionFor(mimeType) {
-  switch (mimeType) {
-    case "audio/mpeg":
-      return "mp3";
-    case "audio/wav":
-    case "audio/x-wav":
-      return "wav";
-    case "audio/ogg":
-      return "ogg";
-    case "audio/opus":
-      return "opus";
-    case "audio/flac":
-      return "flac";
-    case "audio/aac":
-      return "aac";
-    case "audio/mp4":
-      return "m4a";
-    case "audio/webm":
-      return "webm";
-    case "audio/L16":
-      return "pcm";
-    case "audio/basic":
-      return "mulaw";
-    case "audio/x-alaw-basic":
-      return "alaw";
-    default: {
-      const slash = mimeType.indexOf("/");
-      if (slash === -1) return "bin";
-      return mimeType.slice(slash + 1) || "bin";
-    }
-  }
-}
-function arrayBufferToBase64(buffer) {
-  if (typeof Buffer !== "undefined") {
-    return Buffer.from(buffer).toString("base64");
-  }
-  const bytes = new Uint8Array(buffer);
-  const chunkSize = 32768;
-  let binary = "";
-  for (let i = 0; i < bytes.length; i += chunkSize) {
-    const end = Math.min(i + chunkSize, bytes.length);
-    binary += String.fromCharCode.apply(
-      null,
-      // eslint-disable-next-line no-restricted-syntax -- TS lib types String.fromCharCode.apply as Array<number> but runtime accepts any ArrayLike
-      bytes.subarray(i, end)
-    );
-  }
-  return btoa(binary);
-}
-function base64ToArrayBuffer(base64) {
-  let binary;
-  try {
-    binary = atob(base64);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    throw new Error(`Invalid base64 input to toAudioFile: ${msg}`);
-  }
-  const buffer = new ArrayBuffer(binary.length);
-  const bytes = new Uint8Array(buffer);
-  for (let i = 0; i < binary.length; i++) {
-    bytes[i] = binary.charCodeAt(i);
-  }
-  return buffer;
-}
-export {
-  arrayBufferToBase64,
-  toAudioFile
-};
-//# sourceMappingURL=audio.js.map

package/dist/esm/utils/audio.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio.js","sources":["../../../src/utils/audio.ts"],"sourcesContent":["/**\n * Coerce the various audio input shapes accepted by `TranscriptionOptions.audio`\n * into a `File` suitable for `multipart/form-data` uploads.\n *\n * For base64 string inputs we require an explicit MIME type — either via a\n * `data:<mime>;base64,<payload>` URI prefix, or via the caller-provided\n * `audioFormat` parameter. Bare base64 without either is rejected, because\n * silently defaulting to `audio/mpeg` misreports non-mp3 audio to the server.\n *\n * The same rule applies to raw `ArrayBuffer` inputs: the caller must supply\n * an `audioFormat` so we know what MIME type and extension to use.\n */\nexport function toAudioFile(\n  audio: string | File | Blob | ArrayBuffer,\n  audioFormat?: string,\n): File {\n  if (typeof File !== 'undefined' && audio instanceof File) {\n    // Prefer the caller-supplied `audioFormat` over a potentially empty or\n    // incorrect `File.type` — callers pass `audioFormat` precisely because\n    // they have more context than the browser does about the payload. If\n    // neither is set, fall through to the Blob-style error path below.\n    if (audioFormat) {\n      const mimeType = toMimeType(audioFormat)\n      return new File([audio], `audio.${extensionFor(mimeType)}`, {\n        type: mimeType,\n      })\n    }\n    if (audio.type) {\n      return audio\n    }\n    throw new Error(\n      'toAudioFile cannot infer type for File input with empty .type — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n    )\n  }\n\n  if (typeof Blob !== 'undefined' && audio instanceof Blob) {\n    // Mirror the ArrayBuffer / bare-base64 paths: prefer the explicit\n    // audioFormat argument over the Blob's (often empty) .type. We refuse to\n    // fall back to `application/octet-stream` because that mislabels audio\n    // for the server.\n    const mimeType = audioFormat\n      ? toMimeType(audioFormat)\n      : audio.type || undefined\n    if (!mimeType) {\n      throw new Error(\n        'toAudioFile cannot infer type for Blob input with empty .type — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n      )\n    }\n    return new File([audio], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  if (audio instanceof ArrayBuffer) {\n    if (!audioFormat) {\n      throw new Error(\n        'toAudioFile cannot infer type for ArrayBuffer input — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n      )\n    }\n    const mimeType = toMimeType(audioFormat)\n    return new File([audio], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  if (typeof audio === 'string') {\n    if (audio.startsWith('data:')) {\n      const [header, base64Data] = audio.split(',')\n      // Fail loudly on malformed data: URIs instead of silently defaulting\n      // to `audio/mpeg` — the file's contract is that we never mislabel\n      // audio for the server.\n      const headerMatch = header?.match(/data:([^;]+)/)\n      const uriMimeType = headerMatch?.[1]\n      if (!uriMimeType) {\n        throw new Error(\n          'Malformed data: URI in toAudioFile: cannot parse MIME type — expected data:<mime>[;charset=…][;base64],<payload>',\n        )\n      }\n      if (base64Data === undefined || base64Data.trim() === '') {\n        throw new Error(\n          'Malformed data: URI in toAudioFile: missing base64 payload after comma',\n        )\n      }\n      // Caller-supplied `audioFormat` wins over the URI-embedded MIME: the\n      // caller has more context (the URI MIME may be wrong, or a generic\n      // `application/octet-stream`).\n      const mimeType = audioFormat ? toMimeType(audioFormat) : uriMimeType\n      const buffer = base64ToArrayBuffer(base64Data)\n      return new File([buffer], `audio.${extensionFor(mimeType)}`, {\n        type: mimeType,\n      })\n    }\n\n    if (!audioFormat) {\n      throw new Error(\n        'toAudioFile requires a data: URI (e.g. data:audio/wav;base64,...) or an explicit audioFormat argument — bare base64 strings have no MIME type to infer',\n      )\n    }\n\n    const buffer = base64ToArrayBuffer(audio)\n    const mimeType = toMimeType(audioFormat)\n    return new File([buffer], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  throw new Error('Invalid audio input type')\n}\n\nfunction toMimeType(audioFormat: string): string {\n  // Accept either \"audio/…\" strings or bare extensions like \"mp3\".\n  if (audioFormat.includes('/')) return audioFormat\n  const ext = audioFormat.toLowerCase()\n  switch (ext) {\n    case 'mp3':\n      return 'audio/mpeg'\n    case 'wav':\n      return 'audio/wav'\n    case 'ogg':\n      return 'audio/ogg'\n    case 'opus':\n      return 'audio/opus'\n    case 'flac':\n      return 'audio/flac'\n    case 'aac':\n      return 'audio/aac'\n    case 'mp4':\n      return 'audio/mp4'\n    case 'm4a':\n      return 'audio/mp4'\n    case 'webm':\n      return 'audio/webm'\n    case 'pcm':\n      return 'audio/L16'\n    case 'mulaw':\n      return 'audio/basic'\n    case 'alaw':\n      return 'audio/x-alaw-basic'\n    default:\n      return `audio/${ext}`\n  }\n}\n\nfunction extensionFor(mimeType: string): string {\n  switch (mimeType) {\n    case 'audio/mpeg':\n      return 'mp3'\n    case 'audio/wav':\n    case 'audio/x-wav':\n      return 'wav'\n    case 'audio/ogg':\n      return 'ogg'\n    case 'audio/opus':\n      return 'opus'\n    case 'audio/flac':\n      return 'flac'\n    case 'audio/aac':\n      return 'aac'\n    case 'audio/mp4':\n      return 'm4a'\n    case 'audio/webm':\n      return 'webm'\n    case 'audio/L16':\n      return 'pcm'\n    case 'audio/basic':\n      return 'mulaw'\n    case 'audio/x-alaw-basic':\n      return 'alaw'\n    default: {\n      const slash = mimeType.indexOf('/')\n      if (slash === -1) return 'bin'\n      return mimeType.slice(slash + 1) || 'bin'\n    }\n  }\n}\n\n/**\n * Cross-runtime ArrayBuffer → base64 conversion.\n *\n * Uses Node's `Buffer` when available (fastest path on server) and falls\n * back to `btoa` + chunked `String.fromCharCode` everywhere else (browser,\n * Cloudflare Workers, Bun, Deno). Chunking is required because a very\n * large audio buffer spread into `String.fromCharCode(...bytes)` in one\n * call can hit `Maximum call stack size exceeded`.\n */\nexport function arrayBufferToBase64(buffer: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(buffer).toString('base64')\n  }\n  const bytes = new Uint8Array(buffer)\n  const chunkSize = 0x8000\n  let binary = ''\n  for (let i = 0; i < bytes.length; i += chunkSize) {\n    const end = Math.min(i + chunkSize, bytes.length)\n    binary += String.fromCharCode.apply(\n      null,\n      // eslint-disable-next-line no-restricted-syntax -- TS lib types String.fromCharCode.apply as Array<number> but runtime accepts any ArrayLike\n      bytes.subarray(i, end) as unknown as Array<number>,\n    )\n  }\n  return btoa(binary)\n}\n\nfunction base64ToArrayBuffer(base64: string): ArrayBuffer {\n  let binary: string\n  try {\n    binary = atob(base64)\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err)\n    throw new Error(`Invalid base64 input to toAudioFile: ${msg}`)\n  }\n  const buffer = new ArrayBuffer(binary.length)\n  const bytes = new Uint8Array(buffer)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i)\n  }\n  return buffer\n}\n"],"names":["mimeType","buffer"],"mappings":"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"}

package/dist/esm/utils/client.d.ts

@@ -1,14 +0,0 @@
-import { ClientOptions } from 'openai';
-export interface GrokClientConfig extends Omit<ClientOptions, 'apiKey'> {
-    apiKey: string;
-}
-/**
- * Gets Grok API key from environment variables
- * @throws Error if XAI_API_KEY is not found
- */
-export declare function getGrokApiKeyFromEnv(): string;
-/**
- * Returns a Grok client config with the default xAI base URL applied
- * when not already set.
- */
-export declare function withGrokDefaults(config: GrokClientConfig): GrokClientConfig;

package/dist/esm/utils/client.js

@@ -1,21 +0,0 @@
-import { getApiKeyFromEnv } from "@tanstack/ai-utils";
-function getGrokApiKeyFromEnv() {
-  try {
-    return getApiKeyFromEnv("XAI_API_KEY");
-  } catch {
-    throw new Error(
-      "XAI_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key."
-    );
-  }
-}
-function withGrokDefaults(config) {
-  return {
-    ...config,
-    baseURL: config.baseURL || "https://api.x.ai/v1"
-  };
-}
-export {
-  getGrokApiKeyFromEnv,
-  withGrokDefaults
-};
-//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { ClientOptions } from 'openai'\n\nexport interface GrokClientConfig extends Omit<ClientOptions, 'apiKey'> {\n  apiKey: string\n}\n\n/**\n * Gets Grok API key from environment variables\n * @throws Error if XAI_API_KEY is not found\n */\nexport function getGrokApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('XAI_API_KEY')\n  } catch {\n    throw new Error(\n      'XAI_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key.',\n    )\n  }\n}\n\n/**\n * Returns a Grok client config with the default xAI base URL applied\n * when not already set.\n */\nexport function withGrokDefaults(config: GrokClientConfig): GrokClientConfig {\n  return {\n    ...config,\n    baseURL: config.baseURL || 'https://api.x.ai/v1',\n  }\n}\n"],"names":[],"mappings":";AAWO,SAAS,uBAA+B;AAC7C,MAAI;AACF,WAAO,iBAAiB,aAAa;AAAA,EACvC,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;AAMO,SAAS,iBAAiB,QAA4C;AAC3E,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO,WAAW;AAAA,EAAA;AAE/B;"}

package/dist/esm/utils/index.d.ts

@@ -1,4 +0,0 @@
-export { generateId } from '@tanstack/ai-utils';
-export { getGrokApiKeyFromEnv, withGrokDefaults, type GrokClientConfig, } from './client.js';
-export { makeGrokStructuredOutputCompatible, transformNullsToUndefined, } from './schema-converter.js';
-export { toAudioFile, arrayBufferToBase64 } from './audio.js';

package/dist/esm/utils/schema-converter.d.ts

@@ -1,2 +0,0 @@
-export { transformNullsToUndefined } from '@tanstack/ai-utils';
-export { makeStructuredOutputCompatible as makeGrokStructuredOutputCompatible } from '@tanstack/openai-base';

package/dist/esm/video/video-provider-options.d.ts

@@ -1,135 +0,0 @@
-import { DurationOptions } from '@tanstack/ai/adapters';
-import { GrokVideoModel } from '../model-meta.js';
-/**
- * Aspect ratios accepted by the grok-imagine video models.
- *
- * Note: this is a narrower set than the grok-imagine image models — the
- * video endpoint rejects the phone-screen ratios ('9:19.5', '9:20', …) and
- * 'auto'.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export type GrokVideoAspectRatio = '1:1' | '16:9' | '9:16' | '4:3' | '3:4' | '3:2' | '2:3';
-/**
- * Resolution tiers for the grok-imagine video models.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export type GrokVideoResolution = '480p' | '720p' | '1080p';
-/**
- * Size strings for grok-imagine video models. The Imagine API is
- * aspect-ratio based rather than pixel-size based; like the grok-imagine
- * image models, the generic `size` option uses an
- * `aspectRatio_resolution` template ("16:9_720p") — the resolution suffix
- * is optional ("16:9" uses the API default).
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export type GrokVideoSize = GrokVideoAspectRatio | `${GrokVideoAspectRatio}_${GrokVideoResolution}`;
-/**
- * Video duration limits enforced by the Imagine API (seconds).
- */
-export declare const GROK_VIDEO_MIN_DURATION = 1;
-export declare const GROK_VIDEO_MAX_DURATION = 15;
-/**
- * Parses a grok video size string into its components.
- * Format: "aspectRatio" or "aspectRatio_resolution",
- * e.g. "16:9_720p" → { aspectRatio: "16:9", resolution: "720p" }.
- * Returns undefined when the string doesn't match the template.
- */
-export declare function parseGrokVideoSize(size: string): {
-    aspectRatio: string;
-    resolution?: string;
-} | undefined;
-/**
- * Validate the `size` template for a given grok video model.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export declare function validateVideoSize(model: string, size?: string): asserts size is GrokVideoSize | undefined;
-/**
- * Per-model duration type. The Imagine API accepts any integer second in the
- * 1–15 range, so this is a continuous range expressed as `number` (a literal
- * union can't represent it). `snapDuration()` coerces a raw seconds value into
- * the valid range at runtime.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export type GrokVideoModelDurationByName = {
-    'grok-imagine-video': number;
-    'grok-imagine-video-1.5': number;
-};
-/**
- * Runtime duration table backing `availableDurations()` / `snapDuration()`.
- * Both grok-imagine video models accept the same continuous 1–15 integer-second
- * range.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export declare const GROK_VIDEO_DURATIONS: {
-    readonly [TModel in GrokVideoModel]: DurationOptions<GrokVideoModelDurationByName[TModel]>;
-};
-/**
- * Look up the duration options for a grok video model.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export declare function getGrokVideoDurationOptions<TModel extends GrokVideoModel>(model: TModel): DurationOptions<GrokVideoModelDurationByName[TModel]>;
-/**
- * Provider-specific options for grok video generation. These map directly
- * onto the Imagine API request body and take precedence over the generic
- * `size` / `duration` options when both are provided.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export interface GrokVideoProviderOptions {
-    /**
-     * Output aspect ratio.
-     */
-    aspect_ratio?: GrokVideoAspectRatio;
-    /**
-     * Output resolution tier.
-     */
-    resolution?: GrokVideoResolution;
-    /**
-     * Video duration in integer seconds (1–15).
-     */
-    duration?: number;
-}
-/**
- * Type-only map from model name to its specific provider options.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export type GrokVideoModelProviderOptionsByName = {
-    'grok-imagine-video': GrokVideoProviderOptions;
-    'grok-imagine-video-1.5': GrokVideoProviderOptions;
-};
-/**
- * Type-only map from model name to its supported `size` strings.
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export type GrokVideoModelSizeByName = {
-    'grok-imagine-video': GrokVideoSize;
-    'grok-imagine-video-1.5': GrokVideoSize;
-};
-/**
- * Type-only map from model name to the non-text prompt modalities it accepts.
- * Both models accept an `image` prompt part as the starting frame:
- * `grok-imagine-video` (v1.0) does text-to-video and image-to-video, while
- * `grok-imagine-video-1.5` is image-to-video only (the image is required).
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export type GrokVideoModelInputModalitiesByName = {
-    'grok-imagine-video': readonly ['image'];
-    'grok-imagine-video-1.5': readonly ['image'];
-};
-/**
- * True when the model only supports image-to-video (a starting frame is
- * required).
- *
- * @experimental Video generation is an experimental feature and may change.
- */
-export declare function isImageToVideoOnlyModel(model: string): boolean;

package/dist/esm/video/video-provider-options.js

@@ -1,67 +0,0 @@
-const GROK_VIDEO_ASPECT_RATIOS = [
-  "1:1",
-  "16:9",
-  "9:16",
-  "4:3",
-  "3:4",
-  "3:2",
-  "2:3"
-];
-const GROK_VIDEO_RESOLUTIONS = ["480p", "720p", "1080p"];
-const GROK_VIDEO_MIN_DURATION = 1;
-const GROK_VIDEO_MAX_DURATION = 15;
-function parseGrokVideoSize(size) {
-  const match = size.match(/^([\d.]+:[\d.]+)(?:_(.+))?$/);
-  const [, aspectRatio, resolution] = match ?? [];
-  if (aspectRatio === void 0) return void 0;
-  return { aspectRatio, ...resolution !== void 0 && { resolution } };
-}
-function validateVideoSize(model, size) {
-  if (size === void 0) return;
-  const parsed = parseGrokVideoSize(size);
-  if (!parsed || !GROK_VIDEO_ASPECT_RATIOS.includes(parsed.aspectRatio)) {
-    throw new Error(
-      `Size "${size}" is not supported by model "${model}". Expected "aspectRatio" or "aspectRatio_resolution" (e.g. "16:9_720p") with aspect ratio one of: ${GROK_VIDEO_ASPECT_RATIOS.join(", ")}`
-    );
-  }
-  if (parsed.resolution !== void 0 && !GROK_VIDEO_RESOLUTIONS.includes(parsed.resolution)) {
-    throw new Error(
-      `Resolution "${parsed.resolution}" is not supported by model "${model}". Supported resolutions: ${GROK_VIDEO_RESOLUTIONS.join(", ")}`
-    );
-  }
-}
-const GROK_VIDEO_DURATIONS = {
-  "grok-imagine-video": {
-    kind: "range",
-    min: GROK_VIDEO_MIN_DURATION,
-    max: GROK_VIDEO_MAX_DURATION,
-    step: 1,
-    unit: "seconds"
-  },
-  "grok-imagine-video-1.5": {
-    kind: "range",
-    min: GROK_VIDEO_MIN_DURATION,
-    max: GROK_VIDEO_MAX_DURATION,
-    step: 1,
-    unit: "seconds"
-  }
-};
-function getGrokVideoDurationOptions(model) {
-  return GROK_VIDEO_DURATIONS[model];
-}
-const GROK_VIDEO_IMAGE_TO_VIDEO_ONLY = /* @__PURE__ */ new Set([
-  "grok-imagine-video-1.5"
-]);
-function isImageToVideoOnlyModel(model) {
-  return GROK_VIDEO_IMAGE_TO_VIDEO_ONLY.has(model);
-}
-export {
-  GROK_VIDEO_DURATIONS,
-  GROK_VIDEO_MAX_DURATION,
-  GROK_VIDEO_MIN_DURATION,
-  getGrokVideoDurationOptions,
-  isImageToVideoOnlyModel,
-  parseGrokVideoSize,
-  validateVideoSize
-};
-//# sourceMappingURL=video-provider-options.js.map

package/dist/esm/video/video-provider-options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"video-provider-options.js","sources":["../../../src/video/video-provider-options.ts"],"sourcesContent":["/**\n * Grok Video Generation Provider Options (xAI Imagine API)\n *\n * Based on https://docs.x.ai/docs/guides/video-generations\n *\n * @experimental Video generation is an experimental feature and may change.\n */\n\nimport type { DurationOptions } from '@tanstack/ai/adapters'\nimport type { GrokVideoModel } from '../model-meta'\n\n/**\n * Aspect ratios accepted by the grok-imagine video models.\n *\n * Note: this is a narrower set than the grok-imagine image models — the\n * video endpoint rejects the phone-screen ratios ('9:19.5', '9:20', …) and\n * 'auto'.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GrokVideoAspectRatio =\n  | '1:1'\n  | '16:9'\n  | '9:16'\n  | '4:3'\n  | '3:4'\n  | '3:2'\n  | '2:3'\n\n/**\n * Resolution tiers for the grok-imagine video models.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GrokVideoResolution = '480p' | '720p' | '1080p'\n\n/**\n * Size strings for grok-imagine video models. The Imagine API is\n * aspect-ratio based rather than pixel-size based; like the grok-imagine\n * image models, the generic `size` option uses an\n * `aspectRatio_resolution` template (\"16:9_720p\") — the resolution suffix\n * is optional (\"16:9\" uses the API default).\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GrokVideoSize =\n  | GrokVideoAspectRatio\n  | `${GrokVideoAspectRatio}_${GrokVideoResolution}`\n\nconst GROK_VIDEO_ASPECT_RATIOS: ReadonlyArray<string> = [\n  '1:1',\n  '16:9',\n  '9:16',\n  '4:3',\n  '3:4',\n  '3:2',\n  '2:3',\n]\n\nconst GROK_VIDEO_RESOLUTIONS: ReadonlyArray<string> = ['480p', '720p', '1080p']\n\n/**\n * Video duration limits enforced by the Imagine API (seconds).\n */\nexport const GROK_VIDEO_MIN_DURATION = 1\nexport const GROK_VIDEO_MAX_DURATION = 15\n\n/**\n * Parses a grok video size string into its components.\n * Format: \"aspectRatio\" or \"aspectRatio_resolution\",\n * e.g. \"16:9_720p\" → { aspectRatio: \"16:9\", resolution: \"720p\" }.\n * Returns undefined when the string doesn't match the template.\n */\nexport function parseGrokVideoSize(\n  size: string,\n): { aspectRatio: string; resolution?: string } | undefined {\n  const match = size.match(/^([\\d.]+:[\\d.]+)(?:_(.+))?$/)\n  const [, aspectRatio, resolution] = match ?? []\n  if (aspectRatio === undefined) return undefined\n  return { aspectRatio, ...(resolution !== undefined && { resolution }) }\n}\n\n/**\n * Validate the `size` template for a given grok video model.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function validateVideoSize(\n  model: string,\n  size?: string,\n): asserts size is GrokVideoSize | undefined {\n  if (size === undefined) return\n  const parsed = parseGrokVideoSize(size)\n  if (!parsed || !GROK_VIDEO_ASPECT_RATIOS.includes(parsed.aspectRatio)) {\n    throw new Error(\n      `Size \"${size}\" is not supported by model \"${model}\". Expected ` +\n        `\"aspectRatio\" or \"aspectRatio_resolution\" (e.g. \"16:9_720p\") with ` +\n        `aspect ratio one of: ${GROK_VIDEO_ASPECT_RATIOS.join(', ')}`,\n    )\n  }\n  if (\n    parsed.resolution !== undefined &&\n    !GROK_VIDEO_RESOLUTIONS.includes(parsed.resolution)\n  ) {\n    throw new Error(\n      `Resolution \"${parsed.resolution}\" is not supported by model \"${model}\". ` +\n        `Supported resolutions: ${GROK_VIDEO_RESOLUTIONS.join(', ')}`,\n    )\n  }\n}\n\n/**\n * Per-model duration type. The Imagine API accepts any integer second in the\n * 1–15 range, so this is a continuous range expressed as `number` (a literal\n * union can't represent it). `snapDuration()` coerces a raw seconds value into\n * the valid range at runtime.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GrokVideoModelDurationByName = {\n  'grok-imagine-video': number\n  'grok-imagine-video-1.5': number\n}\n\n/**\n * Runtime duration table backing `availableDurations()` / `snapDuration()`.\n * Both grok-imagine video models accept the same continuous 1–15 integer-second\n * range.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport const GROK_VIDEO_DURATIONS: {\n  readonly [TModel in GrokVideoModel]: DurationOptions<\n    GrokVideoModelDurationByName[TModel]\n  >\n} = {\n  'grok-imagine-video': {\n    kind: 'range',\n    min: GROK_VIDEO_MIN_DURATION,\n    max: GROK_VIDEO_MAX_DURATION,\n    step: 1,\n    unit: 'seconds',\n  },\n  'grok-imagine-video-1.5': {\n    kind: 'range',\n    min: GROK_VIDEO_MIN_DURATION,\n    max: GROK_VIDEO_MAX_DURATION,\n    step: 1,\n    unit: 'seconds',\n  },\n}\n\n/**\n * Look up the duration options for a grok video model.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function getGrokVideoDurationOptions<TModel extends GrokVideoModel>(\n  model: TModel,\n): DurationOptions<GrokVideoModelDurationByName[TModel]> {\n  return GROK_VIDEO_DURATIONS[model]\n}\n\n/**\n * Provider-specific options for grok video generation. These map directly\n * onto the Imagine API request body and take precedence over the generic\n * `size` / `duration` options when both are provided.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport interface GrokVideoProviderOptions {\n  /**\n   * Output aspect ratio.\n   */\n  aspect_ratio?: GrokVideoAspectRatio\n\n  /**\n   * Output resolution tier.\n   */\n  resolution?: GrokVideoResolution\n\n  /**\n   * Video duration in integer seconds (1–15).\n   */\n  duration?: number\n}\n\n/**\n * Type-only map from model name to its specific provider options.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GrokVideoModelProviderOptionsByName = {\n  'grok-imagine-video': GrokVideoProviderOptions\n  'grok-imagine-video-1.5': GrokVideoProviderOptions\n}\n\n/**\n * Type-only map from model name to its supported `size` strings.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GrokVideoModelSizeByName = {\n  'grok-imagine-video': GrokVideoSize\n  'grok-imagine-video-1.5': GrokVideoSize\n}\n\n/**\n * Type-only map from model name to the non-text prompt modalities it accepts.\n * Both models accept an `image` prompt part as the starting frame:\n * `grok-imagine-video` (v1.0) does text-to-video and image-to-video, while\n * `grok-imagine-video-1.5` is image-to-video only (the image is required).\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type GrokVideoModelInputModalitiesByName = {\n  'grok-imagine-video': readonly ['image']\n  'grok-imagine-video-1.5': readonly ['image']\n}\n\n/**\n * Models that only support image-to-video — a starting-frame image is\n * required and text-to-video is rejected by the Imagine API. Used by the\n * adapter to fail fast with a clear message instead of surfacing the raw\n * \"Text-to-video is not supported for this model\" 400.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nconst GROK_VIDEO_IMAGE_TO_VIDEO_ONLY: ReadonlySet<string> = new Set([\n  'grok-imagine-video-1.5',\n])\n\n/**\n * True when the model only supports image-to-video (a starting frame is\n * required).\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function isImageToVideoOnlyModel(model: string): boolean {\n  return GROK_VIDEO_IMAGE_TO_VIDEO_ONLY.has(model)\n}\n"],"names":[],"mappings":"AAiDA,MAAM,2BAAkD;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,yBAAgD,CAAC,QAAQ,QAAQ,OAAO;AAKvE,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAQhC,SAAS,mBACd,MAC0D;AAC1D,QAAM,QAAQ,KAAK,MAAM,6BAA6B;AACtD,QAAM,GAAG,aAAa,UAAU,IAAI,SAAS,CAAA;AAC7C,MAAI,gBAAgB,OAAW,QAAO;AACtC,SAAO,EAAE,aAAa,GAAI,eAAe,UAAa,EAAE,aAAW;AACrE;AAOO,SAAS,kBACd,OACA,MAC2C;AAC3C,MAAI,SAAS,OAAW;AACxB,QAAM,SAAS,mBAAmB,IAAI;AACtC,MAAI,CAAC,UAAU,CAAC,yBAAyB,SAAS,OAAO,WAAW,GAAG;AACrE,UAAM,IAAI;AAAA,MACR,SAAS,IAAI,gCAAgC,KAAK,sGAExB,yBAAyB,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAEjE;AACA,MACE,OAAO,eAAe,UACtB,CAAC,uBAAuB,SAAS,OAAO,UAAU,GAClD;AACA,UAAM,IAAI;AAAA,MACR,eAAe,OAAO,UAAU,gCAAgC,KAAK,6BACzC,uBAAuB,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAEjE;AACF;AAsBO,MAAM,uBAIT;AAAA,EACF,sBAAsB;AAAA,IACpB,MAAM;AAAA,IACN,KAAK;AAAA,IACL,KAAK;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,EAAA;AAAA,EAER,0BAA0B;AAAA,IACxB,MAAM;AAAA,IACN,KAAK;AAAA,IACL,KAAK;AAAA,IACL,MAAM;AAAA,IACN,MAAM;AAAA,EAAA;AAEV;AAOO,SAAS,4BACd,OACuD;AACvD,SAAO,qBAAqB,KAAK;AACnC;AAmEA,MAAM,qDAA0D,IAAI;AAAA,EAClE;AACF,CAAC;AAQM,SAAS,wBAAwB,OAAwB;AAC9D,SAAO,+BAA+B,IAAI,KAAK;AACjD;"}