Skip to main content

Changelog

All notable changes to this project are documented here. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Latest Release

The latest version is v1.27.7. See the GitHub Releases page for downloads and detailed release notes.

1.27.7 (2025-10-12)​

🐛 Bug Fixes​

  • transformer: prevent empty include syntax in generated schemas (3d1349b)

1.27.6 (2025-10-10)​

🐛 Bug Fixes​

  • core: use Zod v4 getter recursion and keep z.lazy for v3\n\n- Apply getter-based recursion to relation fields and CRUD select/include when targeting zod v4\n- Add explicit getter return type annotations in pure models to avoid TS7023\n- Fix single-file bundling around getters (no stray commas, correct optional chaining)\n- Add tests: single-file-zod-versions, pure-models-zod-v4-recursion\n- Add scripts: test:features:single-file-zod-versions, test:features:pure-models-zod-v4-recursion\n\nCloses #273 (bcff391)

1.27.5 (2025-10-10)​

🐛 Bug Fixes​

  • naming: align pure model relation symbols with exportNamePattern and resolve import paths via filePattern (93a6f6f)

♻️ Code Refactoring​

  • naming: centralize export symbol parsing (eea46a9)

📚 Documentation​

  • agents: never commit PR body files; use temp paths (cd3dc49)
  • changelog: add PR body for naming fixes (fd40ef2)

1.27.4 (2025-10-09)​

🐛 Bug Fixes​

  • transformer: target client entry file for custom outputs (6d1ae73)
  • tsconfig: add exclude patterns for specific directories (4ddcb03)

1.27.3 (2025-10-04)​

🐛 Bug Fixes​

  • pure-models: correct z.infer references with custom naming patterns (44bd2b2)
  • pure-models: correct z.infer references with custom naming patterns (275a181)
  • variants: prevent type name conflicts in variant exports (caddf9d)

1.27.2 (2025-10-04)​

🐛 Bug Fixes​

  • funding: add GitHub Sponsors funding field to package.json (2dbe092)

1.27.1 (2025-10-04)​

🐛 Bug Fixes​

  • build: include postinstall script in published package (19fb42a)

📚 Documentation​

  • website: fix markdown links and update metrics to v1.27.0 (ce1b65f)

1.27.0 (2025-10-04)​

🚀 Features​

  • config: add fine-grained strict mode configuration (63b5946)

🐛 Bug Fixes​

  • strict-mode: correct model-level enabled baseline logic (9c63335)
  • strict-mode: resolve multiple critical bugs in strict mode logic (11b0ea8)
  • strict-mode: resolve operation name mapping and enhance resolver compatibility (abee69a)
  • tests: remove broken generateImportStatement test cases (fe09750)

♻️ Code Refactoring​

  • strict-mode: improve return type precision in getGlobalSchemaTypeSetting (4d9b762)

📚 Documentation​

  • enlarge README diagrams and update renderer (de5fda6)
  • explain custom import annotations (8b15bd5)

1.26.0 (2025-10-02)​

🚀 Features​

  • imports: add custom imports feature for external validators (fe90cd8)

🐛 Bug Fixes​

  • constraints: resolve max constraint deduplication and conflict resolution (e8a50c1)
  • core: align custom import helpers (35db237)
  • generators: emit custom imports via transformer helper (0b32d9e)
  • generators: emit field custom imports in pure models (ac99736)
  • generators: normalize model-level validation chain (12864e2)
  • generators: use schema content during import filtering (138fa81)
  • generators: use transformer instance for zod import (0014e1b)
  • imports: optimize custom import detection for better performance (72480d0)
  • parser: correct TypeScript import type statement parsing (71a6c53)
  • parsers: drop type-only custom imports (d794551)
  • parsers: handle complex custom import annotations (108dee3)
  • parsers: improve import parsing robustness (7b80423)
  • parsers: parse combined default and named imports (2e3a093)
  • parsers: support iso string annotations (803f968)
  • parsers: tolerate loose custom import arrays (7312460)
  • remove debug log (7a8894e)
  • transformer: escape custom import regex (401d538)
  • transformer: insert max constraint after any Zod base (19246b3)
  • transformer: preserve custom schemas when applying zod annotations (d9f03be)
  • transformer: prevent double-processing of @zod annotations (f06bf45)
  • variants: adjust custom import path rewrites (df0dd8c)
  • variants: filter runtime custom imports (29e7a41)

♻️ Code Refactoring​

  • types: improve type safety for custom import methods (7743c2f)

📚 Documentation​

  • add mermaid rendering workflow (0c6f737)

1.25.1 (2025-10-01)​

🐛 Bug Fixes​

  • transformer: use owning model alias for create many imports (1fd9973)

1.25.0 (2025-09-29)​

🚀 Features​

  • imports: switch to namespace imports for better tree-shaking (aa3873c), closes #158

🐛 Bug Fixes​

  • format code with prettier (c598173)

1.24.0 (2025-09-29)​

🚀 Features​

  • variants: add partial flag support for automatic .partial() application (e5876eb), closes #192 #192
  • zod-comments: add comprehensive JavaScript object literal parser (3afa975)
  • zod-comments: support custom json shapes validations (14dfb06)
  • zod-v4: implement string formats and imports with partial field support (308e97e), closes #233

🐛 Bug Fixes​

  • ci: update link-check workflow to use pnpm instead of npm (7bc1536)
  • zod-comments: review notes (3c5bedb)
  • zod-comments: route @zod.custom payloads through inferZodTypeFromValue (f840f17)
  • zod-comments: support JavaScript object literal syntax in parameters (2f72870)
  • zod-v4: preserve caller-supplied parameters in v4 string format methods (ca28735)

1.23.2 (2025-09-28)​

🐛 Bug Fixes​

  • ci: add missing GitHub permissions for semantic-release (db07eca), closes #260 #233

1.23.1 (2025-09-28)​

🐛 Bug Fixes​

  • esm: add file extension to JSON helpers imports (50481a2)
  • esm: add file extension to Prisma client imports in single-file mode (c0c3a7f)
  • esm: update JSON helpers import regex for single-file mode (a109656)
  • transformer: use enum schemas instead of enum types for runtime validation (0faaa02)

1.23.0 (2025-09-28)​

🚀 Features​

  • zod-comments: add complete Zod v4 string format support (41ed24b)
  • zod-comments: add support for 14 new Zod v4 string format validation methods (75eb185), closes #233

🐛 Bug Fixes​

  • parsers: correct parameter validation for Zod v4 string format methods (5b2b339)
  • release: correct GitHub assignee format and complete datetime docs (0de41aa)
  • zod-comments: improve parser robustness and error handling (cd022ae)
  • zod-comments: preserve parameters in v4 base replacement methods (cf18276)

♻️ Code Refactoring​

  • zod-comments: use central logger consistently (4bb63ef)

📚 Documentation​

  • changelog: correct Zod v4 string format methods list (2910146)

[Unreleased]​

🚀 Features​

  • zod-comments: add support for 20 new Zod v4 string format validation methods (#233)
    • Network/URL formats: @zod.httpUrl(), @zod.hostname()
    • Identifier formats: @zod.nanoid(), @zod.cuid(), @zod.cuid2(), @zod.ulid()
    • Encoding formats: @zod.base64(), @zod.base64url(), @zod.hex()
    • Security formats: @zod.jwt(), @zod.hash("algorithm")
    • Network formats: @zod.ipv4(), @zod.ipv6(), @zod.cidrv4(), @zod.cidrv6()
    • Character formats: @zod.emoji()
    • ISO date/time formats: @zod.isoDate(), @zod.isoTime(), @zod.isoDatetime(), @zod.isoDuration()
    • All methods support Zod v4 base types (e.g., z.nanoid(), z.iso.date()) with v3 fallback compatibility
    • Existing methods like @zod.email(), @zod.url(), @zod.uuid() maintain compatibility

📚 Documentation​

  • zod-comments: add comprehensive documentation for new string format methods with examples and compatibility matrix

1.22.2 (2025-09-28)​

🐛 Bug Fixes​

  • esm: add .js extension support for Prisma client imports (d8ce5af)

📚 Documentation​

  • changelog: fix changelog issue affecting docs site (d59c791)
  • readme: enhance core features with visual Mermaid diagrams (bd715b4)
  • readme: enhance feature badge visibility (387e64e)

1.22.1 (2025-09-27)​

🐛 Bug Fixes​

  • naming: fix remaining bugs (62ef64f)

📚 Documentation​

  • naming: add notes about operation token requirement for CRUD schemas (4b16664)
  • naming: add notes about input naming (67a5c05)
  • readme: add comprehensive Core Features table (4444c59)

1.22.0 (2025-09-26)​

🚀 Features​

  • naming: add custom naming patterns for schemas, inputs, and enums (fe9f3df)
  • naming: dedupe file names when patterns include model+InputType; extend export dedupe and document behavior (53fc283)

🐛 Bug Fixes​

  • import: enhance parseImportStatement to handle alias and type imports (260cf18)
  • import: resolve import/export name mismatch causing compilation failures (d3c321d)
  • naming-resolver: use applyUniversalPattern to avoid regex quirks with brace tokens (2607486)
  • naming: avoid redundant aliasing in enum imports (66b67ab)
  • naming: honor custom schema patterns in import generation (6ab60a6)
  • naming: normalize Operation to PascalCase in schema filenames and imports (b0e34f3)
  • naming: replace Unknown fallback with inputType to prevent filename collisions (2eef15e)
  • naming: resolve duplicate model prefixes and operation casing in custom naming patterns (9b029ae)
  • naming: synchronize import paths with custom schema patterns and prevent file collisions (196d949)
  • naming: wire enum and input imports through naming resolvers (384ebb4)
  • prisma-generator: escape dynamic import extension in dedupe regex to ensure deterministic matching (cb814e8)
  • prisma-generator: include normalized enum names in registry to match normalized schema exports (5ee7d8c)
  • schema: unify CRUD export naming to honor custom exportNamePattern consistently (d87eeb6)
  • transformer): use enum/input resolvers and ESM extensions for imports; refactor(utils): rename namingResolver.ts to naming-resolver.ts; fix(generators): append configured extensions to imports; fix(variants): include extension in fallback and regex; fix(prisma-generator): add extension to enum imports and dedupe; fix(results: include extension in results index exports (49492d9)
  • transformer: bind Prisma types from intrinsic input name, not customized export name (b67c361)
  • transformer: correct enum import base path for CRUD schema files (./enums vs ../enums); ensure path resolves in test:basic (1a14617)
  • transformer: route CRUD/Aggregate/GroupBy writes through canonical writer with collision guard; update tests to schemas path (04925eb)
  • transformer: switch to logger.warn, make input import helper base-aware, avoid brittle path replace for results deps, and prevent double index addition (cc48360)
  • utils: normalize constructed enum import paths with posix.join in generated import lines (06cea0d)
  • utils: normalize enum import paths with posix join and use brace-safe universal pattern applier (491e5c7)
  • variants: use enum constant (VariantType.PURE) instead of string literal for variant check (73ec877)
  • variants: use pattern-aware enum imports in variant files and honor ESM file extensions (a9df6de)

♻️ Code Refactoring​

  • naming: rename enumImport.ts to enum-import.ts and improve naming consistency (2e956ad)

📚 Documentation​

  • naming: clarify duplicate prefix stripping applies only to export names (dcd886f)
  • naming: complete naming patterns documentation and add missing kebab token (6b23a03)

1.21.4 (2025-09-25)​

🐛 Bug Fixes​

  • variants: prevent double array wrapping for scalar array fields (5b1eb67)

1.21.3 (2025-09-21)​

🐛 Bug Fixes​

  • generator: include unused enums in schema generation (cde6d5e), closes #247

♻️ Code Refactoring​

  • address CodeRabbit review feedback (3468ffe)

1.21.2 (2025-09-20)​

🐛 Bug Fixes​

  • ci: remove auto-docs-version step from semantic-release workflow (380a9d0)

📚 Documentation​

  • remove Docusaurus versioning system (3277384)

1.21.1 (2025-09-19)​

🐛 Bug Fixes​

  • models: correct enum import paths from models/ to enums/ (d6a41a3)
  • variants: add missing .array() wrapper for enum arrays in variant schemas (674133e), closes #245

📚 Documentation​

  • fix MDX compilation errors and broken links in documentation (596e5d1)

1.21.0 (2025-09-18)​

🚀 Features​

  • generator: add JSON Schema compatibility mode (ada87fc), closes #236
  • json-schema: enhance validation patterns and add type safety (e7fbb62)

🐛 Bug Fixes​

  • config: address CodeRabbitAI review feedback (258ee75)
  • pure-models: restore optionalFieldBehavior respect and enhance zod comments (057eb25)
  • pure-models: standardize file organization and improve import deduplication (880ae6c)
  • scripts: correct test coverage command file extension (bd109ce)

📚 Documentation​

  • config: add JSON Schema compatibility documentation (d2b3c96)

1.20.4 (2025-09-18)​

🐛 Bug Fixes​

  • align variant export manager with ESM index extension handling (33f6d22)
  • generator: support ESM .js extensions in index files with useMultipleFiles (7109157), closes #234
  • resolve circular dependency issues in variants generator (530cc22)
  • variants: correct ESM import paths for directory-based variant exports (0a7e529)

1.20.3 (2025-09-16)​

🐛 Bug Fixes​

  • generator: support @zod.nullable() on array fields (1754016), closes #235

1.20.2 (2025-09-12)​

🐛 Bug Fixes​

  • variants: do not treat relations as enums; add field-aware base types for @zod integration and ensure variant enum imports use <Enum>Schema (a236939)
  • whereUnique: handle composite unique selectors nested under key names; superRefine now validates completeness inside nested objects and accepts composite PK/unique (8ea437c)

1.20.1 (2025-09-12)​

🐛 Bug Fixes​

  • enable constraint resolution for Zod v4 email syntax (3ea22ca), closes #227
  • improve Zod annotation detection for optional/nullable/nullish calls (2f56c47)
  • resolve @zod comment annotation parsing issues (38c9186), closes #227 #227
  • resolve ESLint errors for Issue #227 implementation (8391aef)

⚡ Performance Improvements​

  • optimize parallel test workers for low-end hardware (db5b257)

1.20.0 (2025-09-11)​

🚀 Features​

🐛 Bug Fixes​

  • add support for @zod.json() and @zod.enum() annotations with Zod v4 compatibility (e3172f9)
  • resolve unused variable linting error (7a80136)

1.19.1 (2025-09-11)​

🐛 Bug Fixes​

  • resolve snake_case aggregate input naming and add comprehensive tests (b14380a)

1.19.0 (2025-09-10)​

⚠ BREAKING CHANGES​

  • schema: Enum and aggregate schema names may change for models with snake_case naming, requiring updates to dependent code.

🚀 Features​

  • complete dual export consistency for all analytics operations (3456f72)

🐛 Bug Fixes​

  • address critical CodeRabbit review issues (c39eebc)
  • conditionally include avg/sum aggregates only for numeric fields (a4d137c)
  • correct getPrismaTypeName to use original model names (7c44948)
  • handle Prisma aggregate type naming for snake_case models (78ee433)
  • only apply enum import aliasing when names differ (40dd0f8)
  • remove empty objects from select schema generation (3c8ecbc)
  • resolve enum import/export mismatch for normalized names (cd82993)
  • resolve import/export naming inconsistencies in generated schemas (8148da6)
  • schema: resolve naming inconsistencies in generated schemas (9ad6988)
  • use correct Prisma type names for snake_case models (facc067)
  • use String type for MongoDB id fields with @db.ObjectId (af016f8)

1.18.8 (2025-09-08)​

🐛 Bug Fixes​

  • single-file-mode: remove duplicated schema declarations (cdb65b4)

1.18.7 (2025-09-08)​

🐛 Bug Fixes​

  • ci: update pnpm version to 10.15.1 in docs and ci workflows (de2326d)

1.18.6 (2025-09-08)​

🐛 Bug Fixes​

  • ci: update pnpm version to 10.15.1 to resolve lockfile mismatch (6593409)
  • convert npm resolutions to pnpm overrides format (02e6d13)
  • remove pnpm caching from setup-node before pnpm installation (f3974c7)

1.18.5 (2025-09-03)​

🐛 Bug Fixes​

  • improve type inference for recursive schemas with AND/OR/NOT operations (2c360ef)

1.18.4 (2025-09-03)​

🐛 Bug Fixes​

  • improve type inference for self-referential schemas (be14309), closes #214

1.18.3 (2025-09-03)​

🐛 Bug Fixes​

  • fix failing schema validation tests (d319ac4)
  • Improve optional/nullable field handling in schema generation and update tests (3b00458)

1.18.2 (2025-09-03)​

🐛 Bug Fixes​

  • resolve TypeScript errors in generated schemas (b7af26a)

📚 Documentation​

  • config: document optional vs nullable policy for object input schemas (non-relation optional nullable; relations optional-only) (82bdfc1)

1.18.1 (2025-09-02)​

🐛 Bug Fixes​

  • objects: add .nullable() to optional non-relation fields and keep relation args optional-only (ce9695c)

📚 Documentation​

  • versioned: add json-friendly-datetime recipe for v1.17.4 to satisfy sidebar (0222f84)

1.18.0 (2025-09-02)​

🚀 Features​

  • generator: DateTime split default for inputs and Prisma-parity WhereUniqueInput semantics (d31c823)

1.17.10 (2025-09-02)​

🐛 Bug Fixes​

  • add missing exports for aggregate and groupBy schemas in index.ts (7b980d2)

1.17.9 (2025-08-31)​

🐛 Bug Fixes​

  • add missing types for enums (431227d)

1.17.8 (2025-08-30)​

🐛 Bug Fixes​

  • correct manifest tracking for single file mode (decbfcd)

1.17.7 (2025-08-30)​

🐛 Bug Fixes​

  • remove incorrect /schemas path segment in variant enum imports (62cd853), closes #208

1.17.6 (2025-08-30)​

🐛 Bug Fixes​

  • add missing Prisma type import detection for ZodType generics in single-file mode (1e384f9), closes #207

1.17.5 (2025-08-30)​

🐛 Bug Fixes​

  • resolve enum import path inconsistencies across generation contexts (b46990a)

📚 Documentation​

  • add dual-exports page links to all versioned sidebars (355c03d)

1.17.4 (2025-08-29)​

🐛 Bug Fixes​

  • use npx for docusaurus commands in website scripts (d4740ee)

1.17.3 (2025-08-29)​

🐛 Bug Fixes​

  • add comprehensive enum import path validation for issue #204 (b3536d1)

1.17.2 (2025-08-29)​

🐛 Bug Fixes​

  • resolve duplicate identifiers and improve enum usage (#205) (5437309)

📚 Documentation​

  • add dateTimeStrategy configuration documentation (617988b)
  • add dual-exports configuration to sidebar (230ea46)
  • optimize workflow by splitting dependencies (9723238)

1.17.1 (2025-08-26)​

🐛 Bug Fixes​

  • config: improve validation and error handling for config file paths (7eeaebf)

📚 Documentation​

  • document config file path resolution behavior (ff3b4de)

1.17.0 (2025-08-26)​

🚀 Features​

  • add manifest tracking methods to transformer (68f62f3)
  • add safety configuration resolver with precedence handling (0cce3e9)
  • add safety system type definitions and interfaces (972a272), closes #71
  • extend configuration parser with safety options support (38b3474)
  • implement configurable safety system with manifest tracking (d8e449b), closes #71
  • integrate configurable safety system into main generator (9944137)

🐛 Bug Fixes​

  • resolve TypeScript type errors and linting issues (65dbc9a)

♻️ Code Refactoring​

  • update file writing utilities for safety system integration (b38ec5f)

📚 Documentation​

  • add comprehensive safety system reference documentation (a509b21)
  • add safety system configuration recipe guides (46bc94f)
  • integrate safety system documentation into website navigation (3968f5f)

1.16.6 (2025-08-25)​

🐛 Bug Fixes​

  • replace console.log with logger.debug for debug output (3f75076)

1.16.5 (2025-08-25)​

🐛 Bug Fixes​

  • implement factory pattern for recursive Zod schemas (bbe8e54)
  • improve @zod.custom.use parsing and enum import handling (48b3c44)
  • improve json helper import path resolution (Issue #196) (6c2290d)
  • prevent missing variants directory import errors (52eb025)
  • variants: import enum schemas in array-based custom variants and use *Schema refs (Issue #193)\n\n- Switch custom variants to import from generated enums instead of @prisma/client\n- Use EnumNameSchema in field definitions\n- Update test to expect schema imports and references\n\nAlso validates @zod.custom.use chaining remains intact (Issue #194 tests stay green). (d3b57d4)

1.16.4 (2025-08-24)​

🐛 Bug Fixes​

  • remove satisfies annotations from recursive Zod schemas (ab51b0f)

♻️ Code Refactoring​

  • clean up unused code in generateZodOnlySanityCheck (392056f)

1.16.3 (2025-08-24)​

⚠ BREAKING CHANGES​

  • config: respect exportTypedSchemas/exportZodSchemas from JSON config with proper precedence

🐛 Bug Fixes​

  • config: respect exportTypedSchemas/exportZodSchemas from JSON config with proper precedence (4a3f582)
  • minimal,zod: allow minimal mode without explicit model config; adjust @zod string quoting (URLs double-quoted, others single-quoted); ensure output path precedence respects schema dir (31072c8)
  • zod: avoid TS7022 for self-referential object schemas by using factory + z.lazy(makeSchema); emit optional sanity-check types; skip Prisma imports for zod-only (6245b74)

1.16.2 (2025-08-23)​

🐛 Bug Fixes​

  • resolve @zod annotations not working without config file (issue #189) (3198737)

1.16.1 (2025-08-23)​

🐛 Bug Fixes​

  • transformer: avoid applying field validations to aggregate input schemas and fix optional() placement for enhanced zod chains (a84d222)
  • transformer: correct optional() placement and skip validations on aggregate inputs (097be4d)

1.16.0 (2025-08-22)​

⚠ BREAKING CHANGES​

  • minimal: suppress object and CRUD schema generation in minimal mode with clear logs

🚀 Features​

  • minimal: suppress object and CRUD schema generation in minimal mode with clear logs (78e6fe3)

🐛 Bug Fixes​

  • config: improve Zod version detection for datetime validation (81893d5)
  • generator: block problematic CreateInput object schemas in minimal mode (aee979b)
  • imports: correct enum import path in model generator and normalize variant file imports formatting (8f5ab41)
  • transformer: prefer UncheckedCreateInput in minimal mode create operations (0b5a982)
  • types,zod: correct ZodType generics, import formatting, and Unchecked pattern precedence (8496299)

📚 Documentation​

  • add troubleshooting guide for CreateInput TypeScript errors (294402e)
  • document minimal mode CreateInput behavior and schema filtering (f65c837)
  • recipes: escape inline Zod import snippets to fix Docusaurus SSG error (z is not defined) (195d112)

1.15.0 (2025-08-20)​

⚠ BREAKING CHANGES​

  • config,zod: add zodImportTarget to control Zod import (v3/v4/auto); update generator, single-file bundler, docs, recipes, and tests

🚀 Features​

  • config,zod: add zodImportTarget to control Zod import (v3/v4/auto); update generator, single-file bundler, docs, recipes, and tests (1a720e6)

📚 Documentation​

  • fix v1.13.0 versioned changelog to show correct latest version (e0e0fa1)
  • website: add circular-dependency-exclusion recipe to sidebars (next, v1.13, v1.14) (6bfc711)
  • website: sync changelog and metrics after docs build (dd83756)

1.14.0 (2025-08-20)​

🚀 Features​

  • ci: automate changelog sync in release workflow (560c806)

📚 Documentation​

  • sync changelog to show v1.13.0 as latest version (04169b7)

1.13.0 (2025-08-20)​

🚀 Features​

  • add pureModelsExcludeCircularRelations option to resolve issue #183 (2627051)

🐛 Bug Fixes​

  • linting: remove non-null assertions from circular dependency detector (80ab27b)
  • naming: respect custom filePattern in import statements for pure models (ac3b338), closes #183 #183

1.12.4 (2025-08-18)​

🐛 Bug Fixes​

  • groupBy: restrict _count to literal true or CountAggregateInput (align with Prisma Client) (c5eaec0)
  • groupBy: use z.literal(true) for _count in groupBy args (disallow false) (4f4fc68)

1.12.3 (2025-08-18)​

⚠ BREAKING CHANGES​

  • args: align CountArgs and ...AndReturn schemas with Prisma Client

🐛 Bug Fixes​

  • args: align CountArgs and ...AndReturn schemas with Prisma Client (82e5534)

1.12.2 (2025-08-17)​

🐛 Bug Fixes​

  • pure-models: apply optionalFieldBehavior to schema-optional fields; keep required fields required; address perf flake by documenting run guidance; fix ESLint issues (32dccaa)

1.12.1 (2025-08-17)​

🐛 Bug Fixes​

  • correct array field handling in Zod schema generation (4043b64), closes #174
  • remove unused imports in array-fields test (1b85c6e)

1.12.0 (2025-08-16)​

🚀 Features​

  • add optionalFieldBehavior configuration option (6bdfc11)

📚 Documentation​

  • add comprehensive documentation for optionalFieldBehavior (127fa84)

1.11.0 (2025-08-16)​

🚀 Features​

  • add complete CRUD operation support and fix GroupBy aggregation fields (2bd0cf8)

📚 Documentation​

  • changelog: remove Twitter/X follow line from Stay Updated section (e63b800)
  • fix MDX parsing in changelog by escaping angle brackets; point navbar Changelog to stable next route (d1ab1ff)
  • snapshot docs for v1.10.1 [skip ci] (846f4bc)
  • versioning script supports patch releases via DOCS_VERSION_ON_PATCH and normalizes tags (59a6683)

1.10.1 (2025-08-15)​

🐛 Bug Fixes​

  • ensure consistent nullable handling for optional fields across all types (a732f19)

♻️ Code Refactoring​

  • standardize enum handling across all variant types (b94f2fa)

📚 Documentation​

  • add automated changelog sync to website (b2390e2)

1.10.0 (2025-08-14)​

🚀 Features​

  • add MongoDB ObjectId max length validation support (1c139c1), closes #167
  • add native type max length validation for varchar/char fields (74c6ad4), closes #167

🐛 Bug Fixes​

  • correct YAML indentation in CI workflow (876d637)
  • enhance native type constraint handling and conflict resolution (4cd8cad)

📚 Documentation​

  • add comprehensive native type max length validation documentation (9389b0f), closes #167
  • ci: gate docs deploy to docs changes or feat/fix commits (34b089b)
  • modernize website with responsive design and automated metrics (e810676)
  • readme: modernize intro, tidy quick start and prerequisites, refine header subline and star cue (cff65d9)

1.9.3 (2025-08-14)​

🐛 Bug Fixes​

  • docs workflow build process (864668f)

📚 Documentation​

  • add version 1.9.2 documentation (a7c2d91)

1.9.2 (2025-08-13)​

🐛 Bug Fixes​

  • prisma-import: point Zod schema Prisma imports to client entry for new prisma-client generator (f009211)

1.9.1 (2025-08-13)​

🐛 Bug Fixes​

  • docs: resolve Docusaurus SSG error by fixing MDX style/class props and update internal links (#contributing, homepage) (0f04448)

📚 Documentation​

  • readme: restore prominent docs website badge/link (9105ef3)
  • readme: streamline quick start, sponsor & contribute guidance, add badges (596a8f3)

1.9.0 (2025-08-13)​

🚀 Features​

  • docs,homepage: mobile hero refinements, button redesign, badge replacement, GitHub CTA styling (529bbc8)

♻️ Code Refactoring​

  • types: remove explicit any in source/tests and ignore docusaurus build artifacts (163d6be)

📚 Documentation​

  • add Docusaurus site, version 1.8.0 snapshot, automation & link checks (8590d02)

1.8.0 (2025-08-13)​

⚠ BREAKING CHANGES​

  • pure-models: pure model exports are now *Schema and only <Model>.schema.ts files are generated (no <Model>.model.ts). Updated README. Adjust your imports accordingly.
  • pureModels: pureModels no longer emits relation (object) fields unless pureModelsIncludeRelations=true. Set that flag to retain prior behavior. Added config parsing, defaults, docs, and tests.

🚀 Features​

  • config: add pureModelsLean and dateTimeStrategy options with docs and schema updates (dc3784c)
  • custom-use: add @zod.custom.use override, helper exports, and tests (72f7b4d)
  • models: overhaul pure model generation (Model naming, lean mode, enum schema refs, DateTime strategies, single-file optimization) (8462d32)
  • naming: add stable naming customization presets and docs (8d611d8)
  • pure-models: unify pure model naming to *Schema and single .schema.ts output (5234631)
  • pureModels: omit relation fields by default; add pureModelsIncludeRelations flag (cf9eef4)
  • pure: support pure-only variant mode (skip CRUD/object schemas when only pure enabled) (9d4527b)
  • variants,imports: unify enum schema usage across variant generators and dynamic Prisma client import paths (a2e126a)
  • variants): refined enum handling for pure variant & chore(test: migrate from deprecated basic reporter (375fcb8)

🐛 Bug Fixes​

  • config: honor JSON config output when generator block omits output\n\nDefers output path initialization so JSON 'output' is used if schema block lacks output (block > JSON > default). (5bc90b9)
  • generator: honor config output path and correct enum import paths in pure model schemas (5393d98)
  • json: align helper file after template update (77ecfe5)
  • json: drop Prisma.JsonValue references for v6 compatibility and use structural JSON types (8fef5f7)
  • prisma-client-preview: correct import path handling for preview prisma-client generator and file extensions (65925e2)

♻️ Code Refactoring​

  • json: centralize JSON helper schema generation and adjust single-file bundling (2102256)

📚 Documentation​

  • recipes: add CRUD-only, input-only, result-only recipe examples (36d6702)
  • recipes: add pure-models-lean recipe with DateTime strategy examples (dcd773a)

1.7.0 (2025-08-12)​

🚀 Features​

  • bytes: align Prisma Bytes mapping with v6 (Uint8Array) and update tests\n\n- I/O schemas: map Bytes to z.instanceof(Uint8Array)\n- Pure models: default to base64 string with size checks; opt-out to Uint8Array via config\n- Update tests and docs/comments accordingly\n\nBREAKING CHANGE: Prisma Bytes now validated as Uint8Array in generated I/O schemas. Pure model default remains base64 string, with config to use Uint8Array. (15ca502)

📚 Documentation​

  • recipes: fix wrong file names and snippet paths in recipe READMEs; clarify usage steps (20ec581)
  • recipes: remove top-level snippets and update references to recipes/*\n\n- Delete snippets/ folder\n- Update README and recipes/README to point to recipes/<name>/schema.prisma\n- Keep historical mention in CHANGELOG as-is (3aa4009)

1.6.0 (2025-08-11)​

🚀 Features​

  • docs: add recipes and snippets with generator block examples and configs (bb284c7)

🐛 Bug Fixes​

  • prisma: add User.password to align generated create inputs with tests (8485187)

♻️ Code Refactoring​

  • config: improve option parsing and precedence; add tagged warnings and info messages (81b0d91)

📚 Documentation​

  • readme: clarify config precedence and logging with tagged messages (96d705b)

1.5.0 (2025-08-10)​

🚀 Features​

  • config,transformer: add strictCreateInputs/preserveRequiredScalarsOnCreate and apply to Create-like inputs; use Omit<> for typed exports when filtered\n\n- config: introduce strictCreateInputs (default true) and preserveRequiredScalarsOnCreate (default true)\n- transformer: respect flags for Create* inputs; re-add required scalars in filtered mode; track excluded fields and wrap typed exports with Omit<>\n- tests/recipes/docs: update helpers and recipes; document options in README (cf48027)

🐛 Bug Fixes​

  • ensure enum value imports are present in variant schemas (post-merge release trigger) (aed7e61)

1.4.2 (2025-08-10)​

🐛 Bug Fixes​

  • ensure enum value imports are present in variant schemas (post-merge release trigger) (b3dde64)

1.4.1 (2025-08-09)​

🐛 Bug Fixes​

  • transformer: correct list handling to avoid duplicate array() and support DateTime[] union\n\n- Use z.union([z.date().array(), z.iso.datetime().array()]) for DateTime lists\n- Append .array() only once and collapse accidental duplicates\n- Preserve optionality behavior with enhanced schemas (2e75b93)

1.4.0 (2025-08-09)​

🚀 Features​

  • logging: hide verbose logs by default and gate them behind DEBUG_PRISMA_ZOD/DEBUG\n\n- Add central logger (src/utils/logger.ts)\n- Convert noisy console.log to logger.debug/info/warn\n- Keep warnings/errors visible without DEBUG (703f716)

1.3.1 (2025-08-09)​

🐛 Bug Fixes​

  • objects: inline object schema exports and add dual exports (typed + pure Zod) (4af455c)
  • whereUniqueInput: require and restrict fields to unique identifiers only for WhereUniqueInput (becd08b)

1.3.0 (2025-08-09)​

🚀 Features​

  • Add comprehensive debug logging for filtering (5309680)
  • add core configuration and type system (2923825)
  • Add example configuration and update test schema (aca8311)
  • Add legacy configuration transformation and auto-discovery (f5612a5)
  • add schema variant system (f133d1a)
  • add utility modules (3446571)
  • Enhance configuration auto-discovery in generator (2985a4b)
  • generator: add strict single-file output mode with in-process aggregator; skip variants in single-file; place bundle at output root by default via placeSingleFileAtRoot; include tests and validation tsconfig (2296b30)
  • implement foreign key preservation for excluded relation fields (52897f3)
  • integrate advanced filtering and configuration (20a5313)
  • integrate zod-integration system with main generator pipeline (fcc396e)
  • validation: add comprehensive schema validation infrastructure (6da9e61)
  • variants: generate array/object variants under schemas/variants by default and add variants barrel to main index; fix index exports\n\nAlso: pure models improvements (Bytes base64 mapping, JSON record handling, dedupe defaults), union formatting to single line, enum string arrays, and minimal-mode schema emission stability. All feature tests pass. (9ea8a46)

🐛 Bug Fixes​

  • ci: generate per-file schemas in example to satisfy tests (useMultipleFiles=true) (c32e6b8)
  • config: resolve tsconfig.json typeRoots and include paths (976fb49)
  • correct config path handling in field exclusion tests (67bcbf2)
  • correct test configurations and schema generation issues (d1af961)
  • enhance @zod annotation parsing and validation (f965e22)
  • enhance @zod method parameter validation for custom error messages (4d06ec4)
  • Enhance model filtering to prevent disabled model schemas in nested folders (c34e995)
  • generator: correct Zod method chaining order for optional and nullable fields (0effdf2)
  • implement comprehensive Zod comment parsing engine (154aaa1)
  • Improve field exclusion system and foreign key preservation (e857e6a)
  • improve regex validation and resolve optional redundancy in zod schema generation (5ccce49)
  • prevent duplicate .optional() calls in enhanced zod schemas (b7eb5e0)
  • remove unused ObjectSchema imports from result schemas (488e838)
  • replace deprecated Zod API usage (9e46bcc)
  • replace deprecated Zod API usage (92d2537)
  • resolve @zod annotation method validation and parameter formatting (918d15c)
  • Resolve config path resolution issues in tests (2cdb6fc)
  • resolve ESLint errors to unblock release (unused vars, require->import) (becfbdb)
  • resolve field exclusion system configuration issues (2f50c4a)
  • resolve test configuration and template variable issues (fc10758)
  • update supporting modules and test infrastructure (0bd5d56)

♻️ Code Refactoring​

  • enhance helper modules with filtering support (4938d6e)
  • parser: remove duplicate base type method configurations (4f5f7f1)

📚 Documentation​

  • add comprehensive documentation (d96c872)

1.2.0 (2025-08-07)​

🚀 Features​

  • implement community generator aggressive inlining pattern (d5675c0)
  • implement dual schema export strategy to solve TypeScript method trade-off (9cba538)
  • implement selective inlining for select schemas (0a1c921)
  • implement true select schema inlining following community generator pattern (be01d20)
  • removes the forced ZodType to allow the use of ZodObject properties and methods (df36da4)

🐛 Bug Fixes​

  • dual export configuration parsing bug (e4b6853)
  • improve TypeScript type inference with explicit Prisma bindings (cb14493)
  • model hiding functionality for @@Gen.model(hide: true) (fe4567e)
  • resolve field name detection bug in generateObjectSchemaField (94508ae)
  • resolve FindMany union validation issue and improve composition approach (92d9301)
  • use Buffer instead of Uint8Array for bytes field in test (4608156)

📚 Documentation​

  • add composition approach design documentation (dc4ecc5)
  • add comprehensive dual export configuration guide (6628842)
  • update comparison with aggressive inlining achievement (b47449f)

1.1.1 (2025-07-30)​

🐛 Bug Fixes​

  • improve ESM import handling and type validation (c07d384)
  • resolve ESLint errors in ESM configuration tests (9687c1d)

📚 Documentation​

  • add preview features support section to README (a348446)
  • remove beta sections and references from README (32edf33)

1.1.0 (2025-07-25)​

🚀 Features​

  • add support for new prisma-client generator (46cdc02), closes #127

1.0.7 (2025-07-25)​

🐛 Bug Fixes​

  • add explicit type annotations to prevent TypeScript implicit any errors (ef50308)

1.0.6 (2025-07-25)​

🐛 Bug Fixes​

  • correct skipDuplicates support for database providers (0511785)

1.0.5 (2025-07-25)​

🐛 Bug Fixes​

  • remove package/package.json from git add in release workflow (254ad28)
  • resolve TypeScript compilation errors in generated schemas (85d10a8)

1.0.5 (2025-07-23)​

🐛 Bug Fixes​

  • remove package/package.json from git add in release workflow (254ad28)

1.0.4 (2025-07-23)​

🐛 Bug Fixes​

  • remove unused error parameters in test catch blocks (025b822)
  • resolve output directory duplication when path ends with 'schemas' (e200115), closes #118

1.0.3 (2025-07-22)​

🐛 Bug Fixes​

  • resolve TypeScript inference issues with z.lazy() relations (6da8eb8)

📚 Documentation​

  • remove hardcoded version numbers from README (95d6cbd)

1.0.2 (2025-07-22)​

🐛 Bug Fixes​

  • resolve schema compilation errors in Issue #119 (3f29b48)
  • resolve Vitest worker timeout in CI (08a5546)

1.0.1 (2025-07-22)​

🐛 Bug Fixes​

  • remove broken logo image from README (eb2ba51)

📚 Documentation​

  • update README for v1.0.0 stable release (0f267c9)

1.0.0 (2025-07-22)​

🚀 Features​

  • add comprehensive CI/CD automation and release workflows (cb562f5)
  • add support for new prisma-client generator (8224aed), closes #116
  • configure semantic-release for beta releases from upgrade branch (6dfdd98)
  • enable semantic-release for upgrade branch (d6ef9b3)
  • remove strict requiresGenerators constraint (6e1d41b), closes #116

🐛 Bug Fixes​

  • add MongoDB schema generation step to CI workflow (b120f12)
  • add skipDuplicates option to createMany query (710d522)
  • adjust MongoDB test expectations for CI compatibility (0c53f60)
  • adjust provider discovery test and fix more ESLint issues (bb83e97)
  • adjust test expectations and resolve remaining ESLint issues (d1ae46e)
  • convert vitest config to JavaScript for better Node 18 compatibility (0106c4f)
  • correct branch references from main to master in CI/CD workflows (009aa79)
  • no array around createManyInput (a244cac)
  • prevent NaN errors in MongoDB test success rate calculations (1498a80)
  • replace absolute paths with relative paths in provider schemas (97cb362)
  • resolve all remaining ESLint any type warnings (b26ea59)
  • resolve CI test failures and ESLint issues (89ba9e6)
  • resolve ESLint configuration and CI issues (df52348)
  • resolve MongoDB schema coverage test import issues (989addd)
  • skip vitest tests for Node 18 due to Vite 7.x requirements (93605e1)
  • update dependabot configuration (d5f57fb)
  • update package-lock.json with semantic-release dependencies (814be64)
  • update vitest config for v3 compatibility with Node 18 (7f34eab)
  • use correct DMMF namespace import alias (a495445)

📚 Documentation​

  • add beta testing announcement to README (1b0bfb2)
  • add comprehensive CI/CD workflow usage guide (3da4f92)
  • add prominent support section to README (0803dc3)
  • clarify GitHub secrets setup for repository vs environment secrets (c8ea5cc)
  • clarify test schema purpose for new generator (659c4e0)
  • comprehensive README improvements (9d014b9)
  • correct link in table of contents (918f862)
  • focus beta announcement on Prisma 6 & Zod 4 compatibility (087c257)
  • improve NPM token setup instructions and troubleshooting (8f379f9)
  • modernize README with enhanced styling and comprehensive content (1f226a1)
  • update README for Prisma 6 and Zod 4 support (bdac9dd)
  • update to v0.8.15-beta.0 with new generator support (7372825)

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

This changelog is automatically generated using semantic-release.

Older Versions​

For the complete version history including older releases, please see the full CHANGELOG.md on GitHub.

Version Support​

  • Current: v1.27.x - Full support with new features and bug fixes
  • Previous: Previous minor versions - Security and critical bug fixes only
  • Legacy: Older versions - Community support only

Upgrade Guide​

When upgrading between major versions, please refer to our Upgrade Guide for breaking changes and migration instructions.

Release Process​

This project follows semantic versioning and uses automated releases via semantic-release. Releases are automatically generated based on commit messages following the Conventional Commits specification.

Version Types​

  • Major (x.0.0): Breaking changes that require code updates
  • Minor (x.y.0): New features that are backward compatible
  • Patch (x.y.z): Bug fixes and small improvements

Stay Updated​