@itwin/core-backend 5.8.2 → 5.9.0-dev.10

package/lib/cjs/internal/workspace/SettingsSqliteDb.js

@@ -1,40 +0,0 @@
-"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 Workspace
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SettingsSqliteDb = void 0;
-const SQLiteDb_1 = require("../../SQLiteDb");
-const core_common_1 = require("@itwin/core-common");
-const Symbols_1 = require("../Symbols");
-const SettingsDbImpl_1 = require("./SettingsDbImpl");
-/** A [[VersionedSqliteDb]] that stores settings dictionaries. Unlike [[WorkspaceSqliteDb]], the
- * manifest is stored using [[settingsManifestProperty]] so that settings and workspace databases
- * can coexist in the same container without ambiguity.
- */
-class SettingsSqliteDb extends SQLiteDb_1.VersionedSqliteDb {
-    myVersion = "1.0.0";
-    getRequiredVersions() {
-        try {
-            return super.getRequiredVersions();
-        }
-        catch (e) {
-            if (core_common_1.SqliteError.isError(e, "invalid-versions-property"))
-                return { readVersion: "^1", writeVersion: "^1" };
-            throw e;
-        }
-    }
-    createDDL(args) {
-        const timeStampCol = "lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))";
-        this.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);
-        this.executeSQL(`CREATE TRIGGER strings_timeStamp AFTER UPDATE ON strings WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE strings SET lastMod=julianday('now') WHERE id=new.id; END`);
-        if (args?.manifest)
-            this[Symbols_1._nativeDb].saveFileProperty(SettingsDbImpl_1.settingsManifestProperty, JSON.stringify(args.manifest));
-    }
-}
-exports.SettingsSqliteDb = SettingsSqliteDb;
-//# sourceMappingURL=SettingsSqliteDb.js.map

package/lib/cjs/internal/workspace/SettingsSqliteDb.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsSqliteDb.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSqliteDb.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,6CAA6D;AAC7D,oDAAiD;AACjD,wCAAuC;AACvC,qDAA4D;AAE5D;;;GAGG;AACH,MAAa,gBAAiB,SAAQ,4BAAiB;IACrC,SAAS,GAAG,OAAO,CAAC;IACpB,mBAAmB;QACjC,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,mBAAmB,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,yBAAW,CAAC,OAAO,CAAC,CAAC,EAAE,2BAA2B,CAAC;gBACrD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAEkB,SAAS,CAAC,IAAS;QACpC,MAAM,YAAY,GAAG,sDAAsD,CAAC;QAC5E,IAAI,CAAC,UAAU,CAAC,gEAAgE,YAAY,GAAG,CAAC,CAAC;QACjG,IAAI,CAAC,UAAU,CAAC,kMAAkM,CAAC,CAAC;QACpN,IAAI,IAAI,EAAE,QAAQ;YAChB,IAAI,CAAC,mBAAS,CAAC,CAAC,gBAAgB,CAAC,yCAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF;AAnBD,4CAmBC","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 Workspace\r\n */\r\n\r\nimport { SQLiteDb, VersionedSqliteDb } from \"../../SQLiteDb\";\r\nimport { SqliteError } from \"@itwin/core-common\";\r\nimport { _nativeDb } from \"../Symbols\";\r\nimport { settingsManifestProperty } from \"./SettingsDbImpl\";\r\n\r\n/** A [[VersionedSqliteDb]] that stores settings dictionaries. Unlike [[WorkspaceSqliteDb]], the\r\n * manifest is stored using [[settingsManifestProperty]] so that settings and workspace databases\r\n * can coexist in the same container without ambiguity.\r\n */\r\nexport class SettingsSqliteDb extends VersionedSqliteDb {\r\n  public override myVersion = \"1.0.0\";\r\n  public override getRequiredVersions(): SQLiteDb.RequiredVersionRanges {\r\n    try {\r\n      return super.getRequiredVersions();\r\n    } catch (e) {\r\n      if (SqliteError.isError(e, \"invalid-versions-property\"))\r\n        return { readVersion: \"^1\", writeVersion: \"^1\" };\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  protected override createDDL(args: any): void {\r\n    const timeStampCol = \"lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\";\r\n    this.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);\r\n    this.executeSQL(`CREATE TRIGGER strings_timeStamp AFTER UPDATE ON strings WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE strings SET lastMod=julianday('now') WHERE id=new.id; END`);\r\n    if (args?.manifest)\r\n      this[_nativeDb].saveFileProperty(settingsManifestProperty, JSON.stringify(args.manifest));\r\n  }\r\n}\r\n"]}

package/lib/esm/internal/workspace/SettingsDbImpl.d.ts

@@ -1,38 +0,0 @@
-/** @packageDocumentation
- * @module Workspace
- */
-import { FilePropertyProps } from "@itwin/core-common";
-import { Setting, SettingName, SettingsContainer, SettingsPriority } from "../../workspace/Settings";
-import { CloudSqliteContainer, WorkspaceDbName } from "../../workspace/Workspace";
-import { SettingsDb, SettingsDbManifest, SettingsDbProps } from "../../workspace/SettingsDb";
-import { WorkspaceSqliteDb } from "./WorkspaceSqliteDb";
-import { _implementationProhibited } from "../Symbols";
-export declare const settingsDbDefaultName: WorkspaceDbName;
-export declare const settingsManifestProperty: FilePropertyProps;
-/** Internal implementation of [[SettingsDb]]. Wraps a [[WorkspaceSqliteDb]] to provide a
- * settings-only read interface over the `strings` table.
- */
-export declare class SettingsDbImpl implements SettingsDb {
-    readonly [_implementationProhibited]: undefined;
-    readonly sqliteDb: WorkspaceSqliteDb;
-    readonly dbName: string;
-    readonly dbFileName: string;
-    protected readonly _container: CloudSqliteContainer;
-    readonly priority: SettingsPriority;
-    protected _manifest?: SettingsDbManifest;
-    constructor(props: SettingsDbProps, container: CloudSqliteContainer, priority: SettingsPriority);
-    get container(): CloudSqliteContainer;
-    get isOpen(): boolean;
-    get version(): string;
-    get manifest(): SettingsDbManifest;
-    /** Check whether the underlying database has a settings manifest property.
-     * Used to validate that a container actually holds a SettingsDb rather than a WorkspaceDb.
-     */
-    get hasSettingsManifestProperty(): boolean;
-    protected withOpenDb<T>(operation: (db: WorkspaceSqliteDb) => T): T;
-    open(): void;
-    close(): void;
-    getSettings(): SettingsContainer;
-    getSetting<T extends Setting>(settingName: SettingName): T | undefined;
-}
-//# sourceMappingURL=SettingsDbImpl.d.ts.map

package/lib/esm/internal/workspace/SettingsDbImpl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsDbImpl.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsDbImpl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAwB,MAAM,4BAA4B,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAa,MAAM,YAAY,CAAC;AAElE,eAAO,MAAM,qBAAqB,EAAE,eAA+B,CAAC;AAEpE,eAAO,MAAM,wBAAwB,EAAE,iBAA+D,CAAC;AAEvG;;GAEG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,SAAgB,CAAC,yBAAyB,CAAC,YAAa;IACxD,SAAgB,QAAQ,oBAA2B;IACnD,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IACpD,SAAgB,QAAQ,EAAE,gBAAgB,CAAC;IAC3C,SAAS,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;gBAEtB,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,oBAAoB,EAAE,QAAQ,EAAE,gBAAgB;IAQtG,IAAW,SAAS,IAAI,oBAAoB,CAA4B;IACxE,IAAW,MAAM,YAAmC;IAEpD,IAAW,OAAO,IAAI,MAAM,CAK3B;IAED,IAAW,QAAQ,IAAI,kBAAkB,CAWxC;IAED;;OAEG;IACH,IAAW,2BAA2B,IAAI,OAAO,CAKhD;IAED,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,CAAC,GAAG,CAAC;IAS5D,IAAI,IAAI,IAAI;IAIZ,KAAK,IAAI,IAAI;IAKb,WAAW,IAAI,iBAAiB;IAgBhC,UAAU,CAAC,CAAC,SAAS,OAAO,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,GAAG,SAAS;CAO9E"}

package/lib/esm/internal/workspace/SettingsDbImpl.js

@@ -1,104 +0,0 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Workspace
- */
-import { DbResult, OpenMode } from "@itwin/core-bentley";
-import { CloudSqlite } from "../../CloudSqlite";
-import { Setting } from "../../workspace/Settings";
-import { settingsResourceName } from "../../workspace/SettingsDb";
-import { WorkspaceSqliteDb } from "./WorkspaceSqliteDb";
-import { _implementationProhibited, _nativeDb } from "../Symbols";
-export const settingsDbDefaultName = "settings-db";
-export const settingsManifestProperty = { namespace: "settings", name: "manifest" };
-/** Internal implementation of [[SettingsDb]]. Wraps a [[WorkspaceSqliteDb]] to provide a
- * settings-only read interface over the `strings` table.
- */
-export class SettingsDbImpl {
-    [_implementationProhibited] = undefined;
-    sqliteDb = new WorkspaceSqliteDb();
-    dbName;
-    dbFileName;
-    _container;
-    priority;
-    _manifest;
-    constructor(props, container, priority) {
-        this.dbName = props.dbName ?? settingsDbDefaultName;
-        CloudSqlite.validateDbName(this.dbName);
-        this._container = container;
-        this.dbFileName = container.resolveDbFileName(props);
-        this.priority = priority;
-    }
-    get container() { return this._container; }
-    get isOpen() { return this.sqliteDb.isOpen; }
-    get version() {
-        const cloudContainer = this.container.cloudContainer;
-        if (undefined === cloudContainer)
-            return "0.0.0";
-        return CloudSqlite.parseDbFileName(this.dbFileName).version;
-    }
-    get manifest() {
-        return this._manifest ??= this.withOpenDb((db) => {
-            const manifestJson = db[_nativeDb].queryFileProperty(settingsManifestProperty, true);
-            if (!manifestJson)
-                return { settingsName: this.dbName };
-            try {
-                return JSON.parse(manifestJson);
-            }
-            catch (e) {
-                throw new Error(`Failed to parse manifest in SettingsDb "${this.dbName}": ${e instanceof Error ? e.message : String(e)}`);
-            }
-        });
-    }
-    /** Check whether the underlying database has a settings manifest property.
-     * Used to validate that a container actually holds a SettingsDb rather than a WorkspaceDb.
-     */
-    get hasSettingsManifestProperty() {
-        return this.withOpenDb((db) => {
-            const manifestJson = db[_nativeDb].queryFileProperty(settingsManifestProperty, true);
-            return manifestJson !== undefined;
-        });
-    }
-    withOpenDb(operation) {
-        const done = this.isOpen ? () => { } : (this.open(), () => this.close());
-        try {
-            return operation(this.sqliteDb);
-        }
-        finally {
-            done();
-        }
-    }
-    open() {
-        this.sqliteDb.openDb(this.dbFileName, OpenMode.Readonly, this._container.cloudContainer);
-    }
-    close() {
-        if (this.isOpen)
-            this.sqliteDb.closeDb();
-    }
-    getSettings() {
-        return this.withOpenDb((db) => {
-            return db.withSqliteStatement("SELECT value FROM strings WHERE id=?", (stmt) => {
-                stmt.bindString(1, settingsResourceName);
-                if (DbResult.BE_SQLITE_ROW !== stmt.step())
-                    return {};
-                try {
-                    // JSON.parse already returns a fresh object tree — no explicit clone needed.
-                    return JSON.parse(stmt.getValueString(0));
-                }
-                catch (e) {
-                    throw new Error(`Failed to parse settings in SettingsDb "${this.dbName}": ${e instanceof Error ? e.message : String(e)}`);
-                }
-            });
-        });
-    }
-    getSetting(settingName) {
-        const settings = this.getSettings();
-        if (!Object.hasOwn(settings, settingName))
-            return undefined;
-        const value = settings[settingName];
-        return value !== undefined ? Setting.clone(value) : undefined;
-    }
-}
-//# sourceMappingURL=SettingsDbImpl.js.map

package/lib/esm/internal/workspace/SettingsDbImpl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsDbImpl.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsDbImpl.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 Workspace\r\n */\r\n\r\nimport { DbResult, OpenMode } from \"@itwin/core-bentley\";\r\nimport { FilePropertyProps } from \"@itwin/core-common\";\r\nimport { CloudSqlite } from \"../../CloudSqlite\";\r\nimport { Setting, SettingName, SettingsContainer, SettingsPriority } from \"../../workspace/Settings\";\r\nimport { CloudSqliteContainer, WorkspaceDbName } from \"../../workspace/Workspace\";\r\nimport { SettingsDb, SettingsDbManifest, SettingsDbProps, settingsResourceName } from \"../../workspace/SettingsDb\";\r\nimport { WorkspaceSqliteDb } from \"./WorkspaceSqliteDb\";\r\nimport { _implementationProhibited, _nativeDb } from \"../Symbols\";\r\n\r\nexport const settingsDbDefaultName: WorkspaceDbName = \"settings-db\";\r\n\r\nexport const settingsManifestProperty: FilePropertyProps = { namespace: \"settings\", name: \"manifest\" };\r\n\r\n/** Internal implementation of [[SettingsDb]]. Wraps a [[WorkspaceSqliteDb]] to provide a\r\n * settings-only read interface over the `strings` table.\r\n */\r\nexport class SettingsDbImpl implements SettingsDb {\r\n  public readonly [_implementationProhibited] = undefined;\r\n  public readonly sqliteDb = new WorkspaceSqliteDb();\r\n  public readonly dbName: string;\r\n  public readonly dbFileName: string;\r\n  protected readonly _container: CloudSqliteContainer;\r\n  public readonly priority: SettingsPriority;\r\n  protected _manifest?: SettingsDbManifest;\r\n\r\n  public constructor(props: SettingsDbProps, container: CloudSqliteContainer, priority: SettingsPriority) {\r\n    this.dbName = props.dbName ?? settingsDbDefaultName;\r\n    CloudSqlite.validateDbName(this.dbName);\r\n    this._container = container;\r\n    this.dbFileName = container.resolveDbFileName(props);\r\n    this.priority = priority;\r\n  }\r\n\r\n  public get container(): CloudSqliteContainer { return this._container; }\r\n  public get isOpen() { return this.sqliteDb.isOpen; }\r\n\r\n  public get version(): string {\r\n    const cloudContainer = this.container.cloudContainer;\r\n    if (undefined === cloudContainer)\r\n      return \"0.0.0\";\r\n    return CloudSqlite.parseDbFileName(this.dbFileName).version;\r\n  }\r\n\r\n  public get manifest(): SettingsDbManifest {\r\n    return this._manifest ??= this.withOpenDb((db) => {\r\n      const manifestJson = db[_nativeDb].queryFileProperty(settingsManifestProperty, true) as string | undefined;\r\n      if (!manifestJson)\r\n        return { settingsName: this.dbName };\r\n      try {\r\n        return JSON.parse(manifestJson);\r\n      } catch (e) {\r\n        throw new Error(`Failed to parse manifest in SettingsDb \"${this.dbName}\": ${e instanceof Error ? e.message : String(e)}`);\r\n      }\r\n    });\r\n  }\r\n\r\n  /** Check whether the underlying database has a settings manifest property.\r\n   * Used to validate that a container actually holds a SettingsDb rather than a WorkspaceDb.\r\n   */\r\n  public get hasSettingsManifestProperty(): boolean {\r\n    return this.withOpenDb((db) => {\r\n      const manifestJson = db[_nativeDb].queryFileProperty(settingsManifestProperty, true) as string | undefined;\r\n      return manifestJson !== undefined;\r\n    });\r\n  }\r\n\r\n  protected withOpenDb<T>(operation: (db: WorkspaceSqliteDb) => T): T {\r\n    const done = this.isOpen ? () => { } : (this.open(), () => this.close());\r\n    try {\r\n      return operation(this.sqliteDb);\r\n    } finally {\r\n      done();\r\n    }\r\n  }\r\n\r\n  public open(): void {\r\n    this.sqliteDb.openDb(this.dbFileName, OpenMode.Readonly, this._container.cloudContainer);\r\n  }\r\n\r\n  public close(): void {\r\n    if (this.isOpen)\r\n      this.sqliteDb.closeDb();\r\n  }\r\n\r\n  public getSettings(): SettingsContainer {\r\n    return this.withOpenDb((db) => {\r\n      return db.withSqliteStatement(\"SELECT value FROM strings WHERE id=?\", (stmt) => {\r\n        stmt.bindString(1, settingsResourceName);\r\n        if (DbResult.BE_SQLITE_ROW !== stmt.step())\r\n          return {};\r\n        try {\r\n          // JSON.parse already returns a fresh object tree — no explicit clone needed.\r\n          return JSON.parse(stmt.getValueString(0));\r\n        } catch (e) {\r\n          throw new Error(`Failed to parse settings in SettingsDb \"${this.dbName}\": ${e instanceof Error ? e.message : String(e)}`);\r\n        }\r\n      });\r\n    });\r\n  }\r\n\r\n  public getSetting<T extends Setting>(settingName: SettingName): T | undefined {\r\n    const settings = this.getSettings();\r\n    if (!Object.hasOwn(settings, settingName))\r\n      return undefined;\r\n    const value = settings[settingName] as T | undefined;\r\n    return value !== undefined ? Setting.clone(value) : undefined;\r\n  }\r\n}\r\n"]}

package/lib/esm/internal/workspace/SettingsSqliteDb.d.ts

@@ -1,14 +0,0 @@
-/** @packageDocumentation
- * @module Workspace
- */
-import { SQLiteDb, VersionedSqliteDb } from "../../SQLiteDb";
-/** A [[VersionedSqliteDb]] that stores settings dictionaries. Unlike [[WorkspaceSqliteDb]], the
- * manifest is stored using [[settingsManifestProperty]] so that settings and workspace databases
- * can coexist in the same container without ambiguity.
- */
-export declare class SettingsSqliteDb extends VersionedSqliteDb {
-    myVersion: string;
-    getRequiredVersions(): SQLiteDb.RequiredVersionRanges;
-    protected createDDL(args: any): void;
-}
-//# sourceMappingURL=SettingsSqliteDb.d.ts.map

package/lib/esm/internal/workspace/SettingsSqliteDb.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsSqliteDb.d.ts","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSqliteDb.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAK7D;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;IACrC,SAAS,SAAW;IACpB,mBAAmB,IAAI,QAAQ,CAAC,qBAAqB;cAUlD,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;CAO9C"}

package/lib/esm/internal/workspace/SettingsSqliteDb.js

@@ -1,36 +0,0 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Workspace
- */
-import { VersionedSqliteDb } from "../../SQLiteDb";
-import { SqliteError } from "@itwin/core-common";
-import { _nativeDb } from "../Symbols";
-import { settingsManifestProperty } from "./SettingsDbImpl";
-/** A [[VersionedSqliteDb]] that stores settings dictionaries. Unlike [[WorkspaceSqliteDb]], the
- * manifest is stored using [[settingsManifestProperty]] so that settings and workspace databases
- * can coexist in the same container without ambiguity.
- */
-export class SettingsSqliteDb extends VersionedSqliteDb {
-    myVersion = "1.0.0";
-    getRequiredVersions() {
-        try {
-            return super.getRequiredVersions();
-        }
-        catch (e) {
-            if (SqliteError.isError(e, "invalid-versions-property"))
-                return { readVersion: "^1", writeVersion: "^1" };
-            throw e;
-        }
-    }
-    createDDL(args) {
-        const timeStampCol = "lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))";
-        this.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);
-        this.executeSQL(`CREATE TRIGGER strings_timeStamp AFTER UPDATE ON strings WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE strings SET lastMod=julianday('now') WHERE id=new.id; END`);
-        if (args?.manifest)
-            this[_nativeDb].saveFileProperty(settingsManifestProperty, JSON.stringify(args.manifest));
-    }
-}
-//# sourceMappingURL=SettingsSqliteDb.js.map

package/lib/esm/internal/workspace/SettingsSqliteDb.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsSqliteDb.js","sourceRoot":"","sources":["../../../../src/internal/workspace/SettingsSqliteDb.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAY,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB;IACrC,SAAS,GAAG,OAAO,CAAC;IACpB,mBAAmB;QACjC,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,mBAAmB,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,2BAA2B,CAAC;gBACrD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAEkB,SAAS,CAAC,IAAS;QACpC,MAAM,YAAY,GAAG,sDAAsD,CAAC;QAC5E,IAAI,CAAC,UAAU,CAAC,gEAAgE,YAAY,GAAG,CAAC,CAAC;QACjG,IAAI,CAAC,UAAU,CAAC,kMAAkM,CAAC,CAAC;QACpN,IAAI,IAAI,EAAE,QAAQ;YAChB,IAAI,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Workspace\r\n */\r\n\r\nimport { SQLiteDb, VersionedSqliteDb } from \"../../SQLiteDb\";\r\nimport { SqliteError } from \"@itwin/core-common\";\r\nimport { _nativeDb } from \"../Symbols\";\r\nimport { settingsManifestProperty } from \"./SettingsDbImpl\";\r\n\r\n/** A [[VersionedSqliteDb]] that stores settings dictionaries. Unlike [[WorkspaceSqliteDb]], the\r\n * manifest is stored using [[settingsManifestProperty]] so that settings and workspace databases\r\n * can coexist in the same container without ambiguity.\r\n */\r\nexport class SettingsSqliteDb extends VersionedSqliteDb {\r\n  public override myVersion = \"1.0.0\";\r\n  public override getRequiredVersions(): SQLiteDb.RequiredVersionRanges {\r\n    try {\r\n      return super.getRequiredVersions();\r\n    } catch (e) {\r\n      if (SqliteError.isError(e, \"invalid-versions-property\"))\r\n        return { readVersion: \"^1\", writeVersion: \"^1\" };\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  protected override createDDL(args: any): void {\r\n    const timeStampCol = \"lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\";\r\n    this.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);\r\n    this.executeSQL(`CREATE TRIGGER strings_timeStamp AFTER UPDATE ON strings WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE strings SET lastMod=julianday('now') WHERE id=new.id; END`);\r\n    if (args?.manifest)\r\n      this[_nativeDb].saveFileProperty(settingsManifestProperty, JSON.stringify(args.manifest));\r\n  }\r\n}\r\n"]}