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

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @osdk/api
 
+## 2.8.0-beta.29
+
+### Minor Changes
+
+- 4a856cb: add shape builder and inline config converter
+
+## 2.8.0-beta.28
+
+### Minor Changes
+
+- f294f5a: Remove literal support before GA.
+- d284bf2: add media types, caching, and metadata query
+- b68cebd: add shape type definitions with opaque internal fields and shapes-internal export path
+
 ## 2.8.0-beta.27
 
 ## 2.8.0-beta.26

package/build/browser/derivedProperties/DerivedProperty.js.map

@@ -1 +1 @@
-{"version":3,"file":"DerivedProperty.js","names":["DerivedProperty"],"sources":["DerivedProperty.ts"],"sourcesContent":["/*\n * Copyright 2024 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 { ValidAggregationKeys } from \"../aggregate/AggregatableKeys.js\";\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 { SimplePropertyDef } from \"../ontology/SimplePropertyDef.js\";\nimport type { LinkedType, LinkNames } from \"../util/LinkUtils.js\";\nimport type {\n  DatetimeExpressions,\n  DefinitionForType,\n  NumericExpressions,\n} from \"./Expressions.js\";\nimport type {\n  CollectWithPropAggregations,\n  MinMaxWithPropAggregateOption,\n} from \"./WithPropertiesAggregationOptions.js\";\n\ndeclare const DerivedPropertyDefinitionBrand: unique symbol;\n\nexport namespace DerivedProperty {\n  export interface Definition<\n    T extends SimplePropertyDef,\n    Q extends ObjectOrInterfaceDefinition,\n  > {\n    readonly [DerivedPropertyDefinitionBrand]: true;\n  }\n\n  export interface NumericPropertyDefinition<\n    T extends SimplePropertyDef,\n    Q extends ObjectOrInterfaceDefinition,\n  > extends Definition<T, Q>, NumericExpressions<Q, T> {}\n\n  export interface DatetimePropertyDefinition<\n    T extends SimplePropertyDef,\n    Q extends ObjectOrInterfaceDefinition,\n  > extends Definition<T, Q>, DatetimeExpressions<Q, T> {}\n\n  export type Creator<\n    Q extends ObjectOrInterfaceDefinition,\n    T extends SimplePropertyDef,\n  > = (\n    baseObjectSet: Builder<Q, false>,\n  ) =>\n    | Definition<T, Q>\n    | NumericPropertyDefinition<T, Q>\n    | DatetimePropertyDefinition<T, Q>;\n\n  export type Clause<\n    Q extends ObjectOrInterfaceDefinition,\n  > = {\n    [key: string]: Creator<Q, SimplePropertyDef>;\n  };\n\n  interface BaseBuilder<\n    Q extends ObjectOrInterfaceDefinition,\n    CONSTRAINED extends boolean,\n  > extends Filterable<Q, CONSTRAINED>, Pivotable<Q, CONSTRAINED> {\n  }\n\n  export interface Builder<\n    Q extends ObjectOrInterfaceDefinition,\n    CONSTRAINED extends boolean,\n  > extends BaseBuilder<Q, CONSTRAINED>, Selectable<Q>, Constant<Q> {\n  }\n\n  export interface AggregateBuilder<\n    Q extends ObjectOrInterfaceDefinition,\n    CONSTRAINED extends boolean,\n  > extends BaseBuilder<Q, CONSTRAINED>, Aggregatable<Q> {\n  }\n\n  export interface SelectPropertyBuilder<\n    Q extends ObjectOrInterfaceDefinition,\n    CONSTRAINED extends boolean,\n  > extends AggregateBuilder<Q, CONSTRAINED>, Selectable<Q> {\n  }\n\n  export type ValidParts = \"DAYS\" | \"MONTHS\" | \"QUARTERS\" | \"YEARS\";\n}\n\ntype BuilderTypeFromConstraint<\n  Q extends ObjectOrInterfaceDefinition,\n  CONSTRAINED extends boolean,\n> = CONSTRAINED extends true ? DerivedProperty.AggregateBuilder<Q, true>\n  : DerivedProperty.SelectPropertyBuilder<Q, false>;\n\ntype Filterable<\n  Q extends ObjectOrInterfaceDefinition,\n  CONSTRAINED extends boolean,\n> = {\n  readonly where: (\n    clause: WhereClause<Q>,\n  ) => BuilderTypeFromConstraint<Q, CONSTRAINED>;\n};\n\ntype Pivotable<\n  Q extends ObjectOrInterfaceDefinition,\n  CONSTRAINED extends boolean,\n> = {\n  readonly pivotTo: <L extends LinkNames<Q>>(\n    type: L,\n  ) => CONSTRAINED extends true\n    ? DerivedProperty.AggregateBuilder<LinkedType<Q, L>, true>\n    : NonNullable<CompileTimeMetadata<Q>[\"links\"][L][\"multiplicity\"]> extends\n      true ? DerivedProperty.AggregateBuilder<LinkedType<Q, L>, true>\n    : DerivedProperty.SelectPropertyBuilder<LinkedType<Q, L>, false>;\n};\n\ntype Constant<Q extends ObjectOrInterfaceDefinition> = {\n  readonly constant: {\n    readonly double: (\n      value: number,\n    ) => DerivedProperty.NumericPropertyDefinition<\n      SimplePropertyDef.Make<\"double\", \"non-nullable\", \"single\">,\n      Q\n    >;\n\n    readonly integer: (\n      value: number,\n    ) => DerivedProperty.NumericPropertyDefinition<\n      SimplePropertyDef.Make<\"integer\", \"non-nullable\", \"single\">,\n      Q\n    >;\n    readonly long: (\n      value: string,\n    ) => DerivedProperty.NumericPropertyDefinition<\n      SimplePropertyDef.Make<\"long\", \"non-nullable\", \"single\">,\n      Q\n    >;\n\n    readonly datetime: (\n      value: string,\n    ) => DerivedProperty.DatetimePropertyDefinition<\n      SimplePropertyDef.Make<\"datetime\", \"non-nullable\", \"single\">,\n      Q\n    >;\n    readonly timestamp: (\n      value: string,\n    ) => DerivedProperty.DatetimePropertyDefinition<\n      SimplePropertyDef.Make<\"timestamp\", \"non-nullable\", \"single\">,\n      Q\n    >;\n  };\n};\n\ntype Aggregatable<\n  Q extends ObjectOrInterfaceDefinition,\n> = {\n  readonly aggregate: <\n    V extends ValidAggregationKeys<\n      Q,\n      \"withPropertiesAggregate\"\n    >,\n  >(\n    aggregationSpecifier: V,\n    opts?: V extends `${any}:${infer P}`\n      ? P extends CollectWithPropAggregations ? { limit: number }\n      : P extends \"approximatePercentile\" ? { percentile: number }\n      : never\n      : never,\n  ) => DefinitionForType<\n    Q,\n    V extends `${infer N}:${infer P}`\n      ? P extends CollectWithPropAggregations ? SimplePropertyDef.Make<\n          CompileTimeMetadata<Q>[\"properties\"][N][\"type\"],\n          \"nullable\",\n          \"array\"\n        >\n      : P extends MinMaxWithPropAggregateOption ? SimplePropertyDef.Make<\n          CompileTimeMetadata<Q>[\"properties\"][N][\"type\"],\n          \"nullable\",\n          \"single\"\n        >\n      : P extends \"approximateDistinct\" | \"exactDistinct\"\n        ? SimplePropertyDef.Make<\n          \"integer\",\n          \"non-nullable\",\n          \"single\"\n        >\n      : SimplePropertyDef.Make<\n        \"double\",\n        \"nullable\",\n        \"single\"\n      >\n      : V extends \"$count\" ? SimplePropertyDef.Make<\n          \"integer\",\n          \"non-nullable\",\n          \"single\"\n        >\n      : never\n  >;\n};\n\ntype Selectable<Q extends ObjectOrInterfaceDefinition> = {\n  readonly selectProperty: <R extends PropertyKeys<Q>>(\n    propertyName: R,\n  ) => DefinitionForType<\n    Q,\n    SimplePropertyDef.Make<\n      CompileTimeMetadata<Q>[\"properties\"][R][\"type\"],\n      CompileTimeMetadata<Q>[\"properties\"][R][\"nullable\"] extends true\n        ? \"nullable\"\n        : \"non-nullable\",\n      CompileTimeMetadata<Q>[\"properties\"][R][\"multiplicity\"] extends true\n        ? \"array\"\n        : \"single\"\n    >\n  >;\n};\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAdA,WAqCiBA,eAAe","ignoreList":[]}
+{"version":3,"file":"DerivedProperty.js","names":["DerivedProperty"],"sources":["DerivedProperty.ts"],"sourcesContent":["/*\n * Copyright 2024 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 { ValidAggregationKeys } from \"../aggregate/AggregatableKeys.js\";\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 { SimplePropertyDef } from \"../ontology/SimplePropertyDef.js\";\nimport type { LinkedType, LinkNames } from \"../util/LinkUtils.js\";\nimport type {\n  DatetimeExpressions,\n  DefinitionForType,\n  NumericExpressions,\n} from \"./Expressions.js\";\nimport type {\n  CollectWithPropAggregations,\n  MinMaxWithPropAggregateOption,\n} from \"./WithPropertiesAggregationOptions.js\";\n\ndeclare const DerivedPropertyDefinitionBrand: unique symbol;\n\nexport namespace DerivedProperty {\n  export interface Definition<\n    T extends SimplePropertyDef,\n    Q extends ObjectOrInterfaceDefinition,\n  > {\n    readonly [DerivedPropertyDefinitionBrand]: true;\n  }\n\n  export interface NumericPropertyDefinition<\n    T extends SimplePropertyDef,\n    Q extends ObjectOrInterfaceDefinition,\n  > extends Definition<T, Q>, NumericExpressions<Q, T> {}\n\n  export interface DatetimePropertyDefinition<\n    T extends SimplePropertyDef,\n    Q extends ObjectOrInterfaceDefinition,\n  > extends Definition<T, Q>, DatetimeExpressions<Q, T> {}\n\n  export type Creator<\n    Q extends ObjectOrInterfaceDefinition,\n    T extends SimplePropertyDef,\n  > = (\n    baseObjectSet: Builder<Q, false>,\n  ) =>\n    | Definition<T, Q>\n    | NumericPropertyDefinition<T, Q>\n    | DatetimePropertyDefinition<T, Q>;\n\n  export type Clause<\n    Q extends ObjectOrInterfaceDefinition,\n  > = {\n    [key: string]: Creator<Q, SimplePropertyDef>;\n  };\n\n  interface BaseBuilder<\n    Q extends ObjectOrInterfaceDefinition,\n    CONSTRAINED extends boolean,\n  > extends Filterable<Q, CONSTRAINED>, Pivotable<Q, CONSTRAINED> {\n  }\n\n  export interface Builder<\n    Q extends ObjectOrInterfaceDefinition,\n    CONSTRAINED extends boolean,\n  > extends BaseBuilder<Q, CONSTRAINED>, Selectable<Q> {\n  }\n\n  export interface AggregateBuilder<\n    Q extends ObjectOrInterfaceDefinition,\n    CONSTRAINED extends boolean,\n  > extends BaseBuilder<Q, CONSTRAINED>, Aggregatable<Q> {\n  }\n\n  export interface SelectPropertyBuilder<\n    Q extends ObjectOrInterfaceDefinition,\n    CONSTRAINED extends boolean,\n  > extends AggregateBuilder<Q, CONSTRAINED>, Selectable<Q> {\n  }\n\n  export type ValidParts = \"DAYS\" | \"MONTHS\" | \"QUARTERS\" | \"YEARS\";\n}\n\ntype BuilderTypeFromConstraint<\n  Q extends ObjectOrInterfaceDefinition,\n  CONSTRAINED extends boolean,\n> = CONSTRAINED extends true ? DerivedProperty.AggregateBuilder<Q, true>\n  : DerivedProperty.SelectPropertyBuilder<Q, false>;\n\ntype Filterable<\n  Q extends ObjectOrInterfaceDefinition,\n  CONSTRAINED extends boolean,\n> = {\n  readonly where: (\n    clause: WhereClause<Q>,\n  ) => BuilderTypeFromConstraint<Q, CONSTRAINED>;\n};\n\ntype Pivotable<\n  Q extends ObjectOrInterfaceDefinition,\n  CONSTRAINED extends boolean,\n> = {\n  readonly pivotTo: <L extends LinkNames<Q>>(\n    type: L,\n  ) => CONSTRAINED extends true\n    ? DerivedProperty.AggregateBuilder<LinkedType<Q, L>, true>\n    : NonNullable<CompileTimeMetadata<Q>[\"links\"][L][\"multiplicity\"]> extends\n      true ? DerivedProperty.AggregateBuilder<LinkedType<Q, L>, true>\n    : DerivedProperty.SelectPropertyBuilder<LinkedType<Q, L>, false>;\n};\n\ntype Constant<Q extends ObjectOrInterfaceDefinition> = {\n  readonly constant: {\n    readonly double: (\n      value: number,\n    ) => DerivedProperty.NumericPropertyDefinition<\n      SimplePropertyDef.Make<\"double\", \"non-nullable\", \"single\">,\n      Q\n    >;\n\n    readonly integer: (\n      value: number,\n    ) => DerivedProperty.NumericPropertyDefinition<\n      SimplePropertyDef.Make<\"integer\", \"non-nullable\", \"single\">,\n      Q\n    >;\n    readonly long: (\n      value: string,\n    ) => DerivedProperty.NumericPropertyDefinition<\n      SimplePropertyDef.Make<\"long\", \"non-nullable\", \"single\">,\n      Q\n    >;\n\n    readonly datetime: (\n      value: string,\n    ) => DerivedProperty.DatetimePropertyDefinition<\n      SimplePropertyDef.Make<\"datetime\", \"non-nullable\", \"single\">,\n      Q\n    >;\n    readonly timestamp: (\n      value: string,\n    ) => DerivedProperty.DatetimePropertyDefinition<\n      SimplePropertyDef.Make<\"timestamp\", \"non-nullable\", \"single\">,\n      Q\n    >;\n  };\n};\n\ntype Aggregatable<\n  Q extends ObjectOrInterfaceDefinition,\n> = {\n  readonly aggregate: <\n    V extends ValidAggregationKeys<\n      Q,\n      \"withPropertiesAggregate\"\n    >,\n  >(\n    aggregationSpecifier: V,\n    opts?: V extends `${any}:${infer P}`\n      ? P extends CollectWithPropAggregations ? { limit: number }\n      : P extends \"approximatePercentile\" ? { percentile: number }\n      : never\n      : never,\n  ) => DefinitionForType<\n    Q,\n    V extends `${infer N}:${infer P}`\n      ? P extends CollectWithPropAggregations ? SimplePropertyDef.Make<\n          CompileTimeMetadata<Q>[\"properties\"][N][\"type\"],\n          \"nullable\",\n          \"array\"\n        >\n      : P extends MinMaxWithPropAggregateOption ? SimplePropertyDef.Make<\n          CompileTimeMetadata<Q>[\"properties\"][N][\"type\"],\n          \"nullable\",\n          \"single\"\n        >\n      : P extends \"approximateDistinct\" | \"exactDistinct\"\n        ? SimplePropertyDef.Make<\n          \"integer\",\n          \"non-nullable\",\n          \"single\"\n        >\n      : SimplePropertyDef.Make<\n        \"double\",\n        \"nullable\",\n        \"single\"\n      >\n      : V extends \"$count\" ? SimplePropertyDef.Make<\n          \"integer\",\n          \"non-nullable\",\n          \"single\"\n        >\n      : never\n  >;\n};\n\ntype Selectable<Q extends ObjectOrInterfaceDefinition> = {\n  readonly selectProperty: <R extends PropertyKeys<Q>>(\n    propertyName: R,\n  ) => DefinitionForType<\n    Q,\n    SimplePropertyDef.Make<\n      CompileTimeMetadata<Q>[\"properties\"][R][\"type\"],\n      CompileTimeMetadata<Q>[\"properties\"][R][\"nullable\"] extends true\n        ? \"nullable\"\n        : \"non-nullable\",\n      CompileTimeMetadata<Q>[\"properties\"][R][\"multiplicity\"] extends true\n        ? \"array\"\n        : \"single\"\n    >\n  >;\n};\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAdA,WAqCiBA,eAAe","ignoreList":[]}

package/build/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["DistanceUnitMapping","DurationMapping","isOk","TimeseriesDurationMapping"],"sources":["index.ts"],"sourcesContent":["/*\n * Copyright 2023 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 { ActionReturnTypeForOptions } from \"./actions/ActionReturnTypeForOptions.js\";\nexport type {\n  ActionEditResponse,\n  ActionParam,\n  ActionValidationResponse,\n  ApplyActionOptions,\n  ApplyBatchActionOptions,\n} from \"./actions/Actions.js\";\nexport type { ValidAggregationKeys } from \"./aggregate/AggregatableKeys.js\";\nexport type { AggregateOpts } from \"./aggregate/AggregateOpts.js\";\nexport type { AggregateOptsThatErrorsAndDisallowsOrderingWithMultipleGroupBy } from \"./aggregate/AggregateOptsThatErrors.js\";\nexport type { AggregationResultsWithGroups } from \"./aggregate/AggregationResultsWithGroups.js\";\nexport type { AggregationResultsWithoutGroups } from \"./aggregate/AggregationResultsWithoutGroups.js\";\nexport type { AggregationClause } from \"./aggregate/AggregationsClause.js\";\nexport type { AggregationsResults } from \"./aggregate/AggregationsResults.js\";\nexport type { GeoFilterOptions } from \"./aggregate/GeoFilter.js\";\nexport type { IntervalRule } from \"./aggregate/IntervalRule.js\";\nexport { DistanceUnitMapping } from \"./aggregate/WhereClause.js\";\nexport type {\n  AndWhereClause,\n  GeoFilter_Intersects,\n  GeoFilter_Within,\n  NotWhereClause,\n  OrWhereClause,\n  PossibleWhereClauseFilters,\n  WhereClause,\n} from \"./aggregate/WhereClause.js\";\nexport type {\n  OsdkObjectCreatePropertyType,\n  OsdkObjectPropertyType,\n} from \"./Definitions.js\";\nexport type {\n  OsdkObjectLinksObject,\n  SingleLinkAccessor,\n} from \"./definitions/LinkDefinitions.js\";\nexport { type DerivedProperty } from \"./derivedProperties/DerivedProperty.js\";\nexport { DurationMapping } from \"./groupby/GroupByClause.js\";\nexport type {\n  AllGroupByValues,\n  GroupByClause,\n  GroupByRange,\n} from \"./groupby/GroupByClause.js\";\nexport type { Logger } from \"./Logger.js\";\nexport type {\n  AllowedBucketKeyTypes,\n  AllowedBucketTypes,\n  DataValueClientToWire,\n  DataValueWireToClient,\n} from \"./mapping/DataValueMapping.js\";\nexport type {\n  PropertyValueWireToClient,\n} from \"./mapping/PropertyValueMapping.js\";\nexport type {\n  Attachment,\n  AttachmentMetadata,\n  AttachmentUpload,\n} from \"./object/Attachment.js\";\nexport type {\n  AsyncIterArgs,\n  Augment,\n  Augments,\n  FetchPageArgs,\n  NullabilityAdherence,\n  ObjectSetArgs,\n  SelectArg,\n  SelectArgToKeys,\n} from \"./object/FetchPageArgs.js\";\nexport type {\n  FetchPageResult,\n  SingleOsdkResult,\n} from \"./object/FetchPageResult.js\";\nexport type {\n  Media,\n  MediaMetadata,\n  MediaReference,\n  MediaUpload,\n} from \"./object/Media.js\";\nexport type {\n  PropertyMarkings,\n  PropertySecurity,\n} from \"./object/PropertySecurity.js\";\nexport { isOk } from \"./object/Result.js\";\nexport type { Result } from \"./object/Result.js\";\nexport type { BaseObjectSet } from \"./objectSet/BaseObjectSet.js\";\nexport type { ObjectSet } from \"./objectSet/ObjectSet.js\";\nexport type {\n  FetchLinksPageResult,\n  LinkTypeApiNamesFor,\n  MinimalDirectedObjectLinkInstance,\n} from \"./objectSet/ObjectSetLinks.js\";\nexport type { ObjectSetSubscription } from \"./objectSet/ObjectSetListener.js\";\nexport type {\n  ActionDefinition,\n  ActionMetadata,\n} from \"./ontology/ActionDefinition.js\";\nexport type {\n  InterfaceDefinition,\n  InterfaceMetadata,\n} from \"./ontology/InterfaceDefinition.js\";\nexport type {\n  ObjectOrInterfaceDefinition,\n  PropertyKeys,\n} from \"./ontology/ObjectOrInterface.js\";\nexport type { ObjectSpecifier } from \"./ontology/ObjectSpecifier.js\";\nexport type {\n  CompileTimeMetadata,\n  ObjectMetadata,\n  ObjectTypeDefinition,\n  PropertyDef,\n  VersionBound,\n} from \"./ontology/ObjectTypeDefinition.js\";\nexport type { OntologyMetadata } from \"./ontology/OntologyMetadata.js\";\nexport type { PrimaryKeyTypes } from \"./ontology/PrimaryKeyTypes.js\";\nexport type {\n  InterfaceQueryDataType,\n  ObjectQueryDataType,\n  ObjectSetQueryDataType,\n  QueryDataTypeDefinition,\n  QueryDefinition,\n  QueryMetadata,\n  QueryParameterDefinition,\n  ThreeDimensionalQueryAggregationDefinition,\n  TwoDimensionalQueryAggregationDefinition,\n} from \"./ontology/QueryDefinition.js\";\nexport type { SimplePropertyDef } from \"./ontology/SimplePropertyDef.js\";\nexport type { PropertyBooleanFormattingRule } from \"./ontology/valueFormatting/PropertyBooleanFormattingRule.js\";\nexport type {\n  DatetimeFormat,\n  DatetimeLocalizedFormat,\n  DatetimeLocalizedFormatType,\n  DatetimeStringFormat,\n  DatetimeTimezone,\n  DatetimeTimezoneStatic,\n  DatetimeTimezoneUser,\n  PropertyDateFormattingRule,\n  PropertyTimestampFormattingRule,\n} from \"./ontology/valueFormatting/PropertyDateAndTimestampFormattingRule.js\";\nexport type {\n  KnownType,\n  PropertyKnownTypeFormattingRule,\n} from \"./ontology/valueFormatting/PropertyKnownTypeFormattingRule.js\";\nexport type {\n  Affix,\n  DurationBaseValue,\n  DurationFormatStyle,\n  DurationPrecision,\n  HumanReadableFormat,\n  NumberFormatAffix,\n  NumberFormatCurrency,\n  NumberFormatCurrencyStyle,\n  NumberFormatCustomUnit,\n  NumberFormatDuration,\n  NumberFormatFixedValues,\n  NumberFormatNotation,\n  NumberFormatOptions,\n  NumberFormatRatio,\n  NumberFormatScale,\n  NumberFormatStandard,\n  NumberFormatStandardUnit,\n  NumberRatioType,\n  NumberRoundingMode,\n  NumberScaleType,\n  PropertyNumberFormattingRule,\n  PropertyNumberFormattingRuleType,\n  TimeCodeFormat,\n} from \"./ontology/valueFormatting/PropertyNumberFormattingRule.js\";\nexport type { PropertyValueFormattingRule } from \"./ontology/valueFormatting/PropertyValueFormattingRule.js\";\nexport type {\n  PropertyTypeReference,\n  PropertyTypeReferenceOrStringConstant,\n  StringConstant,\n} from \"./ontology/valueFormatting/PropertyValueFormattingUtils.js\";\nexport type {\n  BaseWirePropertyTypes,\n  WirePropertyTypes,\n} from \"./ontology/WirePropertyTypes.js\";\nexport type {\n  ObjectIdentifiers,\n  OsdkBase,\n  PrimaryKeyType,\n} from \"./OsdkBase.js\";\n// eslint-disable-next-line @typescript-eslint/no-deprecated\nexport type { OsdkObject } from \"./OsdkObject.js\";\nexport type { ConvertProps, MaybeScore, Osdk } from \"./OsdkObjectFrom.js\";\nexport type { PageResult } from \"./PageResult.js\";\nexport type {\n  Range,\n  ThreeDimensionalAggregation,\n  TwoDimensionalAggregation,\n} from \"./queries/Aggregations.js\";\nexport type { QueryParam, QueryResult } from \"./queries/Queries.js\";\nexport { TimeseriesDurationMapping } from \"./timeseries/timeseries.js\";\nexport type {\n  GeotimeSeriesProperty,\n  TimeSeriesPoint,\n  TimeSeriesProperty,\n  TimeSeriesQuery,\n} from \"./timeseries/timeseries.js\";\nexport type { LinkedType, LinkNames } from \"./util/LinkUtils.js\";\nexport {};\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA,SAASA,mBAAmB,QAAQ,4BAA4B;AAmBhE,SAASC,eAAe,QAAQ,4BAA4B;AA6C5D,SAASC,IAAI,QAAQ,oBAAoB;;AAoGzC;;AAUA,SAASC,yBAAyB,QAAQ,4BAA4B;AAQtE","ignoreList":[]}
+{"version":3,"file":"index.js","names":["DistanceUnitMapping","DurationMapping","isOk","TimeseriesDurationMapping"],"sources":["index.ts"],"sourcesContent":["/*\n * Copyright 2023 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 { ActionReturnTypeForOptions } from \"./actions/ActionReturnTypeForOptions.js\";\nexport type {\n  ActionEditResponse,\n  ActionParam,\n  ActionValidationResponse,\n  ApplyActionOptions,\n  ApplyBatchActionOptions,\n} from \"./actions/Actions.js\";\nexport type { ValidAggregationKeys } from \"./aggregate/AggregatableKeys.js\";\nexport type { AggregateOpts } from \"./aggregate/AggregateOpts.js\";\nexport type { AggregateOptsThatErrorsAndDisallowsOrderingWithMultipleGroupBy } from \"./aggregate/AggregateOptsThatErrors.js\";\nexport type { AggregationResultsWithGroups } from \"./aggregate/AggregationResultsWithGroups.js\";\nexport type { AggregationResultsWithoutGroups } from \"./aggregate/AggregationResultsWithoutGroups.js\";\nexport type { AggregationClause } from \"./aggregate/AggregationsClause.js\";\nexport type { AggregationsResults } from \"./aggregate/AggregationsResults.js\";\nexport type { GeoFilterOptions } from \"./aggregate/GeoFilter.js\";\nexport type { IntervalRule } from \"./aggregate/IntervalRule.js\";\nexport { DistanceUnitMapping } from \"./aggregate/WhereClause.js\";\nexport type {\n  AndWhereClause,\n  GeoFilter_Intersects,\n  GeoFilter_Within,\n  NotWhereClause,\n  OrWhereClause,\n  PossibleWhereClauseFilters,\n  WhereClause,\n} from \"./aggregate/WhereClause.js\";\nexport type {\n  OsdkObjectCreatePropertyType,\n  OsdkObjectPropertyType,\n} from \"./Definitions.js\";\nexport type {\n  OsdkObjectLinksObject,\n  SingleLinkAccessor,\n} from \"./definitions/LinkDefinitions.js\";\nexport { type DerivedProperty } from \"./derivedProperties/DerivedProperty.js\";\nexport { DurationMapping } from \"./groupby/GroupByClause.js\";\nexport type {\n  AllGroupByValues,\n  GroupByClause,\n  GroupByRange,\n} from \"./groupby/GroupByClause.js\";\nexport type { Logger } from \"./Logger.js\";\nexport type {\n  AllowedBucketKeyTypes,\n  AllowedBucketTypes,\n  DataValueClientToWire,\n  DataValueWireToClient,\n} from \"./mapping/DataValueMapping.js\";\nexport type {\n  PropertyValueWireToClient,\n} from \"./mapping/PropertyValueMapping.js\";\nexport type {\n  Attachment,\n  AttachmentMetadata,\n  AttachmentUpload,\n} from \"./object/Attachment.js\";\nexport type {\n  AsyncIterArgs,\n  Augment,\n  Augments,\n  FetchPageArgs,\n  NullabilityAdherence,\n  ObjectSetArgs,\n  SelectArg,\n  SelectArgToKeys,\n} from \"./object/FetchPageArgs.js\";\nexport type {\n  FetchPageResult,\n  SingleOsdkResult,\n} from \"./object/FetchPageResult.js\";\nexport type {\n  Media,\n  MediaMetadata,\n  MediaPropertyLocation,\n  MediaReference,\n  MediaUpload,\n} from \"./object/Media.js\";\nexport type {\n  PropertyMarkings,\n  PropertySecurity,\n} from \"./object/PropertySecurity.js\";\nexport { isOk } from \"./object/Result.js\";\nexport type { Result } from \"./object/Result.js\";\nexport type { BaseObjectSet } from \"./objectSet/BaseObjectSet.js\";\nexport type { ObjectSet } from \"./objectSet/ObjectSet.js\";\nexport type {\n  FetchLinksPageResult,\n  LinkTypeApiNamesFor,\n  MinimalDirectedObjectLinkInstance,\n} from \"./objectSet/ObjectSetLinks.js\";\nexport type { ObjectSetSubscription } from \"./objectSet/ObjectSetListener.js\";\nexport type {\n  ActionDefinition,\n  ActionMetadata,\n} from \"./ontology/ActionDefinition.js\";\nexport type {\n  InterfaceDefinition,\n  InterfaceMetadata,\n} from \"./ontology/InterfaceDefinition.js\";\nexport type {\n  ObjectOrInterfaceDefinition,\n  PropertyKeys,\n} from \"./ontology/ObjectOrInterface.js\";\nexport type { ObjectSpecifier } from \"./ontology/ObjectSpecifier.js\";\nexport type {\n  CompileTimeMetadata,\n  ObjectMetadata,\n  ObjectTypeDefinition,\n  PropertyDef,\n  VersionBound,\n} from \"./ontology/ObjectTypeDefinition.js\";\nexport type { OntologyMetadata } from \"./ontology/OntologyMetadata.js\";\nexport type { PrimaryKeyTypes } from \"./ontology/PrimaryKeyTypes.js\";\nexport type {\n  InterfaceQueryDataType,\n  ObjectQueryDataType,\n  ObjectSetQueryDataType,\n  QueryDataTypeDefinition,\n  QueryDefinition,\n  QueryMetadata,\n  QueryParameterDefinition,\n  ThreeDimensionalQueryAggregationDefinition,\n  TwoDimensionalQueryAggregationDefinition,\n} from \"./ontology/QueryDefinition.js\";\nexport type { SimplePropertyDef } from \"./ontology/SimplePropertyDef.js\";\nexport type { PropertyBooleanFormattingRule } from \"./ontology/valueFormatting/PropertyBooleanFormattingRule.js\";\nexport type {\n  DatetimeFormat,\n  DatetimeLocalizedFormat,\n  DatetimeLocalizedFormatType,\n  DatetimeStringFormat,\n  DatetimeTimezone,\n  DatetimeTimezoneStatic,\n  DatetimeTimezoneUser,\n  PropertyDateFormattingRule,\n  PropertyTimestampFormattingRule,\n} from \"./ontology/valueFormatting/PropertyDateAndTimestampFormattingRule.js\";\nexport type {\n  KnownType,\n  PropertyKnownTypeFormattingRule,\n} from \"./ontology/valueFormatting/PropertyKnownTypeFormattingRule.js\";\nexport type {\n  Affix,\n  DurationBaseValue,\n  DurationFormatStyle,\n  DurationPrecision,\n  HumanReadableFormat,\n  NumberFormatAffix,\n  NumberFormatCurrency,\n  NumberFormatCurrencyStyle,\n  NumberFormatCustomUnit,\n  NumberFormatDuration,\n  NumberFormatFixedValues,\n  NumberFormatNotation,\n  NumberFormatOptions,\n  NumberFormatRatio,\n  NumberFormatScale,\n  NumberFormatStandard,\n  NumberFormatStandardUnit,\n  NumberRatioType,\n  NumberRoundingMode,\n  NumberScaleType,\n  PropertyNumberFormattingRule,\n  PropertyNumberFormattingRuleType,\n  TimeCodeFormat,\n} from \"./ontology/valueFormatting/PropertyNumberFormattingRule.js\";\nexport type { PropertyValueFormattingRule } from \"./ontology/valueFormatting/PropertyValueFormattingRule.js\";\nexport type {\n  PropertyTypeReference,\n  PropertyTypeReferenceOrStringConstant,\n  StringConstant,\n} from \"./ontology/valueFormatting/PropertyValueFormattingUtils.js\";\nexport type {\n  BaseWirePropertyTypes,\n  WirePropertyTypes,\n} from \"./ontology/WirePropertyTypes.js\";\nexport type {\n  ObjectIdentifiers,\n  OsdkBase,\n  PrimaryKeyType,\n} from \"./OsdkBase.js\";\n// eslint-disable-next-line @typescript-eslint/no-deprecated\nexport type { OsdkObject } from \"./OsdkObject.js\";\nexport type { ConvertProps, MaybeScore, Osdk } from \"./OsdkObjectFrom.js\";\nexport type { PageResult } from \"./PageResult.js\";\nexport type {\n  Range,\n  ThreeDimensionalAggregation,\n  TwoDimensionalAggregation,\n} from \"./queries/Aggregations.js\";\nexport type { QueryParam, QueryResult } from \"./queries/Queries.js\";\nexport { TimeseriesDurationMapping } from \"./timeseries/timeseries.js\";\nexport type {\n  GeotimeSeriesProperty,\n  TimeSeriesPoint,\n  TimeSeriesProperty,\n  TimeSeriesQuery,\n} from \"./timeseries/timeseries.js\";\nexport type { LinkedType, LinkNames } from \"./util/LinkUtils.js\";\nexport {};\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA,SAASA,mBAAmB,QAAQ,4BAA4B;AAmBhE,SAASC,eAAe,QAAQ,4BAA4B;AA8C5D,SAASC,IAAI,QAAQ,oBAAoB;;AAoGzC;;AAUA,SAASC,yBAAyB,QAAQ,4BAA4B;AAQtE","ignoreList":[]}

package/build/browser/object/Media.js.map

@@ -1 +1 @@
-{"version":3,"file":"Media.js","names":[],"sources":["Media.ts"],"sourcesContent":["/*\n * Copyright 2024 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 interface Media {\n  /**\n   * Fetches metadata for media reference property\n   */\n  fetchMetadata(): Promise<MediaMetadata>;\n  /**\n   * Fetches content of a media reference property\n   */\n  fetchContents(): Promise<Response>;\n  /**\n   * Returns the media reference\n   */\n  getMediaReference(): MediaReference;\n}\n\n/**\n * Unique identifier of a media item in Foundry.\n */\nexport interface MediaReference {\n  mimeType: string;\n  reference: {\n    type: \"mediaSetViewItem\";\n    mediaSetViewItem: {\n      mediaItemRid: string;\n      mediaSetRid: string;\n      mediaSetViewRid: string;\n      token?: string;\n      /** @deprecated Use `token` instead */\n      readToken?: string;\n    };\n  };\n}\n\n/**\n * Object for uploading Media\n */\nexport interface MediaUpload {\n  readonly fileName: string;\n  readonly data: Blob;\n}\n\n/**\n * Metadata of a media item\n */\nexport interface MediaMetadata {\n  path?: string;\n  sizeBytes: number;\n  mediaType: string;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"Media.js","names":[],"sources":["Media.ts"],"sourcesContent":["/*\n * Copyright 2024 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 interface Media {\n  /**\n   * Fetches metadata for media reference property\n   */\n  fetchMetadata(): Promise<MediaMetadata>;\n  /**\n   * Fetches content of a media reference property\n   */\n  fetchContents(): Promise<Response>;\n  /**\n   * Returns the media reference\n   */\n  getMediaReference(): MediaReference;\n  /**\n   * Returns the source location of this media (object type, primary key, property name).\n   *\n   * Optional because not all media has a source location (e.g., transient/uploaded media).\n   */\n  getMediaSourceLocation?(): MediaPropertyLocation;\n}\n\n/**\n * Location of a media property on an object.\n */\nexport interface MediaPropertyLocation {\n  objectType: string;\n  primaryKey: string | number;\n  propertyName: string;\n}\n\n/**\n * Unique identifier of a media item in Foundry.\n */\nexport interface MediaReference {\n  mimeType: string;\n  reference: {\n    type: \"mediaSetViewItem\";\n    mediaSetViewItem: {\n      mediaItemRid: string;\n      mediaSetRid: string;\n      mediaSetViewRid: string;\n      token?: string;\n      /** @deprecated Use `token` instead */\n      readToken?: string;\n    };\n  };\n}\n\n/**\n * Object for uploading Media\n */\nexport interface MediaUpload {\n  readonly fileName: string;\n  readonly data: Blob;\n}\n\n/**\n * Metadata of a media item\n */\nexport interface MediaMetadata {\n  path?: string;\n  sizeBytes: number;\n  mediaType: string;\n}\n"],"mappings":"","ignoreList":[]}

package/build/browser/public/shapes-internal.js

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

package/build/browser/public/shapes-internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes-internal.js","names":[],"sources":["shapes-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 \"../shapes/internal.js\";\n"],"mappings":"","ignoreList":[]}

package/build/browser/public/unstable.js

@@ -18,4 +18,6 @@ export { __EXPERIMENTAL__NOT_SUPPORTED_YET__createMediaReference } from "../expe
 export { __EXPERIMENTAL__NOT_SUPPORTED_YET__fetchOneByRid } from "../experimental/fetchOneByRid.js";
 export { __EXPERIMENTAL__NOT_SUPPORTED_YET__fetchPageByRid } from "../experimental/fetchPageByRid.js";
 export { __EXPERIMENTAL__NOT_SUPPORTED_YET__getBulkLinks } from "../experimental/getBulkLinks.js";
+// Shapes (unstable — will graduate to @osdk/api/shapes when stable)
+export { configToShapeDefinition, createShapeBuilder, isSourcePkSymbol, ShapeNullabilityError, SourcePrimaryKeySymbol } from "../shapes/index.js";
 //# sourceMappingURL=unstable.js.map

package/build/browser/public/unstable.js.map

@@ -1 +1 @@
-{"version":3,"file":"unstable.js","names":["__EXPERIMENTAL__NOT_SUPPORTED_YET__createMediaReference","__EXPERIMENTAL__NOT_SUPPORTED_YET__fetchOneByRid","__EXPERIMENTAL__NOT_SUPPORTED_YET__fetchPageByRid","__EXPERIMENTAL__NOT_SUPPORTED_YET__getBulkLinks"],"sources":["unstable.ts"],"sourcesContent":["/*\n * Copyright 2024 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 { Experiment, ExperimentFns } from \"../experimental/Experiment.js\";\n\nexport { __EXPERIMENTAL__NOT_SUPPORTED_YET__createMediaReference } from \"../experimental/createMediaReference.js\";\nexport { __EXPERIMENTAL__NOT_SUPPORTED_YET__fetchOneByRid } from \"../experimental/fetchOneByRid.js\";\nexport {\n  __EXPERIMENTAL__NOT_SUPPORTED_YET__fetchPageByRid,\n  type FetchPageByRidPayload,\n} from \"../experimental/fetchPageByRid.js\";\nexport { __EXPERIMENTAL__NOT_SUPPORTED_YET__getBulkLinks } from \"../experimental/getBulkLinks.js\";\n\nexport type { EXPERIMENTAL_BulkLinkResult } from \"../objectSet/BulkLinkResult.js\";\nexport type { MinimalObjectSet } from \"../objectSet/ObjectSet.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,SAASA,uDAAuD,QAAQ,yCAAyC;AACjH,SAASC,gDAAgD,QAAQ,kCAAkC;AACnG,SACEC,iDAAiD,QAE5C,mCAAmC;AAC1C,SAASC,+CAA+C,QAAQ,iCAAiC","ignoreList":[]}
+{"version":3,"file":"unstable.js","names":["__EXPERIMENTAL__NOT_SUPPORTED_YET__createMediaReference","__EXPERIMENTAL__NOT_SUPPORTED_YET__fetchOneByRid","__EXPERIMENTAL__NOT_SUPPORTED_YET__fetchPageByRid","__EXPERIMENTAL__NOT_SUPPORTED_YET__getBulkLinks","configToShapeDefinition","createShapeBuilder","isSourcePkSymbol","ShapeNullabilityError","SourcePrimaryKeySymbol"],"sources":["unstable.ts"],"sourcesContent":["/*\n * Copyright 2024 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 { Experiment, ExperimentFns } from \"../experimental/Experiment.js\";\n\nexport { __EXPERIMENTAL__NOT_SUPPORTED_YET__createMediaReference } from \"../experimental/createMediaReference.js\";\nexport { __EXPERIMENTAL__NOT_SUPPORTED_YET__fetchOneByRid } from \"../experimental/fetchOneByRid.js\";\nexport {\n  __EXPERIMENTAL__NOT_SUPPORTED_YET__fetchPageByRid,\n  type FetchPageByRidPayload,\n} from \"../experimental/fetchPageByRid.js\";\nexport { __EXPERIMENTAL__NOT_SUPPORTED_YET__getBulkLinks } from \"../experimental/getBulkLinks.js\";\n\nexport type { EXPERIMENTAL_BulkLinkResult } from \"../objectSet/BulkLinkResult.js\";\nexport type { MinimalObjectSet } from \"../objectSet/ObjectSet.js\";\n\n// Shapes (unstable — will graduate to @osdk/api/shapes when stable)\nexport {\n  configToShapeDefinition,\n  createShapeBuilder,\n  isSourcePkSymbol,\n  ShapeNullabilityError,\n  SourcePrimaryKeySymbol,\n} from \"../shapes/index.js\";\n\nexport type {\n  InferShapeDefinition,\n  InlineLinkConfig,\n  InlineShapeConfig,\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 \"../shapes/index.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,SAASA,uDAAuD,QAAQ,yCAAyC;AACjH,SAASC,gDAAgD,QAAQ,kCAAkC;AACnG,SACEC,iDAAiD,QAE5C,mCAAmC;AAC1C,SAASC,+CAA+C,QAAQ,iCAAiC;AAKjG;AACA,SACEC,uBAAuB,EACvBC,kBAAkB,EAClBC,gBAAgB,EAChBC,qBAAqB,EACrBC,sBAAsB,QACjB,oBAAoB","ignoreList":[]}

package/build/browser/shapes/InlineShapeConfig.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"InlineShapeConfig.js","names":[],"sources":["InlineShapeConfig.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  ObjectOrInterfaceDefinition,\n  PropertyKeys,\n} from \"../ontology/ObjectOrInterface.js\";\nimport type {\n  PropertyType,\n  RequiredProperty,\n  ShapeDefinition,\n  ShapeLinkBuilder,\n} from \"./ShapeDefinition.js\";\n\nexport interface InlineShapeConfig<\n  BASE extends ObjectOrInterfaceDefinition,\n> {\n  readonly require?: readonly PropertyKeys<BASE>[];\n  readonly select?: readonly PropertyKeys<BASE>[];\n  readonly dropIfNull?: readonly PropertyKeys<BASE>[];\n  readonly defaults?: {\n    readonly [K in PropertyKeys<BASE>]?: NonNullable<PropertyType<BASE, K>>;\n  };\n  readonly transforms?: {\n    readonly [K in PropertyKeys<BASE>]?: (\n      value: PropertyType<BASE, K>,\n    ) => unknown;\n  };\n  readonly links?: Record<string, InlineLinkConfig<BASE>>;\n}\n\nexport interface InlineLinkConfig<\n  SOURCE extends ObjectOrInterfaceDefinition,\n> {\n  readonly via: (\n    builder: ShapeLinkBuilder<SOURCE, SOURCE>,\n  ) => ShapeLinkBuilder<SOURCE, ObjectOrInterfaceDefinition>;\n  readonly target: ShapeDefinition<ObjectOrInterfaceDefinition>;\n  readonly defer?: boolean;\n}\n\n// --- Type-level inference helpers ---\n\ntype ArrayElement<T> = T extends readonly (infer E)[] ? E : never;\n\nexport type InferInlineProps<\n  BASE extends ObjectOrInterfaceDefinition,\n  C extends InlineShapeConfig<BASE>,\n> =\n  & {\n    [K in ArrayElement<C[\"require\"]> & PropertyKeys<BASE>]: RequiredProperty<\n      PropertyType<BASE, K>\n    >;\n  }\n  & {\n    [K in ArrayElement<C[\"select\"]> & PropertyKeys<BASE>]: PropertyType<\n      BASE,\n      K\n    >;\n  }\n  & {\n    [K in ArrayElement<C[\"dropIfNull\"]> & PropertyKeys<BASE>]: RequiredProperty<\n      PropertyType<BASE, K>\n    >;\n  }\n  & {\n    [K in keyof C[\"defaults\"] & PropertyKeys<BASE>]: NonNullable<\n      PropertyType<BASE, K>\n    >;\n  }\n  & {\n    [K in keyof C[\"transforms\"] & PropertyKeys<BASE>]: C[\"transforms\"] extends\n      Record<K, (v: PropertyType<BASE, K>) => infer R> ? R : never;\n  };\n\nexport type InferInlineLinks<\n  BASE extends ObjectOrInterfaceDefinition,\n  C extends InlineShapeConfig<BASE>,\n> = C[\"links\"] extends Record<string, InlineLinkConfig<BASE>> ? {\n    [K in keyof C[\"links\"] & string]: C[\"links\"][K][\"target\"] extends\n      ShapeDefinition<ObjectOrInterfaceDefinition> ? C[\"links\"][K][\"target\"]\n      : ShapeDefinition<ObjectOrInterfaceDefinition>;\n  }\n  : {};\n\nexport type InferShapeDefinition<\n  BASE extends ObjectOrInterfaceDefinition,\n  C extends InlineShapeConfig<BASE>,\n> = ShapeDefinition<\n  BASE,\n  InferInlineProps<BASE, C>,\n  InferInlineLinks<BASE, C>\n>;\n"],"mappings":"","ignoreList":[]}

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