![\"CallApi](\"https://raw.githubusercontent.com/zayne-labs/callapi/refs/heads/main/apps/docs/public/logo.png\"){kind=logo}
\n\n \n
\n \n ![\"npm](\"https://img.shields.io/npm/v/@zayne-labs/callapi?style=flat&color=EFBA5F\")
![\"license\"](\"https://img.shields.io/npm/l/@zayne-labs/callapi?style=flat&color=EFBA5F\")
![\"downloads](\"https://img.shields.io/npm/dm/@zayne-labs/callapi?style=flat&color=EFBA5F\")
![\"commit](\"https://img.shields.io/github/commit-activity/m/zayne-labs/callapi?style=flat&color=EFBA5F\")
![\"Ask](\"https://deepwiki.com/badge.svg\"){kind=icon}
\n
\n An advanced fetch library that solves real problems.\n
\n\n\n Documentation ·\n Getting Started ·\n Plugins\n
\n\n---\n\n## Why CallApi?\n\nFetch is too basic for real apps. You end up writing the same boilerplate: error handling, retries, deduplication, response parsing etc. CallApi handles all of that and practically more.\n\n**Fetch-style API. ~7KB. All kinds of convenience features. Zero dependencies.**\n\n```js\nimport { callApi } from \"@zayne-labs/callapi\";\n\nconst { data, error } = await callApi(\"/api/users\");\n```\n\n## Features\n\n### Request Deduplication\n\nUser spam-clicks a button? Handled. No race conditions.\n\n```js\nconst req1 = callApi(\"/api/user\");\nconst req2 = callApi(\"/api/user\"); // Cancels req1 (can be configured to share its response instead)\n```\n\n### Smart Response Parsing\n\nLooks at Content-Type and parses accordingly.\n\n```js\nconst { data } = await callApi(\"/api/data\"); // JSON? Parsed.\n```\n\n### Error Handling\n\nErrors are returned, not thrown, so every failure is handled in one place.\n\n```js\nimport { isHTTPError, isValidationError } from \"@zayne-labs/callapi/utils\";\n\nconst { data, error } = await callApi(\"/api/users\");\n\nif (isHTTPError(error)) {\n\tconsole.log(error.errorData); // The API's error response body\n}\n\nif (isValidationError(error)) {\n\tconsole.log(error.errorData); // The schema validation issues\n}\n```\n\nPrefer try/catch? Set `throwOnError: true`.\n\n### Retries\n\nSupports exponential backoff and custom retry conditions.\n\n```js\nawait callApi(\"/api/data\", {\n\tretryAttempts: 3,\n\tretryStrategy: \"exponential\",\n\tretryStatusCodes: [429, 500, 502, 503],\n});\n```\n\n### Schema Validation\n\nTypeScript-first types with runtime validation.\n\n```ts\nimport { createFetchClient } from \"@zayne-labs/callapi\";\nimport { defineSchema } from \"@zayne-labs/callapi/utils\";\nimport { z } from \"zod\";\n\nconst callMainApi = createFetchClient({\n\tschema: defineSchema({\n\t\t\"/users/:id\": {\n\t\t\tdata: z.object({\n\t\t\t\tid: z.number(),\n\t\t\t\tname: z.string(),\n\t\t\t}),\n\t\t},\n\t}),\n});\n\n// Fully typed + validated\nconst { data: user, error } = await callMainApi(\"/users/:id\", {\n\tparams: { id: 123 },\n});\n\nif (!error) {\n\tuser.name; // string\n}\n```\n\n### Hooks\n\nHook into CallApi's lifecycle at any point.\n\n```js\nconst api = createFetchClient({\n\tonRequest: ({ request }) => {\n\t\trequest.headers.Authorization = `Bearer ${token}`;\n\t},\n\tonError: ({ error }) => {\n\t\tSentry.captureException(error);\n\t},\n\tonResponseStream: ({ event }) => {\n\t\tconsole.log(`Downloaded ${event.progress}%`);\n\t},\n});\n```\n\n### Plugins\n\nExtend functionality with setup, hooks, and middleware.\n\n```ts\nimport { createFetchClient, type GetCallApiContext } from \"@zayne-labs/callapi\";\nimport { definePluginWithContext } from \"@zayne-labs/callapi/utils\";\n\n// Types the metadata this plugin reads and writes\ntype MetricsContext = GetCallApiContext<{ Meta: { startTime?: number } }>;\n\nconst metricsPlugin = definePluginWithContext