@xivdyetools/core 2.7.0 → 4.0.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,qCAAqC,CAAC;AAG7C,YAAY,EACV,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,oCAAoC,CAAC;AAG5C,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,YAAY,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAGtD,YAAY,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGjG,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAEL,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAuB;AACtF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAuB;AAGlF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,9 +1,18 @@
+// @xivdyetools/core — public barrel.
+//
+// A `@public` JSDoc tag on a specifier below means: published API, deliberately
+// kept even though no workspace in this monorepo imports it. The root
+// `knip.jsonc` gate (`pnpm run lint:dead`, part of `lint`) reports every
+// untagged barrel export that nothing consumes, so a new export must either
+// gain a consumer or be tagged on purpose — see the package CLAUDE.md.
 // Services
 export { ColorService } from './services/ColorService.js';
-export { ColorConverter } from './services/color/ColorConverter.js';
+export { /** @public */ ColorConverter } from './services/color/ColorConverter.js';
 export { DyeService } from './services/DyeService.js';
-export { APIService, MemoryCacheBackend } from './services/APIService.js';
-export { LocalizationService, SUPPORTED_LOCALES, extractLocaleCode, resolveLocaleFromPreference, } from './services/LocalizationService.js';
+export { APIService, /** @public */ MemoryCacheBackend } from './services/APIService.js';
+export { LocalizationService, SUPPORTED_LOCALES, extractLocaleCode, 
+/** @public */
+resolveLocaleFromPreference, } from './services/LocalizationService.js';
 // Localization internals — exported for stateless callers (e.g., og-worker)
 // that prefer explicit-locale APIs over the singleton + setLocale pattern.
 export { LocaleLoader } from './services/localization/LocaleLoader.js';
@@ -15,17 +24,112 @@ export { CharacterColorService, } from './services/CharacterColorService.js';
 // Dye filtering
 export { isDyeExcluded, filterDyes, hasActiveFilters, EXPENSIVE_DYE_IDS, VENDOR_ACQUISITIONS, CRAFT_ACQUISITIONS, } from './services/dye/DyeFilter.js';
 export { 
-// Color matching presets (core-specific, not deprecated)
-MATCHING_PRESETS, } from './types/index.js';
+// 5.0 matching vocabulary (one list suite-wide, dE2000 default)
+MATCHING_METHODS, DEFAULT_MATCHING_METHOD, MATCHING_METHOD_TAGS, LEGACY_MATCHING_METHOD_MAP, isMatchingMethod, normalizeMatchingMethod, } from './types/index.js';
 // Dye consolidation (Patch 7.5)
 export { CONSOLIDATED_IDS, CONSOLIDATED_DYES, isConsolidationActive, getMarketItemID, getConsolidatedDyeName, } from './config/consolidated-ids.js';
+// Dye vocabulary (closed value sets + acquisition → price/currency coupling)
+export { 
+/** @public */
+DYE_CATEGORIES, 
+/** @public */
+DYE_ACQUISITIONS, 
+/** @public */
+ACQUISITION_META, 
+/** @public */
+METALLIC_STAIN_IDS, } from './config/dye-vocabulary.js';
+// Band vocabulary (5.0 calibrated per-method tier boundaries)
+export { BAND_VOCABULARY, BAND_METHOD_DP, 
+/** @public */
+RATIO_BANDS, classifyBandTier, 
+/** @public */
+classifyBandTierWithCuts, 
+/** @public */
+deriveDistinguishCuts, roundToBandDisplay, } from './config/band-vocabulary.js';
+export { SOCIAL_LINKS, PRODUCT_LINKS } from './config/product-links.js';
+// .chara character-file import (5.0 Swatch Matcher; parse rules live in core)
+export { parseCharaFile } from './services/chara/chara-parser.js';
+export { resolveCharaColors, 
+/** @public */ OFF_GRID_DELTA_E2000, } from './services/chara/chara-resolver.js';
+// Equipment model identity (packing helpers shared by api-worker's resolver
+// and the web-app client; the parser emits the keys, nothing in core resolves)
+export { 
+/** @public */ gearModelKey, 
+/** @public */ weaponModelKey, charaModelKey, formatCharaModelLabel, CHARA_SLOT_SEARCH_FIELD, 
+/** @public */ CHARA_WEAPON_SLOTS, isCharaWeaponSlot, isWornCharaModel, } from './services/chara/chara-models.js';
+// /manual topics + learn-more links (shared data for web, bot, og-worker)
+export { MANUAL_TOPICS, 
+/** @public */
+LODESTONE_BY_REGION, 
+/** @public */
+XIVDYETOOLS_DOCS_URL, getLearnLink, getLodestoneLink, } from './config/learn-links.js';
+// Facewear colors (split out of the dye database in schema v2)
+export { 
+/** @public */
+facewearColors, 
+/** @public */
+LEGACY_FACEWEAR_ITEM_IDS, 
+/** @public */
+getFacewearColor, getFacewearColorByLegacyItemID, } from './config/facewear.js';
 // Constants
-export { RGB_MIN, RGB_MAX, HUE_MIN, HUE_MAX, SATURATION_MIN, SATURATION_MAX, VALUE_MIN, VALUE_MAX, COLOR_DISTANCE_MAX, VISION_TYPES, VISION_TYPE_LABELS, BRETTEL_MATRICES, PATTERNS, UNIVERSALIS_API_BASE, UNIVERSALIS_API_TIMEOUT, UNIVERSALIS_API_RETRY_COUNT, UNIVERSALIS_API_RETRY_DELAY, API_CACHE_TTL, API_DEBOUNCE_DELAY, API_CACHE_VERSION, API_MAX_RESPONSE_SIZE, API_RATE_LIMIT_DELAY, } from './constants/index.js';
+export { 
+/** @public */
+RGB_MIN, 
+/** @public */
+RGB_MAX, 
+/** @public */
+HUE_MIN, 
+/** @public */
+HUE_MAX, 
+/** @public */
+SATURATION_MIN, 
+/** @public */
+SATURATION_MAX, 
+/** @public */
+VALUE_MIN, 
+/** @public */
+VALUE_MAX, 
+/** @public */
+BRETTEL_MATRICES, 
+/** @public */
+MACHADO_MATRICES, 
+/** @public */
+PATTERNS, UNIVERSALIS_API_BASE, 
+/** @public */
+UNIVERSALIS_API_TIMEOUT, 
+/** @public */
+UNIVERSALIS_API_RETRY_COUNT, 
+/** @public */
+UNIVERSALIS_API_RETRY_DELAY, 
+/** @public */
+API_CACHE_TTL, 
+/** @public */
+API_CACHE_VERSION, 
+/** @public */
+API_MAX_RESPONSE_SIZE, 
+/** @public */
+API_RATE_LIMIT_DELAY, } from './constants/index.js';
 // Utils
-export { clamp, lerp, round, distance, unique, groupBy, sortByProperty, filterNulls, isValidHexColor, isValidRGB, isValidHSV, isString, isNumber, isArray, isObject, isNullish, sleep, retry, isAbortError, generateChecksum, } from './utils/index.js';
+export { 
+/** @public */
+clamp, 
+/** @public */
+round, 
+/** @public */
+isValidHexColor, 
+/** @public */
+isValidRGB, 
+/** @public */
+isValidHSV, 
+/** @public */
+sleep, 
+/** @public */
+retry, 
+/** @public */
+isAbortError, 
+/** @public */
+generateChecksum, abbreviateDyeName, } from './utils/index.js';
 // Data (for browser environments - to be injected)
-export { default as dyeDatabase } from './data/colors_xiv.json' with { type: 'json' };
+export { default as dyeDatabase } from './data/dyes.json' with { type: 'json' };
 export { default as presetData } from './data/presets.json' with { type: 'json' };
-// Version (auto-generated from package.json during build)
-export { VERSION } from './version.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,mCAAmC,CAAC;AAC3C,4EAA4E;AAC5E,2EAA2E;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAO9D,OAAO,EACL,qBAAqB,GAEtB,MAAM,qCAAqC,CAAC;AAuB7C,gBAAgB;AAChB,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAErC,OAAO;AACL,yDAAyD;AACzD,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,gCAAgC;AAChC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AAOtC,YAAY;AACZ,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,QAAQ;AACR,OAAO,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,MAAM,EACN,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,mDAAmD;AACnD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAElF,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/services/APIService.d.ts

@@ -174,7 +174,7 @@ export interface APIServiceOptions {
      * baseUrl: 'https://universalis.app/api/v2'
      *
      * // Through CORS proxy (browser clients)
-     * baseUrl: 'https://universalis-proxy.xivdyetools.workers.dev/api/v2'
+     * baseUrl: 'https://data.xivdyetools.app/universalis'
      */
     baseUrl?: string;
 }
@@ -190,15 +190,15 @@ export interface APIServiceOptions {
  *
  * // With custom cache backend (e.g., Redis)
  * const redisCache = new RedisCacheBackend(redisClient);
- * const apiService = new APIService(redisCache);
+ * const apiService = new APIService({ cacheBackend: redisCache });
  *
  * // With custom fetch client for testing
  * const mockFetch = new MockFetchClient();
- * const apiService = new APIService(undefined, mockFetch);
+ * const apiService = new APIService({ fetchClient: mockFetch });
  *
  * // With custom rate limiter (e.g., no rate limiting for tests)
  * const noRateLimit = new NoOpRateLimiter();
- * const apiService = new APIService(undefined, undefined, noRateLimit);
+ * const apiService = new APIService({ rateLimiter: noRateLimit });
  *
  * // Fetch price data
  * const priceData = await apiService.getPriceData(itemID, worldID, dataCenterID);
@@ -209,25 +209,9 @@ export interface APIServiceOptions {
  *
  * // With custom base URL (e.g., CORS proxy for browser clients)
  * const apiService = new APIService({
- *   baseUrl: 'https://universalis-proxy.xivdyetools.workers.dev/api/v2'
+ *   baseUrl: 'https://data.xivdyetools.app/universalis'
  * });
  */
-/**
- * Cache performance metrics
- * Tracks hit/miss/eviction/error counts for observability (OPT-002)
- */
-export interface CacheMetrics {
-    /** Number of cache hits (valid cached data returned) */
-    hits: number;
-    /** Number of cache misses (no cached data found) */
-    misses: number;
-    /** Number of cache evictions (expired, version mismatch, or corrupted entries removed) */
-    evictions: number;
-    /** Number of cache backend errors */
-    errors: number;
-    /** Timestamp (ms) when metrics were last reset */
-    lastReset: number;
-}
 export declare class APIService {
     private cache;
     private fetchClient;
@@ -241,18 +225,11 @@ export declare class APIService {
     private pendingBatchRequests;
     private readonly logger;
     private readonly baseUrl;
-    /** OPT-002: Cache performance counters */
-    private metrics;
     /**
      * Constructor with optional dependency injection
-     * @param options Configuration options or legacy cache backend
+     * @param options Configuration options
      */
-    constructor(options?: ICacheBackend | APIServiceOptions, fetchClient?: FetchClient, rateLimiter?: RateLimiter);
-    /**
-     * Type guard to check if the options parameter is an APIServiceOptions object
-     * Checks for any known property of APIServiceOptions
-     */
-    private isOptionsObject;
+    constructor(options?: APIServiceOptions);
     /**
      * Get price from cache if available and not expired
      * Validates cache version and checksum
@@ -276,18 +253,6 @@ export declare class APIService {
      * Clear cache
      */
     clearCache(): Promise<void>;
-    /**
-     * Get cache stats including performance metrics (OPT-002)
-     */
-    getCacheStats(): Promise<{
-        size: number;
-        keys: string[];
-        metrics: CacheMetrics;
-    }>;
-    /**
-     * Reset cache performance metrics counters
-     */
-    resetMetrics(): void;
     /**
      * Fetch price data for a dye from Universalis API
      * Implements caching, debouncing, and retry logic
@@ -352,17 +317,6 @@ export declare class APIService {
      * This prevents crafted dataCenterID values from colliding with other key patterns
      */
     private buildCacheKey;
-    /**
-     * Fetch prices for multiple items (global/universal pricing)
-     * PERFORMANCE: Uses batched API requests to minimize rate limiting
-     *
-     * Strategy:
-     * 1. Check cache for each item
-     * 2. Collect uncached items
-     * 3. Fetch uncached items in a single batched request
-     * 4. Store fetched items in cache
-     */
-    getPricesForItems(itemIDs: number[]): Promise<Map<number, PriceData>>;
     /**
      * Fetch prices for dyes in a specific data center
      * PERFORMANCE: Uses batched API requests to minimize rate limiting
@@ -390,14 +344,6 @@ export declare class APIService {
      * Format price for display (FFXIV Gil format: 69,420G)
      */
     static formatPrice(price: number): string;
-    /**
-     * Calculate price trend (simplified)
-     */
-    static getPriceTrend(currentPrice: number, previousPrice: number): {
-        trend: 'up' | 'down' | 'stable';
-        change: number;
-        changePercent: number;
-    };
 }
 export {};
 //# sourceMappingURL=APIService.d.ts.map

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

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

package/dist/services/APIService.js

@@ -129,6 +129,40 @@ function extractPriceFromApiItem(result) {
     }
     return { price, worldId };
 }
+/**
+ * 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({ cacheBackend: redisCache });
+ *
+ * // With custom fetch client for testing
+ * const mockFetch = new MockFetchClient();
+ * const apiService = new APIService({ fetchClient: mockFetch });
+ *
+ * // With custom rate limiter (e.g., no rate limiting for tests)
+ * const noRateLimit = new NoOpRateLimiter();
+ * const apiService = new APIService({ rateLimiter: 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 });
+ *
+ * // With custom base URL (e.g., CORS proxy for browser clients)
+ * const apiService = new APIService({
+ *   baseUrl: 'https://data.xivdyetools.app/universalis'
+ * });
+ */
 export class APIService {
     cache;
     fetchClient;
@@ -142,52 +176,16 @@ export class APIService {
     pendingBatchRequests = new Map();
     logger;
     baseUrl;
-    /** OPT-002: Cache performance counters */
-    metrics = {
-        hits: 0,
-        misses: 0,
-        evictions: 0,
-        errors: 0,
-        lastReset: Date.now(),
-    };
     /**
      * Constructor with optional dependency injection
-     * @param options Configuration options or legacy cache backend
+     * @param options Configuration options
      */
-    constructor(options, fetchClient, rateLimiter) {
-        // Support both legacy positional arguments and new options object
-        // Check for any known options property to detect options-based API
-        if (options && this.isOptionsObject(options)) {
-            // New options-based API
-            const opts = options;
-            this.cache = opts.cacheBackend ?? new MemoryCacheBackend();
-            this.fetchClient = opts.fetchClient ?? new DefaultFetchClient();
-            this.rateLimiter = opts.rateLimiter ?? new DefaultRateLimiter();
-            this.logger = opts.logger ?? NoOpLogger;
-            this.baseUrl = opts.baseUrl ?? UNIVERSALIS_API_BASE;
-        }
-        else {
-            // Legacy positional arguments API
-            this.cache = options ?? new MemoryCacheBackend();
-            this.fetchClient = fetchClient ?? new DefaultFetchClient();
-            this.rateLimiter = rateLimiter ?? new DefaultRateLimiter();
-            this.logger = NoOpLogger;
-            this.baseUrl = UNIVERSALIS_API_BASE;
-        }
-    }
-    /**
-     * Type guard to check if the options parameter is an APIServiceOptions object
-     * Checks for any known property of APIServiceOptions
-     */
-    isOptionsObject(options) {
-        if (!options || typeof options !== 'object')
-            return false;
-        const obj = options;
-        return ('logger' in obj ||
-            'cacheBackend' in obj ||
-            'baseUrl' in obj ||
-            'fetchClient' in obj ||
-            'rateLimiter' in obj);
+    constructor(options = {}) {
+        this.cache = options.cacheBackend ?? new MemoryCacheBackend();
+        this.fetchClient = options.fetchClient ?? new DefaultFetchClient();
+        this.rateLimiter = options.rateLimiter ?? new DefaultRateLimiter();
+        this.logger = options.logger ?? NoOpLogger;
+        this.baseUrl = options.baseUrl ?? UNIVERSALIS_API_BASE;
     }
     // ============================================================================
     // Cache Management
@@ -207,24 +205,20 @@ export class APIService {
         catch (error) {
             // ERROR-001: Log cache backend error and fall through to API fetch
             // This distinguishes "cache broken" from "cache miss" in logs
-            this.metrics.errors++;
             this.logger.error(`Cache backend error for key ${cacheKey}: ${error instanceof Error ? error.message : 'Unknown error'}. Falling through to API fetch.`);
             return null;
         }
         if (!cached) {
-            this.metrics.misses++;
             return null;
         }
         // Check cache version
         if (cached.version && cached.version !== API_CACHE_VERSION) {
-            this.metrics.evictions++;
             // OPT-003: Fire-and-forget — cache cleanup is best-effort, don't block request path
             void this.cache.delete(cacheKey);
             return null;
         }
         // Check if cache has expired
         if (Date.now() - cached.timestamp > cached.ttl) {
-            this.metrics.evictions++;
             // OPT-003: Fire-and-forget — cache cleanup is best-effort, don't block request path
             void this.cache.delete(cacheKey);
             return null;
@@ -233,14 +227,12 @@ export class APIService {
         if (cached.checksum) {
             const computedChecksum = generateChecksum(cached.data);
             if (computedChecksum !== cached.checksum) {
-                this.metrics.evictions++;
                 this.logger.warn(`Cache corruption detected for key: ${cacheKey}`);
                 // OPT-003: Fire-and-forget — cache cleanup is best-effort, don't block request path
                 void this.cache.delete(cacheKey);
                 return null;
             }
         }
-        this.metrics.hits++;
         return cached.data;
     }
     /**
@@ -267,7 +259,6 @@ export class APIService {
             await this.setCachedPrice(cacheKey, data);
         }
         catch (error) {
-            this.metrics.errors++;
             this.logger.error(`Cache write failed for ${cacheKey}: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
@@ -276,28 +267,8 @@ export class APIService {
      */
     async clearCache() {
         await this.cache.clear();
-        this.resetMetrics();
         this.logger.info('Price cache cleared');
     }
-    /**
-     * Get cache stats including performance metrics (OPT-002)
-     */
-    async getCacheStats() {
-        const keys = await this.cache.keys();
-        return { size: keys.length, keys, metrics: { ...this.metrics } };
-    }
-    /**
-     * Reset cache performance metrics counters
-     */
-    resetMetrics() {
-        this.metrics = {
-            hits: 0,
-            misses: 0,
-            evictions: 0,
-            errors: 0,
-            lastReset: Date.now(),
-        };
-    }
     // ============================================================================
     // API Calls
     // ============================================================================
@@ -374,8 +345,7 @@ export class APIService {
         // 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, this.logger, isRetryableHttpError // OPT-014: 4xx (except 429) fails fast
-            );
+            const data = await retry(() => this.fetchWithTimeout(url, UNIVERSALIS_API_TIMEOUT), UNIVERSALIS_API_RETRY_COUNT, UNIVERSALIS_API_RETRY_DELAY, this.logger, isRetryableHttpError);
             if (!data) {
                 return null;
             }
@@ -433,8 +403,7 @@ export class APIService {
         // Build batch API URL — safe: length ≤ 100 and IDs validated above
         const url = this.buildBatchApiUrl(validItemIDs, dataCenterID);
         try {
-            const data = await retry(() => this.fetchWithTimeout(url, UNIVERSALIS_API_TIMEOUT), UNIVERSALIS_API_RETRY_COUNT, UNIVERSALIS_API_RETRY_DELAY, this.logger, isRetryableHttpError // OPT-014: 4xx (except 429) fails fast
-            );
+            const data = await retry(() => this.fetchWithTimeout(url, UNIVERSALIS_API_TIMEOUT), UNIVERSALIS_API_RETRY_COUNT, UNIVERSALIS_API_RETRY_DELAY, this.logger, isRetryableHttpError);
             if (!data) {
                 return new Map();
             }
@@ -652,68 +621,6 @@ export class APIService {
     // ============================================================================
     // Batch Operations
     // ============================================================================
-    /**
-     * Fetch prices for multiple items (global/universal pricing)
-     * PERFORMANCE: Uses batched API requests to minimize rate limiting
-     *
-     * Strategy:
-     * 1. Check cache for each item
-     * 2. Collect uncached items
-     * 3. Fetch uncached items in a single batched request
-     * 4. Store fetched items in cache
-     */
-    async getPricesForItems(itemIDs) {
-        const results = new Map();
-        const uncachedItemIDs = [];
-        // Step 1: Check cache for each item (in parallel for async backends)
-        const cacheChecks = await Promise.all(itemIDs.map(async (itemID) => {
-            const cacheKey = this.buildCacheKey(itemID);
-            const cached = await this.getCachedPrice(cacheKey);
-            return { itemID, cached };
-        }));
-        for (const { itemID, cached } of cacheChecks) {
-            if (cached) {
-                results.set(itemID, cached);
-            }
-            else {
-                uncachedItemIDs.push(itemID);
-            }
-        }
-        // Step 2: If all items are cached, return immediately
-        if (uncachedItemIDs.length === 0) {
-            this.logger.debug(`All ${itemIDs.length} items found in cache`);
-            return results;
-        }
-        this.logger.debug(`Fetching ${uncachedItemIDs.length} uncached items (${results.size} cached)`);
-        // Step 3+4: Fetch uncached items and write them to cache.
-        // OPT-001 (2026-07-18 audit): identical in-flight batches are coalesced so
-        // N concurrent cold-cache callers produce one upstream request, mirroring
-        // the single-item pendingRequests dedupe. The entry is removed on settle.
-        // BUG-011: cache writes are best-effort — one failed write must not throw
-        // away the whole fetched batch.
-        const batchKey = [...uncachedItemIDs].sort((a, b) => a - b).join(',') + ':universal';
-        let batchPromise = this.pendingBatchRequests.get(batchKey);
-        if (!batchPromise) {
-            batchPromise = (async () => {
-                const batchResults = await this.fetchBatchPriceData(uncachedItemIDs);
-                const cacheWrites = [];
-                for (const [itemID, priceData] of batchResults) {
-                    const cacheKey = this.buildCacheKey(itemID);
-                    cacheWrites.push(this.trySetCachedPrice(cacheKey, priceData));
-                }
-                await Promise.all(cacheWrites);
-                return batchResults;
-            })().finally(() => {
-                this.pendingBatchRequests.delete(batchKey);
-            });
-            this.pendingBatchRequests.set(batchKey, batchPromise);
-        }
-        const batchResults = await batchPromise;
-        for (const [itemID, priceData] of batchResults) {
-            results.set(itemID, priceData);
-        }
-        return results;
-    }
     /**
      * Fetch prices for dyes in a specific data center
      * PERFORMANCE: Uses batched API requests to minimize rate limiting
@@ -820,23 +727,5 @@ export class APIService {
         // 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