fraftDeclarative HTTP for Node.js

Define requests and data transforms in YAML or JSON. Execute them with a single method call.

Get Started

API Reference

View on GitHub

📄

Config-driven

Define every HTTP request, header, auth, and transform step in a YAML or JSON file — no boilerplate code required.

🔄

Transform pipeline

Chain pick, rename, filter, coerce, and custom middleware steps to shape your API responses exactly as needed.

🔑

Environment variable interpolation

Reference secrets and dynamic values with ${env.VAR} syntax. Variables are resolved at load time from process.env.

🧩

Custom middleware

⚡

axios-powered

Built on top of axios with full passthrough of AxiosRequestConfig for timeouts, custom agents, and more.

🦺

Fully typed

Written in TypeScript with strict types and Zod-validated config schemas. All types are exported from the package root.

Quick Look

yaml

# api.yaml
version: 1
baseUrl: https://jsonplaceholder.typicode.com

requests:
  completedTodos:
    path: /todos
    transform:
      - filter: { field: completed, op: eq, value: true }
      - pick: [id, title]

import { FraftClient } from '@go-denki/fraft';

const client = new FraftClient({ config: 'api.yaml' });
const todos = await client.run('completedTodos');
// [ { id: 1, title: '...' }, ... ]