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

package/build/esm/utils/ir/irFieldHelpers.js

@@ -0,0 +1,383 @@
+/*
+ * 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 { versionedSchemaName, versionedTypeName } from "../schema/runtimeSchema.js";
+
+// ---------------------------------------------------------------------------
+// Public read-type TypeScript conversion
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert an IR field type to a TypeScript type string for public read types.
+ */
+export function convertFieldTypeToTypeScript(fieldType, version) {
+  switch (fieldType.type) {
+    case "array":
+      return `readonly ${convertCollectionValueToTypeScript(fieldType.array, version)}[]`;
+    case "map":
+    case "set":
+      throw new Error(`${fieldType.type} is not yet supported in TypeScript generation`);
+    case "value":
+      return convertFieldValueToTypeScript(fieldType.value, version);
+  }
+}
+function convertCollectionValueToTypeScript(collection, version) {
+  // allowNullValue is ignored in public read types (current behavior)
+  return convertFieldValueToTypeScript(collection.value, version);
+}
+function convertFieldValueToTypeScript(value, version) {
+  switch (value.type) {
+    case "boolean":
+      return "boolean";
+    case "datetime":
+      return "string";
+    case "docRef":
+      return "DocumentRef";
+    case "double":
+      return "number";
+    case "integer":
+      return "number";
+    case "mediaRef":
+      return "MediaRef";
+    case "modelRef":
+      {
+        const modelKey = value.modelRef.modelTypes[0];
+        return version != null ? versionedTypeName(modelKey, version) : modelKey;
+      }
+    case "object":
+      return "ObjectRef";
+    case "string":
+      return "string";
+    case "text":
+      return "string";
+    case "unmanagedJson":
+      return "any";
+    case "userRef":
+      return "UserRef";
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Zod schema conversion
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert an IR field type to a Zod schema string.
+ */
+export function convertFieldTypeToZodSchema(fieldType, version) {
+  switch (fieldType.type) {
+    case "array":
+      {
+        const inner = convertFieldValueToZodSchema(fieldType.array.value, version);
+        const optSuffix = fieldType.array.allowNullValue ? ".optional()" : "";
+        return `z.array(${inner}${optSuffix})`;
+      }
+    case "map":
+    case "set":
+      throw new Error(`${fieldType.type} is not yet supported in Zod generation`);
+    case "value":
+      return convertFieldValueToZodSchema(fieldType.value, version);
+  }
+}
+function convertFieldValueToZodSchema(value, version) {
+  switch (value.type) {
+    case "boolean":
+      return "z.boolean()";
+    case "datetime":
+    case "docRef":
+    case "mediaRef":
+    case "object":
+    case "string":
+    case "text":
+    case "userRef":
+      return "z.string()";
+    case "double":
+    case "integer":
+      return "z.number()";
+    case "modelRef":
+      {
+        const modelKey = value.modelRef.modelTypes[0];
+        const refSchemaName = version != null ? versionedSchemaName(modelKey, version) : `${modelKey}Schema`;
+        const refTypeName = version != null ? versionedTypeName(modelKey, version) : modelKey;
+        return `z.lazy((): ZodType<${refTypeName}> => ${refSchemaName})`;
+      }
+    case "unmanagedJson":
+      return "z.unknown()";
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Internal TypeScript conversion (refs → unknown, external refs → string)
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert an IR field type to a TypeScript string for internal types.
+ */
+export function convertFieldTypeToInternalTypeScript(fieldType, isOptional) {
+  const base = convertFieldTypeToInternalTsInner(fieldType);
+  if (isOptional) {
+    return `(${base} | undefined)`;
+  }
+  return base;
+}
+function convertFieldTypeToInternalTsInner(fieldType) {
+  switch (fieldType.type) {
+    case "array":
+      {
+        const inner = convertCollectionValueToInternalTs(fieldType.array);
+        const needsParens = inner.includes("|") || inner.startsWith("readonly ");
+        const wrapped = needsParens ? `(${inner})` : inner;
+        return `readonly ${wrapped}[]`;
+      }
+    case "map":
+    case "set":
+      throw new Error(`${fieldType.type} is not yet supported in internal TypeScript generation`);
+    case "value":
+      return convertFieldValueToInternalTs(fieldType.value);
+  }
+}
+function convertCollectionValueToInternalTs(collection) {
+  const base = convertFieldValueToInternalTs(collection.value);
+  if (collection.allowNullValue) {
+    return `(${base} | undefined)`;
+  }
+  return base;
+}
+function convertFieldValueToInternalTs(value) {
+  switch (value.type) {
+    case "boolean":
+      return "boolean";
+    case "double":
+    case "integer":
+      return "number";
+    case "datetime":
+    case "docRef":
+    case "mediaRef":
+    case "object":
+    case "string":
+    case "text":
+    case "userRef":
+      return "string";
+    case "modelRef":
+    case "unmanagedJson":
+      return "unknown";
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Internal Zod schema conversion
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert an IR field type to a Zod schema string for internal schemas.
+ */
+export function convertFieldTypeToInternalZod(fieldType, isOptional) {
+  const base = convertFieldTypeToInternalZodInner(fieldType);
+  if (isOptional) {
+    if (base.endsWith(".optional()")) {
+      return base;
+    }
+    return `${base}.optional()`;
+  }
+  return base;
+}
+function convertFieldTypeToInternalZodInner(fieldType) {
+  switch (fieldType.type) {
+    case "array":
+      {
+        const inner = convertCollectionValueToInternalZod(fieldType.array);
+        return `z.array(${inner})`;
+      }
+    case "map":
+    case "set":
+      throw new Error(`${fieldType.type} is not yet supported in internal Zod generation`);
+    case "value":
+      return convertFieldValueToInternalZod(fieldType.value);
+  }
+}
+function convertCollectionValueToInternalZod(collection) {
+  const base = convertFieldValueToInternalZod(collection.value);
+  if (collection.allowNullValue) {
+    return `${base}.optional()`;
+  }
+  return base;
+}
+function convertFieldValueToInternalZod(value) {
+  switch (value.type) {
+    case "boolean":
+      return "z.boolean()";
+    case "double":
+    case "integer":
+      return "z.number()";
+    case "datetime":
+    case "docRef":
+    case "mediaRef":
+    case "object":
+    case "string":
+    case "text":
+    case "userRef":
+      return "z.string()";
+    case "modelRef":
+    case "unmanagedJson":
+      return "z.unknown()";
+  }
+}
+
+// ---------------------------------------------------------------------------
+// FieldTypeDescriptor conversion (for UpgradeLens)
+// ---------------------------------------------------------------------------
+
+/**
+ * Convert an IR field type to a FieldTypeDescriptor source string for UpgradeLens.
+ */
+export function convertFieldTypeToDescriptor(fieldType, isOptional) {
+  const base = convertFieldTypeToDescriptorInner(fieldType);
+  if (isOptional) {
+    return `{ kind: "optional", inner: ${base} }`;
+  }
+  return base;
+}
+function convertFieldTypeToDescriptorInner(fieldType) {
+  switch (fieldType.type) {
+    case "array":
+      {
+        const inner = convertCollectionValueToDescriptor(fieldType.array);
+        return `{ kind: "array", element: ${inner} }`;
+      }
+    case "map":
+    case "set":
+      throw new Error(`${fieldType.type} is not yet supported in descriptor generation`);
+    case "value":
+      return convertFieldValueToDescriptor(fieldType.value);
+  }
+}
+function convertCollectionValueToDescriptor(collection) {
+  const base = convertFieldValueToDescriptor(collection.value);
+  if (collection.allowNullValue) {
+    return `{ kind: "optional", inner: ${base} }`;
+  }
+  return base;
+}
+function convertFieldValueToDescriptor(value) {
+  switch (value.type) {
+    case "modelRef":
+      {
+        const modelKey = value.modelRef.modelTypes[0];
+        return `{ kind: "modelRef", model: "${modelKey}" }`;
+      }
+    default:
+      return `{ kind: "primitive" }`;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Ref type detection (for import generation)
+// ---------------------------------------------------------------------------
+
+/**
+ * Detect which external ref types (DocumentRef, MediaRef, ObjectRef, UserRef)
+ * are used anywhere in the IR schema.
+ */
+export function detectUsedRefTypes(ir) {
+  const refTypes = new Set();
+  for (const modelDef of Object.values(ir.models)) {
+    if (modelDef.type === "record") {
+      for (const field of modelDef.record.fields) {
+        scanFieldTypeForRefs(field.fieldType, refTypes);
+      }
+    }
+  }
+  return refTypes;
+}
+function scanFieldTypeForRefs(fieldType, out) {
+  switch (fieldType.type) {
+    case "array":
+      scanFieldValueForRefs(fieldType.array.value, out);
+      break;
+    case "value":
+      scanFieldValueForRefs(fieldType.value, out);
+      break;
+  }
+}
+function scanFieldValueForRefs(value, out) {
+  switch (value.type) {
+    case "docRef":
+      out.add("DocumentRef");
+      break;
+    case "mediaRef":
+      out.add("MediaRef");
+      break;
+    case "object":
+      out.add("ObjectRef");
+      break;
+    case "userRef":
+      out.add("UserRef");
+      break;
+  }
+}
+
+/**
+ * Collect schema-local type references (versioned type names) from a field type.
+ */
+export function collectReferencedTypes(fieldType, version, out) {
+  switch (fieldType.type) {
+    case "array":
+      collectReferencedValuesTypes(fieldType.array.value, version, out);
+      break;
+    case "value":
+      collectReferencedValuesTypes(fieldType.value, version, out);
+      break;
+  }
+}
+function collectReferencedValuesTypes(value, version, out) {
+  if (value.type === "modelRef") {
+    const modelKey = value.modelRef.modelTypes[0];
+    out.add(versionedTypeName(modelKey, version));
+  }
+}
+
+// ---------------------------------------------------------------------------
+// External ref field type detection (for model metadata)
+// ---------------------------------------------------------------------------
+
+/**
+ * Detect the external ref type (docRef, mediaRef, objectRef, userRef) of a field, if any.
+ */
+export function findExternalRefType(fieldType) {
+  switch (fieldType.type) {
+    case "array":
+      return findExternalRefValueType(fieldType.array.value);
+    case "value":
+      return findExternalRefValueType(fieldType.value);
+    default:
+      return undefined;
+  }
+}
+function findExternalRefValueType(value) {
+  switch (value.type) {
+    case "docRef":
+      return "docRef";
+    case "mediaRef":
+      return "mediaRef";
+    case "object":
+      return "objectRef";
+    case "userRef":
+      return "userRef";
+    default:
+      return undefined;
+  }
+}
+//# sourceMappingURL=irFieldHelpers.js.map

package/build/esm/utils/ir/irFieldHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"irFieldHelpers.js","names":["versionedSchemaName","versionedTypeName","convertFieldTypeToTypeScript","fieldType","version","type","convertCollectionValueToTypeScript","array","Error","convertFieldValueToTypeScript","value","collection","modelKey","modelRef","modelTypes","convertFieldTypeToZodSchema","inner","convertFieldValueToZodSchema","optSuffix","allowNullValue","refSchemaName","refTypeName","convertFieldTypeToInternalTypeScript","isOptional","base","convertFieldTypeToInternalTsInner","convertCollectionValueToInternalTs","needsParens","includes","startsWith","wrapped","convertFieldValueToInternalTs","convertFieldTypeToInternalZod","convertFieldTypeToInternalZodInner","endsWith","convertCollectionValueToInternalZod","convertFieldValueToInternalZod","convertFieldTypeToDescriptor","convertFieldTypeToDescriptorInner","convertCollectionValueToDescriptor","convertFieldValueToDescriptor","detectUsedRefTypes","ir","refTypes","Set","modelDef","Object","values","models","field","record","fields","scanFieldTypeForRefs","out","scanFieldValueForRefs","add","collectReferencedTypes","collectReferencedValuesTypes","findExternalRefType","findExternalRefValueType","undefined"],"sources":["irFieldHelpers.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 { IFieldTypeCollection } from \"../../lib/pack-docschema-api/pack-docschema-ir/fieldTypeCollection.js\";\nimport type { IFieldTypeUnion } from \"../../lib/pack-docschema-api/pack-docschema-ir/fieldTypeUnion.js\";\nimport type { IFieldValueUnion } from \"../../lib/pack-docschema-api/pack-docschema-ir/fieldValueUnion.js\";\nimport type { IRealTimeDocumentSchema } from \"../../lib/pack-docschema-api/pack-docschema-ir/realTimeDocumentSchema.js\";\nimport { versionedSchemaName, versionedTypeName } from \"../schema/runtimeSchema.js\";\n\n// ---------------------------------------------------------------------------\n// Public read-type TypeScript conversion\n// ---------------------------------------------------------------------------\n\n/**\n * Convert an IR field type to a TypeScript type string for public read types.\n */\nexport function convertFieldTypeToTypeScript(\n  fieldType: IFieldTypeUnion,\n  version?: number,\n): string {\n  switch (fieldType.type) {\n    case \"array\":\n      return `readonly ${convertCollectionValueToTypeScript(fieldType.array, version)}[]`;\n    case \"map\":\n    case \"set\":\n      throw new Error(`${fieldType.type} is not yet supported in TypeScript generation`);\n    case \"value\":\n      return convertFieldValueToTypeScript(fieldType.value, version);\n  }\n}\n\nfunction convertCollectionValueToTypeScript(\n  collection: IFieldTypeCollection,\n  version?: number,\n): string {\n  // allowNullValue is ignored in public read types (current behavior)\n  return convertFieldValueToTypeScript(collection.value, version);\n}\n\nfunction convertFieldValueToTypeScript(\n  value: IFieldValueUnion,\n  version?: number,\n): string {\n  switch (value.type) {\n    case \"boolean\":\n      return \"boolean\";\n    case \"datetime\":\n      return \"string\";\n    case \"docRef\":\n      return \"DocumentRef\";\n    case \"double\":\n      return \"number\";\n    case \"integer\":\n      return \"number\";\n    case \"mediaRef\":\n      return \"MediaRef\";\n    case \"modelRef\": {\n      const modelKey = value.modelRef.modelTypes[0]!;\n      return version != null ? versionedTypeName(modelKey, version) : modelKey;\n    }\n    case \"object\":\n      return \"ObjectRef\";\n    case \"string\":\n      return \"string\";\n    case \"text\":\n      return \"string\";\n    case \"unmanagedJson\":\n      return \"any\";\n    case \"userRef\":\n      return \"UserRef\";\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Zod schema conversion\n// ---------------------------------------------------------------------------\n\n/**\n * Convert an IR field type to a Zod schema string.\n */\nexport function convertFieldTypeToZodSchema(\n  fieldType: IFieldTypeUnion,\n  version?: number,\n): string {\n  switch (fieldType.type) {\n    case \"array\": {\n      const inner = convertFieldValueToZodSchema(fieldType.array.value, version);\n      const optSuffix = fieldType.array.allowNullValue ? \".optional()\" : \"\";\n      return `z.array(${inner}${optSuffix})`;\n    }\n    case \"map\":\n    case \"set\":\n      throw new Error(`${fieldType.type} is not yet supported in Zod generation`);\n    case \"value\":\n      return convertFieldValueToZodSchema(fieldType.value, version);\n  }\n}\n\nfunction convertFieldValueToZodSchema(\n  value: IFieldValueUnion,\n  version?: number,\n): string {\n  switch (value.type) {\n    case \"boolean\":\n      return \"z.boolean()\";\n    case \"datetime\":\n    case \"docRef\":\n    case \"mediaRef\":\n    case \"object\":\n    case \"string\":\n    case \"text\":\n    case \"userRef\":\n      return \"z.string()\";\n    case \"double\":\n    case \"integer\":\n      return \"z.number()\";\n    case \"modelRef\": {\n      const modelKey = value.modelRef.modelTypes[0]!;\n      const refSchemaName = version != null\n        ? versionedSchemaName(modelKey, version)\n        : `${modelKey}Schema`;\n      const refTypeName = version != null ? versionedTypeName(modelKey, version) : modelKey;\n      return `z.lazy((): ZodType<${refTypeName}> => ${refSchemaName})`;\n    }\n    case \"unmanagedJson\":\n      return \"z.unknown()\";\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal TypeScript conversion (refs → unknown, external refs → string)\n// ---------------------------------------------------------------------------\n\n/**\n * Convert an IR field type to a TypeScript string for internal types.\n */\nexport function convertFieldTypeToInternalTypeScript(\n  fieldType: IFieldTypeUnion,\n  isOptional: boolean,\n): string {\n  const base = convertFieldTypeToInternalTsInner(fieldType);\n  if (isOptional) {\n    return `(${base} | undefined)`;\n  }\n  return base;\n}\n\nfunction convertFieldTypeToInternalTsInner(fieldType: IFieldTypeUnion): string {\n  switch (fieldType.type) {\n    case \"array\": {\n      const inner = convertCollectionValueToInternalTs(fieldType.array);\n      const needsParens = inner.includes(\"|\") || inner.startsWith(\"readonly \");\n      const wrapped = needsParens ? `(${inner})` : inner;\n      return `readonly ${wrapped}[]`;\n    }\n    case \"map\":\n    case \"set\":\n      throw new Error(`${fieldType.type} is not yet supported in internal TypeScript generation`);\n    case \"value\":\n      return convertFieldValueToInternalTs(fieldType.value);\n  }\n}\n\nfunction convertCollectionValueToInternalTs(collection: IFieldTypeCollection): string {\n  const base = convertFieldValueToInternalTs(collection.value);\n  if (collection.allowNullValue) {\n    return `(${base} | undefined)`;\n  }\n  return base;\n}\n\nfunction convertFieldValueToInternalTs(value: IFieldValueUnion): string {\n  switch (value.type) {\n    case \"boolean\":\n      return \"boolean\";\n    case \"double\":\n    case \"integer\":\n      return \"number\";\n    case \"datetime\":\n    case \"docRef\":\n    case \"mediaRef\":\n    case \"object\":\n    case \"string\":\n    case \"text\":\n    case \"userRef\":\n      return \"string\";\n    case \"modelRef\":\n    case \"unmanagedJson\":\n      return \"unknown\";\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal Zod schema conversion\n// ---------------------------------------------------------------------------\n\n/**\n * Convert an IR field type to a Zod schema string for internal schemas.\n */\nexport function convertFieldTypeToInternalZod(\n  fieldType: IFieldTypeUnion,\n  isOptional: boolean,\n): string {\n  const base = convertFieldTypeToInternalZodInner(fieldType);\n  if (isOptional) {\n    if (base.endsWith(\".optional()\")) {\n      return base;\n    }\n    return `${base}.optional()`;\n  }\n  return base;\n}\n\nfunction convertFieldTypeToInternalZodInner(fieldType: IFieldTypeUnion): string {\n  switch (fieldType.type) {\n    case \"array\": {\n      const inner = convertCollectionValueToInternalZod(fieldType.array);\n      return `z.array(${inner})`;\n    }\n    case \"map\":\n    case \"set\":\n      throw new Error(`${fieldType.type} is not yet supported in internal Zod generation`);\n    case \"value\":\n      return convertFieldValueToInternalZod(fieldType.value);\n  }\n}\n\nfunction convertCollectionValueToInternalZod(collection: IFieldTypeCollection): string {\n  const base = convertFieldValueToInternalZod(collection.value);\n  if (collection.allowNullValue) {\n    return `${base}.optional()`;\n  }\n  return base;\n}\n\nfunction convertFieldValueToInternalZod(value: IFieldValueUnion): string {\n  switch (value.type) {\n    case \"boolean\":\n      return \"z.boolean()\";\n    case \"double\":\n    case \"integer\":\n      return \"z.number()\";\n    case \"datetime\":\n    case \"docRef\":\n    case \"mediaRef\":\n    case \"object\":\n    case \"string\":\n    case \"text\":\n    case \"userRef\":\n      return \"z.string()\";\n    case \"modelRef\":\n    case \"unmanagedJson\":\n      return \"z.unknown()\";\n  }\n}\n\n// ---------------------------------------------------------------------------\n// FieldTypeDescriptor conversion (for UpgradeLens)\n// ---------------------------------------------------------------------------\n\n/**\n * Convert an IR field type to a FieldTypeDescriptor source string for UpgradeLens.\n */\nexport function convertFieldTypeToDescriptor(\n  fieldType: IFieldTypeUnion,\n  isOptional: boolean,\n): string {\n  const base = convertFieldTypeToDescriptorInner(fieldType);\n  if (isOptional) {\n    return `{ kind: \"optional\", inner: ${base} }`;\n  }\n  return base;\n}\n\nfunction convertFieldTypeToDescriptorInner(fieldType: IFieldTypeUnion): string {\n  switch (fieldType.type) {\n    case \"array\": {\n      const inner = convertCollectionValueToDescriptor(fieldType.array);\n      return `{ kind: \"array\", element: ${inner} }`;\n    }\n    case \"map\":\n    case \"set\":\n      throw new Error(`${fieldType.type} is not yet supported in descriptor generation`);\n    case \"value\":\n      return convertFieldValueToDescriptor(fieldType.value);\n  }\n}\n\nfunction convertCollectionValueToDescriptor(collection: IFieldTypeCollection): string {\n  const base = convertFieldValueToDescriptor(collection.value);\n  if (collection.allowNullValue) {\n    return `{ kind: \"optional\", inner: ${base} }`;\n  }\n  return base;\n}\n\nfunction convertFieldValueToDescriptor(value: IFieldValueUnion): string {\n  switch (value.type) {\n    case \"modelRef\": {\n      const modelKey = value.modelRef.modelTypes[0]!;\n      return `{ kind: \"modelRef\", model: \"${modelKey}\" }`;\n    }\n    default:\n      return `{ kind: \"primitive\" }`;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Ref type detection (for import generation)\n// ---------------------------------------------------------------------------\n\n/**\n * Detect which external ref types (DocumentRef, MediaRef, ObjectRef, UserRef)\n * are used anywhere in the IR schema.\n */\nexport function detectUsedRefTypes(ir: IRealTimeDocumentSchema): Set<string> {\n  const refTypes = new Set<string>();\n\n  for (const modelDef of Object.values(ir.models)) {\n    if (modelDef.type === \"record\") {\n      for (const field of modelDef.record.fields) {\n        scanFieldTypeForRefs(field.fieldType, refTypes);\n      }\n    }\n  }\n\n  return refTypes;\n}\n\nfunction scanFieldTypeForRefs(fieldType: IFieldTypeUnion, out: Set<string>): void {\n  switch (fieldType.type) {\n    case \"array\":\n      scanFieldValueForRefs(fieldType.array.value, out);\n      break;\n    case \"value\":\n      scanFieldValueForRefs(fieldType.value, out);\n      break;\n  }\n}\n\nfunction scanFieldValueForRefs(value: IFieldValueUnion, out: Set<string>): void {\n  switch (value.type) {\n    case \"docRef\":\n      out.add(\"DocumentRef\");\n      break;\n    case \"mediaRef\":\n      out.add(\"MediaRef\");\n      break;\n    case \"object\":\n      out.add(\"ObjectRef\");\n      break;\n    case \"userRef\":\n      out.add(\"UserRef\");\n      break;\n  }\n}\n\n/**\n * Collect schema-local type references (versioned type names) from a field type.\n */\nexport function collectReferencedTypes(\n  fieldType: IFieldTypeUnion,\n  version: number,\n  out: Set<string>,\n): void {\n  switch (fieldType.type) {\n    case \"array\":\n      collectReferencedValuesTypes(fieldType.array.value, version, out);\n      break;\n    case \"value\":\n      collectReferencedValuesTypes(fieldType.value, version, out);\n      break;\n  }\n}\n\nfunction collectReferencedValuesTypes(\n  value: IFieldValueUnion,\n  version: number,\n  out: Set<string>,\n): void {\n  if (value.type === \"modelRef\") {\n    const modelKey = value.modelRef.modelTypes[0]!;\n    out.add(versionedTypeName(modelKey, version));\n  }\n}\n\n// ---------------------------------------------------------------------------\n// External ref field type detection (for model metadata)\n// ---------------------------------------------------------------------------\n\n/**\n * Detect the external ref type (docRef, mediaRef, objectRef, userRef) of a field, if any.\n */\nexport function findExternalRefType(fieldType: IFieldTypeUnion): string | undefined {\n  switch (fieldType.type) {\n    case \"array\":\n      return findExternalRefValueType(fieldType.array.value);\n    case \"value\":\n      return findExternalRefValueType(fieldType.value);\n    default:\n      return undefined;\n  }\n}\n\nfunction findExternalRefValueType(value: IFieldValueUnion): string | undefined {\n  switch (value.type) {\n    case \"docRef\":\n      return \"docRef\";\n    case \"mediaRef\":\n      return \"mediaRef\";\n    case \"object\":\n      return \"objectRef\";\n    case \"userRef\":\n      return \"userRef\";\n    default:\n      return undefined;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/utils/schema/__tests__/__snapshots__/generateVersionsFromSchema/single-version.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=single-version.js.map

package/build/esm/utils/schema/__tests__/__snapshots__/generateVersionsFromSchema/single-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-version.js","names":[],"sources":["single-version.ts"],"sourcesContent":["// ============================================================\n// versions.ts\n// ============================================================\n\n/* Generated by @palantir/pack.document-schema.type-gen@0.10.0 */\n\nexport type SupportedVersions = 1;\nexport type LatestVersion = 1;\nexport type MinSupportedVersion = 1;\n"],"mappings":"","ignoreList":[]}

package/build/esm/utils/schema/__tests__/__snapshots__/generateVersionsFromSchema/three-version-chain.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=three-version-chain.js.map

package/build/esm/utils/schema/__tests__/__snapshots__/generateVersionsFromSchema/three-version-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-version-chain.js","names":[],"sources":["three-version-chain.ts"],"sourcesContent":["// ============================================================\n// versions.ts\n// ============================================================\n\n/* Generated by @palantir/pack.document-schema.type-gen@0.10.0 */\n\nexport type SupportedVersions = 1 | 2 | 3;\nexport type LatestVersion = 3;\nexport type MinSupportedVersion = 1;\n"],"mappings":"","ignoreList":[]}

package/build/esm/utils/schema/__tests__/__snapshots__/generateVersionsFromSchema/two-version.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=two-version.js.map

package/build/esm/utils/schema/__tests__/__snapshots__/generateVersionsFromSchema/two-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"two-version.js","names":[],"sources":["two-version.ts"],"sourcesContent":["// ============================================================\n// versions.ts\n// ============================================================\n\n/* Generated by @palantir/pack.document-schema.type-gen@0.10.0 */\n\nexport type SupportedVersions = 1 | 2;\nexport type LatestVersion = 2;\nexport type MinSupportedVersion = 1;\n"],"mappings":"","ignoreList":[]}

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

@@ -217,5 +217,18 @@ describe("convertSchemaToSteps", () => {
       await expect(yamlOutput).toMatchFileSnapshot(snapshotPath);
     });
   });
+  it("rejects aliased schemas where exportKey differs from declared name", () => {
+    const schema = P.defineMigration({}, () => {
+      return {
+        FooAlias: P.defineRecord("Foo", {
+          docs: "A foo",
+          fields: {
+            x: P.String
+          }
+        })
+      };
+    });
+    expect(() => convertSchemaToSteps(schema)).toThrow(/cannot represent aliases/);
+  });
 });
 //# sourceMappingURL=convertSchemaToSteps.test.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"convertSchemaToSteps.test.js","names":["P","path","describe","expect","it","convertSchemaToSteps","convertStepsToYamlString","schema","defineMigration","Person","defineRecord","docs","fields","name","String","age","Double","email","Optional","steps","toHaveLength","toHaveProperty","toEqual","Company","Entity","defineUnion","variants","person","company","ObjectNode","x","Container","items","Array","values","Node","Edge","source","target","y","label","TextBox","text","object","textBox","yamlOutput","snapshotPath","join","__dirname","toMatchFileSnapshot","OtherRecord","id","AllFieldTypes","stringField","doubleField","booleanField","Boolean","optionalField","arrayField","unknownField","Unknown","refField"],"sources":["convertSchemaToSteps.test.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 * as P from \"@palantir/pack.schema\";\nimport path from \"path\";\nimport { describe, expect, it } from \"vitest\";\nimport { convertSchemaToSteps, convertStepsToYamlString } from \"../convertSchemaToSteps.js\";\n\ndescribe(\"convertSchemaToSteps\", () => {\n  it(\"should convert a simple record schema to YAML steps\", () => {\n    const schema = P.defineMigration({}, () => {\n      const Person = P.defineRecord(\"Person\", {\n        docs: \"A person record\",\n        fields: {\n          name: P.String,\n          age: P.Double,\n          email: P.Optional(P.String),\n        },\n      });\n      return { Person };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps).toHaveLength(1);\n    expect(steps[0]).toHaveProperty(\"add-records\");\n    expect(steps[0]![\"add-records\"]).toHaveProperty(\"Person\");\n    expect(steps[0]![\"add-records\"]!.Person!.fields).toEqual({\n      name: \"string\",\n      age: \"double\",\n      email: \"optional<string>\",\n    });\n  });\n\n  it(\"should handle union types\", () => {\n    const schema = P.defineMigration({}, () => {\n      const Person = P.defineRecord(\"Person\", {\n        docs: \"A person record\",\n        fields: {\n          name: P.String,\n        },\n      });\n\n      const Company = P.defineRecord(\"Company\", {\n        docs: \"A company record\",\n        fields: {\n          name: P.String,\n        },\n      });\n\n      const Entity = P.defineUnion(\"Entity\", {\n        docs: \"Entity union\",\n        variants: {\n          person: Person,\n          company: Company,\n        },\n      });\n\n      return { Person, Company, Entity };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps).toHaveLength(2);\n    expect(steps[0]![\"add-records\"]).toHaveProperty(\"Person\");\n    expect(steps[0]![\"add-records\"]).toHaveProperty(\"Company\");\n    expect(steps[1]![\"add-union\"]).toHaveProperty(\"Entity\");\n    expect(steps[1]![\"add-union\"]!.Entity).toEqual({\n      variants: {\n        person: \"Person\",\n        company: \"Company\",\n      },\n    });\n  });\n\n  it(\"should preserve record names as defined\", () => {\n    const schema = P.defineMigration({}, () => {\n      const ObjectNode = P.defineRecord(\"ObjectNode\", {\n        docs: \"Object node\",\n        fields: {\n          x: P.Double,\n        },\n      });\n      return { ObjectNode };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps[0]![\"add-records\"]).toHaveProperty(\"ObjectNode\");\n  });\n\n  it(\"should handle array types\", () => {\n    const schema = P.defineMigration({}, () => {\n      const Container = P.defineRecord(\"Container\", {\n        docs: \"Container record\",\n        fields: {\n          items: P.Array(P.String),\n          values: P.Array(P.Double),\n        },\n      });\n      return { Container };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps[0]![\"add-records\"]!.Container!.fields).toEqual({\n      items: \"array<string>\",\n      values: \"array<double>\",\n    });\n  });\n\n  it(\"should handle record references\", () => {\n    const schema = P.defineMigration({}, () => {\n      const Node = P.defineRecord(\"Node\", {\n        docs: \"Node record\",\n        fields: {\n          x: P.Double,\n        },\n      });\n\n      const Edge = P.defineRecord(\"Edge\", {\n        docs: \"Edge record\",\n        fields: {\n          source: () => Node,\n          target: () => Node,\n        },\n      });\n      return { Edge };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps[0]![\"add-records\"]!.Edge!.fields).toEqual({\n      source: \"Node\",\n      target: \"Node\",\n    });\n  });\n\n  describe(\"YAML output snapshots\", () => {\n    it(\"should generate correct YAML for complex schema\", async () => {\n      const schema = P.defineMigration({}, () => {\n        const ObjectNode = P.defineRecord(\"ObjectNode\", {\n          docs: \"Represents a node in a graph\",\n          fields: {\n            x: P.Double,\n            y: P.Double,\n            label: P.Optional(P.String),\n          },\n        });\n\n        const TextBox = P.defineRecord(\"TextBox\", {\n          docs: \"Represents a text box\",\n          fields: {\n            x: P.Double,\n            y: P.Double,\n            text: P.String,\n          },\n        });\n\n        const Edge = P.defineRecord(\"Edge\", {\n          docs: \"Represents an edge\",\n          fields: {\n            source: () => ObjectNode,\n            target: () => ObjectNode,\n          },\n        });\n\n        const Node = P.defineUnion(\"Node\", {\n          docs: \"Node union\",\n          variants: {\n            object: ObjectNode,\n            textBox: TextBox,\n          },\n        });\n\n        return { ObjectNode, TextBox, Edge, Node };\n      });\n\n      const steps = convertSchemaToSteps(schema);\n      const yamlOutput = convertStepsToYamlString(steps);\n      const snapshotPath = path.join(__dirname, \"__snapshots__\", \"schema\", \"complex-schema.yaml\");\n\n      await expect(yamlOutput).toMatchFileSnapshot(snapshotPath);\n    });\n\n    it(\"should generate correct YAML for schema with various field types\", async () => {\n      const schema = P.defineMigration({}, () => {\n        const OtherRecord = P.defineRecord(\"OtherRecord\", {\n          docs: \"Other record\",\n          fields: {\n            id: P.String,\n          },\n        });\n\n        const AllFieldTypes = P.defineRecord(\"AllFieldTypes\", {\n          docs: \"Test all field types\",\n          fields: {\n            stringField: P.String,\n            doubleField: P.Double,\n            booleanField: P.Optional(P.Boolean),\n            optionalField: P.Optional(P.String),\n            arrayField: P.Array(P.Double),\n            unknownField: P.Unknown,\n            refField: () => OtherRecord,\n          },\n        });\n\n        return { OtherRecord, AllFieldTypes };\n      });\n\n      const steps = convertSchemaToSteps(schema);\n      const yamlOutput = convertStepsToYamlString(steps);\n      const snapshotPath = path.join(__dirname, \"__snapshots__\", \"schema\", \"all-field-types.yaml\");\n\n      await expect(yamlOutput).toMatchFileSnapshot(snapshotPath);\n    });\n  });\n});\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"convertSchemaToSteps.test.js","names":["P","path","describe","expect","it","convertSchemaToSteps","convertStepsToYamlString","schema","defineMigration","Person","defineRecord","docs","fields","name","String","age","Double","email","Optional","steps","toHaveLength","toHaveProperty","toEqual","Company","Entity","defineUnion","variants","person","company","ObjectNode","x","Container","items","Array","values","Node","Edge","source","target","y","label","TextBox","text","object","textBox","yamlOutput","snapshotPath","join","__dirname","toMatchFileSnapshot","OtherRecord","id","AllFieldTypes","stringField","doubleField","booleanField","Boolean","optionalField","arrayField","unknownField","Unknown","refField","FooAlias","toThrow"],"sources":["convertSchemaToSteps.test.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 * as P from \"@palantir/pack.schema\";\nimport path from \"path\";\nimport { describe, expect, it } from \"vitest\";\nimport { convertSchemaToSteps, convertStepsToYamlString } from \"../convertSchemaToSteps.js\";\n\ndescribe(\"convertSchemaToSteps\", () => {\n  it(\"should convert a simple record schema to YAML steps\", () => {\n    const schema = P.defineMigration({}, () => {\n      const Person = P.defineRecord(\"Person\", {\n        docs: \"A person record\",\n        fields: {\n          name: P.String,\n          age: P.Double,\n          email: P.Optional(P.String),\n        },\n      });\n      return { Person };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps).toHaveLength(1);\n    expect(steps[0]).toHaveProperty(\"add-records\");\n    expect(steps[0]![\"add-records\"]).toHaveProperty(\"Person\");\n    expect(steps[0]![\"add-records\"]!.Person!.fields).toEqual({\n      name: \"string\",\n      age: \"double\",\n      email: \"optional<string>\",\n    });\n  });\n\n  it(\"should handle union types\", () => {\n    const schema = P.defineMigration({}, () => {\n      const Person = P.defineRecord(\"Person\", {\n        docs: \"A person record\",\n        fields: {\n          name: P.String,\n        },\n      });\n\n      const Company = P.defineRecord(\"Company\", {\n        docs: \"A company record\",\n        fields: {\n          name: P.String,\n        },\n      });\n\n      const Entity = P.defineUnion(\"Entity\", {\n        docs: \"Entity union\",\n        variants: {\n          person: Person,\n          company: Company,\n        },\n      });\n\n      return { Person, Company, Entity };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps).toHaveLength(2);\n    expect(steps[0]![\"add-records\"]).toHaveProperty(\"Person\");\n    expect(steps[0]![\"add-records\"]).toHaveProperty(\"Company\");\n    expect(steps[1]![\"add-union\"]).toHaveProperty(\"Entity\");\n    expect(steps[1]![\"add-union\"]!.Entity).toEqual({\n      variants: {\n        person: \"Person\",\n        company: \"Company\",\n      },\n    });\n  });\n\n  it(\"should preserve record names as defined\", () => {\n    const schema = P.defineMigration({}, () => {\n      const ObjectNode = P.defineRecord(\"ObjectNode\", {\n        docs: \"Object node\",\n        fields: {\n          x: P.Double,\n        },\n      });\n      return { ObjectNode };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps[0]![\"add-records\"]).toHaveProperty(\"ObjectNode\");\n  });\n\n  it(\"should handle array types\", () => {\n    const schema = P.defineMigration({}, () => {\n      const Container = P.defineRecord(\"Container\", {\n        docs: \"Container record\",\n        fields: {\n          items: P.Array(P.String),\n          values: P.Array(P.Double),\n        },\n      });\n      return { Container };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps[0]![\"add-records\"]!.Container!.fields).toEqual({\n      items: \"array<string>\",\n      values: \"array<double>\",\n    });\n  });\n\n  it(\"should handle record references\", () => {\n    const schema = P.defineMigration({}, () => {\n      const Node = P.defineRecord(\"Node\", {\n        docs: \"Node record\",\n        fields: {\n          x: P.Double,\n        },\n      });\n\n      const Edge = P.defineRecord(\"Edge\", {\n        docs: \"Edge record\",\n        fields: {\n          source: () => Node,\n          target: () => Node,\n        },\n      });\n      return { Edge };\n    });\n\n    const steps = convertSchemaToSteps(schema);\n\n    expect(steps[0]![\"add-records\"]!.Edge!.fields).toEqual({\n      source: \"Node\",\n      target: \"Node\",\n    });\n  });\n\n  describe(\"YAML output snapshots\", () => {\n    it(\"should generate correct YAML for complex schema\", async () => {\n      const schema = P.defineMigration({}, () => {\n        const ObjectNode = P.defineRecord(\"ObjectNode\", {\n          docs: \"Represents a node in a graph\",\n          fields: {\n            x: P.Double,\n            y: P.Double,\n            label: P.Optional(P.String),\n          },\n        });\n\n        const TextBox = P.defineRecord(\"TextBox\", {\n          docs: \"Represents a text box\",\n          fields: {\n            x: P.Double,\n            y: P.Double,\n            text: P.String,\n          },\n        });\n\n        const Edge = P.defineRecord(\"Edge\", {\n          docs: \"Represents an edge\",\n          fields: {\n            source: () => ObjectNode,\n            target: () => ObjectNode,\n          },\n        });\n\n        const Node = P.defineUnion(\"Node\", {\n          docs: \"Node union\",\n          variants: {\n            object: ObjectNode,\n            textBox: TextBox,\n          },\n        });\n\n        return { ObjectNode, TextBox, Edge, Node };\n      });\n\n      const steps = convertSchemaToSteps(schema);\n      const yamlOutput = convertStepsToYamlString(steps);\n      const snapshotPath = path.join(__dirname, \"__snapshots__\", \"schema\", \"complex-schema.yaml\");\n\n      await expect(yamlOutput).toMatchFileSnapshot(snapshotPath);\n    });\n\n    it(\"should generate correct YAML for schema with various field types\", async () => {\n      const schema = P.defineMigration({}, () => {\n        const OtherRecord = P.defineRecord(\"OtherRecord\", {\n          docs: \"Other record\",\n          fields: {\n            id: P.String,\n          },\n        });\n\n        const AllFieldTypes = P.defineRecord(\"AllFieldTypes\", {\n          docs: \"Test all field types\",\n          fields: {\n            stringField: P.String,\n            doubleField: P.Double,\n            booleanField: P.Optional(P.Boolean),\n            optionalField: P.Optional(P.String),\n            arrayField: P.Array(P.Double),\n            unknownField: P.Unknown,\n            refField: () => OtherRecord,\n          },\n        });\n\n        return { OtherRecord, AllFieldTypes };\n      });\n\n      const steps = convertSchemaToSteps(schema);\n      const yamlOutput = convertStepsToYamlString(steps);\n      const snapshotPath = path.join(__dirname, \"__snapshots__\", \"schema\", \"all-field-types.yaml\");\n\n      await expect(yamlOutput).toMatchFileSnapshot(snapshotPath);\n    });\n  });\n\n  it(\"rejects aliased schemas where exportKey differs from declared name\", () => {\n    const schema = P.defineMigration({}, () => {\n      return {\n        FooAlias: P.defineRecord(\"Foo\", {\n          docs: \"A foo\",\n          fields: { x: P.String },\n        }),\n      };\n    });\n\n    expect(() => convertSchemaToSteps(schema)).toThrow(/cannot represent aliases/);\n  });\n});\n"],"mappings":"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","ignoreList":[]}