@itwin/core-frontend 4.8.0-dev.32 → 4.8.0-dev.34

package/lib/esm/workers/RegisterWorker.d.ts

@@ -3,7 +3,8 @@
  */
 import type { WorkerImplementation } from "../common/WorkerProxy";
 /** Configure an implementation of the operations defined by `T` to execute on a worker thread.
- * @internal
+ * See [this article]($docs/learning/frontend/WorkerProxy.md) for more details and examples.
+ * @beta
  */
 export declare function registerWorker<T>(impl: WorkerImplementation<T>): void;
 //# sourceMappingURL=RegisterWorker.d.ts.map

package/lib/esm/workers/RegisterWorker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RegisterWorker.d.ts","sourceRoot":"","sources":["../../../src/workers/RegisterWorker.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAWlE;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAkBrE"}
+{"version":3,"file":"RegisterWorker.d.ts","sourceRoot":"","sources":["../../../src/workers/RegisterWorker.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAWlE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,CAkBrE"}

package/lib/esm/workers/RegisterWorker.js

@@ -7,7 +7,8 @@
  */
 import { assert } from "@itwin/core-bentley";
 /** Configure an implementation of the operations defined by `T` to execute on a worker thread.
- * @internal
+ * See [this article]($docs/learning/frontend/WorkerProxy.md) for more details and examples.
+ * @beta
  */
 export function registerWorker(impl) {
     onmessage = (e) => {

package/lib/esm/workers/RegisterWorker.js.map

@@ -1 +1 @@
-{"version":3,"file":"RegisterWorker.js","sourceRoot":"","sources":["../../../src/workers/RegisterWorker.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAY7C;;GAEG;AACH,MAAM,UAAU,cAAc,CAAI,IAA6B;IAC7D,SAAS,GAAG,CAAC,CAAe,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,CAAC,CAAC,IAAqB,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,WAAW,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,IAAI,OAAO,IAAI,GAAG,CAAC,CAAC;YAC5F,MAAM,IAAI,GAAI,IAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,UAAU,IAAI,GAAG;gBAC9C,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;;gBAEvE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC7E,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utils\r\n */\r\n\r\nimport { assert } from \"@itwin/core-bentley\";\r\nimport type { WorkerImplementation } from \"../common/WorkerProxy\";\r\n\r\ninterface WorkerRequest {\r\n  /** The name of the method in the worker's interface to invoke. */\r\n  operation: string;\r\n  /** Correlates the response to the caller on the main thread to resolve/reject the promise. */\r\n  msgId: number;\r\n  /** Arguments to `operation`. */\r\n  payload?: any;\r\n}\r\n\r\n/** Configure an implementation of the operations defined by `T` to execute on a worker thread.\r\n * @internal\r\n */\r\nexport function registerWorker<T>(impl: WorkerImplementation<T>): void {\r\n  onmessage = (e: MessageEvent) => {\r\n    const req = e.data as WorkerRequest;\r\n    const msgId = req.msgId;\r\n    try {\r\n      assert(typeof req === \"object\" && \"operation\" in req && \"payload\" in req && \"msgId\" in req);\r\n      const func = (impl as any)[req.operation];\r\n      assert(typeof func === \"function\");\r\n      const ret = func(req.payload);\r\n      if (typeof ret === \"object\" && \"transfer\" in ret)\r\n        postMessage({ result: ret.result, msgId }, { transfer: ret.transfer });\r\n      else\r\n        postMessage({ result: ret, msgId });\r\n    } catch (err: unknown) {\r\n      const error = err instanceof Error ? err : new Error(\"Unknown worker error\");\r\n      postMessage({ error, msgId });\r\n    }\r\n  };\r\n}\r\n"]}
+{"version":3,"file":"RegisterWorker.js","sourceRoot":"","sources":["../../../src/workers/RegisterWorker.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAY7C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAI,IAA6B;IAC7D,SAAS,GAAG,CAAC,CAAe,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,CAAC,CAAC,IAAqB,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,WAAW,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,IAAI,OAAO,IAAI,GAAG,CAAC,CAAC;YAC5F,MAAM,IAAI,GAAI,IAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,UAAU,IAAI,GAAG;gBAC9C,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;;gBAEvE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC7E,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Utils\r\n */\r\n\r\nimport { assert } from \"@itwin/core-bentley\";\r\nimport type { WorkerImplementation } from \"../common/WorkerProxy\";\r\n\r\ninterface WorkerRequest {\r\n  /** The name of the method in the worker's interface to invoke. */\r\n  operation: string;\r\n  /** Correlates the response to the caller on the main thread to resolve/reject the promise. */\r\n  msgId: number;\r\n  /** Arguments to `operation`. */\r\n  payload?: any;\r\n}\r\n\r\n/** Configure an implementation of the operations defined by `T` to execute on a worker thread.\r\n * See [this article]($docs/learning/frontend/WorkerProxy.md) for more details and examples.\r\n * @beta\r\n */\r\nexport function registerWorker<T>(impl: WorkerImplementation<T>): void {\r\n  onmessage = (e: MessageEvent) => {\r\n    const req = e.data as WorkerRequest;\r\n    const msgId = req.msgId;\r\n    try {\r\n      assert(typeof req === \"object\" && \"operation\" in req && \"payload\" in req && \"msgId\" in req);\r\n      const func = (impl as any)[req.operation];\r\n      assert(typeof func === \"function\");\r\n      const ret = func(req.payload);\r\n      if (typeof ret === \"object\" && \"transfer\" in ret)\r\n        postMessage({ result: ret.result, msgId }, { transfer: ret.transfer });\r\n      else\r\n        postMessage({ result: ret, msgId });\r\n    } catch (err: unknown) {\r\n      const error = err instanceof Error ? err : new Error(\"Unknown worker error\");\r\n      postMessage({ error, msgId });\r\n    }\r\n  };\r\n}\r\n"]}