tnp-core 18.0.47 → 18.0.50

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,73 +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 ReleaseProcessType = 'manual' | 'local' | 'cloud';
+    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';
     /**
-     * All possible release types for taon
-     * for MANUAL/CLOUD release
+     * Available application environments.
      */
-    export type ReleaseArtifactTaon = 'angular-electron-app' | 'angular-frontend-webapp' | 'angular-ionic-app' | 'mkdocs-docs-webapp' | 'nodejs-backend-server' | 'npm-lib-pkg-and-cli-tool' | 'vscode-extension';
-    export const ReleaseArtifactTaonNames: Readonly<{
-        ANGULAR_ELECTRON_APP: ReleaseArtifactTaon;
+    export const EnvironmentName: Readonly<{
         /**
-         * Angular frontend webapp (pwa) inside docker
+         * Default environment, typically for artifact without application
+         * or for storing common data
          */
-        ANGULAR_FRONTEND_WEBAPP: ReleaseArtifactTaon;
+        __: "__";
         /**
-         * Angular + Ionic
+         * Local development environment, typically the developer's machine.
          */
-        ANGULAR_IONIC_APP: ReleaseArtifactTaon;
+        LOCALHOST: "localhost";
         /**
-         * MkDocs documentation webapp (pwa) inside docker
+         * Development environment used by engineers to deploy and test new features.
          */
-        MKDOCS_DOCS_WEBAPP: ReleaseArtifactTaon;
+        DEV: "dev";
         /**
-         * Nodejs backend server inside docker
-         * (could be backend or frontend or microservice)
+         * Staging environment used for final validations before production.
          */
-        NODEJS_BACKEND_SERVER: ReleaseArtifactTaon;
+        STAGE: "stage";
         /**
-         * Npm lib package and global cli tool
+         * Production environment serving live users.
          */
-        NPM_LIB_PKG_AND_CLI_TOOL: ReleaseArtifactTaon;
+        PROD: "prod";
         /**
-         * Visual Studio Code extension
+         * Automated test environment for running unit, integration, or automated tests.
          */
-        VSCODE_EXTENSION: ReleaseArtifactTaon;
-    }>;
-    export const ReleaseArtifactTaonNamesArr: ReleaseArtifactTaon[];
-    /**
-     * All possible local release types for taon
-     * for LOCAL release
-     */
-    export type LocalReleaseArtifactTaon = 'docker-backend-frontend-app' | 'global-cli-tool' | 'vscode-extension';
-    /**
-     * Object with all possible local release types for taon
-     * inside LOCAL release
-     */
-    export const LocalReleaseArtifactTaonNames: Readonly<{
-        DOCKER_BACKEND_FRONTEND_APP: LocalReleaseArtifactTaon;
+        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";
         /**
-         * Global CLI tool
+         * Demonstration environment specifically configured for client presentations and demos.
          */
-        GLOBAL_CLI_TOOL: LocalReleaseArtifactTaon;
+        DEMO: "demo";
         /**
-         * Visual Studio Code extension
+         * Continuous Integration environment used by CI/CD pipelines for automated builds and deployments.
          */
-        VSCODE_EXTENSION: LocalReleaseArtifactTaon;
+        CI: "ci";
+        /**
+         * Training environment dedicated to internal team onboarding and training activities.
+         */
+        TRAINING: "training";
     }>;
-    /**
-     * Array with all possible local release types for taon
-     * inside LOCAL release
-     */
-    export const LocalReleaseArtifactTaonNamesArr: LocalReleaseArtifactTaon[];
-    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';
+    export type EnvironmentNameTaon = (typeof EnvironmentName)[keyof typeof EnvironmentName];
     export type PUSHTYPE = 'feat' | 'chore' | 'feature' | 'refactor' | 'perf' | 'styles' | 'ci' | 'build' | 'fix' | 'bugfix' | 'release' | 'docs';
     /**
      * @deprecated
@@ -114,12 +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[];
-    /**
-     * @deprecated there will be only one lib type "isomorphic-lib"
-     */
-    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
      */
@@ -161,6 +155,7 @@ export declare namespace CoreModels {
         resolvePromiseMsgCallback?: {
             stdout?: () => any;
             stderr?: () => any;
+            exitCode?: (exitCode: number) => any;
         };
         prefix?: string;
         detach?: boolean;
@@ -181,6 +176,7 @@ export declare namespace CoreModels {
          */
         biggerBuffer?: boolean;
         askToTryAgainOnError?: boolean;
+        onChildProcessChange?: (childProcess: ChildProcess) => void;
         exitOnErrorCallback?: (code: number) => void;
         /**
          * From displaying in console
@@ -190,6 +186,8 @@ export declare namespace CoreModels {
             stderr?: boolean;
             acceptAllExitCodeAsSuccess?: boolean;
         };
+        outputBuffer?: string[];
+        outputBufferMaxSize?: number;
     }
     /**
      * @deprecated
@@ -470,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
@@ -13,6 +19,12 @@ export declare namespace Utils {
     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;
@@ -141,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
@@ -162,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 {
@@ -187,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;
     /**
@@ -246,6 +293,7 @@ export declare namespace UtilsTerminal {
             visible?: boolean;
         };
     };
+    export const wait: (second: number) => Promise<void>;
     export const clearConsole: () => void;
     export const multiselect: <T = string>(options: {
         question: string;

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/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
-}