@osdk/react 0.9.0-beta.1 → 0.9.0-beta.10

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

@@ -1 +1 @@
-{"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","stableOrderBy","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 stableOrderBy = React.useMemo(\n    () => orderBy,\n    [JSON.stringify(orderBy)],\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: stableOrderBy,\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      stableOrderBy,\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":"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","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","stableOrderBy","subscribe","getSnapShot","unsubscribe","process","env","NODE_ENV","apiName","observer","observeList","dedupeInterval","listPayload","useSyncExternalStore","error","status","Error","fetchMore","hasMore","undefined","data","resolvedList","isLoading","isOptimistic","totalCount"],"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  LinkedType,\n  LinkNames,\n  ObjectOrInterfaceDefinition,\n  Osdk,\n  PropertyKeys,\n  SimplePropertyDef,\n  WhereClause,\n} from \"@osdk/api\";\nimport type { ObserveObjectsCallbackArgs } 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 ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> {\n  /**\n   * Standard OSDK Where with RDP support\n   */\n  where?: WhereClause<T, RDPs>;\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?: { [K in keyof RDPs]: DerivedProperty.Creator<T, RDPs[K]> };\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, RDPs>;\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 ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n> {\n  /**\n   * Function to fetch more pages (undefined if no more pages)\n   */\n  fetchMore: (() => Promise<void>) | undefined;\n\n  /**\n   * The fetched data with derived properties\n   */\n  data:\n    | Osdk.Instance<T, \"$allBaseProperties\", PropertyKeys<T>, 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   * 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  /**\n   * The total count of objects matching the query (if available from the API)\n   */\n  totalCount?: string;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\nexport function useOsdkObjects<\n  Q extends ObjectOrInterfaceDefinition,\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 ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n>(\n  type: Q,\n  options?: UseOsdkObjectsOptions<Q, RDPs>,\n): UseOsdkListResult<Q, RDPs>;\n\nexport function useOsdkObjects<\n  Q extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n>(\n  type: Q,\n  options?: UseOsdkObjectsOptions<Q, RDPs>,\n):\n  | UseOsdkListResult<Q, RDPs>\n  | UseOsdkListResult<LinkedType<Q, LinkNames<Q>>>\n{\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<\n    Q,\n    RDPs\n  >(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 stableOrderBy = React.useMemo(\n    () => orderBy,\n    [JSON.stringify(orderBy)],\n  );\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      if (!enabled) {\n        return makeExternalStore<\n          ObserveObjectsCallbackArgs<Q, RDPs>\n        >(\n          () => ({ unsubscribe: () => {} }),\n          process.env.NODE_ENV !== \"production\"\n            ? `list ${type.apiName} ${JSON.stringify(canonWhere)} [DISABLED]`\n            : void 0,\n        );\n      }\n      return makeExternalStore<\n        ObserveObjectsCallbackArgs<Q, RDPs>\n      >(\n        (observer) =>\n          observableClient.observeList({\n            type,\n            where: canonWhere,\n            dedupeInterval: dedupeIntervalMs ?? 2_000,\n            pageSize,\n            orderBy: stableOrderBy,\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      stableOrderBy,\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?.hasMore ? listPayload.fetchMore : undefined,\n    error,\n    data: listPayload?.resolvedList,\n    isLoading: enabled\n      ? (listPayload?.status === \"loading\" || listPayload?.status === \"init\"\n        || !listPayload)\n      : false,\n    isOptimistic: listPayload?.isOptimistic ?? false,\n    totalCount: listPayload?.totalCount,\n  };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/public/experimental.js

@@ -15,10 +15,14 @@
  */
 
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
+export { useCurrentFoundryUser } from "../new/platform-apis/admin/useCurrentFoundryUser.js";
+export { useFoundryUser } from "../new/platform-apis/admin/useFoundryUser.js";
+export { useFoundryUsersList } from "../new/platform-apis/admin/useFoundryUsersList.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 { useOsdkFunction } from "../new/useOsdkFunction.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
 export { useOsdkObjects } from "../new/useOsdkObjects.js";
 export { useOsdkClient } from "../useOsdkClient.js";

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

@@ -1 +1 @@
-{"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":[]}
+{"version":3,"file":"experimental.js","names":["OsdkProvider2","useCurrentFoundryUser","useFoundryUser","useFoundryUsersList","useLinks","useObjectSet","useOsdkAction","useOsdkAggregation","useOsdkFunction","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 { useCurrentFoundryUser } from \"../new/platform-apis/admin/useCurrentFoundryUser.js\";\nexport { useFoundryUser } from \"../new/platform-apis/admin/useFoundryUser.js\";\nexport { useFoundryUsersList } from \"../new/platform-apis/admin/useFoundryUsersList.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 type {\n  UseOsdkFunctionOptions,\n  UseOsdkFunctionResult,\n} from \"../new/useOsdkFunction.js\";\nexport { useOsdkFunction } from \"../new/useOsdkFunction.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,qBAAqB,QAAQ,qDAAqD;AAC3F,SAASC,cAAc,QAAQ,8CAA8C;AAC7E,SAASC,mBAAmB,QAAQ,mDAAmD;AACvF,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,YAAY,QAAQ,wBAAwB;AACrD,SAASC,aAAa,QAAQ,yBAAyB;AAEvD,SAASC,kBAAkB,QAAQ,8BAA8B;AAKjE,SAASC,eAAe,QAAQ,2BAA2B;AAC3D,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/esm/utils/usePlatformQuery.js

@@ -0,0 +1,74 @@
+/*
+ * 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";
+import { makeExternalStore } from "../new/makeExternalStore.js";
+export function usePlatformQuery({
+  query,
+  queryName,
+  enabled = true
+}) {
+  const observerRef = React.useRef();
+  const handleQuery = React.useCallback(() => {
+    const observer = observerRef.current;
+    if (observer == null) return;
+    observer.next({
+      status: "loading",
+      data: undefined
+    });
+    query().then(data => {
+      observer.next({
+        status: "success",
+        data
+      });
+    }).catch(err => {
+      observer.error(err);
+    });
+  }, [query]);
+  const {
+    subscribe,
+    getSnapShot
+  } = React.useMemo(() => {
+    if (!enabled) {
+      return makeExternalStore(() => ({
+        unsubscribe: () => {}
+      }), process.env.NODE_ENV !== "production" ? `${queryName} Query [DISABLED]` : undefined);
+    }
+    return makeExternalStore(observer => {
+      observerRef.current = observer;
+      handleQuery();
+      return {
+        unsubscribe: () => {
+          observerRef.current = undefined;
+        }
+      };
+    }, queryName);
+  }, [enabled, queryName, handleQuery]);
+  const payload = React.useSyncExternalStore(subscribe, getSnapShot);
+  let error;
+  if (payload && "error" in payload && payload.error != null) {
+    error = payload.error;
+  } else if (payload?.status === "error") {
+    error = new Error(`Failed to query platform API: ${queryName}`);
+  }
+  return {
+    data: payload?.data,
+    isLoading: enabled ? payload?.status === "loading" || !payload : false,
+    error,
+    refetch: handleQuery
+  };
+}
+//# sourceMappingURL=usePlatformQuery.js.map

package/build/esm/utils/usePlatformQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePlatformQuery.js","names":["React","makeExternalStore","usePlatformQuery","query","queryName","enabled","observerRef","useRef","handleQuery","useCallback","observer","current","next","status","data","undefined","then","catch","err","error","subscribe","getSnapShot","useMemo","unsubscribe","process","env","NODE_ENV","payload","useSyncExternalStore","Error","isLoading","refetch"],"sources":["usePlatformQuery.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 { Observer } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"../new/makeExternalStore.js\";\n\nexport interface UseQueryOptions<T> {\n  /**\n   * Enable or disable the query.\n   *\n   * When `false`, the query will not automatically execute.\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   * });\n   */\n  enabled?: boolean;\n  queryName: string;\n  query: () => Promise<T>;\n}\n\nexport interface QueryResult<T> {\n  data: T | undefined;\n  isLoading: boolean;\n  error: Error | undefined;\n  refetch: () => void;\n}\n\ninterface QueryPayload<T> {\n  data: T | undefined;\n  status: \"loading\" | \"success\" | \"error\";\n}\n\nexport function usePlatformQuery<T>(\n  { query, queryName, enabled = true }: UseQueryOptions<T>,\n): QueryResult<T> {\n  const observerRef = React.useRef<Observer<QueryPayload<T> | undefined>>();\n\n  const handleQuery = React.useCallback(() => {\n    const observer = observerRef.current;\n    if (observer == null) return;\n\n    observer.next({\n      status: \"loading\",\n      data: undefined,\n    });\n\n    query()\n      .then((data) => {\n        observer.next({\n          status: \"success\",\n          data,\n        });\n      })\n      .catch((err: unknown) => {\n        observer.error(err);\n      });\n  }, [query]);\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      if (!enabled) {\n        return makeExternalStore<QueryPayload<T>>(\n          () => ({ unsubscribe: () => {} }),\n          process.env.NODE_ENV !== \"production\"\n            ? `${queryName} Query [DISABLED]`\n            : undefined,\n        );\n      }\n\n      return makeExternalStore<QueryPayload<T>>(\n        (observer: Observer<QueryPayload<T> | undefined>) => {\n          observerRef.current = observer;\n          handleQuery();\n          return {\n            unsubscribe: () => {\n              observerRef.current = undefined;\n            },\n          };\n        },\n        queryName,\n      );\n    },\n    [enabled, queryName, handleQuery],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  let error: Error | undefined;\n  if (payload && \"error\" in payload && payload.error != null) {\n    error = payload.error;\n  } else if (payload?.status === \"error\") {\n    error = new Error(`Failed to query platform API: ${queryName}`);\n  }\n\n  return {\n    data: payload?.data,\n    isLoading: enabled ? (payload?.status === \"loading\" || !payload) : false,\n    error,\n    refetch: handleQuery,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,6BAA6B;AAiC/D,OAAO,SAASC,gBAAgBA,CAC9B;EAAEC,KAAK;EAAEC,SAAS;EAAEC,OAAO,GAAG;AAAyB,CAAC,EACxC;EAChB,MAAMC,WAAW,GAAGN,KAAK,CAACO,MAAM,CAAwC,CAAC;EAEzE,MAAMC,WAAW,GAAGR,KAAK,CAACS,WAAW,CAAC,MAAM;IAC1C,MAAMC,QAAQ,GAAGJ,WAAW,CAACK,OAAO;IACpC,IAAID,QAAQ,IAAI,IAAI,EAAE;IAEtBA,QAAQ,CAACE,IAAI,CAAC;MACZC,MAAM,EAAE,SAAS;MACjBC,IAAI,EAAEC;IACR,CAAC,CAAC;IAEFZ,KAAK,CAAC,CAAC,CACJa,IAAI,CAAEF,IAAI,IAAK;MACdJ,QAAQ,CAACE,IAAI,CAAC;QACZC,MAAM,EAAE,SAAS;QACjBC;MACF,CAAC,CAAC;IACJ,CAAC,CAAC,CACDG,KAAK,CAAEC,GAAY,IAAK;MACvBR,QAAQ,CAACS,KAAK,CAACD,GAAG,CAAC;IACrB,CAAC,CAAC;EACN,CAAC,EAAE,CAACf,KAAK,CAAC,CAAC;EAEX,MAAM;IAAEiB,SAAS;IAAEC;EAAY,CAAC,GAAGrB,KAAK,CAACsB,OAAO,CAC9C,MAAM;IACJ,IAAI,CAACjB,OAAO,EAAE;MACZ,OAAOJ,iBAAiB,CACtB,OAAO;QAAEsB,WAAW,EAAEA,CAAA,KAAM,CAAC;MAAE,CAAC,CAAC,EACjCC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,GAAGtB,SAAS,mBAAmB,GAC/BW,SACN,CAAC;IACH;IAEA,OAAOd,iBAAiB,CACrBS,QAA+C,IAAK;MACnDJ,WAAW,CAACK,OAAO,GAAGD,QAAQ;MAC9BF,WAAW,CAAC,CAAC;MACb,OAAO;QACLe,WAAW,EAAEA,CAAA,KAAM;UACjBjB,WAAW,CAACK,OAAO,GAAGI,SAAS;QACjC;MACF,CAAC;IACH,CAAC,EACDX,SACF,CAAC;EACH,CAAC,EACD,CAACC,OAAO,EAAED,SAAS,EAAEI,WAAW,CAClC,CAAC;EAED,MAAMmB,OAAO,GAAG3B,KAAK,CAAC4B,oBAAoB,CAACR,SAAS,EAAEC,WAAW,CAAC;EAElE,IAAIF,KAAwB;EAC5B,IAAIQ,OAAO,IAAI,OAAO,IAAIA,OAAO,IAAIA,OAAO,CAACR,KAAK,IAAI,IAAI,EAAE;IAC1DA,KAAK,GAAGQ,OAAO,CAACR,KAAK;EACvB,CAAC,MAAM,IAAIQ,OAAO,EAAEd,MAAM,KAAK,OAAO,EAAE;IACtCM,KAAK,GAAG,IAAIU,KAAK,CAAC,iCAAiCzB,SAAS,EAAE,CAAC;EACjE;EAEA,OAAO;IACLU,IAAI,EAAEa,OAAO,EAAEb,IAAI;IACnBgB,SAAS,EAAEzB,OAAO,GAAIsB,OAAO,EAAEd,MAAM,KAAK,SAAS,IAAI,CAACc,OAAO,GAAI,KAAK;IACxER,KAAK;IACLY,OAAO,EAAEvB;EACX,CAAC;AACH","ignoreList":[]}

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

@@ -4,7 +4,7 @@ export type Snapshot<X> = X & {
 } | (Partial<X> & {
 	error?: Error
 }) | undefined;
-export declare function makeExternalStore<X>(createObservation: (callback: Observer<X | undefined>) => Unsubscribable, name?: string): {
+export declare function makeExternalStore<X>(createObservation: (callback: Observer<X | undefined>) => Unsubscribable, _name?: string, initialValue?: Snapshot<X>): {
 	subscribe: (notifyUpdate: () => void) => () => void
 	getSnapShot: () => Snapshot<X>
 };

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,UACA,sBACK,kCAAmC;AAE1C,YAAY,SAAS,KACjB,IAAI;CAAE,QAAQ;AAAO,KACpB,QAAQ,KAAK;CAAE,QAAQ;AAAO;AAGnC,OAAO,iBAAS,kBAAkB,GAChCA,oBAAoBC,UAAU,SAAS,mBAAmB,gBAC1DC,gBACC;CACD,YAAYC;CACZ,mBAAmB,SAAS;AAC7B","names":["createObservation: (callback: Observer<X | undefined>) => Unsubscribable","callback: Observer<X | undefined>","name?: string","notifyUpdate: () => void"],"sources":["../../../src/new/makeExternalStore.ts"],"version":3,"file":"makeExternalStore.d.ts"}
+{"mappings":"AAgBA,cACE,UACA,sBACK,kCAAmC;AAE1C,YAAY,SAAS,KACjB,IAAI;CAAE,QAAQ;AAAO,KACpB,QAAQ,KAAK;CAAE,QAAQ;AAAO;AAGnC,OAAO,iBAAS,kBAAkB,GAChCA,oBAAoBC,UAAU,SAAS,mBAAmB,gBAC1DC,gBACAC,eAAe,SAAS,KACvB;CACD,YAAYC;CACZ,mBAAmB,SAAS;AAC7B","names":["createObservation: (callback: Observer<X | undefined>) => Unsubscribable","callback: Observer<X | undefined>","_name?: string","initialValue?: Snapshot<X>","notifyUpdate: () => void"],"sources":["../../../src/new/makeExternalStore.ts"],"version":3,"file":"makeExternalStore.d.ts"}

package/build/types/new/platform-apis/admin/useCurrentFoundryUser.d.ts

@@ -0,0 +1,28 @@
+import { type User } from "@osdk/foundry.admin";
+export interface UseCurrentFoundryUserOptions {
+	/**
+	* Enable or disable the query.
+	*
+	* When `false`, the query will not automatically execute.
+	*
+	* This is useful for:
+	* - Lazy/on-demand queries that should wait for user interaction
+	* - Dependent queries that need data from another query first
+	* - Conditional queries based on component state
+	*
+	* @default true
+	* });
+	*/
+	enabled?: boolean;
+}
+export interface UseCurrentFoundryUserResult {
+	currentUser: User | undefined;
+	isLoading: boolean;
+	error: Error | undefined;
+	refetch: () => void;
+}
+/**
+* Get the currently signed in User.
+* @param options Options to control the query.
+*/
+export declare function useCurrentFoundryUser({ enabled }?: UseCurrentFoundryUserOptions): UseCurrentFoundryUserResult;

package/build/types/new/platform-apis/admin/useCurrentFoundryUser.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,YAAmB,qBAAsB;AAKvD,iBAAiB,6BAA6B;;;;;;;;;;;;;;CAc5C;AACD;AAED,iBAAiB,4BAA4B;CAC3C,aAAa;CACb;CAEA,OAAO;CAEP;AACD;;;;;AAMD,OAAO,iBAAS,sBACd,EAAE,SAA8C,GAA5B,+BACnB","names":[],"sources":["../../../../../src/new/platform-apis/admin/useCurrentFoundryUser.ts"],"version":3,"file":"useCurrentFoundryUser.d.ts"}

package/build/types/new/platform-apis/admin/useFoundryUser.d.ts

@@ -0,0 +1,36 @@
+import { type User } from "@osdk/foundry.admin";
+import type { UserStatus } from "@osdk/foundry.core";
+export interface UseFoundryUserOptions {
+	/**
+	* Enable or disable the query.
+	*
+	* When `false`, the query will not automatically execute.
+	*
+	* This is useful for:
+	* - Lazy/on-demand queries that should wait for user interaction
+	* - Dependent queries that need data from another query first
+	* - Conditional queries based on component state
+	*
+	* @default true
+	* });
+	*/
+	enabled?: boolean;
+	/**
+	* The default status of the users returned in the list.
+	*
+	* @default "ACTIVE"
+	*/
+	status?: UserStatus;
+}
+export interface UseFoundryUserResult {
+	user: User | undefined;
+	isLoading: boolean;
+	error: Error | undefined;
+	refetch: () => void;
+}
+/**
+* Get the User with the specified id.
+* @param userId A Foundry User ID.
+* @param options Options to control the query.
+*/
+export declare function useFoundryUser(userId: string, { enabled, status }?: UseFoundryUserOptions): UseFoundryUserResult;

package/build/types/new/platform-apis/admin/useFoundryUser.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,YAAmB,qBAAsB;AACvD,cAAc,kBAAkB,oBAAqB;AAKrD,iBAAiB,sBAAsB;;;;;;;;;;;;;;CAcrC;;;;;;CAOA,SAAS;AACV;AAED,iBAAiB,qBAAqB;CACpC,MAAM;CACN;CAEA,OAAO;CAEP;AACD;;;;;;AAOD,OAAO,iBAAS,eACdA,gBACA,EAAE,SAAgB,QAA0C,GAArB,wBACtC","names":["userId: string"],"sources":["../../../../../src/new/platform-apis/admin/useFoundryUser.ts"],"version":3,"file":"useFoundryUser.d.ts"}

package/build/types/new/platform-apis/admin/useFoundryUsersList.d.ts

@@ -0,0 +1,52 @@
+import { type ListUsersResponse } from "@osdk/foundry.admin";
+import type { UserStatus } from "@osdk/foundry.core";
+export interface UseFoundryUsersListOptions {
+	/**
+	* Enable or disable the query.
+	*
+	* When `false`, the query will not automatically execute.
+	*
+	* This is useful for:
+	* - Lazy/on-demand queries that should wait for user interaction
+	* - Dependent queries that need data from another query first
+	* - Conditional queries based on component state
+	*
+	* @default true
+	* });
+	*/
+	enabled?: boolean;
+	/**
+	* The default status of the users returned in the list.
+	*
+	* @default "ACTIVE"
+	*/
+	include?: UserStatus;
+	/**
+	* The preferred page size for the list.
+	*
+	* @default 1000
+	*/
+	pageSize?: number;
+	/**
+	* The page token indicates where to start paging. This should be omitted from the first page's request.
+	* To fetch the next page, clients should take the value from the nextPageToken field of the previous
+	* response and use it to populate the pageToken field of the next request.
+	*/
+	pageToken?: string;
+}
+export interface UseFoundryUsersListResult {
+	users: ListUsersResponse["data"] | undefined;
+	/**
+	* The page token to be used for the next page of users. If this is undefined, there are no more
+	* pages of users to load.
+	*/
+	nextPageToken: string | undefined;
+	isLoading: boolean;
+	error: Error | undefined;
+	refetch: () => void;
+}
+/**
+* Lists all Users. This is a paged endpoint. Each page may be smaller or larger than the requested page size.
+* @param options Options to control the query.
+*/
+export declare function useFoundryUsersList({ enabled, include, pageSize, pageToken }?: UseFoundryUsersListOptions): UseFoundryUsersListResult;

package/build/types/new/platform-apis/admin/useFoundryUsersList.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,yBAAgC,qBAAsB;AACpE,cAAc,kBAAkB,oBAAqB;AAKrD,iBAAiB,2BAA2B;;;;;;;;;;;;;;CAc1C;;;;;;CAOA,UAAU;;;;;;CAOV;;;;;;CAOA;AACD;AAED,iBAAiB,0BAA0B;CACzC,OAAO,kBAAkB;;;;;CAKzB;CACA;CAEA,OAAO;CAEP;AACD;;;;;AAMD,OAAO,iBAAS,oBACd,EAAE,SAAgB,SAAoB,UAAiB,WAC3B,GAA1B,6BACD","names":[],"sources":["../../../../../src/new/platform-apis/admin/useFoundryUsersList.ts"],"version":3,"file":"useFoundryUsersList.d.ts"}

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

@@ -1,6 +1,6 @@
-import type { LinkedType, LinkNames } from "@osdk/api";
-import type { InterfaceDefinition, ObjectTypeDefinition, Osdk, PropertyKeys, WhereClause } from "@osdk/client";
-export interface UseLinksOptions<T extends ObjectTypeDefinition | InterfaceDefinition> {
+import type { LinkedType, LinkNames, ObjectOrInterfaceDefinition } from "@osdk/api";
+import type { Osdk, PropertyKeys, WhereClause } from "@osdk/client";
+export interface UseLinksOptions<T extends ObjectOrInterfaceDefinition> {
 	/**
 	* Standard OSDK Where clause for filtering linked objects
 	*/
@@ -39,7 +39,7 @@ export interface UseLinksOptions<T extends ObjectTypeDefinition | InterfaceDefin
 	*/
 	enabled?: boolean;
 }
-export interface UseLinksResult<Q extends ObjectTypeDefinition | InterfaceDefinition> {
+export interface UseLinksResult<Q extends ObjectOrInterfaceDefinition> {
 	links: Osdk.Instance<Q>[] | undefined;
 	isLoading: boolean;
 	error: Error | undefined;
@@ -65,6 +65,6 @@ export interface UseLinksResult<Q extends ObjectTypeDefinition | InterfaceDefini
 * @returns UseLinksResult with links data and metadata
 */
 export declare function useLinks<
-	T extends ObjectTypeDefinition,
+	T extends ObjectOrInterfaceDefinition,
 	L extends LinkNames<T>
 >(objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined, linkName: L, options?: UseLinksOptions<LinkedType<T, L>>): UseLinksResult<LinkedType<T, L>>;

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,YAAY,iBAAiB,WAAY;AACvD,cACE,qBACA,sBACA,MACA,cACA,mBACK,cAAe;AAMtB,iBAAiB,gBACf,UAAU,uBAAuB,qBACjC;;;;CAIA,QAAQ,YAAY;;;;CAKpB;;CAGA,aACG,KAAK,aAAa,OAAM,QAAQ;;;;;;;CASnC,OAAO,UAAU;;;;;;;;;;;;;;;;;;;;CAqBjB;AACD;AAED,iBAAiB,eACf,UAAU,uBAAuB,qBACjC;CACA,OAAO,KAAK,SAAS;CACrB;CACA,OAAO;;;;CAKP;;;;CAKA,kBAAkB;;;;CAKlB;AACD;;;;;;;;;AAYD,OAAO,iBAAS;CACd,UAAU;CACV,UAAU,UAAU;EAEpBA,SAAS,KAAK,SAAS,KAAK,MAAM,KAAK,SAAS,iBAChDC,UAAU,GACVC,UAAS,gBAAgB,WAAW,GAAG,MACtC,eAAe,WAAW,GAAG","names":["objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined","linkName: L","options: UseLinksOptions<LinkedType<T, L>>"],"sources":["../../../src/new/useLinks.ts"],"version":3,"file":"useLinks.d.ts"}
+{"mappings":"AAgBA,cACE,YACA,WACA,mCACK,WAAY;AACnB,cAAc,MAAM,cAAc,mBAAmB,cAAe;AAMpE,iBAAiB,gBACf,UAAU,6BACV;;;;CAIA,QAAQ,YAAY;;;;CAKpB;;CAGA,aACG,KAAK,aAAa,OAAM,QAAQ;;;;;;;CASnC,OAAO,UAAU;;;;;;;;;;;;;;;;;;;;CAqBjB;AACD;AAED,iBAAiB,eACf,UAAU,6BACV;CACA,OAAO,KAAK,SAAS;CACrB;CACA,OAAO;;;;CAKP;;;;CAKA,kBAAkB;;;;CAKlB;AACD;;;;;;;;;AAYD,OAAO,iBAAS;CACd,UAAU;CACV,UAAU,UAAU;EAEpBA,SAAS,KAAK,SAAS,KAAK,MAAM,KAAK,SAAS,iBAChDC,UAAU,GACVC,UAAS,gBAAgB,WAAW,GAAG,MACtC,eAAe,WAAW,GAAG","names":["objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined","linkName: L","options: UseLinksOptions<LinkedType<T, L>>"],"sources":["../../../src/new/useLinks.ts"],"version":3,"file":"useLinks.d.ts"}

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

@@ -100,6 +100,10 @@ export interface UseObjectSetResult<
 	* The final ObjectSet after all transformations
 	*/
 	objectSet: ObjectSet<Q, RDPs>;
+	/**
+	* The total count of objects matching the query (if available from the API)
+	*/
+	totalCount?: string;
 }
 /**
 * React hook for observing and interacting with OSDK object sets.

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,iBACA,WACA,WACA,sBACA,MACA,cACA,mBACA,mBACK,WAAY;AAUnB,iBAAiB;CACf,UAAU;CACV,aAAa,eAAe,qBAAqB,CAAE;EACnD;;;;CAIA,QAAQ,YAAY,GAAG;;;;CAKvB,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;;;;;;;;CASA;;;;;;;;CASA;;;;;;;;;;;;;;;;;;;;CAqBA;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"}
+{"mappings":"AAgBA,cACE,iBACA,WACA,WACA,sBACA,MACA,cACA,mBACA,mBACK,WAAY;AAUnB,iBAAiB;CACf,UAAU;CACV,aAAa,eAAe,qBAAqB,CAAE;EACnD;;;;CAIA,QAAQ,YAAY,GAAG;;;;CAKvB,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;;;;;;;;CASA;;;;;;;;CASA;;;;;;;;;;;;;;;;;;;;CAqBA;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;;;;CAKxB;AACD;;;;;;;;;;;;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/new/useOsdkAction.d.ts

@@ -1,14 +1,14 @@
-import type { ActionDefinition, ActionValidationResponse } from "@osdk/client";
+import type { ActionDefinition, ActionEditResponse, ActionValidationResponse } from "@osdk/client";
 import { ActionValidationError } from "@osdk/client";
 import type { ActionSignatureFromDef, ObservableClient } from "@osdk/client/unstable-do-not-use";
 type ApplyActionParams<Q extends ActionDefinition<any>> = Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0] & { [K in keyof ObservableClient.ApplyActionOptions as `$${K}`] : ObservableClient.ApplyActionOptions[K] };
 export interface UseOsdkActionResult<Q extends ActionDefinition<any>> {
-	applyAction: (args: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>) => Promise<unknown>;
+	applyAction: (args: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>) => Promise<ActionEditResponse | undefined>;
 	error: undefined | Partial<{
 		actionValidation: ActionValidationError
 		unknown: unknown
 	}>;
-	data: unknown;
+	data: ActionEditResponse | undefined;
 	isPending: boolean;
 	isValidating: boolean;
 	/**

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,kBAAkB,gCAAgC,cAAe;AAC/E,SAAS,6BAA6B,cAAe;AACrD,cACE,wBACA,wBACK,kCAAmC;KAIrC,kBAAkB,UAAU,yBAC7B,WAAW,uBAAuB,GAAG,gBAAgB,QAEpD,WAAW,iBAAiB,0BAA0B,OACrD,iBAAiB,mBAAmB;AAG1C,iBAAiB,oBAAoB,UAAU,uBAAuB;CACpE,cACEA,MAAM,kBAAkB,KAAK,MAAM,kBAAkB,QAClD;CAEL,mBAEI,QAAQ;EACR,kBAAkB;EAClB;CACD;CACH;CAEA;CACA;;;;;;;;CASA,iBACEC,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,OACxD,QAAQ;CAEb,mBAAmB;AACpB;AAED,OAAO,iBAAS,cAAc,UAAU,uBACtCC,WAAW,IACV,oBAAoB","names":["args: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>","args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]","actionDef: Q"],"sources":["../../../src/new/useOsdkAction.ts"],"version":3,"file":"useOsdkAction.d.ts"}
+{"mappings":"AAgBA,cACE,kBACA,oBACA,gCACK,cAAe;AACtB,SAAS,6BAA6B,cAAe;AACrD,cACE,wBACA,wBACK,kCAAmC;KAIrC,kBAAkB,UAAU,yBAC7B,WAAW,uBAAuB,GAAG,gBAAgB,QAEpD,WAAW,iBAAiB,0BAA0B,OACrD,iBAAiB,mBAAmB;AAG1C,iBAAiB,oBAAoB,UAAU,uBAAuB;CACpE,cACEA,MAAM,kBAAkB,KAAK,MAAM,kBAAkB,QAClD,QAAQ;CAEb,mBAEI,QAAQ;EACR,kBAAkB;EAClB;CACD;CACH,MAAM;CAEN;CACA;;;;;;;;CASA,iBACEC,MAAM,WAAW,uBAAuB,GAAG,gBAAgB,OACxD,QAAQ;CAEb,mBAAmB;AACpB;AAED,OAAO,iBAAS,cAAc,UAAU,uBACtCC,WAAW,IACV,oBAAoB","names":["args: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>","args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]","actionDef: Q"],"sources":["../../../src/new/useOsdkAction.ts"],"version":3,"file":"useOsdkAction.d.ts"}

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

@@ -1,20 +1,18 @@
-import type { AggregateOpts, AggregationsResults, DerivedProperty, WhereClause } from "@osdk/api";
-import type { ObjectTypeDefinition } from "@osdk/client";
-import type { InferRdpTypes } from "./types.js";
+import type { AggregateOpts, AggregationsResults, DerivedProperty, ObjectOrInterfaceDefinition, SimplePropertyDef, WhereClause } from "@osdk/api";
 export interface UseOsdkAggregationOptions<
-	T extends ObjectTypeDefinition,
+	T extends ObjectOrInterfaceDefinition,
 	A extends AggregateOpts<T>,
-	WithProps extends DerivedProperty.Clause<T> | undefined = undefined
+	RDPs extends Record<string, SimplePropertyDef> = {}
 > {
 	/**
 	* Standard OSDK Where clause to filter objects before aggregation
 	*/
-	where?: WhereClause<T, InferRdpTypes<T, WithProps>>;
+	where?: WhereClause<T, RDPs>;
 	/**
 	* Define derived properties (RDPs) to be computed server-side.
 	* The derived properties can be used in the where clause and aggregation groupBy/select.
 	*/
-	withProperties?: WithProps;
+	withProperties?: { [K in keyof RDPs] : DerivedProperty.Creator<T, RDPs[K]> };
 	/**
 	* Aggregation options including groupBy and select
 	*/
@@ -28,7 +26,7 @@ export interface UseOsdkAggregationOptions<
 	dedupeIntervalMs?: number;
 }
 export interface UseOsdkAggregationResult<
-	T extends ObjectTypeDefinition,
+	T extends ObjectOrInterfaceDefinition,
 	A extends AggregateOpts<T>
 > {
 	data: AggregationsResults<T, A> | undefined;
@@ -61,7 +59,7 @@ export interface UseOsdkAggregationResult<
 * ```
 */
 export declare function useOsdkAggregation<
-	Q extends ObjectTypeDefinition,
-	A extends AggregateOpts<Q>,
-	WP extends DerivedProperty.Clause<Q> | undefined = undefined
->(type: Q, { where, withProperties, aggregate, dedupeIntervalMs }: UseOsdkAggregationOptions<Q, A, WP>): UseOsdkAggregationResult<Q, A>;
+	Q extends ObjectOrInterfaceDefinition,
+	const A extends AggregateOpts<Q>,
+	RDPs extends Record<string, SimplePropertyDef> = {}
+>(type: Q, { where, withProperties, aggregate, dedupeIntervalMs }: UseOsdkAggregationOptions<Q, A, RDPs>): UseOsdkAggregationResult<Q, A>;

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,eACA,qBACA,iBACA,mBACK,WAAY;AACnB,cAAc,4BAA4B,cAAe;AAKzD,cAAc,qBAAqB,YAAa;AAEhD,iBAAiB;CACf,UAAU;CACV,UAAU,cAAc;CACxB,kBAAkB,gBAAgB,OAAO;EACzC;;;;CAIA,QAAQ,YAAY,GAAG,cAAc,GAAG;;;;;CAMxC,iBAAiB;;;;CAKjB,WAAW;;;;;;;CAQX;AACD;AAED,iBAAiB;CACf,UAAU;CACV,UAAU,cAAc;EACxB;CACA,MAAM,oBAAoB,GAAG;CAC7B;CACA,OAAO;CACP;AACD;;;;;;;;;;;;;;;;;;;;;;;;;AAgCD,OAAO,iBAAS;CACd,UAAU;CACV,UAAU,cAAc;CACxB,WAAW,gBAAgB,OAAO;EAElCA,MAAM,GACN,EACE,OACA,gBACA,WACA,kBACoC,EAAnC,0BAA0B,GAAG,GAAG,MAClC,yBAAyB,GAAG","names":["type: Q"],"sources":["../../../src/new/useOsdkAggregation.ts"],"version":3,"file":"useOsdkAggregation.d.ts"}
+{"mappings":"AAgBA,cACE,eACA,qBACA,iBACA,6BACA,mBACA,mBACK,WAAY;AAMnB,iBAAiB;CACf,UAAU;CACV,UAAU,cAAc;CACxB,aAAa,eAAe,qBAAqB,CAAE;EACnD;;;;CAIA,QAAQ,YAAY,GAAG;;;;;CAMvB,oBAAoB,WAAW,QAAO,gBAAgB,QAAQ,GAAG,KAAK;;;;CAKtE,WAAW;;;;;;;CAQX;AACD;AAED,iBAAiB;CACf,UAAU;CACV,UAAU,cAAc;EACxB;CACA,MAAM,oBAAoB,GAAG;CAC7B;CACA,OAAO;CACP;AACD;;;;;;;;;;;;;;;;;;;;;;;;;AAgCD,OAAO,iBAAS;CACd,UAAU;OACJ,UAAU,cAAc;CAC9B,aAAa,eAAe,qBAAqB,CAAE;EAEnDA,MAAM,GACN,EACE,OACA,gBACA,WACA,kBACsC,EAArC,0BAA0B,GAAG,GAAG,QAClC,yBAAyB,GAAG","names":["type: Q"],"sources":["../../../src/new/useOsdkAggregation.ts"],"version":3,"file":"useOsdkAggregation.d.ts"}

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

@@ -0,0 +1,112 @@
+import type { CompileTimeMetadata, ObjectTypeDefinition, Osdk, QueryDefinition } from "@osdk/api";
+import type { QueryParameterType, QueryReturnType } from "@osdk/client/unstable-do-not-use";
+export interface UseOsdkFunctionOptions<Q extends QueryDefinition<unknown>> {
+	/**
+	* Parameters to pass to the function.
+	* Must include all required parameters; optional parameters can be omitted.
+	*/
+	params?: CompileTimeMetadata<Q>["parameters"] extends Record<string, never> ? undefined : QueryParameterType<CompileTimeMetadata<Q>["parameters"]>;
+	/**
+	* Object types this function depends on.
+	* When actions modify objects of these types, the function will automatically refetch.
+	*
+	* @example
+	* ```tsx
+	* // Refetch when any Employee object changes
+	* { dependsOn: [Employee] }
+	* ```
+	*/
+	dependsOn?: Array<ObjectTypeDefinition | string>;
+	/**
+	* Specific object instances this function depends on.
+	* When any of these specific objects change, the function will refetch.
+	* More fine-grained than dependsOn for precise invalidation control.
+	*
+	* @example
+	* ```tsx
+	* // Refetch when this specific employee changes
+	* { dependsOnObjects: [employee] }
+	* ```
+	*/
+	dependsOnObjects?: Array<Osdk.Instance<ObjectTypeDefinition>>;
+	/**
+	* The number of milliseconds to dedupe identical function calls.
+	* Two calls with the same function and params will share results
+	* if the second call is within this interval of the first.
+	* @default 2000
+	*/
+	dedupeIntervalMs?: number;
+	/**
+	* Whether to enable the query. When false, the query will not execute.
+	* Useful for:
+	* - Dependent queries that need to wait for other data
+	* - Conditional queries based on component state
+	*
+	* @default true
+	* @example
+	* // Dependent query - wait for required data
+	* const { data: employee } = useOsdkObject(Employee, employeeId);
+	* const { data: report } = useOsdkFunction(getEmployeeReport, {
+	*   params: { employeeId: employee?.$primaryKey },
+	*   enabled: !!employee
+	* });
+	*/
+	enabled?: boolean;
+}
+export interface UseOsdkFunctionResult<Q extends QueryDefinition<unknown>> {
+	/**
+	* The function result, or undefined if not yet loaded or on error.
+	*/
+	data: QueryReturnType<CompileTimeMetadata<Q>["output"]> | undefined;
+	/**
+	* True while the function is executing.
+	*/
+	isLoading: boolean;
+	/**
+	* Error if the function execution failed.
+	*/
+	error: Error | undefined;
+	/**
+	* Timestamp (ms since epoch) of when the result was last fetched.
+	*/
+	lastUpdated: number;
+	/**
+	* Manually refetch the function.
+	* Useful for "pull to refresh" or retry patterns.
+	*/
+	refetch: () => void;
+}
+/**
+* React hook for executing and observing OSDK functions.
+*
+* Provides automatic caching, deduplication, and reactive updates for function calls.
+* Functions are automatically re-fetched when dependencies change (configured via options).
+*
+* @param queryDef - The QueryDefinition to execute
+* @param options - Configuration options for the function call
+* @returns Object containing result, loading state, error, and refetch function
+*
+* @example Basic usage
+* ```tsx
+* const { data, isLoading, error } = useOsdkFunction(getEmployeeStats, {
+*   params: { departmentId: "engineering" }
+* });
+* ```
+*
+* @example With dependency tracking
+* ```tsx
+* const { data, refetch } = useOsdkFunction(calculateMetrics, {
+*   params: { startDate, endDate },
+*   dependsOn: [Employee, Project],
+* });
+* ```
+*
+* @example With specific object dependencies
+* ```tsx
+* const { data } = useOsdkFunction(getEmployeeReport, {
+*   params: { employeeId: employee.$primaryKey },
+*   dependsOnObjects: [employee],
+* });
+* ```
+*/
+export declare function useOsdkFunction<Q extends QueryDefinition<unknown>>(queryDef: Q, options?: UseOsdkFunctionOptions<Q>): UseOsdkFunctionResult<Q>;

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,qBACA,sBACA,MACA,uBACK,WAAY;AACnB,cAEE,oBACA,uBACK,kCAAmC;AAK1C,iBAAiB,uBAAuB,UAAU,0BAA0B;;;;;CAK1E,SAAS,oBAAoB,GAAG,sBAAsB,oCAElD,mBAAmB,oBAAoB,GAAG;;;;;;;;;;;CAY9C,YAAY,MAAM;;;;;;;;;;;;CAalB,mBAAmB,MAAM,KAAK,SAAS;;;;;;;CAQvC;;;;;;;;;;;;;;;;CAiBA;AACD;AAED,iBAAiB,sBAAsB,UAAU,0BAA0B;;;;CAIzE,MAAM,gBAAgB,oBAAoB,GAAG;;;;CAK7C;;;;CAKA,OAAO;;;;CAKP;;;;;CAMA;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCD,OAAO,iBAAS,gBAAgB,UAAU,0BACxCA,UAAU,GACVC,UAAS,uBAAuB,KAC/B,sBAAsB","names":["queryDef: Q","options: UseOsdkFunctionOptions<Q>"],"sources":["../../../src/new/useOsdkFunction.ts"],"version":3,"file":"useOsdkFunction.d.ts"}