@itwin/core-common 3.0.0-dev.136 → 3.0.0-dev.141

package/lib/cjs/ipc/IpcWebSocketTransport.js

@@ -0,0 +1,136 @@
+"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.IpcWebSocketTransport = void 0;
+const IpcWebSocket_1 = require("./IpcWebSocket");
+let parts = [];
+/** @internal */
+class IpcWebSocketTransport {
+    constructor() {
+        this._received = [];
+        this._outstanding = 0;
+    }
+    unwrap(data) {
+        return (typeof (Blob) !== "undefined" && data instanceof Blob) ? data.arrayBuffer() : data;
+    }
+    async notifyIncoming(data) {
+        if (this._partial) {
+            this._received.push(data);
+            --this._outstanding;
+            if (this._outstanding === 0) {
+                await Promise.all(this._received.map(async (v, i, a) => a[i] = await this.unwrap(v)));
+                parts = this._received;
+                const message = JSON.parse(this._partial, reviver);
+                this._partial = undefined;
+                parts.length = 0;
+                return InSentOrder.deliver(message);
+            }
+            else {
+                return IpcWebSocket_1.IpcWebSocketMessage.internal();
+            }
+        }
+        else {
+            const [serialized, followers] = JSON.parse(data);
+            if (followers) {
+                this._partial = serialized;
+                this._outstanding = followers;
+                return IpcWebSocket_1.IpcWebSocketMessage.internal();
+            }
+            else {
+                const message = JSON.parse(serialized, reviver);
+                return InSentOrder.deliver(message);
+            }
+        }
+    }
+    serialize(data) {
+        parts.length = 0;
+        const objects = JSON.stringify(data, replacer);
+        const value = [JSON.stringify([objects, parts.length]), ...parts];
+        parts.length = 0;
+        return value;
+    }
+}
+exports.IpcWebSocketTransport = IpcWebSocketTransport;
+const types = [Uint8Array, Int8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array, Uint32Array, Float32Array, Float64Array, DataView];
+function identify(value) { return Buffer.isBuffer(value) ? 0 : types.indexOf(value.constructor); }
+function lookup(value) { return types[value.type]; }
+function replacer(_key, value) {
+    const asBinary = replaceBinary(value);
+    if (asBinary) {
+        return asBinary;
+    }
+    return value;
+}
+function reviver(_key, value) {
+    if (typeof (value) === "object" && value !== null && value.hasOwnProperty("ipc") && value.ipc === "binary") {
+        return reviveBinary(value);
+    }
+    return value;
+}
+function replaceBinary(value) {
+    if (ArrayBuffer.isView(value) || Buffer.isBuffer(value)) {
+        const index = parts.push(value) - 1;
+        const type = identify(value);
+        return { ipc: "binary", type, index };
+    }
+    else {
+        return undefined;
+    }
+}
+function reviveBinary(value) {
+    const constructor = lookup(value);
+    const part = parts[value.index];
+    return new constructor(part);
+}
+function makePromise() {
+    let resolve = () => { };
+    let reject = () => { };
+    const promise = new Promise((res, rej) => { resolve = res; reject = rej; });
+    return { promise, resolve, reject };
+}
+/* Reconstructing the sequence in which messages were sent is necessary since
+   the binary data for a message has to be awaited in IpcWebSocketTransport.unwrap. */
+class InSentOrder {
+    constructor(message) {
+        this.release = () => { };
+        this.duplicate = false;
+        this.sequence = message.sequence;
+        const { promise, resolve } = makePromise();
+        this.message = promise;
+        this.release = () => {
+            const value = this.duplicate ? IpcWebSocket_1.IpcWebSocketMessage.duplicate() : message;
+            resolve(value);
+        };
+    }
+    static get _next() { return this._last + 1; }
+    static async deliver(message) {
+        const entry = new InSentOrder(message);
+        this._queue.push(entry);
+        this._queue.sort((a, b) => a.sequence - b.sequence);
+        while (this._queue.length !== 0) {
+            const next = this._queue[0];
+            const duplicate = next.sequence <= this._last;
+            const match = next.sequence === this._next;
+            if (duplicate) {
+                next.duplicate = true;
+            }
+            else if (match) {
+                ++this._last;
+            }
+            if (duplicate || match) {
+                this._queue.shift();
+                next.release();
+            }
+        }
+        return entry.message;
+    }
+}
+InSentOrder._queue = [];
+InSentOrder._last = -1;
+//# sourceMappingURL=IpcWebSocketTransport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IpcWebSocketTransport.js","sourceRoot":"","sources":["../../../src/ipc/IpcWebSocketTransport.ts"],"names":[],"mappings":"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","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 IpcSocket\r\n */\r\n\r\nimport { IpcWebSocketMessage } from \"./IpcWebSocket\";\r\n\r\nlet parts: any[] = [];\r\n\r\n/** @internal */\r\nexport abstract class IpcWebSocketTransport {\r\n  private _partial?: string;\r\n  private _received: any[] = [];\r\n  private _outstanding = 0;\r\n\r\n  public abstract send(message: IpcWebSocketMessage): void;\r\n\r\n  protected unwrap(data: any) {\r\n    return (typeof (Blob) !== \"undefined\" && data instanceof Blob) ? data.arrayBuffer() : data;\r\n  }\r\n\r\n  protected async notifyIncoming(data: any): Promise<IpcWebSocketMessage> {\r\n    if (this._partial) {\r\n      this._received.push(data);\r\n      --this._outstanding;\r\n\r\n      if (this._outstanding === 0) {\r\n        await Promise.all(this._received.map(async (v, i, a) => a[i] = await this.unwrap(v)));\r\n        parts = this._received;\r\n        const message: IpcWebSocketMessage = JSON.parse(this._partial, reviver);\r\n        this._partial = undefined;\r\n        parts.length = 0;\r\n        return InSentOrder.deliver(message);\r\n      } else {\r\n        return IpcWebSocketMessage.internal();\r\n      }\r\n    } else {\r\n      const [serialized, followers] = JSON.parse(data);\r\n\r\n      if (followers) {\r\n        this._partial = serialized;\r\n        this._outstanding = followers;\r\n        return IpcWebSocketMessage.internal();\r\n      } else {\r\n        const message: IpcWebSocketMessage = JSON.parse(serialized, reviver);\r\n        return InSentOrder.deliver(message);\r\n      }\r\n    }\r\n  }\r\n\r\n  protected serialize(data: IpcWebSocketMessage): any[] {\r\n    parts.length = 0;\r\n    const objects = JSON.stringify(data, replacer);\r\n    const value = [JSON.stringify([objects, parts.length]), ...parts];\r\n    parts.length = 0;\r\n    return value;\r\n  }\r\n}\r\n\r\ninterface Marker { ipc: \"binary\", type: number, index: number }\r\nconst types = [Uint8Array, Int8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array, Uint32Array, Float32Array, Float64Array, DataView];\r\nfunction identify(value: any) { return Buffer.isBuffer(value) ? 0 : types.indexOf(value.constructor); }\r\nfunction lookup(value: Marker) { return types[value.type]; }\r\n\r\nfunction replacer(this: any, _key: string, value: any) {\r\n  const asBinary = replaceBinary(value);\r\n  if (asBinary) {\r\n    return asBinary;\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\nfunction reviver(_key: string, value: any) {\r\n  if (typeof (value) === \"object\" && value !== null && value.hasOwnProperty(\"ipc\") && value.ipc === \"binary\") {\r\n    return reviveBinary(value);\r\n  }\r\n\r\n  return value;\r\n}\r\n\r\nfunction replaceBinary(value: any): Marker | undefined {\r\n  if (ArrayBuffer.isView(value) || Buffer.isBuffer(value)) {\r\n    const index = parts.push(value) - 1;\r\n    const type = identify(value);\r\n    return { ipc: \"binary\", type, index };\r\n  } else {\r\n    return undefined;\r\n  }\r\n}\r\n\r\nfunction reviveBinary(value: Marker): ArrayBufferView {\r\n  const constructor = lookup(value);\r\n  const part = parts[value.index];\r\n  return new constructor(part);\r\n}\r\n\r\nfunction makePromise<T>() {\r\n  let resolve: (value: T | PromiseLike<T>) => void = () => { };\r\n  let reject: (reason?: any) => void = () => { };\r\n  const promise = new Promise<T>((res, rej) => { resolve = res; reject = rej; });\r\n  return { promise, resolve, reject };\r\n}\r\n\r\n/* Reconstructing the sequence in which messages were sent is necessary since\r\n   the binary data for a message has to be awaited in IpcWebSocketTransport.unwrap. */\r\nclass InSentOrder {\r\n  private static _queue: InSentOrder[] = [];\r\n  private static _last = -1;\r\n  private static get _next() { return this._last + 1; }\r\n\r\n  public static async deliver(message: IpcWebSocketMessage): Promise<IpcWebSocketMessage> {\r\n    const entry = new InSentOrder(message);\r\n    this._queue.push(entry);\r\n    this._queue.sort((a, b) => a.sequence - b.sequence);\r\n\r\n    while (this._queue.length !== 0) {\r\n      const next = this._queue[0];\r\n      const duplicate = next.sequence <= this._last;\r\n      const match = next.sequence === this._next;\r\n\r\n      if (duplicate) {\r\n        next.duplicate = true;\r\n      } else if (match) {\r\n        ++this._last;\r\n      }\r\n\r\n      if (duplicate || match) {\r\n        this._queue.shift();\r\n        next.release();\r\n      }\r\n    }\r\n\r\n    return entry.message;\r\n  }\r\n\r\n  public release = () => { };\r\n  public sequence: number;\r\n  public duplicate = false;\r\n  public message: Promise<IpcWebSocketMessage>;\r\n\r\n  private constructor(message: IpcWebSocketMessage) {\r\n    this.sequence = message.sequence;\r\n\r\n    const { promise, resolve } = makePromise<IpcWebSocketMessage>();\r\n    this.message = promise;\r\n\r\n    this.release = () => {\r\n      const value = this.duplicate ? IpcWebSocketMessage.duplicate() : message;\r\n      resolve(value);\r\n    };\r\n  }\r\n}\r\n"]}

package/lib/esm/ConcurrentQuery.d.ts

@@ -8,7 +8,7 @@ import { Point2d, Point3d } from "@itwin/core-geometry";
  * [IModelConnection]($frontend), [IModelDb]($backend), and [ECDb]($backend).
  *
  * @public
- * */
+ */
 export declare enum QueryRowFormat {
     /** Each row is an object in which each non-null column value can be accessed by its name as defined in the ECSql.
      * Null values are omitted.
@@ -19,7 +19,7 @@ export declare enum QueryRowFormat {
      */
     UseECSqlPropertyIndexes = 1,
     /** Each row is an object in which each non-null column value can be accessed by a [remapped property name]($docs/learning/ECSqlRowFormat.md).
-     * This format is backwards-compatible with the format produced by iModel.js version 2.x. Null values are omitted.
+     * This format is backwards-compatible with the format produced by iTwin.js 2.x. Null values are omitted.
      */
     UseJsPropertyNames = 2
 }

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":"AAIA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAqB,QAAQ,EAAQ,UAAU,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACvH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;GAKG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,qBAAqB,IAAA;IACrB;;OAEG;IACH,uBAAuB,IAAA;IACvB;;OAEG;IACH,kBAAkB,IAAA;CACnB;AACD;;;KAGK;AACL,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,YAAY;AACZ,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,YAAY;AACZ,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD;;;KAGK;AACL,MAAM,WAAW,UAAU;IACzB,uGAAuG;IACvG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD;;;KAGK;AACL,MAAM,WAAW,iBAAiB;IAChC,mGAAmG;IACnG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;MAEE;IACF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oGAAoG;IACpG,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AACD;;;KAGK;AACL,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD;;;SAGK;IACL,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mFAAmF;IACnF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;SAGK;IACL,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AACD,YAAY;AACZ,oBAAY,SAAS,GAAG,UAAU,CAAC;AAEnC,YAAY;AACZ,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,cAAc;AACd,qBAAa,mBAAmB;IACX,OAAO,CAAC,QAAQ;gBAAR,QAAQ,GAAE,YAAiB;IAC/C,UAAU,IAAI,YAAY;IAC1B,WAAW,CAAC,GAAG,EAAE,MAAM;IACvB,eAAe,CAAC,GAAG,EAAE,MAAM;IAC3B,QAAQ,CAAC,GAAG,EAAE,UAAU;IACxB,uBAAuB,CAAC,GAAG,EAAE,OAAO;IACpC,kBAAkB,CAAC,GAAG,EAAE,OAAO;IAC/B,oBAAoB,CAAC,GAAG,EAAE,OAAO;IACjC,yBAAyB,CAAC,GAAG,EAAE,OAAO;IACtC,QAAQ,CAAC,GAAG,EAAE,UAAU;IACxB,YAAY,CAAC,GAAG,EAAE,cAAc;CACxC;AACD,YAAY;AACZ,qBAAa,kBAAkB;IACV,OAAO,CAAC,QAAQ;gBAAR,QAAQ,GAAE,WAAgB;IAC9C,UAAU,IAAI,WAAW;IACzB,WAAW,CAAC,GAAG,EAAE,MAAM;IACvB,eAAe,CAAC,GAAG,EAAE,MAAM;IAC3B,QAAQ,CAAC,GAAG,EAAE,UAAU;IACxB,uBAAuB,CAAC,GAAG,EAAE,OAAO;IACpC,QAAQ,CAAC,GAAG,EAAE,SAAS;CAC/B;AAkBD,cAAc;AACd,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,MAAM;IAWP,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,OAAO;IAYtD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,UAAU;IAYtD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM;IAWpD,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,UAAU;IAWpD,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,mBAAmB;IAYhE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM;IAWjD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM;IAWpD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM;IAWlD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM;IAWpD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAWrC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,OAAO;IAWtD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,OAAO;IAW7D,OAAO,CAAC,MAAM,CAAC,IAAI;WAuBL,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW;IAiB1D,SAAS,IAAI,MAAM;CAC3B;AAED,gBAAgB;AAChB,oBAAY,aAAa;IACvB,MAAM,IAAI;IACV,KAAK,IAAI;CACV;AACD,gBAAgB;AAChB,oBAAY,cAAc;IACxB,MAAM,IAAuB;IAC7B,KAAK,IAAsB;IAC3B,QAAQ,IAAI;CACb;AACD,gBAAgB;AAChB,oBAAY,gBAAgB;IAC1B,IAAI,IAAI;IACR,MAAM,IAAI;IACV,OAAO,IAAI;IACX,OAAO,IAAI;IACX,SAAS,IAAI;IACb,KAAK,MAAM;IACX,0BAA0B,MAAY;IACtC,sBAAsB,MAAY;IAClC,2BAA2B,MAAY;IACvC,yBAAyB,MAAY;IACrC,uBAAuB,MAAY;IACnC,uBAAuB,MAAY;CACpC;AACD,gBAAgB;AAChB,oBAAY,aAAa;IACvB,UAAU,IAAI;IACd,OAAO,IAAI;CACZ;AACD,gBAAgB;AAChB,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AACD,gBAAgB;AAChB,MAAM,WAAW,cAAe,SAAQ,SAAS,EAAE,YAAY;IAC7D,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,gBAAgB;AAChB,MAAM,WAAW,aAAc,SAAQ,SAAS,EAAE,WAAW;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;CACxB;AACD,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,gBAAgB;AAChB,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC9B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,gBAAgB;AAChB,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,cAAc;AACd,qBAAa,YAAa,SAAQ,YAAY;aACT,QAAQ,EAAE,GAAG;aAAkB,OAAO,CAAC;gBAAvC,QAAQ,EAAE,GAAG,EAAkB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,QAAQ;WAGhF,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG;CAQxD;AACD,gBAAgB;AAChB,MAAM,WAAW,iBAAiB,CAAC,QAAQ,SAAS,SAAS,EAAE,SAAS,SAAS,UAAU;IACzF,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAChD"}

package/lib/esm/ConcurrentQuery.js

@@ -12,7 +12,7 @@ import { Point2d, Point3d } from "@itwin/core-geometry";
  * [IModelConnection]($frontend), [IModelDb]($backend), and [ECDb]($backend).
  *
  * @public
- * */
+ */
 export var QueryRowFormat;
 (function (QueryRowFormat) {
     /** Each row is an object in which each non-null column value can be accessed by its name as defined in the ECSql.
@@ -24,7 +24,7 @@ export var QueryRowFormat;
      */
     QueryRowFormat[QueryRowFormat["UseECSqlPropertyIndexes"] = 1] = "UseECSqlPropertyIndexes";
     /** Each row is an object in which each non-null column value can be accessed by a [remapped property name]($docs/learning/ECSqlRowFormat.md).
-     * This format is backwards-compatible with the format produced by iModel.js version 2.x. Null values are omitted.
+     * This format is backwards-compatible with the format produced by iTwin.js 2.x. Null values are omitted.
      */
     QueryRowFormat[QueryRowFormat["UseJsPropertyNames"] = 2] = "UseJsPropertyNames";
 })(QueryRowFormat || (QueryRowFormat = {}));

package/lib/esm/ConcurrentQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConcurrentQuery.js","sourceRoot":"","sources":["../../src/ConcurrentQuery.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAc,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACvH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;KAKK;AACL,MAAM,CAAN,IAAY,cAaX;AAbD,WAAY,cAAc;IACxB;;OAEG;IACH,qFAAqB,CAAA;IACrB;;OAEG;IACH,yFAAuB,CAAA;IACvB;;OAEG;IACH,+EAAkB,CAAA;AACpB,CAAC,EAbW,cAAc,KAAd,cAAc,QAazB;AA4FD,cAAc;AACd,MAAM,OAAO,mBAAmB;IAC9B,YAA2B,WAAyB,EAAE;QAA3B,aAAQ,GAAR,QAAQ,CAAmB;IAAI,CAAC;IACpD,UAAU,KAAmB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,WAAW,CAAC,GAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACvE,eAAe,CAAC,GAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC/E,QAAQ,CAAC,GAAe,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACrE,uBAAuB,CAAC,GAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC1F,kBAAkB,CAAC,GAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACtF,oBAAoB,CAAC,GAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC1F,yBAAyB,CAAC,GAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,2BAA2B,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACzG,QAAQ,CAAC,GAAe,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACrE,YAAY,CAAC,GAAmB,IAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;CACxF;AACD,YAAY;AACZ,MAAM,OAAO,kBAAkB;IAC7B,YAA2B,WAAwB,EAAE;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAI,CAAC;IACnD,UAAU,KAAkB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,WAAW,CAAC,GAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACvE,eAAe,CAAC,GAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC/E,QAAQ,CAAC,GAAe,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IACrE,uBAAuB,CAAC,GAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC1F,QAAQ,CAAC,GAAc,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;CAC5E;AACD,gBAAgB;AAChB,IAAK,cAeJ;AAfD,WAAK,cAAc;IACjB,yDAAW,CAAA;IACX,uDAAU,CAAA;IACV,+CAAM,CAAA;IACN,qDAAS,CAAA;IACT,yDAAW,CAAA;IACX,mDAAQ,CAAA;IACR,mDAAQ,CAAA;IACR,wDAAwD;IACxD,yDAAW,CAAA;IACX,wDAAwD;IACxD,yDAAW,CAAA;IACX,uDAAU,CAAA;IACV,oDAAS,CAAA;IACT,wDAAW,CAAA;AACb,CAAC,EAfI,cAAc,KAAd,cAAc,QAelB;AACD,cAAc;AACd,MAAM,OAAO,WAAW;IAAxB;QACU,UAAK,GAAG,EAAE,CAAC;IA4LrB,CAAC;IA3LS,MAAM,CAAC,WAA4B;QACzC,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;YACnC,IAAI,WAAW,GAAG,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;SAC9C;QACD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;YACnC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;aAC5E;SACF;IACH,CAAC;IACM,WAAW,CAAC,WAA4B,EAAE,GAAY;QAC3D,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE;gBACL,IAAI,EAAE,cAAc,CAAC,OAAO;gBAC5B,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,QAAQ,CAAC,WAA4B,EAAE,GAAe;QAC3D,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,KAAK,EAAE,MAAM;aACd;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,UAAU,CAAC,WAA4B,EAAE,GAAW;QACzD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,MAAM;gBAC3B,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,MAAM,CAAC,WAA4B,EAAE,GAAe;QACzD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,EAAE;gBACvB,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,SAAS,CAAC,WAA4B,EAAE,GAAwB;QACrE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,mBAAmB,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,KAAK;gBAC1B,KAAK,EAAE,iBAAiB,CAAC,eAAe,CAAC,mBAAmB,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;aAClF;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,OAAO,CAAC,WAA4B,EAAE,GAAW;QACtD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,OAAO;gBAC5B,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,UAAU,CAAC,WAA4B,EAAE,GAAW;QACzD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,MAAM;gBAC3B,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,QAAQ,CAAC,WAA4B,EAAE,GAAW;QACvD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,UAAU,CAAC,WAA4B,EAAE,GAAW;QACzD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,MAAM;gBAC3B,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,QAAQ,CAAC,WAA4B;QAC1C,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,KAAK,EAAE,IAAI;aACZ;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,WAAW,CAAC,WAA4B,EAAE,GAAY;QAC3D,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,OAAO;gBAC5B,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACM,WAAW,CAAC,WAA4B,EAAE,GAAY;QAC3D,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE;YACtC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACvB,IAAI,EAAE,cAAc,CAAC,OAAO;gBAC5B,KAAK,EAAE,GAAG;aACX;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACO,MAAM,CAAC,IAAI,CAAC,MAAmB,EAAE,QAAyB,EAAE,GAAQ;QAC1E,IAAI,OAAO,GAAG,KAAK,SAAS,EAAE;YAC5B,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SACnC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAClC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SAClC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAClC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SAClC;aAAM,IAAI,GAAG,YAAY,UAAU,EAAE;YACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SAChC;aAAM,IAAI,GAAG,YAAY,OAAO,EAAE;YACjC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SACnC;aAAM,IAAI,GAAG,YAAY,OAAO,EAAE;YACjC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SACnC;aAAM,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;YAC3G,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SACjC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACzD,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SAClC;aAAM,IAAI,OAAO,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE;YACrD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAC3B;aAAM;YACL,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;SACrC;IACH,CAAC;IACM,MAAM,CAAC,IAAI,CAAC,IAAgC;QACjD,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACjC,IAAI,OAAO,IAAI,KAAK,WAAW;YAC7B,OAAO,MAAM,CAAC;QAEhB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACvB,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;gBACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;aAC7B;SACF;aAAM;YACL,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE;gBACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAG,IAAY,CAAC,IAAI,CAAC,CAAC,CAAC;aAC9C;SACF;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACM,SAAS,KAAa,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;CAClD;AAED,gBAAgB;AAChB,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,qDAAU,CAAA;IACV,mDAAS,CAAA;AACX,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AACD,gBAAgB;AAChB,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,uDAA6B,CAAA;IAC7B,qDAA2B,CAAA;IAC3B,2DAAY,CAAA;AACd,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AACD,gBAAgB;AAChB,MAAM,CAAN,IAAY,gBAaX;AAbD,WAAY,gBAAgB;IAC1B,uDAAQ,CAAA;IACR,2DAAU,CAAA;IACV,6DAAW,CAAA;IACX,6DAAW,CAAA;IACX,iEAAa,CAAA;IACb,2DAAW,CAAA;IACX,qGAAsC,CAAA;IACtC,6FAAkC,CAAA;IAClC,uGAAuC,CAAA;IACvC,mGAAqC,CAAA;IACrC,+FAAmC,CAAA;IACnC,+FAAmC,CAAA;AACrC,CAAC,EAbW,gBAAgB,KAAhB,gBAAgB,QAa3B;AACD,gBAAgB;AAChB,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,6DAAc,CAAA;IACd,uDAAW,CAAA;AACb,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAmCD,cAAc;AACd,MAAM,OAAO,YAAa,SAAQ,YAAY;IAC5C,YAAmC,QAAa,EAAkB,OAAa,EAAE,EAAa;QAC5F,KAAK,CAAC,EAAE,aAAF,EAAE,cAAF,EAAE,GAAI,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAD5C,aAAQ,GAAR,QAAQ,CAAK;QAAkB,YAAO,GAAP,OAAO,CAAM;IAE/E,CAAC;IACM,MAAM,CAAC,YAAY,CAAC,QAAa,EAAE,OAAa;QACrD,IAAK,QAAQ,CAAC,MAAiB,IAAK,gBAAgB,CAAC,KAAgB,EAAE;YACrE,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;SAC3C;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,gBAAgB,CAAC,MAAM,EAAE;YAC/C,MAAM,IAAI,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;SACzE;IACH,CAAC;CACF","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 iModels\r\n */\r\nimport { BentleyError, CompressedId64Set, DbResult, Id64, Id64String, OrderedId64Iterable } from \"@itwin/core-bentley\";\r\nimport { Point2d, Point3d } from \"@itwin/core-geometry\";\r\n\r\n/**\r\n * Specifies the format of the rows returned by the `query` and `restartQuery` methods of\r\n * [IModelConnection]($frontend), [IModelDb]($backend), and [ECDb]($backend).\r\n *\r\n * @public\r\n * */\r\nexport enum QueryRowFormat {\r\n  /** Each row is an object in which each non-null column value can be accessed by its name as defined in the ECSql.\r\n   * Null values are omitted.\r\n   */\r\n  UseECSqlPropertyNames,\r\n  /** Each row is an array of values accessed by an index corresponding to the property's position in the ECSql SELECT statement.\r\n   * Null values are included if they are followed by a non-null column, but trailing null values at the end of the array are omitted.\r\n   */\r\n  UseECSqlPropertyIndexes,\r\n  /** Each row is an object in which each non-null column value can be accessed by a [remapped property name]($docs/learning/ECSqlRowFormat.md).\r\n   * This format is backwards-compatible with the format produced by iModel.js version 2.x. Null values are omitted.\r\n   */\r\n  UseJsPropertyNames,\r\n}\r\n/**\r\n * Specify limit or range of rows to return\r\n * @public\r\n * */\r\nexport interface QueryLimit {\r\n  /** Number of rows to return */\r\n  count?: number;\r\n  /** Offset from which to return rows */\r\n  offset?: number;\r\n}\r\n/** @beta */\r\nexport interface QueryPropertyMetaData {\r\n  className: string;\r\n  generated: boolean;\r\n  index: number;\r\n  jsonName: string;\r\n  name: string;\r\n  extendType: string;\r\n  typeName: string;\r\n}\r\n/** @beta */\r\nexport interface DbRuntimeStats {\r\n  cpuTime: number;\r\n  totalTime: number;\r\n  timeLimit: number;\r\n  memLimit: number;\r\n  memUsed: number;\r\n}\r\n/**\r\n * Quota hint for the query.\r\n * @public\r\n * */\r\nexport interface QueryQuota {\r\n  /** Max time allowed in seconds. This is hint and may not be honoured but help in prioritize request */\r\n  time?: number;\r\n  /** Max memory allowed in bytes. This is hint and may not be honoured but help in prioritize request */\r\n  memory?: number;\r\n}\r\n/**\r\n * Config for all request made to concurrent query engine.\r\n * @public\r\n * */\r\nexport interface BaseReaderOptions {\r\n  /** Determine priority of this query default to 0, used as hint and can be overriden by backend. */\r\n  priority?: number;\r\n  /** If specified cancel last query (if any) with same restart token and queue the new query */\r\n  restartToken?: string;\r\n  /** For editing apps this can be set to true and all query will run on primary connection\r\n  *  his may cause slow queries execution but the most recent data changes will be visitable via query\r\n  */\r\n  usePrimaryConn?: boolean;\r\n  /** Restrict time or memory for query but use as hint and may be changed base on backend settings */\r\n  quota?: QueryQuota;\r\n}\r\n/**\r\n * ECSql query config\r\n * @public\r\n * */\r\nexport interface QueryOptions extends BaseReaderOptions {\r\n  /**\r\n   * default to false. It abbreviate blobs to single bytes. This help cases where wildcard is\r\n   * used in select clause. Use BlobReader api to read individual blob specially if its of large size.\r\n   * */\r\n  abbreviateBlobs?: boolean;\r\n  /**\r\n   * default to false. It will suppress error and will not log it. Useful in cases where we expect query\r\n   * can fail.\r\n   */\r\n  suppressLogErrors?: boolean;\r\n  /** This is used internally. If true it query will return meta data about query. */\r\n  includeMetaData?: boolean;\r\n  /** Limit range of rows returned by query*/\r\n  limit?: QueryLimit;\r\n  /**\r\n   * Convert ECClassId, SourceECClassId, TargetECClassId and RelClassId to respective name.\r\n   * When true, XXXXClassId property will be returned as className.\r\n   * */\r\n  convertClassIdsToClassNames?: boolean;\r\n  /**\r\n   * Determine row format.\r\n   */\r\n  rowFormat?: QueryRowFormat;\r\n}\r\n/** @beta */\r\nexport type BlobRange = QueryLimit;\r\n\r\n/** @beta */\r\nexport interface BlobOptions extends BaseReaderOptions {\r\n  range?: BlobRange;\r\n}\r\n\r\n/** @public */\r\nexport class QueryOptionsBuilder {\r\n  public constructor(private _options: QueryOptions = {}) { }\r\n  public getOptions(): QueryOptions { return this._options; }\r\n  public setPriority(val: number) { this._options.priority = val; return this; }\r\n  public setRestartToken(val: string) { this._options.restartToken = val; return this; }\r\n  public setQuota(val: QueryQuota) { this._options.quota = val; return this; }\r\n  public setUsePrimaryConnection(val: boolean) { this._options.usePrimaryConn = val; return this; }\r\n  public setAbbreviateBlobs(val: boolean) { this._options.abbreviateBlobs = val; return this; }\r\n  public setSuppressLogErrors(val: boolean) { this._options.suppressLogErrors = val; return this; }\r\n  public setConvertClassIdsToNames(val: boolean) { this._options.convertClassIdsToClassNames = val; return this; }\r\n  public setLimit(val: QueryLimit) { this._options.limit = val; return this; }\r\n  public setRowFormat(val: QueryRowFormat){ this._options.rowFormat = val; return this; }\r\n}\r\n/** @beta */\r\nexport class BlobOptionsBuilder {\r\n  public constructor(private _options: BlobOptions = {}) { }\r\n  public getOptions(): BlobOptions { return this._options; }\r\n  public setPriority(val: number) { this._options.priority = val; return this; }\r\n  public setRestartToken(val: string) { this._options.restartToken = val; return this; }\r\n  public setQuota(val: QueryQuota) { this._options.quota = val; return this; }\r\n  public setUsePrimaryConnection(val: boolean) { this._options.usePrimaryConn = val; return this; }\r\n  public setRange(val: BlobRange) { this._options.range = val; return this; }\r\n}\r\n/** @internal */\r\nenum QueryParamType {\r\n  Boolean = 0,\r\n  Double = 1,\r\n  Id = 2,\r\n  IdSet = 3,\r\n  Integer = 4,\r\n  Long = 5,\r\n  Null = 6,\r\n  // eslint-disable-next-line @typescript-eslint/no-shadow\r\n  Point2d = 7,\r\n  // eslint-disable-next-line @typescript-eslint/no-shadow\r\n  Point3d = 8,\r\n  String = 9,\r\n  Blob = 10,\r\n  Struct = 11,\r\n}\r\n/** @public */\r\nexport class QueryBinder {\r\n  private _args = {};\r\n  private verify(indexOrName: string | number) {\r\n    if (typeof indexOrName === \"number\") {\r\n      if (indexOrName < 1)\r\n        throw new Error(\"expect index to be >= 1\");\r\n    }\r\n    if (typeof indexOrName === \"string\") {\r\n      if (!/^[a-zA-Z_]+\\w*$/i.test(indexOrName)) {\r\n        throw new Error(\"expect named parameter to meet identifier specification\");\r\n      }\r\n    }\r\n  }\r\n  public bindBoolean(indexOrName: string | number, val: boolean) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true,\r\n      value: {\r\n        type: QueryParamType.Boolean,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindBlob(indexOrName: string | number, val: Uint8Array) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    const base64 = Buffer.from(val).toString(\"base64\");\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Blob,\r\n        value: base64,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindDouble(indexOrName: string | number, val: number) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Double,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindId(indexOrName: string | number, val: Id64String) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Id,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindIdSet(indexOrName: string | number, val: OrderedId64Iterable) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    OrderedId64Iterable.uniqueIterator(val);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.IdSet,\r\n        value: CompressedId64Set.sortAndCompress(OrderedId64Iterable.uniqueIterator(val)),\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindInt(indexOrName: string | number, val: number) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Integer,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindStruct(indexOrName: string | number, val: object) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Struct,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindLong(indexOrName: string | number, val: number) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Long,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindString(indexOrName: string | number, val: string) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.String,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindNull(indexOrName: string | number) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Null,\r\n        value: null,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindPoint2d(indexOrName: string | number, val: Point2d) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Point2d,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindPoint3d(indexOrName: string | number, val: Point3d) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Point3d,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  private static bind(params: QueryBinder, nameOrId: string | number, val: any) {\r\n    if (typeof val === \"boolean\") {\r\n      params.bindBoolean(nameOrId, val);\r\n    } else if (typeof val === \"number\") {\r\n      params.bindDouble(nameOrId, val);\r\n    } else if (typeof val === \"string\") {\r\n      params.bindString(nameOrId, val);\r\n    } else if (val instanceof Uint8Array) {\r\n      params.bindBlob(nameOrId, val);\r\n    } else if (val instanceof Point2d) {\r\n      params.bindPoint2d(nameOrId, val);\r\n    } else if (val instanceof Point3d) {\r\n      params.bindPoint3d(nameOrId, val);\r\n    } else if (val instanceof Array && val.length > 0 && typeof val[0] === \"string\" && Id64.isValidId64(val[0])) {\r\n      params.bindIdSet(nameOrId, val);\r\n    } else if (typeof val === \"object\" && !Array.isArray(val)) {\r\n      params.bindStruct(nameOrId, val);\r\n    } else if (typeof val === \"undefined\" || val === null) {\r\n      params.bindNull(nameOrId);\r\n    } else {\r\n      throw new Error(\"unsupported type\");\r\n    }\r\n  }\r\n  public static from(args: any[] | object | undefined): QueryBinder {\r\n    const params = new QueryBinder();\r\n    if (typeof args === \"undefined\")\r\n      return params;\r\n\r\n    if (Array.isArray(args)) {\r\n      let i = 1;\r\n      for (const val of args) {\r\n        this.bind(params, i++, val);\r\n      }\r\n    } else {\r\n      for (const prop of Object.getOwnPropertyNames(args)) {\r\n        this.bind(params, prop, (args as any)[prop]);\r\n      }\r\n    }\r\n    return params;\r\n  }\r\n  public serialize(): object { return this._args; }\r\n}\r\n\r\n/** @internal */\r\nexport enum DbRequestKind {\r\n  BlobIO = 0,\r\n  ECSql = 1\r\n}\r\n/** @internal */\r\nexport enum DbResponseKind {\r\n  BlobIO = DbRequestKind.BlobIO,\r\n  ECSql = DbRequestKind.ECSql,\r\n  NoResult = 2\r\n}\r\n/** @internal */\r\nexport enum DbResponseStatus {\r\n  Done = 1,  /* query ran to completion. */\r\n  Cancel = 2, /*  Requested by user.*/\r\n  Partial = 3, /*  query was running but ran out of quota.*/\r\n  Timeout = 4, /*  query time quota expired while it was in queue.*/\r\n  QueueFull = 5, /*  could not submit the query as queue was full.*/\r\n  Error = 100, /*  generic error*/\r\n  Error_ECSql_PreparedFailed = Error + 1, /*  ecsql prepared failed*/\r\n  Error_ECSql_StepFailed = Error + 2, /*  ecsql step failed*/\r\n  Error_ECSql_RowToJsonFailed = Error + 3, /*  ecsql failed to serialized row to json.*/\r\n  Error_ECSql_BindingFailed = Error + 4, /*  ecsql binding failed.*/\r\n  Error_BlobIO_OpenFailed = Error + 5, /*  class or property or instance specified was not found or property as not of type blob.*/\r\n  Error_BlobIO_OutOfRange = Error + 6, /*  range specified is invalid based on size of blob.*/\r\n}\r\n/** @internal */\r\nexport enum DbValueFormat {\r\n  ECSqlNames = 0,\r\n  JsNames = 1\r\n}\r\n/** @internal */\r\nexport interface DbRequest extends BaseReaderOptions {\r\n  kind?: DbRequestKind;\r\n}\r\n/** @internal */\r\nexport interface DbQueryRequest extends DbRequest, QueryOptions {\r\n  valueFormat?: DbValueFormat;\r\n  query: string;\r\n  args?: object;\r\n}\r\n/** @internal */\r\nexport interface DbBlobRequest extends DbRequest, BlobOptions {\r\n  className: string;\r\n  accessString: string;\r\n  instanceId: Id64String;\r\n}\r\n/** @internal */\r\nexport interface DbResponse {\r\n  stats: DbRuntimeStats;\r\n  status: DbResponseStatus;\r\n  kind: DbResponseKind;\r\n  error?: string;\r\n}\r\n/** @internal */\r\nexport interface DbQueryResponse extends DbResponse {\r\n  meta: QueryPropertyMetaData[];\r\n  data: any[];\r\n  rowCount: number;\r\n}\r\n/** @internal */\r\nexport interface DbBlobResponse extends DbResponse {\r\n  data?: Uint8Array;\r\n  rawBlobSize: number;\r\n}\r\n/** @public */\r\nexport class DbQueryError extends BentleyError {\r\n  public constructor(public readonly response: any, public readonly request?: any, rc?: DbResult) {\r\n    super(rc ?? DbResult.BE_SQLITE_ERROR, response.error, { response, request });\r\n  }\r\n  public static throwIfError(response: any, request?: any) {\r\n    if ((response.status as number) >= (DbResponseStatus.Error as number)) {\r\n      throw new DbQueryError(response, request);\r\n    }\r\n    if (response.status === DbResponseStatus.Cancel) {\r\n      throw new DbQueryError(response, request, DbResult.BE_SQLITE_INTERRUPT);\r\n    }\r\n  }\r\n}\r\n/** @internal */\r\nexport interface DbRequestExecutor<TRequest extends DbRequest, TResponse extends DbResponse> {\r\n  execute(request: TRequest): Promise<TResponse>;\r\n}\r\n"]}
+{"version":3,"file":"ConcurrentQuery.js","sourceRoot":"","sources":["../../src/ConcurrentQuery.ts"],"names":[],"mappings":"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","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 iModels\r\n */\r\nimport { BentleyError, CompressedId64Set, DbResult, Id64, Id64String, OrderedId64Iterable } from \"@itwin/core-bentley\";\r\nimport { Point2d, Point3d } from \"@itwin/core-geometry\";\r\n\r\n/**\r\n * Specifies the format of the rows returned by the `query` and `restartQuery` methods of\r\n * [IModelConnection]($frontend), [IModelDb]($backend), and [ECDb]($backend).\r\n *\r\n * @public\r\n */\r\nexport enum QueryRowFormat {\r\n  /** Each row is an object in which each non-null column value can be accessed by its name as defined in the ECSql.\r\n   * Null values are omitted.\r\n   */\r\n  UseECSqlPropertyNames,\r\n  /** Each row is an array of values accessed by an index corresponding to the property's position in the ECSql SELECT statement.\r\n   * Null values are included if they are followed by a non-null column, but trailing null values at the end of the array are omitted.\r\n   */\r\n  UseECSqlPropertyIndexes,\r\n  /** Each row is an object in which each non-null column value can be accessed by a [remapped property name]($docs/learning/ECSqlRowFormat.md).\r\n   * This format is backwards-compatible with the format produced by iTwin.js 2.x. Null values are omitted.\r\n   */\r\n  UseJsPropertyNames,\r\n}\r\n/**\r\n * Specify limit or range of rows to return\r\n * @public\r\n * */\r\nexport interface QueryLimit {\r\n  /** Number of rows to return */\r\n  count?: number;\r\n  /** Offset from which to return rows */\r\n  offset?: number;\r\n}\r\n/** @beta */\r\nexport interface QueryPropertyMetaData {\r\n  className: string;\r\n  generated: boolean;\r\n  index: number;\r\n  jsonName: string;\r\n  name: string;\r\n  extendType: string;\r\n  typeName: string;\r\n}\r\n/** @beta */\r\nexport interface DbRuntimeStats {\r\n  cpuTime: number;\r\n  totalTime: number;\r\n  timeLimit: number;\r\n  memLimit: number;\r\n  memUsed: number;\r\n}\r\n/**\r\n * Quota hint for the query.\r\n * @public\r\n * */\r\nexport interface QueryQuota {\r\n  /** Max time allowed in seconds. This is hint and may not be honoured but help in prioritize request */\r\n  time?: number;\r\n  /** Max memory allowed in bytes. This is hint and may not be honoured but help in prioritize request */\r\n  memory?: number;\r\n}\r\n/**\r\n * Config for all request made to concurrent query engine.\r\n * @public\r\n * */\r\nexport interface BaseReaderOptions {\r\n  /** Determine priority of this query default to 0, used as hint and can be overriden by backend. */\r\n  priority?: number;\r\n  /** If specified cancel last query (if any) with same restart token and queue the new query */\r\n  restartToken?: string;\r\n  /** For editing apps this can be set to true and all query will run on primary connection\r\n  *  his may cause slow queries execution but the most recent data changes will be visitable via query\r\n  */\r\n  usePrimaryConn?: boolean;\r\n  /** Restrict time or memory for query but use as hint and may be changed base on backend settings */\r\n  quota?: QueryQuota;\r\n}\r\n/**\r\n * ECSql query config\r\n * @public\r\n * */\r\nexport interface QueryOptions extends BaseReaderOptions {\r\n  /**\r\n   * default to false. It abbreviate blobs to single bytes. This help cases where wildcard is\r\n   * used in select clause. Use BlobReader api to read individual blob specially if its of large size.\r\n   * */\r\n  abbreviateBlobs?: boolean;\r\n  /**\r\n   * default to false. It will suppress error and will not log it. Useful in cases where we expect query\r\n   * can fail.\r\n   */\r\n  suppressLogErrors?: boolean;\r\n  /** This is used internally. If true it query will return meta data about query. */\r\n  includeMetaData?: boolean;\r\n  /** Limit range of rows returned by query*/\r\n  limit?: QueryLimit;\r\n  /**\r\n   * Convert ECClassId, SourceECClassId, TargetECClassId and RelClassId to respective name.\r\n   * When true, XXXXClassId property will be returned as className.\r\n   * */\r\n  convertClassIdsToClassNames?: boolean;\r\n  /**\r\n   * Determine row format.\r\n   */\r\n  rowFormat?: QueryRowFormat;\r\n}\r\n/** @beta */\r\nexport type BlobRange = QueryLimit;\r\n\r\n/** @beta */\r\nexport interface BlobOptions extends BaseReaderOptions {\r\n  range?: BlobRange;\r\n}\r\n\r\n/** @public */\r\nexport class QueryOptionsBuilder {\r\n  public constructor(private _options: QueryOptions = {}) { }\r\n  public getOptions(): QueryOptions { return this._options; }\r\n  public setPriority(val: number) { this._options.priority = val; return this; }\r\n  public setRestartToken(val: string) { this._options.restartToken = val; return this; }\r\n  public setQuota(val: QueryQuota) { this._options.quota = val; return this; }\r\n  public setUsePrimaryConnection(val: boolean) { this._options.usePrimaryConn = val; return this; }\r\n  public setAbbreviateBlobs(val: boolean) { this._options.abbreviateBlobs = val; return this; }\r\n  public setSuppressLogErrors(val: boolean) { this._options.suppressLogErrors = val; return this; }\r\n  public setConvertClassIdsToNames(val: boolean) { this._options.convertClassIdsToClassNames = val; return this; }\r\n  public setLimit(val: QueryLimit) { this._options.limit = val; return this; }\r\n  public setRowFormat(val: QueryRowFormat){ this._options.rowFormat = val; return this; }\r\n}\r\n/** @beta */\r\nexport class BlobOptionsBuilder {\r\n  public constructor(private _options: BlobOptions = {}) { }\r\n  public getOptions(): BlobOptions { return this._options; }\r\n  public setPriority(val: number) { this._options.priority = val; return this; }\r\n  public setRestartToken(val: string) { this._options.restartToken = val; return this; }\r\n  public setQuota(val: QueryQuota) { this._options.quota = val; return this; }\r\n  public setUsePrimaryConnection(val: boolean) { this._options.usePrimaryConn = val; return this; }\r\n  public setRange(val: BlobRange) { this._options.range = val; return this; }\r\n}\r\n/** @internal */\r\nenum QueryParamType {\r\n  Boolean = 0,\r\n  Double = 1,\r\n  Id = 2,\r\n  IdSet = 3,\r\n  Integer = 4,\r\n  Long = 5,\r\n  Null = 6,\r\n  // eslint-disable-next-line @typescript-eslint/no-shadow\r\n  Point2d = 7,\r\n  // eslint-disable-next-line @typescript-eslint/no-shadow\r\n  Point3d = 8,\r\n  String = 9,\r\n  Blob = 10,\r\n  Struct = 11,\r\n}\r\n/** @public */\r\nexport class QueryBinder {\r\n  private _args = {};\r\n  private verify(indexOrName: string | number) {\r\n    if (typeof indexOrName === \"number\") {\r\n      if (indexOrName < 1)\r\n        throw new Error(\"expect index to be >= 1\");\r\n    }\r\n    if (typeof indexOrName === \"string\") {\r\n      if (!/^[a-zA-Z_]+\\w*$/i.test(indexOrName)) {\r\n        throw new Error(\"expect named parameter to meet identifier specification\");\r\n      }\r\n    }\r\n  }\r\n  public bindBoolean(indexOrName: string | number, val: boolean) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true,\r\n      value: {\r\n        type: QueryParamType.Boolean,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindBlob(indexOrName: string | number, val: Uint8Array) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    const base64 = Buffer.from(val).toString(\"base64\");\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Blob,\r\n        value: base64,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindDouble(indexOrName: string | number, val: number) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Double,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindId(indexOrName: string | number, val: Id64String) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Id,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindIdSet(indexOrName: string | number, val: OrderedId64Iterable) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    OrderedId64Iterable.uniqueIterator(val);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.IdSet,\r\n        value: CompressedId64Set.sortAndCompress(OrderedId64Iterable.uniqueIterator(val)),\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindInt(indexOrName: string | number, val: number) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Integer,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindStruct(indexOrName: string | number, val: object) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Struct,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindLong(indexOrName: string | number, val: number) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Long,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindString(indexOrName: string | number, val: string) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.String,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindNull(indexOrName: string | number) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Null,\r\n        value: null,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindPoint2d(indexOrName: string | number, val: Point2d) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Point2d,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  public bindPoint3d(indexOrName: string | number, val: Point3d) {\r\n    this.verify(indexOrName);\r\n    const name = String(indexOrName);\r\n    Object.defineProperty(this._args, name, {\r\n      enumerable: true, value: {\r\n        type: QueryParamType.Point3d,\r\n        value: val,\r\n      },\r\n    });\r\n    return this;\r\n  }\r\n  private static bind(params: QueryBinder, nameOrId: string | number, val: any) {\r\n    if (typeof val === \"boolean\") {\r\n      params.bindBoolean(nameOrId, val);\r\n    } else if (typeof val === \"number\") {\r\n      params.bindDouble(nameOrId, val);\r\n    } else if (typeof val === \"string\") {\r\n      params.bindString(nameOrId, val);\r\n    } else if (val instanceof Uint8Array) {\r\n      params.bindBlob(nameOrId, val);\r\n    } else if (val instanceof Point2d) {\r\n      params.bindPoint2d(nameOrId, val);\r\n    } else if (val instanceof Point3d) {\r\n      params.bindPoint3d(nameOrId, val);\r\n    } else if (val instanceof Array && val.length > 0 && typeof val[0] === \"string\" && Id64.isValidId64(val[0])) {\r\n      params.bindIdSet(nameOrId, val);\r\n    } else if (typeof val === \"object\" && !Array.isArray(val)) {\r\n      params.bindStruct(nameOrId, val);\r\n    } else if (typeof val === \"undefined\" || val === null) {\r\n      params.bindNull(nameOrId);\r\n    } else {\r\n      throw new Error(\"unsupported type\");\r\n    }\r\n  }\r\n  public static from(args: any[] | object | undefined): QueryBinder {\r\n    const params = new QueryBinder();\r\n    if (typeof args === \"undefined\")\r\n      return params;\r\n\r\n    if (Array.isArray(args)) {\r\n      let i = 1;\r\n      for (const val of args) {\r\n        this.bind(params, i++, val);\r\n      }\r\n    } else {\r\n      for (const prop of Object.getOwnPropertyNames(args)) {\r\n        this.bind(params, prop, (args as any)[prop]);\r\n      }\r\n    }\r\n    return params;\r\n  }\r\n  public serialize(): object { return this._args; }\r\n}\r\n\r\n/** @internal */\r\nexport enum DbRequestKind {\r\n  BlobIO = 0,\r\n  ECSql = 1\r\n}\r\n/** @internal */\r\nexport enum DbResponseKind {\r\n  BlobIO = DbRequestKind.BlobIO,\r\n  ECSql = DbRequestKind.ECSql,\r\n  NoResult = 2\r\n}\r\n/** @internal */\r\nexport enum DbResponseStatus {\r\n  Done = 1,  /* query ran to completion. */\r\n  Cancel = 2, /*  Requested by user.*/\r\n  Partial = 3, /*  query was running but ran out of quota.*/\r\n  Timeout = 4, /*  query time quota expired while it was in queue.*/\r\n  QueueFull = 5, /*  could not submit the query as queue was full.*/\r\n  Error = 100, /*  generic error*/\r\n  Error_ECSql_PreparedFailed = Error + 1, /*  ecsql prepared failed*/\r\n  Error_ECSql_StepFailed = Error + 2, /*  ecsql step failed*/\r\n  Error_ECSql_RowToJsonFailed = Error + 3, /*  ecsql failed to serialized row to json.*/\r\n  Error_ECSql_BindingFailed = Error + 4, /*  ecsql binding failed.*/\r\n  Error_BlobIO_OpenFailed = Error + 5, /*  class or property or instance specified was not found or property as not of type blob.*/\r\n  Error_BlobIO_OutOfRange = Error + 6, /*  range specified is invalid based on size of blob.*/\r\n}\r\n/** @internal */\r\nexport enum DbValueFormat {\r\n  ECSqlNames = 0,\r\n  JsNames = 1\r\n}\r\n/** @internal */\r\nexport interface DbRequest extends BaseReaderOptions {\r\n  kind?: DbRequestKind;\r\n}\r\n/** @internal */\r\nexport interface DbQueryRequest extends DbRequest, QueryOptions {\r\n  valueFormat?: DbValueFormat;\r\n  query: string;\r\n  args?: object;\r\n}\r\n/** @internal */\r\nexport interface DbBlobRequest extends DbRequest, BlobOptions {\r\n  className: string;\r\n  accessString: string;\r\n  instanceId: Id64String;\r\n}\r\n/** @internal */\r\nexport interface DbResponse {\r\n  stats: DbRuntimeStats;\r\n  status: DbResponseStatus;\r\n  kind: DbResponseKind;\r\n  error?: string;\r\n}\r\n/** @internal */\r\nexport interface DbQueryResponse extends DbResponse {\r\n  meta: QueryPropertyMetaData[];\r\n  data: any[];\r\n  rowCount: number;\r\n}\r\n/** @internal */\r\nexport interface DbBlobResponse extends DbResponse {\r\n  data?: Uint8Array;\r\n  rawBlobSize: number;\r\n}\r\n/** @public */\r\nexport class DbQueryError extends BentleyError {\r\n  public constructor(public readonly response: any, public readonly request?: any, rc?: DbResult) {\r\n    super(rc ?? DbResult.BE_SQLITE_ERROR, response.error, { response, request });\r\n  }\r\n  public static throwIfError(response: any, request?: any) {\r\n    if ((response.status as number) >= (DbResponseStatus.Error as number)) {\r\n      throw new DbQueryError(response, request);\r\n    }\r\n    if (response.status === DbResponseStatus.Cancel) {\r\n      throw new DbQueryError(response, request, DbResult.BE_SQLITE_INTERRUPT);\r\n    }\r\n  }\r\n}\r\n/** @internal */\r\nexport interface DbRequestExecutor<TRequest extends DbRequest, TResponse extends DbResponse> {\r\n  execute(request: TRequest): Promise<TResponse>;\r\n}\r\n"]}

package/lib/esm/ECSqlTypes.d.ts

@@ -94,12 +94,12 @@ export declare enum ECSqlSystemProperty {
     PointY = 9,
     PointZ = 10
 }
-/** Utility to format ECProperty names according to the iModel.js formatting rules.
+/** Utility to format ECProperty names according to the iTwin.js formatting rules.
  * See also [ECSQL Row Format]($docs/learning/ECSQLRowFormat).
  * @public
  */
 export declare class ECJsNames {
-    /** Formats the specified ECProperty name according to the iModel.js formatting rules.
+    /** Formats the specified ECProperty name according to the iTwin.js formatting rules.
      *
      *  See [ECSQL Row Format]($docs/learning/ECSQLRowFormat) which describes the formatting rules.
      *
@@ -112,7 +112,7 @@ export declare class ECJsNames {
      */
     static toJsName(propName: string, isSystemProperty?: boolean): string;
     /** Returns the name of the specified ECSQL system property according to the
-     *  iModel.js formatting rules.
+     *  iTwin.js formatting rules.
      *
      *  See [ECSQL Row Format]($docs/learning/ECSQLRowFormat) which describes the formatting rules.
      * @param systemPropertyType System property type

package/lib/esm/ECSqlTypes.js

@@ -77,12 +77,12 @@ export var ECSqlSystemProperty;
     ECSqlSystemProperty[ECSqlSystemProperty["PointY"] = 9] = "PointY";
     ECSqlSystemProperty[ECSqlSystemProperty["PointZ"] = 10] = "PointZ";
 })(ECSqlSystemProperty || (ECSqlSystemProperty = {}));
-/** Utility to format ECProperty names according to the iModel.js formatting rules.
+/** Utility to format ECProperty names according to the iTwin.js formatting rules.
  * See also [ECSQL Row Format]($docs/learning/ECSQLRowFormat).
  * @public
  */
 export class ECJsNames {
-    /** Formats the specified ECProperty name according to the iModel.js formatting rules.
+    /** Formats the specified ECProperty name according to the iTwin.js formatting rules.
      *
      *  See [ECSQL Row Format]($docs/learning/ECSQLRowFormat) which describes the formatting rules.
      *
@@ -145,7 +145,7 @@ export class ECJsNames {
         return jsName;
     }
     /** Returns the name of the specified ECSQL system property according to the
-     *  iModel.js formatting rules.
+     *  iTwin.js formatting rules.
      *
      *  See [ECSQL Row Format]($docs/learning/ECSQLRowFormat) which describes the formatting rules.
      * @param systemPropertyType System property type

package/lib/esm/ECSqlTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"ECSqlTypes.js","sourceRoot":"","sources":["../../src/ECSqlTypes.ts"],"names":[],"mappings":"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","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 ECSQL\r\n */\r\n\r\nimport { assert, Id64String } from \"@itwin/core-bentley\";\r\n\r\n/** Describes the different data types an ECSQL value can be of.\r\n * See also [ECSQL]($docs/learning/ECSQL).\r\n * @public\r\n */\r\nexport enum ECSqlValueType {\r\n  // do not change the values of the enum as it must match its counterpart in the addon\r\n  Blob = 1,\r\n  Boolean = 2,\r\n  DateTime = 3,\r\n  Double = 4,\r\n  Geometry = 5,\r\n  Id = 6,\r\n  Int = 7,\r\n  Int64 = 8,\r\n  Point2d = 9,\r\n  Point3d = 10,\r\n  String = 11,\r\n  Navigation = 12,\r\n  Struct = 13,\r\n  PrimitiveArray = 14,\r\n  StructArray = 15,\r\n  Guid = 16,\r\n}\r\n\r\n/** An ECSQL Navigation value.\r\n * It is returned from ECSQL SELECT statements for navigation properties.\r\n * See also [ECSQL]($docs/learning/ECSQL).\r\n * @public\r\n */\r\nexport interface NavigationValue {\r\n  /** ECInstanceId of the related instance */\r\n  id: Id64String;\r\n  /** Fully qualified class name of the relationship backing the Navigation property */\r\n  relClassName?: string;\r\n}\r\n\r\n/** An ECSQL Navigation value which can be bound to a navigation property ECSQL parameter\r\n * See also [ECSQL]($docs/learning/ECSQL).\r\n * @public\r\n */\r\nexport interface NavigationBindingValue {\r\n  /** ECInstanceId of the related instance */\r\n  id: Id64String;\r\n  /** Fully qualified class name of the relationship backing the Navigation property */\r\n  relClassName?: string;\r\n  /** Table space where the relationship's schema is persisted. This is only required\r\n   * if other ECDb files are attached to the primary one. In case a schema exists in more than one of the files,\r\n   * pass the table space to disambiguate.\r\n   */\r\n  relClassTableSpace?: string;\r\n}\r\n\r\n/** Equivalent of the ECEnumeration OpCode in the **ECDbChange** ECSchema.\r\n * The enum can be used when programmatically binding values to the InstanceChange.OpCode property of\r\n * the ECDbChange ECSchema.\r\n *\r\n * See also\r\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\r\n * @public\r\n */\r\nexport enum ChangeOpCode {\r\n  Insert = 1,\r\n  Update = 2,\r\n  Delete = 4,\r\n}\r\n\r\n/** The enum represents the values for the ChangedValueState argument of the ECSQL function **Changes**.\r\n * The enum can be used when programmatically binding values to the ChangedValueState argument\r\n * in an ECSQL using the **Changes** ECSQL function.\r\n *\r\n * See also\r\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\r\n * @public\r\n */\r\nexport enum ChangedValueState {\r\n  AfterInsert = 1,\r\n  BeforeUpdate = 2,\r\n  AfterUpdate = 3,\r\n  BeforeDelete = 4,\r\n}\r\n\r\n/** Defines the ECSQL system properties.\r\n * See also [ECSQL]($docs/learning/ECSQL).\r\n * @public\r\n */\r\nexport enum ECSqlSystemProperty {\r\n  ECInstanceId,\r\n  ECClassId,\r\n  SourceECInstanceId,\r\n  SourceECClassId,\r\n  TargetECInstanceId,\r\n  TargetECClassId,\r\n  NavigationId,\r\n  NavigationRelClassId,\r\n  PointX,\r\n  PointY,\r\n  PointZ,\r\n}\r\n\r\n/** Utility to format ECProperty names according to the iModel.js formatting rules.\r\n * See also [ECSQL Row Format]($docs/learning/ECSQLRowFormat).\r\n * @public\r\n */\r\nexport class ECJsNames {\r\n\r\n  /** Formats the specified ECProperty name according to the iModel.js formatting rules.\r\n   *\r\n   *  See [ECSQL Row Format]($docs/learning/ECSQLRowFormat) which describes the formatting rules.\r\n   *\r\n   * @param ecProperty Property name as defined in the ECSchema for regular ECProperties\r\n   *        or the name of an ECSQL system properties\r\n   * @param isSystemProperty if omitted, the method will try to find out whether the given property\r\n   *        is a system property or not. If true is specified, the method will throw if the property name\r\n   *        is not a known system property. If false is specified, the method will not attempt to recognize\r\n   *        the property name as system property.\r\n   */\r\n  public static toJsName(propName: string, isSystemProperty?: boolean) {\r\n    assert(propName !== undefined, \"propName must not be undefined\");\r\n\r\n    const propTypeUnknown: boolean = isSystemProperty === undefined || isSystemProperty === null;\r\n\r\n    const accessStringTokens: string[] = propName.split(\".\");\r\n    const tokenCount: number = accessStringTokens.length;\r\n    assert(tokenCount > 0);\r\n\r\n    if (tokenCount === 1) {\r\n      if (propTypeUnknown || isSystemProperty!) {\r\n        if (propName === \"ECInstanceId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.ECInstanceId);\r\n\r\n        if (propName === \"ECClassId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.ECClassId);\r\n\r\n        if (propName === \"SourceECInstanceId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.SourceECInstanceId);\r\n\r\n        if (propName === \"TargetECInstanceId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.TargetECInstanceId);\r\n\r\n        if (propName === \"SourceECClassId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.SourceECClassId);\r\n\r\n        if (propName === \"TargetECClassId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.TargetECClassId);\r\n\r\n        return ECJsNames.lowerFirstChar(propName);\r\n      }\r\n\r\n      return ECJsNames.lowerFirstChar(propName);\r\n    }\r\n\r\n    // parse access string and convert the leaf tokens if they are system props\r\n    // The first char of the access string is lowered.\r\n    let jsName: string = ECJsNames.lowerFirstChar(`${accessStringTokens[0]}.`);\r\n    for (let j = 1; j < tokenCount - 1; j++) {\r\n      jsName += `${accessStringTokens[j]}.`;\r\n    }\r\n\r\n    const leafToken: string = accessStringTokens[tokenCount - 1];\r\n\r\n    if (propTypeUnknown || isSystemProperty!) {\r\n      if (leafToken === \"Id\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.NavigationId);\r\n      else if (leafToken === \"RelECClassId\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.NavigationRelClassId);\r\n      else if (leafToken === \"X\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.PointX);\r\n      else if (leafToken === \"Y\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.PointY);\r\n      else if (leafToken === \"Z\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.PointZ);\r\n      else if (propTypeUnknown)\r\n        jsName += ECJsNames.lowerFirstChar(leafToken);\r\n      else\r\n        throw new Error(`Property ${leafToken} of access string ${propName} is no ECSQL system property.`);\r\n    } else\r\n      jsName += leafToken;\r\n\r\n    return jsName;\r\n  }\r\n\r\n  /** Returns the name of the specified ECSQL system property according to the\r\n   *  iModel.js formatting rules.\r\n   *\r\n   *  See [ECSQL Row Format]($docs/learning/ECSQLRowFormat) which describes the formatting rules.\r\n   * @param systemPropertyType System property type\r\n   */\r\n  public static systemPropertyToJsName(systemPropertyType: ECSqlSystemProperty): string {\r\n    switch (systemPropertyType) {\r\n      case ECSqlSystemProperty.ECInstanceId:\r\n      case ECSqlSystemProperty.NavigationId:\r\n        return \"id\";\r\n      case ECSqlSystemProperty.ECClassId:\r\n        return \"className\";\r\n      case ECSqlSystemProperty.SourceECInstanceId:\r\n        return \"sourceId\";\r\n      case ECSqlSystemProperty.SourceECClassId:\r\n        return \"sourceClassName\";\r\n      case ECSqlSystemProperty.TargetECInstanceId:\r\n        return \"targetId\";\r\n      case ECSqlSystemProperty.TargetECClassId:\r\n        return \"targetClassName\";\r\n      case ECSqlSystemProperty.NavigationRelClassId:\r\n        return \"relClassName\";\r\n      case ECSqlSystemProperty.PointX:\r\n        return \"x\";\r\n      case ECSqlSystemProperty.PointY:\r\n        return \"y\";\r\n      case ECSqlSystemProperty.PointZ:\r\n        return \"z\";\r\n      default:\r\n        throw new Error(`Unknown ECSqlSystemProperty enum value ${systemPropertyType}.`);\r\n    }\r\n  }\r\n\r\n  private static lowerFirstChar(name: string): string { return name[0].toLowerCase() + name.substring(1); }\r\n}\r\n"]}
+{"version":3,"file":"ECSqlTypes.js","sourceRoot":"","sources":["../../src/ECSqlTypes.ts"],"names":[],"mappings":"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","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 ECSQL\r\n */\r\n\r\nimport { assert, Id64String } from \"@itwin/core-bentley\";\r\n\r\n/** Describes the different data types an ECSQL value can be of.\r\n * See also [ECSQL]($docs/learning/ECSQL).\r\n * @public\r\n */\r\nexport enum ECSqlValueType {\r\n  // do not change the values of the enum as it must match its counterpart in the addon\r\n  Blob = 1,\r\n  Boolean = 2,\r\n  DateTime = 3,\r\n  Double = 4,\r\n  Geometry = 5,\r\n  Id = 6,\r\n  Int = 7,\r\n  Int64 = 8,\r\n  Point2d = 9,\r\n  Point3d = 10,\r\n  String = 11,\r\n  Navigation = 12,\r\n  Struct = 13,\r\n  PrimitiveArray = 14,\r\n  StructArray = 15,\r\n  Guid = 16,\r\n}\r\n\r\n/** An ECSQL Navigation value.\r\n * It is returned from ECSQL SELECT statements for navigation properties.\r\n * See also [ECSQL]($docs/learning/ECSQL).\r\n * @public\r\n */\r\nexport interface NavigationValue {\r\n  /** ECInstanceId of the related instance */\r\n  id: Id64String;\r\n  /** Fully qualified class name of the relationship backing the Navigation property */\r\n  relClassName?: string;\r\n}\r\n\r\n/** An ECSQL Navigation value which can be bound to a navigation property ECSQL parameter\r\n * See also [ECSQL]($docs/learning/ECSQL).\r\n * @public\r\n */\r\nexport interface NavigationBindingValue {\r\n  /** ECInstanceId of the related instance */\r\n  id: Id64String;\r\n  /** Fully qualified class name of the relationship backing the Navigation property */\r\n  relClassName?: string;\r\n  /** Table space where the relationship's schema is persisted. This is only required\r\n   * if other ECDb files are attached to the primary one. In case a schema exists in more than one of the files,\r\n   * pass the table space to disambiguate.\r\n   */\r\n  relClassTableSpace?: string;\r\n}\r\n\r\n/** Equivalent of the ECEnumeration OpCode in the **ECDbChange** ECSchema.\r\n * The enum can be used when programmatically binding values to the InstanceChange.OpCode property of\r\n * the ECDbChange ECSchema.\r\n *\r\n * See also\r\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\r\n * @public\r\n */\r\nexport enum ChangeOpCode {\r\n  Insert = 1,\r\n  Update = 2,\r\n  Delete = 4,\r\n}\r\n\r\n/** The enum represents the values for the ChangedValueState argument of the ECSQL function **Changes**.\r\n * The enum can be used when programmatically binding values to the ChangedValueState argument\r\n * in an ECSQL using the **Changes** ECSQL function.\r\n *\r\n * See also\r\n * - [ChangeSummary Overview]($docs/learning/ChangeSummaries)\r\n * @public\r\n */\r\nexport enum ChangedValueState {\r\n  AfterInsert = 1,\r\n  BeforeUpdate = 2,\r\n  AfterUpdate = 3,\r\n  BeforeDelete = 4,\r\n}\r\n\r\n/** Defines the ECSQL system properties.\r\n * See also [ECSQL]($docs/learning/ECSQL).\r\n * @public\r\n */\r\nexport enum ECSqlSystemProperty {\r\n  ECInstanceId,\r\n  ECClassId,\r\n  SourceECInstanceId,\r\n  SourceECClassId,\r\n  TargetECInstanceId,\r\n  TargetECClassId,\r\n  NavigationId,\r\n  NavigationRelClassId,\r\n  PointX,\r\n  PointY,\r\n  PointZ,\r\n}\r\n\r\n/** Utility to format ECProperty names according to the iTwin.js formatting rules.\r\n * See also [ECSQL Row Format]($docs/learning/ECSQLRowFormat).\r\n * @public\r\n */\r\nexport class ECJsNames {\r\n\r\n  /** Formats the specified ECProperty name according to the iTwin.js formatting rules.\r\n   *\r\n   *  See [ECSQL Row Format]($docs/learning/ECSQLRowFormat) which describes the formatting rules.\r\n   *\r\n   * @param ecProperty Property name as defined in the ECSchema for regular ECProperties\r\n   *        or the name of an ECSQL system properties\r\n   * @param isSystemProperty if omitted, the method will try to find out whether the given property\r\n   *        is a system property or not. If true is specified, the method will throw if the property name\r\n   *        is not a known system property. If false is specified, the method will not attempt to recognize\r\n   *        the property name as system property.\r\n   */\r\n  public static toJsName(propName: string, isSystemProperty?: boolean) {\r\n    assert(propName !== undefined, \"propName must not be undefined\");\r\n\r\n    const propTypeUnknown: boolean = isSystemProperty === undefined || isSystemProperty === null;\r\n\r\n    const accessStringTokens: string[] = propName.split(\".\");\r\n    const tokenCount: number = accessStringTokens.length;\r\n    assert(tokenCount > 0);\r\n\r\n    if (tokenCount === 1) {\r\n      if (propTypeUnknown || isSystemProperty!) {\r\n        if (propName === \"ECInstanceId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.ECInstanceId);\r\n\r\n        if (propName === \"ECClassId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.ECClassId);\r\n\r\n        if (propName === \"SourceECInstanceId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.SourceECInstanceId);\r\n\r\n        if (propName === \"TargetECInstanceId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.TargetECInstanceId);\r\n\r\n        if (propName === \"SourceECClassId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.SourceECClassId);\r\n\r\n        if (propName === \"TargetECClassId\")\r\n          return ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.TargetECClassId);\r\n\r\n        return ECJsNames.lowerFirstChar(propName);\r\n      }\r\n\r\n      return ECJsNames.lowerFirstChar(propName);\r\n    }\r\n\r\n    // parse access string and convert the leaf tokens if they are system props\r\n    // The first char of the access string is lowered.\r\n    let jsName: string = ECJsNames.lowerFirstChar(`${accessStringTokens[0]}.`);\r\n    for (let j = 1; j < tokenCount - 1; j++) {\r\n      jsName += `${accessStringTokens[j]}.`;\r\n    }\r\n\r\n    const leafToken: string = accessStringTokens[tokenCount - 1];\r\n\r\n    if (propTypeUnknown || isSystemProperty!) {\r\n      if (leafToken === \"Id\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.NavigationId);\r\n      else if (leafToken === \"RelECClassId\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.NavigationRelClassId);\r\n      else if (leafToken === \"X\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.PointX);\r\n      else if (leafToken === \"Y\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.PointY);\r\n      else if (leafToken === \"Z\")\r\n        jsName += ECJsNames.systemPropertyToJsName(ECSqlSystemProperty.PointZ);\r\n      else if (propTypeUnknown)\r\n        jsName += ECJsNames.lowerFirstChar(leafToken);\r\n      else\r\n        throw new Error(`Property ${leafToken} of access string ${propName} is no ECSQL system property.`);\r\n    } else\r\n      jsName += leafToken;\r\n\r\n    return jsName;\r\n  }\r\n\r\n  /** Returns the name of the specified ECSQL system property according to the\r\n   *  iTwin.js formatting rules.\r\n   *\r\n   *  See [ECSQL Row Format]($docs/learning/ECSQLRowFormat) which describes the formatting rules.\r\n   * @param systemPropertyType System property type\r\n   */\r\n  public static systemPropertyToJsName(systemPropertyType: ECSqlSystemProperty): string {\r\n    switch (systemPropertyType) {\r\n      case ECSqlSystemProperty.ECInstanceId:\r\n      case ECSqlSystemProperty.NavigationId:\r\n        return \"id\";\r\n      case ECSqlSystemProperty.ECClassId:\r\n        return \"className\";\r\n      case ECSqlSystemProperty.SourceECInstanceId:\r\n        return \"sourceId\";\r\n      case ECSqlSystemProperty.SourceECClassId:\r\n        return \"sourceClassName\";\r\n      case ECSqlSystemProperty.TargetECInstanceId:\r\n        return \"targetId\";\r\n      case ECSqlSystemProperty.TargetECClassId:\r\n        return \"targetClassName\";\r\n      case ECSqlSystemProperty.NavigationRelClassId:\r\n        return \"relClassName\";\r\n      case ECSqlSystemProperty.PointX:\r\n        return \"x\";\r\n      case ECSqlSystemProperty.PointY:\r\n        return \"y\";\r\n      case ECSqlSystemProperty.PointZ:\r\n        return \"z\";\r\n      default:\r\n        throw new Error(`Unknown ECSqlSystemProperty enum value ${systemPropertyType}.`);\r\n    }\r\n  }\r\n\r\n  private static lowerFirstChar(name: string): string { return name[0].toLowerCase() + name.substring(1); }\r\n}\r\n"]}

package/lib/esm/GeoCoordinateServices.d.ts

@@ -3,6 +3,7 @@
  */
 import { GeoServiceStatus } from "@itwin/core-bentley";
 import { XYZProps } from "@itwin/core-geometry";
+import { GeographicCRSProps } from "./geometry/CoordinateReferenceSystem";
 /** This enumeration lists all possible status as returned from a coordinate conversion to or from a
  * [[GeographicCRS]] and either another [[GeographicCRS]] or a [[GeodeticDatum]].
  * @see the [[PointWithStatus]] included in an [[IModelCoordinatesResponseProps]] or [[GeoCoordinatesResponseProps]].
@@ -88,4 +89,31 @@ export interface GeoCoordinatesResponseProps {
     geoCoords: PointWithStatus[];
     fromCache: number;
 }
+/** Information required to interpret or complete a Geographic CRS in the specified format.
+ *  The only currently supported formats are JSON (for completion) and WKT (OGC Well Known Text)
+ * @beta
+ */
+export interface GeographicCRSInterpretRequestProps {
+    /** The format of the geographic CRS definition provided in the geographicCRSDef property. */
+    format: "WKT" | "JSON";
+    /** The geographic CRS definition in the format specified in the format property.
+     *  Note that when the WKT is used the WKT fragment provided can start with a COMPD_CS clause
+     *  which should then contain both the horizontal CRS definition as well as the vertical CRS specification.
+     *  WKT fragments starting with PROJCS or GEOGCS are also supported but the vertical CRS will be assigned a
+     *  default value.
+    */
+    geographicCRSDef: string;
+}
+/** Information returned from a request to interpret or complete a Geographic CRS
+ * @beta
+ */
+export interface GeographicCRSInterpretResponseProps {
+    /** The result status of the interpret operation. A value of zero indicates successful interpretation.
+     *  Any value other than zero is to be considered a hard error and no valid result will
+     *  be returned in the geographicCRS property.
+    */
+    status: number;
+    /** The property that receives the interpreted geographic CRS if the process was successful. */
+    geographicCRS?: GeographicCRSProps;
+}
 //# sourceMappingURL=GeoCoordinateServices.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GeoCoordinateServices.d.ts","sourceRoot":"","sources":["../../src/GeoCoordinateServices.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD;;;;GAIG;AACH,oBAAY,cAAc;IACxB,kDAAkD;IAClD,OAAO,IAAI;IACX,sIAAsI;IACtI,YAAY,MAAM;IAClB;;;;;;;;;;OAUG;IACH,gBAAgB,IAAI;IACpB;;;;OAIG;IACH,uBAAuB,IAAI;IAC3B;;;;OAIG;IACH,gBAAgB,KAAK;IACrB;;;;OAIG;IACH,yBAAyB,KAAK;IAC9B,sGAAsG;IACtG,UAAU,OAAO;IACjB;;;OAGG;IACH,OAAO,SAAS;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAazE;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,QAAQ,CAAC;IACZ,CAAC,EAAE,cAAc,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,QAAQ,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"GeoCoordinateServices.d.ts","sourceRoot":"","sources":["../../src/GeoCoordinateServices.ts"],"names":[],"mappings":"AAIA;;GAEG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE1E;;;;GAIG;AACH,oBAAY,cAAc;IACxB,kDAAkD;IAClD,OAAO,IAAI;IACX,sIAAsI;IACtI,YAAY,MAAM;IAClB;;;;;;;;;;OAUG;IACH,gBAAgB,IAAI;IACpB;;;;OAIG;IACH,uBAAuB,IAAI;IAC3B;;;;OAIG;IACH,gBAAgB,KAAK;IACrB;;;;OAIG;IACH,yBAAyB,KAAK;IAC9B,sGAAsG;IACtG,UAAU,OAAO;IACjB;;;OAGG;IACH,OAAO,SAAS;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,cAAc,GAAG,gBAAgB,CAazE;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,QAAQ,CAAC;IACZ,CAAC,EAAE,cAAc,CAAC;CACnB;AAED,YAAY;AACZ,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,QAAQ,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kCAAkC;IACjD,6FAA6F;IAC7F,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB;;;;;MAKE;IACF,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD;;;MAGE;IACF,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC"}

package/lib/esm/GeoCoordinateServices.js

@@ -5,6 +5,7 @@
 /** @packageDocumentation
  * @module iModels
  */
+// cspell:ignore NGVD, NAVD, COMPD_CS, PROJCS, GEOGCS
 import { GeoServiceStatus } from "@itwin/core-bentley";
 /** This enumeration lists all possible status as returned from a coordinate conversion to or from a
  * [[GeographicCRS]] and either another [[GeographicCRS]] or a [[GeodeticDatum]].

package/lib/esm/GeoCoordinateServices.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeoCoordinateServices.js","sourceRoot":"","sources":["../../src/GeoCoordinateServices.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD;;;;GAIG;AACH,MAAM,CAAN,IAAY,cA0CX;AA1CD,WAAY,cAAc;IACxB,kDAAkD;IAClD,yDAAW,CAAA;IACX,sIAAsI;IACtI,qEAAkB,CAAA;IAClB;;;;;;;;;;OAUG;IACH,2EAAoB,CAAA;IACpB;;;;OAIG;IACH,yFAA2B,CAAA;IAC3B;;;;OAIG;IACH,4EAAqB,CAAA;IACrB;;;;OAIG;IACH,8FAA8B,CAAA;IAC9B,sGAAsG;IACtG,kEAAiB,CAAA;IACjB;;;OAGG;IACH,8DAAgB,CAAA;AAClB,CAAC,EA1CW,cAAc,KAAd,cAAc,QA0CzB;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAiB;IACrD,QAAQ,CAAC,EAAE;QACT,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC;QAC7D,KAAK,cAAc,CAAC,YAAY,CAAC,CAAC,OAAO,gBAAgB,CAAC,aAAa,CAAC;QACxE,KAAK,cAAc,CAAC,gBAAgB,CAAC,CAAC,OAAO,gBAAgB,CAAC,gBAAgB,CAAC;QAC/E,KAAK,cAAc,CAAC,uBAAuB,CAAC,CAAC,OAAO,gBAAgB,CAAC,uBAAuB,CAAC;QAC7F,KAAK,cAAc,CAAC,gBAAgB,CAAC,CAAC,OAAO,gBAAgB,CAAC,gBAAgB,CAAC;QAC/E,KAAK,cAAc,CAAC,yBAAyB,CAAC,CAAC,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QACjG,KAAK,cAAc,CAAC,UAAU,CAAC,CAAC,OAAO,gBAAgB,CAAC,UAAU,CAAC;QACnE,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC;QAC7D;YACE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;KACnF;AACH,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 iModels\r\n */\r\n\r\nimport { GeoServiceStatus } from \"@itwin/core-bentley\";\r\nimport { XYZProps } from \"@itwin/core-geometry\";\r\n\r\n/** This enumeration lists all possible status as returned from a coordinate conversion to or from a\r\n * [[GeographicCRS]] and either another [[GeographicCRS]] or a [[GeodeticDatum]].\r\n * @see the [[PointWithStatus]] included in an [[IModelCoordinatesResponseProps]] or [[GeoCoordinatesResponseProps]].\r\n * @public\r\n */\r\nexport enum GeoCoordStatus {\r\n  /** Indicates successful coordinate conversion. */\r\n  Success = 0,\r\n  /** Indicates that the source or target of the conversion is not defined, usually the iModel Geographic Coordinate Reference System.*/\r\n  NoGCSDefined = 100,\r\n  /** This value indicates that the conversion was performed outside of the normal use of application of either Geographic Coordinate Reference Systems.\r\n   *  This return value can often be treated as a warning in specific cases. For example, global imagery extent spans the whole globe and\r\n   *  may extend far beyond the normal area of the iModel project extents and the extent of normal use of its Geographic Coordinate Reference System.\r\n   *  In such cases this value can be considered a warning as accuracy and precision is not expected in this specific case and approximate localization\r\n   *  of global imagery or other low accuracy context data is not essential far from the project.\r\n   *  If this status is returned for high accuracy data then it indicates that either Geographic Coordinate Reference Systems were inappropriately selected\r\n   *  for the iModel or other geolocated data. If this is the case the status should be somehow reported so action\r\n   *  can be performed to verify used geolocation parameters.\r\n   *  In either case the returned coordinates are to be considered valid though they may be inaccurate or result in some unexpected distortion of graphical\r\n   *  elements.\r\n   */\r\n  OutOfUsefulRange = 1,\r\n  /** Indicates a hard error where conversions were requested outside of the area of the mathematical capacity of the conversion process for either\r\n   *  Geographic Coordinate Reference Systems involved. An example could be to attempt a conversion involving a Transverse Mercator more than 60 degrees\r\n   *  East or West of the projection central meridian.\r\n   *  The values returned may or may not be valid and should be discarded.\r\n   */\r\n  OutOfMathematicalDomain = 2,\r\n  /** Indicates that datum transformation between the two Geographic Coordinate Reference Systems could not be performed.\r\n   *  This error is usually the result of a datum transformation path requiring use of latitude/longitude grid shift files that could not be obtained\r\n   *  or installed. In this case the latitude/longitude transformation is bypassed but the remainder of the conversion process is completed.\r\n   *  This error can be ignored for low accuracy data but should be somehow reported so actions can be performed to provide the missing files.\r\n   */\r\n  NoDatumConverter = 25,\r\n  /** Indicates that a problem occurred during vertical datum conversion. This may the result of the inability to access the\r\n   *  Geoid separation data or vertical datum differential data (such as used by NGVD29 to NAVD88 conversion).\r\n   *  The horizontal coordinates returned are valid but the elevation ordinate will be returned unchanged or partially changed.\r\n   *  This status should be somehow reported so actions can be performed to provide the missing information.\r\n   */\r\n  VerticalDatumConvertError = 26,\r\n  /** General inner conversion engine error. Coordinates returned are invalid and should be discarded */\r\n  CSMapError = 4096,\r\n  /** This temporary status is used to mark coordinates for which the conversion has not yet been processed by the backend\r\n   *  as opposed to other coordinate conversions that may have been resolved otherwise (typically a cache).\r\n   *  At the completion of the conversion promise no coordinates should have this status.\r\n   */\r\n  Pending = -41556,\r\n}\r\n\r\n/** Maps a GeoCoordStatus to the equivalent GeoServiceStatus.\r\n * @public\r\n */\r\nexport function mapToGeoServiceStatus(s: GeoCoordStatus): GeoServiceStatus {\r\n  switch (s) {\r\n    case GeoCoordStatus.Success: return GeoServiceStatus.Success;\r\n    case GeoCoordStatus.NoGCSDefined: return GeoServiceStatus.NoGeoLocation;\r\n    case GeoCoordStatus.OutOfUsefulRange: return GeoServiceStatus.OutOfUsefulRange;\r\n    case GeoCoordStatus.OutOfMathematicalDomain: return GeoServiceStatus.OutOfMathematicalDomain;\r\n    case GeoCoordStatus.NoDatumConverter: return GeoServiceStatus.NoDatumConverter;\r\n    case GeoCoordStatus.VerticalDatumConvertError: return GeoServiceStatus.VerticalDatumConvertError;\r\n    case GeoCoordStatus.CSMapError: return GeoServiceStatus.CSMapError;\r\n    case GeoCoordStatus.Pending: return GeoServiceStatus.Pending;\r\n    default:\r\n      throw new Error(\"GeoCoordStatus -> GeoServiceStatus - Missing enum conversion\");\r\n  }\r\n}\r\n\r\n/** Information required to request conversion of an array of Geographic coordinates (Longitude/Latitude) to iModel coordinates\r\n * @beta\r\n */\r\nexport interface IModelCoordinatesRequestProps {\r\n  source: string;\r\n  geoCoords: XYZProps[];\r\n}\r\n\r\n/** Information returned from a request to convert an array of Geographic coordinates (Longitude/Latitude) to iModel coordinates\r\n * @beta\r\n */\r\nexport interface PointWithStatus {\r\n  p: XYZProps;\r\n  s: GeoCoordStatus;\r\n}\r\n\r\n/** @beta */\r\nexport interface IModelCoordinatesResponseProps {\r\n  iModelCoords: PointWithStatus[];\r\n  fromCache: number;    // the number that were read from the cache rather than calculated.\r\n}\r\n\r\n/** Information required to request conversion of an array of iModel coordinates to Geographic Coordinates (longitude and latitude)\r\n * @beta\r\n */\r\nexport interface GeoCoordinatesRequestProps {\r\n  target: string;\r\n  iModelCoords: XYZProps[];\r\n}\r\n\r\n/** Information returned from a request to convert an array of iModel coordinates to Geographic Coordinates (longitude and latitude)\r\n * @beta\r\n */\r\nexport interface GeoCoordinatesResponseProps {\r\n  geoCoords: PointWithStatus[];\r\n  fromCache: number;    // the number that were read from the cache rather than calculated.\r\n}\r\n"]}
+{"version":3,"file":"GeoCoordinateServices.js","sourceRoot":"","sources":["../../src/GeoCoordinateServices.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,qDAAqD;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;;;GAIG;AACH,MAAM,CAAN,IAAY,cA0CX;AA1CD,WAAY,cAAc;IACxB,kDAAkD;IAClD,yDAAW,CAAA;IACX,sIAAsI;IACtI,qEAAkB,CAAA;IAClB;;;;;;;;;;OAUG;IACH,2EAAoB,CAAA;IACpB;;;;OAIG;IACH,yFAA2B,CAAA;IAC3B;;;;OAIG;IACH,4EAAqB,CAAA;IACrB;;;;OAIG;IACH,8FAA8B,CAAA;IAC9B,sGAAsG;IACtG,kEAAiB,CAAA;IACjB;;;OAGG;IACH,8DAAgB,CAAA;AAClB,CAAC,EA1CW,cAAc,KAAd,cAAc,QA0CzB;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAiB;IACrD,QAAQ,CAAC,EAAE;QACT,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC;QAC7D,KAAK,cAAc,CAAC,YAAY,CAAC,CAAC,OAAO,gBAAgB,CAAC,aAAa,CAAC;QACxE,KAAK,cAAc,CAAC,gBAAgB,CAAC,CAAC,OAAO,gBAAgB,CAAC,gBAAgB,CAAC;QAC/E,KAAK,cAAc,CAAC,uBAAuB,CAAC,CAAC,OAAO,gBAAgB,CAAC,uBAAuB,CAAC;QAC7F,KAAK,cAAc,CAAC,gBAAgB,CAAC,CAAC,OAAO,gBAAgB,CAAC,gBAAgB,CAAC;QAC/E,KAAK,cAAc,CAAC,yBAAyB,CAAC,CAAC,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QACjG,KAAK,cAAc,CAAC,UAAU,CAAC,CAAC,OAAO,gBAAgB,CAAC,UAAU,CAAC;QACnE,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC;QAC7D;YACE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;KACnF;AACH,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 iModels\r\n */\r\n\r\n// cspell:ignore NGVD, NAVD, COMPD_CS, PROJCS, GEOGCS\r\n\r\nimport { GeoServiceStatus } from \"@itwin/core-bentley\";\r\nimport { XYZProps } from \"@itwin/core-geometry\";\r\nimport { GeographicCRSProps } from \"./geometry/CoordinateReferenceSystem\";\r\n\r\n/** This enumeration lists all possible status as returned from a coordinate conversion to or from a\r\n * [[GeographicCRS]] and either another [[GeographicCRS]] or a [[GeodeticDatum]].\r\n * @see the [[PointWithStatus]] included in an [[IModelCoordinatesResponseProps]] or [[GeoCoordinatesResponseProps]].\r\n * @public\r\n */\r\nexport enum GeoCoordStatus {\r\n  /** Indicates successful coordinate conversion. */\r\n  Success = 0,\r\n  /** Indicates that the source or target of the conversion is not defined, usually the iModel Geographic Coordinate Reference System.*/\r\n  NoGCSDefined = 100,\r\n  /** This value indicates that the conversion was performed outside of the normal use of application of either Geographic Coordinate Reference Systems.\r\n   *  This return value can often be treated as a warning in specific cases. For example, global imagery extent spans the whole globe and\r\n   *  may extend far beyond the normal area of the iModel project extents and the extent of normal use of its Geographic Coordinate Reference System.\r\n   *  In such cases this value can be considered a warning as accuracy and precision is not expected in this specific case and approximate localization\r\n   *  of global imagery or other low accuracy context data is not essential far from the project.\r\n   *  If this status is returned for high accuracy data then it indicates that either Geographic Coordinate Reference Systems were inappropriately selected\r\n   *  for the iModel or other geolocated data. If this is the case the status should be somehow reported so action\r\n   *  can be performed to verify used geolocation parameters.\r\n   *  In either case the returned coordinates are to be considered valid though they may be inaccurate or result in some unexpected distortion of graphical\r\n   *  elements.\r\n   */\r\n  OutOfUsefulRange = 1,\r\n  /** Indicates a hard error where conversions were requested outside of the area of the mathematical capacity of the conversion process for either\r\n   *  Geographic Coordinate Reference Systems involved. An example could be to attempt a conversion involving a Transverse Mercator more than 60 degrees\r\n   *  East or West of the projection central meridian.\r\n   *  The values returned may or may not be valid and should be discarded.\r\n   */\r\n  OutOfMathematicalDomain = 2,\r\n  /** Indicates that datum transformation between the two Geographic Coordinate Reference Systems could not be performed.\r\n   *  This error is usually the result of a datum transformation path requiring use of latitude/longitude grid shift files that could not be obtained\r\n   *  or installed. In this case the latitude/longitude transformation is bypassed but the remainder of the conversion process is completed.\r\n   *  This error can be ignored for low accuracy data but should be somehow reported so actions can be performed to provide the missing files.\r\n   */\r\n  NoDatumConverter = 25,\r\n  /** Indicates that a problem occurred during vertical datum conversion. This may the result of the inability to access the\r\n   *  Geoid separation data or vertical datum differential data (such as used by NGVD29 to NAVD88 conversion).\r\n   *  The horizontal coordinates returned are valid but the elevation ordinate will be returned unchanged or partially changed.\r\n   *  This status should be somehow reported so actions can be performed to provide the missing information.\r\n   */\r\n  VerticalDatumConvertError = 26,\r\n  /** General inner conversion engine error. Coordinates returned are invalid and should be discarded */\r\n  CSMapError = 4096,\r\n  /** This temporary status is used to mark coordinates for which the conversion has not yet been processed by the backend\r\n   *  as opposed to other coordinate conversions that may have been resolved otherwise (typically a cache).\r\n   *  At the completion of the conversion promise no coordinates should have this status.\r\n   */\r\n  Pending = -41556,\r\n}\r\n\r\n/** Maps a GeoCoordStatus to the equivalent GeoServiceStatus.\r\n * @public\r\n */\r\nexport function mapToGeoServiceStatus(s: GeoCoordStatus): GeoServiceStatus {\r\n  switch (s) {\r\n    case GeoCoordStatus.Success: return GeoServiceStatus.Success;\r\n    case GeoCoordStatus.NoGCSDefined: return GeoServiceStatus.NoGeoLocation;\r\n    case GeoCoordStatus.OutOfUsefulRange: return GeoServiceStatus.OutOfUsefulRange;\r\n    case GeoCoordStatus.OutOfMathematicalDomain: return GeoServiceStatus.OutOfMathematicalDomain;\r\n    case GeoCoordStatus.NoDatumConverter: return GeoServiceStatus.NoDatumConverter;\r\n    case GeoCoordStatus.VerticalDatumConvertError: return GeoServiceStatus.VerticalDatumConvertError;\r\n    case GeoCoordStatus.CSMapError: return GeoServiceStatus.CSMapError;\r\n    case GeoCoordStatus.Pending: return GeoServiceStatus.Pending;\r\n    default:\r\n      throw new Error(\"GeoCoordStatus -> GeoServiceStatus - Missing enum conversion\");\r\n  }\r\n}\r\n\r\n/** Information required to request conversion of an array of Geographic coordinates (Longitude/Latitude) to iModel coordinates\r\n * @beta\r\n */\r\nexport interface IModelCoordinatesRequestProps {\r\n  source: string;\r\n  geoCoords: XYZProps[];\r\n}\r\n\r\n/** Information returned from a request to convert an array of Geographic coordinates (Longitude/Latitude) to iModel coordinates\r\n * @beta\r\n */\r\nexport interface PointWithStatus {\r\n  p: XYZProps;\r\n  s: GeoCoordStatus;\r\n}\r\n\r\n/** @beta */\r\nexport interface IModelCoordinatesResponseProps {\r\n  iModelCoords: PointWithStatus[];\r\n  fromCache: number;    // the number that were read from the cache rather than calculated.\r\n}\r\n\r\n/** Information required to request conversion of an array of iModel coordinates to Geographic Coordinates (longitude and latitude)\r\n * @beta\r\n */\r\nexport interface GeoCoordinatesRequestProps {\r\n  target: string;\r\n  iModelCoords: XYZProps[];\r\n}\r\n\r\n/** Information returned from a request to convert an array of iModel coordinates to Geographic Coordinates (longitude and latitude)\r\n * @beta\r\n */\r\nexport interface GeoCoordinatesResponseProps {\r\n  geoCoords: PointWithStatus[];\r\n  fromCache: number;    // the number that were read from the cache rather than calculated.\r\n}\r\n\r\n/** Information required to interpret or complete a Geographic CRS in the specified format.\r\n *  The only currently supported formats are JSON (for completion) and WKT (OGC Well Known Text)\r\n * @beta\r\n */\r\nexport interface GeographicCRSInterpretRequestProps {\r\n  /** The format of the geographic CRS definition provided in the geographicCRSDef property. */\r\n  format: \"WKT\" | \"JSON\";\r\n  /** The geographic CRS definition in the format specified in the format property.\r\n   *  Note that when the WKT is used the WKT fragment provided can start with a COMPD_CS clause\r\n   *  which should then contain both the horizontal CRS definition as well as the vertical CRS specification.\r\n   *  WKT fragments starting with PROJCS or GEOGCS are also supported but the vertical CRS will be assigned a\r\n   *  default value.\r\n  */\r\n  geographicCRSDef: string;\r\n}\r\n\r\n/** Information returned from a request to interpret or complete a Geographic CRS\r\n * @beta\r\n */\r\nexport interface GeographicCRSInterpretResponseProps {\r\n  /** The result status of the interpret operation. A value of zero indicates successful interpretation.\r\n   *  Any value other than zero is to be considered a hard error and no valid result will\r\n   *  be returned in the geographicCRS property.\r\n  */\r\n  status: number;\r\n  /** The property that receives the interpreted geographic CRS if the process was successful. */\r\n  geographicCRS?: GeographicCRSProps;\r\n}\r\n"]}

package/lib/esm/IModel.d.ts

@@ -29,6 +29,18 @@ export interface IModelRpcProps extends IModelRpcOpenProps {
     readonly key: string;
 }
 /** Properties that position an iModel on the earth via [ECEF](https://en.wikipedia.org/wiki/ECEF) (Earth Centered Earth Fixed) coordinates
+ * The origin is specified as an ECEF coordinate. The cartographicOrigin property contains the latitude, longitude and elevation above the WGS84 ellipsoid
+ * of the origin property. This cartographicOrigin is offered as a convenient pre-calculated value representing the location of the ECEF origin.
+ * The 3D coordinate system this class represents is positioned at specified origin and the axis positioned according to
+ * the other properties.
+ * If the xVector and yVector properties are defined then they take precedence over the YawPitchRoll orientation property. The xVector and yVector
+ * represent the direction and scale of the X and Y axes. The Z axis is always perpendicular (according to the right hand rule) to these X-Y axes.
+ * The scaling in the Z direction is always unity. The scale of the X and Y axes is represented by the size of the vector length.
+ * If the xVector and yVector are not present then the YawPitchRoll properties indicates the angles for all tree axes. Scaling in that case
+ * is unity in all three directions.
+ * Note that the present class is intended to represent geolocated 3D coordinate systems that are normally tangent to the WGS84 ellipsoid
+ * possibly offset in altitude by the terrain elevation above the ellipsoid but other general 3D coordinate systems
+ * can be defined.
  * @public
  */
 export interface EcefLocationProps {
@@ -240,7 +252,17 @@ export declare abstract class IModel implements IModelProps {
     /** An offset to be applied to all spatial coordinates. */
     get globalOrigin(): Point3d;
     set globalOrigin(org: Point3d);
-    /** The [EcefLocation]($docs/learning/glossary#ecefLocation) of the iModel in Earth Centered Earth Fixed coordinates. */
+    /** The [EcefLocation]($docs/learning/glossary#ecefLocation) of the iModel in Earth Centered Earth Fixed coordinates.
+     * If the iModel property geographicCoordinateSystem is not defined then the ecefLocation provides a geolocation by defining a
+     * 3D coordinate system relative to the Earth model WGS84. Refer to additional documentation for details. If the geographicCoordinateSystem
+     * property is defined then the ecefLocation must be used with care. When the geographicCoordinateSystem is defined it indicates the
+     * iModel cartesian space is the result of a cartographic projection. This implies a flattening of the Earth surface process that
+     * results in scale, angular or area distortion. The ecefLocation is then an approximation calculated at the center of the project extent.
+     * If the project is more than 2 kilometer in size, the ecefLocation may represent a poor approximation of the effective
+     * cartographic projection used and a linear transformation should then be calculated at the exact origin of the data
+     * it must position.
+     * @see [GeoLocation of iModels]($docs/learning/GeoLocation.md)
+    */
     get ecefLocation(): EcefLocation | undefined;
     set ecefLocation(ecefLocation: EcefLocation | undefined);
     /** Set the [EcefLocation]($docs/learning/glossary#ecefLocation) for this iModel. */