desktopr 1.3.1 → 2.0.1

package/dist-sdk/utils/utils/_regexPatterns.d.ts

@@ -0,0 +1,113 @@
+export declare const RE_WS: RegExp;
+export declare const RE_QUERY_SENSITIVE: RegExp;
+export declare const RE_AUTH: RegExp;
+export declare const RE_AWS_ACCESS_KEY: RegExp;
+export declare const RE_SECRET40: RegExp;
+export declare const RE_LONG_DIGITS: RegExp;
+export declare const RE_IPV4_NOLB: RegExp;
+export declare const RE_PATH_SECRET: RegExp;
+export declare const RE_PEM_BLOCK: RegExp;
+export declare const RE_WHITESPACE: RegExp;
+export declare const RE_NON_WORD: RegExp;
+export declare const RE_SLUG: RegExp;
+export declare const RE_USERNAME_SIMPLE: RegExp;
+export declare const RE_HASHTAG: RegExp;
+export declare const RE_MENTION: RegExp;
+export declare const RE_INT: RegExp;
+export declare const RE_FLOAT: RegExp;
+export declare const RE_NUMBER_THOUSANDS: RegExp;
+export declare const RE_HEX_PREFIXED: RegExp;
+export declare const RE_HEX_COLOR: RegExp;
+export declare const RE_RGB: RegExp;
+export declare const RE_RGBA: RegExp;
+export declare const RE_HSL: RegExp;
+export declare const RE_HSLA: RegExp;
+export declare const RE_EMAIL: RegExp;
+export declare const RE_DOMAIN: RegExp;
+export declare const RE_URL_HTTP: RegExp;
+export declare const RE_URL_SIMPLE: RegExp;
+export declare const RE_IPV4: RegExp;
+export declare const RE_IPV6_SIMPLE: RegExp;
+export declare const RE_MAC: RegExp;
+export declare const RE_HOSTPORT: RegExp;
+export declare const RE_E164_PHONE: RegExp;
+export declare const RE_DATE_ISO: RegExp;
+export declare const RE_TIME_24H: RegExp;
+export declare const RE_TIME_12H: RegExp;
+export declare const RE_DATETIME_ISO: RegExp;
+export declare const RE_DATE_DDMMYYYY: RegExp;
+export declare const RE_DATE_MMDDYYYY: RegExp;
+export declare const RE_TZ_OFFSET: RegExp;
+export declare const RE_UUID_ANY: RegExp;
+export declare const RE_UUID_V4: RegExp;
+export declare const RE_ULID: RegExp;
+export declare const RE_BASE64: RegExp;
+export declare const RE_JWT: RegExp;
+export declare const RE_SHA1: RegExp;
+export declare const RE_SHA256: RegExp;
+export declare const RE_GIT_COMMIT: RegExp;
+export declare const RE_IBAN_GENERIC: RegExp;
+export declare const RE_CREDITCARD_GENERIC: RegExp;
+export declare const RE_VISA: RegExp;
+export declare const RE_MASTERCARD: RegExp;
+export declare const RE_CURRENCY_GENERIC: RegExp;
+export declare const RE_PERCENT: RegExp;
+export declare const RE_ZIP_US: RegExp;
+export declare const RE_CAP_IT: RegExp;
+export declare const RE_POSTCODE_UK_APPROX: RegExp;
+export declare const RE_FILENAME_SAFE: RegExp;
+export declare const RE_UNIX_PATH: RegExp;
+export declare const RE_WINDOWS_PATH: RegExp;
+export declare const RE_EXTENSION: RegExp;
+export declare const RE_MIME_TYPE: RegExp;
+export declare const RE_LAT: RegExp;
+export declare const RE_LON: RegExp;
+export declare const RE_LATLON_PAIR: RegExp;
+export declare const RE_CAMEL_CASE: RegExp;
+export declare const RE_PASCAL_CASE: RegExp;
+export declare const RE_SNAKE_CASE: RegExp;
+export declare const RE_KEBAB_CASE: RegExp;
+export declare const RE_HTML_TAG: RegExp;
+export declare const RE_CSV_LINE: RegExp;
+export declare const RE_PASSWORD_STRONG: RegExp;
+export declare const RE_IPV6: RegExp;
+export declare const RE_CF_IT_STRICT: RegExp;
+export declare const RE_CF_IT_OMOCODIA: RegExp;
+export declare const RE_PIVA_IT: RegExp;
+export declare const RE_PEC_IT_STRICT: RegExp;
+export declare const RE_PEC_GENERIC: RegExp;
+export declare const RE_VAT_AT: RegExp;
+export declare const RE_VAT_BE: RegExp;
+export declare const RE_VAT_BG: RegExp;
+export declare const RE_VAT_HR: RegExp;
+export declare const RE_VAT_CY: RegExp;
+export declare const RE_VAT_CZ: RegExp;
+export declare const RE_VAT_DK: RegExp;
+export declare const RE_VAT_EE: RegExp;
+export declare const RE_VAT_FI: RegExp;
+export declare const RE_VAT_FR: RegExp;
+export declare const RE_VAT_DE: RegExp;
+export declare const RE_VAT_EL: RegExp;
+export declare const RE_VAT_HU: RegExp;
+export declare const RE_VAT_IE: RegExp;
+export declare const RE_VAT_IT: RegExp;
+export declare const RE_VAT_LV: RegExp;
+export declare const RE_VAT_LT: RegExp;
+export declare const RE_VAT_LU: RegExp;
+export declare const RE_VAT_MT: RegExp;
+export declare const RE_VAT_NL: RegExp;
+export declare const RE_VAT_PL: RegExp;
+export declare const RE_VAT_PT: RegExp;
+export declare const RE_VAT_RO: RegExp;
+export declare const RE_VAT_SK: RegExp;
+export declare const RE_VAT_SI: RegExp;
+export declare const RE_VAT_ES: RegExp;
+export declare const RE_VAT_SE: RegExp;
+export declare const RE_S3_URI: RegExp;
+export declare const RE_S3_VHOST_URL: RegExp;
+export declare const RE_S3_PATH_URL: RegExp;
+export declare const RE_R2_PUBLIC_URL: RegExp;
+export declare const RE_R2_S3_COMPAT_URL: RegExp;
+export declare const RE_SEMVER: RegExp;
+export declare const RE_SEMVER_RANGE_SIMPLE: RegExp;
+export declare const RE_SEMVER_RANGE_COMPARATORS: RegExp;

package/dist-sdk/utils/utils/_regexPatterns.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RE_CREDITCARD_GENERIC = exports.RE_IBAN_GENERIC = exports.RE_GIT_COMMIT = exports.RE_SHA256 = exports.RE_SHA1 = exports.RE_JWT = exports.RE_BASE64 = exports.RE_ULID = exports.RE_UUID_V4 = exports.RE_UUID_ANY = exports.RE_TZ_OFFSET = exports.RE_DATE_MMDDYYYY = exports.RE_DATE_DDMMYYYY = exports.RE_DATETIME_ISO = exports.RE_TIME_12H = exports.RE_TIME_24H = exports.RE_DATE_ISO = exports.RE_E164_PHONE = exports.RE_HOSTPORT = exports.RE_MAC = exports.RE_IPV6_SIMPLE = exports.RE_IPV4 = exports.RE_URL_SIMPLE = exports.RE_URL_HTTP = exports.RE_DOMAIN = exports.RE_EMAIL = exports.RE_HSLA = exports.RE_HSL = exports.RE_RGBA = exports.RE_RGB = exports.RE_HEX_COLOR = exports.RE_HEX_PREFIXED = exports.RE_NUMBER_THOUSANDS = exports.RE_FLOAT = exports.RE_INT = exports.RE_MENTION = exports.RE_HASHTAG = exports.RE_USERNAME_SIMPLE = exports.RE_SLUG = exports.RE_NON_WORD = exports.RE_WHITESPACE = exports.RE_PEM_BLOCK = exports.RE_PATH_SECRET = exports.RE_IPV4_NOLB = exports.RE_LONG_DIGITS = exports.RE_SECRET40 = exports.RE_AWS_ACCESS_KEY = exports.RE_AUTH = exports.RE_QUERY_SENSITIVE = exports.RE_WS = void 0;
+exports.RE_VAT_PT = exports.RE_VAT_PL = exports.RE_VAT_NL = exports.RE_VAT_MT = exports.RE_VAT_LU = exports.RE_VAT_LT = exports.RE_VAT_LV = exports.RE_VAT_IT = exports.RE_VAT_IE = exports.RE_VAT_HU = exports.RE_VAT_EL = exports.RE_VAT_DE = exports.RE_VAT_FR = exports.RE_VAT_FI = exports.RE_VAT_EE = exports.RE_VAT_DK = exports.RE_VAT_CZ = exports.RE_VAT_CY = exports.RE_VAT_HR = exports.RE_VAT_BG = exports.RE_VAT_BE = exports.RE_VAT_AT = exports.RE_PEC_GENERIC = exports.RE_PEC_IT_STRICT = exports.RE_PIVA_IT = exports.RE_CF_IT_OMOCODIA = exports.RE_CF_IT_STRICT = exports.RE_IPV6 = exports.RE_PASSWORD_STRONG = exports.RE_CSV_LINE = exports.RE_HTML_TAG = exports.RE_KEBAB_CASE = exports.RE_SNAKE_CASE = exports.RE_PASCAL_CASE = exports.RE_CAMEL_CASE = exports.RE_LATLON_PAIR = exports.RE_LON = exports.RE_LAT = exports.RE_MIME_TYPE = exports.RE_EXTENSION = exports.RE_WINDOWS_PATH = exports.RE_UNIX_PATH = exports.RE_FILENAME_SAFE = exports.RE_POSTCODE_UK_APPROX = exports.RE_CAP_IT = exports.RE_ZIP_US = exports.RE_PERCENT = exports.RE_CURRENCY_GENERIC = exports.RE_MASTERCARD = exports.RE_VISA = void 0;
+exports.RE_SEMVER_RANGE_COMPARATORS = exports.RE_SEMVER_RANGE_SIMPLE = exports.RE_SEMVER = exports.RE_R2_S3_COMPAT_URL = exports.RE_R2_PUBLIC_URL = exports.RE_S3_PATH_URL = exports.RE_S3_VHOST_URL = exports.RE_S3_URI = exports.RE_VAT_SE = exports.RE_VAT_ES = exports.RE_VAT_SI = exports.RE_VAT_SK = exports.RE_VAT_RO = void 0;
+// ===== Generice sensitive data =====
+exports.RE_WS = /\s+/g;
+exports.RE_QUERY_SENSITIVE = /([?&])(token|api[_-]?key|key|signature|password|pass|pwd|code|secret|client[_-]?secret|access[_-]?token)=([^&#\s]+)/gi;
+exports.RE_AUTH = /\b(authorization|bearer|basic)\b[: ]+\S+/gi;
+exports.RE_AWS_ACCESS_KEY = /\bAKIA[0-9A-Z]{16}\b/g;
+exports.RE_SECRET40 = /\b[A-Za-z0-9/+]{40}\b/g; // may overmatch harmless 40-char base64
+exports.RE_LONG_DIGITS = /\b(?:\d[ -]?){13,19}\b/g; // potential cards/accounts
+exports.RE_IPV4_NOLB = /(^|[^0-9])((?:\d{1,3}\.){3}\d{1,3})(?!\d)/g; // no lookbehind
+exports.RE_PATH_SECRET = /\/(token|key|secret|signature|passwd|password|code)\/[^\/?#\s]+/gi;
+exports.RE_PEM_BLOCK = /-----BEGIN [A-Z ]+-----[\s\S]*?-----END [A-Z ]+-----/g;
+// ===== Text / tokens =====
+exports.RE_WHITESPACE = /\s+/g;
+exports.RE_NON_WORD = /\W+/g;
+exports.RE_SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+exports.RE_USERNAME_SIMPLE = /^[A-Z0-9_]{3,20}$/i;
+exports.RE_HASHTAG = /(^|\s)#([A-Z0-9_]{1,30})/gi;
+exports.RE_MENTION = /(^|[^@\w])@([A-Z0-9_]{1,30})/gi;
+// ===== Numbers / formats =====
+exports.RE_INT = /^[+-]?\d+$/;
+exports.RE_FLOAT = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?$/;
+exports.RE_NUMBER_THOUSANDS = /^-?\d{1,3}(?:[.,]\d{3})*(?:[.,]\d+)?$/;
+exports.RE_HEX_PREFIXED = /^0x[0-9A-F]+$/i;
+// ===== Colors (CSS) =====
+exports.RE_HEX_COLOR = /^#(?:[0-9A-F]{3}|[0-9A-F]{6}|[0-9A-F]{8})$/i;
+exports.RE_RGB = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/i;
+exports.RE_RGBA = /^rgba\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(0|1|0?\.\d+)\s*\)$/i;
+exports.RE_HSL = /^hsl\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*\)$/i;
+exports.RE_HSLA = /^hsla\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*,\s*(0|1|0?\.\d+)\s*\)$/i;
+// ===== Web / networking =====
+exports.RE_EMAIL = /\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi;
+exports.RE_DOMAIN = /^(?:[A-Z0-9](?:[A-Z0-9-]{0,61}[A-Z0-9])?\.)+[A-Z]{2,}$/i;
+exports.RE_URL_HTTP = /^(https?:\/\/)[^\s/$.?#].[^\s]*$/i;
+exports.RE_URL_SIMPLE = /^(https?:\/\/)?(?:[A-Z0-9-]+\.)+[A-Z]{2,}(?:\/[^\s]*)?$/i;
+exports.RE_IPV4 = /^(?:25[0-5]|2[0-4]\d|1?\d?\d)(?:\.(?:25[0-5]|2[0-4]\d|1?\d?\d)){3}$/;
+exports.RE_IPV6_SIMPLE = /^([A-F0-9]{1,4}:){7}[A-F0-9]{1,4}$/i; // no '::' compression
+exports.RE_MAC = /^([0-9A-F]{2}[:-]){5}[0-9A-F]{2}$/i;
+exports.RE_HOSTPORT = /^(?:\[(?:[A-F0-9:]+)\]|(?:\d{1,3}\.){3}\d{1,3}|(?:[A-Z0-9-]+\.)+[A-Z]{2,})(?::\d{1,5})?$/i;
+exports.RE_E164_PHONE = /^\+?[1-9]\d{1,14}$/;
+// ===== Dates / times =====
+exports.RE_DATE_ISO = /^\d{4}-\d{2}-\d{2}$/;
+exports.RE_TIME_24H = /^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$/;
+exports.RE_TIME_12H = /^(?:0?[1-9]|1[0-2]):[0-5]\d(?::[0-5]\d)?\s?(?:AM|PM)$/i;
+exports.RE_DATETIME_ISO = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
+exports.RE_DATE_DDMMYYYY = /^(0?[1-9]|[12]\d|3[01])[\/.-](0?[1-9]|1[0-2])[\/.-]\d{4}$/;
+exports.RE_DATE_MMDDYYYY = /^(0?[1-9]|1[0-2])[\/.-](0?[1-9]|[12]\d|3[01])[\/.-]\d{4}$/;
+exports.RE_TZ_OFFSET = /^[+-](?:0\d|1[0-4]):[0-5]\d$/; // ±HH:MM (up to 14)
+// ===== Identifiers / encodings =====
+exports.RE_UUID_ANY = /^[0-9A-F]{8}-[0-9A-F]{4}-[1-5][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;
+exports.RE_UUID_V4 = /^[0-9A-F]{8}-[0-9A-F]{4}-4[0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;
+exports.RE_ULID = /^[0-9A-HJKMNP-TV-Z]{26}$/i;
+exports.RE_BASE64 = /^(?:[A-Z0-9+\/]{4})*(?:[A-Z0-9+\/]{2}==|[A-Z0-9+\/]{3}=)?$/i;
+exports.RE_JWT = /\b([A-Za-z0-9-_]{10,})\.([A-Za-z0-9-_]{10,})(?:\.([A-Za-z0-9-_]{5,}))?\b/g;
+exports.RE_SHA1 = /^[A-F0-9]{40}$/i;
+exports.RE_SHA256 = /^[A-F0-9]{64}$/i;
+exports.RE_GIT_COMMIT = /^[0-9A-F]{7,40}$/i;
+exports.RE_IBAN_GENERIC = /^[A-Z]{2}\d{2}[A-Z0-9]{1,30}$/;
+// ===== Payment-like (approximate) =====
+exports.RE_CREDITCARD_GENERIC = /^(?:4\d{12}(?:\d{3})?|5[1-5]\d{14}|3[47]\d{13}|3(?:0[0-5]|[68]\d)\d{11}|6(?:011|5\d{2})\d{12})$/;
+exports.RE_VISA = /^4\d{12}(\d{3})?$/;
+exports.RE_MASTERCARD = /^(5[1-5]\d{14}|2(?:2[2-9]\d|[3-6]\d{2}|7(?:[01]\d|20))\d{12})$/;
+// ===== Currency / amounts =====
+exports.RE_CURRENCY_GENERIC = /^(?:[A-Z]{3}|[$€£])\s?\d{1,3}(?:[.,]\d{3})*(?:[.,]\d{2})?$/;
+exports.RE_PERCENT = /^(?:100(?:\.0+)?|(?:\d{1,2})(?:\.\d+)?)%$/;
+// ===== Postal codes (examples) =====
+exports.RE_ZIP_US = /^\d{5}(?:-\d{4})?$/;
+exports.RE_CAP_IT = /^\d{5}$/;
+exports.RE_POSTCODE_UK_APPROX = /^[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2}$/i;
+// ===== File paths / names =====
+exports.RE_FILENAME_SAFE = /^[A-Z0-9._-]+$/i;
+exports.RE_UNIX_PATH = /^(\/[^/\0]+)+\/?$/;
+exports.RE_WINDOWS_PATH = /^(?:[A-Z]:\\|\\\\)[^\s<>:"|?*]+$/i;
+exports.RE_EXTENSION = /^[^.]+\.[A-Z0-9]+$/i;
+exports.RE_MIME_TYPE = /^[a-z]+\/[a-z0-9+.-]+$/i;
+// ===== Coordinates =====
+exports.RE_LAT = /^-?(?:[1-8]?\d(?:\.\d+)?|90(?:\.0+)?)$/;
+exports.RE_LON = /^-?(?:1[0-7]\d(?:\.\d+)?|[1-9]?\d(?:\.\d+)?|180(?:\.0+)?)$/;
+exports.RE_LATLON_PAIR = /^\s*-?\d+(?:\.\d+)?\s*,\s*-?\d+(?:\.\d+)?\s*$/;
+// ===== Case styles =====
+exports.RE_CAMEL_CASE = /^(?:[a-z]+(?:[A-Z][a-z0-9]+)*)$/;
+exports.RE_PASCAL_CASE = /^(?:[A-Z][a-z0-9]+)+$/;
+exports.RE_SNAKE_CASE = /^[a-z0-9]+(?:_[a-z0-9]+)+$/;
+exports.RE_KEBAB_CASE = /^[a-z0-9]+(?:-[a-z0-9]+)+$/;
+// ===== HTML / CSV =====
+exports.RE_HTML_TAG = /<[^>]+>/;
+exports.RE_CSV_LINE = /^(?:"[^"]*"|[^",]*)(?:,(?:"[^"]*"|[^",]*))*$/;
+// ===== Password policy (example) =====
+exports.RE_PASSWORD_STRONG = /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[^A-Za-z0-9]).{8,}$/;
+// ===== IP addresses =====
+exports.RE_IPV6 = /^((?:[A-F0-9]{1,4}:){7}[A-F0-9]{1,4}|(?:[A-F0-9]{1,4}:){1,7}:|(?:[A-F0-9]{1,4}:){1,6}:[A-F0-9]{1,4}|(?:[A-F0-9]{1,4}:){1,5}(?::[A-F0-9]{1,4}){1,2}|(?:[A-F0-9]{1,4}:){1,4}(?::[A-F0-9]{1,4}){1,3}|(?:[A-F0-9]{1,4}:){1,3}(?::[A-F0-9]{1,4}){1,4}|(?:[A-F0-9]{1,4}:){1,2}(?::[A-F0-9]{1,4}){1,5}|[A-F0-9]{1,4}:(?::[A-F0-9]{1,4}){1,6}|:(?::[A-F0-9]{1,4}){1,7})(?:%\w+)?$/i; // compressed + zone id
+// ===== Italy: Codice Fiscale & Partita IVA =====
+// Strict (no "omocodia" substitutions)
+exports.RE_CF_IT_STRICT = /^[A-Z]{6}\d{2}[A-EHLMPRST]\d{2}[A-Z]\d{3}[A-Z]$/;
+// Omocodia allowed (L,M,N,P,Q,R,S,T,U,V standing in for digits)
+exports.RE_CF_IT_OMOCODIA = /^[A-Z]{6}[0-9LMNPQRSTUV]{2}[A-EHLMPRST][0-9LMNPQRSTUV]{2}[A-Z][0-9LMNPQRSTUV]{3}[A-Z]$/;
+// Partita IVA (11 digits), with optional "IT" prefix
+exports.RE_PIVA_IT = /^(?:IT\s*)?\d{11}$/i;
+// ===== PEC (Posta Elettronica Certificata) =====
+exports.RE_PEC_IT_STRICT = /^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.PEC\.IT$/i; // ends with .pec.it
+exports.RE_PEC_GENERIC = /^[A-Z0-9._%+-]+@[A-Z0-9.-]*\.PEC\.[A-Z]{2,}$/i; // any TLD with ".pec."
+// ===== EU VAT (per country; pragmatic patterns) =====
+exports.RE_VAT_AT = /^ATU\d{8}$/; // Austria
+exports.RE_VAT_BE = /^BE0?\d{9}$/; // Belgium
+exports.RE_VAT_BG = /^BG\d{9,10}$/; // Bulgaria
+exports.RE_VAT_HR = /^HR\d{11}$/; // Croatia
+exports.RE_VAT_CY = /^CY\d{8}[A-Z]$/i; // Cyprus
+exports.RE_VAT_CZ = /^CZ\d{8,10}$/; // Czechia
+exports.RE_VAT_DK = /^DK\d{8}$/; // Denmark
+exports.RE_VAT_EE = /^EE\d{9}$/; // Estonia
+exports.RE_VAT_FI = /^FI\d{8}$/; // Finland
+exports.RE_VAT_FR = /^FR[0-9A-Z]{2}\d{9}$/i; // France (2-char key + 9 digits)
+exports.RE_VAT_DE = /^DE\d{9}$/; // Germany
+exports.RE_VAT_EL = /^EL\d{9}$/; // Greece (EL)
+exports.RE_VAT_HU = /^HU\d{8}$/; // Hungary
+exports.RE_VAT_IE = /^IE\d{7}[A-W][A-I]?$/i; // Ireland (approx)
+exports.RE_VAT_IT = /^IT\d{11}$/; // Italy
+exports.RE_VAT_LV = /^LV\d{11}$/; // Latvia
+exports.RE_VAT_LT = /^LT(\d{9}|\d{12})$/; // Lithuania
+exports.RE_VAT_LU = /^LU\d{8}$/; // Luxembourg
+exports.RE_VAT_MT = /^MT\d{8}$/; // Malta
+exports.RE_VAT_NL = /^NL\d{9}B\d{2}$/; // Netherlands
+exports.RE_VAT_PL = /^PL\d{10}$/; // Poland
+exports.RE_VAT_PT = /^PT\d{9}$/; // Portugal
+exports.RE_VAT_RO = /^RO\d{2,10}$/; // Romania
+exports.RE_VAT_SK = /^SK\d{10}$/; // Slovakia
+exports.RE_VAT_SI = /^SI\d{8}$/; // Slovenia
+exports.RE_VAT_ES = /^ES[A-Z0-9]\d{7}[A-Z0-9]$/i; // Spain
+exports.RE_VAT_SE = /^SE\d{12}$/; // Sweden
+// ===== S3 / R2 object URLs & URIs =====
+// S3 URI like: s3://bucket/key
+exports.RE_S3_URI = /^s3:\/\/[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]\/.+$/;
+// S3 virtual-hosted–style: https://bucket.s3.amazonaws.com/key (any region suffix acceptable)
+exports.RE_S3_VHOST_URL = /^https?:\/\/[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]\.s3[.-][a-z0-9-]+\.amazonaws\.com\/.+$/i;
+// S3 path-style: https://s3.region.amazonaws.com/bucket/key
+exports.RE_S3_PATH_URL = /^https?:\/\/s3[.-][a-z0-9-]+\.amazonaws\.com\/[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]\/.+$/i;
+// R2 public (account endpoint): https://<accountid>.r2.cloudflarestorage.com/bucket/key
+exports.RE_R2_PUBLIC_URL = /^https?:\/\/[a-z0-9]{32}\.r2\.cloudflarestorage\.com\/[A-Za-z0-9._-]{3,63}\/.+$/;
+// R2 S3-compatible (custom endpoint host): https?:\/\/<host>/bucket/key  — keep broad
+exports.RE_R2_S3_COMPAT_URL = /^https?:\/\/[A-Z0-9.-]+\/[A-Za-z0-9._-]{3,63}\/.+$/i;
+// ===== SemVer (versions & ranges) =====
+// Exact SemVer (same as before, strict)
+exports.RE_SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?(?:\+[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?$/i;
+// Simple ranges with ^ or ~ and OR (pragmatic)
+exports.RE_SEMVER_RANGE_SIMPLE = /^(?:[~^]?\d+\.\d+\.\d+(?:-[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?(?:\+[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?)(?:\s*\|\|\s*[~^]?\d+\.\d+\.\d+(?:-[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?(?:\+[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?)*$/i;
+// Comparators like >=1.2.3 <2.0.0 (basic)
+exports.RE_SEMVER_RANGE_COMPARATORS = /^(?:[<>]=?\s*\d+\.\d+\.\d+(?:-[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?(?:\+[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?\s*)+(?:\|\|\s*(?:[<>]=?\s*\d+\.\d+\.\d+(?:-[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?(?:\+[0-9A-Z-]+(?:\.[0-9A-Z-]+)*)?\s*)+)*$/i;

package/dist-sdk/utils/utils/_typesValidation.d.ts

@@ -0,0 +1,50 @@
+type AnyFunc = (...args: any[]) => any;
+type AsyncFunc = (...args: any[]) => Promise<any>;
+type GenFunc = (...args: any[]) => Generator<any, any, any>;
+interface Validate {
+    string(v: unknown): v is string;
+    url(v: unknown): v is string;
+    nonEmptyString(v: unknown): v is string;
+    number(v: unknown): v is number;
+    integer(v: unknown): v is number;
+    boolean(v: unknown): v is boolean;
+    bigint(v: unknown): v is bigint;
+    symbol(v: unknown): v is symbol;
+    numeric(v: unknown): boolean;
+    finiteNumber(v: unknown): v is number;
+    dateString(v: unknown): v is string;
+    date(v: unknown): v is Date;
+    isoDateString(v: unknown): v is string;
+    isoDateTimeString(v: unknown): v is string;
+    null(v: unknown): v is null;
+    undefined(v: unknown): v is undefined;
+    defined<T>(v: T | null | undefined): v is T;
+    nan(v: unknown): v is number;
+    object(v: unknown): v is Record<string, unknown>;
+    plainObject(v: unknown): v is Record<string, unknown>;
+    emptyObject(v: unknown): v is Record<string, never>;
+    array<T = unknown>(v: unknown): v is T[];
+    nonEmptyArray<T = unknown>(v: unknown): v is T[];
+    set<T = unknown>(v: unknown): v is Set<T>;
+    map<K = unknown, V = unknown>(v: unknown): v is Map<K, V>;
+    weakSet<T extends object = object>(v: unknown): v is WeakSet<T>;
+    weakMap<K extends object = object, V = unknown>(v: unknown): v is WeakMap<K, V>;
+    arrayBuffer(v: unknown): v is ArrayBuffer;
+    dataView(v: unknown): v is DataView;
+    typedArray(v: unknown): v is Exclude<ArrayBufferView, DataView>;
+    regexp(v: unknown): v is RegExp;
+    promise<T = unknown>(v: unknown): v is Promise<T>;
+    function(v: unknown): v is AnyFunc;
+    asyncFunction(v: unknown): v is AsyncFunc;
+    generatorFunction(v: unknown): v is GenFunc;
+    email(v: unknown): v is string;
+    uuid(v: unknown): v is string;
+    hexColor(v: unknown): v is string;
+    ipv4(v: unknown): v is string;
+    ipv6(v: unknown): v is string;
+    jsonString(v: unknown): v is string;
+    truthy(v: unknown): boolean;
+    falsy(v: unknown): boolean;
+}
+export declare const validate: Validate;
+export {};

package/dist-sdk/utils/utils/_typesValidation.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate = void 0;
+// ------------------ helpers ------------------
+function validateUrl(input) {
+    if (typeof input !== "string")
+        return false;
+    const s = input.trim();
+    if (s.length === 0)
+        return false;
+    try {
+        new URL(s); // richiede schema (es. https://)
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isValidDateString(value) {
+    if (typeof value !== "string")
+        return false;
+    const d = new Date(value);
+    return !Number.isNaN(d.getTime());
+}
+function isValidDateObject(value) {
+    return value instanceof Date && !Number.isNaN(value.getTime());
+}
+const ISO_DATE_RE = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
+// YYYY-MM-DDThh:mm(:ss(.sss)?)?(Z|±HH:MM)
+const ISO_DATETIME_RE = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T([01]\d|2[0-3]):([0-5]\d)(?::([0-5]\d)(\.\d{1,3})?)?(Z|[+\-](?:[01]\d|2[0-3]):?[0-5]\d)$/;
+function isIsoDateString(value) {
+    if (typeof value !== "string" || !ISO_DATE_RE.test(value))
+        return false;
+    // validazione calendario: costruisci la data e verifica corrispondenza
+    const [y, m, d] = value.split("-").map(Number);
+    const dt = new Date(Date.UTC(y, m - 1, d));
+    return (dt.getUTCFullYear() === y &&
+        dt.getUTCMonth() === m - 1 &&
+        dt.getUTCDate() === d);
+}
+function isIsoDateTimeString(value) {
+    if (typeof value !== "string" || !ISO_DATETIME_RE.test(value))
+        return false;
+    const dt = new Date(value);
+    return !Number.isNaN(dt.getTime());
+}
+// RFC 5322-lite (pragmatico)
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+// UUID v1–v5
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+// #RGB o #RRGGBB
+const HEX_COLOR_RE = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+// IPv4
+const IPV4_RE = /^(25[0-5]|2[0-4]\d|1\d{2}|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d{2}|[1-9]?\d)){3}$/;
+// IPv6 (compressa o piena) — accetta forme valide comuni
+const IPV6_RE = /^(([0-9A-Fa-f]{1,4}:){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}|:)))(%[0-9A-Za-z]{1,})?$/;
+// ------------------ implementation ------------------
+exports.validate = {
+    // base
+    string: (v) => typeof v === "string",
+    url: (v) => typeof v === "string" && validateUrl(v),
+    nonEmptyString: (v) => typeof v === "string" && v.trim().length > 0,
+    number: (v) => typeof v === "number" && !Number.isNaN(v),
+    integer: (v) => typeof v === "number" && Number.isInteger(v),
+    boolean: (v) => typeof v === "boolean",
+    bigint: (v) => typeof v === "bigint",
+    symbol: (v) => typeof v === "symbol",
+    numeric: (v) => (typeof v === "number" ? !Number.isNaN(v) : !Number.isNaN(Number(v))),
+    finiteNumber: (v) => typeof v === "number" && Number.isFinite(v),
+    // date
+    dateString: (v) => typeof v === "string" && isValidDateString(v),
+    date: (v) => isValidDateObject(v),
+    isoDateString: (v) => typeof v === "string" && isIsoDateString(v),
+    isoDateTimeString: (v) => typeof v === "string" && isIsoDateTimeString(v),
+    // null/undefined
+    null: (v) => v === null,
+    undefined: (v) => typeof v === "undefined",
+    defined: (v) => v !== null && v !== undefined,
+    nan: (v) => typeof v === "number" && Number.isNaN(v),
+    // oggetti/collezioni
+    object: (v) => v !== null && typeof v === "object",
+    plainObject: (v) => {
+        if (v === null || typeof v !== "object" || Array.isArray(v))
+            return false;
+        const proto = Object.getPrototypeOf(v);
+        return proto === Object.prototype || proto === null;
+    },
+    emptyObject: (v) => v !== null && typeof v === "object" && !Array.isArray(v) && Object.keys(v).length === 0,
+    array: (v) => Array.isArray(v),
+    nonEmptyArray: (v) => Array.isArray(v) && v.length > 0,
+    set: (v) => v instanceof Set,
+    map: (v) => v instanceof Map,
+    weakSet: (v) => v instanceof WeakSet,
+    weakMap: (v) => v instanceof WeakMap,
+    // binari / typed arrays
+    arrayBuffer: (v) => v instanceof ArrayBuffer,
+    dataView: (v) => v instanceof DataView,
+    typedArray: (v) => ArrayBuffer.isView(v) && !(v instanceof DataView),
+    // regex / promise / function
+    regexp: (v) => v instanceof RegExp,
+    promise: (v) => !!v && typeof v.then === "function",
+    function: (v) => typeof v === "function",
+    asyncFunction: (v) => typeof v === "function" && v.constructor?.name === "AsyncFunction",
+    generatorFunction: (v) => typeof v === "function" && v.constructor?.name === "GeneratorFunction",
+    // stringhe con pattern
+    email: (v) => typeof v === "string" && EMAIL_RE.test(v),
+    uuid: (v) => typeof v === "string" && UUID_RE.test(v),
+    hexColor: (v) => typeof v === "string" && HEX_COLOR_RE.test(v),
+    ipv4: (v) => typeof v === "string" && IPV4_RE.test(v),
+    ipv6: (v) => typeof v === "string" && IPV6_RE.test(v),
+    jsonString: (v) => {
+        if (typeof v !== "string")
+            return false;
+        try {
+            JSON.parse(v);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    // truthiness
+    truthy: (v) => !!v,
+    falsy: (v) => !v,
+};

package/dist-sdk/utils/utils/_utils.d.ts

@@ -0,0 +1,201 @@
+import type { AnyObject, DropdownOption, HexColor, PasswordStrength } from "../shared/_types";
+export declare const isBrowser: () => boolean;
+export declare const isWindowAvailable: () => boolean;
+export declare const isDev: () => boolean;
+export declare function stringStartsWith(input: string, prefix: string, caseSensitive?: boolean): boolean;
+type FileValidationResult = {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validates a file by checking its MIME type and maximum size.
+ * @param file - The file to validate (can be null or undefined).
+ * @param maxSizeMB - Maximum allowed size in MB (default: 2).
+ * @param allowedTypes - Allowed MIME types (default: empty = all types allowed).
+ * @returns Validation result object.
+ */
+export declare function validateFile(file: File | Blob | null | undefined, maxSizeMB?: number, allowedTypes?: string[]): FileValidationResult;
+export declare function imageExistsAtURL(url: string, bustCache?: boolean): Promise<boolean>;
+export declare function clearUrl(input: string, domainOnly?: boolean): string | null;
+/**
+ * Estrae il sottodominio da un URL o dal dominio corrente (es. builder.bubbledesk.app → "builder").
+ *
+ * ⚠️ Restituisce `null` se non è presente alcun sottodominio (es. bubbledesk.app o localhost).
+ *
+ * @param url - (opzionale) Una stringa URL da cui estrarre il sottodominio. Se non fornita, usa `window.location.hostname`.
+ * @returns Il sottodominio come stringa, oppure `null` se non rilevabile.
+ *
+ * @example
+ * getSubdomain("https://auth.bubbledesk.app"); // "auth"
+ * getSubdomain(); // se eseguito su builder.bubbledesk.app → "builder"
+ * getSubdomain("https://bubbledesk.app"); // null
+ * getSubdomain("http://localhost:5173"); // null
+ */
+export declare const getSubdomain: (url?: string) => string | null;
+/**
+ *
+ * @param options.reload If true, redirect url and related logic will be ignored
+ */
+export declare const redirectOrReload: (options?: {
+    redirectUrl?: string;
+    reload?: boolean;
+    redirectReplace?: boolean;
+}) => void;
+export declare function checkPasswordStrength(password: string): PasswordStrength;
+export declare function capitalize(str: string): string;
+export declare function formSubmit(callback: () => void | Promise<void>): (event: SubmitEvent) => Promise<void>;
+export declare function capitalizeEachWord(input: string): string;
+export declare function parseCookie(header: string): Record<string, string>;
+export declare function isLocalhost(): boolean;
+export declare function getUrlParam(param: string): string | null;
+export declare function sleep(seconds: number): Promise<void>;
+export declare const removeWWW: (host: string | null) => string | null;
+export declare function mapToObject(value: any): any;
+export declare function getRandomNumber(min?: number, max?: number, integer?: boolean): number;
+export declare function getRandomString(options?: {
+    length?: number;
+    includeUppercase?: boolean;
+    prefix?: string;
+}): string;
+export declare function arrrayGetLast<T>(arr: T[]): T | undefined;
+export declare function getPathList(path?: string): string[] | null | undefined;
+export declare function getCurrentPath(path?: string): string | null | undefined;
+export declare function buildPath(parts: string[], endIndex?: number): string;
+export declare function detectAnalysisFileType(filename: string): string;
+export declare function scrollToElement(target: string | HTMLElement, offset?: number, scrollBehavior?: ScrollBehavior): void;
+export declare function clickOutside(node: HTMLElement, callback: () => void): {
+    destroy(): void;
+};
+export declare const setHiddenStatus: (element: string | HTMLElement, hidden: boolean) => void;
+export declare const toggleHiddenStatus: (element: string | HTMLElement) => void;
+export declare function toHtmlId(str: string): string;
+export declare function toggleArrayItem<T>(array: T[], item: T): T[];
+export declare function updateUniqueArray<T>(array: T[], item: T, action: "add" | "remove"): T[];
+export declare function updateArrayByKey<T, K extends keyof T>(array: T[], item: T, action: "add" | "remove", key?: K): T[];
+export declare function toCamelCase(input: string): string;
+export declare function toSnakeCase(input: string): string;
+export declare function portal(node: HTMLElement, target?: HTMLElement): {
+    destroy(): void;
+};
+export declare function isValidTimeStr(timeStr: string): boolean;
+export declare function isValidDate(date: Date): boolean;
+export declare function formatDateForInput(date: Date): string | undefined;
+export declare function addMinutesToTime(timeStr: string, minutesToAdd: number): string | undefined;
+export declare function setTimeForDate(date: Date, timeStr: string): Date;
+export declare function addMinutesToDate(date: Date, minutesToAdd: number, dateTimeStr?: string): Date | undefined;
+export declare function parseDate(dateStr: string, fallbackToToday?: boolean): Date | null;
+export declare function dateToTime24h(date: Date): string | null;
+export declare function dateToTime12h(date: Date): string | null;
+export declare function URLGetParam(paramName: string, url?: string): string | null;
+export declare function isSameMonth(date1: Date, date2: Date): boolean;
+export declare function isSameYear(date1: unknown, date2: unknown): boolean;
+export declare function getMidpointDate(date1: Date, date2: Date): Date;
+export declare function getYearBounds(date?: Date): {
+    start: Date;
+    end: Date;
+};
+export declare function callerName(level?: number): string;
+export declare function arrayGetByKey<T, K extends keyof T>(array: T[], value: T[K], key?: K): T[];
+export declare function checkFileSize(files: FileList | File[], maxSizeMB: number): {
+    valid: boolean;
+    message?: string;
+};
+export declare function getMatchScore(text: string, term: string): number;
+export declare const componentCallbackDispatcher: (callback: Function, data?: any) => void;
+export declare function objectsDiffer<T extends Record<string, any>>(a: Partial<T>, b: Partial<T>, strict?: boolean): boolean;
+export declare function removeNullish<T extends object>(obj: T): Partial<T>;
+type FlattenOptions = {
+    useDotNotation?: boolean;
+};
+export declare function flattenObject(obj: Record<string, any>, options?: FlattenOptions): Record<string, any>;
+/**
+ * @param normalizeMonthly If true and units is months or years, it will normalize the start and end date to the first and last day of the first and last month.
+ */
+export declare function getTimeBounds(midpoint: Date | string, before: number, after: number, unit: "minutes" | "days" | "months" | "years", normalizeMonthly?: boolean): {
+    start: Date;
+    end: Date;
+};
+export declare function listMonthsInRange(start: Date | string, end: Date | string, format?: "YYYY-MM" | "YYYY-MMM" | "YYYY-MMMM", options?: {
+    locale?: string;
+    excludeStart?: boolean;
+    excludeEnd?: boolean;
+    descending?: boolean;
+}): string[];
+/**
+ * @param monthKey (deve essere in formato YYYY-MM)
+ * @returns Restituisce un oggetto contente start e end
+ */
+export declare function getMonthBoundsByYearMonthString(monthKey: string): {
+    start: Date;
+    end: Date;
+};
+/**
+ * @returns The month of the passed date as string in the format YYYY-MM (eg. 2025-05), in UTC
+ */
+export declare function getYearMonthStringFromDate(date: Date): string;
+/**
+ * @returns Restituisce un oggetto contente start e end
+ */
+export declare function getMonthBounds(date: Date): {
+    start: Date;
+    end: Date;
+};
+/**
+ * Unisce l'array originale con nuovi oggetti, sovrascrivendo quelli con la stessa chiave.
+ * @param original Array originale
+ * @param updates Nuovi oggetti da aggiungere o aggiornare
+ * @param key Chiave identificativa (default: "id")
+ * @returns Nuovo array aggiornato
+ */
+export declare function mergeByKey<T extends AnyObject>(original: T[], updates: T[], key?: keyof T): T[];
+/**
+ * Rimuove un elemento da un array di oggetti confrontando un campo chiave.
+ *
+ * @param array - L'array di oggetti da cui rimuovere l'elemento
+ * @param value - Il valore da confrontare per la rimozione
+ * @param key - Il campo su cui fare il confronto (default: "id")
+ * @returns Un nuovo array senza l'elemento corrispondente
+ */
+export declare function removeFromArrayByKey<T extends Record<string, any>>(array: T[], value: any, key?: string): T[];
+export declare function hexToRgb(hexString?: HexColor): string | "";
+export declare function copyToClipboard(text: string, callback?: Function): Promise<void>;
+/**
+ * Reloads the page with the given query parameters if they are not already present or different.
+ * Prevents infinite loops by comparing current parameters with target ones.
+ * Optionally appends a hash anchor (e.g., #section) for native browser scrolling.
+ *
+ * @param newParams An object containing key-value pairs to be added to the URL.
+ * @param anchor Optional ID of the element to scroll to after reload (e.g. 'comments')
+ */
+export declare function URLReload(newParams?: Record<string, string>, anchor?: string): void;
+export declare function flagEmojiToCountryCode(flag: string): string;
+export declare const wait: (timeout?: number, callback?: VoidFunction) => Promise<void>;
+export declare const dropdownOptionsFromStrings: (strings: string[]) => DropdownOption[];
+/** Redact likely-sensitive data and normalize message */
+export declare function sanitizeMessageSensitiveData(msg: string, maxLen?: number): string;
+type ErrorInfo = {
+    message: string;
+    code?: string | number;
+};
+/**
+ *
+ * @param err The error to extract message and code from
+ * @param sanitize Wether to sanitize the error message, removing potential sensitive data
+ * @returns Error info in the format of { message, code}
+ */
+export declare function getErrorInfo(err: unknown, sanitize?: boolean): ErrorInfo;
+/**
+ * Serializes an arbitrary values into a deterministic, hash-friendly string.
+ *
+ * - Objects are serialized with sorted keys to ensure stable ordering.
+ * - Arrays are serialized by preserving element order.
+ * - Dates are converted to ISO strings.
+ * - Files are represented by stable metadata (name, size, lastModified).
+ *
+ * @param value - The value or values to serialize.
+ * @returns A deterministic string representation.
+ */
+export declare function serializeToString(value: unknown): string;
+export declare function createHashInput(values: unknown[], separator?: string): string;
+export declare function arrayIncludesString(arr: string[], needle: string, caseSensitive?: boolean): boolean;
+export {};