zcatalyst-cli 1.21.0 → 1.22.0

package/lib/util_modules/env.js

@@ -1,6 +1,6 @@
 'use strict';
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEnvVariable = exports.envOverride = exports.isPrimaryShell = exports.isWindows = exports.isMac = exports.isCI = void 0;
+exports.getEnvVariable = exports.envOverride = exports.isPrimaryShell = exports.isVsCode = exports.isWindows = exports.isMac = exports.isCI = void 0;
 exports.isCI = process &&
     !!(process.env.CI ||
         process.env.CONTINUOUS_INTEGRATION ||
@@ -12,6 +12,7 @@ exports.isMac = process && process.platform === 'darwin';
 exports.isWindows = process &&
     (process.platform === 'win32' ||
         (process.env.OSTYPE !== undefined && /^(msys|cygwin)$/.test(process.env.OSTYPE)));
+exports.isVsCode = process.env.ZCATALYST_VSCODE === 'true';
 function isPrimaryShell() {
     if (!process || process.env.CATALYST_SUB_PROCESS) {
         return false;
@@ -19,7 +20,7 @@ function isPrimaryShell() {
     if (!exports.isWindows && process.env.SHLVL) {
         return parseInt(process.env.SHLVL) <= 1;
     }
-    return false;
+    return true;
 }
 exports.isPrimaryShell = isPrimaryShell;
 function envOverride(envname, value) {

package/lib/util_modules/fs/index.d.ts

@@ -0,0 +1,3 @@
+import * as ASYNC from './lib/async';
+import * as SYNC from './lib/sync';
+export { SYNC, ASYNC };

package/lib/util_modules/fs/lib/async.d.ts

@@ -0,0 +1,53 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import fs, { CopyFilterAsync, Stats } from 'fs-extra';
+type OutputType = 'buffer' | 'utf8' | undefined;
+type OutputByType<T> = T extends 'buffer' ? Buffer : string;
+export declare function isPathExists(path: string): Promise<boolean>;
+export declare function dirExists(pth: string): Promise<boolean>;
+export declare function fileExists(pth: string): Promise<boolean>;
+export declare function getFileDetails(pth: string): Promise<Stats>;
+export declare function readFile(pth: string): Promise<string | undefined>;
+export declare function readFile<T extends OutputType>(pth: string, type?: T): Promise<OutputByType<T> | undefined>;
+export declare function tempFile(): Promise<string>;
+export declare function tempFile(name: string): Promise<string>;
+export declare function tempFile(name: string, content: string | Buffer): Promise<string>;
+export declare function writeFile(pth: string, content: Buffer | Uint8Array | string, encoding?: string): Promise<void>;
+export declare function dirList(dir: string): Promise<Array<string>>;
+export declare function walk(dir: string, { filter, depth, includeDirPaths }?: {
+    filter?: {
+        exclude: Array<string> | ((path: string) => Promise<boolean>);
+        excludeDir: boolean;
+        ignoreFiles?: boolean;
+    };
+    depth?: number;
+    includeDirPaths?: boolean;
+}): Promise<Array<{
+    path: string;
+    stats: fs.Stats;
+}>>;
+export declare function ensureFile(filePath: string, cleanFile?: boolean): Promise<void>;
+export declare function ensureDir(pth: string): Promise<void>;
+export declare function deleteFile(filePath: string): Promise<void>;
+export declare function deleteDir(dir: string): Promise<void>;
+export declare function copyFile(src: string, dest: string, overwrite?: boolean): Promise<void>;
+export declare function copyFiles(src: Array<string>, dest: string): Promise<Array<void>>;
+export declare function copyDir(srcDir: string, destDir: string, { filter }?: {
+    filter?: CopyFilterAsync;
+}): Promise<void>;
+export declare function rename(pth: string, modifier?: (baseName: string, extention: string) => string): Promise<void>;
+export declare const findAndReplace: (pth: string) => (templates: string | Array<string>, finalWords: string | Array<string>) => Promise<void>;
+export declare function emptyDir(dir: string): Promise<void>;
+export declare function readJSONFile<T = Record<string, any>>(pth: string, opts?: fs.ReadOptions & {
+    checkpath?: boolean;
+}): Promise<T | undefined>;
+export declare function writeJSONFile(pth: string, object: Record<string, unknown>, opts?: fs.WriteOptions): Promise<void>;
+export declare function chmod(path: string, mode: string, { checkPath, recursive }?: {
+    checkPath?: boolean | undefined;
+    recursive?: boolean | undefined;
+}): Promise<void>;
+export declare function readStreamAsJSON<T = Record<string, unknown>>(stream: NodeJS.ReadableStream): Promise<T>;
+export declare function isDirEmpty(pth: string): Promise<boolean>;
+export {};

package/lib/util_modules/fs/lib/async.js

@@ -12,12 +12,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDirEmpty = exports.chmod = exports.writeJSONFile = exports.readJSONFile = exports.emptyDir = exports.findAndReplace = exports.rename = exports.copyDir = exports.copyFiles = exports.copyFile = exports.deleteDir = exports.deleteFile = exports.ensureDir = exports.ensureFile = exports.walk = exports.dirList = exports.writeFile = exports.tempFile = exports.readFile = exports.fileExists = exports.dirExists = exports.isPathExists = void 0;
+exports.isDirEmpty = exports.readStreamAsJSON = exports.chmod = exports.writeJSONFile = exports.readJSONFile = exports.emptyDir = exports.findAndReplace = exports.rename = exports.copyDir = exports.copyFiles = exports.copyFile = exports.deleteDir = exports.deleteFile = exports.ensureDir = exports.ensureFile = exports.walk = exports.dirList = exports.writeFile = exports.tempFile = exports.readFile = exports.getFileDetails = exports.fileExists = exports.dirExists = exports.isPathExists = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const minimatch_1 = __importDefault(require("minimatch"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const utils_js_1 = require("../utils.js");
+const index_js_1 = __importDefault(require("../../../error/index.js"));
 function isPathExists(path) {
     return __awaiter(this, void 0, void 0, function* () {
         const stats = yield fs_extra_1.default.stat((0, utils_js_1.untildify)(path)).catch(() => false);
@@ -39,6 +40,12 @@ function fileExists(pth) {
     });
 }
 exports.fileExists = fileExists;
+function getFileDetails(pth) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return fs_extra_1.default.stat((0, utils_js_1.untildify)(pth));
+    });
+}
+exports.getFileDetails = getFileDetails;
 function readFile(pth, type) {
     return __awaiter(this, void 0, void 0, function* () {
         if (!(yield fileExists(pth))) {
@@ -253,6 +260,28 @@ function chmod(path, mode, { checkPath = true, recursive = false } = {}) {
     });
 }
 exports.chmod = chmod;
+function readStreamAsJSON(stream) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve, reject) => {
+            const data = [];
+            stream.on('data', (chunk) => {
+                data.push(chunk);
+            });
+            stream.on('end', () => {
+                try {
+                    resolve(JSON.parse(Buffer.concat(data).toString()));
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+            stream.on('error', (err) => {
+                reject(index_js_1.default.getErrorInstance(err));
+            });
+        });
+    });
+}
+exports.readStreamAsJSON = readStreamAsJSON;
 function isDirEmpty(pth) {
     return __awaiter(this, void 0, void 0, function* () {
         const files = yield fs_extra_1.default.readdir(pth);

package/lib/util_modules/fs/lib/sync.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import fs, { CopyFilterSync } from 'fs-extra';
+export declare function getWriteStream(pth: string, mode?: number): fs.WriteStream;
+export declare function getReadStream(pth: string): fs.ReadStream;
+export declare function readSymLink(pth: string): string;
+export declare function fileExists(pth: string): boolean;
+export declare function pathExists(pth: string): boolean;
+export declare function dirExists(pth: string): boolean;
+export declare function getAllDirs(srcPath: string): Array<string>;
+export declare function getAllFiles(srcPath: string): Array<string>;
+export declare function deleteFile(pth: string): void;
+export declare function readFile(pth: string, encoding?: BufferEncoding): string | undefined;
+export declare function ensureDir(dir: string): void;
+export declare function ensureFile(filePath: string, cleanFile?: boolean): void;
+export declare function writeFile(pth: string, data: Buffer | Uint8Array | string, encoding?: BufferEncoding): void;
+export declare function appendFile(pth: string, data: Buffer | Uint8Array | string, encoding?: BufferEncoding): void;
+export declare function modifyFileName(pth: string | Array<string>, modifier: (fullPth: string, extension: string) => string): Array<string>;
+export declare function renameFile(pth: string | Array<string>, modifier: (fullPth: string, extension: string) => string): Array<void>;
+export declare function isPathOutside(from: string, to: string): boolean;
+export declare function isPathInside(from: string, to: string): boolean;
+export declare function deleteDir(dir: string): void;
+export declare function tempFile(name?: string): string;
+export declare function deleteTempDir(): void;
+export declare function copyFile(src: string, dest: string): void;
+export declare function copyFiles(src: Array<string>, dest: string): void;
+export declare function copyDir(srcDir: string, destDir: string, { filter, overwrite, errorOnExist }?: {
+    filter?: CopyFilterSync;
+    overwrite?: boolean;
+    errorOnExist?: boolean;
+}): void;
+export declare function emptyDir(dir: string): void;
+export declare function readJSONFile(pth: string, opts?: fs.ReadOptions & {
+    checkpath?: boolean;
+}): Record<string, any> | undefined;
+export declare function writeJSONFile(pth: string, object: Record<string, unknown>, opts?: fs.WriteOptions): void;
+export declare function readPackageJson(): Record<string, unknown> | undefined;
+export declare function isDirEmpty(pth: string): boolean;

package/lib/util_modules/fs/lib/sync.js

@@ -3,10 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDirEmpty = exports.writeJSONFile = exports.readJSONFile = exports.emptyDir = exports.copyDir = exports.copyFiles = exports.copyFile = exports.deleteTempDir = exports.tempFile = exports.deleteDir = exports.isPathInside = exports.isPathOutside = exports.renameFile = exports.modifyFileName = exports.appendFile = exports.writeFile = exports.ensureFile = exports.ensureDir = exports.readFile = exports.deleteFile = exports.getAllFiles = exports.getAllDirs = exports.dirExists = exports.pathExists = exports.fileExists = exports.readSymLink = exports.getReadStream = exports.getWriteStream = void 0;
+exports.isDirEmpty = exports.readPackageJson = exports.writeJSONFile = exports.readJSONFile = exports.emptyDir = exports.copyDir = exports.copyFiles = exports.copyFile = exports.deleteTempDir = exports.tempFile = exports.deleteDir = exports.isPathInside = exports.isPathOutside = exports.renameFile = exports.modifyFileName = exports.appendFile = exports.writeFile = exports.ensureFile = exports.ensureDir = exports.readFile = exports.deleteFile = exports.getAllFiles = exports.getAllDirs = exports.dirExists = exports.pathExists = exports.fileExists = exports.readSymLink = exports.getReadStream = exports.getWriteStream = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const os_1 = __importDefault(require("os"));
-const path_1 = __importDefault(require("path"));
+const path_1 = require("path");
 const utils_1 = require("../utils");
 function getWriteStream(pth, mode) {
     return fs_extra_1.default.createWriteStream(pth, { mode });
@@ -54,7 +54,7 @@ function getAllDirs(srcPath) {
     const directories = fs_extra_1.default
         .readdirSync(srcPath)
         .map((name) => {
-        return path_1.default.join(srcPath, name);
+        return (0, path_1.join)(srcPath, name);
     })
         .filter((source) => {
         return fs_extra_1.default.lstatSync(source).isDirectory();
@@ -66,7 +66,7 @@ function getAllFiles(srcPath) {
     const files = fs_extra_1.default
         .readdirSync(srcPath)
         .map((name) => {
-        return path_1.default.join(srcPath, name);
+        return (0, path_1.join)(srcPath, name);
     })
         .filter((source) => {
         return fs_extra_1.default.lstatSync(source).isFile();
@@ -111,8 +111,8 @@ exports.appendFile = appendFile;
 function modifyFileName(pth, modifier) {
     pth = Array.isArray(pth) ? pth : [pth];
     return pth.map((el) => {
-        const ext = path_1.default.extname(el);
-        return path_1.default.join(path_1.default.dirname(el), modifier(path_1.default.basename(el, ext), ext));
+        const ext = (0, path_1.extname)(el);
+        return (0, path_1.join)((0, path_1.dirname)(el), modifier((0, path_1.basename)(el, ext), ext));
     });
 }
 exports.modifyFileName = modifyFileName;
@@ -126,10 +126,10 @@ function isPathOutside(from, to) {
 }
 exports.isPathOutside = isPathOutside;
 function isPathInside(from, to) {
-    const relative = path_1.default.relative(from, to);
-    return !!((from === to || relative) &&
-        !relative.startsWith('..') &&
-        !path_1.default.isAbsolute(relative));
+    const relativePth = (0, path_1.relative)(from, to);
+    return !!((from === to || relativePth) &&
+        !relativePth.startsWith('..') &&
+        !(0, path_1.isAbsolute)(relativePth));
 }
 exports.isPathInside = isPathInside;
 function deleteDir(dir) {
@@ -137,26 +137,26 @@ function deleteDir(dir) {
 }
 exports.deleteDir = deleteDir;
 function tempFile(name = Date.now().toString()) {
-    const tempDir = path_1.default.join(os_1.default.tmpdir(), '.catalyst');
-    const tempFilePth = path_1.default.join(tempDir, name);
+    const tempDir = (0, path_1.join)(os_1.default.tmpdir(), '.catalyst');
+    const tempFilePth = (0, path_1.join)(tempDir, name);
     fs_extra_1.default.ensureFileSync(tempFilePth);
     return tempFilePth;
 }
 exports.tempFile = tempFile;
 function deleteTempDir() {
-    const dir = path_1.default.join(os_1.default.tmpdir(), '.catalyst');
+    const dir = (0, path_1.join)(os_1.default.tmpdir(), '.catalyst');
     return deleteDir(dir);
 }
 exports.deleteTempDir = deleteTempDir;
 function copyFile(src, dest) {
-    ensureDir(path_1.default.dirname(dest));
+    ensureDir((0, path_1.dirname)(dest));
     return fs_extra_1.default.copyFileSync(src, dest);
 }
 exports.copyFile = copyFile;
 function copyFiles(src, dest) {
     src.forEach((srcPath) => {
-        const file = path_1.default.basename(srcPath);
-        copyFile(srcPath, path_1.default.join(dest, file));
+        const file = (0, path_1.basename)(srcPath);
+        copyFile(srcPath, (0, path_1.join)(dest, file));
     });
 }
 exports.copyFiles = copyFiles;
@@ -180,6 +180,14 @@ function writeJSONFile(pth, object, opts) {
     return fs_extra_1.default.writeJsonSync(pth, object, opts);
 }
 exports.writeJSONFile = writeJSONFile;
+function readPackageJson() {
+    const pkg = readJSONFile((0, path_1.join)(__dirname, '../../../../package.json'), {
+        checkpath: true,
+        throws: false
+    });
+    return pkg;
+}
+exports.readPackageJson = readPackageJson;
 function isDirEmpty(pth) {
     const files = fs_extra_1.default.readdirSync(pth);
     return files.length === 0;

package/lib/util_modules/fs/utils.d.ts

@@ -0,0 +1 @@
+export declare const untildify: (pth: string) => string;

package/lib/util_modules/global-space.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/util_modules/js.d.ts

@@ -0,0 +1,10 @@
+import { LoDashStatic } from 'lodash';
+export interface ILodashMixin extends LoDashStatic {
+    sleep: (ms: number) => Promise<void>;
+    randomString: (length: number) => string;
+    randomNumber: (length: number) => string;
+    removeNullAndUndefined: (obj: unknown) => unknown;
+    parseJSON: (str: string) => JSON | undefined;
+    camelToTitleCase: (str: string) => string;
+}
+export declare const JS: ILodashMixin;

package/lib/util_modules/logger/index.d.ts

@@ -0,0 +1,19 @@
+export declare function log(level: 'info' | 'warn' | 'error', message: string, ignoreHttpLogger?: boolean): void;
+export declare function info(msg?: unknown, ...params: Array<unknown>): void;
+export declare function debug(msg?: unknown, ...params: Array<unknown>): void;
+export declare function success(msg: string, level?: string, label?: string, padLeft?: string): void;
+export declare function message(msg: string, level?: string, label?: string, padLeft?: string): void;
+export declare function warning(msg: string, level?: string, label?: string, padLeft?: string): void;
+export declare function error(msg: string, level?: string, label?: string, padLeft?: string): void;
+export declare const local: {
+    info: (msg?: string) => void;
+    warn: (msg?: string) => void;
+    error: (msg?: string) => void;
+};
+export declare function labeled(label: string, line: string, padLeft?: string): {
+    SUCCESS: () => void;
+    WARN: () => void;
+    MESSAGE: () => void;
+    ERROR: () => void;
+};
+export * from './utils';

package/lib/util_modules/logger/index.js

@@ -0,0 +1,80 @@
+'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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.labeled = exports.local = exports.error = exports.warning = exports.message = exports.success = exports.debug = exports.info = exports.log = void 0;
+const ansi_colors_1 = __importDefault(require("ansi-colors"));
+const utils_1 = require("./utils");
+const winston_1 = __importDefault(require("./winston"));
+const util_1 = require("util");
+const env_1 = require("../env");
+const os_1 = require("os");
+const logStream = env_1.isVsCode && utils_1.LogStreamFactory.getStream();
+function _log(level, message, ignoreHttpLogger = false) {
+    if (logStream && logStream.writable && level !== 'debug') {
+        logStream.write(message.endsWith(os_1.EOL) ? message : message + os_1.EOL);
+    }
+    winston_1.default.log({ level, message, ignoreHttpLogger });
+}
+function log(level, message, ignoreHttpLogger) {
+    _log(level, message, ignoreHttpLogger);
+}
+exports.log = log;
+function info(msg = '', ...params) {
+    _log('info', (0, util_1.format)(msg, ...params));
+}
+exports.info = info;
+function debug(msg = '', ...params) {
+    _log('debug', (0, util_1.format)(msg, ...params));
+}
+exports.debug = debug;
+function success(msg, level = 'info', label = '', padLeft = '') {
+    const postChar = label === '' ? '' : label + ': ';
+    _log(level, padLeft + ansi_colors_1.default.green(utils_1.CHAR.success + ' ' + postChar) + msg);
+}
+exports.success = success;
+function message(msg, level = 'info', label = '', padLeft = '') {
+    const postChar = label === '' ? '' : label + ': ';
+    _log(level, padLeft + ansi_colors_1.default.cyan(utils_1.CHAR.info + ' ' + postChar) + msg);
+}
+exports.message = message;
+function warning(msg, level = 'warn', label = '', padLeft = '') {
+    const postChar = label === '' ? '' : label + ': ';
+    _log(level, padLeft + ansi_colors_1.default.yellow(utils_1.CHAR.warning + ' ' + postChar) + msg);
+}
+exports.warning = warning;
+function error(msg, level = 'error', label = '', padLeft = '') {
+    const postChar = label === '' ? '' : label + ': ';
+    _log(level, padLeft + ansi_colors_1.default.red(utils_1.CHAR.error + ' ' + postChar) + msg);
+}
+exports.error = error;
+exports.local = {
+    info: (msg = '') => log('info', msg, true),
+    warn: (msg = '') => log('warn', msg, true),
+    error: (msg = '') => log('error', msg, true)
+};
+function labeled(label, line, padLeft) {
+    return {
+        SUCCESS: () => success(line, 'info', label, padLeft),
+        WARN: () => warning(line, 'warn', label, padLeft),
+        MESSAGE: () => message(line, 'info', label, padLeft),
+        ERROR: () => error(line, 'error', label, padLeft)
+    };
+}
+exports.labeled = labeled;
+__exportStar(require("./utils"), exports);

package/lib/util_modules/logger/utils.d.ts

@@ -0,0 +1,29 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import { Direction } from 'readline';
+import { PassThrough } from 'stream';
+export declare const CHAR: {
+    success: string;
+    warning: string;
+    info: string;
+    error: string;
+};
+export declare class TTYPassThrough extends PassThrough {
+    columns: number;
+    rows: number;
+    isTTY: boolean;
+    _write(chunk: Buffer, encoding: BufferEncoding, callback: (error?: Error | null) => void): void;
+    clearLine(dir: Direction, callback?: () => void): boolean;
+    clearScreenDown(callback?: () => void): boolean;
+    cursorTo(x: number, y: number, callback?: () => void): boolean;
+    moveCursor(dx: number, dy: number, callback?: () => void): boolean;
+    getColorDepth(env?: object): number;
+    hasColors(count: number, env?: object): boolean;
+    getWindowSize(): [number, number];
+}
+export declare class LogStreamFactory {
+    #private;
+    static getStream(): TTYPassThrough;
+}

package/lib/util_modules/logger/utils.js

@@ -0,0 +1,66 @@
+'use strict';
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _a, _LogStreamFactory_logStream;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogStreamFactory = exports.TTYPassThrough = exports.CHAR = void 0;
+const ansi_colors_1 = require("ansi-colors");
+const env_js_1 = require("../env.js");
+const readline_1 = require("readline");
+const stream_1 = require("stream");
+const option_1 = require("../option");
+const isSupported = !env_js_1.isWindows || process.env.CI || process.env.TERM === 'xterm-256color';
+exports.CHAR = {
+    success: isSupported ? ansi_colors_1.bold.green('✔') : ansi_colors_1.bold.green('√'),
+    warning: isSupported ? ansi_colors_1.bold.yellow('⚠') : ansi_colors_1.bold.yellow('‼'),
+    info: isSupported ? ansi_colors_1.bold.cyan('ℹ') : ansi_colors_1.bold.cyan('i'),
+    error: isSupported ? ansi_colors_1.bold.red('✖') : ansi_colors_1.bold.red('×')
+};
+class TTYPassThrough extends stream_1.PassThrough {
+    constructor() {
+        super(...arguments);
+        this.columns = process.stdout.columns;
+        this.rows = process.stdout.rows;
+        this.isTTY = true;
+    }
+    _write(chunk, encoding, callback) {
+        chunk = Buffer.from(JSON.stringify({
+            data: chunk.toString(),
+            command: (0, option_1.getCurrentCommand)()
+        }));
+        super._write(chunk, encoding, callback);
+    }
+    clearLine(dir, callback) {
+        return (0, readline_1.clearLine)(this, dir, callback);
+    }
+    clearScreenDown(callback) {
+        return (0, readline_1.clearScreenDown)(this, callback);
+    }
+    cursorTo(x, y, callback) {
+        return (0, readline_1.cursorTo)(this, x, y, callback);
+    }
+    moveCursor(dx, dy, callback) {
+        return (0, readline_1.moveCursor)(this, dx, dy, callback);
+    }
+    getColorDepth(env) {
+        return process.stdout.getColorDepth(env);
+    }
+    hasColors(count, env) {
+        return process.stdout.hasColors(count, env);
+    }
+    getWindowSize() {
+        return process.stdout.getWindowSize();
+    }
+}
+exports.TTYPassThrough = TTYPassThrough;
+class LogStreamFactory {
+    static getStream() {
+        return __classPrivateFieldGet(LogStreamFactory, _a, "f", _LogStreamFactory_logStream);
+    }
+}
+exports.LogStreamFactory = LogStreamFactory;
+_a = LogStreamFactory;
+_LogStreamFactory_logStream = { value: new TTYPassThrough() };

package/lib/util_modules/logger/winston.d.ts

@@ -0,0 +1,9 @@
+import { transports as winstonTransports } from 'winston';
+export declare const transport: {
+    console: winstonTransports.ConsoleTransportInstance;
+    log_file: winstonTransports.FileTransportInstance;
+    http_log: winstonTransports.FileTransportInstance;
+};
+export declare function verbose(enable?: boolean): void;
+export declare const logger: import("winston").Logger;
+export default logger;

package/lib/util_modules/logger/winston.js

@@ -0,0 +1,90 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.verbose = exports.transport = void 0;
+const strip_ansi_1 = __importDefault(require("strip-ansi"));
+const winston_1 = require("winston");
+const config_store_1 = __importDefault(require("../config-store"));
+const file_names_js_1 = __importDefault(require("../constants/lib/file-names.js"));
+const env_1 = require("../env");
+const fs_1 = require("../fs");
+const usage = config_store_1.default.get('usage', false);
+exports.transport = {
+    console: new winston_1.transports.Console({
+        level: 'info',
+        handleExceptions: false,
+        format: winston_1.format.printf(env_1.isCI
+            ? (info) => (0, strip_ansi_1.default)(info.message + '')
+            : (info) => {
+                return info.message + '';
+            })
+    }),
+    log_file: new winston_1.transports.File({
+        filename: file_names_js_1.default.log,
+        level: 'debug',
+        handleExceptions: true,
+        tailable: true,
+        format: winston_1.format.combine(winston_1.format.printf((info) => {
+            return `[${info.level}] [${new Date().toISOString()}] : ${(0, strip_ansi_1.default)(info.message + '')}`;
+        }))
+    }),
+    http_log: new winston_1.transports.File({
+        filename: fs_1.SYNC.tempFile(Date.now().toString() + '_' + file_names_js_1.default.http_log),
+        level: 'debug',
+        handleExceptions: true,
+        format: winston_1.format.combine((0, winston_1.format)((info) => {
+            if (info.ignoreHttpLogger) {
+                return false;
+            }
+            delete info.ignoreHttpLogger;
+            return info;
+        })(), (0, winston_1.format)((info) => {
+            info.message = (0, strip_ansi_1.default)(info.message + '');
+            return info.message === '' || info.level === 'info' ? false : info;
+        })(), winston_1.format.json(), winston_1.format.label({
+            label: 'CatalystCLI/' + (0, env_1.getEnvVariable)('ZCATALYST_CLI_VERSION', '')
+        }), winston_1.format.printf((info) => {
+            info._zl_timestamp = Date.now();
+            return JSON.stringify(info);
+        }))
+    })
+};
+if (process.env.DEBUG === 'true' || process.argv.slice(2).includes('--verbose')) {
+    verbose();
+}
+function verbose(enable = true) {
+    if (enable) {
+        exports.transport.console.level = 'debug';
+        const formats = [
+            winston_1.format.timestamp({ format: 'YYYY-MM-DD hh:mm:ss.SSS A' }),
+            winston_1.format.printf(env_1.isCI
+                ? (info) => `[${info.timestamp}] ${info.level}: ${(0, strip_ansi_1.default)(info.message + '')}`
+                : (info) => `[${info.timestamp}] ${info.level}: ${info.message}`)
+        ];
+        if (!env_1.isCI) {
+            formats.unshift(winston_1.format.cli({
+                colors: { info: 'green', error: 'red', debug: 'blue', warn: 'yellow' }
+            }));
+        }
+        exports.transport.console.format = winston_1.format.combine(...formats);
+        return;
+    }
+    exports.transport.console.level = 'info';
+    exports.transport.console.format = winston_1.format.printf((info) => {
+        return info.message + '';
+    });
+}
+exports.verbose = verbose;
+exports.logger = (0, winston_1.createLogger)({
+    transports: [exports.transport.console],
+    exitOnError: false
+});
+if (env_1.isWindows || (0, env_1.isPrimaryShell)()) {
+    if (usage) {
+        exports.logger.add(exports.transport.http_log);
+    }
+    exports.logger.add(exports.transport.log_file);
+}
+exports.default = exports.logger;

package/lib/util_modules/option.d.ts

@@ -0,0 +1,5 @@
+export declare function getCurrentCommand<T>(fallback?: T): T | string;
+export declare function getOptionValue<T = string | boolean>(key: string, fallback?: T): T;
+export declare function setGlobalOption(key: string, value: unknown): void;
+export declare function getGlobalOptionValue<T>(key: string, fallback?: T): T | string;
+export declare function getUnknownOpts<T>(fallback?: T): T | Array<string>;

package/lib/util_modules/option.js

@@ -6,22 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getUnknownOpts = exports.getGlobalOptionValue = exports.setGlobalOption = exports.getOptionValue = exports.getCurrentCommand = void 0;
 const runtime_store_1 = __importDefault(require("../runtime-store"));
 function getCurrentCommand(fallback) {
-    return runtime_store_1.default.get('opts._name', fallback);
+    return runtime_store_1.default.get('context.opts._name', fallback);
 }
 exports.getCurrentCommand = getCurrentCommand;
 function getOptionValue(key, fallback) {
-    return runtime_store_1.default.get('opts.' + key, fallback);
+    return runtime_store_1.default.get('context.opts.' + key, fallback);
 }
 exports.getOptionValue = getOptionValue;
 function setGlobalOption(key, value) {
-    runtime_store_1.default.set('opts.globalOpts.' + key, value);
+    runtime_store_1.default.set('context.opts.globalOpts.' + key, value);
 }
 exports.setGlobalOption = setGlobalOption;
 function getGlobalOptionValue(key, fallback) {
-    return runtime_store_1.default.get('opts.globalOpts.' + key, fallback);
+    return runtime_store_1.default.get('context.opts.globalOpts.' + key, fallback);
 }
 exports.getGlobalOptionValue = getGlobalOptionValue;
 function getUnknownOpts(fallback) {
-    return runtime_store_1.default.get('opts.unknownOpts', fallback);
+    return runtime_store_1.default.get('context.opts.unknownOpts', fallback);
 }
 exports.getUnknownOpts = getUnknownOpts;