@osdk/react 0.7.0-beta.4 → 0.8.0-beta.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @osdkkit/react
 
+## 0.7.0-beta.5
+
+### Minor Changes
+
+- 7b97128: add useObjectSet hook
+
+### Patch Changes
+
+- Updated dependencies [7b97128]
+  - @osdk/client@2.5.0-beta.11
+  - @osdk/api@2.5.0-beta.11
+
 ## 0.7.0-beta.4
 
 ### Minor Changes

package/build/browser/new/useObjectSet.js

@@ -0,0 +1,77 @@
+/*
+ * 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 { computeObjectSetCacheKey } from "@osdk/client/unstable-do-not-use";
+import React from "react";
+import { makeExternalStore } from "./makeExternalStore.js";
+import { OsdkContext2 } from "./OsdkContext2.js";
+/**
+ * React hook for observing and interacting with OSDK object sets.
+ *
+ * @typeParam Q - The object type definition
+ * @typeParam BaseRDPs - Derived properties that already exist on the input ObjectSet
+ * @typeParam RDPs - New derived properties to be added via options.withProperties
+ *
+ * @param baseObjectSet - The ObjectSet to observe (may already have derived properties)
+ * @param options - Options for filtering, sorting, and adding new derived properties
+ * @returns Object set data with both existing and new derived properties
+ */
+export function useObjectSet(baseObjectSet, options = {}) {
+  const {
+    observableClient
+  } = React.useContext(OsdkContext2);
+
+  // Compute a stable cache key for the ObjectSet and options
+  // dedupeIntervalMs is excluded as it doesn't affect the data, only the refresh rate
+  const stableKey = computeObjectSetCacheKey(baseObjectSet, {
+    where: options.where,
+    withProperties: options.withProperties,
+    union: options.union,
+    intersect: options.intersect,
+    subtract: options.subtract,
+    pivotTo: options.pivotTo,
+    pageSize: options.pageSize,
+    orderBy: options.orderBy
+  });
+  const {
+    subscribe,
+    getSnapShot
+  } = React.useMemo(() => {
+    return makeExternalStore(observer => {
+      const subscription = observableClient.observeObjectSet(baseObjectSet, {
+        where: options.where,
+        withProperties: options.withProperties,
+        union: options.union,
+        intersect: options.intersect,
+        subtract: options.subtract,
+        pivotTo: options.pivotTo,
+        pageSize: options.pageSize,
+        orderBy: options.orderBy,
+        dedupeInterval: options.dedupeIntervalMs ?? 2_000
+      }, observer);
+      return subscription;
+    }, process.env.NODE_ENV !== "production" ? `objectSet ${stableKey}` : void 0);
+  }, [observableClient, stableKey]);
+  const payload = React.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    data: payload?.resolvedList,
+    isLoading: payload?.status === "loading" || !payload && true || false,
+    error: payload && "error" in payload ? payload.error : undefined,
+    fetchMore: payload?.fetchMore,
+    objectSet: payload?.objectSet || baseObjectSet
+  };
+}
+//# sourceMappingURL=useObjectSet.js.map

package/build/browser/new/useObjectSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectSet.js","names":["computeObjectSetCacheKey","React","makeExternalStore","OsdkContext2","useObjectSet","baseObjectSet","options","observableClient","useContext","stableKey","where","withProperties","union","intersect","subtract","pivotTo","pageSize","orderBy","subscribe","getSnapShot","useMemo","observer","subscription","observeObjectSet","dedupeInterval","dedupeIntervalMs","process","env","NODE_ENV","payload","useSyncExternalStore","data","resolvedList","isLoading","status","error","undefined","fetchMore","objectSet"],"sources":["useObjectSet.tsx"],"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  Osdk,\n  PropertyKeys,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\n\nimport {\n  computeObjectSetCacheKey,\n  type ObserveObjectSetArgs,\n} from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ntype SimplePropertyDef =\n  | WirePropertyTypes\n  | undefined\n  | Array<WirePropertyTypes>;\n\nexport interface UseObjectSetOptions<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> {\n  /**\n   * Where clause for filtering\n   */\n  where?: WhereClause<Q>;\n\n  /**\n   * Derived properties to add to the object set\n   */\n  withProperties?: { [K in keyof RDPs]: DerivedProperty.Creator<Q, RDPs[K]> };\n\n  /**\n   * Object sets to union with\n   */\n  union?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to intersect with\n   */\n  intersect?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to subtract from\n   */\n  subtract?: ObjectSet<Q>[];\n\n  /**\n   * Link to pivot to (changes the type)\n   */\n  pivotTo?: LinkNames<Q>;\n\n  /**\n   * The preferred page size for the list\n   */\n  pageSize?: number;\n\n  /**\n   * Sort order for the results\n   */\n  orderBy?: {\n    [K in PropertyKeys<Q>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * Minimum time between fetch requests in milliseconds (defaults to 2000ms)\n   */\n  dedupeIntervalMs?: number;\n}\n\nexport interface UseObjectSetResult<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> {\n  /**\n   * The fetched data with derived properties\n   */\n  data:\n    | Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>[]\n    | undefined;\n\n  /**\n   * Whether data is currently being loaded\n   */\n  isLoading: boolean;\n\n  /**\n   * Any error that occurred during fetching\n   */\n  error: Error | undefined;\n\n  /**\n   * Function to fetch more pages (undefined if no more pages)\n   */\n  fetchMore: (() => Promise<void>) | undefined;\n\n  /**\n   * The final ObjectSet after all transformations\n   */\n  objectSet: ObjectSet<Q, RDPs>;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\n/**\n * React hook for observing and interacting with OSDK object sets.\n *\n * @typeParam Q - The object type definition\n * @typeParam BaseRDPs - Derived properties that already exist on the input ObjectSet\n * @typeParam RDPs - New derived properties to be added via options.withProperties\n *\n * @param baseObjectSet - The ObjectSet to observe (may already have derived properties)\n * @param options - Options for filtering, sorting, and adding new derived properties\n * @returns Object set data with both existing and new derived properties\n */\nexport function useObjectSet<\n  Q extends ObjectTypeDefinition,\n  BaseRDPs extends Record<string, SimplePropertyDef> = never,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n>(\n  baseObjectSet: ObjectSet<Q, BaseRDPs>,\n  options: UseObjectSetOptions<Q, RDPs> = {},\n): UseObjectSetResult<Q, RDPs> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // Compute a stable cache key for the ObjectSet and options\n  // dedupeIntervalMs is excluded as it doesn't affect the data, only the refresh rate\n  const stableKey = computeObjectSetCacheKey(baseObjectSet, {\n    where: options.where,\n    withProperties: options.withProperties,\n    union: options.union,\n    intersect: options.intersect,\n    subtract: options.subtract,\n    pivotTo: options.pivotTo,\n    pageSize: options.pageSize,\n    orderBy: options.orderBy,\n  });\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      return makeExternalStore<ObserveObjectSetArgs<Q, RDPs>>(\n        (observer) => {\n          const subscription = observableClient.observeObjectSet(\n            baseObjectSet as ObjectSet<Q>,\n            {\n              where: options.where,\n              withProperties: options.withProperties,\n              union: options.union,\n              intersect: options.intersect,\n              subtract: options.subtract,\n              pivotTo: options.pivotTo,\n              pageSize: options.pageSize,\n              orderBy: options.orderBy,\n              dedupeInterval: options.dedupeIntervalMs ?? 2_000,\n            },\n            observer,\n          );\n          return subscription;\n        },\n        process.env.NODE_ENV !== \"production\"\n          ? `objectSet ${stableKey}`\n          : void 0,\n      );\n    },\n    [observableClient, stableKey],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return {\n    data: payload?.resolvedList as Osdk.Instance<\n      Q,\n      \"$allBaseProperties\",\n      PropertyKeys<Q>,\n      RDPs\n    >[],\n    isLoading: payload?.status === \"loading\" || (!payload && true) || false,\n    error: payload && \"error\" in payload\n      ? payload.error\n      : undefined,\n    fetchMore: payload?.fetchMore,\n    objectSet: payload?.objectSet as ObjectSet<Q, RDPs> || baseObjectSet,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA,SACEA,wBAAwB,QAEnB,kCAAkC;AACzC,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAiGhD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAK1BC,aAAqC,EACrCC,OAAqC,GAAG,CAAC,CAAC,EACb;EAC7B,MAAM;IAAEC;EAAiB,CAAC,GAAGN,KAAK,CAACO,UAAU,CAACL,YAAY,CAAC;;EAE3D;EACA;EACA,MAAMM,SAAS,GAAGT,wBAAwB,CAACK,aAAa,EAAE;IACxDK,KAAK,EAAEJ,OAAO,CAACI,KAAK;IACpBC,cAAc,EAAEL,OAAO,CAACK,cAAc;IACtCC,KAAK,EAAEN,OAAO,CAACM,KAAK;IACpBC,SAAS,EAAEP,OAAO,CAACO,SAAS;IAC5BC,QAAQ,EAAER,OAAO,CAACQ,QAAQ;IAC1BC,OAAO,EAAET,OAAO,CAACS,OAAO;IACxBC,QAAQ,EAAEV,OAAO,CAACU,QAAQ;IAC1BC,OAAO,EAAEX,OAAO,CAACW;EACnB,CAAC,CAAC;EAEF,MAAM;IAAEC,SAAS;IAAEC;EAAY,CAAC,GAAGlB,KAAK,CAACmB,OAAO,CAC9C,MAAM;IACJ,OAAOlB,iBAAiB,CACrBmB,QAAQ,IAAK;MACZ,MAAMC,YAAY,GAAGf,gBAAgB,CAACgB,gBAAgB,CACpDlB,aAAa,EACb;QACEK,KAAK,EAAEJ,OAAO,CAACI,KAAK;QACpBC,cAAc,EAAEL,OAAO,CAACK,cAAc;QACtCC,KAAK,EAAEN,OAAO,CAACM,KAAK;QACpBC,SAAS,EAAEP,OAAO,CAACO,SAAS;QAC5BC,QAAQ,EAAER,OAAO,CAACQ,QAAQ;QAC1BC,OAAO,EAAET,OAAO,CAACS,OAAO;QACxBC,QAAQ,EAAEV,OAAO,CAACU,QAAQ;QAC1BC,OAAO,EAAEX,OAAO,CAACW,OAAO;QACxBO,cAAc,EAAElB,OAAO,CAACmB,gBAAgB,IAAI;MAC9C,CAAC,EACDJ,QACF,CAAC;MACD,OAAOC,YAAY;IACrB,CAAC,EACDI,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,aAAanB,SAAS,EAAE,GACxB,KAAK,CACX,CAAC;EACH,CAAC,EACD,CAACF,gBAAgB,EAAEE,SAAS,CAC9B,CAAC;EAED,MAAMoB,OAAO,GAAG5B,KAAK,CAAC6B,oBAAoB,CAACZ,SAAS,EAAEC,WAAW,CAAC;EAElE,OAAO;IACLY,IAAI,EAAEF,OAAO,EAAEG,YAKZ;IACHC,SAAS,EAAEJ,OAAO,EAAEK,MAAM,KAAK,SAAS,IAAK,CAACL,OAAO,IAAI,IAAK,IAAI,KAAK;IACvEM,KAAK,EAAEN,OAAO,IAAI,OAAO,IAAIA,OAAO,GAChCA,OAAO,CAACM,KAAK,GACbC,SAAS;IACbC,SAAS,EAAER,OAAO,EAAEQ,SAAS;IAC7BC,SAAS,EAAET,OAAO,EAAES,SAAS,IAA0BjC;EACzD,CAAC;AACH","ignoreList":[]}

package/build/browser/new/useOsdkObject.js

@@ -60,7 +60,7 @@ export function useOsdkObject(...args) {
     isOptimistic: !!payload?.isOptimistic,
     error,
     forceUpdate: () => {
-      throw "not implemented";
+      throw new Error("not implemented");
     }
   };
 }

package/build/browser/new/useOsdkObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","mode","length","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","observer","observeObject","payload","useSyncExternalStore","error","status","Error","object","isLoading","isOptimistic","forceUpdate"],"sources":["useOsdkObject.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, PrimaryKeyType } from \"@osdk/api\";\nimport type { ObserveObjectArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args: [obj: Osdk.Instance<Q>] | [type: Q, primaryKey: PrimaryKeyType<Q>]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = args.length === 1 ? \"offline\" : undefined;\n  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;\n  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObserveObjectArgs<Q>>(\n        (observer) =>\n          observableClient.observeObject(\n            objectType,\n            primaryKey,\n            {\n              mode,\n            },\n            observer,\n          ),\n        `object ${objectType} ${primaryKey}`,\n      ),\n    [observableClient, objectType, primaryKey, mode],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  let error: Error | undefined;\n  if (payload && \"error\" in payload && payload.error) {\n    error = payload.error;\n  } else if (payload?.status === \"error\") {\n    error = new Error(\"Failed to load object\");\n  }\n\n  return {\n    object: payload?.object as Osdk.Instance<Q> | undefined,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: !!payload?.isOptimistic,\n    error,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    },\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;;AAehD;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAAwE,EACnD;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAE3D;EACA,MAAMK,IAAI,GAAGH,IAAI,CAACI,MAAM,KAAK,CAAC,GAAG,SAAS,GAAGC,SAAS;EACtD,MAAMC,UAAU,GAAGN,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACO,WAAW,GAAGP,IAAI,CAAC,CAAC,CAAC,CAACQ,OAAO;EAC5E,MAAMC,UAAU,GAAGT,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACU,WAAW,GAAGV,IAAI,CAAC,CAAC,CAAC;EAEpE,MAAM;IAAEW,SAAS;IAAEC;EAAY,CAAC,GAAGhB,KAAK,CAACiB,OAAO,CAC9C,MACEhB,iBAAiB,CACdiB,QAAQ,IACPb,gBAAgB,CAACc,aAAa,CAC5BT,UAAU,EACVG,UAAU,EACV;IACEN;EACF,CAAC,EACDW,QACF,CAAC,EACH,UAAUR,UAAU,IAAIG,UAAU,EACpC,CAAC,EACH,CAACR,gBAAgB,EAAEK,UAAU,EAAEG,UAAU,EAAEN,IAAI,CACjD,CAAC;EAED,MAAMa,OAAO,GAAGpB,KAAK,CAACqB,oBAAoB,CAACN,SAAS,EAAEC,WAAW,CAAC;EAElE,IAAIM,KAAwB;EAC5B,IAAIF,OAAO,IAAI,OAAO,IAAIA,OAAO,IAAIA,OAAO,CAACE,KAAK,EAAE;IAClDA,KAAK,GAAGF,OAAO,CAACE,KAAK;EACvB,CAAC,MAAM,IAAIF,OAAO,EAAEG,MAAM,KAAK,OAAO,EAAE;IACtCD,KAAK,GAAG,IAAIE,KAAK,CAAC,uBAAuB,CAAC;EAC5C;EAEA,OAAO;IACLC,MAAM,EAAEL,OAAO,EAAEK,MAAsC;IACvDC,SAAS,EAAEN,OAAO,EAAEG,MAAM,KAAK,SAAS;IACxCI,YAAY,EAAE,CAAC,CAACP,OAAO,EAAEO,YAAY;IACrCL,KAAK;IACLM,WAAW,EAAEA,CAAA,KAAM;MACjB,MAAM,iBAAiB;IACzB;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","mode","length","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","observer","observeObject","payload","useSyncExternalStore","error","status","Error","object","isLoading","isOptimistic","forceUpdate"],"sources":["useOsdkObject.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, PrimaryKeyType } from \"@osdk/api\";\nimport type { ObserveObjectArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args: [obj: Osdk.Instance<Q>] | [type: Q, primaryKey: PrimaryKeyType<Q>]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = args.length === 1 ? \"offline\" : undefined;\n  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;\n  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObserveObjectArgs<Q>>(\n        (observer) =>\n          observableClient.observeObject(\n            objectType,\n            primaryKey,\n            {\n              mode,\n            },\n            observer,\n          ),\n        `object ${objectType} ${primaryKey}`,\n      ),\n    [observableClient, objectType, primaryKey, mode],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  let error: Error | undefined;\n  if (payload && \"error\" in payload && payload.error) {\n    error = payload.error;\n  } else if (payload?.status === \"error\") {\n    error = new Error(\"Failed to load object\");\n  }\n\n  return {\n    object: payload?.object as Osdk.Instance<Q> | undefined,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: !!payload?.isOptimistic,\n    error,\n    forceUpdate: () => {\n      throw new Error(\"not implemented\");\n    },\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;;AAehD;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAAwE,EACnD;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAE3D;EACA,MAAMK,IAAI,GAAGH,IAAI,CAACI,MAAM,KAAK,CAAC,GAAG,SAAS,GAAGC,SAAS;EACtD,MAAMC,UAAU,GAAGN,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACO,WAAW,GAAGP,IAAI,CAAC,CAAC,CAAC,CAACQ,OAAO;EAC5E,MAAMC,UAAU,GAAGT,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACU,WAAW,GAAGV,IAAI,CAAC,CAAC,CAAC;EAEpE,MAAM;IAAEW,SAAS;IAAEC;EAAY,CAAC,GAAGhB,KAAK,CAACiB,OAAO,CAC9C,MACEhB,iBAAiB,CACdiB,QAAQ,IACPb,gBAAgB,CAACc,aAAa,CAC5BT,UAAU,EACVG,UAAU,EACV;IACEN;EACF,CAAC,EACDW,QACF,CAAC,EACH,UAAUR,UAAU,IAAIG,UAAU,EACpC,CAAC,EACH,CAACR,gBAAgB,EAAEK,UAAU,EAAEG,UAAU,EAAEN,IAAI,CACjD,CAAC;EAED,MAAMa,OAAO,GAAGpB,KAAK,CAACqB,oBAAoB,CAACN,SAAS,EAAEC,WAAW,CAAC;EAElE,IAAIM,KAAwB;EAC5B,IAAIF,OAAO,IAAI,OAAO,IAAIA,OAAO,IAAIA,OAAO,CAACE,KAAK,EAAE;IAClDA,KAAK,GAAGF,OAAO,CAACE,KAAK;EACvB,CAAC,MAAM,IAAIF,OAAO,EAAEG,MAAM,KAAK,OAAO,EAAE;IACtCD,KAAK,GAAG,IAAIE,KAAK,CAAC,uBAAuB,CAAC;EAC5C;EAEA,OAAO;IACLC,MAAM,EAAEL,OAAO,EAAEK,MAAsC;IACvDC,SAAS,EAAEN,OAAO,EAAEG,MAAM,KAAK,SAAS;IACxCI,YAAY,EAAE,CAAC,CAACP,OAAO,EAAEO,YAAY;IACrCL,KAAK;IACLM,WAAW,EAAEA,CAAA,KAAM;MACjB,MAAM,IAAIJ,KAAK,CAAC,iBAAiB,CAAC;IACpC;EACF,CAAC;AACH","ignoreList":[]}

package/build/browser/public/experimental.js

@@ -16,6 +16,7 @@
 
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
 export { useLinks } from "../new/useLinks.js";
+export { useObjectSet } from "../new/useObjectSet.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
 export { useOsdkObjects } from "../new/useOsdkObjects.js";

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

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["OsdkProvider2","useLinks","useOsdkAction","useOsdkObject","useOsdkObjects","useOsdkClient","useOsdkMetadata"],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { OsdkProvider2 } from \"../new/OsdkProvider2.js\";\nexport { useLinks } from \"../new/useLinks.js\";\nexport { useOsdkAction } from \"../new/useOsdkAction.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport type { UseOsdkListResult } from \"../new/useOsdkObjects.js\";\nexport { useOsdkObjects } from \"../new/useOsdkObjects.js\";\nexport { useOsdkClient } from \"../useOsdkClient.js\";\nexport { useOsdkMetadata } from \"../useOsdkMetadata.js\";\nexport type { UseOsdkMetadataResult } from \"../useOsdkMetadata.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,yBAAyB;AACvD,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AAEvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB;AACnD,SAASC,eAAe,QAAQ,uBAAuB","ignoreList":[]}
+{"version":3,"file":"experimental.js","names":["OsdkProvider2","useLinks","useObjectSet","useOsdkAction","useOsdkObject","useOsdkObjects","useOsdkClient","useOsdkMetadata"],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { OsdkProvider2 } from \"../new/OsdkProvider2.js\";\nexport { useLinks } from \"../new/useLinks.js\";\nexport { useObjectSet } from \"../new/useObjectSet.js\";\nexport { useOsdkAction } from \"../new/useOsdkAction.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport type { UseOsdkListResult } from \"../new/useOsdkObjects.js\";\nexport { useOsdkObjects } from \"../new/useOsdkObjects.js\";\nexport { useOsdkClient } from \"../useOsdkClient.js\";\nexport { useOsdkMetadata } from \"../useOsdkMetadata.js\";\nexport type { UseOsdkMetadataResult } from \"../useOsdkMetadata.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,yBAAyB;AACvD,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,YAAY,QAAQ,wBAAwB;AACrD,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AAEvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB;AACnD,SAASC,eAAe,QAAQ,uBAAuB","ignoreList":[]}

package/build/cjs/public/experimental.cjs

@@ -2,12 +2,12 @@
 
 var chunkOVBG5VXE_cjs = require('../chunk-OVBG5VXE.cjs');
 var unstableDoNotUse = require('@osdk/client/unstable-do-not-use');
-var React4 = require('react');
+var React5 = require('react');
 var client = require('@osdk/client');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var React4__default = /*#__PURE__*/_interopDefault(React4);
+var React5__default = /*#__PURE__*/_interopDefault(React5);
 
 function fakeClientFn(..._args) {
   throw new Error("This is not a real client. Did you forget to <OsdkContext.Provider>?");
@@ -15,7 +15,7 @@ function fakeClientFn(..._args) {
 var fakeClient = Object.assign(fakeClientFn, {
   fetchMetadata: fakeClientFn
 });
-var OsdkContext2 = /* @__PURE__ */ React4__default.default.createContext({
+var OsdkContext2 = /* @__PURE__ */ React5__default.default.createContext({
   client: fakeClient,
   observableClient: void 0
 });
@@ -26,13 +26,13 @@ function OsdkProvider2({
   client,
   observableClient
 }) {
-  observableClient = React4.useMemo(() => observableClient ?? unstableDoNotUse.createObservableClient(client), [client, observableClient]);
-  return /* @__PURE__ */ React4__default.default.createElement(OsdkContext2.Provider, {
+  observableClient = React5.useMemo(() => observableClient ?? unstableDoNotUse.createObservableClient(client), [client, observableClient]);
+  return /* @__PURE__ */ React5__default.default.createElement(OsdkContext2.Provider, {
     value: {
       client,
       observableClient
     }
-  }, /* @__PURE__ */ React4__default.default.createElement(chunkOVBG5VXE_cjs.OsdkContext.Provider, {
+  }, /* @__PURE__ */ React5__default.default.createElement(chunkOVBG5VXE_cjs.OsdkContext.Provider, {
     value: {
       client
     }
@@ -76,14 +76,14 @@ var emptyArray = Object.freeze([]);
 function useLinks(objects, linkName, options = {}) {
   const {
     observableClient
-  } = React4__default.default.useContext(OsdkContext2);
-  const objectsArray = React4__default.default.useMemo(() => {
+  } = React5__default.default.useContext(OsdkContext2);
+  const objectsArray = React5__default.default.useMemo(() => {
     return objects === void 0 ? emptyArray : Array.isArray(objects) ? objects : [objects];
   }, [objects]);
   const {
     subscribe,
     getSnapShot
-  } = React4__default.default.useMemo(() => {
+  } = React5__default.default.useMemo(() => {
     return makeExternalStore((observer) => observableClient.observeLinks(objectsArray, linkName, {
       linkName,
       where: options.where,
@@ -92,7 +92,7 @@ function useLinks(objects, linkName, options = {}) {
       mode: options.mode
     }, observer), `links ${linkName} for ${objectsArray.map((obj) => `${obj.$apiName}:${obj.$primaryKey}`).join(",")}`);
   }, [observableClient, objectsArray, linkName, options.where, options.pageSize, options.orderBy, options.mode]);
-  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  const payload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
   return {
     links: payload?.resolvedList,
     isLoading: payload?.status === "loading",
@@ -102,17 +102,59 @@ function useLinks(objects, linkName, options = {}) {
     hasMore: payload?.hasMore ?? false
   };
 }
+function useObjectSet(baseObjectSet, options = {}) {
+  const {
+    observableClient
+  } = React5__default.default.useContext(OsdkContext2);
+  const stableKey = unstableDoNotUse.computeObjectSetCacheKey(baseObjectSet, {
+    where: options.where,
+    withProperties: options.withProperties,
+    union: options.union,
+    intersect: options.intersect,
+    subtract: options.subtract,
+    pivotTo: options.pivotTo,
+    pageSize: options.pageSize,
+    orderBy: options.orderBy
+  });
+  const {
+    subscribe,
+    getSnapShot
+  } = React5__default.default.useMemo(() => {
+    return makeExternalStore((observer) => {
+      const subscription = observableClient.observeObjectSet(baseObjectSet, {
+        where: options.where,
+        withProperties: options.withProperties,
+        union: options.union,
+        intersect: options.intersect,
+        subtract: options.subtract,
+        pivotTo: options.pivotTo,
+        pageSize: options.pageSize,
+        orderBy: options.orderBy,
+        dedupeInterval: options.dedupeIntervalMs ?? 2e3
+      }, observer);
+      return subscription;
+    }, process.env.NODE_ENV !== "production" ? `objectSet ${stableKey}` : void 0);
+  }, [observableClient, stableKey]);
+  const payload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    data: payload?.resolvedList,
+    isLoading: payload?.status === "loading" || !payload && true || false,
+    error: payload && "error" in payload ? payload.error : void 0,
+    fetchMore: payload?.fetchMore,
+    objectSet: payload?.objectSet || baseObjectSet
+  };
+}
 function useOsdkAction(actionDef) {
   const {
     observableClient
-  } = React4__default.default.useContext(OsdkContext2);
-  const [error, setError] = React4__default.default.useState();
-  const [data, setData] = React4__default.default.useState();
-  const [isPending, setPending] = React4__default.default.useState(false);
-  const [isValidating, setValidating] = React4__default.default.useState(false);
-  const [validationResult, setValidationResult] = React4__default.default.useState();
-  const abortControllerRef = React4__default.default.useRef(null);
-  const applyAction = React4__default.default.useCallback(async function applyAction2(hookArgs) {
+  } = React5__default.default.useContext(OsdkContext2);
+  const [error, setError] = React5__default.default.useState();
+  const [data, setData] = React5__default.default.useState();
+  const [isPending, setPending] = React5__default.default.useState(false);
+  const [isValidating, setValidating] = React5__default.default.useState(false);
+  const [validationResult, setValidationResult] = React5__default.default.useState();
+  const abortControllerRef = React5__default.default.useRef(null);
+  const applyAction = React5__default.default.useCallback(async function applyAction2(hookArgs) {
     try {
       if (isValidating && abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -166,7 +208,7 @@ function useOsdkAction(actionDef) {
       setPending(false);
     }
   }, [observableClient, actionDef, isValidating]);
-  const validateAction = React4__default.default.useCallback(async function validateAction2(args) {
+  const validateAction = React5__default.default.useCallback(async function validateAction2(args) {
     try {
       if (isPending) {
         return void 0;
@@ -202,7 +244,7 @@ function useOsdkAction(actionDef) {
       setValidating(false);
     }
   }, [observableClient, actionDef, isPending]);
-  React4__default.default.useEffect(() => {
+  React5__default.default.useEffect(() => {
     return () => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -222,17 +264,17 @@ function useOsdkAction(actionDef) {
 function useOsdkObject(...args) {
   const {
     observableClient
-  } = React4__default.default.useContext(OsdkContext2);
+  } = React5__default.default.useContext(OsdkContext2);
   const mode = args.length === 1 ? "offline" : void 0;
   const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;
   const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];
   const {
     subscribe,
     getSnapShot
-  } = React4__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeObject(objectType, primaryKey, {
+  } = React5__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeObject(objectType, primaryKey, {
     mode
   }, observer)), [observableClient, objectType, primaryKey, mode]);
-  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  const payload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
   let error;
   if (payload && "error" in payload && payload.error) {
     error = payload.error;
@@ -245,7 +287,7 @@ function useOsdkObject(...args) {
     isOptimistic: !!payload?.isOptimistic,
     error,
     forceUpdate: () => {
-      throw "not implemented";
+      throw new Error("not implemented");
     }
   };
 }
@@ -258,12 +300,12 @@ function useOsdkObjects(type, {
 } = {}) {
   const {
     observableClient
-  } = React4__default.default.useContext(OsdkContext2);
+  } = React5__default.default.useContext(OsdkContext2);
   const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
   const {
     subscribe,
     getSnapShot
-  } = React4__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeList({
+  } = React5__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeList({
     type,
     where: canonWhere,
     dedupeInterval: dedupeIntervalMs ?? 2e3,
@@ -271,7 +313,7 @@ function useOsdkObjects(type, {
     orderBy,
     streamUpdates
   }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type, canonWhere, dedupeIntervalMs]);
-  const listPayload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  const listPayload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
   let error;
   if (listPayload && "error" in listPayload && listPayload.error) {
     error = listPayload.error;
@@ -297,6 +339,7 @@ Object.defineProperty(exports, "useOsdkMetadata", {
 });
 exports.OsdkProvider2 = OsdkProvider2;
 exports.useLinks = useLinks;
+exports.useObjectSet = useObjectSet;
 exports.useOsdkAction = useOsdkAction;
 exports.useOsdkObject = useOsdkObject;
 exports.useOsdkObjects = useOsdkObjects;

package/build/cjs/public/experimental.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/new/OsdkContext2.ts","../../../src/new/OsdkProvider2.tsx","../../../src/new/makeExternalStore.ts","../../../src/new/useLinks.ts","../../../src/new/useOsdkAction.ts","../../../src/new/useOsdkObject.ts","../../../src/new/useOsdkObjects.ts"],"names":["useMemo","createObservableClient","React","OsdkContext","applyAction","args","ActionValidationError","validateAction"],"mappings":"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","file":"experimental.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nfunction fakeClientFn(..._args) {\n  throw new Error(\"This is not a real client. Did you forget to <OsdkContext.Provider>?\");\n}\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn\n});\nexport const OsdkContext2 = /*#__PURE__*/React.createContext({\n  client: fakeClient,\n  observableClient: undefined\n});","/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React, { useMemo } from \"react\";\nimport { OsdkContext } from \"../OsdkContext.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function OsdkProvider2({\n  children,\n  client,\n  observableClient\n}) {\n  observableClient = useMemo(() => observableClient ?? createObservableClient(client), [client, observableClient]);\n  return /*#__PURE__*/React.createElement(OsdkContext2.Provider, {\n    value: {\n      client,\n      observableClient\n    }\n  }, /*#__PURE__*/React.createElement(OsdkContext.Provider, {\n    value: {\n      client\n    }\n  }, children));\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function makeExternalStore(createObservation, name) {\n  let lastResult;\n  function getSnapShot() {\n    return lastResult;\n  }\n  function subscribe(notifyUpdate) {\n    const obs = createObservation({\n      next: payload => {\n        lastResult = payload;\n        notifyUpdate();\n      },\n      error: error => {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error))\n        };\n        notifyUpdate();\n      },\n      complete: () => {}\n    });\n    return () => {\n      obs.unsubscribe();\n    };\n  }\n  return {\n    subscribe,\n    getSnapShot\n  };\n}","/*\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 React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nconst emptyArray = Object.freeze([]);\n\n/**\n * Hook to observe links from an object or array of objects.\n *\n * @param objects The source object(s) to observe links from\n * @param linkName The name of the link to observe\n * @param options Optional configuration for the link query\n * @returns UseLinksResult with links data and metadata\n */\nexport function useLinks(objects, linkName, options = {}) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  // Convert single object to array for consistent handling\n  const objectsArray = React.useMemo(() => {\n    return objects === undefined ? emptyArray : Array.isArray(objects) ? objects : [objects];\n  }, [objects]);\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => {\n    return makeExternalStore(observer => observableClient.observeLinks(objectsArray, linkName, {\n      linkName,\n      where: options.where,\n      pageSize: options.pageSize,\n      orderBy: options.orderBy,\n      mode: options.mode\n    }, observer), `links ${linkName} for ${objectsArray.map(obj => `${obj.$apiName}:${obj.$primaryKey}`).join(\",\")}`);\n  }, [observableClient, objectsArray, linkName, options.where, options.pageSize, options.orderBy, options.mode]);\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n  return {\n    links: payload?.resolvedList,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    error: payload?.error,\n    fetchMore: payload?.fetchMore,\n    hasMore: payload?.hasMore ?? false\n  };\n}","/*\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 { ActionValidationError } from \"@osdk/client\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function useOsdkAction(actionDef) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n  const [error, setError] = React.useState();\n  const [data, setData] = React.useState();\n  const [isPending, setPending] = React.useState(false);\n  const [isValidating, setValidating] = React.useState(false);\n  const [validationResult, setValidationResult] = React.useState();\n  const abortControllerRef = React.useRef(null);\n  const applyAction = React.useCallback(async function applyAction(hookArgs) {\n    try {\n      // If validation is in progress, abort it\n      if (isValidating && abortControllerRef.current) {\n        abortControllerRef.current.abort();\n        setValidating(false);\n      }\n      setPending(true);\n      setError(undefined);\n      if (Array.isArray(hookArgs)) {\n        const updates = [];\n        const args = hookArgs.map(a => {\n          const {\n            $optimisticUpdate,\n            ...args\n          } = a;\n          if ($optimisticUpdate) {\n            updates.push($optimisticUpdate);\n          }\n          return args;\n        });\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: ctx => {\n            for (const update of updates) {\n              update?.(ctx);\n            }\n          }\n        });\n        setData(r);\n        return r;\n      } else {\n        const {\n          $optimisticUpdate,\n          ...args\n        } = hookArgs;\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: $optimisticUpdate\n        });\n        setData(r);\n        return r;\n      }\n    } catch (e) {\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e\n        });\n      } else {\n        setError({\n          unknown: e\n        });\n      }\n    } finally {\n      setPending(false);\n    }\n  }, [observableClient, actionDef, isValidating]);\n  const validateAction = React.useCallback(async function validateAction(args) {\n    try {\n      // Check if action is being applied\n      if (isPending) {\n        return undefined;\n      }\n\n      // Abort any existing validation\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n\n      // Create new AbortController\n      const abortController = new AbortController();\n      abortControllerRef.current = abortController;\n      setValidating(true);\n      setError(undefined);\n      const result = await observableClient.validateAction(actionDef, args);\n\n      // Check if aborted\n      if (abortController.signal.aborted) {\n        return undefined;\n      }\n      setValidationResult(result);\n      return result;\n    } catch (e) {\n      // Check if it was aborted\n      if (e instanceof Error && e.name === \"AbortError\") {\n        return undefined;\n      }\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e\n        });\n      } else {\n        setError({\n          unknown: e\n        });\n      }\n      throw e;\n    } finally {\n      setValidating(false);\n    }\n  }, [observableClient, actionDef, isPending]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n    };\n  }, []);\n  return {\n    applyAction,\n    validateAction,\n    error,\n    data,\n    isPending,\n    isValidating,\n    validationResult\n  };\n}","/*\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 React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\n\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\n\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject(...args) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = args.length === 1 ? \"offline\" : undefined;\n  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;\n  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeObject(objectType, primaryKey, {\n    mode\n  }, observer), `object ${objectType} ${primaryKey}`), [observableClient, objectType, primaryKey, mode]);\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n  let error;\n  if (payload && \"error\" in payload && payload.error) {\n    error = payload.error;\n  } else if (payload?.status === \"error\") {\n    error = new Error(\"Failed to load object\");\n  }\n  return {\n    object: payload?.object,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: !!payload?.isOptimistic,\n    error,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    }\n  };\n}","/*\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 React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function useOsdkObjects(type, {\n  pageSize,\n  orderBy,\n  dedupeIntervalMs,\n  where = {},\n  streamUpdates\n} = {}) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  /*  We want the canonical where clause so that the use of `React.useMemo`\n      is stable. No real added cost as we canonicalize internal to\n      the ObservableClient anyway.\n   */\n  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeList({\n    type,\n    where: canonWhere,\n    dedupeInterval: dedupeIntervalMs ?? 2_000,\n    pageSize,\n    orderBy,\n    streamUpdates\n  }, observer), process.env.NODE_ENV !== \"production\" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type, canonWhere, dedupeIntervalMs]);\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n  let error;\n  if (listPayload && \"error\" in listPayload && listPayload.error) {\n    error = listPayload.error;\n  } else if (listPayload?.status === \"error\") {\n    error = new Error(\"Failed to load objects\");\n  }\n  return {\n    fetchMore: listPayload?.fetchMore,\n    error,\n    data: listPayload?.resolvedList,\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false\n  };\n}"]}
+{"version":3,"sources":["../../../src/new/OsdkContext2.ts","../../../src/new/OsdkProvider2.tsx","../../../src/new/makeExternalStore.ts","../../../src/new/useLinks.ts","../../../src/new/useObjectSet.tsx","../../../src/new/useOsdkAction.ts","../../../src/new/useOsdkObject.ts","../../../src/new/useOsdkObjects.ts"],"names":["useMemo","createObservableClient","React","OsdkContext","computeObjectSetCacheKey","applyAction","args","ActionValidationError","validateAction"],"mappings":"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","file":"experimental.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nfunction fakeClientFn(..._args) {\n  throw new Error(\"This is not a real client. Did you forget to <OsdkContext.Provider>?\");\n}\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn\n});\nexport const OsdkContext2 = /*#__PURE__*/React.createContext({\n  client: fakeClient,\n  observableClient: undefined\n});","/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React, { useMemo } from \"react\";\nimport { OsdkContext } from \"../OsdkContext.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function OsdkProvider2({\n  children,\n  client,\n  observableClient\n}) {\n  observableClient = useMemo(() => observableClient ?? createObservableClient(client), [client, observableClient]);\n  return /*#__PURE__*/React.createElement(OsdkContext2.Provider, {\n    value: {\n      client,\n      observableClient\n    }\n  }, /*#__PURE__*/React.createElement(OsdkContext.Provider, {\n    value: {\n      client\n    }\n  }, children));\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function makeExternalStore(createObservation, name) {\n  let lastResult;\n  function getSnapShot() {\n    return lastResult;\n  }\n  function subscribe(notifyUpdate) {\n    const obs = createObservation({\n      next: payload => {\n        lastResult = payload;\n        notifyUpdate();\n      },\n      error: error => {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error))\n        };\n        notifyUpdate();\n      },\n      complete: () => {}\n    });\n    return () => {\n      obs.unsubscribe();\n    };\n  }\n  return {\n    subscribe,\n    getSnapShot\n  };\n}","/*\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 React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nconst emptyArray = Object.freeze([]);\n\n/**\n * Hook to observe links from an object or array of objects.\n *\n * @param objects The source object(s) to observe links from\n * @param linkName The name of the link to observe\n * @param options Optional configuration for the link query\n * @returns UseLinksResult with links data and metadata\n */\nexport function useLinks(objects, linkName, options = {}) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  // Convert single object to array for consistent handling\n  const objectsArray = React.useMemo(() => {\n    return objects === undefined ? emptyArray : Array.isArray(objects) ? objects : [objects];\n  }, [objects]);\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => {\n    return makeExternalStore(observer => observableClient.observeLinks(objectsArray, linkName, {\n      linkName,\n      where: options.where,\n      pageSize: options.pageSize,\n      orderBy: options.orderBy,\n      mode: options.mode\n    }, observer), `links ${linkName} for ${objectsArray.map(obj => `${obj.$apiName}:${obj.$primaryKey}`).join(\",\")}`);\n  }, [observableClient, objectsArray, linkName, options.where, options.pageSize, options.orderBy, options.mode]);\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n  return {\n    links: payload?.resolvedList,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    error: payload?.error,\n    fetchMore: payload?.fetchMore,\n    hasMore: payload?.hasMore ?? false\n  };\n}","/*\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 { computeObjectSetCacheKey } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n/**\n * React hook for observing and interacting with OSDK object sets.\n *\n * @typeParam Q - The object type definition\n * @typeParam BaseRDPs - Derived properties that already exist on the input ObjectSet\n * @typeParam RDPs - New derived properties to be added via options.withProperties\n *\n * @param baseObjectSet - The ObjectSet to observe (may already have derived properties)\n * @param options - Options for filtering, sorting, and adding new derived properties\n * @returns Object set data with both existing and new derived properties\n */\nexport function useObjectSet(baseObjectSet, options = {}) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  // Compute a stable cache key for the ObjectSet and options\n  // dedupeIntervalMs is excluded as it doesn't affect the data, only the refresh rate\n  const stableKey = computeObjectSetCacheKey(baseObjectSet, {\n    where: options.where,\n    withProperties: options.withProperties,\n    union: options.union,\n    intersect: options.intersect,\n    subtract: options.subtract,\n    pivotTo: options.pivotTo,\n    pageSize: options.pageSize,\n    orderBy: options.orderBy\n  });\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => {\n    return makeExternalStore(observer => {\n      const subscription = observableClient.observeObjectSet(baseObjectSet, {\n        where: options.where,\n        withProperties: options.withProperties,\n        union: options.union,\n        intersect: options.intersect,\n        subtract: options.subtract,\n        pivotTo: options.pivotTo,\n        pageSize: options.pageSize,\n        orderBy: options.orderBy,\n        dedupeInterval: options.dedupeIntervalMs ?? 2_000\n      }, observer);\n      return subscription;\n    }, process.env.NODE_ENV !== \"production\" ? `objectSet ${stableKey}` : void 0);\n  }, [observableClient, stableKey]);\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n  return {\n    data: payload?.resolvedList,\n    isLoading: payload?.status === \"loading\" || !payload && true || false,\n    error: payload && \"error\" in payload ? payload.error : undefined,\n    fetchMore: payload?.fetchMore,\n    objectSet: payload?.objectSet || baseObjectSet\n  };\n}","/*\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 { ActionValidationError } from \"@osdk/client\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function useOsdkAction(actionDef) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n  const [error, setError] = React.useState();\n  const [data, setData] = React.useState();\n  const [isPending, setPending] = React.useState(false);\n  const [isValidating, setValidating] = React.useState(false);\n  const [validationResult, setValidationResult] = React.useState();\n  const abortControllerRef = React.useRef(null);\n  const applyAction = React.useCallback(async function applyAction(hookArgs) {\n    try {\n      // If validation is in progress, abort it\n      if (isValidating && abortControllerRef.current) {\n        abortControllerRef.current.abort();\n        setValidating(false);\n      }\n      setPending(true);\n      setError(undefined);\n      if (Array.isArray(hookArgs)) {\n        const updates = [];\n        const args = hookArgs.map(a => {\n          const {\n            $optimisticUpdate,\n            ...args\n          } = a;\n          if ($optimisticUpdate) {\n            updates.push($optimisticUpdate);\n          }\n          return args;\n        });\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: ctx => {\n            for (const update of updates) {\n              update?.(ctx);\n            }\n          }\n        });\n        setData(r);\n        return r;\n      } else {\n        const {\n          $optimisticUpdate,\n          ...args\n        } = hookArgs;\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: $optimisticUpdate\n        });\n        setData(r);\n        return r;\n      }\n    } catch (e) {\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e\n        });\n      } else {\n        setError({\n          unknown: e\n        });\n      }\n    } finally {\n      setPending(false);\n    }\n  }, [observableClient, actionDef, isValidating]);\n  const validateAction = React.useCallback(async function validateAction(args) {\n    try {\n      // Check if action is being applied\n      if (isPending) {\n        return undefined;\n      }\n\n      // Abort any existing validation\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n\n      // Create new AbortController\n      const abortController = new AbortController();\n      abortControllerRef.current = abortController;\n      setValidating(true);\n      setError(undefined);\n      const result = await observableClient.validateAction(actionDef, args);\n\n      // Check if aborted\n      if (abortController.signal.aborted) {\n        return undefined;\n      }\n      setValidationResult(result);\n      return result;\n    } catch (e) {\n      // Check if it was aborted\n      if (e instanceof Error && e.name === \"AbortError\") {\n        return undefined;\n      }\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e\n        });\n      } else {\n        setError({\n          unknown: e\n        });\n      }\n      throw e;\n    } finally {\n      setValidating(false);\n    }\n  }, [observableClient, actionDef, isPending]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n    };\n  }, []);\n  return {\n    applyAction,\n    validateAction,\n    error,\n    data,\n    isPending,\n    isValidating,\n    validationResult\n  };\n}","/*\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 React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\n\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\n\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject(...args) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = args.length === 1 ? \"offline\" : undefined;\n  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;\n  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeObject(objectType, primaryKey, {\n    mode\n  }, observer), `object ${objectType} ${primaryKey}`), [observableClient, objectType, primaryKey, mode]);\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n  let error;\n  if (payload && \"error\" in payload && payload.error) {\n    error = payload.error;\n  } else if (payload?.status === \"error\") {\n    error = new Error(\"Failed to load object\");\n  }\n  return {\n    object: payload?.object,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: !!payload?.isOptimistic,\n    error,\n    forceUpdate: () => {\n      throw new Error(\"not implemented\");\n    }\n  };\n}","/*\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 React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function useOsdkObjects(type, {\n  pageSize,\n  orderBy,\n  dedupeIntervalMs,\n  where = {},\n  streamUpdates\n} = {}) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  /*  We want the canonical where clause so that the use of `React.useMemo`\n      is stable. No real added cost as we canonicalize internal to\n      the ObservableClient anyway.\n   */\n  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeList({\n    type,\n    where: canonWhere,\n    dedupeInterval: dedupeIntervalMs ?? 2_000,\n    pageSize,\n    orderBy,\n    streamUpdates\n  }, observer), process.env.NODE_ENV !== \"production\" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type, canonWhere, dedupeIntervalMs]);\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n  let error;\n  if (listPayload && \"error\" in listPayload && listPayload.error) {\n    error = listPayload.error;\n  } else if (listPayload?.status === \"error\") {\n    error = new Error(\"Failed to load objects\");\n  }\n  return {\n    fetchMore: listPayload?.fetchMore,\n    error,\n    data: listPayload?.resolvedList,\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false\n  };\n}"]}

package/build/cjs/public/experimental.d.cts

@@ -1,7 +1,7 @@
 import { Client, ObjectTypeDefinition, Osdk, InterfaceDefinition, WhereClause, PropertyKeys, ActionDefinition, ActionValidationError, ActionValidationResponse } from '@osdk/client';
 import { ObservableClient, ActionSignatureFromDef } from '@osdk/client/unstable-do-not-use';
 import React from 'react';
-import { LinkNames, LinkedType, ObjectTypeDefinition as ObjectTypeDefinition$1, Osdk as Osdk$1, PrimaryKeyType } from '@osdk/api';
+import { LinkNames, LinkedType, ObjectTypeDefinition as ObjectTypeDefinition$1, WirePropertyTypes, ObjectSet, WhereClause as WhereClause$1, DerivedProperty, PropertyKeys as PropertyKeys$1, Osdk as Osdk$1, PrimaryKeyType } from '@osdk/api';
 export { U as UseOsdkMetadataResult, u as useOsdkClient, a as useOsdkMetadata } from '../useOsdkMetadata-DFZhnhGZ.cjs';
 
 interface OsdkProviderOptions {
@@ -59,6 +59,84 @@ interface UseLinksResult<Q extends ObjectTypeDefinition | InterfaceDefinition> {
  */
 declare function useLinks<T extends ObjectTypeDefinition, L extends LinkNames<T>>(objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined, linkName: L, options?: UseLinksOptions<LinkedType<T, L>>): UseLinksResult<LinkedType<T, L>>;
 
+type SimplePropertyDef = WirePropertyTypes | undefined | Array<WirePropertyTypes>;
+interface UseObjectSetOptions<Q extends ObjectTypeDefinition$1, RDPs extends Record<string, SimplePropertyDef> = {}> {
+    /**
+     * Where clause for filtering
+     */
+    where?: WhereClause$1<Q>;
+    /**
+     * Derived properties to add to the object set
+     */
+    withProperties?: {
+        [K in keyof RDPs]: DerivedProperty.Creator<Q, RDPs[K]>;
+    };
+    /**
+     * Object sets to union with
+     */
+    union?: ObjectSet<Q>[];
+    /**
+     * Object sets to intersect with
+     */
+    intersect?: ObjectSet<Q>[];
+    /**
+     * Object sets to subtract from
+     */
+    subtract?: ObjectSet<Q>[];
+    /**
+     * Link to pivot to (changes the type)
+     */
+    pivotTo?: LinkNames<Q>;
+    /**
+     * The preferred page size for the list
+     */
+    pageSize?: number;
+    /**
+     * Sort order for the results
+     */
+    orderBy?: {
+        [K in PropertyKeys$1<Q>]?: "asc" | "desc";
+    };
+    /**
+     * Minimum time between fetch requests in milliseconds (defaults to 2000ms)
+     */
+    dedupeIntervalMs?: number;
+}
+interface UseObjectSetResult<Q extends ObjectTypeDefinition$1, RDPs extends Record<string, SimplePropertyDef> = {}> {
+    /**
+     * The fetched data with derived properties
+     */
+    data: Osdk$1.Instance<Q, "$allBaseProperties", PropertyKeys$1<Q>, RDPs>[] | undefined;
+    /**
+     * Whether data is currently being loaded
+     */
+    isLoading: boolean;
+    /**
+     * Any error that occurred during fetching
+     */
+    error: Error | undefined;
+    /**
+     * Function to fetch more pages (undefined if no more pages)
+     */
+    fetchMore: (() => Promise<void>) | undefined;
+    /**
+     * The final ObjectSet after all transformations
+     */
+    objectSet: ObjectSet<Q, RDPs>;
+}
+/**
+ * React hook for observing and interacting with OSDK object sets.
+ *
+ * @typeParam Q - The object type definition
+ * @typeParam BaseRDPs - Derived properties that already exist on the input ObjectSet
+ * @typeParam RDPs - New derived properties to be added via options.withProperties
+ *
+ * @param baseObjectSet - The ObjectSet to observe (may already have derived properties)
+ * @param options - Options for filtering, sorting, and adding new derived properties
+ * @returns Object set data with both existing and new derived properties
+ */
+declare function useObjectSet<Q extends ObjectTypeDefinition$1, BaseRDPs extends Record<string, SimplePropertyDef> = never, RDPs extends Record<string, SimplePropertyDef> = {}>(baseObjectSet: ObjectSet<Q, BaseRDPs>, options?: UseObjectSetOptions<Q, RDPs>): UseObjectSetResult<Q, RDPs>;
+
 type ApplyActionParams<Q extends ActionDefinition<any>> = Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0] & {
     [K in keyof ObservableClient.ApplyActionOptions as `$${K}`]: ObservableClient.ApplyActionOptions[K];
 };
@@ -173,4 +251,4 @@ interface UseOsdkListResult<T extends ObjectTypeDefinition | InterfaceDefinition
 }
 declare function useOsdkObjects<Q extends ObjectTypeDefinition | InterfaceDefinition>(type: Q, { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates, }?: UseOsdkObjectsOptions<Q>): UseOsdkListResult<Q>;
 
-export { OsdkProvider2, type UseOsdkListResult, useLinks, useOsdkAction, useOsdkObject, useOsdkObjects };
+export { OsdkProvider2, type UseOsdkListResult, useLinks, useObjectSet, useOsdkAction, useOsdkObject, useOsdkObjects };

package/build/esm/new/useObjectSet.js

@@ -0,0 +1,77 @@
+/*
+ * 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 { computeObjectSetCacheKey } from "@osdk/client/unstable-do-not-use";
+import React from "react";
+import { makeExternalStore } from "./makeExternalStore.js";
+import { OsdkContext2 } from "./OsdkContext2.js";
+/**
+ * React hook for observing and interacting with OSDK object sets.
+ *
+ * @typeParam Q - The object type definition
+ * @typeParam BaseRDPs - Derived properties that already exist on the input ObjectSet
+ * @typeParam RDPs - New derived properties to be added via options.withProperties
+ *
+ * @param baseObjectSet - The ObjectSet to observe (may already have derived properties)
+ * @param options - Options for filtering, sorting, and adding new derived properties
+ * @returns Object set data with both existing and new derived properties
+ */
+export function useObjectSet(baseObjectSet, options = {}) {
+  const {
+    observableClient
+  } = React.useContext(OsdkContext2);
+
+  // Compute a stable cache key for the ObjectSet and options
+  // dedupeIntervalMs is excluded as it doesn't affect the data, only the refresh rate
+  const stableKey = computeObjectSetCacheKey(baseObjectSet, {
+    where: options.where,
+    withProperties: options.withProperties,
+    union: options.union,
+    intersect: options.intersect,
+    subtract: options.subtract,
+    pivotTo: options.pivotTo,
+    pageSize: options.pageSize,
+    orderBy: options.orderBy
+  });
+  const {
+    subscribe,
+    getSnapShot
+  } = React.useMemo(() => {
+    return makeExternalStore(observer => {
+      const subscription = observableClient.observeObjectSet(baseObjectSet, {
+        where: options.where,
+        withProperties: options.withProperties,
+        union: options.union,
+        intersect: options.intersect,
+        subtract: options.subtract,
+        pivotTo: options.pivotTo,
+        pageSize: options.pageSize,
+        orderBy: options.orderBy,
+        dedupeInterval: options.dedupeIntervalMs ?? 2_000
+      }, observer);
+      return subscription;
+    }, process.env.NODE_ENV !== "production" ? `objectSet ${stableKey}` : void 0);
+  }, [observableClient, stableKey]);
+  const payload = React.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    data: payload?.resolvedList,
+    isLoading: payload?.status === "loading" || !payload && true || false,
+    error: payload && "error" in payload ? payload.error : undefined,
+    fetchMore: payload?.fetchMore,
+    objectSet: payload?.objectSet || baseObjectSet
+  };
+}
+//# sourceMappingURL=useObjectSet.js.map

package/build/esm/new/useObjectSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useObjectSet.js","names":["computeObjectSetCacheKey","React","makeExternalStore","OsdkContext2","useObjectSet","baseObjectSet","options","observableClient","useContext","stableKey","where","withProperties","union","intersect","subtract","pivotTo","pageSize","orderBy","subscribe","getSnapShot","useMemo","observer","subscription","observeObjectSet","dedupeInterval","dedupeIntervalMs","process","env","NODE_ENV","payload","useSyncExternalStore","data","resolvedList","isLoading","status","error","undefined","fetchMore","objectSet"],"sources":["useObjectSet.tsx"],"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  Osdk,\n  PropertyKeys,\n  WhereClause,\n  WirePropertyTypes,\n} from \"@osdk/api\";\n\nimport {\n  computeObjectSetCacheKey,\n  type ObserveObjectSetArgs,\n} from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ntype SimplePropertyDef =\n  | WirePropertyTypes\n  | undefined\n  | Array<WirePropertyTypes>;\n\nexport interface UseObjectSetOptions<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> {\n  /**\n   * Where clause for filtering\n   */\n  where?: WhereClause<Q>;\n\n  /**\n   * Derived properties to add to the object set\n   */\n  withProperties?: { [K in keyof RDPs]: DerivedProperty.Creator<Q, RDPs[K]> };\n\n  /**\n   * Object sets to union with\n   */\n  union?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to intersect with\n   */\n  intersect?: ObjectSet<Q>[];\n\n  /**\n   * Object sets to subtract from\n   */\n  subtract?: ObjectSet<Q>[];\n\n  /**\n   * Link to pivot to (changes the type)\n   */\n  pivotTo?: LinkNames<Q>;\n\n  /**\n   * The preferred page size for the list\n   */\n  pageSize?: number;\n\n  /**\n   * Sort order for the results\n   */\n  orderBy?: {\n    [K in PropertyKeys<Q>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * Minimum time between fetch requests in milliseconds (defaults to 2000ms)\n   */\n  dedupeIntervalMs?: number;\n}\n\nexport interface UseObjectSetResult<\n  Q extends ObjectTypeDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> {\n  /**\n   * The fetched data with derived properties\n   */\n  data:\n    | Osdk.Instance<Q, \"$allBaseProperties\", PropertyKeys<Q>, RDPs>[]\n    | undefined;\n\n  /**\n   * Whether data is currently being loaded\n   */\n  isLoading: boolean;\n\n  /**\n   * Any error that occurred during fetching\n   */\n  error: Error | undefined;\n\n  /**\n   * Function to fetch more pages (undefined if no more pages)\n   */\n  fetchMore: (() => Promise<void>) | undefined;\n\n  /**\n   * The final ObjectSet after all transformations\n   */\n  objectSet: ObjectSet<Q, RDPs>;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\n/**\n * React hook for observing and interacting with OSDK object sets.\n *\n * @typeParam Q - The object type definition\n * @typeParam BaseRDPs - Derived properties that already exist on the input ObjectSet\n * @typeParam RDPs - New derived properties to be added via options.withProperties\n *\n * @param baseObjectSet - The ObjectSet to observe (may already have derived properties)\n * @param options - Options for filtering, sorting, and adding new derived properties\n * @returns Object set data with both existing and new derived properties\n */\nexport function useObjectSet<\n  Q extends ObjectTypeDefinition,\n  BaseRDPs extends Record<string, SimplePropertyDef> = never,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n>(\n  baseObjectSet: ObjectSet<Q, BaseRDPs>,\n  options: UseObjectSetOptions<Q, RDPs> = {},\n): UseObjectSetResult<Q, RDPs> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // Compute a stable cache key for the ObjectSet and options\n  // dedupeIntervalMs is excluded as it doesn't affect the data, only the refresh rate\n  const stableKey = computeObjectSetCacheKey(baseObjectSet, {\n    where: options.where,\n    withProperties: options.withProperties,\n    union: options.union,\n    intersect: options.intersect,\n    subtract: options.subtract,\n    pivotTo: options.pivotTo,\n    pageSize: options.pageSize,\n    orderBy: options.orderBy,\n  });\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      return makeExternalStore<ObserveObjectSetArgs<Q, RDPs>>(\n        (observer) => {\n          const subscription = observableClient.observeObjectSet(\n            baseObjectSet as ObjectSet<Q>,\n            {\n              where: options.where,\n              withProperties: options.withProperties,\n              union: options.union,\n              intersect: options.intersect,\n              subtract: options.subtract,\n              pivotTo: options.pivotTo,\n              pageSize: options.pageSize,\n              orderBy: options.orderBy,\n              dedupeInterval: options.dedupeIntervalMs ?? 2_000,\n            },\n            observer,\n          );\n          return subscription;\n        },\n        process.env.NODE_ENV !== \"production\"\n          ? `objectSet ${stableKey}`\n          : void 0,\n      );\n    },\n    [observableClient, stableKey],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return {\n    data: payload?.resolvedList as Osdk.Instance<\n      Q,\n      \"$allBaseProperties\",\n      PropertyKeys<Q>,\n      RDPs\n    >[],\n    isLoading: payload?.status === \"loading\" || (!payload && true) || false,\n    error: payload && \"error\" in payload\n      ? payload.error\n      : undefined,\n    fetchMore: payload?.fetchMore,\n    objectSet: payload?.objectSet as ObjectSet<Q, RDPs> || baseObjectSet,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA,SACEA,wBAAwB,QAEnB,kCAAkC;AACzC,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAiGhD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAK1BC,aAAqC,EACrCC,OAAqC,GAAG,CAAC,CAAC,EACb;EAC7B,MAAM;IAAEC;EAAiB,CAAC,GAAGN,KAAK,CAACO,UAAU,CAACL,YAAY,CAAC;;EAE3D;EACA;EACA,MAAMM,SAAS,GAAGT,wBAAwB,CAACK,aAAa,EAAE;IACxDK,KAAK,EAAEJ,OAAO,CAACI,KAAK;IACpBC,cAAc,EAAEL,OAAO,CAACK,cAAc;IACtCC,KAAK,EAAEN,OAAO,CAACM,KAAK;IACpBC,SAAS,EAAEP,OAAO,CAACO,SAAS;IAC5BC,QAAQ,EAAER,OAAO,CAACQ,QAAQ;IAC1BC,OAAO,EAAET,OAAO,CAACS,OAAO;IACxBC,QAAQ,EAAEV,OAAO,CAACU,QAAQ;IAC1BC,OAAO,EAAEX,OAAO,CAACW;EACnB,CAAC,CAAC;EAEF,MAAM;IAAEC,SAAS;IAAEC;EAAY,CAAC,GAAGlB,KAAK,CAACmB,OAAO,CAC9C,MAAM;IACJ,OAAOlB,iBAAiB,CACrBmB,QAAQ,IAAK;MACZ,MAAMC,YAAY,GAAGf,gBAAgB,CAACgB,gBAAgB,CACpDlB,aAAa,EACb;QACEK,KAAK,EAAEJ,OAAO,CAACI,KAAK;QACpBC,cAAc,EAAEL,OAAO,CAACK,cAAc;QACtCC,KAAK,EAAEN,OAAO,CAACM,KAAK;QACpBC,SAAS,EAAEP,OAAO,CAACO,SAAS;QAC5BC,QAAQ,EAAER,OAAO,CAACQ,QAAQ;QAC1BC,OAAO,EAAET,OAAO,CAACS,OAAO;QACxBC,QAAQ,EAAEV,OAAO,CAACU,QAAQ;QAC1BC,OAAO,EAAEX,OAAO,CAACW,OAAO;QACxBO,cAAc,EAAElB,OAAO,CAACmB,gBAAgB,IAAI;MAC9C,CAAC,EACDJ,QACF,CAAC;MACD,OAAOC,YAAY;IACrB,CAAC,EACDI,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,aAAanB,SAAS,EAAE,GACxB,KAAK,CACX,CAAC;EACH,CAAC,EACD,CAACF,gBAAgB,EAAEE,SAAS,CAC9B,CAAC;EAED,MAAMoB,OAAO,GAAG5B,KAAK,CAAC6B,oBAAoB,CAACZ,SAAS,EAAEC,WAAW,CAAC;EAElE,OAAO;IACLY,IAAI,EAAEF,OAAO,EAAEG,YAKZ;IACHC,SAAS,EAAEJ,OAAO,EAAEK,MAAM,KAAK,SAAS,IAAK,CAACL,OAAO,IAAI,IAAK,IAAI,KAAK;IACvEM,KAAK,EAAEN,OAAO,IAAI,OAAO,IAAIA,OAAO,GAChCA,OAAO,CAACM,KAAK,GACbC,SAAS;IACbC,SAAS,EAAER,OAAO,EAAEQ,SAAS;IAC7BC,SAAS,EAAET,OAAO,EAAES,SAAS,IAA0BjC;EACzD,CAAC;AACH","ignoreList":[]}

package/build/esm/new/useOsdkObject.js

@@ -60,7 +60,7 @@ export function useOsdkObject(...args) {
     isOptimistic: !!payload?.isOptimistic,
     error,
     forceUpdate: () => {
-      throw "not implemented";
+      throw new Error("not implemented");
     }
   };
 }

package/build/esm/new/useOsdkObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","mode","length","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","observer","observeObject","payload","useSyncExternalStore","error","status","Error","object","isLoading","isOptimistic","forceUpdate"],"sources":["useOsdkObject.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, PrimaryKeyType } from \"@osdk/api\";\nimport type { ObserveObjectArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args: [obj: Osdk.Instance<Q>] | [type: Q, primaryKey: PrimaryKeyType<Q>]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = args.length === 1 ? \"offline\" : undefined;\n  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;\n  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObserveObjectArgs<Q>>(\n        (observer) =>\n          observableClient.observeObject(\n            objectType,\n            primaryKey,\n            {\n              mode,\n            },\n            observer,\n          ),\n        `object ${objectType} ${primaryKey}`,\n      ),\n    [observableClient, objectType, primaryKey, mode],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  let error: Error | undefined;\n  if (payload && \"error\" in payload && payload.error) {\n    error = payload.error;\n  } else if (payload?.status === \"error\") {\n    error = new Error(\"Failed to load object\");\n  }\n\n  return {\n    object: payload?.object as Osdk.Instance<Q> | undefined,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: !!payload?.isOptimistic,\n    error,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    },\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;;AAehD;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAAwE,EACnD;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAE3D;EACA,MAAMK,IAAI,GAAGH,IAAI,CAACI,MAAM,KAAK,CAAC,GAAG,SAAS,GAAGC,SAAS;EACtD,MAAMC,UAAU,GAAGN,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACO,WAAW,GAAGP,IAAI,CAAC,CAAC,CAAC,CAACQ,OAAO;EAC5E,MAAMC,UAAU,GAAGT,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACU,WAAW,GAAGV,IAAI,CAAC,CAAC,CAAC;EAEpE,MAAM;IAAEW,SAAS;IAAEC;EAAY,CAAC,GAAGhB,KAAK,CAACiB,OAAO,CAC9C,MACEhB,iBAAiB,CACdiB,QAAQ,IACPb,gBAAgB,CAACc,aAAa,CAC5BT,UAAU,EACVG,UAAU,EACV;IACEN;EACF,CAAC,EACDW,QACF,CAAC,EACH,UAAUR,UAAU,IAAIG,UAAU,EACpC,CAAC,EACH,CAACR,gBAAgB,EAAEK,UAAU,EAAEG,UAAU,EAAEN,IAAI,CACjD,CAAC;EAED,MAAMa,OAAO,GAAGpB,KAAK,CAACqB,oBAAoB,CAACN,SAAS,EAAEC,WAAW,CAAC;EAElE,IAAIM,KAAwB;EAC5B,IAAIF,OAAO,IAAI,OAAO,IAAIA,OAAO,IAAIA,OAAO,CAACE,KAAK,EAAE;IAClDA,KAAK,GAAGF,OAAO,CAACE,KAAK;EACvB,CAAC,MAAM,IAAIF,OAAO,EAAEG,MAAM,KAAK,OAAO,EAAE;IACtCD,KAAK,GAAG,IAAIE,KAAK,CAAC,uBAAuB,CAAC;EAC5C;EAEA,OAAO;IACLC,MAAM,EAAEL,OAAO,EAAEK,MAAsC;IACvDC,SAAS,EAAEN,OAAO,EAAEG,MAAM,KAAK,SAAS;IACxCI,YAAY,EAAE,CAAC,CAACP,OAAO,EAAEO,YAAY;IACrCL,KAAK;IACLM,WAAW,EAAEA,CAAA,KAAM;MACjB,MAAM,iBAAiB;IACzB;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","mode","length","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","observer","observeObject","payload","useSyncExternalStore","error","status","Error","object","isLoading","isOptimistic","forceUpdate"],"sources":["useOsdkObject.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, PrimaryKeyType } from \"@osdk/api\";\nimport type { ObserveObjectArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args: [obj: Osdk.Instance<Q>] | [type: Q, primaryKey: PrimaryKeyType<Q>]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = args.length === 1 ? \"offline\" : undefined;\n  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;\n  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObserveObjectArgs<Q>>(\n        (observer) =>\n          observableClient.observeObject(\n            objectType,\n            primaryKey,\n            {\n              mode,\n            },\n            observer,\n          ),\n        `object ${objectType} ${primaryKey}`,\n      ),\n    [observableClient, objectType, primaryKey, mode],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  let error: Error | undefined;\n  if (payload && \"error\" in payload && payload.error) {\n    error = payload.error;\n  } else if (payload?.status === \"error\") {\n    error = new Error(\"Failed to load object\");\n  }\n\n  return {\n    object: payload?.object as Osdk.Instance<Q> | undefined,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: !!payload?.isOptimistic,\n    error,\n    forceUpdate: () => {\n      throw new Error(\"not implemented\");\n    },\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;;AAehD;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAAwE,EACnD;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAE3D;EACA,MAAMK,IAAI,GAAGH,IAAI,CAACI,MAAM,KAAK,CAAC,GAAG,SAAS,GAAGC,SAAS;EACtD,MAAMC,UAAU,GAAGN,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACO,WAAW,GAAGP,IAAI,CAAC,CAAC,CAAC,CAACQ,OAAO;EAC5E,MAAMC,UAAU,GAAGT,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACU,WAAW,GAAGV,IAAI,CAAC,CAAC,CAAC;EAEpE,MAAM;IAAEW,SAAS;IAAEC;EAAY,CAAC,GAAGhB,KAAK,CAACiB,OAAO,CAC9C,MACEhB,iBAAiB,CACdiB,QAAQ,IACPb,gBAAgB,CAACc,aAAa,CAC5BT,UAAU,EACVG,UAAU,EACV;IACEN;EACF,CAAC,EACDW,QACF,CAAC,EACH,UAAUR,UAAU,IAAIG,UAAU,EACpC,CAAC,EACH,CAACR,gBAAgB,EAAEK,UAAU,EAAEG,UAAU,EAAEN,IAAI,CACjD,CAAC;EAED,MAAMa,OAAO,GAAGpB,KAAK,CAACqB,oBAAoB,CAACN,SAAS,EAAEC,WAAW,CAAC;EAElE,IAAIM,KAAwB;EAC5B,IAAIF,OAAO,IAAI,OAAO,IAAIA,OAAO,IAAIA,OAAO,CAACE,KAAK,EAAE;IAClDA,KAAK,GAAGF,OAAO,CAACE,KAAK;EACvB,CAAC,MAAM,IAAIF,OAAO,EAAEG,MAAM,KAAK,OAAO,EAAE;IACtCD,KAAK,GAAG,IAAIE,KAAK,CAAC,uBAAuB,CAAC;EAC5C;EAEA,OAAO;IACLC,MAAM,EAAEL,OAAO,EAAEK,MAAsC;IACvDC,SAAS,EAAEN,OAAO,EAAEG,MAAM,KAAK,SAAS;IACxCI,YAAY,EAAE,CAAC,CAACP,OAAO,EAAEO,YAAY;IACrCL,KAAK;IACLM,WAAW,EAAEA,CAAA,KAAM;MACjB,MAAM,IAAIJ,KAAK,CAAC,iBAAiB,CAAC;IACpC;EACF,CAAC;AACH","ignoreList":[]}

package/build/esm/public/experimental.js

@@ -16,6 +16,7 @@
 
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
 export { useLinks } from "../new/useLinks.js";
+export { useObjectSet } from "../new/useObjectSet.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
 export { useOsdkObjects } from "../new/useOsdkObjects.js";

package/build/esm/public/experimental.js.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["OsdkProvider2","useLinks","useOsdkAction","useOsdkObject","useOsdkObjects","useOsdkClient","useOsdkMetadata"],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { OsdkProvider2 } from \"../new/OsdkProvider2.js\";\nexport { useLinks } from \"../new/useLinks.js\";\nexport { useOsdkAction } from \"../new/useOsdkAction.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport type { UseOsdkListResult } from \"../new/useOsdkObjects.js\";\nexport { useOsdkObjects } from \"../new/useOsdkObjects.js\";\nexport { useOsdkClient } from \"../useOsdkClient.js\";\nexport { useOsdkMetadata } from \"../useOsdkMetadata.js\";\nexport type { UseOsdkMetadataResult } from \"../useOsdkMetadata.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,yBAAyB;AACvD,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AAEvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB;AACnD,SAASC,eAAe,QAAQ,uBAAuB","ignoreList":[]}
+{"version":3,"file":"experimental.js","names":["OsdkProvider2","useLinks","useObjectSet","useOsdkAction","useOsdkObject","useOsdkObjects","useOsdkClient","useOsdkMetadata"],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { OsdkProvider2 } from \"../new/OsdkProvider2.js\";\nexport { useLinks } from \"../new/useLinks.js\";\nexport { useObjectSet } from \"../new/useObjectSet.js\";\nexport { useOsdkAction } from \"../new/useOsdkAction.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport type { UseOsdkListResult } from \"../new/useOsdkObjects.js\";\nexport { useOsdkObjects } from \"../new/useOsdkObjects.js\";\nexport { useOsdkClient } from \"../useOsdkClient.js\";\nexport { useOsdkMetadata } from \"../useOsdkMetadata.js\";\nexport type { UseOsdkMetadataResult } from \"../useOsdkMetadata.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,yBAAyB;AACvD,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,YAAY,QAAQ,wBAAwB;AACrD,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AAEvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB;AACnD,SAASC,eAAe,QAAQ,uBAAuB","ignoreList":[]}

package/build/types/new/useObjectSet.d.ts

@@ -0,0 +1,85 @@
+import type { DerivedProperty, LinkNames, ObjectSet, ObjectTypeDefinition, Osdk, PropertyKeys, WhereClause, WirePropertyTypes } from "@osdk/api";
+type SimplePropertyDef = WirePropertyTypes | undefined | Array<WirePropertyTypes>;
+export interface UseObjectSetOptions<
+	Q extends ObjectTypeDefinition,
+	RDPs extends Record<string, SimplePropertyDef> = {}
+> {
+	/**
+	* Where clause for filtering
+	*/
+	where?: WhereClause<Q>;
+	/**
+	* Derived properties to add to the object set
+	*/
+	withProperties?: { [K in keyof RDPs] : DerivedProperty.Creator<Q, RDPs[K]> };
+	/**
+	* Object sets to union with
+	*/
+	union?: ObjectSet<Q>[];
+	/**
+	* Object sets to intersect with
+	*/
+	intersect?: ObjectSet<Q>[];
+	/**
+	* Object sets to subtract from
+	*/
+	subtract?: ObjectSet<Q>[];
+	/**
+	* Link to pivot to (changes the type)
+	*/
+	pivotTo?: LinkNames<Q>;
+	/**
+	* The preferred page size for the list
+	*/
+	pageSize?: number;
+	/**
+	* Sort order for the results
+	*/
+	orderBy?: { [K in PropertyKeys<Q>]? : "asc" | "desc" };
+	/**
+	* Minimum time between fetch requests in milliseconds (defaults to 2000ms)
+	*/
+	dedupeIntervalMs?: number;
+}
+export interface UseObjectSetResult<
+	Q extends ObjectTypeDefinition,
+	RDPs extends Record<string, SimplePropertyDef> = {}
+> {
+	/**
+	* The fetched data with derived properties
+	*/
+	data: Osdk.Instance<Q, "$allBaseProperties", PropertyKeys<Q>, RDPs>[] | undefined;
+	/**
+	* Whether data is currently being loaded
+	*/
+	isLoading: boolean;
+	/**
+	* Any error that occurred during fetching
+	*/
+	error: Error | undefined;
+	/**
+	* Function to fetch more pages (undefined if no more pages)
+	*/
+	fetchMore: (() => Promise<void>) | undefined;
+	/**
+	* The final ObjectSet after all transformations
+	*/
+	objectSet: ObjectSet<Q, RDPs>;
+}
+/**
+* React hook for observing and interacting with OSDK object sets.
+*
+* @typeParam Q - The object type definition
+* @typeParam BaseRDPs - Derived properties that already exist on the input ObjectSet
+* @typeParam RDPs - New derived properties to be added via options.withProperties
+*
+* @param baseObjectSet - The ObjectSet to observe (may already have derived properties)
+* @param options - Options for filtering, sorting, and adding new derived properties
+* @returns Object set data with both existing and new derived properties
+*/
+export declare function useObjectSet<
+	Q extends ObjectTypeDefinition,
+	BaseRDPs extends Record<string, SimplePropertyDef> = never,
+	RDPs extends Record<string, SimplePropertyDef> = {}
+>(baseObjectSet: ObjectSet<Q, BaseRDPs>, options?: UseObjectSetOptions<Q, RDPs>): UseObjectSetResult<Q, RDPs>;
+export {};

package/build/types/new/useObjectSet.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,iBACA,WACA,WACA,sBACA,MACA,cACA,aACA,yBACK,WAAY;KAUd,oBACD,gCAEA,MAAM;AAEV,iBAAiB;CACf,UAAU;CACV,aAAa,eAAe,qBAAqB,CAAE;EACnD;;;;CAIA,QAAQ,YAAY;;;;CAKpB,oBAAoB,WAAW,QAAO,gBAAgB,QAAQ,GAAG,KAAK;;;;CAKtE,QAAQ,UAAU;;;;CAKlB,YAAY,UAAU;;;;CAKtB,WAAW,UAAU;;;;CAKrB,UAAU,UAAU;;;;CAKpB;;;;CAKA,aACG,KAAK,aAAa,OAAM,QAAQ;;;;CAMnC;AACD;AAED,iBAAiB;CACf,UAAU;CACV,aAAa,eAAe,qBAAqB,CAAE;EACnD;;;;CAIA,MACI,KAAK,SAAS,GAAG,sBAAsB,aAAa,IAAI;;;;CAM5D;;;;CAKA,OAAO;;;;CAKP,kBAAkB;;;;CAKlB,WAAW,UAAU,GAAG;AACzB;;;;;;;;;;;;AAmBD,OAAO,iBAAS;CACd,UAAU;CACV,iBAAiB,eAAe;CAChC,aAAa,eAAe,qBAAqB,CAAE;EAEnDA,eAAe,UAAU,GAAG,WAC5BC,UAAS,oBAAoB,GAAG,QAC/B,mBAAmB,GAAG","names":["baseObjectSet: ObjectSet<Q, BaseRDPs>","options: UseObjectSetOptions<Q, RDPs>"],"sources":["../../../src/new/useObjectSet.tsx"],"version":3,"file":"useObjectSet.d.ts"}

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

@@ -1,5 +1,6 @@
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
 export { useLinks } from "../new/useLinks.js";
+export { useObjectSet } from "../new/useObjectSet.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
 export type { UseOsdkListResult } from "../new/useOsdkObjects.js";

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

@@ -1 +1 @@
-{"mappings":"AAgBA,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,cAAc,yBAAyB;AACvC,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAChC,cAAc,6BAA6B","names":[],"sources":["../../../src/public/experimental.ts"],"version":3,"file":"experimental.d.ts"}
+{"mappings":"AAgBA,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,cAAc,yBAAyB;AACvC,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAChC,cAAc,6BAA6B","names":[],"sources":["../../../src/public/experimental.ts"],"version":3,"file":"experimental.d.ts"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdk/react",
-  "version": "0.7.0-beta.4",
+  "version": "0.8.0-beta.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -50,10 +50,10 @@
     "react": "^18.3.1",
     "tiny-invariant": "^1.3.3",
     "typescript": "~5.5.4",
-    "@osdk/api": "2.5.0-beta.7",
-    "@osdk/client": "2.5.0-beta.7",
-    "@osdk/monorepo.api-extractor": "~0.4.0-beta.1",
-    "@osdk/monorepo.tsconfig": "~0.4.0-beta.1"
+    "@osdk/api": "2.6.0-beta.1",
+    "@osdk/monorepo.api-extractor": "~0.5.0-beta.1",
+    "@osdk/client": "2.6.0-beta.1",
+    "@osdk/monorepo.tsconfig": "~0.5.0-beta.1"
   },
   "publishConfig": {
     "access": "public"