@sudobility/types 1.9.54 → 1.9.56

package/dist/utils/constants/status-values.cjs

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.STATUS_VALUES = void 0;
-/**
- * Shared status value constants
- * Used across multiple enums to ensure consistency and avoid duplication
- */
-exports.STATUS_VALUES = {
-    SUCCESS: 'success',
-    PENDING: 'pending',
-    FAILED: 'failed',
-    ERROR: 'error',
-};
-//# sourceMappingURL=status-values.js.map

package/dist/utils/formatting/currency.cjs

@@ -1,39 +0,0 @@
-"use strict";
-/**
- * Currency formatting utilities for USDC and other tokens.
- *
- * @since 1.0.0
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLAIM_PERIOD_DAYS = exports.USDC_DECIMALS = void 0;
-exports.formatUSDC = formatUSDC;
-exports.parseUSDC = parseUSDC;
-/** Number of decimal places for USDC token amounts. */
-exports.USDC_DECIMALS = 6;
-/** Revenue claim expiration period in days. */
-exports.CLAIM_PERIOD_DAYS = 60;
-/**
- * Format USDC amount from smallest unit to human-readable string
- * @param amount - Amount in smallest USDC units (with 6 decimals)
- * @returns Formatted string with 2 decimal places
- *
- * @example
- * formatUSDC(1000000) // Returns "1.00"
- * formatUSDC(2500000) // Returns "2.50"
- */
-function formatUSDC(amount) {
-    return (amount / Math.pow(10, exports.USDC_DECIMALS)).toFixed(2);
-}
-/**
- * Parse USDC amount from human-readable string to smallest unit
- * @param amount - Human-readable amount string
- * @returns Amount in smallest USDC units (with 6 decimals)
- *
- * @example
- * parseUSDC("1.00") // Returns 1000000
- * parseUSDC("2.50") // Returns 2500000
- */
-function parseUSDC(amount) {
-    return Math.floor(parseFloat(amount) * Math.pow(10, exports.USDC_DECIMALS));
-}
-//# sourceMappingURL=currency.js.map

package/dist/utils/formatting/date.cjs

@@ -1,197 +0,0 @@
-"use strict";
-/**
- * Date formatting utilities.
- *
- * @since 1.0.0
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatEmailDate = formatEmailDate;
-exports.formatTimestamp = formatTimestamp;
-exports.formatRelativeTime = formatRelativeTime;
-exports.parseDate = parseDate;
-exports.isDateInRange = isDateInRange;
-exports.addDays = addDays;
-exports.addHours = addHours;
-/**
- * Format a date for display in email list.
- * Returns time for today, "Yesterday", day name for the past week,
- * or a short date for older messages.
- *
- * @param date - Date object or ISO date string
- * @returns Formatted date string
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * formatEmailDate(new Date()); // "3:45 PM"
- * formatEmailDate('2024-01-15'); // "Jan 15"
- * ```
- */
-function formatEmailDate(date) {
-    const dateObj = typeof date === 'string' ? new Date(date) : date;
-    if (isNaN(dateObj.getTime())) {
-        return 'Invalid date';
-    }
-    const now = new Date();
-    const diffMs = now.getTime() - dateObj.getTime();
-    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
-    // Today: show time only
-    if (diffDays === 0) {
-        return dateObj.toLocaleTimeString('en-US', {
-            hour: 'numeric',
-            minute: '2-digit',
-            hour12: true,
-        });
-    }
-    // Yesterday
-    if (diffDays === 1) {
-        return 'Yesterday';
-    }
-    // Within a week: show day name
-    if (diffDays < 7) {
-        return dateObj.toLocaleDateString('en-US', {
-            weekday: 'long',
-        });
-    }
-    // Within this year: show month and day
-    if (dateObj.getFullYear() === now.getFullYear()) {
-        return dateObj.toLocaleDateString('en-US', {
-            month: 'short',
-            day: 'numeric',
-        });
-    }
-    // Different year: show full date
-    return dateObj.toLocaleDateString('en-US', {
-        year: 'numeric',
-        month: 'short',
-        day: 'numeric',
-    });
-}
-/**
- * Format a Unix timestamp (ms) to an ISO 8601 string.
- *
- * @param timestamp - Unix timestamp in milliseconds
- * @returns ISO 8601 date string
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * formatTimestamp(1700000000000); // "2023-11-14T22:13:20.000Z"
- * ```
- */
-function formatTimestamp(timestamp) {
-    return new Date(timestamp).toISOString();
-}
-/**
- * Format a date to a relative time string (e.g., "2 hours ago").
- *
- * @param date - Date object, ISO string, or Unix timestamp (ms)
- * @returns Human-readable relative time string
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * formatRelativeTime(Date.now() - 3600000); // "1 hour ago"
- * formatRelativeTime('2024-01-01'); // "1 year ago"
- * ```
- */
-function formatRelativeTime(date) {
-    const dateObj = typeof date === 'string' || typeof date === 'number'
-        ? new Date(date)
-        : date;
-    if (isNaN(dateObj.getTime())) {
-        return 'Invalid date';
-    }
-    const now = new Date();
-    const diffMs = now.getTime() - dateObj.getTime();
-    const diffSeconds = Math.floor(diffMs / 1000);
-    const diffMinutes = Math.floor(diffSeconds / 60);
-    const diffHours = Math.floor(diffMinutes / 60);
-    const diffDays = Math.floor(diffHours / 24);
-    const diffWeeks = Math.floor(diffDays / 7);
-    const diffMonths = Math.floor(diffDays / 30);
-    const diffYears = Math.floor(diffDays / 365);
-    if (diffSeconds < 60) {
-        return 'just now';
-    }
-    if (diffMinutes < 60) {
-        return diffMinutes === 1 ? '1 minute ago' : `${diffMinutes} minutes ago`;
-    }
-    if (diffHours < 24) {
-        return diffHours === 1 ? '1 hour ago' : `${diffHours} hours ago`;
-    }
-    if (diffDays < 7) {
-        return diffDays === 1 ? '1 day ago' : `${diffDays} days ago`;
-    }
-    if (diffWeeks < 4) {
-        return diffWeeks === 1 ? '1 week ago' : `${diffWeeks} weeks ago`;
-    }
-    if (diffMonths < 12) {
-        return diffMonths === 1 ? '1 month ago' : `${diffMonths} months ago`;
-    }
-    return diffYears === 1 ? '1 year ago' : `${diffYears} years ago`;
-}
-/**
- * Parse a date string safely, returning null on invalid input.
- *
- * @param dateString - Date string to parse
- * @returns Parsed Date or null if invalid
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * parseDate('2024-01-15'); // Date object
- * parseDate('not-a-date'); // null
- * ```
- */
-function parseDate(dateString) {
-    try {
-        const date = new Date(dateString);
-        if (isNaN(date.getTime())) {
-            return null;
-        }
-        return date;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Check if a date falls within an inclusive range.
- *
- * @param date - Date to check
- * @param startDate - Range start (inclusive)
- * @param endDate - Range end (inclusive)
- * @returns True if date is within the range
- * @since 1.0.0
- */
-function isDateInRange(date, startDate, endDate) {
-    return date >= startDate && date <= endDate;
-}
-/**
- * Add (or subtract) days from a date. Returns a new Date instance.
- *
- * @param date - Starting date
- * @param days - Number of days to add (negative to subtract)
- * @returns New Date with days added
- * @since 1.0.0
- */
-function addDays(date, days) {
-    const result = new Date(date);
-    result.setDate(result.getDate() + days);
-    return result;
-}
-/**
- * Add (or subtract) hours from a date. Returns a new Date instance.
- *
- * @param date - Starting date
- * @param hours - Number of hours to add (negative to subtract)
- * @returns New Date with hours added
- * @since 1.0.0
- */
-function addHours(date, hours) {
-    const result = new Date(date);
-    result.setHours(result.getHours() + hours);
-    return result;
-}
-//# sourceMappingURL=date.js.map

package/dist/utils/formatting/string.cjs

@@ -1,326 +0,0 @@
-"use strict";
-/**
- * String formatting and manipulation utilities.
- *
- * @since 1.0.0
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.truncate = truncate;
-exports.capitalize = capitalize;
-exports.toTitleCase = toTitleCase;
-exports.toKebabCase = toKebabCase;
-exports.toCamelCase = toCamelCase;
-exports.toSnakeCase = toSnakeCase;
-exports.normalizeWhitespace = normalizeWhitespace;
-exports.isBlank = isBlank;
-exports.isNotBlank = isNotBlank;
-exports.escapeHtml = escapeHtml;
-exports.stripHtml = stripHtml;
-exports.getInitials = getInitials;
-exports.formatBytes = formatBytes;
-exports.randomString = randomString;
-exports.pluralize = pluralize;
-exports.formatNumber = formatNumber;
-/**
- * Truncate a string to a maximum length with a suffix (default `...`).
- *
- * @param str - Input string
- * @param maxLength - Maximum allowed length including suffix
- * @param suffix - Truncation suffix (default: `'...'`)
- * @returns Truncated string or original if within limit
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * truncate('Hello, World!', 8); // "Hello..."
- * ```
- */
-function truncate(str, maxLength, suffix = '...') {
-    if (!str || str.length <= maxLength) {
-        return str;
-    }
-    return str.slice(0, maxLength - suffix.length) + suffix;
-}
-/**
- * Capitalize the first letter of a string.
- *
- * @param str - Input string
- * @returns String with first character uppercased
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * capitalize('hello'); // "Hello"
- * ```
- */
-function capitalize(str) {
-    if (!str)
-        return str;
-    return str.charAt(0).toUpperCase() + str.slice(1);
-}
-/**
- * Convert a string to title case (capitalize each word).
- *
- * @param str - Input string
- * @returns Title-cased string
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * toTitleCase('hello world'); // "Hello World"
- * ```
- */
-function toTitleCase(str) {
-    if (!str)
-        return str;
-    return str
-        .toLowerCase()
-        .split(' ')
-        .map((word) => capitalize(word))
-        .join(' ');
-}
-/**
- * Convert a string to kebab-case.
- *
- * @param str - Input string (camelCase, PascalCase, spaces, or underscores)
- * @returns Kebab-cased string
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * toKebabCase('helloWorld'); // "hello-world"
- * ```
- */
-function toKebabCase(str) {
-    if (!str)
-        return str;
-    return str
-        .replace(/([a-z])([A-Z])/g, '$1-$2')
-        .replace(/[\s_]+/g, '-')
-        .toLowerCase();
-}
-/**
- * Convert a string to camelCase.
- *
- * @param str - Input string (kebab-case, snake_case, or spaces)
- * @returns camelCased string
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * toCamelCase('hello-world'); // "helloWorld"
- * ```
- */
-function toCamelCase(str) {
-    if (!str)
-        return str;
-    return str
-        .replace(/[-_\s]+(.)?/g, (_, char) => (char ? char.toUpperCase() : ''))
-        .replace(/^./, (char) => char.toLowerCase());
-}
-/**
- * Convert a string to snake_case.
- *
- * @param str - Input string (camelCase, kebab-case, or spaces)
- * @returns snake_cased string
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * toSnakeCase('helloWorld'); // "hello_world"
- * ```
- */
-function toSnakeCase(str) {
-    if (!str)
-        return str;
-    return str
-        .replace(/([a-z])([A-Z])/g, '$1_$2')
-        .replace(/[\s-]+/g, '_')
-        .toLowerCase();
-}
-/**
- * Collapse consecutive whitespace to a single space and trim.
- *
- * @param str - Input string
- * @returns Normalized string
- * @since 1.0.0
- */
-function normalizeWhitespace(str) {
-    if (!str)
-        return str;
-    return str.replace(/\s+/g, ' ').trim();
-}
-/**
- * Check if a string is empty, undefined, null, or only whitespace.
- *
- * @param str - Input string (may be nullish)
- * @returns True if blank
- * @since 1.0.0
- */
-function isBlank(str) {
-    return !str || str.trim().length === 0;
-}
-/**
- * Type guard: check if a string is not empty and not only whitespace.
- *
- * @param str - Input string (may be nullish)
- * @returns True (and narrows to `string`) if not blank
- * @since 1.0.0
- */
-function isNotBlank(str) {
-    return !isBlank(str);
-}
-/**
- * Escape HTML special characters (`&`, `<`, `>`, `"`, `'`).
- *
- * @param str - Input string
- * @returns HTML-escaped string
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * escapeHtml('<b>Hi</b>'); // "&lt;b&gt;Hi&lt;/b&gt;"
- * ```
- */
-function escapeHtml(str) {
-    if (!str)
-        return str;
-    const htmlEscapes = {
-        '&': '&amp;',
-        '<': '&lt;',
-        '>': '&gt;',
-        '"': '&quot;',
-        "'": '&#39;',
-    };
-    return str.replace(/[&<>"']/g, (char) => htmlEscapes[char]);
-}
-/**
- * Remove all HTML tags from a string.
- *
- * @param str - Input string with HTML
- * @returns Plain text with tags removed
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * stripHtml('<p>Hello <b>world</b></p>'); // "Hello world"
- * ```
- */
-function stripHtml(str) {
-    if (!str)
-        return str;
-    return str.replace(/<[^>]*>/g, '');
-}
-/**
- * Extract initials from a name (e.g., "John Doe" -> "JD").
- *
- * @param name - Full name
- * @param maxInitials - Maximum number of initials (default: 2)
- * @returns Uppercase initials
- * @since 1.0.0
- */
-function getInitials(name, maxInitials = 2) {
-    if (!name)
-        return '';
-    const words = name.trim().split(/\s+/);
-    const initials = words
-        .slice(0, maxInitials)
-        .map((word) => word.charAt(0).toUpperCase())
-        .join('');
-    return initials;
-}
-/**
- * Format bytes to a human-readable size string (e.g., "1.5 MB").
- *
- * @param bytes - Size in bytes
- * @param decimals - Decimal places (default: 2)
- * @returns Formatted string like "1.5 MB"
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * formatBytes(1536); // "1.5 KB"
- * formatBytes(0);    // "0 Bytes"
- * ```
- */
-function formatBytes(bytes, decimals = 2) {
-    if (bytes === 0)
-        return '0 Bytes';
-    const k = 1024;
-    const dm = decimals < 0 ? 0 : decimals;
-    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB'];
-    const i = Math.floor(Math.log(bytes) / Math.log(k));
-    return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];
-}
-/**
- * Generate a random string of a given length.
- *
- * @param length - Desired string length
- * @param charset - Character set: `'alpha'`, `'numeric'`,
- *   `'alphanumeric'` (default), `'hex'`, or a custom string
- * @returns Random string
- * @since 1.0.0
- */
-function randomString(length, charset = 'alphanumeric') {
-    let chars;
-    switch (charset) {
-        case 'alpha':
-            chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
-            break;
-        case 'numeric':
-            chars = '0123456789';
-            break;
-        case 'alphanumeric':
-            chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
-            break;
-        case 'hex':
-            chars = '0123456789abcdef';
-            break;
-        default:
-            chars = charset;
-    }
-    let result = '';
-    for (let i = 0; i < length; i++) {
-        result += chars.charAt(Math.floor(Math.random() * chars.length));
-    }
-    return result;
-}
-/**
- * Pluralize a word based on count.
- * Appends `'s'` by default when count is not 1.
- *
- * @param count - Item count
- * @param singular - Singular form
- * @param plural - Optional explicit plural form
- * @returns Singular or plural form based on count
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * pluralize(1, 'item');  // "item"
- * pluralize(3, 'item');  // "items"
- * pluralize(2, 'child', 'children'); // "children"
- * ```
- */
-function pluralize(count, singular, plural) {
-    if (count === 1) {
-        return singular;
-    }
-    return plural || `${singular}s`;
-}
-/**
- * Format a number with commas as thousands separators.
- *
- * @param num - Number to format
- * @returns Formatted string (e.g., "1,234,567")
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * formatNumber(1234567); // "1,234,567"
- * ```
- */
-function formatNumber(num) {
-    return num.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
-}
-//# sourceMappingURL=string.js.map

package/dist/utils/logging/logger.cjs

@@ -1,92 +0,0 @@
-"use strict";
-/**
- * Centralized logging utility
- * Provides consistent logging across the application with proper formatting
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.storageLogger = exports.ensLogger = exports.contractLogger = exports.apiLogger = exports.authLogger = exports.logger = exports.LogLevel = void 0;
-var LogLevel;
-(function (LogLevel) {
-    LogLevel["ERROR"] = "error";
-    LogLevel["WARN"] = "warn";
-    LogLevel["INFO"] = "info";
-    LogLevel["DEBUG"] = "debug";
-})(LogLevel || (exports.LogLevel = LogLevel = {}));
-class Logger {
-    constructor() {
-        this.isDevelopment = process.env.NODE_ENV === 'development';
-    }
-    formatTimestamp() {
-        return new Date().toISOString();
-    }
-    formatMessage(_level, message, context) {
-        const timestamp = this.formatTimestamp();
-        const contextStr = context ? ` [${context}]` : '';
-        return `[${timestamp}]${contextStr} ${message}`;
-    }
-    shouldLog(level) {
-        // In production, only log warnings and errors
-        if (!this.isDevelopment) {
-            return level === LogLevel.ERROR || level === LogLevel.WARN;
-        }
-        return true;
-    }
-    error(message, context, data) {
-        if (this.shouldLog(LogLevel.ERROR)) {
-            console.error(this.formatMessage(LogLevel.ERROR, message, context));
-            if (data) {
-                console.error(data);
-            }
-        }
-    }
-    warn(message, context, data) {
-        if (this.shouldLog(LogLevel.WARN)) {
-            console.warn(this.formatMessage(LogLevel.WARN, message, context));
-            if (data) {
-                console.warn(data);
-            }
-        }
-    }
-    info(message, context, data) {
-        if (this.shouldLog(LogLevel.INFO)) {
-            console.log(this.formatMessage(LogLevel.INFO, message, context));
-            if (data) {
-                console.log(data);
-            }
-        }
-    }
-    debug(message, context, data) {
-        if (this.shouldLog(LogLevel.DEBUG)) {
-            console.log(this.formatMessage(LogLevel.DEBUG, message, context));
-            if (data) {
-                console.log(data);
-            }
-        }
-    }
-    /**
-     * Create a contextual logger that automatically includes context in all calls
-     */
-    withContext(context) {
-        return {
-            error: (message, data) => this.error(message, context, data),
-            warn: (message, data) => this.warn(message, context, data),
-            info: (message, data) => this.info(message, context, data),
-            debug: (message, data) => this.debug(message, context, data),
-        };
-    }
-}
-// Export singleton instance
-const logger = new Logger();
-exports.logger = logger;
-// Export contextual loggers for common areas
-const authLogger = logger.withContext('AUTH');
-exports.authLogger = authLogger;
-const apiLogger = logger.withContext('API');
-exports.apiLogger = apiLogger;
-const contractLogger = logger.withContext('CONTRACT');
-exports.contractLogger = contractLogger;
-const ensLogger = logger.withContext('ENS');
-exports.ensLogger = ensLogger;
-const storageLogger = logger.withContext('STORAGE');
-exports.storageLogger = storageLogger;
-//# sourceMappingURL=logger.js.map