@alt-stack/http-client-ky

Typed Zod-backed HTTP client using Ky. It supports a preconfigured KyInstance or adapter-wide Ky options and exposes KyResponse as raw.

Install

pnpm add @alt-stack/http-client-ky zod

Zod 4 is required as a peer. Ky is a direct dependency.

Quick use

import ky from "ky";
import { createApiClient } from "@alt-stack/http-client-ky";
import { Request, Response } from "./generated-api.js";

const transport = ky.create({
  hooks: {
    beforeRequest: [(request) => request.headers.set("X-App", "dashboard")],
  },
});

const api = createApiClient({
  baseUrl: "https://api.example.test",
  Request,
  Response,
  ky: transport,
});

The executor forces throwHttpErrors: false so documented non-2xx responses become typed result values. Avoid combining Ky retries with core retries unless two retry layers are intentional.

Documentation

• Quickstart
• Common Patterns
• Ky API Documentation
• Shared core API Documentation