@osdk/react 0.10.0-beta.9 → 0.10.1-main-20260406220320

package/build/browser/new/useOsdkFunctions.js

@@ -0,0 +1,137 @@
+/*
+ * Copyright 2026 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 { useOsdkClient } from "../useOsdkClient.js";
+/**
+ * React hook for executing multiple OSDK function queries in parallel.
+ * Results are returned in the same order as the input queries.
+ *
+ * @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
+ */
+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 abortControllerRef = React.useRef(null);
+  React.useEffect(() => {
+    if (!enabled || queries.length === 0) {
+      return;
+    }
+
+    // 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;
+          }
+          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;
+        });
+      }
+    })();
+    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) {
+    return {
+      index,
+      result: undefined,
+      error: undefined
+    };
+  }
+  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")
+  };
+};
+//# sourceMappingURL=useOsdkFunctions.js.map

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

@@ -0,0 +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":[]}

package/build/browser/new/useOsdkObject.js

@@ -36,7 +36,7 @@ import { OsdkContext2 } from "./OsdkContext2.js";
  *
  * @param type The object type or interface definition
  * @param primaryKey The primary key of the object
- * @param options Options including $select and enabled
+ * @param options Options including $select, enabled, and $loadPropertySecurityMetadata
  */
 
 /*
@@ -58,6 +58,7 @@ export function useOsdkObject(...args) {
   // Extract enabled flag - 2nd param for instance signature, 3rd for type signature
   const enabled = isInstanceSignature ? typeof args[1] === "boolean" ? args[1] : true : optionsArg ? optionsArg.enabled ?? true : typeof args[2] === "boolean" ? args[2] : true;
   const selectArg = optionsArg?.$select;
+  const loadPropertySecurityMetadata = optionsArg?.$loadPropertySecurityMetadata;
   const mode = isInstanceSignature ? "offline" : undefined;
   const typeOrApiName = isInstanceSignature ? args[0].$objectType : args[0];
   const primaryKey = isInstanceSignature ? args[0].$primaryKey : args[1];
@@ -76,9 +77,12 @@ export function useOsdkObject(...args) {
       mode,
       ...(stableSelect ? {
         select: stableSelect
+      } : {}),
+      ...(loadPropertySecurityMetadata ? {
+        $loadPropertySecurityMetadata: loadPropertySecurityMetadata
       } : {})
     }, observer), `object ${apiNameString} ${primaryKey}`);
-  }, [enabled, observableClient, typeOrApiName, apiNameString, primaryKey, mode, stableSelect]);
+  }, [enabled, observableClient, typeOrApiName, apiNameString, primaryKey, mode, stableSelect, loadPropertySecurityMetadata]);
   const payload = React.useSyncExternalStore(subscribe, getSnapShot);
   const forceUpdate = React.useCallback(() => {
     throw new Error("not implemented");

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","isInstanceSignature","optionsArg","undefined","enabled","selectArg","$select","mode","typeOrApiName","$objectType","primaryKey","$primaryKey","apiNameString","apiName","stableSelect","useMemo","JSON","stringify","subscribe","getSnapShot","unsubscribe","observer","observeObject","select","payload","useSyncExternalStore","forceUpdate","useCallback","Error","error","status","object","isLoading","isOptimistic"],"sources":["useOsdkObject.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ObjectOrInterfaceDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n} from \"@osdk/api\";\nimport type { ObserveObjectCallbackArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<\n  Q extends ObjectOrInterfaceDefinition,\n> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n * @param enabled Enable or disable the query (defaults to true)\n */\nexport function useOsdkObject<\n  Q extends ObjectOrInterfaceDefinition,\n>(\n  obj: Osdk.Instance<Q>,\n  enabled?: boolean,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object or interface instance by type and primary key.\n *\n * @param type The object type or interface definition\n * @param primaryKey The primary key of the object\n * @param enabled Enable or disable the query (defaults to true)\n */\nexport function useOsdkObject<\n  Q extends ObjectOrInterfaceDefinition,\n>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n  enabled?: boolean,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object or interface instance by type and primary key with options.\n *\n * @param type The object type or interface definition\n * @param primaryKey The primary key of the object\n * @param options Options including $select and enabled\n */\nexport function useOsdkObject<\n  Q extends ObjectOrInterfaceDefinition,\n>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n  options?: { $select?: readonly PropertyKeys<Q>[]; enabled?: boolean },\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<\n  Q extends ObjectOrInterfaceDefinition,\n>(\n  ...args:\n    | [obj: Osdk.Instance<Q>, enabled?: boolean]\n    | [type: Q, primaryKey: PrimaryKeyType<Q>, enabled?: boolean]\n    | [\n      type: Q,\n      primaryKey: PrimaryKeyType<Q>,\n      options?: { $select?: readonly PropertyKeys<Q>[]; enabled?: boolean },\n    ]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // Check if first arg is an instance to discriminate signatures\n  // TypeScript cannot narrow rest parameter unions with optional parameters,\n  // so we must use type assertions after runtime discrimination\n  const isInstanceSignature = \"$objectType\" in args[0];\n\n  // Extract options object if provided (3rd arg is an object with $select or enabled)\n  const optionsArg = !isInstanceSignature\n      && args[2] != null\n      && typeof args[2] === \"object\"\n    ? args[2] as { $select?: readonly string[]; enabled?: boolean }\n    : undefined;\n\n  // Extract enabled flag - 2nd param for instance signature, 3rd for type signature\n  const enabled = isInstanceSignature\n    ? (typeof args[1] === \"boolean\" ? args[1] : true)\n    : optionsArg\n    ? (optionsArg.enabled ?? true)\n    : (typeof args[2] === \"boolean\" ? args[2] : true);\n\n  const selectArg = optionsArg?.$select;\n\n  const mode = isInstanceSignature ? \"offline\" : undefined;\n\n  const typeOrApiName = isInstanceSignature\n    ? (args[0] as Osdk.Instance<Q>).$objectType\n    : (args[0] as Q);\n\n  const primaryKey = isInstanceSignature\n    ? (args[0] as Osdk.Instance<Q>).$primaryKey\n    : (args[1] as PrimaryKeyType<Q>);\n\n  const apiNameString = typeof typeOrApiName === \"string\"\n    ? typeOrApiName\n    : typeOrApiName.apiName;\n\n  const stableSelect = React.useMemo(\n    () => selectArg,\n    [JSON.stringify(selectArg)],\n  );\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      if (!enabled) {\n        return makeExternalStore<ObserveObjectCallbackArgs<Q>>(\n          () => ({ unsubscribe: () => {} }),\n          `object ${apiNameString} ${primaryKey} [DISABLED]`,\n        );\n      }\n      return makeExternalStore<ObserveObjectCallbackArgs<Q>>(\n        (observer) =>\n          observableClient.observeObject(\n            typeOrApiName,\n            primaryKey,\n            {\n              mode,\n              ...(stableSelect ? { select: stableSelect } : {}),\n            },\n            observer,\n          ),\n        `object ${apiNameString} ${primaryKey}`,\n      );\n    },\n    [\n      enabled,\n      observableClient,\n      typeOrApiName,\n      apiNameString,\n      primaryKey,\n      mode,\n      stableSelect,\n    ],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  const forceUpdate = React.useCallback(() => {\n    throw new Error(\"not implemented\");\n  }, []);\n\n  return React.useMemo(() => {\n    let error: Error | undefined;\n    if (payload && \"error\" in payload && payload.error) {\n      error = payload.error;\n    } else if (payload?.status === \"error\") {\n      error = new Error(\"Failed to load object\");\n    }\n\n    return {\n      object: payload?.object as Osdk.Instance<Q> | undefined,\n      isLoading: enabled\n        ? (payload?.status === \"loading\" || payload?.status === \"init\"\n          || !payload)\n        : false,\n      isOptimistic: !!payload?.isOptimistic,\n      error,\n      forceUpdate,\n    };\n  }, [payload, enabled, forceUpdate]);\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","isInstanceSignature","optionsArg","undefined","enabled","selectArg","$select","loadPropertySecurityMetadata","$loadPropertySecurityMetadata","mode","typeOrApiName","$objectType","primaryKey","$primaryKey","apiNameString","apiName","stableSelect","useMemo","JSON","stringify","subscribe","getSnapShot","unsubscribe","observer","observeObject","select","payload","useSyncExternalStore","forceUpdate","useCallback","Error","error","status","object","isLoading","isOptimistic"],"sources":["useOsdkObject.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ObjectOrInterfaceDefinition,\n  Osdk,\n  PrimaryKeyType,\n  PropertyKeys,\n} from \"@osdk/api\";\nimport type { ObserveObjectCallbackArgs } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<\n  Q extends ObjectOrInterfaceDefinition,\n> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n * @param enabled Enable or disable the query (defaults to true)\n */\nexport function useOsdkObject<\n  Q extends ObjectOrInterfaceDefinition,\n>(\n  obj: Osdk.Instance<Q>,\n  enabled?: boolean,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object or interface instance by type and primary key.\n *\n * @param type The object type or interface definition\n * @param primaryKey The primary key of the object\n * @param enabled Enable or disable the query (defaults to true)\n */\nexport function useOsdkObject<\n  Q extends ObjectOrInterfaceDefinition,\n>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n  enabled?: boolean,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object or interface instance by type and primary key with options.\n *\n * @param type The object type or interface definition\n * @param primaryKey The primary key of the object\n * @param options Options including $select, enabled, and $loadPropertySecurityMetadata\n */\nexport function useOsdkObject<\n  Q extends ObjectOrInterfaceDefinition,\n>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n  options?: {\n    $select?: readonly PropertyKeys<Q>[];\n    enabled?: boolean;\n    $loadPropertySecurityMetadata?: boolean;\n  },\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<\n  Q extends ObjectOrInterfaceDefinition,\n>(\n  ...args:\n    | [obj: Osdk.Instance<Q>, enabled?: boolean]\n    | [type: Q, primaryKey: PrimaryKeyType<Q>, enabled?: boolean]\n    | [\n      type: Q,\n      primaryKey: PrimaryKeyType<Q>,\n      options?: {\n        $select?: readonly PropertyKeys<Q>[];\n        enabled?: boolean;\n        $loadPropertySecurityMetadata?: boolean;\n      },\n    ]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // Check if first arg is an instance to discriminate signatures\n  // TypeScript cannot narrow rest parameter unions with optional parameters,\n  // so we must use type assertions after runtime discrimination\n  const isInstanceSignature = \"$objectType\" in args[0];\n\n  // Extract options object if provided (3rd arg is an object with $select or enabled)\n  const optionsArg = !isInstanceSignature\n      && args[2] != null\n      && typeof args[2] === \"object\"\n    ? args[2] as {\n      $select?: readonly string[];\n      enabled?: boolean;\n      $loadPropertySecurityMetadata?: boolean;\n    }\n    : undefined;\n\n  // Extract enabled flag - 2nd param for instance signature, 3rd for type signature\n  const enabled = isInstanceSignature\n    ? (typeof args[1] === \"boolean\" ? args[1] : true)\n    : optionsArg\n    ? (optionsArg.enabled ?? true)\n    : (typeof args[2] === \"boolean\" ? args[2] : true);\n\n  const selectArg = optionsArg?.$select;\n  const loadPropertySecurityMetadata = optionsArg\n    ?.$loadPropertySecurityMetadata;\n\n  const mode = isInstanceSignature ? \"offline\" : undefined;\n\n  const typeOrApiName = isInstanceSignature\n    ? (args[0] as Osdk.Instance<Q>).$objectType\n    : (args[0] as Q);\n\n  const primaryKey = isInstanceSignature\n    ? (args[0] as Osdk.Instance<Q>).$primaryKey\n    : (args[1] as PrimaryKeyType<Q>);\n\n  const apiNameString = typeof typeOrApiName === \"string\"\n    ? typeOrApiName\n    : typeOrApiName.apiName;\n\n  const stableSelect = React.useMemo(\n    () => selectArg,\n    [JSON.stringify(selectArg)],\n  );\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      if (!enabled) {\n        return makeExternalStore<ObserveObjectCallbackArgs<Q>>(\n          () => ({ unsubscribe: () => {} }),\n          `object ${apiNameString} ${primaryKey} [DISABLED]`,\n        );\n      }\n      return makeExternalStore<ObserveObjectCallbackArgs<Q>>(\n        (observer) =>\n          observableClient.observeObject(\n            typeOrApiName,\n            primaryKey,\n            {\n              mode,\n              ...(stableSelect ? { select: stableSelect } : {}),\n              ...(loadPropertySecurityMetadata\n                ? {\n                  $loadPropertySecurityMetadata: loadPropertySecurityMetadata,\n                }\n                : {}),\n            },\n            observer,\n          ),\n        `object ${apiNameString} ${primaryKey}`,\n      );\n    },\n    [\n      enabled,\n      observableClient,\n      typeOrApiName,\n      apiNameString,\n      primaryKey,\n      mode,\n      stableSelect,\n      loadPropertySecurityMetadata,\n    ],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  const forceUpdate = React.useCallback(() => {\n    throw new Error(\"not implemented\");\n  }, []);\n\n  return React.useMemo(() => {\n    let error: Error | undefined;\n    if (payload && \"error\" in payload && payload.error) {\n      error = payload.error;\n    } else if (payload?.status === \"error\") {\n      error = new Error(\"Failed to load object\");\n    }\n\n    return {\n      object: payload?.object as Osdk.Instance<Q> | undefined,\n      isLoading: enabled\n        ? (payload?.status === \"loading\" || payload?.status === \"init\"\n          || !payload)\n        : false,\n      isOptimistic: !!payload?.isOptimistic,\n      error,\n      forceUpdate,\n    };\n  }, [payload, enabled, forceUpdate]);\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/new/useOsdkObjects.js

@@ -15,9 +15,9 @@
  */
 
 import React from "react";
+import { extractPayloadError, isPayloadLoading } from "./hookUtils.js";
 import { makeExternalStore } from "./makeExternalStore.js";
 import { OsdkContext2 } from "./OsdkContext2.js";
-const EMPTY_WHERE = {};
 export function useOsdkObjects(type, options) {
   const {
     observableClient
@@ -34,15 +34,17 @@ export function useOsdkObjects(type, options) {
     autoFetchMore,
     intersectWith,
     pivotTo,
-    $select
+    $select,
+    $loadPropertySecurityMetadata
   } = options ?? {};
-  const canonWhere = observableClient.canonicalizeWhereClause(where ?? EMPTY_WHERE);
-  const stableCanonWhere = React.useMemo(() => canonWhere, [JSON.stringify(canonWhere)]);
+  const canonOptions = observableClient.canonicalizeOptions({
+    where,
+    withProperties,
+    orderBy,
+    intersectWith,
+    $select
+  });
   const stableRids = React.useMemo(() => rids, [JSON.stringify(rids)]);
-  const stableWithProperties = React.useMemo(() => withProperties, [JSON.stringify(withProperties)]);
-  const stableIntersectWith = React.useMemo(() => intersectWith, [JSON.stringify(intersectWith)]);
-  const stableOrderBy = React.useMemo(() => orderBy, [JSON.stringify(orderBy)]);
-  const stableSelect = React.useMemo(() => $select, [JSON.stringify($select)]);
   const {
     subscribe,
     getSnapShot
@@ -55,40 +57,41 @@ export function useOsdkObjects(type, options) {
     return makeExternalStore(observer => observableClient.observeList({
       type,
       rids: stableRids,
-      where: stableCanonWhere,
+      where: canonOptions.where,
       dedupeInterval: dedupeIntervalMs ?? 2_000,
       pageSize,
-      orderBy: stableOrderBy,
+      orderBy: canonOptions.orderBy,
       streamUpdates,
-      withProperties: stableWithProperties,
+      withProperties: canonOptions.withProperties,
       autoFetchMore,
-      ...(stableIntersectWith ? {
-        intersectWith: stableIntersectWith
+      ...(canonOptions.intersectWith ? {
+        intersectWith: canonOptions.intersectWith
       } : {}),
       ...(pivotTo ? {
         pivotTo
       } : {}),
-      ...(stableSelect ? {
-        select: stableSelect
+      ...(canonOptions.$select ? {
+        select: canonOptions.$select
+      } : {}),
+      ...($loadPropertySecurityMetadata ? {
+        $loadPropertySecurityMetadata
       } : {})
-    }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${stableRids ? `[${stableRids.length} rids]` : ""} ${JSON.stringify(stableCanonWhere)}` : void 0);
-  }, [enabled, observableClient, type.apiName, type.type, stableRids, stableCanonWhere, dedupeIntervalMs, pageSize, stableOrderBy, streamUpdates, stableWithProperties, autoFetchMore, stableIntersectWith, pivotTo, stableSelect]);
+    }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${stableRids ? `[${stableRids.length} rids]` : ""} ${JSON.stringify(canonOptions.where)}` : void 0);
+  }, [enabled, observableClient, type.apiName, type.type, stableRids, canonOptions.where, dedupeIntervalMs, pageSize, canonOptions.orderBy, streamUpdates, canonOptions.withProperties, autoFetchMore, canonOptions.intersectWith, pivotTo, canonOptions.$select, $loadPropertySecurityMetadata]);
   const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);
-  return React.useMemo(() => {
-    let error;
-    if (listPayload && "error" in listPayload && listPayload.error) {
-      error = listPayload.error;
-    } else if (listPayload?.status === "error") {
-      error = new Error("Failed to load objects");
-    }
-    return {
-      fetchMore: listPayload?.hasMore ? listPayload.fetchMore : undefined,
-      error,
-      data: listPayload?.resolvedList,
-      isLoading: enabled ? listPayload?.status === "loading" || listPayload?.status === "init" || !listPayload : false,
-      isOptimistic: listPayload?.isOptimistic ?? false,
-      totalCount: listPayload?.totalCount
-    };
-  }, [listPayload, enabled]);
+  const refetch = React.useCallback(async () => {
+    await observableClient.invalidateObjectType(type.apiName);
+  }, [observableClient, type.apiName]);
+  return React.useMemo(() => ({
+    fetchMore: listPayload?.hasMore ? listPayload.fetchMore : undefined,
+    error: extractPayloadError(listPayload, "Failed to load objects"),
+    data: listPayload?.resolvedList,
+    isLoading: isPayloadLoading(listPayload, enabled),
+    isOptimistic: listPayload?.isOptimistic ?? false,
+    totalCount: listPayload?.totalCount,
+    hasMore: listPayload?.hasMore ?? false,
+    objectSet: listPayload?.objectSet,
+    refetch
+  }), [listPayload, enabled, refetch]);
 }
 //# sourceMappingURL=useOsdkObjects.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkObjects.js","names":["React","makeExternalStore","OsdkContext2","EMPTY_WHERE","useOsdkObjects","type","options","observableClient","useContext","pageSize","dedupeIntervalMs","withProperties","enabled","rids","where","orderBy","streamUpdates","autoFetchMore","intersectWith","pivotTo","$select","canonWhere","canonicalizeWhereClause","stableCanonWhere","useMemo","JSON","stringify","stableRids","stableWithProperties","stableIntersectWith","stableOrderBy","stableSelect","subscribe","getSnapShot","unsubscribe","process","env","NODE_ENV","apiName","observer","observeList","dedupeInterval","select","length","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   * Fetch objects by their RIDs (Resource Identifiers).\n   * When provided, starts with a static objectset containing these RIDs.\n   * Can be combined with `where` to filter the RID set, and with `orderBy` to sort results.\n   *\n   * @example\n   * // Fetch specific objects by RID\n   * useOsdkObjects(Employee, { rids: ['ri.foo.123', 'ri.foo.456'] })\n   *\n   * @example\n   * // Fetch specific objects by RID, filtered by status\n   * useOsdkObjects(Employee, {\n   *   rids: ['ri.foo.123', 'ri.foo.456', 'ri.foo.789'],\n   *   where: { status: 'active' }\n   * })\n   */\n  rids?: readonly string[];\n\n  /**\n   * Standard OSDK Where clause with RDP support.\n   * When used with `rids`, filters the RID set.\n   * When used alone, filters all objects of the type.\n   */\n  where?: WhereClause<T, RDPs>;\n\n  /**\n   * Sort results by one or more properties.\n   */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * The preferred page size for the list.\n   */\n  pageSize?: number;\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   * The number of milliseconds to wait after the last observed list change.\n   *\n   * Two uses of `useOsdkObjects` with the same parameters will only trigger one\n   * network request if the second is within `dedupeIntervalMs`.\n   */\n  dedupeIntervalMs?: number;\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   * @default true\n   */\n  enabled?: boolean;\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  autoFetchMore?: boolean | number;\n\n  streamUpdates?: boolean;\n\n  /**\n   * Restrict which properties are returned for each object.\n   * When provided, only the specified properties will be fetched,\n   * reducing payload sizes for list views.\n   *\n   * @example\n   * // Only fetch name and status properties\n   * useOsdkObjects(Employee, { $select: [\"name\", \"status\"] })\n   */\n  $select?: readonly PropertyKeys<T>[];\n}\n\nexport interface UseOsdkListResult<\n  T extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n  EXTRA_OPTIONS extends never | \"$rid\" = never,\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<\n      T,\n      \"$allBaseProperties\" | EXTRA_OPTIONS,\n      PropertyKeys<T>,\n      RDPs\n    >[]\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\nconst EMPTY_WHERE = {};\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; rids: readonly string[] },\n): UseOsdkListResult<LinkedType<Q, L>, {}, \"$rid\">;\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> & { rids: readonly string[] },\n): UseOsdkListResult<Q, RDPs, \"$rid\">;\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<Q, RDPs, \"$rid\">\n  | UseOsdkListResult<LinkedType<Q, LinkNames<Q>>>\n  | UseOsdkListResult<LinkedType<Q, LinkNames<Q>>, {}, \"$rid\">\n{\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  const {\n    pageSize,\n    dedupeIntervalMs,\n    withProperties,\n    enabled = true,\n    rids,\n    where,\n    orderBy,\n    streamUpdates,\n    autoFetchMore,\n    intersectWith,\n    pivotTo,\n    $select,\n  } = options ?? {};\n\n  const canonWhere = observableClient.canonicalizeWhereClause<\n    Q,\n    RDPs\n  >(where ?? EMPTY_WHERE);\n\n  const stableCanonWhere = React.useMemo(\n    () => canonWhere,\n    [JSON.stringify(canonWhere)],\n  );\n\n  const stableRids = React.useMemo(\n    () => rids,\n    [JSON.stringify(rids)],\n  );\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 stableSelect = React.useMemo(\n    () => $select,\n    [JSON.stringify($select)],\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} [DISABLED]`\n            : void 0,\n        );\n      }\n\n      return makeExternalStore<\n        ObserveObjectsCallbackArgs<Q, RDPs>\n      >(\n        (observer) =>\n          observableClient.observeList({\n            type,\n            rids: stableRids,\n            where: stableCanonWhere,\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            ...(stableSelect ? { select: stableSelect } : {}),\n          }, observer),\n        process.env.NODE_ENV !== \"production\"\n          ? `list ${type.apiName} ${\n            stableRids ? `[${stableRids.length} rids]` : \"\"\n          } ${JSON.stringify(stableCanonWhere)}`\n          : void 0,\n      );\n    },\n    [\n      enabled,\n      observableClient,\n      type.apiName,\n      type.type,\n      stableRids,\n      stableCanonWhere,\n      dedupeIntervalMs,\n      pageSize,\n      stableOrderBy,\n      streamUpdates,\n      stableWithProperties,\n      autoFetchMore,\n      stableIntersectWith,\n      pivotTo,\n      stableSelect,\n    ],\n  );\n\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return React.useMemo(() => {\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  }, [listPayload, enabled]);\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useOsdkObjects.js","names":["React","extractPayloadError","isPayloadLoading","makeExternalStore","OsdkContext2","useOsdkObjects","type","options","observableClient","useContext","pageSize","dedupeIntervalMs","withProperties","enabled","rids","where","orderBy","streamUpdates","autoFetchMore","intersectWith","pivotTo","$select","$loadPropertySecurityMetadata","canonOptions","canonicalizeOptions","stableRids","useMemo","JSON","stringify","subscribe","getSnapShot","unsubscribe","process","env","NODE_ENV","apiName","observer","observeList","dedupeInterval","select","length","listPayload","useSyncExternalStore","refetch","useCallback","invalidateObjectType","fetchMore","hasMore","undefined","error","data","resolvedList","isLoading","isOptimistic","totalCount","objectSet"],"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  ObjectSet,\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 { extractPayloadError, isPayloadLoading } from \"./hookUtils.js\";\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   * Fetch objects by their RIDs (Resource Identifiers).\n   * When provided, starts with a static objectset containing these RIDs.\n   * Can be combined with `where` to filter the RID set, and with `orderBy` to sort results.\n   *\n   * @example\n   * // Fetch specific objects by RID\n   * useOsdkObjects(Employee, { rids: ['ri.foo.123', 'ri.foo.456'] })\n   *\n   * @example\n   * // Fetch specific objects by RID, filtered by status\n   * useOsdkObjects(Employee, {\n   *   rids: ['ri.foo.123', 'ri.foo.456', 'ri.foo.789'],\n   *   where: { status: 'active' }\n   * })\n   */\n  rids?: readonly string[];\n\n  /**\n   * Standard OSDK Where clause with RDP support.\n   * When used with `rids`, filters the RID set.\n   * When used alone, filters all objects of the type.\n   */\n  where?: WhereClause<T, RDPs>;\n\n  /**\n   * Sort results by one or more properties.\n   */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * The preferred page size for the list.\n   */\n  pageSize?: number;\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   * The number of milliseconds to wait after the last observed list change.\n   *\n   * Two uses of `useOsdkObjects` with the same parameters will only trigger one\n   * network request if the second is within `dedupeIntervalMs`.\n   */\n  dedupeIntervalMs?: number;\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   * @default true\n   */\n  enabled?: boolean;\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  autoFetchMore?: boolean | number;\n\n  streamUpdates?: boolean;\n\n  /**\n   * Restrict which properties are returned for each object.\n   * When provided, only the specified properties will be fetched,\n   * reducing payload sizes for list views.\n   *\n   * @example\n   * // Only fetch name and status properties\n   * useOsdkObjects(Employee, { $select: [\"name\", \"status\"] })\n   */\n  $select?: readonly PropertyKeys<T>[];\n\n  /**\n   * When true, loads per-property security metadata (marking requirements)\n   * alongside each object. The returned objects will have `$propertySecurities`\n   * populated with conjunctive/disjunctive marking requirements per property.\n   */\n  $loadPropertySecurityMetadata?: boolean;\n}\n\nexport interface UseOsdkListResult<\n  T extends ObjectOrInterfaceDefinition,\n  RDPs extends Record<string, SimplePropertyDef> = {},\n  EXTRA_OPTIONS extends never | \"$rid\" = never,\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<\n      T,\n      \"$allBaseProperties\" | EXTRA_OPTIONS,\n      PropertyKeys<T>,\n      RDPs\n    >[]\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  hasMore: boolean;\n\n  objectSet: ObjectSet<T, RDPs> | undefined;\n\n  refetch: () => Promise<void>;\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; rids: readonly string[] },\n): UseOsdkListResult<LinkedType<Q, L>, {}, \"$rid\">;\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> & { rids: readonly string[] },\n): UseOsdkListResult<Q, RDPs, \"$rid\">;\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<Q, RDPs, \"$rid\">\n  | UseOsdkListResult<LinkedType<Q, LinkNames<Q>>>\n  | UseOsdkListResult<LinkedType<Q, LinkNames<Q>>, {}, \"$rid\">\n{\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  const {\n    pageSize,\n    dedupeIntervalMs,\n    withProperties,\n    enabled = true,\n    rids,\n    where,\n    orderBy,\n    streamUpdates,\n    autoFetchMore,\n    intersectWith,\n    pivotTo,\n    $select,\n    $loadPropertySecurityMetadata,\n  } = options ?? {};\n\n  const canonOptions = observableClient.canonicalizeOptions({\n    where,\n    withProperties,\n    orderBy,\n    intersectWith,\n    $select,\n  });\n\n  const stableRids = React.useMemo(\n    () => rids,\n    [JSON.stringify(rids)],\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} [DISABLED]`\n            : void 0,\n        );\n      }\n\n      return makeExternalStore<\n        ObserveObjectsCallbackArgs<Q, RDPs>\n      >(\n        (observer) =>\n          observableClient.observeList({\n            type,\n            rids: stableRids,\n            where: canonOptions.where,\n            dedupeInterval: dedupeIntervalMs ?? 2_000,\n            pageSize,\n            orderBy: canonOptions.orderBy,\n            streamUpdates,\n            withProperties: canonOptions.withProperties,\n            autoFetchMore,\n            ...(canonOptions.intersectWith\n              ? { intersectWith: canonOptions.intersectWith }\n              : {}),\n            ...(pivotTo ? { pivotTo } : {}),\n            ...(canonOptions.$select ? { select: canonOptions.$select } : {}),\n            ...($loadPropertySecurityMetadata\n              ? { $loadPropertySecurityMetadata }\n              : {}),\n          }, observer),\n        process.env.NODE_ENV !== \"production\"\n          ? `list ${type.apiName} ${\n            stableRids ? `[${stableRids.length} rids]` : \"\"\n          } ${JSON.stringify(canonOptions.where)}`\n          : void 0,\n      );\n    },\n    [\n      enabled,\n      observableClient,\n      type.apiName,\n      type.type,\n      stableRids,\n      canonOptions.where,\n      dedupeIntervalMs,\n      pageSize,\n      canonOptions.orderBy,\n      streamUpdates,\n      canonOptions.withProperties,\n      autoFetchMore,\n      canonOptions.intersectWith,\n      pivotTo,\n      canonOptions.$select,\n      $loadPropertySecurityMetadata,\n    ],\n  );\n\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  const refetch = React.useCallback(async () => {\n    await observableClient.invalidateObjectType(type.apiName);\n  }, [observableClient, type.apiName]);\n\n  return React.useMemo(() => ({\n    fetchMore: listPayload?.hasMore ? listPayload.fetchMore : undefined,\n    error: extractPayloadError(listPayload, \"Failed to load objects\"),\n    data: listPayload?.resolvedList,\n    isLoading: isPayloadLoading(listPayload, enabled),\n    isOptimistic: listPayload?.isOptimistic ?? false,\n    totalCount: listPayload?.totalCount,\n    hasMore: listPayload?.hasMore ?? false,\n    objectSet: listPayload?.objectSet,\n    refetch,\n  }), [listPayload, enabled, refetch]);\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -14,7 +14,12 @@
  * limitations under the License.
  */
 
+export { useCbacBanner } from "../../new/platform-apis/admin/useCbacBanner.js";
+export { useCbacMarkingRestrictions } from "../../new/platform-apis/admin/useCbacMarkingRestrictions.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 { useMarkingCategories } from "../../new/platform-apis/admin/useMarkingCategories.js";
+export { useMarkings } from "../../new/platform-apis/admin/useMarkings.js";
+export { useUserViewMarkings } from "../../new/platform-apis/admin/useUserMarkings.js";
 //# sourceMappingURL=admin.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"admin.js","names":["useCurrentFoundryUser","useFoundryUser","useFoundryUsersList"],"sources":["admin.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 { 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\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,qBAAqB,QAAQ,wDAAwD;AAC9F,SAASC,cAAc,QAAQ,iDAAiD;AAChF,SAASC,mBAAmB,QAAQ,sDAAsD","ignoreList":[]}
+{"version":3,"file":"admin.js","names":["useCbacBanner","useCbacMarkingRestrictions","useCurrentFoundryUser","useFoundryUser","useFoundryUsersList","useMarkingCategories","useMarkings","useUserViewMarkings"],"sources":["admin.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 { useCbacBanner } from \"../../new/platform-apis/admin/useCbacBanner.js\";\nexport type {\n  CbacBannerData,\n  UseCbacBannerOptions,\n  UseCbacBannerResult,\n} from \"../../new/platform-apis/admin/useCbacBanner.js\";\nexport { useCbacMarkingRestrictions } from \"../../new/platform-apis/admin/useCbacMarkingRestrictions.js\";\nexport type {\n  CbacMarkingRestrictionsData,\n  UseCbacMarkingRestrictionsOptions,\n  UseCbacMarkingRestrictionsResult,\n} from \"../../new/platform-apis/admin/useCbacMarkingRestrictions.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 { useMarkingCategories } from \"../../new/platform-apis/admin/useMarkingCategories.js\";\nexport { useMarkings } from \"../../new/platform-apis/admin/useMarkings.js\";\nexport { useUserViewMarkings } from \"../../new/platform-apis/admin/useUserMarkings.js\";\nexport type {\n  UseUserViewMarkingsOptions,\n  UseUserViewMarkingsResult,\n} from \"../../new/platform-apis/admin/useUserMarkings.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,gDAAgD;AAM9E,SAASC,0BAA0B,QAAQ,6DAA6D;AAMxG,SAASC,qBAAqB,QAAQ,wDAAwD;AAC9F,SAASC,cAAc,QAAQ,iDAAiD;AAChF,SAASC,mBAAmB,QAAQ,sDAAsD;AAC1F,SAASC,oBAAoB,QAAQ,uDAAuD;AAC5F,SAASC,WAAW,QAAQ,8CAA8C;AAC1E,SAASC,mBAAmB,QAAQ,kDAAkD","ignoreList":[]}

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

@@ -0,0 +1,18 @@
+/*
+ * Copyright 2026 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.
+ */
+
+export { useOsdkFunctions } from "../new/useOsdkFunctions.js";
+//# sourceMappingURL=unstable-do-not-use.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unstable-do-not-use.js","names":["useOsdkFunctions"],"sources":["unstable-do-not-use.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\nexport { useOsdkFunctions } from \"../new/useOsdkFunctions.js\";\nexport type {\n  FunctionQueryParams,\n  UseOsdkFunctionsProps,\n  UseOsdkFunctionsResult,\n} from \"../new/useOsdkFunctions.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,gBAAgB,QAAQ,4BAA4B","ignoreList":[]}

package/build/cjs/chunk-2N32USW5.cjs

@@ -0,0 +1,28 @@
+'use strict';
+
+var React = require('react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+// 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__ */ React__default.default.createContext({
+  client: fakeClient
+});
+
+// src/useOsdkClient.ts
+function useOsdkClient() {
+  return React__default.default.useContext(OsdkContext).client;
+}
+
+exports.OsdkContext = OsdkContext;
+exports.useOsdkClient = useOsdkClient;
+//# sourceMappingURL=chunk-2N32USW5.cjs.map
+//# sourceMappingURL=chunk-2N32USW5.cjs.map

package/build/cjs/chunk-2N32USW5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/OsdkContext.ts","../../src/useOsdkClient.ts"],"names":["React"],"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,0CAAiC,aAAc,CAAA;AAAA,EAC1D,MAAQ,EAAA;AACV,CAAC;;;ACPM,SAAS,aAAgB,GAAA;AAC9B,EAAOA,OAAAA,sBAAAA,CAAM,UAAW,CAAA,WAAW,CAAE,CAAA,MAAA;AACvC","file":"chunk-2N32USW5.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}"]}

package/build/cjs/chunk-R4FZ5MUH.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+var chunk2N32USW5_cjs = require('./chunk-2N32USW5.cjs');
+var React = require('react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React__default = /*#__PURE__*/_interopDefault(React);
+
+function useOsdkMetadata(type) {
+  const client = chunk2N32USW5_cjs.useOsdkClient();
+  const [metadata, setMetadata] = React__default.default.useState(void 0);
+  const [error, setError] = React__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.useOsdkMetadata = useOsdkMetadata;
+//# sourceMappingURL=chunk-R4FZ5MUH.cjs.map
+//# sourceMappingURL=chunk-R4FZ5MUH.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/useOsdkMetadata.ts"],"names":["useOsdkClient","React","error"],"mappings":";;;;;;;;;AAkBO,SAAS,gBAAgB,IAAM,EAAA;AACpC,EAAA,MAAM,SAASA,+BAAc,EAAA;AAC7B,EAAA,MAAM,CAAC,QAAU,EAAA,WAAW,CAAI,GAAAC,sBAAA,CAAM,SAAS,MAAS,CAAA;AACxD,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,uBAAM,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-R4FZ5MUH.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 { 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/{chunk-SVVMLSKN.cjs → chunk-ZUNR45SJ.cjs}

@@ -7,15 +7,26 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var React__default = /*#__PURE__*/_interopDefault(React);
 
 // src/new/OsdkContext2.ts
+var MISSING_PROVIDER_MESSAGE = "No OsdkProvider2 found. Did you forget to wrap your component tree with <OsdkProvider2>?";
 function fakeClientFn(..._args) {
-  throw new Error("This is not a real client. Did you forget to <OsdkContext.Provider>?");
+  throw new Error(MISSING_PROVIDER_MESSAGE);
 }
 var fakeClient = Object.assign(fakeClientFn, {
   fetchMetadata: fakeClientFn
 });
+var fakeObservableClient = new Proxy({}, {
+  get(_target, prop) {
+    if (prop === Symbol.toPrimitive || prop === Symbol.toStringTag) {
+      return void 0;
+    }
+    return (..._args) => {
+      throw new Error(MISSING_PROVIDER_MESSAGE);
+    };
+  }
+});
 var OsdkContext2 = /* @__PURE__ */ React__default.default.createContext({
   client: fakeClient,
-  observableClient: void 0
+  observableClient: fakeObservableClient
 });
 
 // src/new/makeExternalStore.ts
@@ -107,5 +118,5 @@ function makeExternalStoreAsync(createObservation, _name, initialValue) {
 exports.OsdkContext2 = OsdkContext2;
 exports.makeExternalStore = makeExternalStore;
 exports.makeExternalStoreAsync = makeExternalStoreAsync;
-//# sourceMappingURL=chunk-SVVMLSKN.cjs.map
-//# sourceMappingURL=chunk-SVVMLSKN.cjs.map
+//# sourceMappingURL=chunk-ZUNR45SJ.cjs.map
+//# sourceMappingURL=chunk-ZUNR45SJ.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/new/OsdkContext2.ts","../../src/new/makeExternalStore.ts"],"names":[],"mappings":"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","file":"chunk-ZUNR45SJ.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\";\nexport const MISSING_PROVIDER_MESSAGE = \"No OsdkProvider2 found. Did you forget to wrap your component tree with <OsdkProvider2>?\";\nfunction fakeClientFn(..._args) {\n  throw new Error(MISSING_PROVIDER_MESSAGE);\n}\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn\n});\n\n// Proxy that throws a clear error when any method is called, so hooks like\n// useOsdkObjects get \"Did you forget <OsdkProvider2>?\" instead of\n// \"cannot read canonicalizeWhereClause of undefined\".\n// We intercept `get` so every property access returns a throwing function,\n// without needing to enumerate every ObservableClient method.\n// Symbol.toPrimitive and Symbol.toStringTag are accessed by React/devtools\n// during rendering and logging — returning undefined for these avoids\n// spurious throws in contexts unrelated to the user's code.\nconst fakeObservableClient = new Proxy({}, {\n  get(_target, prop) {\n    if (prop === Symbol.toPrimitive || prop === Symbol.toStringTag) {\n      return undefined;\n    }\n    return (..._args) => {\n      throw new Error(MISSING_PROVIDER_MESSAGE);\n    };\n  }\n});\nexport const OsdkContext2 = /*#__PURE__*/React.createContext({\n  client: fakeClient,\n  observableClient: fakeObservableClient\n});","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function makeExternalStore(createObservation, _name, initialValue) {\n  let lastResult = initialValue;\n  function getSnapShot() {\n    return lastResult;\n  }\n  function subscribe(notifyUpdate) {\n    const obs = createObservation({\n      next: payload => {\n        lastResult = payload;\n        notifyUpdate();\n      },\n      error: error => {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error))\n        };\n        notifyUpdate();\n      },\n      complete: () => {}\n    });\n    return () => {\n      obs.unsubscribe();\n    };\n  }\n  return {\n    subscribe,\n    getSnapShot\n  };\n}\n\n/**\n * Like makeExternalStore but for async subscription creation.\n *\n * Uses an isActive flag to handle race conditions:\n * If cleanup runs before promise resolves, the stale subscription is\n * immediately unsubscribed when it eventually resolves\n */\nexport function makeExternalStoreAsync(createObservation, _name, initialValue) {\n  let lastResult = initialValue;\n  function getSnapShot() {\n    return lastResult;\n  }\n  function subscribe(notifyUpdate) {\n    let isActive = true;\n    let currentSubscription;\n    const subscriptionPromise = createObservation({\n      next: payload => {\n        if (isActive) {\n          lastResult = payload;\n          notifyUpdate();\n        }\n      },\n      error: error => {\n        if (isActive) {\n          lastResult = {\n            ...(lastResult ?? {}),\n            error: error instanceof Error ? error : new Error(String(error))\n          };\n          notifyUpdate();\n        }\n      },\n      complete: () => {}\n    });\n    subscriptionPromise.then(sub => {\n      if (isActive) {\n        currentSubscription = sub;\n      } else {\n        sub.unsubscribe();\n      }\n    }).catch(error => {\n      if (isActive) {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error))\n        };\n        notifyUpdate();\n      }\n    });\n    return () => {\n      isActive = false;\n      if (currentSubscription) {\n        currentSubscription.unsubscribe();\n      }\n    };\n  }\n  return {\n    subscribe,\n    getSnapShot\n  };\n}"]}