@zajno/common 2.3.18 → 2.4.0

package/esm/validation/throwers.js

@@ -0,0 +1,28 @@
+export var ValidationThrower;
+(function (ValidationThrower) {
+    async function isValid(value, validator) {
+        try {
+            await validator(value);
+            return true;
+        }
+        catch (_e) {
+            return false;
+        }
+    }
+    ValidationThrower.isValid = isValid;
+})(ValidationThrower || (ValidationThrower = {}));
+export function createThrower(schema) {
+    return async (value) => {
+        await schema.validate(value);
+    };
+}
+export function createThrowers(validators) {
+    return Object.entries(validators).reduce((acc, [key, validator]) => {
+        const kk = key;
+        if ('validate' in validator) {
+            acc[kk] = createThrower(validator);
+        }
+        return acc;
+    }, {});
+}
+//# sourceMappingURL=throwers.js.map

package/esm/validation/throwers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throwers.js","sourceRoot":"","sources":["../../../src/validation/throwers.ts"],"names":[],"mappings":"AAKA,MAAM,KAAW,iBAAiB,CASjC;AATD,WAAiB,iBAAiB;IACvB,KAAK,UAAU,OAAO,CAAI,KAAQ,EAAE,SAA+B;QACtE,IAAI,CAAC;YACD,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAPqB,yBAAO,UAO5B,CAAA;AACL,CAAC,EATgB,iBAAiB,KAAjB,iBAAiB,QASjC;AAYD,MAAM,UAAU,aAAa,CAAI,MAAgC;IAC7D,OAAO,KAAK,EAAE,KAAQ,EAAE,EAAE;QACtB,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,cAAc,CAA6B,UAAa;IACpE,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE;QAC/D,MAAM,EAAE,GAAG,GAAyB,CAAC;QACrC,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;YAC1B,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,SAAS,CAAoC,CAAC;QAC1E,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC,EAAE,EAA0B,CAAC,CAAC;AACnC,CAAC"}

package/esm/validation/types.js

@@ -0,0 +1,8 @@
+export class ValidationError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=types.js.map

package/esm/validation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/validation/types.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,eAA4C,SAAQ,KAAK;IACzD,IAAI,CAAU;IAEvB,YAAY,OAAe,EAAE,IAAa;QACtC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ"}

package/esm/validation/validators.js

@@ -0,0 +1,48 @@
+import creditCard from './creditCard';
+import { ValidationErrors } from './ValidationErrors';
+export const ValidatorsRegExps = {
+    // There is at least first and last name
+    // eslint-disable-next-line no-useless-escape
+    name: /^[\p{L},\.'-]+( +[\p{L},\.'-]+)+$/iu,
+    englishLetters: /^([a-zA-Z\s]+)$/,
+    email: /^([a-zA-Z0-9_.\-\\+])+@([a-zA-Z0-9_.-])+\.([a-zA-Z])+([a-zA-Z])+/,
+    // At least one English letter, (?=.*?[a-zA-Z])
+    // At least one digit, (?=.*?[0-9])
+    // At least one special character, (?=.*?[#?!@$%^&*-])
+    // Minimum eight in length .{8,} (with the anchors)
+    password: /^((?=.*?[a-z])|(?=.*?[A-Z])]|(?=.*?[0-9])).{8,}$/,
+    phoneNumber: /^([\d/+]+)$/,
+    // only digit & special character (+)
+    onlyDigit: /^\d+$/,
+    creditCardNumber: /^\d+$/,
+    expiryDateCard: /^\d+$/,
+    cvv: /^\d+$/,
+    // eslint-disable-next-line no-useless-escape
+    website: /^(https?:\/\/)?((\p{N}|\p{L})+((((-?(\p{N}|\p{L})+)+)?)\.))+\p{L}{2,}(:[0-9]+)?(\/.*)?$/iu,
+    linkedin: /^(https?:\/\/)?([a-z]+\d*[a-z]*\.)?linkedin\.com\/.*$/i,
+};
+export const Validators = {
+    notEmpty: (val) => val ? ValidationErrors.None : ValidationErrors.ShouldBeNonEmpty,
+    firstName: (val) => val ? ValidationErrors.None : ValidationErrors.FirstName,
+    lastName: (val) => val ? ValidationErrors.None : ValidationErrors.LastName,
+    fullName: (val) => ValidatorsRegExps.name.test(val.trim()) ? ValidationErrors.None : ValidationErrors.InvalidNameFormat,
+    onlyEnglish: (val) => ValidatorsRegExps.englishLetters.test(val) ? ValidationErrors.None : ValidationErrors.OnlyEnglishLetters,
+    email: (val) => ValidatorsRegExps.email.test(val) ? ValidationErrors.None : ValidationErrors.InvalidEmailFormat,
+    password: (val) => ValidatorsRegExps.password.test(val) ? ValidationErrors.None : ValidationErrors.InvalidPasswordFormat,
+    onlyDigit: (val) => ValidatorsRegExps.onlyDigit.test(val) ? ValidationErrors.None : ValidationErrors.OnlyDigit,
+    creditCardNumber: (val) => {
+        const shortVal = val.replace(/ /gi, '');
+        const valid = ValidatorsRegExps.creditCardNumber.test(shortVal) && shortVal.length === creditCard.getDigitsCount(shortVal);
+        return valid ? ValidationErrors.None : ValidationErrors.InvalidCreditCardFormat;
+    },
+    creditCardExpiryDate: (val) => {
+        const shortVal = val.replace(/\//gi, '');
+        const valid = (ValidatorsRegExps.expiryDateCard.test(shortVal) && shortVal.length === 4);
+        return valid ? ValidationErrors.None : ValidationErrors.InvalidCreditCardExpiryDateFormat;
+    },
+    creditCardCvv: (val) => (ValidatorsRegExps.cvv.test(val) && val.length >= 3 && val.length <= 4) ? ValidationErrors.None : ValidationErrors.InvalidCreditCardCvvFormat,
+    website: (val) => ValidatorsRegExps.website.test(val) ? ValidationErrors.None : ValidationErrors.Website,
+    linkedin: (val) => ValidatorsRegExps.linkedin.test(val) ? ValidationErrors.None : ValidationErrors.Linkedin,
+    regex: (regex) => ((val) => regex.test(val) ? ValidationErrors.None : ValidationErrors.InvalidFormat),
+};
+//# sourceMappingURL=validators.js.map

package/esm/validation/validators.js.map

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

package/esm/validation/wrappers.js

@@ -0,0 +1,23 @@
+import { throwNotOk } from './helpers';
+import { ValidationErrors } from './ValidationErrors';
+import { Validators } from './validators';
+export const Wrappers = {
+    required(validator) {
+        return (val) => {
+            return Validators.notEmpty(val) || validator(val);
+        };
+    },
+    notRequired(validator) {
+        return (val) => {
+            return Validators.notEmpty(val) === ValidationErrors.ShouldBeNonEmpty
+                ? ValidationErrors.None
+                : validator(val);
+        };
+    },
+    thrower(validator) {
+        return (val) => {
+            throwNotOk(validator(val));
+        };
+    },
+};
+//# sourceMappingURL=wrappers.js.map

package/esm/validation/wrappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrappers.js","sourceRoot":"","sources":["../../../src/validation/wrappers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,QAAQ,CAAa,SAA+B;QAChD,OAAO,CAAC,GAAM,EAAoB,EAAE;YAChC,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QACtD,CAAC,CAAC;IACN,CAAC;IAED,WAAW,CAAa,SAA+B;QACnD,OAAO,CAAC,GAAM,EAAoB,EAAE;YAChC,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,gBAAgB,CAAC,gBAAgB;gBACjE,CAAC,CAAC,gBAAgB,CAAC,IAAI;gBACvB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC,CAAC;IACN,CAAC;IAED,OAAO,CAAa,SAA+B;QAC/C,OAAO,CAAC,GAAM,EAAE,EAAE;YACd,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC;IACN,CAAC;CACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zajno/common",
-  "version": "2.3.18",
+  "version": "2.4.0",
   "description": "Zajno's re-usable utilities for JS/TS projects",
   "private": false,
   "repository": {
@@ -33,19 +33,19 @@
   },
   "devDependencies": {
     "@faker-js/faker": "^8.4.1",
-    "@types/node": "^20.12.7",
-    "@vitest/coverage-istanbul": "^1.4.0",
-    "@zajno/eslint-config": "^3.0.1",
+    "@types/node": "^20.16.10",
+    "@vitest/coverage-istanbul": "^2.1.1",
+    "@zajno/eslint-config": "*",
     "cpy-cli": "^5.0.0",
-    "eslint": "^8.57.0",
-    "fast-check": "^3.17.1",
+    "eslint": "^8.57.1",
+    "fast-check": "^3.22.0",
     "jest-extended": "^4.0.2",
-    "rimraf": "^5.0.5",
+    "rimraf": "^6.0.1",
     "scripty": "^2.1.1",
     "ts-node": "^10.9.2",
-    "tslib": "^2.6.2",
-    "typescript": "^5.4.5",
-    "vitest": "^1.4.0"
+    "tslib": "^2.7.0",
+    "typescript": "^5.6.2",
+    "vitest": "^2.1.1"
   },
   "peerDependencies": {
     "tslib": "^2.6"
@@ -53,9 +53,78 @@
   "files": [
     "LICENSE",
     "!.DS_Store",
+    "!*.tsbuildinfo",
     "*"
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "exports": {
+    "./*": {
+      "types": "./types/*.d.ts",
+      "import": "./esm/*.js",
+      "require": "./cjs/*.js",
+      "default": "./esm/*.js"
+    },
+    "./api": {
+      "types": "./types/api/index.d.ts",
+      "import": "./esm/api/index.js",
+      "require": "./cjs/api/index.js",
+      "default": "./cjs/api/index.js"
+    },
+    "./dates": {
+      "types": "./types/dates/index.d.ts",
+      "import": "./esm/dates/index.js",
+      "require": "./cjs/dates/index.js",
+      "default": "./cjs/dates/index.js"
+    },
+    "./fields": {
+      "types": "./types/fields/index.d.ts",
+      "import": "./esm/fields/index.js",
+      "require": "./cjs/fields/index.js",
+      "default": "./cjs/fields/index.js"
+    },
+    "./logger": {
+      "types": "./types/logger/index.d.ts",
+      "import": "./esm/logger/index.js",
+      "require": "./cjs/logger/index.js",
+      "default": "./cjs/logger/index.js"
+    },
+    "./math": {
+      "types": "./types/math/index.d.ts",
+      "import": "./esm/math/index.js",
+      "require": "./cjs/math/index.js",
+      "default": "./cjs/math/index.js"
+    },
+    "./math/object": {
+      "types": "./types/math/object/index.d.ts",
+      "import": "./esm/math/object/index.js",
+      "require": "./cjs/math/object/index.js",
+      "default": "./cjs/math/object/index.js"
+    },
+    "./storage": {
+      "types": "./types/storage/index.d.ts",
+      "import": "./esm/storage/index.js",
+      "require": "./cjs/storage/index.js",
+      "default": "./cjs/storage/index.js"
+    },
+    "./structures/path": {
+      "types": "./types/structures/path/index.d.ts",
+      "import": "./esm/structures/path/index.js",
+      "require": "./cjs/structures/path/index.js",
+      "default": "./cjs/structures/path/index.js"
+    },
+    "./types": {
+      "types": "./types/types/index.d.ts",
+      "import": "./esm/types/index.js",
+      "require": "./cjs/types/index.js",
+      "default": "./cjs/types/index.js"
+    },
+    "./validation": {
+      "types": "./types/validation/index.d.ts",
+      "import": "./esm/validation/index.js",
+      "require": "./cjs/validation/index.js",
+      "default": "./cjs/validation/index.js"
+    }
   }
-}
+}

package/tsconfig.cjs.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/api/call.ts","../src/api/endpoint.ts","../src/api/endpoint.types.ts","../src/api/error.ts","../src/api/helpers.ts","../src/api/index.ts","../src/api/logging.ts","../src/api/methods.ts","../src/api/processor.ts","../src/api/register.ts","../src/api/statuscodes.ts","../src/async/arrays.ts","../src/async/misc.ts","../src/async/timeout.ts","../src/dates/calc.ts","../src/dates/calendarindex.ts","../src/dates/convert.ts","../src/dates/datex.ts","../src/dates/decompose.ts","../src/dates/format.ts","../src/dates/index.ts","../src/dates/parse.ts","../src/dates/period.ts","../src/dates/shift.ts","../src/dates/types.ts","../src/dates/tz.ts","../src/dates/yeardate.ts","../src/fields/filter.ts","../src/fields/index.ts","../src/fields/skip.ts","../src/fields/transfer.ts","../src/fields/update.ts","../src/functions/assert.ts","../src/functions/disposer.symbols.ts","../src/functions/disposer.ts","../src/functions/safe.ts","../src/functions/throttle.ts","../src/lazy/light.ts","../src/lazy/promise.ts","../src/lazy/singleton.ts","../src/lazy/types.ts","../src/logger/abstractions.ts","../src/logger/batch.ts","../src/logger/console.ts","../src/logger/file.ts","../src/logger/index.ts","../src/logger/manager.ts","../src/logger/named.ts","../src/logger/proxy.ts","../src/math/arrays.ts","../src/math/calc.ts","../src/math/distribution.ts","../src/math/index.ts","../src/math/object/helpers.ts","../src/math/object/index.ts","../src/math/object/math.composite.ts","../src/math/object/math.ts","../src/math/object/ops.composite.ts","../src/math/object/ops.ts","../src/math/object/types.ts","../src/models/entitywithstatus.ts","../src/models/file.ts","../src/models/model.ts","../src/models/valuescollector.ts","../src/models/types.ts","../src/models/wrappers.ts","../src/observing/event.late.ts","../src/observing/event.ts","../src/observing/progresstracker.ts","../src/observing/throttledevent.ts","../src/observing/timer.ts","../src/storage/index.ts","../src/storage/types.ts","../src/storage/wrappers.ts","../src/structures/expire.ts","../src/structures/linkedlist.ts","../src/structures/nameof.ts","../src/structures/pool.ts","../src/structures/promisecache.ts","../src/structures/promiseextended.ts","../src/structures/promiseproxy.ts","../src/structures/subscribersmap.ts","../src/structures/tempocache.ts","../src/structures/helpers/enum.ts","../src/structures/helpers/name.ts","../src/structures/path/builder.ts","../src/structures/path/index.ts","../src/structures/path/types.ts","../src/structures/path/utils.ts","../src/structures/queue/parallel.ts","../src/structures/queue/tasks.ts","../src/types/arrays.ts","../src/types/comparator.ts","../src/types/deep.ts","../src/types/functions.ts","../src/types/getter.ts","../src/types/ident.ts","../src/types/index.ts","../src/types/misc.ts","../src/validation/validationerrors.ts","../src/validation/creditcard.ts","../src/validation/emails.ts","../src/validation/helpers.ts","../src/validation/index.ts","../src/validation/throwers.ts","../src/validation/types.ts","../src/validation/validators.ts","../src/validation/wrappers.ts"],"version":"5.6.2"}

package/tsconfig.esm.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/api/call.ts","../src/api/endpoint.ts","../src/api/endpoint.types.ts","../src/api/error.ts","../src/api/helpers.ts","../src/api/index.ts","../src/api/logging.ts","../src/api/methods.ts","../src/api/processor.ts","../src/api/register.ts","../src/api/statuscodes.ts","../src/async/arrays.ts","../src/async/misc.ts","../src/async/timeout.ts","../src/dates/calc.ts","../src/dates/calendarindex.ts","../src/dates/convert.ts","../src/dates/datex.ts","../src/dates/decompose.ts","../src/dates/format.ts","../src/dates/index.ts","../src/dates/parse.ts","../src/dates/period.ts","../src/dates/shift.ts","../src/dates/types.ts","../src/dates/tz.ts","../src/dates/yeardate.ts","../src/fields/filter.ts","../src/fields/index.ts","../src/fields/skip.ts","../src/fields/transfer.ts","../src/fields/update.ts","../src/functions/assert.ts","../src/functions/disposer.symbols.ts","../src/functions/disposer.ts","../src/functions/safe.ts","../src/functions/throttle.ts","../src/lazy/light.ts","../src/lazy/promise.ts","../src/lazy/singleton.ts","../src/lazy/types.ts","../src/logger/abstractions.ts","../src/logger/batch.ts","../src/logger/console.ts","../src/logger/file.ts","../src/logger/index.ts","../src/logger/manager.ts","../src/logger/named.ts","../src/logger/proxy.ts","../src/math/arrays.ts","../src/math/calc.ts","../src/math/distribution.ts","../src/math/index.ts","../src/math/object/helpers.ts","../src/math/object/index.ts","../src/math/object/math.composite.ts","../src/math/object/math.ts","../src/math/object/ops.composite.ts","../src/math/object/ops.ts","../src/math/object/types.ts","../src/models/entitywithstatus.ts","../src/models/file.ts","../src/models/model.ts","../src/models/valuescollector.ts","../src/models/types.ts","../src/models/wrappers.ts","../src/observing/event.late.ts","../src/observing/event.ts","../src/observing/progresstracker.ts","../src/observing/throttledevent.ts","../src/observing/timer.ts","../src/storage/index.ts","../src/storage/types.ts","../src/storage/wrappers.ts","../src/structures/expire.ts","../src/structures/linkedlist.ts","../src/structures/nameof.ts","../src/structures/pool.ts","../src/structures/promisecache.ts","../src/structures/promiseextended.ts","../src/structures/promiseproxy.ts","../src/structures/subscribersmap.ts","../src/structures/tempocache.ts","../src/structures/helpers/enum.ts","../src/structures/helpers/name.ts","../src/structures/path/builder.ts","../src/structures/path/index.ts","../src/structures/path/types.ts","../src/structures/path/utils.ts","../src/structures/queue/parallel.ts","../src/structures/queue/tasks.ts","../src/types/arrays.ts","../src/types/comparator.ts","../src/types/deep.ts","../src/types/functions.ts","../src/types/getter.ts","../src/types/ident.ts","../src/types/index.ts","../src/types/misc.ts","../src/validation/validationerrors.ts","../src/validation/creditcard.ts","../src/validation/emails.ts","../src/validation/helpers.ts","../src/validation/index.ts","../src/validation/throwers.ts","../src/validation/types.ts","../src/validation/validators.ts","../src/validation/wrappers.ts"],"version":"5.6.2"}

package/tsconfig.types.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/api/call.ts","../src/api/endpoint.ts","../src/api/endpoint.types.ts","../src/api/error.ts","../src/api/helpers.ts","../src/api/index.ts","../src/api/logging.ts","../src/api/methods.ts","../src/api/processor.ts","../src/api/register.ts","../src/api/statuscodes.ts","../src/async/arrays.ts","../src/async/misc.ts","../src/async/timeout.ts","../src/dates/calc.ts","../src/dates/calendarindex.ts","../src/dates/convert.ts","../src/dates/datex.ts","../src/dates/decompose.ts","../src/dates/format.ts","../src/dates/index.ts","../src/dates/parse.ts","../src/dates/period.ts","../src/dates/shift.ts","../src/dates/types.ts","../src/dates/tz.ts","../src/dates/yeardate.ts","../src/fields/filter.ts","../src/fields/index.ts","../src/fields/skip.ts","../src/fields/transfer.ts","../src/fields/update.ts","../src/functions/assert.ts","../src/functions/disposer.symbols.ts","../src/functions/disposer.ts","../src/functions/safe.ts","../src/functions/throttle.ts","../src/lazy/light.ts","../src/lazy/promise.ts","../src/lazy/singleton.ts","../src/lazy/types.ts","../src/logger/abstractions.ts","../src/logger/batch.ts","../src/logger/console.ts","../src/logger/file.ts","../src/logger/index.ts","../src/logger/manager.ts","../src/logger/named.ts","../src/logger/proxy.ts","../src/math/arrays.ts","../src/math/calc.ts","../src/math/distribution.ts","../src/math/index.ts","../src/math/object/helpers.ts","../src/math/object/index.ts","../src/math/object/math.composite.ts","../src/math/object/math.ts","../src/math/object/ops.composite.ts","../src/math/object/ops.ts","../src/math/object/types.ts","../src/models/entitywithstatus.ts","../src/models/file.ts","../src/models/model.ts","../src/models/valuescollector.ts","../src/models/types.ts","../src/models/wrappers.ts","../src/observing/event.late.ts","../src/observing/event.ts","../src/observing/progresstracker.ts","../src/observing/throttledevent.ts","../src/observing/timer.ts","../src/storage/index.ts","../src/storage/types.ts","../src/storage/wrappers.ts","../src/structures/expire.ts","../src/structures/linkedlist.ts","../src/structures/nameof.ts","../src/structures/pool.ts","../src/structures/promisecache.ts","../src/structures/promiseextended.ts","../src/structures/promiseproxy.ts","../src/structures/subscribersmap.ts","../src/structures/tempocache.ts","../src/structures/helpers/enum.ts","../src/structures/helpers/name.ts","../src/structures/path/builder.ts","../src/structures/path/index.ts","../src/structures/path/types.ts","../src/structures/path/utils.ts","../src/structures/queue/parallel.ts","../src/structures/queue/tasks.ts","../src/types/arrays.ts","../src/types/comparator.ts","../src/types/deep.ts","../src/types/functions.ts","../src/types/getter.ts","../src/types/ident.ts","../src/types/index.ts","../src/types/misc.ts","../src/validation/validationerrors.ts","../src/validation/creditcard.ts","../src/validation/emails.ts","../src/validation/helpers.ts","../src/validation/index.ts","../src/validation/throwers.ts","../src/validation/types.ts","../src/validation/validators.ts","../src/validation/wrappers.ts"],"version":"5.6.2"}

package/types/api/call.d.ts

@@ -0,0 +1,35 @@
+import { AnyObject } from '../types';
+import { IEndpointInfo } from './endpoint';
+import { EndpointMethods } from './methods';
+import { LogTypes } from './logging';
+/** Request options to be used by call implementation (e.g. interceptor). Passed as separate object argument to the call method.  */
+type Extra<T> = {
+    headers?: IEndpointInfo.ExtractHeaders<T>;
+    log?: LogTypes<IEndpointInfo.ExtractIn<T>, IEndpointInfo.ExtractOut<T>>;
+    noLoader?: boolean;
+};
+export type RequestConfig<TIn> = {
+    method: EndpointMethods | string & Record<never, never>;
+    url: string;
+    data: TIn | null | undefined;
+    headers: AnyObject;
+};
+/** Compiled request config object passed to `request` implementation */
+export type RequestConfigDetails<T extends IEndpointInfo = IEndpointInfo, TIn = IEndpointInfo.ExtractIn<T>, TExtra extends object = Record<string, any>> = RequestConfig<TIn> & {
+    _api: T;
+    _noLoader?: boolean;
+    _log?: LogTypes;
+    /** Additional data passed to the request implementation */
+    _extra?: TExtra;
+};
+type CallerOptions<TExtra extends object = Record<string, any>> = {
+    /** Additional hook before hading request config to implementation */
+    bodyValidation?: (api: IEndpointInfo, input: any) => Promise<void>;
+    /** Request implementation */
+    request: <TIn, TOut>(config: RequestConfigDetails<IEndpointInfo, TIn, TExtra>) => Promise<{
+        data: TOut;
+    }>;
+};
+export type EndpointCallArgs<T extends IEndpointInfo> = IEndpointInfo.ExtractIn<T> | IEndpointInfo.ExtractPath<T> | IEndpointInfo.ExtractQuery<T>;
+export declare function buildApiCaller<TExtra extends object = Record<string, any>>(options: CallerOptions<TExtra>): <T extends IEndpointInfo>(api: T, data: EndpointCallArgs<T>, extra?: Extra<T> & TExtra) => Promise<IEndpointInfo.ExtractOut<T>>;
+export {};

package/types/api/endpoint.d.ts

@@ -0,0 +1,38 @@
+import { AnyObject } from '../types';
+import { Path } from '../structures/path';
+import { EndpointMethods } from './methods';
+import { IEndpointInfo } from './endpoint.types';
+export type { IEndpointInfo };
+export declare class ApiEndpoint<TIn extends object | null, TOut, TPath extends readonly string[], TQuery extends object, TErrors, THeaders> implements IEndpointInfo, IEndpointInfo.IIn<TIn>, IEndpointInfo.IOut<TOut>, IEndpointInfo.IPath<TPath>, IEndpointInfo.IQuery<TQuery>, IEndpointInfo.IErrors<TErrors>, IEndpointInfo.IHeaders<THeaders> {
+    method: EndpointMethods;
+    path: Path.SwitchBuilder<TPath>;
+    isForm?: boolean;
+    displayName?: string;
+    in?: TIn;
+    out?: TOut;
+    queryKeys?: (string & keyof TQuery)[];
+    queryTemplate?: TQuery;
+    errorProcessor?: (err: TErrors) => void;
+    headers?: THeaders;
+    get pathBuilder(): Path.IBuilder;
+    static construct<TIn extends object | null, TOut>(method?: EndpointMethods, displayName?: string): ApiEndpoint<TIn, TOut, readonly [], object, any, AnyObject>;
+    /** Creates an instance and applies 'GET' method for it. */
+    static get<TOut>(displayName?: string): ApiEndpoint<null, TOut, readonly [], object, any, AnyObject>;
+    /** Creates an instance and applies 'POST' method for it. */
+    static post<TIn extends object | null, TOut = void>(displayName?: string): ApiEndpoint<TIn, TOut, readonly [], object, any, AnyObject>;
+    /** Creates an instance and applies 'DELETE' method for it. */
+    static delete<TOut>(displayName?: string): ApiEndpoint<null, TOut, readonly [], object, any, AnyObject>;
+    /** Applies a type based on {@link Path.IBuilder} type by accepting arguments for {@link Path.construct} function */
+    withPath<P extends Path.BaseInput[]>(...path: P): ApiEndpoint<TIn, TOut, Path.ExtractArgs<Path.CombineBuilders<P>>, TQuery, TErrors, THeaders>;
+    /** Applies query type and also store query keys to make api caller be able to distinguish which keys should be ejected from request body. */
+    withQuery<TQ extends object>(...queryKeys: (string & keyof TQ)[]): ApiEndpoint<TIn, TOut, TPath, TQ, TErrors, THeaders>;
+    /** Applies error type, optionally stores error processor. */
+    withErrors<TErr>(errorProcessor?: (err: TErr) => void): ApiEndpoint<TIn, TOut, TPath, TQuery, TErr, THeaders>;
+    /** Applies headers type. */
+    withHeaders<THeads>(_headersMarker?: THeads): ApiEndpoint<TIn, TOut, TPath, TQuery, TErrors, THeads>;
+    /** Marks this instance as one has to be sent as form.
+     *
+     * TODO: introduce more content types support.
+     */
+    asForm(): this;
+}

package/types/api/endpoint.types.d.ts

@@ -0,0 +1,45 @@
+import { Path } from '../structures/path';
+import { AnyObject, Coalesce, EmptyObjectNullable } from '../types/misc';
+import { EndpointMethods } from './methods';
+export interface IEndpointInfo {
+    readonly method: EndpointMethods;
+    readonly isForm?: boolean;
+    readonly pathBuilder: Path.IBuilder;
+    readonly displayName?: string;
+    readonly errorProcessor?: (err?: any) => void;
+    readonly queryKeys?: string[];
+}
+export declare namespace IEndpointInfo {
+    export interface IIn<TIn extends object | null> {
+        readonly in?: TIn;
+    }
+    export class IOut<TOut> {
+        readonly out?: TOut;
+    }
+    export interface IPath<TPath extends readonly string[]> {
+        readonly path: Path.SwitchBuilder<TPath>;
+    }
+    export type QueryKeysType = boolean | string | string[] | number | number[];
+    export type QueryArgs = Record<string, QueryKeysType>;
+    export interface IQuery<TQuery extends object> {
+        /** actual query keys to be used in argument object parsing */
+        readonly queryKeys?: (string & keyof TQuery)[];
+        /** dummy marker object for better type determining */
+        readonly queryTemplate?: TQuery;
+    }
+    export interface IErrors<TErrors> {
+        readonly errorProcessor?: (err: TErrors) => void;
+    }
+    export interface IHeaders<THeaders> {
+        readonly headers?: THeaders;
+    }
+    type Any = AnyObject;
+    type Empty = EmptyObjectNullable;
+    export type ExtractIn<T> = T extends IIn<infer TIn> ? Coalesce<TIn> : Empty;
+    export type ExtractPath<T> = T extends IPath<infer TPath extends string[]> ? (readonly [] extends TPath ? Empty : Path.ObjectBuilderArgs<TPath[number]>) : Empty;
+    export type ExtractQuery<T> = T extends IQuery<infer TQuery extends QueryArgs> ? TQuery : Empty;
+    export type ExtractOut<T> = T extends IOut<infer TOut> ? TOut : never;
+    export type ExtractErrors<T> = T extends IErrors<infer TErrors> ? TErrors : Any;
+    export type ExtractHeaders<T> = T extends IHeaders<infer THeaders> ? THeaders : Any;
+    export {};
+}

package/types/api/error.d.ts

@@ -0,0 +1,17 @@
+import { StatusCodes } from './statusCodes';
+export type ApiErrorResponse<TCause = never, TErrors = number | string> = {
+    code?: TErrors;
+    message?: string;
+} & ([TCause] extends [never] ? object : {
+    cause?: TCause;
+});
+export declare namespace ApiErrorResponse {
+    function create<TCause = never, TErrors = number | string>(code: TErrors, message?: string, cause?: TCause): ApiErrorResponse<TCause, TErrors>;
+}
+export declare class ApiError<TCause = unknown, TCodes extends number = StatusCodes, TErrors extends number | string = number | string> extends Error {
+    readonly status: TCodes;
+    readonly code: TErrors;
+    readonly cause?: TCause;
+    constructor(status: TCodes, code: TErrors, message: string, cause?: TCause);
+    static fromResponse<TCodes extends number = StatusCodes, TErrors extends number | string = number | string>(status: TCodes, responseData: unknown): ApiError<unknown, TCodes, 0> | ApiError<unknown, TCodes, TErrors>;
+}

package/types/api/helpers.d.ts

@@ -0,0 +1,9 @@
+import { IEndpointInfo } from './endpoint';
+export declare const DefaultSettings: {
+    templateArgPrefix: string;
+    basePrefix: string;
+};
+export declare function setDefaults(settings: Partial<typeof DefaultSettings>): void;
+export declare function getPath<T extends IEndpointInfo>(endpoint: T, pathArgs: IEndpointInfo.ExtractPath<T>, prefix?: string | boolean): string;
+export declare function getTemplate<T extends IEndpointInfo>(endpoint: T, prefix?: string | boolean): string;
+export declare function getFormattedDisplayName(endpoint: IEndpointInfo): string;

package/types/api/index.d.ts

@@ -0,0 +1,8 @@
+export type { ProcessingFn } from './processor';
+export { ApiEndpoint } from './endpoint';
+export type * from './endpoint.types';
+export { EndpointMethods } from './methods';
+export * from './helpers';
+export { buildApiCaller } from './call';
+export { registerPostProcessor, registerPreProcessor } from './register';
+export { LogTypes } from './logging';

package/types/api/logging.d.ts

@@ -0,0 +1,13 @@
+import { Nullable } from '../types';
+export type LogTypes<TIn = any, TOut = any> = boolean | 'full' | LogTypes.Dir | {
+    req?: boolean | LogTypes.LogFn<TIn>;
+    res?: boolean | LogTypes.LogFn<TOut>;
+};
+export declare namespace LogTypes {
+    type Dir = 'req' | 'res';
+    type LogFn<T = any> = (data: T) => void | string | any[];
+    function getIsEnabled<T = unknown>(type: Nullable<LogTypes>, dir: Dir): {
+        enabled: boolean;
+        formatter?: Nullable<(data: T) => unknown>;
+    };
+}

package/types/api/methods.d.ts

@@ -0,0 +1,6 @@
+export declare enum EndpointMethods {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE"
+}

package/types/api/processor.d.ts

@@ -0,0 +1,7 @@
+export type ProcessingFn<T = unknown> = (input: T) => T;
+export declare class ProcessorsRegistry<K> {
+    private readonly _map;
+    cleanup(): void;
+    register<P>(key: K, processor: ProcessingFn<P>, name?: string): () => void;
+    process<T>(key: K, input: T): T;
+}

package/types/api/register.d.ts

@@ -0,0 +1,7 @@
+import { ProcessingFn, ProcessorsRegistry } from './processor';
+import { IEndpointInfo } from './endpoint';
+export declare const PreProcessors: ProcessorsRegistry<IEndpointInfo>;
+export declare const PostProcessors: ProcessorsRegistry<IEndpointInfo>;
+export declare function cleanupProcessors(): void;
+export declare function registerPreProcessor<T extends IEndpointInfo>(api: T, processor: ProcessingFn<IEndpointInfo.ExtractIn<T>>, name?: string): () => void;
+export declare function registerPostProcessor<T extends IEndpointInfo>(api: T, processor: ProcessingFn<IEndpointInfo.ExtractOut<T>>, name?: string): () => void;

package/types/api/statusCodes.d.ts

@@ -0,0 +1,16 @@
+export declare enum StatusCodes {
+    OK = 200,
+    CREATED = 201,
+    FOUND = 302,
+    NOT_MODIFIED = 304,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    CONFLICT = 409,
+    PRECONDITION_FAILED = 412,
+    UPGRADE_REQUIRED = 426,
+    INTERNAL_SERVER_ERROR = 500,
+    SERVICE_UNAVAILABLE = 503
+}

package/types/async/arrays.d.ts

@@ -0,0 +1,4 @@
+export declare function someAsync<T>(target: ReadonlyArray<T>, condition: (v: T, index?: number, arr?: ReadonlyArray<T>) => Promise<boolean>): Promise<boolean>;
+export declare function everyAsync<T>(target: ReadonlyArray<T>, condition: (v: T, index?: number, arr?: ReadonlyArray<T>) => Promise<boolean>): Promise<boolean>;
+export declare function forEachAsync<T>(target: ReadonlyArray<T>, cb: (v: T, index?: number, arr?: ReadonlyArray<T>) => Promise<void>): Promise<void>;
+export declare function mapAsync<T, R>(target: ReadonlyArray<T>, cb: (v: T, index?: number, arr?: ReadonlyArray<T>) => Promise<R>): Promise<R[]>;

package/types/async/misc.d.ts

@@ -0,0 +1,8 @@
+export declare function OptAwait<T>(cb: () => (T | Promise<T>), doAwait: boolean): Promise<T>;
+export declare function chainPromises(...promises: (() => Promise<void>)[]): Promise<void>;
+export type ManualPromise<T> = {
+    readonly promise: Promise<T>;
+    readonly resolve: (res: T) => void;
+    readonly reject: (err: Error) => void;
+};
+export declare function createManualPromise<T = void>(): ManualPromise<T>;

package/types/async/timeout.d.ts

@@ -0,0 +1,8 @@
+export declare function setTimeoutAsync(ms: number, useCancel?: null | ((cb: () => void) => void)): Promise<void>;
+export declare function timeoutPromise<T>(p: Promise<T>, timeoutMs: number, waitForMinElapsed?: number): Promise<{
+    resolved: T | undefined;
+    timedOut?: boolean;
+    elapsed: number;
+}>;
+/** @deprecated Not Supported! Moved to `@zajno/common-web` package due to dependency on DOM's `requestAnimationFrame` */
+export declare function setTimeoutFramesAsync(): void;

package/types/dates/calc.d.ts

@@ -0,0 +1,9 @@
+import { Granularity } from './types';
+export declare function contains(start: Date | number, end: Date | number, target: Date | number, granularity?: Granularity): boolean;
+export declare function intersects(start1: Date | number, end1: Date | number, start2: Date | number, end2: Date | number, granularity?: Granularity): boolean;
+export declare function countDays(start: Date, end: Date, condition?: (d: Date) => boolean): number;
+export declare function compare(d1: Date | number, d2: Date | number, g: Granularity, local?: boolean): number;
+export declare function compare(d1: Date | number, d2: Date | number): number;
+export declare function min(d1: Date, d2: Date): Date;
+export declare function max(d1: Date, d2: Date): Date;
+export declare function clamp(d: Date, low: Date, high: Date): Date;

package/types/dates/calendarIndex.d.ts

@@ -0,0 +1,47 @@
+export interface IMonthIndex {
+    month: number;
+}
+export interface IWeekIndex extends IMonthIndex {
+    week: number;
+}
+export interface IDayIndex extends IWeekIndex {
+    day: number;
+}
+/**
+ * Helps with converting sequential index to 0- or 1-based month, week, day index.
+ *
+ * Allows to use any number of days per week, not just 7. Also one can set any number of weeks per month (but it will be used globally).
+ *
+ * To update the value, either set `raw` property or use `set` method.
+ *
+ * Usage case: some ordered sequence of items, each has its own index, and you want to distribute them by months, weeks and days, knowing the number of items assigned per week.
+ */
+export declare class CalendarIndex implements IDayIndex {
+    readonly perWeek: number;
+    readonly base: 1 | 0;
+    static WEEKS_PER_MONTH: number;
+    /** sequential index */
+    raw: number;
+    /**
+     * @param perWeek how many indexes allocated per week
+     * @param [base=0] 1 or 0 - determines base for all indexes (0 by default)
+     */
+    constructor(perWeek?: number, base?: 1 | 0);
+    get perMonth(): number;
+    /** 1/0-based month index based on `perWeek` property */
+    get month(): number;
+    get fullWeek(): number;
+    /** 1/0-based week index based on `perWeek` property */
+    get week(): number;
+    get day(): number;
+    set(month: number, week?: number, day?: number): this;
+    toIndex(): IDayIndex;
+    clone(): CalendarIndex;
+}
+/** returns based (1/0) remainder of `value / div`
+ *
+ * Ex.: get day of week
+*/
+export declare function basedRemainder(this: void, base: 1 | 0, value: number, div: number): number;
+/** returns based (1/0) floor'ed of `value / div` */
+export declare function basedFloor(this: void, base: 1 | 0, value: number, div: number): number;

package/types/dates/convert.d.ts

@@ -0,0 +1,15 @@
+import { Granularity } from './types';
+type DateFields<T> = {
+    [P in keyof T]: T[P] extends Date ? P : never;
+}[keyof T];
+export declare function ensureDates<T>(obj: T, ...fields: DateFields<T>[]): void;
+export declare function isNetworkDay(n: number): boolean;
+export declare function isNetworkDate(d: Date): boolean;
+export declare function unix(d: Date | number): number;
+export declare function unixDayIndex(d: Date | number): number;
+export declare function dateFromUnixDayIndex(d: number): Date;
+export declare function decomposeDate<K extends Granularity>(d: Date, local: boolean, ...grans: K[]): Record<K, number>;
+export declare function splitDatesByDay(dates: number[]): number[][];
+export declare function getDiscreteDiff(d1: number | Date, d2: number | Date, granularity: Granularity, local?: boolean, absolute?: boolean): number;
+export declare function getDaysStreak(dates: number[], descentOrder: boolean): number;
+export {};