@palantir/pack.document-schema.type-gen 0.12.0 → 0.13.0

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

@@ -0,0 +1,122 @@
+/*
+ * 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 * as P from "@palantir/pack.schema";
+import { defineRecord, defineSchema, defineSchemaUpdate, nextSchema } from "@palantir/pack.schema";
+import { describe, expect, it } from "vitest";
+import { resolveSchemaChain, stripDeprecatedFieldsForSdk } from "../resolveSchemaChain.js";
+
+/** Index a record model's fields by key for a given chain entry. */
+function fieldsByKey(entry, modelKey) {
+  const model = entry.ir.models[modelKey];
+  if (model.type !== "record") throw new Error(`${modelKey} is not a record`);
+  return Object.fromEntries(model.record.fields.map(f => [f.key, f]));
+}
+describe("resolveSchemaChain provenance", () => {
+  const v1 = defineSchema({
+    ShapeBox: defineRecord("ShapeBox", {
+      docs: "A box",
+      fields: {
+        left: P.Double,
+        color: P.Optional(P.String)
+      }
+    })
+  });
+  const colorSplit = defineSchemaUpdate("colorSplit", schema => ({
+    ShapeBox: schema.ShapeBox.addField("fillColor", P.Optional(P.String), {
+      derivedFrom: ["color"]
+    }).addField("strokeColor", P.Optional(P.String), {
+      derivedFrom: ["color"]
+    }).deprecateField("color", "use fillColor/strokeColor").build()
+  }));
+  const v2 = nextSchema(v1).addSchemaUpdate(colorSplit).build();
+  it("derives addedInVersion from first appearance in the chain", () => {
+    const {
+      chain
+    } = resolveSchemaChain(v2);
+    const v2Fields = fieldsByKey(chain.find(c => c.version === 2), "ShapeBox");
+    expect(v2Fields.left.metadata.addedInVersion).toBe(1);
+    expect(v2Fields.fillColor.metadata.addedInVersion).toBe(2);
+    expect(v2Fields.strokeColor.metadata.addedInVersion).toBe(2);
+  });
+  it("keeps a deprecated field present and stamps deprecatedFromVersion + message", () => {
+    const {
+      chain
+    } = resolveSchemaChain(v2);
+    const v2Fields = fieldsByKey(chain.find(c => c.version === 2), "ShapeBox");
+    expect(v2Fields.color).toBeDefined();
+    expect(v2Fields.color.metadata.addedInVersion).toBe(1);
+    expect(v2Fields.color.metadata.deprecatedFromVersion).toBe(2);
+    expect(v2Fields.color.metadata.deprecatedMessage).toBe("use fillColor/strokeColor");
+  });
+  it("does not mark the field deprecated in versions before the deprecation", () => {
+    const {
+      chain
+    } = resolveSchemaChain(v2);
+    const v1Fields = fieldsByKey(chain.find(c => c.version === 1), "ShapeBox");
+    expect(v1Fields.color).toBeDefined();
+    expect(v1Fields.color.metadata.deprecatedFromVersion ?? undefined).toBeUndefined();
+    expect(v1Fields.fillColor).toBeUndefined();
+  });
+  it("stripDeprecatedFieldsForSdk drops deprecated fields from v>=deprecation only", () => {
+    const {
+      chain
+    } = resolveSchemaChain(v2);
+    const stripped = stripDeprecatedFieldsForSdk(chain);
+    const v1Fields = fieldsByKey(stripped.find(c => c.version === 1), "ShapeBox");
+    expect(v1Fields.color).toBeDefined();
+    const v2Fields = fieldsByKey(stripped.find(c => c.version === 2), "ShapeBox");
+    expect(v2Fields.color).toBeUndefined();
+    expect(v2Fields.fillColor).toBeDefined();
+    expect(fieldsByKey(chain.find(c => c.version === 2), "ShapeBox").color).toBeDefined();
+  });
+});
+describe("resolveSchemaChain — union provenance", () => {
+  const v1 = defineSchema({
+    Box: defineRecord("Box", {
+      docs: "",
+      fields: {
+        a: P.Double
+      }
+    }),
+    NodeShape: P.defineUnion("NodeShape", {
+      docs: "shape",
+      variants: {
+        box: defineRecord("Inner", {
+          docs: "",
+          fields: {
+            z: P.Double
+          }
+        })
+      }
+    })
+  });
+  const addB = defineSchemaUpdate("addB", schema => ({
+    Box: schema.Box.addField("b", P.Optional(P.String)).build()
+  }));
+  const v2 = nextSchema(v1).addSchemaUpdate(addB).build();
+  it("a v1-defined union stays addedInVersion 1 in every version", () => {
+    const {
+      chain
+    } = resolveSchemaChain(v2);
+    for (const version of [1, 2]) {
+      const union = chain.find(c => c.version === version).ir.models.NodeShape;
+      if (union.type !== "union") throw new Error("NodeShape should be a union");
+      expect(union.union.metadata.addedInVersion).toBe(1);
+    }
+  });
+});
+//# sourceMappingURL=resolveSchemaChain.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSchemaChain.test.js","names":["P","defineRecord","defineSchema","defineSchemaUpdate","nextSchema","describe","expect","it","resolveSchemaChain","stripDeprecatedFieldsForSdk","fieldsByKey","entry","modelKey","model","ir","models","type","Error","Object","fromEntries","record","fields","map","f","key","v1","ShapeBox","docs","left","Double","color","Optional","String","colorSplit","schema","addField","derivedFrom","deprecateField","build","v2","addSchemaUpdate","chain","v2Fields","find","c","version","metadata","addedInVersion","toBe","fillColor","strokeColor","toBeDefined","deprecatedFromVersion","deprecatedMessage","v1Fields","undefined","toBeUndefined","stripped","Box","a","NodeShape","defineUnion","variants","box","z","addB","union"],"sources":["resolveSchemaChain.test.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as P from \"@palantir/pack.schema\";\nimport { defineRecord, defineSchema, defineSchemaUpdate, nextSchema } from \"@palantir/pack.schema\";\nimport { describe, expect, it } from \"vitest\";\nimport type {\n  IFieldDef,\n  IModelDef,\n} from \"../../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport {\n  resolveSchemaChain,\n  stripDeprecatedFieldsForSdk,\n  type VersionedIrEntry,\n} from \"../resolveSchemaChain.js\";\n\n/** Index a record model's fields by key for a given chain entry. */\nfunction fieldsByKey(entry: VersionedIrEntry, modelKey: string): Record<string, IFieldDef> {\n  const model: IModelDef = entry.ir.models[modelKey]!;\n  if (model.type !== \"record\") throw new Error(`${modelKey} is not a record`);\n  return Object.fromEntries(model.record.fields.map(f => [f.key, f]));\n}\n\ndescribe(\"resolveSchemaChain provenance\", () => {\n  const v1 = defineSchema({\n    ShapeBox: defineRecord(\"ShapeBox\", {\n      docs: \"A box\",\n      fields: { left: P.Double, color: P.Optional(P.String) },\n    }),\n  });\n\n  const colorSplit = defineSchemaUpdate(\n    \"colorSplit\",\n    (schema: P.SchemaBuilder<typeof v1.models>) => ({\n      ShapeBox: schema.ShapeBox\n        .addField(\"fillColor\", P.Optional(P.String), { derivedFrom: [\"color\"] })\n        .addField(\"strokeColor\", P.Optional(P.String), { derivedFrom: [\"color\"] })\n        .deprecateField(\"color\", \"use fillColor/strokeColor\")\n        .build(),\n    }),\n  );\n\n  const v2 = nextSchema(v1).addSchemaUpdate(colorSplit).build();\n\n  it(\"derives addedInVersion from first appearance in the chain\", () => {\n    const { chain } = resolveSchemaChain(v2);\n    const v2Fields = fieldsByKey(chain.find(c => c.version === 2)!, \"ShapeBox\");\n\n    expect(v2Fields.left!.metadata.addedInVersion).toBe(1);\n    expect(v2Fields.fillColor!.metadata.addedInVersion).toBe(2);\n    expect(v2Fields.strokeColor!.metadata.addedInVersion).toBe(2);\n  });\n\n  it(\"keeps a deprecated field present and stamps deprecatedFromVersion + message\", () => {\n    const { chain } = resolveSchemaChain(v2);\n    const v2Fields = fieldsByKey(chain.find(c => c.version === 2)!, \"ShapeBox\");\n\n    expect(v2Fields.color).toBeDefined();\n    expect(v2Fields.color!.metadata.addedInVersion).toBe(1);\n    expect(v2Fields.color!.metadata.deprecatedFromVersion).toBe(2);\n    expect(v2Fields.color!.metadata.deprecatedMessage).toBe(\"use fillColor/strokeColor\");\n  });\n\n  it(\"does not mark the field deprecated in versions before the deprecation\", () => {\n    const { chain } = resolveSchemaChain(v2);\n    const v1Fields = fieldsByKey(chain.find(c => c.version === 1)!, \"ShapeBox\");\n\n    expect(v1Fields.color).toBeDefined();\n    expect(v1Fields.color!.metadata.deprecatedFromVersion ?? undefined).toBeUndefined();\n    expect(v1Fields.fillColor).toBeUndefined();\n  });\n\n  it(\"stripDeprecatedFieldsForSdk drops deprecated fields from v>=deprecation only\", () => {\n    const { chain } = resolveSchemaChain(v2);\n    const stripped = stripDeprecatedFieldsForSdk(chain);\n\n    const v1Fields = fieldsByKey(stripped.find(c => c.version === 1)!, \"ShapeBox\");\n    expect(v1Fields.color).toBeDefined();\n\n    const v2Fields = fieldsByKey(stripped.find(c => c.version === 2)!, \"ShapeBox\");\n    expect(v2Fields.color).toBeUndefined();\n    expect(v2Fields.fillColor).toBeDefined();\n\n    expect(fieldsByKey(chain.find(c => c.version === 2)!, \"ShapeBox\").color).toBeDefined();\n  });\n});\n\ndescribe(\"resolveSchemaChain — union provenance\", () => {\n  const v1 = defineSchema({\n    Box: defineRecord(\"Box\", { docs: \"\", fields: { a: P.Double } }),\n    NodeShape: P.defineUnion(\"NodeShape\", {\n      docs: \"shape\",\n      variants: { box: defineRecord(\"Inner\", { docs: \"\", fields: { z: P.Double } }) },\n    }),\n  });\n  const addB = defineSchemaUpdate(\n    \"addB\",\n    (schema: P.SchemaBuilder<typeof v1.models>) => ({\n      Box: schema.Box.addField(\"b\", P.Optional(P.String)).build(),\n    }),\n  );\n  const v2 = nextSchema(v1).addSchemaUpdate(addB).build();\n\n  it(\"a v1-defined union stays addedInVersion 1 in every version\", () => {\n    const { chain } = resolveSchemaChain(v2);\n    for (const version of [1, 2]) {\n      const union = chain.find(c => c.version === version)!.ir.models.NodeShape!;\n      if (union.type !== \"union\") throw new Error(\"NodeShape should be a union\");\n      expect(union.union.metadata.addedInVersion).toBe(1);\n    }\n  });\n});\n"],"mappings":"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","ignoreList":[]}

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

@@ -105,7 +105,7 @@ function collectRecordModels(chain) {
         }
       }
 
-      // Fields removed in this version
+      // Fields absent from this version relative to the previous one (i.e. deprecated fields).
       const removedFields = [];
       for (const fieldKey of prevFields) {
         if (!currFields.has(fieldKey)) {

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

@@ -1 +1 @@
-{"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":[]}
+{"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 absent from this version relative to the previous one (i.e. deprecated fields).\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/generateScopeFromSchema.js

@@ -100,10 +100,10 @@ export function generateScopeFromChain(resolved, minSupportedVersion) {
       }
     }
 
-    // setCollectionRecord overloads
+    // setRecord overloads
     for (const [modelKey] of Object.entries(ir.models)) {
       const readType = versionedTypeName(modelKey, version);
-      output += `  setCollectionRecord(model: typeof ${modelName(modelKey)}, id: RecordId, data: ${readType}): Promise<void>;\n`;
+      output += `  setRecord(model: typeof ${modelName(modelKey)}, id: RecordId, data: ${readType}): Promise<void>;\n`;
     }
     output += `}\n\n`;
   }

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

@@ -1 +1 @@
-{"version":3,"file":"generateScopeFromSchema.js","names":["GENERATED_FILE_HEADER","resolveMinVersion","modelName","MODELS_PATH","typesFilePath","versionedTypeName","versionedWriteTypeName","writeTypesFilePath","generateScopeFromChain","resolved","minSupportedVersion","chain","minVersion","supportedVersions","filter","v","version","latestIr","length","ir","allModelNames","modelKey","Object","keys","models","push","output","modelImports","map","n","typeImportsFromModels","join","readTypeImports","writeTypeImports","modelDef","entries","type","sort","writeType","readType","unionMembers","handlerProps"],"sources":["generateScopeFromSchema.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 { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport type { ResolvedIrChain } from \"./resolveSchemaChain.js\";\nimport { resolveMinVersion } from \"./resolveSchemaChain.js\";\nimport {\n  modelName,\n  MODELS_PATH,\n  typesFilePath,\n  versionedTypeName,\n  versionedWriteTypeName,\n  writeTypesFilePath,\n} from \"./runtimeSchema.js\";\n\n/**\n * Generate versionedDocRef.ts from a versioned schema chain.\n *\n * Produces:\n * - Per-version VersionedDocRef_vN interfaces extending DocumentRef<DocumentModel>\n * - Union type VersionedDocRef = VersionedDocRef_v1 | VersionedDocRef_v2\n *\n * Every model gets a version-specific overload on every version so that\n * write data is always typed to the exact version, not the latest.\n */\nexport function generateScopeFromChain(\n  resolved: ResolvedIrChain,\n  minSupportedVersion?: number,\n): string {\n  const { chain } = resolved;\n  const { minVersion } = resolveMinVersion(chain, minSupportedVersion);\n\n  // Filter to supported versions\n  const supportedVersions = chain.filter(v => v.version >= minVersion);\n\n  // Collect all model names from the latest IR\n  const latestIr = chain[chain.length - 1]!.ir;\n  const allModelNames: string[] = [];\n  for (const modelKey of Object.keys(latestIr.models)) {\n    allModelNames.push(modelKey);\n  }\n\n  // Build output\n  let output = GENERATED_FILE_HEADER;\n\n  // Import model-types\n  output +=\n    `import type { DocumentRef, RecordId, RecordRef } from \"@palantir/pack.document-schema.model-types\";\\n`;\n\n  // Import model types from models.ts\n  const modelImports = allModelNames.map(n => modelName(n));\n  const typeImportsFromModels = [\"DocumentModel\", ...modelImports];\n  output += `import type { ${typeImportsFromModels.join(\", \")} } from \"${MODELS_PATH}\";\\n`;\n\n  // Import per-version types\n  for (const { version, ir } of supportedVersions) {\n    const readTypeImports: string[] = [];\n    const writeTypeImports: string[] = [];\n\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type === \"record\") {\n        readTypeImports.push(versionedTypeName(modelKey, version));\n        writeTypeImports.push(versionedWriteTypeName(modelKey, version));\n      } else if (modelDef.type === \"union\") {\n        readTypeImports.push(versionedTypeName(modelKey, version));\n      }\n    }\n\n    if (readTypeImports.length > 0) {\n      output += `import type { ${readTypeImports.sort().join(\", \")} } from \"${\n        typesFilePath(version)\n      }\";\\n`;\n    }\n    if (writeTypeImports.length > 0) {\n      output += `import type { ${writeTypeImports.sort().join(\", \")} } from \"${\n        writeTypesFilePath(version)\n      }\";\\n`;\n    }\n  }\n\n  output += \"\\n\";\n\n  // Generate per-version VersionedDocRef interfaces extending DocumentRef.\n  for (const { version, ir } of supportedVersions) {\n    output += `export interface VersionedDocRef_v${version} extends DocumentRef<DocumentModel> {\\n`;\n    output += `  readonly version: ${version};\\n`;\n\n    // updateRecord overloads — record models get write types, union models get Partial<read>\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type === \"record\") {\n        const writeType = versionedWriteTypeName(modelKey, version);\n        output += `  updateRecord(ref: RecordRef<typeof ${\n          modelName(modelKey)\n        }>, data: ${writeType}): Promise<void>;\\n`;\n      } else if (modelDef.type === \"union\") {\n        const readType = versionedTypeName(modelKey, version);\n        output += `  updateRecord(ref: RecordRef<typeof ${\n          modelName(modelKey)\n        }>, data: Partial<${readType}>): Promise<void>;\\n`;\n      }\n    }\n\n    // setCollectionRecord overloads\n    for (const [modelKey] of Object.entries(ir.models)) {\n      const readType = versionedTypeName(modelKey, version);\n      output += `  setCollectionRecord(model: typeof ${\n        modelName(modelKey)\n      }, id: RecordId, data: ${readType}): Promise<void>;\\n`;\n    }\n\n    output += `}\\n\\n`;\n  }\n\n  // Union type\n  if (supportedVersions.length === 1) {\n    output += `export type VersionedDocRef = VersionedDocRef_v${supportedVersions[0]!.version};\\n`;\n  } else {\n    const unionMembers = supportedVersions.map(v => `VersionedDocRef_v${v.version}`).join(\" | \");\n    output += `export type VersionedDocRef = ${unionMembers};\\n`;\n  }\n\n  // asVersioned — identity cast to unlock version-specific write overloads\n  output += `\\n/** Narrow a DocumentRef to a version-discriminated type for type-safe writes. */\\n`;\n  output += `export function asVersioned(docRef: DocumentRef<DocumentModel>): VersionedDocRef {\\n`;\n  output += `  return docRef as VersionedDocRef;\\n`;\n  output += `}\\n`;\n\n  // matchVersion — exhaustive version handler\n  const handlerProps = supportedVersions.map(\n    v => `  readonly ${v.version}: (doc: VersionedDocRef_v${v.version}) => R;`,\n  ).join(\"\\n\");\n\n  output += `\\n/**\\n`;\n  output += ` * Exhaustive version handler. TypeScript enforces that every supported\\n`;\n  output += ` * version has a corresponding handler -- adding a new schema version\\n`;\n  output += ` * produces a compile error at every call site until handled.\\n`;\n  output += ` */\\n`;\n  output += `export function matchVersion<R>(\\n`;\n  output += `  doc: VersionedDocRef,\\n`;\n  output += `  handlers: {\\n`;\n  output += handlerProps + \"\\n\";\n  output += `  },\\n`;\n  output += `): R {\\n`;\n  output += `  switch (doc.version) {\\n`;\n  for (const { version } of supportedVersions) {\n    output += `    case ${version}:\\n`;\n    output += `      return handlers[${version}](doc);\\n`;\n  }\n  output += `    default:\\n`;\n  output += `      throw new Error(\\`Unexpected document version: \\${(doc as any).version}\\`);\\n`;\n  output += `  }\\n`;\n  output += `}\\n`;\n\n  return output;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"generateScopeFromSchema.js","names":["GENERATED_FILE_HEADER","resolveMinVersion","modelName","MODELS_PATH","typesFilePath","versionedTypeName","versionedWriteTypeName","writeTypesFilePath","generateScopeFromChain","resolved","minSupportedVersion","chain","minVersion","supportedVersions","filter","v","version","latestIr","length","ir","allModelNames","modelKey","Object","keys","models","push","output","modelImports","map","n","typeImportsFromModels","join","readTypeImports","writeTypeImports","modelDef","entries","type","sort","writeType","readType","unionMembers","handlerProps"],"sources":["generateScopeFromSchema.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 { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport type { ResolvedIrChain } from \"./resolveSchemaChain.js\";\nimport { resolveMinVersion } from \"./resolveSchemaChain.js\";\nimport {\n  modelName,\n  MODELS_PATH,\n  typesFilePath,\n  versionedTypeName,\n  versionedWriteTypeName,\n  writeTypesFilePath,\n} from \"./runtimeSchema.js\";\n\n/**\n * Generate versionedDocRef.ts from a versioned schema chain.\n *\n * Produces:\n * - Per-version VersionedDocRef_vN interfaces extending DocumentRef<DocumentModel>\n * - Union type VersionedDocRef = VersionedDocRef_v1 | VersionedDocRef_v2\n *\n * Every model gets a version-specific overload on every version so that\n * write data is always typed to the exact version, not the latest.\n */\nexport function generateScopeFromChain(\n  resolved: ResolvedIrChain,\n  minSupportedVersion?: number,\n): string {\n  const { chain } = resolved;\n  const { minVersion } = resolveMinVersion(chain, minSupportedVersion);\n\n  // Filter to supported versions\n  const supportedVersions = chain.filter(v => v.version >= minVersion);\n\n  // Collect all model names from the latest IR\n  const latestIr = chain[chain.length - 1]!.ir;\n  const allModelNames: string[] = [];\n  for (const modelKey of Object.keys(latestIr.models)) {\n    allModelNames.push(modelKey);\n  }\n\n  // Build output\n  let output = GENERATED_FILE_HEADER;\n\n  // Import model-types\n  output +=\n    `import type { DocumentRef, RecordId, RecordRef } from \"@palantir/pack.document-schema.model-types\";\\n`;\n\n  // Import model types from models.ts\n  const modelImports = allModelNames.map(n => modelName(n));\n  const typeImportsFromModels = [\"DocumentModel\", ...modelImports];\n  output += `import type { ${typeImportsFromModels.join(\", \")} } from \"${MODELS_PATH}\";\\n`;\n\n  // Import per-version types\n  for (const { version, ir } of supportedVersions) {\n    const readTypeImports: string[] = [];\n    const writeTypeImports: string[] = [];\n\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type === \"record\") {\n        readTypeImports.push(versionedTypeName(modelKey, version));\n        writeTypeImports.push(versionedWriteTypeName(modelKey, version));\n      } else if (modelDef.type === \"union\") {\n        readTypeImports.push(versionedTypeName(modelKey, version));\n      }\n    }\n\n    if (readTypeImports.length > 0) {\n      output += `import type { ${readTypeImports.sort().join(\", \")} } from \"${\n        typesFilePath(version)\n      }\";\\n`;\n    }\n    if (writeTypeImports.length > 0) {\n      output += `import type { ${writeTypeImports.sort().join(\", \")} } from \"${\n        writeTypesFilePath(version)\n      }\";\\n`;\n    }\n  }\n\n  output += \"\\n\";\n\n  // Generate per-version VersionedDocRef interfaces extending DocumentRef.\n  for (const { version, ir } of supportedVersions) {\n    output += `export interface VersionedDocRef_v${version} extends DocumentRef<DocumentModel> {\\n`;\n    output += `  readonly version: ${version};\\n`;\n\n    // updateRecord overloads — record models get write types, union models get Partial<read>\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type === \"record\") {\n        const writeType = versionedWriteTypeName(modelKey, version);\n        output += `  updateRecord(ref: RecordRef<typeof ${\n          modelName(modelKey)\n        }>, data: ${writeType}): Promise<void>;\\n`;\n      } else if (modelDef.type === \"union\") {\n        const readType = versionedTypeName(modelKey, version);\n        output += `  updateRecord(ref: RecordRef<typeof ${\n          modelName(modelKey)\n        }>, data: Partial<${readType}>): Promise<void>;\\n`;\n      }\n    }\n\n    // setRecord overloads\n    for (const [modelKey] of Object.entries(ir.models)) {\n      const readType = versionedTypeName(modelKey, version);\n      output += `  setRecord(model: typeof ${\n        modelName(modelKey)\n      }, id: RecordId, data: ${readType}): Promise<void>;\\n`;\n    }\n\n    output += `}\\n\\n`;\n  }\n\n  // Union type\n  if (supportedVersions.length === 1) {\n    output += `export type VersionedDocRef = VersionedDocRef_v${supportedVersions[0]!.version};\\n`;\n  } else {\n    const unionMembers = supportedVersions.map(v => `VersionedDocRef_v${v.version}`).join(\" | \");\n    output += `export type VersionedDocRef = ${unionMembers};\\n`;\n  }\n\n  // asVersioned — identity cast to unlock version-specific write overloads\n  output += `\\n/** Narrow a DocumentRef to a version-discriminated type for type-safe writes. */\\n`;\n  output += `export function asVersioned(docRef: DocumentRef<DocumentModel>): VersionedDocRef {\\n`;\n  output += `  return docRef as VersionedDocRef;\\n`;\n  output += `}\\n`;\n\n  // matchVersion — exhaustive version handler\n  const handlerProps = supportedVersions.map(\n    v => `  readonly ${v.version}: (doc: VersionedDocRef_v${v.version}) => R;`,\n  ).join(\"\\n\");\n\n  output += `\\n/**\\n`;\n  output += ` * Exhaustive version handler. TypeScript enforces that every supported\\n`;\n  output += ` * version has a corresponding handler -- adding a new schema version\\n`;\n  output += ` * produces a compile error at every call site until handled.\\n`;\n  output += ` */\\n`;\n  output += `export function matchVersion<R>(\\n`;\n  output += `  doc: VersionedDocRef,\\n`;\n  output += `  handlers: {\\n`;\n  output += handlerProps + \"\\n\";\n  output += `  },\\n`;\n  output += `): R {\\n`;\n  output += `  switch (doc.version) {\\n`;\n  for (const { version } of supportedVersions) {\n    output += `    case ${version}:\\n`;\n    output += `      return handlers[${version}](doc);\\n`;\n  }\n  output += `    default:\\n`;\n  output += `      throw new Error(\\`Unexpected document version: \\${(doc as any).version}\\`);\\n`;\n  output += `  }\\n`;\n  output += `}\\n`;\n\n  return output;\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+import { defineSchema } from "@palantir/pack.schema";
 import fs from "fs-extra";
 import path from "path";
 import { pathToFileURL } from "url";
@@ -31,11 +32,7 @@ export function extractSchemaDefinition(schemaModule) {
     return defaultExport;
   }
   const models = extractValidSchema(schemaModule);
-  return {
-    type: "initial",
-    version: 1,
-    models
-  };
+  return defineSchema(models);
 }
 
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"loadSchemaModule.js","names":["fs","path","pathToFileURL","extractValidSchema","extractSchemaDefinition","schemaModule","defaultExport","default","type","models","version","loadSchemaModule","filePath","inputPath","resolve","pathExists","Error","href"],"sources":["loadSchemaModule.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 { InitialSchema, SchemaDefinition } from \"@palantir/pack.schema\";\nimport fs from \"fs-extra\";\nimport path from \"path\";\nimport { pathToFileURL } from \"url\";\nimport { extractValidSchema } from \"./validateSchemaModule.js\";\n\n/**\n * Pull a `SchemaDefinition` out of an imported module. Accepts either a chain\n * built via `defineSchemaUpdate(...)` (`type: \"initial\" | \"versioned\"`) or a\n * plain `ModelDefs` object exported as `default` (which is wrapped in an\n * `InitialSchema` at version 1).\n */\nexport function extractSchemaDefinition(schemaModule: unknown): SchemaDefinition {\n  const mod = schemaModule as Record<string, unknown>;\n  const defaultExport = mod.default;\n\n  if (\n    typeof defaultExport === \"object\" && defaultExport != null\n    && \"type\" in defaultExport\n    && (defaultExport.type === \"initial\" || defaultExport.type === \"versioned\")\n  ) {\n    return defaultExport as SchemaDefinition;\n  }\n\n  const models = extractValidSchema(schemaModule);\n  return { type: \"initial\", version: 1, models } satisfies InitialSchema;\n}\n\n/**\n * Resolve and import a schema module from a file path, returning a\n * `SchemaDefinition` ready for IR resolution.\n */\nexport async function loadSchemaModule(filePath: string): Promise<SchemaDefinition> {\n  const inputPath = path.resolve(filePath);\n  if (!(await fs.pathExists(inputPath))) {\n    throw new Error(`Input file not found: ${inputPath}`);\n  }\n  const schemaModule: unknown = await import(pathToFileURL(inputPath).href);\n  return extractSchemaDefinition(schemaModule);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,OAAOA,EAAE,MAAM,UAAU;AACzB,OAAOC,IAAI,MAAM,MAAM;AACvB,SAASC,aAAa,QAAQ,KAAK;AACnC,SAASC,kBAAkB,QAAQ,2BAA2B;;AAE9D;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,YAAqB,EAAoB;EAE/E,MAAMC,aAAa,GADPD,YAAY,CACEE,OAAO;EAEjC,IACE,OAAOD,aAAa,KAAK,QAAQ,IAAIA,aAAa,IAAI,IAAI,IACvD,MAAM,IAAIA,aAAa,KACtBA,aAAa,CAACE,IAAI,KAAK,SAAS,IAAIF,aAAa,CAACE,IAAI,KAAK,WAAW,CAAC,EAC3E;IACA,OAAOF,aAAa;EACtB;EAEA,MAAMG,MAAM,GAAGN,kBAAkB,CAACE,YAAY,CAAC;EAC/C,OAAO;IAAEG,IAAI,EAAE,SAAS;IAAEE,OAAO,EAAE,CAAC;IAAED;EAAO,CAAC;AAChD;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAeE,gBAAgBA,CAACC,QAAgB,EAA6B;EAClF,MAAMC,SAAS,GAAGZ,IAAI,CAACa,OAAO,CAACF,QAAQ,CAAC;EACxC,IAAI,EAAE,MAAMZ,EAAE,CAACe,UAAU,CAACF,SAAS,CAAC,CAAC,EAAE;IACrC,MAAM,IAAIG,KAAK,CAAC,yBAAyBH,SAAS,EAAE,CAAC;EACvD;EACA,MAAMR,YAAqB,GAAG,MAAM,MAAM,CAACH,aAAa,CAACW,SAAS,CAAC,CAACI,IAAI,CAAC;EACzE,OAAOb,uBAAuB,CAACC,YAAY,CAAC;AAC9C","ignoreList":[]}
+{"version":3,"file":"loadSchemaModule.js","names":["defineSchema","fs","path","pathToFileURL","extractValidSchema","extractSchemaDefinition","schemaModule","defaultExport","default","type","models","loadSchemaModule","filePath","inputPath","resolve","pathExists","Error","href"],"sources":["loadSchemaModule.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 { defineSchema } from \"@palantir/pack.schema\";\nimport fs from \"fs-extra\";\nimport path from \"path\";\nimport { pathToFileURL } from \"url\";\nimport { extractValidSchema } from \"./validateSchemaModule.js\";\n\n/**\n * Pull a `SchemaDefinition` out of an imported module. Accepts either a chain\n * built via `defineSchemaUpdate(...)` (`type: \"initial\" | \"versioned\"`) or a\n * plain `ModelDefs` object exported as `default` (which is wrapped in an\n * `InitialSchema` at version 1).\n */\nexport function extractSchemaDefinition(schemaModule: unknown): SchemaDefinition {\n  const mod = schemaModule as Record<string, unknown>;\n  const defaultExport = mod.default;\n\n  if (\n    typeof defaultExport === \"object\" && defaultExport != null\n    && \"type\" in defaultExport\n    && (defaultExport.type === \"initial\" || defaultExport.type === \"versioned\")\n  ) {\n    return defaultExport as SchemaDefinition;\n  }\n\n  const models = extractValidSchema(schemaModule);\n  return defineSchema(models);\n}\n\n/**\n * Resolve and import a schema module from a file path, returning a\n * `SchemaDefinition` ready for IR resolution.\n */\nexport async function loadSchemaModule(filePath: string): Promise<SchemaDefinition> {\n  const inputPath = path.resolve(filePath);\n  if (!(await fs.pathExists(inputPath))) {\n    throw new Error(`Input file not found: ${inputPath}`);\n  }\n  const schemaModule: unknown = await import(pathToFileURL(inputPath).href);\n  return extractSchemaDefinition(schemaModule);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,YAAY,QAAQ,uBAAuB;AACpD,OAAOC,EAAE,MAAM,UAAU;AACzB,OAAOC,IAAI,MAAM,MAAM;AACvB,SAASC,aAAa,QAAQ,KAAK;AACnC,SAASC,kBAAkB,QAAQ,2BAA2B;;AAE9D;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,YAAqB,EAAoB;EAE/E,MAAMC,aAAa,GADPD,YAAY,CACEE,OAAO;EAEjC,IACE,OAAOD,aAAa,KAAK,QAAQ,IAAIA,aAAa,IAAI,IAAI,IACvD,MAAM,IAAIA,aAAa,KACtBA,aAAa,CAACE,IAAI,KAAK,SAAS,IAAIF,aAAa,CAACE,IAAI,KAAK,WAAW,CAAC,EAC3E;IACA,OAAOF,aAAa;EACtB;EAEA,MAAMG,MAAM,GAAGN,kBAAkB,CAACE,YAAY,CAAC;EAC/C,OAAON,YAAY,CAACU,MAAM,CAAC;AAC7B;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAeC,gBAAgBA,CAACC,QAAgB,EAA6B;EAClF,MAAMC,SAAS,GAAGX,IAAI,CAACY,OAAO,CAACF,QAAQ,CAAC;EACxC,IAAI,EAAE,MAAMX,EAAE,CAACc,UAAU,CAACF,SAAS,CAAC,CAAC,EAAE;IACrC,MAAM,IAAIG,KAAK,CAAC,yBAAyBH,SAAS,EAAE,CAAC;EACvD;EACA,MAAMP,YAAqB,GAAG,MAAM,MAAM,CAACH,aAAa,CAACU,SAAS,CAAC,CAACI,IAAI,CAAC;EACzE,OAAOZ,uBAAuB,CAACC,YAAY,CAAC;AAC9C","ignoreList":[]}

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

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+import { IModelDef as IModelDefCtor } from "../../lib/pack-docschema-api/pack-docschema-ir/index.js";
 import { convertSchemaToIr } from "../steps/convertStepsToIr.js";
 
 /** JSON-serializable form of a single field migration. */
@@ -21,29 +22,70 @@ import { convertSchemaToIr } from "../steps/convertStepsToIr.js";
 /** Serialized migrations keyed by `[recordModelName][fieldName]`. */
 
 function collectVersionedIrChain(input, identity) {
-  const chain = [];
+  const schemas = collectSchemaDefinitions(input);
+  const provenances = deriveProvenance(schemas);
+  return schemas.map((schema, index) => ({
+    version: schema.version,
+    ir: convertSchemaToIr(schema.models, {
+      version: schema.version,
+      name: identity.name,
+      description: identity.description
+    }, provenances[index]),
+    ...(schema.type === "versioned" ? {
+      migrations: serializeMigrations(schema.migrations)
+    } : {})
+  }));
+}
+function collectSchemaDefinitions(input) {
+  const schemas = [];
   let current = input;
   while (current.type === "versioned") {
-    chain.unshift({
-      version: current.version,
-      ir: convertSchemaToIr(current.models, {
-        version: current.version,
-        name: identity.name,
-        description: identity.description
-      }),
-      migrations: serializeMigrations(current.migrations)
-    });
+    schemas.unshift(current);
     current = current.previous;
   }
-  chain.unshift({
-    version: current.version,
-    ir: convertSchemaToIr(current.models, {
-      version: current.version,
-      name: identity.name,
-      description: identity.description
-    })
+  schemas.unshift(current);
+  return schemas;
+}
+
+/**
+ * Build field/model provenance by walking the version chain from oldest to
+ * newest. The first version where a model key or record field appears is the
+ * version stamped into IR metadata.
+ */
+function deriveProvenance(schemas) {
+  const firstModelVersions = new Map();
+  const firstFieldVersions = new Map();
+  return schemas.map(schema => {
+    const modelVersions = {};
+    const fieldVersions = {};
+    for (const [modelKey, modelDef] of Object.entries(schema.models)) {
+      if (!firstModelVersions.has(modelKey)) {
+        firstModelVersions.set(modelKey, schema.version);
+      }
+      modelVersions[modelKey] = firstModelVersions.get(modelKey);
+      if (modelDef.type !== "record") continue;
+      let fieldVersionsForModel = firstFieldVersions.get(modelKey);
+      if (fieldVersionsForModel == null) {
+        fieldVersionsForModel = new Map();
+        firstFieldVersions.set(modelKey, fieldVersionsForModel);
+      }
+      const fields = {};
+      for (const fieldKey of Object.keys(modelDef.fields)) {
+        if (!fieldVersionsForModel.has(fieldKey)) {
+          fieldVersionsForModel.set(fieldKey, schema.version);
+        }
+        fields[fieldKey] = fieldVersionsForModel.get(fieldKey);
+      }
+      if (Object.keys(fields).length > 0) {
+        fieldVersions[modelKey] = fields;
+      }
+    }
+    return {
+      fieldVersions,
+      modelVersions,
+      deprecations: "deprecations" in schema ? schema.deprecations : undefined
+    };
   });
-  return chain;
 }
 
 /** Convert schema-builder migrations to their JSON-serializable form. */
@@ -101,6 +143,44 @@ export function resolveSchemaChain(schema, minSupportedVersion, identity = {}) {
   };
 }
 
+/**
+ * Return a copy of the chain with deprecated fields removed from every version
+ * at or after the version in which they were deprecated.
+ *
+ * The SDK type generators (`writeAllSdkFiles` and friends) must treat a
+ * deprecated field exactly as a removed field: it disappears from that version's
+ * public read/write types and per-version internal types, and the prev/curr diff
+ * records it as a `removedField` (driving the upgrade lens). The field is still
+ * collected into the all-versions `__Internal` type from earlier versions, which
+ * are left untouched.
+ */
+export function stripDeprecatedFieldsForSdk(chain) {
+  return chain.map(entry => {
+    const models = {};
+    for (const [modelKey, modelDef] of Object.entries(entry.ir.models)) {
+      if (modelDef.type === "record") {
+        const fields = modelDef.record.fields.filter(field => {
+          const dep = field.metadata.deprecatedFromVersion;
+          return dep == null || entry.version < dep;
+        });
+        models[modelKey] = IModelDefCtor.record({
+          ...modelDef.record,
+          fields
+        });
+      } else {
+        models[modelKey] = modelDef;
+      }
+    }
+    return {
+      ...entry,
+      ir: {
+        ...entry.ir,
+        models
+      }
+    };
+  });
+}
+
 /**
  * True if any migration in the chain declares a non-empty `derivedFrom`. Drives
  * whether the generated SDK emits `DocumentModel` as a factory (requires the