@bentley/imodeljs-native 3.4.9 → 3.4.15

package/imodeljs-native.d.ts

@@ -1,3 +1,3 @@
-export * from "./NativeLibrary";
-export * from "./CloudSqlite";
+export * from "./NativeLibrary";
+export * from "./NativeCloudSqlite";
 //# sourceMappingURL=imodeljs-native.d.ts.map

package/imodeljs-native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imodeljs-native.d.ts","sourceRoot":"","sources":["../src/imodeljs-native.ts"],"names":[],"mappings":"AAKA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"imodeljs-native.d.ts","sourceRoot":"","sources":["../src/imodeljs-native.ts"],"names":[],"mappings":"AAKA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/imodeljs-native.js

@@ -1,23 +1,23 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-__exportStar(require("./NativeLibrary"), exports);
-__exportStar(require("./CloudSqlite"), exports);
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+__exportStar(require("./NativeLibrary"), exports);
+__exportStar(require("./NativeCloudSqlite"), exports);
 //# sourceMappingURL=imodeljs-native.js.map

package/imodeljs-native.js.map

@@ -1 +1 @@
-{"version":3,"file":"imodeljs-native.js","sourceRoot":"","sources":["../src/imodeljs-native.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA;;;+FAG+F;AAC/F,kDAAgC;AAChC,gDAA8B","sourcesContent":["\r\n/*---------------------------------------------------------------------------------------------\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\nexport * from \"./NativeLibrary\";\r\nexport * from \"./CloudSqlite\";\r\n"]}
+{"version":3,"file":"imodeljs-native.js","sourceRoot":"","sources":["../src/imodeljs-native.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA;;;+FAG+F;AAC/F,kDAAgC;AAChC,sDAAoC","sourcesContent":["\r\n/*---------------------------------------------------------------------------------------------\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\nexport * from \"./NativeLibrary\";\r\nexport * from \"./NativeCloudSqlite\";\r\n"]}

package/installNativePlatform.js

@@ -68,27 +68,35 @@ function copyFolderRecursiveSync(source, target) {
   }
 }
 
-// We have to run npm install in a temp directory. If we try to run it in the current directory,
-// it will fight over a (file?) lock that the parent npm install holds.
-// Note that we have to copy the current package.json to the temp directory, or else npm install will object.
-const installDir = path.join(os.tmpdir(), "install-imodeljs-native");
-try { fs.mkdirSync(installDir); } catch (err) { }
-fs.copyFileSync(path.join(__dirname, "package.json"), path.join(installDir, "package.json"));
+if (process.env.IMODELJS_NATIVE_OVERRIDE !== undefined) {
+  // expect IMODELJS_NATIVE_OVERRIDE to have the necessary platform in it already. 
+  console.log(`OVERRIDE DETECTED`);
+  const overrideFolder = path.resolve(process.env.IMODELJS_NATIVE_OVERRIDE);
+  console.log(`Copying contents of folder ${overrideFolder} to ${__dirname}`)
+  copyFolderRecursiveSync(overrideFolder, __dirname);
+} else {
+  // We have to run npm install in a temp directory. If we try to run it in the current directory,
+  // it will fight over a (file?) lock that the parent npm install holds.
+  // Note that we have to copy the current package.json to the temp directory, or else npm install will object.
+  const installDir = path.join(os.tmpdir(), "install-imodeljs-native");
+  try { fs.mkdirSync(installDir); } catch (err) { }
+  fs.copyFileSync(path.join(__dirname, "package.json"), path.join(installDir, "package.json"));
 
-// We will then copy the results of the install from the temp directory into sub-directories below this one.
-function installNativePackage() {
-  checkSupportedPlatform();
+  // We will then copy the results of the install from the temp directory into sub-directories below this one.
+  function installNativePackage() {
+    checkSupportedPlatform();
 
-// This platform is supported. Try to install the appropriate addon package.
-const cmdLine = `npm install --no-save @bentley/imodeljs-${process.platform}-${process.arch}@${version}`;
-  console.log(cmdLine);
-  exec(cmdLine, { cwd: installDir }, (error, stdout, stderr) => {
-    if (error)
-      throw error;
-    console.log(stdout);
-    console.log(stderr);
-    copyFolderRecursiveSync(path.join(installDir, "node_modules", "@bentley"), __dirname);
-  });
-}
+  // This platform is supported. Try to install the appropriate addon package.
+  const cmdLine = `npm install --no-save @bentley/imodeljs-${process.platform}-${process.arch}@${version}`;
+    console.log(cmdLine);
+    exec(cmdLine, { cwd: installDir }, (error, stdout, stderr) => {
+      if (error)
+        throw error;
+      console.log(stdout);
+      console.log(stderr);
+      copyFolderRecursiveSync(path.join(installDir, "node_modules", "@bentley"), __dirname);
+    });
+  }
 
-installNativePackage();
+  installNativePackage();
+}

package/package.json

@@ -1,23 +1,23 @@
-{
-  "name": "@bentley/imodeljs-native",
-  "license": "SEE LICENSE IN LICENSE.md",
-  "version": "3.4.9",
-  "main": "imodeljs-native.js",
-  "typings": "imodeljs-native",
-  "keywords": [
-    "Bentley",
-    "iModel"
-  ],
-  "repository": {
-    "type" : "git",
-    "url" : "https://github.com/imodeljs/imodeljs"
-  },
-  "description": "iModel.js native module",
-  "author": {
-    "name": "Bentley Systems, Inc.",
-    "url": "www.bentley.com"
-  },
-   "scripts": {
-    "postinstall": "node ./installNativePlatform.js"
-   }
-}
+{
+  "name": "@bentley/imodeljs-native",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "version": "3.4.15",
+  "main": "imodeljs-native.js",
+  "typings": "imodeljs-native",
+  "keywords": [
+    "Bentley",
+    "iModel"
+  ],
+  "repository": {
+    "type" : "git",
+    "url" : "https://github.com/imodeljs/imodeljs"
+  },
+  "description": "iModel.js native module",
+  "author": {
+    "name": "Bentley Systems, Inc.",
+    "url": "www.bentley.com"
+  },
+   "scripts": {
+    "postinstall": "node ./installNativePlatform.js"
+   }
+}

package/CloudSqlite.d.ts.map

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

package/CloudSqlite.js

@@ -1,156 +0,0 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module iModels
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CloudSqlite = void 0;
-const child_process = require("child_process");
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-const NativeLibrary_1 = require("./NativeLibrary");
-// cspell:ignore polltime cachesize notimestamps deletetime gctime retrytime nwrite ndelete prefetch httptimeout
-/* eslint-disable no-restricted-syntax */
-var CloudSqlite;
-(function (CloudSqlite) {
-    ;
-    class Daemon {
-        static exeName(props) {
-            var _a;
-            return (_a = props.exePath) !== null && _a !== void 0 ? _a : path.join(__dirname, NativeLibrary_1.NativeLibrary.archName, os.platform() === "win32" ? "iTwinDaemon.exe" : "iTwinDaemon");
-        }
-        static daemonDir(props) {
-            var _a;
-            return (_a = props.rootDir) !== null && _a !== void 0 ? _a : path.join(NativeLibrary_1.NativeLibrary.defaultCacheDir, "itwin-daemon");
-        }
-        /** Start the Daemon process using the supplied properties. The process will be detached from the current process. */
-        static start(props) {
-            const dir = this.daemonDir(props);
-            fs.mkdirSync(dir, { recursive: true }); // make sure the directory exists before starting the daemon
-            const args = [`daemon`];
-            if (props.addr !== undefined)
-                args.push(`-addr`, `${props.addr}`);
-            if (props.portNumber !== undefined)
-                args.push(`-port`, `${props.portNumber}`);
-            if (props.cacheSize)
-                args.push(`-cachesize`, `${props.cacheSize}`);
-            if (props.log)
-                args.push(`-log`, `${props.log}`);
-            if (props.noTimeStamps)
-                args.push(`-notimestamps`);
-            if (props.httptimeout !== undefined)
-                args.push(`-httptimeout`, `${props.httptimeout}`);
-            args.push(`${dir}`); // This MUST be the last arg when starting the daemon.
-            return child_process.spawn(this.exeName(props), args, Object.assign(Object.assign({}, props.spawnOptions), { windowsVerbatimArguments: true }));
-        }
-    }
-    CloudSqlite.Daemon = Daemon;
-    /** @internal */
-    async function transferDb(direction, container, props) {
-        if (direction === "download")
-            fs.mkdirSync(path.dirname(props.localFileName), { recursive: true }); // make sure the directory exists before starting download
-        let timer;
-        try {
-            const transfer = new NativeLibrary_1.NativeLibrary.nativeLib.CloudDbTransfer(direction, container, props);
-            let total = 0;
-            const onProgress = props.onProgress;
-            if (onProgress) {
-                timer = setInterval(async () => {
-                    const progress = transfer.getProgress();
-                    total = progress.total;
-                    if (onProgress(progress.loaded, progress.total))
-                        transfer.cancelTransfer();
-                }, 250);
-            }
-            await transfer.promise;
-            onProgress === null || onProgress === void 0 ? void 0 : onProgress(total, total); // make sure we call progress func one last time when download completes
-        }
-        catch (err) {
-            if (err.message === "cancelled")
-                err.errorNumber = 131079; // BriefcaseStatus.DownloadCancelled
-            throw err;
-        }
-        finally {
-            if (timer)
-                clearInterval(timer);
-        }
-    }
-    CloudSqlite.transferDb = transferDb;
-    /** Upload a database into a CloudContainer
-     * @param container the CloudContainer holding the database. Must be connected.
-     * @param props the properties that describe the database to be downloaded, plus optionally an `onProgress` function.
-     * @note this function requires that the write lock be held on the container
-     */
-    async function uploadDb(container, props) {
-        await transferDb("upload", container, props);
-        container.checkForChanges(); // re-read the manifest so the database is available locally.
-    }
-    CloudSqlite.uploadDb = uploadDb;
-    /** Download a database from a CloudContainer
-     * @param container the CloudContainer holding the database. Must be connected.
-     * @param props the properties that describe the database to be downloaded, plus optionally an `onProgress` function.
-     * @returns a Promise that is resolved when the download completes.
-     * @note the download is "restartable." If the transfer is aborted and then re-requested, it will continue from where
-     * it left off rather than re-downloading the entire file.
-     */
-    async function downloadDb(container, props) {
-        await transferDb("download", container, props);
-    }
-    CloudSqlite.downloadDb = downloadDb;
-    /**
-     * Attempt to acquire the write lock for a container, with retries.
-     * If write lock is held by another user, call busyHandler if supplied. If no busyHandler, or handler returns "stop", throw. Otherwise try again.
-     * @note if write lock is already held, this function does nothing.
-     * @param user the name to be displayed to other users in the event they attempt to obtain the lock while it is held by us
-     * @param container the CloudContainer for which the lock is to be acquired
-     * @param busyHandler if present, function called when the write lock is currently held by another user.
-     */
-    async function acquireWriteLock(user, container, busyHandler) {
-        if (container.hasWriteLock)
-            return;
-        while (true) {
-            try {
-                return container.acquireWriteLock(user);
-            }
-            catch (e) {
-                if (e.errorNumber === 5 && busyHandler && "stop" !== await busyHandler(e.lockedBy, e.expires)) // 5 === BE_SQLITE_BUSY
-                    continue; // busy handler wants to try again
-                throw e;
-            }
-        }
-    }
-    CloudSqlite.acquireWriteLock = acquireWriteLock;
-    /**
-     * Perform an asynchronous write operation on a CloudContainer with the write lock held.
-     * 1. if write lock is already held, call operation and return.
-     * 2. attempt to acquire the write lock, with retries. Throw if unable to obtain write lock.
-     * 3. perform the operation
-     * 3.a if the operation throws, abandon all changes and re-throw
-     * 4. release the write lock.
-     * 5. return value from operation
-     * @param user the name to be displayed to other users in the event they attempt to obtain the lock while it is held by us
-     * @param container the CloudContainer for which the lock is to be acquired
-     * @param operation an asynchronous operation performed with the write lock held.
-     * @param busyHandler if present, function called when the write lock is currently held by another user.
-     */
-    async function withWriteLock(user, container, operation, busyHandler) {
-        if (container.hasWriteLock)
-            return operation();
-        await acquireWriteLock(user, container, busyHandler);
-        try {
-            const val = await operation(); // wait for work to finish or fail
-            container.releaseWriteLock();
-            return val;
-        }
-        catch (e) {
-            container.abandonChanges(); // if operation threw, abandon all changes
-            throw e;
-        }
-    }
-    CloudSqlite.withWriteLock = withWriteLock;
-})(CloudSqlite = exports.CloudSqlite || (exports.CloudSqlite = {}));
-//# sourceMappingURL=CloudSqlite.js.map

package/CloudSqlite.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CloudSqlite.js","sourceRoot":"","sources":["../src/CloudSqlite.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 iModels\r\n */\r\n\r\nimport * as child_process from \"child_process\";\r\nimport * as fs from \"fs\";\r\nimport * as os from \"os\";\r\nimport * as path from \"path\";\r\nimport { IModelJsNative, NativeLibrary } from \"./NativeLibrary\";\r\n\r\n/**\r\n * @note This package may only have **dev** dependencies on @itwin packages, so they are *not* available at runtime. Therefore we can only import **types** from them.\r\n */\r\nimport type { LocalFileName } from \"@itwin/core-common\";\r\n\r\n// cspell:ignore polltime cachesize notimestamps deletetime gctime retrytime nwrite ndelete prefetch httptimeout\r\n/* eslint-disable no-restricted-syntax */\r\n\r\nexport namespace CloudSqlite {\r\n\r\n  export const enum LogMask {\r\n    LOG_HTTP = 0x0001, LOG_UPLOAD = 0x0002, LOG_CLEANUP = 0x0004, LOG_EVENT = 0x0008\r\n  };\r\n\r\n  /** Properties that specify how to access the account for a cloud blob-store container. */\r\n  export interface AccountAccessProps {\r\n    /** blob storage module: e.g. \"azure\", \"google\", \"aws\". May also include URI style parameters. */\r\n    storageType: string;\r\n    /** blob store account name, or a URI for custom domains. */\r\n    accessName: string;\r\n  }\r\n\r\n  /** Properties of a CloudContainer. */\r\n  export interface ContainerProps {\r\n    /** the name of the container. */\r\n    containerId: string;\r\n    /** an alias for the container. Defaults to `containerId` */\r\n    alias?: string;\r\n    /** token that grants access to the container. For sas=1 `storageType`s, this is the sasToken. For sas=0, this is the account key */\r\n    accessToken: string;\r\n    /** if true, container is attached with write permissions, and accessToken must provide write access to the cloud container. */\r\n    writeable?: boolean;\r\n    /** if true, container is attached in \"secure\" mode (blocks are encrypted). Only supported in daemon mode. */\r\n    secure?: boolean;\r\n  }\r\n\r\n  /** Returned from `CloudContainer.queryDatabase` describing one database in the container */\r\n  export interface CachedDbProps {\r\n    /** The total of (4Mb) blocks in the database. */\r\n    readonly totalBlocks: number,\r\n    /** the number of blocks of the database that have been downloaded into the CloudCache */\r\n    readonly localBlocks: number,\r\n    /** the number of blocks from this database that have been modified in the CloudCache and need to be uploaded. */\r\n    readonly dirtyBlocks: number,\r\n    /** If true, the database currently has transactions in the WAL file and may not be uploaded until they have been checkPointed. */\r\n    readonly transactions: boolean;\r\n\r\n    /** the state of this database. Indicates whether the database is new or deleted since last upload */\r\n    readonly state: \"\" | \"copied\" | \"deleted\";\r\n  }\r\n\r\n  /** Properties for accessing a CloudContainer */\r\n  export type ContainerAccessProps = AccountAccessProps & ContainerProps & {\r\n\r\n    /** Duration for holding write lock, in seconds. After this time the write lock expires if not refreshed. Default is one hour. */\r\n    durationSeconds?: number\r\n  };\r\n\r\n  /** The name of a CloudSqlite database within a CloudContainer. */\r\n  export interface DbNameProp {\r\n    /** the name of the database within the CloudContainer.\r\n     * @note names of databases within a CloudContainer are always **case sensitive** on all platforms.*/\r\n    dbName: string\r\n  }\r\n\r\n  /** Properties for accessing a database within a CloudContainer */\r\n  export interface DbProps extends DbNameProp {\r\n    /** the name of the local file to access the database. */\r\n    localFileName: LocalFileName\r\n  }\r\n\r\n  export type TransferDirection = \"upload\" | \"download\";\r\n  export interface TransferProgress {\r\n    /** a user-supplied progress function called during the transfer operation. Return a non-0 value to abort the transfer. */\r\n    onProgress?: (loaded: number, total: number) => number\r\n  }\r\n\r\n  export interface CloudHttpProps {\r\n    /** The number of simultaneous HTTP requests.  Default is 6. */\r\n    nRequests?: number;\r\n  }\r\n\r\n  export interface PrefetchProps extends CloudHttpProps {\r\n    /** timeout between requests, in milliseconds. Default is 100. */\r\n    timeout?: number;\r\n    /** The number of prefetch requests to issue while there is foreground activity. Default is 3. */\r\n    minRequests?: number;\r\n  }\r\n\r\n  export type TransferDbProps = DbProps & TransferProgress & CloudHttpProps;\r\n\r\n  /** Properties for creating a CloudCache. */\r\n  export interface CacheProps extends CloudHttpProps {\r\n    /** full path of directory for cache to store its files. Must be on a (preferably fast) local drive, and must be empty when the cache is first created. */\r\n    rootDir: string;\r\n    /** name of this cache. It is possible to have more than one CloudCache in the same session. */\r\n    name: string;\r\n    /** maximum cache Size. Must be a number followed by either M (for megabytes) or G (for gigabytes.) Default is 1G */\r\n    cacheSize?: string;\r\n    /** turn on diagnostics for `curl` (outputs to stderr) */\r\n    curlDiagnostics?: boolean;\r\n  }\r\n\r\n  /** Properties for creating a new instance of a daemon process. */\r\n  export interface DaemonProps {\r\n    /** full path name of daemon.exe file. Default is to find \"iTwinDaemon.exe\" in the same directory as this library. */\r\n    exePath?: string;\r\n    /** daemon connection address. Default is \"127.0.0.1\" */\r\n    addr?: string;\r\n    /** port number. Default 22002 */\r\n    portNumber?: number;\r\n    /** maximum cache Size. Must be a number followed by either M (for megabytes) or G (for gigabytes.) Default is 1G */\r\n    cacheSize?: string;\r\n    /** logging options */\r\n    log?: string;\r\n    /** if true, don't include timestamps in log messages */\r\n    noTimeStamps?: boolean;\r\n    /** The amount of time, in seconds before an http request made to cloud storage by the daemon times out. Default 600 seconds. */\r\n    httptimeout?: number;\r\n    /** options for spawn */\r\n    spawnOptions?: child_process.SpawnOptions;\r\n  }\r\n  export type DaemonCommandArg = DbNameProp & AccountAccessProps & CacheProps & ContainerProps;\r\n\r\n  export class Daemon {\r\n    private static exeName(props: DaemonProps) {\r\n      return props.exePath ?? path.join(__dirname, NativeLibrary.archName, os.platform() === \"win32\" ? \"iTwinDaemon.exe\" : \"iTwinDaemon\");\r\n    }\r\n    public static daemonDir(props: CacheProps) {\r\n      return props.rootDir ?? path.join(NativeLibrary.defaultCacheDir, \"itwin-daemon\");\r\n    }\r\n\r\n    /** Start the Daemon process using the supplied properties. The process will be detached from the current process. */\r\n    public static start(props: DaemonProps & CacheProps): child_process.ChildProcess {\r\n      const dir = this.daemonDir(props);\r\n      fs.mkdirSync(dir, { recursive: true }); // make sure the directory exists before starting the daemon\r\n\r\n      const args = [`daemon`];\r\n      if (props.addr !== undefined)\r\n        args.push(`-addr`, `${props.addr}`);\r\n      if (props.portNumber !== undefined)\r\n        args.push(`-port`, `${props.portNumber}`);\r\n      if (props.cacheSize)\r\n        args.push(`-cachesize`, `${props.cacheSize}`);\r\n      if (props.log)\r\n        args.push(`-log`, `${props.log}`);\r\n      if (props.noTimeStamps)\r\n        args.push(`-notimestamps`);\r\n      if (props.httptimeout !== undefined)\r\n        args.push(`-httptimeout`, `${props.httptimeout}`)\r\n      args.push(`${dir}`); // This MUST be the last arg when starting the daemon.\r\n      return child_process.spawn(this.exeName(props), args, { ...props.spawnOptions, windowsVerbatimArguments: true });\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  export async function transferDb(direction: TransferDirection, container: IModelJsNative.CloudContainer, props: TransferDbProps) {\r\n    if (direction === \"download\")\r\n      fs.mkdirSync(path.dirname(props.localFileName), { recursive: true }); // make sure the directory exists before starting download\r\n\r\n    let timer: NodeJS.Timeout | undefined;\r\n    try {\r\n      const transfer = new NativeLibrary.nativeLib.CloudDbTransfer(direction, container, props);\r\n      let total = 0;\r\n      const onProgress = props.onProgress;\r\n      if (onProgress) {\r\n        timer = setInterval(async () => { // set an interval timer to show progress every 250ms\r\n          const progress = transfer.getProgress();\r\n          total = progress.total;\r\n          if (onProgress(progress.loaded, progress.total))\r\n            transfer.cancelTransfer();\r\n        }, 250);\r\n      }\r\n      await transfer.promise;\r\n      onProgress?.(total, total); // make sure we call progress func one last time when download completes\r\n    } catch (err: any) {\r\n      if (err.message === \"cancelled\")\r\n        err.errorNumber = 131079; // BriefcaseStatus.DownloadCancelled\r\n\r\n      throw err;\r\n    } finally {\r\n      if (timer)\r\n        clearInterval(timer);\r\n    }\r\n  }\r\n\r\n  /** Upload a database into a CloudContainer\r\n   * @param container the CloudContainer holding the database. Must be connected.\r\n   * @param props the properties that describe the database to be downloaded, plus optionally an `onProgress` function.\r\n   * @note this function requires that the write lock be held on the container\r\n   */\r\n  export async function uploadDb(container: IModelJsNative.CloudContainer, props: TransferDbProps): Promise<void> {\r\n    await transferDb(\"upload\", container, props);\r\n    container.checkForChanges(); // re-read the manifest so the database is available locally.\r\n  }\r\n\r\n  /** Download a database from a CloudContainer\r\n   * @param container the CloudContainer holding the database. Must be connected.\r\n   * @param props the properties that describe the database to be downloaded, plus optionally an `onProgress` function.\r\n   * @returns a Promise that is resolved when the download completes.\r\n   * @note the download is \"restartable.\" If the transfer is aborted and then re-requested, it will continue from where\r\n   * it left off rather than re-downloading the entire file.\r\n   */\r\n  export async function downloadDb(container: IModelJsNative.CloudContainer, props: TransferDbProps): Promise<void> {\r\n    await transferDb(\"download\", container, props);\r\n  }\r\n\r\n  /** Optional method to be called when an attempt to acquire the write lock fails because another user currently holds it.\r\n   * @param lockedBy The identifier supplied by the application/user that currently holds the lock.\r\n   * @param expires a stringified Date (in local time) indicating when the lock will expire.\r\n   * @return \"stop\" to give up and stop retrying. Generally, it's a good idea to wait for some time before returning.\r\n   */\r\n  export type WriteLockBusyHandler = (lockedBy: string, expires: string) => Promise<void | \"stop\">;\r\n\r\n  /**\r\n   * Attempt to acquire the write lock for a container, with retries.\r\n   * If write lock is held by another user, call busyHandler if supplied. If no busyHandler, or handler returns \"stop\", throw. Otherwise try again.\r\n   * @note if write lock is already held, this function does nothing.\r\n   * @param user the name to be displayed to other users in the event they attempt to obtain the lock while it is held by us\r\n   * @param container the CloudContainer for which the lock is to be acquired\r\n   * @param busyHandler if present, function called when the write lock is currently held by another user.\r\n   */\r\n  export async function acquireWriteLock(user: string, container: IModelJsNative.CloudContainer, busyHandler?: WriteLockBusyHandler) {\r\n    if (container.hasWriteLock)\r\n      return;\r\n\r\n    while (true) {\r\n      try {\r\n        return container.acquireWriteLock(user);\r\n      } catch (e: any) {\r\n        if (e.errorNumber === 5 && busyHandler && \"stop\" !== await busyHandler(e.lockedBy, e.expires)) // 5 === BE_SQLITE_BUSY\r\n          continue; // busy handler wants to try again\r\n        throw e;\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Perform an asynchronous write operation on a CloudContainer with the write lock held.\r\n   * 1. if write lock is already held, call operation and return.\r\n   * 2. attempt to acquire the write lock, with retries. Throw if unable to obtain write lock.\r\n   * 3. perform the operation\r\n   * 3.a if the operation throws, abandon all changes and re-throw\r\n   * 4. release the write lock.\r\n   * 5. return value from operation\r\n   * @param user the name to be displayed to other users in the event they attempt to obtain the lock while it is held by us\r\n   * @param container the CloudContainer for which the lock is to be acquired\r\n   * @param operation an asynchronous operation performed with the write lock held.\r\n   * @param busyHandler if present, function called when the write lock is currently held by another user.\r\n   */\r\n  export async function withWriteLock<T>(user: string, container: IModelJsNative.CloudContainer, operation: () => T, busyHandler?: WriteLockBusyHandler) {\r\n    if (container.hasWriteLock)\r\n      return operation();\r\n\r\n    await acquireWriteLock(user, container, busyHandler);\r\n    try {\r\n      const val = await operation(); // wait for work to finish or fail\r\n      container.releaseWriteLock();\r\n      return val;\r\n    } catch (e) {\r\n      container.abandonChanges();  // if operation threw, abandon all changes\r\n      throw e;\r\n    }\r\n  }\r\n}\r\n"]}