@itwin/core-backend 3.0.0-dev.100

package/lib/cjs/IModelHost.js

@@ -0,0 +1,411 @@
+"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 IModelHost
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileNameResolver = exports.KnownLocations = exports.Platform = exports.IModelHost = exports.IModelHostConfiguration = void 0;
+const os = require("os");
+const path = require("path");
+const semver = require("semver");
+const imodeljs_native_1 = require("@bentley/imodeljs-native");
+const telemetry_client_1 = require("@bentley/telemetry-client");
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+const AliCloudStorageService_1 = require("./AliCloudStorageService");
+const BackendLoggerCategory_1 = require("./BackendLoggerCategory");
+const BisCoreSchema_1 = require("./BisCoreSchema");
+const BriefcaseManager_1 = require("./BriefcaseManager");
+const CloudStorageBackend_1 = require("./CloudStorageBackend");
+const FunctionalSchema_1 = require("./domains/FunctionalSchema");
+const GenericSchema_1 = require("./domains/GenericSchema");
+const IModelJsFs_1 = require("./IModelJsFs");
+const DevToolsRpcImpl_1 = require("./rpc-impl/DevToolsRpcImpl");
+const IModelReadRpcImpl_1 = require("./rpc-impl/IModelReadRpcImpl");
+const IModelTileRpcImpl_1 = require("./rpc-impl/IModelTileRpcImpl");
+const SnapshotIModelRpcImpl_1 = require("./rpc-impl/SnapshotIModelRpcImpl");
+const WipRpcImpl_1 = require("./rpc-impl/WipRpcImpl");
+const RpcBackend_1 = require("./RpcBackend");
+const loggerCategory = BackendLoggerCategory_1.BackendLoggerCategory.IModelHost;
+/** Configuration of core-backend.
+ * @public
+ */
+class IModelHostConfiguration {
+    constructor() {
+        /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a "pending" status.
+         * @internal
+         */
+        this.tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;
+        /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a "pending" status.
+         * @internal
+         */
+        this.tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;
+        /** The backend will log when a tile took longer to load than this threshold in seconds.
+         * @internal
+         */
+        this.logTileLoadTimeThreshold = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;
+        /** The backend will log when a tile is loaded with a size in bytes above this threshold.
+         * @internal
+         */
+        this.logTileSizeThreshold = IModelHostConfiguration.defaultLogTileSizeThreshold;
+    }
+}
+exports.IModelHostConfiguration = IModelHostConfiguration;
+/** The default time, in milliseconds, used for [[tileTreeRequestTimeout]] and [[tileContentRequestTimeout]]. To change this, override one or both of those properties.
+ * @internal
+ */
+IModelHostConfiguration.defaultTileRequestTimeout = 20 * 1000;
+/** The default time, in seconds, used for [[logTileLoadTimeThreshold]]. To change this, override that property.
+ * @internal
+ */
+IModelHostConfiguration.defaultLogTileLoadTimeThreshold = 40;
+/** The default size, in bytes, used for [[logTileSizeThreshold]]. To change this, override that property.
+ * @internal
+ */
+IModelHostConfiguration.defaultLogTileSizeThreshold = 20 * 1000000;
+/** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.
+ * See [the learning article]($docs/learning/backend/IModelHost.md)
+ * @public
+ */
+class IModelHost {
+    constructor() { }
+    /** @internal */
+    static get platform() {
+        if (this._platform === undefined)
+            throw new Error("IModelHost.startup must be called first");
+        return this._platform;
+    }
+    /** A uniqueId for this session */
+    static get sessionId() { return this.session.sessionId; }
+    static set sessionId(id) { this.session.sessionId = id; }
+    /** The Id of this application - needs to be set only if it is an agent application. The applicationId will otherwise originate at the frontend. */
+    static get applicationId() { return this.session.applicationId; }
+    static set applicationId(id) { this.session.applicationId = id; }
+    /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */
+    static get applicationVersion() { return this.session.applicationVersion; }
+    static set applicationVersion(version) { this.session.applicationVersion = version; }
+    /** Root of the directory holding all the files that iModel.js caches */
+    static get cacheDir() { return this._cacheDir; }
+    /** Get the current access token for this IModelHost, or a blank string if none is available.
+     * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)
+     * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend
+     * obtains the token and forwards it to the frontend.
+     * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value
+     * returned by this method may change over time throughout the course of a session.
+     */
+    static async getAccessToken() {
+        var _a, _b;
+        try {
+            return (_b = (await ((_a = this.authorizationClient) === null || _a === void 0 ? void 0 : _a.getAccessToken()))) !== null && _b !== void 0 ? _b : "";
+        }
+        catch (e) {
+            return "";
+        }
+    }
+    /** @internal */
+    static flushLog() {
+        return this.platform.DgnDb.flushLog();
+    }
+    /** @internal */
+    static loadNative() {
+        const platform = Platform.load();
+        this.registerPlatform(platform);
+    }
+    static registerPlatform(platform) {
+        this._platform = platform;
+        if (undefined === platform)
+            return;
+        if (!core_bentley_1.ProcessDetector.isMobileAppBackend)
+            this.validateNativePlatformVersion();
+        platform.logger = core_bentley_1.Logger;
+    }
+    static validateNativePlatformVersion() {
+        const requiredVersion = require("../../package.json").dependencies["@bentley/imodeljs-native"]; // eslint-disable-line @typescript-eslint/no-var-requires
+        const thisVersion = this.platform.version;
+        if (semver.satisfies(thisVersion, requiredVersion))
+            return;
+        if (IModelJsFs_1.IModelJsFs.existsSync(path.join(__dirname, "DevBuild.txt"))) {
+            console.log("Bypassing version checks for development build"); // eslint-disable-line no-console
+            return;
+        }
+        this._platform = undefined;
+        throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, `imodeljs-native version is (${thisVersion}). core-backend requires version (${requiredVersion})`);
+    }
+    /** @internal */
+    static setHubAccess(hubAccess) { this._hubAccess = hubAccess; }
+    /** Provides access to the IModelHub for this IModelHost
+     * @beta
+     */
+    static get hubAccess() { return this._hubAccess; }
+    /** Returns true if IModelHost is started.  */
+    static get isValid() { return this._isValid; }
+    /** This method must be called before any iModel.js services are used.
+     * @param configuration Host configuration data.
+     * Raises [[onAfterStartup]].
+     * @see [[shutdown]].
+     */
+    static async startup(configuration = new IModelHostConfiguration()) {
+        if (this._isValid)
+            return; // we're already initialized
+        this._isValid = true;
+        if (IModelHost.sessionId === "")
+            IModelHost.sessionId = core_bentley_1.Guid.createValue();
+        this.logStartup();
+        this.backendVersion = require("../../package.json").version; // eslint-disable-line @typescript-eslint/no-var-requires
+        (0, RpcBackend_1.initializeRpcBackend)();
+        if (this._platform === undefined) {
+            try {
+                this.loadNative();
+            }
+            catch (error) {
+                core_bentley_1.Logger.logError(loggerCategory, "Error registering/loading the native platform API", () => (configuration));
+                throw error;
+            }
+        }
+        if (configuration.crashReportingConfig && configuration.crashReportingConfig.crashDir && !core_bentley_1.ProcessDetector.isElectronAppBackend && !core_bentley_1.ProcessDetector.isMobileAppBackend) {
+            this.platform.setCrashReporting(configuration.crashReportingConfig);
+            core_bentley_1.Logger.logTrace(loggerCategory, "Configured crash reporting", () => {
+                var _a, _b, _c, _d;
+                return ({
+                    enableCrashDumps: (_a = configuration.crashReportingConfig) === null || _a === void 0 ? void 0 : _a.enableCrashDumps,
+                    wantFullMemoryDumps: (_b = configuration.crashReportingConfig) === null || _b === void 0 ? void 0 : _b.wantFullMemoryDumps,
+                    enableNodeReport: (_c = configuration.crashReportingConfig) === null || _c === void 0 ? void 0 : _c.enableNodeReport,
+                    uploadToBentley: (_d = configuration.crashReportingConfig) === null || _d === void 0 ? void 0 : _d.uploadToBentley,
+                });
+            });
+            if (configuration.crashReportingConfig.enableNodeReport) {
+                try {
+                    // node-report reports on V8 fatal errors and unhandled exceptions/Promise rejections.
+                    const nodereport = require("node-report/api"); // eslint-disable-line @typescript-eslint/no-var-requires
+                    nodereport.setEvents("exception+fatalerror+apicall");
+                    nodereport.setDirectory(configuration.crashReportingConfig.crashDir);
+                    nodereport.setVerbose("yes");
+                    core_bentley_1.Logger.logTrace(loggerCategory, "Configured native crash reporting (node-report)");
+                }
+                catch (err) {
+                    core_bentley_1.Logger.logWarning(loggerCategory, "node-report is not installed.");
+                }
+            }
+        }
+        this.setupCacheDirs(configuration);
+        BriefcaseManager_1.BriefcaseManager.initialize(this._briefcaseCacheDir);
+        [
+            IModelReadRpcImpl_1.IModelReadRpcImpl,
+            IModelTileRpcImpl_1.IModelTileRpcImpl,
+            SnapshotIModelRpcImpl_1.SnapshotIModelRpcImpl,
+            WipRpcImpl_1.WipRpcImpl,
+            DevToolsRpcImpl_1.DevToolsRpcImpl,
+        ].forEach((rpc) => rpc.register()); // register all of the RPC implementations
+        [
+            BisCoreSchema_1.BisCoreSchema,
+            GenericSchema_1.GenericSchema,
+            FunctionalSchema_1.FunctionalSchema,
+        ].forEach((schema) => schema.registerSchema()); // register all of the schemas
+        if (undefined !== configuration.hubAccess)
+            IModelHost._hubAccess = configuration.hubAccess;
+        IModelHost.configuration = configuration;
+        IModelHost.setupTileCache();
+        this.platform.setUseTileCache(configuration.tileCacheCredentials ? false : true);
+        process.once("beforeExit", IModelHost.shutdown);
+        IModelHost.onAfterStartup.raiseEvent();
+    }
+    static logStartup() {
+        if (!core_bentley_1.Logger.isEnabled(loggerCategory, core_bentley_1.LogLevel.Trace))
+            return;
+        // Extract the iModel details from environment - note this is very specific to Bentley hosted backends, but is quite useful for tracing
+        let startupInfo = {};
+        const serviceName = process.env.FABRIC_SERVICE_NAME;
+        if (serviceName) {
+            // e.g., fabric:/iModelWebViewer3.0/iModelJSGuest/1/08daaeb3-b56f-480b-9051-7efc834d18ae/512d971d-b641-4735-bb1c-c07ab3e44ce7/c1315fcce125ca40b2d405bb7809214daf8b4c85
+            const serviceNameComponents = serviceName.split("/");
+            if (serviceNameComponents.length === 7) {
+                startupInfo = {
+                    ...startupInfo,
+                    iTwinId: serviceNameComponents[4],
+                    iModelId: serviceNameComponents[5],
+                    changesetId: serviceNameComponents[6],
+                };
+            }
+        }
+        core_bentley_1.Logger.logTrace(loggerCategory, "IModelHost.startup", () => startupInfo);
+    }
+    static setupCacheDirs(configuration) {
+        this._cacheDir = configuration.cacheDir ? path.normalize(configuration.cacheDir) : imodeljs_native_1.NativeLibrary.defaultCacheDir;
+        IModelJsFs_1.IModelJsFs.recursiveMkDirSync(this._cacheDir); // make sure the directory for cacheDir exists.
+        this._briefcaseCacheDir = path.join(this._cacheDir, "imodels");
+    }
+    /** This method must be called when an iModel.js services is shut down. Raises [[onBeforeShutdown]] */
+    static async shutdown() {
+        // NB: This method is set as a node listener where `this` is unbound
+        if (!IModelHost._isValid)
+            return;
+        IModelHost._isValid = false;
+        IModelHost.onBeforeShutdown.raiseEvent();
+        IModelHost.configuration = undefined;
+        process.removeListener("beforeExit", IModelHost.shutdown);
+    }
+    /**
+     * Add or update a property that should be included in a crash report.
+     * @param name The name of the property
+     * @param value The value of the property
+     * @alpha
+     */
+    static setCrashReportProperty(name, value) {
+        (0, core_bentley_1.assert)(undefined !== this._platform);
+        this._platform.setCrashReportProperty(name, value);
+    }
+    /**
+     * Remove a previously defined property so that will not be included in a crash report.
+     * @param name The name of the property
+     * @alpha
+     */
+    static removeCrashReportProperty(name) {
+        (0, core_bentley_1.assert)(undefined !== this._platform);
+        this._platform.setCrashReportProperty(name, undefined);
+    }
+    /**
+     * Get all properties that will be included in a crash report.
+     * @alpha
+     */
+    static getCrashReportProperties() {
+        (0, core_bentley_1.assert)(undefined !== this._platform);
+        return this._platform.getCrashReportProperties();
+    }
+    /** The directory where application assets may be found */
+    static get appAssetsDir() { return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined; }
+    /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a "pending" status.
+     * @internal
+     */
+    static get tileTreeRequestTimeout() {
+        return undefined !== IModelHost.configuration ? IModelHost.configuration.tileTreeRequestTimeout : IModelHostConfiguration.defaultTileRequestTimeout;
+    }
+    /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a "pending" status.
+     * @internal
+     */
+    static get tileContentRequestTimeout() {
+        return undefined !== IModelHost.configuration ? IModelHost.configuration.tileContentRequestTimeout : IModelHostConfiguration.defaultTileRequestTimeout;
+    }
+    /** The backend will log when a tile took longer to load than this threshold in seconds. */
+    static get logTileLoadTimeThreshold() { return undefined !== IModelHost.configuration ? IModelHost.configuration.logTileLoadTimeThreshold : IModelHostConfiguration.defaultLogTileLoadTimeThreshold; }
+    /** The backend will log when a tile is loaded with a size in bytes above this threshold. */
+    static get logTileSizeThreshold() { return undefined !== IModelHost.configuration ? IModelHost.configuration.logTileSizeThreshold : IModelHostConfiguration.defaultLogTileSizeThreshold; }
+    /** Whether external tile caching is active.
+     * @internal
+     */
+    static get usingExternalTileCache() {
+        var _a;
+        return undefined !== ((_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.tileCacheCredentials);
+    }
+    /** Whether to restrict tile cache URLs by client IP address.
+     * @internal
+     */
+    static get restrictTileUrlsByClientIp() { return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false); }
+    /** Whether to compress cached tiles.
+     * @internal
+     */
+    static get compressCachedTiles() { var _a; return false !== ((_a = IModelHost.configuration) === null || _a === void 0 ? void 0 : _a.compressCachedTiles); }
+    static setupTileCache() {
+        const config = IModelHost.configuration;
+        const credentials = config.tileCacheCredentials;
+        if (undefined === credentials)
+            return;
+        IModelHost.tileUploader = new CloudStorageBackend_1.CloudStorageTileUploader();
+        if (credentials.service === "azure" && !IModelHost.tileCacheService) {
+            IModelHost.tileCacheService = new CloudStorageBackend_1.AzureBlobStorage(credentials);
+        }
+        else if (credentials.service === "alicloud") {
+            IModelHost.tileCacheService = new AliCloudStorageService_1.AliCloudStorageService(credentials);
+        }
+        else if (credentials.service !== "external") {
+            throw new core_common_1.IModelError(core_common_1.BentleyStatus.ERROR, "Unsupported cloud service credentials for tile cache.");
+        }
+    }
+}
+exports.IModelHost = IModelHost;
+/** @alpha */
+IModelHost.telemetry = new telemetry_client_1.TelemetryManager();
+IModelHost.backendVersion = "";
+IModelHost._cacheDir = "";
+/** Event raised just after the backend IModelHost was started */
+IModelHost.onAfterStartup = new core_bentley_1.BeEvent();
+/** Event raised just before the backend IModelHost is to be shut down */
+IModelHost.onBeforeShutdown = new core_bentley_1.BeEvent();
+/** @internal */
+IModelHost.session = { applicationId: "2686", applicationVersion: "1.0.0", sessionId: "" };
+IModelHost._isValid = false;
+/** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].
+ * @public
+ */
+class Platform {
+    /** Get the name of the platform. */
+    static get platformName() {
+        return process.platform;
+    }
+    /** @internal */
+    static load() {
+        return core_bentley_1.ProcessDetector.isMobileAppBackend ? process._linkedBinding("iModelJsNative") : imodeljs_native_1.NativeLibrary.load();
+    }
+}
+exports.Platform = Platform;
+/** Well known directories that may be used by the application. Also see [[Platform]]
+ * @public
+ */
+class KnownLocations {
+    /** The directory where the imodeljs-native assets are stored. */
+    static get nativeAssetsDir() { return IModelHost.platform.DgnDb.getAssetsDir(); }
+    /** The directory where the core-backend assets are stored. */
+    static get packageAssetsDir() {
+        return path.join(__dirname, "assets");
+    }
+    /** The temporary directory. */
+    static get tmpdir() {
+        return os.tmpdir();
+    }
+}
+exports.KnownLocations = KnownLocations;
+/** Extend this class to provide custom file name resolution behavior.
+ * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.
+ * @see [[IModelHost.snapshotFileNameResolver]]
+ * @public
+ */
+class FileNameResolver {
+    /** Resolve a file name from the specified key.
+     * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.
+     * @returns The resolved file name or `undefined` if not found.
+     */
+    tryResolveKey(_fileKey) { return undefined; }
+    /** Resolve a file name from the specified key.
+     * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.
+     * @returns The resolved file name.
+     * @throws [[IModelError]] if not found.
+     */
+    resolveKey(fileKey) {
+        const resolvedFileName = this.tryResolveKey(fileKey);
+        if (undefined === resolvedFileName) {
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `${fileKey} not resolved`);
+        }
+        return resolvedFileName;
+    }
+    /** Resolve the input file name, which may be a partial name, into a full path file name.
+     * @param inFileName The partial file name.
+     * @returns The resolved full path file name or `undefined` if not found.
+     */
+    tryResolveFileName(inFileName) { return inFileName; }
+    /** Resolve the input file name, which may be a partial name, into a full path file name.
+     * @param inFileName The partial file name.
+     * @returns The resolved full path file name.
+     * @throws [[IModelError]] if not found.
+     */
+    resolveFileName(inFileName) {
+        const resolvedFileName = this.tryResolveFileName(inFileName);
+        if (undefined === resolvedFileName) {
+            throw new core_common_1.IModelError(core_bentley_1.IModelStatus.NotFound, `${inFileName} not resolved`);
+        }
+        return resolvedFileName;
+    }
+}
+exports.FileNameResolver = FileNameResolver;
+//# sourceMappingURL=IModelHost.js.map

package/lib/cjs/IModelHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IModelHost.js","sourceRoot":"","sources":["../../src/IModelHost.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 IModelHost\r\n */\r\n\r\nimport * as os from \"os\";\r\nimport * as path from \"path\";\r\nimport * as semver from \"semver\";\r\nimport { IModelJsNative, NativeLibrary } from \"@bentley/imodeljs-native\";\r\nimport { TelemetryManager } from \"@bentley/telemetry-client\";\r\nimport { AccessToken, assert, BeEvent, Guid, GuidString, IModelStatus, Logger, LogLevel, Mutable, ProcessDetector } from \"@itwin/core-bentley\";\r\nimport { AuthorizationClient, BentleyStatus, IModelError, SessionProps } from \"@itwin/core-common\";\r\nimport { AliCloudStorageService } from \"./AliCloudStorageService\";\r\nimport { BackendHubAccess } from \"./BackendHubAccess\";\r\nimport { BackendLoggerCategory } from \"./BackendLoggerCategory\";\r\nimport { BisCoreSchema } from \"./BisCoreSchema\";\r\nimport { BriefcaseManager } from \"./BriefcaseManager\";\r\nimport { AzureBlobStorage, CloudStorageService, CloudStorageServiceCredentials, CloudStorageTileUploader } from \"./CloudStorageBackend\";\r\nimport { FunctionalSchema } from \"./domains/FunctionalSchema\";\r\nimport { GenericSchema } from \"./domains/GenericSchema\";\r\nimport { IModelJsFs } from \"./IModelJsFs\";\r\nimport { DevToolsRpcImpl } from \"./rpc-impl/DevToolsRpcImpl\";\r\nimport { IModelReadRpcImpl } from \"./rpc-impl/IModelReadRpcImpl\";\r\nimport { IModelTileRpcImpl } from \"./rpc-impl/IModelTileRpcImpl\";\r\nimport { SnapshotIModelRpcImpl } from \"./rpc-impl/SnapshotIModelRpcImpl\";\r\nimport { WipRpcImpl } from \"./rpc-impl/WipRpcImpl\";\r\nimport { initializeRpcBackend } from \"./RpcBackend\";\r\n\r\nconst loggerCategory = BackendLoggerCategory.IModelHost;\r\n\r\n// cspell:ignore nodereport fatalerror apicall alicloud rpcs\r\n\r\n/** @alpha */\r\nexport interface CrashReportingConfigNameValuePair {\r\n  name: string;\r\n  value: string;\r\n}\r\n\r\n/** Configuration of the crash-reporting system.\r\n * @alpha\r\n */\r\nexport interface CrashReportingConfig {\r\n  /** The directory to which *.dmp and/or iModelJsNativeCrash*.properties.txt files are written. This directory will be created if it does not already exist. */\r\n  crashDir: string;\r\n  /** max # .dmp files that may exist in crashDir. The default is 50. */\r\n  maxDumpsInDir?: number;\r\n  /** Enable crash-dumps? If so, .dmp and .properties.txt files will be generated and written to crashDir in the event of an unhandled native-code exception. If not, only .properties.txt files will be written. The default is false. */\r\n  enableCrashDumps?: boolean;\r\n  /** If enableCrashDumps is true, do you want a full-memory dump? Defaults to false. */\r\n  wantFullMemoryDumps?: boolean;\r\n  /** Enable node-report? If so, node-report files will be generated in the event of an unhandled exception or fatal error and written to crashDir. The default is false. */\r\n  enableNodeReport?: boolean;\r\n  /** Additional name, value pairs to write to iModelJsNativeCrash*.properties.txt file in the event of a crash. */\r\n  params?: CrashReportingConfigNameValuePair[];\r\n  /** Run this .js file to process .dmp and node-report files in the event of a crash.\r\n   * This script will be executed with a single command-line parameter: the name of the dump or node-report file.\r\n   * In the case of a dump file, there will be a second file with the same basename and the extension \".properties.txt\".\r\n   * Since it runs in a separate process, this script will have no access to the Javascript\r\n   * context of the exiting backend. No default.\r\n   */\r\n  dumpProcessorScriptFileName?: string;\r\n  /** Upload crash dump and node-reports to Bentley's crash-reporting service? Defaults to false */\r\n  uploadToBentley?: boolean;\r\n}\r\n\r\n/** Configuration of core-backend.\r\n * @public\r\n */\r\nexport class IModelHostConfiguration {\r\n\r\n  /**\r\n   * Root of the directory holding all the files that iModel.js caches\r\n   * - If not specified at startup a platform specific default is used -\r\n   *   - Windows: $(HOMEDIR)/AppData/Local/iModelJs/\r\n   *   - Mac/iOS: $(HOMEDIR)/Library/Caches/iModelJs/\r\n   *   - Linux:   $(HOMEDIR)/.cache/iModelJs/\r\n   *   where $(HOMEDIR) is documented [here](https://nodejs.org/api/os.html#os_os_homedir)\r\n   * - if specified, ensure it is set to a folder with read/write access.\r\n   * - Sub-folders within this folder organize various caches -\r\n   *   - bc/ -> Briefcases\r\n   *   - appSettings/ -> Offline application settings (only relevant in native applications)\r\n   *   - etc.\r\n   * @see [[IModelHost.cacheDir]] for the value it's set to after startup\r\n   */\r\n  public cacheDir?: string;\r\n\r\n  /** The directory where the app's assets are found. */\r\n  public appAssetsDir?: string;\r\n\r\n  /** The kind of iModel hub server to use.\r\n   * @beta\r\n   */\r\n  public hubAccess?: BackendHubAccess;\r\n\r\n  /** The credentials to use for the tile cache service. If omitted, a local cache will be used.\r\n   * @beta\r\n   */\r\n  public tileCacheCredentials?: CloudStorageServiceCredentials;\r\n\r\n  /** Whether to restrict tile cache URLs by client IP address (if available).\r\n   * @beta\r\n   */\r\n  public restrictTileUrlsByClientIp?: boolean;\r\n\r\n  /** Whether to compress cached tiles.\r\n   * Defaults to `true`.\r\n   */\r\n  public compressCachedTiles?: boolean;\r\n\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public tileTreeRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public tileContentRequestTimeout = IModelHostConfiguration.defaultTileRequestTimeout;\r\n  /** The default time, in milliseconds, used for [[tileTreeRequestTimeout]] and [[tileContentRequestTimeout]]. To change this, override one or both of those properties.\r\n   * @internal\r\n   */\r\n  public static defaultTileRequestTimeout = 20 * 1000;\r\n\r\n  /** The default time, in seconds, used for [[logTileLoadTimeThreshold]]. To change this, override that property.\r\n   * @internal\r\n   */\r\n  public static defaultLogTileLoadTimeThreshold = 40;\r\n  /** The backend will log when a tile took longer to load than this threshold in seconds.\r\n   * @internal\r\n   */\r\n  public logTileLoadTimeThreshold: number = IModelHostConfiguration.defaultLogTileLoadTimeThreshold;\r\n\r\n  /** The default size, in bytes, used for [[logTileSizeThreshold]]. To change this, override that property.\r\n   * @internal\r\n   */\r\n  public static defaultLogTileSizeThreshold = 20 * 1000000;\r\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold.\r\n   * @internal\r\n   */\r\n  public logTileSizeThreshold: number = IModelHostConfiguration.defaultLogTileSizeThreshold;\r\n\r\n  /** Crash-reporting configuration\r\n   * @alpha\r\n   */\r\n  public crashReportingConfig?: CrashReportingConfig;\r\n\r\n}\r\n\r\n/** IModelHost initializes ($backend) and captures its configuration. A backend must call [[IModelHost.startup]] before using any backend classes.\r\n * See [the learning article]($docs/learning/backend/IModelHost.md)\r\n * @public\r\n */\r\nexport class IModelHost {\r\n  private constructor() { }\r\n  public static authorizationClient?: AuthorizationClient;\r\n\r\n  /** @alpha */\r\n  public static readonly telemetry = new TelemetryManager();\r\n\r\n  public static backendVersion = \"\";\r\n  private static _cacheDir = \"\";\r\n\r\n  private static _platform?: typeof IModelJsNative;\r\n  /** @internal */\r\n  public static get platform(): typeof IModelJsNative {\r\n    if (this._platform === undefined)\r\n      throw new Error(\"IModelHost.startup must be called first\");\r\n    return this._platform;\r\n  }\r\n\r\n  public static configuration?: IModelHostConfiguration;\r\n  /** Event raised just after the backend IModelHost was started */\r\n  public static readonly onAfterStartup = new BeEvent<() => void>();\r\n\r\n  /** Event raised just before the backend IModelHost is to be shut down */\r\n  public static readonly onBeforeShutdown = new BeEvent<() => void>();\r\n\r\n  /** @internal */\r\n  public static readonly session: Mutable<SessionProps> = { applicationId: \"2686\", applicationVersion: \"1.0.0\", sessionId: \"\" };\r\n\r\n  /** A uniqueId for this session */\r\n  public static get sessionId() { return this.session.sessionId; }\r\n  public static set sessionId(id: GuidString) { this.session.sessionId = id; }\r\n\r\n  /** The Id of this application - needs to be set only if it is an agent application. The applicationId will otherwise originate at the frontend. */\r\n  public static get applicationId() { return this.session.applicationId; }\r\n  public static set applicationId(id: string) { this.session.applicationId = id; }\r\n\r\n  /** The version of this application - needs to be set if is an agent application. The applicationVersion will otherwise originate at the frontend. */\r\n  public static get applicationVersion() { return this.session.applicationVersion; }\r\n  public static set applicationVersion(version: string) { this.session.applicationVersion = version; }\r\n\r\n  /** Root of the directory holding all the files that iModel.js caches */\r\n  public static get cacheDir(): string { return this._cacheDir; }\r\n\r\n  /** The optional [[FileNameResolver]] that resolves keys and partial file names for snapshot iModels. */\r\n  public static snapshotFileNameResolver?: FileNameResolver;\r\n\r\n  /** Get the current access token for this IModelHost, or a blank string if none is available.\r\n   * @note for web backends, this will *always* return a blank string because the backend itself has no token (but never needs one either.)\r\n   * For all IpcHosts, where this backend is servicing a single frontend, this will be the user's token. For ElectronHost, the backend\r\n   * obtains the token and forwards it to the frontend.\r\n   * @note accessTokens expire periodically and are automatically refreshed, if possible. Therefore tokens should not be saved, and the value\r\n   * returned by this method may change over time throughout the course of a session.\r\n   */\r\n  public static async getAccessToken(): Promise<AccessToken> {\r\n    try {\r\n      return (await this.authorizationClient?.getAccessToken()) ?? \"\";\r\n    } catch (e) {\r\n      return \"\";\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  public static flushLog() {\r\n    return this.platform.DgnDb.flushLog();\r\n  }\r\n  /** @internal */\r\n  public static loadNative(): void {\r\n    const platform = Platform.load();\r\n    this.registerPlatform(platform);\r\n  }\r\n\r\n  private static registerPlatform(platform: typeof IModelJsNative): void {\r\n    this._platform = platform;\r\n    if (undefined === platform)\r\n      return;\r\n\r\n    if (!ProcessDetector.isMobileAppBackend)\r\n      this.validateNativePlatformVersion();\r\n\r\n    platform.logger = Logger;\r\n  }\r\n\r\n  private static validateNativePlatformVersion(): void {\r\n    const requiredVersion = require(\"../../package.json\").dependencies[\"@bentley/imodeljs-native\"]; // eslint-disable-line @typescript-eslint/no-var-requires\r\n    const thisVersion = this.platform.version;\r\n    if (semver.satisfies(thisVersion, requiredVersion))\r\n      return;\r\n    if (IModelJsFs.existsSync(path.join(__dirname, \"DevBuild.txt\"))) {\r\n      console.log(\"Bypassing version checks for development build\"); // eslint-disable-line no-console\r\n      return;\r\n    }\r\n    this._platform = undefined;\r\n    throw new IModelError(IModelStatus.BadRequest, `imodeljs-native version is (${thisVersion}). core-backend requires version (${requiredVersion})`);\r\n  }\r\n\r\n  /**\r\n   * @beta\r\n   * @note A reference implementation is set by default for [AzureBlobStorage]. To supply a different implementation for any service provider (such as AWS),\r\n   *       set this property with a custom [CloudStorageService] and also set [IModelHostConfiguration.tileCacheCredentials] using \"external\" for the service name.\r\n   *       Note that the account and access key members of [CloudStorageServiceCredentials] may have blank values unless the custom service implementation uses them.\r\n   */\r\n  public static tileCacheService: CloudStorageService;\r\n\r\n  /** @internal */\r\n  public static tileUploader: CloudStorageTileUploader;\r\n\r\n  private static _hubAccess: BackendHubAccess;\r\n  /** @internal */\r\n  public static setHubAccess(hubAccess: BackendHubAccess) { this._hubAccess = hubAccess; }\r\n\r\n  /** Provides access to the IModelHub for this IModelHost\r\n   * @beta\r\n   */\r\n  public static get hubAccess(): BackendHubAccess { return this._hubAccess; }\r\n\r\n  private static _isValid = false;\r\n  /** Returns true if IModelHost is started.  */\r\n  public static get isValid() { return this._isValid; }\r\n  /** This method must be called before any iModel.js services are used.\r\n   * @param configuration Host configuration data.\r\n   * Raises [[onAfterStartup]].\r\n   * @see [[shutdown]].\r\n   */\r\n  public static async startup(configuration: IModelHostConfiguration = new IModelHostConfiguration()): Promise<void> {\r\n    if (this._isValid)\r\n      return; // we're already initialized\r\n    this._isValid = true;\r\n\r\n    if (IModelHost.sessionId === \"\")\r\n      IModelHost.sessionId = Guid.createValue();\r\n\r\n    this.logStartup();\r\n\r\n    this.backendVersion = require(\"../../package.json\").version; // eslint-disable-line @typescript-eslint/no-var-requires\r\n    initializeRpcBackend();\r\n\r\n    if (this._platform === undefined) {\r\n      try {\r\n        this.loadNative();\r\n      } catch (error) {\r\n        Logger.logError(loggerCategory, \"Error registering/loading the native platform API\", () => (configuration));\r\n        throw error;\r\n      }\r\n    }\r\n\r\n    if (configuration.crashReportingConfig && configuration.crashReportingConfig.crashDir && !ProcessDetector.isElectronAppBackend && !ProcessDetector.isMobileAppBackend) {\r\n      this.platform.setCrashReporting(configuration.crashReportingConfig);\r\n\r\n      Logger.logTrace(loggerCategory, \"Configured crash reporting\", () => ({\r\n        enableCrashDumps: configuration.crashReportingConfig?.enableCrashDumps,\r\n        wantFullMemoryDumps: configuration.crashReportingConfig?.wantFullMemoryDumps,\r\n        enableNodeReport: configuration.crashReportingConfig?.enableNodeReport,\r\n        uploadToBentley: configuration.crashReportingConfig?.uploadToBentley,\r\n      }));\r\n\r\n      if (configuration.crashReportingConfig.enableNodeReport) {\r\n        try {\r\n          // node-report reports on V8 fatal errors and unhandled exceptions/Promise rejections.\r\n          const nodereport = require(\"node-report/api\"); // eslint-disable-line @typescript-eslint/no-var-requires\r\n          nodereport.setEvents(\"exception+fatalerror+apicall\");\r\n          nodereport.setDirectory(configuration.crashReportingConfig.crashDir);\r\n          nodereport.setVerbose(\"yes\");\r\n          Logger.logTrace(loggerCategory, \"Configured native crash reporting (node-report)\");\r\n        } catch (err) {\r\n          Logger.logWarning(loggerCategory, \"node-report is not installed.\");\r\n        }\r\n      }\r\n    }\r\n\r\n    this.setupCacheDirs(configuration);\r\n    BriefcaseManager.initialize(this._briefcaseCacheDir);\r\n\r\n    [\r\n      IModelReadRpcImpl,\r\n      IModelTileRpcImpl,\r\n      SnapshotIModelRpcImpl,\r\n      WipRpcImpl,\r\n      DevToolsRpcImpl,\r\n    ].forEach((rpc) => rpc.register()); // register all of the RPC implementations\r\n\r\n    [\r\n      BisCoreSchema,\r\n      GenericSchema,\r\n      FunctionalSchema,\r\n    ].forEach((schema) => schema.registerSchema()); // register all of the schemas\r\n\r\n    if (undefined !== configuration.hubAccess)\r\n      IModelHost._hubAccess = configuration.hubAccess;\r\n    IModelHost.configuration = configuration;\r\n    IModelHost.setupTileCache();\r\n\r\n    this.platform.setUseTileCache(configuration.tileCacheCredentials ? false : true);\r\n\r\n    process.once(\"beforeExit\", IModelHost.shutdown);\r\n    IModelHost.onAfterStartup.raiseEvent();\r\n  }\r\n\r\n  private static _briefcaseCacheDir: string;\r\n\r\n  private static logStartup() {\r\n    if (!Logger.isEnabled(loggerCategory, LogLevel.Trace))\r\n      return;\r\n\r\n    // Extract the iModel details from environment - note this is very specific to Bentley hosted backends, but is quite useful for tracing\r\n    let startupInfo: any = {};\r\n    const serviceName = process.env.FABRIC_SERVICE_NAME;\r\n    if (serviceName) {\r\n      // e.g., fabric:/iModelWebViewer3.0/iModelJSGuest/1/08daaeb3-b56f-480b-9051-7efc834d18ae/512d971d-b641-4735-bb1c-c07ab3e44ce7/c1315fcce125ca40b2d405bb7809214daf8b4c85\r\n      const serviceNameComponents = serviceName.split(\"/\");\r\n      if (serviceNameComponents.length === 7) {\r\n        startupInfo = {\r\n          ...startupInfo,\r\n          iTwinId: serviceNameComponents[4],\r\n          iModelId: serviceNameComponents[5],\r\n          changesetId: serviceNameComponents[6],\r\n        };\r\n      }\r\n    }\r\n\r\n    Logger.logTrace(loggerCategory, \"IModelHost.startup\", () => startupInfo);\r\n  }\r\n\r\n  private static setupCacheDirs(configuration: IModelHostConfiguration) {\r\n    this._cacheDir = configuration.cacheDir ? path.normalize(configuration.cacheDir) : NativeLibrary.defaultCacheDir;\r\n    IModelJsFs.recursiveMkDirSync(this._cacheDir); // make sure the directory for cacheDir exists.\r\n    this._briefcaseCacheDir = path.join(this._cacheDir, \"imodels\");\r\n  }\r\n\r\n  /** This method must be called when an iModel.js services is shut down. Raises [[onBeforeShutdown]] */\r\n  public static async shutdown(): Promise<void> {\r\n    // NB: This method is set as a node listener where `this` is unbound\r\n    if (!IModelHost._isValid)\r\n      return;\r\n\r\n    IModelHost._isValid = false;\r\n    IModelHost.onBeforeShutdown.raiseEvent();\r\n    IModelHost.configuration = undefined;\r\n    process.removeListener(\"beforeExit\", IModelHost.shutdown);\r\n  }\r\n\r\n  /**\r\n   * Add or update a property that should be included in a crash report.\r\n   * @param name The name of the property\r\n   * @param value The value of the property\r\n   * @alpha\r\n   */\r\n  public static setCrashReportProperty(name: string, value: string): void {\r\n    assert(undefined !== this._platform);\r\n    this._platform.setCrashReportProperty(name, value);\r\n  }\r\n\r\n  /**\r\n   * Remove a previously defined property so that will not be included in a crash report.\r\n   * @param name The name of the property\r\n   * @alpha\r\n   */\r\n  public static removeCrashReportProperty(name: string): void {\r\n    assert(undefined !== this._platform);\r\n    this._platform.setCrashReportProperty(name, undefined);\r\n  }\r\n\r\n  /**\r\n   * Get all properties that will be included in a crash report.\r\n   * @alpha\r\n   */\r\n  public static getCrashReportProperties(): CrashReportingConfigNameValuePair[] {\r\n    assert(undefined !== this._platform);\r\n    return this._platform.getCrashReportProperties();\r\n  }\r\n\r\n  /** The directory where application assets may be found */\r\n  public static get appAssetsDir(): string | undefined { return undefined !== IModelHost.configuration ? IModelHost.configuration.appAssetsDir : undefined; }\r\n\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileTreeProps]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public static get tileTreeRequestTimeout(): number {\r\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.tileTreeRequestTimeout : IModelHostConfiguration.defaultTileRequestTimeout;\r\n  }\r\n  /** The time, in milliseconds, for which [IModelTileRpcInterface.requestTileContent]($common) should wait before returning a \"pending\" status.\r\n   * @internal\r\n   */\r\n  public static get tileContentRequestTimeout(): number {\r\n    return undefined !== IModelHost.configuration ? IModelHost.configuration.tileContentRequestTimeout : IModelHostConfiguration.defaultTileRequestTimeout;\r\n  }\r\n\r\n  /** The backend will log when a tile took longer to load than this threshold in seconds. */\r\n  public static get logTileLoadTimeThreshold(): number { return undefined !== IModelHost.configuration ? IModelHost.configuration.logTileLoadTimeThreshold : IModelHostConfiguration.defaultLogTileLoadTimeThreshold; }\r\n  /** The backend will log when a tile is loaded with a size in bytes above this threshold. */\r\n  public static get logTileSizeThreshold(): number { return undefined !== IModelHost.configuration ? IModelHost.configuration.logTileSizeThreshold : IModelHostConfiguration.defaultLogTileSizeThreshold; }\r\n\r\n  /** Whether external tile caching is active.\r\n   * @internal\r\n   */\r\n  public static get usingExternalTileCache(): boolean {\r\n    return undefined !== IModelHost.configuration?.tileCacheCredentials;\r\n  }\r\n\r\n  /** Whether to restrict tile cache URLs by client IP address.\r\n   * @internal\r\n   */\r\n  public static get restrictTileUrlsByClientIp(): boolean { return undefined !== IModelHost.configuration && (IModelHost.configuration.restrictTileUrlsByClientIp ? true : false); }\r\n\r\n  /** Whether to compress cached tiles.\r\n   * @internal\r\n   */\r\n  public static get compressCachedTiles(): boolean { return false !== IModelHost.configuration?.compressCachedTiles; }\r\n\r\n  private static setupTileCache() {\r\n    const config = IModelHost.configuration!;\r\n    const credentials = config.tileCacheCredentials;\r\n    if (undefined === credentials)\r\n      return;\r\n\r\n    IModelHost.tileUploader = new CloudStorageTileUploader();\r\n\r\n    if (credentials.service === \"azure\" && !IModelHost.tileCacheService) {\r\n      IModelHost.tileCacheService = new AzureBlobStorage(credentials);\r\n    } else if (credentials.service === \"alicloud\") {\r\n      IModelHost.tileCacheService = new AliCloudStorageService(credentials);\r\n    } else if (credentials.service !== \"external\") {\r\n      throw new IModelError(BentleyStatus.ERROR, \"Unsupported cloud service credentials for tile cache.\");\r\n    }\r\n  }\r\n}\r\n\r\n/** Information about the platform on which the app is running. Also see [[KnownLocations]] and [[IModelJsFs]].\r\n * @public\r\n */\r\nexport class Platform {\r\n  /** Get the name of the platform. */\r\n  public static get platformName(): \"win32\" | \"linux\" | \"darwin\" | \"ios\" | \"android\" | \"uwp\" {\r\n    return process.platform as any;\r\n  }\r\n\r\n  /** @internal */\r\n  public static load(): typeof IModelJsNative {\r\n    return ProcessDetector.isMobileAppBackend ? (process as any)._linkedBinding(\"iModelJsNative\") : NativeLibrary.load();\r\n  }\r\n}\r\n\r\n/** Well known directories that may be used by the application. Also see [[Platform]]\r\n * @public\r\n */\r\nexport class KnownLocations {\r\n\r\n  /** The directory where the imodeljs-native assets are stored. */\r\n  public static get nativeAssetsDir(): string { return IModelHost.platform.DgnDb.getAssetsDir(); }\r\n\r\n  /** The directory where the core-backend assets are stored. */\r\n  public static get packageAssetsDir(): string {\r\n    return path.join(__dirname, \"assets\");\r\n  }\r\n\r\n  /** The temporary directory. */\r\n  public static get tmpdir(): string {\r\n    return os.tmpdir();\r\n  }\r\n}\r\n\r\n/** Extend this class to provide custom file name resolution behavior.\r\n * @note Only `tryResolveKey` and/or `tryResolveFileName` need to be overridden as the implementations of `resolveKey` and `resolveFileName` work for most purposes.\r\n * @see [[IModelHost.snapshotFileNameResolver]]\r\n * @public\r\n */\r\nexport abstract class FileNameResolver {\r\n  /** Resolve a file name from the specified key.\r\n   * @param _fileKey The key that identifies the file name in a `Map` or other similar data structure.\r\n   * @returns The resolved file name or `undefined` if not found.\r\n   */\r\n  public tryResolveKey(_fileKey: string): string | undefined { return undefined; }\r\n  /** Resolve a file name from the specified key.\r\n   * @param fileKey The key that identifies the file name in a `Map` or other similar data structure.\r\n   * @returns The resolved file name.\r\n   * @throws [[IModelError]] if not found.\r\n   */\r\n  public resolveKey(fileKey: string): string {\r\n    const resolvedFileName: string | undefined = this.tryResolveKey(fileKey);\r\n    if (undefined === resolvedFileName) {\r\n      throw new IModelError(IModelStatus.NotFound, `${fileKey} not resolved`);\r\n    }\r\n    return resolvedFileName;\r\n  }\r\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\r\n   * @param inFileName The partial file name.\r\n   * @returns The resolved full path file name or `undefined` if not found.\r\n   */\r\n  public tryResolveFileName(inFileName: string): string | undefined { return inFileName; }\r\n  /** Resolve the input file name, which may be a partial name, into a full path file name.\r\n   * @param inFileName The partial file name.\r\n   * @returns The resolved full path file name.\r\n   * @throws [[IModelError]] if not found.\r\n   */\r\n  public resolveFileName(inFileName: string): string {\r\n    const resolvedFileName: string | undefined = this.tryResolveFileName(inFileName);\r\n    if (undefined === resolvedFileName) {\r\n      throw new IModelError(IModelStatus.NotFound, `${inFileName} not resolved`);\r\n    }\r\n    return resolvedFileName;\r\n  }\r\n}\r\n"]}

package/lib/cjs/IModelJsFs.d.ts

@@ -0,0 +1,63 @@
+/// <reference types="node" />
+/** Information about a file. See [[IModelJsFs.lstatSync]]
+ * @public
+ */
+export declare class IModelJsFsStats {
+    size: number;
+    atimeMs: number;
+    mtimeMs: number;
+    birthtimeMs: number;
+    isDirectory: boolean;
+    isFile: boolean;
+    isSocket: boolean;
+    isSymbolicLink: boolean;
+    isReadOnly: boolean;
+    constructor(size: number, atimeMs: number, mtimeMs: number, birthtimeMs: number, isDirectory: boolean, isFile: boolean, isSocket: boolean, isSymbolicLink: boolean, isReadOnly: boolean);
+}
+/** File system operations that are defined on all platforms. See also [[Platform]] and [[KnownLocations]]
+ * @public
+ */
+export declare class IModelJsFs {
+    /** Does file or directory exist? */
+    static existsSync(pathname: string): boolean;
+    /** Delete a file. */
+    static unlinkSync(pathname: string): void;
+    /** Delete a file or remove a directory (rm -r). */
+    static removeSync(pathname: string): void;
+    /** Create a directory. */
+    static mkdirSync(pathname: string): void;
+    /** Remove a directory. */
+    static rmdirSync(pathname: string): void;
+    /** Write to a file. */
+    static writeFileSync(pathname: string, data: string | Uint8Array, wflag?: string): void;
+    /** Append to a file. */
+    static appendFileSync(pathname: string, str: string): void;
+    /** Make a copy of a file */
+    static copySync(src: string, dest: string, opts?: any): void;
+    /** Get the file and directory names in the specified directory. Excludes "." and "..". */
+    static readdirSync(pathname: string): string[];
+    /** Read file */
+    static readFileSync(pathname: string): string | Buffer;
+    /** Test if the current user has permission to write to a file. */
+    private static isFileWritable;
+    /** Get information about a file. */
+    static lstatSync(pathname: string): IModelJsFsStats | undefined;
+    /**
+     * Finds files recursively based on a pattern
+     * @param rootDir Directory from where to start searching for files.
+     * @param pattern A Regex that would be match to basename of files including extension
+     * @returns list of file that match the pattern.
+     */
+    static recursiveFindSync(rootDir: string, pattern: RegExp): string[];
+    /**
+     * Walks a directory in breadth first fashion
+     * @param rootDir  directory from where the traversal starts
+     * @param cb callback that would be called with full path of file or directory
+     */
+    static walkDirSync(rootDir: string, cb: (pathname: string, isDir: boolean) => boolean): void;
+    /** Create a directory, recursively setting up the path as necessary */
+    static recursiveMkDirSync(dirPath: string): void;
+    /** Remove a directory, recursively */
+    static purgeDirSync(dirPath: string): void;
+}
+//# sourceMappingURL=IModelJsFs.d.ts.map

package/lib/cjs/IModelJsFs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IModelJsFs.d.ts","sourceRoot":"","sources":["../../src/IModelJsFs.ts"],"names":[],"mappings":";AAeA;;GAEG;AACH,qBAAa,eAAe;IAEjB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,MAAM;IACnB,WAAW,EAAE,OAAO;IACpB,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,OAAO;IACjB,cAAc,EAAE,OAAO;IACvB,UAAU,EAAE,OAAO;gBARnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,OAAO,EACjB,cAAc,EAAE,OAAO,EACvB,UAAU,EAAE,OAAO;CAE7B;AAED;;GAEG;AACH,qBAAa,UAAU;IAErB,oCAAoC;WACtB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAEnD,qBAAqB;WACP,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAEhD,mDAAmD;WACrC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAEhD,0BAA0B;WACZ,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAE/C,0BAA0B;WACZ,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAE/C,uBAAuB;WACT,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,KAAK,GAAE,MAAY,GAAG,IAAI;IAEnG,wBAAwB;WACV,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAEjE,4BAA4B;WACd,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAEnE,0FAA0F;WAC5E,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAErD,gBAAgB;WACF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAE7D,kEAAkE;IAClE,OAAO,CAAC,MAAM,CAAC,cAAc;IAS7B,oCAAoC;WACtB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAiBtE;;;;;OAKG;WACW,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAc3E;;;;OAIG;WACW,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI;IAkBnG,uEAAuE;WACzD,kBAAkB,CAAC,OAAO,EAAE,MAAM;IAShD,sCAAsC;WACxB,YAAY,CAAC,OAAO,EAAE,MAAM;CAc3C"}