@osdk/api 2.8.0-beta.27 → 2.8.0-beta.29

package/build/esm/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/esm/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/esm/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/esm/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/esm/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/esm/shapes/index.js

@@ -0,0 +1,31 @@
+/*
+ * 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.
+ */
+
+// 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

package/build/esm/shapes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["isSourcePkSymbol","ShapeNullabilityError","SourcePrimaryKeySymbol","createShapeBuilder","configToShapeDefinition"],"sources":["index.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\n// Core types\nexport type {\n  LinkLoadConfig,\n  LinkStatus,\n  NullabilityViolation,\n  PropertyType,\n  RequiredProperty,\n  ShapeBaseType,\n  ShapeBuilder,\n  ShapeDefinition,\n  ShapeDerivedLinks,\n  ShapeInstance,\n  ShapeLinkBuilder,\n  ShapeLinkResult,\n} from \"./ShapeDefinition.js\";\n\n// Inline shape config types\nexport type {\n  InferShapeDefinition,\n  InlineLinkConfig,\n  InlineShapeConfig,\n} from \"./InlineShapeConfig.js\";\n\n// Error types and runtime values\nexport {\n  isSourcePkSymbol,\n  ShapeNullabilityError,\n  SourcePrimaryKeySymbol,\n} from \"./ShapeDefinition.js\";\n\n// Builder functions\nexport { createShapeBuilder } from \"./ShapeBuilder.js\";\n\n// Inline config converter\nexport { configToShapeDefinition } from \"./configToShapeDefinition.js\";\n\n// Inline config converter uses computeShapeId internally but it is not part of the public API.\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAgBA;;AAOA;AACA,SACEA,gBAAgB,EAChBC,qBAAqB,EACrBC,sBAAsB,QACjB,sBAAsB;;AAE7B;AACA,SAASC,kBAAkB,QAAQ,mBAAmB;;AAEtD;AACA,SAASC,uBAAuB,QAAQ,8BAA8B;;AAEtE","ignoreList":[]}

package/build/esm/shapes/internal.js

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

package/build/esm/shapes/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","names":[],"sources":["internal.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\nexport type {\n  DerivedLinkConfig,\n  NullabilityOp,\n  ShapeDerivedLinkDef,\n  ShapeLinkObjectSetDef,\n  ShapeLinkOrderBy,\n  ShapeLinkSegment,\n  ShapeLinkSetOperation,\n  ShapePropertyConfig,\n} from \"./ShapeDefinition.js\";\n"],"mappings":"","ignoreList":[]}

package/build/types/derivedProperties/DerivedProperty.d.ts

@@ -36,7 +36,7 @@ export declare namespace DerivedProperty {
 	export interface Builder<
 		Q extends ObjectOrInterfaceDefinition,
 		CONSTRAINED extends boolean
-	> extends BaseBuilder<Q, CONSTRAINED>, Selectable<Q>, Constant<Q> {}
+	> extends BaseBuilder<Q, CONSTRAINED>, Selectable<Q> {}
 	export interface AggregateBuilder<
 		Q extends ObjectOrInterfaceDefinition,
 		CONSTRAINED extends boolean
@@ -64,15 +64,6 @@ type Pivotable<
 > = {
 	readonly pivotTo: <L extends LinkNames<Q>>(type: L) => CONSTRAINED extends true ? DerivedProperty.AggregateBuilder<LinkedType<Q, L>, true> : NonNullable<CompileTimeMetadata<Q>["links"][L]["multiplicity"]> extends true ? DerivedProperty.AggregateBuilder<LinkedType<Q, L>, true> : DerivedProperty.SelectPropertyBuilder<LinkedType<Q, L>, false>
 };
-type Constant<Q extends ObjectOrInterfaceDefinition> = {
-	readonly constant: {
-		readonly double: (value: number) => DerivedProperty.NumericPropertyDefinition<SimplePropertyDef.Make<"double", "non-nullable", "single">, Q>
-		readonly integer: (value: number) => DerivedProperty.NumericPropertyDefinition<SimplePropertyDef.Make<"integer", "non-nullable", "single">, Q>
-		readonly long: (value: string) => DerivedProperty.NumericPropertyDefinition<SimplePropertyDef.Make<"long", "non-nullable", "single">, Q>
-		readonly datetime: (value: string) => DerivedProperty.DatetimePropertyDefinition<SimplePropertyDef.Make<"datetime", "non-nullable", "single">, Q>
-		readonly timestamp: (value: string) => DerivedProperty.DatetimePropertyDefinition<SimplePropertyDef.Make<"timestamp", "non-nullable", "single">, Q>
-	}
-};
 type Aggregatable<Q extends ObjectOrInterfaceDefinition> = {
 	readonly aggregate: <V extends ValidAggregationKeys<Q, "withPropertiesAggregate">>(aggregationSpecifier: V, opts?: V extends `${any}:${infer P}` ? P extends CollectWithPropAggregations ? {
 		limit: number

package/build/types/derivedProperties/DerivedProperty.d.ts.map

@@ -1 +1 @@
-{"mappings":"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","names":["DerivedPropertyDefinitionBrand: unique symbol","baseObjectSet: Builder<Q, false>","clause: WhereClause<Q>","type: L","value: number","value: string","aggregationSpecifier: V","opts?: V extends `${any}:${infer P}`\n      ? P extends CollectWithPropAggregations ? { limit: number }\n      : P extends \"approximatePercentile\" ? { percentile: number }\n      : never\n      : never","propertyName: R"],"sources":["../../../src/derivedProperties/DerivedProperty.ts"],"version":3,"file":"DerivedProperty.d.ts"}
+{"mappings":"AAgBA,cAAc,4BAA4B,kCAAmC;AAC7E,cAAc,mBAAmB,6BAA8B;AAC/D,cACE,6BACA,oBACK,kCAAmC;AAC1C,cAAc,2BAA2B,qCAAsC;AAC/E,cAAc,yBAAyB,kCAAmC;AAC1E,cAAc,YAAY,iBAAiB,sBAAuB;AAClE,cACE,qBACA,mBACA,0BACK,kBAAmB;AAC1B,cACE,6BACA,qCACK,uCAAwC;AAE/C,cAAcA;AAEd,yBAAiB;AACf,kBAAiB;EACf,UAAU;EACV,UAAU;GACV;YACU,iCAAiC;CAC5C;AAED,kBAAiB;EACf,UAAU;EACV,UAAU;WACF,WAAW,GAAG,IAAI,mBAAmB,GAAG,GAAG,CAAE;AAEvD,kBAAiB;EACf,UAAU;EACV,UAAU;WACF,WAAW,GAAG,IAAI,oBAAoB,GAAG,GAAG,CAAE;AAExD,aAAY;EACV,UAAU;EACV,UAAU;MAEVC,eAAe,QAAQ,GAAG,WAExB,WAAW,GAAG,KACd,0BAA0B,GAAG,KAC7B,2BAA2B,GAAG;AAElC,aAAY,OACV,UAAU,+BACR;iBACa,QAAQ,GAAG;CAC3B;WAES;EACR,UAAU;EACV;WACQ,WAAW,GAAG,cAAc,UAAU,GAAG,aAAa,CAC/D;AAED,kBAAiB;EACf,UAAU;EACV;WACQ,YAAY,GAAG,cAAc,WAAW,GAAG,CACpD;AAED,kBAAiB;EACf,UAAU;EACV;WACQ,YAAY,GAAG,cAAc,aAAa,GAAG,CACtD;AAED,kBAAiB;EACf,UAAU;EACV;WACQ,iBAAiB,GAAG,cAAc,WAAW,GAAG,CACzD;AAED,aAAY,aAAa,SAAS,WAAW,aAAa;;;KAGvD;CACH,UAAU;CACV;IACE,oBAAoB,OAAO,gBAAgB,iBAAiB,GAAG,QAC/D,gBAAgB,sBAAsB,GAAG;KAExC;CACH,UAAU;CACV;IACE;UACO,QACPC,QAAQ,YAAY,OACjB,0BAA0B,GAAG;AACnC;KAEI;CACH,UAAU;CACV;IACE;UACO,UAAU,UAAU,UAAU,IACrCC,MAAM,MACH,oBAAoB,OACrB,gBAAgB,iBAAiB,WAAW,GAAG,IAAI,QACnD,YAAY,oBAAoB,GAAG,SAAS,GAAG,yBAC/C,OAAO,gBAAgB,iBAAiB,WAAW,GAAG,IAAI,QAC1D,gBAAgB,sBAAsB,WAAW,GAAG,IAAI;AAC7D;KAuCI,aACH,UAAU,+BACR;UACO,YACP,UAAU,qBACR,GACA,4BAGFC,sBAAsB,GACtBC,OAAO,0BAA0B,MAC7B,UAAU,8BAA8B;EAAE;CAAe,IACzD,UAAU,0BAA0B;EAAE;CAAoB,sBAG3D,kBACH,GACA,mBAAmB,WAAW,MAC1B,UAAU,8BAA8B,kBAAkB,KACxD,oBAAoB,GAAG,cAAc,GAAG,SACxC,YACA,WAEF,UAAU,gCAAgC,kBAAkB,KAC1D,oBAAoB,GAAG,cAAc,GAAG,SACxC,YACA,YAEF,UAAU,wBAAwB,kBAChC,kBAAkB,KAClB,WACA,gBACA,YAEF,kBAAkB,KAClB,UACA,YACA,YAEA,UAAU,WAAW,kBAAkB,KACrC,WACA,gBACA;AAIT;KAEI,WAAW,UAAU,+BAA+B;UAC9C,iBAAiB,UAAU,aAAa,IAC/CC,cAAc,MACX,kBACH,GACA,kBAAkB,KAChB,oBAAoB,GAAG,cAAc,GAAG,SACxC,oBAAoB,GAAG,cAAc,GAAG,oBAAoB,OACxD,aACA,gBACJ,oBAAoB,GAAG,cAAc,GAAG,wBAAwB,OAC5D,UACA;AAGT","names":["DerivedPropertyDefinitionBrand: unique symbol","baseObjectSet: Builder<Q, false>","clause: WhereClause<Q>","type: L","aggregationSpecifier: V","opts?: V extends `${any}:${infer P}`\n      ? P extends CollectWithPropAggregations ? { limit: number }\n      : P extends \"approximatePercentile\" ? { percentile: number }\n      : never\n      : never","propertyName: R"],"sources":["../../../src/derivedProperties/DerivedProperty.ts"],"version":3,"file":"DerivedProperty.d.ts"}

package/build/types/index.d.ts

@@ -22,7 +22,7 @@ export type { PropertyValueWireToClient } from "./mapping/PropertyValueMapping.j
 export type { Attachment, AttachmentMetadata, AttachmentUpload } from "./object/Attachment.js";
 export type { AsyncIterArgs, Augment, Augments, FetchPageArgs, NullabilityAdherence, ObjectSetArgs, SelectArg, SelectArgToKeys } from "./object/FetchPageArgs.js";
 export type { FetchPageResult, SingleOsdkResult } from "./object/FetchPageResult.js";
-export type { Media, MediaMetadata, MediaReference, MediaUpload } from "./object/Media.js";
+export type { Media, MediaMetadata, MediaPropertyLocation, MediaReference, MediaUpload } from "./object/Media.js";
 export type { PropertyMarkings, PropertySecurity } from "./object/PropertySecurity.js";
 export { isOk } from "./object/Result.js";
 export type { Result } from "./object/Result.js";

package/build/types/index.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,kCAAkC;AAChD,cACE,oBACA,aACA,0BACA,oBACA,+BACK;AACP,cAAc,4BAA4B;AAC1C,cAAc,qBAAqB;AACnC,cAAc,sEAAsE;AACpF,cAAc,oCAAoC;AAClD,cAAc,uCAAuC;AACrD,cAAc,yBAAyB;AACvC,cAAc,2BAA2B;AACzC,cAAc,wBAAwB;AACtC,cAAc,oBAAoB;AAClC,SAAS,2BAA2B;AACpC,cACE,gBACA,sBACA,kBACA,gBACA,eACA,4BACA,mBACK;AACP,cACE,8BACA,8BACK;AACP,cACE,uBACA,0BACK;AACP,cAAc,uBAAuB;AACrC,SAAS,uBAAuB;AAChC,cACE,kBACA,eACA,oBACK;AACP,cAAc,cAAc;AAC5B,cACE,uBACA,oBACA,uBACA,6BACK;AACP,cACE,iCACK;AACP,cACE,YACA,oBACA,wBACK;AACP,cACE,eACA,SACA,UACA,eACA,sBACA,eACA,WACA,uBACK;AACP,cACE,iBACA,wBACK;AACP,cACE,OACA,eACA,gBACA,mBACK;AACP,cACE,kBACA,wBACK;AACP,SAAS,YAAY;AACrB,cAAc,cAAc;AAC5B,cAAc,qBAAqB;AACnC,cAAc,iBAAiB;AAC/B,cACE,sBACA,qBACA,yCACK;AACP,cAAc,6BAA6B;AAC3C,cACE,kBACA,sBACK;AACP,cACE,qBACA,yBACK;AACP,cACE,6BACA,oBACK;AACP,cAAc,uBAAuB;AACrC,cACE,qBACA,gBACA,sBACA,aACA,oBACK;AACP,cAAc,wBAAwB;AACtC,cAAc,uBAAuB;AACrC,cACE,wBACA,qBACA,wBACA,yBACA,iBACA,eACA,0BACA,4CACA,gDACK;AACP,cAAc,yBAAyB;AACvC,cAAc,qCAAqC;AACnD,cACE,gBACA,yBACA,6BACA,sBACA,kBACA,wBACA,sBACA,4BACA,uCACK;AACP,cACE,WACA,uCACK;AACP,cACE,OACA,mBACA,qBACA,mBACA,qBACA,mBACA,sBACA,2BACA,wBACA,sBACA,yBACA,sBACA,qBACA,mBACA,mBACA,sBACA,0BACA,iBACA,oBACA,iBACA,8BACA,kCACA,sBACK;AACP,cAAc,mCAAmC;AACjD,cACE,uBACA,uCACA,sBACK;AACP,cACE,uBACA,yBACK;AACP,cACE,mBACA,UACA,sBACK;AAEP,cAAc,kBAAkB;AAChC,cAAc,cAAc,YAAY,YAAY;AACpD,cAAc,kBAAkB;AAChC,cACE,OACA,6BACA,iCACK;AACP,cAAc,YAAY,mBAAmB;AAC7C,SAAS,iCAAiC;AAC1C,cACE,uBACA,iBACA,oBACA,uBACK;AACP,cAAc,YAAY,iBAAiB;AAC3C","names":[],"sources":["../../src/index.ts"],"version":3,"file":"index.d.ts"}
+{"mappings":"AAgBA,cAAc,kCAAkC;AAChD,cACE,oBACA,aACA,0BACA,oBACA,+BACK;AACP,cAAc,4BAA4B;AAC1C,cAAc,qBAAqB;AACnC,cAAc,sEAAsE;AACpF,cAAc,oCAAoC;AAClD,cAAc,uCAAuC;AACrD,cAAc,yBAAyB;AACvC,cAAc,2BAA2B;AACzC,cAAc,wBAAwB;AACtC,cAAc,oBAAoB;AAClC,SAAS,2BAA2B;AACpC,cACE,gBACA,sBACA,kBACA,gBACA,eACA,4BACA,mBACK;AACP,cACE,8BACA,8BACK;AACP,cACE,uBACA,0BACK;AACP,cAAc,uBAAuB;AACrC,SAAS,uBAAuB;AAChC,cACE,kBACA,eACA,oBACK;AACP,cAAc,cAAc;AAC5B,cACE,uBACA,oBACA,uBACA,6BACK;AACP,cACE,iCACK;AACP,cACE,YACA,oBACA,wBACK;AACP,cACE,eACA,SACA,UACA,eACA,sBACA,eACA,WACA,uBACK;AACP,cACE,iBACA,wBACK;AACP,cACE,OACA,eACA,uBACA,gBACA,mBACK;AACP,cACE,kBACA,wBACK;AACP,SAAS,YAAY;AACrB,cAAc,cAAc;AAC5B,cAAc,qBAAqB;AACnC,cAAc,iBAAiB;AAC/B,cACE,sBACA,qBACA,yCACK;AACP,cAAc,6BAA6B;AAC3C,cACE,kBACA,sBACK;AACP,cACE,qBACA,yBACK;AACP,cACE,6BACA,oBACK;AACP,cAAc,uBAAuB;AACrC,cACE,qBACA,gBACA,sBACA,aACA,oBACK;AACP,cAAc,wBAAwB;AACtC,cAAc,uBAAuB;AACrC,cACE,wBACA,qBACA,wBACA,yBACA,iBACA,eACA,0BACA,4CACA,gDACK;AACP,cAAc,yBAAyB;AACvC,cAAc,qCAAqC;AACnD,cACE,gBACA,yBACA,6BACA,sBACA,kBACA,wBACA,sBACA,4BACA,uCACK;AACP,cACE,WACA,uCACK;AACP,cACE,OACA,mBACA,qBACA,mBACA,qBACA,mBACA,sBACA,2BACA,wBACA,sBACA,yBACA,sBACA,qBACA,mBACA,mBACA,sBACA,0BACA,iBACA,oBACA,iBACA,8BACA,kCACA,sBACK;AACP,cAAc,mCAAmC;AACjD,cACE,uBACA,uCACA,sBACK;AACP,cACE,uBACA,yBACK;AACP,cACE,mBACA,UACA,sBACK;AAEP,cAAc,kBAAkB;AAChC,cAAc,cAAc,YAAY,YAAY;AACpD,cAAc,kBAAkB;AAChC,cACE,OACA,6BACA,iCACK;AACP,cAAc,YAAY,mBAAmB;AAC7C,SAAS,iCAAiC;AAC1C,cACE,uBACA,iBACA,oBACA,uBACK;AACP,cAAc,YAAY,iBAAiB;AAC3C","names":[],"sources":["../../src/index.ts"],"version":3,"file":"index.d.ts"}

package/build/types/object/Media.d.ts

@@ -11,6 +11,20 @@ export interface Media {
 	* Returns the media reference
 	*/
 	getMediaReference(): MediaReference;
+	/**
+	* Returns the source location of this media (object type, primary key, property name).
+	*
+	* Optional because not all media has a source location (e.g., transient/uploaded media).
+	*/
+	getMediaSourceLocation?(): MediaPropertyLocation;
+}
+/**
+* Location of a media property on an object.
+*/
+export interface MediaPropertyLocation {
+	objectType: string;
+	primaryKey: string | number;
+	propertyName: string;
 }
 /**
 * Unique identifier of a media item in Foundry.

package/build/types/object/Media.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,iBAAiB,MAAM;;;;CAIrB,iBAAiB,QAAQ;;;;CAIzB,iBAAiB,QAAQ;;;;CAIzB,qBAAqB;AACtB;;;;AAKD,iBAAiB,eAAe;CAC9B;CACA,WAAW;EACT,MAAM;EACN,kBAAkB;GAChB;GACA;GACA;GACA;;GAEA;EACD;CACF;AACF;;;;AAKD,iBAAiB,YAAY;UAClB;UACA,MAAM;AAChB;;;;AAKD,iBAAiB,cAAc;CAC7B;CACA;CACA;AACD","names":[],"sources":["../../../src/object/Media.ts"],"version":3,"file":"Media.d.ts"}
+{"mappings":"AAgBA,iBAAiB,MAAM;;;;CAIrB,iBAAiB,QAAQ;;;;CAIzB,iBAAiB,QAAQ;;;;CAIzB,qBAAqB;;;;;;CAMrB,2BAA2B;AAC5B;;;;AAKD,iBAAiB,sBAAsB;CACrC;CACA;CACA;AACD;;;;AAKD,iBAAiB,eAAe;CAC9B;CACA,WAAW;EACT,MAAM;EACN,kBAAkB;GAChB;GACA;GACA;GACA;;GAEA;EACD;CACF;AACF;;;;AAKD,iBAAiB,YAAY;UAClB;UACA,MAAM;AAChB;;;;AAKD,iBAAiB,cAAc;CAC7B;CACA;CACA;AACD","names":[],"sources":["../../../src/object/Media.ts"],"version":3,"file":"Media.d.ts"}

package/build/types/public/shapes-internal.d.ts

@@ -0,0 +1 @@
+export type { DerivedLinkConfig, NullabilityOp, ShapeDerivedLinkDef, ShapeLinkObjectSetDef, ShapeLinkOrderBy, ShapeLinkSegment, ShapeLinkSetOperation, ShapePropertyConfig } from "../shapes/internal.js";

package/build/types/public/shapes-internal.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,mBACA,eACA,qBACA,uBACA,kBACA,kBACA,uBACA,2BACK","names":[],"sources":["../../../src/public/shapes-internal.ts"],"version":3,"file":"shapes-internal.d.ts"}

package/build/types/public/unstable.d.ts

@@ -5,3 +5,5 @@ export { __EXPERIMENTAL__NOT_SUPPORTED_YET__fetchPageByRid, type FetchPageByRidP
 export { __EXPERIMENTAL__NOT_SUPPORTED_YET__getBulkLinks } from "../experimental/getBulkLinks.js";
 export type { EXPERIMENTAL_BulkLinkResult } from "../objectSet/BulkLinkResult.js";
 export type { MinimalObjectSet } from "../objectSet/ObjectSet.js";
+export { configToShapeDefinition, createShapeBuilder, isSourcePkSymbol, ShapeNullabilityError, SourcePrimaryKeySymbol } from "../shapes/index.js";
+export type { InferShapeDefinition, InlineLinkConfig, InlineShapeConfig, LinkLoadConfig, LinkStatus, NullabilityViolation, PropertyType, RequiredProperty, ShapeBaseType, ShapeBuilder, ShapeDefinition, ShapeDerivedLinks, ShapeInstance, ShapeLinkBuilder, ShapeLinkResult } from "../shapes/index.js";

package/build/types/public/unstable.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,YAAY,qBAAqB;AAE/C,SAAS,+DAA+D;AACxE,SAAS,wDAAwD;AACjE,SACE,wDACK,6BACA;AACP,SAAS,uDAAuD;AAEhE,cAAc,mCAAmC;AACjD,cAAc,wBAAwB","names":[],"sources":["../../../src/public/unstable.ts"],"version":3,"file":"unstable.d.ts"}
+{"mappings":"AAgBA,cAAc,YAAY,qBAAqB;AAE/C,SAAS,+DAA+D;AACxE,SAAS,wDAAwD;AACjE,SACE,wDACK,6BACA;AACP,SAAS,uDAAuD;AAEhE,cAAc,mCAAmC;AACjD,cAAc,wBAAwB;AAGtC,SACE,yBACA,oBACA,kBACA,uBACA,8BACK;AAEP,cACE,sBACA,kBACA,mBACA,gBACA,YACA,sBACA,cACA,kBACA,eACA,cACA,iBACA,mBACA,eACA,kBACA,uBACK","names":[],"sources":["../../../src/public/unstable.ts"],"version":3,"file":"unstable.d.ts"}

package/build/types/shapes/InlineShapeConfig.d.ts

@@ -0,0 +1,29 @@
+import type { ObjectOrInterfaceDefinition, PropertyKeys } from "../ontology/ObjectOrInterface.js";
+import type { PropertyType, RequiredProperty, ShapeDefinition, ShapeLinkBuilder } from "./ShapeDefinition.js";
+export interface InlineShapeConfig<BASE extends ObjectOrInterfaceDefinition> {
+	readonly require?: readonly PropertyKeys<BASE>[];
+	readonly select?: readonly PropertyKeys<BASE>[];
+	readonly dropIfNull?: readonly PropertyKeys<BASE>[];
+	readonly defaults?: { readonly [K in PropertyKeys<BASE>]? : NonNullable<PropertyType<BASE, K>> };
+	readonly transforms?: { readonly [K in PropertyKeys<BASE>]? : (value: PropertyType<BASE, K>) => unknown };
+	readonly links?: Record<string, InlineLinkConfig<BASE>>;
+}
+export interface InlineLinkConfig<SOURCE extends ObjectOrInterfaceDefinition> {
+	readonly via: (builder: ShapeLinkBuilder<SOURCE, SOURCE>) => ShapeLinkBuilder<SOURCE, ObjectOrInterfaceDefinition>;
+	readonly target: ShapeDefinition<ObjectOrInterfaceDefinition>;
+	readonly defer?: boolean;
+}
+type ArrayElement<T> = T extends readonly (infer E)[] ? E : never;
+export type InferInlineProps<
+	BASE extends ObjectOrInterfaceDefinition,
+	C extends InlineShapeConfig<BASE>
+> = { [K in ArrayElement<C["require"]> & PropertyKeys<BASE>] : RequiredProperty<PropertyType<BASE, K>> } & { [K in ArrayElement<C["select"]> & PropertyKeys<BASE>] : PropertyType<BASE, K> } & { [K in ArrayElement<C["dropIfNull"]> & PropertyKeys<BASE>] : RequiredProperty<PropertyType<BASE, K>> } & { [K in keyof C["defaults"] & PropertyKeys<BASE>] : NonNullable<PropertyType<BASE, K>> } & { [K in keyof C["transforms"] & PropertyKeys<BASE>] : C["transforms"] extends Record<K, (v: PropertyType<BASE, K>) => infer R> ? R : never };
+export type InferInlineLinks<
+	BASE extends ObjectOrInterfaceDefinition,
+	C extends InlineShapeConfig<BASE>
+> = C["links"] extends Record<string, InlineLinkConfig<BASE>> ? { [K in keyof C["links"] & string] : C["links"][K]["target"] extends ShapeDefinition<ObjectOrInterfaceDefinition> ? C["links"][K]["target"] : ShapeDefinition<ObjectOrInterfaceDefinition> } : {};
+export type InferShapeDefinition<
+	BASE extends ObjectOrInterfaceDefinition,
+	C extends InlineShapeConfig<BASE>
+> = ShapeDefinition<BASE, InferInlineProps<BASE, C>, InferInlineLinks<BASE, C>>;
+export {};

package/build/types/shapes/InlineShapeConfig.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,6BACA,oBACK,kCAAmC;AAC1C,cACE,cACA,kBACA,iBACA,wBACK,sBAAuB;AAE9B,iBAAiB,kBACf,aAAa,6BACb;UACS,mBAAmB,aAAa;UAChC,kBAAkB,aAAa;UAC/B,sBAAsB,aAAa;UACnC,uBACG,KAAK,aAAa,UAAS,YAAY,aAAa,MAAM;UAE7D,yBACG,KAAK,aAAa,WAC1BA,OAAO,aAAa,MAAM;UAGrB,QAAQ,eAAe,iBAAiB;AAClD;AAED,iBAAiB,iBACf,eAAe,6BACf;UACS,MACPC,SAAS,iBAAiB,QAAQ,YAC/B,iBAAiB,QAAQ;UACrB,QAAQ,gBAAgB;UACxB;AACV;KAII,aAAa,KAAK,0BAA0B,OAAO;AAExD,YAAY;CACV,aAAa;CACb,UAAU,kBAAkB;OAGzB,KAAK,aAAa,EAAE,cAAc,aAAa,SAAQ,iBACtD,aAAa,MAAM,WAIpB,KAAK,aAAa,EAAE,aAAa,aAAa,SAAQ,aACrD,MACA,UAID,KAAK,aAAa,EAAE,iBAAiB,aAAa,SAAQ,iBACzD,aAAa,MAAM,WAIpB,WAAW,EAAE,cAAc,aAAa,SAAQ,YAC/C,aAAa,MAAM,WAIpB,WAAW,EAAE,gBAAgB,aAAa,SAAQ,EAAE,sBACnD,OAAO,IAAIC,GAAG,aAAa,MAAM,aAAa,KAAK;AAGzD,YAAY;CACV,aAAa;CACb,UAAU,kBAAkB;IAC1B,EAAE,iBAAiB,eAAe,iBAAiB,YAClD,WAAW,EAAE,qBAAoB,EAAE,SAAS,GAAG,kBAC9C,gBAAgB,+BAA+B,EAAE,SAAS,GAAG,YAC3D,gBAAgB,iCAEpB,CAAE;AAEN,YAAY;CACV,aAAa;CACb,UAAU,kBAAkB;IAC1B,gBACF,MACA,iBAAiB,MAAM,IACvB,iBAAiB,MAAM","names":["value: PropertyType<BASE, K>","builder: ShapeLinkBuilder<SOURCE, SOURCE>","v: PropertyType<BASE, K>"],"sources":["../../../src/shapes/InlineShapeConfig.ts"],"version":3,"file":"InlineShapeConfig.d.ts"}

package/build/types/shapes/ShapeBuilder.d.ts

@@ -0,0 +1,21 @@
+import type { ObjectOrInterfaceDefinition } from "../ontology/ObjectOrInterface.js";
+import type { ShapeBuilder, ShapeLinkBuilder } from "./ShapeDefinition.js";
+export declare function createShapeLinkBuilder<
+	SOURCE extends ObjectOrInterfaceDefinition,
+	CURRENT extends ObjectOrInterfaceDefinition
+>(sourceTypeApiName: string): ShapeLinkBuilder<SOURCE, CURRENT>;
+/**
+* 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 declare function createShapeBuilder<BASE extends ObjectOrInterfaceDefinition>(baseType: BASE, debugName?: string): ShapeBuilder<BASE, {}, {}>;

package/build/types/shapes/ShapeBuilder.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,cACE,mCAEK,kCAAmC;AAI1C,cAKE,cAGA,wBAOK,sBAAuB;AA0S9B,OAAO,iBAAS;CACd,eAAe;CACf,gBAAgB;EAChBA,4BAA4B,iBAAiB,QAAQ;;;;;;;;;;;;;;;AAyBvD,OAAO,iBAAS,mBAAmB,aAAa,6BAC9CC,UAAU,MACVC,qBACC,aAAa,MAAM,CAAE,GAAE,CAAE","names":["sourceTypeApiName: string","baseType: BASE","debugName?: string"],"sources":["../../../src/shapes/ShapeBuilder.ts"],"version":3,"file":"ShapeBuilder.d.ts"}