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

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

@@ -0,0 +1,195 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { formatVariantName } from "../formatVariantName.js";
+import { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
+import { resolveSchemaChain } from "./resolveSchemaChain.js";
+import { INTERNAL_UPGRADES_PATH, isRecordSchema, isUnionSchema, modelName, SCHEMA_REEXPORT_PATH, schemaName, TYPES_REEXPORT_PATH } from "./runtimeSchema.js";
+/**
+ * Detect which external ref field types (docRef, mediaRef, objectRef, userRef)
+ * are present on a record for its model metadata.
+ */
+function findExternalRefType(field) {
+  switch (field.type) {
+    case "docRef":
+      return "docRef";
+    case "mediaRef":
+      return "mediaRef";
+    case "objectRef":
+      return "objectRef";
+    case "userRef":
+      return "userRef";
+    case "optional":
+      return field.item ? findExternalRefType(field.item) : undefined;
+    case "array":
+      return field.items ? findExternalRefType(field.items) : undefined;
+    default:
+      return undefined;
+  }
+}
+function extractExternalRefFieldTypes(record) {
+  const refs = [];
+  for (const [fieldName, fieldType] of Object.entries(record.fields)) {
+    const refType = findExternalRefType(fieldType);
+    if (refType != null) {
+      refs.push([fieldName, refType]);
+    }
+  }
+  return refs;
+}
+
+/**
+ * Generate models.ts and schema manifest from a versioned schema chain.
+ *
+ * @param schema - The schema definition (initial or versioned)
+ * @param minSupportedVersion - Minimum version this client supports (defaults to latest)
+ * @param options - Configuration for import paths
+ * @returns Object containing generated models.ts content and schema manifest JSON
+ */
+export function generateModelMetadataFromSchema(schema, minSupportedVersion) {
+  const {
+    chain,
+    latestVersion,
+    minVersion
+  } = resolveSchemaChain(schema, minSupportedVersion);
+  const latestSchema = chain[chain.length - 1].schema;
+
+  // --- Generate models.ts ---
+  let output = GENERATED_FILE_HEADER;
+
+  // Collect model names for imports
+  const recordNames = [];
+  const unionNames = [];
+  const variantNames = [];
+  for (const [exportName, item] of Object.entries(latestSchema)) {
+    if (isRecordSchema(item)) {
+      recordNames.push(exportName);
+    } else if (isUnionSchema(item)) {
+      unionNames.push(exportName);
+      for (const variantName of Object.keys(item.variants)) {
+        variantNames.push(`${exportName}${formatVariantName(variantName)}`);
+      }
+    }
+  }
+  const allModelNames = [...recordNames, ...unionNames, ...variantNames].sort();
+
+  // Imports
+  const modelTypesImports = ["DocumentSchema"];
+  if (recordNames.length > 0) modelTypesImports.push("RecordModel");
+  if (unionNames.length > 0) modelTypesImports.push("UnionModel");
+  output += `import type { ${modelTypesImports.sort().join(", ")} } from "@palantir/pack.document-schema.model-types";\n`;
+  output += `import { Metadata } from "@palantir/pack.document-schema.model-types";\n`;
+  if (allModelNames.length > 0) {
+    output += `import type { ${allModelNames.join(", ")} } from "${TYPES_REEXPORT_PATH}";\n`;
+  }
+
+  // Schema imports
+  const schemaNames = allModelNames.map(n => schemaName(n));
+  if (schemaNames.length > 0) {
+    output += `import { ${schemaNames.join(", ")} } from "${SCHEMA_REEXPORT_PATH}";\n`;
+  }
+
+  // Upgrade imports (only if there are upgrades)
+  const upgradeNames = [...recordNames, ...unionNames].map(n => `${n}Upgrades`);
+  if (chain.length > 1 && upgradeNames.length > 0) {
+    output += `import { ${upgradeNames.join(", ")} } from "${INTERNAL_UPGRADES_PATH}";\n`;
+  }
+  output += "\n";
+
+  // Generate model constants
+  for (const [exportName, item] of Object.entries(latestSchema)) {
+    if (isRecordSchema(item)) {
+      const externalRefs = extractExternalRefFieldTypes(item);
+      const metadataFields = [];
+      if (externalRefs.length > 0) {
+        const entries = externalRefs.map(([field, type]) => `      ${field}: "${type}",`).join("\n");
+        metadataFields.push(`    externalRefFieldTypes: {\n${entries}\n    },`);
+      }
+      metadataFields.push(`    name: "${exportName}",`);
+      output += `export interface ${modelName(exportName)} extends RecordModel<${exportName}, typeof ${schemaName(exportName)}> {}\n`;
+      output += `export const ${modelName(exportName)}: ${modelName(exportName)} = {\n`;
+      output += `  __type: {} as ${exportName},\n`;
+      output += `  zodSchema: ${schemaName(exportName)},\n`;
+      output += `  [Metadata]: {\n${metadataFields.join("\n")}\n  },\n`;
+      output += `};\n\n`;
+    } else if (isUnionSchema(item)) {
+      const metadataFields = [];
+      metadataFields.push(`    discriminant: "${item.discriminant}",`);
+      metadataFields.push(`    name: "${exportName}",`);
+      output += `export interface ${modelName(exportName)} extends UnionModel<${exportName}, typeof ${schemaName(exportName)}> {}\n`;
+      output += `export const ${modelName(exportName)}: ${modelName(exportName)} = {\n`;
+      output += `  __type: {} as ${exportName},\n`;
+      output += `  zodSchema: ${schemaName(exportName)},\n`;
+      output += `  [Metadata]: {\n${metadataFields.join("\n")}\n  },\n`;
+      output += `};\n\n`;
+
+      // Generate variant models
+      for (const variantName of Object.keys(item.variants)) {
+        const formattedVariant = formatVariantName(variantName);
+        const variantTypeName = `${exportName}${formattedVariant}`;
+        const variantMetadata = [];
+        variantMetadata.push(`    discriminant: "${item.discriminant}",`);
+        variantMetadata.push(`    name: "${variantTypeName}",`);
+        output += `export interface ${modelName(variantTypeName)} extends UnionModel<${variantTypeName}, typeof ${schemaName(variantTypeName)}> {}\n`;
+        output += `export const ${modelName(variantTypeName)}: ${modelName(variantTypeName)} = {\n`;
+        output += `  __type: {} as ${variantTypeName},\n`;
+        output += `  zodSchema: ${schemaName(variantTypeName)},\n`;
+        output += `  [Metadata]: {\n${variantMetadata.join("\n")}\n  },\n`;
+        output += `};\n\n`;
+      }
+    }
+  }
+
+  // Generate DocumentModel
+  const modelEntries = [];
+  for (const [exportName, item] of Object.entries(latestSchema)) {
+    if (isRecordSchema(item)) {
+      modelEntries.push(`  ${exportName}: ${modelName(exportName)}`);
+    } else if (isUnionSchema(item)) {
+      modelEntries.push(`  ${exportName}: ${modelName(exportName)}`);
+      for (const variantName of Object.keys(item.variants)) {
+        const formattedVariant = formatVariantName(variantName);
+        const variantTypeName = `${exportName}${formattedVariant}`;
+        modelEntries.push(`  ${variantTypeName}: ${modelName(variantTypeName)}`);
+      }
+    }
+  }
+
+  // Build upgrades map (includes both record and union entries)
+  let upgradesBlock;
+  const allUpgradeNames = [...recordNames, ...unionNames];
+  if (chain.length > 1 && allUpgradeNames.length > 0) {
+    const upgradeEntries = allUpgradeNames.map(n => `      ${n}: ${n}Upgrades,`).join("\n");
+    upgradesBlock = `    upgrades: {\n${upgradeEntries}\n    },\n`;
+  } else {
+    upgradesBlock = "";
+  }
+  output += `export const DocumentModel = {\n`;
+  output += `${modelEntries.join(",\n")},\n`;
+  output += `  [Metadata]: {\n`;
+  output += `    version: ${latestVersion},\n`;
+  if (minVersion !== latestVersion) {
+    output += `    minSupportedVersion: ${minVersion},\n`;
+  }
+  output += upgradesBlock;
+  output += `  },\n`;
+  output += `} as const satisfies DocumentSchema;\n\n`;
+  output += `export type DocumentModel = typeof DocumentModel;\n`;
+  return {
+    modelsFile: output
+  };
+}
+//# sourceMappingURL=generateModelMetadataFromSchema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateModelMetadataFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","resolveSchemaChain","INTERNAL_UPGRADES_PATH","isRecordSchema","isUnionSchema","modelName","SCHEMA_REEXPORT_PATH","schemaName","TYPES_REEXPORT_PATH","findExternalRefType","field","type","item","undefined","items","extractExternalRefFieldTypes","record","refs","fieldName","fieldType","Object","entries","fields","refType","push","generateModelMetadataFromSchema","schema","minSupportedVersion","chain","latestVersion","minVersion","latestSchema","length","output","recordNames","unionNames","variantNames","exportName","variantName","keys","variants","allModelNames","sort","modelTypesImports","join","schemaNames","map","n","upgradeNames","externalRefs","metadataFields","discriminant","formattedVariant","variantTypeName","variantMetadata","modelEntries","upgradesBlock","allUpgradeNames","upgradeEntries","modelsFile"],"sources":["generateModelMetadataFromSchema.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { SchemaDefinition } from \"@palantir/pack.schema\";\nimport { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport { resolveSchemaChain } from \"./resolveSchemaChain.js\";\nimport type { RuntimeSchemaRecord, SchemaField } from \"./runtimeSchema.js\";\nimport {\n  INTERNAL_UPGRADES_PATH,\n  isRecordSchema,\n  isUnionSchema,\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\n/**\n * Detect which external ref field types (docRef, mediaRef, objectRef, userRef)\n * are present on a record for its model metadata.\n */\nfunction findExternalRefType(field: SchemaField): string | undefined {\n  switch (field.type) {\n    case \"docRef\":\n      return \"docRef\";\n    case \"mediaRef\":\n      return \"mediaRef\";\n    case \"objectRef\":\n      return \"objectRef\";\n    case \"userRef\":\n      return \"userRef\";\n    case \"optional\":\n      return field.item ? findExternalRefType(field.item) : undefined;\n    case \"array\":\n      return field.items ? findExternalRefType(field.items) : undefined;\n    default:\n      return undefined;\n  }\n}\n\nfunction extractExternalRefFieldTypes(\n  record: RuntimeSchemaRecord,\n): Array<[string, string]> {\n  const refs: Array<[string, string]> = [];\n  for (const [fieldName, fieldType] of Object.entries(record.fields)) {\n    const refType = findExternalRefType(fieldType);\n    if (refType != null) {\n      refs.push([fieldName, refType]);\n    }\n  }\n  return refs;\n}\n\n/**\n * Generate models.ts and schema manifest from a versioned schema chain.\n *\n * @param schema - The schema definition (initial or versioned)\n * @param minSupportedVersion - Minimum version this client supports (defaults to latest)\n * @param options - Configuration for import paths\n * @returns Object containing generated models.ts content and schema manifest JSON\n */\nexport function generateModelMetadataFromSchema(\n  schema: SchemaDefinition,\n  minSupportedVersion?: number,\n): ModelMetadataOutput {\n  const { chain, latestVersion, minVersion } = resolveSchemaChain(schema, minSupportedVersion);\n  const latestSchema = chain[chain.length - 1]!.schema;\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 [exportName, item] of Object.entries(latestSchema)) {\n    if (isRecordSchema(item)) {\n      recordNames.push(exportName);\n    } else if (isUnionSchema(item)) {\n      unionNames.push(exportName);\n      for (const variantName of Object.keys(item.variants)) {\n        variantNames.push(`${exportName}${formatVariantName(variantName)}`);\n      }\n    }\n  }\n\n  const allModelNames = [...recordNames, ...unionNames, ...variantNames].sort();\n\n  // Imports\n  const modelTypesImports: string[] = [\"DocumentSchema\"];\n  if (recordNames.length > 0) modelTypesImports.push(\"RecordModel\");\n  if (unionNames.length > 0) modelTypesImports.push(\"UnionModel\");\n\n  output += `import type { ${\n    modelTypesImports.sort().join(\", \")\n  } } from \"@palantir/pack.document-schema.model-types\";\\n`;\n  output += `import { Metadata } from \"@palantir/pack.document-schema.model-types\";\\n`;\n\n  if (allModelNames.length > 0) {\n    output += `import type { ${allModelNames.join(\", \")} } from \"${TYPES_REEXPORT_PATH}\";\\n`;\n  }\n\n  // Schema imports\n  const schemaNames = allModelNames.map(n => schemaName(n));\n  if (schemaNames.length > 0) {\n    output += `import { ${schemaNames.join(\", \")} } from \"${SCHEMA_REEXPORT_PATH}\";\\n`;\n  }\n\n  // Upgrade imports (only if there are upgrades)\n  const upgradeNames = [...recordNames, ...unionNames].map(n => `${n}Upgrades`);\n  if (chain.length > 1 && upgradeNames.length > 0) {\n    output += `import { ${upgradeNames.join(\", \")} } from \"${INTERNAL_UPGRADES_PATH}\";\\n`;\n  }\n\n  output += \"\\n\";\n\n  // Generate model constants\n  for (const [exportName, item] of Object.entries(latestSchema)) {\n    if (isRecordSchema(item)) {\n      const externalRefs = extractExternalRefFieldTypes(item);\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: \"${exportName}\",`);\n\n      output += `export interface ${\n        modelName(exportName)\n      } extends RecordModel<${exportName}, typeof ${schemaName(exportName)}> {}\\n`;\n      output += `export const ${modelName(exportName)}: ${modelName(exportName)} = {\\n`;\n      output += `  __type: {} as ${exportName},\\n`;\n      output += `  zodSchema: ${schemaName(exportName)},\\n`;\n      output += `  [Metadata]: {\\n${metadataFields.join(\"\\n\")}\\n  },\\n`;\n      output += `};\\n\\n`;\n    } else if (isUnionSchema(item)) {\n      const metadataFields: string[] = [];\n      metadataFields.push(`    discriminant: \"${item.discriminant}\",`);\n      metadataFields.push(`    name: \"${exportName}\",`);\n\n      output += `export interface ${\n        modelName(exportName)\n      } extends UnionModel<${exportName}, typeof ${schemaName(exportName)}> {}\\n`;\n      output += `export const ${modelName(exportName)}: ${modelName(exportName)} = {\\n`;\n      output += `  __type: {} as ${exportName},\\n`;\n      output += `  zodSchema: ${schemaName(exportName)},\\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(item.variants)) {\n        const formattedVariant = formatVariantName(variantName);\n        const variantTypeName = `${exportName}${formattedVariant}`;\n        const variantMetadata: string[] = [];\n        variantMetadata.push(`    discriminant: \"${item.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 [exportName, item] of Object.entries(latestSchema)) {\n    if (isRecordSchema(item)) {\n      modelEntries.push(`  ${exportName}: ${modelName(exportName)}`);\n    } else if (isUnionSchema(item)) {\n      modelEntries.push(`  ${exportName}: ${modelName(exportName)}`);\n      for (const variantName of Object.keys(item.variants)) {\n        const formattedVariant = formatVariantName(variantName);\n        const variantTypeName = `${exportName}${formattedVariant}`;\n        modelEntries.push(`  ${variantTypeName}: ${modelName(variantTypeName)}`);\n      }\n    }\n  }\n\n  // Build upgrades map (includes both record and union entries)\n  let upgradesBlock: string;\n  const allUpgradeNames = [...recordNames, ...unionNames];\n  if (chain.length > 1 && allUpgradeNames.length > 0) {\n    const upgradeEntries = allUpgradeNames.map(n => `      ${n}: ${n}Upgrades,`).join(\"\\n\");\n    upgradesBlock = `    upgrades: {\\n${upgradeEntries}\\n    },\\n`;\n  } else {\n    upgradesBlock = \"\";\n  }\n\n  output += `export const DocumentModel = {\\n`;\n  output += `${modelEntries.join(\",\\n\")},\\n`;\n  output += `  [Metadata]: {\\n`;\n  output += `    version: ${latestVersion},\\n`;\n  if (minVersion !== latestVersion) {\n    output += `    minSupportedVersion: ${minVersion},\\n`;\n  }\n  output += upgradesBlock;\n  output += `  },\\n`;\n  output += `} as const satisfies DocumentSchema;\\n\\n`;\n  output += `export type DocumentModel = typeof DocumentModel;\\n`;\n\n  return { modelsFile: output };\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,155 @@
+/*
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
+import { resolveSchemaChain } from "./resolveSchemaChain.js";
+import { isRecordSchema, isUnionSchema, modelName, MODELS_PATH, typesFilePath, versionedTypeName, versionedWriteTypeName, writeTypesFilePath } from "./runtimeSchema.js";
+
+/**
+ * Generate versionedDocRef.ts from a versioned schema chain.
+ *
+ * Produces:
+ * - Per-version VersionedDocRef_vN interfaces extending DocumentRef<DocumentModel>
+ * - Union type VersionedDocRef = VersionedDocRef_v1 | VersionedDocRef_v2
+ *
+ * Every model gets a version-specific overload on every version so that
+ * write data is always typed to the exact version, not the latest.
+ */
+export function generateScopeFromSchema(schema, minSupportedVersion) {
+  const {
+    chain,
+    minVersion
+  } = resolveSchemaChain(schema, minSupportedVersion);
+
+  // Filter to supported versions
+  const supportedVersions = chain.filter(v => v.version >= minVersion);
+
+  // Collect all model names from the latest schema
+  const latestSchema = chain[chain.length - 1].schema;
+  const allModelNames = [];
+  for (const [exportName, item] of Object.entries(latestSchema)) {
+    if (isRecordSchema(item) || isUnionSchema(item)) {
+      allModelNames.push(exportName);
+    }
+  }
+
+  // Build output
+  let output = GENERATED_FILE_HEADER;
+
+  // Import model-types
+  output += `import type { DocumentRef, RecordId, RecordRef } from "@palantir/pack.document-schema.model-types";\n`;
+
+  // Import model types from models.ts
+  const modelImports = allModelNames.map(n => modelName(n));
+  const typeImportsFromModels = ["DocumentModel", ...modelImports];
+  output += `import type { ${typeImportsFromModels.join(", ")} } from "${MODELS_PATH}";\n`;
+
+  // Import per-version types
+  for (const {
+    version,
+    schema: versionSchema
+  } of supportedVersions) {
+    const readTypeImports = [];
+    const writeTypeImports = [];
+    for (const [exportName, item] of Object.entries(versionSchema)) {
+      if (isRecordSchema(item)) {
+        readTypeImports.push(versionedTypeName(exportName, version));
+        writeTypeImports.push(versionedWriteTypeName(exportName, version));
+      } else if (isUnionSchema(item)) {
+        readTypeImports.push(versionedTypeName(exportName, version));
+      }
+    }
+    if (readTypeImports.length > 0) {
+      output += `import type { ${readTypeImports.sort().join(", ")} } from "${typesFilePath(version)}";\n`;
+    }
+    if (writeTypeImports.length > 0) {
+      output += `import type { ${writeTypeImports.sort().join(", ")} } from "${writeTypesFilePath(version)}";\n`;
+    }
+  }
+  output += "\n";
+
+  // Generate per-version VersionedDocRef interfaces extending DocumentRef.
+  // Every model gets a version-specific overload on every version so that
+  // write data is always typed to the exact version, not the latest.
+  for (const {
+    version,
+    schema: versionSchema
+  } of supportedVersions) {
+    output += `export interface VersionedDocRef_v${version} extends DocumentRef<DocumentModel> {\n`;
+    output += `  readonly version: ${version};\n`;
+
+    // updateRecord overloads — record models get write types, union models get Partial<read>
+    for (const [exportName, item] of Object.entries(versionSchema)) {
+      if (isRecordSchema(item)) {
+        const writeType = versionedWriteTypeName(exportName, version);
+        output += `  updateRecord(ref: RecordRef<typeof ${modelName(exportName)}>, data: ${writeType}): Promise<void>;\n`;
+      } else if (isUnionSchema(item)) {
+        const readType = versionedTypeName(exportName, version);
+        output += `  updateRecord(ref: RecordRef<typeof ${modelName(exportName)}>, data: Partial<${readType}>): Promise<void>;\n`;
+      }
+    }
+
+    // setCollectionRecord overloads
+    for (const [exportName, item] of Object.entries(versionSchema)) {
+      if (isRecordSchema(item) || isUnionSchema(item)) {
+        const readType = versionedTypeName(exportName, version);
+        output += `  setCollectionRecord(model: typeof ${modelName(exportName)}, id: RecordId, data: ${readType}): Promise<void>;\n`;
+      }
+    }
+    output += `}\n\n`;
+  }
+
+  // Union type
+  if (supportedVersions.length === 1) {
+    output += `export type VersionedDocRef = VersionedDocRef_v${supportedVersions[0].version};\n`;
+  } else {
+    const unionMembers = supportedVersions.map(v => `VersionedDocRef_v${v.version}`).join(" | ");
+    output += `export type VersionedDocRef = ${unionMembers};\n`;
+  }
+
+  // asVersioned — identity cast to unlock version-specific write overloads
+  output += `\n/** Narrow a DocumentRef to a version-discriminated type for type-safe writes. */\n`;
+  output += `export function asVersioned(docRef: DocumentRef<DocumentModel>): VersionedDocRef {\n`;
+  output += `  return docRef as VersionedDocRef;\n`;
+  output += `}\n`;
+
+  // matchVersion — exhaustive version handler
+  const handlerProps = supportedVersions.map(v => `  readonly ${v.version}: (doc: VersionedDocRef_v${v.version}) => R;`).join("\n");
+  output += `\n/**\n`;
+  output += ` * Exhaustive version handler. TypeScript enforces that every supported\n`;
+  output += ` * version has a corresponding handler -- adding a new schema version\n`;
+  output += ` * produces a compile error at every call site until handled.\n`;
+  output += ` */\n`;
+  output += `export function matchVersion<R>(\n`;
+  output += `  doc: VersionedDocRef,\n`;
+  output += `  handlers: {\n`;
+  output += handlerProps + "\n";
+  output += `  },\n`;
+  output += `): R {\n`;
+  output += `  switch (doc.version) {\n`;
+  for (const {
+    version
+  } of supportedVersions) {
+    output += `    case ${version}:\n`;
+    output += `      return handlers[${version}](doc);\n`;
+  }
+  output += `    default:\n`;
+  output += `      throw new Error(\`Unexpected document version: \${(doc as any).version}\`);\n`;
+  output += `  }\n`;
+  output += `}\n`;
+  return output;
+}
+//# sourceMappingURL=generateScopeFromSchema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateScopeFromSchema.js","names":["GENERATED_FILE_HEADER","resolveSchemaChain","isRecordSchema","isUnionSchema","modelName","MODELS_PATH","typesFilePath","versionedTypeName","versionedWriteTypeName","writeTypesFilePath","generateScopeFromSchema","schema","minSupportedVersion","chain","minVersion","supportedVersions","filter","v","version","latestSchema","length","allModelNames","exportName","item","Object","entries","push","output","modelImports","map","n","typeImportsFromModels","join","versionSchema","readTypeImports","writeTypeImports","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 type { SchemaDefinition } from \"@palantir/pack.schema\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport { resolveSchemaChain } from \"./resolveSchemaChain.js\";\nimport {\n  isRecordSchema,\n  isUnionSchema,\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 generateScopeFromSchema(\n  schema: SchemaDefinition,\n  minSupportedVersion?: number,\n): string {\n  const { chain, minVersion } = resolveSchemaChain(schema, 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 schema\n  const latestSchema = chain[chain.length - 1]!.schema;\n  const allModelNames: string[] = [];\n  for (const [exportName, item] of Object.entries(latestSchema)) {\n    if (isRecordSchema(item) || isUnionSchema(item)) {\n      allModelNames.push(exportName);\n    }\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, schema: versionSchema } of supportedVersions) {\n    const readTypeImports: string[] = [];\n    const writeTypeImports: string[] = [];\n\n    for (const [exportName, item] of Object.entries(versionSchema)) {\n      if (isRecordSchema(item)) {\n        readTypeImports.push(versionedTypeName(exportName, version));\n        writeTypeImports.push(versionedWriteTypeName(exportName, version));\n      } else if (isUnionSchema(item)) {\n        readTypeImports.push(versionedTypeName(exportName, 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  // 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  for (const { version, schema: versionSchema } 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 [exportName, item] of Object.entries(versionSchema)) {\n      if (isRecordSchema(item)) {\n        const writeType = versionedWriteTypeName(exportName, version);\n        output += `  updateRecord(ref: RecordRef<typeof ${\n          modelName(exportName)\n        }>, data: ${writeType}): Promise<void>;\\n`;\n      } else if (isUnionSchema(item)) {\n        const readType = versionedTypeName(exportName, version);\n        output += `  updateRecord(ref: RecordRef<typeof ${\n          modelName(exportName)\n        }>, data: Partial<${readType}>): Promise<void>;\\n`;\n      }\n    }\n\n    // setCollectionRecord overloads\n    for (const [exportName, item] of Object.entries(versionSchema)) {\n      if (isRecordSchema(item) || isUnionSchema(item)) {\n        const readType = versionedTypeName(exportName, version);\n        output += `  setCollectionRecord(model: typeof ${\n          modelName(exportName)\n        }, id: RecordId, data: ${readType}): Promise<void>;\\n`;\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/generateTypesFromSchema.js

@@ -16,24 +16,7 @@
 
 import { formatVariantName } from "../formatVariantName.js";
 import { GENERATED_FILE_HEADER } from "../generatedFileHeader.js";
-
-// Define schema types for internal use
-const SchemaDefKind = {
-  RECORD: "record",
-  UNION: "union"
-};
-const TypeKind = {
-  ANY: "any",
-  ARRAY: "array",
-  DOC_REF: "docRef",
-  DOUBLE: "double",
-  MEDIA_REF: "mediaRef",
-  OBJECT_REF: "objectRef",
-  OPTIONAL: "optional",
-  REF: "ref",
-  STRING: "string",
-  USER_REF: "userRef"
-};
+import { SchemaDefKind, TypeKind } from "./runtimeSchema.js";
 
 // Base type definition for schema fields
 
@@ -201,10 +184,10 @@ function convertTypeToTypeScript(fieldType, schema) {
     case TypeKind.ANY:
       return "any";
     case TypeKind.ARRAY:
-      if (isArrayField(fieldType)) {
-        return `readonly ${convertTypeToTypeScript(fieldType.items, schema)}[]`;
+      if (!isArrayField(fieldType)) {
+        throw new Error("Array field is missing items type");
       }
-      return "readonly unknown[]";
+      return `readonly ${convertTypeToTypeScript(fieldType.items, schema)}[]`;
     case TypeKind.DOC_REF:
       return "DocumentRef";
     case TypeKind.DOUBLE:
@@ -214,24 +197,27 @@ function convertTypeToTypeScript(fieldType, schema) {
     case TypeKind.OBJECT_REF:
       return "ObjectRef";
     case TypeKind.OPTIONAL:
-      if (isOptionalField(fieldType)) {
-        return convertTypeToTypeScript(fieldType.item, schema);
+      if (!isOptionalField(fieldType)) {
+        throw new Error("Optional field is missing inner type");
       }
-      return "unknown";
+      return convertTypeToTypeScript(fieldType.item, schema);
     case TypeKind.REF:
-      if (isRefField(fieldType) && fieldType.refType === "record") {
+      if (!isRefField(fieldType)) {
+        throw new Error("Ref field is missing name or refType");
+      }
+      if (fieldType.refType === "record") {
         const exportName = schema ? findRecordExportName(fieldType.name, schema) : null;
-        return exportName || (isRefField(fieldType) ? fieldType.name : "unknown");
-      } else if (isRefField(fieldType) && fieldType.refType === "union") {
-        return isRefField(fieldType) ? fieldType.name : "unknown";
+        return exportName ?? fieldType.name;
       }
-      return "unknown";
+      return fieldType.name;
     case TypeKind.STRING:
       return "string";
     case TypeKind.USER_REF:
       return "UserRef";
     default:
-      return "unknown";
+      {
+        throw new Error(`Unknown schema field type: ${fieldType.type}`);
+      }
   }
 }
 //# sourceMappingURL=generateTypesFromSchema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generateTypesFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","SchemaDefKind","RECORD","UNION","TypeKind","ANY","ARRAY","DOC_REF","DOUBLE","MEDIA_REF","OBJECT_REF","OPTIONAL","REF","STRING","USER_REF","isRecordSchema","item","type","isUnionSchema","isRefField","field","isArrayField","isOptionalField","detectUsedRefTypes","schema","refTypes","Set","scanField","items","add","Object","values","fields","variant","variants","generateTypesFromSchema","runtimeSchema","usedRefTypes","output","size","refTypesList","Array","from","sort","join","exportName","entries","generateRecordInterface","unionEntries","filter","_","forEach","i","unionOutput","generateUnionType","length","record","docs","fieldName","fieldType","tsType","convertTypeToTypeScript","optional","union","variantInterfaces","discriminantField","discriminant","variantName","variantType","interfaceName","push","name","discriminatorValue","refType","recordName","findRecordExportName","map","v"],"sources":["generateTypesFromSchema.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 type { ReturnedSchema, Schema } from \"@palantir/pack.schema\";\nimport { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\n\n// Define schema types for internal use\nconst SchemaDefKind = {\n  RECORD: \"record\",\n  UNION: \"union\",\n} as const;\n\nconst TypeKind = {\n  ANY: \"any\",\n  ARRAY: \"array\",\n  DOC_REF: \"docRef\",\n  DOUBLE: \"double\",\n  MEDIA_REF: \"mediaRef\",\n  OBJECT_REF: \"objectRef\",\n  OPTIONAL: \"optional\",\n  REF: \"ref\",\n  STRING: \"string\",\n  USER_REF: \"userRef\",\n} as const;\n\n// Base type definition for schema fields\ninterface BaseSchemaField {\n  readonly type: string;\n}\n\ninterface AnyField extends BaseSchemaField {\n  readonly type: typeof TypeKind.ANY;\n}\n\ninterface ArrayField extends BaseSchemaField {\n  readonly type: typeof TypeKind.ARRAY;\n  readonly items: SchemaField;\n}\n\ninterface DocRefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.DOC_REF;\n}\n\ninterface DoubleField extends BaseSchemaField {\n  readonly type: typeof TypeKind.DOUBLE;\n}\n\ninterface MediaRefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.MEDIA_REF;\n}\n\ninterface ObjectRefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.OBJECT_REF;\n}\n\ninterface OptionalField extends BaseSchemaField {\n  readonly type: typeof TypeKind.OPTIONAL;\n  readonly item: SchemaField;\n}\n\ninterface RefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.REF;\n  readonly refType: \"record\" | \"union\";\n  readonly name: string;\n}\n\ninterface StringField extends BaseSchemaField {\n  readonly type: typeof TypeKind.STRING;\n}\n\ninterface UserRefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.USER_REF;\n}\n\ntype SchemaField =\n  | AnyField\n  | ArrayField\n  | DocRefField\n  | DoubleField\n  | MediaRefField\n  | ObjectRefField\n  | OptionalField\n  | RefField\n  | StringField\n  | UserRefField;\n\ninterface RuntimeSchemaRecord {\n  readonly type: typeof SchemaDefKind.RECORD;\n  readonly name: string;\n  readonly docs?: string;\n  readonly fields: Readonly<Record<string, SchemaField>>;\n  readonly ref?: RefField & {\n    readonly refType: \"record\";\n  };\n}\n\ninterface RuntimeSchemaUnion {\n  readonly type: typeof SchemaDefKind.UNION;\n  readonly name?: string;\n  readonly variants: Readonly<Record<string, SchemaField>>;\n  readonly discriminant: string;\n  readonly ref?: RefField & {\n    readonly refType: \"union\";\n  };\n}\n\ntype RuntimeSchemaItem = RuntimeSchemaRecord | RuntimeSchemaUnion;\ntype RuntimeSchema = Record<string, RuntimeSchemaItem>;\n\n// Type guards\nfunction isRecordSchema(item: RuntimeSchemaItem): item is RuntimeSchemaRecord {\n  return item.type === SchemaDefKind.RECORD && \"name\" in item && \"fields\" in item;\n}\n\nfunction isUnionSchema(item: RuntimeSchemaItem): item is RuntimeSchemaUnion {\n  return item.type === SchemaDefKind.UNION && \"variants\" in item && \"discriminant\" in item;\n}\n\nfunction isRefField(field: SchemaField): field is RefField {\n  return field.type === TypeKind.REF && \"refType\" in field && \"name\" in field;\n}\n\nfunction isArrayField(field: SchemaField): field is ArrayField {\n  return field.type === TypeKind.ARRAY && \"items\" in field;\n}\n\nfunction isOptionalField(field: SchemaField): field is OptionalField {\n  return field.type === TypeKind.OPTIONAL && \"item\" in field;\n}\n\nfunction detectUsedRefTypes(schema: RuntimeSchema): Set<string> {\n  const refTypes = new Set<string>();\n\n  function scanField(field: SchemaField): void {\n    switch (field.type) {\n      case TypeKind.ARRAY:\n        if (isArrayField(field)) {\n          scanField(field.items);\n        }\n        break;\n      case TypeKind.DOC_REF:\n        refTypes.add(\"DocumentRef\");\n        break;\n      case TypeKind.MEDIA_REF:\n        refTypes.add(\"MediaRef\");\n        break;\n      case TypeKind.OBJECT_REF:\n        refTypes.add(\"ObjectRef\");\n        break;\n      case TypeKind.OPTIONAL:\n        if (isOptionalField(field)) {\n          scanField(field.item);\n        }\n        break;\n      case TypeKind.USER_REF:\n        refTypes.add(\"UserRef\");\n        break;\n    }\n  }\n\n  for (const item of Object.values(schema)) {\n    if (isRecordSchema(item)) {\n      for (const field of Object.values(item.fields)) {\n        scanField(field);\n      }\n    } else if (isUnionSchema(item)) {\n      for (const variant of Object.values(item.variants)) {\n        scanField(variant);\n      }\n    }\n  }\n\n  return refTypes;\n}\n\nexport function generateTypesFromSchema<T extends ReturnedSchema>(\n  schema: Schema<T>,\n): string {\n  const runtimeSchema = schema as unknown as RuntimeSchema;\n\n  // Detect which ref types are used in the schema\n  const usedRefTypes = detectUsedRefTypes(runtimeSchema);\n\n  let output = GENERATED_FILE_HEADER;\n\n  // Add conditional imports based on which ref types are used\n  if (usedRefTypes.size > 0) {\n    const refTypesList = Array.from(usedRefTypes).sort().join(\", \");\n    output +=\n      `import type { ${refTypesList} } from \"@palantir/pack.document-schema.model-types\";\\n`;\n  }\n\n  output += \"\\n\";\n\n  // First pass: generate record interfaces\n  for (const [exportName, item] of Object.entries(runtimeSchema)) {\n    if (item.type === SchemaDefKind.RECORD && isRecordSchema(item)) {\n      output += generateRecordInterface(item, exportName, runtimeSchema);\n      output += \"\\n\";\n    }\n  }\n\n  // Second pass: generate union types\n  const unionEntries = Object.entries(runtimeSchema).filter(\n    ([_, item]) => item.type === SchemaDefKind.UNION && isUnionSchema(item),\n  );\n\n  unionEntries.forEach(([exportName, item], i) => {\n    if (isUnionSchema(item)) {\n      const unionOutput = generateUnionType(item, exportName, runtimeSchema);\n      if (unionOutput) {\n        output += unionOutput;\n        // Only add newline if not the last union\n        if (i < unionEntries.length - 1) {\n          output += \"\\n\";\n        }\n      }\n    }\n  });\n\n  return output;\n}\n\nfunction generateRecordInterface(\n  record: RuntimeSchemaRecord,\n  exportName: string,\n  schema: RuntimeSchema,\n): string {\n  let output = \"\";\n\n  if (record.docs) {\n    output += `/**\\n * ${record.docs}\\n */\\n`;\n  }\n\n  output += `export interface ${exportName} {\\n`;\n\n  for (const [fieldName, fieldType] of Object.entries(record.fields)) {\n    const tsType = convertTypeToTypeScript(fieldType, schema);\n    const optional = fieldType.type === TypeKind.OPTIONAL ? \"?\" : \"\";\n    output += `  readonly ${fieldName}${optional}: ${tsType};\\n`;\n  }\n\n  output += \"}\\n\";\n\n  return output;\n}\n\nfunction generateUnionType(\n  union: RuntimeSchemaUnion,\n  exportName: string,\n  schema: RuntimeSchema,\n): string {\n  let output = \"\";\n  const variantInterfaces: Array<{ name: string; discriminatorValue: string }> = [];\n  const discriminantField = union.discriminant;\n\n  // First pass: generate variant interfaces\n  for (const [variantName, variantType] of Object.entries(union.variants)) {\n    const interfaceName = `${exportName}${formatVariantName(variantName)}`;\n    variantInterfaces.push({ name: interfaceName, discriminatorValue: variantName });\n\n    if (variantType.type === TypeKind.REF && variantType.refType === \"record\") {\n      // Find the corresponding record name in the schema\n      const recordName = findRecordExportName(variantType.name, schema);\n      if (recordName) {\n        output += `export interface ${interfaceName} extends ${recordName} {\\n`;\n        output += `  readonly ${discriminantField}: \"${variantName}\";\\n`;\n        output += \"}\\n\\n\";\n      }\n    } else {\n      // Handle value types\n      const tsType = convertTypeToTypeScript(variantType, schema);\n      output += `export interface ${interfaceName} {\\n`;\n      output += `  readonly ${discriminantField}: \"${variantName}\";\\n`;\n      output += `  readonly value: ${tsType};\\n`;\n      output += \"}\\n\\n\";\n    }\n  }\n\n  // Second pass: generate the union type\n  output += `export type ${exportName} = ${variantInterfaces.map(v => v.name).join(\" | \")};\\n\\n`;\n\n  // Third pass: generate type guards\n  for (let i = 0; i < variantInterfaces.length; i++) {\n    const variant = variantInterfaces[i]!;\n    output +=\n      `export function is${variant.name}(value: ${exportName}): value is ${variant.name} {\\n`;\n    output += `  return value.${discriminantField} === \"${variant.discriminatorValue}\";\\n`;\n    output += \"}\\n\\n\";\n  }\n\n  return output;\n}\n\nfunction findRecordExportName(\n  recordName: string,\n  schema: RuntimeSchema,\n): string | null {\n  for (const [exportName, item] of Object.entries(schema)) {\n    if (isRecordSchema(item) && item.name === recordName) {\n      return exportName;\n    }\n  }\n  return null;\n}\n\nfunction convertTypeToTypeScript(\n  fieldType: SchemaField,\n  schema?: RuntimeSchema,\n): string {\n  switch (fieldType.type) {\n    case TypeKind.ANY:\n      return \"any\";\n    case TypeKind.ARRAY:\n      if (isArrayField(fieldType)) {\n        return `readonly ${convertTypeToTypeScript(fieldType.items, schema)}[]`;\n      }\n      return \"readonly unknown[]\";\n    case TypeKind.DOC_REF:\n      return \"DocumentRef\";\n    case TypeKind.DOUBLE:\n      return \"number\";\n    case TypeKind.MEDIA_REF:\n      return \"MediaRef\";\n    case TypeKind.OBJECT_REF:\n      return \"ObjectRef\";\n    case TypeKind.OPTIONAL:\n      if (isOptionalField(fieldType)) {\n        return convertTypeToTypeScript(fieldType.item, schema);\n      }\n      return \"unknown\";\n    case TypeKind.REF:\n      if (isRefField(fieldType) && fieldType.refType === \"record\") {\n        const exportName = schema ? findRecordExportName(fieldType.name, schema) : null;\n        return exportName || (isRefField(fieldType) ? fieldType.name : \"unknown\");\n      } else if (isRefField(fieldType) && fieldType.refType === \"union\") {\n        return isRefField(fieldType) ? fieldType.name : \"unknown\";\n      }\n      return \"unknown\";\n    case TypeKind.STRING:\n      return \"string\";\n    case TypeKind.USER_REF:\n      return \"UserRef\";\n    default:\n      fieldType satisfies never;\n      return \"unknown\";\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"generateTypesFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","SchemaDefKind","TypeKind","isRecordSchema","item","type","RECORD","isUnionSchema","UNION","isRefField","field","REF","isArrayField","ARRAY","isOptionalField","OPTIONAL","detectUsedRefTypes","schema","refTypes","Set","scanField","items","DOC_REF","add","MEDIA_REF","OBJECT_REF","USER_REF","Object","values","fields","variant","variants","generateTypesFromSchema","runtimeSchema","usedRefTypes","output","size","refTypesList","Array","from","sort","join","exportName","entries","generateRecordInterface","unionEntries","filter","_","forEach","i","unionOutput","generateUnionType","length","record","docs","fieldName","fieldType","tsType","convertTypeToTypeScript","optional","union","variantInterfaces","discriminantField","discriminant","variantName","variantType","interfaceName","push","name","discriminatorValue","refType","recordName","findRecordExportName","map","v","ANY","Error","DOUBLE","STRING"],"sources":["generateTypesFromSchema.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 type { ReturnedSchema, Schema } from \"@palantir/pack.schema\";\nimport { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport { SchemaDefKind, TypeKind } from \"./runtimeSchema.js\";\n\n// Base type definition for schema fields\ninterface BaseSchemaField {\n  readonly type: string;\n}\n\ninterface AnyField extends BaseSchemaField {\n  readonly type: typeof TypeKind.ANY;\n}\n\ninterface ArrayField extends BaseSchemaField {\n  readonly type: typeof TypeKind.ARRAY;\n  readonly items: SchemaField;\n}\n\ninterface DocRefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.DOC_REF;\n}\n\ninterface DoubleField extends BaseSchemaField {\n  readonly type: typeof TypeKind.DOUBLE;\n}\n\ninterface MediaRefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.MEDIA_REF;\n}\n\ninterface ObjectRefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.OBJECT_REF;\n}\n\ninterface OptionalField extends BaseSchemaField {\n  readonly type: typeof TypeKind.OPTIONAL;\n  readonly item: SchemaField;\n}\n\ninterface RefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.REF;\n  readonly refType: \"record\" | \"union\";\n  readonly name: string;\n}\n\ninterface StringField extends BaseSchemaField {\n  readonly type: typeof TypeKind.STRING;\n}\n\ninterface UserRefField extends BaseSchemaField {\n  readonly type: typeof TypeKind.USER_REF;\n}\n\ntype SchemaField =\n  | AnyField\n  | ArrayField\n  | DocRefField\n  | DoubleField\n  | MediaRefField\n  | ObjectRefField\n  | OptionalField\n  | RefField\n  | StringField\n  | UserRefField;\n\ninterface RuntimeSchemaRecord {\n  readonly type: typeof SchemaDefKind.RECORD;\n  readonly name: string;\n  readonly docs?: string;\n  readonly fields: Readonly<Record<string, SchemaField>>;\n  readonly ref?: RefField & {\n    readonly refType: \"record\";\n  };\n}\n\ninterface RuntimeSchemaUnion {\n  readonly type: typeof SchemaDefKind.UNION;\n  readonly name?: string;\n  readonly variants: Readonly<Record<string, SchemaField>>;\n  readonly discriminant: string;\n  readonly ref?: RefField & {\n    readonly refType: \"union\";\n  };\n}\n\ntype RuntimeSchemaItem = RuntimeSchemaRecord | RuntimeSchemaUnion;\ntype RuntimeSchema = Record<string, RuntimeSchemaItem>;\n\n// Type guards\nfunction isRecordSchema(item: RuntimeSchemaItem): item is RuntimeSchemaRecord {\n  return item.type === SchemaDefKind.RECORD && \"name\" in item && \"fields\" in item;\n}\n\nfunction isUnionSchema(item: RuntimeSchemaItem): item is RuntimeSchemaUnion {\n  return item.type === SchemaDefKind.UNION && \"variants\" in item && \"discriminant\" in item;\n}\n\nfunction isRefField(field: SchemaField): field is RefField {\n  return field.type === TypeKind.REF && \"refType\" in field && \"name\" in field;\n}\n\nfunction isArrayField(field: SchemaField): field is ArrayField {\n  return field.type === TypeKind.ARRAY && \"items\" in field;\n}\n\nfunction isOptionalField(field: SchemaField): field is OptionalField {\n  return field.type === TypeKind.OPTIONAL && \"item\" in field;\n}\n\nfunction detectUsedRefTypes(schema: RuntimeSchema): Set<string> {\n  const refTypes = new Set<string>();\n\n  function scanField(field: SchemaField): void {\n    switch (field.type) {\n      case TypeKind.ARRAY:\n        if (isArrayField(field)) {\n          scanField(field.items);\n        }\n        break;\n      case TypeKind.DOC_REF:\n        refTypes.add(\"DocumentRef\");\n        break;\n      case TypeKind.MEDIA_REF:\n        refTypes.add(\"MediaRef\");\n        break;\n      case TypeKind.OBJECT_REF:\n        refTypes.add(\"ObjectRef\");\n        break;\n      case TypeKind.OPTIONAL:\n        if (isOptionalField(field)) {\n          scanField(field.item);\n        }\n        break;\n      case TypeKind.USER_REF:\n        refTypes.add(\"UserRef\");\n        break;\n    }\n  }\n\n  for (const item of Object.values(schema)) {\n    if (isRecordSchema(item)) {\n      for (const field of Object.values(item.fields)) {\n        scanField(field);\n      }\n    } else if (isUnionSchema(item)) {\n      for (const variant of Object.values(item.variants)) {\n        scanField(variant);\n      }\n    }\n  }\n\n  return refTypes;\n}\n\nexport function generateTypesFromSchema<T extends ReturnedSchema>(\n  schema: Schema<T>,\n): string {\n  const runtimeSchema = schema as unknown as RuntimeSchema;\n\n  // Detect which ref types are used in the schema\n  const usedRefTypes = detectUsedRefTypes(runtimeSchema);\n\n  let output = GENERATED_FILE_HEADER;\n\n  // Add conditional imports based on which ref types are used\n  if (usedRefTypes.size > 0) {\n    const refTypesList = Array.from(usedRefTypes).sort().join(\", \");\n    output +=\n      `import type { ${refTypesList} } from \"@palantir/pack.document-schema.model-types\";\\n`;\n  }\n\n  output += \"\\n\";\n\n  // First pass: generate record interfaces\n  for (const [exportName, item] of Object.entries(runtimeSchema)) {\n    if (item.type === SchemaDefKind.RECORD && isRecordSchema(item)) {\n      output += generateRecordInterface(item, exportName, runtimeSchema);\n      output += \"\\n\";\n    }\n  }\n\n  // Second pass: generate union types\n  const unionEntries = Object.entries(runtimeSchema).filter(\n    ([_, item]) => item.type === SchemaDefKind.UNION && isUnionSchema(item),\n  );\n\n  unionEntries.forEach(([exportName, item], i) => {\n    if (isUnionSchema(item)) {\n      const unionOutput = generateUnionType(item, exportName, runtimeSchema);\n      if (unionOutput) {\n        output += unionOutput;\n        // Only add newline if not the last union\n        if (i < unionEntries.length - 1) {\n          output += \"\\n\";\n        }\n      }\n    }\n  });\n\n  return output;\n}\n\nfunction generateRecordInterface(\n  record: RuntimeSchemaRecord,\n  exportName: string,\n  schema: RuntimeSchema,\n): string {\n  let output = \"\";\n\n  if (record.docs) {\n    output += `/**\\n * ${record.docs}\\n */\\n`;\n  }\n\n  output += `export interface ${exportName} {\\n`;\n\n  for (const [fieldName, fieldType] of Object.entries(record.fields)) {\n    const tsType = convertTypeToTypeScript(fieldType, schema);\n    const optional = fieldType.type === TypeKind.OPTIONAL ? \"?\" : \"\";\n    output += `  readonly ${fieldName}${optional}: ${tsType};\\n`;\n  }\n\n  output += \"}\\n\";\n\n  return output;\n}\n\nfunction generateUnionType(\n  union: RuntimeSchemaUnion,\n  exportName: string,\n  schema: RuntimeSchema,\n): string {\n  let output = \"\";\n  const variantInterfaces: Array<{ name: string; discriminatorValue: string }> = [];\n  const discriminantField = union.discriminant;\n\n  // First pass: generate variant interfaces\n  for (const [variantName, variantType] of Object.entries(union.variants)) {\n    const interfaceName = `${exportName}${formatVariantName(variantName)}`;\n    variantInterfaces.push({ name: interfaceName, discriminatorValue: variantName });\n\n    if (variantType.type === TypeKind.REF && variantType.refType === \"record\") {\n      // Find the corresponding record name in the schema\n      const recordName = findRecordExportName(variantType.name, schema);\n      if (recordName) {\n        output += `export interface ${interfaceName} extends ${recordName} {\\n`;\n        output += `  readonly ${discriminantField}: \"${variantName}\";\\n`;\n        output += \"}\\n\\n\";\n      }\n    } else {\n      // Handle value types\n      const tsType = convertTypeToTypeScript(variantType, schema);\n      output += `export interface ${interfaceName} {\\n`;\n      output += `  readonly ${discriminantField}: \"${variantName}\";\\n`;\n      output += `  readonly value: ${tsType};\\n`;\n      output += \"}\\n\\n\";\n    }\n  }\n\n  // Second pass: generate the union type\n  output += `export type ${exportName} = ${variantInterfaces.map(v => v.name).join(\" | \")};\\n\\n`;\n\n  // Third pass: generate type guards\n  for (let i = 0; i < variantInterfaces.length; i++) {\n    const variant = variantInterfaces[i]!;\n    output +=\n      `export function is${variant.name}(value: ${exportName}): value is ${variant.name} {\\n`;\n    output += `  return value.${discriminantField} === \"${variant.discriminatorValue}\";\\n`;\n    output += \"}\\n\\n\";\n  }\n\n  return output;\n}\n\nfunction findRecordExportName(\n  recordName: string,\n  schema: RuntimeSchema,\n): string | null {\n  for (const [exportName, item] of Object.entries(schema)) {\n    if (isRecordSchema(item) && item.name === recordName) {\n      return exportName;\n    }\n  }\n  return null;\n}\n\nfunction convertTypeToTypeScript(\n  fieldType: SchemaField,\n  schema?: RuntimeSchema,\n): string {\n  switch (fieldType.type) {\n    case TypeKind.ANY:\n      return \"any\";\n    case TypeKind.ARRAY:\n      if (!isArrayField(fieldType)) {\n        throw new Error(\"Array field is missing items type\");\n      }\n      return `readonly ${convertTypeToTypeScript(fieldType.items, schema)}[]`;\n    case TypeKind.DOC_REF:\n      return \"DocumentRef\";\n    case TypeKind.DOUBLE:\n      return \"number\";\n    case TypeKind.MEDIA_REF:\n      return \"MediaRef\";\n    case TypeKind.OBJECT_REF:\n      return \"ObjectRef\";\n    case TypeKind.OPTIONAL:\n      if (!isOptionalField(fieldType)) {\n        throw new Error(\"Optional field is missing inner type\");\n      }\n      return convertTypeToTypeScript(fieldType.item, schema);\n    case TypeKind.REF:\n      if (!isRefField(fieldType)) {\n        throw new Error(\"Ref field is missing name or refType\");\n      }\n      if (fieldType.refType === \"record\") {\n        const exportName = schema ? findRecordExportName(fieldType.name, schema) : null;\n        return exportName ?? fieldType.name;\n      }\n      return fieldType.name;\n    case TypeKind.STRING:\n      return \"string\";\n    case TypeKind.USER_REF:\n      return \"UserRef\";\n    default: {\n      const _exhaustive: never = fieldType;\n      throw new Error(`Unknown schema field type: ${(_exhaustive as SchemaField).type}`);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}