@adaptic/utils 0.1.48 → 0.1.50

package/dist/types/alpaca/trading/smart-orders.d.ts.map

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

package/dist/types/alpaca/trading/trailing-stops.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Native Trailing Stop Orders Module
+ *
+ * This module provides functions for creating and managing native trailing stop orders
+ * using Alpaca's server-side trailing stop functionality. Native trailing stops are
+ * handled by Alpaca's servers, eliminating the need for client-side monitoring.
+ *
+ * Key benefits of native trailing stops:
+ * - Server-side execution ensures stops work even if your application is offline
+ * - No need for polling or websocket connections to monitor prices
+ * - Automatic high water mark (HWM) tracking by Alpaca
+ * - Support for both percentage-based and dollar-based trailing
+ */
+import { AlpacaClient } from "../client";
+import { AlpacaOrder, OrderSide, TimeInForce } from "../../types/alpaca-types";
+/**
+ * Alpaca's hard upper limit for `trail_percent` on trailing-stop orders.
+ * Submissions exceeding this value are rejected with HTTP 422 / code 42210000
+ * ("trail_percent must be <= 25"). See:
+ * https://docs.alpaca.markets/reference/postorder
+ */
+export declare const ALPACA_MAX_TRAIL_PERCENT = 25;
+/**
+ * Parameters for creating a trailing stop order
+ */
+export interface TrailingStopParams {
+    /** Stock symbol */
+    symbol: string;
+    /** Number of shares */
+    qty: number;
+    /** Order side (usually 'sell' for closing long positions) */
+    side: OrderSide;
+    /** Trail by percentage (e.g., 1.0 = 1%). Must specify either trailPercent OR trailPrice */
+    trailPercent?: number;
+    /** Trail by fixed dollar amount. Must specify either trailPercent OR trailPrice */
+    trailPrice?: number;
+    /** Time in force (default: 'gtc') */
+    timeInForce?: TimeInForce;
+    /** Extended hours trading */
+    extendedHours?: boolean;
+    /** Client order ID for tracking */
+    clientOrderId?: string;
+}
+/**
+ * Result of trailing stop HWM query
+ */
+export interface TrailingStopHWMResult {
+    /** High water mark - the highest price seen since order placement (for sell stops) */
+    hwm: number | null;
+    /** Current calculated stop price based on HWM and trail amount */
+    currentStop: number | null;
+}
+/**
+ * Parameters for creating trailing stops across a portfolio
+ */
+export interface PortfolioTrailingStopParams {
+    /** Trail by percentage (e.g., 2.0 = 2%) */
+    trailPercent: number;
+    /** Time in force (default: 'gtc') */
+    timeInForce?: TimeInForce;
+    /** Symbols to exclude from trailing stop creation */
+    excludeSymbols?: string[];
+}
+/**
+ * Validation error for trailing stop parameters
+ */
+export declare class TrailingStopValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Create a native trailing stop order
+ *
+ * The trailing stop automatically adjusts based on price movement:
+ * - For SELL: Stop rises as price rises, locks in when price falls
+ * - For BUY: Stop falls as price falls, triggers when price rises
+ *
+ * Must specify either trailPercent OR trailPrice (not both)
+ *
+ * @param client - AlpacaClient instance
+ * @param params - Trailing stop parameters
+ * @returns The created order
+ * @throws {TrailingStopValidationError} If parameters are invalid
+ * @throws {Error} If order creation fails
+ *
+ * @example
+ * ```typescript
+ * // Trail by 2% on a sell (closing long position)
+ * await createTrailingStop(client, {
+ *   symbol: 'AAPL',
+ *   qty: 100,
+ *   side: 'sell',
+ *   trailPercent: 2.0,
+ * });
+ *
+ * // Trail by $5 on a sell
+ * await createTrailingStop(client, {
+ *   symbol: 'AAPL',
+ *   qty: 100,
+ *   side: 'sell',
+ *   trailPrice: 5.00,
+ * });
+ * ```
+ */
+export declare function createTrailingStop(client: AlpacaClient, params: TrailingStopParams): Promise<AlpacaOrder>;
+/**
+ * Update an existing trailing stop order
+ *
+ * You can update the trail_percent or trail_price of an existing order.
+ * Note: Alpaca uses 'trail' parameter for replacements (works for both percent and price).
+ *
+ * @param client - AlpacaClient instance
+ * @param orderId - The ID of the order to update
+ * @param updates - New trail parameters (specify one of trailPercent or trailPrice)
+ * @returns The updated order
+ * @throws {Error} If no update parameters provided or update fails
+ *
+ * @example
+ * ```typescript
+ * // Tighten trailing stop to 1.5%
+ * await updateTrailingStop(client, 'order-id-123', { trailPercent: 1.5 });
+ *
+ * // Change to $3 trail
+ * await updateTrailingStop(client, 'order-id-123', { trailPrice: 3.00 });
+ * ```
+ */
+export declare function updateTrailingStop(client: AlpacaClient, orderId: string, updates: {
+    trailPercent?: number;
+    trailPrice?: number;
+}): Promise<AlpacaOrder>;
+/**
+ * Get the current high water mark (HWM) for a trailing stop
+ *
+ * The HWM is the highest price seen since order placement (for sell stops)
+ * or the lowest price (for buy stops). The current stop price is calculated
+ * based on the HWM and the trail amount.
+ *
+ * @param client - AlpacaClient instance
+ * @param orderId - The ID of the trailing stop order
+ * @returns Object containing HWM and current stop price (null if not yet established)
+ * @throws {Error} If order retrieval fails
+ *
+ * @example
+ * ```typescript
+ * const { hwm, currentStop } = await getTrailingStopHWM(client, 'order-id-123');
+ * console.log(`High water mark: $${hwm}, Current stop: $${currentStop}`);
+ * ```
+ */
+export declare function getTrailingStopHWM(client: AlpacaClient, orderId: string): Promise<TrailingStopHWMResult>;
+/**
+ * Cancel a trailing stop order
+ *
+ * @param client - AlpacaClient instance
+ * @param orderId - The ID of the trailing stop order to cancel
+ * @throws {Error} If cancellation fails
+ *
+ * @example
+ * ```typescript
+ * await cancelTrailingStop(client, 'order-id-123');
+ * ```
+ */
+export declare function cancelTrailingStop(client: AlpacaClient, orderId: string): Promise<void>;
+/**
+ * Create trailing stops for all positions in a portfolio
+ *
+ * This function creates trailing stop orders for all long positions in the portfolio,
+ * which is useful for applying blanket downside protection. Short positions are skipped.
+ *
+ * @param client - AlpacaClient instance
+ * @param params - Configuration for portfolio-wide trailing stops
+ * @returns Map of symbol to created order (symbols that failed are not included)
+ *
+ * @example
+ * ```typescript
+ * // Apply 3% trailing stops to all positions except TSLA and NVDA
+ * const orders = await createPortfolioTrailingStops(client, {
+ *   trailPercent: 3.0,
+ *   excludeSymbols: ['TSLA', 'NVDA'],
+ * });
+ *
+ * console.log(`Created ${orders.size} trailing stops`);
+ * for (const [symbol, order] of orders) {
+ *   console.log(`${symbol}: ${order.id}`);
+ * }
+ * ```
+ */
+export declare function createPortfolioTrailingStops(client: AlpacaClient, params: PortfolioTrailingStopParams): Promise<Map<string, AlpacaOrder>>;
+/**
+ * Get all open trailing stop orders
+ *
+ * @param client - AlpacaClient instance
+ * @param symbol - Optional symbol to filter by
+ * @returns Array of open trailing stop orders
+ *
+ * @example
+ * ```typescript
+ * // Get all trailing stops
+ * const allStops = await getOpenTrailingStops(client);
+ *
+ * // Get trailing stops for specific symbol
+ * const appleStops = await getOpenTrailingStops(client, 'AAPL');
+ * ```
+ */
+export declare function getOpenTrailingStops(client: AlpacaClient, symbol?: string): Promise<AlpacaOrder[]>;
+/**
+ * Check if a symbol has an active trailing stop order
+ *
+ * @param client - AlpacaClient instance
+ * @param symbol - Stock symbol to check
+ * @returns True if an active trailing stop exists for the symbol
+ *
+ * @example
+ * ```typescript
+ * if (await hasActiveTrailingStop(client, 'AAPL')) {
+ *   console.log('AAPL already has a trailing stop');
+ * }
+ * ```
+ */
+export declare function hasActiveTrailingStop(client: AlpacaClient, symbol: string): Promise<boolean>;
+/**
+ * Cancel all trailing stop orders for a specific symbol
+ *
+ * @param client - AlpacaClient instance
+ * @param symbol - Stock symbol
+ * @returns Number of orders canceled
+ *
+ * @example
+ * ```typescript
+ * const canceled = await cancelTrailingStopsForSymbol(client, 'AAPL');
+ * console.log(`Canceled ${canceled} trailing stop orders for AAPL`);
+ * ```
+ */
+export declare function cancelTrailingStopsForSymbol(client: AlpacaClient, symbol: string): Promise<number>;
+/**
+ * Default export object with all trailing stop functions
+ */
+declare const _default: {
+    createTrailingStop: typeof createTrailingStop;
+    updateTrailingStop: typeof updateTrailingStop;
+    getTrailingStopHWM: typeof getTrailingStopHWM;
+    cancelTrailingStop: typeof cancelTrailingStop;
+    createPortfolioTrailingStops: typeof createPortfolioTrailingStops;
+    getOpenTrailingStops: typeof getOpenTrailingStops;
+    hasActiveTrailingStop: typeof hasActiveTrailingStop;
+    cancelTrailingStopsForSymbol: typeof cancelTrailingStopsForSymbol;
+};
+export default _default;
+//# sourceMappingURL=trailing-stops.d.ts.map

package/dist/types/alpaca/trading/trailing-stops.d.ts.map

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

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). Feed controlled by ALPACA_DATA_FEED env (iex|sip, default: iex). */
+    readonly STOCKS: {
+        readonly PRODUCTION: `wss://stream.data.alpaca.markets/v2/${string}`;
+        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,sGAAsG;;;;;IAKtG,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/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, Massive, 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);
+}
+/**
+ * Massive.com API specific errors
+ * Handles all errors from Massive market data API
+ */
+export declare class MassiveApiError 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/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/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 MASSIVE_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"}

package/dist/types/index.d.ts

@@ -20,6 +20,15 @@ export * as tradingPolicy from "./trading-policy";
 export { DEFAULT_TRADING_POLICY, DEFAULT_TRADING_POLICY_UTILS_TUNED, getUtilsTunedTradingPolicy, type TradingPolicyJson, } from "./trading-policy";
 export { AlpacaTradingAPI } from "./alpaca-trading-api";
 export { AlpacaMarketDataAPI } from "./alpaca-market-data-api";
+export * as alpacaSdk from "./alpaca";
+export * as schemas from "./schemas";
+export * from "./errors";
+export * from "./logger";
+export * from "./rate-limiter";
+export * from "./http-timeout";
+export * from "./risk-free-rate";
+export * as paginator from "./utils/paginator";
+export * as retry from "./utils/retry";
 export { validateAlpacaCredentials, validateMassiveApiKey, validateAlphaVantageApiKey, } from "./utils/auth-validator";
 export { KEEP_ALIVE_DEFAULTS, httpAgent, httpsAgent, getAgentPoolStatus, verifyFetchKeepAlive, type ConnectionPoolStatus, } from "./utils/http-keep-alive";
 export declare const createAlpacaTradingAPI: (credentials: Types.AlpacaCredentials) => Types.AlpacaTradingAPI;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"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,68 @@
+/**
+ * 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;
+/**
+ * Returns true when an external logger has been injected via {@link setLogger}.
+ *
+ * Used by the legacy {@link log} export in `logging.ts` to decide whether to
+ * route messages through the injected (production) logger or fall back to the
+ * `DisplayManager` terminal widget (standalone CLI usage). Without this flag,
+ * library code that imports `log` from `./logging` would silently bypass any
+ * structured logging pipeline (Pino, OTel) the host application has wired in.
+ *
+ * @returns `true` if {@link setLogger} has been called since the last reset
+ */
+export declare function isLoggerInjected(): boolean;
+/**
+ * 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;AA+CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAG9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC"}