tnp-core 18.0.46 → 18.0.49

package/websql/lib/core-imports.d.ts

@@ -7,9 +7,49 @@ import { Chalk } from 'chalk';
 import * as json5 from 'json5';
 import type jQueryType from 'jquery';
 import type * as pathBaseType from 'path';
+import type * as globBaseType from 'glob';
+import type * as fseBaseType from 'fs-extra';
+import type * as osBaseType from 'os';
+import type * as child_processType from 'child_process';
+import type * as httpBaseType from 'http';
+import type * as httpsBaseType from 'https';
+import type * as fkillBaseType from 'fkill';
+import type * as psListBaseType from 'ps-list';
+import type * as netBaseType from 'net';
+import type * as spawnBaseType from 'cross-spawn';
+import type * as fgBaseType from 'fast-glob';
+import type { minimatch as minimatchBaseType } from 'minimatch';
+import type * as rimrafBaseType from 'rimraf';
+import type * as chokidarBaseType from 'chokidar';
+import type * as mkdirpBaseType from 'mkdirp';
+import type * as ncpBaseType from 'copy-paste';
+import type * as psBaseType from 'ps-node';
 declare let $: jQueryType;
 declare let path: typeof pathBaseType;
 declare let chalk: Chalk;
+declare let glob: typeof globBaseType;
+declare let fse: typeof fseBaseType;
+declare let os: typeof osBaseType;
+declare let child_process: typeof child_processType;
+declare let http: typeof httpBaseType;
+declare let https: typeof httpsBaseType;
+/**
+ * check if the current process is elevated
+ * - sudo in unix/macos
+ * - admin in windows
+ */
+declare let isElevated: () => Promise<boolean>;
+declare let fkill: typeof fkillBaseType;
+declare let psList: typeof psListBaseType;
+declare let net: typeof netBaseType;
+declare let spawn: typeof spawnBaseType;
+declare let minimatch: typeof minimatchBaseType;
+declare let rimraf: typeof rimrafBaseType;
+declare let chokidar: typeof chokidarBaseType;
+declare let mkdirp: typeof mkdirpBaseType;
+declare let ncp: typeof ncpBaseType;
+declare let ps: typeof psBaseType;
+declare let fg: typeof fgBaseType;
 /**
  * transform unix path to win32 path
  */
@@ -18,4 +58,4 @@ declare const win32Path: (p: string) => string;
  * This funciton will replace // to /
  */
 declare const crossPlatformPath: (pathStringOrPathParts: string | string[]) => string;
-export { _, q, moment, dateformat, crossPlatformPath, win32Path, path, chalk, json5, $, };
+export { _, q, moment, dateformat, crossPlatformPath, win32Path, path, chalk, json5, $, glob, fse, os, child_process, http, https, isElevated, fkill, psList, spawn, minimatch, fg, chokidar, mkdirp, ncp, rimraf, net, ps, };

package/websql/lib/core-models.d.ts

@@ -1,4 +1,5 @@
 // @ts-nocheck
+import type { ChildProcess } from 'child_process';
 export declare namespace CoreModels {
     export type Package = {
         name: string;
@@ -34,14 +35,69 @@ export declare namespace CoreModels {
     };
     export type InstalationType = '-g' | '--save' | '--save-dev' | 'remove';
     export const InstalationTypeArr: string[];
-    export type PackageJsonDependencyObj = 'dependencies' | 'devDependencies' | 'peerDependencies' | 'resolutions';
-    export const PackageJsonDependencyObjArr: PackageJsonDependencyObj[];
-    export type LibraryType = 'angular' | 'typescript';
-    export type ReleaseType = 'major' | 'minor' | 'patch';
-    export type PreReleaseType = 'alpha' | 'beta' | 'rc' | 'next';
+    export type ReleaseVersionType = 'major' | 'minor' | 'patch';
+    export type PreReleaseVersionTag = 'alpha' | 'beta' | 'rc' | 'next';
     export const NpmSpecialVersions: string[];
     export type PROGRESS_DATA_TYPE = 'info' | 'error' | 'warning' | 'event';
-    export type EnvironmentName = 'local' | 'static' | 'dev' | 'stage' | 'prod' | 'online' | 'test' | 'qa' | 'custom';
+    /**
+     * Available application environments.
+     */
+    export const EnvironmentName: Readonly<{
+        /**
+         * Default environment, typically for artifact without application
+         * or for storing common data
+         */
+        __: "__";
+        /**
+         * Local development environment, typically the developer's machine.
+         */
+        LOCALHOST: "localhost";
+        /**
+         * Development environment used by engineers to deploy and test new features.
+         */
+        DEV: "dev";
+        /**
+         * Staging environment used for final validations before production.
+         */
+        STAGE: "stage";
+        /**
+         * Production environment serving live users.
+         */
+        PROD: "prod";
+        /**
+         * Automated test environment for running unit, integration, or automated tests.
+         */
+        TEST: "test";
+        /**
+         * Quality assurance environment designated for manual and exploratory testing.
+         */
+        QA: "qa";
+        /**
+         * Sandbox environment for experimenting and integration without affecting other environments.
+         */
+        SANDBOX: "sandbox";
+        /**
+         * User Acceptance Testing environment where clients or stakeholders validate the release candidate.
+         */
+        UAT: "uat";
+        /**
+         * Pre-production environment, closely mirroring production for final testing and validation.
+         */
+        PREPROD: "preprod";
+        /**
+         * Demonstration environment specifically configured for client presentations and demos.
+         */
+        DEMO: "demo";
+        /**
+         * Continuous Integration environment used by CI/CD pipelines for automated builds and deployments.
+         */
+        CI: "ci";
+        /**
+         * Training environment dedicated to internal team onboarding and training activities.
+         */
+        TRAINING: "training";
+    }>;
+    export type EnvironmentNameTaon = (typeof EnvironmentName)[keyof typeof EnvironmentName];
     export type PUSHTYPE = 'feat' | 'chore' | 'feature' | 'refactor' | 'perf' | 'styles' | 'ci' | 'build' | 'fix' | 'bugfix' | 'release' | 'docs';
     /**
      * @deprecated
@@ -55,9 +111,9 @@ export declare namespace CoreModels {
     export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'jsonp';
     export type ParamType = 'Path' | 'Query' | 'Cookie' | 'Header' | 'Body';
     export type TsUsage = 'import' | 'export';
-    export type BaseProjectType = 'typescript' | 'angular' | 'angular-lib' | 'unknow' | 'unknow-npm-project';
+    export type BaseProjectType = 'typescript' | 'angular' | 'angular-lib' | 'unknown' | 'unknown-npm-project';
     export const BaseProjectTypeArr: string[];
-    export type LibType = BaseProjectType | 'isomorphic-lib' | 'container' | 'docker' | 'vscode-ext' | 'chrome-ext' | 'unknow-npm-project';
+    export type LibType = BaseProjectType | 'isomorphic-lib' | 'container' | 'unknown-npm-project';
     /**
      * @deprecated
      */
@@ -99,6 +155,7 @@ export declare namespace CoreModels {
         resolvePromiseMsgCallback?: {
             stdout?: () => any;
             stderr?: () => any;
+            exitCode?: (exitCode: number) => any;
         };
         prefix?: string;
         detach?: boolean;
@@ -119,6 +176,7 @@ export declare namespace CoreModels {
          */
         biggerBuffer?: boolean;
         askToTryAgainOnError?: boolean;
+        onChildProcessChange?: (childProcess: ChildProcess) => void;
         exitOnErrorCallback?: (code: number) => void;
         /**
          * From displaying in console
@@ -128,6 +186,8 @@ export declare namespace CoreModels {
             stderr?: boolean;
             acceptAllExitCodeAsSuccess?: boolean;
         };
+        outputBuffer?: string[];
+        outputBufferMaxSize?: number;
     }
     /**
      * @deprecated
@@ -408,35 +468,5 @@ export declare namespace CoreModels {
         hideErrors?: boolean;
         debug?: boolean;
     }
-    export interface TaonJson {
-        type: CoreModels.LibType;
-        version?: CoreModels.FrameworkVersion;
-        smartContainerBuildTarget?: string;
-        smart?: boolean;
-        monorepo?: boolean;
-        libReleaseOptions: {
-            cliBuildObscure?: boolean;
-            cliBuildUglify?: boolean;
-            cliBuildNoDts?: boolean;
-            cliBuildIncludeNodeModules?: boolean;
-        };
-        /**
-         * project is template for other project
-         */
-        isCoreProject: boolean;
-        scripts?: {
-            [script in string]: string;
-        };
-        description?: string;
-        license?: string;
-        private?: boolean;
-        author?: string;
-        homepage?: string;
-        overrided: {
-            dependencies?: {
-                [name: string]: string;
-            };
-        };
-    }
     export {};
 }

package/websql/lib/helpers-messages.d.ts

@@ -4,11 +4,14 @@ export declare class HelpersMessages extends HelpersIsomorphic {
     msgCacheClear(): void;
     renderError(err: Error): void;
     /**
-     * Throw error and exit process
-     * make sure browser or nodejs will not continue
-     * @param details
+     * throw error
      */
     throw(details: string): void;
+    /**
+     * throw error and stop application
+     * @param details
+     */
+    stopApplication(details: string): void;
     tryCatchError(error: any): void;
     error(details: any, noExit?: boolean, noTrace?: boolean): void;
     info(details: string, repeatable?: boolean): void;

package/websql/lib/helpers.d.ts

@@ -118,6 +118,9 @@ export declare class HelpersCore extends HelpersMessages {
      */
     _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?: {
@@ -164,6 +167,25 @@ export declare class HelpersCore extends HelpersMessages {
      * @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;
     hideNodeWarnings(): void;
 }

package/websql/lib/utils.d.ts

@@ -1,7 +1,13 @@
 // @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
@@ -12,8 +18,13 @@ export declare namespace Utils {
     export const fullDate: () => any;
     export const getFreePort: (options?: {
         startFrom?: number;
-        howManyFreePortsAfterThatPort?: 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;
@@ -142,6 +153,7 @@ export declare namespace UtilsProcess {
      * 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
@@ -163,6 +175,34 @@ export declare namespace UtilsProcess {
      */
     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 {
@@ -188,11 +228,17 @@ export declare namespace UtilsOs {
      * 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 isRunningInWindowsCmd: () => boolean;
     const isRunningInDocker: () => boolean;
     const isRunningInLinuxGraphicsCapableEnvironment: () => boolean;
     /**
@@ -230,11 +276,30 @@ export declare namespace UtilsMigrations {
     const isValidTimestamp: (value: any) => boolean;
 }
 export declare namespace UtilsTerminal {
+    type SelectActionChoice = {
+        [choice: string]: {
+            /**
+             * Title of the choice
+             */
+            name: string;
+            /**
+             * Action to execute
+             */
+            action?: () => any;
+            /**
+             * If choice is visible
+             *  default: true
+             */
+            visible?: boolean;
+        };
+    };
+    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: {
@@ -248,18 +313,17 @@ export declare namespace UtilsTerminal {
         autocomplete?: boolean;
         defaultSelected?: string[];
     }) => Promise<T[]>;
-    type SelectActionChoice = {
-        [choice: string]: {
-            /**
-             * Title of the choice
-             */
-            name: string;
-            /**
-             * Action to execute
-             */
-            action?: () => any;
-        };
-    };
+    /**
+     * 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

package/browser/package.json

@@ -1,25 +0,0 @@
-{
-  "name": "tnp-core",
-  "version": "0.0.1",
-  "peerDependencies": {
-    "@angular/common": "^13.2.0",
-    "@angular/core": "^13.2.0"
-  },
-  "dependencies": {
-    "tslib": "^2.3.0"
-  },
-  "module": "fesm2022/tnp-core.mjs",
-  "typings": "index.d.ts",
-  "exports": {
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./index.d.ts",
-      "esm2022": "./esm2022/tnp-core.mjs",
-      "esm": "./esm2022/tnp-core.mjs",
-      "default": "./fesm2022/tnp-core.mjs"
-    }
-  },
-  "sideEffects": false
-}

package/taon.jsonc

@@ -1,65 +0,0 @@
-{
-  "resources": [
-    "README.md"
-  ],
-  "overrided": {
-    "ignoreDepsPattern": [],
-    "includeAsDev": [],
-    "includeOnly": [
-      "axios",
-      "glob",
-      "moment",
-      "fkill",
-      "copy-paste",
-      "chokidar",
-      "fs-extra",
-      "rimraf",
-      "mkdirp",
-      "lodash",
-      "@types/lodash",
-      "ps-list",
-      "ps-node",
-      "q",
-      "@types/q",
-      "json5",
-      "is-elevated",
-      "portfinder",
-      "cross-spawn",
-      "chalk",
-      "copy-paste",
-      "is-root",
-      "is-admin",
-      "dateformat"
-    ],
-    "dependencies": {},
-    "linkedFolders": [],
-    "npmFixes": []
-  },
-  "smartContainerBuildTarget": "",
-  "linkedRepos": [],
-  "libReleaseOptions": {
-    "nodts": false,
-    "obscure": false,
-    "ugly": false,
-    "includeNodeModules": false,
-    "cliBuildNoDts": false,
-    "cliBuildObscure": false,
-    "cliBuildIncludeNodeModules": false,
-    "cliBuildUglify": false
-  },
-  "smartContainerTarget": "",
-  "type": "isomorphic-lib",
-  "isCoreProject": false,
-  "useFramework": false,
-  "required": [],
-  "version": "v18",
-  "additionalNpmNames": [
-    "taon-core"
-  ],
-  "isGenerated": false,
-  "requiredServers": [],
-  "license": "MIT",
-  "private": false,
-  "main": "index.js",
-  "workerPlugins": {}
-}

package/websql/package.json

@@ -1,25 +0,0 @@
-{
-  "name": "tnp-core",
-  "version": "0.0.1",
-  "peerDependencies": {
-    "@angular/common": "^13.2.0",
-    "@angular/core": "^13.2.0"
-  },
-  "dependencies": {
-    "tslib": "^2.3.0"
-  },
-  "module": "fesm2022/tnp-core.mjs",
-  "typings": "index.d.ts",
-  "exports": {
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./index.d.ts",
-      "esm2022": "./esm2022/tnp-core.mjs",
-      "esm": "./esm2022/tnp-core.mjs",
-      "default": "./fesm2022/tnp-core.mjs"
-    }
-  },
-  "sideEffects": false
-}