npm - @itwin/core-backend - Versions diffs - 3.6.0-dev.62 → 3.6.0-dev.66 - Mend

@itwin/core-backend 3.6.0-dev.62 → 3.6.0-dev.66

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/lib/cjs/IModelDb.d.ts +15 -1
package/lib/cjs/IModelDb.d.ts.map +1 -1
package/lib/cjs/IModelDb.js +18 -24
package/lib/cjs/IModelDb.js.map +1 -1
package/lib/cjs/IpcHost.js +4 -4
package/lib/cjs/IpcHost.js.map +1 -1
package/lib/cjs/workspace/Workspace.js +2 -2
package/lib/cjs/workspace/Workspace.js.map +1 -1
package/package.json +12 -12

package/lib/cjs/IpcHost.js CHANGED Viewed

@@ -119,7 +119,7 @@ class IpcHandler {
     static register() {
         const impl = new this(); // create an instance of subclass. "as any" is necessary because base class is abstract
         return IpcHost.handle(impl.channelName, async (_evt, funcName, ...args) => {
-            var _a;
+            var _a, _b, _c, _d;
             try {
                 const func = impl[funcName];
                 if (typeof func !== "function")
@@ -129,9 +129,9 @@ class IpcHandler {
             catch (err) {
                 const ret = {
                     error: {
-                        name: (err && typeof err === "object") ? err.constructor.name : "Unknown Error",
-                        message: core_bentley_1.BentleyError.getErrorMessage(err),
-                        errorNumber: (_a = err.errorNumber) !== null && _a !== void 0 ? _a : 0,
+                        name: err.hasOwnProperty("name") ? err.name : (_b = (_a = err.constructor) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : "Unknown Error",
+                        message: (_c = err.message) !== null && _c !== void 0 ? _c : core_bentley_1.BentleyError.getErrorMessage(err),
+                        errorNumber: (_d = err.errorNumber) !== null && _d !== void 0 ? _d : 0,
                     },
                 };
                 if (!IpcHost.noStack)

package/lib/cjs/IpcHost.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"IpcHost.js","sourceRoot":"","sources":["../../src/IpcHost.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAAqG;AACrG,oDAI4B;AAE5B,yCAAiE;AACjE,6CAA6D;AAC7D,oEAAyE;AACzE,2DAAuE;AAmBvE;;;;GAIG;AACH,MAAa,OAAO;IAGlB,2EAA2E;IACnE,MAAM,KAAK,GAAG,KAAuB,OAAO,IAAI,CAAC,IAAK,CAAC,CAAC,CAAC,CAAC,+DAA+D;IACjI,gIAAgI;IACzH,MAAM,KAAK,OAAO,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAExE;;;;OAIG;IACI,MAAM,CAAC,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAChD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAA,0BAAY,EAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,OAAyC;QAC7E,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAA,0BAAY,EAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,OAAe,EAAE,QAAqB;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAA,0BAAY,EAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IACD;;;;OAIG;IACI,MAAM,CAAC,cAAc,CAAC,OAAe,EAAE,QAAqB;QACjE,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,IAAA,0BAAY,EAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAEO,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,SAAqC,EAAE,UAAkB,EAAE,GAAG,IAAW;QAC9G,IAAI,IAAI,CAAC,OAAO;YACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,iBAAiB,CAAsC,UAAa,EAAE,GAAG,IAAwC;QAC7H,OAAO,OAAO,CAAC,IAAI,CAAC,2BAAa,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,UAAU,CAAmC,SAAqC,EAAE,UAAa,EAAE,GAAG,IAAqC;QACvJ,IAAI,CAAC,MAAM,CAAC,2BAAa,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,gBAAgB;IACT,MAAM,CAAC,kBAAkB,CAA4C,SAAqC,EAAE,UAAa,EAAE,GAAG,IAA8C;QACjL,IAAI,CAAC,MAAM,CAAC,2BAAa,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAiB;;QAC3C,IAAI,CAAC,IAAI,GAAG,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,0CAAE,MAAM,CAAC;QACjC,IAAI,MAAA,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,0CAAE,UAAU,0CAAE,OAAO;YACnC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEtB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,sDAAsD;YACxE,aAAa,CAAC,QAAQ,EAAE,CAAC;SAC1B;QAED,MAAM,uBAAU,CAAC,OAAO,CAAC,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,mEAAmE;IAC5D,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC1B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,MAAM,uBAAU,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;;AArFH,0BAsFC;AArFe,eAAO,GAAG,KAAK,CAAC;AAuFhC;;;;;;;;;;;GAWG;AACH,MAAsB,UAAU;IAI9B;;;;;OAKG;IACI,MAAM,CAAC,QAAQ;QACpB,MAAM,IAAI,GAAG,IAAK,IAAY,EAAgB,CAAC,CAAC,uFAAuF;QACvI,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAW,EAAE,QAAgB,EAAE,GAAG,IAAW,EAA4B,EAAE;;YACxH,IAAI;gBACF,MAAM,IAAI,GAAI,IAAY,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,OAAO,IAAI,KAAK,UAAU;oBAC5B,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,gBAAgB,EAAE,WAAW,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,QAAQ,qDAAqD,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBAE5K,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;aACnD;YAAC,OAAO,GAAQ,EAAE;gBACjB,MAAM,GAAG,GAAoB;oBAC3B,KAAK,EAAE;wBACL,IAAI,EAAE,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe;wBAC/E,OAAO,EAAE,2BAAY,CAAC,eAAe,CAAC,GAAG,CAAC;wBAC1C,WAAW,EAAE,MAAA,GAAG,CAAC,WAAW,mCAAI,CAAC;qBAClC;iBACF,CAAC;gBACF,IAAI,CAAC,OAAO,CAAC,OAAO;oBAClB,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,2BAAY,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;gBACpD,OAAO,GAAG,CAAC;aACZ;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAjCD,gCAiCC;AAED;;GAEG;AACH,MAAM,aAAc,SAAQ,UAAU;IAAtC;;QAGU,2BAAsB,GAAG,IAAI,GAAG,EAA0B,CAAC;IAqHrE,CAAC;IAvHC,IAAW,WAAW,KAAK,OAAO,2BAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAIrD,KAAK,CAAC,GAAG,CAAC,UAAkB,EAAE,KAAe,EAAE,QAAgB,EAAE,OAAe,EAAE,QAAc;QACrG,QAAQ,KAAK,EAAE;YACb,KAAK,uBAAQ,CAAC,KAAK;gBACjB,qBAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7C,MAAM;YACR,KAAK,uBAAQ,CAAC,IAAI;gBAChB,qBAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC5C,MAAM;YACR,KAAK,uBAAQ,CAAC,KAAK;gBACjB,qBAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7C,MAAM;YACR,KAAK,uBAAQ,CAAC,OAAO;gBACnB,qBAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC/C,MAAM;SACT;IACH,CAAC;IAEM,KAAK,CAAC,yBAAyB,CAAC,UAA0B,EAAE,UAAgC;QACjG,OAAO,IAAA,6CAAyB,EAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IACM,KAAK,CAAC,6BAA6B,CAAC,GAAW,EAAE,UAAoB;QAC1E,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC;IACpF,CAAC;IACM,KAAK,CAAC,aAAa,CAAC,IAAwB;QACjD,MAAM,EAAE,GAAG,MAAM,sBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;IACM,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,QAAkB,EAAE,IAA4B;QAC5F,OAAO,uBAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC9E,CAAC;IACM,KAAK,CAAC,WAAW,CAAC,GAAW;QAClC,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IACM,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,WAAoB;QACxD,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;IACM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC3D,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC3D,CAAC;IACM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC3D,CAAC;IACM,KAAK,CAAC,aAAa,CAAC,GAAW;QACpC,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC;IACM,KAAK,CAAC,aAAa,CAAC,GAAW;QACpC,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,OAAwB,EAAE,OAA4B;QAC1F,MAAM,QAAQ,GAAG,sBAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,kCAAc,CAAC,QAAQ,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,GAAG,EAAE,WAAC,OAAA,MAAA,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,kCAAc,CAAC,QAAQ,CAAA,EAAA,CAAC;QAEzF,IAAI,UAAwC,CAAC;QAC7C,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,EAAE;YAC3B,MAAM,gBAAgB,GAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAC3D,OAAO,CAAC,IAAI,CAAC,IAAA,sCAAwB,EAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC7E,OAAO,UAAU,EAAE,CAAC;YACtB,CAAC,CAAC;YACF,UAAU,GAAG,wBAAwB,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,gBAAgB,CAAC,CAAC;SAChG;aAAM,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,kBAAkB,EAAE;YACtC,UAAU,GAAG,UAAU,CAAC;SACzB;QAED,IAAI;YACF,MAAM,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;SACrD;gBAAS;YACR,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;SACzC;QAED,OAAO,QAAQ,CAAC,SAAgC,CAAC;IACnD,CAAC;IACM,KAAK,CAAC,wBAAwB,CAAC,GAAW;QAC/C,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,kCAAc,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,WAAmB;QACvD,MAAM,QAAQ,GAAG,sBAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAC5C,OAAO,QAAQ,CAAC,SAAgC,CAAC;IACnD,CAAC;IAEM,KAAK,CAAC,2BAA2B,CAAC,GAAW,EAAE,YAAqB;QACzE,MAAM,GAAG,GAAqD,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC,YAAY,CAAC,CAAC;QAC9I,IAAI,GAAG,CAAC,KAAK;YACX,MAAM,IAAI,yBAAW,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,0CAA0C,CAAC,CAAC;QACtF,IAAA,qBAAM,EAAC,SAAS,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IACM,KAAK,CAAC,2BAA2B,CAAC,GAAW;QAClD,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,iCAAiC,EAAE,CAAC;IAC9E,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,aAAqB;QACzD,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IACrE,CAAC;IACM,KAAK,CAAC,aAAa,CAAC,GAAW;QACpC,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvD,CAAC;IACM,KAAK,CAAC,YAAY,CAAC,GAAW;QACnC,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IACzD,CAAC;IACM,KAAK,CAAC,iBAAiB,CAAC,GAAW;QACxC,OAAO,mBAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC9D,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,IAAkB;QAC9C,OAAO,uBAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CAAC,IAAsB,EAAE,UAAgC,EAAE,gBAAyB;IAC1H,MAAM,QAAQ,GAAG,gBAAgB,aAAhB,gBAAgB,cAAhB,gBAAgB,GAAI,GAAG,CAAC,CAAC,+DAA+D;IACzG,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;IACrC,MAAM,gBAAgB,GAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,MAAM,IAAI,KAAK,IAAI,GAAG,IAAI,QAAQ,EAAE;YACtC,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC;YAC1B,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;SAC5B;QACD,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC,CAAC;IAEF,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAbD,4DAaC","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 NativeApp\r\n /\r\n\r\nimport { assert, BentleyError, IModelStatus, Logger, LogLevel, OpenMode } from \"@itwin/core-bentley\";\r\nimport {\r\n ChangesetIndex, ChangesetIndexAndId, EditingScopeNotifications, getPullChangesIpcChannel, IModelConnectionProps, IModelError, IModelRpcProps,\r\n IpcAppChannel, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketBackend, iTwinChannel, OpenBriefcaseProps,\r\n PullChangesOptions, RemoveFunction, StandaloneOpenOptions, TileTreeContentIds, TxnNotifications,\r\n} from \"@itwin/core-common\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { BriefcaseDb, IModelDb, StandaloneDb } from \"./IModelDb\";\r\nimport { IModelHost, IModelHostOptions } from \"./IModelHost\";\r\nimport { cancelTileContentRequests } from \"./rpc-impl/IModelTileRpcImpl\";\r\nimport { ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\r\n\r\n/\r\n Options for [[IpcHost.startup]]\r\n * @public\r\n /\r\nexport interface IpcHostOpts {\r\n iModelHost?: IModelHostOptions;\r\n ipcHost?: {\r\n /* The Ipc socket to use for communications with frontend. Allows undefined only for headless tests. /\r\n socket?: IpcSocketBackend;\r\n\r\n /* don't send stack information on exceptions /\r\n exceptions?: {\r\n noStack?: boolean;\r\n };\r\n };\r\n}\r\n\r\n/\r\n Used by applications that have a dedicated backend. IpcHosts may send messages to their corresponding IpcApp.\r\n * @note if either end terminates, the other must too.\r\n * @public\r\n /\r\nexport class IpcHost {\r\n public static noStack = false;\r\n private static _ipc: IpcSocketBackend \| undefined;\r\n /* Get the implementation of the [IpcSocketBackend]($common) interface. /\r\n private static get ipc(): IpcSocketBackend { return this._ipc!; } // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n /* Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. /\r\n public static get isValid(): boolean { return undefined !== this._ipc; }\r\n\r\n /\r\n Send a message to the frontend over an Ipc channel.\r\n * @param channel the name of the channel matching the name registered with [[IpcApp.addListener]].\r\n * @param data The content of the message.\r\n /\r\n public static send(channel: string, ...data: any[]): void {\r\n this.ipc.send(iTwinChannel(channel), ...data);\r\n }\r\n\r\n /\r\n Establish a handler for an Ipc channel to receive [[Frontend.invoke]] calls\r\n * @param channel The name of the channel for this handler.\r\n * @param handler A function that supplies the implementation for `channel`\r\n * @note returns A function to call to remove the handler.\r\n /\r\n public static handle(channel: string, handler: (...args: any[]) => Promise<any>): RemoveFunction {\r\n return this.ipc.handle(iTwinChannel(channel), handler);\r\n }\r\n /\r\n Establish a handler to receive messages sent via [[IpcApp.send]].\r\n * @param channel The name of the channel for the messages.\r\n * @param listener A function called when messages are sent over `channel`\r\n * @note returns A function to call to remove the listener.\r\n /\r\n public static addListener(channel: string, listener: IpcListener): RemoveFunction {\r\n return this.ipc.addListener(iTwinChannel(channel), listener);\r\n }\r\n /\r\n Remove a previously registered listener\r\n * @param channel The name of the channel for the listener previously registered with [[addListener]]\r\n * @param listener The function passed to [[addListener]]\r\n /\r\n public static removeListener(channel: string, listener: IpcListener): void {\r\n this.ipc.removeListener(iTwinChannel(channel), listener);\r\n }\r\n\r\n private static notify(channel: string, briefcase: BriefcaseDb \| StandaloneDb, methodName: string, ...args: any[]) {\r\n if (this.isValid)\r\n return this.send(`${channel}:${briefcase.key}`, methodName, ...args);\r\n }\r\n\r\n /* @internal /\r\n public static notifyIpcFrontend<T extends keyof IpcAppNotifications>(methodName: T, ...args: Parameters<IpcAppNotifications[T]>) {\r\n return IpcHost.send(IpcAppChannel.AppNotify, methodName, ...args);\r\n }\r\n\r\n /* @internal /\r\n public static notifyTxns<T extends keyof TxnNotifications>(briefcase: BriefcaseDb \| StandaloneDb, methodName: T, ...args: Parameters<TxnNotifications[T]>) {\r\n this.notify(IpcAppChannel.Txns, briefcase, methodName, ...args);\r\n }\r\n\r\n /* @internal /\r\n public static notifyEditingScope<T extends keyof EditingScopeNotifications>(briefcase: BriefcaseDb \| StandaloneDb, methodName: T, ...args: Parameters<EditingScopeNotifications[T]>) {\r\n this.notify(IpcAppChannel.EditingScope, briefcase, methodName, ...args);\r\n }\r\n\r\n /\r\n Start the backend of an Ipc app.\r\n * @param opt\r\n * @note this method calls [[IModelHost.startup]] internally.\r\n /\r\n public static async startup(opt?: IpcHostOpts): Promise<void> {\r\n this._ipc = opt?.ipcHost?.socket;\r\n if (opt?.ipcHost?.exceptions?.noStack)\r\n this.noStack = true;\r\n\r\n if (this.isValid) { // for tests, we use IpcHost but don't have a frontend\r\n IpcAppHandler.register();\r\n }\r\n\r\n await IModelHost.startup(opt?.iModelHost);\r\n }\r\n\r\n /* Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] /\r\n public static async shutdown(): Promise<void> {\r\n this._ipc = undefined;\r\n await IModelHost.shutdown();\r\n }\r\n}\r\n\r\n/\r\n Base class for all implementations of an Ipc interface.\r\n \r\n Create a subclass to implement your Ipc interface. Your class should be declared like this:\r\n * ```ts\r\n * class MyHandler extends IpcHandler implements MyInterface\r\n * ```\r\n * to ensure all methods and signatures are correct.\r\n \r\n Then, call `MyClass.register` at startup to connect your class to your channel.\r\n * @public\r\n /\r\nexport abstract class IpcHandler {\r\n /* All subclasses must implement this method to specify their channel name. /\r\n public abstract get channelName(): string;\r\n\r\n /\r\n Register this class as the handler for methods on its channel. This static method creates a new instance\r\n * that becomes the handler and is `this` when its methods are called.\r\n * @returns A function that can be called to remove the handler.\r\n * @note this method should only be called once per channel. If it is called multiple times, subsequent calls replace the previous ones.\r\n /\r\n public static register(): RemoveFunction {\r\n const impl = new (this as any)() as IpcHandler; // create an instance of subclass. \"as any\" is necessary because base class is abstract\r\n return IpcHost.handle(impl.channelName, async (_evt: Event, funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => {\r\n try {\r\n const func = (impl as any)[funcName];\r\n if (typeof func !== \"function\")\r\n throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${impl.constructor.name}.${funcName}\" not found on IpcHandler registered for channel: ${impl.channelName}`);\r\n\r\n return { result: await func.call(impl, ...args) };\r\n } catch (err: any) {\r\n const ret: IpcInvokeReturn = {\r\n error: {\r\n name: (err && typeof err === \"object\") ? err.constructor.name : \"Unknown Error\",\r\n message: BentleyError.getErrorMessage(err),\r\n errorNumber: err.errorNumber ?? 0,\r\n },\r\n };\r\n if (!IpcHost.noStack)\r\n ret.error.stack = BentleyError.getErrorStack(err);\r\n return ret;\r\n }\r\n });\r\n }\r\n}\r\n\r\n/\r\n Implementation of IpcAppFunctions\r\n /\r\nclass IpcAppHandler extends IpcHandler implements IpcAppFunctions {\r\n public get channelName() { return IpcAppChannel.Functions; }\r\n\r\n private _iModelKeyToPullStatus = new Map<string, ProgressStatus>();\r\n\r\n public async log(_timestamp: number, level: LogLevel, category: string, message: string, metaData?: any): Promise<void> {\r\n switch (level) {\r\n case LogLevel.Error:\r\n Logger.logError(category, message, metaData);\r\n break;\r\n case LogLevel.Info:\r\n Logger.logInfo(category, message, metaData);\r\n break;\r\n case LogLevel.Trace:\r\n Logger.logTrace(category, message, metaData);\r\n break;\r\n case LogLevel.Warning:\r\n Logger.logWarning(category, message, metaData);\r\n break;\r\n }\r\n }\r\n\r\n public async cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\r\n return cancelTileContentRequests(tokenProps, contentIds);\r\n }\r\n public async cancelElementGraphicsRequests(key: string, requestIds: string[]): Promise<void> {\r\n return IModelDb.findByKey(key).nativeDb.cancelElementGraphicsRequests(requestIds);\r\n }\r\n public async openBriefcase(args: OpenBriefcaseProps): Promise<IModelConnectionProps> {\r\n const db = await BriefcaseDb.open(args);\r\n return db.toJSON();\r\n }\r\n public async openStandalone(filePath: string, openMode: OpenMode, opts?: StandaloneOpenOptions): Promise<IModelConnectionProps> {\r\n return StandaloneDb.openFile(filePath, openMode, opts).getConnectionProps();\r\n }\r\n public async closeIModel(key: string): Promise<void> {\r\n IModelDb.findByKey(key).close();\r\n }\r\n public async saveChanges(key: string, description?: string): Promise<void> {\r\n IModelDb.findByKey(key).saveChanges(description);\r\n }\r\n public async hasPendingTxns(key: string): Promise<boolean> {\r\n return IModelDb.findByKey(key).nativeDb.hasPendingTxns();\r\n }\r\n\r\n public async isUndoPossible(key: string): Promise<boolean> {\r\n return IModelDb.findByKey(key).nativeDb.isUndoPossible();\r\n }\r\n public async isRedoPossible(key: string): Promise<boolean> {\r\n return IModelDb.findByKey(key).nativeDb.isRedoPossible();\r\n }\r\n public async getUndoString(key: string): Promise<string> {\r\n return IModelDb.findByKey(key).nativeDb.getUndoString();\r\n }\r\n public async getRedoString(key: string): Promise<string> {\r\n return IModelDb.findByKey(key).nativeDb.getUndoString();\r\n }\r\n\r\n public async pullChanges(key: string, toIndex?: ChangesetIndex, options?: PullChangesOptions): Promise<ChangesetIndexAndId> {\r\n const iModelDb = BriefcaseDb.findByKey(key);\r\n\r\n this._iModelKeyToPullStatus.set(key, ProgressStatus.Continue);\r\n const checkAbort = () => this._iModelKeyToPullStatus.get(key) ?? ProgressStatus.Continue;\r\n\r\n let onProgress: ProgressFunction \| undefined;\r\n if (options?.reportProgress) {\r\n const progressCallback: ProgressFunction = (loaded, total) => {\r\n IpcHost.send(getPullChangesIpcChannel(iModelDb.iModelId), { loaded, total });\r\n return checkAbort();\r\n };\r\n onProgress = throttleProgressCallback(progressCallback, checkAbort, options?.progressInterval);\r\n } else if (options?.enableCancellation) {\r\n onProgress = checkAbort;\r\n }\r\n\r\n try {\r\n await iModelDb.pullChanges({ toIndex, onProgress });\r\n } finally {\r\n this._iModelKeyToPullStatus.delete(key);\r\n }\r\n\r\n return iModelDb.changeset as ChangesetIndexAndId;\r\n }\r\n public async cancelPullChangesRequest(key: string): Promise<void> {\r\n this._iModelKeyToPullStatus.set(key, ProgressStatus.Abort);\r\n }\r\n\r\n public async pushChanges(key: string, description: string): Promise<ChangesetIndexAndId> {\r\n const iModelDb = BriefcaseDb.findByKey(key);\r\n await iModelDb.pushChanges({ description });\r\n return iModelDb.changeset as ChangesetIndexAndId;\r\n }\r\n\r\n public async toggleGraphicalEditingScope(key: string, startSession: boolean): Promise<boolean> {\r\n const val: IModelJsNative.ErrorStatusOrResult<any, boolean> = IModelDb.findByKey(key).nativeDb.setGeometricModelTrackingEnabled(startSession);\r\n if (val.error)\r\n throw new IModelError(val.error.status, \"Failed to toggle graphical editing scope\");\r\n assert(undefined !== val.result);\r\n return val.result;\r\n }\r\n public async isGraphicalEditingSupported(key: string): Promise<boolean> {\r\n return IModelDb.findByKey(key).nativeDb.isGeometricModelTrackingSupported();\r\n }\r\n\r\n public async reverseTxns(key: string, numOperations: number): Promise<IModelStatus> {\r\n return IModelDb.findByKey(key).nativeDb.reverseTxns(numOperations);\r\n }\r\n public async reverseAllTxn(key: string): Promise<IModelStatus> {\r\n return IModelDb.findByKey(key).nativeDb.reverseAll();\r\n }\r\n public async reinstateTxn(key: string): Promise<IModelStatus> {\r\n return IModelDb.findByKey(key).nativeDb.reinstateTxn();\r\n }\r\n public async restartTxnSession(key: string): Promise<void> {\r\n return IModelDb.findByKey(key).nativeDb.restartTxnSession();\r\n }\r\n\r\n public async queryConcurrency(pool: \"io\" \| \"cpu\"): Promise<number> {\r\n return IModelHost.platform.queryConcurrency(pool);\r\n }\r\n}\r\n\r\n/\r\n Prevents progress callback being called more frequently when provided interval.\r\n * @internal\r\n */\r\nexport function throttleProgressCallback(func: ProgressFunction, checkAbort: () => ProgressStatus, progressInterval?: number): ProgressFunction {\r\n const interval = progressInterval ?? 250; // by default, only send progress events every 250 milliseconds\r\n let nextTime = Date.now() + interval;\r\n const progressCallback: ProgressFunction = (loaded, total) => {\r\n const now = Date.now();\r\n if (loaded >= total \|\| now >= nextTime) {\r\n nextTime = now + interval;\r\n return func(loaded, total);\r\n }\r\n return checkAbort();\r\n };\r\n\r\n return progressCallback;\r\n}\r\n"]}
1	+ {"version":3,"file":"IpcHost.js","sourceRoot":"","sources":["../../src/IpcHost.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 NativeApp\r\n /\r\n\r\nimport { assert, BentleyError, IModelStatus, Logger, LogLevel, OpenMode } from \"@itwin/core-bentley\";\r\nimport {\r\n ChangesetIndex, ChangesetIndexAndId, EditingScopeNotifications, getPullChangesIpcChannel, IModelConnectionProps, IModelError, IModelRpcProps,\r\n IpcAppChannel, IpcAppFunctions, IpcAppNotifications, IpcInvokeReturn, IpcListener, IpcSocketBackend, iTwinChannel, OpenBriefcaseProps,\r\n PullChangesOptions, RemoveFunction, StandaloneOpenOptions, TileTreeContentIds, TxnNotifications,\r\n} from \"@itwin/core-common\";\r\nimport { IModelJsNative } from \"@bentley/imodeljs-native\";\r\nimport { BriefcaseDb, IModelDb, StandaloneDb } from \"./IModelDb\";\r\nimport { IModelHost, IModelHostOptions } from \"./IModelHost\";\r\nimport { cancelTileContentRequests } from \"./rpc-impl/IModelTileRpcImpl\";\r\nimport { ProgressFunction, ProgressStatus } from \"./CheckpointManager\";\r\n\r\n/\r\n Options for [[IpcHost.startup]]\r\n * @public\r\n /\r\nexport interface IpcHostOpts {\r\n iModelHost?: IModelHostOptions;\r\n ipcHost?: {\r\n /* The Ipc socket to use for communications with frontend. Allows undefined only for headless tests. /\r\n socket?: IpcSocketBackend;\r\n\r\n /* don't send stack information on exceptions /\r\n exceptions?: {\r\n noStack?: boolean;\r\n };\r\n };\r\n}\r\n\r\n/\r\n Used by applications that have a dedicated backend. IpcHosts may send messages to their corresponding IpcApp.\r\n * @note if either end terminates, the other must too.\r\n * @public\r\n /\r\nexport class IpcHost {\r\n public static noStack = false;\r\n private static _ipc: IpcSocketBackend \| undefined;\r\n /* Get the implementation of the [IpcSocketBackend]($common) interface. /\r\n private static get ipc(): IpcSocketBackend { return this._ipc!; } // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n /* Determine whether Ipc is available for this backend. This will only be true if [[startup]] has been called on this class. /\r\n public static get isValid(): boolean { return undefined !== this._ipc; }\r\n\r\n /\r\n Send a message to the frontend over an Ipc channel.\r\n * @param channel the name of the channel matching the name registered with [[IpcApp.addListener]].\r\n * @param data The content of the message.\r\n /\r\n public static send(channel: string, ...data: any[]): void {\r\n this.ipc.send(iTwinChannel(channel), ...data);\r\n }\r\n\r\n /\r\n Establish a handler for an Ipc channel to receive [[Frontend.invoke]] calls\r\n * @param channel The name of the channel for this handler.\r\n * @param handler A function that supplies the implementation for `channel`\r\n * @note returns A function to call to remove the handler.\r\n /\r\n public static handle(channel: string, handler: (...args: any[]) => Promise<any>): RemoveFunction {\r\n return this.ipc.handle(iTwinChannel(channel), handler);\r\n }\r\n /\r\n Establish a handler to receive messages sent via [[IpcApp.send]].\r\n * @param channel The name of the channel for the messages.\r\n * @param listener A function called when messages are sent over `channel`\r\n * @note returns A function to call to remove the listener.\r\n /\r\n public static addListener(channel: string, listener: IpcListener): RemoveFunction {\r\n return this.ipc.addListener(iTwinChannel(channel), listener);\r\n }\r\n /\r\n Remove a previously registered listener\r\n * @param channel The name of the channel for the listener previously registered with [[addListener]]\r\n * @param listener The function passed to [[addListener]]\r\n /\r\n public static removeListener(channel: string, listener: IpcListener): void {\r\n this.ipc.removeListener(iTwinChannel(channel), listener);\r\n }\r\n\r\n private static notify(channel: string, briefcase: BriefcaseDb \| StandaloneDb, methodName: string, ...args: any[]) {\r\n if (this.isValid)\r\n return this.send(`${channel}:${briefcase.key}`, methodName, ...args);\r\n }\r\n\r\n /* @internal /\r\n public static notifyIpcFrontend<T extends keyof IpcAppNotifications>(methodName: T, ...args: Parameters<IpcAppNotifications[T]>) {\r\n return IpcHost.send(IpcAppChannel.AppNotify, methodName, ...args);\r\n }\r\n\r\n /* @internal /\r\n public static notifyTxns<T extends keyof TxnNotifications>(briefcase: BriefcaseDb \| StandaloneDb, methodName: T, ...args: Parameters<TxnNotifications[T]>) {\r\n this.notify(IpcAppChannel.Txns, briefcase, methodName, ...args);\r\n }\r\n\r\n /* @internal /\r\n public static notifyEditingScope<T extends keyof EditingScopeNotifications>(briefcase: BriefcaseDb \| StandaloneDb, methodName: T, ...args: Parameters<EditingScopeNotifications[T]>) {\r\n this.notify(IpcAppChannel.EditingScope, briefcase, methodName, ...args);\r\n }\r\n\r\n /\r\n Start the backend of an Ipc app.\r\n * @param opt\r\n * @note this method calls [[IModelHost.startup]] internally.\r\n /\r\n public static async startup(opt?: IpcHostOpts): Promise<void> {\r\n this._ipc = opt?.ipcHost?.socket;\r\n if (opt?.ipcHost?.exceptions?.noStack)\r\n this.noStack = true;\r\n\r\n if (this.isValid) { // for tests, we use IpcHost but don't have a frontend\r\n IpcAppHandler.register();\r\n }\r\n\r\n await IModelHost.startup(opt?.iModelHost);\r\n }\r\n\r\n /* Shutdown IpcHost backend. Also calls [[IModelHost.shutdown]] /\r\n public static async shutdown(): Promise<void> {\r\n this._ipc = undefined;\r\n await IModelHost.shutdown();\r\n }\r\n}\r\n\r\n/\r\n Base class for all implementations of an Ipc interface.\r\n \r\n Create a subclass to implement your Ipc interface. Your class should be declared like this:\r\n * ```ts\r\n * class MyHandler extends IpcHandler implements MyInterface\r\n * ```\r\n * to ensure all methods and signatures are correct.\r\n \r\n Then, call `MyClass.register` at startup to connect your class to your channel.\r\n * @public\r\n /\r\nexport abstract class IpcHandler {\r\n /* All subclasses must implement this method to specify their channel name. /\r\n public abstract get channelName(): string;\r\n\r\n /\r\n Register this class as the handler for methods on its channel. This static method creates a new instance\r\n * that becomes the handler and is `this` when its methods are called.\r\n * @returns A function that can be called to remove the handler.\r\n * @note this method should only be called once per channel. If it is called multiple times, subsequent calls replace the previous ones.\r\n /\r\n public static register(): RemoveFunction {\r\n const impl = new (this as any)() as IpcHandler; // create an instance of subclass. \"as any\" is necessary because base class is abstract\r\n return IpcHost.handle(impl.channelName, async (_evt: Event, funcName: string, ...args: any[]): Promise<IpcInvokeReturn> => {\r\n try {\r\n const func = (impl as any)[funcName];\r\n if (typeof func !== \"function\")\r\n throw new IModelError(IModelStatus.FunctionNotFound, `Method \"${impl.constructor.name}.${funcName}\" not found on IpcHandler registered for channel: ${impl.channelName}`);\r\n\r\n return { result: await func.call(impl, ...args) };\r\n } catch (err: any) {\r\n const ret: IpcInvokeReturn = {\r\n error: {\r\n name: err.hasOwnProperty(\"name\") ? err.name : err.constructor?.name ?? \"Unknown Error\",\r\n message: err.message ?? BentleyError.getErrorMessage(err),\r\n errorNumber: err.errorNumber ?? 0,\r\n },\r\n };\r\n if (!IpcHost.noStack)\r\n ret.error.stack = BentleyError.getErrorStack(err);\r\n return ret;\r\n }\r\n });\r\n }\r\n}\r\n\r\n/\r\n Implementation of IpcAppFunctions\r\n /\r\nclass IpcAppHandler extends IpcHandler implements IpcAppFunctions {\r\n public get channelName() { return IpcAppChannel.Functions; }\r\n\r\n private _iModelKeyToPullStatus = new Map<string, ProgressStatus>();\r\n\r\n public async log(_timestamp: number, level: LogLevel, category: string, message: string, metaData?: any): Promise<void> {\r\n switch (level) {\r\n case LogLevel.Error:\r\n Logger.logError(category, message, metaData);\r\n break;\r\n case LogLevel.Info:\r\n Logger.logInfo(category, message, metaData);\r\n break;\r\n case LogLevel.Trace:\r\n Logger.logTrace(category, message, metaData);\r\n break;\r\n case LogLevel.Warning:\r\n Logger.logWarning(category, message, metaData);\r\n break;\r\n }\r\n }\r\n\r\n public async cancelTileContentRequests(tokenProps: IModelRpcProps, contentIds: TileTreeContentIds[]): Promise<void> {\r\n return cancelTileContentRequests(tokenProps, contentIds);\r\n }\r\n public async cancelElementGraphicsRequests(key: string, requestIds: string[]): Promise<void> {\r\n return IModelDb.findByKey(key).nativeDb.cancelElementGraphicsRequests(requestIds);\r\n }\r\n public async openBriefcase(args: OpenBriefcaseProps): Promise<IModelConnectionProps> {\r\n const db = await BriefcaseDb.open(args);\r\n return db.toJSON();\r\n }\r\n public async openStandalone(filePath: string, openMode: OpenMode, opts?: StandaloneOpenOptions): Promise<IModelConnectionProps> {\r\n return StandaloneDb.openFile(filePath, openMode, opts).getConnectionProps();\r\n }\r\n public async closeIModel(key: string): Promise<void> {\r\n IModelDb.findByKey(key).close();\r\n }\r\n public async saveChanges(key: string, description?: string): Promise<void> {\r\n IModelDb.findByKey(key).saveChanges(description);\r\n }\r\n public async hasPendingTxns(key: string): Promise<boolean> {\r\n return IModelDb.findByKey(key).nativeDb.hasPendingTxns();\r\n }\r\n\r\n public async isUndoPossible(key: string): Promise<boolean> {\r\n return IModelDb.findByKey(key).nativeDb.isUndoPossible();\r\n }\r\n public async isRedoPossible(key: string): Promise<boolean> {\r\n return IModelDb.findByKey(key).nativeDb.isRedoPossible();\r\n }\r\n public async getUndoString(key: string): Promise<string> {\r\n return IModelDb.findByKey(key).nativeDb.getUndoString();\r\n }\r\n public async getRedoString(key: string): Promise<string> {\r\n return IModelDb.findByKey(key).nativeDb.getUndoString();\r\n }\r\n\r\n public async pullChanges(key: string, toIndex?: ChangesetIndex, options?: PullChangesOptions): Promise<ChangesetIndexAndId> {\r\n const iModelDb = BriefcaseDb.findByKey(key);\r\n\r\n this._iModelKeyToPullStatus.set(key, ProgressStatus.Continue);\r\n const checkAbort = () => this._iModelKeyToPullStatus.get(key) ?? ProgressStatus.Continue;\r\n\r\n let onProgress: ProgressFunction \| undefined;\r\n if (options?.reportProgress) {\r\n const progressCallback: ProgressFunction = (loaded, total) => {\r\n IpcHost.send(getPullChangesIpcChannel(iModelDb.iModelId), { loaded, total });\r\n return checkAbort();\r\n };\r\n onProgress = throttleProgressCallback(progressCallback, checkAbort, options?.progressInterval);\r\n } else if (options?.enableCancellation) {\r\n onProgress = checkAbort;\r\n }\r\n\r\n try {\r\n await iModelDb.pullChanges({ toIndex, onProgress });\r\n } finally {\r\n this._iModelKeyToPullStatus.delete(key);\r\n }\r\n\r\n return iModelDb.changeset as ChangesetIndexAndId;\r\n }\r\n public async cancelPullChangesRequest(key: string): Promise<void> {\r\n this._iModelKeyToPullStatus.set(key, ProgressStatus.Abort);\r\n }\r\n\r\n public async pushChanges(key: string, description: string): Promise<ChangesetIndexAndId> {\r\n const iModelDb = BriefcaseDb.findByKey(key);\r\n await iModelDb.pushChanges({ description });\r\n return iModelDb.changeset as ChangesetIndexAndId;\r\n }\r\n\r\n public async toggleGraphicalEditingScope(key: string, startSession: boolean): Promise<boolean> {\r\n const val: IModelJsNative.ErrorStatusOrResult<any, boolean> = IModelDb.findByKey(key).nativeDb.setGeometricModelTrackingEnabled(startSession);\r\n if (val.error)\r\n throw new IModelError(val.error.status, \"Failed to toggle graphical editing scope\");\r\n assert(undefined !== val.result);\r\n return val.result;\r\n }\r\n public async isGraphicalEditingSupported(key: string): Promise<boolean> {\r\n return IModelDb.findByKey(key).nativeDb.isGeometricModelTrackingSupported();\r\n }\r\n\r\n public async reverseTxns(key: string, numOperations: number): Promise<IModelStatus> {\r\n return IModelDb.findByKey(key).nativeDb.reverseTxns(numOperations);\r\n }\r\n public async reverseAllTxn(key: string): Promise<IModelStatus> {\r\n return IModelDb.findByKey(key).nativeDb.reverseAll();\r\n }\r\n public async reinstateTxn(key: string): Promise<IModelStatus> {\r\n return IModelDb.findByKey(key).nativeDb.reinstateTxn();\r\n }\r\n public async restartTxnSession(key: string): Promise<void> {\r\n return IModelDb.findByKey(key).nativeDb.restartTxnSession();\r\n }\r\n\r\n public async queryConcurrency(pool: \"io\" \| \"cpu\"): Promise<number> {\r\n return IModelHost.platform.queryConcurrency(pool);\r\n }\r\n}\r\n\r\n/\r\n Prevents progress callback being called more frequently when provided interval.\r\n * @internal\r\n */\r\nexport function throttleProgressCallback(func: ProgressFunction, checkAbort: () => ProgressStatus, progressInterval?: number): ProgressFunction {\r\n const interval = progressInterval ?? 250; // by default, only send progress events every 250 milliseconds\r\n let nextTime = Date.now() + interval;\r\n const progressCallback: ProgressFunction = (loaded, total) => {\r\n const now = Date.now();\r\n if (loaded >= total \|\| now >= nextTime) {\r\n nextTime = now + interval;\r\n return func(loaded, total);\r\n }\r\n return checkAbort();\r\n };\r\n\r\n return progressCallback;\r\n}\r\n"]}

package/lib/cjs/workspace/Workspace.js CHANGED Viewed

@@ -429,11 +429,11 @@ class EditableWorkspaceDb extends ITwinWorkspaceDb {
             // currently the only way to create a workspaceDb in a cloud container is to create a temporary workspaceDb and upload it.
             const tempDbFile = (0, path_1.join)(IModelHost_1.KnownLocations.tmpdir, `empty.${ITwinWorkspaceDb.fileExt}`);
             if (fs.existsSync(tempDbFile))
-                fs.rmSync(tempDbFile);
+                IModelJsFs_1.IModelJsFs.removeSync(tempDbFile);
             EditableWorkspaceDb.createEmpty(tempDbFile);
             this.dbFileName = ITwinWorkspaceContainer.makeDbFileName(this.dbName, version);
             await CloudSqlite_1.CloudSqlite.uploadDb(this.container.cloudContainer, { localFileName: tempDbFile, dbName: this.dbFileName });
-            fs.rmSync(tempDbFile);
+            IModelJsFs_1.IModelJsFs.removeSync(tempDbFile);
         }
         this.open();
     }

package/lib/cjs/workspace/Workspace.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Workspace.js","sourceRoot":"","sources":["../../../src/workspace/Workspace.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 { createHash } from \"crypto\";\r\nimport as fs from \"fs-extra\";\r\nimport { dirname, extname, join } from \"path\";\r\nimport * as semver from \"semver\";\r\nimport { AccessToken, BeEvent, DbResult, OpenMode, Optional } from \"@itwin/core-bentley\";\r\nimport { IModelError, LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { CloudSqlite } from \"../CloudSqlite\";\r\nimport { IModelHost, KnownLocations } from \"../IModelHost\";\r\nimport { IModelJsFs } from \"../IModelJsFs\";\r\nimport { SQLiteDb } from \"../SQLiteDb\";\r\nimport { SqliteStatement } from \"../SqliteStatement\";\r\nimport { Settings, SettingsPriority } from \"./Settings\";\r\nimport { SettingsSchemas } from \"./SettingsSchemas\";\r\n\r\n/* eslint-disable @typescript-eslint/naming-convention /\r\n// cspell:ignore rowid primarykey julianday\r\n\r\n/* The Settings used by Workspace api\r\n * @beta\r\n /\r\nexport const WorkspaceSetting = {\r\n Accounts: \"cloud/accounts\",\r\n Containers: \"cloud/containers\",\r\n Databases: \"workspace/databases\",\r\n};\r\n\r\n/* Types used to identify cloud accounts for Workspaces.\r\n * @beta\r\n /\r\nexport namespace WorkspaceAccount {\r\n /* The name of a WorkspaceAccount in a \"cloud/accounts\" setting. /\r\n export type Name = string;\r\n\r\n /* A member named `accountName` that specifies by an entry in a \"cloud/accounts\" setting /\r\n export interface Alias { accountName: string }\r\n\r\n /* The properties of a cloud account required to open containers with CloudSqlite. Usually supplied via a \"cloud/accounts\" setting. /\r\n export type Props = CloudSqlite.AccountAccessProps;\r\n}\r\n\r\n/* @beta /\r\nexport namespace WorkspaceContainer {\r\n /* The name of a WorkspaceContainer in a \"cloud/containers\" setting. /\r\n export type Name = string;\r\n\r\n /* The unique identifier of a WorkspaceContainer. This becomes the base name for the local directory holding the WorkspaceDbs from a WorkspaceContainer.\r\n * Usually supplied via the `containerId` member of a \"cloud/containers\" setting.\r\n * `WorkspaceContainer.Id`s may:\r\n * - only contain lower case letters, numbers or dashes\r\n * - not start or end with a dash\r\n * - not be shorter than 3 or longer than 63 characters\r\n /\r\n export type Id = string;\r\n\r\n /* A member named `containerName` that specifies by an entry in a \"cloud/containers\" setting /\r\n export interface Alias { containerName: string }\r\n\r\n /* Properties that specify a WorkspaceContainer. /\r\n export interface Props extends Optional<CloudSqlite.ContainerProps, \"accessToken\"> {\r\n /* true if the container is public (doesn't require authentication) /\r\n isPublic?: boolean;\r\n /* attempt to synchronize (i.e. call `checkForChanges`) this cloud container whenever it is connected to a cloud cache. Default=true /\r\n syncOnConnect?: boolean;\r\n }\r\n\r\n /* A function to supply an [AccessToken]($bentley) for a `WorkspaceContainer`.\r\n * @param props The properties of the WorkspaceContainer necessary to obtain the access token\r\n * @param account The properties of the account for the container\r\n * @returns a Promise that resolves to the AccessToken for the container.\r\n /\r\n export type TokenFunc = (props: Props, account: WorkspaceAccount.Props) => Promise<AccessToken>;\r\n}\r\n\r\n/* @beta /\r\nexport namespace WorkspaceDb {\r\n /* The name of a WorkspaceDb in a \"workspace/databases\" setting. /\r\n export type Name = string;\r\n\r\n /* The base name of a WorkspaceDb within a WorkspaceContainer (without any version identifier) /\r\n export type DbName = string;\r\n\r\n /* The name of a WorkspaceDb within a WorkspaceContainer, including the version identifier /\r\n export type DbFullName = string;\r\n\r\n /* The semver-format version identifier for a WorkspaceDb. /\r\n export type Version = string;\r\n\r\n /* The [semver range format](https://github.com/npm/node-semver) identifier for a range of acceptable versions. /\r\n export type VersionRange = string;\r\n\r\n /* Properties that specify how to load a WorkspaceDb within a [[WorkspaceContainer]]. /\r\n export interface Props extends CloudSqlite.DbNameProp {\r\n /* a semver version range specifier that determines the acceptable range of versions to load. If not present, use the newest version. /\r\n version?: VersionRange;\r\n /* if true, allow semver prerelease versions. By default only released version are allowed. /\r\n includePrerelease?: boolean;\r\n }\r\n\r\n /* Scope to increment for a version number.\r\n * @see semver.ReleaseType\r\n /\r\n export type VersionIncrement = \"major\" \| \"minor\" \| \"patch\";\r\n}\r\n\r\n/* Types used to identify Workspace resources\r\n * @beta\r\n /\r\nexport namespace WorkspaceResource {\r\n /\r\n The name for identifying WorkspaceResources in a [[WorkspaceDb]].\r\n * * `WorkspaceResource.Name`s may not:\r\n * - be blank or start or end with a space\r\n * - be longer than 1024 characters\r\n * @note a single WorkspaceDb may hold WorkspaceResources of type 'blob', 'string' and 'file', all with the same WorkspaceResource.Name.\r\n /\r\n export type Name = string;\r\n\r\n /* Properties that specify an individual WorkspaceResource within a [[WorkspaceDb]]. /\r\n export interface Props {\r\n /* the name of the resource within the WorkspaceDb /\r\n rscName: Name;\r\n }\r\n}\r\n\r\n/\r\n A WorkspaceDb holds workspace resources. `WorkspaceDb`s may just be local files, or they may be stored\r\n * in cloud WorkspaceContainers. Each `WorkspaceResource` in a WorkspaceDb is identified by a [[WorkspaceResource.Name]].\r\n * Resources of type `string` and `blob` may be loaded directly from the `WorkspaceDb`. Resources of type `file` are\r\n * copied from the WorkspaceDb into a temporary local file so they can be accessed by programs directly from disk.\r\n * @beta\r\n /\r\nexport interface WorkspaceDb {\r\n /* The WorkspaceContainer holding this WorkspaceDb. /\r\n readonly container: WorkspaceContainer;\r\n /* The base name of this WorkspaceDb, without version /\r\n readonly dbName: WorkspaceDb.DbName;\r\n /* event raised before this WorkspaceDb is closed. /\r\n readonly onClose: BeEvent<() => void>;\r\n /* Name by which a WorkspaceDb may be opened. This will be either a local file name or the name of a database in a cloud container /\r\n readonly dbFileName: string;\r\n /* Get a string resource from this WorkspaceDb, if present. /\r\n getString(rscName: WorkspaceResource.Name): string \| undefined;\r\n /* Get a blob resource from this WorkspaceDb, if present. /\r\n getBlob(rscName: WorkspaceResource.Name): Uint8Array \| undefined;\r\n /* @internal /\r\n getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;\r\n\r\n /\r\n Extract a local copy of a file resource from this WorkspaceDb, if present.\r\n * @param rscName The name of the file resource in the WorkspaceDb\r\n * @param targetFileName optional name for extracted file. Some applications require files in specific locations or filenames. If\r\n * you know the full path to use for the extracted file, you can supply it. Generally, it is best to not supply the filename and\r\n * keep the extracted files in the filesDir.\r\n * @returns the full path to a file on the local filesystem.\r\n * @note The file is copied from the file into the local filesystem so it may be accessed directly. This happens only\r\n * as necessary, if the local file doesn't exist, or if it is out-of-date because it was updated in the file.\r\n * For this reason, you should not save the local file name, and instead call this method every time you access it, so its\r\n * content is always holds the correct version.\r\n * @note The filename will be a hash value, not the resource name.\r\n * @note Workspace resource files are set readonly as they are copied from the file.\r\n * To edit them, you must first copy them to another location.\r\n /\r\n getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName \| undefined;\r\n\r\n /\r\n Ensure that the contents of a `WorkspaceDb` are downloaded into the local cache so that it may be accessed offline.\r\n * Until the promise is resolved, the `WorkspaceDb` is not fully downloaded, but it may be safely accessed during the download.\r\n * To determine the progress of the download, use the `localBlocks` and `totalBlocks` values returned by `CloudContainer.queryDatabase`.\r\n * @returns a `CloudSqlite.CloudPrefetch` object that can be used to await and/or cancel the prefetch.\r\n * @throws if this WorkspaceDb is not from a `CloudContainer`.\r\n /\r\n prefetch(): CloudSqlite.CloudPrefetch;\r\n}\r\n\r\n/* The properties of the CloudCache used for Workspaces.\r\n * @beta\r\n /\r\nexport interface WorkspaceCloudCacheProps extends Optional<CloudSqlite.CacheProps, \"name\" \| \"rootDir\"> {\r\n /* if true, empty the cache before using it. /\r\n clearContents?: boolean;\r\n}\r\n\r\n/\r\n Options for constructing a [[Workspace]].\r\n * @beta\r\n /\r\nexport interface WorkspaceOpts {\r\n /* The local directory for non-cloud-based WorkspaceDb files. The workspace api will look in this directory\r\n * for files named `${containerId}/${dbId}.itwin-workspace`.\r\n * @note if not supplied, defaults to `iTwin/Workspace` in the user-local folder.\r\n /\r\n containerDir?: LocalDirName;\r\n\r\n /* the local fileName(s) of one or more settings files to load after the Workspace is first created. /\r\n settingsFiles?: LocalFileName \| [LocalFileName];\r\n\r\n /\r\n only for tests\r\n * @internal /\r\n testCloudCache?: CloudSqlite.CloudCache;\r\n}\r\n\r\n/\r\n Settings and resources that customize an application for the current session.\r\n * See [Workspaces]($docs/learning/backend/Workspace)\r\n * @beta\r\n /\r\nexport interface Workspace {\r\n /* The directory for local WorkspaceDb files with the name `${containerId}/${dbId}.itwin-workspace`. /\r\n readonly containerDir: LocalDirName;\r\n /* The [[Settings]] for this Workspace /\r\n readonly settings: Settings;\r\n /* The CloudCache for cloud-based WorkspaceContainers /\r\n readonly cloudCache?: CloudSqlite.CloudCache;\r\n\r\n /* search for a previously opened container.\r\n * @param containerId the id of the container\r\n * @returns the [[WorkspaceContainer]] for `containerId` if it was not previously opened with [[getContainer]]\r\n /\r\n findContainer(containerId: WorkspaceContainer.Id): WorkspaceContainer \| undefined;\r\n\r\n /* get a [[WorkspaceContainer]] by [[WorkspaceContainer.Props]]\r\n * @param props the properties of the `WorkspaceContainer`. If `props.containerId` was already opened, its WorkspaceContainer is returned.\r\n * Otherwise it is created.\r\n * @param account If present, the properties for this container if it is to be opened from the cloud. If not present, the container is just a local directory.\r\n /\r\n getContainer(props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceContainer;\r\n\r\n /* get the properties for the supplied account name by searching for an entry with that name in a `cloud/accounts` setting. /\r\n resolveAccount(accountName: WorkspaceAccount.Name): WorkspaceAccount.Props;\r\n\r\n /* get the properties for the supplied container name by searching for an entry with that name in a `cloud/containers` setting. /\r\n resolveContainer(containerName: WorkspaceContainer.Name): WorkspaceContainer.Props & WorkspaceAccount.Alias;\r\n\r\n /* get the properties for the supplied workspace database name by searching for an entry with that name in a `workspace/databases` setting. /\r\n resolveDatabase(databaseAlias: WorkspaceDb.Name): WorkspaceDb.Props & WorkspaceContainer.Alias;\r\n\r\n /\r\n Get an opened [[WorkspaceDb]]. If the WorkspaceDb is present but not open, it is opened first.\r\n * If `cloudProps` are supplied, a CloudContainer will be used to open the WorkspaceDb.\r\n /\r\n getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceDb;\r\n\r\n /* Get an opened [[WorkspaceDb]] from a WorkspaceDb alias.\r\n * @param dbAlias the database alias, resolved via [[resolveDatabase]].\r\n * @param tokenFunc optional function to obtain an AccessToken for the resolved WorkspaceContainer. This function will only be called the first\r\n * time a container is used.\r\n /\r\n getWorkspaceDb(dbAlias: WorkspaceDb.Name, tokenFunc?: WorkspaceContainer.TokenFunc): Promise<WorkspaceDb>;\r\n\r\n /* Load a WorkspaceResource of type string, parse it, and add it to the current Settings for this Workspace.\r\n * @note settingsRsc must specify a resource holding a stringified JSON representation of a [[SettingDictionary]]\r\n /\r\n loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority): void;\r\n\r\n /* Close this Workspace. All WorkspaceContainers are dropped. /\r\n close(): void;\r\n}\r\n\r\n/\r\n A WorkspaceContainer holds WorkspaceDbs.\r\n * Access rights are administered per WorkspaceContainer. That is, if a user has rights to access a WorkspaceContainer, that right\r\n * applies to all WorkspaceDbs in the WorkspaceContainer.\r\n * @beta\r\n /\r\nexport interface WorkspaceContainer {\r\n /* the local directory where this WorkspaceContainer will store temporary files extracted for file-resources. /\r\n readonly filesDir: LocalDirName;\r\n /* The unique identifier for a WorkspaceContainer a cloud storage account. /\r\n readonly id: WorkspaceContainer.Id;\r\n /* Workspace holding this WorkspaceContainer. /\r\n readonly workspace: Workspace;\r\n /* CloudContainer for this WorkspaceContainer (`undefined` if this is a local WorkspaceContainer.)\r\n * @internal\r\n /\r\n readonly cloudContainer?: CloudSqlite.CloudContainer;\r\n\r\n /* @internal /\r\n addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;\r\n /* @internal /\r\n resolveDbFileName(props: WorkspaceDb.Props): string;\r\n\r\n /* find or open a WorkspaceDb from this WorkspaceContainer. /\r\n getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;\r\n /* Close and remove a currently opened [[WorkspaceDb]] from this Workspace. /\r\n dropWorkspaceDb(container: WorkspaceDb): void;\r\n /* Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. /\r\n close(): void;\r\n}\r\n\r\n/* @internal /\r\nexport class ITwinWorkspace implements Workspace {\r\n private _containers = new Map<WorkspaceContainer.Id, ITwinWorkspaceContainer>();\r\n public readonly containerDir: LocalDirName;\r\n public readonly settings: Settings;\r\n private static _sharedCloudCache?: CloudSqlite.CloudCache;\r\n private _cloudCache?: CloudSqlite.CloudCache;\r\n public get cloudCache(): CloudSqlite.CloudCache {\r\n if (undefined === this._cloudCache)\r\n this._cloudCache = ITwinWorkspace.getSharedCloudCache();\r\n return this._cloudCache;\r\n }\r\n private static getSharedCloudCache(): CloudSqlite.CloudCache {\r\n if (undefined === this._sharedCloudCache) {\r\n const rootDir = join(IModelHost.cacheDir, \"Workspace\", \"cloud\");\r\n IModelJsFs.recursiveMkDirSync(rootDir);\r\n this._sharedCloudCache = CloudSqlite.createCloudCache({ rootDir, cacheSize: \"20G\", name: \"workspace\" });\r\n }\r\n return this._sharedCloudCache;\r\n }\r\n public static finalize() {\r\n if (this._sharedCloudCache) {\r\n this._sharedCloudCache.destroy();\r\n this._sharedCloudCache = undefined;\r\n }\r\n }\r\n\r\n public constructor(settings: Settings, opts?: WorkspaceOpts) {\r\n this.settings = settings;\r\n this.containerDir = opts?.containerDir ?? join(IModelHost.cacheDir, \"Workspace\");\r\n this._cloudCache = opts?.testCloudCache;\r\n let settingsFiles = opts?.settingsFiles;\r\n if (settingsFiles) {\r\n if (typeof settingsFiles === \"string\")\r\n settingsFiles = [settingsFiles];\r\n settingsFiles.forEach((file) => settings.addFile(file, SettingsPriority.application));\r\n }\r\n }\r\n\r\n public addContainer(toAdd: ITwinWorkspaceContainer) {\r\n if (undefined !== this._containers.get(toAdd.id))\r\n throw new Error(\"container already exists in workspace\");\r\n this._containers.set(toAdd.id, toAdd);\r\n }\r\n\r\n public findContainer(containerId: WorkspaceContainer.Id) {\r\n return this._containers.get(containerId);\r\n }\r\n\r\n public getContainer(props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceContainer {\r\n return this.findContainer(props.containerId) ?? new ITwinWorkspaceContainer(this, props, account);\r\n }\r\n\r\n public getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceDb {\r\n return this.getContainer(containerProps, account).getWorkspaceDb(dbProps);\r\n }\r\n\r\n public async getWorkspaceDb(dbAlias: string, tokenFunc?: WorkspaceContainer.TokenFunc) {\r\n const dbProps = this.resolveDatabase(dbAlias);\r\n const containerProps = this.resolveContainer(dbProps.containerName);\r\n const account = containerProps.accountName !== \"\" ? this.resolveAccount(containerProps.accountName) : undefined;\r\n let container: WorkspaceContainer \| undefined = this.findContainer(containerProps.containerId);\r\n if (undefined === container) {\r\n if (tokenFunc && account)\r\n containerProps.accessToken = await tokenFunc(containerProps, account);\r\n container = this.getContainer(containerProps, account);\r\n }\r\n return container?.getWorkspaceDb(dbProps);\r\n }\r\n\r\n public loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority) {\r\n const setting = db.getString(settingRsc);\r\n if (undefined === setting)\r\n throw new Error(`could not load setting resource ${settingRsc}`);\r\n\r\n this.settings.addJson(`${db.container.id}/${db.dbName}/${settingRsc}`, priority, setting);\r\n }\r\n\r\n public close() {\r\n this.settings.close();\r\n for (const [_id, container] of this._containers)\r\n container.close();\r\n this._containers.clear();\r\n }\r\n\r\n public resolveAccount(accountName: string): WorkspaceAccount.Props {\r\n const resolved = this.settings.resolveSetting<WorkspaceAccount.Props>(WorkspaceSetting.Accounts, (val) => {\r\n if (Array.isArray(val)) {\r\n for (const entry of val) {\r\n if (typeof entry === \"object\" && entry.name === accountName)\r\n return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Accounts, accountName);\r\n }\r\n }\r\n return undefined; // keep going through all settings dictionaries\r\n });\r\n if (resolved === undefined)\r\n throw new Error(`no setting \"${WorkspaceSetting.Accounts}\" entry for \"${accountName}\"`);\r\n\r\n return resolved;\r\n }\r\n\r\n public resolveContainer(containerName: string): WorkspaceContainer.Props & WorkspaceAccount.Alias {\r\n const resolved = this.settings.resolveSetting<WorkspaceContainer.Props & WorkspaceAccount.Alias>(WorkspaceSetting.Containers, (val) => {\r\n if (Array.isArray(val)) {\r\n for (const entry of val) {\r\n if (typeof entry === \"object\" && entry.name === containerName)\r\n return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Containers, containerName);\r\n }\r\n }\r\n return undefined; // keep going through all settings dictionaries\r\n });\r\n if (resolved === undefined)\r\n throw new Error(`no setting \"${WorkspaceSetting.Containers}\" entry for \"${containerName}\"`);\r\n\r\n return resolved;\r\n }\r\n\r\n public resolveDatabase(databaseName: string): WorkspaceDb.Props & WorkspaceContainer.Alias {\r\n const resolved = this.settings.resolveSetting<WorkspaceDb.Props & WorkspaceContainer.Alias>(WorkspaceSetting.Databases, (val) => {\r\n if (Array.isArray(val)) {\r\n for (const entry of val) {\r\n if (typeof entry === \"object\" && entry.name === databaseName)\r\n return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Databases, databaseName);\r\n }\r\n }\r\n return undefined; // keep going through all settings dictionaries\r\n });\r\n\r\n if (resolved === undefined)\r\n throw new Error(`no setting \"${WorkspaceSetting.Databases}\" entry for \"${databaseName}\"`);\r\n\r\n return resolved;\r\n }\r\n}\r\n\r\n/* @internal /\r\nexport class ITwinWorkspaceContainer implements WorkspaceContainer {\r\n public readonly workspace: ITwinWorkspace;\r\n public readonly filesDir: LocalDirName;\r\n public readonly id: WorkspaceContainer.Id;\r\n\r\n public readonly cloudContainer?: CloudSqlite.CloudContainer \| undefined;\r\n private _wsDbs = new Map<WorkspaceDb.DbName, ITwinWorkspaceDb>();\r\n public get dirName() { return join(this.workspace.containerDir, this.id); }\r\n\r\n public static noLeadingOrTrailingSpaces(name: string, msg: string) {\r\n if (name.trim() !== name)\r\n throw new Error(`${msg} [${name}] may not have leading or tailing spaces`);\r\n }\r\n\r\n /* rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata)\r\n * - may only contain lower case letters, numbers or dashes\r\n * - may not start or end with with a dash nor have more than one dash in a row\r\n * - may not be shorter than 3 or longer than 63 characters\r\n /\r\n private static validateContainerId(id: WorkspaceContainer.Id) {\r\n if (!/^(?=.{3,63}$)[a-z0-9]+(-[a-z0-9]+)$/g.test(id))\r\n throw new Error(`invalid containerId: [${id}]`);\r\n }\r\n\r\n public static validateDbName(dbName: WorkspaceDb.DbName) {\r\n if (dbName === \"\" \|\| dbName.length > 255 \|\| /[#\\.<>:\"/\\\\\"`'\|?\\u0000-\\u001F]/g.test(dbName) \|\| /^(con\|prn\|aux\|nul\|com\\d\|lpt\\d)$/i.test(dbName))\r\n throw new Error(`invalid dbName: [${dbName}]`);\r\n this.noLeadingOrTrailingSpaces(dbName, \"dbName\");\r\n }\r\n\r\n public constructor(workspace: ITwinWorkspace, props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props) {\r\n ITwinWorkspaceContainer.validateContainerId(props.containerId);\r\n this.workspace = workspace;\r\n this.id = props.containerId;\r\n\r\n if (account?.accessName && account.storageType)\r\n this.cloudContainer = CloudSqlite.createCloudContainer({ accessToken: \"\", ...props, ...account });\r\n\r\n workspace.addContainer(this);\r\n this.filesDir = join(this.dirName, \"Files\");\r\n\r\n const cloudContainer = this.cloudContainer;\r\n if (undefined === cloudContainer)\r\n return;\r\n\r\n cloudContainer.connect(this.workspace.cloudCache);\r\n if (false !== props.syncOnConnect) {\r\n try {\r\n cloudContainer.checkForChanges();\r\n } catch (e: unknown) {\r\n // must be offline\r\n }\r\n }\r\n }\r\n\r\n public static validateVersion(version?: WorkspaceDb.Version) {\r\n version = version ?? \"1.0.0\";\r\n if (version) {\r\n const opts = { loose: true, includePrerelease: true };\r\n // clean allows prerelease, so try it first. If that fails attempt to coerce it (coerce strips prerelease even if you say not to.)\r\n const semVersion = semver.clean(version, opts) ?? semver.coerce(version, opts)?.version;\r\n if (!semVersion)\r\n throw new Error(\"invalid version specification\");\r\n version = semVersion;\r\n }\r\n return version;\r\n }\r\n\r\n public static parseDbFileName(dbFileName: WorkspaceDb.DbFullName): { dbName: WorkspaceDb.DbName, version: WorkspaceDb.Version } {\r\n const parts = dbFileName.split(\":\");\r\n return { dbName: parts[0], version: parts[1] };\r\n }\r\n\r\n public static makeDbFileName(dbName: WorkspaceDb.DbName, version?: WorkspaceDb.Version): WorkspaceDb.DbName {\r\n return `${dbName}:${this.validateVersion(version)}`;\r\n }\r\n\r\n public static resolveCloudFileName(cloudContainer: CloudSqlite.CloudContainer, props: WorkspaceDb.Props): WorkspaceDb.DbFullName {\r\n const dbName = props.dbName;\r\n const dbs = cloudContainer.queryDatabases(`${dbName}`); // get all databases that start with dbName\r\n\r\n const versions = [];\r\n for (const db of dbs) {\r\n const thisDb = ITwinWorkspaceContainer.parseDbFileName(db);\r\n if (thisDb.dbName === dbName && \"string\" === typeof thisDb.version && thisDb.version.length > 0)\r\n versions.push(thisDb.version);\r\n }\r\n\r\n if (versions.length === 0)\r\n versions[0] = \"1.0.0\";\r\n\r\n const range = props.version ?? \"\";\r\n try {\r\n const version = semver.maxSatisfying(versions, range, { loose: true, includePrerelease: props.includePrerelease });\r\n if (version)\r\n return `${dbName}:${version}`;\r\n } catch (e: unknown) {\r\n }\r\n throw new Error(`No version of [${dbName}] available for \"${range}\"`);\r\n }\r\n\r\n /\r\n Create a copy of an existing [[WorkspaceDb]] in a cloud container with a new version number.\r\n * @param cloudContainer The attached cloud container holding the existing WorkspaceDb\r\n * @param fromProps Properties that describe the source WorkspaceDb for the new version\r\n * @param versionType The type of version increment to apply to the existing version.\r\n * @note This requires that the cloudContainer is attached and the write lock on the container be held. The copy should be modified with\r\n * new content before the write lock is released, and thereafter should never be modified again.\r\n /\r\n public static async makeNewVersion(cloudContainer: CloudSqlite.CloudContainer, fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement) {\r\n const oldName = this.resolveCloudFileName(cloudContainer, fromProps);\r\n const oldDb = this.parseDbFileName(oldName);\r\n const newVersion = semver.inc(oldDb.version, versionType);\r\n if (!newVersion)\r\n throw new Error(\"invalid version\");\r\n\r\n const newName = this.makeDbFileName(oldDb.dbName, newVersion);\r\n await cloudContainer.copyDatabase(oldName, newName);\r\n return { oldName, newName };\r\n }\r\n\r\n /\r\n Convert a WorkspaceDb.Props specification into a DbFileName. For cloud-based containers, this resolves to the dbName, incorporating the appropriate\r\n * version. For file-based containers, this returns a local filename of a WorkspaceDb file with the extension \".itwin-workspace\"\r\n /\r\n public resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName {\r\n const cloudContainer = this.cloudContainer;\r\n if (undefined === cloudContainer)\r\n return join(this.dirName, `${props.dbName}.${ITwinWorkspaceDb.fileExt}`); // local file, versions not allowed\r\n\r\n return ITwinWorkspaceContainer.resolveCloudFileName(cloudContainer, props);\r\n }\r\n\r\n public addWorkspaceDb(toAdd: ITwinWorkspaceDb) {\r\n if (undefined !== this._wsDbs.get(toAdd.dbName))\r\n throw new Error(`workspaceDb ${toAdd.dbName} already exists in workspace`);\r\n this._wsDbs.set(toAdd.dbName, toAdd);\r\n }\r\n\r\n public getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb {\r\n const db = this._wsDbs.get(props.dbName) ?? new ITwinWorkspaceDb(props, this);\r\n if (!db.isOpen)\r\n db.open();\r\n return db;\r\n }\r\n\r\n public dropWorkspaceDb(toDrop: WorkspaceDb) {\r\n const name = toDrop.dbName;\r\n const wsDb = this._wsDbs.get(name);\r\n if (wsDb === toDrop) {\r\n this._wsDbs.delete(name);\r\n wsDb.close();\r\n }\r\n }\r\n\r\n public close() {\r\n for (const [_name, db] of this._wsDbs)\r\n db.close();\r\n this._wsDbs.clear();\r\n this.cloudContainer?.disconnect();\r\n }\r\n\r\n /* Delete all local files extracted by [[WorkspaceDb.getFile]] for this container. /\r\n public purgeContainerFiles() {\r\n IModelJsFs.purgeDirSync(this.filesDir);\r\n }\r\n}\r\n\r\n/\r\n Implementation of WorkspaceDb\r\n * @internal\r\n /\r\nexport class ITwinWorkspaceDb implements WorkspaceDb {\r\n /* file extension for local WorkspaceDbs /\r\n public static readonly fileExt = \"itwin-workspace\";\r\n /* the SQLiteDb for this WorkspaceDb/\r\n public readonly sqliteDb = new SQLiteDb();\r\n /* the base WorkspaceDb name, without directory, extension, or version information. /\r\n public readonly dbName: WorkspaceDb.DbName;\r\n /* The WorkspaceContainer holding this WorkspaceDb /\r\n public readonly container: WorkspaceContainer;\r\n /* called before db is closed /\r\n public readonly onClose = new BeEvent<() => void>();\r\n /* either a local file name or the name of the file in a cloud container, including version identifier /\r\n public dbFileName: string;\r\n\r\n /* true if this WorkspaceDb is currently open /\r\n public get isOpen() { return this.sqliteDb.isOpen; }\r\n public queryFileResource(rscName: WorkspaceResource.Name) {\r\n const info = this.sqliteDb.nativeDb.queryEmbeddedFile(rscName);\r\n if (undefined === info)\r\n return undefined;\r\n\r\n // since resource names can contain illegal characters, path separators, etc., we make the local file name from its hash, in hex.\r\n let localFileName = join(this.container.filesDir, createHash(\"sha1\").update(this.dbFileName).update(rscName).digest(\"hex\"));\r\n if (info.fileExt !== \"\") // since some applications may expect to see the extension, append it here if it was supplied.\r\n localFileName = `${localFileName}.${info.fileExt}`;\r\n return { localFileName, info };\r\n }\r\n\r\n public constructor(props: WorkspaceDb.Props, container: WorkspaceContainer) {\r\n ITwinWorkspaceContainer.validateDbName(props.dbName);\r\n this.dbName = props.dbName;\r\n this.container = container;\r\n this.dbFileName = container.resolveDbFileName(props);\r\n container.addWorkspaceDb(this);\r\n }\r\n\r\n public open() {\r\n this.sqliteDb.openDb(this.dbFileName, OpenMode.Readonly, this.container.cloudContainer);\r\n }\r\n\r\n public close() {\r\n if (this.isOpen) {\r\n this.onClose.raiseEvent();\r\n this.sqliteDb.closeDb();\r\n this.container.dropWorkspaceDb(this);\r\n }\r\n }\r\n\r\n public getString(rscName: WorkspaceResource.Name): string \| undefined {\r\n return this.sqliteDb.withSqliteStatement(\"SELECT value from strings WHERE id=?\", (stmt) => {\r\n stmt.bindString(1, rscName);\r\n return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueString(0) : undefined;\r\n });\r\n }\r\n\r\n /* Get a BlobIO reader for a blob WorkspaceResource.\r\n * @note when finished, caller must call `close` on the BlobIO.\r\n /\r\n public getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO {\r\n return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\r\n stmt.bindString(1, rscName);\r\n const blobReader = SQLiteDb.createBlobIO();\r\n blobReader.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0) });\r\n return blobReader;\r\n });\r\n }\r\n\r\n public getBlob(rscName: WorkspaceResource.Name): Uint8Array \| undefined {\r\n return this.sqliteDb.withSqliteStatement(\"SELECT value from blobs WHERE id=?\", (stmt) => {\r\n stmt.bindString(1, rscName);\r\n return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueBlob(0) : undefined;\r\n });\r\n }\r\n\r\n public getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName \| undefined {\r\n const file = this.queryFileResource(rscName);\r\n if (!file)\r\n return undefined;\r\n\r\n const info = file.info;\r\n const localFileName = targetFileName ?? file.localFileName;\r\n\r\n // check whether the file is already up to date.\r\n const stat = fs.existsSync(localFileName) && fs.statSync(localFileName);\r\n if (stat && Math.round(stat.mtimeMs) === info.date && stat.size === info.size)\r\n return localFileName; // yes, we're done\r\n\r\n // extractEmbeddedFile fails if the file exists or if the directory does not exist\r\n if (stat)\r\n fs.removeSync(localFileName);\r\n else\r\n IModelJsFs.recursiveMkDirSync(dirname(localFileName));\r\n\r\n this.sqliteDb.nativeDb.extractEmbeddedFile({ name: rscName, localFileName });\r\n const date = new Date(info.date);\r\n fs.utimesSync(localFileName, date, date); // set the last-modified date of the file to match date in container\r\n fs.chmodSync(localFileName, \"0444\"); // set file readonly\r\n return localFileName;\r\n }\r\n\r\n public prefetch(opts?: CloudSqlite.PrefetchProps): CloudSqlite.CloudPrefetch {\r\n const cloudContainer = this.container.cloudContainer;\r\n if (cloudContainer === undefined)\r\n throw new Error(\"no cloud container to prefetch\");\r\n return CloudSqlite.startCloudPrefetch(cloudContainer, this.dbFileName, opts);\r\n }\r\n}\r\n\r\n/\r\n An editable [[WorkspaceDb]]. This is used by administrators for creating and modifying `WorkspaceDb`s.\r\n * For cloud-backed containers, the write token must be obtained before this class may be used. Only one user at at time\r\n * may be editing.\r\n * @internal\r\n /\r\nexport class EditableWorkspaceDb extends ITwinWorkspaceDb {\r\n private static validateResourceName(name: WorkspaceResource.Name) {\r\n ITwinWorkspaceContainer.noLeadingOrTrailingSpaces(name, \"resource name\");\r\n if (name.length > 1024)\r\n throw new Error(\"resource name too long\");\r\n }\r\n\r\n private validateResourceSize(val: Uint8Array \| string) {\r\n const len = typeof val === \"string\" ? val.length : val.byteLength;\r\n if (len > (1024 1024 * 1024)) // one gigabyte\r\n throw new Error(\"value is too large\");\r\n }\r\n\r\n public override open() {\r\n this.sqliteDb.openDb(this.dbFileName, OpenMode.ReadWrite, this.container.cloudContainer);\r\n }\r\n\r\n private getFileModifiedTime(localFileName: LocalFileName): number {\r\n return Math.round(fs.statSync(localFileName).mtimeMs);\r\n }\r\n\r\n private performWriteSql(rscName: WorkspaceResource.Name, sql: string, bind?: (stmt: SqliteStatement) => void) {\r\n this.sqliteDb.withSqliteStatement(sql, (stmt) => {\r\n stmt.bindString(1, rscName);\r\n bind?.(stmt);\r\n const rc = stmt.step();\r\n if (DbResult.BE_SQLITE_DONE !== rc) {\r\n if (DbResult.BE_SQLITE_CONSTRAINT_PRIMARYKEY === rc)\r\n throw new IModelError(rc, `resource \"${rscName}\" already exists`);\r\n\r\n throw new IModelError(rc, `workspace [${sql}]`);\r\n }\r\n });\r\n this.sqliteDb.saveChanges();\r\n }\r\n\r\n public async createDb(version?: string) {\r\n if (!this.container.cloudContainer) {\r\n EditableWorkspaceDb.createEmpty(this.dbFileName);\r\n } else {\r\n // currently the only way to create a workspaceDb in a cloud container is to create a temporary workspaceDb and upload it.\r\n const tempDbFile = join(KnownLocations.tmpdir, `empty.${ITwinWorkspaceDb.fileExt}`);\r\n if (fs.existsSync(tempDbFile))\r\n fs.rmSync(tempDbFile);\r\n EditableWorkspaceDb.createEmpty(tempDbFile);\r\n this.dbFileName = ITwinWorkspaceContainer.makeDbFileName(this.dbName, version);\r\n await CloudSqlite.uploadDb(this.container.cloudContainer, { localFileName: tempDbFile, dbName: this.dbFileName });\r\n fs.rmSync(tempDbFile);\r\n }\r\n this.open();\r\n }\r\n\r\n /** Create a new, empty, EditableWorkspaceDb for importing Workspace resources. /\r\n public static createEmpty(fileName: LocalFileName) {\r\n const db = new SQLiteDb();\r\n IModelJsFs.recursiveMkDirSync(dirname(fileName));\r\n db.createDb(fileName);\r\n const timeStampCol = \"lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\";\r\n db.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);\r\n db.executeSQL(`CREATE TABLE blobs(id TEXT PRIMARY KEY NOT NULL,value BLOB,${timeStampCol})`);\r\n const createTrigger = (tableName: string) => {\r\n db.executeSQL(`CREATE TRIGGER ${tableName}_timeStamp AFTER UPDATE ON ${tableName} WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE ${tableName} SET lastMod=julianday('now') WHERE id=new.id; END`);\r\n };\r\n createTrigger(\"strings\");\r\n createTrigger(\"blobs\");\r\n db.closeDb(true);\r\n }\r\n\r\n /* Add a new string resource to this WorkspaceDb.\r\n * @param rscName The name of the string resource.\r\n * @param val The string to save.\r\n /\r\n public addString(rscName: WorkspaceResource.Name, val: string): void {\r\n EditableWorkspaceDb.validateResourceName(rscName);\r\n this.validateResourceSize(val);\r\n this.performWriteSql(rscName, \"INSERT INTO strings(id,value) VALUES(?,?)\", (stmt) => stmt.bindString(2, val));\r\n }\r\n\r\n /* Update an existing string resource with a new value.\r\n * @param rscName The name of the string resource.\r\n * @param val The new value.\r\n * @throws if rscName does not exist\r\n /\r\n public updateString(rscName: WorkspaceResource.Name, val: string): void {\r\n this.validateResourceSize(val);\r\n this.performWriteSql(rscName, \"UPDATE strings SET value=?2 WHERE id=?1\", (stmt) => stmt.bindString(2, val));\r\n }\r\n\r\n /* Remove a string resource. /\r\n public removeString(rscName: WorkspaceResource.Name): void {\r\n this.performWriteSql(rscName, \"DELETE FROM strings WHERE id=?\");\r\n }\r\n\r\n /* Add a new blob resource to this WorkspaceDb.\r\n * @param rscName The name of the blob resource.\r\n * @param val The blob to save.\r\n /\r\n public addBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\r\n EditableWorkspaceDb.validateResourceName(rscName);\r\n this.validateResourceSize(val);\r\n this.performWriteSql(rscName, \"INSERT INTO blobs(id,value) VALUES(?,?)\", (stmt) => stmt.bindBlob(2, val));\r\n }\r\n\r\n /* Update an existing blob resource with a new value.\r\n * @param rscName The name of the blob resource.\r\n * @param val The new value.\r\n * @throws if rscName does not exist\r\n /\r\n public updateBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\r\n this.validateResourceSize(val);\r\n this.performWriteSql(rscName, \"UPDATE blobs SET value=?2 WHERE id=?1\", (stmt) => stmt.bindBlob(2, val));\r\n }\r\n\r\n /* Get a BlobIO writer for a previously-added blob WorkspaceResource.\r\n * @note after writing is complete, caller must call `close` on the BlobIO and must call `saveChanges` on the `db`.\r\n /\r\n public getBlobWriter(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO {\r\n return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\r\n stmt.bindString(1, rscName);\r\n const blobWriter = SQLiteDb.createBlobIO();\r\n blobWriter.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0), writeable: true });\r\n return blobWriter;\r\n });\r\n }\r\n\r\n /* Remove a blob resource. /\r\n public removeBlob(rscName: WorkspaceResource.Name): void {\r\n this.performWriteSql(rscName, \"DELETE FROM blobs WHERE id=?\");\r\n }\r\n\r\n /* Copy the contents of an existing local file into this WorkspaceDb as a file resource.\r\n * @param rscName The name of the file resource.\r\n * @param localFileName The name of a local file to be read.\r\n * @param fileExt The extension (do not include the leading \".\") to be appended to the generated fileName\r\n * when this WorkspaceDb is extracted from the WorkspaceDb. By default the characters after the last \".\" in `localFileName`\r\n * are used. Pass this argument to override that.\r\n /\r\n public addFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName, fileExt?: string): void {\r\n EditableWorkspaceDb.validateResourceName(rscName);\r\n fileExt = fileExt ?? extname(localFileName);\r\n if (fileExt?.[0] === \".\")\r\n fileExt = fileExt.slice(1);\r\n this.sqliteDb.nativeDb.embedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName), fileExt });\r\n }\r\n\r\n /* Replace an existing file resource with the contents of another local file.\r\n * @param rscName The name of the file resource.\r\n * @param localFileName The name of a local file to be read.\r\n * @throws if rscName does not exist\r\n /\r\n public updateFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName): void {\r\n this.queryFileResource(rscName); // throws if not present\r\n this.sqliteDb.nativeDb.replaceEmbeddedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName) });\r\n }\r\n\r\n /* Remove a file resource. */\r\n public removeFile(rscName: WorkspaceResource.Name): void {\r\n const file = this.queryFileResource(rscName);\r\n if (undefined === file)\r\n throw new Error(`file resource \"${rscName}\" does not exist`);\r\n if (file && fs.existsSync(file.localFileName))\r\n fs.unlinkSync(file.localFileName);\r\n this.sqliteDb.nativeDb.removeEmbeddedFile(rscName);\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"Workspace.js","sourceRoot":"","sources":["../../../src/workspace/Workspace.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 { createHash } from \"crypto\";\r\nimport as fs from \"fs-extra\";\r\nimport { dirname, extname, join } from \"path\";\r\nimport * as semver from \"semver\";\r\nimport { AccessToken, BeEvent, DbResult, OpenMode, Optional } from \"@itwin/core-bentley\";\r\nimport { IModelError, LocalDirName, LocalFileName } from \"@itwin/core-common\";\r\nimport { CloudSqlite } from \"../CloudSqlite\";\r\nimport { IModelHost, KnownLocations } from \"../IModelHost\";\r\nimport { IModelJsFs } from \"../IModelJsFs\";\r\nimport { SQLiteDb } from \"../SQLiteDb\";\r\nimport { SqliteStatement } from \"../SqliteStatement\";\r\nimport { Settings, SettingsPriority } from \"./Settings\";\r\nimport { SettingsSchemas } from \"./SettingsSchemas\";\r\n\r\n/* eslint-disable @typescript-eslint/naming-convention /\r\n// cspell:ignore rowid primarykey julianday\r\n\r\n/* The Settings used by Workspace api\r\n * @beta\r\n /\r\nexport const WorkspaceSetting = {\r\n Accounts: \"cloud/accounts\",\r\n Containers: \"cloud/containers\",\r\n Databases: \"workspace/databases\",\r\n};\r\n\r\n/* Types used to identify cloud accounts for Workspaces.\r\n * @beta\r\n /\r\nexport namespace WorkspaceAccount {\r\n /* The name of a WorkspaceAccount in a \"cloud/accounts\" setting. /\r\n export type Name = string;\r\n\r\n /* A member named `accountName` that specifies by an entry in a \"cloud/accounts\" setting /\r\n export interface Alias { accountName: string }\r\n\r\n /* The properties of a cloud account required to open containers with CloudSqlite. Usually supplied via a \"cloud/accounts\" setting. /\r\n export type Props = CloudSqlite.AccountAccessProps;\r\n}\r\n\r\n/* @beta /\r\nexport namespace WorkspaceContainer {\r\n /* The name of a WorkspaceContainer in a \"cloud/containers\" setting. /\r\n export type Name = string;\r\n\r\n /* The unique identifier of a WorkspaceContainer. This becomes the base name for the local directory holding the WorkspaceDbs from a WorkspaceContainer.\r\n * Usually supplied via the `containerId` member of a \"cloud/containers\" setting.\r\n * `WorkspaceContainer.Id`s may:\r\n * - only contain lower case letters, numbers or dashes\r\n * - not start or end with a dash\r\n * - not be shorter than 3 or longer than 63 characters\r\n /\r\n export type Id = string;\r\n\r\n /* A member named `containerName` that specifies by an entry in a \"cloud/containers\" setting /\r\n export interface Alias { containerName: string }\r\n\r\n /* Properties that specify a WorkspaceContainer. /\r\n export interface Props extends Optional<CloudSqlite.ContainerProps, \"accessToken\"> {\r\n /* true if the container is public (doesn't require authentication) /\r\n isPublic?: boolean;\r\n /* attempt to synchronize (i.e. call `checkForChanges`) this cloud container whenever it is connected to a cloud cache. Default=true /\r\n syncOnConnect?: boolean;\r\n }\r\n\r\n /* A function to supply an [AccessToken]($bentley) for a `WorkspaceContainer`.\r\n * @param props The properties of the WorkspaceContainer necessary to obtain the access token\r\n * @param account The properties of the account for the container\r\n * @returns a Promise that resolves to the AccessToken for the container.\r\n /\r\n export type TokenFunc = (props: Props, account: WorkspaceAccount.Props) => Promise<AccessToken>;\r\n}\r\n\r\n/* @beta /\r\nexport namespace WorkspaceDb {\r\n /* The name of a WorkspaceDb in a \"workspace/databases\" setting. /\r\n export type Name = string;\r\n\r\n /* The base name of a WorkspaceDb within a WorkspaceContainer (without any version identifier) /\r\n export type DbName = string;\r\n\r\n /* The name of a WorkspaceDb within a WorkspaceContainer, including the version identifier /\r\n export type DbFullName = string;\r\n\r\n /* The semver-format version identifier for a WorkspaceDb. /\r\n export type Version = string;\r\n\r\n /* The [semver range format](https://github.com/npm/node-semver) identifier for a range of acceptable versions. /\r\n export type VersionRange = string;\r\n\r\n /* Properties that specify how to load a WorkspaceDb within a [[WorkspaceContainer]]. /\r\n export interface Props extends CloudSqlite.DbNameProp {\r\n /* a semver version range specifier that determines the acceptable range of versions to load. If not present, use the newest version. /\r\n version?: VersionRange;\r\n /* if true, allow semver prerelease versions. By default only released version are allowed. /\r\n includePrerelease?: boolean;\r\n }\r\n\r\n /* Scope to increment for a version number.\r\n * @see semver.ReleaseType\r\n /\r\n export type VersionIncrement = \"major\" \| \"minor\" \| \"patch\";\r\n}\r\n\r\n/* Types used to identify Workspace resources\r\n * @beta\r\n /\r\nexport namespace WorkspaceResource {\r\n /\r\n The name for identifying WorkspaceResources in a [[WorkspaceDb]].\r\n * * `WorkspaceResource.Name`s may not:\r\n * - be blank or start or end with a space\r\n * - be longer than 1024 characters\r\n * @note a single WorkspaceDb may hold WorkspaceResources of type 'blob', 'string' and 'file', all with the same WorkspaceResource.Name.\r\n /\r\n export type Name = string;\r\n\r\n /* Properties that specify an individual WorkspaceResource within a [[WorkspaceDb]]. /\r\n export interface Props {\r\n /* the name of the resource within the WorkspaceDb /\r\n rscName: Name;\r\n }\r\n}\r\n\r\n/\r\n A WorkspaceDb holds workspace resources. `WorkspaceDb`s may just be local files, or they may be stored\r\n * in cloud WorkspaceContainers. Each `WorkspaceResource` in a WorkspaceDb is identified by a [[WorkspaceResource.Name]].\r\n * Resources of type `string` and `blob` may be loaded directly from the `WorkspaceDb`. Resources of type `file` are\r\n * copied from the WorkspaceDb into a temporary local file so they can be accessed by programs directly from disk.\r\n * @beta\r\n /\r\nexport interface WorkspaceDb {\r\n /* The WorkspaceContainer holding this WorkspaceDb. /\r\n readonly container: WorkspaceContainer;\r\n /* The base name of this WorkspaceDb, without version /\r\n readonly dbName: WorkspaceDb.DbName;\r\n /* event raised before this WorkspaceDb is closed. /\r\n readonly onClose: BeEvent<() => void>;\r\n /* Name by which a WorkspaceDb may be opened. This will be either a local file name or the name of a database in a cloud container /\r\n readonly dbFileName: string;\r\n /* Get a string resource from this WorkspaceDb, if present. /\r\n getString(rscName: WorkspaceResource.Name): string \| undefined;\r\n /* Get a blob resource from this WorkspaceDb, if present. /\r\n getBlob(rscName: WorkspaceResource.Name): Uint8Array \| undefined;\r\n /* @internal /\r\n getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO;\r\n\r\n /\r\n Extract a local copy of a file resource from this WorkspaceDb, if present.\r\n * @param rscName The name of the file resource in the WorkspaceDb\r\n * @param targetFileName optional name for extracted file. Some applications require files in specific locations or filenames. If\r\n * you know the full path to use for the extracted file, you can supply it. Generally, it is best to not supply the filename and\r\n * keep the extracted files in the filesDir.\r\n * @returns the full path to a file on the local filesystem.\r\n * @note The file is copied from the file into the local filesystem so it may be accessed directly. This happens only\r\n * as necessary, if the local file doesn't exist, or if it is out-of-date because it was updated in the file.\r\n * For this reason, you should not save the local file name, and instead call this method every time you access it, so its\r\n * content is always holds the correct version.\r\n * @note The filename will be a hash value, not the resource name.\r\n * @note Workspace resource files are set readonly as they are copied from the file.\r\n * To edit them, you must first copy them to another location.\r\n /\r\n getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName \| undefined;\r\n\r\n /\r\n Ensure that the contents of a `WorkspaceDb` are downloaded into the local cache so that it may be accessed offline.\r\n * Until the promise is resolved, the `WorkspaceDb` is not fully downloaded, but it may be safely accessed during the download.\r\n * To determine the progress of the download, use the `localBlocks` and `totalBlocks` values returned by `CloudContainer.queryDatabase`.\r\n * @returns a `CloudSqlite.CloudPrefetch` object that can be used to await and/or cancel the prefetch.\r\n * @throws if this WorkspaceDb is not from a `CloudContainer`.\r\n /\r\n prefetch(): CloudSqlite.CloudPrefetch;\r\n}\r\n\r\n/* The properties of the CloudCache used for Workspaces.\r\n * @beta\r\n /\r\nexport interface WorkspaceCloudCacheProps extends Optional<CloudSqlite.CacheProps, \"name\" \| \"rootDir\"> {\r\n /* if true, empty the cache before using it. /\r\n clearContents?: boolean;\r\n}\r\n\r\n/\r\n Options for constructing a [[Workspace]].\r\n * @beta\r\n /\r\nexport interface WorkspaceOpts {\r\n /* The local directory for non-cloud-based WorkspaceDb files. The workspace api will look in this directory\r\n * for files named `${containerId}/${dbId}.itwin-workspace`.\r\n * @note if not supplied, defaults to `iTwin/Workspace` in the user-local folder.\r\n /\r\n containerDir?: LocalDirName;\r\n\r\n /* the local fileName(s) of one or more settings files to load after the Workspace is first created. /\r\n settingsFiles?: LocalFileName \| [LocalFileName];\r\n\r\n /\r\n only for tests\r\n * @internal /\r\n testCloudCache?: CloudSqlite.CloudCache;\r\n}\r\n\r\n/\r\n Settings and resources that customize an application for the current session.\r\n * See [Workspaces]($docs/learning/backend/Workspace)\r\n * @beta\r\n /\r\nexport interface Workspace {\r\n /* The directory for local WorkspaceDb files with the name `${containerId}/${dbId}.itwin-workspace`. /\r\n readonly containerDir: LocalDirName;\r\n /* The [[Settings]] for this Workspace /\r\n readonly settings: Settings;\r\n /* The CloudCache for cloud-based WorkspaceContainers /\r\n readonly cloudCache?: CloudSqlite.CloudCache;\r\n\r\n /* search for a previously opened container.\r\n * @param containerId the id of the container\r\n * @returns the [[WorkspaceContainer]] for `containerId` if it was not previously opened with [[getContainer]]\r\n /\r\n findContainer(containerId: WorkspaceContainer.Id): WorkspaceContainer \| undefined;\r\n\r\n /* get a [[WorkspaceContainer]] by [[WorkspaceContainer.Props]]\r\n * @param props the properties of the `WorkspaceContainer`. If `props.containerId` was already opened, its WorkspaceContainer is returned.\r\n * Otherwise it is created.\r\n * @param account If present, the properties for this container if it is to be opened from the cloud. If not present, the container is just a local directory.\r\n /\r\n getContainer(props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceContainer;\r\n\r\n /* get the properties for the supplied account name by searching for an entry with that name in a `cloud/accounts` setting. /\r\n resolveAccount(accountName: WorkspaceAccount.Name): WorkspaceAccount.Props;\r\n\r\n /* get the properties for the supplied container name by searching for an entry with that name in a `cloud/containers` setting. /\r\n resolveContainer(containerName: WorkspaceContainer.Name): WorkspaceContainer.Props & WorkspaceAccount.Alias;\r\n\r\n /* get the properties for the supplied workspace database name by searching for an entry with that name in a `workspace/databases` setting. /\r\n resolveDatabase(databaseAlias: WorkspaceDb.Name): WorkspaceDb.Props & WorkspaceContainer.Alias;\r\n\r\n /\r\n Get an opened [[WorkspaceDb]]. If the WorkspaceDb is present but not open, it is opened first.\r\n * If `cloudProps` are supplied, a CloudContainer will be used to open the WorkspaceDb.\r\n /\r\n getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceDb;\r\n\r\n /* Get an opened [[WorkspaceDb]] from a WorkspaceDb alias.\r\n * @param dbAlias the database alias, resolved via [[resolveDatabase]].\r\n * @param tokenFunc optional function to obtain an AccessToken for the resolved WorkspaceContainer. This function will only be called the first\r\n * time a container is used.\r\n /\r\n getWorkspaceDb(dbAlias: WorkspaceDb.Name, tokenFunc?: WorkspaceContainer.TokenFunc): Promise<WorkspaceDb>;\r\n\r\n /* Load a WorkspaceResource of type string, parse it, and add it to the current Settings for this Workspace.\r\n * @note settingsRsc must specify a resource holding a stringified JSON representation of a [[SettingDictionary]]\r\n /\r\n loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority): void;\r\n\r\n /* Close this Workspace. All WorkspaceContainers are dropped. /\r\n close(): void;\r\n}\r\n\r\n/\r\n A WorkspaceContainer holds WorkspaceDbs.\r\n * Access rights are administered per WorkspaceContainer. That is, if a user has rights to access a WorkspaceContainer, that right\r\n * applies to all WorkspaceDbs in the WorkspaceContainer.\r\n * @beta\r\n /\r\nexport interface WorkspaceContainer {\r\n /* the local directory where this WorkspaceContainer will store temporary files extracted for file-resources. /\r\n readonly filesDir: LocalDirName;\r\n /* The unique identifier for a WorkspaceContainer a cloud storage account. /\r\n readonly id: WorkspaceContainer.Id;\r\n /* Workspace holding this WorkspaceContainer. /\r\n readonly workspace: Workspace;\r\n /* CloudContainer for this WorkspaceContainer (`undefined` if this is a local WorkspaceContainer.)\r\n * @internal\r\n /\r\n readonly cloudContainer?: CloudSqlite.CloudContainer;\r\n\r\n /* @internal /\r\n addWorkspaceDb(toAdd: ITwinWorkspaceDb): void;\r\n /* @internal /\r\n resolveDbFileName(props: WorkspaceDb.Props): string;\r\n\r\n /* find or open a WorkspaceDb from this WorkspaceContainer. /\r\n getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb;\r\n /* Close and remove a currently opened [[WorkspaceDb]] from this Workspace. /\r\n dropWorkspaceDb(container: WorkspaceDb): void;\r\n /* Close this WorkspaceContainer. All currently opened WorkspaceDbs are dropped. /\r\n close(): void;\r\n}\r\n\r\n/* @internal /\r\nexport class ITwinWorkspace implements Workspace {\r\n private _containers = new Map<WorkspaceContainer.Id, ITwinWorkspaceContainer>();\r\n public readonly containerDir: LocalDirName;\r\n public readonly settings: Settings;\r\n private static _sharedCloudCache?: CloudSqlite.CloudCache;\r\n private _cloudCache?: CloudSqlite.CloudCache;\r\n public get cloudCache(): CloudSqlite.CloudCache {\r\n if (undefined === this._cloudCache)\r\n this._cloudCache = ITwinWorkspace.getSharedCloudCache();\r\n return this._cloudCache;\r\n }\r\n private static getSharedCloudCache(): CloudSqlite.CloudCache {\r\n if (undefined === this._sharedCloudCache) {\r\n const rootDir = join(IModelHost.cacheDir, \"Workspace\", \"cloud\");\r\n IModelJsFs.recursiveMkDirSync(rootDir);\r\n this._sharedCloudCache = CloudSqlite.createCloudCache({ rootDir, cacheSize: \"20G\", name: \"workspace\" });\r\n }\r\n return this._sharedCloudCache;\r\n }\r\n public static finalize() {\r\n if (this._sharedCloudCache) {\r\n this._sharedCloudCache.destroy();\r\n this._sharedCloudCache = undefined;\r\n }\r\n }\r\n\r\n public constructor(settings: Settings, opts?: WorkspaceOpts) {\r\n this.settings = settings;\r\n this.containerDir = opts?.containerDir ?? join(IModelHost.cacheDir, \"Workspace\");\r\n this._cloudCache = opts?.testCloudCache;\r\n let settingsFiles = opts?.settingsFiles;\r\n if (settingsFiles) {\r\n if (typeof settingsFiles === \"string\")\r\n settingsFiles = [settingsFiles];\r\n settingsFiles.forEach((file) => settings.addFile(file, SettingsPriority.application));\r\n }\r\n }\r\n\r\n public addContainer(toAdd: ITwinWorkspaceContainer) {\r\n if (undefined !== this._containers.get(toAdd.id))\r\n throw new Error(\"container already exists in workspace\");\r\n this._containers.set(toAdd.id, toAdd);\r\n }\r\n\r\n public findContainer(containerId: WorkspaceContainer.Id) {\r\n return this._containers.get(containerId);\r\n }\r\n\r\n public getContainer(props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceContainer {\r\n return this.findContainer(props.containerId) ?? new ITwinWorkspaceContainer(this, props, account);\r\n }\r\n\r\n public getWorkspaceDbFromProps(dbProps: WorkspaceDb.Props, containerProps: WorkspaceContainer.Props, account?: WorkspaceAccount.Props): WorkspaceDb {\r\n return this.getContainer(containerProps, account).getWorkspaceDb(dbProps);\r\n }\r\n\r\n public async getWorkspaceDb(dbAlias: string, tokenFunc?: WorkspaceContainer.TokenFunc) {\r\n const dbProps = this.resolveDatabase(dbAlias);\r\n const containerProps = this.resolveContainer(dbProps.containerName);\r\n const account = containerProps.accountName !== \"\" ? this.resolveAccount(containerProps.accountName) : undefined;\r\n let container: WorkspaceContainer \| undefined = this.findContainer(containerProps.containerId);\r\n if (undefined === container) {\r\n if (tokenFunc && account)\r\n containerProps.accessToken = await tokenFunc(containerProps, account);\r\n container = this.getContainer(containerProps, account);\r\n }\r\n return container?.getWorkspaceDb(dbProps);\r\n }\r\n\r\n public loadSettingsDictionary(settingRsc: WorkspaceResource.Name, db: WorkspaceDb, priority: SettingsPriority) {\r\n const setting = db.getString(settingRsc);\r\n if (undefined === setting)\r\n throw new Error(`could not load setting resource ${settingRsc}`);\r\n\r\n this.settings.addJson(`${db.container.id}/${db.dbName}/${settingRsc}`, priority, setting);\r\n }\r\n\r\n public close() {\r\n this.settings.close();\r\n for (const [_id, container] of this._containers)\r\n container.close();\r\n this._containers.clear();\r\n }\r\n\r\n public resolveAccount(accountName: string): WorkspaceAccount.Props {\r\n const resolved = this.settings.resolveSetting<WorkspaceAccount.Props>(WorkspaceSetting.Accounts, (val) => {\r\n if (Array.isArray(val)) {\r\n for (const entry of val) {\r\n if (typeof entry === \"object\" && entry.name === accountName)\r\n return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Accounts, accountName);\r\n }\r\n }\r\n return undefined; // keep going through all settings dictionaries\r\n });\r\n if (resolved === undefined)\r\n throw new Error(`no setting \"${WorkspaceSetting.Accounts}\" entry for \"${accountName}\"`);\r\n\r\n return resolved;\r\n }\r\n\r\n public resolveContainer(containerName: string): WorkspaceContainer.Props & WorkspaceAccount.Alias {\r\n const resolved = this.settings.resolveSetting<WorkspaceContainer.Props & WorkspaceAccount.Alias>(WorkspaceSetting.Containers, (val) => {\r\n if (Array.isArray(val)) {\r\n for (const entry of val) {\r\n if (typeof entry === \"object\" && entry.name === containerName)\r\n return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Containers, containerName);\r\n }\r\n }\r\n return undefined; // keep going through all settings dictionaries\r\n });\r\n if (resolved === undefined)\r\n throw new Error(`no setting \"${WorkspaceSetting.Containers}\" entry for \"${containerName}\"`);\r\n\r\n return resolved;\r\n }\r\n\r\n public resolveDatabase(databaseName: string): WorkspaceDb.Props & WorkspaceContainer.Alias {\r\n const resolved = this.settings.resolveSetting<WorkspaceDb.Props & WorkspaceContainer.Alias>(WorkspaceSetting.Databases, (val) => {\r\n if (Array.isArray(val)) {\r\n for (const entry of val) {\r\n if (typeof entry === \"object\" && entry.name === databaseName)\r\n return SettingsSchemas.validateArrayObject(entry, WorkspaceSetting.Databases, databaseName);\r\n }\r\n }\r\n return undefined; // keep going through all settings dictionaries\r\n });\r\n\r\n if (resolved === undefined)\r\n throw new Error(`no setting \"${WorkspaceSetting.Databases}\" entry for \"${databaseName}\"`);\r\n\r\n return resolved;\r\n }\r\n}\r\n\r\n/* @internal /\r\nexport class ITwinWorkspaceContainer implements WorkspaceContainer {\r\n public readonly workspace: ITwinWorkspace;\r\n public readonly filesDir: LocalDirName;\r\n public readonly id: WorkspaceContainer.Id;\r\n\r\n public readonly cloudContainer?: CloudSqlite.CloudContainer \| undefined;\r\n private _wsDbs = new Map<WorkspaceDb.DbName, ITwinWorkspaceDb>();\r\n public get dirName() { return join(this.workspace.containerDir, this.id); }\r\n\r\n public static noLeadingOrTrailingSpaces(name: string, msg: string) {\r\n if (name.trim() !== name)\r\n throw new Error(`${msg} [${name}] may not have leading or tailing spaces`);\r\n }\r\n\r\n /* rules for ContainerIds (from Azure, see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata)\r\n * - may only contain lower case letters, numbers or dashes\r\n * - may not start or end with with a dash nor have more than one dash in a row\r\n * - may not be shorter than 3 or longer than 63 characters\r\n /\r\n private static validateContainerId(id: WorkspaceContainer.Id) {\r\n if (!/^(?=.{3,63}$)[a-z0-9]+(-[a-z0-9]+)$/g.test(id))\r\n throw new Error(`invalid containerId: [${id}]`);\r\n }\r\n\r\n public static validateDbName(dbName: WorkspaceDb.DbName) {\r\n if (dbName === \"\" \|\| dbName.length > 255 \|\| /[#\\.<>:\"/\\\\\"`'\|?\\u0000-\\u001F]/g.test(dbName) \|\| /^(con\|prn\|aux\|nul\|com\\d\|lpt\\d)$/i.test(dbName))\r\n throw new Error(`invalid dbName: [${dbName}]`);\r\n this.noLeadingOrTrailingSpaces(dbName, \"dbName\");\r\n }\r\n\r\n public constructor(workspace: ITwinWorkspace, props: WorkspaceContainer.Props, account?: WorkspaceAccount.Props) {\r\n ITwinWorkspaceContainer.validateContainerId(props.containerId);\r\n this.workspace = workspace;\r\n this.id = props.containerId;\r\n\r\n if (account?.accessName && account.storageType)\r\n this.cloudContainer = CloudSqlite.createCloudContainer({ accessToken: \"\", ...props, ...account });\r\n\r\n workspace.addContainer(this);\r\n this.filesDir = join(this.dirName, \"Files\");\r\n\r\n const cloudContainer = this.cloudContainer;\r\n if (undefined === cloudContainer)\r\n return;\r\n\r\n cloudContainer.connect(this.workspace.cloudCache);\r\n if (false !== props.syncOnConnect) {\r\n try {\r\n cloudContainer.checkForChanges();\r\n } catch (e: unknown) {\r\n // must be offline\r\n }\r\n }\r\n }\r\n\r\n public static validateVersion(version?: WorkspaceDb.Version) {\r\n version = version ?? \"1.0.0\";\r\n if (version) {\r\n const opts = { loose: true, includePrerelease: true };\r\n // clean allows prerelease, so try it first. If that fails attempt to coerce it (coerce strips prerelease even if you say not to.)\r\n const semVersion = semver.clean(version, opts) ?? semver.coerce(version, opts)?.version;\r\n if (!semVersion)\r\n throw new Error(\"invalid version specification\");\r\n version = semVersion;\r\n }\r\n return version;\r\n }\r\n\r\n public static parseDbFileName(dbFileName: WorkspaceDb.DbFullName): { dbName: WorkspaceDb.DbName, version: WorkspaceDb.Version } {\r\n const parts = dbFileName.split(\":\");\r\n return { dbName: parts[0], version: parts[1] };\r\n }\r\n\r\n public static makeDbFileName(dbName: WorkspaceDb.DbName, version?: WorkspaceDb.Version): WorkspaceDb.DbName {\r\n return `${dbName}:${this.validateVersion(version)}`;\r\n }\r\n\r\n public static resolveCloudFileName(cloudContainer: CloudSqlite.CloudContainer, props: WorkspaceDb.Props): WorkspaceDb.DbFullName {\r\n const dbName = props.dbName;\r\n const dbs = cloudContainer.queryDatabases(`${dbName}`); // get all databases that start with dbName\r\n\r\n const versions = [];\r\n for (const db of dbs) {\r\n const thisDb = ITwinWorkspaceContainer.parseDbFileName(db);\r\n if (thisDb.dbName === dbName && \"string\" === typeof thisDb.version && thisDb.version.length > 0)\r\n versions.push(thisDb.version);\r\n }\r\n\r\n if (versions.length === 0)\r\n versions[0] = \"1.0.0\";\r\n\r\n const range = props.version ?? \"\";\r\n try {\r\n const version = semver.maxSatisfying(versions, range, { loose: true, includePrerelease: props.includePrerelease });\r\n if (version)\r\n return `${dbName}:${version}`;\r\n } catch (e: unknown) {\r\n }\r\n throw new Error(`No version of [${dbName}] available for \"${range}\"`);\r\n }\r\n\r\n /\r\n Create a copy of an existing [[WorkspaceDb]] in a cloud container with a new version number.\r\n * @param cloudContainer The attached cloud container holding the existing WorkspaceDb\r\n * @param fromProps Properties that describe the source WorkspaceDb for the new version\r\n * @param versionType The type of version increment to apply to the existing version.\r\n * @note This requires that the cloudContainer is attached and the write lock on the container be held. The copy should be modified with\r\n * new content before the write lock is released, and thereafter should never be modified again.\r\n /\r\n public static async makeNewVersion(cloudContainer: CloudSqlite.CloudContainer, fromProps: WorkspaceDb.Props, versionType: WorkspaceDb.VersionIncrement) {\r\n const oldName = this.resolveCloudFileName(cloudContainer, fromProps);\r\n const oldDb = this.parseDbFileName(oldName);\r\n const newVersion = semver.inc(oldDb.version, versionType);\r\n if (!newVersion)\r\n throw new Error(\"invalid version\");\r\n\r\n const newName = this.makeDbFileName(oldDb.dbName, newVersion);\r\n await cloudContainer.copyDatabase(oldName, newName);\r\n return { oldName, newName };\r\n }\r\n\r\n /\r\n Convert a WorkspaceDb.Props specification into a DbFileName. For cloud-based containers, this resolves to the dbName, incorporating the appropriate\r\n * version. For file-based containers, this returns a local filename of a WorkspaceDb file with the extension \".itwin-workspace\"\r\n /\r\n public resolveDbFileName(props: WorkspaceDb.Props): WorkspaceDb.DbFullName {\r\n const cloudContainer = this.cloudContainer;\r\n if (undefined === cloudContainer)\r\n return join(this.dirName, `${props.dbName}.${ITwinWorkspaceDb.fileExt}`); // local file, versions not allowed\r\n\r\n return ITwinWorkspaceContainer.resolveCloudFileName(cloudContainer, props);\r\n }\r\n\r\n public addWorkspaceDb(toAdd: ITwinWorkspaceDb) {\r\n if (undefined !== this._wsDbs.get(toAdd.dbName))\r\n throw new Error(`workspaceDb ${toAdd.dbName} already exists in workspace`);\r\n this._wsDbs.set(toAdd.dbName, toAdd);\r\n }\r\n\r\n public getWorkspaceDb(props: WorkspaceDb.Props): WorkspaceDb {\r\n const db = this._wsDbs.get(props.dbName) ?? new ITwinWorkspaceDb(props, this);\r\n if (!db.isOpen)\r\n db.open();\r\n return db;\r\n }\r\n\r\n public dropWorkspaceDb(toDrop: WorkspaceDb) {\r\n const name = toDrop.dbName;\r\n const wsDb = this._wsDbs.get(name);\r\n if (wsDb === toDrop) {\r\n this._wsDbs.delete(name);\r\n wsDb.close();\r\n }\r\n }\r\n\r\n public close() {\r\n for (const [_name, db] of this._wsDbs)\r\n db.close();\r\n this._wsDbs.clear();\r\n this.cloudContainer?.disconnect();\r\n }\r\n\r\n /* Delete all local files extracted by [[WorkspaceDb.getFile]] for this container. /\r\n public purgeContainerFiles() {\r\n IModelJsFs.purgeDirSync(this.filesDir);\r\n }\r\n}\r\n\r\n/\r\n Implementation of WorkspaceDb\r\n * @internal\r\n /\r\nexport class ITwinWorkspaceDb implements WorkspaceDb {\r\n /* file extension for local WorkspaceDbs /\r\n public static readonly fileExt = \"itwin-workspace\";\r\n /* the SQLiteDb for this WorkspaceDb/\r\n public readonly sqliteDb = new SQLiteDb();\r\n /* the base WorkspaceDb name, without directory, extension, or version information. /\r\n public readonly dbName: WorkspaceDb.DbName;\r\n /* The WorkspaceContainer holding this WorkspaceDb /\r\n public readonly container: WorkspaceContainer;\r\n /* called before db is closed /\r\n public readonly onClose = new BeEvent<() => void>();\r\n /* either a local file name or the name of the file in a cloud container, including version identifier /\r\n public dbFileName: string;\r\n\r\n /* true if this WorkspaceDb is currently open /\r\n public get isOpen() { return this.sqliteDb.isOpen; }\r\n public queryFileResource(rscName: WorkspaceResource.Name) {\r\n const info = this.sqliteDb.nativeDb.queryEmbeddedFile(rscName);\r\n if (undefined === info)\r\n return undefined;\r\n\r\n // since resource names can contain illegal characters, path separators, etc., we make the local file name from its hash, in hex.\r\n let localFileName = join(this.container.filesDir, createHash(\"sha1\").update(this.dbFileName).update(rscName).digest(\"hex\"));\r\n if (info.fileExt !== \"\") // since some applications may expect to see the extension, append it here if it was supplied.\r\n localFileName = `${localFileName}.${info.fileExt}`;\r\n return { localFileName, info };\r\n }\r\n\r\n public constructor(props: WorkspaceDb.Props, container: WorkspaceContainer) {\r\n ITwinWorkspaceContainer.validateDbName(props.dbName);\r\n this.dbName = props.dbName;\r\n this.container = container;\r\n this.dbFileName = container.resolveDbFileName(props);\r\n container.addWorkspaceDb(this);\r\n }\r\n\r\n public open() {\r\n this.sqliteDb.openDb(this.dbFileName, OpenMode.Readonly, this.container.cloudContainer);\r\n }\r\n\r\n public close() {\r\n if (this.isOpen) {\r\n this.onClose.raiseEvent();\r\n this.sqliteDb.closeDb();\r\n this.container.dropWorkspaceDb(this);\r\n }\r\n }\r\n\r\n public getString(rscName: WorkspaceResource.Name): string \| undefined {\r\n return this.sqliteDb.withSqliteStatement(\"SELECT value from strings WHERE id=?\", (stmt) => {\r\n stmt.bindString(1, rscName);\r\n return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueString(0) : undefined;\r\n });\r\n }\r\n\r\n /* Get a BlobIO reader for a blob WorkspaceResource.\r\n * @note when finished, caller must call `close` on the BlobIO.\r\n /\r\n public getBlobReader(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO {\r\n return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\r\n stmt.bindString(1, rscName);\r\n const blobReader = SQLiteDb.createBlobIO();\r\n blobReader.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0) });\r\n return blobReader;\r\n });\r\n }\r\n\r\n public getBlob(rscName: WorkspaceResource.Name): Uint8Array \| undefined {\r\n return this.sqliteDb.withSqliteStatement(\"SELECT value from blobs WHERE id=?\", (stmt) => {\r\n stmt.bindString(1, rscName);\r\n return DbResult.BE_SQLITE_ROW === stmt.step() ? stmt.getValueBlob(0) : undefined;\r\n });\r\n }\r\n\r\n public getFile(rscName: WorkspaceResource.Name, targetFileName?: LocalFileName): LocalFileName \| undefined {\r\n const file = this.queryFileResource(rscName);\r\n if (!file)\r\n return undefined;\r\n\r\n const info = file.info;\r\n const localFileName = targetFileName ?? file.localFileName;\r\n\r\n // check whether the file is already up to date.\r\n const stat = fs.existsSync(localFileName) && fs.statSync(localFileName);\r\n if (stat && Math.round(stat.mtimeMs) === info.date && stat.size === info.size)\r\n return localFileName; // yes, we're done\r\n\r\n // extractEmbeddedFile fails if the file exists or if the directory does not exist\r\n if (stat)\r\n fs.removeSync(localFileName);\r\n else\r\n IModelJsFs.recursiveMkDirSync(dirname(localFileName));\r\n\r\n this.sqliteDb.nativeDb.extractEmbeddedFile({ name: rscName, localFileName });\r\n const date = new Date(info.date);\r\n fs.utimesSync(localFileName, date, date); // set the last-modified date of the file to match date in container\r\n fs.chmodSync(localFileName, \"0444\"); // set file readonly\r\n return localFileName;\r\n }\r\n\r\n public prefetch(opts?: CloudSqlite.PrefetchProps): CloudSqlite.CloudPrefetch {\r\n const cloudContainer = this.container.cloudContainer;\r\n if (cloudContainer === undefined)\r\n throw new Error(\"no cloud container to prefetch\");\r\n return CloudSqlite.startCloudPrefetch(cloudContainer, this.dbFileName, opts);\r\n }\r\n}\r\n\r\n/\r\n An editable [[WorkspaceDb]]. This is used by administrators for creating and modifying `WorkspaceDb`s.\r\n * For cloud-backed containers, the write token must be obtained before this class may be used. Only one user at at time\r\n * may be editing.\r\n * @internal\r\n /\r\nexport class EditableWorkspaceDb extends ITwinWorkspaceDb {\r\n private static validateResourceName(name: WorkspaceResource.Name) {\r\n ITwinWorkspaceContainer.noLeadingOrTrailingSpaces(name, \"resource name\");\r\n if (name.length > 1024)\r\n throw new Error(\"resource name too long\");\r\n }\r\n\r\n private validateResourceSize(val: Uint8Array \| string) {\r\n const len = typeof val === \"string\" ? val.length : val.byteLength;\r\n if (len > (1024 1024 * 1024)) // one gigabyte\r\n throw new Error(\"value is too large\");\r\n }\r\n\r\n public override open() {\r\n this.sqliteDb.openDb(this.dbFileName, OpenMode.ReadWrite, this.container.cloudContainer);\r\n }\r\n\r\n private getFileModifiedTime(localFileName: LocalFileName): number {\r\n return Math.round(fs.statSync(localFileName).mtimeMs);\r\n }\r\n\r\n private performWriteSql(rscName: WorkspaceResource.Name, sql: string, bind?: (stmt: SqliteStatement) => void) {\r\n this.sqliteDb.withSqliteStatement(sql, (stmt) => {\r\n stmt.bindString(1, rscName);\r\n bind?.(stmt);\r\n const rc = stmt.step();\r\n if (DbResult.BE_SQLITE_DONE !== rc) {\r\n if (DbResult.BE_SQLITE_CONSTRAINT_PRIMARYKEY === rc)\r\n throw new IModelError(rc, `resource \"${rscName}\" already exists`);\r\n\r\n throw new IModelError(rc, `workspace [${sql}]`);\r\n }\r\n });\r\n this.sqliteDb.saveChanges();\r\n }\r\n\r\n public async createDb(version?: string) {\r\n if (!this.container.cloudContainer) {\r\n EditableWorkspaceDb.createEmpty(this.dbFileName);\r\n } else {\r\n // currently the only way to create a workspaceDb in a cloud container is to create a temporary workspaceDb and upload it.\r\n const tempDbFile = join(KnownLocations.tmpdir, `empty.${ITwinWorkspaceDb.fileExt}`);\r\n if (fs.existsSync(tempDbFile))\r\n IModelJsFs.removeSync(tempDbFile);\r\n EditableWorkspaceDb.createEmpty(tempDbFile);\r\n this.dbFileName = ITwinWorkspaceContainer.makeDbFileName(this.dbName, version);\r\n await CloudSqlite.uploadDb(this.container.cloudContainer, { localFileName: tempDbFile, dbName: this.dbFileName });\r\n IModelJsFs.removeSync(tempDbFile);\r\n }\r\n this.open();\r\n }\r\n\r\n /** Create a new, empty, EditableWorkspaceDb for importing Workspace resources. /\r\n public static createEmpty(fileName: LocalFileName) {\r\n const db = new SQLiteDb();\r\n IModelJsFs.recursiveMkDirSync(dirname(fileName));\r\n db.createDb(fileName);\r\n const timeStampCol = \"lastMod TIMESTAMP NOT NULL DEFAULT(julianday('now'))\";\r\n db.executeSQL(`CREATE TABLE strings(id TEXT PRIMARY KEY NOT NULL,value TEXT,${timeStampCol})`);\r\n db.executeSQL(`CREATE TABLE blobs(id TEXT PRIMARY KEY NOT NULL,value BLOB,${timeStampCol})`);\r\n const createTrigger = (tableName: string) => {\r\n db.executeSQL(`CREATE TRIGGER ${tableName}_timeStamp AFTER UPDATE ON ${tableName} WHEN old.lastMod=new.lastMod AND old.lastMod != julianday('now') BEGIN UPDATE ${tableName} SET lastMod=julianday('now') WHERE id=new.id; END`);\r\n };\r\n createTrigger(\"strings\");\r\n createTrigger(\"blobs\");\r\n db.closeDb(true);\r\n }\r\n\r\n /* Add a new string resource to this WorkspaceDb.\r\n * @param rscName The name of the string resource.\r\n * @param val The string to save.\r\n /\r\n public addString(rscName: WorkspaceResource.Name, val: string): void {\r\n EditableWorkspaceDb.validateResourceName(rscName);\r\n this.validateResourceSize(val);\r\n this.performWriteSql(rscName, \"INSERT INTO strings(id,value) VALUES(?,?)\", (stmt) => stmt.bindString(2, val));\r\n }\r\n\r\n /* Update an existing string resource with a new value.\r\n * @param rscName The name of the string resource.\r\n * @param val The new value.\r\n * @throws if rscName does not exist\r\n /\r\n public updateString(rscName: WorkspaceResource.Name, val: string): void {\r\n this.validateResourceSize(val);\r\n this.performWriteSql(rscName, \"UPDATE strings SET value=?2 WHERE id=?1\", (stmt) => stmt.bindString(2, val));\r\n }\r\n\r\n /* Remove a string resource. /\r\n public removeString(rscName: WorkspaceResource.Name): void {\r\n this.performWriteSql(rscName, \"DELETE FROM strings WHERE id=?\");\r\n }\r\n\r\n /* Add a new blob resource to this WorkspaceDb.\r\n * @param rscName The name of the blob resource.\r\n * @param val The blob to save.\r\n /\r\n public addBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\r\n EditableWorkspaceDb.validateResourceName(rscName);\r\n this.validateResourceSize(val);\r\n this.performWriteSql(rscName, \"INSERT INTO blobs(id,value) VALUES(?,?)\", (stmt) => stmt.bindBlob(2, val));\r\n }\r\n\r\n /* Update an existing blob resource with a new value.\r\n * @param rscName The name of the blob resource.\r\n * @param val The new value.\r\n * @throws if rscName does not exist\r\n /\r\n public updateBlob(rscName: WorkspaceResource.Name, val: Uint8Array): void {\r\n this.validateResourceSize(val);\r\n this.performWriteSql(rscName, \"UPDATE blobs SET value=?2 WHERE id=?1\", (stmt) => stmt.bindBlob(2, val));\r\n }\r\n\r\n /* Get a BlobIO writer for a previously-added blob WorkspaceResource.\r\n * @note after writing is complete, caller must call `close` on the BlobIO and must call `saveChanges` on the `db`.\r\n /\r\n public getBlobWriter(rscName: WorkspaceResource.Name): SQLiteDb.BlobIO {\r\n return this.sqliteDb.withSqliteStatement(\"SELECT rowid from blobs WHERE id=?\", (stmt) => {\r\n stmt.bindString(1, rscName);\r\n const blobWriter = SQLiteDb.createBlobIO();\r\n blobWriter.open(this.sqliteDb.nativeDb, { tableName: \"blobs\", columnName: \"value\", row: stmt.getValueInteger(0), writeable: true });\r\n return blobWriter;\r\n });\r\n }\r\n\r\n /* Remove a blob resource. /\r\n public removeBlob(rscName: WorkspaceResource.Name): void {\r\n this.performWriteSql(rscName, \"DELETE FROM blobs WHERE id=?\");\r\n }\r\n\r\n /* Copy the contents of an existing local file into this WorkspaceDb as a file resource.\r\n * @param rscName The name of the file resource.\r\n * @param localFileName The name of a local file to be read.\r\n * @param fileExt The extension (do not include the leading \".\") to be appended to the generated fileName\r\n * when this WorkspaceDb is extracted from the WorkspaceDb. By default the characters after the last \".\" in `localFileName`\r\n * are used. Pass this argument to override that.\r\n /\r\n public addFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName, fileExt?: string): void {\r\n EditableWorkspaceDb.validateResourceName(rscName);\r\n fileExt = fileExt ?? extname(localFileName);\r\n if (fileExt?.[0] === \".\")\r\n fileExt = fileExt.slice(1);\r\n this.sqliteDb.nativeDb.embedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName), fileExt });\r\n }\r\n\r\n /* Replace an existing file resource with the contents of another local file.\r\n * @param rscName The name of the file resource.\r\n * @param localFileName The name of a local file to be read.\r\n * @throws if rscName does not exist\r\n /\r\n public updateFile(rscName: WorkspaceResource.Name, localFileName: LocalFileName): void {\r\n this.queryFileResource(rscName); // throws if not present\r\n this.sqliteDb.nativeDb.replaceEmbeddedFile({ name: rscName, localFileName, date: this.getFileModifiedTime(localFileName) });\r\n }\r\n\r\n /* Remove a file resource. */\r\n public removeFile(rscName: WorkspaceResource.Name): void {\r\n const file = this.queryFileResource(rscName);\r\n if (undefined === file)\r\n throw new Error(`file resource \"${rscName}\" does not exist`);\r\n if (file && fs.existsSync(file.localFileName))\r\n fs.unlinkSync(file.localFileName);\r\n this.sqliteDb.nativeDb.removeEmbeddedFile(rscName);\r\n }\r\n}\r\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/core-backend",
-  "version": "3.6.0-dev.62",
+  "version": "3.6.0-dev.66",
   "description": "iTwin.js backend components",
   "main": "lib/cjs/core-backend.js",
   "typings": "lib/cjs/core-backend",
@@ -24,9 +24,9 @@
     "url": "http://www.bentley.com"
   },
   "peerDependencies": {
-    "@itwin/core-bentley": "^3.6.0-dev.62",
-    "@itwin/core-common": "^3.6.0-dev.62",
-    "@itwin/core-geometry": "^3.6.0-dev.62",
+    "@itwin/core-bentley": "^3.6.0-dev.66",
+    "@itwin/core-common": "^3.6.0-dev.66",
+    "@itwin/core-geometry": "^3.6.0-dev.66",
     "@opentelemetry/api": "^1.0.4"
   },
   "peerDependenciesMeta": {
@@ -39,12 +39,12 @@
     "NOTE: All tools used by scripts in this package must be listed as devDependencies"
   ],
   "devDependencies": {
-    "@itwin/build-tools": "3.6.0-dev.62",
-    "@itwin/core-bentley": "3.6.0-dev.62",
-    "@itwin/core-common": "3.6.0-dev.62",
-    "@itwin/core-geometry": "3.6.0-dev.62",
-    "@itwin/core-webpack-tools": "3.6.0-dev.62",
-    "@itwin/eslint-plugin": "3.6.0-dev.62",
+    "@itwin/build-tools": "3.6.0-dev.66",
+    "@itwin/core-bentley": "3.6.0-dev.66",
+    "@itwin/core-common": "3.6.0-dev.66",
+    "@itwin/core-geometry": "3.6.0-dev.66",
+    "@itwin/core-webpack-tools": "3.6.0-dev.66",
+    "@itwin/eslint-plugin": "3.6.0-dev.66",
     "@opentelemetry/api": "1.0.4",
     "@types/chai": "4.3.1",
     "@types/chai-as-promised": "^7",
@@ -74,11 +74,11 @@
   },
   "dependencies": {
     "@azure/storage-blob": "^12.7.0",
-    "@bentley/imodeljs-native": "3.6.6",
+    "@bentley/imodeljs-native": "3.6.7",
     "@itwin/object-storage-azure": "~1.4.0",
     "@itwin/cloud-agnostic-core": "~1.4.0",
     "@itwin/object-storage-core": "~1.4.0",
-    "@itwin/core-telemetry": "3.6.0-dev.62",
+    "@itwin/core-telemetry": "3.6.0-dev.66",
     "form-data": "^2.3.2",
     "fs-extra": "^8.1.0",
     "inversify": "~5.0.1",