@osdk/api 2.8.0-beta.8 → 2.8.0

package/build/browser/shapes/ShapeBuilder.js

@@ -0,0 +1,243 @@
+/*
+ * Copyright 2025 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 { computeShapeId } from "./computeShapeId.js";
+import { SourcePrimaryKeySymbol } from "./ShapeDefinition.js";
+class ShapeBuilderImpl {
+  #state;
+  constructor(state) {
+    this.#state = state;
+  }
+  #addProps(props, type) {
+    const newProps = {
+      ...this.#state.props
+    };
+    for (const prop of props) {
+      newProps[prop] = {
+        nullabilityOp: {
+          type
+        }
+      };
+    }
+    return newProps;
+  }
+  select(...props) {
+    return new ShapeBuilderImpl({
+      ...this.#state,
+      props: this.#addProps(props, "select")
+    });
+  }
+  require(...props) {
+    return new ShapeBuilderImpl({
+      ...this.#state,
+      props: this.#addProps(props, "require")
+    });
+  }
+  dropIfNull(...props) {
+    return new ShapeBuilderImpl({
+      ...this.#state,
+      props: this.#addProps(props, "dropIfNull")
+    });
+  }
+  withDefault(prop, defaultValue) {
+    return new ShapeBuilderImpl({
+      ...this.#state,
+      props: {
+        ...this.#state.props,
+        [prop]: {
+          nullabilityOp: {
+            type: "withDefault",
+            defaultValue
+          }
+        }
+      }
+    });
+  }
+  withTransform(prop, transform) {
+    return new ShapeBuilderImpl({
+      ...this.#state,
+      props: {
+        ...this.#state.props,
+        [prop]: {
+          nullabilityOp: {
+            type: "withTransform",
+            transform
+          }
+        }
+      }
+    });
+  }
+  deriveLink(name, builder) {
+    const linkBuilder = createShapeLinkBuilder(this.#state.baseTypeApiName);
+    const linkResult = builder(linkBuilder);
+    return new ShapeBuilderImpl({
+      ...this.#state,
+      props: {
+        ...this.#state.props
+      },
+      derivedLinks: [...this.#state.derivedLinks, {
+        name,
+        objectSetDef: linkResult.objectSetDef,
+        targetShape: linkResult.targetShape,
+        config: linkResult.config
+      }]
+    });
+  }
+  build() {
+    const shapeId = computeShapeId({
+      baseTypeApiName: this.#state.baseTypeApiName,
+      props: this.#state.props,
+      derivedLinks: this.#state.derivedLinks
+    });
+    return {
+      __shapeId: shapeId,
+      __debugName: this.#state.debugName,
+      __baseType: this.#state.baseType,
+      __baseTypeApiName: this.#state.baseTypeApiName,
+      __props: Object.freeze({
+        ...this.#state.props
+      }),
+      __derivedLinks: Object.freeze([...this.#state.derivedLinks]),
+      __selectedPropsType: {},
+      __derivedLinksType: {}
+    };
+  }
+}
+class ShapeLinkBuilderImpl {
+  #state;
+  $primaryKey = SourcePrimaryKeySymbol;
+  constructor(state) {
+    this.#state = state;
+  }
+  pivotTo(link) {
+    const newSegments = [...this.#state.segments, {
+      type: "pivotTo",
+      linkName: link,
+      sourceType: this.#state.currentTypeApiName
+      // targetType is resolved at link execution time when link metadata is available
+    }];
+    return new ShapeLinkBuilderImpl({
+      ...this.#state,
+      segments: newSegments,
+      // currentTypeApiName is a hint for debugging; actual type resolution happens at execution
+      currentTypeApiName: `${this.#state.currentTypeApiName}.${link}`
+    });
+  }
+
+  /** Sets the where filter for this link. Calling multiple times replaces the previous clause (last-write-wins). */
+  where(clause) {
+    return new ShapeLinkBuilderImpl({
+      ...this.#state,
+      where: clause
+    });
+  }
+  #setOp(type, others) {
+    return new ShapeLinkBuilderImpl({
+      ...this.#state,
+      setOperations: [...this.#state.setOperations, ...others.map(other => ({
+        type,
+        other: other.toObjectSetDef()
+      }))]
+    });
+  }
+  union(...others) {
+    return this.#setOp("union", others);
+  }
+  intersect(...others) {
+    return this.#setOp("intersect", others);
+  }
+  subtract(...others) {
+    return this.#setOp("subtract", others);
+  }
+  orderBy(property, direction = "asc") {
+    return new ShapeLinkBuilderImpl({
+      ...this.#state,
+      orderBy: [...this.#state.orderBy, {
+        property: property,
+        direction
+      }]
+    });
+  }
+  limit(n) {
+    if (!Number.isInteger(n) || n <= 0) {
+      throw new Error(`ShapeLinkBuilder.limit() requires a positive integer, got: ${n}`);
+    }
+    return new ShapeLinkBuilderImpl({
+      ...this.#state,
+      limit: n
+    });
+  }
+  distinct() {
+    return new ShapeLinkBuilderImpl({
+      ...this.#state,
+      distinct: true
+    });
+  }
+  as(shape, config = {}) {
+    // The brand is a compile-time only marker, at runtime it's just undefined
+    return {
+      targetShape: shape,
+      objectSetDef: this.toObjectSetDef(),
+      config
+    };
+  }
+  toObjectSetDef() {
+    return {
+      segments: Object.freeze([...this.#state.segments]),
+      where: this.#state.where,
+      orderBy: this.#state.orderBy.length > 0 ? Object.freeze([...this.#state.orderBy]) : undefined,
+      limit: this.#state.limit,
+      distinct: this.#state.distinct || undefined,
+      setOperations: this.#state.setOperations.length > 0 ? Object.freeze([...this.#state.setOperations]) : undefined
+    };
+  }
+}
+export function createShapeLinkBuilder(sourceTypeApiName) {
+  return new ShapeLinkBuilderImpl({
+    sourceTypeApiName,
+    currentTypeApiName: sourceTypeApiName,
+    segments: [],
+    orderBy: [],
+    distinct: false,
+    setOperations: []
+  });
+}
+
+/**
+ * Creates a new ShapeBuilder for the given base type.
+ *
+ * @param baseType - The base ObjectTypeDefinition or InterfaceDefinition
+ * @param debugName - Optional name for debugging in DevTools
+ *
+ * @example
+ * ```typescript
+ * const SlimPlayer = createShapeBuilder(Player, "SlimPlayer")
+ *   .require("name", "age")
+ *   .withDefault("position", "Unknown")
+ *   .build();
+ * ```
+ */
+export function createShapeBuilder(baseType, debugName) {
+  const state = {
+    baseType,
+    baseTypeApiName: baseType.apiName,
+    debugName,
+    props: {},
+    derivedLinks: []
+  };
+  return new ShapeBuilderImpl(state);
+}
+//# sourceMappingURL=ShapeBuilder.js.map

package/build/browser/shapes/ShapeBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShapeBuilder.js","names":["computeShapeId","SourcePrimaryKeySymbol","ShapeBuilderImpl","state","constructor","addProps","#addProps","props","type","newProps","prop","nullabilityOp","select","require","dropIfNull","withDefault","defaultValue","withTransform","transform","deriveLink","name","builder","linkBuilder","createShapeLinkBuilder","baseTypeApiName","linkResult","derivedLinks","objectSetDef","targetShape","config","build","shapeId","__shapeId","__debugName","debugName","__baseType","baseType","__baseTypeApiName","__props","Object","freeze","__derivedLinks","__selectedPropsType","__derivedLinksType","ShapeLinkBuilderImpl","$primaryKey","pivotTo","link","newSegments","segments","linkName","sourceType","currentTypeApiName","where","clause","setOp","#setOp","others","setOperations","map","other","toObjectSetDef","union","intersect","subtract","orderBy","property","direction","limit","n","Number","isInteger","Error","distinct","as","shape","length","undefined","sourceTypeApiName","createShapeBuilder","apiName"],"sources":["ShapeBuilder.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 { WhereClause } from \"../aggregate/WhereClause.js\";\nimport type {\n  ObjectOrInterfaceDefinition,\n  PropertyKeys,\n} from \"../ontology/ObjectOrInterface.js\";\nimport type { LinkedType, LinkNames } from \"../util/LinkUtils.js\";\nimport { computeShapeId } from \"./computeShapeId.js\";\nimport { SourcePrimaryKeySymbol } from \"./ShapeDefinition.js\";\nimport type {\n  DerivedLinkConfig,\n  NullabilityOp,\n  PropertyType,\n  RequiredProperty,\n  ShapeBuilder,\n  ShapeDefinition,\n  ShapeDerivedLinkDef,\n  ShapeLinkBuilder,\n  ShapeLinkObjectSetDef,\n  ShapeLinkOrderBy,\n  ShapeLinkResult,\n  ShapeLinkSegment,\n  ShapeLinkSetOperation,\n  ShapePropertyConfig,\n} from \"./ShapeDefinition.js\";\n\ninterface ShapeBuilderState {\n  readonly baseType: ObjectOrInterfaceDefinition;\n  readonly baseTypeApiName: string;\n  readonly debugName: string | undefined;\n  readonly props: Record<string, ShapePropertyConfig>;\n  readonly derivedLinks: ShapeDerivedLinkDef[];\n}\n\nclass ShapeBuilderImpl<\n  BASE extends ObjectOrInterfaceDefinition,\n  PROPS extends Record<string, unknown>,\n  LINKS extends Record<string, ShapeDefinition<ObjectOrInterfaceDefinition>>,\n> implements ShapeBuilder<BASE, PROPS, LINKS> {\n  readonly #state: ShapeBuilderState;\n\n  constructor(state: ShapeBuilderState) {\n    this.#state = state;\n  }\n\n  #addProps(\n    props: string[],\n    type: \"select\" | \"require\" | \"dropIfNull\",\n  ): Record<string, ShapePropertyConfig> {\n    const newProps = { ...this.#state.props };\n    for (const prop of props) {\n      newProps[prop] = { nullabilityOp: { type } };\n    }\n    return newProps;\n  }\n\n  select<K extends Exclude<PropertyKeys<BASE>, keyof PROPS>>(\n    ...props: K[]\n  ): ShapeBuilder<BASE, PROPS & { [P in K]: PropertyType<BASE, P> }, LINKS> {\n    return new ShapeBuilderImpl({\n      ...this.#state,\n      props: this.#addProps(props as string[], \"select\"),\n    });\n  }\n\n  require<K extends Exclude<PropertyKeys<BASE>, keyof PROPS>>(\n    ...props: K[]\n  ): ShapeBuilder<\n    BASE,\n    PROPS & { [P in K]: RequiredProperty<PropertyType<BASE, P>> },\n    LINKS\n  > {\n    return new ShapeBuilderImpl({\n      ...this.#state,\n      props: this.#addProps(props as string[], \"require\"),\n    });\n  }\n\n  dropIfNull<K extends Exclude<PropertyKeys<BASE>, keyof PROPS>>(\n    ...props: K[]\n  ): ShapeBuilder<\n    BASE,\n    PROPS & { [P in K]: RequiredProperty<PropertyType<BASE, P>> },\n    LINKS\n  > {\n    return new ShapeBuilderImpl({\n      ...this.#state,\n      props: this.#addProps(props as string[], \"dropIfNull\"),\n    });\n  }\n\n  withDefault<\n    K extends Exclude<PropertyKeys<BASE>, keyof PROPS>,\n    V extends NonNullable<PropertyType<BASE, K>>,\n  >(\n    prop: K,\n    defaultValue: V,\n  ): ShapeBuilder<\n    BASE,\n    PROPS & { [P in K]: NonNullable<PropertyType<BASE, P>> },\n    LINKS\n  > {\n    return new ShapeBuilderImpl({\n      ...this.#state,\n      props: {\n        ...this.#state.props,\n        [prop as string]: {\n          nullabilityOp: { type: \"withDefault\", defaultValue } as NullabilityOp,\n        },\n      },\n    });\n  }\n\n  withTransform<K extends Exclude<PropertyKeys<BASE>, keyof PROPS>, R>(\n    prop: K,\n    transform: (value: PropertyType<BASE, K>) => R,\n  ): ShapeBuilder<BASE, PROPS & { [P in K]: R }, LINKS> {\n    return new ShapeBuilderImpl({\n      ...this.#state,\n      props: {\n        ...this.#state.props,\n        [prop as string]: {\n          nullabilityOp: { type: \"withTransform\", transform } as NullabilityOp,\n        },\n      },\n    });\n  }\n\n  deriveLink<\n    NAME extends string,\n    TARGET_SHAPE extends ShapeDefinition<ObjectOrInterfaceDefinition>,\n  >(\n    name: NAME,\n    builder: (\n      linkBuilder: ShapeLinkBuilder<BASE, BASE>,\n    ) => ShapeLinkResult<TARGET_SHAPE>,\n  ): ShapeBuilder<BASE, PROPS, LINKS & { [K in NAME]: TARGET_SHAPE }> {\n    const linkBuilder = createShapeLinkBuilder<BASE, BASE>(\n      this.#state.baseTypeApiName,\n    );\n    const linkResult = builder(linkBuilder);\n    return new ShapeBuilderImpl({\n      ...this.#state,\n      props: { ...this.#state.props },\n      derivedLinks: [\n        ...this.#state.derivedLinks,\n        {\n          name,\n          objectSetDef: linkResult.objectSetDef,\n          targetShape: linkResult.targetShape,\n          config: linkResult.config,\n        },\n      ],\n    });\n  }\n\n  build(): ShapeDefinition<BASE, PROPS, LINKS> {\n    const shapeId = computeShapeId({\n      baseTypeApiName: this.#state.baseTypeApiName,\n      props: this.#state.props,\n      derivedLinks: this.#state.derivedLinks,\n    });\n\n    return {\n      __shapeId: shapeId,\n      __debugName: this.#state.debugName,\n      __baseType: this.#state.baseType as BASE,\n      __baseTypeApiName: this.#state.baseTypeApiName,\n      __props: Object.freeze({ ...this.#state.props }),\n      __derivedLinks: Object.freeze([...this.#state.derivedLinks]),\n      __selectedPropsType: {} as PROPS,\n      __derivedLinksType: {} as LINKS,\n    } as ShapeDefinition<BASE, PROPS, LINKS>;\n  }\n}\n\ninterface ShapeLinkBuilderState {\n  readonly sourceTypeApiName: string;\n  readonly currentTypeApiName: string;\n  readonly segments: ShapeLinkSegment[];\n  readonly where?: WhereClause<ObjectOrInterfaceDefinition>;\n  readonly orderBy: ShapeLinkOrderBy[];\n  readonly limit?: number;\n  readonly distinct: boolean;\n  readonly setOperations: ShapeLinkSetOperation[];\n}\n\nclass ShapeLinkBuilderImpl<\n  SOURCE extends ObjectOrInterfaceDefinition,\n  CURRENT extends ObjectOrInterfaceDefinition,\n> implements ShapeLinkBuilder<SOURCE, CURRENT> {\n  readonly #state: ShapeLinkBuilderState;\n  readonly $primaryKey: symbol = SourcePrimaryKeySymbol;\n\n  constructor(state: ShapeLinkBuilderState) {\n    this.#state = state;\n  }\n\n  pivotTo<L extends LinkNames<CURRENT>>(\n    link: L,\n  ): ShapeLinkBuilder<SOURCE, LinkedType<CURRENT, L>> {\n    const newSegments: ShapeLinkSegment[] = [\n      ...this.#state.segments,\n      {\n        type: \"pivotTo\",\n        linkName: link as string,\n        sourceType: this.#state.currentTypeApiName,\n        // targetType is resolved at link execution time when link metadata is available\n      },\n    ];\n\n    return new ShapeLinkBuilderImpl({\n      ...this.#state,\n      segments: newSegments,\n      // currentTypeApiName is a hint for debugging; actual type resolution happens at execution\n      currentTypeApiName: `${this.#state.currentTypeApiName}.${link as string}`,\n    });\n  }\n\n  /** Sets the where filter for this link. Calling multiple times replaces the previous clause (last-write-wins). */\n  where(clause: WhereClause<CURRENT>): ShapeLinkBuilder<SOURCE, CURRENT> {\n    return new ShapeLinkBuilderImpl({\n      ...this.#state,\n      where: clause as WhereClause<ObjectOrInterfaceDefinition>,\n    });\n  }\n\n  #setOp(\n    type: \"union\" | \"intersect\" | \"subtract\",\n    others: ShapeLinkBuilder<SOURCE, CURRENT>[],\n  ): ShapeLinkBuilder<SOURCE, CURRENT> {\n    return new ShapeLinkBuilderImpl({\n      ...this.#state,\n      setOperations: [\n        ...this.#state.setOperations,\n        ...others.map((other) => ({\n          type,\n          other: (other as ShapeLinkBuilderImpl<SOURCE, CURRENT>)\n            .toObjectSetDef(),\n        })),\n      ],\n    });\n  }\n\n  union(\n    ...others: ShapeLinkBuilder<SOURCE, CURRENT>[]\n  ): ShapeLinkBuilder<SOURCE, CURRENT> {\n    return this.#setOp(\"union\", others);\n  }\n\n  intersect(\n    ...others: ShapeLinkBuilder<SOURCE, CURRENT>[]\n  ): ShapeLinkBuilder<SOURCE, CURRENT> {\n    return this.#setOp(\"intersect\", others);\n  }\n\n  subtract(\n    ...others: ShapeLinkBuilder<SOURCE, CURRENT>[]\n  ): ShapeLinkBuilder<SOURCE, CURRENT> {\n    return this.#setOp(\"subtract\", others);\n  }\n\n  orderBy<K extends PropertyKeys<CURRENT>>(\n    property: K,\n    direction: \"asc\" | \"desc\" = \"asc\",\n  ): ShapeLinkBuilder<SOURCE, CURRENT> {\n    return new ShapeLinkBuilderImpl({\n      ...this.#state,\n      orderBy: [\n        ...this.#state.orderBy,\n        { property: property as string, direction },\n      ],\n    });\n  }\n\n  limit(n: number): ShapeLinkBuilder<SOURCE, CURRENT> {\n    if (!Number.isInteger(n) || n <= 0) {\n      throw new Error(\n        `ShapeLinkBuilder.limit() requires a positive integer, got: ${n}`,\n      );\n    }\n    return new ShapeLinkBuilderImpl({\n      ...this.#state,\n      limit: n,\n    });\n  }\n\n  distinct(): ShapeLinkBuilder<SOURCE, CURRENT> {\n    return new ShapeLinkBuilderImpl({\n      ...this.#state,\n      distinct: true,\n    });\n  }\n\n  as<TARGET_SHAPE extends ShapeDefinition<CURRENT>>(\n    shape: TARGET_SHAPE,\n    config: DerivedLinkConfig = {},\n  ): ShapeLinkResult<TARGET_SHAPE> {\n    // The brand is a compile-time only marker, at runtime it's just undefined\n    return {\n      targetShape: shape,\n      objectSetDef: this.toObjectSetDef(),\n      config,\n    } as ShapeLinkResult<TARGET_SHAPE>;\n  }\n\n  toObjectSetDef(): ShapeLinkObjectSetDef {\n    return {\n      segments: Object.freeze([...this.#state.segments]),\n      where: this.#state.where,\n      orderBy: this.#state.orderBy.length > 0\n        ? Object.freeze([...this.#state.orderBy])\n        : undefined,\n      limit: this.#state.limit,\n      distinct: this.#state.distinct || undefined,\n      setOperations: this.#state.setOperations.length > 0\n        ? Object.freeze([...this.#state.setOperations])\n        : undefined,\n    };\n  }\n}\n\nexport function createShapeLinkBuilder<\n  SOURCE extends ObjectOrInterfaceDefinition,\n  CURRENT extends ObjectOrInterfaceDefinition,\n>(sourceTypeApiName: string): ShapeLinkBuilder<SOURCE, CURRENT> {\n  return new ShapeLinkBuilderImpl({\n    sourceTypeApiName,\n    currentTypeApiName: sourceTypeApiName,\n    segments: [],\n    orderBy: [],\n    distinct: false,\n    setOperations: [],\n  });\n}\n\n/**\n * Creates a new ShapeBuilder for the given base type.\n *\n * @param baseType - The base ObjectTypeDefinition or InterfaceDefinition\n * @param debugName - Optional name for debugging in DevTools\n *\n * @example\n * ```typescript\n * const SlimPlayer = createShapeBuilder(Player, \"SlimPlayer\")\n *   .require(\"name\", \"age\")\n *   .withDefault(\"position\", \"Unknown\")\n *   .build();\n * ```\n */\nexport function createShapeBuilder<BASE extends ObjectOrInterfaceDefinition>(\n  baseType: BASE,\n  debugName?: string,\n): ShapeBuilder<BASE, {}, {}> {\n  const state: ShapeBuilderState = {\n    baseType,\n    baseTypeApiName: baseType.apiName,\n    debugName,\n    props: {},\n    derivedLinks: [],\n  };\n\n  return new ShapeBuilderImpl(state);\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/shapes/ShapeDefinition.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright 2025 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.
+ */
+
+export const SourcePrimaryKeySymbol = Symbol.for("osdk.query.$sourcePk");
+const LegacyShapesSymbol = Symbol.for("osdk.shapes.$primaryKey");
+export function isSourcePkSymbol(value) {
+  return typeof value === "symbol" && (value === SourcePrimaryKeySymbol || value === LegacyShapesSymbol);
+}
+
+/** Configuration for how a derived link is loaded at runtime. */
+
+/** The result of calling `ShapeLinkBuilder.as()`, binding a link traversal to a target shape. */
+
+/** A single link traversal step in a derived link's object set definition. */
+
+/** Sort clause for a derived link's result set. */
+
+/** A set operation (union/intersect/subtract) applied to a derived link's object set. */
+
+/** Serializable definition of a derived link's object set: link traversals, filters, ordering, and set operations. */
+
+/** How a shape handles null values for a selected property. */
+
+/** Per-property configuration stored in a shape's `__props` map. */
+
+/** A derived link definition stored in a shape's `__derivedLinks` array. */
+
+/**
+ * Type projection from an OSDK type. `__props` is the single source of truth for property config.
+ *
+ * @typeParam BASE - The base ObjectTypeDefinition or InterfaceDefinition
+ * @typeParam SELECTED_PROPS - Record of selected properties and their transformed types
+ * @typeParam DERIVED_LINKS - Record of derived link names to their result types
+ */
+
+export class ShapeNullabilityError extends Error {
+  constructor(shape, violations) {
+    const props = violations.map(v => v.property).join(", ");
+    const shapeName = shape.__debugName ?? shape.__shapeId;
+    super(`Shape "${shapeName}" requires these properties to be non-null: ${props}`);
+    this.shape = shape;
+    this.violations = violations;
+    this.name = "ShapeNullabilityError";
+  }
+}
+//# sourceMappingURL=ShapeDefinition.js.map

package/build/browser/shapes/ShapeDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShapeDefinition.js","names":["SourcePrimaryKeySymbol","Symbol","for","LegacyShapesSymbol","isSourcePkSymbol","value","ShapeNullabilityError","Error","constructor","shape","violations","props","map","v","property","join","shapeName","__debugName","__shapeId","name"],"sources":["ShapeDefinition.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 { WhereClause } from \"../aggregate/WhereClause.js\";\nimport type {\n  ObjectOrInterfaceDefinition,\n  PropertyKeys,\n} from \"../ontology/ObjectOrInterface.js\";\nimport type { CompileTimeMetadata } from \"../ontology/ObjectTypeDefinition.js\";\nimport type { OsdkBase } from \"../OsdkBase.js\";\nimport type { LinkedType, LinkNames } from \"../util/LinkUtils.js\";\n\nexport const SourcePrimaryKeySymbol: unique symbol = Symbol.for(\n  \"osdk.query.$sourcePk\",\n);\n\nconst LegacyShapesSymbol = Symbol.for(\"osdk.shapes.$primaryKey\");\n\nexport function isSourcePkSymbol(value: unknown): value is symbol {\n  return (\n    typeof value === \"symbol\"\n    && (value === SourcePrimaryKeySymbol || value === LegacyShapesSymbol)\n  );\n}\n\ndeclare const ShapeDefinitionBrand: unique symbol;\n\ndeclare const ShapeLinkResultBrand: unique symbol;\n\n/** Configuration for how a derived link is loaded at runtime. */\nexport interface DerivedLinkConfig {\n  defer?: boolean;\n}\n\n/** The result of calling `ShapeLinkBuilder.as()`, binding a link traversal to a target shape. */\nexport interface ShapeLinkResult<\n  TARGET_SHAPE extends ShapeDefinition<ObjectOrInterfaceDefinition>,\n> {\n  readonly __linkResultBrand: typeof ShapeLinkResultBrand;\n  readonly targetShape: TARGET_SHAPE;\n  readonly objectSetDef: ShapeLinkObjectSetDef;\n  readonly config: DerivedLinkConfig;\n}\n\n/** A single link traversal step in a derived link's object set definition. */\nexport interface ShapeLinkSegment {\n  readonly type: \"pivotTo\";\n  readonly linkName: string;\n  readonly sourceType?: string;\n  readonly targetType?: string;\n}\n\n/** Sort clause for a derived link's result set. */\nexport interface ShapeLinkOrderBy {\n  readonly property: string;\n  readonly direction: \"asc\" | \"desc\";\n}\n\n/** A set operation (union/intersect/subtract) applied to a derived link's object set. */\nexport interface ShapeLinkSetOperation {\n  readonly type: \"union\" | \"intersect\" | \"subtract\";\n  readonly other: ShapeLinkObjectSetDef;\n}\n\n/** Serializable definition of a derived link's object set: link traversals, filters, ordering, and set operations. */\nexport interface ShapeLinkObjectSetDef {\n  readonly segments: readonly ShapeLinkSegment[];\n  readonly where?: WhereClause<ObjectOrInterfaceDefinition>;\n  readonly orderBy?: readonly ShapeLinkOrderBy[];\n  readonly limit?: number;\n  readonly distinct?: boolean;\n  readonly setOperations?: readonly ShapeLinkSetOperation[];\n}\n\n/** How a shape handles null values for a selected property. */\nexport type NullabilityOp =\n  | { type: \"require\" }\n  | { type: \"dropIfNull\" }\n  | { type: \"withDefault\"; defaultValue: unknown }\n  | { type: \"withTransform\"; transform: (value: unknown) => unknown }\n  | { type: \"select\" };\n\n/** Per-property configuration stored in a shape's `__props` map. */\nexport interface ShapePropertyConfig {\n  readonly nullabilityOp: NullabilityOp;\n}\n\n/** A derived link definition stored in a shape's `__derivedLinks` array. */\nexport interface ShapeDerivedLinkDef<\n  TARGET_SHAPE extends ShapeDefinition<ObjectOrInterfaceDefinition> =\n    ShapeDefinition<ObjectOrInterfaceDefinition>,\n> {\n  readonly name: string;\n  readonly objectSetDef: ShapeLinkObjectSetDef;\n  readonly targetShape: TARGET_SHAPE;\n  readonly config: DerivedLinkConfig;\n}\n\n/**\n * Type projection from an OSDK type. `__props` is the single source of truth for property config.\n *\n * @typeParam BASE - The base ObjectTypeDefinition or InterfaceDefinition\n * @typeParam SELECTED_PROPS - Record of selected properties and their transformed types\n * @typeParam DERIVED_LINKS - Record of derived link names to their result types\n */\nexport interface ShapeDefinition<\n  BASE extends ObjectOrInterfaceDefinition,\n  SELECTED_PROPS extends Record<string, unknown> = {},\n  DERIVED_LINKS extends Record<\n    string,\n    ShapeDefinition<ObjectOrInterfaceDefinition>\n  > = {},\n> {\n  readonly [ShapeDefinitionBrand]: true;\n  readonly __shapeId: string;\n  readonly __debugName: string | undefined;\n  readonly __baseType: BASE;\n  readonly __baseTypeApiName: string;\n  readonly __props: Readonly<Record<string, unknown>>;\n  readonly __derivedLinks: readonly unknown[];\n  readonly __selectedPropsType: SELECTED_PROPS;\n  readonly __derivedLinksType: DERIVED_LINKS;\n}\n\nexport type ShapeBaseType<\n  S extends ShapeDefinition<ObjectOrInterfaceDefinition>,\n> = S extends ShapeDefinition<infer BASE, infer _P, infer _L> ? BASE : never;\n\nexport type ShapeSelectedProps<\n  S extends ShapeDefinition<ObjectOrInterfaceDefinition>,\n> = S extends ShapeDefinition<infer _B, infer PROPS, infer _L> ? PROPS : never;\n\nexport type ShapeDerivedLinks<\n  S extends ShapeDefinition<ObjectOrInterfaceDefinition>,\n> = S extends ShapeDefinition<infer _B, infer _P, infer LINKS> ? LINKS : never;\n\nexport type ShapeInstance<\n  S extends ShapeDefinition<ObjectOrInterfaceDefinition>,\n> = S extends ShapeDefinition<infer BASE, infer PROPS, infer LINKS> ?\n    & OsdkBase<BASE>\n    & { readonly $rid: string }\n    & PROPS\n    & {\n      [K in keyof LINKS]: LINKS[K] extends\n        ShapeDefinition<ObjectOrInterfaceDefinition> ? ShapeInstance<LINKS[K]>[]\n        : never;\n    }\n  : never;\n\nexport type PropertyType<\n  BASE extends ObjectOrInterfaceDefinition,\n  K extends PropertyKeys<BASE>,\n> = CompileTimeMetadata<BASE>[\"props\"][K];\n\nexport type RequiredProperty<T> = NonNullable<T>;\n\nexport interface ShapeLinkBuilder<\n  SOURCE extends ObjectOrInterfaceDefinition,\n  CURRENT extends ObjectOrInterfaceDefinition,\n> {\n  pivotTo<L extends LinkNames<CURRENT>>(\n    link: L,\n  ): ShapeLinkBuilder<SOURCE, LinkedType<CURRENT, L>>;\n\n  where(clause: WhereClause<CURRENT>): ShapeLinkBuilder<SOURCE, CURRENT>;\n\n  union(\n    ...others: ShapeLinkBuilder<SOURCE, CURRENT>[]\n  ): ShapeLinkBuilder<SOURCE, CURRENT>;\n\n  intersect(\n    ...others: ShapeLinkBuilder<SOURCE, CURRENT>[]\n  ): ShapeLinkBuilder<SOURCE, CURRENT>;\n\n  subtract(\n    ...others: ShapeLinkBuilder<SOURCE, CURRENT>[]\n  ): ShapeLinkBuilder<SOURCE, CURRENT>;\n\n  orderBy<K extends PropertyKeys<CURRENT>>(\n    property: K,\n    direction?: \"asc\" | \"desc\",\n  ): ShapeLinkBuilder<SOURCE, CURRENT>;\n\n  limit(n: number): ShapeLinkBuilder<SOURCE, CURRENT>;\n\n  distinct(): ShapeLinkBuilder<SOURCE, CURRENT>;\n\n  as<TARGET_SHAPE extends ShapeDefinition<CURRENT>>(\n    shape: TARGET_SHAPE,\n    config?: DerivedLinkConfig,\n  ): ShapeLinkResult<TARGET_SHAPE>;\n\n  readonly $primaryKey: symbol;\n}\n\nexport interface ShapeLinkBuilderInternal\n  extends\n    ShapeLinkBuilder<ObjectOrInterfaceDefinition, ObjectOrInterfaceDefinition>\n{\n  toObjectSetDef(): ShapeLinkObjectSetDef;\n}\n\nexport interface ShapeBuilder<\n  BASE extends ObjectOrInterfaceDefinition,\n  PROPS extends Record<string, unknown> = {},\n  LINKS extends Record<\n    string,\n    ShapeDefinition<ObjectOrInterfaceDefinition>\n  > = {},\n> {\n  select<K extends Exclude<PropertyKeys<BASE>, keyof PROPS>>(\n    ...props: K[]\n  ): ShapeBuilder<\n    BASE,\n    PROPS & { [P in K]: PropertyType<BASE, P> },\n    LINKS\n  >;\n\n  require<K extends Exclude<PropertyKeys<BASE>, keyof PROPS>>(\n    ...props: K[]\n  ): ShapeBuilder<\n    BASE,\n    PROPS & { [P in K]: RequiredProperty<PropertyType<BASE, P>> },\n    LINKS\n  >;\n\n  dropIfNull<K extends Exclude<PropertyKeys<BASE>, keyof PROPS>>(\n    ...props: K[]\n  ): ShapeBuilder<\n    BASE,\n    PROPS & { [P in K]: RequiredProperty<PropertyType<BASE, P>> },\n    LINKS\n  >;\n\n  withDefault<\n    K extends Exclude<PropertyKeys<BASE>, keyof PROPS>,\n    V extends NonNullable<PropertyType<BASE, K>>,\n  >(\n    prop: K,\n    defaultValue: V,\n  ): ShapeBuilder<\n    BASE,\n    PROPS & { [P in K]: NonNullable<PropertyType<BASE, P>> },\n    LINKS\n  >;\n\n  withTransform<\n    K extends Exclude<PropertyKeys<BASE>, keyof PROPS>,\n    R,\n  >(\n    prop: K,\n    transform: (value: PropertyType<BASE, K>) => R,\n  ): ShapeBuilder<BASE, PROPS & { [P in K]: R }, LINKS>;\n\n  deriveLink<\n    NAME extends string,\n    TARGET_SHAPE extends ShapeDefinition<ObjectOrInterfaceDefinition>,\n  >(\n    name: NAME,\n    builder: (\n      linkBuilder: ShapeLinkBuilder<BASE, BASE>,\n    ) => ShapeLinkResult<TARGET_SHAPE>,\n  ): ShapeBuilder<BASE, PROPS, LINKS & { [K in NAME]: TARGET_SHAPE }>;\n\n  build(): ShapeDefinition<BASE, PROPS, LINKS>;\n}\n\nexport interface LinkLoadConfig {\n  pageSize?: number;\n  autoFetchMore?: boolean | number;\n  streamUpdates?: boolean;\n  defer?: boolean;\n}\n\nexport interface LinkStatus {\n  isLoading: boolean;\n  error: Error | undefined;\n  hasMore: boolean;\n  fetchMore: () => Promise<void>;\n}\n\nexport interface NullabilityViolation {\n  property: string;\n  primaryKey: unknown;\n  constraint: \"require\" | \"dropIfNull\" | \"transformError\";\n}\n\nexport class ShapeNullabilityError extends Error {\n  constructor(\n    public readonly shape: ShapeDefinition<ObjectOrInterfaceDefinition>,\n    public readonly violations: readonly NullabilityViolation[],\n  ) {\n    const props = violations.map((v) => v.property).join(\", \");\n    const shapeName = shape.__debugName ?? shape.__shapeId;\n    super(\n      `Shape \"${shapeName}\" requires these properties to be non-null: ${props}`,\n    );\n    this.name = \"ShapeNullabilityError\";\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA,OAAO,MAAMA,sBAAqC,GAAGC,MAAM,CAACC,GAAG,CAC7D,sBACF,CAAC;AAED,MAAMC,kBAAkB,GAAGF,MAAM,CAACC,GAAG,CAAC,yBAAyB,CAAC;AAEhE,OAAO,SAASE,gBAAgBA,CAACC,KAAc,EAAmB;EAChE,OACE,OAAOA,KAAK,KAAK,QAAQ,KACrBA,KAAK,KAAKL,sBAAsB,IAAIK,KAAK,KAAKF,kBAAkB,CAAC;AAEzE;;AAMA;;AAKA;;AAUA;;AAQA;;AAMA;;AAMA;;AAUA;;AAQA;;AAKA;;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;;AAuLA,OAAO,MAAMG,qBAAqB,SAASC,KAAK,CAAC;EAC/CC,WAAWA,CACOC,KAAmD,EACnDC,UAA2C,EAC3D;IACA,MAAMC,KAAK,GAAGD,UAAU,CAACE,GAAG,CAAEC,CAAC,IAAKA,CAAC,CAACC,QAAQ,CAAC,CAACC,IAAI,CAAC,IAAI,CAAC;IAC1D,MAAMC,SAAS,GAAGP,KAAK,CAACQ,WAAW,IAAIR,KAAK,CAACS,SAAS;IACtD,KAAK,CACH,UAAUF,SAAS,+CAA+CL,KAAK,EACzE,CAAC;IAAC,KAPcF,KAAmD,GAAnDA,KAAmD;IAAA,KACnDC,UAA2C,GAA3CA,UAA2C;IAO3D,IAAI,CAACS,IAAI,GAAG,uBAAuB;EACrC;AACF","ignoreList":[]}

package/build/browser/shapes/computeShapeId.js

@@ -0,0 +1,97 @@
+/*
+ * Copyright 2025 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.
+ */
+
+function sortedStringify(obj) {
+  return JSON.stringify(obj, (_, v) => v && typeof v === "object" && !Array.isArray(v) ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => a.localeCompare(b))) : v);
+}
+
+/**
+ * Computes a stable, deterministic identifier for a shape definition.
+ * The ID uniquely represents the combination of base type, property
+ * selections/nullability configs, and derived link definitions so
+ * that identical shapes produce the same ID across calls.
+ */
+export function computeShapeId(input) {
+  const canonical = canonicalizeShapeInput(input);
+  return simpleHash(sortedStringify(canonical));
+}
+function canonicalizeShapeInput(input) {
+  const sortedPropKeys = [...Object.keys(input.props)].sort();
+  const canonicalProps = {};
+  for (const key of sortedPropKeys) {
+    const config = input.props[key];
+    const op = config.nullabilityOp;
+    canonicalProps[key] = op.type === "withDefault" ? {
+      type: op.type,
+      defaultValue: op.defaultValue
+    } : op.type;
+  }
+  const canonicalLinks = input.derivedLinks.map(link => ({
+    name: link.name,
+    objectSetDef: canonicalizeObjectSetDef(link.objectSetDef),
+    targetShapeId: link.targetShape.__shapeId
+  }));
+  canonicalLinks.sort((a, b) => a.name.localeCompare(b.name));
+  return {
+    baseType: input.baseTypeApiName,
+    props: canonicalProps,
+    links: canonicalLinks
+  };
+}
+function canonicalizeObjectSetDef(def) {
+  const result = {
+    segments: def.segments.map(seg => ({
+      type: seg.type,
+      linkName: seg.linkName,
+      sourceType: seg.sourceType
+    }))
+  };
+  if (def.where) {
+    result.where = JSON.parse(sortedStringify(def.where));
+  }
+  if (def.orderBy && def.orderBy.length > 0) {
+    result.orderBy = def.orderBy.map(o => ({
+      property: o.property,
+      direction: o.direction
+    }));
+  }
+  if (def.limit !== undefined) {
+    result.limit = def.limit;
+  }
+  if (def.distinct) {
+    result.distinct = true;
+  }
+  if (def.setOperations && def.setOperations.length > 0) {
+    result.setOperations = def.setOperations.map(op => ({
+      type: op.type,
+      other: canonicalizeObjectSetDef(op.other)
+    }));
+  }
+  return result;
+}
+
+// Shape IDs are used for cache keying and equality, not security,
+// so 32-bit is sufficient.
+function simpleHash(str) {
+  let hash = 5381;
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i);
+    hash = (hash << 5) + hash ^ char;
+  }
+  const positiveHash = hash >>> 0;
+  return positiveHash.toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=computeShapeId.js.map

package/build/browser/shapes/computeShapeId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeShapeId.js","names":["sortedStringify","obj","JSON","stringify","_","v","Array","isArray","Object","fromEntries","entries","sort","a","b","localeCompare","computeShapeId","input","canonical","canonicalizeShapeInput","simpleHash","sortedPropKeys","keys","props","canonicalProps","key","config","op","nullabilityOp","type","defaultValue","canonicalLinks","derivedLinks","map","link","name","objectSetDef","canonicalizeObjectSetDef","targetShapeId","targetShape","__shapeId","baseType","baseTypeApiName","links","def","result","segments","seg","linkName","sourceType","where","parse","orderBy","length","o","property","direction","limit","undefined","distinct","setOperations","other","str","hash","i","char","charCodeAt","positiveHash","toString","padStart"],"sources":["computeShapeId.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 {\n  ShapeDerivedLinkDef,\n  ShapeLinkObjectSetDef,\n  ShapePropertyConfig,\n} from \"./ShapeDefinition.js\";\n\ninterface ShapeIdInput {\n  baseTypeApiName: string;\n  props: Record<string, ShapePropertyConfig>;\n  derivedLinks: readonly ShapeDerivedLinkDef[];\n}\n\nfunction sortedStringify(obj: unknown): string {\n  return JSON.stringify(\n    obj,\n    (_, v) =>\n      v && typeof v === \"object\" && !Array.isArray(v)\n        ? Object.fromEntries(\n          Object.entries(v).sort(([a], [b]) => a.localeCompare(b)),\n        )\n        : v,\n  );\n}\n\n/**\n * Computes a stable, deterministic identifier for a shape definition.\n * The ID uniquely represents the combination of base type, property\n * selections/nullability configs, and derived link definitions so\n * that identical shapes produce the same ID across calls.\n */\nexport function computeShapeId(input: ShapeIdInput): string {\n  const canonical = canonicalizeShapeInput(input);\n  return simpleHash(sortedStringify(canonical));\n}\n\nfunction canonicalizeShapeInput(\n  input: ShapeIdInput,\n): Record<string, unknown> {\n  const sortedPropKeys = [...Object.keys(input.props)].sort();\n  const canonicalProps: Record<string, unknown> = {};\n\n  for (const key of sortedPropKeys) {\n    const config = input.props[key];\n    const op = config.nullabilityOp;\n    canonicalProps[key] = op.type === \"withDefault\"\n      ? { type: op.type, defaultValue: op.defaultValue }\n      : op.type;\n  }\n\n  const canonicalLinks = input.derivedLinks.map((link) => ({\n    name: link.name,\n    objectSetDef: canonicalizeObjectSetDef(link.objectSetDef),\n    targetShapeId: link.targetShape.__shapeId,\n  }));\n  canonicalLinks.sort((a, b) => a.name.localeCompare(b.name));\n\n  return {\n    baseType: input.baseTypeApiName,\n    props: canonicalProps,\n    links: canonicalLinks,\n  };\n}\n\nfunction canonicalizeObjectSetDef(\n  def: ShapeLinkObjectSetDef,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {\n    segments: def.segments.map((seg) => ({\n      type: seg.type,\n      linkName: seg.linkName,\n      sourceType: seg.sourceType,\n    })),\n  };\n\n  if (def.where) {\n    result.where = JSON.parse(sortedStringify(def.where));\n  }\n\n  if (def.orderBy && def.orderBy.length > 0) {\n    result.orderBy = def.orderBy.map((o) => ({\n      property: o.property,\n      direction: o.direction,\n    }));\n  }\n\n  if (def.limit !== undefined) {\n    result.limit = def.limit;\n  }\n\n  if (def.distinct) {\n    result.distinct = true;\n  }\n\n  if (def.setOperations && def.setOperations.length > 0) {\n    result.setOperations = def.setOperations.map((op) => ({\n      type: op.type,\n      other: canonicalizeObjectSetDef(op.other),\n    }));\n  }\n\n  return result;\n}\n\n// Shape IDs are used for cache keying and equality, not security,\n// so 32-bit is sufficient.\nfunction simpleHash(str: string): string {\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    const char = str.charCodeAt(i);\n    hash = ((hash << 5) + hash) ^ char;\n  }\n\n  const positiveHash = hash >>> 0;\n  return positiveHash.toString(16).padStart(8, \"0\");\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/shapes/configToShapeDefinition.js

@@ -0,0 +1,115 @@
+/*
+ * Copyright 2025 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 { computeShapeId } from "./computeShapeId.js";
+import { createShapeLinkBuilder } from "./ShapeBuilder.js";
+export function configToShapeDefinition(baseType, config) {
+  const baseTypeApiName = baseType.apiName;
+  const props = {};
+  const seen = new Set();
+  function addProp(prop, config2) {
+    if (seen.has(prop)) {
+      throw new Error(`Property "${prop}" appears in multiple config arrays`);
+    }
+    seen.add(prop);
+    props[prop] = config2;
+  }
+  if (config.require) {
+    for (const prop of config.require) {
+      addProp(prop, {
+        nullabilityOp: {
+          type: "require"
+        }
+      });
+    }
+  }
+  if (config.select) {
+    for (const prop of config.select) {
+      addProp(prop, {
+        nullabilityOp: {
+          type: "select"
+        }
+      });
+    }
+  }
+  if (config.dropIfNull) {
+    for (const prop of config.dropIfNull) {
+      addProp(prop, {
+        nullabilityOp: {
+          type: "dropIfNull"
+        }
+      });
+    }
+  }
+  if (config.defaults) {
+    for (const [prop, defaultValue] of Object.entries(config.defaults)) {
+      addProp(prop, {
+        nullabilityOp: {
+          type: "withDefault",
+          defaultValue
+        }
+      });
+    }
+  }
+  if (config.transforms) {
+    for (const [prop, transform] of Object.entries(config.transforms)) {
+      if (typeof transform !== "function") {
+        throw new Error(`transforms["${prop}"] must be a function, got: ${typeof transform}`);
+      }
+      addProp(prop, {
+        nullabilityOp: {
+          type: "withTransform",
+          transform
+        }
+      });
+    }
+  }
+  const derivedLinks = [];
+  if (config.links) {
+    for (const [name, linkConfig] of Object.entries(config.links)) {
+      const linkBuilder = createShapeLinkBuilder(baseTypeApiName);
+      const traversed = linkConfig.via(linkBuilder);
+      const objectSetDef = traversed.toObjectSetDef();
+      const targetShape = linkConfig.target;
+      derivedLinks.push({
+        name,
+        objectSetDef,
+        targetShape,
+        config: {
+          defer: linkConfig.defer
+        }
+      });
+    }
+  }
+  const shapeId = computeShapeId({
+    baseTypeApiName,
+    props,
+    derivedLinks
+  });
+  return {
+    __shapeId: shapeId,
+    __debugName: undefined,
+    __baseType: baseType,
+    __baseTypeApiName: baseTypeApiName,
+    __props: Object.freeze({
+      ...props
+    }),
+    __derivedLinks: Object.freeze([...derivedLinks]),
+    __selectedPropsType: {},
+    __derivedLinksType: {}
+  };
+}
+//# sourceMappingURL=configToShapeDefinition.js.map

package/build/browser/shapes/configToShapeDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configToShapeDefinition.js","names":["computeShapeId","createShapeLinkBuilder","configToShapeDefinition","baseType","config","baseTypeApiName","apiName","props","seen","Set","addProp","prop","config2","has","Error","add","require","nullabilityOp","type","select","dropIfNull","defaults","defaultValue","Object","entries","transforms","transform","derivedLinks","links","name","linkConfig","linkBuilder","traversed","via","objectSetDef","toObjectSetDef","targetShape","target","push","defer","shapeId","__shapeId","__debugName","undefined","__baseType","__baseTypeApiName","__props","freeze","__derivedLinks","__selectedPropsType","__derivedLinksType"],"sources":["configToShapeDefinition.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 { ObjectOrInterfaceDefinition } from \"../ontology/ObjectOrInterface.js\";\nimport { computeShapeId } from \"./computeShapeId.js\";\nimport type {\n  InferShapeDefinition,\n  InlineShapeConfig,\n} from \"./InlineShapeConfig.js\";\nimport { createShapeLinkBuilder } from \"./ShapeBuilder.js\";\nimport type {\n  NullabilityOp,\n  ShapeDefinition,\n  ShapeDerivedLinkDef,\n  ShapeLinkBuilderInternal,\n  ShapeLinkObjectSetDef,\n  ShapePropertyConfig,\n} from \"./ShapeDefinition.js\";\n\nexport function configToShapeDefinition<\n  BASE extends ObjectOrInterfaceDefinition,\n  const C extends InlineShapeConfig<BASE>,\n>(\n  baseType: BASE,\n  config: C,\n): InferShapeDefinition<BASE, C> {\n  const baseTypeApiName = baseType.apiName;\n  const props: Record<string, ShapePropertyConfig> = {};\n\n  const seen = new Set<string>();\n  function addProp(prop: string, config2: ShapePropertyConfig) {\n    if (seen.has(prop)) {\n      throw new Error(`Property \"${prop}\" appears in multiple config arrays`);\n    }\n    seen.add(prop);\n    props[prop] = config2;\n  }\n\n  if (config.require) {\n    for (const prop of config.require) {\n      addProp(prop as string, { nullabilityOp: { type: \"require\" } });\n    }\n  }\n\n  if (config.select) {\n    for (const prop of config.select) {\n      addProp(prop as string, { nullabilityOp: { type: \"select\" } });\n    }\n  }\n\n  if (config.dropIfNull) {\n    for (const prop of config.dropIfNull) {\n      addProp(prop as string, { nullabilityOp: { type: \"dropIfNull\" } });\n    }\n  }\n\n  if (config.defaults) {\n    for (const [prop, defaultValue] of Object.entries(config.defaults)) {\n      addProp(prop, {\n        nullabilityOp: {\n          type: \"withDefault\",\n          defaultValue,\n        } as NullabilityOp,\n      });\n    }\n  }\n\n  if (config.transforms) {\n    for (const [prop, transform] of Object.entries(config.transforms)) {\n      if (typeof transform !== \"function\") {\n        throw new Error(\n          `transforms[\"${prop}\"] must be a function, got: ${typeof transform}`,\n        );\n      }\n      addProp(prop, {\n        nullabilityOp: {\n          type: \"withTransform\",\n          transform,\n        } as NullabilityOp,\n      });\n    }\n  }\n\n  const derivedLinks: ShapeDerivedLinkDef[] = [];\n\n  if (config.links) {\n    for (const [name, linkConfig] of Object.entries(config.links)) {\n      const linkBuilder = createShapeLinkBuilder(baseTypeApiName);\n      const traversed = linkConfig.via(linkBuilder as ShapeLinkBuilderInternal);\n      const objectSetDef: ShapeLinkObjectSetDef =\n        (traversed as ShapeLinkBuilderInternal).toObjectSetDef();\n\n      const targetShape: ShapeDefinition<ObjectOrInterfaceDefinition> =\n        linkConfig.target;\n\n      derivedLinks.push({\n        name,\n        objectSetDef,\n        targetShape,\n        config: { defer: linkConfig.defer },\n      });\n    }\n  }\n\n  const shapeId = computeShapeId({\n    baseTypeApiName,\n    props,\n    derivedLinks,\n  });\n\n  return {\n    __shapeId: shapeId,\n    __debugName: undefined,\n    __baseType: baseType,\n    __baseTypeApiName: baseTypeApiName,\n    __props: Object.freeze({ ...props }),\n    __derivedLinks: Object.freeze([...derivedLinks]),\n    __selectedPropsType: {} as InferShapeDefinition<\n      BASE,\n      C\n    >[\"__selectedPropsType\"],\n    __derivedLinksType: {} as InferShapeDefinition<\n      BASE,\n      C\n    >[\"__derivedLinksType\"],\n  } as InferShapeDefinition<BASE, C>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/{definitions/LinkDefinitions.test.js → shapes/index.js}

@@ -1,5 +1,5 @@
 /*
- * Copyright 2023 Palantir Technologies, Inc. All rights reserved.
+ * Copyright 2025 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.
@@ -14,13 +14,18 @@
  * limitations under the License.
  */
 
-import { describe, expectTypeOf, it } from "vitest";
-describe("DefaultToFalse", () => {
-  it("infers properly", () => {
-    expectTypeOf().toEqualTypeOf();
-    expectTypeOf().toEqualTypeOf();
-    expectTypeOf().toEqualTypeOf();
-    expectTypeOf().toEqualTypeOf();
-  });
-});
-//# sourceMappingURL=LinkDefinitions.test.js.map
+// Core types
+
+// Inline shape config types
+
+// Error types and runtime values
+export { isSourcePkSymbol, ShapeNullabilityError, SourcePrimaryKeySymbol } from "./ShapeDefinition.js";
+
+// Builder functions
+export { createShapeBuilder } from "./ShapeBuilder.js";
+
+// Inline config converter
+export { configToShapeDefinition } from "./configToShapeDefinition.js";
+
+// Inline config converter uses computeShapeId internally but it is not part of the public API.
+//# sourceMappingURL=index.js.map