@osdk/react 0.8.0-beta.1 → 0.8.0-beta.3

package/build/browser/new/useOsdkObject.js

@@ -20,6 +20,7 @@ import { OsdkContext2 } from "./OsdkContext2.js";
 
 /**
  * @param obj an existing `Osdk.Instance` object to get metadata for.
+ * @param enabled Enable or disable the query (defaults to true)
  */
 
 /**
@@ -27,6 +28,7 @@ import { OsdkContext2 } from "./OsdkContext2.js";
  *
  * @param type
  * @param primaryKey
+ * @param enabled Enable or disable the query (defaults to true)
  */
 
 /*
@@ -37,16 +39,31 @@ export function useOsdkObject(...args) {
     observableClient
   } = React.useContext(OsdkContext2);
 
+  // Check if first arg is an instance to discriminate signatures
+  // TypeScript cannot narrow rest parameter unions with optional parameters,
+  // so we must use type assertions after runtime discrimination
+  const isInstanceSignature = "$objectType" in args[0];
+
+  // Extract enabled flag - 2nd param for instance signature, 3rd for type signature
+  const enabled = isInstanceSignature ? typeof args[1] === "boolean" ? args[1] : true : typeof args[2] === "boolean" ? args[2] : true;
+
   // TODO: Figure out what the correct default behavior is for the various scenarios
-  const mode = args.length === 1 ? "offline" : undefined;
-  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;
-  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];
+  const mode = isInstanceSignature ? "offline" : undefined;
+  const objectType = isInstanceSignature ? args[0].$objectType : args[0].apiName;
+  const primaryKey = isInstanceSignature ? args[0].$primaryKey : args[1];
   const {
     subscribe,
     getSnapShot
-  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeObject(objectType, primaryKey, {
-    mode
-  }, observer), `object ${objectType} ${primaryKey}`), [observableClient, objectType, primaryKey, mode]);
+  } = React.useMemo(() => {
+    if (!enabled) {
+      return makeExternalStore(() => ({
+        unsubscribe: () => {}
+      }), `object ${objectType} ${primaryKey} [DISABLED]`);
+    }
+    return makeExternalStore(observer => observableClient.observeObject(objectType, primaryKey, {
+      mode
+    }, observer), `object ${objectType} ${primaryKey}`);
+  }, [enabled, observableClient, objectType, primaryKey, mode]);
   const payload = React.useSyncExternalStore(subscribe, getSnapShot);
   let error;
   if (payload && "error" in payload && payload.error) {

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 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":[]}
+{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","isInstanceSignature","enabled","mode","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","unsubscribe","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 * @param enabled Enable or disable the query (defaults to true)\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n  enabled?: boolean,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n * @param enabled Enable or disable the query (defaults to true)\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n  enabled?: boolean,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args:\n    | [obj: Osdk.Instance<Q>, enabled?: boolean]\n    | [type: Q, primaryKey: PrimaryKeyType<Q>, enabled?: boolean]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // Check if first arg is an instance to discriminate signatures\n  // TypeScript cannot narrow rest parameter unions with optional parameters,\n  // so we must use type assertions after runtime discrimination\n  const isInstanceSignature = \"$objectType\" in args[0];\n\n  // Extract enabled flag - 2nd param for instance signature, 3rd for type signature\n  const enabled = isInstanceSignature\n    ? (typeof args[1] === \"boolean\" ? args[1] : true)\n    : (typeof args[2] === \"boolean\" ? args[2] : true);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = isInstanceSignature ? \"offline\" : undefined;\n  const objectType = isInstanceSignature\n    ? (args[0] as Osdk.Instance<Q>).$objectType\n    : (args[0] as Q).apiName;\n  const primaryKey = isInstanceSignature\n    ? (args[0] as Osdk.Instance<Q>).$primaryKey\n    : (args[1] as PrimaryKeyType<Q>);\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      if (!enabled) {\n        return makeExternalStore<ObserveObjectArgs<Q>>(\n          () => ({ unsubscribe: () => {} }),\n          `object ${objectType} ${primaryKey} [DISABLED]`,\n        );\n      }\n      return 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    },\n    [enabled, 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;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAE4D,EACvC;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAE3D;EACA;EACA;EACA,MAAMK,mBAAmB,GAAG,aAAa,IAAIH,IAAI,CAAC,CAAC,CAAC;;EAEpD;EACA,MAAMI,OAAO,GAAGD,mBAAmB,GAC9B,OAAOH,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,GAAGA,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAC7C,OAAOA,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,GAAGA,IAAI,CAAC,CAAC,CAAC,GAAG,IAAK;;EAEnD;EACA,MAAMK,IAAI,GAAGF,mBAAmB,GAAG,SAAS,GAAGG,SAAS;EACxD,MAAMC,UAAU,GAAGJ,mBAAmB,GACjCH,IAAI,CAAC,CAAC,CAAC,CAAsBQ,WAAW,GACxCR,IAAI,CAAC,CAAC,CAAC,CAAOS,OAAO;EAC1B,MAAMC,UAAU,GAAGP,mBAAmB,GACjCH,IAAI,CAAC,CAAC,CAAC,CAAsBW,WAAW,GACxCX,IAAI,CAAC,CAAC,CAAuB;EAElC,MAAM;IAAEY,SAAS;IAAEC;EAAY,CAAC,GAAGjB,KAAK,CAACkB,OAAO,CAC9C,MAAM;IACJ,IAAI,CAACV,OAAO,EAAE;MACZ,OAAOP,iBAAiB,CACtB,OAAO;QAAEkB,WAAW,EAAEA,CAAA,KAAM,CAAC;MAAE,CAAC,CAAC,EACjC,UAAUR,UAAU,IAAIG,UAAU,aACpC,CAAC;IACH;IACA,OAAOb,iBAAiB,CACrBmB,QAAQ,IACPf,gBAAgB,CAACgB,aAAa,CAC5BV,UAAU,EACVG,UAAU,EACV;MACEL;IACF,CAAC,EACDW,QACF,CAAC,EACH,UAAUT,UAAU,IAAIG,UAAU,EACpC,CAAC;EACH,CAAC,EACD,CAACN,OAAO,EAAEH,gBAAgB,EAAEM,UAAU,EAAEG,UAAU,EAAEL,IAAI,CAC1D,CAAC;EAED,MAAMa,OAAO,GAAGtB,KAAK,CAACuB,oBAAoB,CAACP,SAAS,EAAEC,WAAW,CAAC;EAElE,IAAIO,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/new/useOsdkObjects.js

@@ -17,13 +17,19 @@
 import React from "react";
 import { makeExternalStore } from "./makeExternalStore.js";
 import { OsdkContext2 } from "./OsdkContext2.js";
-export function useOsdkObjects(type, {
-  pageSize,
-  orderBy,
-  dedupeIntervalMs,
-  where = {},
-  streamUpdates
-} = {}) {
+export function useOsdkObjects(type, options) {
+  const {
+    pageSize,
+    orderBy,
+    dedupeIntervalMs,
+    where = {},
+    streamUpdates,
+    withProperties,
+    autoFetchMore,
+    intersectWith,
+    pivotTo,
+    enabled = true
+  } = options ?? {};
   const {
     observableClient
   } = React.useContext(OsdkContext2);
@@ -33,17 +39,34 @@ export function useOsdkObjects(type, {
       the ObservableClient anyway.
    */
   const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
+  const stableWithProperties = React.useMemo(() => withProperties, [JSON.stringify(withProperties)]);
+  const stableIntersectWith = React.useMemo(() => intersectWith, [JSON.stringify(intersectWith)]);
   const {
     subscribe,
     getSnapShot
-  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeList({
-    type,
-    where: canonWhere,
-    dedupeInterval: dedupeIntervalMs ?? 2_000,
-    pageSize,
-    orderBy,
-    streamUpdates
-  }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type, canonWhere, dedupeIntervalMs]);
+  } = React.useMemo(() => {
+    if (!enabled) {
+      return makeExternalStore(() => ({
+        unsubscribe: () => {}
+      }), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${JSON.stringify(canonWhere)} [DISABLED]` : void 0);
+    }
+    return makeExternalStore(observer => observableClient.observeList({
+      type,
+      where: canonWhere,
+      dedupeInterval: dedupeIntervalMs ?? 2_000,
+      pageSize,
+      orderBy,
+      streamUpdates,
+      withProperties: stableWithProperties,
+      autoFetchMore,
+      ...(stableIntersectWith ? {
+        intersectWith: stableIntersectWith
+      } : {}),
+      ...(pivotTo ? {
+        pivotTo
+      } : {})
+    }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0);
+  }, [enabled, observableClient, type, canonWhere, dedupeIntervalMs, pageSize, orderBy, streamUpdates, stableWithProperties, autoFetchMore, stableIntersectWith, pivotTo]);
   const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);
   let error;
   if (listPayload && "error" in listPayload && listPayload.error) {

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkObjects.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObjects","type","pageSize","orderBy","dedupeIntervalMs","where","streamUpdates","observableClient","useContext","canonWhere","canonicalizeWhereClause","subscribe","getSnapShot","useMemo","observer","observeList","dedupeInterval","process","env","NODE_ENV","apiName","JSON","stringify","listPayload","useSyncExternalStore","error","status","Error","fetchMore","data","resolvedList","isLoading","isOptimistic"],"sources":["useOsdkObjects.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/client\";\nimport type { ObserveObjectsArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectsOptions<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  /**\n   * Standard OSDK Where\n   */\n  where?: WhereClause<T>;\n\n  /**\n   *  The preferred page size for the list.\n   */\n  pageSize?: number;\n\n  /** */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * Causes the list to automatically fetch more as soon as the previous page\n   * has been loaded. If a number is provided, it will continue to automatically\n   * fetch more until the list is at least that long.\n   */\n  // autoFetchMore?: boolean | number;\n\n  /**\n   * Upon a list being revalidated, this option determines how the component\n   * will be re-rendered with the data.\n   *\n   * An example to help understand the options:\n   *\n   * Suppose pageSize is 10 and we have called `fetchMore()` twice. The list is\n   * now 30 items long.\n   *\n   * Upon revalidation, we get the first 10 items of the list. The options behave\n   * as follows:\n   *\n   * - `\"in-place\"`: The first 10 items of the list are replaced with the new 10\n   *   items. The list is now 30 items long, but only the first 10 items are valid.\n   * - `\"wait\"`: The old list is returned until after the next 20 items are loaded\n   *   (which will happen automatically). The list is now 30 items long.\n   * - `\"reset\"`: The entire list is replaced with the new 10 items. The list is\n   *   now 10 items long.\n   */\n  // invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n\n  /**\n   * The number of milliseconds to wait after the last observed list change.\n   *\n   * Two uses of `useOsdkObjects` with the where clause will only trigger one\n   * network request if the second is within `dedupeIntervalMs`.\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * If provided, the list will be considered this length for the purposes of\n   * `invalidationMode` when using the `wait` option. If not provided,\n   * the internal expectedLength will be determined by the number of times\n   * `fetchMore` has been called.\n   */\n  // expectedLength?: number | undefined;\n\n  streamUpdates?: boolean;\n}\n\nexport interface UseOsdkListResult<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  fetchMore: (() => Promise<unknown>) | undefined;\n  data: Osdk.Instance<T>[] | undefined;\n  isLoading: boolean;\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the ordered list of objects (only considering the $primaryKey)\n   * is optimistic or not.\n   *\n   * If you need to know if the contents of the list are optimistic you can\n   * do that on a per object basis with useOsdkObject\n   */\n  isOptimistic: boolean;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\nexport function useOsdkObjects<\n  Q extends ObjectTypeDefinition | InterfaceDefinition,\n>(\n  type: Q,\n  {\n    pageSize,\n    orderBy,\n    dedupeIntervalMs,\n    where = {},\n    streamUpdates,\n  }: UseOsdkObjectsOptions<Q> = {},\n): UseOsdkListResult<Q> {\n  const { observableClient } = 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\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObserveObjectsArgs<Q>>(\n        (observer) =>\n          observableClient.observeList({\n            type,\n            where: canonWhere,\n            dedupeInterval: dedupeIntervalMs ?? 2_000,\n            pageSize,\n            orderBy,\n            streamUpdates,\n          }, observer),\n        process.env.NODE_ENV !== \"production\"\n          ? `list ${type.apiName} ${JSON.stringify(canonWhere)}`\n          : void 0,\n      ),\n    [observableClient, type, canonWhere, dedupeIntervalMs],\n  );\n\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  let error: Error | undefined;\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\n  return {\n    fetchMore: listPayload?.fetchMore,\n    error,\n    data: listPayload?.resolvedList as Osdk.Instance<Q>[],\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AA2FhD,OAAO,SAASC,cAAcA,CAG5BC,IAAO,EACP;EACEC,QAAQ;EACRC,OAAO;EACPC,gBAAgB;EAChBC,KAAK,GAAG,CAAC,CAAC;EACVC;AACwB,CAAC,GAAG,CAAC,CAAC,EACV;EACtB,MAAM;IAAEC;EAAiB,CAAC,GAAGV,KAAK,CAACW,UAAU,CAACT,YAAY,CAAC;;EAE3D;AACF;AACA;AACA;EACE,MAAMU,UAAU,GAAGF,gBAAgB,CAACG,uBAAuB,CAACL,KAAK,IAAI,CAAC,CAAC,CAAC;EAExE,MAAM;IAAEM,SAAS;IAAEC;EAAY,CAAC,GAAGf,KAAK,CAACgB,OAAO,CAC9C,MACEf,iBAAiB,CACdgB,QAAQ,IACPP,gBAAgB,CAACQ,WAAW,CAAC;IAC3Bd,IAAI;IACJI,KAAK,EAAEI,UAAU;IACjBO,cAAc,EAAEZ,gBAAgB,IAAI,KAAK;IACzCF,QAAQ;IACRC,OAAO;IACPG;EACF,CAAC,EAAEQ,QAAQ,CAAC,EACdG,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,QAAQlB,IAAI,CAACmB,OAAO,IAAIC,IAAI,CAACC,SAAS,CAACb,UAAU,CAAC,EAAE,GACpD,KAAK,CACX,CAAC,EACH,CAACF,gBAAgB,EAAEN,IAAI,EAAEQ,UAAU,EAAEL,gBAAgB,CACvD,CAAC;EAED,MAAMmB,WAAW,GAAG1B,KAAK,CAAC2B,oBAAoB,CAACb,SAAS,EAAEC,WAAW,CAAC;EAEtE,IAAIa,KAAwB;EAC5B,IAAIF,WAAW,IAAI,OAAO,IAAIA,WAAW,IAAIA,WAAW,CAACE,KAAK,EAAE;IAC9DA,KAAK,GAAGF,WAAW,CAACE,KAAK;EAC3B,CAAC,MAAM,IAAIF,WAAW,EAAEG,MAAM,KAAK,OAAO,EAAE;IAC1CD,KAAK,GAAG,IAAIE,KAAK,CAAC,wBAAwB,CAAC;EAC7C;EAEA,OAAO;IACLC,SAAS,EAAEL,WAAW,EAAEK,SAAS;IACjCH,KAAK;IACLI,IAAI,EAAEN,WAAW,EAAEO,YAAkC;IACrDC,SAAS,EAAER,WAAW,EAAEG,MAAM,KAAK,SAAS;IAC5CM,YAAY,EAAET,WAAW,EAAES,YAAY,IAAI;EAC7C,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"useOsdkObjects.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObjects","type","options","pageSize","orderBy","dedupeIntervalMs","where","streamUpdates","withProperties","autoFetchMore","intersectWith","pivotTo","enabled","observableClient","useContext","canonWhere","canonicalizeWhereClause","stableWithProperties","useMemo","JSON","stringify","stableIntersectWith","subscribe","getSnapShot","unsubscribe","process","env","NODE_ENV","apiName","observer","observeList","dedupeInterval","listPayload","useSyncExternalStore","error","status","Error","fetchMore","data","resolvedList","isLoading","isOptimistic"],"sources":["useOsdkObjects.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  DerivedProperty,\n  InterfaceDefinition,\n  LinkedType,\n  LinkNames,\n  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { ObserveObjectsArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nimport type { InferRdpTypes } from \"./types.js\";\n\nexport interface UseOsdkObjectsOptions<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n  WithProps extends DerivedProperty.Clause<T> | undefined = undefined,\n> {\n  /**\n   * Standard OSDK Where with RDP support\n   */\n  where?: WhereClause<T, InferRdpTypes<T, WithProps>>;\n\n  /**\n   *  The preferred page size for the list.\n   */\n  pageSize?: number;\n\n  /** */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * Define derived properties (RDPs) to be computed server-side and attached to each object.\n   * These properties will be available on the returned objects alongside their regular properties.\n   */\n  withProperties?: WithProps;\n\n  /**\n   * Intersect the results with additional object sets.\n   * Each element defines a where clause for an object set to intersect with.\n   * The final result will only include objects that match ALL conditions.\n   */\n  intersectWith?: Array<{\n    where: WhereClause<T, InferRdpTypes<T, WithProps>>;\n  }>;\n\n  /**\n   * Pivot to related objects through a link.\n   * This changes the return type from T to the linked object type.\n   */\n  pivotTo?: LinkNames<T>;\n\n  /**\n   * Causes the list to automatically fetch more as soon as the previous page\n   * has been loaded. If a number is provided, it will continue to automatically\n   * fetch more until the list is at least that long.\n   *\n   * - `true`: Fetch all available pages automatically\n   * - `number`: Fetch pages until at least this many items are loaded\n   * - `undefined` (default): Only fetch the first page, user must call fetchMore()\n   *\n   * Note: When using `autoFetchMore: true` with large datasets, the initial\n   * load may take significant time. Consider using a specific number instead\n   * or implementing virtual scrolling.\n   *\n   * @example\n   * // Fetch all todos at once\n   * const { data } = useOsdkObjects(Todo, { autoFetchMore: true })\n   *\n   * @example\n   * // Fetch at least 100 todos (with 25 per page, fetches 4 pages)\n   * const { data } = useOsdkObjects(Todo, {\n   *   autoFetchMore: 100,\n   *   pageSize: 25\n   * })\n   */\n  autoFetchMore?: boolean | number;\n\n  /**\n   * Upon a list being revalidated, this option determines how the component\n   * will be re-rendered with the data.\n   *\n   * An example to help understand the options:\n   *\n   * Suppose pageSize is 10 and we have called `fetchMore()` twice. The list is\n   * now 30 items long.\n   *\n   * Upon revalidation, we get the first 10 items of the list. The options behave\n   * as follows:\n   *\n   * - `\"in-place\"`: The first 10 items of the list are replaced with the new 10\n   *   items. The list is now 30 items long, but only the first 10 items are valid.\n   * - `\"wait\"`: The old list is returned until after the next 20 items are loaded\n   *   (which will happen automatically). The list is now 30 items long.\n   * - `\"reset\"`: The entire list is replaced with the new 10 items. The list is\n   *   now 10 items long.\n   */\n  // invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n\n  /**\n   * The number of milliseconds to wait after the last observed list change.\n   *\n   * Two uses of `useOsdkObjects` with the where clause will only trigger one\n   * network request if the second is within `dedupeIntervalMs`.\n   */\n  dedupeIntervalMs?: number;\n\n  streamUpdates?: boolean;\n\n  /**\n   * Enable or disable the query.\n   *\n   * When `false`, the query will not automatically execute. It will still\n   * return any cached data, but will not fetch from the server.\n   *\n   * This is useful for:\n   * - Lazy/on-demand queries that should wait for user interaction\n   * - Dependent queries that need data from another query first\n   * - Conditional queries based on component state\n   *\n   * @default true\n   * @example\n   * // Dependent query - wait for parent data\n   * const { data: employee } = useOsdkObject(Employee, employeeId);\n   * const { data: reports } = useOsdkObjects(Employee, {\n   *   where: { managerId: employee?.id },\n   *   enabled: !!employee\n   * });\n   */\n  enabled?: boolean;\n}\n\nexport interface UseOsdkListResult<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  fetchMore: (() => Promise<void>) | undefined;\n  data: Osdk.Instance<T>[] | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the ordered list of objects (only considering the $primaryKey)\n   * is optimistic or not.\n   *\n   * If you need to know if the contents of the list are optimistic you can\n   * do that on a per object basis with useOsdkObject\n   */\n  isOptimistic: boolean;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\nexport function useOsdkObjects<\n  Q extends ObjectTypeDefinition,\n  L extends LinkNames<Q>,\n>(\n  type: Q,\n  options: UseOsdkObjectsOptions<Q> & { pivotTo: L },\n): UseOsdkListResult<LinkedType<Q, L>>;\n\nexport function useOsdkObjects<\n  Q extends ObjectTypeDefinition | InterfaceDefinition,\n  WP extends DerivedProperty.Clause<Q> | undefined,\n>(\n  type: Q,\n  options?: UseOsdkObjectsOptions<Q, WP>,\n): UseOsdkListResult<Q>;\n\nexport function useOsdkObjects<\n  Q extends ObjectTypeDefinition | InterfaceDefinition,\n  WP extends DerivedProperty.Clause<Q> | undefined,\n>(\n  type: Q,\n  options?: UseOsdkObjectsOptions<Q, WP>,\n): UseOsdkListResult<Q> | UseOsdkListResult<LinkedType<Q, LinkNames<Q>>> {\n  const {\n    pageSize,\n    orderBy,\n    dedupeIntervalMs,\n    where = {},\n    streamUpdates,\n    withProperties,\n    autoFetchMore,\n    intersectWith,\n    pivotTo,\n    enabled = true,\n  } = options ?? {};\n  const { observableClient } = 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<Q>(where ?? {});\n\n  const stableWithProperties = React.useMemo(\n    () => withProperties,\n    [JSON.stringify(withProperties)],\n  );\n\n  const stableIntersectWith = React.useMemo(\n    () => intersectWith,\n    [JSON.stringify(intersectWith)],\n  );\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      if (!enabled) {\n        return makeExternalStore<ObserveObjectsArgs<Q>>(\n          () => ({ unsubscribe: () => {} }),\n          process.env.NODE_ENV !== \"production\"\n            ? `list ${type.apiName} ${JSON.stringify(canonWhere)} [DISABLED]`\n            : void 0,\n        );\n      }\n      return makeExternalStore<ObserveObjectsArgs<Q>>(\n        (observer) =>\n          observableClient.observeList({\n            type,\n            where: canonWhere,\n            dedupeInterval: dedupeIntervalMs ?? 2_000,\n            pageSize,\n            orderBy,\n            streamUpdates,\n            withProperties: stableWithProperties,\n            autoFetchMore,\n            ...(stableIntersectWith\n              ? { intersectWith: stableIntersectWith }\n              : {}),\n            ...(pivotTo ? { pivotTo } : {}),\n          }, observer),\n        process.env.NODE_ENV !== \"production\"\n          ? `list ${type.apiName} ${JSON.stringify(canonWhere)}`\n          : void 0,\n      );\n    },\n    [\n      enabled,\n      observableClient,\n      type,\n      canonWhere,\n      dedupeIntervalMs,\n      pageSize,\n      orderBy,\n      streamUpdates,\n      stableWithProperties,\n      autoFetchMore,\n      stableIntersectWith,\n      pivotTo,\n    ],\n  );\n\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  let error: Error | undefined;\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\n  return {\n    fetchMore: listPayload?.fetchMore,\n    error,\n    data: listPayload?.resolvedList,\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAoKhD,OAAO,SAASC,cAAcA,CAI5BC,IAAO,EACPC,OAAsC,EACiC;EACvE,MAAM;IACJC,QAAQ;IACRC,OAAO;IACPC,gBAAgB;IAChBC,KAAK,GAAG,CAAC,CAAC;IACVC,aAAa;IACbC,cAAc;IACdC,aAAa;IACbC,aAAa;IACbC,OAAO;IACPC,OAAO,GAAG;EACZ,CAAC,GAAGV,OAAO,IAAI,CAAC,CAAC;EACjB,MAAM;IAAEW;EAAiB,CAAC,GAAGhB,KAAK,CAACiB,UAAU,CAACf,YAAY,CAAC;;EAE3D;AACF;AACA;AACA;EACE,MAAMgB,UAAU,GAAGF,gBAAgB,CAACG,uBAAuB,CAAIV,KAAK,IAAI,CAAC,CAAC,CAAC;EAE3E,MAAMW,oBAAoB,GAAGpB,KAAK,CAACqB,OAAO,CACxC,MAAMV,cAAc,EACpB,CAACW,IAAI,CAACC,SAAS,CAACZ,cAAc,CAAC,CACjC,CAAC;EAED,MAAMa,mBAAmB,GAAGxB,KAAK,CAACqB,OAAO,CACvC,MAAMR,aAAa,EACnB,CAACS,IAAI,CAACC,SAAS,CAACV,aAAa,CAAC,CAChC,CAAC;EAED,MAAM;IAAEY,SAAS;IAAEC;EAAY,CAAC,GAAG1B,KAAK,CAACqB,OAAO,CAC9C,MAAM;IACJ,IAAI,CAACN,OAAO,EAAE;MACZ,OAAOd,iBAAiB,CACtB,OAAO;QAAE0B,WAAW,EAAEA,CAAA,KAAM,CAAC;MAAE,CAAC,CAAC,EACjCC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,QAAQ1B,IAAI,CAAC2B,OAAO,IAAIT,IAAI,CAACC,SAAS,CAACL,UAAU,CAAC,aAAa,GAC/D,KAAK,CACX,CAAC;IACH;IACA,OAAOjB,iBAAiB,CACrB+B,QAAQ,IACPhB,gBAAgB,CAACiB,WAAW,CAAC;MAC3B7B,IAAI;MACJK,KAAK,EAAES,UAAU;MACjBgB,cAAc,EAAE1B,gBAAgB,IAAI,KAAK;MACzCF,QAAQ;MACRC,OAAO;MACPG,aAAa;MACbC,cAAc,EAAES,oBAAoB;MACpCR,aAAa;MACb,IAAIY,mBAAmB,GACnB;QAAEX,aAAa,EAAEW;MAAoB,CAAC,GACtC,CAAC,CAAC,CAAC;MACP,IAAIV,OAAO,GAAG;QAAEA;MAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC,EAAEkB,QAAQ,CAAC,EACdJ,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,QAAQ1B,IAAI,CAAC2B,OAAO,IAAIT,IAAI,CAACC,SAAS,CAACL,UAAU,CAAC,EAAE,GACpD,KAAK,CACX,CAAC;EACH,CAAC,EACD,CACEH,OAAO,EACPC,gBAAgB,EAChBZ,IAAI,EACJc,UAAU,EACVV,gBAAgB,EAChBF,QAAQ,EACRC,OAAO,EACPG,aAAa,EACbU,oBAAoB,EACpBR,aAAa,EACbY,mBAAmB,EACnBV,OAAO,CAEX,CAAC;EAED,MAAMqB,WAAW,GAAGnC,KAAK,CAACoC,oBAAoB,CAACX,SAAS,EAAEC,WAAW,CAAC;EAEtE,IAAIW,KAAwB;EAC5B,IAAIF,WAAW,IAAI,OAAO,IAAIA,WAAW,IAAIA,WAAW,CAACE,KAAK,EAAE;IAC9DA,KAAK,GAAGF,WAAW,CAACE,KAAK;EAC3B,CAAC,MAAM,IAAIF,WAAW,EAAEG,MAAM,KAAK,OAAO,EAAE;IAC1CD,KAAK,GAAG,IAAIE,KAAK,CAAC,wBAAwB,CAAC;EAC7C;EAEA,OAAO;IACLC,SAAS,EAAEL,WAAW,EAAEK,SAAS;IACjCH,KAAK;IACLI,IAAI,EAAEN,WAAW,EAAEO,YAAY;IAC/BC,SAAS,EAAER,WAAW,EAAEG,MAAM,KAAK,SAAS;IAC5CM,YAAY,EAAET,WAAW,EAAES,YAAY,IAAI;EAC7C,CAAC;AACH","ignoreList":[]}

package/build/browser/public/experimental.js

@@ -18,8 +18,10 @@ 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 { useOsdkAggregation } from "../new/useOsdkAggregation.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
 export { useOsdkObjects } from "../new/useOsdkObjects.js";
 export { useOsdkClient } from "../useOsdkClient.js";
 export { useOsdkMetadata } from "../useOsdkMetadata.js";
+export { useDebouncedCallback } from "../utils/useDebouncedCallback.js";
 //# sourceMappingURL=experimental.js.map

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

@@ -1 +1 @@
-{"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":[]}
+{"version":3,"file":"experimental.js","names":["OsdkProvider2","useLinks","useObjectSet","useOsdkAction","useOsdkAggregation","useOsdkObject","useOsdkObjects","useOsdkClient","useOsdkMetadata","useDebouncedCallback"],"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 type { UseOsdkAggregationResult } from \"../new/useOsdkAggregation.js\";\nexport { useOsdkAggregation } from \"../new/useOsdkAggregation.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\";\nexport { useDebouncedCallback } from \"../utils/useDebouncedCallback.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;AAEvD,SAASC,kBAAkB,QAAQ,8BAA8B;AACjE,SAASC,aAAa,QAAQ,yBAAyB;AAEvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB;AACnD,SAASC,eAAe,QAAQ,uBAAuB;AAEvD,SAASC,oBAAoB,QAAQ,kCAAkC","ignoreList":[]}

package/build/browser/utils/useDebouncedCallback.js

@@ -0,0 +1,81 @@
+/*
+ * 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 React from "react";
+/**
+ * Creates a debounced version of a callback function.
+ *
+ * @param callback The function to debounce
+ * @param delay The delay in milliseconds
+ * @returns A debounced function with cancel() and flush() methods
+ *
+ * @example
+ * ```tsx
+ * const { applyAction } = useOsdkAction(editOffice);
+ *
+ * const debouncedSave = useDebouncedCallback(
+ *   async (name: string) => {
+ *     await applyAction({
+ *       Office: office,
+ *       name,
+ *       location: office.location!,
+ *       $optimisticUpdate: (ctx) => {
+ *         ctx.updateObject(office.$clone({ name }));
+ *       },
+ *     });
+ *   },
+ *   1000
+ * );
+ *
+ * <input onChange={(e) => debouncedSave(e.target.value)} />
+ * ```
+ */
+export function useDebouncedCallback(callback, delay) {
+  const timeoutRef = React.useRef();
+  const callbackRef = React.useRef(callback);
+  const lastArgsRef = React.useRef();
+  callbackRef.current = callback;
+  const cancel = React.useCallback(() => {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = undefined;
+    }
+  }, []);
+  const flush = React.useCallback(() => {
+    if (timeoutRef.current && lastArgsRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = undefined;
+      void callbackRef.current(...lastArgsRef.current);
+    }
+  }, []);
+  const debouncedCallback = React.useCallback((...args) => {
+    lastArgsRef.current = args;
+    cancel();
+    timeoutRef.current = setTimeout(() => {
+      void callbackRef.current(...args);
+    }, delay);
+  }, [delay, cancel]);
+  React.useEffect(() => {
+    return () => {
+      cancel();
+    };
+  }, [cancel]);
+  return Object.assign(debouncedCallback, {
+    cancel,
+    flush
+  });
+}
+//# sourceMappingURL=useDebouncedCallback.js.map

package/build/browser/utils/useDebouncedCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedCallback.js","names":["React","useDebouncedCallback","callback","delay","timeoutRef","useRef","callbackRef","lastArgsRef","current","cancel","useCallback","clearTimeout","undefined","flush","debouncedCallback","args","setTimeout","useEffect","Object","assign"],"sources":["useDebouncedCallback.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 React from \"react\";\n\nexport interface DebouncedCallback<TArgs extends readonly unknown[]> {\n  (...args: TArgs): void;\n  cancel: () => void;\n  flush: () => void;\n}\n\n/**\n * Creates a debounced version of a callback function.\n *\n * @param callback The function to debounce\n * @param delay The delay in milliseconds\n * @returns A debounced function with cancel() and flush() methods\n *\n * @example\n * ```tsx\n * const { applyAction } = useOsdkAction(editOffice);\n *\n * const debouncedSave = useDebouncedCallback(\n *   async (name: string) => {\n *     await applyAction({\n *       Office: office,\n *       name,\n *       location: office.location!,\n *       $optimisticUpdate: (ctx) => {\n *         ctx.updateObject(office.$clone({ name }));\n *       },\n *     });\n *   },\n *   1000\n * );\n *\n * <input onChange={(e) => debouncedSave(e.target.value)} />\n * ```\n */\nexport function useDebouncedCallback<TArgs extends readonly unknown[]>(\n  callback: (...args: TArgs) => void | Promise<void>,\n  delay: number,\n): DebouncedCallback<TArgs> {\n  const timeoutRef = React.useRef<ReturnType<typeof setTimeout>>();\n  const callbackRef = React.useRef(callback);\n  const lastArgsRef = React.useRef<TArgs>();\n\n  callbackRef.current = callback;\n\n  const cancel = React.useCallback(() => {\n    if (timeoutRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = undefined;\n    }\n  }, []);\n\n  const flush = React.useCallback(() => {\n    if (timeoutRef.current && lastArgsRef.current) {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = undefined;\n      void callbackRef.current(...lastArgsRef.current);\n    }\n  }, []);\n\n  const debouncedCallback = React.useCallback(\n    (...args: TArgs) => {\n      lastArgsRef.current = args;\n      cancel();\n      timeoutRef.current = setTimeout(() => {\n        void callbackRef.current(...args);\n      }, delay);\n    },\n    [delay, cancel],\n  );\n\n  React.useEffect(() => {\n    return () => {\n      cancel();\n    };\n  }, [cancel]);\n\n  return Object.assign(debouncedCallback, { cancel, flush });\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,MAAM,OAAO;AAQzB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAClCC,QAAkD,EAClDC,KAAa,EACa;EAC1B,MAAMC,UAAU,GAAGJ,KAAK,CAACK,MAAM,CAAgC,CAAC;EAChE,MAAMC,WAAW,GAAGN,KAAK,CAACK,MAAM,CAACH,QAAQ,CAAC;EAC1C,MAAMK,WAAW,GAAGP,KAAK,CAACK,MAAM,CAAQ,CAAC;EAEzCC,WAAW,CAACE,OAAO,GAAGN,QAAQ;EAE9B,MAAMO,MAAM,GAAGT,KAAK,CAACU,WAAW,CAAC,MAAM;IACrC,IAAIN,UAAU,CAACI,OAAO,EAAE;MACtBG,YAAY,CAACP,UAAU,CAACI,OAAO,CAAC;MAChCJ,UAAU,CAACI,OAAO,GAAGI,SAAS;IAChC;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMC,KAAK,GAAGb,KAAK,CAACU,WAAW,CAAC,MAAM;IACpC,IAAIN,UAAU,CAACI,OAAO,IAAID,WAAW,CAACC,OAAO,EAAE;MAC7CG,YAAY,CAACP,UAAU,CAACI,OAAO,CAAC;MAChCJ,UAAU,CAACI,OAAO,GAAGI,SAAS;MAC9B,KAAKN,WAAW,CAACE,OAAO,CAAC,GAAGD,WAAW,CAACC,OAAO,CAAC;IAClD;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMM,iBAAiB,GAAGd,KAAK,CAACU,WAAW,CACzC,CAAC,GAAGK,IAAW,KAAK;IAClBR,WAAW,CAACC,OAAO,GAAGO,IAAI;IAC1BN,MAAM,CAAC,CAAC;IACRL,UAAU,CAACI,OAAO,GAAGQ,UAAU,CAAC,MAAM;MACpC,KAAKV,WAAW,CAACE,OAAO,CAAC,GAAGO,IAAI,CAAC;IACnC,CAAC,EAAEZ,KAAK,CAAC;EACX,CAAC,EACD,CAACA,KAAK,EAAEM,MAAM,CAChB,CAAC;EAEDT,KAAK,CAACiB,SAAS,CAAC,MAAM;IACpB,OAAO,MAAM;MACXR,MAAM,CAAC,CAAC;IACV,CAAC;EACH,CAAC,EAAE,CAACA,MAAM,CAAC,CAAC;EAEZ,OAAOS,MAAM,CAACC,MAAM,CAACL,iBAAiB,EAAE;IAAEL,MAAM;IAAEI;EAAM,CAAC,CAAC;AAC5D","ignoreList":[]}

package/build/cjs/public/experimental.cjs

@@ -77,6 +77,10 @@ function useLinks(objects, linkName, options = {}) {
   const {
     observableClient
   } = React5__default.default.useContext(OsdkContext2);
+  const {
+    enabled = true,
+    ...otherOptions
+  } = options;
   const objectsArray = React5__default.default.useMemo(() => {
     return objects === void 0 ? emptyArray : Array.isArray(objects) ? objects : [objects];
   }, [objects]);
@@ -84,14 +88,20 @@ function useLinks(objects, linkName, options = {}) {
     subscribe,
     getSnapShot
   } = React5__default.default.useMemo(() => {
+    if (!enabled) {
+      return makeExternalStore(() => ({
+        unsubscribe: () => {
+        }
+      }), `links ${linkName} for ${objectsArray.map((obj) => `${obj.$apiName}:${obj.$primaryKey}`).join(",")} [DISABLED]`);
+    }
     return makeExternalStore((observer) => observableClient.observeLinks(objectsArray, linkName, {
       linkName,
-      where: options.where,
-      pageSize: options.pageSize,
-      orderBy: options.orderBy,
-      mode: options.mode
+      where: otherOptions.where,
+      pageSize: otherOptions.pageSize,
+      orderBy: otherOptions.orderBy,
+      mode: otherOptions.mode
     }, observer), `links ${linkName} for ${objectsArray.map((obj) => `${obj.$apiName}:${obj.$primaryKey}`).join(",")}`);
-  }, [observableClient, objectsArray, linkName, options.where, options.pageSize, options.orderBy, options.mode]);
+  }, [enabled, observableClient, objectsArray, linkName, otherOptions.where, otherOptions.pageSize, otherOptions.orderBy, otherOptions.mode]);
   const payload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
   return {
     links: payload?.resolvedList,
@@ -106,35 +116,48 @@ function useObjectSet(baseObjectSet, options = {}) {
   const {
     observableClient
   } = React5__default.default.useContext(OsdkContext2);
+  const {
+    enabled = true,
+    streamUpdates,
+    ...otherOptions
+  } = options;
   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
+    where: otherOptions.where,
+    withProperties: otherOptions.withProperties,
+    union: otherOptions.union,
+    intersect: otherOptions.intersect,
+    subtract: otherOptions.subtract,
+    pivotTo: otherOptions.pivotTo,
+    pageSize: otherOptions.pageSize,
+    orderBy: otherOptions.orderBy
   });
   const {
     subscribe,
     getSnapShot
   } = React5__default.default.useMemo(() => {
+    if (!enabled) {
+      return makeExternalStore(() => ({
+        unsubscribe: () => {
+        }
+      }), process.env.NODE_ENV !== "production" ? `objectSet ${stableKey} [DISABLED]` : void 0);
+    }
     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
+        where: otherOptions.where,
+        withProperties: otherOptions.withProperties,
+        union: otherOptions.union,
+        intersect: otherOptions.intersect,
+        subtract: otherOptions.subtract,
+        pivotTo: otherOptions.pivotTo,
+        pageSize: otherOptions.pageSize,
+        orderBy: otherOptions.orderBy,
+        dedupeInterval: otherOptions.dedupeIntervalMs ?? 2e3,
+        autoFetchMore: otherOptions.autoFetchMore,
+        streamUpdates
       }, observer);
       return subscription;
     }, process.env.NODE_ENV !== "production" ? `objectSet ${stableKey}` : void 0);
-  }, [observableClient, stableKey]);
+  }, [enabled, observableClient, stableKey, streamUpdates]);
   const payload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
   return {
     data: payload?.resolvedList,
@@ -261,19 +284,68 @@ function useOsdkAction(actionDef) {
     validationResult
   };
 }
+function useOsdkAggregation(type, {
+  where = {},
+  withProperties,
+  aggregate,
+  dedupeIntervalMs
+}) {
+  const {
+    observableClient
+  } = React5__default.default.useContext(OsdkContext2);
+  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
+  const stableWithProperties = React5__default.default.useMemo(() => withProperties, [JSON.stringify(withProperties)]);
+  const stableAggregate = React5__default.default.useMemo(() => aggregate, [JSON.stringify(aggregate)]);
+  const {
+    subscribe,
+    getSnapShot
+  } = React5__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeAggregation({
+    type,
+    where: canonWhere,
+    withProperties: stableWithProperties,
+    aggregate: stableAggregate,
+    dedupeInterval: dedupeIntervalMs ?? 2e3
+  }, observer), process.env.NODE_ENV !== "production" ? `aggregation ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type.apiName, type.type, canonWhere, stableWithProperties, stableAggregate, dedupeIntervalMs]);
+  const payload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  let error;
+  if (payload && "error" in payload && payload.error) {
+    error = payload.error;
+  } else if (payload?.status === "error") {
+    error = new Error("Failed to execute aggregation");
+  }
+  const refetch = React5__default.default.useCallback(async () => {
+    await observableClient.invalidateObjectType(type.apiName);
+  }, [observableClient, type.apiName]);
+  return {
+    data: payload?.result,
+    isLoading: payload?.status === "loading",
+    error,
+    refetch
+  };
+}
 function useOsdkObject(...args) {
   const {
     observableClient
   } = 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 isInstanceSignature = "$objectType" in args[0];
+  const enabled = isInstanceSignature ? typeof args[1] === "boolean" ? args[1] : true : typeof args[2] === "boolean" ? args[2] : true;
+  const mode = isInstanceSignature ? "offline" : void 0;
+  const objectType = isInstanceSignature ? args[0].$objectType : args[0].apiName;
+  const primaryKey = isInstanceSignature ? args[0].$primaryKey : args[1];
   const {
     subscribe,
     getSnapShot
-  } = React5__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeObject(objectType, primaryKey, {
-    mode
-  }, observer)), [observableClient, objectType, primaryKey, mode]);
+  } = React5__default.default.useMemo(() => {
+    if (!enabled) {
+      return makeExternalStore(() => ({
+        unsubscribe: () => {
+        }
+      }));
+    }
+    return makeExternalStore((observer) => observableClient.observeObject(objectType, primaryKey, {
+      mode
+    }, observer));
+  }, [enabled, observableClient, objectType, primaryKey, mode]);
   const payload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
   let error;
   if (payload && "error" in payload && payload.error) {
@@ -291,28 +363,52 @@ function useOsdkObject(...args) {
     }
   };
 }
-function useOsdkObjects(type, {
-  pageSize,
-  orderBy,
-  dedupeIntervalMs,
-  where = {},
-  streamUpdates
-} = {}) {
+function useOsdkObjects(type, options) {
+  const {
+    pageSize,
+    orderBy,
+    dedupeIntervalMs,
+    where = {},
+    streamUpdates,
+    withProperties,
+    autoFetchMore,
+    intersectWith,
+    pivotTo,
+    enabled = true
+  } = options ?? {};
   const {
     observableClient
   } = React5__default.default.useContext(OsdkContext2);
   const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
+  const stableWithProperties = React5__default.default.useMemo(() => withProperties, [JSON.stringify(withProperties)]);
+  const stableIntersectWith = React5__default.default.useMemo(() => intersectWith, [JSON.stringify(intersectWith)]);
   const {
     subscribe,
     getSnapShot
-  } = React5__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeList({
-    type,
-    where: canonWhere,
-    dedupeInterval: dedupeIntervalMs ?? 2e3,
-    pageSize,
-    orderBy,
-    streamUpdates
-  }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type, canonWhere, dedupeIntervalMs]);
+  } = React5__default.default.useMemo(() => {
+    if (!enabled) {
+      return makeExternalStore(() => ({
+        unsubscribe: () => {
+        }
+      }), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${JSON.stringify(canonWhere)} [DISABLED]` : void 0);
+    }
+    return makeExternalStore((observer) => observableClient.observeList({
+      type,
+      where: canonWhere,
+      dedupeInterval: dedupeIntervalMs ?? 2e3,
+      pageSize,
+      orderBy,
+      streamUpdates,
+      withProperties: stableWithProperties,
+      autoFetchMore,
+      ...stableIntersectWith ? {
+        intersectWith: stableIntersectWith
+      } : {},
+      ...pivotTo ? {
+        pivotTo
+      } : {}
+    }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0);
+  }, [enabled, observableClient, type, canonWhere, dedupeIntervalMs, pageSize, orderBy, streamUpdates, stableWithProperties, autoFetchMore, stableIntersectWith, pivotTo]);
   const listPayload = React5__default.default.useSyncExternalStore(subscribe, getSnapShot);
   let error;
   if (listPayload && "error" in listPayload && listPayload.error) {
@@ -328,6 +424,41 @@ function useOsdkObjects(type, {
     isOptimistic: listPayload?.isOptimistic ?? false
   };
 }
+function useDebouncedCallback(callback, delay) {
+  const timeoutRef = React5__default.default.useRef();
+  const callbackRef = React5__default.default.useRef(callback);
+  const lastArgsRef = React5__default.default.useRef();
+  callbackRef.current = callback;
+  const cancel = React5__default.default.useCallback(() => {
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = void 0;
+    }
+  }, []);
+  const flush = React5__default.default.useCallback(() => {
+    if (timeoutRef.current && lastArgsRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = void 0;
+      void callbackRef.current(...lastArgsRef.current);
+    }
+  }, []);
+  const debouncedCallback = React5__default.default.useCallback((...args) => {
+    lastArgsRef.current = args;
+    cancel();
+    timeoutRef.current = setTimeout(() => {
+      void callbackRef.current(...args);
+    }, delay);
+  }, [delay, cancel]);
+  React5__default.default.useEffect(() => {
+    return () => {
+      cancel();
+    };
+  }, [cancel]);
+  return Object.assign(debouncedCallback, {
+    cancel,
+    flush
+  });
+}
 
 Object.defineProperty(exports, "useOsdkClient", {
   enumerable: true,
@@ -338,9 +469,11 @@ Object.defineProperty(exports, "useOsdkMetadata", {
   get: function () { return chunkOVBG5VXE_cjs.useOsdkMetadata; }
 });
 exports.OsdkProvider2 = OsdkProvider2;
+exports.useDebouncedCallback = useDebouncedCallback;
 exports.useLinks = useLinks;
 exports.useObjectSet = useObjectSet;
 exports.useOsdkAction = useOsdkAction;
+exports.useOsdkAggregation = useOsdkAggregation;
 exports.useOsdkObject = useOsdkObject;
 exports.useOsdkObjects = useOsdkObjects;
 //# sourceMappingURL=experimental.cjs.map