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

package/dist/esm/certUtils.js

@@ -0,0 +1,271 @@
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import { Emoji, ensureDirectory, getPowershellHackArgs, isPlatformMac, isPlatformWindows, logIf, red, requireString, requireValidPath, simpleSpawnSync, spawnAsync, stringToNonEmptyLines, whichSync } from './generalUtils.js';
+const defaultCertLogOptions = {
+    logSpawnOutput: false,
+    logTraceMessages: false,
+    logElevatedPermissionsMessage: true,
+    logSuccess: true
+};
+/**
+ * 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 options Options for generating the cert.
+ * @returns The path to the generated pfx file.
+ */
+export async function generateCertWithOpenSsl(url, options) {
+    requireString('url', url);
+    throwIfMaybeBadUrlChars(url);
+    const isMac = isPlatformMac();
+    const mergedOptions = { ...defaultCertLogOptions, outputDirectory: './cert', ...options };
+    const spawnArgs = { cwd: mergedOptions.outputDirectory, stdio: mergedOptions.logSpawnOutput ? 'inherit' : 'pipe' };
+    logIf(mergedOptions.logTraceMessages, 'checking if openssl is installed');
+    let brewOpenSslPath = '';
+    if (!isMac) {
+        const openSslPath = whichSync('openssl').location;
+        if (!openSslPath) {
+            throw Error('openssl is required but was not found');
+        }
+        logIf(mergedOptions.logTraceMessages, `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 {
+            logIf(mergedOptions.logTraceMessages, `using openssl at: ${brewOpenSslPath}`);
+        }
+    }
+    ensureDirectory(mergedOptions.outputDirectory);
+    const crtName = url + '.crt';
+    const keyName = url + '.key';
+    const pfxName = url + '.pfx';
+    const sanCnfName = url + '.cnf';
+    const filesToCheck = [crtName, keyName, pfxName, sanCnfName];
+    for (const file of filesToCheck) {
+        const filePath = path.join(mergedOptions.outputDirectory, file);
+        if (fs.existsSync(filePath)) {
+            throw Error(`${Emoji.Stop} File ${filePath} already exists. Delete or rename all of the following files from '${mergedOptions.outputDirectory}' if you want to generate a new cert: ${filesToCheck.join(', ')}.`);
+        }
+    }
+    logIf(mergedOptions.logTraceMessages, `writing ${sanCnfName} file for use with openssl command`);
+    const sanCnfContents = getSanCnfFileContents(url);
+    const sanCnfPath = path.join(mergedOptions.outputDirectory, sanCnfName);
+    await fsp.writeFile(sanCnfPath, sanCnfContents);
+    logIf(mergedOptions.logTraceMessages, `attempting to generate cert ${pfxName}`);
+    const genKeyAndCrtArgs = `req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout ${keyName} -out ${crtName} -subj /CN=${url} -config ${sanCnfName}`.split(' ');
+    const command = isMac ? brewOpenSslPath : 'openssl';
+    let result = await spawnAsync(command, genKeyAndCrtArgs, spawnArgs);
+    throwIfSpawnResultError(result);
+    logIf(mergedOptions.logTraceMessages, '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 spawnAsync(command, convertToPfxArgs, spawnArgs);
+    throwIfSpawnResultError(result);
+    const pfxPath = path.join(mergedOptions.outputDirectory, pfxName);
+    logIf(mergedOptions.logSuccess, `${Emoji.GreenCheck} Successfully generated cert: ${pfxPath}`);
+    return pfxPath;
+}
+/**
+ * Uses Powershell to install a cert to the local machine's trusted root store. Must have elevated permissions.
+ * If the cert is already installed, this function will do nothing.
+ * @param pfxPath The path to the pfx file to install.
+ */
+export async function winInstallCert(pfxPath, options) {
+    if (!isPlatformWindows()) {
+        throw Error('winInstallCert is only supported on Windows');
+    }
+    validatePfxPath(pfxPath);
+    const mergedOptions = { ...defaultCertLogOptions, ...options };
+    logIf(mergedOptions.logElevatedPermissionsMessage, getRequiresElevatedPermissionsMessage(true));
+    if (await winCertIsInstalled({ pfxPath }, mergedOptions)) {
+        const certInfo = await winGetPfxInfo(pfxPath);
+        logIf(mergedOptions.logTraceMessages, `${Emoji.Warning} certificate '${pfxPath}' with subject '${certInfo.subject}' is already installed - to install it again, first uninstall it manually or with the winUninstallCert function`);
+        return;
+    }
+    logIf(mergedOptions.logTraceMessages, `installing cert '${pfxPath}'`);
+    const psCommandArgs = getPowershellHackArgs(`Import-PfxCertificate -FilePath '${pfxPath}' -CertStoreLocation Cert:\\LocalMachine\\Root`);
+    const result = await spawnAsync('powershell', psCommandArgs, { stdio: mergedOptions.logSpawnOutput ? 'inherit' : 'pipe' });
+    throwIfSpawnResultError(result);
+    logIf(mergedOptions.logSuccess, `${Emoji.GreenCheck} Successfully installed cert: ${pfxPath}`);
+}
+/**
+ * Uses Powershell to check if a cert is already installed to the local machine's trusted root store.
+ * Uses the subject of the cert in order to avoid false negatives from regenerating the same self-signed cert
+ * with the same subject but different thumbprint. Note that this method is geared towards use with certs generated
+ * with the {@link generateCertWithOpenSsl} function, so this may not work using subject if your subject is not precisely "`CN=<url>`".
+ * @param identifier The subject or path to the pfx file of the cert to check.
+ * @returns `true` if the cert is already installed, `false` otherwise.
+ */
+export async function winCertIsInstalled(identifier, options) {
+    if (!isPlatformWindows()) {
+        throw new Error('winCertIsInstalled is only supported on Windows');
+    }
+    const mergedOptions = { ...defaultCertLogOptions, ...options };
+    let psCommandArgs;
+    // Get the count of certs installed with the same subject as the one we're trying to install
+    if (typeof identifier === 'string') {
+        requireString('subject', identifier);
+        validateSubject(identifier);
+        const subject = identifier.startsWith('CN=') ? identifier : `CN=${identifier}`;
+        psCommandArgs = getPowershellHackArgs(`Write-Host (Get-ChildItem Cert:\\LocalMachine\\Root | Where-Object { $_.Subject -eq '${subject}' } | Measure-Object).Count`);
+    }
+    else if ('pfxPath' in identifier) {
+        validatePfxPath(identifier.pfxPath);
+        psCommandArgs = getPowershellHackArgs(`Write-Host (Get-ChildItem Cert:\\LocalMachine\\Root | Where-Object { $_.Subject -eq (Get-PfxCertificate -FilePath '${identifier.pfxPath}').Subject } | Measure-Object).Count`);
+    }
+    const tracePart = (typeof identifier === 'string') ? `subject ${identifier}` : `pfxPath ${identifier.pfxPath}`;
+    logIf(mergedOptions.logTraceMessages, `checking if cert with ${tracePart} is already installed`);
+    const result = await spawnAsync('powershell', psCommandArgs, { stdio: 'pipe' });
+    throwIfSpawnResultError(result);
+    const lines = stringToNonEmptyLines(result.stdout);
+    if (lines.length !== 1) {
+        throw new Error(`Unexpected output from powershell command to check if the cert is already installed: ${result.stdout}`);
+    }
+    return lines[0].trim() !== '0';
+}
+/**
+ * Uses Powershell to uninstall a cert from the local machine's trusted root store. Must have elevated permissions.
+ * @param identifier The subject, thumbprint or path to the pfx file of the cert to uninstall.
+ * @param options Options for uninstalling the cert.
+ */
+export async function winUninstallCert(identifier, options) {
+    if (!isPlatformWindows()) {
+        throw new Error('winUninstallCert is only supported on Windows');
+    }
+    const mergedOptions = { ...defaultCertLogOptions, ...options };
+    logIf(mergedOptions.logElevatedPermissionsMessage, getRequiresElevatedPermissionsMessage(false));
+    let psCommandArgs;
+    if (typeof identifier === 'string') {
+        requireString('subject', identifier);
+        validateSubject(identifier);
+        psCommandArgs = getPowershellHackArgs(`Get-ChildItem Cert:\\LocalMachine\\Root | Where-Object { $_.Subject -match '${identifier}' } | Remove-Item`);
+    }
+    else if ('thumbprint' in identifier) {
+        validateNoQuotes('thumbprint', identifier.thumbprint);
+        psCommandArgs = getPowershellHackArgs(`Get-ChildItem Cert:\\LocalMachine\\Root | Where-Object { $_.Thumbprint -eq '${identifier.thumbprint}' } | Remove-Item`);
+    }
+    else if ('pfxPath' in identifier) {
+        validatePfxPath(identifier.pfxPath);
+        psCommandArgs = getPowershellHackArgs(`$thumbprint = (Get-PfxCertificate -FilePath '${identifier.pfxPath}').Thumbprint; Get-ChildItem Cert:\\LocalMachine\\Root | Where-Object { $_.Thumbprint -eq $thumbprint } | Remove-Item`);
+    }
+    const tracePart = typeof identifier === 'string' ? `'${identifier}'` : JSON.stringify(identifier);
+    logIf(mergedOptions.logTraceMessages, `uninstalling cert ${tracePart}`);
+    const result = await spawnAsync('powershell', psCommandArgs, { stdio: mergedOptions.logSpawnOutput ? 'inherit' : 'pipe' });
+    throwIfSpawnResultError(result);
+    logIf(mergedOptions.logSuccess, `${Emoji.GreenCheck} Successfully uninstalled cert`);
+}
+/**
+ * Uses Powershell to get info about a cert.
+ * @param pfxPath The path to the pfx file to get info for.
+ * @returns The subject, thumbprint and pfxPath of the cert.
+ */
+export async function winGetPfxInfo(pfxPath) {
+    if (!isPlatformWindows()) {
+        throw new Error('winGetPfxInfo is only supported on Windows');
+    }
+    validatePfxPath(pfxPath);
+    const psCommandArgs = getPowershellHackArgs(`Get-PfxCertificate -FilePath '${pfxPath}' | Select-Object -Property Subject, Thumbprint, @{Name='PfxPath';Expression={'${pfxPath}'}} | ConvertTo-Json`);
+    const result = await spawnAsync('powershell', psCommandArgs, { stdio: 'pipe' });
+    throwIfSpawnResultError(result);
+    const json = result.stdout.trim();
+    const parsedJson = JSON.parse(json);
+    const certInfo = {
+        subject: parsedJson.Subject,
+        thumbprint: parsedJson.Thumbprint,
+        pfxPath: parsedJson.PfxPath
+    };
+    return certInfo;
+}
+/**
+ * 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 function)
+- Check box for "Trust certificate for identifying websites"
+- Click OK
+- Reload site`;
+    console.log(instructions);
+}
+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 = 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);
+}
+function validateSubject(subject) {
+    if (subject.includes('\\') || subject.includes('/') || subject.endsWith('.pfx')) {
+        throw new Error(`The subject appears to be a file path, which is not allowed. Did you mean to pass something like this instead: { pfxPath: '${subject}' } ?`);
+    }
+    validateNoQuotes('subject', subject);
+}
+function validateNoQuotes(name, value) {
+    if (value.includes("'") || value.includes('"')) {
+        throw new Error(`The value passed for '${name}' contains a single or double quote, which is not allowed.`);
+    }
+}
+function throwIfSpawnResultError(result) {
+    if (result.code !== 0) {
+        // There won't be any stderr if stdio was set to 'inherit', so we're checking first
+        if (result.stderr) {
+            console.error(red('Error:'), result.stderr);
+        }
+        throw Error(`Spawned command failed with exit code ${result.code}`);
+    }
+}
+function validatePfxPath(pfxPath) {
+    if (!pfxPath.endsWith('.pfx')) {
+        throw new Error('pfxPath must end with .pfx');
+    }
+    requireValidPath('pfxPath', pfxPath);
+    validateNoQuotes('pfxPath', pfxPath);
+}
+function getRequiresElevatedPermissionsMessage(isInstall = true) {
+    return `${Emoji.Info} Important: ${isInstall ? '' : 'un'}installing a certificate requires elevated permissions`;
+}
+// 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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2VydFV0aWxzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NlcnRVdGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUE7QUFDeEIsT0FBTyxHQUFHLE1BQU0sa0JBQWtCLENBQUE7QUFDbEMsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFBO0FBQzVCLE9BQU8sRUFDTCxLQUFLLEVBR0wsZUFBZSxFQUNmLHFCQUFxQixFQUNyQixhQUFhLEVBQ2IsaUJBQWlCLEVBQ2pCLEtBQUssRUFDTCxHQUFHLEVBQ0gsYUFBYSxFQUNiLGdCQUFnQixFQUNoQixlQUFlLEVBQ2YsVUFBVSxFQUNWLHFCQUFxQixFQUNyQixTQUFTLEVBQ1YsTUFBTSxtQkFBbUIsQ0FBQTtBQWUxQixNQUFNLHFCQUFxQixHQUFtQjtJQUM1QyxjQUFjLEVBQUUsS0FBSztJQUNyQixnQkFBZ0IsRUFBRSxLQUFLO0lBQ3ZCLDZCQUE2QixFQUFFLElBQUk7SUFDbkMsVUFBVSxFQUFFLElBQUk7Q0FDakIsQ0FBQTtBQVdEOzs7OztHQUtHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSx1QkFBdUIsQ0FBQyxHQUFXLEVBQUUsT0FBc0M7SUFDL0YsYUFBYSxDQUFDLEtBQUssRUFBRSxHQUFHLENBQUMsQ0FBQTtJQUN6Qix1QkFBdUIsQ0FBQyxHQUFHLENBQUMsQ0FBQTtJQUM1QixNQUFNLEtBQUssR0FBRyxhQUFhLEVBQUUsQ0FBQTtJQUU3QixNQUFNLGFBQWEsR0FBd0IsRUFBRSxHQUFHLHFCQUFxQixFQUFFLGVBQWUsRUFBRSxRQUFRLEVBQUUsR0FBRyxPQUFPLEVBQUUsQ0FBQTtJQUU5RyxNQUFNLFNBQVMsR0FBbUMsRUFBRSxHQUFHLEVBQUUsYUFBYSxDQUFDLGVBQWUsRUFBRSxLQUFLLEVBQUUsYUFBYSxDQUFDLGNBQWMsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQTtJQUVs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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,184 @@
+import { Emoji, 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(`${Emoji.Warning} 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 getCSharpMigrationFilePath(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 (bad file path): ${filePath}`);
+    }
+    return filePath;
+}
+async function addDbMigrationBoilerplate(projectDirectory, dbContextName, migrationName) {
+    const filePath = await getCSharpMigrationFilePath(projectDirectory, dbContextName, migrationName);
+    log(`Replacing file contents with boilerplate for file 📄${filePath}`);
+    const newFileContents = cSharpMigrationFileTemplate
+        .replaceAll(contextNamePlaceholder, dbContextName)
+        .replaceAll(migrationNamePlaceholder, migrationName);
+    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`);
+    await writeEmptySqlFileIfNotExists(upScriptPath, 'Up');
+    await writeEmptySqlFileIfNotExists(downScriptPath, 'Down');
+}
+async function writeEmptySqlFileIfNotExists(scriptPath, scriptType) {
+    if (!fs.existsSync(scriptPath)) {
+        await fsp.writeFile(scriptPath, '', { encoding: 'utf8' });
+    }
+    else {
+        log(`Skipping ${scriptType} sql script (already exists)`);
+    }
+}
+const contextNamePlaceholder = '{{context_name}}';
+const migrationNamePlaceholder = '{{migration_name}}';
+const cSharpMigrationFileTemplate = `using Microsoft.EntityFrameworkCore.Migrations;
+using MikeyT.DbMigrations;
+
+#nullable disable
+
+namespace DbMigrator.Migrations.${contextNamePlaceholder}Migrations
+{
+    public partial class ${migrationNamePlaceholder} : Migration
+    {
+        protected override void Up(MigrationBuilder migrationBuilder)
+        {
+            MigrationScriptRunner.RunScript(migrationBuilder, "${migrationNamePlaceholder}.sql");
+        }
+
+        protected override void Down(MigrationBuilder migrationBuilder)
+        {
+            MigrationScriptRunner.RunScript(migrationBuilder, "${migrationNamePlaceholder}_Down.sql");
+        }
+    }
+}
+
+`;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGJNaWdyYXRpb25VdGlscy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9kYk1pZ3JhdGlvblV0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLEVBQUUsZUFBZSxFQUFFLEdBQUcsRUFBRSxhQUFhLEVBQUUsZ0JBQWdCLEVBQUUsVUFBVSxFQUFFLE1BQU0sbUJBQW1CLENBQUE7QUFDNUcsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFBO0FBQzVCLE9BQU8sRUFBRSxNQUFNLFNBQVMsQ0FBQTtBQUN4QixPQUFPLEdBQUcsTUFBTSxrQkFBa0IsQ0FBQTtBQUVsQzs7Ozs7Ozs7R0FRRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsZUFBZSxDQUFDLFdBQW1CLEVBQUUsYUFBcUIsRUFBRSxJQUFjLEVBQUUsT0FBTyxHQUFHLElBQUk7SUFDOUcsZ0JBQWdCLENBQUMsYUFBYSxFQUFFLFdBQVcsQ0FBQyxDQUFBO0lBQzVDLGFBQWEsQ0FBQyxlQUFlLEVBQUUsYUFBYSxDQUFDLENBQUE7SUFDN0MsTUFBTSxNQUFNLEdBQUcsTUFBTSxVQUFVLENBQUMsUUFBUSxFQUFFLENBQUMsSUFBSSxFQUFFLFdBQVcsRUFBRSxXQUFXLEVBQUUsR0FBRyxJQUFJLEVBQUUsV0FBVyxFQUFFLGFBQWEsRUFBRSxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLFlBQVksQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUE7SUFDcEosT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFBO0FBQ3BCLENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxnQkFBZ0IsQ0FBQyxXQUFtQixFQUFFLGFBQXFCO0lBQy9FLE1BQU0sZUFBZSxDQUFDLFdBQVcsRUFBRSxhQUFhLEVBQUUsQ0FBQyxZQUFZLEVBQUUsTUFBTSxDQUFDLENBQUUsQ0FBQTtBQUM1RSxDQUFDO0FBRUQ7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

package/dist/esm/dotnetUtils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Runs dotnet build on the specified project.
+ * @param projectPath Path to project file (like .csproj) or directory of project to build
+ * @throws A {@link SpawnError} if the spawned process exits with a non-zero exit code
+ */
+export declare function dotnetBuild(projectPath: string): Promise<void>;
+/**
+ * Helper method to spawn a process and run 'dotnet publish'.
+ * @param projectPath Path to project file (like .csproj) or directory of project to build
+ * @param configuration Build configuration, such as 'Release'
+ * @param outputDir The relative or absolute path for the build output
+ * @param cwd Optionally run the command from another current working directory
+ */
+export declare function dotnetPublish(projectPath?: string, configuration?: string, outputDir?: string, cwd?: string): Promise<void>;
+/**
+ * Spawns a process that runs the necessary commands to install or update the dotnet-ef tool globally on the system.
+ */
+export declare function installOrUpdateDotnetEfTool(): Promise<void>;
+/**
+ * Spawns a process that runs the following commands to clean and re-install the dotnet dev certs:
+ * - dotnet dev-certs https --clean
+ * - dotnet dev-certs https -t
+ */
+export declare function configureDotnetDevCerts(): Promise<void>;
+//# sourceMappingURL=dotnetUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dotnetUtils.d.ts","sourceRoot":"","sources":["../../src/dotnetUtils.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,iBAGpD;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,GAAE,MAAa,EAAE,aAAa,GAAE,MAAkB,EAAE,SAAS,GAAE,MAAkB,EAAE,GAAG,CAAC,EAAE,MAAM,iBAY7I;AAED;;GAEG;AACH,wBAAsB,2BAA2B,kBAShD;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,kBAG5C"}

package/dist/esm/dotnetUtils.js

@@ -0,0 +1,54 @@
+import { log, requireString, requireValidPath, spawnAsync, trace, whichSync } from './generalUtils.js';
+/**
+ * Runs dotnet build on the specified project.
+ * @param projectPath Path to project file (like .csproj) or directory of project to build
+ * @throws A {@link SpawnError} if the spawned process exits with a non-zero exit code
+ */
+export async function dotnetBuild(projectPath) {
+    requireValidPath('projectPath', projectPath);
+    await spawnAsync('dotnet', ['build', projectPath], { throwOnNonZero: true });
+}
+/**
+ * Helper method to spawn a process and run 'dotnet publish'.
+ * @param projectPath Path to project file (like .csproj) or directory of project to build
+ * @param configuration Build configuration, such as 'Release'
+ * @param outputDir The relative or absolute path for the build output
+ * @param cwd Optionally run the command from another current working directory
+ */
+export async function dotnetPublish(projectPath = './', configuration = 'Release', outputDir = 'publish', cwd) {
+    requireValidPath('projectPath', projectPath);
+    requireString('outputDir', outputDir);
+    requireString('configuration', configuration);
+    if (cwd) {
+        requireValidPath('cwd', cwd);
+    }
+    const args = ['publish', projectPath, '-c', configuration, '-o', outputDir];
+    const traceMessage = `running dotnet ${args.join(' ')}`;
+    const traceAdditional = cwd ? ` in cwd ${cwd}` : '';
+    trace(`${traceMessage}${traceAdditional}`);
+    await spawnAsync('dotnet', args, { cwd: cwd });
+}
+/**
+ * Spawns a process that runs the necessary commands to install or update the dotnet-ef tool globally on the system.
+ */
+export async function installOrUpdateDotnetEfTool() {
+    const installed = whichSync('dotnet-ef').location;
+    if (installed) {
+        log('dotnet-ef tool already installed, updating...');
+    }
+    else {
+        log('dotnet-ef tool not installed, installing...');
+    }
+    const args = ['tool', installed ? 'update' : 'install', '--global', 'dotnet-ef'];
+    await spawnAsync('dotnet', args);
+}
+/**
+ * Spawns a process that runs the following commands to clean and re-install the dotnet dev certs:
+ * - dotnet dev-certs https --clean
+ * - dotnet dev-certs https -t
+ */
+export async function configureDotnetDevCerts() {
+    await spawnAsync('dotnet', ['dev-certs', 'https', '--clean']);
+    await spawnAsync('dotnet', ['dev-certs', 'https', '-t']);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG90bmV0VXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZG90bmV0VXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEdBQUcsRUFBRSxhQUFhLEVBQUUsZ0JBQWdCLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQTtBQU10Rzs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxXQUFXLENBQUMsV0FBbUI7SUFDbkQsZ0JBQWdCLENBQUMsYUFBYSxFQUFFLFdBQVcsQ0FBQyxDQUFBO0lBQzVDLE1BQU0sVUFBVSxDQUFDLFFBQVEsRUFBRSxDQUFDLE9BQU8sRUFBRSxXQUFXLENBQUMsRUFBRSxFQUFFLGNBQWMsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFBO0FBQzlFLENBQUM7QUFFRDs7Ozs7O0dBTUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLGFBQWEsQ0FBQyxjQUFzQixJQUFJLEVBQUUsZ0JBQXdCLFNBQVMsRUFBRSxZQUFvQixTQUFTLEVBQUUsR0FBWTtJQUM1SSxnQkFBZ0IsQ0FBQyxhQUFhLEVBQUUsV0FBVyxDQUFDLENBQUE7SUFDNUMsYUFBYSxDQUFDLFdBQVcsRUFBRSxTQUFTLENBQUMsQ0FBQTtJQUNyQyxhQUFhLENBQUMsZUFBZSxFQUFFLGFBQWEsQ0FBQyxDQUFBO0lBQzdDLElBQUksR0FBRyxFQUFFO1FBQ1AsZ0JBQWdCLENBQUMsS0FBSyxFQUFFLEdBQUcsQ0FBQyxDQUFBO0tBQzdCO0lBQ0QsTUFBTSxJQUFJLEdBQUcsQ0FBQyxTQUFTLEVBQUUsV0FBVyxFQUFFLElBQUksRUFBRSxhQUFhLEVBQUUsSUFBSSxFQUFFLFNBQVMsQ0FBQyxDQUFBO0lBQzNFLE1BQU0sWUFBWSxHQUFHLGtCQUFrQixJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUE7SUFDdkQsTUFBTSxlQUFlLEdBQUcsR0FBRyxDQUFDLENBQUMsQ0FBQyxXQUFXLEdBQUcsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUE7SUFDbkQsS0FBSyxDQUFDLEdBQUcsWUFBWSxHQUFHLGVBQWUsRUFBRSxDQUFDLENBQUE7SUFDMUMsTUFBTSxVQUFVLENBQUMsUUFBUSxFQUFFLElBQUksRUFBRSxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsQ0FBQyxDQUFBO0FBQ2hELENBQUM7QUFFRDs7R0FFRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsMkJBQTJCO0lBQy9DLE1BQU0sU0FBUyxHQUFHLFNBQVMsQ0FBQyxXQUFXLENBQUMsQ0FBQyxRQUFRLENBQUE7SUFDakQsSUFBSSxTQUFTLEVBQUU7UUFDYixHQUFHLENBQUMsK0NBQStDLENBQUMsQ0FBQTtLQUNyRDtTQUFNO1FBQ0wsR0FBRyxDQUFDLDZDQUE2QyxDQUFDLENBQUE7S0FDbkQ7SUFDRCxNQUFNLElBQUksR0FBRyxDQUFDLE1BQU0sRUFBRSxTQUFTLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsU0FBUyxFQUFFLFVBQVUsRUFBRSxXQUFXLENBQUMsQ0FBQTtJQUNoRixNQUFNLFVBQVUsQ0FBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLENBQUE7QUFDbEMsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLHVCQUF1QjtJQUMzQyxNQUFNLFVBQVUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxXQUFXLEVBQUUsT0FBTyxFQUFFLFNBQVMsQ0FBQyxDQUFDLENBQUE7SUFDN0QsTUFBTSxVQUFVLENBQUMsUUFBUSxFQUFFLENBQUMsV0FBVyxFQUFFLE9BQU8sRUFBRSxJQUFJLENBQUMsQ0FBQyxDQUFBO0FBQzFELENBQUMifQ==

package/dist/esm/esmSpecific.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Only dynamically import this if ESM is detected. This allows a CJS-specific build to avoid
+ * an error it would otherwise encounter when parsing import.meta.url.
+ * @returns the file path of the currently executing script
+ */
+export declare const getImportMetaUrlFilePath: () => string;
+//# sourceMappingURL=esmSpecific.d.mts.map

package/dist/esm/esmSpecific.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esmSpecific.d.mts","sourceRoot":"","sources":["../../src/esmSpecific.mts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,cAGpC,CAAA"}