tnp-helpers 19.0.51 → 19.0.53

package/websql/lib/base/classes/base-cli-worker/base-cli-worker.d.ts

@@ -20,6 +20,7 @@ export declare abstract class BaseCliWorker<REMOTE_CTRL extends BaseCliWorkerCon
     readonly terminalUI: TERMINAL_UI;
     readonly workerContextTemplate: ReturnType<typeof Taon.createContextTemplate>;
     private workerMainContext;
+    getRemoteControllerFor(ipAddressOfTaonInstance: string, port?: number): Promise<REMOTE_CTRL>;
     private workerRemoteContext;
     readonly controllerClass: new () => REMOTE_CTRL;
     private contextForRemoteConnection;
@@ -44,7 +45,9 @@ export declare abstract class BaseCliWorker<REMOTE_CTRL extends BaseCliWorkerCon
      * start normally process
      * this will crash if process already started
      */
-    startNormallyInCurrentProcess(): Promise<void>;
+    startNormallyInCurrentProcess(options?: {
+        actionBeforeTerminalUI?: () => Promise<void>;
+    }): Promise<void>;
     getControllerForRemoteConnection(options?: {
         calledFrom?: string;
     }): Promise<REMOTE_CTRL>;

package/websql/lib/base/classes/base-docker.d.ts

@@ -0,0 +1,16 @@
+// @ts-nocheck
+import type { ChildProcess, StdioOptions } from 'child_process';
+import { BaseFeatureForProject } from './base-feature-for-project';
+import { BaseProject } from './base-project';
+export declare class BaseDocker<PROJECT extends BaseProject = any> extends BaseFeatureForProject<PROJECT> {
+    /**
+     * Updates ports in .env file based on available ports range.
+     */
+    updateDockerComposePorts(): Promise<void>;
+    getDockerComposeUpExecChildProcess(action: 'up' | 'down', options?: {
+        composeFileName?: string;
+        cwd?: string;
+        env?: NodeJS.ProcessEnv;
+        stdio?: StdioOptions;
+    }): ChildProcess;
+}

package/websql/lib/base/classes/base-file-folders-operations.d.ts

@@ -0,0 +1,17 @@
+// @ts-nocheck
+import { BaseFeatureForProject } from './base-feature-for-project';
+import type { BaseProject } from './base-project';
+export declare class BaseFileFoldersOperations<PROJECT extends BaseProject = any> extends BaseFeatureForProject<PROJECT> {
+    /**
+     * Relative to project root
+     * @returns list of files and folders to copy when copying project
+     */
+    protected fielsAndFoldersToCopy(): string[];
+    moveProjectTo(destination: string): Promise<void>;
+    deleteProject(options?: {
+        skipChildren?: boolean;
+    }): void;
+    copyProjectTo(destination: string, options?: {
+        skipChildren?: boolean;
+    }): Promise<void>;
+}

package/websql/lib/base/classes/base-git.d.ts

@@ -171,7 +171,7 @@ export declare class BaseGit<PROJECT extends BaseProject = any> extends BaseFeat
         setOrigin?: 'ssh' | 'http';
     }): Promise<void>;
     validateEmailDomain(allowedEmailsEnds: string[]): Promise<void>;
-    protected _afterPullProcessAction(setOrigin: 'ssh' | 'http'): Promise<void>;
+    protected _afterPullProcessAction(setOrigin: 'ssh' | 'http', skipCloneGitChildren?: boolean): Promise<void>;
     pushProcess(options?: PushProcessOptions): Promise<void>;
     _beforeAnyActionOnGitRoot(): void;
     protected _beforePushProcessAction(setOrigin: 'ssh' | 'http'): Promise<void>;
@@ -203,4 +203,5 @@ export declare class BaseGit<PROJECT extends BaseProject = any> extends BaseFeat
      * If false command navi reset will reset only project.
      */
     resetIsRestingAlsoChildren(): boolean;
+    useBranchNameDirectlyAsCommitMessage(): boolean;
 }

package/websql/lib/base/classes/base-ignore-hide.d.ts

@@ -0,0 +1,47 @@
+// @ts-nocheck
+import { BaseFeatureForProject } from './base-feature-for-project';
+import type { BaseProject } from './base-project';
+/**
+ * Git Ignore
+ * Vscode Files Hide
+ * Npm Ignore
+ */
+export declare class BaseIgnoreHideHelpers<PROJECT extends BaseProject = any> extends BaseFeatureForProject<PROJECT> {
+    /**
+     * (@default: false)
+     *
+     * If true, the files/folders/patterns that aren't really code and can
+     * be recreated from template project like (tsconfig.json, .babelrc, .prettierc etc.)
+     * will are stored in the repo
+     */
+    protected storeInRepoConfigFiles(): boolean;
+    init(): Promise<void>;
+    /**
+     * @param data list of patterns
+     * @returns list of patterns for recrusive ignore
+     */
+    private recursivePatternTransformFn;
+    /**
+     * Have to start with /
+     *
+     * Usefull if you are generating some files and folder in src/*.* folder
+     * (Taon CLI does this for automatic host generation)
+     * @returns patterns that are ignored in repo but visible to user
+     */
+    protected getPatternsIgnoredInRepoButVisibleToUser(): string[];
+    protected alwaysIgnoredHiddenPatterns(): string[];
+    alwaysUseRecursivePattern(): string[];
+    protected alwaysIgnoredAndHiddenFilesAndFolders(): string[];
+    protected hiddenButNeverIgnoredInRepo(): string[];
+    protected hiddenButNotNecessaryIgnoredInRepoFilesAndFolders(): string[];
+    protected hiddenButNotNecessaryIgnoredInRepoPatterns(): string[];
+    protected npmIgnoreFilesFoldersPatterns(): string[];
+    writeGitIgnore(): void;
+    /**
+     * Use can apply this to .vscode/settings.json [files.exclude] property
+     */
+    getVscodeFilesFoldersAndPatternsToHide(): {
+        [fileFolderOrPattern: string]: true;
+    };
+    writeNpmIgnore(): void;
+}

package/websql/lib/base/classes/base-linked-projects.d.ts

@@ -19,5 +19,5 @@ export declare class BaseLinkedProjects<PROJECT extends BaseProject = any> exten
     get detectedLinkedProjects(): LinkedProject[];
     get linkedProjectsPrefix(): string;
     resetLinkedProjectsOnlyToCoreBranches(): boolean;
-    cloneUnexistedLinkedProjects(setOrigin: 'ssh' | 'http'): Promise<any>;
+    cloneNonexistedLinkedProjects(setOrigin: 'ssh' | 'http'): Promise<any>;
 }

package/websql/lib/base/classes/base-linter.d.ts

@@ -0,0 +1,12 @@
+// @ts-nocheck
+import { BaseFeatureForProject } from './base-feature-for-project';
+import type { BaseProject } from './base-project';
+export declare class BaseLinter<PROJECT extends BaseProject = any> extends BaseFeatureForProject<PROJECT> {
+    init(): Promise<void>;
+    getLintFiles(): string[];
+    getConfigEditorconfig(): string;
+    getConfigPrettierrc(): object;
+    getConfigPrettierignore(): string;
+    isEnableForProject(): boolean;
+    writeLintFiles(): void;
+}

package/websql/lib/base/classes/base-package-json.d.ts

@@ -96,6 +96,9 @@ export declare class BasePackageJson extends BaseJsonFileReader<PackageJson> {
      * Minor Version from package.json
      */
     get minorVersion(): number;
+    /**
+     * @deprecated TODO not usefull ?
+     */
     getVersionAsNumber(releaseType: CoreModels.ReleaseVersionType): number;
     bumpPatchVersion(): Promise<any>;
     getBumpedVersionFor(releaseType: CoreModels.ReleaseVersionType): string;
@@ -114,4 +117,5 @@ export declare class BasePackageJson extends BaseJsonFileReader<PackageJson> {
     setMainProperty(main: string, purpose?: string): Promise<void>;
     setBuildHash(hash: string): void;
     getBuildHash(): string;
+    copyTo(location: string | string[]): void;
 }

package/websql/lib/base/classes/base-project.d.ts

@@ -2,10 +2,14 @@
 import { CoreModels } from 'tnp-core/websql';
 import { CoreProject } from '../../index';
 import { BaseProjectType } from '../../models';
+import { BaseDocker } from './base-docker';
+import { BaseFileFoldersOperations } from './base-file-folders-operations';
 import { BaseGit } from './base-git';
+import { BaseIgnoreHideHelpers } from './base-ignore-hide';
 import { BaseJavaJdk } from './base-java-jdk';
 import type { BaseLibraryBuild } from './base-library-build';
 import { BaseLinkedProjects } from './base-linked-projects';
+import { BaseLinter } from './base-linter';
 import { BaseNpmHelpers } from './base-npm-helpers';
 import { BaseProjectResolver } from './base-project-resolver';
 import { BaseQuickFixes } from './base-quick-fixes';
@@ -29,15 +33,19 @@ export declare abstract class BaseProject<PROJECT extends BaseProject<any, any>
     readonly port: string;
     libraryBuild?: BaseLibraryBuild<BaseProject>;
     npmHelpers?: BaseNpmHelpers;
+    fileFoldersOperations?: BaseFileFoldersOperations;
     get packageJson(): import("./base-package-json").BasePackageJson;
     get nodeModules(): import("./base-node-modules").BaseNodeModules<BaseNpmHelpers<BaseProject<BaseProject<any, any>, CoreModels.BaseProjectType>>>;
     linkedProjects?: BaseLinkedProjects;
     vsCodeHelpers?: BaseVscodeHelpers;
     releaseProcess?: BaseReleaseProcess;
     git?: BaseGit;
+    linter?: BaseLinter;
+    ignoreHide: BaseIgnoreHideHelpers;
     quickFixes?: BaseQuickFixes;
     staticPages?: BaseStaticPages;
     javaJdk?: BaseJavaJdk;
+    docker?: BaseDocker;
     private __location;
     get location(): string;
     set location(v: string);
@@ -168,6 +176,9 @@ export declare abstract class BaseProject<PROJECT extends BaseProject<any, any>
     remove(relativePath: string | string[], exactPath?: boolean): any;
     removeFolderByRelativePath(relativePathToFolder: string): void;
     get isAngularLib(): any;
+    refreshChildrenProjects(options?: {
+        askUserAboutUpdate?: boolean;
+    }): Promise<void>;
     protected getUniqueForTask(task: string): string;
     registerAndAssignPort(taskName: string, options?: {
         startFrom?: number;
@@ -176,7 +187,6 @@ export declare abstract class BaseProject<PROJECT extends BaseProject<any, any>
      * @deprecated use this.registerAndAssignPort() or Utils.getFreePort() instead
      */
     assignFreePort(startFrom?: number): Promise<number>;
-    removeItself(): void;
     /**
      * Purpose: not initializing all classes at the beginning
      * Only for BaseFeatureForProject class

package/websql/lib/base/classes/base-vscode.d.ts

@@ -1,29 +1,30 @@
 // @ts-nocheck
+import { CoreModels } from 'tnp-core/websql';
 import { BaseFeatureForProject } from './base-feature-for-project';
 import type { BaseProject } from './base-project';
-export interface ISettingsVscode {
-    'workbench.colorTheme': string;
-    'workbench.colorCustomizations'?: {
-        'activityBar.background'?: string;
-        'statusBar.background'?: string;
-        'statusBar.debuggingBackground'?: string;
-    };
-}
 export declare class BaseVscodeHelpers<PROJECT extends BaseProject = any> extends BaseFeatureForProject<PROJECT> {
+    init(options?: {
+        skipHiddingTempFiles?: boolean;
+    }): Promise<void>;
     /**
      * settings.json relative path
      */
     readonly relativePathSettingsJsonVscode = ".vscode/settings.json";
     readonly relativePathExtensionJsonVScode = ".vscode/extensions.json";
-    protected readonly currentSettingsValue: ISettingsVscode;
-    saveCurrentSettings(): void;
+    readonly currentSettingsValue: CoreModels.VSCodeSettings;
     constructor(project: PROJECT);
+    protected modifyVscode(modifyFN: (settings: CoreModels.VSCodeSettings) => CoreModels.VSCodeSettings): void;
+    saveCurrentSettings(): void;
     getExtensions(): string[];
     /**
      * @deprecated use getExtensions() instead
      */
     private get extensions();
     recreateExtensions(): void;
+    protected getExecuteParamsForSettings(): any[];
+    recreateBaseSettings(options?: {
+        save?: boolean;
+    }): Promise<void>;
     recreateWindowTitle(options?: {
         save?: boolean;
     }): void;
@@ -43,4 +44,11 @@ export declare class BaseVscodeHelpers<PROJECT extends BaseProject = any> extend
      */
     getVscodeBottomColor(): string;
     refreshColorsInSettings(): void;
+    getBasicSettins(): Promise<object>;
+    protected resolveParamsVscode(obj: any, prams: any[]): Promise<void>;
+    toogleFilesVisibilityInVscode(options: {
+        action: 'show-files' | 'hide-files';
+        skipSaving?: boolean;
+    }): void;
+    changeColorThemeVscode(white?: boolean): void;
 }

package/websql/lib/base/classes/index.d.ts

@@ -9,6 +9,8 @@ export * from './base-node-modules';
 export * from './base-npm-helpers';
 export * from './base-linked-projects';
 export * from './base-git';
+export * from './base-ignore-hide';
+export * from './base-linter';
 export * from './base-vscode';
 export * from './base-release-process';
 export * from './base-compiler-for-project';
@@ -16,4 +18,5 @@ export * from './base-debounce-compiler-for-project';
 export * from './base-quick-fixes';
 export * from './base-cli-worker';
 export * from './base-process-manager';
-export * from './base-command-line-feature';
+export * from './base-command-line-feature';
+export * from './base-file-folders-operations';

package/websql/lib/base/tcp-udp-ports/tcp-udp-ports.context.d.ts

@@ -6,12 +6,7 @@ export declare const PortsContextTemplate: () => {
     readonly __refSync: import("taon/websql").EndpointContext;
     getClassInstance<T>(ctor: new (...args: any[]) => T): T;
     getClass<T>(ctor: new (...args: any[]) => T): new (...args: any[]) => T;
-    initialize: (overrideOptions?: {
-        overrideHost?: string;
-        overrideRemoteHost?: string;
-        onlyMigrationRun?: boolean;
-        onlyMigrationRevertToTimestamp?: number;
-    }) => Promise<import("taon/websql").EndpointContext>;
+    initialize: (overrideOptions?: import("taon/websql").Models.TaonInitializeParams) => Promise<import("taon/websql").EndpointContext>;
     readonly realtime: {
         readonly client: import("taon/websql/lib/realtime/realtime-client").RealtimeClient;
         readonly server: import("taon/websql/lib/realtime/realtime-server").RealtimeServer;

package/websql/lib/build-info._auto-generated_.d.ts

@@ -18,4 +18,4 @@ export declare const PROJECT_NPM_NAME = "tnp-helpers";
 /**
  *  Autogenerated by current cli tool. Use *tnp release* to bump version.
  */
-export declare const CURRENT_PACKAGE_VERSION = "19.0.51";
+export declare const CURRENT_PACKAGE_VERSION = "19.0.53";

package/websql/lib/old/execute-command.d.ts

@@ -1,5 +1,5 @@
 // @ts-nocheck
-import type { ExtensionContext } from 'vscode';
+import type { ExtensionContext, Uri } from 'vscode';
 import { Log } from './helpers';
 import { ProcesOptions } from './models';
 export type ExecCommandTypeOpt = {
@@ -7,6 +7,9 @@ export type ExecCommandTypeOpt = {
     log?: Log;
     context?: ExtensionContext;
     cwd?: string;
+    uri: Uri;
+    selectedUris: Uri[];
+    rootFolderPath?: string;
 };
 export type ExecCommandType = string | string[] | ((opt: ExecCommandTypeOpt) => any);
 export declare function executeCommand(titleOfTask: any, registerName: string, commandToExecute: ExecCommandType, pOptions?: ProcesOptions, isDefaultBuildCommand?: boolean, context?: ExtensionContext, debug?: boolean): any;

package/websql/lib/utils.d.ts

@@ -207,4 +207,45 @@ export declare namespace UtilsJava {
 export declare namespace UtilsPasswords {
     const hashPassword: (password: string) => Promise<string>;
     const verifyPassword: (password: string, stored: string) => Promise<boolean>;
+}
+export declare namespace FilePathMetaData {
+    /**
+     * Embed metadata into filename while preserving the extension.
+     *
+     * Example:
+     * embedData({ version: "1.2.3", envName: "__" }, "project.zip")
+     * -> "version|-|1.2.3||--||envName|-|__|||project.zip"
+     */
+    function embedData<T extends Record<string, any>>(data: T, orgFilename: string, options?: {
+        skipAddingBasenameAtEnd?: boolean;
+    }): string;
+    /**
+     * Extract metadata from filename (reverse of embedData).
+     *
+     * Example:
+     * extractData<{ version: string; env: string }>("myfile__version-1.2.3__env-prod.zip")
+     * -> { version: "1.2.3", env: "prod" }
+     */
+    function extractData<T extends Record<string, any>>(filename: string): T;
+    const getOnlyMetadataString: (filename: string) => string;
+}
+/**
+ * Easy way to connect CLI commands to cli class methods.
+ *
+ * Example:
+ * in clic class
+ * $FirstCli {
+ *
+ *   @UtilsCliMethod.decorator('doSomething')
+ *   doSomething() {
+ *     console.log('doing something');
+ *   }
+ * }
+ *
+ * UtilsCliMethod.getFrom($FirstCli.prototype.doSomething) // "firstcli:dosomething"
+ *
+ */
+export declare namespace UtilsCliMethod {
+    const decorator: (methodName: string) => MethodDecorator;
+    const getFrom: (ClassPrototypeMethodFnHere: Function, globalMethod?: boolean) => string;
 }

package/websql/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tnp-helpers/websql",
-  "version": "19.0.51",
+  "version": "19.0.53",
   "module": "fesm2022/tnp-helpers.mjs",
   "typings": "index.d.ts",
   "exports": {