@zap-studio/fetch 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1]
+
+### Changed
+
+`@zap-studio/logger` is now an optional peer dependency instead of a regular dependency. Every import from it is type-only (`import type { Logger }`), so it was never pulled in at runtime — pass any object matching the `Logger` shape (including `pino`) with no install required. Existing consumers of `logger?: Logger` are unaffected.
+
 ## [1.1.0]
 
 ### Added

package/README.md

@@ -4,6 +4,16 @@ A small fetch wrapper with [**Standard Schema**](https://standardschema.dev/sche
 
 Full documentation: [zapstudio.dev/fetch](https://www.zapstudio.dev/fetch)
 
+## Motivation
+
+Raw `fetch` does not throw on HTTP errors like 404 or 500 — you must check `response.ok` yourself. And it does not check that the JSON body matches what your code expects.
+
+So most projects add the same pattern at every call site: check the status, parse the JSON, then validate it with `schema.parse(await res.json())`. It is easy to forget one of these steps somewhere, and that is how bad data or a network error goes unnoticed until it breaks something downstream.
+
+`@zap-studio/fetch` makes this pattern the default, not something you write by hand. `api.get(url, UserSchema)` checks the response, validates the body, and throws a clear, typed error — `FetchError` for a bad HTTP status, `ValidationError` for a bad shape — so you always know what went wrong and where.
+
+It uses [Standard Schema](https://standardschema.dev/schema), so you are not locked into one validation library: start with Zod, move to Valibot later, and the call sites do not change. And because it only wraps the global `fetch` function, it is not a Node-only HTTP client — it runs the same way on Bun, Deno, Cloudflare Workers, and in the browser.
+
 ## Installation
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zap-studio/fetch",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "private": false,
   "description": "A type-safe, tree-shakeable fetch wrapper for HTTP requests with runtime schema validation.",
   "keywords": [
@@ -46,8 +46,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@zap-studio/validation": "1.0.0",
-    "@zap-studio/logger": "1.0.0"
+    "@zap-studio/validation": "1.0.0"
   },
   "devDependencies": {
     "arktype": "^2.2.3",
@@ -56,8 +55,17 @@
     "valibot": "^1.4.2",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
+    "@zap-studio/logger": "1.0.0",
     "@zap-studio/typescript": "0.0.0"
   },
+  "peerDependencies": {
+    "@zap-studio/logger": "1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@zap-studio/logger": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=18.0.0"
   }