@xivdyetools/core 1.3.7

package/dist/services/APIService.js

@@ -0,0 +1,499 @@
+/**
+ * @xivdyetools/core - API Service
+ *
+ * Universalis API integration with caching and debouncing
+ * Environment-agnostic with pluggable cache backends
+ *
+ * @module services/APIService
+ */
+import { ErrorCode, AppError, NoOpLogger } from '../types/index.js';
+import { UNIVERSALIS_API_BASE, UNIVERSALIS_API_TIMEOUT, UNIVERSALIS_API_RETRY_COUNT, UNIVERSALIS_API_RETRY_DELAY, API_CACHE_TTL, API_RATE_LIMIT_DELAY, API_CACHE_VERSION, API_MAX_RESPONSE_SIZE, } from '../constants/index.js';
+import { retry, sleep, generateChecksum } from '../utils/index.js';
+/**
+ * Default fetch client using global fetch API
+ */
+export class DefaultFetchClient {
+    async fetch(url, options) {
+        return fetch(url, options);
+    }
+}
+/**
+ * Default rate limiter with configurable minimum delay between requests
+ */
+export class DefaultRateLimiter {
+    /**
+     * Constructor with optional minimum delay
+     * @param minDelay Minimum milliseconds between requests (default: API_RATE_LIMIT_DELAY)
+     */
+    constructor(minDelay = API_RATE_LIMIT_DELAY) {
+        this.minDelay = minDelay;
+        this.lastRequestTime = 0;
+    }
+    async waitIfNeeded() {
+        const timeSinceLastRequest = Date.now() - this.lastRequestTime;
+        if (timeSinceLastRequest < this.minDelay) {
+            await sleep(this.minDelay - timeSinceLastRequest);
+        }
+    }
+    recordRequest() {
+        this.lastRequestTime = Date.now();
+    }
+}
+/**
+ * In-memory cache backend (default, no persistence)
+ */
+export class MemoryCacheBackend {
+    constructor() {
+        this.cache = new Map();
+    }
+    get(key) {
+        return this.cache.get(key) || null;
+    }
+    set(key, value) {
+        this.cache.set(key, value);
+    }
+    delete(key) {
+        this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    keys() {
+        return Array.from(this.cache.keys());
+    }
+}
+/**
+ * Service for Universalis API integration
+ * Handles price data fetching with caching and debouncing
+ *
+ * Refactored for testability: Supports dependency injection of cache, fetch client, and rate limiter
+ *
+ * @example
+ * // With default implementations (memory cache, global fetch, standard rate limiting)
+ * const apiService = new APIService();
+ *
+ * // With custom cache backend (e.g., Redis)
+ * const redisCache = new RedisCacheBackend(redisClient);
+ * const apiService = new APIService(redisCache);
+ *
+ * // With custom fetch client for testing
+ * const mockFetch = new MockFetchClient();
+ * const apiService = new APIService(undefined, mockFetch);
+ *
+ * // With custom rate limiter (e.g., no rate limiting for tests)
+ * const noRateLimit = new NoOpRateLimiter();
+ * const apiService = new APIService(undefined, undefined, noRateLimit);
+ *
+ * // Fetch price data
+ * const priceData = await apiService.getPriceData(itemID, worldID, dataCenterID);
+ *
+ * // With custom logger for debugging
+ * import { ConsoleLogger } from 'xivdyetools-core';
+ * const apiService = new APIService({ logger: ConsoleLogger });
+ */
+export class APIService {
+    /**
+     * Constructor with optional dependency injection
+     * @param options Configuration options or legacy cache backend
+     */
+    constructor(options, fetchClient, rateLimiter) {
+        this.pendingRequests = new Map();
+        // Support both legacy positional arguments and new options object
+        if (options && 'logger' in options) {
+            // New options-based API
+            this.cache = options.cacheBackend ?? new MemoryCacheBackend();
+            this.fetchClient = options.fetchClient ?? new DefaultFetchClient();
+            this.rateLimiter = options.rateLimiter ?? new DefaultRateLimiter();
+            this.logger = options.logger ?? NoOpLogger;
+        }
+        else {
+            // Legacy positional arguments API
+            this.cache = options ?? new MemoryCacheBackend();
+            this.fetchClient = fetchClient ?? new DefaultFetchClient();
+            this.rateLimiter = rateLimiter ?? new DefaultRateLimiter();
+            this.logger = NoOpLogger;
+        }
+    }
+    // ============================================================================
+    // Cache Management
+    // ============================================================================
+    /**
+     * Get price from cache if available and not expired
+     * Validates cache version and checksum
+     */
+    async getCachedPrice(cacheKey) {
+        const cached = await this.cache.get(cacheKey);
+        if (!cached) {
+            return null;
+        }
+        // Check cache version
+        if (cached.version && cached.version !== API_CACHE_VERSION) {
+            await this.cache.delete(cacheKey);
+            return null;
+        }
+        // Check if cache has expired
+        if (Date.now() - cached.timestamp > cached.ttl) {
+            await this.cache.delete(cacheKey);
+            return null;
+        }
+        // Validate checksum if present
+        if (cached.checksum) {
+            const computedChecksum = generateChecksum(cached.data);
+            if (computedChecksum !== cached.checksum) {
+                this.logger.warn(`Cache corruption detected for key: ${cacheKey}`);
+                await this.cache.delete(cacheKey);
+                return null;
+            }
+        }
+        return cached.data;
+    }
+    /**
+     * Set price in cache with version and checksum
+     */
+    async setCachedPrice(cacheKey, data) {
+        const checksum = generateChecksum(data);
+        await this.cache.set(cacheKey, {
+            data,
+            timestamp: Date.now(),
+            ttl: API_CACHE_TTL,
+            version: API_CACHE_VERSION,
+            checksum,
+        });
+    }
+    /**
+     * Clear cache
+     */
+    async clearCache() {
+        await this.cache.clear();
+        this.logger.info('Price cache cleared');
+    }
+    /**
+     * Get cache stats
+     */
+    async getCacheStats() {
+        const keys = await this.cache.keys();
+        return { size: keys.length, keys };
+    }
+    // ============================================================================
+    // API Calls
+    // ============================================================================
+    /**
+     * Fetch price data for a dye from Universalis API
+     * Implements caching, debouncing, and retry logic
+     */
+    async getPriceData(itemID, worldID, dataCenterID) {
+        try {
+            // Build cache key
+            const cacheKey = this.buildCacheKey(itemID, worldID, dataCenterID);
+            // Check cache first
+            const cached = await this.getCachedPrice(cacheKey);
+            if (cached) {
+                this.logger.info(`Price cache hit for item ${itemID}`);
+                return cached;
+            }
+            // Check if request is already pending (deduplication)
+            if (this.pendingRequests.has(cacheKey)) {
+                this.logger.info(`Using pending request for item ${itemID}`);
+                return await this.pendingRequests.get(cacheKey);
+            }
+            // Create pending request
+            const promise = this.fetchPriceData(itemID, worldID, dataCenterID).then(async (data) => {
+                this.pendingRequests.delete(cacheKey);
+                if (data) {
+                    await this.setCachedPrice(cacheKey, data);
+                }
+                return data;
+            }, (error) => {
+                this.pendingRequests.delete(cacheKey);
+                throw error;
+            });
+            this.pendingRequests.set(cacheKey, promise);
+            return await promise;
+        }
+        catch (error) {
+            this.logger.error('Failed to fetch price data', error);
+            return null;
+        }
+    }
+    /**
+     * Internal method to fetch price data from API
+     */
+    async fetchPriceData(itemID, worldID, dataCenterID) {
+        // Rate limiting: use injected rate limiter
+        await this.rateLimiter.waitIfNeeded();
+        this.rateLimiter.recordRequest();
+        // Build API URL
+        const url = this.buildApiUrl(itemID, worldID, dataCenterID);
+        try {
+            const data = await retry(() => this.fetchWithTimeout(url, UNIVERSALIS_API_TIMEOUT), UNIVERSALIS_API_RETRY_COUNT, UNIVERSALIS_API_RETRY_DELAY);
+            if (!data) {
+                return null;
+            }
+            // Parse and validate response
+            return this.parseApiResponse(data, itemID);
+        }
+        catch (error) {
+            throw new AppError(ErrorCode.API_CALL_FAILED, `Failed to fetch price data for item ${itemID}: ${error instanceof Error ? error.message : 'Unknown error'}`, 'warning');
+        }
+    }
+    /**
+     * Fetch with timeout and size limits
+     * Uses injected fetch client for better testability
+     */
+    async fetchWithTimeout(url, timeoutMs) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const response = await this.fetchClient.fetch(url, { signal: controller.signal });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const contentType = response.headers.get('content-type');
+            if (!contentType?.includes('application/json')) {
+                throw new Error('Invalid content type: expected application/json');
+            }
+            // Check content-length header if available
+            const contentLength = response.headers.get('content-length');
+            if (contentLength) {
+                const size = parseInt(contentLength, 10);
+                if (!isNaN(size) && size > API_MAX_RESPONSE_SIZE) {
+                    throw new Error(`Response too large: ${size} bytes (max: ${API_MAX_RESPONSE_SIZE} bytes)`);
+                }
+            }
+            // Read response text and validate size
+            const text = await response.text();
+            if (text.length > API_MAX_RESPONSE_SIZE) {
+                throw new Error(`Response too large: ${text.length} bytes (max: ${API_MAX_RESPONSE_SIZE} bytes)`);
+            }
+            // Parse JSON with error handling
+            try {
+                return JSON.parse(text);
+            }
+            catch (parseError) {
+                throw new Error(`Invalid JSON response: ${parseError instanceof Error ? parseError.message : 'Unknown error'}`);
+            }
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Parse and validate API response
+     */
+    parseApiResponse(data, itemID) {
+        try {
+            // Validate response structure
+            if (!data || typeof data !== 'object') {
+                this.logger.warn(`Invalid API response structure for item ${itemID}`);
+                return null;
+            }
+            // Parse aggregated endpoint response format
+            if (!data.results || !Array.isArray(data.results) || data.results.length === 0) {
+                this.logger.warn(`No price data available for item ${itemID}`);
+                return null;
+            }
+            const result = data.results[0];
+            if (!result || typeof result !== 'object') {
+                this.logger.warn(`Invalid result structure for item ${itemID}`);
+                return null;
+            }
+            // Validate itemId type and match
+            if (typeof result.itemId !== 'number' || result.itemId !== itemID) {
+                this.logger.warn(`Item ID mismatch: expected ${itemID}, got ${result.itemId}`);
+                return null;
+            }
+            // Try to get price from nq.minListing (prefer DC, then world, then region)
+            let price = null;
+            if (result.nq?.minListing) {
+                // Prefer data center price
+                if (result.nq.minListing.dc?.price) {
+                    price = result.nq.minListing.dc.price;
+                }
+                // Fall back to world price
+                else if (result.nq.minListing.world?.price) {
+                    price = result.nq.minListing.world.price;
+                }
+                // Fall back to region price
+                else if (result.nq.minListing.region?.price) {
+                    price = result.nq.minListing.region.price;
+                }
+            }
+            // If no NQ price, try HQ
+            if (!price && result.hq?.minListing) {
+                if (result.hq.minListing.dc?.price) {
+                    price = result.hq.minListing.dc.price;
+                }
+                else if (result.hq.minListing.world?.price) {
+                    price = result.hq.minListing.world.price;
+                }
+                else if (result.hq.minListing.region?.price) {
+                    price = result.hq.minListing.region.price;
+                }
+            }
+            if (!price) {
+                this.logger.warn(`No price data available for item ${itemID}`);
+                return null;
+            }
+            return {
+                itemID,
+                currentAverage: Math.round(price),
+                currentMinPrice: Math.round(price), // Using same price for all fields
+                currentMaxPrice: Math.round(price),
+                lastUpdate: Date.now(),
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to parse price data for item ${itemID}`, error);
+            return null;
+        }
+    }
+    /**
+     * Build API URL for item price query
+     */
+    buildApiUrl(itemID, _worldID, dataCenterID) {
+        // Universalis API endpoint: /api/v2/aggregated/{dataCenter or worldName}/{itemIDs}
+        // Note: worldID parameter reserved for future use (world-specific queries)
+        // Sanitize dataCenterID to prevent URL path injection
+        const pathSegment = dataCenterID ? this.sanitizeDataCenterId(dataCenterID) : 'universal';
+        return `${UNIVERSALIS_API_BASE}/aggregated/${pathSegment}/${itemID}`;
+    }
+    /**
+     * Sanitize datacenter ID to prevent cache key injection.
+     * Only allows alphanumeric characters (a-z, A-Z, 0-9).
+     */
+    sanitizeDataCenterId(dataCenterID) {
+        return dataCenterID.replace(/[^a-zA-Z0-9]/g, '');
+    }
+    /**
+     * Build cache key from parameters
+     * SECURITY: Uses type prefixes to prevent cache key collisions
+     * Format: itemID:type:value where type is 'dc', 'world', or 'global'
+     * This prevents crafted dataCenterID values from colliding with other key patterns
+     */
+    buildCacheKey(itemID, worldID, dataCenterID) {
+        const parts = [itemID];
+        if (dataCenterID) {
+            // Type prefix 'dc' ensures datacenter keys don't collide with world/global keys
+            const sanitized = this.sanitizeDataCenterId(dataCenterID);
+            parts.push('dc', sanitized);
+        }
+        else if (worldID) {
+            // Type prefix 'world' ensures world keys don't collide with datacenter/global keys
+            parts.push('world', worldID);
+        }
+        else {
+            parts.push('global');
+        }
+        // Use colon delimiter (not in sanitized values) for unambiguous parsing
+        return parts.join(':');
+    }
+    // ============================================================================
+    // Batch Operations
+    // ============================================================================
+    /**
+     * Fetch prices for multiple items
+     * PERFORMANCE: Uses Promise.allSettled for parallel requests
+     * Failed requests are logged but don't block other results
+     */
+    async getPricesForItems(itemIDs) {
+        const results = new Map();
+        // Fire all requests in parallel
+        const promises = itemIDs.map(async (itemID) => {
+            const price = await this.getPriceData(itemID);
+            return { itemID, price };
+        });
+        // Wait for all to settle (don't fail on individual errors)
+        const settled = await Promise.allSettled(promises);
+        // Collect successful results
+        for (const result of settled) {
+            if (result.status === 'fulfilled' && result.value.price) {
+                results.set(result.value.itemID, result.value.price);
+            }
+        }
+        return results;
+    }
+    /**
+     * Fetch prices for dyes in a specific data center
+     * PERFORMANCE: Uses Promise.allSettled for parallel requests
+     */
+    async getPricesForDataCenter(itemIDs, dataCenterID) {
+        const results = new Map();
+        // Fire all requests in parallel
+        const promises = itemIDs.map(async (itemID) => {
+            const price = await this.getPriceData(itemID, undefined, dataCenterID);
+            return { itemID, price };
+        });
+        // Wait for all to settle (don't fail on individual errors)
+        const settled = await Promise.allSettled(promises);
+        // Collect successful results
+        for (const result of settled) {
+            if (result.status === 'fulfilled' && result.value.price) {
+                results.set(result.value.itemID, result.value.price);
+            }
+        }
+        return results;
+    }
+    // ============================================================================
+    // Health Checks
+    // ============================================================================
+    /**
+     * Check if Universalis API is available
+     * Uses injected fetch client
+     */
+    async isAPIAvailable() {
+        try {
+            const response = await this.fetchClient.fetch(`${UNIVERSALIS_API_BASE}/data-centers`);
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get API status information
+     */
+    async getAPIStatus() {
+        const start = Date.now();
+        try {
+            const available = await this.isAPIAvailable();
+            const latency = Date.now() - start;
+            return { available, latency };
+        }
+        catch {
+            return { available: false, latency: -1 };
+        }
+    }
+    // ============================================================================
+    // Utility Methods
+    // ============================================================================
+    /**
+     * Format price for display (FFXIV Gil format: 69,420G)
+     */
+    static formatPrice(price) {
+        const formattedNumber = new Intl.NumberFormat('en-US', {
+            minimumFractionDigits: 0,
+            maximumFractionDigits: 0,
+        }).format(price);
+        // Return with small "G" suffix
+        return `${formattedNumber}G`;
+    }
+    /**
+     * Calculate price trend (simplified)
+     */
+    static getPriceTrend(currentPrice, previousPrice) {
+        const change = currentPrice - previousPrice;
+        const changePercent = previousPrice === 0 ? 0 : (change / previousPrice) * 100;
+        let trend;
+        if (change > previousPrice * 0.05) {
+            trend = 'up';
+        }
+        else if (change < -previousPrice * 0.05) {
+            trend = 'down';
+        }
+        else {
+            trend = 'stable';
+        }
+        return { trend, change, changePercent: Math.round(changePercent * 100) / 100 };
+    }
+}
+//# sourceMappingURL=APIService.js.map

package/dist/services/APIService.js.map

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

package/dist/services/ColorService.d.ts

@@ -0,0 +1,146 @@
+/**
+ * @xivdyetools/core - Color Service
+ *
+ * Color conversion algorithms and colorblindness simulation.
+ * Provides utilities for converting between RGB, HSV, and hex color formats,
+ * calculating color distances, and simulating color vision deficiencies.
+ *
+ * Per R-4: Facade class that delegates to focused service classes
+ * Maintains backward compatibility while using split services internally
+ *
+ * @module services/ColorService
+ * @example
+ * ```typescript
+ * import { ColorService } from '@xivdyetools/core';
+ *
+ * // Convert hex to RGB
+ * const rgb = ColorService.hexToRgb('#FF0000');
+ * // { r: 255, g: 0, b: 0 }
+ *
+ * // Convert RGB to HSV
+ * const hsv = ColorService.rgbToHsv(rgb);
+ * // { h: 0, s: 100, v: 100 }
+ *
+ * // Calculate color distance
+ * const distance = ColorService.getColorDistance('#FF0000', '#00FF00');
+ * ```
+ */
+import type { RGB, HSV, HexColor, VisionType } from '../types/index.js';
+/**
+ * Color conversion and manipulation service (Facade)
+ * Per R-4: Delegates to focused service classes for better separation of concerns
+ * Maintains backward compatibility with existing API
+ */
+export declare class ColorService {
+    /**
+     * Clear all caches (useful for testing or memory management)
+     */
+    static clearCaches(): void;
+    /**
+     * Get cache statistics (for monitoring)
+     */
+    static getCacheStats(): {
+        hexToRgb: number;
+        rgbToHex: number;
+        rgbToHsv: number;
+        hsvToRgb: number;
+        hexToHsv: number;
+        colorblind: number;
+    };
+    /**
+     * Convert hexadecimal color to RGB
+     * @example hexToRgb("#FF0000") -> { r: 255, g: 0, b: 0 }
+     */
+    static hexToRgb(hex: string): RGB;
+    /**
+     * Convert RGB to hexadecimal color
+     * @example rgbToHex(255, 0, 0) -> "#FF0000"
+     */
+    static rgbToHex(r: number, g: number, b: number): HexColor;
+    /**
+     * Convert RGB to HSV
+     * @example rgbToHsv(255, 0, 0) -> { h: 0, s: 100, v: 100 }
+     */
+    static rgbToHsv(r: number, g: number, b: number): HSV;
+    /**
+     * Convert HSV to RGB
+     * @example hsvToRgb(0, 100, 100) -> { r: 255, g: 0, b: 0 }
+     */
+    static hsvToRgb(h: number, s: number, v: number): RGB;
+    /**
+     * Convert hex to HSV
+     */
+    static hexToHsv(hex: string): HSV;
+    /**
+     * Convert HSV to hex
+     */
+    static hsvToHex(h: number, s: number, v: number): HexColor;
+    /**
+     * Normalize a hex color to #RRGGBB format
+     */
+    static normalizeHex(hex: string): HexColor;
+    /**
+     * Calculate Euclidean distance between two RGB colors
+     * Returns 0 for identical colors, ~441.67 for white vs black
+     */
+    static getColorDistance(hex1: string, hex2: string): number;
+    /**
+     * Simulate colorblindness on an RGB color
+     * @example simulateColorblindness({ r: 255, g: 0, b: 0 }, 'deuteranopia')
+     */
+    static simulateColorblindness(rgb: RGB, visionType: VisionType): RGB;
+    /**
+     * Simulate colorblindness on a hex color
+     */
+    static simulateColorblindnessHex(hex: string, visionType: VisionType): HexColor;
+    /**
+     * Calculate perceived luminance of a color (0-1)
+     * Uses relative luminance formula from WCAG
+     */
+    static getPerceivedLuminance(hex: string): number;
+    /**
+     * Calculate contrast ratio between two colors
+     * Returns 1 (no contrast) to 21 (maximum contrast)
+     */
+    static getContrastRatio(hex1: string, hex2: string): number;
+    /**
+     * Check if two colors meet WCAG AA contrast ratio
+     */
+    static meetsWCAGAA(hex1: string, hex2: string, largeText?: boolean): boolean;
+    /**
+     * Check if two colors meet WCAG AAA contrast ratio
+     */
+    static meetsWCAGAAA(hex1: string, hex2: string, largeText?: boolean): boolean;
+    /**
+     * Check if a color is light (for determining text color on background)
+     */
+    static isLightColor(hex: string): boolean;
+    /**
+     * Get optimal text color for a background color
+     */
+    static getOptimalTextColor(backgroundColor: string): HexColor;
+    /**
+     * Adjust brightness of a color
+     * @param amount -100 to 100 (negative = darker, positive = lighter)
+     */
+    static adjustBrightness(hex: string, amount: number): HexColor;
+    /**
+     * Adjust saturation of a color
+     * @param amount -100 to 100 (negative = less saturated, positive = more saturated)
+     */
+    static adjustSaturation(hex: string, amount: number): HexColor;
+    /**
+     * Rotate hue of a color
+     * @param degrees 0-360 (amount to rotate hue)
+     */
+    static rotateHue(hex: string, degrees: number): HexColor;
+    /**
+     * Invert a color (create complementary color)
+     */
+    static invert(hex: string): HexColor;
+    /**
+     * Desaturate a color (convert to grayscale)
+     */
+    static desaturate(hex: string): HexColor;
+}
+//# sourceMappingURL=ColorService.d.ts.map

package/dist/services/ColorService.d.ts.map

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