@svazqz/api-contract-kit 0.1.6-alpha

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 Sergio Vazquez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,448 @@
+# api-contract-kit
+
+`api-contract-kit` is a TypeScript-first library for defining HTTP APIs once and reusing that definition across:
+
+- server handlers
+- client consumers
+- OpenAPI generation
+
+The library is now framework-agnostic at its core, with adapter layers for multiple server frameworks.
+
+## Migration Notice
+
+This package was renamed from `@svazqz/next-api-generator` to `@svazqz/api-contract-kit`.
+
+Replace imports and installation commands to use the new package name.
+
+## Why this library exists
+
+Many projects duplicate API contracts in multiple places:
+
+- route handlers
+- frontend consumers
+- OpenAPI specs
+- runtime validation code
+
+This library removes that duplication by making your endpoint definition the source of truth.
+
+## Design Principles
+
+1. **Contract-first development**
+   - Define method/path/schemas before implementing business logic.
+2. **Framework-agnostic core**
+   - Build around standard `Request`/`Response` so the same contract works in Node and Edge runtimes.
+3. **Runtime validation with Zod**
+   - Validate query/body/output at runtime, while keeping full static inference in TypeScript.
+4. **Pluggable transport format**
+   - JSON is the default codec, but request/response encoding is extensible.
+5. **Optional integrations**
+   - React Query integration is available, but not required.
+6. **Documentation automation**
+   - OpenAPI metadata is generated from the same endpoint definitions used at runtime.
+
+## Capabilities
+
+### API Definition
+
+- Define endpoint path and method.
+- Attach Zod schemas for:
+  - URL params
+  - query params
+  - payload/body
+  - response/output
+- Add OpenAPI metadata:
+  - summary
+  - description
+  - tags
+  - operationId
+  - deprecated
+  - security requirements
+  - custom responses
+- Attach auth function and custom error mapping.
+- Attach custom codec for non-JSON protocols.
+
+### Server Runtime
+
+- Framework-agnostic wrapper built on Fetch `Request`/`Response`.
+- Default validation flow:
+  - URL params
+  - query params
+  - payload
+  - handler execution
+  - optional response validation
+- Structured error handling through an overridable `errorMapper`.
+- Auth handling through an overridable `auth(request)` function.
+- Default JSON response encoding, with codec support for custom formats.
+
+### Client Runtime
+
+- Framework-agnostic typed client (`createClient` and `apiConsumer`).
+- Supports:
+  - typed params/query/body payloads
+  - request headers
+  - `AbortSignal`
+  - configurable fetch implementation
+  - optional dynamic headers provider
+- Optional React Query adapter shipped as a separate module.
+
+### OpenAPI
+
+- Generates OpenAPI definitions from endpoint contracts.
+- Supports operation metadata and response customization.
+- CLI-oriented workflow intended for CI/CD pipelines.
+- Produces static OpenAPI JSON suitable for artifact publishing and static docs hosting.
+
+## Runtime & Framework Support
+
+### Core Runtime
+
+The core is Fetch-based (`Request`/`Response`) to support both:
+
+- **Node runtimes**
+- **Edge-compatible runtimes**
+
+### Server Adapters
+
+First-party adapters are available in the server module:
+
+- `nextAdapter`
+- `expressAdapter`
+- `fastifyAdapter`
+- `honoAdapter`
+- `nestAdapter` (via Express-style adapter strategy)
+
+You can also use `apiWrapper` directly when your runtime already speaks Fetch.
+
+## Installation
+
+```bash
+npm install @svazqz/api-contract-kit zod @asteasolutions/zod-to-openapi
+```
+
+If you want React Query integration:
+
+```bash
+npm install @tanstack/react-query
+```
+
+## Package Entry Points
+
+- `@svazqz/api-contract-kit/dist/api-contract-kit`
+- `@svazqz/api-contract-kit/dist/server`
+- `@svazqz/api-contract-kit/dist/client`
+- `@svazqz/api-contract-kit/dist/react-query` (optional integration)
+
+## Core Types and Architecture Decisions
+
+### `ServerFnDefinition`
+
+This is the central contract type. It contains endpoint information, runtime behavior hooks, validation schemas, and OpenAPI metadata.
+
+Architectural decision:
+
+- keep one definition object as the single source of truth
+- prevent drift between implementation, client code, and docs
+
+### `HandlerFn`
+
+Handler functions are typed from your schemas. This gives strongly typed payload/query/params inside your business logic.
+
+Architectural decision:
+
+- infer types from Zod schemas to avoid parallel interface maintenance
+
+### `ApiCodec`
+
+A codec defines how request bodies are decoded and response bodies are encoded.
+
+Architectural decision:
+
+- default to JSON for usability
+- keep protocol support open for future formats (for example protobuf)
+
+### `ErrorMapper`
+
+Error mapping is centralized and overridable.
+
+Architectural decision:
+
+- provide sensible defaults
+- let applications align API error shape/status with their platform standards
+
+## Quick Start
+
+### 1) Define schemas
+
+```typescript
+import { z } from 'zod';
+import { extendZodWithOpenApi } from '@asteasolutions/zod-to-openapi';
+
+extendZodWithOpenApi(z);
+
+export const Coordinates = z
+  .object({
+    latitude: z.number(),
+    longitude: z.number(),
+  })
+  .openapi('Coordinates');
+
+export const LocationData = z
+  .object({
+    city: z.string(),
+    state: z.string(),
+    country: z.string(),
+  })
+  .openapi('LocationData');
+```
+
+### 2) Define endpoints
+
+```typescript
+import { createAPIDefinition } from '@svazqz/api-contract-kit/dist/api-contract-kit';
+import { Coordinates, LocationData } from './schemas';
+
+export const getGeoData = createAPIDefinition({
+  method: 'get',
+  path: '/geo',
+  schemas: {
+    queryParams: Coordinates,
+    response: LocationData,
+  },
+  openapi: {
+    summary: 'Get geo data',
+    description: 'Returns city/state/country from coordinates',
+    tags: ['geo'],
+    operationId: 'getGeoData',
+  },
+});
+
+export const postGeoData = createAPIDefinition({
+  method: 'post',
+  path: '/geo',
+  schemas: {
+    payload: Coordinates,
+    response: LocationData,
+  },
+  openapi: {
+    summary: 'Create geo lookup',
+    tags: ['geo'],
+    operationId: 'postGeoData',
+  },
+});
+```
+
+### 3) Implement server handlers
+
+#### Next.js App Router
+
+```typescript
+import { nextAdapter } from '@svazqz/api-contract-kit/dist/server';
+import { getGeoData, postGeoData } from './api-definitions';
+
+export const GET = nextAdapter(getGeoData, async (_request, query) => {
+  const lat = query?.latitude;
+  const lon = query?.longitude;
+  const response = await fetch(`https://geocode.xyz/${lat},${lon}?json=1`);
+  const json = await response.json();
+  const full = json.standard || json;
+  return {
+    city: full.city,
+    state: full.state,
+    country: full.country,
+  };
+});
+
+export const POST = nextAdapter(postGeoData, async (_request, _query, _params, payload) => {
+  const lat = payload?.latitude;
+  const lon = payload?.longitude;
+  const response = await fetch(`https://geocode.xyz/${lat},${lon}?json=1`);
+  const json = await response.json();
+  const full = json.standard || json;
+  return {
+    city: full.city,
+    state: full.state,
+    country: full.country,
+  };
+});
+```
+
+#### Express
+
+```typescript
+import express from 'express';
+import { expressAdapter } from '@svazqz/api-contract-kit/dist/server';
+import { getGeoData } from './api-definitions';
+
+const app = express();
+app.use(express.json());
+
+app.get('/geo', expressAdapter(getGeoData, async (_request, query) => {
+  return {
+    city: 'CDMX',
+    state: 'CDMX',
+    country: 'MX',
+  };
+}));
+```
+
+#### Fastify
+
+```typescript
+import Fastify from 'fastify';
+import { fastifyAdapter } from '@svazqz/api-contract-kit/dist/server';
+import { getGeoData } from './api-definitions';
+
+const app = Fastify();
+
+app.get('/geo', fastifyAdapter(getGeoData, async () => {
+  return {
+    city: 'CDMX',
+    state: 'CDMX',
+    country: 'MX',
+  };
+}));
+```
+
+#### Hono
+
+```typescript
+import { Hono } from 'hono';
+import { honoAdapter } from '@svazqz/api-contract-kit/dist/server';
+import { getGeoData } from './api-definitions';
+
+const app = new Hono();
+
+app.get('/geo', honoAdapter(getGeoData, async () => {
+  return {
+    city: 'CDMX',
+    state: 'CDMX',
+    country: 'MX',
+  };
+}));
+```
+
+### 4) Consume from client (framework-agnostic)
+
+#### Using `createClient`
+
+```typescript
+import { createClient } from '@svazqz/api-contract-kit/dist/client';
+import { getGeoData } from './api-definitions';
+
+const client = createClient({
+  baseUrl: 'https://my-api.example.com',
+});
+
+const result = await client.call(getGeoData, {
+  query: { latitude: 19.43, longitude: -99.13 },
+});
+```
+
+#### Using `apiConsumer`
+
+```typescript
+import { apiConsumer } from '@svazqz/api-contract-kit/dist/client';
+import { postGeoData } from './api-definitions';
+
+const callPostGeo = apiConsumer(postGeoData, {
+  baseUrl: 'https://my-api.example.com',
+});
+
+const result = await callPostGeo({
+  body: { latitude: 19.43, longitude: -99.13 },
+});
+```
+
+### 5) Optional React Query adapter
+
+```typescript
+import { createReactQueryAdapter } from '@svazqz/api-contract-kit/dist/react-query';
+import { getGeoData } from './api-definitions';
+
+const rq = createReactQueryAdapter({
+  baseUrl: 'https://my-api.example.com',
+});
+
+const { query } = rq.useApiQuery(
+  getGeoData,
+  { query: { latitude: 19.43, longitude: -99.13 } },
+  { enabled: true },
+);
+```
+
+## Advanced Configuration
+
+### Auth
+
+Provide `auth(request)` in your API definition. It can return:
+
+- `true` / `false`
+- or an object with `ok`, `status`, `body`, `headers`
+
+This allows centralized authorization behavior before business logic runs.
+
+### Error Mapping
+
+Provide `errorMapper` in your definition to transform runtime/validation/auth errors into your API error contract.
+
+### Custom Codecs
+
+You can provide `codec` in your definition to customize request decoding and response encoding.
+
+Current built-in default: JSON codec.
+
+Architectural rationale:
+
+- keep the transport layer extensible without changing business handlers
+
+## OpenAPI Generation
+
+The OpenAPI generator uses your endpoint definitions and metadata to build a static JSON document.
+
+CLI binary:
+
+```bash
+export-open-api
+```
+
+The generator accepts positional arguments for:
+
+- API definitions index module path
+- output directory (optional, defaults to `dist`)
+- API path prefix (optional, defaults to `/api`)
+
+Typical CI flow:
+
+1. Build your project definitions.
+2. Run OpenAPI export.
+3. Publish generated JSON artifact.
+4. Serve static API docs (for example in GitHub Pages) from that artifact.
+
+## Current Architectural Trade-offs
+
+1. **Fetch-based core**
+   - Great portability to Edge and modern runtimes.
+   - Requires adapter conversion for classic Node middleware stacks.
+2. **Zod as contract runtime**
+   - Strong validation and type inference.
+   - Requires schema discipline in all endpoint definitions.
+3. **Optional React Query module**
+   - Keeps core lightweight and framework-agnostic.
+   - Users needing hooks must install adapter peer dependencies.
+4. **Codec abstraction**
+   - Future-proofs transport format strategy.
+   - Adds a small abstraction layer to runtime pipeline.
+
+## Project Status
+
+The library now supports a modular architecture with:
+
+- framework-agnostic server core
+- multi-framework adapters
+- framework-agnostic client core
+- optional React Query integration
+- OpenAPI automation designed for CI/CD pipelines
+
+## Donate
+
+[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=BTJPCXNPH43YC)

package/dist/api-contract-kit.cjs.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const R=e=>{var a,p,i,r,c,u,y,h,m,d,l,P,g,q,j,C,T,x,$,b;const o=`${e.openapiPathPrefix??"/api"}`,s=`${e.endpoint??e.path??""}`,t=e.codec??A,n={method:e.method,path:`${o}${s}`,summary:((a=e.openapi)==null?void 0:a.summary)??"",request:{},responses:{}},I=(p=e.schemas)!=null&&p.response?{200:{description:((c=(r=(i=e.openapi)==null?void 0:i.responses)==null?void 0:r[200])==null?void 0:c.description)??"",content:{[t.responseContentType]:{schema:(u=e.schemas)==null?void 0:u.response}}}}:{},O=((y=e.openapi)==null?void 0:y.responses)??{};return n.responses={...I,...O},(h=e.schemas)!=null&&h.queryParams&&(n.request.query=(d=(m=e.schemas)==null?void 0:m.queryParams)==null?void 0:d.openapi("Query Params")),(l=e.schemas)!=null&&l.payload&&(n.request.body={description:"Body",content:{[t.requestContentType]:{schema:(P=e.schemas)==null?void 0:P.payload}},required:!0}),(g=e.schemas)!=null&&g.urlArgs&&(n.request.params=(j=(q=e.schemas)==null?void 0:q.urlArgs)==null?void 0:j.openapi("URL Params")),n.description=(C=e.openapi)==null?void 0:C.description,n.tags=(T=e.openapi)==null?void 0:T.tags,n.operationId=(x=e.openapi)==null?void 0:x.operationId,n.deprecated=($=e.openapi)==null?void 0:$.deprecated,n.security=(b=e.openapi)==null?void 0:b.security,n},A={id:"json",requestContentType:"application/json",responseContentType:"application/json",decodeRequest:async e=>{if(!(e.headers.get("content-type")||"").includes("application/json")){const t=await e.text();if(!t)return;try{return JSON.parse(t)}catch{return t}}const s=await e.text();if(s)return JSON.parse(s)},encodeResponse:async e=>({body:JSON.stringify(e),headers:{"content-type":"application/json"}})},S=e=>{const o=`${e.path??e.endpoint??""}`,s=o.startsWith("/")?o:`/${o}`,t={method:"get",...e,path:s==="/"?"":s,endpoint:s==="/"?"":s,codec:e.codec??A};return t.apiConfig=R(t),t};exports.createAPIDefinition=S;
+//# sourceMappingURL=api-contract-kit.cjs.js.map

package/dist/api-contract-kit.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-contract-kit.cjs.js","sources":["../src/utils.ts","../src/next-api-generator.ts"],"sourcesContent":["import { ZodType, ZodNumber, ZodBoolean } from 'zod';\nimport { ApiCodec, ServerFnDefinition } from './types';\nimport { RouteConfig } from '@asteasolutions/zod-to-openapi';\n\nexport function validateQueryParams<\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  Response extends ZodType,\n>(\n  request: Request,\n  def: ServerFnDefinition<URLParams, QueryParams, Body, Response>,\n) {\n  const queryParams = {};\n  const params = new URL(request.url).searchParams.keys();\n  for (const param of params) {\n    if ((def.schemas?.queryParams as any).shape[param] instanceof ZodNumber) {\n      (queryParams as unknown as any)[param as unknown as string] = Number(\n        new URL(request.url).searchParams.get(param),\n      );\n    } else if (\n      (def.schemas?.queryParams as any).shape[param] instanceof ZodBoolean\n    ) {\n      (queryParams as unknown as any)[param as unknown as string] = Boolean(\n        new URL(request.url).searchParams.get(param),\n      );\n    } else {\n      (queryParams as unknown as any)[param as unknown as string] =\n        new URL(request.url).searchParams.get(param);\n    }\n  }\n  def.schemas?.queryParams?.parse(queryParams);\n  return queryParams;\n}\n\nexport async function validatePayload<\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  Response extends ZodType,\n>(\n  request: Request,\n  def: ServerFnDefinition<URLParams, QueryParams, Body, Response>,\n  ProtoClass: any,\n) {\n  let parsedPayload: Body | undefined = undefined;\n\n  if (ProtoClass) {\n    try {\n      const lResponse = await request.arrayBuffer();\n      parsedPayload = ProtoClass.decode(new Uint8Array(lResponse));\n    } catch {\n      throw new Error('Protocol buffer parsing error');\n    }\n  } else {\n    parsedPayload = await request.json();\n  }\n  def.schemas?.payload?.parse(parsedPayload);\n  return parsedPayload;\n}\n\nexport const setOpenAPIMetadata = (_def: any) => {\n  const openapiPathPrefix = `${_def.openapiPathPrefix ?? '/api'}`;\n  const endpoint = `${_def.endpoint ?? _def.path ?? ''}`;\n  const codec = _def.codec ?? jsonCodec;\n\n  const apiConfig = {\n    method: _def.method,\n    path: `${openapiPathPrefix}${endpoint}`,\n    summary: _def.openapi?.summary ?? '',\n    request: {},\n    responses: {},\n  } as RouteConfig;\n\n  const baseResponses =\n    _def.schemas?.response\n      ? {\n          200: {\n            description: _def.openapi?.responses?.[200]?.description ?? '',\n            content: {\n              [codec.responseContentType]: {\n                schema: _def.schemas?.response,\n              },\n            },\n          },\n        }\n      : {};\n\n  const customResponses = _def.openapi?.responses ?? {};\n  apiConfig.responses = { ...baseResponses, ...customResponses };\n\n  if (_def.schemas?.queryParams) {\n    (apiConfig.request as any).query = (\n      _def.schemas?.queryParams as any\n    )?.openapi('Query Params');\n  }\n  if (_def.schemas?.payload) {\n    (apiConfig.request as any).body = {\n      description: 'Body',\n      content: {\n        [codec.requestContentType]: {\n          schema: _def.schemas?.payload,\n        },\n      },\n      required: true,\n    };\n  }\n  if (_def.schemas?.urlArgs) {\n    (apiConfig.request as any).params = (_def.schemas?.urlArgs as any)?.openapi(\n      'URL Params',\n    );\n  }\n\n  (apiConfig as any).description = _def.openapi?.description;\n  (apiConfig as any).tags = _def.openapi?.tags;\n  (apiConfig as any).operationId = _def.openapi?.operationId;\n  (apiConfig as any).deprecated = _def.openapi?.deprecated;\n  (apiConfig as any).security = _def.openapi?.security;\n\n  return apiConfig;\n};\n\nexport const jsonCodec: ApiCodec = {\n  id: 'json',\n  requestContentType: 'application/json',\n  responseContentType: 'application/json',\n  decodeRequest: async (request) => {\n    const contentType = request.headers.get('content-type') || '';\n    if (!contentType.includes('application/json')) {\n      const text = await request.text();\n      if (!text) return undefined;\n      try {\n        return JSON.parse(text);\n      } catch {\n        return text;\n      }\n    }\n    const text = await request.text();\n    if (!text) return undefined;\n    return JSON.parse(text);\n  },\n  encodeResponse: async (value) => ({\n    body: JSON.stringify(value),\n    headers: { 'content-type': 'application/json' },\n  }),\n};\n","import { ZodType } from 'zod';\nimport { jsonCodec, setOpenAPIMetadata } from './utils';\nimport { ServerFnDefinition } from './types';\n\nexport const createAPIDefinition = <\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  ResponseSchema extends ZodType,\n>(\n  def: ServerFnDefinition<URLParams, QueryParams, Body, ResponseSchema>,\n): ServerFnDefinition<URLParams, QueryParams, Body, ResponseSchema> => {\n  const path = `${def.path ?? def.endpoint ?? ''}`;\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  const _def = {\n    method: 'get',\n    ...def,\n    ...{\n      path: normalizedPath === '/' ? '' : normalizedPath,\n      endpoint: normalizedPath === '/' ? '' : normalizedPath,\n    },\n    codec: def.codec ?? jsonCodec,\n  };\n\n  (_def as any).apiConfig = setOpenAPIMetadata(_def);\n\n  return _def;\n};\n"],"names":["setOpenAPIMetadata","_def","openapiPathPrefix","endpoint","codec","jsonCodec","apiConfig","_a","baseResponses","_b","_e","_d","_c","_f","customResponses","_g","_h","_j","_i","_k","_l","_m","_o","_n","_p","_q","_r","_s","_t","request","text","value","createAPIDefinition","def","path","normalizedPath"],"mappings":"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"}

package/dist/api-contract-kit.d.ts

@@ -0,0 +1 @@
+export { createAPIDefinition } from './next-api-generator';

package/dist/api-contract-kit.es.js

@@ -0,0 +1,65 @@
+const b = (e) => {
+  var a, p, r, i, c, u, h, y, m, d, P, l, g, q, x, C, j, T, $, R;
+  const o = `${e.openapiPathPrefix ?? "/api"}`, n = `${e.endpoint ?? e.path ?? ""}`, t = e.codec ?? A, s = {
+    method: e.method,
+    path: `${o}${n}`,
+    summary: ((a = e.openapi) == null ? void 0 : a.summary) ?? "",
+    request: {},
+    responses: {}
+  }, I = (p = e.schemas) != null && p.response ? {
+    200: {
+      description: ((c = (i = (r = e.openapi) == null ? void 0 : r.responses) == null ? void 0 : i[200]) == null ? void 0 : c.description) ?? "",
+      content: {
+        [t.responseContentType]: {
+          schema: (u = e.schemas) == null ? void 0 : u.response
+        }
+      }
+    }
+  } : {}, O = ((h = e.openapi) == null ? void 0 : h.responses) ?? {};
+  return s.responses = { ...I, ...O }, (y = e.schemas) != null && y.queryParams && (s.request.query = (d = (m = e.schemas) == null ? void 0 : m.queryParams) == null ? void 0 : d.openapi("Query Params")), (P = e.schemas) != null && P.payload && (s.request.body = {
+    description: "Body",
+    content: {
+      [t.requestContentType]: {
+        schema: (l = e.schemas) == null ? void 0 : l.payload
+      }
+    },
+    required: !0
+  }), (g = e.schemas) != null && g.urlArgs && (s.request.params = (x = (q = e.schemas) == null ? void 0 : q.urlArgs) == null ? void 0 : x.openapi(
+    "URL Params"
+  )), s.description = (C = e.openapi) == null ? void 0 : C.description, s.tags = (j = e.openapi) == null ? void 0 : j.tags, s.operationId = (T = e.openapi) == null ? void 0 : T.operationId, s.deprecated = ($ = e.openapi) == null ? void 0 : $.deprecated, s.security = (R = e.openapi) == null ? void 0 : R.security, s;
+}, A = {
+  id: "json",
+  requestContentType: "application/json",
+  responseContentType: "application/json",
+  decodeRequest: async (e) => {
+    if (!(e.headers.get("content-type") || "").includes("application/json")) {
+      const t = await e.text();
+      if (!t) return;
+      try {
+        return JSON.parse(t);
+      } catch {
+        return t;
+      }
+    }
+    const n = await e.text();
+    if (n)
+      return JSON.parse(n);
+  },
+  encodeResponse: async (e) => ({
+    body: JSON.stringify(e),
+    headers: { "content-type": "application/json" }
+  })
+}, J = (e) => {
+  const o = `${e.path ?? e.endpoint ?? ""}`, n = o.startsWith("/") ? o : `/${o}`, t = {
+    method: "get",
+    ...e,
+    path: n === "/" ? "" : n,
+    endpoint: n === "/" ? "" : n,
+    codec: e.codec ?? A
+  };
+  return t.apiConfig = b(t), t;
+};
+export {
+  J as createAPIDefinition
+};
+//# sourceMappingURL=api-contract-kit.es.js.map

package/dist/api-contract-kit.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-contract-kit.es.js","sources":["../src/utils.ts","../src/next-api-generator.ts"],"sourcesContent":["import { ZodType, ZodNumber, ZodBoolean } from 'zod';\nimport { ApiCodec, ServerFnDefinition } from './types';\nimport { RouteConfig } from '@asteasolutions/zod-to-openapi';\n\nexport function validateQueryParams<\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  Response extends ZodType,\n>(\n  request: Request,\n  def: ServerFnDefinition<URLParams, QueryParams, Body, Response>,\n) {\n  const queryParams = {};\n  const params = new URL(request.url).searchParams.keys();\n  for (const param of params) {\n    if ((def.schemas?.queryParams as any).shape[param] instanceof ZodNumber) {\n      (queryParams as unknown as any)[param as unknown as string] = Number(\n        new URL(request.url).searchParams.get(param),\n      );\n    } else if (\n      (def.schemas?.queryParams as any).shape[param] instanceof ZodBoolean\n    ) {\n      (queryParams as unknown as any)[param as unknown as string] = Boolean(\n        new URL(request.url).searchParams.get(param),\n      );\n    } else {\n      (queryParams as unknown as any)[param as unknown as string] =\n        new URL(request.url).searchParams.get(param);\n    }\n  }\n  def.schemas?.queryParams?.parse(queryParams);\n  return queryParams;\n}\n\nexport async function validatePayload<\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  Response extends ZodType,\n>(\n  request: Request,\n  def: ServerFnDefinition<URLParams, QueryParams, Body, Response>,\n  ProtoClass: any,\n) {\n  let parsedPayload: Body | undefined = undefined;\n\n  if (ProtoClass) {\n    try {\n      const lResponse = await request.arrayBuffer();\n      parsedPayload = ProtoClass.decode(new Uint8Array(lResponse));\n    } catch {\n      throw new Error('Protocol buffer parsing error');\n    }\n  } else {\n    parsedPayload = await request.json();\n  }\n  def.schemas?.payload?.parse(parsedPayload);\n  return parsedPayload;\n}\n\nexport const setOpenAPIMetadata = (_def: any) => {\n  const openapiPathPrefix = `${_def.openapiPathPrefix ?? '/api'}`;\n  const endpoint = `${_def.endpoint ?? _def.path ?? ''}`;\n  const codec = _def.codec ?? jsonCodec;\n\n  const apiConfig = {\n    method: _def.method,\n    path: `${openapiPathPrefix}${endpoint}`,\n    summary: _def.openapi?.summary ?? '',\n    request: {},\n    responses: {},\n  } as RouteConfig;\n\n  const baseResponses =\n    _def.schemas?.response\n      ? {\n          200: {\n            description: _def.openapi?.responses?.[200]?.description ?? '',\n            content: {\n              [codec.responseContentType]: {\n                schema: _def.schemas?.response,\n              },\n            },\n          },\n        }\n      : {};\n\n  const customResponses = _def.openapi?.responses ?? {};\n  apiConfig.responses = { ...baseResponses, ...customResponses };\n\n  if (_def.schemas?.queryParams) {\n    (apiConfig.request as any).query = (\n      _def.schemas?.queryParams as any\n    )?.openapi('Query Params');\n  }\n  if (_def.schemas?.payload) {\n    (apiConfig.request as any).body = {\n      description: 'Body',\n      content: {\n        [codec.requestContentType]: {\n          schema: _def.schemas?.payload,\n        },\n      },\n      required: true,\n    };\n  }\n  if (_def.schemas?.urlArgs) {\n    (apiConfig.request as any).params = (_def.schemas?.urlArgs as any)?.openapi(\n      'URL Params',\n    );\n  }\n\n  (apiConfig as any).description = _def.openapi?.description;\n  (apiConfig as any).tags = _def.openapi?.tags;\n  (apiConfig as any).operationId = _def.openapi?.operationId;\n  (apiConfig as any).deprecated = _def.openapi?.deprecated;\n  (apiConfig as any).security = _def.openapi?.security;\n\n  return apiConfig;\n};\n\nexport const jsonCodec: ApiCodec = {\n  id: 'json',\n  requestContentType: 'application/json',\n  responseContentType: 'application/json',\n  decodeRequest: async (request) => {\n    const contentType = request.headers.get('content-type') || '';\n    if (!contentType.includes('application/json')) {\n      const text = await request.text();\n      if (!text) return undefined;\n      try {\n        return JSON.parse(text);\n      } catch {\n        return text;\n      }\n    }\n    const text = await request.text();\n    if (!text) return undefined;\n    return JSON.parse(text);\n  },\n  encodeResponse: async (value) => ({\n    body: JSON.stringify(value),\n    headers: { 'content-type': 'application/json' },\n  }),\n};\n","import { ZodType } from 'zod';\nimport { jsonCodec, setOpenAPIMetadata } from './utils';\nimport { ServerFnDefinition } from './types';\n\nexport const createAPIDefinition = <\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  ResponseSchema extends ZodType,\n>(\n  def: ServerFnDefinition<URLParams, QueryParams, Body, ResponseSchema>,\n): ServerFnDefinition<URLParams, QueryParams, Body, ResponseSchema> => {\n  const path = `${def.path ?? def.endpoint ?? ''}`;\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  const _def = {\n    method: 'get',\n    ...def,\n    ...{\n      path: normalizedPath === '/' ? '' : normalizedPath,\n      endpoint: normalizedPath === '/' ? '' : normalizedPath,\n    },\n    codec: def.codec ?? jsonCodec,\n  };\n\n  (_def as any).apiConfig = setOpenAPIMetadata(_def);\n\n  return _def;\n};\n"],"names":["setOpenAPIMetadata","_def","_a","_b","_c","_d","_e","_f","_g","_h","_i","_j","_k","_l","_m","_n","_o","_p","_q","_r","_s","_t","openapiPathPrefix","endpoint","codec","jsonCodec","apiConfig","baseResponses","customResponses","request","text","value","createAPIDefinition","def","path","normalizedPath"],"mappings":"AA6DO,MAAMA,IAAqB,CAACC,MAAc;AAA1C,MAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC,GAAAC;AACL,QAAMC,IAAoB,GAAGrB,EAAK,qBAAqB,MAAM,IACvDsB,IAAW,GAAGtB,EAAK,YAAYA,EAAK,QAAQ,EAAE,IAC9CuB,IAAQvB,EAAK,SAASwB,GAEtBC,IAAY;AAAA,IAChB,QAAQzB,EAAK;AAAA,IACb,MAAM,GAAGqB,CAAiB,GAAGC,CAAQ;AAAA,IACrC,WAASrB,IAAAD,EAAK,YAAL,gBAAAC,EAAc,YAAW;AAAA,IAClC,SAAS,CAAA;AAAA,IACT,WAAW,CAAA;AAAA,EAAC,GAGRyB,KACJxB,IAAAF,EAAK,YAAL,QAAAE,EAAc,WACV;AAAA,IACE,KAAK;AAAA,MACH,eAAaG,KAAAD,KAAAD,IAAAH,EAAK,YAAL,gBAAAG,EAAc,cAAd,gBAAAC,EAA0B,SAA1B,gBAAAC,EAAgC,gBAAe;AAAA,MAC5D,SAAS;AAAA,QACP,CAACkB,EAAM,mBAAmB,GAAG;AAAA,UAC3B,SAAQjB,IAAAN,EAAK,YAAL,gBAAAM,EAAc;AAAA,QAAA;AAAA,MACxB;AAAA,IACF;AAAA,EACF,IAEF,CAAA,GAEAqB,MAAkBpB,IAAAP,EAAK,YAAL,gBAAAO,EAAc,cAAa,CAAA;AACnD,SAAAkB,EAAU,YAAY,EAAE,GAAGC,GAAe,GAAGC,EAAA,IAEzCnB,IAAAR,EAAK,YAAL,QAAAQ,EAAc,gBACfiB,EAAU,QAAgB,SACzBf,KAAAD,IAAAT,EAAK,YAAL,gBAAAS,EAAc,gBAAd,gBAAAC,EACC,QAAQ,mBAETC,IAAAX,EAAK,YAAL,QAAAW,EAAc,YACfc,EAAU,QAAgB,OAAO;AAAA,IAChC,aAAa;AAAA,IACb,SAAS;AAAA,MACP,CAACF,EAAM,kBAAkB,GAAG;AAAA,QAC1B,SAAQX,IAAAZ,EAAK,YAAL,gBAAAY,EAAc;AAAA,MAAA;AAAA,IACxB;AAAA,IAEF,UAAU;AAAA,EAAA,KAGVC,IAAAb,EAAK,YAAL,QAAAa,EAAc,YACfY,EAAU,QAAgB,UAAUV,KAAAD,IAAAd,EAAK,YAAL,gBAAAc,EAAc,YAAd,gBAAAC,EAA+B;AAAA,IAClE;AAAA,MAIHU,EAAkB,eAAcT,IAAAhB,EAAK,YAAL,gBAAAgB,EAAc,aAC9CS,EAAkB,QAAOR,IAAAjB,EAAK,YAAL,gBAAAiB,EAAc,MACvCQ,EAAkB,eAAcP,IAAAlB,EAAK,YAAL,gBAAAkB,EAAc,aAC9CO,EAAkB,cAAaN,IAAAnB,EAAK,YAAL,gBAAAmB,EAAc,YAC7CM,EAAkB,YAAWL,IAAApB,EAAK,YAAL,gBAAAoB,EAAc,UAErCK;AACT,GAEaD,IAAsB;AAAA,EACjC,IAAI;AAAA,EACJ,oBAAoB;AAAA,EACpB,qBAAqB;AAAA,EACrB,eAAe,OAAOI,MAAY;AAEhC,QAAI,EADgBA,EAAQ,QAAQ,IAAI,cAAc,KAAK,IAC1C,SAAS,kBAAkB,GAAG;AAC7C,YAAMC,IAAO,MAAMD,EAAQ,KAAA;AAC3B,UAAI,CAACC,EAAM;AACX,UAAI;AACF,eAAO,KAAK,MAAMA,CAAI;AAAA,MACxB,QAAQ;AACN,eAAOA;AAAAA,MACT;AAAA,IACF;AACA,UAAMA,IAAO,MAAMD,EAAQ,KAAA;AAC3B,QAAKC;AACL,aAAO,KAAK,MAAMA,CAAI;AAAA,EACxB;AAAA,EACA,gBAAgB,OAAOC,OAAW;AAAA,IAChC,MAAM,KAAK,UAAUA,CAAK;AAAA,IAC1B,SAAS,EAAE,gBAAgB,mBAAA;AAAA,EAAmB;AAElD,GC7IaC,IAAsB,CAMjCC,MACqE;AACrE,QAAMC,IAAO,GAAGD,EAAI,QAAQA,EAAI,YAAY,EAAE,IACxCE,IAAiBD,EAAK,WAAW,GAAG,IAAIA,IAAO,IAAIA,CAAI,IAEvDjC,IAAO;AAAA,IACX,QAAQ;AAAA,IACR,GAAGgC;AAAA,IAED,MAAME,MAAmB,MAAM,KAAKA;AAAA,IACpC,UAAUA,MAAmB,MAAM,KAAKA;AAAA,IAE1C,OAAOF,EAAI,SAASR;AAAA,EAAA;AAGrB,SAAAxB,EAAa,YAAYD,EAAmBC,CAAI,GAE1CA;AACT;"}

package/dist/client.cjs.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l={id:"json",requestContentType:"application/json",responseContentType:"application/json",decodeRequest:async e=>{if(!(e.headers.get("content-type")||"").includes("application/json")){const r=await e.text();if(!r)return;try{return JSON.parse(r)}catch{return r}}const s=await e.text();if(s)return JSON.parse(s)},encodeResponse:async e=>({body:JSON.stringify(e),headers:{"content-type":"application/json"}})},u=(e,t)=>{let s=`${e}${t.query?`?${new URLSearchParams(t.query||{})}`:""}`;return t&&t.urlParams&&Object.keys(t.urlParams).forEach(r=>{s=s.replace(`{${r}}`,t==null?void 0:t.urlParams[r])}),s},p=e=>{const t=e.fetchFn??fetch,s=e.headersProvider;return{call:async(n,a)=>{const c=u((n==null?void 0:n.endpoint)||(n==null?void 0:n.path)||"/",a),h=await(s==null?void 0:s())??{},o=`${e.baseUrl}${c}`,d=await t(o,{method:n.method||"get",body:a.body===void 0?void 0:JSON.stringify(a.body),headers:{...h,...a.headers??{},...a.body===void 0?{}:{"content-type":l.requestContentType}},signal:a.signal});if(!d.ok){const b=await d.text();throw new Error(b||`Request failed with status ${d.status}`)}return await l.decodeRequest(d)}}},y=(e,t)=>async s=>{var c;const r=(c=globalThis==null?void 0:globalThis.process)==null?void 0:c.env,n=(r==null?void 0:r.NEXT_PUBLIC_BASE_API_URL)||"";return p({baseUrl:(t==null?void 0:t.baseUrl)??n,fetchFn:t==null?void 0:t.fetchFn,headersProvider:t==null?void 0:t.headersProvider}).call(e,s)};exports.apiConsumer=y;exports.createClient=p;
+//# sourceMappingURL=client.cjs.js.map

package/dist/client.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs.js","sources":["../src/utils.ts","../src/client.ts"],"sourcesContent":["import { ZodType, ZodNumber, ZodBoolean } from 'zod';\nimport { ApiCodec, ServerFnDefinition } from './types';\nimport { RouteConfig } from '@asteasolutions/zod-to-openapi';\n\nexport function validateQueryParams<\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  Response extends ZodType,\n>(\n  request: Request,\n  def: ServerFnDefinition<URLParams, QueryParams, Body, Response>,\n) {\n  const queryParams = {};\n  const params = new URL(request.url).searchParams.keys();\n  for (const param of params) {\n    if ((def.schemas?.queryParams as any).shape[param] instanceof ZodNumber) {\n      (queryParams as unknown as any)[param as unknown as string] = Number(\n        new URL(request.url).searchParams.get(param),\n      );\n    } else if (\n      (def.schemas?.queryParams as any).shape[param] instanceof ZodBoolean\n    ) {\n      (queryParams as unknown as any)[param as unknown as string] = Boolean(\n        new URL(request.url).searchParams.get(param),\n      );\n    } else {\n      (queryParams as unknown as any)[param as unknown as string] =\n        new URL(request.url).searchParams.get(param);\n    }\n  }\n  def.schemas?.queryParams?.parse(queryParams);\n  return queryParams;\n}\n\nexport async function validatePayload<\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  Response extends ZodType,\n>(\n  request: Request,\n  def: ServerFnDefinition<URLParams, QueryParams, Body, Response>,\n  ProtoClass: any,\n) {\n  let parsedPayload: Body | undefined = undefined;\n\n  if (ProtoClass) {\n    try {\n      const lResponse = await request.arrayBuffer();\n      parsedPayload = ProtoClass.decode(new Uint8Array(lResponse));\n    } catch {\n      throw new Error('Protocol buffer parsing error');\n    }\n  } else {\n    parsedPayload = await request.json();\n  }\n  def.schemas?.payload?.parse(parsedPayload);\n  return parsedPayload;\n}\n\nexport const setOpenAPIMetadata = (_def: any) => {\n  const openapiPathPrefix = `${_def.openapiPathPrefix ?? '/api'}`;\n  const endpoint = `${_def.endpoint ?? _def.path ?? ''}`;\n  const codec = _def.codec ?? jsonCodec;\n\n  const apiConfig = {\n    method: _def.method,\n    path: `${openapiPathPrefix}${endpoint}`,\n    summary: _def.openapi?.summary ?? '',\n    request: {},\n    responses: {},\n  } as RouteConfig;\n\n  const baseResponses =\n    _def.schemas?.response\n      ? {\n          200: {\n            description: _def.openapi?.responses?.[200]?.description ?? '',\n            content: {\n              [codec.responseContentType]: {\n                schema: _def.schemas?.response,\n              },\n            },\n          },\n        }\n      : {};\n\n  const customResponses = _def.openapi?.responses ?? {};\n  apiConfig.responses = { ...baseResponses, ...customResponses };\n\n  if (_def.schemas?.queryParams) {\n    (apiConfig.request as any).query = (\n      _def.schemas?.queryParams as any\n    )?.openapi('Query Params');\n  }\n  if (_def.schemas?.payload) {\n    (apiConfig.request as any).body = {\n      description: 'Body',\n      content: {\n        [codec.requestContentType]: {\n          schema: _def.schemas?.payload,\n        },\n      },\n      required: true,\n    };\n  }\n  if (_def.schemas?.urlArgs) {\n    (apiConfig.request as any).params = (_def.schemas?.urlArgs as any)?.openapi(\n      'URL Params',\n    );\n  }\n\n  (apiConfig as any).description = _def.openapi?.description;\n  (apiConfig as any).tags = _def.openapi?.tags;\n  (apiConfig as any).operationId = _def.openapi?.operationId;\n  (apiConfig as any).deprecated = _def.openapi?.deprecated;\n  (apiConfig as any).security = _def.openapi?.security;\n\n  return apiConfig;\n};\n\nexport const jsonCodec: ApiCodec = {\n  id: 'json',\n  requestContentType: 'application/json',\n  responseContentType: 'application/json',\n  decodeRequest: async (request) => {\n    const contentType = request.headers.get('content-type') || '';\n    if (!contentType.includes('application/json')) {\n      const text = await request.text();\n      if (!text) return undefined;\n      try {\n        return JSON.parse(text);\n      } catch {\n        return text;\n      }\n    }\n    const text = await request.text();\n    if (!text) return undefined;\n    return JSON.parse(text);\n  },\n  encodeResponse: async (value) => ({\n    body: JSON.stringify(value),\n    headers: { 'content-type': 'application/json' },\n  }),\n};\n","import { ZodType } from 'zod';\nimport { APIConsumerPayload, ConsumerFn, DTO, ServerFnDefinition } from './types';\nimport { jsonCodec } from './utils';\n\nconst getEndpointWithArgsAndQuery = <\n  URLParams extends ZodType,\n  QueryParams extends ZodType,\n  Body extends ZodType,\n  _ResponseSchema extends ZodType,\n>(\n  endpoint: string,\n  consumerPayload: APIConsumerPayload<\n    DTO<URLParams>,\n    DTO<QueryParams>,\n    DTO<Body>\n  >,\n) => {\n  let url = `${endpoint}${\n    consumerPayload.query\n      ? `?${new URLSearchParams(consumerPayload.query || {})}`\n      : ''\n  }`;\n\n  if (consumerPayload && consumerPayload.urlParams) {\n    Object.keys(consumerPayload.urlParams).forEach(\n      (arg: keyof typeof consumerPayload.urlParams) => {\n        url = url.replace(\n          `{${arg as string}}`,\n          consumerPayload?.urlParams![arg],\n        );\n      },\n    );\n  }\n\n  return url;\n};\n\nexport type ApiClientConfig = {\n  baseUrl: string;\n  fetchFn?: typeof fetch;\n  headersProvider?:\n    | (() => Promise<Record<string, string>>)\n    | (() => Record<string, string>);\n};\n\nexport const createClient = (config: ApiClientConfig) => {\n  const fetchFn = config.fetchFn ?? fetch;\n  const headersProvider = config.headersProvider;\n\n  const call = async <\n    URLParams extends ZodType,\n    QueryParams extends ZodType,\n    Body extends ZodType,\n    ResponseSchema extends ZodType,\n  >(\n    apiDefinition: ServerFnDefinition<URLParams, QueryParams, Body, ResponseSchema>,\n    consumerPayload: APIConsumerPayload<\n      DTO<URLParams>,\n      DTO<QueryParams>,\n      DTO<Body>\n    >,\n  ): Promise<DTO<ResponseSchema>> => {\n    const endpointKey = getEndpointWithArgsAndQuery(\n      apiDefinition?.endpoint || apiDefinition?.path || '/',\n      consumerPayload,\n    );\n\n    const resolvedHeaders =\n      (await headersProvider?.()) ?? ({} as Record<string, string>);\n\n    const url = `${config.baseUrl}${endpointKey}`;\n    const response = await fetchFn(url, {\n      method: apiDefinition.method || 'get',\n      body:\n        consumerPayload.body === undefined\n          ? undefined\n          : JSON.stringify(consumerPayload.body),\n      headers: {\n        ...resolvedHeaders,\n        ...(consumerPayload.headers ?? {}),\n        ...(consumerPayload.body === undefined\n          ? {}\n          : { 'content-type': jsonCodec.requestContentType }),\n      },\n      signal: consumerPayload.signal,\n    });\n\n    if (!response.ok) {\n      const text = await response.text();\n      throw new Error(text || `Request failed with status ${response.status}`);\n    }\n\n    const parsed = (await jsonCodec.decodeRequest(response)) as DTO<ResponseSchema>;\n    return parsed;\n  };\n\n  return { call };\n};\n\nexport const apiConsumer =\n  <\n    URLParams extends ZodType,\n    QueryParams extends ZodType,\n    Body extends ZodType,\n    ResponseSchema extends ZodType,\n  >(\n    apiDefinition: ServerFnDefinition<URLParams, QueryParams, Body, ResponseSchema>,\n    config?: Partial<ApiClientConfig> & { baseUrl: string },\n  ): ConsumerFn<URLParams, QueryParams, Body, ResponseSchema> =>\n  async (\n    consumerPayload: APIConsumerPayload<\n      DTO<URLParams>,\n      DTO<QueryParams>,\n      DTO<Body>\n    >,\n  ) => {\n    const runtimeEnv = (globalThis as any)?.process?.env;\n    const fallbackBaseUrl =\n      runtimeEnv?.NEXT_PUBLIC_BASE_API_URL || '';\n\n    const client = createClient({\n      baseUrl: config?.baseUrl ?? fallbackBaseUrl,\n      fetchFn: config?.fetchFn,\n      headersProvider: config?.headersProvider,\n    });\n\n    return client.call(apiDefinition, consumerPayload);\n  };\n"],"names":["jsonCodec","request","text","value","getEndpointWithArgsAndQuery","endpoint","consumerPayload","url","arg","createClient","config","fetchFn","headersProvider","apiDefinition","endpointKey","resolvedHeaders","response","apiConsumer","runtimeEnv","_a","fallbackBaseUrl"],"mappings":"gFA0HO,MAAMA,EAAsB,CACjC,GAAI,OACJ,mBAAoB,mBACpB,oBAAqB,mBACrB,cAAe,MAAOC,GAAY,CAEhC,GAAI,EADgBA,EAAQ,QAAQ,IAAI,cAAc,GAAK,IAC1C,SAAS,kBAAkB,EAAG,CAC7C,MAAMC,EAAO,MAAMD,EAAQ,KAAA,EAC3B,GAAI,CAACC,EAAM,OACX,GAAI,CACF,OAAO,KAAK,MAAMA,CAAI,CACxB,MAAQ,CACN,OAAOA,CACT,CACF,CACA,MAAMA,EAAO,MAAMD,EAAQ,KAAA,EAC3B,GAAKC,EACL,OAAO,KAAK,MAAMA,CAAI,CACxB,EACA,eAAgB,MAAOC,IAAW,CAChC,KAAM,KAAK,UAAUA,CAAK,EAC1B,QAAS,CAAE,eAAgB,kBAAA,CAAmB,EAElD,EC7IMC,EAA8B,CAMlCC,EACAC,IAKG,CACH,IAAIC,EAAM,GAAGF,CAAQ,GACnBC,EAAgB,MACZ,IAAI,IAAI,gBAAgBA,EAAgB,OAAS,CAAA,CAAE,CAAC,GACpD,EACN,GAEA,OAAIA,GAAmBA,EAAgB,WACrC,OAAO,KAAKA,EAAgB,SAAS,EAAE,QACpCE,GAAgD,CAC/CD,EAAMA,EAAI,QACR,IAAIC,CAAa,IACjBF,GAAA,YAAAA,EAAiB,UAAWE,EAAG,CAEnC,CAAA,EAIGD,CACT,EAUaE,EAAgBC,GAA4B,CACvD,MAAMC,EAAUD,EAAO,SAAW,MAC5BE,EAAkBF,EAAO,gBAiD/B,MAAO,CAAE,KA/CI,MAMXG,EACAP,IAKiC,CACjC,MAAMQ,EAAcV,GAClBS,GAAA,YAAAA,EAAe,YAAYA,GAAA,YAAAA,EAAe,OAAQ,IAClDP,CAAA,EAGIS,EACH,MAAMH,GAAA,YAAAA,MAAyB,CAAA,EAE5BL,EAAM,GAAGG,EAAO,OAAO,GAAGI,CAAW,GACrCE,EAAW,MAAML,EAAQJ,EAAK,CAClC,OAAQM,EAAc,QAAU,MAChC,KACEP,EAAgB,OAAS,OACrB,OACA,KAAK,UAAUA,EAAgB,IAAI,EACzC,QAAS,CACP,GAAGS,EACH,GAAIT,EAAgB,SAAW,CAAA,EAC/B,GAAIA,EAAgB,OAAS,OACzB,CAAA,EACA,CAAE,eAAgBN,EAAU,kBAAA,CAAmB,EAErD,OAAQM,EAAgB,MAAA,CACzB,EAED,GAAI,CAACU,EAAS,GAAI,CAChB,MAAMd,EAAO,MAAMc,EAAS,KAAA,EAC5B,MAAM,IAAI,MAAMd,GAAQ,8BAA8Bc,EAAS,MAAM,EAAE,CACzE,CAGA,OADgB,MAAMhB,EAAU,cAAcgB,CAAQ,CAExD,CAES,CACX,EAEaC,EACX,CAMEJ,EACAH,IAEF,MACEJ,GAKG,OACH,MAAMY,GAAcC,EAAA,mCAAoB,UAApB,YAAAA,EAA6B,IAC3CC,GACJF,GAAA,YAAAA,EAAY,2BAA4B,GAQ1C,OANeT,EAAa,CAC1B,SAASC,GAAA,YAAAA,EAAQ,UAAWU,EAC5B,QAASV,GAAA,YAAAA,EAAQ,QACjB,gBAAiBA,GAAA,YAAAA,EAAQ,eAAA,CAC1B,EAEa,KAAKG,EAAeP,CAAe,CACnD"}

package/dist/client.d.ts

@@ -0,0 +1,13 @@
+import { ZodType } from 'zod';
+import { APIConsumerPayload, ConsumerFn, DTO, ServerFnDefinition } from './types';
+export type ApiClientConfig = {
+    baseUrl: string;
+    fetchFn?: typeof fetch;
+    headersProvider?: (() => Promise<Record<string, string>>) | (() => Record<string, string>);
+};
+export declare const createClient: (config: ApiClientConfig) => {
+    call: <URLParams extends ZodType, QueryParams extends ZodType, Body extends ZodType, ResponseSchema extends ZodType>(apiDefinition: ServerFnDefinition<URLParams, QueryParams, Body, ResponseSchema>, consumerPayload: APIConsumerPayload<DTO<URLParams>, DTO<QueryParams>, DTO<Body>>) => Promise<DTO<ResponseSchema>>;
+};
+export declare const apiConsumer: <URLParams extends ZodType, QueryParams extends ZodType, Body extends ZodType, ResponseSchema extends ZodType>(apiDefinition: ServerFnDefinition<URLParams, QueryParams, Body, ResponseSchema>, config?: Partial<ApiClientConfig> & {
+    baseUrl: string;
+}) => ConsumerFn<URLParams, QueryParams, Body, ResponseSchema>;