@osdk/react 0.10.1-main-20260407074313 → 0.11.0-main-20260407144723

package/CHANGELOG.md

@@ -1,14 +1,19 @@
 # @osdkkit/react
 
-## 0.10.1-main-20260407074313
+## 0.11.0-main-20260407144723
+
+### Minor Changes
+
+- f8b9f12: Cache results from useOsdkFunctions
 
 ### Patch Changes
 
 - 51ccca8: Refactor hooks to use canonicalizeOptions for stable memo keys, add objectSet/hasMore/refetch to useOsdkObjects return, support undefined objectSet in useObjectSet
+- Updated dependencies [f8b9f12]
 - Updated dependencies [bcf359f]
 - Updated dependencies [51ccca8]
-  - @osdk/client@2.8.1-main-20260407074313
-  - @osdk/api@2.8.1-main-20260407074313
+  - @osdk/client@2.9.0-main-20260407144723
+  - @osdk/api@2.9.0-main-20260407144723
 
 ## 0.10.0
 

package/build/browser/new/useOsdkFunction.js

@@ -89,8 +89,8 @@ export function useOsdkFunction(queryDef, options = {}) {
     }, observer), process.env.NODE_ENV !== "production" ? `function ${queryDef.apiName} ${JSON.stringify(stableParams)}` : void 0);
   }, [observableClient, queryDef.apiName, queryDef.version, paramsForApi, stableDependsOn, stableDependsOnObjects, dedupeIntervalMs, enabled]);
   const payload = React.useSyncExternalStore(subscribe, getSnapShot);
-  const refetch = React.useCallback(() => {
-    void observableClient.invalidateFunction(queryDef, paramsForApi);
+  const refetch = React.useCallback(async () => {
+    await observableClient.invalidateFunction(queryDef, paramsForApi);
   }, [observableClient, queryDef, paramsForApi]);
   return React.useMemo(() => {
     const error = payload?.error ?? (payload?.status === "error" ? new Error("Failed to execute function") : undefined);

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkFunction.js","names":["getWireObjectSet","React","makeExternalStore","OsdkContext2","useOsdkFunction","queryDef","options","observableClient","useContext","params","dependsOn","dependsOnObjects","dedupeIntervalMs","enabled","stableParams","useMemo","JSON","stringify","stableDependsOn","map","d","apiName","stableDependsOnObjects","item","$apiName","$primaryKey","__objectSet","paramsForApi","subscribe","getSnapShot","unsubscribe","process","env","NODE_ENV","observer","observeFunction","dedupeInterval","version","payload","useSyncExternalStore","refetch","useCallback","invalidateFunction","error","status","Error","undefined","data","result","isLoading","lastUpdated"],"sources":["useOsdkFunction.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  CompileTimeMetadata,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  QueryDefinition,\n} from \"@osdk/api\";\nimport type {\n  ObserveFunctionCallbackArgs,\n  QueryParameterType,\n} from \"@osdk/client/unstable-do-not-use\";\nimport { getWireObjectSet } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkFunctionOptions<Q extends QueryDefinition<unknown>> {\n  /**\n   * Parameters to pass to the function.\n   * Must include all required parameters; optional parameters can be omitted.\n   */\n  params?: CompileTimeMetadata<Q>[\"parameters\"] extends Record<string, never>\n    ? undefined\n    : QueryParameterType<CompileTimeMetadata<Q>[\"parameters\"]>;\n\n  /**\n   * Object types this function depends on.\n   * When actions modify objects of these types, the function will automatically refetch.\n   *\n   * @example\n   * ```tsx\n   * // Refetch when any Employee object changes\n   * { dependsOn: [Employee] }\n   * ```\n   */\n  dependsOn?: Array<ObjectTypeDefinition | string>;\n\n  /**\n   * Specific object instances or ObjectSets this function depends on.\n   * When any of these specific objects change, the function will refetch.\n   * More fine-grained than dependsOn for precise invalidation control.\n   *\n   * For ObjectSets, the object type is extracted asynchronously and changes\n   * to any object of that type will trigger a refetch.\n   *\n   * @example\n   * ```tsx\n   * // Refetch when this specific employee changes\n   * { dependsOnObjects: [employee] }\n   *\n   * // Refetch when any object in the ObjectSet's type changes\n   * { dependsOnObjects: [employeeObjectSet] }\n   * ```\n   */\n  dependsOnObjects?: Array<\n    Osdk.Instance<ObjectTypeDefinition> | ObjectSet<ObjectTypeDefinition>\n  >;\n\n  /**\n   * The number of milliseconds to dedupe identical function calls.\n   * Two calls with the same function and params will share results\n   * if the second call is within this interval of the first.\n   * @default 2000\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * Whether to enable the query. When false, the query will not execute.\n   * Useful for:\n   * - Dependent queries that need to wait for other data\n   * - Conditional queries based on component state\n   *\n   * @default true\n   * @example\n   * // Dependent query - wait for required data\n   * const { data: employee } = useOsdkObject(Employee, employeeId);\n   * const { data: report } = useOsdkFunction(getEmployeeReport, {\n   *   params: { employeeId: employee?.$primaryKey },\n   *   enabled: !!employee\n   * });\n   */\n  enabled?: boolean;\n}\n\nexport interface UseOsdkFunctionResult<Q extends QueryDefinition<unknown>> {\n  /**\n   * The function result, or undefined if not yet loaded or on error.\n   */\n  data:\n    | (CompileTimeMetadata<Q>[\"signature\"] extends (...args: never[]) => infer R\n      ? Awaited<R>\n      : never)\n    | undefined;\n\n  /**\n   * True while the function is executing.\n   */\n  isLoading: boolean;\n\n  /**\n   * Error if the function execution failed.\n   */\n  error: Error | undefined;\n\n  /**\n   * Timestamp (ms since epoch) of when the result was last fetched.\n   */\n  lastUpdated: number;\n\n  /**\n   * Manually refetch the function.\n   * Useful for \"pull to refresh\" or retry patterns.\n   */\n  refetch: () => void;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\n/**\n * React hook for executing and observing OSDK functions.\n *\n * Provides automatic caching, deduplication, and reactive updates for function calls.\n * Functions are automatically re-fetched when dependencies change (configured via options).\n *\n * @param queryDef - The QueryDefinition to execute\n * @param options - Configuration options for the function call\n * @returns Object containing result, loading state, error, and refetch function\n *\n * @example Basic usage\n * ```tsx\n * const { data, isLoading, error } = useOsdkFunction(getEmployeeStats, {\n *   params: { departmentId: \"engineering\" }\n * });\n * ```\n *\n * @example With dependency tracking\n * ```tsx\n * const { data, refetch } = useOsdkFunction(calculateMetrics, {\n *   params: { startDate, endDate },\n *   dependsOn: [Employee, Project],\n * });\n * ```\n *\n * @example With specific object dependencies\n * ```tsx\n * const { data } = useOsdkFunction(getEmployeeReport, {\n *   params: { employeeId: employee.$primaryKey },\n *   dependsOnObjects: [employee],\n * });\n * ```\n */\nexport function useOsdkFunction<Q extends QueryDefinition<unknown>>(\n  queryDef: Q,\n  options: UseOsdkFunctionOptions<Q> = {},\n): UseOsdkFunctionResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n  const {\n    params,\n    dependsOn,\n    dependsOnObjects,\n    dedupeIntervalMs,\n    enabled = true,\n  } = options;\n\n  const stableParams = React.useMemo(\n    () => params,\n    [JSON.stringify(params)],\n  );\n  const stableDependsOn = React.useMemo(\n    () => dependsOn,\n    [JSON.stringify(\n      dependsOn?.map(d => typeof d === \"string\" ? d : d.apiName),\n    )],\n  );\n  const stableDependsOnObjects = React.useMemo(\n    () => dependsOnObjects,\n    [JSON.stringify(\n      dependsOnObjects?.map(item =>\n        \"$apiName\" in item\n          ? { $apiName: item.$apiName, $primaryKey: item.$primaryKey }\n          : { __objectSet: getWireObjectSet(item) }\n      ),\n    )],\n  );\n\n  // Record<string, unknown> required as typing is figured out at runtime\n  const paramsForApi = stableParams as Record<string, unknown> | undefined;\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      if (!enabled) {\n        return makeExternalStore<ObserveFunctionCallbackArgs<Q>>(\n          () => ({ unsubscribe: () => {} }),\n          process.env.NODE_ENV !== \"production\"\n            ? `function ${queryDef.apiName} ${\n              JSON.stringify(stableParams)\n            } [DISABLED]`\n            : void 0,\n        );\n      }\n      return makeExternalStore<ObserveFunctionCallbackArgs<Q>>(\n        (observer) =>\n          observableClient.observeFunction(\n            queryDef,\n            paramsForApi,\n            {\n              dependsOn: stableDependsOn,\n              dependsOnObjects: stableDependsOnObjects,\n              dedupeInterval: dedupeIntervalMs ?? 2_000,\n            },\n            observer,\n          ),\n        process.env.NODE_ENV !== \"production\"\n          ? `function ${queryDef.apiName} ${JSON.stringify(stableParams)}`\n          : void 0,\n      );\n    },\n    [\n      observableClient,\n      queryDef.apiName,\n      queryDef.version,\n      paramsForApi,\n      stableDependsOn,\n      stableDependsOnObjects,\n      dedupeIntervalMs,\n      enabled,\n    ],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  const refetch = React.useCallback(() => {\n    void observableClient.invalidateFunction(queryDef, paramsForApi);\n  }, [observableClient, queryDef, paramsForApi]);\n\n  return React.useMemo(() => {\n    const error = payload?.error\n      ?? (payload?.status === \"error\"\n        ? new Error(\"Failed to execute function\")\n        : undefined);\n\n    return {\n      data: payload?.result as UseOsdkFunctionResult<Q>[\"data\"],\n      isLoading: payload?.status === \"loading\",\n      error,\n      lastUpdated: payload?.lastUpdated ?? 0,\n      refetch,\n    };\n  }, [payload, refetch]);\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useOsdkFunction.js","names":["getWireObjectSet","React","makeExternalStore","OsdkContext2","useOsdkFunction","queryDef","options","observableClient","useContext","params","dependsOn","dependsOnObjects","dedupeIntervalMs","enabled","stableParams","useMemo","JSON","stringify","stableDependsOn","map","d","apiName","stableDependsOnObjects","item","$apiName","$primaryKey","__objectSet","paramsForApi","subscribe","getSnapShot","unsubscribe","process","env","NODE_ENV","observer","observeFunction","dedupeInterval","version","payload","useSyncExternalStore","refetch","useCallback","invalidateFunction","error","status","Error","undefined","data","result","isLoading","lastUpdated"],"sources":["useOsdkFunction.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  CompileTimeMetadata,\n  ObjectSet,\n  ObjectTypeDefinition,\n  Osdk,\n  QueryDefinition,\n} from \"@osdk/api\";\nimport type {\n  ObserveFunctionCallbackArgs,\n  QueryParameterType,\n} from \"@osdk/client/unstable-do-not-use\";\nimport { getWireObjectSet } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkFunctionOptions<Q extends QueryDefinition<unknown>> {\n  /**\n   * Parameters to pass to the function.\n   * Must include all required parameters; optional parameters can be omitted.\n   */\n  params?: CompileTimeMetadata<Q>[\"parameters\"] extends Record<string, never>\n    ? undefined\n    : QueryParameterType<CompileTimeMetadata<Q>[\"parameters\"]>;\n\n  /**\n   * Object types this function depends on.\n   * When actions modify objects of these types, the function will automatically refetch.\n   *\n   * @example\n   * ```tsx\n   * // Refetch when any Employee object changes\n   * { dependsOn: [Employee] }\n   * ```\n   */\n  dependsOn?: Array<ObjectTypeDefinition | string>;\n\n  /**\n   * Specific object instances or ObjectSets this function depends on.\n   * When any of these specific objects change, the function will refetch.\n   * More fine-grained than dependsOn for precise invalidation control.\n   *\n   * For ObjectSets, the object type is extracted asynchronously and changes\n   * to any object of that type will trigger a refetch.\n   *\n   * @example\n   * ```tsx\n   * // Refetch when this specific employee changes\n   * { dependsOnObjects: [employee] }\n   *\n   * // Refetch when any object in the ObjectSet's type changes\n   * { dependsOnObjects: [employeeObjectSet] }\n   * ```\n   */\n  dependsOnObjects?: Array<\n    Osdk.Instance<ObjectTypeDefinition> | ObjectSet<ObjectTypeDefinition>\n  >;\n\n  /**\n   * The number of milliseconds to dedupe identical function calls.\n   * Two calls with the same function and params will share results\n   * if the second call is within this interval of the first.\n   * @default 2000\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * Whether to enable the query. When false, the query will not execute.\n   * Useful for:\n   * - Dependent queries that need to wait for other data\n   * - Conditional queries based on component state\n   *\n   * @default true\n   * @example\n   * // Dependent query - wait for required data\n   * const { data: employee } = useOsdkObject(Employee, employeeId);\n   * const { data: report } = useOsdkFunction(getEmployeeReport, {\n   *   params: { employeeId: employee?.$primaryKey },\n   *   enabled: !!employee\n   * });\n   */\n  enabled?: boolean;\n}\n\nexport interface UseOsdkFunctionResult<Q extends QueryDefinition<unknown>> {\n  /**\n   * The function result, or undefined if not yet loaded or on error.\n   */\n  data:\n    | (CompileTimeMetadata<Q>[\"signature\"] extends (...args: never[]) => infer R\n      ? Awaited<R>\n      : never)\n    | undefined;\n\n  /**\n   * True while the function is executing.\n   */\n  isLoading: boolean;\n\n  /**\n   * Error if the function execution failed.\n   */\n  error: Error | undefined;\n\n  /**\n   * Timestamp (ms since epoch) of when the result was last fetched.\n   */\n  lastUpdated: number;\n\n  /**\n   * Manually refetch the function.\n   * Useful for \"pull to refresh\" or retry patterns.\n   */\n  refetch: () => Promise<void>;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\n/**\n * React hook for executing and observing OSDK functions.\n *\n * Provides automatic caching, deduplication, and reactive updates for function calls.\n * Functions are automatically re-fetched when dependencies change (configured via options).\n *\n * @param queryDef - The QueryDefinition to execute\n * @param options - Configuration options for the function call\n * @returns Object containing result, loading state, error, and refetch function\n *\n * @example Basic usage\n * ```tsx\n * const { data, isLoading, error } = useOsdkFunction(getEmployeeStats, {\n *   params: { departmentId: \"engineering\" }\n * });\n * ```\n *\n * @example With dependency tracking\n * ```tsx\n * const { data, refetch } = useOsdkFunction(calculateMetrics, {\n *   params: { startDate, endDate },\n *   dependsOn: [Employee, Project],\n * });\n * ```\n *\n * @example With specific object dependencies\n * ```tsx\n * const { data } = useOsdkFunction(getEmployeeReport, {\n *   params: { employeeId: employee.$primaryKey },\n *   dependsOnObjects: [employee],\n * });\n * ```\n */\nexport function useOsdkFunction<Q extends QueryDefinition<unknown>>(\n  queryDef: Q,\n  options: UseOsdkFunctionOptions<Q> = {},\n): UseOsdkFunctionResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n  const {\n    params,\n    dependsOn,\n    dependsOnObjects,\n    dedupeIntervalMs,\n    enabled = true,\n  } = options;\n\n  const stableParams = React.useMemo(\n    () => params,\n    [JSON.stringify(params)],\n  );\n  const stableDependsOn = React.useMemo(\n    () => dependsOn,\n    [JSON.stringify(\n      dependsOn?.map(d => typeof d === \"string\" ? d : d.apiName),\n    )],\n  );\n  const stableDependsOnObjects = React.useMemo(\n    () => dependsOnObjects,\n    [JSON.stringify(\n      dependsOnObjects?.map(item =>\n        \"$apiName\" in item\n          ? { $apiName: item.$apiName, $primaryKey: item.$primaryKey }\n          : { __objectSet: getWireObjectSet(item) }\n      ),\n    )],\n  );\n\n  // Record<string, unknown> required as typing is figured out at runtime\n  const paramsForApi = stableParams as Record<string, unknown> | undefined;\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      if (!enabled) {\n        return makeExternalStore<ObserveFunctionCallbackArgs<Q>>(\n          () => ({ unsubscribe: () => {} }),\n          process.env.NODE_ENV !== \"production\"\n            ? `function ${queryDef.apiName} ${\n              JSON.stringify(stableParams)\n            } [DISABLED]`\n            : void 0,\n        );\n      }\n      return makeExternalStore<ObserveFunctionCallbackArgs<Q>>(\n        (observer) =>\n          observableClient.observeFunction(\n            queryDef,\n            paramsForApi,\n            {\n              dependsOn: stableDependsOn,\n              dependsOnObjects: stableDependsOnObjects,\n              dedupeInterval: dedupeIntervalMs ?? 2_000,\n            },\n            observer,\n          ),\n        process.env.NODE_ENV !== \"production\"\n          ? `function ${queryDef.apiName} ${JSON.stringify(stableParams)}`\n          : void 0,\n      );\n    },\n    [\n      observableClient,\n      queryDef.apiName,\n      queryDef.version,\n      paramsForApi,\n      stableDependsOn,\n      stableDependsOnObjects,\n      dedupeIntervalMs,\n      enabled,\n    ],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  const refetch = React.useCallback(async () => {\n    await observableClient.invalidateFunction(queryDef, paramsForApi);\n  }, [observableClient, queryDef, paramsForApi]);\n\n  return React.useMemo(() => {\n    const error = payload?.error\n      ?? (payload?.status === \"error\"\n        ? new Error(\"Failed to execute function\")\n        : undefined);\n\n    return {\n      data: payload?.result as UseOsdkFunctionResult<Q>[\"data\"],\n      isLoading: payload?.status === \"loading\",\n      error,\n      lastUpdated: payload?.lastUpdated ?? 0,\n      refetch,\n    };\n  }, [payload, refetch]);\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/new/useOsdkFunctions.js

@@ -15,11 +15,17 @@
  */
 
 import React from "react";
-import { useOsdkClient } from "../useOsdkClient.js";
+import { OsdkContext2 } from "./OsdkContext2.js";
 /**
  * React hook for executing multiple OSDK function queries in parallel.
+ *
+ * This hook executes multiple function queries with individual configurations,
+ * with automatic caching and deduplication via the ObservableClient.
  * Results are returned in the same order as the input queries.
  *
+ * Queries with identical function+params share cached results through the
+ * Store layer, avoiding duplicate network requests across components.
+ *
  * @param options - Configuration options containing the queries to execute
  * @returns Array of results in the same order as input queries, each with the same shape as useOsdkFunction
  */
@@ -27,111 +33,90 @@ export function useOsdkFunctions({
   queries,
   enabled = true
 }) {
-  const client = useOsdkClient();
-  const [results, setResults] = React.useState(() => queries.map(() => ({
-    data: undefined,
-    isLoading: false,
-    error: undefined,
-    lastUpdated: 0
+  const {
+    observableClient
+  } = React.useContext(OsdkContext2);
+  const stableQueriesKey = JSON.stringify(queries.map(q => ({
+    apiName: q.queryDefinition.apiName,
+    params: q.options?.params,
+    enabled: q.options?.enabled,
+    dedupeIntervalMs: q.options?.dedupeIntervalMs
   })));
-  const abortControllerRef = React.useRef(null);
-  React.useEffect(() => {
-    if (!enabled || queries.length === 0) {
-      return;
+
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  const stableQueries = React.useMemo(() => queries, [stableQueriesKey]);
+
+  // Create a composite external store that manages N subscriptions
+  // We can't reuse makeExternalStore directly because it wraps a
+  // single Observer, but we need N observers funneled into one useSyncExternalStore.
+  const {
+    subscribe,
+    getSnapshot
+  } = React.useMemo(() => {
+    const count = stableQueries.length;
+    if (!enabled || count === 0) {
+      const empty = [];
+      return {
+        subscribe: () => () => {},
+        getSnapshot: () => empty
+      };
     }
 
-    // Cancel previous requests
-    abortControllerRef.current?.abort();
-    const abortController = new AbortController();
-    abortControllerRef.current = abortController;
-    void (async () => {
-      // Initialize loading state for all queries
-      setResults(prev => queries.map((_, index) => ({
-        data: prev[index]?.data,
-        // Preserving existing data
-        isLoading: queries[index].options?.enabled !== false,
-        error: undefined,
-        lastUpdated: prev[index]?.lastUpdated || 0
-      })));
-      for await (const queryResult of executeQueriesGenerator(queries, client)) {
-        const {
-          index,
-          result,
-          error
-        } = queryResult;
-        if (abortController.signal.aborted) {
-          break;
-        }
-        setResults(prev => {
-          if (abortController.signal.aborted) {
-            return prev;
+    // Mutable snapshot array — replaced (never mutated in place) on each
+    // observer callback so that useSyncExternalStore sees a new reference.
+    let current = stableQueries.map(() => undefined);
+    const updateSlot = (index, value) => {
+      const next = [...current];
+      next[index] = value;
+      current = next;
+    };
+    return {
+      getSnapshot: () => current,
+      subscribe: notifyUpdate => {
+        const subscriptions = [];
+        stableQueries.forEach((query, index) => {
+          if (query.options?.enabled === false) {
+            return;
           }
-          const newResults = [...prev];
-          newResults[index] = {
-            data: result,
-            isLoading: false,
-            error: error instanceof Error ? error : error ? new Error(typeof error === "string" ? error : JSON.stringify(error)) : undefined,
-            lastUpdated: Date.now()
-          };
-          return newResults;
+          const params = query.options?.params;
+          const sub = observableClient.observeFunction(query.queryDefinition, params, {
+            dedupeInterval: query.options?.dedupeIntervalMs ?? 2_000
+          }, {
+            next: payload => {
+              updateSlot(index, payload);
+              notifyUpdate();
+            },
+            error: error => {
+              updateSlot(index, {
+                ...(current[index] ?? {}),
+                error: error instanceof Error ? error : new Error(String(error))
+              });
+              notifyUpdate();
+            },
+            complete: () => {}
+          });
+          subscriptions.push(sub);
         });
+        return () => {
+          subscriptions.forEach(sub => sub.unsubscribe());
+        };
       }
-    })();
-    return () => {
-      abortController.abort();
     };
-  }, [enabled, client, queries]);
-  return results;
-}
-/**
- * Generator function that executes queries and yields results as they complete
- */
-async function* executeQueriesGenerator(queries, client) {
-  const queryPromises = queries.map((query, index) => createQueryPromise(query, index, client));
-  const pendingPromises = [...queryPromises];
-
-  // Yield results as they complete using Promise.race
-  while (pendingPromises.length > 0) {
-    const raceResult = await Promise.race(pendingPromises.map((promise, idx) => promise.then(result => ({
-      result,
-      idx
-    }))));
-    yield raceResult.result;
-
-    // Remove the completed promise from the pending list
-    void pendingPromises.splice(raceResult.idx, 1);
-  }
-}
-const createQueryPromise = async (query, index, client) => {
-  // Skip disabled queries
-  if (query.options?.enabled === false) {
+  }, [enabled, observableClient, stableQueries]);
+  const payloads = React.useSyncExternalStore(subscribe, getSnapshot);
+  const refetches = React.useMemo(() => stableQueries.map(query => async () => {
+    await observableClient.invalidateFunction(query.queryDefinition, query.options?.params);
+  }), [stableQueries, observableClient]);
+  return React.useMemo(() => stableQueries.map((_, index) => {
+    const payload = payloads[index];
+    const error = payload?.error ?? (payload?.status === "error" ? new Error("Failed to execute function") : undefined);
     return {
-      index,
-      result: undefined,
-      error: undefined
+      data: payload?.result,
+      isLoading: payload?.status === "loading",
+      error,
+      lastUpdated: payload?.lastUpdated ?? 0,
+      refetch: refetches[index]
     };
-  }
-  const queryClient = client(query.queryDefinition);
-  if ("executeFunction" in queryClient && typeof queryClient.executeFunction === "function") {
-    try {
-      const result = await queryClient.executeFunction(query.options?.params);
-      return {
-        index,
-        result,
-        error: null
-      };
-    } catch (error) {
-      return {
-        index,
-        result: undefined,
-        error
-      };
-    }
-  }
-  return {
-    index,
-    result: undefined,
-    error: new Error("Invalid query client: executeFunction method not found")
-  };
-};
+  }), [stableQueries, payloads, refetches]);
+}
 //# sourceMappingURL=useOsdkFunctions.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkFunctions.js","names":["React","useOsdkClient","useOsdkFunctions","queries","enabled","client","results","setResults","useState","map","data","undefined","isLoading","error","lastUpdated","abortControllerRef","useRef","useEffect","length","current","abort","abortController","AbortController","prev","_","index","options","queryResult","executeQueriesGenerator","result","signal","aborted","newResults","Error","JSON","stringify","Date","now","queryPromises","query","createQueryPromise","pendingPromises","raceResult","Promise","race","promise","idx","then","splice","queryClient","queryDefinition","executeFunction","params"],"sources":["useOsdkFunctions.ts"],"sourcesContent":["/*\n * Copyright 2026 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 { CompileTimeMetadata, QueryDefinition } from \"@osdk/api\";\nimport type { Client } from \"@osdk/client\";\nimport React from \"react\";\nimport { useOsdkClient } from \"../useOsdkClient.js\";\nimport type {\n  UseOsdkFunctionOptions,\n  UseOsdkFunctionResult,\n} from \"./useOsdkFunction.js\";\n\nexport interface FunctionQueryParams<Q extends QueryDefinition<unknown>> {\n  queryDefinition: Q;\n  /**\n   * Only allow params and enabled options at the query level,\n   * other options are not yet supported in this batch context\n   */\n  options?: Pick<UseOsdkFunctionOptions<Q>, \"params\" | \"enabled\">;\n}\n\nexport interface UseOsdkFunctionsProps {\n  /**\n   * Array of query configurations to execute\n   */\n  queries: Array<FunctionQueryParams<QueryDefinition<unknown>>>;\n\n  /**\n   * Whether to enable all queries. When false, no queries will execute.\n   * Individual query enabled states are also respected.\n   * @default true\n   */\n  enabled?: boolean;\n}\n\nexport type UseOsdkFunctionsResult = Array<\n  Omit<UseOsdkFunctionResult<QueryDefinition<unknown>>, \"refetch\">\n>;\n\n/**\n * React hook for executing multiple OSDK function queries in parallel.\n * Results are returned in the same order as the input queries.\n *\n * @param options - Configuration options containing the queries to execute\n * @returns Array of results in the same order as input queries, each with the same shape as useOsdkFunction\n */\nexport function useOsdkFunctions(\n  { queries, enabled = true }: UseOsdkFunctionsProps,\n): UseOsdkFunctionsResult {\n  const client = useOsdkClient();\n\n  const [results, setResults] = React.useState<\n    UseOsdkFunctionsResult\n  >(() =>\n    queries.map(() => ({\n      data: undefined,\n      isLoading: false,\n      error: undefined,\n      lastUpdated: 0,\n    }))\n  );\n\n  const abortControllerRef = React.useRef<AbortController | null>(null);\n\n  React.useEffect(() => {\n    if (!enabled || queries.length === 0) {\n      return;\n    }\n\n    // Cancel previous requests\n    abortControllerRef.current?.abort();\n\n    const abortController = new AbortController();\n    abortControllerRef.current = abortController;\n\n    const executeQueries = async () => {\n      // Initialize loading state for all queries\n      setResults(prev =>\n        queries.map((_, index) => ({\n          data: prev[index]?.data, // Preserving existing data\n          isLoading: queries[index].options?.enabled !== false,\n          error: undefined,\n          lastUpdated: prev[index]?.lastUpdated || 0,\n        }))\n      );\n\n      for await (\n        const queryResult of executeQueriesGenerator(\n          queries,\n          client,\n        )\n      ) {\n        const { index, result, error } = queryResult;\n\n        if (abortController.signal.aborted) {\n          break;\n        }\n\n        setResults(prev => {\n          if (abortController.signal.aborted) {\n            return prev;\n          }\n          const newResults = [...prev];\n          newResults[index] = {\n            data: result,\n            isLoading: false,\n            error: error instanceof Error\n              ? error\n              : error\n              ? new Error(\n                typeof error === \"string\" ? error : JSON.stringify(error),\n              )\n              : undefined,\n            lastUpdated: Date.now(),\n          };\n          return newResults;\n        });\n      }\n    };\n\n    void executeQueries();\n\n    return () => {\n      abortController.abort();\n    };\n  }, [\n    enabled,\n    client,\n    queries,\n  ]);\n\n  return results;\n}\n\ninterface QueryResult<Q extends QueryDefinition<unknown>> {\n  index: number;\n  result?:\n    | (CompileTimeMetadata<Q>[\"signature\"] extends (...args: never[]) => infer R\n      ? Awaited<R>\n      : never)\n    | undefined;\n  error?: unknown;\n}\n/**\n * Generator function that executes queries and yields results as they complete\n */\nasync function* executeQueriesGenerator(\n  queries: Array<FunctionQueryParams<QueryDefinition<unknown>>>,\n  client: Client,\n): AsyncGenerator<QueryResult<QueryDefinition<unknown>>> {\n  const queryPromises = queries.map((query, index) =>\n    createQueryPromise<typeof query.queryDefinition>(query, index, client)\n  );\n\n  const pendingPromises = [...queryPromises];\n\n  // Yield results as they complete using Promise.race\n  while (pendingPromises.length > 0) {\n    const raceResult = await Promise.race(\n      pendingPromises.map((promise, idx) =>\n        promise.then(result => ({ result, idx }))\n      ),\n    );\n\n    yield raceResult.result;\n\n    // Remove the completed promise from the pending list\n    void pendingPromises.splice(raceResult.idx, 1);\n  }\n}\n\nconst createQueryPromise = async <Q extends QueryDefinition<unknown>>(\n  query: FunctionQueryParams<Q>,\n  index: number,\n  client: Client,\n): Promise<QueryResult<Q>> => {\n  // Skip disabled queries\n  if (query.options?.enabled === false) {\n    return { index, result: undefined, error: undefined };\n  }\n\n  const queryClient = client(query.queryDefinition);\n\n  if (\n    \"executeFunction\" in queryClient\n    && typeof queryClient.executeFunction === \"function\"\n  ) {\n    try {\n      const result = await queryClient.executeFunction(query.options?.params);\n      return { index, result, error: null };\n    } catch (error) {\n      return { index, result: undefined, error };\n    }\n  }\n\n  return {\n    index,\n    result: undefined,\n    error: new Error(\"Invalid query client: executeFunction method not found\"),\n  };\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useOsdkFunctions.js","names":["React","OsdkContext2","useOsdkFunctions","queries","enabled","observableClient","useContext","stableQueriesKey","JSON","stringify","map","q","apiName","queryDefinition","params","options","dedupeIntervalMs","stableQueries","useMemo","subscribe","getSnapshot","count","length","empty","current","undefined","updateSlot","index","value","next","notifyUpdate","subscriptions","forEach","query","sub","observeFunction","dedupeInterval","payload","error","Error","String","complete","push","unsubscribe","payloads","useSyncExternalStore","refetches","invalidateFunction","_","status","data","result","isLoading","lastUpdated","refetch"],"sources":["useOsdkFunctions.ts"],"sourcesContent":["/*\n * Copyright 2026 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 { QueryDefinition } from \"@osdk/api\";\nimport type { ObserveFunctionCallbackArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport type { Snapshot } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nimport type {\n  UseOsdkFunctionOptions,\n  UseOsdkFunctionResult,\n} from \"./useOsdkFunction.js\";\n\nexport interface FunctionQueryParams<Q extends QueryDefinition<unknown>> {\n  queryDefinition: Q;\n  /**\n   * Only allow params and enabled options at the query level,\n   * other options are not yet supported in this batch context\n   */\n  options?: Pick<\n    UseOsdkFunctionOptions<Q>,\n    \"params\" | \"enabled\" | \"dedupeIntervalMs\"\n  >;\n}\n\nexport interface UseOsdkFunctionsProps {\n  /**\n   * Array of query configurations to execute\n   */\n  queries: Array<FunctionQueryParams<QueryDefinition<unknown>>>;\n\n  /**\n   * Whether to enable all queries. When false, no queries will execute.\n   * Individual query enabled states are also respected.\n   * @default true\n   */\n  enabled?: boolean;\n}\n\nexport type UseOsdkFunctionsResult = Array<\n  UseOsdkFunctionResult<QueryDefinition<unknown>>\n>;\n\ntype FunctionPayload = ObserveFunctionCallbackArgs<QueryDefinition<unknown>>;\n\n/**\n * React hook for executing multiple OSDK function queries in parallel.\n *\n * This hook executes multiple function queries with individual configurations,\n * with automatic caching and deduplication via the ObservableClient.\n * Results are returned in the same order as the input queries.\n *\n * Queries with identical function+params share cached results through the\n * Store layer, avoiding duplicate network requests across components.\n *\n * @param options - Configuration options containing the queries to execute\n * @returns Array of results in the same order as input queries, each with the same shape as useOsdkFunction\n */\nexport function useOsdkFunctions(\n  { queries, enabled = true }: UseOsdkFunctionsProps,\n): UseOsdkFunctionsResult {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  const stableQueriesKey = JSON.stringify(queries.map(q => ({\n    apiName: q.queryDefinition.apiName,\n    params: q.options?.params,\n    enabled: q.options?.enabled,\n    dedupeIntervalMs: q.options?.dedupeIntervalMs,\n  })));\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  const stableQueries = React.useMemo(() => queries, [stableQueriesKey]);\n\n  // Create a composite external store that manages N subscriptions\n  // We can't reuse makeExternalStore directly because it wraps a\n  // single Observer, but we need N observers funneled into one useSyncExternalStore.\n  const { subscribe, getSnapshot } = React.useMemo(\n    () => {\n      const count = stableQueries.length;\n\n      if (!enabled || count === 0) {\n        const empty: Array<Snapshot<FunctionPayload>> = [];\n        return {\n          subscribe: () => () => {},\n          getSnapshot: () => empty,\n        };\n      }\n\n      // Mutable snapshot array — replaced (never mutated in place) on each\n      // observer callback so that useSyncExternalStore sees a new reference.\n      let current: Array<Snapshot<FunctionPayload>> = stableQueries.map(\n        () => undefined,\n      );\n\n      const updateSlot = (\n        index: number,\n        value: Snapshot<FunctionPayload>,\n      ) => {\n        const next = [...current];\n        next[index] = value;\n        current = next;\n      };\n\n      return {\n        getSnapshot: () => current,\n        subscribe: (notifyUpdate: () => void) => {\n          const subscriptions: Array<{ unsubscribe: () => void }> = [];\n\n          stableQueries.forEach((query, index) => {\n            if (query.options?.enabled === false) {\n              return;\n            }\n\n            const params = query.options?.params as\n              | Record<string, unknown>\n              | undefined;\n\n            const sub = observableClient.observeFunction(\n              query.queryDefinition,\n              params,\n              { dedupeInterval: query.options?.dedupeIntervalMs ?? 2_000 },\n              {\n                next: (payload: FunctionPayload | undefined) => {\n                  updateSlot(\n                    index,\n                    payload as Snapshot<FunctionPayload>,\n                  );\n                  notifyUpdate();\n                },\n                error: (error: unknown) => {\n                  updateSlot(index, {\n                    ...(current[index] ?? {}),\n                    error: error instanceof Error\n                      ? error\n                      : new Error(String(error)),\n                  } as Snapshot<FunctionPayload>);\n                  notifyUpdate();\n                },\n                complete: () => {},\n              },\n            );\n\n            subscriptions.push(sub);\n          });\n\n          return () => {\n            subscriptions.forEach(sub => sub.unsubscribe());\n          };\n        },\n      };\n    },\n    [enabled, observableClient, stableQueries],\n  );\n\n  const payloads = React.useSyncExternalStore(subscribe, getSnapshot);\n\n  const refetches = React.useMemo(\n    () =>\n      stableQueries.map((query) => async () => {\n        await observableClient.invalidateFunction(\n          query.queryDefinition,\n          query.options?.params as Record<string, unknown> | undefined,\n        );\n      }),\n    [stableQueries, observableClient],\n  );\n\n  return React.useMemo(\n    () =>\n      stableQueries.map((_, index): UseOsdkFunctionResult<\n        QueryDefinition<unknown>\n      > => {\n        const payload = payloads[index];\n        const error = payload?.error\n          ?? (payload?.status === \"error\"\n            ? new Error(\"Failed to execute function\")\n            : undefined);\n\n        return {\n          data: payload?.result as UseOsdkFunctionResult<\n            QueryDefinition<unknown>\n          >[\"data\"],\n          isLoading: payload?.status === \"loading\",\n          error,\n          lastUpdated: payload?.lastUpdated ?? 0,\n          refetch: refetches[index],\n        };\n      }),\n    [stableQueries, payloads, refetches],\n  );\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/public/experimental.js

@@ -20,6 +20,7 @@ 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 { useOsdkFunctions } from "../new/useOsdkFunctions.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
 export { useOsdkObjects } from "../new/useOsdkObjects.js";
 export { useOsdkClient } from "../useOsdkClient.js";

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

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["OsdkProvider2","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 { 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 {\n  UseOsdkListResult,\n  UseOsdkObjectsOptions,\n} 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;AAKjE,SAASC,eAAe,QAAQ,2BAA2B;AAC3D,SAASC,aAAa,QAAQ,yBAAyB;AAKvD,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","useLinks","useObjectSet","useOsdkAction","useOsdkAggregation","useOsdkFunction","useOsdkFunctions","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 type {\n  UseOsdkFunctionOptions,\n  UseOsdkFunctionResult,\n} from \"../new/useOsdkFunction.js\";\nexport { useOsdkFunction } from \"../new/useOsdkFunction.js\";\nexport { useOsdkFunctions } from \"../new/useOsdkFunctions.js\";\nexport type {\n  FunctionQueryParams,\n  UseOsdkFunctionsProps,\n  UseOsdkFunctionsResult,\n} from \"../new/useOsdkFunctions.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport type {\n  UseOsdkListResult,\n  UseOsdkObjectsOptions,\n} 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;AAKjE,SAASC,eAAe,QAAQ,2BAA2B;AAC3D,SAASC,gBAAgB,QAAQ,4BAA4B;AAM7D,SAASC,aAAa,QAAQ,yBAAyB;AAKvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB;AACnD,SAASC,eAAe,QAAQ,uBAAuB;AAEvD,SAASC,oBAAoB,QAAQ,kCAAkC","ignoreList":[]}

package/build/cjs/chunk-OVBG5VXE.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+var React3 = require('react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React3__default = /*#__PURE__*/_interopDefault(React3);
+
+// src/useOsdkClient.ts
+function fakeClientFn(..._args) {
+  throw new Error("This is not a real client. Did you forget to <OsdkContext.Provider>?");
+}
+var fakeClient = Object.assign(fakeClientFn, {
+  fetchMetadata: fakeClientFn
+});
+var OsdkContext = /* @__PURE__ */ React3__default.default.createContext({
+  client: fakeClient
+});
+
+// src/useOsdkClient.ts
+function useOsdkClient() {
+  return React3__default.default.useContext(OsdkContext).client;
+}
+function useOsdkMetadata(type) {
+  const client = useOsdkClient();
+  const [metadata, setMetadata] = React3__default.default.useState(void 0);
+  const [error, setError] = React3__default.default.useState();
+  if (!metadata && !error) {
+    client.fetchMetadata(type).then((fetchedMetadata) => {
+      setMetadata(fetchedMetadata);
+    }).catch((error2) => {
+      const errorMessage = error2 instanceof Error ? error2.message : String(error2);
+      setError(errorMessage);
+    });
+    return {
+      loading: true
+    };
+  }
+  return {
+    loading: false,
+    metadata,
+    error
+  };
+}
+
+exports.OsdkContext = OsdkContext;
+exports.useOsdkClient = useOsdkClient;
+exports.useOsdkMetadata = useOsdkMetadata;
+//# sourceMappingURL=chunk-OVBG5VXE.cjs.map
+//# sourceMappingURL=chunk-OVBG5VXE.cjs.map

package/build/cjs/chunk-OVBG5VXE.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/OsdkContext.ts","../../src/useOsdkClient.ts","../../src/useOsdkMetadata.ts"],"names":["React","error"],"mappings":";;;;;;;;;AAiBA,SAAS,gBAAgB,KAAO,EAAA;AAC9B,EAAM,MAAA,IAAI,MAAM,sEAAsE,CAAA;AACxF;AACA,IAAM,UAAA,GAAa,MAAO,CAAA,MAAA,CAAO,YAAc,EAAA;AAAA,EAC7C,aAAe,EAAA;AACjB,CAAC,CAAA;AACY,IAAA,WAAA,2CAAiC,aAAc,CAAA;AAAA,EAC1D,MAAQ,EAAA;AACV,CAAC;;;ACPM,SAAS,aAAgB,GAAA;AAC9B,EAAOA,OAAAA,uBAAAA,CAAM,UAAW,CAAA,WAAW,CAAE,CAAA,MAAA;AACvC;ACFO,SAAS,gBAAgB,IAAM,EAAA;AACpC,EAAA,MAAM,SAAS,aAAc,EAAA;AAC7B,EAAA,MAAM,CAAC,QAAU,EAAA,WAAW,CAAIA,GAAAA,uBAAAA,CAAM,SAAS,MAAS,CAAA;AACxD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,wBAAM,QAAS,EAAA;AACzC,EAAI,IAAA,CAAC,QAAY,IAAA,CAAC,KAAO,EAAA;AACvB,IAAA,MAAA,CAAO,aAAc,CAAA,IAAI,CAAE,CAAA,IAAA,CAAK,CAAmB,eAAA,KAAA;AACjD,MAAA,WAAA,CAAY,eAAe,CAAA;AAAA,KAC5B,CAAA,CAAE,KAAM,CAAA,CAAAC,MAAS,KAAA;AAChB,MAAA,MAAM,eAAeA,MAAiB,YAAA,KAAA,GAAQA,MAAM,CAAA,OAAA,GAAU,OAAOA,MAAK,CAAA;AAC1E,MAAA,QAAA,CAAS,YAAY,CAAA;AAAA,KACtB,CAAA;AACD,IAAO,OAAA;AAAA,MACL,OAAS,EAAA;AAAA,KACX;AAAA;AAEF,EAAO,OAAA;AAAA,IACL,OAAS,EAAA,KAAA;AAAA,IACT,QAAA;AAAA,IACA;AAAA,GACF;AACF","file":"chunk-OVBG5VXE.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nfunction fakeClientFn(..._args) {\n  throw new Error(\"This is not a real client. Did you forget to <OsdkContext.Provider>?\");\n}\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn\n});\nexport const OsdkContext = /*#__PURE__*/React.createContext({\n  client: fakeClient\n});","/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { OsdkContext } from \"./OsdkContext.js\";\nexport function useOsdkClient() {\n  return React.useContext(OsdkContext).client;\n}","/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { useOsdkClient } from \"./useOsdkClient.js\";\nexport function useOsdkMetadata(type) {\n  const client = useOsdkClient();\n  const [metadata, setMetadata] = React.useState(undefined);\n  const [error, setError] = React.useState();\n  if (!metadata && !error) {\n    client.fetchMetadata(type).then(fetchedMetadata => {\n      setMetadata(fetchedMetadata);\n    }).catch(error => {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      setError(errorMessage);\n    });\n    return {\n      loading: true\n    };\n  }\n  return {\n    loading: false,\n    metadata,\n    error\n  };\n}"]}

package/build/cjs/index.cjs

@@ -1,7 +1,6 @@
 'use strict';
 
-var chunkR4FZ5MUH_cjs = require('./chunk-R4FZ5MUH.cjs');
-var chunk2N32USW5_cjs = require('./chunk-2N32USW5.cjs');
+var chunkOVBG5VXE_cjs = require('./chunk-OVBG5VXE.cjs');
 var React = require('react');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -12,20 +11,20 @@ function OsdkProvider({
   children,
   client
 }) {
-  return /* @__PURE__ */ React__default.default.createElement(chunk2N32USW5_cjs.OsdkContext.Provider, {
+  return /* @__PURE__ */ React__default.default.createElement(chunkOVBG5VXE_cjs.OsdkContext.Provider, {
     value: {
       client
     }
   }, children);
 }
 
-Object.defineProperty(exports, "useOsdkMetadata", {
+Object.defineProperty(exports, "useOsdkClient", {
   enumerable: true,
-  get: function () { return chunkR4FZ5MUH_cjs.useOsdkMetadata; }
+  get: function () { return chunkOVBG5VXE_cjs.useOsdkClient; }
 });
-Object.defineProperty(exports, "useOsdkClient", {
+Object.defineProperty(exports, "useOsdkMetadata", {
   enumerable: true,
-  get: function () { return chunk2N32USW5_cjs.useOsdkClient; }
+  get: function () { return chunkOVBG5VXE_cjs.useOsdkMetadata; }
 });
 exports.OsdkProvider = OsdkProvider;
 //# sourceMappingURL=index.cjs.map

package/build/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/OsdkProvider.tsx"],"names":["React","OsdkContext"],"mappings":";;;;;;;;;;AAkBO,SAAS,YAAa,CAAA;AAAA,EAC3B,QAAA;AAAA,EACA;AACF,CAAG,EAAA;AACD,EAAoB,uBAAAA,sBAAA,CAAM,aAAc,CAAAC,6BAAA,CAAY,QAAU,EAAA;AAAA,IAC5D,KAAO,EAAA;AAAA,MACL;AAAA;AACF,KACC,QAAQ,CAAA;AACb","file":"index.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { OsdkContext } from \"./OsdkContext.js\";\nexport function OsdkProvider({\n  children,\n  client\n}) {\n  return /*#__PURE__*/React.createElement(OsdkContext.Provider, {\n    value: {\n      client\n    }\n  }, children);\n}"]}
+{"version":3,"sources":["../../src/OsdkProvider.tsx"],"names":["React","OsdkContext"],"mappings":";;;;;;;;;AAkBO,SAAS,YAAa,CAAA;AAAA,EAC3B,QAAA;AAAA,EACA;AACF,CAAG,EAAA;AACD,EAAoB,uBAAAA,sBAAA,CAAM,aAAc,CAAAC,6BAAA,CAAY,QAAU,EAAA;AAAA,IAC5D,KAAO,EAAA;AAAA,MACL;AAAA;AACF,KACC,QAAQ,CAAA;AACb","file":"index.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { OsdkContext } from \"./OsdkContext.js\";\nexport function OsdkProvider({\n  children,\n  client\n}) {\n  return /*#__PURE__*/React.createElement(OsdkContext.Provider, {\n    value: {\n      client\n    }\n  }, children);\n}"]}

package/build/cjs/public/experimental.cjs

@@ -1,7 +1,6 @@
 'use strict';
 
-var chunkR4FZ5MUH_cjs = require('../chunk-R4FZ5MUH.cjs');
-var chunk2N32USW5_cjs = require('../chunk-2N32USW5.cjs');
+var chunkOVBG5VXE_cjs = require('../chunk-OVBG5VXE.cjs');
 var chunkZUNR45SJ_cjs = require('../chunk-ZUNR45SJ.cjs');
 var unstableDoNotUse = require('@osdk/client/unstable-do-not-use');
 var React4 = require('react');
@@ -22,7 +21,7 @@ function OsdkProvider2({
       client,
       observableClient
     }
-  }, /* @__PURE__ */ React4__default.default.createElement(chunk2N32USW5_cjs.OsdkContext.Provider, {
+  }, /* @__PURE__ */ React4__default.default.createElement(chunkOVBG5VXE_cjs.OsdkContext.Provider, {
     value: {
       client
     }
@@ -424,8 +423,8 @@ function useOsdkFunction(queryDef, options = {}) {
     }, observer), process.env.NODE_ENV !== "production" ? `function ${queryDef.apiName} ${JSON.stringify(stableParams)}` : void 0);
   }, [observableClient, queryDef.apiName, queryDef.version, paramsForApi, stableDependsOn, stableDependsOnObjects, dedupeIntervalMs, enabled]);
   const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  const refetch = React4__default.default.useCallback(() => {
-    void observableClient.invalidateFunction(queryDef, paramsForApi);
+  const refetch = React4__default.default.useCallback(async () => {
+    await observableClient.invalidateFunction(queryDef, paramsForApi);
   }, [observableClient, queryDef, paramsForApi]);
   return React4__default.default.useMemo(() => {
     const error = payload?.error ?? (payload?.status === "error" ? new Error("Failed to execute function") : void 0);
@@ -438,6 +437,89 @@ function useOsdkFunction(queryDef, options = {}) {
     };
   }, [payload, refetch]);
 }
+function useOsdkFunctions({
+  queries,
+  enabled = true
+}) {
+  const {
+    observableClient
+  } = React4__default.default.useContext(chunkZUNR45SJ_cjs.OsdkContext2);
+  const stableQueriesKey = JSON.stringify(queries.map((q) => ({
+    apiName: q.queryDefinition.apiName,
+    params: q.options?.params,
+    enabled: q.options?.enabled,
+    dedupeIntervalMs: q.options?.dedupeIntervalMs
+  })));
+  const stableQueries = React4__default.default.useMemo(() => queries, [stableQueriesKey]);
+  const {
+    subscribe,
+    getSnapshot
+  } = React4__default.default.useMemo(() => {
+    const count = stableQueries.length;
+    if (!enabled || count === 0) {
+      const empty = [];
+      return {
+        subscribe: () => () => {
+        },
+        getSnapshot: () => empty
+      };
+    }
+    let current = stableQueries.map(() => void 0);
+    const updateSlot = (index, value) => {
+      const next = [...current];
+      next[index] = value;
+      current = next;
+    };
+    return {
+      getSnapshot: () => current,
+      subscribe: (notifyUpdate) => {
+        const subscriptions = [];
+        stableQueries.forEach((query, index) => {
+          if (query.options?.enabled === false) {
+            return;
+          }
+          const params = query.options?.params;
+          const sub = observableClient.observeFunction(query.queryDefinition, params, {
+            dedupeInterval: query.options?.dedupeIntervalMs ?? 2e3
+          }, {
+            next: (payload) => {
+              updateSlot(index, payload);
+              notifyUpdate();
+            },
+            error: (error) => {
+              updateSlot(index, {
+                ...current[index] ?? {},
+                error: error instanceof Error ? error : new Error(String(error))
+              });
+              notifyUpdate();
+            },
+            complete: () => {
+            }
+          });
+          subscriptions.push(sub);
+        });
+        return () => {
+          subscriptions.forEach((sub) => sub.unsubscribe());
+        };
+      }
+    };
+  }, [enabled, observableClient, stableQueries]);
+  const payloads = React4__default.default.useSyncExternalStore(subscribe, getSnapshot);
+  const refetches = React4__default.default.useMemo(() => stableQueries.map((query) => async () => {
+    await observableClient.invalidateFunction(query.queryDefinition, query.options?.params);
+  }), [stableQueries, observableClient]);
+  return React4__default.default.useMemo(() => stableQueries.map((_, index) => {
+    const payload = payloads[index];
+    const error = payload?.error ?? (payload?.status === "error" ? new Error("Failed to execute function") : void 0);
+    return {
+      data: payload?.result,
+      isLoading: payload?.status === "loading",
+      error,
+      lastUpdated: payload?.lastUpdated ?? 0,
+      refetch: refetches[index]
+    };
+  }), [stableQueries, payloads, refetches]);
+}
 function useOsdkObject(...args) {
   const {
     observableClient
@@ -605,13 +687,13 @@ function useDebouncedCallback(callback, delay) {
   });
 }
 
-Object.defineProperty(exports, "useOsdkMetadata", {
+Object.defineProperty(exports, "useOsdkClient", {
   enumerable: true,
-  get: function () { return chunkR4FZ5MUH_cjs.useOsdkMetadata; }
+  get: function () { return chunkOVBG5VXE_cjs.useOsdkClient; }
 });
-Object.defineProperty(exports, "useOsdkClient", {
+Object.defineProperty(exports, "useOsdkMetadata", {
   enumerable: true,
-  get: function () { return chunk2N32USW5_cjs.useOsdkClient; }
+  get: function () { return chunkOVBG5VXE_cjs.useOsdkMetadata; }
 });
 exports.OsdkProvider2 = OsdkProvider2;
 exports.useDebouncedCallback = useDebouncedCallback;
@@ -620,6 +702,7 @@ exports.useObjectSet = useObjectSet;
 exports.useOsdkAction = useOsdkAction;
 exports.useOsdkAggregation = useOsdkAggregation;
 exports.useOsdkFunction = useOsdkFunction;
+exports.useOsdkFunctions = useOsdkFunctions;
 exports.useOsdkObject = useOsdkObject;
 exports.useOsdkObjects = useOsdkObjects;
 //# sourceMappingURL=experimental.cjs.map