@adaptic/utils 0.0.99

package/dist/types/crypto.d.ts

@@ -0,0 +1,76 @@
+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.
+ *
+ * @param params - The parameters for fetching crypto bars.
+ * @param params.symbols - An array of cryptocurrency symbols to fetch data for.
+ * @param params.timeframe - The timeframe for the bars (e.g., '1Min', '5Min', '1H', '1D').
+ * @param params.start - The start date for fetching bars (optional).
+ * @param params.end - The end date for fetching bars (optional).
+ * @param params.limit - The maximum number of bars to return (optional).
+ * @param params.page_token - The token for pagination (optional).
+ * @param params.sort - The sorting order for the results (optional).
+ * @returns A promise that resolves to an object containing arrays of CryptoBar objects for each symbol.
+ */
+export declare function fetchBars(params: CryptoBarsParams): Promise<{
+    [symbol: string]: CryptoBar[];
+}>;
+type AlpacaAuth = {
+    APIKey: string;
+    APISecret: string;
+    type?: "PAPER" | "LIVE";
+};
+/**
+ * Fetches news articles related to a specific cryptocurrency symbol.
+ * This function retrieves news articles from the Alpaca API.
+ *
+ * @param params - The parameters for fetching news articles.
+ * @param params.symbol - The cryptocurrency symbol to fetch news for.
+ * @param params.start - The start date for fetching news (optional).
+ * @param params.sort - The sorting order for the results (optional).
+ * @param params.includeContent - Whether to include the full content of the articles (optional).
+ * @param params.limit - The maximum number of articles to return (optional).
+ * @param auth - The Alpaca authentication object containing API key and secret.
+ * @returns A promise that resolves to an array of AlpacaNewsArticle objects.
+ * @throws Will throw an error if required parameters are missing or if fetching fails.
+ */
+export declare function fetchNews(params: {
+    symbol: string;
+    start?: Date;
+    sort?: string;
+    includeContent?: boolean;
+    limit?: number;
+}, auth: AlpacaAuth): Promise<AlpacaNewsArticle[]>;
+/**
+ * Fetches the latest trades for the specified cryptocurrency symbols.
+ * This function retrieves the most recent trade price and volume for each symbol.
+ *
+ * @param params - The parameters for fetching latest trades.
+ * @param params.symbols - An array of cryptocurrency symbols to fetch data for (e.g., ['BTC-USD', 'ETH-USD']).
+ * @param params.loc - The location identifier (default: 'us'). Options: 'us' (Alpaca US), 'us-1' (Kraken US), 'eu-1' (Kraken EU).
+ * @param auth - The Alpaca authentication object containing API key and secret.
+ * @returns A promise that resolves to an object containing the latest trade for each symbol.
+ * @throws Will throw an error if required parameters are missing or if fetching fails.
+ */
+export declare function fetchLatestTrades(params: {
+    symbols: string[];
+    loc?: string;
+}, auth: AlpacaAuth): Promise<LatestTradesResponse>;
+/**
+ * Fetches the latest quotes (bid/ask prices) for the specified cryptocurrency symbols.
+ * This function retrieves the most recent bid and ask prices for each symbol.
+ *
+ * @param params - The parameters for fetching latest quotes.
+ * @param params.symbols - An array of cryptocurrency symbols to fetch data for (e.g., ['BTC-USD', 'ETH-USD']).
+ * @param params.loc - The location identifier (default: 'us'). Options: 'us' (Alpaca US), 'us-1' (Kraken US), 'eu-1' (Kraken EU).
+ * @param auth - The Alpaca authentication object containing API key and secret.
+ * @returns A promise that resolves to an object containing the latest quote for each symbol.
+ * @throws Will throw an error if required parameters are missing or if fetching fails.
+ */
+export declare function fetchLatestQuotes(params: {
+    symbols: string[];
+    loc?: string;
+}, auth: AlpacaAuth): Promise<LatestQuotesResponse>;
+export {};
+//# sourceMappingURL=crypto.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,24 @@
+import { LogOptions } from "./types/logging-types";
+export declare class DisplayManager {
+    private static instance;
+    private promptText;
+    private constructor();
+    static getInstance(): DisplayManager;
+    setPrompt(prompt: string): void;
+    /**
+     * Logs a message while preserving the prompt at the bottom
+     */
+    log(message: string, options?: LogOptions): void;
+    /**
+     * Writes a log entry to a symbol-specific log file
+     */
+    private writeSymbolLog;
+    /**
+     * Writes a log entry to a generic log file when no symbol is provided
+     */
+    private writeGenericLog;
+    private writePrompt;
+    clearPrompt(): void;
+    restorePrompt(): void;
+}
+//# sourceMappingURL=display-manager.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,36 @@
+/**
+ * Asset Allocation Algorithm - Example Usage
+ *
+ * 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<AllocationRecommendation>;
+/**
+ * Example 2: Aggressive Growth Portfolio for Young Investor
+ */
+export declare function aggressiveGrowthPortfolio(): Promise<AllocationRecommendation>;
+/**
+ * Example 3: Rebalancing an Existing Portfolio
+ */
+export declare function rebalancePortfolio(): Promise<AllocationRecommendation>;
+/**
+ * Example 4: Crisis Mode Allocation
+ */
+export declare function crisisModePortfolio(): Promise<AllocationRecommendation>;
+/**
+ * Example 5: Risk Parity Portfolio
+ */
+export declare function riskParityPortfolio(): Promise<AllocationRecommendation>;
+/**
+ * Example 6: Small Account Allocation
+ */
+export declare function smallAccountPortfolio(): Promise<AllocationRecommendation>;
+/**
+ * Run all examples
+ */
+export declare function runAllExamples(): Promise<void>;
+//# sourceMappingURL=asset-allocation-example.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,54 @@
+/**
+ * Capitalizes the first letter of a string
+ * @param {string} str - The string to capitalize
+ * @returns {string} The capitalized string, or original value if not a string
+ * @example
+ * capitalize('hello') // 'Hello'
+ * capitalize(123) // 123
+ */
+export declare function capitalize(str: string): string;
+/**
+ * Transforms enum formatting to human readable format (e.g. 'STOCK_TICKER' to 'Stock Ticker')
+ * @param {string} value - The enum string to format
+ * @returns {string} The formatted string, or empty string if no value provided
+ * @example
+ * formatEnum('STOCK_TICKER') // 'Stock Ticker'
+ */
+export declare function formatEnum(value: string): string;
+/**
+ * Formats a number as US currency
+ * @param {number} value - The number to format
+ * @returns {string} The formatted currency string (e.g. '$1,234.56')
+ * @example
+ * formatCurrency(1234.56) // '$1,234.56'
+ * formatCurrency(NaN) // '$0.00'
+ */
+export declare function formatCurrency(value: number): string;
+/**
+ * Formats a number with commas
+ * @param {number} value - The number to format
+ * @returns {string} The formatted number string (e.g. '1,234.56')
+ * @example
+ * formatNumber(1234.56) // '1,234.56'
+ * formatNumber(NaN) // '0'
+ */
+export declare function formatNumber(value: number): string;
+/**
+ * Formats a number as a percentage
+ * @param {number} value - The number to format (e.g. 0.75 for 75%)
+ * @param {number} [decimalPlaces=2] - Number of decimal places to show
+ * @returns {string} The formatted percentage string (e.g. '75.00%')
+ * @example
+ * formatPercentage(0.75) // '75.00%'
+ * formatPercentage(0.753, 1) // '75.3%'
+ */
+export declare function formatPercentage(value: number, decimalPlaces?: number): string;
+/**
+ * Formats a Date object to Australian datetime format for Google Sheets
+ * @param {Date} date - The date to format
+ * @returns {string} The formatted datetime string in 'DD/MM/YYYY HH:MM:SS' format
+ * @example
+ * dateTimeForGS(new Date('2025-01-01T12:34:56')) // '01/01/2025 12:34:56'
+ */
+export declare function dateTimeForGS(date: Date): string;
+//# sourceMappingURL=format-tools.d.ts.map

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

@@ -0,0 +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,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"}