typia 3.4.22 → 3.4.23

package/src/factories/LiteralFactory.ts

@@ -1,44 +1,44 @@
-import ts from "typescript";
-
-import { IdentifierFactory } from "./IdentifierFactory";
-
-export namespace LiteralFactory {
-    export function generate(input: any): ts.Expression {
-        if (input === null) return ts.factory.createNull();
-        else if (ts.isIdentifier(input)) return input;
-        else if (input instanceof Array) return generate_array(input);
-        else if (typeof input === "object") return generate_object(input);
-        else if (typeof input === "string") return generate_string(input);
-        else if (typeof input === "boolean") return generate_value(input);
-        else if (typeof input === "number") return generate_value(input);
-        else if (typeof input === "bigint") return generate_value(input);
-        else throw new Error("Unknown type.");
-    }
-
-    function generate_object(obj: object): ts.ObjectLiteralExpression {
-        const properties = Object.entries(obj)
-            .filter((tuple) => tuple[1] !== undefined)
-            .map(([key, value]) =>
-                ts.factory.createPropertyAssignment(
-                    IdentifierFactory.generate(key),
-                    generate(value),
-                ),
-            );
-        return ts.factory.createObjectLiteralExpression(properties, true);
-    }
-
-    function generate_array(array: any[]): ts.ArrayLiteralExpression {
-        return ts.factory.createArrayLiteralExpression(
-            array.map(generate),
-            true,
-        );
-    }
-
-    function generate_value(value: number | boolean | bigint): ts.Identifier {
-        return ts.factory.createIdentifier(value.toString());
-    }
-
-    function generate_string(value: string): ts.StringLiteral {
-        return ts.factory.createStringLiteral(value);
-    }
-}
+import ts from "typescript";
+
+import { IdentifierFactory } from "./IdentifierFactory";
+
+export namespace LiteralFactory {
+    export function generate(input: any): ts.Expression {
+        if (input === null) return ts.factory.createNull();
+        else if (ts.isIdentifier(input)) return input;
+        else if (input instanceof Array) return generate_array(input);
+        else if (typeof input === "object") return generate_object(input);
+        else if (typeof input === "string") return generate_string(input);
+        else if (typeof input === "boolean") return generate_value(input);
+        else if (typeof input === "number") return generate_value(input);
+        else if (typeof input === "bigint") return generate_value(input);
+        else throw new Error("Unknown type.");
+    }
+
+    function generate_object(obj: object): ts.ObjectLiteralExpression {
+        const properties = Object.entries(obj)
+            .filter((tuple) => tuple[1] !== undefined)
+            .map(([key, value]) =>
+                ts.factory.createPropertyAssignment(
+                    IdentifierFactory.generate(key),
+                    generate(value),
+                ),
+            );
+        return ts.factory.createObjectLiteralExpression(properties, true);
+    }
+
+    function generate_array(array: any[]): ts.ArrayLiteralExpression {
+        return ts.factory.createArrayLiteralExpression(
+            array.map(generate),
+            true,
+        );
+    }
+
+    function generate_value(value: number | boolean | bigint): ts.Identifier {
+        return ts.factory.createIdentifier(value.toString());
+    }
+
+    function generate_string(value: string): ts.StringLiteral {
+        return ts.factory.createStringLiteral(value);
+    }
+}

package/src/factories/StatementFactory.ts

@@ -1,60 +1,60 @@
-import ts from "typescript";
-
-export namespace StatementFactory {
-    export function constant(name: string, initializer?: ts.Expression) {
-        return ts.factory.createVariableStatement(
-            undefined,
-            ts.factory.createVariableDeclarationList(
-                [
-                    ts.factory.createVariableDeclaration(
-                        name,
-                        undefined,
-                        undefined,
-                        initializer,
-                    ),
-                ],
-                ts.NodeFlags.Const,
-            ),
-        );
-    }
-
-    export function transpile(script: string) {
-        return ts.factory.createExpressionStatement(
-            ts.factory.createIdentifier(ts.transpile(script)),
-        );
-    }
-
-    // export function require(variable: string, location: string) {
-    //     return ts.factory.createImportDeclaration(
-    //         undefined,
-    //         undefined,
-    //         ts.factory.createImportClause(
-    //             false,
-    //             undefined,
-    //             ts.factory.createNamespaceImport(
-    //                 ts.factory.createIdentifier(variable),
-    //             ),
-    //         ),
-    //         ts.factory.createStringLiteral(location),
-    //     );
-    // }
-
-    // export function importModulo(variable: string, location: string) {
-    //     return ts.factory.createImportDeclaration(
-    //         undefined,
-    //         undefined,
-    //         ts.factory.createImportClause(
-    //             false,
-    //             undefined,
-    //             ts.factory.createNamedImports([
-    //                 ts.factory.createImportSpecifier(
-    //                     false,
-    //                     undefined,
-    //                     ts.factory.createIdentifier(variable),
-    //                 ),
-    //             ]),
-    //         ),
-    //         ts.factory.createStringLiteral(location),
-    //     );
-    // }
-}
+import ts from "typescript";
+
+export namespace StatementFactory {
+    export function constant(name: string, initializer?: ts.Expression) {
+        return ts.factory.createVariableStatement(
+            undefined,
+            ts.factory.createVariableDeclarationList(
+                [
+                    ts.factory.createVariableDeclaration(
+                        name,
+                        undefined,
+                        undefined,
+                        initializer,
+                    ),
+                ],
+                ts.NodeFlags.Const,
+            ),
+        );
+    }
+
+    export function transpile(script: string) {
+        return ts.factory.createExpressionStatement(
+            ts.factory.createIdentifier(ts.transpile(script)),
+        );
+    }
+
+    // export function require(variable: string, location: string) {
+    //     return ts.factory.createImportDeclaration(
+    //         undefined,
+    //         undefined,
+    //         ts.factory.createImportClause(
+    //             false,
+    //             undefined,
+    //             ts.factory.createNamespaceImport(
+    //                 ts.factory.createIdentifier(variable),
+    //             ),
+    //         ),
+    //         ts.factory.createStringLiteral(location),
+    //     );
+    // }
+
+    // export function importModulo(variable: string, location: string) {
+    //     return ts.factory.createImportDeclaration(
+    //         undefined,
+    //         undefined,
+    //         ts.factory.createImportClause(
+    //             false,
+    //             undefined,
+    //             ts.factory.createNamedImports([
+    //                 ts.factory.createImportSpecifier(
+    //                     false,
+    //                     undefined,
+    //                     ts.factory.createIdentifier(variable),
+    //                 ),
+    //             ]),
+    //         ),
+    //         ts.factory.createStringLiteral(location),
+    //     );
+    // }
+}

package/src/factories/TemplateFactory.ts

@@ -1,56 +1,56 @@
-import ts from "typescript";
-
-export namespace TemplateFactory {
-    export function generate(expressions: ts.Expression[]): ts.Expression {
-        if (expressions.every((exp) => ts.isStringLiteral(exp)))
-            return ts.factory.createStringLiteral(
-                (expressions as ts.StringLiteral[])
-                    .map((str) => str.text)
-                    .join(""),
-            );
-
-        const it: IIerator = {
-            value: "",
-            index: 0,
-        };
-        gather(expressions, it);
-
-        const head: ts.TemplateHead = ts.factory.createTemplateHead(it.value);
-        const spans: ts.TemplateSpan[] = [];
-
-        while (true) {
-            const elem: ts.Expression = expressions[it.index++]!;
-            gather(expressions, it);
-
-            const broken: boolean = it.index === expressions.length;
-            spans.push(
-                ts.factory.createTemplateSpan(
-                    elem,
-                    broken
-                        ? ts.factory.createTemplateTail(it.value)
-                        : ts.factory.createTemplateMiddle(it.value),
-                ),
-            );
-            if (broken === true) break;
-        }
-        return ts.factory.createTemplateExpression(head, spans);
-    }
-
-    function gather(expressions: ts.Expression[], it: IIerator): void {
-        const found: number = expressions.findIndex(
-            (elem, index) => index >= it.index && !ts.isStringLiteral(elem),
-        );
-
-        const last: number = found !== -1 ? found : expressions.length;
-        it.value = expressions
-            .slice(it.index, last)
-            .map((elem) => (elem as ts.StringLiteral).text)
-            .reduce((x, y) => x + y, "");
-        it.index = last;
-    }
-
-    interface IIerator {
-        value: string;
-        index: number;
-    }
-}
+import ts from "typescript";
+
+export namespace TemplateFactory {
+    export function generate(expressions: ts.Expression[]): ts.Expression {
+        if (expressions.every((exp) => ts.isStringLiteral(exp)))
+            return ts.factory.createStringLiteral(
+                (expressions as ts.StringLiteral[])
+                    .map((str) => str.text)
+                    .join(""),
+            );
+
+        const it: IIerator = {
+            value: "",
+            index: 0,
+        };
+        gather(expressions, it);
+
+        const head: ts.TemplateHead = ts.factory.createTemplateHead(it.value);
+        const spans: ts.TemplateSpan[] = [];
+
+        while (true) {
+            const elem: ts.Expression = expressions[it.index++]!;
+            gather(expressions, it);
+
+            const broken: boolean = it.index === expressions.length;
+            spans.push(
+                ts.factory.createTemplateSpan(
+                    elem,
+                    broken
+                        ? ts.factory.createTemplateTail(it.value)
+                        : ts.factory.createTemplateMiddle(it.value),
+                ),
+            );
+            if (broken === true) break;
+        }
+        return ts.factory.createTemplateExpression(head, spans);
+    }
+
+    function gather(expressions: ts.Expression[], it: IIerator): void {
+        const found: number = expressions.findIndex(
+            (elem, index) => index >= it.index && !ts.isStringLiteral(elem),
+        );
+
+        const last: number = found !== -1 ? found : expressions.length;
+        it.value = expressions
+            .slice(it.index, last)
+            .map((elem) => (elem as ts.StringLiteral).text)
+            .reduce((x, y) => x + y, "");
+        it.index = last;
+    }
+
+    interface IIerator {
+        value: string;
+        index: number;
+    }
+}

package/src/factories/TypeFactory.ts

@@ -1,101 +1,101 @@
-import ts from "typescript";
-
-export namespace TypeFactory {
-    export function resolve(
-        checker: ts.TypeChecker,
-        type: ts.Type,
-    ): ts.Type | null {
-        return getReturnType(checker, type, "toJSON");
-    }
-
-    export function isFunction(type: ts.Type): boolean {
-        return getFunction(type) !== null;
-    }
-    function getFunction(type: ts.Type) {
-        const node = type.symbol?.declarations?.[0];
-        if (node === undefined) return null;
-
-        return ts.isFunctionLike(node)
-            ? node
-            : ts.isPropertyAssignment(node) || ts.isPropertyDeclaration(node)
-            ? ts.isFunctionLike(node.initializer)
-                ? node.initializer
-                : null
-            : null;
-    }
-
-    export function getReturnType(
-        checker: ts.TypeChecker,
-        type: ts.Type,
-        name: string,
-    ): ts.Type | null {
-        // FIND TO-JSON METHOD
-        const symbol: ts.Symbol | undefined = type.getProperty(name);
-        if (!symbol) return null;
-        else if (!symbol.valueDeclaration) return null;
-
-        // GET FUNCTION DECLARATION
-        const functor: ts.Type = checker.getTypeOfSymbolAtLocation(
-            symbol,
-            symbol.valueDeclaration,
-        );
-
-        // RETURNS THE RETURN-TYPE
-        const signature: ts.Signature | undefined = checker.getSignaturesOfType(
-            functor,
-            ts.SignatureKind.Call,
-        )[0];
-        return signature ? signature.getReturnType() : null;
-    }
-
-    export function getFullName(
-        checker: ts.TypeChecker,
-        type: ts.Type,
-        symbol?: ts.Symbol,
-    ): string {
-        // PRIMITIVE
-        symbol ||= type.aliasSymbol || type.getSymbol();
-        if (symbol === undefined) return checker.typeToString(type);
-
-        // UNION OR INTERSECT
-        if (type.aliasSymbol === undefined && type.isUnionOrIntersection()) {
-            const joiner: string = type.isIntersection() ? " & " : " | ";
-            return type.types
-                .map((child) => getFullName(checker, child))
-                .join(joiner);
-        }
-
-        //----
-        // SPECIALIZATION
-        //----
-        const name: string = get_name(symbol);
-
-        // CHECK GENERIC
-        const generic: readonly ts.Type[] = type.aliasSymbol
-            ? type.aliasTypeArguments || []
-            : checker.getTypeArguments(type as ts.TypeReference);
-        return generic.length
-            ? name === "Promise"
-                ? getFullName(checker, generic[0]!)
-                : `${name}<${generic
-                      .map((child) => getFullName(checker, child))
-                      .join(", ")}>`
-            : name;
-    }
-
-    function explore_name(name: string, decl: ts.Node): string {
-        return ts.isModuleBlock(decl)
-            ? explore_name(
-                  `${decl.parent.name.getText()}.${name}`,
-                  decl.parent.parent,
-              )
-            : name;
-    }
-
-    function get_name(symbol: ts.Symbol): string {
-        const parent = symbol.getDeclarations()?.[0]?.parent;
-        return parent
-            ? explore_name(symbol.escapedName.toString(), parent)
-            : "__type";
-    }
-}
+import ts from "typescript";
+
+export namespace TypeFactory {
+    export function resolve(
+        checker: ts.TypeChecker,
+        type: ts.Type,
+    ): ts.Type | null {
+        return getReturnType(checker, type, "toJSON");
+    }
+
+    export function isFunction(type: ts.Type): boolean {
+        return getFunction(type) !== null;
+    }
+    function getFunction(type: ts.Type) {
+        const node = type.symbol?.declarations?.[0];
+        if (node === undefined) return null;
+
+        return ts.isFunctionLike(node)
+            ? node
+            : ts.isPropertyAssignment(node) || ts.isPropertyDeclaration(node)
+            ? ts.isFunctionLike(node.initializer)
+                ? node.initializer
+                : null
+            : null;
+    }
+
+    export function getReturnType(
+        checker: ts.TypeChecker,
+        type: ts.Type,
+        name: string,
+    ): ts.Type | null {
+        // FIND TO-JSON METHOD
+        const symbol: ts.Symbol | undefined = type.getProperty(name);
+        if (!symbol) return null;
+        else if (!symbol.valueDeclaration) return null;
+
+        // GET FUNCTION DECLARATION
+        const functor: ts.Type = checker.getTypeOfSymbolAtLocation(
+            symbol,
+            symbol.valueDeclaration,
+        );
+
+        // RETURNS THE RETURN-TYPE
+        const signature: ts.Signature | undefined = checker.getSignaturesOfType(
+            functor,
+            ts.SignatureKind.Call,
+        )[0];
+        return signature ? signature.getReturnType() : null;
+    }
+
+    export function getFullName(
+        checker: ts.TypeChecker,
+        type: ts.Type,
+        symbol?: ts.Symbol,
+    ): string {
+        // PRIMITIVE
+        symbol ||= type.aliasSymbol || type.getSymbol();
+        if (symbol === undefined) return checker.typeToString(type);
+
+        // UNION OR INTERSECT
+        if (type.aliasSymbol === undefined && type.isUnionOrIntersection()) {
+            const joiner: string = type.isIntersection() ? " & " : " | ";
+            return type.types
+                .map((child) => getFullName(checker, child))
+                .join(joiner);
+        }
+
+        //----
+        // SPECIALIZATION
+        //----
+        const name: string = get_name(symbol);
+
+        // CHECK GENERIC
+        const generic: readonly ts.Type[] = type.aliasSymbol
+            ? type.aliasTypeArguments || []
+            : checker.getTypeArguments(type as ts.TypeReference);
+        return generic.length
+            ? name === "Promise"
+                ? getFullName(checker, generic[0]!)
+                : `${name}<${generic
+                      .map((child) => getFullName(checker, child))
+                      .join(", ")}>`
+            : name;
+    }
+
+    function explore_name(name: string, decl: ts.Node): string {
+        return ts.isModuleBlock(decl)
+            ? explore_name(
+                  `${decl.parent.name.getText()}.${name}`,
+                  decl.parent.parent,
+              )
+            : name;
+    }
+
+    function get_name(symbol: ts.Symbol): string {
+        const parent = symbol.getDeclarations()?.[0]?.parent;
+        return parent
+            ? explore_name(symbol.escapedName.toString(), parent)
+            : "__type";
+    }
+}

package/src/factories/ValueFactory.ts

@@ -1,12 +1,12 @@
-import ts from "typescript";
-
-export namespace ValueFactory {
-    export const NULL = () => ts.factory.createNull();
-    export const UNDEFINED = () => ts.factory.createIdentifier("undefined");
-    export const BOOLEAN = (value: boolean) =>
-        value ? ts.factory.createTrue() : ts.factory.createFalse();
-    export const INPUT = (str: string = "input") =>
-        ts.factory.createIdentifier(str);
-    export const TYPEOF = (input: ts.Expression) =>
-        ts.factory.createTypeOfExpression(input);
-}
+import ts from "typescript";
+
+export namespace ValueFactory {
+    export const NULL = () => ts.factory.createNull();
+    export const UNDEFINED = () => ts.factory.createIdentifier("undefined");
+    export const BOOLEAN = (value: boolean) =>
+        value ? ts.factory.createTrue() : ts.factory.createFalse();
+    export const INPUT = (str: string = "input") =>
+        ts.factory.createIdentifier(str);
+    export const TYPEOF = (input: ts.Expression) =>
+        ts.factory.createTypeOfExpression(input);
+}

package/src/functional/$every.ts

@@ -1,11 +1,11 @@
-import { TypeGuardError } from "../TypeGuardError";
-
-export const $every = <T>(
-    array: T[],
-    pred: (value: T, i: number) => null | Omit<TypeGuardError.IProps, "method">,
-): null | Omit<TypeGuardError.IProps, "method"> => {
-    let error: null | Omit<TypeGuardError.IProps, "method"> = null;
-    for (let i: number = 0; i < array.length; ++i)
-        if (null !== (error = pred(array[i]!, i))) return error;
-    return null;
-};
+import { TypeGuardError } from "../TypeGuardError";
+
+export const $every = <T>(
+    array: T[],
+    pred: (value: T, i: number) => null | Omit<TypeGuardError.IProps, "method">,
+): null | Omit<TypeGuardError.IProps, "method"> => {
+    let error: null | Omit<TypeGuardError.IProps, "method"> = null;
+    for (let i: number = 0; i < array.length; ++i)
+        if (null !== (error = pred(array[i]!, i))) return error;
+    return null;
+};

package/src/functional/$is_email.ts

@@ -1,5 +1,5 @@
-export function $is_email(str: string): boolean {
-    return REGEX.test(str);
-}
-const REGEX =
-    /^(([^<>()[\]\.,;:\s@\"]+(\.[^<>()[\]\.,;:\s@\"]+)*)|(\".+\"))@(([^<>()[\]\.,;:\s@\"]+\.)+[^<>()[\]\.,;:\s@\"]{2,})$/i;
+export function $is_email(str: string): boolean {
+    return REGEX.test(str);
+}
+const REGEX =
+    /^(([^<>()[\]\.,;:\s@\"]+(\.[^<>()[\]\.,;:\s@\"]+)*)|(\".+\"))@(([^<>()[\]\.,;:\s@\"]+\.)+[^<>()[\]\.,;:\s@\"]{2,})$/i;

package/src/functional/$is_ipv4.ts

@@ -1,5 +1,5 @@
-export function $is_ipv4(str: string): boolean {
-    return REGEX.test(str);
-}
-const REGEX =
-    /^(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
+export function $is_ipv4(str: string): boolean {
+    return REGEX.test(str);
+}
+const REGEX =
+    /^(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;

package/src/functional/$is_ipv6.ts

@@ -1,5 +1,5 @@
-export function $is_ipv6(str: string): boolean {
-    return REGEX.test(str);
-}
-const REGEX =
-    /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/;
+export function $is_ipv6(str: string): boolean {
+    return REGEX.test(str);
+}
+const REGEX =
+    /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/;

package/src/functional/$is_url.ts

@@ -1,5 +1,5 @@
-export function $is_url(str: string): boolean {
-    return REGEX.test(str);
-}
-const REGEX =
-    /^[a-zA-Z0-9]+:\/\/(?:www.)?[-a-zA-Z0-9@:%._+~#=]{1,256}.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_+.~#?&/=]*)$/;
+export function $is_url(str: string): boolean {
+    return REGEX.test(str);
+}
+const REGEX =
+    /^[a-zA-Z0-9]+:\/\/(?:www.)?[-a-zA-Z0-9@:%._+~#=]{1,256}.[a-zA-Z0-9()]{1,6}\b(?:[-a-zA-Z0-9()@:%_+.~#?&/=]*)$/;

package/src/functional/$is_uuid.ts

@@ -1,5 +1,5 @@
-export function $is_uuid(str: string): boolean {
-    return REGEX.test(str);
-}
-const REGEX =
-    /[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;
+export function $is_uuid(str: string): boolean {
+    return REGEX.test(str);
+}
+const REGEX =
+    /[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;