@osdk/react 0.10.0-beta.9 → 0.10.0

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

@@ -1,7 +1,8 @@
 import { Client, Osdk, WhereClause, PropertyKeys, ActionDefinition, ActionEditResponse, ActionValidationError, ActionValidationResponse, ObjectTypeDefinition } from '@osdk/client';
-import { ObservableClient, ActionSignatureFromDef, QueryParameterType } from '@osdk/client/unstable-do-not-use';
+import { ObservableClient, ActionSignatureFromDef } from '@osdk/client/unstable-do-not-use';
 import React from 'react';
-import { ObjectOrInterfaceDefinition, LinkNames, LinkedType, SimplePropertyDef, ObjectSet, WhereClause as WhereClause$1, DerivedProperty, PropertyKeys as PropertyKeys$1, Osdk as Osdk$1, AggregateOpts, AggregationsResults, QueryDefinition, CompileTimeMetadata, ObjectTypeDefinition as ObjectTypeDefinition$1, PrimaryKeyType } from '@osdk/api';
+import { ObjectOrInterfaceDefinition, LinkNames, LinkedType, SimplePropertyDef, ObjectSet, WhereClause as WhereClause$1, DerivedProperty, PropertyKeys as PropertyKeys$1, Osdk as Osdk$1, AggregateOpts, AggregationsResults, PrimaryKeyType } from '@osdk/api';
+export { U as UseOsdkFunctionOptions, a as UseOsdkFunctionResult, u as useOsdkFunction } from '../useOsdkFunction-B0s7lqgN.cjs';
 export { U as UseOsdkMetadataResult, u as useOsdkClient, a as useOsdkMetadata } from '../useOsdkMetadata-BElt3F5s.cjs';
 
 interface OsdkProviderOptions {
@@ -326,123 +327,6 @@ interface UseOsdkAggregationResult<T extends ObjectOrInterfaceDefinition, A exte
 declare function useOsdkAggregation<Q extends ObjectOrInterfaceDefinition, const A extends AggregateOpts<Q>, RDPs extends Record<string, SimplePropertyDef> = {}>(type: Q, options: UseOsdkAggregationOptions<Q, A, RDPs>): UseOsdkAggregationResult<Q, A>;
 declare function useOsdkAggregation<Q extends ObjectTypeDefinition, const A extends AggregateOpts<Q>, RDPs extends Record<string, SimplePropertyDef> = {}>(type: Q, options: UseOsdkAggregationOptionsWithObjectSet<Q, A, RDPs>): UseOsdkAggregationResult<Q, A>;
 
-interface UseOsdkFunctionOptions<Q extends QueryDefinition<unknown>> {
-    /**
-     * Parameters to pass to the function.
-     * Must include all required parameters; optional parameters can be omitted.
-     */
-    params?: CompileTimeMetadata<Q>["parameters"] extends Record<string, never> ? undefined : QueryParameterType<CompileTimeMetadata<Q>["parameters"]>;
-    /**
-     * Object types this function depends on.
-     * When actions modify objects of these types, the function will automatically refetch.
-     *
-     * @example
-     * ```tsx
-     * // Refetch when any Employee object changes
-     * { dependsOn: [Employee] }
-     * ```
-     */
-    dependsOn?: Array<ObjectTypeDefinition$1 | string>;
-    /**
-     * Specific object instances or ObjectSets this function depends on.
-     * When any of these specific objects change, the function will refetch.
-     * More fine-grained than dependsOn for precise invalidation control.
-     *
-     * For ObjectSets, the object type is extracted asynchronously and changes
-     * to any object of that type will trigger a refetch.
-     *
-     * @example
-     * ```tsx
-     * // Refetch when this specific employee changes
-     * { dependsOnObjects: [employee] }
-     *
-     * // Refetch when any object in the ObjectSet's type changes
-     * { dependsOnObjects: [employeeObjectSet] }
-     * ```
-     */
-    dependsOnObjects?: Array<Osdk$1.Instance<ObjectTypeDefinition$1> | ObjectSet<ObjectTypeDefinition$1>>;
-    /**
-     * The number of milliseconds to dedupe identical function calls.
-     * Two calls with the same function and params will share results
-     * if the second call is within this interval of the first.
-     * @default 2000
-     */
-    dedupeIntervalMs?: number;
-    /**
-     * Whether to enable the query. When false, the query will not execute.
-     * Useful for:
-     * - Dependent queries that need to wait for other data
-     * - Conditional queries based on component state
-     *
-     * @default true
-     * @example
-     * // Dependent query - wait for required data
-     * const { data: employee } = useOsdkObject(Employee, employeeId);
-     * const { data: report } = useOsdkFunction(getEmployeeReport, {
-     *   params: { employeeId: employee?.$primaryKey },
-     *   enabled: !!employee
-     * });
-     */
-    enabled?: boolean;
-}
-interface UseOsdkFunctionResult<Q extends QueryDefinition<unknown>> {
-    /**
-     * The function result, or undefined if not yet loaded or on error.
-     */
-    data: (CompileTimeMetadata<Q>["signature"] extends (...args: never[]) => infer R ? Awaited<R> : never) | undefined;
-    /**
-     * True while the function is executing.
-     */
-    isLoading: boolean;
-    /**
-     * Error if the function execution failed.
-     */
-    error: Error | undefined;
-    /**
-     * Timestamp (ms since epoch) of when the result was last fetched.
-     */
-    lastUpdated: number;
-    /**
-     * Manually refetch the function.
-     * Useful for "pull to refresh" or retry patterns.
-     */
-    refetch: () => void;
-}
-/**
- * React hook for executing and observing OSDK functions.
- *
- * Provides automatic caching, deduplication, and reactive updates for function calls.
- * Functions are automatically re-fetched when dependencies change (configured via options).
- *
- * @param queryDef - The QueryDefinition to execute
- * @param options - Configuration options for the function call
- * @returns Object containing result, loading state, error, and refetch function
- *
- * @example Basic usage
- * ```tsx
- * const { data, isLoading, error } = useOsdkFunction(getEmployeeStats, {
- *   params: { departmentId: "engineering" }
- * });
- * ```
- *
- * @example With dependency tracking
- * ```tsx
- * const { data, refetch } = useOsdkFunction(calculateMetrics, {
- *   params: { startDate, endDate },
- *   dependsOn: [Employee, Project],
- * });
- * ```
- *
- * @example With specific object dependencies
- * ```tsx
- * const { data } = useOsdkFunction(getEmployeeReport, {
- *   params: { employeeId: employee.$primaryKey },
- *   dependsOnObjects: [employee],
- * });
- * ```
- */
-declare function useOsdkFunction<Q extends QueryDefinition<unknown>>(queryDef: Q, options?: UseOsdkFunctionOptions<Q>): UseOsdkFunctionResult<Q>;
-
 interface UseOsdkObjectResult<Q extends ObjectOrInterfaceDefinition> {
     object: Osdk$1.Instance<Q> | undefined;
     isLoading: boolean;
@@ -471,11 +355,12 @@ declare function useOsdkObject<Q extends ObjectOrInterfaceDefinition>(type: Q, p
  *
  * @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
  */
 declare function useOsdkObject<Q extends ObjectOrInterfaceDefinition>(type: Q, primaryKey: PrimaryKeyType<Q>, options?: {
     $select?: readonly PropertyKeys$1<Q>[];
     enabled?: boolean;
+    $loadPropertySecurityMetadata?: boolean;
 }): UseOsdkObjectResult<Q>;
 
 interface UseOsdkObjectsOptions<T extends ObjectOrInterfaceDefinition, RDPs extends Record<string, SimplePropertyDef> = {}> {
@@ -569,6 +454,12 @@ interface UseOsdkObjectsOptions<T extends ObjectOrInterfaceDefinition, RDPs exte
      * useOsdkObjects(Employee, { $select: ["name", "status"] })
      */
     $select?: readonly PropertyKeys$1<T>[];
+    /**
+     * When true, loads per-property security metadata (marking requirements)
+     * alongside each object. The returned objects will have `$propertySecurities`
+     * populated with conjunctive/disjunctive marking requirements per property.
+     */
+    $loadPropertySecurityMetadata?: boolean;
 }
 interface UseOsdkListResult<T extends ObjectOrInterfaceDefinition, RDPs extends Record<string, SimplePropertyDef> = {}, EXTRA_OPTIONS extends never | "$rid" = never> {
     /**
@@ -647,4 +538,4 @@ interface DebouncedCallback<TArgs extends readonly unknown[]> {
  */
 declare function useDebouncedCallback<TArgs extends readonly unknown[]>(callback: (...args: TArgs) => void | Promise<void>, delay: number): DebouncedCallback<TArgs>;
 
-export { OsdkProvider2, type UseOsdkAggregationResult, type UseOsdkFunctionOptions, type UseOsdkFunctionResult, type UseOsdkListResult, type UseOsdkObjectsOptions, useDebouncedCallback, useLinks, useObjectSet, useOsdkAction, useOsdkAggregation, useOsdkFunction, useOsdkObject, useOsdkObjects };
+export { OsdkProvider2, type UseOsdkAggregationResult, type UseOsdkListResult, type UseOsdkObjectsOptions, useDebouncedCallback, useLinks, useObjectSet, useOsdkAction, useOsdkAggregation, useOsdkObject, useOsdkObjects };

package/build/cjs/public/unstable-do-not-use.cjs

@@ -0,0 +1,114 @@
+'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 useOsdkFunctions({
+  queries,
+  enabled = true
+}) {
+  const client = chunk2N32USW5_cjs.useOsdkClient();
+  const [results, setResults] = React__default.default.useState(() => queries.map(() => ({
+    data: void 0,
+    isLoading: false,
+    error: void 0,
+    lastUpdated: 0
+  })));
+  const abortControllerRef = React__default.default.useRef(null);
+  React__default.default.useEffect(() => {
+    if (!enabled || queries.length === 0) {
+      return;
+    }
+    abortControllerRef.current?.abort();
+    const abortController = new AbortController();
+    abortControllerRef.current = abortController;
+    const executeQueries = async () => {
+      setResults((prev) => queries.map((_, index) => ({
+        data: prev[index]?.data,
+        // Preserving existing data
+        isLoading: queries[index].options?.enabled !== false,
+        error: void 0,
+        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)) : void 0,
+            lastUpdated: Date.now()
+          };
+          return newResults;
+        });
+      }
+    };
+    void executeQueries();
+    return () => {
+      abortController.abort();
+    };
+  }, [enabled, client, queries]);
+  return results;
+}
+async function* executeQueriesGenerator(queries, client) {
+  const queryPromises = queries.map((query, index) => createQueryPromise(query, index, client));
+  const pendingPromises = [...queryPromises];
+  while (pendingPromises.length > 0) {
+    const raceResult = await Promise.race(pendingPromises.map((promise, idx) => promise.then((result) => ({
+      result,
+      idx
+    }))));
+    yield raceResult.result;
+    void pendingPromises.splice(raceResult.idx, 1);
+  }
+}
+var createQueryPromise = async (query, index, client) => {
+  if (query.options?.enabled === false) {
+    return {
+      index,
+      result: void 0,
+      error: void 0
+    };
+  }
+  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: void 0,
+        error
+      };
+    }
+  }
+  return {
+    index,
+    result: void 0,
+    error: new Error("Invalid query client: executeFunction method not found")
+  };
+};
+
+exports.useOsdkFunctions = useOsdkFunctions;
+//# sourceMappingURL=unstable-do-not-use.cjs.map
+//# sourceMappingURL=unstable-do-not-use.cjs.map

package/build/cjs/public/unstable-do-not-use.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/new/useOsdkFunctions.ts"],"names":["useOsdkClient","React"],"mappings":"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","file":"unstable-do-not-use.cjs","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 React from \"react\";\nimport { useOsdkClient } from \"../useOsdkClient.js\";\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,\n  enabled = true\n}) {\n  const client = useOsdkClient();\n  const [results, setResults] = React.useState(() => queries.map(() => ({\n    data: undefined,\n    isLoading: false,\n    error: undefined,\n    lastUpdated: 0\n  })));\n  const abortControllerRef = React.useRef(null);\n  React.useEffect(() => {\n    if (!enabled || queries.length === 0) {\n      return;\n    }\n\n    // Cancel previous requests\n    abortControllerRef.current?.abort();\n    const abortController = new AbortController();\n    abortControllerRef.current = abortController;\n    const executeQueries = async () => {\n      // Initialize loading state for all queries\n      setResults(prev => queries.map((_, index) => ({\n        data: prev[index]?.data,\n        // Preserving existing data\n        isLoading: queries[index].options?.enabled !== false,\n        error: undefined,\n        lastUpdated: prev[index]?.lastUpdated || 0\n      })));\n      for await (const queryResult of executeQueriesGenerator(queries, client)) {\n        const {\n          index,\n          result,\n          error\n        } = queryResult;\n        if (abortController.signal.aborted) {\n          break;\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 ? error : error ? new Error(typeof error === \"string\" ? error : JSON.stringify(error)) : undefined,\n            lastUpdated: Date.now()\n          };\n          return newResults;\n        });\n      }\n    };\n    void executeQueries();\n    return () => {\n      abortController.abort();\n    };\n  }, [enabled, client, queries]);\n  return results;\n}\n/**\n * Generator function that executes queries and yields results as they complete\n */\nasync function* executeQueriesGenerator(queries, client) {\n  const queryPromises = queries.map((query, index) => createQueryPromise(query, index, client));\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(pendingPromises.map((promise, idx) => promise.then(result => ({\n      result,\n      idx\n    }))));\n    yield raceResult.result;\n\n    // Remove the completed promise from the pending list\n    void pendingPromises.splice(raceResult.idx, 1);\n  }\n}\nconst createQueryPromise = async (query, index, client) => {\n  // Skip disabled queries\n  if (query.options?.enabled === false) {\n    return {\n      index,\n      result: undefined,\n      error: undefined\n    };\n  }\n  const queryClient = client(query.queryDefinition);\n  if (\"executeFunction\" in queryClient && typeof queryClient.executeFunction === \"function\") {\n    try {\n      const result = await queryClient.executeFunction(query.options?.params);\n      return {\n        index,\n        result,\n        error: null\n      };\n    } catch (error) {\n      return {\n        index,\n        result: undefined,\n        error\n      };\n    }\n  }\n  return {\n    index,\n    result: undefined,\n    error: new Error(\"Invalid query client: executeFunction method not found\")\n  };\n};"]}

package/build/cjs/public/unstable-do-not-use.d.cts

@@ -0,0 +1,35 @@
+import { QueryDefinition } from '@osdk/api';
+import { U as UseOsdkFunctionOptions, a as UseOsdkFunctionResult } from '../useOsdkFunction-B0s7lqgN.cjs';
+import '@osdk/client/unstable-do-not-use';
+
+interface FunctionQueryParams<Q extends QueryDefinition<unknown>> {
+    queryDefinition: Q;
+    /**
+     * Only allow params and enabled options at the query level,
+     * other options are not yet supported in this batch context
+     */
+    options?: Pick<UseOsdkFunctionOptions<Q>, "params" | "enabled">;
+}
+interface UseOsdkFunctionsProps {
+    /**
+     * Array of query configurations to execute
+     */
+    queries: Array<FunctionQueryParams<QueryDefinition<unknown>>>;
+    /**
+     * Whether to enable all queries. When false, no queries will execute.
+     * Individual query enabled states are also respected.
+     * @default true
+     */
+    enabled?: boolean;
+}
+type UseOsdkFunctionsResult = Array<Omit<UseOsdkFunctionResult<QueryDefinition<unknown>>, "refetch">>;
+/**
+ * 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
+ */
+declare function useOsdkFunctions({ queries, enabled }: UseOsdkFunctionsProps): UseOsdkFunctionsResult;
+
+export { type FunctionQueryParams, type UseOsdkFunctionsProps, type UseOsdkFunctionsResult, useOsdkFunctions };

package/build/cjs/useOsdkFunction-B0s7lqgN.d.cts

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

package/build/esm/new/OsdkContext2.js

@@ -15,14 +15,34 @@
  */
 
 import React from "react";
+export const 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);
 }
 const fakeClient = Object.assign(fakeClientFn, {
   fetchMetadata: fakeClientFn
 });
+
+// Proxy that throws a clear error when any method is called, so hooks like
+// useOsdkObjects get "Did you forget <OsdkProvider2>?" instead of
+// "cannot read canonicalizeWhereClause of undefined".
+// We intercept `get` so every property access returns a throwing function,
+// without needing to enumerate every ObservableClient method.
+// Symbol.toPrimitive and Symbol.toStringTag are accessed by React/devtools
+// during rendering and logging — returning undefined for these avoids
+// spurious throws in contexts unrelated to the user's code.
+const fakeObservableClient = new Proxy({}, {
+  get(_target, prop) {
+    if (prop === Symbol.toPrimitive || prop === Symbol.toStringTag) {
+      return undefined;
+    }
+    return (..._args) => {
+      throw new Error(MISSING_PROVIDER_MESSAGE);
+    };
+  }
+});
 export const OsdkContext2 = /*#__PURE__*/React.createContext({
   client: fakeClient,
-  observableClient: undefined
+  observableClient: fakeObservableClient
 });
 //# sourceMappingURL=OsdkContext2.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"OsdkContext2.js","names":["React","fakeClientFn","_args","Error","fakeClient","Object","assign","fetchMetadata","OsdkContext2","createContext","client","observableClient","undefined"],"sources":["OsdkContext2.ts"],"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 type { Client } from \"@osdk/client\";\nimport type { ObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\n\nfunction fakeClientFn(..._args: any[]) {\n  throw new Error(\n    \"This is not a real client. Did you forget to <OsdkContext.Provider>?\",\n  );\n}\n\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn,\n} as Client);\n\ninterface OsdkContextContents {\n  client: Client;\n  // keeping the old name for now intentionally\n  // in case i need both for a while\n  // in the future we can just make\n  // this `client: ObservableClient`\n  observableClient: ObservableClient;\n}\n\nexport const OsdkContext2: React.Context<OsdkContextContents> = React\n  .createContext<OsdkContextContents>({\n    client: fakeClient,\n    observableClient: undefined!,\n  });\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AAEzB,SAASC,YAAYA,CAAC,GAAGC,KAAY,EAAE;EACrC,MAAM,IAAIC,KAAK,CACb,sEACF,CAAC;AACH;AAEA,MAAMC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAACL,YAAY,EAAE;EAC7CM,aAAa,EAAEN;AACjB,CAAW,CAAC;AAWZ,OAAO,MAAMO,YAAgD,gBAAGR,KAAK,CAClES,aAAa,CAAsB;EAClCC,MAAM,EAAEN,UAAU;EAClBO,gBAAgB,EAAEC;AACpB,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"OsdkContext2.js","names":["React","MISSING_PROVIDER_MESSAGE","fakeClientFn","_args","Error","fakeClient","Object","assign","fetchMetadata","fakeObservableClient","Proxy","get","_target","prop","Symbol","toPrimitive","toStringTag","undefined","OsdkContext2","createContext","client","observableClient"],"sources":["OsdkContext2.ts"],"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 type { Client } from \"@osdk/client\";\nimport type { ObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\n\nexport const MISSING_PROVIDER_MESSAGE =\n  \"No OsdkProvider2 found. Did you forget to wrap your component tree with <OsdkProvider2>?\";\n\nfunction fakeClientFn(..._args: any[]) {\n  throw new Error(MISSING_PROVIDER_MESSAGE);\n}\n\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn,\n} as Client);\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({} as ObservableClient, {\n  get(_target, prop) {\n    if (prop === Symbol.toPrimitive || prop === Symbol.toStringTag) {\n      return undefined;\n    }\n    return (..._args: any[]) => {\n      throw new Error(MISSING_PROVIDER_MESSAGE);\n    };\n  },\n});\n\ninterface OsdkContextContents {\n  client: Client;\n  // keeping the old name for now intentionally\n  // in case i need both for a while\n  // in the future we can just make\n  // this `client: ObservableClient`\n  observableClient: ObservableClient;\n}\n\nexport const OsdkContext2: React.Context<OsdkContextContents> = React\n  .createContext<OsdkContextContents>({\n    client: fakeClient,\n    observableClient: fakeObservableClient,\n  });\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AAEzB,OAAO,MAAMC,wBAAwB,GACnC,0FAA0F;AAE5F,SAASC,YAAYA,CAAC,GAAGC,KAAY,EAAE;EACrC,MAAM,IAAIC,KAAK,CAACH,wBAAwB,CAAC;AAC3C;AAEA,MAAMI,UAAU,GAAGC,MAAM,CAACC,MAAM,CAACL,YAAY,EAAE;EAC7CM,aAAa,EAAEN;AACjB,CAAW,CAAC;;AAEZ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMO,oBAAoB,GAAG,IAAIC,KAAK,CAAC,CAAC,CAAC,EAAsB;EAC7DC,GAAGA,CAACC,OAAO,EAAEC,IAAI,EAAE;IACjB,IAAIA,IAAI,KAAKC,MAAM,CAACC,WAAW,IAAIF,IAAI,KAAKC,MAAM,CAACE,WAAW,EAAE;MAC9D,OAAOC,SAAS;IAClB;IACA,OAAO,CAAC,GAAGd,KAAY,KAAK;MAC1B,MAAM,IAAIC,KAAK,CAACH,wBAAwB,CAAC;IAC3C,CAAC;EACH;AACF,CAAC,CAAC;AAWF,OAAO,MAAMiB,YAAgD,gBAAGlB,KAAK,CAClEmB,aAAa,CAAsB;EAClCC,MAAM,EAAEf,UAAU;EAClBgB,gBAAgB,EAAEZ;AACpB,CAAC,CAAC","ignoreList":[]}

package/build/esm/new/platform-apis/admin/useCbacBanner.js

@@ -0,0 +1,63 @@
+/*
+ * 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 { CbacBanners } from "@osdk/foundry.admin";
+import React from "react";
+import { usePlatformQuery } from "../../../utils/usePlatformQuery.js";
+import { OsdkContext2 } from "../../OsdkContext2.js";
+/**
+ * Get the CBAC banner data for the given marking IDs.
+ * @param options Options to control the query.
+ */
+export function useCbacBanner({
+  markingIds,
+  enabled: externalEnabled = true
+}) {
+  const {
+    client
+  } = React.useContext(OsdkContext2);
+  const stableMarkingIds = React.useMemo(() => markingIds, [JSON.stringify(markingIds)]);
+  const enabled = stableMarkingIds.length > 0 && externalEnabled;
+  const handleQuery = React.useCallback(() => {
+    return CbacBanners.get(client, {
+      markingIds: stableMarkingIds,
+      preview: true
+    });
+  }, [client, stableMarkingIds]);
+  const query = usePlatformQuery({
+    query: handleQuery,
+    enabled,
+    queryName: "cbac-banner"
+  });
+  const banner = React.useMemo(() => {
+    if (query.data == null) {
+      return undefined;
+    }
+    return {
+      classificationString: query.data.classificationString,
+      textColor: query.data.textColor,
+      backgroundColors: query.data.backgroundColors,
+      markingIds: query.data.markings
+    };
+  }, [query.data]);
+  return {
+    banner,
+    isLoading: query.isLoading,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+//# sourceMappingURL=useCbacBanner.js.map

package/build/esm/new/platform-apis/admin/useCbacBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCbacBanner.js","names":["CbacBanners","React","usePlatformQuery","OsdkContext2","useCbacBanner","markingIds","enabled","externalEnabled","client","useContext","stableMarkingIds","useMemo","JSON","stringify","length","handleQuery","useCallback","get","preview","query","queryName","banner","data","undefined","classificationString","textColor","backgroundColors","markings","isLoading","error","refetch"],"sources":["useCbacBanner.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 { CbacBanners } from \"@osdk/foundry.admin\";\nimport React from \"react\";\nimport { usePlatformQuery } from \"../../../utils/usePlatformQuery.js\";\nimport { OsdkContext2 } from \"../../OsdkContext2.js\";\n\nexport interface CbacBannerData {\n  classificationString: string;\n  textColor: string;\n  backgroundColors: string[];\n  markingIds: string[];\n}\n\nexport interface UseCbacBannerOptions {\n  markingIds: string[];\n  /**\n   * Enable or disable the query.\n   *\n   * When `false`, the query will not automatically execute.\n   *\n   * This is useful for:\n   * - Lazy/on-demand queries that should wait for user interaction\n   * - Dependent queries that need data from another query first\n   * - Conditional queries based on component state\n   *\n   * @default true\n   */\n  enabled?: boolean;\n}\n\nexport interface UseCbacBannerResult {\n  banner: CbacBannerData | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  refetch: () => void;\n}\n\n/**\n * Get the CBAC banner data for the given marking IDs.\n * @param options Options to control the query.\n */\nexport function useCbacBanner(\n  { markingIds, enabled: externalEnabled = true }: UseCbacBannerOptions,\n): UseCbacBannerResult {\n  const { client } = React.useContext(OsdkContext2);\n\n  const stableMarkingIds = React.useMemo(\n    () => markingIds,\n    [JSON.stringify(markingIds)],\n  );\n\n  const enabled = stableMarkingIds.length > 0 && externalEnabled;\n\n  const handleQuery = React.useCallback(() => {\n    return CbacBanners.get(client, {\n      markingIds: stableMarkingIds,\n      preview: true,\n    });\n  }, [client, stableMarkingIds]);\n\n  const query = usePlatformQuery({\n    query: handleQuery,\n    enabled,\n    queryName: \"cbac-banner\",\n  });\n\n  const banner = React.useMemo((): CbacBannerData | undefined => {\n    if (query.data == null) {\n      return undefined;\n    }\n    return {\n      classificationString: query.data.classificationString,\n      textColor: query.data.textColor,\n      backgroundColors: query.data.backgroundColors,\n      markingIds: query.data.markings,\n    };\n  }, [query.data]);\n\n  return {\n    banner,\n    isLoading: query.isLoading,\n    error: query.error,\n    refetch: query.refetch,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,WAAW,QAAQ,qBAAqB;AACjD,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,gBAAgB,QAAQ,oCAAoC;AACrE,SAASC,YAAY,QAAQ,uBAAuB;AAmCpD;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B;EAAEC,UAAU;EAAEC,OAAO,EAAEC,eAAe,GAAG;AAA2B,CAAC,EAChD;EACrB,MAAM;IAAEC;EAAO,CAAC,GAAGP,KAAK,CAACQ,UAAU,CAACN,YAAY,CAAC;EAEjD,MAAMO,gBAAgB,GAAGT,KAAK,CAACU,OAAO,CACpC,MAAMN,UAAU,EAChB,CAACO,IAAI,CAACC,SAAS,CAACR,UAAU,CAAC,CAC7B,CAAC;EAED,MAAMC,OAAO,GAAGI,gBAAgB,CAACI,MAAM,GAAG,CAAC,IAAIP,eAAe;EAE9D,MAAMQ,WAAW,GAAGd,KAAK,CAACe,WAAW,CAAC,MAAM;IAC1C,OAAOhB,WAAW,CAACiB,GAAG,CAACT,MAAM,EAAE;MAC7BH,UAAU,EAAEK,gBAAgB;MAC5BQ,OAAO,EAAE;IACX,CAAC,CAAC;EACJ,CAAC,EAAE,CAACV,MAAM,EAAEE,gBAAgB,CAAC,CAAC;EAE9B,MAAMS,KAAK,GAAGjB,gBAAgB,CAAC;IAC7BiB,KAAK,EAAEJ,WAAW;IAClBT,OAAO;IACPc,SAAS,EAAE;EACb,CAAC,CAAC;EAEF,MAAMC,MAAM,GAAGpB,KAAK,CAACU,OAAO,CAAC,MAAkC;IAC7D,IAAIQ,KAAK,CAACG,IAAI,IAAI,IAAI,EAAE;MACtB,OAAOC,SAAS;IAClB;IACA,OAAO;MACLC,oBAAoB,EAAEL,KAAK,CAACG,IAAI,CAACE,oBAAoB;MACrDC,SAAS,EAAEN,KAAK,CAACG,IAAI,CAACG,SAAS;MAC/BC,gBAAgB,EAAEP,KAAK,CAACG,IAAI,CAACI,gBAAgB;MAC7CrB,UAAU,EAAEc,KAAK,CAACG,IAAI,CAACK;IACzB,CAAC;EACH,CAAC,EAAE,CAACR,KAAK,CAACG,IAAI,CAAC,CAAC;EAEhB,OAAO;IACLD,MAAM;IACNO,SAAS,EAAET,KAAK,CAACS,SAAS;IAC1BC,KAAK,EAAEV,KAAK,CAACU,KAAK;IAClBC,OAAO,EAAEX,KAAK,CAACW;EACjB,CAAC;AACH","ignoreList":[]}

package/build/esm/new/platform-apis/admin/useCbacMarkingRestrictions.js

@@ -0,0 +1,64 @@
+/*
+ * 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 { CbacMarkingRestrictionsObjects } from "@osdk/foundry.admin";
+import React from "react";
+import { usePlatformQuery } from "../../../utils/usePlatformQuery.js";
+import { OsdkContext2 } from "../../OsdkContext2.js";
+/**
+ * Get CBAC marking restrictions (implied, disallowed, required) for the given marking IDs.
+ * @param options Options to control the query.
+ */
+export function useCbacMarkingRestrictions({
+  markingIds,
+  enabled: externalEnabled = true
+}) {
+  const {
+    client
+  } = React.useContext(OsdkContext2);
+  const stableMarkingIds = React.useMemo(() => markingIds, [JSON.stringify(markingIds)]);
+  const enabled = stableMarkingIds.length > 0 && externalEnabled;
+  const handleQuery = React.useCallback(() => {
+    return CbacMarkingRestrictionsObjects.get(client, {
+      markingIds: stableMarkingIds,
+      preview: true
+    });
+  }, [client, stableMarkingIds]);
+  const query = usePlatformQuery({
+    query: handleQuery,
+    enabled,
+    queryName: "cbac-marking-restrictions"
+  });
+  const restrictions = React.useMemo(() => {
+    if (query.data == null) {
+      return undefined;
+    }
+    return {
+      disallowedMarkings: query.data.disallowedMarkings.map(String),
+      impliedMarkings: query.data.impliedMarkings.map(String),
+      requiredMarkings: query.data.requiredMarkings.map(group => group.map(String)),
+      userSatisfiesMarkings: query.data.userSatisfiesMarkings,
+      isValid: query.data.isValid
+    };
+  }, [query.data]);
+  return {
+    restrictions,
+    isLoading: query.isLoading,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+//# sourceMappingURL=useCbacMarkingRestrictions.js.map