@aneuhold/be-ts-lib 1.0.1

package/README.md

@@ -0,0 +1,3 @@
+# Personal Backend TypeScript Library
+
+This is a library meant to contain any common code between backend TypeScript projects.

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+import { sleep } from '@aneuhold/core-ts-lib';
+import CLIService from './services/CLIService';
+import ChromeService from './services/applications/ChromeService';
+import DockerService from './services/applications/DockerService';
+import OSFileSystemService from './services/applications/OSFileSystemService';
+import CurrentEnv, { OperatingSystemType, ShellType, TerminalType } from './utils/CurrentEnv';
+import ITermService from './services/applications/ITermService';
+import ConfigService from './services/ConfigService/ConfigService';
+export { CLIService, CurrentEnv, ChromeService, DockerService, OSFileSystemService, sleep, OperatingSystemType, ShellType, TerminalType, ITermService, ConfigService };
+export type {};
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,aAAa,MAAM,uCAAuC,CAAC;AAClE,OAAO,aAAa,MAAM,uCAAuC,CAAC;AAClE,OAAO,mBAAmB,MAAM,6CAA6C,CAAC;AAC9E,OAAO,UAAU,EAAE,EACjB,mBAAmB,EACnB,SAAS,EACT,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,YAAY,MAAM,sCAAsC,CAAC;AAChE,OAAO,aAAa,MAAM,wCAAwC,CAAC;AAGnE,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,KAAK,EACL,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,aAAa,EACd,CAAC;AAGF,YAAY,EAAE,CAAC"}

package/lib/index.js

@@ -0,0 +1,48 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigService = exports.ITermService = exports.TerminalType = exports.ShellType = exports.OperatingSystemType = exports.sleep = exports.OSFileSystemService = exports.DockerService = exports.ChromeService = exports.CurrentEnv = exports.CLIService = void 0;
+const core_ts_lib_1 = require("@aneuhold/core-ts-lib");
+Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return core_ts_lib_1.sleep; } });
+const CLIService_1 = __importDefault(require("./services/CLIService"));
+exports.CLIService = CLIService_1.default;
+const ChromeService_1 = __importDefault(require("./services/applications/ChromeService"));
+exports.ChromeService = ChromeService_1.default;
+const DockerService_1 = __importDefault(require("./services/applications/DockerService"));
+exports.DockerService = DockerService_1.default;
+const OSFileSystemService_1 = __importDefault(require("./services/applications/OSFileSystemService"));
+exports.OSFileSystemService = OSFileSystemService_1.default;
+const CurrentEnv_1 = __importStar(require("./utils/CurrentEnv"));
+exports.CurrentEnv = CurrentEnv_1.default;
+Object.defineProperty(exports, "OperatingSystemType", { enumerable: true, get: function () { return CurrentEnv_1.OperatingSystemType; } });
+Object.defineProperty(exports, "ShellType", { enumerable: true, get: function () { return CurrentEnv_1.ShellType; } });
+Object.defineProperty(exports, "TerminalType", { enumerable: true, get: function () { return CurrentEnv_1.TerminalType; } });
+const ITermService_1 = __importDefault(require("./services/applications/ITermService"));
+exports.ITermService = ITermService_1.default;
+const ConfigService_1 = __importDefault(require("./services/ConfigService/ConfigService"));
+exports.ConfigService = ConfigService_1.default;

package/lib/services/CLIService.d.ts

@@ -0,0 +1,69 @@
+type ExecCmdReturnType = {
+    didComplete: boolean;
+    output: string;
+};
+/**
+ * A service which can be used to interact with the command line on the current
+ * system.
+ */
+export default class CLIService {
+    private static POWERSHELL_PREFIX;
+    /**
+     * Executes the given command in a shell environment. Spins up a separate
+     * process to execute the command and returns a promise once it is completely
+     * finished.
+     *
+     * The shell environment chosen is determined by the `CurrentEnv` class.
+     *
+     * @param cmd the command to run. This is ran as a normal execution where the
+     * output is all returned at once after completion. For example this could be
+     * `ls -a`.
+     *
+     * @param logError if set to false, it will not output a log if an error
+     * occurs in `stderr` when executing the function. This can be useful if
+     * a command regularly outputs an error even when it succeeds. This  only
+     * applies to commands ran with normal execution.
+     *
+     * @param cwd the current working directory to run the command in. If not
+     * provided, it will use the current working directory of the process.
+     *
+     * @param useProfile if set to true will use the current profile or zshrc of
+     * the shell environment. By default this is false.
+     *
+     * @returns an object that holds the output and true if the command completed
+     * successfully or false if it did not.
+     */
+    static execCmd(cmd: string, logError?: boolean, cwd?: string, useProfile?: boolean): Promise<ExecCmdReturnType>;
+    /**
+     * Executes the given command but fulfills the
+     * promise when either the command completes, or the given number of ms have
+     * passed. Whichever comes first.
+     *
+     * @param command the command to execute
+     * @param ms the number of milliseconds to wait. This is 5 seconds by default.
+     */
+    static execCmdWithTimeout(command: string, ms?: number): Promise<ExecCmdReturnType>;
+    /**
+     * Spawns a new process where the command is ran as a stream where all
+     *  output is streamed to the console.
+     * This is helpful for long-running commands or commands
+     * that output a lot of data. For example `yarn` or `npm install`.
+     * All of the output from this is logged by default because of the listeners
+     * involved. This could be changed in the future though.
+     *
+     * @param cmd the command to run. This is the the first argument passed to the
+     * `spawn` function. For example this could be `npm`.
+     * @param args the arguments to pass to the command. For example this could be
+     * `['install', 'react']`.
+     */
+    static spawnCmd(cmd: string, args?: string[], currentWorkingDirectory?: string): Promise<ExecCmdReturnType>;
+    /**
+     * Gets input from the user on command line.
+     *
+     * @param promptToUser the prompt that should be provided to the user. Include
+     * a newline at the end if you want there to be one.
+     */
+    static getUserInput(promptToUser: string): Promise<string>;
+}
+export {};
+//# sourceMappingURL=CLIService.d.ts.map

package/lib/services/CLIService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLIService.d.ts","sourceRoot":"","sources":["../../src/services/CLIService.ts"],"names":[],"mappings":"AAWA,KAAK,iBAAiB,GAAG;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAA+B;IAE/D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;WACU,OAAO,CAClB,GAAG,EAAE,MAAM,EACX,QAAQ,UAAQ,EAChB,GAAG,CAAC,EAAE,MAAM,EACZ,UAAU,UAAQ,GACjB,OAAO,CAAC,iBAAiB,CAAC;IA6C7B;;;;;;;OAOG;WACU,kBAAkB,CAC7B,OAAO,EAAE,MAAM,EACf,EAAE,SAAO,GACR,OAAO,CAAC,iBAAiB,CAAC;IAU7B;;;;;;;;;;;;OAYG;WACU,QAAQ,CACnB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,uBAAuB,CAAC,EAAE,MAAM,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAkC7B;;;;;OAKG;WACU,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAYjE"}

package/lib/services/CLIService.js

@@ -0,0 +1,193 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const rl = __importStar(require("readline"));
+const util_1 = __importDefault(require("util"));
+const core_ts_lib_1 = require("@aneuhold/core-ts-lib");
+const CurrentEnv_1 = __importStar(require("../utils/CurrentEnv"));
+/**
+ * The promisified version of the {@link normalExec} function.
+ */
+const execute = util_1.default.promisify(child_process_1.exec);
+/**
+ * A service which can be used to interact with the command line on the current
+ * system.
+ */
+class CLIService {
+    static POWERSHELL_PREFIX = `pwsh -NoProfile -Command `;
+    /**
+     * Executes the given command in a shell environment. Spins up a separate
+     * process to execute the command and returns a promise once it is completely
+     * finished.
+     *
+     * The shell environment chosen is determined by the `CurrentEnv` class.
+     *
+     * @param cmd the command to run. This is ran as a normal execution where the
+     * output is all returned at once after completion. For example this could be
+     * `ls -a`.
+     *
+     * @param logError if set to false, it will not output a log if an error
+     * occurs in `stderr` when executing the function. This can be useful if
+     * a command regularly outputs an error even when it succeeds. This  only
+     * applies to commands ran with normal execution.
+     *
+     * @param cwd the current working directory to run the command in. If not
+     * provided, it will use the current working directory of the process.
+     *
+     * @param useProfile if set to true will use the current profile or zshrc of
+     * the shell environment. By default this is false.
+     *
+     * @returns an object that holds the output and true if the command completed
+     * successfully or false if it did not.
+     */
+    static async execCmd(cmd, logError = false, cwd, useProfile = false) {
+        const execOptions = {};
+        if (cwd) {
+            execOptions.cwd = cwd;
+        }
+        let commandToExecute = cmd;
+        // Set the powershell prefix if the current OS is Windows so that
+        // the profile is not ran before the command.
+        if (CurrentEnv_1.default.os === CurrentEnv_1.OperatingSystemType.Windows && !useProfile) {
+            commandToExecute = `${CLIService.POWERSHELL_PREFIX}${cmd}`;
+        }
+        else if (CurrentEnv_1.default.os === CurrentEnv_1.OperatingSystemType.Windows && useProfile) {
+            execOptions.shell = 'pwsh';
+        }
+        core_ts_lib_1.Logger.verbose.info(`Executing command: ${commandToExecute}`);
+        try {
+            const { stdout, stderr } = await execute(commandToExecute, execOptions);
+            if (stderr) {
+                if (logError) {
+                    core_ts_lib_1.Logger.error(`There was an error executing ${cmd}. Details are printed below:
+            ${stderr}`);
+                }
+                return {
+                    didComplete: false,
+                    output: stderr
+                };
+            }
+            core_ts_lib_1.Logger.verbose.info(`Output from stdout is: ${stdout}`);
+            return {
+                didComplete: true,
+                output: stdout
+            };
+        }
+        catch (err) {
+            core_ts_lib_1.Logger.verbose
+                .error(`There was an error executing the "exec" function. Details are printed below:
+        ${err}`);
+            return {
+                didComplete: false,
+                output: err
+            };
+        }
+    }
+    /**
+     * Executes the given command but fulfills the
+     * promise when either the command completes, or the given number of ms have
+     * passed. Whichever comes first.
+     *
+     * @param command the command to execute
+     * @param ms the number of milliseconds to wait. This is 5 seconds by default.
+     */
+    static async execCmdWithTimeout(command, ms = 5000) {
+        const sleepPromise = (0, core_ts_lib_1.sleep)(ms).then(() => {
+            return {
+                didComplete: false,
+                output: `Command ended after ${ms} ms.`
+            };
+        });
+        return Promise.any([sleepPromise, CLIService.execCmd(command)]);
+    }
+    /**
+     * Spawns a new process where the command is ran as a stream where all
+     *  output is streamed to the console.
+     * This is helpful for long-running commands or commands
+     * that output a lot of data. For example `yarn` or `npm install`.
+     * All of the output from this is logged by default because of the listeners
+     * involved. This could be changed in the future though.
+     *
+     * @param cmd the command to run. This is the the first argument passed to the
+     * `spawn` function. For example this could be `npm`.
+     * @param args the arguments to pass to the command. For example this could be
+     * `['install', 'react']`.
+     */
+    static async spawnCmd(cmd, args, currentWorkingDirectory) {
+        return new Promise((resolve) => {
+            let output = '';
+            const execOptions = {
+                cwd: currentWorkingDirectory
+            };
+            const spawnedCmd = (0, child_process_1.spawn)(cmd, args, execOptions);
+            spawnedCmd.on('error', (err) => {
+                core_ts_lib_1.Logger.error(`There was an error executing the "spawn" function. Details are printed below:
+      ${err}`);
+                resolve({
+                    didComplete: false,
+                    output: err.toString()
+                });
+            });
+            spawnedCmd.stdout.on('data', (data) => {
+                output += data;
+                core_ts_lib_1.Logger.info(data, true);
+            });
+            spawnedCmd.stderr.on('data', (data) => {
+                output += data;
+                core_ts_lib_1.Logger.info(data, true);
+            });
+            spawnedCmd.on('close', (exitCode) => {
+                core_ts_lib_1.Logger.info(`Command "${cmd}" exited with code ${exitCode}`);
+                resolve({
+                    didComplete: true,
+                    output
+                });
+            });
+        });
+    }
+    /**
+     * Gets input from the user on command line.
+     *
+     * @param promptToUser the prompt that should be provided to the user. Include
+     * a newline at the end if you want there to be one.
+     */
+    static async getUserInput(promptToUser) {
+        const readline = rl.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        return new Promise((resolve) => {
+            readline.question(promptToUser, (input) => {
+                readline.close();
+                resolve(input);
+            });
+        });
+    }
+}
+exports.default = CLIService;

package/lib/services/ConfigService/ConfigService.d.ts

@@ -0,0 +1,25 @@
+import 'dotenv/config';
+export type ConfigEnv = 'local' | 'dev' | 'prod';
+/**
+ * A class which can be used to load configuration into the local environment
+ * from a pre-defined location.
+ */
+export default class ConfigService {
+    private static gitHub;
+    static useConfig(env: string): Promise<void>;
+    /**
+     * Creates a new GitHub client using `CONFIG_GITHUB_TOKEN` from the
+     * local environment or .env file.
+     */
+    private static getGitHubClient;
+    /**
+     * Inserts the provided configuration into the local environment.
+     */
+    private static insertPropertiesIntoEnv;
+    /**
+     * Strips JSON comments from the provided JSON string. Only `//` comments
+     * are supported at the moment.
+     */
+    private static stripJsonComments;
+}
+//# sourceMappingURL=ConfigService.d.ts.map

package/lib/services/ConfigService/ConfigService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigService.d.ts","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigService.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,CAAC;AAGvB,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwB;WAEhC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBlD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAY9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAUtC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAG9B;CACH"}

package/lib/services/ConfigService/ConfigService.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const octokit_1 = require("octokit");
+require("dotenv/config");
+const core_ts_lib_1 = require("@aneuhold/core-ts-lib");
+/**
+ * A class which can be used to load configuration into the local environment
+ * from a pre-defined location.
+ */
+class ConfigService {
+    static gitHub = null;
+    static async useConfig(env) {
+        if (!ConfigService.gitHub) {
+            ConfigService.gitHub = ConfigService.getGitHubClient();
+        }
+        try {
+            const result = await ConfigService.gitHub.rest.repos.getContent({
+                mediaType: {
+                    format: 'raw'
+                },
+                owner: 'aneuhold',
+                repo: 'config',
+                path: `${env}.jsonc`
+            });
+            const strippedJson = ConfigService.stripJsonComments(result.data);
+            const config = JSON.parse(strippedJson);
+            ConfigService.insertPropertiesIntoEnv(config);
+        }
+        catch (error) {
+            core_ts_lib_1.Logger.error(`Failed to load ${env}.json, error: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Creates a new GitHub client using `CONFIG_GITHUB_TOKEN` from the
+     * local environment or .env file.
+     */
+    static getGitHubClient() {
+        const authToken = process.env.CONFIG_GITHUB_TOKEN;
+        if (!authToken) {
+            throw new Error('No CONFIG_GITHUB_TOKEN key found in environment variables.');
+        }
+        return new octokit_1.Octokit({
+            auth: authToken
+        });
+    }
+    /**
+     * Inserts the provided configuration into the local environment.
+     */
+    static insertPropertiesIntoEnv(config) {
+        Object.entries(config).forEach(([key, value]) => {
+            if (typeof value === 'object') {
+                ConfigService.insertPropertiesIntoEnv(value);
+            }
+            else {
+                process.env[key] = value;
+            }
+        });
+    }
+    /**
+     * Strips JSON comments from the provided JSON string. Only `//` comments
+     * are supported at the moment.
+     */
+    static stripJsonComments = (jsonString) => {
+        const commentRegex = /\/\/(.*)/g;
+        return jsonString.replace(commentRegex, '');
+    };
+}
+exports.default = ConfigService;

package/lib/services/ConfigService/ConfigService.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ConfigService.spec.d.ts.map

package/lib/services/ConfigService/ConfigService.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigService.spec.d.ts","sourceRoot":"","sources":["../../../src/services/ConfigService/ConfigService.spec.ts"],"names":[],"mappings":""}

package/lib/services/ConfigService/ConfigService.spec.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const console_1 = require("console");
+const core_ts_lib_1 = require("@aneuhold/core-ts-lib");
+const ConfigService_1 = __importDefault(require("./ConfigService"));
+describe('ConfigService', () => {
+    describe('useConfig', () => {
+        /**
+         * Depends upon a GitHub token being available in the local environment.
+         * This will be a local `.env` file with the CONFIG_GITHUB_TOKEN variable
+         * set.
+         */
+        it('should load configuration from GitHub', async () => {
+            const env = 'local';
+            await ConfigService_1.default.useConfig(env);
+            (0, console_1.assert)(process.env.SOME_KEY === 'SOME_VALUE');
+        });
+        it('should throw an error when loading configuration fails', async () => {
+            const env = 'invalid_env';
+            core_ts_lib_1.TestUtils.suppressConsole();
+            await expect(ConfigService_1.default.useConfig(env)).rejects.toThrow();
+            core_ts_lib_1.TestUtils.restoreConsole();
+        });
+    });
+});

package/lib/services/applications/ChromeService.d.ts

@@ -0,0 +1,20 @@
+import { OperatingSystemType } from '../../utils/CurrentEnv';
+/**
+ * A service that provides functionality for interacting with the Chrome
+ * browser.
+ */
+export default class ChromeService {
+    /**
+     * Gets the path to the chrome application for the current system given the
+     * operating system type.
+     *
+     * This does include the quotes
+     */
+    static getChromePath(os: OperatingSystemType): string | null;
+    /**
+     * Opens and sets pinned tabs in chrome. Still trying to figure out
+     * how to get this to work.
+     */
+    static openAndSetPinnedTabs(): Promise<void>;
+}
+//# sourceMappingURL=ChromeService.d.ts.map

package/lib/services/applications/ChromeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChromeService.d.ts","sourceRoot":"","sources":["../../../src/services/applications/ChromeService.ts"],"names":[],"mappings":"AAAA,OAAmB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGzE;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI;IAW5D;;;OAGG;WACU,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;CAOnD"}

package/lib/services/applications/ChromeService.js

@@ -0,0 +1,60 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const CurrentEnv_1 = __importStar(require("../../utils/CurrentEnv"));
+const CLIService_1 = __importDefault(require("../CLIService"));
+/**
+ * A service that provides functionality for interacting with the Chrome
+ * browser.
+ */
+class ChromeService {
+    /**
+     * Gets the path to the chrome application for the current system given the
+     * operating system type.
+     *
+     * This does include the quotes
+     */
+    static getChromePath(os) {
+        switch (os) {
+            case CurrentEnv_1.OperatingSystemType.MacOSX:
+                return `"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"`;
+            case CurrentEnv_1.OperatingSystemType.Windows:
+                return `& "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"`;
+            default:
+                return null;
+        }
+    }
+    /**
+     * Opens and sets pinned tabs in chrome. Still trying to figure out
+     * how to get this to work.
+     */
+    static async openAndSetPinnedTabs() {
+        await CLIService_1.default.execCmd(`${ChromeService.getChromePath(CurrentEnv_1.default.os)} --pinned-tab-count=2 https://google.com https://tonyneuhold.com`);
+    }
+}
+exports.default = ChromeService;

package/lib/services/applications/DockerService.d.ts

@@ -0,0 +1,21 @@
+import { OperatingSystemType } from '../../utils/CurrentEnv';
+/**
+ * A service that provides functionality for interacting with the Docker
+ * application.
+ */
+export default class DockerService {
+    /**
+     * Starts the Docker Desktop application. If it is already running, it doesn't
+     * do anything.
+     */
+    static startDockerDesktop(): Promise<void>;
+    static checkIfDockerDesktopIsRunning(): Promise<boolean>;
+    /**
+     * Gets the path to the docker application for the current system given the
+     * operating system type.
+     *
+     * This does include the quotes
+     */
+    static getDockerPath(os: OperatingSystemType): string | null;
+}
+//# sourceMappingURL=DockerService.d.ts.map

package/lib/services/applications/DockerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DockerService.d.ts","sourceRoot":"","sources":["../../../src/services/applications/DockerService.ts"],"names":[],"mappings":"AAGA,OAAmB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGzE;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC;;;OAGG;WACU,kBAAkB;WAgBlB,6BAA6B,IAAI,OAAO,CAAC,OAAO,CAAC;IAe9D;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI;CAS7D"}

package/lib/services/applications/DockerService.js

@@ -0,0 +1,87 @@
+"use strict";
+/* eslint-disable no-await-in-loop */
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_ts_lib_1 = require("@aneuhold/core-ts-lib");
+const CurrentEnv_1 = __importStar(require("../../utils/CurrentEnv"));
+const CLIService_1 = __importDefault(require("../CLIService"));
+/**
+ * A service that provides functionality for interacting with the Docker
+ * application.
+ */
+class DockerService {
+    /**
+     * Starts the Docker Desktop application. If it is already running, it doesn't
+     * do anything.
+     */
+    static async startDockerDesktop() {
+        const currentOS = CurrentEnv_1.default.os;
+        const dockerPath = DockerService.getDockerPath(currentOS);
+        let dockerRunning = await DockerService.checkIfDockerDesktopIsRunning();
+        if (!dockerRunning && dockerPath) {
+            core_ts_lib_1.Logger.info('Docker desktop is not running. Starting it now...');
+            await CLIService_1.default.execCmdWithTimeout(dockerPath, 4000);
+            while (!dockerRunning) {
+                core_ts_lib_1.Logger.info('Waiting for Docker to start...');
+                await (0, core_ts_lib_1.sleep)(2000);
+                dockerRunning = await DockerService.checkIfDockerDesktopIsRunning();
+            }
+        }
+        core_ts_lib_1.Logger.info('Docker desktop is running.');
+    }
+    static async checkIfDockerDesktopIsRunning() {
+        const currentOS = CurrentEnv_1.default.os;
+        if (currentOS === CurrentEnv_1.OperatingSystemType.Windows) {
+            const { didComplete } = await CLIService_1.default.execCmd('Get-Process docker');
+            if (didComplete) {
+                core_ts_lib_1.Logger.verbose.info('Docker is running.');
+                return true;
+            }
+            core_ts_lib_1.Logger.verbose.info('Docker is not running.');
+            return false;
+        }
+        core_ts_lib_1.Logger.error('Docker command not defined for this OS yet.');
+        return false;
+    }
+    /**
+     * Gets the path to the docker application for the current system given the
+     * operating system type.
+     *
+     * This does include the quotes
+     */
+    static getDockerPath(os) {
+        switch (os) {
+            case CurrentEnv_1.OperatingSystemType.Windows:
+                return `& "C:\\Program Files\\Docker\\Docker\\Docker Desktop.exe"`;
+            default:
+                core_ts_lib_1.Logger.error('Docker path not defined for this OS yet.');
+                return null;
+        }
+    }
+}
+exports.default = DockerService;

package/lib/services/applications/ITermService.d.ts

@@ -0,0 +1,8 @@
+export default class ITermService {
+    /**
+     * Splits the iTerm terminal horzontally and runs each command in a separate
+     * pane.
+     */
+    static splitHorizontallyAndRunCommands(commands: string[], cwd?: string): Promise<void>;
+}
+//# sourceMappingURL=ITermService.d.ts.map

package/lib/services/applications/ITermService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITermService.d.ts","sourceRoot":"","sources":["../../../src/services/applications/ITermService.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B;;;OAGG;WACU,+BAA+B,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,SAAK;CAmC1E"}

package/lib/services/applications/ITermService.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_ts_lib_1 = require("@aneuhold/core-ts-lib");
+const OsaScriptBuilder_1 = __importDefault(require("../../utils/OsaScriptBuilder"));
+const CLIService_1 = __importDefault(require("../CLIService"));
+class ITermService {
+    /**
+     * Splits the iTerm terminal horzontally and runs each command in a separate
+     * pane.
+     */
+    static async splitHorizontallyAndRunCommands(commands, cwd = '') {
+        const terminalWindowTellBlock = {
+            tellCommand: `W's current session`,
+            sections: []
+        };
+        // Do the number of splits needed
+        commands.forEach(() => {
+            terminalWindowTellBlock.sections.push(`split horizontally with default profile`);
+        });
+        const iTermApplicationTellBlock = {
+            tellCommand: 'application "iTerm"',
+            sections: [
+                'activate',
+                'set W to current window',
+                'if W = missing value then set W to create window with default profile',
+                terminalWindowTellBlock,
+                `set T to W's current tab`
+            ]
+        };
+        // Add in the commands, adding 2 to the session number because the first
+        // session is 1, and the second is 2.
+        commands.forEach((command, i) => {
+            iTermApplicationTellBlock.sections.push(`write T's session ${i + 2} text "cd ${cwd} && ${command}"`);
+        });
+        const osaScriptBuilder = new OsaScriptBuilder_1.default();
+        osaScriptBuilder.addTellBlock(iTermApplicationTellBlock);
+        const osaScript = osaScriptBuilder.getFullCommand();
+        core_ts_lib_1.Logger.verbose.info(`OsaScript: ${osaScript}`);
+        await CLIService_1.default.execCmd(osaScript);
+    }
+}
+exports.default = ITermService;

package/lib/services/applications/OSFileSystemService.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A service which can be used to interact with the file system application on
+ * the current system.
+ */
+export default class OSFileSystemService {
+    static openNugetCache(): Promise<void>;
+    /**
+     * Tries to add the provided snippet of text to the path provided. If the file
+     * doesn't exist, it creates it. If the folders to the file don't exist, it
+     * creates those. If the text already exists in the file, it does nothing.
+     *
+     * @param folderPath the path to the folder which contains the file that should
+     * be updated
+     */
+    static findAndInsertText(folderPath: string, fileName: string, textToInsert: string): Promise<void>;
+    private static openWindowsNugetCache;
+    private static openMacNugetCache;
+}
+//# sourceMappingURL=OSFileSystemService.d.ts.map

package/lib/services/applications/OSFileSystemService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OSFileSystemService.d.ts","sourceRoot":"","sources":["../../../src/services/applications/OSFileSystemService.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;WACzB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5C;;;;;;;OAOG;WACU,iBAAiB,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;mBAsBK,qBAAqB;mBAOrB,iBAAiB;CAMvC"}

package/lib/services/applications/OSFileSystemService.js

@@ -0,0 +1,90 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const promises_1 = require("fs/promises");
+const path_1 = __importDefault(require("path"));
+const core_ts_lib_1 = require("@aneuhold/core-ts-lib");
+const CurrentEnv_1 = __importStar(require("../../utils/CurrentEnv"));
+const CLIService_1 = __importDefault(require("../CLIService"));
+/**
+ * A service which can be used to interact with the file system application on
+ * the current system.
+ */
+class OSFileSystemService {
+    static async openNugetCache() {
+        if (CurrentEnv_1.default.os === CurrentEnv_1.OperatingSystemType.Windows) {
+            await OSFileSystemService.openWindowsNugetCache();
+            return;
+        }
+        if (CurrentEnv_1.default.os === CurrentEnv_1.OperatingSystemType.MacOSX) {
+            await OSFileSystemService.openMacNugetCache();
+            return;
+        }
+        core_ts_lib_1.Logger.error('Not implemented for this OS yet.');
+    }
+    /**
+     * Tries to add the provided snippet of text to the path provided. If the file
+     * doesn't exist, it creates it. If the folders to the file don't exist, it
+     * creates those. If the text already exists in the file, it does nothing.
+     *
+     * @param folderPath the path to the folder which contains the file that should
+     * be updated
+     */
+    static async findAndInsertText(folderPath, fileName, textToInsert) {
+        const filePath = path_1.default.join(folderPath, fileName);
+        await core_ts_lib_1.FileSystemService.checkOrCreateFolder(folderPath);
+        try {
+            await (0, promises_1.access)(filePath);
+            const fileContents = await (0, promises_1.readFile)(filePath);
+            if (!fileContents.includes(textToInsert)) {
+                await (0, promises_1.appendFile)(filePath, `\n${textToInsert}`);
+                core_ts_lib_1.Logger.info(`Added "${textToInsert}" to "${filePath}"`);
+            }
+            else {
+                core_ts_lib_1.Logger.info(`"${textToInsert}" already exists in "${filePath}"`);
+            }
+        }
+        catch {
+            core_ts_lib_1.Logger.info(`File at "${filePath}" didn't exist. Creating it now and adding "${textToInsert}" to it.`);
+            await (0, promises_1.writeFile)(filePath, textToInsert);
+        }
+    }
+    static async openWindowsNugetCache() {
+        await Promise.all([
+            CLIService_1.default.execCmd(`ii $HOME/localNuget`),
+            CLIService_1.default.execCmd(`ii $HOME/.nuget/packages`)
+        ]);
+    }
+    static async openMacNugetCache() {
+        await Promise.all([
+            CLIService_1.default.execCmd(`open $HOME/localNuget`),
+            CLIService_1.default.execCmd(`open $HOME/.nuget/packages`)
+        ]);
+    }
+}
+exports.default = OSFileSystemService;

package/lib/utils/CurrentEnv.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The type of shell that the current environment is running.
+ */
+export declare enum ShellType {
+    PowerShellCore = 0,
+    PowerShellDesktop = 1,
+    Bash = 2,
+    Zsh = 3,
+    CommandPrompt = 4,
+    Unknown = 5
+}
+export declare enum OperatingSystemType {
+    Windows = 0,
+    MacOSX = 1,
+    Linux = 2,
+    Unknown = 3
+}
+/**
+ * The type of terminal that the current enviornment is running.
+ */
+export declare enum TerminalType {
+    WindowsTerminal = 0,
+    ITerm2 = 1,
+    Unknown = 2
+}
+/**
+ * Provides information relevant to the current environment this script is
+ * running in.
+ */
+export default class CurrentEnv {
+    /**
+     * Returns the type of terminal the current environment is using.
+     */
+    static terminal(): TerminalType;
+    /**
+     * Returns the type of shell the current environment is using.
+     *
+     * This might be arbitrary because it seems that the exec command will use
+     * whatever the default shell is or whatever is specified as the shell
+     * option.
+     */
+    static shell(): Promise<ShellType>;
+    /**
+     * Gets all file names in the current directory.
+     */
+    static fileNamesInDir(): Promise<string[]>;
+    /**
+     * Runs the startup script for the current system. This command exits the
+     * package.
+     *
+     * The startup scripts are defined in the
+     * [dotfiles repo](https://github.com/aneuhold/dotfiles).
+     */
+    static runStartupScript(): Promise<void>;
+    /**
+     * Determines the type of operating system in the current environment.
+     *
+     * This looks to be O(1) complexity.
+     */
+    static get os(): OperatingSystemType;
+    static folderName(): string;
+}
+//# sourceMappingURL=CurrentEnv.d.ts.map

package/lib/utils/CurrentEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurrentEnv.d.ts","sourceRoot":"","sources":["../../src/utils/CurrentEnv.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,oBAAY,SAAS;IACnB,cAAc,IAAA;IACd,iBAAiB,IAAA;IACjB,IAAI,IAAA;IACJ,GAAG,IAAA;IACH,aAAa,IAAA;IACb,OAAO,IAAA;CACR;AAED,oBAAY,mBAAmB;IAC7B,OAAO,IAAA;IACP,MAAM,IAAA;IACN,KAAK,IAAA;IACL,OAAO,IAAA;CACR;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,eAAe,IAAA;IACf,MAAM,IAAA;IACN,OAAO,IAAA;CACR;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B;;OAEG;WACW,QAAQ,IAAI,YAAY;IAYtC;;;;;;OAMG;WACiB,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;IAyB/C;;OAEG;WACiB,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvD;;;;;;OAMG;WACiB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrD;;;;OAIG;IACH,WAAkB,EAAE,IAAI,mBAAmB,CAQ1C;WAEa,UAAU,IAAI,MAAM;CAGnC"}

package/lib/utils/CurrentEnv.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalType = exports.OperatingSystemType = exports.ShellType = void 0;
+const promises_1 = require("fs/promises");
+const path_1 = __importDefault(require("path"));
+const core_ts_lib_1 = require("@aneuhold/core-ts-lib");
+const CLIService_1 = __importDefault(require("../services/CLIService"));
+/**
+ * The type of shell that the current environment is running.
+ */
+var ShellType;
+(function (ShellType) {
+    ShellType[ShellType["PowerShellCore"] = 0] = "PowerShellCore";
+    ShellType[ShellType["PowerShellDesktop"] = 1] = "PowerShellDesktop";
+    ShellType[ShellType["Bash"] = 2] = "Bash";
+    ShellType[ShellType["Zsh"] = 3] = "Zsh";
+    ShellType[ShellType["CommandPrompt"] = 4] = "CommandPrompt";
+    ShellType[ShellType["Unknown"] = 5] = "Unknown";
+})(ShellType || (exports.ShellType = ShellType = {}));
+var OperatingSystemType;
+(function (OperatingSystemType) {
+    OperatingSystemType[OperatingSystemType["Windows"] = 0] = "Windows";
+    OperatingSystemType[OperatingSystemType["MacOSX"] = 1] = "MacOSX";
+    OperatingSystemType[OperatingSystemType["Linux"] = 2] = "Linux";
+    OperatingSystemType[OperatingSystemType["Unknown"] = 3] = "Unknown";
+})(OperatingSystemType || (exports.OperatingSystemType = OperatingSystemType = {}));
+/**
+ * The type of terminal that the current enviornment is running.
+ */
+var TerminalType;
+(function (TerminalType) {
+    TerminalType[TerminalType["WindowsTerminal"] = 0] = "WindowsTerminal";
+    TerminalType[TerminalType["ITerm2"] = 1] = "ITerm2";
+    TerminalType[TerminalType["Unknown"] = 2] = "Unknown";
+})(TerminalType || (exports.TerminalType = TerminalType = {}));
+/**
+ * Provides information relevant to the current environment this script is
+ * running in.
+ */
+class CurrentEnv {
+    /**
+     * Returns the type of terminal the current environment is using.
+     */
+    static terminal() {
+        // See https://stackoverflow.com/questions/59733731/how-to-detect-if-running-in-the-new-windows-terminal
+        // for information on why this method was chosen.
+        if (process.env.WT_SESSION) {
+            return TerminalType.WindowsTerminal;
+        }
+        if (process.env.TERM_PROGRAM && process.env.TERM_PROGRAM === 'iTerm.app') {
+            return TerminalType.ITerm2;
+        }
+        return TerminalType.Unknown;
+    }
+    /**
+     * Returns the type of shell the current environment is using.
+     *
+     * This might be arbitrary because it seems that the exec command will use
+     * whatever the default shell is or whatever is specified as the shell
+     * option.
+     */
+    static async shell() {
+        const currentOs = CurrentEnv.os;
+        if (currentOs === OperatingSystemType.Windows) {
+            // Command comes from: https://stackoverflow.com/questions/34471956/how-to-determine-if-im-in-powershell-or-cmd
+            const { output } = await CLIService_1.default.execCmd('(dir 2>&1 *`|echo CMD);&<# rem #>echo ($PSVersionTable).PSEdition');
+            switch (output) {
+                case 'CMD':
+                    return ShellType.CommandPrompt;
+                case 'Desktop':
+                    return ShellType.PowerShellDesktop;
+                case 'Core':
+                    return ShellType.PowerShellCore;
+                default:
+                    core_ts_lib_1.Logger.verbose.failure(`No recognizable shell returned for Windows environment.`);
+            }
+        }
+        else if (currentOs === OperatingSystemType.MacOSX) {
+            // Mighbt want to use process.env.SHELL for Linux environments
+        }
+        return ShellType.Unknown;
+    }
+    /**
+     * Gets all file names in the current directory.
+     */
+    static async fileNamesInDir() {
+        return (0, promises_1.readdir)(path_1.default.resolve('.'));
+    }
+    /**
+     * Runs the startup script for the current system. This command exits the
+     * package.
+     *
+     * The startup scripts are defined in the
+     * [dotfiles repo](https://github.com/aneuhold/dotfiles).
+     */
+    static async runStartupScript() {
+        let cmd = '';
+        if (CurrentEnv.os === OperatingSystemType.Windows) {
+            // & says to powershell that you actually want to run the script in the
+            // quotes afterwards
+            // Also just running the startup script for now because of some infinite
+            // loop issues with specifying arguments
+            cmd = `& "$Home\\startup.ps1"`;
+        }
+        else {
+            cmd = 'zsh';
+            const args = ['startup.sh'];
+            await CLIService_1.default.spawnCmd(cmd, args, process.env.HOME);
+            return;
+        }
+        core_ts_lib_1.Logger.info(`Executing the following command: "${cmd}"`);
+        const { output } = await CLIService_1.default.execCmd(cmd);
+        core_ts_lib_1.Logger.info(output);
+        process.exit();
+    }
+    /**
+     * Determines the type of operating system in the current environment.
+     *
+     * This looks to be O(1) complexity.
+     */
+    static get os() {
+        if (process.platform === 'win32') {
+            return OperatingSystemType.Windows;
+        }
+        if (process.platform === 'darwin') {
+            return OperatingSystemType.MacOSX;
+        }
+        return OperatingSystemType.Unknown;
+    }
+    static folderName() {
+        return path_1.default.basename(path_1.default.resolve('.'));
+    }
+}
+exports.default = CurrentEnv;

package/lib/utils/OsaScriptBuilder.d.ts

@@ -0,0 +1,45 @@
+/**
+ * A `tell` block that can be executed in an OSA script.
+ */
+export type OsaScriptTellBlock = {
+    /**
+     * The command that goes after the `tell` keyword in the first line of the
+     * block.
+     */
+    tellCommand: string;
+    sections: OsaScriptSection[];
+};
+/**
+ * A plain command that can be executed in an OSA script.
+ */
+export type OsaScriptCommand = string;
+export type OsaScriptSection = OsaScriptTellBlock | OsaScriptCommand;
+export default class OsaScriptBuilder {
+    private currentScript;
+    /**
+     * There's no need to escape single quotes with this. That is already done
+     * in the class.
+     */
+    addCommand(command: string): void;
+    /**
+     * There's no need to escape single quotes with this. That is already done
+     * in the class.
+     */
+    addTellBlock(tellBlock: OsaScriptTellBlock): void;
+    /**
+     * Generates the full command that should be pasted as-is into a terminal.
+     *
+     * This will automatically escape any single quotes appropriately that were
+     * provided.
+     */
+    getFullCommand(): string;
+    private stringifySection;
+    /**
+     * Single quotes are escaped by splitting the string in two, then adding a
+     * single quote to the end of the first half, and combining the two halves.
+     *
+     * By putting no space inbetween the two halves, the two halves are combined.
+     */
+    private static escapeSingleQuotes;
+}
+//# sourceMappingURL=OsaScriptBuilder.d.ts.map

package/lib/utils/OsaScriptBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OsaScriptBuilder.d.ts","sourceRoot":"","sources":["../../src/utils/OsaScriptBuilder.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;AAErE,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,OAAO,CAAC,aAAa,CAA0B;IAE/C;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAIxD;;;;;OAKG;IACH,cAAc,IAAI,MAAM;IAQxB,OAAO,CAAC,gBAAgB;IAcxB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAGlC"}

package/lib/utils/OsaScriptBuilder.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class OsaScriptBuilder {
+    currentScript = [];
+    /**
+     * There's no need to escape single quotes with this. That is already done
+     * in the class.
+     */
+    addCommand(command) {
+        this.currentScript.push(command);
+    }
+    /**
+     * There's no need to escape single quotes with this. That is already done
+     * in the class.
+     */
+    addTellBlock(tellBlock) {
+        this.currentScript.push(tellBlock);
+    }
+    /**
+     * Generates the full command that should be pasted as-is into a terminal.
+     *
+     * This will automatically escape any single quotes appropriately that were
+     * provided.
+     */
+    getFullCommand() {
+        let stringifiedScript = `osascript`;
+        this.currentScript.forEach((section) => {
+            stringifiedScript += this.stringifySection(section);
+        });
+        return stringifiedScript;
+    }
+    stringifySection(section) {
+        if (typeof section === 'string') {
+            return ` -e '${OsaScriptBuilder.escapeSingleQuotes(section)}'`;
+        }
+        let stringifiedSection = ` -e 'tell ${OsaScriptBuilder.escapeSingleQuotes(section.tellCommand)}'`;
+        section.sections.forEach((subSection) => {
+            stringifiedSection += this.stringifySection(subSection);
+        });
+        stringifiedSection += ` -e 'end tell'`;
+        return stringifiedSection;
+    }
+    /**
+     * Single quotes are escaped by splitting the string in two, then adding a
+     * single quote to the end of the first half, and combining the two halves.
+     *
+     * By putting no space inbetween the two halves, the two halves are combined.
+     */
+    static escapeSingleQuotes(stringToEscape) {
+        return stringToEscape.replace(/'/g, `'\\''`);
+    }
+}
+exports.default = OsaScriptBuilder;

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@aneuhold/be-ts-lib",
+  "version": "1.0.1",
+  "description": "A backend TypeScript library used for common functionality in personal backend projects.",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "author": "Anton G Neuhold Jr <agneuhold@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aneuhold/be-ts-lib.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aneuhold/be-ts-lib/issues"
+  },
+  "homepage": "https://github.com/aneuhold/be-ts-lib#readme",
+  "files": [
+    "lib/**/*"
+  ],
+  "keywords": [
+    "Scripting",
+    "Node.js"
+  ],
+  "scripts": {
+    "pushpub": "npm run build && npm version patch && git push && npm publish --access public",
+    "build": "tsc",
+    "watch": "tsc -w",
+    "link:local": "cd lib && yarn link",
+    "unlink:local": "cd lib && yarn unlink",
+    "upgrade:all": "yarn upgrade --latest",
+    "test": "jest"
+  },
+  "dependencies": {
+    "@aneuhold/core-ts-lib": "^1.1.5",
+    "node-fetch": "^2",
+    "octokit": "^3.1.2",
+    "dotenv": "^16.3.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.8",
+    "@types/node": "^20.10.4",
+    "@types/node-fetch": "^2.6.9",
+    "@typescript-eslint/eslint-plugin": "^6.14.0",
+    "@typescript-eslint/parser": "^6.14.0",
+    "eslint": "^8.35.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.22.1",
+    "eslint-plugin-prettier": "^5.0.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.1",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.2.1",
+    "typescript": "^5.3.3"
+  }
+}