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

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

@@ -17,16 +17,18 @@
 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";
+import { INTERNAL_UPGRADE_FNS_PATH, 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)
+ * - `models.js` (star export — model constants and `DocumentModel`; emitted
+ *   as a factory function when the schema has derived fields, otherwise a const)
  * - `types.js` (star export — latest-version type aliases)
  * - `versions.js` (star export — SupportedVersions, LatestVersion, MinSupportedVersion)
  * - `versionedDocRef.js` (star export — VersionedDocRef types and factory)
+ * - `DocumentUpgradeFns` type (the typed shape the factory accepts)
  * - Per supported version: explicit named type exports from `types_vN.js`
  *   (not star exports, to avoid polluting autocomplete for read-only consumers)
  */
@@ -44,6 +46,9 @@ export function generateIndexFromChain(resolved, minSupportedVersion) {
   output += `export * from "${TYPES_REEXPORT_PATH}";\n`;
   output += `export * from "${VERSIONS_PATH}";\n`;
   output += `export * from "${VERSIONED_DOC_REF_PATH}";\n`;
+  // The typed upgrade-function table shape. Apps reference this type when
+  // constructing the value passed to `DocumentModel(...)`.
+  output += `export { type DocumentUpgradeFns } from "${INTERNAL_UPGRADE_FNS_PATH}";\n`;
 
   // Per-version explicit named type exports
   for (const {

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

@@ -1 +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":[]}
+{"version":3,"file":"generateIndexFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","resolveMinVersion","INTERNAL_UPGRADE_FNS_PATH","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  INTERNAL_UPGRADE_FNS_PATH,\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`; emitted\n *   as a factory function when the schema has derived fields, otherwise a const)\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 * - `DocumentUpgradeFns` type (the typed shape the factory accepts)\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  // The typed upgrade-function table shape. Apps reference this type when\n  // constructing the value passed to `DocumentModel(...)`.\n  output += `export { type DocumentUpgradeFns } from \"${INTERNAL_UPGRADE_FNS_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,yBAAyB,EACzBC,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;AACA;AACA,OAAO,SAASC,sBAAsBA,CACpCC,QAAyB,EACzBC,mBAA4B,EACpB;EACR,MAAM;IAAEC;EAAM,CAAC,GAAGF,QAAQ;EAC1B,MAAM;IAAEG;EAAW,CAAC,GAAGZ,iBAAiB,CAACW,KAAK,EAAED,mBAAmB,CAAC;EAEpE,IAAIG,MAAM,GAAGd,qBAAqB;;EAElC;EACAc,MAAM,IAAI,kBAAkBX,WAAW,MAAM;EAC7CW,MAAM,IAAI,kBAAkBV,mBAAmB,MAAM;EACrDU,MAAM,IAAI,kBAAkBN,aAAa,MAAM;EAC/CM,MAAM,IAAI,kBAAkBR,sBAAsB,MAAM;EACxD;EACA;EACAQ,MAAM,IAAI,4CAA4CZ,yBAAyB,MAAM;;EAErF;EACA,KAAK,MAAM;IAAEa,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,GAAG9B,iBAAiB,CAAC0B,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

@@ -16,6 +16,7 @@
 
 import { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
 import { convertFieldTypeToDescriptor, convertFieldTypeToInternalTypeScript, convertFieldTypeToInternalZod } from "../ir/irFieldHelpers.js";
+import { chainHasDerivedFields } from "./resolveSchemaChain.js";
 
 /** Collected info about all fields for a model across all versions. */
 
@@ -94,13 +95,11 @@ function collectRecordModels(chain) {
           const annotation = recordUpgrades?.[fieldKey];
           if (annotation != null) {
             addedFields.set(fieldKey, {
-              derivedFrom: [...annotation.derivedFrom],
-              forwardSource: annotation.forwardSource
+              derivedFrom: [...annotation.derivedFrom]
             });
           } else {
             addedFields.set(fieldKey, {
-              derivedFrom: [],
-              forwardSource: "() => undefined"
+              derivedFrom: []
             });
           }
         }
@@ -115,7 +114,6 @@ function collectRecordModels(chain) {
       }
       if (addedFields.size > 0 || removedFields.length > 0) {
         model.steps.push({
-          name: `v${currEntry.version}`,
           addedInVersion: currEntry.version,
           fields: addedFields,
           removedFields
@@ -155,6 +153,56 @@ function generateInternalTypes(allRecordModels) {
   return output;
 }
 
+/**
+ * Generate per-version internal interfaces (e.g. `ShapeBox__v1`, `ShapeBox__v2`).
+ *
+ * Each interface contains only the fields present in that version, with their
+ * actual optionality taken straight from that version's IR. The downstream
+ * `DocumentUpgradeFns` generator uses these so each upgrade function's
+ * parameter can `Pick` the prior version's fields and its return type can
+ * index the current version's field type precisely.
+ */
+function generatePerVersionInternalTypes(chain) {
+  // Group by model so each model's versions appear together in ascending order.
+  const perModelVersions = new Map();
+  for (const {
+    version,
+    ir
+  } of chain) {
+    for (const [modelKey, modelDef] of Object.entries(ir.models)) {
+      if (modelDef.type !== "record") continue;
+      let list = perModelVersions.get(modelKey);
+      if (list == null) {
+        list = [];
+        perModelVersions.set(modelKey, list);
+      }
+      list.push({
+        version,
+        fields: modelDef.record.fields
+      });
+    }
+  }
+  let output = "";
+  const sortedModels = Array.from(perModelVersions.entries()).sort(([a], [b]) => a.localeCompare(b));
+  for (const [modelKey, versions] of sortedModels) {
+    for (const {
+      version,
+      fields
+    } of versions) {
+      output += `/** Internal representation of ${modelKey} at schema version ${version}. */\n`;
+      output += `export interface ${modelKey}__v${version} {\n`;
+      const sortedFields = [...fields].sort((a, b) => a.key.localeCompare(b.key));
+      for (const field of sortedFields) {
+        const tsType = convertFieldTypeToInternalTypeScript(field.fieldType, field.isOptional === true);
+        const optional = field.isOptional === true ? "?" : "";
+        output += `  readonly ${field.key}${optional}: ${tsType};\n`;
+      }
+      output += "}\n\n";
+    }
+  }
+  return output;
+}
+
 /**
  * Generate _internal/upgrades.ts content.
  */
@@ -184,13 +232,11 @@ function generateUpgrades(allRecordModels, latestIr) {
     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`;
         }
@@ -243,8 +289,87 @@ function generateInternalSchemaContent(allRecordModels) {
 }
 
 /**
- * Generate _internal/types.ts, _internal/upgrades.ts, and _internal/schema.ts
- * from an already-resolved versioned IR chain.
+ * Generate _internal/upgradeFns.ts content: a typed `DocumentUpgradeFns`
+ * interface enumerating every upgrade function the app must supply at boot.
+ *
+ * For every `(modelName, v${version}, fieldName)` triple where `derivedFrom` is
+ * non-empty, emit a property typed
+ * `(oldFields: Pick<<Model>__v<prior>, derivedFrom[number]>) => <Model>__v<current>[fieldName]`.
+ * Additive fields (empty `derivedFrom`) are intentionally absent — they are
+ * handled by the structural `default` in `_internal/upgrades.ts`.
+ *
+ * The interface is consumed by the generated `DocumentModel` factory in
+ * `models.ts`, which requires it as a parameter when the schema has any
+ * derived fields. Schemas without derived fields emit an empty interface
+ * (still exported for type-uniformity in downstream code).
+ */
+function generateUpgradeFns(chain, allRecordModels) {
+  const perModel = new Map();
+  const neededTypes = new Set();
+  for (const [modelKey, model] of sortedEntries(allRecordModels)) {
+    for (const step of model.steps) {
+      const currentIdx = chain.findIndex(c => c.version === step.addedInVersion);
+      if (currentIdx <= 0) continue;
+      const priorVersion = chain[currentIdx - 1].version;
+      const fields = [];
+      for (const [fieldName, fieldMeta] of step.fields) {
+        if (fieldMeta.derivedFrom.length === 0) continue;
+        fields.push({
+          fieldName,
+          derivedFrom: [...fieldMeta.derivedFrom]
+        });
+      }
+      if (fields.length === 0) continue;
+      let list = perModel.get(modelKey);
+      if (list == null) {
+        list = [];
+        perModel.set(modelKey, list);
+      }
+      list.push({
+        currentVersion: step.addedInVersion,
+        priorVersion,
+        fields
+      });
+      neededTypes.add(`${modelKey}__v${priorVersion}`);
+      neededTypes.add(`${modelKey}__v${step.addedInVersion}`);
+    }
+  }
+  let output = GENERATED_FILE_HEADER;
+  output += `\n`;
+  if (neededTypes.size > 0) {
+    const sorted = Array.from(neededTypes).sort();
+    output += `import type { ${sorted.join(", ")} } from "./types.js";\n\n`;
+  }
+  output += `/**\n`;
+  output += ` * Typed upgrade functions the application must supply at boot. Coverage is\n`;
+  output += ` * exhaustive: missing or extra entries fail type-check at the \`DocumentModel(...)\`\n`;
+  output += ` * call site. Additive fields (empty \`derivedFrom\`) are intentionally absent.\n`;
+  output += ` */\n`;
+  if (perModel.size === 0) {
+    output += `// eslint-disable-next-line @typescript-eslint/no-empty-object-type\n`;
+    output += `export interface DocumentUpgradeFns {}\n`;
+  } else {
+    output += `export interface DocumentUpgradeFns {\n`;
+    for (const [modelKey, steps] of Array.from(perModel.entries()).sort(([a], [b]) => a.localeCompare(b))) {
+      output += `  ${modelKey}: {\n`;
+      for (const step of steps) {
+        output += `    v${step.currentVersion}: {\n`;
+        for (const f of step.fields) {
+          const pickKeys = f.derivedFrom.map(d => `"${d}"`).join(" | ");
+          output += `      ${f.fieldName}: (oldFields: Pick<${modelKey}__v${step.priorVersion}, ${pickKeys}>) => ${modelKey}__v${step.currentVersion}["${f.fieldName}"];\n`;
+        }
+        output += `    };\n`;
+      }
+      output += `  };\n`;
+    }
+    output += `}\n`;
+  }
+  return output;
+}
+
+/**
+ * Generate _internal/types.ts, _internal/upgrades.ts, _internal/schema.ts and
+ * _internal/upgradeFns.ts from an already-resolved versioned IR chain.
  */
 export function generateInternalFromChain(resolved) {
   const {
@@ -252,13 +377,15 @@ export function generateInternalFromChain(resolved) {
   } = resolved;
   const latestIr = chain[chain.length - 1].ir;
   const allRecordModels = collectRecordModels(chain);
-  const internalTypes = generateInternalTypes(allRecordModels);
+  const internalTypes = generateInternalTypes(allRecordModels) + (chainHasDerivedFields(chain) ? generatePerVersionInternalTypes(chain) : "");
   const upgrades = generateUpgrades(allRecordModels, latestIr);
   const internalSchema = generateInternalSchemaContent(allRecordModels);
+  const internalUpgradeFns = generateUpgradeFns(chain, allRecordModels);
   return {
     internalTypes,
     upgrades,
-    internalSchema
+    internalSchema,
+    internalUpgradeFns
   };
 }
 //# sourceMappingURL=generateInternalFromSchema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generateInternalFromSchema.js","names":["GENERATED_FILE_HEADER","convertFieldTypeToDescriptor","convertFieldTypeToInternalTypeScript","convertFieldTypeToInternalZod","sortedEntries","map","Array","from","entries","sort","a","b","localeCompare","collectRecordModels","chain","allRecordModels","Map","version","ir","modelKey","modelDef","Object","models","type","has","set","allFields","steps","model","get","field","record","fields","existing","key","fieldType","isOptional","presentInVersions","Set","alwaysOptional","everOptional","add","i","length","prevEntry","currEntry","currModelDef","prevModelDef","prevFields","f","currFields","addedFields","recordUpgrades","migrations","fieldKey","annotation","derivedFrom","forwardSource","removedFields","push","size","name","addedInVersion","totalVersions","values","fieldInfo","generateInternalTypes","output","fieldName","tsType","optional","generateUpgrades","latestIr","hasRecords","hasUnions","some","m","imports","join","typeDescriptor","step","fieldMeta","d","default","undefined","JSON","stringify","union","discriminant","variantKey","variantModelKey","variants","generateInternalSchemaContent","zodType","generateInternalFromChain","resolved","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 {\n  IFieldTypeUnion,\n  IRealTimeDocumentSchema,\n} from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport {\n  convertFieldTypeToDescriptor,\n  convertFieldTypeToInternalTypeScript,\n  convertFieldTypeToInternalZod,\n} from \"../ir/irFieldHelpers.js\";\nimport type { ResolvedIrChain, VersionedIrEntry } from \"./resolveSchemaChain.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/** Collected info about all fields for a model across all versions. */\ninterface AllFieldInfo {\n  fieldType: IFieldTypeUnion;\n  isOptional: boolean;\n  /** Versions where this field exists. */\n  presentInVersions: Set<number>;\n  /** Whether field is always optional. */\n  alwaysOptional: boolean;\n  /** Whether field is optional in at least one version. */\n  everOptional: boolean;\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: VersionedIrEntry[],\n): Map<string, RecordModelInfo> {\n  const allRecordModels = new Map<string, RecordModelInfo>();\n\n  // Initialize models from all versions\n  for (const { version, ir } of chain) {\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type !== \"record\") continue;\n\n      if (!allRecordModels.has(modelKey)) {\n        allRecordModels.set(modelKey, {\n          allFields: new Map(),\n          steps: [],\n        });\n      }\n\n      const model = allRecordModels.get(modelKey)!;\n\n      for (const field of modelDef.record.fields) {\n        const existing = model.allFields.get(field.key);\n        if (existing == null) {\n          model.allFields.set(field.key, {\n            fieldType: field.fieldType,\n            isOptional: field.isOptional === true,\n            presentInVersions: new Set([version]),\n            alwaysOptional: field.isOptional === true,\n            everOptional: field.isOptional === true,\n          });\n        } else {\n          existing.presentInVersions.add(version);\n          if (field.isOptional !== true) {\n            existing.alwaysOptional = false;\n          }\n          if (field.isOptional === true) {\n            existing.everOptional = true;\n          }\n        }\n      }\n    }\n  }\n\n  // Compute upgrade steps from version diffs\n  for (let i = 1; i < chain.length; i++) {\n    const prevEntry = chain[i - 1]!;\n    const currEntry = chain[i]!;\n\n    for (const [modelKey, currModelDef] of Object.entries(currEntry.ir.models)) {\n      if (currModelDef.type !== \"record\") continue;\n\n      const prevModelDef = prevEntry.ir.models[modelKey];\n      if (prevModelDef == null || prevModelDef.type !== \"record\") continue;\n\n      const model = allRecordModels.get(modelKey);\n      if (model == null) continue;\n\n      const prevFields = new Set(prevModelDef.record.fields.map(f => f.key));\n      const currFields = new Set(currModelDef.record.fields.map(f => f.key));\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 = currEntry.migrations?.[modelKey];\n      for (const fieldKey of currFields) {\n        if (!prevFields.has(fieldKey)) {\n          const annotation = recordUpgrades?.[fieldKey];\n          if (annotation != null) {\n            addedFields.set(fieldKey, {\n              derivedFrom: [...annotation.derivedFrom],\n              forwardSource: annotation.forwardSource,\n            });\n          } else {\n            addedFields.set(fieldKey, {\n              derivedFrom: [],\n              forwardSource: \"() => undefined\",\n            });\n          }\n        }\n      }\n\n      // Fields removed in this version\n      const removedFields: string[] = [];\n      for (const fieldKey of prevFields) {\n        if (!currFields.has(fieldKey)) {\n          removedFields.push(fieldKey);\n        }\n      }\n\n      if (addedFields.size > 0 || removedFields.length > 0) {\n        model.steps.push({\n          name: `v${currEntry.version}`,\n          addedInVersion: currEntry.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 [modelKey, model] of sortedEntries(allRecordModels)) {\n    output += `/** Internal representation containing all fields across all schema versions. */\\n`;\n    output += `export interface ${modelKey}__Internal {\\n`;\n\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      const tsType = convertFieldTypeToInternalTypeScript(\n        fieldInfo.fieldType,\n        fieldInfo.isOptional,\n      );\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  latestIr: IRealTimeDocumentSchema,\n): string {\n  let output = GENERATED_FILE_HEADER;\n\n  const hasRecords = allRecordModels.size > 0;\n  const hasUnions = Object.values(latestIr.models).some(m => m.type === \"union\");\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 [modelKey, model] of sortedEntries(allRecordModels)) {\n    output += `export const ${modelKey}Upgrades: UpgradeRegistry<\"${modelKey}\"> = {\\n`;\n    output += `  modelName: \"${modelKey}\",\\n`;\n\n    // allFields\n    output += `  allFields: {\\n`;\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      const typeDescriptor = convertFieldTypeToDescriptor(\n        fieldInfo.fieldType,\n        fieldInfo.isOptional,\n      );\n      output += `    ${fieldName}: { type: ${typeDescriptor} },\\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 [modelKey, modelDef] of Object.entries(latestIr.models)) {\n    if (modelDef.type !== \"union\") continue;\n\n    const union = modelDef.union;\n    output += `export const ${modelKey}Upgrades: UnionUpgradeRegistry<\"${modelKey}\"> = {\\n`;\n    output += `  modelName: \"${modelKey}\",\\n`;\n    output += `  discriminant: \"${union.discriminant}\",\\n`;\n    output += `  variants: {\\n`;\n    for (const [variantKey, variantModelKey] of Object.entries(union.variants)) {\n      output += `    \"${variantKey}\": \"${variantModelKey}\",\\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 [modelKey, model] of sortedEntries(allRecordModels)) {\n    output += `export const ${modelKey}InternalSchema = z.object({\\n`;\n\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      // Use everOptional: a field optional in ANY version must stay optional\n      // in the internal schema because older documents may legitimately omit it.\n      const zodType = convertFieldTypeToInternalZod(\n        fieldInfo.fieldType,\n        fieldInfo.alwaysOptional || fieldInfo.everOptional,\n      );\n      output += `  ${fieldName}: ${zodType},\\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 an already-resolved versioned IR chain.\n */\nexport function generateInternalFromChain(\n  resolved: ResolvedIrChain,\n): InternalTypesOutput {\n  const { chain } = resolved;\n  const latestIr = chain[chain.length - 1]!.ir;\n\n  const allRecordModels = collectRecordModels(chain);\n\n  const internalTypes = generateInternalTypes(allRecordModels);\n  const upgrades = generateUpgrades(allRecordModels, latestIr);\n  const internalSchema = generateInternalSchemaContent(allRecordModels);\n\n  return { internalTypes, upgrades, internalSchema };\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"generateInternalFromSchema.js","names":["GENERATED_FILE_HEADER","convertFieldTypeToDescriptor","convertFieldTypeToInternalTypeScript","convertFieldTypeToInternalZod","chainHasDerivedFields","sortedEntries","map","Array","from","entries","sort","a","b","localeCompare","collectRecordModels","chain","allRecordModels","Map","version","ir","modelKey","modelDef","Object","models","type","has","set","allFields","steps","model","get","field","record","fields","existing","key","fieldType","isOptional","presentInVersions","Set","alwaysOptional","everOptional","add","i","length","prevEntry","currEntry","currModelDef","prevModelDef","prevFields","f","currFields","addedFields","recordUpgrades","migrations","fieldKey","annotation","derivedFrom","removedFields","push","size","addedInVersion","totalVersions","values","fieldInfo","generateInternalTypes","output","fieldName","tsType","optional","generatePerVersionInternalTypes","perModelVersions","list","sortedModels","versions","sortedFields","generateUpgrades","latestIr","hasRecords","hasUnions","some","m","imports","join","typeDescriptor","step","fieldMeta","d","default","undefined","JSON","stringify","union","discriminant","variantKey","variantModelKey","variants","generateInternalSchemaContent","zodType","generateUpgradeFns","perModel","neededTypes","currentIdx","findIndex","c","priorVersion","currentVersion","sorted","pickKeys","generateInternalFromChain","resolved","internalTypes","upgrades","internalSchema","internalUpgradeFns"],"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 {\n  IFieldDef,\n  IFieldTypeUnion,\n  IRealTimeDocumentSchema,\n} from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport {\n  convertFieldTypeToDescriptor,\n  convertFieldTypeToInternalTypeScript,\n  convertFieldTypeToInternalZod,\n} from \"../ir/irFieldHelpers.js\";\nimport {\n  chainHasDerivedFields,\n  type ResolvedIrChain,\n  type VersionedIrEntry,\n} from \"./resolveSchemaChain.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  /** _internal/upgradeFns.ts content */\n  internalUpgradeFns: string;\n}\n\n/** Collected info about all fields for a model across all versions. */\ninterface AllFieldInfo {\n  fieldType: IFieldTypeUnion;\n  isOptional: boolean;\n  /** Versions where this field exists. */\n  presentInVersions: Set<number>;\n  /** Whether field is always optional. */\n  alwaysOptional: boolean;\n  /** Whether field is optional in at least one version. */\n  everOptional: boolean;\n}\n\n/**\n * Represents an upgrade step for a model between version transitions.\n */\ninterface UpgradeStep {\n  addedInVersion: number;\n  fields: Map<string, { derivedFrom: 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: VersionedIrEntry[],\n): Map<string, RecordModelInfo> {\n  const allRecordModels = new Map<string, RecordModelInfo>();\n\n  // Initialize models from all versions\n  for (const { version, ir } of chain) {\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type !== \"record\") continue;\n\n      if (!allRecordModels.has(modelKey)) {\n        allRecordModels.set(modelKey, {\n          allFields: new Map(),\n          steps: [],\n        });\n      }\n\n      const model = allRecordModels.get(modelKey)!;\n\n      for (const field of modelDef.record.fields) {\n        const existing = model.allFields.get(field.key);\n        if (existing == null) {\n          model.allFields.set(field.key, {\n            fieldType: field.fieldType,\n            isOptional: field.isOptional === true,\n            presentInVersions: new Set([version]),\n            alwaysOptional: field.isOptional === true,\n            everOptional: field.isOptional === true,\n          });\n        } else {\n          existing.presentInVersions.add(version);\n          if (field.isOptional !== true) {\n            existing.alwaysOptional = false;\n          }\n          if (field.isOptional === true) {\n            existing.everOptional = true;\n          }\n        }\n      }\n    }\n  }\n\n  // Compute upgrade steps from version diffs\n  for (let i = 1; i < chain.length; i++) {\n    const prevEntry = chain[i - 1]!;\n    const currEntry = chain[i]!;\n\n    for (const [modelKey, currModelDef] of Object.entries(currEntry.ir.models)) {\n      if (currModelDef.type !== \"record\") continue;\n\n      const prevModelDef = prevEntry.ir.models[modelKey];\n      if (prevModelDef == null || prevModelDef.type !== \"record\") continue;\n\n      const model = allRecordModels.get(modelKey);\n      if (model == null) continue;\n\n      const prevFields = new Set(prevModelDef.record.fields.map(f => f.key));\n      const currFields = new Set(currModelDef.record.fields.map(f => f.key));\n\n      // Fields added in this version\n      const addedFields = new Map<\n        string,\n        { derivedFrom: string[]; default?: unknown }\n      >();\n      const recordUpgrades = currEntry.migrations?.[modelKey];\n      for (const fieldKey of currFields) {\n        if (!prevFields.has(fieldKey)) {\n          const annotation = recordUpgrades?.[fieldKey];\n          if (annotation != null) {\n            addedFields.set(fieldKey, {\n              derivedFrom: [...annotation.derivedFrom],\n            });\n          } else {\n            addedFields.set(fieldKey, {\n              derivedFrom: [],\n            });\n          }\n        }\n      }\n\n      // Fields removed in this version\n      const removedFields: string[] = [];\n      for (const fieldKey of prevFields) {\n        if (!currFields.has(fieldKey)) {\n          removedFields.push(fieldKey);\n        }\n      }\n\n      if (addedFields.size > 0 || removedFields.length > 0) {\n        model.steps.push({\n          addedInVersion: currEntry.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 [modelKey, model] of sortedEntries(allRecordModels)) {\n    output += `/** Internal representation containing all fields across all schema versions. */\\n`;\n    output += `export interface ${modelKey}__Internal {\\n`;\n\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      const tsType = convertFieldTypeToInternalTypeScript(\n        fieldInfo.fieldType,\n        fieldInfo.isOptional,\n      );\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 per-version internal interfaces (e.g. `ShapeBox__v1`, `ShapeBox__v2`).\n *\n * Each interface contains only the fields present in that version, with their\n * actual optionality taken straight from that version's IR. The downstream\n * `DocumentUpgradeFns` generator uses these so each upgrade function's\n * parameter can `Pick` the prior version's fields and its return type can\n * index the current version's field type precisely.\n */\nfunction generatePerVersionInternalTypes(\n  chain: VersionedIrEntry[],\n): string {\n  // Group by model so each model's versions appear together in ascending order.\n  const perModelVersions = new Map<\n    string,\n    { version: number; fields: readonly IFieldDef[] }[]\n  >();\n\n  for (const { version, ir } of chain) {\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type !== \"record\") continue;\n      let list = perModelVersions.get(modelKey);\n      if (list == null) {\n        list = [];\n        perModelVersions.set(modelKey, list);\n      }\n      list.push({ version, fields: modelDef.record.fields });\n    }\n  }\n\n  let output = \"\";\n  const sortedModels = Array.from(perModelVersions.entries()).sort(([a], [b]) =>\n    a.localeCompare(b)\n  );\n  for (const [modelKey, versions] of sortedModels) {\n    for (const { version, fields } of versions) {\n      output += `/** Internal representation of ${modelKey} at schema version ${version}. */\\n`;\n      output += `export interface ${modelKey}__v${version} {\\n`;\n      const sortedFields = [...fields].sort((a, b) => a.key.localeCompare(b.key));\n      for (const field of sortedFields) {\n        const tsType = convertFieldTypeToInternalTypeScript(\n          field.fieldType,\n          field.isOptional === true,\n        );\n        const optional = field.isOptional === true ? \"?\" : \"\";\n        output += `  readonly ${field.key}${optional}: ${tsType};\\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  latestIr: IRealTimeDocumentSchema,\n): string {\n  let output = GENERATED_FILE_HEADER;\n\n  const hasRecords = allRecordModels.size > 0;\n  const hasUnions = Object.values(latestIr.models).some(m => m.type === \"union\");\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 [modelKey, model] of sortedEntries(allRecordModels)) {\n    output += `export const ${modelKey}Upgrades: UpgradeRegistry<\"${modelKey}\"> = {\\n`;\n    output += `  modelName: \"${modelKey}\",\\n`;\n\n    // allFields\n    output += `  allFields: {\\n`;\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      const typeDescriptor = convertFieldTypeToDescriptor(\n        fieldInfo.fieldType,\n        fieldInfo.isOptional,\n      );\n      output += `    ${fieldName}: { type: ${typeDescriptor} },\\n`;\n    }\n    output += `  },\\n`;\n\n    // steps\n    output += `  steps: [\\n`;\n    for (const step of model.steps) {\n      output += `    {\\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        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 [modelKey, modelDef] of Object.entries(latestIr.models)) {\n    if (modelDef.type !== \"union\") continue;\n\n    const union = modelDef.union;\n    output += `export const ${modelKey}Upgrades: UnionUpgradeRegistry<\"${modelKey}\"> = {\\n`;\n    output += `  modelName: \"${modelKey}\",\\n`;\n    output += `  discriminant: \"${union.discriminant}\",\\n`;\n    output += `  variants: {\\n`;\n    for (const [variantKey, variantModelKey] of Object.entries(union.variants)) {\n      output += `    \"${variantKey}\": \"${variantModelKey}\",\\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 [modelKey, model] of sortedEntries(allRecordModels)) {\n    output += `export const ${modelKey}InternalSchema = z.object({\\n`;\n\n    for (const [fieldName, fieldInfo] of sortedEntries(model.allFields)) {\n      // Use everOptional: a field optional in ANY version must stay optional\n      // in the internal schema because older documents may legitimately omit it.\n      const zodType = convertFieldTypeToInternalZod(\n        fieldInfo.fieldType,\n        fieldInfo.alwaysOptional || fieldInfo.everOptional,\n      );\n      output += `  ${fieldName}: ${zodType},\\n`;\n    }\n\n    output += `}).passthrough();\\n\\n`;\n  }\n\n  return output;\n}\n\n/**\n * Generate _internal/upgradeFns.ts content: a typed `DocumentUpgradeFns`\n * interface enumerating every upgrade function the app must supply at boot.\n *\n * For every `(modelName, v${version}, fieldName)` triple where `derivedFrom` is\n * non-empty, emit a property typed\n * `(oldFields: Pick<<Model>__v<prior>, derivedFrom[number]>) => <Model>__v<current>[fieldName]`.\n * Additive fields (empty `derivedFrom`) are intentionally absent — they are\n * handled by the structural `default` in `_internal/upgrades.ts`.\n *\n * The interface is consumed by the generated `DocumentModel` factory in\n * `models.ts`, which requires it as a parameter when the schema has any\n * derived fields. Schemas without derived fields emit an empty interface\n * (still exported for type-uniformity in downstream code).\n */\nfunction generateUpgradeFns(\n  chain: VersionedIrEntry[],\n  allRecordModels: Map<string, RecordModelInfo>,\n): string {\n  interface UpgradeFnEntry {\n    fieldName: string;\n    derivedFrom: readonly string[];\n  }\n  interface StepEntry {\n    currentVersion: number;\n    priorVersion: number;\n    fields: UpgradeFnEntry[];\n  }\n\n  const perModel = new Map<string, StepEntry[]>();\n  const neededTypes = new Set<string>();\n\n  for (const [modelKey, model] of sortedEntries(allRecordModels)) {\n    for (const step of model.steps) {\n      const currentIdx = chain.findIndex(c => c.version === step.addedInVersion);\n      if (currentIdx <= 0) continue;\n      const priorVersion = chain[currentIdx - 1]!.version;\n\n      const fields: UpgradeFnEntry[] = [];\n      for (const [fieldName, fieldMeta] of step.fields) {\n        if (fieldMeta.derivedFrom.length === 0) continue;\n        fields.push({ fieldName, derivedFrom: [...fieldMeta.derivedFrom] });\n      }\n      if (fields.length === 0) continue;\n\n      let list = perModel.get(modelKey);\n      if (list == null) {\n        list = [];\n        perModel.set(modelKey, list);\n      }\n      list.push({\n        currentVersion: step.addedInVersion,\n        priorVersion,\n        fields,\n      });\n      neededTypes.add(`${modelKey}__v${priorVersion}`);\n      neededTypes.add(`${modelKey}__v${step.addedInVersion}`);\n    }\n  }\n\n  let output = GENERATED_FILE_HEADER;\n  output += `\\n`;\n\n  if (neededTypes.size > 0) {\n    const sorted = Array.from(neededTypes).sort();\n    output += `import type { ${sorted.join(\", \")} } from \"./types.js\";\\n\\n`;\n  }\n\n  output += `/**\\n`;\n  output += ` * Typed upgrade functions the application must supply at boot. Coverage is\\n`;\n  output +=\n    ` * exhaustive: missing or extra entries fail type-check at the \\`DocumentModel(...)\\`\\n`;\n  output += ` * call site. Additive fields (empty \\`derivedFrom\\`) are intentionally absent.\\n`;\n  output += ` */\\n`;\n  if (perModel.size === 0) {\n    output += `// eslint-disable-next-line @typescript-eslint/no-empty-object-type\\n`;\n    output += `export interface DocumentUpgradeFns {}\\n`;\n  } else {\n    output += `export interface DocumentUpgradeFns {\\n`;\n    for (\n      const [modelKey, steps] of Array.from(perModel.entries()).sort(([a], [b]) =>\n        a.localeCompare(b)\n      )\n    ) {\n      output += `  ${modelKey}: {\\n`;\n      for (const step of steps) {\n        output += `    v${step.currentVersion}: {\\n`;\n        for (const f of step.fields) {\n          const pickKeys = f.derivedFrom.map(d => `\"${d}\"`).join(\" | \");\n          output +=\n            `      ${f.fieldName}: (oldFields: Pick<${modelKey}__v${step.priorVersion}, ${pickKeys}>) => ${modelKey}__v${step.currentVersion}[\"${f.fieldName}\"];\\n`;\n        }\n        output += `    };\\n`;\n      }\n      output += `  };\\n`;\n    }\n    output += `}\\n`;\n  }\n\n  return output;\n}\n\n/**\n * Generate _internal/types.ts, _internal/upgrades.ts, _internal/schema.ts and\n * _internal/upgradeFns.ts from an already-resolved versioned IR chain.\n */\nexport function generateInternalFromChain(\n  resolved: ResolvedIrChain,\n): InternalTypesOutput {\n  const { chain } = resolved;\n  const latestIr = chain[chain.length - 1]!.ir;\n\n  const allRecordModels = collectRecordModels(chain);\n\n  const internalTypes = generateInternalTypes(allRecordModels)\n    + (chainHasDerivedFields(chain) ? generatePerVersionInternalTypes(chain) : \"\");\n  const upgrades = generateUpgrades(allRecordModels, latestIr);\n  const internalSchema = generateInternalSchemaContent(allRecordModels);\n  const internalUpgradeFns = generateUpgradeFns(chain, allRecordModels);\n\n  return { internalTypes, upgrades, internalSchema, internalUpgradeFns };\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -17,8 +17,8 @@
 import { formatVariantName } from "../formatVariantName.js";
 import { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
 import { findExternalRefType } from "../ir/irFieldHelpers.js";
-import { resolveMinVersion } from "./resolveSchemaChain.js";
-import { INTERNAL_UPGRADES_PATH, modelName, SCHEMA_REEXPORT_PATH, schemaName, TYPES_REEXPORT_PATH } from "./runtimeSchema.js";
+import { chainHasDerivedFields, resolveMinVersion } from "./resolveSchemaChain.js";
+import { INTERNAL_UPGRADE_FNS_PATH, INTERNAL_UPGRADES_PATH, modelName, SCHEMA_REEXPORT_PATH, schemaName, TYPES_REEXPORT_PATH } from "./runtimeSchema.js";
 function extractExternalRefFieldTypes(record) {
   const refs = [];
   for (const field of record.fields) {
@@ -42,6 +42,7 @@ export function generateModelMetadataFromChain(resolved, minSupportedVersion) {
     minVersion
   } = resolveMinVersion(chain, minSupportedVersion);
   const latestIr = chain[chain.length - 1].ir;
+  const hasDerivedFields = chainHasDerivedFields(chain);
 
   // --- Generate models.ts ---
   let output = GENERATED_FILE_HEADER;
@@ -66,6 +67,7 @@ export function generateModelMetadataFromChain(resolved, minSupportedVersion) {
   const modelTypesImports = ["DocumentSchema"];
   if (recordNames.length > 0) modelTypesImports.push("RecordModel");
   if (unionNames.length > 0) modelTypesImports.push("UnionModel");
+  if (hasDerivedFields) modelTypesImports.push("UpgradeFns");
   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) {
@@ -83,6 +85,11 @@ export function generateModelMetadataFromChain(resolved, minSupportedVersion) {
   if (chain.length > 1 && upgradeNames.length > 0) {
     output += `import { ${upgradeNames.join(", ")} } from "${INTERNAL_UPGRADES_PATH}";\n`;
   }
+
+  // DocumentUpgradeFns type is needed by the factory's parameter signature.
+  if (hasDerivedFields) {
+    output += `import type { DocumentUpgradeFns } from "${INTERNAL_UPGRADE_FNS_PATH}";\n`;
+  }
   output += "\n";
 
   // Generate model constants
@@ -149,22 +156,47 @@ export function generateModelMetadataFromChain(resolved, minSupportedVersion) {
   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`;
+    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`;
+
+  // Common metadata literal: shared between the const and factory forms.
+  let metadataBody = `    [Metadata]: {\n`;
+  metadataBody += `      version: ${latestVersion},\n`;
   if (minVersion !== latestVersion) {
-    output += `    minSupportedVersion: ${minVersion},\n`;
+    metadataBody += `      minSupportedVersion: ${minVersion},\n`;
+  }
+  metadataBody += upgradesBlock;
+  const modelEntriesBody = modelEntries.map(e => `  ${e}`).join(",\n");
+  if (hasDerivedFields) {
+    // Factory form: schema has derived fields, so the runtime requires the app
+    // to supply typed upgrade functions. The factory makes this a compile-time
+    // requirement — apps can't get a DocumentSchema value without passing them.
+    output += `/**\n`;
+    output += ` * Construct the DocumentModel for this SDK, wiring in the typed forward\n`;
+    output += ` * functions the runtime needs to materialize derived fields.\n`;
+    output += ` */\n`;
+    output += `export function DocumentModel(upgradeFns: DocumentUpgradeFns): DocumentSchema {\n`;
+    output += `  return {\n`;
+    output += `${modelEntriesBody},\n`;
+    output += metadataBody;
+    output += `      upgradeFns: upgradeFns as unknown as UpgradeFns,\n`;
+    output += `    },\n`;
+    output += `  };\n`;
+    output += `}\n\n`;
+    output += `export type DocumentModel = ReturnType<typeof DocumentModel>;\n`;
+  } else {
+    // Const form: no derived fields means no upgrade functions are required.
+    output += `export const DocumentModel = {\n`;
+    output += `${modelEntriesBody},\n`;
+    // Const form indents one level less than the factory body.
+    output += metadataBody.replace(/^ {4}/gm, "  ");
+    output += `  },\n`;
+    output += `} as const satisfies DocumentSchema;\n\n`;
+    output += `export type DocumentModel = typeof DocumentModel;\n`;
   }
-  output += upgradesBlock;
-  output += `  },\n`;
-  output += `} as const satisfies DocumentSchema;\n\n`;
-  output += `export type DocumentModel = typeof DocumentModel;\n`;
   return {
     modelsFile: output
   };

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

@@ -1 +1 @@
-{"version":3,"file":"generateModelMetadataFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","findExternalRefType","resolveMinVersion","INTERNAL_UPGRADES_PATH","modelName","SCHEMA_REEXPORT_PATH","schemaName","TYPES_REEXPORT_PATH","extractExternalRefFieldTypes","record","refs","field","fields","refType","fieldType","push","key","generateModelMetadataFromChain","resolved","minSupportedVersion","chain","latestVersion","minVersion","latestIr","length","ir","output","recordNames","unionNames","variantNames","modelKey","modelDef","Object","entries","models","type","variantName","keys","union","variants","allModelNames","sort","modelTypesImports","join","schemaNames","map","n","upgradeNames","externalRefs","metadataFields","discriminant","formattedVariant","variantTypeName","variantMetadata","modelEntries","upgradesBlock","allUpgradeNames","upgradeEntries","modelsFile"],"sources":["generateModelMetadataFromSchema.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 { IRecordDef } from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport { findExternalRefType } from \"../ir/irFieldHelpers.js\";\nimport type { ResolvedIrChain } from \"./resolveSchemaChain.js\";\nimport { resolveMinVersion } from \"./resolveSchemaChain.js\";\nimport {\n  INTERNAL_UPGRADES_PATH,\n  modelName,\n  SCHEMA_REEXPORT_PATH,\n  schemaName,\n  TYPES_REEXPORT_PATH,\n} from \"./runtimeSchema.js\";\n\nexport interface ModelMetadataOutput {\n  /** models.ts content -- DocumentModel with version metadata and upgrade references */\n  modelsFile: string;\n}\n\nfunction extractExternalRefFieldTypes(\n  record: IRecordDef,\n): Array<[string, string]> {\n  const refs: Array<[string, string]> = [];\n  for (const field of record.fields) {\n    const refType = findExternalRefType(field.fieldType);\n    if (refType != null) {\n      refs.push([field.key, refType]);\n    }\n  }\n  return refs;\n}\n\n/**\n * Generate models.ts from an already-resolved versioned IR chain.\n */\nexport function generateModelMetadataFromChain(\n  resolved: ResolvedIrChain,\n  minSupportedVersion?: number,\n): ModelMetadataOutput {\n  const { chain } = resolved;\n  const { latestVersion, minVersion } = resolveMinVersion(chain, minSupportedVersion);\n  const latestIr = chain[chain.length - 1]!.ir;\n\n  // --- Generate models.ts ---\n  let output = GENERATED_FILE_HEADER;\n\n  // Collect model names for imports\n  const recordNames: string[] = [];\n  const unionNames: string[] = [];\n  const variantNames: string[] = [];\n\n  for (const [modelKey, modelDef] of Object.entries(latestIr.models)) {\n    if (modelDef.type === \"record\") {\n      recordNames.push(modelKey);\n    } else if (modelDef.type === \"union\") {\n      unionNames.push(modelKey);\n      for (const variantName of Object.keys(modelDef.union.variants)) {\n        variantNames.push(`${modelKey}${formatVariantName(variantName)}`);\n      }\n    }\n  }\n\n  const allModelNames = [...recordNames, ...unionNames, ...variantNames].sort();\n\n  // Imports\n  const modelTypesImports: string[] = [\"DocumentSchema\"];\n  if (recordNames.length > 0) modelTypesImports.push(\"RecordModel\");\n  if (unionNames.length > 0) modelTypesImports.push(\"UnionModel\");\n\n  output += `import type { ${\n    modelTypesImports.sort().join(\", \")\n  } } from \"@palantir/pack.document-schema.model-types\";\\n`;\n  output += `import { Metadata } from \"@palantir/pack.document-schema.model-types\";\\n`;\n\n  if (allModelNames.length > 0) {\n    output += `import type { ${allModelNames.join(\", \")} } from \"${TYPES_REEXPORT_PATH}\";\\n`;\n  }\n\n  // Schema imports\n  const schemaNames = allModelNames.map(n => schemaName(n));\n  if (schemaNames.length > 0) {\n    output += `import { ${schemaNames.join(\", \")} } from \"${SCHEMA_REEXPORT_PATH}\";\\n`;\n  }\n\n  // Upgrade imports (only if there are upgrades)\n  const upgradeNames = [...recordNames, ...unionNames].map(n => `${n}Upgrades`);\n  if (chain.length > 1 && upgradeNames.length > 0) {\n    output += `import { ${upgradeNames.join(\", \")} } from \"${INTERNAL_UPGRADES_PATH}\";\\n`;\n  }\n\n  output += \"\\n\";\n\n  // Generate model constants\n  for (const [modelKey, modelDef] of Object.entries(latestIr.models)) {\n    if (modelDef.type === \"record\") {\n      const externalRefs = extractExternalRefFieldTypes(modelDef.record);\n      const metadataFields: string[] = [];\n\n      if (externalRefs.length > 0) {\n        const entries = externalRefs.map(([field, type]) => `      ${field}: \"${type}\",`).join(\n          \"\\n\",\n        );\n        metadataFields.push(`    externalRefFieldTypes: {\\n${entries}\\n    },`);\n      }\n      metadataFields.push(`    name: \"${modelKey}\",`);\n\n      output += `export interface ${modelName(modelKey)} extends RecordModel<${modelKey}, typeof ${\n        schemaName(modelKey)\n      }> {}\\n`;\n      output += `export const ${modelName(modelKey)}: ${modelName(modelKey)} = {\\n`;\n      output += `  __type: {} as ${modelKey},\\n`;\n      output += `  zodSchema: ${schemaName(modelKey)},\\n`;\n      output += `  [Metadata]: {\\n${metadataFields.join(\"\\n\")}\\n  },\\n`;\n      output += `};\\n\\n`;\n    } else if (modelDef.type === \"union\") {\n      const union = modelDef.union;\n      const metadataFields: string[] = [];\n      metadataFields.push(`    discriminant: \"${union.discriminant}\",`);\n      metadataFields.push(`    name: \"${modelKey}\",`);\n\n      output += `export interface ${modelName(modelKey)} extends UnionModel<${modelKey}, typeof ${\n        schemaName(modelKey)\n      }> {}\\n`;\n      output += `export const ${modelName(modelKey)}: ${modelName(modelKey)} = {\\n`;\n      output += `  __type: {} as ${modelKey},\\n`;\n      output += `  zodSchema: ${schemaName(modelKey)},\\n`;\n      output += `  [Metadata]: {\\n${metadataFields.join(\"\\n\")}\\n  },\\n`;\n      output += `};\\n\\n`;\n\n      // Generate variant models\n      for (const variantName of Object.keys(union.variants)) {\n        const formattedVariant = formatVariantName(variantName);\n        const variantTypeName = `${modelKey}${formattedVariant}`;\n        const variantMetadata: string[] = [];\n        variantMetadata.push(`    discriminant: \"${union.discriminant}\",`);\n        variantMetadata.push(`    name: \"${variantTypeName}\",`);\n\n        output += `export interface ${\n          modelName(variantTypeName)\n        } extends UnionModel<${variantTypeName}, typeof ${schemaName(variantTypeName)}> {}\\n`;\n        output += `export const ${modelName(variantTypeName)}: ${modelName(variantTypeName)} = {\\n`;\n        output += `  __type: {} as ${variantTypeName},\\n`;\n        output += `  zodSchema: ${schemaName(variantTypeName)},\\n`;\n        output += `  [Metadata]: {\\n${variantMetadata.join(\"\\n\")}\\n  },\\n`;\n        output += `};\\n\\n`;\n      }\n    }\n  }\n\n  // Generate DocumentModel\n  const modelEntries: string[] = [];\n  for (const [modelKey, modelDef] of Object.entries(latestIr.models)) {\n    if (modelDef.type === \"record\") {\n      modelEntries.push(`  ${modelKey}: ${modelName(modelKey)}`);\n    } else if (modelDef.type === \"union\") {\n      modelEntries.push(`  ${modelKey}: ${modelName(modelKey)}`);\n      for (const variantName of Object.keys(modelDef.union.variants)) {\n        const formattedVariant = formatVariantName(variantName);\n        const variantTypeName = `${modelKey}${formattedVariant}`;\n        modelEntries.push(`  ${variantTypeName}: ${modelName(variantTypeName)}`);\n      }\n    }\n  }\n\n  // Build upgrades map (includes both record and union entries)\n  let upgradesBlock: string;\n  const allUpgradeNames = [...recordNames, ...unionNames];\n  if (chain.length > 1 && allUpgradeNames.length > 0) {\n    const upgradeEntries = allUpgradeNames.map(n => `      ${n}: ${n}Upgrades,`).join(\"\\n\");\n    upgradesBlock = `    upgrades: {\\n${upgradeEntries}\\n    },\\n`;\n  } else {\n    upgradesBlock = \"\";\n  }\n\n  output += `export const DocumentModel = {\\n`;\n  output += `${modelEntries.join(\",\\n\")},\\n`;\n  output += `  [Metadata]: {\\n`;\n  output += `    version: ${latestVersion},\\n`;\n  if (minVersion !== latestVersion) {\n    output += `    minSupportedVersion: ${minVersion},\\n`;\n  }\n  output += upgradesBlock;\n  output += `  },\\n`;\n  output += `} as const satisfies DocumentSchema;\\n\\n`;\n  output += `export type DocumentModel = typeof DocumentModel;\\n`;\n\n  return { modelsFile: output };\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"generateModelMetadataFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","findExternalRefType","chainHasDerivedFields","resolveMinVersion","INTERNAL_UPGRADE_FNS_PATH","INTERNAL_UPGRADES_PATH","modelName","SCHEMA_REEXPORT_PATH","schemaName","TYPES_REEXPORT_PATH","extractExternalRefFieldTypes","record","refs","field","fields","refType","fieldType","push","key","generateModelMetadataFromChain","resolved","minSupportedVersion","chain","latestVersion","minVersion","latestIr","length","ir","hasDerivedFields","output","recordNames","unionNames","variantNames","modelKey","modelDef","Object","entries","models","type","variantName","keys","union","variants","allModelNames","sort","modelTypesImports","join","schemaNames","map","n","upgradeNames","externalRefs","metadataFields","discriminant","formattedVariant","variantTypeName","variantMetadata","modelEntries","upgradesBlock","allUpgradeNames","upgradeEntries","metadataBody","modelEntriesBody","e","replace","modelsFile"],"sources":["generateModelMetadataFromSchema.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 { IRecordDef } from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport { findExternalRefType } from \"../ir/irFieldHelpers.js\";\nimport type { ResolvedIrChain } from \"./resolveSchemaChain.js\";\nimport { chainHasDerivedFields, resolveMinVersion } from \"./resolveSchemaChain.js\";\nimport {\n  INTERNAL_UPGRADE_FNS_PATH,\n  INTERNAL_UPGRADES_PATH,\n  modelName,\n  SCHEMA_REEXPORT_PATH,\n  schemaName,\n  TYPES_REEXPORT_PATH,\n} from \"./runtimeSchema.js\";\n\nexport interface ModelMetadataOutput {\n  /** models.ts content -- DocumentModel with version metadata and upgrade references */\n  modelsFile: string;\n}\n\nfunction extractExternalRefFieldTypes(\n  record: IRecordDef,\n): Array<[string, string]> {\n  const refs: Array<[string, string]> = [];\n  for (const field of record.fields) {\n    const refType = findExternalRefType(field.fieldType);\n    if (refType != null) {\n      refs.push([field.key, refType]);\n    }\n  }\n  return refs;\n}\n\n/**\n * Generate models.ts from an already-resolved versioned IR chain.\n */\nexport function generateModelMetadataFromChain(\n  resolved: ResolvedIrChain,\n  minSupportedVersion?: number,\n): ModelMetadataOutput {\n  const { chain } = resolved;\n  const { latestVersion, minVersion } = resolveMinVersion(chain, minSupportedVersion);\n  const latestIr = chain[chain.length - 1]!.ir;\n  const hasDerivedFields = chainHasDerivedFields(chain);\n\n  // --- Generate models.ts ---\n  let output = GENERATED_FILE_HEADER;\n\n  // Collect model names for imports\n  const recordNames: string[] = [];\n  const unionNames: string[] = [];\n  const variantNames: string[] = [];\n\n  for (const [modelKey, modelDef] of Object.entries(latestIr.models)) {\n    if (modelDef.type === \"record\") {\n      recordNames.push(modelKey);\n    } else if (modelDef.type === \"union\") {\n      unionNames.push(modelKey);\n      for (const variantName of Object.keys(modelDef.union.variants)) {\n        variantNames.push(`${modelKey}${formatVariantName(variantName)}`);\n      }\n    }\n  }\n\n  const allModelNames = [...recordNames, ...unionNames, ...variantNames].sort();\n\n  // Imports\n  const modelTypesImports: string[] = [\"DocumentSchema\"];\n  if (recordNames.length > 0) modelTypesImports.push(\"RecordModel\");\n  if (unionNames.length > 0) modelTypesImports.push(\"UnionModel\");\n  if (hasDerivedFields) modelTypesImports.push(\"UpgradeFns\");\n\n  output += `import type { ${\n    modelTypesImports.sort().join(\", \")\n  } } from \"@palantir/pack.document-schema.model-types\";\\n`;\n  output += `import { Metadata } from \"@palantir/pack.document-schema.model-types\";\\n`;\n\n  if (allModelNames.length > 0) {\n    output += `import type { ${allModelNames.join(\", \")} } from \"${TYPES_REEXPORT_PATH}\";\\n`;\n  }\n\n  // Schema imports\n  const schemaNames = allModelNames.map(n => schemaName(n));\n  if (schemaNames.length > 0) {\n    output += `import { ${schemaNames.join(\", \")} } from \"${SCHEMA_REEXPORT_PATH}\";\\n`;\n  }\n\n  // Upgrade imports (only if there are upgrades)\n  const upgradeNames = [...recordNames, ...unionNames].map(n => `${n}Upgrades`);\n  if (chain.length > 1 && upgradeNames.length > 0) {\n    output += `import { ${upgradeNames.join(\", \")} } from \"${INTERNAL_UPGRADES_PATH}\";\\n`;\n  }\n\n  // DocumentUpgradeFns type is needed by the factory's parameter signature.\n  if (hasDerivedFields) {\n    output += `import type { DocumentUpgradeFns } from \"${INTERNAL_UPGRADE_FNS_PATH}\";\\n`;\n  }\n\n  output += \"\\n\";\n\n  // Generate model constants\n  for (const [modelKey, modelDef] of Object.entries(latestIr.models)) {\n    if (modelDef.type === \"record\") {\n      const externalRefs = extractExternalRefFieldTypes(modelDef.record);\n      const metadataFields: string[] = [];\n\n      if (externalRefs.length > 0) {\n        const entries = externalRefs.map(([field, type]) => `      ${field}: \"${type}\",`).join(\n          \"\\n\",\n        );\n        metadataFields.push(`    externalRefFieldTypes: {\\n${entries}\\n    },`);\n      }\n      metadataFields.push(`    name: \"${modelKey}\",`);\n\n      output += `export interface ${modelName(modelKey)} extends RecordModel<${modelKey}, typeof ${\n        schemaName(modelKey)\n      }> {}\\n`;\n      output += `export const ${modelName(modelKey)}: ${modelName(modelKey)} = {\\n`;\n      output += `  __type: {} as ${modelKey},\\n`;\n      output += `  zodSchema: ${schemaName(modelKey)},\\n`;\n      output += `  [Metadata]: {\\n${metadataFields.join(\"\\n\")}\\n  },\\n`;\n      output += `};\\n\\n`;\n    } else if (modelDef.type === \"union\") {\n      const union = modelDef.union;\n      const metadataFields: string[] = [];\n      metadataFields.push(`    discriminant: \"${union.discriminant}\",`);\n      metadataFields.push(`    name: \"${modelKey}\",`);\n\n      output += `export interface ${modelName(modelKey)} extends UnionModel<${modelKey}, typeof ${\n        schemaName(modelKey)\n      }> {}\\n`;\n      output += `export const ${modelName(modelKey)}: ${modelName(modelKey)} = {\\n`;\n      output += `  __type: {} as ${modelKey},\\n`;\n      output += `  zodSchema: ${schemaName(modelKey)},\\n`;\n      output += `  [Metadata]: {\\n${metadataFields.join(\"\\n\")}\\n  },\\n`;\n      output += `};\\n\\n`;\n\n      // Generate variant models\n      for (const variantName of Object.keys(union.variants)) {\n        const formattedVariant = formatVariantName(variantName);\n        const variantTypeName = `${modelKey}${formattedVariant}`;\n        const variantMetadata: string[] = [];\n        variantMetadata.push(`    discriminant: \"${union.discriminant}\",`);\n        variantMetadata.push(`    name: \"${variantTypeName}\",`);\n\n        output += `export interface ${\n          modelName(variantTypeName)\n        } extends UnionModel<${variantTypeName}, typeof ${schemaName(variantTypeName)}> {}\\n`;\n        output += `export const ${modelName(variantTypeName)}: ${modelName(variantTypeName)} = {\\n`;\n        output += `  __type: {} as ${variantTypeName},\\n`;\n        output += `  zodSchema: ${schemaName(variantTypeName)},\\n`;\n        output += `  [Metadata]: {\\n${variantMetadata.join(\"\\n\")}\\n  },\\n`;\n        output += `};\\n\\n`;\n      }\n    }\n  }\n\n  // Generate DocumentModel\n  const modelEntries: string[] = [];\n  for (const [modelKey, modelDef] of Object.entries(latestIr.models)) {\n    if (modelDef.type === \"record\") {\n      modelEntries.push(`  ${modelKey}: ${modelName(modelKey)}`);\n    } else if (modelDef.type === \"union\") {\n      modelEntries.push(`  ${modelKey}: ${modelName(modelKey)}`);\n      for (const variantName of Object.keys(modelDef.union.variants)) {\n        const formattedVariant = formatVariantName(variantName);\n        const variantTypeName = `${modelKey}${formattedVariant}`;\n        modelEntries.push(`  ${variantTypeName}: ${modelName(variantTypeName)}`);\n      }\n    }\n  }\n\n  // Build upgrades map (includes both record and union entries)\n  let upgradesBlock: string;\n  const allUpgradeNames = [...recordNames, ...unionNames];\n  if (chain.length > 1 && allUpgradeNames.length > 0) {\n    const upgradeEntries = allUpgradeNames.map(n => `        ${n}: ${n}Upgrades,`).join(\"\\n\");\n    upgradesBlock = `      upgrades: {\\n${upgradeEntries}\\n      },\\n`;\n  } else {\n    upgradesBlock = \"\";\n  }\n\n  // Common metadata literal: shared between the const and factory forms.\n  let metadataBody = `    [Metadata]: {\\n`;\n  metadataBody += `      version: ${latestVersion},\\n`;\n  if (minVersion !== latestVersion) {\n    metadataBody += `      minSupportedVersion: ${minVersion},\\n`;\n  }\n  metadataBody += upgradesBlock;\n\n  const modelEntriesBody = modelEntries.map(e => `  ${e}`).join(\",\\n\");\n\n  if (hasDerivedFields) {\n    // Factory form: schema has derived fields, so the runtime requires the app\n    // to supply typed upgrade functions. The factory makes this a compile-time\n    // requirement — apps can't get a DocumentSchema value without passing them.\n    output += `/**\\n`;\n    output += ` * Construct the DocumentModel for this SDK, wiring in the typed forward\\n`;\n    output += ` * functions the runtime needs to materialize derived fields.\\n`;\n    output += ` */\\n`;\n    output += `export function DocumentModel(upgradeFns: DocumentUpgradeFns): DocumentSchema {\\n`;\n    output += `  return {\\n`;\n    output += `${modelEntriesBody},\\n`;\n    output += metadataBody;\n    output += `      upgradeFns: upgradeFns as unknown as UpgradeFns,\\n`;\n    output += `    },\\n`;\n    output += `  };\\n`;\n    output += `}\\n\\n`;\n    output += `export type DocumentModel = ReturnType<typeof DocumentModel>;\\n`;\n  } else {\n    // Const form: no derived fields means no upgrade functions are required.\n    output += `export const DocumentModel = {\\n`;\n    output += `${modelEntriesBody},\\n`;\n    // Const form indents one level less than the factory body.\n    output += metadataBody.replace(/^ {4}/gm, \"  \");\n    output += `  },\\n`;\n    output += `} as const satisfies DocumentSchema;\\n\\n`;\n    output += `export type DocumentModel = typeof DocumentModel;\\n`;\n  }\n\n  return { modelsFile: output };\n}\n"],"mappings":"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","ignoreList":[]}