@adaptic/utils 0.0.383 → 0.0.901

package/dist/types/index.d.ts

@@ -1,26 +1,38 @@
-import * as Alpaca from './alpaca-functions';
-import * as pm from './performance-metrics';
-import * as tu from './time-utils';
-import * as mt from './market-time';
-import fetchTradeMetrics from './metrics-calcs';
-import * as pu from './price-utils';
-import * as ft from './format-tools';
-import * as Types from './types';
-import * as misc from './misc-utils';
-import * as polygon from './polygon';
-import * as av from './alphavantage';
-import * as backend from './adaptic';
-import * as crypto from './crypto';
-import * as ta from './technical-analysis';
-export { StampedeProtectedCache, createStampedeProtectedCache, DEFAULT_CACHE_OPTIONS, type StampedeProtectedCacheOptions, type CacheEntry, type CacheStats, type CacheLoader, } from './cache/stampede-protected-cache';
-export { AssetAllocationEngine, generateOptimalAllocation, getDefaultRiskProfile } from './asset-allocation-algorithm';
-export * from './types/asset-allocation-types';
-export * from './types';
-export { AlpacaTradingAPI } from './alpaca-trading-api';
-export { AlpacaMarketDataAPI } from './alpaca-market-data-api';
+import * as Alpaca from "./alpaca/legacy";
+import * as pm from "./performance-metrics";
+import * as tu from "./time-utils";
+import * as mt from "./market-time";
+import fetchTradeMetrics from "./metrics-calcs";
+import * as pu from "./price-utils";
+import * as ft from "./format-tools";
+import * as Types from "./types";
+import * as misc from "./misc-utils";
+import * as polygon from "./polygon";
+import * as av from "./alphavantage";
+import * as backend from "./adaptic";
+import * as crypto from "./crypto";
+import * as ta from "./technical-analysis";
+import { TokenBucketRateLimiter } from "./rate-limiter";
+export { type Logger, setLogger, getLogger, resetLogger } from "./logger";
+export { AdapticUtilsError, AlpacaApiError, PolygonApiError, AlphaVantageError, TimeoutError, ValidationError, AuthenticationError, HttpClientError, HttpServerError, RateLimitError, WebSocketError, NetworkError, DataFormatError, } from "./errors";
+export { validateAlpacaCredentials, validatePolygonApiKey, validateAlphaVantageApiKey, } from "./utils/auth-validator";
+export { TRADING_API, MARKET_DATA_API, WEBSOCKET_STREAMS, getTradingApiUrl, getTradingWebSocketUrl, getStockStreamUrl, getOptionsStreamUrl, getCryptoStreamUrl, type AccountType, } from "./config/api-endpoints";
+export { StampedeProtectedCache, createStampedeProtectedCache, DEFAULT_CACHE_OPTIONS, type StampedeProtectedCacheOptions, type CacheEntry, type CacheStats, type CacheLoader, } from "./cache/stampede-protected-cache";
+export { TokenBucketRateLimiter, rateLimiters, type RateLimiterConfig, } from "./rate-limiter";
+export { withRetry, API_RETRY_CONFIGS, type RetryConfig } from "./utils/retry";
+export { DEFAULT_TIMEOUTS, withTimeout, createTimeoutSignal, getTimeout, } from "./http-timeout";
+export { AssetAllocationEngine, generateOptimalAllocation, getDefaultRiskProfile, } from "./asset-allocation-algorithm";
+export * from "./types/asset-allocation-types";
+export { validateResponse, safeValidateResponse, ValidationResponseError, type ValidationResult, type ValidateResponseOptions, AlpacaAccountDetailsSchema, AlpacaPositionSchema, AlpacaPositionsArraySchema, AlpacaOrderSchema, AlpacaOrdersArraySchema, AlpacaBarSchema, AlpacaHistoricalBarsResponseSchema, AlpacaLatestBarsResponseSchema, AlpacaQuoteSchema, AlpacaLatestQuotesResponseSchema, AlpacaTradeSchema, AlpacaLatestTradesResponseSchema, AlpacaNewsArticleSchema, AlpacaNewsResponseSchema, AlpacaPortfolioHistoryResponseSchema, AlpacaCryptoBarsResponseSchema, RawPolygonPriceDataSchema, PolygonTickerInfoSchema, PolygonTickerDetailsResponseSchema, PolygonGroupedDailyResponseSchema, PolygonDailyOpenCloseSchema, PolygonTradeSchema as PolygonTradeZodSchema, PolygonTradesResponseSchema, PolygonLastTradeResponseSchema, PolygonAggregatesResponseSchema, PolygonErrorResponseSchema, AlphaVantageQuoteResponseSchema, AVNewsArticleSchema, AVNewsResponseSchema, } from "./schemas";
+export { paginate, paginateAll, type CursorPaginationConfig, type UrlPaginationConfig, type OffsetPaginationConfig, type PaginationConfig, } from "./utils/paginator";
+export { KEEP_ALIVE_DEFAULTS, httpAgent, httpsAgent, getAgentPoolStatus, verifyFetchKeepAlive, type ConnectionPoolStatus, } from "./utils/http-keep-alive";
+export * from "./types";
+export { AlpacaTradingAPI } from "./alpaca-trading-api";
+export { AlpacaMarketDataAPI } from "./alpaca-market-data-api";
 export declare const createAlpacaTradingAPI: (credentials: Types.AlpacaCredentials) => Types.AlpacaTradingAPI;
 export declare const createAlpacaMarketDataAPI: () => Types.AlpacaMarketDataAPI;
-export type { TokenProvider } from './adaptic';
+export * from "./alpaca";
+export type { TokenProvider } from "./adaptic";
 export declare const adaptic: {
     types: typeof Types;
     backend: {
@@ -30,22 +42,127 @@ export declare const adaptic: {
         isAuthConfigured: () => boolean;
     };
     alpaca: {
-        TradingAPI: typeof Types.AlpacaTradingAPI;
-        MarketDataAPI: typeof Types.AlpacaMarketDataAPI;
-        makeRequest: typeof Alpaca.makeRequest;
-        accountDetails: typeof Alpaca.fetchAccountDetails;
-        positions: typeof Alpaca.fetchAllPositions;
-        position: {
-            fetch: typeof Alpaca.fetchPosition;
-            close: typeof Alpaca.closePosition;
-            fetchAll: typeof Alpaca.fetchAllPositions;
-            closeAll: typeof Alpaca.closeAllPositions;
-            closeAllAfterHours: typeof Alpaca.closeAllPositionsAfterHours;
+        createClient: typeof import("./alpaca").createAlpacaClient;
+        createClientFromEnv: typeof import("./alpaca").createClientFromEnv;
+        clearClientCache: typeof import("./alpaca").clearClientCache;
+        /** @description Smart orders: brackets, OCO, OTO, trailing stops */
+        smartOrders: {
+            bracket: typeof import("./alpaca/trading/bracket-orders");
+            oco: typeof import("./alpaca/trading/oco-orders");
+            oto: typeof import("./alpaca/trading/oto-orders");
+            trailingStops: typeof import("./alpaca/trading/trailing-stops");
+            determineOrderType(params: import("./alpaca/trading/smart-orders").SmartOrderParams): import("./alpaca/trading/smart-orders").SmartOrderType;
+            createSmartOrder(client: import("./alpaca").AlpacaClient, params: import("./alpaca/trading/smart-orders").SmartOrderParams): Promise<import("./alpaca/trading/smart-orders").SmartOrderResult>;
+            createPercentageBracket(client: import("./alpaca").AlpacaClient, params: import("./alpaca/trading/smart-orders").PercentageBracketParams): Promise<import("./alpaca").BracketOrderResult>;
+            createRiskManagedPosition(client: import("./alpaca").AlpacaClient, params: import("./alpaca/trading/smart-orders").RiskManagedPositionParams): Promise<import("./alpaca").BracketOrderResult | import("./alpaca").OTOOrderResult>;
+            calculateRewardRiskRatio(entryPrice: number, takeProfitPrice: number, stopLossPrice: number, side: Types.OrderSide): number;
+            calculatePositionSize(accountValue: number, riskPercent: number, entryPrice: number, stopPrice: number): number;
+            default: {
+                createSmartOrder: typeof import("./alpaca/trading/smart-orders").createSmartOrder;
+                determineOrderType: typeof import("./alpaca/trading/smart-orders").determineOrderType;
+                createPercentageBracket: typeof import("./alpaca/trading/smart-orders").createPercentageBracket;
+                createRiskManagedPosition: typeof import("./alpaca/trading/smart-orders").createRiskManagedPosition;
+                calculateRewardRiskRatio: typeof import("./alpaca/trading/smart-orders").calculateRewardRiskRatio;
+                calculatePositionSize: typeof import("./alpaca/trading/smart-orders").calculatePositionSize;
+                createBracketOrder: typeof import("./alpaca").createBracketOrder;
+                createProtectiveBracket: typeof import("./alpaca").createProtectiveBracket;
+                createExecutorFromTradingAPI: typeof import("./alpaca").createExecutorFromTradingAPI;
+                createOCOOrder: typeof import("./alpaca").createOCOOrder;
+                createOTOOrder: typeof import("./alpaca").createOTOOrder;
+                createTrailingStop: typeof import("./alpaca").createTrailingStop;
+                updateTrailingStop: typeof import("./alpaca").updateTrailingStop;
+            };
+            createBracketOrder(executor: import("./alpaca").BracketOrderExecutor, params: import("./alpaca").BracketOrderParams): Promise<import("./alpaca").BracketOrderResult>;
+            createProtectiveBracket(executor: import("./alpaca").BracketOrderExecutor, params: import("./alpaca").ProtectiveBracketParams): Promise<import("./alpaca").BracketOrderResult>;
+            createExecutorFromTradingAPI(api: {
+                makeRequest: (endpoint: string, method: string, body?: unknown) => Promise<Types.AlpacaOrder>;
+            }): import("./alpaca").BracketOrderExecutor;
+            createOCOOrder(client: import("./alpaca").AlpacaClient, params: import("./alpaca").OCOOrderParams): Promise<import("./alpaca").OCOOrderResult>;
+            cancelOCOOrder(client: import("./alpaca").AlpacaClient, parentOrderId: string): Promise<void>;
+            getOCOOrderStatus(client: import("./alpaca").AlpacaClient, parentOrderId: string): Promise<Types.AlpacaOrder>;
+            protectLongPosition(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, takeProfitPrice: number, stopLossPrice: number, stopLimitPrice?: number): Promise<import("./alpaca").OCOOrderResult>;
+            protectShortPosition(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, takeProfitPrice: number, stopLossPrice: number, stopLimitPrice?: number): Promise<import("./alpaca").OCOOrderResult>;
+            createOTOOrder(client: import("./alpaca").AlpacaClient, params: import("./alpaca").OTOOrderParams): Promise<import("./alpaca").OTOOrderResult>;
+            cancelOTOOrder(client: import("./alpaca").AlpacaClient, parentOrderId: string): Promise<void>;
+            getOTOOrderStatus(client: import("./alpaca").AlpacaClient, parentOrderId: string): Promise<Types.AlpacaOrder>;
+            buyWithStopLoss(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, stopLossPrice: number, stopLimitPrice?: number): Promise<import("./alpaca").OTOOrderResult>;
+            buyWithTrailingStop(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, trailPercent: number): Promise<import("./alpaca").OTOOrderResult>;
+            limitBuyWithTakeProfit(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, entryPrice: number, takeProfitPrice: number): Promise<import("./alpaca").OTOOrderResult>;
+            shortWithStopLoss(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, entryPrice: number, stopLossPrice: number): Promise<import("./alpaca").OTOOrderResult>;
+            entryWithPercentStopLoss(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, entryPrice: number | null, stopLossPercent: number, side?: Types.OrderSide): Promise<import("./alpaca").OTOOrderResult>;
+            createTrailingStop(client: import("./alpaca").AlpacaClient, params: import("./alpaca").TrailingStopParams): Promise<Types.AlpacaOrder>;
+            updateTrailingStop(client: import("./alpaca").AlpacaClient, orderId: string, updates: {
+                trailPercent?: number;
+                trailPrice?: number;
+            }): Promise<Types.AlpacaOrder>;
+            getTrailingStopHWM(client: import("./alpaca").AlpacaClient, orderId: string): Promise<import("./alpaca").TrailingStopHWMResult>;
+            cancelTrailingStop(client: import("./alpaca").AlpacaClient, orderId: string): Promise<void>;
+            createPortfolioTrailingStops(client: import("./alpaca").AlpacaClient, params: import("./alpaca").PortfolioTrailingStopParams): Promise<Map<string, Types.AlpacaOrder>>;
+            getOpenTrailingStops(client: import("./alpaca").AlpacaClient, symbol?: string): Promise<Types.AlpacaOrder[]>;
+            hasActiveTrailingStop(client: import("./alpaca").AlpacaClient, symbol: string): Promise<boolean>;
+            cancelTrailingStopsForSymbol(client: import("./alpaca").AlpacaClient, symbol: string): Promise<number>;
+            TrailingStopValidationError: typeof import("./alpaca").TrailingStopValidationError;
         };
-        portfolioHistory: typeof Alpaca.fetchPortfolioHistory;
-        getConfig: typeof Alpaca.getConfiguration;
-        updateConfig: typeof Alpaca.updateConfiguration;
-        news: typeof Alpaca.fetchNews;
+        /** @description Standard order operations - SDK-based (requires AlpacaClient) */
+        sdkOrders: {
+            getOrdersBySymbol(client: import("./alpaca").AlpacaClient, symbol: string, params?: Omit<Types.GetOrdersParams, "symbols">): Promise<Types.AlpacaOrder[]>;
+            getOpenOrders(client: import("./alpaca").AlpacaClient, params?: Omit<Types.GetOrdersParams, "status">): Promise<Types.AlpacaOrder[]>;
+            getFilledOrders(client: import("./alpaca").AlpacaClient, params: import("./alpaca").GetFilledOrdersParams): Promise<Types.AlpacaOrder[]>;
+            getOrderHistory(client: import("./alpaca").AlpacaClient, params?: import("./alpaca").GetOrderHistoryParams): Promise<import("./alpaca").OrderHistoryResult>;
+            getAllOrders(client: import("./alpaca").AlpacaClient, params?: import("./alpaca").GetAllOrdersParams): Promise<Types.AlpacaOrder[]>;
+            waitForOrderFill(client: import("./alpaca").AlpacaClient, params: import("./alpaca").WaitForOrderFillParams): Promise<import("./alpaca").WaitForOrderFillResult>;
+            isOrderFillable(order: Types.AlpacaOrder): boolean;
+            isOrderFilled(order: Types.AlpacaOrder): boolean;
+            isOrderTerminal(order: Types.AlpacaOrder): boolean;
+            isOrderOpen(order: Types.AlpacaOrder): boolean;
+            calculateOrderValue(order: Types.AlpacaOrder): number | null;
+            formatOrderSummary(order: Types.AlpacaOrder): import("./alpaca").OrderSummary;
+            formatOrderForLog(order: Types.AlpacaOrder): string;
+            roundPriceForAlpaca(price: number): string;
+            roundPriceForAlpacaNumber(price: number): number;
+            groupOrdersBySymbol(orders: Types.AlpacaOrder[]): Map<string, Types.AlpacaOrder[]>;
+            groupOrdersByStatus(orders: Types.AlpacaOrder[]): Map<string, Types.AlpacaOrder[]>;
+            calculateTotalFilledValue(orders: Types.AlpacaOrder[]): number;
+            filterOrdersByDateRange(orders: Types.AlpacaOrder[], startDate: Date, endDate: Date): Types.AlpacaOrder[];
+            sortOrdersByDate(orders: Types.AlpacaOrder[], direction?: "asc" | "desc"): Types.AlpacaOrder[];
+            default: {
+                getOrdersBySymbol: typeof import("./alpaca").getOrdersBySymbol;
+                getOpenOrders: typeof import("./alpaca").getOpenOrdersQuery;
+                getFilledOrders: typeof import("./alpaca").getFilledOrders;
+                getOrderHistory: typeof import("./alpaca").getOrderHistory;
+                getAllOrders: typeof import("./alpaca").getAllOrders;
+                waitForOrderFill: typeof import("./alpaca").waitForOrderFill;
+                isOrderFillable: typeof import("./alpaca").isOrderFillable;
+                isOrderFilled: typeof import("./alpaca").isOrderFilled;
+                isOrderTerminal: typeof import("./alpaca").isOrderTerminalStatus;
+                isOrderOpen: typeof import("./alpaca").isOrderOpen;
+                calculateOrderValue: typeof import("./alpaca").calculateOrderValue;
+                calculateTotalFilledValue: typeof import("./alpaca").calculateTotalFilledValue;
+                formatOrderSummary: typeof import("./alpaca").formatOrderSummary;
+                formatOrderForLog: typeof import("./alpaca").formatOrderForLog;
+                roundPriceForAlpaca: typeof import("./alpaca").roundPriceForAlpaca;
+                roundPriceForAlpacaNumber: typeof import("./alpaca").roundPriceForAlpacaNumber;
+                groupOrdersBySymbol: typeof import("./alpaca").groupOrdersBySymbol;
+                groupOrdersByStatus: typeof import("./alpaca").groupOrdersByStatus;
+                filterOrdersByDateRange: typeof import("./alpaca").filterOrdersByDateRange;
+                sortOrdersByDate: typeof import("./alpaca").sortOrdersByDate;
+            };
+            createOrder(client: import("./alpaca").AlpacaClient, params: Types.CreateOrderParams): Promise<Types.AlpacaOrder>;
+            getOrder(client: import("./alpaca").AlpacaClient, orderId: string): Promise<Types.AlpacaOrder>;
+            getOrders(client: import("./alpaca").AlpacaClient, params?: Types.GetOrdersParams): Promise<Types.AlpacaOrder[]>;
+            cancelOrder(client: import("./alpaca").AlpacaClient, orderId: string): Promise<void>;
+            cancelAllOrders(client: import("./alpaca").AlpacaClient): Promise<import("./alpaca/trading/orders").CancelAllOrdersResponse>;
+            replaceOrder(client: import("./alpaca").AlpacaClient, orderId: string, params: Types.ReplaceOrderParams): Promise<Types.AlpacaOrder>;
+            isOrderCancelable(status: Types.OrderStatus): boolean;
+            getOrderByClientId(client: import("./alpaca").AlpacaClient, clientOrderId: string): Promise<Types.AlpacaOrder>;
+        };
+        /** @description Position management - SDK-based (requires AlpacaClient) */
+        sdkPositions: typeof import("./alpaca/trading/positions");
+        /** @description Account information and configuration - SDK-based (requires AlpacaClient) */
+        sdkAccount: typeof import("./alpaca/trading/account");
+        /** @description Market clock and trading calendar - SDK-based (requires AlpacaClient) */
+        sdkClock: typeof import("./alpaca/trading/clock");
+        /** @description Standard order operations - Legacy API (uses AlpacaAuth) */
         orders: {
             create: typeof Alpaca.createOrder;
             createLimitOrder: typeof Alpaca.createLimitOrder;
@@ -55,9 +172,59 @@ export declare const adaptic: {
             cancel: typeof Alpaca.cancelOrder;
             cancelAll: typeof Alpaca.cancelAllOrders;
         };
+        /** @description Position management - Legacy API (uses AlpacaAuth) */
+        positions: {
+            fetch: typeof Alpaca.fetchPosition;
+            close: typeof Alpaca.closePosition;
+            fetchAll: typeof Alpaca.fetchAllPositions;
+            closeAll: typeof Alpaca.closeAllPositions;
+            closeAllAfterHours: typeof Alpaca.closeAllPositionsAfterHours;
+        };
+        /** @description Account information - Legacy API (uses AlpacaAuth) */
+        account: typeof Alpaca.fetchAccountDetails;
+        /** @description Real-time and historical quotes */
+        quotes: typeof import("./alpaca/market-data/quotes");
+        /** @description Historical price bars (OHLCV) */
+        bars: typeof import("./alpaca/market-data/bars");
+        /** @description Trade data */
+        trades: typeof import("./alpaca/market-data/trades");
+        /** @description Market news */
+        news: typeof import("./alpaca/market-data/news");
+        /** @description Options trading and data */
+        options: {
+            contracts: typeof import("./alpaca/options/contracts");
+            orders: typeof import("./alpaca/options/orders");
+            strategies: typeof import("./alpaca/options/strategies");
+            data: typeof import("./alpaca/options/data");
+        };
+        /** @description Cryptocurrency trading and data */
+        crypto: {
+            orders: typeof import("./alpaca/crypto/orders");
+            data: typeof import("./alpaca/crypto/data");
+        };
+        /** @description Real-time WebSocket streams */
+        streams: typeof import("./alpaca/streams");
+        /** @deprecated Use positions module instead */
+        position: {
+            fetch: typeof Alpaca.fetchPosition;
+            close: typeof Alpaca.closePosition;
+            fetchAll: typeof Alpaca.fetchAllPositions;
+            closeAll: typeof Alpaca.closeAllPositions;
+            closeAllAfterHours: typeof Alpaca.closeAllPositionsAfterHours;
+        };
+        /** @deprecated Use account() instead */
+        accountDetails: typeof Alpaca.fetchAccountDetails;
+        /** @deprecated Use sdkAccount.getPortfolioHistory() instead */
+        portfolioHistory: typeof Alpaca.fetchPortfolioHistory;
+        /** @deprecated Use sdkAccount.getAccountConfiguration() instead */
+        getConfig: typeof Alpaca.getConfiguration;
+        /** @deprecated Use sdkAccount.updateAccountConfiguration() instead */
+        updateConfig: typeof Alpaca.updateConfiguration;
+        /** @deprecated Use SDK asset functions instead */
         asset: {
             get: typeof Alpaca.getAsset;
         };
+        /** @deprecated Use quotes module instead */
         quote: {
             getLatest: typeof Alpaca.getLatestQuotes;
         };
@@ -162,7 +329,7 @@ export declare const adaptic: {
             order?: string;
             limit?: number;
             sort?: string;
-        }) => Promise<any>;
+        }) => Promise<Types.PolygonIndicesSnapshotResponse>;
         formatBarData: (data: Types.PolygonIndicesAggregatesResponse) => Array<{
             date: string;
             open: number;
@@ -218,10 +385,18 @@ export declare const adaptic: {
         getTradingDate: typeof mt.getTradingDate;
     };
     utils: {
-        logIfDebug: (message: string, data?: unknown, type?: "info" | "warn" | "error" | "debug" | "trace") => void;
+        logIfDebug: (message: string, data?: unknown, type?: "error" | "info" | "warn" | "debug" | "trace") => void;
         fetchWithRetry: typeof misc.fetchWithRetry;
         validatePolygonApiKey: typeof misc.validatePolygonApiKey;
     };
+    rateLimiter: {
+        TokenBucketRateLimiter: typeof TokenBucketRateLimiter;
+        limiters: {
+            alpaca: TokenBucketRateLimiter;
+            polygon: TokenBucketRateLimiter;
+            alphaVantage: TokenBucketRateLimiter;
+        };
+    };
 };
 export declare const adptc: {
     types: typeof Types;
@@ -232,22 +407,127 @@ export declare const adptc: {
         isAuthConfigured: () => boolean;
     };
     alpaca: {
-        TradingAPI: typeof Types.AlpacaTradingAPI;
-        MarketDataAPI: typeof Types.AlpacaMarketDataAPI;
-        makeRequest: typeof Alpaca.makeRequest;
-        accountDetails: typeof Alpaca.fetchAccountDetails;
-        positions: typeof Alpaca.fetchAllPositions;
-        position: {
-            fetch: typeof Alpaca.fetchPosition;
-            close: typeof Alpaca.closePosition;
-            fetchAll: typeof Alpaca.fetchAllPositions;
-            closeAll: typeof Alpaca.closeAllPositions;
-            closeAllAfterHours: typeof Alpaca.closeAllPositionsAfterHours;
+        createClient: typeof import("./alpaca").createAlpacaClient;
+        createClientFromEnv: typeof import("./alpaca").createClientFromEnv;
+        clearClientCache: typeof import("./alpaca").clearClientCache;
+        /** @description Smart orders: brackets, OCO, OTO, trailing stops */
+        smartOrders: {
+            bracket: typeof import("./alpaca/trading/bracket-orders");
+            oco: typeof import("./alpaca/trading/oco-orders");
+            oto: typeof import("./alpaca/trading/oto-orders");
+            trailingStops: typeof import("./alpaca/trading/trailing-stops");
+            determineOrderType(params: import("./alpaca/trading/smart-orders").SmartOrderParams): import("./alpaca/trading/smart-orders").SmartOrderType;
+            createSmartOrder(client: import("./alpaca").AlpacaClient, params: import("./alpaca/trading/smart-orders").SmartOrderParams): Promise<import("./alpaca/trading/smart-orders").SmartOrderResult>;
+            createPercentageBracket(client: import("./alpaca").AlpacaClient, params: import("./alpaca/trading/smart-orders").PercentageBracketParams): Promise<import("./alpaca").BracketOrderResult>;
+            createRiskManagedPosition(client: import("./alpaca").AlpacaClient, params: import("./alpaca/trading/smart-orders").RiskManagedPositionParams): Promise<import("./alpaca").BracketOrderResult | import("./alpaca").OTOOrderResult>;
+            calculateRewardRiskRatio(entryPrice: number, takeProfitPrice: number, stopLossPrice: number, side: Types.OrderSide): number;
+            calculatePositionSize(accountValue: number, riskPercent: number, entryPrice: number, stopPrice: number): number;
+            default: {
+                createSmartOrder: typeof import("./alpaca/trading/smart-orders").createSmartOrder;
+                determineOrderType: typeof import("./alpaca/trading/smart-orders").determineOrderType;
+                createPercentageBracket: typeof import("./alpaca/trading/smart-orders").createPercentageBracket;
+                createRiskManagedPosition: typeof import("./alpaca/trading/smart-orders").createRiskManagedPosition;
+                calculateRewardRiskRatio: typeof import("./alpaca/trading/smart-orders").calculateRewardRiskRatio;
+                calculatePositionSize: typeof import("./alpaca/trading/smart-orders").calculatePositionSize;
+                createBracketOrder: typeof import("./alpaca").createBracketOrder;
+                createProtectiveBracket: typeof import("./alpaca").createProtectiveBracket;
+                createExecutorFromTradingAPI: typeof import("./alpaca").createExecutorFromTradingAPI;
+                createOCOOrder: typeof import("./alpaca").createOCOOrder;
+                createOTOOrder: typeof import("./alpaca").createOTOOrder;
+                createTrailingStop: typeof import("./alpaca").createTrailingStop;
+                updateTrailingStop: typeof import("./alpaca").updateTrailingStop;
+            };
+            createBracketOrder(executor: import("./alpaca").BracketOrderExecutor, params: import("./alpaca").BracketOrderParams): Promise<import("./alpaca").BracketOrderResult>;
+            createProtectiveBracket(executor: import("./alpaca").BracketOrderExecutor, params: import("./alpaca").ProtectiveBracketParams): Promise<import("./alpaca").BracketOrderResult>;
+            createExecutorFromTradingAPI(api: {
+                makeRequest: (endpoint: string, method: string, body?: unknown) => Promise<Types.AlpacaOrder>;
+            }): import("./alpaca").BracketOrderExecutor;
+            createOCOOrder(client: import("./alpaca").AlpacaClient, params: import("./alpaca").OCOOrderParams): Promise<import("./alpaca").OCOOrderResult>;
+            cancelOCOOrder(client: import("./alpaca").AlpacaClient, parentOrderId: string): Promise<void>;
+            getOCOOrderStatus(client: import("./alpaca").AlpacaClient, parentOrderId: string): Promise<Types.AlpacaOrder>;
+            protectLongPosition(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, takeProfitPrice: number, stopLossPrice: number, stopLimitPrice?: number): Promise<import("./alpaca").OCOOrderResult>;
+            protectShortPosition(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, takeProfitPrice: number, stopLossPrice: number, stopLimitPrice?: number): Promise<import("./alpaca").OCOOrderResult>;
+            createOTOOrder(client: import("./alpaca").AlpacaClient, params: import("./alpaca").OTOOrderParams): Promise<import("./alpaca").OTOOrderResult>;
+            cancelOTOOrder(client: import("./alpaca").AlpacaClient, parentOrderId: string): Promise<void>;
+            getOTOOrderStatus(client: import("./alpaca").AlpacaClient, parentOrderId: string): Promise<Types.AlpacaOrder>;
+            buyWithStopLoss(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, stopLossPrice: number, stopLimitPrice?: number): Promise<import("./alpaca").OTOOrderResult>;
+            buyWithTrailingStop(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, trailPercent: number): Promise<import("./alpaca").OTOOrderResult>;
+            limitBuyWithTakeProfit(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, entryPrice: number, takeProfitPrice: number): Promise<import("./alpaca").OTOOrderResult>;
+            shortWithStopLoss(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, entryPrice: number, stopLossPrice: number): Promise<import("./alpaca").OTOOrderResult>;
+            entryWithPercentStopLoss(client: import("./alpaca").AlpacaClient, symbol: string, qty: number, entryPrice: number | null, stopLossPercent: number, side?: Types.OrderSide): Promise<import("./alpaca").OTOOrderResult>;
+            createTrailingStop(client: import("./alpaca").AlpacaClient, params: import("./alpaca").TrailingStopParams): Promise<Types.AlpacaOrder>;
+            updateTrailingStop(client: import("./alpaca").AlpacaClient, orderId: string, updates: {
+                trailPercent?: number;
+                trailPrice?: number;
+            }): Promise<Types.AlpacaOrder>;
+            getTrailingStopHWM(client: import("./alpaca").AlpacaClient, orderId: string): Promise<import("./alpaca").TrailingStopHWMResult>;
+            cancelTrailingStop(client: import("./alpaca").AlpacaClient, orderId: string): Promise<void>;
+            createPortfolioTrailingStops(client: import("./alpaca").AlpacaClient, params: import("./alpaca").PortfolioTrailingStopParams): Promise<Map<string, Types.AlpacaOrder>>;
+            getOpenTrailingStops(client: import("./alpaca").AlpacaClient, symbol?: string): Promise<Types.AlpacaOrder[]>;
+            hasActiveTrailingStop(client: import("./alpaca").AlpacaClient, symbol: string): Promise<boolean>;
+            cancelTrailingStopsForSymbol(client: import("./alpaca").AlpacaClient, symbol: string): Promise<number>;
+            TrailingStopValidationError: typeof import("./alpaca").TrailingStopValidationError;
         };
-        portfolioHistory: typeof Alpaca.fetchPortfolioHistory;
-        getConfig: typeof Alpaca.getConfiguration;
-        updateConfig: typeof Alpaca.updateConfiguration;
-        news: typeof Alpaca.fetchNews;
+        /** @description Standard order operations - SDK-based (requires AlpacaClient) */
+        sdkOrders: {
+            getOrdersBySymbol(client: import("./alpaca").AlpacaClient, symbol: string, params?: Omit<Types.GetOrdersParams, "symbols">): Promise<Types.AlpacaOrder[]>;
+            getOpenOrders(client: import("./alpaca").AlpacaClient, params?: Omit<Types.GetOrdersParams, "status">): Promise<Types.AlpacaOrder[]>;
+            getFilledOrders(client: import("./alpaca").AlpacaClient, params: import("./alpaca").GetFilledOrdersParams): Promise<Types.AlpacaOrder[]>;
+            getOrderHistory(client: import("./alpaca").AlpacaClient, params?: import("./alpaca").GetOrderHistoryParams): Promise<import("./alpaca").OrderHistoryResult>;
+            getAllOrders(client: import("./alpaca").AlpacaClient, params?: import("./alpaca").GetAllOrdersParams): Promise<Types.AlpacaOrder[]>;
+            waitForOrderFill(client: import("./alpaca").AlpacaClient, params: import("./alpaca").WaitForOrderFillParams): Promise<import("./alpaca").WaitForOrderFillResult>;
+            isOrderFillable(order: Types.AlpacaOrder): boolean;
+            isOrderFilled(order: Types.AlpacaOrder): boolean;
+            isOrderTerminal(order: Types.AlpacaOrder): boolean;
+            isOrderOpen(order: Types.AlpacaOrder): boolean;
+            calculateOrderValue(order: Types.AlpacaOrder): number | null;
+            formatOrderSummary(order: Types.AlpacaOrder): import("./alpaca").OrderSummary;
+            formatOrderForLog(order: Types.AlpacaOrder): string;
+            roundPriceForAlpaca(price: number): string;
+            roundPriceForAlpacaNumber(price: number): number;
+            groupOrdersBySymbol(orders: Types.AlpacaOrder[]): Map<string, Types.AlpacaOrder[]>;
+            groupOrdersByStatus(orders: Types.AlpacaOrder[]): Map<string, Types.AlpacaOrder[]>;
+            calculateTotalFilledValue(orders: Types.AlpacaOrder[]): number;
+            filterOrdersByDateRange(orders: Types.AlpacaOrder[], startDate: Date, endDate: Date): Types.AlpacaOrder[];
+            sortOrdersByDate(orders: Types.AlpacaOrder[], direction?: "asc" | "desc"): Types.AlpacaOrder[];
+            default: {
+                getOrdersBySymbol: typeof import("./alpaca").getOrdersBySymbol;
+                getOpenOrders: typeof import("./alpaca").getOpenOrdersQuery;
+                getFilledOrders: typeof import("./alpaca").getFilledOrders;
+                getOrderHistory: typeof import("./alpaca").getOrderHistory;
+                getAllOrders: typeof import("./alpaca").getAllOrders;
+                waitForOrderFill: typeof import("./alpaca").waitForOrderFill;
+                isOrderFillable: typeof import("./alpaca").isOrderFillable;
+                isOrderFilled: typeof import("./alpaca").isOrderFilled;
+                isOrderTerminal: typeof import("./alpaca").isOrderTerminalStatus;
+                isOrderOpen: typeof import("./alpaca").isOrderOpen;
+                calculateOrderValue: typeof import("./alpaca").calculateOrderValue;
+                calculateTotalFilledValue: typeof import("./alpaca").calculateTotalFilledValue;
+                formatOrderSummary: typeof import("./alpaca").formatOrderSummary;
+                formatOrderForLog: typeof import("./alpaca").formatOrderForLog;
+                roundPriceForAlpaca: typeof import("./alpaca").roundPriceForAlpaca;
+                roundPriceForAlpacaNumber: typeof import("./alpaca").roundPriceForAlpacaNumber;
+                groupOrdersBySymbol: typeof import("./alpaca").groupOrdersBySymbol;
+                groupOrdersByStatus: typeof import("./alpaca").groupOrdersByStatus;
+                filterOrdersByDateRange: typeof import("./alpaca").filterOrdersByDateRange;
+                sortOrdersByDate: typeof import("./alpaca").sortOrdersByDate;
+            };
+            createOrder(client: import("./alpaca").AlpacaClient, params: Types.CreateOrderParams): Promise<Types.AlpacaOrder>;
+            getOrder(client: import("./alpaca").AlpacaClient, orderId: string): Promise<Types.AlpacaOrder>;
+            getOrders(client: import("./alpaca").AlpacaClient, params?: Types.GetOrdersParams): Promise<Types.AlpacaOrder[]>;
+            cancelOrder(client: import("./alpaca").AlpacaClient, orderId: string): Promise<void>;
+            cancelAllOrders(client: import("./alpaca").AlpacaClient): Promise<import("./alpaca/trading/orders").CancelAllOrdersResponse>;
+            replaceOrder(client: import("./alpaca").AlpacaClient, orderId: string, params: Types.ReplaceOrderParams): Promise<Types.AlpacaOrder>;
+            isOrderCancelable(status: Types.OrderStatus): boolean;
+            getOrderByClientId(client: import("./alpaca").AlpacaClient, clientOrderId: string): Promise<Types.AlpacaOrder>;
+        };
+        /** @description Position management - SDK-based (requires AlpacaClient) */
+        sdkPositions: typeof import("./alpaca/trading/positions");
+        /** @description Account information and configuration - SDK-based (requires AlpacaClient) */
+        sdkAccount: typeof import("./alpaca/trading/account");
+        /** @description Market clock and trading calendar - SDK-based (requires AlpacaClient) */
+        sdkClock: typeof import("./alpaca/trading/clock");
+        /** @description Standard order operations - Legacy API (uses AlpacaAuth) */
         orders: {
             create: typeof Alpaca.createOrder;
             createLimitOrder: typeof Alpaca.createLimitOrder;
@@ -257,9 +537,59 @@ export declare const adptc: {
             cancel: typeof Alpaca.cancelOrder;
             cancelAll: typeof Alpaca.cancelAllOrders;
         };
+        /** @description Position management - Legacy API (uses AlpacaAuth) */
+        positions: {
+            fetch: typeof Alpaca.fetchPosition;
+            close: typeof Alpaca.closePosition;
+            fetchAll: typeof Alpaca.fetchAllPositions;
+            closeAll: typeof Alpaca.closeAllPositions;
+            closeAllAfterHours: typeof Alpaca.closeAllPositionsAfterHours;
+        };
+        /** @description Account information - Legacy API (uses AlpacaAuth) */
+        account: typeof Alpaca.fetchAccountDetails;
+        /** @description Real-time and historical quotes */
+        quotes: typeof import("./alpaca/market-data/quotes");
+        /** @description Historical price bars (OHLCV) */
+        bars: typeof import("./alpaca/market-data/bars");
+        /** @description Trade data */
+        trades: typeof import("./alpaca/market-data/trades");
+        /** @description Market news */
+        news: typeof import("./alpaca/market-data/news");
+        /** @description Options trading and data */
+        options: {
+            contracts: typeof import("./alpaca/options/contracts");
+            orders: typeof import("./alpaca/options/orders");
+            strategies: typeof import("./alpaca/options/strategies");
+            data: typeof import("./alpaca/options/data");
+        };
+        /** @description Cryptocurrency trading and data */
+        crypto: {
+            orders: typeof import("./alpaca/crypto/orders");
+            data: typeof import("./alpaca/crypto/data");
+        };
+        /** @description Real-time WebSocket streams */
+        streams: typeof import("./alpaca/streams");
+        /** @deprecated Use positions module instead */
+        position: {
+            fetch: typeof Alpaca.fetchPosition;
+            close: typeof Alpaca.closePosition;
+            fetchAll: typeof Alpaca.fetchAllPositions;
+            closeAll: typeof Alpaca.closeAllPositions;
+            closeAllAfterHours: typeof Alpaca.closeAllPositionsAfterHours;
+        };
+        /** @deprecated Use account() instead */
+        accountDetails: typeof Alpaca.fetchAccountDetails;
+        /** @deprecated Use sdkAccount.getPortfolioHistory() instead */
+        portfolioHistory: typeof Alpaca.fetchPortfolioHistory;
+        /** @deprecated Use sdkAccount.getAccountConfiguration() instead */
+        getConfig: typeof Alpaca.getConfiguration;
+        /** @deprecated Use sdkAccount.updateAccountConfiguration() instead */
+        updateConfig: typeof Alpaca.updateConfiguration;
+        /** @deprecated Use SDK asset functions instead */
         asset: {
             get: typeof Alpaca.getAsset;
         };
+        /** @deprecated Use quotes module instead */
         quote: {
             getLatest: typeof Alpaca.getLatestQuotes;
         };
@@ -364,7 +694,7 @@ export declare const adptc: {
             order?: string;
             limit?: number;
             sort?: string;
-        }) => Promise<any>;
+        }) => Promise<Types.PolygonIndicesSnapshotResponse>;
         formatBarData: (data: Types.PolygonIndicesAggregatesResponse) => Array<{
             date: string;
             open: number;
@@ -420,9 +750,17 @@ export declare const adptc: {
         getTradingDate: typeof mt.getTradingDate;
     };
     utils: {
-        logIfDebug: (message: string, data?: unknown, type?: "info" | "warn" | "error" | "debug" | "trace") => void;
+        logIfDebug: (message: string, data?: unknown, type?: "error" | "info" | "warn" | "debug" | "trace") => void;
         fetchWithRetry: typeof misc.fetchWithRetry;
         validatePolygonApiKey: typeof misc.validatePolygonApiKey;
     };
+    rateLimiter: {
+        TokenBucketRateLimiter: typeof TokenBucketRateLimiter;
+        limiters: {
+            alpaca: TokenBucketRateLimiter;
+            polygon: TokenBucketRateLimiter;
+            alphaVantage: TokenBucketRateLimiter;
+        };
+    };
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,iBAAiB,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAK3C,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,KAAK,6BAA6B,EAClC,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,cAAc,gCAAgC,CAAC;AAG/C,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,eAAO,MAAM,sBAAsB,GAAI,aAAa,KAAK,CAAC,iBAAiB,2BAE1E,CAAC;AAEF,eAAO,MAAM,yBAAyB,iCAErC,CAAC;AAGF,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAfkB,CAAC;;;iBAiFnB,CAAC;eAAW,CAAC;iBAC7B,CAAC;kBAAgB,CAAC;gBAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBArFjC,CAAC;;;kBAgK+gL,CAAC;oBAAsB,CAAC;sBAAyB,CAAC;;;kBAzDlkL,CAAJ;;;kBAyD2zX,CAAC;qBAAuB,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;iBAA4B,CAAC;iBAA2B,CAAC;gBAAkB,CAAC;;;;;eAAz6W,CAAC;;;iBAAiE,CAAC;;kBAAmC,CAAC;;;;;kBAA60Q,CAAC;oBAAsB,CAAC;;;;;;kBAjJ9kS,CAAC;;;kBAgDuB,CAAC;;;kBAyCxB,CAAF;;;kBAgCc,CAAA;;;kBAwBy5B,CAAC;gBAAkB,CAAC;iBAAmB,CAAC;iBAAmB,CAAC;gBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAJv/B,CAAC;AAEF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA3JoB,CAAC;;;iBAiFnB,CAAC;eAAW,CAAC;iBAC7B,CAAC;kBAAgB,CAAC;gBAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBArFjC,CAAC;;;kBAgK+gL,CAAC;oBAAsB,CAAC;sBAAyB,CAAC;;;kBAzDlkL,CAAJ;;;kBAyD2zX,CAAC;qBAAuB,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;uBAAkC,CAAC;wBAAmC,CAAC;iBAA4B,CAAC;iBAA2B,CAAC;gBAAkB,CAAC;;;;;eAAz6W,CAAC;;;iBAAiE,CAAC;;kBAAmC,CAAC;;;;;kBAA60Q,CAAC;oBAAsB,CAAC;;;;;;kBAjJ9kS,CAAC;;;kBAgDuB,CAAC;;;kBAyCxB,CAAF;;;kBAgCc,CAAA;;;kBAwBy5B,CAAC;gBAAkB,CAAC;iBAAmB,CAAC;iBAAmB,CAAC;gBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAF59B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types/logger.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Configurable logger interface compatible with Pino and other logging libraries.
+ * Provides structured logging with context support.
+ */
+export interface Logger {
+    error(message: string, context?: unknown): void;
+    warn(message: string, context?: unknown): void;
+    info(message: string, context?: unknown): void;
+    debug(message: string, context?: unknown): void;
+}
+/**
+ * Sets a custom logger implementation.
+ * Call this to integrate with Pino or other logging libraries.
+ *
+ * @param logger - The logger implementation to use
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { setLogger } from '@adaptic/utils';
+ *
+ * const pinoLogger = pino();
+ *
+ * setLogger({
+ *   error: (msg, ctx) => pinoLogger.error(ctx, msg),
+ *   warn: (msg, ctx) => pinoLogger.warn(ctx, msg),
+ *   info: (msg, ctx) => pinoLogger.info(ctx, msg),
+ *   debug: (msg, ctx) => pinoLogger.debug(ctx, msg),
+ * });
+ * ```
+ */
+export declare function setLogger(logger: Logger): void;
+/**
+ * Gets the current logger instance.
+ * Use this to log messages throughout the application.
+ *
+ * @returns The current logger instance
+ *
+ * @example
+ * ```typescript
+ * import { getLogger } from '@adaptic/utils';
+ *
+ * const logger = getLogger();
+ * logger.error('Operation failed', { userId: 123, operation: 'createOrder' });
+ * logger.warn('Rate limit approaching', { remaining: 10 });
+ * logger.info('Order created', { orderId: 'abc123', symbol: 'AAPL' });
+ * logger.debug('Cache hit', { key: 'user:123' });
+ * ```
+ */
+export declare function getLogger(): Logger;
+/**
+ * Resets the logger to the default console-based implementation.
+ * Useful for testing or cleanup.
+ */
+export declare function resetLogger(): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/types/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACjD;AA8CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/types/logging.d.ts

@@ -1,4 +1,4 @@
-import { LogOptions } from './types/logging-types';
+import { LogOptions } from "./types/logging-types";
 /**
  * Logs a message to the console.
  * @param message The message to log.