@usecolf/client

COLF Client SDK with colfFetch HTTP wrapper and automatic response decoder for browser and web environments.

Overview

@usecolf/client provides client-side utilities for fetching and automatically unpacking COLF API responses. The included colfFetch wrapper sets Accept: application/vnd.colf+json and seamlessly unpacks compressed columnar JSON back into standard JavaScript arrays of objects.

Features

• Drop-in fetch Replacement: colfFetch shares the exact signature as browser native fetch.
• Automatic Content Negotiation: Automatically adds COLF headers and decodes application/vnd.colf+json responses.
• Transparent Decoding: Returns parsed JavaScript array objects transparently in response.json().

Installation

npm install @usecolf/client
# or
pnpm add @usecolf/client

Quick Start

import { colfFetch, decode } from '@usecolf/client';

// Use colfFetch just like standard fetch
const response = await colfFetch('/api/users');
const users = await response.json();

console.log(users); // Standard array of objects: [{ id: 1, name: 'Alice' }, ...]

License

MIT © COLF Team