@adaptic/utils 0.0.382 → 0.0.900

package/dist/types/config/api-endpoints.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Centralized API Endpoints Configuration
+ *
+ * This file defines all Alpaca API base URLs to ensure consistency
+ * across the codebase and make updates easier.
+ *
+ * API Version Guidelines:
+ * - Trading API: v2 (stable, production-ready)
+ * - Market Data (stocks): v2 (stable)
+ * - Market Data (crypto): v1beta3 (latest beta)
+ * - Market Data (options): v1beta1 (latest beta)
+ * - News API: v1beta1 (latest beta)
+ */
+/**
+ * Account type for trading
+ */
+export type AccountType = "PAPER" | "LIVE";
+/**
+ * Trading API base URLs (v2)
+ * Used for orders, positions, account management
+ */
+export declare const TRADING_API: {
+    readonly PAPER: "https://paper-api.alpaca.markets/v2";
+    readonly LIVE: "https://api.alpaca.markets/v2";
+};
+/**
+ * Get trading API base URL for account type
+ */
+export declare function getTradingApiUrl(accountType: AccountType): string;
+/**
+ * Market Data API base URLs
+ */
+export declare const MARKET_DATA_API: {
+    /** Stock market data (v2) - bars, quotes, trades */
+    readonly STOCKS: "https://data.alpaca.markets/v2";
+    /** Cryptocurrency market data (v1beta3) - latest stable beta */
+    readonly CRYPTO: "https://data.alpaca.markets/v1beta3";
+    /** Options market data (v1beta1) */
+    readonly OPTIONS: "https://data.alpaca.markets/v1beta1";
+    /** News API (v1beta1) */
+    readonly NEWS: "https://data.alpaca.markets/v1beta1";
+};
+/**
+ * WebSocket stream URLs
+ */
+export declare const WEBSOCKET_STREAMS: {
+    /** Trading updates (orders, fills, etc.) */
+    readonly TRADING: {
+        readonly PAPER: "wss://paper-api.alpaca.markets/stream";
+        readonly LIVE: "wss://api.alpaca.markets/stream";
+    };
+    /** Stock market data stream (v2) */
+    readonly STOCKS: {
+        readonly PRODUCTION: "wss://stream.data.alpaca.markets/v2/sip";
+        readonly TEST: "wss://stream.data.alpaca.markets/v2/test";
+    };
+    /** Options market data stream (v1beta3) */
+    readonly OPTIONS: {
+        readonly PRODUCTION: "wss://stream.data.alpaca.markets/v1beta3/options";
+        readonly SANDBOX: "wss://stream.data.sandbox.alpaca.markets/v1beta3/options";
+    };
+    /** Crypto market data stream (v1beta3) */
+    readonly CRYPTO: {
+        readonly PRODUCTION: "wss://stream.data.alpaca.markets/v1beta3/crypto/us";
+        readonly SANDBOX: "wss://stream.data.sandbox.alpaca.markets/v1beta3/crypto/us";
+    };
+};
+/**
+ * Get trading WebSocket URL for account type
+ */
+export declare function getTradingWebSocketUrl(accountType: AccountType): string;
+/**
+ * Get stock stream WebSocket URL
+ */
+export declare function getStockStreamUrl(mode?: "PRODUCTION" | "TEST"): string;
+/**
+ * Get options stream WebSocket URL
+ */
+export declare function getOptionsStreamUrl(mode?: "PRODUCTION" | "SANDBOX"): string;
+/**
+ * Get crypto stream WebSocket URL
+ */
+export declare function getCryptoStreamUrl(mode?: "PRODUCTION" | "SANDBOX"): string;
+/**
+ * Legacy support - map old API version references to current
+ * @deprecated Use the constants above directly
+ */
+export declare const LEGACY_API_VERSIONS: {
+    /** @deprecated Use MARKET_DATA_API.OPTIONS instead */
+    readonly v1beta1: "https://data.alpaca.markets/v1beta1";
+    /** @deprecated Use MARKET_DATA_API.CRYPTO instead */
+    readonly v1beta3: "https://data.alpaca.markets/v1beta3";
+};
+//# sourceMappingURL=api-endpoints.d.ts.map

package/dist/types/config/api-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-endpoints.d.ts","sourceRoot":"","sources":["../../../src/config/api-endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,oDAAoD;;IAEpD,gEAAgE;;IAEhE,oCAAoC;;IAEpC,yBAAyB;;CAEjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,4CAA4C;;;;;IAK5C,oCAAoC;;;;;IAKpC,2CAA2C;;;;;IAK3C,0CAA0C;;;;;CAKlC,CAAC;AAEX;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE,YAAY,GAAG,MAAqB,GACzC,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,YAAY,GAAG,SAAwB,GAC5C,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,YAAY,GAAG,SAAwB,GAC5C,MAAM,CAER;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,sDAAsD;;IAEtD,qDAAqD;;CAE7C,CAAC"}

package/dist/types/crypto.d.ts

@@ -1,4 +1,4 @@
-import type { CryptoBarsParams, CryptoBar, AlpacaNewsArticle, LatestTradesResponse, LatestQuotesResponse } from './types/alpaca-types.js';
+import type { CryptoBarsParams, CryptoBar, AlpacaNewsArticle, LatestTradesResponse, LatestQuotesResponse } from "./types/alpaca-types.js";
 /**
  * Fetches cryptocurrency bars for the specified parameters.
  * This function retrieves historical price data for multiple cryptocurrencies.
@@ -19,7 +19,7 @@ export declare function fetchBars(params: CryptoBarsParams): Promise<{
 type AlpacaAuth = {
     APIKey: string;
     APISecret: string;
-    type?: 'PAPER' | 'LIVE';
+    type?: "PAPER" | "LIVE";
 };
 /**
  * Fetches news articles related to a specific cryptocurrency symbol.

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

@@ -1 +1 @@
-{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAKjC;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;CAAE,CAAC,CAgEpG;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqE9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,EACD,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,oBAAoB,CAAC,CA2C/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,EACD,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,oBAAoB,CAAC,CA2C/B"}
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAQjC;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;IAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;CAAE,CAAC,CA8E5C;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE;IACN,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqG9B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,EACD,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,oBAAoB,CAAC,CA+C/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE;IACN,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,EACD,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,oBAAoB,CAAC,CA+C/B"}

package/dist/types/display-manager.d.ts

@@ -1,4 +1,4 @@
-import { LogOptions } from './types/logging-types';
+import { LogOptions } from "./types/logging-types";
 export declare class DisplayManager {
     private static instance;
     private promptText;

package/dist/types/display-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-manager.d.ts","sourceRoot":"","sources":["../../src/display-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,UAAU,CAAc;IAEhC,OAAO;WAEO,WAAW,IAAI,cAAc;IAOpC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAqCvD;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB,OAAO,CAAC,WAAW;IAIZ,WAAW,IAAI,IAAI;IAKnB,aAAa,IAAI,IAAI;CAG7B"}
+{"version":3,"file":"display-manager.d.ts","sourceRoot":"","sources":["../../src/display-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,UAAU,CAAc;IAEhC,OAAO;WAEO,WAAW,IAAI,cAAc;IAOpC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAuCvD;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,WAAW;IAIZ,WAAW,IAAI,IAAI;IAKnB,aAAa,IAAI,IAAI;CAG7B"}

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

@@ -0,0 +1,130 @@
+/**
+ * Structured error type hierarchy for all API integrations
+ *
+ * This module provides a comprehensive error handling system for external API integrations,
+ * including Alpaca, Polygon, and AlphaVantage services.
+ */
+/**
+ * Base error class for all @adaptic/utils errors
+ * Extends Error with additional context about service, error code, and retry capability
+ */
+export declare class AdapticUtilsError extends Error {
+    readonly code: string;
+    readonly service: string;
+    readonly isRetryable: boolean;
+    readonly cause?: unknown | undefined;
+    readonly name: string;
+    constructor(message: string, code: string, service: string, isRetryable?: boolean, cause?: unknown | undefined);
+}
+/**
+ * Alpaca API specific errors
+ * Handles all errors from Alpaca trading and market data APIs
+ */
+export declare class AlpacaApiError extends AdapticUtilsError {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, cause?: unknown);
+}
+/**
+ * Polygon.io API specific errors
+ * Handles all errors from Polygon market data API
+ */
+export declare class PolygonApiError extends AdapticUtilsError {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, cause?: unknown);
+}
+/**
+ * AlphaVantage API specific errors
+ * Handles all errors from AlphaVantage financial data API
+ */
+export declare class AlphaVantageError extends AdapticUtilsError {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, cause?: unknown);
+}
+/**
+ * Network timeout errors
+ * Used when API requests exceed configured timeout limits
+ * Always retryable as timeouts are often transient
+ */
+export declare class TimeoutError extends AdapticUtilsError {
+    readonly service: string;
+    readonly timeoutMs: number;
+    constructor(message: string, service: string, timeoutMs: number, cause?: unknown);
+}
+/**
+ * Input validation errors
+ * Used when function inputs fail validation checks
+ * Never retryable as the inputs need to be corrected
+ */
+export declare class ValidationError extends AdapticUtilsError {
+    readonly service: string;
+    readonly invalidField?: string | undefined;
+    constructor(message: string, service: string, invalidField?: string | undefined, cause?: unknown);
+}
+/**
+ * Authentication and authorization errors
+ * Used when API credentials are invalid, expired, or lack permissions
+ * Never retryable as credentials need to be updated
+ */
+export declare class AuthenticationError extends AdapticUtilsError {
+    readonly service: string;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, service: string, statusCode?: number | undefined, cause?: unknown);
+}
+/**
+ * HTTP client errors (4xx)
+ * Used for client-side errors that are not authentication or validation related
+ * Generally not retryable unless specific status codes indicate otherwise
+ */
+export declare class HttpClientError extends AdapticUtilsError {
+    readonly service: string;
+    readonly statusCode: number;
+    constructor(message: string, service: string, statusCode: number, cause?: unknown);
+}
+/**
+ * HTTP server errors (5xx)
+ * Used for server-side errors from external APIs
+ * Always retryable as server issues are often transient
+ */
+export declare class HttpServerError extends AdapticUtilsError {
+    readonly service: string;
+    readonly statusCode: number;
+    constructor(message: string, service: string, statusCode: number, cause?: unknown);
+}
+/**
+ * Rate limit errors (429)
+ * Used when API rate limits are exceeded
+ * Always retryable, often with retry-after header information
+ */
+export declare class RateLimitError extends AdapticUtilsError {
+    readonly service: string;
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, service: string, retryAfterMs?: number | undefined, cause?: unknown);
+}
+/**
+ * WebSocket connection errors
+ * Used for WebSocket-specific connection and communication failures
+ * Retryability depends on the specific error condition
+ */
+export declare class WebSocketError extends AdapticUtilsError {
+    readonly service: string;
+    constructor(message: string, service: string, isRetryable?: boolean, cause?: unknown);
+}
+/**
+ * Network errors (connection failures, DNS issues, etc.)
+ * Used for low-level network failures
+ * Always retryable as network issues are often transient
+ */
+export declare class NetworkError extends AdapticUtilsError {
+    readonly service: string;
+    constructor(message: string, service: string, cause?: unknown);
+}
+/**
+ * Data parsing and format errors
+ * Used when API responses cannot be parsed or are in unexpected format
+ * Not retryable as the data format issue needs investigation
+ */
+export declare class DataFormatError extends AdapticUtilsError {
+    readonly service: string;
+    constructor(message: string, service: string, cause?: unknown);
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/dist/types/examples/asset-allocation-example.d.ts

@@ -4,30 +4,31 @@
  * Demonstrates practical usage of the asset allocation engine
  * with real-world scenarios and best practices.
  */
+import { type AllocationRecommendation } from "../index";
 /**
  * Example 1: Basic Conservative Portfolio for Retirement
  */
-export declare function conservativeRetirementPortfolio(): Promise<import("../index").AllocationRecommendation>;
+export declare function conservativeRetirementPortfolio(): Promise<AllocationRecommendation>;
 /**
  * Example 2: Aggressive Growth Portfolio for Young Investor
  */
-export declare function aggressiveGrowthPortfolio(): Promise<import("../index").AllocationRecommendation>;
+export declare function aggressiveGrowthPortfolio(): Promise<AllocationRecommendation>;
 /**
  * Example 3: Rebalancing an Existing Portfolio
  */
-export declare function rebalancePortfolio(): Promise<import("../index").AllocationRecommendation>;
+export declare function rebalancePortfolio(): Promise<AllocationRecommendation>;
 /**
  * Example 4: Crisis Mode Allocation
  */
-export declare function crisisModePortfolio(): Promise<import("../index").AllocationRecommendation>;
+export declare function crisisModePortfolio(): Promise<AllocationRecommendation>;
 /**
  * Example 5: Risk Parity Portfolio
  */
-export declare function riskParityPortfolio(): Promise<import("../index").AllocationRecommendation>;
+export declare function riskParityPortfolio(): Promise<AllocationRecommendation>;
 /**
  * Example 6: Small Account Allocation
  */
-export declare function smallAccountPortfolio(): Promise<import("../index").AllocationRecommendation>;
+export declare function smallAccountPortfolio(): Promise<AllocationRecommendation>;
 /**
  * Run all examples
  */

package/dist/types/examples/asset-allocation-example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-allocation-example.d.ts","sourceRoot":"","sources":["../../../src/examples/asset-allocation-example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;GAEG;AACH,wBAAsB,+BAA+B,yDAiKpD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,yDA4C9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,yDAsEvC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,yDAwDxC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,yDAgDxC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,yDAwC1C;AAwJD;;GAEG;AACH,wBAAsB,cAAc,kBAOnC"}
+{"version":3,"file":"asset-allocation-example.d.ts","sourceRoot":"","sources":["../../../src/examples/asset-allocation-example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAWL,KAAK,wBAAwB,EAC9B,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,wBAAsB,+BAA+B,sCAyKpD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,sCA6C9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,sCAiFvC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,sCAyDxC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,sCAmDxC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,sCAyC1C;AAkLD;;GAEG;AACH,wBAAsB,cAAc,kBAOnC"}

package/dist/types/examples/rate-limiter-example.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Rate Limiter Usage Examples
+ *
+ * Demonstrates how to use the TokenBucketRateLimiter for various API integrations
+ */
+export {};
+//# sourceMappingURL=rate-limiter-example.d.ts.map

package/dist/types/examples/rate-limiter-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter-example.d.ts","sourceRoot":"","sources":["../../../src/examples/rate-limiter-example.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/format-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-tools.d.ts","sourceRoot":"","sources":["../../src/format-tools.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,GAAE,MAAU,GAAG,MAAM,CAQjF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAYhD"}
+{"version":3,"file":"format-tools.d.ts","sourceRoot":"","sources":["../../src/format-tools.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,MAAU,GACxB,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAYhD"}

package/dist/types/http-timeout.d.ts

@@ -0,0 +1,37 @@
+/**
+ * HTTP request timeout utilities
+ * Provides configurable timeout handling for external API calls
+ */
+/**
+ * Default timeout values for different external APIs (in milliseconds)
+ * Can be overridden via environment variables
+ */
+export declare const DEFAULT_TIMEOUTS: {
+    readonly ALPACA_API: number;
+    readonly POLYGON_API: number;
+    readonly ALPHA_VANTAGE: number;
+    readonly GENERAL: number;
+};
+/**
+ * Wraps a promise with a timeout
+ * @param promise - The promise to wrap with timeout
+ * @param ms - Timeout duration in milliseconds
+ * @param label - Label for error messages to identify the request
+ * @returns Promise that rejects if timeout is exceeded
+ * @throws Error if the promise takes longer than the specified timeout
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, label: string): Promise<T>;
+/**
+ * Creates an AbortSignal that times out after the specified duration
+ * Compatible with fetch API
+ * @param ms - Timeout duration in milliseconds
+ * @returns AbortSignal that will abort after the specified duration
+ */
+export declare function createTimeoutSignal(ms: number): AbortSignal;
+/**
+ * Get the appropriate timeout value for a given API
+ * @param api - The API type to get timeout for
+ * @returns Timeout value in milliseconds
+ */
+export declare function getTimeout(api: keyof typeof DEFAULT_TIMEOUTS): number;
+//# sourceMappingURL=http-timeout.d.ts.map

package/dist/types/http-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-timeout.d.ts","sourceRoot":"","sources":["../../src/http-timeout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,OAAO,gBAAgB,GAAG,MAAM,CAErE"}