@osdk/react 0.6.0-beta.3 → 0.7.0-beta.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @osdkkit/react
 
+## 0.7.0-beta.2
+
+### Minor Changes
+
+- 2348ddc: Make useOsdkAction validate less restrictive
+
+### Patch Changes
+
+- Updated dependencies [b05075d]
+- Updated dependencies [7160276]
+- Updated dependencies [7cdab1d]
+- Updated dependencies [b9e9a88]
+- Updated dependencies [76905f5]
+- Updated dependencies [48d52b7]
+  - @osdk/client@2.5.0-beta.2
+  - @osdk/api@2.5.0-beta.2
+
 ## 0.6.0-beta.3
 
 ### Minor Changes

package/build/browser/index.js

@@ -20,4 +20,5 @@
 
 export { OsdkProvider } from "./OsdkProvider.js";
 export { useOsdkClient } from "./useOsdkClient.js";
+export { useOsdkMetadata } from "./useOsdkMetadata.js";
 //# sourceMappingURL=index.js.map

package/build/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["OsdkProvider","useOsdkClient"],"sources":["index.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\n/**\n * @module @osdk/react\n */\n\nexport { OsdkProvider } from \"./OsdkProvider.js\";\nexport { useOsdkClient } from \"./useOsdkClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA,SAASA,YAAY,QAAQ,mBAAmB;AAChD,SAASC,aAAa,QAAQ,oBAAoB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["OsdkProvider","useOsdkClient","useOsdkMetadata"],"sources":["index.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\n/**\n * @module @osdk/react\n */\n\nexport { OsdkProvider } from \"./OsdkProvider.js\";\nexport { useOsdkClient } from \"./useOsdkClient.js\";\nexport { useOsdkMetadata } from \"./useOsdkMetadata.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA,SAASA,YAAY,QAAQ,mBAAmB;AAChD,SAASC,aAAa,QAAQ,oBAAoB;AAClD,SAASC,eAAe,QAAQ,sBAAsB","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"makeExternalStore.js","names":["makeExternalStore","createObservation","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\n  | (Partial<X> & { error: Error })\n  | undefined;\n\nexport function makeExternalStore<X>(\n  createObservation: (callback: Observer<X | undefined>) => Unsubscribable,\n  name?: string,\n): {\n  subscribe: (notifyUpdate: () => void) => () => void;\n  getSnapShot: () => Snapshot<X>;\n} {\n  let lastResult: Snapshot<X>;\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;\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,EAKxE;EACA,IAAIC,UAAuB;EAE3B,SAASC,WAAWA,CAAA,EAAgB;IAClC,OAAOD,UAAU;EACnB;EAuBA,OAAO;IACLE,SAAS,EAtBX,SAASA,SAASA,CAACC,YAAwB,EAAE;MAC3C,MAAMC,GAAG,GAAGL,iBAAiB,CAAC;QAC5BM,IAAI,EAAGC,OAAO,IAAK;UACjBN,UAAU,GAAGM,OAAO;UACpBH,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","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): {\n  subscribe: (notifyUpdate: () => void) => () => void;\n  getSnapShot: () => Snapshot<X>;\n} {\n  let lastResult: Snapshot<X>;\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,EAKxE;EACA,IAAIC,UAAuB;EAE3B,SAASC,WAAWA,CAAA,EAAgB;IAClC,OAAOD,UAAU;EACnB;EAuBA,OAAO;IACLE,SAAS,EAtBX,SAASA,SAASA,CAACC,YAAwB,EAAE;MAC3C,MAAMC,GAAG,GAAGL,iBAAiB,CAAC;QAC5BM,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":[]}

package/build/browser/new/useLinks.js

@@ -0,0 +1,61 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+import { makeExternalStore } from "./makeExternalStore.js";
+import { OsdkContext2 } from "./OsdkContext2.js";
+const emptyArray = Object.freeze([]);
+
+/**
+ * Hook to observe links from an object or array of objects.
+ *
+ * @param objects The source object(s) to observe links from
+ * @param linkName The name of the link to observe
+ * @param options Optional configuration for the link query
+ * @returns UseLinksResult with links data and metadata
+ */
+export function useLinks(objects, linkName, options = {}) {
+  const {
+    observableClient
+  } = React.useContext(OsdkContext2);
+
+  // Convert single object to array for consistent handling
+  const objectsArray = React.useMemo(() => {
+    return objects === undefined ? emptyArray : Array.isArray(objects) ? objects : [objects];
+  }, [objects]);
+  const {
+    subscribe,
+    getSnapShot
+  } = React.useMemo(() => {
+    return makeExternalStore(observer => observableClient.observeLinks(objectsArray, linkName, {
+      linkName,
+      where: options.where,
+      pageSize: options.pageSize,
+      orderBy: options.orderBy,
+      mode: options.mode
+    }, observer), `links ${linkName} for ${objectsArray.map(obj => `${obj.$apiName}:${obj.$primaryKey}`).join(",")}`);
+  }, [observableClient, objectsArray, linkName, options.where, options.pageSize, options.orderBy, options.mode]);
+  const payload = React.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    links: payload?.resolvedList,
+    isLoading: payload?.status === "loading",
+    isOptimistic: payload?.isOptimistic ?? false,
+    error: payload?.error,
+    fetchMore: payload?.fetchMore,
+    hasMore: payload?.hasMore ?? false
+  };
+}
+//# sourceMappingURL=useLinks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLinks.js","names":["React","makeExternalStore","OsdkContext2","emptyArray","Object","freeze","useLinks","objects","linkName","options","observableClient","useContext","objectsArray","useMemo","undefined","Array","isArray","subscribe","getSnapShot","observer","observeLinks","where","pageSize","orderBy","mode","map","obj","$apiName","$primaryKey","join","payload","useSyncExternalStore","links","resolvedList","isLoading","status","isOptimistic","error","fetchMore","hasMore"],"sources":["useLinks.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 { LinkedType, LinkNames } from \"@osdk/api\";\nimport type {\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/client\";\nimport type { ObserveLinks } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseLinksOptions<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  /**\n   * Standard OSDK Where clause for filtering linked objects\n   */\n  where?: WhereClause<T>;\n\n  /**\n   * The preferred page size for the links list.\n   */\n  pageSize?: number;\n\n  /** Sorting options for the linked objects */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * The mode to use for fetching data.\n   * - undefined: Fetch data if not already in cache\n   * - \"force\": Always fetch fresh data\n   * - \"offline\": Only use cached data, don't make network requests\n   */\n  mode?: \"force\" | \"offline\";\n}\n\nexport interface UseLinksResult<\n  Q extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  links: Osdk.Instance<Q>[] | undefined;\n  isLoading: boolean;\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the links are optimistic or not.\n   */\n  isOptimistic: boolean;\n\n  /**\n   * Fetch more linked objects if pagination is supported\n   */\n  fetchMore: (() => Promise<unknown>) | undefined;\n\n  /**\n   * Indicates if there are more linked objects available to fetch\n   */\n  hasMore: boolean;\n}\n\nconst emptyArray = Object.freeze([]);\n\n/**\n * Hook to observe links from an object or array of objects.\n *\n * @param objects The source object(s) to observe links from\n * @param linkName The name of the link to observe\n * @param options Optional configuration for the link query\n * @returns UseLinksResult with links data and metadata\n */\nexport function useLinks<\n  T extends ObjectTypeDefinition,\n  L extends LinkNames<T>,\n>(\n  objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined,\n  linkName: L,\n  options: UseLinksOptions<LinkedType<T, L>> = {},\n): UseLinksResult<LinkedType<T, L>> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // Convert single object to array for consistent handling\n  const objectsArray: ReadonlyArray<Osdk.Instance<T>> = React.useMemo(() => {\n    return objects === undefined\n      ? emptyArray\n      : Array.isArray(objects)\n      ? objects\n      : [objects];\n  }, [objects]);\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      return makeExternalStore<ObserveLinks.CallbackArgs<T>>(\n        (observer) =>\n          observableClient.observeLinks(\n            objectsArray,\n            linkName,\n            {\n              linkName,\n              where: options.where,\n              pageSize: options.pageSize,\n              orderBy: options.orderBy,\n              mode: options.mode,\n            },\n            observer,\n          ),\n        `links ${linkName} for ${\n          objectsArray.map(obj => `${obj.$apiName}:${obj.$primaryKey}`).join(\n            \",\",\n          )\n        }`,\n      );\n    },\n    [\n      observableClient,\n      objectsArray,\n      linkName,\n      options.where,\n      options.pageSize,\n      options.orderBy,\n      options.mode,\n    ],\n  );\n\n  const payload = React.useSyncExternalStore(\n    subscribe,\n    getSnapShot,\n  );\n\n  return {\n    links: payload?.resolvedList,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    error: payload?.error,\n    fetchMore: payload?.fetchMore,\n    hasMore: payload?.hasMore ?? false,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAoDhD,MAAMC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAAC,EAAE,CAAC;;AAEpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAItBC,OAA+D,EAC/DC,QAAW,EACXC,OAA0C,GAAG,CAAC,CAAC,EACb;EAClC,MAAM;IAAEC;EAAiB,CAAC,GAAGV,KAAK,CAACW,UAAU,CAACT,YAAY,CAAC;;EAE3D;EACA,MAAMU,YAA6C,GAAGZ,KAAK,CAACa,OAAO,CAAC,MAAM;IACxE,OAAON,OAAO,KAAKO,SAAS,GACxBX,UAAU,GACVY,KAAK,CAACC,OAAO,CAACT,OAAO,CAAC,GACtBA,OAAO,GACP,CAACA,OAAO,CAAC;EACf,CAAC,EAAE,CAACA,OAAO,CAAC,CAAC;EAEb,MAAM;IAAEU,SAAS;IAAEC;EAAY,CAAC,GAAGlB,KAAK,CAACa,OAAO,CAC9C,MAAM;IACJ,OAAOZ,iBAAiB,CACrBkB,QAAQ,IACPT,gBAAgB,CAACU,YAAY,CAC3BR,YAAY,EACZJ,QAAQ,EACR;MACEA,QAAQ;MACRa,KAAK,EAAEZ,OAAO,CAACY,KAAK;MACpBC,QAAQ,EAAEb,OAAO,CAACa,QAAQ;MAC1BC,OAAO,EAAEd,OAAO,CAACc,OAAO;MACxBC,IAAI,EAAEf,OAAO,CAACe;IAChB,CAAC,EACDL,QACF,CAAC,EACH,SAASX,QAAQ,QACfI,YAAY,CAACa,GAAG,CAACC,GAAG,IAAI,GAAGA,GAAG,CAACC,QAAQ,IAAID,GAAG,CAACE,WAAW,EAAE,CAAC,CAACC,IAAI,CAChE,GACF,CAAC,EAEL,CAAC;EACH,CAAC,EACD,CACEnB,gBAAgB,EAChBE,YAAY,EACZJ,QAAQ,EACRC,OAAO,CAACY,KAAK,EACbZ,OAAO,CAACa,QAAQ,EAChBb,OAAO,CAACc,OAAO,EACfd,OAAO,CAACe,IAAI,CAEhB,CAAC;EAED,MAAMM,OAAO,GAAG9B,KAAK,CAAC+B,oBAAoB,CACxCd,SAAS,EACTC,WACF,CAAC;EAED,OAAO;IACLc,KAAK,EAAEF,OAAO,EAAEG,YAAY;IAC5BC,SAAS,EAAEJ,OAAO,EAAEK,MAAM,KAAK,SAAS;IACxCC,YAAY,EAAEN,OAAO,EAAEM,YAAY,IAAI,KAAK;IAC5CC,KAAK,EAAEP,OAAO,EAAEO,KAAK;IACrBC,SAAS,EAAER,OAAO,EAAEQ,SAAS;IAC7BC,OAAO,EAAET,OAAO,EAAES,OAAO,IAAI;EAC/B,CAAC;AACH","ignoreList":[]}

package/build/browser/new/useOsdkAction.js

@@ -86,7 +86,7 @@ export function useOsdkAction(actionDef) {
     try {
       // Check if action is being applied
       if (isPending) {
-        throw new Error("Cannot validate while action is pending");
+        return undefined;
       }
 
       // Abort any existing validation

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","observableClient","useContext","error","setError","useState","data","setData","isPending","setPending","isValidating","setValidating","validationResult","setValidationResult","abortControllerRef","useRef","applyAction","useCallback","hookArgs","current","abort","undefined","Array","isArray","updates","args","map","a","$optimisticUpdate","push","r","optimisticUpdate","ctx","update","e","actionValidation","unknown","validateAction","Error","abortController","AbortController","result","signal","aborted","name","useEffect"],"sources":["useOsdkAction.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 { ActionDefinition, ActionValidationResponse } from \"@osdk/client\";\nimport { ActionValidationError } from \"@osdk/client\";\nimport type {\n  ActionSignatureFromDef,\n  ObservableClient,\n} from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ntype ApplyActionParams<Q extends ActionDefinition<any>> =\n  & Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n  & {\n    [K in keyof ObservableClient.ApplyActionOptions as `$${K}`]:\n      ObservableClient.ApplyActionOptions[K];\n  };\n\nexport interface UseOsdkActionResult<Q extends ActionDefinition<any>> {\n  applyAction: (\n    args: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>,\n  ) => Promise<unknown>;\n\n  error:\n    | undefined\n    | Partial<{\n      actionValidation: ActionValidationError;\n      unknown: unknown;\n    }>;\n  data: unknown;\n\n  isPending: boolean;\n  isValidating: boolean;\n\n  /**\n   * Validates the action with the provided arguments without executing it.\n   * Calling this function again before the previous validation finishes will cancel\n   * the first validation and start a new one.\n   * @param args The action arguments to validate\n   * @returns A promise that resolves to the validation response, or undefined if aborted\n   */\n  validateAction: (\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse | undefined>;\n\n  validationResult?: ActionValidationResponse;\n}\n\nexport function useOsdkAction<Q extends ActionDefinition<any>>(\n  actionDef: Q,\n): UseOsdkActionResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n  const [error, setError] = React.useState<UseOsdkActionResult<Q>[\"error\"]>();\n  const [data, setData] = React.useState<unknown>();\n  const [isPending, setPending] = React.useState(false);\n  const [isValidating, setValidating] = React.useState(false);\n  const [validationResult, setValidationResult] = React.useState<\n    ActionValidationResponse | undefined\n  >();\n  const abortControllerRef = React.useRef<AbortController | null>(null);\n\n  const applyAction = React.useCallback(async function applyAction(\n    hookArgs: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>,\n  ) {\n    try {\n      // If validation is in progress, abort it\n      if (isValidating && abortControllerRef.current) {\n        abortControllerRef.current.abort();\n        setValidating(false);\n      }\n\n      setPending(true);\n      setError(undefined);\n\n      if (Array.isArray(hookArgs)) {\n        const updates: Array<\n          ObservableClient.ApplyActionOptions[\"optimisticUpdate\"]\n        > = [];\n        const args = hookArgs.map(a => {\n          const { $optimisticUpdate, ...args } = a;\n          if ($optimisticUpdate) {\n            updates.push($optimisticUpdate);\n          }\n          return args;\n        });\n\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: (ctx) => {\n            for (const update of updates) {\n              update?.(ctx);\n            }\n          },\n        });\n        setData(r);\n        return r;\n      } else {\n        const { $optimisticUpdate, ...args } = hookArgs;\n\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: $optimisticUpdate,\n        });\n        setData(r);\n        return r;\n      }\n    } catch (e) {\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e,\n        });\n      } else {\n        setError({ unknown: e });\n      }\n    } finally {\n      setPending(false);\n    }\n  }, [observableClient, actionDef, isValidating]);\n\n  const validateAction = React.useCallback(async function validateAction(\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ): Promise<ActionValidationResponse | undefined> {\n    try {\n      // Check if action is being applied\n      if (isPending) {\n        throw new Error(\"Cannot validate while action is pending\");\n      }\n\n      // Abort any existing validation\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n\n      // Create new AbortController\n      const abortController = new AbortController();\n      abortControllerRef.current = abortController;\n\n      setValidating(true);\n      setError(undefined);\n\n      const result = await observableClient.validateAction(actionDef, args);\n\n      // Check if aborted\n      if (abortController.signal.aborted) {\n        return undefined;\n      }\n\n      setValidationResult(result);\n      return result;\n    } catch (e) {\n      // Check if it was aborted\n      if (e instanceof Error && e.name === \"AbortError\") {\n        return undefined;\n      }\n\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e,\n        });\n      } else {\n        setError({ unknown: e });\n      }\n      throw e;\n    } finally {\n      setValidating(false);\n    }\n  }, [observableClient, actionDef, isPending]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n    };\n  }, []);\n\n  return {\n    applyAction,\n    validateAction,\n    error,\n    data,\n    isPending,\n    isValidating,\n    validationResult,\n  };\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","observableClient","useContext","error","setError","useState","data","setData","isPending","setPending","isValidating","setValidating","validationResult","setValidationResult","abortControllerRef","useRef","applyAction","useCallback","hookArgs","current","abort","undefined","Array","isArray","updates","args","map","a","$optimisticUpdate","push","r","optimisticUpdate","ctx","update","e","actionValidation","unknown","validateAction","abortController","AbortController","result","signal","aborted","Error","name","useEffect"],"sources":["useOsdkAction.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 { ActionDefinition, ActionValidationResponse } from \"@osdk/client\";\nimport { ActionValidationError } from \"@osdk/client\";\nimport type {\n  ActionSignatureFromDef,\n  ObservableClient,\n} from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ntype ApplyActionParams<Q extends ActionDefinition<any>> =\n  & Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n  & {\n    [K in keyof ObservableClient.ApplyActionOptions as `$${K}`]:\n      ObservableClient.ApplyActionOptions[K];\n  };\n\nexport interface UseOsdkActionResult<Q extends ActionDefinition<any>> {\n  applyAction: (\n    args: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>,\n  ) => Promise<unknown>;\n\n  error:\n    | undefined\n    | Partial<{\n      actionValidation: ActionValidationError;\n      unknown: unknown;\n    }>;\n  data: unknown;\n\n  isPending: boolean;\n  isValidating: boolean;\n\n  /**\n   * Validates the action with the provided arguments without executing it.\n   * Calling this function again before the previous validation finishes will cancel\n   * the first validation and start a new one.\n   * @param args The action arguments to validate\n   * @returns A promise that resolves to the validation response, or undefined if aborted\n   */\n  validateAction: (\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse | undefined>;\n\n  validationResult?: ActionValidationResponse;\n}\n\nexport function useOsdkAction<Q extends ActionDefinition<any>>(\n  actionDef: Q,\n): UseOsdkActionResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n  const [error, setError] = React.useState<UseOsdkActionResult<Q>[\"error\"]>();\n  const [data, setData] = React.useState<unknown>();\n  const [isPending, setPending] = React.useState(false);\n  const [isValidating, setValidating] = React.useState(false);\n  const [validationResult, setValidationResult] = React.useState<\n    ActionValidationResponse | undefined\n  >();\n  const abortControllerRef = React.useRef<AbortController | null>(null);\n\n  const applyAction = React.useCallback(async function applyAction(\n    hookArgs: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>,\n  ) {\n    try {\n      // If validation is in progress, abort it\n      if (isValidating && abortControllerRef.current) {\n        abortControllerRef.current.abort();\n        setValidating(false);\n      }\n\n      setPending(true);\n      setError(undefined);\n\n      if (Array.isArray(hookArgs)) {\n        const updates: Array<\n          ObservableClient.ApplyActionOptions[\"optimisticUpdate\"]\n        > = [];\n        const args = hookArgs.map(a => {\n          const { $optimisticUpdate, ...args } = a;\n          if ($optimisticUpdate) {\n            updates.push($optimisticUpdate);\n          }\n          return args;\n        });\n\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: (ctx) => {\n            for (const update of updates) {\n              update?.(ctx);\n            }\n          },\n        });\n        setData(r);\n        return r;\n      } else {\n        const { $optimisticUpdate, ...args } = hookArgs;\n\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: $optimisticUpdate,\n        });\n        setData(r);\n        return r;\n      }\n    } catch (e) {\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e,\n        });\n      } else {\n        setError({ unknown: e });\n      }\n    } finally {\n      setPending(false);\n    }\n  }, [observableClient, actionDef, isValidating]);\n\n  const validateAction = React.useCallback(async function validateAction(\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ): Promise<ActionValidationResponse | undefined> {\n    try {\n      // Check if action is being applied\n      if (isPending) {\n        return undefined;\n      }\n\n      // Abort any existing validation\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n\n      // Create new AbortController\n      const abortController = new AbortController();\n      abortControllerRef.current = abortController;\n\n      setValidating(true);\n      setError(undefined);\n\n      const result = await observableClient.validateAction(actionDef, args);\n\n      // Check if aborted\n      if (abortController.signal.aborted) {\n        return undefined;\n      }\n\n      setValidationResult(result);\n      return result;\n    } catch (e) {\n      // Check if it was aborted\n      if (e instanceof Error && e.name === \"AbortError\") {\n        return undefined;\n      }\n\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e,\n        });\n      } else {\n        setError({ unknown: e });\n      }\n      throw e;\n    } finally {\n      setValidating(false);\n    }\n  }, [observableClient, actionDef, isPending]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n    };\n  }, []);\n\n  return {\n    applyAction,\n    validateAction,\n    error,\n    data,\n    isPending,\n    isValidating,\n    validationResult,\n  };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/browser/public/experimental.js

@@ -15,6 +15,7 @@
  */
 
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
+export { useLinks } from "../new/useLinks.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
 export { useOsdkObjects } from "../new/useOsdkObjects.js";

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

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["OsdkProvider2","useOsdkAction","useOsdkObject","useOsdkObjects","useOsdkClient"],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { OsdkProvider2 } from \"../new/OsdkProvider2.js\";\nexport { useOsdkAction } from \"../new/useOsdkAction.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport { useOsdkObjects } from \"../new/useOsdkObjects.js\";\nexport { useOsdkClient } from \"../useOsdkClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB","ignoreList":[]}
+{"version":3,"file":"experimental.js","names":["OsdkProvider2","useLinks","useOsdkAction","useOsdkObject","useOsdkObjects","useOsdkClient"],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { OsdkProvider2 } from \"../new/OsdkProvider2.js\";\nexport { useLinks } from \"../new/useLinks.js\";\nexport { useOsdkAction } from \"../new/useOsdkAction.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport type { UseOsdkListResult } from \"../new/useOsdkObjects.js\";\nexport { useOsdkObjects } from \"../new/useOsdkObjects.js\";\nexport { useOsdkClient } from \"../useOsdkClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,yBAAyB;AACvD,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AAEvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB","ignoreList":[]}

package/build/cjs/index.cjs

@@ -17,11 +17,30 @@ function OsdkProvider({
     }
   }, children);
 }
+function useOsdkMetadata(type) {
+  const client = chunk2N32USW5_cjs.useOsdkClient();
+  const [metadata, setMetadata] = React__default.default.useState(void 0);
+  if (!metadata) {
+    client.fetchMetadata(type).then((fetchedMetadata) => {
+      setMetadata(fetchedMetadata);
+    }).catch((error) => {
+      console.error("Failed to fetch metadata", error);
+    });
+    return {
+      loading: true
+    };
+  }
+  return {
+    loading: false,
+    metadata
+  };
+}
 
 Object.defineProperty(exports, "useOsdkClient", {
   enumerable: true,
   get: function () { return chunk2N32USW5_cjs.useOsdkClient; }
 });
 exports.OsdkProvider = OsdkProvider;
+exports.useOsdkMetadata = useOsdkMetadata;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/build/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/OsdkProvider.tsx"],"names":["React","OsdkContext"],"mappings":";;;;;;;;;AAkBO,SAAS,YAAa,CAAA;AAAA,EAC3B,QAAA;AAAA,EACA;AACF,CAAG,EAAA;AACD,EAAoB,uBAAAA,sBAAA,CAAM,aAAc,CAAAC,6BAAA,CAAY,QAAU,EAAA;AAAA,IAC5D,KAAO,EAAA;AAAA,MACL;AAAA;AACF,KACC,QAAQ,CAAA;AACb","file":"index.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { OsdkContext } from \"./OsdkContext.js\";\nexport function OsdkProvider({\n  children,\n  client\n}) {\n  return /*#__PURE__*/React.createElement(OsdkContext.Provider, {\n    value: {\n      client\n    }\n  }, children);\n}"]}
+{"version":3,"sources":["../../src/OsdkProvider.tsx","../../src/useOsdkMetadata.ts"],"names":["React","OsdkContext","useOsdkClient"],"mappings":";;;;;;;;;AAkBO,SAAS,YAAa,CAAA;AAAA,EAC3B,QAAA;AAAA,EACA;AACF,CAAG,EAAA;AACD,EAAoB,uBAAAA,sBAAA,CAAM,aAAc,CAAAC,6BAAA,CAAY,QAAU,EAAA;AAAA,IAC5D,KAAO,EAAA;AAAA,MACL;AAAA;AACF,KACC,QAAQ,CAAA;AACb;ACTO,SAAS,gBAAgB,IAAM,EAAA;AACpC,EAAA,MAAM,SAASC,+BAAc,EAAA;AAC7B,EAAA,MAAM,CAAC,QAAU,EAAA,WAAW,CAAIF,GAAAA,sBAAAA,CAAM,SAAS,MAAS,CAAA;AACxD,EAAA,IAAI,CAAC,QAAU,EAAA;AACb,IAAA,MAAA,CAAO,aAAc,CAAA,IAAI,CAAE,CAAA,IAAA,CAAK,CAAmB,eAAA,KAAA;AACjD,MAAA,WAAA,CAAY,eAAe,CAAA;AAAA,KAC5B,CAAE,CAAA,KAAA,CAAM,CAAS,KAAA,KAAA;AAEhB,MAAQ,OAAA,CAAA,KAAA,CAAM,4BAA4B,KAAK,CAAA;AAAA,KAChD,CAAA;AACD,IAAO,OAAA;AAAA,MACL,OAAS,EAAA;AAAA,KACX;AAAA;AAEF,EAAO,OAAA;AAAA,IACL,OAAS,EAAA,KAAA;AAAA,IACT;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { OsdkContext } from \"./OsdkContext.js\";\nexport function OsdkProvider({\n  children,\n  client\n}) {\n  return /*#__PURE__*/React.createElement(OsdkContext.Provider, {\n    value: {\n      client\n    }\n  }, children);\n}","/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { useOsdkClient } from \"./useOsdkClient.js\";\nexport function useOsdkMetadata(type) {\n  const client = useOsdkClient();\n  const [metadata, setMetadata] = React.useState(undefined);\n  if (!metadata) {\n    client.fetchMetadata(type).then(fetchedMetadata => {\n      setMetadata(fetchedMetadata);\n    }).catch(error => {\n      // eslint-disable-next-line no-console\n      console.error(\"Failed to fetch metadata\", error);\n    });\n    return {\n      loading: true\n    };\n  }\n  return {\n    loading: false,\n    metadata\n  };\n}"]}

package/build/cjs/index.d.cts

@@ -1,10 +1,17 @@
 import { Client } from '@osdk/client';
 import React from 'react';
 export { u as useOsdkClient } from './useOsdkClient-B4iwHO1H.cjs';
+import { ObjectOrInterfaceDefinition, InterfaceDefinition, InterfaceMetadata, ObjectTypeDefinition, ObjectMetadata } from '@osdk/api';
 
 declare function OsdkProvider({ children, client, }: {
     children: React.ReactNode;
     client: Client;
 }): React.JSX.Element;
 
-export { OsdkProvider };
+type MetadataFor<T extends ObjectOrInterfaceDefinition> = T extends InterfaceDefinition ? InterfaceMetadata : T extends ObjectTypeDefinition ? ObjectMetadata : never;
+declare function useOsdkMetadata<T extends ObjectOrInterfaceDefinition>(type: T): {
+    loading: boolean;
+    metadata?: MetadataFor<T>;
+};
+
+export { OsdkProvider, useOsdkMetadata };

package/build/cjs/public/experimental.cjs

@@ -2,12 +2,12 @@
 
 var chunk2N32USW5_cjs = require('../chunk-2N32USW5.cjs');
 var unstableDoNotUse = require('@osdk/client/unstable-do-not-use');
-var React3 = require('react');
+var React4 = require('react');
 var client = require('@osdk/client');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var React3__default = /*#__PURE__*/_interopDefault(React3);
+var React4__default = /*#__PURE__*/_interopDefault(React4);
 
 function fakeClientFn(..._args) {
   throw new Error("This is not a real client. Did you forget to <OsdkContext.Provider>?");
@@ -15,7 +15,7 @@ function fakeClientFn(..._args) {
 var fakeClient = Object.assign(fakeClientFn, {
   fetchMetadata: fakeClientFn
 });
-var OsdkContext2 = /* @__PURE__ */ React3__default.default.createContext({
+var OsdkContext2 = /* @__PURE__ */ React4__default.default.createContext({
   client: fakeClient,
   observableClient: void 0
 });
@@ -26,29 +26,93 @@ function OsdkProvider2({
   client,
   observableClient
 }) {
-  observableClient = React3.useMemo(() => observableClient ?? unstableDoNotUse.createObservableClient(client), [client, observableClient]);
-  return /* @__PURE__ */ React3__default.default.createElement(OsdkContext2.Provider, {
+  observableClient = React4.useMemo(() => observableClient ?? unstableDoNotUse.createObservableClient(client), [client, observableClient]);
+  return /* @__PURE__ */ React4__default.default.createElement(OsdkContext2.Provider, {
     value: {
       client,
       observableClient
     }
-  }, /* @__PURE__ */ React3__default.default.createElement(chunk2N32USW5_cjs.OsdkContext.Provider, {
+  }, /* @__PURE__ */ React4__default.default.createElement(chunk2N32USW5_cjs.OsdkContext.Provider, {
     value: {
       client
     }
   }, children));
 }
+
+// src/new/makeExternalStore.ts
+function makeExternalStore(createObservation, name) {
+  let lastResult;
+  function getSnapShot() {
+    return lastResult;
+  }
+  function subscribe(notifyUpdate) {
+    const obs = createObservation({
+      next: (payload) => {
+        lastResult = payload;
+        notifyUpdate();
+      },
+      error: (error) => {
+        lastResult = {
+          ...lastResult ?? {},
+          error: error instanceof Error ? error : new Error(String(error))
+        };
+        notifyUpdate();
+      },
+      complete: () => {
+      }
+    });
+    return () => {
+      obs.unsubscribe();
+    };
+  }
+  return {
+    subscribe,
+    getSnapShot
+  };
+}
+
+// src/new/useLinks.ts
+var emptyArray = Object.freeze([]);
+function useLinks(objects, linkName, options = {}) {
+  const {
+    observableClient
+  } = React4__default.default.useContext(OsdkContext2);
+  const objectsArray = React4__default.default.useMemo(() => {
+    return objects === void 0 ? emptyArray : Array.isArray(objects) ? objects : [objects];
+  }, [objects]);
+  const {
+    subscribe,
+    getSnapShot
+  } = React4__default.default.useMemo(() => {
+    return makeExternalStore((observer) => observableClient.observeLinks(objectsArray, linkName, {
+      linkName,
+      where: options.where,
+      pageSize: options.pageSize,
+      orderBy: options.orderBy,
+      mode: options.mode
+    }, observer), `links ${linkName} for ${objectsArray.map((obj) => `${obj.$apiName}:${obj.$primaryKey}`).join(",")}`);
+  }, [observableClient, objectsArray, linkName, options.where, options.pageSize, options.orderBy, options.mode]);
+  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    links: payload?.resolvedList,
+    isLoading: payload?.status === "loading",
+    isOptimistic: payload?.isOptimistic ?? false,
+    error: payload?.error,
+    fetchMore: payload?.fetchMore,
+    hasMore: payload?.hasMore ?? false
+  };
+}
 function useOsdkAction(actionDef) {
   const {
     observableClient
-  } = React3__default.default.useContext(OsdkContext2);
-  const [error, setError] = React3__default.default.useState();
-  const [data, setData] = React3__default.default.useState();
-  const [isPending, setPending] = React3__default.default.useState(false);
-  const [isValidating, setValidating] = React3__default.default.useState(false);
-  const [validationResult, setValidationResult] = React3__default.default.useState();
-  const abortControllerRef = React3__default.default.useRef(null);
-  const applyAction = React3__default.default.useCallback(async function applyAction2(hookArgs) {
+  } = React4__default.default.useContext(OsdkContext2);
+  const [error, setError] = React4__default.default.useState();
+  const [data, setData] = React4__default.default.useState();
+  const [isPending, setPending] = React4__default.default.useState(false);
+  const [isValidating, setValidating] = React4__default.default.useState(false);
+  const [validationResult, setValidationResult] = React4__default.default.useState();
+  const abortControllerRef = React4__default.default.useRef(null);
+  const applyAction = React4__default.default.useCallback(async function applyAction2(hookArgs) {
     try {
       if (isValidating && abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -102,10 +166,10 @@ function useOsdkAction(actionDef) {
       setPending(false);
     }
   }, [observableClient, actionDef, isValidating]);
-  const validateAction = React3__default.default.useCallback(async function validateAction2(args) {
+  const validateAction = React4__default.default.useCallback(async function validateAction2(args) {
     try {
       if (isPending) {
-        throw new Error("Cannot validate while action is pending");
+        return void 0;
       }
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -138,7 +202,7 @@ function useOsdkAction(actionDef) {
       setValidating(false);
     }
   }, [observableClient, actionDef, isPending]);
-  React3__default.default.useEffect(() => {
+  React4__default.default.useEffect(() => {
     return () => {
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -155,54 +219,20 @@ function useOsdkAction(actionDef) {
     validationResult
   };
 }
-
-// src/new/makeExternalStore.ts
-function makeExternalStore(createObservation, name) {
-  let lastResult;
-  function getSnapShot() {
-    return lastResult;
-  }
-  function subscribe(notifyUpdate) {
-    const obs = createObservation({
-      next: (payload) => {
-        lastResult = payload;
-        notifyUpdate();
-      },
-      error: (error) => {
-        lastResult = {
-          ...lastResult ?? {},
-          error: error instanceof Error ? error : new Error(String(error))
-        };
-        notifyUpdate();
-      },
-      complete: () => {
-      }
-    });
-    return () => {
-      obs.unsubscribe();
-    };
-  }
-  return {
-    subscribe,
-    getSnapShot
-  };
-}
-
-// src/new/useOsdkObject.ts
 function useOsdkObject(...args) {
   const {
     observableClient
-  } = React3__default.default.useContext(OsdkContext2);
+  } = React4__default.default.useContext(OsdkContext2);
   const mode = args.length === 1 ? "offline" : void 0;
   const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;
   const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];
   const {
     subscribe,
     getSnapShot
-  } = React3__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeObject(objectType, primaryKey, {
+  } = React4__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeObject(objectType, primaryKey, {
     mode
   }, observer)), [observableClient, objectType, primaryKey, mode]);
-  const payload = React3__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  const payload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
   return {
     object: payload?.object,
     isLoading: payload?.status === "loading",
@@ -222,12 +252,12 @@ function useOsdkObjects(type, {
 } = {}) {
   const {
     observableClient
-  } = React3__default.default.useContext(OsdkContext2);
+  } = React4__default.default.useContext(OsdkContext2);
   const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
   const {
     subscribe,
     getSnapShot
-  } = React3__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeList({
+  } = React4__default.default.useMemo(() => makeExternalStore((observer) => observableClient.observeList({
     type,
     where: canonWhere,
     dedupeInterval: dedupeIntervalMs ?? 2e3,
@@ -235,7 +265,7 @@ function useOsdkObjects(type, {
     orderBy,
     streamUpdates
   }, observer), process.env.NODE_ENV !== "production" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type, canonWhere, dedupeIntervalMs]);
-  const listPayload = React3__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  const listPayload = React4__default.default.useSyncExternalStore(subscribe, getSnapShot);
   return {
     fetchMore: listPayload?.fetchMore,
     error: listPayload && "error" in listPayload ? listPayload?.error : void 0,
@@ -250,6 +280,7 @@ Object.defineProperty(exports, "useOsdkClient", {
   get: function () { return chunk2N32USW5_cjs.useOsdkClient; }
 });
 exports.OsdkProvider2 = OsdkProvider2;
+exports.useLinks = useLinks;
 exports.useOsdkAction = useOsdkAction;
 exports.useOsdkObject = useOsdkObject;
 exports.useOsdkObjects = useOsdkObjects;

package/build/cjs/public/experimental.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/new/OsdkContext2.ts","../../../src/new/OsdkProvider2.tsx","../../../src/new/useOsdkAction.ts","../../../src/new/makeExternalStore.ts","../../../src/new/useOsdkObject.ts","../../../src/new/useOsdkObjects.ts"],"names":["useMemo","createObservableClient","React","OsdkContext","applyAction","args","ActionValidationError","validateAction"],"mappings":"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","file":"experimental.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nfunction fakeClientFn(..._args) {\n  throw new Error(\"This is not a real client. Did you forget to <OsdkContext.Provider>?\");\n}\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn\n});\nexport const OsdkContext2 = /*#__PURE__*/React.createContext({\n  client: fakeClient,\n  observableClient: undefined\n});","/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React, { useMemo } from \"react\";\nimport { OsdkContext } from \"../OsdkContext.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function OsdkProvider2({\n  children,\n  client,\n  observableClient\n}) {\n  observableClient = useMemo(() => observableClient ?? createObservableClient(client), [client, observableClient]);\n  return /*#__PURE__*/React.createElement(OsdkContext2.Provider, {\n    value: {\n      client,\n      observableClient\n    }\n  }, /*#__PURE__*/React.createElement(OsdkContext.Provider, {\n    value: {\n      client\n    }\n  }, children));\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ActionValidationError } from \"@osdk/client\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function useOsdkAction(actionDef) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n  const [error, setError] = React.useState();\n  const [data, setData] = React.useState();\n  const [isPending, setPending] = React.useState(false);\n  const [isValidating, setValidating] = React.useState(false);\n  const [validationResult, setValidationResult] = React.useState();\n  const abortControllerRef = React.useRef(null);\n  const applyAction = React.useCallback(async function applyAction(hookArgs) {\n    try {\n      // If validation is in progress, abort it\n      if (isValidating && abortControllerRef.current) {\n        abortControllerRef.current.abort();\n        setValidating(false);\n      }\n      setPending(true);\n      setError(undefined);\n      if (Array.isArray(hookArgs)) {\n        const updates = [];\n        const args = hookArgs.map(a => {\n          const {\n            $optimisticUpdate,\n            ...args\n          } = a;\n          if ($optimisticUpdate) {\n            updates.push($optimisticUpdate);\n          }\n          return args;\n        });\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: ctx => {\n            for (const update of updates) {\n              update?.(ctx);\n            }\n          }\n        });\n        setData(r);\n        return r;\n      } else {\n        const {\n          $optimisticUpdate,\n          ...args\n        } = hookArgs;\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: $optimisticUpdate\n        });\n        setData(r);\n        return r;\n      }\n    } catch (e) {\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e\n        });\n      } else {\n        setError({\n          unknown: e\n        });\n      }\n    } finally {\n      setPending(false);\n    }\n  }, [observableClient, actionDef, isValidating]);\n  const validateAction = React.useCallback(async function validateAction(args) {\n    try {\n      // Check if action is being applied\n      if (isPending) {\n        throw new Error(\"Cannot validate while action is pending\");\n      }\n\n      // Abort any existing validation\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n\n      // Create new AbortController\n      const abortController = new AbortController();\n      abortControllerRef.current = abortController;\n      setValidating(true);\n      setError(undefined);\n      const result = await observableClient.validateAction(actionDef, args);\n\n      // Check if aborted\n      if (abortController.signal.aborted) {\n        return undefined;\n      }\n      setValidationResult(result);\n      return result;\n    } catch (e) {\n      // Check if it was aborted\n      if (e instanceof Error && e.name === \"AbortError\") {\n        return undefined;\n      }\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e\n        });\n      } else {\n        setError({\n          unknown: e\n        });\n      }\n      throw e;\n    } finally {\n      setValidating(false);\n    }\n  }, [observableClient, actionDef, isPending]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n    };\n  }, []);\n  return {\n    applyAction,\n    validateAction,\n    error,\n    data,\n    isPending,\n    isValidating,\n    validationResult\n  };\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function makeExternalStore(createObservation, name) {\n  let lastResult;\n  function getSnapShot() {\n    return lastResult;\n  }\n  function subscribe(notifyUpdate) {\n    const obs = createObservation({\n      next: payload => {\n        lastResult = payload;\n        notifyUpdate();\n      },\n      error: error => {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error))\n        };\n        notifyUpdate();\n      },\n      complete: () => {}\n    });\n    return () => {\n      obs.unsubscribe();\n    };\n  }\n  return {\n    subscribe,\n    getSnapShot\n  };\n}","/*\n * 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 React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\n\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\n\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject(...args) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = args.length === 1 ? \"offline\" : undefined;\n  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;\n  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeObject(objectType, primaryKey, {\n    mode\n  }, observer), `object ${objectType} ${primaryKey}`), [observableClient, objectType, primaryKey, mode]);\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n  return {\n    object: payload?.object,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: !!payload?.isOptimistic,\n    error: payload && \"error\" in payload ? payload.error : undefined,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    }\n  };\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function useOsdkObjects(type, {\n  pageSize,\n  orderBy,\n  dedupeIntervalMs,\n  where = {},\n  streamUpdates\n} = {}) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  /*  We want the canonical where clause so that the use of `React.useMemo`\n      is stable. No real added cost as we canonicalize internal to\n      the ObservableClient anyway.\n   */\n  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeList({\n    type,\n    where: canonWhere,\n    dedupeInterval: dedupeIntervalMs ?? 2_000,\n    pageSize,\n    orderBy,\n    streamUpdates\n  }, observer), process.env.NODE_ENV !== \"production\" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type, canonWhere, dedupeIntervalMs]);\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n  // TODO: we need to expose the error in the result\n  return {\n    fetchMore: listPayload?.fetchMore,\n    error: listPayload && \"error\" in listPayload ? listPayload?.error : undefined,\n    data: listPayload?.resolvedList,\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false\n  };\n}"]}
+{"version":3,"sources":["../../../src/new/OsdkContext2.ts","../../../src/new/OsdkProvider2.tsx","../../../src/new/makeExternalStore.ts","../../../src/new/useLinks.ts","../../../src/new/useOsdkAction.ts","../../../src/new/useOsdkObject.ts","../../../src/new/useOsdkObjects.ts"],"names":["useMemo","createObservableClient","React","OsdkContext","applyAction","args","ActionValidationError","validateAction"],"mappings":"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","file":"experimental.cjs","sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nfunction fakeClientFn(..._args) {\n  throw new Error(\"This is not a real client. Did you forget to <OsdkContext.Provider>?\");\n}\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn\n});\nexport const OsdkContext2 = /*#__PURE__*/React.createContext({\n  client: fakeClient,\n  observableClient: undefined\n});","/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React, { useMemo } from \"react\";\nimport { OsdkContext } from \"../OsdkContext.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function OsdkProvider2({\n  children,\n  client,\n  observableClient\n}) {\n  observableClient = useMemo(() => observableClient ?? createObservableClient(client), [client, observableClient]);\n  return /*#__PURE__*/React.createElement(OsdkContext2.Provider, {\n    value: {\n      client,\n      observableClient\n    }\n  }, /*#__PURE__*/React.createElement(OsdkContext.Provider, {\n    value: {\n      client\n    }\n  }, children));\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function makeExternalStore(createObservation, name) {\n  let lastResult;\n  function getSnapShot() {\n    return lastResult;\n  }\n  function subscribe(notifyUpdate) {\n    const obs = createObservation({\n      next: payload => {\n        lastResult = payload;\n        notifyUpdate();\n      },\n      error: error => {\n        lastResult = {\n          ...(lastResult ?? {}),\n          error: error instanceof Error ? error : new Error(String(error))\n        };\n        notifyUpdate();\n      },\n      complete: () => {}\n    });\n    return () => {\n      obs.unsubscribe();\n    };\n  }\n  return {\n    subscribe,\n    getSnapShot\n  };\n}","/*\n * 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 React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nconst emptyArray = Object.freeze([]);\n\n/**\n * Hook to observe links from an object or array of objects.\n *\n * @param objects The source object(s) to observe links from\n * @param linkName The name of the link to observe\n * @param options Optional configuration for the link query\n * @returns UseLinksResult with links data and metadata\n */\nexport function useLinks(objects, linkName, options = {}) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  // Convert single object to array for consistent handling\n  const objectsArray = React.useMemo(() => {\n    return objects === undefined ? emptyArray : Array.isArray(objects) ? objects : [objects];\n  }, [objects]);\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => {\n    return makeExternalStore(observer => observableClient.observeLinks(objectsArray, linkName, {\n      linkName,\n      where: options.where,\n      pageSize: options.pageSize,\n      orderBy: options.orderBy,\n      mode: options.mode\n    }, observer), `links ${linkName} for ${objectsArray.map(obj => `${obj.$apiName}:${obj.$primaryKey}`).join(\",\")}`);\n  }, [observableClient, objectsArray, linkName, options.where, options.pageSize, options.orderBy, options.mode]);\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n  return {\n    links: payload?.resolvedList,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    error: payload?.error,\n    fetchMore: payload?.fetchMore,\n    hasMore: payload?.hasMore ?? false\n  };\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ActionValidationError } from \"@osdk/client\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function useOsdkAction(actionDef) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n  const [error, setError] = React.useState();\n  const [data, setData] = React.useState();\n  const [isPending, setPending] = React.useState(false);\n  const [isValidating, setValidating] = React.useState(false);\n  const [validationResult, setValidationResult] = React.useState();\n  const abortControllerRef = React.useRef(null);\n  const applyAction = React.useCallback(async function applyAction(hookArgs) {\n    try {\n      // If validation is in progress, abort it\n      if (isValidating && abortControllerRef.current) {\n        abortControllerRef.current.abort();\n        setValidating(false);\n      }\n      setPending(true);\n      setError(undefined);\n      if (Array.isArray(hookArgs)) {\n        const updates = [];\n        const args = hookArgs.map(a => {\n          const {\n            $optimisticUpdate,\n            ...args\n          } = a;\n          if ($optimisticUpdate) {\n            updates.push($optimisticUpdate);\n          }\n          return args;\n        });\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: ctx => {\n            for (const update of updates) {\n              update?.(ctx);\n            }\n          }\n        });\n        setData(r);\n        return r;\n      } else {\n        const {\n          $optimisticUpdate,\n          ...args\n        } = hookArgs;\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: $optimisticUpdate\n        });\n        setData(r);\n        return r;\n      }\n    } catch (e) {\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e\n        });\n      } else {\n        setError({\n          unknown: e\n        });\n      }\n    } finally {\n      setPending(false);\n    }\n  }, [observableClient, actionDef, isValidating]);\n  const validateAction = React.useCallback(async function validateAction(args) {\n    try {\n      // Check if action is being applied\n      if (isPending) {\n        return undefined;\n      }\n\n      // Abort any existing validation\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n\n      // Create new AbortController\n      const abortController = new AbortController();\n      abortControllerRef.current = abortController;\n      setValidating(true);\n      setError(undefined);\n      const result = await observableClient.validateAction(actionDef, args);\n\n      // Check if aborted\n      if (abortController.signal.aborted) {\n        return undefined;\n      }\n      setValidationResult(result);\n      return result;\n    } catch (e) {\n      // Check if it was aborted\n      if (e instanceof Error && e.name === \"AbortError\") {\n        return undefined;\n      }\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e\n        });\n      } else {\n        setError({\n          unknown: e\n        });\n      }\n      throw e;\n    } finally {\n      setValidating(false);\n    }\n  }, [observableClient, actionDef, isPending]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n    };\n  }, []);\n  return {\n    applyAction,\n    validateAction,\n    error,\n    data,\n    isPending,\n    isValidating,\n    validationResult\n  };\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\n\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\n\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject(...args) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  // TODO: Figure out what the correct default behavior is for the various scenarios\n  const mode = args.length === 1 ? \"offline\" : undefined;\n  const objectType = args.length === 1 ? args[0].$objectType : args[0].apiName;\n  const primaryKey = args.length === 1 ? args[0].$primaryKey : args[1];\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeObject(objectType, primaryKey, {\n    mode\n  }, observer), `object ${objectType} ${primaryKey}`), [observableClient, objectType, primaryKey, mode]);\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n  return {\n    object: payload?.object,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: !!payload?.isOptimistic,\n    error: payload && \"error\" in payload ? payload.error : undefined,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    }\n  };\n}","/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function useOsdkObjects(type, {\n  pageSize,\n  orderBy,\n  dedupeIntervalMs,\n  where = {},\n  streamUpdates\n} = {}) {\n  const {\n    observableClient\n  } = React.useContext(OsdkContext2);\n\n  /*  We want the canonical where clause so that the use of `React.useMemo`\n      is stable. No real added cost as we canonicalize internal to\n      the ObservableClient anyway.\n   */\n  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(observer => observableClient.observeList({\n    type,\n    where: canonWhere,\n    dedupeInterval: dedupeIntervalMs ?? 2_000,\n    pageSize,\n    orderBy,\n    streamUpdates\n  }, observer), process.env.NODE_ENV !== \"production\" ? `list ${type.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, type, canonWhere, dedupeIntervalMs]);\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n  // TODO: we need to expose the error in the result\n  return {\n    fetchMore: listPayload?.fetchMore,\n    error: listPayload && \"error\" in listPayload ? listPayload?.error : undefined,\n    data: listPayload?.resolvedList,\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false\n  };\n}"]}

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

@@ -1,7 +1,7 @@
-import { Client, ActionDefinition, ActionValidationError, ActionValidationResponse, ObjectTypeDefinition as ObjectTypeDefinition$1, InterfaceDefinition, WhereClause, PropertyKeys, Osdk as Osdk$1 } from '@osdk/client';
+import { Client, ObjectTypeDefinition, Osdk, InterfaceDefinition, WhereClause, PropertyKeys, ActionDefinition, ActionValidationError, ActionValidationResponse } from '@osdk/client';
 import { ObservableClient, ActionSignatureFromDef } from '@osdk/client/unstable-do-not-use';
 import React from 'react';
-import { ObjectTypeDefinition, Osdk, PrimaryKeyType } from '@osdk/api';
+import { LinkNames, LinkedType, ObjectTypeDefinition as ObjectTypeDefinition$1, Osdk as Osdk$1, PrimaryKeyType } from '@osdk/api';
 export { u as useOsdkClient } from '../useOsdkClient-B4iwHO1H.cjs';
 
 interface OsdkProviderOptions {
@@ -11,6 +11,54 @@ interface OsdkProviderOptions {
 }
 declare function OsdkProvider2({ children, client, observableClient, }: OsdkProviderOptions): React.JSX.Element;
 
+interface UseLinksOptions<T extends ObjectTypeDefinition | InterfaceDefinition> {
+    /**
+     * Standard OSDK Where clause for filtering linked objects
+     */
+    where?: WhereClause<T>;
+    /**
+     * The preferred page size for the links list.
+     */
+    pageSize?: number;
+    /** Sorting options for the linked objects */
+    orderBy?: {
+        [K in PropertyKeys<T>]?: "asc" | "desc";
+    };
+    /**
+     * The mode to use for fetching data.
+     * - undefined: Fetch data if not already in cache
+     * - "force": Always fetch fresh data
+     * - "offline": Only use cached data, don't make network requests
+     */
+    mode?: "force" | "offline";
+}
+interface UseLinksResult<Q extends ObjectTypeDefinition | InterfaceDefinition> {
+    links: Osdk.Instance<Q>[] | undefined;
+    isLoading: boolean;
+    error: Error | undefined;
+    /**
+     * Refers to whether the links are optimistic or not.
+     */
+    isOptimistic: boolean;
+    /**
+     * Fetch more linked objects if pagination is supported
+     */
+    fetchMore: (() => Promise<unknown>) | undefined;
+    /**
+     * Indicates if there are more linked objects available to fetch
+     */
+    hasMore: boolean;
+}
+/**
+ * Hook to observe links from an object or array of objects.
+ *
+ * @param objects The source object(s) to observe links from
+ * @param linkName The name of the link to observe
+ * @param options Optional configuration for the link query
+ * @returns UseLinksResult with links data and metadata
+ */
+declare function useLinks<T extends ObjectTypeDefinition, L extends LinkNames<T>>(objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined, linkName: L, options?: UseLinksOptions<LinkedType<T, L>>): UseLinksResult<LinkedType<T, L>>;
+
 type ApplyActionParams<Q extends ActionDefinition<any>> = Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0] & {
     [K in keyof ObservableClient.ApplyActionOptions as `$${K}`]: ObservableClient.ApplyActionOptions[K];
 };
@@ -35,8 +83,8 @@ interface UseOsdkActionResult<Q extends ActionDefinition<any>> {
 }
 declare function useOsdkAction<Q extends ActionDefinition<any>>(actionDef: Q): UseOsdkActionResult<Q>;
 
-interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {
-    object: Osdk.Instance<Q> | undefined;
+interface UseOsdkObjectResult<Q extends ObjectTypeDefinition$1> {
+    object: Osdk$1.Instance<Q> | undefined;
     isLoading: boolean;
     error: Error | undefined;
     /**
@@ -48,16 +96,16 @@ interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {
 /**
  * @param obj an existing `Osdk.Instance` object to get metadata for.
  */
-declare function useOsdkObject<Q extends ObjectTypeDefinition>(obj: Osdk.Instance<Q>): UseOsdkObjectResult<Q>;
+declare function useOsdkObject<Q extends ObjectTypeDefinition$1>(obj: Osdk$1.Instance<Q>): UseOsdkObjectResult<Q>;
 /**
  * Loads an object by type and primary key.
  *
  * @param type
  * @param primaryKey
  */
-declare function useOsdkObject<Q extends ObjectTypeDefinition>(type: Q, primaryKey: PrimaryKeyType<Q>): UseOsdkObjectResult<Q>;
+declare function useOsdkObject<Q extends ObjectTypeDefinition$1>(type: Q, primaryKey: PrimaryKeyType<Q>): UseOsdkObjectResult<Q>;
 
-interface UseOsdkObjectsOptions<T extends ObjectTypeDefinition$1 | InterfaceDefinition> {
+interface UseOsdkObjectsOptions<T extends ObjectTypeDefinition | InterfaceDefinition> {
     /**
      * Standard OSDK Where
      */
@@ -109,9 +157,9 @@ interface UseOsdkObjectsOptions<T extends ObjectTypeDefinition$1 | InterfaceDefi
      */
     streamUpdates?: boolean;
 }
-interface UseOsdkListResult<T extends ObjectTypeDefinition$1 | InterfaceDefinition> {
+interface UseOsdkListResult<T extends ObjectTypeDefinition | InterfaceDefinition> {
     fetchMore: (() => Promise<unknown>) | undefined;
-    data: Osdk$1.Instance<T>[] | undefined;
+    data: Osdk.Instance<T>[] | undefined;
     isLoading: boolean;
     error: Error | undefined;
     /**
@@ -123,6 +171,6 @@ interface UseOsdkListResult<T extends ObjectTypeDefinition$1 | InterfaceDefiniti
      */
     isOptimistic: boolean;
 }
-declare function useOsdkObjects<Q extends ObjectTypeDefinition$1 | InterfaceDefinition>(type: Q, { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates, }?: UseOsdkObjectsOptions<Q>): UseOsdkListResult<Q>;
+declare function useOsdkObjects<Q extends ObjectTypeDefinition | InterfaceDefinition>(type: Q, { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates, }?: UseOsdkObjectsOptions<Q>): UseOsdkListResult<Q>;
 
-export { OsdkProvider2, useOsdkAction, useOsdkObject, useOsdkObjects };
+export { OsdkProvider2, type UseOsdkListResult, useLinks, useOsdkAction, useOsdkObject, useOsdkObjects };

package/build/esm/index.js

@@ -20,4 +20,5 @@
 
 export { OsdkProvider } from "./OsdkProvider.js";
 export { useOsdkClient } from "./useOsdkClient.js";
+export { useOsdkMetadata } from "./useOsdkMetadata.js";
 //# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["OsdkProvider","useOsdkClient"],"sources":["index.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\n/**\n * @module @osdk/react\n */\n\nexport { OsdkProvider } from \"./OsdkProvider.js\";\nexport { useOsdkClient } from \"./useOsdkClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA,SAASA,YAAY,QAAQ,mBAAmB;AAChD,SAASC,aAAa,QAAQ,oBAAoB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["OsdkProvider","useOsdkClient","useOsdkMetadata"],"sources":["index.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\n/**\n * @module @osdk/react\n */\n\nexport { OsdkProvider } from \"./OsdkProvider.js\";\nexport { useOsdkClient } from \"./useOsdkClient.js\";\nexport { useOsdkMetadata } from \"./useOsdkMetadata.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA,SAASA,YAAY,QAAQ,mBAAmB;AAChD,SAASC,aAAa,QAAQ,oBAAoB;AAClD,SAASC,eAAe,QAAQ,sBAAsB","ignoreList":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"makeExternalStore.js","names":["makeExternalStore","createObservation","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\n  | (Partial<X> & { error: Error })\n  | undefined;\n\nexport function makeExternalStore<X>(\n  createObservation: (callback: Observer<X | undefined>) => Unsubscribable,\n  name?: string,\n): {\n  subscribe: (notifyUpdate: () => void) => () => void;\n  getSnapShot: () => Snapshot<X>;\n} {\n  let lastResult: Snapshot<X>;\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;\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,EAKxE;EACA,IAAIC,UAAuB;EAE3B,SAASC,WAAWA,CAAA,EAAgB;IAClC,OAAOD,UAAU;EACnB;EAuBA,OAAO;IACLE,SAAS,EAtBX,SAASA,SAASA,CAACC,YAAwB,EAAE;MAC3C,MAAMC,GAAG,GAAGL,iBAAiB,CAAC;QAC5BM,IAAI,EAAGC,OAAO,IAAK;UACjBN,UAAU,GAAGM,OAAO;UACpBH,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","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): {\n  subscribe: (notifyUpdate: () => void) => () => void;\n  getSnapShot: () => Snapshot<X>;\n} {\n  let lastResult: Snapshot<X>;\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,EAKxE;EACA,IAAIC,UAAuB;EAE3B,SAASC,WAAWA,CAAA,EAAgB;IAClC,OAAOD,UAAU;EACnB;EAuBA,OAAO;IACLE,SAAS,EAtBX,SAASA,SAASA,CAACC,YAAwB,EAAE;MAC3C,MAAMC,GAAG,GAAGL,iBAAiB,CAAC;QAC5BM,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":[]}

package/build/esm/new/useLinks.js

@@ -0,0 +1,61 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+import { makeExternalStore } from "./makeExternalStore.js";
+import { OsdkContext2 } from "./OsdkContext2.js";
+const emptyArray = Object.freeze([]);
+
+/**
+ * Hook to observe links from an object or array of objects.
+ *
+ * @param objects The source object(s) to observe links from
+ * @param linkName The name of the link to observe
+ * @param options Optional configuration for the link query
+ * @returns UseLinksResult with links data and metadata
+ */
+export function useLinks(objects, linkName, options = {}) {
+  const {
+    observableClient
+  } = React.useContext(OsdkContext2);
+
+  // Convert single object to array for consistent handling
+  const objectsArray = React.useMemo(() => {
+    return objects === undefined ? emptyArray : Array.isArray(objects) ? objects : [objects];
+  }, [objects]);
+  const {
+    subscribe,
+    getSnapShot
+  } = React.useMemo(() => {
+    return makeExternalStore(observer => observableClient.observeLinks(objectsArray, linkName, {
+      linkName,
+      where: options.where,
+      pageSize: options.pageSize,
+      orderBy: options.orderBy,
+      mode: options.mode
+    }, observer), `links ${linkName} for ${objectsArray.map(obj => `${obj.$apiName}:${obj.$primaryKey}`).join(",")}`);
+  }, [observableClient, objectsArray, linkName, options.where, options.pageSize, options.orderBy, options.mode]);
+  const payload = React.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    links: payload?.resolvedList,
+    isLoading: payload?.status === "loading",
+    isOptimistic: payload?.isOptimistic ?? false,
+    error: payload?.error,
+    fetchMore: payload?.fetchMore,
+    hasMore: payload?.hasMore ?? false
+  };
+}
+//# sourceMappingURL=useLinks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLinks.js","names":["React","makeExternalStore","OsdkContext2","emptyArray","Object","freeze","useLinks","objects","linkName","options","observableClient","useContext","objectsArray","useMemo","undefined","Array","isArray","subscribe","getSnapShot","observer","observeLinks","where","pageSize","orderBy","mode","map","obj","$apiName","$primaryKey","join","payload","useSyncExternalStore","links","resolvedList","isLoading","status","isOptimistic","error","fetchMore","hasMore"],"sources":["useLinks.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 { LinkedType, LinkNames } from \"@osdk/api\";\nimport type {\n  InterfaceDefinition,\n  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/client\";\nimport type { ObserveLinks } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseLinksOptions<\n  T extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  /**\n   * Standard OSDK Where clause for filtering linked objects\n   */\n  where?: WhereClause<T>;\n\n  /**\n   * The preferred page size for the links list.\n   */\n  pageSize?: number;\n\n  /** Sorting options for the linked objects */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * The mode to use for fetching data.\n   * - undefined: Fetch data if not already in cache\n   * - \"force\": Always fetch fresh data\n   * - \"offline\": Only use cached data, don't make network requests\n   */\n  mode?: \"force\" | \"offline\";\n}\n\nexport interface UseLinksResult<\n  Q extends ObjectTypeDefinition | InterfaceDefinition,\n> {\n  links: Osdk.Instance<Q>[] | undefined;\n  isLoading: boolean;\n  error: Error | undefined;\n\n  /**\n   * Refers to whether the links are optimistic or not.\n   */\n  isOptimistic: boolean;\n\n  /**\n   * Fetch more linked objects if pagination is supported\n   */\n  fetchMore: (() => Promise<unknown>) | undefined;\n\n  /**\n   * Indicates if there are more linked objects available to fetch\n   */\n  hasMore: boolean;\n}\n\nconst emptyArray = Object.freeze([]);\n\n/**\n * Hook to observe links from an object or array of objects.\n *\n * @param objects The source object(s) to observe links from\n * @param linkName The name of the link to observe\n * @param options Optional configuration for the link query\n * @returns UseLinksResult with links data and metadata\n */\nexport function useLinks<\n  T extends ObjectTypeDefinition,\n  L extends LinkNames<T>,\n>(\n  objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined,\n  linkName: L,\n  options: UseLinksOptions<LinkedType<T, L>> = {},\n): UseLinksResult<LinkedType<T, L>> {\n  const { observableClient } = React.useContext(OsdkContext2);\n\n  // Convert single object to array for consistent handling\n  const objectsArray: ReadonlyArray<Osdk.Instance<T>> = React.useMemo(() => {\n    return objects === undefined\n      ? emptyArray\n      : Array.isArray(objects)\n      ? objects\n      : [objects];\n  }, [objects]);\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () => {\n      return makeExternalStore<ObserveLinks.CallbackArgs<T>>(\n        (observer) =>\n          observableClient.observeLinks(\n            objectsArray,\n            linkName,\n            {\n              linkName,\n              where: options.where,\n              pageSize: options.pageSize,\n              orderBy: options.orderBy,\n              mode: options.mode,\n            },\n            observer,\n          ),\n        `links ${linkName} for ${\n          objectsArray.map(obj => `${obj.$apiName}:${obj.$primaryKey}`).join(\n            \",\",\n          )\n        }`,\n      );\n    },\n    [\n      observableClient,\n      objectsArray,\n      linkName,\n      options.where,\n      options.pageSize,\n      options.orderBy,\n      options.mode,\n    ],\n  );\n\n  const payload = React.useSyncExternalStore(\n    subscribe,\n    getSnapShot,\n  );\n\n  return {\n    links: payload?.resolvedList,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    error: payload?.error,\n    fetchMore: payload?.fetchMore,\n    hasMore: payload?.hasMore ?? false,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAWA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAoDhD,MAAMC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAAC,EAAE,CAAC;;AAEpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAItBC,OAA+D,EAC/DC,QAAW,EACXC,OAA0C,GAAG,CAAC,CAAC,EACb;EAClC,MAAM;IAAEC;EAAiB,CAAC,GAAGV,KAAK,CAACW,UAAU,CAACT,YAAY,CAAC;;EAE3D;EACA,MAAMU,YAA6C,GAAGZ,KAAK,CAACa,OAAO,CAAC,MAAM;IACxE,OAAON,OAAO,KAAKO,SAAS,GACxBX,UAAU,GACVY,KAAK,CAACC,OAAO,CAACT,OAAO,CAAC,GACtBA,OAAO,GACP,CAACA,OAAO,CAAC;EACf,CAAC,EAAE,CAACA,OAAO,CAAC,CAAC;EAEb,MAAM;IAAEU,SAAS;IAAEC;EAAY,CAAC,GAAGlB,KAAK,CAACa,OAAO,CAC9C,MAAM;IACJ,OAAOZ,iBAAiB,CACrBkB,QAAQ,IACPT,gBAAgB,CAACU,YAAY,CAC3BR,YAAY,EACZJ,QAAQ,EACR;MACEA,QAAQ;MACRa,KAAK,EAAEZ,OAAO,CAACY,KAAK;MACpBC,QAAQ,EAAEb,OAAO,CAACa,QAAQ;MAC1BC,OAAO,EAAEd,OAAO,CAACc,OAAO;MACxBC,IAAI,EAAEf,OAAO,CAACe;IAChB,CAAC,EACDL,QACF,CAAC,EACH,SAASX,QAAQ,QACfI,YAAY,CAACa,GAAG,CAACC,GAAG,IAAI,GAAGA,GAAG,CAACC,QAAQ,IAAID,GAAG,CAACE,WAAW,EAAE,CAAC,CAACC,IAAI,CAChE,GACF,CAAC,EAEL,CAAC;EACH,CAAC,EACD,CACEnB,gBAAgB,EAChBE,YAAY,EACZJ,QAAQ,EACRC,OAAO,CAACY,KAAK,EACbZ,OAAO,CAACa,QAAQ,EAChBb,OAAO,CAACc,OAAO,EACfd,OAAO,CAACe,IAAI,CAEhB,CAAC;EAED,MAAMM,OAAO,GAAG9B,KAAK,CAAC+B,oBAAoB,CACxCd,SAAS,EACTC,WACF,CAAC;EAED,OAAO;IACLc,KAAK,EAAEF,OAAO,EAAEG,YAAY;IAC5BC,SAAS,EAAEJ,OAAO,EAAEK,MAAM,KAAK,SAAS;IACxCC,YAAY,EAAEN,OAAO,EAAEM,YAAY,IAAI,KAAK;IAC5CC,KAAK,EAAEP,OAAO,EAAEO,KAAK;IACrBC,SAAS,EAAER,OAAO,EAAEQ,SAAS;IAC7BC,OAAO,EAAET,OAAO,EAAES,OAAO,IAAI;EAC/B,CAAC;AACH","ignoreList":[]}

package/build/esm/new/useOsdkAction.js

@@ -86,7 +86,7 @@ export function useOsdkAction(actionDef) {
     try {
       // Check if action is being applied
       if (isPending) {
-        throw new Error("Cannot validate while action is pending");
+        return undefined;
       }
 
       // Abort any existing validation

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","observableClient","useContext","error","setError","useState","data","setData","isPending","setPending","isValidating","setValidating","validationResult","setValidationResult","abortControllerRef","useRef","applyAction","useCallback","hookArgs","current","abort","undefined","Array","isArray","updates","args","map","a","$optimisticUpdate","push","r","optimisticUpdate","ctx","update","e","actionValidation","unknown","validateAction","Error","abortController","AbortController","result","signal","aborted","name","useEffect"],"sources":["useOsdkAction.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 { ActionDefinition, ActionValidationResponse } from \"@osdk/client\";\nimport { ActionValidationError } from \"@osdk/client\";\nimport type {\n  ActionSignatureFromDef,\n  ObservableClient,\n} from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ntype ApplyActionParams<Q extends ActionDefinition<any>> =\n  & Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n  & {\n    [K in keyof ObservableClient.ApplyActionOptions as `$${K}`]:\n      ObservableClient.ApplyActionOptions[K];\n  };\n\nexport interface UseOsdkActionResult<Q extends ActionDefinition<any>> {\n  applyAction: (\n    args: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>,\n  ) => Promise<unknown>;\n\n  error:\n    | undefined\n    | Partial<{\n      actionValidation: ActionValidationError;\n      unknown: unknown;\n    }>;\n  data: unknown;\n\n  isPending: boolean;\n  isValidating: boolean;\n\n  /**\n   * Validates the action with the provided arguments without executing it.\n   * Calling this function again before the previous validation finishes will cancel\n   * the first validation and start a new one.\n   * @param args The action arguments to validate\n   * @returns A promise that resolves to the validation response, or undefined if aborted\n   */\n  validateAction: (\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse | undefined>;\n\n  validationResult?: ActionValidationResponse;\n}\n\nexport function useOsdkAction<Q extends ActionDefinition<any>>(\n  actionDef: Q,\n): UseOsdkActionResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n  const [error, setError] = React.useState<UseOsdkActionResult<Q>[\"error\"]>();\n  const [data, setData] = React.useState<unknown>();\n  const [isPending, setPending] = React.useState(false);\n  const [isValidating, setValidating] = React.useState(false);\n  const [validationResult, setValidationResult] = React.useState<\n    ActionValidationResponse | undefined\n  >();\n  const abortControllerRef = React.useRef<AbortController | null>(null);\n\n  const applyAction = React.useCallback(async function applyAction(\n    hookArgs: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>,\n  ) {\n    try {\n      // If validation is in progress, abort it\n      if (isValidating && abortControllerRef.current) {\n        abortControllerRef.current.abort();\n        setValidating(false);\n      }\n\n      setPending(true);\n      setError(undefined);\n\n      if (Array.isArray(hookArgs)) {\n        const updates: Array<\n          ObservableClient.ApplyActionOptions[\"optimisticUpdate\"]\n        > = [];\n        const args = hookArgs.map(a => {\n          const { $optimisticUpdate, ...args } = a;\n          if ($optimisticUpdate) {\n            updates.push($optimisticUpdate);\n          }\n          return args;\n        });\n\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: (ctx) => {\n            for (const update of updates) {\n              update?.(ctx);\n            }\n          },\n        });\n        setData(r);\n        return r;\n      } else {\n        const { $optimisticUpdate, ...args } = hookArgs;\n\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: $optimisticUpdate,\n        });\n        setData(r);\n        return r;\n      }\n    } catch (e) {\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e,\n        });\n      } else {\n        setError({ unknown: e });\n      }\n    } finally {\n      setPending(false);\n    }\n  }, [observableClient, actionDef, isValidating]);\n\n  const validateAction = React.useCallback(async function validateAction(\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ): Promise<ActionValidationResponse | undefined> {\n    try {\n      // Check if action is being applied\n      if (isPending) {\n        throw new Error(\"Cannot validate while action is pending\");\n      }\n\n      // Abort any existing validation\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n\n      // Create new AbortController\n      const abortController = new AbortController();\n      abortControllerRef.current = abortController;\n\n      setValidating(true);\n      setError(undefined);\n\n      const result = await observableClient.validateAction(actionDef, args);\n\n      // Check if aborted\n      if (abortController.signal.aborted) {\n        return undefined;\n      }\n\n      setValidationResult(result);\n      return result;\n    } catch (e) {\n      // Check if it was aborted\n      if (e instanceof Error && e.name === \"AbortError\") {\n        return undefined;\n      }\n\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e,\n        });\n      } else {\n        setError({ unknown: e });\n      }\n      throw e;\n    } finally {\n      setValidating(false);\n    }\n  }, [observableClient, actionDef, isPending]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n    };\n  }, []);\n\n  return {\n    applyAction,\n    validateAction,\n    error,\n    data,\n    isPending,\n    isValidating,\n    validationResult,\n  };\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","observableClient","useContext","error","setError","useState","data","setData","isPending","setPending","isValidating","setValidating","validationResult","setValidationResult","abortControllerRef","useRef","applyAction","useCallback","hookArgs","current","abort","undefined","Array","isArray","updates","args","map","a","$optimisticUpdate","push","r","optimisticUpdate","ctx","update","e","actionValidation","unknown","validateAction","abortController","AbortController","result","signal","aborted","Error","name","useEffect"],"sources":["useOsdkAction.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 { ActionDefinition, ActionValidationResponse } from \"@osdk/client\";\nimport { ActionValidationError } from \"@osdk/client\";\nimport type {\n  ActionSignatureFromDef,\n  ObservableClient,\n} from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ntype ApplyActionParams<Q extends ActionDefinition<any>> =\n  & Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0]\n  & {\n    [K in keyof ObservableClient.ApplyActionOptions as `$${K}`]:\n      ObservableClient.ApplyActionOptions[K];\n  };\n\nexport interface UseOsdkActionResult<Q extends ActionDefinition<any>> {\n  applyAction: (\n    args: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>,\n  ) => Promise<unknown>;\n\n  error:\n    | undefined\n    | Partial<{\n      actionValidation: ActionValidationError;\n      unknown: unknown;\n    }>;\n  data: unknown;\n\n  isPending: boolean;\n  isValidating: boolean;\n\n  /**\n   * Validates the action with the provided arguments without executing it.\n   * Calling this function again before the previous validation finishes will cancel\n   * the first validation and start a new one.\n   * @param args The action arguments to validate\n   * @returns A promise that resolves to the validation response, or undefined if aborted\n   */\n  validateAction: (\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ) => Promise<ActionValidationResponse | undefined>;\n\n  validationResult?: ActionValidationResponse;\n}\n\nexport function useOsdkAction<Q extends ActionDefinition<any>>(\n  actionDef: Q,\n): UseOsdkActionResult<Q> {\n  const { observableClient } = React.useContext(OsdkContext2);\n  const [error, setError] = React.useState<UseOsdkActionResult<Q>[\"error\"]>();\n  const [data, setData] = React.useState<unknown>();\n  const [isPending, setPending] = React.useState(false);\n  const [isValidating, setValidating] = React.useState(false);\n  const [validationResult, setValidationResult] = React.useState<\n    ActionValidationResponse | undefined\n  >();\n  const abortControllerRef = React.useRef<AbortController | null>(null);\n\n  const applyAction = React.useCallback(async function applyAction(\n    hookArgs: ApplyActionParams<Q> | Array<ApplyActionParams<Q>>,\n  ) {\n    try {\n      // If validation is in progress, abort it\n      if (isValidating && abortControllerRef.current) {\n        abortControllerRef.current.abort();\n        setValidating(false);\n      }\n\n      setPending(true);\n      setError(undefined);\n\n      if (Array.isArray(hookArgs)) {\n        const updates: Array<\n          ObservableClient.ApplyActionOptions[\"optimisticUpdate\"]\n        > = [];\n        const args = hookArgs.map(a => {\n          const { $optimisticUpdate, ...args } = a;\n          if ($optimisticUpdate) {\n            updates.push($optimisticUpdate);\n          }\n          return args;\n        });\n\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: (ctx) => {\n            for (const update of updates) {\n              update?.(ctx);\n            }\n          },\n        });\n        setData(r);\n        return r;\n      } else {\n        const { $optimisticUpdate, ...args } = hookArgs;\n\n        const r = await observableClient.applyAction(actionDef, args, {\n          optimisticUpdate: $optimisticUpdate,\n        });\n        setData(r);\n        return r;\n      }\n    } catch (e) {\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e,\n        });\n      } else {\n        setError({ unknown: e });\n      }\n    } finally {\n      setPending(false);\n    }\n  }, [observableClient, actionDef, isValidating]);\n\n  const validateAction = React.useCallback(async function validateAction(\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n  ): Promise<ActionValidationResponse | undefined> {\n    try {\n      // Check if action is being applied\n      if (isPending) {\n        return undefined;\n      }\n\n      // Abort any existing validation\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n\n      // Create new AbortController\n      const abortController = new AbortController();\n      abortControllerRef.current = abortController;\n\n      setValidating(true);\n      setError(undefined);\n\n      const result = await observableClient.validateAction(actionDef, args);\n\n      // Check if aborted\n      if (abortController.signal.aborted) {\n        return undefined;\n      }\n\n      setValidationResult(result);\n      return result;\n    } catch (e) {\n      // Check if it was aborted\n      if (e instanceof Error && e.name === \"AbortError\") {\n        return undefined;\n      }\n\n      if (e instanceof ActionValidationError) {\n        setError({\n          actionValidation: e,\n        });\n      } else {\n        setError({ unknown: e });\n      }\n      throw e;\n    } finally {\n      setValidating(false);\n    }\n  }, [observableClient, actionDef, isPending]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (abortControllerRef.current) {\n        abortControllerRef.current.abort();\n      }\n    };\n  }, []);\n\n  return {\n    applyAction,\n    validateAction,\n    error,\n    data,\n    isPending,\n    isValidating,\n    validationResult,\n  };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/public/experimental.js

@@ -15,6 +15,7 @@
  */
 
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
+export { useLinks } from "../new/useLinks.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
 export { useOsdkObjects } from "../new/useOsdkObjects.js";

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

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["OsdkProvider2","useOsdkAction","useOsdkObject","useOsdkObjects","useOsdkClient"],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { OsdkProvider2 } from \"../new/OsdkProvider2.js\";\nexport { useOsdkAction } from \"../new/useOsdkAction.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport { useOsdkObjects } from \"../new/useOsdkObjects.js\";\nexport { useOsdkClient } from \"../useOsdkClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB","ignoreList":[]}
+{"version":3,"file":"experimental.js","names":["OsdkProvider2","useLinks","useOsdkAction","useOsdkObject","useOsdkObjects","useOsdkClient"],"sources":["experimental.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport { OsdkProvider2 } from \"../new/OsdkProvider2.js\";\nexport { useLinks } from \"../new/useLinks.js\";\nexport { useOsdkAction } from \"../new/useOsdkAction.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.js\";\nexport type { UseOsdkListResult } from \"../new/useOsdkObjects.js\";\nexport { useOsdkObjects } from \"../new/useOsdkObjects.js\";\nexport { useOsdkClient } from \"../useOsdkClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,QAAQ,yBAAyB;AACvD,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,yBAAyB;AAEvD,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,qBAAqB","ignoreList":[]}

package/build/types/index.d.ts

@@ -3,3 +3,4 @@
 */
 export { OsdkProvider } from "./OsdkProvider.js";
 export { useOsdkClient } from "./useOsdkClient.js";
+export { useOsdkMetadata } from "./useOsdkMetadata.js";

package/build/types/index.d.ts.map

@@ -1 +1 @@
-{"mappings":";;;AAoBA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB","names":[],"sources":["../../src/index.ts"],"version":3,"file":"index.d.ts"}
+{"mappings":";;;AAoBA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB","names":[],"sources":["../../src/index.ts"],"version":3,"file":"index.d.ts"}

package/build/types/new/makeExternalStore.d.ts

@@ -1,6 +1,8 @@
 import type { Observer, Unsubscribable } from "@osdk/client/unstable-do-not-use";
-export type Snapshot<X> = X | (Partial<X> & {
-	error: Error
+export type Snapshot<X> = X & {
+	error?: Error
+} | (Partial<X> & {
+	error?: Error
 }) | undefined;
 export declare function makeExternalStore<X>(createObservation: (callback: Observer<X | undefined>) => Unsubscribable, name?: string): {
 	subscribe: (notifyUpdate: () => void) => () => void

package/build/types/new/makeExternalStore.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,cACE,UACA,sBACK,kCAAmC;AAE1C,YAAY,SAAS,KACjB,KACC,QAAQ,KAAK;CAAE,OAAO;AAAO;AAGlC,OAAO,iBAAS,kBAAkB,GAChCA,oBAAoBC,UAAU,SAAS,mBAAmB,gBAC1DC,gBACC;CACD,YAAYC;CACZ,mBAAmB,SAAS;AAC7B","names":["createObservation: (callback: Observer<X | undefined>) => Unsubscribable","callback: Observer<X | undefined>","name?: string","notifyUpdate: () => void"],"sources":["../../../src/new/makeExternalStore.ts"],"version":3,"file":"makeExternalStore.d.ts"}
+{"mappings":"AAgBA,cACE,UACA,sBACK,kCAAmC;AAE1C,YAAY,SAAS,KACjB,IAAI;CAAE,QAAQ;AAAO,KACpB,QAAQ,KAAK;CAAE,QAAQ;AAAO;AAGnC,OAAO,iBAAS,kBAAkB,GAChCA,oBAAoBC,UAAU,SAAS,mBAAmB,gBAC1DC,gBACC;CACD,YAAYC;CACZ,mBAAmB,SAAS;AAC7B","names":["createObservation: (callback: Observer<X | undefined>) => Unsubscribable","callback: Observer<X | undefined>","name?: string","notifyUpdate: () => void"],"sources":["../../../src/new/makeExternalStore.ts"],"version":3,"file":"makeExternalStore.d.ts"}

package/build/types/new/useLinks.d.ts

@@ -0,0 +1,50 @@
+import type { LinkedType, LinkNames } from "@osdk/api";
+import type { InterfaceDefinition, ObjectTypeDefinition, Osdk, PropertyKeys, WhereClause } from "@osdk/client";
+export interface UseLinksOptions<T extends ObjectTypeDefinition | InterfaceDefinition> {
+	/**
+	* Standard OSDK Where clause for filtering linked objects
+	*/
+	where?: WhereClause<T>;
+	/**
+	* The preferred page size for the links list.
+	*/
+	pageSize?: number;
+	/** Sorting options for the linked objects */
+	orderBy?: { [K in PropertyKeys<T>]? : "asc" | "desc" };
+	/**
+	* The mode to use for fetching data.
+	* - undefined: Fetch data if not already in cache
+	* - "force": Always fetch fresh data
+	* - "offline": Only use cached data, don't make network requests
+	*/
+	mode?: "force" | "offline";
+}
+export interface UseLinksResult<Q extends ObjectTypeDefinition | InterfaceDefinition> {
+	links: Osdk.Instance<Q>[] | undefined;
+	isLoading: boolean;
+	error: Error | undefined;
+	/**
+	* Refers to whether the links are optimistic or not.
+	*/
+	isOptimistic: boolean;
+	/**
+	* Fetch more linked objects if pagination is supported
+	*/
+	fetchMore: (() => Promise<unknown>) | undefined;
+	/**
+	* Indicates if there are more linked objects available to fetch
+	*/
+	hasMore: boolean;
+}
+/**
+* Hook to observe links from an object or array of objects.
+*
+* @param objects The source object(s) to observe links from
+* @param linkName The name of the link to observe
+* @param options Optional configuration for the link query
+* @returns UseLinksResult with links data and metadata
+*/
+export declare function useLinks<
+	T extends ObjectTypeDefinition,
+	L extends LinkNames<T>
+>(objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined, linkName: L, options?: UseLinksOptions<LinkedType<T, L>>): UseLinksResult<LinkedType<T, L>>;

package/build/types/new/useLinks.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,YAAY,iBAAiB,WAAY;AACvD,cACE,qBACA,sBACA,MACA,cACA,mBACK,cAAe;AAMtB,iBAAiB,gBACf,UAAU,uBAAuB,qBACjC;;;;CAIA,QAAQ,YAAY;;;;CAKpB;;CAGA,aACG,KAAK,aAAa,OAAM,QAAQ;;;;;;;CASnC,OAAO,UAAU;AAClB;AAED,iBAAiB,eACf,UAAU,uBAAuB,qBACjC;CACA,OAAO,KAAK,SAAS;CACrB;CACA,OAAO;;;;CAKP;;;;CAKA,kBAAkB;;;;CAKlB;AACD;;;;;;;;;AAYD,OAAO,iBAAS;CACd,UAAU;CACV,UAAU,UAAU;EAEpBA,SAAS,KAAK,SAAS,KAAK,MAAM,KAAK,SAAS,iBAChDC,UAAU,GACVC,UAAS,gBAAgB,WAAW,GAAG,MACtC,eAAe,WAAW,GAAG","names":["objects: Osdk.Instance<T> | Array<Osdk.Instance<T>> | undefined","linkName: L","options: UseLinksOptions<LinkedType<T, L>>"],"sources":["../../../src/new/useLinks.ts"],"version":3,"file":"useLinks.d.ts"}

package/build/types/public/experimental.d.ts

@@ -1,5 +1,7 @@
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
+export { useLinks } from "../new/useLinks.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
+export type { UseOsdkListResult } from "../new/useOsdkObjects.js";
 export { useOsdkObjects } from "../new/useOsdkObjects.js";
 export { useOsdkClient } from "../useOsdkClient.js";

package/build/types/public/experimental.d.ts.map

@@ -1 +1 @@
-{"mappings":"AAgBA,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB","names":[],"sources":["../../../src/public/experimental.ts"],"version":3,"file":"experimental.d.ts"}
+{"mappings":"AAgBA,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAC9B,cAAc,yBAAyB;AACvC,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB","names":[],"sources":["../../../src/public/experimental.ts"],"version":3,"file":"experimental.d.ts"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdk/react",
-  "version": "0.6.0-beta.3",
+  "version": "0.7.0-beta.2",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -50,10 +50,10 @@
     "react": "^18.0.0",
     "tiny-invariant": "^1.3.3",
     "typescript": "~5.5.4",
-    "@osdk/client": "2.4.0-beta.4",
-    "@osdk/api": "2.4.0-beta.4",
-    "@osdk/monorepo.api-extractor": "~0.3.0-beta.1",
-    "@osdk/monorepo.tsconfig": "~0.3.0-beta.1"
+    "@osdk/api": "2.5.0-beta.2",
+    "@osdk/monorepo.api-extractor": "~0.4.0-beta.1",
+    "@osdk/monorepo.tsconfig": "~0.4.0-beta.1",
+    "@osdk/client": "2.5.0-beta.2"
   },
   "publishConfig": {
     "access": "public"