tnp-core 16.0.15 → 16.0.17

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

@@ -40,4 +40,173 @@ export interface RunOptions extends ExecuteOptions {
     stdio?: any;
     cwd?: string;
 }
-export type PROGRESS_DATA_TYPE = 'info' | 'error' | 'warning' | 'event';
+export type PROGRESS_DATA_TYPE = 'info' | 'error' | 'warning' | 'event';
+export declare const mimeTypes: {
+    readonly ".aac": "audio/aac";
+    readonly ".abw": "application/x-abiword";
+    readonly ".arc": "application/x-freearc";
+    readonly ".avi": "video/x-msvideo";
+    readonly ".azw": "application/vnd.amazon.ebook";
+    readonly ".bin": "application/octet-stream";
+    readonly ".bmp": "image/bmp";
+    readonly ".bz": "application/x-bzip";
+    readonly ".bz2": "application/x-bzip2";
+    readonly ".csh": "application/x-csh";
+    readonly ".css": "text/css";
+    readonly ".csv": "text/csv";
+    readonly ".doc": "application/msword";
+    readonly ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    readonly ".eot": "application/vnd.ms-fontobject";
+    readonly ".epub": "application/epub+zip";
+    readonly ".gz": "application/gzip";
+    readonly ".gif": "image/gif";
+    readonly ".htm": "text/html";
+    readonly ".html": "text/html";
+    readonly ".ico": "image/vnd.microsoft.icon";
+    readonly ".ics": "text/calendar";
+    readonly ".jar": "application/java-archive";
+    readonly ".jpeg": "image/jpeg";
+    readonly ".jpg": "image/jpeg";
+    readonly ".js": "text/javascript";
+    readonly ".json": "application/json";
+    readonly ".jsonld": "application/ld+json";
+    readonly ".mid": "application/midi";
+    readonly ".midi": "application/midi";
+    readonly ".mjs": "text/javascript";
+    readonly ".mp3": "audio/mpeg";
+    readonly ".mp4": "video/mp4";
+    readonly ".mpeg": "video/mpeg";
+    readonly ".mpkg": "application/vnd.apple.installer+xml";
+    readonly ".odp": "application/vnd.oasis.opendocument.presentation";
+    readonly ".ods": "application/vnd.oasis.opendocument.spreadsheet";
+    readonly ".odt": "application/vnd.oasis.opendocument.text";
+    readonly ".oga": "audio/ogg";
+    readonly ".ogg": "audio/ogg";
+    readonly ".ogv": "video/ogg";
+    readonly ".ogx": "application/ogg";
+    readonly ".opus": "audio/opus";
+    readonly ".otf": "font/otf";
+    readonly ".png": "image/png";
+    readonly ".pdf": "application/pdf";
+    readonly ".php": "application/php";
+    readonly ".ppt": "application/vnd.ms-powerpoint";
+    readonly ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+    readonly ".rar": "application/vnd.rar";
+    readonly ".rtf": "application/rtf";
+    readonly ".sh": "application/x-sh";
+    readonly ".svg": "image/svg+xml";
+    readonly ".swf": "application/x-shockwave-flash";
+    readonly ".tar": "application/x-tar";
+    readonly ".tif": "image/tiff";
+    readonly ".tiff": "image/tiff";
+    readonly ".ts": "video/mp2t";
+    readonly ".ttf": "font/ttf";
+    readonly ".txt": "text/plain";
+    readonly ".vsd": "application/vnd.visio";
+    readonly ".wav": "audio/wav";
+    readonly ".weba": "audio/webm";
+    readonly ".webm": "video/webm";
+    readonly ".webp": "image/webp";
+    readonly ".woff": "font/woff";
+    readonly ".woff2": "font/woff2";
+    readonly ".xhtml": "application/xhtml+xml";
+    readonly ".xls": "application/vnd.ms-excel";
+    readonly ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    readonly ".xml": "application/xml";
+    readonly ".xul": "application/vnd.mozilla.xul+xml";
+    readonly ".zip": "application/zip";
+    readonly ".3gp": "video/3gpp";
+    readonly ".3g2": "video/3gpp2";
+    readonly ".7z": "application/x-7z-compressed";
+};
+export type ContentTypeKeys = keyof typeof mimeTypes;
+export type ContentType = typeof mimeTypes[ContentTypeKeys] | 'multipart/form-data';
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types
+ */
+export type MediaType = 'text' | 'image' | 'audio' | 'font' | 'video' | 'application' | 'multipart' | 'message' | 'model';
+export declare const MediaTypeAllArr: MediaType[];
+type ContentType_ = ContentType;
+export declare namespace Files {
+    type MimeType = keyof typeof mimeTypes;
+    const MimeTypesObj: {
+        readonly ".aac": "audio/aac";
+        readonly ".abw": "application/x-abiword";
+        readonly ".arc": "application/x-freearc";
+        readonly ".avi": "video/x-msvideo";
+        readonly ".azw": "application/vnd.amazon.ebook";
+        readonly ".bin": "application/octet-stream";
+        readonly ".bmp": "image/bmp";
+        readonly ".bz": "application/x-bzip";
+        readonly ".bz2": "application/x-bzip2";
+        readonly ".csh": "application/x-csh";
+        readonly ".css": "text/css";
+        readonly ".csv": "text/csv";
+        readonly ".doc": "application/msword";
+        readonly ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+        readonly ".eot": "application/vnd.ms-fontobject";
+        readonly ".epub": "application/epub+zip";
+        readonly ".gz": "application/gzip";
+        readonly ".gif": "image/gif";
+        readonly ".htm": "text/html";
+        readonly ".html": "text/html";
+        readonly ".ico": "image/vnd.microsoft.icon";
+        readonly ".ics": "text/calendar";
+        readonly ".jar": "application/java-archive";
+        readonly ".jpeg": "image/jpeg";
+        readonly ".jpg": "image/jpeg";
+        readonly ".js": "text/javascript";
+        readonly ".json": "application/json";
+        readonly ".jsonld": "application/ld+json";
+        readonly ".mid": "application/midi";
+        readonly ".midi": "application/midi";
+        readonly ".mjs": "text/javascript";
+        readonly ".mp3": "audio/mpeg";
+        readonly ".mp4": "video/mp4";
+        readonly ".mpeg": "video/mpeg";
+        readonly ".mpkg": "application/vnd.apple.installer+xml";
+        readonly ".odp": "application/vnd.oasis.opendocument.presentation";
+        readonly ".ods": "application/vnd.oasis.opendocument.spreadsheet";
+        readonly ".odt": "application/vnd.oasis.opendocument.text";
+        readonly ".oga": "audio/ogg";
+        readonly ".ogg": "audio/ogg";
+        readonly ".ogv": "video/ogg";
+        readonly ".ogx": "application/ogg";
+        readonly ".opus": "audio/opus";
+        readonly ".otf": "font/otf";
+        readonly ".png": "image/png";
+        readonly ".pdf": "application/pdf";
+        readonly ".php": "application/php";
+        readonly ".ppt": "application/vnd.ms-powerpoint";
+        readonly ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+        readonly ".rar": "application/vnd.rar";
+        readonly ".rtf": "application/rtf";
+        readonly ".sh": "application/x-sh";
+        readonly ".svg": "image/svg+xml";
+        readonly ".swf": "application/x-shockwave-flash";
+        readonly ".tar": "application/x-tar";
+        readonly ".tif": "image/tiff";
+        readonly ".tiff": "image/tiff";
+        readonly ".ts": "video/mp2t";
+        readonly ".ttf": "font/ttf";
+        readonly ".txt": "text/plain";
+        readonly ".vsd": "application/vnd.visio";
+        readonly ".wav": "audio/wav";
+        readonly ".weba": "audio/webm";
+        readonly ".webm": "video/webm";
+        readonly ".webp": "image/webp";
+        readonly ".woff": "font/woff";
+        readonly ".woff2": "font/woff2";
+        readonly ".xhtml": "application/xhtml+xml";
+        readonly ".xls": "application/vnd.ms-excel";
+        readonly ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+        readonly ".xml": "application/xml";
+        readonly ".xul": "application/vnd.mozilla.xul+xml";
+        readonly ".zip": "application/zip";
+        readonly ".3gp": "video/3gpp";
+        readonly ".3g2": "video/3gpp2";
+        readonly ".7z": "application/x-7z-compressed";
+    };
+    type ContentType = ContentType_;
+}
+export {};

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

@@ -2,6 +2,7 @@
 import { HelpersIsomorphic } from './helpers-isomorphic';
 export declare class HelpersMessages extends HelpersIsomorphic {
     msgCacheClear(): void;
+    renderError(err: Error): void;
     error(details: any, noExit?: boolean, noTrace?: boolean): void;
     info(details: string, repeatable?: boolean): void;
     success(details: any | string): void;

package/websql/lib/helpers.d.ts

@@ -1,6 +1,6 @@
 // @ts-nocheck
 import { HelpersMessages } from './helpers-messages';
-import { RunOptions } from './core-models';
+import { MediaType, RunOptions } from './core-models';
 export interface RunSyncOrAsyncOptions {
     functionFn: Function;
     context?: object;
@@ -18,11 +18,27 @@ export declare class HelpersCore extends HelpersMessages {
     static get InstanceCore(): HelpersCore;
     readonly bigMaxBuffer: number;
     constructor();
-    isBlob(maybeBlob: any): boolean;
+    mediaTypeFromSrc(src: string): MediaType;
+    /**
+     * check if data is nodejs/browser blob
+     *
+     * @param maybeBlob
+     * @returns
+     */
+    isBlob(maybeBlob: any): maybeBlob is Blob;
+    /**
+     * Check if data is nodejs buffer
+     *
+     * @param maybeNodejsBuffer
+     * @returns
+     */
     removeSlashAtEnd(s: string): string;
     removeSlashAtBegin(s: string): string;
+    /**
+     * stringify to pretty json string
+     */
     stringify(inputObject: any): string;
-    runSyncOrAsync(fnOrOptions: Function | [string, object] | RunSyncOrAsyncOptions, ...firstArg: any[]): Promise<any>;
+    runSyncOrAsync<FUNCTION_RETURN_TYPE = any>(fnOrOptions: Function | [string, object] | RunSyncOrAsyncOptions, ...firstArg: any[]): Promise<FUNCTION_RETURN_TYPE>;
     /**
      * symlink may have existed or unexisted destiantion url
      * @param destUrl M
@@ -38,15 +54,19 @@ export declare class HelpersCore extends HelpersMessages {
      */
     isExistedSymlink(filePath: string): boolean;
     exists(folderOrFilePath: string | string[]): any;
+    /**
+     * this is HACK for running procesess inside processes
+     */
     _fixCommand(command: string): string;
     command(command: string): {};
-    wait(second: number): Promise<unknown>;
+    wait(second: number): Promise<void>;
     killProcess(byPid: number): void;
     run(command: string, options?: RunOptions): {
         async(detach?: boolean, mockFun?: (stdoutCallback: (dataForStdout: any) => any, stdErrcCallback: (dataForStder: any) => any, shouldProcesBeDead?: () => boolean) => Promise<number> | number): any;
     };
     /**
      * Quick fix for object values
+     * @deprecated
      */
     values(obj: any): any[];
 }

package/websql/lib/index.d.ts

@@ -5,5 +5,6 @@ export * from './core-models';
 import { HelpersCore as Base } from './helpers';
 export * from './core-config';
 export * from './progress-data';
+export * from './utils';
 export { HelpersCore as CoreHelpers, CommandOutputOptions } from './helpers';
 export declare let Helpers: Base;

package/websql/lib/utils.d.ts

@@ -0,0 +1,70 @@
+// @ts-nocheck
+import { ContentType } from "./core-models";
+export declare namespace Utils {
+    enum DbBinaryFormatEnum {
+        Blob = "Blob",
+        File = "File",
+        string = "string"
+    }
+    type DbBinaryFormatForBrowser = Blob | File | string;
+    /**
+     * Binary format that can be stored in database
+     *
+     * for nodejs => Buffer
+     * for sql.js => string (shoulb be blob - but not supported)
+     *
+     */
+    type DbBinaryFormat = DbBinaryFormatForBrowser;
+    namespace binary {
+        /**
+         * This is for BROWSER ONLY
+         *
+         * @param buffer
+         * @param contentType
+         * @returns
+         */
+        function arrayBufferToBlob(buffer: ArrayBuffer, contentType: ContentType): Promise<Blob>;
+        /**
+         * This is for BROWSER ONLY
+         * @param blob
+         * @returns
+         */
+        function blobToArrayBuffer(blob: Blob): Promise<ArrayBuffer>;
+        /**
+         * it is revers to base64toBlob
+         * @param blob
+         * @returns
+         */
+        function blobToBase64(blob: Blob): Promise<string>;
+        /**
+         * it is revers to blobToBase64()
+         * @param base64Data
+         * @returns
+         */
+        function base64toBlob(base64Data: string, contentTypeOverride?: ContentType): Promise<Blob>;
+        function base64toDbBinaryFormat(text: string): Promise<DbBinaryFormat>;
+        function dbBinaryFormatToBase64(binaryFormat: DbBinaryFormat): Promise<string>;
+        function textToDbBinaryFormat(text: string): Promise<DbBinaryFormat>;
+        function dbBinaryFormatToText(binaryFormat: DbBinaryFormat): Promise<string>;
+        function fileToBlob(file: File): Promise<Blob>;
+        function blobToFile(blob: Blob, nameForFile?: string): Promise<File>;
+        function textToBlob(text: string, type?: ContentType): Promise<Blob>;
+        function blobToText(blob: Blob): Promise<string>;
+        function textToFile(text: string, fileRelativePathOrName: string): Promise<File>;
+        function fileToText(file: File): Promise<string>;
+        function jsonToBlob(jsonObj: object): Promise<Blob>;
+        /**
+         * TODO NOT TESTED
+         */
+        function blobToJson(blob: Blob): Promise<string>;
+        function getBlobFrom(url: string): Promise<Blob>;
+    }
+    namespace css {
+        /**
+         *
+         * @param pixelsCss pixels ex. 100px
+         * @returns
+         */
+        function numValue(pixelsCss: string): number;
+    }
+}