@itwin/core-common 5.12.0-dev.8 → 5.13.0-dev.1

package/lib/cjs/ipc/IpcErrors.js

@@ -0,0 +1,167 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module IpcSocket
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeIpcError = serializeIpcError;
+exports.rebuildIpcError = rebuildIpcError;
+const core_bentley_1 = require("@itwin/core-bentley");
+/**
+ * Serialize a value thrown by an Ipc handler into the [[IpcInvokeReturn]] `error` envelope so it can be
+ * transmitted across an Ipc socket via structured clone or JSON, depending on the transport.
+ *
+ * Hardens against values that can't be cloned: copies `Error`'s non-enumerable `message`/`stack`/`cause`,
+ * preserves `BentleyError` identity (`iTwinErrorId` and logging metadata, normalized to a JSON-safe form),
+ * recurses into nested `Error`s and plain objects, strips functions and class instances, and guards against cycles.
+ * @param err The thrown value to serialize.
+ * @param includeStack Whether to include `Error.stack` in the serialized output.
+ * @returns An [[IpcInvokeReturn]] holding the serialized `error`.
+ * @internal
+ */
+function serializeIpcError(err, includeStack) {
+    if (!core_bentley_1.JsonUtils.isObject(err))
+        return { error: err };
+    const serialize = (e, visited = new WeakSet()) => {
+        if (visited.has(e))
+            return undefined;
+        visited.add(e);
+        try {
+            const serialized = { ...e };
+            for (const sym of Object.getOwnPropertySymbols(serialized))
+                delete serialized[sym]; // symbol-keyed properties cannot be structured-cloned
+            // `iTwinErrorId`/`loggingMetadata` are prototype getters, so `Object.keys`/spread never pick them up; resolve
+            // them explicitly. Shared by the top-level and metadata-nested paths below so they can't drift apart again.
+            const applyBentleyErrorIdentity = (be, out, sanitize) => {
+                out.iTwinErrorId = be.iTwinErrorId;
+                if (be.hasMetaData)
+                    out.loggingMetadata = sanitize(be.loggingMetadata);
+                delete out._metaData;
+            };
+            if (e instanceof Error) {
+                serialized.message = e.message; // NB: .message and .stack are non-enumerable on Error instances
+                if (includeStack)
+                    serialized.stack = e.stack;
+                // Error.cause is typically non-enumerable and must be copied explicitly.
+                if (Object.prototype.hasOwnProperty.call(e, "cause"))
+                    serialized.cause = e.cause;
+            }
+            if (e instanceof core_bentley_1.BentleyError)
+                applyBentleyErrorIdentity(e, serialized, (v) => v); // loggingMetadata is sanitized once, below
+            // Only recurse into Error instances and plain objects — not class instances like Date or Buffer.
+            const shouldRecurse = (val) => val instanceof Error || (core_bentley_1.JsonUtils.isObject(val) && Object.getPrototypeOf(val) === Object.prototype);
+            const isSerializableLeaf = (val) => {
+                const t = typeof val;
+                return val === null || val === undefined || val instanceof Date
+                    || t === "string" || t === "number" || t === "boolean";
+            };
+            // Recurse into arrays, Errors, and plain objects; strip anything else non-cloneable (functions, RegExp,
+            // Map, Set, typed arrays, other class instances) to `undefined`.
+            const serializeValue = (val) => {
+                if (Array.isArray(val)) {
+                    // Arrays need their own cycle guard: they never pass through `serialize` below, so a self-referencing
+                    // array would otherwise recurse via `map` forever.
+                    if (visited.has(val))
+                        return undefined;
+                    visited.add(val);
+                    try {
+                        return val.map((item) => serializeValue(item));
+                    }
+                    finally {
+                        visited.delete(val);
+                    }
+                }
+                if (shouldRecurse(val))
+                    return serialize(val, visited);
+                return isSerializableLeaf(val) ? val : undefined;
+            };
+            // `loggingMetadata` can be any shape (e.g. a `Map`/`Set` from a `GetMetaDataFunction`). Normalize it to a
+            // JSON-safe form so it survives every transport — raw `Map`/`Set` clone fine over Electron's structured
+            // clone but collapse to `{}` over the WebSocket transport, which uses `JSON.stringify`.
+            const sanitizeMetadataValue = (val) => {
+                if (val === null || val === undefined || val instanceof Date || typeof val === "string" || typeof val === "number" || typeof val === "boolean")
+                    return val;
+                if (typeof val !== "object" || visited.has(val))
+                    return undefined; // functions, symbols, or an already-visited (cyclic) value
+                visited.add(val);
+                try {
+                    if (val instanceof Map) {
+                        // String(k) can collide (e.g. two object keys); suffix with "#n" so entries aren't silently dropped.
+                        const out = {};
+                        const keyCounts = new Map();
+                        for (const [k, v] of val) {
+                            const baseKey = String(k);
+                            const count = keyCounts.get(baseKey) ?? 0;
+                            keyCounts.set(baseKey, count + 1);
+                            out[count === 0 ? baseKey : `${baseKey}#${count}`] = sanitizeMetadataValue(v);
+                        }
+                        return out;
+                    }
+                    if (val instanceof Set)
+                        return [...val].map(sanitizeMetadataValue);
+                    if (Array.isArray(val))
+                        return val.map(sanitizeMetadataValue);
+                    if (val instanceof Error || (core_bentley_1.JsonUtils.isObject(val) && Object.getPrototypeOf(val) === Object.prototype)) {
+                        const out = {};
+                        for (const key of Object.keys(val))
+                            out[key] = sanitizeMetadataValue(val[key]);
+                        if (val instanceof Error)
+                            out.message = val.message;
+                        if (val instanceof core_bentley_1.BentleyError)
+                            applyBentleyErrorIdentity(val, out, sanitizeMetadataValue);
+                        return out;
+                    }
+                    return undefined; // other class instances: not cloneable across every transport
+                }
+                finally {
+                    visited.delete(val);
+                }
+            };
+            if (serialized.loggingMetadata !== undefined)
+                serialized.loggingMetadata = sanitizeMetadataValue(serialized.loggingMetadata);
+            const genericStripExcludedKeys = new Set(["loggingMetadata"]);
+            for (const key of Object.keys(serialized)) {
+                if (genericStripExcludedKeys.has(key))
+                    continue;
+                serialized[key] = serializeValue(serialized[key]);
+            }
+            return serialized;
+        }
+        finally {
+            // Remove from the stack so a sibling branch can still serialize this object.
+            visited.delete(e);
+        }
+    };
+    return { error: serialize(err) };
+}
+/**
+ * Reconstruct an `Error` from the serialized `error` produced by [[serializeIpcError]], so the Ipc caller can
+ * `throw` it.
+ *
+ * By default, rebuilds a plain `Error` following the `ITwinError` paradigm (identify via
+ * [ITwinError.isError]($bentley), since `instanceof` cannot survive marshalling across the Ipc boundary). Pass
+ * `typedErrorClass` for backwards compatibility to rebuild a legacy typed `BentleyError` subclass instead — the
+ * frontend uses this to keep rethrowing [BackendError]($common).
+ * @param err The serialized error object (must be an object; callers should forward non-object values as-is).
+ * @param typedErrorClass Optional constructor for a legacy typed error (e.g. [BackendError]($common)). Omit for
+ * the ITwinError paradigm.
+ * @returns The reconstructed `Error` to throw.
+ * @internal
+ */
+function rebuildIpcError(err, typedErrorClass) {
+    if (typedErrorClass === undefined || !core_bentley_1.BentleyError.isError(err)) {
+        const rebuilt = Object.assign(new Error(), err);
+        // Object.assign above re-copies `err`'s own `message` (even a non-string one, e.g. `throw { message: 123 }`),
+        // so guard/normalize the final message *after* the assign rather than before, or this would be silently overwritten.
+        rebuilt.message = typeof err.message === "string" ? err.message : "unknown error";
+        return rebuilt;
+    }
+    const trimErr = { ...err };
+    delete trimErr.iTwinErrorId; // getter on the typed error; assigning would throw
+    delete trimErr.loggingMetadata; // getter on the typed error; assigning would throw
+    return Object.assign(new typedErrorClass(err.errorNumber, err.iTwinErrorId.key, err.message, err.loggingMetadata), trimErr);
+}
+//# sourceMappingURL=IpcErrors.js.map

package/lib/cjs/ipc/IpcErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IpcErrors.js","sourceRoot":"","sources":["../../../src/ipc/IpcErrors.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module IpcSocket\n */\n\nimport { BentleyError, JsonUtils, LoggingMetaData } from \"@itwin/core-bentley\";\nimport { IpcInvokeReturn } from \"./IpcSocket\";\n\n/**\n * Serialize a value thrown by an Ipc handler into the [[IpcInvokeReturn]] `error` envelope so it can be\n * transmitted across an Ipc socket via structured clone or JSON, depending on the transport.\n *\n * Hardens against values that can't be cloned: copies `Error`'s non-enumerable `message`/`stack`/`cause`,\n * preserves `BentleyError` identity (`iTwinErrorId` and logging metadata, normalized to a JSON-safe form),\n * recurses into nested `Error`s and plain objects, strips functions and class instances, and guards against cycles.\n * @param err The thrown value to serialize.\n * @param includeStack Whether to include `Error.stack` in the serialized output.\n * @returns An [[IpcInvokeReturn]] holding the serialized `error`.\n * @internal\n */\nexport function serializeIpcError(err: unknown, includeStack: boolean): IpcInvokeReturn {\n  if (!JsonUtils.isObject(err))\n    return { error: err };\n\n  const serialize = (e: any, visited = new WeakSet<object>()): any => {\n    if (visited.has(e))\n      return undefined;\n    visited.add(e);\n    try {\n      const serialized: any = { ...e };\n\n      for (const sym of Object.getOwnPropertySymbols(serialized))\n        delete serialized[sym]; // symbol-keyed properties cannot be structured-cloned\n\n      // `iTwinErrorId`/`loggingMetadata` are prototype getters, so `Object.keys`/spread never pick them up; resolve\n      // them explicitly. Shared by the top-level and metadata-nested paths below so they can't drift apart again.\n      const applyBentleyErrorIdentity = (be: BentleyError, out: any, sanitize: (v: unknown) => unknown): void => {\n        out.iTwinErrorId = be.iTwinErrorId;\n        if (be.hasMetaData)\n          out.loggingMetadata = sanitize(be.loggingMetadata);\n        delete out._metaData;\n      };\n\n      if (e instanceof Error) {\n        serialized.message = e.message; // NB: .message and .stack are non-enumerable on Error instances\n        if (includeStack)\n          serialized.stack = e.stack;\n\n        // Error.cause is typically non-enumerable and must be copied explicitly.\n        if (Object.prototype.hasOwnProperty.call(e, \"cause\"))\n          serialized.cause = (e as { cause?: unknown }).cause;\n      }\n\n      if (e instanceof BentleyError)\n        applyBentleyErrorIdentity(e, serialized, (v) => v); // loggingMetadata is sanitized once, below\n\n      // Only recurse into Error instances and plain objects — not class instances like Date or Buffer.\n      const shouldRecurse = (val: any) => val instanceof Error || (JsonUtils.isObject(val) && Object.getPrototypeOf(val) === Object.prototype);\n      const isSerializableLeaf = (val: unknown): boolean => {\n        const t = typeof val;\n        return val === null || val === undefined || val instanceof Date\n          || t === \"string\" || t === \"number\" || t === \"boolean\";\n      };\n      // Recurse into arrays, Errors, and plain objects; strip anything else non-cloneable (functions, RegExp,\n      // Map, Set, typed arrays, other class instances) to `undefined`.\n      const serializeValue = (val: any): any => {\n        if (Array.isArray(val)) {\n          // Arrays need their own cycle guard: they never pass through `serialize` below, so a self-referencing\n          // array would otherwise recurse via `map` forever.\n          if (visited.has(val))\n            return undefined;\n          visited.add(val);\n          try {\n            return val.map((item) => serializeValue(item));\n          } finally {\n            visited.delete(val);\n          }\n        }\n        if (shouldRecurse(val))\n          return serialize(val, visited);\n        return isSerializableLeaf(val) ? val : undefined;\n      };\n      // `loggingMetadata` can be any shape (e.g. a `Map`/`Set` from a `GetMetaDataFunction`). Normalize it to a\n      // JSON-safe form so it survives every transport — raw `Map`/`Set` clone fine over Electron's structured\n      // clone but collapse to `{}` over the WebSocket transport, which uses `JSON.stringify`.\n      const sanitizeMetadataValue = (val: any): any => {\n        if (val === null || val === undefined || val instanceof Date || typeof val === \"string\" || typeof val === \"number\" || typeof val === \"boolean\")\n          return val;\n        if (typeof val !== \"object\" || visited.has(val))\n          return undefined; // functions, symbols, or an already-visited (cyclic) value\n\n        visited.add(val);\n        try {\n          if (val instanceof Map) {\n            // String(k) can collide (e.g. two object keys); suffix with \"#n\" so entries aren't silently dropped.\n            const out: any = {};\n            const keyCounts = new Map<string, number>();\n            for (const [k, v] of val) {\n              const baseKey = String(k);\n              const count = keyCounts.get(baseKey) ?? 0;\n              keyCounts.set(baseKey, count + 1);\n              out[count === 0 ? baseKey : `${baseKey}#${count}`] = sanitizeMetadataValue(v);\n            }\n            return out;\n          }\n          if (val instanceof Set)\n            return [...val].map(sanitizeMetadataValue);\n          if (Array.isArray(val))\n            return val.map(sanitizeMetadataValue);\n          if (val instanceof Error || (JsonUtils.isObject(val) && Object.getPrototypeOf(val) === Object.prototype)) {\n            const out: any = {};\n            for (const key of Object.keys(val))\n              out[key] = sanitizeMetadataValue((val as any)[key]);\n            if (val instanceof Error)\n              out.message = val.message;\n            if (val instanceof BentleyError)\n              applyBentleyErrorIdentity(val, out, sanitizeMetadataValue);\n            return out;\n          }\n          return undefined; // other class instances: not cloneable across every transport\n        } finally {\n          visited.delete(val);\n        }\n      };\n      if (serialized.loggingMetadata !== undefined)\n        serialized.loggingMetadata = sanitizeMetadataValue(serialized.loggingMetadata);\n\n      const genericStripExcludedKeys = new Set([\"loggingMetadata\"]);\n      for (const key of Object.keys(serialized)) {\n        if (genericStripExcludedKeys.has(key))\n          continue;\n        serialized[key] = serializeValue(serialized[key]);\n      }\n\n      return serialized;\n    } finally {\n      // Remove from the stack so a sibling branch can still serialize this object.\n      visited.delete(e);\n    }\n  };\n\n  return { error: serialize(err) };\n}\n\n/**\n * Reconstruct an `Error` from the serialized `error` produced by [[serializeIpcError]], so the Ipc caller can\n * `throw` it.\n *\n * By default, rebuilds a plain `Error` following the `ITwinError` paradigm (identify via\n * [ITwinError.isError]($bentley), since `instanceof` cannot survive marshalling across the Ipc boundary). Pass\n * `typedErrorClass` for backwards compatibility to rebuild a legacy typed `BentleyError` subclass instead — the\n * frontend uses this to keep rethrowing [BackendError]($common).\n * @param err The serialized error object (must be an object; callers should forward non-object values as-is).\n * @param typedErrorClass Optional constructor for a legacy typed error (e.g. [BackendError]($common)). Omit for\n * the ITwinError paradigm.\n * @returns The reconstructed `Error` to throw.\n * @internal\n */\nexport function rebuildIpcError(\n  err: any,\n  typedErrorClass?: new (errorNumber: number, name: string, message: string, getMetaData?: LoggingMetaData) => Error,\n): Error {\n  if (typedErrorClass === undefined || !BentleyError.isError(err)) {\n    const rebuilt = Object.assign(new Error(), err);\n    // Object.assign above re-copies `err`'s own `message` (even a non-string one, e.g. `throw { message: 123 }`),\n    // so guard/normalize the final message *after* the assign rather than before, or this would be silently overwritten.\n    rebuilt.message = typeof err.message === \"string\" ? err.message : \"unknown error\";\n    return rebuilt;\n  }\n\n  const trimErr: any = { ...err };\n  delete trimErr.iTwinErrorId;    // getter on the typed error; assigning would throw\n  delete trimErr.loggingMetadata; // getter on the typed error; assigning would throw\n  return Object.assign(new typedErrorClass(err.errorNumber, err.iTwinErrorId.key, err.message, err.loggingMetadata), trimErr);\n}\n"]}

package/lib/cjs/ipc/IpcInvoke.d.ts

@@ -0,0 +1,44 @@
+/** @packageDocumentation
+ * @module IpcSocket
+ */
+import { LoggingMetaData, PickAsyncMethods } from "@itwin/core-bentley";
+import { IpcInvokeReturn } from "./IpcSocket";
+/**
+ * Unwrap an [[IpcInvokeReturn]] produced by an Ipc handler: return its `result` on success, or rethrow the
+ * serialized `error` on failure (rebuilt via [[rebuildIpcError]]; non-object values are rethrown as-is).
+ *
+ * Shared by both Ipc directions. By default the error is rebuilt as a plain `Error` following the `ITwinError`
+ * paradigm (identify via [ITwinError.isError]($bentley)); the backend (`IpcHost`) uses this. A caller may pass
+ * `typedErrorClass` to rebuild a legacy typed error instead — the frontend (`IpcApp`) passes [BackendError]($common)
+ * to preserve `instanceof BackendError` for existing consumers.
+ * @param retVal The [[IpcInvokeReturn]] returned by the remote handler.
+ * @param typedErrorClass Optional constructor for a legacy typed error to build when the serialized error carries
+ * `BentleyError` identity (e.g. [BackendError]($common) on the frontend). Omit it for the ITwinError paradigm.
+ * @returns The handler's `result` value, typed as `T` (defaults to `unknown`, so untyped callers must narrow).
+ * @throws The reconstructed error when `retVal` carries an `error`.
+ * @internal
+ */
+export declare function unwrapIpcInvokeReturn<T = unknown>(retVal: IpcInvokeReturn, typedErrorClass?: new (errorNumber: number, name: string, message: string, getMetaData?: LoggingMetaData) => Error): T;
+/**
+ * Create a type-safe `Proxy` that routes every method access to `call`, forwarding the accessed method name and
+ * its arguments. Shared by the frontend (`IpcApp.makeIpcProxy`) and backend (`IpcHost.makeIpcProxy`) so both build
+ * their remote-interface proxies identically; each supplies a `call` bound to its own `callIpcChannel`.
+ * @param call Invoked with the accessed method name followed by the call arguments.
+ * @returns A `Proxy` exposing `K`'s async methods.
+ * @internal
+ */
+export declare function createIpcProxy<K>(call: (methodName: string, ...args: any[]) => Promise<any>): PickAsyncMethods<K>;
+/**
+ * Create the handler that an `IpcHandler` registers on its channel: it looks up `funcName` on `impl`, invokes it
+ * with `args`, and packages the outcome as an [[IpcInvokeReturn]] (`{ result }` on success, or a serialized `error`
+ * via [[serializeIpcError]] on failure). Shared by the frontend and backend `IpcHandler.register` implementations
+ * so method dispatch and error packaging behave identically in both directions.
+ * @param impl The handler instance whose methods are exposed over the channel.
+ * @param channelName The channel `impl` is registered on, used for diagnostic messages.
+ * @param includeStack Whether to include `Error.stack` in serialized errors, or a function evaluated per
+ * invocation to decide (the backend omits stacks when [[IpcHost.noStack]] is set, which can change at runtime).
+ * @returns An async dispatcher `(funcName, ...args) => Promise<IpcInvokeReturn>`.
+ * @internal
+ */
+export declare function createIpcDispatcher(impl: object, channelName: string, includeStack: boolean | (() => boolean)): (funcName: string, ...args: any[]) => Promise<IpcInvokeReturn>;
+//# sourceMappingURL=IpcInvoke.d.ts.map

package/lib/cjs/ipc/IpcInvoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IpcInvoke.d.ts","sourceRoot":"","sources":["../../../src/ipc/IpcInvoke.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAA2B,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGjG,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,OAAO,EAC/C,MAAM,EAAE,eAAe,EACvB,eAAe,CAAC,EAAE,KAAK,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,KAAK,KAAK,GACjH,CAAC,CAUH;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAMjH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,GACtC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAiBhE"}

package/lib/cjs/ipc/IpcInvoke.js

@@ -0,0 +1,83 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module IpcSocket
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrapIpcInvokeReturn = unwrapIpcInvokeReturn;
+exports.createIpcProxy = createIpcProxy;
+exports.createIpcDispatcher = createIpcDispatcher;
+const core_bentley_1 = require("@itwin/core-bentley");
+const IModelError_1 = require("../IModelError");
+const IpcErrors_1 = require("./IpcErrors");
+/**
+ * Unwrap an [[IpcInvokeReturn]] produced by an Ipc handler: return its `result` on success, or rethrow the
+ * serialized `error` on failure (rebuilt via [[rebuildIpcError]]; non-object values are rethrown as-is).
+ *
+ * Shared by both Ipc directions. By default the error is rebuilt as a plain `Error` following the `ITwinError`
+ * paradigm (identify via [ITwinError.isError]($bentley)); the backend (`IpcHost`) uses this. A caller may pass
+ * `typedErrorClass` to rebuild a legacy typed error instead — the frontend (`IpcApp`) passes [BackendError]($common)
+ * to preserve `instanceof BackendError` for existing consumers.
+ * @param retVal The [[IpcInvokeReturn]] returned by the remote handler.
+ * @param typedErrorClass Optional constructor for a legacy typed error to build when the serialized error carries
+ * `BentleyError` identity (e.g. [BackendError]($common) on the frontend). Omit it for the ITwinError paradigm.
+ * @returns The handler's `result` value, typed as `T` (defaults to `unknown`, so untyped callers must narrow).
+ * @throws The reconstructed error when `retVal` carries an `error`.
+ * @internal
+ */
+function unwrapIpcInvokeReturn(retVal, typedErrorClass) {
+    if (retVal.error === undefined)
+        return retVal.result; // method was successful
+    // remote handler threw an exception, rethrow one on this side
+    const err = retVal.error;
+    if (!core_bentley_1.JsonUtils.isObject(err)) // exception wasn't an object?
+        throw retVal.error; // eslint-disable-line @typescript-eslint/only-throw-error
+    throw (0, IpcErrors_1.rebuildIpcError)(err, typedErrorClass);
+}
+/**
+ * Create a type-safe `Proxy` that routes every method access to `call`, forwarding the accessed method name and
+ * its arguments. Shared by the frontend (`IpcApp.makeIpcProxy`) and backend (`IpcHost.makeIpcProxy`) so both build
+ * their remote-interface proxies identically; each supplies a `call` bound to its own `callIpcChannel`.
+ * @param call Invoked with the accessed method name followed by the call arguments.
+ * @returns A `Proxy` exposing `K`'s async methods.
+ * @internal
+ */
+function createIpcProxy(call) {
+    return new Proxy({}, {
+        get(_target, methodName) {
+            return async (...args) => call(methodName, ...args);
+        },
+    });
+}
+/**
+ * Create the handler that an `IpcHandler` registers on its channel: it looks up `funcName` on `impl`, invokes it
+ * with `args`, and packages the outcome as an [[IpcInvokeReturn]] (`{ result }` on success, or a serialized `error`
+ * via [[serializeIpcError]] on failure). Shared by the frontend and backend `IpcHandler.register` implementations
+ * so method dispatch and error packaging behave identically in both directions.
+ * @param impl The handler instance whose methods are exposed over the channel.
+ * @param channelName The channel `impl` is registered on, used for diagnostic messages.
+ * @param includeStack Whether to include `Error.stack` in serialized errors, or a function evaluated per
+ * invocation to decide (the backend omits stacks when [[IpcHost.noStack]] is set, which can change at runtime).
+ * @returns An async dispatcher `(funcName, ...args) => Promise<IpcInvokeReturn>`.
+ * @internal
+ */
+function createIpcDispatcher(impl, channelName, includeStack) {
+    const prohibitedFunctions = Object.getOwnPropertyNames(Object.getPrototypeOf({}));
+    return async (funcName, ...args) => {
+        try {
+            if (prohibitedFunctions.includes(funcName))
+                throw new Error(`Method "${funcName}" not available for channel: ${channelName}`);
+            const func = impl[funcName];
+            if (typeof func !== "function")
+                throw new IModelError_1.IModelError(core_bentley_1.IModelStatus.FunctionNotFound, `Method "${impl.constructor.name}.${funcName}" not found on IpcHandler registered for channel: ${channelName}`);
+            return { result: await func.call(impl, ...args) };
+        }
+        catch (err) {
+            return (0, IpcErrors_1.serializeIpcError)(err, typeof includeStack === "function" ? includeStack() : includeStack);
+        }
+    };
+}
+//# sourceMappingURL=IpcInvoke.js.map

package/lib/cjs/ipc/IpcInvoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IpcInvoke.js","sourceRoot":"","sources":["../../../src/ipc/IpcInvoke.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;AAsBH,sDAaC;AAUD,wCAMC;AAcD,kDAqBC;AApFD,sDAAiG;AACjG,gDAA6C;AAC7C,2CAAiE;AAGjE;;;;;;;;;;;;;;GAcG;AACH,SAAgB,qBAAqB,CACnC,MAAuB,EACvB,eAAkH;IAElH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAC5B,OAAO,MAAM,CAAC,MAAW,CAAC,CAAC,wBAAwB;IAErD,8DAA8D;IAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;IACzB,IAAI,CAAC,wBAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,8BAA8B;QAC1D,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,0DAA0D;IAEhF,MAAM,IAAA,2BAAe,EAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAI,IAA0D;IAC1F,OAAO,IAAI,KAAK,CAAC,EAAyB,EAAE;QAC1C,GAAG,CAAC,OAAO,EAAE,UAAkB;YAC7B,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,mBAAmB,CACjC,IAAY,EACZ,WAAmB,EACnB,YAAuC;IAEvC,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;IAElF,OAAO,KAAK,EAAE,QAAgB,EAAE,GAAG,IAAW,EAA4B,EAAE;QAC1E,IAAI,CAAC;YACH,IAAI,mBAAmB,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,WAAW,QAAQ,gCAAgC,WAAW,EAAE,CAAC,CAAC;YAEpF,MAAM,IAAI,GAAI,IAAY,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,OAAO,IAAI,KAAK,UAAU;gBAC5B,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,gBAAgB,EAAE,WAAW,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,QAAQ,qDAAqD,WAAW,EAAE,CAAC,CAAC;YAEvK,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,IAAA,6BAAiB,EAAC,GAAG,EAAE,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QACpG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module IpcSocket\n */\n\nimport { IModelStatus, JsonUtils, LoggingMetaData, PickAsyncMethods } from \"@itwin/core-bentley\";\nimport { IModelError } from \"../IModelError\";\nimport { rebuildIpcError, serializeIpcError } from \"./IpcErrors\";\nimport { IpcInvokeReturn } from \"./IpcSocket\";\n\n/**\n * Unwrap an [[IpcInvokeReturn]] produced by an Ipc handler: return its `result` on success, or rethrow the\n * serialized `error` on failure (rebuilt via [[rebuildIpcError]]; non-object values are rethrown as-is).\n *\n * Shared by both Ipc directions. By default the error is rebuilt as a plain `Error` following the `ITwinError`\n * paradigm (identify via [ITwinError.isError]($bentley)); the backend (`IpcHost`) uses this. A caller may pass\n * `typedErrorClass` to rebuild a legacy typed error instead — the frontend (`IpcApp`) passes [BackendError]($common)\n * to preserve `instanceof BackendError` for existing consumers.\n * @param retVal The [[IpcInvokeReturn]] returned by the remote handler.\n * @param typedErrorClass Optional constructor for a legacy typed error to build when the serialized error carries\n * `BentleyError` identity (e.g. [BackendError]($common) on the frontend). Omit it for the ITwinError paradigm.\n * @returns The handler's `result` value, typed as `T` (defaults to `unknown`, so untyped callers must narrow).\n * @throws The reconstructed error when `retVal` carries an `error`.\n * @internal\n */\nexport function unwrapIpcInvokeReturn<T = unknown>(\n  retVal: IpcInvokeReturn,\n  typedErrorClass?: new (errorNumber: number, name: string, message: string, getMetaData?: LoggingMetaData) => Error,\n): T {\n  if (retVal.error === undefined)\n    return retVal.result as T; // method was successful\n\n  // remote handler threw an exception, rethrow one on this side\n  const err = retVal.error;\n  if (!JsonUtils.isObject(err)) // exception wasn't an object?\n    throw retVal.error; // eslint-disable-line @typescript-eslint/only-throw-error\n\n  throw rebuildIpcError(err, typedErrorClass);\n}\n\n/**\n * Create a type-safe `Proxy` that routes every method access to `call`, forwarding the accessed method name and\n * its arguments. Shared by the frontend (`IpcApp.makeIpcProxy`) and backend (`IpcHost.makeIpcProxy`) so both build\n * their remote-interface proxies identically; each supplies a `call` bound to its own `callIpcChannel`.\n * @param call Invoked with the accessed method name followed by the call arguments.\n * @returns A `Proxy` exposing `K`'s async methods.\n * @internal\n */\nexport function createIpcProxy<K>(call: (methodName: string, ...args: any[]) => Promise<any>): PickAsyncMethods<K> {\n  return new Proxy({} as PickAsyncMethods<K>, {\n    get(_target, methodName: string) {\n      return async (...args: any[]) => call(methodName, ...args);\n    },\n  });\n}\n\n/**\n * Create the handler that an `IpcHandler` registers on its channel: it looks up `funcName` on `impl`, invokes it\n * with `args`, and packages the outcome as an [[IpcInvokeReturn]] (`{ result }` on success, or a serialized `error`\n * via [[serializeIpcError]] on failure). Shared by the frontend and backend `IpcHandler.register` implementations\n * so method dispatch and error packaging behave identically in both directions.\n * @param impl The handler instance whose methods are exposed over the channel.\n * @param channelName The channel `impl` is registered on, used for diagnostic messages.\n * @param includeStack Whether to include `Error.stack` in serialized errors, or a function evaluated per\n * invocation to decide (the backend omits stacks when [[IpcHost.noStack]] is set, which can change at runtime).\n * @returns An async dispatcher `(funcName, ...args) => Promise<IpcInvokeReturn>`.\n * @internal\n */\nexport function createIpcDispatcher(\n  impl: object,\n  channelName: string,\n  includeStack: boolean | (() => boolean),\n): (funcName: string, ...args: any[]) => Promise<IpcInvokeReturn> {\n  const prohibitedFunctions = Object.getOwnPropertyNames(Object.getPrototypeOf({}));\n\n  return async (funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => {\n    try {\n      if (prohibitedFunctions.includes(funcName))\n        throw new Error(`Method \"${funcName}\" not available for channel: ${channelName}`);\n\n      const func = (impl as any)[funcName];\n      if (typeof func !== \"function\")\n        throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${impl.constructor.name}.${funcName}\" not found on IpcHandler registered for channel: ${channelName}`);\n\n      return { result: await func.call(impl, ...args) };\n    } catch (err: unknown) {\n      return serializeIpcError(err, typeof includeStack === \"function\" ? includeStack() : includeStack);\n    }\n  };\n}\n"]}

package/lib/esm/ConcurrentQuery.d.ts

@@ -414,12 +414,25 @@ export declare class QueryBinder {
      */
     bindRange3d(indexOrName: string | number, val: LowAndHighXYZ): this;
     private static bind;
+    /**
+     * Shared implementation for [[QueryBinder.from]] and [[QueryBinder.fromSkippingNullish]].
+     * @param args if array of values is provided then array index is used as index. If object is provided then object property name is used as parameter name of each value.
+     * @param skipNullish if true, entries whose value is `undefined` or `null` are skipped instead of bound as NULL.
+     */
+    private static fromImpl;
     /**
      * Allow bulk bind either parameters by index as value array or by parameter names as object.
-     * @param args if array of values is provided then array index is used as index. If object is provided then object property name is used as parameter name of reach value.
+     * @param args if array of values is provided then array index is used as index. If object is provided then object property name is used as parameter name of each value.
      * @returns @type QueryBinder to allow fluent interface.
      */
     static from(args: any[] | object | undefined): QueryBinder;
+    /**
+     * Same as [[QueryBinder.from]], except entries whose value is `undefined` or `null` are skipped instead of bound as NULL,
+     * matching the legacy `ECSqlStatement.bindValues` semantics. For positional arrays, skipped positions are left unbound
+     * and later positions keep their 1-based index.
+     * @internal
+     */
+    static fromSkippingNullish(args: any[] | object | undefined): QueryBinder;
     serialize(): object;
 }
 /** @internal */

package/lib/esm/ConcurrentQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConcurrentQuery.d.ts","sourceRoot":"","sources":["../../src/ConcurrentQuery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConcurrentQuery.d.ts","sourceRoot":"","sources":["../../src/ConcurrentQuery.ts"],"names":[],"mappings":"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"}

package/lib/esm/ConcurrentQuery.js

@@ -531,27 +531,49 @@ export class QueryBinder {
         }
     }
     /**
-     * Allow bulk bind either parameters by index as value array or by parameter names as object.
-     * @param args if array of values is provided then array index is used as index. If object is provided then object property name is used as parameter name of reach value.
-     * @returns @type QueryBinder to allow fluent interface.
+     * Shared implementation for [[QueryBinder.from]] and [[QueryBinder.fromSkippingNullish]].
+     * @param args if array of values is provided then array index is used as index. If object is provided then object property name is used as parameter name of each value.
+     * @param skipNullish if true, entries whose value is `undefined` or `null` are skipped instead of bound as NULL.
      */
-    static from(args) {
+    static fromImpl(args, skipNullish) {
         const params = new QueryBinder();
         if (typeof args === "undefined")
             return params;
+        const shouldBind = (val) => !skipNullish || (val !== undefined && val !== null);
         if (Array.isArray(args)) {
             let i = 1;
             for (const val of args) {
-                this.bind(params, i++, val);
+                const index = i++;
+                if (shouldBind(val))
+                    this.bind(params, index, val);
             }
         }
         else {
             for (const prop of Object.getOwnPropertyNames(args)) {
-                this.bind(params, prop, args[prop]);
+                const val = args[prop];
+                if (shouldBind(val))
+                    this.bind(params, prop, val);
             }
         }
         return params;
     }
+    /**
+     * Allow bulk bind either parameters by index as value array or by parameter names as object.
+     * @param args if array of values is provided then array index is used as index. If object is provided then object property name is used as parameter name of each value.
+     * @returns @type QueryBinder to allow fluent interface.
+     */
+    static from(args) {
+        return this.fromImpl(args, false);
+    }
+    /**
+     * Same as [[QueryBinder.from]], except entries whose value is `undefined` or `null` are skipped instead of bound as NULL,
+     * matching the legacy `ECSqlStatement.bindValues` semantics. For positional arrays, skipped positions are left unbound
+     * and later positions keep their 1-based index.
+     * @internal
+     */
+    static fromSkippingNullish(args) {
+        return this.fromImpl(args, true);
+    }
     serialize() {
         return this._args;
     }