@tanstack/ai-lovable 0.0.0

package/dist/esm/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @module @tanstack/ai-lovable
+ *
+ * Lovable AI Gateway adapter for TanStack AI.
+ */
+export { LovableTextAdapter, type LovableTextConfig, type LovableTextProviderOptions, } from './adapters/text.js';
+export { createLovableText, lovableText, type LovableTextApi, type LovableResponsesApiConfig, type LovableChatApiConfig, } from './adapters/factory.js';
+export { LovableResponsesTextAdapter, createLovableResponsesText, lovableResponsesText, type LovableResponsesTextConfig, type LovableResponsesTextProviderOptions, } from './adapters/responses-text.js';
+export { createLovableSummarize, lovableSummarize, type LovableSummarizeConfig, type LovableSummarizeModel, } from './adapters/summarize.js';
+export { LovableEmbeddingAdapter, createLovableEmbedding, lovableEmbedding, type LovableEmbeddingConfig, } from './adapters/embedding.js';
+export type { LovableEmbeddingProviderOptions } from './embedding/embedding-provider-options.js';
+export { LovableImageAdapter, createLovableImage, lovableImage, type LovableImageConfig, } from './adapters/image.js';
+export type { LovableImageProviderOptions } from './image/image-provider-options.js';
+/**
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export { LovableVideoAdapter, createLovableVideo, lovableVideo, type LovableVideoConfig, } from './adapters/video.js';
+export type { LovableVideoProviderOptions, LovableVideoSize, LovableHdVideoSize, Lovable4kVideoSize, LovableVideoDuration, LovableVideoSeconds, } from './video/video-provider-options.js';
+export { LovableTTSAdapter, createLovableSpeech, lovableSpeech, type LovableTTSConfig, } from './adapters/tts.js';
+export type { LovableTTSProviderOptions, LovableTTSVoice, LovableTTSFormat, } from './audio/tts-provider-options.js';
+export { LovableTranscriptionAdapter, createLovableTranscription, lovableTranscription, type LovableTranscriptionConfig, } from './adapters/transcription.js';
+export type { LovableTranscriptionProviderOptions } from './audio/transcription-provider-options.js';
+export { LOVABLE_CHAT_MODELS, LOVABLE_IMAGE_MODELS, LOVABLE_VIDEO_MODELS, LOVABLE_EMBEDDING_MODELS, LOVABLE_TTS_MODELS, LOVABLE_TRANSCRIPTION_MODELS, } from './model-meta.js';
+export type { LovableChatModel, LovableModelId, LovableChatModelProviderOptionsByName, LovableModelInputModalitiesByName, LovableImageModel, LovableVideoModel, LovableEmbeddingModel, LovableTTSModel, LovableTranscriptionModel, ResolveProviderOptions, ResolveInputModalities, } from './model-meta.js';
+export type { LovableTextMetadata, LovableImageMetadata, LovableAudioMetadata, LovableVideoMetadata, LovableDocumentMetadata, LovableMessageMetadataByModality, } from './message-types.js';
+export { getLovableApiKeyFromEnv, lovableGatewayHeaders, type LovableClientConfig, } from './utils/client.js';

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+import { getLovableApiKeyFromEnv, lovableGatewayHeaders } from "./utils/client.js";
+import { LovableTextAdapter } from "./adapters/text.js";
+import { LovableResponsesTextAdapter, createLovableResponsesText, lovableResponsesText } from "./adapters/responses-text.js";
+import { createLovableText, lovableText } from "./adapters/factory.js";
+import { createLovableSummarize, lovableSummarize } from "./adapters/summarize.js";
+import { LovableEmbeddingAdapter, createLovableEmbedding, lovableEmbedding } from "./adapters/embedding.js";
+import { LovableImageAdapter, createLovableImage, lovableImage } from "./adapters/image.js";
+import { LovableVideoAdapter, createLovableVideo, lovableVideo } from "./adapters/video.js";
+import { LovableTTSAdapter, createLovableSpeech, lovableSpeech } from "./adapters/tts.js";
+import { LovableTranscriptionAdapter, createLovableTranscription, lovableTranscription } from "./adapters/transcription.js";
+import { LOVABLE_CHAT_MODELS, LOVABLE_EMBEDDING_MODELS, LOVABLE_IMAGE_MODELS, LOVABLE_TRANSCRIPTION_MODELS, LOVABLE_TTS_MODELS, LOVABLE_VIDEO_MODELS } from "./model-meta.js";
+export { LOVABLE_CHAT_MODELS, LOVABLE_EMBEDDING_MODELS, LOVABLE_IMAGE_MODELS, LOVABLE_TRANSCRIPTION_MODELS, LOVABLE_TTS_MODELS, LOVABLE_VIDEO_MODELS, LovableEmbeddingAdapter, LovableImageAdapter, LovableResponsesTextAdapter, LovableTTSAdapter, LovableTextAdapter, LovableTranscriptionAdapter, LovableVideoAdapter, createLovableEmbedding, createLovableImage, createLovableResponsesText, createLovableSpeech, createLovableSummarize, createLovableText, createLovableTranscription, createLovableVideo, getLovableApiKeyFromEnv, lovableEmbedding, lovableGatewayHeaders, lovableImage, lovableResponsesText, lovableSpeech, lovableSummarize, lovableText, lovableTranscription, lovableVideo };

package/dist/esm/message-types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Metadata for Lovable AI Gateway document content parts.
+ */
+export interface LovableDocumentMetadata {
+}
+/**
+ * Metadata for Lovable AI Gateway text content parts.
+ */
+export interface LovableTextMetadata {
+}
+/**
+ * Metadata for Lovable AI Gateway image content parts.
+ */
+export interface LovableImageMetadata {
+    /**
+     * Specifies the detail level of the image.
+     * - 'auto': Let the model decide based on image size and content
+     * - 'low': Use low resolution processing (faster, cheaper, less detail)
+     * - 'high': Use high resolution processing (slower, more expensive, more detail)
+     *
+     * @default 'auto'
+     */
+    detail?: 'auto' | 'low' | 'high';
+}
+/**
+ * Metadata for Lovable AI Gateway audio content parts.
+ */
+export interface LovableAudioMetadata {
+}
+/**
+ * Metadata for Lovable AI Gateway video content parts.
+ */
+export interface LovableVideoMetadata {
+}
+/**
+ * Map of modality types to their Lovable AI Gateway metadata types.
+ */
+export interface LovableMessageMetadataByModality {
+    text: LovableTextMetadata;
+    image: LovableImageMetadata;
+    audio: LovableAudioMetadata;
+    video: LovableVideoMetadata;
+    document: LovableDocumentMetadata;
+}

package/dist/esm/model-meta.d.ts

@@ -0,0 +1,71 @@
+import { LovableEmbeddingProviderOptions } from './embedding/embedding-provider-options.js';
+import { LovableImageProviderOptions, LovableImageSize } from './image/image-provider-options.js';
+import { LovableTextProviderOptions } from './text/text-provider-options.js';
+import { LovableHdVideoSize, LovableVideoDuration, LovableVideoProviderOptions, LovableVideoSize } from './video/video-provider-options.js';
+/**
+ * Chat models listed on https://docs.lovable.dev/features/ai.
+ * Ids use the `google/` and `openai/` form that the gateway accepts.
+ */
+export declare const LOVABLE_CHAT_MODELS: readonly ["google/gemini-3.7-flash", "google/gemini-3.6-flash", "google/gemini-3.5-flash", "google/gemini-3.1-pro-preview", "google/gemini-3.1-flash-lite", "google/gemini-3-flash-preview", "google/gemini-2.5-pro", "google/gemini-2.5-flash", "google/gemini-2.5-flash-lite", "openai/gpt-5.6-sol", "openai/gpt-5.6-terra", "openai/gpt-5.6-luna", "openai/gpt-5.5-pro", "openai/gpt-5.5", "openai/gpt-5.4-pro", "openai/gpt-5.4", "openai/gpt-5.4-mini", "openai/gpt-5.4-nano", "openai/gpt-5.2", "openai/gpt-5", "openai/gpt-5-mini", "openai/gpt-5-nano"];
+export type LovableChatModel = (typeof LOVABLE_CHAT_MODELS)[number];
+/**
+ * A curated chat model id, or any other id the gateway accepts.
+ * Uncurated ids fall back to text-only input and the generic provider options.
+ */
+export type LovableModelId = LovableChatModel | (string & {});
+export type LovableChatModelProviderOptionsByName = {
+    [K in LovableChatModel]: LovableTextProviderOptions;
+};
+export type LovableModelInputModalitiesByName = {
+    [K in LovableChatModel]: readonly ['text', 'image'];
+};
+export type LovableChatModelToolCapabilitiesByName = {
+    [K in LovableChatModel]: readonly [];
+};
+export type ResolveProviderOptions<TModel extends string> = TModel extends keyof LovableChatModelProviderOptionsByName ? LovableChatModelProviderOptionsByName[TModel] : LovableTextProviderOptions;
+export type ResolveInputModalities<TModel extends string> = TModel extends keyof LovableModelInputModalitiesByName ? LovableModelInputModalitiesByName[TModel] : readonly ['text'];
+export declare const LOVABLE_IMAGE_MODELS: readonly ["openai/gpt-image-2", "openai/gpt-image-1-mini", "google/gemini-3.1-flash-image", "google/gemini-3.1-flash-lite-image", "google/gemini-3-pro-image", "google/gemini-2.5-flash-image"];
+export type LovableImageModel = (typeof LOVABLE_IMAGE_MODELS)[number];
+export type LovableImageModelProviderOptionsByName = {
+    [K in LovableImageModel]: LovableImageProviderOptions;
+};
+export type LovableImageModelSizeByName = {
+    [K in LovableImageModel]: LovableImageSize;
+};
+export type LovableImageModelInputModalitiesByName = {
+    [K in LovableImageModel]: readonly ['image'];
+};
+/**
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export declare const LOVABLE_VIDEO_MODELS: readonly ["google/veo-3.1-lite", "google/veo-3.1-fast", "google/veo-3.1"];
+/**
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type LovableVideoModel = (typeof LOVABLE_VIDEO_MODELS)[number];
+export type LovableVideoModelProviderOptionsByName = {
+    [K in LovableVideoModel]: LovableVideoProviderOptions;
+};
+export type LovableVideoModelSizeByName = {
+    'google/veo-3.1-lite': LovableHdVideoSize;
+    'google/veo-3.1-fast': LovableVideoSize;
+    'google/veo-3.1': LovableVideoSize;
+};
+export type LovableVideoModelDurationByName = {
+    [K in LovableVideoModel]: LovableVideoDuration;
+};
+export type LovableVideoModelInputModalitiesByName = {
+    [K in LovableVideoModel]: readonly ['image'];
+};
+export declare const LOVABLE_EMBEDDING_MODELS: readonly ["google/gemini-embedding-2", "google/gemini-embedding-001", "openai/text-embedding-3-small", "openai/text-embedding-3-large"];
+export type LovableEmbeddingModel = (typeof LOVABLE_EMBEDDING_MODELS)[number];
+export type LovableEmbeddingModelProviderOptionsByName = {
+    [K in LovableEmbeddingModel]: LovableEmbeddingProviderOptions;
+};
+export type LovableEmbeddingModelInputModalitiesByName = {
+    [K in LovableEmbeddingModel]: readonly ['text'];
+};
+export declare const LOVABLE_TTS_MODELS: readonly ["openai/gpt-4o-mini-tts", "google/gemini-2.5-flash-tts", "google/gemini-2.5-pro-tts", "google/gemini-2.5-flash-lite-preview-tts", "google/gemini-3.1-flash-tts-preview"];
+export type LovableTTSModel = (typeof LOVABLE_TTS_MODELS)[number];
+export declare const LOVABLE_TRANSCRIPTION_MODELS: readonly ["openai/gpt-4o-mini-transcribe", "openai/gpt-4o-transcribe"];
+export type LovableTranscriptionModel = (typeof LOVABLE_TRANSCRIPTION_MODELS)[number];

package/dist/esm/model-meta.js

@@ -0,0 +1,63 @@
+//#region src/model-meta.ts
+/**
+* Chat models listed on https://docs.lovable.dev/features/ai.
+* Ids use the `google/` and `openai/` form that the gateway accepts.
+*/
+var LOVABLE_CHAT_MODELS = [
+	"google/gemini-3.7-flash",
+	"google/gemini-3.6-flash",
+	"google/gemini-3.5-flash",
+	"google/gemini-3.1-pro-preview",
+	"google/gemini-3.1-flash-lite",
+	"google/gemini-3-flash-preview",
+	"google/gemini-2.5-pro",
+	"google/gemini-2.5-flash",
+	"google/gemini-2.5-flash-lite",
+	"openai/gpt-5.6-sol",
+	"openai/gpt-5.6-terra",
+	"openai/gpt-5.6-luna",
+	"openai/gpt-5.5-pro",
+	"openai/gpt-5.5",
+	"openai/gpt-5.4-pro",
+	"openai/gpt-5.4",
+	"openai/gpt-5.4-mini",
+	"openai/gpt-5.4-nano",
+	"openai/gpt-5.2",
+	"openai/gpt-5",
+	"openai/gpt-5-mini",
+	"openai/gpt-5-nano"
+];
+var LOVABLE_IMAGE_MODELS = [
+	"openai/gpt-image-2",
+	"openai/gpt-image-1-mini",
+	"google/gemini-3.1-flash-image",
+	"google/gemini-3.1-flash-lite-image",
+	"google/gemini-3-pro-image",
+	"google/gemini-2.5-flash-image"
+];
+/**
+* @experimental Video generation is an experimental feature and may change.
+*/
+var LOVABLE_VIDEO_MODELS = [
+	"google/veo-3.1-lite",
+	"google/veo-3.1-fast",
+	"google/veo-3.1"
+];
+var LOVABLE_EMBEDDING_MODELS = [
+	"google/gemini-embedding-2",
+	"google/gemini-embedding-001",
+	"openai/text-embedding-3-small",
+	"openai/text-embedding-3-large"
+];
+var LOVABLE_TTS_MODELS = [
+	"openai/gpt-4o-mini-tts",
+	"google/gemini-2.5-flash-tts",
+	"google/gemini-2.5-pro-tts",
+	"google/gemini-2.5-flash-lite-preview-tts",
+	"google/gemini-3.1-flash-tts-preview"
+];
+var LOVABLE_TRANSCRIPTION_MODELS = ["openai/gpt-4o-mini-transcribe", "openai/gpt-4o-transcribe"];
+//#endregion
+export { LOVABLE_CHAT_MODELS, LOVABLE_EMBEDDING_MODELS, LOVABLE_IMAGE_MODELS, LOVABLE_TRANSCRIPTION_MODELS, LOVABLE_TTS_MODELS, LOVABLE_VIDEO_MODELS };
+
+//# sourceMappingURL=model-meta.js.map

package/dist/esm/model-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-meta.js","names":[],"sources":["../../src/model-meta.ts"],"sourcesContent":["import type { LovableEmbeddingProviderOptions } from './embedding/embedding-provider-options'\nimport type {\n  LovableImageProviderOptions,\n  LovableImageSize,\n} from './image/image-provider-options'\nimport type { LovableTextProviderOptions } from './text/text-provider-options'\nimport type {\n  LovableHdVideoSize,\n  LovableVideoDuration,\n  LovableVideoProviderOptions,\n  LovableVideoSize,\n} from './video/video-provider-options'\n\n/**\n * Chat models listed on https://docs.lovable.dev/features/ai.\n * Ids use the `google/` and `openai/` form that the gateway accepts.\n */\nexport const LOVABLE_CHAT_MODELS = [\n  'google/gemini-3.7-flash',\n  'google/gemini-3.6-flash',\n  'google/gemini-3.5-flash',\n  'google/gemini-3.1-pro-preview',\n  'google/gemini-3.1-flash-lite',\n  'google/gemini-3-flash-preview',\n  'google/gemini-2.5-pro',\n  'google/gemini-2.5-flash',\n  'google/gemini-2.5-flash-lite',\n  'openai/gpt-5.6-sol',\n  'openai/gpt-5.6-terra',\n  'openai/gpt-5.6-luna',\n  'openai/gpt-5.5-pro',\n  'openai/gpt-5.5',\n  'openai/gpt-5.4-pro',\n  'openai/gpt-5.4',\n  'openai/gpt-5.4-mini',\n  'openai/gpt-5.4-nano',\n  'openai/gpt-5.2',\n  'openai/gpt-5',\n  'openai/gpt-5-mini',\n  'openai/gpt-5-nano',\n] as const\n\nexport type LovableChatModel = (typeof LOVABLE_CHAT_MODELS)[number]\n\n/**\n * A curated chat model id, or any other id the gateway accepts.\n * Uncurated ids fall back to text-only input and the generic provider options.\n */\nexport type LovableModelId = LovableChatModel | (string & {})\n\nexport type LovableChatModelProviderOptionsByName = {\n  [K in LovableChatModel]: LovableTextProviderOptions\n}\n\nexport type LovableModelInputModalitiesByName = {\n  [K in LovableChatModel]: readonly ['text', 'image']\n}\n\nexport type LovableChatModelToolCapabilitiesByName = {\n  [K in LovableChatModel]: readonly []\n}\n\nexport type ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof LovableChatModelProviderOptionsByName\n    ? LovableChatModelProviderOptionsByName[TModel]\n    : LovableTextProviderOptions\n\nexport type ResolveInputModalities<TModel extends string> =\n  TModel extends keyof LovableModelInputModalitiesByName\n    ? LovableModelInputModalitiesByName[TModel]\n    : readonly ['text']\n\nexport const LOVABLE_IMAGE_MODELS = [\n  'openai/gpt-image-2',\n  'openai/gpt-image-1-mini',\n  'google/gemini-3.1-flash-image',\n  'google/gemini-3.1-flash-lite-image',\n  'google/gemini-3-pro-image',\n  'google/gemini-2.5-flash-image',\n] as const\n\nexport type LovableImageModel = (typeof LOVABLE_IMAGE_MODELS)[number]\n\nexport type LovableImageModelProviderOptionsByName = {\n  [K in LovableImageModel]: LovableImageProviderOptions\n}\n\nexport type LovableImageModelSizeByName = {\n  [K in LovableImageModel]: LovableImageSize\n}\n\nexport type LovableImageModelInputModalitiesByName = {\n  [K in LovableImageModel]: readonly ['image']\n}\n\n/**\n * @experimental Video generation is an experimental feature and may change.\n */\nexport const LOVABLE_VIDEO_MODELS = [\n  'google/veo-3.1-lite',\n  'google/veo-3.1-fast',\n  'google/veo-3.1',\n] as const\n\n/**\n * @experimental Video generation is an experimental feature and may change.\n */\nexport type LovableVideoModel = (typeof LOVABLE_VIDEO_MODELS)[number]\n\nexport type LovableVideoModelProviderOptionsByName = {\n  [K in LovableVideoModel]: LovableVideoProviderOptions\n}\n\nexport type LovableVideoModelSizeByName = {\n  'google/veo-3.1-lite': LovableHdVideoSize\n  'google/veo-3.1-fast': LovableVideoSize\n  'google/veo-3.1': LovableVideoSize\n}\n\nexport type LovableVideoModelDurationByName = {\n  [K in LovableVideoModel]: LovableVideoDuration\n}\n\nexport type LovableVideoModelInputModalitiesByName = {\n  [K in LovableVideoModel]: readonly ['image']\n}\n\nexport const LOVABLE_EMBEDDING_MODELS = [\n  'google/gemini-embedding-2',\n  'google/gemini-embedding-001',\n  'openai/text-embedding-3-small',\n  'openai/text-embedding-3-large',\n] as const\n\nexport type LovableEmbeddingModel = (typeof LOVABLE_EMBEDDING_MODELS)[number]\n\nexport type LovableEmbeddingModelProviderOptionsByName = {\n  [K in LovableEmbeddingModel]: LovableEmbeddingProviderOptions\n}\n\nexport type LovableEmbeddingModelInputModalitiesByName = {\n  [K in LovableEmbeddingModel]: readonly ['text']\n}\n\nexport const LOVABLE_TTS_MODELS = [\n  'openai/gpt-4o-mini-tts',\n  'google/gemini-2.5-flash-tts',\n  'google/gemini-2.5-pro-tts',\n  'google/gemini-2.5-flash-lite-preview-tts',\n  'google/gemini-3.1-flash-tts-preview',\n] as const\n\nexport type LovableTTSModel = (typeof LOVABLE_TTS_MODELS)[number]\n\nexport const LOVABLE_TRANSCRIPTION_MODELS = [\n  'openai/gpt-4o-mini-transcribe',\n  'openai/gpt-4o-transcribe',\n] as const\n\nexport type LovableTranscriptionModel =\n  (typeof LOVABLE_TRANSCRIPTION_MODELS)[number]\n"],"mappings":";;;;;AAiBA,IAAa,sBAAsB;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAgCA,IAAa,uBAAuB;CAClC;CACA;CACA;CACA;CACA;CACA;AACF;;;;AAmBA,IAAa,uBAAuB;CAClC;CACA;CACA;AACF;AAyBA,IAAa,2BAA2B;CACtC;CACA;CACA;CACA;AACF;AAYA,IAAa,qBAAqB;CAChC;CACA;CACA;CACA;CACA;AACF;AAIA,IAAa,+BAA+B,CAC1C,iCACA,0BACF"}

package/dist/esm/text/responses-provider-options.d.ts

@@ -0,0 +1,3 @@
+import { LovableTextProviderOptions } from './text-provider-options.js';
+export type LovableResponsesProviderOptions = Pick<LovableTextProviderOptions, 'temperature' | 'top_p' | 'max_output_tokens' | 'user'>;
+export type ExternalResponsesProviderOptions = LovableResponsesProviderOptions;

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

@@ -0,0 +1,17 @@
+export interface LovableTextProviderOptions {
+    temperature?: number | null;
+    top_p?: number | null;
+    max_tokens?: number | null;
+    max_completion_tokens?: number | null;
+    max_output_tokens?: number | null;
+    frequency_penalty?: number | null;
+    presence_penalty?: number | null;
+    stop?: string | null | Array<string>;
+    seed?: number | null;
+    reasoning?: boolean | Record<string, unknown> | null;
+    include_reasoning?: boolean | null;
+    response_format?: unknown;
+    structured_outputs?: boolean | null;
+    user?: string | null;
+}
+export type ExternalTextProviderOptions = LovableTextProviderOptions;

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

@@ -0,0 +1,14 @@
+import { ClientOptions } from 'openai';
+export declare const LOVABLE_DEFAULT_BASE_URL = "https://ai.gateway.lovable.dev/v1";
+export interface LovableClientConfig extends Omit<ClientOptions, 'apiKey'> {
+    apiKey: string;
+}
+export declare function getLovableApiKeyFromEnv(): string;
+export declare function lovableGatewayHeaders(apiKey: string): {
+    'Lovable-API-Key': string;
+    'X-Lovable-AIG-SDK': string;
+};
+export declare function withLovableDefaults(config: LovableClientConfig): ClientOptions;
+export declare function openaiRequestOptions(abortSignal?: AbortSignal): {
+    signal: AbortSignal;
+} | undefined;

package/dist/esm/utils/client.js

@@ -0,0 +1,35 @@
+import { getApiKeyFromEnv } from "@tanstack/ai-utils";
+//#region src/utils/client.ts
+var LOVABLE_DEFAULT_BASE_URL = "https://ai.gateway.lovable.dev/v1";
+function getLovableApiKeyFromEnv() {
+	try {
+		return getApiKeyFromEnv("LOVABLE_API_KEY");
+	} catch (cause) {
+		throw new Error("LOVABLE_API_KEY is required. Set it in the environment or pass apiKey to the factory.", { cause });
+	}
+}
+function lovableGatewayHeaders(apiKey) {
+	return {
+		"Lovable-API-Key": apiKey,
+		"X-Lovable-AIG-SDK": "tanstack-ai"
+	};
+}
+function withLovableDefaults(config) {
+	const { defaultHeaders, ...rest } = config;
+	return {
+		...rest,
+		baseURL: config.baseURL || "https://ai.gateway.lovable.dev/v1",
+		defaultHeaders: {
+			...lovableGatewayHeaders(config.apiKey),
+			...defaultHeaders
+		}
+	};
+}
+function openaiRequestOptions(abortSignal) {
+	if (!abortSignal) return void 0;
+	return { signal: abortSignal };
+}
+//#endregion
+export { LOVABLE_DEFAULT_BASE_URL, getLovableApiKeyFromEnv, lovableGatewayHeaders, openaiRequestOptions, withLovableDefaults };
+
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { ClientOptions } from 'openai'\n\nexport const LOVABLE_DEFAULT_BASE_URL = 'https://ai.gateway.lovable.dev/v1'\n\nexport interface LovableClientConfig extends Omit<ClientOptions, 'apiKey'> {\n  apiKey: string\n}\n\nexport function getLovableApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('LOVABLE_API_KEY')\n  } catch (cause) {\n    throw new Error(\n      'LOVABLE_API_KEY is required. Set it in the environment or pass apiKey to the factory.',\n      { cause },\n    )\n  }\n}\n\nexport function lovableGatewayHeaders(apiKey: string): {\n  'Lovable-API-Key': string\n  'X-Lovable-AIG-SDK': string\n} {\n  return {\n    'Lovable-API-Key': apiKey,\n    'X-Lovable-AIG-SDK': 'tanstack-ai',\n  }\n}\n\nexport function withLovableDefaults(\n  config: LovableClientConfig,\n): ClientOptions {\n  const { defaultHeaders, ...rest } = config\n  return {\n    ...rest,\n    baseURL: config.baseURL || LOVABLE_DEFAULT_BASE_URL,\n    defaultHeaders: {\n      ...lovableGatewayHeaders(config.apiKey),\n      ...defaultHeaders,\n    },\n  }\n}\n\nexport function openaiRequestOptions(\n  abortSignal?: AbortSignal,\n): { signal: AbortSignal } | undefined {\n  if (!abortSignal) return undefined\n  return { signal: abortSignal }\n}\n"],"mappings":";;AAGA,IAAa,2BAA2B;AAMxC,SAAgB,0BAAkC;CAChD,IAAI;EACF,OAAO,iBAAiB,iBAAiB;CAC3C,SAAS,OAAO;EACd,MAAM,IAAI,MACR,yFACA,EAAE,MAAM,CACV;CACF;AACF;AAEA,SAAgB,sBAAsB,QAGpC;CACA,OAAO;EACL,mBAAmB;EACnB,qBAAqB;CACvB;AACF;AAEA,SAAgB,oBACd,QACe;CACf,MAAM,EAAE,gBAAgB,GAAG,SAAS;CACpC,OAAO;EACL,GAAG;EACH,SAAS,OAAO,WAAA;EAChB,gBAAgB;GACd,GAAG,sBAAsB,OAAO,MAAM;GACtC,GAAG;EACL;CACF;AACF;AAEA,SAAgB,qBACd,aACqC;CACrC,IAAI,CAAC,aAAa,OAAO,KAAA;CACzB,OAAO,EAAE,QAAQ,YAAY;AAC/B"}

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

@@ -0,0 +1,19 @@
+/**
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type LovableHdVideoSize = '1280x720' | '720x1280' | '1920x1080' | '1080x1920';
+export type Lovable4kVideoSize = '3840x2160' | '2160x3840';
+export type LovableVideoSize = LovableHdVideoSize | Lovable4kVideoSize;
+export type LovableVideoSeconds = '4' | '6' | '8';
+export type LovableVideoDuration = 4 | 6 | 8;
+export interface LovableVideoProviderOptions {
+    size?: LovableVideoSize;
+    seconds?: LovableVideoSeconds;
+}
+export declare function is4kVideoSize(size: string): size is Lovable4kVideoSize;
+export declare function isHighResVideoSize(size: string): boolean;
+export declare function supports4kVideo(model: string): boolean;
+export declare function validateVideoSize(model: string, size?: string): asserts size is LovableVideoSize | undefined;
+export declare function validateVideoSeconds(model: string, seconds?: number | string): asserts seconds is LovableVideoSeconds | LovableVideoDuration | undefined;
+export declare function validateHighResDuration(model: string, size: string | undefined, seconds: number | string | undefined): void;
+export declare function toApiSeconds(seconds: number | string | undefined): LovableVideoSeconds | undefined;

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

@@ -0,0 +1,47 @@
+//#region src/video/video-provider-options.ts
+var HD_SIZES = [
+	"1280x720",
+	"720x1280",
+	"1920x1080",
+	"1080x1920"
+];
+var FOUR_K_SIZES = ["3840x2160", "2160x3840"];
+var ALL_SIZES = [...HD_SIZES, ...FOUR_K_SIZES];
+var HIGH_RES_SIZES = /* @__PURE__ */ new Set([
+	"1920x1080",
+	"1080x1920",
+	"3840x2160",
+	"2160x3840"
+]);
+var FOUR_K_MODELS = /* @__PURE__ */ new Set(["google/veo-3.1-fast", "google/veo-3.1"]);
+function is4kVideoSize(size) {
+	return FOUR_K_SIZES.includes(size);
+}
+function isHighResVideoSize(size) {
+	return HIGH_RES_SIZES.has(size);
+}
+function supports4kVideo(model) {
+	return FOUR_K_MODELS.has(model);
+}
+function validateVideoSize(model, size) {
+	if (!size) return;
+	if (!ALL_SIZES.includes(size)) throw new Error(`Size "${size}" is not supported by model "${model}". Supported sizes: ${ALL_SIZES.join(", ")}`);
+	if (is4kVideoSize(size) && !supports4kVideo(model)) throw new Error(`Size "${size}" is 4K. Only google/veo-3.1-fast and google/veo-3.1 support 4K.`);
+}
+function validateVideoSeconds(model, seconds) {
+	if (seconds === void 0) return;
+	if (!(typeof seconds === "string" ? seconds === "4" || seconds === "6" || seconds === "8" : seconds === 4 || seconds === 6 || seconds === 8)) throw new Error(`Duration "${seconds}" is not supported by model "${model}". Supported durations: 4, 6, or 8 seconds`);
+}
+function validateHighResDuration(model, size, seconds) {
+	if (!size || !isHighResVideoSize(size)) return;
+	const asNumber = seconds === void 0 ? void 0 : typeof seconds === "string" ? Number(seconds) : seconds;
+	if (asNumber !== void 0 && asNumber !== 8) throw new Error(`Model "${model}" requires 8 second clips at 1080p and 4K. Received duration ${seconds}.`);
+}
+function toApiSeconds(seconds) {
+	if (seconds === void 0) return void 0;
+	return String(seconds);
+}
+//#endregion
+export { is4kVideoSize, isHighResVideoSize, supports4kVideo, toApiSeconds, validateHighResDuration, validateVideoSeconds, validateVideoSize };
+
+//# sourceMappingURL=video-provider-options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-provider-options.js","names":[],"sources":["../../../src/video/video-provider-options.ts"],"sourcesContent":["/**\n * @experimental Video generation is an experimental feature and may change.\n */\n\nexport type LovableHdVideoSize =\n  | '1280x720'\n  | '720x1280'\n  | '1920x1080'\n  | '1080x1920'\n\nexport type Lovable4kVideoSize = '3840x2160' | '2160x3840'\n\nexport type LovableVideoSize = LovableHdVideoSize | Lovable4kVideoSize\n\nexport type LovableVideoSeconds = '4' | '6' | '8'\n\nexport type LovableVideoDuration = 4 | 6 | 8\n\nexport interface LovableVideoProviderOptions {\n  size?: LovableVideoSize\n  seconds?: LovableVideoSeconds\n}\n\nconst HD_SIZES: ReadonlyArray<LovableHdVideoSize> = [\n  '1280x720',\n  '720x1280',\n  '1920x1080',\n  '1080x1920',\n]\n\nconst FOUR_K_SIZES: ReadonlyArray<Lovable4kVideoSize> = [\n  '3840x2160',\n  '2160x3840',\n]\n\nconst ALL_SIZES: ReadonlyArray<LovableVideoSize> = [\n  ...HD_SIZES,\n  ...FOUR_K_SIZES,\n]\n\nconst HIGH_RES_SIZES: ReadonlySet<string> = new Set([\n  '1920x1080',\n  '1080x1920',\n  '3840x2160',\n  '2160x3840',\n])\n\nconst FOUR_K_MODELS: ReadonlySet<string> = new Set([\n  'google/veo-3.1-fast',\n  'google/veo-3.1',\n])\n\nexport function is4kVideoSize(size: string): size is Lovable4kVideoSize {\n  return (FOUR_K_SIZES as ReadonlyArray<string>).includes(size)\n}\n\nexport function isHighResVideoSize(size: string): boolean {\n  return HIGH_RES_SIZES.has(size)\n}\n\nexport function supports4kVideo(model: string): boolean {\n  return FOUR_K_MODELS.has(model)\n}\n\nexport function validateVideoSize(\n  model: string,\n  size?: string,\n): asserts size is LovableVideoSize | undefined {\n  if (!size) return\n\n  if (!(ALL_SIZES as ReadonlyArray<string>).includes(size)) {\n    throw new Error(\n      `Size \"${size}\" is not supported by model \"${model}\". Supported sizes: ${ALL_SIZES.join(', ')}`,\n    )\n  }\n\n  if (is4kVideoSize(size) && !supports4kVideo(model)) {\n    throw new Error(\n      `Size \"${size}\" is 4K. Only google/veo-3.1-fast and google/veo-3.1 support 4K.`,\n    )\n  }\n}\n\nexport function validateVideoSeconds(\n  model: string,\n  seconds?: number | string,\n): asserts seconds is LovableVideoSeconds | LovableVideoDuration | undefined {\n  if (seconds === undefined) return\n\n  const isValid =\n    typeof seconds === 'string'\n      ? seconds === '4' || seconds === '6' || seconds === '8'\n      : seconds === 4 || seconds === 6 || seconds === 8\n\n  if (!isValid) {\n    throw new Error(\n      `Duration \"${seconds}\" is not supported by model \"${model}\". Supported durations: 4, 6, or 8 seconds`,\n    )\n  }\n}\n\nexport function validateHighResDuration(\n  model: string,\n  size: string | undefined,\n  seconds: number | string | undefined,\n): void {\n  if (!size || !isHighResVideoSize(size)) return\n\n  const asNumber =\n    seconds === undefined\n      ? undefined\n      : typeof seconds === 'string'\n        ? Number(seconds)\n        : seconds\n\n  if (asNumber !== undefined && asNumber !== 8) {\n    throw new Error(\n      `Model \"${model}\" requires 8 second clips at 1080p and 4K. Received duration ${seconds}.`,\n    )\n  }\n}\n\nexport function toApiSeconds(\n  seconds: number | string | undefined,\n): LovableVideoSeconds | undefined {\n  if (seconds === undefined) return undefined\n  return String(seconds) as LovableVideoSeconds\n}\n"],"mappings":";AAuBA,IAAM,WAA8C;CAClD;CACA;CACA;CACA;AACF;AAEA,IAAM,eAAkD,CACtD,aACA,WACF;AAEA,IAAM,YAA6C,CACjD,GAAG,UACH,GAAG,YACL;AAEA,IAAM,iCAAsC,IAAI,IAAI;CAClD;CACA;CACA;CACA;AACF,CAAC;AAED,IAAM,gCAAqC,IAAI,IAAI,CACjD,uBACA,gBACF,CAAC;AAED,SAAgB,cAAc,MAA0C;CACtE,OAAQ,aAAuC,SAAS,IAAI;AAC9D;AAEA,SAAgB,mBAAmB,MAAuB;CACxD,OAAO,eAAe,IAAI,IAAI;AAChC;AAEA,SAAgB,gBAAgB,OAAwB;CACtD,OAAO,cAAc,IAAI,KAAK;AAChC;AAEA,SAAgB,kBACd,OACA,MAC8C;CAC9C,IAAI,CAAC,MAAM;CAEX,IAAI,CAAE,UAAoC,SAAS,IAAI,GACrD,MAAM,IAAI,MACR,SAAS,KAAK,+BAA+B,MAAM,sBAAsB,UAAU,KAAK,IAAI,GAC9F;CAGF,IAAI,cAAc,IAAI,KAAK,CAAC,gBAAgB,KAAK,GAC/C,MAAM,IAAI,MACR,SAAS,KAAK,iEAChB;AAEJ;AAEA,SAAgB,qBACd,OACA,SAC2E;CAC3E,IAAI,YAAY,KAAA,GAAW;CAO3B,IAAI,EAJF,OAAO,YAAY,WACf,YAAY,OAAO,YAAY,OAAO,YAAY,MAClD,YAAY,KAAK,YAAY,KAAK,YAAY,IAGlD,MAAM,IAAI,MACR,aAAa,QAAQ,+BAA+B,MAAM,2CAC5D;AAEJ;AAEA,SAAgB,wBACd,OACA,MACA,SACM;CACN,IAAI,CAAC,QAAQ,CAAC,mBAAmB,IAAI,GAAG;CAExC,MAAM,WACJ,YAAY,KAAA,IACR,KAAA,IACA,OAAO,YAAY,WACjB,OAAO,OAAO,IACd;CAER,IAAI,aAAa,KAAA,KAAa,aAAa,GACzC,MAAM,IAAI,MACR,UAAU,MAAM,+DAA+D,QAAQ,EACzF;AAEJ;AAEA,SAAgB,aACd,SACiC;CACjC,IAAI,YAAY,KAAA,GAAW,OAAO,KAAA;CAClC,OAAO,OAAO,OAAO;AACvB"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@tanstack/ai-lovable",
+  "version": "0.0.0",
+  "description": "Lovable AI Gateway adapter for TanStack AI chat, embeddings, image, video, speech, and transcription.",
+  "author": "Tanner Linsley",
+  "license": "MIT",
+  "homepage": "https://tanstack.com/ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TanStack/ai.git",
+    "directory": "packages/ai-lovable"
+  },
+  "bugs": {
+    "url": "https://github.com/TanStack/ai/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/tannerlinsley"
+  },
+  "type": "module",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js"
+    },
+    "./byok": {
+      "types": "./dist/esm/byok.d.ts",
+      "import": "./dist/esm/byok.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "lovable",
+    "ai-gateway",
+    "adapter",
+    "llm",
+    "chat",
+    "embeddings",
+    "image-generation",
+    "video-generation",
+    "tts",
+    "transcription",
+    "streaming"
+  ],
+  "devDependencies": {
+    "@vitest/coverage-v8": "4.1.10",
+    "vite": "^8.2.1",
+    "zod": "^4.2.0",
+    "@tanstack/ai": "0.49.0"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0",
+    "@tanstack/ai": "^0.49.0"
+  },
+  "dependencies": {
+    "openai": "^6.41.0",
+    "@tanstack/ai-utils": "^0.4.0",
+    "@tanstack/openai-base": "^0.10.4"
+  },
+  "scripts": {
+    "build": "vite build",
+    "clean": "premove ./build ./dist",
+    "lint:fix": "oxlint src --type-aware --fix",
+    "test:build": "publint --strict",
+    "test:oxlint": "oxlint src --type-aware",
+    "test:lib": "vitest run",
+    "test:lib:dev": "pnpm test:lib --watch",
+    "test:types": "tsc"
+  }
+}

package/src/adapters/embedding.ts

@@ -0,0 +1,102 @@
+import OpenAI from 'openai'
+import { BaseEmbeddingAdapter } from '@tanstack/ai/adapters'
+import { toRunErrorPayload } from '@tanstack/ai/adapter-internals'
+import { generateId } from '@tanstack/ai-utils'
+import { requireTextOnlyEmbeddingInput } from '@tanstack/ai'
+import { getLovableApiKeyFromEnv, withLovableDefaults } from '../utils/client'
+import type {
+  EmbeddingOptions,
+  EmbeddingResult,
+  TokenUsage,
+} from '@tanstack/ai'
+import type OpenAI_SDK from 'openai'
+import type {
+  LovableEmbeddingModel,
+  LovableEmbeddingModelInputModalitiesByName,
+  LovableEmbeddingModelProviderOptionsByName,
+} from '../model-meta'
+import type { LovableEmbeddingProviderOptions } from '../embedding/embedding-provider-options'
+import type { LovableClientConfig } from '../utils/client'
+
+export interface LovableEmbeddingConfig extends LovableClientConfig {}
+
+export class LovableEmbeddingAdapter<
+  TModel extends LovableEmbeddingModel,
+> extends BaseEmbeddingAdapter<
+  TModel,
+  LovableEmbeddingProviderOptions,
+  LovableEmbeddingModelProviderOptionsByName,
+  LovableEmbeddingModelInputModalitiesByName
+> {
+  readonly name = 'lovable' as const
+
+  protected client: OpenAI
+
+  constructor(config: LovableEmbeddingConfig, model: TModel) {
+    super(model, {})
+    this.client = new OpenAI(withLovableDefaults(config))
+  }
+
+  async createEmbeddings(
+    options: EmbeddingOptions<LovableEmbeddingProviderOptions>,
+  ): Promise<EmbeddingResult> {
+    const { model, logger, modelOptions } = options
+    const texts = requireTextOnlyEmbeddingInput(options.input, this.name, model)
+
+    try {
+      const request: OpenAI_SDK.EmbeddingCreateParams = {
+        ...modelOptions,
+        model,
+        input: texts,
+        encoding_format: 'float',
+      }
+      if (options.dimensions !== undefined) {
+        request.dimensions = options.dimensions
+      }
+
+      logger.request(
+        `activity=embed provider=${this.name} model=${model} inputs=${texts.length}`,
+        { provider: this.name, model },
+      )
+
+      const response = await this.client.embeddings.create(request)
+
+      const usage: TokenUsage = {
+        promptTokens: response.usage.prompt_tokens,
+        completionTokens: 0,
+        totalTokens: response.usage.total_tokens,
+      }
+
+      return {
+        id: generateId(this.name),
+        model,
+        embeddings: response.data.map((item) => ({
+          vector: item.embedding,
+          index: item.index,
+        })),
+        usage,
+      }
+    } catch (error: unknown) {
+      logger.errors(`${this.name}.createEmbeddings fatal`, {
+        error: toRunErrorPayload(error, `${this.name}.createEmbeddings failed`),
+        source: `${this.name}.createEmbeddings`,
+      })
+      throw error
+    }
+  }
+}
+
+export function createLovableEmbedding<TModel extends LovableEmbeddingModel>(
+  model: TModel,
+  apiKey: string,
+  config?: Omit<LovableEmbeddingConfig, 'apiKey'>,
+): LovableEmbeddingAdapter<TModel> {
+  return new LovableEmbeddingAdapter({ apiKey, ...config }, model)
+}
+
+export function lovableEmbedding<TModel extends LovableEmbeddingModel>(
+  model: TModel,
+  config?: Omit<LovableEmbeddingConfig, 'apiKey'>,
+): LovableEmbeddingAdapter<TModel> {
+  return createLovableEmbedding(model, getLovableApiKeyFromEnv(), config)
+}