@xbg.solutions/utils-validation 1.0.0

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validation utilities barrel export
+ */
+export { EMAIL_REGEX, PHONE_REGEX, UID_REGEX, COUNTRY_CODE_REGEX, validateEmail, validatePhone, validateIANATimezone, validateCurrency, validateLength, validateUID, validateCountryCode, validateURL, validatePositiveNumber, validateNonNegativeNumber, validateFutureDate, validateEnum, } from './validators';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC"}

package/lib/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Validation utilities barrel export
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEnum = exports.validateFutureDate = exports.validateNonNegativeNumber = exports.validatePositiveNumber = exports.validateURL = exports.validateCountryCode = exports.validateUID = exports.validateLength = exports.validateCurrency = exports.validateIANATimezone = exports.validatePhone = exports.validateEmail = exports.COUNTRY_CODE_REGEX = exports.UID_REGEX = exports.PHONE_REGEX = exports.EMAIL_REGEX = void 0;
+var validators_1 = require("./validators");
+Object.defineProperty(exports, "EMAIL_REGEX", { enumerable: true, get: function () { return validators_1.EMAIL_REGEX; } });
+Object.defineProperty(exports, "PHONE_REGEX", { enumerable: true, get: function () { return validators_1.PHONE_REGEX; } });
+Object.defineProperty(exports, "UID_REGEX", { enumerable: true, get: function () { return validators_1.UID_REGEX; } });
+Object.defineProperty(exports, "COUNTRY_CODE_REGEX", { enumerable: true, get: function () { return validators_1.COUNTRY_CODE_REGEX; } });
+Object.defineProperty(exports, "validateEmail", { enumerable: true, get: function () { return validators_1.validateEmail; } });
+Object.defineProperty(exports, "validatePhone", { enumerable: true, get: function () { return validators_1.validatePhone; } });
+Object.defineProperty(exports, "validateIANATimezone", { enumerable: true, get: function () { return validators_1.validateIANATimezone; } });
+Object.defineProperty(exports, "validateCurrency", { enumerable: true, get: function () { return validators_1.validateCurrency; } });
+Object.defineProperty(exports, "validateLength", { enumerable: true, get: function () { return validators_1.validateLength; } });
+Object.defineProperty(exports, "validateUID", { enumerable: true, get: function () { return validators_1.validateUID; } });
+Object.defineProperty(exports, "validateCountryCode", { enumerable: true, get: function () { return validators_1.validateCountryCode; } });
+Object.defineProperty(exports, "validateURL", { enumerable: true, get: function () { return validators_1.validateURL; } });
+Object.defineProperty(exports, "validatePositiveNumber", { enumerable: true, get: function () { return validators_1.validatePositiveNumber; } });
+Object.defineProperty(exports, "validateNonNegativeNumber", { enumerable: true, get: function () { return validators_1.validateNonNegativeNumber; } });
+Object.defineProperty(exports, "validateFutureDate", { enumerable: true, get: function () { return validators_1.validateFutureDate; } });
+Object.defineProperty(exports, "validateEnum", { enumerable: true, get: function () { return validators_1.validateEnum; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2CAiBsB;AAhBpB,yGAAA,WAAW,OAAA;AACX,yGAAA,WAAW,OAAA;AACX,uGAAA,SAAS,OAAA;AACT,gHAAA,kBAAkB,OAAA;AAClB,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,kHAAA,oBAAoB,OAAA;AACpB,8GAAA,gBAAgB,OAAA;AAChB,4GAAA,cAAc,OAAA;AACd,yGAAA,WAAW,OAAA;AACX,iHAAA,mBAAmB,OAAA;AACnB,yGAAA,WAAW,OAAA;AACX,oHAAA,sBAAsB,OAAA;AACtB,uHAAA,yBAAyB,OAAA;AACzB,gHAAA,kBAAkB,OAAA;AAClB,0GAAA,YAAY,OAAA"}

package/lib/validators.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Validation Utilities
+ *
+ * Reusable validation functions for common data types.
+ * All validators return boolean (true = valid, false = invalid).
+ */
+/**
+ * Email validation (RFC 5322 simplified)
+ */
+export declare const EMAIL_REGEX: RegExp;
+export declare function validateEmail(email: string): boolean;
+/**
+ * Phone number validation (E.164 format)
+ * Format: +[country code][number] (e.g., +61412345678)
+ * Length: 7-15 digits total (minimum viable phone number)
+ */
+export declare const PHONE_REGEX: RegExp;
+export declare function validatePhone(phone: string): boolean;
+/**
+ * IANA timezone validation
+ * Validates against the IANA timezone database
+ * Requires proper format (e.g., "Australia/Sydney", not "EST")
+ */
+export declare function validateIANATimezone(timezone: string): boolean;
+export declare function validateCurrency(code: string): boolean;
+/**
+ * String length validation
+ */
+export declare function validateLength(str: string, min: number, max: number): boolean;
+/**
+ * UID format validation (Firestore auto-generated IDs)
+ * Format: 20+ alphanumeric characters, hyphens, underscores
+ */
+export declare const UID_REGEX: RegExp;
+export declare function validateUID(uid: string): boolean;
+/**
+ * ISO 3166-1 alpha-2 country code validation
+ * Format: Two uppercase letters (e.g., AU, US, GB)
+ */
+export declare const COUNTRY_CODE_REGEX: RegExp;
+export declare function validateCountryCode(code: string): boolean;
+/**
+ * URL validation (basic)
+ */
+export declare function validateURL(url: string): boolean;
+/**
+ * Positive number validation
+ */
+export declare function validatePositiveNumber(value: unknown): boolean;
+/**
+ * Non-negative number validation (>= 0)
+ */
+export declare function validateNonNegativeNumber(value: unknown): boolean;
+/**
+ * Date validation (not in the past)
+ */
+export declare function validateFutureDate(date: Date): boolean;
+/**
+ * Enum validation helper
+ */
+export declare function validateEnum<T extends string>(value: string, allowedValues: readonly T[]): value is T;
+//# sourceMappingURL=validators.d.ts.map

package/lib/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,QAA+B,CAAC;AAExD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAuB,CAAC;AAEhD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkB9D;AAmBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAMT;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,QAAyB,CAAC;AAEhD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKhD;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAe,CAAC;AAE/C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWhD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK9D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAKtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,CAAC,EAAE,GAC1B,KAAK,IAAI,CAAC,CAEZ"}

package/lib/validators.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Validation Utilities
+ *
+ * Reusable validation functions for common data types.
+ * All validators return boolean (true = valid, false = invalid).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COUNTRY_CODE_REGEX = exports.UID_REGEX = exports.PHONE_REGEX = exports.EMAIL_REGEX = void 0;
+exports.validateEmail = validateEmail;
+exports.validatePhone = validatePhone;
+exports.validateIANATimezone = validateIANATimezone;
+exports.validateCurrency = validateCurrency;
+exports.validateLength = validateLength;
+exports.validateUID = validateUID;
+exports.validateCountryCode = validateCountryCode;
+exports.validateURL = validateURL;
+exports.validatePositiveNumber = validatePositiveNumber;
+exports.validateNonNegativeNumber = validateNonNegativeNumber;
+exports.validateFutureDate = validateFutureDate;
+exports.validateEnum = validateEnum;
+/**
+ * Email validation (RFC 5322 simplified)
+ */
+exports.EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function validateEmail(email) {
+    if (!email || typeof email !== 'string') {
+        return false;
+    }
+    return exports.EMAIL_REGEX.test(email.trim());
+}
+/**
+ * Phone number validation (E.164 format)
+ * Format: +[country code][number] (e.g., +61412345678)
+ * Length: 7-15 digits total (minimum viable phone number)
+ */
+exports.PHONE_REGEX = /^\+?[1-9]\d{6,14}$/;
+function validatePhone(phone) {
+    if (!phone || typeof phone !== 'string') {
+        return false;
+    }
+    return exports.PHONE_REGEX.test(phone.trim());
+}
+/**
+ * IANA timezone validation
+ * Validates against the IANA timezone database
+ * Requires proper format (e.g., "Australia/Sydney", not "EST")
+ */
+function validateIANATimezone(timezone) {
+    if (!timezone || typeof timezone !== 'string') {
+        return false;
+    }
+    // Require proper IANA format (must contain slash: Continent/City)
+    // Reject abbreviations like EST, GMT, UTC offsets like GMT+10
+    if (!timezone.includes('/') && timezone !== 'UTC') {
+        return false;
+    }
+    try {
+        // Use Intl.DateTimeFormat to validate timezone
+        Intl.DateTimeFormat(undefined, { timeZone: timezone });
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Currency code validation (ISO 4217)
+ * Common currencies only for MVP
+ */
+const VALID_CURRENCIES = new Set([
+    'AUD', // Australian Dollar
+    'USD', // US Dollar
+    'EUR', // Euro
+    'GBP', // British Pound
+    'JPY', // Japanese Yen
+    'CNY', // Chinese Yuan
+    'INR', // Indian Rupee
+    'CAD', // Canadian Dollar
+    'NZD', // New Zealand Dollar
+    'SGD', // Singapore Dollar
+]);
+function validateCurrency(code) {
+    if (!code || typeof code !== 'string') {
+        return false;
+    }
+    return VALID_CURRENCIES.has(code.toUpperCase());
+}
+/**
+ * String length validation
+ */
+function validateLength(str, min, max) {
+    if (!str || typeof str !== 'string') {
+        return false;
+    }
+    const length = str.trim().length;
+    return length >= min && length <= max;
+}
+/**
+ * UID format validation (Firestore auto-generated IDs)
+ * Format: 20+ alphanumeric characters, hyphens, underscores
+ */
+exports.UID_REGEX = /^[a-zA-Z0-9_-]{20,}$/;
+function validateUID(uid) {
+    if (!uid || typeof uid !== 'string') {
+        return false;
+    }
+    return exports.UID_REGEX.test(uid);
+}
+/**
+ * ISO 3166-1 alpha-2 country code validation
+ * Format: Two uppercase letters (e.g., AU, US, GB)
+ */
+exports.COUNTRY_CODE_REGEX = /^[A-Z]{2}$/;
+function validateCountryCode(code) {
+    if (!code || typeof code !== 'string') {
+        return false;
+    }
+    return exports.COUNTRY_CODE_REGEX.test(code.toUpperCase());
+}
+/**
+ * URL validation (basic)
+ */
+function validateURL(url) {
+    if (!url || typeof url !== 'string') {
+        return false;
+    }
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Positive number validation
+ */
+function validatePositiveNumber(value) {
+    if (typeof value !== 'number') {
+        return false;
+    }
+    return value > 0 && !isNaN(value) && isFinite(value);
+}
+/**
+ * Non-negative number validation (>= 0)
+ */
+function validateNonNegativeNumber(value) {
+    if (typeof value !== 'number') {
+        return false;
+    }
+    return value >= 0 && !isNaN(value) && isFinite(value);
+}
+/**
+ * Date validation (not in the past)
+ */
+function validateFutureDate(date) {
+    if (!(date instanceof Date) || isNaN(date.getTime())) {
+        return false;
+    }
+    return date.getTime() > Date.now();
+}
+/**
+ * Enum validation helper
+ */
+function validateEnum(value, allowedValues) {
+    return allowedValues.includes(value);
+}
+//# sourceMappingURL=validators.js.map

package/lib/validators.js.map

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

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@xbg.solutions/utils-validation",
+  "version": "1.0.0",
+  "description": "Input validation with Joi and express-validator",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": ["lib"],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {"joi": "^17.11.0", "express-validator": "^7.0.1"},
+  "devDependencies": {"@types/node": "^20.11.0", "typescript": "^5.3.3"},
+  "engines": {
+    "node": "22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}