chore: release v0.19.0

[zedrdave]

Summary

Release v0.19.0 with improved response type semantics and optimized import handling.

Changes

Added

• Unified Response Types: All responses (GET, POST, PATCH, DELETE) now use a single, consistent type
• Strict Response Option: New --use-strict-response CLI flag to control whether all fields are required
  • Default: ApiResponse (ALL fields required, matches typical API behavior)
  • Opt-in: ApiResponseStrict (only readonly/required fields required)

Fixed

• Import Optimization: Generated API client files now import only the required response type (ApiResponse or ApiResponseStrict) instead of always importing both, preventing noUnusedLocals lint errors in strict TypeScript projects
• Semantic Clarity: Clarified that readonly fields only affect request bodies (mutations), not response types
• Documentation: Updated all help text and README examples to reflect correct type semantics

Changed

• Breaking: Removed ApiResponseSafe type (use ApiResponseStrict instead)
• Breaking: Removed --use-query-safe-response flag (replaced with --use-strict-response)
• Response typing is now consistent across ALL operations regardless of HTTP method

Related Issues

• Addresses Copilot review feedback on unused import handling
• Based on feature/query-safe-response-by-default branch

Testing

• All 342 tests passing
• Validated with npm run lint, npm run types, npm run test:run

[Copilot]

Pull request overview

Prepares the v0.19.0 release of the library and introduces a new CLI flag intended to control “query-safe” (readonly-required) response typing for GET operations during code generation.

Changes:

• Add --use-query-safe-response / --no-use-query-safe-response option parsing, help text, and plumbing into api-types.ts generation.
• Bump package version to 0.19.0 and update README npm badge.
• Add a 0.19.0 entry to the changelog.

Reviewed changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/cli.ts	Adds the new CLI flag, updates usage text, and passes the flag into generateApiTypesContent.
package.json	Version bump to 0.19.0.
package-lock.json	Lockfile version metadata updated to 0.19.0.
README.md	Updates npm badge cache-busting version parameter to 0.19.0.
CHANGELOG.md	Adds the 0.19.0 release entry documenting the new flag.

[Copilot]

Pull request overview

Copilot reviewed 15 out of 15 changed files in this pull request and generated 3 comments.

Comments suppressed due to low confidence (1)

src/cli.ts:1404

• When useStrictResponse is enabled, the generated api-client import list still includes ApiResponse even though all generated Response aliases use ApiResponseStrict. In consumer projects with noUnusedLocals/lint rules enabled, this can make the generated file fail to compile. Consider emitting only the selected response type in the import (either ApiResponse or ApiResponseStrict) based on useStrictResponse.

import type {
  ApiResponse${useStrictResponse ? ',\n  ApiResponseStrict' : ''},
  ApiRequest,
  ApiPathParams,
  ApiPathParamsInput,
  ApiQueryParams,
  operations,
} from './api-operations.js'