dexbot 1.1.10

package/dist/modules/order/logger_state.d.ts

@@ -0,0 +1,133 @@
+/**
+ * modules/order/logger_state.ts - Logger State Manager
+ *
+ * State tracking engine for change detection and audit logging.
+ * Exports a single LoggerState class that enables smart logging by detecting state changes.
+ *
+ * Purpose:
+ * - Track previous state across multiple categories (funds, orders, fills, boundary, errors)
+ * - Detect and report what changed between state transitions
+ * - Determine if logging is needed (only log when values change)
+ * - Maintain audit history of state changes
+ * - Calculate significance of numeric changes against thresholds
+ *
+ * Used by Logger to:
+ * - Skip redundant logging when nothing changed
+ * - Only output on significant state transitions
+ * - Maintain audit trail for debugging
+ *
+ * ===============================================================================
+ * TABLE OF CONTENTS - LoggerState Class (7 methods)
+ * ===============================================================================
+ *
+ * INITIALIZATION (1 method)
+ *   1. constructor() - Create new LoggerState with empty previousState and changeHistory
+ *      Initializes tracking for: funds, orders, fills, boundary, errors
+ *
+ * CHANGE DETECTION (2 methods)
+ *   2. detectChanges(category, current) - Detect changes between previous and current state
+ *      Returns { isNew: boolean, changes: Object } with detailed change information
+ *   3. isSignificantChange(oldVal, newVal, threshold) - Check if numeric change exceeds threshold
+ *      Returns true if change is significant or values are non-finite
+ *
+ * HISTORY MANAGEMENT (3 methods)
+ *   4. recordChange(timestamp, category, type, data) - Record change for audit trail
+ *      Maintains circular buffer (max 100 entries) of all state changes
+ *   5. getRecentChanges(category, count) - Get recent changes for a category
+ *      Returns last N changes for specified category (default: 10)
+ *   6. reset(category) - Clear state for category (reset previous state)
+ *
+ * INTERNAL UTILITIES (1 method)
+ *   7. _deepDiff(prev, current) - Deep diff between two objects
+ *      Recursively compares objects, detects all changes and deletions
+ *      Returns Object with format: { key: { from: oldVal, to: newVal } }
+ *
+ * ===============================================================================
+ *
+ * STATE CATEGORIES:
+ * - funds: Available, committed, total, cache, and fee tracking
+ * - orders: Order counts, states, and type distributions
+ * - fills: Fill operations and trade history
+ * - boundary: Grid boundary positions and movements
+ * - errors: Error conditions and recovery attempts
+ *
+ * CHANGE DETECTION ALGORITHM:
+ * 1. First call: Returns { isNew: true, changes: current } and stores state
+ * 2. Subsequent calls: Compares with stored state using _deepDiff
+ * 3. _deepDiff: Recursively compares all keys, detects additions/deletions
+ * 4. Returns: { isNew: false, changes: { key: { from, to } } }
+ *
+ * CHANGE HISTORY:
+ * - Stores up to 100 recent changes (FIFO circular buffer)
+ * - Each entry: { timestamp, category, type, data }
+ * - Enables audit trails and debugging of state transitions
+ *
+ * ===============================================================================
+ *
+ * @class
+ */
+declare class LoggerState {
+    previousState: Record<string, any>;
+    changeHistory: Array<{
+        timestamp: number;
+        category: string;
+        type: string;
+        data: any;
+    }>;
+    maxHistory: number;
+    constructor();
+    /**
+     * Detect what changed between previous and current state
+     * @param {string} category - Category name (funds, orders, fills, etc.)
+     * @param {Object} current - Current state object
+     * @returns {Object} { isNew: boolean, changes: Object }
+     */
+    detectChanges(category: any, current: any): {
+        isNew: boolean;
+        changes: any;
+    };
+    /**
+     * Check if change exceeds significance threshold
+     * @param {number} oldVal - Previous value
+     * @param {number} newVal - Current value
+     * @param {number} threshold - Threshold for significance
+     * @returns {boolean} True if change is significant
+     */
+    isSignificantChange(oldVal: any, newVal: any, threshold?: number): boolean;
+    /**
+     * Record change for history (auditing)
+     * @param {number} timestamp - Unix timestamp
+     * @param {string} category - Log category
+     * @param {string} type - Event type
+     * @param {Object} data - Change data
+     */
+    recordChange(timestamp: any, category: any, type: any, data: any): void;
+    /**
+     * Get recent changes for a category
+     * @param {string} category - Category to query
+     * @param {number} count - Number of recent changes to return
+     * @returns {Array} Recent changes
+     */
+    getRecentChanges(category: any, count?: number): {
+        timestamp: number;
+        category: string;
+        type: string;
+        data: any;
+    }[];
+    /**
+     * Clear state for a category (reset previous state)
+     * @param {string} category - Category to reset
+     */
+    reset(category: any): void;
+    /**
+     * Deep diff between two objects
+     * Detects all changes recursively
+     * @param {Object} prev - Previous state
+     * @param {Object} current - Current state
+     * @returns {Object} Object with keys that changed
+     * @private
+     */
+    _deepDiff(prev: any, current: any): {};
+}
+export = LoggerState;
+//# sourceMappingURL=logger_state.d.ts.map

package/dist/modules/order/logger_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger_state.d.ts","sourceRoot":"","sources":["../../../modules/order/logger_state.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,cAAM,WAAW;IACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,aAAa,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACvF,UAAU,EAAE,MAAM,CAAC;;IAcnB;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,KAAA,EAAE,OAAO,KAAA;;;;IAY/B;;;;;;OAMG;IACH,mBAAmB,CAAC,MAAM,KAAA,EAAE,MAAM,KAAA,EAAE,SAAS,SAAI;IAKjD;;;;;;OAMG;IACH,YAAY,CAAC,SAAS,KAAA,EAAE,QAAQ,KAAA,EAAE,IAAI,KAAA,EAAE,IAAI,KAAA;IAO5C;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,KAAA,EAAE,KAAK,SAAK;mBAjEH,MAAM;kBAAY,MAAM;cAAQ,MAAM;cAAQ,GAAG;;IAuEnF;;;OAGG;IACH,KAAK,CAAC,QAAQ,KAAA;IAId;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA;CAmB1B;AAED,SAAS,WAAW,CAAC"}

package/dist/modules/order/logger_state.js

@@ -0,0 +1,170 @@
+'use strict';
+/**
+ * modules/order/logger_state.ts - Logger State Manager
+ *
+ * State tracking engine for change detection and audit logging.
+ * Exports a single LoggerState class that enables smart logging by detecting state changes.
+ *
+ * Purpose:
+ * - Track previous state across multiple categories (funds, orders, fills, boundary, errors)
+ * - Detect and report what changed between state transitions
+ * - Determine if logging is needed (only log when values change)
+ * - Maintain audit history of state changes
+ * - Calculate significance of numeric changes against thresholds
+ *
+ * Used by Logger to:
+ * - Skip redundant logging when nothing changed
+ * - Only output on significant state transitions
+ * - Maintain audit trail for debugging
+ *
+ * ===============================================================================
+ * TABLE OF CONTENTS - LoggerState Class (7 methods)
+ * ===============================================================================
+ *
+ * INITIALIZATION (1 method)
+ *   1. constructor() - Create new LoggerState with empty previousState and changeHistory
+ *      Initializes tracking for: funds, orders, fills, boundary, errors
+ *
+ * CHANGE DETECTION (2 methods)
+ *   2. detectChanges(category, current) - Detect changes between previous and current state
+ *      Returns { isNew: boolean, changes: Object } with detailed change information
+ *   3. isSignificantChange(oldVal, newVal, threshold) - Check if numeric change exceeds threshold
+ *      Returns true if change is significant or values are non-finite
+ *
+ * HISTORY MANAGEMENT (3 methods)
+ *   4. recordChange(timestamp, category, type, data) - Record change for audit trail
+ *      Maintains circular buffer (max 100 entries) of all state changes
+ *   5. getRecentChanges(category, count) - Get recent changes for a category
+ *      Returns last N changes for specified category (default: 10)
+ *   6. reset(category) - Clear state for category (reset previous state)
+ *
+ * INTERNAL UTILITIES (1 method)
+ *   7. _deepDiff(prev, current) - Deep diff between two objects
+ *      Recursively compares objects, detects all changes and deletions
+ *      Returns Object with format: { key: { from: oldVal, to: newVal } }
+ *
+ * ===============================================================================
+ *
+ * STATE CATEGORIES:
+ * - funds: Available, committed, total, cache, and fee tracking
+ * - orders: Order counts, states, and type distributions
+ * - fills: Fill operations and trade history
+ * - boundary: Grid boundary positions and movements
+ * - errors: Error conditions and recovery attempts
+ *
+ * CHANGE DETECTION ALGORITHM:
+ * 1. First call: Returns { isNew: true, changes: current } and stores state
+ * 2. Subsequent calls: Compares with stored state using _deepDiff
+ * 3. _deepDiff: Recursively compares all keys, detects additions/deletions
+ * 4. Returns: { isNew: false, changes: { key: { from, to } } }
+ *
+ * CHANGE HISTORY:
+ * - Stores up to 100 recent changes (FIFO circular buffer)
+ * - Each entry: { timestamp, category, type, data }
+ * - Enables audit trails and debugging of state transitions
+ *
+ * ===============================================================================
+ *
+ * @class
+ */
+class LoggerState {
+    previousState;
+    changeHistory;
+    maxHistory;
+    constructor() {
+        this.previousState = {
+            funds: null,
+            orders: null,
+            fills: null,
+            boundary: null,
+            errors: null
+        };
+        this.changeHistory = [];
+        this.maxHistory = 100;
+    }
+    /**
+     * Detect what changed between previous and current state
+     * @param {string} category - Category name (funds, orders, fills, etc.)
+     * @param {Object} current - Current state object
+     * @returns {Object} { isNew: boolean, changes: Object }
+     */
+    detectChanges(category, current) {
+        const prev = this.previousState[category];
+        if (!prev) {
+            this.previousState[category] = { ...current };
+            return { isNew: true, changes: current };
+        }
+        const changes = this._deepDiff(prev, current);
+        this.previousState[category] = { ...current };
+        return { isNew: false, changes };
+    }
+    /**
+     * Check if change exceeds significance threshold
+     * @param {number} oldVal - Previous value
+     * @param {number} newVal - Current value
+     * @param {number} threshold - Threshold for significance
+     * @returns {boolean} True if change is significant
+     */
+    isSignificantChange(oldVal, newVal, threshold = 0) {
+        if (!Number.isFinite(oldVal) || !Number.isFinite(newVal))
+            return true;
+        return Math.abs(oldVal - newVal) > threshold;
+    }
+    /**
+     * Record change for history (auditing)
+     * @param {number} timestamp - Unix timestamp
+     * @param {string} category - Log category
+     * @param {string} type - Event type
+     * @param {Object} data - Change data
+     */
+    recordChange(timestamp, category, type, data) {
+        this.changeHistory.push({ timestamp, category, type, data });
+        if (this.changeHistory.length > this.maxHistory) {
+            this.changeHistory.shift();
+        }
+    }
+    /**
+     * Get recent changes for a category
+     * @param {string} category - Category to query
+     * @param {number} count - Number of recent changes to return
+     * @returns {Array} Recent changes
+     */
+    getRecentChanges(category, count = 10) {
+        return this.changeHistory
+            .filter(c => c.category === category)
+            .slice(-count);
+    }
+    /**
+     * Clear state for a category (reset previous state)
+     * @param {string} category - Category to reset
+     */
+    reset(category) {
+        this.previousState[category] = null;
+    }
+    /**
+     * Deep diff between two objects
+     * Detects all changes recursively
+     * @param {Object} prev - Previous state
+     * @param {Object} current - Current state
+     * @returns {Object} Object with keys that changed
+     * @private
+     */
+    _deepDiff(prev, current) {
+        const diff = {};
+        // Check all keys in current
+        for (const key in current) {
+            if (JSON.stringify(prev[key]) !== JSON.stringify(current[key])) {
+                diff[key] = { from: prev[key], to: current[key] };
+            }
+        }
+        // Check for deleted keys
+        for (const key in prev) {
+            if (!(key in current)) {
+                diff[key] = { from: prev[key], to: undefined };
+            }
+        }
+        return diff;
+    }
+}
+module.exports = LoggerState;
+//# sourceMappingURL=logger_state.js.map

package/dist/modules/order/logger_state.js.map

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