@sudobility/types 1.8.21

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

@@ -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.js.map

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

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@sudobility/types",
+  "version": "1.8.21",
+  "description": "Comprehensive TypeScript types, interfaces, and utilities for the 0xmail.box Web3 email ecosystem - optimized for AI-assisted development",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./api": {
+      "import": "./dist/types/api/indexer-responses.js",
+      "require": "./dist/types/api/indexer-responses.cjs",
+      "types": "./dist/types/api/indexer-responses.d.ts"
+    },
+    "./enums": {
+      "import": "./dist/types/business/enums.js",
+      "require": "./dist/types/business/enums.cjs",
+      "types": "./dist/types/business/enums.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && npm run build:cjs-rename",
+    "build:cjs-rename": "find dist -name '*.js' -not -name '*.cjs' -exec sh -c 'cp \"$1\" \"${1%.js}.cjs\"' _ {} \\;",
+    "clean": "rimraf dist",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.{ts,js,json,md}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,js,json,md}\"",
+    "typecheck": "tsc --noEmit",
+    "verify": "npm run typecheck && npm run lint && npm run test && npm run build",
+    "ai:analyze": "node .ai/scripts/analyze-types.js",
+    "ai:validate-exports": "node .ai/scripts/validate-exports.js",
+    "ai:docs": "npm run ai:analyze && npm run ai:validate-exports",
+    "prepublishOnly": "npm run clean && npm run verify"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "CLAUDE.md"
+  ],
+  "keywords": [
+    "typescript",
+    "types",
+    "interfaces",
+    "0xmail",
+    "web3",
+    "blockchain",
+    "email",
+    "ai-optimized",
+    "tree-shakeable",
+    "zero-dependencies"
+  ],
+  "author": "0xmail.box",
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^9.36.0",
+    "@types/node": "^24.5.2",
+    "@typescript-eslint/eslint-plugin": "^8.44.0",
+    "@typescript-eslint/parser": "^8.44.0",
+    "eslint": "^9.36.0",
+    "globals": "^16.4.0",
+    "prettier": "^3.0.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  }
+}