namirasoft-core 1.2.13 → 1.2.14

package/.gitlab-ci.yml

@@ -1,14 +1,14 @@
-stages:   
- - npm-publish
-
-publish:
-  stage: npm-publish
-  script:
-    - rm -rf node_modules
-    - rm -rf dist
-    - ncu -u
-    - npm i
-    - tsc
-    - npm publish
-  only:
+stages:   
+ - npm-publish
+
+publish:
+  stage: npm-publish
+  script:
+    - rm -rf node_modules
+    - rm -rf dist
+    - ncu -u
+    - npm i
+    - tsc
+    - npm publish
+  only:
     - master

package/dist/EncryptionOperation.js

@@ -27,15 +27,23 @@ exports.EncryptionOperation = void 0;
 const crypto = __importStar(require("node:crypto"));
 class EncryptionOperation {
     static encrypt(algorithm, secret, message) {
-        const iv = Buffer.alloc(16, 0);
+        const iv = crypto.randomBytes(16);
         const cipher = crypto.createCipheriv(algorithm, secret, iv);
-        return cipher.update(JSON.stringify(message), 'utf8', 'hex') + cipher.final('hex');
+        const encrypted = Buffer.concat([cipher.update(JSON.stringify(message), 'utf8'), cipher.final()]);
+        const authTag = cipher.getAuthTag();
+        const ivHex = iv.toString('hex');
+        const authTagHex = authTag.toString('hex');
+        const encryptedHex = encrypted.toString('hex');
+        return [ivHex, authTagHex, encryptedHex].join(";");
     }
     static decrypt(algorithm, secret, message) {
-        let encryptedText = Buffer.from(message, 'hex');
-        const iv = Buffer.alloc(16, 0);
+        const [ivHex, authTagHex, encryptedHex] = message.split(';');
+        const iv = Buffer.from(ivHex, 'hex');
+        const authTag = Buffer.from(authTagHex, 'hex');
+        const encrypte = Buffer.from(encryptedHex, 'hex');
         const decipher = crypto.createDecipheriv(algorithm, secret, iv);
-        let decrypted = decipher.update(encryptedText);
+        decipher.setAuthTag(authTag);
+        let decrypted = decipher.update(encrypte);
         decrypted = Buffer.concat([decrypted, decipher.final()]);
         return JSON.parse(decrypted.toString());
     }

package/dist/EncryptionOperation.js.map

@@ -1 +1 @@
-{"version":3,"file":"EncryptionOperation.js","sourceRoot":"","sources":["../src/EncryptionOperation.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAsC;AAEtC,MAAa,mBAAmB;IAEpB,MAAM,CAAC,OAAO,CAAI,SAAiB,EAAE,MAAc,EAAE,OAAU;QAEnE,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvF,CAAC;IACO,MAAM,CAAC,OAAO,CAAI,SAAiB,EAAE,MAAc,EAAE,OAAe;QAExE,IAAI,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEhD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAEhE,IAAI,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC/C,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAI,MAAc,EAAE,OAAU;QAEjD,OAAO,mBAAmB,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAI,MAAc,EAAE,OAAe;QAEtD,OAAO,mBAAmB,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACJ;AA3BD,kDA2BC"}
+{"version":3,"file":"EncryptionOperation.js","sourceRoot":"","sources":["../src/EncryptionOperation.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAsC;AAEtC,MAAa,mBAAmB;IAEpB,MAAM,CAAC,OAAO,CAAI,SAAiB,EAAE,MAAc,EAAE,OAAU;QAEnE,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClG,MAAM,OAAO,GAAI,MAAc,CAAC,UAAU,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IACO,MAAM,CAAC,OAAO,CAAI,SAAiB,EAAE,MAAc,EAAE,OAAe;QAExE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAElD,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/D,QAAgB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAEtC,IAAI,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAI,MAAc,EAAE,OAAU;QAEjD,OAAO,mBAAmB,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,CAAC,gBAAgB,CAAI,MAAc,EAAE,OAAe;QAEtD,OAAO,mBAAmB,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACJ;AAnCD,kDAmCC"}

package/dist/SignOperation.d.ts

@@ -0,0 +1,4 @@
+export declare class SignOperation {
+    static sign(secret: string, message: any): string;
+    static isValid(key: string, values: any, signature: string): boolean;
+}

package/dist/SignOperation.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignOperation = void 0;
+const HashOperation_1 = require("./HashOperation");
+class SignOperation {
+    static sign(secret, message) {
+        return HashOperation_1.HashOperation.sha256Secret(secret, message);
+    }
+    static isValid(key, values, signature) {
+        return this.sign(key, values).toLowerCase() === signature.toLowerCase();
+    }
+}
+exports.SignOperation = SignOperation;
+//# sourceMappingURL=SignOperation.js.map

package/dist/SignOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignOperation.js","sourceRoot":"","sources":["../src/SignOperation.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAEhD,MAAa,aAAa;IAEtB,MAAM,CAAC,IAAI,CAAC,MAAc,EAAE,OAAY;QAEpC,OAAO,6BAAa,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,GAAW,EAAE,MAAW,EAAE,SAAiB;QAEtD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC;IAC5E,CAAC;CACJ;AAVD,sCAUC"}

package/package.json

@@ -1,16 +1,16 @@
-{
-    "name": "namirasoft-core",
-    "description": "Namira Software Corporation Core NPM Package",
-    "version": "1.2.13",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "scripts": {},
-    "author": "Amir Abolhasani",
-    "license": "MIT",
-    "dependencies": {
-        "@types/node": "^20.11.24",
-        "axios": "^1.6.7",
-        "moment": "^2.30.1",
-        "phone": "^3.1.42"
-    }
+{
+    "name": "namirasoft-core",
+    "description": "Namira Software Corporation Core NPM Package",
+    "version": "1.2.14",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "scripts": {},
+    "author": "Amir Abolhasani",
+    "license": "MIT",
+    "dependencies": {
+        "@types/node": "^20.11.25",
+        "axios": "^1.6.7",
+        "moment": "^2.30.1",
+        "phone": "^3.1.42"
+    }
 }

package/src/BaseDatabaseRow.ts

@@ -1,7 +1,7 @@
-export type BaseDatabaseRow<ID> =
-    {
-        id: ID;
-        createdAt: string;
-        updatedAt: string;
-        deletedAt: string;
+export type BaseDatabaseRow<ID> =
+    {
+        id: ID;
+        createdAt: string;
+        updatedAt: string;
+        deletedAt: string;
     }

package/src/BaseServer.ts

@@ -1,73 +1,73 @@
-import axios, { AxiosRequestConfig, AxiosResponse } from "axios";
-import { HashOperation } from "./HashOperation";
-import { URLOperation } from "./URLOperation";
-import { ErrorOperation } from "./ErrorOperation";
-import { ParsedNameValue } from "./ParsedNameValue";
-
-export abstract class BaseServer
-{
-    protected domain: string = "";
-    constructor(domain: string)
-    {
-        this.domain = domain;
-    }
-    protected abstract onBeforeRequest<ReqData = any>(url: string, config?: AxiosRequestConfig<ReqData>): void;
-    protected abstract onAfterRequest<ResData = any>(url: string, response: AxiosResponse<ResData>): void;
-    protected abstract onError(error: Error): void;
-    private async _request<ResData = any, ReqData = any>(onRequest: (url: string, data?: any, config?: AxiosRequestConfig<ReqData>) => Promise<AxiosResponse<ResData>>, sub: string, query?: { [name: string]: ParsedNameValue }, data?: ReqData, config?: AxiosRequestConfig<ReqData>, sign_header?: string, sign_key?: string): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
-    {
-        let url: string = URLOperation.getLink(this.domain, sub, query);
-        if (!config)
-            config = { headers: {} };
-        if (sign_header)
-            if (sign_key)
-                if (data)
-                    if (config?.headers)
-                        config.headers[sign_header] = HashOperation.SHA256Secret(sign_key, data);
-        try
-        {
-            this.onBeforeRequest(url, config);
-            let response: AxiosResponse<ResData> = await onRequest(url, data, config);
-            this.onAfterRequest(url, response);
-            return { response, data: response.data };
-        } catch (error)
-        {
-            if (error instanceof Error)
-            {
-                this.onError(error);
-                if (axios.isAxiosError(error))
-                    if (error?.response?.data)
-                        ErrorOperation.throwHTTP(error.response.status, error.response.data);
-            }
-            throw error;
-        }
-    }
-    protected async _get<ResData = any, ReqData = any>(sub: string, query?: { [name: string]: ParsedNameValue }, config?: AxiosRequestConfig<ReqData>): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
-    {
-        return await this._request(async (url: string, _?: any, config?: AxiosRequestConfig<ReqData>) =>
-        {
-            return await axios.get(url, config);
-        }, sub, query, undefined, config);
-    }
-    protected async _post<ResData = any, ReqData = any>(sub: string, query?: { [name: string]: ParsedNameValue }, data?: ReqData, config?: AxiosRequestConfig<ReqData>, sign_header?: string, sign_key?: string): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
-    {
-        return await this._request(async (url: string, data: ReqData, config?: AxiosRequestConfig<ReqData>) =>
-        {
-            return await axios.post(url, data, config);
-        }, sub, query, data, config, sign_header, sign_key);
-    }
-    protected async _put<ResData = any, ReqData = any>(sub: string, query?: { [name: string]: ParsedNameValue }, data?: ReqData, config?: AxiosRequestConfig<ReqData>, sign_header?: string, sign_key?: string): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
-    {
-        return await this._request(async (url: string, data: ReqData, config?: AxiosRequestConfig<ReqData>) =>
-        {
-            return await axios.put(url, data, config);
-        }, sub, query, data, config, sign_header, sign_key);
-    }
-    protected async _delete<ResData = any, ReqData = any>(sub: string, query?: { [name: string]: ParsedNameValue }, config?: AxiosRequestConfig<ReqData>, sign_header?: string, sign_key?: string): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
-    {
-        return await this._request(async (url: string, _?: any, config?: AxiosRequestConfig<ReqData>) =>
-        {
-            return await axios.delete(url, config);
-        }, sub, query, undefined, config, sign_header, sign_key);
-    }
+import axios, { AxiosRequestConfig, AxiosResponse } from "axios";
+import { HashOperation } from "./HashOperation";
+import { URLOperation } from "./URLOperation";
+import { ErrorOperation } from "./ErrorOperation";
+import { ParsedNameValue } from "./ParsedNameValue";
+
+export abstract class BaseServer
+{
+    protected domain: string = "";
+    constructor(domain: string)
+    {
+        this.domain = domain;
+    }
+    protected abstract onBeforeRequest<ReqData = any>(url: string, config?: AxiosRequestConfig<ReqData>): void;
+    protected abstract onAfterRequest<ResData = any>(url: string, response: AxiosResponse<ResData>): void;
+    protected abstract onError(error: Error): void;
+    private async _request<ResData = any, ReqData = any>(onRequest: (url: string, data?: any, config?: AxiosRequestConfig<ReqData>) => Promise<AxiosResponse<ResData>>, sub: string, query?: { [name: string]: ParsedNameValue }, data?: ReqData, config?: AxiosRequestConfig<ReqData>, sign_header?: string, sign_key?: string): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
+    {
+        let url: string = URLOperation.getLink(this.domain, sub, query);
+        if (!config)
+            config = { headers: {} };
+        if (sign_header)
+            if (sign_key)
+                if (data)
+                    if (config?.headers)
+                        config.headers[sign_header] = HashOperation.SHA256Secret(sign_key, data);
+        try
+        {
+            this.onBeforeRequest(url, config);
+            let response: AxiosResponse<ResData> = await onRequest(url, data, config);
+            this.onAfterRequest(url, response);
+            return { response, data: response.data };
+        } catch (error)
+        {
+            if (error instanceof Error)
+            {
+                this.onError(error);
+                if (axios.isAxiosError(error))
+                    if (error?.response?.data)
+                        ErrorOperation.throwHTTP(error.response.status, error.response.data);
+            }
+            throw error;
+        }
+    }
+    protected async _get<ResData = any, ReqData = any>(sub: string, query?: { [name: string]: ParsedNameValue }, config?: AxiosRequestConfig<ReqData>): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
+    {
+        return await this._request(async (url: string, _?: any, config?: AxiosRequestConfig<ReqData>) =>
+        {
+            return await axios.get(url, config);
+        }, sub, query, undefined, config);
+    }
+    protected async _post<ResData = any, ReqData = any>(sub: string, query?: { [name: string]: ParsedNameValue }, data?: ReqData, config?: AxiosRequestConfig<ReqData>, sign_header?: string, sign_key?: string): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
+    {
+        return await this._request(async (url: string, data: ReqData, config?: AxiosRequestConfig<ReqData>) =>
+        {
+            return await axios.post(url, data, config);
+        }, sub, query, data, config, sign_header, sign_key);
+    }
+    protected async _put<ResData = any, ReqData = any>(sub: string, query?: { [name: string]: ParsedNameValue }, data?: ReqData, config?: AxiosRequestConfig<ReqData>, sign_header?: string, sign_key?: string): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
+    {
+        return await this._request(async (url: string, data: ReqData, config?: AxiosRequestConfig<ReqData>) =>
+        {
+            return await axios.put(url, data, config);
+        }, sub, query, data, config, sign_header, sign_key);
+    }
+    protected async _delete<ResData = any, ReqData = any>(sub: string, query?: { [name: string]: ParsedNameValue }, config?: AxiosRequestConfig<ReqData>, sign_header?: string, sign_key?: string): Promise<{ response: AxiosResponse<ResData>, data: ResData }>
+    {
+        return await this._request(async (url: string, _?: any, config?: AxiosRequestConfig<ReqData>) =>
+        {
+            return await axios.delete(url, config);
+        }, sub, query, undefined, config, sign_header, sign_key);
+    }
 }

package/src/ConvertService.ts

@@ -1,99 +1,99 @@
-import { ErrorOperation } from "./ErrorOperation";
-import { StringOperation } from "./StringOperation";
-
-export abstract class ConvertService
-{
-    repair: boolean = true;
-    private mandatory: boolean;
-    constructor(mandatory: boolean = false)
-    {
-        this.mandatory = mandatory;
-    }
-    abstract getNullString(): string | null;
-    private checkMandatory<D>(value: D): D
-    {
-        if (this.mandatory)
-            if (value == null || value == undefined)
-                this.onMandatoryError();
-        return value;
-    }
-    protected onMandatoryError(): void
-    {
-        ErrorOperation.throwHTTP(500, "Object value can not be converted.");
-    }
-    getString(_default: string = ""): string
-    {
-        let ans = this.checkMandatory(this.getNullString()) ?? _default;
-        if (this.repair)
-            ans = StringOperation.repair(ans);
-        return ans;
-    }
-    getNullInt(): number | null
-    {
-        let str = this.getString();
-        if (str == null)
-            return null;
-        let ans = parseInt(str);
-        if (isNaN(ans))
-            return null;
-        return ans;
-    }
-    getInt(_default: number = 0): number
-    {
-        return this.checkMandatory(this.getNullInt()) ?? _default;
-    }
-    getNullFloat(): number | null
-    {
-        let str = this.getString();
-        if (str == null)
-            return null;
-        let ans = parseFloat(str);
-        if (isNaN(ans))
-            return null;
-        return ans;
-    }
-    getFloat(_default: number = 0): number
-    {
-        return this.checkMandatory(this.getNullFloat()) ?? _default;
-    }
-    getNullBoolean(): boolean | null
-    {
-        let str = this.getString();
-        if (str == null)
-            return null;
-        let ans = str.toLowerCase();
-        if (ans == "true")
-            return true;
-        if (ans == "false")
-            return false;
-        return null;
-    }
-    getBoolean(_default: boolean = false): boolean
-    {
-        return this.checkMandatory(this.getNullBoolean()) ?? _default;
-    }
-    getNullEnum<T>(enumObj: { [s: string]: T }): T | null
-    {
-        let str = this.getString();
-        return Object.values(enumObj).find((enumValue) => enumValue === str) as T | null;
-    }
-    getEnum<T>(enumObj: { [s: string]: T }, _default: T): T
-    {
-        return this.checkMandatory(this.getNullEnum<T>(enumObj)) ?? _default;
-    }
-    getStringArray(delimiter: string = ","): string[]
-    {
-        let ans: string[] = this.getString("").split(delimiter);
-        ans = ans.map(v => `${v}`);
-        ans = ans.filter(x => x);
-        return ans;
-    }
-    getIntArray(delimiter: string = ","): number[]
-    {
-        return this.getStringArray(delimiter).map(x => parseInt(x)).filter(x => !isNaN(x));
-    }
-    getFloatArray(delimiter: string = ","): number[]
-    {
-        return this.getStringArray(delimiter).map(x => parseFloat(x)).filter(x => !isNaN(x));
-    }
+import { ErrorOperation } from "./ErrorOperation";
+import { StringOperation } from "./StringOperation";
+
+export abstract class ConvertService
+{
+    repair: boolean = true;
+    private mandatory: boolean;
+    constructor(mandatory: boolean = false)
+    {
+        this.mandatory = mandatory;
+    }
+    abstract getNullString(): string | null;
+    private checkMandatory<D>(value: D): D
+    {
+        if (this.mandatory)
+            if (value == null || value == undefined)
+                this.onMandatoryError();
+        return value;
+    }
+    protected onMandatoryError(): void
+    {
+        ErrorOperation.throwHTTP(500, "Object value can not be converted.");
+    }
+    getString(_default: string = ""): string
+    {
+        let ans = this.checkMandatory(this.getNullString()) ?? _default;
+        if (this.repair)
+            ans = StringOperation.repair(ans);
+        return ans;
+    }
+    getNullInt(): number | null
+    {
+        let str = this.getString();
+        if (str == null)
+            return null;
+        let ans = parseInt(str);
+        if (isNaN(ans))
+            return null;
+        return ans;
+    }
+    getInt(_default: number = 0): number
+    {
+        return this.checkMandatory(this.getNullInt()) ?? _default;
+    }
+    getNullFloat(): number | null
+    {
+        let str = this.getString();
+        if (str == null)
+            return null;
+        let ans = parseFloat(str);
+        if (isNaN(ans))
+            return null;
+        return ans;
+    }
+    getFloat(_default: number = 0): number
+    {
+        return this.checkMandatory(this.getNullFloat()) ?? _default;
+    }
+    getNullBoolean(): boolean | null
+    {
+        let str = this.getString();
+        if (str == null)
+            return null;
+        let ans = str.toLowerCase();
+        if (ans == "true")
+            return true;
+        if (ans == "false")
+            return false;
+        return null;
+    }
+    getBoolean(_default: boolean = false): boolean
+    {
+        return this.checkMandatory(this.getNullBoolean()) ?? _default;
+    }
+    getNullEnum<T>(enumObj: { [s: string]: T }): T | null
+    {
+        let str = this.getString();
+        return Object.values(enumObj).find((enumValue) => enumValue === str) as T | null;
+    }
+    getEnum<T>(enumObj: { [s: string]: T }, _default: T): T
+    {
+        return this.checkMandatory(this.getNullEnum<T>(enumObj)) ?? _default;
+    }
+    getStringArray(delimiter: string = ","): string[]
+    {
+        let ans: string[] = this.getString("").split(delimiter);
+        ans = ans.map(v => `${v}`);
+        ans = ans.filter(x => x);
+        return ans;
+    }
+    getIntArray(delimiter: string = ","): number[]
+    {
+        return this.getStringArray(delimiter).map(x => parseInt(x)).filter(x => !isNaN(x));
+    }
+    getFloatArray(delimiter: string = ","): number[]
+    {
+        return this.getStringArray(delimiter).map(x => parseFloat(x)).filter(x => !isNaN(x));
+    }
 }