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

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateVersionedZodFromSchema.test.js","names":["path","describe","expect","it","generateVersionedZodFromChain","resolveSchemaChain","nestedOptionalsSchema","nestedUnionSchema","refFieldsSchema","singleVersionSchema","twoVersionAdditiveSchema","twoVersionFieldRemovalSchema","unionTypesSchema","formatVersionedZodSnapshot","snapshotDir","join","__dirname","result","toMatchFileSnapshot","zodSchemas","size","toBe","has"],"sources":["generateVersionedZodFromSchema.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 { generateVersionedZodFromChain } from \"../generateVersionedZodFromSchema.js\";\nimport { resolveSchemaChain } from \"../resolveSchemaChain.js\";\nimport {\n  nestedOptionalsSchema,\n  nestedUnionSchema,\n  refFieldsSchema,\n  singleVersionSchema,\n  twoVersionAdditiveSchema,\n  twoVersionFieldRemovalSchema,\n  unionTypesSchema,\n} from \"./fixtures.js\";\nimport { formatVersionedZodSnapshot } from \"./snapshotUtils.js\";\n\ndescribe(\"generateVersionedZodFromChain\", () => {\n  const snapshotDir = path.join(__dirname, \"__snapshots__\", \"generateVersionedZodFromSchema\");\n\n  it(\"single-version schema\", async () => {\n    const result = generateVersionedZodFromChain(resolveSchemaChain(singleVersionSchema));\n    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"single-version.snap\"),\n    );\n  });\n\n  it(\"two-version additive change\", async () => {\n    const result = generateVersionedZodFromChain(\n      resolveSchemaChain(twoVersionAdditiveSchema, 1),\n      1,\n    );\n    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-additive.snap\"),\n    );\n  });\n\n  it(\"two-version field removal\", async () => {\n    const result = generateVersionedZodFromChain(\n      resolveSchemaChain(twoVersionFieldRemovalSchema, 1),\n      1,\n    );\n    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version-field-removal.snap\"),\n    );\n  });\n\n  it(\"schema with union types\", async () => {\n    const result = generateVersionedZodFromChain(resolveSchemaChain(unionTypesSchema));\n    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"union-types.snap\"),\n    );\n  });\n\n  it(\"schema with ref fields\", async () => {\n    const result = generateVersionedZodFromChain(resolveSchemaChain(refFieldsSchema));\n    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"ref-fields.snap\"),\n    );\n  });\n\n  it(\"nested optionals inside arrays\", async () => {\n    const result = generateVersionedZodFromChain(resolveSchemaChain(nestedOptionalsSchema));\n    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"nested-optionals.snap\"),\n    );\n  });\n\n  it(\"includes value field in Zod schema for union variants that reference another union\", async () => {\n    const result = generateVersionedZodFromChain(resolveSchemaChain(nestedUnionSchema));\n    await expect(await formatVersionedZodSnapshot(result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"union-reference-union.snap\"),\n    );\n  });\n\n  it(\"respects minSupportedVersion default (latest only)\", () => {\n    const result = generateVersionedZodFromChain(resolveSchemaChain(twoVersionAdditiveSchema));\n    expect(result.zodSchemas.size).toBe(1);\n    expect(result.zodSchemas.has(2)).toBe(true);\n    expect(result.zodSchemas.has(1)).toBe(false);\n  });\n});\n"],"mappings":"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","ignoreList":[]}

package/build/esm/utils/schema/__tests__/generateVersionsFromSchema.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 { generateVersionsFromChain } from "../generateVersionsFromSchema.js";
+import { resolveSchemaChain } from "../resolveSchemaChain.js";
+import { singleVersionSchema, threeVersionChainSchema, twoVersionAdditiveSchema } from "./fixtures.js";
+import { formatSingleSnapshot } from "./snapshotUtils.js";
+describe("generateVersionsFromChain", () => {
+  const snapshotDir = path.join(__dirname, "__snapshots__", "generateVersionsFromSchema");
+  it("single-version schema", async () => {
+    const result = generateVersionsFromChain(resolveSchemaChain(singleVersionSchema));
+    await expect(await formatSingleSnapshot("versions.ts", result)).toMatchFileSnapshot(path.join(snapshotDir, "single-version.ts"));
+  });
+  it("two-version with minSupportedVersion", async () => {
+    const result = generateVersionsFromChain(resolveSchemaChain(twoVersionAdditiveSchema, 1), 1);
+    await expect(await formatSingleSnapshot("versions.ts", result)).toMatchFileSnapshot(path.join(snapshotDir, "two-version.ts"));
+  });
+  it("three-version chain", async () => {
+    const result = generateVersionsFromChain(resolveSchemaChain(threeVersionChainSchema, 1), 1);
+    await expect(await formatSingleSnapshot("versions.ts", result)).toMatchFileSnapshot(path.join(snapshotDir, "three-version-chain.ts"));
+  });
+});
+//# sourceMappingURL=generateVersionsFromSchema.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateVersionsFromSchema.test.js","names":["path","describe","expect","it","generateVersionsFromChain","resolveSchemaChain","singleVersionSchema","threeVersionChainSchema","twoVersionAdditiveSchema","formatSingleSnapshot","snapshotDir","join","__dirname","result","toMatchFileSnapshot"],"sources":["generateVersionsFromSchema.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 { generateVersionsFromChain } from \"../generateVersionsFromSchema.js\";\nimport { resolveSchemaChain } from \"../resolveSchemaChain.js\";\nimport {\n  singleVersionSchema,\n  threeVersionChainSchema,\n  twoVersionAdditiveSchema,\n} from \"./fixtures.js\";\nimport { formatSingleSnapshot } from \"./snapshotUtils.js\";\n\ndescribe(\"generateVersionsFromChain\", () => {\n  const snapshotDir = path.join(__dirname, \"__snapshots__\", \"generateVersionsFromSchema\");\n\n  it(\"single-version schema\", async () => {\n    const result = generateVersionsFromChain(resolveSchemaChain(singleVersionSchema));\n    await expect(await formatSingleSnapshot(\"versions.ts\", result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"single-version.ts\"),\n    );\n  });\n\n  it(\"two-version with minSupportedVersion\", async () => {\n    const result = generateVersionsFromChain(resolveSchemaChain(twoVersionAdditiveSchema, 1), 1);\n    await expect(await formatSingleSnapshot(\"versions.ts\", result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"two-version.ts\"),\n    );\n  });\n\n  it(\"three-version chain\", async () => {\n    const result = generateVersionsFromChain(resolveSchemaChain(threeVersionChainSchema, 1), 1);\n    await expect(await formatSingleSnapshot(\"versions.ts\", result)).toMatchFileSnapshot(\n      path.join(snapshotDir, \"three-version-chain.ts\"),\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,mBAAmB,EACnBC,uBAAuB,EACvBC,wBAAwB,QACnB,eAAe;AACtB,SAASC,oBAAoB,QAAQ,oBAAoB;AAEzDR,QAAQ,CAAC,2BAA2B,EAAE,MAAM;EAC1C,MAAMS,WAAW,GAAGV,IAAI,CAACW,IAAI,CAACC,SAAS,EAAE,eAAe,EAAE,4BAA4B,CAAC;EAEvFT,EAAE,CAAC,uBAAuB,EAAE,YAAY;IACtC,MAAMU,MAAM,GAAGT,yBAAyB,CAACC,kBAAkB,CAACC,mBAAmB,CAAC,CAAC;IACjF,MAAMJ,MAAM,CAAC,MAAMO,oBAAoB,CAAC,aAAa,EAAEI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACjFd,IAAI,CAACW,IAAI,CAACD,WAAW,EAAE,mBAAmB,CAC5C,CAAC;EACH,CAAC,CAAC;EAEFP,EAAE,CAAC,sCAAsC,EAAE,YAAY;IACrD,MAAMU,MAAM,GAAGT,yBAAyB,CAACC,kBAAkB,CAACG,wBAAwB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5F,MAAMN,MAAM,CAAC,MAAMO,oBAAoB,CAAC,aAAa,EAAEI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACjFd,IAAI,CAACW,IAAI,CAACD,WAAW,EAAE,gBAAgB,CACzC,CAAC;EACH,CAAC,CAAC;EAEFP,EAAE,CAAC,qBAAqB,EAAE,YAAY;IACpC,MAAMU,MAAM,GAAGT,yBAAyB,CAACC,kBAAkB,CAACE,uBAAuB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAML,MAAM,CAAC,MAAMO,oBAAoB,CAAC,aAAa,EAAEI,MAAM,CAAC,CAAC,CAACC,mBAAmB,CACjFd,IAAI,CAACW,IAAI,CAACD,WAAW,EAAE,wBAAwB,CACjD,CAAC;EACH,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

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

@@ -0,0 +1,106 @@
+/*
+ * 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 { format } from "prettier";
+const prettierOpts = {
+  parser: "typescript",
+  singleQuote: true,
+  trailingComma: "es5"
+};
+async function fmt(code) {
+  return format(code, prettierOpts);
+}
+function section(filename, content) {
+  const bar = "=".repeat(60);
+  return `// ${bar}\n// ${filename}\n// ${bar}\n\n${content}`;
+}
+
+/**
+ * Combine a VersionedTypesOutput into a single snapshot string.
+ *
+ * Layout:
+ *   // === types_v1.ts ===
+ *   ...formatted code...
+ *   // === writeTypes_v1.ts ===
+ *   ...
+ *   // === types.ts ===
+ *   ...
+ */
+export async function formatVersionedTypesSnapshot(result) {
+  const sections = [];
+  const sortedVersions = [...result.readTypes.keys()].sort((a, b) => a - b);
+  for (const version of sortedVersions) {
+    sections.push(section(`types_v${version}.ts`, await fmt(result.readTypes.get(version))));
+  }
+  for (const version of sortedVersions) {
+    sections.push(section(`writeTypes_v${version}.ts`, await fmt(result.writeTypes.get(version))));
+  }
+  sections.push(section("types.ts", await fmt(result.typesReExport)));
+  return sections.join("\n");
+}
+
+/**
+ * Format a ModelMetadataOutput into a snapshot string.
+ */
+export async function formatModelMetadataSnapshot(result) {
+  return section("models.ts", await fmt(result.modelsFile));
+}
+
+/**
+ * Format a single generated string into a snapshot.
+ */
+export async function formatSingleSnapshot(filename, code) {
+  return section(filename, await fmt(code));
+}
+
+/**
+ * Combine a VersionedZodOutput into a single snapshot string.
+ *
+ * Layout:
+ *   // === schema_v1.ts ===
+ *   ...formatted code...
+ *   // === schema.ts ===
+ *   ...
+ */
+export async function formatVersionedZodSnapshot(result) {
+  const sections = [];
+  const sortedVersions = [...result.zodSchemas.keys()].sort((a, b) => a - b);
+  for (const version of sortedVersions) {
+    sections.push(section(`schema_v${version}.ts`, await fmt(result.zodSchemas.get(version))));
+  }
+  sections.push(section("schema.ts", await fmt(result.schemaReExport)));
+  return sections.join("\n");
+}
+
+/**
+ * Combine an InternalTypesOutput into a single snapshot string.
+ *
+ * Layout:
+ *   // === _internal/types.ts ===
+ *   ...formatted code...
+ *   // === _internal/upgrades.ts ===
+ *   ...
+ *   // === _internal/schema.ts ===
+ *   ...
+ */
+export async function formatInternalTypesSnapshot(result) {
+  const sections = [];
+  sections.push(section("_internal/types.ts", await fmt(result.internalTypes)));
+  sections.push(section("_internal/upgrades.ts", await fmt(result.upgrades)));
+  sections.push(section("_internal/schema.ts", await fmt(result.internalSchema)));
+  return sections.join("\n");
+}
+//# sourceMappingURL=snapshotUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotUtils.js","names":["format","prettierOpts","parser","singleQuote","trailingComma","fmt","code","section","filename","content","bar","repeat","formatVersionedTypesSnapshot","result","sections","sortedVersions","readTypes","keys","sort","a","b","version","push","get","writeTypes","typesReExport","join","formatModelMetadataSnapshot","modelsFile","formatSingleSnapshot","formatVersionedZodSnapshot","zodSchemas","schemaReExport","formatInternalTypesSnapshot","internalTypes","upgrades","internalSchema"],"sources":["snapshotUtils.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 { format } from \"prettier\";\nimport type { InternalTypesOutput } from \"../generateInternalFromSchema.js\";\nimport type { ModelMetadataOutput } from \"../generateModelMetadataFromSchema.js\";\nimport type { VersionedTypesOutput } from \"../generateVersionedTypesFromSchema.js\";\nimport type { VersionedZodOutput } from \"../generateVersionedZodFromSchema.js\";\n\nconst prettierOpts = {\n  parser: \"typescript\" as const,\n  singleQuote: true,\n  trailingComma: \"es5\" as const,\n};\n\nasync function fmt(code: string): Promise<string> {\n  return format(code, prettierOpts);\n}\n\nfunction section(filename: string, content: string): string {\n  const bar = \"=\".repeat(60);\n  return `// ${bar}\\n// ${filename}\\n// ${bar}\\n\\n${content}`;\n}\n\n/**\n * Combine a VersionedTypesOutput into a single snapshot string.\n *\n * Layout:\n *   // === types_v1.ts ===\n *   ...formatted code...\n *   // === writeTypes_v1.ts ===\n *   ...\n *   // === types.ts ===\n *   ...\n */\nexport async function formatVersionedTypesSnapshot(\n  result: VersionedTypesOutput,\n): Promise<string> {\n  const sections: string[] = [];\n\n  const sortedVersions = [...result.readTypes.keys()].sort((a, b) => a - b);\n\n  for (const version of sortedVersions) {\n    sections.push(section(`types_v${version}.ts`, await fmt(result.readTypes.get(version)!)));\n  }\n  for (const version of sortedVersions) {\n    sections.push(section(`writeTypes_v${version}.ts`, await fmt(result.writeTypes.get(version)!)));\n  }\n  sections.push(section(\"types.ts\", await fmt(result.typesReExport)));\n\n  return sections.join(\"\\n\");\n}\n\n/**\n * Format a ModelMetadataOutput into a snapshot string.\n */\nexport async function formatModelMetadataSnapshot(\n  result: ModelMetadataOutput,\n): Promise<string> {\n  return section(\"models.ts\", await fmt(result.modelsFile));\n}\n\n/**\n * Format a single generated string into a snapshot.\n */\nexport async function formatSingleSnapshot(\n  filename: string,\n  code: string,\n): Promise<string> {\n  return section(filename, await fmt(code));\n}\n\n/**\n * Combine a VersionedZodOutput into a single snapshot string.\n *\n * Layout:\n *   // === schema_v1.ts ===\n *   ...formatted code...\n *   // === schema.ts ===\n *   ...\n */\nexport async function formatVersionedZodSnapshot(\n  result: VersionedZodOutput,\n): Promise<string> {\n  const sections: string[] = [];\n\n  const sortedVersions = [...result.zodSchemas.keys()].sort((a, b) => a - b);\n\n  for (const version of sortedVersions) {\n    sections.push(section(`schema_v${version}.ts`, await fmt(result.zodSchemas.get(version)!)));\n  }\n  sections.push(section(\"schema.ts\", await fmt(result.schemaReExport)));\n\n  return sections.join(\"\\n\");\n}\n\n/**\n * Combine an InternalTypesOutput into a single snapshot string.\n *\n * Layout:\n *   // === _internal/types.ts ===\n *   ...formatted code...\n *   // === _internal/upgrades.ts ===\n *   ...\n *   // === _internal/schema.ts ===\n *   ...\n */\nexport async function formatInternalTypesSnapshot(\n  result: InternalTypesOutput,\n): Promise<string> {\n  const sections: string[] = [];\n\n  sections.push(section(\"_internal/types.ts\", await fmt(result.internalTypes)));\n  sections.push(section(\"_internal/upgrades.ts\", await fmt(result.upgrades)));\n  sections.push(section(\"_internal/schema.ts\", await fmt(result.internalSchema)));\n\n  return sections.join(\"\\n\");\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/utils/schema/convertSchemaToSteps.js

@@ -70,6 +70,12 @@ function convertUnionToYaml(unionDef) {
   return result;
 }
 export function convertSchemaToSteps(schema) {
+  // Reject aliased schemas: the YAML step format cannot represent exportKey !== declaredName
+  for (const [exportKey, def] of Object.entries(schema)) {
+    if (exportKey !== def.name) {
+      throw new Error(`Schema entry "${exportKey}" has declared model name "${def.name}". ` + `The migration-step YAML format cannot represent aliases (exportKey !== declaredName). ` + `Use the same name for both, or use the IR pipeline instead.`);
+    }
+  }
   const steps = [];
   const records = {};
   const unions = {};

package/build/esm/utils/schema/convertSchemaToSteps.js.map

@@ -1 +1 @@
-{"version":3,"file":"convertSchemaToSteps.js","names":["yaml","convertFieldType","field","type","items","item","name","Error","convertRecordToYaml","recordDef","result","fields","docs","fieldName","fieldDef","Object","entries","fieldType","convertUnionToYaml","unionDef","variants","variantName","variantRef","discriminant","convertSchemaToSteps","schema","steps","records","unions","def","values","keys","length","push","convertStepsToYamlString","dump","flowLevel","lineWidth","noRefs","quotingType","forceQuotes","skipInvalid"],"sources":["convertSchemaToSteps.ts"],"sourcesContent":["/*\n * Copyright 2025 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 yaml from \"js-yaml\";\nimport type { MigrationStep, UnionDefinition } from \"../steps/parseMigrationSteps.js\";\nimport type { P } from \"./validateSchemaModule.js\";\n\nfunction convertFieldType(field: P.Type): string {\n  switch (field.type) {\n    case \"array\":\n      return `array<${convertFieldType(field.items as P.Type)}>`;\n    case \"boolean\":\n      return \"boolean\";\n    case \"docRef\":\n      return \"docRef\";\n    case \"double\":\n      return \"double\";\n    case \"mediaRef\":\n      return \"mediaRef\";\n    case \"objectRef\":\n      return \"objectRef\";\n    case \"optional\":\n      return `optional<${convertFieldType(field.item as P.Type)}>`;\n    case \"ref\":\n      return field.name;\n    case \"string\":\n      return \"string\";\n    case \"unknown\":\n      return \"unknown\";\n    case \"userRef\":\n      return \"userRef\";\n    default:\n      field satisfies never;\n      throw new Error(`Unsupported field type: ${(field as P.Type).type}`);\n  }\n}\n\nfunction convertRecordToYaml(\n  recordDef: P.RecordDef,\n): { docs?: string; fields: Record<string, string> } {\n  const result: { docs?: string; fields: Record<string, string> } = {\n    fields: {},\n  };\n\n  if (recordDef.docs) {\n    result.docs = recordDef.docs;\n  }\n\n  for (const [fieldName, fieldDef] of Object.entries(recordDef.fields)) {\n    const fieldType = convertFieldType(fieldDef);\n    result.fields[fieldName] = fieldType;\n  }\n\n  return result;\n}\n\nfunction convertUnionToYaml(unionDef: P.UnionDef): UnionDefinition {\n  const variants: Record<string, string> = {};\n\n  for (const [variantName, variantRef] of Object.entries(unionDef.variants)) {\n    variants[variantName] = variantRef.name;\n  }\n\n  const result: UnionDefinition = {\n    variants,\n  };\n\n  if (unionDef.discriminant !== \"type\") {\n    result.discriminant = unionDef.discriminant;\n  }\n\n  return result;\n}\n\nexport function convertSchemaToSteps(schema: P.ReturnedSchema): MigrationStep[] {\n  const steps: MigrationStep[] = [];\n  const records: Record<string, { docs?: string; fields: Record<string, string> }> = {};\n  const unions: Record<string, UnionDefinition> = {};\n\n  for (const def of Object.values(schema)) {\n    switch (def.type) {\n      case \"record\": {\n        records[def.name] = convertRecordToYaml(def);\n        break;\n      }\n      case \"union\": {\n        unions[def.name] = convertUnionToYaml(def);\n        break;\n      }\n    }\n  }\n\n  if (Object.keys(records).length > 0) {\n    steps.push({ \"add-records\": records });\n  }\n\n  if (Object.keys(unions).length > 0) {\n    steps.push({ \"add-union\": unions });\n  }\n\n  return steps;\n}\n\nexport function convertStepsToYamlString(steps: MigrationStep[]): string {\n  return yaml.dump(steps, {\n    flowLevel: -1,\n    lineWidth: -1,\n    noRefs: true,\n    quotingType: \"'\",\n    forceQuotes: false,\n    skipInvalid: false,\n  });\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"convertSchemaToSteps.js","names":["yaml","convertFieldType","field","type","items","item","name","Error","convertRecordToYaml","recordDef","result","fields","docs","fieldName","fieldDef","Object","entries","fieldType","convertUnionToYaml","unionDef","variants","variantName","variantRef","discriminant","convertSchemaToSteps","schema","exportKey","def","steps","records","unions","values","keys","length","push","convertStepsToYamlString","dump","flowLevel","lineWidth","noRefs","quotingType","forceQuotes","skipInvalid"],"sources":["convertSchemaToSteps.ts"],"sourcesContent":["/*\n * Copyright 2025 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 yaml from \"js-yaml\";\nimport type { MigrationStep, UnionDefinition } from \"../steps/parseMigrationSteps.js\";\nimport type { P } from \"./validateSchemaModule.js\";\n\nfunction convertFieldType(field: P.Type): string {\n  switch (field.type) {\n    case \"array\":\n      return `array<${convertFieldType(field.items as P.Type)}>`;\n    case \"boolean\":\n      return \"boolean\";\n    case \"docRef\":\n      return \"docRef\";\n    case \"double\":\n      return \"double\";\n    case \"mediaRef\":\n      return \"mediaRef\";\n    case \"objectRef\":\n      return \"objectRef\";\n    case \"optional\":\n      return `optional<${convertFieldType(field.item as P.Type)}>`;\n    case \"ref\":\n      return field.name;\n    case \"string\":\n      return \"string\";\n    case \"unknown\":\n      return \"unknown\";\n    case \"userRef\":\n      return \"userRef\";\n    default:\n      field satisfies never;\n      throw new Error(`Unsupported field type: ${(field as P.Type).type}`);\n  }\n}\n\nfunction convertRecordToYaml(\n  recordDef: P.RecordDef,\n): { docs?: string; fields: Record<string, string> } {\n  const result: { docs?: string; fields: Record<string, string> } = {\n    fields: {},\n  };\n\n  if (recordDef.docs) {\n    result.docs = recordDef.docs;\n  }\n\n  for (const [fieldName, fieldDef] of Object.entries(recordDef.fields)) {\n    const fieldType = convertFieldType(fieldDef);\n    result.fields[fieldName] = fieldType;\n  }\n\n  return result;\n}\n\nfunction convertUnionToYaml(unionDef: P.UnionDef): UnionDefinition {\n  const variants: Record<string, string> = {};\n\n  for (const [variantName, variantRef] of Object.entries(unionDef.variants)) {\n    variants[variantName] = variantRef.name;\n  }\n\n  const result: UnionDefinition = {\n    variants,\n  };\n\n  if (unionDef.discriminant !== \"type\") {\n    result.discriminant = unionDef.discriminant;\n  }\n\n  return result;\n}\n\nexport function convertSchemaToSteps(schema: P.ReturnedSchema): MigrationStep[] {\n  // Reject aliased schemas: the YAML step format cannot represent exportKey !== declaredName\n  for (const [exportKey, def] of Object.entries(schema)) {\n    if (exportKey !== def.name) {\n      throw new Error(\n        `Schema entry \"${exportKey}\" has declared model name \"${def.name}\". `\n          + `The migration-step YAML format cannot represent aliases (exportKey !== declaredName). `\n          + `Use the same name for both, or use the IR pipeline instead.`,\n      );\n    }\n  }\n\n  const steps: MigrationStep[] = [];\n  const records: Record<string, { docs?: string; fields: Record<string, string> }> = {};\n  const unions: Record<string, UnionDefinition> = {};\n\n  for (const def of Object.values(schema)) {\n    switch (def.type) {\n      case \"record\": {\n        records[def.name] = convertRecordToYaml(def);\n        break;\n      }\n      case \"union\": {\n        unions[def.name] = convertUnionToYaml(def);\n        break;\n      }\n    }\n  }\n\n  if (Object.keys(records).length > 0) {\n    steps.push({ \"add-records\": records });\n  }\n\n  if (Object.keys(unions).length > 0) {\n    steps.push({ \"add-union\": unions });\n  }\n\n  return steps;\n}\n\nexport function convertStepsToYamlString(steps: MigrationStep[]): string {\n  return yaml.dump(steps, {\n    flowLevel: -1,\n    lineWidth: -1,\n    noRefs: true,\n    quotingType: \"'\",\n    forceQuotes: false,\n    skipInvalid: false,\n  });\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/utils/schema/generateIndexFromSchema.js

@@ -0,0 +1,74 @@
+/*
+ * 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 { formatVariantName } from "../formatVariantName.js";
+import { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
+import { resolveMinVersion } from "./resolveSchemaChain.js";
+import { MODELS_PATH, TYPES_REEXPORT_PATH, typesFilePath, VERSIONED_DOC_REF_PATH, versionedTypeName, VERSIONS_PATH } from "./runtimeSchema.js";
+
+/**
+ * Generate the index.ts barrel export from a versioned schema.
+ *
+ * Exports:
+ * - `models.js` (star export — model constants and DocumentModel)
+ * - `types.js` (star export — latest-version type aliases)
+ * - `versions.js` (star export — SupportedVersions, LatestVersion, MinSupportedVersion)
+ * - `versionedDocRef.js` (star export — VersionedDocRef types and factory)
+ * - Per supported version: explicit named type exports from `types_vN.js`
+ *   (not star exports, to avoid polluting autocomplete for read-only consumers)
+ */
+export function generateIndexFromChain(resolved, minSupportedVersion) {
+  const {
+    chain
+  } = resolved;
+  const {
+    minVersion
+  } = resolveMinVersion(chain, minSupportedVersion);
+  let output = GENERATED_FILE_HEADER;
+
+  // Star exports for core modules
+  output += `export * from "${MODELS_PATH}";\n`;
+  output += `export * from "${TYPES_REEXPORT_PATH}";\n`;
+  output += `export * from "${VERSIONS_PATH}";\n`;
+  output += `export * from "${VERSIONED_DOC_REF_PATH}";\n`;
+
+  // Per-version explicit named type exports
+  for (const {
+    version,
+    ir
+  } of chain) {
+    if (version < minVersion) continue;
+    const typeNames = [];
+    for (const [modelKey, modelDef] of Object.entries(ir.models)) {
+      if (modelDef.type === "record") {
+        typeNames.push(versionedTypeName(modelKey, version));
+      } else if (modelDef.type === "union") {
+        typeNames.push(versionedTypeName(modelKey, version));
+
+        // Union variant types
+        for (const variantName of Object.keys(modelDef.union.variants)) {
+          const formattedVariant = formatVariantName(variantName);
+          typeNames.push(`${versionedTypeName(modelKey, version)}${formattedVariant}`);
+        }
+      }
+    }
+    if (typeNames.length > 0) {
+      output += `export type { ${typeNames.sort().join(", ")} } from "${typesFilePath(version)}";\n`;
+    }
+  }
+  return output;
+}
+//# sourceMappingURL=generateIndexFromSchema.js.map

package/build/esm/utils/schema/generateIndexFromSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateIndexFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","resolveMinVersion","MODELS_PATH","TYPES_REEXPORT_PATH","typesFilePath","VERSIONED_DOC_REF_PATH","versionedTypeName","VERSIONS_PATH","generateIndexFromChain","resolved","minSupportedVersion","chain","minVersion","output","version","ir","typeNames","modelKey","modelDef","Object","entries","models","type","push","variantName","keys","union","variants","formattedVariant","length","sort","join"],"sources":["generateIndexFromSchema.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 { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport type { ResolvedIrChain } from \"./resolveSchemaChain.js\";\nimport { resolveMinVersion } from \"./resolveSchemaChain.js\";\nimport {\n  MODELS_PATH,\n  TYPES_REEXPORT_PATH,\n  typesFilePath,\n  VERSIONED_DOC_REF_PATH,\n  versionedTypeName,\n  VERSIONS_PATH,\n} from \"./runtimeSchema.js\";\n\n/**\n * Generate the index.ts barrel export from a versioned schema.\n *\n * Exports:\n * - `models.js` (star export — model constants and DocumentModel)\n * - `types.js` (star export — latest-version type aliases)\n * - `versions.js` (star export — SupportedVersions, LatestVersion, MinSupportedVersion)\n * - `versionedDocRef.js` (star export — VersionedDocRef types and factory)\n * - Per supported version: explicit named type exports from `types_vN.js`\n *   (not star exports, to avoid polluting autocomplete for read-only consumers)\n */\nexport function generateIndexFromChain(\n  resolved: ResolvedIrChain,\n  minSupportedVersion?: number,\n): string {\n  const { chain } = resolved;\n  const { minVersion } = resolveMinVersion(chain, minSupportedVersion);\n\n  let output = GENERATED_FILE_HEADER;\n\n  // Star exports for core modules\n  output += `export * from \"${MODELS_PATH}\";\\n`;\n  output += `export * from \"${TYPES_REEXPORT_PATH}\";\\n`;\n  output += `export * from \"${VERSIONS_PATH}\";\\n`;\n  output += `export * from \"${VERSIONED_DOC_REF_PATH}\";\\n`;\n\n  // Per-version explicit named type exports\n  for (const { version, ir } of chain) {\n    if (version < minVersion) continue;\n\n    const typeNames: string[] = [];\n\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type === \"record\") {\n        typeNames.push(versionedTypeName(modelKey, version));\n      } else if (modelDef.type === \"union\") {\n        typeNames.push(versionedTypeName(modelKey, version));\n\n        // Union variant types\n        for (const variantName of Object.keys(modelDef.union.variants)) {\n          const formattedVariant = formatVariantName(variantName);\n          typeNames.push(`${versionedTypeName(modelKey, version)}${formattedVariant}`);\n        }\n      }\n    }\n\n    if (typeNames.length > 0) {\n      output += `export type { ${typeNames.sort().join(\", \")} } from \"${\n        typesFilePath(version)\n      }\";\\n`;\n    }\n  }\n\n  return output;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,iBAAiB,QAAQ,yBAAyB;AAC3D,SAASC,qBAAqB,QAAQ,2BAA2B;AAEjE,SAASC,iBAAiB,QAAQ,yBAAyB;AAC3D,SACEC,WAAW,EACXC,mBAAmB,EACnBC,aAAa,EACbC,sBAAsB,EACtBC,iBAAiB,EACjBC,aAAa,QACR,oBAAoB;;AAE3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CACpCC,QAAyB,EACzBC,mBAA4B,EACpB;EACR,MAAM;IAAEC;EAAM,CAAC,GAAGF,QAAQ;EAC1B,MAAM;IAAEG;EAAW,CAAC,GAAGX,iBAAiB,CAACU,KAAK,EAAED,mBAAmB,CAAC;EAEpE,IAAIG,MAAM,GAAGb,qBAAqB;;EAElC;EACAa,MAAM,IAAI,kBAAkBX,WAAW,MAAM;EAC7CW,MAAM,IAAI,kBAAkBV,mBAAmB,MAAM;EACrDU,MAAM,IAAI,kBAAkBN,aAAa,MAAM;EAC/CM,MAAM,IAAI,kBAAkBR,sBAAsB,MAAM;;EAExD;EACA,KAAK,MAAM;IAAES,OAAO;IAAEC;EAAG,CAAC,IAAIJ,KAAK,EAAE;IACnC,IAAIG,OAAO,GAAGF,UAAU,EAAE;IAE1B,MAAMI,SAAmB,GAAG,EAAE;IAE9B,KAAK,MAAM,CAACC,QAAQ,EAAEC,QAAQ,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACL,EAAE,CAACM,MAAM,CAAC,EAAE;MAC5D,IAAIH,QAAQ,CAACI,IAAI,KAAK,QAAQ,EAAE;QAC9BN,SAAS,CAACO,IAAI,CAACjB,iBAAiB,CAACW,QAAQ,EAAEH,OAAO,CAAC,CAAC;MACtD,CAAC,MAAM,IAAII,QAAQ,CAACI,IAAI,KAAK,OAAO,EAAE;QACpCN,SAAS,CAACO,IAAI,CAACjB,iBAAiB,CAACW,QAAQ,EAAEH,OAAO,CAAC,CAAC;;QAEpD;QACA,KAAK,MAAMU,WAAW,IAAIL,MAAM,CAACM,IAAI,CAACP,QAAQ,CAACQ,KAAK,CAACC,QAAQ,CAAC,EAAE;UAC9D,MAAMC,gBAAgB,GAAG7B,iBAAiB,CAACyB,WAAW,CAAC;UACvDR,SAAS,CAACO,IAAI,CAAC,GAAGjB,iBAAiB,CAACW,QAAQ,EAAEH,OAAO,CAAC,GAAGc,gBAAgB,EAAE,CAAC;QAC9E;MACF;IACF;IAEA,IAAIZ,SAAS,CAACa,MAAM,GAAG,CAAC,EAAE;MACxBhB,MAAM,IAAI,iBAAiBG,SAAS,CAACc,IAAI,CAAC,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC,YACpD3B,aAAa,CAACU,OAAO,CAAC,MAClB;IACR;EACF;EAEA,OAAOD,MAAM;AACf","ignoreList":[]}

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

@@ -0,0 +1,264 @@
+/*
+ * 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 { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
+import { convertFieldTypeToDescriptor, convertFieldTypeToInternalTypeScript, convertFieldTypeToInternalZod } from "../ir/irFieldHelpers.js";
+
+/** Collected info about all fields for a model across all versions. */
+
+/**
+ * Represents an upgrade step for a model between version transitions.
+ */
+
+/**
+ * Helper to iterate sorted entries of a Map.
+ */
+function sortedEntries(map) {
+  return Array.from(map.entries()).sort(([a], [b]) => a.localeCompare(b));
+}
+
+/**
+ * Collect all record model info across all versions and compute upgrade steps.
+ */
+function collectRecordModels(chain) {
+  const allRecordModels = new Map();
+
+  // Initialize models from all versions
+  for (const {
+    version,
+    ir
+  } of chain) {
+    for (const [modelKey, modelDef] of Object.entries(ir.models)) {
+      if (modelDef.type !== "record") continue;
+      if (!allRecordModels.has(modelKey)) {
+        allRecordModels.set(modelKey, {
+          allFields: new Map(),
+          steps: []
+        });
+      }
+      const model = allRecordModels.get(modelKey);
+      for (const field of modelDef.record.fields) {
+        const existing = model.allFields.get(field.key);
+        if (existing == null) {
+          model.allFields.set(field.key, {
+            fieldType: field.fieldType,
+            isOptional: field.isOptional === true,
+            presentInVersions: new Set([version]),
+            alwaysOptional: field.isOptional === true,
+            everOptional: field.isOptional === true
+          });
+        } else {
+          existing.presentInVersions.add(version);
+          if (field.isOptional !== true) {
+            existing.alwaysOptional = false;
+          }
+          if (field.isOptional === true) {
+            existing.everOptional = true;
+          }
+        }
+      }
+    }
+  }
+
+  // Compute upgrade steps from version diffs
+  for (let i = 1; i < chain.length; i++) {
+    const prevEntry = chain[i - 1];
+    const currEntry = chain[i];
+    for (const [modelKey, currModelDef] of Object.entries(currEntry.ir.models)) {
+      if (currModelDef.type !== "record") continue;
+      const prevModelDef = prevEntry.ir.models[modelKey];
+      if (prevModelDef == null || prevModelDef.type !== "record") continue;
+      const model = allRecordModels.get(modelKey);
+      if (model == null) continue;
+      const prevFields = new Set(prevModelDef.record.fields.map(f => f.key));
+      const currFields = new Set(currModelDef.record.fields.map(f => f.key));
+
+      // Fields added in this version
+      const addedFields = new Map();
+      const recordUpgrades = currEntry.migrations?.[modelKey];
+      for (const fieldKey of currFields) {
+        if (!prevFields.has(fieldKey)) {
+          const annotation = recordUpgrades?.[fieldKey];
+          if (annotation != null) {
+            addedFields.set(fieldKey, {
+              derivedFrom: [...annotation.derivedFrom],
+              forwardSource: annotation.forwardSource
+            });
+          } else {
+            addedFields.set(fieldKey, {
+              derivedFrom: [],
+              forwardSource: "() => undefined"
+            });
+          }
+        }
+      }
+
+      // Fields removed in this version
+      const removedFields = [];
+      for (const fieldKey of prevFields) {
+        if (!currFields.has(fieldKey)) {
+          removedFields.push(fieldKey);
+        }
+      }
+      if (addedFields.size > 0 || removedFields.length > 0) {
+        model.steps.push({
+          name: `v${currEntry.version}`,
+          addedInVersion: currEntry.version,
+          fields: addedFields,
+          removedFields
+        });
+      }
+    }
+  }
+
+  // Mark fields that are not present in ALL versions as optional in internal type
+  const totalVersions = chain.length;
+  for (const model of allRecordModels.values()) {
+    for (const [, fieldInfo] of model.allFields) {
+      if (fieldInfo.presentInVersions.size < totalVersions) {
+        fieldInfo.alwaysOptional = true;
+      }
+    }
+  }
+  return allRecordModels;
+}
+
+/**
+ * Generate _internal/types.ts content.
+ */
+function generateInternalTypes(allRecordModels) {
+  let output = GENERATED_FILE_HEADER;
+  output += "\n";
+  for (const [modelKey, model] of sortedEntries(allRecordModels)) {
+    output += `/** Internal representation containing all fields across all schema versions. */\n`;
+    output += `export interface ${modelKey}__Internal {\n`;
+    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {
+      const tsType = convertFieldTypeToInternalTypeScript(fieldInfo.fieldType, fieldInfo.isOptional);
+      const optional = fieldInfo.alwaysOptional ? "?" : "";
+      output += `  readonly ${fieldName}${optional}: ${tsType};\n`;
+    }
+    output += "}\n\n";
+  }
+  return output;
+}
+
+/**
+ * Generate _internal/upgrades.ts content.
+ */
+function generateUpgrades(allRecordModels, latestIr) {
+  let output = GENERATED_FILE_HEADER;
+  const hasRecords = allRecordModels.size > 0;
+  const hasUnions = Object.values(latestIr.models).some(m => m.type === "union");
+  const imports = [];
+  if (hasRecords) imports.push("UpgradeRegistry");
+  if (hasUnions) imports.push("UnionUpgradeRegistry");
+  if (imports.length > 0) {
+    output += `import type { ${imports.join(", ")} } from "@palantir/pack.document-schema.model-types";\n\n`;
+  }
+  for (const [modelKey, model] of sortedEntries(allRecordModels)) {
+    output += `export const ${modelKey}Upgrades: UpgradeRegistry<"${modelKey}"> = {\n`;
+    output += `  modelName: "${modelKey}",\n`;
+
+    // allFields
+    output += `  allFields: {\n`;
+    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {
+      const typeDescriptor = convertFieldTypeToDescriptor(fieldInfo.fieldType, fieldInfo.isOptional);
+      output += `    ${fieldName}: { type: ${typeDescriptor} },\n`;
+    }
+    output += `  },\n`;
+
+    // steps
+    output += `  steps: [\n`;
+    for (const step of model.steps) {
+      output += `    {\n`;
+      output += `      name: "${step.name}",\n`;
+      output += `      addedInVersion: ${step.addedInVersion},\n`;
+      output += `      fields: {\n`;
+      for (const [fieldName, fieldMeta] of step.fields) {
+        output += `        ${fieldName}: {\n`;
+        output += `          derivedFrom: [${fieldMeta.derivedFrom.map(d => `"${d}"`).join(", ")}],\n`;
+        output += `          forward: ${fieldMeta.forwardSource},\n`;
+        if (fieldMeta.default !== undefined) {
+          output += `          default: ${JSON.stringify(fieldMeta.default)},\n`;
+        }
+        output += `        },\n`;
+      }
+      output += `      },\n`;
+      if (step.removedFields.length > 0) {
+        output += `      removedFields: [${step.removedFields.map(f => `"${f}"`).join(", ")}],\n`;
+      }
+      output += `    },\n`;
+    }
+    output += `  ],\n`;
+    output += `};\n\n`;
+  }
+
+  // Generate UnionUpgradeRegistry entries for union models
+  for (const [modelKey, modelDef] of Object.entries(latestIr.models)) {
+    if (modelDef.type !== "union") continue;
+    const union = modelDef.union;
+    output += `export const ${modelKey}Upgrades: UnionUpgradeRegistry<"${modelKey}"> = {\n`;
+    output += `  modelName: "${modelKey}",\n`;
+    output += `  discriminant: "${union.discriminant}",\n`;
+    output += `  variants: {\n`;
+    for (const [variantKey, variantModelKey] of Object.entries(union.variants)) {
+      output += `    "${variantKey}": "${variantModelKey}",\n`;
+    }
+    output += `  },\n`;
+    output += `};\n\n`;
+  }
+  return output;
+}
+
+/**
+ * Generate _internal/schema.ts content.
+ */
+function generateInternalSchemaContent(allRecordModels) {
+  let output = GENERATED_FILE_HEADER;
+  output += `import { z } from "zod";\n\n`;
+  for (const [modelKey, model] of sortedEntries(allRecordModels)) {
+    output += `export const ${modelKey}InternalSchema = z.object({\n`;
+    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {
+      // Use everOptional: a field optional in ANY version must stay optional
+      // in the internal schema because older documents may legitimately omit it.
+      const zodType = convertFieldTypeToInternalZod(fieldInfo.fieldType, fieldInfo.alwaysOptional || fieldInfo.everOptional);
+      output += `  ${fieldName}: ${zodType},\n`;
+    }
+    output += `}).passthrough();\n\n`;
+  }
+  return output;
+}
+
+/**
+ * Generate _internal/types.ts, _internal/upgrades.ts, and _internal/schema.ts
+ * from an already-resolved versioned IR chain.
+ */
+export function generateInternalFromChain(resolved) {
+  const {
+    chain
+  } = resolved;
+  const latestIr = chain[chain.length - 1].ir;
+  const allRecordModels = collectRecordModels(chain);
+  const internalTypes = generateInternalTypes(allRecordModels);
+  const upgrades = generateUpgrades(allRecordModels, latestIr);
+  const internalSchema = generateInternalSchemaContent(allRecordModels);
+  return {
+    internalTypes,
+    upgrades,
+    internalSchema
+  };
+}
+//# sourceMappingURL=generateInternalFromSchema.js.map