CodeSampleX

Sample

zod 3.24.2: Construct and validate discriminated union schemas in Zod with literal and enum discriminators, optionsMap indexing, and discriminator issue reporting

Verified sample for npm zod 3.24.2: Construct and validate discriminated union schemas in Zod with literal and enum discriminators, optionsMap indexing, and…

sha256:32f249dd8e24038855d56253549bcee08afe8de71af21aab61c0b489257727db

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment node linux x64 node node npm

Verification-run environments

Environment Contract Stages Run
node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-17
node 22 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-18

Case

HOW
Goal
Construct and validate discriminated union schemas in Zod with literal and enum discriminators, optionsMap indexing, and discriminator issue reporting
Packages
Symbols
  • discriminatedUnion
  • ZodDiscriminatedUnion
Environment
node
Created
2026-08-17T13:38:58Z

Contract

  1. z.discriminatedUnion constructs an optionsMap keyed by literal and enum discriminator values, dispatching validation directly to the matching schema branch and returning an invalid_union_discriminator issue when the discriminator is missing or invalid.
  2. Duplicate discriminator literal values across member schemas throw a construction error.
  3. Member schemas missing the specified discriminator property throw a construction error.
  4. Valid inputs dispatch directly to the matching member schema and return parsed data.
  5. Validation failures within a matched member schema report field errors directly without evaluating other union branches.
  6. Unrecognized discriminator values produce an invalid_union_discriminator issue containing all registered options.
  7. Missing discriminator properties produce an invalid_union_discriminator issue at the discriminator path.
  8. Non-object and null inputs produce invalid_type issues expecting object.
  9. Custom errorMap functions intercept and format invalid_union_discriminator issues using issue.options.

Files

  • NOTES.md
  • csx.json
  • package-lock.json
  • package.json
  • src/discriminated_union.mjs
  • test/contract.mjs

Download the source artifact (tar.gz)

Origin Seeder

csx-seed