GitHub - AniTrend/request-client: A tiny, dependency‑free, axios‑style fetch wrapper for Deno

A tiny, dependency-free, axios-style fetch wrapper for Deno

Features

🚀 Axios-style API - Familiar interface for HTTP requests
🎯 Zero Dependencies - Built on top of native Fetch API
📦 TypeScript First - Full type safety
🔄 Interceptors - Request, response, and error interceptors
⚙️ Configuration - Global and per-request configuration
⏱️ Timeout Support - Built-in request timeout handling
🎨 Multiple Response Types - JSON, text, blob, arrayBuffer

Installation

From JSR (Recommended)

import { createClient } from 'jsr:@anitrend/request-client@^0.1.0';

Add to deno.json

{
  "imports": {
    "@anitrend/request-client": "jsr:@anitrend/request-client@^0.1.0"
  }
}

Then import in your code:

import { createClient } from '@anitrend/request-client';

Runtime Compatibility

This package is built for Deno and published via JSR (JavaScript Registry).

✅ Deno (Primary Target)

Fully supported with zero dependencies. Uses native Fetch API.

import { createClient } from 'jsr:@anitrend/request-client@^0.1.0';

✅ Node.js (via JSR)

Compatible with Node.js 18+ through JSR's npm compatibility layer:

# Using npm
npx jsr add @anitrend/request-client

# Using yarn
yarn dlx jsr add @anitrend/request-client

# Using pnpm
pnpm dlx jsr add @anitrend/request-client

Then import in your Node.js code:

import { createClient } from '@anitrend/request-client';

✅ Bun

Compatible with Bun through JSR:

bunx jsr add @anitrend/request-client

🔄 Other Runtimes

Any JavaScript runtime that supports:

Native Fetch API
ES Modules
TypeScript (optional)

Should work with this package. Compatibility may vary based on the runtime's Fetch API implementation.

Quick Start

Basic Usage

import { createClient } from 'jsr:@anitrend/request-client';

// Create a client instance
const client = createClient();

// Make a GET request
const response = await client.get('https://api.example.com/users');
console.log(response.data);

// Make a POST request
const newUser = await client.post('https://api.example.com/users', {
  name: 'John Doe',
  email: 'john@example.com',
});
console.log(newUser.data);

With Configuration

import { createClient } from 'jsr:@anitrend/request-client';

const client = createClient({
  baseURL: 'https://api.example.com',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json',
  },
  timeout: 5000, // 5 seconds
});

// Now all requests use the baseURL
const users = await client.get('/users');
const user = await client.get('/users/1');

Query Parameters

const response = await client.get('/search', {
  params: {
    q: 'deno',
    limit: 10,
  },
});
// Requests: /search?q=deno&limit=10

Request Interceptors

client.interceptors.request.use((config) => {
  // Modify request config before sending
  config.headers = {
    ...config.headers,
    'X-Custom-Header': 'value',
  };
  return config;
});

Response Interceptors

client.interceptors.response.use((response) => {
  // Transform response data
  console.log('Response received:', response.status);
  return response;
});

Error Handling

import { RequestError } from 'jsr:@anitrend/request-client';

try {
  const response = await client.get('/endpoint');
} catch (error) {
  if (error instanceof RequestError) {
    console.error('Status:', error.response?.status);
    console.error('Data:', error.response?.data);
  }
}

API Reference

Creating a Client

const client = createClient(config?: RequestConfig);

RequestConfig

interface RequestConfig {
  baseURL?: string;
  headers?: Record<string, string>;
  timeout?: number;
  params?: Record<string, string | number | boolean>;
  data?: unknown;
  responseType?: 'json' | 'text' | 'blob' | 'arrayBuffer';
  signal?: AbortSignal;
  validateStatus?: (status: number) => boolean;
}

HTTP Methods

// GET request
client.get<T>(url: string, config?: RequestConfig): Promise<RequestResponse<T>>

// POST request
client.post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<RequestResponse<T>>

// PUT request
client.put<T>(url: string, data?: unknown, config?: RequestConfig): Promise<RequestResponse<T>>

// PATCH request
client.patch<T>(url: string, data?: unknown, config?: RequestConfig): Promise<RequestResponse<T>>

// DELETE request
client.delete<T>(url: string, config?: RequestConfig): Promise<RequestResponse<T>>

// HEAD request
client.head<T>(url: string, config?: RequestConfig): Promise<RequestResponse<T>>

// OPTIONS request
client.options<T>(url: string, config?: RequestConfig): Promise<RequestResponse<T>>

RequestResponse

interface RequestResponse<T = unknown> {
  data: T;
  status: number;
  statusText: string;
  headers: Headers;
  config: RequestConfig;
}

Development

Prerequisites

Deno 2.x or higher

Running Tests

# Run unit tests
deno task test:unit

# Run specification tests
deno task test:spec

# Watch mode
deno task test:watch

# Generate coverage report
deno task coverage

Code Quality

# Linting
deno task lint

# Formatting
deno task fmt

# Check formatting
deno task fmt:check

# Type checking
deno task check

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing.

License

   Copyright 2025 AniTrend

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.