@archon-research/http-client-core

Typed HTTP client utilities built on OpenAPI and Zod for end-to-end request/response validation.

Installation

npm install @archon-research/http-client-core openapi-fetch
npm install --save-dev openapi-typescript

Features

• Type-safe HTTP client using OpenAPI specifications
• Built-in Zod schema validation for responses
• Automatic TypeScript types from OpenAPI specs
• Request and response interceptors

Usage

Generate types from OpenAPI spec

npx openapi-typescript api.yaml -o src/api.types.ts

Create a typed client

import createClient from 'openapi-fetch';
import type { paths } from './api.types';

const client = createClient<paths>({
  baseUrl: 'https://api.example.com',
});

// Fully typed requests and responses
const { data, error } = await client.GET('/users/{id}', {
  params: { path: { id: '123' } },
});

Validate responses with Zod

import { z } from 'zod';
import { createValidatedClient } from '@archon-research/http-client-core';

const UserSchema = z.object({
  id: z.string(),
  name: z.string(),
  email: z.string().email(),
});

// Client with automatic validation
const validatedClient = createValidatedClient(client, {
  'GET /users/{id}': UserSchema,
});

Peer dependencies

• openapi-typescript: For generating types from OpenAPI specs

See also

• http-client-react for React Query integration