@orxataguy/tyr 1.0.0 → 1.0.2

package/src/lib/SQLManager.ts

@@ -1,121 +1,113 @@
-import 'dotenv/config';
-import dotenv from 'dotenv';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import sql, { config as SQLConfig } from 'mssql';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-dotenv.config({ path: path.resolve(__dirname, '../../.env') });
-
-/**
- * @class SQLManager
- * @description Conector con la base de datos SQL Server.
- */
-export class SQLManager {
-  private pool!: sql.ConnectionPool;
-  private connected = false;
-
-  constructor() {
-  }
-
-  private async init(): Promise<void> {
-    if (!this.connected) {
-
-      const db_config: SQLConfig = {
-        user: process.env.MSSQL_USER,
-        password: process.env.MSSQL_PASSWORD,
-        server: process.env.MSSQL_SERVER || '',
-        database: process.env.MSSQL_DATABASE,
-        options: {
-          encrypt: false,
-          trustServerCertificate: true
-        }
-      };
-
-      this.pool = await sql.connect(db_config);
-      this.connected = true;
-    }
-  }
-
-  /**
-   * @method select
-   * @description Ejecuta un comando SELECT en SQL Server y devuelve el resultado como JSON.
-   * @param {string} query - El comando SELECT completo.
-   * @returns {Promise<any[]>} Los registros del resultado.
-   * @example
-   * await dbManager.init();
-   * const data = await dbManager.select('SELECT * FROM tabla');
-   */
-  public async select(query: string): Promise<any[]> {
-    await this.init();
-
-    const result = await this.pool.request().query(query);
-
-    await this.close();
-    return result.recordset;
-  }
-
-  /**
-   * @method searchBrokerOnDB
-   * @description Busca broker por hostname usando la query encoded.
-   * @param {string | URL} url - URL o string para extraer hostname.
-   * @returns {Promise<string>} Nombre del broker.
-   * @example
-   * const broker = await db.searchBrokerOnDB('https://www.foo.com');
-   */
-  public async searchBrokerOnDB(url: string | URL): Promise<string> {
-    let urlString = url.toString();
-
-    if (!urlString.startsWith("http://") && !urlString.startsWith("https://")) {
-      urlString = "https://" + urlString;
-    }
-    let urlObj = new URL(urlString).hostname;
-
-    if (urlObj.split('.').length < 3) {
-      urlObj = ['www', urlObj].join('.');
-    }
-
-    const isWeb = urlObj.startsWith('www') ||
-      urlObj.startsWith('horizon') ||
-      urlObj.startsWith('ambiance') ||
-      urlObj.startsWith('panorama') ||
-      urlObj.startsWith('flow') ||
-      urlObj.startsWith('panorama') ||
-      urlObj.startsWith('avantio') ||
-      urlObj.startsWith('demo');
-
-
-    const query = isWeb ? `SELECT basedir as BROKER from ftpUsers where CONCAT(prefijo, '.', dominio) = '${urlObj}'` : `SELECT LOGIN_DS AS BROKER from CR_CANALVENTAS WHERE WEB_DS = '${urlObj}'`;
-
-    await this.init();
-
-    const result = await this.pool.request().query(query);
-
-    await this.close();
-
-    if (!result.recordset[0] || !result.recordset[0].BROKER) {
-      throw new Error(`No se encontró broker para ${urlObj}`);
-    }
-
-    return result.recordset[0].BROKER as string;
-  }
-
-  private async close(): Promise<void> {
-    if (this.connected && this.pool) {
-      await this.pool.close();
-      this.connected = false;
-    }
-  }
-}
-
-/**
- * @object SQLManagerTests
- * @description Parámetros de pruebas para validar la funcionalidad de SQLManager.
- */
-export const SQLManagerTests = {
-    // init: {},
-    // select: { query: 'SELECT 1 as test_value' },
-    // connectionPool: { queries: ['SELECT 1 as q1', 'SELECT 2 as q2', 'SELECT 3 as q3'] }
+import path from 'path';
+import sql, { config as SQLConfig } from 'mssql';
+
+/**
+ * @class SQLManager
+ * @description Conector con la base de datos SQL Server.
+ */
+export class SQLManager {
+  private pool!: sql.ConnectionPool;
+  private connected = false;
+
+  constructor() {
+  }
+
+  private async init(): Promise<void> {
+    if (!this.connected) {
+
+      const db_config: SQLConfig = {
+        user: process.env.MSSQL_USER,
+        password: process.env.MSSQL_PASSWORD,
+        server: process.env.MSSQL_SERVER || '',
+        database: process.env.MSSQL_DATABASE,
+        options: {
+          encrypt: false,
+          trustServerCertificate: true
+        }
+      };
+
+      this.pool = await sql.connect(db_config);
+      this.connected = true;
+    }
+  }
+
+  /**
+   * @method select
+   * @description Ejecuta un comando SELECT en SQL Server y devuelve el resultado como JSON.
+   * @param {string} query - El comando SELECT completo.
+   * @returns {Promise<any[]>} Los registros del resultado.
+   * @example
+   * await dbManager.init();
+   * const data = await dbManager.select('SELECT * FROM tabla');
+   */
+  public async select(query: string): Promise<any[]> {
+    await this.init();
+
+    const result = await this.pool.request().query(query);
+
+    await this.close();
+    return result.recordset;
+  }
+
+  /**
+   * @method searchBrokerOnDB
+   * @description Busca broker por hostname usando la query encoded.
+   * @param {string | URL} url - URL o string para extraer hostname.
+   * @returns {Promise<string>} Nombre del broker.
+   * @example
+   * const broker = await db.searchBrokerOnDB('https://www.foo.com');
+   */
+  public async searchBrokerOnDB(url: string | URL): Promise<string> {
+    let urlString = url.toString();
+
+    if (!urlString.startsWith("http://") && !urlString.startsWith("https://")) {
+      urlString = "https://" + urlString;
+    }
+    let urlObj = new URL(urlString).hostname;
+
+    if (urlObj.split('.').length < 3) {
+      urlObj = ['www', urlObj].join('.');
+    }
+
+    const isWeb = urlObj.startsWith('www') ||
+      urlObj.startsWith('horizon') ||
+      urlObj.startsWith('ambiance') ||
+      urlObj.startsWith('panorama') ||
+      urlObj.startsWith('flow') ||
+      urlObj.startsWith('panorama') ||
+      urlObj.startsWith('avantio') ||
+      urlObj.startsWith('demo');
+
+
+    const query = isWeb ? `SELECT basedir as BROKER from ftpUsers where CONCAT(prefijo, '.', dominio) = '${urlObj}'` : `SELECT LOGIN_DS AS BROKER from CR_CANALVENTAS WHERE WEB_DS = '${urlObj}'`;
+
+    await this.init();
+
+    const result = await this.pool.request().query(query);
+
+    await this.close();
+
+    if (!result.recordset[0] || !result.recordset[0].BROKER) {
+      throw new Error(`No se encontró broker para ${urlObj}`);
+    }
+
+    return result.recordset[0].BROKER as string;
+  }
+
+  private async close(): Promise<void> {
+    if (this.connected && this.pool) {
+      await this.pool.close();
+      this.connected = false;
+    }
+  }
+}
+
+/**
+ * @object SQLManagerTests
+ * @description Parámetros de pruebas para validar la funcionalidad de SQLManager.
+ */
+export const SQLManagerTests = {
+    // init: {},
+    // select: { query: 'SELECT 1 as test_value' },
+    // connectionPool: { queries: ['SELECT 1 as q1', 'SELECT 2 as q2', 'SELECT 3 as q3'] }
 };

package/src/lib/ShellManager.ts

@@ -1,118 +1,118 @@
-import { execa } from 'execa';
-import { resolve } from 'path';
-import { homedir } from 'os';
-import inquirer from 'inquirer';
-
-import { TyrError } from '../core/TyrError.js';
-
-/**
- * @class ShellManager
- * @description Terminal command executor. Maintains the working directory (CWD) state to chain commands in specific folders.
- */
-export class ShellManager {
-    private cwd: string;
-
-    constructor() {
-        this.cwd = process.cwd();
-    }
-
-    /**
-     * @method exec
-     * @description Executes a command in the system shell and returns the standard output.
-     * @param {string} command - The full command to execute.
-     * @returns {Promise<string>} The command output (stdout) trimmed of extra whitespace.
-     * @example
-     * const version = await shell.exec('node -v');
-     */
-    public async exec(command: string): Promise<string> {
-        try {
-            const result = await execa(command, { shell: true, cwd: this.cwd });
-            return result.stdout.trim();
-        } catch (e) {
-            throw new TyrError(`An error occurred while executing the command: ${command}`, e);
-        }
-    }
-
-    /**
-    * @method showLoader
-    * @description Displays a spinner loader in the terminal.
-    * @param {string} message - Informational text to show alongside the spinner.
-    * @returns {void}
-    * @example
-    * shell.showLoader('Loading...');
-    */
-    public showLoader = (message: string): { stop: () => void } => {
-        const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-        let i = 0;
-        let stopped = false;
-
-        const interval = setInterval(() => {
-            if (!stopped) {
-                process.stdout.write(`\r${frames[i]} ${message}`);
-                i = (i + 1) % frames.length;
-            }
-        }, 80);
-
-        return {
-            stop: () => {
-                stopped = true;
-                clearInterval(interval);
-                process.stdout.write('\r');
-            }
-        };
-    };
-
-    /**
-     * @method input
-     * @description Prompts the user for a value via CLI.
-     * @param {string} question - Informational text shown as the prompt.
-     * @returns {Promise<string>} The value entered by the user.
-     * @example
-     * const name = await shell.input("What's your name?");
-     */
-    public async input(question: string): Promise<string> {
-        try {
-            const result = await inquirer.prompt([
-                {
-                    type: 'input',
-                    name: 'value',
-                    message: question,
-                },
-            ]);
-
-            return result.value.trim();
-        } catch (e) {
-            throw new TyrError(`An error occurred while prompting the question: ${question}`, e);
-        }
-    }
-
-    /**
-     * @method cd
-     * @description Changes the internal working directory for subsequent commands executed by this instance.
-     * @param {string} path - Absolute or relative path to change to.
-     * @example
-     * shell.cd('./backend');
-     * await shell.exec('npm install'); // Runs inside /backend
-     */
-    public cd(path: string): void {
-        let expandedPath = path;
-        if (path.startsWith('~/')) {
-            expandedPath = path.replace('~', homedir());
-        } else if (path === '~') {
-            expandedPath = homedir();
-        }
-
-        this.cwd = resolve(this.cwd, expandedPath);
-    }
-}
-
-/**
- * @object ShellManagerTests
- * @description Test parameters to validate ShellManager functionality.
- */
-export const ShellManagerTests = {
-    exec: { command: 'node -v' },
-    cd: { path: '/tmp' },
-    input: { question: 'Enter a test value:' },
-    showLoader: { message: 'Loading test...' }
+import { execa } from 'execa';
+import { resolve } from 'path';
+import { homedir } from 'os';
+import inquirer from 'inquirer';
+
+import { TyrError } from '../core/TyrError.js';
+
+/**
+ * @class ShellManager
+ * @description Terminal command executor. Maintains the working directory (CWD) state to chain commands in specific folders.
+ */
+export class ShellManager {
+    private cwd: string;
+
+    constructor() {
+        this.cwd = process.cwd();
+    }
+
+    /**
+     * @method exec
+     * @description Executes a command in the system shell and returns the standard output.
+     * @param {string} command - The full command to execute.
+     * @returns {Promise<string>} The command output (stdout) trimmed of extra whitespace.
+     * @example
+     * const version = await shell.exec('node -v');
+     */
+    public async exec(command: string): Promise<string> {
+        try {
+            const result = await execa(command, { shell: true, cwd: this.cwd });
+            return result.stdout.trim();
+        } catch (e) {
+            throw new TyrError(`An error occurred while executing the command: ${command}`, e);
+        }
+    }
+
+    /**
+    * @method showLoader
+    * @description Displays a spinner loader in the terminal.
+    * @param {string} message - Informational text to show alongside the spinner.
+    * @returns {void}
+    * @example
+    * shell.showLoader('Loading...');
+    */
+    public showLoader = (message: string): { stop: () => void } => {
+        const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+        let i = 0;
+        let stopped = false;
+
+        const interval = setInterval(() => {
+            if (!stopped) {
+                process.stdout.write(`\r${frames[i]} ${message}`);
+                i = (i + 1) % frames.length;
+            }
+        }, 80);
+
+        return {
+            stop: () => {
+                stopped = true;
+                clearInterval(interval);
+                process.stdout.write('\r');
+            }
+        };
+    };
+
+    /**
+     * @method input
+     * @description Prompts the user for a value via CLI.
+     * @param {string} question - Informational text shown as the prompt.
+     * @returns {Promise<string>} The value entered by the user.
+     * @example
+     * const name = await shell.input("What's your name?");
+     */
+    public async input(question: string): Promise<string> {
+        try {
+            const result = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'value',
+                    message: question,
+                },
+            ]);
+
+            return result.value.trim();
+        } catch (e) {
+            throw new TyrError(`An error occurred while prompting the question: ${question}`, e);
+        }
+    }
+
+    /**
+     * @method cd
+     * @description Changes the internal working directory for subsequent commands executed by this instance.
+     * @param {string} path - Absolute or relative path to change to.
+     * @example
+     * shell.cd('./backend');
+     * await shell.exec('npm install'); // Runs inside /backend
+     */
+    public cd(path: string): void {
+        let expandedPath = path;
+        if (path.startsWith('~/')) {
+            expandedPath = path.replace('~', homedir());
+        } else if (path === '~') {
+            expandedPath = homedir();
+        }
+
+        this.cwd = resolve(this.cwd, expandedPath);
+    }
+}
+
+/**
+ * @object ShellManagerTests
+ * @description Test parameters to validate ShellManager functionality.
+ */
+export const ShellManagerTests = {
+    exec: { command: 'node -v' },
+    cd: { path: '/tmp' },
+    input: { question: 'Enter a test value:' },
+    showLoader: { message: 'Loading test...' }
 };

package/src/lib/SystemManager.ts

@@ -1,83 +1,83 @@
-import { ShellManager } from './ShellManager.js';
-import { Logger } from '../core/Logger.js';
-import { TyrError } from '../core/TyrError.js';
-
-/**
- * @class SystemManager
- * @description General OS maintenance and cleanup utilities.
- */
-export class SystemManager {
-    private shell: ShellManager;
-    private logger: Logger;
-
-    constructor(shell: ShellManager, logger: Logger) {
-        this.shell = shell;
-        this.logger = logger;
-    }
-
-    /**
-     * @method killPort
-     * @description Identifies which process is occupying a port and force-kills it.
-     * @param {number|string} port - The port to free (e.g. 3000).
-     * @returns {Promise<boolean>} True if a process was killed, False if the port was already free.
-     * @example
-     * await sys.killPort(8080);
-     */
-    public async killPort(port: number | string): Promise<boolean> {
-        try {
-            let pid: string | null = null;
-
-            if (process.platform === 'win32') {
-                const result = await this.shell.exec(`netstat -ano | findstr :${port}`).catch(() => null);
-                if (!result?.trim()) return false;
-                const lines = result.trim().split('\n').filter(l => l.includes(`LISTENING`));
-                if (!lines.length) return false;
-                pid = lines[0].trim().split(/\s+/).pop() ?? null;
-            } else {
-                pid = await this.shell.exec(`lsof -t -i:${port}`).catch(() => null);
-            }
-
-            if (!pid?.trim()) return false;
-
-            this.logger.warn(`Port ${port} blocked by PID ${pid.trim()}. Killing...`);
-
-            if (process.platform === 'win32') {
-                await this.shell.exec(`taskkill /F /PID ${pid.trim()}`);
-            } else {
-                await this.shell.exec(`kill -9 ${pid.trim()}`);
-            }
-
-            this.logger.success(`Port ${port} freed.`);
-            return true;
-        } catch (e) {
-            throw new TyrError(`Could not free port: ${port}`, e, 'Check that you have the necessary permissions.');
-        }
-    }
-
-    /**
-     * @method nukeNodeModules
-     * @description Removes node_modules and package-lock.json from the current directory.
-     * Useful for fixing corrupted NPM installations.
-     * @example
-     * await sys.nukeNodeModules();
-     */
-    public async nukeNodeModules(): Promise<void> {
-        this.logger.info('Cleaning up dependencies...');
-        try {
-            if (process.platform === 'win32') {
-                await this.shell.exec('if exist node_modules rmdir /s /q node_modules');
-                await this.shell.exec('if exist package-lock.json del /f /q package-lock.json');
-            } else {
-                await this.shell.exec('rm -rf node_modules package-lock.json');
-            }
-            this.logger.success('node_modules and package-lock.json removed.');
-        } catch (e) {
-            if (e instanceof TyrError) throw e;
-            throw new TyrError('Could not remove node_modules.', e, 'Check write permissions on the current directory.');
-        }
-    }
-}
-
-export const SystemManagerTests = {
-    killPort: { port: 3000 },
-};
+import { ShellManager } from './ShellManager.js';
+import { Logger } from '../core/Logger.js';
+import { TyrError } from '../core/TyrError.js';
+
+/**
+ * @class SystemManager
+ * @description General OS maintenance and cleanup utilities.
+ */
+export class SystemManager {
+    private shell: ShellManager;
+    private logger: Logger;
+
+    constructor(shell: ShellManager, logger: Logger) {
+        this.shell = shell;
+        this.logger = logger;
+    }
+
+    /**
+     * @method killPort
+     * @description Identifies which process is occupying a port and force-kills it.
+     * @param {number|string} port - The port to free (e.g. 3000).
+     * @returns {Promise<boolean>} True if a process was killed, False if the port was already free.
+     * @example
+     * await sys.killPort(8080);
+     */
+    public async killPort(port: number | string): Promise<boolean> {
+        try {
+            let pid: string | null = null;
+
+            if (process.platform === 'win32') {
+                const result = await this.shell.exec(`netstat -ano | findstr :${port}`).catch(() => null);
+                if (!result?.trim()) return false;
+                const lines = result.trim().split('\n').filter(l => l.includes(`LISTENING`));
+                if (!lines.length) return false;
+                pid = lines[0].trim().split(/\s+/).pop() ?? null;
+            } else {
+                pid = await this.shell.exec(`lsof -t -i:${port}`).catch(() => null);
+            }
+
+            if (!pid?.trim()) return false;
+
+            this.logger.warn(`Port ${port} blocked by PID ${pid.trim()}. Killing...`);
+
+            if (process.platform === 'win32') {
+                await this.shell.exec(`taskkill /F /PID ${pid.trim()}`);
+            } else {
+                await this.shell.exec(`kill -9 ${pid.trim()}`);
+            }
+
+            this.logger.success(`Port ${port} freed.`);
+            return true;
+        } catch (e) {
+            throw new TyrError(`Could not free port: ${port}`, e, 'Check that you have the necessary permissions.');
+        }
+    }
+
+    /**
+     * @method nukeNodeModules
+     * @description Removes node_modules and package-lock.json from the current directory.
+     * Useful for fixing corrupted NPM installations.
+     * @example
+     * await sys.nukeNodeModules();
+     */
+    public async nukeNodeModules(): Promise<void> {
+        this.logger.info('Cleaning up dependencies...');
+        try {
+            if (process.platform === 'win32') {
+                await this.shell.exec('if exist node_modules rmdir /s /q node_modules');
+                await this.shell.exec('if exist package-lock.json del /f /q package-lock.json');
+            } else {
+                await this.shell.exec('rm -rf node_modules package-lock.json');
+            }
+            this.logger.success('node_modules and package-lock.json removed.');
+        } catch (e) {
+            if (e instanceof TyrError) throw e;
+            throw new TyrError('Could not remove node_modules.', e, 'Check write permissions on the current directory.');
+        }
+    }
+}
+
+export const SystemManagerTests = {
+    killPort: { port: 3000 },
+};