tnp-core 19.0.36 → 19.0.37

package/client/lib/helpers.d.ts

@@ -1,185 +0,0 @@
-// @ts-nocheck
-import { HelpersMessages } from './helpers-messages';
-import { CoreModels } from './core-models';
-import type { ChildProcess } from 'child_process';
-export interface RunSyncOrAsyncOptions {
-    functionFn: Function;
-    context?: object;
-    arrayOfParams?: any[];
-}
-export interface CommandOutputOptions {
-    biggerBuffer?: boolean;
-    showOnlyLastLine?: boolean;
-    showStder?: boolean;
-    gatherColors?: boolean;
-    showErrorWarning?: boolean;
-}
-export declare class HelpersCore extends HelpersMessages {
-    private static _instanceCore;
-    static get InstanceCore(): HelpersCore;
-    readonly bigMaxBuffer: number;
-    constructor();
-    /**
-     * @deprecated use UtilsOs.isRunningInsideWsl()
-     */
-    get isWsl(): boolean;
-    /**
-     * @deprecated use UtilsOs.isRunningInDocker
-     */
-    isRunningInDocker(): boolean;
-    /**
-     * @deprecated use UtilsOs.isRunningInLinuxGraphicEnvironment
-     */
-    isRunningInLinuxGraphicsCapableEnvironment(): boolean;
-    /**
-     * @deprecated use UtilsTerminal.clearConsole
-     */
-    clearConsole(): void;
-    mediaTypeFromSrc(src: string): CoreModels.MediaType;
-    sleep(seconds?: number): any;
-    removeIfExists(absoluteFileOrFolderPath: string | string[]): any;
-    /**
-     * path.relative that return cross platform path
-     */
-    relative(cwd: string, to: string): string;
-    removeFileIfExists(absoluteFilePath: string | string[]): any;
-    removeFolderIfExists(absoluteFolderPath: string | string[]): any;
-    /**
-     * leave max 1 empty line
-     */
-    removeEmptyLineFromString(str: string): string;
-    /**
-     * @deprecated
-     */
-    tryRemoveDir(dirpath: string, contentOnly?: boolean, omitWarningNotExisted?: boolean): any;
-    removeSymlinks(dirPath: string | string[], options?: {
-        dryRun?: boolean;
-    }): void;
-    /**
-     * @deprecated use safeRemove
-     */
-    remove(fileOrFolderPathOrPatter: string | string[], exactFolder?: boolean): any;
-    get isRunningInGitBash(): boolean;
-    /**
-     * Check if the current shell is supported by Taon framework.
-     */
-    get isSupportedTaonTerminal(): boolean;
-    /**
-     * check if function is class
-     */
-    isClass(funcOrClass: any): boolean;
-    /**
-     * check if data is nodejs/browser blob
-     *
-     * @param maybeBlob
-     * @returns
-     */
-    isBlob(maybeBlob: any): maybeBlob is Blob;
-    /**
-     * Check if data is nodejs buffer
-     *
-     * @param maybeNodejsBuffer
-     * @returns
-     */
-    removeSlashAtEnd(s: string): string;
-    removeSlashAtBegin(s: string): string;
-    /**
-     * stringify to pretty json string
-     */
-    stringify(inputObject: any): string;
-    runSyncOrAsync<FUNCTION_RETURN_TYPE = any>(fnOrOptions: RunSyncOrAsyncOptions): Promise<FUNCTION_RETURN_TYPE>;
-    /**
-     * symlink may have existed or unexisted destiantion url
-     * @param destUrl M
-     */
-    isSymlinkThatMatchesUrl(possibleSymlink: string, destUrl: string, absoluteFileMatch?: boolean): boolean;
-    isSymlinkFileExitedOrUnexisted(filePath: string | string[]): boolean;
-    /**
-     * If symbolnk link that target file does not exits
-     */
-    isUnexistedLink(filePath: string | string[]): boolean;
-    /**
-     * @param existedLink check if source of link exists
-     */
-    isExistedSymlink(filePath: string | string[]): boolean;
-    exists(folderOrFilePath: string | string[]): any;
-    /**
-     * this is HACK for running procesess inside processes
-     */
-    _fixCommand(command: string): string;
-    command(command: string): {};
-    /**
-     * @deprecated use UtilsTerminal.wait
-     */
-    wait(second: number): Promise<void>;
-    timeout(seconds: number): Promise<void>;
-    killProcessByPort(portOrPortsToKill: number | number[], options?: {
-        silent?: boolean;
-    }): Promise<any>;
-    killOnPort(portOrPortsToKill: number | number[], options?: {
-        silent?: boolean;
-    }): Promise<any>;
-    killProcess(byPid: number): void;
-    run(command: string, options?: CoreModels.RunOptions): {
-        /**
-         * start command as synchronous nodej proces
-         */
-        sync(): any;
-        /**
-         * start command as asynchronous nodej proces
-         * @param detach (default: false) - if true process will be detached
-         */
-        async(detach?: boolean, mockFun?: (stdoutCallback: (dataForStdout: any) => any, stdErrcCallback: (dataForStder: any) => any, shouldProcesBeDead?: () => boolean) => Promise<number> | number): ChildProcess;
-        /**
-         * start command as asynchronous nodej proces inside promise
-         */
-        asyncAsPromise(): Promise<void>;
-        unitlOutput(optionsOutput: {
-            stdoutMsg: string | string[];
-            stderMsg?: string | string[];
-            timeout?: number;
-            stdoutOutputContainsCallback?: () => any;
-            outputLineReplace?: (outputLine: string) => string;
-        }): Promise<void>;
-        /**
-         * @deprecated use unitlOutput
-         * start command as asynchronous nodej proces inside promise
-         * and wait until output contains some string
-         */
-        unitlOutputContains(stdoutMsg: string | string[], stderMsg?: string | string[], timeout?: number, stdoutOutputContainsCallback?: () => any): any;
-    };
-    /**
-     * @deprecated use UtilsTerminal.confirm
-     */
-    questionYesNo(message: string, callbackTrue?: () => any, callbackFalse?: () => any, defaultValue?: boolean): Promise<any>;
-    /**
-     * Quick fix for object values
-     * @deprecated
-     */
-    values(obj: any): any[];
-    /**
-     * does not make sense
-     * @deprecated
-     */
-    private isFile;
-    tryReadFile(absoluteFilePath: string | string[], // @ts-ignore
-    defaultValueWhenNotExists?: string, notTrim?: boolean): Promise<string | undefined>;
-    /**
-     * wrapper for fs.readFileSync
-     */
-    readFile(absoluteFilePath: string | string[], // @ts-ignore
-    defaultValueWhenNotExists?: string, notTrim?: boolean): string | undefined;
-    /**
-     * read json from absolute path
-     * @returns json object
-     */
-    readJson(absoluteFilePath: string | string[], defaultValue?: {}, useJson5?: boolean): any;
-    readJson5(absoluteFilePath: string | string[], defaultValue?: any): any;
-    readJsonC(absoluteFilePath: string | string[], defaultValue?: any): any;
-    replaceLinesInFile(absoluteFilePath: string | string[], lineReplaceFn: (line: string) => string): void;
-    getFilesFrom(folderOrLinkToFolder: string | string[], options?: {
-        recursive?: boolean;
-        followSymlinks?: boolean;
-    }): string[];
-    hideNodeWarnings(): void;
-}

package/client/lib/index.d.ts

@@ -1,12 +0,0 @@
-// @ts-nocheck
-export * from './framework-name';
-export * from './core-imports';
-export * from './core-models';
-import { HelpersCore as Base } from './helpers';
-export * from './core-config';
-export * from './progress-data';
-export * from './utils';
-export * from './core-cli';
-export * from './required-global-npm-packages';
-export { HelpersCore as CoreHelpers, CommandOutputOptions } from './helpers';
-export declare let Helpers: Base;

package/client/lib/node-chalk-mock.d.ts

@@ -1,3 +0,0 @@
-// @ts-nocheck
-import { Chalk } from 'chalk';
-export declare const chalk: Chalk;

package/client/lib/node-path-mock.d.ts

@@ -1,26 +0,0 @@
-// @ts-nocheck
-export declare const path: {
-    resolve: (pathToResovle: any) => any;
-    normalize: (pathArg: any) => any;
-    isAbsolute: (pathArg: any) => boolean;
-    join: () => any;
-    relative: (from: any, to: any) => any;
-    _makeLong: (path: any) => any;
-    dirname: (path: any) => any;
-    basename: (pathArg: any, ext: any) => any;
-    extname: (pathArg: any) => any;
-    format: (pathObject: any) => any;
-    parse: (pathArg: any) => {
-        root: string;
-        dir: string;
-        base: string;
-        ext: string;
-        name: string;
-    };
-    sep: string;
-    delimiter: string;
-    win32: {
-        normalize: (p: any) => any;
-    };
-    posix: any;
-};

package/client/lib/progress-data.d.ts

@@ -1,19 +0,0 @@
-// @ts-nocheck
-import { CoreModels } from './core-models';
-export interface IPROGRESS_DATA {
-    /**
-     * How man percent of
-     */
-    value?: number;
-    msg?: string;
-    type?: CoreModels.PROGRESS_DATA_TYPE;
-    date?: Date;
-}
-export declare class PROGRESS_DATA implements IPROGRESS_DATA {
-    static log(log: IPROGRESS_DATA): void;
-    static resolveFrom(chunk: string, callbackOnFounded?: (json: PROGRESS_DATA) => any, checkSplit?: boolean): PROGRESS_DATA[];
-    value?: number;
-    msg?: string;
-    type: CoreModels.PROGRESS_DATA_TYPE;
-    date?: Date;
-}

package/client/lib/required-global-npm-packages.d.ts

@@ -1,10 +0,0 @@
-// @ts-nocheck
-/**
- * TODO slowly refactor this.. only actually globally needed are:
- * pm2, yarn, npm-run, ts-node ???
- */
-export declare const requiredForDev: {
-    npm: any[];
-    niceTools: any[];
-    programs: any[];
-};

package/client/lib/utils.d.ts

@@ -1,388 +0,0 @@
-// @ts-nocheck
-import { Blob } from 'buffer';
-import { CoreModels } from './core-models';
-export declare namespace Utils {
-    export const uniqArray: <T = any>(array: any[], uniqueProperty?: keyof T) => T[];
-    /**
-     * @param anyObject
-     * @returns object with sorted keys
-     */
-    export const sortKeys: (anyObject: any) => any;
-    /**
-     * Example:
-     * new RegExp(escapeStringForRegEx('a.b.c'),'g') => /a\.b\.c/g
-     */
-    export const escapeStringForRegEx: (stringForRegExp: string) => string;
-    export function removeChalkSpecialChars(str: string): string;
-    export const fullDateTime: () => any;
-    export const fullDate: () => any;
-    export const getFreePort: (options?: {
-        startFrom?: number;
-    }) => Promise<number>;
-    export const requireUncached: (module: string) => any;
-    /**
-     * similar to camelCase but remove
-     * all non word / repeated characters
-     */
-    export const camelize: (str?: string) => string;
-    interface AttrJsoncProp {
-        name: string;
-        value?: any;
-    }
-    export namespace json {
-        const getAtrributies: (jsonDeepPath: string, fileContent: string) => AttrJsoncProp[];
-    }
-    export enum DbBinaryFormatEnum {
-        Blob = "Blob",
-        File = "File",
-        string = "string"
-    }
-    export type DbBinaryFormatForBrowser = Blob | File | string;
-    /**
-     * Binary format that can be stored in database
-     *
-     * for nodejs => Buffer
-     * for sql.js => string (shoulb be blob - but not supported)
-     *
-     */
-    export type DbBinaryFormat = DbBinaryFormatForBrowser;
-    export namespace binary {
-        /**
-         * This is for BROWSER ONLY
-         *
-         * @param buffer
-         * @param contentType
-         * @returns
-         */
-        function arrayBufferToBlob(buffer: ArrayBuffer, contentType: CoreModels.ContentType): Promise<Blob>;
-        /**
-         * This is for BROWSER ONLY
-         * @param blob
-         * @returns
-         */
-        function blobToArrayBuffer(blob: Blob): Promise<ArrayBuffer>;
-        /**
-         * it is revers to base64toBlob
-         * @param blob
-         * @returns
-         */
-        function blobToBase64(blob: Blob): Promise<string>;
-        /**
-         * it is revers to blobToBase64()
-         * @param base64Data
-         * @returns
-         */
-        function base64toBlob(base64Data: string, contentTypeOverride?: CoreModels.ContentType): Promise<Blob>;
-        function base64toDbBinaryFormat(text: string): Promise<DbBinaryFormat>;
-        function dbBinaryFormatToBase64(binaryFormat: DbBinaryFormat): Promise<string>;
-        function textToDbBinaryFormat(text: string): Promise<DbBinaryFormat>;
-        function dbBinaryFormatToText(binaryFormat: DbBinaryFormat): Promise<string>;
-        function fileToBlob(file: File): Promise<Blob>;
-        function blobToFile(blob: Blob, nameForFile?: string): Promise<File>;
-        function textToBlob(text: string, type?: CoreModels.ContentType): Promise<Blob>;
-        function blobToText(blob: Blob): Promise<string>;
-        function textToFile(text: string, fileRelativePathOrName: string): Promise<File>;
-        function fileToText(file: File): Promise<string>;
-        function jsonToBlob(jsonObj: object): Promise<Blob>;
-        /**
-         * TODO NOT TESTED
-         */
-        function blobToJson(blob: Blob): Promise<string>;
-        function getBlobFrom(url: string): Promise<Blob>;
-    }
-    export namespace css {
-        /**
-         *
-         * @param pixelsCss pixels ex. 100px
-         * @returns
-         */
-        function numValue(pixelsCss: string | number): number;
-    }
-    export {};
-}
-export declare namespace UtilsProcess {
-    interface ResolvePromiseMsg {
-        /**
-         * until this string is in output of stdout
-         */
-        stdout?: string | string[];
-        /**
-         * until this string is in output of stderr
-         */
-        stderr?: string | string[];
-        /**
-         * by default only resolve when exit code is 0
-         */
-        resolveAfterAnyExitCode?: boolean;
-    }
-    export interface ProcessStartOptions {
-        /**
-         * by default is process.cwd();
-         */
-        cwd?: string;
-        /**
-         * by default is false
-         */
-        showCommand?: boolean;
-        /**
-         * Modify output line by line
-         */
-        outputLineReplace?: (outputLineStderOrStdout: string) => string;
-        resolvePromiseMsg?: ResolvePromiseMsg;
-        /**
-         * Prefix messages output from child_process
-         */
-        prefix?: string;
-        /**
-         * Try command again after fail after n milliseconds
-         */
-        tryAgainWhenFailAfter?: number;
-        askToTryAgainOnError?: boolean;
-        exitOnErrorCallback?: (code: number) => void;
-        /**
-         * Use big buffer for big webpack logs
-         * (it may slow down smaller processes execution)
-         */
-        biggerBuffer?: boolean;
-        hideOutput?: {
-            stdout?: boolean;
-            stderr?: boolean;
-        };
-    }
-    /**
-     * TODO IMPLEMENT
-     * start async node process
-     */
-    export const startAsync: (command: string, cwd: string, options?: Omit<CoreModels.ExecuteOptions, "tryAgainWhenFailAfter">) => Promise<void>;
-    /**
-     * This let you start child process and resolve promise when some
-     * condition is met. It is useful for example when you want to start
-     * process and wait until some output is in stdout or stderr.
-     */
-    export const startAsyncChildProcessCommandUntil: (command: string, options: {
-        /**
-         * tels when to resolve promise
-         */
-        untilOptions: ResolvePromiseMsg;
-        displayOutputInParentProcess?: boolean;
-        resolveAfterAnyExitCode?: boolean;
-        cwd?: string;
-    }) => Promise<void>;
-    export const getGitBashPath: () => any;
-    /**
-     * TODO IMPLEMENT
-     * start async node process
-     */
-    export const startInNewTerminalWindow: (command: string, options?: Pick<ProcessStartOptions, "cwd" | "hideOutput">) => any;
-    export const getBashOrShellName: () => "browser" | "cmd" | "powershell" | "gitbash" | "cygwin" | "unknown" | "bash" | "zsh" | "fish" | "sh";
-    /**
-     * Get CPU and memory usage for a single PID.
-     */
-    export const getUsageForPid: (pid: number) => Promise<{
-        cpu: number;
-        memoryInGB: number;
-        memoryInMB: number;
-    }>;
-    /**
-     * Cross-platform function to list *direct* child PIDs of a given PID.
-     * Uses the appropriate command depending on `process.platform`.
-     */
-    export function getChildPidsOnce(pid: number): Promise<number[]>;
-    /**
-     * Get CPU and memory usage for the current process (the Node.js process itself),
-     * plus any child processes spawned by it.
-     */
-    export const getCurrentProcessAndChildUsage: () => Promise<{
-        current: {
-            cpu: number;
-            memoryInMB: number;
-        };
-        children: Array<{
-            pid: number;
-            cpu: number;
-            memoryInMB: number;
-        }>;
-    }>;
-    export {};
-}
-export declare namespace UtilsOs {
-    /**
-     * check if script is running in client browser
-     * (websql model -> is also considered as browser
-     * because it is running in browser)
-     */
-    const isRunningInBrowser: () => boolean;
-    /**
-     * check if script is running in nodejs
-     * (backend script or electron script)
-     */
-    const isRunningInNode: () => boolean;
-    /**
-     * check if script is running special
-     * browser mode that has sql.js backend
-     * and executes sql queries in browser
-     */
-    const isRunningInWebSQL: () => boolean;
-    /**
-     * check whether the current process is running inside
-     * Electron backend or browser.
-     */
-    const isRunningInElectron: () => boolean;
-    /**
-     * Check whether the current process is running inside
-     * a Visual Studio Code extension.
-     */
-    const isRunningInVscodeExtension: () => boolean;
-    /**
-     * Check wether the current process is running inside
-     * windows subsystem for linux (WSL).
-     */
-    const isRunningInWsl: () => boolean;
-    const isRunningInWindowsPowerShell: () => boolean;
-    const isRunningInWindowsCmd: () => boolean;
-    const isRunningInDocker: () => boolean;
-    const isRunningInLinuxGraphicsCapableEnvironment: () => boolean;
-    /**
-     * Check whether the current process is running in CLI mode.
-     */
-    const isRunningInCliMode: () => boolean;
-    /**
-     * Check whether the current process is running in mocha test.
-     */
-    const isRunningInMochaTest: () => boolean;
-    /**
-     * Checks if a given port is already in use (bound by another process).
-     *
-     * @param port - The port number to check.
-     * @param host - The hostname or IP address to bind to (default: '127.0.0.1').
-     * @returns Promise<boolean> - Resolves to `true` if the port is in use, otherwise `false`.
-     */
-    const isPortInUse: (port: number, options?: {
-        /**
-         * '127.0.0.1' etc..
-         */
-        checkForSpecificOnlyHost?: string;
-    }) => Promise<boolean>;
-    const isElectron: boolean;
-    const isBrowser: boolean;
-    const isNode: boolean;
-    const isWebSQL: boolean;
-    const isVscodeExtension: boolean;
-}
-export declare namespace UtilsString {
-    const kebabCaseNoSplitNumbers: (input: string) => string;
-}
-/**
- * Taon migration utilities
- */
-export declare namespace UtilsMigrations {
-    const getTimestampFromClassName: (className: string) => number | undefined;
-    const getFormattedTimestampFromClassName: (className: string) => string | undefined;
-    const formatTimestamp: (timestamp: number) => string;
-    const isValidTimestamp: (value: any) => boolean;
-}
-export declare namespace UtilsTerminal {
-    export interface SelectChoice {
-        /**
-         * Title of the choice
-         */
-        name?: string;
-        disabled?: boolean;
-    }
-    export interface SelectChoiceValue<T = string> extends SelectChoice {
-        value?: T;
-    }
-    type SelectActionChoice = {
-        [choice: string]: SelectChoice & {
-            /**
-             * Action to execute
-             */
-            action?: () => any;
-        };
-    };
-    export const wait: (second: number) => Promise<void>;
-    export const clearConsole: () => void;
-    export const multiselect: <T = string>(options: {
-        question: string;
-        /**
-         * If true, then only one choice can be selected
-         * @deprecated use select instead
-         */
-        onlyOneChoice?: boolean;
-        choices: SelectChoiceValue<T>[] | {
-            [choice: string]: SelectChoice;
-        };
-        autocomplete?: boolean;
-        defaultSelected?: string[];
-    }) => Promise<T[]>;
-    /**
-     * Similar to select but executes action if provided
-     * @returns selected and executed value
-     */
-    export const multiselectActionAndExecute: <CHOICE extends SelectActionChoice = SelectActionChoice>(choices: CHOICE, options?: {
-        question?: string;
-        autocomplete?: boolean;
-        defaultSelected?: string;
-        hint?: string;
-        executeActionsOnDefault?: boolean;
-    }) => Promise<any>;
-    /**
-     * Similar to select but executes action if provided
-     * @returns selected and executed value
-     */
-    export const selectActionAndExecute: <CHOICE extends SelectActionChoice = SelectActionChoice>(choices: CHOICE, options?: {
-        question?: string;
-        autocomplete?: boolean;
-        defaultSelected?: string;
-        hint?: string;
-        executeActionOnDefault?: boolean;
-    }) => Promise<any>;
-    export const select: <T = string>(options: {
-        question: string;
-        choices: SelectChoiceValue<T>[] | {
-            [choice: string]: SelectChoice;
-        };
-        autocomplete?: boolean;
-        defaultSelected?: string;
-        hint?: string;
-    }) => Promise<T>;
-    export const pipeEnterToStdin: () => void;
-    export const input: ({ defaultValue, question, required, }: {
-        defaultValue?: string;
-        question: string;
-        required?: boolean;
-        validate?: (value: string) => boolean;
-    }) => Promise<string>;
-    export const confirm: (options?: {
-        /**
-         * default: Are you sure?
-         */
-        message?: string;
-        callbackTrue?: () => any;
-        callbackFalse?: () => any;
-        /**
-         * default: true
-         */
-        defaultValue?: boolean;
-        engine?: "inquirer-toggle" | "prompts" | "enquirer" | "@inquirer/prompts";
-    }) => Promise<any>;
-    export const pressAnyKeyToContinueAsync: (options?: {
-        message?: string;
-    }) => Promise<void>;
-    /**
-     * @deprecated use UtilsTerminal.pressAnyKeyToContinueAsync()
-     */
-    export const pressAnyKey: (options?: {
-        message?: string;
-    }) => any;
-    export const previewLongList: (list: string | string[], listName?: string) => Promise<void>;
-    /**
-     * Displays a long list in the console using a pager like `less`.
-     * Returns a Promise that resolves when the user exits the pager.
-     *
-     * @param {string} list - The long string content to display.
-     * @returns {Promise<void>} A Promise that resolves when the pager exits.
-     */
-    export const previewLongListGitLogLike: (list: string | string[]) => Promise<void>;
-    export {};
-}

package/client/public-api.d.ts

@@ -1,2 +0,0 @@
-// @ts-nocheck
-export * from './lib';