@osdk/react 0.3.0-beta.2 → 0.3.0-rc.4

package/build/cjs/public/experimental.cjs

@@ -0,0 +1,142 @@
+'use strict';
+
+var chunk2N32USW5_cjs = require('../chunk-2N32USW5.cjs');
+var React3 = require('react');
+var client = require('@osdk/client');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React3__default = /*#__PURE__*/_interopDefault(React3);
+
+function fakeClientFn(..._args) {
+  throw new Error("This is not a real client. Did you forget to <OsdkContext.Provider>?");
+}
+var fakeClient = Object.assign(fakeClientFn, {
+  fetchMetadata: fakeClientFn
+});
+var OsdkContext2 = /* @__PURE__ */ React3__default.default.createContext({
+  client: fakeClient,
+  store: undefined
+});
+
+// src/new/OsdkProvider2.tsx
+function OsdkProvider2({
+  children,
+  client,
+  store
+}) {
+  return /* @__PURE__ */ React3__default.default.createElement(OsdkContext2.Provider, {
+    value: {
+      client,
+      store
+    }
+  }, children);
+}
+function useOsdkAction(actionDef) {
+  const {
+    store
+  } = React3__default.default.useContext(OsdkContext2);
+  const [error, setError] = React3__default.default.useState();
+  const [data, setData] = React3__default.default.useState();
+  const applyAction = React3__default.default.useCallback(async function applyAction2(args, opts) {
+    try {
+      const r = await store.applyAction(actionDef, args, opts);
+      setData(r);
+      return r;
+    } catch (e) {
+      if (e instanceof client.ActionValidationError) {
+        setError({
+          actionValidation: e
+        });
+      } else {
+        setError({
+          unknown: e
+        });
+      }
+    }
+  }, [store, setError]);
+  return {
+    applyAction,
+    error,
+    data
+  };
+}
+
+// src/new/makeExternalStore.ts
+function makeExternalStore(createObservation, name) {
+  let lastResult;
+  function getSnapShot() {
+    return lastResult;
+  }
+  function subscribe(notifyUpdate) {
+    console.log("Subscribing", name);
+    const obs = createObservation((payload) => {
+      lastResult = payload;
+      notifyUpdate();
+    });
+    return () => {
+      console.log("Unsubscribing", name);
+      obs.unsubscribe();
+    };
+  }
+  return {
+    subscribe,
+    getSnapShot
+  };
+}
+
+// src/new/useOsdkList.ts
+function useOsdkList(type, opts) {
+  const {
+    store
+  } = React3__default.default.useContext(OsdkContext2);
+  const where = store.canonicalizeWhereClause(opts.where);
+  const {
+    subscribe,
+    getSnapShot
+  } = React3__default.default.useMemo(() => makeExternalStore((x) => store.observeList(type, where, {
+    dedupeInterval: opts.dedupeIntervalMs ?? 2e3
+  }, x), `list ${type.apiName} ${JSON.stringify(where)}`), [store, type, where, opts.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), `object ${objectType} ${primaryKey}`), [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,
+  get: function () { return chunk2N32USW5_cjs.useOsdkClient; }
+});
+exports.OsdkProvider2 = OsdkProvider2;
+exports.useOsdkAction = useOsdkAction;
+exports.useOsdkList = useOsdkList;
+exports.useOsdkObject = useOsdkObject;
+//# sourceMappingURL=experimental.cjs.map
+//# sourceMappingURL=experimental.cjs.map

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

@@ -0,0 +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":";;;;;;;;;;AAiBA,SAAS,gBAAgB,KAAO,EAAA;AAC9B,EAAM,MAAA,IAAI,MAAM,sEAAsE,CAAA;AACxF;AACA,IAAM,UAAA,GAAa,MAAO,CAAA,MAAA,CAAO,YAAc,EAAA;AAAA,EAC7C,aAAe,EAAA;AACjB,CAAC,CAAA;AACM,IAAM,YAAA,2CAAkC,aAAc,CAAA;AAAA,EAC3D,MAAQ,EAAA,UAAA;AAAA,EACR,KAAO,EAAA;AACT,CAAC,CAAA;;;ACRM,SAAS,aAAc,CAAA;AAAA,EAC5B,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAG,EAAA;AACD,EAAA,uBAAoBA,uBAAAA,CAAM,aAAc,CAAA,YAAA,CAAa,QAAU,EAAA;AAAA,IAC7D,KAAO,EAAA;AAAA,MACL,MAAA;AAAA,MACA;AAAA;AACF,KACC,QAAQ,CAAA;AACb;ACVO,SAAS,cAAc,SAAW,EAAA;AACvC,EAAM,MAAA;AAAA,IACJ;AAAA,GACF,GAAIA,uBAAM,CAAA,UAAA,CAAW,YAAY,CAAA;AACjC,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,wBAAM,QAAS,EAAA;AACzC,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAIA,wBAAM,QAAS,EAAA;AACvC,EAAA,MAAM,cAAcA,uBAAM,CAAA,WAAA,CAAY,eAAeC,YAAAA,CAAY,MAAM,IAAM,EAAA;AAC3E,IAAI,IAAA;AACF,MAAA,MAAM,IAAI,MAAM,KAAA,CAAM,WAAY,CAAA,SAAA,EAAW,MAAM,IAAI,CAAA;AACvD,MAAA,OAAA,CAAQ,CAAC,CAAA;AACT,MAAO,OAAA,CAAA;AAAA,aACA,CAAG,EAAA;AACV,MAAA,IAAI,aAAaC,4BAAuB,EAAA;AACtC,QAAS,QAAA,CAAA;AAAA,UACP,gBAAkB,EAAA;AAAA,SACnB,CAAA;AAAA,OACI,MAAA;AACL,QAAS,QAAA,CAAA;AAAA,UACP,OAAS,EAAA;AAAA,SACV,CAAA;AAAA;AACH;AACF,GACC,EAAA,CAAC,KAAO,EAAA,QAAQ,CAAC,CAAA;AACpB,EAAO,OAAA;AAAA,IACL,WAAA;AAAA,IACA,KAAA;AAAA,IACA;AAAA,GACF;AACF;;;AC/BO,SAAS,iBAAA,CAAkB,mBAAmB,IAAM,EAAA;AACzD,EAAI,IAAA,UAAA;AACJ,EAAA,SAAS,WAAc,GAAA;AACrB,IAAO,OAAA,UAAA;AAAA;AAET,EAAA,SAAS,UAAU,YAAc,EAAA;AAE/B,IAAQ,OAAA,CAAA,GAAA,CAAI,eAAe,IAAI,CAAA;AAC/B,IAAM,MAAA,GAAA,GAAM,kBAAkB,CAAW,OAAA,KAAA;AACvC,MAAa,UAAA,GAAA,OAAA;AACb,MAAa,YAAA,EAAA;AAAA,KACd,CAAA;AACD,IAAA,OAAO,MAAM;AAEX,MAAQ,OAAA,CAAA,GAAA,CAAI,iBAAiB,IAAI,CAAA;AACjC,MAAA,GAAA,CAAI,WAAY,EAAA;AAAA,KAClB;AAAA;AAEF,EAAO,OAAA;AAAA,IACL,SAAA;AAAA,IACA;AAAA,GACF;AACF;;;ACnBO,SAAS,WAAA,CAAY,MAAM,IAAM,EAAA;AACtC,EAAM,MAAA;AAAA,IACJ;AAAA,GACF,GAAIF,uBAAM,CAAA,UAAA,CAAW,YAAY,CAAA;AACjC,EAAA,MAAM,KAAQ,GAAA,KAAA,CAAM,uBAAwB,CAAA,IAAA,CAAK,KAAK,CAAA;AACtD,EAAM,MAAA;AAAA,IACJ,SAAA;AAAA,IACA;AAAA,GACF,GAAIA,wBAAM,OAAQ,CAAA,MAAM,kBAAkB,CAAK,CAAA,KAAA,KAAA,CAAM,WAAY,CAAA,IAAA,EAAM,KAAO,EAAA;AAAA,IAC5E,cAAA,EAAgB,KAAK,gBAAoB,IAAA;AAAA,KACxC,CAAC,CAAA,EAAG,QAAQ,IAAK,CAAA,OAAO,IAAI,IAAK,CAAA,SAAA,CAAU,KAAK,CAAC,CAAA,CAAE,GAAG,CAAC,KAAA,EAAO,MAAM,KAAO,EAAA,IAAA,CAAK,gBAAgB,CAAC,CAAA;AACpG,EAAA,MAAM,WAAcA,GAAAA,uBAAAA,CAAM,oBAAqB,CAAA,SAAA,EAAW,WAAW,CAAA;AACrE,EAAO,OAAA;AAAA,IACL,WAAW,WAAa,EAAA,SAAA;AAAA,IACxB,MAAM,WAAa,EAAA,YAAA;AAAA,IACnB,SAAA,EAAW,aAAa,MAAW,KAAA,SAAA;AAAA,IACnC,KAAO,EAAA,SAAA;AAAA,IACP,YAAA,EAAc,aAAa,YAAgB,IAAA;AAAA,GAC7C;AACF;ACJO,SAAS,iBAAiB,IAAM,EAAA;AACrC,EAAM,MAAA;AAAA,IACJ;AAAA,GACF,GAAIA,uBAAM,CAAA,UAAA,CAAW,YAAY,CAAA;AAGjC,EAAA,MAAM,IAAO,GAAA,IAAA,CAAK,MAAW,KAAA,CAAA,GAAI,SAAY,GAAA,SAAA;AAC7C,EAAM,MAAA,UAAA,GAAa,IAAK,CAAA,MAAA,KAAW,CAAI,GAAA,IAAA,CAAK,CAAC,CAAE,CAAA,WAAA,GAAc,IAAK,CAAA,CAAC,CAAE,CAAA,OAAA;AACrE,EAAM,MAAA,UAAA,GAAa,KAAK,MAAW,KAAA,CAAA,GAAI,KAAK,CAAC,CAAA,CAAE,WAAc,GAAA,IAAA,CAAK,CAAC,CAAA;AACnE,EAAM,MAAA;AAAA,IACJ,SAAA;AAAA,IACA;AAAA,GACF,GAAIA,uBAAM,CAAA,OAAA,CAAQ,MAAM,iBAAA,CAAkB,CAAAG,QAAW,KAAA,KAAA,CAAM,aAAc,CAAA,UAAA,EAAY,UAAY,EAAA;AAAA,IAC/F;AAAA,GACCA,EAAAA,QAAO,CAAG,EAAA,CAAA,OAAA,EAAU,UAAU,CAAI,CAAA,EAAA,UAAU,CAAE,CAAA,CAAA,EAAG,CAAC,KAAA,EAAO,UAAY,EAAA,UAAA,EAAY,IAAI,CAAC,CAAA;AACzF,EAAA,MAAM,OAAUH,GAAAA,uBAAAA,CAAM,oBAAqB,CAAA,SAAA,EAAW,WAAW,CAAA;AACjE,EAAO,OAAA;AAAA,IACL,QAAQ,OAAS,EAAA,MAAA;AAAA,IACjB,SAAA,EAAW,SAAS,MAAW,KAAA,SAAA;AAAA,IAC/B,YAAA,EAAc,SAAS,YAAgB,IAAA,KAAA;AAAA,IACvC,aAAa,MAAM;AACjB,MAAM,MAAA,iBAAA;AAAA;AACR,GACF;AACF","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 applyAction = React.useCallback(async function applyAction(args, opts) {\n    try {\n      const r = await store.applyAction(actionDef, args, opts);\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    }\n  }, [store, setError]);\n  return {\n    applyAction,\n    error,\n    data\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    // eslint-disable-next-line no-console\n    console.log(\"Subscribing\", name);\n    const obs = createObservation(payload => {\n      lastResult = payload;\n      notifyUpdate();\n    });\n    return () => {\n      // eslint-disable-next-line no-console\n      console.log(\"Unsubscribing\", name);\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(type, opts) {\n  const {\n    store\n  } = React.useContext(OsdkContext2);\n  const where = store.canonicalizeWhereClause(opts.where);\n  const {\n    subscribe,\n    getSnapShot\n  } = React.useMemo(() => makeExternalStore(x => store.observeList(type, where, {\n    dedupeInterval: opts.dedupeIntervalMs ?? 2_000\n  }, x), `list ${type.apiName} ${JSON.stringify(where)}`), [store, type, where, opts.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}"]}

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

@@ -0,0 +1,71 @@
+import { Client, ActionDefinition, ActionValidationError, ObjectTypeDefinition, WhereClause, Osdk } 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';
+export { u as useOsdkClient } from '../useOsdkClient-B4iwHO1H.cjs';
+
+interface OsdkProviderOptions {
+    children: React.ReactNode;
+    client: Client;
+    store: ObservableClient;
+}
+declare function OsdkProvider2({ children, client, store, }: OsdkProviderOptions): React.JSX.Element;
+
+interface UseOsdkActionResult<Q extends ActionDefinition<any>> {
+    applyAction: (args: Parameters<ActionSignatureFromDef<Q>["applyAction"]>[0], opts: ObservableClient.ApplyActionOptions) => Promise<unknown>;
+    error: undefined | Partial<{
+        actionValidation: ActionValidationError;
+        unknown: unknown;
+    }>;
+    data: unknown;
+}
+declare function useOsdkAction<Q extends ActionDefinition<any>>(actionDef: Q): UseOsdkActionResult<Q>;
+
+interface UseOsdkListOptions<T extends ObjectTypeDefinition> {
+    where: WhereClause<T>;
+    /**
+     * The number of milliseconds to wait after the last observed list change.
+     *
+     * Two uses of `useOsdkList` with the where clause will only trigger one
+     * network request if the second is within `dedupeIntervalMs`.
+     */
+    dedupeIntervalMs?: number;
+}
+interface UseOsdkListResult<T extends ObjectTypeDefinition> {
+    fetchMore: (() => Promise<unknown>) | undefined;
+    data: Osdk.Instance<T>[];
+    isLoading: boolean;
+    error: undefined;
+    /**
+     * Refers to whether the ordered list of objects (only considering the $primaryKey)
+     * is optimistic or not.
+     *
+     * If you need to know if the contents of the list are optimistic you can
+     * do that on a per object basis with useOsdkObject
+     */
+    isOptimistic: boolean;
+}
+declare function useOsdkList<T extends ObjectTypeDefinition>(type: T, opts: 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>;
+
+export { OsdkProvider2, useOsdkAction, useOsdkList, useOsdkObject };

package/build/cjs/useOsdkClient-B4iwHO1H.d.cts

@@ -0,0 +1,5 @@
+import { Client } from '@osdk/client';
+
+declare function useOsdkClient(): Client;
+
+export { useOsdkClient as u };

package/build/esm/OsdkContext.js

@@ -13,6 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+
 import React from "react";
 function fakeClientFn(..._args) {
   throw new Error("This is not a real client. Did you forget to <OsdkContext.Provider>?");
@@ -20,7 +21,7 @@ function fakeClientFn(..._args) {
 const fakeClient = Object.assign(fakeClientFn, {
   fetchMetadata: fakeClientFn
 });
-export const OsdkContext = React.createContext({
+export const OsdkContext = /*#__PURE__*/React.createContext({
   client: fakeClient
 });
 //# sourceMappingURL=OsdkContext.js.map

package/build/esm/OsdkContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"OsdkContext.js","names":["React","fakeClientFn","_args","Error","fakeClient","Object","assign","fetchMetadata","OsdkContext","createContext","client"],"sources":["OsdkContext.js"],"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 */\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 OsdkContext = React.createContext({\n    client: fakeClient,\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,YAAYA,CAAC,GAAGC,KAAK,EAAE;EAC5B,MAAM,IAAIC,KAAK,CAAC,sEAAsE,CAAC;AAC3F;AACA,MAAMC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAACL,YAAY,EAAE;EAC3CM,aAAa,EAAEN;AACnB,CAAC,CAAC;AACF,OAAO,MAAMO,WAAW,GAAGR,KAAK,CAACS,aAAa,CAAC;EAC3CC,MAAM,EAAEN;AACZ,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"OsdkContext.js","names":["React","fakeClientFn","_args","Error","fakeClient","Object","assign","fetchMetadata","OsdkContext","createContext","client"],"sources":["OsdkContext.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 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\nexport const OsdkContext: React.Context<{\n  client: Client;\n}> = React.createContext<{ client: Client }>({\n  client: fakeClient,\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,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;AAEZ,OAAO,MAAMO,WAEX,gBAAGR,KAAK,CAACS,aAAa,CAAqB;EAC3CC,MAAM,EAAEN;AACV,CAAC,CAAC","ignoreList":[]}

package/build/esm/OsdkProvider.js

@@ -13,13 +13,14 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+
 import React from "react";
 import { OsdkContext } from "./OsdkContext.js";
 export function OsdkProvider({
   children,
   client
 }) {
-  return React.createElement(OsdkContext.Provider, {
+  return /*#__PURE__*/React.createElement(OsdkContext.Provider, {
     value: {
       client
     }

package/build/esm/OsdkProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"OsdkProvider.js","names":["React","OsdkContext","OsdkProvider","children","client","createElement","Provider","value"],"sources":["OsdkProvider.js"],"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 */\nimport React from \"react\";\nimport { OsdkContext } from \"./OsdkContext.js\";\nexport function OsdkProvider({ children, client, }) {\n    return (React.createElement(OsdkContext.Provider, { value: { client } }, children));\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,WAAW,QAAQ,kBAAkB;AAC9C,OAAO,SAASC,YAAYA,CAAC;EAAEC,QAAQ;EAAEC;AAAQ,CAAC,EAAE;EAChD,OAAQJ,KAAK,CAACK,aAAa,CAACJ,WAAW,CAACK,QAAQ,EAAE;IAAEC,KAAK,EAAE;MAAEH;IAAO;EAAE,CAAC,EAAED,QAAQ,CAAC;AACtF","ignoreList":[]}
+{"version":3,"file":"OsdkProvider.js","names":["React","OsdkContext","OsdkProvider","children","client","createElement","Provider","value"],"sources":["OsdkProvider.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 React from \"react\";\nimport { OsdkContext } from \"./OsdkContext.js\";\n\nexport function OsdkProvider({\n  children,\n  client,\n}: {\n  children: React.ReactNode;\n  client: Client;\n}): React.JSX.Element {\n  return (\n    <OsdkContext.Provider value={{ client }}>{children}</OsdkContext.Provider>\n  );\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,WAAW,QAAQ,kBAAkB;AAE9C,OAAO,SAASC,YAAYA,CAAC;EAC3BC,QAAQ;EACRC;AAIF,CAAC,EAAqB;EACpB,oBACEJ,KAAA,CAAAK,aAAA,CAACJ,WAAW,CAACK,QAAQ;IAACC,KAAK,EAAE;MAAEH;IAAO;EAAE,GAAED,QAA+B,CAAC;AAE9E","ignoreList":[]}

package/build/esm/index.js

@@ -13,6 +13,11 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+
+/**
+ * @module @osdk/react
+ */
+
 export { OsdkProvider } from "./OsdkProvider.js";
 export { useOsdkClient } from "./useOsdkClient.js";
 //# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["OsdkProvider","useOsdkClient"],"sources":["index.js"],"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 */\nexport { OsdkProvider } from \"./OsdkProvider.js\";\nexport { useOsdkClient } from \"./useOsdkClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,YAAY,QAAQ,mBAAmB;AAChD,SAASC,aAAa,QAAQ,oBAAoB","ignoreList":[]}
+{"version":3,"file":"index.js","names":["OsdkProvider","useOsdkClient"],"sources":["index.ts"],"sourcesContent":["/*\n * Copyright 2024 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * @module @osdk/react\n */\n\nexport { OsdkProvider } from \"./OsdkProvider.js\";\nexport { useOsdkClient } from \"./useOsdkClient.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA,SAASA,YAAY,QAAQ,mBAAmB;AAChD,SAASC,aAAa,QAAQ,oBAAoB","ignoreList":[]}

package/build/esm/new/OsdkContext2.js

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2024 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+function fakeClientFn(..._args) {
+  throw new Error("This is not a real client. Did you forget to <OsdkContext.Provider>?");
+}
+const fakeClient = Object.assign(fakeClientFn, {
+  fetchMetadata: fakeClientFn
+});
+export const OsdkContext2 = /*#__PURE__*/React.createContext({
+  client: fakeClient,
+  store: undefined
+});
+//# sourceMappingURL=OsdkContext2.js.map

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

@@ -0,0 +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":[]}

package/build/esm/new/OsdkProvider2.js

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2024 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+import { OsdkContext2 } from "./OsdkContext2.js";
+export function OsdkProvider2({
+  children,
+  client,
+  store
+}) {
+  return /*#__PURE__*/React.createElement(OsdkContext2.Provider, {
+    value: {
+      client,
+      store
+    }
+  }, children);
+}
+//# sourceMappingURL=OsdkProvider2.js.map

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

@@ -0,0 +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":[]}

package/build/esm/new/makeExternalStore.js

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export function makeExternalStore(createObservation, name) {
+  let lastResult;
+  function getSnapShot() {
+    return lastResult;
+  }
+  return {
+    subscribe: function subscribe(notifyUpdate) {
+      // eslint-disable-next-line no-console
+      console.log("Subscribing", name);
+      const obs = createObservation(payload => {
+        lastResult = payload;
+        notifyUpdate();
+      });
+      return () => {
+        // eslint-disable-next-line no-console
+        console.log("Unsubscribing", name);
+        obs.unsubscribe();
+      };
+    },
+    getSnapShot
+  };
+}
+//# sourceMappingURL=makeExternalStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"makeExternalStore.js","names":["makeExternalStore","createObservation","name","lastResult","getSnapShot","subscribe","notifyUpdate","console","log","obs","payload","unsubscribe"],"sources":["makeExternalStore.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Unsubscribable } from \"@osdk/client/unstable-do-not-use\";\n\nexport function makeExternalStore<X>(\n  createObservation: (callback: (x: X | undefined) => void) => Unsubscribable,\n  name?: string,\n): {\n  subscribe: (notifyUpdate: () => void) => () => void;\n  getSnapShot: () => X | undefined;\n} {\n  let lastResult: X | undefined;\n\n  function getSnapShot(): X | undefined {\n    return lastResult;\n  }\n\n  function subscribe(notifyUpdate: () => void) {\n    // eslint-disable-next-line no-console\n    console.log(\"Subscribing\", name);\n    const obs = createObservation((payload) => {\n      lastResult = payload;\n      notifyUpdate();\n    });\n\n    return (): void => {\n      // eslint-disable-next-line no-console\n      console.log(\"Unsubscribing\", name);\n      obs.unsubscribe();\n    };\n  }\n\n  return {\n    subscribe,\n    getSnapShot,\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,OAAO,SAASA,iBAAiBA,CAC/BC,iBAA2E,EAC3EC,IAAa,EAIb;EACA,IAAIC,UAAyB;EAE7B,SAASC,WAAWA,CAAA,EAAkB;IACpC,OAAOD,UAAU;EACnB;EAiBA,OAAO;IACLE,SAAS,EAhBX,SAASA,SAASA,CAACC,YAAwB,EAAE;MAC3C;MACAC,OAAO,CAACC,GAAG,CAAC,aAAa,EAAEN,IAAI,CAAC;MAChC,MAAMO,GAAG,GAAGR,iBAAiB,CAAES,OAAO,IAAK;QACzCP,UAAU,GAAGO,OAAO;QACpBJ,YAAY,CAAC,CAAC;MAChB,CAAC,CAAC;MAEF,OAAO,MAAY;QACjB;QACAC,OAAO,CAACC,GAAG,CAAC,eAAe,EAAEN,IAAI,CAAC;QAClCO,GAAG,CAACE,WAAW,CAAC,CAAC;MACnB,CAAC;IACH,CAGW;IACTP;EACF,CAAC;AACH","ignoreList":[]}

package/build/esm/new/useOsdkAction.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { ActionValidationError } from "@osdk/client";
+import React from "react";
+import { OsdkContext2 } from "./OsdkContext2.js";
+export function useOsdkAction(actionDef) {
+  const {
+    store
+  } = React.useContext(OsdkContext2);
+  const [error, setError] = React.useState();
+  const [data, setData] = React.useState();
+  const applyAction = React.useCallback(async function (args, opts) {
+    try {
+      const r = await store.applyAction(actionDef, args, opts);
+      setData(r);
+      return r;
+    } catch (e) {
+      if (e instanceof ActionValidationError) {
+        setError({
+          actionValidation: e
+        });
+      } else {
+        setError({
+          unknown: e
+        });
+      }
+    }
+  }, [store, setError]);
+  return {
+    applyAction,
+    error,
+    data
+  };
+}
+//# sourceMappingURL=useOsdkAction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOsdkAction.js","names":["ActionValidationError","React","OsdkContext2","useOsdkAction","actionDef","store","useContext","error","setError","useState","data","setData","applyAction","useCallback","args","opts","r","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\nexport interface UseOsdkActionResult<Q extends ActionDefinition<any>> {\n  applyAction: (\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts: ObservableClient.ApplyActionOptions,\n  ) => Promise<unknown>;\n\n  error:\n    | undefined\n    | Partial<{\n      actionValidation: ActionValidationError;\n      unknown: unknown;\n    }>;\n  data: unknown;\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\n  const applyAction = React.useCallback(async function applyAction(\n    args: Parameters<ActionSignatureFromDef<Q>[\"applyAction\"]>[0],\n    opts: ObservableClient.ApplyActionOptions,\n  ) {\n    try {\n      const r = await store.applyAction(actionDef, args, opts);\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    }\n  }, [store, setError]);\n\n  return { applyAction, error, data };\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;AAiBhD,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;EAEjD,MAAMG,WAAW,GAAGX,KAAK,CAACY,WAAW,CAAC,gBACpCC,IAA6D,EAC7DC,IAAyC,EACzC;IACA,IAAI;MACF,MAAMC,CAAC,GAAG,MAAMX,KAAK,CAACO,WAAW,CAACR,SAAS,EAAEU,IAAI,EAAEC,IAAI,CAAC;MACxDJ,OAAO,CAACK,CAAC,CAAC;MACV,OAAOA,CAAC;IACV,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV,IAAIA,CAAC,YAAYjB,qBAAqB,EAAE;QACtCQ,QAAQ,CAAC;UACPU,gBAAgB,EAAED;QACpB,CAAC,CAAC;MACJ,CAAC,MAAM;QACLT,QAAQ,CAAC;UAAEW,OAAO,EAAEF;QAAE,CAAC,CAAC;MAC1B;IACF;EACF,CAAC,EAAE,CAACZ,KAAK,EAAEG,QAAQ,CAAC,CAAC;EAErB,OAAO;IAAEI,WAAW;IAAEL,KAAK;IAAEG;EAAK,CAAC;AACrC","ignoreList":[]}

package/build/esm/new/useOsdkList.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+import { makeExternalStore } from "./makeExternalStore.js";
+import { OsdkContext2 } from "./OsdkContext2.js";
+export function useOsdkList(type, opts) {
+  const {
+    store
+  } = React.useContext(OsdkContext2);
+  const where = store.canonicalizeWhereClause(opts.where);
+  const {
+    subscribe,
+    getSnapShot
+  } = React.useMemo(() => makeExternalStore(x => store.observeList(type, where, {
+    dedupeInterval: opts.dedupeIntervalMs ?? 2_000
+  }, x), `list ${type.apiName} ${JSON.stringify(where)}`), [store, type, where, opts.dedupeIntervalMs]);
+  const listPayload = React.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    fetchMore: listPayload?.fetchMore,
+    data: listPayload?.resolvedList,
+    isLoading: listPayload?.status === "loading",
+    error: undefined,
+    isOptimistic: listPayload?.isOptimistic ?? false
+  };
+}
+//# sourceMappingURL=useOsdkList.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useOsdkList.js","names":["React","makeExternalStore","OsdkContext2","useOsdkList","type","opts","store","useContext","where","canonicalizeWhereClause","subscribe","getSnapShot","useMemo","x","observeList","dedupeInterval","dedupeIntervalMs","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 { ObjectTypeDefinition, Osdk, WhereClause } 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  where: WhereClause<T>;\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}\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\nexport function useOsdkList<T extends ObjectTypeDefinition>(\n  type: T,\n  opts: UseOsdkListOptions<T>,\n): UseOsdkListResult<T> {\n  const { store } = React.useContext(OsdkContext2);\n  const where = store.canonicalizeWhereClause(opts.where);\n\n  const { subscribe, getSnapShot } = React.useMemo(\n    () =>\n      makeExternalStore<ListPayload>((x) =>\n        store.observeList(\n          type,\n          where,\n          {\n            dedupeInterval: opts.dedupeIntervalMs ?? 2_000,\n          },\n          x,\n        ), `list ${type.apiName} ${JSON.stringify(where)}`),\n    [store, type, where, opts.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;;AAIA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,iBAAiB,QAAQ,wBAAwB;AAC1D,SAASC,YAAY,QAAQ,mBAAmB;AA+BhD,OAAO,SAASC,WAAWA,CACzBC,IAAO,EACPC,IAA2B,EACL;EACtB,MAAM;IAAEC;EAAM,CAAC,GAAGN,KAAK,CAACO,UAAU,CAACL,YAAY,CAAC;EAChD,MAAMM,KAAK,GAAGF,KAAK,CAACG,uBAAuB,CAACJ,IAAI,CAACG,KAAK,CAAC;EAEvD,MAAM;IAAEE,SAAS;IAAEC;EAAY,CAAC,GAAGX,KAAK,CAACY,OAAO,CAC9C,MACEX,iBAAiB,CAAeY,CAAC,IAC/BP,KAAK,CAACQ,WAAW,CACfV,IAAI,EACJI,KAAK,EACL;IACEO,cAAc,EAAEV,IAAI,CAACW,gBAAgB,IAAI;EAC3C,CAAC,EACDH,CACF,CAAC,EAAE,QAAQT,IAAI,CAACa,OAAO,IAAIC,IAAI,CAACC,SAAS,CAACX,KAAK,CAAC,EAAE,CAAC,EACvD,CAACF,KAAK,EAAEF,IAAI,EAAEI,KAAK,EAAEH,IAAI,CAACW,gBAAgB,CAC5C,CAAC;EAED,MAAMI,WAAW,GAAGpB,KAAK,CAACqB,oBAAoB,CAACX,SAAS,EAAEC,WAAW,CAAC;EAEtE,OAAO;IACLW,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/useOsdkObject.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+import { makeExternalStore } from "./makeExternalStore.js";
+import { OsdkContext2 } from "./OsdkContext2.js";
+
+/**
+ * @param obj an existing `Osdk.Instance` object to get metadata for.
+ */
+
+/**
+ * Loads an object by type and primary key.
+ *
+ * @param type
+ * @param primaryKey
+ */
+
+/*
+    Implementation of useOsdkObject
+ */
+export function useOsdkObject(...args) {
+  const {
+    store
+  } = React.useContext(OsdkContext2);
+
+  // TODO: Figure out what the correct default behavior is for the various scenarios
+  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
+  } = React.useMemo(() => makeExternalStore(payload => store.observeObject(objectType, primaryKey, {
+    mode
+  }, payload), `object ${objectType} ${primaryKey}`), [store, objectType, primaryKey, mode]);
+  const payload = React.useSyncExternalStore(subscribe, getSnapShot);
+  return {
+    object: payload?.object,
+    isLoading: payload?.status === "loading",
+    isOptimistic: payload?.isOptimistic ?? false,
+    forceUpdate: () => {
+      throw "not implemented";
+    }
+  };
+}
+//# sourceMappingURL=useOsdkObject.js.map

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

@@ -0,0 +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":[]}