@discomedia/utils 1.0.3

package/dist/types/llm-images.d.ts

@@ -0,0 +1,49 @@
+import { ImageGenerationOptions } from './types';
+import { ImageModel, ImagesResponse } from 'openai/resources/images';
+/**
+ * Enhanced ImagesResponse that includes cost calculation
+ */
+export interface ImageResponseWithUsage extends ImagesResponse {
+    usage?: ImagesResponse['usage'] & {
+        provider: string;
+        model: ImageModel;
+        cost: number;
+    };
+}
+/**
+ * Makes a call to the OpenAI Images API to generate images based on a text prompt.
+ *
+ * This function provides access to OpenAI's image generation capabilities with support for:
+ * - Different output formats (JPEG, PNG, WebP)
+ * - Various image sizes and quality settings
+ * - Multiple image generation in a single call
+ * - Base64 encoded image data return
+ *
+ * @example
+ * // Basic image generation
+ * const response = await makeImagesCall('A beautiful sunset over mountains');
+ *
+ * @example
+ * // Custom options
+ * const response = await makeImagesCall('A birthday cake', {
+ *   size: '1024x1024',
+ *   outputFormat: 'png',
+ *   quality: 'high',
+ *   count: 2
+ * });
+ *
+ * @param prompt - The text prompt describing the image to generate
+ * @param options - Configuration options for image generation. Includes:
+ * - size: Image dimensions (uses OpenAI's size options)
+ * - outputFormat: Image format ('jpeg', 'png', 'webp') - defaults to 'webp'
+ * - compression: Compression level (number) - defaults to 50
+ * - quality: Quality setting (uses OpenAI's quality options) - defaults to 'high'
+ * - count: Number of images to generate - defaults to 1
+ * - background: Background setting for transparency support
+ * - moderation: Content moderation level
+ * - apiKey: OpenAI API key (optional, falls back to environment variable)
+ * @returns Promise<ImageResponseWithUsage> - The image generation response with cost information
+ * @throws Error if the API call fails or invalid parameters are provided
+ */
+export declare function makeImagesCall(prompt: string, options?: ImageGenerationOptions): Promise<ImageResponseWithUsage>;
+//# sourceMappingURL=llm-images.d.ts.map

package/dist/types/llm-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-images.d.ts","sourceRoot":"","sources":["../../src/llm-images.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,EAAuB,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC5D,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,UAAU,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,sBAAsB,CAAC,CAmFjC"}

package/dist/types/llm-openai.d.ts

@@ -0,0 +1,64 @@
+import { Tool } from 'openai/resources/responses/responses';
+import { LLMResponse, LLMOptions, OpenAIModel } from './types';
+import { ResponseCreateParamsNonStreaming } from 'openai/resources/responses/responses';
+export declare const DEFAULT_OPTIONS: LLMOptions;
+/**
+ * Checks if the given model supports the temperature parameter. Reasoning models (o1*, o3*, o4*) do not support temperature.
+ * @param model The model to check.
+ * @returns True if the model supports the temperature parameter, false otherwise.
+ */
+export declare function supportsTemperature(model: string): boolean;
+/**
+ * Checks if the given model is a reasoning model. Reasoning models have different tool choice constraints.
+ * @param model The model to check.
+ * @returns True if the model is a reasoning model, false otherwise.
+ */
+export declare function isReasoningModel(model: string): boolean;
+/**
+ * Makes a call to OpenAI's Responses API for more advanced use cases with built-in tools.
+ *
+ * This function provides access to the Responses API which supports:
+ * - Built-in tools (web search, file search, computer use, code interpreter, image generation)
+ * - Background processing
+ * - Conversation state management
+ * - Reasoning support for o-series models
+ *
+ * @example
+ * // Basic text response
+ * const response = await makeResponsesAPICall('What is the weather like?');
+ *
+ * @example
+ * // With web search tool
+ * const response = await makeResponsesAPICall('Latest news about AI', {
+ *   tools: [{ type: 'web_search_preview' }]
+ * });
+ *
+ * @param input - The input content. Can be:
+ * - A string for simple text prompts
+ * - An array of input items for complex/multi-modal content
+ * @param options - Configuration options for the Responses API
+ * @returns Promise<LLMResponse<T>> - The response in the same format as makeLLMCall
+ * @throws Error if the API call fails
+ */
+export declare const makeResponsesAPICall: <T = any>(input: string | ResponseCreateParamsNonStreaming["input"], options?: Omit<ResponseCreateParamsNonStreaming, "input" | "model"> & {
+    apiKey?: string;
+    model?: string;
+}) => Promise<LLMResponse<T>>;
+/**
+ * Makes a call to the OpenAI Responses API for advanced use cases with built-in tools.
+ *
+ * @param input The text prompt to send to the model (e.g., "What's in this image?")
+ * @param options The options for the Responses API call, including optional image data.
+ * @return A promise that resolves to the response from the Responses API.
+ */
+export declare function makeLLMCall<T = any>(input: string, options?: {
+    apiKey?: string;
+    model?: OpenAIModel;
+    responseFormat?: 'text' | 'json';
+    tools?: Tool[];
+    useCodeInterpreter?: boolean;
+    useWebSearch?: boolean;
+    imageBase64?: string;
+    imageDetail?: 'low' | 'high' | 'auto';
+}): Promise<LLMResponse<T>>;
+//# sourceMappingURL=llm-openai.d.ts.map

package/dist/types/llm-openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-openai.d.ts","sourceRoot":"","sources":["../../src/llm-openai.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAiB,MAAM,sCAAsC,CAAC;AAK3E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAwB,MAAM,SAAS,CAAC;AACrF,OAAO,EACL,gCAAgC,EAOjC,MAAM,sCAAsC,CAAC;AAE9C,eAAO,MAAM,eAAe,EAAE,UAG7B,CAAC;AAkBF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,oBAAoB,GAAU,CAAC,GAAG,GAAG,EAChD,OAAO,MAAM,GAAG,gCAAgC,CAAC,OAAO,CAAC,EACzD,UAAS,IAAI,CAAC,gCAAgC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,KACL,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CA0HxB,CAAC;AAGF;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,GAAG,GAAG,EACvC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CAClC,GACL,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA6EzB"}

package/dist/types/llm-utils.d.ts

@@ -0,0 +1,16 @@
+import { OpenAIResponseFormat } from './types';
+export declare function normalizeModelName(model: string): string;
+export declare const CODE_BLOCK_TYPES: string[];
+/**
+ * Tries to parse JSON from the given content string according to the specified
+ * response format. If the response format is 'json' or a JSON schema object, it
+ * will attempt to parse the content using multiple strategies. If any of the
+ * strategies succeed, it will return the parsed JSON object. If all of them fail,
+ * it will throw an error.
+ *
+ * @param content The content string to parse
+ * @param responseFormat The desired format of the response
+ * @returns The parsed JSON object or null if it fails
+ */
+export declare function parseResponse<T>(content: string, responseFormat: OpenAIResponseFormat): Promise<T | null>;
+//# sourceMappingURL=llm-utils.d.ts.map

package/dist/types/llm-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-utils.d.ts","sourceRoot":"","sources":["../../src/llm-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,eAAO,MAAM,gBAAgB,UAAsF,CAAC;AAElH;;;;;;;;;;GAUG;AACL,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,oBAAoB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA+E/G"}

package/dist/types/logging.d.ts

@@ -0,0 +1,12 @@
+import { LogOptions } from './types/logging-types';
+/**
+ * Logs a message to the console.
+ * @param message The message to log.
+ * @param options Optional options.
+ * @param options.source The source of the message.
+ * @param options.type The type of message to log.
+ * @param options.symbol The trading symbol associated with this log.
+ * @param options.account The account associated with this log.
+ */
+export declare function log(message: string, options?: LogOptions): void;
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,UAA4C,GAAG,IAAI,CAoBhG"}

package/dist/types/market-hours.d.ts

@@ -0,0 +1,24 @@
+export interface HolidayDetails {
+    date: string;
+}
+export interface MarketHolidaysForYear {
+    [holidayName: string]: HolidayDetails;
+}
+export interface MarketHolidays {
+    [year: number]: MarketHolidaysForYear;
+}
+export interface EarlyCloseDetails {
+    date: string;
+    time: string;
+    optionsTime: string;
+    notes: string;
+}
+export interface EarlyClosesForYear {
+    [date: string]: EarlyCloseDetails;
+}
+export interface MarketEarlyCloses {
+    [year: number]: EarlyClosesForYear;
+}
+export declare const marketHolidays: MarketHolidays;
+export declare const marketEarlyCloses: MarketEarlyCloses;
+//# sourceMappingURL=market-hours.d.ts.map

package/dist/types/market-hours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-hours.d.ts","sourceRoot":"","sources":["../../src/market-hours.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACpC;AAED,eAAO,MAAM,cAAc,EAAE,cAsC5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAsE/B,CAAC"}

package/dist/types/market-time.d.ts

@@ -0,0 +1,184 @@
+import { IntradayReporting, PeriodDates, MarketTimeParams, MarketOpenCloseResult, MarketStatus, MarketTimesConfig } from './types/market-time-types';
+/**
+ * Market times for NYSE
+ * Regular market hours are 9:30am-4:00pm
+ * Early market hours are 9:30am-10:00am (first 30 minutes)
+ * Extended market hours are 4:00am to 9:30am and 4:00pm-8:00pm
+ * On days before some holidays, the market closes early at 1:00pm
+ * Early extended market hours are 1:00pm-5:00pm on early close days
+ */
+export declare const MARKET_TIMES: MarketTimesConfig;
+/**
+ * Utility class for handling market time-related operations
+ */
+export declare class MarketTimeUtil {
+    private timezone;
+    private intradayReporting;
+    /**
+     * Creates a new MarketTimeUtil instance
+     * @param {string} [timezone='America/New_York'] - The timezone to use for market time calculations
+     * @param {IntradayReporting} [intradayReporting='market_hours'] - The intraday reporting mode
+     */
+    constructor(timezone?: string, intradayReporting?: IntradayReporting);
+    /**
+     * Validates the provided timezone
+     * @private
+     * @param {string} timezone - The timezone to validate
+     * @throws {Error} If the timezone is invalid
+     */
+    private validateTimezone;
+    private formatDate;
+    private isWeekend;
+    private isHoliday;
+    isEarlyCloseDay(date: Date): boolean;
+    /**
+     * Get the early close time for a given date
+     * @param date - The date to get the early close time for
+     * @returns The early close time in minutes from midnight, or null if there is no early close
+     */
+    getEarlyCloseTime(date: Date): number | null;
+    /**
+     * Check if a given date is a market day
+     * @param date - The date to check
+     * @returns true if the date is a market day, false otherwise
+     */
+    isMarketDay(date: Date): boolean;
+    /**
+     * Check if a given date is within market hours
+     * @param date - The date to check
+     * @returns true if the date is within market hours, false otherwise
+     */
+    isWithinMarketHours(date: Date): boolean;
+    /**
+     * Check if a given date is before market hours
+     * @param date - The date to check
+     * @returns true if the date is before market hours, false otherwise
+     */
+    private isBeforeMarketHours;
+    /**
+     * Get the last trading date, i.e. the last date that was a market day
+     * @param currentDate - The current date
+     * @returns The last trading date
+     */
+    getLastTradingDate(currentDate?: Date): Date;
+    private getLastMarketDay;
+    getLastFullTradingDate(currentDate?: Date): Date;
+    /**
+     * Gets the next market day from a reference date
+     * @param {Object} [options] - Options object
+     * @param {Date} [options.referenceDate] - The reference date (defaults to current date)
+     * @returns {Object} The next market day information
+     * @property {Date} date - The date object (start of day in NY time)
+     * @property {string} yyyymmdd - The date in YYYY-MM-DD format
+     * @property {string} dateISOString - Full ISO date string
+     */
+    getNextMarketDay(date: Date): Date;
+    private getDayBoundaries;
+    private calculatePeriodStartDate;
+    getMarketTimePeriod({ period, end, intraday_reporting, outputFormat, }: MarketTimeParams): PeriodDates;
+    getMarketOpenClose(options?: {
+        date?: Date;
+    }): MarketOpenCloseResult;
+}
+/**
+ * Creates a new MarketTimeUtil instance
+ * @param {string} [timezone] - The timezone to use for market time calculations
+ * @param {IntradayReporting} [intraday_reporting] - The intraday reporting mode
+ * @returns {MarketTimeUtil} A new MarketTimeUtil instance
+ */
+export declare function createMarketTimeUtil(timezone?: string, intraday_reporting?: IntradayReporting): MarketTimeUtil;
+/**
+ * Gets start and end timestamps for a given market time period
+ * @param {MarketTimeParams} [params] - The market time parameters
+ * @returns {PeriodDates} The start and end timestamps
+ */
+export declare function getStartAndEndTimestamps(params?: MarketTimeParams): PeriodDates;
+/**
+ * Gets the market open/close times for a given date
+ * @param {Object} [options] - Options object
+ * @param {Date} [options.date] - The date to check (defaults to current date)
+ * @returns {MarketOpenCloseResult} The market open/close times
+ */
+export declare function getMarketOpenClose(options?: {
+    date?: Date;
+}): MarketOpenCloseResult;
+/**
+ * Gets the start and end dates for a given market time period
+ * @param {MarketTimeParams} [params] - The market time parameters
+ * @returns {Object} The start and end dates
+ * @property {Date} start - The start date
+ * @property {Date} end - The end date
+ */
+export declare function getStartAndEndDates(params?: MarketTimeParams): {
+    start: Date;
+    end: Date;
+};
+/**
+ * Gets the last trading date in YYYY-MM-DD format
+ * @returns {string} The last trading date in YYYY-MM-DD format
+ */
+export declare function getLastTradingDateYYYYMMDD(): string;
+/**
+ * Gets the last full trading date
+ * @param {Date} [currentDate] - The current date (defaults to now)
+ * @returns {Object} The last full trading date
+ * @property {Date} date - The date object
+ * @property {string} YYYYMMDD - The date in YYYY-MM-DD format
+ */
+export declare function getLastFullTradingDate(currentDate?: Date): {
+    date: Date;
+    YYYYMMDD: string;
+};
+/**
+ * Gets the next market day from a reference date
+ * @param {Object} [options] - Options object
+ * @param {Date} [options.referenceDate] - The reference date (defaults to current date)
+ * @returns {Object} The next market day information
+ * @property {Date} date - The date object (start of day in NY time)
+ * @property {string} yyyymmdd - The date in YYYY-MM-DD format
+ * @property {string} dateISOString - Full ISO date string
+ */
+export declare function getNextMarketDay({ referenceDate }?: {
+    referenceDate?: Date;
+}): {
+    date: Date;
+    yyyymmdd: string;
+    dateISOString: string;
+};
+/**
+ * Gets the current time in Eastern Time
+ * @returns {Date} The current time in Eastern Time
+ */
+export declare const currentTimeET: () => Date;
+/**
+ * Gets a date in New York timezone, rezoned using date-fns-tz
+ * @param {number|string|Date} time - The time to convert
+ * @returns {Date} The date in New York timezone
+ */
+export declare function getDateInNY(time: number | string | {
+    year: number;
+    month: number;
+    day: number;
+}): Date;
+/**
+ * Gets the trading date in YYYY-MM-DD format for New York timezone, for grouping of data
+ * @param {string|number|Date} time - The time to convert (string, unix timestamp in ms, or Date object)
+ * @returns {string} The trading date in YYYY-MM-DD format
+ */
+export declare function getTradingDate(time: string | number | Date): string;
+/**
+ * Returns the New York timezone offset based on whether daylight savings is active
+ * @param dateString - The date string to check
+ * @returns "-04:00" during daylight savings (EDT) or "-05:00" during standard time (EST)
+ */
+export declare const getNYTimeZone: (date?: Date) => "-04:00" | "-05:00";
+/**
+ * Gets the current market status
+ * @param {Object} [options] - Options object
+ * @param {Date} [options.date] - The date to check (defaults to current date)
+ * @returns {MarketStatus} The current market status
+ */
+export declare function getMarketStatus(options?: {
+    date?: Date;
+}): MarketStatus;
+//# sourceMappingURL=market-time.d.ts.map

package/dist/types/market-time.d.ts.map

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

package/dist/types/misc-utils.d.ts

@@ -0,0 +1,49 @@
+declare const LOG_TYPES: readonly ["info", "warn", "error", "debug", "trace"];
+type LogType = (typeof LOG_TYPES)[number];
+/**
+ * Debug logging utility that respects environment debug flags.
+ * Logs messages to the console based on the specified log level.
+ *
+ * @param message - The message to log.
+ * @param data - Optional data to log alongside the message. This can be any type of data.
+ * @param type - Log level. One of: 'info' | 'warn' | 'error' | 'debug' | 'trace'. Defaults to 'info'.
+ *
+ * @example
+ * logIfDebug("User login failed", { userId: 123 }, "error");
+ * logIfDebug("Cache miss", undefined, "warn");
+ * logIfDebug("Processing request", { requestId: "abc" }, "debug");
+ */
+export declare const logIfDebug: (message: string, data?: unknown, type?: LogType) => void;
+/**
+ * Hides (masks) the value of any query parameter that is "apiKey" (case-insensitive),
+ * replacing the middle part with **** and keeping only the first 2 and last 2 characters.
+ *
+ * @param url - The URL containing the query parameters.
+ * @returns The URL with the masked API key.
+ *
+ * @example
+ * hideApiKeyFromurl("https://xxx.com/s/23/fdsa/?apiKey=12341239856677");
+ * // Returns "https://xxx.com/s/23/fdsa/?apiKey=12****77"
+ */
+export declare function hideApiKeyFromurl(url: string): string;
+/**
+ * Fetches a resource with intelligent retry logic for handling transient errors.
+ * Features enhanced error logging, rate limit detection, and adaptive backoff.
+ *
+ * @param url - The URL to fetch.
+ * @param options - Optional fetch options.
+ * @param retries - The number of retry attempts. Defaults to 3.
+ * @param initialBackoff - The initial backoff time in milliseconds. Defaults to 1000.
+ * @returns A promise that resolves to the response.
+ *
+ * @throws Will throw an error if the fetch fails after the specified number of retries.
+ */
+export declare function fetchWithRetry(url: string, options?: RequestInit, retries?: number, initialBackoff?: number): Promise<Response>;
+/**
+ * Validates a Polygon.io API key by making a test request.
+ * @param apiKey - The API key to validate.
+ * @returns Promise that resolves to true if valid, false otherwise.
+ */
+export declare function validatePolygonApiKey(apiKey: string): Promise<boolean>;
+export {};
+//# sourceMappingURL=misc-utils.d.ts.map

package/dist/types/misc-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc-utils.d.ts","sourceRoot":"","sources":["../../src/misc-utils.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,SAAS,sDAAuD,CAAC;AAEvE,KAAK,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,OAAO,OAAO,EAAE,OAAM,OAAgB,SAqBjF,CAAC;AAqBF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBrD;AAyCD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,WAAgB,EACzB,OAAO,GAAE,MAAU,EACnB,cAAc,GAAE,MAAa,GAC5B,OAAO,CAAC,QAAQ,CAAC,CA2FnB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAe5E"}

package/dist/types/polygon-indices.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Polygon Indices API Implementation
+ *
+ * This module provides functions to interact with the Polygon.io Indices API.
+ */
+import { PolygonIndicesAggregatesParams, PolygonIndicesAggregatesResponse, PolygonIndicesPrevCloseResponse, PolygonIndicesDailyOpenCloseResponse, PolygonIndicesSnapshotParams, PolygonIndicesSnapshotResponse } from './types';
+/**
+ * Fetches aggregate bars for an index over a given date range in custom time window sizes.
+ *
+ * @param {PolygonIndicesAggregatesParams} params - Parameters for the aggregates request
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.apiKey] - API key to use for the request
+ * @returns {Promise<PolygonIndicesAggregatesResponse>} The aggregates response
+ */
+export declare const fetchIndicesAggregates: (params: PolygonIndicesAggregatesParams, options?: {
+    apiKey?: string;
+}) => Promise<PolygonIndicesAggregatesResponse>;
+/**
+ * Gets the previous day's open, high, low, and close (OHLC) for the specified index.
+ *
+ * @param {string} indicesTicker - The ticker symbol of the index
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.apiKey] - API key to use for the request
+ * @returns {Promise<PolygonIndicesPrevCloseResponse>} The previous close response
+ */
+export declare const fetchIndicesPreviousClose: (indicesTicker: string, options?: {
+    apiKey?: string;
+}) => Promise<PolygonIndicesPrevCloseResponse>;
+/**
+ * Gets the open, close and afterhours values of an index symbol on a certain date.
+ *
+ * @param {string} indicesTicker - The ticker symbol of the index
+ * @param {string} date - The date in YYYY-MM-DD format
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.apiKey] - API key to use for the request
+ * @returns {Promise<PolygonIndicesDailyOpenCloseResponse>} The daily open/close response
+ */
+export declare const fetchIndicesDailyOpenClose: (indicesTicker: string, date: string, options?: {
+    apiKey?: string;
+}) => Promise<PolygonIndicesDailyOpenCloseResponse>;
+/**
+ * Gets a snapshot of indices data for specified tickers.
+ *
+ * @param {PolygonIndicesSnapshotParams} [params] - Parameters for the snapshot request
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.apiKey] - API key to use for the request
+ * @returns {Promise<PolygonIndicesSnapshotResponse>} The indices snapshot response
+ */
+export declare const fetchIndicesSnapshot: (params?: PolygonIndicesSnapshotParams, options?: {
+    apiKey?: string;
+}) => Promise<PolygonIndicesSnapshotResponse>;
+/**
+ * Gets snapshots for assets of all types, including indices.
+ *
+ * @param {string[]} tickers - Array of tickers to fetch snapshots for
+ * @param {Object} [options] - Optional parameters
+ * @param {string} [options.apiKey] - API key to use for the request
+ * @param {string} [options.type] - Filter by asset type
+ * @param {string} [options.order] - Order results
+ * @param {number} [options.limit] - Limit the number of results
+ * @param {string} [options.sort] - Sort field
+ * @returns {Promise<any>} The universal snapshot response
+ */
+export declare const fetchUniversalSnapshot: (tickers: string[], options?: {
+    apiKey?: string;
+    type?: string;
+    order?: string;
+    limit?: number;
+    sort?: string;
+}) => Promise<any>;
+/**
+ * Converts Polygon Indices bar data to a more standardized format
+ *
+ * @param {PolygonIndicesAggregatesResponse} data - The raw aggregates response
+ * @returns {Array<{date: string, open: number, high: number, low: number, close: number, timestamp: number}>} Formatted bar data
+ */
+export declare const formatIndicesBarData: (data: PolygonIndicesAggregatesResponse) => Array<{
+    date: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    timestamp: number;
+}>;
+//# sourceMappingURL=polygon-indices.d.ts.map

package/dist/types/polygon-indices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon-indices.d.ts","sourceRoot":"","sources":["../../src/polygon-indices.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,EAChC,+BAA+B,EAC/B,oCAAoC,EACpC,4BAA4B,EAC5B,8BAA8B,EAE/B,MAAM,SAAS,CAAC;AAyBjB;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,8BAA8B,EACtC,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAC5B,OAAO,CAAC,gCAAgC,CAuC1C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACpC,eAAe,MAAM,EACrB,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAC5B,OAAO,CAAC,+BAA+B,CAyBzC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACrC,eAAe,MAAM,EACrB,MAAM,MAAM,EACZ,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAC5B,OAAO,CAAC,oCAAoC,CAyB9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,4BAA4B,EACrC,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAC5B,OAAO,CAAC,8BAA8B,CAyCxC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,EAAE,EACjB,UAAU;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KACA,OAAO,CAAC,GAAG,CA6Cb,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,gCAAgC,KACrC,KAAK,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAYA,CAAC"}

package/dist/types/polygon.d.ts

@@ -0,0 +1,126 @@
+/**********************************************************************************
+ * Polygon.io calls
+ **********************************************************************************/
+import { PolygonQuote, PolygonPriceData, PolygonGroupedDailyResponse, PolygonTickerInfo, PolygonDailyOpenClose, PolygonTradesResponse } from './types';
+/**
+ * Fetches general information about a stock ticker.
+ * @param {string} symbol - The stock ticker symbol to fetch information for.
+ * @param {Object} [options] - Optional parameters.
+ * @param {string} [options.apiKey] - The API key to use for the request.
+ * @returns {Promise<PolygonTickerInfo | null>} The ticker information or null if not found.
+ */
+export declare const fetchTickerInfo: (symbol: string, options?: {
+    apiKey?: string;
+}) => Promise<PolygonTickerInfo | null>;
+/**
+ * Fetches the last trade for a given stock ticker.
+ * @param {string} symbol - The stock ticker symbol to fetch the last trade for.
+ * @param {Object} [options] - Optional parameters.
+ * @param {string} [options.apiKey] - The API key to use for the request.
+ * @returns {Promise<PolygonQuote>} The last trade information.
+ */
+export declare const fetchLastTrade: (symbol: string, options?: {
+    apiKey?: string;
+}) => Promise<PolygonQuote>;
+/**
+ * Fetches price data for a given stock ticker.
+ * @param {Object} params - The parameters for fetching price data.
+ * @param {string} params.ticker - The stock ticker symbol.
+ * @param {number} params.start - The start timestamp for fetching price data.
+ * @param {number} [params.end] - The end timestamp for fetching price data.
+ * @param {number} params.multiplier - The multiplier for the price data.
+ * @param {string} params.timespan - The timespan for the price data.
+ * @param {number} [params.limit] - The maximum number of price data points to fetch.
+ * @param {Object} [options] - Optional parameters.
+ * @param {string} [options.apiKey] - The API key to use for the request.
+ * @returns {Promise<PolygonPriceData[]>} The fetched price data.
+ */
+export declare const fetchPrices: (params: {
+    ticker: string;
+    start: number;
+    end?: number;
+    multiplier: number;
+    timespan: string;
+    limit?: number;
+}, options?: {
+    apiKey?: string;
+}) => Promise<PolygonPriceData[]>;
+/**
+ * Analyzes the price data for a given stock.
+ * @param {PolygonPriceData[]} priceData - The price data to analyze.
+ * @returns {string} The analysis report.
+ */
+export declare function analysePolygonPriceData(priceData: PolygonPriceData[]): string;
+/**
+ * Fetches grouped daily price data for a specific date.
+ * @param {string} date - The date to fetch grouped daily data for.
+ * @param {Object} [options] - Optional parameters.
+ * @param {string} [options.apiKey] - The API key to use for the request.
+ * @param {boolean} [options.adjusted] - Whether to adjust the data.
+ * @param {boolean} [options.includeOTC] - Whether to include OTC data.
+ * @returns {Promise<PolygonGroupedDailyResponse>} The grouped daily response.
+ */
+export declare const fetchGroupedDaily: (date: string, options?: {
+    apiKey?: string;
+    adjusted?: boolean;
+    includeOTC?: boolean;
+}) => Promise<PolygonGroupedDailyResponse>;
+/**
+ * Formats the price data into a readable string.
+ * @param {PolygonPriceData[]} priceData - The price data to format.
+ * @returns {string} The formatted price data.
+ */
+export declare function formatPriceData(priceData: PolygonPriceData[]): string;
+export declare const fetchDailyOpenClose: (
+/**
+ * Fetches the daily open and close data for a given stock ticker.
+ * @param {string} symbol - The stock ticker symbol to fetch data for.
+ * @param {Date} [date=new Date()] - The date to fetch data for.
+ * @param {Object} [options] - Optional parameters.
+ * @param {string} [options.apiKey] - The API key to use for the request.
+ * @param {boolean} [options.adjusted] - Whether to adjust the data.
+ * @returns {Promise<PolygonDailyOpenClose>} The daily open and close data.
+ */
+symbol: string, date?: Date, options?: {
+    apiKey?: string;
+    adjusted?: boolean;
+}) => Promise<PolygonDailyOpenClose>;
+/**
+ * Gets the previous close price for a given stock ticker.
+ * @param {string} symbol - The stock ticker symbol to fetch the previous close for.
+ * @param {Date} [referenceDate] - The reference date to use for fetching the previous close.
+ * @returns {Promise<{ close: number; date: Date }>} The previous close price and date.
+ */
+export declare function getPreviousClose(symbol: string, referenceDate?: Date, options?: {
+    apiKey?: string;
+}): Promise<{
+    close: number;
+    date: Date;
+}>;
+/**
+ * Fetches trade data for a given stock ticker.
+ * @param {string} symbol - The stock ticker symbol to fetch trades for.
+ * @param {Object} [options] - Optional parameters.
+ * @param {string} [options.apiKey] - The API key to use for the request.
+ * @param {string | number} [options.timestamp] - The timestamp for fetching trades.
+ * @param {string | number} [options.timestampgt] - Greater than timestamp for fetching trades.
+ * @param {string | number} [options.timestampgte] - Greater than or equal to timestamp for fetching trades.
+ * @param {string | number} [options.timestamplt] - Less than timestamp for fetching trades.
+ * @param {string | number} [options.timestamplte] - Less than or equal to timestamp for fetching trades.
+ * @param {'asc' | 'desc'} [options.order] - The order of the trades.
+ * @param {number} [options.limit] - The maximum number of trades to fetch.
+ * @param {string} [options.sort] - The sort order for the trades.
+ * @returns {Promise<PolygonTradesResponse>} The fetched trades response.
+ */
+export declare const fetchTrades: (symbol: string, options?: {
+    apiKey?: string;
+    timestamp?: string | number;
+    timestampgt?: string | number;
+    timestampgte?: string | number;
+    timestamplt?: string | number;
+    timestamplte?: string | number;
+    order?: "asc" | "desc";
+    limit?: number;
+    sort?: string;
+}) => Promise<PolygonTradesResponse>;
+//# sourceMappingURL=polygon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../src/polygon.ts"],"names":[],"mappings":"AAAA;;oFAEoF;AAGpF,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,2BAA2B,EAE3B,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAYjB;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,GAC1B,QAAQ,MAAM,EACd,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAC5B,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAoFlC,CAAC;AAGF;;;;;;GAMG;AAEH,eAAO,MAAM,cAAc,GAAU,QAAQ,MAAM,EAAE,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,YAAY,CAkDxG,CAAC;AAGF;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,WAAW,GACtB,QAAQ;IACN,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,UAAU;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAC5B,OAAO,CAAC,gBAAgB,EAAE,CAiF5B,CAAC;AAEF;;;;GAIG;AAEH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAsC7E;AAID;;;;;;;;GAQG;AAEH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,UAAU;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,KACA,OAAO,CAAC,2BAA2B,CA6DrC,CAAC;AAEF;;;;GAIG;AAEH,wBAAgB,eAAe,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAkBrE;AAED,eAAO,MAAM,mBAAmB;AAC9B;;;;;;;;GAQG;AAEH,QAAQ,MAAM,EACd,OAAM,IAAiB,EACvB,UAAU;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,KACA,OAAO,CAAC,qBAAqB,CAsB/B,CAAC;AAIF;;;;;GAKG;AAEH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,IAAI,EACpB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAUxC;AAED;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,UAAU;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KACA,OAAO,CAAC,qBAAqB,CAuD/B,CAAC"}