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

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/hookUtils.js

@@ -0,0 +1,32 @@
+/*
+ * 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 function extractPayloadError(payload, fallbackMessage) {
+  if (payload && "error" in payload && payload.error) {
+    return payload.error;
+  }
+  if (payload?.status === "error") {
+    return new Error(fallbackMessage);
+  }
+  return undefined;
+}
+export function isPayloadLoading(payload, enabled) {
+  if (!enabled) {
+    return false;
+  }
+  return payload?.status === "loading" || payload?.status === "init" || !payload;
+}
+//# sourceMappingURL=hookUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hookUtils.js","names":["extractPayloadError","payload","fallbackMessage","error","status","Error","undefined","isPayloadLoading","enabled"],"sources":["hookUtils.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 function extractPayloadError(\n  payload: { error?: Error; status?: string } | undefined | null,\n  fallbackMessage: string,\n): Error | undefined {\n  if (payload && \"error\" in payload && payload.error) {\n    return payload.error;\n  }\n  if (payload?.status === \"error\") {\n    return new Error(fallbackMessage);\n  }\n  return undefined;\n}\n\nexport function isPayloadLoading(\n  payload: { status?: string } | undefined | null,\n  enabled: boolean,\n): boolean {\n  if (!enabled) {\n    return false;\n  }\n  return payload?.status === \"loading\" || payload?.status === \"init\"\n    || !payload;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASA,mBAAmBA,CACjCC,OAA8D,EAC9DC,eAAuB,EACJ;EACnB,IAAID,OAAO,IAAI,OAAO,IAAIA,OAAO,IAAIA,OAAO,CAACE,KAAK,EAAE;IAClD,OAAOF,OAAO,CAACE,KAAK;EACtB;EACA,IAAIF,OAAO,EAAEG,MAAM,KAAK,OAAO,EAAE;IAC/B,OAAO,IAAIC,KAAK,CAACH,eAAe,CAAC;EACnC;EACA,OAAOI,SAAS;AAClB;AAEA,OAAO,SAASC,gBAAgBA,CAC9BN,OAA+C,EAC/CO,OAAgB,EACP;EACT,IAAI,CAACA,OAAO,EAAE;IACZ,OAAO,KAAK;EACd;EACA,OAAOP,OAAO,EAAEG,MAAM,KAAK,SAAS,IAAIH,OAAO,EAAEG,MAAM,KAAK,MAAM,IAC7D,CAACH,OAAO;AACf","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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCbacMarkingRestrictions.js","names":["CbacMarkingRestrictionsObjects","React","usePlatformQuery","OsdkContext2","useCbacMarkingRestrictions","markingIds","enabled","externalEnabled","client","useContext","stableMarkingIds","useMemo","JSON","stringify","length","handleQuery","useCallback","get","preview","query","queryName","restrictions","data","undefined","disallowedMarkings","map","String","impliedMarkings","requiredMarkings","group","userSatisfiesMarkings","isValid","isLoading","error","refetch"],"sources":["useCbacMarkingRestrictions.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 { CbacMarkingRestrictionsObjects } from \"@osdk/foundry.admin\";\nimport React from \"react\";\nimport { usePlatformQuery } from \"../../../utils/usePlatformQuery.js\";\nimport { OsdkContext2 } from \"../../OsdkContext2.js\";\n\nexport interface CbacMarkingRestrictionsData {\n  disallowedMarkings: string[];\n  impliedMarkings: string[];\n  requiredMarkings: string[][];\n  userSatisfiesMarkings: boolean;\n  isValid: boolean;\n}\n\nexport interface UseCbacMarkingRestrictionsOptions {\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 UseCbacMarkingRestrictionsResult {\n  restrictions: CbacMarkingRestrictionsData | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  refetch: () => void;\n}\n\n/**\n * Get CBAC marking restrictions (implied, disallowed, required) for the given marking IDs.\n * @param options Options to control the query.\n */\nexport function useCbacMarkingRestrictions(\n  { markingIds, enabled: externalEnabled = true }:\n    UseCbacMarkingRestrictionsOptions,\n): UseCbacMarkingRestrictionsResult {\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 CbacMarkingRestrictionsObjects.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-marking-restrictions\",\n  });\n\n  const restrictions = React.useMemo(\n    (): CbacMarkingRestrictionsData | undefined => {\n      if (query.data == null) {\n        return undefined;\n      }\n      return {\n        disallowedMarkings: query.data.disallowedMarkings.map(String),\n        impliedMarkings: query.data.impliedMarkings.map(String),\n        requiredMarkings: query.data.requiredMarkings.map(group =>\n          group.map(String)\n        ),\n        userSatisfiesMarkings: query.data.userSatisfiesMarkings,\n        isValid: query.data.isValid,\n      };\n    },\n    [query.data],\n  );\n\n  return {\n    restrictions,\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,8BAA8B,QAAQ,qBAAqB;AACpE,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,gBAAgB,QAAQ,oCAAoC;AACrE,SAASC,YAAY,QAAQ,uBAAuB;AAoCpD;AACA;AACA;AACA;AACA,OAAO,SAASC,0BAA0BA,CACxC;EAAEC,UAAU;EAAEC,OAAO,EAAEC,eAAe,GAAG;AACP,CAAC,EACD;EAClC,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,8BAA8B,CAACiB,GAAG,CAACT,MAAM,EAAE;MAChDH,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,YAAY,GAAGpB,KAAK,CAACU,OAAO,CAChC,MAA+C;IAC7C,IAAIQ,KAAK,CAACG,IAAI,IAAI,IAAI,EAAE;MACtB,OAAOC,SAAS;IAClB;IACA,OAAO;MACLC,kBAAkB,EAAEL,KAAK,CAACG,IAAI,CAACE,kBAAkB,CAACC,GAAG,CAACC,MAAM,CAAC;MAC7DC,eAAe,EAAER,KAAK,CAACG,IAAI,CAACK,eAAe,CAACF,GAAG,CAACC,MAAM,CAAC;MACvDE,gBAAgB,EAAET,KAAK,CAACG,IAAI,CAACM,gBAAgB,CAACH,GAAG,CAACI,KAAK,IACrDA,KAAK,CAACJ,GAAG,CAACC,MAAM,CAClB,CAAC;MACDI,qBAAqB,EAAEX,KAAK,CAACG,IAAI,CAACQ,qBAAqB;MACvDC,OAAO,EAAEZ,KAAK,CAACG,IAAI,CAACS;IACtB,CAAC;EACH,CAAC,EACD,CAACZ,KAAK,CAACG,IAAI,CACb,CAAC;EAED,OAAO;IACLD,YAAY;IACZW,SAAS,EAAEb,KAAK,CAACa,SAAS;IAC1BC,KAAK,EAAEd,KAAK,CAACc,KAAK;IAClBC,OAAO,EAAEf,KAAK,CAACe;EACjB,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,46 @@
+/*
+ * 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 { MarkingCategories } from "@osdk/foundry.admin";
+import React from "react";
+import { usePlatformQuery } from "../../../utils/usePlatformQuery.js";
+import { OsdkContext2 } from "../../OsdkContext2.js";
+/**
+ * List all marking categories.
+ * @param options Options to control the query.
+ */
+export function useMarkingCategories({
+  enabled = true
+} = {}) {
+  const {
+    client
+  } = React.useContext(OsdkContext2);
+  const handleQuery = React.useCallback(() => {
+    return MarkingCategories.list(client);
+  }, [client]);
+  const query = usePlatformQuery({
+    query: handleQuery,
+    enabled,
+    queryName: "marking-categories"
+  });
+  return {
+    categories: query.data?.data,
+    isLoading: query.isLoading,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+//# sourceMappingURL=useMarkingCategories.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkingCategories.js","names":["MarkingCategories","React","usePlatformQuery","OsdkContext2","useMarkingCategories","enabled","client","useContext","handleQuery","useCallback","list","query","queryName","categories","data","isLoading","error","refetch"],"sources":["useMarkingCategories.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 { MarkingCategory } from \"@osdk/foundry.admin\";\nimport { MarkingCategories } from \"@osdk/foundry.admin\";\nimport React from \"react\";\nimport { usePlatformQuery } from \"../../../utils/usePlatformQuery.js\";\nimport { OsdkContext2 } from \"../../OsdkContext2.js\";\n\nexport interface UseMarkingCategoriesOptions {\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 UseMarkingCategoriesResult {\n  categories: MarkingCategory[] | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  refetch: () => void;\n}\n\n/**\n * List all marking categories.\n * @param options Options to control the query.\n */\nexport function useMarkingCategories(\n  { enabled = true }: UseMarkingCategoriesOptions = {},\n): UseMarkingCategoriesResult {\n  const { client } = React.useContext(OsdkContext2);\n\n  const handleQuery = React.useCallback(() => {\n    return MarkingCategories.list(client);\n  }, [client]);\n\n  const query = usePlatformQuery({\n    query: handleQuery,\n    enabled,\n    queryName: \"marking-categories\",\n  });\n\n  return {\n    categories: query.data?.data,\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;;AAGA,SAASA,iBAAiB,QAAQ,qBAAqB;AACvD,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,gBAAgB,QAAQ,oCAAoC;AACrE,SAASC,YAAY,QAAQ,uBAAuB;AA2BpD;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAClC;EAAEC,OAAO,GAAG;AAAkC,CAAC,GAAG,CAAC,CAAC,EACxB;EAC5B,MAAM;IAAEC;EAAO,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;EAEjD,MAAMK,WAAW,GAAGP,KAAK,CAACQ,WAAW,CAAC,MAAM;IAC1C,OAAOT,iBAAiB,CAACU,IAAI,CAACJ,MAAM,CAAC;EACvC,CAAC,EAAE,CAACA,MAAM,CAAC,CAAC;EAEZ,MAAMK,KAAK,GAAGT,gBAAgB,CAAC;IAC7BS,KAAK,EAAEH,WAAW;IAClBH,OAAO;IACPO,SAAS,EAAE;EACb,CAAC,CAAC;EAEF,OAAO;IACLC,UAAU,EAAEF,KAAK,CAACG,IAAI,EAAEA,IAAI;IAC5BC,SAAS,EAAEJ,KAAK,CAACI,SAAS;IAC1BC,KAAK,EAAEL,KAAK,CAACK,KAAK;IAClBC,OAAO,EAAEN,KAAK,CAACM;EACjB,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,46 @@
+/*
+ * 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 { Markings } from "@osdk/foundry.admin";
+import React from "react";
+import { usePlatformQuery } from "../../../utils/usePlatformQuery.js";
+import { OsdkContext2 } from "../../OsdkContext2.js";
+/**
+ * List all markings.
+ * @param options Options to control the query.
+ */
+export function useMarkings({
+  enabled = true
+} = {}) {
+  const {
+    client
+  } = React.useContext(OsdkContext2);
+  const handleQuery = React.useCallback(() => {
+    return Markings.list(client);
+  }, [client]);
+  const query = usePlatformQuery({
+    query: handleQuery,
+    enabled,
+    queryName: "markings"
+  });
+  return {
+    markings: query.data?.data,
+    isLoading: query.isLoading,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+//# sourceMappingURL=useMarkings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMarkings.js","names":["Markings","React","usePlatformQuery","OsdkContext2","useMarkings","enabled","client","useContext","handleQuery","useCallback","list","query","queryName","markings","data","isLoading","error","refetch"],"sources":["useMarkings.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 { Marking } from \"@osdk/foundry.admin\";\nimport { Markings } from \"@osdk/foundry.admin\";\nimport React from \"react\";\nimport { usePlatformQuery } from \"../../../utils/usePlatformQuery.js\";\nimport { OsdkContext2 } from \"../../OsdkContext2.js\";\n\nexport interface UseMarkingsOptions {\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 UseMarkingsResult {\n  markings: Marking[] | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  refetch: () => void;\n}\n\n/**\n * List all markings.\n * @param options Options to control the query.\n */\nexport function useMarkings(\n  { enabled = true }: UseMarkingsOptions = {},\n): UseMarkingsResult {\n  const { client } = React.useContext(OsdkContext2);\n\n  const handleQuery = React.useCallback(() => {\n    return Markings.list(client);\n  }, [client]);\n\n  const query = usePlatformQuery({\n    query: handleQuery,\n    enabled,\n    queryName: \"markings\",\n  });\n\n  return {\n    markings: query.data?.data,\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;;AAGA,SAASA,QAAQ,QAAQ,qBAAqB;AAC9C,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,gBAAgB,QAAQ,oCAAoC;AACrE,SAASC,YAAY,QAAQ,uBAAuB;AA2BpD;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CACzB;EAAEC,OAAO,GAAG;AAAyB,CAAC,GAAG,CAAC,CAAC,EACxB;EACnB,MAAM;IAAEC;EAAO,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;EAEjD,MAAMK,WAAW,GAAGP,KAAK,CAACQ,WAAW,CAAC,MAAM;IAC1C,OAAOT,QAAQ,CAACU,IAAI,CAACJ,MAAM,CAAC;EAC9B,CAAC,EAAE,CAACA,MAAM,CAAC,CAAC;EAEZ,MAAMK,KAAK,GAAGT,gBAAgB,CAAC;IAC7BS,KAAK,EAAEH,WAAW;IAClBH,OAAO;IACPO,SAAS,EAAE;EACb,CAAC,CAAC;EAEF,OAAO;IACLC,QAAQ,EAAEF,KAAK,CAACG,IAAI,EAAEA,IAAI;IAC1BC,SAAS,EAAEJ,KAAK,CAACI,SAAS;IAC1BC,KAAK,EAAEL,KAAK,CAACK,KAAK;IAClBC,OAAO,EAAEN,KAAK,CAACM;EACjB,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,50 @@
+/*
+ * 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 { Users } from "@osdk/foundry.admin";
+import React from "react";
+import { usePlatformQuery } from "../../../utils/usePlatformQuery.js";
+import { OsdkContext2 } from "../../OsdkContext2.js";
+/**
+ * Get view-accessible markings for a user.
+ * When `userId` is provided, fetches markings for that user.
+ * When omitted, fetches markings for the current user.
+ * @param options Options to control the query.
+ */
+export function useUserViewMarkings({
+  userId,
+  enabled = true
+} = {}) {
+  const {
+    client
+  } = React.useContext(OsdkContext2);
+  const handleQuery = React.useCallback(async () => {
+    const resolvedUserId = userId ?? (await Users.getCurrent(client)).id;
+    return Users.getMarkings(client, resolvedUserId);
+  }, [client, userId]);
+  const query = usePlatformQuery({
+    query: handleQuery,
+    enabled,
+    queryName: "user-view-markings"
+  });
+  return {
+    markingIds: query.data?.view,
+    isLoading: query.isLoading,
+    error: query.error,
+    refetch: query.refetch
+  };
+}
+//# sourceMappingURL=useUserMarkings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUserMarkings.js","names":["Users","React","usePlatformQuery","OsdkContext2","useUserViewMarkings","userId","enabled","client","useContext","handleQuery","useCallback","resolvedUserId","getCurrent","id","getMarkings","query","queryName","markingIds","data","view","isLoading","error","refetch"],"sources":["useUserMarkings.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 { Users } from \"@osdk/foundry.admin\";\nimport React from \"react\";\nimport { usePlatformQuery } from \"../../../utils/usePlatformQuery.js\";\nimport { OsdkContext2 } from \"../../OsdkContext2.js\";\n\nexport interface UseUserViewMarkingsOptions {\n  /**\n   * The user ID to fetch view markings for.\n   * When omitted, fetches markings for the current user.\n   */\n  userId?: 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 UseUserViewMarkingsResult {\n  markingIds: string[] | undefined;\n  isLoading: boolean;\n\n  error: Error | undefined;\n\n  refetch: () => void;\n}\n\n/**\n * Get view-accessible markings for a user.\n * When `userId` is provided, fetches markings for that user.\n * When omitted, fetches markings for the current user.\n * @param options Options to control the query.\n */\nexport function useUserViewMarkings(\n  { userId, enabled = true }: UseUserViewMarkingsOptions = {},\n): UseUserViewMarkingsResult {\n  const { client } = React.useContext(OsdkContext2);\n\n  const handleQuery = React.useCallback(async () => {\n    const resolvedUserId = userId\n      ?? (await Users.getCurrent(client)).id;\n    return Users.getMarkings(client, resolvedUserId);\n  }, [client, userId]);\n\n  const query = usePlatformQuery({\n    query: handleQuery,\n    enabled,\n    queryName: \"user-view-markings\",\n  });\n\n  return {\n    markingIds: query.data?.view,\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,KAAK,QAAQ,qBAAqB;AAC3C,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,gBAAgB,QAAQ,oCAAoC;AACrE,SAASC,YAAY,QAAQ,uBAAuB;AAgCpD;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CACjC;EAAEC,MAAM;EAAEC,OAAO,GAAG;AAAiC,CAAC,GAAG,CAAC,CAAC,EAChC;EAC3B,MAAM;IAAEC;EAAO,CAAC,GAAGN,KAAK,CAACO,UAAU,CAACL,YAAY,CAAC;EAEjD,MAAMM,WAAW,GAAGR,KAAK,CAACS,WAAW,CAAC,YAAY;IAChD,MAAMC,cAAc,GAAGN,MAAM,IACxB,CAAC,MAAML,KAAK,CAACY,UAAU,CAACL,MAAM,CAAC,EAAEM,EAAE;IACxC,OAAOb,KAAK,CAACc,WAAW,CAACP,MAAM,EAAEI,cAAc,CAAC;EAClD,CAAC,EAAE,CAACJ,MAAM,EAAEF,MAAM,CAAC,CAAC;EAEpB,MAAMU,KAAK,GAAGb,gBAAgB,CAAC;IAC7Ba,KAAK,EAAEN,WAAW;IAClBH,OAAO;IACPU,SAAS,EAAE;EACb,CAAC,CAAC;EAEF,OAAO;IACLC,UAAU,EAAEF,KAAK,CAACG,IAAI,EAAEC,IAAI;IAC5BC,SAAS,EAAEL,KAAK,CAACK,SAAS;IAC1BC,KAAK,EAAEN,KAAK,CAACM,KAAK;IAClBC,OAAO,EAAEP,KAAK,CAACO;EACjB,CAAC;AACH","ignoreList":[]}

package/build/esm/new/useLinks.js

@@ -15,6 +15,7 @@
  */
 
 import React from "react";
+import { extractPayloadError, isPayloadLoading } from "./hookUtils.js";
 import { makeExternalStore } from "./makeExternalStore.js";
 import { OsdkContext2 } from "./OsdkContext2.js";
 const emptyArray = Object.freeze([]);
@@ -36,9 +37,11 @@ export function useLinks(objects, linkName, options = {}) {
     enabled = true,
     ...otherOptions
   } = options;
-  const stableWhere = React.useMemo(() => otherOptions.where, [JSON.stringify(otherOptions.where)]);
-  const stableOrderBy = React.useMemo(() => otherOptions.orderBy, [JSON.stringify(otherOptions.orderBy)]);
-  const stableSelect = React.useMemo(() => otherOptions.$select, [JSON.stringify(otherOptions.$select)]);
+  const canonOptions = observableClient.canonicalizeOptions({
+    where: otherOptions.where,
+    orderBy: otherOptions.orderBy,
+    $select: otherOptions.$select
+  });
   const objectsKey = React.useMemo(() => {
     if (objects === undefined) return "";
     const arr = Array.isArray(objects) ? objects : [objects];
@@ -60,23 +63,23 @@ export function useLinks(objects, linkName, options = {}) {
     }
     return makeExternalStore(observer => observableClient.observeLinks(objectsArray, linkName, {
       linkName,
-      where: stableWhere,
+      where: canonOptions.where,
       pageSize: otherOptions.pageSize,
-      orderBy: stableOrderBy,
+      orderBy: canonOptions.orderBy,
       mode: otherOptions.mode,
       dedupeInterval: otherOptions.dedupeIntervalMs ?? 2_000,
-      ...(stableSelect ? {
-        select: stableSelect
+      ...(canonOptions.$select ? {
+        select: canonOptions.$select
       } : {})
     }, observer), `links ${linkName} for ${objectsKey}`);
-  }, [enabled, observableClient, objectsArray, objectsKey, linkName, stableWhere, otherOptions.pageSize, stableOrderBy, otherOptions.mode, otherOptions.dedupeIntervalMs, stableSelect]);
+  }, [enabled, observableClient, objectsArray, objectsKey, linkName, canonOptions.where, otherOptions.pageSize, canonOptions.orderBy, otherOptions.mode, otherOptions.dedupeIntervalMs, canonOptions.$select]);
   const payload = React.useSyncExternalStore(subscribe, getSnapShot);
   return React.useMemo(() => ({
     links: payload?.resolvedList,
     linkedObjectsBySourcePrimaryKey: payload?.linkedObjectsBySourcePrimaryKey ?? emptyMap,
-    isLoading: enabled ? payload?.status === "loading" || payload?.status === "init" || !payload : false,
+    isLoading: isPayloadLoading(payload, enabled),
     isOptimistic: payload?.isOptimistic ?? false,
-    error: payload?.error,
+    error: extractPayloadError(payload, "Failed to load links"),
     fetchMore: payload?.hasMore ? payload?.fetchMore : undefined,
     hasMore: payload?.hasMore ?? false
   }), [payload, enabled]);