@itwin/core-backend 5.8.0-dev.11 → 5.8.0-dev.13

package/lib/esm/LocalHub.d.ts

@@ -1,6 +1,6 @@
 import { GuidString, Id64String } from "@itwin/core-bentley";
 import { BriefcaseId, ChangesetFileProps, ChangesetId, ChangesetIdWithIndex, ChangesetIndex, ChangesetIndexOrId, ChangesetProps, ChangesetRange, LocalDirName, LocalFileName, LockState } from "@itwin/core-common";
-import { LockMap, LockProps } from "./BackendHubAccess";
+import { BriefcaseIdArg, LockMap, LockProps } from "./BackendHubAccess";
 /** @internal */
 interface MockBriefcaseIdProps {
     id: BriefcaseId;
@@ -17,27 +17,27 @@ interface LocalHubProps {
     readonly version0?: string;
     readonly noLocks?: true;
 }
-interface LocksEntry {
+interface LockLastReleaseChangesetIndices {
+    lastExclusiveReleaseChangesetIndex?: ChangesetIndex;
+    lastSharedReleaseChangesetIndex?: ChangesetIndex;
+}
+interface LocksEntry extends LockLastReleaseChangesetIndices {
     id: Id64String;
     level: LockState;
-    lastCsIndex?: ChangesetIndex;
     briefcaseId?: BriefcaseId;
 }
-interface LockStatusNone {
+interface LockStatusNone extends LockLastReleaseChangesetIndices {
     state: LockState.None;
-    lastCsIndex?: ChangesetIndex;
 }
 /** @internal exported for tests. */
-export interface LockStatusExclusive {
+export interface LockStatusExclusive extends LockLastReleaseChangesetIndices {
     state: LockState.Exclusive;
     briefcaseId: BriefcaseId;
-    lastCsIndex?: ChangesetIndex;
 }
 /** @internal exported for tests. */
-export interface LockStatusShared {
+export interface LockStatusShared extends LockLastReleaseChangesetIndices {
     state: LockState.Shared;
     sharedBy: Set<BriefcaseId>;
-    lastCsIndex?: ChangesetIndex;
 }
 interface BriefcaseIdAndChangeset {
     changeset: ChangesetIdWithIndex;
@@ -131,11 +131,16 @@ export declare class LocalHub {
     private querySharedLockHolders;
     queryAllLocks(briefcaseId: BriefcaseId): LockProps[];
     queryLockStatus(elementId: Id64String): LockStatus;
+    private doesBriefcaseRequirePullBeforeLock;
+    private addSharedLockRecord;
     private reserveLock;
+    private downgradeExclusiveLockToShared;
     private clearLock;
-    private updateLockChangeset;
+    private updateLockExclusiveChangeset;
+    private updateLockSharedChangeset;
     private requestLock;
     private removeSharedLock;
+    private abandonLock;
     private releaseLock;
     /** Acquire a set of locks. If any lock cannot be acquired, no locks are acquired  */
     acquireLocks(locks: LockMap, briefcase: BriefcaseIdAndChangeset): void;
@@ -144,10 +149,12 @@ export declare class LocalHub {
         briefcaseId: BriefcaseId;
         changesetIndex: ChangesetIndex;
     }): void;
+    abandonLocks(locks: LockMap, arg: BriefcaseIdArg): void;
     releaseAllLocks(arg: {
         briefcaseId: BriefcaseId;
         changesetIndex: ChangesetIndex;
     }): void;
+    abandonAllLocks(arg: BriefcaseIdArg): void;
     private countTable;
     countSharedLocks(): number;
     countLocks(): number;

package/lib/esm/LocalHub.d.ts.map

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

package/lib/esm/LocalHub.js

@@ -3,7 +3,7 @@
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 import { join } from "path";
-import { DbResult, IModelHubStatus, IModelStatus, OpenMode } from "@itwin/core-bentley";
+import { assert, DbResult, IModelHubStatus, IModelStatus, OpenMode } from "@itwin/core-bentley";
 import { BriefcaseIdValue, IModelError, LockState, } from "@itwin/core-common";
 import { LockConflict } from "./BackendHubAccess";
 import { BriefcaseManager } from "./BriefcaseManager";
@@ -41,7 +41,7 @@ export class LocalHub {
                    FOREIGN KEY(briefcaseId) REFERENCES briefcases(id))");
         db.executeSQL("CREATE TABLE checkpoints(csIndex INTEGER PRIMARY KEY NOT NULL)");
         db.executeSQL("CREATE TABLE versions(name TEXT PRIMARY KEY NOT NULL,csIndex TEXT,FOREIGN KEY(csIndex) REFERENCES timeline(csIndex))");
-        db.executeSQL("CREATE TABLE locks(id INTEGER PRIMARY KEY NOT NULL,level INTEGER NOT NULL,lastCSetIndex INTEGER,briefcaseId INTEGER)");
+        db.executeSQL("CREATE TABLE locks(id INTEGER PRIMARY KEY NOT NULL,level INTEGER NOT NULL,lastExclusiveReleaseChangesetIndex INTEGER,lastSharedReleaseChangesetIndex INTEGER,briefcaseId INTEGER)");
         db.executeSQL("CREATE TABLE sharedLocks(lockId INTEGER NOT NULL,briefcaseId INTEGER NOT NULL,PRIMARY KEY(lockId,briefcaseId))");
         db.executeSQL("CREATE INDEX LockIdx ON locks(briefcaseId)");
         db.executeSQL("CREATE INDEX SharedLockIdx ON sharedLocks(briefcaseId)");
@@ -380,21 +380,23 @@ export class LocalHub {
         return locks;
     }
     queryLockStatus(elementId) {
-        return this.db.withPreparedSqliteStatement("SELECT lastCSetIndex,level,briefcaseId FROM locks WHERE id=?", (stmt) => {
+        return this.db.withPreparedSqliteStatement("SELECT lastSharedReleaseChangesetIndex,lastExclusiveReleaseChangesetIndex,level,briefcaseId FROM locks WHERE id=?", (stmt) => {
             stmt.bindId(1, elementId);
             const rc = stmt.step();
             if (DbResult.BE_SQLITE_ROW !== rc)
                 return { state: LockState.None };
-            const lastCsVal = stmt.getValue(0);
+            const lastSharedCsVal = stmt.getValue(0);
+            const lastExclusiveCsVal = stmt.getValue(1);
             const lock = {
-                lastCsIndex: lastCsVal.isNull ? undefined : lastCsVal.getInteger(),
-                state: stmt.getValueInteger(1),
+                lastSharedReleaseChangesetIndex: lastSharedCsVal.isNull ? undefined : lastSharedCsVal.getInteger(),
+                lastExclusiveReleaseChangesetIndex: lastExclusiveCsVal.isNull ? undefined : lastExclusiveCsVal.getInteger(),
+                state: stmt.getValueInteger(2),
             };
             switch (lock.state) {
                 case LockState.None:
                     return lock;
                 case LockState.Exclusive:
-                    return { ...lock, briefcaseId: stmt.getValueInteger(2) };
+                    return { ...lock, briefcaseId: stmt.getValueInteger(3) };
                 case LockState.Shared:
                     return { ...lock, sharedBy: this.querySharedLockHolders(elementId) };
                 default:
@@ -402,9 +404,37 @@ export class LocalHub {
             }
         });
     }
+    doesBriefcaseRequirePullBeforeLock(currStatus, props, briefcase) {
+        if (props.state === LockState.None)
+            return false;
+        const briefcaseChangesetIndex = this.getIndexFromChangeset(briefcase.changeset);
+        const exclusiveIndexIsNewer = currStatus.lastExclusiveReleaseChangesetIndex !== undefined &&
+            currStatus.lastExclusiveReleaseChangesetIndex > briefcaseChangesetIndex;
+        if (props.state === LockState.Shared) {
+            // To acquire a shared lock, the briefcase must at least at the latest exclusive changeset index
+            return exclusiveIndexIsNewer;
+        }
+        else {
+            assert(props.state === LockState.Exclusive);
+            const sharedIndexIsNewer = currStatus.lastSharedReleaseChangesetIndex !== undefined &&
+                currStatus.lastSharedReleaseChangesetIndex > briefcaseChangesetIndex;
+            // To acquire the exclusive lock the briefcase must be at least at the greater of the two last-indexes
+            return exclusiveIndexIsNewer || sharedIndexIsNewer;
+        }
+    }
+    addSharedLockRecord(lockId, briefcaseId) {
+        this.db.withPreparedSqliteStatement("INSERT INTO sharedLocks(lockId,briefcaseId) VALUES(?,?) ON CONFLICT(lockId,briefcaseId) DO NOTHING", (stmt) => {
+            stmt.bindId(1, lockId);
+            stmt.bindInteger(2, briefcaseId);
+            const rc = stmt.step();
+            if (rc !== DbResult.BE_SQLITE_DONE)
+                throw new IModelError(rc, "cannot insert shared lock");
+        });
+    }
     reserveLock(currStatus, props, briefcase) {
-        if (props.state === LockState.Exclusive && currStatus.lastCsIndex && (currStatus.lastCsIndex > this.getIndexFromChangeset(briefcase.changeset)))
+        if (this.doesBriefcaseRequirePullBeforeLock(currStatus, props, briefcase)) {
             throw new IModelError(IModelHubStatus.PullIsRequired, "pull is required to obtain lock");
+        }
         const wantShared = props.state === LockState.Shared;
         if (wantShared && (currStatus.state === LockState.Exclusive))
             throw new Error("cannot acquire shared lock because an exclusive lock is already held");
@@ -417,15 +447,26 @@ export class LocalHub {
                 throw new IModelError(rc, "cannot insert lock");
         });
         if (wantShared) {
-            this.db.withPreparedSqliteStatement("INSERT INTO sharedLocks(lockId,briefcaseId) VALUES(?,?)", (stmt) => {
-                stmt.bindId(1, props.id);
-                stmt.bindInteger(2, briefcase.briefcaseId);
-                const rc = stmt.step();
-                if (rc !== DbResult.BE_SQLITE_DONE)
-                    throw new IModelError(rc, "cannot insert shared lock");
-            });
+            this.addSharedLockRecord(props.id, briefcase.briefcaseId);
         }
     }
+    downgradeExclusiveLockToShared(lockId, briefcaseId) {
+        this.db.withPreparedSqliteStatement("UPDATE locks SET level=1,briefcaseId=NULL WHERE id=? AND briefcaseId=? AND level=2", (stmt) => {
+            stmt.bindId(1, lockId);
+            stmt.bindInteger(2, briefcaseId);
+            const rc = stmt.step();
+            if (rc !== DbResult.BE_SQLITE_DONE)
+                throw new IModelError(rc, "can't downgrade lock");
+        });
+        // Verify that the above actually updated a row. If it didn't, something has gone wrong with the downgrade.
+        // This shouldn't happen.
+        this.db.withPreparedSqliteStatement("SELECT CHANGES()", (stmt) => {
+            stmt.step();
+            if (stmt.getValueInteger(0) !== 1)
+                throw new IModelError(IModelHubStatus.LockOwnedByAnotherBriefcase, "lock not held by this briefcase or lock is not exclusive");
+        });
+        this.addSharedLockRecord(lockId, briefcaseId);
+    }
     clearLock(id) {
         this.db.withPreparedSqliteStatement("UPDATE locks SET level=0,briefcaseId=NULL WHERE id=?", (stmt) => {
             stmt.bindId(1, id);
@@ -434,15 +475,26 @@ export class LocalHub {
                 throw new IModelError(rc, "can't release lock");
         });
     }
-    updateLockChangeset(id, index) {
+    updateLockExclusiveChangeset(id, index) {
         if (index <= 0)
             return;
-        this.db.withPreparedSqliteStatement("UPDATE locks SET lastCSetIndex=? WHERE id=?", (stmt) => {
+        this.db.withPreparedSqliteStatement("UPDATE locks SET lastExclusiveReleaseChangesetIndex=? WHERE id=?", (stmt) => {
             stmt.bindInteger(1, index);
             stmt.bindId(2, id);
             const rc = stmt.step();
             if (rc !== DbResult.BE_SQLITE_DONE)
-                throw new IModelError(rc, "can't update lock changeSetId");
+                throw new IModelError(rc, "can't update lock exclusive changeSetId");
+        });
+    }
+    updateLockSharedChangeset(id, index) {
+        if (index <= 0)
+            return;
+        this.db.withPreparedSqliteStatement("UPDATE locks SET lastSharedReleaseChangesetIndex=? WHERE id=?", (stmt) => {
+            stmt.bindInteger(1, index);
+            stmt.bindId(2, id);
+            const rc = stmt.step();
+            if (rc !== DbResult.BE_SQLITE_DONE)
+                throw new IModelError(rc, "can't update lock shared changeSetId");
         });
     }
     requestLock(props, briefcase) {
@@ -482,23 +534,58 @@ export class LocalHub {
                 throw new IModelError(rc, "can't remove shared lock");
         });
     }
-    releaseLock(props, arg) {
+    abandonLock(props, briefcase) {
+        // When abandoning (but not when releasing), props.state indicates which
+        // state we're abandoning _to_. Specifically, an Exclusive lock can be
+        // abandoned to either Shared or None.
+        // It makes no sense to abandon a lock _to_ the Exclusive state.
+        if (props.state === LockState.Exclusive)
+            throw new IModelError(IModelHubStatus.InvalidArgumentError, "must specify Shared or None when abandoning a lock");
         const lockId = props.id;
-        const lockStatus = this.queryLockStatus(lockId);
-        switch (lockStatus.state) {
+        const previousLockStatus = this.queryLockStatus(lockId);
+        switch (previousLockStatus.state) {
+            case LockState.None:
+                throw new IModelError(IModelHubStatus.LockDoesNotExist, "lock not held");
+            case LockState.Exclusive:
+                if (previousLockStatus.briefcaseId !== briefcase.briefcaseId)
+                    throw new IModelError(IModelHubStatus.LockOwnedByAnotherBriefcase, "lock not held by this briefcase");
+                if (props.state === LockState.Shared) {
+                    // Exclusive -> Shared
+                    this.downgradeExclusiveLockToShared(lockId, briefcase.briefcaseId);
+                }
+                else {
+                    // Exclusive -> None
+                    this.clearLock(lockId);
+                }
+                break;
+            case LockState.Shared:
+                if (!previousLockStatus.sharedBy.has(briefcase.briefcaseId))
+                    throw new IModelError(IModelHubStatus.LockDoesNotExist, "shared lock not held by this briefcase");
+                this.removeSharedLock(lockId, briefcase.briefcaseId);
+                if (previousLockStatus.sharedBy.size === 1)
+                    this.clearLock(lockId);
+        }
+    }
+    releaseLock(props, briefcase) {
+        // Unlike abandonLock above, release always releases the lock all the way back to the None state.
+        // So we ignore props.state. There's no such thing as a "downgrade" here.
+        const lockId = props.id;
+        const previousLockStatus = this.queryLockStatus(lockId);
+        switch (previousLockStatus.state) {
             case LockState.None:
                 throw new IModelError(IModelHubStatus.LockDoesNotExist, "lock not held");
             case LockState.Exclusive:
-                if (lockStatus.briefcaseId !== arg.briefcaseId)
+                if (previousLockStatus.briefcaseId !== briefcase.briefcaseId)
                     throw new IModelError(IModelHubStatus.LockOwnedByAnotherBriefcase, "lock not held by this briefcase");
-                this.updateLockChangeset(lockId, arg.changesetIndex);
+                this.updateLockExclusiveChangeset(lockId, briefcase.changesetIndex);
                 this.clearLock(lockId);
                 break;
             case LockState.Shared:
-                if (!lockStatus.sharedBy.has(arg.briefcaseId))
+                if (!previousLockStatus.sharedBy.has(briefcase.briefcaseId))
                     throw new IModelError(IModelHubStatus.LockDoesNotExist, "shared lock not held by this briefcase");
-                this.removeSharedLock(lockId, arg.briefcaseId);
-                if (lockStatus.sharedBy.size === 1)
+                this.updateLockSharedChangeset(lockId, briefcase.changesetIndex);
+                this.removeSharedLock(lockId, briefcase.briefcaseId);
+                if (previousLockStatus.sharedBy.size === 1)
                     this.clearLock(lockId);
         }
     }
@@ -524,10 +611,20 @@ export class LocalHub {
             this.releaseLock(props, arg);
         this.db.saveChanges();
     }
+    abandonLocks(locks, arg) {
+        for (const props of locks)
+            this.abandonLock({ id: props[0], state: props[1] }, arg);
+        this.db.saveChanges();
+    }
     releaseAllLocks(arg) {
         const locks = this.queryAllLocks(arg.briefcaseId);
         this.releaseLocks(locks, arg);
     }
+    abandonAllLocks(arg) {
+        const locks = new Map();
+        this.queryAllLocks(arg.briefcaseId).forEach(lock => locks.set(lock.id, LockState.None));
+        this.abandonLocks(locks, arg);
+    }
     countTable(tableName) {
         return this.db.withSqliteStatement(`SELECT count(*) from ${tableName}`, (stmt) => {
             stmt.step();
@@ -550,13 +647,14 @@ export class LocalHub {
     // for debugging
     queryLocks() {
         const locks = [];
-        this.db.withPreparedSqliteStatement("SELECT id,level,lastCSetIndex,briefcaseId FROM locks", (stmt) => {
+        this.db.withPreparedSqliteStatement("SELECT id,level,lastExclusiveReleaseChangesetIndex,lastSharedReleaseChangesetIndex,briefcaseId FROM locks", (stmt) => {
             while (DbResult.BE_SQLITE_ROW === stmt.step())
                 locks.push({
                     id: stmt.getValueId(0),
                     level: stmt.getValueInteger(1),
-                    lastCsIndex: stmt.getValue(2).isNull ? undefined : stmt.getValueInteger(2),
-                    briefcaseId: stmt.getValue(3).isNull ? undefined : stmt.getValueInteger(3),
+                    lastExclusiveReleaseChangesetIndex: stmt.getValue(2).isNull ? undefined : stmt.getValueInteger(2),
+                    lastSharedReleaseChangesetIndex: stmt.getValue(3).isNull ? undefined : stmt.getValueInteger(3),
+                    briefcaseId: stmt.getValue(4).isNull ? undefined : stmt.getValueInteger(4),
                 });
         });
         return locks;