@ai-sdk/vercel 0.0.0-70e0935a-20260114150030 → 0.0.0-98261322-20260122142521

package/CHANGELOG.md

@@ -1,13 +1,72 @@
 # @ai-sdk/vercel
 
-## 0.0.0-70e0935a-20260114150030
+## 0.0.0-98261322-20260122142521
 
 ### Patch Changes
 
-- Updated dependencies [9fbe723]
-  - @ai-sdk/provider-utils@0.0.0-70e0935a-20260114150030
-  - @ai-sdk/provider@0.0.0-70e0935a-20260114150030
-  - @ai-sdk/openai-compatible@0.0.0-70e0935a-20260114150030
+- 080559b: chore: add docs to package dist
+
+## 2.0.17
+
+### Patch Changes
+
+- 8dc54db: chore: add src folders to package bundle
+- Updated dependencies [8dc54db]
+  - @ai-sdk/openai-compatible@2.0.17
+
+## 2.0.16
+
+### Patch Changes
+
+- Updated dependencies [78555ad]
+  - @ai-sdk/openai-compatible@2.0.16
+
+## 2.0.15
+
+### Patch Changes
+
+- Updated dependencies [7116ef3]
+  - @ai-sdk/openai-compatible@2.0.15
+
+## 2.0.14
+
+### Patch Changes
+
+- Updated dependencies [1612a57]
+  - @ai-sdk/openai-compatible@2.0.14
+
+## 2.0.13
+
+### Patch Changes
+
+- Updated dependencies [5c090e7]
+  - @ai-sdk/provider@3.0.4
+  - @ai-sdk/openai-compatible@2.0.13
+  - @ai-sdk/provider-utils@4.0.8
+
+## 2.0.12
+
+### Patch Changes
+
+- Updated dependencies [78a133a]
+  - @ai-sdk/openai-compatible@2.0.12
+
+## 2.0.11
+
+### Patch Changes
+
+- Updated dependencies [46f46e4]
+  - @ai-sdk/provider-utils@4.0.7
+  - @ai-sdk/openai-compatible@2.0.11
+
+## 2.0.10
+
+### Patch Changes
+
+- Updated dependencies [1b11dcb]
+  - @ai-sdk/provider-utils@4.0.6
+  - @ai-sdk/provider@3.0.3
+  - @ai-sdk/openai-compatible@2.0.10
 
 ## 2.0.9
 

package/dist/index.js

@@ -32,7 +32,7 @@ var import_openai_compatible = require("@ai-sdk/openai-compatible");
 var import_provider_utils = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "0.0.0-70e0935a-20260114150030" : "0.0.0-test";
+var VERSION = true ? "0.0.0-98261322-20260122142521" : "0.0.0-test";
 
 // src/vercel-provider.ts
 function createVercel(options = {}) {

package/dist/index.mjs

@@ -10,7 +10,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "0.0.0-70e0935a-20260114150030" : "0.0.0-test";
+var VERSION = true ? "0.0.0-98261322-20260122142521" : "0.0.0-test";
 
 // src/vercel-provider.ts
 function createVercel(options = {}) {

package/docs/02-vercel.mdx

@@ -0,0 +1,129 @@
+---
+title: Vercel
+description: Learn how to use Vercel's v0 models with the AI SDK.
+---
+
+# Vercel Provider
+
+The [Vercel](https://vercel.com) provider gives you access to the [v0 API](https://v0.app/docs/api/model), designed for building modern web applications. The v0 models support text and image inputs and provide fast streaming responses.
+
+You can create your Vercel API key at [v0.dev](https://v0.dev/chat/settings/keys).
+
+<Note>
+  The v0 API is currently in beta and requires a Premium or Team plan with
+  usage-based billing enabled. For details, visit the [pricing
+  page](https://v0.dev/pricing). To request a higher limit, contact Vercel at
+  support@v0.dev.
+</Note>
+
+## Features
+
+- **Framework aware completions**: Evaluated on modern stacks like Next.js and Vercel
+- **Auto-fix**: Identifies and corrects common coding issues during generation
+- **Quick edit**: Streams inline edits as they're available
+- **Multimodal**: Supports both text and image inputs
+
+## Setup
+
+The Vercel provider is available via the `@ai-sdk/vercel` module. You can install it with:
+
+<Tabs items={['pnpm', 'npm', 'yarn', 'bun']}>
+  <Tab>
+    <Snippet text="pnpm add @ai-sdk/vercel" dark />
+  </Tab>
+  <Tab>
+    <Snippet text="npm install @ai-sdk/vercel" dark />
+  </Tab>
+  <Tab>
+    <Snippet text="yarn add @ai-sdk/vercel" dark />
+  </Tab>
+
+  <Tab>
+    <Snippet text="bun add @ai-sdk/vercel" dark />
+  </Tab>
+</Tabs>
+
+## Provider Instance
+
+You can import the default provider instance `vercel` from `@ai-sdk/vercel`:
+
+```ts
+import { vercel } from '@ai-sdk/vercel';
+```
+
+If you need a customized setup, you can import `createVercel` from `@ai-sdk/vercel` and create a provider instance with your settings:
+
+```ts
+import { createVercel } from '@ai-sdk/vercel';
+
+const vercel = createVercel({
+  apiKey: process.env.VERCEL_API_KEY ?? '',
+});
+```
+
+You can use the following optional settings to customize the Vercel provider instance:
+
+- **baseURL** _string_
+
+  Use a different URL prefix for API calls. The default prefix is `https://api.v0.dev/v1`.
+
+- **apiKey** _string_
+
+  API key that is being sent using the `Authorization` header. It defaults to
+  the `VERCEL_API_KEY` environment variable.
+
+- **headers** _Record&lt;string,string&gt;_
+
+  Custom headers to include in the requests.
+
+- **fetch** _(input: RequestInfo, init?: RequestInit) => Promise&lt;Response&gt;_
+
+  Custom [fetch](https://developer.mozilla.org/en-US/docs/Web/API/fetch) implementation.
+  Defaults to the global `fetch` function.
+  You can use it as a middleware to intercept requests,
+  or to provide a custom fetch implementation for e.g. testing.
+
+## Language Models
+
+You can create language models using a provider instance. The first argument is the model ID, for example:
+
+```ts
+import { vercel } from '@ai-sdk/vercel';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: vercel('v0-1.0-md'),
+  prompt: 'Create a Next.js AI chatbot',
+});
+```
+
+Vercel language models can also be used in the `streamText` function (see [AI SDK Core](/docs/ai-sdk-core)).
+
+## Models
+
+### v0-1.5-md
+
+The `v0-1.5-md` model is for everyday tasks and UI generation.
+
+### v0-1.5-lg
+
+The `v0-1.5-lg` model is for advanced thinking or reasoning.
+
+### v0-1.0-md (legacy)
+
+The `v0-1.0-md` model is the legacy model served by the v0 API.
+
+All v0 models have the following capabilities:
+
+- Supports text and image inputs (multimodal)
+- Supports function/tool calls
+- Streaming responses with low latency
+- Optimized for frontend and full-stack web development
+
+## Model Capabilities
+
+| Model       | Image Input         | Object Generation   | Tool Usage          | Tool Streaming      |
+| ----------- | ------------------- | ------------------- | ------------------- | ------------------- |
+| `v0-1.5-md` | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| `v0-1.5-lg` | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| `v0-1.0-md` | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/vercel",
-  "version": "0.0.0-70e0935a-20260114150030",
+  "version": "0.0.0-98261322-20260122142521",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -8,9 +8,14 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist/**/*",
+    "docs/**/*",
+    "src",
     "CHANGELOG.md",
     "README.md"
   ],
+  "directories": {
+    "doc": "./docs"
+  },
   "exports": {
     "./package.json": "./package.json",
     ".": {
@@ -20,9 +25,9 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/openai-compatible": "0.0.0-70e0935a-20260114150030",
-    "@ai-sdk/provider": "0.0.0-70e0935a-20260114150030",
-    "@ai-sdk/provider-utils": "0.0.0-70e0935a-20260114150030"
+    "@ai-sdk/openai-compatible": "2.0.17",
+    "@ai-sdk/provider": "3.0.4",
+    "@ai-sdk/provider-utils": "4.0.8"
   },
   "devDependencies": {
     "@types/node": "20.17.24",
@@ -54,7 +59,7 @@
   "scripts": {
     "build": "pnpm clean && tsup --tsconfig tsconfig.build.json",
     "build:watch": "pnpm clean && tsup --watch",
-    "clean": "del-cli dist *.tsbuildinfo",
+    "clean": "del-cli dist docs *.tsbuildinfo",
     "lint": "eslint \"./**/*.ts*\"",
     "type-check": "tsc --build",
     "prettier-check": "prettier --check \"./**/*.ts*\"",

package/src/index.ts

@@ -0,0 +1,4 @@
+export { createVercel, vercel } from './vercel-provider';
+export type { VercelProvider, VercelProviderSettings } from './vercel-provider';
+export type { OpenAICompatibleErrorData as VercelErrorData } from '@ai-sdk/openai-compatible';
+export { VERSION } from './version';

package/src/vercel-chat-options.ts

@@ -0,0 +1,6 @@
+// https://v0.dev/docs/v0-model-api
+export type VercelChatModelId =
+  | 'v0-1.0-md'
+  | 'v0-1.5-md'
+  | 'v0-1.5-lg'
+  | (string & {});

package/src/vercel-provider.test.ts

@@ -0,0 +1,102 @@
+import { createVercel } from './vercel-provider';
+import { OpenAICompatibleChatLanguageModel } from '@ai-sdk/openai-compatible';
+import { LanguageModelV3 } from '@ai-sdk/provider';
+import { loadApiKey } from '@ai-sdk/provider-utils';
+import { describe, it, expect, vi, beforeEach, Mock } from 'vitest';
+
+const OpenAICompatibleChatLanguageModelMock =
+  OpenAICompatibleChatLanguageModel as unknown as Mock;
+
+vi.mock('@ai-sdk/openai-compatible', () => ({
+  OpenAICompatibleChatLanguageModel: vi.fn(),
+  OpenAICompatibleCompletionLanguageModel: vi.fn(),
+}));
+
+vi.mock('@ai-sdk/provider-utils', async () => {
+  const actual = await vi.importActual('@ai-sdk/provider-utils');
+  return {
+    ...actual,
+    loadApiKey: vi.fn().mockReturnValue('mock-api-key'),
+    withoutTrailingSlash: vi.fn(url => url),
+  };
+});
+
+vi.mock('./vercel-image-model', () => ({
+  VercelImageModel: vi.fn(),
+}));
+
+describe('VercelProvider', () => {
+  let mockLanguageModel: LanguageModelV3;
+
+  beforeEach(() => {
+    mockLanguageModel = {
+      // Add any required methods for LanguageModelV1
+    } as LanguageModelV3;
+
+    // Reset mocks
+    vi.clearAllMocks();
+  });
+
+  describe('createVercel', () => {
+    it('should create a VercelProvider instance with default options', () => {
+      const provider = createVercel();
+      provider('model-id');
+
+      // Use the mocked version
+      const constructorCall =
+        OpenAICompatibleChatLanguageModelMock.mock.calls[0];
+      const config = constructorCall[1];
+      config.headers();
+
+      expect(loadApiKey).toHaveBeenCalledWith({
+        apiKey: undefined,
+        environmentVariableName: 'VERCEL_API_KEY',
+        description: 'Vercel',
+      });
+    });
+
+    it('should create a VercelProvider instance with custom options', () => {
+      const options = {
+        apiKey: 'custom-key',
+        baseURL: 'https://custom.url',
+        headers: { 'Custom-Header': 'value' },
+      };
+      const provider = createVercel(options);
+      provider('model-id');
+
+      const constructorCall =
+        OpenAICompatibleChatLanguageModelMock.mock.calls[0];
+      const config = constructorCall[1];
+      config.headers();
+
+      expect(loadApiKey).toHaveBeenCalledWith({
+        apiKey: 'custom-key',
+        environmentVariableName: 'VERCEL_API_KEY',
+        description: 'Vercel',
+      });
+    });
+
+    it('should return a chat model when called as a function', () => {
+      const provider = createVercel();
+      const modelId = 'foo-model-id';
+
+      const model = provider(modelId);
+      expect(model).toBeInstanceOf(OpenAICompatibleChatLanguageModel);
+    });
+  });
+
+  it('should construct a language model with correct configuration', () => {
+    const provider = createVercel();
+    const modelId = 'vercel-chat-model';
+
+    const model = provider.languageModel(modelId);
+
+    expect(model).toBeInstanceOf(OpenAICompatibleChatLanguageModel);
+    expect(OpenAICompatibleChatLanguageModelMock).toHaveBeenCalledWith(
+      modelId,
+      expect.objectContaining({
+        provider: 'vercel.chat',
+      }),
+    );
+  });
+});

package/src/vercel-provider.ts

@@ -0,0 +1,107 @@
+import {
+  LanguageModelV3,
+  NoSuchModelError,
+  ProviderV3,
+} from '@ai-sdk/provider';
+import { OpenAICompatibleChatLanguageModel } from '@ai-sdk/openai-compatible';
+import {
+  FetchFunction,
+  loadApiKey,
+  withoutTrailingSlash,
+  withUserAgentSuffix,
+} from '@ai-sdk/provider-utils';
+import { VercelChatModelId } from './vercel-chat-options';
+import { VERSION } from './version';
+
+export interface VercelProviderSettings {
+  /**
+Vercel API key.
+*/
+  apiKey?: string;
+  /**
+Base URL for the API calls.
+*/
+  baseURL?: string;
+  /**
+Custom headers to include in the requests.
+*/
+  headers?: Record<string, string>;
+  /**
+Custom fetch implementation. You can use it as a middleware to intercept requests,
+or to provide a custom fetch implementation for e.g. testing.
+*/
+  fetch?: FetchFunction;
+}
+
+export interface VercelProvider extends ProviderV3 {
+  /**
+Creates a model for text generation.
+*/
+  (modelId: VercelChatModelId): LanguageModelV3;
+
+  /**
+Creates a language model for text generation.
+*/
+  languageModel(modelId: VercelChatModelId): LanguageModelV3;
+
+  /**
+   * @deprecated Use `embeddingModel` instead.
+   */
+  textEmbeddingModel(modelId: string): never;
+}
+
+export function createVercel(
+  options: VercelProviderSettings = {},
+): VercelProvider {
+  const baseURL = withoutTrailingSlash(
+    options.baseURL ?? 'https://api.v0.dev/v1',
+  );
+  const getHeaders = () =>
+    withUserAgentSuffix(
+      {
+        Authorization: `Bearer ${loadApiKey({
+          apiKey: options.apiKey,
+          environmentVariableName: 'VERCEL_API_KEY',
+          description: 'Vercel',
+        })}`,
+        ...options.headers,
+      },
+      `ai-sdk/vercel/${VERSION}`,
+    );
+
+  interface CommonModelConfig {
+    provider: string;
+    url: ({ path }: { path: string }) => string;
+    headers: () => Record<string, string>;
+    fetch?: FetchFunction;
+  }
+
+  const getCommonModelConfig = (modelType: string): CommonModelConfig => ({
+    provider: `vercel.${modelType}`,
+    url: ({ path }) => `${baseURL}${path}`,
+    headers: getHeaders,
+    fetch: options.fetch,
+  });
+
+  const createChatModel = (modelId: VercelChatModelId) => {
+    return new OpenAICompatibleChatLanguageModel(modelId, {
+      ...getCommonModelConfig('chat'),
+    });
+  };
+
+  const provider = (modelId: VercelChatModelId) => createChatModel(modelId);
+
+  provider.specificationVersion = 'v3' as const;
+  provider.languageModel = createChatModel;
+  provider.embeddingModel = (modelId: string) => {
+    throw new NoSuchModelError({ modelId, modelType: 'embeddingModel' });
+  };
+  provider.textEmbeddingModel = provider.embeddingModel;
+  provider.imageModel = (modelId: string) => {
+    throw new NoSuchModelError({ modelId, modelType: 'imageModel' });
+  };
+
+  return provider;
+}
+
+export const vercel = createVercel();

package/src/version.ts

@@ -0,0 +1,6 @@
+// Version string of this package injected at build time.
+declare const __PACKAGE_VERSION__: string | undefined;
+export const VERSION: string =
+  typeof __PACKAGE_VERSION__ !== 'undefined'
+    ? __PACKAGE_VERSION__
+    : '0.0.0-test';