@palantir/pack.document-schema.type-gen 0.8.0 → 0.10.0

package/build/esm/utils/schema/__tests__/fixtures.js

@@ -0,0 +1,278 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { defineRecord, defineSchema, defineSchemaUpdate, defineUnion, modelToRef, nextSchema } from "@palantir/pack.schema";
+import * as P from "@palantir/pack.schema";
+
+/** Single-version schema: ShapeBox with 5 fields */
+const singleVersionModels = {
+  ShapeBox: defineRecord("ShapeBox", {
+    docs: "A box shape",
+    fields: {
+      left: P.Double,
+      right: P.Double,
+      top: P.Double,
+      bottom: P.Double,
+      color: P.Optional(P.String)
+    }
+  })
+};
+const singleVersionSchemaNarrow = defineSchema(singleVersionModels);
+export const singleVersionSchema = singleVersionSchemaNarrow;
+
+/** Two-version schema with field removal (color removed, fillColor + strokeColor + opacity added) */
+export const twoVersionFieldRemovalSchema = {
+  type: "versioned",
+  models: {
+    ShapeBox: defineRecord("ShapeBox", {
+      docs: "A box shape",
+      fields: {
+        left: P.Double,
+        right: P.Double,
+        top: P.Double,
+        bottom: P.Double,
+        fillColor: P.Optional(P.String),
+        strokeColor: P.Optional(P.String),
+        opacity: P.Optional(P.Double)
+      }
+    })
+  },
+  version: 2,
+  previous: singleVersionSchema
+};
+
+/** Two-version schema with additive change only (adds fillColor) */
+const addFillColorUpdate = defineSchemaUpdate("addFillColor", schema => ({
+  ShapeBox: schema.ShapeBox.addField("fillColor", P.Optional(P.String)).build()
+}));
+export const twoVersionAdditiveSchema = nextSchema(singleVersionSchemaNarrow).addSchemaUpdate(addFillColorUpdate).build();
+
+/** Schema with ref fields: tests import paths for record refs, DocumentRef, UserRef */
+const CircleRecord = defineRecord("Circle", {
+  docs: "A circle",
+  fields: {
+    radius: P.Double
+  }
+});
+const DocRef = {
+  type: "docRef"
+};
+const UserRefField = {
+  type: "userRef"
+};
+export const refFieldsSchema = defineSchema({
+  Circle: CircleRecord,
+  Drawing: defineRecord("Drawing", {
+    docs: "A drawing with references",
+    fields: {
+      mainShape: CircleRecord,
+      extraShapes: P.Array(modelToRef(CircleRecord)),
+      background: P.Optional(modelToRef(CircleRecord)),
+      attachment: DocRef,
+      owner: P.Optional(UserRefField)
+    }
+  })
+});
+
+/** Schema with union types: tests union variant interfaces, discriminated union, and type guards */
+const RectangleRecord = defineRecord("Rectangle", {
+  docs: "A rectangle",
+  fields: {
+    width: P.Double,
+    height: P.Double
+  }
+});
+export const unionTypesSchema = defineSchema({
+  Circle: CircleRecord,
+  Rectangle: RectangleRecord,
+  Shape: defineUnion("Shape", {
+    docs: "A shape",
+    variants: {
+      circle: CircleRecord,
+      rectangle: RectangleRecord
+    }
+  })
+});
+
+/** Schema with nested optionals: tests that optional inside array structures is preserved */
+export const nestedOptionalsSchema = defineSchema({
+  Config: defineRecord("Config", {
+    docs: "A config with nested optional fields",
+    fields: {
+      tags: P.Array(P.Optional(P.String)),
+      scores: P.Array(P.Optional(P.Double)),
+      label: P.Optional(P.String)
+    }
+  })
+});
+
+/** Two-version schema with derived fields (color split into fillColor + strokeColor) */
+export const twoVersionDerivedFieldsSchema = {
+  type: "versioned",
+  models: {
+    ShapeBox: defineRecord("ShapeBox", {
+      docs: "A box shape",
+      fields: {
+        left: P.Double,
+        right: P.Double,
+        top: P.Double,
+        bottom: P.Double,
+        fillColor: P.Optional(P.String),
+        strokeColor: P.Optional(P.String),
+        opacity: P.Optional(P.Double)
+      }
+    })
+  },
+  version: 2,
+  previous: singleVersionSchema,
+  migrations: {
+    ShapeBox: {
+      fillColor: {
+        derivedFrom: ["color"],
+        forward: ({
+          color
+        }) => color
+      },
+      strokeColor: {
+        derivedFrom: ["color"],
+        forward: ({
+          color
+        }) => color
+      }
+    }
+  }
+};
+
+/** Schema with aliased export key: export key "FooAlias" differs from model name "Foo" */
+export const aliasedEntryNameSchema = defineSchema({
+  FooAlias: defineRecord("Foo", {
+    docs: "A record exported under an alias",
+    fields: {
+      name: P.String
+    }
+  })
+});
+
+/** Schema with nested union: Entity union has a variant that points to another union (LivingBeing) */
+const AnimalRecord = defineRecord("Animal", {
+  docs: "An animal",
+  fields: {
+    species: P.String
+  }
+});
+const PlantRecord = defineRecord("Plant", {
+  docs: "A plant",
+  fields: {
+    genus: P.String
+  }
+});
+const LivingBeingUnion = defineUnion("LivingBeing", {
+  docs: "A living being",
+  variants: {
+    animal: AnimalRecord,
+    plant: PlantRecord
+  }
+});
+export const nestedUnionSchema = defineSchema({
+  Animal: AnimalRecord,
+  Plant: PlantRecord,
+  LivingBeing: LivingBeingUnion,
+  Entity: defineUnion("Entity", {
+    docs: "An entity",
+    variants: {
+      livingBeing: LivingBeingUnion
+    }
+  })
+});
+
+/**
+ * Two-version schema where a field starts as Optional(String) in v1 and becomes
+ * required (String) in v2. The internal schema must remain optional because
+ * documents written under v1 may legitimately omit the field.
+ */
+export const optionalToRequiredFieldSchema = (() => {
+  const v1 = defineSchema({
+    Item: defineRecord("Item", {
+      docs: "An item",
+      fields: {
+        name: P.String,
+        label: P.Optional(P.String)
+      }
+    })
+  });
+  return {
+    type: "versioned",
+    models: {
+      Item: defineRecord("Item", {
+        docs: "An item",
+        fields: {
+          name: P.String,
+          label: P.String
+        }
+      })
+    },
+    version: 2,
+    previous: v1
+  };
+})();
+
+/** Three-version chain: Item (name, color -> name, hexColor -> name, hexColor, tags) */
+export const threeVersionChainSchema = (() => {
+  const v1Models = {
+    Item: defineRecord("Item", {
+      docs: "",
+      fields: {
+        name: P.String,
+        color: P.Optional(P.String)
+      }
+    })
+  };
+  const v2Models = {
+    Item: defineRecord("Item", {
+      docs: "",
+      fields: {
+        name: P.String,
+        hexColor: P.Optional(P.String)
+      }
+    })
+  };
+  const v3Models = {
+    Item: defineRecord("Item", {
+      docs: "",
+      fields: {
+        name: P.String,
+        hexColor: P.Optional(P.String),
+        tags: P.Optional(P.String)
+      }
+    })
+  };
+  return {
+    type: "versioned",
+    models: v3Models,
+    version: 3,
+    previous: {
+      type: "versioned",
+      models: v2Models,
+      version: 2,
+      previous: {
+        type: "initial",
+        version: 1,
+        models: v1Models
+      }
+    }
+  };
+})();
+//# sourceMappingURL=fixtures.js.map

package/build/esm/utils/schema/__tests__/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","names":["defineRecord","defineSchema","defineSchemaUpdate","defineUnion","modelToRef","nextSchema","P","singleVersionModels","ShapeBox","docs","fields","left","Double","right","top","bottom","color","Optional","String","singleVersionSchemaNarrow","singleVersionSchema","twoVersionFieldRemovalSchema","type","models","fillColor","strokeColor","opacity","version","previous","addFillColorUpdate","schema","addField","build","twoVersionAdditiveSchema","addSchemaUpdate","CircleRecord","radius","DocRef","UserRefField","refFieldsSchema","Circle","Drawing","mainShape","extraShapes","Array","background","attachment","owner","RectangleRecord","width","height","unionTypesSchema","Rectangle","Shape","variants","circle","rectangle","nestedOptionalsSchema","Config","tags","scores","label","twoVersionDerivedFieldsSchema","migrations","derivedFrom","forward","aliasedEntryNameSchema","FooAlias","name","AnimalRecord","species","PlantRecord","genus","LivingBeingUnion","animal","plant","nestedUnionSchema","Animal","Plant","LivingBeing","Entity","livingBeing","optionalToRequiredFieldSchema","v1","Item","threeVersionChainSchema","v1Models","v2Models","hexColor","v3Models"],"sources":["fixtures.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { SchemaBuilder, SchemaDefinition } from \"@palantir/pack.schema\";\nimport {\n  defineRecord,\n  defineSchema,\n  defineSchemaUpdate,\n  defineUnion,\n  modelToRef,\n  nextSchema,\n} from \"@palantir/pack.schema\";\nimport * as P from \"@palantir/pack.schema\";\n\n/** Single-version schema: ShapeBox with 5 fields */\nconst singleVersionModels = {\n  ShapeBox: defineRecord(\"ShapeBox\", {\n    docs: \"A box shape\",\n    fields: {\n      left: P.Double,\n      right: P.Double,\n      top: P.Double,\n      bottom: P.Double,\n      color: P.Optional(P.String),\n    },\n  }),\n};\nconst singleVersionSchemaNarrow = defineSchema(singleVersionModels);\nexport const singleVersionSchema: SchemaDefinition = singleVersionSchemaNarrow;\n\n/** Two-version schema with field removal (color removed, fillColor + strokeColor + opacity added) */\nexport const twoVersionFieldRemovalSchema: SchemaDefinition = {\n  type: \"versioned\",\n  models: {\n    ShapeBox: defineRecord(\"ShapeBox\", {\n      docs: \"A box shape\",\n      fields: {\n        left: P.Double,\n        right: P.Double,\n        top: P.Double,\n        bottom: P.Double,\n        fillColor: P.Optional(P.String),\n        strokeColor: P.Optional(P.String),\n        opacity: P.Optional(P.Double),\n      },\n    }),\n  },\n  version: 2,\n  previous: singleVersionSchema,\n};\n\n/** Two-version schema with additive change only (adds fillColor) */\nconst addFillColorUpdate = defineSchemaUpdate(\n  \"addFillColor\",\n  (schema: SchemaBuilder<typeof singleVersionModels>) => ({\n    ShapeBox: schema.ShapeBox\n      .addField(\"fillColor\", P.Optional(P.String))\n      .build(),\n  }),\n);\n\nexport const twoVersionAdditiveSchema: SchemaDefinition = nextSchema(singleVersionSchemaNarrow)\n  .addSchemaUpdate(addFillColorUpdate)\n  .build();\n\n/** Schema with ref fields: tests import paths for record refs, DocumentRef, UserRef */\nconst CircleRecord = defineRecord(\"Circle\", {\n  docs: \"A circle\",\n  fields: {\n    radius: P.Double,\n  },\n});\n\nconst DocRef: P.DocRef = { type: \"docRef\" };\nconst UserRefField: P.UserRef = { type: \"userRef\" };\n\nexport const refFieldsSchema: SchemaDefinition = defineSchema({\n  Circle: CircleRecord,\n  Drawing: defineRecord(\"Drawing\", {\n    docs: \"A drawing with references\",\n    fields: {\n      mainShape: CircleRecord,\n      extraShapes: P.Array(modelToRef(CircleRecord)),\n      background: P.Optional(modelToRef(CircleRecord)),\n      attachment: DocRef,\n      owner: P.Optional(UserRefField),\n    },\n  }),\n});\n\n/** Schema with union types: tests union variant interfaces, discriminated union, and type guards */\nconst RectangleRecord = defineRecord(\"Rectangle\", {\n  docs: \"A rectangle\",\n  fields: {\n    width: P.Double,\n    height: P.Double,\n  },\n});\n\nexport const unionTypesSchema: SchemaDefinition = defineSchema({\n  Circle: CircleRecord,\n  Rectangle: RectangleRecord,\n  Shape: defineUnion(\"Shape\", {\n    docs: \"A shape\",\n    variants: {\n      circle: CircleRecord,\n      rectangle: RectangleRecord,\n    },\n  }),\n});\n\n/** Schema with nested optionals: tests that optional inside array structures is preserved */\nexport const nestedOptionalsSchema: SchemaDefinition = defineSchema({\n  Config: defineRecord(\"Config\", {\n    docs: \"A config with nested optional fields\",\n    fields: {\n      tags: P.Array(P.Optional(P.String)),\n      scores: P.Array(P.Optional(P.Double)),\n      label: P.Optional(P.String),\n    },\n  }),\n});\n\n/** Two-version schema with derived fields (color split into fillColor + strokeColor) */\nexport const twoVersionDerivedFieldsSchema: SchemaDefinition = {\n  type: \"versioned\",\n  models: {\n    ShapeBox: defineRecord(\"ShapeBox\", {\n      docs: \"A box shape\",\n      fields: {\n        left: P.Double,\n        right: P.Double,\n        top: P.Double,\n        bottom: P.Double,\n        fillColor: P.Optional(P.String),\n        strokeColor: P.Optional(P.String),\n        opacity: P.Optional(P.Double),\n      },\n    }),\n  },\n  version: 2,\n  previous: singleVersionSchema,\n  migrations: {\n    ShapeBox: {\n      fillColor: {\n        derivedFrom: [\"color\"],\n        forward: ({ color }: Record<string, unknown>) => color,\n      },\n      strokeColor: {\n        derivedFrom: [\"color\"],\n        forward: ({ color }: Record<string, unknown>) => color,\n      },\n    },\n  },\n};\n\n/** Schema with aliased export key: export key \"FooAlias\" differs from model name \"Foo\" */\nexport const aliasedEntryNameSchema: SchemaDefinition = defineSchema({\n  FooAlias: defineRecord(\"Foo\", {\n    docs: \"A record exported under an alias\",\n    fields: {\n      name: P.String,\n    },\n  }),\n});\n\n/** Schema with nested union: Entity union has a variant that points to another union (LivingBeing) */\nconst AnimalRecord = defineRecord(\"Animal\", {\n  docs: \"An animal\",\n  fields: { species: P.String },\n});\n\nconst PlantRecord = defineRecord(\"Plant\", {\n  docs: \"A plant\",\n  fields: { genus: P.String },\n});\n\nconst LivingBeingUnion = defineUnion(\"LivingBeing\", {\n  docs: \"A living being\",\n  variants: {\n    animal: AnimalRecord,\n    plant: PlantRecord,\n  },\n});\n\nexport const nestedUnionSchema: SchemaDefinition = defineSchema({\n  Animal: AnimalRecord,\n  Plant: PlantRecord,\n  LivingBeing: LivingBeingUnion,\n  Entity: defineUnion(\"Entity\", {\n    docs: \"An entity\",\n    variants: {\n      livingBeing: LivingBeingUnion,\n    },\n  }),\n});\n\n/**\n * Two-version schema where a field starts as Optional(String) in v1 and becomes\n * required (String) in v2. The internal schema must remain optional because\n * documents written under v1 may legitimately omit the field.\n */\nexport const optionalToRequiredFieldSchema: SchemaDefinition = (() => {\n  const v1 = defineSchema({\n    Item: defineRecord(\"Item\", {\n      docs: \"An item\",\n      fields: {\n        name: P.String,\n        label: P.Optional(P.String),\n      },\n    }),\n  });\n  return {\n    type: \"versioned\" as const,\n    models: {\n      Item: defineRecord(\"Item\", {\n        docs: \"An item\",\n        fields: {\n          name: P.String,\n          label: P.String,\n        },\n      }),\n    },\n    version: 2,\n    previous: v1,\n  };\n})();\n\n/** Three-version chain: Item (name, color -> name, hexColor -> name, hexColor, tags) */\nexport const threeVersionChainSchema: SchemaDefinition = (() => {\n  const v1Models = {\n    Item: defineRecord(\"Item\", {\n      docs: \"\",\n      fields: {\n        name: P.String,\n        color: P.Optional(P.String),\n      },\n    }),\n  };\n  const v2Models = {\n    Item: defineRecord(\"Item\", {\n      docs: \"\",\n      fields: {\n        name: P.String,\n        hexColor: P.Optional(P.String),\n      },\n    }),\n  };\n  const v3Models = {\n    Item: defineRecord(\"Item\", {\n      docs: \"\",\n      fields: {\n        name: P.String,\n        hexColor: P.Optional(P.String),\n        tags: P.Optional(P.String),\n      },\n    }),\n  };\n  return {\n    type: \"versioned\",\n    models: v3Models,\n    version: 3,\n    previous: {\n      type: \"versioned\",\n      models: v2Models,\n      version: 2,\n      previous: { type: \"initial\", version: 1, models: v1Models },\n    },\n  };\n})();\n"],"mappings":"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","ignoreList":[]}

package/build/esm/utils/schema/__tests__/generateInternalFromSchema.test.js

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import path from "path";
+import { describe, expect, it } from "vitest";
+import { generateInternalFromChain } from "../generateInternalFromSchema.js";
+import { resolveSchemaChain } from "../resolveSchemaChain.js";
+import { nestedOptionalsSchema, nestedUnionSchema, optionalToRequiredFieldSchema, singleVersionSchema, twoVersionDerivedFieldsSchema, twoVersionFieldRemovalSchema } from "./fixtures.js";
+import { formatInternalTypesSnapshot } from "./snapshotUtils.js";
+describe("generateInternalFromChain", () => {
+  const snapshotDir = path.join(__dirname, "__snapshots__", "generateInternalFromSchema");
+  it("single-version schema", async () => {
+    const result = generateInternalFromChain(resolveSchemaChain(singleVersionSchema));
+    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "single-version.snap"));
+  });
+  it("nested optionals inside arrays", async () => {
+    const result = generateInternalFromChain(resolveSchemaChain(nestedOptionalsSchema));
+    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "nested-optionals.snap"));
+  });
+  it("two-version field removal", async () => {
+    const result = generateInternalFromChain(resolveSchemaChain(twoVersionFieldRemovalSchema));
+    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-field-removal.snap"));
+  });
+  it("two-version derived fields", async () => {
+    const result = generateInternalFromChain(resolveSchemaChain(twoVersionDerivedFieldsSchema));
+    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-derived-fields.snap"));
+  });
+  it("nested union schema generates upgrade registries for all variant targets", async () => {
+    const result = generateInternalFromChain(resolveSchemaChain(nestedUnionSchema));
+    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "nested-union.snap"));
+  });
+  it("field optional in v1 and required in v2 stays optional in internal schema", async () => {
+    const result = generateInternalFromChain(resolveSchemaChain(optionalToRequiredFieldSchema));
+    // "label" is Optional(String) in v1 but String in v2.
+    // The internal Zod schema must keep it optional because v1 documents
+    // may legitimately omit the field.
+    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-optional-fields.snap"));
+  });
+});
+//# sourceMappingURL=generateInternalFromSchema.test.js.map

package/build/esm/utils/schema/__tests__/generateInternalFromSchema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateInternalFromSchema.test.js","names":["path","describe","expect","it","generateInternalFromChain","resolveSchemaChain","nestedOptionalsSchema","nestedUnionSchema","optionalToRequiredFieldSchema","singleVersionSchema","twoVersionDerivedFieldsSchema","twoVersionFieldRemovalSchema","formatInternalTypesSnapshot","snapshotDir","join","__dirname","result","toMatchFileSnapshot"],"sources":["generateInternalFromSchema.test.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport path from \"path\";\nimport { describe, expect, it } from \"vitest\";\nimport { generateInternalFromChain } from \"../generateInternalFromSchema.js\";\nimport { resolveSchemaChain } from \"../resolveSchemaChain.js\";\nimport {\n  nestedOptionalsSchema,\n  nestedUnionSchema,\n  optionalToRequiredFieldSchema,\n  singleVersionSchema,\n  twoVersionDerivedFieldsSchema,\n  twoVersionFieldRemovalSchema,\n} from \"./fixtures.js\";\nimport { formatInternalTypesSnapshot } from \"./snapshotUtils.js\";\n\ndescribe(\"generateInternalFromChain\", () => {\n  const snapshotDir = path.join(__dirname, \"__snapshots__\", \"generateInternalFromSchema\");\n\n  it(\"single-version schema\", async () => {\n    const result = generateInternalFromChain(resolveSchemaChain(singleVersionSchema));\n    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"single-version.snap\"),\n    );\n  });\n\n  it(\"nested optionals inside arrays\", async () => {\n    const result = generateInternalFromChain(resolveSchemaChain(nestedOptionalsSchema));\n    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"nested-optionals.snap\"),\n    );\n  });\n\n  it(\"two-version field removal\", async () => {\n    const result = generateInternalFromChain(resolveSchemaChain(twoVersionFieldRemovalSchema));\n    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-field-removal.snap\"),\n    );\n  });\n\n  it(\"two-version derived fields\", async () => {\n    const result = generateInternalFromChain(resolveSchemaChain(twoVersionDerivedFieldsSchema));\n    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-derived-fields.snap\"),\n    );\n  });\n\n  it(\"nested union schema generates upgrade registries for all variant targets\", async () => {\n    const result = generateInternalFromChain(resolveSchemaChain(nestedUnionSchema));\n    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"nested-union.snap\"),\n    );\n  });\n\n  it(\"field optional in v1 and required in v2 stays optional in internal schema\", async () => {\n    const result = generateInternalFromChain(resolveSchemaChain(optionalToRequiredFieldSchema));\n    // \"label\" is Optional(String) in v1 but String in v2.\n    // The internal Zod schema must keep it optional because v1 documents\n    // may legitimately omit the field.\n    await expect(await formatInternalTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-optional-fields.snap\"),\n    );\n  });\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,IAAI,MAAM,MAAM;AACvB,SAASC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAC7C,SAASC,yBAAyB,QAAQ,kCAAkC;AAC5E,SAASC,kBAAkB,QAAQ,0BAA0B;AAC7D,SACEC,qBAAqB,EACrBC,iBAAiB,EACjBC,6BAA6B,EAC7BC,mBAAmB,EACnBC,6BAA6B,EAC7BC,4BAA4B,QACvB,eAAe;AACtB,SAASC,2BAA2B,QAAQ,oBAAoB;AAEhEX,QAAQ,CAAC,2BAA2B,EAAE,MAAM;EAC1C,MAAMY,WAAW,GAAGb,IAAI,CAACc,IAAI,CAACC,SAAS,EAAE,eAAe,EAAE,4BAA4B,CAAC;EAEvFZ,EAAE,CAAC,uBAAuB,EAAE,YAAY;IACtC,MAAMa,MAAM,GAAGZ,yBAAyB,CAACC,kBAAkB,CAACI,mBAAmB,CAAC,CAAC;IACjF,MAAMP,MAAM,CAAC,MAAMU,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEjB,IAAI,CAACc,IAAI,CAACD,WAAW,EAAE,qBAAqB,CAC9C,CAAC;EACH,CAAC,CAAC;EAEFV,EAAE,CAAC,gCAAgC,EAAE,YAAY;IAC/C,MAAMa,MAAM,GAAGZ,yBAAyB,CAACC,kBAAkB,CAACC,qBAAqB,CAAC,CAAC;IACnF,MAAMJ,MAAM,CAAC,MAAMU,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEjB,IAAI,CAACc,IAAI,CAACD,WAAW,EAAE,uBAAuB,CAChD,CAAC;EACH,CAAC,CAAC;EAEFV,EAAE,CAAC,2BAA2B,EAAE,YAAY;IAC1C,MAAMa,MAAM,GAAGZ,yBAAyB,CAACC,kBAAkB,CAACM,4BAA4B,CAAC,CAAC;IAC1F,MAAMT,MAAM,CAAC,MAAMU,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEjB,IAAI,CAACc,IAAI,CAACD,WAAW,EAAE,gCAAgC,CACzD,CAAC;EACH,CAAC,CAAC;EAEFV,EAAE,CAAC,4BAA4B,EAAE,YAAY;IAC3C,MAAMa,MAAM,GAAGZ,yBAAyB,CAACC,kBAAkB,CAACK,6BAA6B,CAAC,CAAC;IAC3F,MAAMR,MAAM,CAAC,MAAMU,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEjB,IAAI,CAACc,IAAI,CAACD,WAAW,EAAE,iCAAiC,CAC1D,CAAC;EACH,CAAC,CAAC;EAEFV,EAAE,CAAC,0EAA0E,EAAE,YAAY;IACzF,MAAMa,MAAM,GAAGZ,yBAAyB,CAACC,kBAAkB,CAACE,iBAAiB,CAAC,CAAC;IAC/E,MAAML,MAAM,CAAC,MAAMU,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEjB,IAAI,CAACc,IAAI,CAACD,WAAW,EAAE,mBAAmB,CAC5C,CAAC;EACH,CAAC,CAAC;EAEFV,EAAE,CAAC,2EAA2E,EAAE,YAAY;IAC1F,MAAMa,MAAM,GAAGZ,yBAAyB,CAACC,kBAAkB,CAACG,6BAA6B,CAAC,CAAC;IAC3F;IACA;IACA;IACA,MAAMN,MAAM,CAAC,MAAMU,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEjB,IAAI,CAACc,IAAI,CAACD,WAAW,EAAE,kCAAkC,CAC3D,CAAC;EACH,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/build/esm/utils/schema/__tests__/generateModelMetadataFromSchema.test.js

@@ -0,0 +1,42 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import path from "path";
+import { describe, expect, it } from "vitest";
+import { generateModelMetadataFromChain } from "../generateModelMetadataFromSchema.js";
+import { resolveSchemaChain } from "../resolveSchemaChain.js";
+import { singleVersionSchema, threeVersionChainSchema, twoVersionFieldRemovalSchema, unionTypesSchema } from "./fixtures.js";
+import { formatModelMetadataSnapshot } from "./snapshotUtils.js";
+describe("generateModelMetadataFromChain", () => {
+  const snapshotDir = path.join(__dirname, "__snapshots__", "generateModelMetadataFromSchema");
+  it("single-version schema", async () => {
+    const result = generateModelMetadataFromChain(resolveSchemaChain(singleVersionSchema));
+    await expect(await formatModelMetadataSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "single-version.snap"));
+  });
+  it("two-version field removal", async () => {
+    const result = generateModelMetadataFromChain(resolveSchemaChain(twoVersionFieldRemovalSchema, 1), 1);
+    await expect(await formatModelMetadataSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-field-removal.snap"));
+  });
+  it("three-version chain", async () => {
+    const result = generateModelMetadataFromChain(resolveSchemaChain(threeVersionChainSchema, 1), 1);
+    await expect(await formatModelMetadataSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "three-version-chain.snap"));
+  });
+  it("union types schema", async () => {
+    const result = generateModelMetadataFromChain(resolveSchemaChain(unionTypesSchema));
+    await expect(await formatModelMetadataSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "union-types.snap"));
+  });
+});
+//# sourceMappingURL=generateModelMetadataFromSchema.test.js.map

package/build/esm/utils/schema/__tests__/generateModelMetadataFromSchema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateModelMetadataFromSchema.test.js","names":["path","describe","expect","it","generateModelMetadataFromChain","resolveSchemaChain","singleVersionSchema","threeVersionChainSchema","twoVersionFieldRemovalSchema","unionTypesSchema","formatModelMetadataSnapshot","snapshotDir","join","__dirname","result","toMatchFileSnapshot"],"sources":["generateModelMetadataFromSchema.test.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport path from \"path\";\nimport { describe, expect, it } from \"vitest\";\nimport { generateModelMetadataFromChain } from \"../generateModelMetadataFromSchema.js\";\nimport { resolveSchemaChain } from \"../resolveSchemaChain.js\";\nimport {\n  singleVersionSchema,\n  threeVersionChainSchema,\n  twoVersionFieldRemovalSchema,\n  unionTypesSchema,\n} from \"./fixtures.js\";\nimport { formatModelMetadataSnapshot } from \"./snapshotUtils.js\";\n\ndescribe(\"generateModelMetadataFromChain\", () => {\n  const snapshotDir = path.join(__dirname, \"__snapshots__\", \"generateModelMetadataFromSchema\");\n\n  it(\"single-version schema\", async () => {\n    const result = generateModelMetadataFromChain(resolveSchemaChain(singleVersionSchema));\n    await expect(await formatModelMetadataSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"single-version.snap\"),\n    );\n  });\n\n  it(\"two-version field removal\", async () => {\n    const result = generateModelMetadataFromChain(\n      resolveSchemaChain(twoVersionFieldRemovalSchema, 1),\n      1,\n    );\n    await expect(await formatModelMetadataSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-field-removal.snap\"),\n    );\n  });\n\n  it(\"three-version chain\", async () => {\n    const result = generateModelMetadataFromChain(\n      resolveSchemaChain(threeVersionChainSchema, 1),\n      1,\n    );\n    await expect(await formatModelMetadataSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"three-version-chain.snap\"),\n    );\n  });\n\n  it(\"union types schema\", async () => {\n    const result = generateModelMetadataFromChain(resolveSchemaChain(unionTypesSchema));\n    await expect(await formatModelMetadataSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"union-types.snap\"),\n    );\n  });\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,IAAI,MAAM,MAAM;AACvB,SAASC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAC7C,SAASC,8BAA8B,QAAQ,uCAAuC;AACtF,SAASC,kBAAkB,QAAQ,0BAA0B;AAC7D,SACEC,mBAAmB,EACnBC,uBAAuB,EACvBC,4BAA4B,EAC5BC,gBAAgB,QACX,eAAe;AACtB,SAASC,2BAA2B,QAAQ,oBAAoB;AAEhET,QAAQ,CAAC,gCAAgC,EAAE,MAAM;EAC/C,MAAMU,WAAW,GAAGX,IAAI,CAACY,IAAI,CAACC,SAAS,EAAE,eAAe,EAAE,iCAAiC,CAAC;EAE5FV,EAAE,CAAC,uBAAuB,EAAE,YAAY;IACtC,MAAMW,MAAM,GAAGV,8BAA8B,CAACC,kBAAkB,CAACC,mBAAmB,CAAC,CAAC;IACtF,MAAMJ,MAAM,CAAC,MAAMQ,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEf,IAAI,CAACY,IAAI,CAACD,WAAW,EAAE,qBAAqB,CAC9C,CAAC;EACH,CAAC,CAAC;EAEFR,EAAE,CAAC,2BAA2B,EAAE,YAAY;IAC1C,MAAMW,MAAM,GAAGV,8BAA8B,CAC3CC,kBAAkB,CAACG,4BAA4B,EAAE,CAAC,CAAC,EACnD,CACF,CAAC;IACD,MAAMN,MAAM,CAAC,MAAMQ,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEf,IAAI,CAACY,IAAI,CAACD,WAAW,EAAE,gCAAgC,CACzD,CAAC;EACH,CAAC,CAAC;EAEFR,EAAE,CAAC,qBAAqB,EAAE,YAAY;IACpC,MAAMW,MAAM,GAAGV,8BAA8B,CAC3CC,kBAAkB,CAACE,uBAAuB,EAAE,CAAC,CAAC,EAC9C,CACF,CAAC;IACD,MAAML,MAAM,CAAC,MAAMQ,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEf,IAAI,CAACY,IAAI,CAACD,WAAW,EAAE,0BAA0B,CACnD,CAAC;EACH,CAAC,CAAC;EAEFR,EAAE,CAAC,oBAAoB,EAAE,YAAY;IACnC,MAAMW,MAAM,GAAGV,8BAA8B,CAACC,kBAAkB,CAACI,gBAAgB,CAAC,CAAC;IACnF,MAAMP,MAAM,CAAC,MAAMQ,2BAA2B,CAACI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACzEf,IAAI,CAACY,IAAI,CAACD,WAAW,EAAE,kBAAkB,CAC3C,CAAC;EACH,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/build/esm/utils/schema/__tests__/generateScopeFromSchema.test.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import path from "path";
+import { describe, expect, it } from "vitest";
+import { generateScopeFromChain } from "../generateScopeFromSchema.js";
+import { resolveSchemaChain } from "../resolveSchemaChain.js";
+import { singleVersionSchema, twoVersionFieldRemovalSchema, unionTypesSchema } from "./fixtures.js";
+import { formatSingleSnapshot } from "./snapshotUtils.js";
+describe("generateScopeFromChain", () => {
+  const snapshotDir = path.join(__dirname, "__snapshots__", "generateScopeFromSchema");
+  it("single-version schema", async () => {
+    const result = generateScopeFromChain(resolveSchemaChain(singleVersionSchema));
+    await expect(await formatSingleSnapshot("versionedDocRef.ts", result)).toMatchFileSnapshot(path.join(snapshotDir, "single-version.snap"));
+  });
+  it("two-version field removal", async () => {
+    const result = generateScopeFromChain(resolveSchemaChain(twoVersionFieldRemovalSchema, 1), 1);
+    await expect(await formatSingleSnapshot("versionedDocRef.ts", result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-field-removal.snap"));
+  });
+  it("union types schema", async () => {
+    const result = generateScopeFromChain(resolveSchemaChain(unionTypesSchema));
+    await expect(await formatSingleSnapshot("versionedDocRef.ts", result)).toMatchFileSnapshot(path.join(snapshotDir, "union-types.snap"));
+  });
+});
+//# sourceMappingURL=generateScopeFromSchema.test.js.map

package/build/esm/utils/schema/__tests__/generateScopeFromSchema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateScopeFromSchema.test.js","names":["path","describe","expect","it","generateScopeFromChain","resolveSchemaChain","singleVersionSchema","twoVersionFieldRemovalSchema","unionTypesSchema","formatSingleSnapshot","snapshotDir","join","__dirname","result","toMatchFileSnapshot"],"sources":["generateScopeFromSchema.test.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport path from \"path\";\nimport { describe, expect, it } from \"vitest\";\nimport { generateScopeFromChain } from \"../generateScopeFromSchema.js\";\nimport { resolveSchemaChain } from \"../resolveSchemaChain.js\";\nimport { singleVersionSchema, twoVersionFieldRemovalSchema, unionTypesSchema } from \"./fixtures.js\";\nimport { formatSingleSnapshot } from \"./snapshotUtils.js\";\n\ndescribe(\"generateScopeFromChain\", () => {\n  const snapshotDir = path.join(__dirname, \"__snapshots__\", \"generateScopeFromSchema\");\n\n  it(\"single-version schema\", async () => {\n    const result = generateScopeFromChain(resolveSchemaChain(singleVersionSchema));\n    await expect(await formatSingleSnapshot(\"versionedDocRef.ts\", result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"single-version.snap\"),\n    );\n  });\n\n  it(\"two-version field removal\", async () => {\n    const result = generateScopeFromChain(resolveSchemaChain(twoVersionFieldRemovalSchema, 1), 1);\n    await expect(await formatSingleSnapshot(\"versionedDocRef.ts\", result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-field-removal.snap\"),\n    );\n  });\n\n  it(\"union types schema\", async () => {\n    const result = generateScopeFromChain(resolveSchemaChain(unionTypesSchema));\n    await expect(await formatSingleSnapshot(\"versionedDocRef.ts\", result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"union-types.snap\"),\n    );\n  });\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,IAAI,MAAM,MAAM;AACvB,SAASC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAC7C,SAASC,sBAAsB,QAAQ,+BAA+B;AACtE,SAASC,kBAAkB,QAAQ,0BAA0B;AAC7D,SAASC,mBAAmB,EAAEC,4BAA4B,EAAEC,gBAAgB,QAAQ,eAAe;AACnG,SAASC,oBAAoB,QAAQ,oBAAoB;AAEzDR,QAAQ,CAAC,wBAAwB,EAAE,MAAM;EACvC,MAAMS,WAAW,GAAGV,IAAI,CAACW,IAAI,CAACC,SAAS,EAAE,eAAe,EAAE,yBAAyB,CAAC;EAEpFT,EAAE,CAAC,uBAAuB,EAAE,YAAY;IACtC,MAAMU,MAAM,GAAGT,sBAAsB,CAACC,kBAAkB,CAACC,mBAAmB,CAAC,CAAC;IAC9E,MAAMJ,MAAM,CAAC,MAAMO,oBAAoB,CAAC,oBAAoB,EAAEI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACxFd,IAAI,CAACW,IAAI,CAACD,WAAW,EAAE,qBAAqB,CAC9C,CAAC;EACH,CAAC,CAAC;EAEFP,EAAE,CAAC,2BAA2B,EAAE,YAAY;IAC1C,MAAMU,MAAM,GAAGT,sBAAsB,CAACC,kBAAkB,CAACE,4BAA4B,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7F,MAAML,MAAM,CAAC,MAAMO,oBAAoB,CAAC,oBAAoB,EAAEI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACxFd,IAAI,CAACW,IAAI,CAACD,WAAW,EAAE,gCAAgC,CACzD,CAAC;EACH,CAAC,CAAC;EAEFP,EAAE,CAAC,oBAAoB,EAAE,YAAY;IACnC,MAAMU,MAAM,GAAGT,sBAAsB,CAACC,kBAAkB,CAACG,gBAAgB,CAAC,CAAC;IAC3E,MAAMN,MAAM,CAAC,MAAMO,oBAAoB,CAAC,oBAAoB,EAAEI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACxFd,IAAI,CAACW,IAAI,CAACD,WAAW,EAAE,kBAAkB,CAC3C,CAAC;EACH,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/build/esm/utils/schema/__tests__/generateVersionedTypesFromSchema.test.js

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import path from "path";
+import { describe, expect, it } from "vitest";
+import { generateVersionedTypesFromChain } from "../generateVersionedTypesFromSchema.js";
+import { resolveSchemaChain } from "../resolveSchemaChain.js";
+import { aliasedEntryNameSchema, nestedUnionSchema, refFieldsSchema, singleVersionSchema, threeVersionChainSchema, twoVersionAdditiveSchema, twoVersionFieldRemovalSchema, unionTypesSchema } from "./fixtures.js";
+import { formatVersionedTypesSnapshot } from "./snapshotUtils.js";
+describe("generateVersionedTypesFromChain", () => {
+  const snapshotDir = path.join(__dirname, "__snapshots__", "generateVersionedTypesFromSchema");
+  it("single-version schema", async () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(singleVersionSchema));
+    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "single-version.snap"));
+  });
+  it("two-version additive change", async () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(twoVersionAdditiveSchema, 1), 1);
+    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-additive.snap"));
+  });
+  it("two-version field removal", async () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(twoVersionFieldRemovalSchema, 1), 1);
+    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-field-removal.snap"));
+  });
+  it("three-version chain", async () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(threeVersionChainSchema, 1), 1);
+    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "three-version-chain.snap"));
+  });
+  it("schema with ref fields", async () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(refFieldsSchema));
+    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "ref-fields.snap"));
+  });
+  it("schema with union types", async () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(unionTypesSchema));
+    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "union-types.snap"));
+  });
+  it("preserves aliased export name when export key differs from model name", async () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(aliasedEntryNameSchema));
+    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "alias-types.snap"));
+  });
+  it("includes value field for union variants that reference another union", async () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(nestedUnionSchema));
+    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "union-reference-union.snap"));
+  });
+  it("respects minSupportedVersion default (latest only)", () => {
+    const result = generateVersionedTypesFromChain(resolveSchemaChain(twoVersionAdditiveSchema));
+    expect(result.readTypes.size).toBe(1);
+    expect(result.readTypes.has(2)).toBe(true);
+    expect(result.readTypes.has(1)).toBe(false);
+  });
+});
+//# sourceMappingURL=generateVersionedTypesFromSchema.test.js.map

package/build/esm/utils/schema/__tests__/generateVersionedTypesFromSchema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateVersionedTypesFromSchema.test.js","names":["path","describe","expect","it","generateVersionedTypesFromChain","resolveSchemaChain","aliasedEntryNameSchema","nestedUnionSchema","refFieldsSchema","singleVersionSchema","threeVersionChainSchema","twoVersionAdditiveSchema","twoVersionFieldRemovalSchema","unionTypesSchema","formatVersionedTypesSnapshot","snapshotDir","join","__dirname","result","toMatchFileSnapshot","readTypes","size","toBe","has"],"sources":["generateVersionedTypesFromSchema.test.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport path from \"path\";\nimport { describe, expect, it } from \"vitest\";\nimport { generateVersionedTypesFromChain } from \"../generateVersionedTypesFromSchema.js\";\nimport { resolveSchemaChain } from \"../resolveSchemaChain.js\";\nimport {\n  aliasedEntryNameSchema,\n  nestedUnionSchema,\n  refFieldsSchema,\n  singleVersionSchema,\n  threeVersionChainSchema,\n  twoVersionAdditiveSchema,\n  twoVersionFieldRemovalSchema,\n  unionTypesSchema,\n} from \"./fixtures.js\";\nimport { formatVersionedTypesSnapshot } from \"./snapshotUtils.js\";\n\ndescribe(\"generateVersionedTypesFromChain\", () => {\n  const snapshotDir = path.join(__dirname, \"__snapshots__\", \"generateVersionedTypesFromSchema\");\n\n  it(\"single-version schema\", async () => {\n    const result = generateVersionedTypesFromChain(resolveSchemaChain(singleVersionSchema));\n    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"single-version.snap\"),\n    );\n  });\n\n  it(\"two-version additive change\", async () => {\n    const result = generateVersionedTypesFromChain(\n      resolveSchemaChain(twoVersionAdditiveSchema, 1),\n      1,\n    );\n    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-additive.snap\"),\n    );\n  });\n\n  it(\"two-version field removal\", async () => {\n    const result = generateVersionedTypesFromChain(\n      resolveSchemaChain(twoVersionFieldRemovalSchema, 1),\n      1,\n    );\n    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-field-removal.snap\"),\n    );\n  });\n\n  it(\"three-version chain\", async () => {\n    const result = generateVersionedTypesFromChain(\n      resolveSchemaChain(threeVersionChainSchema, 1),\n      1,\n    );\n    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"three-version-chain.snap\"),\n    );\n  });\n\n  it(\"schema with ref fields\", async () => {\n    const result = generateVersionedTypesFromChain(resolveSchemaChain(refFieldsSchema));\n    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"ref-fields.snap\"),\n    );\n  });\n\n  it(\"schema with union types\", async () => {\n    const result = generateVersionedTypesFromChain(resolveSchemaChain(unionTypesSchema));\n    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"union-types.snap\"),\n    );\n  });\n\n  it(\"preserves aliased export name when export key differs from model name\", async () => {\n    const result = generateVersionedTypesFromChain(resolveSchemaChain(aliasedEntryNameSchema));\n    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"alias-types.snap\"),\n    );\n  });\n\n  it(\"includes value field for union variants that reference another union\", async () => {\n    const result = generateVersionedTypesFromChain(resolveSchemaChain(nestedUnionSchema));\n    await expect(await formatVersionedTypesSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"union-reference-union.snap\"),\n    );\n  });\n\n  it(\"respects minSupportedVersion default (latest only)\", () => {\n    const result = generateVersionedTypesFromChain(resolveSchemaChain(twoVersionAdditiveSchema));\n    expect(result.readTypes.size).toBe(1);\n    expect(result.readTypes.has(2)).toBe(true);\n    expect(result.readTypes.has(1)).toBe(false);\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/build/esm/utils/schema/__tests__/generateVersionedZodFromSchema.test.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import path from "path";
+import { describe, expect, it } from "vitest";
+import { generateVersionedZodFromChain } from "../generateVersionedZodFromSchema.js";
+import { resolveSchemaChain } from "../resolveSchemaChain.js";
+import { nestedOptionalsSchema, nestedUnionSchema, refFieldsSchema, singleVersionSchema, twoVersionAdditiveSchema, twoVersionFieldRemovalSchema, unionTypesSchema } from "./fixtures.js";
+import { formatVersionedZodSnapshot } from "./snapshotUtils.js";
+describe("generateVersionedZodFromChain", () => {
+  const snapshotDir = path.join(__dirname, "__snapshots__", "generateVersionedZodFromSchema");
+  it("single-version schema", async () => {
+    const result = generateVersionedZodFromChain(resolveSchemaChain(singleVersionSchema));
+    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "single-version.snap"));
+  });
+  it("two-version additive change", async () => {
+    const result = generateVersionedZodFromChain(resolveSchemaChain(twoVersionAdditiveSchema, 1), 1);
+    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-additive.snap"));
+  });
+  it("two-version field removal", async () => {
+    const result = generateVersionedZodFromChain(resolveSchemaChain(twoVersionFieldRemovalSchema, 1), 1);
+    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version-field-removal.snap"));
+  });
+  it("schema with union types", async () => {
+    const result = generateVersionedZodFromChain(resolveSchemaChain(unionTypesSchema));
+    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "union-types.snap"));
+  });
+  it("schema with ref fields", async () => {
+    const result = generateVersionedZodFromChain(resolveSchemaChain(refFieldsSchema));
+    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "ref-fields.snap"));
+  });
+  it("nested optionals inside arrays", async () => {
+    const result = generateVersionedZodFromChain(resolveSchemaChain(nestedOptionalsSchema));
+    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "nested-optionals.snap"));
+  });
+  it("includes value field in Zod schema for union variants that reference another union", async () => {
+    const result = generateVersionedZodFromChain(resolveSchemaChain(nestedUnionSchema));
+    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(path.join(snapshotDir, "union-reference-union.snap"));
+  });
+  it("respects minSupportedVersion default (latest only)", () => {
+    const result = generateVersionedZodFromChain(resolveSchemaChain(twoVersionAdditiveSchema));
+    expect(result.zodSchemas.size).toBe(1);
+    expect(result.zodSchemas.has(2)).toBe(true);
+    expect(result.zodSchemas.has(1)).toBe(false);
+  });
+});
+//# sourceMappingURL=generateVersionedZodFromSchema.test.js.map