adding data-services

libs/utils/README.md

@@ -0,0 +1,51 @@
+# Utils Library
+
+Common utility functions shared across services in the stock-bot project.
+
+## Included Utilities
+
+### Date Utilities
+
+Helper functions for working with market dates:
+
+```typescript
+import { dateUtils } from '@stock-bot/utils';
+
+// Check if a date is a trading day
+const isTradingDay = dateUtils.isTradingDay(new Date());
+
+// Get the next trading day
+const nextTradingDay = dateUtils.getNextTradingDay(new Date());
+```
+
+### Financial Utilities
+
+Mathematical functions for financial calculations:
+
+```typescript
+import { financialUtils } from '@stock-bot/utils';
+
+// Calculate Sharpe ratio
+const returns = [0.05, 0.03, -0.01, 0.04, 0.02];
+const sharpeRatio = financialUtils.calculateSharpeRatio(returns, 0.02);
+
+// Calculate maximum drawdown
+const equityCurve = [10000, 10500, 10200, 10800, 10300];
+const maxDrawdown = financialUtils.calculateMaxDrawdown(equityCurve);
+```
+
+### Logger
+
+Standardized logging service:
+
+```typescript
+import { createLogger, LogLevel } from '@stock-bot/utils';
+
+// Create a logger for your service
+const logger = createLogger('strategy-orchestrator', LogLevel.INFO);
+
+// Log at different levels
+logger.info('Strategy initialized');
+logger.warn('Position size exceeds recommended limit');
+logger.error('Failed to execute order', { orderId: '123', reason: 'Insufficient funds' });
+```