@qlover/fe-corekit 1.2.1 → 1.2.5

package/dist/interface/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../../interface/executor/Executor.ts","../../interface/executor/ExecutorError.ts","../../interface/request/RequestError.ts"],"sourcesContent":["import { ExecutorError } from './ExecutorError';\nimport { ExecutorPlugin, Task } from './ExecutorPlugin';\n\n/**\n * Base executor class providing plugin management and execution pipeline\n *\n * The Executor pattern implements a pluggable execution pipeline that allows:\n * 1. Pre-processing of input data\n * 2. Post-processing of results\n * 3. Error handling\n * 4. Custom execution logic\n *\n * execNoError returns all errors as they are., and if there is a plugin onerror handler chain in which an error occurs, it will also return the error instead of throwing it.\n *\n * @abstract\n * @class Executor\n * @category Executor\n * @example\n * ```typescript\n * // Create an executor instance\n * const executor = new AsyncExecutor();\n *\n * // Add plugins\n * executor.use(new LoggerPlugin());\n * executor.use(new RetryPlugin({ maxAttempts: 3 }));\n *\n * // Execute a task\n * const result = await executor.exec(async (data) => {\n *   return await someAsyncOperation(data);\n * });\n * ```\n */\nexport abstract class Executor<ExecutorConfig = unknown> {\n  /**\n   * Array of active plugins\n   *\n   * - Purpose: Stores and manages executor plugins\n   * - Core Concept: Ordered plugin pipeline\n   * - Main Features:\n   *  - Maintains plugin execution order\n   *  - Supports plugin lifecycle management\n   * - Primary Use: Plugin orchestration and execution\n   *\n   * @example\n   * ```typescript\n   * protected plugins = [\n   *   new LoggerPlugin(),\n   *   new RetryPlugin()\n   * ];\n   * ```\n   */\n  protected plugins: ExecutorPlugin[] = [];\n\n  /**\n   * Creates a new Executor instance\n   *\n   * - Purpose: Initialize executor with optional configuration\n   * - Core Concept: Configurable executor setup\n   * - Main Features: Configuration injection\n   * - Primary Use: Executor instantiation\n   *\n   * @param {ExecutorConfig} config - Optional configuration object\n   *\n   * @example\n   * ```typescript\n   * const executor = new Executor({\n   *   // config options\n   * });\n   * ```\n   */\n  constructor(protected config?: ExecutorConfig) {}\n\n  /**\n   * Add a plugin to the executor\n   *\n   * - Purpose: Extends executor functionality through plugins\n   * - Core Concept: Plugin registration and deduplication\n   * - Main Features:\n   *  - Prevents duplicate plugins if onlyOne is true\n   *  - Maintains plugin execution order\n   * - Primary Use: Adding new capabilities to executor\n   *\n   * @param plugin - Plugin instance to add\n   *\n   * @example\n   * ```typescript\n   * executor.use(new LoggerPlugin());\n   * executor.use(new RetryPlugin({ maxAttempts: 3 }));\n   * ```\n   *\n   * @example\n   *\n   * Use a plain object as a plugin\n   * ```typescript\n   * executor.use({\n   *   onBefore: (data) => ({ ...data, modified: true })\n   * });\n   * ```\n   */\n  use(plugin: ExecutorPlugin): void {\n    if (\n      this.plugins.find(\n        (p) =>\n          p === plugin ||\n          p.pluginName === plugin.pluginName ||\n          p.constructor === plugin.constructor\n      ) &&\n      plugin.onlyOne\n    ) {\n      console.warn(`Plugin ${plugin.pluginName} is already used, skip adding`);\n      return;\n    }\n\n    this.plugins.push(plugin);\n  }\n\n  /**\n   * Execute a plugin hook\n   *\n   * - Purpose: Provides plugin hook execution mechanism\n   * - Core Concept: Plugin lifecycle management\n   * - Main Features:\n   *  - Dynamic hook execution\n   *  - Support for async and sync hooks\n   * - Primary Use: Running plugin lifecycle methods\n   *\n   * @param plugins - Plugins to execute\n   * @param name - Hook name to execute\n   * @param args - Arguments for the hook\n   *\n   * @example\n   * ```typescript\n   * await executor.runHook(plugins, 'beforeExec', data);\n   * ```\n   */\n  abstract runHooks(\n    plugins: ExecutorPlugin[],\n    name: keyof ExecutorPlugin,\n    ...args: unknown[]\n  ): void | unknown | Promise<void | unknown>;\n\n  /**\n   * Execute a task with plugin pipeline\n   *\n   * - Purpose: Core task execution with plugin support\n   * - Core Concept: Task execution pipeline\n   * - Main Features:\n   *  - Plugin hook integration\n   *  - Error handling\n   * - Primary Use: Running tasks through the executor pipeline\n   *\n   * @param task - Task to execute\n   * @param data - Optional input data for task\n   * @throws {ExecutorError} If task execution fails\n   *\n   * @example\n   * ```typescript\n   * const result = await executor.exec(async (data) => {\n   *   return await processData(data);\n   * });\n   * ```\n   */\n  abstract exec<Result, Params = unknown>(\n    task: Task<Result, Params>\n  ): Promise<Result> | Result;\n\n  /**\n   * Execute a task with plugin pipeline and input data\n   *\n   * - Purpose: Core task execution with plugin support and input data\n   * - Core Concept: Task execution pipeline with data\n   * - Main Features:\n   *  - Plugin hook integration\n   *  - Error handling\n   * - Primary Use: Running tasks with input data through the executor pipeline\n   *\n   * @param data - Input data for task\n   * @param task - Task to execute\n   * @throws {ExecutorError} If task execution fails\n   *\n   * @example\n   * ```typescript\n   * const result = await executor.exec(data, async (data) => {\n   *   return await processData(data);\n   * });\n   * ```\n   */\n  abstract exec<Result, Params = unknown>(\n    data: unknown,\n    task: Task<Result, Params>\n  ): Promise<Result> | Result;\n\n  /**\n   * Execute a task without throwing errors\n   *\n   * - Purpose: Safe task execution with error wrapping\n   * - Core Concept: Error-safe execution pipeline\n   * - Main Features:\n   *  - Error wrapping in ExecutorError\n   *  - Non-throwing execution\n   * - Primary Use: When error handling is preferred over exceptions\n   *\n   * @param task - Task to execute\n   *\n   * @example\n   * ```typescript\n   * const result = await executor.execNoError(async (data) => {\n   *   return await riskyOperation(data);\n   * });\n   * if (result instanceof ExecutorError) {\n   *   console.error('Task failed:', result);\n   * }\n   * ```\n   */\n  abstract execNoError<Result, Params = unknown>(\n    task: Task<Result, Params>\n  ): Promise<Result | ExecutorError> | Result | ExecutorError;\n\n  /**\n   * Execute a task with input data without throwing errors\n   *\n   * - Purpose: Safe task execution with error wrapping and input data\n   * - Core Concept: Error-safe execution pipeline with data\n   * - Main Features:\n   *  - Error wrapping in ExecutorError\n   *  - Non-throwing execution\n   * - Primary Use: When error handling is preferred over exceptions with input data\n   *\n   * @param data - Input data for task\n   * @param task - Task to execute\n   *\n   * @example\n   * ```typescript\n   * const result = await executor.execNoError(data, async (data) => {\n   *   return await riskyOperation(data);\n   * });\n   * if (result instanceof ExecutorError) {\n   *   console.error('Task failed:', result);\n   * }\n   * ```\n   */\n  abstract execNoError<Result, Params = unknown>(\n    data: unknown,\n    task: Task<Result, Params>\n  ): Promise<Result | ExecutorError> | Result | ExecutorError;\n}\n","/**\n * Custom error class for executor operations.\n *\n * This class provides a structured way to handle errors that occur during executor operations.\n * It extends the standard Error class to include an error identification string, which can be used\n * to categorize and manage errors more effectively.\n *\n * @category Executor\n *\n * @example\n * ```typescript\n * try {\n *   // some executor operation\n * } catch (error) {\n *   throw new ExecutorError('EXECUTOR_ERROR', error);\n * }\n * ```\n *\n * @example\n *\n * create an error with a message from a string\n *\n * ```typescript\n * const error = new ExecutorError('ERROR_ID', 'This is an error message');\n *\n * // => error.message is 'This is an error message'\n * // => error.id is 'ERROR_ID'\n * ```\n */\nexport class ExecutorError extends Error {\n  /**\n   * Constructs a new ExecutorError.\n   *\n   * if originalError is a string, it will be used as the error message.\n   * if originalError is an Error object, its message will be used as the error message.\n   * if originalError is not provided, the error message will be the id.\n   *\n   * @param id - A unique identifier for the error, used for categorization and tracking.\n   * @param originalError - The original error message or Error object that triggered this error.\n   *                        This parameter is optional.\n   */\n  constructor(\n    public id: string,\n    originalError?: string | Error\n  ) {\n    super(\n      originalError instanceof Error\n        ? originalError.message\n        : originalError || id\n    );\n\n    // if originalError is an Error object, use its stack\n    if (originalError instanceof Error && 'stack' in originalError) {\n      this.stack = originalError.stack;\n    }\n\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { ExecutorError } from '../executor';\n\n/**\n * Represents a custom error class for handling request-related errors in the application\n *\n * RequestError extends the base ExecutorError class to provide specific error handling\n * for HTTP requests and fetch operations. It works in conjunction with RequestErrorID\n * to categorize different types of request failures.\n *\n * @since 1.0.14\n *\n * @example\n * ```typescript\n * try {\n *   await fetchData(url);\n * } catch (error) {\n *   if (error instanceof RequestError) {\n *     // Handle request specific error\n *     console.error('Request failed:', error.message);\n *   }\n * }\n * ```\n */\nexport class RequestError extends ExecutorError {}\n\n/**\n * Error IDs for different fetch request failure scenarios\n * Used to identify specific error types in error handling\n *\n * @description\n * This enum provides a standardized set of error identifiers that can be used\n * to categorize and handle different types of request failures in a consistent manner.\n * Each error ID represents a specific failure scenario that might occur during HTTP requests.\n *\n * @example\n * ```typescript\n * if (error.id === RequestErrorID.RESPONSE_NOT_OK) {\n *   // Handle non-200 response\n * } else if (error.id === RequestErrorID.ABORT_ERROR) {\n *   // Handle aborted request\n * }\n * ```\n */\nexport enum RequestErrorID {\n  /** Generic fetch request error */\n  REQUEST_ERROR = 'REQUEST_ERROR',\n  /** Environment doesn't support fetch API */\n  ENV_FETCH_NOT_SUPPORT = 'ENV_FETCH_NOT_SUPPORT',\n  /** No fetcher function provided */\n  FETCHER_NONE = 'FETCHER_NONE',\n  /** Response status is not OK (not in 200-299 range) */\n  RESPONSE_NOT_OK = 'RESPONSE_NOT_OK',\n  /** Request was aborted */\n  ABORT_ERROR = 'ABORT_ERROR',\n  /** URL is not provided */\n  URL_NONE = 'URL_NONE'\n}\n"],"names":["RequestErrorID"],"mappings":";;;;;;EAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BG;AACH,MAAA,QAAA,kBAAA,YAAA;EAqBE;;;;;;;;;;;;;;;;EAgBG;EACH,IAAA,SAAA,QAAA,CAAsB,MAAuB,EAAA;UAAvB,IAAM,CAAA,MAAA,GAAN,MAAM;EArC5B;;;;;;;;;;;;;;;;;EAiBG;UACO,IAAO,CAAA,OAAA,GAAqB,EAAE;;EAqBxC;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BG;MACH,QAAG,CAAA,SAAA,CAAA,GAAA,GAAH,UAAI,MAAsB,EAAA;EACxB,QAAA,IACE,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,UAAC,CAAC,EAAA;cACA,OAAA,CAAC,KAAK,MAAM;EACZ,gBAAA,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;EAClC,gBAAA,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW;EAFpC,SAEoC,CACvC;cACD,MAAM,CAAC,OAAO,EACd;cACA,OAAO,CAAC,IAAI,CAAC,SAAA,CAAA,MAAA,CAAU,MAAM,CAAC,UAAU,EAA+B,+BAAA,CAAA,CAAC;cACxE;;EAGF,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;OAC1B;MAmIH,OAAC,QAAA;EAAD,CAAC,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ECrPD;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BG;AACH,MAAA,aAAA,kBAAA,UAAA,MAAA,EAAA;MAAmC,SAAK,CAAA,aAAA,EAAA,MAAA,CAAA;EACtC;;;;;;;;;;EAUG;MACH,SACS,aAAA,CAAA,EAAU,EACjB,aAA8B,EAAA;;EAE9B,QAAA,IAAA,KAAA,GAAA,MAAK,CAAA,IAAA,CAAA,IAAA,EACH,aAAa,YAAY;gBACrB,aAAa,CAAC;EAChB,cAAE,aAAa,IAAI,EAAE,CACxB,IAAC,IAAA;UAPK,KAAE,CAAA,EAAA,GAAF,EAAE;;UAUT,IAAI,aAAa,YAAY,KAAK,IAAI,OAAO,IAAI,aAAa,EAAE;EAC9D,YAAA,KAAI,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK;;UAGlC,MAAM,CAAC,cAAc,CAAC,KAAI,EAAE,UAAW,CAAA,SAAS,CAAC;;;MAErD,OAAC,aAAA;EAAD,CA7BA,CAAmC,KAAK,CA6BvC;;ECxDD;;;;;;;;;;;;;;;;;;;;EAoBG;AACH,MAAA,YAAA,kBAAA,UAAA,MAAA,EAAA;MAAkC,SAAa,CAAA,YAAA,EAAA,MAAA,CAAA;EAA/C,IAAA,SAAA,YAAA,GAAA;;;MAAiD,OAAC,YAAA;EAAD,CAAjD,CAAkC,aAAa,CAAG;EAElD;;;;;;;;;;;;;;;;;EAiBG;AACSA;EAAZ,CAAA,UAAY,cAAc,EAAA;;EAExB,IAAA,cAAA,CAAA,eAAA,CAAA,GAAA,eAA+B;;EAE/B,IAAA,cAAA,CAAA,uBAAA,CAAA,GAAA,uBAA+C;;EAE/C,IAAA,cAAA,CAAA,cAAA,CAAA,GAAA,cAA6B;;EAE7B,IAAA,cAAA,CAAA,iBAAA,CAAA,GAAA,iBAAmC;;EAEnC,IAAA,cAAA,CAAA,aAAA,CAAA,GAAA,aAA2B;;EAE3B,IAAA,cAAA,CAAA,UAAA,CAAA,GAAA,UAAqB;EACvB,CAAC,EAbWA,sBAAc,KAAdA,sBAAc,GAazB,EAAA,CAAA,CAAA;;;;;;;;;;"}

package/dist/server/index.cjs.js

@@ -1 +1,170 @@
-"use strict";var t=require("crypto"),e=require("buffer"),i=require("zlib"),n=function(){function n(t,e){void 0===e&&(e="base64"),this.encoding=e,this.ALGORITHM="aes-128-cbc",this.IV_LENGTH=16,this.KEY_LENGTH=16,this.KEY=this.validateKey(t)}return n.prototype.validateKey=function(t){var i=e.Buffer.from(t.slice(0,this.KEY_LENGTH));if(i.length!==this.KEY_LENGTH)throw new RangeError("Invalid key length. Expected ".concat(this.KEY_LENGTH," bytes, got ").concat(i.length," bytes"));return i},n.prototype.encrypt=function(e){var n=t.randomBytes(this.IV_LENGTH),r=t.createCipheriv(this.ALGORITHM,this.KEY,n),o=i.deflateSync(e),c=r.update(o,void 0,this.encoding);return c+=r.final(this.encoding),"".concat(c,":").concat(n.toString(this.encoding))},n.prototype.decrypt=function(n){var r=n.split(":"),o=r[0],c=r[1],s=t.createDecipheriv(this.ALGORITHM,this.KEY,e.Buffer.from(c,this.encoding)),a=e.Buffer.from(s.update(o,this.encoding,"binary"),"binary");return a=e.Buffer.concat([a,s.final()]),i.inflateSync(a).toString()},n}(),r=function(){function i(t,e){void 0===e&&(e="base64"),this.encoding=e,this.ALGORITHM="aes-256-cbc",this.KEY_LENGTH=32,this.KEY=this.validateKey(t)}return i.prototype.validateKey=function(t){var i=e.Buffer.from(t.slice(0,this.KEY_LENGTH));if(i.length!==this.KEY_LENGTH)throw new RangeError("Invalid key length. Expected ".concat(this.KEY_LENGTH," bytes, got ").concat(i.length," bytes"));return i},i.prototype.encrypt=function(e){var i=t.randomBytes(16),n=t.createCipheriv(this.ALGORITHM,this.KEY,i),r=n.update(e,"utf8",this.encoding);return r+=n.final(this.encoding),"".concat(r,":").concat(i.toString(this.encoding))},i.prototype.decrypt=function(i){var n=i.split(":"),r=n[0],o=n[1],c=t.createDecipheriv(this.ALGORITHM,this.KEY,e.Buffer.from(o,this.encoding)),s=c.update(r,this.encoding,"utf8");return s+=c.final("utf8")},i}();exports.StringEntrypt=r,exports.StringZlibEncrypt=n;
+'use strict';
+
+var crypto = require('crypto');
+var buffer = require('buffer');
+var zlib = require('zlib');
+
+/**
+ * String encryption implementation with Zlib compression
+ * Combines AES encryption with data compression
+ *
+ * Features:
+ * - AES-128-CBC encryption
+ * - Zlib compression
+ * - IV support
+ * - Configurable encoding
+ *
+ * @implements {Encryptor<string, string>}
+ *
+ * @example
+ * ```typescript
+ * const encryptor = new StringZlibEncrypt('my-16-char-key!!');
+ *
+ * // Encrypt and compress
+ * const encrypted = encryptor.encrypt('large text data');
+ *
+ * // Decrypt and decompress
+ * const decrypted = encryptor.decrypt(encrypted);
+ * ```
+ */
+var StringZlibEncrypt = /** @class */ (function () {
+    /**
+     * Creates a new StringZlibEncrypt instance
+     * @param encryptionKey - Key used for encryption/decryption
+     * @param encoding - Output encoding format
+     * @throws {RangeError} If key length is invalid
+     */
+    function StringZlibEncrypt(encryptionKey, encoding) {
+        if (encoding === void 0) { encoding = 'base64'; }
+        this.encoding = encoding;
+        this.ALGORITHM = 'aes-128-cbc';
+        this.IV_LENGTH = 16;
+        this.KEY_LENGTH = 16;
+        this.KEY = this.validateKey(encryptionKey);
+    }
+    /**
+     * Validates and processes encryption key
+     * Ensures key meets length requirements
+     *
+     * @param key - Raw encryption key
+     * @returns Validated key buffer
+     * @throws {RangeError} If key length is invalid
+     */
+    StringZlibEncrypt.prototype.validateKey = function (key) {
+        var keyBuffer = buffer.Buffer.from(key.slice(0, this.KEY_LENGTH));
+        if (keyBuffer.length !== this.KEY_LENGTH) {
+            throw new RangeError("Invalid key length. Expected ".concat(this.KEY_LENGTH, " bytes, got ").concat(keyBuffer.length, " bytes"));
+        }
+        return keyBuffer;
+    };
+    /**
+     * Encrypts and compresses a string value
+     * Applies compression before encryption
+     *
+     * @param value - String to encrypt
+     * @returns Encrypted and compressed string with IV
+     */
+    StringZlibEncrypt.prototype.encrypt = function (value) {
+        var iv = crypto.randomBytes(this.IV_LENGTH);
+        var cipher = crypto.createCipheriv(this.ALGORITHM, this.KEY, iv);
+        var compressedValue = zlib.deflateSync(value);
+        var encrypted = cipher.update(compressedValue, undefined, this.encoding);
+        encrypted += cipher.final(this.encoding);
+        return "".concat(encrypted, ":").concat(iv.toString(this.encoding));
+    };
+    /**
+     * Decrypts and decompresses an encrypted string
+     * Applies decryption before decompression
+     *
+     * @param encryptedData - Encrypted string with IV
+     * @returns Original string
+     */
+    StringZlibEncrypt.prototype.decrypt = function (encryptedData) {
+        var _a = encryptedData.split(':'), encrypted = _a[0], iv = _a[1];
+        var decipher = crypto.createDecipheriv(this.ALGORITHM, this.KEY, buffer.Buffer.from(iv, this.encoding));
+        var decrypted = buffer.Buffer.from(decipher.update(encrypted, this.encoding, 'binary'), 'binary');
+        // console.log(decrypted);
+        // console.log(decipher.final());
+        decrypted = buffer.Buffer.concat([decrypted, decipher.final()]);
+        var decompressedValue = zlib.inflateSync(decrypted);
+        return decompressedValue.toString();
+    };
+    return StringZlibEncrypt;
+}());
+
+/**
+ * Represents a string encryption utility using AES-256-CBC algorithm.
+ *
+ * This class provides methods to encrypt and decrypt string values securely.
+ * It ensures that the encryption key meets the required length for AES-256.
+ *
+ * @example
+ * ```typescript
+ * const encryptor = new StringEntrypt('your-encryption-key');
+ * const encrypted = encryptor.encrypt('your-string');
+ * const decrypted = encryptor.decrypt(encrypted);
+ * ```
+ */
+var StringEntrypt = /** @class */ (function () {
+    /**
+     * Creates a new StringEntrypt instance
+     * @param encryptionKey - Key used for encryption/decryption
+     * @param encoding - Output encoding format
+     * @throws {RangeError} If key length is invalid
+     */
+    function StringEntrypt(encryptionKey, encoding) {
+        if (encoding === void 0) { encoding = 'base64'; }
+        this.encoding = encoding;
+        this.ALGORITHM = 'aes-256-cbc';
+        this.KEY_LENGTH = 32; // AES-256 needs 32 bytes key
+        this.KEY = this.validateKey(encryptionKey);
+    }
+    /**
+     * Validates and processes encryption key
+     * Ensures key meets length requirements
+     *
+     * @param key - Raw encryption key
+     * @returns Validated key buffer
+     * @throws {RangeError} If key length is invalid
+     */
+    StringEntrypt.prototype.validateKey = function (key) {
+        var keyBuffer = buffer.Buffer.from(key.slice(0, this.KEY_LENGTH));
+        if (keyBuffer.length !== this.KEY_LENGTH) {
+            throw new RangeError("Invalid key length. Expected ".concat(this.KEY_LENGTH, " bytes, got ").concat(keyBuffer.length, " bytes"));
+        }
+        return keyBuffer;
+    };
+    /**
+     * Encrypts a string value
+     * Uses random IV for each encryption
+     *
+     * @param value - String to encrypt
+     * @returns Encrypted string with IV
+     */
+    StringEntrypt.prototype.encrypt = function (value) {
+        var iv = crypto.randomBytes(16);
+        var cipher = crypto.createCipheriv(this.ALGORITHM, this.KEY, iv);
+        var encrypted = cipher.update(value, 'utf8', this.encoding);
+        encrypted += cipher.final(this.encoding);
+        return "".concat(encrypted, ":").concat(iv.toString(this.encoding));
+    };
+    /**
+     * Decrypts an encrypted string
+     * Extracts IV from encrypted data
+     *
+     * @param encryptedData - Encrypted string with IV
+     * @returns Original string
+     */
+    StringEntrypt.prototype.decrypt = function (encryptedData) {
+        var _a = encryptedData.split(':'), encrypted = _a[0], iv = _a[1];
+        var decipher = crypto.createDecipheriv(this.ALGORITHM, this.KEY, buffer.Buffer.from(iv, this.encoding));
+        var decrypted = decipher.update(encrypted, this.encoding, 'utf8');
+        decrypted += decipher.final('utf8');
+        return decrypted;
+    };
+    return StringEntrypt;
+}());
+
+exports.StringEntrypt = StringEntrypt;
+exports.StringZlibEncrypt = StringZlibEncrypt;
+//# sourceMappingURL=index.cjs.js.map

package/dist/server/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../../server/encrypt/StringZlibEncrypt.ts","../../server/encrypt/StringEntrypt.ts"],"sourcesContent":["import crypto from 'crypto';\nimport { Buffer } from 'buffer';\nimport zlib from 'zlib';\nimport { Encryptor } from '../../interface';\n\n/**\n * String encryption implementation with Zlib compression\n * Combines AES encryption with data compression\n *\n * Features:\n * - AES-128-CBC encryption\n * - Zlib compression\n * - IV support\n * - Configurable encoding\n *\n * @implements {Encryptor<string, string>}\n *\n * @example\n * ```typescript\n * const encryptor = new StringZlibEncrypt('my-16-char-key!!');\n *\n * // Encrypt and compress\n * const encrypted = encryptor.encrypt('large text data');\n *\n * // Decrypt and decompress\n * const decrypted = encryptor.decrypt(encrypted);\n * ```\n */\nexport class StringZlibEncrypt implements Encryptor<string, string> {\n  private ALGORITHM = 'aes-128-cbc';\n  private KEY: Buffer;\n  private IV_LENGTH = 16;\n  private KEY_LENGTH = 16;\n\n  /**\n   * Creates a new StringZlibEncrypt instance\n   * @param encryptionKey - Key used for encryption/decryption\n   * @param encoding - Output encoding format\n   * @throws {RangeError} If key length is invalid\n   */\n  constructor(\n    encryptionKey: string,\n    private readonly encoding: globalThis.BufferEncoding = 'base64'\n  ) {\n    this.KEY = this.validateKey(encryptionKey);\n  }\n\n  /**\n   * Validates and processes encryption key\n   * Ensures key meets length requirements\n   *\n   * @param key - Raw encryption key\n   * @returns Validated key buffer\n   * @throws {RangeError} If key length is invalid\n   */\n  private validateKey(key: string): Buffer {\n    const keyBuffer = Buffer.from(key.slice(0, this.KEY_LENGTH));\n    if (keyBuffer.length !== this.KEY_LENGTH) {\n      throw new RangeError(\n        `Invalid key length. Expected ${this.KEY_LENGTH} bytes, got ${keyBuffer.length} bytes`\n      );\n    }\n    return keyBuffer;\n  }\n\n  /**\n   * Encrypts and compresses a string value\n   * Applies compression before encryption\n   *\n   * @param value - String to encrypt\n   * @returns Encrypted and compressed string with IV\n   */\n  encrypt(value: string): string {\n    const iv = crypto.randomBytes(this.IV_LENGTH);\n    const cipher = crypto.createCipheriv(this.ALGORITHM, this.KEY, iv);\n\n    const compressedValue = zlib.deflateSync(value);\n    let encrypted = cipher.update(compressedValue, undefined, this.encoding);\n    encrypted += cipher.final(this.encoding);\n\n    return `${encrypted}:${iv.toString(this.encoding)}`;\n  }\n\n  /**\n   * Decrypts and decompresses an encrypted string\n   * Applies decryption before decompression\n   *\n   * @param encryptedData - Encrypted string with IV\n   * @returns Original string\n   */\n  decrypt(encryptedData: string): string {\n    const [encrypted, iv] = encryptedData.split(':');\n    const decipher = crypto.createDecipheriv(\n      this.ALGORITHM,\n      this.KEY,\n      Buffer.from(iv, this.encoding)\n    );\n\n    let decrypted = Buffer.from(\n      decipher.update(encrypted, this.encoding, 'binary'),\n      'binary'\n    );\n\n    // console.log(decrypted);\n    // console.log(decipher.final());\n\n    decrypted = Buffer.concat([decrypted, decipher.final()]);\n    const decompressedValue = zlib.inflateSync(decrypted);\n\n    return decompressedValue.toString();\n  }\n}\n","import crypto from 'crypto';\nimport { Buffer } from 'buffer';\nimport { Encryptor } from '../../interface';\n\n/**\n * Represents a string encryption utility using AES-256-CBC algorithm.\n *\n * This class provides methods to encrypt and decrypt string values securely.\n * It ensures that the encryption key meets the required length for AES-256.\n *\n * @example\n * ```typescript\n * const encryptor = new StringEntrypt('your-encryption-key');\n * const encrypted = encryptor.encrypt('your-string');\n * const decrypted = encryptor.decrypt(encrypted);\n * ```\n */\nexport class StringEntrypt implements Encryptor<string, string> {\n  private ALGORITHM = 'aes-256-cbc';\n  private KEY: Buffer;\n  private KEY_LENGTH = 32; // AES-256 needs 32 bytes key\n\n  /**\n   * Creates a new StringEntrypt instance\n   * @param encryptionKey - Key used for encryption/decryption\n   * @param encoding - Output encoding format\n   * @throws {RangeError} If key length is invalid\n   */\n  constructor(\n    encryptionKey: string,\n    private readonly encoding: globalThis.BufferEncoding = 'base64'\n  ) {\n    this.KEY = this.validateKey(encryptionKey);\n  }\n\n  /**\n   * Validates and processes encryption key\n   * Ensures key meets length requirements\n   *\n   * @param key - Raw encryption key\n   * @returns Validated key buffer\n   * @throws {RangeError} If key length is invalid\n   */\n  private validateKey(key: string): Buffer {\n    const keyBuffer = Buffer.from(key.slice(0, this.KEY_LENGTH));\n\n    if (keyBuffer.length !== this.KEY_LENGTH) {\n      throw new RangeError(\n        `Invalid key length. Expected ${this.KEY_LENGTH} bytes, got ${keyBuffer.length} bytes`\n      );\n    }\n\n    return keyBuffer;\n  }\n\n  /**\n   * Encrypts a string value\n   * Uses random IV for each encryption\n   *\n   * @param value - String to encrypt\n   * @returns Encrypted string with IV\n   */\n  encrypt(value: string): string {\n    const iv = crypto.randomBytes(16);\n    const cipher = crypto.createCipheriv(this.ALGORITHM, this.KEY, iv);\n    let encrypted = cipher.update(value, 'utf8', this.encoding);\n    encrypted += cipher.final(this.encoding);\n    return `${encrypted}:${iv.toString(this.encoding)}`;\n  }\n\n  /**\n   * Decrypts an encrypted string\n   * Extracts IV from encrypted data\n   *\n   * @param encryptedData - Encrypted string with IV\n   * @returns Original string\n   */\n  decrypt(encryptedData: string): string {\n    const [encrypted, iv] = encryptedData.split(':');\n    const decipher = crypto.createDecipheriv(\n      this.ALGORITHM,\n      this.KEY,\n      Buffer.from(iv, this.encoding)\n    );\n    let decrypted = decipher.update(encrypted, this.encoding, 'utf8');\n    decrypted += decipher.final('utf8');\n    return decrypted;\n  }\n}\n"],"names":["Buffer"],"mappings":"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"}

package/dist/server/index.es.js

@@ -1 +1,167 @@
-import t from"crypto";import{Buffer as i}from"buffer";import e from"zlib";var n=function(){function n(t,i){void 0===i&&(i="base64"),this.encoding=i,this.ALGORITHM="aes-128-cbc",this.IV_LENGTH=16,this.KEY_LENGTH=16,this.KEY=this.validateKey(t)}return n.prototype.validateKey=function(t){var e=i.from(t.slice(0,this.KEY_LENGTH));if(e.length!==this.KEY_LENGTH)throw new RangeError("Invalid key length. Expected ".concat(this.KEY_LENGTH," bytes, got ").concat(e.length," bytes"));return e},n.prototype.encrypt=function(i){var n=t.randomBytes(this.IV_LENGTH),o=t.createCipheriv(this.ALGORITHM,this.KEY,n),r=e.deflateSync(i),c=o.update(r,void 0,this.encoding);return c+=o.final(this.encoding),"".concat(c,":").concat(n.toString(this.encoding))},n.prototype.decrypt=function(n){var o=n.split(":"),r=o[0],c=o[1],a=t.createDecipheriv(this.ALGORITHM,this.KEY,i.from(c,this.encoding)),s=i.from(a.update(r,this.encoding,"binary"),"binary");return s=i.concat([s,a.final()]),e.inflateSync(s).toString()},n}(),o=function(){function e(t,i){void 0===i&&(i="base64"),this.encoding=i,this.ALGORITHM="aes-256-cbc",this.KEY_LENGTH=32,this.KEY=this.validateKey(t)}return e.prototype.validateKey=function(t){var e=i.from(t.slice(0,this.KEY_LENGTH));if(e.length!==this.KEY_LENGTH)throw new RangeError("Invalid key length. Expected ".concat(this.KEY_LENGTH," bytes, got ").concat(e.length," bytes"));return e},e.prototype.encrypt=function(i){var e=t.randomBytes(16),n=t.createCipheriv(this.ALGORITHM,this.KEY,e),o=n.update(i,"utf8",this.encoding);return o+=n.final(this.encoding),"".concat(o,":").concat(e.toString(this.encoding))},e.prototype.decrypt=function(e){var n=e.split(":"),o=n[0],r=n[1],c=t.createDecipheriv(this.ALGORITHM,this.KEY,i.from(r,this.encoding)),a=c.update(o,this.encoding,"utf8");return a+=c.final("utf8")},e}();export{o as StringEntrypt,n as StringZlibEncrypt};
+import crypto from 'crypto';
+import { Buffer } from 'buffer';
+import zlib from 'zlib';
+
+/**
+ * String encryption implementation with Zlib compression
+ * Combines AES encryption with data compression
+ *
+ * Features:
+ * - AES-128-CBC encryption
+ * - Zlib compression
+ * - IV support
+ * - Configurable encoding
+ *
+ * @implements {Encryptor<string, string>}
+ *
+ * @example
+ * ```typescript
+ * const encryptor = new StringZlibEncrypt('my-16-char-key!!');
+ *
+ * // Encrypt and compress
+ * const encrypted = encryptor.encrypt('large text data');
+ *
+ * // Decrypt and decompress
+ * const decrypted = encryptor.decrypt(encrypted);
+ * ```
+ */
+var StringZlibEncrypt = /** @class */ (function () {
+    /**
+     * Creates a new StringZlibEncrypt instance
+     * @param encryptionKey - Key used for encryption/decryption
+     * @param encoding - Output encoding format
+     * @throws {RangeError} If key length is invalid
+     */
+    function StringZlibEncrypt(encryptionKey, encoding) {
+        if (encoding === void 0) { encoding = 'base64'; }
+        this.encoding = encoding;
+        this.ALGORITHM = 'aes-128-cbc';
+        this.IV_LENGTH = 16;
+        this.KEY_LENGTH = 16;
+        this.KEY = this.validateKey(encryptionKey);
+    }
+    /**
+     * Validates and processes encryption key
+     * Ensures key meets length requirements
+     *
+     * @param key - Raw encryption key
+     * @returns Validated key buffer
+     * @throws {RangeError} If key length is invalid
+     */
+    StringZlibEncrypt.prototype.validateKey = function (key) {
+        var keyBuffer = Buffer.from(key.slice(0, this.KEY_LENGTH));
+        if (keyBuffer.length !== this.KEY_LENGTH) {
+            throw new RangeError("Invalid key length. Expected ".concat(this.KEY_LENGTH, " bytes, got ").concat(keyBuffer.length, " bytes"));
+        }
+        return keyBuffer;
+    };
+    /**
+     * Encrypts and compresses a string value
+     * Applies compression before encryption
+     *
+     * @param value - String to encrypt
+     * @returns Encrypted and compressed string with IV
+     */
+    StringZlibEncrypt.prototype.encrypt = function (value) {
+        var iv = crypto.randomBytes(this.IV_LENGTH);
+        var cipher = crypto.createCipheriv(this.ALGORITHM, this.KEY, iv);
+        var compressedValue = zlib.deflateSync(value);
+        var encrypted = cipher.update(compressedValue, undefined, this.encoding);
+        encrypted += cipher.final(this.encoding);
+        return "".concat(encrypted, ":").concat(iv.toString(this.encoding));
+    };
+    /**
+     * Decrypts and decompresses an encrypted string
+     * Applies decryption before decompression
+     *
+     * @param encryptedData - Encrypted string with IV
+     * @returns Original string
+     */
+    StringZlibEncrypt.prototype.decrypt = function (encryptedData) {
+        var _a = encryptedData.split(':'), encrypted = _a[0], iv = _a[1];
+        var decipher = crypto.createDecipheriv(this.ALGORITHM, this.KEY, Buffer.from(iv, this.encoding));
+        var decrypted = Buffer.from(decipher.update(encrypted, this.encoding, 'binary'), 'binary');
+        // console.log(decrypted);
+        // console.log(decipher.final());
+        decrypted = Buffer.concat([decrypted, decipher.final()]);
+        var decompressedValue = zlib.inflateSync(decrypted);
+        return decompressedValue.toString();
+    };
+    return StringZlibEncrypt;
+}());
+
+/**
+ * Represents a string encryption utility using AES-256-CBC algorithm.
+ *
+ * This class provides methods to encrypt and decrypt string values securely.
+ * It ensures that the encryption key meets the required length for AES-256.
+ *
+ * @example
+ * ```typescript
+ * const encryptor = new StringEntrypt('your-encryption-key');
+ * const encrypted = encryptor.encrypt('your-string');
+ * const decrypted = encryptor.decrypt(encrypted);
+ * ```
+ */
+var StringEntrypt = /** @class */ (function () {
+    /**
+     * Creates a new StringEntrypt instance
+     * @param encryptionKey - Key used for encryption/decryption
+     * @param encoding - Output encoding format
+     * @throws {RangeError} If key length is invalid
+     */
+    function StringEntrypt(encryptionKey, encoding) {
+        if (encoding === void 0) { encoding = 'base64'; }
+        this.encoding = encoding;
+        this.ALGORITHM = 'aes-256-cbc';
+        this.KEY_LENGTH = 32; // AES-256 needs 32 bytes key
+        this.KEY = this.validateKey(encryptionKey);
+    }
+    /**
+     * Validates and processes encryption key
+     * Ensures key meets length requirements
+     *
+     * @param key - Raw encryption key
+     * @returns Validated key buffer
+     * @throws {RangeError} If key length is invalid
+     */
+    StringEntrypt.prototype.validateKey = function (key) {
+        var keyBuffer = Buffer.from(key.slice(0, this.KEY_LENGTH));
+        if (keyBuffer.length !== this.KEY_LENGTH) {
+            throw new RangeError("Invalid key length. Expected ".concat(this.KEY_LENGTH, " bytes, got ").concat(keyBuffer.length, " bytes"));
+        }
+        return keyBuffer;
+    };
+    /**
+     * Encrypts a string value
+     * Uses random IV for each encryption
+     *
+     * @param value - String to encrypt
+     * @returns Encrypted string with IV
+     */
+    StringEntrypt.prototype.encrypt = function (value) {
+        var iv = crypto.randomBytes(16);
+        var cipher = crypto.createCipheriv(this.ALGORITHM, this.KEY, iv);
+        var encrypted = cipher.update(value, 'utf8', this.encoding);
+        encrypted += cipher.final(this.encoding);
+        return "".concat(encrypted, ":").concat(iv.toString(this.encoding));
+    };
+    /**
+     * Decrypts an encrypted string
+     * Extracts IV from encrypted data
+     *
+     * @param encryptedData - Encrypted string with IV
+     * @returns Original string
+     */
+    StringEntrypt.prototype.decrypt = function (encryptedData) {
+        var _a = encryptedData.split(':'), encrypted = _a[0], iv = _a[1];
+        var decipher = crypto.createDecipheriv(this.ALGORITHM, this.KEY, Buffer.from(iv, this.encoding));
+        var decrypted = decipher.update(encrypted, this.encoding, 'utf8');
+        decrypted += decipher.final('utf8');
+        return decrypted;
+    };
+    return StringEntrypt;
+}());
+
+export { StringEntrypt, StringZlibEncrypt };
+//# sourceMappingURL=index.es.js.map

package/dist/server/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":["../../server/encrypt/StringZlibEncrypt.ts","../../server/encrypt/StringEntrypt.ts"],"sourcesContent":["import crypto from 'crypto';\nimport { Buffer } from 'buffer';\nimport zlib from 'zlib';\nimport { Encryptor } from '../../interface';\n\n/**\n * String encryption implementation with Zlib compression\n * Combines AES encryption with data compression\n *\n * Features:\n * - AES-128-CBC encryption\n * - Zlib compression\n * - IV support\n * - Configurable encoding\n *\n * @implements {Encryptor<string, string>}\n *\n * @example\n * ```typescript\n * const encryptor = new StringZlibEncrypt('my-16-char-key!!');\n *\n * // Encrypt and compress\n * const encrypted = encryptor.encrypt('large text data');\n *\n * // Decrypt and decompress\n * const decrypted = encryptor.decrypt(encrypted);\n * ```\n */\nexport class StringZlibEncrypt implements Encryptor<string, string> {\n  private ALGORITHM = 'aes-128-cbc';\n  private KEY: Buffer;\n  private IV_LENGTH = 16;\n  private KEY_LENGTH = 16;\n\n  /**\n   * Creates a new StringZlibEncrypt instance\n   * @param encryptionKey - Key used for encryption/decryption\n   * @param encoding - Output encoding format\n   * @throws {RangeError} If key length is invalid\n   */\n  constructor(\n    encryptionKey: string,\n    private readonly encoding: globalThis.BufferEncoding = 'base64'\n  ) {\n    this.KEY = this.validateKey(encryptionKey);\n  }\n\n  /**\n   * Validates and processes encryption key\n   * Ensures key meets length requirements\n   *\n   * @param key - Raw encryption key\n   * @returns Validated key buffer\n   * @throws {RangeError} If key length is invalid\n   */\n  private validateKey(key: string): Buffer {\n    const keyBuffer = Buffer.from(key.slice(0, this.KEY_LENGTH));\n    if (keyBuffer.length !== this.KEY_LENGTH) {\n      throw new RangeError(\n        `Invalid key length. Expected ${this.KEY_LENGTH} bytes, got ${keyBuffer.length} bytes`\n      );\n    }\n    return keyBuffer;\n  }\n\n  /**\n   * Encrypts and compresses a string value\n   * Applies compression before encryption\n   *\n   * @param value - String to encrypt\n   * @returns Encrypted and compressed string with IV\n   */\n  encrypt(value: string): string {\n    const iv = crypto.randomBytes(this.IV_LENGTH);\n    const cipher = crypto.createCipheriv(this.ALGORITHM, this.KEY, iv);\n\n    const compressedValue = zlib.deflateSync(value);\n    let encrypted = cipher.update(compressedValue, undefined, this.encoding);\n    encrypted += cipher.final(this.encoding);\n\n    return `${encrypted}:${iv.toString(this.encoding)}`;\n  }\n\n  /**\n   * Decrypts and decompresses an encrypted string\n   * Applies decryption before decompression\n   *\n   * @param encryptedData - Encrypted string with IV\n   * @returns Original string\n   */\n  decrypt(encryptedData: string): string {\n    const [encrypted, iv] = encryptedData.split(':');\n    const decipher = crypto.createDecipheriv(\n      this.ALGORITHM,\n      this.KEY,\n      Buffer.from(iv, this.encoding)\n    );\n\n    let decrypted = Buffer.from(\n      decipher.update(encrypted, this.encoding, 'binary'),\n      'binary'\n    );\n\n    // console.log(decrypted);\n    // console.log(decipher.final());\n\n    decrypted = Buffer.concat([decrypted, decipher.final()]);\n    const decompressedValue = zlib.inflateSync(decrypted);\n\n    return decompressedValue.toString();\n  }\n}\n","import crypto from 'crypto';\nimport { Buffer } from 'buffer';\nimport { Encryptor } from '../../interface';\n\n/**\n * Represents a string encryption utility using AES-256-CBC algorithm.\n *\n * This class provides methods to encrypt and decrypt string values securely.\n * It ensures that the encryption key meets the required length for AES-256.\n *\n * @example\n * ```typescript\n * const encryptor = new StringEntrypt('your-encryption-key');\n * const encrypted = encryptor.encrypt('your-string');\n * const decrypted = encryptor.decrypt(encrypted);\n * ```\n */\nexport class StringEntrypt implements Encryptor<string, string> {\n  private ALGORITHM = 'aes-256-cbc';\n  private KEY: Buffer;\n  private KEY_LENGTH = 32; // AES-256 needs 32 bytes key\n\n  /**\n   * Creates a new StringEntrypt instance\n   * @param encryptionKey - Key used for encryption/decryption\n   * @param encoding - Output encoding format\n   * @throws {RangeError} If key length is invalid\n   */\n  constructor(\n    encryptionKey: string,\n    private readonly encoding: globalThis.BufferEncoding = 'base64'\n  ) {\n    this.KEY = this.validateKey(encryptionKey);\n  }\n\n  /**\n   * Validates and processes encryption key\n   * Ensures key meets length requirements\n   *\n   * @param key - Raw encryption key\n   * @returns Validated key buffer\n   * @throws {RangeError} If key length is invalid\n   */\n  private validateKey(key: string): Buffer {\n    const keyBuffer = Buffer.from(key.slice(0, this.KEY_LENGTH));\n\n    if (keyBuffer.length !== this.KEY_LENGTH) {\n      throw new RangeError(\n        `Invalid key length. Expected ${this.KEY_LENGTH} bytes, got ${keyBuffer.length} bytes`\n      );\n    }\n\n    return keyBuffer;\n  }\n\n  /**\n   * Encrypts a string value\n   * Uses random IV for each encryption\n   *\n   * @param value - String to encrypt\n   * @returns Encrypted string with IV\n   */\n  encrypt(value: string): string {\n    const iv = crypto.randomBytes(16);\n    const cipher = crypto.createCipheriv(this.ALGORITHM, this.KEY, iv);\n    let encrypted = cipher.update(value, 'utf8', this.encoding);\n    encrypted += cipher.final(this.encoding);\n    return `${encrypted}:${iv.toString(this.encoding)}`;\n  }\n\n  /**\n   * Decrypts an encrypted string\n   * Extracts IV from encrypted data\n   *\n   * @param encryptedData - Encrypted string with IV\n   * @returns Original string\n   */\n  decrypt(encryptedData: string): string {\n    const [encrypted, iv] = encryptedData.split(':');\n    const decipher = crypto.createDecipheriv(\n      this.ALGORITHM,\n      this.KEY,\n      Buffer.from(iv, this.encoding)\n    );\n    let decrypted = decipher.update(encrypted, this.encoding, 'utf8');\n    decrypted += decipher.final('utf8');\n    return decrypted;\n  }\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qlover/fe-corekit",
   "description": "A corekit for frontwork",
-  "version": "1.2.1",
+  "version": "1.2.5",
   "private": false,
   "type": "module",
   "files": [
@@ -58,7 +58,7 @@
     "merge": "^2.1.1"
   },
   "devDependencies": {
-    "@qlover/fe-scripts": "latest",
+    "@qlover/env-loader": "^0.0.1",
     "@types/lodash": "^4.17.12",
     "axios": "^1.7.9"
   }