tnp-core 18.0.45 → 18.0.47

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

@@ -36,9 +36,68 @@ export declare namespace CoreModels {
     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 ReleaseProcessType = 'manual' | 'local' | 'cloud';
+    /**
+     * All possible release types for taon
+     * for MANUAL/CLOUD release
+     */
+    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;
+        /**
+         * Angular frontend webapp (pwa) inside docker
+         */
+        ANGULAR_FRONTEND_WEBAPP: ReleaseArtifactTaon;
+        /**
+         * Angular + Ionic
+         */
+        ANGULAR_IONIC_APP: ReleaseArtifactTaon;
+        /**
+         * MkDocs documentation webapp (pwa) inside docker
+         */
+        MKDOCS_DOCS_WEBAPP: ReleaseArtifactTaon;
+        /**
+         * Nodejs backend server inside docker
+         * (could be backend or frontend or microservice)
+         */
+        NODEJS_BACKEND_SERVER: ReleaseArtifactTaon;
+        /**
+         * Npm lib package and global cli tool
+         */
+        NPM_LIB_PKG_AND_CLI_TOOL: ReleaseArtifactTaon;
+        /**
+         * Visual Studio Code extension
+         */
+        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;
+        /**
+         * Global CLI tool
+         */
+        GLOBAL_CLI_TOOL: LocalReleaseArtifactTaon;
+        /**
+         * Visual Studio Code extension
+         */
+        VSCODE_EXTENSION: LocalReleaseArtifactTaon;
+    }>;
+    /**
+     * 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';
@@ -57,6 +116,9 @@ export declare namespace CoreModels {
     export type TsUsage = 'import' | 'export';
     export type BaseProjectType = 'typescript' | 'angular' | 'angular-lib' | 'unknow' | 'unknow-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';
     /**
      * @deprecated

package/websql/lib/utils.d.ts

@@ -12,7 +12,6 @@ export declare namespace Utils {
     export const fullDate: () => any;
     export const getFreePort: (options?: {
         startFrom?: number;
-        howManyFreePortsAfterThatPort?: number;
     }) => Promise<number>;
     interface AttrJsoncProp {
         name: string;
@@ -90,7 +89,21 @@ export declare namespace Utils {
     export {};
 }
 export declare namespace UtilsProcess {
-    interface ProcessStartOptions {
+    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();
          */
@@ -103,20 +116,7 @@ export declare namespace UtilsProcess {
          * Modify output line by line
          */
         outputLineReplace?: (outputLineStderOrStdout: string) => string;
-        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;
-        };
+        resolvePromiseMsg?: ResolvePromiseMsg;
         /**
          * Prefix messages output from child_process
          */
@@ -141,18 +141,28 @@ export declare namespace UtilsProcess {
      * TODO IMPLEMENT
      * start async node process
      */
-    function startAsync(command: string, options?: ProcessStartOptions): Promise<void>;
     /**
-     * TODO IMPLEMENT
+     * 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.
      */
-    function startSync(command: string, options?: ProcessStartOptions): void;
-    const getGitBashPath: () => any;
+    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
      */
-    const startInNewTerminalWindow: (command: string, options?: Pick<ProcessStartOptions, "cwd" | "hideOutput">) => any;
-    const getBashOrShellName: () => "browser" | "cmd" | "powershell" | "gitbash" | "cygwin" | "unknown" | "bash" | "zsh" | "fish" | "sh";
+    export const startInNewTerminalWindow: (command: string, options?: Pick<ProcessStartOptions, "cwd" | "hideOutput">) => any;
+    export const getBashOrShellName: () => "browser" | "cmd" | "powershell" | "gitbash" | "cygwin" | "unknown" | "bash" | "zsh" | "fish" | "sh";
+    export {};
 }
 export declare namespace UtilsOs {
     /**
@@ -219,11 +229,29 @@ 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 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: {
@@ -237,18 +265,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