@osdk/client 2.6.0-beta.3 → 2.6.0-beta.4

package/build/browser/observable/internal/Canonicalizer.js

@@ -0,0 +1,51 @@
+/*
+ * 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.
+ */
+
+/**
+ * Interface for canonicalizing objects.
+ */
+
+/**
+ * Base class for canonicalizers that provides common caching infrastructure.
+ * Subclasses control how structural deduplication is performed.
+ */
+export class CachingCanonicalizer {
+  /**
+   * Cache for input object identity.
+   */
+  inputCache = new WeakMap();
+
+  /**
+   * Look up or create a canonical form for the given input.
+   * This method handles the structural deduplication logic.
+   *
+   * @param input The input to canonicalize
+   * @returns The canonical form
+   */
+
+  canonicalize(input) {
+    if (!input) {
+      return undefined;
+    }
+    if (this.inputCache.has(input)) {
+      return this.inputCache.get(input);
+    }
+    const canonical = this.lookupOrCreate(input);
+    this.inputCache.set(input, canonical);
+    return canonical;
+  }
+}
+//# sourceMappingURL=Canonicalizer.js.map

package/build/browser/observable/internal/Canonicalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canonicalizer.js","names":["CachingCanonicalizer","inputCache","WeakMap","canonicalize","input","undefined","has","get","canonical","lookupOrCreate","set"],"sources":["Canonicalizer.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 { Canonical } from \"./Canonical.js\";\n\n/**\n * Interface for canonicalizing objects.\n */\nexport interface Canonicalizer<TInput, TCanonical> {\n  /**\n   * Canonicalizes the input object. Returns the same reference for\n   * structurally identical inputs.\n   */\n  canonicalize(input: TInput | undefined): Canonical<TCanonical> | undefined;\n}\n\n/**\n * Base class for canonicalizers that provides common caching infrastructure.\n * Subclasses control how structural deduplication is performed.\n */\nexport abstract class CachingCanonicalizer<TInput extends object, TCanonical>\n  implements Canonicalizer<TInput, TCanonical>\n{\n  /**\n   * Cache for input object identity.\n   */\n  protected inputCache: WeakMap<TInput, Canonical<TCanonical>> = new WeakMap<\n    TInput,\n    Canonical<TCanonical>\n  >();\n\n  /**\n   * Look up or create a canonical form for the given input.\n   * This method handles the structural deduplication logic.\n   *\n   * @param input The input to canonicalize\n   * @returns The canonical form\n   */\n  protected abstract lookupOrCreate(input: TInput): Canonical<TCanonical>;\n\n  canonicalize(input: TInput): Canonical<TCanonical>;\n  canonicalize(input: TInput | undefined): Canonical<TCanonical> | undefined;\n  canonicalize(input: TInput | undefined): Canonical<TCanonical> | undefined {\n    if (!input) {\n      return undefined;\n    }\n    if (this.inputCache.has(input)) {\n      return this.inputCache.get(input)!;\n    }\n\n    const canonical = this.lookupOrCreate(input);\n    this.inputCache.set(input, canonical);\n\n    return canonical;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA,OAAO,MAAeA,oBAAoB,CAE1C;EACE;AACF;AACA;EACYC,UAAU,GAA2C,IAAIC,OAAO,CAGxE,CAAC;;EAEH;AACF;AACA;AACA;AACA;AACA;AACA;;EAKEC,YAAYA,CAACC,KAAyB,EAAqC;IACzE,IAAI,CAACA,KAAK,EAAE;MACV,OAAOC,SAAS;IAClB;IACA,IAAI,IAAI,CAACJ,UAAU,CAACK,GAAG,CAACF,KAAK,CAAC,EAAE;MAC9B,OAAO,IAAI,CAACH,UAAU,CAACM,GAAG,CAACH,KAAK,CAAC;IACnC;IAEA,MAAMI,SAAS,GAAG,IAAI,CAACC,cAAc,CAACL,KAAK,CAAC;IAC5C,IAAI,CAACH,UAAU,CAACS,GAAG,CAACN,KAAK,EAAEI,SAAS,CAAC;IAErC,OAAOA,SAAS;EAClB;AACF","ignoreList":[]}

package/build/browser/observable/internal/ObservableClientImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeLinks","linkName","objectsArray","Array","isArray","parentSub","obj","querySubscription","links","srcType","type","$apiName","$primaryKey","add","observeObjectSet","baseObjectSet","objectSets","invalidateAll","invalidateObjects","invalidateObjectType","undefined","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize"],"sources":["ObservableClientImpl.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  ActionDefinition,\n  ActionValidationResponse,\n  CompileTimeMetadata,\n  InterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\nimport { Subscription } from \"rxjs\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport type { SpecificLinkPayload } from \"../LinkPayload.js\";\nimport type { ListPayload } from \"../ListPayload.js\";\nimport type { ObjectPayload } from \"../ObjectPayload.js\";\nimport type { ObjectSetPayload } from \"../ObjectSetPayload.js\";\nimport type {\n  ObservableClient,\n  ObserveListOptions,\n  ObserveObjectArgs,\n  ObserveObjectOptions,\n  ObserveObjectsArgs,\n  ObserveObjectSetArgs,\n  Unsubscribable,\n} from \"../ObservableClient.js\";\nimport type { Observer } from \"../ObservableClient/common.js\";\nimport type { ObserveLinks } from \"../ObservableClient/ObserveLink.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport type { ObserveObjectSetOptions } from \"./objectset/ObjectSetQueryOptions.js\";\nimport type { Store } from \"./Store.js\";\nimport { UnsubscribableWrapper } from \"./UnsubscribableWrapper.js\";\n\n/**\n * Implementation of the public ObservableClient interface.\n * - Delegates all operations to the Store for consistency\n * - Serves as the entry point for reactive data management\n * - Ensures proper method binding and API exposure\n *\n * @internal\n */\nexport class ObservableClientImpl implements ObservableClient {\n  __experimentalStore: Store;\n\n  constructor(store: Store) {\n    this.__experimentalStore = store;\n\n    this.applyAction = store.applyAction.bind(store);\n    this.validateAction = store.validateAction.bind(store);\n  }\n\n  public observeObject: <T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: Omit<ObserveObjectOptions<T>, \"apiName\" | \"pk\">,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ) => Unsubscribable = (apiName, pk, options, subFn) => {\n    return this.__experimentalStore.objects.observe(\n      {\n        ...options,\n        apiName,\n        pk,\n      },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectPayload>,\n    );\n  };\n\n  public observeList: <T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveListOptions<T>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ) => Unsubscribable = (options, subFn) => {\n    return this.__experimentalStore.lists.observe(\n      options,\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ListPayload>,\n    );\n  };\n\n  public observeLinks: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    L extends keyof CompileTimeMetadata<T>[\"links\"] & string,\n  >(\n    objects: Osdk.Instance<T> | Array<Osdk.Instance<T>>,\n    linkName: L,\n    options: ObserveLinks.Options<T, L>,\n    subFn: Observer<\n      ObserveLinks.CallbackArgs<\n        CompileTimeMetadata<T>[\"links\"][L][\"targetType\"]\n      >\n    >,\n  ) => Unsubscribable = (objects, linkName, options, subFn) => {\n    // Convert to array if single object provided\n    const objectsArray = Array.isArray(objects) ? objects : [objects];\n\n    const parentSub = new Subscription();\n\n    for (const obj of objectsArray) {\n      const querySubscription = this.__experimentalStore.links\n        .observe(\n          {\n            ...options,\n            srcType: {\n              type: \"object\",\n              apiName: obj.$apiName,\n            },\n            linkName,\n            pk: obj.$primaryKey,\n          },\n          // cast to cross typed to untyped barrier\n          subFn as unknown as Observer<SpecificLinkPayload>,\n        );\n\n      parentSub.add(querySubscription);\n    }\n\n    return new UnsubscribableWrapper(parentSub);\n  };\n\n  public applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  public validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  public observeObjectSet<\n    T extends ObjectTypeDefinition,\n    RDPs extends Record<\n      string,\n      WirePropertyTypes | undefined | Array<WirePropertyTypes>\n    > = {},\n  >(\n    baseObjectSet: ObjectSet<T>,\n    options: ObserveObjectSetOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectSetArgs<T, RDPs>>,\n  ): Unsubscribable {\n    return this.__experimentalStore.objectSets.observe(\n      { baseObjectSet, ...options },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectSetPayload>,\n    );\n  }\n\n  public invalidateAll(): Promise<void> {\n    return this.__experimentalStore.invalidateAll();\n  }\n\n  public invalidateObjects(\n    objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjects(objects);\n  }\n\n  public invalidateObjectType<T extends ObjectTypeDefinition>(\n    type: T | T[\"apiName\"],\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjectType(type, undefined);\n  }\n\n  public canonicalizeWhereClause<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n  >(where: WhereClause<T>): Canonical<WhereClause<T>> {\n    return this.__experimentalStore.whereCanonicalizer\n      .canonicalize(where) as Canonical<WhereClause<T>>;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA,SAASA,YAAY,QAAQ,MAAM;AAoBnC,SAASC,qBAAqB,QAAQ,4BAA4B;;AAElE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,CAA6B;EAG5DC,WAAWA,CAACC,KAAY,EAAE;IACxB,IAAI,CAACC,mBAAmB,GAAGD,KAAK;IAEhC,IAAI,CAACE,WAAW,GAAGF,KAAK,CAACE,WAAW,CAACC,IAAI,CAACH,KAAK,CAAC;IAChD,IAAI,CAACI,cAAc,GAAGJ,KAAK,CAACI,cAAc,CAACD,IAAI,CAACH,KAAK,CAAC;EACxD;EAEOK,aAAa,GAKEA,CAACC,OAAO,EAAEC,EAAE,EAAEC,OAAO,EAAEC,KAAK,KAAK;IACrD,OAAO,IAAI,CAACR,mBAAmB,CAACS,OAAO,CAACC,OAAO,CAC7C;MACE,GAAGH,OAAO;MACVF,OAAO;MACPC;IACF,CAAC;IACD;IACAE,KACF,CAAC;EACH,CAAC;EAEMG,WAAW,GAGIA,CAACJ,OAAO,EAAEC,KAAK,KAAK;IACxC,OAAO,IAAI,CAACR,mBAAmB,CAACY,KAAK,CAACF,OAAO,CAC3CH,OAAO;IACP;IACAC,KACF,CAAC;EACH,CAAC;EAEMK,YAAY,GAYGA,CAACJ,OAAO,EAAEK,QAAQ,EAAEP,OAAO,EAAEC,KAAK,KAAK;IAC3D;IACA,MAAMO,YAAY,GAAGC,KAAK,CAACC,OAAO,CAACR,OAAO,CAAC,GAAGA,OAAO,GAAG,CAACA,OAAO,CAAC;IAEjE,MAAMS,SAAS,GAAG,IAAIvB,YAAY,CAAC,CAAC;IAEpC,KAAK,MAAMwB,GAAG,IAAIJ,YAAY,EAAE;MAC9B,MAAMK,iBAAiB,GAAG,IAAI,CAACpB,mBAAmB,CAACqB,KAAK,CACrDX,OAAO,CACN;QACE,GAAGH,OAAO;QACVe,OAAO,EAAE;UACPC,IAAI,EAAE,QAAQ;UACdlB,OAAO,EAAEc,GAAG,CAACK;QACf,CAAC;QACDV,QAAQ;QACRR,EAAE,EAAEa,GAAG,CAACM;MACV,CAAC;MACD;MACAjB,KACF,CAAC;MAEHU,SAAS,CAACQ,GAAG,CAACN,iBAAiB,CAAC;IAClC;IAEA,OAAO,IAAIxB,qBAAqB,CAACsB,SAAS,CAAC;EAC7C,CAAC;EAaMS,gBAAgBA,CAOrBC,aAA2B,EAC3BrB,OAAyC,EACzCC,KAA8C,EAC9B;IAChB,OAAO,IAAI,CAACR,mBAAmB,CAAC6B,UAAU,CAACnB,OAAO,CAChD;MAAEkB,aAAa;MAAE,GAAGrB;IAAQ,CAAC;IAC7B;IACAC,KACF,CAAC;EACH;EAEOsB,aAAaA,CAAA,EAAkB;IACpC,OAAO,IAAI,CAAC9B,mBAAmB,CAAC8B,aAAa,CAAC,CAAC;EACjD;EAEOC,iBAAiBA,CACtBtB,OAEsD,EACvC;IACf,OAAO,IAAI,CAACT,mBAAmB,CAAC+B,iBAAiB,CAACtB,OAAO,CAAC;EAC5D;EAEOuB,oBAAoBA,CACzBT,IAAsB,EACP;IACf,OAAO,IAAI,CAACvB,mBAAmB,CAACgC,oBAAoB,CAACT,IAAI,EAAEU,SAAS,CAAC;EACvE;EAEOC,uBAAuBA,CAE5BC,KAAqB,EAA6B;IAClD,OAAO,IAAI,CAACnC,mBAAmB,CAACoC,kBAAkB,CAC/CC,YAAY,CAACF,KAAK,CAAC;EACxB;AACF","ignoreList":[]}
+{"version":3,"file":"ObservableClientImpl.js","names":["Subscription","UnsubscribableWrapper","ObservableClientImpl","constructor","store","__experimentalStore","applyAction","bind","validateAction","observeObject","apiName","pk","options","subFn","objects","observe","observeList","lists","observeLinks","linkName","objectsArray","Array","isArray","parentSub","obj","querySubscription","links","srcType","type","$apiName","$primaryKey","add","observeObjectSet","baseObjectSet","objectSets","invalidateAll","invalidateObjects","invalidateObjectType","undefined","canonicalizeWhereClause","where","whereCanonicalizer","canonicalize"],"sources":["ObservableClientImpl.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  ActionDefinition,\n  ActionValidationResponse,\n  CompileTimeMetadata,\n  InterfaceDefinition,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  PrimaryKeyType,\n  SimplePropertyDef,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\nimport { Subscription } from \"rxjs\";\nimport type { ActionSignatureFromDef } from \"../../actions/applyAction.js\";\nimport type { SpecificLinkPayload } from \"../LinkPayload.js\";\nimport type { ListPayload } from \"../ListPayload.js\";\nimport type { ObjectPayload } from \"../ObjectPayload.js\";\nimport type { ObjectSetPayload } from \"../ObjectSetPayload.js\";\nimport type {\n  ObservableClient,\n  ObserveListOptions,\n  ObserveObjectArgs,\n  ObserveObjectOptions,\n  ObserveObjectsArgs,\n  ObserveObjectSetArgs,\n  Unsubscribable,\n} from \"../ObservableClient.js\";\nimport type { Observer } from \"../ObservableClient/common.js\";\nimport type { ObserveLinks } from \"../ObservableClient/ObserveLink.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport type { ObserveObjectSetOptions } from \"./objectset/ObjectSetQueryOptions.js\";\nimport type { Store } from \"./Store.js\";\nimport { UnsubscribableWrapper } from \"./UnsubscribableWrapper.js\";\n\n/**\n * Implementation of the public ObservableClient interface.\n * - Delegates all operations to the Store for consistency\n * - Serves as the entry point for reactive data management\n * - Ensures proper method binding and API exposure\n *\n * @internal\n */\nexport class ObservableClientImpl implements ObservableClient {\n  __experimentalStore: Store;\n\n  constructor(store: Store) {\n    this.__experimentalStore = store;\n\n    this.applyAction = store.applyAction.bind(store);\n    this.validateAction = store.validateAction.bind(store);\n  }\n\n  public observeObject: <T extends ObjectTypeDefinition>(\n    apiName: T[\"apiName\"] | T,\n    pk: PrimaryKeyType<T>,\n    options: Omit<ObserveObjectOptions<T>, \"apiName\" | \"pk\">,\n    subFn: Observer<ObserveObjectArgs<T>>,\n  ) => Unsubscribable = (apiName, pk, options, subFn) => {\n    return this.__experimentalStore.objects.observe(\n      {\n        ...options,\n        apiName,\n        pk,\n      },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectPayload>,\n    );\n  };\n\n  public observeList: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(\n    options: ObserveListOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectsArgs<T>>,\n  ) => Unsubscribable = (options, subFn) => {\n    return this.__experimentalStore.lists.observe(\n      options,\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ListPayload>,\n    );\n  };\n\n  public observeLinks: <\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    L extends keyof CompileTimeMetadata<T>[\"links\"] & string,\n  >(\n    objects: Osdk.Instance<T> | Array<Osdk.Instance<T>>,\n    linkName: L,\n    options: ObserveLinks.Options<T, L>,\n    subFn: Observer<\n      ObserveLinks.CallbackArgs<\n        CompileTimeMetadata<T>[\"links\"][L][\"targetType\"]\n      >\n    >,\n  ) => Unsubscribable = (objects, linkName, options, subFn) => {\n    // Convert to array if single object provided\n    const objectsArray = Array.isArray(objects) ? objects : [objects];\n\n    const parentSub = new Subscription();\n\n    for (const obj of objectsArray) {\n      const querySubscription = this.__experimentalStore.links\n        .observe(\n          {\n            ...options,\n            srcType: {\n              type: \"object\",\n              apiName: obj.$apiName,\n            },\n            linkName,\n            pk: obj.$primaryKey,\n          },\n          // cast to cross typed to untyped barrier\n          subFn as unknown as Observer<SpecificLinkPayload>,\n        );\n\n      parentSub.add(querySubscription);\n    }\n\n    return new UnsubscribableWrapper(parentSub);\n  };\n\n  public applyAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts?: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  public validateAction: <Q extends ActionDefinition<any>>(\n    action: Q,\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse>;\n\n  public observeObjectSet<\n    T extends ObjectTypeDefinition,\n    RDPs extends Record<\n      string,\n      WirePropertyTypes | undefined | Array<WirePropertyTypes>\n    > = {},\n  >(\n    baseObjectSet: ObjectSet<T>,\n    options: ObserveObjectSetOptions<T, RDPs>,\n    subFn: Observer<ObserveObjectSetArgs<T, RDPs>>,\n  ): Unsubscribable {\n    return this.__experimentalStore.objectSets.observe(\n      { baseObjectSet, ...options },\n      // cast to cross typed to untyped barrier\n      subFn as unknown as Observer<ObjectSetPayload>,\n    );\n  }\n\n  public invalidateAll(): Promise<void> {\n    return this.__experimentalStore.invalidateAll();\n  }\n\n  public invalidateObjects(\n    objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>,\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjects(objects);\n  }\n\n  public invalidateObjectType<T extends ObjectTypeDefinition>(\n    type: T | T[\"apiName\"],\n  ): Promise<void> {\n    return this.__experimentalStore.invalidateObjectType(type, undefined);\n  }\n\n  public canonicalizeWhereClause<\n    T extends ObjectTypeDefinition | InterfaceDefinition,\n    RDPs extends Record<string, SimplePropertyDef> = {},\n  >(where: WhereClause<T, RDPs>): Canonical<WhereClause<T, RDPs>> {\n    return this.__experimentalStore.whereCanonicalizer\n      .canonicalize(where) as Canonical<WhereClause<T, RDPs>>;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA,SAASA,YAAY,QAAQ,MAAM;AAoBnC,SAASC,qBAAqB,QAAQ,4BAA4B;;AAElE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,CAA6B;EAG5DC,WAAWA,CAACC,KAAY,EAAE;IACxB,IAAI,CAACC,mBAAmB,GAAGD,KAAK;IAEhC,IAAI,CAACE,WAAW,GAAGF,KAAK,CAACE,WAAW,CAACC,IAAI,CAACH,KAAK,CAAC;IAChD,IAAI,CAACI,cAAc,GAAGJ,KAAK,CAACI,cAAc,CAACD,IAAI,CAACH,KAAK,CAAC;EACxD;EAEOK,aAAa,GAKEA,CAACC,OAAO,EAAEC,EAAE,EAAEC,OAAO,EAAEC,KAAK,KAAK;IACrD,OAAO,IAAI,CAACR,mBAAmB,CAACS,OAAO,CAACC,OAAO,CAC7C;MACE,GAAGH,OAAO;MACVF,OAAO;MACPC;IACF,CAAC;IACD;IACAE,KACF,CAAC;EACH,CAAC;EAEMG,WAAW,GAMIA,CAACJ,OAAO,EAAEC,KAAK,KAAK;IACxC,OAAO,IAAI,CAACR,mBAAmB,CAACY,KAAK,CAACF,OAAO,CAC3CH,OAAO;IACP;IACAC,KACF,CAAC;EACH,CAAC;EAEMK,YAAY,GAYGA,CAACJ,OAAO,EAAEK,QAAQ,EAAEP,OAAO,EAAEC,KAAK,KAAK;IAC3D;IACA,MAAMO,YAAY,GAAGC,KAAK,CAACC,OAAO,CAACR,OAAO,CAAC,GAAGA,OAAO,GAAG,CAACA,OAAO,CAAC;IAEjE,MAAMS,SAAS,GAAG,IAAIvB,YAAY,CAAC,CAAC;IAEpC,KAAK,MAAMwB,GAAG,IAAIJ,YAAY,EAAE;MAC9B,MAAMK,iBAAiB,GAAG,IAAI,CAACpB,mBAAmB,CAACqB,KAAK,CACrDX,OAAO,CACN;QACE,GAAGH,OAAO;QACVe,OAAO,EAAE;UACPC,IAAI,EAAE,QAAQ;UACdlB,OAAO,EAAEc,GAAG,CAACK;QACf,CAAC;QACDV,QAAQ;QACRR,EAAE,EAAEa,GAAG,CAACM;MACV,CAAC;MACD;MACAjB,KACF,CAAC;MAEHU,SAAS,CAACQ,GAAG,CAACN,iBAAiB,CAAC;IAClC;IAEA,OAAO,IAAIxB,qBAAqB,CAACsB,SAAS,CAAC;EAC7C,CAAC;EAaMS,gBAAgBA,CAOrBC,aAA2B,EAC3BrB,OAAyC,EACzCC,KAA8C,EAC9B;IAChB,OAAO,IAAI,CAACR,mBAAmB,CAAC6B,UAAU,CAACnB,OAAO,CAChD;MAAEkB,aAAa;MAAE,GAAGrB;IAAQ,CAAC;IAC7B;IACAC,KACF,CAAC;EACH;EAEOsB,aAAaA,CAAA,EAAkB;IACpC,OAAO,IAAI,CAAC9B,mBAAmB,CAAC8B,aAAa,CAAC,CAAC;EACjD;EAEOC,iBAAiBA,CACtBtB,OAEsD,EACvC;IACf,OAAO,IAAI,CAACT,mBAAmB,CAAC+B,iBAAiB,CAACtB,OAAO,CAAC;EAC5D;EAEOuB,oBAAoBA,CACzBT,IAAsB,EACP;IACf,OAAO,IAAI,CAACvB,mBAAmB,CAACgC,oBAAoB,CAACT,IAAI,EAAEU,SAAS,CAAC;EACvE;EAEOC,uBAAuBA,CAG5BC,KAA2B,EAAmC;IAC9D,OAAO,IAAI,CAACnC,mBAAmB,CAACoC,kBAAkB,CAC/CC,YAAY,CAACF,KAAK,CAAC;EACxB;AACF","ignoreList":[]}

package/build/browser/observable/internal/OrderByCanonicalizer.js

@@ -23,10 +23,7 @@ export class OrderByCanonicalizer {
       }
       return result;
     }, []);
-    let data = Object.fromEntries(pairs);
-    if (process.env.NODE_ENV !== "production") {
-      data = Object.freeze(data);
-    }
+    const data = Object.fromEntries(pairs);
     return data;
   });
   canonicalize = orderBy => {

package/build/browser/observable/internal/OrderByCanonicalizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"OrderByCanonicalizer.js","names":["WeakRefTrie","OrderByCanonicalizer","trie","array","pairs","reduce","result","_","index","push","slice","data","Object","fromEntries","process","env","NODE_ENV","freeze","canonicalize","orderBy","strings","entries","flat","lookupArray"],"sources":["OrderByCanonicalizer.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 { ObjectTypeDefinition } from \"@osdk/api\";\nimport type { OrderBy } from \"../ObservableClient.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport { WeakRefTrie } from \"./WeakRefTrie.js\";\n\nexport class OrderByCanonicalizer {\n  #trie = new WeakRefTrie(\n    (array: Array<string>) => {\n      const pairs = array.reduce<Array<[string, \"asc\" | \"desc\"]>>(\n        function(result, _, index, array) {\n          if (index % 2 === 0 && array[index] != null) {\n            result.push(\n              array.slice(index, index + 2) as [string, \"asc\" | \"desc\"],\n            );\n          }\n          return result;\n        },\n        [],\n      );\n      let data = Object.fromEntries(pairs) satisfies Record<\n        string,\n        \"asc\" | \"desc\"\n      > as Canonical<OrderBy<ObjectTypeDefinition>>;\n\n      if (process.env.NODE_ENV !== \"production\") {\n        data = Object.freeze(data);\n      }\n      return data;\n    },\n  );\n\n  canonicalize: (\n    orderBy: Record<string, \"asc\" | \"desc\" | undefined>,\n  ) => Canonical<Record<string, \"asc\" | \"desc\" | undefined>> = (\n    orderBy,\n  ) => {\n    const strings = Object.entries(orderBy).flat();\n    return this.#trie.lookupArray(strings);\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,SAASA,WAAW,QAAQ,kBAAkB;AAE9C,OAAO,MAAMC,oBAAoB,CAAC;EAChC,CAACC,IAAI,GAAG,IAAIF,WAAW,CACpBG,KAAoB,IAAK;IACxB,MAAMC,KAAK,GAAGD,KAAK,CAACE,MAAM,CACxB,UAASC,MAAM,EAAEC,CAAC,EAAEC,KAAK,EAAEL,KAAK,EAAE;MAChC,IAAIK,KAAK,GAAG,CAAC,KAAK,CAAC,IAAIL,KAAK,CAACK,KAAK,CAAC,IAAI,IAAI,EAAE;QAC3CF,MAAM,CAACG,IAAI,CACTN,KAAK,CAACO,KAAK,CAACF,KAAK,EAAEA,KAAK,GAAG,CAAC,CAC9B,CAAC;MACH;MACA,OAAOF,MAAM;IACf,CAAC,EACD,EACF,CAAC;IACD,IAAIK,IAAI,GAAGC,MAAM,CAACC,WAAW,CAACT,KAAK,CAGU;IAE7C,IAAIU,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;MACzCL,IAAI,GAAGC,MAAM,CAACK,MAAM,CAACN,IAAI,CAAC;IAC5B;IACA,OAAOA,IAAI;EACb,CACF,CAAC;EAEDO,YAAY,GAGVC,OAAO,IACJ;IACH,MAAMC,OAAO,GAAGR,MAAM,CAACS,OAAO,CAACF,OAAO,CAAC,CAACG,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,CAACpB,IAAI,CAACqB,WAAW,CAACH,OAAO,CAAC;EACxC,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"OrderByCanonicalizer.js","names":["WeakRefTrie","OrderByCanonicalizer","trie","array","pairs","reduce","result","_","index","push","slice","data","Object","fromEntries","canonicalize","orderBy","strings","entries","flat","lookupArray"],"sources":["OrderByCanonicalizer.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 { ObjectTypeDefinition } from \"@osdk/api\";\nimport type { OrderBy } from \"../ObservableClient.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport { WeakRefTrie } from \"./WeakRefTrie.js\";\n\nexport class OrderByCanonicalizer {\n  #trie = new WeakRefTrie(\n    (array: Array<string>) => {\n      const pairs = array.reduce<Array<[string, \"asc\" | \"desc\"]>>(\n        function(result, _, index, array) {\n          if (index % 2 === 0 && array[index] != null) {\n            result.push(\n              array.slice(index, index + 2) as [string, \"asc\" | \"desc\"],\n            );\n          }\n          return result;\n        },\n        [],\n      );\n      const data = Object.fromEntries(pairs) satisfies Record<\n        string,\n        \"asc\" | \"desc\"\n      > as Canonical<OrderBy<ObjectTypeDefinition>>;\n      return data;\n    },\n  );\n\n  canonicalize: (\n    orderBy: Record<string, \"asc\" | \"desc\" | undefined>,\n  ) => Canonical<Record<string, \"asc\" | \"desc\" | undefined>> = (\n    orderBy,\n  ) => {\n    const strings = Object.entries(orderBy).flat();\n    return this.#trie.lookupArray(strings);\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA,SAASA,WAAW,QAAQ,kBAAkB;AAE9C,OAAO,MAAMC,oBAAoB,CAAC;EAChC,CAACC,IAAI,GAAG,IAAIF,WAAW,CACpBG,KAAoB,IAAK;IACxB,MAAMC,KAAK,GAAGD,KAAK,CAACE,MAAM,CACxB,UAASC,MAAM,EAAEC,CAAC,EAAEC,KAAK,EAAEL,KAAK,EAAE;MAChC,IAAIK,KAAK,GAAG,CAAC,KAAK,CAAC,IAAIL,KAAK,CAACK,KAAK,CAAC,IAAI,IAAI,EAAE;QAC3CF,MAAM,CAACG,IAAI,CACTN,KAAK,CAACO,KAAK,CAACF,KAAK,EAAEA,KAAK,GAAG,CAAC,CAC9B,CAAC;MACH;MACA,OAAOF,MAAM;IACf,CAAC,EACD,EACF,CAAC;IACD,MAAMK,IAAI,GAAGC,MAAM,CAACC,WAAW,CAACT,KAAK,CAGQ;IAC7C,OAAOO,IAAI;EACb,CACF,CAAC;EAEDG,YAAY,GAGVC,OAAO,IACJ;IACH,MAAMC,OAAO,GAAGJ,MAAM,CAACK,OAAO,CAACF,OAAO,CAAC,CAACG,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,CAAChB,IAAI,CAACiB,WAAW,CAACH,OAAO,CAAC;EACxC,CAAC;AACH","ignoreList":[]}

package/build/browser/observable/internal/RdpCanonicalizer.js

@@ -0,0 +1,66 @@
+/*
+ * 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 { createWithPropertiesObjectSet } from "../../derivedProperties/createWithPropertiesObjectSet.js";
+import { CachingCanonicalizer } from "./Canonicalizer.js";
+export class RdpCanonicalizer extends CachingCanonicalizer {
+  structuralCache = new Map();
+  lookupOrCreate(rdp) {
+    // Map from builder result symbols to their definitions
+    const definitionMap = new Map();
+    const computedProperties = {};
+
+    // Create a wrapper holding object type for the builder to let us extract the definition structure
+    const objectTypeHolder = {
+      type: "object",
+      apiName: "__rdp_canonicalizer_holder__"
+    };
+    for (const [key, rdpFunction] of Object.entries(rdp)) {
+      const builder = createWithPropertiesObjectSet(objectTypeHolder, {
+        type: "methodInput"
+      }, definitionMap, /* fromBaseObjectSet */true);
+      const result = rdpFunction(builder);
+      const definition = definitionMap.get(result);
+      if (definition) {
+        computedProperties[key] = definition;
+      }
+    }
+
+    // Sort entries by key for consistent ordering
+    const sortedKeys = Object.keys(computedProperties).sort();
+
+    // Create a serialized key for the computed definitions
+    const sortedDefinitions = {};
+    for (const key of sortedKeys) {
+      sortedDefinitions[key] = computedProperties[key];
+    }
+    const definitionsKey = JSON.stringify(sortedDefinitions);
+
+    // Check if we already have a canonical RDP for these definitions
+    let canonical = this.structuralCache.get(definitionsKey);
+    if (!canonical) {
+      // Create a canonical RDP object with sorted keys
+      const sortedRdp = {};
+      for (const key of Object.keys(rdp).sort()) {
+        sortedRdp[key] = rdp[key];
+      }
+      canonical = sortedRdp;
+      this.structuralCache.set(definitionsKey, canonical);
+    }
+    return canonical;
+  }
+}
+//# sourceMappingURL=RdpCanonicalizer.js.map

package/build/browser/observable/internal/RdpCanonicalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RdpCanonicalizer.js","names":["createWithPropertiesObjectSet","CachingCanonicalizer","RdpCanonicalizer","structuralCache","Map","lookupOrCreate","rdp","definitionMap","computedProperties","objectTypeHolder","type","apiName","key","rdpFunction","Object","entries","builder","result","definition","get","sortedKeys","keys","sort","sortedDefinitions","definitionsKey","JSON","stringify","canonical","sortedRdp","set"],"sources":["RdpCanonicalizer.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  DerivedProperty,\n  ObjectOrInterfaceDefinition,\n  SimplePropertyDef,\n} from \"@osdk/api\";\nimport type { DerivedPropertyDefinition } from \"@osdk/foundry.ontologies\";\nimport { createWithPropertiesObjectSet } from \"../../derivedProperties/createWithPropertiesObjectSet.js\";\nimport type { Canonical } from \"./Canonical.js\";\nimport { CachingCanonicalizer } from \"./Canonicalizer.js\";\n\nexport type Rdp = DerivedProperty.Clause<ObjectOrInterfaceDefinition>;\n\nexport class RdpCanonicalizer extends CachingCanonicalizer<Rdp, Rdp> {\n  private structuralCache = new Map<string, Canonical<Rdp>>();\n\n  protected lookupOrCreate(rdp: Rdp): Canonical<Rdp> {\n    // Map from builder result symbols to their definitions\n    const definitionMap = new Map<\n      DerivedProperty.Definition<\n        SimplePropertyDef,\n        ObjectOrInterfaceDefinition\n      >,\n      DerivedPropertyDefinition\n    >();\n    const computedProperties: Record<string, DerivedPropertyDefinition> = {};\n\n    // Create a wrapper holding object type for the builder to let us extract the definition structure\n    const objectTypeHolder = {\n      type: \"object\" as const,\n      apiName: \"__rdp_canonicalizer_holder__\",\n    } as ObjectOrInterfaceDefinition;\n\n    for (const [key, rdpFunction] of Object.entries(rdp)) {\n      const builder = createWithPropertiesObjectSet(\n        objectTypeHolder,\n        { type: \"methodInput\" },\n        definitionMap,\n        /* fromBaseObjectSet */ true,\n      );\n\n      const result = rdpFunction(builder);\n      const definition = definitionMap.get(result);\n\n      if (definition) {\n        computedProperties[key] = definition;\n      }\n    }\n\n    // Sort entries by key for consistent ordering\n    const sortedKeys = Object.keys(computedProperties).sort();\n\n    // Create a serialized key for the computed definitions\n    const sortedDefinitions: Record<string, DerivedPropertyDefinition> = {};\n    for (const key of sortedKeys) {\n      sortedDefinitions[key] = computedProperties[key];\n    }\n    const definitionsKey = JSON.stringify(sortedDefinitions);\n\n    // Check if we already have a canonical RDP for these definitions\n    let canonical = this.structuralCache.get(definitionsKey);\n\n    if (!canonical) {\n      // Create a canonical RDP object with sorted keys\n      const sortedRdp: Rdp = {};\n      for (const key of Object.keys(rdp).sort()) {\n        sortedRdp[key] = rdp[key];\n      }\n      canonical = sortedRdp as Canonical<Rdp>;\n      this.structuralCache.set(definitionsKey, canonical);\n    }\n\n    return canonical;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,SAASA,6BAA6B,QAAQ,0DAA0D;AAExG,SAASC,oBAAoB,QAAQ,oBAAoB;AAIzD,OAAO,MAAMC,gBAAgB,SAASD,oBAAoB,CAAW;EAC3DE,eAAe,GAAG,IAAIC,GAAG,CAAyB,CAAC;EAEjDC,cAAcA,CAACC,GAAQ,EAAkB;IACjD;IACA,MAAMC,aAAa,GAAG,IAAIH,GAAG,CAM3B,CAAC;IACH,MAAMI,kBAA6D,GAAG,CAAC,CAAC;;IAExE;IACA,MAAMC,gBAAgB,GAAG;MACvBC,IAAI,EAAE,QAAiB;MACvBC,OAAO,EAAE;IACX,CAAgC;IAEhC,KAAK,MAAM,CAACC,GAAG,EAAEC,WAAW,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACT,GAAG,CAAC,EAAE;MACpD,MAAMU,OAAO,GAAGhB,6BAA6B,CAC3CS,gBAAgB,EAChB;QAAEC,IAAI,EAAE;MAAc,CAAC,EACvBH,aAAa,EACb,uBAAwB,IAC1B,CAAC;MAED,MAAMU,MAAM,GAAGJ,WAAW,CAACG,OAAO,CAAC;MACnC,MAAME,UAAU,GAAGX,aAAa,CAACY,GAAG,CAACF,MAAM,CAAC;MAE5C,IAAIC,UAAU,EAAE;QACdV,kBAAkB,CAACI,GAAG,CAAC,GAAGM,UAAU;MACtC;IACF;;IAEA;IACA,MAAME,UAAU,GAAGN,MAAM,CAACO,IAAI,CAACb,kBAAkB,CAAC,CAACc,IAAI,CAAC,CAAC;;IAEzD;IACA,MAAMC,iBAA4D,GAAG,CAAC,CAAC;IACvE,KAAK,MAAMX,GAAG,IAAIQ,UAAU,EAAE;MAC5BG,iBAAiB,CAACX,GAAG,CAAC,GAAGJ,kBAAkB,CAACI,GAAG,CAAC;IAClD;IACA,MAAMY,cAAc,GAAGC,IAAI,CAACC,SAAS,CAACH,iBAAiB,CAAC;;IAExD;IACA,IAAII,SAAS,GAAG,IAAI,CAACxB,eAAe,CAACgB,GAAG,CAACK,cAAc,CAAC;IAExD,IAAI,CAACG,SAAS,EAAE;MACd;MACA,MAAMC,SAAc,GAAG,CAAC,CAAC;MACzB,KAAK,MAAMhB,GAAG,IAAIE,MAAM,CAACO,IAAI,CAACf,GAAG,CAAC,CAACgB,IAAI,CAAC,CAAC,EAAE;QACzCM,SAAS,CAAChB,GAAG,CAAC,GAAGN,GAAG,CAACM,GAAG,CAAC;MAC3B;MACAe,SAAS,GAAGC,SAA2B;MACvC,IAAI,CAACzB,eAAe,CAAC0B,GAAG,CAACL,cAAc,EAAEG,SAAS,CAAC;IACrD;IAEA,OAAOA,SAAS;EAClB;AACF","ignoreList":[]}

package/build/browser/observable/internal/RdpCanonicalizer.test.js

@@ -0,0 +1,68 @@
+/*
+ * 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 { describe, expect, it } from "vitest";
+import { RdpCanonicalizer } from "./RdpCanonicalizer.js";
+describe("RdpCanonicalizer", () => {
+  it("returns same canonical object for functionally identical RDPs with different function references", () => {
+    const canonicalizer = new RdpCanonicalizer();
+
+    // Create first RDP with a function
+    const rdp1 = {
+      derivedAddress: base => base.pivotTo("lead").selectProperty("employeeId"),
+      derivedName: base => base.pivotTo("lead").selectProperty("fullName")
+    };
+
+    // Create second RDP with new function references but same logic
+    const rdp2 = {
+      derivedAddress: base => base.pivotTo("lead").selectProperty("employeeId"),
+      derivedName: base => base.pivotTo("lead").selectProperty("fullName")
+    };
+
+    // The functions should have different references
+    expect(rdp1.derivedAddress).not.toBe(rdp2.derivedAddress);
+    expect(rdp1.derivedName).not.toBe(rdp2.derivedName);
+
+    // But canonicalization should return the same object
+    const canonical1 = canonicalizer.canonicalize(rdp1);
+    const canonical2 = canonicalizer.canonicalize(rdp2);
+    expect(canonical1).toBe(canonical2);
+  });
+  it("handles complex RDP with aggregations", () => {
+    const canonicalizer = new RdpCanonicalizer();
+    const canonical1 = canonicalizer.canonicalize({
+      peepsCount: base => base.pivotTo("peeps").aggregate("$count"),
+      leadName: base => base.pivotTo("lead").selectProperty("fullName")
+    });
+    const canonical2 = canonicalizer.canonicalize({
+      peepsCount: base => base.pivotTo("peeps").aggregate("$count"),
+      leadName: base => base.pivotTo("lead").selectProperty("fullName")
+    });
+    expect(canonical1).toBe(canonical2);
+  });
+  it("caches results for the same input object", () => {
+    const canonicalizer = new RdpCanonicalizer();
+    const rdp = {
+      derivedProp: base => base.pivotTo("lead").selectProperty("employeeId")
+    };
+    const canonical1 = canonicalizer.canonicalize(rdp);
+    const canonical2 = canonicalizer.canonicalize(rdp);
+
+    // Same input object should return cached result
+    expect(canonical1).toBe(canonical2);
+  });
+});
+//# sourceMappingURL=RdpCanonicalizer.test.js.map

package/build/browser/observable/internal/RdpCanonicalizer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RdpCanonicalizer.test.js","names":["describe","expect","it","RdpCanonicalizer","canonicalizer","rdp1","derivedAddress","base","pivotTo","selectProperty","derivedName","rdp2","not","toBe","canonical1","canonicalize","canonical2","peepsCount","aggregate","leadName","rdp","derivedProp"],"sources":["RdpCanonicalizer.test.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { DerivedProperty } from \"@osdk/api\";\nimport type { Employee } from \"@osdk/client.test.ontology\";\nimport { describe, expect, it } from \"vitest\";\nimport { RdpCanonicalizer } from \"./RdpCanonicalizer.js\";\n\ndescribe(\"RdpCanonicalizer\", () => {\n  it(\"returns same canonical object for functionally identical RDPs with different function references\", () => {\n    const canonicalizer = new RdpCanonicalizer();\n\n    // Create first RDP with a function\n    const rdp1: DerivedProperty.Clause<typeof Employee> = {\n      derivedAddress: (base) =>\n        base.pivotTo(\"lead\").selectProperty(\"employeeId\"),\n      derivedName: (base) => base.pivotTo(\"lead\").selectProperty(\"fullName\"),\n    };\n\n    // Create second RDP with new function references but same logic\n    const rdp2: DerivedProperty.Clause<typeof Employee> = {\n      derivedAddress: (base) =>\n        base.pivotTo(\"lead\").selectProperty(\"employeeId\"),\n      derivedName: (base) => base.pivotTo(\"lead\").selectProperty(\"fullName\"),\n    };\n\n    // The functions should have different references\n    expect(rdp1.derivedAddress).not.toBe(rdp2.derivedAddress);\n    expect(rdp1.derivedName).not.toBe(rdp2.derivedName);\n\n    // But canonicalization should return the same object\n    const canonical1 = canonicalizer.canonicalize(rdp1);\n    const canonical2 = canonicalizer.canonicalize(rdp2);\n\n    expect(canonical1).toBe(canonical2);\n  });\n\n  it(\"handles complex RDP with aggregations\", () => {\n    const canonicalizer = new RdpCanonicalizer();\n\n    const rdp1: DerivedProperty.Clause<typeof Employee> = {\n      peepsCount: (base) => base.pivotTo(\"peeps\").aggregate(\"$count\"),\n      leadName: (base) => base.pivotTo(\"lead\").selectProperty(\"fullName\"),\n    };\n\n    const rdp2: DerivedProperty.Clause<typeof Employee> = {\n      peepsCount: (base) => base.pivotTo(\"peeps\").aggregate(\"$count\"),\n      leadName: (base) => base.pivotTo(\"lead\").selectProperty(\"fullName\"),\n    };\n\n    const canonical1 = canonicalizer.canonicalize(rdp1);\n    const canonical2 = canonicalizer.canonicalize(rdp2);\n\n    expect(canonical1).toBe(canonical2);\n  });\n\n  it(\"caches results for the same input object\", () => {\n    const canonicalizer = new RdpCanonicalizer();\n\n    const rdp: DerivedProperty.Clause<typeof Employee> = {\n      derivedProp: (base) => base.pivotTo(\"lead\").selectProperty(\"employeeId\"),\n    };\n\n    const canonical1 = canonicalizer.canonicalize(rdp);\n    const canonical2 = canonicalizer.canonicalize(rdp);\n\n    // Same input object should return cached result\n    expect(canonical1).toBe(canonical2);\n  });\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAC7C,SAASC,gBAAgB,QAAQ,uBAAuB;AAExDH,QAAQ,CAAC,kBAAkB,EAAE,MAAM;EACjCE,EAAE,CAAC,kGAAkG,EAAE,MAAM;IAC3G,MAAME,aAAa,GAAG,IAAID,gBAAgB,CAAC,CAAC;;IAE5C;IACA,MAAME,IAA6C,GAAG;MACpDC,cAAc,EAAGC,IAAI,IACnBA,IAAI,CAACC,OAAO,CAAC,MAAM,CAAC,CAACC,cAAc,CAAC,YAAY,CAAC;MACnDC,WAAW,EAAGH,IAAI,IAAKA,IAAI,CAACC,OAAO,CAAC,MAAM,CAAC,CAACC,cAAc,CAAC,UAAU;IACvE,CAAC;;IAED;IACA,MAAME,IAA6C,GAAG;MACpDL,cAAc,EAAGC,IAAI,IACnBA,IAAI,CAACC,OAAO,CAAC,MAAM,CAAC,CAACC,cAAc,CAAC,YAAY,CAAC;MACnDC,WAAW,EAAGH,IAAI,IAAKA,IAAI,CAACC,OAAO,CAAC,MAAM,CAAC,CAACC,cAAc,CAAC,UAAU;IACvE,CAAC;;IAED;IACAR,MAAM,CAACI,IAAI,CAACC,cAAc,CAAC,CAACM,GAAG,CAACC,IAAI,CAACF,IAAI,CAACL,cAAc,CAAC;IACzDL,MAAM,CAACI,IAAI,CAACK,WAAW,CAAC,CAACE,GAAG,CAACC,IAAI,CAACF,IAAI,CAACD,WAAW,CAAC;;IAEnD;IACA,MAAMI,UAAU,GAAGV,aAAa,CAACW,YAAY,CAACV,IAAI,CAAC;IACnD,MAAMW,UAAU,GAAGZ,aAAa,CAACW,YAAY,CAACJ,IAAI,CAAC;IAEnDV,MAAM,CAACa,UAAU,CAAC,CAACD,IAAI,CAACG,UAAU,CAAC;EACrC,CAAC,CAAC;EAEFd,EAAE,CAAC,uCAAuC,EAAE,MAAM;IAChD,MAAME,aAAa,GAAG,IAAID,gBAAgB,CAAC,CAAC;IAY5C,MAAMW,UAAU,GAAGV,aAAa,CAACW,YAAY,CAVS;MACpDE,UAAU,EAAGV,IAAI,IAAKA,IAAI,CAACC,OAAO,CAAC,OAAO,CAAC,CAACU,SAAS,CAAC,QAAQ,CAAC;MAC/DC,QAAQ,EAAGZ,IAAI,IAAKA,IAAI,CAACC,OAAO,CAAC,MAAM,CAAC,CAACC,cAAc,CAAC,UAAU;IACpE,CAOkD,CAAC;IACnD,MAAMO,UAAU,GAAGZ,aAAa,CAACW,YAAY,CANS;MACpDE,UAAU,EAAGV,IAAI,IAAKA,IAAI,CAACC,OAAO,CAAC,OAAO,CAAC,CAACU,SAAS,CAAC,QAAQ,CAAC;MAC/DC,QAAQ,EAAGZ,IAAI,IAAKA,IAAI,CAACC,OAAO,CAAC,MAAM,CAAC,CAACC,cAAc,CAAC,UAAU;IACpE,CAGkD,CAAC;IAEnDR,MAAM,CAACa,UAAU,CAAC,CAACD,IAAI,CAACG,UAAU,CAAC;EACrC,CAAC,CAAC;EAEFd,EAAE,CAAC,0CAA0C,EAAE,MAAM;IACnD,MAAME,aAAa,GAAG,IAAID,gBAAgB,CAAC,CAAC;IAE5C,MAAMiB,GAA4C,GAAG;MACnDC,WAAW,EAAGd,IAAI,IAAKA,IAAI,CAACC,OAAO,CAAC,MAAM,CAAC,CAACC,cAAc,CAAC,YAAY;IACzE,CAAC;IAED,MAAMK,UAAU,GAAGV,aAAa,CAACW,YAAY,CAACK,GAAG,CAAC;IAClD,MAAMJ,UAAU,GAAGZ,aAAa,CAACW,YAAY,CAACK,GAAG,CAAC;;IAElD;IACAnB,MAAM,CAACa,UAAU,CAAC,CAACD,IAAI,CAACG,UAAU,CAAC;EACrC,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/build/browser/observable/internal/SimpleWhereClause.js.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleWhereClause.js","names":[],"sources":["SimpleWhereClause.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 \"@osdk/api\";\n\nexport type SimpleWhereClause = WhereClause<\n  any\n>;\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"SimpleWhereClause.js","names":[],"sources":["SimpleWhereClause.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  SimplePropertyDef,\n  WhereClause,\n} from \"@osdk/api\";\n\n/**\n * A where clause without specific type information - used for runtime matching logic.\n * This accepts any WhereClause<T, RDPs> by using the base types.\n */\nexport type SimpleWhereClause = WhereClause<\n  ObjectOrInterfaceDefinition,\n  Record<string, SimplePropertyDef>\n>;\n"],"mappings":"","ignoreList":[]}

package/build/browser/observable/internal/Store.js

@@ -18,15 +18,20 @@ import invariant from "tiny-invariant";
 import { additionalContext } from "../../Client.js";
 import { DEBUG_REFCOUNTS } from "../DebugFlags.js";
 import { ActionApplication } from "./actions/ActionApplication.js";
+import { DEBUG_ONLY__cacheKeyToString } from "./CacheKey.js";
 import { CacheKeys } from "./CacheKeys.js";
 import { createChangedObjects, DEBUG_ONLY__changesToString } from "./Changes.js";
 import { Layers } from "./Layers.js";
 import { LinksHelper } from "./links/LinksHelper.js";
+import { API_NAME_IDX as LIST_API_NAME_IDX, RDP_IDX as LIST_RDP_IDX } from "./list/ListCacheKey.js";
 import { ListsHelper } from "./list/ListsHelper.js";
+import { API_NAME_IDX as OBJECT_API_NAME_IDX, RDP_CONFIG_IDX as OBJECT_RDP_CONFIG_IDX } from "./object/ObjectCacheKey.js";
+import { ObjectCacheKeyRegistry } from "./object/ObjectCacheKeyRegistry.js";
 import { ObjectsHelper } from "./object/ObjectsHelper.js";
 import { ObjectSetHelper } from "./objectset/ObjectSetHelper.js";
 import { OrderByCanonicalizer } from "./OrderByCanonicalizer.js";
 import { Queries } from "./Queries.js";
+import { RdpCanonicalizer } from "./RdpCanonicalizer.js";
 import { WhereClauseCanonicalizer } from "./WhereClauseCanonicalizer.js";
 /*
   Notes:
@@ -43,10 +48,12 @@ import { WhereClauseCanonicalizer } from "./WhereClauseCanonicalizer.js";
 export class Store {
   whereCanonicalizer = new WhereClauseCanonicalizer();
   orderByCanonicalizer = new OrderByCanonicalizer();
+  rdpCanonicalizer = new RdpCanonicalizer();
 
   /** @internal */
 
   queries = new Queries();
+  objectCacheKeyRegistry = new ObjectCacheKeyRegistry();
   layers = new Layers({
     logger: this.logger,
     onRevalidate: this.#maybeRevalidateQueries.bind(this)
@@ -63,7 +70,7 @@ export class Store {
     this.cacheKeys = new CacheKeys({
       onDestroy: this.#cleanupCacheKey
     });
-    this.lists = new ListsHelper(this, this.cacheKeys, this.whereCanonicalizer, this.orderByCanonicalizer);
+    this.lists = new ListsHelper(this, this.cacheKeys, this.whereCanonicalizer, this.orderByCanonicalizer, this.rdpCanonicalizer);
     this.objects = new ObjectsHelper(this, this.cacheKeys);
     this.links = new LinksHelper(this, this.cacheKeys, this.whereCanonicalizer, this.orderByCanonicalizer);
     this.objectSets = new ObjectSetHelper(this, this.cacheKeys, this.whereCanonicalizer, this.orderByCanonicalizer);
@@ -114,10 +121,28 @@ export class Store {
     if (typeof apiName !== "string") {
       apiName = apiName.apiName;
     }
-    return this.objects.getQuery({
-      apiName,
-      pk
-    }).revalidate(/* force */true);
+    const variants = this.objectCacheKeyRegistry.getVariants(apiName, pk);
+
+    // Invalidate all variant cache entries
+    // Using Promise.allSettled to ensure if one invalidation fails, others will still complete.
+    // This prevents a single failing query from blocking invalidation of other cache variants for the same object.
+    const promises = [];
+    if (variants.size === 0) {
+      // No registered variants - create and revalidate the base variant (no RDP)
+      promises.push(this.objects.getQuery({
+        apiName,
+        pk
+      }, undefined).revalidate(/* force */true));
+    } else {
+      // Revalidate all registered variants
+      for (const key of variants) {
+        const query = this.queries.peek(key);
+        if (query) {
+          promises.push(query.revalidate(/* force */true));
+        }
+      }
+    }
+    return Promise.allSettled(promises);
   }
   async #maybeRevalidateQueries(changes, optimisticId) {
     const logger = process.env.NODE_ENV !== "production" ? this.logger?.child({
@@ -137,7 +162,19 @@ export class Store {
     try {
       const promises = [];
       for (const cacheKey of this.queries.keys()) {
-        const promise = this.queries.peek(cacheKey)?.maybeUpdateAndRevalidate?.(changes, optimisticId);
+        const query = this.queries.peek(cacheKey);
+        if (!query?.maybeUpdateAndRevalidate) {
+          continue;
+        }
+
+        // Only propagate to queries that should receive these changes
+        if (!this.#shouldPropagateToQuery({
+          cacheKey,
+          maybeUpdateAndRevalidate: query.maybeUpdateAndRevalidate
+        }, changes, optimisticId)) {
+          continue;
+        }
+        const promise = query.maybeUpdateAndRevalidate(changes, optimisticId);
         if (promise) promises.push(promise);
       }
       await Promise.all(promises);
@@ -148,6 +185,123 @@ export class Store {
     }
   }
 
+  /**
+   * Determines whether changes should propagate to a specific query.
+   * Prevents unnecessary observable pipeline execution for cross-propagation.
+   *
+   * @param query - The query to check
+   * @param changes - The changes that occurred
+   * @param optimisticId - Optional optimistic update ID
+   * @returns true if the query should be notified of these changes
+   */
+  #shouldPropagateToQuery(query, changes, optimisticId) {
+    // Always propagate optimistic updates (user-initiated actions need immediate feedback)
+    if (optimisticId) {
+      return true;
+    }
+
+    // If the query's own cache key was modified (direct fetch), always propagate
+    if (changes.modified.has(query.cacheKey)) {
+      return true;
+    }
+
+    // Check if the query's object type is affected by the changes
+    if (this.#shouldPropagateForObjectTypeChanges(query.cacheKey, changes)) {
+      return true;
+    }
+
+    // For other cross-propagation (e.g., RDP field updates from unrelated object types):
+    // Only propagate to queries WITH RDP configurations
+    const queryRdpConfig = this.#getQueryRdpConfig(query.cacheKey);
+
+    // If query has no RDP, don't propagate unrelated object changes to it
+    // (it will get updates from its own direct fetches only)
+    return queryRdpConfig != null;
+  }
+
+  /**
+   * Checks if changes to an object type should propagate to a query.
+   * This ensures queries receive updates when objects of their type are added/modified.
+   *
+   * @param cacheKey - The cache key of the query
+   * @param changes - The changes that occurred
+   * @returns true if the query should be notified based on object type changes
+   */
+  #shouldPropagateForObjectTypeChanges(cacheKey, changes) {
+    const queryObjectType = this.#getQueryObjectType(cacheKey);
+    if (!queryObjectType) {
+      return false;
+    }
+    const affected = this.#changesAffectObjectType(changes, queryObjectType);
+    if (process.env.NODE_ENV !== "production") {
+      this.logger?.child({
+        methodName: "shouldPropagateToQuery"
+      }).debug(`Query type: ${queryObjectType}, affected: ${affected}`, {
+        queryKey: DEBUG_ONLY__cacheKeyToString(cacheKey),
+        addedCount: changes.addedObjects.get(queryObjectType)?.length ?? 0,
+        modifiedCount: changes.modifiedObjects.get(queryObjectType)?.length ?? 0
+      });
+    }
+    return affected;
+  }
+
+  /**
+   * Extracts RDP configuration from a cache key if present.
+   *
+   * @param cacheKey - The cache key to check
+   * @returns The RDP configuration, or undefined if not present
+   */
+  #getQueryRdpConfig(cacheKey) {
+    if ("otherKeys" in cacheKey && Array.isArray(cacheKey.otherKeys)) {
+      if (cacheKey.type === "object") {
+        return cacheKey.otherKeys[OBJECT_RDP_CONFIG_IDX];
+      } else if (cacheKey.type === "list") {
+        return cacheKey.otherKeys[LIST_RDP_IDX];
+      }
+    }
+    return undefined;
+  }
+
+  /**
+   * Extracts the object type (apiName) from a cache key.
+   *
+   * @param cacheKey - The cache key to check
+   * @returns The object type/apiName, or undefined if not applicable
+   */
+  #getQueryObjectType(cacheKey) {
+    if ("otherKeys" in cacheKey && Array.isArray(cacheKey.otherKeys)) {
+      if (cacheKey.type === "object") {
+        return cacheKey.otherKeys[OBJECT_API_NAME_IDX];
+      } else if (cacheKey.type === "list") {
+        return cacheKey.otherKeys[LIST_API_NAME_IDX];
+      }
+      // Links would have apiName at a different position
+    }
+    return undefined;
+  }
+
+  /**
+   * Checks if changes affect a specific object type.
+   *
+   * @param changes - The changes to check
+   * @param objectType - The object type to check for
+   * @returns true if the changes include added or modified objects of this type
+   */
+  #changesAffectObjectType(changes, objectType) {
+    // Check added objects (MultiMap.get returns an array)
+    const addedForType = changes.addedObjects.get(objectType);
+    if (addedForType && addedForType.length > 0) {
+      return true;
+    }
+
+    // Check modified objects (MultiMap.get returns an array)
+    const modifiedForType = changes.modifiedObjects.get(objectType);
+    if (modifiedForType && modifiedForType.length > 0) {
+      return true;
+    }
+    return false;
+  }
+
   /**
    * Invalidates all cache entries for a specific object type.
    * This will revalidate: