# Changelog All notable changes to `typedapi-client-helpers` are documented in this file. ## [0.3.5] - 2026-07-24 ### Added * Added support for `x-typedapi-filter-form` on non-paginated query endpoints. * Added `buildFilterQuery()` for converting `FilterFormValues` without adding pagination or sorting. * Generated filter-form methods now group normal query values and typed filter-form values inside a single `filterForm` argument. * The `filterForm.query` values are merged with the output of `buildFilterQuery(filterForm.filters)` before sending the request. * Optional-query endpoints default the complete `filterForm` argument to an empty object. ### Compatibility notes * Pair this package with `TypedApi.Swagger` 0.3.2 or newer to use `[TypedApiFilterForm]`. * Existing paginated method signatures and `buildQuery()` behaviour are unchanged. * Regenerate committed API files because filter-form endpoint signatures have changed. ## [0.3.4] - 2026-07-22 ### Added * Added support for `x-typedapi-generic` metadata and reusable TypeScript generic declarations. * Added exact generic substitutions for direct properties, array/collection items, dictionary values, and inherited generic wrappers. * Added discriminator mapping support with literal discriminator properties and frontend union types. * Added readable closed-generic reference handling such as `ApiPaginationResponseOfProjectModel` to `ApiPaginationResponse`. * Added generator coverage for custom generic envelopes, pagination, nullability combinations, polymorphism, schema IDs, typed errors, and TypeScript compilation. ### Changed * Requiredness and nullability now remain independent in generated property declarations. * Polymorphic base schemas now generate a separate `Base` contract plus a union of concrete variants. * Derived polymorphic schemas inherit from the base contract rather than from the union, preventing cyclic TypeScript types. * Inline `allOf` object fragments are emitted directly in intersections instead of creating unnecessary numbered helper interfaces. * Typed OpenAPI error responses are deduplicated into method-specific error unions. * TypedApi contract version 2 is now supported. ### Fixed * Fixed flattened inherited generic wrappers accidentally capturing the first concrete schema, such as generating `data: OrderModel[]` inside `ApiPaginationSortResponse`. * Fixed flattened generic inheritance being emitted as a duplicated standalone interface; annotated derived wrappers now preserve their reusable generic base intersection. * Invalid generic metadata with unused type parameters now fails with a clear error instead of emitting a misleading generic declaration. ### Compatibility notes * Pair this package with `TypedApi.Swagger` 0.3.1 or newer for all new features. * Regenerate committed API files after upgrading. * Generic reconstruction only occurs for schemas carrying `x-typedapi-generic`; ordinary closed generic schemas remain ordinary component types. ## [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`.