backtest-kit 2.0.4 → 2.0.6

package/build/index.cjs

@@ -8,6 +8,7 @@ var path = require('path');
 var crypto = require('crypto');
 var os = require('os');
 var fs$1 = require('fs');
+var util = require('util');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -9918,6 +9919,83 @@ const VALID_METHOD_NAMES = [
     "riskRejection",
     "dispose",
 ];
+/**
+ * Calculates the Levenshtein distance between two strings.
+ *
+ * Levenshtein distance is the minimum number of single-character edits
+ * (insertions, deletions, or substitutions) required to change one string into another.
+ * Used to find typos and similar method names in validation.
+ *
+ * @param str1 - First string to compare
+ * @param str2 - Second string to compare
+ * @returns Number of edits needed to transform str1 into str2
+ */
+const LEVENSHTEIN_DISTANCE = (str1, str2) => {
+    const len1 = str1.length;
+    const len2 = str2.length;
+    // Create a 2D array for dynamic programming
+    const matrix = Array.from({ length: len1 + 1 }, () => Array(len2 + 1).fill(0));
+    // Initialize first column and row
+    for (let i = 0; i <= len1; i++) {
+        matrix[i][0] = i;
+    }
+    for (let j = 0; j <= len2; j++) {
+        matrix[0][j] = j;
+    }
+    // Fill the matrix
+    for (let i = 1; i <= len1; i++) {
+        for (let j = 1; j <= len2; j++) {
+            const cost = str1[i - 1] === str2[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
+            matrix[i][j - 1] + 1, // insertion
+            matrix[i - 1][j - 1] + cost // substitution
+            );
+        }
+    }
+    return matrix[len1][len2];
+};
+/**
+ * Finds suggestions for a method name based on similarity scoring.
+ *
+ * Uses Levenshtein distance and partial string matching to find similar method names.
+ * Returns suggestions sorted by similarity (most similar first).
+ * Used to provide helpful "Did you mean?" suggestions in validation error messages.
+ *
+ * @param methodName - The invalid method name to find suggestions for
+ * @param validNames - List of valid method names to search through
+ * @param maxDistance - Maximum Levenshtein distance to consider (default: 3)
+ * @returns Array of suggested method names sorted by similarity
+ */
+const FIND_SUGGESTIONS = (methodName, validNames, maxDistance = 3) => {
+    const lowerMethodName = methodName.toLowerCase();
+    // Calculate similarity score for each valid name
+    const suggestions = validNames
+        .map((validName) => {
+        const lowerValidName = validName.toLowerCase();
+        const distance = LEVENSHTEIN_DISTANCE(lowerMethodName, lowerValidName);
+        // Check for partial matches
+        const hasPartialMatch = lowerValidName.includes(lowerMethodName) ||
+            lowerMethodName.includes(lowerValidName);
+        return {
+            name: validName,
+            distance,
+            hasPartialMatch,
+        };
+    })
+        .filter((item) => item.distance <= maxDistance || item.hasPartialMatch)
+        .sort((a, b) => {
+        // Prioritize partial matches
+        if (a.hasPartialMatch && !b.hasPartialMatch)
+            return -1;
+        if (!a.hasPartialMatch && b.hasPartialMatch)
+            return 1;
+        // Then sort by distance
+        return a.distance - b.distance;
+    })
+        .slice(0, 3) // Limit to top 3 suggestions
+        .map((item) => item.name);
+    return suggestions;
+};
 /**
  * Validates that all public methods in a class-based action handler are in the allowed list.
  *
@@ -9944,7 +10022,18 @@ const VALIDATE_CLASS_METHODS = (actionName, handler, self) => {
         const descriptor = Object.getOwnPropertyDescriptor(handler.prototype, methodName);
         const isMethod = descriptor && typeof descriptor.value === "function";
         if (isMethod && !VALID_METHOD_NAMES.includes(methodName)) {
-            const msg = functoolsKit.str.newline(`ActionSchema ${actionName} contains invalid method "${methodName}". `, `Valid methods are: ${VALID_METHOD_NAMES.join(", ")}`, `If you want to keep this property name use one of these patterns: _${methodName} or #${methodName}`);
+            const suggestions = FIND_SUGGESTIONS(methodName, VALID_METHOD_NAMES);
+            const lines = [
+                `ActionSchema ${actionName} contains invalid method "${methodName}". `,
+                `Valid methods are: ${VALID_METHOD_NAMES.join(", ")}`,
+            ];
+            if (suggestions.length > 0) {
+                lines.push(functoolsKit.typo.nbsp);
+                lines.push(`Do you mean: ${suggestions.join(", ")}?`);
+                lines.push(functoolsKit.typo.nbsp);
+            }
+            lines.push(`If you want to keep this property name use one of these patterns: _${methodName} or #${methodName}`);
+            const msg = functoolsKit.str.newline(lines);
             self.loggerService.log(`actionValidationService exception thrown`, {
                 msg,
             });
@@ -9973,7 +10062,18 @@ const VALIDATE_OBJECT_METHODS = (actionName, handler, self) => {
         }
         if (typeof handler[methodName] === "function" &&
             !VALID_METHOD_NAMES.includes(methodName)) {
-            const msg = functoolsKit.str.newline(`ActionSchema ${actionName} contains invalid method "${methodName}". `, `Valid methods are: ${VALID_METHOD_NAMES.join(", ")}`, `If you want to keep this property name use one of these patterns: _${methodName} or #${methodName}`);
+            const suggestions = FIND_SUGGESTIONS(methodName, VALID_METHOD_NAMES);
+            const lines = [
+                `ActionSchema ${actionName} contains invalid method "${methodName}". `,
+                `Valid methods are: ${VALID_METHOD_NAMES.join(", ")}`,
+            ];
+            if (suggestions.length > 0) {
+                lines.push(functoolsKit.typo.nbsp);
+                lines.push(`Do you mean: ${suggestions.join(", ")}?`);
+                lines.push(functoolsKit.typo.nbsp);
+            }
+            lines.push(`If you want to keep this property name use one of these patterns: _${methodName} or #${methodName}`);
+            const msg = functoolsKit.str.newline(lines);
             self.loggerService.log(`actionValidationService exception thrown`, {
                 msg,
             });
@@ -31679,6 +31779,91 @@ const roundTicks = (price, tickSize) => {
     return price.toFixed(precision);
 };
 
+/**
+ * Parses command-line arguments for trading bot configuration.
+ *
+ * Processes process.argv to extract trading parameters and mode flags.
+ * Merges provided default values with command-line arguments.
+ * Supports both backtest mode (historical simulation), paper trading mode
+ * (simulated trading with live data), and live trading mode (real trading).
+ *
+ * Command-line options:
+ * - --symbol: Trading pair symbol (e.g., "BTCUSDT")
+ * - --strategy: Strategy name to use
+ * - --exchange: Exchange name (e.g., "binance")
+ * - --frame: Timeframe for candles (e.g., "1h", "15m")
+ * - --backtest: Enable backtest mode (boolean flag)
+ * - --paper: Enable paper trading mode (boolean flag)
+ * - --live: Enable live trading mode (boolean flag)
+ *
+ * @param params - Optional default values for parameters
+ * @param params.symbol - Default trading pair symbol
+ * @param params.strategyName - Default strategy name
+ * @param params.exchangeName - Default exchange name
+ * @param params.frameName - Default timeframe
+ * @returns Parsed configuration with all parameters and mode flags
+ *
+ * @example
+ * ```typescript
+ * // Parse args with defaults
+ * const config = parseArgs({
+ *   symbol: "BTCUSDT",
+ *   strategyName: "rsi_divergence",
+ *   exchangeName: "binance",
+ *   frameName: "1h"
+ * });
+ *
+ * // Command: node app.js --backtest
+ * // Result: { symbol: "BTCUSDT", ..., backtest: true, paper: false, live: false }
+ * ```
+ */
+const parseArgs = ({ symbol, strategyName, exchangeName, frameName, } = {}) => {
+    const { values } = util.parseArgs({
+        args: process.argv,
+        options: {
+            symbol: {
+                type: "string",
+                default: symbol,
+            },
+            strategy: {
+                type: "string",
+                default: strategyName,
+            },
+            exchange: {
+                type: "string",
+                default: exchangeName,
+            },
+            frame: {
+                type: "string",
+                default: frameName,
+            },
+            backtest: {
+                type: "boolean",
+                default: false,
+            },
+            paper: {
+                type: "boolean",
+                default: false,
+            },
+            live: {
+                type: "boolean",
+                default: false,
+            },
+        },
+        strict: false,
+        allowPositionals: true,
+    });
+    return {
+        symbol: String(values.symbol),
+        strategyName: String(values.strategy),
+        exchangeName: String(values.exchange),
+        frameName: String(values.frame),
+        backtest: Boolean(values.backtest),
+        paper: Boolean(values.paper),
+        live: Boolean(values.live),
+    };
+};
+
 /**
  * Updates the value of a nested object property using a specific path.
  *
@@ -31821,6 +32006,7 @@ exports.overrideRiskSchema = overrideRiskSchema;
 exports.overrideSizingSchema = overrideSizingSchema;
 exports.overrideStrategySchema = overrideStrategySchema;
 exports.overrideWalkerSchema = overrideWalkerSchema;
+exports.parseArgs = parseArgs;
 exports.roundTicks = roundTicks;
 exports.set = set;
 exports.setColumns = setColumns;

package/build/index.mjs

@@ -1,12 +1,13 @@
 import { createActivator } from 'di-kit';
 import { scoped } from 'di-scoped';
-import { Subject, trycatch, errorData, getErrorMessage, sleep, memoize, makeExtendable, singleshot, not, retry, randomString, str, isObject, ToolRegistry, and, resolveDocuments, timeout, TIMEOUT_SYMBOL as TIMEOUT_SYMBOL$1, compose, iterateDocuments, distinctDocuments, queued, singlerun } from 'functools-kit';
+import { Subject, trycatch, errorData, getErrorMessage, sleep, memoize, makeExtendable, singleshot, not, retry, randomString, str, isObject, ToolRegistry, typo, and, resolveDocuments, timeout, TIMEOUT_SYMBOL as TIMEOUT_SYMBOL$1, compose, iterateDocuments, distinctDocuments, queued, singlerun } from 'functools-kit';
 import * as fs from 'fs/promises';
 import fs__default, { mkdir, writeFile } from 'fs/promises';
 import path, { join, dirname } from 'path';
 import crypto from 'crypto';
 import os from 'os';
 import { createWriteStream } from 'fs';
+import { parseArgs as parseArgs$1 } from 'util';
 
 const { init, inject, provide } = createActivator("backtest");
 
@@ -9898,6 +9899,83 @@ const VALID_METHOD_NAMES = [
     "riskRejection",
     "dispose",
 ];
+/**
+ * Calculates the Levenshtein distance between two strings.
+ *
+ * Levenshtein distance is the minimum number of single-character edits
+ * (insertions, deletions, or substitutions) required to change one string into another.
+ * Used to find typos and similar method names in validation.
+ *
+ * @param str1 - First string to compare
+ * @param str2 - Second string to compare
+ * @returns Number of edits needed to transform str1 into str2
+ */
+const LEVENSHTEIN_DISTANCE = (str1, str2) => {
+    const len1 = str1.length;
+    const len2 = str2.length;
+    // Create a 2D array for dynamic programming
+    const matrix = Array.from({ length: len1 + 1 }, () => Array(len2 + 1).fill(0));
+    // Initialize first column and row
+    for (let i = 0; i <= len1; i++) {
+        matrix[i][0] = i;
+    }
+    for (let j = 0; j <= len2; j++) {
+        matrix[0][j] = j;
+    }
+    // Fill the matrix
+    for (let i = 1; i <= len1; i++) {
+        for (let j = 1; j <= len2; j++) {
+            const cost = str1[i - 1] === str2[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
+            matrix[i][j - 1] + 1, // insertion
+            matrix[i - 1][j - 1] + cost // substitution
+            );
+        }
+    }
+    return matrix[len1][len2];
+};
+/**
+ * Finds suggestions for a method name based on similarity scoring.
+ *
+ * Uses Levenshtein distance and partial string matching to find similar method names.
+ * Returns suggestions sorted by similarity (most similar first).
+ * Used to provide helpful "Did you mean?" suggestions in validation error messages.
+ *
+ * @param methodName - The invalid method name to find suggestions for
+ * @param validNames - List of valid method names to search through
+ * @param maxDistance - Maximum Levenshtein distance to consider (default: 3)
+ * @returns Array of suggested method names sorted by similarity
+ */
+const FIND_SUGGESTIONS = (methodName, validNames, maxDistance = 3) => {
+    const lowerMethodName = methodName.toLowerCase();
+    // Calculate similarity score for each valid name
+    const suggestions = validNames
+        .map((validName) => {
+        const lowerValidName = validName.toLowerCase();
+        const distance = LEVENSHTEIN_DISTANCE(lowerMethodName, lowerValidName);
+        // Check for partial matches
+        const hasPartialMatch = lowerValidName.includes(lowerMethodName) ||
+            lowerMethodName.includes(lowerValidName);
+        return {
+            name: validName,
+            distance,
+            hasPartialMatch,
+        };
+    })
+        .filter((item) => item.distance <= maxDistance || item.hasPartialMatch)
+        .sort((a, b) => {
+        // Prioritize partial matches
+        if (a.hasPartialMatch && !b.hasPartialMatch)
+            return -1;
+        if (!a.hasPartialMatch && b.hasPartialMatch)
+            return 1;
+        // Then sort by distance
+        return a.distance - b.distance;
+    })
+        .slice(0, 3) // Limit to top 3 suggestions
+        .map((item) => item.name);
+    return suggestions;
+};
 /**
  * Validates that all public methods in a class-based action handler are in the allowed list.
  *
@@ -9924,7 +10002,18 @@ const VALIDATE_CLASS_METHODS = (actionName, handler, self) => {
         const descriptor = Object.getOwnPropertyDescriptor(handler.prototype, methodName);
         const isMethod = descriptor && typeof descriptor.value === "function";
         if (isMethod && !VALID_METHOD_NAMES.includes(methodName)) {
-            const msg = str.newline(`ActionSchema ${actionName} contains invalid method "${methodName}". `, `Valid methods are: ${VALID_METHOD_NAMES.join(", ")}`, `If you want to keep this property name use one of these patterns: _${methodName} or #${methodName}`);
+            const suggestions = FIND_SUGGESTIONS(methodName, VALID_METHOD_NAMES);
+            const lines = [
+                `ActionSchema ${actionName} contains invalid method "${methodName}". `,
+                `Valid methods are: ${VALID_METHOD_NAMES.join(", ")}`,
+            ];
+            if (suggestions.length > 0) {
+                lines.push(typo.nbsp);
+                lines.push(`Do you mean: ${suggestions.join(", ")}?`);
+                lines.push(typo.nbsp);
+            }
+            lines.push(`If you want to keep this property name use one of these patterns: _${methodName} or #${methodName}`);
+            const msg = str.newline(lines);
             self.loggerService.log(`actionValidationService exception thrown`, {
                 msg,
             });
@@ -9953,7 +10042,18 @@ const VALIDATE_OBJECT_METHODS = (actionName, handler, self) => {
         }
         if (typeof handler[methodName] === "function" &&
             !VALID_METHOD_NAMES.includes(methodName)) {
-            const msg = str.newline(`ActionSchema ${actionName} contains invalid method "${methodName}". `, `Valid methods are: ${VALID_METHOD_NAMES.join(", ")}`, `If you want to keep this property name use one of these patterns: _${methodName} or #${methodName}`);
+            const suggestions = FIND_SUGGESTIONS(methodName, VALID_METHOD_NAMES);
+            const lines = [
+                `ActionSchema ${actionName} contains invalid method "${methodName}". `,
+                `Valid methods are: ${VALID_METHOD_NAMES.join(", ")}`,
+            ];
+            if (suggestions.length > 0) {
+                lines.push(typo.nbsp);
+                lines.push(`Do you mean: ${suggestions.join(", ")}?`);
+                lines.push(typo.nbsp);
+            }
+            lines.push(`If you want to keep this property name use one of these patterns: _${methodName} or #${methodName}`);
+            const msg = str.newline(lines);
             self.loggerService.log(`actionValidationService exception thrown`, {
                 msg,
             });
@@ -31659,6 +31759,91 @@ const roundTicks = (price, tickSize) => {
     return price.toFixed(precision);
 };
 
+/**
+ * Parses command-line arguments for trading bot configuration.
+ *
+ * Processes process.argv to extract trading parameters and mode flags.
+ * Merges provided default values with command-line arguments.
+ * Supports both backtest mode (historical simulation), paper trading mode
+ * (simulated trading with live data), and live trading mode (real trading).
+ *
+ * Command-line options:
+ * - --symbol: Trading pair symbol (e.g., "BTCUSDT")
+ * - --strategy: Strategy name to use
+ * - --exchange: Exchange name (e.g., "binance")
+ * - --frame: Timeframe for candles (e.g., "1h", "15m")
+ * - --backtest: Enable backtest mode (boolean flag)
+ * - --paper: Enable paper trading mode (boolean flag)
+ * - --live: Enable live trading mode (boolean flag)
+ *
+ * @param params - Optional default values for parameters
+ * @param params.symbol - Default trading pair symbol
+ * @param params.strategyName - Default strategy name
+ * @param params.exchangeName - Default exchange name
+ * @param params.frameName - Default timeframe
+ * @returns Parsed configuration with all parameters and mode flags
+ *
+ * @example
+ * ```typescript
+ * // Parse args with defaults
+ * const config = parseArgs({
+ *   symbol: "BTCUSDT",
+ *   strategyName: "rsi_divergence",
+ *   exchangeName: "binance",
+ *   frameName: "1h"
+ * });
+ *
+ * // Command: node app.js --backtest
+ * // Result: { symbol: "BTCUSDT", ..., backtest: true, paper: false, live: false }
+ * ```
+ */
+const parseArgs = ({ symbol, strategyName, exchangeName, frameName, } = {}) => {
+    const { values } = parseArgs$1({
+        args: process.argv,
+        options: {
+            symbol: {
+                type: "string",
+                default: symbol,
+            },
+            strategy: {
+                type: "string",
+                default: strategyName,
+            },
+            exchange: {
+                type: "string",
+                default: exchangeName,
+            },
+            frame: {
+                type: "string",
+                default: frameName,
+            },
+            backtest: {
+                type: "boolean",
+                default: false,
+            },
+            paper: {
+                type: "boolean",
+                default: false,
+            },
+            live: {
+                type: "boolean",
+                default: false,
+            },
+        },
+        strict: false,
+        allowPositionals: true,
+    });
+    return {
+        symbol: String(values.symbol),
+        strategyName: String(values.strategy),
+        exchangeName: String(values.exchange),
+        frameName: String(values.frame),
+        backtest: Boolean(values.backtest),
+        paper: Boolean(values.paper),
+        live: Boolean(values.live),
+    };
+};
+
 /**
  * Updates the value of a nested object property using a specific path.
  *
@@ -31682,4 +31867,4 @@ const set = (object, path, value) => {
     }
 };
 
-export { ActionBase, Backtest, Breakeven, Cache, Constant, Exchange, ExecutionContextService, Heat, Live, Markdown, MarkdownFileBase, MarkdownFolderBase, MethodContextService, Notification, Optimizer, Partial, Performance, PersistBase, PersistBreakevenAdapter, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PositionSize, Report, ReportBase, Risk, Schedule, Walker, addActionSchema, addExchangeSchema, addFrameSchema, addOptimizerSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, commitBreakeven, commitCancel, commitPartialLoss, commitPartialProfit, commitTrailingStop, commitTrailingTake, dumpSignalData, emitters, formatPrice, formatQuantity, get, getActionSchema, getAveragePrice, getBacktestTimeframe, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getExchangeSchema, getFrameSchema, getMode, getOptimizerSchema, getOrderBook, getRiskSchema, getSizingSchema, getStrategySchema, getSymbol, getWalkerSchema, hasTradeContext, backtest as lib, listExchangeSchema, listFrameSchema, listOptimizerSchema, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenOptimizerProgress, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideOptimizerSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, roundTicks, set, setColumns, setConfig, setLogger, stop, validate };
+export { ActionBase, Backtest, Breakeven, Cache, Constant, Exchange, ExecutionContextService, Heat, Live, Markdown, MarkdownFileBase, MarkdownFolderBase, MethodContextService, Notification, Optimizer, Partial, Performance, PersistBase, PersistBreakevenAdapter, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PositionSize, Report, ReportBase, Risk, Schedule, Walker, addActionSchema, addExchangeSchema, addFrameSchema, addOptimizerSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, commitBreakeven, commitCancel, commitPartialLoss, commitPartialProfit, commitTrailingStop, commitTrailingTake, dumpSignalData, emitters, formatPrice, formatQuantity, get, getActionSchema, getAveragePrice, getBacktestTimeframe, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getExchangeSchema, getFrameSchema, getMode, getOptimizerSchema, getOrderBook, getRiskSchema, getSizingSchema, getStrategySchema, getSymbol, getWalkerSchema, hasTradeContext, backtest as lib, listExchangeSchema, listFrameSchema, listOptimizerSchema, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenOptimizerProgress, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideOptimizerSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, roundTicks, set, setColumns, setConfig, setLogger, stop, validate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backtest-kit",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "A TypeScript library for trading system backtest",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -2,6 +2,9 @@ import * as di_scoped from 'di-scoped';
 import * as functools_kit from 'functools-kit';
 import { Subject } from 'functools-kit';
 import { WriteStream } from 'fs';
+import { ExchangeName as ExchangeName$1 } from 'src/interfaces/Exchange.interface';
+import { FrameName as FrameName$1 } from 'src/interfaces/Frame.interface';
+import { StrategyName as StrategyName$1 } from 'src/interfaces/Strategy.interface';
 
 /**
  * Retrieves current backtest timeframe for given symbol.
@@ -13774,6 +13777,72 @@ declare namespace emitters {
  */
 declare const roundTicks: (price: string | number, tickSize: number) => string;
 
+/**
+ * Input parameters for parseArgs function.
+ * Defines the default values for command-line argument parsing.
+ */
+interface IParseArgsParams {
+    /** Trading pair symbol (e.g., "BTCUSDT", "ETHUSDT") */
+    symbol: string;
+    /** Name of the trading strategy to execute */
+    strategyName: StrategyName$1;
+    /** Name of the exchange to connect to (e.g., "binance", "bybit") */
+    exchangeName: ExchangeName$1;
+    /** Timeframe for candle data (e.g., "1h", "15m", "1d") */
+    frameName: FrameName$1;
+}
+/**
+ * Result of parseArgs function.
+ * Extends input parameters with trading mode flags parsed from command-line arguments.
+ */
+interface IParseArgsResult extends IParseArgsParams {
+    /** Whether to run in backtest mode (historical data simulation) */
+    backtest: boolean;
+    /** Whether to run in paper trading mode (simulated trading with live data) */
+    paper: boolean;
+    /** Whether to run in live trading mode (real trading with real money) */
+    live: boolean;
+}
+/**
+ * Parses command-line arguments for trading bot configuration.
+ *
+ * Processes process.argv to extract trading parameters and mode flags.
+ * Merges provided default values with command-line arguments.
+ * Supports both backtest mode (historical simulation), paper trading mode
+ * (simulated trading with live data), and live trading mode (real trading).
+ *
+ * Command-line options:
+ * - --symbol: Trading pair symbol (e.g., "BTCUSDT")
+ * - --strategy: Strategy name to use
+ * - --exchange: Exchange name (e.g., "binance")
+ * - --frame: Timeframe for candles (e.g., "1h", "15m")
+ * - --backtest: Enable backtest mode (boolean flag)
+ * - --paper: Enable paper trading mode (boolean flag)
+ * - --live: Enable live trading mode (boolean flag)
+ *
+ * @param params - Optional default values for parameters
+ * @param params.symbol - Default trading pair symbol
+ * @param params.strategyName - Default strategy name
+ * @param params.exchangeName - Default exchange name
+ * @param params.frameName - Default timeframe
+ * @returns Parsed configuration with all parameters and mode flags
+ *
+ * @example
+ * ```typescript
+ * // Parse args with defaults
+ * const config = parseArgs({
+ *   symbol: "BTCUSDT",
+ *   strategyName: "rsi_divergence",
+ *   exchangeName: "binance",
+ *   frameName: "1h"
+ * });
+ *
+ * // Command: node app.js --backtest
+ * // Result: { symbol: "BTCUSDT", ..., backtest: true, paper: false, live: false }
+ * ```
+ */
+declare const parseArgs: ({ symbol, strategyName, exchangeName, frameName, }?: Partial<IParseArgsParams>) => IParseArgsResult;
+
 /**
  * Retrieves a value from an object using a given path.
  *
@@ -18855,4 +18924,4 @@ declare const backtest: {
     loggerService: LoggerService;
 };
 
-export { ActionBase, type ActivePingContract, Backtest, type BacktestDoneNotification, type BacktestStatisticsModel, type BootstrapNotification, Breakeven, type BreakevenContract, type BreakevenData, Cache, type CandleInterval, type ColumnConfig, type ColumnModel, Constant, type CriticalErrorNotification, type DoneContract, type EntityId, Exchange, ExecutionContextService, type FrameInterval, type GlobalConfig, Heat, type HeatmapStatisticsModel, type IBidData, type ICandleData, type IExchangeSchema, type IFrameSchema, type IHeatmapRow, type IMarkdownDumpOptions, type IOptimizerCallbacks, type IOptimizerData, type IOptimizerFetchArgs, type IOptimizerFilterArgs, type IOptimizerRange, type IOptimizerSchema, type IOptimizerSource, type IOptimizerStrategy, type IOptimizerTemplate, type IOrderBookData, type IPersistBase, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IPublicSignalRow, type IReportDumpOptions, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IScheduledSignalCancelRow, type IScheduledSignalRow, type ISignalDto, type ISignalRow, type ISizingCalculateParams, type ISizingCalculateParamsATR, type ISizingCalculateParamsFixedPercentage, type ISizingCalculateParamsKelly, type ISizingSchema, type ISizingSchemaATR, type ISizingSchemaFixedPercentage, type ISizingSchemaKelly, type IStrategyPnL, type IStrategyResult, type IStrategySchema, type IStrategyTickResult, type IStrategyTickResultActive, type IStrategyTickResultCancelled, type IStrategyTickResultClosed, type IStrategyTickResultIdle, type IStrategyTickResultOpened, type IStrategyTickResultScheduled, type IWalkerResults, type IWalkerSchema, type IWalkerStrategyResult, type InfoErrorNotification, Live, type LiveDoneNotification, type LiveStatisticsModel, Markdown, MarkdownFileBase, MarkdownFolderBase, type MarkdownName, type MessageModel, type MessageRole, MethodContextService, type MetricStats, Notification, type NotificationModel, Optimizer, Partial$1 as Partial, type PartialData, type PartialEvent, type PartialLossContract, type PartialLossNotification, type PartialProfitContract, type PartialProfitNotification, type PartialStatisticsModel, Performance, type PerformanceContract, type PerformanceMetricType, type PerformanceStatisticsModel, PersistBase, PersistBreakevenAdapter, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PositionSize, type ProgressBacktestContract, type ProgressBacktestNotification, type ProgressOptimizerContract, type ProgressWalkerContract, Report, ReportBase, type ReportName, Risk, type RiskContract, type RiskData, type RiskEvent, type RiskRejectionNotification, type RiskStatisticsModel, Schedule, type ScheduleData, type SchedulePingContract, type ScheduleStatisticsModel, type ScheduledEvent, type SignalCancelledNotification, type SignalClosedNotification, type SignalData, type SignalInterval, type SignalOpenedNotification, type SignalScheduledNotification, type TMarkdownBase, type TPersistBase, type TPersistBaseCtor, type TReportBase, type TickEvent, type ValidationErrorNotification, Walker, type WalkerCompleteContract, type WalkerContract, type WalkerMetric, type SignalData$1 as WalkerSignalData, type WalkerStatisticsModel, addActionSchema, addExchangeSchema, addFrameSchema, addOptimizerSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, commitBreakeven, commitCancel, commitPartialLoss, commitPartialProfit, commitTrailingStop, commitTrailingTake, dumpSignalData, emitters, formatPrice, formatQuantity, get, getActionSchema, getAveragePrice, getBacktestTimeframe, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getExchangeSchema, getFrameSchema, getMode, getOptimizerSchema, getOrderBook, getRiskSchema, getSizingSchema, getStrategySchema, getSymbol, getWalkerSchema, hasTradeContext, backtest as lib, listExchangeSchema, listFrameSchema, listOptimizerSchema, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenOptimizerProgress, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideOptimizerSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, roundTicks, set, setColumns, setConfig, setLogger, stop, validate };
+export { ActionBase, type ActivePingContract, Backtest, type BacktestDoneNotification, type BacktestStatisticsModel, type BootstrapNotification, Breakeven, type BreakevenContract, type BreakevenData, Cache, type CandleInterval, type ColumnConfig, type ColumnModel, Constant, type CriticalErrorNotification, type DoneContract, type EntityId, Exchange, ExecutionContextService, type FrameInterval, type GlobalConfig, Heat, type HeatmapStatisticsModel, type IBidData, type ICandleData, type IExchangeSchema, type IFrameSchema, type IHeatmapRow, type IMarkdownDumpOptions, type IOptimizerCallbacks, type IOptimizerData, type IOptimizerFetchArgs, type IOptimizerFilterArgs, type IOptimizerRange, type IOptimizerSchema, type IOptimizerSource, type IOptimizerStrategy, type IOptimizerTemplate, type IOrderBookData, type IPersistBase, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IPublicSignalRow, type IReportDumpOptions, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IScheduledSignalCancelRow, type IScheduledSignalRow, type ISignalDto, type ISignalRow, type ISizingCalculateParams, type ISizingCalculateParamsATR, type ISizingCalculateParamsFixedPercentage, type ISizingCalculateParamsKelly, type ISizingSchema, type ISizingSchemaATR, type ISizingSchemaFixedPercentage, type ISizingSchemaKelly, type IStrategyPnL, type IStrategyResult, type IStrategySchema, type IStrategyTickResult, type IStrategyTickResultActive, type IStrategyTickResultCancelled, type IStrategyTickResultClosed, type IStrategyTickResultIdle, type IStrategyTickResultOpened, type IStrategyTickResultScheduled, type IWalkerResults, type IWalkerSchema, type IWalkerStrategyResult, type InfoErrorNotification, Live, type LiveDoneNotification, type LiveStatisticsModel, Markdown, MarkdownFileBase, MarkdownFolderBase, type MarkdownName, type MessageModel, type MessageRole, MethodContextService, type MetricStats, Notification, type NotificationModel, Optimizer, Partial$1 as Partial, type PartialData, type PartialEvent, type PartialLossContract, type PartialLossNotification, type PartialProfitContract, type PartialProfitNotification, type PartialStatisticsModel, Performance, type PerformanceContract, type PerformanceMetricType, type PerformanceStatisticsModel, PersistBase, PersistBreakevenAdapter, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PositionSize, type ProgressBacktestContract, type ProgressBacktestNotification, type ProgressOptimizerContract, type ProgressWalkerContract, Report, ReportBase, type ReportName, Risk, type RiskContract, type RiskData, type RiskEvent, type RiskRejectionNotification, type RiskStatisticsModel, Schedule, type ScheduleData, type SchedulePingContract, type ScheduleStatisticsModel, type ScheduledEvent, type SignalCancelledNotification, type SignalClosedNotification, type SignalData, type SignalInterval, type SignalOpenedNotification, type SignalScheduledNotification, type TMarkdownBase, type TPersistBase, type TPersistBaseCtor, type TReportBase, type TickEvent, type ValidationErrorNotification, Walker, type WalkerCompleteContract, type WalkerContract, type WalkerMetric, type SignalData$1 as WalkerSignalData, type WalkerStatisticsModel, addActionSchema, addExchangeSchema, addFrameSchema, addOptimizerSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, commitBreakeven, commitCancel, commitPartialLoss, commitPartialProfit, commitTrailingStop, commitTrailingTake, dumpSignalData, emitters, formatPrice, formatQuantity, get, getActionSchema, getAveragePrice, getBacktestTimeframe, getCandles, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getExchangeSchema, getFrameSchema, getMode, getOptimizerSchema, getOrderBook, getRiskSchema, getSizingSchema, getStrategySchema, getSymbol, getWalkerSchema, hasTradeContext, backtest as lib, listExchangeSchema, listFrameSchema, listOptimizerSchema, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenBacktestProgress, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenOptimizerProgress, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideOptimizerSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, roundTicks, set, setColumns, setConfig, setLogger, stop, validate };