@itwin/core-backend 5.15.0-dev.9 → 5.15.0

package/lib/esm/test/standalone/EditTxn.test.js

@@ -6,7 +6,8 @@ import { Logger, OpenMode } from "@itwin/core-bentley";
 import { expect } from "chai";
 import * as sinon from "sinon";
 import { EditTxnError } from "@itwin/core-common";
-import { EditTxn, IModelJsFs, StandaloneDb } from "../../core-backend";
+import { BackendLoggerCategory, EditTxn, IModelJsFs, StandaloneDb, withEditTxn } from "../../core-backend";
+import { _nativeDb } from "../../internal/Symbols";
 import { IModelTestUtils } from "../IModelTestUtils";
 class TestEditTxn extends EditTxn {
     constructor(iModel) {
@@ -177,6 +178,76 @@ describe("EditTxn", () => {
         second.end("abandon");
         expect(second.isActive).to.be.false;
     });
+    for (const mode of ["save", "abandon"]) {
+        it(`retains transaction ownership when native ${mode} fails`, () => {
+            const txn = new TestEditTxn(iModel);
+            txn.start();
+            txn.writeFileProperty("pending", "value");
+            const failure = new Error(`native ${mode} failed`);
+            const nativeOperation = sinon.stub(iModel[_nativeDb], mode === "save" ? "saveChanges" : "abandonChanges").throws(failure);
+            expect(() => txn.end(mode)).to.throw(failure);
+            expect(txn.isActive).to.be.true;
+            expect(iModel.txns.hasUnsavedChanges).to.be.true;
+            nativeOperation.restore();
+            txn.end("abandon");
+            expect(txn.isActive).to.be.false;
+            expect(iModel.queryFilePropertyString({ name: "pending", namespace: "EditTxnTest" })).to.be.undefined;
+        });
+    }
+    it("preserves the callback error and transaction ownership when scoped native abandonment fails", () => {
+        const failure = new Error("callback failure");
+        const abandonFailure = new Error("native abandonment failed");
+        const nativeOperation = sinon.stub(iModel[_nativeDb], "abandonChanges").throws(abandonFailure);
+        const logError = sinon.spy(Logger, "logError");
+        let activeTxn;
+        expect(() => withEditTxn(iModel, (txn) => {
+            activeTxn = txn;
+            txn.saveFileProperty({ name: "pending", namespace: "EditTxnTest" }, "value");
+            throw failure;
+        })).to.throw(failure);
+        expect(activeTxn?.isActive).to.be.true;
+        expect(iModel.txns.hasUnsavedChanges).to.be.true;
+        expect(logError.calledOnceWithExactly(BackendLoggerCategory.IModelDb, abandonFailure)).to.be.true;
+        nativeOperation.restore();
+        activeTxn?.end("abandon");
+        expect(iModel.queryFilePropertyString({ name: "pending", namespace: "EditTxnTest" })).to.be.undefined;
+    });
+    for (const asynchronous of [false, true]) {
+        it(`preserves the ${asynchronous ? "asynchronous" : "synchronous"} callback error when rollback and error logging both fail`, async () => {
+            const failure = new Error("callback failure");
+            const abandonFailure = new Error("native abandonment failed");
+            const loggingFailure = new Error("error logging failed");
+            const nativeOperation = sinon.stub(iModel[_nativeDb], "abandonChanges").throws(abandonFailure);
+            const logError = sinon.stub(Logger, "logError").throws(loggingFailure);
+            let activeTxn;
+            const edit = (txn) => {
+                activeTxn = txn;
+                txn.saveFileProperty({ name: "pending", namespace: "EditTxnTest" }, "value");
+                throw failure;
+            };
+            try {
+                if (asynchronous) {
+                    const error = await withEditTxn(iModel, async (txn) => {
+                        await Promise.resolve();
+                        edit(txn);
+                    }).catch((err) => err);
+                    expect(error).to.equal(failure);
+                }
+                else {
+                    expect(() => withEditTxn(iModel, edit)).to.throw(failure);
+                }
+                expect(logError.calledOnceWithExactly(BackendLoggerCategory.IModelDb, abandonFailure)).to.be.true;
+                expect(logError.firstCall.exception).to.equal(loggingFailure);
+                expect(activeTxn?.isActive).to.be.true;
+                expect(iModel.txns.hasUnsavedChanges).to.be.true;
+            }
+            finally {
+                nativeOperation.restore();
+                activeTxn?.end("abandon");
+            }
+            expect(iModel.queryFilePropertyString({ name: "pending", namespace: "EditTxnTest" })).to.be.undefined;
+        });
+    }
     it("uses the default description unless save is given an override", () => {
         const txn = new EditTxn(iModel, "default description");
         txn.start();

package/lib/esm/test/standalone/EditTxn.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"EditTxn.test.js","sourceRoot":"","sources":["../../../../src/test/standalone/EditTxn.test.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\r\nimport { Logger, OpenMode } from \"@itwin/core-bentley\";\r\nimport { expect } from \"chai\";\r\nimport * as sinon from \"sinon\";\r\nimport { EditTxnError } from \"@itwin/core-common\";\r\nimport { EditTxn, type IModelDb, IModelJsFs, StandaloneDb } from \"../../core-backend\";\r\nimport { IModelTestUtils } from \"../IModelTestUtils\";\r\n\r\nclass TestEditTxn extends EditTxn {\r\n  public constructor(iModel: IModelDb) {\r\n    super(iModel, \"test\");\r\n  }\r\n\r\n  public writeFileProperty(name: string, value: string | undefined): void {\r\n    super.saveFileProperty({ name, namespace: \"EditTxnTest\" }, value);\r\n  }\r\n}\r\n\r\nclass AbandonOnCloseEditTxn extends TestEditTxn {\r\n  public override onClose(): void {\r\n    if (this.isActive)\r\n      this.abandonChanges();\r\n  }\r\n}\r\n\r\nfunction expectEditTxnError(fn: () => void, key: EditTxnError.Key): void {\r\n  expect(fn).to.throw().that.satisfies((error: unknown) => EditTxnError.isError(error, key));\r\n}\r\n\r\nfunction legacyWriteFileProperty(iModel: StandaloneDb, name: string, value: string): void {\r\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n  iModel.saveFileProperty({ name, namespace: \"EditTxnTest\" }, value);\r\n}\r\n\r\ndescribe(\"EditTxn\", () => {\r\n  let iModel: StandaloneDb;\r\n  let fileName: string;\r\n\r\n  beforeEach(() => {\r\n    EditTxn.implicitWriteEnforcement = \"allow\";\r\n    fileName = IModelTestUtils.prepareOutputFile(\"EditTxn\", \"EditTxn.bim\");\r\n    iModel = StandaloneDb.createEmpty(fileName, {\r\n      rootSubject: { name: \"EditTxn\" },\r\n      enableTransactions: true,\r\n    });\r\n  });\r\n\r\n  afterEach(() => {\r\n    EditTxn.implicitWriteEnforcement = \"allow\";\r\n    sinon.restore();\r\n\r\n    if (iModel.isOpen)\r\n      iModel.close();\r\n\r\n    IModelJsFs.removeSync(fileName);\r\n  });\r\n\r\n  it(\"allows implicit writes before and after explicit txn scopes\", () => {\r\n    // Implicit IModelDb mutators should work before any explicit EditTxn starts.\r\n    legacyWriteFileProperty(iModel, \"legacy-before-start\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy-before-start\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.abandonChanges();\r\n\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n    expect(txn.isActive).to.be.true;\r\n\r\n    txn.writeFileProperty(\"cancelled\", \"value\");\r\n    txn.end(\"abandon\");\r\n    // After canceling, implicit writes should still work.\r\n    expect(txn.isActive).to.be.false;\r\n    legacyWriteFileProperty(iModel, \"legacy-after-cancel\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy-after-cancel\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.abandonChanges();\r\n    expect(iModel.queryFilePropertyString({ name: \"cancelled\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n\r\n    txn.start();\r\n    txn.writeFileProperty(\"saved\", \"value\");\r\n    txn.end();\r\n    // Committing also leaves the iModel ready for later implicit writes.\r\n    expect(txn.isActive).to.be.false;\r\n    expect(iModel.queryFilePropertyString({ name: \"saved\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n    legacyWriteFileProperty(iModel, \"legacy-after-end\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy-after-end\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n  });\r\n\r\n  it(\"enforces identical explicit transaction behavior across allow, log, and throw settings\", () => {\r\n    const settings: Array<\"allow\" | \"log\" | \"throw\"> = [\"allow\", \"log\", \"throw\"];\r\n\r\n    for (const setting of settings) {\r\n      EditTxn.implicitWriteEnforcement = setting;\r\n      const txn = new TestEditTxn(iModel);\r\n      const inactiveName = `inactive-${setting}`;\r\n      const savedName = `saved-${setting}`;\r\n      const inactiveAgainName = `inactive-again-${setting}`;\r\n\r\n      // Inactive explicit txn writes must always fail, regardless of enforcement.\r\n      expectEditTxnError(() => txn.writeFileProperty(inactiveName, \"value\"), \"not-active\");\r\n      expectEditTxnError(() => txn.saveChanges(`save ${inactiveName}`), \"not-active\");\r\n      expect(iModel.queryFilePropertyString({ name: inactiveName, namespace: \"EditTxnTest\" })).to.be.undefined;\r\n      expectEditTxnError(() => txn.end(\"abandon\"), \"not-active\");\r\n\r\n      txn.start();\r\n      txn.writeFileProperty(savedName, \"value\");\r\n      txn.saveChanges(`save ${savedName}`);\r\n      expect(txn.isActive).to.be.true;\r\n\r\n      txn.end();\r\n      expect(iModel.queryFilePropertyString({ name: savedName, namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n\r\n      expectEditTxnError(() => txn.writeFileProperty(inactiveAgainName, \"value\"), \"not-active\");\r\n      expectEditTxnError(() => txn.saveChanges(`save ${inactiveAgainName}`), \"not-active\");\r\n      expect(iModel.queryFilePropertyString({ name: inactiveAgainName, namespace: \"EditTxnTest\" })).to.be.undefined;\r\n      expectEditTxnError(() => txn.end(\"abandon\"), \"not-active\");\r\n    }\r\n  });\r\n\r\n  it(\"logs implicit writes in log mode but still rejects inactive explicit writes\", () => {\r\n    EditTxn.implicitWriteEnforcement = \"log\";\r\n    const logError = sinon.spy(Logger, \"logError\");\r\n    const txn = new TestEditTxn(iModel);\r\n\r\n    legacyWriteFileProperty(iModel, \"implicit-log\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"implicit-log\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n    expect(logError.called).to.be.true;\r\n    expect(logError.firstCall.args[0]).to.equal(\"core-backend.IModelDb\");\r\n    expect(EditTxnError.isError(logError.firstCall.args[1], \"implicit-txn-write-disallowed\")).to.be.true;\r\n\r\n    const callCount = logError.callCount;\r\n    expectEditTxnError(() => txn.writeFileProperty(\"inactive-log\", \"value\"), \"not-active\");\r\n    expectEditTxnError(() => txn.saveChanges(\"save inactive log\"), \"not-active\");\r\n    expect(logError.callCount).to.equal(callCount);\r\n    expectEditTxnError(() => txn.end(\"abandon\"), \"not-active\");\r\n  });\r\n\r\n  it(\"rejects implicit writes in throw mode and still allows active explicit writes\", () => {\r\n    EditTxn.implicitWriteEnforcement = \"throw\";\r\n\r\n    expectEditTxnError(() => legacyWriteFileProperty(iModel, \"implicit-throw\", \"value\"), \"implicit-txn-write-disallowed\");\r\n    expect(iModel.queryFilePropertyString({ name: \"implicit-throw\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n    txn.writeFileProperty(\"explicit-enforce\", \"value\");\r\n    txn.end();\r\n\r\n    expect(iModel.queryFilePropertyString({ name: \"explicit-enforce\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n  });\r\n\r\n  it(\"throws when started with unsaved changes\", () => {\r\n    // Unsaved changes made through the implicit surface block a new explicit EditTxn.\r\n    legacyWriteFileProperty(iModel, \"unsaved\", \"value\");\r\n\r\n    const txn = new TestEditTxn(iModel);\r\n    expectEditTxnError(() => txn.start(), \"unsaved-changes\");\r\n\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.abandonChanges();\r\n    legacyWriteFileProperty(iModel, \"legacy-after-abandon\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy-after-abandon\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n  });\r\n\r\n  it(\"rejects starting an explicit txn while another explicit txn is active\", () => {\r\n    const first = new TestEditTxn(iModel);\r\n    const second = new TestEditTxn(iModel);\r\n\r\n    first.start();\r\n    expect(first.isActive).to.be.true;\r\n\r\n    // EditTxn.start() now requires the implicit txn to be active, so a second explicit txn cannot start yet.\r\n    expectEditTxnError(() => second.start(), \"already-active\");\r\n    expect(first.isActive).to.be.true;\r\n    expect(second.isActive).to.be.false;\r\n\r\n    first.end(\"abandon\");\r\n    expect(first.isActive).to.be.false;\r\n  });\r\n\r\n  it(\"allows deprecated mutating APIs while an explicit txn is active when enforcement is none\", () => {\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n\r\n    // Deprecated IModelDb mutators route through the implicit txn and are allowed in compatibility mode.\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.saveFileProperty({ name: \"legacy\", namespace: \"EditTxnTest\" }, \"value\");\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.saveChanges(\"legacy save\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n\r\n    txn.writeFileProperty(\"explicit\", \"value\");\r\n    txn.saveChanges(\"explicit save\");\r\n    expect(iModel.queryFilePropertyString({ name: \"explicit\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n\r\n    txn.end(\"abandon\");\r\n    expect(txn.isActive).to.be.false;\r\n  });\r\n\r\n  it(\"allows starting a new explicit txn when only pending changes exist\", () => {\r\n    const first = new TestEditTxn(iModel);\r\n    const second = new TestEditTxn(iModel);\r\n\r\n    first.start();\r\n    first.writeFileProperty(\"pending\", \"value\");\r\n    first.saveChanges(\"save pending\");\r\n\r\n    // Saved-but-unpushed changes are allowed; only unsaved local changes block start().\r\n    expect(iModel.txns.hasPendingTxns).to.be.true;\r\n    expect(iModel.txns.hasUnsavedChanges).to.be.false;\r\n\r\n    first.end(\"abandon\");\r\n    expect(() => second.start()).to.not.throw();\r\n    expect(first.isActive).to.be.false;\r\n    expect(second.isActive).to.be.true;\r\n\r\n    second.end(\"abandon\");\r\n    expect(second.isActive).to.be.false;\r\n  });\r\n\r\n  it(\"uses the default description unless save is given an override\", () => {\r\n    const txn = new EditTxn(iModel, \"default description\");\r\n\r\n    txn.start();\r\n    txn.saveFileProperty({ name: \"default-description\", namespace: \"EditTxnTest\" }, \"value\");\r\n    txn.saveChanges();\r\n    expect(iModel.txns.getLastSavedTxnProps()?.props.description).to.equal(\"default description\");\r\n\r\n    txn.saveFileProperty({ name: \"override-description\", namespace: \"EditTxnTest\" }, \"value\");\r\n    txn.end(\"save\", \"override description\");\r\n    expect(iModel.txns.getLastSavedTxnProps()?.props.description).to.equal(\"override description\");\r\n  });\r\n\r\n  it(\"reverseTxns abandons unsaved changes from the active explicit txn\", () => {\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n    txn.writeFileProperty(\"reverse\", \"value\");\r\n\r\n    // Reversing txns abandons the active explicit txn's local changes, but the explicit txn remains active.\r\n    iModel.txns.reverseTxns(1);\r\n\r\n    expect(txn.isActive).to.be.true;\r\n    expect(iModel.txns.hasUnsavedChanges).to.be.false;\r\n    expect(iModel.queryFilePropertyString({ name: \"reverse\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n\r\n    txn.end(\"abandon\");\r\n    expect(txn.isActive).to.be.false;\r\n  });\r\n\r\n  it(\"saves unsaved changes from the active explicit txn when the iModel closes\", () => {\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n    txn.writeFileProperty(\"unsaved-on-close\", \"value\");\r\n\r\n    iModel.close();\r\n    iModel = StandaloneDb.openFile(fileName, OpenMode.Readonly);\r\n\r\n    expect(iModel.queryFilePropertyString({ name: \"unsaved-on-close\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n  });\r\n\r\n  it(\"allows subclasses to abandon unsaved changes when the iModel closes\", () => {\r\n    const txn = new AbandonOnCloseEditTxn(iModel);\r\n    txn.start();\r\n    txn.writeFileProperty(\"saved-on-close\", \"value\");\r\n\r\n    iModel.close();\r\n    iModel = StandaloneDb.openFile(fileName, OpenMode.Readonly);\r\n\r\n    expect(iModel.queryFilePropertyString({ name: \"saved-on-close\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n  });\r\n});\r\n\r\n"]}
+{"version":3,"file":"EditTxn.test.js","sourceRoot":"","sources":["../../../../src/test/standalone/EditTxn.test.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\r\nimport { Logger, OpenMode } from \"@itwin/core-bentley\";\r\nimport { expect } from \"chai\";\r\nimport * as sinon from \"sinon\";\r\nimport { EditTxnError } from \"@itwin/core-common\";\r\nimport { BackendLoggerCategory, EditTxn, type IModelDb, IModelJsFs, StandaloneDb, withEditTxn } from \"../../core-backend\";\r\nimport { _nativeDb } from \"../../internal/Symbols\";\r\nimport { IModelTestUtils } from \"../IModelTestUtils\";\r\n\r\nclass TestEditTxn extends EditTxn {\r\n  public constructor(iModel: IModelDb) {\r\n    super(iModel, \"test\");\r\n  }\r\n\r\n  public writeFileProperty(name: string, value: string | undefined): void {\r\n    super.saveFileProperty({ name, namespace: \"EditTxnTest\" }, value);\r\n  }\r\n}\r\n\r\nclass AbandonOnCloseEditTxn extends TestEditTxn {\r\n  public override onClose(): void {\r\n    if (this.isActive)\r\n      this.abandonChanges();\r\n  }\r\n}\r\n\r\nfunction expectEditTxnError(fn: () => void, key: EditTxnError.Key): void {\r\n  expect(fn).to.throw().that.satisfies((error: unknown) => EditTxnError.isError(error, key));\r\n}\r\n\r\nfunction legacyWriteFileProperty(iModel: StandaloneDb, name: string, value: string): void {\r\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n  iModel.saveFileProperty({ name, namespace: \"EditTxnTest\" }, value);\r\n}\r\n\r\ndescribe(\"EditTxn\", () => {\r\n  let iModel: StandaloneDb;\r\n  let fileName: string;\r\n\r\n  beforeEach(() => {\r\n    EditTxn.implicitWriteEnforcement = \"allow\";\r\n    fileName = IModelTestUtils.prepareOutputFile(\"EditTxn\", \"EditTxn.bim\");\r\n    iModel = StandaloneDb.createEmpty(fileName, {\r\n      rootSubject: { name: \"EditTxn\" },\r\n      enableTransactions: true,\r\n    });\r\n  });\r\n\r\n  afterEach(() => {\r\n    EditTxn.implicitWriteEnforcement = \"allow\";\r\n    sinon.restore();\r\n\r\n    if (iModel.isOpen)\r\n      iModel.close();\r\n\r\n    IModelJsFs.removeSync(fileName);\r\n  });\r\n\r\n  it(\"allows implicit writes before and after explicit txn scopes\", () => {\r\n    // Implicit IModelDb mutators should work before any explicit EditTxn starts.\r\n    legacyWriteFileProperty(iModel, \"legacy-before-start\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy-before-start\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.abandonChanges();\r\n\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n    expect(txn.isActive).to.be.true;\r\n\r\n    txn.writeFileProperty(\"cancelled\", \"value\");\r\n    txn.end(\"abandon\");\r\n    // After canceling, implicit writes should still work.\r\n    expect(txn.isActive).to.be.false;\r\n    legacyWriteFileProperty(iModel, \"legacy-after-cancel\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy-after-cancel\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.abandonChanges();\r\n    expect(iModel.queryFilePropertyString({ name: \"cancelled\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n\r\n    txn.start();\r\n    txn.writeFileProperty(\"saved\", \"value\");\r\n    txn.end();\r\n    // Committing also leaves the iModel ready for later implicit writes.\r\n    expect(txn.isActive).to.be.false;\r\n    expect(iModel.queryFilePropertyString({ name: \"saved\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n    legacyWriteFileProperty(iModel, \"legacy-after-end\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy-after-end\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n  });\r\n\r\n  it(\"enforces identical explicit transaction behavior across allow, log, and throw settings\", () => {\r\n    const settings: Array<\"allow\" | \"log\" | \"throw\"> = [\"allow\", \"log\", \"throw\"];\r\n\r\n    for (const setting of settings) {\r\n      EditTxn.implicitWriteEnforcement = setting;\r\n      const txn = new TestEditTxn(iModel);\r\n      const inactiveName = `inactive-${setting}`;\r\n      const savedName = `saved-${setting}`;\r\n      const inactiveAgainName = `inactive-again-${setting}`;\r\n\r\n      // Inactive explicit txn writes must always fail, regardless of enforcement.\r\n      expectEditTxnError(() => txn.writeFileProperty(inactiveName, \"value\"), \"not-active\");\r\n      expectEditTxnError(() => txn.saveChanges(`save ${inactiveName}`), \"not-active\");\r\n      expect(iModel.queryFilePropertyString({ name: inactiveName, namespace: \"EditTxnTest\" })).to.be.undefined;\r\n      expectEditTxnError(() => txn.end(\"abandon\"), \"not-active\");\r\n\r\n      txn.start();\r\n      txn.writeFileProperty(savedName, \"value\");\r\n      txn.saveChanges(`save ${savedName}`);\r\n      expect(txn.isActive).to.be.true;\r\n\r\n      txn.end();\r\n      expect(iModel.queryFilePropertyString({ name: savedName, namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n\r\n      expectEditTxnError(() => txn.writeFileProperty(inactiveAgainName, \"value\"), \"not-active\");\r\n      expectEditTxnError(() => txn.saveChanges(`save ${inactiveAgainName}`), \"not-active\");\r\n      expect(iModel.queryFilePropertyString({ name: inactiveAgainName, namespace: \"EditTxnTest\" })).to.be.undefined;\r\n      expectEditTxnError(() => txn.end(\"abandon\"), \"not-active\");\r\n    }\r\n  });\r\n\r\n  it(\"logs implicit writes in log mode but still rejects inactive explicit writes\", () => {\r\n    EditTxn.implicitWriteEnforcement = \"log\";\r\n    const logError = sinon.spy(Logger, \"logError\");\r\n    const txn = new TestEditTxn(iModel);\r\n\r\n    legacyWriteFileProperty(iModel, \"implicit-log\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"implicit-log\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n    expect(logError.called).to.be.true;\r\n    expect(logError.firstCall.args[0]).to.equal(\"core-backend.IModelDb\");\r\n    expect(EditTxnError.isError(logError.firstCall.args[1], \"implicit-txn-write-disallowed\")).to.be.true;\r\n\r\n    const callCount = logError.callCount;\r\n    expectEditTxnError(() => txn.writeFileProperty(\"inactive-log\", \"value\"), \"not-active\");\r\n    expectEditTxnError(() => txn.saveChanges(\"save inactive log\"), \"not-active\");\r\n    expect(logError.callCount).to.equal(callCount);\r\n    expectEditTxnError(() => txn.end(\"abandon\"), \"not-active\");\r\n  });\r\n\r\n  it(\"rejects implicit writes in throw mode and still allows active explicit writes\", () => {\r\n    EditTxn.implicitWriteEnforcement = \"throw\";\r\n\r\n    expectEditTxnError(() => legacyWriteFileProperty(iModel, \"implicit-throw\", \"value\"), \"implicit-txn-write-disallowed\");\r\n    expect(iModel.queryFilePropertyString({ name: \"implicit-throw\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n    txn.writeFileProperty(\"explicit-enforce\", \"value\");\r\n    txn.end();\r\n\r\n    expect(iModel.queryFilePropertyString({ name: \"explicit-enforce\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n  });\r\n\r\n  it(\"throws when started with unsaved changes\", () => {\r\n    // Unsaved changes made through the implicit surface block a new explicit EditTxn.\r\n    legacyWriteFileProperty(iModel, \"unsaved\", \"value\");\r\n\r\n    const txn = new TestEditTxn(iModel);\r\n    expectEditTxnError(() => txn.start(), \"unsaved-changes\");\r\n\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.abandonChanges();\r\n    legacyWriteFileProperty(iModel, \"legacy-after-abandon\", \"value\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy-after-abandon\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n  });\r\n\r\n  it(\"rejects starting an explicit txn while another explicit txn is active\", () => {\r\n    const first = new TestEditTxn(iModel);\r\n    const second = new TestEditTxn(iModel);\r\n\r\n    first.start();\r\n    expect(first.isActive).to.be.true;\r\n\r\n    // EditTxn.start() now requires the implicit txn to be active, so a second explicit txn cannot start yet.\r\n    expectEditTxnError(() => second.start(), \"already-active\");\r\n    expect(first.isActive).to.be.true;\r\n    expect(second.isActive).to.be.false;\r\n\r\n    first.end(\"abandon\");\r\n    expect(first.isActive).to.be.false;\r\n  });\r\n\r\n  it(\"allows deprecated mutating APIs while an explicit txn is active when enforcement is none\", () => {\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n\r\n    // Deprecated IModelDb mutators route through the implicit txn and are allowed in compatibility mode.\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.saveFileProperty({ name: \"legacy\", namespace: \"EditTxnTest\" }, \"value\");\r\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\r\n    iModel.saveChanges(\"legacy save\");\r\n    expect(iModel.queryFilePropertyString({ name: \"legacy\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n\r\n    txn.writeFileProperty(\"explicit\", \"value\");\r\n    txn.saveChanges(\"explicit save\");\r\n    expect(iModel.queryFilePropertyString({ name: \"explicit\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n\r\n    txn.end(\"abandon\");\r\n    expect(txn.isActive).to.be.false;\r\n  });\r\n\r\n  it(\"allows starting a new explicit txn when only pending changes exist\", () => {\r\n    const first = new TestEditTxn(iModel);\r\n    const second = new TestEditTxn(iModel);\r\n\r\n    first.start();\r\n    first.writeFileProperty(\"pending\", \"value\");\r\n    first.saveChanges(\"save pending\");\r\n\r\n    // Saved-but-unpushed changes are allowed; only unsaved local changes block start().\r\n    expect(iModel.txns.hasPendingTxns).to.be.true;\r\n    expect(iModel.txns.hasUnsavedChanges).to.be.false;\r\n\r\n    first.end(\"abandon\");\r\n    expect(() => second.start()).to.not.throw();\r\n    expect(first.isActive).to.be.false;\r\n    expect(second.isActive).to.be.true;\r\n\r\n    second.end(\"abandon\");\r\n    expect(second.isActive).to.be.false;\r\n  });\r\n\r\n  for (const mode of [\"save\", \"abandon\"] as const) {\r\n    it(`retains transaction ownership when native ${mode} fails`, () => {\r\n      const txn = new TestEditTxn(iModel);\r\n      txn.start();\r\n      txn.writeFileProperty(\"pending\", \"value\");\r\n      const failure = new Error(`native ${mode} failed`);\r\n      const nativeOperation = sinon.stub(iModel[_nativeDb], mode === \"save\" ? \"saveChanges\" : \"abandonChanges\").throws(failure);\r\n      expect(() => txn.end(mode)).to.throw(failure);\r\n      expect(txn.isActive).to.be.true;\r\n      expect(iModel.txns.hasUnsavedChanges).to.be.true;\r\n      nativeOperation.restore();\r\n      txn.end(\"abandon\");\r\n      expect(txn.isActive).to.be.false;\r\n      expect(iModel.queryFilePropertyString({ name: \"pending\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n    });\r\n  }\r\n\r\n  it(\"preserves the callback error and transaction ownership when scoped native abandonment fails\", () => {\r\n    const failure = new Error(\"callback failure\");\r\n    const abandonFailure = new Error(\"native abandonment failed\");\r\n    const nativeOperation = sinon.stub(iModel[_nativeDb], \"abandonChanges\").throws(abandonFailure);\r\n    const logError = sinon.spy(Logger, \"logError\");\r\n    let activeTxn: EditTxn | undefined;\r\n    expect(() => withEditTxn(iModel, (txn) => {\r\n      activeTxn = txn;\r\n      txn.saveFileProperty({ name: \"pending\", namespace: \"EditTxnTest\" }, \"value\");\r\n      throw failure;\r\n    })).to.throw(failure);\r\n    expect(activeTxn?.isActive).to.be.true;\r\n    expect(iModel.txns.hasUnsavedChanges).to.be.true;\r\n    expect(logError.calledOnceWithExactly(BackendLoggerCategory.IModelDb, abandonFailure)).to.be.true;\r\n    nativeOperation.restore();\r\n    activeTxn?.end(\"abandon\");\r\n    expect(iModel.queryFilePropertyString({ name: \"pending\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n  });\r\n\r\n  for (const asynchronous of [false, true]) {\r\n    it(`preserves the ${asynchronous ? \"asynchronous\" : \"synchronous\"} callback error when rollback and error logging both fail`, async () => {\r\n      const failure = new Error(\"callback failure\");\r\n      const abandonFailure = new Error(\"native abandonment failed\");\r\n      const loggingFailure = new Error(\"error logging failed\");\r\n      const nativeOperation = sinon.stub(iModel[_nativeDb], \"abandonChanges\").throws(abandonFailure);\r\n      const logError = sinon.stub(Logger, \"logError\").throws(loggingFailure);\r\n      let activeTxn: EditTxn | undefined;\r\n      const edit = (txn: EditTxn) => {\r\n        activeTxn = txn;\r\n        txn.saveFileProperty({ name: \"pending\", namespace: \"EditTxnTest\" }, \"value\");\r\n        throw failure;\r\n      };\r\n      try {\r\n        if (asynchronous) {\r\n          const error = await withEditTxn(iModel, async (txn) => {\r\n            await Promise.resolve();\r\n            edit(txn);\r\n          }).catch((err: unknown) => err);\r\n          expect(error).to.equal(failure);\r\n        } else {\r\n          expect(() => withEditTxn(iModel, edit)).to.throw(failure);\r\n        }\r\n        expect(logError.calledOnceWithExactly(BackendLoggerCategory.IModelDb, abandonFailure)).to.be.true;\r\n        expect(logError.firstCall.exception).to.equal(loggingFailure);\r\n        expect(activeTxn?.isActive).to.be.true;\r\n        expect(iModel.txns.hasUnsavedChanges).to.be.true;\r\n      } finally {\r\n        nativeOperation.restore();\r\n        activeTxn?.end(\"abandon\");\r\n      }\r\n      expect(iModel.queryFilePropertyString({ name: \"pending\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n    });\r\n  }\r\n\r\n  it(\"uses the default description unless save is given an override\", () => {\r\n    const txn = new EditTxn(iModel, \"default description\");\r\n\r\n    txn.start();\r\n    txn.saveFileProperty({ name: \"default-description\", namespace: \"EditTxnTest\" }, \"value\");\r\n    txn.saveChanges();\r\n    expect(iModel.txns.getLastSavedTxnProps()?.props.description).to.equal(\"default description\");\r\n\r\n    txn.saveFileProperty({ name: \"override-description\", namespace: \"EditTxnTest\" }, \"value\");\r\n    txn.end(\"save\", \"override description\");\r\n    expect(iModel.txns.getLastSavedTxnProps()?.props.description).to.equal(\"override description\");\r\n  });\r\n\r\n  it(\"reverseTxns abandons unsaved changes from the active explicit txn\", () => {\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n    txn.writeFileProperty(\"reverse\", \"value\");\r\n\r\n    // Reversing txns abandons the active explicit txn's local changes, but the explicit txn remains active.\r\n    iModel.txns.reverseTxns(1);\r\n\r\n    expect(txn.isActive).to.be.true;\r\n    expect(iModel.txns.hasUnsavedChanges).to.be.false;\r\n    expect(iModel.queryFilePropertyString({ name: \"reverse\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n\r\n    txn.end(\"abandon\");\r\n    expect(txn.isActive).to.be.false;\r\n  });\r\n\r\n  it(\"saves unsaved changes from the active explicit txn when the iModel closes\", () => {\r\n    const txn = new TestEditTxn(iModel);\r\n    txn.start();\r\n    txn.writeFileProperty(\"unsaved-on-close\", \"value\");\r\n\r\n    iModel.close();\r\n    iModel = StandaloneDb.openFile(fileName, OpenMode.Readonly);\r\n\r\n    expect(iModel.queryFilePropertyString({ name: \"unsaved-on-close\", namespace: \"EditTxnTest\" })).to.equal(\"value\");\r\n  });\r\n\r\n  it(\"allows subclasses to abandon unsaved changes when the iModel closes\", () => {\r\n    const txn = new AbandonOnCloseEditTxn(iModel);\r\n    txn.start();\r\n    txn.writeFileProperty(\"saved-on-close\", \"value\");\r\n\r\n    iModel.close();\r\n    iModel = StandaloneDb.openFile(fileName, OpenMode.Readonly);\r\n\r\n    expect(iModel.queryFilePropertyString({ name: \"saved-on-close\", namespace: \"EditTxnTest\" })).to.be.undefined;\r\n  });\r\n});\r\n"]}

package/lib/esm/test/standalone/GeoCoordConfig.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GeoCoordConfig.test.d.ts.map

package/lib/esm/test/standalone/GeoCoordConfig.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoCoordConfig.test.d.ts","sourceRoot":"","sources":["../../../../src/test/standalone/GeoCoordConfig.test.ts"],"names":[],"mappings":""}

package/lib/esm/test/standalone/GeoCoordConfig.test.js

@@ -0,0 +1,158 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { expect } from "chai";
+import * as sinon from "sinon";
+import { Logger } from "@itwin/core-bentley";
+import { CloudSqlite, GeoCoordConfig, IModelHost } from "../../core-backend";
+import { IModelNative } from "../../internal/NativePlatform";
+import { constructWorkspace } from "../../internal/workspace/WorkspaceImpl";
+import { SettingsImpl } from "../../internal/workspace/SettingsImpl";
+import { SettingsPriority } from "../../workspace/Settings";
+import { TestUtils } from "../TestUtils";
+describe("GeoCoordConfig", () => {
+    const dbProps = { baseUri: "", storageType: "azure", containerId: "gcs-retry-test", dbName: "vertical", prefetch: true };
+    const sandbox = sinon.createSandbox();
+    let getContainer;
+    let getArray;
+    let getBoolean;
+    let queryDatabase;
+    let addWorkspace;
+    let prefetch;
+    let logError;
+    let connected;
+    beforeEach(() => {
+        GeoCoordConfig.onStartup();
+        const workspace = IModelHost.appWorkspace;
+        const container = workspace.getContainer({ ...dbProps, accessToken: "" });
+        connected = true;
+        queryDatabase = sandbox.stub().returns({ totalBlocks: 10, localBlocks: 0 });
+        sandbox.stub(container, "cloudContainer").get(() => ({ isConnected: connected, queryDatabase }));
+        sandbox.stub(container, "resolveDbFileName").callsFake((props) => `${props.dbName}:1.0.0`);
+        getContainer = sandbox.stub(workspace, "getContainer").returns(container);
+        getArray = sandbox.stub(workspace.settings, "getArray").returns([dbProps]);
+        getBoolean = sandbox.stub(workspace.settings, "getBoolean").returns(false);
+        addWorkspace = sandbox.stub().returns(true);
+        const nativePlatform = { ...IModelNative.platform, addGcsWorkspaceDb: addWorkspace };
+        sandbox.stub(IModelNative, "platform").get(() => nativePlatform);
+        prefetch = sandbox.stub(CloudSqlite, "startCloudPrefetch").callsFake((cloudContainer, dbName) => ({
+            cloudContainer, dbName, promise: Promise.resolve(true), cancel: () => undefined,
+        }));
+        logError = sandbox.stub(Logger, "logError");
+    });
+    afterEach(() => {
+        sandbox.restore();
+        GeoCoordConfig.onStartup();
+        TestUtils.disableGcsWorkspaces();
+    });
+    function expectRetryToSucceed() {
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(getContainer.callCount).to.equal(2);
+        expect(prefetch.callCount).to.equal(1);
+        expect(GeoCoordConfig.prefetches).to.have.lengthOf(1);
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(getContainer.callCount).to.equal(2);
+    }
+    it("retries after a container load throws", () => {
+        getContainer.onFirstCall().throws(new Error("temporary container failure"));
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(logError.calledOnce).to.be.true;
+        expect(addWorkspace.called).to.be.false;
+        expectRetryToSucceed();
+    });
+    it("retries after a disconnected container", () => {
+        connected = false;
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(logError.calledOnce).to.be.true;
+        expect(addWorkspace.called).to.be.false;
+        connected = true;
+        expectRetryToSucceed();
+    });
+    it("retries after a missing database", () => {
+        queryDatabase.onFirstCall().returns(undefined);
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(logError.calledOnce).to.be.true;
+        expect(addWorkspace.called).to.be.false;
+        expectRetryToSucceed();
+    });
+    it("recovers a failed initial cloud connection through the real workspace cache", () => {
+        const workspace = constructWorkspace(new SettingsImpl());
+        const sharedWorkspace = constructWorkspace(new SettingsImpl());
+        const props = { ...dbProps, baseUri: "https://example.invalid", containerId: "gcs-initial-connect-retry", isPublic: true, priority: 42 };
+        workspace.settings.addDictionary({ name: "gcs connection retry", priority: SettingsPriority.application }, {
+            [GeoCoordConfig.settingName.disableWorkspaces]: false,
+            [GeoCoordConfig.settingName.defaultDatabases]: [props],
+        });
+        sandbox.stub(IModelHost, "appWorkspace").get(() => workspace);
+        const cloud = CloudSqlite.createCloudContainer({ ...props, accessToken: "" });
+        let isConnected = false;
+        const connect = sandbox.stub().callsFake(() => { isConnected = true; });
+        connect.onFirstCall().throws(new Error("temporary cloud connection failure"));
+        const disconnect = sandbox.stub().callsFake(() => { isConnected = false; });
+        Object.defineProperties(cloud, {
+            isConnected: { get: () => isConnected },
+            connect: { value: connect },
+            disconnect: { value: disconnect },
+            checkForChanges: { value: sandbox.stub() },
+            queryDatabases: { value: sandbox.stub().returns(["vertical:1.0.0"]) },
+            queryDatabase: { value: sandbox.stub().returns({ totalBlocks: 10, localBlocks: 0, dirtyBlocks: 0, transactions: false, state: "", nClient: 0, nPrefetch: 0 }) },
+        });
+        sandbox.stub(CloudSqlite, "createCloudContainer").returns(cloud);
+        try {
+            GeoCoordConfig.loadDefaultDatabases();
+            expect(logError.calledOnce).to.be.true;
+            expect(addWorkspace.called).to.be.false;
+            expect(workspace.findContainer(props.containerId)).to.be.undefined;
+            GeoCoordConfig.loadDefaultDatabases();
+            expect(connect.callCount).to.equal(2);
+            expect(addWorkspace.callCount, JSON.stringify(logError.args)).to.equal(1);
+            expect(addWorkspace.firstCall.args).to.deep.equal(["vertical:1.0.0", cloud, props.priority]);
+            expect(prefetch.calledOnce).to.be.true;
+            const container = workspace.findContainer(props.containerId);
+            expect(container?.cloudContainer).to.equal(cloud);
+            expect(sharedWorkspace.getContainer({ ...props, accessToken: "" }).cloudContainer).to.equal(cloud);
+            expect(connect.callCount).to.equal(2);
+            GeoCoordConfig.loadDefaultDatabases();
+            expect(addWorkspace.calledOnce).to.be.true;
+        }
+        finally {
+            try {
+                sharedWorkspace.close();
+                expect(disconnect.called).to.be.false;
+            }
+            finally {
+                workspace.close();
+            }
+        }
+        expect(disconnect.calledOnce).to.be.true;
+    });
+    it("attempts every database and accepts already registered databases on retry", () => {
+        getArray.returns([dbProps, { ...dbProps, dbName: "horizontal" }]);
+        queryDatabase.onFirstCall().returns(undefined);
+        addWorkspace.onSecondCall().returns(true);
+        addWorkspace.onThirdCall().returns(false);
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(getContainer.callCount).to.equal(2);
+        expect(addWorkspace.calledOnceWithExactly("horizontal:1.0.0", sinon.match.object, undefined)).to.be.true;
+        expect(logError.calledOnce).to.be.true;
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(getContainer.callCount).to.equal(4);
+        expect(addWorkspace.callCount).to.equal(3);
+        expect(prefetch.callCount).to.equal(2);
+        expect(GeoCoordConfig.prefetches).to.have.lengthOf(2);
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(getContainer.callCount).to.equal(4);
+    });
+    it("loads defaults after workspaces are re-enabled", () => {
+        getBoolean.returns(true);
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(getContainer.called).to.be.false;
+        getBoolean.returns(false);
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(addWorkspace.calledOnce).to.be.true;
+        GeoCoordConfig.loadDefaultDatabases();
+        expect(addWorkspace.calledOnce).to.be.true;
+    });
+});
+//# sourceMappingURL=GeoCoordConfig.test.js.map

package/lib/esm/test/standalone/GeoCoordConfig.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeoCoordConfig.test.js","sourceRoot":"","sources":["../../../../src/test/standalone/GeoCoordConfig.test.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\r\nimport { expect } from \"chai\";\r\nimport * as sinon from \"sinon\";\r\nimport { Logger } from \"@itwin/core-bentley\";\r\nimport { CloudSqlite, GcsDbProps, GeoCoordConfig, IModelHost } from \"../../core-backend\";\r\nimport { IModelNative } from \"../../internal/NativePlatform\";\r\nimport { constructWorkspace } from \"../../internal/workspace/WorkspaceImpl\";\r\nimport { SettingsImpl } from \"../../internal/workspace/SettingsImpl\";\r\nimport { SettingsPriority } from \"../../workspace/Settings\";\r\nimport { TestUtils } from \"../TestUtils\";\r\n\r\ndescribe(\"GeoCoordConfig\", () => {\r\n  const dbProps: GcsDbProps = { baseUri: \"\", storageType: \"azure\", containerId: \"gcs-retry-test\", dbName: \"vertical\", prefetch: true };\r\n  const sandbox = sinon.createSandbox();\r\n  let getContainer: sinon.SinonStub;\r\n  let getArray: sinon.SinonStub;\r\n  let getBoolean: sinon.SinonStub;\r\n  let queryDatabase: sinon.SinonStub;\r\n  let addWorkspace: sinon.SinonStub;\r\n  let prefetch: sinon.SinonStub;\r\n  let logError: sinon.SinonStub;\r\n  let connected: boolean;\r\n\r\n  beforeEach(() => {\r\n    GeoCoordConfig.onStartup();\r\n    const workspace = IModelHost.appWorkspace;\r\n    const container = workspace.getContainer({ ...dbProps, accessToken: \"\" });\r\n    connected = true;\r\n    queryDatabase = sandbox.stub().returns({ totalBlocks: 10, localBlocks: 0 });\r\n    sandbox.stub(container, \"cloudContainer\").get(() => ({ isConnected: connected, queryDatabase }));\r\n    sandbox.stub(container, \"resolveDbFileName\").callsFake((props) => `${props.dbName}:1.0.0`);\r\n    getContainer = sandbox.stub(workspace, \"getContainer\").returns(container);\r\n    getArray = sandbox.stub(workspace.settings, \"getArray\").returns([dbProps]);\r\n    getBoolean = sandbox.stub(workspace.settings, \"getBoolean\").returns(false);\r\n    addWorkspace = sandbox.stub().returns(true);\r\n    const nativePlatform = { ...IModelNative.platform, addGcsWorkspaceDb: addWorkspace };\r\n    sandbox.stub(IModelNative, \"platform\").get(() => nativePlatform);\r\n    prefetch = sandbox.stub(CloudSqlite, \"startCloudPrefetch\").callsFake((cloudContainer, dbName) => ({\r\n      cloudContainer, dbName, promise: Promise.resolve(true), cancel: () => undefined,\r\n    }));\r\n    logError = sandbox.stub(Logger, \"logError\");\r\n  });\r\n\r\n  afterEach(() => {\r\n    sandbox.restore();\r\n    GeoCoordConfig.onStartup();\r\n    TestUtils.disableGcsWorkspaces();\r\n  });\r\n\r\n  function expectRetryToSucceed() {\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(getContainer.callCount).to.equal(2);\r\n    expect(prefetch.callCount).to.equal(1);\r\n    expect(GeoCoordConfig.prefetches).to.have.lengthOf(1);\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(getContainer.callCount).to.equal(2);\r\n  }\r\n\r\n  it(\"retries after a container load throws\", () => {\r\n    getContainer.onFirstCall().throws(new Error(\"temporary container failure\"));\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(logError.calledOnce).to.be.true;\r\n    expect(addWorkspace.called).to.be.false;\r\n    expectRetryToSucceed();\r\n  });\r\n\r\n  it(\"retries after a disconnected container\", () => {\r\n    connected = false;\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(logError.calledOnce).to.be.true;\r\n    expect(addWorkspace.called).to.be.false;\r\n    connected = true;\r\n    expectRetryToSucceed();\r\n  });\r\n\r\n  it(\"retries after a missing database\", () => {\r\n    queryDatabase.onFirstCall().returns(undefined);\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(logError.calledOnce).to.be.true;\r\n    expect(addWorkspace.called).to.be.false;\r\n    expectRetryToSucceed();\r\n  });\r\n\r\n  it(\"recovers a failed initial cloud connection through the real workspace cache\", () => {\r\n    const workspace = constructWorkspace(new SettingsImpl());\r\n    const sharedWorkspace = constructWorkspace(new SettingsImpl());\r\n    const props = { ...dbProps, baseUri: \"https://example.invalid\", containerId: \"gcs-initial-connect-retry\", isPublic: true, priority: 42 };\r\n    workspace.settings.addDictionary({ name: \"gcs connection retry\", priority: SettingsPriority.application }, {\r\n      [GeoCoordConfig.settingName.disableWorkspaces]: false,\r\n      [GeoCoordConfig.settingName.defaultDatabases]: [props],\r\n    });\r\n    sandbox.stub(IModelHost, \"appWorkspace\").get(() => workspace);\r\n    const cloud = CloudSqlite.createCloudContainer({ ...props, accessToken: \"\" });\r\n    let isConnected = false;\r\n    const connect = sandbox.stub().callsFake(() => { isConnected = true; });\r\n    connect.onFirstCall().throws(new Error(\"temporary cloud connection failure\"));\r\n    const disconnect = sandbox.stub().callsFake(() => { isConnected = false; });\r\n    Object.defineProperties(cloud, {\r\n      isConnected: { get: () => isConnected },\r\n      connect: { value: connect },\r\n      disconnect: { value: disconnect },\r\n      checkForChanges: { value: sandbox.stub() },\r\n      queryDatabases: { value: sandbox.stub().returns([\"vertical:1.0.0\"]) },\r\n      queryDatabase: { value: sandbox.stub().returns({ totalBlocks: 10, localBlocks: 0, dirtyBlocks: 0, transactions: false, state: \"\", nClient: 0, nPrefetch: 0 }) },\r\n    });\r\n    sandbox.stub(CloudSqlite, \"createCloudContainer\").returns(cloud);\r\n    try {\r\n      GeoCoordConfig.loadDefaultDatabases();\r\n      expect(logError.calledOnce).to.be.true;\r\n      expect(addWorkspace.called).to.be.false;\r\n      expect(workspace.findContainer(props.containerId)).to.be.undefined;\r\n      GeoCoordConfig.loadDefaultDatabases();\r\n      expect(connect.callCount).to.equal(2);\r\n      expect(addWorkspace.callCount, JSON.stringify(logError.args)).to.equal(1);\r\n      expect(addWorkspace.firstCall.args).to.deep.equal([\"vertical:1.0.0\", cloud, props.priority]);\r\n      expect(prefetch.calledOnce).to.be.true;\r\n      const container = workspace.findContainer(props.containerId);\r\n      expect(container?.cloudContainer).to.equal(cloud);\r\n      expect(sharedWorkspace.getContainer({ ...props, accessToken: \"\" }).cloudContainer).to.equal(cloud);\r\n      expect(connect.callCount).to.equal(2);\r\n      GeoCoordConfig.loadDefaultDatabases();\r\n      expect(addWorkspace.calledOnce).to.be.true;\r\n    } finally {\r\n      try {\r\n        sharedWorkspace.close();\r\n        expect(disconnect.called).to.be.false;\r\n      } finally {\r\n        workspace.close();\r\n      }\r\n    }\r\n    expect(disconnect.calledOnce).to.be.true;\r\n  });\r\n\r\n  it(\"attempts every database and accepts already registered databases on retry\", () => {\r\n    getArray.returns([dbProps, { ...dbProps, dbName: \"horizontal\" }]);\r\n    queryDatabase.onFirstCall().returns(undefined);\r\n    addWorkspace.onSecondCall().returns(true);\r\n    addWorkspace.onThirdCall().returns(false);\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(getContainer.callCount).to.equal(2);\r\n    expect(addWorkspace.calledOnceWithExactly(\"horizontal:1.0.0\", sinon.match.object, undefined)).to.be.true;\r\n    expect(logError.calledOnce).to.be.true;\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(getContainer.callCount).to.equal(4);\r\n    expect(addWorkspace.callCount).to.equal(3);\r\n    expect(prefetch.callCount).to.equal(2);\r\n    expect(GeoCoordConfig.prefetches).to.have.lengthOf(2);\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(getContainer.callCount).to.equal(4);\r\n  });\r\n\r\n  it(\"loads defaults after workspaces are re-enabled\", () => {\r\n    getBoolean.returns(true);\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(getContainer.called).to.be.false;\r\n    getBoolean.returns(false);\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(addWorkspace.calledOnce).to.be.true;\r\n    GeoCoordConfig.loadDefaultDatabases();\r\n    expect(addWorkspace.calledOnce).to.be.true;\r\n  });\r\n});\r\n"]}

package/lib/esm/test/standalone/ViewStoreDb.test.js

@@ -6,6 +6,7 @@ import { expect } from "chai";
 import { join } from "path";
 import { Guid, Logger, LogLevel, OpenMode } from "@itwin/core-bentley";
 import { ViewStore } from "../../ViewStore";
+import { ViewStoreError } from "@itwin/core-common";
 import { KnownTestLocations } from "../KnownTestLocations";
 import { SnapshotDb } from "../../IModelDb";
 import { IModelTestUtils } from "../IModelTestUtils";
@@ -236,6 +237,58 @@ describe("ViewStore", function () {
         expect(vs1.queryViewsSync({ owner: "owner10", classNames: ["BisCore:SpatialViewDefinition", "BisCore:OrthographicViewDefinition"] }).length).equal(2);
         expect(vs1.queryViewsSync({ owner: "owner10", classNames: ["BisCore:DrawingViewDefinition"] }).length).equal(1);
         expect(vs1.queryViewsSync({ owner: "owner10", classNames: ["BisCore:DrawingViewDefinition", "BisCore:SheetViewDefinition"] }).length).equal(2);
+        // query parameters may come from RPC callers, so values must never be interpreted as SQL
+        const allPublicCount = vs1.queryViewsSync({}).length;
+        const injectClause = "x') OR 1=1 OR className IN('x";
+        expect(vs1.queryViewsSync({ classNames: [injectClause] }).length).equal(0);
+        expect(vs1.queryViewsSync({ classNames: ["foo') UNION SELECT Id,name,owner,private,1 FROM views -- "] }).length).equal(0);
+        expect(vs1.queryViewsSync({ tags: [injectClause] }).length).equal(0);
+        expect(vs1.queryViewsSync({ classNames: ["it's"] }).length).equal(0); // quotes in values must not cause SQL errors
+        expect(vs1.queryViewsSync({ tags: ["it's"] }).length).equal(0);
+        expect(vs1.queryViewsSync({ nameSearch: "' OR 1=1 --" }).length).equal(0);
+        expect(vs1.queryViewsSync({ group: "group2", offset: 95 }).length).equal(5); // offset without limit
+        const badParams = [
+            { nameSearch: "x", nameCompare: "= @name OR 1=1 OR name =" },
+            { nameSearch: "x", nameCompare: "like" },
+            { limit: "1 UNION SELECT Id FROM views" },
+            { limit: 1.5 },
+            { limit: -1 },
+            { limit: 10, offset: "1; --" },
+            { classNames: "BisCore:SpatialViewDefinition" },
+            { classNames: [1] },
+            { tags: [{}] },
+            { owner: 1 },
+            { nameSearch: { $ne: "" } },
+            { group: 5 },
+            { group: ["group2"] },
+            null,
+            undefined,
+        ];
+        for (const params of badParams) {
+            // must be rejected by validation with a ViewStoreError, not fail later with a generic or native error
+            expect(() => vs1.queryViewsSync(params), String(JSON.stringify(params))).throws().that.satisfies((e) => ViewStoreError.isError(e, "invalid-value"));
+        }
+        expect(vs1.queryViewsSync({ owner: "", nameSearch: "", group: "" }).length).equal(allPublicCount); // empty strings are treated as absent
+        // owner is optional: without it only public views are returned; with it, that owner's private views are added
+        expect(vs1.queryViewsSync({ group: "/" }).every((view) => !view.isPrivate)).to.be.true;
+        expect(vs1.queryViewsSync({ group: "/", owner: "someoneElse" }).every((view) => !view.isPrivate)).to.be.true;
+        expect(vs1.queryViewsSync({ group: "/", owner: "owner10" }).filter((view) => view.isPrivate).length).equal(4);
+        expect(vs1.queryViewsSync({ nameSearch: "my private 2" }).length).equal(0);
+        expect(vs1.queryViewsSync({ nameSearch: "my private 2", owner: "someoneElse" }).length).equal(0);
+        expect(vs1.queryViewsSync({ nameSearch: "my private 2", owner: "owner10" }).length).equal(1);
+        // a limit of 0 means no limit
+        expect(vs1.queryViewsSync({ group: "group2", limit: 0 }).length).equal(100);
+        expect(vs1.queryViewsSync({ group: "group2", limit: 0, offset: 0 }).length).equal(100);
+        // the query statement is cached, so bindings from one call must not leak into the next
+        expect(vs1.queryViewsSync({ owner: "owner10" }).length).equal(7);
+        expect(vs1.queryViewsSync({}).length).equal(allPublicCount);
+        expect(vs1.queryViewsSync({ owner: "owner10", classNames: ["BisCore:SpatialViewDefinition"], nameSearch: "my%", nameCompare: "LIKE", limit: 1 }).length).equal(1);
+        expect(vs1.queryViewsSync({ nameSearch: "another view" }).length).equal(1);
+        expect(vs1.queryViewsSync({}).length).equal(allPublicCount);
+        // arrays are bound as a single JSON value, so their size is not limited by SQLite's bound-variable limit
+        const manyClassNames = Array.from({ length: 40000 }, (_, i) => `Fake:Class${i}`);
+        expect(vs1.queryViewsSync({ owner: "owner10", classNames: [...manyClassNames, "BisCore:DrawingViewDefinition"] }).length).equal(1);
+        expect(vs1.queryViewsSync({}).length).equal(allPublicCount);
         await vs1.renameTag({ oldName: "tag2", newName: "tag2-renamed" });
         views = vs1.queryViewsSync({ tags: ["tag2-renamed"] });
         expect(views.length).equal(3);