@3rd-eye-labs/openmm 0.1.5 → 0.1.7

package/dist/core/price-aggregation/price-cache.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Price Cache
+ * Manages price caching with 1-minute TTL and fallback strategies
+ */
+export declare class PriceCache {
+    private cache;
+    private fallbackCache;
+    /**
+     * Cache price with TTL (1 minute as requested)
+     */
+    cachePrice(symbol: string, price: number, ttl?: number): void;
+    /**
+     * Get cached price if still valid
+     */
+    getCachedPrice(symbol: string): number | null;
+    /**
+     * Get fallback price (last known good price, even if stale)
+     * Used when Iris API fails
+     */
+    getFallbackPrice(symbol: string): number | null;
+    /**
+     * Check if cached price object is valid
+     */
+    private isCacheValid;
+    /**
+     * Get cache statistics for monitoring
+     */
+    getCacheStats(): {
+        activeEntries: number;
+        fallbackEntries: number;
+        hitRate: number;
+        oldestEntry: Date | null;
+    };
+    /**
+     * Get age of cached price in seconds
+     */
+    getCacheAge(symbol: string): number | null;
+    /**
+     * Clear all caches
+     */
+    clearCache(): void;
+    /**
+     * Clear expired entries from cache
+     */
+    private cleanupCache;
+    /**
+     * Get oldest cache entry timestamp
+     */
+    private getOldestCacheEntry;
+    /**
+     * Get key of oldest cache entry
+     */
+    private getOldestCacheKey;
+}
+//# sourceMappingURL=price-cache.d.ts.map

package/dist/core/price-aggregation/price-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-cache.d.ts","sourceRoot":"","sources":["../../../src/core/price-aggregation/price-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,aAAa,CAAuC;IAE5D;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAiC,GAAG,IAAI;IAkBvF;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAa7C;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAa/C;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,aAAa,IAAI;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;KAC1B;IAoBD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO1C;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAyBpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAa1B"}

package/dist/core/price-aggregation/price-cache.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Price Cache
+ * Manages price caching with 1-minute TTL and fallback strategies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriceCache = void 0;
+const price_aggregation_1 = require("../../config/price-aggregation");
+class PriceCache {
+    constructor() {
+        this.cache = new Map();
+        this.fallbackCache = new Map();
+    }
+    /**
+     * Cache price with TTL (1 minute as requested)
+     */
+    cachePrice(symbol, price, ttl = price_aggregation_1.CACHE_CONFIG.DEFAULT_TTL) {
+        const cached = {
+            price,
+            timestamp: new Date(),
+            ttl
+        };
+        this.cache.set(symbol, cached);
+        // Also store in fallback cache (longer retention)
+        this.fallbackCache.set(symbol, {
+            ...cached,
+            ttl: price_aggregation_1.CACHE_CONFIG.STALE_THRESHOLD
+        });
+        this.cleanupCache();
+    }
+    /**
+     * Get cached price if still valid
+     */
+    getCachedPrice(symbol) {
+        const cached = this.cache.get(symbol);
+        if (!cached)
+            return null;
+        if (this.isCacheValid(cached)) {
+            return cached.price;
+        }
+        // Remove expired cache entry
+        this.cache.delete(symbol);
+        return null;
+    }
+    /**
+     * Get fallback price (last known good price, even if stale)
+     * Used when Iris API fails
+     */
+    getFallbackPrice(symbol) {
+        const cached = this.fallbackCache.get(symbol);
+        if (!cached)
+            return null;
+        const age = Date.now() - cached.timestamp.getTime();
+        if (age > price_aggregation_1.CACHE_CONFIG.STALE_THRESHOLD) {
+            this.fallbackCache.delete(symbol);
+            return null;
+        }
+        return cached.price;
+    }
+    /**
+     * Check if cached price object is valid
+     */
+    isCacheValid(cached) {
+        const age = Date.now() - cached.timestamp.getTime();
+        return age < cached.ttl;
+    }
+    /**
+     * Get cache statistics for monitoring
+     */
+    getCacheStats() {
+        const activeEntries = Array.from(this.cache.values()).filter(cached => this.isCacheValid(cached)).length;
+        const fallbackEntries = this.fallbackCache.size;
+        // Simple hit rate calculation (would need proper tracking in production)
+        const hitRate = this.cache.size > 0 ? activeEntries / this.cache.size : 0;
+        const oldestEntry = this.getOldestCacheEntry();
+        return {
+            activeEntries,
+            fallbackEntries,
+            hitRate,
+            oldestEntry
+        };
+    }
+    /**
+     * Get age of cached price in seconds
+     */
+    getCacheAge(symbol) {
+        const cached = this.cache.get(symbol);
+        if (!cached)
+            return null;
+        return (Date.now() - cached.timestamp.getTime()) / 1000;
+    }
+    /**
+     * Clear all caches
+     */
+    clearCache() {
+        this.cache.clear();
+        this.fallbackCache.clear();
+    }
+    /**
+     * Clear expired entries from cache
+     */
+    cleanupCache() {
+        // Cleanup main cache
+        for (const [symbol, cached] of this.cache.entries()) {
+            if (!this.isCacheValid(cached)) {
+                this.cache.delete(symbol);
+            }
+        }
+        // Cleanup fallback cache
+        for (const [symbol, cached] of this.fallbackCache.entries()) {
+            const age = Date.now() - cached.timestamp.getTime();
+            if (age > price_aggregation_1.CACHE_CONFIG.STALE_THRESHOLD) {
+                this.fallbackCache.delete(symbol);
+            }
+        }
+        // Size-based cleanup if cache is too large
+        if (this.cache.size > price_aggregation_1.CACHE_CONFIG.MAX_CACHE_SIZE) {
+            const oldestKey = this.getOldestCacheKey();
+            if (oldestKey) {
+                this.cache.delete(oldestKey);
+            }
+        }
+    }
+    /**
+     * Get oldest cache entry timestamp
+     */
+    getOldestCacheEntry() {
+        let oldest = null;
+        for (const cached of this.cache.values()) {
+            if (!oldest || cached.timestamp < oldest) {
+                oldest = cached.timestamp;
+            }
+        }
+        return oldest;
+    }
+    /**
+     * Get key of oldest cache entry
+     */
+    getOldestCacheKey() {
+        let oldestKey = null;
+        let oldestTime = Date.now();
+        for (const [key, cached] of this.cache.entries()) {
+            if (cached.timestamp.getTime() < oldestTime) {
+                oldestTime = cached.timestamp.getTime();
+                oldestKey = key;
+            }
+        }
+        return oldestKey;
+    }
+}
+exports.PriceCache = PriceCache;
+//# sourceMappingURL=price-cache.js.map

package/dist/core/price-aggregation/price-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-cache.js","sourceRoot":"","sources":["../../../src/core/price-aggregation/price-cache.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,sEAA8D;AAE9D,MAAa,UAAU;IAAvB;QACU,UAAK,GAA6B,IAAI,GAAG,EAAE,CAAC;QAC5C,kBAAa,GAA6B,IAAI,GAAG,EAAE,CAAC;IAyK9D,CAAC;IAvKC;;OAEG;IACH,UAAU,CAAC,MAAc,EAAE,KAAa,EAAE,MAAc,gCAAY,CAAC,WAAW;QAC9E,MAAM,MAAM,GAAgB;YAC1B,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG;SACJ,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE/B,kDAAkD;QAClD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE;YAC7B,GAAG,MAAM;YACT,GAAG,EAAE,gCAAY,CAAC,eAAe;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,MAAc;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACpD,IAAI,GAAG,GAAG,gCAAY,CAAC,eAAe,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,MAAmB;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QAMX,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CACpE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAC1B,CAAC,MAAM,CAAC;QAET,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;QAEhD,yEAAyE;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1E,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAE/C,OAAO;YACL,aAAa;YACb,eAAe;YACf,OAAO;YACP,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAc;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,YAAY;QAClB,qBAAqB;QACrB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACpD,IAAI,GAAG,GAAG,gCAAY,CAAC,eAAe,EAAE,CAAC;gBACvC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,gCAAY,CAAC,cAAc,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3C,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,IAAI,MAAM,GAAgB,IAAI,CAAC;QAE/B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;gBACzC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,iBAAiB;QACvB,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,IAAI,UAAU,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAEpC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;gBAC5C,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACxC,SAAS,GAAG,GAAG,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AA3KD,gCA2KC"}

package/dist/examples/mexc-connector-comprehensive-test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MEXC Connector Comprehensive Test Suite
+ *
+ * Tests every method in MexcConnector to ensure they work as intended.
+ * This single test file validates the complete base SDK architecture implementation.
+ *
+ * Coverage:
+ * - Connection Management
+ * - REST API Methods (Balance, Orders, Market Data)
+ * - WebSocket Methods (Real-time Market Data with Direct Protobuf Processing)
+ * - User Data Stream Methods (Real-time Account Updates)
+ * - Error Handling and Edge Cases
+ */
+import 'dotenv/config';
+//# sourceMappingURL=mexc-connector-comprehensive-test.d.ts.map

package/dist/examples/mexc-connector-comprehensive-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mexc-connector-comprehensive-test.d.ts","sourceRoot":"","sources":["../../src/examples/mexc-connector-comprehensive-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,eAAe,CAAC"}