@osdk/client 2.4.2 → 2.5.0-beta.10

package/build/esm/observable/internal/{ObjectQuery.js → object/ObjectQuery.js}

@@ -16,10 +16,10 @@
 
 import deepEqual from "fast-deep-equal";
 import { BehaviorSubject, connectable, map } from "rxjs";
-import { additionalContext } from "../../Client.js";
-import { getBulkObjectLoader } from "./BulkObjectLoader.js";
-import { Query } from "./Query.js";
-import { tombstone } from "./tombstone.js";
+import { additionalContext } from "../../../Client.js";
+import { getBulkObjectLoader } from "../BulkObjectLoader.js";
+import { Query } from "../Query.js";
+import { tombstone } from "../tombstone.js";
 export class ObjectQuery extends Query {
   #apiName;
   #pk;
@@ -53,6 +53,11 @@ export class ObjectQuery extends Query {
         methodName: "_fetchAndStore"
       }).debug("calling _fetchAndStore");
     }
+
+    // TODO: In the future, implement tracking of network requests to ensure
+    // we're not making unnecessary network calls. This would need dedicated
+    // tests separate from subscription notification tests.
+
     const obj = await getBulkObjectLoader(this.store.client).fetch(this.#apiName, this.#pk);
     this.store.batch({}, batch => {
       this.writeToStore(obj, "loaded", batch);
@@ -61,10 +66,20 @@ export class ObjectQuery extends Query {
   writeToStore(data, status, batch) {
     const entry = batch.read(this.cacheKey);
     if (entry && deepEqual(data, entry.value)) {
+      // Check if both data AND status are the same
+      if (entry.status === status) {
+        if (process.env.NODE_ENV !== "production") {
+          this.logger?.child({
+            methodName: "writeToStore"
+          }).debug(`Object was deep equal and status unchanged (${status}), skipping update`);
+        }
+        // Return the existing entry without writing to avoid unnecessary notifications
+        return entry;
+      }
       if (process.env.NODE_ENV !== "production") {
         this.logger?.child({
           methodName: "writeToStore"
-        }).debug(`Object was deep equal, just setting status`);
+        }).debug(`Object was deep equal, just setting status (old status: ${entry.status}, new status: ${status})`);
       }
       // must do a "full write" here so that the lastUpdated is updated but we
       // don't want to retrigger anyone's memoization on the value!
@@ -109,18 +124,12 @@ export class ObjectQuery extends Query {
     batch.changes.deleteObject(this.cacheKey);
     return ret;
   }
-}
-
-/**
- * Internal helper method for writing objects to the store and returning their
- * object keys
- * @internal
- */
-export function storeOsdkInstances(store, values, batch) {
-  // update the cache for any object that has changed
-  // and save the mapped values to return
-  return values.map(v => {
-    return store.getObjectQuery(v.$apiName, v.$primaryKey).writeToStore(v, "loaded", batch).cacheKey;
-  });
+  invalidateObjectType = (objectType, changes) => {
+    if (this.#apiName === objectType) {
+      changes?.modified.add(this.cacheKey);
+      return this.revalidate(true);
+    }
+    return Promise.resolve();
+  };
 }
 //# sourceMappingURL=ObjectQuery.js.map

package/build/esm/observable/internal/object/ObjectQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectQuery.js","names":["deepEqual","BehaviorSubject","connectable","map","additionalContext","getBulkObjectLoader","Query","tombstone","ObjectQuery","apiName","pk","constructor","store","subject","type","cacheKey","opts","process","env","NODE_ENV","client","logger","child","msgPrefix","otherKeys","x","JSON","stringify","join","undefined","_createConnectable","pipe","status","object","value","lastUpdated","isOptimistic","connector","_fetchAndStore","methodName","debug","obj","fetch","batch","writeToStore","data","entry","read","write","ret","changes","registerObject","deleteFromStore","delete","deleteObject","invalidateObjectType","objectType","modified","add","revalidate","Promise","resolve"],"sources":["ObjectQuery.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, PrimaryKeyType } from \"@osdk/api\";\nimport deepEqual from \"fast-deep-equal\";\nimport type { Connectable, Observable, Subject } from \"rxjs\";\nimport { BehaviorSubject, connectable, map } from \"rxjs\";\nimport { additionalContext } from \"../../../Client.js\";\nimport type { ObjectHolder } from \"../../../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { ObjectPayload } from \"../../ObjectPayload.js\";\nimport type {\n  CommonObserveOptions,\n  Status,\n} from \"../../ObservableClient/common.js\";\nimport type { BatchContext } from \"../BatchContext.js\";\nimport { getBulkObjectLoader } from \"../BulkObjectLoader.js\";\nimport type { Changes } from \"../Changes.js\";\nimport type { Entry } from \"../Layer.js\";\nimport { Query } from \"../Query.js\";\nimport type { Store } from \"../Store.js\";\nimport type { SubjectPayload } from \"../SubjectPayload.js\";\nimport { tombstone } from \"../tombstone.js\";\nimport type { ObjectCacheKey } from \"./ObjectCacheKey.js\";\n\nexport class ObjectQuery extends Query<\n  ObjectCacheKey,\n  ObjectPayload,\n  CommonObserveOptions\n> {\n  #apiName: string;\n  #pk: string | number | boolean;\n\n  constructor(\n    store: Store,\n    subject: Subject<SubjectPayload<ObjectCacheKey>>,\n    type: string,\n    pk: PrimaryKeyType<ObjectTypeDefinition>,\n    cacheKey: ObjectCacheKey,\n    opts: CommonObserveOptions,\n  ) {\n    super(\n      store,\n      subject,\n      opts,\n      cacheKey,\n      process.env.NODE_ENV !== \"production\"\n        ? (\n          store.client[additionalContext].logger?.child({}, {\n            msgPrefix: `ObjectQuery<${\n              cacheKey.otherKeys.map(x => JSON.stringify(x)).join(\", \")\n            }>`,\n          })\n        )\n        : undefined,\n    );\n    this.#apiName = type;\n    this.#pk = pk;\n  }\n\n  protected _createConnectable(\n    subject: Observable<SubjectPayload<ObjectCacheKey>>,\n  ): Connectable<ObjectPayload> {\n    return connectable<ObjectPayload>(\n      subject.pipe(\n        map((x) => {\n          return {\n            status: x.status,\n            object: x.value,\n            lastUpdated: x.lastUpdated,\n            isOptimistic: x.isOptimistic,\n          };\n        }),\n      ),\n      {\n        connector: () =>\n          new BehaviorSubject<ObjectPayload>({\n            status: \"init\",\n            object: undefined,\n            lastUpdated: 0,\n            isOptimistic: false,\n          }),\n      },\n    );\n  }\n\n  async _fetchAndStore(): Promise<void> {\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.child({ methodName: \"_fetchAndStore\" }).debug(\n        \"calling _fetchAndStore\",\n      );\n    }\n\n    // TODO: In the future, implement tracking of network requests to ensure\n    // we're not making unnecessary network calls. This would need dedicated\n    // tests separate from subscription notification tests.\n\n    const obj = await getBulkObjectLoader(this.store.client)\n      .fetch(this.#apiName, this.#pk);\n\n    this.store.batch({}, (batch) => {\n      this.writeToStore(obj, \"loaded\", batch);\n    });\n  }\n\n  writeToStore(\n    data: ObjectHolder,\n    status: Status,\n    batch: BatchContext,\n  ): Entry<ObjectCacheKey> {\n    const entry = batch.read(this.cacheKey);\n\n    if (entry && deepEqual(data, entry.value)) {\n      // Check if both data AND status are the same\n      if (entry.status === status) {\n        if (process.env.NODE_ENV !== \"production\") {\n          this.logger?.child({ methodName: \"writeToStore\" }).debug(\n            `Object was deep equal and status unchanged (${status}), skipping update`,\n          );\n        }\n        // Return the existing entry without writing to avoid unnecessary notifications\n        return entry;\n      }\n\n      if (process.env.NODE_ENV !== \"production\") {\n        this.logger?.child({ methodName: \"writeToStore\" }).debug(\n          `Object was deep equal, just setting status (old status: ${entry.status}, new status: ${status})`,\n        );\n      }\n      // must do a \"full write\" here so that the lastUpdated is updated but we\n      // don't want to retrigger anyone's memoization on the value!\n      return batch.write(this.cacheKey, entry.value, status);\n    }\n\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.child({ methodName: \"writeToStore\" }).debug(\n        JSON.stringify({ status }),\n        data,\n      );\n    }\n    const ret = batch.write(this.cacheKey, data, status);\n    batch.changes.registerObject(this.cacheKey, data, /* isNew */ !entry);\n\n    return ret;\n  }\n\n  deleteFromStore(\n    status: Status,\n    batch: BatchContext,\n  ): Entry<ObjectCacheKey> | undefined {\n    const entry = batch.read(this.cacheKey);\n\n    if (entry && deepEqual(tombstone, entry.value)) {\n      if (process.env.NODE_ENV !== \"production\") {\n        this.logger?.child({ methodName: \"deleteFromStore\" }).debug(\n          `Object was deep equal, just setting status`,\n        );\n      }\n      // must do a \"full write\" here so that the lastUpdated is updated but we\n      // don't want to retrigger anyone's memoization on the value!\n      return batch.write(this.cacheKey, entry.value, status);\n    }\n\n    if (process.env.NODE_ENV !== \"production\") {\n      this.logger?.child({ methodName: \"deleteFromStore\" }).debug(\n        JSON.stringify({ status }),\n      );\n    }\n\n    // if there is no entry then there is nothing to do\n    if (!entry || !entry.value) {\n      return;\n    }\n\n    const ret = batch.delete(this.cacheKey, status);\n    batch.changes.deleteObject(this.cacheKey);\n\n    return ret;\n  }\n\n  invalidateObjectType = (\n    objectType: string,\n    changes: Changes | undefined,\n  ): Promise<void> => {\n    if (this.#apiName === objectType) {\n      changes?.modified.add(this.cacheKey);\n      return this.revalidate(true);\n    }\n    return Promise.resolve();\n  };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/observable/internal/object/ObjectsHelper.js

@@ -0,0 +1,48 @@
+/*
+ * 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 { AbstractHelper } from "../AbstractHelper.js";
+import { ObjectQuery } from "./ObjectQuery.js";
+export class ObjectsHelper extends AbstractHelper {
+  observe(options, subFn) {
+    return super.observe(options, subFn);
+  }
+  getQuery(options) {
+    const apiName = typeof options.apiName === "string" ? options.apiName : options.apiName.apiName;
+    const {
+      pk
+    } = options;
+    const objectCacheKey = this.cacheKeys.get("object", apiName, pk);
+    return this.store.queries.get(objectCacheKey, () => new ObjectQuery(this.store, this.store.subjects.get(objectCacheKey), apiName, pk, objectCacheKey, {
+      dedupeInterval: 0
+    }));
+  }
+
+  /**
+   * Internal helper method for writing objects to the store and returning their
+   * object keys
+   * @internal
+   */
+  storeOsdkInstances(values, batch) {
+    // update the cache for any object that has changed
+    // and save the mapped values to return
+    return values.map(v => this.getQuery({
+      apiName: v.$apiName,
+      pk: v.$primaryKey
+    }).writeToStore(v, "loaded", batch).cacheKey);
+  }
+}
+//# sourceMappingURL=ObjectsHelper.js.map

package/build/esm/observable/internal/object/ObjectsHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectsHelper.js","names":["AbstractHelper","ObjectQuery","ObjectsHelper","observe","options","subFn","getQuery","apiName","pk","objectCacheKey","cacheKeys","get","store","queries","subjects","dedupeInterval","storeOsdkInstances","values","batch","map","v","$apiName","$primaryKey","writeToStore","cacheKey"],"sources":["ObjectsHelper.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  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n} from \"@osdk/api\";\nimport type { ObjectHolder } from \"../../../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { ObjectPayload } from \"../../ObjectPayload.js\";\nimport type { ObserveObjectOptions } from \"../../ObservableClient.js\";\nimport type { Observer } from \"../../ObservableClient/common.js\";\nimport { AbstractHelper } from \"../AbstractHelper.js\";\nimport type { BatchContext } from \"../BatchContext.js\";\nimport type { QuerySubscription } from \"../QuerySubscription.js\";\nimport { type ObjectCacheKey } from \"./ObjectCacheKey.js\";\nimport { ObjectQuery } from \"./ObjectQuery.js\";\n\nexport class ObjectsHelper extends AbstractHelper<\n  ObjectQuery,\n  ObserveObjectOptions<any>\n> {\n  observe<T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveObjectOptions<T>,\n    subFn: Observer<ObjectPayload>,\n  ): QuerySubscription<ObjectQuery> {\n    return super.observe(options, subFn);\n  }\n\n  getQuery<T extends ObjectTypeDefinition | InterfaceDefinition>(\n    options: ObserveObjectOptions<T>,\n  ): ObjectQuery {\n    const apiName = typeof options.apiName === \"string\"\n      ? options.apiName\n      : options.apiName.apiName;\n    const { pk } = options;\n\n    const objectCacheKey = this.cacheKeys.get<ObjectCacheKey>(\n      \"object\",\n      apiName,\n      pk,\n    );\n\n    return this.store.queries.get(objectCacheKey, () =>\n      new ObjectQuery(\n        this.store,\n        this.store.subjects.get(objectCacheKey),\n        apiName,\n        pk,\n        objectCacheKey,\n        { dedupeInterval: 0 },\n      ));\n  }\n\n  /**\n   * Internal helper method for writing objects to the store and returning their\n   * object keys\n   * @internal\n   */\n  public storeOsdkInstances(\n    values: Array<ObjectHolder> | Array<Osdk.Instance<any, any, any>>,\n    batch: BatchContext,\n  ): ObjectCacheKey[] {\n    // update the cache for any object that has changed\n    // and save the mapped values to return\n    return values.map(v =>\n      this.getQuery({\n        apiName: v.$apiName,\n        pk: v.$primaryKey as string | number,\n      }).writeToStore(\n        v as ObjectHolder,\n        \"loaded\",\n        batch,\n      ).cacheKey\n    );\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA,SAASA,cAAc,QAAQ,sBAAsB;AAIrD,SAASC,WAAW,QAAQ,kBAAkB;AAE9C,OAAO,MAAMC,aAAa,SAASF,cAAc,CAG/C;EACAG,OAAOA,CACLC,OAAgC,EAChCC,KAA8B,EACE;IAChC,OAAO,KAAK,CAACF,OAAO,CAACC,OAAO,EAAEC,KAAK,CAAC;EACtC;EAEAC,QAAQA,CACNF,OAAgC,EACnB;IACb,MAAMG,OAAO,GAAG,OAAOH,OAAO,CAACG,OAAO,KAAK,QAAQ,GAC/CH,OAAO,CAACG,OAAO,GACfH,OAAO,CAACG,OAAO,CAACA,OAAO;IAC3B,MAAM;MAAEC;IAAG,CAAC,GAAGJ,OAAO;IAEtB,MAAMK,cAAc,GAAG,IAAI,CAACC,SAAS,CAACC,GAAG,CACvC,QAAQ,EACRJ,OAAO,EACPC,EACF,CAAC;IAED,OAAO,IAAI,CAACI,KAAK,CAACC,OAAO,CAACF,GAAG,CAACF,cAAc,EAAE,MAC5C,IAAIR,WAAW,CACb,IAAI,CAACW,KAAK,EACV,IAAI,CAACA,KAAK,CAACE,QAAQ,CAACH,GAAG,CAACF,cAAc,CAAC,EACvCF,OAAO,EACPC,EAAE,EACFC,cAAc,EACd;MAAEM,cAAc,EAAE;IAAE,CACtB,CAAC,CAAC;EACN;;EAEA;AACF;AACA;AACA;AACA;EACSC,kBAAkBA,CACvBC,MAAiE,EACjEC,KAAmB,EACD;IAClB;IACA;IACA,OAAOD,MAAM,CAACE,GAAG,CAACC,CAAC,IACjB,IAAI,CAACd,QAAQ,CAAC;MACZC,OAAO,EAAEa,CAAC,CAACC,QAAQ;MACnBb,EAAE,EAAEY,CAAC,CAACE;IACR,CAAC,CAAC,CAACC,YAAY,CACbH,CAAC,EACD,QAAQ,EACRF,KACF,CAAC,CAACM,QACJ,CAAC;EACH;AACF","ignoreList":[]}

package/build/esm/observable/internal/sorting/SortingStrategy.js

@@ -0,0 +1,78 @@
+/*
+ * 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.
+ */
+
+/**
+ * Strategy interface for collection sorting
+ */
+
+/**
+ * No-operation sorting strategy that preserves original order
+ */
+export class NoOpSortingStrategy {
+  sortCacheKeys(objectCacheKeys) {
+    return objectCacheKeys;
+  }
+}
+/**
+ * Sorting strategy for OrderBy clauses
+ */
+export class OrderBySortingStrategy {
+  constructor(apiName, orderBy) {
+    this.apiName = apiName;
+    this.orderBy = orderBy;
+    this.sortFns = createOrderBySortFns(orderBy);
+  }
+  sortCacheKeys(objectCacheKeys, batch) {
+    if (Object.keys(this.orderBy).length === 0) {
+      return objectCacheKeys;
+    }
+    return objectCacheKeys.sort((a, b) => {
+      for (const sortFn of this.sortFns) {
+        const ret = sortFn(batch.read(a)?.value?.$as(this.apiName), batch.read(b)?.value?.$as(this.apiName));
+        if (ret !== 0) {
+          return ret;
+        }
+      }
+      return 0;
+    });
+  }
+}
+
+/**
+ * Creates sort functions for an orderBy clause
+ * @param orderBy - The order by clause
+ * @returns Array of sort functions
+ */
+export function createOrderBySortFns(orderBy) {
+  return Object.entries(orderBy).map(([key, order]) => {
+    return (a, b) => {
+      const aValue = a?.[key];
+      const bValue = b?.[key];
+      if (aValue == null && bValue == null) {
+        return 0;
+      }
+      if (aValue == null) {
+        return 1;
+      }
+      if (bValue == null) {
+        return -1;
+      }
+      const m = order === "asc" ? -1 : 1;
+      return aValue < bValue ? m : aValue > bValue ? -m : 0;
+    };
+  });
+}
+//# sourceMappingURL=SortingStrategy.js.map

package/build/esm/observable/internal/sorting/SortingStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SortingStrategy.js","names":["NoOpSortingStrategy","sortCacheKeys","objectCacheKeys","OrderBySortingStrategy","constructor","apiName","orderBy","sortFns","createOrderBySortFns","batch","Object","keys","length","sort","a","b","sortFn","ret","read","value","$as","entries","map","key","order","aValue","bValue","m"],"sources":["SortingStrategy.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 { InterfaceHolder } from \"../../../object/convertWireToOsdkObjects/InterfaceHolder.js\";\nimport type { ObjectHolder } from \"../../../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { BatchContext } from \"../BatchContext.js\";\nimport type { Canonical } from \"../Canonical.js\";\nimport type { ObjectCacheKey } from \"../object/ObjectCacheKey.js\";\n\n/**\n * Strategy interface for collection sorting\n */\nexport interface SortingStrategy {\n  /**\n   * Sort an array of object cache keys\n   * @param objectCacheKeys - Keys to sort\n   * @param batch - Batch context for reading objects\n   * @returns Sorted array of keys\n   */\n  sortCacheKeys(\n    objectCacheKeys: ObjectCacheKey[],\n    batch: BatchContext,\n  ): ObjectCacheKey[];\n}\n\n/**\n * No-operation sorting strategy that preserves original order\n */\nexport class NoOpSortingStrategy implements SortingStrategy {\n  sortCacheKeys(\n    objectCacheKeys: ObjectCacheKey[],\n    _batch: BatchContext,\n  ): ObjectCacheKey[] {\n    return objectCacheKeys;\n  }\n}\n\ntype ObjectInterfaceComparer = (\n  a: ObjectHolder | InterfaceHolder | undefined,\n  b: ObjectHolder | InterfaceHolder | undefined,\n) => number;\n\n/**\n * Sorting strategy for OrderBy clauses\n */\nexport class OrderBySortingStrategy implements SortingStrategy {\n  private readonly sortFns: Array<ObjectInterfaceComparer>;\n\n  constructor(\n    private readonly apiName: string,\n    private readonly orderBy: Canonical<\n      Record<string, \"asc\" | \"desc\" | undefined>\n    >,\n  ) {\n    this.sortFns = createOrderBySortFns(orderBy);\n  }\n\n  sortCacheKeys(\n    objectCacheKeys: ObjectCacheKey[],\n    batch: BatchContext,\n  ): ObjectCacheKey[] {\n    if (Object.keys(this.orderBy).length === 0) {\n      return objectCacheKeys;\n    }\n\n    return objectCacheKeys.sort((a, b) => {\n      for (const sortFn of this.sortFns) {\n        const ret = sortFn(\n          batch.read(a)?.value?.$as(this.apiName),\n          batch.read(b)?.value?.$as(this.apiName),\n        );\n        if (ret !== 0) {\n          return ret;\n        }\n      }\n      return 0;\n    });\n  }\n}\n\n/**\n * Creates sort functions for an orderBy clause\n * @param orderBy - The order by clause\n * @returns Array of sort functions\n */\nexport function createOrderBySortFns(\n  orderBy: Canonical<Record<string, \"asc\" | \"desc\" | undefined>>,\n): ObjectInterfaceComparer[] {\n  return Object.entries(orderBy).map(([key, order]) => {\n    return (\n      a: ObjectHolder | InterfaceHolder | undefined,\n      b: ObjectHolder | InterfaceHolder | undefined,\n    ): number => {\n      const aValue = a?.[key];\n      const bValue = b?.[key];\n\n      if (aValue == null && bValue == null) {\n        return 0;\n      }\n      if (aValue == null) {\n        return 1;\n      }\n      if (bValue == null) {\n        return -1;\n      }\n      const m = order === \"asc\" ? -1 : 1;\n      return aValue < bValue ? m : aValue > bValue ? -m : 0;\n    };\n  });\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;;AAcA;AACA;AACA;AACA,OAAO,MAAMA,mBAAmB,CAA4B;EAC1DC,aAAaA,CACXC,eAAiC,EAEf;IAClB,OAAOA,eAAe;EACxB;AACF;AAOA;AACA;AACA;AACA,OAAO,MAAMC,sBAAsB,CAA4B;EAG7DC,WAAWA,CACQC,OAAe,EACfC,OAEhB,EACD;IAAA,KAJiBD,OAAe,GAAfA,OAAe;IAAA,KACfC,OAEhB,GAFgBA,OAEhB;IAED,IAAI,CAACC,OAAO,GAAGC,oBAAoB,CAACF,OAAO,CAAC;EAC9C;EAEAL,aAAaA,CACXC,eAAiC,EACjCO,KAAmB,EACD;IAClB,IAAIC,MAAM,CAACC,IAAI,CAAC,IAAI,CAACL,OAAO,CAAC,CAACM,MAAM,KAAK,CAAC,EAAE;MAC1C,OAAOV,eAAe;IACxB;IAEA,OAAOA,eAAe,CAACW,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAK;MACpC,KAAK,MAAMC,MAAM,IAAI,IAAI,CAACT,OAAO,EAAE;QACjC,MAAMU,GAAG,GAAGD,MAAM,CAChBP,KAAK,CAACS,IAAI,CAACJ,CAAC,CAAC,EAAEK,KAAK,EAAEC,GAAG,CAAC,IAAI,CAACf,OAAO,CAAC,EACvCI,KAAK,CAACS,IAAI,CAACH,CAAC,CAAC,EAAEI,KAAK,EAAEC,GAAG,CAAC,IAAI,CAACf,OAAO,CACxC,CAAC;QACD,IAAIY,GAAG,KAAK,CAAC,EAAE;UACb,OAAOA,GAAG;QACZ;MACF;MACA,OAAO,CAAC;IACV,CAAC,CAAC;EACJ;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAAST,oBAAoBA,CAClCF,OAA8D,EACnC;EAC3B,OAAOI,MAAM,CAACW,OAAO,CAACf,OAAO,CAAC,CAACgB,GAAG,CAAC,CAAC,CAACC,GAAG,EAAEC,KAAK,CAAC,KAAK;IACnD,OAAO,CACLV,CAA6C,EAC7CC,CAA6C,KAClC;MACX,MAAMU,MAAM,GAAGX,CAAC,GAAGS,GAAG,CAAC;MACvB,MAAMG,MAAM,GAAGX,CAAC,GAAGQ,GAAG,CAAC;MAEvB,IAAIE,MAAM,IAAI,IAAI,IAAIC,MAAM,IAAI,IAAI,EAAE;QACpC,OAAO,CAAC;MACV;MACA,IAAID,MAAM,IAAI,IAAI,EAAE;QAClB,OAAO,CAAC;MACV;MACA,IAAIC,MAAM,IAAI,IAAI,EAAE;QAClB,OAAO,CAAC,CAAC;MACX;MACA,MAAMC,CAAC,GAAGH,KAAK,KAAK,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;MAClC,OAAOC,MAAM,GAAGC,MAAM,GAAGC,CAAC,GAAGF,MAAM,GAAGC,MAAM,GAAG,CAACC,CAAC,GAAG,CAAC;IACvD,CAAC;EACH,CAAC,CAAC;AACJ","ignoreList":[]}

package/build/esm/observable/internal/testUtils/invalidateList.js

@@ -0,0 +1,23 @@
+/*
+ * 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 async function invalidateList(store, args) {
+  const where = store.whereCanonicalizer.canonicalize(args.where ?? {});
+  const orderBy = store.orderByCanonicalizer.canonicalize(args.orderBy ?? {});
+  const cacheKey = store.cacheKeys.get("list", args.type.type, args.type.apiName, where, orderBy);
+  await store.queries.peek(cacheKey)?.revalidate(true);
+}
+//# sourceMappingURL=invalidateList.js.map

package/build/esm/observable/internal/testUtils/invalidateList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidateList.js","names":["invalidateList","store","args","where","whereCanonicalizer","canonicalize","orderBy","orderByCanonicalizer","cacheKey","cacheKeys","get","type","apiName","queries","peek","revalidate"],"sources":["invalidateList.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, WhereClause } from \"@osdk/api\";\nimport type { OrderBy } from \"../../ObservableClient.js\";\nimport type { Canonical } from \"../Canonical.js\";\nimport type { ListCacheKey } from \"../list/ListCacheKey.js\";\nimport type { SimpleWhereClause } from \"../SimpleWhereClause.js\";\nimport type { Store } from \"../Store.js\";\n\nexport async function invalidateList<T extends ObjectTypeDefinition>(\n  store: Store,\n  args: {\n    type: Pick<T, \"apiName\" | \"type\">;\n    where?: WhereClause<T> | SimpleWhereClause;\n    orderBy?: OrderBy<T>;\n  },\n): Promise<void> {\n  const where = store.whereCanonicalizer.canonicalize(args.where ?? {});\n  const orderBy = store.orderByCanonicalizer.canonicalize(args.orderBy ?? {});\n\n  const cacheKey = store.cacheKeys.get<ListCacheKey>(\n    \"list\",\n    args.type.type,\n    args.type.apiName,\n    where,\n    orderBy as Canonical<OrderBy<T>>,\n  );\n\n  await store.queries.peek(cacheKey)?.revalidate(true);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,OAAO,eAAeA,cAAcA,CAClCC,KAAY,EACZC,IAIC,EACc;EACf,MAAMC,KAAK,GAAGF,KAAK,CAACG,kBAAkB,CAACC,YAAY,CAACH,IAAI,CAACC,KAAK,IAAI,CAAC,CAAC,CAAC;EACrE,MAAMG,OAAO,GAAGL,KAAK,CAACM,oBAAoB,CAACF,YAAY,CAACH,IAAI,CAACI,OAAO,IAAI,CAAC,CAAC,CAAC;EAE3E,MAAME,QAAQ,GAAGP,KAAK,CAACQ,SAAS,CAACC,GAAG,CAClC,MAAM,EACNR,IAAI,CAACS,IAAI,CAACA,IAAI,EACdT,IAAI,CAACS,IAAI,CAACC,OAAO,EACjBT,KAAK,EACLG,OACF,CAAC;EAED,MAAML,KAAK,CAACY,OAAO,CAACC,IAAI,CAACN,QAAQ,CAAC,EAAEO,UAAU,CAAC,IAAI,CAAC;AACtD","ignoreList":[]}

package/build/esm/observable/internal/testUtils/observeLink/expectStandardObserveLink.js

@@ -0,0 +1,69 @@
+/*
+ * 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 { createDefer, expectSingleLinkCallAndClear, mockLinkSubCallback, waitForCall } from "../../testUtils.js";
+const defer = createDefer();
+
+/**
+ * Utility function for testing link observation behavior between objects
+ *
+ * This function provides the following guarantees:
+ * - Sets up a link subscription using the Store's observeLinks method
+ * - Validates that an initial "loading" state is emitted with empty results
+ * - Waits for the link data to be fetched and emitted
+ * - Validates the "loaded" state contains the expected linked objects
+ * - Returns both the link payload and mock subscription function for further assertions
+ *
+ * This helper creates a standardized test flow for link observations that:
+ * 1. Creates a subscription to observe links from source to target objects
+ * 2. Verifies the initial loading state is emitted with empty results
+ * 3. Waits for the data loading to complete
+ * 4. Verifies the loaded state with the expected linked objects
+ * 5. Provides the result objects for additional assertions in tests
+ *
+ * @typeParam S - The source object type definition
+ * @typeParam T - The target object type definition
+ */
+export async function expectStandardObserveLink({
+  store,
+  srcObject,
+  srcLinkName,
+  targetType,
+  expected
+}) {
+  const linkSubFn = mockLinkSubCallback();
+  defer(store.links.observe({
+    linkName: srcLinkName,
+    srcType: {
+      type: "object",
+      apiName: srcObject.$apiName
+    },
+    pk: srcObject.$primaryKey
+  }, linkSubFn));
+  await waitForCall(linkSubFn);
+  expectSingleLinkCallAndClear(linkSubFn, [], {
+    status: "loading"
+  });
+  await waitForCall(linkSubFn);
+  const payload = expectSingleLinkCallAndClear(linkSubFn, expected, {
+    status: "loaded"
+  });
+  return {
+    payload,
+    linkSubFn
+  };
+}
+//# sourceMappingURL=expectStandardObserveLink.js.map

package/build/esm/observable/internal/testUtils/observeLink/expectStandardObserveLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expectStandardObserveLink.js","names":["createDefer","expectSingleLinkCallAndClear","mockLinkSubCallback","waitForCall","defer","expectStandardObserveLink","store","srcObject","srcLinkName","targetType","expected","linkSubFn","links","observe","linkName","srcType","type","apiName","$apiName","pk","$primaryKey","status","payload"],"sources":["expectStandardObserveLink.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, Osdk } from \"@osdk/api\";\nimport type { Observer } from \"type-fest\";\nimport type { MockedObject } from \"vitest\";\nimport type { ObjectHolder } from \"../../../../object/convertWireToOsdkObjects/ObjectHolder.js\";\nimport type { SpecificLinkPayload } from \"../../../LinkPayload.js\";\nimport type { Store } from \"../../Store.js\";\nimport {\n  createDefer,\n  expectSingleLinkCallAndClear,\n  mockLinkSubCallback,\n  waitForCall,\n} from \"../../testUtils.js\";\n\nconst defer = createDefer();\n\n/**\n * Utility function for testing link observation behavior between objects\n *\n * This function provides the following guarantees:\n * - Sets up a link subscription using the Store's observeLinks method\n * - Validates that an initial \"loading\" state is emitted with empty results\n * - Waits for the link data to be fetched and emitted\n * - Validates the \"loaded\" state contains the expected linked objects\n * - Returns both the link payload and mock subscription function for further assertions\n *\n * This helper creates a standardized test flow for link observations that:\n * 1. Creates a subscription to observe links from source to target objects\n * 2. Verifies the initial loading state is emitted with empty results\n * 3. Waits for the data loading to complete\n * 4. Verifies the loaded state with the expected linked objects\n * 5. Provides the result objects for additional assertions in tests\n *\n * @typeParam S - The source object type definition\n * @typeParam T - The target object type definition\n */\nexport async function expectStandardObserveLink<\n  S extends ObjectTypeDefinition,\n  T extends ObjectTypeDefinition,\n>(\n  {\n    store,\n    srcObject,\n    srcLinkName,\n    targetType,\n    expected,\n  }: {\n    /** The Store instance to use for observation */\n    store: Store;\n    /** The source object that contains the link */\n    srcObject: Osdk.Instance<S>;\n    /** The name of the link field to observe */\n    srcLinkName: string;\n    /** The type definition of the linked objects */\n    targetType: T;\n    /** The expected linked objects that should be returned */\n    expected: ObjectHolder<Osdk.Instance<T>>[];\n  },\n): Promise<{\n  /** The link payload containing the linked objects and metadata */\n  payload: SpecificLinkPayload | undefined;\n  /** The mocked subscription callback for further testing assertions */\n  linkSubFn: MockedObject<\n    Observer<\n      SpecificLinkPayload | undefined\n    >\n  >;\n}> {\n  const linkSubFn = mockLinkSubCallback();\n  defer(\n    store.links.observe({\n      linkName: srcLinkName,\n      srcType: { type: \"object\", apiName: srcObject.$apiName },\n      pk: srcObject.$primaryKey,\n    }, linkSubFn),\n  );\n\n  await waitForCall(linkSubFn);\n  expectSingleLinkCallAndClear(linkSubFn, [], { status: \"loading\" });\n\n  await waitForCall(linkSubFn);\n\n  const payload = expectSingleLinkCallAndClear(linkSubFn, expected, {\n    status: \"loaded\",\n  });\n\n  return { payload, linkSubFn };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,SACEA,WAAW,EACXC,4BAA4B,EAC5BC,mBAAmB,EACnBC,WAAW,QACN,oBAAoB;AAE3B,MAAMC,KAAK,GAAGJ,WAAW,CAAC,CAAC;;AAE3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeK,yBAAyBA,CAI7C;EACEC,KAAK;EACLC,SAAS;EACTC,WAAW;EACXC,UAAU;EACVC;AAYF,CAAC,EAUA;EACD,MAAMC,SAAS,GAAGT,mBAAmB,CAAC,CAAC;EACvCE,KAAK,CACHE,KAAK,CAACM,KAAK,CAACC,OAAO,CAAC;IAClBC,QAAQ,EAAEN,WAAW;IACrBO,OAAO,EAAE;MAAEC,IAAI,EAAE,QAAQ;MAAEC,OAAO,EAAEV,SAAS,CAACW;IAAS,CAAC;IACxDC,EAAE,EAAEZ,SAAS,CAACa;EAChB,CAAC,EAAET,SAAS,CACd,CAAC;EAED,MAAMR,WAAW,CAACQ,SAAS,CAAC;EAC5BV,4BAA4B,CAACU,SAAS,EAAE,EAAE,EAAE;IAAEU,MAAM,EAAE;EAAU,CAAC,CAAC;EAElE,MAAMlB,WAAW,CAACQ,SAAS,CAAC;EAE5B,MAAMW,OAAO,GAAGrB,4BAA4B,CAACU,SAAS,EAAED,QAAQ,EAAE;IAChEW,MAAM,EAAE;EACV,CAAC,CAAC;EAEF,OAAO;IAAEC,OAAO;IAAEX;EAAU,CAAC;AAC/B","ignoreList":[]}

package/build/esm/observable/internal/testUtils/observeObject/expectStandardObserveObject.js

@@ -0,0 +1,56 @@
+/*
+ * 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 { expect } from "vitest";
+import { createDefer, expectSingleObjectCallAndClear, mockSingleSubCallback, waitForCall } from "../../testUtils.js";
+const defer = createDefer();
+
+/**
+ * Utility function for testing object observation behavior
+ *
+ * This function provides the following guarantees:
+ * - Validates the initial "loading" state is emitted
+ * - Waits for the subscription callback to be called again
+ * - Validates the "loaded" state with the expected object containing apiName and primaryKey
+ * - Returns both the observed object and mock subscription function for further assertions
+ *
+ * @param cache - The Store instance to use for observation
+ * @param apiName - The API name for the object to observe
+ * @param primaryKey - The primary key of the object to observe
+ * @returns A promise that resolves to the observed object and the mocked subscription callback
+ */
+export async function expectStandardObserveObject({
+  cache,
+  type,
+  primaryKey
+}) {
+  const subFn = mockSingleSubCallback();
+  defer(cache.objects.observe({
+    apiName: type,
+    pk: primaryKey
+  }, subFn));
+  expectSingleObjectCallAndClear(subFn, undefined, "loading");
+  await waitForCall(subFn);
+  const obj = expectSingleObjectCallAndClear(subFn, expect.objectContaining({
+    $apiName: type.apiName,
+    $primaryKey: primaryKey
+  }), "loaded");
+  return {
+    payload: obj,
+    subFn
+  };
+}
+//# sourceMappingURL=expectStandardObserveObject.js.map

package/build/esm/observable/internal/testUtils/observeObject/expectStandardObserveObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expectStandardObserveObject.js","names":["expect","createDefer","expectSingleObjectCallAndClear","mockSingleSubCallback","waitForCall","defer","expectStandardObserveObject","cache","type","primaryKey","subFn","objects","observe","apiName","pk","undefined","obj","objectContaining","$apiName","$primaryKey","payload"],"sources":["expectStandardObserveObject.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, PrimaryKeyType } from \"@osdk/api\";\nimport { expect } from \"vitest\";\nimport type { TypedObjectPayload } from \"../../../ObjectPayload.js\";\nimport type { Store } from \"../../Store.js\";\nimport type { MockedSingleSubCallback } from \"../../testUtils.js\";\nimport {\n  createDefer,\n  expectSingleObjectCallAndClear,\n  mockSingleSubCallback,\n  waitForCall,\n} from \"../../testUtils.js\";\n\nconst defer = createDefer();\n\n/**\n * Utility function for testing object observation behavior\n *\n * This function provides the following guarantees:\n * - Validates the initial \"loading\" state is emitted\n * - Waits for the subscription callback to be called again\n * - Validates the \"loaded\" state with the expected object containing apiName and primaryKey\n * - Returns both the observed object and mock subscription function for further assertions\n *\n * @param cache - The Store instance to use for observation\n * @param apiName - The API name for the object to observe\n * @param primaryKey - The primary key of the object to observe\n * @returns A promise that resolves to the observed object and the mocked subscription callback\n */\nexport async function expectStandardObserveObject<\n  T extends ObjectTypeDefinition,\n>(\n  { cache, type, primaryKey }: {\n    cache: Store;\n    type: T;\n    primaryKey: PrimaryKeyType<T>;\n  },\n): Promise<{\n  payload: TypedObjectPayload<T>;\n  subFn: MockedSingleSubCallback;\n}> {\n  const subFn = mockSingleSubCallback();\n  defer(\n    cache.objects.observe({\n      apiName: type,\n      pk: primaryKey,\n    }, subFn),\n  );\n\n  expectSingleObjectCallAndClear(\n    subFn,\n    undefined,\n    \"loading\",\n  );\n\n  await waitForCall(subFn);\n\n  const obj = expectSingleObjectCallAndClear(\n    subFn,\n    expect.objectContaining({\n      $apiName: type.apiName,\n      $primaryKey: primaryKey,\n    }),\n    \"loaded\",\n  );\n  return { payload: obj as TypedObjectPayload<T>, subFn };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,MAAM,QAAQ,QAAQ;AAI/B,SACEC,WAAW,EACXC,8BAA8B,EAC9BC,qBAAqB,EACrBC,WAAW,QACN,oBAAoB;AAE3B,MAAMC,KAAK,GAAGJ,WAAW,CAAC,CAAC;;AAE3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeK,2BAA2BA,CAG/C;EAAEC,KAAK;EAAEC,IAAI;EAAEC;AAIf,CAAC,EAIA;EACD,MAAMC,KAAK,GAAGP,qBAAqB,CAAC,CAAC;EACrCE,KAAK,CACHE,KAAK,CAACI,OAAO,CAACC,OAAO,CAAC;IACpBC,OAAO,EAAEL,IAAI;IACbM,EAAE,EAAEL;EACN,CAAC,EAAEC,KAAK,CACV,CAAC;EAEDR,8BAA8B,CAC5BQ,KAAK,EACLK,SAAS,EACT,SACF,CAAC;EAED,MAAMX,WAAW,CAACM,KAAK,CAAC;EAExB,MAAMM,GAAG,GAAGd,8BAA8B,CACxCQ,KAAK,EACLV,MAAM,CAACiB,gBAAgB,CAAC;IACtBC,QAAQ,EAAEV,IAAI,CAACK,OAAO;IACtBM,WAAW,EAAEV;EACf,CAAC,CAAC,EACF,QACF,CAAC;EACD,OAAO;IAAEW,OAAO,EAAEJ,GAA4B;IAAEN;EAAM,CAAC;AACzD","ignoreList":[]}

package/build/esm/observable/internal/testUtils.js

@@ -15,22 +15,25 @@
  */
 
 import { Chalk } from "chalk";
+import { inspect } from "node:util";
 import pDefer from "p-defer";
 import invariant from "tiny-invariant";
 import { afterEach, beforeEach, expect, vi, vitest } from "vitest";
 import { additionalContext } from "../../Client.js";
-import { storeOsdkInstances } from "./ObjectQuery.js";
 const chalk = new Chalk(); // new Chalk({ level: 3 });
 
 function mockLog(...args) {
   // eslint-disable-next-line no-console
   console.log(chalk.yellow("mockClient"), ...args);
 }
-// interface Logger.LogFn {
-//   (obj: unknown, msg?: string, ...args: any[]): void;
-//   (msg: string, ...args: any[]): void;
-// }
 
+/**
+ * Testing utilities for ObservableClient implementation.
+ * - Mock creation helpers for client, observers, and callbacks
+ * - Expectation utilities for validating payloads
+ * - Tools for managing test lifecycle and cleanup
+ * - Creates a colorized logger for test environments
+ */
 export function createTestLogger(bindings, options) {
   const colors = {
     debug: [chalk.cyan, chalk.bgCyan],
@@ -71,6 +74,10 @@ export function createTestLogger(bindings, options) {
     isLevelEnabled: vi.fn(() => true)
   };
 }
+
+/**
+ * Creates mocked client helpers with deferred promise control
+ */
 export function createClientMockHelper() {
   const client = vitest.fn();
   const logger = createTestLogger({});
@@ -183,6 +190,10 @@ export function createClientMockHelper() {
     }
   };
 }
+
+/**
+ * Manages test subscriptions with automatic cleanup
+ */
 export function createDefer() {
   let subscriptions;
   beforeEach(() => {
@@ -199,6 +210,18 @@ export function createDefer() {
     return x;
   };
 }
+export function expectSingleLinkCallAndClear(subFn, resolvedList, payloadOptions = {}) {
+  if (vitest.isFakeTimers()) {
+    vitest.runOnlyPendingTimers();
+  }
+  expect(subFn.next).toHaveBeenCalledExactlyOnceWith(linkPayloadContaining({
+    ...payloadOptions,
+    resolvedList: resolvedList
+  }));
+  const ret = subFn.next.mock.calls[0][0];
+  subFn.next.mockClear();
+  return ret;
+}
 export function expectSingleListCallAndClear(subFn, resolvedList, payloadOptions = {}) {
   if (vitest.isFakeTimers()) {
     vitest.runOnlyPendingTimers();
@@ -209,12 +232,18 @@ export function expectSingleListCallAndClear(subFn, resolvedList, payloadOptions
   }));
   subFn.next.mockClear();
 }
+
+/**
+ * Validates object payload emissions in tests
+ */
 export function expectSingleObjectCallAndClear(subFn, object, status) {
   expect(subFn.next).toHaveBeenCalledExactlyOnceWith(expect.objectContaining({
     object,
     status: status ?? expect.any(String)
   }));
+  const ret = subFn.next.mock.calls[0][0];
   subFn.next.mockClear();
+  return ret;
 }
 export async function waitForCall(subFn, times = 1) {
   if ("next" in subFn && "error" in subFn && "complete" in subFn) {
@@ -223,8 +252,16 @@ export async function waitForCall(subFn, times = 1) {
   try {
     await vi.waitFor(() => {
       expect(subFn).toHaveBeenCalledTimes(times);
+    }, {
+      interval: 0
     });
   } catch (e) {
+    // eslint-disable-next-line no-console
+    console.log(`We are going to fail waiting for ${times} calls because these are our calls: `, inspect(subFn.mock.calls, {
+      depth: 9,
+      colors: true,
+      compact: 2
+    }));
     // we don't need the error, it will retrigger on the next line
     // and that provides better behavior in the vitest vscode
     // plugin. This places the error in the test itself instead of
@@ -286,9 +323,16 @@ export function mockObserver() {
     complete: vitest.fn()
   };
 }
+
+// todo: find uses of this and replace with direct call to mockObserver<ListPayload | undefined>
 export function mockListSubCallback() {
   return mockObserver();
 }
+
+// todo: find uses of this and replace with direct call to mockObserver<SpecificLinkPayload | undefined>
+export function mockLinkSubCallback() {
+  return mockObserver();
+}
 export function cacheEntryContaining(x) {
   return {
     cacheKey: x.cacheKey ?? expect.any(Object),
@@ -318,6 +362,16 @@ export function listPayloadContaining(x) {
     lastUpdated: x.lastUpdated ?? expect.anything()
   };
 }
+export function linkPayloadContaining(x) {
+  return {
+    fetchMore: x.fetchMore ?? expect.any(Function),
+    hasMore: x.hasMore ?? expect.any(Boolean),
+    resolvedList: x.resolvedList ?? expect.anything(),
+    isOptimistic: expect.any(Boolean),
+    status: x.status ?? expect.anything(),
+    lastUpdated: x.lastUpdated ?? expect.anything()
+  };
+}
 export function applyCustomMatchers() {
   expect.extend({
     toBeGreaterThan: (r, e) => {
@@ -356,21 +410,29 @@ export function updateList(store, {
       optimisticId
     });
   }
-  const query = store.getListQuery(type, where ?? {}, orderBy ?? {}, opts);
+  const query = store.lists.getQuery({
+    ...opts,
+    type,
+    where: where ?? {},
+    orderBy: orderBy ?? {}
+  });
   store.batch({
     optimisticId
   }, batch => {
-    const objectCacheKeys = storeOsdkInstances(store, objects, batch);
-    query._updateList(objectCacheKeys, false, "loaded", batch);
+    const objectCacheKeys = store.objects.storeOsdkInstances(objects, batch);
+    query._updateList(objectCacheKeys, "loaded", batch, false);
   });
 }
 export function getObject(store, type, pk) {
-  return store.getValue(store.getCacheKey("object", type, pk))?.value;
+  return store.getValue(store.cacheKeys.get("object", type, pk))?.value;
 }
 export function updateObject(store, value, {
   optimisticId
 } = {}) {
-  const query = store.getObjectQuery(value.$apiName, value.$primaryKey);
+  const query = store.objects.getQuery({
+    apiName: value.$apiName,
+    pk: value.$primaryKey
+  });
   store.batch({
     optimisticId
   }, batch => {