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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"convertSchemaToSteps.js","names":["yaml","convertFieldType","field","type","items","item","name","Error","convertRecordToYaml","recordDef","result","fields","docs","fieldName","fieldDef","Object","entries","fieldType","convertUnionToYaml","unionDef","variants","variantName","variantRef","discriminant","convertSchemaToSteps","schema","steps","records","unions","def","values","keys","length","push","convertStepsToYamlString","dump","flowLevel","lineWidth","noRefs","quotingType","forceQuotes","skipInvalid"],"sources":["convertSchemaToSteps.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport yaml from \"js-yaml\";\nimport type { MigrationStep, UnionDefinition } from \"../steps/parseMigrationSteps.js\";\nimport type { P } from \"./validateSchemaModule.js\";\n\nfunction convertFieldType(field: P.Type): string {\n  switch (field.type) {\n    case \"array\":\n      return `array<${convertFieldType(field.items as P.Type)}>`;\n    case \"boolean\":\n      return \"boolean\";\n    case \"docRef\":\n      return \"docRef\";\n    case \"double\":\n      return \"double\";\n    case \"mediaRef\":\n      return \"mediaRef\";\n    case \"objectRef\":\n      return \"objectRef\";\n    case \"optional\":\n      return `optional<${convertFieldType(field.item as P.Type)}>`;\n    case \"ref\":\n      return field.name;\n    case \"string\":\n      return \"string\";\n    case \"unknown\":\n      return \"unknown\";\n    case \"userRef\":\n      return \"userRef\";\n    default:\n      field satisfies never;\n      throw new Error(`Unsupported field type: ${(field as P.Type).type}`);\n  }\n}\n\nfunction convertRecordToYaml(\n  recordDef: P.RecordDef,\n): { docs?: string; fields: Record<string, string> } {\n  const result: { docs?: string; fields: Record<string, string> } = {\n    fields: {},\n  };\n\n  if (recordDef.docs) {\n    result.docs = recordDef.docs;\n  }\n\n  for (const [fieldName, fieldDef] of Object.entries(recordDef.fields)) {\n    const fieldType = convertFieldType(fieldDef);\n    result.fields[fieldName] = fieldType;\n  }\n\n  return result;\n}\n\nfunction convertUnionToYaml(unionDef: P.UnionDef): UnionDefinition {\n  const variants: Record<string, string> = {};\n\n  for (const [variantName, variantRef] of Object.entries(unionDef.variants)) {\n    variants[variantName] = variantRef.name;\n  }\n\n  const result: UnionDefinition = {\n    variants,\n  };\n\n  if (unionDef.discriminant !== \"type\") {\n    result.discriminant = unionDef.discriminant;\n  }\n\n  return result;\n}\n\nexport function convertSchemaToSteps(schema: P.ReturnedSchema): MigrationStep[] {\n  const steps: MigrationStep[] = [];\n  const records: Record<string, { docs?: string; fields: Record<string, string> }> = {};\n  const unions: Record<string, UnionDefinition> = {};\n\n  for (const def of Object.values(schema)) {\n    switch (def.type) {\n      case \"record\": {\n        records[def.name] = convertRecordToYaml(def);\n        break;\n      }\n      case \"union\": {\n        unions[def.name] = convertUnionToYaml(def);\n        break;\n      }\n    }\n  }\n\n  if (Object.keys(records).length > 0) {\n    steps.push({ \"add-records\": records });\n  }\n\n  if (Object.keys(unions).length > 0) {\n    steps.push({ \"add-union\": unions });\n  }\n\n  return steps;\n}\n\nexport function convertStepsToYamlString(steps: MigrationStep[]): string {\n  return yaml.dump(steps, {\n    flowLevel: -1,\n    lineWidth: -1,\n    noRefs: true,\n    quotingType: \"'\",\n    forceQuotes: false,\n    skipInvalid: false,\n  });\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"convertSchemaToSteps.js","names":["yaml","convertFieldType","field","type","items","item","name","Error","convertRecordToYaml","recordDef","result","fields","docs","fieldName","fieldDef","Object","entries","fieldType","convertUnionToYaml","unionDef","variants","variantName","variantRef","discriminant","convertSchemaToSteps","schema","exportKey","def","steps","records","unions","values","keys","length","push","convertStepsToYamlString","dump","flowLevel","lineWidth","noRefs","quotingType","forceQuotes","skipInvalid"],"sources":["convertSchemaToSteps.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport yaml from \"js-yaml\";\nimport type { MigrationStep, UnionDefinition } from \"../steps/parseMigrationSteps.js\";\nimport type { P } from \"./validateSchemaModule.js\";\n\nfunction convertFieldType(field: P.Type): string {\n  switch (field.type) {\n    case \"array\":\n      return `array<${convertFieldType(field.items as P.Type)}>`;\n    case \"boolean\":\n      return \"boolean\";\n    case \"docRef\":\n      return \"docRef\";\n    case \"double\":\n      return \"double\";\n    case \"mediaRef\":\n      return \"mediaRef\";\n    case \"objectRef\":\n      return \"objectRef\";\n    case \"optional\":\n      return `optional<${convertFieldType(field.item as P.Type)}>`;\n    case \"ref\":\n      return field.name;\n    case \"string\":\n      return \"string\";\n    case \"unknown\":\n      return \"unknown\";\n    case \"userRef\":\n      return \"userRef\";\n    default:\n      field satisfies never;\n      throw new Error(`Unsupported field type: ${(field as P.Type).type}`);\n  }\n}\n\nfunction convertRecordToYaml(\n  recordDef: P.RecordDef,\n): { docs?: string; fields: Record<string, string> } {\n  const result: { docs?: string; fields: Record<string, string> } = {\n    fields: {},\n  };\n\n  if (recordDef.docs) {\n    result.docs = recordDef.docs;\n  }\n\n  for (const [fieldName, fieldDef] of Object.entries(recordDef.fields)) {\n    const fieldType = convertFieldType(fieldDef);\n    result.fields[fieldName] = fieldType;\n  }\n\n  return result;\n}\n\nfunction convertUnionToYaml(unionDef: P.UnionDef): UnionDefinition {\n  const variants: Record<string, string> = {};\n\n  for (const [variantName, variantRef] of Object.entries(unionDef.variants)) {\n    variants[variantName] = variantRef.name;\n  }\n\n  const result: UnionDefinition = {\n    variants,\n  };\n\n  if (unionDef.discriminant !== \"type\") {\n    result.discriminant = unionDef.discriminant;\n  }\n\n  return result;\n}\n\nexport function convertSchemaToSteps(schema: P.ReturnedSchema): MigrationStep[] {\n  // Reject aliased schemas: the YAML step format cannot represent exportKey !== declaredName\n  for (const [exportKey, def] of Object.entries(schema)) {\n    if (exportKey !== def.name) {\n      throw new Error(\n        `Schema entry \"${exportKey}\" has declared model name \"${def.name}\". `\n          + `The migration-step YAML format cannot represent aliases (exportKey !== declaredName). `\n          + `Use the same name for both, or use the IR pipeline instead.`,\n      );\n    }\n  }\n\n  const steps: MigrationStep[] = [];\n  const records: Record<string, { docs?: string; fields: Record<string, string> }> = {};\n  const unions: Record<string, UnionDefinition> = {};\n\n  for (const def of Object.values(schema)) {\n    switch (def.type) {\n      case \"record\": {\n        records[def.name] = convertRecordToYaml(def);\n        break;\n      }\n      case \"union\": {\n        unions[def.name] = convertUnionToYaml(def);\n        break;\n      }\n    }\n  }\n\n  if (Object.keys(records).length > 0) {\n    steps.push({ \"add-records\": records });\n  }\n\n  if (Object.keys(unions).length > 0) {\n    steps.push({ \"add-union\": unions });\n  }\n\n  return steps;\n}\n\nexport function convertStepsToYamlString(steps: MigrationStep[]): string {\n  return yaml.dump(steps, {\n    flowLevel: -1,\n    lineWidth: -1,\n    noRefs: true,\n    quotingType: \"'\",\n    forceQuotes: false,\n    skipInvalid: false,\n  });\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -16,25 +16,29 @@
 
 import { formatVariantName } from "../formatVariantName.js";
 import { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
-import { resolveSchemaChain } from "./resolveSchemaChain.js";
-import { isRecordSchema, isUnionSchema, MODELS_PATH, TYPES_REEXPORT_PATH, typesFilePath, VERSIONED_DOC_REF_PATH, versionedTypeName, VERSIONS_PATH } from "./runtimeSchema.js";
+import { resolveMinVersion } from "./resolveSchemaChain.js";
+import { INTERNAL_UPGRADE_FNS_PATH, MODELS_PATH, TYPES_REEXPORT_PATH, typesFilePath, VERSIONED_DOC_REF_PATH, versionedTypeName, VERSIONS_PATH } from "./runtimeSchema.js";
 
 /**
  * Generate the index.ts barrel export from a versioned schema.
  *
  * Exports:
- * - `models.js` (star export — model constants and DocumentModel)
+ * - `models.js` (star export — model constants and `DocumentModel`; emitted
+ *   as a factory function when the schema has derived fields, otherwise a const)
  * - `types.js` (star export — latest-version type aliases)
  * - `versions.js` (star export — SupportedVersions, LatestVersion, MinSupportedVersion)
  * - `versionedDocRef.js` (star export — VersionedDocRef types and factory)
+ * - `DocumentUpgradeFns` type (the typed shape the factory accepts)
  * - Per supported version: explicit named type exports from `types_vN.js`
  *   (not star exports, to avoid polluting autocomplete for read-only consumers)
  */
-export function generateIndexFromSchema(schema, minSupportedVersion) {
+export function generateIndexFromChain(resolved, minSupportedVersion) {
+  const {
+    chain
+  } = resolved;
   const {
-    chain,
     minVersion
-  } = resolveSchemaChain(schema, minSupportedVersion);
+  } = resolveMinVersion(chain, minSupportedVersion);
   let output = GENERATED_FILE_HEADER;
 
   // Star exports for core modules
@@ -42,24 +46,27 @@ export function generateIndexFromSchema(schema, minSupportedVersion) {
   output += `export * from "${TYPES_REEXPORT_PATH}";\n`;
   output += `export * from "${VERSIONS_PATH}";\n`;
   output += `export * from "${VERSIONED_DOC_REF_PATH}";\n`;
+  // The typed upgrade-function table shape. Apps reference this type when
+  // constructing the value passed to `DocumentModel(...)`.
+  output += `export { type DocumentUpgradeFns } from "${INTERNAL_UPGRADE_FNS_PATH}";\n`;
 
   // Per-version explicit named type exports
   for (const {
     version,
-    schema: versionSchema
+    ir
   } of chain) {
     if (version < minVersion) continue;
     const typeNames = [];
-    for (const [exportName, item] of Object.entries(versionSchema)) {
-      if (isRecordSchema(item)) {
-        typeNames.push(versionedTypeName(exportName, version));
-      } else if (isUnionSchema(item)) {
-        typeNames.push(versionedTypeName(exportName, version));
+    for (const [modelKey, modelDef] of Object.entries(ir.models)) {
+      if (modelDef.type === "record") {
+        typeNames.push(versionedTypeName(modelKey, version));
+      } else if (modelDef.type === "union") {
+        typeNames.push(versionedTypeName(modelKey, version));
 
         // Union variant types
-        for (const variantName of Object.keys(item.variants)) {
+        for (const variantName of Object.keys(modelDef.union.variants)) {
           const formattedVariant = formatVariantName(variantName);
-          typeNames.push(`${versionedTypeName(exportName, version)}${formattedVariant}`);
+          typeNames.push(`${versionedTypeName(modelKey, version)}${formattedVariant}`);
         }
       }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"generateIndexFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","resolveSchemaChain","isRecordSchema","isUnionSchema","MODELS_PATH","TYPES_REEXPORT_PATH","typesFilePath","VERSIONED_DOC_REF_PATH","versionedTypeName","VERSIONS_PATH","generateIndexFromSchema","schema","minSupportedVersion","chain","minVersion","output","version","versionSchema","typeNames","exportName","item","Object","entries","push","variantName","keys","variants","formattedVariant","length","sort","join"],"sources":["generateIndexFromSchema.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { SchemaDefinition } from \"@palantir/pack.schema\";\nimport { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport { resolveSchemaChain } from \"./resolveSchemaChain.js\";\nimport {\n  isRecordSchema,\n  isUnionSchema,\n  MODELS_PATH,\n  TYPES_REEXPORT_PATH,\n  typesFilePath,\n  VERSIONED_DOC_REF_PATH,\n  versionedTypeName,\n  VERSIONS_PATH,\n} from \"./runtimeSchema.js\";\n\n/**\n * Generate the index.ts barrel export from a versioned schema.\n *\n * Exports:\n * - `models.js` (star export — model constants and DocumentModel)\n * - `types.js` (star export — latest-version type aliases)\n * - `versions.js` (star export — SupportedVersions, LatestVersion, MinSupportedVersion)\n * - `versionedDocRef.js` (star export — VersionedDocRef types and factory)\n * - Per supported version: explicit named type exports from `types_vN.js`\n *   (not star exports, to avoid polluting autocomplete for read-only consumers)\n */\nexport function generateIndexFromSchema(\n  schema: SchemaDefinition,\n  minSupportedVersion?: number,\n): string {\n  const { chain, minVersion } = resolveSchemaChain(schema, minSupportedVersion);\n\n  let output = GENERATED_FILE_HEADER;\n\n  // Star exports for core modules\n  output += `export * from \"${MODELS_PATH}\";\\n`;\n  output += `export * from \"${TYPES_REEXPORT_PATH}\";\\n`;\n  output += `export * from \"${VERSIONS_PATH}\";\\n`;\n  output += `export * from \"${VERSIONED_DOC_REF_PATH}\";\\n`;\n\n  // Per-version explicit named type exports\n  for (const { version, schema: versionSchema } of chain) {\n    if (version < minVersion) continue;\n\n    const typeNames: string[] = [];\n\n    for (const [exportName, item] of Object.entries(versionSchema)) {\n      if (isRecordSchema(item)) {\n        typeNames.push(versionedTypeName(exportName, version));\n      } else if (isUnionSchema(item)) {\n        typeNames.push(versionedTypeName(exportName, version));\n\n        // Union variant types\n        for (const variantName of Object.keys(item.variants)) {\n          const formattedVariant = formatVariantName(variantName);\n          typeNames.push(`${versionedTypeName(exportName, version)}${formattedVariant}`);\n        }\n      }\n    }\n\n    if (typeNames.length > 0) {\n      output += `export type { ${typeNames.sort().join(\", \")} } from \"${\n        typesFilePath(version)\n      }\";\\n`;\n    }\n  }\n\n  return output;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,iBAAiB,QAAQ,yBAAyB;AAC3D,SAASC,qBAAqB,QAAQ,2BAA2B;AACjE,SAASC,kBAAkB,QAAQ,yBAAyB;AAC5D,SACEC,cAAc,EACdC,aAAa,EACbC,WAAW,EACXC,mBAAmB,EACnBC,aAAa,EACbC,sBAAsB,EACtBC,iBAAiB,EACjBC,aAAa,QACR,oBAAoB;;AAE3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CACrCC,MAAwB,EACxBC,mBAA4B,EACpB;EACR,MAAM;IAAEC,KAAK;IAAEC;EAAW,CAAC,GAAGb,kBAAkB,CAACU,MAAM,EAAEC,mBAAmB,CAAC;EAE7E,IAAIG,MAAM,GAAGf,qBAAqB;;EAElC;EACAe,MAAM,IAAI,kBAAkBX,WAAW,MAAM;EAC7CW,MAAM,IAAI,kBAAkBV,mBAAmB,MAAM;EACrDU,MAAM,IAAI,kBAAkBN,aAAa,MAAM;EAC/CM,MAAM,IAAI,kBAAkBR,sBAAsB,MAAM;;EAExD;EACA,KAAK,MAAM;IAAES,OAAO;IAAEL,MAAM,EAAEM;EAAc,CAAC,IAAIJ,KAAK,EAAE;IACtD,IAAIG,OAAO,GAAGF,UAAU,EAAE;IAE1B,MAAMI,SAAmB,GAAG,EAAE;IAE9B,KAAK,MAAM,CAACC,UAAU,EAAEC,IAAI,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACL,aAAa,CAAC,EAAE;MAC9D,IAAIf,cAAc,CAACkB,IAAI,CAAC,EAAE;QACxBF,SAAS,CAACK,IAAI,CAACf,iBAAiB,CAACW,UAAU,EAAEH,OAAO,CAAC,CAAC;MACxD,CAAC,MAAM,IAAIb,aAAa,CAACiB,IAAI,CAAC,EAAE;QAC9BF,SAAS,CAACK,IAAI,CAACf,iBAAiB,CAACW,UAAU,EAAEH,OAAO,CAAC,CAAC;;QAEtD;QACA,KAAK,MAAMQ,WAAW,IAAIH,MAAM,CAACI,IAAI,CAACL,IAAI,CAACM,QAAQ,CAAC,EAAE;UACpD,MAAMC,gBAAgB,GAAG5B,iBAAiB,CAACyB,WAAW,CAAC;UACvDN,SAAS,CAACK,IAAI,CAAC,GAAGf,iBAAiB,CAACW,UAAU,EAAEH,OAAO,CAAC,GAAGW,gBAAgB,EAAE,CAAC;QAChF;MACF;IACF;IAEA,IAAIT,SAAS,CAACU,MAAM,GAAG,CAAC,EAAE;MACxBb,MAAM,IAAI,iBAAiBG,SAAS,CAACW,IAAI,CAAC,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC,YACpDxB,aAAa,CAACU,OAAO,CAAC,MAClB;IACR;EACF;EAEA,OAAOD,MAAM;AACf","ignoreList":[]}
+{"version":3,"file":"generateIndexFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","resolveMinVersion","INTERNAL_UPGRADE_FNS_PATH","MODELS_PATH","TYPES_REEXPORT_PATH","typesFilePath","VERSIONED_DOC_REF_PATH","versionedTypeName","VERSIONS_PATH","generateIndexFromChain","resolved","minSupportedVersion","chain","minVersion","output","version","ir","typeNames","modelKey","modelDef","Object","entries","models","type","push","variantName","keys","union","variants","formattedVariant","length","sort","join"],"sources":["generateIndexFromSchema.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport type { ResolvedIrChain } from \"./resolveSchemaChain.js\";\nimport { resolveMinVersion } from \"./resolveSchemaChain.js\";\nimport {\n  INTERNAL_UPGRADE_FNS_PATH,\n  MODELS_PATH,\n  TYPES_REEXPORT_PATH,\n  typesFilePath,\n  VERSIONED_DOC_REF_PATH,\n  versionedTypeName,\n  VERSIONS_PATH,\n} from \"./runtimeSchema.js\";\n\n/**\n * Generate the index.ts barrel export from a versioned schema.\n *\n * Exports:\n * - `models.js` (star export — model constants and `DocumentModel`; emitted\n *   as a factory function when the schema has derived fields, otherwise a const)\n * - `types.js` (star export — latest-version type aliases)\n * - `versions.js` (star export — SupportedVersions, LatestVersion, MinSupportedVersion)\n * - `versionedDocRef.js` (star export — VersionedDocRef types and factory)\n * - `DocumentUpgradeFns` type (the typed shape the factory accepts)\n * - Per supported version: explicit named type exports from `types_vN.js`\n *   (not star exports, to avoid polluting autocomplete for read-only consumers)\n */\nexport function generateIndexFromChain(\n  resolved: ResolvedIrChain,\n  minSupportedVersion?: number,\n): string {\n  const { chain } = resolved;\n  const { minVersion } = resolveMinVersion(chain, minSupportedVersion);\n\n  let output = GENERATED_FILE_HEADER;\n\n  // Star exports for core modules\n  output += `export * from \"${MODELS_PATH}\";\\n`;\n  output += `export * from \"${TYPES_REEXPORT_PATH}\";\\n`;\n  output += `export * from \"${VERSIONS_PATH}\";\\n`;\n  output += `export * from \"${VERSIONED_DOC_REF_PATH}\";\\n`;\n  // The typed upgrade-function table shape. Apps reference this type when\n  // constructing the value passed to `DocumentModel(...)`.\n  output += `export { type DocumentUpgradeFns } from \"${INTERNAL_UPGRADE_FNS_PATH}\";\\n`;\n\n  // Per-version explicit named type exports\n  for (const { version, ir } of chain) {\n    if (version < minVersion) continue;\n\n    const typeNames: string[] = [];\n\n    for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n      if (modelDef.type === \"record\") {\n        typeNames.push(versionedTypeName(modelKey, version));\n      } else if (modelDef.type === \"union\") {\n        typeNames.push(versionedTypeName(modelKey, version));\n\n        // Union variant types\n        for (const variantName of Object.keys(modelDef.union.variants)) {\n          const formattedVariant = formatVariantName(variantName);\n          typeNames.push(`${versionedTypeName(modelKey, version)}${formattedVariant}`);\n        }\n      }\n    }\n\n    if (typeNames.length > 0) {\n      output += `export type { ${typeNames.sort().join(\", \")} } from \"${\n        typesFilePath(version)\n      }\";\\n`;\n    }\n  }\n\n  return output;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,iBAAiB,QAAQ,yBAAyB;AAC3D,SAASC,qBAAqB,QAAQ,2BAA2B;AAEjE,SAASC,iBAAiB,QAAQ,yBAAyB;AAC3D,SACEC,yBAAyB,EACzBC,WAAW,EACXC,mBAAmB,EACnBC,aAAa,EACbC,sBAAsB,EACtBC,iBAAiB,EACjBC,aAAa,QACR,oBAAoB;;AAE3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CACpCC,QAAyB,EACzBC,mBAA4B,EACpB;EACR,MAAM;IAAEC;EAAM,CAAC,GAAGF,QAAQ;EAC1B,MAAM;IAAEG;EAAW,CAAC,GAAGZ,iBAAiB,CAACW,KAAK,EAAED,mBAAmB,CAAC;EAEpE,IAAIG,MAAM,GAAGd,qBAAqB;;EAElC;EACAc,MAAM,IAAI,kBAAkBX,WAAW,MAAM;EAC7CW,MAAM,IAAI,kBAAkBV,mBAAmB,MAAM;EACrDU,MAAM,IAAI,kBAAkBN,aAAa,MAAM;EAC/CM,MAAM,IAAI,kBAAkBR,sBAAsB,MAAM;EACxD;EACA;EACAQ,MAAM,IAAI,4CAA4CZ,yBAAyB,MAAM;;EAErF;EACA,KAAK,MAAM;IAAEa,OAAO;IAAEC;EAAG,CAAC,IAAIJ,KAAK,EAAE;IACnC,IAAIG,OAAO,GAAGF,UAAU,EAAE;IAE1B,MAAMI,SAAmB,GAAG,EAAE;IAE9B,KAAK,MAAM,CAACC,QAAQ,EAAEC,QAAQ,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACL,EAAE,CAACM,MAAM,CAAC,EAAE;MAC5D,IAAIH,QAAQ,CAACI,IAAI,KAAK,QAAQ,EAAE;QAC9BN,SAAS,CAACO,IAAI,CAACjB,iBAAiB,CAACW,QAAQ,EAAEH,OAAO,CAAC,CAAC;MACtD,CAAC,MAAM,IAAII,QAAQ,CAACI,IAAI,KAAK,OAAO,EAAE;QACpCN,SAAS,CAACO,IAAI,CAACjB,iBAAiB,CAACW,QAAQ,EAAEH,OAAO,CAAC,CAAC;;QAEpD;QACA,KAAK,MAAMU,WAAW,IAAIL,MAAM,CAACM,IAAI,CAACP,QAAQ,CAACQ,KAAK,CAACC,QAAQ,CAAC,EAAE;UAC9D,MAAMC,gBAAgB,GAAG9B,iBAAiB,CAAC0B,WAAW,CAAC;UACvDR,SAAS,CAACO,IAAI,CAAC,GAAGjB,iBAAiB,CAACW,QAAQ,EAAEH,OAAO,CAAC,GAAGc,gBAAgB,EAAE,CAAC;QAC9E;MACF;IACF;IAEA,IAAIZ,SAAS,CAACa,MAAM,GAAG,CAAC,EAAE;MACxBhB,MAAM,IAAI,iBAAiBG,SAAS,CAACc,IAAI,CAAC,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC,YACpD3B,aAAa,CAACU,OAAO,CAAC,MAClB;IACR;EACF;EAEA,OAAOD,MAAM;AACf","ignoreList":[]}