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

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

@@ -17,7 +17,7 @@
 import { formatVariantName } from "../formatVariantName.js";
 import { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
 import { findExternalRefType } from "../ir/irFieldHelpers.js";
-import { chainHasDerivedFields, resolveMinVersion } from "./resolveSchemaChain.js";
+import { chainNeedsUpgradeFns, 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 = [];
@@ -42,7 +42,7 @@ export function generateModelMetadataFromChain(resolved, minSupportedVersion) {
     minVersion
   } = resolveMinVersion(chain, minSupportedVersion);
   const latestIr = chain[chain.length - 1].ir;
-  const hasDerivedFields = chainHasDerivedFields(chain);
+  const needsUpgradeFns = chainNeedsUpgradeFns(chain);
 
   // --- Generate models.ts ---
   let output = GENERATED_FILE_HEADER;
@@ -67,7 +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");
+  if (needsUpgradeFns) 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) {
@@ -87,7 +87,7 @@ export function generateModelMetadataFromChain(resolved, minSupportedVersion) {
   }
 
   // DocumentUpgradeFns type is needed by the factory's parameter signature.
-  if (hasDerivedFields) {
+  if (needsUpgradeFns) {
     output += `import type { DocumentUpgradeFns } from "${INTERNAL_UPGRADE_FNS_PATH}";\n`;
   }
   output += "\n";
@@ -170,13 +170,14 @@ export function generateModelMetadataFromChain(resolved, minSupportedVersion) {
   }
   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.
+  if (needsUpgradeFns) {
+    // Factory form: schema has at least one derived field or required additive
+    // field, 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 += ` * functions the runtime needs to materialize fields added past v1.\n`;
     output += ` */\n`;
     output += `export function DocumentModel(upgradeFns: DocumentUpgradeFns): DocumentSchema {\n`;
     output += `  return {\n`;
@@ -188,7 +189,8 @@ export function generateModelMetadataFromChain(resolved, minSupportedVersion) {
     output += `}\n\n`;
     output += `export type DocumentModel = ReturnType<typeof DocumentModel>;\n`;
   } else {
-    // Const form: no derived fields means no upgrade functions are required.
+    // Const form: no field added past v1 needs lens treatment, so no upgrade
+    // functions are required.
     output += `export const DocumentModel = {\n`;
     output += `${modelEntriesBody},\n`;
     // Const form indents one level less than the factory body.

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

@@ -1 +1 @@
-{"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":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,iBAAiB,QAAQ,yBAAyB;AAC3D,SAASC,qBAAqB,QAAQ,2BAA2B;AACjE,SAASC,mBAAmB,QAAQ,yBAAyB;AAE7D,SAASC,qBAAqB,EAAEC,iBAAiB,QAAQ,yBAAyB;AAClF,SACEC,yBAAyB,EACzBC,sBAAsB,EACtBC,SAAS,EACTC,oBAAoB,EACpBC,UAAU,EACVC,mBAAmB,QACd,oBAAoB;AAO3B,SAASC,4BAA4BA,CACnCC,MAAkB,EACO;EACzB,MAAMC,IAA6B,GAAG,EAAE;EACxC,KAAK,MAAMC,KAAK,IAAIF,MAAM,CAACG,MAAM,EAAE;IACjC,MAAMC,OAAO,GAAGd,mBAAmB,CAACY,KAAK,CAACG,SAAS,CAAC;IACpD,IAAID,OAAO,IAAI,IAAI,EAAE;MACnBH,IAAI,CAACK,IAAI,CAAC,CAACJ,KAAK,CAACK,GAAG,EAAEH,OAAO,CAAC,CAAC;IACjC;EACF;EACA,OAAOH,IAAI;AACb;;AAEA;AACA;AACA;AACA,OAAO,SAASO,8BAA8BA,CAC5CC,QAAyB,EACzBC,mBAA4B,EACP;EACrB,MAAM;IAAEC;EAAM,CAAC,GAAGF,QAAQ;EAC1B,MAAM;IAAEG,aAAa;IAAEC;EAAW,CAAC,GAAGrB,iBAAiB,CAACmB,KAAK,EAAED,mBAAmB,CAAC;EACnF,MAAMI,QAAQ,GAAGH,KAAK,CAACA,KAAK,CAACI,MAAM,GAAG,CAAC,CAAC,CAAEC,EAAE;EAC5C,MAAMC,gBAAgB,GAAG1B,qBAAqB,CAACoB,KAAK,CAAC;;EAErD;EACA,IAAIO,MAAM,GAAG7B,qBAAqB;;EAElC;EACA,MAAM8B,WAAqB,GAAG,EAAE;EAChC,MAAMC,UAAoB,GAAG,EAAE;EAC/B,MAAMC,YAAsB,GAAG,EAAE;EAEjC,KAAK,MAAM,CAACC,QAAQ,EAAEC,QAAQ,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACX,QAAQ,CAACY,MAAM,CAAC,EAAE;IAClE,IAAIH,QAAQ,CAACI,IAAI,KAAK,QAAQ,EAAE;MAC9BR,WAAW,CAACb,IAAI,CAACgB,QAAQ,CAAC;IAC5B,CAAC,MAAM,IAAIC,QAAQ,CAACI,IAAI,KAAK,OAAO,EAAE;MACpCP,UAAU,CAACd,IAAI,CAACgB,QAAQ,CAAC;MACzB,KAAK,MAAMM,WAAW,IAAIJ,MAAM,CAACK,IAAI,CAACN,QAAQ,CAACO,KAAK,CAACC,QAAQ,CAAC,EAAE;QAC9DV,YAAY,CAACf,IAAI,CAAC,GAAGgB,QAAQ,GAAGlC,iBAAiB,CAACwC,WAAW,CAAC,EAAE,CAAC;MACnE;IACF;EACF;EAEA,MAAMI,aAAa,GAAG,CAAC,GAAGb,WAAW,EAAE,GAAGC,UAAU,EAAE,GAAGC,YAAY,CAAC,CAACY,IAAI,CAAC,CAAC;;EAE7E;EACA,MAAMC,iBAA2B,GAAG,CAAC,gBAAgB,CAAC;EACtD,IAAIf,WAAW,CAACJ,MAAM,GAAG,CAAC,EAAEmB,iBAAiB,CAAC5B,IAAI,CAAC,aAAa,CAAC;EACjE,IAAIc,UAAU,CAACL,MAAM,GAAG,CAAC,EAAEmB,iBAAiB,CAAC5B,IAAI,CAAC,YAAY,CAAC;EAC/D,IAAIW,gBAAgB,EAAEiB,iBAAiB,CAAC5B,IAAI,CAAC,YAAY,CAAC;EAE1DY,MAAM,IAAI,iBACRgB,iBAAiB,CAACD,IAAI,CAAC,CAAC,CAACE,IAAI,CAAC,IAAI,CAAC,yDACoB;EACzDjB,MAAM,IAAI,0EAA0E;EAEpF,IAAIc,aAAa,CAACjB,MAAM,GAAG,CAAC,EAAE;IAC5BG,MAAM,IAAI,iBAAiBc,aAAa,CAACG,IAAI,CAAC,IAAI,CAAC,YAAYrC,mBAAmB,MAAM;EAC1F;;EAEA;EACA,MAAMsC,WAAW,GAAGJ,aAAa,CAACK,GAAG,CAACC,CAAC,IAAIzC,UAAU,CAACyC,CAAC,CAAC,CAAC;EACzD,IAAIF,WAAW,CAACrB,MAAM,GAAG,CAAC,EAAE;IAC1BG,MAAM,IAAI,YAAYkB,WAAW,CAACD,IAAI,CAAC,IAAI,CAAC,YAAYvC,oBAAoB,MAAM;EACpF;;EAEA;EACA,MAAM2C,YAAY,GAAG,CAAC,GAAGpB,WAAW,EAAE,GAAGC,UAAU,CAAC,CAACiB,GAAG,CAACC,CAAC,IAAI,GAAGA,CAAC,UAAU,CAAC;EAC7E,IAAI3B,KAAK,CAACI,MAAM,GAAG,CAAC,IAAIwB,YAAY,CAACxB,MAAM,GAAG,CAAC,EAAE;IAC/CG,MAAM,IAAI,YAAYqB,YAAY,CAACJ,IAAI,CAAC,IAAI,CAAC,YAAYzC,sBAAsB,MAAM;EACvF;;EAEA;EACA,IAAIuB,gBAAgB,EAAE;IACpBC,MAAM,IAAI,4CAA4CzB,yBAAyB,MAAM;EACvF;EAEAyB,MAAM,IAAI,IAAI;;EAEd;EACA,KAAK,MAAM,CAACI,QAAQ,EAAEC,QAAQ,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACX,QAAQ,CAACY,MAAM,CAAC,EAAE;IAClE,IAAIH,QAAQ,CAACI,IAAI,KAAK,QAAQ,EAAE;MAC9B,MAAMa,YAAY,GAAGzC,4BAA4B,CAACwB,QAAQ,CAACvB,MAAM,CAAC;MAClE,MAAMyC,cAAwB,GAAG,EAAE;MAEnC,IAAID,YAAY,CAACzB,MAAM,GAAG,CAAC,EAAE;QAC3B,MAAMU,OAAO,GAAGe,YAAY,CAACH,GAAG,CAAC,CAAC,CAACnC,KAAK,EAAEyB,IAAI,CAAC,KAAK,SAASzB,KAAK,MAAMyB,IAAI,IAAI,CAAC,CAACQ,IAAI,CACpF,IACF,CAAC;QACDM,cAAc,CAACnC,IAAI,CAAC,iCAAiCmB,OAAO,UAAU,CAAC;MACzE;MACAgB,cAAc,CAACnC,IAAI,CAAC,cAAcgB,QAAQ,IAAI,CAAC;MAE/CJ,MAAM,IAAI,oBAAoBvB,SAAS,CAAC2B,QAAQ,CAAC,wBAAwBA,QAAQ,YAC/EzB,UAAU,CAACyB,QAAQ,CAAC,QACd;MACRJ,MAAM,IAAI,gBAAgBvB,SAAS,CAAC2B,QAAQ,CAAC,KAAK3B,SAAS,CAAC2B,QAAQ,CAAC,QAAQ;MAC7EJ,MAAM,IAAI,mBAAmBI,QAAQ,KAAK;MAC1CJ,MAAM,IAAI,gBAAgBrB,UAAU,CAACyB,QAAQ,CAAC,KAAK;MACnDJ,MAAM,IAAI,oBAAoBuB,cAAc,CAACN,IAAI,CAAC,IAAI,CAAC,UAAU;MACjEjB,MAAM,IAAI,QAAQ;IACpB,CAAC,MAAM,IAAIK,QAAQ,CAACI,IAAI,KAAK,OAAO,EAAE;MACpC,MAAMG,KAAK,GAAGP,QAAQ,CAACO,KAAK;MAC5B,MAAMW,cAAwB,GAAG,EAAE;MACnCA,cAAc,CAACnC,IAAI,CAAC,sBAAsBwB,KAAK,CAACY,YAAY,IAAI,CAAC;MACjED,cAAc,CAACnC,IAAI,CAAC,cAAcgB,QAAQ,IAAI,CAAC;MAE/CJ,MAAM,IAAI,oBAAoBvB,SAAS,CAAC2B,QAAQ,CAAC,uBAAuBA,QAAQ,YAC9EzB,UAAU,CAACyB,QAAQ,CAAC,QACd;MACRJ,MAAM,IAAI,gBAAgBvB,SAAS,CAAC2B,QAAQ,CAAC,KAAK3B,SAAS,CAAC2B,QAAQ,CAAC,QAAQ;MAC7EJ,MAAM,IAAI,mBAAmBI,QAAQ,KAAK;MAC1CJ,MAAM,IAAI,gBAAgBrB,UAAU,CAACyB,QAAQ,CAAC,KAAK;MACnDJ,MAAM,IAAI,oBAAoBuB,cAAc,CAACN,IAAI,CAAC,IAAI,CAAC,UAAU;MACjEjB,MAAM,IAAI,QAAQ;;MAElB;MACA,KAAK,MAAMU,WAAW,IAAIJ,MAAM,CAACK,IAAI,CAACC,KAAK,CAACC,QAAQ,CAAC,EAAE;QACrD,MAAMY,gBAAgB,GAAGvD,iBAAiB,CAACwC,WAAW,CAAC;QACvD,MAAMgB,eAAe,GAAG,GAAGtB,QAAQ,GAAGqB,gBAAgB,EAAE;QACxD,MAAME,eAAyB,GAAG,EAAE;QACpCA,eAAe,CAACvC,IAAI,CAAC,sBAAsBwB,KAAK,CAACY,YAAY,IAAI,CAAC;QAClEG,eAAe,CAACvC,IAAI,CAAC,cAAcsC,eAAe,IAAI,CAAC;QAEvD1B,MAAM,IAAI,oBACRvB,SAAS,CAACiD,eAAe,CAAC,uBACLA,eAAe,YAAY/C,UAAU,CAAC+C,eAAe,CAAC,QAAQ;QACrF1B,MAAM,IAAI,gBAAgBvB,SAAS,CAACiD,eAAe,CAAC,KAAKjD,SAAS,CAACiD,eAAe,CAAC,QAAQ;QAC3F1B,MAAM,IAAI,mBAAmB0B,eAAe,KAAK;QACjD1B,MAAM,IAAI,gBAAgBrB,UAAU,CAAC+C,eAAe,CAAC,KAAK;QAC1D1B,MAAM,IAAI,oBAAoB2B,eAAe,CAACV,IAAI,CAAC,IAAI,CAAC,UAAU;QAClEjB,MAAM,IAAI,QAAQ;MACpB;IACF;EACF;;EAEA;EACA,MAAM4B,YAAsB,GAAG,EAAE;EACjC,KAAK,MAAM,CAACxB,QAAQ,EAAEC,QAAQ,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACX,QAAQ,CAACY,MAAM,CAAC,EAAE;IAClE,IAAIH,QAAQ,CAACI,IAAI,KAAK,QAAQ,EAAE;MAC9BmB,YAAY,CAACxC,IAAI,CAAC,KAAKgB,QAAQ,KAAK3B,SAAS,CAAC2B,QAAQ,CAAC,EAAE,CAAC;IAC5D,CAAC,MAAM,IAAIC,QAAQ,CAACI,IAAI,KAAK,OAAO,EAAE;MACpCmB,YAAY,CAACxC,IAAI,CAAC,KAAKgB,QAAQ,KAAK3B,SAAS,CAAC2B,QAAQ,CAAC,EAAE,CAAC;MAC1D,KAAK,MAAMM,WAAW,IAAIJ,MAAM,CAACK,IAAI,CAACN,QAAQ,CAACO,KAAK,CAACC,QAAQ,CAAC,EAAE;QAC9D,MAAMY,gBAAgB,GAAGvD,iBAAiB,CAACwC,WAAW,CAAC;QACvD,MAAMgB,eAAe,GAAG,GAAGtB,QAAQ,GAAGqB,gBAAgB,EAAE;QACxDG,YAAY,CAACxC,IAAI,CAAC,KAAKsC,eAAe,KAAKjD,SAAS,CAACiD,eAAe,CAAC,EAAE,CAAC;MAC1E;IACF;EACF;;EAEA;EACA,IAAIG,aAAqB;EACzB,MAAMC,eAAe,GAAG,CAAC,GAAG7B,WAAW,EAAE,GAAGC,UAAU,CAAC;EACvD,IAAIT,KAAK,CAACI,MAAM,GAAG,CAAC,IAAIiC,eAAe,CAACjC,MAAM,GAAG,CAAC,EAAE;IAClD,MAAMkC,cAAc,GAAGD,eAAe,CAACX,GAAG,CAACC,CAAC,IAAI,WAAWA,CAAC,KAAKA,CAAC,WAAW,CAAC,CAACH,IAAI,CAAC,IAAI,CAAC;IACzFY,aAAa,GAAG,sBAAsBE,cAAc,cAAc;EACpE,CAAC,MAAM;IACLF,aAAa,GAAG,EAAE;EACpB;;EAEA;EACA,IAAIG,YAAY,GAAG,qBAAqB;EACxCA,YAAY,IAAI,kBAAkBtC,aAAa,KAAK;EACpD,IAAIC,UAAU,KAAKD,aAAa,EAAE;IAChCsC,YAAY,IAAI,8BAA8BrC,UAAU,KAAK;EAC/D;EACAqC,YAAY,IAAIH,aAAa;EAE7B,MAAMI,gBAAgB,GAAGL,YAAY,CAACT,GAAG,CAACe,CAAC,IAAI,KAAKA,CAAC,EAAE,CAAC,CAACjB,IAAI,CAAC,KAAK,CAAC;EAEpE,IAAIlB,gBAAgB,EAAE;IACpB;IACA;IACA;IACAC,MAAM,IAAI,OAAO;IACjBA,MAAM,IAAI,4EAA4E;IACtFA,MAAM,IAAI,iEAAiE;IAC3EA,MAAM,IAAI,OAAO;IACjBA,MAAM,IAAI,mFAAmF;IAC7FA,MAAM,IAAI,cAAc;IACxBA,MAAM,IAAI,GAAGiC,gBAAgB,KAAK;IAClCjC,MAAM,IAAIgC,YAAY;IACtBhC,MAAM,IAAI,0DAA0D;IACpEA,MAAM,IAAI,UAAU;IACpBA,MAAM,IAAI,QAAQ;IAClBA,MAAM,IAAI,OAAO;IACjBA,MAAM,IAAI,iEAAiE;EAC7E,CAAC,MAAM;IACL;IACAA,MAAM,IAAI,kCAAkC;IAC5CA,MAAM,IAAI,GAAGiC,gBAAgB,KAAK;IAClC;IACAjC,MAAM,IAAIgC,YAAY,CAACG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;IAC/CnC,MAAM,IAAI,QAAQ;IAClBA,MAAM,IAAI,0CAA0C;IACpDA,MAAM,IAAI,qDAAqD;EACjE;EAEA,OAAO;IAAEoC,UAAU,EAAEpC;EAAO,CAAC;AAC/B","ignoreList":[]}
+{"version":3,"file":"generateModelMetadataFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","findExternalRefType","chainNeedsUpgradeFns","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","needsUpgradeFns","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 { chainNeedsUpgradeFns, 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 needsUpgradeFns = chainNeedsUpgradeFns(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 (needsUpgradeFns) 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 (needsUpgradeFns) {\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 (needsUpgradeFns) {\n    // Factory form: schema has at least one derived field or required additive\n    // field, so the runtime requires the app to supply typed upgrade functions.\n    // The factory makes this a compile-time requirement — apps can't get a\n    // 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 fields added past v1.\\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 field added past v1 needs lens treatment, so no upgrade\n    // 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":[]}

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

@@ -50,7 +50,7 @@ export function generateScopeFromChain(resolved, minSupportedVersion) {
   let output = GENERATED_FILE_HEADER;
 
   // Import model-types
-  output += `import type { DocumentRef, RecordId, RecordRef } from "@palantir/pack.document-schema.model-types";\n`;
+  output += `import type { DocumentRef, EditDescription, PresencePublishOptions, RecordId, RecordRef } from "@palantir/pack.document-schema.model-types";\n`;
 
   // Import model types from models.ts
   const modelImports = allModelNames.map(n => modelName(n));
@@ -105,6 +105,18 @@ export function generateScopeFromChain(resolved, minSupportedVersion) {
       const readType = versionedTypeName(modelKey, version);
       output += `  setRecord(model: typeof ${modelName(modelKey)}, id: RecordId, data: ${readType}): Promise<void>;\n`;
     }
+
+    // custom presence overloads
+    for (const [modelKey] of Object.entries(ir.models)) {
+      const readType = versionedTypeName(modelKey, version);
+      output += `  updateCustomPresence(model: typeof ${modelName(modelKey)}, data: ${readType}, options?: PresencePublishOptions): void;\n`;
+    }
+
+    // custom activity description overloads
+    for (const [modelKey] of Object.entries(ir.models)) {
+      const readType = versionedTypeName(modelKey, version);
+      output += `  describeEdit(model: typeof ${modelName(modelKey)}, data: ${readType}): EditDescription<typeof ${modelName(modelKey)}>;\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    // 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":[]}
+{"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, EditDescription, PresencePublishOptions, 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    // custom presence overloads\n    for (const [modelKey] of Object.entries(ir.models)) {\n      const readType = versionedTypeName(modelKey, version);\n      output += `  updateCustomPresence(model: typeof ${\n        modelName(modelKey)\n      }, data: ${readType}, options?: PresencePublishOptions): void;\\n`;\n    }\n\n    // custom activity description overloads\n    for (const [modelKey] of Object.entries(ir.models)) {\n      const readType = versionedTypeName(modelKey, version);\n      output += `  describeEdit(model: typeof ${\n        modelName(modelKey)\n      }, data: ${readType}): EditDescription<typeof ${modelName(modelKey)}>;\\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/resolveSchemaChain.js

@@ -121,6 +121,15 @@ export function resolveMinVersion(chain, minSupportedVersion) {
     minVersion: minSupportedVersion ?? latestVersion
   };
 }
+function capVersionedIrChain(chain, maxVersion) {
+  if (maxVersion == null) {
+    return chain;
+  }
+  if (!chain.some(c => c.version === maxVersion)) {
+    throw new Error(`maxVersion ${maxVersion} is not in the schema chain ` + `(available versions: ${chain.map(c => c.version).join(", ")})`);
+  }
+  return chain.filter(c => c.version <= maxVersion);
+}
 
 /**
  * Collect the version chain and resolve min/latest versions.
@@ -130,8 +139,8 @@ export function resolveMinVersion(chain, minSupportedVersion) {
  * defaults.
  * Throws on empty chain or invalid minSupportedVersion.
  */
-export function resolveSchemaChain(schema, minSupportedVersion, identity = {}) {
-  const chain = collectVersionedIrChain(schema, identity);
+export function resolveSchemaChain(schema, minSupportedVersion, identity = {}, maxVersion) {
+  const chain = capVersionedIrChain(collectVersionedIrChain(schema, identity), maxVersion);
   const {
     latestVersion,
     minVersion
@@ -182,16 +191,33 @@ export function stripDeprecatedFieldsForSdk(chain) {
 }
 
 /**
- * True if any migration in the chain declares a non-empty `derivedFrom`. Drives
- * whether the generated SDK emits `DocumentModel` as a factory (requires the
- * app to supply typed upgrade functions) or as a const (no upgrade functions needed).
+ * True if the chain has any field that requires a runtime upgrade function.
+ * Drives whether the generated SDK emits `DocumentModel` as a factory
+ * (requires the app to supply typed upgrade functions) or as a const.
+ *
+ * Two cases trigger this:
+ *  - A field declares `derivedFrom` with one or more source fields — the app
+ *    must supply a forward function.
+ *  - A required field is added in a version past v1 (no `derivedFrom`) — the
+ *    app must supply a zero-arg thunk; `undefined` is not a legal value.
+ *
+ * Optional additive fields don't trigger it; the lens leaves them alone.
  */
-export function chainHasDerivedFields(chain) {
-  for (const entry of chain) {
-    if (entry.migrations == null) continue;
-    for (const recordMigrations of Object.values(entry.migrations)) {
-      for (const fieldMigration of Object.values(recordMigrations)) {
-        if (fieldMigration.derivedFrom.length > 0) return true;
+export function chainNeedsUpgradeFns(chain) {
+  for (let i = 1; i < chain.length; i++) {
+    const prevEntry = chain[i - 1];
+    const currEntry = chain[i];
+    for (const [modelKey, currModelDef] of Object.entries(currEntry.ir.models)) {
+      if (currModelDef.type !== "record") continue;
+      const prevModelDef = prevEntry.ir.models[modelKey];
+      if (prevModelDef == null || prevModelDef.type !== "record") continue;
+      const prevFields = new Set(prevModelDef.record.fields.map(f => f.key));
+      const recordMigrations = currEntry.migrations?.[modelKey];
+      for (const field of currModelDef.record.fields) {
+        if (prevFields.has(field.key)) continue;
+        const derivedFrom = recordMigrations?.[field.key]?.derivedFrom ?? [];
+        if (derivedFrom.length > 0) return true;
+        if (field.isOptional !== true) return true;
       }
     }
   }

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

@@ -1 +1 @@
-{"version":3,"file":"resolveSchemaChain.js","names":["IModelDef","IModelDefCtor","convertSchemaToIr","collectVersionedIrChain","input","identity","schemas","collectSchemaDefinitions","provenances","deriveProvenance","map","schema","index","version","ir","models","name","description","type","migrations","serializeMigrations","current","unshift","previous","firstModelVersions","Map","firstFieldVersions","modelVersions","fieldVersions","modelKey","modelDef","Object","entries","has","set","get","fieldVersionsForModel","fields","fieldKey","keys","length","deprecations","undefined","result","fieldEntries","fieldName","migration","derivedFrom","resolveMinVersion","chain","minSupportedVersion","Error","latestVersion","some","c","join","minVersion","resolveSchemaChain","stripDeprecatedFieldsForSdk","entry","record","filter","field","dep","metadata","deprecatedFromVersion","chainHasDerivedFields","recordMigrations","values","fieldMigration"],"sources":["resolveSchemaChain.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, VersionMigrations } from \"@palantir/pack.schema\";\nimport type {\n  IModelDef,\n  IRealTimeDocumentSchema,\n} from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { IModelDef as IModelDefCtor } from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport type { SchemaProvenance } from \"../steps/convertStepsToIr.js\";\nimport { convertSchemaToIr } from \"../steps/convertStepsToIr.js\";\n\n/** JSON-serializable form of a single field migration. */\nexport interface SerializedFieldMigration {\n  readonly derivedFrom: readonly string[];\n}\n\n/** Serialized migrations keyed by `[recordModelName][fieldName]`. */\nexport type SerializedVersionMigrations = Record<\n  string,\n  Record<string, SerializedFieldMigration>\n>;\n\nexport interface VersionedIrEntry {\n  version: number;\n  ir: IRealTimeDocumentSchema;\n  migrations?: SerializedVersionMigrations;\n}\n\nexport interface ResolvedIrChain {\n  chain: VersionedIrEntry[];\n  latestVersion: number;\n  minVersion: number;\n}\n\nexport interface IrChainPayload {\n  __comment?: string;\n  latestVersion: number;\n  minSupportedVersion?: number;\n  chain: VersionedIrEntry[];\n}\n\nexport interface SchemaIdentity {\n  readonly name?: string;\n  readonly description?: string;\n}\n\nfunction collectVersionedIrChain(\n  input: SchemaDefinition,\n  identity: SchemaIdentity,\n): VersionedIrEntry[] {\n  const schemas = collectSchemaDefinitions(input);\n  const provenances = deriveProvenance(schemas);\n\n  return schemas.map((schema, index): VersionedIrEntry => ({\n    version: schema.version,\n    ir: convertSchemaToIr(\n      schema.models,\n      { version: schema.version, name: identity.name, description: identity.description },\n      provenances[index]!,\n    ),\n    ...(schema.type === \"versioned\" ? { migrations: serializeMigrations(schema.migrations) } : {}),\n  }));\n}\n\nfunction collectSchemaDefinitions(input: SchemaDefinition): SchemaDefinition[] {\n  const schemas: SchemaDefinition[] = [];\n  let current: SchemaDefinition = input;\n\n  while (current.type === \"versioned\") {\n    schemas.unshift(current);\n    current = current.previous;\n  }\n  schemas.unshift(current);\n\n  return schemas;\n}\n\n/**\n * Build field/model provenance by walking the version chain from oldest to\n * newest. The first version where a model key or record field appears is the\n * version stamped into IR metadata.\n */\nfunction deriveProvenance(schemas: readonly SchemaDefinition[]): SchemaProvenance[] {\n  const firstModelVersions = new Map<string, number>();\n  const firstFieldVersions = new Map<string, Map<string, number>>();\n\n  return schemas.map(schema => {\n    const modelVersions: Record<string, number> = {};\n    const fieldVersions: Record<string, Record<string, number>> = {};\n\n    for (const [modelKey, modelDef] of Object.entries(schema.models)) {\n      if (!firstModelVersions.has(modelKey)) {\n        firstModelVersions.set(modelKey, schema.version);\n      }\n      modelVersions[modelKey] = firstModelVersions.get(modelKey)!;\n\n      if (modelDef.type !== \"record\") continue;\n\n      let fieldVersionsForModel = firstFieldVersions.get(modelKey);\n      if (fieldVersionsForModel == null) {\n        fieldVersionsForModel = new Map<string, number>();\n        firstFieldVersions.set(modelKey, fieldVersionsForModel);\n      }\n\n      const fields: Record<string, number> = {};\n      for (const fieldKey of Object.keys(modelDef.fields)) {\n        if (!fieldVersionsForModel.has(fieldKey)) {\n          fieldVersionsForModel.set(fieldKey, schema.version);\n        }\n        fields[fieldKey] = fieldVersionsForModel.get(fieldKey)!;\n      }\n\n      if (Object.keys(fields).length > 0) {\n        fieldVersions[modelKey] = fields;\n      }\n    }\n\n    return {\n      fieldVersions,\n      modelVersions,\n      deprecations: \"deprecations\" in schema ? schema.deprecations : undefined,\n    };\n  });\n}\n\n/** Convert schema-builder migrations to their JSON-serializable form. */\nfunction serializeMigrations(\n  migrations: VersionMigrations | undefined,\n): SerializedVersionMigrations | undefined {\n  if (migrations == null) return undefined;\n  const result: SerializedVersionMigrations = {};\n  for (const [modelKey, fields] of Object.entries(migrations)) {\n    const fieldEntries: Record<string, SerializedFieldMigration> = {};\n    for (const [fieldName, migration] of Object.entries(fields)) {\n      fieldEntries[fieldName] = {\n        derivedFrom: [...migration.derivedFrom],\n      };\n    }\n    result[modelKey] = fieldEntries;\n  }\n  return result;\n}\n\n/**\n * Validate `minSupportedVersion` against an already-resolved chain and return\n * the effective `minVersion`. Throws on invalid input.\n */\nexport function resolveMinVersion(\n  chain: VersionedIrEntry[],\n  minSupportedVersion: number | undefined,\n): { latestVersion: number; minVersion: number } {\n  if (chain.length === 0) {\n    throw new Error(\"Schema version chain is empty\");\n  }\n\n  const latestVersion = chain[chain.length - 1]!.version;\n\n  if (minSupportedVersion != null && !chain.some(c => c.version === minSupportedVersion)) {\n    throw new Error(\n      `minSupportedVersion ${minSupportedVersion} is not in the schema chain `\n        + `(available versions: ${chain.map(c => c.version).join(\", \")})`,\n    );\n  }\n\n  return {\n    latestVersion,\n    minVersion: minSupportedVersion ?? latestVersion,\n  };\n}\n\n/**\n * Collect the version chain and resolve min/latest versions.\n * Each version's models are converted to IR (IRealTimeDocumentSchema).\n * `identity.name` / `identity.description` are embedded into each chain entry's\n * IR; when omitted (e.g. test callers), `convertSchemaToIr` falls back to its\n * defaults.\n * Throws on empty chain or invalid minSupportedVersion.\n */\nexport function resolveSchemaChain(\n  schema: SchemaDefinition,\n  minSupportedVersion?: number,\n  identity: SchemaIdentity = {},\n): ResolvedIrChain {\n  const chain = collectVersionedIrChain(schema, identity);\n  const { latestVersion, minVersion } = resolveMinVersion(chain, minSupportedVersion);\n  return { chain, latestVersion, minVersion };\n}\n\n/**\n * Return a copy of the chain with deprecated fields removed from every version\n * at or after the version in which they were deprecated.\n *\n * The SDK type generators (`writeAllSdkFiles` and friends) must treat a\n * deprecated field exactly as a removed field: it disappears from that version's\n * public read/write types and per-version internal types, and the prev/curr diff\n * records it as a `removedField` (driving the upgrade lens). The field is still\n * collected into the all-versions `__Internal` type from earlier versions, which\n * are left untouched.\n */\nexport function stripDeprecatedFieldsForSdk(chain: VersionedIrEntry[]): VersionedIrEntry[] {\n  return chain.map((entry): VersionedIrEntry => {\n    const models: Record<string, IModelDef> = {};\n    for (const [modelKey, modelDef] of Object.entries(entry.ir.models)) {\n      if (modelDef.type === \"record\") {\n        const fields = modelDef.record.fields.filter(field => {\n          const dep = field.metadata.deprecatedFromVersion;\n          return dep == null || entry.version < dep;\n        });\n        models[modelKey] = IModelDefCtor.record({ ...modelDef.record, fields });\n      } else {\n        models[modelKey] = modelDef;\n      }\n    }\n    return { ...entry, ir: { ...entry.ir, models } };\n  });\n}\n\n/**\n * True if any migration in the chain declares a non-empty `derivedFrom`. Drives\n * whether the generated SDK emits `DocumentModel` as a factory (requires the\n * app to supply typed upgrade functions) or as a const (no upgrade functions needed).\n */\nexport function chainHasDerivedFields(chain: VersionedIrEntry[]): boolean {\n  for (const entry of chain) {\n    if (entry.migrations == null) continue;\n    for (const recordMigrations of Object.values(entry.migrations)) {\n      for (const fieldMigration of Object.values(recordMigrations)) {\n        if (fieldMigration.derivedFrom.length > 0) return true;\n      }\n    }\n  }\n  return false;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"resolveSchemaChain.js","names":["IModelDef","IModelDefCtor","convertSchemaToIr","collectVersionedIrChain","input","identity","schemas","collectSchemaDefinitions","provenances","deriveProvenance","map","schema","index","version","ir","models","name","description","type","migrations","serializeMigrations","current","unshift","previous","firstModelVersions","Map","firstFieldVersions","modelVersions","fieldVersions","modelKey","modelDef","Object","entries","has","set","get","fieldVersionsForModel","fields","fieldKey","keys","length","deprecations","undefined","result","fieldEntries","fieldName","migration","derivedFrom","resolveMinVersion","chain","minSupportedVersion","Error","latestVersion","some","c","join","minVersion","capVersionedIrChain","maxVersion","filter","resolveSchemaChain","stripDeprecatedFieldsForSdk","entry","record","field","dep","metadata","deprecatedFromVersion","chainNeedsUpgradeFns","i","prevEntry","currEntry","currModelDef","prevModelDef","prevFields","Set","f","key","recordMigrations","isOptional"],"sources":["resolveSchemaChain.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, VersionMigrations } from \"@palantir/pack.schema\";\nimport type {\n  IModelDef,\n  IRealTimeDocumentSchema,\n} from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { IModelDef as IModelDefCtor } from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport type { SchemaProvenance } from \"../steps/convertStepsToIr.js\";\nimport { convertSchemaToIr } from \"../steps/convertStepsToIr.js\";\n\n/** JSON-serializable form of a single field migration. */\nexport interface SerializedFieldMigration {\n  readonly derivedFrom: readonly string[];\n}\n\n/** Serialized migrations keyed by `[recordModelName][fieldName]`. */\nexport type SerializedVersionMigrations = Record<\n  string,\n  Record<string, SerializedFieldMigration>\n>;\n\nexport interface VersionedIrEntry {\n  version: number;\n  ir: IRealTimeDocumentSchema;\n  migrations?: SerializedVersionMigrations;\n}\n\nexport interface ResolvedIrChain {\n  chain: VersionedIrEntry[];\n  latestVersion: number;\n  minVersion: number;\n}\n\nexport interface IrChainPayload {\n  __comment?: string;\n  latestVersion: number;\n  minSupportedVersion?: number;\n  chain: VersionedIrEntry[];\n}\n\nexport interface SchemaIdentity {\n  readonly name?: string;\n  readonly description?: string;\n}\n\nfunction collectVersionedIrChain(\n  input: SchemaDefinition,\n  identity: SchemaIdentity,\n): VersionedIrEntry[] {\n  const schemas = collectSchemaDefinitions(input);\n  const provenances = deriveProvenance(schemas);\n\n  return schemas.map((schema, index): VersionedIrEntry => ({\n    version: schema.version,\n    ir: convertSchemaToIr(\n      schema.models,\n      { version: schema.version, name: identity.name, description: identity.description },\n      provenances[index]!,\n    ),\n    ...(schema.type === \"versioned\" ? { migrations: serializeMigrations(schema.migrations) } : {}),\n  }));\n}\n\nfunction collectSchemaDefinitions(input: SchemaDefinition): SchemaDefinition[] {\n  const schemas: SchemaDefinition[] = [];\n  let current: SchemaDefinition = input;\n\n  while (current.type === \"versioned\") {\n    schemas.unshift(current);\n    current = current.previous;\n  }\n  schemas.unshift(current);\n\n  return schemas;\n}\n\n/**\n * Build field/model provenance by walking the version chain from oldest to\n * newest. The first version where a model key or record field appears is the\n * version stamped into IR metadata.\n */\nfunction deriveProvenance(schemas: readonly SchemaDefinition[]): SchemaProvenance[] {\n  const firstModelVersions = new Map<string, number>();\n  const firstFieldVersions = new Map<string, Map<string, number>>();\n\n  return schemas.map(schema => {\n    const modelVersions: Record<string, number> = {};\n    const fieldVersions: Record<string, Record<string, number>> = {};\n\n    for (const [modelKey, modelDef] of Object.entries(schema.models)) {\n      if (!firstModelVersions.has(modelKey)) {\n        firstModelVersions.set(modelKey, schema.version);\n      }\n      modelVersions[modelKey] = firstModelVersions.get(modelKey)!;\n\n      if (modelDef.type !== \"record\") continue;\n\n      let fieldVersionsForModel = firstFieldVersions.get(modelKey);\n      if (fieldVersionsForModel == null) {\n        fieldVersionsForModel = new Map<string, number>();\n        firstFieldVersions.set(modelKey, fieldVersionsForModel);\n      }\n\n      const fields: Record<string, number> = {};\n      for (const fieldKey of Object.keys(modelDef.fields)) {\n        if (!fieldVersionsForModel.has(fieldKey)) {\n          fieldVersionsForModel.set(fieldKey, schema.version);\n        }\n        fields[fieldKey] = fieldVersionsForModel.get(fieldKey)!;\n      }\n\n      if (Object.keys(fields).length > 0) {\n        fieldVersions[modelKey] = fields;\n      }\n    }\n\n    return {\n      fieldVersions,\n      modelVersions,\n      deprecations: \"deprecations\" in schema ? schema.deprecations : undefined,\n    };\n  });\n}\n\n/** Convert schema-builder migrations to their JSON-serializable form. */\nfunction serializeMigrations(\n  migrations: VersionMigrations | undefined,\n): SerializedVersionMigrations | undefined {\n  if (migrations == null) return undefined;\n  const result: SerializedVersionMigrations = {};\n  for (const [modelKey, fields] of Object.entries(migrations)) {\n    const fieldEntries: Record<string, SerializedFieldMigration> = {};\n    for (const [fieldName, migration] of Object.entries(fields)) {\n      fieldEntries[fieldName] = {\n        derivedFrom: [...migration.derivedFrom],\n      };\n    }\n    result[modelKey] = fieldEntries;\n  }\n  return result;\n}\n\n/**\n * Validate `minSupportedVersion` against an already-resolved chain and return\n * the effective `minVersion`. Throws on invalid input.\n */\nexport function resolveMinVersion(\n  chain: VersionedIrEntry[],\n  minSupportedVersion: number | undefined,\n): { latestVersion: number; minVersion: number } {\n  if (chain.length === 0) {\n    throw new Error(\"Schema version chain is empty\");\n  }\n\n  const latestVersion = chain[chain.length - 1]!.version;\n\n  if (minSupportedVersion != null && !chain.some(c => c.version === minSupportedVersion)) {\n    throw new Error(\n      `minSupportedVersion ${minSupportedVersion} is not in the schema chain `\n        + `(available versions: ${chain.map(c => c.version).join(\", \")})`,\n    );\n  }\n\n  return {\n    latestVersion,\n    minVersion: minSupportedVersion ?? latestVersion,\n  };\n}\n\nfunction capVersionedIrChain(\n  chain: VersionedIrEntry[],\n  maxVersion: number | undefined,\n): VersionedIrEntry[] {\n  if (maxVersion == null) {\n    return chain;\n  }\n\n  if (!chain.some(c => c.version === maxVersion)) {\n    throw new Error(\n      `maxVersion ${maxVersion} is not in the schema chain `\n        + `(available versions: ${chain.map(c => c.version).join(\", \")})`,\n    );\n  }\n\n  return chain.filter(c => c.version <= maxVersion);\n}\n\n/**\n * Collect the version chain and resolve min/latest versions.\n * Each version's models are converted to IR (IRealTimeDocumentSchema).\n * `identity.name` / `identity.description` are embedded into each chain entry's\n * IR; when omitted (e.g. test callers), `convertSchemaToIr` falls back to its\n * defaults.\n * Throws on empty chain or invalid minSupportedVersion.\n */\nexport function resolveSchemaChain(\n  schema: SchemaDefinition,\n  minSupportedVersion?: number,\n  identity: SchemaIdentity = {},\n  maxVersion?: number,\n): ResolvedIrChain {\n  const chain = capVersionedIrChain(collectVersionedIrChain(schema, identity), maxVersion);\n  const { latestVersion, minVersion } = resolveMinVersion(chain, minSupportedVersion);\n  return { chain, latestVersion, minVersion };\n}\n\n/**\n * Return a copy of the chain with deprecated fields removed from every version\n * at or after the version in which they were deprecated.\n *\n * The SDK type generators (`writeAllSdkFiles` and friends) must treat a\n * deprecated field exactly as a removed field: it disappears from that version's\n * public read/write types and per-version internal types, and the prev/curr diff\n * records it as a `removedField` (driving the upgrade lens). The field is still\n * collected into the all-versions `__Internal` type from earlier versions, which\n * are left untouched.\n */\nexport function stripDeprecatedFieldsForSdk(chain: VersionedIrEntry[]): VersionedIrEntry[] {\n  return chain.map((entry): VersionedIrEntry => {\n    const models: Record<string, IModelDef> = {};\n    for (const [modelKey, modelDef] of Object.entries(entry.ir.models)) {\n      if (modelDef.type === \"record\") {\n        const fields = modelDef.record.fields.filter(field => {\n          const dep = field.metadata.deprecatedFromVersion;\n          return dep == null || entry.version < dep;\n        });\n        models[modelKey] = IModelDefCtor.record({ ...modelDef.record, fields });\n      } else {\n        models[modelKey] = modelDef;\n      }\n    }\n    return { ...entry, ir: { ...entry.ir, models } };\n  });\n}\n\n/**\n * True if the chain has any field that requires a runtime upgrade function.\n * Drives whether the generated SDK emits `DocumentModel` as a factory\n * (requires the app to supply typed upgrade functions) or as a const.\n *\n * Two cases trigger this:\n *  - A field declares `derivedFrom` with one or more source fields — the app\n *    must supply a forward function.\n *  - A required field is added in a version past v1 (no `derivedFrom`) — the\n *    app must supply a zero-arg thunk; `undefined` is not a legal value.\n *\n * Optional additive fields don't trigger it; the lens leaves them alone.\n */\nexport function chainNeedsUpgradeFns(chain: VersionedIrEntry[]): boolean {\n  for (let i = 1; i < chain.length; i++) {\n    const prevEntry = chain[i - 1]!;\n    const currEntry = chain[i]!;\n    for (const [modelKey, currModelDef] of Object.entries(currEntry.ir.models)) {\n      if (currModelDef.type !== \"record\") continue;\n      const prevModelDef = prevEntry.ir.models[modelKey];\n      if (prevModelDef == null || prevModelDef.type !== \"record\") continue;\n      const prevFields = new Set(prevModelDef.record.fields.map(f => f.key));\n      const recordMigrations = currEntry.migrations?.[modelKey];\n      for (const field of currModelDef.record.fields) {\n        if (prevFields.has(field.key)) continue;\n        const derivedFrom = recordMigrations?.[field.key]?.derivedFrom ?? [];\n        if (derivedFrom.length > 0) return true;\n        if (field.isOptional !== true) return true;\n      }\n    }\n  }\n  return false;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA,SAASA,SAAS,IAAIC,aAAa,QAAQ,yDAAyD;AAEpG,SAASC,iBAAiB,QAAQ,8BAA8B;;AAEhE;;AAKA;;AA8BA,SAASC,uBAAuBA,CAC9BC,KAAuB,EACvBC,QAAwB,EACJ;EACpB,MAAMC,OAAO,GAAGC,wBAAwB,CAACH,KAAK,CAAC;EAC/C,MAAMI,WAAW,GAAGC,gBAAgB,CAACH,OAAO,CAAC;EAE7C,OAAOA,OAAO,CAACI,GAAG,CAAC,CAACC,MAAM,EAAEC,KAAK,MAAwB;IACvDC,OAAO,EAAEF,MAAM,CAACE,OAAO;IACvBC,EAAE,EAAEZ,iBAAiB,CACnBS,MAAM,CAACI,MAAM,EACb;MAAEF,OAAO,EAAEF,MAAM,CAACE,OAAO;MAAEG,IAAI,EAAEX,QAAQ,CAACW,IAAI;MAAEC,WAAW,EAAEZ,QAAQ,CAACY;IAAY,CAAC,EACnFT,WAAW,CAACI,KAAK,CACnB,CAAC;IACD,IAAID,MAAM,CAACO,IAAI,KAAK,WAAW,GAAG;MAAEC,UAAU,EAAEC,mBAAmB,CAACT,MAAM,CAACQ,UAAU;IAAE,CAAC,GAAG,CAAC,CAAC;EAC/F,CAAC,CAAC,CAAC;AACL;AAEA,SAASZ,wBAAwBA,CAACH,KAAuB,EAAsB;EAC7E,MAAME,OAA2B,GAAG,EAAE;EACtC,IAAIe,OAAyB,GAAGjB,KAAK;EAErC,OAAOiB,OAAO,CAACH,IAAI,KAAK,WAAW,EAAE;IACnCZ,OAAO,CAACgB,OAAO,CAACD,OAAO,CAAC;IACxBA,OAAO,GAAGA,OAAO,CAACE,QAAQ;EAC5B;EACAjB,OAAO,CAACgB,OAAO,CAACD,OAAO,CAAC;EAExB,OAAOf,OAAO;AAChB;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASG,gBAAgBA,CAACH,OAAoC,EAAsB;EAClF,MAAMkB,kBAAkB,GAAG,IAAIC,GAAG,CAAiB,CAAC;EACpD,MAAMC,kBAAkB,GAAG,IAAID,GAAG,CAA8B,CAAC;EAEjE,OAAOnB,OAAO,CAACI,GAAG,CAACC,MAAM,IAAI;IAC3B,MAAMgB,aAAqC,GAAG,CAAC,CAAC;IAChD,MAAMC,aAAqD,GAAG,CAAC,CAAC;IAEhE,KAAK,MAAM,CAACC,QAAQ,EAAEC,QAAQ,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACrB,MAAM,CAACI,MAAM,CAAC,EAAE;MAChE,IAAI,CAACS,kBAAkB,CAACS,GAAG,CAACJ,QAAQ,CAAC,EAAE;QACrCL,kBAAkB,CAACU,GAAG,CAACL,QAAQ,EAAElB,MAAM,CAACE,OAAO,CAAC;MAClD;MACAc,aAAa,CAACE,QAAQ,CAAC,GAAGL,kBAAkB,CAACW,GAAG,CAACN,QAAQ,CAAE;MAE3D,IAAIC,QAAQ,CAACZ,IAAI,KAAK,QAAQ,EAAE;MAEhC,IAAIkB,qBAAqB,GAAGV,kBAAkB,CAACS,GAAG,CAACN,QAAQ,CAAC;MAC5D,IAAIO,qBAAqB,IAAI,IAAI,EAAE;QACjCA,qBAAqB,GAAG,IAAIX,GAAG,CAAiB,CAAC;QACjDC,kBAAkB,CAACQ,GAAG,CAACL,QAAQ,EAAEO,qBAAqB,CAAC;MACzD;MAEA,MAAMC,MAA8B,GAAG,CAAC,CAAC;MACzC,KAAK,MAAMC,QAAQ,IAAIP,MAAM,CAACQ,IAAI,CAACT,QAAQ,CAACO,MAAM,CAAC,EAAE;QACnD,IAAI,CAACD,qBAAqB,CAACH,GAAG,CAACK,QAAQ,CAAC,EAAE;UACxCF,qBAAqB,CAACF,GAAG,CAACI,QAAQ,EAAE3B,MAAM,CAACE,OAAO,CAAC;QACrD;QACAwB,MAAM,CAACC,QAAQ,CAAC,GAAGF,qBAAqB,CAACD,GAAG,CAACG,QAAQ,CAAE;MACzD;MAEA,IAAIP,MAAM,CAACQ,IAAI,CAACF,MAAM,CAAC,CAACG,MAAM,GAAG,CAAC,EAAE;QAClCZ,aAAa,CAACC,QAAQ,CAAC,GAAGQ,MAAM;MAClC;IACF;IAEA,OAAO;MACLT,aAAa;MACbD,aAAa;MACbc,YAAY,EAAE,cAAc,IAAI9B,MAAM,GAAGA,MAAM,CAAC8B,YAAY,GAAGC;IACjE,CAAC;EACH,CAAC,CAAC;AACJ;;AAEA;AACA,SAAStB,mBAAmBA,CAC1BD,UAAyC,EACA;EACzC,IAAIA,UAAU,IAAI,IAAI,EAAE,OAAOuB,SAAS;EACxC,MAAMC,MAAmC,GAAG,CAAC,CAAC;EAC9C,KAAK,MAAM,CAACd,QAAQ,EAAEQ,MAAM,CAAC,IAAIN,MAAM,CAACC,OAAO,CAACb,UAAU,CAAC,EAAE;IAC3D,MAAMyB,YAAsD,GAAG,CAAC,CAAC;IACjE,KAAK,MAAM,CAACC,SAAS,EAAEC,SAAS,CAAC,IAAIf,MAAM,CAACC,OAAO,CAACK,MAAM,CAAC,EAAE;MAC3DO,YAAY,CAACC,SAAS,CAAC,GAAG;QACxBE,WAAW,EAAE,CAAC,GAAGD,SAAS,CAACC,WAAW;MACxC,CAAC;IACH;IACAJ,MAAM,CAACd,QAAQ,CAAC,GAAGe,YAAY;EACjC;EACA,OAAOD,MAAM;AACf;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASK,iBAAiBA,CAC/BC,KAAyB,EACzBC,mBAAuC,EACQ;EAC/C,IAAID,KAAK,CAACT,MAAM,KAAK,CAAC,EAAE;IACtB,MAAM,IAAIW,KAAK,CAAC,+BAA+B,CAAC;EAClD;EAEA,MAAMC,aAAa,GAAGH,KAAK,CAACA,KAAK,CAACT,MAAM,GAAG,CAAC,CAAC,CAAE3B,OAAO;EAEtD,IAAIqC,mBAAmB,IAAI,IAAI,IAAI,CAACD,KAAK,CAACI,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACzC,OAAO,KAAKqC,mBAAmB,CAAC,EAAE;IACtF,MAAM,IAAIC,KAAK,CACb,uBAAuBD,mBAAmB,8BAA8B,GACpE,wBAAwBD,KAAK,CAACvC,GAAG,CAAC4C,CAAC,IAAIA,CAAC,CAACzC,OAAO,CAAC,CAAC0C,IAAI,CAAC,IAAI,CAAC,GAClE,CAAC;EACH;EAEA,OAAO;IACLH,aAAa;IACbI,UAAU,EAAEN,mBAAmB,IAAIE;EACrC,CAAC;AACH;AAEA,SAASK,mBAAmBA,CAC1BR,KAAyB,EACzBS,UAA8B,EACV;EACpB,IAAIA,UAAU,IAAI,IAAI,EAAE;IACtB,OAAOT,KAAK;EACd;EAEA,IAAI,CAACA,KAAK,CAACI,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACzC,OAAO,KAAK6C,UAAU,CAAC,EAAE;IAC9C,MAAM,IAAIP,KAAK,CACb,cAAcO,UAAU,8BAA8B,GAClD,wBAAwBT,KAAK,CAACvC,GAAG,CAAC4C,CAAC,IAAIA,CAAC,CAACzC,OAAO,CAAC,CAAC0C,IAAI,CAAC,IAAI,CAAC,GAClE,CAAC;EACH;EAEA,OAAON,KAAK,CAACU,MAAM,CAACL,CAAC,IAAIA,CAAC,CAACzC,OAAO,IAAI6C,UAAU,CAAC;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,kBAAkBA,CAChCjD,MAAwB,EACxBuC,mBAA4B,EAC5B7C,QAAwB,GAAG,CAAC,CAAC,EAC7BqD,UAAmB,EACF;EACjB,MAAMT,KAAK,GAAGQ,mBAAmB,CAACtD,uBAAuB,CAACQ,MAAM,EAAEN,QAAQ,CAAC,EAAEqD,UAAU,CAAC;EACxF,MAAM;IAAEN,aAAa;IAAEI;EAAW,CAAC,GAAGR,iBAAiB,CAACC,KAAK,EAAEC,mBAAmB,CAAC;EACnF,OAAO;IAAED,KAAK;IAAEG,aAAa;IAAEI;EAAW,CAAC;AAC7C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,2BAA2BA,CAACZ,KAAyB,EAAsB;EACzF,OAAOA,KAAK,CAACvC,GAAG,CAAEoD,KAAK,IAAuB;IAC5C,MAAM/C,MAAiC,GAAG,CAAC,CAAC;IAC5C,KAAK,MAAM,CAACc,QAAQ,EAAEC,QAAQ,CAAC,IAAIC,MAAM,CAACC,OAAO,CAAC8B,KAAK,CAAChD,EAAE,CAACC,MAAM,CAAC,EAAE;MAClE,IAAIe,QAAQ,CAACZ,IAAI,KAAK,QAAQ,EAAE;QAC9B,MAAMmB,MAAM,GAAGP,QAAQ,CAACiC,MAAM,CAAC1B,MAAM,CAACsB,MAAM,CAACK,KAAK,IAAI;UACpD,MAAMC,GAAG,GAAGD,KAAK,CAACE,QAAQ,CAACC,qBAAqB;UAChD,OAAOF,GAAG,IAAI,IAAI,IAAIH,KAAK,CAACjD,OAAO,GAAGoD,GAAG;QAC3C,CAAC,CAAC;QACFlD,MAAM,CAACc,QAAQ,CAAC,GAAG5B,aAAa,CAAC8D,MAAM,CAAC;UAAE,GAAGjC,QAAQ,CAACiC,MAAM;UAAE1B;QAAO,CAAC,CAAC;MACzE,CAAC,MAAM;QACLtB,MAAM,CAACc,QAAQ,CAAC,GAAGC,QAAQ;MAC7B;IACF;IACA,OAAO;MAAE,GAAGgC,KAAK;MAAEhD,EAAE,EAAE;QAAE,GAAGgD,KAAK,CAAChD,EAAE;QAAEC;MAAO;IAAE,CAAC;EAClD,CAAC,CAAC;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASqD,oBAAoBA,CAACnB,KAAyB,EAAW;EACvE,KAAK,IAAIoB,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGpB,KAAK,CAACT,MAAM,EAAE6B,CAAC,EAAE,EAAE;IACrC,MAAMC,SAAS,GAAGrB,KAAK,CAACoB,CAAC,GAAG,CAAC,CAAE;IAC/B,MAAME,SAAS,GAAGtB,KAAK,CAACoB,CAAC,CAAE;IAC3B,KAAK,MAAM,CAACxC,QAAQ,EAAE2C,YAAY,CAAC,IAAIzC,MAAM,CAACC,OAAO,CAACuC,SAAS,CAACzD,EAAE,CAACC,MAAM,CAAC,EAAE;MAC1E,IAAIyD,YAAY,CAACtD,IAAI,KAAK,QAAQ,EAAE;MACpC,MAAMuD,YAAY,GAAGH,SAAS,CAACxD,EAAE,CAACC,MAAM,CAACc,QAAQ,CAAC;MAClD,IAAI4C,YAAY,IAAI,IAAI,IAAIA,YAAY,CAACvD,IAAI,KAAK,QAAQ,EAAE;MAC5D,MAAMwD,UAAU,GAAG,IAAIC,GAAG,CAACF,YAAY,CAACV,MAAM,CAAC1B,MAAM,CAAC3B,GAAG,CAACkE,CAAC,IAAIA,CAAC,CAACC,GAAG,CAAC,CAAC;MACtE,MAAMC,gBAAgB,GAAGP,SAAS,CAACpD,UAAU,GAAGU,QAAQ,CAAC;MACzD,KAAK,MAAMmC,KAAK,IAAIQ,YAAY,CAACT,MAAM,CAAC1B,MAAM,EAAE;QAC9C,IAAIqC,UAAU,CAACzC,GAAG,CAAC+B,KAAK,CAACa,GAAG,CAAC,EAAE;QAC/B,MAAM9B,WAAW,GAAG+B,gBAAgB,GAAGd,KAAK,CAACa,GAAG,CAAC,EAAE9B,WAAW,IAAI,EAAE;QACpE,IAAIA,WAAW,CAACP,MAAM,GAAG,CAAC,EAAE,OAAO,IAAI;QACvC,IAAIwB,KAAK,CAACe,UAAU,KAAK,IAAI,EAAE,OAAO,IAAI;MAC5C;IACF;EACF;EACA,OAAO,KAAK;AACd","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/arrayFields.js.map

@@ -1 +1 @@
-{"version":3,"file":"arrayFields.js","names":[],"sources":["arrayFields.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */\n\n\nexport interface Container {\n  readonly items: readonly string[];\n  readonly numbers: readonly number[];\n}\n\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"arrayFields.js","names":[],"sources":["arrayFields.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */\n\n\nexport interface Container {\n  readonly items: readonly string[];\n  readonly numbers: readonly number[];\n}\n\n"],"mappings":"","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/customDiscriminant.js

@@ -1,4 +1,4 @@
-/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */
+/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */
 
 /**
  * A cat

package/build/esm/utils/steps/__tests__/__snapshots__/types/customDiscriminant.js.map

@@ -1 +1 @@
-{"version":3,"file":"customDiscriminant.js","names":["isAnimalCat","value","kind","isAnimalDog"],"sources":["customDiscriminant.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */\n\n\n/**\n * A cat\n */\nexport interface Cat {\n  readonly meow: string;\n  readonly whiskers: number;\n}\n\n/**\n * A dog\n */\nexport interface Dog {\n  readonly bark: string;\n  readonly tailWags: number;\n}\n\nexport interface AnimalCat extends Cat {\n  readonly kind: \"cat\";\n}\n\nexport interface AnimalDog extends Dog {\n  readonly kind: \"dog\";\n}\n\nexport type Animal = AnimalCat | AnimalDog;\n\nexport function isAnimalCat(value: Animal): value is AnimalCat {\n  return value.kind === \"cat\";\n}\n\nexport function isAnimalDog(value: Animal): value is AnimalDog {\n  return value.kind === \"dog\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAgBA,OAAO,SAASA,WAAWA,CAACC,KAAa,EAAsB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,KAAK;AAC7B;AAEA,OAAO,SAASC,WAAWA,CAACF,KAAa,EAAsB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,KAAK;AAC7B","ignoreList":[]}
+{"version":3,"file":"customDiscriminant.js","names":["isAnimalCat","value","kind","isAnimalDog"],"sources":["customDiscriminant.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */\n\n\n/**\n * A cat\n */\nexport interface Cat {\n  readonly meow: string;\n  readonly whiskers: number;\n}\n\n/**\n * A dog\n */\nexport interface Dog {\n  readonly bark: string;\n  readonly tailWags: number;\n}\n\nexport interface AnimalCat extends Cat {\n  readonly kind: \"cat\";\n}\n\nexport interface AnimalDog extends Dog {\n  readonly kind: \"dog\";\n}\n\nexport type Animal = AnimalCat | AnimalDog;\n\nexport function isAnimalCat(value: Animal): value is AnimalCat {\n  return value.kind === \"cat\";\n}\n\nexport function isAnimalDog(value: Animal): value is AnimalDog {\n  return value.kind === \"dog\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAgBA,OAAO,SAASA,WAAWA,CAACC,KAAa,EAAsB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,KAAK;AAC7B;AAEA,OAAO,SAASC,WAAWA,CAACF,KAAa,EAAsB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,KAAK;AAC7B","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/generateTypeScriptInterfaces.js

@@ -1,4 +1,4 @@
-/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */
+/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */
 
 /**
  * Represents an edge in a graph

package/build/esm/utils/steps/__tests__/__snapshots__/types/generateTypeScriptInterfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateTypeScriptInterfaces.js","names":["isNodeObject","value","type","isNodeTextBox"],"sources":["generateTypeScriptInterfaces.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */\n\n\n/**\n * Represents an edge in a graph\n */\nexport interface Edge {\n  readonly source: ObjectNode;\n  readonly target: ObjectNode;\n}\n\nexport interface ObjectNode {\n  readonly x: number;\n  readonly y: number;\n  readonly label?: string;\n  readonly color?: string;\n}\n\n/**\n * Represents a text box in a graph\n */\nexport interface TextBox {\n  readonly x: number;\n  readonly y: number;\n  readonly text: string;\n}\n\nexport interface NodeObject extends ObjectNode {\n  readonly type: \"object\";\n}\n\nexport interface NodeTextBox extends TextBox {\n  readonly type: \"text-box\";\n}\n\nexport type Node = NodeObject | NodeTextBox;\n\nexport function isNodeObject(value: Node): value is NodeObject {\n  return value.type === \"object\";\n}\n\nexport function isNodeTextBox(value: Node): value is NodeTextBox {\n  return value.type === \"text-box\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AAaA;AACA;AACA;;AAiBA,OAAO,SAASA,YAAYA,CAACC,KAAW,EAAuB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ;AAChC;AAEA,OAAO,SAASC,aAAaA,CAACF,KAAW,EAAwB;EAC/D,OAAOA,KAAK,CAACC,IAAI,KAAK,UAAU;AAClC","ignoreList":[]}
+{"version":3,"file":"generateTypeScriptInterfaces.js","names":["isNodeObject","value","type","isNodeTextBox"],"sources":["generateTypeScriptInterfaces.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */\n\n\n/**\n * Represents an edge in a graph\n */\nexport interface Edge {\n  readonly source: ObjectNode;\n  readonly target: ObjectNode;\n}\n\nexport interface ObjectNode {\n  readonly x: number;\n  readonly y: number;\n  readonly label?: string;\n  readonly color?: string;\n}\n\n/**\n * Represents a text box in a graph\n */\nexport interface TextBox {\n  readonly x: number;\n  readonly y: number;\n  readonly text: string;\n}\n\nexport interface NodeObject extends ObjectNode {\n  readonly type: \"object\";\n}\n\nexport interface NodeTextBox extends TextBox {\n  readonly type: \"text-box\";\n}\n\nexport type Node = NodeObject | NodeTextBox;\n\nexport function isNodeObject(value: Node): value is NodeObject {\n  return value.type === \"object\";\n}\n\nexport function isNodeTextBox(value: Node): value is NodeTextBox {\n  return value.type === \"text-box\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AAaA;AACA;AACA;;AAiBA,OAAO,SAASA,YAAYA,CAACC,KAAW,EAAuB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ;AAChC;AAEA,OAAO,SAASC,aAAaA,CAACF,KAAW,EAAwB;EAC/D,OAAOA,KAAK,CAACC,IAAI,KAAK,UAAU;AAClC","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/refTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"refTypes.js","names":[],"sources":["refTypes.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */\n\nimport type { DocumentRef, MediaRef, ObjectRef, UserRef } from \"@palantir/pack.document-schema.model-types\";\n\n/**\n * A record containing all reference types\n */\nexport interface Document {\n  readonly id: string;\n  readonly docRef: DocumentRef;\n  readonly userRef: UserRef;\n  readonly objectRef: ObjectRef;\n  readonly mediaRef: MediaRef;\n  readonly optionalDocRef?: DocumentRef;\n  readonly docRefArray: readonly DocumentRef[];\n  readonly userRefArray: readonly UserRef[];\n}\n\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"refTypes.js","names":[],"sources":["refTypes.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */\n\nimport type { DocumentRef, MediaRef, ObjectRef, UserRef } from \"@palantir/pack.document-schema.model-types\";\n\n/**\n * A record containing all reference types\n */\nexport interface Document {\n  readonly id: string;\n  readonly docRef: DocumentRef;\n  readonly userRef: UserRef;\n  readonly objectRef: ObjectRef;\n  readonly mediaRef: MediaRef;\n  readonly optionalDocRef?: DocumentRef;\n  readonly docRefArray: readonly DocumentRef[];\n  readonly userRefArray: readonly UserRef[];\n}\n\n"],"mappings":"","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/simpleRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"simpleRecord.js","names":[],"sources":["simpleRecord.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */\n\n\n/**\n * A person record\n */\nexport interface Person {\n  readonly name: string;\n  readonly age: number;\n  readonly email?: string;\n}\n\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"simpleRecord.js","names":[],"sources":["simpleRecord.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */\n\n\n/**\n * A person record\n */\nexport interface Person {\n  readonly name: string;\n  readonly age: number;\n  readonly email?: string;\n}\n\n"],"mappings":"","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/simpleSteps.js

@@ -1,4 +1,4 @@
-/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */
+/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */
 
 /**
  * A node in the graph

package/build/esm/utils/steps/__tests__/__snapshots__/types/simpleSteps.js.map

@@ -1 +1 @@
-{"version":3,"file":"simpleSteps.js","names":["isNodeObject","value","type","isNodeTextBox"],"sources":["simpleSteps.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.13.0 */\n\n\n/**\n * A node in the graph\n */\nexport interface ObjectNode {\n  readonly x: number;\n  readonly y: number;\n  readonly object: string;\n  readonly label?: string;\n  readonly edges: readonly Edge[];\n}\n\n/**\n * A text box in the graph\n */\nexport interface TextBox {\n  readonly x: number;\n  readonly y: number;\n  readonly text: string;\n}\n\n/**\n * An edge in the graph\n */\nexport interface Edge {\n  readonly source: ObjectNode;\n  readonly target: ObjectNode;\n}\n\nexport interface NodeObject extends ObjectNode {\n  readonly type: \"object\";\n}\n\nexport interface NodeTextBox extends TextBox {\n  readonly type: \"textBox\";\n}\n\nexport type Node = NodeObject | NodeTextBox;\n\nexport function isNodeObject(value: Node): value is NodeObject {\n  return value.type === \"object\";\n}\n\nexport function isNodeTextBox(value: Node): value is NodeTextBox {\n  return value.type === \"textBox\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AASA;AACA;AACA;;AAOA;AACA;AACA;;AAgBA,OAAO,SAASA,YAAYA,CAACC,KAAW,EAAuB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ;AAChC;AAEA,OAAO,SAASC,aAAaA,CAACF,KAAW,EAAwB;EAC/D,OAAOA,KAAK,CAACC,IAAI,KAAK,SAAS;AACjC","ignoreList":[]}
+{"version":3,"file":"simpleSteps.js","names":["isNodeObject","value","type","isNodeTextBox"],"sources":["simpleSteps.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.15.0 */\n\n\n/**\n * A node in the graph\n */\nexport interface ObjectNode {\n  readonly x: number;\n  readonly y: number;\n  readonly object: string;\n  readonly label?: string;\n  readonly edges: readonly Edge[];\n}\n\n/**\n * A text box in the graph\n */\nexport interface TextBox {\n  readonly x: number;\n  readonly y: number;\n  readonly text: string;\n}\n\n/**\n * An edge in the graph\n */\nexport interface Edge {\n  readonly source: ObjectNode;\n  readonly target: ObjectNode;\n}\n\nexport interface NodeObject extends ObjectNode {\n  readonly type: \"object\";\n}\n\nexport interface NodeTextBox extends TextBox {\n  readonly type: \"textBox\";\n}\n\nexport type Node = NodeObject | NodeTextBox;\n\nexport function isNodeObject(value: Node): value is NodeObject {\n  return value.type === \"object\";\n}\n\nexport function isNodeTextBox(value: Node): value is NodeTextBox {\n  return value.type === \"textBox\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AASA;AACA;AACA;;AAOA;AACA;AACA;;AAgBA,OAAO,SAASA,YAAYA,CAACC,KAAW,EAAuB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ;AAChC;AAEA,OAAO,SAASC,aAAaA,CAACF,KAAW,EAAwB;EAC/D,OAAOA,KAAK,CAACC,IAAI,KAAK,SAAS;AACjC","ignoreList":[]}

package/build/types/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAsBA,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAcxC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAqBA,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAaxC"}

package/build/types/commands/ir/__tests__/resolveIrInput.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolveIrInput.test.d.ts.map

package/build/types/commands/ir/__tests__/resolveIrInput.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveIrInput.test.d.ts","sourceRoot":"","sources":["../../../../../src/commands/ir/__tests__/resolveIrInput.test.ts"],"names":[],"mappings":""}

package/build/types/commands/ir/irDeployHandler.d.ts

@@ -3,8 +3,14 @@ interface DeployOptions {
     readonly ir: string;
     readonly baseUrl: string;
     readonly auth: string;
-    readonly parentFolder: string;
-    readonly fileSystemType: FileSystemType;
+    readonly fileSystemType?: FileSystemType;
+    readonly firstParty?: boolean;
+    /** Required for third-party deploys. */
+    readonly parentFolder?: string;
+    /** Required for first-party deploys. */
+    readonly ontologyRid?: string;
+    /** Overrides the API prefix for first-party deploys (e.g. /api/gotham). */
+    readonly firstPartyPrefix?: string;
 }
 export declare function irDeployHandler(options: DeployOptions): Promise<void>;
 export {};

package/build/types/commands/ir/irDeployHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"irDeployHandler.d.ts","sourceRoot":"","sources":["../../../../src/commands/ir/irDeployHandler.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC3E"}
+{"version":3,"file":"irDeployHandler.d.ts","sourceRoot":"","sources":["../../../../src/commands/ir/irDeployHandler.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3E"}

package/build/types/commands/ir/irGenAssetHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"irGenAssetHandler.d.ts","sourceRoot":"","sources":["../../../../src/commands/ir/irGenAssetHandler.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,aAAa,CAAC;AAErE,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAC5C;AAwDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAmFlE"}
+{"version":3,"file":"irGenAssetHandler.d.ts","sourceRoot":"","sources":["../../../../src/commands/ir/irGenAssetHandler.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,aAAa,CAAC;AAGrE,UAAU,iBAAiB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAC5C;AAYD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CA+ElE"}

package/build/types/commands/ir/irUpdateSchemaHandler.d.ts

@@ -0,0 +1,15 @@
+interface IrUpdateSchemaOptions {
+    readonly ir: string;
+    readonly baseUrl: string;
+    readonly auth: string;
+    readonly ontologyRid: string;
+    readonly forceOverwrite?: boolean;
+    readonly firstPartyPrefix?: string;
+}
+/**
+ * Updates the schema of an existing document type from an IR file. Sources the wire schema and version directly from
+ * the IR (the same single source of truth used by `ir deploy`), avoiding a separately-generated asset file.
+ */
+export declare function irUpdateSchemaHandler(options: IrUpdateSchemaOptions): Promise<void>;
+export {};
+//# sourceMappingURL=irUpdateSchemaHandler.d.ts.map

package/build/types/commands/ir/irUpdateSchemaHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"irUpdateSchemaHandler.d.ts","sourceRoot":"","sources":["../../../../src/commands/ir/irUpdateSchemaHandler.ts"],"names":[],"mappings":"AA2BA,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DzF"}

package/build/types/commands/ir/registerIrCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registerIrCommands.d.ts","sourceRoot":"","sources":["../../../../src/commands/ir/registerIrCommands.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2EzD"}
+{"version":3,"file":"registerIrCommands.d.ts","sourceRoot":"","sources":["../../../../src/commands/ir/registerIrCommands.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsHzD"}

package/build/types/commands/ir/resolveIrInput.d.ts

@@ -0,0 +1,8 @@
+import type { IRealTimeDocumentSchema } from "../../lib/pack-docschema-api/pack-docschema-ir/index.js";
+export interface ResolvedIrInput {
+    readonly ir: IRealTimeDocumentSchema;
+    readonly latestVersion: number;
+    readonly minSupportedVersion: number;
+}
+export declare function resolveIrInput(parsed: unknown, irPath: string): ResolvedIrInput;
+//# sourceMappingURL=resolveIrInput.d.ts.map

package/build/types/commands/ir/resolveIrInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveIrInput.d.ts","sourceRoot":"","sources":["../../../../src/commands/ir/resolveIrInput.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAGvG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAuCD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAI/E"}

package/build/types/commands/schema/registerSchemaCommands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registerSchemaCommands.d.ts","sourceRoot":"","sources":["../../../../src/commands/schema/registerSchemaCommands.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsB7D"}
+{"version":3,"file":"registerSchemaCommands.d.ts","sourceRoot":"","sources":["../../../../src/commands/schema/registerSchemaCommands.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0B7D"}

package/build/types/commands/schema/schemaIrHandler.d.ts

@@ -2,6 +2,7 @@ interface SchemaIrOptions {
     input: string;
     output: string;
     config: string;
+    maxVersion?: string;
 }
 interface PackConfigValues {
     readonly documentTypeName: string;
@@ -32,9 +33,9 @@ export declare function readPackConfig(configPath: string): Promise<PackConfigVa
  *    downstream tools default to supporting only the latest schema version.
  *
  * Note: this is distinct from the legacy single-version IR JSON consumed by
- * `ir deploy` / `ir zod`, which is a bare `IRealTimeDocumentSchema` (no chain,
- * no migrations). Tools that previously read that format should pick the
- * entry matching `latestVersion` from `chain` and use its `ir` field.
+ * `ir zod`, which is a bare `IRealTimeDocumentSchema` (no chain, no migrations).
+ * Tools that previously read that format should pick the entry matching
+ * `latestVersion` from `chain` and use its `ir` field.
  */
 export declare function schemaIrHandler(options: SchemaIrOptions): Promise<void>;
 export {};

package/build/types/commands/schema/schemaIrHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemaIrHandler.d.ts","sourceRoot":"","sources":["../../../../src/commands/schema/schemaIrHandler.ts"],"names":[],"mappings":"AAuBA,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD,UAAU,gBAAgB;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAwBD,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiClF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC7E"}
+{"version":3,"file":"schemaIrHandler.d.ts","sourceRoot":"","sources":["../../../../src/commands/schema/schemaIrHandler.ts"],"names":[],"mappings":"AAuBA,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD,UAAU,gBAAgB;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAwBD,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiClF;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C7E"}