@harperfast/harper 5.0.0-alpha.10

package/dist/components/Application.js

@@ -0,0 +1,509 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Application = exports.InvalidInstallTimeoutError = exports.InvalidInstallCommandError = exports.InvalidInstallPropertyError = exports.InvalidPackageIdentifierError = void 0;
+exports.assertApplicationConfig = assertApplicationConfig;
+exports.extractApplication = extractApplication;
+exports.installApplication = installApplication;
+exports.derivePackageIdentifier = derivePackageIdentifier;
+exports.prepareApplication = prepareApplication;
+exports.installApplications = installApplications;
+exports.nonInteractiveSpawn = nonInteractiveSpawn;
+exports.getEnvBuiltInComponents = getEnvBuiltInComponents;
+const configUtils_js_1 = require("../config/configUtils.js");
+const hdbTerms_js_1 = require("../utility/hdbTerms.js");
+const harper_logger_js_1 = __importDefault(require("../utility/logging/harper_logger.js"));
+const node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_stream_1 = require("node:stream");
+const promises_2 = require("node:stream/promises");
+const tar_fs_1 = require("tar-fs");
+const gunzip_maybe_1 = __importDefault(require("gunzip-maybe"));
+class InvalidPackageIdentifierError extends TypeError {
+    constructor(applicationName, packageIdentifier) {
+        super(`Invalid 'package' property for application ${applicationName}: expected string, got ${typeof packageIdentifier}`);
+    }
+}
+exports.InvalidPackageIdentifierError = InvalidPackageIdentifierError;
+class InvalidInstallPropertyError extends TypeError {
+    constructor(applicationName, installProperty) {
+        super(`Invalid 'install' property for application ${applicationName}: expected object, got ${typeof installProperty}`);
+    }
+}
+exports.InvalidInstallPropertyError = InvalidInstallPropertyError;
+class InvalidInstallCommandError extends TypeError {
+    constructor(applicationName, command) {
+        super(`Invalid 'install.command' property for application ${applicationName}: expected string, got ${typeof command}`);
+    }
+}
+exports.InvalidInstallCommandError = InvalidInstallCommandError;
+class InvalidInstallTimeoutError extends TypeError {
+    constructor(applicationName, timeout) {
+        super(`Invalid 'install.timeout' property for application ${applicationName}: expected non-negative number, got ${typeof timeout}`);
+    }
+}
+exports.InvalidInstallTimeoutError = InvalidInstallTimeoutError;
+function assertApplicationConfig(applicationName, applicationConfig) {
+    if (typeof applicationConfig.package !== 'string') {
+        throw new InvalidPackageIdentifierError(applicationName, applicationConfig.package);
+    }
+    if ('install' in applicationConfig) {
+        if (typeof applicationConfig.install !== 'object' ||
+            applicationConfig.install === null ||
+            Array.isArray(applicationConfig.install)) {
+            throw new InvalidInstallPropertyError(applicationName, applicationConfig.install);
+        }
+        if ('command' in applicationConfig.install && typeof applicationConfig.install.command !== 'string') {
+            throw new InvalidInstallCommandError(applicationName, applicationConfig.install.command);
+        }
+        if ('timeout' in applicationConfig.install &&
+            (typeof applicationConfig.install.timeout !== 'number' || applicationConfig.install.timeout < 0)) {
+            throw new InvalidInstallTimeoutError(applicationName, applicationConfig.install.timeout);
+        }
+    }
+}
+/**
+ * Extract an application given payload (content of the application) or package (npm-compatible identifier to the application).
+ *
+ * Only one of `application.payload` or `application.package` should be specified; otherwise, an error is thrown.
+ *
+ * Writes the application to the configured components root directory using the `application.name` and overwrites any existing directory.
+ *
+ * This method should only be called from the main thread
+ */
+async function extractApplication(application) {
+    // Can't specify neither
+    if (!application.payload && !application.packageIdentifier) {
+        throw new Error('Either payload or package must be provided');
+    }
+    // Can't specify both
+    if (application.payload && application.packageIdentifier) {
+        throw new Error('Both payload and package cannot be provided');
+    }
+    // Resolve the tarball from the input
+    let tarballPath;
+    let tarball;
+    if (application.payload) {
+        // Given a payload, create a Readable from the Buffer or string
+        tarball = node_stream_1.Readable.from(application.payload instanceof Buffer ? application.payload : Buffer.from(application.payload, 'base64'));
+    }
+    else {
+        // Given a package, there are a a couple options
+        const parentDirPath = (0, node_path_1.dirname)(application.dirPath);
+        // If the package identifier is a file path we need to check if its a tarball or a directory
+        if (application.packageIdentifier.startsWith('file:')) {
+            const packagePath = application.packageIdentifier.slice(5);
+            try {
+                // Have to remove the 'file:' prefix in order to use fs methods
+                const stats = await (0, promises_1.stat)(packagePath);
+                if (stats.isDirectory()) {
+                    // If its a directory, symlink
+                    await (0, promises_1.symlink)(packagePath, application.dirPath, 'dir');
+                    // And return early since we're done; no extraction needed
+                    return;
+                }
+                if (!stats.isFile()) {
+                    throw new Error(`File path specified in package identifier is not a file or directory: ${packagePath}`);
+                }
+                // If its a file, we assume it can be unzipped and extracted.
+                // We are using maybe-gunzip to handle both gzipped and non-gzipped tarballs
+                // And then we are happy to let the `tar-fs` library handle the extraction.
+                // Maybe worth adding some detection or at least some error handling if that step below fails.
+                tarballPath = packagePath;
+                tarball = (0, node_fs_1.createReadStream)(tarballPath);
+            }
+            catch (err) {
+                if (err.code === 'ENOENT') {
+                    throw new Error(`File path specified in package identifier does not exist: ${packagePath}`);
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        else {
+            // Given a package, resolve using `npm pack` (downloads the package as a tarball and writes the path to stdout)
+            const { stdout: tarballFilePath, code, stderr, } = await nonInteractiveSpawn(application.name, 'npm', ['pack', application.packageIdentifier], parentDirPath);
+            if (code !== 0)
+                throw new Error(`Failed to download package ${application.packageIdentifier}: ${stderr}`);
+            tarballPath = (0, node_path_1.join)(parentDirPath, tarballFilePath.trim());
+            // Create a Readable from the tarball
+            tarball = (0, node_fs_1.createReadStream)(tarballPath);
+        }
+    }
+    // Create the application directory
+    try {
+        await (0, promises_1.access)(application.dirPath, promises_1.constants.F_OK);
+        // directory already exists; clear it
+        await (0, promises_1.rm)(application.dirPath, { recursive: true, force: true });
+    }
+    catch (err) {
+        // Ignore does not exist error
+        if (err.code !== 'ENOENT') {
+            throw err;
+        }
+    }
+    // Finally, create the application directory fresh
+    await (0, promises_1.mkdir)(application.dirPath, { recursive: true });
+    // Now pipeline the tarball into maybe-gunzip then tar-fs to reliably decompress and extract the contents
+    await (0, promises_2.pipeline)(tarball, (0, gunzip_maybe_1.default)(), (0, tar_fs_1.extract)(application.dirPath));
+    // If the extracted directory contains a single folder, move the contents up one level
+    // The `npm pack` command does this (the top-level folder is called "package")
+    // Other packing tools may have similar behavior, but the directory name is not guaranteed.
+    const extracted = await (0, promises_1.readdir)(application.dirPath, { withFileTypes: true });
+    if (extracted.length === 1 && extracted[0].isDirectory()) {
+        const topLevelDirPath = (0, node_path_1.join)(application.dirPath, extracted[0].name);
+        const tempDirPath = await (0, promises_1.mkdtemp)(application.dirPath);
+        // Copy contents of top-level directory to temp directory (in order to avoid collisions of top-level directory name and one of the contents)
+        await (0, promises_1.cp)(topLevelDirPath, tempDirPath, { recursive: true });
+        // Remove top-level directory
+        await (0, promises_1.rm)(topLevelDirPath, { recursive: true, force: true });
+        // Copy contents of temp directory to application directory
+        await (0, promises_1.cp)(tempDirPath, application.dirPath, { recursive: true });
+        // Finally, remove the temp dir
+        await (0, promises_1.rm)(tempDirPath, { recursive: true, force: true });
+    }
+    // Clean up the original tarball
+    if (tarballPath) {
+        await (0, promises_1.rm)(tarballPath, { force: true });
+    }
+}
+/**
+ * Install an application to its relative `application.dirPath` using either a
+ * configured `application.install` command, a derived package manager from the
+ * application's `package.json#devEngines`, or falling back to the default
+ * package manager, `npm`.
+ *
+ * Will return early if `node_modules` already exists within the `application.dirPath`
+ *
+ * This method should only be called from the main thread
+ */
+async function installApplication(application) {
+    let packageJSON;
+    try {
+        packageJSON = JSON.parse(await (0, promises_1.readFile)((0, node_path_1.join)(application.dirPath, 'package.json'), 'utf8'));
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+        // If no package.json, nothing to install
+        application.logger.debug(`Application ${application.name} has no package.json; skipping install`);
+        return;
+    }
+    try {
+        // Does node_modules exist?
+        await (0, promises_1.access)((0, node_path_1.join)(application.dirPath, 'node_modules'), promises_1.constants.F_OK);
+        application.logger.debug(`Application ${application.name} already has node_modules; skipping install`);
+        return;
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+        // If node_modules doesn't exist, we need to install dependencies
+    }
+    // If custom install command is specified, run it
+    if (application.install?.command) {
+        const [command, ...args] = application.install.command.split(' ');
+        const { stdout, stderr, code } = await nonInteractiveSpawn(application.name, command, args, application.dirPath, application.install?.timeout);
+        // if it succeeds, return
+        if (code === 0) {
+            return;
+        }
+        if (stdout) {
+            printStd(application.name, command, stdout, 'stdout', 'warn');
+        }
+        if (stderr) {
+            printStd(application.name, command, stderr, 'stderr', 'warn');
+        }
+        // and throw a descriptive error
+        throw new Error(`Failed to install dependencies for ${application.name} using custom install command: ${application.install.command}. Exit code: ${code}`);
+    }
+    // Next, try package.json devEngines field
+    const { packageManager } = packageJSON.devEngines || {};
+    // Custom package manager specified
+    if (packageManager) {
+        // On any given system we want to leverage the `name` to match the package manager executable
+        let onFail = packageManager.onFail;
+        const validOnFailValues = ['ignore', 'warn', 'error'];
+        if (onFail === 'download') {
+            application.logger.warn('Harper currently does not support `devEngines.packageManager.onFail = "download"`. Defaulting to "error"');
+            onFail = 'error';
+        }
+        else if (onFail && !validOnFailValues.includes(onFail)) {
+            application.logger.error(`Invalid \`devEngines.packageManager.onFail\` value: "${onFail}". Expected one of ${validOnFailValues.map((v) => `"${v}"`).join(', ')}. Defaulting to "error"`);
+            onFail = 'error';
+        }
+        onFail = onFail || 'error';
+        // TODO: Implement a version check / resolution system
+        // For example, say they specify a specific major version for their package manager
+        // Maybe on our system, we have all of the supported majors (for a given Node.js major) of any supported package manager.
+        // Then we can do something like <name>@<version> for the corresponding executable.
+        // `devEngines: { packageManager: { name: 'pnpm', version: '>=7' } }`
+        // Would result in `pnpm@7` being used as the executable.
+        // Important note: an `npm` version should not be specifiable; the only valid npm version is the one installed alongside Node.js
+        const { stdout, stderr, code } = await nonInteractiveSpawn(application.name, (application.packageManagerPrefix ? application.packageManagerPrefix + ' ' : '') + packageManager.name, ['install'], // All of `npm`, `yarn`, and `pnpm` support the `install` command. If we need to configure options here we may have to use some other defaults though
+        application.dirPath, application.install?.timeout);
+        // if it succeeds, return
+        if (code === 0) {
+            return;
+        }
+        // Otherwise handle failure case based on `onFail` value
+        if (onFail === 'error') {
+            // Log the std outputs using the error log level (in case the user doesn't have debug level set)
+            if (stdout) {
+                printStd(application.name, packageManager.name, stdout, 'stdout', 'error');
+            }
+            if (stderr) {
+                printStd(application.name, packageManager.name, stderr, 'stderr', 'error');
+            }
+            // And throw an error instead of continuing
+            throw new Error(`Failed to install dependencies for ${application.name} using ${packageManager.name}. Exit code: ${code}`);
+        }
+        // If onFail is 'warn', print outputs using the warn level, plus an additional message
+        if (onFail === 'warn') {
+            if (stdout) {
+                printStd(application.name, packageManager.name, stdout, 'stdout', 'warn');
+            }
+            if (stderr) {
+                printStd(application.name, packageManager.name, stderr, 'stderr', 'warn');
+            }
+            application.logger.warn(`Failed to install dependencies for ${application.name} using ${packageManager.name}. Exit code: ${code}`);
+        }
+        // But then fall through to installing with npm
+    }
+    // Finally, default to running `npm install`
+    const { stdout, stderr, code } = await nonInteractiveSpawn(application.name, (application.packageManagerPrefix ? application.packageManagerPrefix + ' ' : '') + 'npm', ['install', '--force'], application.dirPath);
+    // if it succeeds, return
+    if (code === 0) {
+        return;
+    }
+    // Otherwise, print the stdout and stderr outputs
+    if (stdout) {
+        printStd(application.name, 'npm', stdout, 'stdout', 'warn');
+    }
+    if (stderr) {
+        printStd(application.name, 'npm', stderr, 'stderr', 'error');
+    }
+    // and throw a descriptive error
+    throw new Error(`Failed to install dependencies for ${application.name} using npm default. Exit code: ${code}`);
+}
+class Application {
+    name;
+    payload;
+    packageIdentifier;
+    install;
+    dirPath;
+    logger;
+    packageManagerPrefix; // can be used to configure a package manager prefix, specifically "sfw".
+    constructor({ name, payload, packageIdentifier, install }) {
+        this.name = name;
+        this.payload = payload;
+        this.packageIdentifier = packageIdentifier && derivePackageIdentifier(packageIdentifier);
+        this.install = install;
+        this.dirPath = (0, node_path_1.join)((0, configUtils_js_1.getConfigValue)(hdbTerms_js_1.CONFIG_PARAMS.COMPONENTSROOT), name);
+        this.logger = harper_logger_js_1.default.loggerWithTag(name);
+        this.packageManagerPrefix = (0, configUtils_js_1.getConfigValue)(hdbTerms_js_1.CONFIG_PARAMS.APPLICATIONS_PACKAGEMANAGERPREFIX);
+    }
+}
+exports.Application = Application;
+/**
+ * Based on an old implementation for a method called `getPkgPrefix()` that was used
+ * during the installation process in order to actually resolve what the user specifies for a
+ * component matching some of npm's package resolution rules.
+ */
+function derivePackageIdentifier(packageIdentifier) {
+    if (packageIdentifier.includes(':')) {
+        return packageIdentifier;
+    }
+    if (packageIdentifier.startsWith('@') || (!packageIdentifier.startsWith('@') && !packageIdentifier.includes('/'))) {
+        return `npm:${packageIdentifier}`;
+    }
+    if ((0, node_path_1.extname)(packageIdentifier) || (0, node_fs_1.existsSync)(packageIdentifier)) {
+        return `file:${packageIdentifier}`;
+    }
+    return `github:${packageIdentifier}`;
+}
+/**
+ * Extract and install the specified application.
+ *
+ * This method should only be called from the main thread
+ *
+ * @param application The application to prepare.
+ * @returns A promise that resolves when all preparation steps complete.
+ */
+function prepareApplication(application) {
+    return extractApplication(application).then(() => installApplication(application));
+}
+/**
+ * Install all applications specified in the root config.
+ *
+ * This method should only be called from the main thread otherwise certain
+ * operations may conflict with each other (such as writing to the same directory).
+ */
+async function installApplications() {
+    const applicationInstallationPromises = [];
+    // first install any built-in components specified from env vars
+    for (const { name, packageIdentifier } of getEnvBuiltInComponents()) {
+        if (packageIdentifier.startsWith('@/')) {
+            // this is a package relative module id, so later we will resolve it, but we don't need to install anything
+            continue;
+        }
+        const application = new Application({
+            name,
+            packageIdentifier,
+        });
+        applicationInstallationPromises.push(prepareApplication(application));
+    }
+    const config = (0, configUtils_js_1.getConfigObj)();
+    const componentsRootDirPath = (0, configUtils_js_1.getConfigValue)(hdbTerms_js_1.CONFIG_PARAMS.COMPONENTSROOT);
+    // Ensure component directory exists
+    await (0, promises_1.mkdir)(componentsRootDirPath, { recursive: true });
+    const harperApplicationLockPath = (0, node_path_1.join)((0, configUtils_js_1.getConfigValue)(hdbTerms_js_1.CONFIG_PARAMS.ROOTPATH), 'harper-application-lock.json');
+    let harperApplicationLock = { applications: {} };
+    try {
+        harperApplicationLock = JSON.parse(await (0, promises_1.readFile)(harperApplicationLockPath, 'utf8'));
+    }
+    catch (error) {
+        // Ignore file not found error; will create new lock file after installations
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    for (const [name, applicationConfig] of Object.entries(config)) {
+        // Pre-validation check if the configuration is actually for an application
+        // Don't want to throw an error here as the config may contain non-application entries
+        if (typeof applicationConfig !== 'object' || applicationConfig === null || !('package' in applicationConfig)) {
+            continue;
+        }
+        try {
+            // Then do proper error-based validation with TypeScript `asserts` to provide type safety
+            // This will throw if the config is invalid
+            assertApplicationConfig(name, applicationConfig);
+            const application = new Application({
+                name,
+                packageIdentifier: applicationConfig.package,
+                install: applicationConfig.install,
+            });
+            // Lock check: only install if not already installed with matching configuration
+            if ((0, node_fs_1.existsSync)(application.dirPath) &&
+                harperApplicationLock.applications[name] &&
+                JSON.stringify(harperApplicationLock.applications[name]) === JSON.stringify(applicationConfig)) {
+                harper_logger_js_1.default.info?.(`Application ${name} is already installed with matching configuration; skipping installation`);
+                continue;
+            }
+            applicationInstallationPromises.push(prepareApplication(application));
+            harperApplicationLock.applications[name] = applicationConfig;
+        }
+        catch (error) {
+            harper_logger_js_1.default.error?.(`Skipping installation of application ${name} due to invalid configuration: ${error.message}`);
+        }
+    }
+    const applicationInstallationStatuses = await Promise.allSettled(applicationInstallationPromises);
+    harper_logger_js_1.default.debug?.(applicationInstallationStatuses);
+    harper_logger_js_1.default.info?.('All root applications loaded');
+    // Finally, write the lock file
+    await (0, promises_1.writeFile)(harperApplicationLockPath, JSON.stringify(harperApplicationLock, null, 2), 'utf8');
+}
+function getGitSSHCommand() {
+    const rootDir = (0, configUtils_js_1.getConfigValue)(hdbTerms_js_1.CONFIG_PARAMS.ROOTPATH);
+    const sshDir = (0, node_path_1.join)(rootDir, 'ssh');
+    if ((0, node_fs_1.existsSync)(sshDir)) {
+        for (const file of (0, node_fs_1.readdirSync)(sshDir)) {
+            if (file.includes('.key')) {
+                return `ssh -F ${(0, node_path_1.join)(sshDir, 'config')} -o UserKnownHostsFile=${(0, node_path_1.join)(sshDir, 'known_hosts')}`;
+            }
+        }
+    }
+}
+/**
+ * Execute a command (using `spawn`) with stdin ignored.
+ *
+ * Stdout is logged chunk-by-chunk. Stderr is buffered and then logged line-by-line.
+ *
+ * Rejects with an error if the command fails or times out.
+ *
+ * @param command The command to run.
+ * @param args The arguments to pass to the command.
+ * @param cwd The working directory for the command.
+ * @param timeoutMs The timeout for the command in milliseconds. Defaults to 5 minutes.
+ * @returns A promise that resolves when the command completes.
+ */
+function nonInteractiveSpawn(applicationName, command, args, cwd, timeoutMs = 5 * 60 * 1000) {
+    return new Promise((resolve, reject) => {
+        harper_logger_js_1.default
+            .loggerWithTag(`${applicationName}:spawn:${command}`)
+            .debug?.(`Executing \`${command} ${args.join(' ')}\` in ${cwd}`);
+        const env = { ...process.env };
+        const gitSSHCommand = getGitSSHCommand();
+        if (gitSSHCommand) {
+            env.GIT_SSH_COMMAND = gitSSHCommand;
+        }
+        const childProcess = (0, node_child_process_1.spawn)(command, args, {
+            shell: true,
+            cwd,
+            env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const timeout = setTimeout(() => {
+            childProcess.kill();
+            reject(new Error(`Command\`${command} ${args.join(' ')}\` timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        let stdout = '';
+        childProcess.stdout.on('data', (chunk) => {
+            // buffer stdout for later resolve
+            stdout += chunk.toString();
+            // log stdout lines immediately
+            // TODO: Technically nothing guarantees that a chunk will be a complete line so need to implement
+            // something here to buffer until a newline character, then log the complete line
+            harper_logger_js_1.default.loggerWithTag(`${applicationName}:spawn:${command}:stdout`).debug?.(chunk.toString());
+        });
+        // buffer stderr
+        let stderr = '';
+        childProcess.stderr.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        childProcess.on('error', (error) => {
+            clearTimeout(timeout);
+            // Print out stderr before rejecting
+            if (stderr) {
+                printStd(applicationName, command, stderr, 'stderr');
+            }
+            reject(error);
+        });
+        childProcess.on('close', (code) => {
+            clearTimeout(timeout);
+            if (stderr) {
+                printStd(applicationName, command, stderr, 'stderr');
+            }
+            harper_logger_js_1.default.loggerWithTag(`${applicationName}:spawn:${command}`).debug?.(`Process exited with code ${code}`);
+            resolve({
+                stdout,
+                stderr,
+                code,
+            });
+        });
+    });
+}
+function getEnvBuiltInComponents() {
+    const builtInComponents = [];
+    if (process.env.HARPER_BUILTIN_COMPONENTS) {
+        for (const componentDefinition of process.env.HARPER_BUILTIN_COMPONENTS.split(',')) {
+            const [name, packageIdentifier] = componentDefinition.trim().split('=');
+            if (!componentDefinition)
+                continue;
+            builtInComponents.push({ name, packageIdentifier });
+        }
+    }
+    return builtInComponents;
+}
+function printStd(applicationName, command, stdString, stdStreamLabel, level = 'debug') {
+    const stdLogger = harper_logger_js_1.default.loggerWithTag(`${applicationName}:spawn:${command}:${stdStreamLabel}`);
+    for (const line of stdString.split('\n')) {
+        stdLogger[level]?.(line);
+    }
+}
+//# sourceMappingURL=Application.js.map

package/dist/components/Application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Application.js","sourceRoot":"","sources":["../../components/Application.ts"],"names":[],"mappings":";;;;;;AAsEA,0DA4BC;AAWD,gDA4GC;AAYD,gDAuJC;AAkCD,0DAYC;AAUD,gDAEC;AAQD,kDA8EC;AA2BD,kDAqEC;AAED,0DAUC;AAvnBD,6DAAwE;AACxE,wDAAuD;AACvD,2FAAyD;AAEzD,yCAAmD;AACnD,+CAY0B;AAC1B,2DAA2C;AAC3C,qCAAoE;AACpE,6CAAuC;AACvC,mDAAgD;AAEhD,mCAAiC;AACjC,gEAAkC;AAalC,MAAa,6BAA8B,SAAQ,SAAS;IAC3D,YAAY,eAAuB,EAAE,iBAA0B;QAC9D,KAAK,CACJ,8CAA8C,eAAe,0BAA0B,OAAO,iBAAiB,EAAE,CACjH,CAAC;IACH,CAAC;CACD;AAND,sEAMC;AAED,MAAa,2BAA4B,SAAQ,SAAS;IACzD,YAAY,eAAuB,EAAE,eAAwB;QAC5D,KAAK,CACJ,8CAA8C,eAAe,0BAA0B,OAAO,eAAe,EAAE,CAC/G,CAAC;IACH,CAAC;CACD;AAND,kEAMC;AAED,MAAa,0BAA2B,SAAQ,SAAS;IACxD,YAAY,eAAuB,EAAE,OAAgB;QACpD,KAAK,CACJ,sDAAsD,eAAe,0BAA0B,OAAO,OAAO,EAAE,CAC/G,CAAC;IACH,CAAC;CACD;AAND,gEAMC;AAED,MAAa,0BAA2B,SAAQ,SAAS;IACxD,YAAY,eAAuB,EAAE,OAAgB;QACpD,KAAK,CACJ,sDAAsD,eAAe,uCAAuC,OAAO,OAAO,EAAE,CAC5H,CAAC;IACH,CAAC;CACD;AAND,gEAMC;AAED,SAAgB,uBAAuB,CACtC,eAAuB,EACvB,iBAAuE;IAEvE,IAAI,OAAO,iBAAiB,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnD,MAAM,IAAI,6BAA6B,CAAC,eAAe,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,SAAS,IAAI,iBAAiB,EAAE,CAAC;QACpC,IACC,OAAO,iBAAiB,CAAC,OAAO,KAAK,QAAQ;YAC7C,iBAAiB,CAAC,OAAO,KAAK,IAAI;YAClC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,EACvC,CAAC;YACF,MAAM,IAAI,2BAA2B,CAAC,eAAe,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,SAAS,IAAI,iBAAiB,CAAC,OAAO,IAAI,OAAO,iBAAiB,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACrG,MAAM,IAAI,0BAA0B,CAAC,eAAe,EAAE,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1F,CAAC;QAED,IACC,SAAS,IAAI,iBAAiB,CAAC,OAAO;YACtC,CAAC,OAAO,iBAAiB,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,iBAAiB,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,EAC/F,CAAC;YACF,MAAM,IAAI,0BAA0B,CAAC,eAAe,EAAE,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1F,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,kBAAkB,CAAC,WAAwB;IAChE,wBAAwB;IACxB,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC/D,CAAC;IAED,qBAAqB;IACrB,IAAI,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,iBAAiB,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAChE,CAAC;IAED,qCAAqC;IACrC,IAAI,WAAmB,CAAC;IACxB,IAAI,OAAiB,CAAC;IACtB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,+DAA+D;QAC/D,OAAO,GAAG,sBAAQ,CAAC,IAAI,CACtB,WAAW,CAAC,OAAO,YAAY,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CACxG,CAAC;IACH,CAAC;SAAM,CAAC;QACP,gDAAgD;QAChD,MAAM,aAAa,GAAG,IAAA,mBAAO,EAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAEnD,4FAA4F;QAC5F,IAAI,WAAW,CAAC,iBAAiB,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,MAAM,WAAW,GAAG,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC;gBACJ,+DAA+D;gBAC/D,MAAM,KAAK,GAAG,MAAM,IAAA,eAAI,EAAC,WAAW,CAAC,CAAC;gBAEtC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACzB,8BAA8B;oBAC9B,MAAM,IAAA,kBAAO,EAAC,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;oBACvD,0DAA0D;oBAC1D,OAAO;gBACR,CAAC;gBAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;oBACrB,MAAM,IAAI,KAAK,CAAC,yEAAyE,WAAW,EAAE,CAAC,CAAC;gBACzG,CAAC;gBAED,6DAA6D;gBAC7D,4EAA4E;gBAC5E,2EAA2E;gBAC3E,8FAA8F;gBAC9F,WAAW,GAAG,WAAW,CAAC;gBAC1B,OAAO,GAAG,IAAA,0BAAgB,EAAC,WAAW,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,6DAA6D,WAAW,EAAE,CAAC,CAAC;gBAC7F,CAAC;qBAAM,CAAC;oBACP,MAAM,GAAG,CAAC;gBACX,CAAC;YACF,CAAC;QACF,CAAC;aAAM,CAAC;YACP,+GAA+G;YAC/G,MAAM,EACL,MAAM,EAAE,eAAe,EACvB,IAAI,EACJ,MAAM,GACN,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC,CAAC;YAC/G,IAAI,IAAI,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,WAAW,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC,CAAC;YAC1G,WAAW,GAAG,IAAA,gBAAI,EAAC,aAAa,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,qCAAqC;YACrC,OAAO,GAAG,IAAA,0BAAgB,EAAC,WAAW,CAAC,CAAC;QACzC,CAAC;IACF,CAAC;IAED,mCAAmC;IACnC,IAAI,CAAC;QACJ,MAAM,IAAA,iBAAM,EAAC,WAAW,CAAC,OAAO,EAAE,oBAAS,CAAC,IAAI,CAAC,CAAC;QAClD,qCAAqC;QACrC,MAAM,IAAA,aAAE,EAAC,WAAW,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,8BAA8B;QAC9B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,GAAG,CAAC;QACX,CAAC;IACF,CAAC;IACD,kDAAkD;IAClD,MAAM,IAAA,gBAAK,EAAC,WAAW,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,yGAAyG;IACzG,MAAM,IAAA,mBAAQ,EAAC,OAAO,EAAE,IAAA,sBAAM,GAAE,EAAE,IAAA,gBAAO,EAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhE,sFAAsF;IACtF,8EAA8E;IAC9E,2FAA2F;IAC3F,MAAM,SAAS,GAAG,MAAM,IAAA,kBAAO,EAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1D,MAAM,eAAe,GAAG,IAAA,gBAAI,EAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAErE,MAAM,WAAW,GAAG,MAAM,IAAA,kBAAO,EAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAEvD,4IAA4I;QAC5I,MAAM,IAAA,aAAE,EAAC,eAAe,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,6BAA6B;QAC7B,MAAM,IAAA,aAAE,EAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,2DAA2D;QAC3D,MAAM,IAAA,aAAE,EAAC,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,+BAA+B;QAC/B,MAAM,IAAA,aAAE,EAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,gCAAgC;IAChC,IAAI,WAAW,EAAE,CAAC;QACjB,MAAM,IAAA,aAAE,EAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACI,KAAK,UAAU,kBAAkB,CAAC,WAAwB;IAChE,IAAI,WAAgB,CAAC;IACrB,IAAI,CAAC;QACJ,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;QACrC,yCAAyC;QACzC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,WAAW,CAAC,IAAI,wCAAwC,CAAC,CAAC;QAClG,OAAO;IACR,CAAC;IACD,IAAI,CAAC;QACJ,2BAA2B;QAC3B,MAAM,IAAA,iBAAM,EAAC,IAAA,gBAAI,EAAC,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,oBAAS,CAAC,IAAI,CAAC,CAAC;QACxE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,WAAW,CAAC,IAAI,6CAA6C,CAAC,CAAC;QACvG,OAAO;IACR,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;QACrC,iEAAiE;IAClE,CAAC;IAED,iDAAiD;IACjD,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QAClC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,mBAAmB,CACzD,WAAW,CAAC,IAAI,EAChB,OAAO,EACP,IAAI,EACJ,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,OAAO,EAAE,OAAO,CAC5B,CAAC;QACF,yBAAyB;QACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO;QACR,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACZ,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/D,CAAC;QACD,gCAAgC;QAChC,MAAM,IAAI,KAAK,CACd,sCAAsC,WAAW,CAAC,IAAI,kCAAkC,WAAW,CAAC,OAAO,CAAC,OAAO,gBAAgB,IAAI,EAAE,CACzI,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,EAAE,cAAc,EAAE,GAAG,WAAW,CAAC,UAAU,IAAI,EAAE,CAAC;IAExD,mCAAmC;IACnC,IAAI,cAAc,EAAE,CAAC;QACpB,6FAA6F;QAC7F,IAAI,MAAM,GAAuB,cAAc,CAAC,MAAM,CAAC;QAEvD,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAEtD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC3B,WAAW,CAAC,MAAM,CAAC,IAAI,CACtB,0GAA0G,CAC1G,CAAC;YACF,MAAM,GAAG,OAAO,CAAC;QAClB,CAAC;aAAM,IAAI,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,WAAW,CAAC,MAAM,CAAC,KAAK,CACvB,wDAAwD,MAAM,sBAAsB,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAC9J,CAAC;YACF,MAAM,GAAG,OAAO,CAAC;QAClB,CAAC;QAED,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC;QAE3B,sDAAsD;QACtD,mFAAmF;QACnF,yHAAyH;QACzH,mFAAmF;QACnF,qEAAqE;QACrE,yDAAyD;QACzD,gIAAgI;QAEhI,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,mBAAmB,CACzD,WAAW,CAAC,IAAI,EAChB,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,IAAI,EACtG,CAAC,SAAS,CAAC,EAAE,qJAAqJ;QAClK,WAAW,CAAC,OAAO,EACnB,WAAW,CAAC,OAAO,EAAE,OAAO,CAC5B,CAAC;QAEF,yBAAyB;QACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO;QACR,CAAC;QAED,wDAAwD;QACxD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACxB,gGAAgG;YAChG,IAAI,MAAM,EAAE,CAAC;gBACZ,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5E,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACZ,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5E,CAAC;YAED,2CAA2C;YAC3C,MAAM,IAAI,KAAK,CACd,sCAAsC,WAAW,CAAC,IAAI,UAAU,cAAc,CAAC,IAAI,gBAAgB,IAAI,EAAE,CACzG,CAAC;QACH,CAAC;QAED,sFAAsF;QACtF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACvB,IAAI,MAAM,EAAE,CAAC;gBACZ,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3E,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACZ,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3E,CAAC;YAED,WAAW,CAAC,MAAM,CAAC,IAAI,CACtB,sCAAsC,WAAW,CAAC,IAAI,UAAU,cAAc,CAAC,IAAI,gBAAgB,IAAI,EAAE,CACzG,CAAC;QACH,CAAC;QAED,+CAA+C;IAChD,CAAC;IAED,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,mBAAmB,CACzD,WAAW,CAAC,IAAI,EAChB,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EACxF,CAAC,SAAS,EAAE,SAAS,CAAC,EACtB,WAAW,CAAC,OAAO,CACnB,CAAC;IAEF,yBAAyB;IACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO;IACR,CAAC;IAED,iDAAiD;IACjD,IAAI,MAAM,EAAE,CAAC;QACZ,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACZ,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,gCAAgC;IAChC,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,CAAC,IAAI,kCAAkC,IAAI,EAAE,CAAC,CAAC;AACjH,CAAC;AASD,MAAa,WAAW;IACvB,IAAI,CAAS;IACb,OAAO,CAAmB;IAC1B,iBAAiB,CAAU;IAC3B,OAAO,CAA0C;IACjD,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,oBAAoB,CAAS,CAAC,yEAAyE;IAEvG,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAsB;QAC5E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,IAAI,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;QACzF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAA,gBAAI,EAAC,IAAA,+BAAc,EAAC,2BAAa,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,GAAG,0BAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,oBAAoB,GAAG,IAAA,+BAAc,EAAC,2BAAa,CAAC,iCAAiC,CAAC,CAAC;IAC7F,CAAC;CACD;AAlBD,kCAkBC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,iBAAyB;IAChE,IAAI,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,iBAAiB,CAAC;IAC1B,CAAC;IACD,IAAI,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACnH,OAAO,OAAO,iBAAiB,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,IAAA,mBAAO,EAAC,iBAAiB,CAAC,IAAI,IAAA,oBAAU,EAAC,iBAAiB,CAAC,EAAE,CAAC;QACjE,OAAO,QAAQ,iBAAiB,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,UAAU,iBAAiB,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,WAAwB;IAC1D,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,mBAAmB;IACxC,MAAM,+BAA+B,GAAoB,EAAE,CAAC;IAE5D,gEAAgE;IAChE,KAAK,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,uBAAuB,EAAE,EAAE,CAAC;QACrE,IAAI,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,2GAA2G;YAC3G,SAAS;QACV,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;YACnC,IAAI;YACJ,iBAAiB;SACjB,CAAC,CAAC;QAEH,+BAA+B,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,6BAAY,GAAE,CAAC;IAE9B,MAAM,qBAAqB,GAAG,IAAA,+BAAc,EAAC,2BAAa,CAAC,cAAc,CAAC,CAAC;IAE3E,oCAAoC;IACpC,MAAM,IAAA,gBAAK,EAAC,qBAAqB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,yBAAyB,GAAG,IAAA,gBAAI,EAAC,IAAA,+BAAc,EAAC,2BAAa,CAAC,QAAQ,CAAC,EAAE,8BAA8B,CAAC,CAAC;IAE/G,IAAI,qBAAqB,GAAwD,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IACtG,IAAI,CAAC;QACJ,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,6EAA6E;QAC7E,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChE,2EAA2E;QAC3E,sFAAsF;QACtF,IAAI,OAAO,iBAAiB,KAAK,QAAQ,IAAI,iBAAiB,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,iBAAiB,CAAC,EAAE,CAAC;YAC9G,SAAS;QACV,CAAC;QAED,IAAI,CAAC;YACJ,yFAAyF;YACzF,2CAA2C;YAC3C,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YAEjD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC;gBACnC,IAAI;gBACJ,iBAAiB,EAAE,iBAAiB,CAAC,OAAO;gBAC5C,OAAO,EAAE,iBAAiB,CAAC,OAAO;aAClC,CAAC,CAAC;YAEH,gFAAgF;YAChF,IACC,IAAA,oBAAU,EAAC,WAAW,CAAC,OAAO,CAAC;gBAC/B,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAC;gBACxC,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,EAC7F,CAAC;gBACF,0BAAM,CAAC,IAAI,EAAE,CAAC,eAAe,IAAI,0EAA0E,CAAC,CAAC;gBAC7G,SAAS;YACV,CAAC;YAED,+BAA+B,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;YAEtE,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,0BAAM,CAAC,KAAK,EAAE,CAAC,wCAAwC,IAAI,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/G,CAAC;IACF,CAAC;IAED,MAAM,+BAA+B,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAC;IAClG,0BAAM,CAAC,KAAK,EAAE,CAAC,+BAA+B,CAAC,CAAC;IAChD,0BAAM,CAAC,IAAI,EAAE,CAAC,8BAA8B,CAAC,CAAC;IAE9C,+BAA+B;IAC/B,MAAM,IAAA,oBAAS,EAAC,yBAAyB,EAAE,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,gBAAgB;IACxB,MAAM,OAAO,GAAG,IAAA,+BAAc,EAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,IAAI,IAAA,oBAAU,EAAC,MAAM,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,IAAA,qBAAW,EAAC,MAAM,CAAC,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,UAAU,IAAA,gBAAI,EAAC,MAAM,EAAE,QAAQ,CAAC,0BAA0B,IAAA,gBAAI,EAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;YAChG,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CAClC,eAAuB,EACvB,OAAe,EACf,IAAc,EACd,GAAW,EACX,YAAoB,CAAC,GAAG,EAAE,GAAG,IAAI;IAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,0BAAM;aACJ,aAAa,CAAC,GAAG,eAAe,UAAU,OAAO,EAAE,CAAC;aACpD,KAAK,EAAE,CAAC,eAAe,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;QAElE,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE/B,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;QACzC,IAAI,aAAa,EAAE,CAAC;YACnB,GAAG,CAAC,eAAe,GAAG,aAAa,CAAC;QACrC,CAAC;QAED,MAAM,YAAY,GAAG,IAAA,0BAAK,EAAC,OAAO,EAAE,IAAI,EAAE;YACzC,KAAK,EAAE,IAAI;YACX,GAAG;YACH,GAAG;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SACjC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,YAAY,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,SAAS,IAAI,CAAC,CAAC,CAAC;QAC7F,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,kCAAkC;YAClC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC3B,+BAA+B;YAC/B,iGAAiG;YACjG,iFAAiF;YACjF,0BAAM,CAAC,aAAa,CAAC,GAAG,eAAe,UAAU,OAAO,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;QAEH,gBAAgB;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAClC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,oCAAoC;YACpC,IAAI,MAAM,EAAE,CAAC;gBACZ,QAAQ,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACjC,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,MAAM,EAAE,CAAC;gBACZ,QAAQ,CAAC,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACtD,CAAC;YACD,0BAAM,CAAC,aAAa,CAAC,GAAG,eAAe,UAAU,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;YACxG,OAAO,CAAC;gBACP,MAAM;gBACN,MAAM;gBACN,IAAI;aACJ,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,uBAAuB;IACtC,MAAM,iBAAiB,GAAkD,EAAE,CAAC;IAC5E,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,CAAC;QAC3C,KAAK,MAAM,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACpF,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxE,IAAI,CAAC,mBAAmB;gBAAE,SAAS;YACnC,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAChB,eAAuB,EACvB,OAAe,EACf,SAAiB,EACjB,cAAmC,EACnC,QAAoC,OAAO;IAE3C,MAAM,SAAS,GAAG,0BAAM,CAAC,aAAa,CAAC,GAAG,eAAe,UAAU,OAAO,IAAI,cAAc,EAAE,CAAC,CAAC;IAChG,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACF,CAAC"}

package/dist/components/ApplicationScope.d.ts

@@ -0,0 +1,28 @@
+import type { Resources } from '../resources/Resources.ts';
+import { type Server } from '../server/Server.ts';
+export declare class MissingDefaultFilesOptionError extends Error {
+    constructor();
+}
+/**
+ * This class is used to represent the application scope for the VM context used for loading modules within an application
+ */
+export declare class ApplicationScope {
+    logger: any;
+    resources: Resources;
+    server: Server;
+    mode?: 'none' | 'vm' | 'compartment';
+    dependencyContainment?: boolean;
+    verifyPath?: string;
+    config: any;
+    constructor(name: string, resources: Resources, server: Server, verifyPath?: string);
+    /**
+     * The compartment that is used for this scope and any imports that it makes
+     */
+    compartment?: Promise<any>;
+    /**
+     * Import a file into the scope's sandbox.
+     * @param filePath - The path of the file to import.
+     * @returns A promise that resolves with the imported module or value.
+     */
+    import(filePath: string): Promise<unknown>;
+}

package/dist/components/ApplicationScope.js

@@ -0,0 +1,81 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationScope = exports.MissingDefaultFilesOptionError = void 0;
+const harper_logger_js_1 = require("../utility/logging/harper_logger.js");
+const jsLoader_ts_1 = require("../security/jsLoader.js");
+const env = __importStar(require("../utility/environment/environmentManager.js"));
+const hdbTerms_ts_1 = require("../utility/hdbTerms.js");
+class MissingDefaultFilesOptionError extends Error {
+    constructor() {
+        super('No default files option exists. Ensure `files` is specified in config.yaml');
+        this.name = 'MissingDefaultFilesOptionError';
+    }
+}
+exports.MissingDefaultFilesOptionError = MissingDefaultFilesOptionError;
+/**
+ * This class is used to represent the application scope for the VM context used for loading modules within an application
+ */
+class ApplicationScope {
+    logger;
+    resources;
+    server;
+    mode; // option to set this from the scope
+    dependencyContainment; // option to set this from the scope
+    verifyPath;
+    config;
+    constructor(name, resources, server, verifyPath) {
+        this.logger = (0, harper_logger_js_1.loggerWithTag)(name);
+        this.resources = resources;
+        this.server = server;
+        this.mode = env.get(hdbTerms_ts_1.CONFIG_PARAMS.APPLICATIONS_CONTAINMENT) ?? 'vm';
+        this.dependencyContainment = Boolean(env.get(hdbTerms_ts_1.CONFIG_PARAMS.APPLICATIONS_DEPENDENCYCONTAINMENT));
+        this.verifyPath = verifyPath;
+    }
+    /**
+     * The compartment that is used for this scope and any imports that it makes
+     */
+    compartment;
+    /**
+     * Import a file into the scope's sandbox.
+     * @param filePath - The path of the file to import.
+     * @returns A promise that resolves with the imported module or value.
+     */
+    async import(filePath) {
+        return (0, jsLoader_ts_1.scopedImport)(filePath, this);
+    }
+}
+exports.ApplicationScope = ApplicationScope;
+//# sourceMappingURL=ApplicationScope.js.map

package/dist/components/ApplicationScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationScope.js","sourceRoot":"","sources":["../../components/ApplicationScope.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,0EAAoE;AACpE,yDAAuD;AACvD,kFAAoE;AACpE,wDAAuD;AAEvD,MAAa,8BAA+B,SAAQ,KAAK;IACxD;QACC,KAAK,CAAC,4EAA4E,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC9C,CAAC;CACD;AALD,wEAKC;AAED;;GAEG;AACH,MAAa,gBAAgB;IAC5B,MAAM,CAAM;IACZ,SAAS,CAAY;IACrB,MAAM,CAAS;IACf,IAAI,CAAiC,CAAC,oCAAoC;IAC1E,qBAAqB,CAAW,CAAC,oCAAoC;IACrE,UAAU,CAAU;IACpB,MAAM,CAAM;IACZ,YAAY,IAAY,EAAE,SAAoB,EAAE,MAAc,EAAE,UAAmB;QAClF,IAAI,CAAC,MAAM,GAAG,IAAA,gCAAa,EAAC,IAAI,CAAC,CAAC;QAElC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,2BAAa,CAAC,wBAAwB,CAAC,IAAI,IAAI,CAAC;QACpE,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,2BAAa,CAAC,kCAAkC,CAAC,CAAC,CAAC;QAChG,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW,CAAgB;IAC3B;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC5B,OAAO,IAAA,0BAAY,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;CACD;AA/BD,4CA+BC"}