@discomedia/utils 1.0.6 → 1.0.7

package/dist/types-frontend/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-frontend/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-frontend/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-frontend/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-frontend/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-frontend/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-frontend/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-frontend/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-frontend/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-frontend/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-frontend/market-time.d.ts

@@ -0,0 +1,254 @@
+import { Period, IntradayReporting, PeriodDates, MarketTimeParams, OutputFormat, MarketOpenCloseResult, MarketStatus, MarketTimesConfig } from './types/market-time-types';
+/**
+ * Market configuration constants
+ */
+export declare const MARKET_CONFIG: {
+    readonly TIMEZONE: "America/New_York";
+    readonly TIMES: {
+        readonly EXTENDED_START: {
+            readonly hour: 4;
+            readonly minute: 0;
+        };
+        readonly MARKET_OPEN: {
+            readonly hour: 9;
+            readonly minute: 30;
+        };
+        readonly EARLY_MARKET_END: {
+            readonly hour: 10;
+            readonly minute: 0;
+        };
+        readonly MARKET_CLOSE: {
+            readonly hour: 16;
+            readonly minute: 0;
+        };
+        readonly EARLY_CLOSE: {
+            readonly hour: 13;
+            readonly minute: 0;
+        };
+        readonly EXTENDED_END: {
+            readonly hour: 20;
+            readonly minute: 0;
+        };
+        readonly EARLY_EXTENDED_END: {
+            readonly hour: 17;
+            readonly minute: 0;
+        };
+    };
+};
+/**
+ * Service for handling market calendar operations (holidays, early closes, market days)
+ */
+export declare class MarketCalendar {
+    private timezone;
+    constructor(timezone?: string);
+    /**
+     * Check if a date is a weekend
+     */
+    isWeekend(date: Date): boolean;
+    /**
+     * Check if a date is a market holiday
+     */
+    isHoliday(date: Date): boolean;
+    /**
+     * Check if a date is an early close day
+     */
+    isEarlyCloseDay(date: Date): boolean;
+    /**
+     * Get the early close time for a date (in minutes from midnight)
+     */
+    getEarlyCloseTime(date: Date): number | null;
+    /**
+     * Check if a date is a market day (not weekend or holiday)
+     */
+    isMarketDay(date: Date): boolean;
+    /**
+     * Get the next market day from a given date
+     */
+    getNextMarketDay(date: Date): Date;
+    /**
+     * Get the previous market day from a given date
+     */
+    getPreviousMarketDay(date: Date): Date;
+}
+/**
+ * Service for formatting time outputs
+ */
+export declare class TimeFormatter {
+    private timezone;
+    constructor(timezone?: string);
+    /**
+     * Format a date based on the output format
+     */
+    formatDate(date: Date, outputFormat?: OutputFormat): string | number;
+    /**
+     * Get New York timezone offset
+     */
+    getNYTimeZone(date?: Date): '-04:00' | '-05:00';
+    /**
+     * Get trading date in YYYY-MM-DD format
+     */
+    getTradingDate(time: string | number | Date): string;
+}
+/**
+ * Service for core market time calculations
+ */
+export declare class MarketTimeCalculator {
+    private calendar;
+    private formatter;
+    private timezone;
+    constructor(timezone?: string);
+    /**
+     * Get market open/close times for a date
+     */
+    getMarketTimes(date: Date): MarketOpenCloseResult;
+    /**
+     * Check if a time is within market hours based on intraday reporting mode
+     */
+    isWithinMarketHours(date: Date, intradayReporting?: IntradayReporting): boolean;
+    /**
+     * Get the last full trading date
+     */
+    getLastFullTradingDate(currentDate?: Date): Date;
+    /**
+     * Get day boundaries based on intraday reporting mode
+     */
+    getDayBoundaries(date: Date, intradayReporting?: IntradayReporting): {
+        start: Date;
+        end: Date;
+    };
+}
+/**
+ * Service for calculating time periods
+ */
+export declare class PeriodCalculator {
+    private calendar;
+    private timeCalculator;
+    private formatter;
+    constructor(timezone?: string);
+    /**
+     * Calculate the start date for a given period
+     */
+    calculatePeriodStartDate(endDate: Date, period: Period): Date;
+    /**
+     * Get period dates for market time calculations
+     */
+    getMarketTimePeriod(params: MarketTimeParams): PeriodDates;
+}
+/**
+ * Service for determining market status
+ */
+export declare class MarketStatusService {
+    private calendar;
+    private timeCalculator;
+    private timezone;
+    constructor(timezone?: string);
+    /**
+     * Get current market status
+     */
+    getMarketStatus(date?: Date): MarketStatus;
+}
+/**
+ * Get market open/close times for a given date
+ */
+export declare function getMarketOpenClose(options?: {
+    date?: Date;
+}): MarketOpenCloseResult;
+/**
+ * Get start and end dates for a given market time period
+ */
+export declare function getStartAndEndDates(params?: MarketTimeParams): {
+    start: Date;
+    end: Date;
+};
+/**
+ * Get the last full trading date
+ */
+export declare function getLastFullTradingDate(currentDate?: Date): {
+    date: Date;
+    YYYYMMDD: string;
+};
+/**
+ * Get the next market day
+ */
+export declare function getNextMarketDay({ referenceDate }?: {
+    referenceDate?: Date;
+}): {
+    date: Date;
+    yyyymmdd: string;
+    dateISOString: string;
+};
+/**
+ * Get trading date in YYYY-MM-DD format
+ */
+export declare function getTradingDate(time: string | number | Date): string;
+/**
+ * Get New York timezone offset
+ */
+export declare function getNYTimeZone(date?: Date): '-04:00' | '-05:00';
+/**
+ * Get current market status
+ */
+export declare function getMarketStatus(options?: {
+    date?: Date;
+}): MarketStatus;
+/**
+ * Check if a date is a market day
+ */
+export declare function isMarketDay(date: Date): boolean;
+/**
+ * Check if a date is within market hours
+ */
+export declare function isWithinMarketHours(date: Date, intradayReporting?: IntradayReporting): boolean;
+/**
+ * Function to find complete trading date periods, starting at the beginning of one trading date and ending at the last.
+ * By default, it gets the last trading date, returning the beginning and end. But we can also a) define the end date
+ * on which to look (which is the end market date, e.g. for 8 july 2025 we'd return an end of 16:00 NY time on that date),
+ * and to go back x days before, e.g. 7 would just subtract raw 7 days, giving us 4-5 trading days (depending on holidays).
+ * @param options.endDate - The end date to use, defaults to today
+ * @param options.days - The number of days to go back, defaults to 1
+ * @returns The start and end dates with proper market open/close times
+ */
+export declare function getTradingStartAndEndDates(options?: {
+    endDate?: Date;
+    days?: number;
+}): {
+    startDate: Date;
+    endDate: Date;
+};
+/**
+ * Create a market time utility instance with custom timezone
+ */
+export declare function createMarketTimeUtil(timezone?: string, intradayReporting?: IntradayReporting): {
+    isMarketDay: (date: Date) => boolean;
+    isWithinMarketHours: (date: Date) => boolean;
+    getLastFullTradingDate: (date?: Date) => Date;
+    getNextMarketDay: (date: Date) => Date;
+    getMarketOpenClose: (options?: {
+        date?: Date;
+    }) => MarketOpenCloseResult;
+    getMarketTimePeriod: (params: MarketTimeParams) => PeriodDates;
+    getMarketStatus: (date?: Date) => MarketStatus;
+    isEarlyCloseDay: (date: Date) => boolean;
+    getEarlyCloseTime: (date: Date) => number | null;
+};
+export declare class MarketTimeUtil {
+    private calculator;
+    private calendar;
+    private formatter;
+    private periodCalc;
+    private statusService;
+    private intradayReporting;
+    constructor(timezone?: string, intradayReporting?: IntradayReporting);
+    isMarketDay(date: Date): boolean;
+    isWithinMarketHours(date: Date): boolean;
+    getLastFullTradingDate(date?: Date): Date;
+    getNextMarketDay(date: Date): Date;
+    getMarketOpenClose(options?: {
+        date?: Date;
+    }): MarketOpenCloseResult;
+    getMarketTimePeriod(params: MarketTimeParams): PeriodDates;
+    isEarlyCloseDay(date: Date): boolean;
+    getEarlyCloseTime(date: Date): number | null;
+}
+export declare const MARKET_TIMES: MarketTimesConfig;
+//# sourceMappingURL=market-time.d.ts.map

package/dist/types-frontend/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-frontend/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-frontend/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-frontend/old-test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=old-test.d.ts.map

package/dist/types-frontend/old-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"old-test.d.ts","sourceRoot":"","sources":["../../src/old-test.ts"],"names":[],"mappings":""}

package/dist/types-frontend/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-frontend/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"}