@palantir/pack.schema 0.0.1-beta.1

package/.turbo/turbo-lint.log

@@ -0,0 +1,4 @@
+
+> @palantir/pack.schema@0.0.1-beta.1 lint /home/runner/work/pack/pack/packages/schema
+> eslint ./src ; dprint check --config $(find-up dprint.json) --allow-no-files
+

package/.turbo/turbo-transpileBrowser.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.schema@0.0.1-beta.1 transpileBrowser /home/runner/work/pack/pack/packages/schema
+> monorepo-transpile -f esm -m bundle -t browser
+
+👍

package/.turbo/turbo-transpileCjs.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.schema@0.0.1-beta.1 transpileCjs /home/runner/work/pack/pack/packages/schema
+> monorepo-transpile -f cjs -m bundle -t node
+
+👍

package/.turbo/turbo-transpileEsm.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.schema@0.0.1-beta.1 transpileEsm /home/runner/work/pack/pack/packages/schema
+> monorepo-transpile -f esm -m bundle -t node
+
+👍

package/.turbo/turbo-transpileTypes.log

@@ -0,0 +1,5 @@
+
+> @palantir/pack.schema@0.0.1-beta.1 transpileTypes /home/runner/work/pack/pack/packages/schema
+> monorepo-transpile -f esm -m types -t node
+
+👍

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @palantir/pack.schema@0.0.1-beta.1 typecheck /home/runner/work/pack/pack/packages/schema
+> tsc --noEmit --emitDeclarationOnly false
+

package/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2025 Palantir Technologies, Inc.
+
+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.

package/README.md

@@ -0,0 +1,87 @@
+# @palantir/pack.schema
+
+Programmatic API for defining schemas using TypeScript builders, providing type-safe schema definition with records, unions, and migrations.
+
+## Overview
+
+This package provides builder functions and types for defining document schemas programmatically in TypeScript. It offers an alternative to YAML-based schema definitions, allowing for type-safe schema construction with full IDE support.
+
+## Key Exports
+
+### Schema Definition Functions
+
+- `defineRecord(name, config)` - Define record types with fields and documentation
+- `defineUnion(name, variants)` - Define discriminated unions of record types
+- `defineMigration(previousSchema, migrationFn)` - Define schema migrations
+
+### Type System
+
+- `Type` - Base type for all PACK field types
+- `String`, `Double` - Primitive field types
+- `Array<T>`, `Optional<T>` - Composite field types
+- `Ref` - References to other defined records/unions
+
+### Utilities
+
+- Field validation and resolution utilities
+- Schema conversion and processing functions
+
+## Usage
+
+```typescript
+import * as P from "@pack/document-schema-api";
+
+// Define a record type
+const Position = P.defineRecord("Position", {
+  docs: "A position in 2D space",
+  fields: {
+    x: P.Double,
+    y: P.Double,
+  },
+});
+
+// Define a record with optional fields and references
+const Node = P.defineRecord("Node", {
+  docs: "A node in the graph",
+  extends: [Position],
+  fields: {
+    label: P.Optional(P.String),
+    connections: P.Array(Ref(() => Node)), // Forward reference
+  },
+});
+
+// Define a union type
+const Shape = P.defineUnion("Shape", {
+  circle: Circle,
+  rectangle: Rectangle,
+  node: Node,
+});
+
+// Define a migration
+const v2Schema = P.defineMigration(v1Schema, schema => {
+  // Migration logic
+  return schema;
+});
+```
+
+## Field Types
+
+### Primitives
+
+- `String` - String values
+- `Double` - Numeric values
+- `Unknown` - Any value type
+
+### Composites
+
+- `Array<T>` - Arrays of type T
+- `Optional<T>` - Optional values of type T
+- `Ref<T>` - References to other defined types
+
+## Features
+
+- **Type Safety** - Full TypeScript type checking during schema definition
+- **Forward References** - Support for circular/forward references using functions
+- **Schema Evolution** - Migration system for schema versioning
+- **IDE Support** - IntelliSense and auto-completion for schema building
+- **Validation** - Runtime validation of schema definitions

package/build/browser/index.js

@@ -0,0 +1,176 @@
+// src/defs.ts
+var ModelDefType = {
+  RECORD: "record",
+  UNION: "union"
+};
+
+// src/primitives.ts
+var TypeKind = {
+  ARRAY: "array",
+  DOUBLE: "double",
+  OPTIONAL: "optional",
+  REF: "ref",
+  STRING: "string",
+  UNKNOWN: "unknown"
+};
+var String = {
+  type: TypeKind.STRING
+};
+var Double = {
+  type: TypeKind.DOUBLE
+};
+var Unknown = {
+  type: TypeKind.UNKNOWN
+};
+var Array = (item) => ({
+  type: TypeKind.ARRAY,
+  items: item
+});
+var Optional = (item) => ({
+  type: TypeKind.OPTIONAL,
+  item
+});
+
+// src/utils.ts
+function modelToRef(model) {
+  return createRef(model.name, model.type);
+}
+function createRef(name, refType) {
+  return {
+    type: TypeKind.REF,
+    name,
+    refType
+  };
+}
+function isRecordDef(value) {
+  return value != null && typeof value === "object" && "type" in value && value.type === ModelDefType.RECORD && "fields" in value;
+}
+function isUnionDef(value) {
+  return value != null && typeof value === "object" && "type" in value && value.type === ModelDefType.UNION && "variants" in value;
+}
+
+// src/defineUnion.ts
+function defineUnion(name, union) {
+  const entries = Object.entries(union.variants).map(([key, value]) => [key, resolveUnionVariantArg(value)]);
+  const variants = Object.fromEntries(entries);
+  return {
+    type: ModelDefType.UNION,
+    discriminant: "type",
+    name,
+    docs: union.docs,
+    variants
+  };
+}
+function resolveUnionVariantArg(arg) {
+  const resolved = typeof arg === "function" ? arg() : arg;
+  return resolved.type === TypeKind.REF ? resolved : modelToRef(resolved);
+}
+
+// src/defineMigration.ts
+var UnionBuilderImpl = class _UnionBuilderImpl {
+  name;
+  docs;
+  variants;
+  constructor({
+    name,
+    docs,
+    variants
+  }) {
+    this.name = name;
+    this.docs = docs;
+    this.variants = {
+      ...variants
+    };
+  }
+  addVariant(variantName, modelDefOrRef) {
+    const ref = resolveUnionVariantArg(modelDefOrRef);
+    const newVariants = {
+      ...this.variants,
+      [variantName]: ref
+    };
+    return new _UnionBuilderImpl({
+      type: ModelDefType.UNION,
+      name: this.name,
+      variants: newVariants,
+      discriminant: "type"
+    });
+  }
+  build() {
+    return {
+      type: ModelDefType.UNION,
+      variants: this.variants,
+      discriminant: "type",
+      name: this.name
+    };
+  }
+};
+var RecordBuilderImpl = class _RecordBuilderImpl {
+  name;
+  fields;
+  constructor(initialRecordDef) {
+    this.name = initialRecordDef.name;
+    this.fields = {
+      ...initialRecordDef.fields
+    };
+  }
+  // TODO: resolve field value from arg instead
+  addField(name, value) {
+    return new _RecordBuilderImpl({
+      type: ModelDefType.RECORD,
+      name: this.name,
+      fields: {
+        ...this.fields,
+        [name]: value
+      },
+      docs: ""
+    });
+  }
+  build() {
+    return {
+      type: ModelDefType.RECORD,
+      name: this.name,
+      fields: this.fields,
+      docs: ""
+    };
+  }
+};
+function defineMigration(previous, migration) {
+  const builders = {};
+  for (const key in previous) {
+    const v = previous[key];
+    if (isRecordDef(v)) {
+      const recordBuilder = new RecordBuilderImpl(v);
+      builders[key] = recordBuilder;
+    } else if (isUnionDef(v)) {
+      const unionBuilder = new UnionBuilderImpl(v);
+      builders[key] = unionBuilder;
+    }
+  }
+  return {
+    ...previous,
+    ...migration(builders)
+  };
+}
+
+// src/defineRecord.ts
+function resolveFieldArg(value) {
+  const resolved = typeof value === "function" ? value() : value;
+  if (isRecordDef(resolved) || isUnionDef(resolved)) {
+    return modelToRef(resolved);
+  }
+  return resolved;
+}
+function defineRecord(name, record) {
+  const entries = Object.entries(record.fields).map(([key, value]) => [key, resolveFieldArg(value)]);
+  const fields = Object.fromEntries(entries);
+  return {
+    type: ModelDefType.RECORD,
+    name,
+    docs: record.docs,
+    fields
+  };
+}
+
+export { Array, Double, ModelDefType, Optional, String, TypeKind, Unknown, createRef, defineMigration, defineRecord, defineUnion, isRecordDef, isUnionDef, modelToRef, resolveUnionVariantArg };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/build/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/defs.ts","../../src/primitives.ts","../../src/utils.ts","../../src/defineUnion.ts","../../src/defineMigration.ts","../../src/defineRecord.ts"],"names":[],"mappings":"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","file":"index.js","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\nexport const ModelDefType = {\n  RECORD: \"record\",\n  UNION: \"union\"\n};","/*\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\nexport const TypeKind = {\n  ARRAY: \"array\",\n  DOUBLE: \"double\",\n  OPTIONAL: \"optional\",\n  REF: \"ref\",\n  STRING: \"string\",\n  UNKNOWN: \"unknown\"\n};\n\n// Forward declaration to avoid circular reference\n\n// A reference to a record or a union type\n\nexport const String = {\n  type: TypeKind.STRING\n};\nexport const Double = {\n  type: TypeKind.DOUBLE\n};\nexport const Unknown = {\n  type: TypeKind.UNKNOWN\n};\nexport const Array = item => ({\n  type: TypeKind.ARRAY,\n  items: item\n});\nexport const Optional = item => ({\n  type: TypeKind.OPTIONAL,\n  item\n});","/*\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 { ModelDefType } from \"./defs.js\";\nimport { TypeKind } from \"./primitives.js\";\n\n/**\n * Helper function to safely transform a record definition to a reference.\n * This function helps TypeScript track type transformations better.\n */\nexport function modelToRef(model) {\n  return createRef(model.name, model.type);\n}\n\n/**\n * Helper function to create a reference with proper typing.\n * This avoids type assertions in multiple places.\n */\nexport function createRef(name, refType) {\n  return {\n    type: TypeKind.REF,\n    name,\n    refType\n  };\n}\n\n/**\n * Type guard to check if a value is a RecordDef\n */\nexport function isRecordDef(value) {\n  return value != null && typeof value === \"object\" && \"type\" in value && value.type === ModelDefType.RECORD && \"fields\" in value;\n}\n\n/**\n * Type guard to check if a value is a UnionDef\n */\nexport function isUnionDef(value) {\n  return value != null && typeof value === \"object\" && \"type\" in value && value.type === ModelDefType.UNION && \"variants\" in value;\n}","/*\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 { ModelDefType } from \"./defs.js\";\nimport { TypeKind } from \"./primitives.js\";\nimport { modelToRef } from \"./utils.js\";\nexport function defineUnion(name, union) {\n  const entries = Object.entries(union.variants).map(([key, value]) => [key, resolveUnionVariantArg(value)]);\n  const variants = Object.fromEntries(entries);\n  return {\n    type: ModelDefType.UNION,\n    discriminant: \"type\",\n    name: name,\n    docs: union.docs,\n    variants\n  };\n}\nexport function resolveUnionVariantArg(arg) {\n  const resolved = typeof arg === \"function\" ? arg() : arg;\n  return resolved.type === TypeKind.REF ? resolved : modelToRef(resolved);\n}","/*\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 { resolveUnionVariantArg } from \"./defineUnion.js\";\nimport { ModelDefType } from \"./defs.js\";\nimport { isRecordDef, isUnionDef } from \"./utils.js\";\nclass UnionBuilderImpl {\n  name;\n  docs;\n  variants;\n  constructor({\n    name,\n    docs,\n    variants\n  }) {\n    this.name = name;\n    this.docs = docs;\n    this.variants = {\n      ...variants\n    };\n  }\n  addVariant(variantName, modelDefOrRef) {\n    const ref = resolveUnionVariantArg(modelDefOrRef);\n    const newVariants = {\n      ...this.variants,\n      [variantName]: ref\n    };\n    return new UnionBuilderImpl({\n      type: ModelDefType.UNION,\n      name: this.name,\n      variants: newVariants,\n      discriminant: \"type\"\n    });\n  }\n  build() {\n    return {\n      type: ModelDefType.UNION,\n      variants: this.variants,\n      discriminant: \"type\",\n      name: this.name\n    };\n  }\n}\nclass RecordBuilderImpl {\n  name;\n  fields;\n  constructor(initialRecordDef) {\n    this.name = initialRecordDef.name;\n    this.fields = {\n      ...initialRecordDef.fields\n    };\n  }\n\n  // TODO: resolve field value from arg instead\n  addField(name, value) {\n    return new RecordBuilderImpl({\n      type: ModelDefType.RECORD,\n      name: this.name,\n      fields: {\n        ...this.fields,\n        [name]: value\n      },\n      docs: \"\"\n    });\n  }\n  build() {\n    return {\n      type: ModelDefType.RECORD,\n      name: this.name,\n      fields: this.fields,\n      docs: \"\"\n    };\n  }\n}\nexport function defineMigration(previous, migration) {\n  /**\n   * Create a map of builders for the schema.\n   *\n   * Note about type assertions:\n   * We use a type assertion here (SchemaBuilder<T>) because TypeScript cannot\n   * track the relationship between the keys in the original schema and the\n   * corresponding builder types. This is a fundamental limitation of TypeScript's\n   * type system when dealing with dynamically constructed objects.\n   *\n   * The assertion is safe because:\n   * 1. We're only adding keys that exist in the original schema\n   * 2. For each key, we're creating a builder of the correct type\n   * 3. The resulting object exactly matches the SchemaBuilder<T> type\n   */\n  const builders = {};\n  for (const key in previous) {\n    const v = previous[key];\n\n    // Use our type guards for safer type narrowing\n    if (isRecordDef(v)) {\n      // This assertion is necessary because TypeScript can't track the field types\n      // through the dynamic property access and object construction\n      const recordBuilder = new RecordBuilderImpl(v);\n      builders[key] = recordBuilder;\n    } else if (isUnionDef(v)) {\n      // Similar assertion needed for union builders\n      const unionBuilder = new UnionBuilderImpl(v);\n      builders[key] = unionBuilder;\n    }\n  }\n  return {\n    ...previous,\n    ...migration(builders)\n  };\n}","/*\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 { ModelDefType } from \"./defs.js\";\nimport { isRecordDef, isUnionDef, modelToRef } from \"./utils.js\";\n/**\n * Helper function to resolve a field value, handling functions and transforming\n * types as needed.\n */\nfunction resolveFieldArg(value) {\n  // Handle function values\n  const resolved = typeof value === \"function\" ? value() : value;\n  if (isRecordDef(resolved) || isUnionDef(resolved)) {\n    return modelToRef(resolved);\n  }\n\n  // For primitive types and other Types\n  return resolved;\n}\nexport function defineRecord(name, record) {\n  const entries = Object.entries(record.fields).map(([key, value]) => [key, resolveFieldArg(value)]);\n  const fields = Object.fromEntries(entries);\n  return {\n    type: ModelDefType.RECORD,\n    name: name,\n    docs: record.docs,\n    fields\n  };\n}"]}

package/build/cjs/index.cjs

@@ -0,0 +1,192 @@
+'use strict';
+
+// src/defs.ts
+var ModelDefType = {
+  RECORD: "record",
+  UNION: "union"
+};
+
+// src/primitives.ts
+var TypeKind = {
+  ARRAY: "array",
+  DOUBLE: "double",
+  OPTIONAL: "optional",
+  REF: "ref",
+  STRING: "string",
+  UNKNOWN: "unknown"
+};
+var String = {
+  type: TypeKind.STRING
+};
+var Double = {
+  type: TypeKind.DOUBLE
+};
+var Unknown = {
+  type: TypeKind.UNKNOWN
+};
+var Array = (item) => ({
+  type: TypeKind.ARRAY,
+  items: item
+});
+var Optional = (item) => ({
+  type: TypeKind.OPTIONAL,
+  item
+});
+
+// src/utils.ts
+function modelToRef(model) {
+  return createRef(model.name, model.type);
+}
+function createRef(name, refType) {
+  return {
+    type: TypeKind.REF,
+    name,
+    refType
+  };
+}
+function isRecordDef(value) {
+  return value != null && typeof value === "object" && "type" in value && value.type === ModelDefType.RECORD && "fields" in value;
+}
+function isUnionDef(value) {
+  return value != null && typeof value === "object" && "type" in value && value.type === ModelDefType.UNION && "variants" in value;
+}
+
+// src/defineUnion.ts
+function defineUnion(name, union) {
+  const entries = Object.entries(union.variants).map(([key, value]) => [key, resolveUnionVariantArg(value)]);
+  const variants = Object.fromEntries(entries);
+  return {
+    type: ModelDefType.UNION,
+    discriminant: "type",
+    name,
+    docs: union.docs,
+    variants
+  };
+}
+function resolveUnionVariantArg(arg) {
+  const resolved = typeof arg === "function" ? arg() : arg;
+  return resolved.type === TypeKind.REF ? resolved : modelToRef(resolved);
+}
+
+// src/defineMigration.ts
+var UnionBuilderImpl = class _UnionBuilderImpl {
+  name;
+  docs;
+  variants;
+  constructor({
+    name,
+    docs,
+    variants
+  }) {
+    this.name = name;
+    this.docs = docs;
+    this.variants = {
+      ...variants
+    };
+  }
+  addVariant(variantName, modelDefOrRef) {
+    const ref = resolveUnionVariantArg(modelDefOrRef);
+    const newVariants = {
+      ...this.variants,
+      [variantName]: ref
+    };
+    return new _UnionBuilderImpl({
+      type: ModelDefType.UNION,
+      name: this.name,
+      variants: newVariants,
+      discriminant: "type"
+    });
+  }
+  build() {
+    return {
+      type: ModelDefType.UNION,
+      variants: this.variants,
+      discriminant: "type",
+      name: this.name
+    };
+  }
+};
+var RecordBuilderImpl = class _RecordBuilderImpl {
+  name;
+  fields;
+  constructor(initialRecordDef) {
+    this.name = initialRecordDef.name;
+    this.fields = {
+      ...initialRecordDef.fields
+    };
+  }
+  // TODO: resolve field value from arg instead
+  addField(name, value) {
+    return new _RecordBuilderImpl({
+      type: ModelDefType.RECORD,
+      name: this.name,
+      fields: {
+        ...this.fields,
+        [name]: value
+      },
+      docs: ""
+    });
+  }
+  build() {
+    return {
+      type: ModelDefType.RECORD,
+      name: this.name,
+      fields: this.fields,
+      docs: ""
+    };
+  }
+};
+function defineMigration(previous, migration) {
+  const builders = {};
+  for (const key in previous) {
+    const v = previous[key];
+    if (isRecordDef(v)) {
+      const recordBuilder = new RecordBuilderImpl(v);
+      builders[key] = recordBuilder;
+    } else if (isUnionDef(v)) {
+      const unionBuilder = new UnionBuilderImpl(v);
+      builders[key] = unionBuilder;
+    }
+  }
+  return {
+    ...previous,
+    ...migration(builders)
+  };
+}
+
+// src/defineRecord.ts
+function resolveFieldArg(value) {
+  const resolved = typeof value === "function" ? value() : value;
+  if (isRecordDef(resolved) || isUnionDef(resolved)) {
+    return modelToRef(resolved);
+  }
+  return resolved;
+}
+function defineRecord(name, record) {
+  const entries = Object.entries(record.fields).map(([key, value]) => [key, resolveFieldArg(value)]);
+  const fields = Object.fromEntries(entries);
+  return {
+    type: ModelDefType.RECORD,
+    name,
+    docs: record.docs,
+    fields
+  };
+}
+
+exports.Array = Array;
+exports.Double = Double;
+exports.ModelDefType = ModelDefType;
+exports.Optional = Optional;
+exports.String = String;
+exports.TypeKind = TypeKind;
+exports.Unknown = Unknown;
+exports.createRef = createRef;
+exports.defineMigration = defineMigration;
+exports.defineRecord = defineRecord;
+exports.defineUnion = defineUnion;
+exports.isRecordDef = isRecordDef;
+exports.isUnionDef = isUnionDef;
+exports.modelToRef = modelToRef;
+exports.resolveUnionVariantArg = resolveUnionVariantArg;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/build/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/defs.ts","../../src/primitives.ts","../../src/utils.ts","../../src/defineUnion.ts","../../src/defineMigration.ts","../../src/defineRecord.ts"],"names":[],"mappings":";;;AAgBO,IAAM,YAAA,GAAe;AAAA,EAC1B,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO;AACT;;;ACHO,IAAM,QAAA,GAAW;AAAA,EACtB,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,QAAA,EAAU,UAAA;AAAA,EACV,GAAA,EAAK,KAAA;AAAA,EACL,MAAA,EAAQ,QAAA;AAAA,EACR,OAAA,EAAS;AACX;AAMO,IAAM,MAAA,GAAS;AAAA,EACpB,MAAM,QAAA,CAAS;AACjB;AACO,IAAM,MAAA,GAAS;AAAA,EACpB,MAAM,QAAA,CAAS;AACjB;AACO,IAAM,OAAA,GAAU;AAAA,EACrB,MAAM,QAAA,CAAS;AACjB;AACO,IAAM,QAAQ,CAAA,IAAA,MAAS;AAAA,EAC5B,MAAM,QAAA,CAAS,KAAA;AAAA,EACf,KAAA,EAAO;AACT,CAAA;AACO,IAAM,WAAW,CAAA,IAAA,MAAS;AAAA,EAC/B,MAAM,QAAA,CAAS,QAAA;AAAA,EACf;AACF,CAAA;;;ACtBO,SAAS,WAAW,KAAA,EAAO;AAChC,EAAA,OAAO,SAAA,CAAU,KAAA,CAAM,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA;AACzC;AAMO,SAAS,SAAA,CAAU,MAAM,OAAA,EAAS;AACvC,EAAA,OAAO;AAAA,IACL,MAAM,QAAA,CAAS,GAAA;AAAA,IACf,IAAA;AAAA,IACA;AAAA,GACF;AACF;AAKO,SAAS,YAAY,KAAA,EAAO;AACjC,EAAA,OAAO,KAAA,IAAS,IAAA,IAAQ,OAAO,KAAA,KAAU,QAAA,IAAY,MAAA,IAAU,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,CAAa,MAAA,IAAU,QAAA,IAAY,KAAA;AAC5H;AAKO,SAAS,WAAW,KAAA,EAAO;AAChC,EAAA,OAAO,KAAA,IAAS,IAAA,IAAQ,OAAO,KAAA,KAAU,QAAA,IAAY,MAAA,IAAU,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,CAAa,KAAA,IAAS,UAAA,IAAc,KAAA;AAC7H;;;AChCO,SAAS,WAAA,CAAY,MAAM,KAAA,EAAO;AACvC,EAAA,MAAM,UAAU,MAAA,CAAO,OAAA,CAAQ,KAAA,CAAM,QAAQ,EAAE,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM,CAAC,KAAK,sBAAA,CAAuB,KAAK,CAAC,CAAC,CAAA;AACzG,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA;AAC3C,EAAA,OAAO;AAAA,IACL,MAAM,YAAA,CAAa,KAAA;AAAA,IACnB,YAAA,EAAc,MAAA;AAAA,IACd,IAAA;AAAA,IACA,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ;AAAA,GACF;AACF;AACO,SAAS,uBAAuB,GAAA,EAAK;AAC1C,EAAA,MAAM,QAAA,GAAW,OAAO,GAAA,KAAQ,UAAA,GAAa,KAAI,GAAI,GAAA;AACrD,EAAA,OAAO,SAAS,IAAA,KAAS,QAAA,CAAS,GAAA,GAAM,QAAA,GAAW,WAAW,QAAQ,CAAA;AACxE;;;ACdA,IAAM,gBAAA,GAAN,MAAM,iBAAA,CAAiB;AAAA,EACrB,IAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA,CAAY;AAAA,IACV,IAAA;AAAA,IACA,IAAA;AAAA,IACA;AAAA,GACF,EAAG;AACD,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,QAAA,GAAW;AAAA,MACd,GAAG;AAAA,KACL;AAAA,EACF;AAAA,EACA,UAAA,CAAW,aAAa,aAAA,EAAe;AACrC,IAAA,MAAM,GAAA,GAAM,uBAAuB,aAAa,CAAA;AAChD,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,GAAG,IAAA,CAAK,QAAA;AAAA,MACR,CAAC,WAAW,GAAG;AAAA,KACjB;AACA,IAAA,OAAO,IAAI,iBAAA,CAAiB;AAAA,MAC1B,MAAM,YAAA,CAAa,KAAA;AAAA,MACnB,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,QAAA,EAAU,WAAA;AAAA,MACV,YAAA,EAAc;AAAA,KACf,CAAA;AAAA,EACH;AAAA,EACA,KAAA,GAAQ;AACN,IAAA,OAAO;AAAA,MACL,MAAM,YAAA,CAAa,KAAA;AAAA,MACnB,UAAU,IAAA,CAAK,QAAA;AAAA,MACf,YAAA,EAAc,MAAA;AAAA,MACd,MAAM,IAAA,CAAK;AAAA,KACb;AAAA,EACF;AACF,CAAA;AACA,IAAM,iBAAA,GAAN,MAAM,kBAAA,CAAkB;AAAA,EACtB,IAAA;AAAA,EACA,MAAA;AAAA,EACA,YAAY,gBAAA,EAAkB;AAC5B,IAAA,IAAA,CAAK,OAAO,gBAAA,CAAiB,IAAA;AAC7B,IAAA,IAAA,CAAK,MAAA,GAAS;AAAA,MACZ,GAAG,gBAAA,CAAiB;AAAA,KACtB;AAAA,EACF;AAAA;AAAA,EAGA,QAAA,CAAS,MAAM,KAAA,EAAO;AACpB,IAAA,OAAO,IAAI,kBAAA,CAAkB;AAAA,MAC3B,MAAM,YAAA,CAAa,MAAA;AAAA,MACnB,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,MAAA,EAAQ;AAAA,QACN,GAAG,IAAA,CAAK,MAAA;AAAA,QACR,CAAC,IAAI,GAAG;AAAA,OACV;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA,EACA,KAAA,GAAQ;AACN,IAAA,OAAO;AAAA,MACL,MAAM,YAAA,CAAa,MAAA;AAAA,MACnB,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,QAAQ,IAAA,CAAK,MAAA;AAAA,MACb,IAAA,EAAM;AAAA,KACR;AAAA,EACF;AACF,CAAA;AACO,SAAS,eAAA,CAAgB,UAAU,SAAA,EAAW;AAenD,EAAA,MAAM,WAAW,EAAC;AAClB,EAAA,KAAA,MAAW,OAAO,QAAA,EAAU;AAC1B,IAAA,MAAM,CAAA,GAAI,SAAS,GAAG,CAAA;AAGtB,IAAA,IAAI,WAAA,CAAY,CAAC,CAAA,EAAG;AAGlB,MAAA,MAAM,aAAA,GAAgB,IAAI,iBAAA,CAAkB,CAAC,CAAA;AAC7C,MAAA,QAAA,CAAS,GAAG,CAAA,GAAI,aAAA;AAAA,IAClB,CAAA,MAAA,IAAW,UAAA,CAAW,CAAC,CAAA,EAAG;AAExB,MAAA,MAAM,YAAA,GAAe,IAAI,gBAAA,CAAiB,CAAC,CAAA;AAC3C,MAAA,QAAA,CAAS,GAAG,CAAA,GAAI,YAAA;AAAA,IAClB;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL,GAAG,QAAA;AAAA,IACH,GAAG,UAAU,QAAQ;AAAA,GACvB;AACF;;;ACpGA,SAAS,gBAAgB,KAAA,EAAO;AAE9B,EAAA,MAAM,QAAA,GAAW,OAAO,KAAA,KAAU,UAAA,GAAa,OAAM,GAAI,KAAA;AACzD,EAAA,IAAI,WAAA,CAAY,QAAQ,CAAA,IAAK,UAAA,CAAW,QAAQ,CAAA,EAAG;AACjD,IAAA,OAAO,WAAW,QAAQ,CAAA;AAAA,EAC5B;AAGA,EAAA,OAAO,QAAA;AACT;AACO,SAAS,YAAA,CAAa,MAAM,MAAA,EAAQ;AACzC,EAAA,MAAM,UAAU,MAAA,CAAO,OAAA,CAAQ,MAAA,CAAO,MAAM,EAAE,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM,CAAC,KAAK,eAAA,CAAgB,KAAK,CAAC,CAAC,CAAA;AACjG,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA;AACzC,EAAA,OAAO;AAAA,IACL,MAAM,YAAA,CAAa,MAAA;AAAA,IACnB,IAAA;AAAA,IACA,MAAM,MAAA,CAAO,IAAA;AAAA,IACb;AAAA,GACF;AACF","file":"index.cjs","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\nexport const ModelDefType = {\n  RECORD: \"record\",\n  UNION: \"union\"\n};","/*\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\nexport const TypeKind = {\n  ARRAY: \"array\",\n  DOUBLE: \"double\",\n  OPTIONAL: \"optional\",\n  REF: \"ref\",\n  STRING: \"string\",\n  UNKNOWN: \"unknown\"\n};\n\n// Forward declaration to avoid circular reference\n\n// A reference to a record or a union type\n\nexport const String = {\n  type: TypeKind.STRING\n};\nexport const Double = {\n  type: TypeKind.DOUBLE\n};\nexport const Unknown = {\n  type: TypeKind.UNKNOWN\n};\nexport const Array = item => ({\n  type: TypeKind.ARRAY,\n  items: item\n});\nexport const Optional = item => ({\n  type: TypeKind.OPTIONAL,\n  item\n});","/*\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 { ModelDefType } from \"./defs.js\";\nimport { TypeKind } from \"./primitives.js\";\n\n/**\n * Helper function to safely transform a record definition to a reference.\n * This function helps TypeScript track type transformations better.\n */\nexport function modelToRef(model) {\n  return createRef(model.name, model.type);\n}\n\n/**\n * Helper function to create a reference with proper typing.\n * This avoids type assertions in multiple places.\n */\nexport function createRef(name, refType) {\n  return {\n    type: TypeKind.REF,\n    name,\n    refType\n  };\n}\n\n/**\n * Type guard to check if a value is a RecordDef\n */\nexport function isRecordDef(value) {\n  return value != null && typeof value === \"object\" && \"type\" in value && value.type === ModelDefType.RECORD && \"fields\" in value;\n}\n\n/**\n * Type guard to check if a value is a UnionDef\n */\nexport function isUnionDef(value) {\n  return value != null && typeof value === \"object\" && \"type\" in value && value.type === ModelDefType.UNION && \"variants\" in value;\n}","/*\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 { ModelDefType } from \"./defs.js\";\nimport { TypeKind } from \"./primitives.js\";\nimport { modelToRef } from \"./utils.js\";\nexport function defineUnion(name, union) {\n  const entries = Object.entries(union.variants).map(([key, value]) => [key, resolveUnionVariantArg(value)]);\n  const variants = Object.fromEntries(entries);\n  return {\n    type: ModelDefType.UNION,\n    discriminant: \"type\",\n    name: name,\n    docs: union.docs,\n    variants\n  };\n}\nexport function resolveUnionVariantArg(arg) {\n  const resolved = typeof arg === \"function\" ? arg() : arg;\n  return resolved.type === TypeKind.REF ? resolved : modelToRef(resolved);\n}","/*\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 { resolveUnionVariantArg } from \"./defineUnion.js\";\nimport { ModelDefType } from \"./defs.js\";\nimport { isRecordDef, isUnionDef } from \"./utils.js\";\nclass UnionBuilderImpl {\n  name;\n  docs;\n  variants;\n  constructor({\n    name,\n    docs,\n    variants\n  }) {\n    this.name = name;\n    this.docs = docs;\n    this.variants = {\n      ...variants\n    };\n  }\n  addVariant(variantName, modelDefOrRef) {\n    const ref = resolveUnionVariantArg(modelDefOrRef);\n    const newVariants = {\n      ...this.variants,\n      [variantName]: ref\n    };\n    return new UnionBuilderImpl({\n      type: ModelDefType.UNION,\n      name: this.name,\n      variants: newVariants,\n      discriminant: \"type\"\n    });\n  }\n  build() {\n    return {\n      type: ModelDefType.UNION,\n      variants: this.variants,\n      discriminant: \"type\",\n      name: this.name\n    };\n  }\n}\nclass RecordBuilderImpl {\n  name;\n  fields;\n  constructor(initialRecordDef) {\n    this.name = initialRecordDef.name;\n    this.fields = {\n      ...initialRecordDef.fields\n    };\n  }\n\n  // TODO: resolve field value from arg instead\n  addField(name, value) {\n    return new RecordBuilderImpl({\n      type: ModelDefType.RECORD,\n      name: this.name,\n      fields: {\n        ...this.fields,\n        [name]: value\n      },\n      docs: \"\"\n    });\n  }\n  build() {\n    return {\n      type: ModelDefType.RECORD,\n      name: this.name,\n      fields: this.fields,\n      docs: \"\"\n    };\n  }\n}\nexport function defineMigration(previous, migration) {\n  /**\n   * Create a map of builders for the schema.\n   *\n   * Note about type assertions:\n   * We use a type assertion here (SchemaBuilder<T>) because TypeScript cannot\n   * track the relationship between the keys in the original schema and the\n   * corresponding builder types. This is a fundamental limitation of TypeScript's\n   * type system when dealing with dynamically constructed objects.\n   *\n   * The assertion is safe because:\n   * 1. We're only adding keys that exist in the original schema\n   * 2. For each key, we're creating a builder of the correct type\n   * 3. The resulting object exactly matches the SchemaBuilder<T> type\n   */\n  const builders = {};\n  for (const key in previous) {\n    const v = previous[key];\n\n    // Use our type guards for safer type narrowing\n    if (isRecordDef(v)) {\n      // This assertion is necessary because TypeScript can't track the field types\n      // through the dynamic property access and object construction\n      const recordBuilder = new RecordBuilderImpl(v);\n      builders[key] = recordBuilder;\n    } else if (isUnionDef(v)) {\n      // Similar assertion needed for union builders\n      const unionBuilder = new UnionBuilderImpl(v);\n      builders[key] = unionBuilder;\n    }\n  }\n  return {\n    ...previous,\n    ...migration(builders)\n  };\n}","/*\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 { ModelDefType } from \"./defs.js\";\nimport { isRecordDef, isUnionDef, modelToRef } from \"./utils.js\";\n/**\n * Helper function to resolve a field value, handling functions and transforming\n * types as needed.\n */\nfunction resolveFieldArg(value) {\n  // Handle function values\n  const resolved = typeof value === \"function\" ? value() : value;\n  if (isRecordDef(resolved) || isUnionDef(resolved)) {\n    return modelToRef(resolved);\n  }\n\n  // For primitive types and other Types\n  return resolved;\n}\nexport function defineRecord(name, record) {\n  const entries = Object.entries(record.fields).map(([key, value]) => [key, resolveFieldArg(value)]);\n  const fields = Object.fromEntries(entries);\n  return {\n    type: ModelDefType.RECORD,\n    name: name,\n    docs: record.docs,\n    fields\n  };\n}"]}