@itwin/core-backend 4.0.0-dev.52 → 4.0.0-dev.55

package/lib/cjs/SQLiteDb.js

@@ -1,213 +1,213 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module SQLiteDb
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SQLiteDb = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const CloudSqlite_1 = require("./CloudSqlite");
-const IModelHost_1 = require("./IModelHost");
-const SqliteStatement_1 = require("./SqliteStatement");
-// cspell:ignore savepoint
-/* eslint-disable @typescript-eslint/unified-signatures */
-/** A SQLiteDb file
- * @public
- */
-class SQLiteDb {
-    constructor() {
-        /** @internal */
-        this.nativeDb = new IModelHost_1.IModelHost.platform.SQLiteDb();
-        this._sqliteStatementCache = new SqliteStatement_1.StatementCache();
-    }
-    /** @internal */
-    static createBlobIO() {
-        return new IModelHost_1.IModelHost.platform.BlobIO();
-    }
-    /** alias for closeDb. */
-    dispose() {
-        this.closeDb();
-    }
-    /** @internal */
-    createDb(dbName, container, params) {
-        this.nativeDb.createDb(dbName, container, params);
-    }
-    /** @internal */
-    openDb(dbName, openMode, container) {
-        this.nativeDb.openDb(dbName, openMode, container);
-    }
-    /** Close SQLiteDb.
-     * @param saveChanges if true, call `saveChanges` before closing db. Otherwise unsaved changes are abandoned.
-     */
-    closeDb(saveChanges) {
-        if (saveChanges && this.isOpen)
-            this.saveChanges();
-        this._sqliteStatementCache.clear();
-        this.nativeDb.closeDb();
-    }
-    /** Returns true if this SQLiteDb is open */
-    get isOpen() { return this.nativeDb.isOpen(); }
-    /** Returns true if this SQLiteDb is open readonly */
-    get isReadonly() { return this.nativeDb.isReadonly(); }
-    /**
-     * Open a database, perform an operation, then close the database.
-     *
-     * Details:
-     * - if database is open, throw an error
-     * - open a database
-     * - call a function with the database opened. If it is async, await its return.
-     * - if function throws, abandon all changes, close database, and rethrow
-     * - save all changes
-     * - close the database
-     * @return value from operation
-     */
-    withOpenDb(args, operation) {
-        if (this.isOpen)
-            throw new Error("database is already open");
-        const save = () => this.closeDb(true), abandon = () => this.closeDb(false);
-        this.openDb(args.dbName, args.openMode ?? core_bentley_1.OpenMode.Readonly, args.container);
-        try {
-            const result = operation();
-            result instanceof Promise ? result.then(save, abandon) : save();
-            return result;
-        }
-        catch (e) {
-            abandon();
-            throw e;
-        }
-    }
-    /**
-     * Perform an operation on a database in a CloudContainer with the write lock held.
-     *
-     * Details:
-     * - acquire the write lock on a CloudContainer
-     * - call `withOpenDb` with openMode `ReadWrite`
-     * - upload changes
-     * - release the write lock
-     * @param args arguments to lock the container and open the database
-     * @param operation an operation performed on the database with the write lock held.
-     * @return value from operation
-     * @internal
-     */
-    async withLockedContainer(args, operation) {
-        return CloudSqlite_1.CloudSqlite.withWriteLock(args.user, args.container, () => this.withOpenDb({ ...args, openMode: core_bentley_1.OpenMode.ReadWrite }, operation), args.busyHandler);
-    }
-    /** vacuum this database
-     * @see https://www.sqlite.org/lang_vacuum.html
-     */
-    vacuum(args) {
-        this.nativeDb.vacuum(args);
-    }
-    /** Commit the outermost transaction, writing changes to the file. Then, restart the transaction. */
-    saveChanges() {
-        this.nativeDb.saveChanges();
-    }
-    /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the transaction. */
-    abandonChanges() {
-        this.nativeDb.abandonChanges();
-    }
-    /**
-     * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist
-     * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved
-     * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be
-     * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding
-     * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].
-     * @param sql The SQLite SQL statement to execute
-     * @param callback the callback to invoke on the prepared statement
-     * @returns the value returned by `callback`.
-     */
-    withPreparedSqliteStatement(sql, callback) {
-        const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);
-        const release = () => this._sqliteStatementCache.addOrDispose(stmt);
-        try {
-            const val = callback(stmt);
-            val instanceof Promise ? val.then(release, release) : release();
-            return val;
-        }
-        catch (err) {
-            release();
-            throw err;
-        }
-    }
-    /**
-     * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.
-     * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.
-     * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].
-     * @param sql The SQLite SQL statement to execute
-     * @param callback the callback to invoke on the prepared statement
-     * @returns the value returned by `callback`.
-     */
-    withSqliteStatement(sql, callback) {
-        const stmt = this.prepareSqliteStatement(sql);
-        const release = () => stmt.dispose();
-        try {
-            const val = callback(stmt);
-            val instanceof Promise ? val.then(release, release) : release();
-            return val;
-        }
-        catch (err) {
-            release();
-            throw err;
-        }
-    }
-    /**
-     * Perform an operation on this database within a [savepoint](https://www.sqlite.org/lang_savepoint.html). If the operation completes successfully, the
-     * changes remain in the current transaction. If the operation throws an exception, the savepoint is rolled back
-     * and all changes to the database from this method are reversed, leaving the transaction exactly as it was before this method.
-     */
-    withSavePoint(savePointName, operation) {
-        if (this.isReadonly)
-            throw new Error("database is readonly");
-        this.executeSQL(`SAVEPOINT ${savePointName}`);
-        try {
-            operation();
-            this.executeSQL(`RELEASE ${savePointName}`);
-        }
-        catch (e) {
-            this.executeSQL(`ROLLBACK TO ${savePointName}`);
-            throw e;
-        }
-    }
-    /** Prepare an SQL statement.
-       * @param sql The SQLite SQL statement to prepare
-       * @param logErrors Determine if errors are logged or not
-       * @internal
-       */
-    prepareSqliteStatement(sql, logErrors = true) {
-        const stmt = new SqliteStatement_1.SqliteStatement(sql);
-        stmt.prepare(this.nativeDb, logErrors);
-        return stmt;
-    }
-    /** execute an SQL statement */
-    executeSQL(sql) {
-        const stmt = this.prepareSqliteStatement(sql);
-        try {
-            return stmt.step();
-        }
-        finally {
-            stmt.dispose();
-        }
-    }
-}
-exports.SQLiteDb = SQLiteDb;
-/** @public */
-(function (SQLiteDb) {
-    /** Default transaction mode for SQLiteDbs.
-     * @see https://www.sqlite.org/lang_transaction.html
-     */
-    let DefaultTxnMode;
-    (function (DefaultTxnMode) {
-        /** no default transaction is started. You must use BEGIN/COMMIT or SQLite will use implicit transactions */
-        DefaultTxnMode[DefaultTxnMode["None"] = 0] = "None";
-        /** A deferred transaction is started when the file is first opened. This is the default. */
-        DefaultTxnMode[DefaultTxnMode["Deferred"] = 1] = "Deferred";
-        /** An immediate transaction is started when the file is first opened. */
-        DefaultTxnMode[DefaultTxnMode["Immediate"] = 2] = "Immediate";
-        /** An exclusive transaction is started when the file is first opened. */
-        DefaultTxnMode[DefaultTxnMode["Exclusive"] = 3] = "Exclusive";
-    })(DefaultTxnMode = SQLiteDb.DefaultTxnMode || (SQLiteDb.DefaultTxnMode = {}));
-})(SQLiteDb = exports.SQLiteDb || (exports.SQLiteDb = {}));
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module SQLiteDb
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLiteDb = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const CloudSqlite_1 = require("./CloudSqlite");
+const IModelHost_1 = require("./IModelHost");
+const SqliteStatement_1 = require("./SqliteStatement");
+// cspell:ignore savepoint
+/* eslint-disable @typescript-eslint/unified-signatures */
+/** A SQLiteDb file
+ * @public
+ */
+class SQLiteDb {
+    constructor() {
+        /** @internal */
+        this.nativeDb = new IModelHost_1.IModelHost.platform.SQLiteDb();
+        this._sqliteStatementCache = new SqliteStatement_1.StatementCache();
+    }
+    /** @internal */
+    static createBlobIO() {
+        return new IModelHost_1.IModelHost.platform.BlobIO();
+    }
+    /** alias for closeDb. */
+    dispose() {
+        this.closeDb();
+    }
+    /** @internal */
+    createDb(dbName, container, params) {
+        this.nativeDb.createDb(dbName, container, params);
+    }
+    /** @internal */
+    openDb(dbName, openMode, container) {
+        this.nativeDb.openDb(dbName, openMode, container);
+    }
+    /** Close SQLiteDb.
+     * @param saveChanges if true, call `saveChanges` before closing db. Otherwise unsaved changes are abandoned.
+     */
+    closeDb(saveChanges) {
+        if (saveChanges && this.isOpen)
+            this.saveChanges();
+        this._sqliteStatementCache.clear();
+        this.nativeDb.closeDb();
+    }
+    /** Returns true if this SQLiteDb is open */
+    get isOpen() { return this.nativeDb.isOpen(); }
+    /** Returns true if this SQLiteDb is open readonly */
+    get isReadonly() { return this.nativeDb.isReadonly(); }
+    /**
+     * Open a database, perform an operation, then close the database.
+     *
+     * Details:
+     * - if database is open, throw an error
+     * - open a database
+     * - call a function with the database opened. If it is async, await its return.
+     * - if function throws, abandon all changes, close database, and rethrow
+     * - save all changes
+     * - close the database
+     * @return value from operation
+     */
+    withOpenDb(args, operation) {
+        if (this.isOpen)
+            throw new Error("database is already open");
+        const save = () => this.closeDb(true), abandon = () => this.closeDb(false);
+        this.openDb(args.dbName, args.openMode ?? core_bentley_1.OpenMode.Readonly, args.container);
+        try {
+            const result = operation();
+            result instanceof Promise ? result.then(save, abandon) : save();
+            return result;
+        }
+        catch (e) {
+            abandon();
+            throw e;
+        }
+    }
+    /**
+     * Perform an operation on a database in a CloudContainer with the write lock held.
+     *
+     * Details:
+     * - acquire the write lock on a CloudContainer
+     * - call `withOpenDb` with openMode `ReadWrite`
+     * - upload changes
+     * - release the write lock
+     * @param args arguments to lock the container and open the database
+     * @param operation an operation performed on the database with the write lock held.
+     * @return value from operation
+     * @internal
+     */
+    async withLockedContainer(args, operation) {
+        return CloudSqlite_1.CloudSqlite.withWriteLock(args.user, args.container, () => this.withOpenDb({ ...args, openMode: core_bentley_1.OpenMode.ReadWrite }, operation), args.busyHandler);
+    }
+    /** vacuum this database
+     * @see https://www.sqlite.org/lang_vacuum.html
+     */
+    vacuum(args) {
+        this.nativeDb.vacuum(args);
+    }
+    /** Commit the outermost transaction, writing changes to the file. Then, restart the transaction. */
+    saveChanges() {
+        this.nativeDb.saveChanges();
+    }
+    /** Abandon (cancel) the outermost transaction, discarding all changes since last save. Then, restart the transaction. */
+    abandonChanges() {
+        this.nativeDb.abandonChanges();
+    }
+    /**
+     * Use a prepared SQL statement, potentially from the statement cache. If the requested statement doesn't exist
+     * in the statement cache, a new statement is prepared. After the callback completes, the statement is reset and saved
+     * in the statement cache so it can be reused in the future. Use this method for SQL statements that will be
+     * reused often and are expensive to prepare. The statement cache holds the most recently used statements, discarding
+     * the oldest statements as it fills. For statements you don't intend to reuse, instead use [[withSqliteStatement]].
+     * @param sql The SQLite SQL statement to execute
+     * @param callback the callback to invoke on the prepared statement
+     * @returns the value returned by `callback`.
+     */
+    withPreparedSqliteStatement(sql, callback) {
+        const stmt = this._sqliteStatementCache.findAndRemove(sql) ?? this.prepareSqliteStatement(sql);
+        const release = () => this._sqliteStatementCache.addOrDispose(stmt);
+        try {
+            const val = callback(stmt);
+            val instanceof Promise ? val.then(release, release) : release();
+            return val;
+        }
+        catch (err) {
+            release();
+            throw err;
+        }
+    }
+    /**
+     * Prepared and execute a callback on a SQL statement. After the callback completes the statement is disposed.
+     * Use this method for SQL statements are either not expected to be reused, or are not expensive to prepare.
+     * For statements that will be reused often, instead use [[withPreparedSqliteStatement]].
+     * @param sql The SQLite SQL statement to execute
+     * @param callback the callback to invoke on the prepared statement
+     * @returns the value returned by `callback`.
+     */
+    withSqliteStatement(sql, callback) {
+        const stmt = this.prepareSqliteStatement(sql);
+        const release = () => stmt.dispose();
+        try {
+            const val = callback(stmt);
+            val instanceof Promise ? val.then(release, release) : release();
+            return val;
+        }
+        catch (err) {
+            release();
+            throw err;
+        }
+    }
+    /**
+     * Perform an operation on this database within a [savepoint](https://www.sqlite.org/lang_savepoint.html). If the operation completes successfully, the
+     * changes remain in the current transaction. If the operation throws an exception, the savepoint is rolled back
+     * and all changes to the database from this method are reversed, leaving the transaction exactly as it was before this method.
+     */
+    withSavePoint(savePointName, operation) {
+        if (this.isReadonly)
+            throw new Error("database is readonly");
+        this.executeSQL(`SAVEPOINT ${savePointName}`);
+        try {
+            operation();
+            this.executeSQL(`RELEASE ${savePointName}`);
+        }
+        catch (e) {
+            this.executeSQL(`ROLLBACK TO ${savePointName}`);
+            throw e;
+        }
+    }
+    /** Prepare an SQL statement.
+       * @param sql The SQLite SQL statement to prepare
+       * @param logErrors Determine if errors are logged or not
+       * @internal
+       */
+    prepareSqliteStatement(sql, logErrors = true) {
+        const stmt = new SqliteStatement_1.SqliteStatement(sql);
+        stmt.prepare(this.nativeDb, logErrors);
+        return stmt;
+    }
+    /** execute an SQL statement */
+    executeSQL(sql) {
+        const stmt = this.prepareSqliteStatement(sql);
+        try {
+            return stmt.step();
+        }
+        finally {
+            stmt.dispose();
+        }
+    }
+}
+exports.SQLiteDb = SQLiteDb;
+/** @public */
+(function (SQLiteDb) {
+    /** Default transaction mode for SQLiteDbs.
+     * @see https://www.sqlite.org/lang_transaction.html
+     */
+    let DefaultTxnMode;
+    (function (DefaultTxnMode) {
+        /** no default transaction is started. You must use BEGIN/COMMIT or SQLite will use implicit transactions */
+        DefaultTxnMode[DefaultTxnMode["None"] = 0] = "None";
+        /** A deferred transaction is started when the file is first opened. This is the default. */
+        DefaultTxnMode[DefaultTxnMode["Deferred"] = 1] = "Deferred";
+        /** An immediate transaction is started when the file is first opened. */
+        DefaultTxnMode[DefaultTxnMode["Immediate"] = 2] = "Immediate";
+        /** An exclusive transaction is started when the file is first opened. */
+        DefaultTxnMode[DefaultTxnMode["Exclusive"] = 3] = "Exclusive";
+    })(DefaultTxnMode = SQLiteDb.DefaultTxnMode || (SQLiteDb.DefaultTxnMode = {}));
+})(SQLiteDb = exports.SQLiteDb || (exports.SQLiteDb = {}));
 //# sourceMappingURL=SQLiteDb.js.map

package/lib/cjs/Schema.d.ts

@@ -1,56 +1,56 @@
-/** @packageDocumentation
- * @module Schema
- */
-/** Base class for all schema classes - see [working with schemas and elements in TypeScript]($docs/learning/backend/SchemasAndElementsInTypeScript.md).
- * @public
- */
-export declare class Schema {
-    /** The name of the BIS schema handled by this Schema.
-     * @note Every subclass of Schema ** MUST ** override this method to identify its BIS schema.
-     * Failure to do so will ordinarily result in an error when the schema is registered, since there may only
-     * be one JavaScript class for a given BIS schema (usually the errant schema will collide with its superclass.)
-     */
-    static get schemaName(): string;
-    /** if true, this Schema is a proxy for a missing Domain marked with the `BisCore.SchemaHasBehavior` customAttribute.
-     * Classes generated for this Schema will disallow protected operations.
-     * @internal
-     */
-    static get missingRequiredBehavior(): boolean;
-    /** Get a semver-compatible string from a padded version string.
-     * works on unpadded version strings as well
-     * if there is no write version, it will be added
-     * @example Schema.toSemverString("1.02.03") === "1.2.3"
-     * @example Schema.toSemverString("1.01") === "1.0.1" // write version was added
-     * @beta
-     */
-    static toSemverString(paddedVersion: string): string;
-    /** Schemas may not be instantiated. The method is not private only because that precludes subclassing. It throws an
-     * error if it is ever called.
-     * @internal
-     */
-    protected constructor();
-}
-/** Manages registered schemas
- * @public
- */
-export declare class Schemas {
-    private static readonly _registeredSchemas;
-    private constructor();
-    /** Register a schema prior to using it.
-     * @throws [[IModelError]] if a schema of the same name is already registered.
-     */
-    static registerSchema(schema: typeof Schema): void;
-    /** Unregister a schema, by name, if one is already registered.
-     * This function is not normally needed, but is useful for cases where a generated *proxy* schema needs to be replaced by the *real* schema.
-     * @param schemaName Name of the schema to unregister
-     * @return true if the schema was unregistered
-     * @internal
-     */
-    static unregisterSchema(schemaName: string): boolean;
-    /** Look up a previously registered schema
-     * @param schemaName The name of the schema
-     * @returns the previously registered schema or undefined if not registered.
-     */
-    static getRegisteredSchema(schemaName: string): typeof Schema | undefined;
-}
+/** @packageDocumentation
+ * @module Schema
+ */
+/** Base class for all schema classes - see [working with schemas and elements in TypeScript]($docs/learning/backend/SchemasAndElementsInTypeScript.md).
+ * @public
+ */
+export declare class Schema {
+    /** The name of the BIS schema handled by this Schema.
+     * @note Every subclass of Schema ** MUST ** override this method to identify its BIS schema.
+     * Failure to do so will ordinarily result in an error when the schema is registered, since there may only
+     * be one JavaScript class for a given BIS schema (usually the errant schema will collide with its superclass.)
+     */
+    static get schemaName(): string;
+    /** if true, this Schema is a proxy for a missing Domain marked with the `BisCore.SchemaHasBehavior` customAttribute.
+     * Classes generated for this Schema will disallow protected operations.
+     * @internal
+     */
+    static get missingRequiredBehavior(): boolean;
+    /** Get a semver-compatible string from a padded version string.
+     * works on unpadded version strings as well
+     * if there is no write version, it will be added
+     * @example Schema.toSemverString("1.02.03") === "1.2.3"
+     * @example Schema.toSemverString("1.01") === "1.0.1" // write version was added
+     * @beta
+     */
+    static toSemverString(paddedVersion: string): string;
+    /** Schemas may not be instantiated. The method is not private only because that precludes subclassing. It throws an
+     * error if it is ever called.
+     * @internal
+     */
+    protected constructor();
+}
+/** Manages registered schemas
+ * @public
+ */
+export declare class Schemas {
+    private static readonly _registeredSchemas;
+    private constructor();
+    /** Register a schema prior to using it.
+     * @throws [[IModelError]] if a schema of the same name is already registered.
+     */
+    static registerSchema(schema: typeof Schema): void;
+    /** Unregister a schema, by name, if one is already registered.
+     * This function is not normally needed, but is useful for cases where a generated *proxy* schema needs to be replaced by the *real* schema.
+     * @param schemaName Name of the schema to unregister
+     * @return true if the schema was unregistered
+     * @internal
+     */
+    static unregisterSchema(schemaName: string): boolean;
+    /** Look up a previously registered schema
+     * @param schemaName The name of the schema
+     * @returns the previously registered schema or undefined if not registered.
+     */
+    static getRegisteredSchema(schemaName: string): typeof Schema | undefined;
+}
 //# sourceMappingURL=Schema.d.ts.map