@sudobility/types 1.9.55 → 1.9.56

package/dist/utils/url/url-params.cjs

@@ -1,128 +0,0 @@
-"use strict";
-/**
- * Platform-agnostic URLSearchParams wrapper
- * Provides URLSearchParams functionality with React Native compatibility
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createURLSearchParams = createURLSearchParams;
-exports.createSearchParams = createSearchParams;
-exports.searchParamsToString = searchParamsToString;
-exports.parseSearchParams = parseSearchParams;
-/**
- * Simple URLSearchParams implementation for environments that don't have it
- */
-class SimpleURLSearchParams {
-    constructor(init) {
-        this.params = new Map();
-        if (init) {
-            if (typeof init === 'string') {
-                this.parseString(init);
-            }
-            else if (Array.isArray(init)) {
-                for (const [key, value] of init) {
-                    this.append(key, value);
-                }
-            }
-            else {
-                for (const [key, value] of Object.entries(init)) {
-                    if (value !== undefined) {
-                        this.append(key, value);
-                    }
-                }
-            }
-        }
-    }
-    parseString(str) {
-        const params = str.startsWith('?') ? str.slice(1) : str;
-        if (!params)
-            return;
-        for (const pair of params.split('&')) {
-            const [key, value = ''] = pair.split('=');
-            if (key) {
-                this.append(decodeURIComponent(key), decodeURIComponent(value));
-            }
-        }
-    }
-    append(name, value) {
-        if (!this.params.has(name)) {
-            this.params.set(name, []);
-        }
-        const existingValues = this.params.get(name);
-        if (existingValues) {
-            existingValues.push(value);
-        }
-    }
-    delete(name) {
-        this.params.delete(name);
-    }
-    get(name) {
-        const values = this.params.get(name);
-        return values && values.length > 0 ? values[0] : null;
-    }
-    getAll(name) {
-        return this.params.get(name) || [];
-    }
-    has(name) {
-        return this.params.has(name);
-    }
-    set(name, value) {
-        this.params.set(name, [value]);
-    }
-    toString() {
-        const pairs = [];
-        this.params.forEach((values, key) => {
-            for (const value of values) {
-                pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
-            }
-        });
-        return pairs.join('&');
-    }
-    forEach(callback) {
-        this.params.forEach((values, key) => {
-            for (const value of values) {
-                callback(value, key);
-            }
-        });
-    }
-}
-/**
- * Create a URLSearchParams instance with cross-platform compatibility
- */
-function createURLSearchParams(init) {
-    // Check if native URLSearchParams is available
-    if (typeof URLSearchParams !== 'undefined') {
-        return new URLSearchParams(init);
-    }
-    // Fall back to our implementation for React Native or other environments
-    return new SimpleURLSearchParams(init);
-}
-/**
- * Convenience function to create URL search params from an object
- */
-function createSearchParams(params) {
-    const searchParams = createURLSearchParams(undefined);
-    for (const [key, value] of Object.entries(params)) {
-        if (value !== undefined && value !== null) {
-            searchParams.append(key, String(value));
-        }
-    }
-    return searchParams;
-}
-/**
- * Convert search params to a query string
- */
-function searchParamsToString(params) {
-    return params.toString();
-}
-/**
- * Parse a query string into an object
- */
-function parseSearchParams(queryString) {
-    const params = createURLSearchParams(queryString);
-    const result = {};
-    params.forEach((value, key) => {
-        result[key] = value;
-    });
-    return result;
-}
-//# sourceMappingURL=url-params.js.map

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

@@ -1,250 +0,0 @@
-"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
- * the expected type. Returns a {@link ValidationResult}.
- *
- * @template T - The validated type
- * @param validationFn - Type guard function
- * @param typeName - Name used in error messages
- * @returns A function returning `ValidationResult<T>`
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * const validateString = createValidator(isString, 'string');
- * validateString('hi');  // { isValid: true, data: 'hi' }
- * validateString(42);    // { isValid: false, error: 'Invalid string' }
- * ```
- */
-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;
-/**
- * Runtime type guard: checks if value is a `string`.
- * @since 1.0.0
- */
-const isString = (value) => typeof value === 'string';
-exports.isString = isString;
-/**
- * Runtime type guard: checks if value is a finite `number` (excludes NaN).
- * @since 1.0.0
- */
-const isNumber = (value) => typeof value === 'number' && !isNaN(value);
-exports.isNumber = isNumber;
-/**
- * Runtime type guard: checks if value is a `boolean`.
- * @since 1.0.0
- */
-const isBoolean = (value) => typeof value === 'boolean';
-exports.isBoolean = isBoolean;
-/**
- * Runtime type guard: checks if value is a non-null, non-array object.
- * @since 1.0.0
- */
-const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-exports.isObject = isObject;
-/**
- * Runtime type guard: checks if value is an array.
- * @since 1.0.0
- */
-const isArray = (value) => Array.isArray(value);
-exports.isArray = isArray;
-/**
- * Runtime type guard: checks if value is `null` or `undefined`.
- * @since 1.0.0
- */
-const isNullish = (value) => value === null || value === undefined;
-exports.isNullish = isNullish;
-/**
- * Validates that an object has all required properties present.
- *
- * @template T - Expected object shape
- * @param obj - Value to check
- * @param requiredProps - Array of required property keys
- * @returns True if obj has all required properties
- * @since 1.0.0
- */
-const hasRequiredProperties = (obj, requiredProps) => {
-    if (!(0, exports.isObject)(obj))
-        return false;
-    return requiredProps.every((prop) => prop in obj);
-};
-exports.hasRequiredProperties = hasRequiredProperties;
-/**
- * Validates that a value is an array where every item passes a validator.
- *
- * @template T - Expected item type
- * @param data - Value to check
- * @param itemValidator - Type guard for individual items
- * @returns True if data is an array of T
- * @since 1.0.0
- */
-const validateArray = (data, itemValidator) => {
-    if (!(0, exports.isArray)(data))
-        return false;
-    return data.every(itemValidator);
-};
-exports.validateArray = validateArray;
-/**
- * Wraps a validator to also accept `undefined`.
- *
- * @template T - The validated type
- * @param validator - Base type guard
- * @returns Type guard that also accepts `undefined`
- * @since 1.0.0
- */
-const optional = (validator) => (value) => {
-    return value === undefined || validator(value);
-};
-exports.optional = optional;
-/**
- * Check if data looks like an API response (has `success` boolean).
- * @since 1.0.0
- */
-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;
-/**
- * Check if a value is a string that parses to a valid date.
- * @since 1.0.0
- */
-const isValidDate = (value) => {
-    if (!(0, exports.isString)(value))
-        return false;
-    const date = new Date(value);
-    return !isNaN(date.getTime());
-};
-exports.isValidDate = isValidDate;
-/**
- * Basic email format validation.
- * @since 1.0.0
- */
-const isEmail = (value) => {
-    if (!(0, exports.isString)(value))
-        return false;
-    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-    return emailRegex.test(value);
-};
-exports.isEmail = isEmail;
-/**
- * Basic URL validation using the `URL` constructor.
- * @since 1.0.0
- */
-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 `TypeError` on
- * invalid data. Use with `createValidator` for the non-throwing variant.
- *
- * @template T - The asserted type
- * @param validator - Type guard function
- * @param typeName - Name used in error messages
- * @returns An assertion function
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * const assertString = createAssertion(isString, 'string');
- * assertString('hello'); // passes
- * assertString(42);      // throws TypeError
- * ```
- */
-const createAssertion = (validator, typeName) => {
-    return (data, context = typeName) => {
-        if (!validator(data)) {
-            throw new TypeError(`Invalid ${context}: expected ${typeName}`);
-        }
-    };
-};
-exports.createAssertion = createAssertion;
-/**
- * Safely parse a JSON string, optionally validating the result.
- * Returns a {@link ValidationResult} instead of throwing.
- *
- * @template T - Expected parsed type
- * @param jsonString - JSON string to parse
- * @param validator - Optional type guard to validate the parsed result
- * @returns Validation result with parsed data or error
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * const result = parseJson('{"name":"Alice"}');
- * if (result.isValid) console.log(result.data);
- * ```
- */
-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/web3-username-validator.cjs

@@ -1,132 +0,0 @@
-"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