@osdk/react 0.4.0-beta.2 → 0.4.0-beta.3

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @osdkkit/react
 
+## 0.4.0-beta.3
+
+### Minor Changes
+
+- 2f6206c: Improvements to @osdk/react
+
+### Patch Changes
+
+- Updated dependencies [62e5965]
+- Updated dependencies [2f6206c]
+  - @osdk/client@2.2.0-beta.5
+  - @osdk/api@2.2.0-beta.5
+
 ## 0.4.0-beta.2
 
 ### Minor Changes

package/build/browser/new/OsdkContext2.js

@@ -23,6 +23,6 @@ const fakeClient = Object.assign(fakeClientFn, {
 });
 export const OsdkContext2 = /*#__PURE__*/React.createContext({
   client: fakeClient,
-  store: undefined
+  observableClient: undefined
 });
 //# sourceMappingURL=OsdkContext2.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"OsdkContext2.js","names":["React","fakeClientFn","_args","Error","fakeClient","Object","assign","fetchMetadata","OsdkContext2","createContext","client","store","undefined"],"sources":["OsdkContext2.ts"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Client } from \"@osdk/client\";\nimport type { ObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\n\nfunction fakeClientFn(..._args: any[]) {\n  throw new Error(\n    \"This is not a real client. Did you forget to <OsdkContext.Provider>?\",\n  );\n}\n\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn,\n} as Client);\n\ninterface OsdkContextContents {\n  client: Client;\n  // keeping the old name for now intentionally\n  // in case i need both for a while\n  // in the future we can just make\n  // this `client: ObservableClient`\n  store: ObservableClient;\n}\n\nexport const OsdkContext2: React.Context<OsdkContextContents> = React\n  .createContext<OsdkContextContents>({\n    client: fakeClient,\n    store: undefined!,\n  });\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AAEzB,SAASC,YAAYA,CAAC,GAAGC,KAAY,EAAE;EACrC,MAAM,IAAIC,KAAK,CACb,sEACF,CAAC;AACH;AAEA,MAAMC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAACL,YAAY,EAAE;EAC7CM,aAAa,EAAEN;AACjB,CAAW,CAAC;AAWZ,OAAO,MAAMO,YAAgD,gBAAGR,KAAK,CAClES,aAAa,CAAsB;EAClCC,MAAM,EAAEN,UAAU;EAClBO,KAAK,EAAEC;AACT,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"OsdkContext2.js","names":["React","fakeClientFn","_args","Error","fakeClient","Object","assign","fetchMetadata","OsdkContext2","createContext","client","observableClient","undefined"],"sources":["OsdkContext2.ts"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Client } from \"@osdk/client\";\nimport type { ObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\n\nfunction fakeClientFn(..._args: any[]) {\n  throw new Error(\n    \"This is not a real client. Did you forget to <OsdkContext.Provider>?\",\n  );\n}\n\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn,\n} as Client);\n\ninterface OsdkContextContents {\n  client: Client;\n  // keeping the old name for now intentionally\n  // in case i need both for a while\n  // in the future we can just make\n  // this `client: ObservableClient`\n  observableClient: ObservableClient;\n}\n\nexport const OsdkContext2: React.Context<OsdkContextContents> = React\n  .createContext<OsdkContextContents>({\n    client: fakeClient,\n    observableClient: undefined!,\n  });\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AAEzB,SAASC,YAAYA,CAAC,GAAGC,KAAY,EAAE;EACrC,MAAM,IAAIC,KAAK,CACb,sEACF,CAAC;AACH;AAEA,MAAMC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAACL,YAAY,EAAE;EAC7CM,aAAa,EAAEN;AACjB,CAAW,CAAC;AAWZ,OAAO,MAAMO,YAAgD,gBAAGR,KAAK,CAClES,aAAa,CAAsB;EAClCC,MAAM,EAAEN,UAAU;EAClBO,gBAAgB,EAAEC;AACpB,CAAC,CAAC","ignoreList":[]}

package/build/browser/new/OsdkProvider2.js

@@ -14,17 +14,19 @@
  * limitations under the License.
  */
 
-import React from "react";
+import { createObservableClient } from "@osdk/client/unstable-do-not-use";
+import React, { useMemo } from "react";
 import { OsdkContext2 } from "./OsdkContext2.js";
 export function OsdkProvider2({
   children,
   client,
-  store
+  observableClient
 }) {
+  observableClient = useMemo(() => observableClient ?? createObservableClient(client), [client, observableClient]);
   return /*#__PURE__*/React.createElement(OsdkContext2.Provider, {
     value: {
       client,
-      store
+      observableClient
     }
   }, children);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"OsdkProvider2.js","names":["React","OsdkContext2","OsdkProvider2","children","client","store","createElement","Provider","value"],"sources":["OsdkProvider2.tsx"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Client } from \"@osdk/client\";\nimport type { ObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ninterface OsdkProviderOptions {\n  children: React.ReactNode;\n  client: Client;\n  store: ObservableClient;\n}\n\nexport function OsdkProvider2({\n  children,\n  client,\n  store,\n}: OsdkProviderOptions): React.JSX.Element {\n  return (\n    <OsdkContext2.Provider value={{ client, store }}>\n      {children}\n    </OsdkContext2.Provider>\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,mBAAmB;AAQhD,OAAO,SAASC,aAAaA,CAAC;EAC5BC,QAAQ;EACRC,MAAM;EACNC;AACmB,CAAC,EAAqB;EACzC,oBACEL,KAAA,CAAAM,aAAA,CAACL,YAAY,CAACM,QAAQ;IAACC,KAAK,EAAE;MAAEJ,MAAM;MAAEC;IAAM;EAAE,GAC7CF,QACoB,CAAC;AAE5B","ignoreList":[]}
+{"version":3,"file":"OsdkProvider2.js","names":["createObservableClient","React","useMemo","OsdkContext2","OsdkProvider2","children","client","observableClient","createElement","Provider","value"],"sources":["OsdkProvider2.tsx"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Client } from \"@osdk/client\";\nimport {\n  createObservableClient,\n  type ObservableClient,\n} from \"@osdk/client/unstable-do-not-use\";\nimport React, { useMemo } from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ninterface OsdkProviderOptions {\n  children: React.ReactNode;\n  client: Client;\n  observableClient?: ObservableClient;\n}\n\nexport function OsdkProvider2({\n  children,\n  client,\n  observableClient,\n}: OsdkProviderOptions): React.JSX.Element {\n  observableClient = useMemo(\n    () => observableClient ?? createObservableClient(client),\n    [client, observableClient],\n  );\n  return (\n    <OsdkContext2.Provider value={{ client, observableClient }}>\n      {children}\n    </OsdkContext2.Provider>\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SACEA,sBAAsB,QAEjB,kCAAkC;AACzC,OAAOC,KAAK,IAAIC,OAAO,QAAQ,OAAO;AACtC,SAASC,YAAY,QAAQ,mBAAmB;AAQhD,OAAO,SAASC,aAAaA,CAAC;EAC5BC,QAAQ;EACRC,MAAM;EACNC;AACmB,CAAC,EAAqB;EACzCA,gBAAgB,GAAGL,OAAO,CACxB,MAAMK,gBAAgB,IAAIP,sBAAsB,CAACM,MAAM,CAAC,EACxD,CAACA,MAAM,EAAEC,gBAAgB,CAC3B,CAAC;EACD,oBACEN,KAAA,CAAAO,aAAA,CAACL,YAAY,CAACM,QAAQ;IAACC,KAAK,EAAE;MAAEJ,MAAM;MAAEC;IAAiB;EAAE,GACxDF,QACoB,CAAC;AAE5B","ignoreList":[]}

package/build/browser/new/useOsdkAction.js

@@ -19,7 +19,7 @@ import React from "react";
 import { OsdkContext2 } from "./OsdkContext2.js";
 export function useOsdkAction(actionDef) {
   const {
-    store
+    observableClient
   } = React.useContext(OsdkContext2);
   const [error, setError] = React.useState();
   const [data, setData] = React.useState();
@@ -32,7 +32,7 @@ export function useOsdkAction(actionDef) {
     try {
       setPending(true);
       setError(undefined);
-      const r = await store.applyAction(actionDef, args, {
+      const r = await observableClient.applyAction(actionDef, args, {
         optimisticUpdate: $optimisticUpdate
       });
       setData(r);
@@ -50,7 +50,7 @@ export function useOsdkAction(actionDef) {
     } finally {
       setPending(false);
     }
-  }, [store, setError]);
+  }, [observableClient, setError]);
   return {
     applyAction,
     error,

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","store","useContext","error","setError","useState","data","setData","isPending","setPending","applyAction","useCallback","hookArgs","$optimisticUpdate","args","undefined","r","optimisticUpdate","e","actionValidation","unknown"],"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 } 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>,\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}\n\nexport function useOsdkAction<Q extends ActionDefinition<any>>(\n  actionDef: Q,\n): UseOsdkActionResult<Q> {\n  const { store } = 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\n  const applyAction = React.useCallback(async function applyAction(\n    hookArgs: ApplyActionParams<Q>,\n  ) {\n    const { $optimisticUpdate, ...args } = hookArgs;\n    try {\n      setPending(true);\n      setError(undefined);\n      const r = await store.applyAction(actionDef, args, {\n        optimisticUpdate: $optimisticUpdate,\n      });\n      setData(r);\n      return r;\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  }, [store, setError]);\n\n  return { applyAction, error, data, isPending };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,qBAAqB,QAAQ,cAAc;AAKpD,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,mBAAmB;AAyBhD,OAAO,SAASC,aAAaA,CAC3BC,SAAY,EACY;EACxB,MAAM;IAAEC;EAAM,CAAC,GAAGJ,KAAK,CAACK,UAAU,CAACJ,YAAY,CAAC;EAChD,MAAM,CAACK,KAAK,EAAEC,QAAQ,CAAC,GAAGP,KAAK,CAACQ,QAAQ,CAAkC,CAAC;EAC3E,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAGV,KAAK,CAACQ,QAAQ,CAAU,CAAC;EACjD,MAAM,CAACG,SAAS,EAAEC,UAAU,CAAC,GAAGZ,KAAK,CAACQ,QAAQ,CAAC,KAAK,CAAC;EAErD,MAAMK,WAAW,GAAGb,KAAK,CAACc,WAAW,CAAC,gBACpCC,QAA8B,EAC9B;IACA,MAAM;MAAEC,iBAAiB;MAAE,GAAGC;IAAK,CAAC,GAAGF,QAAQ;IAC/C,IAAI;MACFH,UAAU,CAAC,IAAI,CAAC;MAChBL,QAAQ,CAACW,SAAS,CAAC;MACnB,MAAMC,CAAC,GAAG,MAAMf,KAAK,CAACS,WAAW,CAACV,SAAS,EAAEc,IAAI,EAAE;QACjDG,gBAAgB,EAAEJ;MACpB,CAAC,CAAC;MACFN,OAAO,CAACS,CAAC,CAAC;MACV,OAAOA,CAAC;IACV,CAAC,CAAC,OAAOE,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYtB,qBAAqB,EAAE;QACtCQ,QAAQ,CAAC;UACPe,gBAAgB,EAAED;QACpB,CAAC,CAAC;MACJ,CAAC,MAAM;QACLd,QAAQ,CAAC;UAAEgB,OAAO,EAAEF;QAAE,CAAC,CAAC;MAC1B;IACF,CAAC,SAAS;MACRT,UAAU,CAAC,KAAK,CAAC;IACnB;EACF,CAAC,EAAE,CAACR,KAAK,EAAEG,QAAQ,CAAC,CAAC;EAErB,OAAO;IAAEM,WAAW;IAAEP,KAAK;IAAEG,IAAI;IAAEE;EAAU,CAAC;AAChD","ignoreList":[]}
+{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","observableClient","useContext","error","setError","useState","data","setData","isPending","setPending","applyAction","useCallback","hookArgs","$optimisticUpdate","args","undefined","r","optimisticUpdate","e","actionValidation","unknown"],"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 } 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>,\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}\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\n  const applyAction = React.useCallback(async function applyAction(\n    hookArgs: ApplyActionParams<Q>,\n  ) {\n    const { $optimisticUpdate, ...args } = hookArgs;\n    try {\n      setPending(true);\n      setError(undefined);\n      const r = await observableClient.applyAction(actionDef, args, {\n        optimisticUpdate: $optimisticUpdate,\n      });\n      setData(r);\n      return r;\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, setError]);\n\n  return { applyAction, error, data, isPending };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,qBAAqB,QAAQ,cAAc;AAKpD,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,mBAAmB;AAyBhD,OAAO,SAASC,aAAaA,CAC3BC,SAAY,EACY;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGJ,KAAK,CAACK,UAAU,CAACJ,YAAY,CAAC;EAC3D,MAAM,CAACK,KAAK,EAAEC,QAAQ,CAAC,GAAGP,KAAK,CAACQ,QAAQ,CAAkC,CAAC;EAC3E,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAGV,KAAK,CAACQ,QAAQ,CAAU,CAAC;EACjD,MAAM,CAACG,SAAS,EAAEC,UAAU,CAAC,GAAGZ,KAAK,CAACQ,QAAQ,CAAC,KAAK,CAAC;EAErD,MAAMK,WAAW,GAAGb,KAAK,CAACc,WAAW,CAAC,gBACpCC,QAA8B,EAC9B;IACA,MAAM;MAAEC,iBAAiB;MAAE,GAAGC;IAAK,CAAC,GAAGF,QAAQ;IAC/C,IAAI;MACFH,UAAU,CAAC,IAAI,CAAC;MAChBL,QAAQ,CAACW,SAAS,CAAC;MACnB,MAAMC,CAAC,GAAG,MAAMf,gBAAgB,CAACS,WAAW,CAACV,SAAS,EAAEc,IAAI,EAAE;QAC5DG,gBAAgB,EAAEJ;MACpB,CAAC,CAAC;MACFN,OAAO,CAACS,CAAC,CAAC;MACV,OAAOA,CAAC;IACV,CAAC,CAAC,OAAOE,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYtB,qBAAqB,EAAE;QACtCQ,QAAQ,CAAC;UACPe,gBAAgB,EAAED;QACpB,CAAC,CAAC;MACJ,CAAC,MAAM;QACLd,QAAQ,CAAC;UAAEgB,OAAO,EAAEF;QAAE,CAAC,CAAC;MAC1B;IACF,CAAC,SAAS;MACRT,UAAU,CAAC,KAAK,CAAC;IACnB;EACF,CAAC,EAAE,CAACR,gBAAgB,EAAEG,QAAQ,CAAC,CAAC;EAEhC,OAAO;IAAEM,WAAW;IAAEP,KAAK;IAAEG,IAAI;IAAEE;EAAU,CAAC;AAChD","ignoreList":[]}

package/build/browser/new/useOsdkObject.js

@@ -34,7 +34,7 @@ import { OsdkContext2 } from "./OsdkContext2.js";
  */
 export function useOsdkObject(...args) {
   const {
-    store
+    observableClient
   } = React.useContext(OsdkContext2);
 
   // TODO: Figure out what the correct default behavior is for the various scenarios
@@ -44,9 +44,9 @@ export function useOsdkObject(...args) {
   const {
     subscribe,
     getSnapShot
-  } = React.useMemo(() => makeExternalStore(payload => store.observeObject(objectType, primaryKey, {
+  } = React.useMemo(() => makeExternalStore(payload => observableClient.observeObject(objectType, primaryKey, {
     mode
-  }, payload), `object ${objectType} ${primaryKey}`), [store, objectType, primaryKey, mode]);
+  }, payload), `object ${objectType} ${primaryKey}`), [observableClient, objectType, primaryKey, mode]);
   const payload = React.useSyncExternalStore(subscribe, getSnapShot);
   return {
     object: payload?.object,

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","store","useContext","mode","length","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","payload","observeObject","useSyncExternalStore","object","isLoading","status","isOptimistic","forceUpdate"],"sources":["useOsdkObject.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectTypeDefinition, Osdk, PrimaryKeyType } from \"@osdk/api\";\nimport type { ObjectPayload } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args: [obj: Osdk.Instance<Q>] | [type: Q, primaryKey: PrimaryKeyType<Q>]\n): UseOsdkObjectResult<Q> {\n  const { store } = 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\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObjectPayload>((payload) =>\n        store.observeObject(\n          objectType,\n          primaryKey,\n          {\n            mode,\n          },\n          payload,\n        ), `object ${objectType} ${primaryKey}`),\n    [store, objectType, primaryKey, mode],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return {\n    object: payload?.object as Osdk.Instance<Q> | undefined,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    },\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;;AAahD;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAAwE,EACnD;EACxB,MAAM;IAAEC;EAAM,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAEhD;EACA,MAAMK,IAAI,GAAGH,IAAI,CAACI,MAAM,KAAK,CAAC,GAAG,SAAS,GAAGC,SAAS;EACtD,MAAMC,UAAU,GAAGN,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACO,WAAW,GAAGP,IAAI,CAAC,CAAC,CAAC,CAACQ,OAAO;EAC5E,MAAMC,UAAU,GAAGT,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACU,WAAW,GAAGV,IAAI,CAAC,CAAC,CAAC;EAEpE,MAAM;IAAEW,SAAS;IAAEC;EAAY,CAAC,GAAGhB,KAAK,CAACiB,OAAO,CAC9C,MACEhB,iBAAiB,CAAiBiB,OAAO,IACvCb,KAAK,CAACc,aAAa,CACjBT,UAAU,EACVG,UAAU,EACV;IACEN;EACF,CAAC,EACDW,OACF,CAAC,EAAE,UAAUR,UAAU,IAAIG,UAAU,EAAE,CAAC,EAC5C,CAACR,KAAK,EAAEK,UAAU,EAAEG,UAAU,EAAEN,IAAI,CACtC,CAAC;EAED,MAAMW,OAAO,GAAGlB,KAAK,CAACoB,oBAAoB,CAACL,SAAS,EAAEC,WAAW,CAAC;EAElE,OAAO;IACLK,MAAM,EAAEH,OAAO,EAAEG,MAAsC;IACvDC,SAAS,EAAEJ,OAAO,EAAEK,MAAM,KAAK,SAAS;IACxCC,YAAY,EAAEN,OAAO,EAAEM,YAAY,IAAI,KAAK;IAC5CC,WAAW,EAAEA,CAAA,KAAM;MACjB,MAAM,iBAAiB;IACzB;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","mode","length","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","payload","observeObject","useSyncExternalStore","object","isLoading","status","isOptimistic","forceUpdate"],"sources":["useOsdkObject.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectTypeDefinition, Osdk, PrimaryKeyType } from \"@osdk/api\";\nimport type { ObjectPayload } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args: [obj: Osdk.Instance<Q>] | [type: Q, primaryKey: PrimaryKeyType<Q>]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = 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\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObjectPayload>(\n        (payload) =>\n          observableClient.observeObject(\n            objectType,\n            primaryKey,\n            {\n              mode,\n            },\n            payload,\n          ),\n        `object ${objectType} ${primaryKey}`,\n      ),\n    [observableClient, objectType, primaryKey, mode],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return {\n    object: payload?.object as Osdk.Instance<Q> | undefined,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    },\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;;AAahD;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAAwE,EACnD;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAE3D;EACA,MAAMK,IAAI,GAAGH,IAAI,CAACI,MAAM,KAAK,CAAC,GAAG,SAAS,GAAGC,SAAS;EACtD,MAAMC,UAAU,GAAGN,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACO,WAAW,GAAGP,IAAI,CAAC,CAAC,CAAC,CAACQ,OAAO;EAC5E,MAAMC,UAAU,GAAGT,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACU,WAAW,GAAGV,IAAI,CAAC,CAAC,CAAC;EAEpE,MAAM;IAAEW,SAAS;IAAEC;EAAY,CAAC,GAAGhB,KAAK,CAACiB,OAAO,CAC9C,MACEhB,iBAAiB,CACdiB,OAAO,IACNb,gBAAgB,CAACc,aAAa,CAC5BT,UAAU,EACVG,UAAU,EACV;IACEN;EACF,CAAC,EACDW,OACF,CAAC,EACH,UAAUR,UAAU,IAAIG,UAAU,EACpC,CAAC,EACH,CAACR,gBAAgB,EAAEK,UAAU,EAAEG,UAAU,EAAEN,IAAI,CACjD,CAAC;EAED,MAAMW,OAAO,GAAGlB,KAAK,CAACoB,oBAAoB,CAACL,SAAS,EAAEC,WAAW,CAAC;EAElE,OAAO;IACLK,MAAM,EAAEH,OAAO,EAAEG,MAAsC;IACvDC,SAAS,EAAEJ,OAAO,EAAEK,MAAM,KAAK,SAAS;IACxCC,YAAY,EAAEN,OAAO,EAAEM,YAAY,IAAI,KAAK;IAC5CC,WAAW,EAAEA,CAAA,KAAM;MACjB,MAAM,iBAAiB;IACzB;EACF,CAAC;AACH","ignoreList":[]}

package/build/browser/new/{useOsdkList.js → useOsdkObjects.js}

@@ -17,40 +17,40 @@
 import React from "react";
 import { makeExternalStore } from "./makeExternalStore.js";
 import { OsdkContext2 } from "./OsdkContext2.js";
-export function useOsdkList(objectType, {
+export function useOsdkObjects(objectType, {
   pageSize,
   orderBy,
   dedupeIntervalMs,
-  where,
+  where = {},
   streamUpdates
-}) {
+} = {}) {
   const {
-    store
+    observableClient
   } = React.useContext(OsdkContext2);
 
   /*  We want the canonical where clause so that the use of `React.useMemo`
       is stable. No real added cost as we canonicalize internal to
       the ObservableClient anyway.
    */
-  const canonWhere = store.canonicalizeWhereClause(where ?? {});
+  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
   const {
     subscribe,
     getSnapShot
-  } = React.useMemo(() => makeExternalStore(x => store.observeList({
+  } = React.useMemo(() => makeExternalStore(x => observableClient.observeList({
     objectType,
     where: canonWhere,
     dedupeInterval: dedupeIntervalMs ?? 2_000,
     pageSize,
     orderBy,
     streamUpdates
-  }, x), process.env.NODE_ENV !== "production" ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}` : void 0), [store, objectType, canonWhere, dedupeIntervalMs]);
+  }, x), process.env.NODE_ENV !== "production" ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, objectType, canonWhere, dedupeIntervalMs]);
   const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);
+  // TODO: we need to expose the error in the result
   return {
     fetchMore: listPayload?.fetchMore,
     data: listPayload?.resolvedList,
     isLoading: listPayload?.status === "loading",
-    error: undefined,
     isOptimistic: listPayload?.isOptimistic ?? false
   };
 }
-//# sourceMappingURL=useOsdkList.js.map
+//# sourceMappingURL=useOsdkObjects.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOsdkObjects.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObjects","objectType","pageSize","orderBy","dedupeIntervalMs","where","streamUpdates","observableClient","useContext","canonWhere","canonicalizeWhereClause","subscribe","getSnapShot","useMemo","x","observeList","dedupeInterval","process","env","NODE_ENV","apiName","JSON","stringify","listPayload","useSyncExternalStore","fetchMore","data","resolvedList","isLoading","status","isOptimistic"],"sources":["useOsdkObjects.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/client\";\nimport type { ListPayload } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectsOptions<T extends ObjectTypeDefinition> {\n  /**\n   * Standard OSDK Where\n   */\n  where?: WhereClause<T>;\n\n  /**\n   *  The preferred page size for the list.\n   */\n  pageSize?: number;\n\n  /** */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * Causes the list to automatically fetch more as soon as the previous page\n   * has been loaded. If a number is provided, it will continue to automatically\n   * fetch more until the list is at least that long.\n   */\n  // autoFetchMore?: boolean | number;\n\n  /**\n   * Upon a list being revalidated, this option determines how the component\n   * will be re-rendered with the data.\n   *\n   * An example to help understand the options:\n   *\n   * Suppose pageSize is 10 and we have called `fetchMore()` twice. The list is\n   * now 30 items long.\n   *\n   * Upon revalidation, we get the first 10 items of the list. The options behave\n   * as follows:\n   *\n   * - `\"in-place\"`: The first 10 items of the list are replaced with the new 10\n   *   items. The list is now 30 items long, but only the first 10 items are valid.\n   * - `\"wait\"`: The old list is returned until after the next 20 items are loaded\n   *   (which will happen automatically). The list is now 30 items long.\n   * - `\"reset\"`: The entire list is replaced with the new 10 items. The list is\n   *   now 10 items long.\n   */\n  // invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n\n  /**\n   * The number of milliseconds to wait after the last observed list change.\n   *\n   * Two uses of `useOsdkObjects` with the where clause will only trigger one\n   * network request if the second is within `dedupeIntervalMs`.\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * If provided, the list will be considered this length for the purposes of\n   * `invalidationMode` when using the `wait` option. If not provided,\n   * the internal expectedLength will be determined by the number of times\n   * `fetchMore` has been called.\n   */\n  // expectedLength?: number | undefined;\n\n  streamUpdates?: boolean;\n}\n\nexport interface UseOsdkListResult<T extends ObjectTypeDefinition> {\n  fetchMore: (() => Promise<unknown>) | undefined;\n  data: Osdk.Instance<T>[] | undefined;\n  isLoading: boolean;\n\n  // FIXME populate error!\n  // error: undefined;\n\n  /**\n   * Refers to whether the ordered list of objects (only considering the $primaryKey)\n   * is optimistic or not.\n   *\n   * If you need to know if the contents of the list are optimistic you can\n   * do that on a per object basis with useOsdkObject\n   */\n  isOptimistic: boolean;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\nexport function useOsdkObjects<T extends ObjectTypeDefinition>(\n  objectType: T,\n  {\n    pageSize,\n    orderBy,\n    dedupeIntervalMs,\n    where = {},\n    streamUpdates,\n  }: UseOsdkObjectsOptions<T> = {},\n): UseOsdkListResult<T> {\n  const { observableClient } = 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\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ListPayload>(\n        (x) =>\n          observableClient.observeList({\n            objectType,\n            where: canonWhere,\n            dedupeInterval: dedupeIntervalMs ?? 2_000,\n            pageSize,\n            orderBy,\n            streamUpdates,\n          }, x),\n        process.env.NODE_ENV !== \"production\"\n          ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}`\n          : void 0,\n      ),\n    [observableClient, objectType, canonWhere, dedupeIntervalMs],\n  );\n\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    data: listPayload?.resolvedList as Osdk.Instance<T>[],\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAyFhD,OAAO,SAASC,cAAcA,CAC5BC,UAAa,EACb;EACEC,QAAQ;EACRC,OAAO;EACPC,gBAAgB;EAChBC,KAAK,GAAG,CAAC,CAAC;EACVC;AACwB,CAAC,GAAG,CAAC,CAAC,EACV;EACtB,MAAM;IAAEC;EAAiB,CAAC,GAAGV,KAAK,CAACW,UAAU,CAACT,YAAY,CAAC;;EAE3D;AACF;AACA;AACA;EACE,MAAMU,UAAU,GAAGF,gBAAgB,CAACG,uBAAuB,CAACL,KAAK,IAAI,CAAC,CAAC,CAAC;EAExE,MAAM;IAAEM,SAAS;IAAEC;EAAY,CAAC,GAAGf,KAAK,CAACgB,OAAO,CAC9C,MACEf,iBAAiB,CACdgB,CAAC,IACAP,gBAAgB,CAACQ,WAAW,CAAC;IAC3Bd,UAAU;IACVI,KAAK,EAAEI,UAAU;IACjBO,cAAc,EAAEZ,gBAAgB,IAAI,KAAK;IACzCF,QAAQ;IACRC,OAAO;IACPG;EACF,CAAC,EAAEQ,CAAC,CAAC,EACPG,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,QAAQlB,UAAU,CAACmB,OAAO,IAAIC,IAAI,CAACC,SAAS,CAACb,UAAU,CAAC,EAAE,GAC1D,KAAK,CACX,CAAC,EACH,CAACF,gBAAgB,EAAEN,UAAU,EAAEQ,UAAU,EAAEL,gBAAgB,CAC7D,CAAC;EAED,MAAMmB,WAAW,GAAG1B,KAAK,CAAC2B,oBAAoB,CAACb,SAAS,EAAEC,WAAW,CAAC;EACtE;EACA,OAAO;IACLa,SAAS,EAAEF,WAAW,EAAEE,SAAS;IACjCC,IAAI,EAAEH,WAAW,EAAEI,YAAkC;IACrDC,SAAS,EAAEL,WAAW,EAAEM,MAAM,KAAK,SAAS;IAC5CC,YAAY,EAAEP,WAAW,EAAEO,YAAY,IAAI;EAC7C,CAAC;AACH","ignoreList":[]}

package/build/browser/public/experimental.js

@@ -16,7 +16,7 @@
 
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
-export { useOsdkList } from "../new/useOsdkList.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
+export { useOsdkObjects } from "../new/useOsdkObjects.js";
 export { useOsdkClient } from "../useOsdkClient.js";
 //# sourceMappingURL=experimental.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["OsdkProvider2","useOsdkAction","useOsdkList","useOsdkObject","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 { useOsdkList } from \"../new/useOsdkList.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.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,WAAW,QAAQ,uBAAuB;AACnD,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,qBAAqB","ignoreList":[]}
+{"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":[]}

package/build/cjs/public/experimental.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var chunk2N32USW5_cjs = require('../chunk-2N32USW5.cjs');
+var unstableDoNotUse = require('@osdk/client/unstable-do-not-use');
 var React3 = require('react');
 var client = require('@osdk/client');
 
@@ -16,25 +17,26 @@ var fakeClient = Object.assign(fakeClientFn, {
 });
 var OsdkContext2 = /* @__PURE__ */ React3__default.default.createContext({
   client: fakeClient,
-  store: undefined
+  observableClient: undefined
 });
 
 // src/new/OsdkProvider2.tsx
 function OsdkProvider2({
   children,
   client,
-  store
+  observableClient
 }) {
+  observableClient = React3.useMemo(() => observableClient ?? unstableDoNotUse.createObservableClient(client), [client, observableClient]);
   return /* @__PURE__ */ React3__default.default.createElement(OsdkContext2.Provider, {
     value: {
       client,
-      store
+      observableClient
     }
   }, children);
 }
 function useOsdkAction(actionDef) {
   const {
-    store
+    observableClient
   } = React3__default.default.useContext(OsdkContext2);
   const [error, setError] = React3__default.default.useState();
   const [data, setData] = React3__default.default.useState();
@@ -47,7 +49,7 @@ function useOsdkAction(actionDef) {
     try {
       setPending(true);
       setError(void 0);
-      const r = await store.applyAction(actionDef, args, {
+      const r = await observableClient.applyAction(actionDef, args, {
         optimisticUpdate: $optimisticUpdate
       });
       setData(r);
@@ -65,7 +67,7 @@ function useOsdkAction(actionDef) {
     } finally {
       setPending(false);
     }
-  }, [store, setError]);
+  }, [observableClient, setError]);
   return {
     applyAction,
     error,
@@ -95,61 +97,60 @@ function makeExternalStore(createObservation, name) {
   };
 }
 
-// src/new/useOsdkList.ts
-function useOsdkList(objectType, {
+// src/new/useOsdkObject.ts
+function useOsdkObject(...args) {
+  const {
+    observableClient
+  } = React3__default.default.useContext(OsdkContext2);
+  const mode = args.length === 1 ? "offline" : undefined;
+  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((payload2) => observableClient.observeObject(objectType, primaryKey, {
+    mode
+  }, payload2)), [observableClient, objectType, primaryKey, mode]);
+  const payload = React3__default.default.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    object: payload?.object,
+    isLoading: payload?.status === "loading",
+    isOptimistic: payload?.isOptimistic ?? false,
+    forceUpdate: () => {
+      throw "not implemented";
+    }
+  };
+}
+function useOsdkObjects(objectType, {
   pageSize,
   orderBy,
   dedupeIntervalMs,
-  where,
+  where = {},
   streamUpdates
-}) {
+} = {}) {
   const {
-    store
+    observableClient
   } = React3__default.default.useContext(OsdkContext2);
-  const canonWhere = store.canonicalizeWhereClause(where ?? {});
+  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
   const {
     subscribe,
     getSnapShot
-  } = React3__default.default.useMemo(() => makeExternalStore((x) => store.observeList({
+  } = React3__default.default.useMemo(() => makeExternalStore((x) => observableClient.observeList({
     objectType,
     where: canonWhere,
     dedupeInterval: dedupeIntervalMs ?? 2e3,
     pageSize,
     orderBy,
     streamUpdates
-  }, x), process.env.NODE_ENV !== "production" ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}` : undefined), [store, objectType, canonWhere, dedupeIntervalMs]);
+  }, x), process.env.NODE_ENV !== "production" ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}` : undefined), [observableClient, objectType, canonWhere, dedupeIntervalMs]);
   const listPayload = React3__default.default.useSyncExternalStore(subscribe, getSnapShot);
   return {
     fetchMore: listPayload?.fetchMore,
     data: listPayload?.resolvedList,
     isLoading: listPayload?.status === "loading",
-    error: undefined,
     isOptimistic: listPayload?.isOptimistic ?? false
   };
 }
-function useOsdkObject(...args) {
-  const {
-    store
-  } = React3__default.default.useContext(OsdkContext2);
-  const mode = args.length === 1 ? "offline" : undefined;
-  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((payload2) => store.observeObject(objectType, primaryKey, {
-    mode
-  }, payload2)), [store, objectType, primaryKey, mode]);
-  const payload = React3__default.default.useSyncExternalStore(subscribe, getSnapShot);
-  return {
-    object: payload?.object,
-    isLoading: payload?.status === "loading",
-    isOptimistic: payload?.isOptimistic ?? false,
-    forceUpdate: () => {
-      throw "not implemented";
-    }
-  };
-}
 
 Object.defineProperty(exports, "useOsdkClient", {
   enumerable: true,
@@ -157,7 +158,7 @@ Object.defineProperty(exports, "useOsdkClient", {
 });
 exports.OsdkProvider2 = OsdkProvider2;
 exports.useOsdkAction = useOsdkAction;
-exports.useOsdkList = useOsdkList;
 exports.useOsdkObject = useOsdkObject;
+exports.useOsdkObjects = useOsdkObjects;
 //# sourceMappingURL=experimental.cjs.map
 //# sourceMappingURL=experimental.cjs.map

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/useOsdkList.ts","../../../src/new/useOsdkObject.ts"],"names":["React","applyAction","ActionValidationError","payload"],"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  store: 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 React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\nexport function OsdkProvider2({\n  children,\n  client,\n  store\n}) {\n  return /*#__PURE__*/React.createElement(OsdkContext2.Provider, {\n    value: {\n      client,\n      store\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    store\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 applyAction = React.useCallback(async function applyAction(hookArgs) {\n    const {\n      $optimisticUpdate,\n      ...args\n    } = hookArgs;\n    try {\n      setPending(true);\n      setError(undefined);\n      const r = await store.applyAction(actionDef, args, {\n        optimisticUpdate: $optimisticUpdate\n      });\n      setData(r);\n      return r;\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  }, [store, setError]);\n  return {\n    applyAction,\n    error,\n    data,\n    isPending\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(payload => {\n      lastResult = payload;\n      notifyUpdate();\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\";\nexport function useOsdkList(objectType, {\n  pageSize,\n  orderBy,\n  dedupeIntervalMs,\n  where,\n  streamUpdates\n}) {\n  const {\n    store\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 = store.canonicalizeWhereClause(where ?? {});\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(x => store.observeList({\n    objectType,\n    where: canonWhere,\n    dedupeInterval: dedupeIntervalMs ?? 2_000,\n    pageSize,\n    orderBy,\n    streamUpdates\n  }, x), process.env.NODE_ENV !== \"production\" ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}` : void 0), [store, objectType, canonWhere, dedupeIntervalMs]);\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n  return {\n    fetchMore: listPayload?.fetchMore,\n    data: listPayload?.resolvedList,\n    isLoading: listPayload?.status === \"loading\",\n    error: undefined,\n    isOptimistic: listPayload?.isOptimistic ?? 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 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    store\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(payload => store.observeObject(objectType, primaryKey, {\n    mode\n  }, payload), `object ${objectType} ${primaryKey}`), [store, 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 ?? false,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    }\n  };\n}"]}
+{"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","applyAction","ActionValidationError","payload"],"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 { 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  }, 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 applyAction = React.useCallback(async function applyAction(hookArgs) {\n    const {\n      $optimisticUpdate,\n      ...args\n    } = hookArgs;\n    try {\n      setPending(true);\n      setError(undefined);\n      const r = await observableClient.applyAction(actionDef, args, {\n        optimisticUpdate: $optimisticUpdate\n      });\n      setData(r);\n      return r;\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, setError]);\n  return {\n    applyAction,\n    error,\n    data,\n    isPending\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(payload => {\n      lastResult = payload;\n      notifyUpdate();\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(payload => observableClient.observeObject(objectType, primaryKey, {\n    mode\n  }, payload), `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 ?? false,\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(objectType, {\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(x => observableClient.observeList({\n    objectType,\n    where: canonWhere,\n    dedupeInterval: dedupeIntervalMs ?? 2_000,\n    pageSize,\n    orderBy,\n    streamUpdates\n  }, x), process.env.NODE_ENV !== \"production\" ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, objectType, 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    data: listPayload?.resolvedList,\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false\n  };\n}"]}

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

@@ -1,15 +1,15 @@
-import { Client, ActionDefinition, ActionValidationError, ObjectTypeDefinition, WhereClause, PropertyKeys, Osdk } from '@osdk/client';
+import { Client, ActionDefinition, ActionValidationError, ObjectTypeDefinition as ObjectTypeDefinition$1, WhereClause, PropertyKeys, Osdk as Osdk$1 } from '@osdk/client';
 import { ObservableClient, ActionSignatureFromDef } from '@osdk/client/unstable-do-not-use';
 import React from 'react';
-import { ObjectTypeDefinition as ObjectTypeDefinition$1, Osdk as Osdk$1, PrimaryKeyType } from '@osdk/api';
+import { ObjectTypeDefinition, Osdk, PrimaryKeyType } from '@osdk/api';
 export { u as useOsdkClient } from '../useOsdkClient-B4iwHO1H.cjs';
 
 interface OsdkProviderOptions {
     children: React.ReactNode;
     client: Client;
-    store: ObservableClient;
+    observableClient?: ObservableClient;
 }
-declare function OsdkProvider2({ children, client, store, }: OsdkProviderOptions): React.JSX.Element;
+declare function OsdkProvider2({ children, client, observableClient, }: OsdkProviderOptions): React.JSX.Element;
 
 type ApplyActionParams<Q extends ActionDefinition<any>> = Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0] & {
     [K in keyof ObservableClient.ApplyActionOptions as `$${K}`]: ObservableClient.ApplyActionOptions[K];
@@ -25,7 +25,28 @@ interface UseOsdkActionResult<Q extends ActionDefinition<any>> {
 }
 declare function useOsdkAction<Q extends ActionDefinition<any>>(actionDef: Q): UseOsdkActionResult<Q>;
 
-interface UseOsdkListOptions<T extends ObjectTypeDefinition> {
+interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {
+    object: Osdk.Instance<Q> | undefined;
+    isLoading: boolean;
+    /**
+     * Refers to whether the object is optimistic or not.
+     */
+    isOptimistic: boolean;
+    forceUpdate: () => void;
+}
+/**
+ * @param obj an existing `Osdk.Instance` object to get metadata for.
+ */
+declare function useOsdkObject<Q extends ObjectTypeDefinition>(obj: Osdk.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>;
+
+interface UseOsdkObjectsOptions<T extends ObjectTypeDefinition$1> {
     /**
      * Standard OSDK Where
      */
@@ -65,7 +86,7 @@ interface UseOsdkListOptions<T extends ObjectTypeDefinition> {
     /**
      * The number of milliseconds to wait after the last observed list change.
      *
-     * Two uses of `useOsdkList` with the where clause will only trigger one
+     * Two uses of `useOsdkObjects` with the where clause will only trigger one
      * network request if the second is within `dedupeIntervalMs`.
      */
     dedupeIntervalMs?: number;
@@ -77,11 +98,10 @@ interface UseOsdkListOptions<T extends ObjectTypeDefinition> {
      */
     streamUpdates?: boolean;
 }
-interface UseOsdkListResult<T extends ObjectTypeDefinition> {
+interface UseOsdkListResult<T extends ObjectTypeDefinition$1> {
     fetchMore: (() => Promise<unknown>) | undefined;
-    data: Osdk.Instance<T>[];
+    data: Osdk$1.Instance<T>[] | undefined;
     isLoading: boolean;
-    error: undefined;
     /**
      * Refers to whether the ordered list of objects (only considering the $primaryKey)
      * is optimistic or not.
@@ -91,27 +111,6 @@ interface UseOsdkListResult<T extends ObjectTypeDefinition> {
      */
     isOptimistic: boolean;
 }
-declare function useOsdkList<T extends ObjectTypeDefinition>(objectType: T, { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates }: UseOsdkListOptions<T>): UseOsdkListResult<T>;
-
-interface UseOsdkObjectResult<Q extends ObjectTypeDefinition$1> {
-    object: Osdk$1.Instance<Q> | undefined;
-    isLoading: boolean;
-    /**
-     * Refers to whether the object is optimistic or not.
-     */
-    isOptimistic: boolean;
-    forceUpdate: () => void;
-}
-/**
- * @param obj an existing `Osdk.Instance` object to get metadata for.
- */
-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$1>(type: Q, primaryKey: PrimaryKeyType<Q>): UseOsdkObjectResult<Q>;
+declare function useOsdkObjects<T extends ObjectTypeDefinition$1>(objectType: T, { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates, }?: UseOsdkObjectsOptions<T>): UseOsdkListResult<T>;
 
-export { OsdkProvider2, useOsdkAction, useOsdkList, useOsdkObject };
+export { OsdkProvider2, useOsdkAction, useOsdkObject, useOsdkObjects };

package/build/esm/new/OsdkContext2.js

@@ -23,6 +23,6 @@ const fakeClient = Object.assign(fakeClientFn, {
 });
 export const OsdkContext2 = /*#__PURE__*/React.createContext({
   client: fakeClient,
-  store: undefined
+  observableClient: undefined
 });
 //# sourceMappingURL=OsdkContext2.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"OsdkContext2.js","names":["React","fakeClientFn","_args","Error","fakeClient","Object","assign","fetchMetadata","OsdkContext2","createContext","client","store","undefined"],"sources":["OsdkContext2.ts"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Client } from \"@osdk/client\";\nimport type { ObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\n\nfunction fakeClientFn(..._args: any[]) {\n  throw new Error(\n    \"This is not a real client. Did you forget to <OsdkContext.Provider>?\",\n  );\n}\n\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn,\n} as Client);\n\ninterface OsdkContextContents {\n  client: Client;\n  // keeping the old name for now intentionally\n  // in case i need both for a while\n  // in the future we can just make\n  // this `client: ObservableClient`\n  store: ObservableClient;\n}\n\nexport const OsdkContext2: React.Context<OsdkContextContents> = React\n  .createContext<OsdkContextContents>({\n    client: fakeClient,\n    store: undefined!,\n  });\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AAEzB,SAASC,YAAYA,CAAC,GAAGC,KAAY,EAAE;EACrC,MAAM,IAAIC,KAAK,CACb,sEACF,CAAC;AACH;AAEA,MAAMC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAACL,YAAY,EAAE;EAC7CM,aAAa,EAAEN;AACjB,CAAW,CAAC;AAWZ,OAAO,MAAMO,YAAgD,gBAAGR,KAAK,CAClES,aAAa,CAAsB;EAClCC,MAAM,EAAEN,UAAU;EAClBO,KAAK,EAAEC;AACT,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"OsdkContext2.js","names":["React","fakeClientFn","_args","Error","fakeClient","Object","assign","fetchMetadata","OsdkContext2","createContext","client","observableClient","undefined"],"sources":["OsdkContext2.ts"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Client } from \"@osdk/client\";\nimport type { ObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\n\nfunction fakeClientFn(..._args: any[]) {\n  throw new Error(\n    \"This is not a real client. Did you forget to <OsdkContext.Provider>?\",\n  );\n}\n\nconst fakeClient = Object.assign(fakeClientFn, {\n  fetchMetadata: fakeClientFn,\n} as Client);\n\ninterface OsdkContextContents {\n  client: Client;\n  // keeping the old name for now intentionally\n  // in case i need both for a while\n  // in the future we can just make\n  // this `client: ObservableClient`\n  observableClient: ObservableClient;\n}\n\nexport const OsdkContext2: React.Context<OsdkContextContents> = React\n  .createContext<OsdkContextContents>({\n    client: fakeClient,\n    observableClient: undefined!,\n  });\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AAEzB,SAASC,YAAYA,CAAC,GAAGC,KAAY,EAAE;EACrC,MAAM,IAAIC,KAAK,CACb,sEACF,CAAC;AACH;AAEA,MAAMC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAACL,YAAY,EAAE;EAC7CM,aAAa,EAAEN;AACjB,CAAW,CAAC;AAWZ,OAAO,MAAMO,YAAgD,gBAAGR,KAAK,CAClES,aAAa,CAAsB;EAClCC,MAAM,EAAEN,UAAU;EAClBO,gBAAgB,EAAEC;AACpB,CAAC,CAAC","ignoreList":[]}

package/build/esm/new/OsdkProvider2.js

@@ -14,17 +14,19 @@
  * limitations under the License.
  */
 
-import React from "react";
+import { createObservableClient } from "@osdk/client/unstable-do-not-use";
+import React, { useMemo } from "react";
 import { OsdkContext2 } from "./OsdkContext2.js";
 export function OsdkProvider2({
   children,
   client,
-  store
+  observableClient
 }) {
+  observableClient = useMemo(() => observableClient ?? createObservableClient(client), [client, observableClient]);
   return /*#__PURE__*/React.createElement(OsdkContext2.Provider, {
     value: {
       client,
-      store
+      observableClient
     }
   }, children);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"OsdkProvider2.js","names":["React","OsdkContext2","OsdkProvider2","children","client","store","createElement","Provider","value"],"sources":["OsdkProvider2.tsx"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Client } from \"@osdk/client\";\nimport type { ObservableClient } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ninterface OsdkProviderOptions {\n  children: React.ReactNode;\n  client: Client;\n  store: ObservableClient;\n}\n\nexport function OsdkProvider2({\n  children,\n  client,\n  store,\n}: OsdkProviderOptions): React.JSX.Element {\n  return (\n    <OsdkContext2.Provider value={{ client, store }}>\n      {children}\n    </OsdkContext2.Provider>\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,mBAAmB;AAQhD,OAAO,SAASC,aAAaA,CAAC;EAC5BC,QAAQ;EACRC,MAAM;EACNC;AACmB,CAAC,EAAqB;EACzC,oBACEL,KAAA,CAAAM,aAAA,CAACL,YAAY,CAACM,QAAQ;IAACC,KAAK,EAAE;MAAEJ,MAAM;MAAEC;IAAM;EAAE,GAC7CF,QACoB,CAAC;AAE5B","ignoreList":[]}
+{"version":3,"file":"OsdkProvider2.js","names":["createObservableClient","React","useMemo","OsdkContext2","OsdkProvider2","children","client","observableClient","createElement","Provider","value"],"sources":["OsdkProvider2.tsx"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Client } from \"@osdk/client\";\nimport {\n  createObservableClient,\n  type ObservableClient,\n} from \"@osdk/client/unstable-do-not-use\";\nimport React, { useMemo } from \"react\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\ninterface OsdkProviderOptions {\n  children: React.ReactNode;\n  client: Client;\n  observableClient?: ObservableClient;\n}\n\nexport function OsdkProvider2({\n  children,\n  client,\n  observableClient,\n}: OsdkProviderOptions): React.JSX.Element {\n  observableClient = useMemo(\n    () => observableClient ?? createObservableClient(client),\n    [client, observableClient],\n  );\n  return (\n    <OsdkContext2.Provider value={{ client, observableClient }}>\n      {children}\n    </OsdkContext2.Provider>\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SACEA,sBAAsB,QAEjB,kCAAkC;AACzC,OAAOC,KAAK,IAAIC,OAAO,QAAQ,OAAO;AACtC,SAASC,YAAY,QAAQ,mBAAmB;AAQhD,OAAO,SAASC,aAAaA,CAAC;EAC5BC,QAAQ;EACRC,MAAM;EACNC;AACmB,CAAC,EAAqB;EACzCA,gBAAgB,GAAGL,OAAO,CACxB,MAAMK,gBAAgB,IAAIP,sBAAsB,CAACM,MAAM,CAAC,EACxD,CAACA,MAAM,EAAEC,gBAAgB,CAC3B,CAAC;EACD,oBACEN,KAAA,CAAAO,aAAA,CAACL,YAAY,CAACM,QAAQ;IAACC,KAAK,EAAE;MAAEJ,MAAM;MAAEC;IAAiB;EAAE,GACxDF,QACoB,CAAC;AAE5B","ignoreList":[]}

package/build/esm/new/useOsdkAction.js

@@ -19,7 +19,7 @@ import React from "react";
 import { OsdkContext2 } from "./OsdkContext2.js";
 export function useOsdkAction(actionDef) {
   const {
-    store
+    observableClient
   } = React.useContext(OsdkContext2);
   const [error, setError] = React.useState();
   const [data, setData] = React.useState();
@@ -32,7 +32,7 @@ export function useOsdkAction(actionDef) {
     try {
       setPending(true);
       setError(undefined);
-      const r = await store.applyAction(actionDef, args, {
+      const r = await observableClient.applyAction(actionDef, args, {
         optimisticUpdate: $optimisticUpdate
       });
       setData(r);
@@ -50,7 +50,7 @@ export function useOsdkAction(actionDef) {
     } finally {
       setPending(false);
     }
-  }, [store, setError]);
+  }, [observableClient, setError]);
   return {
     applyAction,
     error,

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","store","useContext","error","setError","useState","data","setData","isPending","setPending","applyAction","useCallback","hookArgs","$optimisticUpdate","args","undefined","r","optimisticUpdate","e","actionValidation","unknown"],"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 } 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>,\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}\n\nexport function useOsdkAction<Q extends ActionDefinition<any>>(\n  actionDef: Q,\n): UseOsdkActionResult<Q> {\n  const { store } = 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\n  const applyAction = React.useCallback(async function applyAction(\n    hookArgs: ApplyActionParams<Q>,\n  ) {\n    const { $optimisticUpdate, ...args } = hookArgs;\n    try {\n      setPending(true);\n      setError(undefined);\n      const r = await store.applyAction(actionDef, args, {\n        optimisticUpdate: $optimisticUpdate,\n      });\n      setData(r);\n      return r;\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  }, [store, setError]);\n\n  return { applyAction, error, data, isPending };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,qBAAqB,QAAQ,cAAc;AAKpD,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,mBAAmB;AAyBhD,OAAO,SAASC,aAAaA,CAC3BC,SAAY,EACY;EACxB,MAAM;IAAEC;EAAM,CAAC,GAAGJ,KAAK,CAACK,UAAU,CAACJ,YAAY,CAAC;EAChD,MAAM,CAACK,KAAK,EAAEC,QAAQ,CAAC,GAAGP,KAAK,CAACQ,QAAQ,CAAkC,CAAC;EAC3E,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAGV,KAAK,CAACQ,QAAQ,CAAU,CAAC;EACjD,MAAM,CAACG,SAAS,EAAEC,UAAU,CAAC,GAAGZ,KAAK,CAACQ,QAAQ,CAAC,KAAK,CAAC;EAErD,MAAMK,WAAW,GAAGb,KAAK,CAACc,WAAW,CAAC,gBACpCC,QAA8B,EAC9B;IACA,MAAM;MAAEC,iBAAiB;MAAE,GAAGC;IAAK,CAAC,GAAGF,QAAQ;IAC/C,IAAI;MACFH,UAAU,CAAC,IAAI,CAAC;MAChBL,QAAQ,CAACW,SAAS,CAAC;MACnB,MAAMC,CAAC,GAAG,MAAMf,KAAK,CAACS,WAAW,CAACV,SAAS,EAAEc,IAAI,EAAE;QACjDG,gBAAgB,EAAEJ;MACpB,CAAC,CAAC;MACFN,OAAO,CAACS,CAAC,CAAC;MACV,OAAOA,CAAC;IACV,CAAC,CAAC,OAAOE,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYtB,qBAAqB,EAAE;QACtCQ,QAAQ,CAAC;UACPe,gBAAgB,EAAED;QACpB,CAAC,CAAC;MACJ,CAAC,MAAM;QACLd,QAAQ,CAAC;UAAEgB,OAAO,EAAEF;QAAE,CAAC,CAAC;MAC1B;IACF,CAAC,SAAS;MACRT,UAAU,CAAC,KAAK,CAAC;IACnB;EACF,CAAC,EAAE,CAACR,KAAK,EAAEG,QAAQ,CAAC,CAAC;EAErB,OAAO;IAAEM,WAAW;IAAEP,KAAK;IAAEG,IAAI;IAAEE;EAAU,CAAC;AAChD","ignoreList":[]}
+{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","observableClient","useContext","error","setError","useState","data","setData","isPending","setPending","applyAction","useCallback","hookArgs","$optimisticUpdate","args","undefined","r","optimisticUpdate","e","actionValidation","unknown"],"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 } 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>,\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}\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\n  const applyAction = React.useCallback(async function applyAction(\n    hookArgs: ApplyActionParams<Q>,\n  ) {\n    const { $optimisticUpdate, ...args } = hookArgs;\n    try {\n      setPending(true);\n      setError(undefined);\n      const r = await observableClient.applyAction(actionDef, args, {\n        optimisticUpdate: $optimisticUpdate,\n      });\n      setData(r);\n      return r;\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, setError]);\n\n  return { applyAction, error, data, isPending };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,qBAAqB,QAAQ,cAAc;AAKpD,OAAOC,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,mBAAmB;AAyBhD,OAAO,SAASC,aAAaA,CAC3BC,SAAY,EACY;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGJ,KAAK,CAACK,UAAU,CAACJ,YAAY,CAAC;EAC3D,MAAM,CAACK,KAAK,EAAEC,QAAQ,CAAC,GAAGP,KAAK,CAACQ,QAAQ,CAAkC,CAAC;EAC3E,MAAM,CAACC,IAAI,EAAEC,OAAO,CAAC,GAAGV,KAAK,CAACQ,QAAQ,CAAU,CAAC;EACjD,MAAM,CAACG,SAAS,EAAEC,UAAU,CAAC,GAAGZ,KAAK,CAACQ,QAAQ,CAAC,KAAK,CAAC;EAErD,MAAMK,WAAW,GAAGb,KAAK,CAACc,WAAW,CAAC,gBACpCC,QAA8B,EAC9B;IACA,MAAM;MAAEC,iBAAiB;MAAE,GAAGC;IAAK,CAAC,GAAGF,QAAQ;IAC/C,IAAI;MACFH,UAAU,CAAC,IAAI,CAAC;MAChBL,QAAQ,CAACW,SAAS,CAAC;MACnB,MAAMC,CAAC,GAAG,MAAMf,gBAAgB,CAACS,WAAW,CAACV,SAAS,EAAEc,IAAI,EAAE;QAC5DG,gBAAgB,EAAEJ;MACpB,CAAC,CAAC;MACFN,OAAO,CAACS,CAAC,CAAC;MACV,OAAOA,CAAC;IACV,CAAC,CAAC,OAAOE,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYtB,qBAAqB,EAAE;QACtCQ,QAAQ,CAAC;UACPe,gBAAgB,EAAED;QACpB,CAAC,CAAC;MACJ,CAAC,MAAM;QACLd,QAAQ,CAAC;UAAEgB,OAAO,EAAEF;QAAE,CAAC,CAAC;MAC1B;IACF,CAAC,SAAS;MACRT,UAAU,CAAC,KAAK,CAAC;IACnB;EACF,CAAC,EAAE,CAACR,gBAAgB,EAAEG,QAAQ,CAAC,CAAC;EAEhC,OAAO;IAAEM,WAAW;IAAEP,KAAK;IAAEG,IAAI;IAAEE;EAAU,CAAC;AAChD","ignoreList":[]}

package/build/esm/new/useOsdkObject.js

@@ -34,7 +34,7 @@ import { OsdkContext2 } from "./OsdkContext2.js";
  */
 export function useOsdkObject(...args) {
   const {
-    store
+    observableClient
   } = React.useContext(OsdkContext2);
 
   // TODO: Figure out what the correct default behavior is for the various scenarios
@@ -44,9 +44,9 @@ export function useOsdkObject(...args) {
   const {
     subscribe,
     getSnapShot
-  } = React.useMemo(() => makeExternalStore(payload => store.observeObject(objectType, primaryKey, {
+  } = React.useMemo(() => makeExternalStore(payload => observableClient.observeObject(objectType, primaryKey, {
     mode
-  }, payload), `object ${objectType} ${primaryKey}`), [store, objectType, primaryKey, mode]);
+  }, payload), `object ${objectType} ${primaryKey}`), [observableClient, objectType, primaryKey, mode]);
   const payload = React.useSyncExternalStore(subscribe, getSnapShot);
   return {
     object: payload?.object,

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

@@ -1 +1 @@
-{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","store","useContext","mode","length","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","payload","observeObject","useSyncExternalStore","object","isLoading","status","isOptimistic","forceUpdate"],"sources":["useOsdkObject.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectTypeDefinition, Osdk, PrimaryKeyType } from \"@osdk/api\";\nimport type { ObjectPayload } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args: [obj: Osdk.Instance<Q>] | [type: Q, primaryKey: PrimaryKeyType<Q>]\n): UseOsdkObjectResult<Q> {\n  const { store } = 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\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObjectPayload>((payload) =>\n        store.observeObject(\n          objectType,\n          primaryKey,\n          {\n            mode,\n          },\n          payload,\n        ), `object ${objectType} ${primaryKey}`),\n    [store, objectType, primaryKey, mode],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return {\n    object: payload?.object as Osdk.Instance<Q> | undefined,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    },\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;;AAahD;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAAwE,EACnD;EACxB,MAAM;IAAEC;EAAM,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAEhD;EACA,MAAMK,IAAI,GAAGH,IAAI,CAACI,MAAM,KAAK,CAAC,GAAG,SAAS,GAAGC,SAAS;EACtD,MAAMC,UAAU,GAAGN,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACO,WAAW,GAAGP,IAAI,CAAC,CAAC,CAAC,CAACQ,OAAO;EAC5E,MAAMC,UAAU,GAAGT,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACU,WAAW,GAAGV,IAAI,CAAC,CAAC,CAAC;EAEpE,MAAM;IAAEW,SAAS;IAAEC;EAAY,CAAC,GAAGhB,KAAK,CAACiB,OAAO,CAC9C,MACEhB,iBAAiB,CAAiBiB,OAAO,IACvCb,KAAK,CAACc,aAAa,CACjBT,UAAU,EACVG,UAAU,EACV;IACEN;EACF,CAAC,EACDW,OACF,CAAC,EAAE,UAAUR,UAAU,IAAIG,UAAU,EAAE,CAAC,EAC5C,CAACR,KAAK,EAAEK,UAAU,EAAEG,UAAU,EAAEN,IAAI,CACtC,CAAC;EAED,MAAMW,OAAO,GAAGlB,KAAK,CAACoB,oBAAoB,CAACL,SAAS,EAAEC,WAAW,CAAC;EAElE,OAAO;IACLK,MAAM,EAAEH,OAAO,EAAEG,MAAsC;IACvDC,SAAS,EAAEJ,OAAO,EAAEK,MAAM,KAAK,SAAS;IACxCC,YAAY,EAAEN,OAAO,EAAEM,YAAY,IAAI,KAAK;IAC5CC,WAAW,EAAEA,CAAA,KAAM;MACjB,MAAM,iBAAiB;IACzB;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"file":"useOsdkObject.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObject","args","observableClient","useContext","mode","length","undefined","objectType","$objectType","apiName","primaryKey","$primaryKey","subscribe","getSnapShot","useMemo","payload","observeObject","useSyncExternalStore","object","isLoading","status","isOptimistic","forceUpdate"],"sources":["useOsdkObject.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { ObjectTypeDefinition, Osdk, PrimaryKeyType } from \"@osdk/api\";\nimport type { ObjectPayload } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectResult<Q extends ObjectTypeDefinition> {\n  object: Osdk.Instance<Q> | undefined;\n  isLoading: boolean;\n\n  /**\n   * Refers to whether the object is optimistic or not.\n   */\n  isOptimistic: boolean;\n  forceUpdate: () => void;\n}\n\n/**\n * @param obj an existing `Osdk.Instance` object to get metadata for.\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  obj: Osdk.Instance<Q>,\n): UseOsdkObjectResult<Q>;\n/**\n * Loads an object by type and primary key.\n *\n * @param type\n * @param primaryKey\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  type: Q,\n  primaryKey: PrimaryKeyType<Q>,\n): UseOsdkObjectResult<Q>;\n/*\n    Implementation of useOsdkObject\n */\nexport function useOsdkObject<Q extends ObjectTypeDefinition>(\n  ...args: [obj: Osdk.Instance<Q>] | [type: Q, primaryKey: PrimaryKeyType<Q>]\n): UseOsdkObjectResult<Q> {\n  const { observableClient } = 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\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ObjectPayload>(\n        (payload) =>\n          observableClient.observeObject(\n            objectType,\n            primaryKey,\n            {\n              mode,\n            },\n            payload,\n          ),\n        `object ${objectType} ${primaryKey}`,\n      ),\n    [observableClient, objectType, primaryKey, mode],\n  );\n\n  const payload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return {\n    object: payload?.object as Osdk.Instance<Q> | undefined,\n    isLoading: payload?.status === \"loading\",\n    isOptimistic: payload?.isOptimistic ?? false,\n    forceUpdate: () => {\n      throw \"not implemented\";\n    },\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;;AAahD;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAC3B,GAAGC,IAAwE,EACnD;EACxB,MAAM;IAAEC;EAAiB,CAAC,GAAGL,KAAK,CAACM,UAAU,CAACJ,YAAY,CAAC;;EAE3D;EACA,MAAMK,IAAI,GAAGH,IAAI,CAACI,MAAM,KAAK,CAAC,GAAG,SAAS,GAAGC,SAAS;EACtD,MAAMC,UAAU,GAAGN,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACO,WAAW,GAAGP,IAAI,CAAC,CAAC,CAAC,CAACQ,OAAO;EAC5E,MAAMC,UAAU,GAAGT,IAAI,CAACI,MAAM,KAAK,CAAC,GAAGJ,IAAI,CAAC,CAAC,CAAC,CAACU,WAAW,GAAGV,IAAI,CAAC,CAAC,CAAC;EAEpE,MAAM;IAAEW,SAAS;IAAEC;EAAY,CAAC,GAAGhB,KAAK,CAACiB,OAAO,CAC9C,MACEhB,iBAAiB,CACdiB,OAAO,IACNb,gBAAgB,CAACc,aAAa,CAC5BT,UAAU,EACVG,UAAU,EACV;IACEN;EACF,CAAC,EACDW,OACF,CAAC,EACH,UAAUR,UAAU,IAAIG,UAAU,EACpC,CAAC,EACH,CAACR,gBAAgB,EAAEK,UAAU,EAAEG,UAAU,EAAEN,IAAI,CACjD,CAAC;EAED,MAAMW,OAAO,GAAGlB,KAAK,CAACoB,oBAAoB,CAACL,SAAS,EAAEC,WAAW,CAAC;EAElE,OAAO;IACLK,MAAM,EAAEH,OAAO,EAAEG,MAAsC;IACvDC,SAAS,EAAEJ,OAAO,EAAEK,MAAM,KAAK,SAAS;IACxCC,YAAY,EAAEN,OAAO,EAAEM,YAAY,IAAI,KAAK;IAC5CC,WAAW,EAAEA,CAAA,KAAM;MACjB,MAAM,iBAAiB;IACzB;EACF,CAAC;AACH","ignoreList":[]}

package/build/esm/new/{useOsdkList.js → useOsdkObjects.js}

@@ -17,40 +17,40 @@
 import React from "react";
 import { makeExternalStore } from "./makeExternalStore.js";
 import { OsdkContext2 } from "./OsdkContext2.js";
-export function useOsdkList(objectType, {
+export function useOsdkObjects(objectType, {
   pageSize,
   orderBy,
   dedupeIntervalMs,
-  where,
+  where = {},
   streamUpdates
-}) {
+} = {}) {
   const {
-    store
+    observableClient
   } = React.useContext(OsdkContext2);
 
   /*  We want the canonical where clause so that the use of `React.useMemo`
       is stable. No real added cost as we canonicalize internal to
       the ObservableClient anyway.
    */
-  const canonWhere = store.canonicalizeWhereClause(where ?? {});
+  const canonWhere = observableClient.canonicalizeWhereClause(where ?? {});
   const {
     subscribe,
     getSnapShot
-  } = React.useMemo(() => makeExternalStore(x => store.observeList({
+  } = React.useMemo(() => makeExternalStore(x => observableClient.observeList({
     objectType,
     where: canonWhere,
     dedupeInterval: dedupeIntervalMs ?? 2_000,
     pageSize,
     orderBy,
     streamUpdates
-  }, x), process.env.NODE_ENV !== "production" ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}` : void 0), [store, objectType, canonWhere, dedupeIntervalMs]);
+  }, x), process.env.NODE_ENV !== "production" ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}` : void 0), [observableClient, objectType, canonWhere, dedupeIntervalMs]);
   const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);
+  // TODO: we need to expose the error in the result
   return {
     fetchMore: listPayload?.fetchMore,
     data: listPayload?.resolvedList,
     isLoading: listPayload?.status === "loading",
-    error: undefined,
     isOptimistic: listPayload?.isOptimistic ?? false
   };
 }
-//# sourceMappingURL=useOsdkList.js.map
+//# sourceMappingURL=useOsdkObjects.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOsdkObjects.js","names":["React","makeExternalStore","OsdkContext2","useOsdkObjects","objectType","pageSize","orderBy","dedupeIntervalMs","where","streamUpdates","observableClient","useContext","canonWhere","canonicalizeWhereClause","subscribe","getSnapShot","useMemo","x","observeList","dedupeInterval","process","env","NODE_ENV","apiName","JSON","stringify","listPayload","useSyncExternalStore","fetchMore","data","resolvedList","isLoading","status","isOptimistic"],"sources":["useOsdkObjects.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type {\n  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/client\";\nimport type { ListPayload } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkObjectsOptions<T extends ObjectTypeDefinition> {\n  /**\n   * Standard OSDK Where\n   */\n  where?: WhereClause<T>;\n\n  /**\n   *  The preferred page size for the list.\n   */\n  pageSize?: number;\n\n  /** */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * Causes the list to automatically fetch more as soon as the previous page\n   * has been loaded. If a number is provided, it will continue to automatically\n   * fetch more until the list is at least that long.\n   */\n  // autoFetchMore?: boolean | number;\n\n  /**\n   * Upon a list being revalidated, this option determines how the component\n   * will be re-rendered with the data.\n   *\n   * An example to help understand the options:\n   *\n   * Suppose pageSize is 10 and we have called `fetchMore()` twice. The list is\n   * now 30 items long.\n   *\n   * Upon revalidation, we get the first 10 items of the list. The options behave\n   * as follows:\n   *\n   * - `\"in-place\"`: The first 10 items of the list are replaced with the new 10\n   *   items. The list is now 30 items long, but only the first 10 items are valid.\n   * - `\"wait\"`: The old list is returned until after the next 20 items are loaded\n   *   (which will happen automatically). The list is now 30 items long.\n   * - `\"reset\"`: The entire list is replaced with the new 10 items. The list is\n   *   now 10 items long.\n   */\n  // invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n\n  /**\n   * The number of milliseconds to wait after the last observed list change.\n   *\n   * Two uses of `useOsdkObjects` with the where clause will only trigger one\n   * network request if the second is within `dedupeIntervalMs`.\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * If provided, the list will be considered this length for the purposes of\n   * `invalidationMode` when using the `wait` option. If not provided,\n   * the internal expectedLength will be determined by the number of times\n   * `fetchMore` has been called.\n   */\n  // expectedLength?: number | undefined;\n\n  streamUpdates?: boolean;\n}\n\nexport interface UseOsdkListResult<T extends ObjectTypeDefinition> {\n  fetchMore: (() => Promise<unknown>) | undefined;\n  data: Osdk.Instance<T>[] | undefined;\n  isLoading: boolean;\n\n  // FIXME populate error!\n  // error: undefined;\n\n  /**\n   * Refers to whether the ordered list of objects (only considering the $primaryKey)\n   * is optimistic or not.\n   *\n   * If you need to know if the contents of the list are optimistic you can\n   * do that on a per object basis with useOsdkObject\n   */\n  isOptimistic: boolean;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\nexport function useOsdkObjects<T extends ObjectTypeDefinition>(\n  objectType: T,\n  {\n    pageSize,\n    orderBy,\n    dedupeIntervalMs,\n    where = {},\n    streamUpdates,\n  }: UseOsdkObjectsOptions<T> = {},\n): UseOsdkListResult<T> {\n  const { observableClient } = 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\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ListPayload>(\n        (x) =>\n          observableClient.observeList({\n            objectType,\n            where: canonWhere,\n            dedupeInterval: dedupeIntervalMs ?? 2_000,\n            pageSize,\n            orderBy,\n            streamUpdates,\n          }, x),\n        process.env.NODE_ENV !== \"production\"\n          ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}`\n          : void 0,\n      ),\n    [observableClient, objectType, canonWhere, dedupeIntervalMs],\n  );\n\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    data: listPayload?.resolvedList as Osdk.Instance<T>[],\n    isLoading: listPayload?.status === \"loading\",\n    isOptimistic: listPayload?.isOptimistic ?? false,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAyFhD,OAAO,SAASC,cAAcA,CAC5BC,UAAa,EACb;EACEC,QAAQ;EACRC,OAAO;EACPC,gBAAgB;EAChBC,KAAK,GAAG,CAAC,CAAC;EACVC;AACwB,CAAC,GAAG,CAAC,CAAC,EACV;EACtB,MAAM;IAAEC;EAAiB,CAAC,GAAGV,KAAK,CAACW,UAAU,CAACT,YAAY,CAAC;;EAE3D;AACF;AACA;AACA;EACE,MAAMU,UAAU,GAAGF,gBAAgB,CAACG,uBAAuB,CAACL,KAAK,IAAI,CAAC,CAAC,CAAC;EAExE,MAAM;IAAEM,SAAS;IAAEC;EAAY,CAAC,GAAGf,KAAK,CAACgB,OAAO,CAC9C,MACEf,iBAAiB,CACdgB,CAAC,IACAP,gBAAgB,CAACQ,WAAW,CAAC;IAC3Bd,UAAU;IACVI,KAAK,EAAEI,UAAU;IACjBO,cAAc,EAAEZ,gBAAgB,IAAI,KAAK;IACzCF,QAAQ;IACRC,OAAO;IACPG;EACF,CAAC,EAAEQ,CAAC,CAAC,EACPG,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,QAAQlB,UAAU,CAACmB,OAAO,IAAIC,IAAI,CAACC,SAAS,CAACb,UAAU,CAAC,EAAE,GAC1D,KAAK,CACX,CAAC,EACH,CAACF,gBAAgB,EAAEN,UAAU,EAAEQ,UAAU,EAAEL,gBAAgB,CAC7D,CAAC;EAED,MAAMmB,WAAW,GAAG1B,KAAK,CAAC2B,oBAAoB,CAACb,SAAS,EAAEC,WAAW,CAAC;EACtE;EACA,OAAO;IACLa,SAAS,EAAEF,WAAW,EAAEE,SAAS;IACjCC,IAAI,EAAEH,WAAW,EAAEI,YAAkC;IACrDC,SAAS,EAAEL,WAAW,EAAEM,MAAM,KAAK,SAAS;IAC5CC,YAAY,EAAEP,WAAW,EAAEO,YAAY,IAAI;EAC7C,CAAC;AACH","ignoreList":[]}

package/build/esm/public/experimental.js

@@ -16,7 +16,7 @@
 
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
-export { useOsdkList } from "../new/useOsdkList.js";
 export { useOsdkObject } from "../new/useOsdkObject.js";
+export { useOsdkObjects } from "../new/useOsdkObjects.js";
 export { useOsdkClient } from "../useOsdkClient.js";
 //# sourceMappingURL=experimental.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"experimental.js","names":["OsdkProvider2","useOsdkAction","useOsdkList","useOsdkObject","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 { useOsdkList } from \"../new/useOsdkList.js\";\nexport { useOsdkObject } from \"../new/useOsdkObject.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,WAAW,QAAQ,uBAAuB;AACnD,SAASC,aAAa,QAAQ,yBAAyB;AACvD,SAASC,aAAa,QAAQ,qBAAqB","ignoreList":[]}
+{"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":[]}

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

@@ -3,7 +3,7 @@ import type { ObservableClient } from "@osdk/client/unstable-do-not-use";
 import React from "react";
 interface OsdkContextContents {
 	client: Client;
-	store: ObservableClient;
+	observableClient: ObservableClient;
 }
 export declare const OsdkContext2: React.Context<OsdkContextContents>;
 export {};

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,cAAc,cAAe;AAC3C,cAAc,wBAAwB,kCAAmC;AACzE,OAAO,WAAW,OAAQ;UAYhB,oBAAoB;CAC5B,QAAQ;CAKR,OAAO;AACR;AAED,OAAO,cAAMA,cAAc,MAAM,QAAQ","names":["OsdkContext2: React.Context<OsdkContextContents>"],"sources":["../../../src/new/OsdkContext2.ts"],"version":3,"file":"OsdkContext2.d.ts"}
+{"mappings":"AAgBA,cAAc,cAAc,cAAe;AAC3C,cAAc,wBAAwB,kCAAmC;AACzE,OAAO,WAAW,OAAQ;UAYhB,oBAAoB;CAC5B,QAAQ;CAKR,kBAAkB;AACnB;AAED,OAAO,cAAMA,cAAc,MAAM,QAAQ","names":["OsdkContext2: React.Context<OsdkContextContents>"],"sources":["../../../src/new/OsdkContext2.ts"],"version":3,"file":"OsdkContext2.d.ts"}

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

@@ -1,10 +1,10 @@
 import type { Client } from "@osdk/client";
-import type { ObservableClient } from "@osdk/client/unstable-do-not-use";
+import { type ObservableClient } from "@osdk/client/unstable-do-not-use";
 import React from "react";
 interface OsdkProviderOptions {
 	children: React.ReactNode;
 	client: Client;
-	store: ObservableClient;
+	observableClient?: ObservableClient;
 }
-export declare function OsdkProvider2({ children, client, store }: OsdkProviderOptions): React.JSX.Element;
+export declare function OsdkProvider2({ children, client, observableClient }: OsdkProviderOptions): React.JSX.Element;
 export {};

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,cAAc,cAAe;AAC3C,cAAc,wBAAwB,kCAAmC;AACzE,OAAO,WAAW,OAAQ;UAGhB,oBAAoB;CAC5B,UAAU,MAAM;CAChB,QAAQ;CACR,OAAO;AACR;AAED,OAAO,iBAAS,cAAc,EAC5B,UACA,QACA,OACoB,EAAnB,sBAAsB,MAAM,IAAI","names":[],"sources":["../../../src/new/OsdkProvider2.tsx"],"version":3,"file":"OsdkProvider2.d.ts"}
+{"mappings":"AAgBA,cAAc,cAAc,cAAe;AAC3C,cAEO,wBACA,kCAAmC;AAC1C,OAAO,WAAwB,OAAQ;UAG7B,oBAAoB;CAC5B,UAAU,MAAM;CAChB,QAAQ;CACR,mBAAmB;AACpB;AAED,OAAO,iBAAS,cAAc,EAC5B,UACA,QACA,kBACoB,EAAnB,sBAAsB,MAAM,IAAI","names":[],"sources":["../../../src/new/OsdkProvider2.tsx"],"version":3,"file":"OsdkProvider2.d.ts"}

package/build/types/new/{useOsdkList.d.ts → useOsdkObjects.d.ts}

@@ -1,5 +1,5 @@
 import type { ObjectTypeDefinition, Osdk, PropertyKeys, WhereClause } from "@osdk/client";
-export interface UseOsdkListOptions<T extends ObjectTypeDefinition> {
+export interface UseOsdkObjectsOptions<T extends ObjectTypeDefinition> {
 	/**
 	* Standard OSDK Where
 	*/
@@ -37,7 +37,7 @@ export interface UseOsdkListOptions<T extends ObjectTypeDefinition> {
 	/**
 	* The number of milliseconds to wait after the last observed list change.
 	*
-	* Two uses of `useOsdkList` with the where clause will only trigger one
+	* Two uses of `useOsdkObjects` with the where clause will only trigger one
 	* network request if the second is within `dedupeIntervalMs`.
 	*/
 	dedupeIntervalMs?: number;
@@ -51,9 +51,8 @@ export interface UseOsdkListOptions<T extends ObjectTypeDefinition> {
 }
 export interface UseOsdkListResult<T extends ObjectTypeDefinition> {
 	fetchMore: (() => Promise<unknown>) | undefined;
-	data: Osdk.Instance<T>[];
+	data: Osdk.Instance<T>[] | undefined;
 	isLoading: boolean;
-	error: undefined;
 	/**
 	* Refers to whether the ordered list of objects (only considering the $primaryKey)
 	* is optimistic or not.
@@ -63,4 +62,4 @@ export interface UseOsdkListResult<T extends ObjectTypeDefinition> {
 	*/
 	isOptimistic: boolean;
 }
-export declare function useOsdkList<T extends ObjectTypeDefinition>(objectType: T, { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates }: UseOsdkListOptions<T>): UseOsdkListResult<T>;
+export declare function useOsdkObjects<T extends ObjectTypeDefinition>(objectType: T, { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates }?: UseOsdkObjectsOptions<T>): UseOsdkListResult<T>;

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

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cACE,sBACA,MACA,cACA,mBACK,cAAe;AAMtB,iBAAiB,sBAAsB,UAAU,sBAAsB;;;;CAIrE,QAAQ,YAAY;;;;CAKpB;;CAGA,aACG,KAAK,aAAa,OAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCnC;;;;;;;CAUA;AACD;AAED,iBAAiB,kBAAkB,UAAU,sBAAsB;CACjE,kBAAkB;CAClB,MAAM,KAAK,SAAS;CACpB;;;;;;;;CAYA;AACD;AAQD,OAAO,iBAAS,eAAe,UAAU,sBACvCA,YAAY,GACZ,EACE,UACA,SACA,kBACA,OACA,eACyB,GAAxB,sBAAsB,KACxB,kBAAkB","names":["objectType: T"],"sources":["../../../src/new/useOsdkObjects.ts"],"version":3,"file":"useOsdkObjects.d.ts"}

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

@@ -1,5 +1,5 @@
 export { OsdkProvider2 } from "../new/OsdkProvider2.js";
 export { useOsdkAction } from "../new/useOsdkAction.js";
-export { useOsdkList } from "../new/useOsdkList.js";
 export { useOsdkObject } from "../new/useOsdkObject.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,mBAAmB;AAC5B,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB","names":[],"sources":["../../../src/public/experimental.ts"],"version":3,"file":"experimental.d.ts"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdk/react",
-  "version": "0.4.0-beta.2",
+  "version": "0.4.0-beta.3",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -49,10 +49,10 @@
     "p-defer": "^4.0.1",
     "react": "^18.0.0",
     "typescript": "~5.5.4",
-    "@osdk/api": "2.2.0-beta.4",
-    "@osdk/client": "2.2.0-beta.4",
-    "@osdk/monorepo.tsconfig": "~0.1.0-beta.1",
-    "@osdk/monorepo.api-extractor": "~0.1.0-beta.1"
+    "@osdk/api": "2.2.0-beta.5",
+    "@osdk/client": "2.2.0-beta.5",
+    "@osdk/monorepo.api-extractor": "~0.1.0-beta.1",
+    "@osdk/monorepo.tsconfig": "~0.1.0-beta.1"
   },
   "publishConfig": {
     "access": "public"

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

@@ -1 +0,0 @@
-{"version":3,"file":"useOsdkList.js","names":["React","makeExternalStore","OsdkContext2","useOsdkList","objectType","pageSize","orderBy","dedupeIntervalMs","where","streamUpdates","store","useContext","canonWhere","canonicalizeWhereClause","subscribe","getSnapShot","useMemo","x","observeList","dedupeInterval","process","env","NODE_ENV","apiName","JSON","stringify","listPayload","useSyncExternalStore","fetchMore","data","resolvedList","isLoading","status","error","undefined","isOptimistic"],"sources":["useOsdkList.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  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/client\";\nimport type { ListPayload } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkListOptions<T extends ObjectTypeDefinition> {\n  /**\n   * Standard OSDK Where\n   */\n  where?: WhereClause<T>;\n\n  /**\n   *  The preferred page size for the list.\n   */\n  pageSize?: number;\n\n  /** */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * Causes the list to automatically fetch more as soon as the previous page\n   * has been loaded. If a number is provided, it will continue to automatically\n   * fetch more until the list is at least that long.\n   */\n  // autoFetchMore?: boolean | number;\n\n  /**\n   * Upon a list being revalidated, this option determines how the component\n   * will be re-rendered with the data.\n   *\n   * An example to help understand the options:\n   *\n   * Suppose pageSize is 10 and we have called `fetchMore()` twice. The list is\n   * now 30 items long.\n   *\n   * Upon revalidation, we get the first 10 items of the list. The options behave\n   * as follows:\n   *\n   * - `\"in-place\"`: The first 10 items of the list are replaced with the new 10\n   *   items. The list is now 30 items long, but only the first 10 items are valid.\n   * - `\"wait\"`: The old list is returned until after the next 20 items are loaded\n   *   (which will happen automatically). The list is now 30 items long.\n   * - `\"reset\"`: The entire list is replaced with the new 10 items. The list is\n   *   now 10 items long.\n   */\n  // invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n\n  /**\n   * The number of milliseconds to wait after the last observed list change.\n   *\n   * Two uses of `useOsdkList` with the where clause will only trigger one\n   * network request if the second is within `dedupeIntervalMs`.\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * If provided, the list will be considered this length for the purposes of\n   * `invalidationMode` when using the `wait` option. If not provided,\n   * the internal expectedLength will be determined by the number of times\n   * `fetchMore` has been called.\n   */\n  // expectedLength?: number | undefined;\n\n  streamUpdates?: boolean;\n}\n\nexport interface UseOsdkListResult<T extends ObjectTypeDefinition> {\n  fetchMore: (() => Promise<unknown>) | undefined;\n  data: Osdk.Instance<T>[];\n  isLoading: boolean;\n\n  // FIXME populate error!\n  error: undefined;\n\n  /**\n   * Refers to whether the ordered list of objects (only considering the $primaryKey)\n   * is optimistic or not.\n   *\n   * If you need to know if the contents of the list are optimistic you can\n   * do that on a per object basis with useOsdkObject\n   */\n  isOptimistic: boolean;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\nexport function useOsdkList<T extends ObjectTypeDefinition>(\n  objectType: T,\n  { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates }:\n    UseOsdkListOptions<T>,\n): UseOsdkListResult<T> {\n  const { store } = 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 = store.canonicalizeWhereClause(where ?? {});\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ListPayload>(\n        (x) =>\n          store.observeList({\n            objectType,\n            where: canonWhere,\n            dedupeInterval: dedupeIntervalMs ?? 2_000,\n            pageSize,\n            orderBy,\n            streamUpdates,\n          }, x),\n        process.env.NODE_ENV !== \"production\"\n          ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}`\n          : void 0,\n      ),\n    [store, objectType, canonWhere, dedupeIntervalMs],\n  );\n\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return {\n    fetchMore: listPayload?.fetchMore,\n    data: listPayload?.resolvedList as Osdk.Instance<T>[],\n    isLoading: listPayload?.status === \"loading\",\n    error: undefined,\n    isOptimistic: listPayload?.isOptimistic ?? false,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAyFhD,OAAO,SAASC,WAAWA,CACzBC,UAAa,EACb;EAAEC,QAAQ;EAAEC,OAAO;EAAEC,gBAAgB;EAAEC,KAAK;EAAEC;AACxB,CAAC,EACD;EACtB,MAAM;IAAEC;EAAM,CAAC,GAAGV,KAAK,CAACW,UAAU,CAACT,YAAY,CAAC;;EAEhD;AACF;AACA;AACA;EACE,MAAMU,UAAU,GAAGF,KAAK,CAACG,uBAAuB,CAACL,KAAK,IAAI,CAAC,CAAC,CAAC;EAE7D,MAAM;IAAEM,SAAS;IAAEC;EAAY,CAAC,GAAGf,KAAK,CAACgB,OAAO,CAC9C,MACEf,iBAAiB,CACdgB,CAAC,IACAP,KAAK,CAACQ,WAAW,CAAC;IAChBd,UAAU;IACVI,KAAK,EAAEI,UAAU;IACjBO,cAAc,EAAEZ,gBAAgB,IAAI,KAAK;IACzCF,QAAQ;IACRC,OAAO;IACPG;EACF,CAAC,EAAEQ,CAAC,CAAC,EACPG,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,QAAQlB,UAAU,CAACmB,OAAO,IAAIC,IAAI,CAACC,SAAS,CAACb,UAAU,CAAC,EAAE,GAC1D,KAAK,CACX,CAAC,EACH,CAACF,KAAK,EAAEN,UAAU,EAAEQ,UAAU,EAAEL,gBAAgB,CAClD,CAAC;EAED,MAAMmB,WAAW,GAAG1B,KAAK,CAAC2B,oBAAoB,CAACb,SAAS,EAAEC,WAAW,CAAC;EAEtE,OAAO;IACLa,SAAS,EAAEF,WAAW,EAAEE,SAAS;IACjCC,IAAI,EAAEH,WAAW,EAAEI,YAAkC;IACrDC,SAAS,EAAEL,WAAW,EAAEM,MAAM,KAAK,SAAS;IAC5CC,KAAK,EAAEC,SAAS;IAChBC,YAAY,EAAET,WAAW,EAAES,YAAY,IAAI;EAC7C,CAAC;AACH","ignoreList":[]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"useOsdkList.js","names":["React","makeExternalStore","OsdkContext2","useOsdkList","objectType","pageSize","orderBy","dedupeIntervalMs","where","streamUpdates","store","useContext","canonWhere","canonicalizeWhereClause","subscribe","getSnapShot","useMemo","x","observeList","dedupeInterval","process","env","NODE_ENV","apiName","JSON","stringify","listPayload","useSyncExternalStore","fetchMore","data","resolvedList","isLoading","status","error","undefined","isOptimistic"],"sources":["useOsdkList.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  ObjectTypeDefinition,\n  Osdk,\n  PropertyKeys,\n  WhereClause,\n} from \"@osdk/client\";\nimport type { ListPayload } from \"@osdk/client/unstable-do-not-use\";\nimport React from \"react\";\nimport { makeExternalStore } from \"./makeExternalStore.js\";\nimport { OsdkContext2 } from \"./OsdkContext2.js\";\n\nexport interface UseOsdkListOptions<T extends ObjectTypeDefinition> {\n  /**\n   * Standard OSDK Where\n   */\n  where?: WhereClause<T>;\n\n  /**\n   *  The preferred page size for the list.\n   */\n  pageSize?: number;\n\n  /** */\n  orderBy?: {\n    [K in PropertyKeys<T>]?: \"asc\" | \"desc\";\n  };\n\n  /**\n   * Causes the list to automatically fetch more as soon as the previous page\n   * has been loaded. If a number is provided, it will continue to automatically\n   * fetch more until the list is at least that long.\n   */\n  // autoFetchMore?: boolean | number;\n\n  /**\n   * Upon a list being revalidated, this option determines how the component\n   * will be re-rendered with the data.\n   *\n   * An example to help understand the options:\n   *\n   * Suppose pageSize is 10 and we have called `fetchMore()` twice. The list is\n   * now 30 items long.\n   *\n   * Upon revalidation, we get the first 10 items of the list. The options behave\n   * as follows:\n   *\n   * - `\"in-place\"`: The first 10 items of the list are replaced with the new 10\n   *   items. The list is now 30 items long, but only the first 10 items are valid.\n   * - `\"wait\"`: The old list is returned until after the next 20 items are loaded\n   *   (which will happen automatically). The list is now 30 items long.\n   * - `\"reset\"`: The entire list is replaced with the new 10 items. The list is\n   *   now 10 items long.\n   */\n  // invalidationMode?: \"in-place\" | \"wait\" | \"reset\";\n\n  /**\n   * The number of milliseconds to wait after the last observed list change.\n   *\n   * Two uses of `useOsdkList` with the where clause will only trigger one\n   * network request if the second is within `dedupeIntervalMs`.\n   */\n  dedupeIntervalMs?: number;\n\n  /**\n   * If provided, the list will be considered this length for the purposes of\n   * `invalidationMode` when using the `wait` option. If not provided,\n   * the internal expectedLength will be determined by the number of times\n   * `fetchMore` has been called.\n   */\n  // expectedLength?: number | undefined;\n\n  streamUpdates?: boolean;\n}\n\nexport interface UseOsdkListResult<T extends ObjectTypeDefinition> {\n  fetchMore: (() => Promise<unknown>) | undefined;\n  data: Osdk.Instance<T>[];\n  isLoading: boolean;\n\n  // FIXME populate error!\n  error: undefined;\n\n  /**\n   * Refers to whether the ordered list of objects (only considering the $primaryKey)\n   * is optimistic or not.\n   *\n   * If you need to know if the contents of the list are optimistic you can\n   * do that on a per object basis with useOsdkObject\n   */\n  isOptimistic: boolean;\n}\n\ndeclare const process: {\n  env: {\n    NODE_ENV: \"development\" | \"production\";\n  };\n};\n\nexport function useOsdkList<T extends ObjectTypeDefinition>(\n  objectType: T,\n  { pageSize, orderBy, dedupeIntervalMs, where, streamUpdates }:\n    UseOsdkListOptions<T>,\n): UseOsdkListResult<T> {\n  const { store } = 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 = store.canonicalizeWhereClause(where ?? {});\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ListPayload>(\n        (x) =>\n          store.observeList({\n            objectType,\n            where: canonWhere,\n            dedupeInterval: dedupeIntervalMs ?? 2_000,\n            pageSize,\n            orderBy,\n            streamUpdates,\n          }, x),\n        process.env.NODE_ENV !== \"production\"\n          ? `list ${objectType.apiName} ${JSON.stringify(canonWhere)}`\n          : void 0,\n      ),\n    [store, objectType, canonWhere, dedupeIntervalMs],\n  );\n\n  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);\n\n  return {\n    fetchMore: listPayload?.fetchMore,\n    data: listPayload?.resolvedList as Osdk.Instance<T>[],\n    isLoading: listPayload?.status === \"loading\",\n    error: undefined,\n    isOptimistic: listPayload?.isOptimistic ?? false,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AAyFhD,OAAO,SAASC,WAAWA,CACzBC,UAAa,EACb;EAAEC,QAAQ;EAAEC,OAAO;EAAEC,gBAAgB;EAAEC,KAAK;EAAEC;AACxB,CAAC,EACD;EACtB,MAAM;IAAEC;EAAM,CAAC,GAAGV,KAAK,CAACW,UAAU,CAACT,YAAY,CAAC;;EAEhD;AACF;AACA;AACA;EACE,MAAMU,UAAU,GAAGF,KAAK,CAACG,uBAAuB,CAACL,KAAK,IAAI,CAAC,CAAC,CAAC;EAE7D,MAAM;IAAEM,SAAS;IAAEC;EAAY,CAAC,GAAGf,KAAK,CAACgB,OAAO,CAC9C,MACEf,iBAAiB,CACdgB,CAAC,IACAP,KAAK,CAACQ,WAAW,CAAC;IAChBd,UAAU;IACVI,KAAK,EAAEI,UAAU;IACjBO,cAAc,EAAEZ,gBAAgB,IAAI,KAAK;IACzCF,QAAQ;IACRC,OAAO;IACPG;EACF,CAAC,EAAEQ,CAAC,CAAC,EACPG,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,GACjC,QAAQlB,UAAU,CAACmB,OAAO,IAAIC,IAAI,CAACC,SAAS,CAACb,UAAU,CAAC,EAAE,GAC1D,KAAK,CACX,CAAC,EACH,CAACF,KAAK,EAAEN,UAAU,EAAEQ,UAAU,EAAEL,gBAAgB,CAClD,CAAC;EAED,MAAMmB,WAAW,GAAG1B,KAAK,CAAC2B,oBAAoB,CAACb,SAAS,EAAEC,WAAW,CAAC;EAEtE,OAAO;IACLa,SAAS,EAAEF,WAAW,EAAEE,SAAS;IACjCC,IAAI,EAAEH,WAAW,EAAEI,YAAkC;IACrDC,SAAS,EAAEL,WAAW,EAAEM,MAAM,KAAK,SAAS;IAC5CC,KAAK,EAAEC,SAAS;IAChBC,YAAY,EAAET,WAAW,EAAES,YAAY,IAAI;EAC7C,CAAC;AACH","ignoreList":[]}

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

@@ -1 +0,0 @@
-{"mappings":"AAgBA,cACE,sBACA,MACA,cACA,mBACK,cAAe;AAMtB,iBAAiB,mBAAmB,UAAU,sBAAsB;;;;CAIlE,QAAQ,YAAY;;;;CAKpB;;CAGA,aACG,KAAK,aAAa,OAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCnC;;;;;;;CAUA;AACD;AAED,iBAAiB,kBAAkB,UAAU,sBAAsB;CACjE,kBAAkB;CAClB,MAAM,KAAK,SAAS;CACpB;CAGA;;;;;;;;CASA;AACD;AAQD,OAAO,iBAAS,YAAY,UAAU,sBACpCA,YAAY,GACZ,EAAE,UAAU,SAAS,kBAAkB,OAAO,eACvB,EAArB,mBAAmB,KACpB,kBAAkB","names":["objectType: T"],"sources":["../../../src/new/useOsdkList.ts"],"version":3,"file":"useOsdkList.d.ts"}