tunli 0.0.27 → 0.2.0

package/dist/sea-main.d.ts.map

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

package/dist/sea-main.js

@@ -0,0 +1,20 @@
+// SEA (Single Executable Application) entry point.
+// Bundled by esbuild into a single CJS file containing both CLI and daemon.
+// The daemon is distinguished at runtime via the TUNLI_DAEMON env var.
+// This binary is spawned and supervised by the launcher (launcher-main.ts).
+if (process.env.TUNLI_DAEMON === '1') {
+    await import('./daemon-main.js');
+}
+else {
+    // If a restart dump exists the daemon was stopped for an update.
+    // Start it now so it can restore the tunnels before the CLI runs.
+    const { existsSync } = await import('node:fs');
+    const { RESTART_DUMP_FILEPATH } = await import('./lib/defs.js');
+    if (existsSync(RESTART_DUMP_FILEPATH)) {
+        const { DaemonClient } = await import('./daemon/DaemonClient.js');
+        await DaemonClient.ensureRunning();
+    }
+    await import('./client.js');
+}
+export {};
+//# sourceMappingURL=sea-main.js.map

package/dist/sea-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sea-main.js","sourceRoot":"","sources":["../src/sea-main.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,4EAA4E;AAC5E,uEAAuE;AACvE,4EAA4E;AAE5E,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,EAAE,CAAC;IACrC,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;AAClC,CAAC;KAAM,CAAC;IACN,iEAAiE;IACjE,kEAAkE;IAClE,MAAM,EAAC,UAAU,EAAC,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAA;IAC5C,MAAM,EAAC,qBAAqB,EAAC,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;IAC7D,IAAI,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACtC,MAAM,EAAC,YAAY,EAAC,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAA;QAC/D,MAAM,YAAY,CAAC,aAAa,EAAE,CAAA;IACpC,CAAC;IACD,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;AAC7B,CAAC"}

package/dist/types/types.d.ts

@@ -0,0 +1,55 @@
+import type { ParsedGlobalConfig } from "#config/ParsedGlobalConfig";
+import type { ParsedLocalConfig } from "#config/ParsedLocalConfig";
+import type { ApiClient } from "#api-client/ApiClient";
+export type ServerConfig = {
+    readonly url: string;
+    readonly authToken: string;
+};
+export type Protocol = "http" | "https";
+export type TargetConfig = {
+    readonly protocol: Protocol;
+    readonly port: number;
+    readonly host: string;
+};
+export type ProfileConfig = {
+    readonly filepath: string;
+    readonly allowedCidr: string[];
+    readonly deniedCidr: string[];
+    readonly profileName: string;
+    readonly serverConfig: ServerConfig;
+    readonly apiClient: ApiClient;
+    readonly proxy: ProxyConfig;
+    readonly target: TargetConfig;
+};
+export type ProxyConfig = {
+    readonly proxyURL: string;
+    readonly proxyIdent: string;
+};
+export type IncomingSocketIoRequest = {
+    method: RequestMethod;
+    headers: Headers;
+    path: string;
+    port: number;
+    hostname: string;
+};
+export type RequestMethod = "GET" | "POST" | "PATCH" | "DELETE" | "HEAD" | "OPTION" | "PUT";
+export interface Headers {
+    host: string;
+    [name: string]: string;
+}
+export type Logger = {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+};
+export type Context = {
+    logger: Logger;
+    exit(code?: number): never;
+    apiClient: ApiClient;
+    config: {
+        createLocalConfig(): void;
+        global: ParsedGlobalConfig;
+        local: ParsedLocalConfig | undefined;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAErD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEvC,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAE,QAAQ,EAAE,QAAQ,CAAA;IAC5B,QAAQ,CAAE,IAAI,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAE,IAAI,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAE3F,MAAM,WAAW,OAAO;IAEtB,IAAI,EAAE,MAAM,CAAA;IAEZ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE;QACN,iBAAiB,IAAI,IAAI,CAAA;QACzB,MAAM,EAAE,kBAAkB,CAAA;QAC1B,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAAA;KACrC,CAAA;CACF,CAAA"}

package/dist/types/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":""}

package/dist/utils/arrayFunctions.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Removes duplicate elements from an array.
+ * @param value - The array from which to remove duplicates.
+ * @returns A new array with unique elements, or null if the input is not an array.
+ */
+export declare const arrayUnique: (value: any) => any[] | null;
+/**
+ * @template A
+ * @template B
+ * Merges two arrays into one.
+ * @param arr1 - The first array.
+ * @param arr2 - The second array.
+ * @returns  - A new array containing elements from both input arrays.
+ */
+export declare const arrayMerge: (arr1: any, arr2: any) => any[];
+/**
+ * Subtracts elements of the second array from the first array.
+ * @param arr1 - The array from which to subtract elements.
+ * @param arr2 - The array containing elements to subtract.
+ * @returns A new array containing elements from arr1 that are not in arr2.
+ */
+export declare const arraySub: (arr1: any, arr2: any) => any;
+export declare const arrayRemoveEntry: (array: any, search: any) => any;
+//# sourceMappingURL=arrayFunctions.d.ts.map

package/dist/utils/arrayFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayFunctions.d.ts","sourceRoot":"","sources":["../../src/utils/arrayFunctions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,GAAG,iBAKrC,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,GAAG,EAAE,MAAM,GAAG,UAI9C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,GAAG,EAAE,MAAM,GAAG,QAI5C,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,OAAO,GAAG,EAAE,QAAQ,GAAG,QAMvD,CAAA"}

package/dist/utils/arrayFunctions.js

@@ -0,0 +1,43 @@
+/**
+ * Removes duplicate elements from an array.
+ * @param value - The array from which to remove duplicates.
+ * @returns A new array with unique elements, or null if the input is not an array.
+ */
+export const arrayUnique = (value) => {
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    return Array.from(new Set(value));
+};
+/**
+ * @template A
+ * @template B
+ * Merges two arrays into one.
+ * @param arr1 - The first array.
+ * @param arr2 - The second array.
+ * @returns  - A new array containing elements from both input arrays.
+ */
+export const arrayMerge = (arr1, arr2) => {
+    arr1 ??= [];
+    arr2 ??= [];
+    return [...arr1, ...arr2];
+};
+/**
+ * Subtracts elements of the second array from the first array.
+ * @param arr1 - The array from which to subtract elements.
+ * @param arr2 - The array containing elements to subtract.
+ * @returns A new array containing elements from arr1 that are not in arr2.
+ */
+export const arraySub = (arr1, arr2) => {
+    arr1 ??= [];
+    arr2 ??= [];
+    return arr1.filter((x) => !arr2.includes(x));
+};
+export const arrayRemoveEntry = (array, search) => {
+    const delPos = array.indexOf(search);
+    if (delPos > -1) {
+        array = [...array.slice(0, delPos), ...array.slice(delPos + 1)];
+    }
+    return array;
+};
+//# sourceMappingURL=arrayFunctions.js.map

package/dist/utils/arrayFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayFunctions.js","sourceRoot":"","sources":["../../src/utils/arrayFunctions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAU,EAAE,EAAE;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;AACnC,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAS,EAAE,IAAS,EAAE,EAAE;IACjD,IAAI,KAAK,EAAE,CAAA;IACX,IAAI,KAAK,EAAE,CAAA;IACX,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAA;AAC3B,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAS,EAAE,IAAS,EAAE,EAAE;IAC/C,IAAI,KAAK,EAAE,CAAA;IACX,IAAI,KAAK,EAAE,CAAA;IACX,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AACnD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAU,EAAE,MAAW,EAAE,EAAE;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAChB,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/dist/utils/assertFunctions.d.ts

@@ -0,0 +1,7 @@
+import type { Protocol } from "#types/types";
+export declare function assertObject(value: unknown): asserts value is Record<string, unknown>;
+export declare function assertPort(value: unknown): asserts value is number;
+export declare function assertHost(value: unknown): asserts value is string;
+export declare function assertProtocol(value: unknown): asserts value is Protocol;
+export declare function assertString(value: unknown, custom?: string): asserts value is string;
+//# sourceMappingURL=assertFunctions.d.ts.map

package/dist/utils/assertFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertFunctions.d.ts","sourceRoot":"","sources":["../../src/utils/assertFunctions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAC;AAE3C,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIrF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAElE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAElE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAExE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,MAAgB,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAE9F"}

package/dist/utils/assertFunctions.js

@@ -0,0 +1,20 @@
+import { InvalidArgumentError } from "#commander/index";
+import { checkHost, checkPort, checkProtocol, checkString } from "#utils/checkFunctions";
+export function assertObject(value) {
+    if (!value || typeof value !== 'object') {
+        throw new InvalidArgumentError('Expected an object');
+    }
+}
+export function assertPort(value) {
+    checkPort(value);
+}
+export function assertHost(value) {
+    checkHost(value);
+}
+export function assertProtocol(value) {
+    checkProtocol(value);
+}
+export function assertString(value, custom = 'Value') {
+    checkString(value, custom);
+}
+//# sourceMappingURL=assertFunctions.js.map

package/dist/utils/assertFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertFunctions.js","sourceRoot":"","sources":["../../src/utils/assertFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAC,MAAM,uBAAuB,CAAC;AAGvF,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAAC,oBAAoB,CAAC,CAAA;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,SAAS,CAAC,KAAK,CAAC,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,SAAS,CAAC,KAAK,CAAC,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,aAAa,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,SAAiB,OAAO;IACnE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AAC5B,CAAC"}

package/dist/utils/checkFunctions.d.ts

@@ -0,0 +1,34 @@
+import { IPv4Address } from "@pfeiferio/ipv4";
+/**
+ * Validate and format an IPv4 address with CIDR notation.
+ * This function checks if the provided value is a valid IPv4 address with or without CIDR suffix.
+ * If valid, it returns the address formatted with its CIDR suffix.
+ * If invalid, it throws an InvalidArgumentError with an appropriate message.
+ *
+ * @param value - The IPv4 address (with or without CIDR) to validate.
+ * @returns The validated and formatted IPv4 address with CIDR suffix.
+ * @throws {InvalidArgumentError} - If the IPv4 address is not valid.
+ */
+export declare const checkIpV4Cidr: (value: unknown) => IPv4Address;
+/**
+ * Checks if the value is an integer.
+ * @param  value - The value to check.
+ * @param  [errorMessage='Value must be an integer'] - The error message to throw if validation fails.
+ * @returns The validated integer.
+ * @throws {InvalidArgumentError} - If the value is not a valid integer.
+ */
+export declare const checkInt: (value: unknown, errorMessage?: string) => number;
+/**
+ * Checks if the value is a valid URL.
+ * @param value - The value to check.
+ * @returns The validated URL.
+ * @throws {InvalidArgumentError} - If the value is not a valid URL.
+ */
+export declare const checkUrl: (value: string) => string;
+export declare const checkProtocol: (value: unknown) => string;
+export declare const checkInArray: (val: string, arr: string[], valueName?: string) => string;
+export declare const checkMd5: (hash: string) => string;
+export declare const checkPort: (value: unknown) => number;
+export declare const checkString: (value: unknown, foo?: string) => void;
+export declare const checkHost: (value: unknown) => void;
+//# sourceMappingURL=checkFunctions.d.ts.map

package/dist/utils/checkFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkFunctions.d.ts","sourceRoot":"","sources":["../../src/utils/checkFunctions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAO,WAAW,EAAC,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,WAQ9C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,EAAE,qBAAyC,KAAG,MAapF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,WAMrC,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,WAG3C,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,EAAE,YAAW,MAAgB,WAKnF,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,WAKpC,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAI1C,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,MAAK,MAAgB,SAIhE,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,SAIvC,CAAA"}

package/dist/utils/checkFunctions.js

@@ -0,0 +1,87 @@
+import { InvalidArgumentError } from "#commander/index";
+import { assertString } from "#utils/assertFunctions";
+import { ipV4, IPv4Address } from "@pfeiferio/ipv4";
+/**
+ * Validate and format an IPv4 address with CIDR notation.
+ * This function checks if the provided value is a valid IPv4 address with or without CIDR suffix.
+ * If valid, it returns the address formatted with its CIDR suffix.
+ * If invalid, it throws an InvalidArgumentError with an appropriate message.
+ *
+ * @param value - The IPv4 address (with or without CIDR) to validate.
+ * @returns The validated and formatted IPv4 address with CIDR suffix.
+ * @throws {InvalidArgumentError} - If the IPv4 address is not valid.
+ */
+export const checkIpV4Cidr = (value) => {
+    try {
+        return ipV4(value);
+    }
+    catch (e) {
+        throw new InvalidArgumentError(String(e));
+        //    throw new InvalidArgumentError('The provided value must be a valid IPv4 address, with or without CIDR notation.')
+    }
+};
+/**
+ * Checks if the value is an integer.
+ * @param  value - The value to check.
+ * @param  [errorMessage='Value must be an integer'] - The error message to throw if validation fails.
+ * @returns The validated integer.
+ * @throws {InvalidArgumentError} - If the value is not a valid integer.
+ */
+export const checkInt = (value, errorMessage = 'Value must be an integer') => {
+    if (typeof value === 'number' && Number.isInteger(value))
+        return value;
+    if (value == null)
+        throw new InvalidArgumentError(errorMessage);
+    const stringValue = value.toString();
+    if (!/^\d+$/.test(stringValue)) {
+        throw new InvalidArgumentError(errorMessage);
+    }
+    return parseInt(stringValue);
+};
+/**
+ * Checks if the value is a valid URL.
+ * @param value - The value to check.
+ * @returns The validated URL.
+ * @throws {InvalidArgumentError} - If the value is not a valid URL.
+ */
+export const checkUrl = (value) => {
+    try {
+        return new URL(value).toString();
+    }
+    catch (e) {
+        throw new InvalidArgumentError('Invalid URL');
+    }
+};
+export const checkProtocol = (value) => {
+    assertString(value, 'Protocol');
+    return checkInArray(value, ['http', 'https'], 'Protocol');
+};
+export const checkInArray = (val, arr, valueName = 'Value') => {
+    if (!arr.includes(val)) {
+        throw new InvalidArgumentError(`${valueName} must be one of (${arr.join(', ')})`);
+    }
+    return val;
+};
+export const checkMd5 = (hash) => {
+    if (!hash?.match(/^[0-9a-f]{32}$/i)) {
+        throw new InvalidArgumentError(`Value is not a valid md5 hash`);
+    }
+    return hash.toLowerCase();
+};
+export const checkPort = (value) => {
+    const port = checkInt(value, 'Port must be a valid integer');
+    if (port < 1 || port > 65535)
+        throw new InvalidArgumentError('Port must be between 1 and 65535');
+    return port;
+};
+export const checkString = (value, foo = 'Value') => {
+    if (typeof value !== 'string') {
+        throw new InvalidArgumentError(`${foo} must be a string`);
+    }
+};
+export const checkHost = (value) => {
+    if (typeof value !== 'string') {
+        throw new InvalidArgumentError('Host must be a string');
+    }
+};
+//# sourceMappingURL=checkFunctions.js.map

package/dist/utils/checkFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkFunctions.js","sourceRoot":"","sources":["../../src/utils/checkFunctions.ts"],"names":[],"mappings":"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"}

package/dist/utils/cliFunctions.d.ts

@@ -0,0 +1,10 @@
+export declare const setCursorVisibility: (visible: boolean) => void;
+export declare const clearTerminal: () => void;
+interface ProxyOptions {
+    sea?: boolean;
+    env?: Record<string, string>;
+    onBeforeRestart?: () => Promise<void>;
+}
+export declare const proxyChildProcess: (pathToExecutable: string, proxyArguments?: string[], options?: ProxyOptions) => Promise<unknown>;
+export {};
+//# sourceMappingURL=cliFunctions.d.ts.map

package/dist/utils/cliFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliFunctions.d.ts","sourceRoot":"","sources":["../../src/utils/cliFunctions.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,GAAI,SAAS,OAAO,SAMnD,CAAA;AAED,eAAO,MAAM,aAAa,YAEzB,CAAA;AAGD,UAAU,YAAY;IACpB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC;AAED,eAAO,MAAM,iBAAiB,GAC5B,kBAAkB,MAAM,EACxB,iBAAgB,MAAM,EAAkB,EACxC,UAAS,YAAiB,qBA2D3B,CAAA"}

package/dist/utils/cliFunctions.js

@@ -0,0 +1,68 @@
+import { argv, stdout } from 'node:process';
+import EventEmitter from "node:events";
+import { spawn } from "child_process";
+import { logDebug } from "#logger/logger";
+export const setCursorVisibility = (visible) => {
+    if (visible) {
+        stdout.write('\x1B[?25h');
+    }
+    else {
+        stdout.write('\x1B[?25l');
+    }
+};
+export const clearTerminal = () => {
+    stdout.write('\x1B[2J\x1B[0f');
+};
+export const proxyChildProcess = (pathToExecutable, proxyArguments = argv.slice(2), options = {}) => {
+    const command = options.sea ? pathToExecutable : 'node';
+    const args = options.sea ? proxyArguments : [pathToExecutable, ...proxyArguments];
+    const env = options.env ? { ...process.env, ...options.env } : undefined;
+    const eventEmitter = new EventEmitter();
+    const createSpawnProcessPromise = () => {
+        logDebug('Lifecycle: Initializing child process spawn...');
+        const onError = (error) => {
+            logDebug(`Lifecycle: Spawn failed or process encountered an error: ${error.message}`);
+            eventEmitter.emit('close', 1);
+        };
+        const onClose = (code) => {
+            if (code === null) {
+                logDebug('Lifecycle: Child process was terminated externally (SIGKILL/SIGTERM).');
+                clearTerminal();
+            }
+            else {
+                logDebug(`Lifecycle: Child process exited with code ${code}`);
+            }
+            eventEmitter.emit('close', code);
+        };
+        const onMessage = (message) => {
+            logDebug(`Received IPC message: ${message}`);
+            if (message === 'restart') {
+                child.off('close', onClose);
+                child.kill();
+                const doRestart = async () => {
+                    logDebug('Lifecycle: Child process termination signal sent. Preparing restart hooks...');
+                    await options.onBeforeRestart?.();
+                    logDebug('Lifecycle: Restart hooks completed. Emitting spawn event for new process.');
+                    eventEmitter.emit('spawn');
+                };
+                void doRestart();
+            }
+        };
+        const child = spawn(command, args, {
+            stdio: ['inherit', 'inherit', 'inherit', 'ipc'],
+            env,
+        })
+            .on('close', onClose)
+            .on('error', onError)
+            .on('message', onMessage);
+        if (child.pid) {
+            logDebug(`Lifecycle: Child process successfully started (PID: ${child.pid})`);
+        }
+    };
+    eventEmitter.on('spawn', () => createSpawnProcessPromise());
+    return new Promise((resolve) => {
+        eventEmitter.once('close', resolve);
+        eventEmitter.emit('spawn');
+    });
+};
+//# sourceMappingURL=cliFunctions.js.map

package/dist/utils/cliFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliFunctions.js","sourceRoot":"","sources":["../../src/utils/cliFunctions.ts"],"names":[],"mappings":"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"}

package/dist/utils/hashFunctions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @param value
+ */
+export declare const md5: (value: {
+    toString(): string;
+}) => string;
+export declare const sha256: (value: {
+    toString(): string;
+}) => string;
+//# sourceMappingURL=hashFunctions.d.ts.map

package/dist/utils/hashFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashFunctions.d.ts","sourceRoot":"","sources":["../../src/utils/hashFunctions.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,GAAG,GAAI,OAAO;IAAE,QAAQ,IAAI,MAAM,CAAA;CAAE,WAEhD,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,OAAO;IAAE,QAAQ,IAAI,MAAM,CAAA;CAAE,WAEnD,CAAA"}

package/dist/utils/hashFunctions.js

@@ -0,0 +1,11 @@
+import { createHash } from 'crypto';
+/**
+ * @param value
+ */
+export const md5 = (value) => {
+    return createHash('md5').update(value.toString()).digest('hex');
+};
+export const sha256 = (value) => {
+    return createHash('sha256').update(value.toString()).digest('hex');
+};
+//# sourceMappingURL=hashFunctions.js.map

package/dist/utils/hashFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashFunctions.js","sourceRoot":"","sources":["../../src/utils/hashFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,QAAQ,CAAA;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,KAA6B,EAAE,EAAE;IACnD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACjE,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAA6B,EAAE,EAAE;IACtD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACpE,CAAC,CAAA"}

package/dist/utils/npmFunctions.d.ts

@@ -0,0 +1,3 @@
+export declare const checkGlobalInstallation: (packageName: string) => Promise<unknown>;
+export declare const checkLocalInstallation: (packageName: string) => Promise<unknown>;
+//# sourceMappingURL=npmFunctions.d.ts.map

package/dist/utils/npmFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npmFunctions.d.ts","sourceRoot":"","sources":["../../src/utils/npmFunctions.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,GAAI,aAAa,MAAM,qBAU1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,aAAa,MAAM,qBAWzD,CAAA"}

package/dist/utils/npmFunctions.js

@@ -0,0 +1,28 @@
+import { exec } from 'child_process';
+import { dirname, join } from 'path';
+export const checkGlobalInstallation = (packageName) => {
+    return new Promise((resolve) => {
+        exec(`npm list -g --depth=0 ${packageName}`, (_error, stdout) => {
+            if (stdout.includes(packageName)) {
+                resolve(true);
+            }
+            else {
+                resolve(false);
+            }
+        });
+    });
+};
+export const checkLocalInstallation = (packageName) => {
+    const localPath = join(process.cwd(), 'node_modules', packageName);
+    return new Promise((resolve) => {
+        exec(`npm list --depth=0 ${packageName}`, { cwd: dirname(process.argv[1]) }, (_error, stdout) => {
+            if (stdout.includes(localPath)) {
+                resolve(true);
+            }
+            else {
+                resolve(false);
+            }
+        });
+    });
+};
+//# sourceMappingURL=npmFunctions.js.map

package/dist/utils/npmFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npmFunctions.js","sourceRoot":"","sources":["../../src/utils/npmFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AACnC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAC,MAAM,MAAM,CAAC;AAEnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,WAAmB,EAAE,EAAE;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,yBAAyB,WAAW,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;YAC9D,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,CAAA;YACf,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,CAAA;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,WAAmB,EAAE,EAAE;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,CAAC,CAAA;IAClE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,sBAAsB,WAAW,EAAE,EAAE,EAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,EAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;YAC7F,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,CAAA;YACf,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,CAAA;YAChB,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/utils/stringFunctions.d.ts

@@ -0,0 +1,12 @@
+export declare const trimEnd: (string: string, trimChar?: string) => string;
+export declare const trimStart: (string: string, trimChar: string) => string;
+export declare const removeControlChars: (string: string) => string;
+export declare const padEndIgnoreControlChars: (string: string, maxLength: number, fillString?: string, autoSubstring?: string | boolean) => string;
+/**
+ * Replaces template placeholders in a string with corresponding values from a replacements object.
+ *
+ * @param template - The string containing placeholders in the format {{ placeholder }}.
+ * @param replacements - The object containing replacement values. Nested placeholders can be accessed using dot notation.
+ */
+export declare const replaceTemplatePlaceholders: (template: string, replacements: Record<string, unknown>) => string;
+//# sourceMappingURL=stringFunctions.d.ts.map

package/dist/utils/stringFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringFunctions.d.ts","sourceRoot":"","sources":["../../src/utils/stringFunctions.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,WAAU,MAAY,WAG7D,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,WAGzD,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,WAGhD,CAAA;AAED,eAAO,MAAM,wBAAwB,GAClC,QAAQ,MAAM,EAAE,WAAW,MAAM,EAAE,aAAY,MAAY,EAAE,gBAAe,MAAM,GAAG,OAAe,WAkBpG,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GACrC,UAAU,MAAM,EAAE,cAAc,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAwC,CAAA"}

package/dist/utils/stringFunctions.js

@@ -0,0 +1,37 @@
+import { interpolate } from "@pfeiferio/string-interpolate";
+export const trimEnd = (string, trimChar = ' ') => {
+    const regex = new RegExp(`${trimChar}+$`);
+    return string.replace(regex, '');
+};
+export const trimStart = (string, trimChar) => {
+    const regex = new RegExp(`^${trimChar}+`);
+    return string.replace(regex, '');
+};
+export const removeControlChars = (string) => {
+    const removeControlCharsRegex = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+    return string.replace(removeControlCharsRegex, '');
+};
+export const padEndIgnoreControlChars = (string, maxLength, fillString = ' ', autoSubstring = false) => {
+    if (maxLength < 0) {
+        return string;
+    }
+    const stringWithoutCC = removeControlChars(string);
+    if (autoSubstring !== false && stringWithoutCC.length > maxLength) {
+        if (autoSubstring !== true) {
+            return stringWithoutCC.substring(0, maxLength - autoSubstring.length) + autoSubstring;
+        }
+        else {
+            return stringWithoutCC.substring(0, maxLength);
+        }
+    }
+    const padding = ''.padEnd(maxLength - stringWithoutCC.length, fillString);
+    return `${string}${padding}`;
+};
+/**
+ * Replaces template placeholders in a string with corresponding values from a replacements object.
+ *
+ * @param template - The string containing placeholders in the format {{ placeholder }}.
+ * @param replacements - The object containing replacement values. Nested placeholders can be accessed using dot notation.
+ */
+export const replaceTemplatePlaceholders = (template, replacements) => interpolate(template, replacements);
+//# sourceMappingURL=stringFunctions.js.map

package/dist/utils/stringFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringFunctions.js","sourceRoot":"","sources":["../../src/utils/stringFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,+BAA+B,CAAC;AAE1D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,WAAmB,GAAG,EAAE,EAAE;IAChE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAA;IACzC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAClC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,QAAgB,EAAE,EAAE;IAC5D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAA;IACzC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAClC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAE,EAAE;IACnD,MAAM,uBAAuB,GAAG,6EAA6E,CAAA;IAC7G,OAAO,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAA;AACpD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,wBAAwB,GACnC,CAAC,MAAc,EAAE,SAAiB,EAAE,aAAqB,GAAG,EAAE,gBAAkC,KAAK,EAAE,EAAE;IAEvG,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAElD,IAAI,aAAa,KAAK,KAAK,IAAI,eAAe,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAClE,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAA;QACvF,CAAC;aAAM,CAAC;YACN,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACzE,OAAO,GAAG,MAAM,GAAG,OAAO,EAAE,CAAA;AAC9B,CAAC,CAAA;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,CAAC,QAAgB,EAAE,YAAqC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA"}