@osdk/widget.client-react 3.4.0-beta.1 → 3.4.0-beta.10

package/build/esm/utils/transformEmitEventPayload.test.js

@@ -0,0 +1,210 @@
+/*
+ * 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 { createAndFetchTempObjectSetRid } from "@osdk/client/internal";
+import { defineConfig } from "@osdk/widget.client";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { transformEmitEventPayload } from "./transformEmitEventPayload.js";
+vi.mock("@osdk/client/internal", () => ({
+  createAndFetchTempObjectSetRid: vi.fn()
+}));
+describe("transformEmitEventPayload", () => {
+  const client = vi.fn();
+  const createMockObjectType = (rid = "ri.object-type.123") => ({
+    apiName: "MyObjectType",
+    type: "object",
+    internalDoNotUseMetadata: {
+      rid
+    }
+  });
+  const mockObjectSet = {};
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("should transform ObjectSet parameters and pass through others", async () => {
+    const config = defineConfig({
+      id: "testWidget",
+      name: "Test Widget",
+      type: "workshop",
+      parameters: {
+        myObjectSet: {
+          displayName: "My Object Set",
+          type: "objectSet",
+          objectType: createMockObjectType()
+        },
+        myString: {
+          displayName: "My String",
+          type: "string"
+        }
+      },
+      events: {
+        updateMixed: {
+          displayName: "Update Mixed",
+          parameterUpdateIds: ["myObjectSet", "myString"]
+        }
+      }
+    });
+    vi.mocked(createAndFetchTempObjectSetRid).mockResolvedValue("ri.object-set.456");
+    const result = transformEmitEventPayload(config, "updateMixed", {
+      parameterUpdates: {
+        myObjectSet: mockObjectSet,
+        myString: "world"
+      }
+    }, client);
+    expect(result.type).toBe("async");
+    const resolved = await result.payload;
+    expect(resolved).toEqual({
+      parameterUpdates: {
+        myObjectSet: {
+          objectSetRid: "ri.object-set.456"
+        },
+        myString: "world"
+      }
+    });
+  });
+  it("should transform multiple ObjectSet parameters", async () => {
+    const config = defineConfig({
+      id: "testWidget",
+      name: "Test Widget",
+      type: "workshop",
+      parameters: {
+        objectSetA: {
+          displayName: "Object Set A",
+          type: "objectSet",
+          objectType: createMockObjectType()
+        },
+        objectSetB: {
+          displayName: "Object Set B",
+          type: "objectSet",
+          objectType: createMockObjectType()
+        }
+      },
+      events: {
+        updateBoth: {
+          displayName: "Update Both",
+          parameterUpdateIds: ["objectSetA", "objectSetB"]
+        }
+      }
+    });
+    vi.mocked(createAndFetchTempObjectSetRid).mockResolvedValueOnce("ri.object-set.aaa").mockResolvedValueOnce("ri.object-set.bbb");
+    const result = transformEmitEventPayload(config, "updateBoth", {
+      parameterUpdates: {
+        objectSetA: mockObjectSet,
+        objectSetB: mockObjectSet
+      }
+    }, client);
+    expect(result.type).toBe("async");
+    const resolved = await result.payload;
+    expect(createAndFetchTempObjectSetRid).toHaveBeenCalledTimes(2);
+    expect(resolved).toEqual({
+      parameterUpdates: {
+        objectSetA: {
+          objectSetRid: "ri.object-set.aaa"
+        },
+        objectSetB: {
+          objectSetRid: "ri.object-set.bbb"
+        }
+      }
+    });
+  });
+  it("should throw error when ObjectSet parameter used without client", async () => {
+    const config = defineConfig({
+      id: "testWidget",
+      name: "Test Widget",
+      type: "workshop",
+      parameters: {
+        myObjectSet: {
+          displayName: "My Object Set",
+          type: "objectSet",
+          objectType: createMockObjectType()
+        }
+      },
+      events: {
+        updateObjectSet: {
+          displayName: "Update Object Set",
+          parameterUpdateIds: ["myObjectSet"]
+        }
+      }
+    });
+    const result = transformEmitEventPayload(config, "updateObjectSet", {
+      parameterUpdates: {
+        myObjectSet: mockObjectSet
+      }
+    });
+    expect(result.type).toBe("async");
+    await expect(result.payload).rejects.toThrow("Cannot emit event \"updateObjectSet\" with ObjectSet parameter \"myObjectSet\" without an osdk client");
+  });
+  it("should pass through all parameters when none are ObjectSet type", () => {
+    const config = defineConfig({
+      id: "testWidget",
+      name: "Test Widget",
+      type: "workshop",
+      parameters: {
+        myString: {
+          displayName: "My String",
+          type: "string"
+        },
+        myNumber: {
+          displayName: "My Number",
+          type: "number"
+        }
+      },
+      events: {
+        updatePrimitives: {
+          displayName: "Update Primitives",
+          parameterUpdateIds: ["myString", "myNumber"]
+        }
+      }
+    });
+    const result = transformEmitEventPayload(config, "updatePrimitives", {
+      parameterUpdates: {
+        myString: "hello",
+        myNumber: 42
+      }
+    }, client);
+    expect(result.type).toBe("passThrough");
+    expect(result.payload).toEqual({
+      parameterUpdates: {
+        myString: "hello",
+        myNumber: 42
+      }
+    });
+    expect(createAndFetchTempObjectSetRid).not.toHaveBeenCalled();
+  });
+  it("should throw error when eventId not found in config", async () => {
+    const config = defineConfig({
+      id: "testWidget",
+      name: "Test Widget",
+      type: "workshop",
+      parameters: {
+        myObjectSet: {
+          displayName: "My Object Set",
+          type: "objectSet",
+          objectType: createMockObjectType()
+        }
+      },
+      events: {}
+    });
+    const result = transformEmitEventPayload(config, "nonExistentEvent", {
+      parameterUpdates: {
+        myObjectSet: mockObjectSet
+      }
+    }, client);
+    expect(result.type).toBe("async");
+    await expect(result.payload).rejects.toThrow("Event with ID \"nonExistentEvent\" not found in widget config");
+  });
+});
+//# sourceMappingURL=transformEmitEventPayload.test.js.map

package/build/esm/utils/transformEmitEventPayload.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformEmitEventPayload.test.js","names":["createAndFetchTempObjectSetRid","defineConfig","beforeEach","describe","expect","it","vi","transformEmitEventPayload","mock","fn","client","createMockObjectType","rid","apiName","type","internalDoNotUseMetadata","mockObjectSet","clearAllMocks","config","id","name","parameters","myObjectSet","displayName","objectType","myString","events","updateMixed","parameterUpdateIds","mocked","mockResolvedValue","result","parameterUpdates","toBe","resolved","payload","toEqual","objectSetRid","objectSetA","objectSetB","updateBoth","mockResolvedValueOnce","toHaveBeenCalledTimes","updateObjectSet","rejects","toThrow","myNumber","updatePrimitives","not","toHaveBeenCalled"],"sources":["transformEmitEventPayload.test.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 } from \"@osdk/client\";\nimport { createAndFetchTempObjectSetRid } from \"@osdk/client/internal\";\nimport type { ObjectType } from \"@osdk/widget.api\";\nimport { defineConfig } from \"@osdk/widget.client\";\nimport type { Mock } from \"vitest\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { transformEmitEventPayload } from \"./transformEmitEventPayload.js\";\n\nvi.mock(\"@osdk/client/internal\", () => ({\n  createAndFetchTempObjectSetRid: vi.fn(),\n}));\n\ndescribe(\"transformEmitEventPayload\", () => {\n  const client = vi.fn() as Mock<Client> & Client;\n\n  const createMockObjectType = (rid = \"ri.object-type.123\"): ObjectType => ({\n    apiName: \"MyObjectType\",\n    type: \"object\",\n    internalDoNotUseMetadata: { rid },\n  });\n\n  const mockObjectSet = {} as ObjectSet;\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n  });\n\n  it(\"should transform ObjectSet parameters and pass through others\", async () => {\n    const config = defineConfig({\n      id: \"testWidget\",\n      name: \"Test Widget\",\n      type: \"workshop\",\n      parameters: {\n        myObjectSet: {\n          displayName: \"My Object Set\",\n          type: \"objectSet\",\n          objectType: createMockObjectType(),\n        },\n        myString: {\n          displayName: \"My String\",\n          type: \"string\",\n        },\n      },\n      events: {\n        updateMixed: {\n          displayName: \"Update Mixed\",\n          parameterUpdateIds: [\"myObjectSet\", \"myString\"],\n        },\n      },\n    });\n\n    vi.mocked(createAndFetchTempObjectSetRid).mockResolvedValue(\n      \"ri.object-set.456\",\n    );\n\n    const result = transformEmitEventPayload(\n      config,\n      \"updateMixed\",\n      { parameterUpdates: { myObjectSet: mockObjectSet, myString: \"world\" } },\n      client,\n    );\n\n    expect(result.type).toBe(\"async\");\n    const resolved = await result.payload;\n    expect(resolved).toEqual({\n      parameterUpdates: {\n        myObjectSet: { objectSetRid: \"ri.object-set.456\" },\n        myString: \"world\",\n      },\n    });\n  });\n\n  it(\"should transform multiple ObjectSet parameters\", async () => {\n    const config = defineConfig({\n      id: \"testWidget\",\n      name: \"Test Widget\",\n      type: \"workshop\",\n      parameters: {\n        objectSetA: {\n          displayName: \"Object Set A\",\n          type: \"objectSet\",\n          objectType: createMockObjectType(),\n        },\n        objectSetB: {\n          displayName: \"Object Set B\",\n          type: \"objectSet\",\n          objectType: createMockObjectType(),\n        },\n      },\n      events: {\n        updateBoth: {\n          displayName: \"Update Both\",\n          parameterUpdateIds: [\"objectSetA\", \"objectSetB\"],\n        },\n      },\n    });\n\n    vi.mocked(createAndFetchTempObjectSetRid)\n      .mockResolvedValueOnce(\"ri.object-set.aaa\")\n      .mockResolvedValueOnce(\"ri.object-set.bbb\");\n\n    const result = transformEmitEventPayload(\n      config,\n      \"updateBoth\",\n      {\n        parameterUpdates: {\n          objectSetA: mockObjectSet,\n          objectSetB: mockObjectSet,\n        },\n      },\n      client,\n    );\n\n    expect(result.type).toBe(\"async\");\n    const resolved = await result.payload;\n    expect(createAndFetchTempObjectSetRid).toHaveBeenCalledTimes(2);\n    expect(resolved).toEqual({\n      parameterUpdates: {\n        objectSetA: { objectSetRid: \"ri.object-set.aaa\" },\n        objectSetB: { objectSetRid: \"ri.object-set.bbb\" },\n      },\n    });\n  });\n\n  it(\"should throw error when ObjectSet parameter used without client\", async () => {\n    const config = defineConfig({\n      id: \"testWidget\",\n      name: \"Test Widget\",\n      type: \"workshop\",\n      parameters: {\n        myObjectSet: {\n          displayName: \"My Object Set\",\n          type: \"objectSet\",\n          objectType: createMockObjectType(),\n        },\n      },\n      events: {\n        updateObjectSet: {\n          displayName: \"Update Object Set\",\n          parameterUpdateIds: [\"myObjectSet\"],\n        },\n      },\n    });\n\n    const result = transformEmitEventPayload(config, \"updateObjectSet\", {\n      parameterUpdates: { myObjectSet: mockObjectSet },\n    });\n\n    expect(result.type).toBe(\"async\");\n    await expect(result.payload).rejects.toThrow(\n      \"Cannot emit event \\\"updateObjectSet\\\" with ObjectSet parameter \\\"myObjectSet\\\" without an osdk client\",\n    );\n  });\n\n  it(\"should pass through all parameters when none are ObjectSet type\", () => {\n    const config = defineConfig({\n      id: \"testWidget\",\n      name: \"Test Widget\",\n      type: \"workshop\",\n      parameters: {\n        myString: {\n          displayName: \"My String\",\n          type: \"string\",\n        },\n        myNumber: {\n          displayName: \"My Number\",\n          type: \"number\",\n        },\n      },\n      events: {\n        updatePrimitives: {\n          displayName: \"Update Primitives\",\n          parameterUpdateIds: [\"myString\", \"myNumber\"],\n        },\n      },\n    });\n\n    const result = transformEmitEventPayload(\n      config,\n      \"updatePrimitives\",\n      { parameterUpdates: { myString: \"hello\", myNumber: 42 } },\n      client,\n    );\n\n    expect(result.type).toBe(\"passThrough\");\n    expect(result.payload).toEqual({\n      parameterUpdates: { myString: \"hello\", myNumber: 42 },\n    });\n    expect(createAndFetchTempObjectSetRid).not.toHaveBeenCalled();\n  });\n\n  it(\"should throw error when eventId not found in config\", async () => {\n    const config = defineConfig({\n      id: \"testWidget\",\n      name: \"Test Widget\",\n      type: \"workshop\",\n      parameters: {\n        myObjectSet: {\n          displayName: \"My Object Set\",\n          type: \"objectSet\",\n          objectType: createMockObjectType(),\n        },\n      },\n      events: {},\n    });\n\n    const result = transformEmitEventPayload(\n      config,\n      \"nonExistentEvent\" as never,\n      { parameterUpdates: { myObjectSet: mockObjectSet } } as never,\n      client,\n    );\n\n    expect(result.type).toBe(\"async\");\n    await expect(result.payload).rejects.toThrow(\n      \"Event with ID \\\"nonExistentEvent\\\" not found in widget config\",\n    );\n  });\n});\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,8BAA8B,QAAQ,uBAAuB;AAEtE,SAASC,YAAY,QAAQ,qBAAqB;AAElD,SAASC,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,QAAQ;AAC7D,SAASC,yBAAyB,QAAQ,gCAAgC;AAE1ED,EAAE,CAACE,IAAI,CAAC,uBAAuB,EAAE,OAAO;EACtCR,8BAA8B,EAAEM,EAAE,CAACG,EAAE,CAAC;AACxC,CAAC,CAAC,CAAC;AAEHN,QAAQ,CAAC,2BAA2B,EAAE,MAAM;EAC1C,MAAMO,MAAM,GAAGJ,EAAE,CAACG,EAAE,CAAC,CAA0B;EAE/C,MAAME,oBAAoB,GAAGA,CAACC,GAAG,GAAG,oBAAoB,MAAkB;IACxEC,OAAO,EAAE,cAAc;IACvBC,IAAI,EAAE,QAAQ;IACdC,wBAAwB,EAAE;MAAEH;IAAI;EAClC,CAAC,CAAC;EAEF,MAAMI,aAAa,GAAG,CAAC,CAAc;EAErCd,UAAU,CAAC,MAAM;IACfI,EAAE,CAACW,aAAa,CAAC,CAAC;EACpB,CAAC,CAAC;EAEFZ,EAAE,CAAC,+DAA+D,EAAE,YAAY;IAC9E,MAAMa,MAAM,GAAGjB,YAAY,CAAC;MAC1BkB,EAAE,EAAE,YAAY;MAChBC,IAAI,EAAE,aAAa;MACnBN,IAAI,EAAE,UAAU;MAChBO,UAAU,EAAE;QACVC,WAAW,EAAE;UACXC,WAAW,EAAE,eAAe;UAC5BT,IAAI,EAAE,WAAW;UACjBU,UAAU,EAAEb,oBAAoB,CAAC;QACnC,CAAC;QACDc,QAAQ,EAAE;UACRF,WAAW,EAAE,WAAW;UACxBT,IAAI,EAAE;QACR;MACF,CAAC;MACDY,MAAM,EAAE;QACNC,WAAW,EAAE;UACXJ,WAAW,EAAE,cAAc;UAC3BK,kBAAkB,EAAE,CAAC,aAAa,EAAE,UAAU;QAChD;MACF;IACF,CAAC,CAAC;IAEFtB,EAAE,CAACuB,MAAM,CAAC7B,8BAA8B,CAAC,CAAC8B,iBAAiB,CACzD,mBACF,CAAC;IAED,MAAMC,MAAM,GAAGxB,yBAAyB,CACtCW,MAAM,EACN,aAAa,EACb;MAAEc,gBAAgB,EAAE;QAAEV,WAAW,EAAEN,aAAa;QAAES,QAAQ,EAAE;MAAQ;IAAE,CAAC,EACvEf,MACF,CAAC;IAEDN,MAAM,CAAC2B,MAAM,CAACjB,IAAI,CAAC,CAACmB,IAAI,CAAC,OAAO,CAAC;IACjC,MAAMC,QAAQ,GAAG,MAAMH,MAAM,CAACI,OAAO;IACrC/B,MAAM,CAAC8B,QAAQ,CAAC,CAACE,OAAO,CAAC;MACvBJ,gBAAgB,EAAE;QAChBV,WAAW,EAAE;UAAEe,YAAY,EAAE;QAAoB,CAAC;QAClDZ,QAAQ,EAAE;MACZ;IACF,CAAC,CAAC;EACJ,CAAC,CAAC;EAEFpB,EAAE,CAAC,gDAAgD,EAAE,YAAY;IAC/D,MAAMa,MAAM,GAAGjB,YAAY,CAAC;MAC1BkB,EAAE,EAAE,YAAY;MAChBC,IAAI,EAAE,aAAa;MACnBN,IAAI,EAAE,UAAU;MAChBO,UAAU,EAAE;QACViB,UAAU,EAAE;UACVf,WAAW,EAAE,cAAc;UAC3BT,IAAI,EAAE,WAAW;UACjBU,UAAU,EAAEb,oBAAoB,CAAC;QACnC,CAAC;QACD4B,UAAU,EAAE;UACVhB,WAAW,EAAE,cAAc;UAC3BT,IAAI,EAAE,WAAW;UACjBU,UAAU,EAAEb,oBAAoB,CAAC;QACnC;MACF,CAAC;MACDe,MAAM,EAAE;QACNc,UAAU,EAAE;UACVjB,WAAW,EAAE,aAAa;UAC1BK,kBAAkB,EAAE,CAAC,YAAY,EAAE,YAAY;QACjD;MACF;IACF,CAAC,CAAC;IAEFtB,EAAE,CAACuB,MAAM,CAAC7B,8BAA8B,CAAC,CACtCyC,qBAAqB,CAAC,mBAAmB,CAAC,CAC1CA,qBAAqB,CAAC,mBAAmB,CAAC;IAE7C,MAAMV,MAAM,GAAGxB,yBAAyB,CACtCW,MAAM,EACN,YAAY,EACZ;MACEc,gBAAgB,EAAE;QAChBM,UAAU,EAAEtB,aAAa;QACzBuB,UAAU,EAAEvB;MACd;IACF,CAAC,EACDN,MACF,CAAC;IAEDN,MAAM,CAAC2B,MAAM,CAACjB,IAAI,CAAC,CAACmB,IAAI,CAAC,OAAO,CAAC;IACjC,MAAMC,QAAQ,GAAG,MAAMH,MAAM,CAACI,OAAO;IACrC/B,MAAM,CAACJ,8BAA8B,CAAC,CAAC0C,qBAAqB,CAAC,CAAC,CAAC;IAC/DtC,MAAM,CAAC8B,QAAQ,CAAC,CAACE,OAAO,CAAC;MACvBJ,gBAAgB,EAAE;QAChBM,UAAU,EAAE;UAAED,YAAY,EAAE;QAAoB,CAAC;QACjDE,UAAU,EAAE;UAAEF,YAAY,EAAE;QAAoB;MAClD;IACF,CAAC,CAAC;EACJ,CAAC,CAAC;EAEFhC,EAAE,CAAC,iEAAiE,EAAE,YAAY;IAChF,MAAMa,MAAM,GAAGjB,YAAY,CAAC;MAC1BkB,EAAE,EAAE,YAAY;MAChBC,IAAI,EAAE,aAAa;MACnBN,IAAI,EAAE,UAAU;MAChBO,UAAU,EAAE;QACVC,WAAW,EAAE;UACXC,WAAW,EAAE,eAAe;UAC5BT,IAAI,EAAE,WAAW;UACjBU,UAAU,EAAEb,oBAAoB,CAAC;QACnC;MACF,CAAC;MACDe,MAAM,EAAE;QACNiB,eAAe,EAAE;UACfpB,WAAW,EAAE,mBAAmB;UAChCK,kBAAkB,EAAE,CAAC,aAAa;QACpC;MACF;IACF,CAAC,CAAC;IAEF,MAAMG,MAAM,GAAGxB,yBAAyB,CAACW,MAAM,EAAE,iBAAiB,EAAE;MAClEc,gBAAgB,EAAE;QAAEV,WAAW,EAAEN;MAAc;IACjD,CAAC,CAAC;IAEFZ,MAAM,CAAC2B,MAAM,CAACjB,IAAI,CAAC,CAACmB,IAAI,CAAC,OAAO,CAAC;IACjC,MAAM7B,MAAM,CAAC2B,MAAM,CAACI,OAAO,CAAC,CAACS,OAAO,CAACC,OAAO,CAC1C,uGACF,CAAC;EACH,CAAC,CAAC;EAEFxC,EAAE,CAAC,iEAAiE,EAAE,MAAM;IAC1E,MAAMa,MAAM,GAAGjB,YAAY,CAAC;MAC1BkB,EAAE,EAAE,YAAY;MAChBC,IAAI,EAAE,aAAa;MACnBN,IAAI,EAAE,UAAU;MAChBO,UAAU,EAAE;QACVI,QAAQ,EAAE;UACRF,WAAW,EAAE,WAAW;UACxBT,IAAI,EAAE;QACR,CAAC;QACDgC,QAAQ,EAAE;UACRvB,WAAW,EAAE,WAAW;UACxBT,IAAI,EAAE;QACR;MACF,CAAC;MACDY,MAAM,EAAE;QACNqB,gBAAgB,EAAE;UAChBxB,WAAW,EAAE,mBAAmB;UAChCK,kBAAkB,EAAE,CAAC,UAAU,EAAE,UAAU;QAC7C;MACF;IACF,CAAC,CAAC;IAEF,MAAMG,MAAM,GAAGxB,yBAAyB,CACtCW,MAAM,EACN,kBAAkB,EAClB;MAAEc,gBAAgB,EAAE;QAAEP,QAAQ,EAAE,OAAO;QAAEqB,QAAQ,EAAE;MAAG;IAAE,CAAC,EACzDpC,MACF,CAAC;IAEDN,MAAM,CAAC2B,MAAM,CAACjB,IAAI,CAAC,CAACmB,IAAI,CAAC,aAAa,CAAC;IACvC7B,MAAM,CAAC2B,MAAM,CAACI,OAAO,CAAC,CAACC,OAAO,CAAC;MAC7BJ,gBAAgB,EAAE;QAAEP,QAAQ,EAAE,OAAO;QAAEqB,QAAQ,EAAE;MAAG;IACtD,CAAC,CAAC;IACF1C,MAAM,CAACJ,8BAA8B,CAAC,CAACgD,GAAG,CAACC,gBAAgB,CAAC,CAAC;EAC/D,CAAC,CAAC;EAEF5C,EAAE,CAAC,qDAAqD,EAAE,YAAY;IACpE,MAAMa,MAAM,GAAGjB,YAAY,CAAC;MAC1BkB,EAAE,EAAE,YAAY;MAChBC,IAAI,EAAE,aAAa;MACnBN,IAAI,EAAE,UAAU;MAChBO,UAAU,EAAE;QACVC,WAAW,EAAE;UACXC,WAAW,EAAE,eAAe;UAC5BT,IAAI,EAAE,WAAW;UACjBU,UAAU,EAAEb,oBAAoB,CAAC;QACnC;MACF,CAAC;MACDe,MAAM,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,MAAMK,MAAM,GAAGxB,yBAAyB,CACtCW,MAAM,EACN,kBAAkB,EAClB;MAAEc,gBAAgB,EAAE;QAAEV,WAAW,EAAEN;MAAc;IAAE,CAAC,EACpDN,MACF,CAAC;IAEDN,MAAM,CAAC2B,MAAM,CAACjB,IAAI,CAAC,CAACmB,IAAI,CAAC,OAAO,CAAC;IACjC,MAAM7B,MAAM,CAAC2B,MAAM,CAACI,OAAO,CAAC,CAACS,OAAO,CAACC,OAAO,CAC1C,+DACF,CAAC;EACH,CAAC,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/build/types/client.d.ts

@@ -1,6 +1,6 @@
 import type { Client } from "@osdk/client";
 import type { ObjectType } from "@osdk/widget.api";
-import type { WidgetConfig } from "@osdk/widget.client";
+import { type WidgetConfig } from "@osdk/widget.client";
 import React from "react";
 import type { ExtendedAsyncParameterValueMap } from "./context.js";
 type ExtractObjectTypes<C extends WidgetConfig<C["parameters"]>> = C["parameters"][keyof C["parameters"]] extends infer Param ? Param extends {

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,cAAyB,cAAe;AACtD,cAAc,kBAAkB,kBAAmB;AACnD,cAGE,oBACK,qBAAsB;AAE7B,OAAO,WAA2C,OAAQ;AAC1D,cACE,sCAGK,cAAe;KAMjB,mBAAmB,UAAU,aAAa,EAAE,kBAC/C,EAAE,oBAAoB,EAAE,6BAA6B,QACjD,cAAc;CAAE,MAAM;CAAa,kBAAkB;AAAI,IACvD,WAAW,aAAa;KAK3B,uBAAuB,UAAU,aAAa,EAAE,kBACnD,mBAAmB,mBAAmB,QAAQ;KAE3C,eAAe,UAAU,aAAa,EAAE,kBAAkB;;;;CAI7D,QAAQ;AACT;KAEI,mBAAmB,UAAU,aAAa,EAAE,kBAC7C;CACA,UAAU,MAAM;;;;CAKhB,QAAQ;;;;;;CAOR,gBAAgB,+BAA+B;AAChD,IACC,QAAQ,eAAe,OACtB,uBAAuB,WAAW,OAAO,eAAe,KAAK,CAAE;;;;AAKpE,OAAO,cAAM,gBAAiB,UAAU,aAAa,EAAE,gBAAgB,EACrE,UACA,QACA,eACA,QAAQ,YACc,EAArB,mBAAmB,OAAK,MAAM,aAAa,mBAAmB","names":[],"sources":["../../src/client.tsx"],"version":3,"file":"client.d.ts"}
+{"mappings":"AAgBA,cAAc,cAAyB,cAAe;AACtD,cAAc,kBAAkB,kBAAmB;AACnD,cAKO,oBACA,qBAAsB;AAC7B,OAAO,WAAwD,OAAQ;AACvE,cAEE,sCAGK,cAAe;KAOjB,mBAAmB,UAAU,aAAa,EAAE,kBAC/C,EAAE,oBAAoB,EAAE,6BAA6B,QACjD,cAAc;CAAE,MAAM;CAAa,kBAAkB;AAAI,IACvD,WAAW,aAAa;KAK3B,uBAAuB,UAAU,aAAa,EAAE,kBACnD,mBAAmB,mBAAmB,QAAQ;KAE3C,eAAe,UAAU,aAAa,EAAE,kBAAkB;;;;CAI7D,QAAQ;AACT;KAEI,mBAAmB,UAAU,aAAa,EAAE,kBAC7C;CACA,UAAU,MAAM;;;;CAKhB,QAAQ;;;;;;CAOR,gBAAgB,+BAA+B;AAChD,IACC,QAAQ,eAAe,OACtB,uBAAuB,WAAW,OAAO,eAAe,KAAK,CAAE;;;;AAKpE,OAAO,cAAM,gBAAiB,UAAU,aAAa,EAAE,gBAAgB,EACrE,UACA,QACA,eACA,QAAQ,YACc,EAArB,mBAAmB,OAAK,MAAM,aAAa,mBAAmB","names":[],"sources":["../../src/client.tsx"],"version":3,"file":"client.d.ts"}

package/build/types/client.test.d.ts

@@ -0,0 +1,3 @@
+declare global {
+	var IS_REACT_ACT_ENVIRONMENT: boolean;
+}

package/build/types/client.test.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"eAgBe;CACb,IAAIA;AACL","names":["IS_REACT_ACT_ENVIRONMENT: boolean"],"sources":["../../src/client.test.tsx"],"version":3,"file":"client.test.d.ts"}

package/build/types/context.d.ts

@@ -1,9 +1,43 @@
 import type { ObjectSet } from "@osdk/client";
-import type { ObjectType } from "@osdk/widget.api";
-import { type AsyncParameterValueMap, type AsyncValue, FoundryHostEventTarget, type FoundryWidgetClient, type ParameterConfig, type ParameterValueMap, type WidgetConfig } from "@osdk/widget.client";
+import type { EventId, EventParameterValueMap, ObjectType, WidgetMessage } from "@osdk/widget.api";
+import { type AsyncParameterValueMap, type AsyncValue, FoundryHostEventTarget, type ParameterConfig, type ParameterValueMap, type WidgetConfig } from "@osdk/widget.client";
 import React from "react";
+export type AugmentedEventParameterValueMap<
+	C extends WidgetConfig<C["parameters"]>,
+	K extends EventId<C>
+> = { [P in keyof EventParameterValueMap<C, K>] : P extends keyof C["parameters"] ? C["parameters"][P] extends {
+	type: "objectSet"
+	objectType: infer T
+} ? T extends ObjectType ? ObjectSet<T> : EventParameterValueMap<C, K>[P] : EventParameterValueMap<C, K>[P] : EventParameterValueMap<C, K>[P] };
+type AugmentedEmitEventIdMap<C extends WidgetConfig<C["parameters"]>> = { [K in EventId<C>] : {
+	eventId: K
+	parameterUpdates: AugmentedEventParameterValueMap<C, K>
+} };
+interface AugmentedWidgetEmitEvent<C extends WidgetConfig<C["parameters"]>> extends Omit<WidgetMessage.EmitEvent<C>, "payload"> {
+	payload: AugmentedEmitEventIdMap<C>[EventId<C>];
+}
+/**
+* Emits a widget event with parameter updates to the host Foundry UI.
+*
+* For object set parameters, pass `ObjectSet<T>` directly.
+* If the same event is emitted multiple times in quick succession and involves Object Set parameters, only the last call will be sent.
+* Errors (e.g., network failures when serializing ObjectSet parameters) are not surfaced to the caller.
+*/
+export type AugmentedEmitEvent<C extends WidgetConfig<C["parameters"]>> = <
+	M extends AugmentedWidgetEmitEvent<C>,
+	ID extends M["payload"]["eventId"]
+>(eventId: ID, payload: Omit<Extract<M["payload"], {
+	eventId: ID
+}>, "eventId">) => void;
 export interface FoundryWidgetClientContext<C extends WidgetConfig<C["parameters"]>> {
-	emitEvent: FoundryWidgetClient<C>["emitEvent"];
+	/**
+	* Emits a widget event with parameter updates to the host Foundry UI.
+	*
+	* - For ObjectSet parameters, pass `ObjectSet<T>` directly
+	* - If the same event is emitted multiple times rapidly and involves Object Set parameters, only the last call is sent
+	* - Errors are not surfaced to the caller
+	*/
+	emitEvent: AugmentedEmitEvent<C>;
 	hostEventTarget: FoundryHostEventTarget<C>;
 	/**
 	* Object where the individual parameters have their async state represented
@@ -39,3 +73,4 @@ export declare function useFoundryWidgetContext<C extends WidgetConfig<C["parame
 export declare namespace useFoundryWidgetContext {
 	function withTypes<C extends WidgetConfig<C["parameters"]>>(): () => FoundryWidgetClientContext<C>;
 }
+export {};

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

@@ -1 +1 @@
-{"mappings":"AAgBA,cAAc,iBAAiB,cAAe;AAC9C,cAAc,kBAAkB,kBAAmB;AACnD,cACO,6BACA,YACL,6BACK,0BACA,sBACA,wBACA,oBACA,qBAAsB;AAC7B,OAAO,WAA2B,OAAQ;AAE1C,iBAAiB,2BACf,UAAU,aAAa,EAAE,gBACzB;CACA,WAAW,oBAAoB,GAAG;CAClC,iBAAiB,uBAAuB;;;;CAKxC,sBAAsB,+BAA+B;;;;CAKrD,YAAY;EACV,QAAQ,QAAQ,0BAA0B;EAC1C,OAAO,WAAW,kBAAkB,IAAI;CACzC;AACF;AAED,YAAY,0BAA0B,UAAU,aAAa,EAAE,qBAE1D,WAAW,EAAE,iBAAgB,gBAAgB,kBAAkB,KAC5D,EAAE,cAAc,WAAW;CAAE,MAAM;CAAa,kBAAkB;AAAG,IACnE,UAAU,aACR,kBAAkB,GAAG,KAAK;CAAE,WAAW,UAAU;AAAI,IACvD,kBAAkB,GAAG,KACvB,kBAAkB,GAAG;AAI7B,YAAY,+BACV,UAAU,aAAa,EAAE,qBAExB,WAAW,EAAE,iBAAgB,gBAAgB,uBAAuB,KACjE,EAAE,cAAc,WAAW;CAAE,MAAM;CAAa,kBAAkB;AAAG,IACnE,UAAU,aAAa,uBAAuB,GAAG,KAAK;CACpD,OAAO,WACL,kBAAkB,GAAG,KAAK;EAAE,WAAW,UAAU;CAAI;AAExD,IACD,uBAAuB,GAAG,KAC5B,uBAAuB,GAAG;AAIhC,OAAO,cAAMA,sBAAsB,MAAM,QACvC,2BAA2B,aAAa;;;;AAgB1C,OAAO,iBAAS,wBACd,UAAU,aAAa,EAAE,mBAEkB,2BAA2B;AAGxE,yBAAiB;CACR,SAAS,UACd,UAAU,aAAa,EAAE,yBAChB,2BAA2B","names":["FoundryWidgetContext: React.Context<\n  FoundryWidgetClientContext<WidgetConfig<ParameterConfig>>\n>"],"sources":["../../src/context.ts"],"version":3,"file":"context.d.ts"}
+{"mappings":"AAgBA,cAAc,iBAAiB,cAAe;AAC9C,cACE,SACA,wBACA,YACA,qBACK,kBAAmB;AAC1B,cACO,6BACA,YACL,6BACK,sBACA,wBACA,oBACA,qBAAsB;AAC7B,OAAO,WAA2B,OAAQ;AAE1C,YAAY;CACV,UAAU,aAAa,EAAE;CACzB,UAAU,QAAQ;OAEjB,WAAW,uBAAuB,GAAG,MAAK,gBAAgB,EAAE,gBACzD,EAAE,cAAc,WAAW;CAAE,MAAM;CAAa,kBAAkB;AAAG,IACnE,UAAU,aAAa,UAAU,KACjC,uBAAuB,GAAG,GAAG,KAC/B,uBAAuB,GAAG,GAAG,KAC7B,uBAAuB,GAAG,GAAG;KAG9B,wBAAwB,UAAU,aAAa,EAAE,qBACnD,KAAK,QAAQ,MAAK;CACjB,SAAS;CACT,kBAAkB,gCAAgC,GAAG;AACtD;UAGO,yBAAyB,UAAU,aAAa,EAAE,wBAClD,KAAK,cAAc,UAAU,IAAI,WAC3C;CACE,SAAS,wBAAwB,GAAG,QAAQ;AAC7C;;;;;;;;AASD,YAAY,mBAAmB,UAAU,aAAa,EAAE;CACtD,UAAU,yBAAyB;CACnC,WAAW,EAAE,WAAW;EAExBA,SAAS,IACTC,SAAS,KAAK,QAAQ,EAAE,YAAY;CAAE,SAAS;AAAI,IAAG;AAGxD,iBAAiB,2BACf,UAAU,aAAa,EAAE,gBACzB;;;;;;;;CAQA,WAAW,mBAAmB;CAC9B,iBAAiB,uBAAuB;;;;CAKxC,sBAAsB,+BAA+B;;;;CAKrD,YAAY;EACV,QAAQ,QAAQ,0BAA0B;EAC1C,OAAO,WAAW,kBAAkB,IAAI;CACzC;AACF;AAED,YAAY,0BAA0B,UAAU,aAAa,EAAE,qBAE1D,WAAW,EAAE,iBAAgB,gBAAgB,kBAAkB,KAC5D,EAAE,cAAc,WAAW;CAAE,MAAM;CAAa,kBAAkB;AAAG,IACnE,UAAU,aACR,kBAAkB,GAAG,KAAK;CAAE,WAAW,UAAU;AAAI,IACvD,kBAAkB,GAAG,KACvB,kBAAkB,GAAG;AAI7B,YAAY,+BACV,UAAU,aAAa,EAAE,qBAExB,WAAW,EAAE,iBAAgB,gBAAgB,uBAAuB,KACjE,EAAE,cAAc,WAAW;CAAE,MAAM;CAAa,kBAAkB;AAAG,IACnE,UAAU,aAAa,uBAAuB,GAAG,KAAK;CACpD,OAAO,WACL,kBAAkB,GAAG,KAAK;EAAE,WAAW,UAAU;CAAI;AAExD,IACD,uBAAuB,GAAG,KAC5B,uBAAuB,GAAG;AAIhC,OAAO,cAAMC,sBAAsB,MAAM,QACvC,2BAA2B,aAAa;;;;AAgB1C,OAAO,iBAAS,wBACd,UAAU,aAAa,EAAE,mBACtB,2BAA2B;AAIhC,yBAAiB;CACR,SAAS,UACd,UAAU,aAAa,EAAE,yBAChB,2BAA2B","names":["eventId: ID","payload: Omit<Extract<M[\"payload\"], { eventId: ID }>, \"eventId\">","FoundryWidgetContext: React.Context<\n  FoundryWidgetClientContext<WidgetConfig<ParameterConfig>>\n>"],"sources":["../../src/context.ts"],"version":3,"file":"context.d.ts"}

package/build/types/utils/transformEmitEventPayload.d.ts

@@ -0,0 +1,41 @@
+import type { Client } from "@osdk/client";
+import type { EventId, EventParameterValueMap } from "@osdk/widget.api";
+import type { WidgetConfig } from "@osdk/widget.client";
+import type { AugmentedEventParameterValueMap } from "../context.js";
+type TransformedEmitEventPayload<
+	C extends WidgetConfig<C["parameters"]>,
+	K extends EventId<C>
+> = {
+	parameterUpdates: EventParameterValueMap<C, K>
+};
+type TransformedEmitEventPayloadResult<
+	C extends WidgetConfig<C["parameters"]>,
+	K extends EventId<C>
+> = {
+	type: "async"
+	payload: Promise<TransformedEmitEventPayload<C, K>>
+} | {
+	type: "passThrough"
+	payload: TransformedEmitEventPayload<C, K>
+};
+export declare function transformEmitEventPayload<
+	C extends WidgetConfig<C["parameters"]>,
+	K extends EventId<C>
+>(config: C, eventId: K, payload: {
+	parameterUpdates: AugmentedEventParameterValueMap<C, K>
+}, osdkClient?: Client): TransformedEmitEventPayloadResult<C, K>;
+/**
+* Transforms an augmented emit event payload by creating temporary object sets
+* from ObjectSet instances.
+*
+* Multiple ObjectSet parameters are transformed in parallel for better performance.
+*/
+export declare function transformEmitEventPayloadAsync<
+	C extends WidgetConfig<C["parameters"]>,
+	K extends EventId<C>
+>(config: C, eventId: K, payload: {
+	parameterUpdates: AugmentedEventParameterValueMap<C, K>
+}, osdkClient?: Client): Promise<{
+	parameterUpdates: EventParameterValueMap<C, K>
+}>;
+export {};

package/build/types/utils/transformEmitEventPayload.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"AAgBA,cAAc,cAAyB,cAAe;AAEtD,cAEE,SACA,8BAEK,kBAAmB;AAC1B,cAAc,oBAAoB,qBAAsB;AACxD,cAAc,uCAAuC,eAAgB;KAKhE;CACH,UAAU,aAAa,EAAE;CACzB,UAAU,QAAQ;IAChB;CACF,kBAAkB,uBAAuB,GAAG;AAC7C;KAEI;CACH,UAAU,aAAa,EAAE;CACzB,UAAU,QAAQ;IAChB;CACF,MAAM;CACN,SAAS,QAAQ,4BAA4B,GAAG;AACjD,IAAG;CACF,MAAM;CACN,SAAS,4BAA4B,GAAG;AACzC;AAED,OAAO,iBAAS;CACd,UAAU,aAAa,EAAE;CACzB,UAAU,QAAQ;EAElBA,QAAQ,GACRC,SAAS,GACTC,SAAS;CAAE,kBAAkB,gCAAgC,GAAG;AAAI,GACpEC,aAAa,SACZ,kCAAkC,GAAG;;;;;;;AAkCxC,OAAO,iBAAe;CACpB,UAAU,aAAa,EAAE;CACzB,UAAU,QAAQ;EAElBH,QAAQ,GACRC,SAAS,GACTC,SAAS;CAAE,kBAAkB,gCAAgC,GAAG;AAAI,GACpEC,aAAa,SACZ,QAAQ;CAAE,kBAAkB,uBAAuB,GAAG;AAAI","names":["config: C","eventId: K","payload: { parameterUpdates: AugmentedEventParameterValueMap<C, K> }","osdkClient?: Client"],"sources":["../../../src/utils/transformEmitEventPayload.ts"],"version":3,"file":"transformEmitEventPayload.d.ts"}

package/build/types/utils/transformEmitEventPayload.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/types/utils/transformEmitEventPayload.test.d.ts.map

@@ -0,0 +1 @@
+{"mappings":"","names":[],"sources":["../../../src/utils/transformEmitEventPayload.test.ts"],"version":3,"file":"transformEmitEventPayload.test.d.ts"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdk/widget.client-react",
-  "version": "3.4.0-beta.1",
+  "version": "3.4.0-beta.10",
   "description": "Wrapper around @osdk/widget.client",
   "access": "public",
   "license": "Apache-2.0",
@@ -34,7 +34,7 @@
     "@types/react-dom": "^18 || ^19",
     "react": "^18 || ^19",
     "react-dom": "^18 || ^19",
-    "@osdk/widget.client": "~3.4.0-beta.1"
+    "@osdk/widget.client": "~3.4.0-beta.10"
   },
   "devDependencies": {
     "@types/react": "^18.3.24",
@@ -43,11 +43,11 @@
     "react-dom": "18.3.1",
     "ts-expect": "^1.3.0",
     "typescript": "~5.5.4",
+    "@osdk/client": "~2.7.0-beta.10",
     "@osdk/monorepo.api-extractor": "~0.6.0-beta.1",
-    "@osdk/client": "~2.7.0-beta.1",
     "@osdk/monorepo.tsconfig": "~0.6.0-beta.1",
-    "@osdk/widget.api": "~3.4.0-beta.1",
-    "@osdk/widget.client": "~3.4.0-beta.1"
+    "@osdk/widget.api": "~3.4.0-beta.10",
+    "@osdk/widget.client": "~3.4.0-beta.10"
   },
   "publishConfig": {
     "access": "public"
@@ -73,6 +73,7 @@
     "clean": "rm -rf lib dist types build tsconfig.tsbuildinfo",
     "fix-lint": "eslint . --fix && dprint fmt --config $(find-up dprint.json)",
     "lint": "eslint . && dprint check  --config $(find-up dprint.json)",
+    "test": "vitest run",
     "transpileBrowser": "monorepo.tool.transpile -f esm -m normal -t browser",
     "transpileCjs": "monorepo.tool.transpile -f cjs -m bundle -t node",
     "transpileEsm": "monorepo.tool.transpile -f esm -m normal -t node",