hanzio 2.1.0 → 2.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kristoffer Hansen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1156,9 +1156,8 @@ bun run build
 
 ## Releasing
 
-Releases are cut by [Release Please](https://github.com/googleapis/release-please)
-from squash-merged PR titles written as conventional commits. `feat:` bumps the
-minor version, `fix:` the patch, `feat!:` or a `BREAKING CHANGE:` footer the
-major. `chore:`, `ci:`, `docs:`, `refactor:` and `test:` do not release. Each
-merge to main updates a release PR; merging that PR tags the version and
-publishes to npm. Nobody runs `npm publish` locally.
+Squash PRs with conventional titles (`fix:`, `feat:`, or `feat!:`). Release Please keeps the version and changelog in a release PR; merge that PR to publish with release notes and npm provenance. See [release and recovery instructions](docs/releasing.md).
+
+## License
+
+[MIT](LICENSE).

package/dist/api-wrapper/endpoint.d.ts

@@ -1,10 +1,11 @@
 import type { z } from 'zod';
-import type { ApiEndpoint } from './types';
+import type { ApiEndpoint, CheckResponseContext } from './types';
 /**
  * Defines an endpoint with full inference, as an alternative to
  * `satisfies ApiEndpoint`: `resFormatter` must return what `resSchema`
- * accepts, and a literal `path` types its `:params` (making `reqParams`
- * required when there's no `reqParamsSchema`).
+ * accepts, `checkResponse` receives the parsed `resSchema` output, and a
+ * literal `path` types its `:params` (making `reqParams` required when
+ * there's no `reqParamsSchema`).
  *
  * @example
  * export const usersGet = defineEndpoint({
@@ -13,6 +14,8 @@ import type { ApiEndpoint } from './types';
  *   resSchema: User
  * })
  */
-export declare function defineEndpoint<const TEndpoint extends ApiEndpoint>(endpoint: TEndpoint & {
-    resFormatter?: (data: unknown, headers: Record<string, string>) => z.input<TEndpoint['resSchema']>;
+export declare function defineEndpoint<const TEndpoint extends Omit<ApiEndpoint, 'checkResponse'>, TRes extends z.ZodType = TEndpoint['resSchema']>(endpoint: TEndpoint & {
+    resSchema: TRes;
+    resFormatter?: (data: unknown, headers: Record<string, string>) => z.input<TRes>;
+    checkResponse?: ((data: z.output<TRes>, context: CheckResponseContext) => void | Promise<void>) | false;
 }): TEndpoint;

package/dist/api-wrapper/transport.d.ts

@@ -49,6 +49,7 @@ export declare function makeRequestWithRetry<TValidated>(args: MakeRequestArgs<T
 export declare function validateAndTransformResponse<T extends z.ZodType>(endpoint: ApiEndpoint<z.ZodType | undefined, z.ZodType | undefined, z.ZodType | undefined, z.ZodType | undefined, T>, response: Response, ctx: (over?: Partial<ApiErrorContext>) => ApiErrorContext): Promise<{
     data: z.infer<T>;
     responseSizeBytes: number;
+    headers: Record<string, string>;
 }>;
 export declare function defaultShouldRetry(ctx: RetryContext): boolean;
 export {};

package/dist/api-wrapper/types.d.ts

@@ -17,6 +17,11 @@ export interface ApiEndpoint<TReqBody extends z.ZodType | undefined = z.ZodType
     resFormatter?: (data: unknown, headers: Record<string, string>) => z.input<TResponse>;
     reqDefaultQueryParams?: QueryParams;
     doNotEncodeQueryParams?: boolean;
+    /**
+     * Replaces the client's `checkResponse` for this endpoint; `false` skips it.
+     * `defineEndpoint` types `data` as the parsed `resSchema` output.
+     */
+    checkResponse?: ((data: any, context: CheckResponseContext) => void | Promise<void>) | false;
 }
 export interface ApiWrapperResponse<T> {
     data: T;
@@ -25,6 +30,8 @@ export interface ApiWrapperResponse<T> {
     responseTimeMs: number;
     httpStatus: number;
     retryCount: number;
+    /** Response headers of the final attempt, keyed by lowercase name. */
+    headers: Record<string, string>;
 }
 export type RetryContext = {
     error?: unknown;

package/dist/{index-j1ybktbr.js → index-zbj9s3s3.js}

@@ -1006,7 +1006,7 @@ async function validateAndTransformResponse(endpoint, response, ctx) {
   }
   const transformedData = endpoint.resFormatter ? endpoint.resFormatter(responseData, responseHeaders) : responseData;
   const data = await validateResponse(endpoint.resSchema, transformedData, ctx);
-  return { data, responseSizeBytes };
+  return { data, responseSizeBytes, headers: responseHeaders };
 }
 function defaultShouldRetry2(ctx) {
   if (ctx.error)
@@ -1170,14 +1170,16 @@ function createApiClientImpl(apiConfig) {
         responseSizeMb: result.validatedData.responseSizeBytes / (1024 * 1024),
         responseTimeMs: elapsed(),
         httpStatus: result.httpStatus,
-        retryCount: result.retryCount
+        retryCount: result.retryCount,
+        headers: result.validatedData.headers
       };
     };
     const runCheckResponse = async (data, httpStatus, attempt) => {
-      if (!apiConfig.checkResponse)
+      const checkResponse = endpoint.checkResponse === undefined ? apiConfig.checkResponse : endpoint.checkResponse;
+      if (!checkResponse)
         return;
       try {
-        await apiConfig.checkResponse(data, {
+        await checkResponse(data, {
           endpoint: endpointName,
           method: endpoint.method,
           url: fullUrl,

package/dist/src/api-wrapper/index.js

@@ -28,7 +28,7 @@ import {
   paginate2,
   otelMiddleware2,
   defineEndpoint2
-} from "../../index-j1ybktbr.js";
+} from "../../index-zbj9s3s3.js";
 export {
   ActionError2 as ActionError,
   ApiError2 as ApiError,

package/dist/src/secrets/index.js

@@ -1,7 +1,7 @@
 import {
   HttpResponseError2,
   createApiClient2
-} from "../../index-j1ybktbr.js";
+} from "../../index-zbj9s3s3.js";
 import {
   getViteDefine2,
   viteSecretSetPlugin2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hanzio",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "A lightweight set of utility functions for TypeScript",
   "type": "module",
   "module": "./dist/src/index.js",
@@ -25,6 +25,7 @@
   },
   "files": [
     "src/**/*.ts",
+    "src/**/README.md",
     "dist",
     "!src/**/*.test.ts"
   ],
@@ -132,7 +133,8 @@
     "typecheck": "tsgo --noEmit",
     "prepare": "husky",
     "test:secrets:runtime": "bun run build && node scripts/verify-secrets.mjs",
-    "test:exports": "bun run build && node scripts/verify-exports.mjs"
+    "test:exports": "bun run build && node scripts/verify-exports.mjs",
+    "verify:package": "node scripts/verify-package.mjs"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.6",
@@ -152,5 +154,10 @@
     "zod": {
       "optional": true
     }
-  }
+  },
+  "homepage": "https://github.com/HansKristoffer/hanzio#readme",
+  "bugs": {
+    "url": "https://github.com/HansKristoffer/hanzio/issues"
+  },
+  "packageManager": "bun@1.4.2"
 }