@sudobility/types 1.8.21

package/dist/utils/validation/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateArray = exports.parseJson = exports.optional = exports.isValidDate = exports.isUrl = exports.isSuccessResponse = exports.isString = exports.isObject = exports.isNumber = exports.isNullish = exports.isErrorResponse = exports.isEmail = exports.isBoolean = exports.isArray = exports.isApiResponse = exports.hasRequiredProperties = exports.createValidator = exports.createAssertion = exports.Web3UsernameValidator = void 0;
+var web3_username_validator_1 = require("./web3-username-validator");
+Object.defineProperty(exports, "Web3UsernameValidator", { enumerable: true, get: function () { return web3_username_validator_1.Web3UsernameValidator; } });
+var type_validation_1 = require("./type-validation");
+Object.defineProperty(exports, "createAssertion", { enumerable: true, get: function () { return type_validation_1.createAssertion; } });
+Object.defineProperty(exports, "createValidator", { enumerable: true, get: function () { return type_validation_1.createValidator; } });
+Object.defineProperty(exports, "hasRequiredProperties", { enumerable: true, get: function () { return type_validation_1.hasRequiredProperties; } });
+Object.defineProperty(exports, "isApiResponse", { enumerable: true, get: function () { return type_validation_1.isApiResponse; } });
+Object.defineProperty(exports, "isArray", { enumerable: true, get: function () { return type_validation_1.isArray; } });
+Object.defineProperty(exports, "isBoolean", { enumerable: true, get: function () { return type_validation_1.isBoolean; } });
+Object.defineProperty(exports, "isEmail", { enumerable: true, get: function () { return type_validation_1.isEmail; } });
+Object.defineProperty(exports, "isErrorResponse", { enumerable: true, get: function () { return type_validation_1.isErrorResponse; } });
+Object.defineProperty(exports, "isNullish", { enumerable: true, get: function () { return type_validation_1.isNullish; } });
+Object.defineProperty(exports, "isNumber", { enumerable: true, get: function () { return type_validation_1.isNumber; } });
+Object.defineProperty(exports, "isObject", { enumerable: true, get: function () { return type_validation_1.isObject; } });
+Object.defineProperty(exports, "isString", { enumerable: true, get: function () { return type_validation_1.isString; } });
+Object.defineProperty(exports, "isSuccessResponse", { enumerable: true, get: function () { return type_validation_1.isSuccessResponse; } });
+Object.defineProperty(exports, "isUrl", { enumerable: true, get: function () { return type_validation_1.isUrl; } });
+Object.defineProperty(exports, "isValidDate", { enumerable: true, get: function () { return type_validation_1.isValidDate; } });
+Object.defineProperty(exports, "optional", { enumerable: true, get: function () { return type_validation_1.optional; } });
+Object.defineProperty(exports, "parseJson", { enumerable: true, get: function () { return type_validation_1.parseJson; } });
+Object.defineProperty(exports, "validateArray", { enumerable: true, get: function () { return type_validation_1.validateArray; } });
+//# sourceMappingURL=index.js.map

package/dist/utils/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/validation/index.ts"],"names":[],"mappings":";;;AAGA,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAK9B,qDAmB2B;AAlBzB,kHAAA,eAAe,OAAA;AACf,kHAAA,eAAe,OAAA;AACf,wHAAA,qBAAqB,OAAA;AACrB,gHAAA,aAAa,OAAA;AACb,0GAAA,OAAO,OAAA;AACP,4GAAA,SAAS,OAAA;AACT,0GAAA,OAAO,OAAA;AACP,kHAAA,eAAe,OAAA;AACf,4GAAA,SAAS,OAAA;AACT,2GAAA,QAAQ,OAAA;AACR,2GAAA,QAAQ,OAAA;AACR,2GAAA,QAAQ,OAAA;AACR,oHAAA,iBAAiB,OAAA;AACjB,wGAAA,KAAK,OAAA;AACL,8GAAA,WAAW,OAAA;AACX,2GAAA,QAAQ,OAAA;AACR,4GAAA,SAAS,OAAA;AACT,gHAAA,aAAa,OAAA"}

package/dist/utils/validation/type-validation.cjs

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Type validation utilities for runtime type checking
+ *
+ * These utilities help ensure type safety at runtime, especially useful
+ * for validating API responses and external data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJson = exports.createAssertion = exports.isUrl = exports.isEmail = exports.isValidDate = exports.isErrorResponse = exports.isSuccessResponse = exports.isApiResponse = exports.optional = exports.validateArray = exports.hasRequiredProperties = exports.isNullish = exports.isArray = exports.isObject = exports.isBoolean = exports.isNumber = exports.isString = exports.createValidator = void 0;
+/**
+ * Creates a validation function that safely checks if a value matches expected type
+ */
+const createValidator = (validationFn, typeName) => {
+    return (data) => {
+        try {
+            if (validationFn(data)) {
+                return { isValid: true, data };
+            }
+            return { isValid: false, error: `Invalid ${typeName}`, data: null };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                error: `Validation error for ${typeName}: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                data: null,
+            };
+        }
+    };
+};
+exports.createValidator = createValidator;
+/**
+ * Basic type validators
+ */
+const isString = (value) => typeof value === 'string';
+exports.isString = isString;
+const isNumber = (value) => typeof value === 'number' && !isNaN(value);
+exports.isNumber = isNumber;
+const isBoolean = (value) => typeof value === 'boolean';
+exports.isBoolean = isBoolean;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+exports.isObject = isObject;
+const isArray = (value) => Array.isArray(value);
+exports.isArray = isArray;
+const isNullish = (value) => value === null || value === undefined;
+exports.isNullish = isNullish;
+/**
+ * Validates that an object has required properties
+ */
+const hasRequiredProperties = (obj, requiredProps) => {
+    if (!(0, exports.isObject)(obj))
+        return false;
+    return requiredProps.every((prop) => prop in obj);
+};
+exports.hasRequiredProperties = hasRequiredProperties;
+/**
+ * Validates array of objects with a validator function
+ */
+const validateArray = (data, itemValidator) => {
+    if (!(0, exports.isArray)(data))
+        return false;
+    return data.every(itemValidator);
+};
+exports.validateArray = validateArray;
+/**
+ * Creates optional property validator
+ */
+const optional = (validator) => (value) => {
+    return value === undefined || validator(value);
+};
+exports.optional = optional;
+/**
+ * Common pattern validators for API responses
+ */
+const isApiResponse = (data) => {
+    return (0, exports.isObject)(data) && (0, exports.isBoolean)(data.success);
+};
+exports.isApiResponse = isApiResponse;
+const isSuccessResponse = (data, dataValidator) => {
+    if (!(0, exports.isApiResponse)(data) || !data.success)
+        return false;
+    if (dataValidator && 'data' in data) {
+        return dataValidator(data.data);
+    }
+    return true;
+};
+exports.isSuccessResponse = isSuccessResponse;
+const isErrorResponse = (data) => {
+    return ((0, exports.isApiResponse)(data) &&
+        !data.success &&
+        'error' in data &&
+        (0, exports.isString)(data.error));
+};
+exports.isErrorResponse = isErrorResponse;
+/**
+ * Date validation
+ */
+const isValidDate = (value) => {
+    if (!(0, exports.isString)(value))
+        return false;
+    const date = new Date(value);
+    return !isNaN(date.getTime());
+};
+exports.isValidDate = isValidDate;
+/**
+ * Email validation (basic)
+ */
+const isEmail = (value) => {
+    if (!(0, exports.isString)(value))
+        return false;
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(value);
+};
+exports.isEmail = isEmail;
+/**
+ * URL validation (basic)
+ */
+const isUrl = (value) => {
+    if (!(0, exports.isString)(value))
+        return false;
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+exports.isUrl = isUrl;
+/**
+ * Creates a type assertion function that throws on invalid data
+ */
+const createAssertion = (validator, typeName) => {
+    return (data, context = typeName) => {
+        if (!validator(data)) {
+            throw new TypeError(`Invalid ${context}: expected ${typeName}`);
+        }
+    };
+};
+exports.createAssertion = createAssertion;
+/**
+ * Safe JSON parsing with validation
+ */
+const parseJson = (jsonString, validator) => {
+    try {
+        const parsed = JSON.parse(jsonString);
+        if (validator) {
+            if (validator(parsed)) {
+                return { isValid: true, data: parsed };
+            }
+            return {
+                isValid: false,
+                error: 'Parsed JSON does not match expected type',
+                data: null,
+            };
+        }
+        return { isValid: true, data: parsed };
+    }
+    catch (error) {
+        return {
+            isValid: false,
+            error: `JSON parse error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            data: null,
+        };
+    }
+};
+exports.parseJson = parseJson;
+//# sourceMappingURL=type-validation.js.map

package/dist/utils/validation/type-validation.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Type validation utilities for runtime type checking
+ *
+ * These utilities help ensure type safety at runtime, especially useful
+ * for validating API responses and external data.
+ */
+import type { ValidationResult, Optional } from '../../types/common';
+export type { ValidationResult };
+/**
+ * Creates a validation function that safely checks if a value matches expected type
+ */
+export declare const createValidator: <T>(validationFn: (data: unknown) => data is T, typeName: string) => (data: unknown) => ValidationResult<T>;
+/**
+ * Basic type validators
+ */
+export declare const isString: (value: unknown) => value is string;
+export declare const isNumber: (value: unknown) => value is number;
+export declare const isBoolean: (value: unknown) => value is boolean;
+export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+export declare const isArray: (value: unknown) => value is unknown[];
+export declare const isNullish: (value: unknown) => value is null | undefined;
+/**
+ * Validates that an object has required properties
+ */
+export declare const hasRequiredProperties: <T extends Record<string, unknown>>(obj: unknown, requiredProps: (keyof T)[]) => obj is T;
+/**
+ * Validates array of objects with a validator function
+ */
+export declare const validateArray: <T>(data: unknown, itemValidator: (item: unknown) => item is T) => data is T[];
+/**
+ * Creates optional property validator
+ */
+export declare const optional: <T>(validator: (value: unknown) => value is T) => (value: unknown) => value is T | undefined;
+/**
+ * Common pattern validators for API responses
+ */
+export declare const isApiResponse: (data: unknown) => data is {
+    success: boolean;
+};
+export declare const isSuccessResponse: <T>(data: unknown, dataValidator?: Optional<(value: unknown) => value is T>) => data is {
+    success: true;
+    data: T;
+};
+export declare const isErrorResponse: (data: unknown) => data is {
+    success: false;
+    error: string;
+};
+/**
+ * Date validation
+ */
+export declare const isValidDate: (value: unknown) => value is string;
+/**
+ * Email validation (basic)
+ */
+export declare const isEmail: (value: unknown) => value is string;
+/**
+ * URL validation (basic)
+ */
+export declare const isUrl: (value: unknown) => value is string;
+/**
+ * Creates a type assertion function that throws on invalid data
+ */
+export declare const createAssertion: <T>(validator: (data: unknown) => data is T, typeName: string) => (data: unknown, context?: string) => asserts data is T;
+/**
+ * Safe JSON parsing with validation
+ */
+export declare const parseJson: <T>(jsonString: string, validator?: Optional<(data: unknown) => data is T>) => ValidationResult<T>;
+//# sourceMappingURL=type-validation.d.ts.map

package/dist/utils/validation/type-validation.d.ts.map

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

package/dist/utils/validation/type-validation.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Type validation utilities for runtime type checking
+ *
+ * These utilities help ensure type safety at runtime, especially useful
+ * for validating API responses and external data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJson = exports.createAssertion = exports.isUrl = exports.isEmail = exports.isValidDate = exports.isErrorResponse = exports.isSuccessResponse = exports.isApiResponse = exports.optional = exports.validateArray = exports.hasRequiredProperties = exports.isNullish = exports.isArray = exports.isObject = exports.isBoolean = exports.isNumber = exports.isString = exports.createValidator = void 0;
+/**
+ * Creates a validation function that safely checks if a value matches expected type
+ */
+const createValidator = (validationFn, typeName) => {
+    return (data) => {
+        try {
+            if (validationFn(data)) {
+                return { isValid: true, data };
+            }
+            return { isValid: false, error: `Invalid ${typeName}`, data: null };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                error: `Validation error for ${typeName}: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                data: null,
+            };
+        }
+    };
+};
+exports.createValidator = createValidator;
+/**
+ * Basic type validators
+ */
+const isString = (value) => typeof value === 'string';
+exports.isString = isString;
+const isNumber = (value) => typeof value === 'number' && !isNaN(value);
+exports.isNumber = isNumber;
+const isBoolean = (value) => typeof value === 'boolean';
+exports.isBoolean = isBoolean;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+exports.isObject = isObject;
+const isArray = (value) => Array.isArray(value);
+exports.isArray = isArray;
+const isNullish = (value) => value === null || value === undefined;
+exports.isNullish = isNullish;
+/**
+ * Validates that an object has required properties
+ */
+const hasRequiredProperties = (obj, requiredProps) => {
+    if (!(0, exports.isObject)(obj))
+        return false;
+    return requiredProps.every((prop) => prop in obj);
+};
+exports.hasRequiredProperties = hasRequiredProperties;
+/**
+ * Validates array of objects with a validator function
+ */
+const validateArray = (data, itemValidator) => {
+    if (!(0, exports.isArray)(data))
+        return false;
+    return data.every(itemValidator);
+};
+exports.validateArray = validateArray;
+/**
+ * Creates optional property validator
+ */
+const optional = (validator) => (value) => {
+    return value === undefined || validator(value);
+};
+exports.optional = optional;
+/**
+ * Common pattern validators for API responses
+ */
+const isApiResponse = (data) => {
+    return (0, exports.isObject)(data) && (0, exports.isBoolean)(data.success);
+};
+exports.isApiResponse = isApiResponse;
+const isSuccessResponse = (data, dataValidator) => {
+    if (!(0, exports.isApiResponse)(data) || !data.success)
+        return false;
+    if (dataValidator && 'data' in data) {
+        return dataValidator(data.data);
+    }
+    return true;
+};
+exports.isSuccessResponse = isSuccessResponse;
+const isErrorResponse = (data) => {
+    return ((0, exports.isApiResponse)(data) &&
+        !data.success &&
+        'error' in data &&
+        (0, exports.isString)(data.error));
+};
+exports.isErrorResponse = isErrorResponse;
+/**
+ * Date validation
+ */
+const isValidDate = (value) => {
+    if (!(0, exports.isString)(value))
+        return false;
+    const date = new Date(value);
+    return !isNaN(date.getTime());
+};
+exports.isValidDate = isValidDate;
+/**
+ * Email validation (basic)
+ */
+const isEmail = (value) => {
+    if (!(0, exports.isString)(value))
+        return false;
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(value);
+};
+exports.isEmail = isEmail;
+/**
+ * URL validation (basic)
+ */
+const isUrl = (value) => {
+    if (!(0, exports.isString)(value))
+        return false;
+    try {
+        new URL(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+exports.isUrl = isUrl;
+/**
+ * Creates a type assertion function that throws on invalid data
+ */
+const createAssertion = (validator, typeName) => {
+    return (data, context = typeName) => {
+        if (!validator(data)) {
+            throw new TypeError(`Invalid ${context}: expected ${typeName}`);
+        }
+    };
+};
+exports.createAssertion = createAssertion;
+/**
+ * Safe JSON parsing with validation
+ */
+const parseJson = (jsonString, validator) => {
+    try {
+        const parsed = JSON.parse(jsonString);
+        if (validator) {
+            if (validator(parsed)) {
+                return { isValid: true, data: parsed };
+            }
+            return {
+                isValid: false,
+                error: 'Parsed JSON does not match expected type',
+                data: null,
+            };
+        }
+        return { isValid: true, data: parsed };
+    }
+    catch (error) {
+        return {
+            isValid: false,
+            error: `JSON parse error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            data: null,
+        };
+    }
+};
+exports.parseJson = parseJson;
+//# sourceMappingURL=type-validation.js.map

package/dist/utils/validation/type-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-validation.js","sourceRoot":"","sources":["../../../src/utils/validation/type-validation.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAOH;;GAEG;AACI,MAAM,eAAe,GAAG,CAC7B,YAA0C,EAC1C,QAAgB,EAChB,EAAE;IACF,OAAO,CAAC,IAAa,EAAuB,EAAE;QAC5C,IAAI,CAAC;YACH,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,wBAAwB,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;gBACtG,IAAI,EAAE,IAAI;aACX,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AAlBW,QAAA,eAAe,mBAkB1B;AAEF;;GAEG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC1D,OAAO,KAAK,KAAK,QAAQ,CAAC;AADf,QAAA,QAAQ,YACO;AAErB,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC1D,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AADhC,QAAA,QAAQ,YACwB;AAEtC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE,CAC5D,OAAO,KAAK,KAAK,SAAS,CAAC;AADhB,QAAA,SAAS,aACO;AAEtB,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAC3E,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAD1D,QAAA,QAAQ,YACkD;AAEhE,MAAM,OAAO,GAAG,CAAC,KAAc,EAAsB,EAAE,CAC5D,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AADV,QAAA,OAAO,WACG;AAEhB,MAAM,SAAS,GAAG,CAAC,KAAc,EAA6B,EAAE,CACrE,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAD3B,QAAA,SAAS,aACkB;AAExC;;GAEG;AACI,MAAM,qBAAqB,GAAG,CACnC,GAAY,EACZ,aAA0B,EAChB,EAAE;IACZ,IAAI,CAAC,IAAA,gBAAQ,EAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;AACpD,CAAC,CAAC;AANW,QAAA,qBAAqB,yBAMhC;AAEF;;GAEG;AACI,MAAM,aAAa,GAAG,CAC3B,IAAa,EACb,aAA2C,EAC9B,EAAE;IACf,IAAI,CAAC,IAAA,eAAO,EAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC,CAAC;AANW,QAAA,aAAa,iBAMxB;AAEF;;GAEG;AACI,MAAM,QAAQ,GACnB,CAAI,SAAyC,EAAE,EAAE,CACjD,CAAC,KAAc,EAA0B,EAAE;IACzC,OAAO,KAAK,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC,CAAC;AAJS,QAAA,QAAQ,YAIjB;AAEJ;;GAEG;AACI,MAAM,aAAa,GAAG,CAAC,IAAa,EAAgC,EAAE;IAC3E,OAAO,IAAA,gBAAQ,EAAC,IAAI,CAAC,IAAI,IAAA,iBAAS,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAEK,MAAM,iBAAiB,GAAG,CAC/B,IAAa,EACb,aAAwD,EACpB,EAAE;IACtC,IAAI,CAAC,IAAA,qBAAa,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,aAAa,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACpC,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AATW,QAAA,iBAAiB,qBAS5B;AAEK,MAAM,eAAe,GAAG,CAC7B,IAAa,EAC8B,EAAE;IAC7C,OAAO,CACL,IAAA,qBAAa,EAAC,IAAI,CAAC;QACnB,CAAC,IAAI,CAAC,OAAO;QACb,OAAO,IAAI,IAAI;QACf,IAAA,gBAAQ,EAAC,IAAI,CAAC,KAAK,CAAC,CACrB,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,eAAe,mBAS1B;AAEF;;GAEG;AACI,MAAM,WAAW,GAAG,CAAC,KAAc,EAAmB,EAAE;IAC7D,IAAI,CAAC,IAAA,gBAAQ,EAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC,CAAC;AAJW,QAAA,WAAW,eAItB;AAEF;;GAEG;AACI,MAAM,OAAO,GAAG,CAAC,KAAc,EAAmB,EAAE;IACzD,IAAI,CAAC,IAAA,gBAAQ,EAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,UAAU,GAAG,4BAA4B,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC,CAAC;AAJW,QAAA,OAAO,WAIlB;AAEF;;GAEG;AACI,MAAM,KAAK,GAAG,CAAC,KAAc,EAAmB,EAAE;IACvD,IAAI,CAAC,IAAA,gBAAQ,EAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AARW,QAAA,KAAK,SAQhB;AAEF;;GAEG;AACI,MAAM,eAAe,GAAG,CAC7B,SAAuC,EACvC,QAAgB,EAChB,EAAE;IACF,OAAO,CAAC,IAAa,EAAE,OAAO,GAAG,QAAQ,EAAqB,EAAE;QAC9D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,WAAW,OAAO,cAAc,QAAQ,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,eAAe,mBAS1B;AAEF;;GAEG;AACI,MAAM,SAAS,GAAG,CACvB,UAAkB,EAClB,SAAkD,EAC7B,EAAE;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YACzC,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0CAA0C;gBACjD,IAAI,EAAE,IAAI;aACX,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAW,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;YACtF,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAxBW,QAAA,SAAS,aAwBpB"}

package/dist/utils/validation/web3-username-validator.cjs

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * @fileoverview Address Validation Utility
+ * @description Centralized address validation for EVM, Solana, ENS, and SNS addresses
+ * Eliminates code duplication across multiple files
+ *
+ * Pure TypeScript implementation with no external dependencies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Web3UsernameValidator = void 0;
+// Import ChainType from business enums
+const enums_1 = require("../../types/business/enums");
+class Web3UsernameValidator {
+    /**
+     * Comprehensive address validation for API endpoint
+     * Returns AddressValidationResult for valid addresses, undefined for invalid ones
+     */
+    static validate(address) {
+        if (!address) {
+            return undefined;
+        }
+        // 1. Check if it's a valid EVM address (0x + 40 hex characters)
+        if (this.EVM_REGEX.test(address)) {
+            return {
+                name: null,
+                address: address.toLowerCase(),
+                chainType: enums_1.ChainType.EVM,
+            };
+        }
+        // 2. Check if it's a valid Solana address (Base58, 32-44 characters, no 0x prefix)
+        if (!address.startsWith('0x') &&
+            address.length >= 32 &&
+            address.length <= 44 &&
+            this.BASE58_REGEX.test(address)) {
+            return {
+                name: null,
+                address: address, // Keep case for Solana
+                chainType: enums_1.ChainType.SOLANA,
+            };
+        }
+        // 3. Check if it's a valid ENS name (.eth or .box)
+        if ((address.toLowerCase().endsWith('.eth') ||
+            address.toLowerCase().endsWith('.box')) &&
+            address.length >= 5 && // minimum: "a.eth" = 5 chars
+            this.ENS_REGEX.test(address)) {
+            return {
+                name: address.toLowerCase(),
+                address: null,
+                chainType: enums_1.ChainType.EVM, // ENS resolves to EVM addresses
+            };
+        }
+        // 4. Check if it's a valid SNS name (Solana Name Service)
+        if (address.toLowerCase().includes('.')) {
+            const parts = address.toLowerCase().split('.');
+            if (parts.length === 2) {
+                const [name, tld] = parts;
+                if (this.VALID_SNS_TLDS.includes(tld) &&
+                    this.SNS_NAME_REGEX.test(name) &&
+                    name.length >= 1) {
+                    return {
+                        name: address.toLowerCase(),
+                        address: null,
+                        chainType: enums_1.ChainType.SOLANA, // SNS resolves to Solana addresses
+                    };
+                }
+            }
+        }
+        // If no format matches, return undefined
+        return undefined;
+    }
+    /**
+     * Quick EVM address validation
+     */
+    static isValidEVMAddress(address) {
+        return this.EVM_REGEX.test(address);
+    }
+    /**
+     * Quick Solana address validation
+     */
+    static isValidSolanaAddress(address) {
+        return (!address.startsWith('0x') &&
+            address.length >= 32 &&
+            address.length <= 44 &&
+            this.BASE58_REGEX.test(address));
+    }
+    /**
+     * Quick ENS name validation
+     */
+    static isValidENSName(address) {
+        return ((address.toLowerCase().endsWith('.eth') ||
+            address.toLowerCase().endsWith('.box')) &&
+            address.length >= 5 &&
+            this.ENS_REGEX.test(address));
+    }
+    /**
+     * Quick SNS name validation
+     */
+    static isValidSNSName(address) {
+        if (!address.toLowerCase().includes('.'))
+            return false;
+        const parts = address.toLowerCase().split('.');
+        if (parts.length !== 2)
+            return false;
+        const [name, tld] = parts;
+        return (this.VALID_SNS_TLDS.includes(tld) &&
+            this.SNS_NAME_REGEX.test(name) &&
+            name.length >= 1);
+    }
+}
+exports.Web3UsernameValidator = Web3UsernameValidator;
+// Regex patterns for different address types
+Web3UsernameValidator.EVM_REGEX = /^0x[a-fA-F0-9]{40}$/;
+Web3UsernameValidator.BASE58_REGEX = /^[1-9A-HJ-NP-Za-km-z]+$/;
+Web3UsernameValidator.ENS_REGEX = /^[a-zA-Z0-9]([a-zA-Z0-9]|(-[a-zA-Z0-9]))*\.(eth|box)$/i;
+Web3UsernameValidator.SNS_NAME_REGEX = /^[a-zA-Z0-9]([a-zA-Z0-9]|(-[a-zA-Z0-9]))*$/;
+// Valid SNS top-level domains
+Web3UsernameValidator.VALID_SNS_TLDS = [
+    'sol',
+    'abc',
+    'backpack',
+    'bonk',
+    'coin',
+    'dao',
+    'defi',
+    'gm',
+    'poor',
+    'pump',
+    'shdw',
+    'stepn',
+    'web3',
+];
+//# sourceMappingURL=web3-username-validator.js.map

package/dist/utils/validation/web3-username-validator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Address Validation Utility
+ * @description Centralized address validation for EVM, Solana, ENS, and SNS addresses
+ * Eliminates code duplication across multiple files
+ *
+ * Pure TypeScript implementation with no external dependencies
+ */
+import { ChainType } from '../../types/business/enums';
+import { Optional } from '../../types/common';
+export interface AddressValidationResult {
+    name?: Optional<string>;
+    address?: Optional<string>;
+    chainType: ChainType;
+}
+export declare class Web3UsernameValidator {
+    private static readonly EVM_REGEX;
+    private static readonly BASE58_REGEX;
+    private static readonly ENS_REGEX;
+    private static readonly SNS_NAME_REGEX;
+    private static readonly VALID_SNS_TLDS;
+    /**
+     * Comprehensive address validation for API endpoint
+     * Returns AddressValidationResult for valid addresses, undefined for invalid ones
+     */
+    static validate(address: string): Optional<AddressValidationResult>;
+    /**
+     * Quick EVM address validation
+     */
+    static isValidEVMAddress(address: string): boolean;
+    /**
+     * Quick Solana address validation
+     */
+    static isValidSolanaAddress(address: string): boolean;
+    /**
+     * Quick ENS name validation
+     */
+    static isValidENSName(address: string): boolean;
+    /**
+     * Quick SNS name validation
+     */
+    static isValidSNSName(address: string): boolean;
+}
+//# sourceMappingURL=web3-username-validator.d.ts.map

package/dist/utils/validation/web3-username-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3-username-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/validation/web3-username-validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,qBAAa,qBAAqB;IAEhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA6B;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAC0B;IAC3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CACS;IAG/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAcpC;IAEF;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,uBAAuB,CAAC;IAiEnE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASrD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAS/C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAWhD"}