$ show zellwk/zl-fetch
zlFetch is a lightweight JavaScript library that wraps the native Fetch API with quality-of-life improvements. It automatically parses response bodies based on `Content-Type` (JSON, text, form-urlencoded, NDJSON, Blob), provides promise-based error handling that rejects on 4xx/5xx status codes, supports request aborting, and includes shorthand methods for GET, POST, PUT, PATCH, DELETE. The library also offers streaming capabilities (SSE, NDJSON, chunked transfer), an EventSource wrapper for server-sent events, query string helpers, authorization header helpers, and a `createZlFetch` factory for pre-configured instances. The code is modular, well-typed with JSDoc, and thoroughly tested across browser and Node.js environments using vitest.
The LLM identified 2 files worth highlighting for reuse:
Isolates the logic for building fetch request options: appending query parameters to the URL, setting the HTTP method, configuring headers (content-type based on body type, Authorization header for bearer/basic auth), and serializing the body (JSON for objects, form-urlencoded for strings). This module is self-contained (imports no internal modules) and could be extracted into a standalone helper for constructing fetch options with similar conventions.
Implements content-type-aware response parsing: detects JSON, NDJSON, SSE, chunked transfer, text, form-urlencoded, and binary Blobs; handles 204 No Content (null body); and provides streaming decoders for SSE and chunked data. The `handleChunkedStream` function buffers partial lines and handles JSON split across chunks. While it imports `parseSSE` from an external utility, the pattern of content-type-based dispatching and stream processing is a reusable architectural approach for fetch wrappers.