@gennext/lb-infra 0.0.12 → 0.0.17

package/dist/helpers/redis/redis.helper.js

@@ -7,7 +7,37 @@ exports.RedisHelper = void 0;
 const parse_utility_1 = require("../../utilities/parse.utility");
 const ioredis_1 = __importDefault(require("ioredis"));
 const default_helper_1 = require("./default.helper");
+/**
+ * Redis connection helper with automatic retry and connection management
+ * Extends DefaultRedisHelper with ioredis client implementation
+ *
+ * @class RedisHelper
+ * @extends DefaultRedisHelper
+ * @example
+ * const redis = new RedisHelper({
+ *   name: 'cache',
+ *   host: 'localhost',
+ *   port: 6379,
+ *   password: 'secret',
+ *   autoConnect: true,
+ *   maxRetry: 3
+ * });
+ *
+ * await redis.connect();
+ * const value = await redis.get('mykey');
+ */
 class RedisHelper extends default_helper_1.DefaultRedisHelper {
+    /**
+     * Creates a new Redis connection instance
+     * @param opts - Connection configuration options
+     * @param opts.name - Identifier name for this Redis instance
+     * @param opts.host - Redis server hostname
+     * @param opts.port - Redis server port (will be parsed to int)
+     * @param opts.password - Authentication password (optional)
+     * @param opts.database - Database number (default: 0)
+     * @param opts.autoConnect - Connect immediately (default: true)
+     * @param opts.maxRetry - Maximum retry attempts (default: 0, -1 = unlimited)
+     */
     constructor(opts) {
         const { name, host, port, password, 
         // Optional
@@ -35,6 +65,10 @@ class RedisHelper extends default_helper_1.DefaultRedisHelper {
             }),
         });
     }
+    /**
+     * Gets the underlying Redis client instance
+     * @returns ioredis Redis client
+     */
     getClient() {
         return this.client;
     }

package/dist/helpers/redis/redis.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"redis.helper.js","sourceRoot":"","sources":["../../../src/helpers/redis/redis.helper.ts"],"names":[],"mappings":";;;;;;AAAA,6DAAgD;AAChD,sDAA4B;AAC5B,qDAAsD;AAGtD,MAAa,WAAY,SAAQ,mCAAkB;IACjD,YAAY,IAAyB;QACnC,MAAM,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ;QAER,WAAW;QACX,QAAQ,GAAG,CAAC,EACZ,WAAW,GAAG,IAAI,EAClB,QAAQ,GAAG,CAAC,GACb,GAAG,IAAI,CAAC;QAET,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,WAAW,CAAC,IAAI;YACvB,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,IAAI,iBAAK,CAAC;gBAChB,IAAI;gBACJ,IAAI;gBACJ,IAAI,EAAE,IAAA,mBAAG,EAAC,IAAI,CAAC;gBACf,QAAQ;gBACR,EAAE,EAAE,QAAQ;gBACZ,WAAW,EAAE,CAAC,WAAW;gBACzB,sBAAsB,EAAE,IAAI;gBAC5B,aAAa,EAAE,CAAC,cAAsB,EAAE,EAAE;oBACxC,IAAI,QAAQ,GAAG,CAAC,CAAC,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;wBAC/C,OAAO,SAAS,CAAC;oBACnB,CAAC;oBAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;oBACvE,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,oBAAoB,EAAE,IAAI;aAC3B,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAEQ,SAAS;QAChB,OAAO,IAAI,CAAC,MAAe,CAAC;IAC9B,CAAC;CACF;AA1CD,kCA0CC"}
+{"version":3,"file":"redis.helper.js","sourceRoot":"","sources":["../../../src/helpers/redis/redis.helper.ts"],"names":[],"mappings":";;;;;;AAAA,6DAAgD;AAChD,sDAA4B;AAC5B,qDAAsD;AAGtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,WAAY,SAAQ,mCAAkB;IACjD;;;;;;;;;;OAUG;IACH,YAAY,IAAyB;QACnC,MAAM,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ;QAER,WAAW;QACX,QAAQ,GAAG,CAAC,EACZ,WAAW,GAAG,IAAI,EAClB,QAAQ,GAAG,CAAC,GACb,GAAG,IAAI,CAAC;QAET,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,WAAW,CAAC,IAAI;YACvB,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,IAAI,iBAAK,CAAC;gBAChB,IAAI;gBACJ,IAAI;gBACJ,IAAI,EAAE,IAAA,mBAAG,EAAC,IAAI,CAAC;gBACf,QAAQ;gBACR,EAAE,EAAE,QAAQ;gBACZ,WAAW,EAAE,CAAC,WAAW;gBACzB,sBAAsB,EAAE,IAAI;gBAC5B,aAAa,EAAE,CAAC,cAAsB,EAAE,EAAE;oBACxC,IAAI,QAAQ,GAAG,CAAC,CAAC,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;wBAC/C,OAAO,SAAS,CAAC;oBACnB,CAAC;oBAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;oBACvE,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBACD,oBAAoB,EAAE,IAAI;aAC3B,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACM,SAAS;QAChB,OAAO,IAAI,CAAC,MAAe,CAAC;IAC9B,CAAC;CACF;AAzDD,kCAyDC"}

package/dist/utilities/crypto.utility.d.ts

@@ -1,4 +1,32 @@
 import C from 'node:crypto';
+/**
+ * Generates cryptographic hashes using specified algorithm
+ * Supports HMAC-SHA256 and MD5 hashing
+ *
+ * @param text - Text to hash
+ * @param options - Hash configuration
+ * @param options.algorithm - Algorithm: 'SHA256' or 'MD5'
+ * @param options.secret - Secret key for HMAC-SHA256 (optional)
+ * @param options.outputType - Output encoding format (hex, base64, base64url)
+ * @returns Hashed string in specified format
+ *
+ * @example
+ * // SHA256 with HMAC
+ * const hashed = hash('password', {
+ *   algorithm: 'SHA256',
+ *   secret: 'my-secret-key',
+ *   outputType: 'hex'
+ * }); // "a1b2c3..."
+ *
+ * @example
+ * // MD5 hash
+ * const md5 = hash('text', {
+ *   algorithm: 'MD5',
+ *   outputType: 'hex'
+ * }); // "5d41402abc4b2a76b9719d911017c592"
+ *
+ * @throws No explicit errors, invalid algorithms return original text
+ */
 export declare const hash: (text: string, options: {
     algorithm: "SHA256" | "MD5";
     secret?: string;

package/dist/utilities/crypto.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crypto.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/crypto.utility.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,aAAa,CAAC;AAE5B,eAAO,MAAM,IAAI,GACf,MAAM,MAAM,EACZ,SAAS;IACP,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,CAAC,oBAAoB,CAAC;CACpC,KACA,MAkBF,CAAC"}
+{"version":3,"file":"crypto.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/crypto.utility.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,aAAa,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,IAAI,GACf,MAAM,MAAM,EACZ,SAAS;IACP,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,CAAC,oBAAoB,CAAC;CACpC,KACA,MAkBF,CAAC"}

package/dist/utilities/crypto.utility.js

@@ -5,6 +5,34 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hash = void 0;
 const node_crypto_1 = __importDefault(require("node:crypto"));
+/**
+ * Generates cryptographic hashes using specified algorithm
+ * Supports HMAC-SHA256 and MD5 hashing
+ *
+ * @param text - Text to hash
+ * @param options - Hash configuration
+ * @param options.algorithm - Algorithm: 'SHA256' or 'MD5'
+ * @param options.secret - Secret key for HMAC-SHA256 (optional)
+ * @param options.outputType - Output encoding format (hex, base64, base64url)
+ * @returns Hashed string in specified format
+ *
+ * @example
+ * // SHA256 with HMAC
+ * const hashed = hash('password', {
+ *   algorithm: 'SHA256',
+ *   secret: 'my-secret-key',
+ *   outputType: 'hex'
+ * }); // "a1b2c3..."
+ *
+ * @example
+ * // MD5 hash
+ * const md5 = hash('text', {
+ *   algorithm: 'MD5',
+ *   outputType: 'hex'
+ * }); // "5d41402abc4b2a76b9719d911017c592"
+ *
+ * @throws No explicit errors, invalid algorithms return original text
+ */
 const hash = (text, options) => {
     const { algorithm, secret, outputType } = options;
     switch (algorithm) {

package/dist/utilities/crypto.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"crypto.utility.js","sourceRoot":"","sources":["../../src/utilities/crypto.utility.ts"],"names":[],"mappings":";;;;;;AAAA,8DAA4B;AAErB,MAAM,IAAI,GAAG,CAClB,IAAY,EACZ,OAIC,EACO,EAAE;IACV,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAElD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,qBAAC,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACzE,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,OAAO,qBAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAzBW,QAAA,IAAI,QAyBf"}
+{"version":3,"file":"crypto.utility.js","sourceRoot":"","sources":["../../src/utilities/crypto.utility.ts"],"names":[],"mappings":";;;;;;AAAA,8DAA4B;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACI,MAAM,IAAI,GAAG,CAClB,IAAY,EACZ,OAIC,EACO,EAAE;IACV,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAElD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,qBAAC,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACzE,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,OAAO,qBAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAzBW,QAAA,IAAI,QAyBf"}

package/dist/utilities/date.utility.d.ts

@@ -1,18 +1,75 @@
 import dayjs from 'dayjs';
+/**
+ * Delays execution for specified milliseconds
+ * @param ms - Delay duration in milliseconds
+ * @returns Promise that resolves after delay
+ * @example
+ * await sleep(1000); // Wait 1 second
+ */
 export declare const sleep: (ms: number) => Promise<unknown>;
+/**
+ * Checks if a given date is a weekday (Monday-Friday)
+ * @param date - Date to check (ISO string or dayjs object)
+ * @returns True if date is a weekday
+ * @example
+ * isWeekday('2024-01-15') // true (Monday)
+ * isWeekday('2024-01-20') // false (Saturday)
+ */
 export declare const isWeekday: (date: string | dayjs.Dayjs) => boolean;
+/**
+ * Gets the previous weekday from a given date
+ * Skips weekends (Saturday and Sunday)
+ * @param opts - Configuration options
+ * @param opts.date - Starting date (default: today)
+ * @returns dayjs object of previous weekday
+ * @example
+ * getPreviousWeekday({ date: '2024-01-15' }) // Monday 2024-01-15 -> Friday 2024-01-12
+ */
 export declare const getPreviousWeekday: (opts?: {
     date?: string | dayjs.Dayjs;
 }) => dayjs.Dayjs;
+/**
+ * Gets the next weekday from a given date
+ * Skips weekends (Saturday and Sunday)
+ * @param opts - Configuration options
+ * @param opts.date - Starting date (default: today)
+ * @returns dayjs object of next weekday
+ * @example
+ * getNextWeekday({ date: '2024-01-12' }) // Friday 2024-01-12 -> Monday 2024-01-15
+ */
 export declare const getNextWeekday: (opts?: {
     date?: string | dayjs.Dayjs;
 }) => dayjs.Dayjs;
+/**
+ * Gets a date adjusted to specific timezone with optional offset
+ * @param opts - Configuration options
+ * @param opts.date - Input date string
+ * @param opts.timezone - Target timezone (e.g., 'America/New_York')
+ * @param opts.useClientTz - Use client timezone (default: false)
+ * @param opts.timeOffset - Hours to add/subtract (default: 0)
+ * @returns dayjs object in target timezone
+ * @example
+ * getDateTz({
+ *   date: '2024-01-15T10:00:00Z',
+ *   timezone: 'America/New_York',
+ *   timeOffset: -5
+ * })
+ */
 export declare const getDateTz: (opts: {
     date: string;
     timezone: string;
     useClientTz?: boolean;
     timeOffset?: number;
 }) => dayjs.Dayjs;
+/**
+ * Gets high-resolution time in seconds with nanosecond precision
+ * Useful for performance measurements
+ * @returns Current time as float (seconds.nanoseconds)
+ * @example
+ * const start = hrTime();
+ * // ... do something ...
+ * const elapsed = hrTime() - start; // Time in seconds
+ */
 export declare const hrTime: () => number;
 export { dayjs };
 //# sourceMappingURL=date.utility.d.ts.map

package/dist/utilities/date.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/date.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAkB1B,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBAE/B,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,YAGnD,CAAC;AAWF,eAAO,MAAM,kBAAkB,GAAI,OAAO;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAAA;CAAE,gBASxE,CAAC;AAWF,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAAA;CAAE,gBASpE,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,gBAGA,CAAC;AAEF,eAAO,MAAM,MAAM,cAGlB,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"date.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/date.utility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAmB1B;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBAE/B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,YAGnD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAAA;CAAE,gBASxE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAAA;CAAE,gBASpE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,gBAGA,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,cAGlB,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/utilities/date.utility.js

@@ -12,6 +12,7 @@ const timezone_1 = __importDefault(require("dayjs/plugin/timezone"));
 const utc_1 = __importDefault(require("dayjs/plugin/utc"));
 const weekday_1 = __importDefault(require("dayjs/plugin/weekday"));
 const parse_utility_1 = require("./parse.utility");
+// Initialize dayjs plugins for comprehensive date/time functionality
 dayjs_1.default.extend(customParseFormat_1.default);
 dayjs_1.default.extend(utc_1.default);
 dayjs_1.default.extend(timezone_1.default);
@@ -19,23 +20,39 @@ dayjs_1.default.extend(weekday_1.default);
 dayjs_1.default.extend(isoWeek_1.default);
 const tz = process.env.APP_ENV_APPLICATION_TIMEZONE ?? 'Asia/Ho_Chi_Minh';
 dayjs_1.default.tz.setDefault(tz);
+/**
+ * Delays execution for specified milliseconds
+ * @param ms - Delay duration in milliseconds
+ * @returns Promise that resolves after delay
+ * @example
+ * await sleep(1000); // Wait 1 second
+ */
 const sleep = (ms) => {
     return new Promise(resolve => setTimeout(resolve, ms));
 };
 exports.sleep = sleep;
+/**
+ * Checks if a given date is a weekday (Monday-Friday)
+ * @param date - Date to check (ISO string or dayjs object)
+ * @returns True if date is a weekday
+ * @example
+ * isWeekday('2024-01-15') // true (Monday)
+ * isWeekday('2024-01-20') // false (Saturday)
+ */
 const isWeekday = (date) => {
     const isoWeekday = (0, dayjs_1.default)(date)?.isoWeekday();
     return isoWeekday > 0 && isoWeekday < 6;
 };
 exports.isWeekday = isWeekday;
-/* export const getPreviousWeekday = () => {
-  let date = dayjs();
-  while (!isWeekday(date)) {
-    date = date.subtract(1, 'day');
-  }
-
-  return date;
-}; */
+/**
+ * Gets the previous weekday from a given date
+ * Skips weekends (Saturday and Sunday)
+ * @param opts - Configuration options
+ * @param opts.date - Starting date (default: today)
+ * @returns dayjs object of previous weekday
+ * @example
+ * getPreviousWeekday({ date: '2024-01-15' }) // Monday 2024-01-15 -> Friday 2024-01-12
+ */
 const getPreviousWeekday = (opts) => {
     const { date } = opts ?? { date: (0, dayjs_1.default)() };
     let rs = (0, dayjs_1.default)(date).clone().subtract(1, 'day');
@@ -45,14 +62,15 @@ const getPreviousWeekday = (opts) => {
     return rs;
 };
 exports.getPreviousWeekday = getPreviousWeekday;
-/* export const getNextWeekday = () => {
-  let date = dayjs();
-  while (!isWeekday(date)) {
-    date = date.add(1, 'day');
-  }
-
-  return date;
-}; */
+/**
+ * Gets the next weekday from a given date
+ * Skips weekends (Saturday and Sunday)
+ * @param opts - Configuration options
+ * @param opts.date - Starting date (default: today)
+ * @returns dayjs object of next weekday
+ * @example
+ * getNextWeekday({ date: '2024-01-12' }) // Friday 2024-01-12 -> Monday 2024-01-15
+ */
 const getNextWeekday = (opts) => {
     const { date } = opts ?? { date: (0, dayjs_1.default)() };
     let rs = (0, dayjs_1.default)(date).clone().add(1, 'day');
@@ -62,11 +80,35 @@ const getNextWeekday = (opts) => {
     return rs;
 };
 exports.getNextWeekday = getNextWeekday;
+/**
+ * Gets a date adjusted to specific timezone with optional offset
+ * @param opts - Configuration options
+ * @param opts.date - Input date string
+ * @param opts.timezone - Target timezone (e.g., 'America/New_York')
+ * @param opts.useClientTz - Use client timezone (default: false)
+ * @param opts.timeOffset - Hours to add/subtract (default: 0)
+ * @returns dayjs object in target timezone
+ * @example
+ * getDateTz({
+ *   date: '2024-01-15T10:00:00Z',
+ *   timezone: 'America/New_York',
+ *   timeOffset: -5
+ * })
+ */
 const getDateTz = (opts) => {
     const { date, timezone, useClientTz = false, timeOffset = 0 } = opts;
     return (0, dayjs_1.default)(date).tz(timezone, useClientTz).add(timeOffset, 'hour');
 };
 exports.getDateTz = getDateTz;
+/**
+ * Gets high-resolution time in seconds with nanosecond precision
+ * Useful for performance measurements
+ * @returns Current time as float (seconds.nanoseconds)
+ * @example
+ * const start = hrTime();
+ * // ... do something ...
+ * const elapsed = hrTime() - start; // Time in seconds
+ */
 const hrTime = () => {
     const curr = process.hrtime();
     return (0, parse_utility_1.float)(curr[0] + curr[1] / 10 ** 9, 9);

package/dist/utilities/date.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.utility.js","sourceRoot":"","sources":["../../src/utilities/date.utility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"date.utility.js","sourceRoot":"","sources":["../../src/utilities/date.utility.ts"],"names":[],"mappings":"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"}

package/dist/utilities/error.utility.d.ts

@@ -1,15 +1,78 @@
+/**
+ * Enhanced application error class with comprehensive error tracking
+ * @class ApplicationError
+ * @extends Error
+ * @example
+ * throw new ApplicationError({
+ *   statusCode: 500,
+ *   messageCode: 'DATABASE_ERROR',
+ *   message: 'Failed to connect to database',
+ *   context: { dbName: 'users' },
+ *   originalError: err
+ * });
+ */
 export declare class ApplicationError extends Error {
     statusCode: number;
     messageCode?: string;
+    timestamp: Date;
+    context?: Record<string, any>;
+    originalError?: Error;
+    correlationId?: string;
     constructor(opts: {
         statusCode?: number;
         messageCode?: string;
         message: string;
+        context?: Record<string, any>;
+        originalError?: Error;
+        correlationId?: string;
     });
+    /**
+     * Serialize error to JSON format for logging/response
+     */
+    toJSON(): {
+        message: string;
+        statusCode: number;
+        messageCode: string | undefined;
+        timestamp: string;
+        context: Record<string, any> | undefined;
+        correlationId: string | undefined;
+    };
+}
+/**
+ * Error for not-implemented methods
+ * @class NotImplementedError
+ * @extends ApplicationError
+ */
+export declare class NotImplementedError extends ApplicationError {
+    /**
+     * @param methodName - Name of the not-implemented method
+     * @param context - Additional context information
+     */
+    constructor(methodName: string, context?: Record<string, any>);
+}
+/**
+ * Error for validation failures
+ * @class ValidationError
+ * @extends ApplicationError
+ */
+export declare class ValidationError extends ApplicationError {
+    /**
+     * @param message - Error message
+     * @param context - Validation context with field errors
+     */
+    constructor(message: string, context?: Record<string, any>);
 }
+/**
+ * Factory function to create ApplicationError instances
+ * @param opts - Error configuration options
+ * @returns ApplicationError instance
+ */
 export declare const getError: (opts: {
     statusCode?: number;
     messageCode?: string;
     message: string;
+    context?: Record<string, any>;
+    originalError?: Error;
+    correlationId?: string;
 }) => ApplicationError;
 //# sourceMappingURL=error.utility.d.ts.map

package/dist/utilities/error.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/error.utility.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAOjF;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,qBAG5F,CAAC"}
+{"version":3,"file":"error.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/error.utility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,aAAa,CAAC,EAAE,KAAK,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAeD;;OAEG;IACH,MAAM;;;;;;;;CAUP;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD;;;OAGG;gBACS,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAS9D;AAED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAS3D;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,qBAEA,CAAC"}

package/dist/utilities/error.utility.js

@@ -1,18 +1,96 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getError = exports.ApplicationError = void 0;
+exports.getError = exports.ValidationError = exports.NotImplementedError = exports.ApplicationError = void 0;
+/**
+ * Enhanced application error class with comprehensive error tracking
+ * @class ApplicationError
+ * @extends Error
+ * @example
+ * throw new ApplicationError({
+ *   statusCode: 500,
+ *   messageCode: 'DATABASE_ERROR',
+ *   message: 'Failed to connect to database',
+ *   context: { dbName: 'users' },
+ *   originalError: err
+ * });
+ */
 class ApplicationError extends Error {
     constructor(opts) {
-        const { message, messageCode, statusCode = 400 } = opts;
+        const { message, messageCode, statusCode = 400, context, originalError, correlationId } = opts;
         super(message);
         this.statusCode = statusCode;
         this.messageCode = messageCode;
+        this.context = context;
+        this.originalError = originalError;
+        this.correlationId = correlationId;
+        this.timestamp = new Date();
+        // Maintain proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, ApplicationError.prototype);
+    }
+    /**
+     * Serialize error to JSON format for logging/response
+     */
+    toJSON() {
+        return {
+            message: this.message,
+            statusCode: this.statusCode,
+            messageCode: this.messageCode,
+            timestamp: this.timestamp.toISOString(),
+            context: this.context,
+            correlationId: this.correlationId,
+        };
     }
 }
 exports.ApplicationError = ApplicationError;
+/**
+ * Error for not-implemented methods
+ * @class NotImplementedError
+ * @extends ApplicationError
+ */
+class NotImplementedError extends ApplicationError {
+    /**
+     * @param methodName - Name of the not-implemented method
+     * @param context - Additional context information
+     */
+    constructor(methodName, context) {
+        super({
+            statusCode: 501,
+            messageCode: 'METHOD_NOT_IMPLEMENTED',
+            message: `Method '${methodName}' is not implemented.`,
+            context,
+        });
+        Object.setPrototypeOf(this, NotImplementedError.prototype);
+    }
+}
+exports.NotImplementedError = NotImplementedError;
+/**
+ * Error for validation failures
+ * @class ValidationError
+ * @extends ApplicationError
+ */
+class ValidationError extends ApplicationError {
+    /**
+     * @param message - Error message
+     * @param context - Validation context with field errors
+     */
+    constructor(message, context) {
+        super({
+            statusCode: 400,
+            messageCode: 'VALIDATION_ERROR',
+            message,
+            context,
+        });
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Factory function to create ApplicationError instances
+ * @param opts - Error configuration options
+ * @returns ApplicationError instance
+ */
 const getError = (opts) => {
-    const error = new ApplicationError(opts);
-    return error;
+    return new ApplicationError(opts);
 };
 exports.getError = getError;
 //# sourceMappingURL=error.utility.js.map

package/dist/utilities/error.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.utility.js","sourceRoot":"","sources":["../../src/utilities/error.utility.ts"],"names":[],"mappings":";;;AAAA,MAAa,gBAAiB,SAAQ,KAAK;IAIzC,YAAY,IAAoE;QAC9E,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAXD,4CAWC;AAEM,MAAM,QAAQ,GAAG,CAAC,IAAoE,EAAE,EAAE;IAC/F,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAHW,QAAA,QAAQ,YAGnB"}
+{"version":3,"file":"error.utility.js","sourceRoot":"","sources":["../../src/utilities/error.utility.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAQzC,YAAY,IAOX;QACC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,GAAG,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;QAC/F,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC;IACJ,CAAC;CACF;AA3CD,4CA2CC;AAED;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,gBAAgB;IACvD;;;OAGG;IACH,YAAY,UAAkB,EAAE,OAA6B;QAC3D,KAAK,CAAC;YACJ,UAAU,EAAE,GAAG;YACf,WAAW,EAAE,wBAAwB;YACrC,OAAO,EAAE,WAAW,UAAU,uBAAuB;YACrD,OAAO;SACR,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AAdD,kDAcC;AAED;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACnD;;;OAGG;IACH,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC;YACJ,UAAU,EAAE,GAAG;YACf,WAAW,EAAE,kBAAkB;YAC/B,OAAO;YACP,OAAO;SACR,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAdD,0CAcC;AAED;;;;GAIG;AACI,MAAM,QAAQ,GAAG,CAAC,IAOxB,EAAE,EAAE;IACH,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC;AATW,QAAA,QAAQ,YASnB"}

package/dist/utilities/lodash.utility.d.ts

@@ -1,3 +1,4 @@
 export { default as get } from 'lodash/get';
 export { default as set } from 'lodash/set';
+export { default as isEmpty } from 'lodash/isEmpty';
 //# sourceMappingURL=lodash.utility.d.ts.map

package/dist/utilities/lodash.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lodash.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/lodash.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"lodash.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/lodash.utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/utilities/lodash.utility.js

@@ -3,9 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.set = exports.get = void 0;
+exports.isEmpty = exports.set = exports.get = void 0;
 var get_1 = require("lodash/get");
 Object.defineProperty(exports, "get", { enumerable: true, get: function () { return __importDefault(get_1).default; } });
 var set_1 = require("lodash/set");
 Object.defineProperty(exports, "set", { enumerable: true, get: function () { return __importDefault(set_1).default; } });
+var isEmpty_1 = require("lodash/isEmpty");
+Object.defineProperty(exports, "isEmpty", { enumerable: true, get: function () { return __importDefault(isEmpty_1).default; } });
 //# sourceMappingURL=lodash.utility.js.map

package/dist/utilities/lodash.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"lodash.utility.js","sourceRoot":"","sources":["../../src/utilities/lodash.utility.ts"],"names":[],"mappings":";;;;;;AAAA,kCAA4C;AAAnC,2GAAA,OAAO,OAAO;AACvB,kCAA4C;AAAnC,2GAAA,OAAO,OAAO"}
+{"version":3,"file":"lodash.utility.js","sourceRoot":"","sources":["../../src/utilities/lodash.utility.ts"],"names":[],"mappings":";;;;;;AAAA,kCAA4C;AAAnC,2GAAA,OAAO,OAAO;AACvB,kCAA4C;AAAnC,2GAAA,OAAO,OAAO;AACvB,0CAAoD;AAA3C,mHAAA,OAAO,OAAW"}

package/dist/utilities/model.utility.d.ts

@@ -1,8 +1,23 @@
 import { SchemaObject } from '@loopback/rest';
 import { BaseEntity, BaseIdEntity } from '../base/models/base.model';
+/**
+ * Extracts the JSON schema of the ID property from a LoopBack entity
+ * @param entity - The LoopBack entity class (must extend BaseEntity)
+ * @returns The SchemaObject representing the ID property
+ * @example
+ * const schema = getIdSchema(User);
+ * // { type: 'number', minimum: 1 }
+ */
 export declare const getIdSchema: <E extends BaseEntity>(entity: typeof BaseEntity & {
     prototype: E;
 }) => SchemaObject;
+/**
+ * Inspects the metadata of a LoopBack entity to determine the ID type
+ * @param entity - The LoopBack entity class
+ * @returns 'string' or 'number' (default: 'number')
+ * @example
+ * const type = getIdType(User); // 'number'
+ */
 export declare const getIdType: <E extends BaseEntity>(entity: typeof BaseIdEntity & {
     prototype: E;
 }) => "string" | "number";

package/dist/utilities/model.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/model.utility.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGpE,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,UAAU,EAC9C,QAAQ,OAAO,UAAU,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,KAC3C,YAIF,CAAC;AAGF,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,UAAU,EAC5C,QAAQ,OAAO,YAAY,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,KAC7C,QAAQ,GAAG,QAoBb,CAAC"}
+{"version":3,"file":"model.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/model.utility.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,UAAU,EAC9C,QAAQ,OAAO,UAAU,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,KAC3C,YAIF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,UAAU,EAC5C,QAAQ,OAAO,YAAY,GAAG;IAAE,SAAS,EAAE,CAAC,CAAA;CAAE,KAC7C,QAAQ,GAAG,QAoBb,CAAC"}

package/dist/utilities/model.utility.js

@@ -3,14 +3,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getIdType = exports.getIdSchema = void 0;
 const metadata_1 = require("@loopback/metadata");
 const rest_1 = require("@loopback/rest");
-// --------------------------------------------------------------------------------------------------------------
+/**
+ * Extracts the JSON schema of the ID property from a LoopBack entity
+ * @param entity - The LoopBack entity class (must extend BaseEntity)
+ * @returns The SchemaObject representing the ID property
+ * @example
+ * const schema = getIdSchema(User);
+ * // { type: 'number', minimum: 1 }
+ */
 const getIdSchema = (entity) => {
     const idProp = entity.getIdProperties()[0];
     const modelSchema = (0, rest_1.jsonToSchemaObject)((0, rest_1.getJsonSchema)(entity));
     return modelSchema.properties?.[idProp];
 };
 exports.getIdSchema = getIdSchema;
-// --------------------------------------------------------------------------------------------------------------
+/**
+ * Inspects the metadata of a LoopBack entity to determine the ID type
+ * @param entity - The LoopBack entity class
+ * @returns 'string' or 'number' (default: 'number')
+ * @example
+ * const type = getIdType(User); // 'number'
+ */
 const getIdType = (entity) => {
     let idType = 'number';
     try {

package/dist/utilities/model.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.utility.js","sourceRoot":"","sources":["../../src/utilities/model.utility.ts"],"names":[],"mappings":";;;AAAA,iDAAuD;AACvD,yCAAiF;AAIjF,iHAAiH;AAC1G,MAAM,WAAW,GAAG,CACzB,MAA4C,EAC9B,EAAE;IAChB,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAA,yBAAkB,EAAC,IAAA,oBAAa,EAAC,MAAM,CAAC,CAAiB,CAAC;IAC9E,OAAO,WAAW,CAAC,UAAU,EAAE,CAAC,MAAM,CAAiB,CAAC;AAC1D,CAAC,CAAC;AANW,QAAA,WAAW,eAMtB;AAEF,iHAAiH;AAC1G,MAAM,SAAS,GAAG,CACvB,MAA8C,EACzB,EAAE;IACvB,IAAI,MAAM,GAAwB,QAAQ,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,4BAAiB,CAAC,mBAAmB,CAErD,2BAA2B,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAE9C,MAAM,GAAG,UAAU,EAAE,IAAI,IAAI,QAAQ,CAAC;IACxC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,iFAAiF,EACjF,CAAC,CACF,CAAC;QAEF,MAAM,GAAG,QAAQ,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAtBW,QAAA,SAAS,aAsBpB"}
+{"version":3,"file":"model.utility.js","sourceRoot":"","sources":["../../src/utilities/model.utility.ts"],"names":[],"mappings":";;;AAAA,iDAAuD;AACvD,yCAAiF;AAIjF;;;;;;;GAOG;AACI,MAAM,WAAW,GAAG,CACzB,MAA4C,EAC9B,EAAE;IAChB,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAA,yBAAkB,EAAC,IAAA,oBAAa,EAAC,MAAM,CAAC,CAAiB,CAAC;IAC9E,OAAO,WAAW,CAAC,UAAU,EAAE,CAAC,MAAM,CAAiB,CAAC;AAC1D,CAAC,CAAC;AANW,QAAA,WAAW,eAMtB;AAEF;;;;;;GAMG;AACI,MAAM,SAAS,GAAG,CACvB,MAA8C,EACzB,EAAE;IACvB,IAAI,MAAM,GAAwB,QAAQ,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,4BAAiB,CAAC,mBAAmB,CAErD,2BAA2B,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAE9C,MAAM,GAAG,UAAU,EAAE,IAAI,IAAI,QAAQ,CAAC;IACxC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACX,iFAAiF,EACjF,CAAC,CACF,CAAC;QAEF,MAAM,GAAG,QAAQ,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAtBW,QAAA,SAAS,aAsBpB"}