fix(zod): generate z.union([z.instanceof(Blob), z.instanceof(File)]) for binary format

[j-ibarra]

Summary

Fields with format: 'binary' (produced e.g. by contentMediaType: 'application/octet-stream' in OpenAPI 3.1, as emitted by FastAPI ≥ 0.129.1) were generating z.string() in all three Zod plugin variants (v3, v4, mini) because the formatNode switch had no 'binary' case.

This PR adds the missing case to produce z.union([z.instanceof(Blob), z.instanceof(File)]), which mirrors what the TypeScript plugin already generates (Blob | File) and correctly validates file upload fields at runtime.

Before:

publicKey: z.string()

After:

publicKey: z.union([z.instanceof(Blob), z.instanceof(File)])

Changes

• constants.ts — add instanceof identifier
• v3/toAst/string.ts — add 'binary' case to formatNode
• v4/toAst/string.ts — add 'binary' case to formatNode
• mini/toAst/string.ts — add 'binary' case to formatNode

Related issues

• Fixes [ZOD] Incorrect schema creation for binary files #2317 — [ZOD] Incorrect schema creation for binary files
• Relates to Export binary string OpenAPI types using z.file() in zod v4 #2446 — Export binary string types using z.file() in zod v4. This PR uses z.instanceof(Blob/File) instead of z.file() because it works uniformly across all three Zod plugin variants (v3, v4, mini). A follow-up could add z.file() specifically for the v4 variant if desired.
• Relates to contentMediaType schema property not generating Blob | File` for multipart/form-data uploads #3408 — contentMediaType schema property not generating Blob | File. The TypeScript side was fixed by fix: generate Blob | File for contentMediaType schema property in OpenAPI 3.1 #3431; this PR completes the fix for the Zod plugin side.
• Overlaps with fix(plugins/zod): fix support for string types in binary format #1616 — fix(plugins/zod): fix support for string types in binary format. Similar fix, but this PR is based on the current main, covers all three Zod variants (v3, v4, mini), and includes updated snapshot tests.

Test plan

• All existing tests pass across @test/openapi-ts, @test/openapi-ts-zod-v3, and @test/openapi-ts-zod-v4
• Snapshot tests added for content-binary.json + zod and content-media-type.yaml + zod
• All zod snapshots (v3, v4, mini × OpenAPI 2.0.x, 3.0.x, 3.1.x) updated to reflect z.instanceof(Blob/File) for binary fields
• Builds clean for all three Zod plugin variants

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[pullfrog]

Error

agent completed without reporting progress

  ^{｜ Rerun failed job ➔ ｜ View workflow run ｜ Triggered by Pullfrog ｜ pullfrog.com ｜ 𝕏}

[vercel]

@j-ibarra is attempting to deploy a commit to the Hey API Team on Vercel.

A member of the Team first needs to authorize it.

[changeset-bot]

⚠️ No Changeset found

Latest commit: d934c8a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[pkg-pr-new]

Open in StackBlitz

@hey-api/codegen-core

npm i https://pkg.pr.new/@hey-api/codegen-core@3627

@hey-api/json-schema-ref-parser

npm i https://pkg.pr.new/@hey-api/json-schema-ref-parser@3627

@hey-api/nuxt

npm i https://pkg.pr.new/@hey-api/nuxt@3627

@hey-api/openapi-ts

npm i https://pkg.pr.new/@hey-api/openapi-ts@3627

@hey-api/shared

npm i https://pkg.pr.new/@hey-api/shared@3627

@hey-api/spec-types

npm i https://pkg.pr.new/@hey-api/spec-types@3627

@hey-api/types

npm i https://pkg.pr.new/@hey-api/types@3627

@hey-api/vite-plugin

npm i https://pkg.pr.new/@hey-api/vite-plugin@3627

commit: d934c8a

[codecov]

Codecov Report

❌ Patch coverage is 0% with 8 lines in your changes missing coverage. Please review.
✅ Project coverage is 38.97%. Comparing base (46b7d3a) to head (d934c8a).
⚠️ Report is 4 commits behind head on main.

Files with missing lines	Patch %	Lines
...ages/openapi-ts/src/plugins/zod/v3/toAst/string.ts	0.00%	4 Missing ⚠️
...es/openapi-ts/src/plugins/zod/mini/toAst/string.ts	0.00%	2 Missing ⚠️
...ages/openapi-ts/src/plugins/zod/v4/toAst/string.ts	0.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3627      +/-   ##
==========================================
- Coverage   38.98%   38.97%   -0.02%     
==========================================
  Files         518      518              
  Lines       18968    18975       +7     
  Branches     5606     5609       +3     
==========================================
  Hits         7395     7395              
- Misses       9367     9374       +7     
  Partials     2206     2206              

Flag	Coverage Δ
unittests	38.97% <0.00%> (-0.02%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.