elbywan/wretch

Features

• Fluent Request Builders - Provides a fluent, chainable interface to configure HTTP request options before executing the final fetch call.
• Fluent Request Builders - Uses a chainable fluent interface to manage request configuration and response processing.
• Fetch API Wrappers - Provides a chainable interface that wraps the Fetch API to simplify request configuration, response parsing, and error handling.
• Automatic Content-Type Selection - Automatically detects input types to choose between JSON, multipart, or URL-encoded formats for the request body.
• API Error Handling - Parses network error responses into consistent, type-safe formats for standardized application-wide handling.
• Response Body Parsing - Converts raw network responses into structured formats such as JSON, text, or blobs using built-in handlers.
• HTTP Client Libraries - Provides a lightweight tool for making network requests with built-in support for timeouts, retries, and interceptors.
• Request Configurations - Offers a system for defining the structure, authentication, and operational parameters of network requests.
• Middleware-Based Request Pipelines - Features a modular chain of pluggable components to intercept and modify network requests and responses.
• Response Resolution Pipelines - Processes network responses through a programmable sequence of predefined tasks to automate parsing and error handling.
• HTTP Request Execution - Performs standard synchronous and asynchronous HTTP operations including GET, POST, HEAD, and OPTIONS.
• Request Header Configuration - Provides comprehensive tools for defining and managing custom HTTP request headers and authentication metadata.
• Query Parameter Serializers - Transforms JavaScript objects or strings into URL search parameters while automatically filtering empty values.
• Message Body Serializers - Provides logic for encoding request bodies into JSON, multipart, or URL-encoded formats.
• Descriptive HTTP Error Responses - Transforms raw error responses into typed objects that include parsed bodies and status codes.
• Request Body Attachers - Allows attaching raw strings, JSON, or form-encoded data to the body of an HTTP request.
• Request Interception Middleware - Provides pipeline handlers for intercepting, validating, and modifying outgoing network traffic.
• HTTP Middleware Pipelines - Implements a middleware system for extending request and response logic through modular add-ons and programmable pipelines.
• API Response Processing - Executes a programmable sequence of tasks on every incoming response to automate parsing and transformation.
• URL Construction - Provides dynamic construction of request URLs by appending path segments to a base URL.
• Request Timeouts - Limits the duration of outgoing network requests to prevent application hangs from orphaned connections.
• Request Retries - Automatically re-attempts failed network requests using configurable retry logic to improve reliability.
• Request Cancellations - Utilizes AbortController signals to implement request timeouts and manual cancellation of pending network transfers.
• Request Abort Signals - Allows cancelling pending network requests immediately using AbortController signals to recover resources.
• Request Workflow Extensions - Integrates hooks and plugin systems to add custom tasks and modify behavior throughout the network request lifecycle.
• Exponential Backoff Retries - Implements exponential backoff strategies to prevent server overload during automatic request retries.
• Automatic Token Refreshes - Intercepts unauthorized responses to refresh credentials and automatically retry the original request.
• Global Error Handlers - Implements a single-point exception processor to catch failures across the network request pipeline and provide recovery logic.
• Core Capability Extensions - Allows extending the fundamental operational logic of the HTTP client through a modular addon system.
• Response Schema Validators - Passes incoming response data through schema validators to ensure the output matches expected types.
• Plugin-Based Extensibility - Provides a modular registration mechanism to add new capabilities to request and response objects via plugins.
• Automatic Task Retries - Implements automatic re-execution of failed network calls using configurable retry logic and skip rules.
• Automatic FormData Conversions - Provides automatic conversion of JavaScript objects into FormData for easier file and form uploads.
• Multipart Uploads - Implements client-side encoding of multipart/form-data bodies to support file uploads and complex form submissions.
• Network Error Identification - Differentiates between low-level network failures, such as connection timeouts, and standard HTTP status code errors.
• HTTP Request Managers - Offers utilities for complex HTTP tasks such as upload progress tracking, request deduplication, and response caching.
• Global Payload Transformers - Modifies the structure or casing of data sent to or received from an API globally via middleware.
• URL-Encoded Serializers - Converts input objects into URL-encoded strings and automatically sets the required content-type header.
• Request Deduplication - Collapses multiple identical outgoing requests into a single execution to prevent redundant network calls.
• Response Caching - Stores server responses for a set time and serves them for later requests to lower network traffic.
• API Clients and Utilities - Intuitive wrapper for the Fetch API.
• API Clients - Small fetch wrapper with intuitive syntax.
• API Layer - Chainable fetch wrapper with built-in error handling.
• Web Frameworks - Tiny wrapper around fetch with an intuitive syntax.

Star history