@itwin/core-backend 3.4.0-dev.2 → 3.4.0-dev.20

package/lib/cjs/SQLiteDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"SQLiteDb.js","sourceRoot":"","sources":["../../src/SQLiteDb.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 SQLiteDb\r\n */\r\n\r\nimport { CloudSqlite, IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { DbResult, IDisposable, OpenMode } from \"@itwin/core-bentley\";\r\nimport { LocalFileName } from \"@itwin/core-common\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { SqliteStatement, StatementCache } from \"./SqliteStatement\";\r\n\r\n/* eslint-disable @typescript-eslint/unified-signatures */\r\n\r\n/** A SQLiteDb file\r\n * @public\r\n */\r\nexport class SQLiteDb implements IDisposable {\r\n  /** @internal */\r\n  public readonly nativeDb = new IModelHost.platform.SQLiteDb();\r\n  private _sqliteStatementCache = new StatementCache<SqliteStatement>();\r\n\r\n  /** @internal */\r\n  public static createCloudContainer(args: CloudSqlite.ContainerAccessProps): SQLiteDb.CloudContainer {\r\n    return new IModelHost.platform.CloudContainer(args);\r\n  }\r\n  /** @internal */\r\n  public static createCloudCache(args: CloudSqlite.CacheProps): SQLiteDb.CloudCache {\r\n    return new IModelHost.platform.CloudCache(args);\r\n  }\r\n  /** @internal */\r\n  public static startCloudPrefetch(container: SQLiteDb.CloudContainer, dbName: string, args?: CloudSqlite.PrefetchProps): SQLiteDb.CloudPrefetch {\r\n    return new IModelHost.platform.CloudPrefetch(container, dbName, args);\r\n  }\r\n  /** @internal */\r\n  public static createBlobIO(): SQLiteDb.BlobIO {\r\n    return new IModelHost.platform.BlobIO();\r\n  }\r\n\r\n  /** alias for closeDb. */\r\n  public dispose(): void {\r\n    this.closeDb();\r\n  }\r\n\r\n  /** Create a SQLiteDb\r\n   * @param dbName The path to the SQLiteDb file to create.\r\n   */\r\n  public createDb(dbName: string, container?: SQLiteDb.CloudContainer, params?: SQLiteDb.CreateParams): void {\r\n    this.nativeDb.createDb(dbName, container, params);\r\n  }\r\n\r\n  /** Open a SQLiteDb.\r\n   * @param dbName The path to the SQLiteDb file to open\r\n   */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams): void;\r\n  /**\r\n   * @param container optional CloudContainer holding database\r\n   * @internal\r\n   */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: SQLiteDb.CloudContainer): void;\r\n\r\n  /** @internal */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: SQLiteDb.CloudContainer): void {\r\n    this.nativeDb.openDb(dbName, openMode, container);\r\n  }\r\n\r\n  /** Close SQLiteDb.\r\n   * @param saveChanges if true, call `saveChanges` before closing db.\r\n   */\r\n  public closeDb(saveChanges?: boolean): void {\r\n    if (saveChanges && this.isOpen)\r\n      this.saveChanges();\r\n    this._sqliteStatementCache.clear();\r\n    this.nativeDb.closeDb();\r\n  }\r\n\r\n  /** Returns true if the SQLiteDb is open */\r\n  public get isOpen(): boolean { return this.nativeDb.isOpen(); }\r\n\r\n  /**\r\n   * 1. open a database\r\n   * 2. call a function supplying the open SQliteDb as argument. If it is async, await its return.\r\n   * 3. close the database (even if exceptions are thrown)\r\n   */\r\n  public static withOpenDb<T>(args: {\r\n    /** The name of the database to open */\r\n    dbName: string;\r\n    /** either an object with the open parameters or just OpenMode value. */\r\n    openMode?: OpenMode | SQLiteDb.OpenParams;\r\n    /** @internal */\r\n    container?: SQLiteDb.CloudContainer;\r\n  }, operation: (db: SQLiteDb) => T): T {\r\n    const db = new SQLiteDb();\r\n    db.openDb(args.dbName, args.openMode ?? OpenMode.Readonly, args.container);\r\n    let fromPromise = false;\r\n\r\n    try {\r\n      const result = operation(db);\r\n      if (result instanceof Promise) {\r\n        fromPromise = true;\r\n        const doClose = () => db.closeDb();\r\n        result.then(doClose, doClose);\r\n      }\r\n      return result;\r\n    } finally {\r\n      if (!fromPromise)\r\n        db.closeDb();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 1. acquire the write lock on a CloudContainer\r\n   * 2. open a ReadWrite database in the container\r\n   * 3. call a function with the opened database as an argument\r\n   * 4. close the database\r\n   * 5. release the write lock and upload changes.\r\n   * @internal\r\n   */\r\n  public static async withLockedContainer(\r\n    args: {\r\n      /** the name to be displayed in the event of lock collisions */\r\n      user: string;\r\n      /** the name of the database within the container */\r\n      dbName: string;\r\n      /** the CloudContainer on which the operation will be performed */\r\n      container: SQLiteDb.CloudContainer;\r\n      /** if present, function called when the write lock is currently held by another user. */\r\n      busyHandler?: CloudSqlite.WriteLockBusyHandler;\r\n    },\r\n    /** an asynchronous operation performed on the database with the write lock held. */\r\n    operation: (db: SQLiteDb) => Promise<void>) {\r\n    const fn = async () => SQLiteDb.withOpenDb({ ...args, openMode: OpenMode.ReadWrite }, operation);\r\n    await CloudSqlite.withWriteLock(args.user, args.container, fn, args.busyHandler);\r\n  }\r\n\r\n  /** vacuum this database\r\n   * @see https://www.sqlite.org/lang_vacuum.html\r\n   */\r\n  public vacuum(args?: {\r\n    /** new page size\r\n     * @see https://www.sqlite.org/pragma.html#pragma_page_size\r\n     */\r\n    pageSize?: number;\r\n    /** if present, name of new file to vacuum into */\r\n    into?: LocalFileName;\r\n  }) {\r\n    this.nativeDb.vacuum(args);\r\n  }\r\n\r\n  /** Commit the outermost transaction, writing changes to the file. Then, restart the transaction. */\r\n  public saveChanges(): void {\r\n    this.nativeDb.saveChanges();\r\n  }\r\n\r\n  /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the transaction. */\r\n  public abandonChanges(): void {\r\n    this.nativeDb.abandonChanges();\r\n  }\r\n\r\n  /**\r\n   * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist\r\n   * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved\r\n   * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be\r\n   * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding\r\n   * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].\r\n   * @param sql The SQLite SQL statement to execute\r\n   * @param callback the callback to invoke on the prepared statement\r\n   * @returns the value returned by `callback`.\r\n   */\r\n  public withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);\r\n    const release = () => this._sqliteStatementCache.addOrDispose(stmt);\r\n    try {\r\n      const val: T = callback(stmt);\r\n      if (val instanceof Promise) {\r\n        val.then(release, release);\r\n      } else {\r\n        release();\r\n      }\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.\r\n   * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.\r\n   * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].\r\n   * @param sql The SQLite SQL statement to execute\r\n   * @param callback the callback to invoke on the prepared statement\r\n   * @returns the value returned by `callback`.\r\n   */\r\n  public withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    const release = () => stmt.dispose();\r\n    try {\r\n      const val: T = callback(stmt);\r\n      if (val instanceof Promise) {\r\n        val.then(release, release);\r\n      } else {\r\n        release();\r\n      }\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /** Prepare an SQL statement.\r\n     * @param sql The SQLite SQL statement to prepare\r\n     * @param logErrors Determine if errors are logged or not\r\n     * @internal\r\n     */\r\n  public prepareSqliteStatement(sql: string, logErrors = true): SqliteStatement {\r\n    const stmt = new SqliteStatement(sql);\r\n    stmt.prepare(this.nativeDb, logErrors);\r\n    return stmt;\r\n  }\r\n\r\n  /** execute an SQL statement */\r\n  public executeSQL(sql: string): DbResult {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    try {\r\n      return stmt.step();\r\n    } finally {\r\n      stmt.dispose();\r\n    }\r\n  }\r\n}\r\n\r\n/** @public */\r\nexport namespace SQLiteDb {\r\n  /** A CloudSqlite container that may be connected to a CloudCache.\r\n   * @internal\r\n   */\r\n  export type CloudContainer = IModelJsNative.CloudContainer;\r\n  /** @internal */\r\n  export type CloudCache = IModelJsNative.CloudCache;\r\n  /** @internal */\r\n  export type CloudPrefetch = IModelJsNative.CloudPrefetch;\r\n  /** Incremental IO for blobs\r\n   * @internal\r\n   */\r\n  export type BlobIO = IModelJsNative.BlobIO;\r\n\r\n  /** Default transaction mode for SQLiteDbs.\r\n     * @see https://www.sqlite.org/lang_transaction.html\r\n    */\r\n  export enum DefaultTxnMode {\r\n    /** no default transaction is started. You must use BEGIN/COMMIT or SQLite will use implicit transactions */\r\n    None = 0,\r\n    /** A deferred transaction is started when the file is first opened. This is the default. */\r\n    Deferred = 1,\r\n    /** An immediate transaction is started when the file is first opened. */\r\n    Immediate = 2,\r\n    /** An exclusive transaction is started when the file is first opened. */\r\n    Exclusive = 3\r\n  }\r\n\r\n  /** parameters common to opening or creating a new SQLiteDb */\r\n  export interface OpenOrCreateParams {\r\n    /** If true, do not require that the `be_Prop` table exist */\r\n    rawSQLite?: boolean;\r\n    /** @see immutable option at https://www.sqlite.org/c3ref/open.html */\r\n    immutable?: boolean;\r\n    /** Do not attempt to verify that the file is a valid sQLite file before opening. */\r\n    skipFileCheck?: boolean;\r\n    /** the default transaction mode\r\n     * @see [[SQLiteDb.DefaultTxnMode]]\r\n    */\r\n    defaultTxn?: 0 | 1 | 2 | 3;\r\n    /** see query parameters from 'URI Filenames' in  https://www.sqlite.org/c3ref/open.html */\r\n    queryParam?: string;\r\n  }\r\n\r\n  /** Parameters for opening an existing SQLiteDb */\r\n  export interface OpenParams extends OpenOrCreateParams {\r\n    /** use OpenMode.ReadWrite to open the file with write access */\r\n    openMode: OpenMode;\r\n  }\r\n\r\n  /** Parameters for creating a new SQLiteDb */\r\n  export interface CreateParams extends OpenOrCreateParams {\r\n    /** see https://www.sqlite.org/pragma.html#pragma_page_size */\r\n    pageSize?: number;\r\n  }\r\n\r\n}\r\n"]}
+{"version":3,"file":"SQLiteDb.js","sourceRoot":"","sources":["../../src/SQLiteDb.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 SQLiteDb\r\n */\r\n\r\nimport { CloudSqlite, IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { DbResult, IDisposable, OpenMode } from \"@itwin/core-bentley\";\r\nimport { LocalFileName } from \"@itwin/core-common\";\r\nimport { IModelHost } from \"./IModelHost\";\r\nimport { SqliteStatement, StatementCache } from \"./SqliteStatement\";\r\n\r\n// cspell:ignore savepoint\r\n/* eslint-disable @typescript-eslint/unified-signatures */\r\n\r\n/** A SQLiteDb file\r\n * @public\r\n */\r\nexport class SQLiteDb implements IDisposable {\r\n  /** @internal */\r\n  public readonly nativeDb = new IModelHost.platform.SQLiteDb();\r\n  private _sqliteStatementCache = new StatementCache<SqliteStatement>();\r\n\r\n  /** @internal */\r\n  public static createCloudContainer(args: CloudSqlite.ContainerAccessProps): SQLiteDb.CloudContainer {\r\n    return new IModelHost.platform.CloudContainer(args);\r\n  }\r\n  /** @internal */\r\n  public static createCloudCache(args: CloudSqlite.CacheProps): SQLiteDb.CloudCache {\r\n    return new IModelHost.platform.CloudCache(args);\r\n  }\r\n  /** @internal */\r\n  public static startCloudPrefetch(container: SQLiteDb.CloudContainer, dbName: string, args?: CloudSqlite.PrefetchProps): SQLiteDb.CloudPrefetch {\r\n    return new IModelHost.platform.CloudPrefetch(container, dbName, args);\r\n  }\r\n  /** @internal */\r\n  public static createBlobIO(): SQLiteDb.BlobIO {\r\n    return new IModelHost.platform.BlobIO();\r\n  }\r\n\r\n  /** alias for closeDb. */\r\n  public dispose(): void {\r\n    this.closeDb();\r\n  }\r\n\r\n  /** Create a SQLiteDb\r\n   * @param dbName The path to the SQLiteDb file to create.\r\n   */\r\n  public createDb(dbName: string, container?: SQLiteDb.CloudContainer, params?: SQLiteDb.CreateParams): void {\r\n    this.nativeDb.createDb(dbName, container, params);\r\n  }\r\n\r\n  /** Open a SQLiteDb.\r\n   * @param dbName The path to the SQLiteDb file to open\r\n   */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams): void;\r\n  /**\r\n   * @param container optional CloudContainer holding database\r\n   * @internal\r\n   */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: SQLiteDb.CloudContainer): void;\r\n\r\n  /** @internal */\r\n  public openDb(dbName: string, openMode: OpenMode | SQLiteDb.OpenParams, container?: SQLiteDb.CloudContainer): void {\r\n    this.nativeDb.openDb(dbName, openMode, container);\r\n  }\r\n\r\n  /** Close SQLiteDb.\r\n   * @param saveChanges if true, call `saveChanges` before closing db. Otherwise unsaved changes are abandoned.\r\n   */\r\n  public closeDb(saveChanges?: boolean): void {\r\n    if (saveChanges && this.isOpen)\r\n      this.saveChanges();\r\n    this._sqliteStatementCache.clear();\r\n    this.nativeDb.closeDb();\r\n  }\r\n\r\n  /** Returns true if this SQLiteDb is open */\r\n  public get isOpen(): boolean { return this.nativeDb.isOpen(); }\r\n\r\n  /** Returns true if this SQLiteDb is open readonly */\r\n  public get isReadonly(): boolean { return this.nativeDb.isReadonly(); }\r\n\r\n  /**\r\n   * Open a database, perform an operation, then close the database.\r\n   *\r\n   * Details:\r\n   * - if database is open, throw an error\r\n   * - open a database\r\n   * - call a function with the database opened. If it is async, await its return.\r\n   * - if function throws, abandon all changes, close database, and rethrow\r\n   * - save all changes\r\n   * - close the database\r\n   * @return value from operation\r\n   */\r\n  public withOpenDb<T>(args: SQLiteDb.WithOpenDbArgs, operation: () => T): T {\r\n    if (this.isOpen)\r\n      throw new Error(\"database is already open\");\r\n\r\n    const save = () => this.closeDb(true), abandon = () => this.closeDb(false);\r\n    this.openDb(args.dbName, args.openMode ?? OpenMode.Readonly, args.container);\r\n    try {\r\n      const result = operation();\r\n      result instanceof Promise ? result.then(save, abandon) : save();\r\n      return result;\r\n    } catch (e) {\r\n      abandon();\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an operation on a database in a CloudContainer with the write lock held.\r\n   *\r\n   * Details:\r\n   * - acquire the write lock on a CloudContainer\r\n   * - call `withOpenDb` with openMode `ReadWrite`\r\n   * - upload changes\r\n   * - release the write lock\r\n   * @param args arguments to lock the container and open the database\r\n   * @param operation an operation performed on the database with the write lock held.\r\n   * @return value from operation\r\n   * @internal\r\n   */\r\n  public async withLockedContainer<T>(args: SQLiteDb.LockAndOpenArgs, operation: () => T) {\r\n    return CloudSqlite.withWriteLock(args.user, args.container, () => this.withOpenDb({ ...args, openMode: OpenMode.ReadWrite }, operation), args.busyHandler);\r\n  }\r\n\r\n  /** vacuum this database\r\n   * @see https://www.sqlite.org/lang_vacuum.html\r\n   */\r\n  public vacuum(args?: SQLiteDb.VacuumDbArgs) {\r\n    this.nativeDb.vacuum(args);\r\n  }\r\n\r\n  /** Commit the outermost transaction, writing changes to the file. Then, restart the transaction. */\r\n  public saveChanges(): void {\r\n    this.nativeDb.saveChanges();\r\n  }\r\n\r\n  /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the transaction. */\r\n  public abandonChanges(): void {\r\n    this.nativeDb.abandonChanges();\r\n  }\r\n\r\n  /**\r\n   * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist\r\n   * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved\r\n   * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be\r\n   * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding\r\n   * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].\r\n   * @param sql The SQLite SQL statement to execute\r\n   * @param callback the callback to invoke on the prepared statement\r\n   * @returns the value returned by `callback`.\r\n   */\r\n  public withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);\r\n    const release = () => this._sqliteStatementCache.addOrDispose(stmt);\r\n    try {\r\n      const val = callback(stmt);\r\n      val instanceof Promise ? val.then(release, release) : release();\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.\r\n   * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.\r\n   * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].\r\n   * @param sql The SQLite SQL statement to execute\r\n   * @param callback the callback to invoke on the prepared statement\r\n   * @returns the value returned by `callback`.\r\n   */\r\n  public withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T): T {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    const release = () => stmt.dispose();\r\n    try {\r\n      const val = callback(stmt);\r\n      val instanceof Promise ? val.then(release, release) : release();\r\n      return val;\r\n    } catch (err) {\r\n      release();\r\n      throw err;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an operation on this database within a [savepoint](https://www.sqlite.org/lang_savepoint.html). If the operation completes successfully, the\r\n   * changes remain in the current transaction. If the operation throws an exception, the savepoint is rolled back\r\n   * and all changes to the database from this method are reversed, leaving the transaction exactly as it was before this method.\r\n   */\r\n  public withSavePoint(savePointName: string, operation: () => void) {\r\n    if (this.isReadonly)\r\n      throw new Error(\"database is readonly\");\r\n\r\n    this.executeSQL(`SAVEPOINT ${savePointName}`);\r\n    try {\r\n      operation();\r\n      this.executeSQL(`RELEASE ${savePointName}`);\r\n    } catch (e) {\r\n      this.executeSQL(`ROLLBACK TO ${savePointName}`);\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  /** Prepare an SQL statement.\r\n     * @param sql The SQLite SQL statement to prepare\r\n     * @param logErrors Determine if errors are logged or not\r\n     * @internal\r\n     */\r\n  public prepareSqliteStatement(sql: string, logErrors = true): SqliteStatement {\r\n    const stmt = new SqliteStatement(sql);\r\n    stmt.prepare(this.nativeDb, logErrors);\r\n    return stmt;\r\n  }\r\n\r\n  /** execute an SQL statement */\r\n  public executeSQL(sql: string): DbResult {\r\n    const stmt = this.prepareSqliteStatement(sql);\r\n    try {\r\n      return stmt.step();\r\n    } finally {\r\n      stmt.dispose();\r\n    }\r\n  }\r\n}\r\n\r\n/** @public */\r\nexport namespace SQLiteDb {\r\n  /** A CloudSqlite container that may be connected to a CloudCache.\r\n   * @internal\r\n   */\r\n  export type CloudContainer = IModelJsNative.CloudContainer;\r\n  /** @internal */\r\n  export type CloudCache = IModelJsNative.CloudCache;\r\n  /** @internal */\r\n  export type CloudPrefetch = IModelJsNative.CloudPrefetch;\r\n  /** Incremental IO for blobs\r\n   * @internal\r\n   */\r\n  export type BlobIO = IModelJsNative.BlobIO;\r\n\r\n  /** Default transaction mode for SQLiteDbs.\r\n     * @see https://www.sqlite.org/lang_transaction.html\r\n    */\r\n  export enum DefaultTxnMode {\r\n    /** no default transaction is started. You must use BEGIN/COMMIT or SQLite will use implicit transactions */\r\n    None = 0,\r\n    /** A deferred transaction is started when the file is first opened. This is the default. */\r\n    Deferred = 1,\r\n    /** An immediate transaction is started when the file is first opened. */\r\n    Immediate = 2,\r\n    /** An exclusive transaction is started when the file is first opened. */\r\n    Exclusive = 3\r\n  }\r\n\r\n  /** parameters common to opening or creating a new SQLiteDb */\r\n  export interface OpenOrCreateParams {\r\n    /** If true, do not require that the `be_Prop` table exist */\r\n    rawSQLite?: boolean;\r\n    /** @see immutable option at https://www.sqlite.org/c3ref/open.html */\r\n    immutable?: boolean;\r\n    /** Do not attempt to verify that the file is a valid sQLite file before opening. */\r\n    skipFileCheck?: boolean;\r\n    /** the default transaction mode\r\n     * @see [[SQLiteDb.DefaultTxnMode]]\r\n    */\r\n    defaultTxn?: 0 | 1 | 2 | 3;\r\n    /** see query parameters from 'URI Filenames' in  https://www.sqlite.org/c3ref/open.html */\r\n    queryParam?: string;\r\n  }\r\n\r\n  /** Parameters for opening an existing SQLiteDb */\r\n  export interface OpenParams extends OpenOrCreateParams {\r\n    /** use OpenMode.ReadWrite to open the file with write access */\r\n    openMode: OpenMode;\r\n  }\r\n\r\n  /** Size of a SQLiteDb page in bytes */\r\n  export interface PageSize {\r\n    /** see https://www.sqlite.org/pragma.html#pragma_page_size */\r\n    pageSize?: number;\r\n  }\r\n\r\n  /** Parameters for creating a new SQLiteDb */\r\n  export type CreateParams = OpenOrCreateParams & PageSize;\r\n\r\n  /** @internal */\r\n  export interface LockAndOpenArgs {\r\n    /** the name to be displayed in the event of lock collisions */\r\n    user: string;\r\n    /** the name of the database within the container */\r\n    dbName: string;\r\n    /** the CloudContainer on which the operation will be performed */\r\n    container: SQLiteDb.CloudContainer;\r\n    /** if present, function called when the write lock is currently held by another user. */\r\n    busyHandler?: CloudSqlite.WriteLockBusyHandler;\r\n  }\r\n\r\n  /** Arguments for `SqliteDb.withOpenDb` */\r\n  export interface WithOpenDbArgs {\r\n    /** The name of the database to open */\r\n    dbName: string;\r\n    /** either an object with the open parameters or just OpenMode value. */\r\n    openMode?: OpenMode | SQLiteDb.OpenParams;\r\n    /** @internal */\r\n    container?: SQLiteDb.CloudContainer;\r\n  }\r\n\r\n  /** Arguments for `SQLiteDb.vacuum` */\r\n  export interface VacuumDbArgs extends PageSize {\r\n    /** if present, name of new file to [vacuum into](https://www.sqlite.org/lang_vacuum.html) */\r\n    into?: LocalFileName;\r\n  }\r\n}\r\n"]}

package/lib/cjs/SqliteStatement.d.ts

@@ -40,8 +40,9 @@ export declare type BindParameter = number | string;
 export declare class SqliteStatement implements IterableIterator<any>, IDisposable {
     private _sql;
     private _stmt;
+    private _db;
     constructor(_sql: string);
-    get stmt(): IModelJsNative.SqliteStatement | undefined;
+    get stmt(): IModelJsNative.SqliteStatement;
     get sql(): string;
     /** Check if this statement has been prepared successfully or not */
     get isPrepared(): boolean;
@@ -52,7 +53,7 @@ export declare class SqliteStatement implements IterableIterator<any>, IDisposab
      * @throws if the SQL statement cannot be prepared. Normally, prepare fails due to SQL syntax errors or references to tables or properties that do not exist.
      * The error.message property will provide details.
      */
-    prepare(db: IModelJsNative.DgnDb | IModelJsNative.ECDb | IModelJsNative.SQLiteDb, logErrors?: boolean): void;
+    prepare(db: IModelJsNative.AnyDb, logErrors?: boolean): void;
     /** Indicates whether the prepared statement makes no **direct* changes to the content of the file
      * or not. See [SQLite docs](https://www.sqlite.org/c3ref/stmt_readonly.html) for details.
      */
@@ -62,6 +63,13 @@ export declare class SqliteStatement implements IterableIterator<any>, IDisposab
     reset(): void;
     /** Call this function when finished with this statement. This releases the native resources held by the statement. */
     dispose(): void;
+    /**
+     * Call `step` on this statement and determine whether a new row is available.
+     * Use this method only when this statement has been prepared with a SELECT statement.
+     * @return true if a new row is available, false otherwise.
+     * @throws if `step` returns anything other than BE_SQLITE_ROW or BE_SQLITE_DONE.
+     */
+    nextRow(): boolean;
     /** Binds a value to the specified SQL parameter.
      *  The value must be of one of these types:
      *  JavaScript Type | SQLite Type
@@ -145,6 +153,10 @@ export declare class SqliteStatement implements IterableIterator<any>, IDisposab
      * @param columnIx Index of SQL column in query result (0-based)
      */
     getValue(columnIx: number): SqliteValue;
+    /** Determine whether the value of the specified column is null
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    isValueNull(colIndex: number): boolean;
     /** Get a size in bytes of a blob or text column
      * @param colIndex Index of SQL column in query result (0-based)
      */

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

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

package/lib/cjs/SqliteStatement.js

@@ -50,6 +50,7 @@ class SqliteStatement {
     prepare(db, logErrors = true) {
         if (this.isPrepared)
             throw new Error("SqliteStatement is already prepared");
+        this._db = db;
         this._stmt = new IModelHost_1.IModelHost.platform.SqliteStatement();
         this._stmt.prepare(db, this._sql, logErrors);
     }
@@ -57,20 +58,37 @@ class SqliteStatement {
      * or not. See [SQLite docs](https://www.sqlite.org/c3ref/stmt_readonly.html) for details.
      */
     get isReadonly() {
-        return this._stmt.isReadonly();
+        return this.stmt.isReadonly();
     }
     /** Reset this statement so that the next call to step will return the first row, if any.
      */
     reset() {
-        this._stmt.reset();
+        this.stmt.reset();
     }
     /** Call this function when finished with this statement. This releases the native resources held by the statement. */
     dispose() {
         if (this._stmt) {
             this._stmt.dispose(); // free native statement
             this._stmt = undefined;
+            this._db = undefined;
         }
     }
+    /**
+     * Call `step` on this statement and determine whether a new row is available.
+     * Use this method only when this statement has been prepared with a SELECT statement.
+     * @return true if a new row is available, false otherwise.
+     * @throws if `step` returns anything other than BE_SQLITE_ROW or BE_SQLITE_DONE.
+     */
+    nextRow() {
+        const rc = this.step();
+        switch (rc) {
+            case core_bentley_1.DbResult.BE_SQLITE_ROW:
+                return true;
+            case core_bentley_1.DbResult.BE_SQLITE_DONE:
+                return false;
+        }
+        throw new core_bentley_1.BentleyError(rc, this._db.getLastError());
+    }
     /** Binds a value to the specified SQL parameter.
      *  The value must be of one of these types:
      *  JavaScript Type | SQLite Type
@@ -91,28 +109,28 @@ class SqliteStatement {
     bindValue(parameter, value) {
         let stat;
         if (value === undefined || value === null) {
-            stat = this._stmt.bindNull(parameter);
+            stat = this.stmt.bindNull(parameter);
         }
         else if (typeof (value) === "number") {
             if (Number.isInteger(value))
-                stat = this._stmt.bindInteger(parameter, value);
+                stat = this.stmt.bindInteger(parameter, value);
             else
-                stat = this._stmt.bindDouble(parameter, value);
+                stat = this.stmt.bindDouble(parameter, value);
         }
         else if (typeof (value) === "boolean") {
-            stat = this._stmt.bindInteger(parameter, value ? 1 : 0);
+            stat = this.stmt.bindInteger(parameter, value ? 1 : 0);
         }
         else if (typeof (value) === "string") {
-            stat = this._stmt.bindString(parameter, value);
+            stat = this.stmt.bindString(parameter, value);
         }
         else if (!!value.id) {
-            stat = this._stmt.bindId(parameter, value.id);
+            stat = this.stmt.bindId(parameter, value.id);
         }
         else if (!!value.guid) {
-            stat = this._stmt.bindGuid(parameter, value.guid);
+            stat = this.stmt.bindGuid(parameter, value.guid);
         }
         else if (value instanceof Uint8Array) {
-            stat = this._stmt.bindBlob(parameter, value);
+            stat = this.stmt.bindBlob(parameter, value);
         }
         else
             throw new core_common_1.IModelError(core_bentley_1.DbResult.BE_SQLITE_ERROR, `Parameter value ${value} is of an unsupported data type.`);
@@ -128,48 +146,48 @@ class SqliteStatement {
      *  @param val integer to bind.
      */
     bindInteger(parameter, val) {
-        this.checkBind(this._stmt.bindInteger(parameter, val));
+        this.checkBind(this.stmt.bindInteger(parameter, val));
     }
     /** Bind a double parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val double to bind.
      */
     bindDouble(parameter, val) {
-        this.checkBind(this._stmt.bindDouble(parameter, val));
+        this.checkBind(this.stmt.bindDouble(parameter, val));
     }
     /** Bind a string parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val string to bind.
      */
     bindString(parameter, val) {
-        this.checkBind(this._stmt.bindString(parameter, val));
+        this.checkBind(this.stmt.bindString(parameter, val));
     }
     /** Bind an Id64String parameter as a 64-bit integer
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val Id to bind.
      */
     bindId(parameter, id) {
-        this.checkBind(this._stmt.bindId(parameter, id));
+        this.checkBind(this.stmt.bindId(parameter, id));
     }
     /** Bind a Guid parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val Guid to bind.
      */
     bindGuid(parameter, guid) {
-        this.checkBind(this._stmt.bindGuid(parameter, guid));
+        this.checkBind(this.stmt.bindGuid(parameter, guid));
     }
     /** Bind a blob parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      *  @param val blob to bind.
      */
     bindBlob(parameter, blob) {
-        this.checkBind(this._stmt.bindBlob(parameter, blob));
+        this.checkBind(this.stmt.bindBlob(parameter, blob));
     }
     /** Bind null to a parameter
      *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')
      */
     bindNull(parameter) {
-        this.checkBind(this._stmt.bindNull(parameter));
+        this.checkBind(this.stmt.bindNull(parameter));
     }
     /** Bind values to all parameters in the statement.
      * @param values The values to bind to the parameters.
@@ -201,7 +219,7 @@ class SqliteStatement {
      * @throws [IModelError]($common) in case of errors
      */
     clearBindings() {
-        const stat = this._stmt.clearBindings();
+        const stat = this.stmt.clearBindings();
         if (stat !== core_bentley_1.DbResult.BE_SQLITE_OK)
             throw new core_common_1.IModelError(stat, "Error in clearBindings");
     }
@@ -216,41 +234,45 @@ class SqliteStatement {
      *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has been executed successfully.
      *  - Error status in case of errors.
      */
-    step() { return this._stmt.step(); }
+    step() { return this.stmt.step(); }
     /** Get the query result's column count (only for SQL SELECT statements). */
-    getColumnCount() { return this._stmt.getColumnCount(); }
+    getColumnCount() { return this.stmt.getColumnCount(); }
     /** Get the value for the column at the given index in the query result.
      * @param columnIx Index of SQL column in query result (0-based)
      */
-    getValue(columnIx) { return new SqliteValue(this._stmt, columnIx); }
+    getValue(columnIx) { return new SqliteValue(this.stmt, columnIx); }
+    /** Determine whether the value of the specified column is null
+     * @param colIndex Index of SQL column in query result (0-based)
+     */
+    isValueNull(colIndex) { return this.stmt.isValueNull(colIndex); }
     /** Get a size in bytes of a blob or text column
      * @param colIndex Index of SQL column in query result (0-based)
      */
-    getColumnBytes(colIndex) { return this._stmt.getColumnBytes(colIndex); }
+    getColumnBytes(colIndex) { return this.stmt.getColumnBytes(colIndex); }
     /** Get a value as a blob
      * @param colIndex Index of SQL column in query result (0-based)
      */
-    getValueBlob(colIndex) { return this._stmt.getValueBlob(colIndex); }
+    getValueBlob(colIndex) { return this.stmt.getValueBlob(colIndex); }
     /** Get a value as a double
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueDouble(colIndex) { return this._stmt.getValueDouble(colIndex); }
+    getValueDouble(colIndex) { return this.stmt.getValueDouble(colIndex); }
     /** Get a value as a integer
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueInteger(colIndex) { return this._stmt.getValueInteger(colIndex); }
+    getValueInteger(colIndex) { return this.stmt.getValueInteger(colIndex); }
     /** Get a value as a string
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueString(colIndex) { return this._stmt.getValueString(colIndex); }
+    getValueString(colIndex) { return this.stmt.getValueString(colIndex); }
     /** Get a value as an Id
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueId(colIndex) { return this._stmt.getValueId(colIndex); }
+    getValueId(colIndex) { return this.stmt.getValueId(colIndex); }
     /** Get a value as a Guid
     * @param colIndex Index of SQL column in query result (0-based)
     */
-    getValueGuid(colIndex) { return this._stmt.getValueGuid(colIndex); }
+    getValueGuid(colIndex) { return this.stmt.getValueGuid(colIndex); }
     /** Get the current row.
      * The returned row is formatted as JavaScript object where every SELECT clause item becomes a property in the JavaScript object.
      *

package/lib/cjs/SqliteStatement.js.map

@@ -1 +1 @@
-{"version":3,"file":"SqliteStatement.js","sourceRoot":"","sources":["../../src/SqliteStatement.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 SQLite\r\n */\r\n\r\nimport { assert, DbResult, GuidString, Id64String, IDisposable, LRUMap } from \"@itwin/core-bentley\";\r\nimport { ECJsNames, IModelError } from \"@itwin/core-common\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/* eslint-disable @typescript-eslint/no-non-null-assertion */\r\n\r\n/** Marks a string as either an [Id64String]($core-bentley) or [GuidString]($core-bentley), so\r\n * that it can be passed to the [bindValue]($backend.SqliteStatement) or [bindValues]($backend.SqliteStatement)\r\n * methods of [SqliteStatement]($backend).\r\n * @internal\r\n */\r\nexport interface StringParam {\r\n  id?: Id64String;\r\n  guid?: GuidString;\r\n}\r\n\r\n/** parameter Index (1-based), or name of the parameter (including the initial ':', '@' or '$')\r\n * @public\r\n */\r\nexport type BindParameter = number | string;\r\n\r\n/** Executes SQLite SQL statements.\r\n *\r\n * A statement must be prepared before it can be executed, and it must be released when no longer needed.\r\n * See [IModelDb.withPreparedSqliteStatement]($backend) or\r\n * [ECDb.withPreparedSqliteStatement]($backend) for a convenient and\r\n * reliable way to prepare, execute, and then release a statement.\r\n *\r\n * A statement may contain parameters that must be filled in before use by calling [SqliteStatement.bindValue]($backend)\r\n * or [SqliteStatement.bindValues]($backend).\r\n *\r\n * Once prepared (and parameters are bound, if any), the statement is executed by calling [SqliteStatement.step]($backend).\r\n * In case of an **SQL SELECT** statement, the current row can be retrieved with [SqliteStatement.getRow]($backend) as\r\n * a whole, or with [SqliteStatement.getValue]($backend) when individual values are needed.\r\n * Alternatively, query results of an **SQL SELECT** statement can be stepped through by using\r\n * standard iteration syntax, such as `for of`.\r\n *\r\n * > Preparing a statement can be time-consuming. The best way to reduce the effect of this overhead is to cache and reuse prepared\r\n * > statements. A cached prepared statement may be used in different places in an app, as long as the statement is general enough.\r\n * > The key to making this strategy work is to phrase a statement in a general way and use placeholders to represent parameters that will vary on each use.\r\n * @public\r\n */\r\nexport class SqliteStatement implements IterableIterator<any>, IDisposable {\r\n  private _stmt: IModelJsNative.SqliteStatement | undefined;\r\n\r\n  public constructor(private _sql: string) { }\r\n  public get stmt() { return this._stmt; }\r\n  public get sql() { return this._sql; }\r\n\r\n  /** Check if this statement has been prepared successfully or not */\r\n  public get isPrepared(): boolean { return undefined !== this._stmt; }\r\n\r\n  /** Prepare this statement prior to first use.\r\n   * @param db The DgnDb or ECDb to prepare the statement against\r\n   * @param sql The SQL statement string to prepare\r\n   * @param logErrors Determine if errors are logged or not\r\n   * @throws if the SQL statement cannot be prepared. Normally, prepare fails due to SQL syntax errors or references to tables or properties that do not exist.\r\n   * The error.message property will provide details.\r\n   */\r\n  public prepare(db: IModelJsNative.DgnDb | IModelJsNative.ECDb | IModelJsNative.SQLiteDb, logErrors = true): void {\r\n    if (this.isPrepared)\r\n      throw new Error(\"SqliteStatement is already prepared\");\r\n    this._stmt = new IModelHost.platform.SqliteStatement();\r\n    this._stmt.prepare(db, this._sql, logErrors);\r\n  }\r\n\r\n  /** Indicates whether the prepared statement makes no **direct* changes to the content of the file\r\n   * or not. See [SQLite docs](https://www.sqlite.org/c3ref/stmt_readonly.html) for details.\r\n   */\r\n  public get isReadonly(): boolean {\r\n    return this._stmt!.isReadonly();\r\n  }\r\n\r\n  /** Reset this statement so that the next call to step will return the first row, if any.\r\n   */\r\n  public reset(): void {\r\n    this._stmt!.reset();\r\n  }\r\n\r\n  /** Call this function when finished with this statement. This releases the native resources held by the statement. */\r\n  public dispose(): void {\r\n    if (this._stmt) {\r\n      this._stmt.dispose(); // free native statement\r\n      this._stmt = undefined;\r\n    }\r\n  }\r\n\r\n  /** Binds a value to the specified SQL parameter.\r\n   *  The value must be of one of these types:\r\n   *  JavaScript Type | SQLite Type\r\n   *  --- | ---\r\n   *  undefined | NULL\r\n   *  boolean | INTEGER with true being bound as 1 and false as 0\r\n   *  number | INTEGER if number is integral or REAL if number is not integral\r\n   *  string | TEXT\r\n   *  Uint8Array or ArrayBuffer | BLOB\r\n   *  [StringParam]($backend) where member **id** is set | INTEGER\r\n   *  [StringParam]($backend) where member **guid** is set | BLOB\r\n   *\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param value Value to bind.\r\n   *  @throws [IModelError]($common) if the value is of an unsupported type or in\r\n   *  case of other binding errors.\r\n   */\r\n  public bindValue(parameter: BindParameter, value: any): void {\r\n    let stat: DbResult;\r\n    if (value === undefined || value === null) {\r\n      stat = this._stmt!.bindNull(parameter);\r\n    } else if (typeof (value) === \"number\") {\r\n      if (Number.isInteger(value))\r\n        stat = this._stmt!.bindInteger(parameter, value);\r\n      else\r\n        stat = this._stmt!.bindDouble(parameter, value);\r\n    } else if (typeof (value) === \"boolean\") {\r\n      stat = this._stmt!.bindInteger(parameter, value ? 1 : 0);\r\n    } else if (typeof (value) === \"string\") {\r\n      stat = this._stmt!.bindString(parameter, value);\r\n    } else if (!!value.id) {\r\n      stat = this._stmt!.bindId(parameter, value.id);\r\n    } else if (!!value.guid) {\r\n      stat = this._stmt!.bindGuid(parameter, value.guid);\r\n    } else if (value instanceof Uint8Array) {\r\n      stat = this._stmt!.bindBlob(parameter, value);\r\n    } else\r\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, `Parameter value ${value} is of an unsupported data type.`);\r\n\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"Error in bindValue\");\r\n  }\r\n\r\n  private checkBind(stat: DbResult) {\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"SQLite Bind error\");\r\n  }\r\n  /** Bind an integer parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val integer to bind.\r\n   */\r\n  public bindInteger(parameter: BindParameter, val: number) {\r\n    this.checkBind(this._stmt!.bindInteger(parameter, val));\r\n  }\r\n  /** Bind a double parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val double to bind.\r\n   */\r\n  public bindDouble(parameter: BindParameter, val: number) {\r\n    this.checkBind(this._stmt!.bindDouble(parameter, val));\r\n  }\r\n  /** Bind a string parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val string to bind.\r\n   */\r\n  public bindString(parameter: BindParameter, val: string) {\r\n    this.checkBind(this._stmt!.bindString(parameter, val));\r\n  }\r\n  /** Bind an Id64String parameter as a 64-bit integer\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val Id to bind.\r\n   */\r\n  public bindId(parameter: BindParameter, id: Id64String) {\r\n    this.checkBind(this._stmt!.bindId(parameter, id));\r\n  }\r\n  /** Bind a Guid parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val Guid to bind.\r\n   */\r\n  public bindGuid(parameter: BindParameter, guid: GuidString) {\r\n    this.checkBind(this._stmt!.bindGuid(parameter, guid));\r\n  }\r\n  /** Bind a blob parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val blob to bind.\r\n   */\r\n  public bindBlob(parameter: BindParameter, blob: Uint8Array) {\r\n    this.checkBind(this._stmt!.bindBlob(parameter, blob));\r\n  }\r\n  /** Bind null to a parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   */\r\n  public bindNull(parameter: BindParameter) {\r\n    this.checkBind(this._stmt!.bindNull(parameter));\r\n  }\r\n\r\n  /** Bind values to all parameters in the statement.\r\n   * @param values The values to bind to the parameters.\r\n   * Pass an *array* of values if the parameters are *positional*.\r\n   * Pass an *object of the values keyed on the parameter name* for *named parameters*.\r\n   * The values in either the array or object must match the respective types of the parameter.\r\n   * See [[SqliteStatement.bindValue]] for details on the supported types.\r\n   */\r\n  public bindValues(values: any[] | object): void {\r\n    if (Array.isArray(values)) {\r\n      for (let i = 0; i < values.length; i++) {\r\n        const paramIndex: number = i + 1;\r\n        const paramValue: any = values[i];\r\n        if (paramValue === undefined || paramValue === null)\r\n          continue;\r\n\r\n        this.bindValue(paramIndex, paramValue);\r\n      }\r\n      return;\r\n    }\r\n\r\n    for (const entry of Object.entries(values)) {\r\n      const paramName: string = entry[0];\r\n      const paramValue: any = entry[1];\r\n      if (paramValue === undefined || paramValue === null)\r\n        continue;\r\n\r\n      this.bindValue(paramName, paramValue);\r\n    }\r\n  }\r\n\r\n  /** Clear any bindings that were previously set on this statement.\r\n   * @throws [IModelError]($common) in case of errors\r\n   */\r\n  public clearBindings(): void {\r\n    const stat = this._stmt!.clearBindings();\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"Error in clearBindings\");\r\n  }\r\n\r\n  /** Step this statement to the next row.\r\n   *\r\n   *  For **SQL SELECT** statements the method returns\r\n   *  - [DbResult.BE_SQLITE_ROW]($core-bentley) if the statement now points successfully to the next row.\r\n   *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has no more rows.\r\n   *  - Error status in case of errors.\r\n   *\r\n   *  For **SQL INSERT, UPDATE, DELETE** statements the method returns\r\n   *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has been executed successfully.\r\n   *  - Error status in case of errors.\r\n   */\r\n  public step(): DbResult { return this._stmt!.step(); }\r\n\r\n  /** Get the query result's column count (only for SQL SELECT statements). */\r\n  public getColumnCount(): number { return this._stmt!.getColumnCount(); }\r\n\r\n  /** Get the value for the column at the given index in the query result.\r\n   * @param columnIx Index of SQL column in query result (0-based)\r\n   */\r\n  public getValue(columnIx: number): SqliteValue { return new SqliteValue(this._stmt!, columnIx); }\r\n\r\n  /** Get a size in bytes of a blob or text column\r\n   * @param colIndex Index of SQL column in query result (0-based)\r\n   */\r\n  public getColumnBytes(colIndex: number): number { return this._stmt!.getColumnBytes(colIndex); }\r\n\r\n  /** Get a value as a blob\r\n   * @param colIndex Index of SQL column in query result (0-based)\r\n   */\r\n  public getValueBlob(colIndex: number): Uint8Array { return this._stmt!.getValueBlob(colIndex); }\r\n  /** Get a value as a double\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueDouble(colIndex: number): number { return this._stmt!.getValueDouble(colIndex); }\r\n  /** Get a value as a integer\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueInteger(colIndex: number): number { return this._stmt!.getValueInteger(colIndex); }\r\n  /** Get a value as a string\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueString(colIndex: number): string { return this._stmt!.getValueString(colIndex); }\r\n  /** Get a value as an Id\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueId(colIndex: number): Id64String { return this._stmt!.getValueId(colIndex); }\r\n  /** Get a value as a Guid\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueGuid(colIndex: number): GuidString { return this._stmt!.getValueGuid(colIndex); }\r\n\r\n  /** Get the current row.\r\n   * The returned row is formatted as JavaScript object where every SELECT clause item becomes a property in the JavaScript object.\r\n   *\r\n   * The SQL select clause item's name becomes the member name of the JavaScript object, **with the first character lowered**.\r\n   *\r\n   * SQLite Type | JavaScript Type\r\n   * --- | ---\r\n   * [SqliteValueType.Null]($backend) | undefined\r\n   * [SqliteValueType.Integer]($backend) | number\r\n   * [SqliteValueType.Double]($backend) | number\r\n   * [SqliteValueType.String]($backend) | string\r\n   * [SqliteValueType.Blob]($backend) | Uint8Array\r\n   */\r\n  public getRow(): any {\r\n    const colCount = this.getColumnCount();\r\n    const row: object = {};\r\n    const duplicatePropNames = new Map<string, number>();\r\n    for (let i = 0; i < colCount; i++) {\r\n      const sqliteValue = this.getValue(i);\r\n      if (!sqliteValue.isNull) {\r\n        const propName: string = SqliteStatement.determineResultRowPropertyName(duplicatePropNames, sqliteValue);\r\n        let val: any;\r\n        switch (sqliteValue.type) {\r\n          case SqliteValueType.Blob:\r\n            val = sqliteValue.getBlob();\r\n            break;\r\n          case SqliteValueType.Double:\r\n            val = sqliteValue.getDouble();\r\n            break;\r\n          case SqliteValueType.Integer:\r\n            val = sqliteValue.getInteger();\r\n            break;\r\n          case SqliteValueType.String:\r\n            val = sqliteValue.getString();\r\n            break;\r\n\r\n          default:\r\n            throw new Error(\"Unsupported SqliteValueType\");\r\n        }\r\n\r\n        Object.defineProperty(row, propName, { enumerable: true, configurable: true, writable: true, value: val });\r\n      }\r\n    }\r\n    return row;\r\n  }\r\n\r\n  private static determineResultRowPropertyName(duplicatePropNames: Map<string, number>, sqliteValue: SqliteValue): string {\r\n    let jsName = ECJsNames.toJsName(sqliteValue.columnName);\r\n\r\n    // now check duplicates. If there are, append a numeric suffix to the duplicates\r\n    let suffix = duplicatePropNames.get(jsName);\r\n    if (suffix === undefined)\r\n      duplicatePropNames.set(jsName, 0);\r\n    else {\r\n      suffix++;\r\n      duplicatePropNames.set(jsName, suffix);\r\n      jsName += `_${suffix}`;\r\n    }\r\n\r\n    return jsName;\r\n  }\r\n\r\n  /** Calls step when called as an iterator.\r\n   */\r\n  public next(): IteratorResult<any> {\r\n    return DbResult.BE_SQLITE_ROW === this.step() ? { done: false, value: this.getRow() } : { done: true, value: undefined };\r\n  }\r\n\r\n  /** The iterator that will step through the results of this statement. */\r\n  public [Symbol.iterator](): IterableIterator<any> { return this; }\r\n}\r\n\r\n/** Data type of a value in in an SQLite SQL query result.\r\n * See also:\r\n * - [SqliteValue]($backend)\r\n * - [SqliteStatement]($backend)\r\n * - [SqliteStatement.getValue]($backend)\r\n * @public\r\n */\r\nexport enum SqliteValueType {\r\n  // do not change the values of that enum. It must correspond to the respective\r\n  // enum DbValueType in the native BeSQLite API.\r\n  Integer = 1,\r\n  Double = 2,\r\n  String = 3,\r\n  Blob = 4,\r\n  Null = 5,\r\n}\r\n\r\n/** Value of a column in a row of an SQLite SQL query result.\r\n * See also:\r\n * - [SqliteStatement]($backend)\r\n * - [SqliteStatement.getValue]($backend)\r\n * @public\r\n */\r\nexport class SqliteValue {\r\n  private readonly _stmt: IModelJsNative.SqliteStatement;\r\n  private readonly _colIndex: number;\r\n\r\n  public constructor(stmt: IModelJsNative.SqliteStatement, colIndex: number) {\r\n    this._stmt = stmt;\r\n    this._colIndex = colIndex;\r\n  }\r\n\r\n  /** Indicates whether the value is NULL or not. */\r\n  public get isNull(): boolean { return this._stmt.isValueNull(this._colIndex); }\r\n\r\n  /** Gets the data type of the value. */\r\n  public get type(): SqliteValueType { return this._stmt.getColumnType(this._colIndex); }\r\n\r\n  /** Gets the name of the column of the value. */\r\n  public get columnName(): string { return this._stmt.getColumnName(this._colIndex); }\r\n\r\n  /** Gets the SqlValue as JavaScript value.\r\n   *\r\n   * SQLite Type | JavaScript Type\r\n   * --- | ---\r\n   * [SqliteValueType.Null]($backend) | undefined\r\n   * [SqliteValueType.Integer]($backend) | number\r\n   * [SqliteValueType.Double]($backend) | number\r\n   * [SqliteValueType.String]($backend) | string\r\n   * [SqliteValueType.Blob]($backend) | Uint8Array\r\n   */\r\n  public get value(): any {\r\n    switch (this.type) {\r\n      case SqliteValueType.Null:\r\n        return undefined;\r\n      case SqliteValueType.Blob:\r\n        return this.getBlob();\r\n      case SqliteValueType.Double:\r\n        return this.getDouble();\r\n      case SqliteValueType.Integer:\r\n        return this.getInteger();\r\n      case SqliteValueType.String:\r\n        return this.getString();\r\n      default:\r\n        throw new Error(\"Unhandled SqliteValueType\");\r\n    }\r\n  }\r\n\r\n  /** Get the value as BLOB */\r\n  public getBlob(): Uint8Array { return this._stmt.getValueBlob(this._colIndex); }\r\n  /** Get the value as a double value */\r\n  public getDouble(): number { return this._stmt.getValueDouble(this._colIndex); }\r\n  /** Get the value as a integer value */\r\n  public getInteger(): number { return this._stmt.getValueInteger(this._colIndex); }\r\n  /** Get the value as a string value */\r\n  public getString(): string { return this._stmt.getValueString(this._colIndex); }\r\n  /** Get the value as an Id value */\r\n  public getId(): Id64String { return this._stmt.getValueId(this._colIndex); }\r\n  /** Get the value as a Guid value */\r\n  public getGuid(): GuidString { return this._stmt.getValueGuid(this._colIndex); }\r\n}\r\n\r\ninterface Statement {\r\n  isPrepared: boolean;\r\n  sql: string;\r\n  dispose(): void;\r\n  reset(): void;\r\n  clearBindings(): void;\r\n}\r\n\r\n/** A cache for previously prepared SqliteStatements.\r\n * It only holds Statements after they are no longer in use, resetting and clearing their bindings before saving them.\r\n * When a request to use a statement from the cache is made, it is first removed from the cache.\r\n * @internal\r\n */\r\nexport class StatementCache<Stmt extends Statement> {\r\n  private _cache: LRUMap<string, Stmt>;\r\n\r\n  public constructor(maxCount = 40) {\r\n    this._cache = new LRUMap<string, Stmt>(maxCount);\r\n  }\r\n\r\n  public get size() { return this._cache.size; }\r\n  public addOrDispose(stmt: Stmt): void {\r\n    assert(stmt.isPrepared);\r\n\r\n    const existing = this._cache.get(stmt.sql);\r\n    if (existing !== undefined) {\r\n      stmt.dispose(); // we already have a statement with this sql cached, we can't save another one so just dispose it\r\n      return;\r\n    }\r\n    if (this._cache.size >= this._cache.limit) {\r\n      const oldest = this._cache.shift()!;\r\n      oldest[1].dispose();\r\n    }\r\n    stmt.reset();\r\n    stmt.clearBindings();\r\n    this._cache.set(stmt.sql, stmt);\r\n  }\r\n\r\n  public findAndRemove(sql: string): Stmt | undefined {\r\n    return this._cache.delete(sql);\r\n  }\r\n\r\n  public clear() {\r\n    this._cache.forEach((stmt) => stmt.dispose());\r\n    this._cache.clear();\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SqliteStatement.js","sourceRoot":"","sources":["../../src/SqliteStatement.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 SQLite\r\n */\r\n\r\nimport { assert, BentleyError, DbResult, GuidString, Id64String, IDisposable, LRUMap } from \"@itwin/core-bentley\";\r\nimport { ECJsNames, IModelError } from \"@itwin/core-common\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { IModelHost } from \"./IModelHost\";\r\n\r\n/* eslint-disable @typescript-eslint/no-non-null-assertion */\r\n\r\n/** Marks a string as either an [Id64String]($core-bentley) or [GuidString]($core-bentley), so\r\n * that it can be passed to the [bindValue]($backend.SqliteStatement) or [bindValues]($backend.SqliteStatement)\r\n * methods of [SqliteStatement]($backend).\r\n * @internal\r\n */\r\nexport interface StringParam {\r\n  id?: Id64String;\r\n  guid?: GuidString;\r\n}\r\n\r\n/** parameter Index (1-based), or name of the parameter (including the initial ':', '@' or '$')\r\n * @public\r\n */\r\nexport type BindParameter = number | string;\r\n\r\n/** Executes SQLite SQL statements.\r\n *\r\n * A statement must be prepared before it can be executed, and it must be released when no longer needed.\r\n * See [IModelDb.withPreparedSqliteStatement]($backend) or\r\n * [ECDb.withPreparedSqliteStatement]($backend) for a convenient and\r\n * reliable way to prepare, execute, and then release a statement.\r\n *\r\n * A statement may contain parameters that must be filled in before use by calling [SqliteStatement.bindValue]($backend)\r\n * or [SqliteStatement.bindValues]($backend).\r\n *\r\n * Once prepared (and parameters are bound, if any), the statement is executed by calling [SqliteStatement.step]($backend).\r\n * In case of an **SQL SELECT** statement, the current row can be retrieved with [SqliteStatement.getRow]($backend) as\r\n * a whole, or with [SqliteStatement.getValue]($backend) when individual values are needed.\r\n * Alternatively, query results of an **SQL SELECT** statement can be stepped through by using\r\n * standard iteration syntax, such as `for of`.\r\n *\r\n * > Preparing a statement can be time-consuming. The best way to reduce the effect of this overhead is to cache and reuse prepared\r\n * > statements. A cached prepared statement may be used in different places in an app, as long as the statement is general enough.\r\n * > The key to making this strategy work is to phrase a statement in a general way and use placeholders to represent parameters that will vary on each use.\r\n * @public\r\n */\r\nexport class SqliteStatement implements IterableIterator<any>, IDisposable {\r\n  private _stmt: IModelJsNative.SqliteStatement | undefined;\r\n  private _db: IModelJsNative.AnyDb | undefined;\r\n\r\n  public constructor(private _sql: string) { }\r\n  public get stmt(): IModelJsNative.SqliteStatement { return this._stmt!; }\r\n  public get sql() { return this._sql; }\r\n\r\n  /** Check if this statement has been prepared successfully or not */\r\n  public get isPrepared(): boolean { return undefined !== this._stmt; }\r\n\r\n  /** Prepare this statement prior to first use.\r\n   * @param db The DgnDb or ECDb to prepare the statement against\r\n   * @param sql The SQL statement string to prepare\r\n   * @param logErrors Determine if errors are logged or not\r\n   * @throws if the SQL statement cannot be prepared. Normally, prepare fails due to SQL syntax errors or references to tables or properties that do not exist.\r\n   * The error.message property will provide details.\r\n   */\r\n  public prepare(db: IModelJsNative.AnyDb, logErrors = true): void {\r\n    if (this.isPrepared)\r\n      throw new Error(\"SqliteStatement is already prepared\");\r\n    this._db = db;\r\n    this._stmt = new IModelHost.platform.SqliteStatement();\r\n    this._stmt.prepare(db, this._sql, logErrors);\r\n  }\r\n\r\n  /** Indicates whether the prepared statement makes no **direct* changes to the content of the file\r\n   * or not. See [SQLite docs](https://www.sqlite.org/c3ref/stmt_readonly.html) for details.\r\n   */\r\n  public get isReadonly(): boolean {\r\n    return this.stmt.isReadonly();\r\n  }\r\n\r\n  /** Reset this statement so that the next call to step will return the first row, if any.\r\n   */\r\n  public reset(): void {\r\n    this.stmt.reset();\r\n  }\r\n\r\n  /** Call this function when finished with this statement. This releases the native resources held by the statement. */\r\n  public dispose(): void {\r\n    if (this._stmt) {\r\n      this._stmt.dispose(); // free native statement\r\n      this._stmt = undefined;\r\n      this._db = undefined;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Call `step` on this statement and determine whether a new row is available.\r\n   * Use this method only when this statement has been prepared with a SELECT statement.\r\n   * @return true if a new row is available, false otherwise.\r\n   * @throws if `step` returns anything other than BE_SQLITE_ROW or BE_SQLITE_DONE.\r\n   */\r\n  public nextRow(): boolean {\r\n    const rc = this.step();\r\n    switch (rc) {\r\n      case DbResult.BE_SQLITE_ROW:\r\n        return true;\r\n      case DbResult.BE_SQLITE_DONE:\r\n        return false;\r\n    }\r\n\r\n    throw new BentleyError(rc, this._db!.getLastError());\r\n  }\r\n\r\n  /** Binds a value to the specified SQL parameter.\r\n   *  The value must be of one of these types:\r\n   *  JavaScript Type | SQLite Type\r\n   *  --- | ---\r\n   *  undefined | NULL\r\n   *  boolean | INTEGER with true being bound as 1 and false as 0\r\n   *  number | INTEGER if number is integral or REAL if number is not integral\r\n   *  string | TEXT\r\n   *  Uint8Array or ArrayBuffer | BLOB\r\n   *  [StringParam]($backend) where member **id** is set | INTEGER\r\n   *  [StringParam]($backend) where member **guid** is set | BLOB\r\n   *\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param value Value to bind.\r\n   *  @throws [IModelError]($common) if the value is of an unsupported type or in\r\n   *  case of other binding errors.\r\n   */\r\n  public bindValue(parameter: BindParameter, value: any): void {\r\n    let stat: DbResult;\r\n    if (value === undefined || value === null) {\r\n      stat = this.stmt.bindNull(parameter);\r\n    } else if (typeof (value) === \"number\") {\r\n      if (Number.isInteger(value))\r\n        stat = this.stmt.bindInteger(parameter, value);\r\n      else\r\n        stat = this.stmt.bindDouble(parameter, value);\r\n    } else if (typeof (value) === \"boolean\") {\r\n      stat = this.stmt.bindInteger(parameter, value ? 1 : 0);\r\n    } else if (typeof (value) === \"string\") {\r\n      stat = this.stmt.bindString(parameter, value);\r\n    } else if (!!value.id) {\r\n      stat = this.stmt.bindId(parameter, value.id);\r\n    } else if (!!value.guid) {\r\n      stat = this.stmt.bindGuid(parameter, value.guid);\r\n    } else if (value instanceof Uint8Array) {\r\n      stat = this.stmt.bindBlob(parameter, value);\r\n    } else\r\n      throw new IModelError(DbResult.BE_SQLITE_ERROR, `Parameter value ${value} is of an unsupported data type.`);\r\n\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"Error in bindValue\");\r\n  }\r\n\r\n  private checkBind(stat: DbResult) {\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"SQLite Bind error\");\r\n  }\r\n  /** Bind an integer parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val integer to bind.\r\n   */\r\n  public bindInteger(parameter: BindParameter, val: number) {\r\n    this.checkBind(this.stmt.bindInteger(parameter, val));\r\n  }\r\n  /** Bind a double parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val double to bind.\r\n   */\r\n  public bindDouble(parameter: BindParameter, val: number) {\r\n    this.checkBind(this.stmt.bindDouble(parameter, val));\r\n  }\r\n  /** Bind a string parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val string to bind.\r\n   */\r\n  public bindString(parameter: BindParameter, val: string) {\r\n    this.checkBind(this.stmt.bindString(parameter, val));\r\n  }\r\n  /** Bind an Id64String parameter as a 64-bit integer\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val Id to bind.\r\n   */\r\n  public bindId(parameter: BindParameter, id: Id64String) {\r\n    this.checkBind(this.stmt.bindId(parameter, id));\r\n  }\r\n  /** Bind a Guid parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val Guid to bind.\r\n   */\r\n  public bindGuid(parameter: BindParameter, guid: GuidString) {\r\n    this.checkBind(this.stmt.bindGuid(parameter, guid));\r\n  }\r\n  /** Bind a blob parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   *  @param val blob to bind.\r\n   */\r\n  public bindBlob(parameter: BindParameter, blob: Uint8Array) {\r\n    this.checkBind(this.stmt.bindBlob(parameter, blob));\r\n  }\r\n  /** Bind null to a parameter\r\n   *  @param parameter Index (1-based) or name of the parameter (including the initial ':', '@' or '$')\r\n   */\r\n  public bindNull(parameter: BindParameter) {\r\n    this.checkBind(this.stmt.bindNull(parameter));\r\n  }\r\n\r\n  /** Bind values to all parameters in the statement.\r\n   * @param values The values to bind to the parameters.\r\n   * Pass an *array* of values if the parameters are *positional*.\r\n   * Pass an *object of the values keyed on the parameter name* for *named parameters*.\r\n   * The values in either the array or object must match the respective types of the parameter.\r\n   * See [[SqliteStatement.bindValue]] for details on the supported types.\r\n   */\r\n  public bindValues(values: any[] | object): void {\r\n    if (Array.isArray(values)) {\r\n      for (let i = 0; i < values.length; i++) {\r\n        const paramIndex: number = i + 1;\r\n        const paramValue: any = values[i];\r\n        if (paramValue === undefined || paramValue === null)\r\n          continue;\r\n\r\n        this.bindValue(paramIndex, paramValue);\r\n      }\r\n      return;\r\n    }\r\n\r\n    for (const entry of Object.entries(values)) {\r\n      const paramName: string = entry[0];\r\n      const paramValue: any = entry[1];\r\n      if (paramValue === undefined || paramValue === null)\r\n        continue;\r\n\r\n      this.bindValue(paramName, paramValue);\r\n    }\r\n  }\r\n\r\n  /** Clear any bindings that were previously set on this statement.\r\n   * @throws [IModelError]($common) in case of errors\r\n   */\r\n  public clearBindings(): void {\r\n    const stat = this.stmt.clearBindings();\r\n    if (stat !== DbResult.BE_SQLITE_OK)\r\n      throw new IModelError(stat, \"Error in clearBindings\");\r\n  }\r\n\r\n  /** Step this statement to the next row.\r\n   *\r\n   *  For **SQL SELECT** statements the method returns\r\n   *  - [DbResult.BE_SQLITE_ROW]($core-bentley) if the statement now points successfully to the next row.\r\n   *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has no more rows.\r\n   *  - Error status in case of errors.\r\n   *\r\n   *  For **SQL INSERT, UPDATE, DELETE** statements the method returns\r\n   *  - [DbResult.BE_SQLITE_DONE]($core-bentley) if the statement has been executed successfully.\r\n   *  - Error status in case of errors.\r\n   */\r\n  public step(): DbResult { return this.stmt.step(); }\r\n\r\n  /** Get the query result's column count (only for SQL SELECT statements). */\r\n  public getColumnCount(): number { return this.stmt.getColumnCount(); }\r\n\r\n  /** Get the value for the column at the given index in the query result.\r\n   * @param columnIx Index of SQL column in query result (0-based)\r\n   */\r\n  public getValue(columnIx: number): SqliteValue { return new SqliteValue(this.stmt, columnIx); }\r\n\r\n  /** Determine whether the value of the specified column is null\r\n   * @param colIndex Index of SQL column in query result (0-based)\r\n   */\r\n  public isValueNull(colIndex: number): boolean { return this.stmt.isValueNull(colIndex); }\r\n\r\n  /** Get a size in bytes of a blob or text column\r\n   * @param colIndex Index of SQL column in query result (0-based)\r\n   */\r\n  public getColumnBytes(colIndex: number): number { return this.stmt.getColumnBytes(colIndex); }\r\n\r\n  /** Get a value as a blob\r\n   * @param colIndex Index of SQL column in query result (0-based)\r\n   */\r\n  public getValueBlob(colIndex: number): Uint8Array { return this.stmt.getValueBlob(colIndex); }\r\n  /** Get a value as a double\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueDouble(colIndex: number): number { return this.stmt.getValueDouble(colIndex); }\r\n  /** Get a value as a integer\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueInteger(colIndex: number): number { return this.stmt.getValueInteger(colIndex); }\r\n  /** Get a value as a string\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueString(colIndex: number): string { return this.stmt.getValueString(colIndex); }\r\n  /** Get a value as an Id\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueId(colIndex: number): Id64String { return this.stmt.getValueId(colIndex); }\r\n  /** Get a value as a Guid\r\n  * @param colIndex Index of SQL column in query result (0-based)\r\n  */\r\n  public getValueGuid(colIndex: number): GuidString { return this.stmt.getValueGuid(colIndex); }\r\n\r\n  /** Get the current row.\r\n   * The returned row is formatted as JavaScript object where every SELECT clause item becomes a property in the JavaScript object.\r\n   *\r\n   * The SQL select clause item's name becomes the member name of the JavaScript object, **with the first character lowered**.\r\n   *\r\n   * SQLite Type | JavaScript Type\r\n   * --- | ---\r\n   * [SqliteValueType.Null]($backend) | undefined\r\n   * [SqliteValueType.Integer]($backend) | number\r\n   * [SqliteValueType.Double]($backend) | number\r\n   * [SqliteValueType.String]($backend) | string\r\n   * [SqliteValueType.Blob]($backend) | Uint8Array\r\n   */\r\n  public getRow(): any {\r\n    const colCount = this.getColumnCount();\r\n    const row: object = {};\r\n    const duplicatePropNames = new Map<string, number>();\r\n    for (let i = 0; i < colCount; i++) {\r\n      const sqliteValue = this.getValue(i);\r\n      if (!sqliteValue.isNull) {\r\n        const propName: string = SqliteStatement.determineResultRowPropertyName(duplicatePropNames, sqliteValue);\r\n        let val: any;\r\n        switch (sqliteValue.type) {\r\n          case SqliteValueType.Blob:\r\n            val = sqliteValue.getBlob();\r\n            break;\r\n          case SqliteValueType.Double:\r\n            val = sqliteValue.getDouble();\r\n            break;\r\n          case SqliteValueType.Integer:\r\n            val = sqliteValue.getInteger();\r\n            break;\r\n          case SqliteValueType.String:\r\n            val = sqliteValue.getString();\r\n            break;\r\n\r\n          default:\r\n            throw new Error(\"Unsupported SqliteValueType\");\r\n        }\r\n\r\n        Object.defineProperty(row, propName, { enumerable: true, configurable: true, writable: true, value: val });\r\n      }\r\n    }\r\n    return row;\r\n  }\r\n\r\n  private static determineResultRowPropertyName(duplicatePropNames: Map<string, number>, sqliteValue: SqliteValue): string {\r\n    let jsName = ECJsNames.toJsName(sqliteValue.columnName);\r\n\r\n    // now check duplicates. If there are, append a numeric suffix to the duplicates\r\n    let suffix = duplicatePropNames.get(jsName);\r\n    if (suffix === undefined)\r\n      duplicatePropNames.set(jsName, 0);\r\n    else {\r\n      suffix++;\r\n      duplicatePropNames.set(jsName, suffix);\r\n      jsName += `_${suffix}`;\r\n    }\r\n\r\n    return jsName;\r\n  }\r\n\r\n  /** Calls step when called as an iterator.\r\n   */\r\n  public next(): IteratorResult<any> {\r\n    return DbResult.BE_SQLITE_ROW === this.step() ? { done: false, value: this.getRow() } : { done: true, value: undefined };\r\n  }\r\n\r\n  /** The iterator that will step through the results of this statement. */\r\n  public [Symbol.iterator](): IterableIterator<any> { return this; }\r\n}\r\n\r\n/** Data type of a value in in an SQLite SQL query result.\r\n * See also:\r\n * - [SqliteValue]($backend)\r\n * - [SqliteStatement]($backend)\r\n * - [SqliteStatement.getValue]($backend)\r\n * @public\r\n */\r\nexport enum SqliteValueType {\r\n  // do not change the values of that enum. It must correspond to the respective\r\n  // enum DbValueType in the native BeSQLite API.\r\n  Integer = 1,\r\n  Double = 2,\r\n  String = 3,\r\n  Blob = 4,\r\n  Null = 5,\r\n}\r\n\r\n/** Value of a column in a row of an SQLite SQL query result.\r\n * See also:\r\n * - [SqliteStatement]($backend)\r\n * - [SqliteStatement.getValue]($backend)\r\n * @public\r\n */\r\nexport class SqliteValue {\r\n  private readonly _stmt: IModelJsNative.SqliteStatement;\r\n  private readonly _colIndex: number;\r\n\r\n  public constructor(stmt: IModelJsNative.SqliteStatement, colIndex: number) {\r\n    this._stmt = stmt;\r\n    this._colIndex = colIndex;\r\n  }\r\n\r\n  /** Indicates whether the value is NULL or not. */\r\n  public get isNull(): boolean { return this._stmt.isValueNull(this._colIndex); }\r\n\r\n  /** Gets the data type of the value. */\r\n  public get type(): SqliteValueType { return this._stmt.getColumnType(this._colIndex); }\r\n\r\n  /** Gets the name of the column of the value. */\r\n  public get columnName(): string { return this._stmt.getColumnName(this._colIndex); }\r\n\r\n  /** Gets the SqlValue as JavaScript value.\r\n   *\r\n   * SQLite Type | JavaScript Type\r\n   * --- | ---\r\n   * [SqliteValueType.Null]($backend) | undefined\r\n   * [SqliteValueType.Integer]($backend) | number\r\n   * [SqliteValueType.Double]($backend) | number\r\n   * [SqliteValueType.String]($backend) | string\r\n   * [SqliteValueType.Blob]($backend) | Uint8Array\r\n   */\r\n  public get value(): any {\r\n    switch (this.type) {\r\n      case SqliteValueType.Null:\r\n        return undefined;\r\n      case SqliteValueType.Blob:\r\n        return this.getBlob();\r\n      case SqliteValueType.Double:\r\n        return this.getDouble();\r\n      case SqliteValueType.Integer:\r\n        return this.getInteger();\r\n      case SqliteValueType.String:\r\n        return this.getString();\r\n      default:\r\n        throw new Error(\"Unhandled SqliteValueType\");\r\n    }\r\n  }\r\n\r\n  /** Get the value as BLOB */\r\n  public getBlob(): Uint8Array { return this._stmt.getValueBlob(this._colIndex); }\r\n  /** Get the value as a double value */\r\n  public getDouble(): number { return this._stmt.getValueDouble(this._colIndex); }\r\n  /** Get the value as a integer value */\r\n  public getInteger(): number { return this._stmt.getValueInteger(this._colIndex); }\r\n  /** Get the value as a string value */\r\n  public getString(): string { return this._stmt.getValueString(this._colIndex); }\r\n  /** Get the value as an Id value */\r\n  public getId(): Id64String { return this._stmt.getValueId(this._colIndex); }\r\n  /** Get the value as a Guid value */\r\n  public getGuid(): GuidString { return this._stmt.getValueGuid(this._colIndex); }\r\n}\r\n\r\ninterface Statement {\r\n  isPrepared: boolean;\r\n  sql: string;\r\n  dispose(): void;\r\n  reset(): void;\r\n  clearBindings(): void;\r\n}\r\n\r\n/** A cache for previously prepared SqliteStatements.\r\n * It only holds Statements after they are no longer in use, resetting and clearing their bindings before saving them.\r\n * When a request to use a statement from the cache is made, it is first removed from the cache.\r\n * @internal\r\n */\r\nexport class StatementCache<Stmt extends Statement> {\r\n  private _cache: LRUMap<string, Stmt>;\r\n\r\n  public constructor(maxCount = 40) {\r\n    this._cache = new LRUMap<string, Stmt>(maxCount);\r\n  }\r\n\r\n  public get size() { return this._cache.size; }\r\n  public addOrDispose(stmt: Stmt): void {\r\n    assert(stmt.isPrepared);\r\n\r\n    const existing = this._cache.get(stmt.sql);\r\n    if (existing !== undefined) {\r\n      stmt.dispose(); // we already have a statement with this sql cached, we can't save another one so just dispose it\r\n      return;\r\n    }\r\n    if (this._cache.size >= this._cache.limit) {\r\n      const oldest = this._cache.shift()!;\r\n      oldest[1].dispose();\r\n    }\r\n    stmt.reset();\r\n    stmt.clearBindings();\r\n    this._cache.set(stmt.sql, stmt);\r\n  }\r\n\r\n  public findAndRemove(sql: string): Stmt | undefined {\r\n    return this._cache.delete(sql);\r\n  }\r\n\r\n  public clear() {\r\n    this._cache.forEach((stmt) => stmt.dispose());\r\n    this._cache.clear();\r\n  }\r\n}\r\n"]}

package/lib/cjs/TxnManager.js

@@ -110,7 +110,7 @@ class ChangedEntitiesProc {
                 ? "SELECT ElementId, ChangeType, ECClassId FROM temp.txn_Elements"
                 : "SELECT ModelId, ChangeType, ECClassId FROM temp.txn_Models";
             iModel.withPreparedSqliteStatement(select, (sql) => {
-                const stmt = sql.stmt; // eslint-disable-line @typescript-eslint/no-non-null-assertion
+                const stmt = sql.stmt;
                 while (sql.step() === core_bentley_1.DbResult.BE_SQLITE_ROW) {
                     const id = stmt.getValueId(0);
                     const classId = stmt.getValueId(2);