@itwin/core-common 4.1.0-dev.8 → 4.1.0-dev.80

package/lib/cjs/ECSqlReader.d.ts

@@ -13,27 +13,99 @@ export declare class PropertyMetaDataMap implements Iterable<QueryPropertyMetaDa
     findByNoCase(name: string): QueryPropertyMetaData | undefined;
 }
 /**
+ * The format for rows returned by [[ECSqlReader]].
  * @beta
-*/
+ */
 export type QueryValueType = any;
-/** @beta */
+/**
+ * Methods and ways of accessing values from rows returned by [[ECSqlReader]].
+ * @beta
+ */
 export interface QueryRowProxy {
+    /**
+     * Get the current row as a JavaScript `object`.
+     *
+     * @returns The current row as a JavaScript `object`.
+     */
     toRow(): any;
+    /**
+     * Get all remaining rows from the query result.
+     * If called on the current row ([[ECSqlReader.current]]), only that row is returned.
+     *
+     * @returns All remaining rows from the query result.
+     */
     toArray(): QueryValueType[];
+    /**
+     * Get the metadata for each column in the query result.
+     *
+     * @returns The metadata for each column in the query result.
+     */
     getMetaData(): QueryPropertyMetaData[];
+    /**
+     * Access a property using its name.
+     *
+     * @returns The value from the row whose key (ECSQL column name) is `propertyName`.
+     *
+     * @example
+     * The following lines will all return the same result:
+     * ```ts
+     * reader.current.ECInstanceId;
+     * reader.current.ecinstanceid;
+     * reader.current.["ECInstanceId"];
+     * ```
+     */
     [propertyName: string]: QueryValueType;
+    /**
+     * Access a property using its index.
+     * The index is relative to the order of the columns returned by the query that produced the row.
+     *
+     * @returns The value from the column at `propertyIndex`.
+     *
+     * @example reader.current[0]
+     */
     [propertyIndex: number]: QueryValueType;
 }
-/** @beta */
+/**
+ * Performance-related statistics for [[ECSqlReader]].
+ * @beta
+ */
 export interface QueryStats {
+    /** Time spent running the query; not including time spent queued. Time is in microseconds */
     backendCpuTime: number;
+    /** Total time it took the backend to run the query. Time is in milliseconds. */
     backendTotalTime: number;
+    /** Estimated memory used for the query. */
     backendMemUsed: number;
+    /** Total number of rows returned by the backend. */
     backendRowsReturned: number;
+    /** The total round trip time from the client's perspective. Time is in milliseconds. */
     totalTime: number;
+    /** The number of retries attempted to execute the query. */
     retryCount: number;
 }
-/** @beta */
+/**
+ * Execute ECSQL statements and read the results.
+ *
+ * The query results are returned one row at a time. The format of the row is dictated by the
+ * [[QueryOptions.rowFormat]] specified in the `options` parameter of the constructed ECSqlReader object. Defaults to
+ * [[QueryRowFormat.UseECSqlPropertyIndexes]] when no `rowFormat` is defined.
+ *
+ * There are three primary ways to interact with and read the results:
+ * - Stream them using ECSqlReader as an asynchronous iterator.
+ * - Iterator over them manually using [[ECSqlReader.step]].
+ * - Capture all of the results at once in an array using [[QueryRowProxy.toArray]].
+ *
+ * @see
+ * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)
+ * - [ECSQL Row Formats]($docs/learning/ECSQLRowFormat) for more details on how rows are formatted.
+ * - [ECSQL Code Examples]($docs/learning/ECSQLCodeExamples#iterating-over-query-results) for examples of each
+ *      of the above ways of interacting with ECSqlReader.
+ *
+ * @note When iterating over the results, the current row will be a [[QueryRowProxy]] object. To get the row as a basic
+ *       JavaScript object, call [[QueryRowProxy.toRow]] on it.
+ *
+ * @beta
+ */
 export declare class ECSqlReader implements AsyncIterableIterator<QueryRowProxy> {
     private _executor;
     readonly query: string;
@@ -48,26 +120,111 @@ export declare class ECSqlReader implements AsyncIterableIterator<QueryRowProxy>
     private _param;
     private _lockArgs;
     private _stats;
-    private _rowProxy;
     private _options;
-    /** @internal */
+    private _rowProxy;
+    /**
+     * @internal
+     */
     constructor(_executor: DbRequestExecutor<DbQueryRequest, DbQueryResponse>, query: string, param?: QueryBinder, options?: QueryOptions);
     private static replaceBase64WithUint8Array;
     setParams(param: QueryBinder): void;
     reset(options?: QueryOptions): void;
+    /**
+     * Get the current row from the query result. The current row is the one most recently stepped-to
+     * (by step() or during iteration).
+     *
+     * Each value from the row can be accessed by index or by name.
+     *
+     * The format of the row is dictated by the [[QueryOptions.rowFormat]] specified in the `options` parameter of the
+     * constructed ECSqlReader object.
+     *
+     * @see
+     * - [[QueryRowFormat]]
+     * - [ECSQL Row Formats]($docs/learning/ECSQLRowFormat)
+     *
+     * @note The current row is be a [[QueryRowProxy]] object. To get the row as a basic JavaScript object, call
+     *       [[QueryRowProxy.toRow]] on it.
+     *
+     * @example
+     * ```ts
+     * const reader = iModel.createQueryReader("SELECT ECInstanceId FROM bis.Element");
+     * while (await reader.step()) {
+     *   // Both lines below print the same value
+     *   console.log(reader.current[0]);
+     *   console.log(reader.current.ecinstanceid);
+     * }
+     * ```
+     *
+     * @return The current row as a [[QueryRowProxy]].
+     */
     get current(): QueryRowProxy;
+    /**
+     * Clear all bindings.
+     */
     resetBindings(): void;
+    /**
+     * Returns if there are more rows available.
+     *
+     * @returns `true` if all rows have been stepped through already.<br/>
+     *          `false` if there are any yet unaccessed rows.
+     */
     get done(): boolean;
+    /**
+     *
+     */
     getRowInternal(): any[];
+    /**
+     * Get performance-related statistics for the current query.
+     */
     get stats(): QueryStats;
+    /**
+     *
+     */
     private readRows;
-    private runWithRetry;
+    /**
+     * @internal
+     */
+    protected runWithRetry(request: DbQueryRequest): Promise<DbQueryResponse>;
+    /**
+     *
+     */
     formatCurrentRow(onlyReturnObject?: boolean): any[] | object;
+    /**
+     * Get the metadata for each column in the query result.
+     *
+     * @returns An array of [[QueryPropertyMetaData]].
+     */
     getMetaData(): Promise<QueryPropertyMetaData[]>;
+    /**
+     *
+     */
     private fetchRows;
+    /**
+     * Step to the next row of the query result.
+     *
+     * @returns `true` if a row can be read from `current`.<br/>
+     *          `false` if there are no more rows; i.e., all rows have been stepped through already.
+     */
     step(): Promise<boolean>;
+    /**
+     * Get all remaining rows from the query result.
+     *
+     * @returns An array of all remaining rows from the query result.
+     */
     toArray(): Promise<any[]>;
+    /**
+     * Accessor for using ECSqlReader as an asynchronous iterator.
+     *
+     * @returns An asynchronous iterator over the rows returned by the executed ECSQL query.
+     */
     [Symbol.asyncIterator](): AsyncIterableIterator<QueryRowProxy>;
+    /**
+     * Calls step when called as an iterator.
+     *
+     * Returns the row alongside a `done` boolean to indicate if there are any more rows for an iterator to step to.
+     *
+     * @returns An object with the keys: `value` which contains the row and `done` which contains a boolean.
+     */
     next(): Promise<IteratorResult<QueryRowProxy, any>>;
 }
 //# sourceMappingURL=ECSqlReader.d.ts.map

package/lib/cjs/ECSqlReader.d.ts.map

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

package/lib/cjs/ECSqlReader.js

@@ -24,7 +24,9 @@ class PropertyMetaDataMap {
             this._byNoCase.set(property.jsonName.toLowerCase(), property.index);
         }
     }
-    get length() { return this.properties.length; }
+    get length() {
+        return this.properties.length;
+    }
     [Symbol.iterator]() {
         return this.properties[Symbol.iterator]();
     }
@@ -51,9 +53,33 @@ class PropertyMetaDataMap {
     }
 }
 exports.PropertyMetaDataMap = PropertyMetaDataMap;
-/** @beta */
+/**
+ * Execute ECSQL statements and read the results.
+ *
+ * The query results are returned one row at a time. The format of the row is dictated by the
+ * [[QueryOptions.rowFormat]] specified in the `options` parameter of the constructed ECSqlReader object. Defaults to
+ * [[QueryRowFormat.UseECSqlPropertyIndexes]] when no `rowFormat` is defined.
+ *
+ * There are three primary ways to interact with and read the results:
+ * - Stream them using ECSqlReader as an asynchronous iterator.
+ * - Iterator over them manually using [[ECSqlReader.step]].
+ * - Capture all of the results at once in an array using [[QueryRowProxy.toArray]].
+ *
+ * @see
+ * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)
+ * - [ECSQL Row Formats]($docs/learning/ECSQLRowFormat) for more details on how rows are formatted.
+ * - [ECSQL Code Examples]($docs/learning/ECSQLCodeExamples#iterating-over-query-results) for examples of each
+ *      of the above ways of interacting with ECSqlReader.
+ *
+ * @note When iterating over the results, the current row will be a [[QueryRowProxy]] object. To get the row as a basic
+ *       JavaScript object, call [[QueryRowProxy.toRow]] on it.
+ *
+ * @beta
+ */
 class ECSqlReader {
-    /** @internal */
+    /**
+     * @internal
+     */
     constructor(_executor, query, param, options) {
         this._executor = _executor;
         this.query = query;
@@ -67,6 +93,7 @@ class ECSqlReader {
         this._param = new ConcurrentQuery_1.QueryBinder().serialize();
         this._lockArgs = false;
         this._stats = { backendCpuTime: 0, backendTotalTime: 0, backendMemUsed: 0, backendRowsReturned: 0, totalTime: 0, retryCount: 0 };
+        this._options = new ConcurrentQuery_1.QueryOptionsBuilder().getOptions();
         this._rowProxy = new Proxy(this, {
             get: (target, key) => {
                 if (typeof key === "string") {
@@ -101,7 +128,6 @@ class ECSqlReader {
                 return keys;
             },
         });
-        this._options = new ConcurrentQuery_1.QueryOptionsBuilder().getOptions();
         if (query.trim().length === 0) {
             throw new Error("expecting non-empty ecsql statement");
         }
@@ -148,21 +174,70 @@ class ECSqlReader {
         }
         this._done = false;
     }
-    get current() { return this._rowProxy; }
-    // clear all bindings
+    /**
+     * Get the current row from the query result. The current row is the one most recently stepped-to
+     * (by step() or during iteration).
+     *
+     * Each value from the row can be accessed by index or by name.
+     *
+     * The format of the row is dictated by the [[QueryOptions.rowFormat]] specified in the `options` parameter of the
+     * constructed ECSqlReader object.
+     *
+     * @see
+     * - [[QueryRowFormat]]
+     * - [ECSQL Row Formats]($docs/learning/ECSQLRowFormat)
+     *
+     * @note The current row is be a [[QueryRowProxy]] object. To get the row as a basic JavaScript object, call
+     *       [[QueryRowProxy.toRow]] on it.
+     *
+     * @example
+     * ```ts
+     * const reader = iModel.createQueryReader("SELECT ECInstanceId FROM bis.Element");
+     * while (await reader.step()) {
+     *   // Both lines below print the same value
+     *   console.log(reader.current[0]);
+     *   console.log(reader.current.ecinstanceid);
+     * }
+     * ```
+     *
+     * @return The current row as a [[QueryRowProxy]].
+     */
+    get current() {
+        return this._rowProxy;
+    }
+    /**
+     * Clear all bindings.
+     */
     resetBindings() {
         this._param = new ConcurrentQuery_1.QueryBinder().serialize();
         this._lockArgs = false;
     }
-    // return if there is any more rows available
-    get done() { return this._done; }
+    /**
+     * Returns if there are more rows available.
+     *
+     * @returns `true` if all rows have been stepped through already.<br/>
+     *          `false` if there are any yet unaccessed rows.
+     */
+    get done() {
+        return this._done;
+    }
+    /**
+     *
+     */
     getRowInternal() {
         if (this._localRows.length <= this._localOffset)
             throw new Error("no current row");
         return this._localRows[this._localOffset];
     }
-    // return performance related statistics for current query.
-    get stats() { return this._stats; }
+    /**
+     * Get performance-related statistics for the current query.
+     */
+    get stats() {
+        return this._stats;
+    }
+    /**
+     *
+     */
     async readRows() {
         if (this._globalDone) {
             return [];
@@ -193,13 +268,16 @@ class ECSqlReader {
         }
         return resp.data;
     }
+    /**
+     * @internal
+     */
     async runWithRetry(request) {
-        const needRetry = (rs) => (rs.status === ConcurrentQuery_1.DbResponseStatus.Partial || rs.status === ConcurrentQuery_1.DbResponseStatus.QueueFull || rs.status === ConcurrentQuery_1.DbResponseStatus.Timeout) && (rs.data.length === 0);
+        const needRetry = (rs) => (rs.status === ConcurrentQuery_1.DbResponseStatus.Partial || rs.status === ConcurrentQuery_1.DbResponseStatus.QueueFull || rs.status === ConcurrentQuery_1.DbResponseStatus.Timeout) && (rs.data === undefined || rs.data.length === 0);
         const updateStats = (rs) => {
             this._stats.backendCpuTime += rs.stats.cpuTime;
             this._stats.backendTotalTime += rs.stats.totalTime;
             this._stats.backendMemUsed += rs.stats.memUsed;
-            this._stats.backendRowsReturned += rs.data.length;
+            this._stats.backendRowsReturned += (rs.data === undefined) ? 0 : rs.data.length;
         };
         const execQuery = async (req) => {
             const startTime = Date.now();
@@ -223,6 +301,9 @@ class ECSqlReader {
         updateStats(resp);
         return resp;
     }
+    /**
+     *
+     */
     formatCurrentRow(onlyReturnObject = false) {
         if (!onlyReturnObject && this._options.rowFormat === ConcurrentQuery_1.QueryRowFormat.UseECSqlPropertyIndexes) {
             return this.getRowInternal();
@@ -240,12 +321,20 @@ class ECSqlReader {
         }
         return formattedRow;
     }
+    /**
+     * Get the metadata for each column in the query result.
+     *
+     * @returns An array of [[QueryPropertyMetaData]].
+     */
     async getMetaData() {
         if (this._props.length === 0) {
             await this.fetchRows();
         }
         return this._props.properties;
     }
+    /**
+     *
+     */
     async fetchRows() {
         this._localOffset = -1;
         this._localRows = await this.readRows();
@@ -253,6 +342,12 @@ class ECSqlReader {
             this._done = true;
         }
     }
+    /**
+     * Step to the next row of the query result.
+     *
+     * @returns `true` if a row can be read from `current`.<br/>
+     *          `false` if there are no more rows; i.e., all rows have been stepped through already.
+     */
     async step() {
         if (this._done) {
             return false;
@@ -268,6 +363,11 @@ class ECSqlReader {
         }
         return true;
     }
+    /**
+     * Get all remaining rows from the query result.
+     *
+     * @returns An array of all remaining rows from the query result.
+     */
     async toArray() {
         const rows = [];
         while (await this.step()) {
@@ -275,9 +375,21 @@ class ECSqlReader {
         }
         return rows;
     }
+    /**
+     * Accessor for using ECSqlReader as an asynchronous iterator.
+     *
+     * @returns An asynchronous iterator over the rows returned by the executed ECSQL query.
+     */
     [Symbol.asyncIterator]() {
         return this;
     }
+    /**
+     * Calls step when called as an iterator.
+     *
+     * Returns the row alongside a `done` boolean to indicate if there are any more rows for an iterator to step to.
+     *
+     * @returns An object with the keys: `value` which contains the row and `done` which contains a boolean.
+     */
     async next() {
         if (await this.step()) {
             return {

package/lib/cjs/ECSqlReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"ECSqlReader.js","sourceRoot":"","sources":["../../src/ECSqlReader.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 { Base64EncodedString } from \"./Base64EncodedString\";\r\nimport {\r\n  DbQueryError, DbQueryRequest, DbQueryResponse, DbRequestExecutor, DbRequestKind, DbResponseStatus, DbValueFormat, QueryBinder, QueryOptions, QueryOptionsBuilder,\r\n  QueryPropertyMetaData, QueryRowFormat,\r\n} from \"./ConcurrentQuery\";\r\n\r\n/** @beta */\r\nexport class PropertyMetaDataMap implements Iterable<QueryPropertyMetaData> {\r\n  private _byPropName = new Map<string, number>();\r\n  private _byJsonName = new Map<string, number>();\r\n  private _byNoCase = new Map<string, number>();\r\n  public constructor(public readonly properties: QueryPropertyMetaData[]) {\r\n    for (const property of this.properties) {\r\n      this._byPropName.set(property.name, property.index);\r\n      this._byJsonName.set(property.jsonName, property.index);\r\n      this._byNoCase.set(property.name.toLowerCase(), property.index);\r\n      this._byNoCase.set(property.jsonName.toLowerCase(), property.index);\r\n    }\r\n  }\r\n  public get length(): number { return this.properties.length; }\r\n\r\n  public [Symbol.iterator](): Iterator<QueryPropertyMetaData, any, undefined> {\r\n    return this.properties[Symbol.iterator]();\r\n  }\r\n  public findByName(name: string): QueryPropertyMetaData | undefined {\r\n    const index = this._byPropName.get(name);\r\n    if (typeof index === \"number\") {\r\n      return this.properties[index];\r\n    }\r\n    return undefined;\r\n  }\r\n  public findByJsonName(name: string): QueryPropertyMetaData | undefined {\r\n    const index = this._byJsonName.get(name);\r\n    if (typeof index === \"number\") {\r\n      return this.properties[index];\r\n    }\r\n    return undefined;\r\n  }\r\n  public findByNoCase(name: string): QueryPropertyMetaData | undefined {\r\n    const index = this._byNoCase.get(name.toLowerCase());\r\n    if (typeof index === \"number\") {\r\n      return this.properties[index];\r\n    }\r\n    return undefined;\r\n  }\r\n}\r\n/**\r\n * @beta\r\n*/\r\nexport type QueryValueType = any;\r\n\r\n/** @beta */\r\nexport interface QueryRowProxy {\r\n  toRow(): any;\r\n  toArray(): QueryValueType[];\r\n  getMetaData(): QueryPropertyMetaData[];\r\n  [propertyName: string]: QueryValueType;\r\n  [propertyIndex: number]: QueryValueType;\r\n}\r\n\r\n/** @beta */\r\nexport interface QueryStats {\r\n  backendCpuTime: number; // Time spent running the query. It exclude query time in queue. Time is in microseconds.\r\n  backendTotalTime: number; // backend total time spent running the query. Time is in milliseconds.\r\n  backendMemUsed: number; // Estimated m emory used for query. Time is in milliseconds.\r\n  backendRowsReturned: number; // Total rows returned by backend.\r\n  totalTime: number; // Round trip time from client perspective.Time is in milliseconds.\r\n  retryCount: number;\r\n}\r\n\r\n/** @beta */\r\nexport class ECSqlReader implements AsyncIterableIterator<QueryRowProxy>  {\r\n  private static readonly _maxRetryCount = 10;\r\n  private _localRows: any[] = [];\r\n  private _localOffset: number = 0;\r\n  private _globalOffset: number = -1;\r\n  private _globalCount: number = -1;\r\n  private _done: boolean = false;\r\n  private _globalDone: boolean = false;\r\n  private _props = new PropertyMetaDataMap([]);\r\n  private _param = new QueryBinder().serialize();\r\n  private _lockArgs: boolean = false;\r\n  private _stats = { backendCpuTime: 0, backendTotalTime: 0, backendMemUsed: 0, backendRowsReturned: 0, totalTime: 0, retryCount: 0 };\r\n  private _rowProxy = new Proxy<ECSqlReader>(this, {\r\n    get: (target: ECSqlReader, key: string | Symbol) => {\r\n      if (typeof key === \"string\") {\r\n        const idx = Number.parseInt(key, 10);\r\n        if (!Number.isNaN(idx)) {\r\n          return target.getRowInternal()[idx];\r\n        }\r\n        const prop = target._props.findByNoCase(key);\r\n        if (prop) {\r\n          return target.getRowInternal()[prop.index];\r\n        }\r\n        if (key === \"getMetaData\") {\r\n          return () => target._props.properties;\r\n        }\r\n        if (key === \"toRow\") {\r\n          return () => target.formatCurrentRow(true);\r\n        }\r\n        if (key === \"toArray\") {\r\n          return () => this.getRowInternal();\r\n        }\r\n      }\r\n      return undefined;\r\n    },\r\n    has: (target: ECSqlReader, p: string | symbol) => {\r\n      return !target._props.findByNoCase(p as string);\r\n    },\r\n    ownKeys: (target: ECSqlReader) => {\r\n      const keys = [];\r\n      for (const prop of target._props) {\r\n        keys.push(prop.name);\r\n      }\r\n      return keys;\r\n    },\r\n  });\r\n  private _options: QueryOptions = new QueryOptionsBuilder().getOptions();\r\n  /** @internal */\r\n  public constructor(private _executor: DbRequestExecutor<DbQueryRequest, DbQueryResponse>, public readonly query: string, param?: QueryBinder, options?: QueryOptions) {\r\n    if (query.trim().length === 0) {\r\n      throw new Error(\"expecting non-empty ecsql statement\");\r\n    }\r\n    if (param) {\r\n      this._param = param.serialize();\r\n    }\r\n    this.reset(options);\r\n  }\r\n  private static replaceBase64WithUint8Array(row: any) {\r\n    for (const key of Object.keys(row)) {\r\n      const val = row[key];\r\n      if (typeof val === \"string\") {\r\n        if (Base64EncodedString.hasPrefix(val)) {\r\n          row[key] = Base64EncodedString.toUint8Array(val);\r\n        }\r\n      } else if (typeof val === \"object\" && val !== null) {\r\n        this.replaceBase64WithUint8Array(val);\r\n      }\r\n    }\r\n  }\r\n  public setParams(param: QueryBinder) {\r\n    if (this._lockArgs) {\r\n      throw new Error(\"call resetBindings() before setting or changing parameters\");\r\n    }\r\n    this._param = param.serialize();\r\n  }\r\n  public reset(options?: QueryOptions) {\r\n    if (options) {\r\n      this._options = options;\r\n    }\r\n    this._props = new PropertyMetaDataMap([]);\r\n    this._localRows = [];\r\n    this._globalDone = false;\r\n    this._globalOffset = 0;\r\n    this._globalCount = -1;\r\n    if (typeof this._options.rowFormat === \"undefined\")\r\n      this._options.rowFormat = QueryRowFormat.UseECSqlPropertyIndexes;\r\n    if (this._options.limit) {\r\n      if (typeof this._options.limit.offset === \"number\" && this._options.limit.offset > 0)\r\n        this._globalOffset = this._options.limit.offset;\r\n      if (typeof this._options.limit.count === \"number\" && this._options.limit.count > 0)\r\n        this._globalCount = this._options.limit.count;\r\n    }\r\n    this._done = false;\r\n  }\r\n  public get current(): QueryRowProxy { return (this._rowProxy as any); }\r\n  // clear all bindings\r\n  public resetBindings() {\r\n    this._param = new QueryBinder().serialize();\r\n    this._lockArgs = false;\r\n  }\r\n  // return if there is any more rows available\r\n  public get done(): boolean { return this._done; }\r\n  public getRowInternal(): any[] {\r\n    if (this._localRows.length <= this._localOffset)\r\n      throw new Error(\"no current row\");\r\n    return this._localRows[this._localOffset] as any[];\r\n  }\r\n  // return performance related statistics for current query.\r\n  public get stats(): QueryStats { return this._stats; }\r\n  private async readRows(): Promise<any[]> {\r\n    if (this._globalDone) {\r\n      return [];\r\n    }\r\n    this._lockArgs = true;\r\n    this._globalOffset += this._localRows.length;\r\n    this._globalCount -= this._localRows.length;\r\n    if (this._globalCount === 0) {\r\n      return [];\r\n    }\r\n    const valueFormat = this._options.rowFormat === QueryRowFormat.UseJsPropertyNames ? DbValueFormat.JsNames : DbValueFormat.ECSqlNames;\r\n    const request: DbQueryRequest = {\r\n      ... this._options,\r\n      kind: DbRequestKind.ECSql,\r\n      valueFormat,\r\n      query: this.query,\r\n      args: this._param,\r\n    };\r\n    request.includeMetaData = this._props.length > 0 ? false : true;\r\n    request.limit = { offset: this._globalOffset, count: this._globalCount < 1 ? -1 : this._globalCount };\r\n    const resp = await this.runWithRetry(request);\r\n    this._globalDone = resp.status === DbResponseStatus.Done;\r\n    if (this._props.length === 0 && resp.meta.length > 0) {\r\n      this._props = new PropertyMetaDataMap(resp.meta);\r\n    }\r\n    for (const row of resp.data) {\r\n      ECSqlReader.replaceBase64WithUint8Array(row);\r\n    }\r\n    return resp.data;\r\n  }\r\n  private async runWithRetry(request: DbQueryRequest) {\r\n    const needRetry = (rs: DbQueryResponse) => (rs.status === DbResponseStatus.Partial || rs.status === DbResponseStatus.QueueFull || rs.status === DbResponseStatus.Timeout) && (rs.data.length === 0);\r\n    const updateStats = (rs: DbQueryResponse) => {\r\n      this._stats.backendCpuTime += rs.stats.cpuTime;\r\n      this._stats.backendTotalTime += rs.stats.totalTime;\r\n      this._stats.backendMemUsed += rs.stats.memUsed;\r\n      this._stats.backendRowsReturned += rs.data.length;\r\n    };\r\n    const execQuery = async (req: DbQueryRequest) => {\r\n      const startTime = Date.now();\r\n      const rs = await this._executor.execute(req);\r\n      this.stats.totalTime += (Date.now() - startTime);\r\n      return rs;\r\n    };\r\n    let retry = ECSqlReader._maxRetryCount;\r\n    let resp = await execQuery(request);\r\n    DbQueryError.throwIfError(resp, request);\r\n    while (--retry > 0 && needRetry(resp)) {\r\n      resp = await execQuery(request);\r\n      this._stats.retryCount += 1;\r\n      if (needRetry(resp)) {\r\n        updateStats(resp);\r\n      }\r\n    }\r\n    if (retry === 0 && needRetry(resp)) {\r\n      throw new Error(\"query too long to execute or server is too busy\");\r\n    }\r\n    updateStats(resp);\r\n    return resp;\r\n  }\r\n  public formatCurrentRow(onlyReturnObject: boolean = false): any[] | object {\r\n    if (!onlyReturnObject && this._options.rowFormat === QueryRowFormat.UseECSqlPropertyIndexes) {\r\n      return this.getRowInternal();\r\n    }\r\n    const formattedRow = {};\r\n    for (const prop of this._props) {\r\n      const propName = this._options.rowFormat === QueryRowFormat.UseJsPropertyNames ? prop.jsonName : prop.name;\r\n      const val = this.getRowInternal()[prop.index];\r\n      if (typeof val !== \"undefined\" && val !== null) {\r\n        Object.defineProperty(formattedRow, propName, {\r\n          value: val,\r\n          enumerable: true,\r\n        });\r\n      }\r\n    }\r\n    return formattedRow;\r\n  }\r\n  public async getMetaData(): Promise<QueryPropertyMetaData[]> {\r\n    if (this._props.length === 0) {\r\n      await this.fetchRows();\r\n    }\r\n    return this._props.properties;\r\n  }\r\n  private async fetchRows() {\r\n    this._localOffset = -1;\r\n    this._localRows = await this.readRows();\r\n    if (this._localRows.length === 0) {\r\n      this._done = true;\r\n    }\r\n  }\r\n  public async step(): Promise<boolean> {\r\n    if (this._done) {\r\n      return false;\r\n    }\r\n    const cachedRows = this._localRows.length;\r\n    if (this._localOffset < cachedRows - 1) {\r\n      ++this._localOffset;\r\n    } else {\r\n      await this.fetchRows();\r\n      this._localOffset = 0;\r\n      return !this._done;\r\n    }\r\n    return true;\r\n  }\r\n  public async toArray(): Promise<any[]> {\r\n    const rows = [];\r\n    while (await this.step()) {\r\n      rows.push(this.formatCurrentRow());\r\n    }\r\n    return rows;\r\n  }\r\n  public [Symbol.asyncIterator](): AsyncIterableIterator<QueryRowProxy> {\r\n    return this;\r\n  }\r\n  public async next(): Promise<IteratorResult<QueryRowProxy, any>> {\r\n    if (await this.step()) {\r\n      return {\r\n        done: false,\r\n        value: this.current,\r\n      };\r\n    } else {\r\n      return {\r\n        done: true,\r\n        value: this.current,\r\n      };\r\n    }\r\n  }\r\n}\r\n\r\n"]}
+{"version":3,"file":"ECSqlReader.js","sourceRoot":"","sources":["../../src/ECSqlReader.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module iModels\n */\nimport { Base64EncodedString } from \"./Base64EncodedString\";\nimport {\n  DbQueryError, DbQueryRequest, DbQueryResponse, DbRequestExecutor, DbRequestKind, DbResponseStatus, DbValueFormat, QueryBinder, QueryOptions, QueryOptionsBuilder,\n  QueryPropertyMetaData, QueryRowFormat,\n} from \"./ConcurrentQuery\";\n\n/** @beta */\nexport class PropertyMetaDataMap implements Iterable<QueryPropertyMetaData> {\n  private _byPropName = new Map<string, number>();\n  private _byJsonName = new Map<string, number>();\n  private _byNoCase = new Map<string, number>();\n\n  public constructor(public readonly properties: QueryPropertyMetaData[]) {\n    for (const property of this.properties) {\n      this._byPropName.set(property.name, property.index);\n      this._byJsonName.set(property.jsonName, property.index);\n      this._byNoCase.set(property.name.toLowerCase(), property.index);\n      this._byNoCase.set(property.jsonName.toLowerCase(), property.index);\n    }\n  }\n\n  public get length(): number {\n    return this.properties.length;\n  }\n\n  public [Symbol.iterator](): Iterator<QueryPropertyMetaData, any, undefined> {\n    return this.properties[Symbol.iterator]();\n  }\n\n  public findByName(name: string): QueryPropertyMetaData | undefined {\n    const index = this._byPropName.get(name);\n    if (typeof index === \"number\") {\n      return this.properties[index];\n    }\n    return undefined;\n  }\n\n  public findByJsonName(name: string): QueryPropertyMetaData | undefined {\n    const index = this._byJsonName.get(name);\n    if (typeof index === \"number\") {\n      return this.properties[index];\n    }\n    return undefined;\n  }\n\n  public findByNoCase(name: string): QueryPropertyMetaData | undefined {\n    const index = this._byNoCase.get(name.toLowerCase());\n    if (typeof index === \"number\") {\n      return this.properties[index];\n    }\n    return undefined;\n  }\n}\n\n/**\n * The format for rows returned by [[ECSqlReader]].\n * @beta\n */\nexport type QueryValueType = any;\n\n/**\n * Methods and ways of accessing values from rows returned by [[ECSqlReader]].\n * @beta\n */\nexport interface QueryRowProxy {\n  /**\n   * Get the current row as a JavaScript `object`.\n   *\n   * @returns The current row as a JavaScript `object`.\n   */\n  toRow(): any;\n\n  /**\n   * Get all remaining rows from the query result.\n   * If called on the current row ([[ECSqlReader.current]]), only that row is returned.\n   *\n   * @returns All remaining rows from the query result.\n   */\n  toArray(): QueryValueType[];\n\n  /**\n   * Get the metadata for each column in the query result.\n   *\n   * @returns The metadata for each column in the query result.\n   */\n  getMetaData(): QueryPropertyMetaData[];\n\n  /**\n   * Access a property using its name.\n   *\n   * @returns The value from the row whose key (ECSQL column name) is `propertyName`.\n   *\n   * @example\n   * The following lines will all return the same result:\n   * ```ts\n   * reader.current.ECInstanceId;\n   * reader.current.ecinstanceid;\n   * reader.current.[\"ECInstanceId\"];\n   * ```\n   */\n  [propertyName: string]: QueryValueType;\n\n  /**\n   * Access a property using its index.\n   * The index is relative to the order of the columns returned by the query that produced the row.\n   *\n   * @returns The value from the column at `propertyIndex`.\n   *\n   * @example reader.current[0]\n   */\n  [propertyIndex: number]: QueryValueType;\n}\n\n/**\n * Performance-related statistics for [[ECSqlReader]].\n * @beta\n */\nexport interface QueryStats {\n  /** Time spent running the query; not including time spent queued. Time is in microseconds */\n  backendCpuTime: number;\n  /** Total time it took the backend to run the query. Time is in milliseconds. */\n  backendTotalTime: number;\n  /** Estimated memory used for the query. */\n  backendMemUsed: number;\n  /** Total number of rows returned by the backend. */\n  backendRowsReturned: number;\n  /** The total round trip time from the client's perspective. Time is in milliseconds. */\n  totalTime: number;\n  /** The number of retries attempted to execute the query. */\n  retryCount: number;\n}\n\n/**\n * Execute ECSQL statements and read the results.\n *\n * The query results are returned one row at a time. The format of the row is dictated by the\n * [[QueryOptions.rowFormat]] specified in the `options` parameter of the constructed ECSqlReader object. Defaults to\n * [[QueryRowFormat.UseECSqlPropertyIndexes]] when no `rowFormat` is defined.\n *\n * There are three primary ways to interact with and read the results:\n * - Stream them using ECSqlReader as an asynchronous iterator.\n * - Iterator over them manually using [[ECSqlReader.step]].\n * - Capture all of the results at once in an array using [[QueryRowProxy.toArray]].\n *\n * @see\n * - [ECSQL Overview]($docs/learning/backend/ExecutingECSQL)\n * - [ECSQL Row Formats]($docs/learning/ECSQLRowFormat) for more details on how rows are formatted.\n * - [ECSQL Code Examples]($docs/learning/ECSQLCodeExamples#iterating-over-query-results) for examples of each\n *      of the above ways of interacting with ECSqlReader.\n *\n * @note When iterating over the results, the current row will be a [[QueryRowProxy]] object. To get the row as a basic\n *       JavaScript object, call [[QueryRowProxy.toRow]] on it.\n *\n * @beta\n */\nexport class ECSqlReader implements AsyncIterableIterator<QueryRowProxy> {\n  private static readonly _maxRetryCount = 10;\n\n  private _localRows: any[] = [];\n  private _localOffset: number = 0;\n  private _globalOffset: number = -1;\n  private _globalCount: number = -1;\n  private _done: boolean = false;\n  private _globalDone: boolean = false;\n  private _props = new PropertyMetaDataMap([]);\n  private _param = new QueryBinder().serialize();\n  private _lockArgs: boolean = false;\n  private _stats = { backendCpuTime: 0, backendTotalTime: 0, backendMemUsed: 0, backendRowsReturned: 0, totalTime: 0, retryCount: 0 };\n  private _options: QueryOptions = new QueryOptionsBuilder().getOptions();\n\n  private _rowProxy = new Proxy<ECSqlReader>(this, {\n    get: (target: ECSqlReader, key: string | Symbol) => {\n      if (typeof key === \"string\") {\n        const idx = Number.parseInt(key, 10);\n        if (!Number.isNaN(idx)) {\n          return target.getRowInternal()[idx];\n        }\n        const prop = target._props.findByNoCase(key);\n        if (prop) {\n          return target.getRowInternal()[prop.index];\n        }\n        if (key === \"getMetaData\") {\n          return () => target._props.properties;\n        }\n        if (key === \"toRow\") {\n          return () => target.formatCurrentRow(true);\n        }\n        if (key === \"toArray\") {\n          return () => this.getRowInternal();\n        }\n      }\n      return undefined;\n    },\n    has: (target: ECSqlReader, p: string | symbol) => {\n      return !target._props.findByNoCase(p as string);\n    },\n    ownKeys: (target: ECSqlReader) => {\n      const keys = [];\n      for (const prop of target._props) {\n        keys.push(prop.name);\n      }\n      return keys;\n    },\n  });\n\n  /**\n   * @internal\n   */\n  public constructor(private _executor: DbRequestExecutor<DbQueryRequest, DbQueryResponse>, public readonly query: string, param?: QueryBinder, options?: QueryOptions) {\n    if (query.trim().length === 0) {\n      throw new Error(\"expecting non-empty ecsql statement\");\n    }\n    if (param) {\n      this._param = param.serialize();\n    }\n    this.reset(options);\n  }\n\n  private static replaceBase64WithUint8Array(row: any) {\n    for (const key of Object.keys(row)) {\n      const val = row[key];\n      if (typeof val === \"string\") {\n        if (Base64EncodedString.hasPrefix(val)) {\n          row[key] = Base64EncodedString.toUint8Array(val);\n        }\n      } else if (typeof val === \"object\" && val !== null) {\n        this.replaceBase64WithUint8Array(val);\n      }\n    }\n  }\n\n  public setParams(param: QueryBinder) {\n    if (this._lockArgs) {\n      throw new Error(\"call resetBindings() before setting or changing parameters\");\n    }\n    this._param = param.serialize();\n  }\n\n  public reset(options?: QueryOptions) {\n    if (options) {\n      this._options = options;\n    }\n    this._props = new PropertyMetaDataMap([]);\n    this._localRows = [];\n    this._globalDone = false;\n    this._globalOffset = 0;\n    this._globalCount = -1;\n    if (typeof this._options.rowFormat === \"undefined\")\n      this._options.rowFormat = QueryRowFormat.UseECSqlPropertyIndexes;\n    if (this._options.limit) {\n      if (typeof this._options.limit.offset === \"number\" && this._options.limit.offset > 0)\n        this._globalOffset = this._options.limit.offset;\n      if (typeof this._options.limit.count === \"number\" && this._options.limit.count > 0)\n        this._globalCount = this._options.limit.count;\n    }\n    this._done = false;\n  }\n\n  /**\n   * Get the current row from the query result. The current row is the one most recently stepped-to\n   * (by step() or during iteration).\n   *\n   * Each value from the row can be accessed by index or by name.\n   *\n   * The format of the row is dictated by the [[QueryOptions.rowFormat]] specified in the `options` parameter of the\n   * constructed ECSqlReader object.\n   *\n   * @see\n   * - [[QueryRowFormat]]\n   * - [ECSQL Row Formats]($docs/learning/ECSQLRowFormat)\n   *\n   * @note The current row is be a [[QueryRowProxy]] object. To get the row as a basic JavaScript object, call\n   *       [[QueryRowProxy.toRow]] on it.\n   *\n   * @example\n   * ```ts\n   * const reader = iModel.createQueryReader(\"SELECT ECInstanceId FROM bis.Element\");\n   * while (await reader.step()) {\n   *   // Both lines below print the same value\n   *   console.log(reader.current[0]);\n   *   console.log(reader.current.ecinstanceid);\n   * }\n   * ```\n   *\n   * @return The current row as a [[QueryRowProxy]].\n   */\n  public get current(): QueryRowProxy {\n    return this._rowProxy as any;\n  }\n\n  /**\n   * Clear all bindings.\n   */\n  public resetBindings() {\n    this._param = new QueryBinder().serialize();\n    this._lockArgs = false;\n  }\n\n  /**\n   * Returns if there are more rows available.\n   *\n   * @returns `true` if all rows have been stepped through already.<br/>\n   *          `false` if there are any yet unaccessed rows.\n   */\n  public get done(): boolean {\n    return this._done;\n  }\n\n  /**\n   *\n   */\n  public getRowInternal(): any[] {\n    if (this._localRows.length <= this._localOffset)\n      throw new Error(\"no current row\");\n    return this._localRows[this._localOffset] as any[];\n  }\n\n  /**\n   * Get performance-related statistics for the current query.\n   */\n  public get stats(): QueryStats {\n    return this._stats;\n  }\n\n  /**\n   *\n   */\n  private async readRows(): Promise<any[]> {\n    if (this._globalDone) {\n      return [];\n    }\n    this._lockArgs = true;\n    this._globalOffset += this._localRows.length;\n    this._globalCount -= this._localRows.length;\n    if (this._globalCount === 0) {\n      return [];\n    }\n    const valueFormat = this._options.rowFormat === QueryRowFormat.UseJsPropertyNames ? DbValueFormat.JsNames : DbValueFormat.ECSqlNames;\n    const request: DbQueryRequest = {\n      ... this._options,\n      kind: DbRequestKind.ECSql,\n      valueFormat,\n      query: this.query,\n      args: this._param,\n    };\n    request.includeMetaData = this._props.length > 0 ? false : true;\n    request.limit = { offset: this._globalOffset, count: this._globalCount < 1 ? -1 : this._globalCount };\n    const resp = await this.runWithRetry(request);\n    this._globalDone = resp.status === DbResponseStatus.Done;\n    if (this._props.length === 0 && resp.meta.length > 0) {\n      this._props = new PropertyMetaDataMap(resp.meta);\n    }\n    for (const row of resp.data) {\n      ECSqlReader.replaceBase64WithUint8Array(row);\n    }\n    return resp.data;\n  }\n\n  /**\n   * @internal\n   */\n  protected async runWithRetry(request: DbQueryRequest) {\n    const needRetry = (rs: DbQueryResponse) => (rs.status === DbResponseStatus.Partial || rs.status === DbResponseStatus.QueueFull || rs.status === DbResponseStatus.Timeout) && (rs.data === undefined || rs.data.length === 0);\n    const updateStats = (rs: DbQueryResponse) => {\n      this._stats.backendCpuTime += rs.stats.cpuTime;\n      this._stats.backendTotalTime += rs.stats.totalTime;\n      this._stats.backendMemUsed += rs.stats.memUsed;\n      this._stats.backendRowsReturned += (rs.data === undefined) ? 0 : rs.data.length;\n    };\n    const execQuery = async (req: DbQueryRequest) => {\n      const startTime = Date.now();\n      const rs = await this._executor.execute(req);\n      this.stats.totalTime += (Date.now() - startTime);\n      return rs;\n    };\n    let retry = ECSqlReader._maxRetryCount;\n    let resp = await execQuery(request);\n    DbQueryError.throwIfError(resp, request);\n    while (--retry > 0 && needRetry(resp)) {\n      resp = await execQuery(request);\n      this._stats.retryCount += 1;\n      if (needRetry(resp)) {\n        updateStats(resp);\n      }\n    }\n    if (retry === 0 && needRetry(resp)) {\n      throw new Error(\"query too long to execute or server is too busy\");\n    }\n    updateStats(resp);\n    return resp;\n  }\n\n  /**\n   *\n   */\n  public formatCurrentRow(onlyReturnObject: boolean = false): any[] | object {\n    if (!onlyReturnObject && this._options.rowFormat === QueryRowFormat.UseECSqlPropertyIndexes) {\n      return this.getRowInternal();\n    }\n    const formattedRow = {};\n    for (const prop of this._props) {\n      const propName = this._options.rowFormat === QueryRowFormat.UseJsPropertyNames ? prop.jsonName : prop.name;\n      const val = this.getRowInternal()[prop.index];\n      if (typeof val !== \"undefined\" && val !== null) {\n        Object.defineProperty(formattedRow, propName, {\n          value: val,\n          enumerable: true,\n        });\n      }\n    }\n    return formattedRow;\n  }\n\n  /**\n   * Get the metadata for each column in the query result.\n   *\n   * @returns An array of [[QueryPropertyMetaData]].\n   */\n  public async getMetaData(): Promise<QueryPropertyMetaData[]> {\n    if (this._props.length === 0) {\n      await this.fetchRows();\n    }\n    return this._props.properties;\n  }\n\n  /**\n   *\n   */\n  private async fetchRows() {\n    this._localOffset = -1;\n    this._localRows = await this.readRows();\n    if (this._localRows.length === 0) {\n      this._done = true;\n    }\n  }\n\n  /**\n   * Step to the next row of the query result.\n   *\n   * @returns `true` if a row can be read from `current`.<br/>\n   *          `false` if there are no more rows; i.e., all rows have been stepped through already.\n   */\n  public async step(): Promise<boolean> {\n    if (this._done) {\n      return false;\n    }\n    const cachedRows = this._localRows.length;\n    if (this._localOffset < cachedRows - 1) {\n      ++this._localOffset;\n    } else {\n      await this.fetchRows();\n      this._localOffset = 0;\n      return !this._done;\n    }\n    return true;\n  }\n\n  /**\n   * Get all remaining rows from the query result.\n   *\n   * @returns An array of all remaining rows from the query result.\n   */\n  public async toArray(): Promise<any[]> {\n    const rows = [];\n    while (await this.step()) {\n      rows.push(this.formatCurrentRow());\n    }\n    return rows;\n  }\n\n  /**\n   * Accessor for using ECSqlReader as an asynchronous iterator.\n   *\n   * @returns An asynchronous iterator over the rows returned by the executed ECSQL query.\n   */\n  public [Symbol.asyncIterator](): AsyncIterableIterator<QueryRowProxy> {\n    return this;\n  }\n\n  /**\n   * Calls step when called as an iterator.\n   *\n   * Returns the row alongside a `done` boolean to indicate if there are any more rows for an iterator to step to.\n   *\n   * @returns An object with the keys: `value` which contains the row and `done` which contains a boolean.\n   */\n  public async next(): Promise<IteratorResult<QueryRowProxy, any>> {\n    if (await this.step()) {\n      return {\n        done: false,\n        value: this.current,\n      };\n    } else {\n      return {\n        done: true,\n        value: this.current,\n      };\n    }\n  }\n}\n\n"]}

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