@e-mc/types 0.8.1 → 0.8.3

package/README.md

@@ -1,5 +1,7 @@
 ### @e-mc/types
 
+https://e-mc.readthedocs.io
+
 ### LICENSE
 
 BSD 3-Clause

package/constant.d.ts

@@ -1,5 +1,5 @@
 export const enum INTERNAL {
-    VERSION = '0.8.1',
+    VERSION = '0.8.3',
     TEMP_DIR = 'tmp', // eslint-disable-line @typescript-eslint/no-shadow
     CJS = '__cjs__'
 }
@@ -7,6 +7,7 @@ export const enum INTERNAL {
 export const enum VAL_MESSAGE {
     SUCCESS = 'Success',
     COMPLETED = 'Completed',
+    CHECKSUM = 'Checksum matched',
     MODIFIED_DIRECTORY = 'Directory was modified',
     COMMIT_TRANSACTION = 'Transactions were committed'
 }
@@ -28,6 +29,7 @@ export const enum VAL_CLOUD {
     EMPTY_BUCKET = 'Bucket emptied',
     CONFIGURE_BUCKET = 'Bucket configured',
     POLICY_BUCKET = 'Bucket policy configured',
+    WEBSITE_BUCKET = 'Bucket website configured',
     ACL_BUCKET = 'Bucket ACL configured'
 }
 
@@ -57,6 +59,7 @@ export const enum ERR_MESSAGE {
     TIMEOUT = 'Timeout was exceeded',
     HANDLED_REJECTION = 'Handled rejection',
     UNSUPPORTED_ACCESS = 'Unsupported access',
+    UNSUPPORTED_MIME = 'Unsupported MIME',
     UNSUPPORTED_READ = 'Not permitted to read file',
     UNSUPPORTED_WRITE = 'Not permitted to write file',
     NOTFOUND_FILE = 'File not found',
@@ -123,8 +126,11 @@ export const enum ERR_CLOUD {
     CONSTRUCTOR = 'Not a Cloud constructor',
     CREATE_BUCKET = 'Unable to create bucket',
     POLICY_BUCKET = 'Unable to update bucket policy',
+    TAGGING_BUCKET = 'Unable to update bucket tagging',
+    WEBSITE_BUCKET = 'Unable to set bucket website',
     DELETE_BUCKET = 'Unable to empty bucket',
     CONFIGURE_BUCKET = 'Unable to configure bucket',
+    CREATE_TAG = 'Unable to create tags',
     EXISTS_BUCKET = 'Bucket does not exist',
     POLICY_INVALID = 'Invalid bucket policy',
     LIST_BUCKET = 'Unable to list bucket',
@@ -135,6 +141,7 @@ export const enum ERR_CLOUD {
     MODULE_NOTFOUND = 'Cloud module not installed',
     CREATE_BUCKET_SUPPORT = 'Create bucket not supported',
     BUCKET_POLICY_SUPPORT = 'Bucket policy not supported',
+    BUCKET_TAGGING_SUPPORT = 'Bucket tagging not supported',
     DELETE_OBJECTS_SUPPORT = 'Delete objects not supported',
     BUCKET_WEBSITE_SUPPORT = 'Set bucket website not supported',
     EXECUTE_QUERY_SUPPORT = 'Execute query not supported',
@@ -153,6 +160,10 @@ export const enum ERR_IMAGE {
     METHOD_ARGS = 'Invalid method arguments'
 }
 
+export const enum ERR_HTTP {
+    HEADERS = 'Unable to process headers'
+}
+
 export const enum DB_TRANSACTION {
     ACTIVE = 1,
     PARTIAL = 2,

package/index.js

@@ -5,7 +5,6 @@ exports.generateUUID = exports.incrementUUID = exports.purgeMemory = exports.err
 const path = require("path");
 const fs = require("fs");
 const crypto = require("crypto");
-const uuid = require("uuid");
 const bytes = require("bytes");
 class AbortError extends Error {
     constructor() {
@@ -15,7 +14,8 @@ class AbortError extends Error {
     }
 }
 const REGEXP_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const REGEXP_FUNCTION = /^(async\s+)?(function(?:\b|\s+)([\w_$]*)\s*\(([^)]*)\)\s*\{([\S\s]*)\})$/;
+const REGEXP_FUNCTION = /^(async\s+)?(function(?:\b|\s+)[\w_$]*\s*\(([^)]*)\)\s*\{([\S\s]*)\})$/;
+const REGEXP_FUNCTION_ARROW = /^(async\s+)?(\s*\(([^)]*)\)\s*=>\s*(?:\{([\S\s]*)\}|(?!\s|{)((?:(?<!return\s+)(?:"[^"\n]*"|'[^'\n]*'|`[^`]*`|[^\n;"'`]))*;)))$/;
 const ASYNC_FUNCTION = Object.getPrototypeOf(async () => { }).constructor;
 let CACHE_COERCED = new WeakSet();
 let LOG_CURRENT = null;
@@ -322,8 +322,8 @@ var IMPORT_MAP;
     IMPORT_MAP["@squared-functions/document/packages/@babel/core"] = "@pi-r/babel";
     IMPORT_MAP["@squared-functions/document/packages/clean-css"] = "@pi-r/clean-css";
     IMPORT_MAP["@squared-functions/document/packages/eslint"] = "@pi-r/eslint";
-    IMPORT_MAP["@squared-functions/document/packages/html-minifier-terser"] = "@pi-r/html-minifier-terser";
     IMPORT_MAP["@squared-functions/document/packages/html-minifier"] = "@pi-r/html-minifier";
+    IMPORT_MAP["@squared-functions/document/packages/html-minifier-terser"] = "@pi-r/html-minifier-terser";
     IMPORT_MAP["@squared-functions/document/packages/html-validate"] = "@pi-r/html-validate";
     IMPORT_MAP["@squared-functions/document/packages/postcss"] = "@pi-r/postcss";
     IMPORT_MAP["@squared-functions/document/packages/posthtml"] = "@pi-r/posthtml";
@@ -805,10 +805,10 @@ function asFunction(value, sync = true) {
         return value;
     }
     let match;
-    if (isString(value) && (match = REGEXP_FUNCTION.exec(value = value.trim()))) {
+    if (isString(value) && (match = REGEXP_FUNCTION.exec(value = value.trim()) || REGEXP_FUNCTION_ARROW.exec(value))) {
         if (!sync || match[1]) {
-            const args = match[4].trim().split(/\s*,\s*/);
-            args.push(match[5]);
+            const args = match[3].trim().split(/\s*,\s*/);
+            args.push(match[4] || (match[5] && (match[5] = 'return ' + match[5])));
             return new ASYNC_FUNCTION(...args);
         }
         try {
@@ -824,7 +824,22 @@ function asFunction(value, sync = true) {
 }
 exports.asFunction = asFunction;
 function getEncoding(value, fallback = 'utf-8') {
-    return typeof value === 'string' && Buffer.isEncoding(value = value.trim().toLowerCase()) ? value : fallback;
+    if (typeof value === 'string') {
+        switch (value = value.trim().toLowerCase()) {
+            case 'utf8':
+            case 'utf-8':
+            case 'utf16le':
+                return value;
+            case 'utf-16le':
+            case 'utf16':
+            case 'utf-16':
+                return 'utf16le';
+        }
+        if (Buffer.isEncoding(value)) {
+            return value;
+        }
+    }
+    return fallback;
 }
 exports.getEncoding = getEncoding;
 function encryptUTF8(algorithm, key, iv, data, encoding = 'hex') {
@@ -917,4 +932,4 @@ function incrementUUID(restart) {
     return INCREMENT_PREFIX + (INCREMENT_COUNT++).toString(16).padStart(4, '0');
 }
 exports.incrementUUID = incrementUUID;
-exports.generateUUID = typeof crypto.randomUUID === 'function' ? crypto.randomUUID.bind(crypto) : uuid.v4;
+exports.generateUUID = typeof crypto.randomUUID === 'function' ? crypto.randomUUID.bind(crypto) : require('uuid').v4;

package/lib/filemanager.d.ts

@@ -19,6 +19,13 @@ export const enum FINALIZE_STATE {
     ABORTED = 6
 }
 
+export const enum INCREMENTAL {
+    NONE = 'none',
+    STAGING = 'staging',
+    ETAG = 'etag',
+    EXISTS = 'exists'
+}
+
 export interface RequestData<T extends ExternalAsset = ExternalAsset> extends IRequestData<T>, RequestInit {
     timeout?: ObjectMap<NumString>;
 }

package/lib/http.d.ts

@@ -45,6 +45,7 @@ export const enum HTTP_STATUS {
     UNPROCESSABLE_ENTITY = 422,
     LOCKED = 423,
     FAILED_DEPENDENCY = 424,
+    TOO_EARLY = 425,
     UPGRADE_REQUIRED = 426,
     PRECONDITION_REQUIRED = 428,
     TOO_MANY_REQUESTS = 429,
@@ -62,6 +63,7 @@ export const enum HTTP_STATUS {
     VARIANT_ALSO_NEGOTIATES = 506,
     INSUFFICIENT_STORAGE = 507,
     LOOP_DETECTED = 508,
+    BANDWIDTH_LIMIT_EXCEEDED = 509,
     NOT_EXTENDED = 510,
     NETWORK_AUTHENTICATION_REQUIRED = 511,
     WEB_SERVER_IS_DOWN = 521,

package/lib/index.d.ts

@@ -17,7 +17,7 @@ import type { CommandData, CropData, QualityData, ResizeData, RotateData, Transf
 import type { ExecCommand, LOG_TYPE, LogArguments, LogComponent, LogDate, LogFailOptions, LogMessageOptions, LogOptions, LogProcessOptions, LogTime, LogType, LogValue, STATUS_TYPE, StatusType } from './logger';
 import type { AsHashOptions, CheckSemVerOptions, CopyDirOptions, CopyDirResult, CopyFileOptions, CreateDirOptions, DeleteFileOptions, GetTempDirOptions, MoveFileOptions, NormalizeFlags, ParseFunctionOptions, PermissionOptions, ProtocolType, ReadBufferOptions, ReadFileCallback, ReadFileOptions, ReadHashOptions, ReadTextOptions, RemoveDirOptions, WriteFileOptions } from './module';
 import type { RequestData, Settings } from './node';
-import type { ApplyOptions, Aria2Options, BufferFormat, DataEncodedResult, DataObjectResult, FormDataPart, HeadersOnCallback, HostConfig, OpenOptions, PostOptions, ProxySettings, ReadExpectType, RequestInit } from './request';
+import type { ApplyOptions, Aria2Options, BufferFormat, DataEncodedResult, DataObjectResult, FormDataPart, HeadersOnCallback, HostConfig, OpenOptions, PostOptions, ProxySettings, ReadExpectType, RequestInit, StatusOnCallback } from './request';
 import type { ClientModule, CloudModule, CloudServiceOptions, CompressModule, CompressSettings, DbCoerceSettings, DbModule, DbSourceOptions, DnsLookupSettings, DocumentComponent, DocumentComponentOption, DocumentModule, HttpConnectSettings, HttpMemorySettings, ImageModule, RequestModule, RequestSettings, TaskModule, WatchModule } from './settings';
 import type { Command, SpawnResult } from './task';
 import type { IFileGroup, ModifiedPostFinalizeListener, SecureOptions, WatchInitResult } from './watch';
@@ -109,6 +109,7 @@ declare namespace functions {
         clamp(value: unknown, min?: number, max?: number): number;
         isBinary(mime: unknown): mime is string;
         toABGR(buffer: Uint8Array | Buffer): Buffer;
+        /* @deprecated IImage.using (v0.9) */
         using?<V extends ExternalAsset>(this: T, instance: IImage<T, U>, data: IFileThread<V>, command: string): Promise<unknown>;
         readonly prototype: IImage<T, U>;
         new(module?: U): IImage<T, U>;
@@ -126,6 +127,7 @@ declare namespace functions {
 
     interface TaskConstructor<T extends IHost = IHost, U extends TaskModule = TaskModule> extends ModuleConstructor {
         finalize<V extends ExternalAsset>(this: T, instance: ITask<T, U>, assets: V[]): Promise<unknown>;
+        /* @deprecated ITask.using (v0.9) */
         using?<V extends ExternalAsset>(this: T, instance: ITask<T, U>, assets: V[], preceding?: boolean): Promise<unknown>;
         readonly prototype: ITask<T, U>;
         new(module?: U, ...args: unknown[]): ITask<T, U>;
@@ -254,6 +256,7 @@ declare namespace functions {
         writeSourceMap(uri: string, data: SourceCode, options?: SourceMapOptions): Undef<string>;
         updateGradle(source: string, namespaces: string[], value: string, options?: UpdateGradleOptions | boolean): string;
         generateLintTable(messages: LintMessage[], options: GenerateLintTableOptions): LogComponent[];
+        /* @deprecated IDocument.using (v0.9) */
         using?(this: T, instance: IDocument<T, U, V, W, X, Y>, file: U): Promise<unknown>;
         cleanup?(this: T, instance: IDocument<T, U, V, W, X, Y>): Promise<unknown>;
         sanitizeAssets?(assets: U[], exclusions?: U[]): U[];
@@ -302,9 +305,12 @@ declare namespace functions {
         proxy: Null<ProxySettings>;
         init(config?: RequestInit): this;
         apply(options: ApplyOptions): this;
-        addDns(hostname: string, address: string, family?: NumString): void;
+        addDns(hostname: string, address: string, timeout: number): void;
+        addDns(hostname: string, address: string, family?: NumString, timeout?: number): void;
         lookupDns(hostname: string): LookupFunction;
         proxyOf(uri: string, localhost?: boolean): Undef<ProxySettings>;
+        statusOn(name: ArrayOf<number>, callback: StatusOnCallback): void;
+        statusOn(name: ArrayOf<number>, patternUrl: string, callback: StatusOnCallback): void;
         headersOn(name: ArrayOf<string>, callback: HeadersOnCallback): void;
         headersOn(name: ArrayOf<string>, patternUrl: string, callback: HeadersOnCallback): void;
         headersOf(uri: string): Undef<OutgoingHttpHeaders>;

package/lib/logger.d.ts

@@ -40,6 +40,7 @@ export interface LoggerFormat<T = NumString> {
     bold?: boolean;
     justify?: TextAlign;
     unit?: string;
+    as?: StringMap;
 }
 
 export interface LoggerStatus<T = boolean> {
@@ -93,10 +94,9 @@ export interface LogTypeValue {
     sessionId?: string;
 }
 
-export interface LogArguments {
-    type?: LogType;
-    value?: LogValue;
+export interface LogArguments extends Pick<LogBaseOptions, "type" | "sessionId"> {
     title?: string;
+    value?: LogValue;
     message?: unknown;
 }
 

package/lib/request.d.ts

@@ -128,4 +128,5 @@ export type BufferFormat = "json" | "yaml" | "json5" | "xml" | "toml";
 export type ReadExpectType = "always" | "string" | "none";
 export type DataEncodedResult<T extends { encoding?: BufferEncoding }> = T extends { encoding: BufferEncoding } ? string : Null<BufferContent>;
 export type DataObjectResult<T extends { format?: unknown; encoding?: BufferEncoding }> = T extends { format: string | PlainObject } ? Null<object> : DataEncodedResult<T>;
-export type HeadersOnCallback = (value: IncomingHttpHeaders, url?: URL) => Void<boolean>;
+export type StatusOnCallback = (code: number, headers: IncomingHttpHeaders, url?: URL) => Void<boolean>;
+export type HeadersOnCallback = (headers: IncomingHttpHeaders, url?: URL) => Void<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e-mc/types",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Type definitions for E-mc.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -9,7 +9,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/anpham6/e-mc.git",
+    "url": "git+https://github.com/anpham6/e-mc.git",
     "directory": "src/types"
   },
   "keywords": [