@osdk/client 2.5.0-beta.10 → 2.5.0-beta.11

package/build/esm/observable/internal/objectset/ObjectSetHelper.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 { getWireObjectSet } from "../../../objectSet/createObjectSet.js";
+import { AbstractHelper } from "../AbstractHelper.js";
+import { ObjectSetQuery } from "./ObjectSetQuery.js";
+export class ObjectSetHelper extends AbstractHelper {
+  constructor(store, cacheKeys, whereCanonicalizer, orderByCanonicalizer) {
+    super(store, cacheKeys);
+    this.whereCanonicalizer = whereCanonicalizer;
+    this.orderByCanonicalizer = orderByCanonicalizer;
+  }
+  observe(options, subFn) {
+    return super.observe(options, subFn);
+  }
+  getQuery(options) {
+    const {
+      baseObjectSet
+    } = options;
+    const baseObjectSetWire = JSON.stringify(getWireObjectSet(baseObjectSet));
+    const operations = this.buildCanonicalizedOperations(options);
+    const objectSetCacheKey = this.cacheKeys.get("objectSet", baseObjectSetWire, operations);
+    return this.store.queries.get(objectSetCacheKey, () => {
+      return new ObjectSetQuery(this.store, this.store.subjects.get(objectSetCacheKey), baseObjectSetWire, operations, objectSetCacheKey, options);
+    });
+  }
+  buildCanonicalizedOperations(options) {
+    const operations = {};
+    if (options.where) {
+      operations.where = this.whereCanonicalizer.canonicalize(options.where);
+    }
+    if (options.withProperties) {
+      operations.withProperties = Object.keys(options.withProperties).sort();
+    }
+    if (options.union && options.union.length > 0) {
+      operations.union = options.union.map(os => JSON.stringify(getWireObjectSet(os)));
+    }
+    if (options.intersect && options.intersect.length > 0) {
+      operations.intersect = options.intersect.map(os => JSON.stringify(getWireObjectSet(os)));
+    }
+    if (options.subtract && options.subtract.length > 0) {
+      operations.subtract = options.subtract.map(os => JSON.stringify(getWireObjectSet(os)));
+    }
+    if (options.pivotTo) {
+      operations.pivotTo = options.pivotTo;
+    }
+    if (options.orderBy) {
+      operations.orderBy = this.orderByCanonicalizer.canonicalize(options.orderBy);
+    }
+    if (options.pageSize) {
+      operations.pageSize = options.pageSize;
+    }
+    return operations;
+  }
+}
+//# sourceMappingURL=ObjectSetHelper.js.map

package/build/esm/observable/internal/objectset/ObjectSetHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectSetHelper.js","names":["getWireObjectSet","AbstractHelper","ObjectSetQuery","ObjectSetHelper","constructor","store","cacheKeys","whereCanonicalizer","orderByCanonicalizer","observe","options","subFn","getQuery","baseObjectSet","baseObjectSetWire","JSON","stringify","operations","buildCanonicalizedOperations","objectSetCacheKey","get","queries","subjects","where","canonicalize","withProperties","Object","keys","sort","union","length","map","os","intersect","subtract","pivotTo","orderBy","pageSize"],"sources":["ObjectSetHelper.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 { getWireObjectSet } from \"../../../objectSet/createObjectSet.js\";\nimport type { ObjectSetPayload } from \"../../ObjectSetPayload.js\";\nimport type { Observer } from \"../../ObservableClient/common.js\";\nimport { AbstractHelper } from \"../AbstractHelper.js\";\nimport type { CacheKeys } from \"../CacheKeys.js\";\nimport type { Canonical } from \"../Canonical.js\";\nimport type { KnownCacheKey } from \"../KnownCacheKey.js\";\nimport type { OrderByCanonicalizer } from \"../OrderByCanonicalizer.js\";\nimport type { QuerySubscription } from \"../QuerySubscription.js\";\nimport type { Store } from \"../Store.js\";\nimport type { WhereClauseCanonicalizer } from \"../WhereClauseCanonicalizer.js\";\nimport type {\n  ObjectSetCacheKey,\n  ObjectSetOperations,\n} from \"./ObjectSetCacheKey.js\";\nimport { ObjectSetQuery } from \"./ObjectSetQuery.js\";\nimport type { ObjectSetQueryOptions } from \"./ObjectSetQueryOptions.js\";\n\nexport class ObjectSetHelper extends AbstractHelper<\n  ObjectSetQuery,\n  ObjectSetQueryOptions\n> {\n  whereCanonicalizer: WhereClauseCanonicalizer;\n  orderByCanonicalizer: OrderByCanonicalizer;\n\n  constructor(\n    store: Store,\n    cacheKeys: CacheKeys<KnownCacheKey>,\n    whereCanonicalizer: WhereClauseCanonicalizer,\n    orderByCanonicalizer: OrderByCanonicalizer,\n  ) {\n    super(store, cacheKeys);\n\n    this.whereCanonicalizer = whereCanonicalizer;\n    this.orderByCanonicalizer = orderByCanonicalizer;\n  }\n\n  observe(\n    options: ObjectSetQueryOptions,\n    subFn: Observer<ObjectSetPayload>,\n  ): QuerySubscription<ObjectSetQuery> {\n    return super.observe(options, subFn);\n  }\n\n  getQuery(options: ObjectSetQueryOptions): ObjectSetQuery {\n    const { baseObjectSet } = options;\n    const baseObjectSetWire = JSON.stringify(getWireObjectSet(baseObjectSet));\n    const operations = this.buildCanonicalizedOperations(options);\n\n    const objectSetCacheKey = this.cacheKeys.get<ObjectSetCacheKey>(\n      \"objectSet\",\n      baseObjectSetWire,\n      operations,\n    );\n\n    return this.store.queries.get(objectSetCacheKey, () => {\n      return new ObjectSetQuery(\n        this.store,\n        this.store.subjects.get(objectSetCacheKey),\n        baseObjectSetWire,\n        operations,\n        objectSetCacheKey,\n        options,\n      );\n    });\n  }\n\n  private buildCanonicalizedOperations(\n    options: ObjectSetQueryOptions,\n  ): Canonical<ObjectSetOperations> {\n    const operations: ObjectSetOperations = {};\n\n    if (options.where) {\n      operations.where = this.whereCanonicalizer.canonicalize(options.where);\n    }\n\n    if (options.withProperties) {\n      operations.withProperties = Object.keys(options.withProperties).sort();\n    }\n\n    if (options.union && options.union.length > 0) {\n      operations.union = options.union.map(os =>\n        JSON.stringify(getWireObjectSet(os))\n      );\n    }\n\n    if (options.intersect && options.intersect.length > 0) {\n      operations.intersect = options.intersect.map(os =>\n        JSON.stringify(getWireObjectSet(os))\n      );\n    }\n\n    if (options.subtract && options.subtract.length > 0) {\n      operations.subtract = options.subtract.map(os =>\n        JSON.stringify(getWireObjectSet(os))\n      );\n    }\n\n    if (options.pivotTo) {\n      operations.pivotTo = options.pivotTo as string;\n    }\n\n    if (options.orderBy) {\n      operations.orderBy = this.orderByCanonicalizer.canonicalize(\n        options.orderBy,\n      );\n    }\n\n    if (options.pageSize) {\n      operations.pageSize = options.pageSize;\n    }\n\n    return operations as Canonical<ObjectSetOperations>;\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/observable/internal/objectset/ObjectSetQuery.js

@@ -0,0 +1,151 @@
+/*
+ * 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 { additionalContext } from "../../../Client.js";
+import { getWireObjectSet } from "../../../objectSet/createObjectSet.js";
+import { BaseListQuery } from "../base-list/BaseListQuery.js";
+import { OrderBySortingStrategy } from "../sorting/SortingStrategy.js";
+export class ObjectSetQuery extends BaseListQuery {
+  #baseObjectSetWire;
+  #operations;
+  #composedObjectSet;
+  #objectTypes;
+  constructor(store, subject, baseObjectSetWire, operations, cacheKey, opts) {
+    super(store, subject, opts, cacheKey, process.env.NODE_ENV !== "production" ? store.client[additionalContext].logger?.child({}, {
+      msgPrefix: `ObjectSetQuery<${cacheKey.otherKeys.map(x => JSON.stringify(x)).join(", ")}>`
+    }) : undefined);
+    this.#baseObjectSetWire = baseObjectSetWire;
+    this.#operations = operations;
+    this.#composedObjectSet = this.#composeObjectSet(opts);
+    this.#objectTypes = this.#extractObjectTypes(opts);
+    if (operations.orderBy && Object.keys(operations.orderBy).length > 0) {
+      const firstType = Array.from(this.#objectTypes)[0];
+      this.sortingStrategy = new OrderBySortingStrategy(firstType, operations.orderBy);
+    }
+    this.minResultsToLoad = opts.pageSize || 0;
+  }
+  #composeObjectSet(opts) {
+    let result = opts.baseObjectSet;
+    if (opts.withProperties) {
+      result = result.withProperties(opts.withProperties);
+    }
+    if (opts.where) {
+      result = result.where(opts.where);
+    }
+    if (opts.union && opts.union.length > 0) {
+      result = result.union(...opts.union);
+    }
+    if (opts.intersect && opts.intersect.length > 0) {
+      result = result.intersect(...opts.intersect);
+    }
+    if (opts.subtract && opts.subtract.length > 0) {
+      result = result.subtract(...opts.subtract);
+    }
+    if (opts.pivotTo) {
+      result = result.pivotTo(opts.pivotTo);
+    }
+    return result;
+  }
+  #extractObjectTypes(opts) {
+    const types = new Set();
+    const baseWire = JSON.parse(this.#baseObjectSetWire);
+    if (baseWire.type) {
+      types.add(baseWire.type);
+    }
+    if (opts.union) {
+      for (const os of opts.union) {
+        const wire = getWireObjectSet(os);
+        if (wire.type) {
+          types.add(wire.type);
+        }
+      }
+    }
+    if (opts.intersect) {
+      for (const os of opts.intersect) {
+        const wire = getWireObjectSet(os);
+        if (wire.type) {
+          types.add(wire.type);
+        }
+      }
+    }
+    if (opts.subtract) {
+      for (const os of opts.subtract) {
+        const wire = getWireObjectSet(os);
+        if (wire.type) {
+          types.add(wire.type);
+        }
+      }
+    }
+
+    // TODO: support pivotTo, requires resolving the target type from link metadata
+
+    return types;
+  }
+
+  /**
+   * Register changes to the cache specific to ObjectSetQuery
+   */
+  registerCacheChanges(batch) {
+    batch.changes.registerObjectSet(this.cacheKey);
+  }
+
+  /**
+   * Implements fetchPageData from BaseListQuery template method
+   * Fetches a page of data from the composed ObjectSet
+   */
+  async fetchPageData(signal) {
+    // Fetch the data with pagination
+    const resp = await this.#composedObjectSet.fetchPage({
+      $nextPageToken: this.nextPageToken,
+      $pageSize: this.options.pageSize,
+      // OrderBy is already applied in the composed ObjectSet
+      ...(this.#operations.orderBy && Object.keys(this.#operations.orderBy).length > 0 ? {
+        $orderBy: this.#operations.orderBy
+      } : {})
+    });
+    if (signal?.aborted) {
+      throw new Error("Aborted");
+    }
+    this.nextPageToken = resp.nextPageToken;
+    return resp;
+  }
+  handleFetchError(error, _status, batch) {
+    this.logger?.error("error", error);
+    this.store.subjects.get(this.cacheKey).error(error);
+    return this.writeToStore({
+      data: []
+    }, "error", batch);
+  }
+  invalidateObjectType = async (objectType, changes) => {
+    if (this.#objectTypes.has(objectType)) {
+      changes?.modified.add(this.cacheKey);
+      return this.revalidate(true);
+    }
+    return Promise.resolve();
+  };
+  createPayload(params) {
+    return {
+      resolvedList: params.resolvedData,
+      isOptimistic: params.isOptimistic,
+      fetchMore: this.fetchMore,
+      hasMore: this.nextPageToken != null,
+      status: params.status,
+      lastUpdated: params.lastUpdated,
+      objectSet: this.#composedObjectSet
+    };
+  }
+}
+//# sourceMappingURL=ObjectSetQuery.js.map

package/build/esm/observable/internal/objectset/ObjectSetQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectSetQuery.js","names":["additionalContext","getWireObjectSet","BaseListQuery","OrderBySortingStrategy","ObjectSetQuery","baseObjectSetWire","operations","composedObjectSet","objectTypes","constructor","store","subject","cacheKey","opts","process","env","NODE_ENV","client","logger","child","msgPrefix","otherKeys","map","x","JSON","stringify","join","undefined","composeObjectSet","extractObjectTypes","orderBy","Object","keys","length","firstType","Array","from","sortingStrategy","minResultsToLoad","pageSize","#composeObjectSet","result","baseObjectSet","withProperties","where","union","intersect","subtract","pivotTo","#extractObjectTypes","types","Set","baseWire","parse","type","add","os","wire","registerCacheChanges","batch","changes","registerObjectSet","fetchPageData","signal","resp","fetchPage","$nextPageToken","nextPageToken","$pageSize","options","$orderBy","aborted","Error","handleFetchError","error","_status","subjects","get","writeToStore","data","invalidateObjectType","objectType","has","modified","revalidate","Promise","resolve","createPayload","params","resolvedList","resolvedData","isOptimistic","fetchMore","hasMore","status","lastUpdated","objectSet"],"sources":["ObjectSetQuery.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 { ObjectSet, Osdk, PageResult } from \"@osdk/api\";\nimport type { Observable } from \"rxjs\";\nimport { additionalContext } from \"../../../Client.js\";\nimport { getWireObjectSet } from \"../../../objectSet/createObjectSet.js\";\nimport type { ObjectSetPayload } from \"../../ObjectSetPayload.js\";\nimport type { Status } from \"../../ObservableClient/common.js\";\nimport { BaseListQuery } from \"../base-list/BaseListQuery.js\";\nimport type { BatchContext } from \"../BatchContext.js\";\nimport type { Canonical } from \"../Canonical.js\";\nimport type { Changes } from \"../Changes.js\";\nimport type { Entry } from \"../Layer.js\";\nimport { OrderBySortingStrategy } from \"../sorting/SortingStrategy.js\";\nimport type { Store } from \"../Store.js\";\nimport type { SubjectPayload } from \"../SubjectPayload.js\";\nimport type {\n  ObjectSetCacheKey,\n  ObjectSetOperations,\n} from \"./ObjectSetCacheKey.js\";\nimport type { ObjectSetQueryOptions } from \"./ObjectSetQueryOptions.js\";\n\nexport class ObjectSetQuery extends BaseListQuery<\n  ObjectSetCacheKey,\n  ObjectSetPayload,\n  ObjectSetQueryOptions\n> {\n  #baseObjectSetWire: string;\n  #operations: Canonical<ObjectSetOperations>;\n  #composedObjectSet: ObjectSet<any, any>;\n  #objectTypes: Set<string>;\n\n  constructor(\n    store: Store,\n    subject: Observable<SubjectPayload<ObjectSetCacheKey>>,\n    baseObjectSetWire: string,\n    operations: Canonical<ObjectSetOperations>,\n    cacheKey: ObjectSetCacheKey,\n    opts: ObjectSetQueryOptions,\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: `ObjectSetQuery<${\n              cacheKey.otherKeys.map(x => JSON.stringify(x)).join(\", \")\n            }>`,\n          })\n        )\n        : undefined,\n    );\n\n    this.#baseObjectSetWire = baseObjectSetWire;\n    this.#operations = operations;\n    this.#composedObjectSet = this.#composeObjectSet(opts);\n    this.#objectTypes = this.#extractObjectTypes(opts);\n\n    if (operations.orderBy && Object.keys(operations.orderBy).length > 0) {\n      const firstType = Array.from(this.#objectTypes)[0];\n      this.sortingStrategy = new OrderBySortingStrategy(\n        firstType,\n        operations.orderBy,\n      );\n    }\n\n    this.minResultsToLoad = opts.pageSize || 0;\n  }\n\n  #composeObjectSet(opts: ObjectSetQueryOptions): ObjectSet<any, any> {\n    let result = opts.baseObjectSet;\n\n    if (opts.withProperties) {\n      result = result.withProperties(opts.withProperties);\n    }\n    if (opts.where) {\n      result = result.where(opts.where);\n    }\n    if (opts.union && opts.union.length > 0) {\n      result = result.union(...opts.union);\n    }\n    if (opts.intersect && opts.intersect.length > 0) {\n      result = result.intersect(...opts.intersect);\n    }\n    if (opts.subtract && opts.subtract.length > 0) {\n      result = result.subtract(...opts.subtract);\n    }\n    if (opts.pivotTo) {\n      result = result.pivotTo(opts.pivotTo);\n    }\n\n    return result;\n  }\n\n  #extractObjectTypes(opts: ObjectSetQueryOptions): Set<string> {\n    const types = new Set<string>();\n    const baseWire = JSON.parse(this.#baseObjectSetWire);\n    if (baseWire.type) {\n      types.add(baseWire.type);\n    }\n\n    if (opts.union) {\n      for (const os of opts.union) {\n        const wire = getWireObjectSet(os);\n        if (wire.type) {\n          types.add(wire.type);\n        }\n      }\n    }\n\n    if (opts.intersect) {\n      for (const os of opts.intersect) {\n        const wire = getWireObjectSet(os);\n        if (wire.type) {\n          types.add(wire.type);\n        }\n      }\n    }\n\n    if (opts.subtract) {\n      for (const os of opts.subtract) {\n        const wire = getWireObjectSet(os);\n        if (wire.type) {\n          types.add(wire.type);\n        }\n      }\n    }\n\n    // TODO: support pivotTo, requires resolving the target type from link metadata\n\n    return types;\n  }\n\n  /**\n   * Register changes to the cache specific to ObjectSetQuery\n   */\n  protected registerCacheChanges(batch: BatchContext): void {\n    batch.changes.registerObjectSet(this.cacheKey);\n  }\n\n  /**\n   * Implements fetchPageData from BaseListQuery template method\n   * Fetches a page of data from the composed ObjectSet\n   */\n  protected async fetchPageData(\n    signal: AbortSignal | undefined,\n  ): Promise<PageResult<Osdk.Instance<any>>> {\n    // Fetch the data with pagination\n    const resp = await this.#composedObjectSet.fetchPage({\n      $nextPageToken: this.nextPageToken,\n      $pageSize: this.options.pageSize,\n      // OrderBy is already applied in the composed ObjectSet\n      ...(this.#operations.orderBy\n          && Object.keys(this.#operations.orderBy).length > 0\n        ? { $orderBy: this.#operations.orderBy }\n        : {}),\n    });\n\n    if (signal?.aborted) {\n      throw new Error(\"Aborted\");\n    }\n\n    this.nextPageToken = resp.nextPageToken;\n\n    return resp;\n  }\n\n  protected handleFetchError(\n    error: unknown,\n    _status: Status,\n    batch: BatchContext,\n  ): Entry<ObjectSetCacheKey> {\n    this.logger?.error(\"error\", error);\n    this.store.subjects.get(this.cacheKey).error(error);\n\n    return this.writeToStore({ data: [] }, \"error\", batch);\n  }\n\n  invalidateObjectType = async (\n    objectType: string,\n    changes: Changes | undefined,\n  ): Promise<void> => {\n    if (this.#objectTypes.has(objectType)) {\n      changes?.modified.add(this.cacheKey);\n      return this.revalidate(true);\n    }\n    return Promise.resolve();\n  };\n\n  protected createPayload(\n    params: {\n      resolvedData: any[];\n      isOptimistic: boolean;\n      status: Status;\n      lastUpdated: number;\n    },\n  ): ObjectSetPayload {\n    return {\n      resolvedList: params.resolvedData,\n      isOptimistic: params.isOptimistic,\n      fetchMore: this.fetchMore,\n      hasMore: this.nextPageToken != null,\n      status: params.status,\n      lastUpdated: params.lastUpdated,\n      objectSet: this.#composedObjectSet,\n    };\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/observable/internal/objectset/ObjectSetQueryOptions.js

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

package/build/esm/observable/internal/objectset/ObjectSetQueryOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectSetQueryOptions.js","names":[],"sources":["ObjectSetQueryOptions.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  LinkNames,\n  ObjectSet,\n  ObjectTypeDefinition,\n  PropertyKeys,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\nimport type { CommonObserveOptions } from \"../../ObservableClient/common.js\";\n\nexport interface ObserveObjectSetOptions<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<\n    string,\n    WirePropertyTypes | undefined | Array<WirePropertyTypes>\n  > = {},\n> extends CommonObserveOptions {\n  where?: WhereClause<Q>;\n  withProperties?: { [K in keyof RDPs]: DerivedProperty.Creator<Q, RDPs[K]> };\n  union?: ObjectSet<Q>[];\n  intersect?: ObjectSet<Q>[];\n  subtract?: ObjectSet<Q>[];\n  pivotTo?: LinkNames<Q>;\n  pageSize?: number;\n  orderBy?: { [K in PropertyKeys<Q>]?: \"asc\" | \"desc\" };\n}\n\nexport interface ObjectSetQueryOptions\n  extends ObserveObjectSetOptions<any, any>\n{\n  baseObjectSet: ObjectSet<any>;\n}\n"],"mappings":"","ignoreList":[]}

package/build/esm/public/unstable-do-not-use.js

@@ -18,6 +18,7 @@ export { augment } from "../object/fetchPage.js";
 
 // THIS IS NOT THE FINAL NAME DO NOT SHIP LIKE THIS
 
+export { computeObjectSetCacheKey } from "../observable/computeObjectSetCacheKey.js";
 export { createObservableClient } from "../observable/ObservableClient.js";
 export { getMetaTagContent, getOsdkConfig } from "../public-utils/osdkConfig.js";
 export { createClientWithTransaction } from "../createClient.js";

package/build/esm/public/unstable-do-not-use.js.map

@@ -1 +1 @@
-{"version":3,"file":"unstable-do-not-use.js","names":["augment","createObservableClient","getMetaTagContent","getOsdkConfig","createClientWithTransaction"],"sources":["unstable-do-not-use.ts"],"sourcesContent":["/*\n * Copyright 2023 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { augment } from \"../object/fetchPage.js\";\n\n// THIS IS NOT THE FINAL NAME DO NOT SHIP LIKE THIS\nexport type { ActionSignatureFromDef } from \"../actions/applyAction.js\";\nexport { createObservableClient } from \"../observable/ObservableClient.js\";\nexport type {\n  ObservableClient,\n  ObserveObjectArgs,\n  ObserveObjectsArgs,\n  Unsubscribable,\n} from \"../observable/ObservableClient.js\";\nexport type { Observer } from \"../observable/ObservableClient/common.js\";\nexport type { ObserveLinks } from \"../observable/ObservableClient/ObserveLink.js\";\nexport {\n  getMetaTagContent,\n  getOsdkConfig,\n} from \"../public-utils/osdkConfig.js\";\nexport type { OsdkConfig } from \"../public-utils/osdkConfig.js\";\n\nexport { createClientWithTransaction } from \"../createClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAQ,wBAAwB;;AAEhD;;AAEA,SAASC,sBAAsB,QAAQ,mCAAmC;AAS1E,SACEC,iBAAiB,EACjBC,aAAa,QACR,+BAA+B;AAGtC,SAASC,2BAA2B,QAAQ,oBAAoB","ignoreList":[]}
+{"version":3,"file":"unstable-do-not-use.js","names":["augment","computeObjectSetCacheKey","createObservableClient","getMetaTagContent","getOsdkConfig","createClientWithTransaction"],"sources":["unstable-do-not-use.ts"],"sourcesContent":["/*\n * Copyright 2023 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { augment } from \"../object/fetchPage.js\";\n\n// THIS IS NOT THE FINAL NAME DO NOT SHIP LIKE THIS\nexport type { ActionSignatureFromDef } from \"../actions/applyAction.js\";\nexport { computeObjectSetCacheKey } from \"../observable/computeObjectSetCacheKey.js\";\nexport { createObservableClient } from \"../observable/ObservableClient.js\";\nexport type {\n  ObservableClient,\n  ObserveObjectArgs,\n  ObserveObjectsArgs,\n  ObserveObjectSetArgs,\n  Unsubscribable,\n} from \"../observable/ObservableClient.js\";\nexport type { Observer } from \"../observable/ObservableClient/common.js\";\nexport type { ObserveLinks } from \"../observable/ObservableClient/ObserveLink.js\";\nexport {\n  getMetaTagContent,\n  getOsdkConfig,\n} from \"../public-utils/osdkConfig.js\";\nexport type { OsdkConfig } from \"../public-utils/osdkConfig.js\";\n\nexport { createClientWithTransaction } from \"../createClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAQ,wBAAwB;;AAEhD;;AAEA,SAASC,wBAAwB,QAAQ,2CAA2C;AACpF,SAASC,sBAAsB,QAAQ,mCAAmC;AAU1E,SACEC,iBAAiB,EACjBC,aAAa,QACR,+BAA+B;AAGtC,SAASC,2BAA2B,QAAQ,oBAAoB","ignoreList":[]}

package/build/esm/util/UserAgent.js

@@ -14,6 +14,6 @@
  * limitations under the License.
  */
 
-export const USER_AGENT = `osdk-client/${"2.5.0-beta.10"}`;
-export const OBSERVABLE_USER_AGENT = `osdk-observable-client/${"2.5.0-beta.10"}`;
+export const USER_AGENT = `osdk-client/${"2.5.0-beta.11"}`;
+export const OBSERVABLE_USER_AGENT = `osdk-observable-client/${"2.5.0-beta.11"}`;
 //# sourceMappingURL=UserAgent.js.map

package/build/types/observable/ObjectSetPayload.d.ts

@@ -0,0 +1,5 @@
+import type { ObjectSet } from "@osdk/api";
+import type { BaseCollectionPayload } from "./internal/base-list/BaseCollectionQuery.js";
+export interface ObjectSetPayload extends BaseCollectionPayload {
+	objectSet: ObjectSet<any, any>;
+}

package/build/types/observable/ObjectSetPayload.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,iBAAiB,WAAY;AAC3C,cAAc,6BAA6B,6CAA8C;AAEzF,iBAAiB,yBAAyB,sBAAsB;CAC9D,WAAW;AACZ","names":[],"sources":["../../../src/observable/ObjectSetPayload.ts"],"version":3,"file":"ObjectSetPayload.d.ts"}

package/build/types/observable/ObservableClient.d.ts

@@ -1,7 +1,8 @@
-import type { ActionDefinition, ActionValidationResponse, InterfaceDefinition, ObjectTypeDefinition, Osdk, PrimaryKeyType, PropertyKeys, WhereClause } from "@osdk/api";
+import type { ActionDefinition, ActionValidationResponse, InterfaceDefinition, ObjectSet, ObjectTypeDefinition, Osdk, PrimaryKeyType, PropertyKeys, WhereClause, WirePropertyTypes } from "@osdk/api";
 import type { ActionSignatureFromDef } from "../actions/applyAction.js";
 import { type Client } from "../Client.js";
 import type { Canonical } from "./internal/Canonical.js";
+import type { ObserveObjectSetOptions } from "./internal/objectset/ObjectSetQueryOptions.js";
 import type { CommonObserveOptions, InvalidationMode, ObserveOptions, Observer, Status } from "./ObservableClient/common.js";
 import type { ObserveLinks } from "./ObservableClient/ObserveLink.js";
 import type { OptimisticBuilder } from "./OptimisticBuilder.js";
@@ -39,6 +40,18 @@ export interface ObserveObjectsArgs<T extends ObjectTypeDefinition | InterfaceDe
 	hasMore: boolean;
 	status: Status;
 }
+export interface ObserveObjectSetArgs<
+	T extends ObjectTypeDefinition | InterfaceDefinition,
+	RDPs extends Record<string, WirePropertyTypes | undefined | Array<WirePropertyTypes>> = {}
+> {
+	resolvedList: Array<Osdk.Instance<T, "$allBaseProperties", PropertyKeys<T>, RDPs>>;
+	isOptimistic: boolean;
+	lastUpdated: number;
+	fetchMore: () => Promise<void>;
+	hasMore: boolean;
+	status: Status;
+	objectSet: ObjectSet<T, RDPs>;
+}
 /**
 * User facing callback args for `observeLink`
 */
@@ -92,6 +105,25 @@ export interface ObservableClient extends ObserveLinks {
 	*/
 	observeList<T extends ObjectTypeDefinition | InterfaceDefinition>(options: ObserveListOptions<T>, subFn: Observer<ObserveObjectsArgs<T>>): Unsubscribable;
 	/**
+	* Observe an ObjectSet with automatic updates when matching objects change.
+	*
+	* @param baseObjectSet - The base ObjectSet to observe
+	* @param options - Options for transforming and observing the ObjectSet
+	* @param subFn - Observer that receives ObjectSet state updates
+	* @returns Subscription that can be unsubscribed to stop updates
+	*
+	* Supports all ObjectSet operations:
+	* - Filtering with where clauses
+	* - Derived properties with withProperties
+	* - Set operations (union, intersect, subtract)
+	* - Link traversal with pivotTo
+	* - Sorting and pagination
+	*/
+	observeObjectSet<
+		T extends ObjectTypeDefinition,
+		RDPs extends Record<string, WirePropertyTypes | undefined | Array<WirePropertyTypes>> = {}
+	>(baseObjectSet: ObjectSet<T>, options: ObserveObjectSetOptions<T, RDPs>, subFn: Observer<ObserveObjectSetArgs<T, RDPs>>): Unsubscribable;
+	/**
 	* Execute an action with optional optimistic updates.
 	*
 	* @param action - Action definition to execute

package/build/types/observable/ObservableClient.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,kBACA,0BACA,qBACA,sBACA,MACA,gBACA,cACA,mBACK,WAAY;AAEnB,cAAc,8BAA8B,2BAA4B;AACxE,cAAiC,cAAc,cAAe;AAG9D,cAAc,iBAAiB,yBAA0B;AAGzD,cACE,sBACA,kBACA,gBACA,UACA,cACK,8BAA+B;AACtC,cAAc,oBAAoB,mCAAoC;AACtE,cAAc,yBAAyB,wBAAyB;AAEhE,yBAAiB;WACE,mBAAmB;EAClC,oBAAoBA,KAAK;CAC1B;;AAGH,iBAAiB,qBACf,UAAU,uBAAuB,6BACzB,eAAe;CACvB,SAAS,EAAE,aAAa;CACxB,IAAI,eAAe;CACnB,SAAS,aAAa;AACvB;AAED,YAAY,QAAQ,UAAU,uBAAuB,0BAClD,KAAK,aAAa,OAAM,QAAQ;AAGnC,iBAAiB,mBACf,UAAU,uBAAuB,6BACzB,sBAAsB,eAAe;CAC7C,MAAM,KAAK,GAAG,YAAY;CAC1B,QAAQ,YAAY;CACpB;CACA,UAAU,QAAQ;CAClB,mBAAmB;CACnB;CACA;AACD;AAID,iBAAiB,kBAAkB,UAAU,sBAAsB;CACjE,QAAQ,KAAK,SAAS;CACtB;CACA,QAAQ;CACR;AACD;AAGD,iBAAiB,mBACf,UAAU,uBAAuB,qBACjC;CACA,cAAc,MAAM,KAAK,SAAS;CAClC;CACA;CACA,iBAAiB;CACjB;CACA,QAAQ;AACT;;;;AAKD,iBAAiB,wBACf,UAAU,uBAAuB,qBACjC;CACA,cAAc,KAAK,SAAS;CAC5B;CACA;CACA,iBAAiB;CACjB;CACA,QAAQ;AACT;;;;;;;;;;;AAYD,iBAAiB,yBAAyB,aAAa;;;;;;;;;;;;;;;;CAgBrD,cAAc,UAAU,sBACtBC,SAAS,EAAE,aAAa,GACxBC,IAAI,eAAe,IACnBC,SAAS,gBACTC,OAAO,SAAS,kBAAkB,MACjC;;;;;;;;;;;;;;CAeH,YAAY,UAAU,uBAAuB,qBAC3CC,SAAS,mBAAmB,IAC5BC,OAAO,SAAS,mBAAmB,MAClC;;;;;;;;;;;;;;;CAgBH,cAAc,UAAU,uBACtBC,QAAQ,GACRC,MACI,WAAW,uBAAuB,GAAG,gBAAgB,KACrD,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,KAC/DC,OAAO,iBAAiB,uBACrB;;;;;;;;;;;;;CAcL,iBAAiB,UAAU,uBACzBF,QAAQ,GACRG,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,OACxD,QAAQ;;;;;CAMb,iBAAiB;;;;;CAMjB,kBACEC,SACI,KAAK,SAAS,wBACd,cAAc,KAAK,SAAS,yBAC/B;;;;;;;;;;;CAYH,qBAAqB,UAAU,sBAC7BC,MAAM,IAAI,EAAE,aACX;CAEH,0BACE,UAAU,uBAAuB,qBAEjCC,OAAO,YAAY,OAChB,UAAU,YAAY;AAC5B;AAED,OAAO,iBAAS,uBAAuBC,QAAQ,SAAS;AA0BxD,iBAAiB,eAAe;CAC9B;AACD","names":["ctx: OptimisticBuilder","apiName: T[\"apiName\"] | T","pk: PrimaryKeyType<T>","options: ObserveOptions","subFn: Observer<ObserveObjectArgs<T>>","options: ObserveListOptions<T>","subFn: Observer<ObserveObjectsArgs<T>>","action: Q","args:\n      | Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n      | Array<Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]>","opts?: ObservableClient.ApplyActionOptions","args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]","objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>","type: T | T[\"apiName\"]","where: WhereClause<T>","client: Client"],"sources":["../../../src/observable/ObservableClient.ts"],"version":3,"file":"ObservableClient.d.ts"}
+{"mappings":"AAgBA,cACE,kBACA,0BACA,qBACA,WACA,sBACA,MACA,gBACA,cACA,aACA,yBACK,WAAY;AAEnB,cAAc,8BAA8B,2BAA4B;AACxE,cAAiC,cAAc,cAAe;AAG9D,cAAc,iBAAiB,yBAA0B;AACzD,cAAc,+BAA+B,+CAAgD;AAG7F,cACE,sBACA,kBACA,gBACA,UACA,cACK,8BAA+B;AACtC,cAAc,oBAAoB,mCAAoC;AACtE,cAAc,yBAAyB,wBAAyB;AAEhE,yBAAiB;WACE,mBAAmB;EAClC,oBAAoBA,KAAK;CAC1B;;AAGH,iBAAiB,qBACf,UAAU,uBAAuB,6BACzB,eAAe;CACvB,SAAS,EAAE,aAAa;CACxB,IAAI,eAAe;CACnB,SAAS,aAAa;AACvB;AAED,YAAY,QAAQ,UAAU,uBAAuB,0BAClD,KAAK,aAAa,OAAM,QAAQ;AAGnC,iBAAiB,mBACf,UAAU,uBAAuB,6BACzB,sBAAsB,eAAe;CAC7C,MAAM,KAAK,GAAG,YAAY;CAC1B,QAAQ,YAAY;CACpB;CACA,UAAU,QAAQ;CAClB,mBAAmB;CACnB;CACA;AACD;AAID,iBAAiB,kBAAkB,UAAU,sBAAsB;CACjE,QAAQ,KAAK,SAAS;CACtB;CACA,QAAQ;CACR;AACD;AAGD,iBAAiB,mBACf,UAAU,uBAAuB,qBACjC;CACA,cAAc,MAAM,KAAK,SAAS;CAClC;CACA;CACA,iBAAiB;CACjB;CACA,QAAQ;AACT;AAED,iBAAiB;CACf,UAAU,uBAAuB;CACjC,aAAa,eAEX,gCAAgC,MAAM,sBACpC,CAAE;EACN;CACA,cAAc,MACZ,KAAK,SAAS,GAAG,sBAAsB,aAAa,IAAI;CAE1D;CACA;CACA,iBAAiB;CACjB;CACA,QAAQ;CACR,WAAW,UAAU,GAAG;AACzB;;;;AAKD,iBAAiB,wBACf,UAAU,uBAAuB,qBACjC;CACA,cAAc,KAAK,SAAS;CAC5B;CACA;CACA,iBAAiB;CACjB;CACA,QAAQ;AACT;;;;;;;;;;;AAYD,iBAAiB,yBAAyB,aAAa;;;;;;;;;;;;;;;;CAgBrD,cAAc,UAAU,sBACtBC,SAAS,EAAE,aAAa,GACxBC,IAAI,eAAe,IACnBC,SAAS,gBACTC,OAAO,SAAS,kBAAkB,MACjC;;;;;;;;;;;;;;CAeH,YAAY,UAAU,uBAAuB,qBAC3CC,SAAS,mBAAmB,IAC5BC,OAAO,SAAS,mBAAmB,MAClC;;;;;;;;;;;;;;;;CAiBH;EACE,UAAU;EACV,aAAa,eAEX,gCAAgC,MAAM,sBACpC,CAAE;GAENC,eAAe,UAAU,IACzBC,SAAS,wBAAwB,GAAG,OACpCC,OAAO,SAAS,qBAAqB,GAAG,SACvC;;;;;;;;;;;;;;;CAgBH,cAAc,UAAU,uBACtBC,QAAQ,GACRC,MACI,WAAW,uBAAuB,GAAG,gBAAgB,KACrD,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,KAC/DC,OAAO,iBAAiB,uBACrB;;;;;;;;;;;;;CAcL,iBAAiB,UAAU,uBACzBF,QAAQ,GACRG,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,OACxD,QAAQ;;;;;CAMb,iBAAiB;;;;;CAMjB,kBACEC,SACI,KAAK,SAAS,wBACd,cAAc,KAAK,SAAS,yBAC/B;;;;;;;;;;;CAYH,qBAAqB,UAAU,sBAC7BC,MAAM,IAAI,EAAE,aACX;CAEH,0BACE,UAAU,uBAAuB,qBAEjCC,OAAO,YAAY,OAChB,UAAU,YAAY;AAC5B;AAED,OAAO,iBAAS,uBAAuBC,QAAQ,SAAS;AA0BxD,iBAAiB,eAAe;CAC9B;AACD","names":["ctx: OptimisticBuilder","apiName: T[\"apiName\"] | T","pk: PrimaryKeyType<T>","options: ObserveOptions","subFn: Observer<ObserveObjectArgs<T>>","options: ObserveListOptions<T>","subFn: Observer<ObserveObjectsArgs<T>>","baseObjectSet: ObjectSet<T>","options: ObserveObjectSetOptions<T, RDPs>","subFn: Observer<ObserveObjectSetArgs<T, RDPs>>","action: Q","args:\n      | Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n      | Array<Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]>","opts?: ObservableClient.ApplyActionOptions","args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]","objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>","type: T | T[\"apiName\"]","where: WhereClause<T>","client: Client"],"sources":["../../../src/observable/ObservableClient.ts"],"version":3,"file":"ObservableClient.d.ts"}

package/build/types/observable/computeObjectSetCacheKey.d.ts

@@ -0,0 +1,16 @@
+import type { BaseObjectSet, ObjectSet, ObjectTypeDefinition, WirePropertyTypes } from "@osdk/api";
+import type { ObserveObjectSetOptions } from "./internal/objectset/ObjectSetQueryOptions.js";
+/**
+* Computes a stable cache key for an ObjectSet with options.
+*
+* Note: dedupeInterval is excluded as it doesn't affect the data, only the refresh rate.
+*
+* @param objectSet - The base ObjectSet
+* @param options - Optional observation options (where, orderBy, etc.)
+* @returns A stable string key representing the ObjectSet and options
+*/
+export declare function computeObjectSetCacheKey<
+	T extends ObjectTypeDefinition,
+	BaseRDPs extends Record<string, WirePropertyTypes | undefined | Array<WirePropertyTypes>> | BaseObjectSet<T> = never,
+	RDPs extends Record<string, WirePropertyTypes | undefined | Array<WirePropertyTypes>> = {}
+>(objectSet: ObjectSet<T, BaseRDPs>, options?: ObserveObjectSetOptions<T, RDPs>): string;

package/build/types/observable/computeObjectSetCacheKey.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,eACA,WACA,sBACA,yBACK,WAAY;AAEnB,cAAc,+BAA+B,+CAAgD;;;;;;;;;;AAgB7F,OAAO,iBAAS;CACd,UAAU;CACV,iBACI,eAAe,gCAAgC,MAAM,sBACrD,cAAc;CAClB,aAAa,eAEX,gCAAgC,MAAM,sBACpC,CAAE;EAENA,WAAW,UAAU,GAAG,WACxBC,UAAU,wBAAwB,GAAG","names":["objectSet: ObjectSet<T, BaseRDPs>","options?: ObserveObjectSetOptions<T, RDPs>"],"sources":["../../../src/observable/computeObjectSetCacheKey.ts"],"version":3,"file":"computeObjectSetCacheKey.d.ts"}

package/build/types/observable/internal/Changes.d.ts

@@ -3,17 +3,19 @@ import type { ObjectHolder } from "../../object/convertWireToOsdkObjects/ObjectH
 import type { SpecificLinkCacheKey } from "./links/SpecificLinkCacheKey.js";
 import type { ListCacheKey } from "./list/ListCacheKey.js";
 import type { ObjectCacheKey } from "./object/ObjectCacheKey.js";
+import type { ObjectSetCacheKey } from "./objectset/ObjectSetCacheKey.js";
 export declare class Changes {
 	modifiedObjects: MultiMap<string, ObjectHolder>;
 	addedObjects: MultiMap<string, ObjectHolder>;
-	added: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey>;
-	modified: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey>;
-	deleted: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey>;
+	added: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey | ObjectSetCacheKey>;
+	modified: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey | ObjectSetCacheKey>;
+	deleted: Set<ListCacheKey | ObjectCacheKey | SpecificLinkCacheKey | ObjectSetCacheKey>;
 	registerObject: (cacheKey: ObjectCacheKey, data: ObjectHolder, isNew: boolean) => void;
 	deleteObject: (cacheKey: ObjectCacheKey) => void;
 	registerList: (key: ListCacheKey) => void;
 	registerLink: (cacheKey: SpecificLinkCacheKey) => void;
 	deleteLink: (cacheKey: SpecificLinkCacheKey) => void;
+	registerObjectSet: (key: ObjectSetCacheKey) => void;
 	isEmpty(): boolean;
 }
 export declare function createChangedObjects(): Changes;

package/build/types/observable/internal/Changes.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,SAAS,gBAAgB,WAAY;AACrC,cAAc,oBAAoB,uDAAwD;AAG1F,cAAc,4BAA4B,iCAAkC;AAC5E,cAAc,oBAAoB,wBAAyB;AAC3D,cAAc,sBAAsB,4BAA6B;AAEjE,OAAO,cAAM,QAAQ;CACnB,iBAAiB,iBAAiB;CAClC,cAAc,iBAAiB;CAE/B,OAAO,IAAI,eAAe,iBAAiB;CAC3C,UAAU,IAAI,eAAe,iBAAiB;CAE9C,SAAS,IAAI,eAAe,iBAAiB;CAG7C,iBACEA,UAAU,gBACVC,MAAM,cACNC;CAMF,eAAgBF,UAAU;CAI1B,eAAgBG,KAAK;CAIrB,eAAgBC,UAAU;CAI1B,aAAcA,UAAU;CAIxB;AASD;AAED,OAAO,iBAAS,wBAAwB;AAIxC,OAAO,iBAAS,4BAA4BC,SAAS","names":["cacheKey: ObjectCacheKey","data: ObjectHolder","isNew: boolean","key: ListCacheKey","cacheKey: SpecificLinkCacheKey","changes: Changes"],"sources":["../../../../src/observable/internal/Changes.ts"],"version":3,"file":"Changes.d.ts"}
+{"mappings":"AAgBA,SAAS,gBAAgB,WAAY;AACrC,cAAc,oBAAoB,uDAAwD;AAG1F,cAAc,4BAA4B,iCAAkC;AAC5E,cAAc,oBAAoB,wBAAyB;AAC3D,cAAc,sBAAsB,4BAA6B;AACjE,cAAc,yBAAyB,kCAAmC;AAE1E,OAAO,cAAM,QAAQ;CACnB,iBAAiB,iBAAiB;CAClC,cAAc,iBAAiB;CAE/B,OAAO,IACL,eAAe,iBAAiB,uBAAuB;CAEzD,UAAU,IACR,eAAe,iBAAiB,uBAAuB;CAEzD,SAAS,IACP,eAAe,iBAAiB,uBAAuB;CAGzD,iBACEA,UAAU,gBACVC,MAAM,cACNC;CAMF,eAAgBF,UAAU;CAI1B,eAAgBG,KAAK;CAIrB,eAAgBC,UAAU;CAI1B,aAAcA,UAAU;CAIxB,oBAAqBC,KAAK;CAI1B;AASD;AAED,OAAO,iBAAS,wBAAwB;AAIxC,OAAO,iBAAS,4BAA4BC,SAAS","names":["cacheKey: ObjectCacheKey","data: ObjectHolder","isNew: boolean","key: ListCacheKey","cacheKey: SpecificLinkCacheKey","key: ObjectSetCacheKey","changes: Changes"],"sources":["../../../../src/observable/internal/Changes.ts"],"version":3,"file":"Changes.d.ts"}

package/build/types/observable/internal/KnownCacheKey.d.ts

@@ -1,4 +1,5 @@
 import type { SpecificLinkCacheKey } from "./links/SpecificLinkCacheKey.js";
 import type { ListCacheKey } from "./list/ListCacheKey.js";
 import type { ObjectCacheKey } from "./object/ObjectCacheKey.js";
-export type KnownCacheKey = ObjectCacheKey | SpecificLinkCacheKey | ListCacheKey;
+import type { ObjectSetCacheKey } from "./objectset/ObjectSetCacheKey.js";
+export type KnownCacheKey = ObjectCacheKey | SpecificLinkCacheKey | ListCacheKey | ObjectSetCacheKey;

package/build/types/observable/internal/KnownCacheKey.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,4BAA4B,iCAAkC;AAC5E,cAAc,oBAAoB,wBAAyB;AAC3D,cAAc,sBAAsB,4BAA6B;AAEjE,YAAY,gBACR,iBACA,uBACA","names":[],"sources":["../../../../src/observable/internal/KnownCacheKey.ts"],"version":3,"file":"KnownCacheKey.d.ts"}
+{"mappings":"AAgBA,cAAc,4BAA4B,iCAAkC;AAC5E,cAAc,oBAAoB,wBAAyB;AAC3D,cAAc,sBAAsB,4BAA6B;AACjE,cAAc,yBAAyB,kCAAmC;AAE1E,YAAY,gBACR,iBACA,uBACA,eACA","names":[],"sources":["../../../../src/observable/internal/KnownCacheKey.ts"],"version":3,"file":"KnownCacheKey.d.ts"}

package/build/types/observable/internal/Query.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,cAAc,WAAY;AACxC,cACE,aACA,YACA,UACA,cACA,oBACK,MAAO;AAEd,cACE,sBACA,cACK,+BAAgC;AACvC,cAAc,oBAAoB,mBAAoB;AACtD,cAAc,iBAAiB,gBAAiB;AAChD,cAAc,eAAe,cAAe;AAC5C,cAAc,qBAAqB,oBAAqB;AACxD,cAAc,aAAa,YAAa;AACxC,cAAc,oBAAoB,mBAAoB;AACtD,cAAc,aAAa,YAAa;AACxC,cAAc,sBAAsB,qBAAsB;AAE1D,OAAO,uBAAe;CACpB,YAAY;CACZ;CACA,UAAU;aACC,aAAa,SAAS;;CACjC;CACA,eAAe;CACf;CACA,SAAS;CACT,UAAU;CACV,OAAO;CACP,kBAAkB;CASlB,mBAAmB,WAAW,UAAU;CAExC,YACEA,OAAO,OACPC,YAAY,WAAW,eAAe,OACtCC,MAAM,GACNC,UAAU,KACVC,SAAS;CAqBX,mBAAmB,mBACjBC,SAAS,WAAW,eAAe,QAClC,YAAY;CAEf,AAAO,UACLC,UAAU,SAAS,WAClB;;;;CASH,mCACEC,wBACAC;;;;CAUF,qCAAqCD;;;;CAOrC,QAAQ;;;;;;;;;CAgBR,AAAM,WAAWE,kBAAkB;CAiEnC,UAAU;CAEV,mBAAmB,kBAAkB;;;;;;;;CASrC,UACEC,QAAQ,QACRC,OAAO;CAyBT;;;;CAWA,UAAU;;;;;;;;;CAUV,SAAS,aACPC,MAAM,IAAI,cAAc,UACxBF,QAAQ,QACRC,OAAO,eACN,MAAM;;;;;;;CAQT,4BACEE,SAAS,SACTC,cAAc,6BACX;CAEL,SAAS,qBACPC,oBACAC,SAAS,sBACR;AACJ","names":["store: Store","observable: Observable<SubjectPayload<KEY>>","opts: O","cacheKey: KEY","logger?: Logger","subject: Observable<SubjectPayload<KEY>>","observer: Observer<PAYLOAD>","subscriptionId: string","dedupeInterval: number | undefined","force?: boolean","status: Status","batch: BatchContext","data: KEY[\"__cacheKey\"][\"value\"]","changes: Changes","optimisticId: OptimisticId | undefined","objectType: string","changes: Changes | undefined"],"sources":["../../../../src/observable/internal/Query.ts"],"version":3,"file":"Query.d.ts"}
+{"mappings":"AAgBA,cAAc,cAAc,WAAY;AACxC,cACE,aACA,YACA,UACA,cACA,oBACK,MAAO;AAEd,cACE,sBACA,cACK,+BAAgC;AACvC,cAAc,oBAAoB,mBAAoB;AACtD,cAAc,iBAAiB,gBAAiB;AAChD,cAAc,eAAe,cAAe;AAC5C,cAAc,qBAAqB,oBAAqB;AACxD,cAAc,aAAa,YAAa;AACxC,cAAc,oBAAoB,mBAAoB;AACtD,cAAc,aAAa,YAAa;AACxC,cAAc,sBAAsB,qBAAsB;AAE1D,OAAO,uBAAe;CACpB,YAAY;CACZ;CACA,UAAU;aACC,aAAa,SAAS;;CACjC;CACA,eAAe;CACf;CACA,SAAS;CACT,UAAU;CACV,OAAO;CACP,kBAAkB;CASlB,mBAAmB,WAAW,UAAU;CAExC,YACEA,OAAO,OACPC,YAAY,WAAW,eAAe,OACtCC,MAAM,GACNC,UAAU,KACVC,SAAS;CAqBX,mBAAmB,mBACjBC,SAAS,WAAW,eAAe,QAClC,YAAY;CAEf,AAAO,UACLC,UAAU,SAAS,WAClB;;;;CA0BH,mCACEC,wBACAC;;;;CAUF,qCAAqCD;;;;CAOrC,QAAQ;;;;;;;;;CAgBR,AAAM,WAAWE,kBAAkB;CAiEnC,UAAU;CAEV,mBAAmB,kBAAkB;;;;;;;;CASrC,UACEC,QAAQ,QACRC,OAAO;CAyBT;;;;CAWA,UAAU;;;;;;;;;CAUV,SAAS,aACPC,MAAM,IAAI,cAAc,UACxBF,QAAQ,QACRC,OAAO,eACN,MAAM;;;;;;;CAQT,4BACEE,SAAS,SACTC,cAAc,6BACX;CAEL,SAAS,qBACPC,oBACAC,SAAS,sBACR;AACJ","names":["store: Store","observable: Observable<SubjectPayload<KEY>>","opts: O","cacheKey: KEY","logger?: Logger","subject: Observable<SubjectPayload<KEY>>","observer: Observer<PAYLOAD>","subscriptionId: string","dedupeInterval: number | undefined","force?: boolean","status: Status","batch: BatchContext","data: KEY[\"__cacheKey\"][\"value\"]","changes: Changes","optimisticId: OptimisticId | undefined","objectType: string","changes: Changes | undefined"],"sources":["../../../../src/observable/internal/Query.ts"],"version":3,"file":"Query.d.ts"}

package/build/types/observable/internal/Store.d.ts

@@ -11,6 +11,7 @@ import { Layers } from "./Layers.js";
 import { LinksHelper } from "./links/LinksHelper.js";
 import { ListsHelper } from "./list/ListsHelper.js";
 import { ObjectsHelper } from "./object/ObjectsHelper.js";
+import { ObjectSetHelper } from "./objectset/ObjectSetHelper.js";
 import { type OptimisticId } from "./OptimisticId.js";
 import { OrderByCanonicalizer } from "./OrderByCanonicalizer.js";
 import { Queries } from "./Queries.js";
@@ -39,6 +40,7 @@ export declare class Store {
 	readonly lists: ListsHelper;
 	readonly objects: ObjectsHelper;
 	readonly links: LinksHelper;
+	readonly objectSets: ObjectSetHelper;
 	constructor(client: Client);
 	applyAction: <Q extends ActionDefinition<any>>(action: Q, args: Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0] | Array<Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0]>, opts?: Store.ApplyActionOptions) => Promise<ActionEditResponse>;
 	validateAction: <Q extends ActionDefinition<any>>(action: Q, args: Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0]) => Promise<ActionValidationResponse>;

package/build/types/observable/internal/Store.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,kBACA,oBACA,0BAEA,sBACA,MACA,sBACK,WAAY;AAEnB,cAAc,8BAA8B,8BAA+B;AAC3E,cAAiC,cAAc,iBAAkB;AAEjE,cAAc,yBAAyB,yBAA0B;AAEjE,cAAc,oBAAoB,mBAAoB;AACtD,SAAS,iBAAiB,gBAAiB;AAC3C,cACO,eAGA,cAAe;AACtB,cAAc,qBAAqB,oBAAqB;AACxD,cAAc,aAAa,YAAa;AACxC,SAAS,cAAc,aAAc;AACrC,SAAS,mBAAmB,wBAAyB;AACrD,SAAS,mBAAmB,uBAAwB;AACpD,SAAS,qBAAqB,2BAA4B;AAC1D,cAAc,oBAAoB,mBAAoB;AACtD,SAAS,4BAA4B,2BAA4B;AACjE,SAAS,eAAe,cAAe;AACvC,cAAc,gBAAgB,eAAgB;AAC9C,SAAS,gCAAgC,+BAAgC;AAEzE,yBAAiB;WACE,mBAAmB;EAClC,oBAAoBA,KAAK;CAC1B;;;;;;;;AAeH,OAAO,cAAM,MAAM;;CACjB,SAAS,oBAAoB;CAE7B,SAAS,sBAAsB;CAG/B,SAAS,QAAQ;CAKjB,SAAS,WAAW,UAAU;CAC9B,SAAS,SAAS;CAElB,SAAS,QAAQ;CAIjB,SAAS,UAAU;CAGnB,SAAS,OAAO;CAChB,SAAS,SAAS;CAClB,SAAS,OAAO;CAEhB,YAAYC,QAAQ;CAqDpB,cAAc,UAAU,uBACtBC,QAAQ,GACRC,MACI,WAAW,uBAAuB,GAAG,gBAAgB,KACrD,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,KAC/DC,OAAO,MAAM,uBACV,QAAQ;CAIb,iBAAiB,UAAU,uBACzBF,QAAQ,GACRG,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,OACxD,QAAQ;CAQb,AAAO,SAAS,UAAU,eACxBC,UAAU,IACT,MAAM;CAIT,MAAM,GACJ,EAAE,cAAc,SAGf,EAHmD;EAClD,eAAe;EACf,UAAU;CACX,GACDC,UAAUC,cAAc,iBAAiB,IACxC;EACD,aAAa;EACb,QAAQ;EACR,SAAS;CACV;CAID,AAAO,iBAAiB,UAAU,sBAChCC,SAAS,EAAE,aAAa,GACxBC,IAAI,eAAe,KAClB;;;;;;;;;;;;CA0DH,AAAO,qBAAqB,UAAU,sBACpCD,SAAS,EAAE,aAAa,GACxBE,SAAS,sBACR;CA0BH,AAAa,iBAAiB;CAY9B,AAAa,kBACXC,SACI,KAAK,SAAS,wBACd,cAAc,KAAK,SAAS,yBAC/B;AAWJ","names":["ctx: OptimisticBuilder","client: Client","action: Q","args:\n      | Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n      | Array<Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]>","opts?: Store.ApplyActionOptions","args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]","cacheKey: K","batchFn: (batchContext: BatchContext) => X","batchContext: BatchContext","apiName: T[\"apiName\"] | T","pk: PrimaryKeyType<T>","changes: Changes | undefined","objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>"],"sources":["../../../../src/observable/internal/Store.ts"],"version":3,"file":"Store.d.ts"}
+{"mappings":"AAgBA,cACE,kBACA,oBACA,0BAEA,sBACA,MACA,sBACK,WAAY;AAEnB,cAAc,8BAA8B,8BAA+B;AAC3E,cAAiC,cAAc,iBAAkB;AAEjE,cAAc,yBAAyB,yBAA0B;AAEjE,cAAc,oBAAoB,mBAAoB;AACtD,SAAS,iBAAiB,gBAAiB;AAC3C,cACO,eAGA,cAAe;AACtB,cAAc,qBAAqB,oBAAqB;AACxD,cAAc,aAAa,YAAa;AACxC,SAAS,cAAc,aAAc;AACrC,SAAS,mBAAmB,wBAAyB;AACrD,SAAS,mBAAmB,uBAAwB;AACpD,SAAS,qBAAqB,2BAA4B;AAC1D,SAAS,uBAAuB,gCAAiC;AACjE,cAAc,oBAAoB,mBAAoB;AACtD,SAAS,4BAA4B,2BAA4B;AACjE,SAAS,eAAe,cAAe;AACvC,cAAc,gBAAgB,eAAgB;AAC9C,SAAS,gCAAgC,+BAAgC;AAEzE,yBAAiB;WACE,mBAAmB;EAClC,oBAAoBA,KAAK;CAC1B;;;;;;;;AAeH,OAAO,cAAM,MAAM;;CACjB,SAAS,oBAAoB;CAE7B,SAAS,sBAAsB;CAG/B,SAAS,QAAQ;CAKjB,SAAS,WAAW,UAAU;CAC9B,SAAS,SAAS;CAElB,SAAS,QAAQ;CAIjB,SAAS,UAAU;CAGnB,SAAS,OAAO;CAChB,SAAS,SAAS;CAClB,SAAS,OAAO;CAChB,SAAS,YAAY;CAErB,YAAYC,QAAQ;CA2DpB,cAAc,UAAU,uBACtBC,QAAQ,GACRC,MACI,WAAW,uBAAuB,GAAG,gBAAgB,KACrD,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,KAC/DC,OAAO,MAAM,uBACV,QAAQ;CAIb,iBAAiB,UAAU,uBACzBF,QAAQ,GACRG,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,OACxD,QAAQ;CAQb,AAAO,SAAS,UAAU,eACxBC,UAAU,IACT,MAAM;CAIT,MAAM,GACJ,EAAE,cAAc,SAGf,EAHmD;EAClD,eAAe;EACf,UAAU;CACX,GACDC,UAAUC,cAAc,iBAAiB,IACxC;EACD,aAAa;EACb,QAAQ;EACR,SAAS;CACV;CAID,AAAO,iBAAiB,UAAU,sBAChCC,SAAS,EAAE,aAAa,GACxBC,IAAI,eAAe,KAClB;;;;;;;;;;;;CA0DH,AAAO,qBAAqB,UAAU,sBACpCD,SAAS,EAAE,aAAa,GACxBE,SAAS,sBACR;CA0BH,AAAa,iBAAiB;CAY9B,AAAa,kBACXC,SACI,KAAK,SAAS,wBACd,cAAc,KAAK,SAAS,yBAC/B;AAWJ","names":["ctx: OptimisticBuilder","client: Client","action: Q","args:\n      | Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n      | Array<Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]>","opts?: Store.ApplyActionOptions","args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]","cacheKey: K","batchFn: (batchContext: BatchContext) => X","batchContext: BatchContext","apiName: T[\"apiName\"] | T","pk: PrimaryKeyType<T>","changes: Changes | undefined","objects:\n      | Osdk.Instance<ObjectTypeDefinition>\n      | ReadonlyArray<Osdk.Instance<ObjectTypeDefinition>>"],"sources":["../../../../src/observable/internal/Store.ts"],"version":3,"file":"Store.d.ts"}

package/build/types/observable/internal/objectset/ObjectSetCacheKey.d.ts

@@ -0,0 +1,16 @@
+import type { CollectionStorageData } from "../base-list/BaseCollectionQuery.js";
+import type { CacheKey } from "../CacheKey.js";
+import type { Canonical } from "../Canonical.js";
+import type { ObjectSetQuery } from "./ObjectSetQuery.js";
+export interface ObjectSetStorageData extends CollectionStorageData {}
+export interface ObjectSetOperations {
+	where?: Canonical<any>;
+	withProperties?: string[];
+	union?: string[];
+	intersect?: string[];
+	subtract?: string[];
+	pivotTo?: string;
+	orderBy?: Canonical<Record<string, "asc" | "desc" | undefined>>;
+	pageSize?: number;
+}
+export interface ObjectSetCacheKey extends CacheKey<"objectSet", ObjectSetStorageData, ObjectSetQuery, [baseObjectSetWire: string, operations: Canonical<ObjectSetOperations>]> {}

package/build/types/observable/internal/objectset/ObjectSetCacheKey.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,6BAA6B,qCAAsC;AACjF,cAAc,gBAAgB,gBAAiB;AAC/C,cAAc,iBAAiB,iBAAkB;AACjD,cAAc,sBAAsB,qBAAsB;AAE1D,iBAAiB,6BAA6B,sBAAsB,CAAE;AAEtE,iBAAiB,oBAAoB;CACnC,QAAQ;CACR;CACA;CACA;CACA;CACA;CACA,UAAU,UAAU,eAAe,QAAQ;CAC3C;AACD;AAED,iBAAiB,0BACf,SACE,aACA,sBACA,iBAEE,2BACA,YAAY,UAAU,uBAG5B,CACC","names":[],"sources":["../../../../../src/observable/internal/objectset/ObjectSetCacheKey.ts"],"version":3,"file":"ObjectSetCacheKey.d.ts"}

package/build/types/observable/internal/objectset/ObjectSetHelper.d.ts

@@ -0,0 +1,19 @@
+import type { ObjectSetPayload } from "../../ObjectSetPayload.js";
+import type { Observer } from "../../ObservableClient/common.js";
+import { AbstractHelper } from "../AbstractHelper.js";
+import type { CacheKeys } from "../CacheKeys.js";
+import type { KnownCacheKey } from "../KnownCacheKey.js";
+import type { OrderByCanonicalizer } from "../OrderByCanonicalizer.js";
+import type { QuerySubscription } from "../QuerySubscription.js";
+import type { Store } from "../Store.js";
+import type { WhereClauseCanonicalizer } from "../WhereClauseCanonicalizer.js";
+import { ObjectSetQuery } from "./ObjectSetQuery.js";
+import type { ObjectSetQueryOptions } from "./ObjectSetQueryOptions.js";
+export declare class ObjectSetHelper extends AbstractHelper<ObjectSetQuery, ObjectSetQueryOptions> {
+	whereCanonicalizer: WhereClauseCanonicalizer;
+	orderByCanonicalizer: OrderByCanonicalizer;
+	constructor(store: Store, cacheKeys: CacheKeys<KnownCacheKey>, whereCanonicalizer: WhereClauseCanonicalizer, orderByCanonicalizer: OrderByCanonicalizer);
+	observe(options: ObjectSetQueryOptions, subFn: Observer<ObjectSetPayload>): QuerySubscription<ObjectSetQuery>;
+	getQuery(options: ObjectSetQueryOptions): ObjectSetQuery;
+	private buildCanonicalizedOperations;
+}

package/build/types/observable/internal/objectset/ObjectSetHelper.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAiBA,cAAc,wBAAwB,2BAA4B;AAClE,cAAc,gBAAgB,kCAAmC;AACjE,SAAS,sBAAsB,sBAAuB;AACtD,cAAc,iBAAiB,iBAAkB;AAEjD,cAAc,qBAAqB,qBAAsB;AACzD,cAAc,4BAA4B,4BAA6B;AACvE,cAAc,yBAAyB,yBAA0B;AACjE,cAAc,aAAa,aAAc;AACzC,cAAc,gCAAgC,gCAAiC;AAK/E,SAAS,sBAAsB,qBAAsB;AACrD,cAAc,6BAA6B,4BAA6B;AAExE,OAAO,cAAM,wBAAwB,eACnC,gBACA,uBACA;CACA,oBAAoB;CACpB,sBAAsB;CAEtB,YACEA,OAAO,OACPC,WAAW,UAAU,gBACrBC,oBAAoB,0BACpBC,sBAAsB;CAQxB,QACEC,SAAS,uBACTC,OAAO,SAAS,oBACf,kBAAkB;CAIrB,SAASD,SAAS,wBAAwB;CAuB1C,QAAQ;AA+CT","names":["store: Store","cacheKeys: CacheKeys<KnownCacheKey>","whereCanonicalizer: WhereClauseCanonicalizer","orderByCanonicalizer: OrderByCanonicalizer","options: ObjectSetQueryOptions","subFn: Observer<ObjectSetPayload>"],"sources":["../../../../../src/observable/internal/objectset/ObjectSetHelper.ts"],"version":3,"file":"ObjectSetHelper.d.ts"}

package/build/types/observable/internal/objectset/ObjectSetQuery.d.ts

@@ -0,0 +1,34 @@
+import type { Osdk, PageResult } from "@osdk/api";
+import type { Observable } from "rxjs";
+import type { ObjectSetPayload } from "../../ObjectSetPayload.js";
+import type { Status } from "../../ObservableClient/common.js";
+import { BaseListQuery } from "../base-list/BaseListQuery.js";
+import type { BatchContext } from "../BatchContext.js";
+import type { Canonical } from "../Canonical.js";
+import type { Changes } from "../Changes.js";
+import type { Entry } from "../Layer.js";
+import type { Store } from "../Store.js";
+import type { SubjectPayload } from "../SubjectPayload.js";
+import type { ObjectSetCacheKey, ObjectSetOperations } from "./ObjectSetCacheKey.js";
+import type { ObjectSetQueryOptions } from "./ObjectSetQueryOptions.js";
+export declare class ObjectSetQuery extends BaseListQuery<ObjectSetCacheKey, ObjectSetPayload, ObjectSetQueryOptions> {
+	#private;
+	constructor(store: Store, subject: Observable<SubjectPayload<ObjectSetCacheKey>>, baseObjectSetWire: string, operations: Canonical<ObjectSetOperations>, cacheKey: ObjectSetCacheKey, opts: ObjectSetQueryOptions);
+	/**
+	* Register changes to the cache specific to ObjectSetQuery
+	*/
+	protected registerCacheChanges(batch: BatchContext): void;
+	/**
+	* Implements fetchPageData from BaseListQuery template method
+	* Fetches a page of data from the composed ObjectSet
+	*/
+	protected fetchPageData(signal: AbortSignal | undefined): Promise<PageResult<Osdk.Instance<any>>>;
+	protected handleFetchError(error: unknown, _status: Status, batch: BatchContext): Entry<ObjectSetCacheKey>;
+	invalidateObjectType: (objectType: string, changes: Changes | undefined) => Promise<void>;
+	protected createPayload(params: {
+		resolvedData: any[]
+		isOptimistic: boolean
+		status: Status
+		lastUpdated: number
+	}): ObjectSetPayload;
+}

package/build/types/observable/internal/objectset/ObjectSetQuery.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAyB,MAAM,kBAAkB,WAAY;AAC7D,cAAc,kBAAkB,MAAO;AAGvC,cAAc,wBAAwB,2BAA4B;AAClE,cAAc,cAAc,kCAAmC;AAC/D,SAAS,qBAAqB,+BAAgC;AAC9D,cAAc,oBAAoB,oBAAqB;AACvD,cAAc,iBAAiB,iBAAkB;AACjD,cAAc,eAAe,eAAgB;AAC7C,cAAc,aAAa,aAAc;AAEzC,cAAc,aAAa,aAAc;AACzC,cAAc,sBAAsB,sBAAuB;AAC3D,cACE,mBACA,2BACK,wBAAyB;AAChC,cAAc,6BAA6B,4BAA6B;AAExE,OAAO,cAAM,uBAAuB,cAClC,mBACA,kBACA,uBACA;;CAMA,YACEA,OAAO,OACPC,SAAS,WAAW,eAAe,qBACnCC,2BACAC,YAAY,UAAU,sBACtBC,UAAU,mBACVC,MAAM;;;;CAqGR,UAAU,qBAAqBC,OAAO;;;;;CAQtC,UAAgB,cACdC,QAAQ,0BACP,QAAQ,WAAW,KAAK;CAqB3B,UAAU,iBACRC,gBACAC,SAAS,QACTH,OAAO,eACN,MAAM;CAOT,uBACEI,oBACAC,SAAS,wBACR;CAQH,UAAU,cACRC,QAAQ;EACN;EACA;EACA,QAAQ;EACR;CACD,IACA;AAWJ","names":["store: Store","subject: Observable<SubjectPayload<ObjectSetCacheKey>>","baseObjectSetWire: string","operations: Canonical<ObjectSetOperations>","cacheKey: ObjectSetCacheKey","opts: ObjectSetQueryOptions","batch: BatchContext","signal: AbortSignal | undefined","error: unknown","_status: Status","objectType: string","changes: Changes | undefined","params: {\n      resolvedData: any[];\n      isOptimistic: boolean;\n      status: Status;\n      lastUpdated: number;\n    }"],"sources":["../../../../../src/observable/internal/objectset/ObjectSetQuery.ts"],"version":3,"file":"ObjectSetQuery.d.ts"}

package/build/types/observable/internal/objectset/ObjectSetQueryOptions.d.ts

@@ -0,0 +1,18 @@
+import type { DerivedProperty, LinkNames, ObjectSet, ObjectTypeDefinition, PropertyKeys, WhereClause, WirePropertyTypes } from "@osdk/api";
+import type { CommonObserveOptions } from "../../ObservableClient/common.js";
+export interface ObserveObjectSetOptions<
+	Q extends ObjectTypeDefinition,
+	RDPs extends Record<string, WirePropertyTypes | undefined | Array<WirePropertyTypes>> = {}
+> extends CommonObserveOptions {
+	where?: WhereClause<Q>;
+	withProperties?: { [K in keyof RDPs] : DerivedProperty.Creator<Q, RDPs[K]> };
+	union?: ObjectSet<Q>[];
+	intersect?: ObjectSet<Q>[];
+	subtract?: ObjectSet<Q>[];
+	pivotTo?: LinkNames<Q>;
+	pageSize?: number;
+	orderBy?: { [K in PropertyKeys<Q>]? : "asc" | "desc" };
+}
+export interface ObjectSetQueryOptions extends ObserveObjectSetOptions<any, any> {
+	baseObjectSet: ObjectSet<any>;
+}

package/build/types/observable/internal/objectset/ObjectSetQueryOptions.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,iBACA,WACA,WACA,sBACA,cACA,aACA,yBACK,WAAY;AACnB,cAAc,4BAA4B,kCAAmC;AAE7E,iBAAiB;CACf,UAAU;CACV,aAAa,eAEX,gCAAgC,MAAM,sBACpC,CAAE;UACE,qBAAqB;CAC7B,QAAQ,YAAY;CACpB,oBAAoB,WAAW,QAAO,gBAAgB,QAAQ,GAAG,KAAK;CACtE,QAAQ,UAAU;CAClB,YAAY,UAAU;CACtB,WAAW,UAAU;CACrB,UAAU,UAAU;CACpB;CACA,aAAa,KAAK,aAAa,OAAM,QAAQ;AAC9C;AAED,iBAAiB,8BACP,kCACV;CACE,eAAe;AAChB","names":[],"sources":["../../../../../src/observable/internal/objectset/ObjectSetQueryOptions.ts"],"version":3,"file":"ObjectSetQueryOptions.d.ts"}