@mikeyt23/node-cli-utils 1.4.1 → 2.0.0-beta.1

package/dist/esm/TarballUtility.js

@@ -0,0 +1,143 @@
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import { mkdirp, requireString, requireValidPath, spawnAsync, trace, whichSync } from './generalUtils.js';
+import { config } from './NodeCliUtilsConfig.js';
+/**
+ * This utility class exists so we can mock the `which` dependency in unit tests without resorting to libraries that hack the import system.
+ */
+export class TarballUtility {
+    whichSyncFn;
+    constructor(whichSyncFn) {
+        this.whichSyncFn = whichSyncFn;
+    }
+    /**
+     * Creates a gzipped tarball from a directory by spawning a process to run OS-installed `tar` to avoid pulling in npm package dependencies.
+     * Note that Windows has tar since Windows 10 1803 (see https://devblogs.microsoft.com/commandline/windows10v1803/.
+     *
+     * It's possible this isn't 100% reliable due to differences in `tar` versions across platforms. If better normalization
+     * is required, consider using the npm package `node-tar` instead.
+     * @param directoryToTarball The directory to tarball. The directory name will be used as the root directory in the tarball
+     * @param tarballPath The path to the tarball to create - must end with '.tar.gz'
+     * @param options See {@link CreateTarballOptions}
+     */
+    createTarball = async (directoryToTarball, tarballPath, options) => {
+        requireValidPath('directoryToTarball', directoryToTarball);
+        requireString('tarballPath', tarballPath);
+        const defaultOptions = { excludes: [] };
+        const mergedOptions = { ...defaultOptions, ...options };
+        if (!this.whichSyncFn('tar').location) {
+            throw new Error('tar command not found - please install tar on your OS to use this method, or consider using the npm package node-tar instead');
+        }
+        if (!fs.existsSync(directoryToTarball)) {
+            throw new Error(`directoryToTarball does not exist: ${directoryToTarball}`);
+        }
+        if (tarballPath.endsWith('.tar.gz') === false) {
+            throw new Error(`tarballPath must end with '.tar.gz': ${tarballPath}`);
+        }
+        const directoryToTarballParentDir = path.dirname(directoryToTarball);
+        const directoryToTarballName = path.basename(directoryToTarball);
+        const outputDirectory = path.dirname(tarballPath);
+        const tarballName = path.basename(tarballPath);
+        if (!fs.existsSync(outputDirectory)) {
+            trace(`tarballPath directory does not exist - creating '${outputDirectory}'`);
+            await mkdirp(outputDirectory);
+        }
+        else if (fs.existsSync(tarballPath)) {
+            trace(`removing existing tarball '${tarballName}' before creating new one`);
+            await fsp.unlink(tarballPath);
+        }
+        const excludesArgs = mergedOptions.excludes.length > 0 ? mergedOptions.excludes.map(exclude => `--exclude=${exclude}`) : [];
+        const verboseFlag = config.traceEnabled ? ['-v'] : [];
+        const args = [...(verboseFlag), '-czf', tarballPath, '-C', directoryToTarballParentDir, ...excludesArgs, directoryToTarballName];
+        const result = await spawnAsync('tar', args);
+        if (result.code !== 0) {
+            throw new Error(`tar command failed with code ${result.code}`);
+        }
+        trace('tarball created: ' + tarballPath);
+    };
+    /**
+     * Unpacks a gzipped tarball by spawning a process to run OS-installed `tar` to avoid pulling in npm package dependencies.
+     * This method will throw an error if the unpackDirectory is not empty, unless the `throwOnNonEmptyUnpackDir` option is set to false.
+     * @param tarballPath The path to the tarball to unpack
+     * @param unpackDirectory The directory to unpack the tarball into
+     * @param options The options to use when unpacking the tarball. See {@link TarballUnpackOptions}.
+     */
+    unpackTarball = async (tarballPath, unpackDirectory, options) => {
+        requireValidPath('tarballPath', tarballPath);
+        requireString('unpackDirectory', unpackDirectory);
+        if (!this.whichSyncFn('tar').location) {
+            throw new Error('tar command not found - please install tar on your OS to use this method, or consider using the npm package node-tar instead');
+        }
+        const defaultOptions = { createDirIfNotExists: false, stripComponents: 0, throwOnNonEmptyUnpackDir: true };
+        const mergedOptions = { ...defaultOptions, ...options };
+        if (mergedOptions.stripComponents < 0) {
+            throw new Error('stripComponents must be greater than or equal to 0 if provided');
+        }
+        const unpackedDirExists = fs.existsSync(unpackDirectory);
+        if (unpackedDirExists && !this.isDirectory(unpackDirectory)) {
+            throw new Error(`unpackDirectory exists but is not a directory: ${unpackDirectory}`);
+        }
+        if (mergedOptions.createDirIfNotExists && !unpackedDirExists) {
+            await this.tryCreateDirectory(unpackDirectory);
+        }
+        if (!mergedOptions.createDirIfNotExists && !unpackedDirExists) {
+            throw new Error(`unpackDirectory does not exist: ${unpackDirectory}`);
+        }
+        if (mergedOptions.throwOnNonEmptyUnpackDir && this.dirIsNotEmpty(unpackDirectory)) {
+            throw new Error(`unpackDirectory exists but is not empty: ${unpackDirectory}`);
+        }
+        const verboseFlag = config.traceEnabled ? ['-v'] : [];
+        const args = [...(verboseFlag), '-xzf', tarballPath, '-C', unpackDirectory, '--strip-components', mergedOptions.stripComponents.toString()];
+        const result = await spawnAsync('tar', args);
+        if (result.code !== 0) {
+            throw new Error(`tar command failed with code ${result.code}`);
+        }
+        trace(`tarball unpacked at ${unpackDirectory}`);
+    };
+    /**
+     * A more opinionated version of {@link unpackTarball} that assumes you want to create the directory and strip the first directory out of the unpacked files.
+     * @param tarballPath The path to the tarball to unpack
+     * @param unpackDirectory The directory to unpack the tarball into - will be created if it doesn't exist and will throw if it exists but is not empty
+     * @param stripComponents The number of leading directories to strip out of the unpacked files, defaults to 1
+     */
+    unpackTarballContents = async (tarballPath, unpackDirectory, stripComponents = 1) => {
+        await this.unpackTarball(tarballPath, unpackDirectory, { stripComponents, createDirIfNotExists: true });
+    };
+    isDirectory = (path) => {
+        try {
+            const stats = fs.statSync(path);
+            return stats.isDirectory();
+        }
+        catch (err) {
+            return false;
+        }
+    };
+    dirIsNotEmpty = (dirPath) => {
+        try {
+            const stats = fs.statSync(dirPath);
+            return stats.isDirectory() && fs.readdirSync(dirPath).length > 0;
+        }
+        catch (err) {
+            return false;
+        }
+    };
+    tryCreateDirectory = async (dirPath) => {
+        try {
+            await mkdirp(dirPath);
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                throw new Error(`Error creating unpackDirectory: ${err.message}`);
+            }
+            else {
+                throw new Error(`Error creating unpackDirectory: ${err}`);
+            }
+        }
+    };
+}
+const defaultUtil = new TarballUtility(whichSync);
+export const createTarball = defaultUtil.createTarball;
+export const unpackTarball = defaultUtil.unpackTarball;
+export const unpackTarballContents = defaultUtil.unpackTarballContents;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVGFyYmFsbFV0aWxpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvVGFyYmFsbFV0aWxpdHkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLE1BQU0sU0FBUyxDQUFBO0FBQ3hCLE9BQU8sR0FBRyxNQUFNLGtCQUFrQixDQUFBO0FBQ2xDLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQTtBQUM1QixPQUFPLEVBQUUsTUFBTSxFQUFFLGFBQWEsRUFBRSxnQkFBZ0IsRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLG1CQUFtQixDQUFBO0FBQ3pHLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQTtBQWdCaEQ7O0dBRUc7QUFDSCxNQUFNLE9BQU8sY0FBYztJQUNqQixXQUFXLENBQWtCO0lBRXJDLFlBQVksV0FBNkI7UUFDdkMsSUFBSSxDQUFDLFdBQVcsR0FBRyxXQUFXLENBQUE7SUFDaEMsQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTRztJQUNILGFBQWEsR0FBRyxLQUFLLEVBQUUsa0JBQTBCLEVBQUUsV0FBbUIsRUFBRSxPQUE4QixFQUFFLEVBQUU7UUFDeEcsZ0JBQWdCLENBQUMsb0JBQW9CLEVBQUUsa0JBQWtCLENBQUMsQ0FBQTtRQUMxRCxhQUFhLENBQUMsYUFBYSxFQUFFLFdBQVcsQ0FBQyxDQUFBO1FBRXpDLE1BQU0sY0FBYyxHQUFHLEVBQUUsUUFBUSxFQUFFLEVBQUUsRUFBRSxDQUFBO1FBQ3ZDLE1BQU0sYUFBYSxHQUFHLEVBQUUsR0FBRyxjQUFjLEVBQUUsR0FBRyxPQUFPLEVBQUUsQ0FBQTtRQUV2RCxJQUFJLENBQUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxLQUFLLENBQUMsQ0FBQyxRQUFRLEVBQUU7WUFDckMsTUFBTSxJQUFJLEtBQUssQ0FBQyw4SEFBOEgsQ0FBQyxDQUFBO1NBQ2hKO1FBRUQsSUFBSSxDQUFDLEVBQUUsQ0FBQyxVQUFVLENBQUMsa0JBQWtC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

package/dist/esm/certUtils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Wrapper function for calling openssl to generate a self-signed cert to be used for developing a local website with trusted https.
+ * @param url The url to generate a cert for. This will be used as the common name (CN) in the cert as well as the filename for the generated cert files.
+ * @param outputDirectory The directory to write the generated cert files to. Defaults to './cert'.
+ */
+export declare function generateCertWithOpenSsl(url: string, outputDirectory?: string): Promise<void>;
+/**
+ * Uses Powershell to install a cert to the local machine's trusted root store. Must have admin permissions.
+ *
+ * If the cert is already installed, this method will do nothing.
+ * @param urlOrCertFilename The url or cert filename to install. The url + '.pfx' or the cert filename passed must match a file that exists in the certDirectory.
+ * @param certDirectory The directory to look for the cert file in. Defaults to './cert'.
+ */
+export declare function winInstallCert(urlOrCertFilename: string, certDirectory?: string): Promise<void>;
+/**
+ * Uses Powershell to uninstall a cert from the local machine's trusted root store. Must have admin permissions.
+ * @param urlOrSubject The url or subject of the cert to uninstall. If the cert was installed with the winInstallCert method, this will be the url passed to that method.
+ */
+export declare function winUninstallCert(urlOrSubject: string): Promise<void>;
+/**
+ * Does not actually do anything - just outputs the manual instructions for installing a cert for use by chrome on linux.
+ */
+export declare function linuxInstallCert(): void;
+/**
+ * Uses Powershell to check if a cert is already installed to the local machine's trusted root store.
+ * @param urlOrSubject The url or subject of the cert to check. If the cert was installed with the winInstallCert method, this will be the url passed to that method.
+ * @returns `true` if the cert is already installed, `false` otherwise.
+ */
+export declare function winCertAlreadyInstalled(urlOrSubject: string): Promise<boolean>;
+//# sourceMappingURL=certUtils.d.ts.map

package/dist/esm/certUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certUtils.d.ts","sourceRoot":"","sources":["../../src/certUtils.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,GAAE,MAAiB,iBAuD5F;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,aAAa,SAAW,iBA8BvF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,iBAY1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,SAU/B;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBpF"}

package/dist/esm/certUtils.js

@@ -0,0 +1,185 @@
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import * as nodeCliUtils from './generalUtils.js';
+import { log } from './generalUtils.js';
+const requiresAdminMessage = `➡️ Important: Requires admin permissions`;
+const powershellHackPrefix = `$env:PSModulePath = [Environment]::GetEnvironmentVariable('PSModulePath', 'Machine'); `;
+/**
+ * Wrapper function for calling openssl to generate a self-signed cert to be used for developing a local website with trusted https.
+ * @param url The url to generate a cert for. This will be used as the common name (CN) in the cert as well as the filename for the generated cert files.
+ * @param outputDirectory The directory to write the generated cert files to. Defaults to './cert'.
+ */
+export async function generateCertWithOpenSsl(url, outputDirectory = './cert') {
+    nodeCliUtils.requireString('url', url);
+    throwIfMaybeBadUrlChars(url);
+    const isMac = nodeCliUtils.isPlatformMac();
+    const spawnArgs = { cwd: outputDirectory };
+    log('- checking if openssl is installed');
+    let brewOpenSslPath = '';
+    if (!isMac) {
+        const openSslPath = nodeCliUtils.whichSync('openssl').location;
+        if (!openSslPath) {
+            throw Error('openssl is required but was not found');
+        }
+        log(`- using openssl at: ${openSslPath}`);
+    }
+    else if (isMac) {
+        const brewOpenSslDirectory = getBrewOpensslPath();
+        if (!brewOpenSslDirectory) {
+            throw Error('openssl (brew version) is required but was not found');
+        }
+        brewOpenSslPath = `${getBrewOpensslPath()}/bin/openssl`;
+        if (!fs.existsSync(brewOpenSslPath)) {
+            throw Error(`openssl (brew version) is required but was not found at: ${brewOpenSslPath}`);
+        }
+        else {
+            log(`- using openssl at: ${brewOpenSslPath}`);
+        }
+    }
+    nodeCliUtils.ensureDirectory(outputDirectory);
+    const keyName = url + '.key';
+    const crtName = url + '.crt';
+    const pfxName = url + '.pfx';
+    const pfxPath = path.join(outputDirectory, pfxName);
+    if (fs.existsSync(pfxPath)) {
+        throw Error(`File ${pfxPath} already exists. Delete or rename this file if you want to generate a new cert.`);
+    }
+    log('- writing san.cnf file for use with openssl command');
+    const sanCnfContents = getSanCnfFileContents(url);
+    const sanCnfPath = path.join(outputDirectory, 'san.cnf');
+    await fsp.writeFile(sanCnfPath, sanCnfContents);
+    log(`- attempting to generate cert ${pfxName}`);
+    const genKeyAndCrtArgs = `req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout ${keyName} -out ${crtName} -subj /CN=${url} -config san.cnf`.split(' ');
+    const command = isMac ? brewOpenSslPath : 'openssl';
+    let result = await nodeCliUtils.spawnAsync(command, genKeyAndCrtArgs, spawnArgs);
+    if (result.code !== 0) {
+        throw Error(`openssl command to generate key and crt files failed with exit code ${result.code}`);
+    }
+    log('- converting key and crt to pfx');
+    const convertToPfxArgs = `pkcs12 -certpbe AES-256-CBC -export -out ${pfxName} -aes256 -inkey ${keyName} -in ${crtName} -password pass:`.split(' ');
+    result = await nodeCliUtils.spawnAsync(command, convertToPfxArgs, spawnArgs);
+    if (result.code !== 0) {
+        throw Error(`openssl command to convert key and crt files to a pfx failed with exit code ${result.code}`);
+    }
+}
+/**
+ * Uses Powershell to install a cert to the local machine's trusted root store. Must have admin permissions.
+ *
+ * If the cert is already installed, this method will do nothing.
+ * @param urlOrCertFilename The url or cert filename to install. The url + '.pfx' or the cert filename passed must match a file that exists in the certDirectory.
+ * @param certDirectory The directory to look for the cert file in. Defaults to './cert'.
+ */
+export async function winInstallCert(urlOrCertFilename, certDirectory = './cert') {
+    nodeCliUtils.requireString('urlOrCertFilename', urlOrCertFilename);
+    nodeCliUtils.requireValidPath('certDirectory', certDirectory);
+    throwIfMaybeBadUrlChars(urlOrCertFilename, 'urlOrCertFilename');
+    if (!nodeCliUtils.isPlatformWindows()) {
+        throw Error('This method is only supported on Windows');
+    }
+    log(requiresAdminMessage);
+    if (await winCertAlreadyInstalled(urlOrCertFilename)) {
+        log(`certificate for ${urlOrCertFilename} is already installed - to install it again, first uninstall it manually or with the winUninstallCert method`);
+        return;
+    }
+    const certName = urlOrCertFilename.endsWith('.pfx') ? urlOrCertFilename : urlOrCertFilename + '.pfx';
+    const certPath = path.join(certDirectory, certName);
+    if (!fs.existsSync(certPath)) {
+        throw Error(`File ${certPath} does not exist. Generate this first if you want to install it.`);
+    }
+    const psCommand = `${powershellHackPrefix}Import-PfxCertificate -FilePath '${certPath}' -CertStoreLocation Cert:\\LocalMachine\\Root`;
+    const result = await nodeCliUtils.spawnAsync('powershell', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', psCommand]);
+    if (result.code !== 0) {
+        throw Error(`powershell command to install cert failed with exit code ${result.code}`);
+    }
+}
+/**
+ * Uses Powershell to uninstall a cert from the local machine's trusted root store. Must have admin permissions.
+ * @param urlOrSubject The url or subject of the cert to uninstall. If the cert was installed with the winInstallCert method, this will be the url passed to that method.
+ */
+export async function winUninstallCert(urlOrSubject) {
+    nodeCliUtils.requireString('urlOrSubject', urlOrSubject);
+    log(requiresAdminMessage);
+    const psCommand = `${powershellHackPrefix}Get-ChildItem Cert:\\LocalMachine\\Root | Where-Object { $_.Subject -match '${urlOrSubject}' } | Remove-Item`;
+    const result = await nodeCliUtils.spawnAsync('powershell', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', psCommand]);
+    if (result.code !== 0) {
+        throw Error(`powershell command to uninstall cert failed with exit code ${result.code}`);
+    }
+}
+/**
+ * Does not actually do anything - just outputs the manual instructions for installing a cert for use by chrome on linux.
+ */
+export function linuxInstallCert() {
+    const instructions = `Automated linux cert install not supported (chrome does not use system certs without significant extra configuration).
+Manual Instructions:
+- In Chrome, go to chrome://settings/certificates
+- Select Authorities -> import
+- Select your generated .crt file (in the ./cert/ directory by default - if you haven't generated it, see the generateCertWithOpenSsl method)
+- Check box for "Trust certificate for identifying websites"
+- Click OK
+- Reload site`;
+    console.log(instructions);
+}
+/**
+ * Uses Powershell to check if a cert is already installed to the local machine's trusted root store.
+ * @param urlOrSubject The url or subject of the cert to check. If the cert was installed with the winInstallCert method, this will be the url passed to that method.
+ * @returns `true` if the cert is already installed, `false` otherwise.
+ */
+export async function winCertAlreadyInstalled(urlOrSubject) {
+    const psCommand = `${powershellHackPrefix}Get-ChildItem Cert:\\LocalMachine\\Root | Where-Object { $_.Subject -match '${urlOrSubject}' }`;
+    // The stdio option of 'pipe' is important here - if left to default of spawnAsync ('inherit'), stdout will be empty
+    const result = await nodeCliUtils.spawnAsync('powershell', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', psCommand], { stdio: ['inherit', 'pipe', 'pipe'] });
+    if (result.code !== 0) {
+        throw Error(`powershell command to find installed cert failed with exit code ${result.code}`);
+    }
+    const lines = nodeCliUtils.stringToNonEmptyLines(result.stdout);
+    for (const line of lines) {
+        if (line.includes(urlOrSubject)) {
+            return true;
+        }
+    }
+    return false;
+}
+function throwIfMaybeBadUrlChars(url, varName = 'url') {
+    if (url.includes(' ')) {
+        throw Error(`${varName} should not contain spaces`);
+    }
+    if (url.includes('/')) {
+        throw Error(`${varName} should not contain forward slashes`);
+    }
+    if (url.includes('\\')) {
+        throw Error(`${varName} should not contain backslashes`);
+    }
+}
+function getBrewOpensslPath() {
+    const brewResult = nodeCliUtils.simpleSpawnSync('brew', ['--prefix', 'openssl']);
+    if (brewResult.error) {
+        throw Error('error attempting to find openssl installed by brew');
+    }
+    if (brewResult.stdoutLines.length === 0 || brewResult.stdoutLines.length > 1) {
+        throw new Error(`unexpected output from brew command 'brew --prefix openssl': ${brewResult.stdout}`);
+    }
+    return brewResult.stdoutLines[0];
+}
+function getSanCnfFileContents(url) {
+    return sanCnfTemplate.replace(/{{url}}/g, url);
+}
+// Newer cert requirements force the need for "extension info" with DNS and IP info, but openssl v1.x doesn't support that with the
+// CLI option -addext, so we're using a san.cnf file instead and passing this into the CLI command with the -config option.
+const sanCnfTemplate = `[req]
+distinguished_name=req
+x509_extensions = v3_req
+prompt = no
+
+[req_distinguished_name]
+CN = {{url}}
+
+[v3_req]
+subjectAltName = @alt_names
+
+[alt_names]
+DNS.1 = {{url}}
+IP.1 = 127.0.0.1
+
+`;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2VydFV0aWxzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NlcnRVdGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUE7QUFDeEIsT0FBTyxHQUFHLE1BQU0sa0JBQWtCLENBQUE7QUFDbEMsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFBO0FBQzVCLE9BQU8sS0FBSyxZQUFZLE1BQU0sbUJBQW1CLENBQUE7QUFDakQsT0FBTyxFQUFFLEdBQUcsRUFBRSxNQUFNLG1CQUFtQixDQUFBO0FBRXZDLE1BQU0sb0JBQW9CLEdBQUcsMENBQTBDLENBQUE7QUFDdkUsTUFBTSxvQkFBb0IsR0FBRyx3RkFBd0YsQ0FBQTtBQUVySDs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSx1QkFBdUIsQ0FBQyxHQUFXLEVBQUUsa0JBQTBCLFFBQVE7SUFDM0YsWUFBWSxDQUFDLGFBQWEsQ0FBQyxLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUE7SUFDdEMsdUJBQXVCLENBQUMsR0FBRyxDQUFDLENBQUE7SUFDNUIsTUFBTSxLQUFLLEdBQUcsWUFBWSxDQUFDLGFBQWEsRUFBRSxDQUFBO0lBQzFDLE1BQU0sU0FBUyxHQUFHLEVBQUUsR0FBRyxFQUFFLGVBQWUsRUFBRSxDQUFBO0lBRTFDLEdBQUcsQ0FBQyxvQ0FBb0MsQ0FBQyxDQUFBO0lBQ3pDLElBQUksZUFBZSxHQUFXLEVBQUUsQ0FBQTtJQUNoQyxJQUFJLENBQUMsS0FBSyxFQUFFO1FBQ1YsTUFBTSxXQUFXLEdBQUcsWUFBWSxDQUFDLFNBQVMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxRQUFRLENBQUE7UUFDOUQsSUFBSSxDQUFDLFdBQVcsRUFBRTtZQUNoQixNQUFNLEtBQUssQ0FBQyx1Q0FBdUMsQ0FBQyxDQUFBO1NBQ3JEO1FBQ0QsR0FBRyxDQUFDLHVCQUF1QixXQUFXLEVBQUUsQ0FBQyxDQUFBO0tBQzFDO1NBQU0sSUFBSSxLQUFLLEVB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

package/dist/esm/dbMigrationUtils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Wrapper function for `dotnet ef`. If you don't pass `false` for `noBuild`, be sure the project has already been built by some other means.
+ *
+ * Docs for "dotnet ef" CLI: https://learn.microsoft.com/en-us/ef/core/cli/dotnet.
+ * @param projectPath Path to project that has the DbContext and Migration files used for the `--project` argument
+ * @param dbContextName The name of the DbContext class used for the `--context` argument
+ * @param args Arguments to pass to the `dotnet ef` CLI
+ * @param noBuild If true, the `--no-build` argument will be passed to the `dotnet ef` CLI (default: true)
+ */
+export declare function dotnetEfCommand(projectPath: string, dbContextName: string, args: string[], noBuild?: boolean): Promise<number>;
+/**
+ * Wrapper function for `dotnet ef migrations list`.
+ * @param projectPath The path to the project that contains the DbContext and Migration files
+ * @param dbContextName The name of the DbContext class
+ */
+export declare function efMigrationsList(projectPath: string, dbContextName: string): Promise<void>;
+/**
+ * Wrapper function for `dotnet ef database update <migration_name>`.
+ * @param projectPath The path to the project that contains the DbContext and Migration files
+ * @param dbContextName The name of the DbContext class
+ * @param migrationName The name of the migration to update to (optional). If not provided, all migrations will be applied.
+ */
+export declare function efMigrationsUpdate(projectPath: string, dbContextName: string, migrationName?: string): Promise<void>;
+/**
+ *
+ * @param projectPath The path to the project that contains the DbContext and Migration files
+ * @param dbContextName The name of the DbContext class
+ * @param migrationName The name of the migration to add
+ * @param withBoilerplate If true, boilerplate will be added to the migration C# file and empty Up and Down SQL files will be created
+ */
+export declare function efAddMigration(projectPath: string, dbContextName: string, migrationName: string, withBoilerplate?: boolean): Promise<void>;
+/**
+ *
+ * @param projectPath The path to the project that contains the DbContext and Migration files
+ * @param dbContextName The name of the DbContext class
+ * @param skipConfirm If `true`, the user will not be prompted to confirm the removal of the last migration
+ */
+export declare function efRemoveLastMigration(projectPath: string, dbContextName: string, skipConfirm?: boolean): Promise<void>;
+//# sourceMappingURL=dbMigrationUtils.d.ts.map

package/dist/esm/dbMigrationUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbMigrationUtils.d.ts","sourceRoot":"","sources":["../../src/dbMigrationUtils.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,UAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjI;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iBAEhF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,iBAE1G;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,UAAQ,iBAY9H;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,UAAQ,iBAe1G"}

package/dist/esm/dbMigrationUtils.js

@@ -0,0 +1,194 @@
+import { getConfirmation, log, requireString, requireValidPath, spawnAsync } from './generalUtils.js';
+import path from 'node:path';
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+/**
+ * Wrapper function for `dotnet ef`. If you don't pass `false` for `noBuild`, be sure the project has already been built by some other means.
+ *
+ * Docs for "dotnet ef" CLI: https://learn.microsoft.com/en-us/ef/core/cli/dotnet.
+ * @param projectPath Path to project that has the DbContext and Migration files used for the `--project` argument
+ * @param dbContextName The name of the DbContext class used for the `--context` argument
+ * @param args Arguments to pass to the `dotnet ef` CLI
+ * @param noBuild If true, the `--no-build` argument will be passed to the `dotnet ef` CLI (default: true)
+ */
+export async function dotnetEfCommand(projectPath, dbContextName, args, noBuild = true) {
+    requireValidPath('projectPath', projectPath);
+    requireString('dbContextName', dbContextName);
+    const result = await spawnAsync('dotnet', ['ef', '--project', projectPath, ...args, '--context', dbContextName, ...(noBuild ? ['--no-build'] : [])]);
+    return result.code;
+}
+/**
+ * Wrapper function for `dotnet ef migrations list`.
+ * @param projectPath The path to the project that contains the DbContext and Migration files
+ * @param dbContextName The name of the DbContext class
+ */
+export async function efMigrationsList(projectPath, dbContextName) {
+    await dotnetEfCommand(projectPath, dbContextName, ['migrations', 'list']);
+}
+/**
+ * Wrapper function for `dotnet ef database update <migration_name>`.
+ * @param projectPath The path to the project that contains the DbContext and Migration files
+ * @param dbContextName The name of the DbContext class
+ * @param migrationName The name of the migration to update to (optional). If not provided, all migrations will be applied.
+ */
+export async function efMigrationsUpdate(projectPath, dbContextName, migrationName) {
+    await dotnetEfCommand(projectPath, dbContextName, ['database', 'update', ...(migrationName ? [migrationName] : [])]);
+}
+/**
+ *
+ * @param projectPath The path to the project that contains the DbContext and Migration files
+ * @param dbContextName The name of the DbContext class
+ * @param migrationName The name of the migration to add
+ * @param withBoilerplate If true, boilerplate will be added to the migration C# file and empty Up and Down SQL files will be created
+ */
+export async function efAddMigration(projectPath, dbContextName, migrationName, withBoilerplate = false) {
+    const projectDirectory = projectPath.endsWith('.csproj') ? projectPath.substring(0, projectPath.lastIndexOf('/')) : projectPath;
+    const migrationsOutputDir = getMigrationsProjectRelativePath(dbContextName);
+    await dotnetEfCommand(projectPath, dbContextName, ['migrations', 'add', migrationName, '-o', migrationsOutputDir]);
+    if (withBoilerplate) {
+        try {
+            await addDbMigrationBoilerplate(projectDirectory, dbContextName, migrationName);
+        }
+        catch (error) {
+            console.error(error);
+            await efRemoveLastMigration(projectPath, dbContextName, true);
+        }
+    }
+}
+/**
+ *
+ * @param projectPath The path to the project that contains the DbContext and Migration files
+ * @param dbContextName The name of the DbContext class
+ * @param skipConfirm If `true`, the user will not be prompted to confirm the removal of the last migration
+ */
+export async function efRemoveLastMigration(projectPath, dbContextName, skipConfirm = false) {
+    const lastMigrationName = await getLastMigrationName(projectPath, dbContextName);
+    if (!skipConfirm && !await getConfirmation(`Are you sure you want to remove the last migration: ➡️${lastMigrationName}?`)) {
+        return;
+    }
+    const returnCode = await dotnetEfCommand(projectPath, dbContextName, ['migrations', 'remove']);
+    if (returnCode !== 0) {
+        throw new Error(`dotnet ef migrations remove returned non-zero exit code: ${returnCode}`);
+    }
+    log(`Removing migration SQL script files for migration if they're empty`);
+    await deleteScriptFileIfEmpty(getScriptPath(projectPath, lastMigrationName, true));
+    await deleteScriptFileIfEmpty(getScriptPath(projectPath, lastMigrationName, false));
+}
+async function deleteScriptFileIfEmpty(scriptPath) {
+    if (fs.existsSync(scriptPath)) {
+        const scriptContents = fs.readFileSync(scriptPath, { encoding: 'utf8' });
+        if (scriptContents.trim().length === 0) {
+            await fsp.unlink(scriptPath);
+        }
+        else {
+            log(`⚠️ Skipping deletion of non-empty script file: ${scriptPath}`);
+        }
+    }
+}
+async function getLastMigrationName(projectPath, dbContextName) {
+    const migrationsDirectory = getMigrationsDirectory(projectPath, dbContextName);
+    const filenames = fs.readdirSync(migrationsDirectory);
+    const migrationNames = filenames.filter(filename => filename.endsWith('.cs') &&
+        !filename.endsWith('.Designer.cs') &&
+        !filename.endsWith('.ModelSnapshot.cs') &&
+        filename.includes('_')).map(filename => filename.substring(0, filename.length - 3));
+    const migrationNamesWithTimestamps = migrationNames.map(migrationName => {
+        const timestamp = migrationName.substring(0, 14);
+        const name = migrationName.substring(15);
+        return { timestamp, name };
+    });
+    log(`Found migrations: ${migrationNamesWithTimestamps.map(m => m.name).join(', ')}`);
+    log(`Found timestamps: ${migrationNamesWithTimestamps.map(m => m.timestamp).join(', ')}`);
+    const sortedMigrationNames = migrationNamesWithTimestamps.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    const lastMigrationName = sortedMigrationNames[sortedMigrationNames.length - 1].name;
+    return lastMigrationName;
+}
+function getMigrationsProjectRelativePath(dbContextName) {
+    return `Migrations/${dbContextName}Migrations`;
+}
+function getMigrationsDirectory(projectDirectory, dbContextName) {
+    return path.join(projectDirectory, `Migrations/${dbContextName}Migrations`);
+}
+function getScriptPath(projectDirectory, migrationName, isUp) {
+    return path.join(projectDirectory, `Scripts/${migrationName}${isUp ? '' : '_Down'}.sql`);
+}
+async function addDbMigrationBoilerplate(projectDirectory, dbContextName, migrationName) {
+    const migrationsOutputDir = getMigrationsDirectory(projectDirectory, dbContextName);
+    if (!fs.existsSync(migrationsOutputDir)) {
+        throw new Error(`Unable to add migration C# boilerplate - could not find migrations output directory: ${migrationsOutputDir}`);
+    }
+    log(`Checking for generated C# file 📄XXXX_${migrationName}.cs in directory 📁${migrationsOutputDir}`);
+    const filenamePattern = `_${migrationName}.cs`;
+    const filenames = fs.readdirSync(migrationsOutputDir).filter(filename => filename.endsWith(filenamePattern));
+    if (!filenames || filenames.length === 0) {
+        throw new Error(`Auto-generated migration file not found - migrations output directory has no C# files ending with : ${filenamePattern}`);
+    }
+    if (filenames.length > 1) {
+        throw new Error(`Auto-generated migration file not found - migrations output directory has multiple C# files with the same migration name: ${filenames.join(', ')}`);
+    }
+    const filename = filenames[0];
+    const filePath = path.join(migrationsOutputDir, filename);
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Issue generating file path for migration (not found): ${filePath}`);
+    }
+    log(`Adding boilerplate to file 📄${filePath}`);
+    const usingLine = 'using MikeyT.DbMigrations;';
+    const upLine = `MigrationScriptRunner.RunScript(migrationBuilder, "${migrationName}.sql");`;
+    const downLine = `MigrationScriptRunner.RunScript(migrationBuilder, "${migrationName}_Down.sql");`;
+    const fileContents = await fsp.readFile(filePath, { encoding: 'utf8' });
+    const lines = fileContents.replaceAll('\r', '').split('\n');
+    const newLines = [];
+    newLines.push(lines[0].trim());
+    newLines.push(usingLine);
+    let addUpLine = false;
+    let addDownLine = false;
+    let skipNextLineIfBlank = false;
+    for (let i = 1; i < lines.length; i++) {
+        if (skipNextLineIfBlank && lines[i].trim().length === 0) {
+            skipNextLineIfBlank = false;
+            continue;
+        }
+        if (addUpLine) {
+            const newLine = lines[i].replace('{', `{\n\t\t\t${upLine}`);
+            newLines.push(newLine);
+            addUpLine = false;
+            skipNextLineIfBlank = true;
+            continue;
+        }
+        if (addDownLine) {
+            const newLine = lines[i].replace('{', `{\n\t\t\t${downLine}`);
+            newLines.push(newLine);
+            addDownLine = false;
+            skipNextLineIfBlank = true;
+            continue;
+        }
+        newLines.push(lines[i]);
+        if (lines[i].includes('void Up')) {
+            addUpLine = true;
+        }
+        if (lines[i].includes('void Down')) {
+            addDownLine = true;
+        }
+    }
+    const newFileContents = newLines.join('\n');
+    await fsp.writeFile(filePath, newFileContents, { encoding: 'utf8' });
+    log(`Updated file with boilerplate - please ensure it is correct: ${filePath}`);
+    const upScriptPath = path.join(projectDirectory, `Scripts/${migrationName}.sql`);
+    const downScriptPath = path.join(projectDirectory, `Scripts/${migrationName}_Down.sql`);
+    log('\nCreating corresponding empty sql files (no action will be taken if they already exist):');
+    log(`  - 📄${upScriptPath}`);
+    log(`  - 📄${downScriptPath}\n`);
+    if (!fs.existsSync(upScriptPath)) {
+        await fsp.writeFile(upScriptPath, '', { encoding: 'utf8' });
+    }
+    else {
+        log('Skipping Up sql script (already exists)');
+    }
+    if (!fs.existsSync(downScriptPath)) {
+        await fsp.writeFile(downScriptPath, '', { encoding: 'utf8' });
+    }
+    else {
+        log('Skipping Down sql script (already exists)');
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGJNaWdyYXRpb25VdGlscy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kYk1pZ3JhdGlvblV0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxlQUFlLEVBQUUsR0FBRyxFQUFFLGFBQWEsRUFBRSxnQkFBZ0IsRUFBRSxVQUFVLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQTtBQUNyRyxPQUFPLElBQUksTUFBTSxXQUFXLENBQUE7QUFDNUIsT0FBTyxFQUFFLE1BQU0sU0FBUyxDQUFBO0FBQ3hCLE9BQU8sR0FBRyxNQUFNLGtCQUFrQixDQUFBO0FBRWxDOzs7Ozs7OztHQVFHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxlQUFlLENBQUMsV0FBbUIsRUFBRSxhQUFxQixFQUFFLElBQWMsRUFBRSxPQUFPLEdBQUcsSUFBSTtJQUM5RyxnQkFBZ0IsQ0FBQyxhQUFhLEVBQUUsV0FBVyxDQUFDLENBQUE7SUFDNUMsYUFBYSxDQUFDLGVBQWUsRUFBRSxhQUFhLENBQUMsQ0FBQTtJQUM3QyxNQUFNLE1BQU0sR0FBRyxNQUFNLFVBQVUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxJQUFJLEVBQUUsV0FBVyxFQUFFLFdBQVcsRUFBRSxHQUFHLElBQUksRUFBRSxXQUFXLEVBQUUsYUFBYSxFQUFFLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsWUFBWSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUNwSixPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUE7QUFDcEIsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLGdCQUFnQixDQUFDLFdBQW1CLEVBQUUsYUFBcUI7SUFDL0UsTUFBTSxlQUFlLENBQUMsV0FBVyxFQUFFLGFBQWEsRUFBRSxDQUFDLFlBQVksRUFBRSxNQUFNLENBQUMsQ0FBRSxDQUFBO0FBQzVFLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsa0JBQWtCLENBQUMsV0FBbUIsRUFBRSxhQUFxQixFQUFFLGFBQXNCO0lBQ3pHLE1BQU0sZUFBZSxDQUFDLFdBQVcsRUFBRSxhQUFhLEVBQUUsQ0FBQyxVQUFVLEVBQUUsUUFBUSxFQUFFLEdBQUcsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDLENBQUMsYUFBYSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQTtBQUN0SCxDQUFDO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxjQUFjLENBQUMsV0FBbUIsRUFBRSxhQUFxQixFQUFFLGFBQXFCLEVBQUUsZUFBZSxHQUFHLEtBQUs7SUFDN0gsTUFBTSxnQkFBZ0IsR0FBRyxXQUFXLENBQUMsUUFBUSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxXQUFXLENBQUMsU0FBUyxDQUFDLENBQUMsRUFBRSxXQUFXLENBQUMsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsQ0FBQTtJQUMvSCxNQUFNLG1CQUFtQixHQUFHLGdDQUFnQyxDQUFDLGFBQWEsQ0FBQyxDQUFBO0lBQzNFLE1BQU0sZUFBZSxDQUFDLFdBQVcsRUFBRSxhQUFhLEVBQUUsQ0FBQyxZQUFZLEVBQUUsS0FBSyxFQUFFLGFBQWEsRUFBRSxJQUFJLEVBQUUsbUJBQW1CLENBQUMsQ0FBQyxDQUFBO0lBQ2xILElBQUksZUFBZSxFQUFFO1FBQ25CLElBQUk7WUFDRixNQUFNLHlCQUF5QixDQUFDLGdCQUFnQixFQUFFLGFBQWEsRUFBRSxhQUFhLENBQUMsQ0FBQTtTQUNoRjtRQUFDLE9BQU8sS0FBSyxFQUFFO1lBQ2QsT0FBTyxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQTtZQUNwQixNQUFNLHFCQUFxQixDQUFDLFdBQVcsRUFBRSxhQUFhLEVBQUUsSUFBSSxDQUFDLENBQUE7U0FDOUQ7S0FDRjtBQUNILENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUscUJBQXFCLENBQUMsV0FBbUIsRUFBRSxhQUFxQixFQUFFLFdBQVcsR0FBRyxLQUFLO0lBQ3pHLE1BQU0saUJBQWlCLEdBQUcsTUFBTSxvQkFBb0IsQ0FBQyxXQUFXLEVBQUUsYUFBYSxDQUFDLENBQUE7SUFFaEYsSUFBSSxDQUFDLFdBQVcsSUFBSSxDQUFDLE1BQU0sZUFBZSxDQUFDLHlEQUF5RCxpQkFBaUIsR0FBRyxDQUFDLEVBQUU7UUFDekgsT0FBTTtLQUNQO0lBRUQsTUFBTSxVQUFVLEdBQUcsTUFBTSxlQUFlLENBQUMsV0FBVyxFQUFFLGFBQWEsRUFBRSxDQUFDLFlBQVksRUFBRSxRQUFRLENBQUMsQ0FBQyxDQUFBO0lBQzlGLElBQUksVUFBVSxLQUFLLENBQUMsRUFBRTtRQUNwQixNQUFNLElBQUksS0FBSyxDQUFDLDREQUE0RCxVQUFVLEVBQUUsQ0FBQyxDQUFBO0tBQzFGO0lBRUQsR0FBRyxDQUFDLG9FQUFvRSxDQUFDLENBQUE7SUFDekUsTUFBTSx1QkFBdUIsQ0FBQyxhQUFhLENBQUMsV0FBVyxFQUFFLGlCQUFpQixFQUFFLElBQUksQ0FBQyxDQUFDLENBQUE7SUFDbEYsTUFBTSx1QkFBdUIsQ0FBQyxhQUFhLENBQUMsV0FBVyxFQUFFLGlCQUFpQixFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUE7QUFDckYsQ0FBQztBQUVELEtBQUssVUFBVSx1QkFBdUIsQ0FBQyxVQUFrQjtJQUN2RCxJQUFJLEVBQUUsQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLEVBQUU7UUFDN0IsTUFBTSxjQUFjLEdBQUcsRUFBRSxDQUFDLFlBQVksQ0FBQyxVQUFVLEVBQUUsRUFBRSxRQUFRLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQTtRQUN4RSxJQUFJLGNBQWMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFO1lBQ3RDLE1BQU0sR0FBRyxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsQ0FBQTtTQUM3QjthQUFNO1lBQ0wsR0FBRyxDQUFDLGtEQUFrRCxVQUFVLEVBQUUsQ0FBQyxDQUFBO1NBQ3BFO0tBQ0Y7QUFDSCxDQUFDO0FBRUQsS0FBSyxVQUFVLG9CQUFvQixDQUFDLFdBQW1CLEVBQUUsYUFBcUI7SUFDNUUsTUFBTSxtQkFBbUIsR0FBRyxzQkFBc0IsQ0FBQyxXQUFXLEVBQUUsYUFBYSxDQUFDLENBQUE7SUFDOUUsTUFBTSxTQUFTLEdBQUcsRUFBRSxDQUFDLFdBQVcsQ0FBQyxtQkFBbUIsQ0FBQyxDQUFBO0lBQ3JELE1BQU0sY0FBYyxHQUFHLFNBQVMsQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FDakQsUUFBUSxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUM7UUFDeEIsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLGNBQWMsQ0FBQztRQUNsQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsbUJBQW1CLENBQUM7UUFDdkMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDLFFBQVEsQ0FBQyxTQUFTLENBQUMsQ0FBQyxFQUFFLFFBQVEsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUNyRixNQUFNLDRCQUE0QixHQUFHLGNBQWMsQ0FBQyxHQUFHLENBQUMsYUFBYSxDQUFDLEVBQUU7UUFDdEUsTUFBTSxTQUFTLEdBQUcsYUFBYSxDQUFDLFNBQVMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUE7UUFDaEQsTUFBTSxJQUFJLEdBQUcsYUFBYSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsQ0FBQTtRQUN4QyxPQUFPLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxDQUFBO0lBQzVCLENBQUMsQ0FBQyxDQUFBO0lBQ0YsR0FBRyxDQUFDLHFCQUFxQiw0QkFBNEIsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQTtJQUNwRixHQUFHLENBQUMscUJBQXFCLDRCQUE0QixDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxDQUFBO0lBQ3pGLE1BQU0sb0JBQW9CLEdBQUcsNEJBQTRCLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxhQUFhLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUE7SUFDaEgsTUFBTSxpQkFBaUIsR0FBRyxvQkFBb0IsQ0FBQyxvQkFBb0IsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFBO0lBQ3BGLE9BQU8saUJBQWlCLENBQUE7QUFDMUIsQ0FBQztBQUVELFNBQVMsZ0NBQWdDLENBQUMsYUFBcUI7SUFDN0QsT0FBTyxjQUFjLGFBQWEsWUFBWSxDQUFBO0FBQ2hELENBQUM7QUFFRCxTQUFTLHNCQUFzQixDQUFDLGdCQUF3QixFQUFFLGFBQXFCO0lBQzdFLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxnQkFBZ0IsRUFBRSxjQUFjLGFBQWEsWUFBWSxDQUFDLENBQUE7QUFDN0UsQ0FBQztBQUVELFNBQVMsYUFBYSxDQUFDLGdCQUF3QixFQUFFLGFBQXFCLEVBQUUsSUFBYTtJQUNuRixPQUFPLElBQUksQ0FBQyxJQUFJLENBQUMsZ0JBQWdCLEVBQUUsV0FBVyxhQUFhLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLE9BQU8sTUFBTSxDQUFDLENBQUE7QUFDMUYsQ0FBQztBQUVELEtBQUssVUFBVSx5QkFBeUIsQ0FBQyxnQkFBd0IsRUFBRSxhQUFxQixFQUFFLGFBQXFCO0lBQzdHLE1BQU0sbUJBQW1CLEdBQUcsc0JBQXNCLENBQUMsZ0JBQWdCLEVBQUUsYUFBYSxDQUFDLENBQUE7SUFFbkYsSUFBSSxDQUFDLEVBQUUsQ0FBQyxVQUFVLENBQUMsbUJBQW1CLENBQUMsRUFBRTtRQUN2QyxNQUFNLElBQUksS0FBSyxDQUFDLHdGQUF3RixtQkFBbUIsRUFBRSxDQUFDLENBQUE7S0FDL0g7SUFFRCxHQUFHLENBQUMseUNBQXlDLGFBQWEsc0JBQXNCLG1CQUFtQixFQUFFLENBQUMsQ0FBQTtJQUV0RyxNQUFNLGVBQWUsR0FBRyxJQUFJLGFBQWEsS0FBSyxDQUFBO0lBQzlDLE1BQU0sU0FBUyxHQUFHLEVBQUUsQ0FBQyxXQUFXLENBQUMsbUJBQW1CLENBQUMsQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLGVBQWUsQ0FBQyxDQUFDLENBQUE7SUFDNUcsSUFBSSxDQUFDLFNBQVMsSUFBSSxTQUFTLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRTtRQUN4QyxNQUFNLElBQUksS0FBSyxDQUFDLHVHQUF1RyxlQUFlLEVBQUUsQ0FBQyxDQUFBO0tBQzFJO0lBRUQsSUFBSSxTQUFTLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRTtRQUN4QixNQUFNLElBQUksS0FBSyxDQUFDLDZIQUE2SCxTQUFTLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQTtLQUNySztJQUVELE1BQU0sUUFBUSxHQUFHLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQTtJQUM3QixNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLG1CQUFtQixFQUFFLFFBQVEsQ0FBQyxDQUFBO0lBRXpELElBQUksQ0FBQyxFQUFFLENBQUMsVUFBVSxDQUFDLFFBQVEsQ0FBQyxFQUFFO1FBQzVCLE1BQU0sSUFBSSxLQUFLLENBQUMseURBQXlELFFBQVEsRUFBRSxDQUFDLENBQUE7S0FDckY7SUFFRCxHQUFHLENBQUMsZ0NBQWdDLFFBQVEsRUFBRSxDQUFDLENBQUE7SUFFL0MsTUFBTSxTQUFTLEdBQUcsNEJBQTRCLENBQUE7SUFDOUMsTUFBTSxNQUFNLEdBQUcsc0RBQXNELGFBQWEsU0FBUyxDQUFBO0lBQzNGLE1BQU0sUUFBUSxHQUFHLHNEQUFzRCxhQUFhLGNBQWMsQ0FBQTtJQUVsRyxNQUFNLFlBQVksR0FBRyxNQUFNLEdBQUcsQ0FBQyxRQUFRLENBQUMsUUFBUSxFQUFFLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxDQUFDLENBQUE7SUFDdkUsTUFBTSxLQUFLLEdBQUcsWUFBWSxDQUFDLFVBQVUsQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFBO0lBRTNELE1BQU0sUUFBUSxHQUFHLEVBQUUsQ0FBQTtJQUVuQixRQUFRLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFBO0lBQzlCLFFBQVEsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUE7SUFFeEIsSUFBSSxTQUFTLEdBQUcsS0FBSyxDQUFBO0lBQ3JCLElBQUksV0FBVyxHQUFHLEtBQUssQ0FBQTtJQUN2QixJQUFJLG1CQUFtQixHQUFHLEtBQUssQ0FBQTtJQUMvQixLQUFLLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLEdBQUcsS0FBSyxDQUFDLE1BQU0sRUFBRSxDQUFDLEVBQUUsRUFBRTtRQUNyQyxJQUFJLG1CQUFtQixJQUFJLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFO1lBQ3ZELG1CQUFtQixHQUFHLEtBQUssQ0FBQTtZQUMzQixTQUFRO1NBQ1Q7UUFDRCxJQUFJLFNBQVMsRUFBRTtZQUNiLE1BQU0sT0FBTyxHQUFHLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLFlBQVksTUFBTSxFQUFFLENBQUMsQ0FBQTtZQUMzRCxRQUFRLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFBO1lBQ3RCLFNBQVMsR0FBRyxLQUFLLENBQUE7WUFDakIsbUJBQW1CLEdBQUcsSUFBSSxDQUFBO1lBQzFCLFNBQVE7U0FDVDtRQUNELElBQUksV0FBVyxFQUFFO1lBQ2YsTUFBTSxPQUFPLEdBQUcsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxHQUFHLEVBQUUsWUFBWSxRQUFRLEVBQUUsQ0FBQyxDQUFBO1lBQzdELFFBQVEsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUE7WUFDdEIsV0FBVyxHQUFHLEtBQUssQ0FBQTtZQUNuQixtQkFBbUIsR0FBRyxJQUFJLENBQUE7WUFDMUIsU0FBUTtTQUNUO1FBQ0QsUUFBUSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQTtRQUN2QixJQUFJLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsU0FBUyxDQUFDLEVBQUU7WUFDaEMsU0FBUyxHQUFHLElBQUksQ0FBQTtTQUNqQjtRQUNELElBQUksS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxXQUFXLENBQUMsRUFBRTtZQUNsQyxXQUFXLEdBQUcsSUFBSSxDQUFBO1NBQ25CO0tBQ0Y7SUFFRCxNQUFNLGVBQWUsR0FBRyxRQUFRLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFBO0lBRTNDLE1BQU0sR0FBRyxDQUFDLFNBQVMsQ0FBQyxRQUFRLEVBQUUsZUFBZSxFQUFFLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxDQUFDLENBQUE7SUFFcEUsR0FBRyxDQUFDLGdFQUFnRSxRQUFRLEVBQUUsQ0FBQyxDQUFBO0lBRS9FLE1BQU0sWUFBWSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsZ0JBQWdCLEVBQUUsV0FBVyxhQUFhLE1BQU0sQ0FBQyxDQUFBO0lBQ2hGLE1BQU0sY0FBYyxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsZ0JBQWdCLEVBQUUsV0FBVyxhQUFhLFdBQVcsQ0FBQyxDQUFBO0lBRXZGLEdBQUcsQ0FBQywyRkFBMkYsQ0FBQyxDQUFBO0lBQ2hHLEdBQUcsQ0FBQyxTQUFTLFlBQVksRUFBRSxDQUFDLENBQUE7SUFDNUIsR0FBRyxDQUFDLFNBQVMsY0FBYyxJQUFJLENBQUMsQ0FBQTtJQUVoQyxJQUFJLENBQUMsRUFBRSxDQUFDLFVBQVUsQ0FBQyxZQUFZLENBQUMsRUFBRTtRQUNoQyxNQUFNLEdBQUcsQ0FBQyxTQUFTLENBQUMsWUFBWSxFQUFFLEVBQUUsRUFBRSxFQUFFLFFBQVEsRUFBRSxNQUFNLEVBQUUsQ0FBQyxDQUFBO0tBQzVEO1NBQU07UUFDTCxHQUFHLENBQUMseUNBQXlDLENBQUMsQ0FBQTtLQUMvQztJQUVELElBQUksQ0FBQyxFQUFFLENBQUMsVUFBVSxDQUFDLGNBQWMsQ0FBQyxFQUFFO1FBQ2xDLE1BQU0sR0FBRyxDQUFDLFNBQVMsQ0FBQyxjQUFjLEVBQUUsRUFBRSxFQUFFLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxDQUFDLENBQUE7S0FDOUQ7U0FBTTtRQUNMLEdBQUcsQ0FBQywyQ0FBMkMsQ0FBQyxDQUFBO0tBQ2pEO0FBQ0gsQ0FBQyJ9