Summary

Adds support for request-level options in the post() method, addressing the use case from #1868 with a clean, typed interface.

New Features

RequestOptions interface:

interface RequestOptions {
  /** Request timeout in milliseconds */
  timeout?: number;
  /** AbortController signal for request cancellation */
  signal?: AbortSignal;
}

Usage examples:

// Set a 5 second timeout
await api.post('/path', body, headers, { timeout: 5000 });

// Use AbortController for cancellation
const controller = new AbortController();
setTimeout(() => controller.abort(), 5000);
await api.post('/path', body, headers, { signal: controller.signal });

Use Cases

This enables:

• Abort/timeout control via AbortController - Avoid requests hanging indefinitely in CI, server-side batch scripts, or when the API is slow
• Custom timeout settings per request - Override default timeouts for specific operations

Changes

• Added RequestOptions interface to src/types.ts
• Updated post() method to accept optional options parameter
• Updated Fetcher interface for consistency
• Added tests for timeout and abort signal functionality

Related

Addresses the feedback from @kinderjoypresents on #1868 - this provides a proper typed interface for request options instead of the heuristic-based approach.

🤖 Generated with Claude Code