tnp-helpers 19.0.44 → 19.0.45

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

@@ -0,0 +1,10 @@
+// @ts-nocheck
+import { Models } from 'taon/websql';
+/**
+ * Get taon service database config
+ * (database is stored in user's home directory)
+ * @param serviceNameUniqueInSystem - unique name of the service in the system
+ * @param recreateMode - mode of database recreation, default is 'DROP_DB+MIGRATIONS'
+ * @returns DatabaseConfig object with location and recreateMode
+ */
+export declare const getBaseCliWorkerDatabaseConfig: (serviceNameUniqueInSystem: string, recreateMode?: Models.DBRecreateMode) => any;

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

@@ -1,13 +1,19 @@
 // @ts-nocheck
-import type { CfontAlign, CfontStyle } from '../../../models';
+import { CoreModels } from 'tnp-core/websql';
 import type { BaseCliWorker } from './base-cli-worker';
 import type { BaseCliWorkerController } from './base-cli-worker-controller';
+export type BaseWorkerTerminalActionReturnType = {
+    [uniqeActionName: string]: {
+        name: string;
+        action: () => unknown | Promise<unknown>;
+    };
+};
 export declare class BaseCliWorkerTerminalUI<WORKER extends BaseCliWorker<BaseCliWorkerController, any>> {
     protected worker: WORKER;
     constructor(worker: WORKER);
     protected headerText(): Promise<string>;
-    protected textHeaderStyle(): CfontStyle;
-    protected headerTextAlign(): CfontAlign;
+    protected textHeaderStyle(): CoreModels.CfontStyle;
+    protected headerTextAlign(): CoreModels.CfontAlign;
     /**
      * override whole terminal header
      */
@@ -27,12 +33,7 @@ export declare class BaseCliWorkerTerminalUI<WORKER extends BaseCliWorker<BaseCl
     protected getWorkerTerminalActions(options?: {
         exitIsOnlyReturn?: boolean;
         chooseAction?: boolean;
-    }): {
-        [uniqeActionName: string]: {
-            name: string;
-            action: () => unknown | Promise<unknown>;
-        };
-    };
+    }): BaseWorkerTerminalActionReturnType;
     infoScreen(options?: {
         exitIsOnlyReturn?: boolean;
     }): Promise<void>;

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

@@ -39,11 +39,15 @@ export declare abstract class BaseCliWorker<REMOTE_CTRL extends BaseCliWorkerCon
      */
     serviceVersion: string);
     /**
+     * <strong>IMPORTANT USE ONLY IN DEVELOPMENT !!!</strong>
+     * for production use startDetachedIfNeedsToBeStarted()
      * start normally process
      * this will crash if process already started
      */
-    protected startNormallyInCurrentProcess(): Promise<void>;
-    getControllerForRemoteConnection(): Promise<REMOTE_CTRL>;
+    startNormallyInCurrentProcess(): Promise<void>;
+    getControllerForRemoteConnection(options?: {
+        calledFrom?: string;
+    }): Promise<REMOTE_CTRL>;
     startDetachedIfNeedsToBeStarted(options?: {
         useCurrentWindowForDetach?: boolean;
     }): Promise<any>;
@@ -85,6 +89,8 @@ export declare abstract class BaseCliWorker<REMOTE_CTRL extends BaseCliWorkerCon
     }): Promise<void>;
     private saveProcessInfo;
     protected initializeWorkerMetadata(): Promise<any>;
-    protected waitForProcessPortSavedToDisk(): Promise<void>;
+    protected waitForProcessPortSavedToDisk(options?: {
+        calledFrom?: string;
+    }): Promise<void>;
     getServicePort(): Promise<number>;
 }

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

@@ -1,5 +1,6 @@
 // @ts-nocheck
 export * from './base-cli-worker';
+export * from './base-cli-worker-database-config';
 export * from './base-cli-worker-controller';
 export * from './base-cli-worker-config';
 export * from './base-cli-worker-terminal-ui';

package/websql/lib/base/tcp-udp-ports/tcp-upd-ports-terminal-ui.d.ts

@@ -1,12 +1,12 @@
 // @ts-nocheck
+import { CoreModels } from 'tnp-core/websql';
 import { Port } from '../../index';
-import { CfontStyle } from '../../models';
 import { BaseCliWorkerTerminalUI } from '../classes/base-cli-worker/base-cli-worker-terminal-ui';
 import { PortStatus } from './ports.entity';
 import type { PortsWorker } from './tcp-upd-ports.worker';
 export declare class TcpUdpPortsTerminalUI extends BaseCliWorkerTerminalUI<PortsWorker> {
     protected headerText(): Promise<string>;
-    protected textHeaderStyle(): CfontStyle;
+    protected textHeaderStyle(): CoreModels.CfontStyle;
     protected crudMenuForTakeByOsPorts(): Promise<void>;
     protected addPortTerminalUiProcess(): Promise<void>;
     protected selectPortProcess(ports: Port[], title: string): Promise<Port>;

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.44";
+export declare const CURRENT_PACKAGE_VERSION = "19.0.45";

package/websql/lib/helpers/for-backend/helpers-file-folders.d.ts

@@ -101,7 +101,7 @@ export declare class HelpersFileFolders {
     } & CopyOptionsSync): void;
     filterDontCopy(basePathFoldersTosSkip: string[], projectOrBasepath: string): any;
     filterOnlyCopy(basePathFoldersOnlyToInclude: string[], projectOrBasepath: string): any;
-    copyFile(sourcePath: string, destinationPath: string, options?: {
+    copyFile(sourcePath: string | string[], destinationPath: string | string[], options?: {
         transformTextFn?: (input: string) => string;
         debugMode?: boolean;
         fast?: boolean;

package/websql/lib/models.d.ts

@@ -137,8 +137,6 @@ export declare class CommandProcess {
     start(options?: CommandProcessRunOptions): Promise<void>;
     stop(): Promise<void>;
 }
-export type CfontStyle = 'block' | 'slick' | 'tiny' | 'grid' | 'pallet' | 'shade' | 'chrome' | 'simple' | 'simpleBlock' | '3d' | 'simple3d' | 'huge';
-export type CfontAlign = 'left' | 'center' | 'right' | 'block';
 export interface DockerComposeFile {
     version: string;
     services: Record<string, DockerService>;

package/websql/lib/utils.d.ts

@@ -19,7 +19,7 @@ export declare namespace UtilsTypescript {
      * @param regionName - The name of the region to remove.
      * @returns Modified TypeScript code without the specified regions.
      */
-    export const removeRegionByName: (sourceCode: string, regionName: string) => string;
+    const removeRegionByName: (sourceCode: string, regionName: string) => string;
     interface ExportInfo {
         type: 'class' | 'function' | 'const' | 'let' | 'var' | 'enum' | 'type' | 'interface' | 'default' | 'module' | 'namespace';
         name: string;
@@ -27,34 +27,34 @@ export declare namespace UtilsTypescript {
     /**
      * Function to extract exports from a TypeScript file
      */
-    export const exportsFromFile: (filePath: string) => ExportInfo[];
+    const exportsFromFile: (filePath: string) => ExportInfo[];
     /**
      * Function to extract exports from a TypeScript file
      */
-    export const exportsFromContent: (fileContent: string) => ExportInfo[];
-    export const extractDefaultClassNameFromString: (sourceCode: string) => string | undefined;
-    export const extractClassNameFromString: (sourceCode: string) => string[];
-    export const extractClassNamesFromFile: (absoluteFilePath: string) => string[];
-    export const extractDefaultClassNameFromFile: (absoluteFilePath: string) => any;
-    export const formatFile: (absPathToFile: string | string[]) => void;
-    export const formatAllFilesInsideFolder: (absPathToFolder: string) => void;
-    export const eslintFixFile: (absPathToFile: string | string[]) => void;
-    export const eslintFixAllFilesInsideFolder: (absPathToFolder: string | string[]) => void;
-    export const getTaonContextFromContent: (fileContent: string) => string[];
-    export const getTaonContextsNamesFromFile: (tsAbsFilePath: string) => string[];
-    export const extractAngularComponentSelectors: (fileAbsPath: string) => {
+    const exportsFromContent: (fileContent: string) => ExportInfo[];
+    const extractDefaultClassNameFromString: (sourceCode: string) => string | undefined;
+    const extractClassNameFromString: (sourceCode: string) => string[];
+    const extractClassNamesFromFile: (absoluteFilePath: string) => string[];
+    const extractDefaultClassNameFromFile: (absoluteFilePath: string) => any;
+    const formatFile: (absPathToFile: string | string[]) => void;
+    const formatAllFilesInsideFolder: (absPathToFolder: string) => void;
+    const eslintFixFile: (absPathToFile: string | string[]) => void;
+    const eslintFixAllFilesInsideFolder: (absPathToFolder: string | string[]) => void;
+    const getTaonContextFromContent: (fileContent: string) => string[];
+    const getTaonContextsNamesFromFile: (tsAbsFilePath: string) => string[];
+    const extractAngularComponentSelectors: (fileAbsPath: string) => {
         className: string;
         selector: string;
     }[];
-    export const wrapWithComment: (oneLineComment: string, absDestFilePath: string) => any;
+    const wrapWithComment: (oneLineComment: string, absDestFilePath: string) => any;
     /**
      * Attempts to set or add an exported const with given name and value.
      */
-    export const setValueToVariableInTsFile: (tsAbsFilePath: string, variableName: string, valueOfVariable: any, options?: {
+    const setValueToVariableInTsFile: (tsAbsFilePath: string, variableName: string, valueOfVariable: any, options?: {
         skipAddIfNotExists?: boolean;
         useRawStringValue?: boolean;
     }) => void;
-    export class TsImportExport {
+    class TsImportExport {
         /**
          * for external modification
          */
@@ -96,27 +96,26 @@ export declare namespace UtilsTypescript {
         getStringPartFrom(wholeContentOfFile: string): string;
         wrapInParenthesis(str: string): string;
     }
-    export const recognizeImportsFromFile: (fileAbsPAth: string) => TsImportExport[];
-    export const recognizeImportsFromContent: (fileContent: string) => TsImportExport[];
+    const recognizeImportsFromFile: (fileAbsPAth: string) => TsImportExport[];
+    const recognizeImportsFromContent: (fileContent: string) => TsImportExport[];
     /**
      * Transition methods ng18 => ng19
      * Remove standalone:true from component decorator
      * and add standalone: false if not exists
      */
-    export function transformComponentStandaloneOption(sourceText: string): string;
-    export const fixHtmlTemplatesInDir: (directoryPath: string) => void;
-    export function removeTaggedImportExport(tsFileContent: string, tags: string[]): string;
-    export const wrapFirstImportsInImportsRegion: (fileContent: string) => string;
+    function transformComponentStandaloneOption(sourceText: string): string;
+    const fixHtmlTemplatesInDir: (directoryPath: string) => void;
+    function removeTaggedImportExport(tsFileContent: string, tags: string[]): string;
+    const wrapFirstImportsInImportsRegion: (fileContent: string) => string;
     /**
      * wrap class field with decorators
      * wrap class methods with decorators
      */
-    export function wrapContentClassMembersDecoratorsWithRegion(classFileContent: string, wrapTag?: string): string;
-    export const clearRequireCacheRecursive: (modulePath: string, seen?: Set<string>) => void;
-    export type DeepWritable<T> = {
+    function wrapContentClassMembersDecoratorsWithRegion(classFileContent: string, wrapTag?: string): string;
+    const clearRequireCacheRecursive: (modulePath: string, seen?: Set<string>) => void;
+    type DeepWritable<T> = {
         -readonly [P in keyof T]: T[P] extends object ? T[P] extends Function ? T[P] : DeepWritable<T[P]> : T[P];
     };
-    export {};
 }
 export declare namespace UtilsHttp {
     const startHttpServer: (cwd: string, port: number) => Promise<any>;
@@ -157,7 +156,8 @@ export declare namespace UtilsVSCode {
     const vscodeImport: () => any;
 }
 export declare namespace UtilsDotFile {
-    const setValueToDotFile: (dotFileAbsPath: string | string[], value: string, key: string | number | boolean) => void;
+    const setValueToDotFile: (dotFileAbsPath: string | string[], key: string, value: string | number | boolean) => void;
+    const setCommentToKeyInDotFile: (dotFileAbsPath: string | string[], key: string, comment: string) => void;
     const getValueFromDotFile: (dotFileAbsPath: string | string[], key: string) => string | number | boolean;
     const setValuesKeysFromObject: (dotFileAbsPath: string | string[], obj: Record<string, string | number | boolean>, options?: {
         /**
@@ -166,6 +166,10 @@ export declare namespace UtilsDotFile {
         setAsNewFile?: boolean;
     }) => void;
     const getValuesKeysAsJsonObject: <T = Record<string, string | number | boolean>>(dotFileAbsPath: string | string[]) => T;
+    /**
+     * @returns key|comment pairs as json object
+     */
+    const getCommentsKeysAsJsonObject: <T = Record<string, string>>(dotFileAbsPath: string | string[]) => T;
 }
 export declare namespace UtilsZipBrowser {
     const zipDirBrowser: (fileList: FileList) => Promise<Blob>;
@@ -178,6 +182,17 @@ export declare namespace UtilsZip {
      * @returns true if file was split, false if not needed
      */
     const splitFile: (inputPath: string, partSizeMB?: number) => Promise<number>;
-    const zipDir: (absPathToDir: string) => Promise<void>;
+    /**
+     * @returns absolute path to zip file
+     */
+    const zipDir: (absPathToDir: string, options?: {
+        /**
+         * default false
+         */
+        overrideIfZipFileExists?: boolean;
+    }) => Promise<string>;
     const unzipArchive: (absPathToZip: string) => Promise<void>;
+}
+export declare namespace UtilsTaonWorker {
+    const getUniqueForTask: (task: string, location: string | string[]) => string;
 }

package/websql/package.json

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