@theholocron/http-client 1.58.0-alpha.1 → 1.58.0-alpha.3

package/dist/index.d.mts

@@ -111,6 +111,12 @@ interface RequestOptions {
   query?: Record<string, string>;
   /** Return `undefined` without parsing even on a 200 response. */
   expectNoContent?: boolean;
+  /**
+   * Called with the response headers of a successful (2xx) response, before the body is read. For a value the
+   * vendor returns in a header rather than the body (GitHub's token expiry). A failed response throws as before
+   * and does not call it.
+   */
+  onResponse?: (headers: Headers) => void;
 }
 interface RestClient {
   readonly baseUrl: string;

package/dist/index.mjs

@@ -213,6 +213,7 @@ function createRestClient(config) {
 				path,
 				status: res.status
 			}, "response");
+			opts.onResponse?.(res.headers);
 			if (opts.expectNoContent || res.status === 204) return void 0;
 			const text = await res.text();
 			if (!text) return void 0;

package/dist/testing.d.mts

@@ -8,6 +8,7 @@ export declare function stubFetch(responses: Array<{
   status?: number;
   body?: unknown;
   text?: string;
+  headers?: Record<string, string>;
 }>): {
   fetch: typeof fetch;
   calls: FetchCall[];

package/dist/testing.mjs

@@ -21,9 +21,15 @@ function stubFetch(responses) {
 				body: {}
 			};
 			const status = next.status ?? 200;
-			if (status === 204) return new Response(null, { status });
+			if (status === 204) return new Response(null, {
+				status,
+				headers: next.headers
+			});
 			const text = next.text ?? JSON.stringify(next.body ?? {});
-			return new Response(text, { status });
+			return new Response(text, {
+				status,
+				headers: next.headers
+			});
 		}),
 		calls
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/http-client",
-  "version": "1.58.0-alpha.1",
+  "version": "1.58.0-alpha.3",
   "description": "Shared HTTP primitives for theholocron — REST client factory, auth resolver, and error types",
   "keywords": [
     "typescript",
@@ -36,8 +36,8 @@
     "dist"
   ],
   "dependencies": {
-    "@theholocron/observability": "^0.6.1-alpha.1",
-    "@theholocron/env-utils": "^1.16.1-alpha.1"
+    "@theholocron/env-utils": "^1.16.1-alpha.1",
+    "@theholocron/observability": "^0.6.1-alpha.1"
   },
   "devDependencies": {
     "@types/node": "^26",
@@ -49,10 +49,10 @@
     "tsdown": "^0.23.3",
     "typescript": "^5.9.3",
     "vitest": "^5.0.5",
-    "@theholocron/eslint-config": "^8.9.0-alpha.3",
+    "@theholocron/tsconfig": "^8.9.0-alpha.3",
     "@theholocron/tsdown-config": "^8.9.0-alpha.3",
-    "@theholocron/vitest-config": "^8.9.0-alpha.3",
-    "@theholocron/tsconfig": "^8.9.0-alpha.3"
+    "@theholocron/eslint-config": "^8.9.0-alpha.3",
+    "@theholocron/vitest-config": "^8.9.0-alpha.3"
   },
   "peerDependencies": {
     "vitest": ">=4.0.0"