@osdk/widget.client-react 3.3.0-beta.1 → 3.3.0-beta.11

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # @osdk/widget.client-react
 
+## 3.3.0-beta.11
+
+### Minor Changes
+
+- a8802b3: Add error boundary for custom widgets
+- 8d7b8db: Expand ErrorBoundary to catch all errors
+
+### Patch Changes
+
+- Updated dependencies [84f0eef]
+- Updated dependencies [486ef7e]
+- Updated dependencies [ea077c6]
+  - @osdk/client@2.6.0-beta.13
+  - @osdk/widget.client@3.3.0-beta.11
+
+## 3.3.0-beta.10
+
+### Patch Changes
+
+- Updated dependencies [9961f06]
+  - @osdk/client@2.6.0-beta.12
+  - @osdk/widget.client@3.3.0-beta.10
+
+## 3.3.0-beta.9
+
+### Patch Changes
+
+- Updated dependencies [c5a3815]
+  - @osdk/client@2.6.0-beta.11
+  - @osdk/widget.client@3.3.0-beta.9
+
+## 3.3.0-beta.8
+
+### Patch Changes
+
+- Updated dependencies [3fbb596]
+  - @osdk/client@2.6.0-beta.10
+  - @osdk/widget.client@3.3.0-beta.8
+
+## 3.3.0-beta.7
+
+### Patch Changes
+
+- @osdk/client@2.6.0-beta.9
+- @osdk/widget.client@3.3.0-beta.7
+
+## 3.3.0-beta.6
+
+### Patch Changes
+
+- Updated dependencies [a1ffb20]
+- Updated dependencies [e62c692]
+  - @osdk/client@2.6.0-beta.8
+  - @osdk/widget.client@3.3.0-beta.6
+
+## 3.3.0-beta.5
+
+### Patch Changes
+
+- Updated dependencies [507ec7f]
+  - @osdk/client@2.6.0-beta.7
+  - @osdk/widget.client@3.3.0-beta.5
+
+## 3.3.0-beta.4
+
+### Patch Changes
+
+- Updated dependencies [b959085]
+  - @osdk/client@2.6.0-beta.6
+  - @osdk/widget.client@3.3.0-beta.4
+
+## 3.3.0-beta.3
+
+### Patch Changes
+
+- Updated dependencies [b48526f]
+  - @osdk/client@2.6.0-beta.5
+  - @osdk/widget.client@3.3.0-beta.3
+
+## 3.3.0-beta.2
+
+### Minor Changes
+
+- 4d37e98: Improved support for object set parameters in widget.client-react
+
+### Patch Changes
+
+- @osdk/widget.client@3.3.0-beta.2
+
 ## 3.2.0-beta.5
 
 ### Patch Changes

package/build/browser/ErrorBoundary.js

@@ -0,0 +1,63 @@
+/*
+ * 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 * as React from "react";
+/**
+ * Error boundary to catch and display errors in widget code.
+ */
+export class ErrorBoundary extends React.Component {
+  state = {
+    error: null
+  };
+  static getDerivedStateFromError(error) {
+    return {
+      error
+    };
+  }
+  render() {
+    if (this.state.error) {
+      const errorDetails = this.state.error instanceof Error ? this.state.error.stack : "See browser console for more details.";
+      return /*#__PURE__*/React.createElement("section", {
+        style: {
+          padding: "16px"
+        }
+      }, /*#__PURE__*/React.createElement("h3", {
+        style: {
+          margin: "0 0 12px 0",
+          color: "#c00"
+        }
+      }, "An uncaught error occurred"), process.env.NODE_ENV !== "production" && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("p", {
+        style: {
+          margin: "0 0 8px 0"
+        }
+      }, "This error was caught by the widget framework's fallback error boundary."), /*#__PURE__*/React.createElement("ul", {
+        style: {
+          margin: "0 0 16px 0"
+        }
+      }, /*#__PURE__*/React.createElement("li", null, "Ensure errors are properly handled in your code with try-catch blocks and promise rejection handling."), /*#__PURE__*/React.createElement("li", null, "Add your own error boundary to replace this fallback with a custom error message or recovery options for your users."), /*#__PURE__*/React.createElement("li", null, "See:", " ", /*#__PURE__*/React.createElement("code", null, "https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary")))), /*#__PURE__*/React.createElement("pre", {
+        style: {
+          backgroundColor: "#f5f5f5",
+          padding: "12px",
+          overflow: "auto",
+          fontSize: "12px",
+          margin: 0
+        }
+      }, errorDetails));
+    }
+    return this.props.children;
+  }
+}
+//# sourceMappingURL=ErrorBoundary.js.map

package/build/browser/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","names":["React","ErrorBoundary","Component","state","error","getDerivedStateFromError","render","errorDetails","Error","stack","createElement","style","padding","margin","color","process","env","NODE_ENV","Fragment","backgroundColor","overflow","fontSize","props","children"],"sources":["ErrorBoundary.tsx"],"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 * as React from \"react\";\n\ninterface State {\n  error: unknown;\n}\n\n/**\n * Error boundary to catch and display errors in widget code.\n */\nexport class ErrorBoundary extends React.Component<\n  React.PropsWithChildren,\n  State\n> {\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: unknown): Partial<State> {\n    return { error };\n  }\n\n  render(): React.ReactNode {\n    if (this.state.error) {\n      const errorDetails = this.state.error instanceof Error\n        ? this.state.error.stack\n        : \"See browser console for more details.\";\n\n      return (\n        <section style={{ padding: \"16px\" }}>\n          <h3 style={{ margin: \"0 0 12px 0\", color: \"#c00\" }}>\n            An uncaught error occurred\n          </h3>\n          {process.env.NODE_ENV !== \"production\" && (\n            <>\n              <p style={{ margin: \"0 0 8px 0\" }}>\n                This error was caught by the widget framework's fallback error\n                boundary.\n              </p>\n              <ul style={{ margin: \"0 0 16px 0\" }}>\n                <li>\n                  Ensure errors are properly handled in your code with try-catch\n                  blocks and promise rejection handling.\n                </li>\n                <li>\n                  Add your own error boundary to replace this fallback with a\n                  custom error message or recovery options for your users.\n                </li>\n                <li>\n                  See:{\" \"}\n                  <code>\n                    https://react.dev/reference/react/Component#catching-rendering-errors-with-an-error-boundary\n                  </code>\n                </li>\n              </ul>\n            </>\n          )}\n          <pre\n            style={{\n              backgroundColor: \"#f5f5f5\",\n              padding: \"12px\",\n              overflow: \"auto\",\n              fontSize: \"12px\",\n              margin: 0,\n            }}\n          >\n            {errorDetails}\n          </pre>\n        </section>\n      );\n    }\n\n    return this.props.children;\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAM9B;AACA;AACA;AACA,OAAO,MAAMC,aAAa,SAASD,KAAK,CAACE,SAAS,CAGhD;EACAC,KAAK,GAAU;IAAEC,KAAK,EAAE;EAAK,CAAC;EAE9B,OAAOC,wBAAwBA,CAACD,KAAc,EAAkB;IAC9D,OAAO;MAAEA;IAAM,CAAC;EAClB;EAEAE,MAAMA,CAAA,EAAoB;IACxB,IAAI,IAAI,CAACH,KAAK,CAACC,KAAK,EAAE;MACpB,MAAMG,YAAY,GAAG,IAAI,CAACJ,KAAK,CAACC,KAAK,YAAYI,KAAK,GAClD,IAAI,CAACL,KAAK,CAACC,KAAK,CAACK,KAAK,GACtB,uCAAuC;MAE3C,oBACET,KAAA,CAAAU,aAAA;QAASC,KAAK,EAAE;UAAEC,OAAO,EAAE;QAAO;MAAE,gBAClCZ,KAAA,CAAAU,aAAA;QAAIC,KAAK,EAAE;UAAEE,MAAM,EAAE,YAAY;UAAEC,KAAK,EAAE;QAAO;MAAE,GAAC,4BAEhD,CAAC,EACJC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,iBACpCjB,KAAA,CAAAU,aAAA,CAAAV,KAAA,CAAAkB,QAAA,qBACElB,KAAA,CAAAU,aAAA;QAAGC,KAAK,EAAE;UAAEE,MAAM,EAAE;QAAY;MAAE,GAAC,0EAGhC,CAAC,eACJb,KAAA,CAAAU,aAAA;QAAIC,KAAK,EAAE;UAAEE,MAAM,EAAE;QAAa;MAAE,gBAClCb,KAAA,CAAAU,aAAA,aAAI,uGAGA,CAAC,eACLV,KAAA,CAAAU,aAAA,aAAI,sHAGA,CAAC,eACLV,KAAA,CAAAU,aAAA,aAAI,MACE,EAAC,GAAG,eACRV,KAAA,CAAAU,aAAA,eAAM,8FAEA,CACJ,CACF,CACJ,CACH,eACDV,KAAA,CAAAU,aAAA;QACEC,KAAK,EAAE;UACLQ,eAAe,EAAE,SAAS;UAC1BP,OAAO,EAAE,MAAM;UACfQ,QAAQ,EAAE,MAAM;UAChBC,QAAQ,EAAE,MAAM;UAChBR,MAAM,EAAE;QACV;MAAE,GAEDN,YACE,CACE,CAAC;IAEd;IAEA,OAAO,IAAI,CAACe,KAAK,CAACC,QAAQ;EAC5B;AACF","ignoreList":[]}

package/build/browser/client.js

@@ -15,8 +15,10 @@
  */
 
 import { createFoundryWidgetClient } from "@osdk/widget.client";
-import React, { useEffect, useMemo } from "react";
+import React, { useEffect, useMemo, useRef } from "react";
 import { FoundryWidgetContext } from "./context.js";
+import { ErrorBoundary } from "./ErrorBoundary.js";
+import { extendParametersWithObjectSets } from "./utils/extendParametersWithObjectSets.js";
 import { initializeParameters } from "./utils/initializeParameters.js";
 /**
  * Handles subscribing to messages from the host Foundry UI and updating the widget's parameter values accordingly via React context
@@ -24,26 +26,29 @@ import { initializeParameters } from "./utils/initializeParameters.js";
 export const FoundryWidget = ({
   children,
   config,
-  initialValues
+  initialValues,
+  client: osdkClient
 }) => {
   const client = useMemo(() => createFoundryWidgetClient(), []);
   const [asyncParameterValues, setAsyncParameterValues] = React.useState(initialValues ?? initializeParameters(config, "not-started"));
   const [allParameterValues, setAllParameterValues] = React.useState({
     type: "not-started"
   });
+  const objectSetCache = useRef(new Map());
   useEffect(() => {
     client.subscribe();
     client.hostEventTarget.addEventListener("host.update-parameters", payload => {
+      const processedParameters = extendParametersWithObjectSets(osdkClient, config, payload.detail.parameters, objectSetCache.current);
       setAsyncParameterValues(currentParameters => ({
         ...currentParameters,
-        ...payload.detail.parameters
+        ...processedParameters
       }));
       setAllParameterValues(currentParameters => {
         let aggregatedLoadedState = "loaded";
         let firstError;
         const newParameterValues = {};
-        for (const key in payload.detail.parameters) {
-          const value = payload.detail.parameters[key].value;
+        for (const key in processedParameters) {
+          const value = processedParameters[key].value;
           // If any fails, consider the whole thing failed
           if (value.type === "failed") {
             aggregatedLoadedState = "failed";
@@ -106,6 +111,6 @@ export const FoundryWidget = ({
       }
       // Unfortunately the context is statically defined so we can't use the generic type, hence the cast
     }
-  }, children);
+  }, /*#__PURE__*/React.createElement(ErrorBoundary, null, children));
 };
 //# sourceMappingURL=client.js.map

package/build/browser/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":["createFoundryWidgetClient","React","useEffect","useMemo","FoundryWidgetContext","initializeParameters","FoundryWidget","children","config","initialValues","client","asyncParameterValues","setAsyncParameterValues","useState","allParameterValues","setAllParameterValues","type","subscribe","hostEventTarget","addEventListener","payload","currentParameters","detail","parameters","aggregatedLoadedState","firstError","newParameterValues","key","value","error","currentParameterValue","updatedValue","Error","ready","unsubscribe","createElement","Provider","emitEvent","values","state"],"sources":["client.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 {\n  AsyncParameterValueMap,\n  AsyncValue,\n  ParameterConfig,\n  ParameterValueMap,\n  WidgetConfig,\n} from \"@osdk/widget.client\";\nimport { createFoundryWidgetClient } from \"@osdk/widget.client\";\nimport React, { useEffect, useMemo } from \"react\";\nimport type { FoundryWidgetClientContext } from \"./context.js\";\nimport { FoundryWidgetContext } from \"./context.js\";\nimport { initializeParameters } from \"./utils/initializeParameters.js\";\n\ninterface FoundryWidgetProps<C extends WidgetConfig<C[\"parameters\"]>> {\n  children: React.ReactNode;\n\n  /**\n   * Parameter configuration for the widget\n   */\n  config: C;\n\n  /**\n   * Customize what the initial value of each parameter should be\n   *\n   * @default Sets all parameters to the \"not-started\" loading state\n   */\n  initialValues?: AsyncParameterValueMap<C>;\n}\n\n/**\n * Handles subscribing to messages from the host Foundry UI and updating the widget's parameter values accordingly via React context\n */\nexport const FoundryWidget = <C extends WidgetConfig<C[\"parameters\"]>>({\n  children,\n  config,\n  initialValues,\n}: FoundryWidgetProps<C>): React.ReactElement<FoundryWidgetProps<C>> => {\n  const client = useMemo(() => createFoundryWidgetClient<C>(), []);\n  const [asyncParameterValues, setAsyncParameterValues] = React.useState<\n    AsyncParameterValueMap<C>\n  >(initialValues ?? initializeParameters(config, \"not-started\"));\n  const [allParameterValues, setAllParameterValues] = React.useState<\n    AsyncValue<ParameterValueMap<C>>\n  >({\n    type: \"not-started\",\n  });\n\n  useEffect(() => {\n    client.subscribe();\n    client.hostEventTarget.addEventListener(\n      \"host.update-parameters\",\n      (payload) => {\n        setAsyncParameterValues((currentParameters) => ({\n          ...currentParameters,\n          ...payload.detail.parameters,\n        }));\n        setAllParameterValues((currentParameters) => {\n          let aggregatedLoadedState: AsyncValue<any>[\"type\"] = \"loaded\";\n          let firstError: Error | undefined;\n          const newParameterValues: ParameterValueMap<\n            WidgetConfig<ParameterConfig>\n          > = {};\n          for (const key in payload.detail.parameters) {\n            const value = payload.detail.parameters[key].value;\n            // If any fails, consider the whole thing failed\n            if (value.type === \"failed\") {\n              aggregatedLoadedState = \"failed\";\n              firstError = firstError ?? value.error;\n              newParameterValues[key as any] = value.value as any;\n              continue;\n            }\n            // If any is loading, consider all of it loading unless we have failed somewhere\n            if (\n              value.type === \"loading\"\n              && aggregatedLoadedState !== \"failed\"\n            ) {\n              aggregatedLoadedState = \"loading\";\n              continue;\n            }\n            // If any is reloading, consider it loading unless something is failed or loading for the first time\n            if (\n              value.type === \"reloading\"\n              && aggregatedLoadedState !== \"failed\"\n              && aggregatedLoadedState !== \"loading\"\n            ) {\n              aggregatedLoadedState = \"reloading\";\n              newParameterValues[key as any] = value.value as any;\n              continue;\n            }\n            if (\n              value.type === \"not-started\"\n              && aggregatedLoadedState !== \"failed\"\n              && aggregatedLoadedState !== \"loading\"\n              && aggregatedLoadedState !== \"reloading\"\n            ) {\n              aggregatedLoadedState = \"not-started\";\n            }\n\n            if (value.type === \"loaded\") {\n              newParameterValues[key as any] = value.value as any;\n            }\n          }\n          const currentParameterValue = currentParameters.type !== \"not-started\"\n              && currentParameters.type !== \"loading\"\n            ? currentParameters.value\n            : {};\n          if (\n            aggregatedLoadedState !== \"not-started\"\n            && aggregatedLoadedState !== \"loading\"\n          ) {\n            const updatedValue = {\n              ...currentParameterValue,\n              ...newParameterValues,\n            } as ParameterValueMap<C>;\n            return aggregatedLoadedState === \"failed\"\n              ? {\n                type: aggregatedLoadedState,\n                value: updatedValue,\n                error: firstError ?? new Error(\"Failed to load parameters\"),\n              }\n              : {\n                type: aggregatedLoadedState,\n                value: updatedValue,\n              };\n          } else {\n            return { type: aggregatedLoadedState };\n          }\n        });\n      },\n    );\n    client.ready();\n    return () => {\n      client.unsubscribe();\n    };\n  }, []);\n\n  return (\n    <FoundryWidgetContext.Provider\n      value={{\n        emitEvent: client.emitEvent,\n        hostEventTarget: client.hostEventTarget,\n        asyncParameterValues,\n        parameters: {\n          values: allParameterValues.value ?? {},\n          state: allParameterValues.type,\n        },\n        // Unfortunately the context is statically defined so we can't use the generic type, hence the cast\n      } as FoundryWidgetClientContext<WidgetConfig<ParameterConfig>>}\n    >\n      {children}\n    </FoundryWidgetContext.Provider>\n  );\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"client.js","names":["createFoundryWidgetClient","React","useEffect","useMemo","useRef","FoundryWidgetContext","ErrorBoundary","extendParametersWithObjectSets","initializeParameters","FoundryWidget","children","config","initialValues","client","osdkClient","asyncParameterValues","setAsyncParameterValues","useState","allParameterValues","setAllParameterValues","type","objectSetCache","Map","subscribe","hostEventTarget","addEventListener","payload","processedParameters","detail","parameters","current","currentParameters","aggregatedLoadedState","firstError","newParameterValues","key","value","error","currentParameterValue","updatedValue","Error","ready","unsubscribe","createElement","Provider","emitEvent","values","state"],"sources":["client.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, ObjectSet } from \"@osdk/client\";\nimport type { ObjectType } from \"@osdk/widget.api\";\nimport type {\n  AsyncValue,\n  ParameterConfig,\n  WidgetConfig,\n} from \"@osdk/widget.client\";\nimport { createFoundryWidgetClient } from \"@osdk/widget.client\";\nimport React, { useEffect, useMemo, useRef } from \"react\";\nimport type {\n  ExtendedAsyncParameterValueMap,\n  ExtendedParameterValueMap,\n  FoundryWidgetClientContext,\n} from \"./context.js\";\nimport { FoundryWidgetContext } from \"./context.js\";\nimport { ErrorBoundary } from \"./ErrorBoundary.js\";\nimport { extendParametersWithObjectSets } from \"./utils/extendParametersWithObjectSets.js\";\nimport { initializeParameters } from \"./utils/initializeParameters.js\";\n\ntype ExtractObjectTypes<C extends WidgetConfig<C[\"parameters\"]>> =\n  C[\"parameters\"][keyof C[\"parameters\"]] extends infer Param\n    ? Param extends { type: \"objectSet\"; objectType: infer OT }\n      ? OT extends ObjectType ? OT : never\n    : never\n    : never;\n\ntype HasObjectSetParameters<C extends WidgetConfig<C[\"parameters\"]>> =\n  ExtractObjectTypes<C> extends never ? false : true;\n\ntype ObjectSetProps<C extends WidgetConfig<C[\"parameters\"]>> = {\n  /**\n   * Used to hydrate object sets from their RIDs for object set parameters\n   */\n  client: Client;\n};\n\ntype FoundryWidgetProps<C extends WidgetConfig<C[\"parameters\"]>> =\n  & {\n    children: React.ReactNode;\n\n    /**\n     * Parameter configuration for the widget\n     */\n    config: C;\n\n    /**\n     * Customize what the initial value of each parameter should be\n     *\n     * @default Sets all parameters to the \"not-started\" loading state\n     */\n    initialValues?: ExtendedAsyncParameterValueMap<C>;\n  }\n  & Partial<ObjectSetProps<C>>\n  & (HasObjectSetParameters<C> extends true ? ObjectSetProps<C> : {});\n\n/**\n * Handles subscribing to messages from the host Foundry UI and updating the widget's parameter values accordingly via React context\n */\nexport const FoundryWidget = <C extends WidgetConfig<C[\"parameters\"]>>({\n  children,\n  config,\n  initialValues,\n  client: osdkClient,\n}: FoundryWidgetProps<C>): React.ReactElement<FoundryWidgetProps<C>> => {\n  const client = useMemo(() => createFoundryWidgetClient<C>(), []);\n  const [asyncParameterValues, setAsyncParameterValues] = React.useState<\n    ExtendedAsyncParameterValueMap<C>\n  >(initialValues ?? initializeParameters(config, \"not-started\"));\n  const [allParameterValues, setAllParameterValues] = React.useState<\n    AsyncValue<ExtendedParameterValueMap<C>>\n  >({\n    type: \"not-started\",\n  });\n\n  const objectSetCache = useRef<\n    Map<string, { objectSetRid: string; objectSet: ObjectSet }>\n  >(new Map());\n\n  useEffect(() => {\n    client.subscribe();\n    client.hostEventTarget.addEventListener(\n      \"host.update-parameters\",\n      (payload) => {\n        const processedParameters = extendParametersWithObjectSets(\n          osdkClient,\n          config,\n          payload.detail.parameters,\n          objectSetCache.current,\n        );\n        setAsyncParameterValues((currentParameters) => ({\n          ...currentParameters,\n          ...processedParameters,\n        }));\n        setAllParameterValues((currentParameters) => {\n          let aggregatedLoadedState: AsyncValue<any>[\"type\"] = \"loaded\";\n          let firstError: Error | undefined;\n          const newParameterValues: ExtendedParameterValueMap<\n            WidgetConfig<ParameterConfig>\n          > = {};\n          for (const key in processedParameters) {\n            const value = processedParameters[key].value;\n            // If any fails, consider the whole thing failed\n            if (value.type === \"failed\") {\n              aggregatedLoadedState = \"failed\";\n              firstError = firstError ?? value.error;\n              newParameterValues[key as any] = value.value as any;\n              continue;\n            }\n            // If any is loading, consider all of it loading unless we have failed somewhere\n            if (\n              value.type === \"loading\"\n              && aggregatedLoadedState !== \"failed\"\n            ) {\n              aggregatedLoadedState = \"loading\";\n              continue;\n            }\n            // If any is reloading, consider it loading unless something is failed or loading for the first time\n            if (\n              value.type === \"reloading\"\n              && aggregatedLoadedState !== \"failed\"\n              && aggregatedLoadedState !== \"loading\"\n            ) {\n              aggregatedLoadedState = \"reloading\";\n              newParameterValues[key as any] = value.value as any;\n              continue;\n            }\n            if (\n              value.type === \"not-started\"\n              && aggregatedLoadedState !== \"failed\"\n              && aggregatedLoadedState !== \"loading\"\n              && aggregatedLoadedState !== \"reloading\"\n            ) {\n              aggregatedLoadedState = \"not-started\";\n            }\n\n            if (value.type === \"loaded\") {\n              newParameterValues[key as any] = value.value as any;\n            }\n          }\n          const currentParameterValue = currentParameters.type !== \"not-started\"\n              && currentParameters.type !== \"loading\"\n            ? currentParameters.value\n            : {};\n          if (\n            aggregatedLoadedState !== \"not-started\"\n            && aggregatedLoadedState !== \"loading\"\n          ) {\n            const updatedValue = {\n              ...currentParameterValue,\n              ...newParameterValues,\n            } as ExtendedParameterValueMap<C>;\n            return aggregatedLoadedState === \"failed\"\n              ? {\n                type: aggregatedLoadedState,\n                value: updatedValue,\n                error: firstError ?? new Error(\"Failed to load parameters\"),\n              }\n              : {\n                type: aggregatedLoadedState,\n                value: updatedValue,\n              };\n          } else {\n            return { type: aggregatedLoadedState };\n          }\n        });\n      },\n    );\n    client.ready();\n    return () => {\n      client.unsubscribe();\n    };\n  }, []);\n\n  return (\n    <FoundryWidgetContext.Provider\n      value={{\n        emitEvent: client.emitEvent,\n        hostEventTarget: client.hostEventTarget,\n        asyncParameterValues,\n        parameters: {\n          values: allParameterValues.value ?? {},\n          state: allParameterValues.type,\n        },\n        // Unfortunately the context is statically defined so we can't use the generic type, hence the cast\n      } as FoundryWidgetClientContext<WidgetConfig<ParameterConfig>>}\n    >\n      <ErrorBoundary>\n        {children}\n      </ErrorBoundary>\n    </FoundryWidgetContext.Provider>\n  );\n};\n"],"mappings":"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","ignoreList":[]}

package/build/browser/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":["FoundryHostEventTarget","React","useContext","FoundryWidgetContext","createContext","emitEvent","hostEventTarget","asyncParameterValues","parameters","state","values","useFoundryWidgetContext","_useFoundryWidgetContext","withTypes"],"sources":["context.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 {\n  type AsyncParameterValueMap,\n  type AsyncValue,\n  FoundryHostEventTarget,\n  type FoundryWidgetClient,\n  type ParameterConfig,\n  type ParameterValueMap,\n  type WidgetConfig,\n} from \"@osdk/widget.client\";\nimport React, { useContext } from \"react\";\n\nexport interface FoundryWidgetClientContext<\n  C extends WidgetConfig<C[\"parameters\"]>,\n> {\n  emitEvent: FoundryWidgetClient<C>[\"emitEvent\"];\n  hostEventTarget: FoundryHostEventTarget<C>;\n\n  /**\n   * Object where the individual parameters have their async state represented\n   */\n  asyncParameterValues: AsyncParameterValueMap<C>;\n\n  /**\n   * Convenience object that aggregates the value of all parameters, accounting for their loading states\n   */\n  parameters: {\n    values: Partial<ParameterValueMap<C>>;\n    state: AsyncValue<ParameterValueMap<C>>[\"type\"];\n  };\n}\n\nexport const FoundryWidgetContext: React.Context<\n  FoundryWidgetClientContext<WidgetConfig<ParameterConfig>>\n> = React.createContext<\n  FoundryWidgetClientContext<WidgetConfig<ParameterConfig>>\n>({\n  emitEvent: () => {},\n  hostEventTarget: new FoundryHostEventTarget<WidgetConfig<ParameterConfig>>(),\n  asyncParameterValues: {},\n  parameters: {\n    state: \"not-started\",\n    values: {},\n  },\n});\n\n/**\n * @returns The current FoundryWidgetClientContext, in the context of your specific parameter configuration\n */\nexport function useFoundryWidgetContext<\n  C extends WidgetConfig<C[\"parameters\"]>,\n>() {\n  return useContext(FoundryWidgetContext) as FoundryWidgetClientContext<C>;\n}\n\nexport namespace useFoundryWidgetContext {\n  export function withTypes<\n    C extends WidgetConfig<C[\"parameters\"]>,\n  >(): () => FoundryWidgetClientContext<C> {\n    return () => {\n      return useFoundryWidgetContext<C>();\n    };\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAGEA,sBAAsB,QAKjB,qBAAqB;AAC5B,OAAOC,KAAK,IAAIC,UAAU,QAAQ,OAAO;AAsBzC,OAAO,MAAMC,oBAEZ,gBAAGF,KAAK,CAACG,aAAa,CAErB;EACAC,SAAS,EAAEA,CAAA,KAAM,CAAC,CAAC;EACnBC,eAAe,EAAE,IAAIN,sBAAsB,CAAgC,CAAC;EAC5EO,oBAAoB,EAAE,CAAC,CAAC;EACxBC,UAAU,EAAE;IACVC,KAAK,EAAE,aAAa;IACpBC,MAAM,EAAE,CAAC;EACX;AACF,CAAC,CAAC;;AAEF;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAAA,EAEnC;EACF,OAAOT,UAAU,CAACC,oBAAoB,CAAC;AACzC;AAAC,WAAAS,wBAAA;EAAAA,wBAAA,CAAAC,SAAA,GAGQ,YAEkC;IACvC,OAAO,MAAM;MACX,OAAOF,uBAAuB,CAAI,CAAC;IACrC,CAAC;EACH,CAAC;AAAA,GAPcA,uBAAuB,KAAvBA,uBAAuB","ignoreList":[]}
+{"version":3,"file":"context.js","names":["FoundryHostEventTarget","React","useContext","FoundryWidgetContext","createContext","emitEvent","hostEventTarget","asyncParameterValues","parameters","state","values","useFoundryWidgetContext","_useFoundryWidgetContext","withTypes"],"sources":["context.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 { ObjectSet } from \"@osdk/client\";\nimport type { ObjectType } from \"@osdk/widget.api\";\nimport {\n  type AsyncParameterValueMap,\n  type AsyncValue,\n  FoundryHostEventTarget,\n  type FoundryWidgetClient,\n  type ParameterConfig,\n  type ParameterValueMap,\n  type WidgetConfig,\n} from \"@osdk/widget.client\";\nimport React, { useContext } from \"react\";\n\nexport interface FoundryWidgetClientContext<\n  C extends WidgetConfig<C[\"parameters\"]>,\n> {\n  emitEvent: FoundryWidgetClient<C>[\"emitEvent\"];\n  hostEventTarget: FoundryHostEventTarget<C>;\n\n  /**\n   * Object where the individual parameters have their async state represented\n   */\n  asyncParameterValues: ExtendedAsyncParameterValueMap<C>;\n\n  /**\n   * Convenience object that aggregates the value of all parameters, accounting for their loading states\n   */\n  parameters: {\n    values: Partial<ExtendedParameterValueMap<C>>;\n    state: AsyncValue<ParameterValueMap<C>>[\"type\"];\n  };\n}\n\nexport type ExtendedParameterValueMap<C extends WidgetConfig<C[\"parameters\"]>> =\n  {\n    [K in keyof C[\"parameters\"]]: K extends keyof ParameterValueMap<C>\n      ? C[\"parameters\"][K] extends { type: \"objectSet\"; objectType: infer T }\n        ? T extends ObjectType\n          ? ParameterValueMap<C>[K] & { objectSet: ObjectSet<T> }\n        : ParameterValueMap<C>[K]\n      : ParameterValueMap<C>[K]\n      : never;\n  };\n\nexport type ExtendedAsyncParameterValueMap<\n  C extends WidgetConfig<C[\"parameters\"]>,\n> = {\n  [K in keyof C[\"parameters\"]]: K extends keyof AsyncParameterValueMap<C>\n    ? C[\"parameters\"][K] extends { type: \"objectSet\"; objectType: infer T }\n      ? T extends ObjectType ? AsyncParameterValueMap<C>[K] & {\n          value: AsyncValue<\n            ParameterValueMap<C>[K] & { objectSet: ObjectSet<T> }\n          >;\n        }\n      : AsyncParameterValueMap<C>[K]\n    : AsyncParameterValueMap<C>[K]\n    : never;\n};\n\nexport const FoundryWidgetContext: React.Context<\n  FoundryWidgetClientContext<WidgetConfig<ParameterConfig>>\n> = React.createContext<\n  FoundryWidgetClientContext<WidgetConfig<ParameterConfig>>\n>({\n  emitEvent: () => {},\n  hostEventTarget: new FoundryHostEventTarget<WidgetConfig<ParameterConfig>>(),\n  asyncParameterValues: {},\n  parameters: {\n    state: \"not-started\",\n    values: {},\n  },\n});\n\n/**\n * @returns The current FoundryWidgetClientContext, in the context of your specific parameter configuration\n */\nexport function useFoundryWidgetContext<\n  C extends WidgetConfig<C[\"parameters\"]>,\n>() {\n  return useContext(FoundryWidgetContext) as FoundryWidgetClientContext<C>;\n}\n\nexport namespace useFoundryWidgetContext {\n  export function withTypes<\n    C extends WidgetConfig<C[\"parameters\"]>,\n  >(): () => FoundryWidgetClientContext<C> {\n    return () => {\n      return useFoundryWidgetContext<C>();\n    };\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,SAGEA,sBAAsB,QAKjB,qBAAqB;AAC5B,OAAOC,KAAK,IAAIC,UAAU,QAAQ,OAAO;AAgDzC,OAAO,MAAMC,oBAEZ,gBAAGF,KAAK,CAACG,aAAa,CAErB;EACAC,SAAS,EAAEA,CAAA,KAAM,CAAC,CAAC;EACnBC,eAAe,EAAE,IAAIN,sBAAsB,CAAgC,CAAC;EAC5EO,oBAAoB,EAAE,CAAC,CAAC;EACxBC,UAAU,EAAE;IACVC,KAAK,EAAE,aAAa;IACpBC,MAAM,EAAE,CAAC;EACX;AACF,CAAC,CAAC;;AAEF;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAAA,EAEnC;EACF,OAAOT,UAAU,CAACC,oBAAoB,CAAC;AACzC;AAAC,WAAAS,wBAAA;EAAAA,wBAAA,CAAAC,SAAA,GAGQ,YAEkC;IACvC,OAAO,MAAM;MACX,OAAOF,uBAAuB,CAAI,CAAC;IACrC,CAAC;EACH,CAAC;AAAA,GAPcA,uBAAuB,KAAvBA,uBAAuB","ignoreList":[]}

package/build/browser/utils/extendParametersWithObjectSets.js

@@ -0,0 +1,62 @@
+/*
+ * 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 { hydrateObjectSetFromRid } from "@osdk/client/internal";
+/**
+ * Patches parameter values with hydrated object sets for object set parameters.
+ *
+ * The cache is used to avoid redundant hydration of the same object set RID, which
+ * can cause unnecessary re-renders in React components consuming the parameters.
+ */
+export function extendParametersWithObjectSets(osdkClient, config, parameters, cache) {
+  const extendedParameters = {
+    ...parameters
+  };
+  for (const parameterId of Object.keys(extendedParameters)) {
+    const param = config.parameters[parameterId];
+    if (param.type === "objectSet" && extendedParameters[parameterId].type === "objectSet") {
+      const parameterValue = extendedParameters[parameterId].value.value;
+      if (parameterValue != null) {
+        if (typeof parameterValue === "object" && "objectSetRid" in parameterValue && typeof parameterValue.objectSetRid === "string") {
+          const objectSetRid = parameterValue.objectSetRid;
+          const objectSet = getOrHydrateObjectSet(osdkClient, cache, parameterId, objectSetRid, param.objectType);
+          parameterValue.objectSet = objectSet;
+        } else {
+          throw new Error(`Invalid object set parameter value for parameter "${parameterId}"`);
+        }
+      } else {
+        cache.delete(parameterId);
+      }
+    }
+  }
+  return extendedParameters;
+}
+function getOrHydrateObjectSet(osdkClient, cache, paramKey, objectSetRid, definition) {
+  if (osdkClient == null) {
+    throw new Error("Not provided an OSDK client");
+  }
+  const cached = cache.get(paramKey);
+  if (cached?.objectSetRid === objectSetRid) {
+    return cached.objectSet;
+  }
+  const objectSet = hydrateObjectSetFromRid(osdkClient, definition, objectSetRid);
+  cache.set(paramKey, {
+    objectSetRid,
+    objectSet
+  });
+  return objectSet;
+}
+//# sourceMappingURL=extendParametersWithObjectSets.js.map

package/build/browser/utils/extendParametersWithObjectSets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extendParametersWithObjectSets.js","names":["hydrateObjectSetFromRid","extendParametersWithObjectSets","osdkClient","config","parameters","cache","extendedParameters","parameterId","Object","keys","param","type","parameterValue","value","objectSetRid","objectSet","getOrHydrateObjectSet","objectType","Error","delete","paramKey","definition","cached","get","set"],"sources":["extendParametersWithObjectSets.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 { Client, ObjectSet, ObjectTypeDefinition } from \"@osdk/client\";\nimport { hydrateObjectSetFromRid } from \"@osdk/client/internal\";\nimport type { AsyncParameterValueMap, WidgetConfig } from \"@osdk/widget.api\";\nimport type { ExtendedAsyncParameterValueMap } from \"../context.js\";\n\n/**\n * Patches parameter values with hydrated object sets for object set parameters.\n *\n * The cache is used to avoid redundant hydration of the same object set RID, which\n * can cause unnecessary re-renders in React components consuming the parameters.\n */\nexport function extendParametersWithObjectSets<\n  C extends WidgetConfig<C[\"parameters\"]>,\n>(\n  osdkClient: Client | undefined,\n  config: C,\n  parameters: AsyncParameterValueMap<C>,\n  cache: Map<string, { objectSetRid: string; objectSet: ObjectSet }>,\n): ExtendedAsyncParameterValueMap<C> {\n  const extendedParameters = {\n    ...parameters,\n  } as ExtendedAsyncParameterValueMap<C>;\n\n  for (const parameterId of Object.keys(extendedParameters)) {\n    const param = config.parameters[parameterId];\n    if (\n      param.type === \"objectSet\"\n      && extendedParameters[parameterId].type === \"objectSet\"\n    ) {\n      const parameterValue = extendedParameters[parameterId].value.value;\n      if (parameterValue != null) {\n        if (\n          typeof parameterValue === \"object\"\n          && \"objectSetRid\" in parameterValue\n          && typeof parameterValue.objectSetRid === \"string\"\n        ) {\n          const objectSetRid = parameterValue.objectSetRid;\n          const objectSet = getOrHydrateObjectSet(\n            osdkClient,\n            cache,\n            parameterId,\n            objectSetRid,\n            param.objectType as ObjectTypeDefinition,\n          );\n          (parameterValue as any).objectSet = objectSet;\n        } else {\n          throw new Error(\n            `Invalid object set parameter value for parameter \"${parameterId}\"`,\n          );\n        }\n      } else {\n        cache.delete(parameterId);\n      }\n    }\n  }\n\n  return extendedParameters;\n}\n\nfunction getOrHydrateObjectSet<T extends ObjectTypeDefinition>(\n  osdkClient: Client | undefined,\n  cache: Map<string, { objectSetRid: string; objectSet: ObjectSet<T> }>,\n  paramKey: string,\n  objectSetRid: string,\n  definition: T,\n) {\n  if (osdkClient == null) {\n    throw new Error(\"Not provided an OSDK client\");\n  }\n  const cached = cache.get(paramKey);\n  if (cached?.objectSetRid === objectSetRid) {\n    return cached.objectSet;\n  }\n  const objectSet = hydrateObjectSetFromRid(\n    osdkClient,\n    definition,\n    objectSetRid,\n  );\n  cache.set(paramKey, { objectSetRid, objectSet });\n  return objectSet;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,uBAAuB,QAAQ,uBAAuB;AAI/D;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,8BAA8BA,CAG5CC,UAA8B,EAC9BC,MAAS,EACTC,UAAqC,EACrCC,KAAkE,EAC/B;EACnC,MAAMC,kBAAkB,GAAG;IACzB,GAAGF;EACL,CAAsC;EAEtC,KAAK,MAAMG,WAAW,IAAIC,MAAM,CAACC,IAAI,CAACH,kBAAkB,CAAC,EAAE;IACzD,MAAMI,KAAK,GAAGP,MAAM,CAACC,UAAU,CAACG,WAAW,CAAC;IAC5C,IACEG,KAAK,CAACC,IAAI,KAAK,WAAW,IACvBL,kBAAkB,CAACC,WAAW,CAAC,CAACI,IAAI,KAAK,WAAW,EACvD;MACA,MAAMC,cAAc,GAAGN,kBAAkB,CAACC,WAAW,CAAC,CAACM,KAAK,CAACA,KAAK;MAClE,IAAID,cAAc,IAAI,IAAI,EAAE;QAC1B,IACE,OAAOA,cAAc,KAAK,QAAQ,IAC/B,cAAc,IAAIA,cAAc,IAChC,OAAOA,cAAc,CAACE,YAAY,KAAK,QAAQ,EAClD;UACA,MAAMA,YAAY,GAAGF,cAAc,CAACE,YAAY;UAChD,MAAMC,SAAS,GAAGC,qBAAqB,CACrCd,UAAU,EACVG,KAAK,EACLE,WAAW,EACXO,YAAY,EACZJ,KAAK,CAACO,UACR,CAAC;UACAL,cAAc,CAASG,SAAS,GAAGA,SAAS;QAC/C,CAAC,MAAM;UACL,MAAM,IAAIG,KAAK,CACb,qDAAqDX,WAAW,GAClE,CAAC;QACH;MACF,CAAC,MAAM;QACLF,KAAK,CAACc,MAAM,CAACZ,WAAW,CAAC;MAC3B;IACF;EACF;EAEA,OAAOD,kBAAkB;AAC3B;AAEA,SAASU,qBAAqBA,CAC5Bd,UAA8B,EAC9BG,KAAqE,EACrEe,QAAgB,EAChBN,YAAoB,EACpBO,UAAa,EACb;EACA,IAAInB,UAAU,IAAI,IAAI,EAAE;IACtB,MAAM,IAAIgB,KAAK,CAAC,6BAA6B,CAAC;EAChD;EACA,MAAMI,MAAM,GAAGjB,KAAK,CAACkB,GAAG,CAACH,QAAQ,CAAC;EAClC,IAAIE,MAAM,EAAER,YAAY,KAAKA,YAAY,EAAE;IACzC,OAAOQ,MAAM,CAACP,SAAS;EACzB;EACA,MAAMA,SAAS,GAAGf,uBAAuB,CACvCE,UAAU,EACVmB,UAAU,EACVP,YACF,CAAC;EACDT,KAAK,CAACmB,GAAG,CAACJ,QAAQ,EAAE;IAAEN,YAAY;IAAEC;EAAU,CAAC,CAAC;EAChD,OAAOA,SAAS;AAClB","ignoreList":[]}