@aitianyu.cn/types 0.0.12 → 0.1.0

package/dist/lib/index.js

@@ -1,54 +1,70 @@
-"use strict";
-/**@format */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hash = exports.guid = exports.StringHelper = exports.ArrayHelper = exports.ObjectHelper = exports.ObjectCalculater = exports.getBoolean = exports.Performance = exports.Log = exports.parseAreaString = exports.parseAreaCode = exports.ObjectDiffMergeFailedException = exports.ObjectDiffApplyInvalidStatusException = exports.ObjectMergeStatusCheckFailedException = exports.ObjectCloneFunctionNotSupportException = exports.ArgumentNullOrEmptyException = exports.Path = exports.PathDirAndFileConvertInvaild = exports.PathDirectoryValidationFailException = exports.PathProcessorSourceLostException = exports.TMap = exports.EncryptOption = exports.PathBase = exports.LogLevel = exports.Exception = exports.AreaCode = void 0;
-// src/types
-var AreaCode_1 = require("./types/AreaCode");
-Object.defineProperty(exports, "AreaCode", { enumerable: true, get: function () { return AreaCode_1.AreaCode; } });
-var Exception_1 = require("./types/Exception");
-Object.defineProperty(exports, "Exception", { enumerable: true, get: function () { return Exception_1.Exception; } });
-var Logs_1 = require("./types/Logs");
-Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return Logs_1.LogLevel; } });
-var PathBase_1 = require("./types/PathBase");
-Object.defineProperty(exports, "PathBase", { enumerable: true, get: function () { return PathBase_1.PathBase; } });
-var Security_1 = require("./types/Security");
-Object.defineProperty(exports, "EncryptOption", { enumerable: true, get: function () { return Security_1.EncryptOption; } });
-var TMap_1 = require("./types/TMap");
-Object.defineProperty(exports, "TMap", { enumerable: true, get: function () { return TMap_1.TMap; } });
-// utilities
-// coding
-var Error_1 = require("./utilities/coding/Error");
-Object.defineProperty(exports, "PathProcessorSourceLostException", { enumerable: true, get: function () { return Error_1.PathProcessorSourceLostException; } });
-Object.defineProperty(exports, "PathDirectoryValidationFailException", { enumerable: true, get: function () { return Error_1.PathDirectoryValidationFailException; } });
-Object.defineProperty(exports, "PathDirAndFileConvertInvaild", { enumerable: true, get: function () { return Error_1.PathDirAndFileConvertInvaild; } });
-var Path_1 = require("./utilities/coding/Path");
-Object.defineProperty(exports, "Path", { enumerable: true, get: function () { return Path_1.Path; } });
-// core
-var Errors_1 = require("./utilities/core/Errors");
-Object.defineProperty(exports, "ArgumentNullOrEmptyException", { enumerable: true, get: function () { return Errors_1.ArgumentNullOrEmptyException; } });
-Object.defineProperty(exports, "ObjectCloneFunctionNotSupportException", { enumerable: true, get: function () { return Errors_1.ObjectCloneFunctionNotSupportException; } });
-Object.defineProperty(exports, "ObjectMergeStatusCheckFailedException", { enumerable: true, get: function () { return Errors_1.ObjectMergeStatusCheckFailedException; } });
-Object.defineProperty(exports, "ObjectDiffApplyInvalidStatusException", { enumerable: true, get: function () { return Errors_1.ObjectDiffApplyInvalidStatusException; } });
-Object.defineProperty(exports, "ObjectDiffMergeFailedException", { enumerable: true, get: function () { return Errors_1.ObjectDiffMergeFailedException; } });
-var Language_1 = require("./utilities/core/Language");
-Object.defineProperty(exports, "parseAreaCode", { enumerable: true, get: function () { return Language_1.parseAreaCode; } });
-Object.defineProperty(exports, "parseAreaString", { enumerable: true, get: function () { return Language_1.parseAreaString; } });
-var Log_1 = require("./utilities/core/Log");
-Object.defineProperty(exports, "Log", { enumerable: true, get: function () { return Log_1.Log; } });
-Object.defineProperty(exports, "Performance", { enumerable: true, get: function () { return Log_1.Performance; } });
-var TypeConvertion_1 = require("./utilities/core/TypeConvertion");
-Object.defineProperty(exports, "getBoolean", { enumerable: true, get: function () { return TypeConvertion_1.getBoolean; } });
-//// object
-var Calculater_1 = require("./utilities/core/object/Calculater");
-Object.defineProperty(exports, "ObjectCalculater", { enumerable: true, get: function () { return Calculater_1.ObjectCalculater; } });
-var Helper_1 = require("./utilities/core/object/Helper");
-Object.defineProperty(exports, "ObjectHelper", { enumerable: true, get: function () { return Helper_1.ObjectHelper; } });
-var ArrayHelper_1 = require("./utilities/core/object/ArrayHelper");
-Object.defineProperty(exports, "ArrayHelper", { enumerable: true, get: function () { return ArrayHelper_1.ArrayHelper; } });
-var StringHelper_1 = require("./utilities/core/object/StringHelper");
-Object.defineProperty(exports, "StringHelper", { enumerable: true, get: function () { return StringHelper_1.StringHelper; } });
-// security
-var Guid_1 = require("./utilities/security/Guid");
-Object.defineProperty(exports, "guid", { enumerable: true, get: function () { return Guid_1.guid; } });
-var Hash_1 = require("./utilities/security/Hash");
-Object.defineProperty(exports, "hash", { enumerable: true, get: function () { return Hash_1.hash; } });
+"use strict";
+/**@format */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHA = exports.RSA = exports.QRCode = exports.hash = exports.guid = exports.Base32 = exports.Json = exports.Integer = exports.DataView = exports.Bytes = exports.StringHelper = exports.ArrayHelper = exports.ObjectHelper = exports.ObjectCalculater = exports.getBoolean = exports.Performance = exports.Log = exports.parseAreaString = exports.parseAreaCode = exports.ObjectDiffMergeFailedException = exports.ObjectDiffApplyInvalidStatusException = exports.ObjectMergeStatusCheckFailedException = exports.ObjectCloneFunctionNotSupportException = exports.ArgumentNullOrEmptyException = exports.Path = exports.PathDirAndFileConvertInvaild = exports.PathDirectoryValidationFailException = exports.PathProcessorSourceLostException = exports.TMap = exports.EncryptOption = exports.PathBase = exports.LogLevel = exports.Exception = exports.AreaCode = void 0;
+// src/types
+var AreaCode_1 = require("./types/AreaCode");
+Object.defineProperty(exports, "AreaCode", { enumerable: true, get: function () { return AreaCode_1.AreaCode; } });
+var Exception_1 = require("./types/Exception");
+Object.defineProperty(exports, "Exception", { enumerable: true, get: function () { return Exception_1.Exception; } });
+var Logs_1 = require("./types/Logs");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return Logs_1.LogLevel; } });
+var PathBase_1 = require("./types/PathBase");
+Object.defineProperty(exports, "PathBase", { enumerable: true, get: function () { return PathBase_1.PathBase; } });
+var Security_1 = require("./types/Security");
+Object.defineProperty(exports, "EncryptOption", { enumerable: true, get: function () { return Security_1.EncryptOption; } });
+var TMap_1 = require("./types/TMap");
+Object.defineProperty(exports, "TMap", { enumerable: true, get: function () { return TMap_1.TMap; } });
+// utilities
+// coding
+var Error_1 = require("./coding/Error");
+Object.defineProperty(exports, "PathProcessorSourceLostException", { enumerable: true, get: function () { return Error_1.PathProcessorSourceLostException; } });
+Object.defineProperty(exports, "PathDirectoryValidationFailException", { enumerable: true, get: function () { return Error_1.PathDirectoryValidationFailException; } });
+Object.defineProperty(exports, "PathDirAndFileConvertInvaild", { enumerable: true, get: function () { return Error_1.PathDirAndFileConvertInvaild; } });
+var Path_1 = require("./coding/Path");
+Object.defineProperty(exports, "Path", { enumerable: true, get: function () { return Path_1.Path; } });
+// core
+var Errors_1 = require("./core/Errors");
+Object.defineProperty(exports, "ArgumentNullOrEmptyException", { enumerable: true, get: function () { return Errors_1.ArgumentNullOrEmptyException; } });
+Object.defineProperty(exports, "ObjectCloneFunctionNotSupportException", { enumerable: true, get: function () { return Errors_1.ObjectCloneFunctionNotSupportException; } });
+Object.defineProperty(exports, "ObjectMergeStatusCheckFailedException", { enumerable: true, get: function () { return Errors_1.ObjectMergeStatusCheckFailedException; } });
+Object.defineProperty(exports, "ObjectDiffApplyInvalidStatusException", { enumerable: true, get: function () { return Errors_1.ObjectDiffApplyInvalidStatusException; } });
+Object.defineProperty(exports, "ObjectDiffMergeFailedException", { enumerable: true, get: function () { return Errors_1.ObjectDiffMergeFailedException; } });
+var Language_1 = require("./core/Language");
+Object.defineProperty(exports, "parseAreaCode", { enumerable: true, get: function () { return Language_1.parseAreaCode; } });
+Object.defineProperty(exports, "parseAreaString", { enumerable: true, get: function () { return Language_1.parseAreaString; } });
+var Log_1 = require("./core/Log");
+Object.defineProperty(exports, "Log", { enumerable: true, get: function () { return Log_1.Log; } });
+Object.defineProperty(exports, "Performance", { enumerable: true, get: function () { return Log_1.Performance; } });
+var TypeConvertion_1 = require("./core/TypeConvertion");
+Object.defineProperty(exports, "getBoolean", { enumerable: true, get: function () { return TypeConvertion_1.getBoolean; } });
+//// object
+var Calculater_1 = require("./core/object/Calculater");
+Object.defineProperty(exports, "ObjectCalculater", { enumerable: true, get: function () { return Calculater_1.ObjectCalculater; } });
+var ObjectHelper_1 = require("./core/object/ObjectHelper");
+Object.defineProperty(exports, "ObjectHelper", { enumerable: true, get: function () { return ObjectHelper_1.ObjectHelper; } });
+var ArrayHelper_1 = require("./core/object/ArrayHelper");
+Object.defineProperty(exports, "ArrayHelper", { enumerable: true, get: function () { return ArrayHelper_1.ArrayHelper; } });
+var StringHelper_1 = require("./core/object/StringHelper");
+Object.defineProperty(exports, "StringHelper", { enumerable: true, get: function () { return StringHelper_1.StringHelper; } });
+var Bytes_1 = require("./core/object/Bytes");
+Object.defineProperty(exports, "Bytes", { enumerable: true, get: function () { return Bytes_1.Bytes; } });
+var DataView_1 = require("./core/object/DataView");
+Object.defineProperty(exports, "DataView", { enumerable: true, get: function () { return DataView_1.DataView; } });
+var Integer_1 = require("./core/object/Integer");
+Object.defineProperty(exports, "Integer", { enumerable: true, get: function () { return Integer_1.Integer; } });
+var Json_1 = require("./core/object/Json");
+Object.defineProperty(exports, "Json", { enumerable: true, get: function () { return Json_1.Json; } });
+// security
+var Base32_1 = require("./security/Base32");
+Object.defineProperty(exports, "Base32", { enumerable: true, get: function () { return Base32_1.Base32; } });
+var Guid_1 = require("./security/Guid");
+Object.defineProperty(exports, "guid", { enumerable: true, get: function () { return Guid_1.guid; } });
+var Hash_1 = require("./security/Hash");
+Object.defineProperty(exports, "hash", { enumerable: true, get: function () { return Hash_1.hash; } });
+var QRCode_1 = require("./security/QRCode");
+Object.defineProperty(exports, "QRCode", { enumerable: true, get: function () { return QRCode_1.QRCode; } });
+var RSA_1 = require("./security/RSA");
+Object.defineProperty(exports, "RSA", { enumerable: true, get: function () { return RSA_1.RSA; } });
+var SHA_1 = require("./security/SHA");
+Object.defineProperty(exports, "SHA", { enumerable: true, get: function () { return SHA_1.SHA; } });

package/dist/lib/security/Base32.js

@@ -0,0 +1,104 @@
+"use strict";
+/** @format */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Base32 = void 0;
+const Bytes_1 = require("../core/object/Bytes");
+const DataView_1 = require("../core/object/DataView");
+const Integer_1 = require("../core/object/Integer");
+const StringHelper_1 = require("../core/object/StringHelper");
+/** Base32 Encoding Lib */
+class Base32 {
+    static RFC4648_CHS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+    static RFC4648_HEX_CHS = "0123456789ABCDEFGHIJKLMNOPQRSTUV";
+    static CROCKFORD_CHS = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+    /**
+     * To encode the buffer to be a Base32 encoded string
+     *
+     * @param data input source buffer
+     * @param encoding encoding type
+     * @returns return the encoded string
+     */
+    static encode(data, encoding) {
+        const alphabet = Base32.getAlphabet(encoding);
+        const view = DataView_1.DataView.parse(data);
+        let bits = 0;
+        let value = 0;
+        let output = "";
+        for (let i = 0; i < view.byteLength; i++) {
+            value = Integer_1.Integer.or(Integer_1.Integer.left(value, 8), view.getUint8(i));
+            bits += 8;
+            while (bits >= 5) {
+                const index = Integer_1.Integer.and(Integer_1.Integer.rightUnsigned(value, bits - 5), 31);
+                const char = alphabet[index];
+                if (char === undefined) {
+                    throw new Error(StringHelper_1.StringHelper.format('Invalid index: {0} in alphabet "{1}"', [index, alphabet]));
+                }
+                output += char;
+                bits -= 5;
+            }
+        }
+        if (bits > 0) {
+            output += alphabet[Integer_1.Integer.and(Integer_1.Integer.left(value, 5 - bits), 31)];
+        }
+        if (encoding !== "Crockford") {
+            while (output.length % 8 !== 0) {
+                output += "=";
+            }
+        }
+        return output;
+    }
+    /**
+     * Decode the input string to be an array buffer
+     *
+     * @param input source string
+     * @param encoding encoding type
+     * @returns return the target array buffer
+     */
+    static decode(input, encoding) {
+        const alphabet = Base32.getAlphabet(encoding);
+        const data = encoding !== "Crockford" ? input.replace(/=+$/, "") : input.toUpperCase().replace(/O/g, "0").replace(/[IL]/g, "1");
+        const length = data.length;
+        let bits = 0;
+        let value = 0;
+        let index = 0;
+        const output = new Uint8Array(Integer_1.Integer.or((length * 5) / 8, 0));
+        for (let i = 0; i < length; i++) {
+            value = Integer_1.Integer.or(Integer_1.Integer.left(value, 5), Base32.readChar(alphabet, data[i]));
+            bits += 5;
+            if (bits >= 8) {
+                output[index++] = Integer_1.Integer.and(Integer_1.Integer.rightUnsigned(value, bits - 8), 255);
+                bits -= 8;
+            }
+        }
+        return output.buffer;
+    }
+    /**
+     * Get a random string which is encoded by given encoding type
+     *
+     * @param size random bytes size
+     * @param encoding encoding type
+     * @returns return encoded random string
+     */
+    static random(size, encoding = "RFC4648") {
+        const bytes = Bytes_1.Bytes.random(size);
+        return Base32.encode(bytes, encoding);
+    }
+    static getAlphabet(encoding) {
+        const alphabet = encoding === "RFC4648" || encoding === "RFC3548"
+            ? Base32.RFC4648_CHS
+            : encoding === "RFC4648-HEX"
+                ? Base32.RFC4648_HEX_CHS
+                : encoding === "Crockford"
+                    ? Base32.CROCKFORD_CHS
+                    : "";
+        return alphabet;
+    }
+    static readChar(alphabet, char) {
+        const idx = alphabet.indexOf(char);
+        if (idx === -1) {
+            throw new Error(StringHelper_1.StringHelper.format("Invalid character found: {0}", char));
+        }
+        return idx;
+    }
+}
+exports.Base32 = Base32;

package/dist/lib/security/Guid.js

@@ -0,0 +1,26 @@
+"use strict";
+/**@format */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.guid = void 0;
+const Integer_1 = require("../core/object/Integer");
+const UUID_TEMPLATE = {
+    none: "xxxxxxxxxxxx4xxxyxxxxxxxxxxxxxxx",
+    default: "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",
+};
+/** Generate a Guid value string */
+function guid(type = "default") {
+    let d = new Date().getTime();
+    if (typeof performance === "undefined") {
+        // global.performance = require("perf_hooks").performance;
+        // eslint-disable-next-line no-eval
+        global.performance = eval("require")("perf_hooks").performance;
+    }
+    d += performance.now(); //use high-precision timer if available
+    const uuid = UUID_TEMPLATE[type].replace(/[xy]/g, (c) => {
+        const r = Integer_1.Integer.or((d + Math.random() * 16) % 16, 0); // d是随机种子
+        d = Math.floor(d / 16);
+        return (c === "x" ? r : Integer_1.Integer.or(Integer_1.Integer.and(r, 0x3), 0x8)).toString(16);
+    });
+    return uuid;
+}
+exports.guid = guid;

package/dist/lib/{utilities/security → security}/Hash.js

@@ -1,15 +1,16 @@
-"use strict";
-/**@format */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hash = void 0;
-/** Generate a hash code number of the string */
-function hash(source) {
-    let length = source.length;
-    let hashCode = 0;
-    while (length--) {
-        hashCode = (hashCode << 5) - hashCode + source.charCodeAt(length);
-        hashCode = hashCode & hashCode; // convert to 32 bit
-    }
-    return hashCode;
-}
-exports.hash = hash;
+"use strict";
+/**@format */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hash = void 0;
+const Integer_1 = require("../core/object/Integer");
+/** Generate a hash code number of the string */
+function hash(source) {
+    let length = source.length;
+    let hashCode = 0;
+    while (length--) {
+        hashCode = Integer_1.Integer.left(hashCode, 5) - hashCode + source.charCodeAt(length);
+        hashCode = Integer_1.Integer.and(hashCode, hashCode); // convert to 32 bit
+    }
+    return hashCode;
+}
+exports.hash = hash;

package/dist/lib/security/QRCode.js

@@ -0,0 +1,46 @@
+"use strict";
+/** @format */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QRCode = void 0;
+const qrcode = __importStar(require("qrcode"));
+/** QR code Lib */
+class QRCode {
+    /**
+     * Async getting a base64 URL of given text
+     *
+     * @param text source text
+     * @returns return base64 URL string
+     */
+    static async getURL(text) {
+        return new Promise((resolve) => {
+            qrcode.toDataURL(text, (error, url) => {
+                const textURL = error ? "" : url;
+                resolve(textURL);
+            });
+        });
+    }
+}
+exports.QRCode = QRCode;

package/dist/lib/security/RSA.js

@@ -0,0 +1,62 @@
+"use strict";
+/** @format */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RSA = void 0;
+const crypto_1 = require("crypto");
+/** RSA Lib */
+class RSA {
+    /**
+     * To get a new RSA public key and private key
+     *
+     * @param options RSA key generation option
+     * @returns return new RSA key
+     */
+    static new(options) {
+        const { publicKey, privateKey } = (0, crypto_1.generateKeyPairSync)("rsa", options);
+        return {
+            privateKey: privateKey,
+            publicKey: publicKey,
+        };
+    }
+    /**
+     * To encode a value with public key, the encoded data can be decoded by private key
+     *
+     * @param data input data
+     * @param publicKey encoding public key
+     * @returns return encoded buffer
+     */
+    static encodepub(data, publicKey) {
+        return (0, crypto_1.publicEncrypt)(publicKey, data);
+    }
+    /**
+     * To encode a value with private key, the encoded data can be decoded by public key
+     *
+     * @param data input data
+     * @param publicKey encoding private key
+     * @returns return encoded buffer
+     */
+    static encodepri(data, privateKey) {
+        return (0, crypto_1.privateEncrypt)(privateKey, data);
+    }
+    /**
+     * To decode a value with public key, the value is encoded by private key
+     *
+     * @param data input data
+     * @param publicKey decoding public key
+     * @returns return decoded buffer
+     */
+    static decodepub(data, publicKey) {
+        return (0, crypto_1.publicDecrypt)(publicKey, data);
+    }
+    /**
+     * To decode a value with private key, the value is encoded by public key
+     *
+     * @param data input data
+     * @param privateKey decoding private key
+     * @returns return decoded buffer
+     */
+    static decodepri(data, privateKey) {
+        return (0, crypto_1.privateDecrypt)(privateKey, data);
+    }
+}
+exports.RSA = RSA;

package/dist/lib/security/SHA.js

@@ -0,0 +1,67 @@
+"use strict";
+/** @format */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHA = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+/** SHA Lib */
+class SHA {
+    /**
+     * Calculate SHA256 code of data based on specified string encoding.
+     *
+     * @param data source data
+     * @param encoding string encoding type, default encoding type is 'utf-8', only used when data type is string
+     * @returns return the SHA256 code buffer
+     */
+    static sha256(data, encoding = "utf-8") {
+        return SHA.sha("sha256", data, encoding);
+    }
+    /**
+     * Calculate SHA512 code of data based on specified string encoding.
+     *
+     * @param data source data
+     * @param encoding string encoding type, default encoding type is 'utf-8', only used when data type is string
+     * @returns return the SHA256 code buffer
+     */
+    static sha512(data, encoding = "utf-8") {
+        return SHA.sha("sha512", data, encoding);
+    }
+    static sha(algorithm, data, encoding) {
+        const buffer = typeof data === "string" ? Buffer.from(data, encoding) : data;
+        const hash = crypto_1.default.createHash(algorithm);
+        hash.update(buffer);
+        return hash.digest();
+    }
+    /**
+     * Calculate SHA256 code of data based on a stream
+     *
+     * @param stream data stream
+     * @returns return the encoded buffer
+     */
+    static async stream256(stream) {
+        return SHA.streamSHA("sha256", stream);
+    }
+    /**
+     * Calculate SHA512 code of data based on a stream
+     *
+     * @param stream data stream
+     * @returns return the encoded buffer
+     */
+    static async stream512(stream) {
+        return SHA.streamSHA("sha512", stream);
+    }
+    static async streamSHA(algorithm, stream) {
+        const hash = crypto_1.default.createHash(algorithm);
+        return new Promise((resolve) => {
+            stream.on("data", (data) => {
+                hash.update(data);
+            });
+            stream.on("end", () => {
+                resolve(hash.digest());
+            });
+        });
+    }
+}
+exports.SHA = SHA;