litellm-api 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,55 @@
+# litellm-api
+
+Auto-generated, fully typed client for the [LiteLLM proxy API](https://docs.litellm.ai/docs/proxy/quick_start).
+
+## Features
+
+- **Fully typed** - every operation, parameter and response is generated from the official OpenAPI spec
+- **Tree-shakable** - only the operations you import end up in your bundle
+- **Runtime agnostic** - uses the global `fetch`, or bring your own implementation
+
+## Installation
+
+```bash
+npm install litellm-api
+```
+
+## Quick Start
+
+LiteLLM is self-hosted, so the client requires the `baseUrl` of your proxy:
+
+```ts
+import { LiteLLMApi } from "litellm-api";
+
+const client = new LiteLLMApi({
+  baseUrl: "http://localhost:4000",
+  token: process.env.LITELLM_MASTER_KEY ?? null,
+});
+
+const usage = await client.api.billing.checkUsageBillingUsageGet();
+```
+
+Operations are grouped by tag: `client.api.<tag>.<operation>(params)`.
+
+### Custom fetch
+
+```ts
+const client = new LiteLLMApi({
+  baseUrl: "http://localhost:4000",
+  token: process.env.LITELLM_MASTER_KEY ?? null,
+  fetch: myFetchImplementation,
+});
+```
+
+## Entrypoints
+
+| Import | Contents |
+| --- | --- |
+| `litellm-api` | client class, operations, schemas and types |
+| `litellm-api/components` | operations grouped by tag and by path |
+| `litellm-api/schemas` | Zod schemas for every operation |
+| `litellm-api/types` | TypeScript types for every operation |
+
+## License
+
+ISC

package/dist/components-e9x5e8kj.js

@@ -0,0 +1,149 @@
+function notEmpty(value) {
+    return value !== null && value !== undefined;
+}
+function compactObject(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, value])=>notEmpty(value)));
+}
+
+async function client({ url, method, body, headers, pathParams, queryParams, signal, baseUrl = "", token = null, fetchImpl = fetch }) {
+    try {
+        const requestHeaders = compactObject({
+            "Content-Type": "application/json",
+            Authorization: token ? `Bearer ${token}` : undefined,
+            ...headers
+        });
+        if (requestHeaders["Content-Type"]?.toLowerCase().includes("multipart/form-data")) {
+            delete requestHeaders["Content-Type"];
+        }
+        const payload = body instanceof FormData ? body : requestHeaders["Content-Type"] === "application/json" ? JSON.stringify(body) : body;
+        const fullUrl = `${baseUrl}${resolveUrl(url, queryParams, pathParams)}`;
+        const response = await fetchImpl(fullUrl, {
+            signal,
+            method: method.toUpperCase(),
+            body: payload,
+            headers: requestHeaders
+        });
+        if (!response.ok) {
+            let error;
+            try {
+                error = await response.json();
+            } catch (e) {
+                error = {
+                    status: "unknown",
+                    payload: e instanceof Error ? `Unexpected error (${e.message})` : "Unexpected error"
+                };
+            }
+            throw error;
+        }
+        if (response.headers?.get("content-type")?.includes("json")) {
+            return await response.json();
+        } else {
+            return await response.text();
+        }
+    } catch (e) {
+        const errorObject = {
+            name: "unknown",
+            message: e instanceof Error ? `Network error (${e.message})` : "Network error",
+            stack: e
+        };
+        throw errorObject;
+    }
+}
+const resolveUrl = (url, queryParams = {}, pathParams = {})=>{
+    let query = new URLSearchParams(queryParams).toString();
+    if (query) query = `?${query}`;
+    return url.replace(/\{\w*\}/g, (key)=>pathParams[key.slice(1, -1)] ?? "") + query;
+};
+
+/**
+ * @summary Create a Stripe Checkout session for API access
+ * @description Returns a Stripe Checkout URL. After payment, you'll receive an API key.
+ * @link /billing/checkout
+ */ async function createCheckoutBillingCheckoutPost({ config } = {}) {
+    const { client: request = client, ...requestConfig } = config ?? {};
+    const data = await request({
+        method: "POST",
+        url: `/billing/checkout`,
+        ...requestConfig,
+        headers: {
+            ...requestConfig.headers
+        }
+    });
+    return data;
+}
+/**
+ * @summary Check your free-tier usage
+ * @description See how many requests you've used today (free tier, by IP).
+ * @link /billing/usage
+ */ async function checkUsageBillingUsageGet({ config } = {}) {
+    const { client: request = client, ...requestConfig } = config ?? {};
+    const data = await request({
+        method: "GET",
+        url: `/billing/usage`,
+        ...requestConfig,
+        headers: {
+            ...requestConfig.headers
+        }
+    });
+    return data;
+}
+/**
+ * @summary List the full LiteLLM model catalog
+ * @description Returns model pricing, context window sizes, and capability metadata from LiteLLM's built-in catalog. Supports filtering by provider, mode, model name pattern, and pagination.
+ * @link /model_catalog
+ */ async function listModelCatalogModelCatalogGet({ queryParams, config } = {}) {
+    const { client: request = client, ...requestConfig } = config ?? {};
+    const data = await request({
+        method: "GET",
+        url: `/model_catalog`,
+        queryParams,
+        ...requestConfig,
+        headers: {
+            ...requestConfig.headers
+        }
+    });
+    return data;
+}
+/**
+ * @summary Get a single model from the catalog
+ * @description Returns detailed information for a specific model by its exact ID.
+ * @link /model_catalog/{model_id}
+ */ async function getModelCatalogEntryModelCatalogModelIdGet({ pathParams, config } = {}) {
+    const { client: request = client, ...requestConfig } = config ?? {};
+    if (!pathParams.model_id) {
+        throw new Error(`Missing required path parameter: model_id`);
+    }
+    const data = await request({
+        method: "GET",
+        url: `/model_catalog/${pathParams.model_id}`,
+        ...requestConfig,
+        headers: {
+            ...requestConfig.headers
+        }
+    });
+    return data;
+}
+const operationsByPath = {
+    "POST /billing/checkout": createCheckoutBillingCheckoutPost,
+    "GET /billing/usage": checkUsageBillingUsageGet,
+    "GET /model_catalog": listModelCatalogModelCatalogGet,
+    "GET /model_catalog/{model_id}": getModelCatalogEntryModelCatalogModelIdGet
+};
+const operationsByTag = {
+    billing: {
+        createCheckoutBillingCheckoutPost,
+        checkUsageBillingUsageGet
+    }
+};
+const tagDictionary = {
+    billing: {
+        POST: [
+            "createCheckoutBillingCheckoutPost"
+        ],
+        GET: [
+            "checkUsageBillingUsageGet"
+        ]
+    }
+};
+
+export { operationsByPath as a, checkUsageBillingUsageGet as b, client as c, createCheckoutBillingCheckoutPost as d, getModelCatalogEntryModelCatalogModelIdGet as g, listModelCatalogModelCatalogGet as l, operationsByTag as o, tagDictionary as t };

package/dist/components-g21ikhwl.cjs

@@ -0,0 +1,156 @@
+function notEmpty(value) {
+    return value !== null && value !== undefined;
+}
+function compactObject(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, value])=>notEmpty(value)));
+}
+
+async function client({ url, method, body, headers, pathParams, queryParams, signal, baseUrl = "", token = null, fetchImpl = fetch }) {
+    try {
+        const requestHeaders = compactObject({
+            "Content-Type": "application/json",
+            Authorization: token ? `Bearer ${token}` : undefined,
+            ...headers
+        });
+        if (requestHeaders["Content-Type"]?.toLowerCase().includes("multipart/form-data")) {
+            delete requestHeaders["Content-Type"];
+        }
+        const payload = body instanceof FormData ? body : requestHeaders["Content-Type"] === "application/json" ? JSON.stringify(body) : body;
+        const fullUrl = `${baseUrl}${resolveUrl(url, queryParams, pathParams)}`;
+        const response = await fetchImpl(fullUrl, {
+            signal,
+            method: method.toUpperCase(),
+            body: payload,
+            headers: requestHeaders
+        });
+        if (!response.ok) {
+            let error;
+            try {
+                error = await response.json();
+            } catch (e) {
+                error = {
+                    status: "unknown",
+                    payload: e instanceof Error ? `Unexpected error (${e.message})` : "Unexpected error"
+                };
+            }
+            throw error;
+        }
+        if (response.headers?.get("content-type")?.includes("json")) {
+            return await response.json();
+        } else {
+            return await response.text();
+        }
+    } catch (e) {
+        const errorObject = {
+            name: "unknown",
+            message: e instanceof Error ? `Network error (${e.message})` : "Network error",
+            stack: e
+        };
+        throw errorObject;
+    }
+}
+const resolveUrl = (url, queryParams = {}, pathParams = {})=>{
+    let query = new URLSearchParams(queryParams).toString();
+    if (query) query = `?${query}`;
+    return url.replace(/\{\w*\}/g, (key)=>pathParams[key.slice(1, -1)] ?? "") + query;
+};
+
+/**
+ * @summary Create a Stripe Checkout session for API access
+ * @description Returns a Stripe Checkout URL. After payment, you'll receive an API key.
+ * @link /billing/checkout
+ */ async function createCheckoutBillingCheckoutPost({ config } = {}) {
+    const { client: request = client, ...requestConfig } = config ?? {};
+    const data = await request({
+        method: "POST",
+        url: `/billing/checkout`,
+        ...requestConfig,
+        headers: {
+            ...requestConfig.headers
+        }
+    });
+    return data;
+}
+/**
+ * @summary Check your free-tier usage
+ * @description See how many requests you've used today (free tier, by IP).
+ * @link /billing/usage
+ */ async function checkUsageBillingUsageGet({ config } = {}) {
+    const { client: request = client, ...requestConfig } = config ?? {};
+    const data = await request({
+        method: "GET",
+        url: `/billing/usage`,
+        ...requestConfig,
+        headers: {
+            ...requestConfig.headers
+        }
+    });
+    return data;
+}
+/**
+ * @summary List the full LiteLLM model catalog
+ * @description Returns model pricing, context window sizes, and capability metadata from LiteLLM's built-in catalog. Supports filtering by provider, mode, model name pattern, and pagination.
+ * @link /model_catalog
+ */ async function listModelCatalogModelCatalogGet({ queryParams, config } = {}) {
+    const { client: request = client, ...requestConfig } = config ?? {};
+    const data = await request({
+        method: "GET",
+        url: `/model_catalog`,
+        queryParams,
+        ...requestConfig,
+        headers: {
+            ...requestConfig.headers
+        }
+    });
+    return data;
+}
+/**
+ * @summary Get a single model from the catalog
+ * @description Returns detailed information for a specific model by its exact ID.
+ * @link /model_catalog/{model_id}
+ */ async function getModelCatalogEntryModelCatalogModelIdGet({ pathParams, config } = {}) {
+    const { client: request = client, ...requestConfig } = config ?? {};
+    if (!pathParams.model_id) {
+        throw new Error(`Missing required path parameter: model_id`);
+    }
+    const data = await request({
+        method: "GET",
+        url: `/model_catalog/${pathParams.model_id}`,
+        ...requestConfig,
+        headers: {
+            ...requestConfig.headers
+        }
+    });
+    return data;
+}
+const operationsByPath = {
+    "POST /billing/checkout": createCheckoutBillingCheckoutPost,
+    "GET /billing/usage": checkUsageBillingUsageGet,
+    "GET /model_catalog": listModelCatalogModelCatalogGet,
+    "GET /model_catalog/{model_id}": getModelCatalogEntryModelCatalogModelIdGet
+};
+const operationsByTag = {
+    billing: {
+        createCheckoutBillingCheckoutPost,
+        checkUsageBillingUsageGet
+    }
+};
+const tagDictionary = {
+    billing: {
+        POST: [
+            "createCheckoutBillingCheckoutPost"
+        ],
+        GET: [
+            "checkUsageBillingUsageGet"
+        ]
+    }
+};
+
+exports.checkUsageBillingUsageGet = checkUsageBillingUsageGet;
+exports.client = client;
+exports.createCheckoutBillingCheckoutPost = createCheckoutBillingCheckoutPost;
+exports.getModelCatalogEntryModelCatalogModelIdGet = getModelCatalogEntryModelCatalogModelIdGet;
+exports.listModelCatalogModelCatalogGet = listModelCatalogModelCatalogGet;
+exports.operationsByPath = operationsByPath;
+exports.operationsByTag = operationsByTag;
+exports.tagDictionary = tagDictionary;

package/dist/components.cjs

@@ -1,157 +1,13 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
-function notEmpty(value) {
-    return value !== null && value !== undefined;
-}
-function compactObject(obj) {
-    return Object.fromEntries(Object.entries(obj).filter(([, value])=>notEmpty(value)));
-}
+var components = require('./components-g21ikhwl.cjs');
 
-async function client({ url, method, body, headers, pathParams, queryParams, signal, baseUrl = "", token = null, fetchImpl = fetch }) {
-    try {
-        const requestHeaders = compactObject({
-            "Content-Type": "application/json",
-            Authorization: token ? `Bearer ${token}` : undefined,
-            ...headers
-        });
-        if (requestHeaders["Content-Type"]?.toLowerCase().includes("multipart/form-data")) {
-            delete requestHeaders["Content-Type"];
-        }
-        const payload = body instanceof FormData ? body : requestHeaders["Content-Type"] === "application/json" ? JSON.stringify(body) : body;
-        const fullUrl = `${baseUrl}${resolveUrl(url, queryParams, pathParams)}`;
-        const response = await fetchImpl(fullUrl, {
-            signal,
-            method: method.toUpperCase(),
-            body: payload,
-            headers: requestHeaders
-        });
-        if (!response.ok) {
-            let error;
-            try {
-                error = await response.json();
-            } catch (e) {
-                error = {
-                    status: "unknown",
-                    payload: e instanceof Error ? `Unexpected error (${e.message})` : "Unexpected error"
-                };
-            }
-            throw error;
-        }
-        if (response.headers?.get("content-type")?.includes("json")) {
-            return await response.json();
-        } else {
-            return await response.text();
-        }
-    } catch (e) {
-        const errorObject = {
-            name: "unknown",
-            message: e instanceof Error ? `Network error (${e.message})` : "Network error",
-            stack: e
-        };
-        throw errorObject;
-    }
-}
-const resolveUrl = (url, queryParams = {}, pathParams = {})=>{
-    let query = new URLSearchParams(queryParams).toString();
-    if (query) query = `?${query}`;
-    return url.replace(/\{\w*\}/g, (key)=>pathParams[key.slice(1, -1)] ?? "") + query;
-};
 
-/**
- * @summary Create a Stripe Checkout session for API access
- * @description Returns a Stripe Checkout URL. After payment, you'll receive an API key.
- * @link /billing/checkout
- */ async function createCheckoutBillingCheckoutPost({ config } = {}) {
-    const { client: request = client, ...requestConfig } = config ?? {};
-    const data = await request({
-        method: "POST",
-        url: `/billing/checkout`,
-        ...requestConfig,
-        headers: {
-            ...requestConfig.headers
-        }
-    });
-    return data;
-}
-/**
- * @summary Check your free-tier usage
- * @description See how many requests you've used today (free tier, by IP).
- * @link /billing/usage
- */ async function checkUsageBillingUsageGet({ config } = {}) {
-    const { client: request = client, ...requestConfig } = config ?? {};
-    const data = await request({
-        method: "GET",
-        url: `/billing/usage`,
-        ...requestConfig,
-        headers: {
-            ...requestConfig.headers
-        }
-    });
-    return data;
-}
-/**
- * @summary List the full LiteLLM model catalog
- * @description Returns model pricing, context window sizes, and capability metadata from LiteLLM's built-in catalog. Supports filtering by provider, mode, model name pattern, and pagination.
- * @link /model_catalog
- */ async function listModelCatalogModelCatalogGet({ queryParams, config } = {}) {
-    const { client: request = client, ...requestConfig } = config ?? {};
-    const data = await request({
-        method: "GET",
-        url: `/model_catalog`,
-        queryParams,
-        ...requestConfig,
-        headers: {
-            ...requestConfig.headers
-        }
-    });
-    return data;
-}
-/**
- * @summary Get a single model from the catalog
- * @description Returns detailed information for a specific model by its exact ID.
- * @link /model_catalog/{model_id}
- */ async function getModelCatalogEntryModelCatalogModelIdGet({ pathParams, config } = {}) {
-    const { client: request = client, ...requestConfig } = config ?? {};
-    if (!pathParams.model_id) {
-        throw new Error(`Missing required path parameter: model_id`);
-    }
-    const data = await request({
-        method: "GET",
-        url: `/model_catalog/${pathParams.model_id}`,
-        ...requestConfig,
-        headers: {
-            ...requestConfig.headers
-        }
-    });
-    return data;
-}
-const operationsByPath = {
-    "POST /billing/checkout": createCheckoutBillingCheckoutPost,
-    "GET /billing/usage": checkUsageBillingUsageGet,
-    "GET /model_catalog": listModelCatalogModelCatalogGet,
-    "GET /model_catalog/{model_id}": getModelCatalogEntryModelCatalogModelIdGet
-};
-const operationsByTag = {
-    "billing": {
-        createCheckoutBillingCheckoutPost,
-        checkUsageBillingUsageGet
-    }
-};
-const tagDictionary = {
-    "billing": {
-        "POST": [
-            "createCheckoutBillingCheckoutPost"
-        ],
-        "GET": [
-            "checkUsageBillingUsageGet"
-        ]
-    }
-};
 
-exports.checkUsageBillingUsageGet = checkUsageBillingUsageGet;
-exports.createCheckoutBillingCheckoutPost = createCheckoutBillingCheckoutPost;
-exports.getModelCatalogEntryModelCatalogModelIdGet = getModelCatalogEntryModelCatalogModelIdGet;
-exports.listModelCatalogModelCatalogGet = listModelCatalogModelCatalogGet;
-exports.operationsByPath = operationsByPath;
-exports.operationsByTag = operationsByTag;
-exports.tagDictionary = tagDictionary;
+exports.checkUsageBillingUsageGet = components.checkUsageBillingUsageGet;
+exports.createCheckoutBillingCheckoutPost = components.createCheckoutBillingCheckoutPost;
+exports.getModelCatalogEntryModelCatalogModelIdGet = components.getModelCatalogEntryModelCatalogModelIdGet;
+exports.listModelCatalogModelCatalogGet = components.listModelCatalogModelCatalogGet;
+exports.operationsByPath = components.operationsByPath;
+exports.operationsByTag = components.operationsByTag;
+exports.tagDictionary = components.tagDictionary;