From dd5d56aa3db92f53f9f687cf1649560ab0956b3d Mon Sep 17 00:00:00 2001
From: VIVEK PATEL <patelvk2000@gmail.com>
Date: Tue, 19 Nov 2024 02:00:20 -0500
Subject: [PATCH] Init

---
 .changeset/README.md               |   8 ++
 .changeset/config.json             |  11 +++
 .gitignore                         |  14 ++++
 .npmrc                             |   2 +
 .prettierrc                        |   7 ++
 CHANGELOG.md                       |   7 ++
 LICENSE.md                         |  11 +++
 bun.lockb                          | Bin 0 -> 111787 bytes
 package.json                       |  78 +++++++++++++++++
 readme.md                          |  83 ++++++++++++++++++
 src/index.ts                       |   2 +
 src/voyage-embedding-model.test.ts | 130 +++++++++++++++++++++++++++++
 src/voyage-embedding-model.ts      | 102 ++++++++++++++++++++++
 src/voyage-embedding-settings.ts   |  38 +++++++++
 src/voyage-error.ts                |  18 ++++
 src/voyage-provider.ts             | 128 ++++++++++++++++++++++++++++
 tsconfig.json                      |  29 +++++++
 tsup.config.ts                     |  11 +++
 vitest.edge.config.js              |  12 +++
 vitest.node.config.js              |  12 +++
 20 files changed, 703 insertions(+)
 create mode 100644 .changeset/README.md
 create mode 100644 .changeset/config.json
 create mode 100644 .gitignore
 create mode 100644 .npmrc
 create mode 100644 .prettierrc
 create mode 100644 CHANGELOG.md
 create mode 100644 LICENSE.md
 create mode 100644 bun.lockb
 create mode 100644 package.json
 create mode 100644 readme.md
 create mode 100644 src/index.ts
 create mode 100644 src/voyage-embedding-model.test.ts
 create mode 100644 src/voyage-embedding-model.ts
 create mode 100644 src/voyage-embedding-settings.ts
 create mode 100644 src/voyage-error.ts
 create mode 100644 src/voyage-provider.ts
 create mode 100644 tsconfig.json
 create mode 100644 tsup.config.ts
 create mode 100644 vitest.edge.config.js
 create mode 100644 vitest.node.config.js

diff --git a/.changeset/README.md b/.changeset/README.md
new file mode 100644
index 0000000..e5b6d8d
--- /dev/null
+++ b/.changeset/README.md
@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)
diff --git a/.changeset/config.json b/.changeset/config.json
new file mode 100644
index 0000000..5b42be8
--- /dev/null
+++ b/.changeset/config.json
@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.3/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": true,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "master",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..84c1263
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,14 @@
+.DS_Store
+node_modules
+.turbo
+*.log
+.next
+dist
+dist-ssr
+*.local
+.env
+.cache
+server/dist
+public/dist
+.turbo
+test-results
\ No newline at end of file
diff --git a/.npmrc b/.npmrc
new file mode 100644
index 0000000..60ddfd0
--- /dev/null
+++ b/.npmrc
@@ -0,0 +1,2 @@
+auto-install-peers = true
+strict-peer-dependencies = false
diff --git a/.prettierrc b/.prettierrc
new file mode 100644
index 0000000..c9ae50d
--- /dev/null
+++ b/.prettierrc
@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 80,
+  "tabWidth": 2
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..dfe5686
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,7 @@
+# voyage-ai-provider
+
+## 0.0.1
+
+### Patch Changes
+
+- First public release
diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 0000000..51fca54
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,11 @@
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
diff --git a/bun.lockb b/bun.lockb
new file mode 100644
index 0000000000000000000000000000000000000000..f8c2a9a1478497eff0043e7e77f2acee596a259d
GIT binary patch
literal 111787
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
H|M25K`tL`l

literal 0
HcmV?d00001

diff --git a/package.json b/package.json
new file mode 100644
index 0000000..9701207
--- /dev/null
+++ b/package.json
@@ -0,0 +1,78 @@
+{
+  "name": "voyage-ai-provider",
+  "version": "0.0.1",
+  "description": "Voyage AI Provider for running Voyage AI models with Vercel AI SDK",
+  "author": "Vivek Patel <me@patelvivek.dev>",
+  "license": "Apache-2.0",
+  "keywords": [
+    "ai",
+    "vercel-ai",
+    "voyage",
+    "embeddings"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-exports": "attw --pack .",
+    "dev": "tsup --watch",
+    "lint": "eslint \"./**/*.ts*\"",
+    "type-check": "tsc --noEmit",
+    "format": "prettier --write .",
+    "check-format": "prettier --check .",
+    "test": "bun test:node && bun test:edge",
+    "test:edge": "vitest --config vitest.edge.config.js --run",
+    "test:node": "vitest --config vitest.node.config.js --run",
+    "ci": "bun run build && bun run check-format && bun run test",
+    "local-release": "changeset version && changeset publish",
+    "prepublishOnly": "npm run ci"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@ai-sdk/provider": "^1.0.0",
+    "@ai-sdk/provider-utils": "^2.0.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.9",
+    "@edge-runtime/vm": "^3.2.0",
+    "@types/node": "^18.19.64",
+    "prettier": "^3.3.3",
+    "tsup": "^8.3.5",
+    "typescript": "5.5.4",
+    "vite-tsconfig-paths": "^4.3.2",
+    "vitest": "^2.1.5",
+    "zod": "^3.23.8"
+  },
+  "peerDependencies": {
+    "zod": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/patelvivekdev/voyage-ai-provider",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/patelvivekdev/voyage-ai-provider.git"
+  },
+  "bugs": {
+    "url": "https://github.com/patelvivekdev/voyage-ai-provider/issues"
+  }
+}
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..2173da6
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,83 @@
+# AI SDK - Voyage AI Provider
+
+## Introduction
+
+The Voyage AI Provider is a provider for the AI SDK. It provides a simple interface to the Voyage AI API.
+
+## Installation
+
+```bash
+npm install voyage-ai-provider
+
+# or
+
+yarn add voyage-ai-provider
+
+# or
+
+pnpm add voyage-ai-provider
+
+# or
+
+bun add voyage-ai-provider
+```
+
+## Configuration
+
+The Voyage AI Provider requires an API key to be configured. You can obtain an API key by signing up at [Voyage](https://voyageai.com).
+
+add the following to your `.env` file:
+
+```bash
+VOYAGE_API_KEY=your-api-key
+```
+
+## Usage
+
+```typescript
+import { voyage } from 'voyage-ai-provider';
+import { embedMany } from 'ai';
+
+const embeddingModel = voyage.textEmbeddingModel('voyage-3-lite');
+
+export const generateEmbeddings = async (
+  value: string,
+): Promise<Array<{ embedding: number[]; content: string }>> => {
+  // Generate chunks from the input value
+  const chunks = value.split('\n');
+
+  // Optional: You can also split the input value by comma
+  // const chunks = value.split('.');
+
+  // Or you can use LLM to generate chunks(summarize) from the input value
+
+  const { embeddings } = await embedMany({
+    model: embeddingModel,
+    values: chunks,
+  });
+  return embeddings.map((e, i) => ({ content: chunks[i], embedding: e }));
+};
+```
+
+### Add settings to the model
+
+The settings object should contain the settings you want to add to the model. You can find the available settings for the model in the Voyage API documentation: https://docs.voyageai.com/reference/embeddings-api
+
+```typescript
+const voyage = createVoyage({
+  apiKey: process.env.VOYAGE_API_KEY,
+});
+
+// Initialize the embedding model
+const embeddingModel = voyage.textEmbeddingModel(
+  'voyage-3-lite',
+  // adding settings
+  {
+    inputType: 'document',
+  },
+);
+```
+
+## Authors
+
+- [patelvivekdev](https://patelvivek.dev)
diff --git a/src/index.ts b/src/index.ts
new file mode 100644
index 0000000..41f2a26
--- /dev/null
+++ b/src/index.ts
@@ -0,0 +1,2 @@
+export { createVoyage, voyage } from './voyage-provider';
+export type { VoyageProvider, VoyageProviderSettings } from './voyage-provider';
diff --git a/src/voyage-embedding-model.test.ts b/src/voyage-embedding-model.test.ts
new file mode 100644
index 0000000..b1cce88
--- /dev/null
+++ b/src/voyage-embedding-model.test.ts
@@ -0,0 +1,130 @@
+import { EmbeddingModelV1Embedding } from '@ai-sdk/provider';
+import { JsonTestServer } from '@ai-sdk/provider-utils/test';
+import { createVoyage } from './voyage-provider';
+
+const dummyEmbeddings = [
+  [0.1, 0.2, 0.3, 0.4, 0.5],
+  [0.6, 0.7, 0.8, 0.9, 1],
+];
+const testValues = ['sunny day at the beach', 'rainy day in the city'];
+
+const provider = createVoyage({
+  baseURL: 'https://api.voyage.ai/v1',
+  apiKey: 'test-api-key',
+});
+const model = provider('voyage-3-lite');
+
+describe('doEmbed', () => {
+  const server = new JsonTestServer('https://api.voyage.ai/v1/embeddings');
+
+  server.setupTestEnvironment();
+
+  function prepareJsonResponse({
+    embeddings = dummyEmbeddings,
+    usage = {
+      prompt_tokens: 4,
+      total_tokens: 12,
+    },
+  }: {
+    embeddings?: EmbeddingModelV1Embedding[];
+    usage?: { prompt_tokens: number; total_tokens: number };
+  } = {}) {
+    server.responseBodyJson = {
+      object: 'list',
+      data: embeddings.map((embedding, i) => ({
+        object: 'embedding',
+        embedding,
+        index: i,
+      })),
+      model: 'voyage-3-lite',
+      normalized: true,
+      encoding_format: 'float',
+      usage,
+    };
+  }
+
+  it('should extract embedding', async () => {
+    prepareJsonResponse();
+
+    const { embeddings } = await model.doEmbed({ values: testValues });
+
+    expect(embeddings).toStrictEqual(dummyEmbeddings);
+  });
+
+  it('should expose the raw response headers', async () => {
+    prepareJsonResponse();
+
+    server.responseHeaders = {
+      'test-header': 'test-value',
+    };
+
+    const { rawResponse } = await model.doEmbed({ values: testValues });
+
+    expect(rawResponse?.headers).toStrictEqual({
+      'content-length': '272',
+      // default headers:
+      'content-type': 'application/json',
+
+      // custom header
+      'test-header': 'test-value',
+    });
+  });
+
+  it('should pass the model and the values', async () => {
+    prepareJsonResponse();
+
+    await model.doEmbed({ values: testValues });
+
+    expect(await server.getRequestBodyJson()).toStrictEqual({
+      input: testValues,
+      model: 'voyage-3-lite',
+    });
+  });
+
+  it('should pass the settings ', async () => {
+    prepareJsonResponse();
+
+    const voyage = createVoyage({
+      baseURL: 'https://api.voyage.ai/v1',
+      apiKey: 'test-api-key',
+    });
+
+    await voyage
+      .textEmbeddingModel('voyage-3-lite', {
+        inputType: 'document',
+      })
+      .doEmbed({
+        values: testValues,
+      });
+
+    expect(await server.getRequestBodyJson()).toStrictEqual({
+      input: testValues,
+      model: 'voyage-3-lite',
+      input_type: 'document',
+    });
+  });
+
+  it('should pass custom headers', async () => {
+    prepareJsonResponse();
+
+    const voyage = createVoyage({
+      baseURL: 'https://api.voyage.ai/v1',
+      apiKey: 'test-api-key',
+      headers: {
+        'Custom-Header': 'test-header',
+      },
+    });
+
+    await voyage.textEmbeddingModel('voyage-3-lite').doEmbed({
+      values: testValues,
+    });
+
+    const requestHeaders = await server.getRequestHeaders();
+
+    expect(requestHeaders).toStrictEqual({
+      authorization: 'Bearer test-api-key',
+      'content-type': 'application/json',
+      'custom-header': 'test-header',
+    });
+  });
+});
diff --git a/src/voyage-embedding-model.ts b/src/voyage-embedding-model.ts
new file mode 100644
index 0000000..72a5c87
--- /dev/null
+++ b/src/voyage-embedding-model.ts
@@ -0,0 +1,102 @@
+import {
+  EmbeddingModelV1,
+  TooManyEmbeddingValuesForCallError,
+} from '@ai-sdk/provider';
+import {
+  createJsonResponseHandler,
+  postJsonToApi,
+} from '@ai-sdk/provider-utils';
+import { z } from 'zod';
+
+import {
+  VoyageEmbeddingModelId,
+  VoyageEmbeddingSettings,
+} from '@/voyage-embedding-settings';
+import { voyageFailedResponseHandler } from '@/voyage-error';
+import { encode } from 'punycode';
+
+type VoyageEmbeddingConfig = {
+  baseURL: string;
+  fetch?: typeof fetch;
+  headers: () => Record<string, string | undefined>;
+  provider: string;
+};
+
+export class VoyageEmbeddingModel implements EmbeddingModelV1<string> {
+  readonly specificationVersion = 'v1';
+  readonly modelId: VoyageEmbeddingModelId;
+
+  private readonly config: VoyageEmbeddingConfig;
+  private readonly settings: VoyageEmbeddingSettings;
+
+  get provider(): string {
+    return this.config.provider;
+  }
+
+  get maxEmbeddingsPerCall(): number {
+    return 128;
+  }
+
+  get supportsParallelCalls(): boolean {
+    return false;
+  }
+
+  constructor(
+    modelId: VoyageEmbeddingModelId,
+    settings: VoyageEmbeddingSettings,
+    config: VoyageEmbeddingConfig,
+  ) {
+    this.modelId = modelId;
+    this.settings = settings;
+    this.config = config;
+  }
+
+  async doEmbed({
+    abortSignal,
+    values,
+  }: Parameters<EmbeddingModelV1<string>['doEmbed']>[0]): Promise<
+    Awaited<ReturnType<EmbeddingModelV1<string>['doEmbed']>>
+  > {
+    if (values.length > this.maxEmbeddingsPerCall) {
+      throw new TooManyEmbeddingValuesForCallError({
+        maxEmbeddingsPerCall: this.maxEmbeddingsPerCall,
+        modelId: this.modelId,
+        provider: this.provider,
+        values,
+      });
+    }
+
+    const { responseHeaders, value: response } = await postJsonToApi({
+      abortSignal,
+      body: {
+        input: values,
+        model: this.modelId,
+        input_type: this.settings.inputType,
+        encoding_format: this.settings.encodingFormat,
+        truncation: this.settings.truncation,
+      },
+      failedResponseHandler: voyageFailedResponseHandler,
+      fetch: this.config.fetch,
+      headers: this.config.headers(),
+      successfulResponseHandler: createJsonResponseHandler(
+        voyageTextEmbeddingResponseSchema,
+      ),
+      url: `${this.config.baseURL}/embeddings`,
+    });
+
+    return {
+      embeddings: response.data.map((item) => item.embedding),
+      usage: response.usage
+        ? { tokens: response.usage.total_tokens }
+        : undefined,
+      rawResponse: { headers: responseHeaders },
+    };
+  }
+}
+
+// minimal version of the schema, focussed on what is needed for the implementation
+// this approach limits breakages when the API changes and increases efficiency
+const voyageTextEmbeddingResponseSchema = z.object({
+  data: z.array(z.object({ embedding: z.array(z.number()) })),
+  usage: z.object({ total_tokens: z.number() }).nullish(),
+});
diff --git a/src/voyage-embedding-settings.ts b/src/voyage-embedding-settings.ts
new file mode 100644
index 0000000..624d6af
--- /dev/null
+++ b/src/voyage-embedding-settings.ts
@@ -0,0 +1,38 @@
+export type VoyageEmbeddingModelId =
+  | 'voyage-3'
+  | 'voyage-3-lite'
+  | 'voyage-finance-2'
+  | 'voyage-multilingual-2'
+  | 'voyage-law-2'
+  | 'voyage-code-2'
+
+  // Older models
+  | 'voyage-large-2-instruct'
+  | 'voyage-large-2'
+  | 'voyage-2'
+  | 'voyage-02'
+  | 'voyage-01'
+  | 'voyage-lite-01'
+  | (string & NonNullable<unknown>);
+
+export interface VoyageEmbeddingSettings {
+  /**
+   * The input type for the embeddings. Defaults to "query".
+   * For query, the prompt is "Represent the query for retrieving supporting documents: ".
+   * For document, the prompt is "Represent the document for retrieval: ".
+   */
+
+  inputType?: 'query' | 'document';
+
+  /**
+   * Format in which the embeddings are encoded. We support two options:
+   * If not specified (defaults to null): the embeddings are represented as lists of floating-point numbers;
+   * base64: the embeddings are compressed to base64 encodings.
+   */
+  encodingFormat?: 'base64';
+
+  /**
+   *  Whether to truncate the input texts to fit within the context length.
+   */
+  truncation?: boolean;
+}
diff --git a/src/voyage-error.ts b/src/voyage-error.ts
new file mode 100644
index 0000000..b880cbb
--- /dev/null
+++ b/src/voyage-error.ts
@@ -0,0 +1,18 @@
+import { createJsonErrorResponseHandler } from '@ai-sdk/provider-utils';
+import { z } from 'zod';
+
+const voyageErrorDataSchema = z.object({
+  error: z.object({
+    code: z.string().nullable(),
+    message: z.string(),
+    param: z.any().nullable(),
+    type: z.string(),
+  }),
+});
+
+export type VoyageErrorData = z.infer<typeof voyageErrorDataSchema>;
+
+export const voyageFailedResponseHandler = createJsonErrorResponseHandler({
+  errorSchema: voyageErrorDataSchema,
+  errorToMessage: (data) => data.error.message,
+});
diff --git a/src/voyage-provider.ts b/src/voyage-provider.ts
new file mode 100644
index 0000000..327d0bc
--- /dev/null
+++ b/src/voyage-provider.ts
@@ -0,0 +1,128 @@
+import {
+  EmbeddingModelV1,
+  LanguageModelV1,
+  ProviderV1,
+} from '@ai-sdk/provider';
+import {
+  FetchFunction,
+  loadApiKey,
+  withoutTrailingSlash,
+} from '@ai-sdk/provider-utils';
+import { VoyageEmbeddingModel } from './voyage-embedding-model';
+import {
+  VoyageEmbeddingModelId,
+  VoyageEmbeddingSettings,
+} from './voyage-embedding-settings';
+
+export interface VoyageProvider extends ProviderV1 {
+  (
+    modelId: VoyageEmbeddingModelId,
+    settings?: VoyageEmbeddingSettings,
+  ): EmbeddingModelV1<string>;
+
+  /**
+  @deprecated Use `textEmbeddingModel()` instead.
+     */
+  embedding(
+    modelId: VoyageEmbeddingModelId,
+    settings?: VoyageEmbeddingSettings,
+  ): EmbeddingModelV1<string>;
+
+  /**
+  @deprecated Use `textEmbeddingModel()` instead.
+     */
+  textEmbedding(
+    modelId: VoyageEmbeddingModelId,
+    settings?: VoyageEmbeddingSettings,
+  ): EmbeddingModelV1<string>;
+
+  textEmbeddingModel: (
+    modelId: VoyageEmbeddingModelId,
+    settings?: VoyageEmbeddingSettings,
+  ) => EmbeddingModelV1<string>;
+}
+
+export interface VoyageProviderSettings {
+  /**
+  Use a different URL prefix for API calls, e.g. to use proxy servers.
+  The default prefix is `https://api.voyageai.com/v1`.
+     */
+  baseURL?: string;
+
+  /**
+  API key that is being send using the `Authorization` header.
+  It defaults to the `VOYAGE_API_KEY` environment variable.
+     */
+  apiKey?: 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;
+}
+
+/**
+  Create a Voyage AI provider instance.
+   */
+export function createVoyage(
+  options: VoyageProviderSettings = {},
+): VoyageProvider {
+  const baseURL =
+    withoutTrailingSlash(options.baseURL) ?? 'https://api.voyageai.com/v1';
+
+  const getHeaders = () => ({
+    Authorization: `Bearer ${loadApiKey({
+      apiKey: options.apiKey,
+      environmentVariableName: 'VOYAGE_API_KEY',
+      description: 'Voyage',
+    })}`,
+    ...options.headers,
+  });
+
+  const createEmbeddingModel = (
+    modelId: VoyageEmbeddingModelId,
+    settings: VoyageEmbeddingSettings = {},
+  ) =>
+    new VoyageEmbeddingModel(modelId, settings, {
+      provider: 'voyage.embedding',
+      baseURL,
+      headers: getHeaders,
+      fetch: options.fetch,
+    });
+
+  const provider = function (
+    modelId: VoyageEmbeddingModelId,
+    settings?: VoyageEmbeddingSettings,
+  ) {
+    if (new.target) {
+      throw new Error(
+        'The Voyage model function cannot be called with the new keyword.',
+      );
+    }
+
+    return createEmbeddingModel(modelId, settings);
+  };
+
+  provider.embedding = createEmbeddingModel;
+  provider.textEmbedding = createEmbeddingModel;
+  provider.textEmbeddingModel = createEmbeddingModel;
+
+  provider.chat = provider.languageModel = (
+    modelId: string,
+  ): LanguageModelV1 => {
+    throw new Error('languageModel method is not implemented.');
+  };
+
+  return provider as VoyageProvider;
+}
+
+/**
+  Default Voyage provider instance.
+   */
+export const voyage = createVoyage();
diff --git a/tsconfig.json b/tsconfig.json
new file mode 100644
index 0000000..afc64e8
--- /dev/null
+++ b/tsconfig.json
@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "composite": false,
+    "declaration": true,
+    "declarationMap": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "inlineSources": false,
+    "isolatedModules": true,
+    "moduleResolution": "node",
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "preserveWatchOutput": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "types": ["@types/node", "vitest/globals"],
+    "jsx": "react-jsx",
+    "lib": ["dom", "ES2021"],
+    "module": "ESNext",
+    "target": "ES2018",
+    "stripInternal": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["."],
+  "exclude": ["dist", "build", "node_modules"]
+}
diff --git a/tsup.config.ts b/tsup.config.ts
new file mode 100644
index 0000000..fa5392f
--- /dev/null
+++ b/tsup.config.ts
@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig([
+  {
+    entry: ['src/index.ts'],
+    format: ['cjs', 'esm'],
+    dts: true,
+    sourcemap: true,
+    clean: true,
+  },
+]);
diff --git a/vitest.edge.config.js b/vitest.edge.config.js
new file mode 100644
index 0000000..9c43c68
--- /dev/null
+++ b/vitest.edge.config.js
@@ -0,0 +1,12 @@
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [tsconfigPaths()],
+  test: {
+    environment: 'edge-runtime',
+    globals: true,
+    include: ['**/*.test.ts', '**/*.test.tsx'],
+  },
+});
diff --git a/vitest.node.config.js b/vitest.node.config.js
new file mode 100644
index 0000000..585f6b1
--- /dev/null
+++ b/vitest.node.config.js
@@ -0,0 +1,12 @@
+import tsconfigPaths from 'vite-tsconfig-paths';
+import { defineConfig } from 'vitest/config';
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [tsconfigPaths()],
+  test: {
+    environment: 'node',
+    globals: true,
+    include: ['**/*.test.ts', '**/*.test.tsx'],
+  },
+});