@osdk/react 0.10.0-beta.1 → 0.10.0-beta.11

package/AGENTS.md

@@ -1,21 +1,20 @@
-# @osdk/react - AI Agent Instructions
+# @osdk/react
 
-## Critical Rules
+## Rules
 
-1. **Use `OsdkProvider2`** - Not `OsdkProvider`. All modern hooks require `OsdkProvider2`.
-2. **Import from `@osdk/react/experimental`** - Not `@osdk/react`. The main entry point only has legacy hooks.
-3. **Never conditionally call hooks** - Use the `enabled` option instead.
-4. **Keep rendering during loading** - No early returns like `if (isLoading) return <Spinner />`. Show loading indicators while rendering existing data.
+1. **Use `OsdkProvider2`**, not `OsdkProvider`. All modern hooks require it.
+2. **Import from `@osdk/react/experimental`**, not `@osdk/react`. Main entry only has legacy hooks.
+3. **Never conditionally call hooks.** Use the `enabled` option instead.
+4. **Keep rendering during loading.** No early returns like `if (isLoading) return <Spinner />`. Show loading indicators alongside existing data to prevent UI flashing. Exception: `if (!data && isLoading)` is acceptable for initial load.
+5. **`useOsdkObject` `enabled` is positional**, not in an options object: `useOsdkObject(Type, id, false)`.
 
 ## Exports
 
-**Stable** (`@osdk/react`):
+**Stable** (`@osdk/react`): `OsdkProvider` (legacy), `useOsdkClient`, `useOsdkMetadata`
 
-- `OsdkProvider` - Legacy provider
-- `useOsdkClient` - Access client
-- `useOsdkMetadata` - Fetch metadata
+**Experimental** (`@osdk/react/experimental`): `OsdkProvider2`, `useOsdkObjects`, `useOsdkObject`, `useOsdkAction`, `useLinks`, `useObjectSet`, `useOsdkAggregation`, `useOsdkFunction`, `useDebouncedCallback`, `useCurrentFoundryUser`, `useFoundryUser`, `useFoundryUsersList`
 
-**Experimental** (`@osdk/react/experimental`):
+## Hook Options
 
 - `OsdkProvider2` - Modern provider (use this)
 - `useOsdkObjects` - Query lists of objects
@@ -24,230 +23,56 @@
 - `useLinks` - Navigate object relationships
 - `useObjectSet` - Advanced set operations (union, intersect, subtract, pivot)
 - `useOsdkAggregation` - Server-side aggregations with groupBy/select
-- `useCurrentFoundryUser`, `useFoundryUser`, `useFoundryUsersList` - Platform APIs
 - `useOsdkClient`, `useOsdkMetadata` - Also available from experimental
 
-## Correct Patterns
-
-### Loading States
-
-```tsx
-import { Todo } from "@my/osdk";
-import { useOsdkObjects } from "@osdk/react/experimental";
-
-function TodoList() {
-  const { data, isLoading, error } = useOsdkObjects(Todo);
-
-  return (
-    <div>
-      {isLoading && <LoadingIndicator />}
-      {error && <ErrorMessage error={error} />}
-      {data?.map(todo => <TodoItem key={todo.$primaryKey} todo={todo} />)}
-    </div>
-  );
-}
-```
+**Experimental Admin** (`@osdk/react/experimental/admin`):
 
-### Single Object (useOsdkObject)
-
-```tsx
-import { Employee } from "@my/osdk";
-import { useOsdkObject } from "@osdk/react/experimental";
-
-// By type + primary key (enabled is 3rd positional param)
-const { object, isLoading, error, isOptimistic } = useOsdkObject(
-  Employee,
-  "employee-123",
-  true, // enabled (optional, defaults to true)
-);
-
-// By existing instance (enabled is 2nd positional param)
-const { object: refreshed } = useOsdkObject(existingEmployee, true);
-```
-
-### Conditional Fetching
-
-```tsx
-// useOsdkObjects uses options object
-const { data: reports } = useOsdkObjects(Employee, {
-  where: { managerId: selectedManagerId },
-  enabled: !!selectedManagerId,
-});
-
-// useOsdkObject uses positional enabled parameter
-const { object: manager } = useOsdkObject(Employee, managerId, !!managerId);
-```
+- `useCurrentFoundryUser`, `useFoundryUser`, `useFoundryUsersList` - Platform APIs (requires `@osdk/foundry.admin`)
 
-### Actions (useOsdkAction)
+## Correct Patterns
 
-```tsx
-import { $Actions } from "@my/osdk";
-import { useOsdkAction } from "@osdk/react/experimental";
-
-function CompleteTodoButton({ todo }) {
-  const {
-    applyAction,
-    validateAction,
-    isPending,
-    isValidating,
-    error,
-    data,
-    validationResult,
-  } = useOsdkAction($Actions.completeTodo);
-
-  // Validate before applying
-  const handleValidate = async () => {
-    const result = await validateAction({ todo, isComplete: true });
-  };
-
-  // Apply the action
-  const handleComplete = async () => {
-    await applyAction({ todo, isComplete: true });
-  };
-
-  // With optimistic update (use $ prefix for client options)
-  const handleOptimistic = async () => {
-    await applyAction({
-      todo,
-      isComplete: true,
-      $optimisticUpdate: (ctx) => {
-        ctx.updateObject(todo, { isComplete: true });
-      },
-    });
-  };
-
-  return (
-    <button onClick={handleComplete} disabled={isPending}>
-      Complete
-    </button>
-  );
-}
-```
+| Hook                 | Key Options                                                                                                                                   |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `useOsdkObjects`     | `where`, `orderBy`, `pageSize`, `withProperties`, `enabled`, `autoFetchMore`, `dedupeIntervalMs`, `streamUpdates`, `intersectWith`, `pivotTo` |
+| `useObjectSet`       | Same as above plus `union`, `intersect`, `subtract`. Use when you need set operations.                                                        |
+| `useOsdkObject`      | `enabled` is **positional** (2nd param for instance, 3rd for type+key)                                                                        |
+| `useLinks`           | `where`, `pageSize`, `enabled`, `mode` (`"force"` / `"offline"`), `dedupeIntervalMs`. Accepts single object or array.                         |
+| `useOsdkAction`      | Returns `applyAction`, `validateAction`, `isPending`, `error`, `validationResult`. Pass `$optimisticUpdate` with `$` prefix in action params. |
+| `useOsdkAggregation` | `where`, `aggregate: { $groupBy, $select }`. Metrics: `$count`, `sum`, `avg`, `min`, `max`, `exactDistinct`, `approximateDistinct`.           |
+| `useOsdkFunction`    | `params`, `dependsOn` (object types), `dependsOnObjects` (instances), `enabled`, `dedupeIntervalMs`                                           |
 
-### Links (useLinks)
+## Text Search Filters
 
-```tsx
-import { useLinks } from "@osdk/react/experimental";
-
-// Single object
-const { links, isLoading, hasMore, fetchMore, error } = useLinks(
-  employee,
-  "directReports",
-  { pageSize: 20 },
-);
-
-// Multiple objects (returns all linked objects)
-const { links: allReports } = useLinks(
-  [employee1, employee2],
-  "directReports",
-);
-```
+`$startsWith`, `$containsAnyTerm`, `$containsAllTerms`, `$containsAllTermsInOrder`. All support `{ term, fuzzySearch: true }`.
 
-### Object Set Operations (useObjectSet)
+## useOsdkObjects vs useObjectSet
 
-```tsx
-import { Employee } from "@my/osdk";
-import { useObjectSet } from "@osdk/react/experimental";
-
-const { data, isLoading, fetchMore, objectSet } = useObjectSet(
-  Employee.all(),
-  {
-    where: { department: "Engineering" },
-    orderBy: { hireDate: "desc" },
-    pageSize: 50,
-    union: [otherObjectSet],
-    intersect: [anotherObjectSet],
-    autoFetchMore: 100, // fetch until 100 items
-    streamUpdates: true,
-    enabled: true,
-  },
-);
-```
+Use `useOsdkObjects` by default (more optimized). Use `useObjectSet` only when you need `union`/`intersect`/`subtract` set operations.
 
-### Aggregations (useOsdkAggregation)
+## Cache
 
-```tsx
-import { Employee } from "@my/osdk";
-import { useOsdkAggregation } from "@osdk/react/experimental";
-
-const { data, isLoading, error, refetch } = useOsdkAggregation(Employee, {
-  where: { department: "Engineering" },
-  aggregate: {
-    groupBy: { department: "exact" },
-    select: {
-      avgSalary: { $avg: "salary" },
-      count: { $count: {} },
-    },
-  },
-});
-```
+The `ObservableClient` maintains a normalized cache. Objects update automatically after actions. For manual invalidation: `observableClient.invalidateObjects()`, `.invalidateObjectType()`, `.invalidateFunction()`, `.invalidateAll()`.
 
 ## Anti-Patterns
 
-### Wrong: Conditional Hook Call
-
-```tsx
-if (shouldLoad) {
-  const { data } = useOsdkObjects(Todo); // NEVER do this
-}
-```
-
-### Wrong: Early Return During Loading
-
-```tsx
-if (isLoading) return <Spinner />; // Causes UI flashing
-if (!data) return null; // Loses state
-```
-
-### Wrong: Importing from Main Entry
-
-```tsx
-import { useOsdkObjects } from "@osdk/react"; // WRONG - doesn't exist here
-```
-
-### Wrong: Using OsdkProvider Instead of OsdkProvider2
-
 ```tsx
-<OsdkProvider client={client}> // WRONG - new hooks won't work
-```
-
-### Wrong: Using options object for useOsdkObject enabled
-
-```tsx
-// WRONG - enabled is positional, not in options
-const { object } = useOsdkObject(Employee, id, { enabled: false });
-
+// WRONG: conditional hook
+if (x) { useOsdkObjects(Todo); }
+// CORRECT: use enabled
+useOsdkObjects(Todo, { enabled: x });
+
+// WRONG: early return
+if (isLoading) return <Spinner />;
+// CORRECT: render together
+<div>{isLoading && <Spinner />}{data?.map(...)}</div>
+
+// WRONG: import from main entry
+import { useOsdkObjects } from "@osdk/react";
 // CORRECT
-const { object } = useOsdkObject(Employee, id, false);
-```
-
-## Hook Options Reference
-
-**useOsdkObjects / useObjectSet:**
-
-- `where` - Filter conditions
-- `orderBy` - Sort order (`{ field: "asc" | "desc" }`)
-- `pageSize` - Results per page
-- `withProperties` - Derived properties
-- `enabled` - Enable/disable query
-- `autoFetchMore` - Auto-pagination (`true` | `number`)
-- `dedupeIntervalMs` - Request deduplication
-- `streamUpdates` - WebSocket updates
-
-**useObjectSet additional:**
-
-- `union`, `intersect`, `subtract` - Set operations
-- `pivotTo` - Pivot to linked type
-
-**useOsdkObject:**
-
-- `enabled` is a **positional parameter**, not in options
-
-**useLinks:**
-
-- `where`, `pageSize`, `enabled`
-- `mode` - `"force"` | `"offline"`
-
-**useOsdkAction:**
+import { useOsdkObjects } from "@osdk/react/experimental";
 
-- `$optimisticUpdate` - Passed to action with `$` prefix
+// WRONG: useOsdkObject enabled in options
+useOsdkObject(Employee, id, { enabled: false });
+// CORRECT: positional
+useOsdkObject(Employee, id, false);
+```

package/CHANGELOG.md

@@ -1,5 +1,152 @@
 # @osdkkit/react
 
+## 0.10.0-beta.11
+
+### Minor Changes
+
+- b1e8bba: add cbac admin hooks for markings, categories, and restrictions
+- 599426b: expose $loadPropertySecurityMetadata option in observable client and react hooks
+
+### Patch Changes
+
+- Updated dependencies [599426b]
+- Updated dependencies [60b5ffb]
+- Updated dependencies [61e33ab]
+  - @osdk/client@2.8.0-beta.26
+  - @osdk/api@2.8.0-beta.26
+
+## 0.10.0-beta.10
+
+### Minor Changes
+
+- dbbfb6f: Add experimental ActionForm component with field renderers, form state hook, and tests
+
+### Patch Changes
+
+- Updated dependencies [cbfa135]
+- Updated dependencies [f4604c2]
+  - @osdk/client@2.8.0-beta.22
+  - @osdk/api@2.8.0-beta.22
+
+## 0.10.0-beta.9
+
+### Minor Changes
+
+- c40444b: Add linkedObjectsBySourcePrimaryKey to link observation responses
+
+### Patch Changes
+
+- Updated dependencies [c40444b]
+- Updated dependencies [dda14be]
+  - @osdk/client@2.8.0-beta.21
+  - @osdk/api@2.8.0-beta.21
+
+## 0.10.0-beta.8
+
+### Minor Changes
+
+- 9720083: Add AGENTS.md files for AI IDE context
+- 09e5659: add $select support to observable client and react hooks
+- 8a82492: Move admin hooks to @osdk/react/experimental/admin subpath to avoid bundler crash when @osdk/foundry.admin is not installed
+- 2ebe62c: package and bundle size optimizations
+
+### Patch Changes
+
+- Updated dependencies [09e5659]
+- Updated dependencies [2ebe62c]
+  - @osdk/client@2.8.0-beta.16
+  - @osdk/api@2.8.0-beta.16
+
+## 0.10.0-beta.7
+
+### Minor Changes
+
+- 9156827: Preserve object set data between loads
+- 35f2f1a: Add Media inputs/outputs for Queries
+- 71e28ef: Allow interface object sets in useObjectSet
+
+### Patch Changes
+
+- Updated dependencies [e64bf0b]
+- Updated dependencies [baba327]
+- Updated dependencies [d1ad4d1]
+- Updated dependencies [35f2f1a]
+- Updated dependencies [71e28ef]
+  - @osdk/client@2.8.0-beta.14
+  - @osdk/api@2.8.0-beta.14
+
+## 0.10.0-beta.6
+
+### Minor Changes
+
+- 993c023: ObjectTable supports objectSet input
+
+### Patch Changes
+
+- Updated dependencies [8825f8c]
+  - @osdk/client@2.8.0-beta.12
+  - @osdk/api@2.8.0-beta.12
+
+## 0.10.0-beta.5
+
+### Minor Changes
+
+- 525f277: update useOsdkAggregation to support composed object sets, async
+- d80c234: add interface support to useOsdkObject
+- 996d8e4: memoize hook responses
+
+### Patch Changes
+
+- Updated dependencies [642be5f]
+- Updated dependencies [525f277]
+- Updated dependencies [f5f95e2]
+- Updated dependencies [d80c234]
+  - @osdk/client@2.8.0-beta.11
+  - @osdk/api@2.8.0-beta.11
+
+## 0.10.0-beta.4
+
+### Minor Changes
+
+- 727fd0e: fix dual @types/react version mismatch
+
+### Patch Changes
+
+- Updated dependencies [8c60682]
+- Updated dependencies [15e1686]
+- Updated dependencies [c9d954d]
+- Updated dependencies [044eb80]
+- Updated dependencies [9d234b9]
+  - @osdk/client@2.8.0-beta.6
+  - @osdk/api@2.8.0-beta.6
+
+## 0.10.0-beta.3
+
+### Minor Changes
+
+- 73e617e: expose dedupeInterval on useLinks and fix forced revalidation bypassing dedupeInterval
+- a027f3c: stabilize subscription deps in useOsdkObjects and useOsdkAggregation
+
+### Patch Changes
+
+- Updated dependencies [73e617e]
+- Updated dependencies [5848e3c]
+  - @osdk/client@2.8.0-beta.4
+  - @osdk/api@2.8.0-beta.4
+
+## 0.10.0-beta.2
+
+### Minor Changes
+
+- 0d174a2: useOsdkFunction typing updates
+
+### Patch Changes
+
+- Updated dependencies [26cec61]
+- Updated dependencies [0d174a2]
+  - @osdk/client@2.8.0-beta.3
+  - @osdk/api@2.8.0-beta.3
+
 ## 0.9.0-beta.10
 
 ### Minor Changes

package/build/browser/new/makeExternalStore.js

@@ -42,4 +42,65 @@ export function makeExternalStore(createObservation, _name, initialValue) {
     getSnapShot
   };
 }
+
+/**
+ * Like makeExternalStore but for async subscription creation.
+ *
+ * Uses an isActive flag to handle race conditions:
+ * If cleanup runs before promise resolves, the stale subscription is
+ * immediately unsubscribed when it eventually resolves
+ */
+export function makeExternalStoreAsync(createObservation, _name, initialValue) {
+  let lastResult = initialValue;
+  function getSnapShot() {
+    return lastResult;
+  }
+  function subscribe(notifyUpdate) {
+    let isActive = true;
+    let currentSubscription;
+    const subscriptionPromise = createObservation({
+      next: payload => {
+        if (isActive) {
+          lastResult = payload;
+          notifyUpdate();
+        }
+      },
+      error: error => {
+        if (isActive) {
+          lastResult = {
+            ...(lastResult ?? {}),
+            error: error instanceof Error ? error : new Error(String(error))
+          };
+          notifyUpdate();
+        }
+      },
+      complete: () => {}
+    });
+    subscriptionPromise.then(sub => {
+      if (isActive) {
+        currentSubscription = sub;
+      } else {
+        sub.unsubscribe();
+      }
+    }).catch(error => {
+      if (isActive) {
+        lastResult = {
+          ...(lastResult ?? {}),
+          error: error instanceof Error ? error : new Error(String(error))
+        };
+        notifyUpdate();
+      }
+    });
+    return () => {
+      isActive = false;
+      if (currentSubscription) {
+        currentSubscription.unsubscribe();
+      }
+    };
+  }
+  return {
+    subscribe,
+    getSnapShot
+  };
+}
 //# sourceMappingURL=makeExternalStore.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"makeExternalStore.js","names":["makeExternalStore","createObservation","_name","initialValue","lastResult","getSnapShot","subscribe","notifyUpdate","obs","next","payload","error","Error","String","complete","unsubscribe"],"sources":["makeExternalStore.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  Observer,\n  Unsubscribable,\n} from \"@osdk/client/unstable-do-not-use\";\n\nexport type Snapshot<X> =\n  | X & { error?: Error }\n  | (Partial<X> & { error?: Error })\n  | undefined;\n\nexport function makeExternalStore<X>(\n  createObservation: (callback: Observer<X | undefined>) => Unsubscribable,\n  _name?: string,\n  initialValue?: Snapshot<X>,\n): {\n  subscribe: (notifyUpdate: () => void) => () => void;\n  getSnapShot: () => Snapshot<X>;\n} {\n  let lastResult: Snapshot<X> = initialValue;\n\n  function getSnapShot(): Snapshot<X> {\n    return lastResult;\n  }\n\n  function subscribe(notifyUpdate: () => void) {\n    const obs = createObservation({\n      next: (payload) => {\n        lastResult = payload as Snapshot<X>;\n        notifyUpdate();\n      },\n      error: (error: unknown) => {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error)),\n        } as Snapshot<X>;\n        notifyUpdate();\n      },\n      complete: () => {},\n    });\n\n    return (): void => {\n      obs.unsubscribe();\n    };\n  }\n\n  return {\n    subscribe,\n    getSnapShot,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA,OAAO,SAASA,iBAAiBA,CAC/BC,iBAAwE,EACxEC,KAAc,EACdC,YAA0B,EAI1B;EACA,IAAIC,UAAuB,GAAGD,YAAY;EAE1C,SAASE,WAAWA,CAAA,EAAgB;IAClC,OAAOD,UAAU;EACnB;EAuBA,OAAO;IACLE,SAAS,EAtBX,SAASA,SAASA,CAACC,YAAwB,EAAE;MAC3C,MAAMC,GAAG,GAAGP,iBAAiB,CAAC;QAC5BQ,IAAI,EAAGC,OAAO,IAAK;UACjBN,UAAU,GAAGM,OAAsB;UACnCH,YAAY,CAAC,CAAC;QAChB,CAAC;QACDI,KAAK,EAAGA,KAAc,IAAK;UACzBP,UAAU,GAAG;YACX,IAAIA,UAAU,IAAI,CAAC,CAAC,CAAC;YACrBO,KAAK,EAAEA,KAAK,YAAYC,KAAK,GAAGD,KAAK,GAAG,IAAIC,KAAK,CAACC,MAAM,CAACF,KAAK,CAAC;UACjE,CAAgB;UAChBJ,YAAY,CAAC,CAAC;QAChB,CAAC;QACDO,QAAQ,EAAEA,CAAA,KAAM,CAAC;MACnB,CAAC,CAAC;MAEF,OAAO,MAAY;QACjBN,GAAG,CAACO,WAAW,CAAC,CAAC;MACnB,CAAC;IACH,CAGW;IACTV;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"makeExternalStore.js","names":["makeExternalStore","createObservation","_name","initialValue","lastResult","getSnapShot","subscribe","notifyUpdate","obs","next","payload","error","Error","String","complete","unsubscribe","makeExternalStoreAsync","isActive","currentSubscription","subscriptionPromise","then","sub","catch"],"sources":["makeExternalStore.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  Observer,\n  Unsubscribable,\n} from \"@osdk/client/unstable-do-not-use\";\n\nexport type Snapshot<X> =\n  | X & { error?: Error }\n  | (Partial<X> & { error?: Error })\n  | undefined;\n\nexport function makeExternalStore<X>(\n  createObservation: (callback: Observer<X | undefined>) => Unsubscribable,\n  _name?: string,\n  initialValue?: Snapshot<X>,\n): {\n  subscribe: (notifyUpdate: () => void) => () => void;\n  getSnapShot: () => Snapshot<X>;\n} {\n  let lastResult: Snapshot<X> = initialValue;\n\n  function getSnapShot(): Snapshot<X> {\n    return lastResult;\n  }\n\n  function subscribe(notifyUpdate: () => void) {\n    const obs = createObservation({\n      next: (payload) => {\n        lastResult = payload as Snapshot<X>;\n        notifyUpdate();\n      },\n      error: (error: unknown) => {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error)),\n        } as Snapshot<X>;\n        notifyUpdate();\n      },\n      complete: () => {},\n    });\n\n    return (): void => {\n      obs.unsubscribe();\n    };\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<X>(\n  createObservation: (\n    callback: Observer<X | undefined>,\n  ) => Promise<Unsubscribable>,\n  _name?: string,\n  initialValue?: Snapshot<X>,\n): {\n  subscribe: (notifyUpdate: () => void) => () => void;\n  getSnapShot: () => Snapshot<X>;\n} {\n  let lastResult: Snapshot<X> = initialValue;\n\n  function getSnapShot(): Snapshot<X> {\n    return lastResult;\n  }\n\n  function subscribe(notifyUpdate: () => void) {\n    let isActive = true;\n    let currentSubscription: Unsubscribable | undefined;\n\n    const subscriptionPromise = createObservation({\n      next: (payload) => {\n        if (isActive) {\n          lastResult = payload as Snapshot<X>;\n          notifyUpdate();\n        }\n      },\n      error: (error: unknown) => {\n        if (isActive) {\n          lastResult = {\n            ...(lastResult ?? {}),\n            error: error instanceof Error ? error : new Error(String(error)),\n          } as Snapshot<X>;\n          notifyUpdate();\n        }\n      },\n      complete: () => {},\n    });\n\n    subscriptionPromise.then((sub) => {\n      if (isActive) {\n        currentSubscription = sub;\n      } else {\n        sub.unsubscribe();\n      }\n    }).catch((error: unknown) => {\n      if (isActive) {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error)),\n        } as Snapshot<X>;\n        notifyUpdate();\n      }\n    });\n\n    return (): void => {\n      isActive = false;\n      if (currentSubscription) {\n        currentSubscription.unsubscribe();\n      }\n    };\n  }\n\n  return {\n    subscribe,\n    getSnapShot,\n  };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/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/browser/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/browser/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