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

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

@@ -0,0 +1,380 @@
+/*
+ * 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 { resolveSchemaChain } from "./resolveSchemaChain.js";
+import { findRecordExportName, isRecordSchema, isUnionSchema, TypeKind } from "./runtimeSchema.js";
+/**
+ * Convert a schema field type to TypeScript string for internal types.
+ */
+function convertTypeToTypeScript(fieldType) {
+  switch (fieldType.type) {
+    case TypeKind.ARRAY:
+      {
+        if (fieldType.items == null) {
+          throw new Error("Array field is missing items type");
+        }
+        const inner = convertTypeToTypeScript(fieldType.items);
+        // Wrap compound types (unions, other arrays) in parens before appending []
+        const needsParens = inner.includes("|") || inner.startsWith("readonly ");
+        const wrapped = needsParens ? `(${inner})` : inner;
+        return `readonly ${wrapped}[]`;
+      }
+    case TypeKind.BOOLEAN:
+      return "boolean";
+    case TypeKind.DOC_REF:
+      return "string";
+    case TypeKind.DOUBLE:
+      return "number";
+    case TypeKind.MEDIA_REF:
+      return "string";
+    case TypeKind.OBJECT_REF:
+      return "string";
+    case TypeKind.OPTIONAL:
+      if (fieldType.item == null) {
+        throw new Error("Optional field is missing inner type");
+      }
+      return `(${convertTypeToTypeScript(fieldType.item)} | undefined)`;
+    case TypeKind.REF:
+      return "unknown";
+    case TypeKind.STRING:
+      return "string";
+    case TypeKind.USER_REF:
+      return "string";
+    default:
+      throw new Error(`Unknown schema field type: ${fieldType.type}`);
+  }
+}
+
+/**
+ * Convert a schema field type to a FieldTypeDescriptor source string.
+ */
+function convertTypeToFieldTypeDescriptor(fieldType, schema) {
+  switch (fieldType.type) {
+    case TypeKind.ARRAY:
+      if (fieldType.items == null) {
+        throw new Error("Array field is missing items type");
+      }
+      return `{ kind: "array", element: ${convertTypeToFieldTypeDescriptor(fieldType.items, schema)} }`;
+    case TypeKind.OPTIONAL:
+      if (fieldType.item == null) {
+        throw new Error("Optional field is missing inner type");
+      }
+      return `{ kind: "optional", inner: ${convertTypeToFieldTypeDescriptor(fieldType.item, schema)} }`;
+    case TypeKind.REF:
+      {
+        if (fieldType.name == null) {
+          throw new Error("Ref field is missing a name");
+        }
+        const exportKey = fieldType.refType === "record" ? findRecordExportName(fieldType.name, schema) ?? fieldType.name : fieldType.name;
+        return `{ kind: "modelRef", model: "${exportKey}" }`;
+      }
+    default:
+      return `{ kind: "primitive" }`;
+  }
+}
+
+/**
+ * Convert a schema field type to a Zod schema string.
+ */
+function convertTypeToZodSchema(fieldType) {
+  switch (fieldType.type) {
+    case TypeKind.ARRAY:
+      if (fieldType.items == null) {
+        throw new Error("Array field is missing items type");
+      }
+      return `z.array(${convertTypeToZodSchema(fieldType.items)})`;
+    case TypeKind.BOOLEAN:
+      return "z.boolean()";
+    case TypeKind.DOC_REF:
+    case TypeKind.MEDIA_REF:
+    case TypeKind.OBJECT_REF:
+    case TypeKind.STRING:
+    case TypeKind.USER_REF:
+      return "z.string()";
+    case TypeKind.DOUBLE:
+      return "z.number()";
+    case TypeKind.OPTIONAL:
+      if (fieldType.item == null) {
+        throw new Error("Optional field is missing inner type");
+      }
+      return `${convertTypeToZodSchema(fieldType.item)}.optional()`;
+    case TypeKind.REF:
+      return "z.unknown()";
+    default:
+      throw new Error(`Unknown schema field type: ${fieldType.type}`);
+  }
+}
+
+/** 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,
+    schema
+  } of chain) {
+    for (const [exportName, item] of Object.entries(schema)) {
+      if (!isRecordSchema(item)) continue;
+      if (!allRecordModels.has(exportName)) {
+        allRecordModels.set(exportName, {
+          allFields: new Map(),
+          steps: []
+        });
+      }
+      const model = allRecordModels.get(exportName);
+      for (const [fieldName, fieldType] of Object.entries(item.fields)) {
+        const existing = model.allFields.get(fieldName);
+        if (existing == null) {
+          model.allFields.set(fieldName, {
+            fieldType,
+            presentInVersions: new Set([version]),
+            alwaysOptional: fieldType.type === TypeKind.OPTIONAL
+          });
+        } else {
+          existing.presentInVersions.add(version);
+          if (fieldType.type !== TypeKind.OPTIONAL) {
+            existing.alwaysOptional = false;
+          }
+        }
+      }
+    }
+  }
+
+  // Compute upgrade steps from version diffs
+  for (let i = 1; i < chain.length; i++) {
+    const prevVersion = chain[i - 1];
+    const currVersion = chain[i];
+    for (const [exportName, currItem] of Object.entries(currVersion.schema)) {
+      if (!isRecordSchema(currItem)) continue;
+      const prevItem = prevVersion.schema[exportName];
+      if (prevItem == null || !isRecordSchema(prevItem)) continue;
+      const model = allRecordModels.get(exportName);
+      if (model == null) continue;
+      const prevFields = new Set(Object.keys(prevItem.fields));
+      const currFields = new Set(Object.keys(currItem.fields));
+
+      // Fields added in this version
+      const addedFields = new Map();
+      const recordUpgrades = currVersion.migrations?.[exportName];
+      for (const fieldName of currFields) {
+        if (!prevFields.has(fieldName)) {
+          const annotation = recordUpgrades?.[fieldName];
+          if (annotation != null) {
+            addedFields.set(fieldName, {
+              derivedFrom: [...annotation.derivedFrom],
+              forwardSource: annotation.forward.toString()
+            });
+          } else {
+            addedFields.set(fieldName, {
+              derivedFrom: [],
+              forwardSource: "() => undefined"
+            });
+          }
+        }
+      }
+
+      // Fields removed in this version
+      const removedFields = [];
+      for (const fieldName of prevFields) {
+        if (!currFields.has(fieldName)) {
+          removedFields.push(fieldName);
+        }
+      }
+      if (addedFields.size > 0 || removedFields.length > 0) {
+        model.steps.push({
+          name: `v${currVersion.version}`,
+          addedInVersion: currVersion.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 [exportName, model] of sortedEntries(allRecordModels)) {
+    output += `/** Internal representation containing all fields across all schema versions. */\n`;
+    output += `export interface ${exportName}__Internal {\n`;
+    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {
+      const tsType = convertTypeToTypeScript(fieldInfo.fieldType);
+      const optional = fieldInfo.alwaysOptional ? "?" : "";
+      output += `  readonly ${fieldName}${optional}: ${tsType};\n`;
+    }
+    output += "}\n\n";
+  }
+  return output;
+}
+
+/**
+ * Generate _internal/upgrades.ts content.
+ */
+function generateUpgrades(allRecordModels, latestSchema) {
+  let output = GENERATED_FILE_HEADER;
+  const hasRecords = allRecordModels.size > 0;
+  const hasUnions = Object.values(latestSchema).some(isUnionSchema);
+  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 [exportName, model] of sortedEntries(allRecordModels)) {
+    output += `export const ${exportName}Upgrades: UpgradeRegistry<"${exportName}"> = {\n`;
+    output += `  modelName: "${exportName}",\n`;
+
+    // allFields
+    output += `  allFields: {\n`;
+    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {
+      const typeDescriptor = convertTypeToFieldTypeDescriptor(fieldInfo.fieldType, latestSchema);
+      if (fieldInfo.default !== undefined) {
+        output += `    ${fieldName}: { type: ${typeDescriptor}, default: ${JSON.stringify(fieldInfo.default)} },\n`;
+      } else {
+        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 [exportName, item] of Object.entries(latestSchema)) {
+    if (!isUnionSchema(item)) continue;
+    output += `export const ${exportName}Upgrades: UnionUpgradeRegistry<"${exportName}"> = {\n`;
+    output += `  modelName: "${exportName}",\n`;
+    output += `  discriminant: "${item.discriminant}",\n`;
+    output += `  variants: {\n`;
+    for (const [variantKey, variantField] of Object.entries(item.variants)) {
+      if (variantField.type === "ref" && variantField.refType === "record" && variantField.name != null) {
+        const variantExportName = findRecordExportName(variantField.name, latestSchema);
+        if (variantExportName != null) {
+          output += `    "${variantKey}": "${variantExportName}",\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 [exportName, model] of sortedEntries(allRecordModels)) {
+    output += `export const ${exportName}InternalSchema = z.object({\n`;
+    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {
+      const zodType = convertTypeToZodSchema(fieldInfo.fieldType);
+      // In internal schema, all fields that might be absent are optional
+      if (fieldInfo.alwaysOptional) {
+        // If the type already ends with .optional(), don't double-wrap
+        if (zodType.endsWith(".optional()")) {
+          output += `  ${fieldName}: ${zodType},\n`;
+        } else {
+          output += `  ${fieldName}: ${zodType}.optional(),\n`;
+        }
+      } else {
+        output += `  ${fieldName}: ${zodType},\n`;
+      }
+    }
+    output += `}).passthrough();\n\n`;
+  }
+  return output;
+}
+
+/**
+ * Generate _internal/types.ts, _internal/upgrades.ts, and _internal/schema.ts
+ * from a versioned schema chain.
+ *
+ * @param schema - The schema definition (initial or versioned)
+ * @returns Object containing generated code for each internal file
+ */
+export function generateInternalFromSchema(schema) {
+  const {
+    chain
+  } = resolveSchemaChain(schema);
+  const latestSchema = chain[chain.length - 1].schema;
+  const allRecordModels = collectRecordModels(chain);
+  const internalTypes = generateInternalTypes(allRecordModels);
+  const upgrades = generateUpgrades(allRecordModels, latestSchema);
+  const internalSchema = generateInternalSchemaContent(allRecordModels);
+  return {
+    internalTypes,
+    upgrades,
+    internalSchema
+  };
+}
+//# sourceMappingURL=generateInternalFromSchema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateInternalFromSchema.js","names":["GENERATED_FILE_HEADER","resolveSchemaChain","findRecordExportName","isRecordSchema","isUnionSchema","TypeKind","convertTypeToTypeScript","fieldType","type","ARRAY","items","Error","inner","needsParens","includes","startsWith","wrapped","BOOLEAN","DOC_REF","DOUBLE","MEDIA_REF","OBJECT_REF","OPTIONAL","item","REF","STRING","USER_REF","convertTypeToFieldTypeDescriptor","schema","name","exportKey","refType","convertTypeToZodSchema","sortedEntries","map","Array","from","entries","sort","a","b","localeCompare","collectRecordModels","chain","allRecordModels","Map","version","exportName","Object","has","set","allFields","steps","model","get","fieldName","fields","existing","presentInVersions","Set","alwaysOptional","add","i","length","prevVersion","currVersion","currItem","prevItem","prevFields","keys","currFields","addedFields","recordUpgrades","migrations","annotation","derivedFrom","forwardSource","forward","toString","removedFields","push","size","addedInVersion","totalVersions","values","fieldInfo","generateInternalTypes","output","tsType","optional","generateUpgrades","latestSchema","hasRecords","hasUnions","some","imports","join","typeDescriptor","default","undefined","JSON","stringify","step","fieldMeta","d","f","discriminant","variantKey","variantField","variants","variantExportName","generateInternalSchemaContent","zodType","endsWith","generateInternalFromSchema","internalTypes","upgrades","internalSchema"],"sources":["generateInternalFromSchema.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 { SchemaDefinition } from \"@palantir/pack.schema\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport type { VersionedSchemaEntry } from \"./resolveSchemaChain.js\";\nimport { resolveSchemaChain } from \"./resolveSchemaChain.js\";\nimport type { RuntimeSchema, SchemaField } from \"./runtimeSchema.js\";\nimport { findRecordExportName, isRecordSchema, isUnionSchema, TypeKind } from \"./runtimeSchema.js\";\n\nexport interface InternalTypesOutput {\n  /** _internal/types.ts content */\n  internalTypes: string;\n  /** _internal/upgrades.ts content */\n  upgrades: string;\n  /** _internal/schema.ts content */\n  internalSchema: string;\n}\n\n/**\n * Convert a schema field type to TypeScript string for internal types.\n */\nfunction convertTypeToTypeScript(fieldType: SchemaField): string {\n  switch (fieldType.type) {\n    case TypeKind.ARRAY: {\n      if (fieldType.items == null) {\n        throw new Error(\"Array field is missing items type\");\n      }\n      const inner = convertTypeToTypeScript(fieldType.items);\n      // Wrap compound types (unions, other arrays) in parens before appending []\n      const needsParens = inner.includes(\"|\") || inner.startsWith(\"readonly \");\n      const wrapped = needsParens ? `(${inner})` : inner;\n      return `readonly ${wrapped}[]`;\n    }\n    case TypeKind.BOOLEAN:\n      return \"boolean\";\n    case TypeKind.DOC_REF:\n      return \"string\";\n    case TypeKind.DOUBLE:\n      return \"number\";\n    case TypeKind.MEDIA_REF:\n      return \"string\";\n    case TypeKind.OBJECT_REF:\n      return \"string\";\n    case TypeKind.OPTIONAL:\n      if (fieldType.item == null) {\n        throw new Error(\"Optional field is missing inner type\");\n      }\n      return `(${convertTypeToTypeScript(fieldType.item)} | undefined)`;\n    case TypeKind.REF:\n      return \"unknown\";\n    case TypeKind.STRING:\n      return \"string\";\n    case TypeKind.USER_REF:\n      return \"string\";\n    default:\n      throw new Error(`Unknown schema field type: ${fieldType.type}`);\n  }\n}\n\n/**\n * Convert a schema field type to a FieldTypeDescriptor source string.\n */\nfunction convertTypeToFieldTypeDescriptor(fieldType: SchemaField, schema: RuntimeSchema): string {\n  switch (fieldType.type) {\n    case TypeKind.ARRAY:\n      if (fieldType.items == null) {\n        throw new Error(\"Array field is missing items type\");\n      }\n      return `{ kind: \"array\", element: ${\n        convertTypeToFieldTypeDescriptor(fieldType.items, schema)\n      } }`;\n    case TypeKind.OPTIONAL:\n      if (fieldType.item == null) {\n        throw new Error(\"Optional field is missing inner type\");\n      }\n      return `{ kind: \"optional\", inner: ${\n        convertTypeToFieldTypeDescriptor(fieldType.item, schema)\n      } }`;\n    case TypeKind.REF: {\n      if (fieldType.name == null) {\n        throw new Error(\"Ref field is missing a name\");\n      }\n      const exportKey = fieldType.refType === \"record\"\n        ? findRecordExportName(fieldType.name, schema) ?? fieldType.name\n        : fieldType.name;\n      return `{ kind: \"modelRef\", model: \"${exportKey}\" }`;\n    }\n    default:\n      return `{ kind: \"primitive\" }`;\n  }\n}\n\n/**\n * Convert a schema field type to a Zod schema string.\n */\nfunction convertTypeToZodSchema(fieldType: SchemaField): string {\n  switch (fieldType.type) {\n    case TypeKind.ARRAY:\n      if (fieldType.items == null) {\n        throw new Error(\"Array field is missing items type\");\n      }\n      return `z.array(${convertTypeToZodSchema(fieldType.items)})`;\n    case TypeKind.BOOLEAN:\n      return \"z.boolean()\";\n    case TypeKind.DOC_REF:\n    case TypeKind.MEDIA_REF:\n    case TypeKind.OBJECT_REF:\n    case TypeKind.STRING:\n    case TypeKind.USER_REF:\n      return \"z.string()\";\n    case TypeKind.DOUBLE:\n      return \"z.number()\";\n    case TypeKind.OPTIONAL:\n      if (fieldType.item == null) {\n        throw new Error(\"Optional field is missing inner type\");\n      }\n      return `${convertTypeToZodSchema(fieldType.item)}.optional()`;\n    case TypeKind.REF:\n      return \"z.unknown()\";\n    default:\n      throw new Error(`Unknown schema field type: ${fieldType.type}`);\n  }\n}\n\n/** Collected info about all fields for a model across all versions. */\ninterface AllFieldInfo {\n  fieldType: SchemaField;\n  /** Versions where this field exists. */\n  presentInVersions: Set<number>;\n  /** Whether field is always optional. */\n  alwaysOptional: boolean;\n  /** Default value if any. */\n  default?: unknown;\n}\n\n/**\n * Represents an upgrade step for a model between version transitions.\n */\ninterface UpgradeStep {\n  name: string;\n  addedInVersion: number;\n  fields: Map<string, { derivedFrom: string[]; forwardSource: string; default?: unknown }>;\n  removedFields: string[];\n}\n\ninterface RecordModelInfo {\n  allFields: Map<string, AllFieldInfo>;\n  steps: UpgradeStep[];\n}\n\n/**\n * Helper to iterate sorted entries of a Map.\n */\nfunction sortedEntries<V>(map: Map<string, V>): [string, V][] {\n  return Array.from(map.entries()).sort(([a], [b]) => a.localeCompare(b));\n}\n\n/**\n * Collect all record model info across all versions and compute upgrade steps.\n */\nfunction collectRecordModels(\n  chain: VersionedSchemaEntry[],\n): Map<string, RecordModelInfo> {\n  const allRecordModels = new Map<string, RecordModelInfo>();\n\n  // Initialize models from all versions\n  for (const { version, schema } of chain) {\n    for (const [exportName, item] of Object.entries(schema)) {\n      if (!isRecordSchema(item)) continue;\n\n      if (!allRecordModels.has(exportName)) {\n        allRecordModels.set(exportName, {\n          allFields: new Map(),\n          steps: [],\n        });\n      }\n\n      const model = allRecordModels.get(exportName)!;\n\n      for (const [fieldName, fieldType] of Object.entries(item.fields)) {\n        const existing = model.allFields.get(fieldName);\n        if (existing == null) {\n          model.allFields.set(fieldName, {\n            fieldType,\n            presentInVersions: new Set([version]),\n            alwaysOptional: fieldType.type === TypeKind.OPTIONAL,\n          });\n        } else {\n          existing.presentInVersions.add(version);\n          if (fieldType.type !== TypeKind.OPTIONAL) {\n            existing.alwaysOptional = false;\n          }\n        }\n      }\n    }\n  }\n\n  // Compute upgrade steps from version diffs\n  for (let i = 1; i < chain.length; i++) {\n    const prevVersion = chain[i - 1]!;\n    const currVersion = chain[i]!;\n\n    for (const [exportName, currItem] of Object.entries(currVersion.schema)) {\n      if (!isRecordSchema(currItem)) continue;\n\n      const prevItem = prevVersion.schema[exportName];\n      if (prevItem == null || !isRecordSchema(prevItem)) continue;\n\n      const model = allRecordModels.get(exportName);\n      if (model == null) continue;\n\n      const prevFields = new Set(Object.keys(prevItem.fields));\n      const currFields = new Set(Object.keys(currItem.fields));\n\n      // Fields added in this version\n      const addedFields = new Map<\n        string,\n        { derivedFrom: string[]; forwardSource: string; default?: unknown }\n      >();\n      const recordUpgrades = currVersion.migrations?.[exportName];\n      for (const fieldName of currFields) {\n        if (!prevFields.has(fieldName)) {\n          const annotation = recordUpgrades?.[fieldName];\n          if (annotation != null) {\n            addedFields.set(fieldName, {\n              derivedFrom: [...annotation.derivedFrom],\n              forwardSource: annotation.forward.toString(),\n            });\n          } else {\n            addedFields.set(fieldName, {\n              derivedFrom: [],\n              forwardSource: \"() => undefined\",\n            });\n          }\n        }\n      }\n\n      // Fields removed in this version\n      const removedFields: string[] = [];\n      for (const fieldName of prevFields) {\n        if (!currFields.has(fieldName)) {\n          removedFields.push(fieldName);\n        }\n      }\n\n      if (addedFields.size > 0 || removedFields.length > 0) {\n        model.steps.push({\n          name: `v${currVersion.version}`,\n          addedInVersion: currVersion.version,\n          fields: addedFields,\n          removedFields,\n        });\n      }\n    }\n  }\n\n  // Mark fields that are not present in ALL versions as optional in internal type\n  const totalVersions = chain.length;\n  for (const model of allRecordModels.values()) {\n    for (const [, fieldInfo] of model.allFields) {\n      if (fieldInfo.presentInVersions.size < totalVersions) {\n        fieldInfo.alwaysOptional = true;\n      }\n    }\n  }\n\n  return allRecordModels;\n}\n\n/**\n * Generate _internal/types.ts content.\n */\nfunction generateInternalTypes(\n  allRecordModels: Map<string, RecordModelInfo>,\n): string {\n  let output = GENERATED_FILE_HEADER;\n  output += \"\\n\";\n\n  for (const [exportName, model] of sortedEntries(allRecordModels)) {\n    output += `/** Internal representation containing all fields across all schema versions. */\\n`;\n    output += `export interface ${exportName}__Internal {\\n`;\n\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      const tsType = convertTypeToTypeScript(fieldInfo.fieldType);\n      const optional = fieldInfo.alwaysOptional ? \"?\" : \"\";\n      output += `  readonly ${fieldName}${optional}: ${tsType};\\n`;\n    }\n\n    output += \"}\\n\\n\";\n  }\n\n  return output;\n}\n\n/**\n * Generate _internal/upgrades.ts content.\n */\nfunction generateUpgrades(\n  allRecordModels: Map<string, RecordModelInfo>,\n  latestSchema: RuntimeSchema,\n): string {\n  let output = GENERATED_FILE_HEADER;\n\n  const hasRecords = allRecordModels.size > 0;\n  const hasUnions = Object.values(latestSchema).some(isUnionSchema);\n\n  const imports: string[] = [];\n  if (hasRecords) imports.push(\"UpgradeRegistry\");\n  if (hasUnions) imports.push(\"UnionUpgradeRegistry\");\n\n  if (imports.length > 0) {\n    output += `import type { ${\n      imports.join(\", \")\n    } } from \"@palantir/pack.document-schema.model-types\";\\n\\n`;\n  }\n\n  for (const [exportName, model] of sortedEntries(allRecordModels)) {\n    output += `export const ${exportName}Upgrades: UpgradeRegistry<\"${exportName}\"> = {\\n`;\n    output += `  modelName: \"${exportName}\",\\n`;\n\n    // allFields\n    output += `  allFields: {\\n`;\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      const typeDescriptor = convertTypeToFieldTypeDescriptor(fieldInfo.fieldType, latestSchema);\n      if (fieldInfo.default !== undefined) {\n        output += `    ${fieldName}: { type: ${typeDescriptor}, default: ${\n          JSON.stringify(fieldInfo.default)\n        } },\\n`;\n      } else {\n        output += `    ${fieldName}: { type: ${typeDescriptor} },\\n`;\n      }\n    }\n    output += `  },\\n`;\n\n    // steps\n    output += `  steps: [\\n`;\n    for (const step of model.steps) {\n      output += `    {\\n`;\n      output += `      name: \"${step.name}\",\\n`;\n      output += `      addedInVersion: ${step.addedInVersion},\\n`;\n      output += `      fields: {\\n`;\n      for (const [fieldName, fieldMeta] of step.fields) {\n        output += `        ${fieldName}: {\\n`;\n        output += `          derivedFrom: [${\n          fieldMeta.derivedFrom.map(d => `\"${d}\"`).join(\", \")\n        }],\\n`;\n        output += `          forward: ${fieldMeta.forwardSource},\\n`;\n        if (fieldMeta.default !== undefined) {\n          output += `          default: ${JSON.stringify(fieldMeta.default)},\\n`;\n        }\n        output += `        },\\n`;\n      }\n      output += `      },\\n`;\n      if (step.removedFields.length > 0) {\n        output += `      removedFields: [${step.removedFields.map(f => `\"${f}\"`).join(\", \")}],\\n`;\n      }\n      output += `    },\\n`;\n    }\n    output += `  ],\\n`;\n\n    output += `};\\n\\n`;\n  }\n\n  // Generate UnionUpgradeRegistry entries for union models\n  for (const [exportName, item] of Object.entries(latestSchema)) {\n    if (!isUnionSchema(item)) continue;\n\n    output += `export const ${exportName}Upgrades: UnionUpgradeRegistry<\"${exportName}\"> = {\\n`;\n    output += `  modelName: \"${exportName}\",\\n`;\n    output += `  discriminant: \"${item.discriminant}\",\\n`;\n    output += `  variants: {\\n`;\n    for (const [variantKey, variantField] of Object.entries(item.variants)) {\n      if (\n        variantField.type === \"ref\" && variantField.refType === \"record\"\n        && variantField.name != null\n      ) {\n        const variantExportName = findRecordExportName(variantField.name, latestSchema);\n        if (variantExportName != null) {\n          output += `    \"${variantKey}\": \"${variantExportName}\",\\n`;\n        }\n      }\n    }\n    output += `  },\\n`;\n    output += `};\\n\\n`;\n  }\n\n  return output;\n}\n\n/**\n * Generate _internal/schema.ts content.\n */\nfunction generateInternalSchemaContent(\n  allRecordModels: Map<string, RecordModelInfo>,\n): string {\n  let output = GENERATED_FILE_HEADER;\n  output += `import { z } from \"zod\";\\n\\n`;\n\n  for (const [exportName, model] of sortedEntries(allRecordModels)) {\n    output += `export const ${exportName}InternalSchema = z.object({\\n`;\n\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      const zodType = convertTypeToZodSchema(fieldInfo.fieldType);\n      // In internal schema, all fields that might be absent are optional\n      if (fieldInfo.alwaysOptional) {\n        // If the type already ends with .optional(), don't double-wrap\n        if (zodType.endsWith(\".optional()\")) {\n          output += `  ${fieldName}: ${zodType},\\n`;\n        } else {\n          output += `  ${fieldName}: ${zodType}.optional(),\\n`;\n        }\n      } else {\n        output += `  ${fieldName}: ${zodType},\\n`;\n      }\n    }\n\n    output += `}).passthrough();\\n\\n`;\n  }\n\n  return output;\n}\n\n/**\n * Generate _internal/types.ts, _internal/upgrades.ts, and _internal/schema.ts\n * from a versioned schema chain.\n *\n * @param schema - The schema definition (initial or versioned)\n * @returns Object containing generated code for each internal file\n */\nexport function generateInternalFromSchema(\n  schema: SchemaDefinition,\n): InternalTypesOutput {\n  const { chain } = resolveSchemaChain(schema);\n  const latestSchema = chain[chain.length - 1]!.schema;\n\n  const allRecordModels = collectRecordModels(chain);\n\n  const internalTypes = generateInternalTypes(allRecordModels);\n  const upgrades = generateUpgrades(allRecordModels, latestSchema);\n  const internalSchema = generateInternalSchemaContent(allRecordModels);\n\n  return { internalTypes, upgrades, internalSchema };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,qBAAqB,QAAQ,2BAA2B;AAEjE,SAASC,kBAAkB,QAAQ,yBAAyB;AAE5D,SAASC,oBAAoB,EAAEC,cAAc,EAAEC,aAAa,EAAEC,QAAQ,QAAQ,oBAAoB;AAWlG;AACA;AACA;AACA,SAASC,uBAAuBA,CAACC,SAAsB,EAAU;EAC/D,QAAQA,SAAS,CAACC,IAAI;IACpB,KAAKH,QAAQ,CAACI,KAAK;MAAE;QACnB,IAAIF,SAAS,CAACG,KAAK,IAAI,IAAI,EAAE;UAC3B,MAAM,IAAIC,KAAK,CAAC,mCAAmC,CAAC;QACtD;QACA,MAAMC,KAAK,GAAGN,uBAAuB,CAACC,SAAS,CAACG,KAAK,CAAC;QACtD;QACA,MAAMG,WAAW,GAAGD,KAAK,CAACE,QAAQ,CAAC,GAAG,CAAC,IAAIF,KAAK,CAACG,UAAU,CAAC,WAAW,CAAC;QACxE,MAAMC,OAAO,GAAGH,WAAW,GAAG,IAAID,KAAK,GAAG,GAAGA,KAAK;QAClD,OAAO,YAAYI,OAAO,IAAI;MAChC;IACA,KAAKX,QAAQ,CAACY,OAAO;MACnB,OAAO,SAAS;IAClB,KAAKZ,QAAQ,CAACa,OAAO;MACnB,OAAO,QAAQ;IACjB,KAAKb,QAAQ,CAACc,MAAM;MAClB,OAAO,QAAQ;IACjB,KAAKd,QAAQ,CAACe,SAAS;MACrB,OAAO,QAAQ;IACjB,KAAKf,QAAQ,CAACgB,UAAU;MACtB,OAAO,QAAQ;IACjB,KAAKhB,QAAQ,CAACiB,QAAQ;MACpB,IAAIf,SAAS,CAACgB,IAAI,IAAI,IAAI,EAAE;QAC1B,MAAM,IAAIZ,KAAK,CAAC,sCAAsC,CAAC;MACzD;MACA,OAAO,IAAIL,uBAAuB,CAACC,SAAS,CAACgB,IAAI,CAAC,eAAe;IACnE,KAAKlB,QAAQ,CAACmB,GAAG;MACf,OAAO,SAAS;IAClB,KAAKnB,QAAQ,CAACoB,MAAM;MAClB,OAAO,QAAQ;IACjB,KAAKpB,QAAQ,CAACqB,QAAQ;MACpB,OAAO,QAAQ;IACjB;MACE,MAAM,IAAIf,KAAK,CAAC,8BAA8BJ,SAAS,CAACC,IAAI,EAAE,CAAC;EACnE;AACF;;AAEA;AACA;AACA;AACA,SAASmB,gCAAgCA,CAACpB,SAAsB,EAAEqB,MAAqB,EAAU;EAC/F,QAAQrB,SAAS,CAACC,IAAI;IACpB,KAAKH,QAAQ,CAACI,KAAK;MACjB,IAAIF,SAAS,CAACG,KAAK,IAAI,IAAI,EAAE;QAC3B,MAAM,IAAIC,KAAK,CAAC,mCAAmC,CAAC;MACtD;MACA,OAAO,6BACLgB,gCAAgC,CAACpB,SAAS,CAACG,KAAK,EAAEkB,MAAM,CAAC,IACvD;IACN,KAAKvB,QAAQ,CAACiB,QAAQ;MACpB,IAAIf,SAAS,CAACgB,IAAI,IAAI,IAAI,EAAE;QAC1B,MAAM,IAAIZ,KAAK,CAAC,sCAAsC,CAAC;MACzD;MACA,OAAO,8BACLgB,gCAAgC,CAACpB,SAAS,CAACgB,IAAI,EAAEK,MAAM,CAAC,IACtD;IACN,KAAKvB,QAAQ,CAACmB,GAAG;MAAE;QACjB,IAAIjB,SAAS,CAACsB,IAAI,IAAI,IAAI,EAAE;UAC1B,MAAM,IAAIlB,KAAK,CAAC,6BAA6B,CAAC;QAChD;QACA,MAAMmB,SAAS,GAAGvB,SAAS,CAACwB,OAAO,KAAK,QAAQ,GAC5C7B,oBAAoB,CAACK,SAAS,CAACsB,IAAI,EAAED,MAAM,CAAC,IAAIrB,SAAS,CAACsB,IAAI,GAC9DtB,SAAS,CAACsB,IAAI;QAClB,OAAO,+BAA+BC,SAAS,KAAK;MACtD;IACA;MACE,OAAO,uBAAuB;EAClC;AACF;;AAEA;AACA;AACA;AACA,SAASE,sBAAsBA,CAACzB,SAAsB,EAAU;EAC9D,QAAQA,SAAS,CAACC,IAAI;IACpB,KAAKH,QAAQ,CAACI,KAAK;MACjB,IAAIF,SAAS,CAACG,KAAK,IAAI,IAAI,EAAE;QAC3B,MAAM,IAAIC,KAAK,CAAC,mCAAmC,CAAC;MACtD;MACA,OAAO,WAAWqB,sBAAsB,CAACzB,SAAS,CAACG,KAAK,CAAC,GAAG;IAC9D,KAAKL,QAAQ,CAACY,OAAO;MACnB,OAAO,aAAa;IACtB,KAAKZ,QAAQ,CAACa,OAAO;IACrB,KAAKb,QAAQ,CAACe,SAAS;IACvB,KAAKf,QAAQ,CAACgB,UAAU;IACxB,KAAKhB,QAAQ,CAACoB,MAAM;IACpB,KAAKpB,QAAQ,CAACqB,QAAQ;MACpB,OAAO,YAAY;IACrB,KAAKrB,QAAQ,CAACc,MAAM;MAClB,OAAO,YAAY;IACrB,KAAKd,QAAQ,CAACiB,QAAQ;MACpB,IAAIf,SAAS,CAACgB,IAAI,IAAI,IAAI,EAAE;QAC1B,MAAM,IAAIZ,KAAK,CAAC,sCAAsC,CAAC;MACzD;MACA,OAAO,GAAGqB,sBAAsB,CAACzB,SAAS,CAACgB,IAAI,CAAC,aAAa;IAC/D,KAAKlB,QAAQ,CAACmB,GAAG;MACf,OAAO,aAAa;IACtB;MACE,MAAM,IAAIb,KAAK,CAAC,8BAA8BJ,SAAS,CAACC,IAAI,EAAE,CAAC;EACnE;AACF;;AAEA;;AAWA;AACA;AACA;;AAaA;AACA;AACA;AACA,SAASyB,aAAaA,CAAIC,GAAmB,EAAiB;EAC5D,OAAOC,KAAK,CAACC,IAAI,CAACF,GAAG,CAACG,OAAO,CAAC,CAAC,CAAC,CAACC,IAAI,CAAC,CAAC,CAACC,CAAC,CAAC,EAAE,CAACC,CAAC,CAAC,KAAKD,CAAC,CAACE,aAAa,CAACD,CAAC,CAAC,CAAC;AACzE;;AAEA;AACA;AACA;AACA,SAASE,mBAAmBA,CAC1BC,KAA6B,EACC;EAC9B,MAAMC,eAAe,GAAG,IAAIC,GAAG,CAA0B,CAAC;;EAE1D;EACA,KAAK,MAAM;IAAEC,OAAO;IAAElB;EAAO,CAAC,IAAIe,KAAK,EAAE;IACvC,KAAK,MAAM,CAACI,UAAU,EAAExB,IAAI,CAAC,IAAIyB,MAAM,CAACX,OAAO,CAACT,MAAM,CAAC,EAAE;MACvD,IAAI,CAACzB,cAAc,CAACoB,IAAI,CAAC,EAAE;MAE3B,IAAI,CAACqB,eAAe,CAACK,GAAG,CAACF,UAAU,CAAC,EAAE;QACpCH,eAAe,CAACM,GAAG,CAACH,UAAU,EAAE;UAC9BI,SAAS,EAAE,IAAIN,GAAG,CAAC,CAAC;UACpBO,KAAK,EAAE;QACT,CAAC,CAAC;MACJ;MAEA,MAAMC,KAAK,GAAGT,eAAe,CAACU,GAAG,CAACP,UAAU,CAAE;MAE9C,KAAK,MAAM,CAACQ,SAAS,EAAEhD,SAAS,CAAC,IAAIyC,MAAM,CAACX,OAAO,CAACd,IAAI,CAACiC,MAAM,CAAC,EAAE;QAChE,MAAMC,QAAQ,GAAGJ,KAAK,CAACF,SAAS,CAACG,GAAG,CAACC,SAAS,CAAC;QAC/C,IAAIE,QAAQ,IAAI,IAAI,EAAE;UACpBJ,KAAK,CAACF,SAAS,CAACD,GAAG,CAACK,SAAS,EAAE;YAC7BhD,SAAS;YACTmD,iBAAiB,EAAE,IAAIC,GAAG,CAAC,CAACb,OAAO,CAAC,CAAC;YACrCc,cAAc,EAAErD,SAAS,CAACC,IAAI,KAAKH,QAAQ,CAACiB;UAC9C,CAAC,CAAC;QACJ,CAAC,MAAM;UACLmC,QAAQ,CAACC,iBAAiB,CAACG,GAAG,CAACf,OAAO,CAAC;UACvC,IAAIvC,SAAS,CAACC,IAAI,KAAKH,QAAQ,CAACiB,QAAQ,EAAE;YACxCmC,QAAQ,CAACG,cAAc,GAAG,KAAK;UACjC;QACF;MACF;IACF;EACF;;EAEA;EACA,KAAK,IAAIE,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGnB,KAAK,CAACoB,MAAM,EAAED,CAAC,EAAE,EAAE;IACrC,MAAME,WAAW,GAAGrB,KAAK,CAACmB,CAAC,GAAG,CAAC,CAAE;IACjC,MAAMG,WAAW,GAAGtB,KAAK,CAACmB,CAAC,CAAE;IAE7B,KAAK,MAAM,CAACf,UAAU,EAAEmB,QAAQ,CAAC,IAAIlB,MAAM,CAACX,OAAO,CAAC4B,WAAW,CAACrC,MAAM,CAAC,EAAE;MACvE,IAAI,CAACzB,cAAc,CAAC+D,QAAQ,CAAC,EAAE;MAE/B,MAAMC,QAAQ,GAAGH,WAAW,CAACpC,MAAM,CAACmB,UAAU,CAAC;MAC/C,IAAIoB,QAAQ,IAAI,IAAI,IAAI,CAAChE,cAAc,CAACgE,QAAQ,CAAC,EAAE;MAEnD,MAAMd,KAAK,GAAGT,eAAe,CAACU,GAAG,CAACP,UAAU,CAAC;MAC7C,IAAIM,KAAK,IAAI,IAAI,EAAE;MAEnB,MAAMe,UAAU,GAAG,IAAIT,GAAG,CAACX,MAAM,CAACqB,IAAI,CAACF,QAAQ,CAACX,MAAM,CAAC,CAAC;MACxD,MAAMc,UAAU,GAAG,IAAIX,GAAG,CAACX,MAAM,CAACqB,IAAI,CAACH,QAAQ,CAACV,MAAM,CAAC,CAAC;;MAExD;MACA,MAAMe,WAAW,GAAG,IAAI1B,GAAG,CAGzB,CAAC;MACH,MAAM2B,cAAc,GAAGP,WAAW,CAACQ,UAAU,GAAG1B,UAAU,CAAC;MAC3D,KAAK,MAAMQ,SAAS,IAAIe,UAAU,EAAE;QAClC,IAAI,CAACF,UAAU,CAACnB,GAAG,CAACM,SAAS,CAAC,EAAE;UAC9B,MAAMmB,UAAU,GAAGF,cAAc,GAAGjB,SAAS,CAAC;UAC9C,IAAImB,UAAU,IAAI,IAAI,EAAE;YACtBH,WAAW,CAACrB,GAAG,CAACK,SAAS,EAAE;cACzBoB,WAAW,EAAE,CAAC,GAAGD,UAAU,CAACC,WAAW,CAAC;cACxCC,aAAa,EAAEF,UAAU,CAACG,OAAO,CAACC,QAAQ,CAAC;YAC7C,CAAC,CAAC;UACJ,CAAC,MAAM;YACLP,WAAW,CAACrB,GAAG,CAACK,SAAS,EAAE;cACzBoB,WAAW,EAAE,EAAE;cACfC,aAAa,EAAE;YACjB,CAAC,CAAC;UACJ;QACF;MACF;;MAEA;MACA,MAAMG,aAAuB,GAAG,EAAE;MAClC,KAAK,MAAMxB,SAAS,IAAIa,UAAU,EAAE;QAClC,IAAI,CAACE,UAAU,CAACrB,GAAG,CAACM,SAAS,CAAC,EAAE;UAC9BwB,aAAa,CAACC,IAAI,CAACzB,SAAS,CAAC;QAC/B;MACF;MAEA,IAAIgB,WAAW,CAACU,IAAI,GAAG,CAAC,IAAIF,aAAa,CAAChB,MAAM,GAAG,CAAC,EAAE;QACpDV,KAAK,CAACD,KAAK,CAAC4B,IAAI,CAAC;UACfnD,IAAI,EAAE,IAAIoC,WAAW,CAACnB,OAAO,EAAE;UAC/BoC,cAAc,EAAEjB,WAAW,CAACnB,OAAO;UACnCU,MAAM,EAAEe,WAAW;UACnBQ;QACF,CAAC,CAAC;MACJ;IACF;EACF;;EAEA;EACA,MAAMI,aAAa,GAAGxC,KAAK,CAACoB,MAAM;EAClC,KAAK,MAAMV,KAAK,IAAIT,eAAe,CAACwC,MAAM,CAAC,CAAC,EAAE;IAC5C,KAAK,MAAM,GAAGC,SAAS,CAAC,IAAIhC,KAAK,CAACF,SAAS,EAAE;MAC3C,IAAIkC,SAAS,CAAC3B,iBAAiB,CAACuB,IAAI,GAAGE,aAAa,EAAE;QACpDE,SAAS,CAACzB,cAAc,GAAG,IAAI;MACjC;IACF;EACF;EAEA,OAAOhB,eAAe;AACxB;;AAEA;AACA;AACA;AACA,SAAS0C,qBAAqBA,CAC5B1C,eAA6C,EACrC;EACR,IAAI2C,MAAM,GAAGvF,qBAAqB;EAClCuF,MAAM,IAAI,IAAI;EAEd,KAAK,MAAM,CAACxC,UAAU,EAAEM,KAAK,CAAC,IAAIpB,aAAa,CAACW,eAAe,CAAC,EAAE;IAChE2C,MAAM,IAAI,oFAAoF;IAC9FA,MAAM,IAAI,oBAAoBxC,UAAU,gBAAgB;IAExD,KAAK,MAAM,CAACQ,SAAS,EAAE8B,SAAS,CAAC,IAAIpD,aAAa,CAACoB,KAAK,CAACF,SAAS,CAAC,EAAE;MACnE,MAAMqC,MAAM,GAAGlF,uBAAuB,CAAC+E,SAAS,CAAC9E,SAAS,CAAC;MAC3D,MAAMkF,QAAQ,GAAGJ,SAAS,CAACzB,cAAc,GAAG,GAAG,GAAG,EAAE;MACpD2B,MAAM,IAAI,cAAchC,SAAS,GAAGkC,QAAQ,KAAKD,MAAM,KAAK;IAC9D;IAEAD,MAAM,IAAI,OAAO;EACnB;EAEA,OAAOA,MAAM;AACf;;AAEA;AACA;AACA;AACA,SAASG,gBAAgBA,CACvB9C,eAA6C,EAC7C+C,YAA2B,EACnB;EACR,IAAIJ,MAAM,GAAGvF,qBAAqB;EAElC,MAAM4F,UAAU,GAAGhD,eAAe,CAACqC,IAAI,GAAG,CAAC;EAC3C,MAAMY,SAAS,GAAG7C,MAAM,CAACoC,MAAM,CAACO,YAAY,CAAC,CAACG,IAAI,CAAC1F,aAAa,CAAC;EAEjE,MAAM2F,OAAiB,GAAG,EAAE;EAC5B,IAAIH,UAAU,EAAEG,OAAO,CAACf,IAAI,CAAC,iBAAiB,CAAC;EAC/C,IAAIa,SAAS,EAAEE,OAAO,CAACf,IAAI,CAAC,sBAAsB,CAAC;EAEnD,IAAIe,OAAO,CAAChC,MAAM,GAAG,CAAC,EAAE;IACtBwB,MAAM,IAAI,iBACRQ,OAAO,CAACC,IAAI,CAAC,IAAI,CAAC,2DACuC;EAC7D;EAEA,KAAK,MAAM,CAACjD,UAAU,EAAEM,KAAK,CAAC,IAAIpB,aAAa,CAACW,eAAe,CAAC,EAAE;IAChE2C,MAAM,IAAI,gBAAgBxC,UAAU,8BAA8BA,UAAU,UAAU;IACtFwC,MAAM,IAAI,iBAAiBxC,UAAU,MAAM;;IAE3C;IACAwC,MAAM,IAAI,kBAAkB;IAC5B,KAAK,MAAM,CAAChC,SAAS,EAAE8B,SAAS,CAAC,IAAIpD,aAAa,CAACoB,KAAK,CAACF,SAAS,CAAC,EAAE;MACnE,MAAM8C,cAAc,GAAGtE,gCAAgC,CAAC0D,SAAS,CAAC9E,SAAS,EAAEoF,YAAY,CAAC;MAC1F,IAAIN,SAAS,CAACa,OAAO,KAAKC,SAAS,EAAE;QACnCZ,MAAM,IAAI,OAAOhC,SAAS,aAAa0C,cAAc,cACnDG,IAAI,CAACC,SAAS,CAAChB,SAAS,CAACa,OAAO,CAAC,OAC5B;MACT,CAAC,MAAM;QACLX,MAAM,IAAI,OAAOhC,SAAS,aAAa0C,cAAc,OAAO;MAC9D;IACF;IACAV,MAAM,IAAI,QAAQ;;IAElB;IACAA,MAAM,IAAI,cAAc;IACxB,KAAK,MAAMe,IAAI,IAAIjD,KAAK,CAACD,KAAK,EAAE;MAC9BmC,MAAM,IAAI,SAAS;MACnBA,MAAM,IAAI,gBAAgBe,IAAI,CAACzE,IAAI,MAAM;MACzC0D,MAAM,IAAI,yBAAyBe,IAAI,CAACpB,cAAc,KAAK;MAC3DK,MAAM,IAAI,mBAAmB;MAC7B,KAAK,MAAM,CAAChC,SAAS,EAAEgD,SAAS,CAAC,IAAID,IAAI,CAAC9C,MAAM,EAAE;QAChD+B,MAAM,IAAI,WAAWhC,SAAS,OAAO;QACrCgC,MAAM,IAAI,2BACRgB,SAAS,CAAC5B,WAAW,CAACzC,GAAG,CAACsE,CAAC,IAAI,IAAIA,CAAC,GAAG,CAAC,CAACR,IAAI,CAAC,IAAI,CAAC,MAC/C;QACNT,MAAM,IAAI,sBAAsBgB,SAAS,CAAC3B,aAAa,KAAK;QAC5D,IAAI2B,SAAS,CAACL,OAAO,KAAKC,SAAS,EAAE;UACnCZ,MAAM,IAAI,sBAAsBa,IAAI,CAACC,SAAS,CAACE,SAAS,CAACL,OAAO,CAAC,KAAK;QACxE;QACAX,MAAM,IAAI,cAAc;MAC1B;MACAA,MAAM,IAAI,YAAY;MACtB,IAAIe,IAAI,CAACvB,aAAa,CAAChB,MAAM,GAAG,CAAC,EAAE;QACjCwB,MAAM,IAAI,yBAAyBe,IAAI,CAACvB,aAAa,CAAC7C,GAAG,CAACuE,CAAC,IAAI,IAAIA,CAAC,GAAG,CAAC,CAACT,IAAI,CAAC,IAAI,CAAC,MAAM;MAC3F;MACAT,MAAM,IAAI,UAAU;IACtB;IACAA,MAAM,IAAI,QAAQ;IAElBA,MAAM,IAAI,QAAQ;EACpB;;EAEA;EACA,KAAK,MAAM,CAACxC,UAAU,EAAExB,IAAI,CAAC,IAAIyB,MAAM,CAACX,OAAO,CAACsD,YAAY,CAAC,EAAE;IAC7D,IAAI,CAACvF,aAAa,CAACmB,IAAI,CAAC,EAAE;IAE1BgE,MAAM,IAAI,gBAAgBxC,UAAU,mCAAmCA,UAAU,UAAU;IAC3FwC,MAAM,IAAI,iBAAiBxC,UAAU,MAAM;IAC3CwC,MAAM,IAAI,oBAAoBhE,IAAI,CAACmF,YAAY,MAAM;IACrDnB,MAAM,IAAI,iBAAiB;IAC3B,KAAK,MAAM,CAACoB,UAAU,EAAEC,YAAY,CAAC,IAAI5D,MAAM,CAACX,OAAO,CAACd,IAAI,CAACsF,QAAQ,CAAC,EAAE;MACtE,IACED,YAAY,CAACpG,IAAI,KAAK,KAAK,IAAIoG,YAAY,CAAC7E,OAAO,KAAK,QAAQ,IAC7D6E,YAAY,CAAC/E,IAAI,IAAI,IAAI,EAC5B;QACA,MAAMiF,iBAAiB,GAAG5G,oBAAoB,CAAC0G,YAAY,CAAC/E,IAAI,EAAE8D,YAAY,CAAC;QAC/E,IAAImB,iBAAiB,IAAI,IAAI,EAAE;UAC7BvB,MAAM,IAAI,QAAQoB,UAAU,OAAOG,iBAAiB,MAAM;QAC5D;MACF;IACF;IACAvB,MAAM,IAAI,QAAQ;IAClBA,MAAM,IAAI,QAAQ;EACpB;EAEA,OAAOA,MAAM;AACf;;AAEA;AACA;AACA;AACA,SAASwB,6BAA6BA,CACpCnE,eAA6C,EACrC;EACR,IAAI2C,MAAM,GAAGvF,qBAAqB;EAClCuF,MAAM,IAAI,8BAA8B;EAExC,KAAK,MAAM,CAACxC,UAAU,EAAEM,KAAK,CAAC,IAAIpB,aAAa,CAACW,eAAe,CAAC,EAAE;IAChE2C,MAAM,IAAI,gBAAgBxC,UAAU,+BAA+B;IAEnE,KAAK,MAAM,CAACQ,SAAS,EAAE8B,SAAS,CAAC,IAAIpD,aAAa,CAACoB,KAAK,CAACF,SAAS,CAAC,EAAE;MACnE,MAAM6D,OAAO,GAAGhF,sBAAsB,CAACqD,SAAS,CAAC9E,SAAS,CAAC;MAC3D;MACA,IAAI8E,SAAS,CAACzB,cAAc,EAAE;QAC5B;QACA,IAAIoD,OAAO,CAACC,QAAQ,CAAC,aAAa,CAAC,EAAE;UACnC1B,MAAM,IAAI,KAAKhC,SAAS,KAAKyD,OAAO,KAAK;QAC3C,CAAC,MAAM;UACLzB,MAAM,IAAI,KAAKhC,SAAS,KAAKyD,OAAO,gBAAgB;QACtD;MACF,CAAC,MAAM;QACLzB,MAAM,IAAI,KAAKhC,SAAS,KAAKyD,OAAO,KAAK;MAC3C;IACF;IAEAzB,MAAM,IAAI,uBAAuB;EACnC;EAEA,OAAOA,MAAM;AACf;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAAS2B,0BAA0BA,CACxCtF,MAAwB,EACH;EACrB,MAAM;IAAEe;EAAM,CAAC,GAAG1C,kBAAkB,CAAC2B,MAAM,CAAC;EAC5C,MAAM+D,YAAY,GAAGhD,KAAK,CAACA,KAAK,CAACoB,MAAM,GAAG,CAAC,CAAC,CAAEnC,MAAM;EAEpD,MAAMgB,eAAe,GAAGF,mBAAmB,CAACC,KAAK,CAAC;EAElD,MAAMwE,aAAa,GAAG7B,qBAAqB,CAAC1C,eAAe,CAAC;EAC5D,MAAMwE,QAAQ,GAAG1B,gBAAgB,CAAC9C,eAAe,EAAE+C,YAAY,CAAC;EAChE,MAAM0B,cAAc,GAAGN,6BAA6B,CAACnE,eAAe,CAAC;EAErE,OAAO;IAAEuE,aAAa;IAAEC,QAAQ;IAAEC;EAAe,CAAC;AACpD","ignoreList":[]}

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

@@ -0,0 +1,195 @@
+/*
+ * 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 { resolveSchemaChain } from "./resolveSchemaChain.js";
+import { INTERNAL_UPGRADES_PATH, isRecordSchema, isUnionSchema, modelName, SCHEMA_REEXPORT_PATH, schemaName, TYPES_REEXPORT_PATH } from "./runtimeSchema.js";
+/**
+ * Detect which external ref field types (docRef, mediaRef, objectRef, userRef)
+ * are present on a record for its model metadata.
+ */
+function findExternalRefType(field) {
+  switch (field.type) {
+    case "docRef":
+      return "docRef";
+    case "mediaRef":
+      return "mediaRef";
+    case "objectRef":
+      return "objectRef";
+    case "userRef":
+      return "userRef";
+    case "optional":
+      return field.item ? findExternalRefType(field.item) : undefined;
+    case "array":
+      return field.items ? findExternalRefType(field.items) : undefined;
+    default:
+      return undefined;
+  }
+}
+function extractExternalRefFieldTypes(record) {
+  const refs = [];
+  for (const [fieldName, fieldType] of Object.entries(record.fields)) {
+    const refType = findExternalRefType(fieldType);
+    if (refType != null) {
+      refs.push([fieldName, refType]);
+    }
+  }
+  return refs;
+}
+
+/**
+ * Generate models.ts and schema manifest from a versioned schema chain.
+ *
+ * @param schema - The schema definition (initial or versioned)
+ * @param minSupportedVersion - Minimum version this client supports (defaults to latest)
+ * @param options - Configuration for import paths
+ * @returns Object containing generated models.ts content and schema manifest JSON
+ */
+export function generateModelMetadataFromSchema(schema, minSupportedVersion) {
+  const {
+    chain,
+    latestVersion,
+    minVersion
+  } = resolveSchemaChain(schema, minSupportedVersion);
+  const latestSchema = chain[chain.length - 1].schema;
+
+  // --- Generate models.ts ---
+  let output = GENERATED_FILE_HEADER;
+
+  // Collect model names for imports
+  const recordNames = [];
+  const unionNames = [];
+  const variantNames = [];
+  for (const [exportName, item] of Object.entries(latestSchema)) {
+    if (isRecordSchema(item)) {
+      recordNames.push(exportName);
+    } else if (isUnionSchema(item)) {
+      unionNames.push(exportName);
+      for (const variantName of Object.keys(item.variants)) {
+        variantNames.push(`${exportName}${formatVariantName(variantName)}`);
+      }
+    }
+  }
+  const allModelNames = [...recordNames, ...unionNames, ...variantNames].sort();
+
+  // Imports
+  const modelTypesImports = ["DocumentSchema"];
+  if (recordNames.length > 0) modelTypesImports.push("RecordModel");
+  if (unionNames.length > 0) modelTypesImports.push("UnionModel");
+  output += `import type { ${modelTypesImports.sort().join(", ")} } from "@palantir/pack.document-schema.model-types";\n`;
+  output += `import { Metadata } from "@palantir/pack.document-schema.model-types";\n`;
+  if (allModelNames.length > 0) {
+    output += `import type { ${allModelNames.join(", ")} } from "${TYPES_REEXPORT_PATH}";\n`;
+  }
+
+  // Schema imports
+  const schemaNames = allModelNames.map(n => schemaName(n));
+  if (schemaNames.length > 0) {
+    output += `import { ${schemaNames.join(", ")} } from "${SCHEMA_REEXPORT_PATH}";\n`;
+  }
+
+  // Upgrade imports (only if there are upgrades)
+  const upgradeNames = [...recordNames, ...unionNames].map(n => `${n}Upgrades`);
+  if (chain.length > 1 && upgradeNames.length > 0) {
+    output += `import { ${upgradeNames.join(", ")} } from "${INTERNAL_UPGRADES_PATH}";\n`;
+  }
+  output += "\n";
+
+  // Generate model constants
+  for (const [exportName, item] of Object.entries(latestSchema)) {
+    if (isRecordSchema(item)) {
+      const externalRefs = extractExternalRefFieldTypes(item);
+      const metadataFields = [];
+      if (externalRefs.length > 0) {
+        const entries = externalRefs.map(([field, type]) => `      ${field}: "${type}",`).join("\n");
+        metadataFields.push(`    externalRefFieldTypes: {\n${entries}\n    },`);
+      }
+      metadataFields.push(`    name: "${exportName}",`);
+      output += `export interface ${modelName(exportName)} extends RecordModel<${exportName}, typeof ${schemaName(exportName)}> {}\n`;
+      output += `export const ${modelName(exportName)}: ${modelName(exportName)} = {\n`;
+      output += `  __type: {} as ${exportName},\n`;
+      output += `  zodSchema: ${schemaName(exportName)},\n`;
+      output += `  [Metadata]: {\n${metadataFields.join("\n")}\n  },\n`;
+      output += `};\n\n`;
+    } else if (isUnionSchema(item)) {
+      const metadataFields = [];
+      metadataFields.push(`    discriminant: "${item.discriminant}",`);
+      metadataFields.push(`    name: "${exportName}",`);
+      output += `export interface ${modelName(exportName)} extends UnionModel<${exportName}, typeof ${schemaName(exportName)}> {}\n`;
+      output += `export const ${modelName(exportName)}: ${modelName(exportName)} = {\n`;
+      output += `  __type: {} as ${exportName},\n`;
+      output += `  zodSchema: ${schemaName(exportName)},\n`;
+      output += `  [Metadata]: {\n${metadataFields.join("\n")}\n  },\n`;
+      output += `};\n\n`;
+
+      // Generate variant models
+      for (const variantName of Object.keys(item.variants)) {
+        const formattedVariant = formatVariantName(variantName);
+        const variantTypeName = `${exportName}${formattedVariant}`;
+        const variantMetadata = [];
+        variantMetadata.push(`    discriminant: "${item.discriminant}",`);
+        variantMetadata.push(`    name: "${variantTypeName}",`);
+        output += `export interface ${modelName(variantTypeName)} extends UnionModel<${variantTypeName}, typeof ${schemaName(variantTypeName)}> {}\n`;
+        output += `export const ${modelName(variantTypeName)}: ${modelName(variantTypeName)} = {\n`;
+        output += `  __type: {} as ${variantTypeName},\n`;
+        output += `  zodSchema: ${schemaName(variantTypeName)},\n`;
+        output += `  [Metadata]: {\n${variantMetadata.join("\n")}\n  },\n`;
+        output += `};\n\n`;
+      }
+    }
+  }
+
+  // Generate DocumentModel
+  const modelEntries = [];
+  for (const [exportName, item] of Object.entries(latestSchema)) {
+    if (isRecordSchema(item)) {
+      modelEntries.push(`  ${exportName}: ${modelName(exportName)}`);
+    } else if (isUnionSchema(item)) {
+      modelEntries.push(`  ${exportName}: ${modelName(exportName)}`);
+      for (const variantName of Object.keys(item.variants)) {
+        const formattedVariant = formatVariantName(variantName);
+        const variantTypeName = `${exportName}${formattedVariant}`;
+        modelEntries.push(`  ${variantTypeName}: ${modelName(variantTypeName)}`);
+      }
+    }
+  }
+
+  // Build upgrades map (includes both record and union entries)
+  let upgradesBlock;
+  const allUpgradeNames = [...recordNames, ...unionNames];
+  if (chain.length > 1 && allUpgradeNames.length > 0) {
+    const upgradeEntries = allUpgradeNames.map(n => `      ${n}: ${n}Upgrades,`).join("\n");
+    upgradesBlock = `    upgrades: {\n${upgradeEntries}\n    },\n`;
+  } else {
+    upgradesBlock = "";
+  }
+  output += `export const DocumentModel = {\n`;
+  output += `${modelEntries.join(",\n")},\n`;
+  output += `  [Metadata]: {\n`;
+  output += `    version: ${latestVersion},\n`;
+  if (minVersion !== latestVersion) {
+    output += `    minSupportedVersion: ${minVersion},\n`;
+  }
+  output += upgradesBlock;
+  output += `  },\n`;
+  output += `} as const satisfies DocumentSchema;\n\n`;
+  output += `export type DocumentModel = typeof DocumentModel;\n`;
+  return {
+    modelsFile: output
+  };
+}
+//# sourceMappingURL=generateModelMetadataFromSchema.js.map