@rsdk/common 5.7.0-next.2 → 6.0.0-next.0

package/dist/functions/obj-normalization.d.ts

@@ -8,15 +8,42 @@ export interface NormalizeOptions {
     maxDepth?: number;
 }
 /**
- * Prepares object to be stringified with JSON.stringify()
- * - removes circular references.
- * - makes message, stack and cause properties of Errors enumerable
- * - (optional) sorts error keys for human readability
- * - (optional) filters out provided keys
+ * Creates a function that prepares objects for JSON.stringify().
  *
- * NOTE: Function is recursive
+ * This is a higher-order function that creates a closure over a cache Set.
+ * The cache is used to detect circular references during normalization.
+ * Each call to normalizer() creates a new cache, ensuring thread-safety
+ * and preventing memory leaks between different normalization operations.
  *
- * @returns unknown
+ * Features:
+ * - Removes circular references (replaces with '[circular]')
+ * - Makes Error properties (message, stack, cause) enumerable
+ * - Handles special types:
+ *   - Buffer -> '[Buffer size]'
+ *   - ArrayBuffer -> '[ArrayBuffer size]'
+ *   - Map -> '[Map size]'
+ *   - Set -> '[Set size]'
+ * - Limits object nesting depth (default: 10)
+ * - Protects against large objects (>16M keys)
+ *
+ * @example
+ * // Create two independent normalizers
+ * const normalizer1 = normalizer();
+ * const normalizer2 = normalizer();
+ *
+ * // Each normalizer has its own circular reference cache
+ * const obj1 = { circular: {} };
+ * obj1.circular = obj1;
+ * normalizer1(obj1); // Safe: uses first cache
+ * normalizer2(obj1); // Safe: uses second cache
+ *
+ * @returns A normalization function with its own circular reference cache that accepts:
+ *   @param x - Value to normalize
+ *   @param options - Normalization options:
+ *     - filterKeys: Array of keys to exclude
+ *     - sortKeys: Custom key sorting configuration
+ *     - maxDepth: Maximum nesting depth (default: 10)
+ *   @param depth - Current recursion depth (internal use)
  */
 export declare const normalizer: () => ((x: unknown, options?: NormalizeOptions, depth?: number) => unknown);
 /**

package/dist/functions/obj-normalization.js

@@ -4,15 +4,42 @@ exports.sortErrorKeys = exports.normalizer = void 0;
 const serializable_type_1 = require("./serializable.type");
 const DEFAULT_MAX_DEPTH = 10;
 /**
- * Prepares object to be stringified with JSON.stringify()
- * - removes circular references.
- * - makes message, stack and cause properties of Errors enumerable
- * - (optional) sorts error keys for human readability
- * - (optional) filters out provided keys
+ * Creates a function that prepares objects for JSON.stringify().
  *
- * NOTE: Function is recursive
+ * This is a higher-order function that creates a closure over a cache Set.
+ * The cache is used to detect circular references during normalization.
+ * Each call to normalizer() creates a new cache, ensuring thread-safety
+ * and preventing memory leaks between different normalization operations.
  *
- * @returns unknown
+ * Features:
+ * - Removes circular references (replaces with '[circular]')
+ * - Makes Error properties (message, stack, cause) enumerable
+ * - Handles special types:
+ *   - Buffer -> '[Buffer size]'
+ *   - ArrayBuffer -> '[ArrayBuffer size]'
+ *   - Map -> '[Map size]'
+ *   - Set -> '[Set size]'
+ * - Limits object nesting depth (default: 10)
+ * - Protects against large objects (>16M keys)
+ *
+ * @example
+ * // Create two independent normalizers
+ * const normalizer1 = normalizer();
+ * const normalizer2 = normalizer();
+ *
+ * // Each normalizer has its own circular reference cache
+ * const obj1 = { circular: {} };
+ * obj1.circular = obj1;
+ * normalizer1(obj1); // Safe: uses first cache
+ * normalizer2(obj1); // Safe: uses second cache
+ *
+ * @returns A normalization function with its own circular reference cache that accepts:
+ *   @param x - Value to normalize
+ *   @param options - Normalization options:
+ *     - filterKeys: Array of keys to exclude
+ *     - sortKeys: Custom key sorting configuration
+ *     - maxDepth: Maximum nesting depth (default: 10)
+ *   @param depth - Current recursion depth (internal use)
  */
 const normalizer = () => {
     const cache = new Set();
@@ -31,6 +58,10 @@ const normalizer = () => {
         if (Buffer.isBuffer(xObject)) {
             return `[Buffer ${Buffer.byteLength(xObject)}]`;
         }
+        // Array is not serializable
+        if (xObject instanceof ArrayBuffer) {
+            return `[ArrayBuffer ${xObject.byteLength}]`;
+        }
         // TODO: maybe serialize Map as record/dict
         if (xObject instanceof Map) {
             return `[Map ${xObject.size}]`;

package/dist/functions/obj-normalization.js.map

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

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export * from './functions';
 export * from './size';
 export * from './strings';
 export * from './observable';
+export * from './parsers';

package/dist/index.js

@@ -22,4 +22,5 @@ __exportStar(require("./functions"), exports);
 __exportStar(require("./size"), exports);
 __exportStar(require("./strings"), exports);
 __exportStar(require("./observable"), exports);
+__exportStar(require("./parsers"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,0CAAwB;AACxB,4CAA0B;AAC1B,yCAAuB;AACvB,8CAA4B;AAC5B,yCAAuB;AACvB,4CAA0B;AAC1B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,0CAAwB;AACxB,4CAA0B;AAC1B,yCAAuB;AACvB,8CAA4B;AAC5B,yCAAuB;AACvB,4CAA0B;AAC1B,+CAA6B;AAC7B,4CAA0B"}

package/dist/parsers/array/array.parser.d.ts

@@ -0,0 +1,11 @@
+import type { PropertyParser } from '../parser.interface';
+export declare class ArrayParser<T> implements PropertyParser<T[]> {
+    private readonly singleValueParser;
+    private readonly options;
+    constructor(singleValueParser: PropertyParser<T>, options?: {
+        separator: string;
+    });
+    type(): string;
+    description(): string;
+    parse(value: unknown): T[];
+}

package/dist/parsers/array/array.parser.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayParser = void 0;
+const strings_1 = require("../../strings");
+const types_1 = require("../../types");
+class ArrayParser {
+    singleValueParser;
+    options;
+    constructor(singleValueParser, options = { separator: ',' }) {
+        this.singleValueParser = singleValueParser;
+        this.options = options;
+    }
+    type() {
+        return `(array)${this.singleValueParser.type()}`;
+    }
+    description() {
+        return (0, strings_1.text) `
+      Extracts array of values. If raw value is a string
+      <${this.options.separator}> will used as separator. Each value:
+      ${this.singleValueParser.description()}
+    `;
+    }
+    parse(value) {
+        if (Array.isArray(value)) {
+            return value.map((x) => this.singleValueParser.parse(x));
+        }
+        types_1.Assert.isString(value);
+        return value
+            .split(this.options.separator)
+            .map((x) => this.singleValueParser.parse(x));
+    }
+}
+exports.ArrayParser = ArrayParser;
+//# sourceMappingURL=array.parser.js.map

package/dist/parsers/array/array.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.parser.js","sourceRoot":"","sources":["../../../src/parsers/array/array.parser.ts"],"names":[],"mappings":";;;AAAA,2CAAqC;AACrC,uCAAqC;AAGrC,MAAa,WAAW;IAEH;IACA;IAFnB,YACmB,iBAAoC,EACpC,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE;QAD5B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,YAAO,GAAP,OAAO,CAAqB;IAC5C,CAAC;IAEJ,IAAI;QACF,OAAO,UAAU,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;IACnD,CAAC;IAED,WAAW;QACT,OAAO,IAAA,cAAI,EAAA;;SAEN,IAAI,CAAC,OAAO,CAAC,SAAS;QACvB,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE;KACvC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,cAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEvB,OAAO,KAAK;aACT,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;aAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;CACF;AA7BD,kCA6BC"}

package/dist/parsers/array/index.d.ts

@@ -0,0 +1 @@
+export * from './array.parser';

package/dist/parsers/array/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./array.parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parsers/array/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parsers/array/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/parsers/boolean/bool.parser.d.ts

@@ -0,0 +1,6 @@
+import type { PropertyParser } from '../parser.interface';
+export declare class BoolParser implements PropertyParser<boolean> {
+    type(): string;
+    description(): string;
+    parse(value: unknown): boolean;
+}

package/dist/parsers/boolean/bool.parser.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoolParser = void 0;
+const convert_1 = require("../../convert");
+const strings_1 = require("../../strings");
+class BoolParser {
+    type() {
+        return 'boolean';
+    }
+    description() {
+        return (0, strings_1.text) `
+      Extracts boolean value. Any boolean value or strings
+      'true' and 'false' will pass.
+    `;
+    }
+    parse(value) {
+        return convert_1.Convert.boolean(value);
+    }
+}
+exports.BoolParser = BoolParser;
+//# sourceMappingURL=bool.parser.js.map

package/dist/parsers/boolean/bool.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bool.parser.js","sourceRoot":"","sources":["../../../src/parsers/boolean/bool.parser.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,2CAAqC;AAGrC,MAAa,UAAU;IACrB,IAAI;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,WAAW;QACT,OAAO,IAAA,cAAI,EAAA;;;KAGV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,OAAO,iBAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF;AAfD,gCAeC"}

package/dist/parsers/boolean/index.d.ts

@@ -0,0 +1 @@
+export * from './bool.parser';

package/dist/parsers/boolean/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./bool.parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parsers/boolean/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parsers/boolean/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/parsers/enum/enum.parser.d.ts

@@ -0,0 +1,9 @@
+import type { EnumLike, EnumValue } from '../../enums';
+import type { PropertyParser } from '../parser.interface';
+export declare class EnumParser<E extends EnumValue> implements PropertyParser<E> {
+    private readonly enumeration;
+    constructor(enumeration: EnumLike);
+    type(): string;
+    description(): string;
+    parse(value: unknown): E;
+}

package/dist/parsers/enum/enum.parser.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnumParser = void 0;
+const convert_1 = require("../../convert");
+const enums_1 = require("../../enums");
+const strings_1 = require("../../strings");
+class EnumParser {
+    enumeration;
+    constructor(enumeration) {
+        this.enumeration = enumeration;
+    }
+    type() {
+        return `string|number(enum_value)`;
+    }
+    description() {
+        return (0, strings_1.text) `
+      Extracts strings or numbers and ensures it is one of:
+      ${enums_1.Enum.values(this.enumeration).join(', ')}
+    `;
+    }
+    parse(value) {
+        return convert_1.Convert.enum(value, this.enumeration);
+    }
+}
+exports.EnumParser = EnumParser;
+//# sourceMappingURL=enum.parser.js.map

package/dist/parsers/enum/enum.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum.parser.js","sourceRoot":"","sources":["../../../src/parsers/enum/enum.parser.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC,uCAAmC;AACnC,2CAAqC;AAGrC,MAAa,UAAU;IACQ;IAA7B,YAA6B,WAAqB;QAArB,gBAAW,GAAX,WAAW,CAAU;IAAG,CAAC;IAEtD,IAAI;QACF,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,WAAW;QACT,OAAO,IAAA,cAAI,EAAA;;QAEP,YAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KAC3C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,OAAO,iBAAO,CAAC,IAAI,CAAI,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAjBD,gCAiBC"}

package/dist/parsers/enum/index.d.ts

@@ -0,0 +1 @@
+export * from './enum.parser';

package/dist/parsers/enum/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enum.parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parsers/enum/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parsers/enum/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/parsers/index.d.ts

@@ -0,0 +1,11 @@
+export * from './boolean';
+export * from './enum';
+export * from './int';
+export * from './number';
+export * from './size';
+export * from './string';
+export * from './timespan';
+export * from './url';
+export * from './array';
+export * from './json';
+export * from './parser.interface';

package/dist/parsers/index.js

@@ -0,0 +1,28 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./boolean"), exports);
+__exportStar(require("./enum"), exports);
+__exportStar(require("./int"), exports);
+__exportStar(require("./number"), exports);
+__exportStar(require("./size"), exports);
+__exportStar(require("./string"), exports);
+__exportStar(require("./timespan"), exports);
+__exportStar(require("./url"), exports);
+__exportStar(require("./array"), exports);
+__exportStar(require("./json"), exports);
+__exportStar(require("./parser.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,yCAAuB;AACvB,wCAAsB;AACtB,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,6CAA2B;AAC3B,wCAAsB;AACtB,0CAAwB;AACxB,yCAAuB;AACvB,qDAAmC"}

package/dist/parsers/int/index.d.ts

@@ -0,0 +1 @@
+export * from './int.parser';

package/dist/parsers/int/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./int.parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parsers/int/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parsers/int/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B"}

package/dist/parsers/int/int.parser.d.ts

@@ -0,0 +1,6 @@
+import type { PropertyParser } from '../parser.interface';
+export declare class IntParser implements PropertyParser<number> {
+    type(): string;
+    description(): string;
+    parse(value: unknown): number;
+}

package/dist/parsers/int/int.parser.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntParser = void 0;
+const convert_1 = require("../../convert");
+const strings_1 = require("../../strings");
+class IntParser {
+    type() {
+        return 'number(int)';
+    }
+    description() {
+        return (0, strings_1.text) `
+      Extracts valid integer (uses parseInt under the hood).
+      Floating point numbers, NaN, Infinity will be rejected.
+    `;
+    }
+    parse(value) {
+        return convert_1.Convert.int(value);
+    }
+}
+exports.IntParser = IntParser;
+//# sourceMappingURL=int.parser.js.map

package/dist/parsers/int/int.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"int.parser.js","sourceRoot":"","sources":["../../../src/parsers/int/int.parser.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,2CAAqC;AAGrC,MAAa,SAAS;IACpB,IAAI;QACF,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,WAAW;QACT,OAAO,IAAA,cAAI,EAAA;;;KAGV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,OAAO,iBAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACF;AAfD,8BAeC"}

package/dist/parsers/json/index.d.ts

@@ -0,0 +1 @@
+export * from './json.parser';

package/dist/parsers/json/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./json.parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parsers/json/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parsers/json/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/parsers/json/json.parser.d.ts

@@ -0,0 +1,6 @@
+import type { PropertyParser } from '../parser.interface';
+export declare class JsonParser implements PropertyParser<Record<string, any>> {
+    description(): string;
+    parse(value: string): Record<string, any>;
+    type(): string;
+}

package/dist/parsers/json/json.parser.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonParser = void 0;
+class JsonParser {
+    description() {
+        return 'parse string as json';
+    }
+    parse(value) {
+        return JSON.parse(value);
+    }
+    type() {
+        return 'json';
+    }
+}
+exports.JsonParser = JsonParser;
+//# sourceMappingURL=json.parser.js.map

package/dist/parsers/json/json.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.parser.js","sourceRoot":"","sources":["../../../src/parsers/json/json.parser.ts"],"names":[],"mappings":";;;AAEA,MAAa,UAAU;IACrB,WAAW;QACT,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAZD,gCAYC"}

package/dist/parsers/number/index.d.ts

@@ -0,0 +1 @@
+export * from './number.parser';

package/dist/parsers/number/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./number.parser"), exports);
+//# sourceMappingURL=index.js.map

package/dist/parsers/number/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parsers/number/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC"}

package/dist/parsers/number/number.parser.d.ts

@@ -0,0 +1,6 @@
+import type { PropertyParser } from '../parser.interface';
+export declare class NumberParser implements PropertyParser<number> {
+    type(): string;
+    description(): string;
+    parse(value: unknown): number;
+}

package/dist/parsers/number/number.parser.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumberParser = void 0;
+const convert_1 = require("../../convert");
+const strings_1 = require("../../strings");
+class NumberParser {
+    type() {
+        return 'number';
+    }
+    description() {
+        return (0, strings_1.text) `
+      Extracts numeric value (uses parseFloat under the hood).
+      NaN and Infinity will be rejected.
+
+      NOTE: Use correct decimal delimiter according to locale. See
+      https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Intl
+    `;
+    }
+    parse(value) {
+        return convert_1.Convert.number(value);
+    }
+}
+exports.NumberParser = NumberParser;
+//# sourceMappingURL=number.parser.js.map

package/dist/parsers/number/number.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.parser.js","sourceRoot":"","sources":["../../../src/parsers/number/number.parser.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,2CAAqC;AAGrC,MAAa,YAAY;IACvB,IAAI;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,WAAW;QACT,OAAO,IAAA,cAAI,EAAA;;;;;;KAMV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,OAAO,iBAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF;AAlBD,oCAkBC"}

package/dist/parsers/parser.interface.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Implement this interface to create more parsers.
+ * For example: email, BigInt, guid etc.
+ *
+ * NOTE: In other modules it is more common to define metadata
+ * via decorators. But this case is a bit different.
+ *
+ * 1. Parser implementations can have constructors with parameters
+ * which will affect it's behaviour. It's will be nice to have it
+ * in metadata, and decorators won't provide this.
+ *
+ * 2. Metadata will be extracted via type() and description() methods
+ * mostly during decorator factories (such as @Property()) code is
+ * executed. Thus output **can** be used in autodoc
+ */
+export interface PropertyParser<T = any> {
+    type(): string;
+    description(): string;
+    parse(value: unknown): T;
+}

package/dist/parsers/parser.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=parser.interface.js.map

package/dist/parsers/parser.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.interface.js","sourceRoot":"","sources":["../../src/parsers/parser.interface.ts"],"names":[],"mappings":""}

package/dist/parsers/size/index.d.ts

@@ -0,0 +1 @@
+export * from './size.parser';

package/dist/parsers/size/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./size.parser"), exports);
+//# sourceMappingURL=index.js.map