@adaptic/utils 0.0.359

package/dist/types/alpaca-trading-api.d.ts

@@ -0,0 +1,315 @@
+import { AlpacaAccountDetails, AlpacaCredentials, AlpacaPosition, AssetClass, GetOptionContractsParams, GetOrdersParams, OptionAccountActivity, OptionContract, OptionContractsResponse, AlpacaOrder, OrderLeg, TradeUpdate } from './types/alpaca-types';
+/**
+Websocket example
+  const alpacaAPI = createAlpacaTradingAPI(credentials); // type AlpacaCredentials
+  alpacaAPI.onTradeUpdate((update: TradeUpdate) => {
+   this.log(`Received trade update: event ${update.event} for an order to ${update.order.side} ${update.order.qty} of ${update.order.symbol}`);
+  });
+  alpacaAPI.connectWebsocket(); // necessary to connect to the WebSocket
+*/
+export declare class AlpacaTradingAPI {
+    static new(credentials: AlpacaCredentials): AlpacaTradingAPI;
+    static getInstance(credentials: AlpacaCredentials): AlpacaTradingAPI;
+    private ws;
+    private headers;
+    private tradeUpdateCallback;
+    private credentials;
+    private apiBaseUrl;
+    private wsUrl;
+    private authenticated;
+    private connecting;
+    private reconnectDelay;
+    private reconnectTimeout;
+    private messageHandlers;
+    private debugLogging;
+    /**
+     * Constructor for AlpacaTradingAPI
+     * @param credentials - Alpaca credentials,
+     *   accountName: string; // The account identifier used inthis.logs and tracking
+     *   apiKey: string; // Alpaca API key
+     *   apiSecret: string; // Alpaca API secret
+     *   type: AlpacaAccountType;
+     *   orderType: AlpacaOrderType;
+     * @param options - Optional options
+     *   debugLogging: boolean; // Whether to log messages of type 'debug'
+     */
+    constructor(credentials: AlpacaCredentials, options?: {
+        debugLogging?: boolean;
+    });
+    private log;
+    /**
+     * Round a price to the nearest 2 decimal places for Alpaca, or 4 decimal places for prices less than $1
+     * @param price - The price to round
+     * @returns The rounded price
+     */
+    private roundPriceForAlpaca;
+    private handleAuthMessage;
+    private handleListenMessage;
+    private handleTradeUpdate;
+    private handleMessage;
+    connectWebsocket(): void;
+    private authenticate;
+    private subscribeToTradeUpdates;
+    private makeRequest;
+    getPositions(assetClass?: AssetClass): Promise<AlpacaPosition[]>;
+    /**
+     * Get all orders
+     * @param params (GetOrdersParams) - optional parameters to filter the orders
+     * - status: 'open' | 'closed' | 'all'
+     * - limit: number
+     * - after: string
+     * - until: string
+     * - direction: 'asc' | 'desc'
+     * - nested: boolean
+     * - symbols: string[], an array of all the symbols
+     * - side: 'buy' | 'sell'
+     * @returns all orders
+     */
+    getOrders(params?: GetOrdersParams): Promise<AlpacaOrder[]>;
+    getAccountDetails(): Promise<AlpacaAccountDetails>;
+    /**
+     * Create a trailing stop order
+     * @param symbol (string) - the symbol of the order
+     * @param qty (number) - the quantity of the order
+     * @param side (string) - the side of the order
+     * @param trailPercent100 (number) - the trail percent of the order (scale 100, i.e. 0.5 = 0.5%)
+     * @param position_intent (string) - the position intent of the order
+     */
+    createTrailingStop(symbol: string, qty: number, side: 'buy' | 'sell', trailPercent100: number, position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close'): Promise<void>;
+    /**
+     * Create a market order
+     * @param symbol (string) - the symbol of the order
+     * @param qty (number) - the quantity of the order
+     * @param side (string) - the side of the order
+     * @param position_intent (string) - the position intent of the order. Important for knowing if a position needs a trailing stop.
+     */
+    createMarketOrder(symbol: string, qty: number, side: 'buy' | 'sell', position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close', client_order_id?: string): Promise<AlpacaOrder>;
+    /**
+     * Get the current trail percent for a symbol, assuming that it has an open position and a trailing stop order to close it. Because this relies on an orders request for one symbol, you can't do it too often.
+     * @param symbol (string) - the symbol of the order
+     * @returns the current trail percent
+     */
+    getCurrentTrailPercent(symbol: string): Promise<number | null>;
+    /**
+     * Update the trail percent for a trailing stop order
+     * @param symbol (string) - the symbol of the order
+     * @param trailPercent100 (number) - the trail percent of the order (scale 100, i.e. 0.5 = 0.5%)
+     */
+    updateTrailingStop(symbol: string, trailPercent100: number): Promise<void>;
+    /**
+     * Cancel all open orders
+     */
+    cancelAllOrders(): Promise<void>;
+    /**
+     * Cancel a specific order by its ID
+     * @param orderId The id of the order to cancel
+     * @throws Error if the order is not cancelable (status 422) or if the order doesn't exist
+     * @returns Promise that resolves when the order is successfully canceled
+     */
+    cancelOrder(orderId: string): Promise<void>;
+    /**
+     * Create a limit order
+     * @param symbol (string) - the symbol of the order
+     * @param qty (number) - the quantity of the order
+     * @param side (string) - the side of the order
+     * @param limitPrice (number) - the limit price of the order
+     * @param position_intent (string) - the position intent of the order
+     * @param extended_hours (boolean) - whether the order is in extended hours
+     * @param client_order_id (string) - the client order id of the order
+     */
+    createLimitOrder(symbol: string, qty: number, side: 'buy' | 'sell', limitPrice: number, position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close', extended_hours?: boolean, client_order_id?: string): Promise<AlpacaOrder>;
+    /**
+     * Close all equities positions
+     * @param options (object) - the options for closing the positions
+     * - cancel_orders (boolean) - whether to cancel related orders
+     * - useLimitOrders (boolean) - whether to use limit orders to close the positions
+     */
+    closeAllPositions(options?: {
+        cancel_orders: boolean;
+        useLimitOrders: boolean;
+    }): Promise<void>;
+    /**
+     * Close all equities positions using limit orders during extended hours trading
+     * @param cancelOrders Whether to cancel related orders (default: true)
+     * @returns Promise that resolves when all positions are closed
+     */
+    closeAllPositionsAfterHours(): Promise<void>;
+    onTradeUpdate(callback: (update: TradeUpdate) => void): void;
+    /**
+     * Get portfolio history for the account
+     * @param params Parameters for the portfolio history request
+     * @returns Portfolio history data
+     */
+    getPortfolioHistory(params: {
+        timeframe?: '1Min' | '5Min' | '15Min' | '1H' | '1D';
+        period?: string;
+        extended_hours?: boolean;
+        date_end?: string;
+    }): Promise<{
+        timestamp: number[];
+        equity: number[];
+        profit_loss: number[];
+        profit_loss_pct: number[];
+        base_value: number;
+        timeframe: string;
+    }>;
+    /**
+     * Get option contracts based on specified parameters
+     * @param params Parameters to filter option contracts
+     * @returns Option contracts matching the criteria
+     */
+    getOptionContracts(params: GetOptionContractsParams): Promise<OptionContractsResponse>;
+    /**
+     * Get a specific option contract by symbol or ID
+     * @param symbolOrId The symbol or ID of the option contract
+     * @returns The option contract details
+     */
+    getOptionContract(symbolOrId: string): Promise<OptionContract>;
+    /**
+     * Create a simple option order (market or limit)
+     * @param symbol Option contract symbol
+     * @param qty Quantity of contracts (must be a whole number)
+     * @param side Buy or sell
+     * @param position_intent Position intent (buy_to_open, buy_to_close, sell_to_open, sell_to_close)
+     * @param type Order type (market or limit)
+     * @param limitPrice Limit price (required for limit orders)
+     * @returns The created order
+     */
+    createOptionOrder(symbol: string, qty: number, side: 'buy' | 'sell', position_intent: 'buy_to_open' | 'buy_to_close' | 'sell_to_open' | 'sell_to_close', type: 'market' | 'limit', limitPrice?: number): Promise<AlpacaOrder>;
+    /**
+     * Create a multi-leg option order
+     * @param legs Array of order legs
+     * @param qty Quantity of the multi-leg order (must be a whole number)
+     * @param type Order type (market or limit)
+     * @param limitPrice Limit price (required for limit orders)
+     * @returns The created multi-leg order
+     */
+    createMultiLegOptionOrder(legs: OrderLeg[], qty: number, type: 'market' | 'limit', limitPrice?: number): Promise<AlpacaOrder>;
+    /**
+     * Exercise an option contract
+     * @param symbolOrContractId The symbol or ID of the option contract to exercise
+     * @returns Response from the exercise request
+     */
+    exerciseOption(symbolOrContractId: string): Promise<any>;
+    /**
+     * Get option positions
+     * @returns Array of option positions
+     */
+    getOptionPositions(): Promise<AlpacaPosition[]>;
+    getOptionsOpenSpreadTrades(): Promise<void>;
+    /**
+     * Get option account activities (exercises, assignments, expirations)
+     * @param activityType Type of option activity to filter by
+     * @param date Date to filter activities (YYYY-MM-DD format)
+     * @returns Array of option account activities
+     */
+    getOptionActivities(activityType?: 'OPEXC' | 'OPASN' | 'OPEXP', date?: string): Promise<OptionAccountActivity[]>;
+    /**
+     * Create a long call spread (buy lower strike call, sell higher strike call)
+     * @param lowerStrikeCallSymbol Symbol of the lower strike call option
+     * @param higherStrikeCallSymbol Symbol of the higher strike call option
+     * @param qty Quantity of spreads to create (must be a whole number)
+     * @param limitPrice Limit price for the spread
+     * @returns The created multi-leg order
+     */
+    createLongCallSpread(lowerStrikeCallSymbol: string, higherStrikeCallSymbol: string, qty: number, limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Create a long put spread (buy higher strike put, sell lower strike put)
+     * @param higherStrikePutSymbol Symbol of the higher strike put option
+     * @param lowerStrikePutSymbol Symbol of the lower strike put option
+     * @param qty Quantity of spreads to create (must be a whole number)
+     * @param limitPrice Limit price for the spread
+     * @returns The created multi-leg order
+     */
+    createLongPutSpread(higherStrikePutSymbol: string, lowerStrikePutSymbol: string, qty: number, limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Create an iron condor (sell call spread and put spread)
+     * @param longPutSymbol Symbol of the lower strike put (long)
+     * @param shortPutSymbol Symbol of the higher strike put (short)
+     * @param shortCallSymbol Symbol of the lower strike call (short)
+     * @param longCallSymbol Symbol of the higher strike call (long)
+     * @param qty Quantity of iron condors to create (must be a whole number)
+     * @param limitPrice Limit price for the iron condor (credit)
+     * @returns The created multi-leg order
+     */
+    createIronCondor(longPutSymbol: string, shortPutSymbol: string, shortCallSymbol: string, longCallSymbol: string, qty: number, limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Create a covered call (sell call option against owned stock)
+     * @param stockSymbol Symbol of the underlying stock
+     * @param callOptionSymbol Symbol of the call option to sell
+     * @param qty Quantity of covered calls to create (must be a whole number)
+     * @param limitPrice Limit price for the call option
+     * @returns The created order
+     */
+    createCoveredCall(stockSymbol: string, callOptionSymbol: string, qty: number, limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Roll an option position to a new expiration or strike
+     * @param currentOptionSymbol Symbol of the current option position
+     * @param newOptionSymbol Symbol of the new option to roll to
+     * @param qty Quantity of options to roll (must be a whole number)
+     * @param currentPositionSide Side of the current position ('buy' or 'sell')
+     * @param limitPrice Net limit price for the roll
+     * @returns The created multi-leg order
+     */
+    rollOptionPosition(currentOptionSymbol: string, newOptionSymbol: string, qty: number, currentPositionSide: 'buy' | 'sell', limitPrice: number): Promise<AlpacaOrder>;
+    /**
+     * Get option chain for a specific underlying symbol and expiration date
+     * @param underlyingSymbol The underlying stock symbol
+     * @param expirationDate The expiration date (YYYY-MM-DD format)
+     * @returns Option contracts for the specified symbol and expiration date
+     */
+    getOptionChain(underlyingSymbol: string, expirationDate: string): Promise<OptionContract[]>;
+    /**
+     * Get all available expiration dates for a specific underlying symbol
+     * @param underlyingSymbol The underlying stock symbol
+     * @returns Array of available expiration dates
+     */
+    getOptionExpirationDates(underlyingSymbol: string): Promise<string[]>;
+    /**
+     * Get the current options trading level for the account
+     * @returns The options trading level (0-3)
+     */
+    getOptionsTradingLevel(): Promise<number>;
+    /**
+     * Check if the account has options trading enabled
+     * @returns Boolean indicating if options trading is enabled
+     */
+    isOptionsEnabled(): Promise<boolean>;
+    /**
+     * Close all option positions
+     * @param cancelOrders Whether to cancel related orders (default: true)
+     * @returns Response from the close positions request
+     */
+    closeAllOptionPositions(cancelOrders?: boolean): Promise<void>;
+    /**
+     * Close a specific option position
+     * @param symbol The option contract symbol
+     * @param qty Optional quantity to close (defaults to entire position)
+     * @returns The created order
+     */
+    closeOptionPosition(symbol: string, qty?: number): Promise<AlpacaOrder>;
+    /**
+     * Create a complete equities trade with optional stop loss and take profit
+     * @param params Trade parameters including symbol, qty, side, and optional referencePrice
+     * @param options Trade options including order type, extended hours, stop loss, and take profit settings
+     * @returns The created order
+     */
+    createEquitiesTrade(params: {
+        symbol: string;
+        qty: number;
+        side: 'buy' | 'sell';
+        referencePrice?: number;
+    }, options?: {
+        type?: 'market' | 'limit';
+        limitPrice?: number;
+        extendedHours?: boolean;
+        useStopLoss?: boolean;
+        stopPrice?: number;
+        stopPercent100?: number;
+        useTakeProfit?: boolean;
+        takeProfitPrice?: number;
+        takeProfitPercent100?: number;
+        clientOrderId?: string;
+    }): Promise<AlpacaOrder>;
+}
+//# sourceMappingURL=alpaca-trading-api.d.ts.map

package/dist/types/alpaca-trading-api.d.ts.map

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

package/dist/types/alphavantage.d.ts

@@ -0,0 +1,44 @@
+/**********************************************************************************
+ * AlphaVantage calls
+ **********************************************************************************/
+import { AlphaVantageQuoteResponse, AVNewsArticle } from './types';
+/**
+ * Fetches the current quote for a given ticker symbol.
+ * @param {string} ticker - The ticker symbol to fetch the quote for.
+ * @param {Object} [options] - Optional parameters.
+ * @param {string} [options.apiKey] - The API key to use for the request.
+ * @returns {Promise<AlphaVantageQuoteResponse>} The current quote response.
+ */
+export declare const fetchQuote: (ticker: string, options?: {
+    apiKey?: string;
+}) => Promise<AlphaVantageQuoteResponse>;
+/**
+ * Converts a Date object to a string in the format YYYYMMDDTHHMM.
+ * @param {Date} date - The date to convert.
+ * @returns {string} The formatted date string.
+ */
+export declare function convertDateToYYYYMMDDTHHMM(date: Date): string;
+/**
+ * Converts a string in the format YYYYMMDDTHHMMSS to a Date object.
+ * @param {string} dateString - The date string to convert.
+ * @returns {Date} The corresponding Date object.
+ */
+export declare function convertYYYYMMDDTHHMMSSToDate(dateString: string): Date;
+/**
+ * Fetches news articles from AlphaVantage for a given ticker symbol. Performs filtering as the API endpoint doesn't respect the parameters.
+ * @param {string} ticker - The ticker symbol to fetch news for.
+ * @param {Object} [options] - Optional parameters.
+ * @param {Date} [options.start] - The start date for fetching news.
+ * @param {Date} [options.end] - The end date for fetching news.
+ * @param {number} [options.limit] - The maximum number of news articles to fetch.
+ * @param {string} [options.apiKey] - The API key to use for the request.
+ * @returns {Promise<AVNewsArticle[]>} The fetched news articles.
+ */
+export declare const fetchTickerNews: (ticker: string, options?: {
+    start?: Date;
+    end?: Date;
+    limit?: number;
+    apiKey?: string;
+    sort?: "LATEST" | "EARLIEST" | "RELEVANCE";
+}) => Promise<AVNewsArticle[]>;
+//# sourceMappingURL=alphavantage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alphavantage.d.ts","sourceRoot":"","sources":["../../src/alphavantage.ts"],"names":[],"mappings":"AAAA;;oFAEoF;AAEpF,OAAO,EAAE,yBAAyB,EAAkB,aAAa,EAAE,MAAM,SAAS,CAAC;AAmBnF;;;;;;GAMG;AAEH,eAAO,MAAM,UAAU,GAAU,QAAQ,MAAM,EAAE,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,yBAAyB,CAajH,CAAC;AAEF;;;;GAIG;AAEH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAU7D;AAED;;;;GAIG;AAEH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CASrE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,MAAM,EACd,UAAS;IAAE,KAAK,CAAC,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAA;CAK/G,KACA,OAAO,CAAC,aAAa,EAAE,CAgDzB,CAAC"}

package/dist/types/crypto.d.ts

@@ -0,0 +1,46 @@
+import type { CryptoBarsParams, CryptoBar, AlpacaNewsArticle } 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[]>;
+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,EAAE,gBAAgB,EAAsB,SAAS,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKlH;;;;;;;;;;;;;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"}

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;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"}

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,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,GAAE,MAAU,GAAG,MAAM,CAQjF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAYhD"}