@viliaapro/apifetch 0.1.2 → 0.1.4

package/README.md

@@ -20,7 +20,7 @@ npm install @viliaapro/apifetch @standard-schema/spec http-status-codes zod
 ## Usage
 
 ```typescript
-import { apiFetch } from '@viliaapro/apifetch';
+import { apiFetch, handleResponse } from '@viliaapro/apifetch';
 import { StatusCodes } from 'http-status-codes';
 import { z } from 'zod';
 
@@ -89,6 +89,15 @@ try {
 
 Returns `Promise<R>` where `R` is inferred from the transform return types.
 
+### `handleResponse<R>(response, handlers)`
+
+| Parameter  | Type                  | Description                        |
+|------------|-----------------------|------------------------------------|
+| `response` | `Response`            | A fetch `Response` object          |
+| `handlers` | `ResponseHandlers<R>` | Map of status codes to handlers    |
+
+Returns `Promise<R>`. Useful when you already have a `Response` object from an external fetch client or middleware.
+
 ## License
 
 MIT

package/dist/index.d.mts

@@ -8,9 +8,9 @@ type ResponseHandlers<R> = {
     [S in number]?: StatusHandler<StandardSchemaV1, R>;
 };
 declare class ApiError extends Error {
-    readonly response?: Response | undefined;
-    get status(): number | undefined;
-    constructor(message: string, response?: Response | undefined, options?: ErrorOptions);
+    readonly response: Response;
+    get status(): number;
+    constructor(message: string, response: Response, options?: ErrorOptions);
 }
 declare class UnrecognizedStatusError extends ApiError {
     constructor(response: Response);
@@ -19,6 +19,7 @@ declare class MalformedResponseError extends ApiError {
     readonly issues: readonly StandardSchemaV1.Issue[];
     constructor(response: Response, issues: readonly StandardSchemaV1.Issue[]);
 }
+declare function handleResponse<R>(response: Response, handlers: ResponseHandlers<R>): Promise<R>;
 declare function apiFetch<R>(url: string, handlers: ResponseHandlers<R>, options?: RequestInit): Promise<R>;
 
-export { ApiError, MalformedResponseError, type ResponseHandlers, type StatusHandler, UnrecognizedStatusError, apiFetch };
+export { ApiError, MalformedResponseError, type ResponseHandlers, type StatusHandler, UnrecognizedStatusError, apiFetch, handleResponse };

package/dist/index.d.ts

@@ -8,9 +8,9 @@ type ResponseHandlers<R> = {
     [S in number]?: StatusHandler<StandardSchemaV1, R>;
 };
 declare class ApiError extends Error {
-    readonly response?: Response | undefined;
-    get status(): number | undefined;
-    constructor(message: string, response?: Response | undefined, options?: ErrorOptions);
+    readonly response: Response;
+    get status(): number;
+    constructor(message: string, response: Response, options?: ErrorOptions);
 }
 declare class UnrecognizedStatusError extends ApiError {
     constructor(response: Response);
@@ -19,6 +19,7 @@ declare class MalformedResponseError extends ApiError {
     readonly issues: readonly StandardSchemaV1.Issue[];
     constructor(response: Response, issues: readonly StandardSchemaV1.Issue[]);
 }
+declare function handleResponse<R>(response: Response, handlers: ResponseHandlers<R>): Promise<R>;
 declare function apiFetch<R>(url: string, handlers: ResponseHandlers<R>, options?: RequestInit): Promise<R>;
 
-export { ApiError, MalformedResponseError, type ResponseHandlers, type StatusHandler, UnrecognizedStatusError, apiFetch };
+export { ApiError, MalformedResponseError, type ResponseHandlers, type StatusHandler, UnrecognizedStatusError, apiFetch, handleResponse };

package/dist/index.js

@@ -23,7 +23,8 @@ __export(index_exports, {
   ApiError: () => ApiError,
   MalformedResponseError: () => MalformedResponseError,
   UnrecognizedStatusError: () => UnrecognizedStatusError,
-  apiFetch: () => apiFetch
+  apiFetch: () => apiFetch,
+  handleResponse: () => handleResponse
 });
 module.exports = __toCommonJS(index_exports);
 var ApiError = class extends Error {
@@ -33,7 +34,7 @@ var ApiError = class extends Error {
     this.name = this.constructor.name;
   }
   get status() {
-    return this.response?.status;
+    return this.response.status;
   }
 };
 var UnrecognizedStatusError = class extends ApiError {
@@ -47,11 +48,7 @@ var MalformedResponseError = class extends ApiError {
     this.issues = issues;
   }
 };
-async function apiFetch(url, handlers, options = {}) {
-  const response = await fetch(url, {
-    ...options,
-    headers: { "Content-Type": "application/json", ...options.headers }
-  });
+async function handleResponse(response, handlers) {
   const handler = handlers[response.status];
   if (!handler) {
     throw new UnrecognizedStatusError(response);
@@ -63,10 +60,18 @@ async function apiFetch(url, handlers, options = {}) {
   }
   return handler.transform(result.value);
 }
+async function apiFetch(url, handlers, options = {}) {
+  const response = await fetch(url, {
+    ...options,
+    headers: { "Content-Type": "application/json", ...options.headers }
+  });
+  return handleResponse(response, handlers);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApiError,
   MalformedResponseError,
   UnrecognizedStatusError,
-  apiFetch
+  apiFetch,
+  handleResponse
 });

package/dist/index.mjs

@@ -6,7 +6,7 @@ var ApiError = class extends Error {
     this.name = this.constructor.name;
   }
   get status() {
-    return this.response?.status;
+    return this.response.status;
   }
 };
 var UnrecognizedStatusError = class extends ApiError {
@@ -20,11 +20,7 @@ var MalformedResponseError = class extends ApiError {
     this.issues = issues;
   }
 };
-async function apiFetch(url, handlers, options = {}) {
-  const response = await fetch(url, {
-    ...options,
-    headers: { "Content-Type": "application/json", ...options.headers }
-  });
+async function handleResponse(response, handlers) {
   const handler = handlers[response.status];
   if (!handler) {
     throw new UnrecognizedStatusError(response);
@@ -36,9 +32,17 @@ async function apiFetch(url, handlers, options = {}) {
   }
   return handler.transform(result.value);
 }
+async function apiFetch(url, handlers, options = {}) {
+  const response = await fetch(url, {
+    ...options,
+    headers: { "Content-Type": "application/json", ...options.headers }
+  });
+  return handleResponse(response, handlers);
+}
 export {
   ApiError,
   MalformedResponseError,
   UnrecognizedStatusError,
-  apiFetch
+  apiFetch,
+  handleResponse
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viliaapro/apifetch",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "A typed fetch wrapper with Standard Schema validation and status-code dispatch",
   "main": "dist/index.cjs",
   "module": "dist/index.js",