typedapi-client-helpers 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,68 +1,71 @@
-# Changelog
-
-All notable changes to `typedapi-client-helpers` are documented in this file.
-
-## [0.3.0] - 2026-07-10
-
-### Added
-
-* Added serializer-aware wire mapping through `toWireValue()` and `fromWireValue()`.
-* Added support for exact OpenAPI property names in JSON bodies, multipart forms, query parameters, headers, cookies, path parameters, responses, and documented error bodies.
-* Added support for path, query, header, cookie, and request-body inputs in the same operation.
-* Added typed unions for documented non-success response bodies.
-* Added structured client errors for network failures, aborted requests, and malformed responses.
-* Added support for local OpenAPI `$ref` values in schemas, parameters, path items, request bodies, and responses.
-* Added support for `allOf` schemas with additional local properties.
-* Added configurable frontend method naming through `typedApiMethodNameStyle`.
-* Added `typedApiPrefixMethodNamesWithController` for controller-prefixed action names.
-* Added controller-name fallback detection from TypedApi metadata, OpenAPI tags, and route paths.
-* Added generated root `index.ts` barrel exports.
-* Added `typedapi.manifest.json` containing generator, contract, source, and naming information.
-* Added `--check`, `--strict`, `--offline`, and `--verbose` generator modes.
-* Added configurable Swagger download timeouts.
-* Added global and per-request timeout support.
-* Added support for external `AbortSignal` values and combined cancellation signals.
-* Added header and cookie utilities through `mergeHeaders()`, `toRequestHeaders()`, and `toCookieHeader()`.
-* Added automated generator and runtime tests.
-
-### Changed
-
-* Generated TypeScript property names now lowercase only the first character while preserving the remainder of the OpenAPI name.
-* Generated operation IDs and TypeScript identifiers are validated and sanitized before files are written.
-* Missing operation IDs now cause a clear error by default.
-* Missing operation IDs can optionally be generated with `typedApiGenerateMissingOperationIds`.
-* Action-based names can include the controller name by default, preventing collisions between actions with the same name in different controllers.
-* Controller prefixes are not duplicated when an action name already begins with the controller name.
-* Generated method signatures now keep non-body parameters, request bodies, and request options in predictable argument groups.
-* Body-only operations now accept their payload directly without an additional request wrapper.
-* Query-only and paginated operations now use more specific generated query types.
-* Documented backend errors are returned alongside structured TypedApi client errors.
-* Malformed JSON is now returned as a structured parse error instead of being cast to the expected response type.
-* Exceptions thrown by consumer `onSuccess` and `onError` callbacks now propagate normally.
-* Fetch header merging now uses the native `Headers` implementation.
-* File, Blob, FormData, and multipart handling is safer in SSR and Node.js environments.
-* Binary image, PDF, and octet-stream responses are handled as blobs.
-* The package build now uses a deterministic TypeScript-only ESM, CommonJS, and declaration build instead of a bundler-dependent build.
-
-### Fixed
-
-* Fixed generated-output replacement failures caused by transient Windows filesystem locks.
-* Added retries for filesystem errors encountered while replacing generated output.
-* Added rollback-protected managed-file synchronization when `src/api` cannot be renamed because an editor, TypeScript watcher, antivirus scanner, or development server holds a directory handle.
-* Preserved unmanaged files during fallback synchronization.
-* Removed stale TypedApi-generated files during fallback synchronization.
-* Fixed handling of cancel token `0`.
-* Fixed abort-controller cleanup after completed requests.
-* Fixed URLs that already contain query strings.
-* Fixed absolute URL handling.
-* Fixed duplicate generated method and type names after TypeScript normalization.
-* Fixed property-name collisions caused by first-character normalization.
-
-### Migration notes
-
-* OpenAPI 3.x is now required. Swagger 2.0 documents are rejected.
-* Regenerated method names, parameter types, property names, and method signatures may differ from version `0.2.1`.
-* Projects using `typedApiMethodNameStyle: "action"` receive controller-prefixed names by default.
-* Set `typedApiPrefixMethodNamesWithController` to `false` to generate action-only names.
-* Set `typedApiGenerateMissingOperationIds` to `true` only when operation IDs cannot be supplied by the backend.
-* Regenerate and review committed API files after upgrading.
+# Changelog
+
+All notable changes to `typedapi-client-helpers` are documented in this file.
+
+## [0.3.0] - 2026-07-10
+
+### Added
+
+* Added serializer-aware wire mapping through `toWireValue()` and `fromWireValue()`.
+* Added support for exact OpenAPI property names in JSON bodies, multipart forms, query parameters, headers, cookies, path parameters, responses, and documented error bodies.
+* Added support for path, query, header, cookie, and request-body inputs in the same operation.
+* Added typed unions for documented non-success response bodies.
+* Added structured client errors for network failures, aborted requests, and malformed responses.
+* Added `ApiHttpError` for operations without a documented OpenAPI error schema.
+* Added support for local OpenAPI `$ref` values in schemas, parameters, path items, request bodies, and responses.
+* Added support for `allOf` schemas with additional local properties.
+* Added configurable frontend method naming through `typedApiMethodNameStyle`.
+* Added `typedApiPrefixMethodNamesWithController` for controller-prefixed action names.
+* Added controller-name fallback detection from TypedApi metadata, OpenAPI tags, and route paths.
+* Added `--check`, `--strict`, `--offline`, and `--verbose` generator modes.
+* Added configurable Swagger download timeouts.
+* Added global and per-request timeout support.
+* Added support for external `AbortSignal` values and combined cancellation signals.
+* Added header and cookie utilities through `mergeHeaders()`, `toRequestHeaders()`, and `toCookieHeader()`.
+* Added automated generator and runtime tests.
+
+### Changed
+
+* Generated TypeScript property names now lowercase only the first character while preserving the remainder of the OpenAPI name.
+* Generated operation IDs and TypeScript identifiers are validated and sanitized before files are written.
+* Missing operation IDs now cause a clear error by default.
+* Missing operation IDs can optionally be generated with `typedApiGenerateMissingOperationIds`.
+* Action-based names can include the controller name by default, preventing collisions between actions with the same name in different controllers.
+* Controller prefixes are not duplicated when an action name already begins with the controller name.
+* Generated method signatures now keep non-body parameters, request bodies, and request options in predictable argument groups.
+* Generated methods now use `ApiHttpError` instead of `unknown` when no backend error schema is documented.
+* Generated API output no longer contains a root `index.ts`; methods and contracts are imported directly from their generated files.
+* Body-only operations now accept their payload directly without an additional request wrapper.
+* Query-only and paginated operations now use more specific generated query types.
+* Documented backend errors are returned alongside structured TypedApi client errors.
+* Malformed JSON is now returned as a structured parse error instead of being cast to the expected response type.
+* Exceptions thrown by consumer `onSuccess` and `onError` callbacks now propagate normally.
+* Fetch header merging now uses the native `Headers` implementation.
+* File, Blob, FormData, and multipart handling is safer in SSR and Node.js environments.
+* Binary image, PDF, and octet-stream responses are handled as blobs.
+* The package build now uses a deterministic TypeScript-only ESM, CommonJS, and declaration build instead of a bundler-dependent build.
+
+### Fixed
+
+* Fixed generated-output replacement failures caused by transient Windows filesystem locks.
+* Added retries for filesystem errors encountered while replacing generated output.
+* Added rollback-protected managed-file synchronization when `src/api` cannot be renamed because an editor, TypeScript watcher, antivirus scanner, or development server holds a directory handle.
+* Preserved unmanaged files during fallback synchronization.
+* Removed stale TypedApi-generated files during fallback synchronization.
+* Removed previously generated root `index.ts` files during regeneration.
+* Fixed handling of cancel token `0`.
+* Fixed abort-controller cleanup after completed requests.
+* Fixed URLs that already contain query strings.
+* Fixed absolute URL handling.
+* Fixed duplicate generated method and type names after TypeScript normalization.
+* Fixed property-name collisions caused by first-character normalization.
+
+### Migration notes
+
+* OpenAPI 3.x is now required. Swagger 2.0 documents are rejected.
+* Regenerated method names, parameter types, property names, and method signatures may differ from version `0.2.1`.
+* Projects using `typedApiMethodNameStyle: "action"` receive controller-prefixed names by default.
+* Set `typedApiPrefixMethodNamesWithController` to `false` to generate action-only names.
+* Set `typedApiGenerateMissingOperationIds` to `true` only when operation IDs cannot be supplied by the backend.
+* Import methods from `src/api/methods/*.api.ts` and contracts from `src/api/generated/data-contracts.ts` instead of using `src/api/index.ts`.
+* Regenerate and review committed API files after upgrading; regeneration removes the old generated root `index.ts`.

package/README.md

@@ -4,14 +4,15 @@ A small Fetch runtime and OpenAPI 3 TypeScript generator designed to work with `
 
 ## Version 0.3 highlights
 
-- Lowercases only the first character of generated TypeScript members while preserving exact OpenAPI names on the wire.
+- Lowercases only the first character of generated TypeScript members.
 - Sanitizes operation IDs and rejects duplicates before writing output.
 - Can name frontend functions from either the unique OpenAPI operation ID or the original ASP.NET controller action name.
 - Supports path, query, header, cookie, and request-body inputs in the same operation.
 - Resolves local OpenAPI references for schemas, parameters, request bodies, and responses.
 - Supports `allOf` composition with local properties.
 - Generates typed unions for documented non-success responses.
-- Produces `index.ts` and `typedapi.manifest.json`.
+- Uses a structured `ApiHttpError` when an operation has no documented error schema.
+- Generates API contracts and controller method files without creating a root API barrel file.
 - Writes generated output transactionally, with a Windows-safe in-place fallback when directory renames are blocked by editors or file watchers.
 - Adds `--check`, `--strict`, `--offline`, and `--verbose` CLI modes.
 - Improves cancellation, timeouts, header merging, SSR safety, and malformed-response handling.
@@ -60,13 +61,18 @@ src/api/
 ├── generated/
 │   ├── data-contracts.ts
 │   └── http-client.ts
-├── methods/
-│   └── Products.api.ts
-├── index.ts
-└── typedapi.manifest.json
+└── methods/
+    └── Products.api.ts
 ```
 
-The Swagger backup belongs to the consuming project, not this npm package.
+The generator intentionally does not create `src/api/index.ts`. Import generated methods and contracts directly from their files:
+
+```ts
+import { getProducts } from "./api/methods/Product.api";
+import type { ProductModel } from "./api/generated/data-contracts";
+```
+
+When upgrading from an earlier 0.3.0 build, the next generation removes the old generated `src/api/index.ts`. The Swagger backup belongs to the consuming project, not this npm package.
 
 ## Frontend method names
 
@@ -150,8 +156,8 @@ The generated signature is:
 export async function updateWarehouse(
   pathParams: UpdateWarehouseParams,
   data: WarehouseRequest,
-  options: ApiMethodOptions<WarehouseModel, unknown, RequestParams> = {},
-): Promise<ApiResult<WarehouseModel, unknown>>;
+  options: ApiMethodOptions<WarehouseModel, ApiHttpError, RequestParams> = {},
+): Promise<ApiResult<WarehouseModel, ApiHttpError>>;
 ```
 
 Path operations without a body use only the params object:
@@ -184,15 +190,18 @@ await updateWarehouse(pathParams, data, {
 
 ## Typed errors
 
-When the OpenAPI document describes error response bodies, generated methods expose their union:
+When the OpenAPI document describes error response bodies, generated methods expose their generated type or union. When no error schema is documented, the method uses `ApiHttpError` instead of `unknown`:
 
 ```ts
-const result = await createProduct(body);
+const result = await cancelOrder({ id, reason });
 
 if (!result.ok) {
-  // Documented backend error type or a TypedApi client error:
-  // network, aborted, or parse.
-  console.error(result.error);
+  if (result.error.kind === "http") {
+    console.error(result.error.status, result.error.body);
+  } else {
+    // Structured TypedApi client error: network, aborted, or parse.
+    console.error(result.error);
+  }
 }
 ```
 
@@ -214,7 +223,7 @@ configureApiClient({
 setSecurityData("access-token");
 ```
 
-The runtime also exports `createApiClient`, `request`, `abortRequest`, `mergeHeaders`, `toRequestHeaders`, `toCookieHeader`, `handleApiResponse`, `buildQuery`, `toFormData`, `toWireValue`, and `fromWireValue`.
+The runtime also exports `createApiClient`, `request`, `abortRequest`, `mergeHeaders`, `toRequestHeaders`, `toCookieHeader`, `handleApiResponse`, `buildQuery`, `toFormData`.
 
 ## Backend pairing
 

package/dist/cjs/index.js

@@ -21,12 +21,8 @@ __exportStar(require("./interfaces/SortType"), exports);
 __exportStar(require("./types/ApiMethodTypes"), exports);
 __exportStar(require("./types/ApiCallOptions"), exports);
 __exportStar(require("./types/ApiMethodOptions"), exports);
-__exportStar(require("./types/ApiMethodArguments"), exports);
 __exportStar(require("./utils/buildQuery"), exports);
-__exportStar(require("./utils/extractArgsToastsAndParams"), exports);
-__exportStar(require("./utils/extractArgsCallbacksAndParams"), exports);
 __exportStar(require("./utils/handleApiResponse"), exports);
 __exportStar(require("./utils/SortTypeFromSortDirection"), exports);
 __exportStar(require("./utils/toFormData"), exports);
-__exportStar(require("./utils/wireMapping"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAE7B,yDAAuC;AACvC,sDAAoC;AACpC,wDAAsC;AAEtC,yDAAuC;AACvC,yDAAuC;AACvC,2DAAyC;AACzC,6DAA2C;AAE3C,qDAAmC;AACnC,qEAAmD;AACnD,wEAAsD;AACtD,4DAA0C;AAC1C,oEAAkD;AAClD,qDAAmC;AACnC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAE7B,yDAAuC;AACvC,sDAAoC;AACpC,wDAAsC;AAEtC,yDAAuC;AACvC,yDAAuC;AACvC,2DAAyC;AAEzC,qDAAmC;AACnC,4DAA0C;AAC1C,oEAAkD;AAClD,qDAAmC"}

package/dist/cjs/utils/handleApiResponse.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApiHttpError = createApiHttpError;
 exports.handleApiResponse = handleApiResponse;
+const defaultUnknownErrorMessage = "An unknown error occurred.";
 class ResponseParseError extends Error {
     constructor(status, rawBody, parseCause) {
         super(`Could not parse JSON response with status ${status}.`);
@@ -40,7 +42,14 @@ function isResponseLike(value) {
         "headers" in value &&
         typeof value.text === "function");
 }
-function clientError(error) {
+function createApiHttpError(status, body) {
+    return {
+        kind: "http",
+        status,
+        body: body,
+    };
+}
+function clientError(error, fallbackErrorMessage) {
     if (error instanceof ResponseParseError) {
         return {
             kind: "parse",
@@ -55,7 +64,7 @@ function clientError(error) {
     if (name === "AbortError" || name === "TimeoutError") {
         return { kind: "aborted", cause: error };
     }
-    return { kind: "network", cause: error };
+    return fallbackErrorMessage ?? defaultUnknownErrorMessage;
 }
 async function handleApiResponse(call, options) {
     let result;
@@ -77,7 +86,7 @@ async function handleApiResponse(call, options) {
                 ok: false,
                 status: response.status,
                 response: undefined,
-                error: clientError(error),
+                error: clientError(error, options?.fallbackErrorMessage),
             };
         }
     }
@@ -85,9 +94,12 @@ async function handleApiResponse(call, options) {
         if (isResponseLike(error)) {
             try {
                 const rawErrorData = await readResponseBody(error.clone());
-                const errorData = options?.transformError
-                    ? options.transformError(rawErrorData)
+                const transformedError = options?.transformError
+                    ? options.transformError(rawErrorData, error)
                     : rawErrorData;
+                const errorData = transformedError === undefined
+                    ? options?.fallbackErrorMessage ?? defaultUnknownErrorMessage
+                    : transformedError;
                 result = {
                     ok: false,
                     status: error.status,
@@ -100,7 +112,7 @@ async function handleApiResponse(call, options) {
                     ok: false,
                     status: error.status,
                     response: undefined,
-                    error: clientError(parseError),
+                    error: clientError(parseError, options?.fallbackErrorMessage),
                 };
             }
         }
@@ -109,7 +121,7 @@ async function handleApiResponse(call, options) {
                 ok: false,
                 status: 0,
                 response: undefined,
-                error: clientError(error),
+                error: clientError(error, options?.fallbackErrorMessage),
             };
         }
     }

package/dist/cjs/utils/handleApiResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleApiResponse.js","sourceRoot":"","sources":["../../../src/utils/handleApiResponse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handleApiResponse.js","sourceRoot":"","sources":["../../../src/utils/handleApiResponse.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -5,12 +5,8 @@ export * from "./interfaces/SortType.js";
 export * from "./types/ApiMethodTypes.js";
 export * from "./types/ApiCallOptions.js";
 export * from "./types/ApiMethodOptions.js";
-export * from "./types/ApiMethodArguments.js";
 export * from "./utils/buildQuery.js";
-export * from "./utils/extractArgsToastsAndParams.js";
-export * from "./utils/extractArgsCallbacksAndParams.js";
 export * from "./utils/handleApiResponse.js";
 export * from "./utils/SortTypeFromSortDirection.js";
 export * from "./utils/toFormData.js";
-export * from "./utils/wireMapping.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oBAAoB,CAAC"}

package/dist/esm/utils/handleApiResponse.js

@@ -1,3 +1,4 @@
+const defaultUnknownErrorMessage = "An unknown error occurred.";
 class ResponseParseError extends Error {
     constructor(status, rawBody, parseCause) {
         super(`Could not parse JSON response with status ${status}.`);
@@ -37,7 +38,14 @@ function isResponseLike(value) {
         "headers" in value &&
         typeof value.text === "function");
 }
-function clientError(error) {
+export function createApiHttpError(status, body) {
+    return {
+        kind: "http",
+        status,
+        body: body,
+    };
+}
+function clientError(error, fallbackErrorMessage) {
     if (error instanceof ResponseParseError) {
         return {
             kind: "parse",
@@ -52,7 +60,7 @@ function clientError(error) {
     if (name === "AbortError" || name === "TimeoutError") {
         return { kind: "aborted", cause: error };
     }
-    return { kind: "network", cause: error };
+    return fallbackErrorMessage ?? defaultUnknownErrorMessage;
 }
 export async function handleApiResponse(call, options) {
     let result;
@@ -74,7 +82,7 @@ export async function handleApiResponse(call, options) {
                 ok: false,
                 status: response.status,
                 response: undefined,
-                error: clientError(error),
+                error: clientError(error, options?.fallbackErrorMessage),
             };
         }
     }
@@ -82,9 +90,12 @@ export async function handleApiResponse(call, options) {
         if (isResponseLike(error)) {
             try {
                 const rawErrorData = await readResponseBody(error.clone());
-                const errorData = options?.transformError
-                    ? options.transformError(rawErrorData)
+                const transformedError = options?.transformError
+                    ? options.transformError(rawErrorData, error)
                     : rawErrorData;
+                const errorData = transformedError === undefined
+                    ? options?.fallbackErrorMessage ?? defaultUnknownErrorMessage
+                    : transformedError;
                 result = {
                     ok: false,
                     status: error.status,
@@ -97,7 +108,7 @@ export async function handleApiResponse(call, options) {
                     ok: false,
                     status: error.status,
                     response: undefined,
-                    error: clientError(parseError),
+                    error: clientError(parseError, options?.fallbackErrorMessage),
                 };
             }
         }
@@ -106,7 +117,7 @@ export async function handleApiResponse(call, options) {
                 ok: false,
                 status: 0,
                 response: undefined,
-                error: clientError(error),
+                error: clientError(error, options?.fallbackErrorMessage),
             };
         }
     }

package/dist/esm/utils/handleApiResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleApiResponse.js","sourceRoot":"","sources":["../../../src/utils/handleApiResponse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handleApiResponse.js","sourceRoot":"","sources":["../../../src/utils/handleApiResponse.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -5,12 +5,8 @@ export * from "./interfaces/SortType";
 export * from "./types/ApiMethodTypes";
 export * from "./types/ApiCallOptions";
 export * from "./types/ApiMethodOptions";
-export * from "./types/ApiMethodArguments";
 export * from "./utils/buildQuery";
-export * from "./utils/extractArgsToastsAndParams";
-export * from "./utils/extractArgsCallbacksAndParams";
 export * from "./utils/handleApiResponse";
 export * from "./utils/SortTypeFromSortDirection";
 export * from "./utils/toFormData";
-export * from "./utils/wireMapping";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,oBAAoB,CAAC"}

package/dist/types/interfaces/ApiResult.d.ts

@@ -1,3 +1,12 @@
+export type ApiHttpErrorBody = string | number | boolean | null | Blob | undefined | ApiHttpErrorBody[] | {
+    [key: string]: ApiHttpErrorBody;
+};
+/** An HTTP error response without a documented OpenAPI error schema. */
+export type ApiHttpError = {
+    kind: "http";
+    status: number;
+    body: ApiHttpErrorBody;
+};
 /** Errors created by the TypedApi runtime before a typed HTTP error body is available. */
 export type ApiClientError = {
     kind: "network";
@@ -21,7 +30,7 @@ export type ApiResult<TResponse, TError = unknown> = {
     ok: false;
     status: number;
     response?: undefined;
-    error: TError | ApiClientError;
+    error: TError | ApiClientError | string;
 };
 export type ApiSuccessResult<TResponse, TError = unknown> = Extract<ApiResult<TResponse, TError>, {
     ok: true;

package/dist/types/interfaces/ApiResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiResult.d.ts","sourceRoot":"","sources":["../../../src/interfaces/ApiResult.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEN,yEAAyE;AACzE,MAAM,MAAM,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,IAC7C;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;CAChC,CAAC;AAEN,MAAM,MAAM,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,IAAI,OAAO,CACjE,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,EAC5B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CACb,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,IAAI,OAAO,CAC/D,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,EAC5B;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CACd,CAAC"}
+{"version":3,"file":"ApiResult.d.ts","sourceRoot":"","sources":["../../../src/interfaces/ApiResult.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,SAAS,GACT,gBAAgB,EAAE,GAClB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAExC,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAEF,0FAA0F;AAC1F,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEN,yEAAyE;AACzE,MAAM,MAAM,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,IAC7C;IACE,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,CAAC;CACzC,CAAC;AAEN,MAAM,MAAM,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,IAAI,OAAO,CACjE,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,EAC5B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CACb,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,IAAI,OAAO,CAC/D,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,EAC5B;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CACd,CAAC"}

package/dist/types/types/ApiMethodOptions.d.ts

@@ -1,5 +1,5 @@
-import { ApiErrorHandler, ApiSuccessHandler } from "./ApiCallOptions";
-import { RuntimeRequestParams } from "./HttpResponse";
+import type { ApiErrorHandler, ApiSuccessHandler } from "./ApiCallOptions";
+import type { RuntimeRequestParams } from "./httpClientTypes";
 export type ApiMethodOptions<TResponse, TError = unknown, TRequestParams = RuntimeRequestParams> = {
     onSuccess?: ApiSuccessHandler<TResponse>;
     onError?: ApiErrorHandler<TResponse, TError>;

package/dist/types/types/ApiMethodOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiMethodOptions.d.ts","sourceRoot":"","sources":["../../../src/types/ApiMethodOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,gBAAgB,CAC1B,SAAS,EACT,MAAM,GAAG,OAAO,EAChB,cAAc,GAAG,oBAAoB,IACnC;IACF,SAAS,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,CAAC"}
+{"version":3,"file":"ApiMethodOptions.d.ts","sourceRoot":"","sources":["../../../src/types/ApiMethodOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,MAAM,gBAAgB,CAC1B,SAAS,EACT,MAAM,GAAG,OAAO,EAChB,cAAc,GAAG,oBAAoB,IACnC;IACF,SAAS,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,CAAC"}

package/dist/types/utils/handleApiResponse.d.ts

@@ -1,11 +1,13 @@
-import type { ApiResult } from "../interfaces/ApiResult";
+import type { ApiHttpError, ApiResult } from "../interfaces/ApiResult";
 import type { ApiErrorHandler, ApiSuccessHandler } from "../types/ApiCallOptions";
 import type { HttpResponse } from "../httpClient";
 export type HandleApiResponseOptions<TResponse, TError = unknown> = {
     onSuccess?: ApiSuccessHandler<TResponse>;
     onError?: ApiErrorHandler<TResponse, TError>;
     transformResponse?: (value: unknown) => TResponse;
-    transformError?: (value: unknown) => TError;
+    transformError?: (value: unknown, response: Response) => TError;
+    fallbackErrorMessage?: string;
 };
+export declare function createApiHttpError(status: number, body: unknown): ApiHttpError;
 export declare function handleApiResponse<TResponse, TError = unknown>(call: () => Promise<HttpResponse<TResponse, TError>>, options?: HandleApiResponseOptions<TResponse, TError>): Promise<ApiResult<TResponse, TError>>;
 //# sourceMappingURL=handleApiResponse.d.ts.map

package/dist/types/utils/handleApiResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handleApiResponse.d.ts","sourceRoot":"","sources":["../../../src/utils/handleApiResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,IAAI;IAClE,SAAS,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC;IAClD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAC7C,CAAC;AA0EF,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EACjE,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,EACpD,OAAO,CAAC,EAAE,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAAC,GACpD,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CA4DvC"}
+{"version":3,"file":"handleApiResponse.d.ts","sourceRoot":"","sources":["../../../src/utils/handleApiResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAoB,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,MAAM,MAAM,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,IAAI;IAClE,SAAS,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC;IAClD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC;IAChE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAoDF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CAM9E;AAwBD,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EACjE,IAAI,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,EACpD,OAAO,CAAC,EAAE,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAAC,GACpD,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CA+DvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typedapi-client-helpers",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Reusable typed OpenAPI client helpers.",
   "license": "MIT",
   "keywords": [
@@ -66,6 +66,7 @@
     "typedApiDefaultFunctionsPath": "src/defaultApiFunctions",
     "typedApiDefaultSuccessHandler": "handleGoodResult",
     "typedApiDefaultErrorHandler": "handleErrors",
+    "typedApiDefaultErrorMessage": "unknownErrorMessage",
     "typedApiDefaultResponseAsSuccess": false,
     "typedApiGenerateUnionEnums": false,
     "typedApiEnumNamesAsValues": false,