fmp-node-api 0.1.9 → 0.2.0-beta.1

package/dist/index.d.mts

@@ -1,6 +1,7 @@
-import { FMPConfig, APIResponse, EarningsCalendar, EarningsConfirmed, DividendsCalendar, EconomicsCalendar, IPOCalendar, SplitsCalendar, CompanyProfile, ExecutiveCompensation, CompanyNotes, HistoricalEmployeeCount, SharesFloat, HistoricalSharesFloat, EarningsCallTranscript, CompanyTranscriptData, TreasuryRate, EconomicIndicator, ETFHoldingDates, ETFHolding, ETFHolder, ETFProfile, ETFWeighting, ETFCountryWeighting, ETFStockExposure, IncomeStatement, BalanceSheet, CashFlowStatement, KeyMetrics, FinancialRatios, EnterpriseValue, CashflowGrowth, IncomeGrowth, BalanceSheetGrowth, FinancialGrowth, EarningsHistorical, EarningsSurprises, InsiderTradingRSSResponse, InsiderTradingSearchResponse, TransactionTypesResponse, InsidersBySymbolResponse, InsiderTradeStatisticsResponse, CikMapperResponse, CikMapperBySymbolResponse, BeneficialOwnershipResponse, FailToDeliverResponse, TransactionType, Form13FResponse, InstitutionalHolderResponse, StockList, ETFList, CryptoList, ForexList, AvailableIndexesList, MarketHours, MarketPerformance, MarketSectorPerformance, MarketIndex, MutualFundHolding, Article, News, Quote, HistoricalPriceResponse, HistoricalPriceData, ScreenerParams, Screener, AvailableExchanges, AvailableSectors, AvailableIndustries, AvailableCountries, RSSFeedItem, RSSFeedAllItem, RSSFeedV3Item, RSSFeed8KItem, SECFiling, IndustryClassification, IndustryClassificationCode, SenateTradingResponse, SenateHouseTradingByNameResponse, HouseTradingResponse, MarketCap, StockSplitResponse, StockDividendResponse, StockRealTimePrice, StockRealTimePriceFull } from './types-only.mjs';
-export { CompaniesPriceListResponse, DateRangeParams, EconomicIndicatorName, Exchange, IndividualIndustryClassificationParams, IndustryClassificationCodesParams, MarketHoliday, PaginationParams, Period, PeriodParams, QueryParams, RSSFeed8KParams, RSSFeedParams, RSSFeedV3Params, SECFilingsParams, StockDividend, StockListResponse, StockSplit, SymbolParams } from './types-only.mjs';
+import { FMPConfig, APIResponse, EarningsCalendar, EarningsConfirmed, DividendsCalendar, EconomicsCalendar, IPOCalendar, SplitsCalendar, CompanyProfile, ExecutiveCompensation, CompanyNotes, HistoricalEmployeeCount, SharesFloat, HistoricalSharesFloat, EarningsCallTranscript, CompanyTranscriptData, TreasuryRate, EconomicIndicator, ETFHoldingDates, ETFHolding, ETFHolder, ETFProfile, ETFWeighting, ETFCountryWeighting, ETFStockExposure, IncomeStatement, BalanceSheet, CashFlowStatement, KeyMetrics, FinancialRatios, EnterpriseValue, CashflowGrowth, IncomeGrowth, BalanceSheetGrowth, FinancialGrowth, EarningsHistorical, EarningsSurprises, InsiderTradingRSSResponse, InsiderTradingSearchResponse, TransactionTypesResponse, InsidersBySymbolResponse, InsiderTradeStatisticsResponse, CikMapperResponse, CikMapperBySymbolResponse, BeneficialOwnershipResponse, FailToDeliverResponse, TransactionType, Form13FResponse, InstitutionalHolderResponse, StockList, ETFList, CryptoList, ForexList, AvailableIndexesList, MarketHours, MarketIndex, MarketPerformance, MarketSectorPerformance, MutualFundHolding, Article, News, Quote, HistoricalPriceResponse, IntradayPrice, ScreenerParams, Screener, AvailableExchanges, AvailableSectors, AvailableIndustries, AvailableCountries, RSSFeedItem, RSSFeedAllItem, RSSFeedV3Item, RSSFeed8KItem, SECFiling, IndustryClassification, IndustryClassificationCode, SenateTradingResponse, SenateHouseTradingByNameResponse, HouseTradingResponse, MarketCap, StockSplitResponse, StockDividendResponse, StockRealTimePrice, StockRealTimePriceFull, FMPErrorType } from './types-only.mjs';
+export { ArticleSchema, AvailableCountriesSchema, AvailableExchangesSchema, AvailableIndexesListSchema, AvailableIndustriesSchema, AvailableSectorsSchema, BalanceSheetGrowthSchema, BalanceSheetSchema, BeneficialOwnershipResponseSchema, CashFlowStatementSchema, CashflowGrowthSchema, CikMapperBySymbolResponseSchema, CikMapperResponseSchema, CompaniesPriceListResponse, CompanyNotesSchema, CompanyProfileSchema, CompanyTranscriptDataSchema, CryptoListSchema, DateRangeParams, DividendsCalendarSchema, ETFCountryWeightingSchema, ETFHolderSchema, ETFHoldingDatesSchema, ETFHoldingSchema, ETFListSchema, ETFProfileSchema, ETFStockExposureSchema, ETFWeightingSchema, EarningsCalendarSchema, EarningsCallTranscriptSchema, EarningsConfirmedSchema, EarningsHistoricalSchema, EarningsSurprisesSchema, EconomicIndicatorName, EconomicIndicatorNameSchema, EconomicIndicatorSchema, EconomicsCalendarSchema, EnterpriseValueSchema, Exchange, ExecutiveCompensationSchema, FailToDeliverResponseSchema, FinancialGrowthSchema, FinancialRatiosSchema, ForexListSchema, Form13FResponseSchema, HistoricalEmployeeCountSchema, HistoricalPriceData, HistoricalPriceDataSchema, HistoricalPriceResponseSchema, HistoricalSharesFloatSchema, HouseTradingResponseSchema, IPOCalendarSchema, IncomeGrowthSchema, IncomeStatementSchema, IndividualIndustryClassificationParams, IndividualIndustryClassificationParamsSchema, IndustryClassificationCodeSchema, IndustryClassificationCodesParams, IndustryClassificationCodesParamsSchema, IndustryClassificationSchema, InsiderTradeStatisticsResponseSchema, InsiderTradingRSSResponseSchema, InsiderTradingSearchResponseSchema, InsidersBySymbolResponseSchema, InstitutionalHolderResponseSchema, IntradayPriceSchema, KeyMetricsSchema, MarketCapSchema, MarketHoliday, MarketHolidaySchema, MarketHoursSchema, MarketIndexSchema, MarketPerformanceSchema, MarketSectorPerformanceSchema, MutualFundHoldingSchema, NewsSchema, PaginationParams, Period, PeriodParams, QueryParams, QuoteSchema, RSSFeed8KItemSchema, RSSFeed8KParams, RSSFeed8KParamsSchema, RSSFeedAllItemSchema, RSSFeedItemSchema, RSSFeedParams, RSSFeedParamsSchema, RSSFeedV3ItemSchema, RSSFeedV3Params, RSSFeedV3ParamsSchema, SECFilingSchema, SECFilingsParams, SECFilingsParamsSchema, ScreenerParamsSchema, ScreenerSchema, SenateHouseTradingByNameResponseSchema, SenateTradingResponseSchema, SharesFloatSchema, SplitsCalendarSchema, StockDividend, StockDividendResponseSchema, StockDividendSchema, StockListResponse, StockListSchema, StockRealTimePriceFullSchema, StockRealTimePriceSchema, StockSplit, StockSplitResponseSchema, StockSplitSchema, SymbolParams, TransactionTypeRecordSchema, TreasuryRateSchema } from './types-only.mjs';
 export { FMPValidation } from './utils/validation.mjs';
+import 'zod';
 
 declare class FMPClient {
     private v3Client;
@@ -21,6 +22,15 @@ declare class FMPClient {
      * For endpoints that return single objects, this will always return an object (possibly empty) for `data` when success is true.
      */
     getSingle<T>(endpoint: string, version?: 'v3' | 'v4' | 'stable', params?: Record<string, any>): Promise<APIResponse<T>>;
+    /**
+     * Build a classified error response from a caught axios error.
+     *
+     * FMP returns the real reason in the response *body* (e.g.
+     * `{ "Error Message": "Special Endpoint : ..." }`), not in `error.message`
+     * (which is axios's generic "Request failed with status code N"). We prefer
+     * the body, then classify into a typed `errorType`.
+     */
+    private buildErrorResponse;
     private getClientForVersion;
 }
 
@@ -1875,7 +1885,7 @@ declare class MarketEndpoints {
      *
      * @see {@link https://site.financialmodelingprep.com/developer/docs#market-index-market-overview|FMP Market Performance Documentation}
      */
-    getMarketPerformance(): Promise<APIResponse<MarketPerformance[]>>;
+    getMarketPerformance(): Promise<APIResponse<MarketIndex[]>>;
     /**
      * Get top gaining stocks for the current trading day
      *
@@ -2544,7 +2554,7 @@ declare class QuoteEndpoints {
         interval: '1min' | '5min' | '15min' | '30min' | '1hour' | '4hour';
         from?: string;
         to?: string;
-    }): Promise<APIResponse<HistoricalPriceData[]>>;
+    }): Promise<APIResponse<IntradayPrice[]>>;
 }
 
 declare class ScreenerEndpoints {
@@ -3432,4 +3442,24 @@ declare const SECTORS: {
     readonly COMMUNICATION_SERVICES: "Communication Services";
 };
 
-export { APIResponse, Article, AvailableCountries, AvailableExchanges, AvailableIndexesList, AvailableIndustries, AvailableSectors, BalanceSheet, BalanceSheetGrowth, BeneficialOwnershipResponse, CalendarEndpoints, CashFlowStatement, CashflowGrowth, CikMapperBySymbolResponse, CikMapperResponse, CompanyEndpoints, CompanyNotes, CompanyProfile, CompanyTranscriptData, CryptoList, DEFAULT_LIMIT, DEFAULT_TIMEOUT, DividendsCalendar, ETFCountryWeighting, ETFEndpoints, ETFHolder, ETFHolding, ETFHoldingDates, ETFList, ETFProfile, ETFStockExposure, ETFWeighting, EXCHANGES, EarningsCalendar, EarningsCallTranscript, EarningsConfirmed, EarningsHistorical, EarningsSurprises, EconomicEndpoints, EconomicIndicator, EconomicsCalendar, EnterpriseValue, ExecutiveCompensation, FMP, FMPClient, FMPConfig, FailToDeliverResponse, FinancialEndpoints, FinancialGrowth, FinancialRatios, ForexList, Form13FResponse, HistoricalEmployeeCount, HistoricalPriceData, HistoricalPriceResponse, HistoricalSharesFloat, HouseTradingResponse, IPOCalendar, IncomeGrowth, IncomeStatement, IndustryClassification, IndustryClassificationCode, InsiderEndpoints, InsiderTradeStatisticsResponse, InsiderTradingRSSResponse, InsiderTradingSearchResponse, InsidersBySymbolResponse, InstitutionalEndpoints, InstitutionalHolderResponse, KeyMetrics, ListEndpoints, MAX_LIMIT, MarketCap, MarketEndpoints, MarketHours, MarketIndex, MarketPerformance, MarketSectorPerformance, MutualFundEndpoints, MutualFundHolding, News, NewsEndpoints, PERIODS, Quote, QuoteEndpoints, RSSFeed8KItem, RSSFeedAllItem, RSSFeedItem, RSSFeedV3Item, SECEndpoints, SECFiling, SECTORS, Screener, ScreenerEndpoints, ScreenerParams, SenateHouseEndpoints, SenateHouseTradingByNameResponse, SenateTradingResponse, SharesFloat, SplitsCalendar, StockDividendResponse, StockEndpoints, StockList, StockRealTimePrice, StockRealTimePriceFull, StockSplitResponse, TransactionType, TransactionTypesResponse, TreasuryRate, formatCurrency, formatDate, formatLargeNumber, formatPercentage, formatVolume };
+interface ClassifiedError {
+    errorType: FMPErrorType;
+    message: string;
+}
+/**
+ * Classify a failed request.
+ *
+ * @param status HTTP status code; use `0` when no HTTP response was received
+ *               (network error / timeout), which maps to `network`.
+ * @param rawMessage The best available message — prefer FMP's response body over
+ *                   axios's generic "Request failed with status code N".
+ */
+declare function classifyError(status: number, rawMessage: string): ClassifiedError;
+
+declare class FMPError extends Error {
+    status?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
+}
+
+export { APIResponse, Article, AvailableCountries, AvailableExchanges, AvailableIndexesList, AvailableIndustries, AvailableSectors, BalanceSheet, BalanceSheetGrowth, BeneficialOwnershipResponse, CalendarEndpoints, CashFlowStatement, CashflowGrowth, CikMapperBySymbolResponse, CikMapperResponse, type ClassifiedError, CompanyEndpoints, CompanyNotes, CompanyProfile, CompanyTranscriptData, CryptoList, DEFAULT_LIMIT, DEFAULT_TIMEOUT, DividendsCalendar, ETFCountryWeighting, ETFEndpoints, ETFHolder, ETFHolding, ETFHoldingDates, ETFList, ETFProfile, ETFStockExposure, ETFWeighting, EXCHANGES, EarningsCalendar, EarningsCallTranscript, EarningsConfirmed, EarningsHistorical, EarningsSurprises, EconomicEndpoints, EconomicIndicator, EconomicsCalendar, EnterpriseValue, ExecutiveCompensation, FMP, FMPClient, FMPConfig, FMPError, FMPErrorType, FailToDeliverResponse, FinancialEndpoints, FinancialGrowth, FinancialRatios, ForexList, Form13FResponse, HistoricalEmployeeCount, HistoricalPriceResponse, HistoricalSharesFloat, HouseTradingResponse, IPOCalendar, IncomeGrowth, IncomeStatement, IndustryClassification, IndustryClassificationCode, InsiderEndpoints, InsiderTradeStatisticsResponse, InsiderTradingRSSResponse, InsiderTradingSearchResponse, InsidersBySymbolResponse, InstitutionalEndpoints, InstitutionalHolderResponse, IntradayPrice, KeyMetrics, ListEndpoints, MAX_LIMIT, MarketCap, MarketEndpoints, MarketHours, MarketIndex, MarketPerformance, MarketSectorPerformance, MutualFundEndpoints, MutualFundHolding, News, NewsEndpoints, PERIODS, Quote, QuoteEndpoints, RSSFeed8KItem, RSSFeedAllItem, RSSFeedItem, RSSFeedV3Item, SECEndpoints, SECFiling, SECTORS, Screener, ScreenerEndpoints, ScreenerParams, SenateHouseEndpoints, SenateHouseTradingByNameResponse, SenateTradingResponse, SharesFloat, SplitsCalendar, StockDividendResponse, StockEndpoints, StockList, StockRealTimePrice, StockRealTimePriceFull, StockSplitResponse, TransactionType, TransactionTypesResponse, TreasuryRate, classifyError, formatCurrency, formatDate, formatLargeNumber, formatPercentage, formatVolume };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { FMPConfig, APIResponse, EarningsCalendar, EarningsConfirmed, DividendsCalendar, EconomicsCalendar, IPOCalendar, SplitsCalendar, CompanyProfile, ExecutiveCompensation, CompanyNotes, HistoricalEmployeeCount, SharesFloat, HistoricalSharesFloat, EarningsCallTranscript, CompanyTranscriptData, TreasuryRate, EconomicIndicator, ETFHoldingDates, ETFHolding, ETFHolder, ETFProfile, ETFWeighting, ETFCountryWeighting, ETFStockExposure, IncomeStatement, BalanceSheet, CashFlowStatement, KeyMetrics, FinancialRatios, EnterpriseValue, CashflowGrowth, IncomeGrowth, BalanceSheetGrowth, FinancialGrowth, EarningsHistorical, EarningsSurprises, InsiderTradingRSSResponse, InsiderTradingSearchResponse, TransactionTypesResponse, InsidersBySymbolResponse, InsiderTradeStatisticsResponse, CikMapperResponse, CikMapperBySymbolResponse, BeneficialOwnershipResponse, FailToDeliverResponse, TransactionType, Form13FResponse, InstitutionalHolderResponse, StockList, ETFList, CryptoList, ForexList, AvailableIndexesList, MarketHours, MarketPerformance, MarketSectorPerformance, MarketIndex, MutualFundHolding, Article, News, Quote, HistoricalPriceResponse, HistoricalPriceData, ScreenerParams, Screener, AvailableExchanges, AvailableSectors, AvailableIndustries, AvailableCountries, RSSFeedItem, RSSFeedAllItem, RSSFeedV3Item, RSSFeed8KItem, SECFiling, IndustryClassification, IndustryClassificationCode, SenateTradingResponse, SenateHouseTradingByNameResponse, HouseTradingResponse, MarketCap, StockSplitResponse, StockDividendResponse, StockRealTimePrice, StockRealTimePriceFull } from './types-only.js';
-export { CompaniesPriceListResponse, DateRangeParams, EconomicIndicatorName, Exchange, IndividualIndustryClassificationParams, IndustryClassificationCodesParams, MarketHoliday, PaginationParams, Period, PeriodParams, QueryParams, RSSFeed8KParams, RSSFeedParams, RSSFeedV3Params, SECFilingsParams, StockDividend, StockListResponse, StockSplit, SymbolParams } from './types-only.js';
+import { FMPConfig, APIResponse, EarningsCalendar, EarningsConfirmed, DividendsCalendar, EconomicsCalendar, IPOCalendar, SplitsCalendar, CompanyProfile, ExecutiveCompensation, CompanyNotes, HistoricalEmployeeCount, SharesFloat, HistoricalSharesFloat, EarningsCallTranscript, CompanyTranscriptData, TreasuryRate, EconomicIndicator, ETFHoldingDates, ETFHolding, ETFHolder, ETFProfile, ETFWeighting, ETFCountryWeighting, ETFStockExposure, IncomeStatement, BalanceSheet, CashFlowStatement, KeyMetrics, FinancialRatios, EnterpriseValue, CashflowGrowth, IncomeGrowth, BalanceSheetGrowth, FinancialGrowth, EarningsHistorical, EarningsSurprises, InsiderTradingRSSResponse, InsiderTradingSearchResponse, TransactionTypesResponse, InsidersBySymbolResponse, InsiderTradeStatisticsResponse, CikMapperResponse, CikMapperBySymbolResponse, BeneficialOwnershipResponse, FailToDeliverResponse, TransactionType, Form13FResponse, InstitutionalHolderResponse, StockList, ETFList, CryptoList, ForexList, AvailableIndexesList, MarketHours, MarketIndex, MarketPerformance, MarketSectorPerformance, MutualFundHolding, Article, News, Quote, HistoricalPriceResponse, IntradayPrice, ScreenerParams, Screener, AvailableExchanges, AvailableSectors, AvailableIndustries, AvailableCountries, RSSFeedItem, RSSFeedAllItem, RSSFeedV3Item, RSSFeed8KItem, SECFiling, IndustryClassification, IndustryClassificationCode, SenateTradingResponse, SenateHouseTradingByNameResponse, HouseTradingResponse, MarketCap, StockSplitResponse, StockDividendResponse, StockRealTimePrice, StockRealTimePriceFull, FMPErrorType } from './types-only.js';
+export { ArticleSchema, AvailableCountriesSchema, AvailableExchangesSchema, AvailableIndexesListSchema, AvailableIndustriesSchema, AvailableSectorsSchema, BalanceSheetGrowthSchema, BalanceSheetSchema, BeneficialOwnershipResponseSchema, CashFlowStatementSchema, CashflowGrowthSchema, CikMapperBySymbolResponseSchema, CikMapperResponseSchema, CompaniesPriceListResponse, CompanyNotesSchema, CompanyProfileSchema, CompanyTranscriptDataSchema, CryptoListSchema, DateRangeParams, DividendsCalendarSchema, ETFCountryWeightingSchema, ETFHolderSchema, ETFHoldingDatesSchema, ETFHoldingSchema, ETFListSchema, ETFProfileSchema, ETFStockExposureSchema, ETFWeightingSchema, EarningsCalendarSchema, EarningsCallTranscriptSchema, EarningsConfirmedSchema, EarningsHistoricalSchema, EarningsSurprisesSchema, EconomicIndicatorName, EconomicIndicatorNameSchema, EconomicIndicatorSchema, EconomicsCalendarSchema, EnterpriseValueSchema, Exchange, ExecutiveCompensationSchema, FailToDeliverResponseSchema, FinancialGrowthSchema, FinancialRatiosSchema, ForexListSchema, Form13FResponseSchema, HistoricalEmployeeCountSchema, HistoricalPriceData, HistoricalPriceDataSchema, HistoricalPriceResponseSchema, HistoricalSharesFloatSchema, HouseTradingResponseSchema, IPOCalendarSchema, IncomeGrowthSchema, IncomeStatementSchema, IndividualIndustryClassificationParams, IndividualIndustryClassificationParamsSchema, IndustryClassificationCodeSchema, IndustryClassificationCodesParams, IndustryClassificationCodesParamsSchema, IndustryClassificationSchema, InsiderTradeStatisticsResponseSchema, InsiderTradingRSSResponseSchema, InsiderTradingSearchResponseSchema, InsidersBySymbolResponseSchema, InstitutionalHolderResponseSchema, IntradayPriceSchema, KeyMetricsSchema, MarketCapSchema, MarketHoliday, MarketHolidaySchema, MarketHoursSchema, MarketIndexSchema, MarketPerformanceSchema, MarketSectorPerformanceSchema, MutualFundHoldingSchema, NewsSchema, PaginationParams, Period, PeriodParams, QueryParams, QuoteSchema, RSSFeed8KItemSchema, RSSFeed8KParams, RSSFeed8KParamsSchema, RSSFeedAllItemSchema, RSSFeedItemSchema, RSSFeedParams, RSSFeedParamsSchema, RSSFeedV3ItemSchema, RSSFeedV3Params, RSSFeedV3ParamsSchema, SECFilingSchema, SECFilingsParams, SECFilingsParamsSchema, ScreenerParamsSchema, ScreenerSchema, SenateHouseTradingByNameResponseSchema, SenateTradingResponseSchema, SharesFloatSchema, SplitsCalendarSchema, StockDividend, StockDividendResponseSchema, StockDividendSchema, StockListResponse, StockListSchema, StockRealTimePriceFullSchema, StockRealTimePriceSchema, StockSplit, StockSplitResponseSchema, StockSplitSchema, SymbolParams, TransactionTypeRecordSchema, TreasuryRateSchema } from './types-only.js';
 export { FMPValidation } from './utils/validation.js';
+import 'zod';
 
 declare class FMPClient {
     private v3Client;
@@ -21,6 +22,15 @@ declare class FMPClient {
      * For endpoints that return single objects, this will always return an object (possibly empty) for `data` when success is true.
      */
     getSingle<T>(endpoint: string, version?: 'v3' | 'v4' | 'stable', params?: Record<string, any>): Promise<APIResponse<T>>;
+    /**
+     * Build a classified error response from a caught axios error.
+     *
+     * FMP returns the real reason in the response *body* (e.g.
+     * `{ "Error Message": "Special Endpoint : ..." }`), not in `error.message`
+     * (which is axios's generic "Request failed with status code N"). We prefer
+     * the body, then classify into a typed `errorType`.
+     */
+    private buildErrorResponse;
     private getClientForVersion;
 }
 
@@ -1875,7 +1885,7 @@ declare class MarketEndpoints {
      *
      * @see {@link https://site.financialmodelingprep.com/developer/docs#market-index-market-overview|FMP Market Performance Documentation}
      */
-    getMarketPerformance(): Promise<APIResponse<MarketPerformance[]>>;
+    getMarketPerformance(): Promise<APIResponse<MarketIndex[]>>;
     /**
      * Get top gaining stocks for the current trading day
      *
@@ -2544,7 +2554,7 @@ declare class QuoteEndpoints {
         interval: '1min' | '5min' | '15min' | '30min' | '1hour' | '4hour';
         from?: string;
         to?: string;
-    }): Promise<APIResponse<HistoricalPriceData[]>>;
+    }): Promise<APIResponse<IntradayPrice[]>>;
 }
 
 declare class ScreenerEndpoints {
@@ -3432,4 +3442,24 @@ declare const SECTORS: {
     readonly COMMUNICATION_SERVICES: "Communication Services";
 };
 
-export { APIResponse, Article, AvailableCountries, AvailableExchanges, AvailableIndexesList, AvailableIndustries, AvailableSectors, BalanceSheet, BalanceSheetGrowth, BeneficialOwnershipResponse, CalendarEndpoints, CashFlowStatement, CashflowGrowth, CikMapperBySymbolResponse, CikMapperResponse, CompanyEndpoints, CompanyNotes, CompanyProfile, CompanyTranscriptData, CryptoList, DEFAULT_LIMIT, DEFAULT_TIMEOUT, DividendsCalendar, ETFCountryWeighting, ETFEndpoints, ETFHolder, ETFHolding, ETFHoldingDates, ETFList, ETFProfile, ETFStockExposure, ETFWeighting, EXCHANGES, EarningsCalendar, EarningsCallTranscript, EarningsConfirmed, EarningsHistorical, EarningsSurprises, EconomicEndpoints, EconomicIndicator, EconomicsCalendar, EnterpriseValue, ExecutiveCompensation, FMP, FMPClient, FMPConfig, FailToDeliverResponse, FinancialEndpoints, FinancialGrowth, FinancialRatios, ForexList, Form13FResponse, HistoricalEmployeeCount, HistoricalPriceData, HistoricalPriceResponse, HistoricalSharesFloat, HouseTradingResponse, IPOCalendar, IncomeGrowth, IncomeStatement, IndustryClassification, IndustryClassificationCode, InsiderEndpoints, InsiderTradeStatisticsResponse, InsiderTradingRSSResponse, InsiderTradingSearchResponse, InsidersBySymbolResponse, InstitutionalEndpoints, InstitutionalHolderResponse, KeyMetrics, ListEndpoints, MAX_LIMIT, MarketCap, MarketEndpoints, MarketHours, MarketIndex, MarketPerformance, MarketSectorPerformance, MutualFundEndpoints, MutualFundHolding, News, NewsEndpoints, PERIODS, Quote, QuoteEndpoints, RSSFeed8KItem, RSSFeedAllItem, RSSFeedItem, RSSFeedV3Item, SECEndpoints, SECFiling, SECTORS, Screener, ScreenerEndpoints, ScreenerParams, SenateHouseEndpoints, SenateHouseTradingByNameResponse, SenateTradingResponse, SharesFloat, SplitsCalendar, StockDividendResponse, StockEndpoints, StockList, StockRealTimePrice, StockRealTimePriceFull, StockSplitResponse, TransactionType, TransactionTypesResponse, TreasuryRate, formatCurrency, formatDate, formatLargeNumber, formatPercentage, formatVolume };
+interface ClassifiedError {
+    errorType: FMPErrorType;
+    message: string;
+}
+/**
+ * Classify a failed request.
+ *
+ * @param status HTTP status code; use `0` when no HTTP response was received
+ *               (network error / timeout), which maps to `network`.
+ * @param rawMessage The best available message — prefer FMP's response body over
+ *                   axios's generic "Request failed with status code N".
+ */
+declare function classifyError(status: number, rawMessage: string): ClassifiedError;
+
+declare class FMPError extends Error {
+    status?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined);
+}
+
+export { APIResponse, Article, AvailableCountries, AvailableExchanges, AvailableIndexesList, AvailableIndustries, AvailableSectors, BalanceSheet, BalanceSheetGrowth, BeneficialOwnershipResponse, CalendarEndpoints, CashFlowStatement, CashflowGrowth, CikMapperBySymbolResponse, CikMapperResponse, type ClassifiedError, CompanyEndpoints, CompanyNotes, CompanyProfile, CompanyTranscriptData, CryptoList, DEFAULT_LIMIT, DEFAULT_TIMEOUT, DividendsCalendar, ETFCountryWeighting, ETFEndpoints, ETFHolder, ETFHolding, ETFHoldingDates, ETFList, ETFProfile, ETFStockExposure, ETFWeighting, EXCHANGES, EarningsCalendar, EarningsCallTranscript, EarningsConfirmed, EarningsHistorical, EarningsSurprises, EconomicEndpoints, EconomicIndicator, EconomicsCalendar, EnterpriseValue, ExecutiveCompensation, FMP, FMPClient, FMPConfig, FMPError, FMPErrorType, FailToDeliverResponse, FinancialEndpoints, FinancialGrowth, FinancialRatios, ForexList, Form13FResponse, HistoricalEmployeeCount, HistoricalPriceResponse, HistoricalSharesFloat, HouseTradingResponse, IPOCalendar, IncomeGrowth, IncomeStatement, IndustryClassification, IndustryClassificationCode, InsiderEndpoints, InsiderTradeStatisticsResponse, InsiderTradingRSSResponse, InsiderTradingSearchResponse, InsidersBySymbolResponse, InstitutionalEndpoints, InstitutionalHolderResponse, IntradayPrice, KeyMetrics, ListEndpoints, MAX_LIMIT, MarketCap, MarketEndpoints, MarketHours, MarketIndex, MarketPerformance, MarketSectorPerformance, MutualFundEndpoints, MutualFundHolding, News, NewsEndpoints, PERIODS, Quote, QuoteEndpoints, RSSFeed8KItem, RSSFeedAllItem, RSSFeedItem, RSSFeedV3Item, SECEndpoints, SECFiling, SECTORS, Screener, ScreenerEndpoints, ScreenerParams, SenateHouseEndpoints, SenateHouseTradingByNameResponse, SenateTradingResponse, SharesFloat, SplitsCalendar, StockDividendResponse, StockEndpoints, StockList, StockRealTimePrice, StockRealTimePriceFull, StockSplitResponse, TransactionType, TransactionTypesResponse, TreasuryRate, classifyError, formatCurrency, formatDate, formatLargeNumber, formatPercentage, formatVolume };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var F=require('axios');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var F__default=/*#__PURE__*/_interopDefault(F);function M(i){return Array.isArray(i)&&i.length===1?i[0]:i}function k(i){return Array.isArray(i)?i:i??[]}function x(i){return i==null?{}:Array.isArray(i)&&i.length===0?{}:i}var c=class{constructor(e){if(!e.apiKey)throw new Error("API key is required for FMPClient");this.apiKey=e.apiKey,this.v3Client=F__default.default.create({baseURL:"https://financialmodelingprep.com/api/v3",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),this.v4Client=F__default.default.create({baseURL:"https://financialmodelingprep.com/api/v4",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),this.stableClient=F__default.default.create({baseURL:"https://financialmodelingprep.com/stable",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),[this.v3Client,this.v4Client,this.stableClient].forEach(t=>{t.interceptors.request.use(s=>(s.params={...s.params,apikey:this.apiKey},s));});}async get(e,t="v3",s){let r=this.getClientForVersion(t);try{let n=await r.get(e,{params:s}),o=n.data;return (Array.isArray(o)||o==null)&&(o=k(o)),{success:!0,data:o,error:null,status:n.status}}catch(n){return {success:false,data:null,error:n.message||"Unknown error occurred",status:n.response?.status||500}}}async getSingle(e,t="v3",s){let r=this.getClientForVersion(t);try{let n=await r.get(e,{params:s});return {success:!0,data:x(M(n.data)),error:null,status:n.status}}catch(n){return {success:false,data:null,error:n.message||"Unknown error occurred",status:n.response?.status||500}}}getClientForVersion(e){switch(e){case "v3":return this.v3Client;case "v4":return this.v4Client;case "stable":return this.stableClient;default:return this.v3Client}}};var m=class{static isValidSymbol(e){return !e||typeof e!="string"?false:/^[A-Z]{1,5}$/.test(e)}static isValidCryptoSymbol(e){return !e||typeof e!="string"?false:/^[A-Z]{2,10}(USD|EUR|GBP|JPY|CAD|AUD|CHF|CNY)$/.test(e)}static isValidForexPair(e){return !e||typeof e!="string"?false:/^[A-Z]{3}[A-Z]{3}$/.test(e)}static isValidDate(e){if(!e||typeof e!="string"||!/^\d{4}-\d{2}-\d{2}$/.test(e))return  false;let s=new Date(e);return !isNaN(s.getTime())&&s.toISOString().split("T")[0]===e}static isValidDateRange(e,t){if(!this.isValidDate(e)||!this.isValidDate(t))return  false;let s=new Date(e),r=new Date(t);return s<=r}static isValidResponse(e){return !!(e&&typeof e=="object"&&typeof e.success=="boolean")}static isValidApiKey(e){return !e||typeof e!="string"?false:/^[a-zA-Z0-9]{32,}$/.test(e)}static isValidPeriod(e){return !e||typeof e!="string"?false:["annual","quarter","fy"].includes(e.toLowerCase())}static isValidLimit(e){return typeof e=="number"&&Number.isInteger(e)&&e>0&&e<=1e3}static validateQuoteParams(e){let t=[];return e?(e.symbol?!this.isValidSymbol(e.symbol)&&!this.isValidCryptoSymbol(e.symbol)&&!this.isValidForexPair(e.symbol)&&t.push("Invalid symbol format"):t.push("Symbol is required"),e.from&&!this.isValidDate(e.from)&&t.push("Invalid from date format (expected YYYY-MM-DD)"),e.to&&!this.isValidDate(e.to)&&t.push("Invalid to date format (expected YYYY-MM-DD)"),e.from&&e.to&&!this.isValidDateRange(e.from,e.to)&&t.push("From date must be before or equal to to date"),t):(t.push("Parameters object is required"),t)}static validateFinancialParams(e){let t=[];return e?(e.symbol?this.isValidSymbol(e.symbol)||t.push("Invalid symbol format"):t.push("Symbol is required"),e.period&&!this.isValidPeriod(e.period)&&t.push('Invalid period (must be "annual", "quarter", or "FY")'),e.limit&&!this.isValidLimit(e.limit)&&t.push("Invalid limit (must be a positive integer <= 1000)"),t):(t.push("Parameters object is required"),t)}static validateDateRangeParams(e){let t=[];return e?(e.from&&!this.isValidDate(e.from)&&t.push("Invalid from date format (expected YYYY-MM-DD)"),e.to&&!this.isValidDate(e.to)&&t.push("Invalid to date format (expected YYYY-MM-DD)"),e.from&&e.to&&!this.isValidDateRange(e.from,e.to)&&t.push("From date must be before or equal to to date"),t):(t.push("Parameters object is required"),t)}static throwIfInvalid(e,t="Validation"){if(e.length>0)throw new Error(`${t} failed: ${e.join(", ")}`)}};var p=class{constructor(e){this._client=e;}async getEarningsCalendar(e={}){let{from:t,to:s}=e,r={};return t&&(r.from=t),s&&(r.to=s),this._client.get("/earning_calendar","v3",r)}async getEarningsConfirmed(e={}){let{from:t,to:s}=e,r={};return t&&(r.from=t),s&&(r.to=s),this._client.get("/earning-calendar-confirmed","v4",r)}async getDividendsCalendar(e={}){let{from:t,to:s}=e,r={};return t&&(r.from=t),s&&(r.to=s),this._client.get("/stock_dividend_calendar","v3",r)}async getEconomicsCalendar(e={}){let{from:t,to:s}=e,r={};return t&&(r.from=t),s&&(r.to=s),this._client.get("/economic_calendar","v3",r)}async getIPOCalendar(e={}){let{from:t,to:s}=e,r={};return t&&(r.from=t),s&&(r.to=s),this._client.get("/ipo_calendar","v3",r)}async getSplitsCalendar(e={}){let{from:t,to:s}=e,r={};return t&&(r.from=t),s&&(r.to=s),this._client.get("/stock_split_calendar","v3",r)}};var g=class{constructor(e){this.client=e;}async getCompanyProfile(e){return this.client.getSingle("/profile","stable",{symbol:e})}async getExecutiveCompensation(e){return this.client.get("/governance-executive-compensation","stable",{symbol:e})}async getCompanyNotes(e){return this.client.get("/company-notes","stable",{symbol:e})}async getHistoricalEmployeeCount(e){return this.client.get("/historical-employee-count","stable",{symbol:e})}async getSharesFloat(e){return this.client.getSingle("/shares-float","stable",{symbol:e})}async getHistoricalSharesFloat(e){return this.client.get("/historical/shares_float","v4",{symbol:e})}async getEarningsCallTranscript(e){let{symbol:t,year:s,quarter:r}=e;return this.client.getSingle(`/earning_call_transcript/${t}`,"v3",{year:s,quarter:r})}async getCompanyTranscriptData(e){return this.client.getSingle("/earning_call_transcript","v4",{symbol:e})}};var u=class{constructor(e){this.client=e;}async getTreasuryRates(e){let{from:t,to:s}=e,r={};return t&&(r.from=t),s&&(r.to=s),this.client.get("/treasury-rates","stable",r)}async getEconomicIndicators(e){let{name:t,from:s,to:r}=e,n={name:t};return s&&(n.from=s),r&&(n.to=r),this.client.get("/economic-indicators","stable",n)}};var d=class{constructor(e){this.client=e;}async getHoldingDates(e){return this.client.get("/etf-holdings/portfolio-date","v4",{symbol:e})}async getHoldings(e){let{symbol:t,date:s}=e,r={};return t&&(r.symbol=t),s&&(r.date=s),this.client.get("/etf-holdings","v4",r)}async getHolder(e){return this.client.get(`/etf-holder/${e}`,"v3")}async getProfile(e){return this.client.getSingle("/etf/info","stable",{symbol:e})}async getSectorWeighting(e){return this.client.get("/etf/sector-weightings","stable",{symbol:e})}async getCountryWeighting(e){return this.client.get("/etf/country-weightings","stable",{symbol:e})}async getStockExposure(e){return this.client.get(`/etf-stock-exposure/${e}`,"v3")}};var y=class{constructor(e){this.client=e;}async getIncomeStatement(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/income-statement?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getBalanceSheet(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/balance-sheet-statement?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getCashFlowStatement(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/cash-flow-statement?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getKeyMetrics(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/key-metrics?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getFinancialRatios(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/ratios?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getEnterpriseValue(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/enterprise-values?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getCashflowGrowth(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/cash-flow-statement-growth?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getIncomeGrowth(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/income-statement-growth?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getBalanceSheetGrowth(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/balance-sheet-statement-growth?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getFinancialGrowth(e){let{symbol:t,period:s="annual",limit:r=5}=e;return this.client.get(`/financial-growth?symbol=${t}&period=${s}&limit=${r}`,"stable")}async getEarningsHistorical(e){let{symbol:t,limit:s=5}=e;return this.client.get(`/earnings?symbol=${t}&limit=${s}`,"stable")}async getEarningsSurprises(e){return this.client.get(`/earnings-surprises/${e}`,"v3")}};var f=class{constructor(e){this.client=e;}async getInsiderTradingRSS(e){let{page:t=0,limit:s=100}=e;return this.client.get("/insider-trading/latest","stable",{page:t,limit:s})}async searchInsiderTrading(e){let{symbol:t,reportingCik:s,companyCik:r,transactionType:n,page:o=0,limit:a=100}=e,l={page:o,limit:a};return t&&(l.symbol=t),s&&(l.reportingCik=s),r&&(l.companyCik=r),n&&(l.transactionType=n),this.client.get("/insider-trading/search","stable",l)}async getTransactionTypes(){return this.client.get("/insider-trading-transaction-type","stable")}async getInsidersBySymbol(e){let{symbol:t}=e;return this.client.get("/insider-roaster","v4",{symbol:t})}async getInsiderTradeStatistics(e){let{symbol:t}=e;return this.client.get("/insider-trading/statistics","stable",{symbol:t})}async getCikMapper(e){let{page:t=0}=e;return this.client.get("/mapper-cik-name","v4",{page:t})}async getCikMapperByName(e){let{name:t,page:s=0}=e;return this.client.get("/mapper-cik-name","v4",{name:t,page:s})}async getCikMapperBySymbol(e){let{symbol:t}=e;return this.client.getSingle(`/mapper-cik-company/${t}`,"v4")}async getBeneficialOwnership(e){let{symbol:t,limit:s=100}=e;return this.client.get("/acquisition-of-beneficial-ownership","stable",{symbol:t,limit:s})}async getFailToDeliver(e){let{symbol:t,page:s=0}=e;return this.client.get("/fail_to_deliver","v4",{symbol:t,page:s})}async getInsiderTradesBySymbol(e,t=0){return this.searchInsiderTrading({symbol:e,page:t})}async getInsiderTradesByType(e,t=0){return this.searchInsiderTrading({transactionType:e,page:t})}async getInsiderTradesByReportingCik(e,t=0){return this.searchInsiderTrading({reportingCik:e,page:t})}async getInsiderTradesByCompanyCik(e,t=0){return this.searchInsiderTrading({companyCik:e,page:t})}};var P=class{constructor(e){this.client=e;}async getForm13F(e){let{cik:t,date:s}=e,r={};return s&&(r.date=s),this.client.get(`/form-thirteen/${t}`,"v3",r)}async getForm13FDates(e){let{cik:t}=e;return this.client.get(`/form-thirteen-date/${t}`,"v3")}async getInstitutionalHolders(e){let{symbol:t}=e;return this.client.get(`/institutional-holder/${t}`,"v3")}};var b=class{constructor(e){this.client=e;}async getStockList(){return this.client.get("/stock/list")}async getETFList(){return this.client.get("/etf/list")}async getCryptoList(){return this.client.get("/symbol/available-cryptocurrencies")}async getForexList(){return this.client.get("/symbol/available-forex-currency-pairs")}async getAvailableIndexes(){return this.client.get("/symbol/available-indexes")}};var h=class{constructor(e){this.client=e;}async getMarketHours(){return this.client.get("/market-hours","v3")}async getMarketPerformance(){return this.client.get("/quotes/index","v3")}async getGainers(){return this.client.get("/biggest-gainers","stable")}async getLosers(){return this.client.get("/biggest-losers","stable")}async getMostActive(){return this.client.get("/most-actives","stable")}async getSectorPerformance(){return this.client.get("/sector-performance","v3")}async getMarketIndex(){return this.client.get("/quotes/index","v3")}};var R=class{constructor(e){this.client=e;}async getHolders(e){return this.client.get(`/mutual-fund-holder/${e}`,"v3")}};var I=class{constructor(e){this.client=e;}async getArticles(e={}){let{page:t=1,limit:s=100}=e;return this.client.get("/fmp-articles","stable",{page:t,limit:s})}async getStockNews(e={}){let{from:t,to:s,page:r=1,limit:n=100}=e,o={page:r,limit:n};return t&&(o.from=t),s&&(o.to=s),this.client.get("/news/stock-latest","stable",o)}async getCryptoNews(e={}){let{from:t,to:s,page:r=1,limit:n=100}=e,o={page:r,limit:n};return t&&(o.from=t),s&&(o.to=s),this.client.get("/news/crypto-latest","stable",o)}async getForexNews(e={}){let{from:t,to:s,page:r=1,limit:n=100}=e,o={page:r,limit:n};return t&&(o.from=t),s&&(o.to=s),this.client.get("/news/forex-latest","stable",o)}async getStockNewsBySymbol(e){let{symbols:t,from:s,to:r,page:n=1,limit:o=100}=e,a=t.join(","),l={page:n,limit:o};return s&&(l.from=s),r&&(l.to=r),this.client.get(`/news/stock?symbols=${a}`,"stable",l)}async getCryptoNewsBySymbol(e){let{symbols:t,from:s,to:r,page:n=1,limit:o=100}=e,a=t.join(","),l={page:n,limit:o};return s&&(l.from=s),r&&(l.to=r),this.client.get(`/news/crypto?symbols=${a}`,"stable",l)}async getForexNewsBySymbol(e){let{symbols:t,from:s,to:r,page:n=1,limit:o=100}=e,a=t.join(","),l={page:n,limit:o};return s&&(l.from=s),r&&(l.to=r),this.client.get(`/news/forex?symbols=${a}`,"stable",l)}};var A=class{constructor(e){this.client=e;}async getQuote(e){return this.client.getSingle(`/quote/${e}`,"v3")}async getHistoricalPrice(e){let{symbol:t,from:s,to:r}=e,n={};return s&&(n.from=s),r&&(n.to=r),this.client.getSingle(`/historical-price-full/${t}`,"v3",n)}async getQuotes(e){let t=e.join(",");return this.client.get(`/quote/${t}`,"v3")}async getIntraday(e){let{symbol:t,interval:s,from:r,to:n}=e,o={};return r&&(o.from=r),n&&(o.to=n),this.client.get(`/historical-chart/${s}/${t}`,"v3",o)}};var S=class{constructor(e){this.client=e;}async getScreener(e){return this.client.get("/company-screener","stable",e)}async getAvailableExchanges(){return this.client.get("/available-exchanges","stable")}async getAvailableSectors(){return this.client.get("/available-sectors","stable")}async getAvailableIndustries(){return this.client.get("/available-industries","stable")}async getAvailableCountries(){return this.client.get("/available-countries","stable")}};var C=class{constructor(e){this.client=e;}async getRSSFeed(e){return this.client.get("/rss_feed","v4",e)}async getRSSFeedAll(e){return this.client.get("/rss_feed_all","v4",e)}async getRSSFeedV3(e){return this.client.get("/rss_feed","v3",e)}async getRSSFeed8K(e){return this.client.get("/rss_feed_8k","v4",e)}async getSECFilings({symbol:e,params:t}){return this.client.get(`/sec_filings/${e}`,"v3",t)}async getIndividualIndustryClassification(e){return this.client.getSingle("/standard_industrial_classification","v4",e)}async getAllIndustryClassifications(){return this.client.get("/standard_industrial_classification/all","v4")}async getIndustryClassificationCodes(e){return this.client.get("/standard_industrial_classification_list","v4",e)}};var E=class{constructor(e){this.client=e;}async getSenateTrading(e){let{symbol:t}=e;return this.client.get("/senate-trades","stable",{symbol:t})}async getSenateTradingRSSFeed(e){let{page:t,limit:s}=e;return this.client.get("/senate-latest","stable",{page:t,limit:s??100})}async getSenateTradingByName(e){let{name:t}=e;return this.client.get("/senate-trades-by-name","stable",{name:t})}async getHouseTrading(e){let{symbol:t}=e;return this.client.get("/house-trades","stable",{symbol:t})}async getHouseTradingRSSFeed(e){let{page:t,limit:s}=e;return this.client.get("/house-latest","stable",{page:t,limit:s??100})}async getHouseTradingByName(e){let{name:t}=e;return this.client.get("/house-trades-by-name","stable",{name:t})}};var T=class{constructor(e){this.client=e;}async getMarketCap(e){return this.client.getSingle(`/market-capitalization/${e}`,"v3")}async getStockSplits(e){return this.client.get(`/historical-price-full/stock_split/${e}`,"v3")}async getDividendHistory(e){return this.client.getSingle(`/historical-price-full/stock_dividend/${e}`,"v3")}async getRealTimePrice(e){let t=`stock/real-time-price/${e.join(",")}`,s=await this.client.get(t,"v3");if(s.success&&s.data&&!Array.isArray(s.data)){let n=s.data;if(typeof n=="object"&&n!==null&&"companiesPriceList"in n&&Array.isArray(n.companiesPriceList)){let o=n.companiesPriceList.filter(a=>a&&a.symbol);if(o.length>0)return {...s,data:o}}if(typeof n=="object"&&n!==null&&"stockList"in n&&Array.isArray(n.stockList)){let o=n.stockList.filter(a=>a&&a.symbol);if(o.length>0)return {...s,data:o}}return n.symbol?{...s,data:[n]}:(e.length===1&&console.warn(`No real-time price data found for symbol: ${e[0]}`),{...s,data:[]})}let r=s.data.filter(n=>n&&n.symbol);return {...s,data:r}}async getRealTimePriceForMultipleStocks(e){let t=`stock/full/real-time-price/${e.join(",")}`,s=await this.client.get(t,"v3");if(s.success&&s.data&&!Array.isArray(s.data)){let n=s.data;if(typeof n=="object"&&n!==null&&"companiesPriceList"in n&&Array.isArray(n.companiesPriceList)){let o=n.companiesPriceList.filter(a=>a&&a.symbol);if(o.length>0)return {...s,data:o}}if(typeof n=="object"&&n!==null&&"stockList"in n&&Array.isArray(n.stockList)){let o=n.stockList.filter(a=>a&&a.symbol);if(o.length>0)return {...s,data:o}}return n.symbol?{...s,data:[n]}:(e.length===1&&console.warn(`No full real-time price data found for symbol: ${e[0]}`),{...s,data:[]})}let r=s.data.filter(n=>n&&n.symbol);return {...s,data:r}}};var v=class{constructor(e={}){let t=e.apiKey||process.env.FMP_API_KEY;if(!t)throw new Error("FMP API key is required. Please provide it in the config or set the FMP_API_KEY environment variable.");if(!m.isValidApiKey(t))throw new Error("Invalid API key format");let s=new c({...e,apiKey:t});this.calendar=new p(s),this.company=new g(s),this.economic=new u(s),this.etf=new d(s),this.financial=new y(s),this.insider=new f(s),this.institutional=new P(s),this.list=new b(s),this.market=new h(s),this.mutualFund=new R(s),this.news=new I(s),this.quote=new A(s),this.screener=new S(s),this.sec=new C(s),this.senateHouse=new E(s),this.stock=new T(s);}getClient(){return this.stock.client}};function w(i,e="USD"){return new Intl.NumberFormat("en-US",{style:"currency",currency:e}).format(i)}function D(i,e=2){return `${i.toFixed(e)}%`}function L(i){return i>=1e12?`${(i/1e12).toFixed(2)}T`:i>=1e9?`${(i/1e9).toFixed(2)}B`:i>=1e6?`${(i/1e6).toFixed(2)}M`:i>=1e3?`${(i/1e3).toFixed(2)}K`:i.toString()}function N(i){return (typeof i=="string"?new Date(i):i).toISOString().split("T")[0]}function $(i){return i>=1e9?`${(i/1e9).toFixed(2)}B`:i>=1e6?`${(i/1e6).toFixed(2)}M`:i>=1e3?`${(i/1e3).toFixed(2)}K`:i.toString()}var _=1e4,H=100,q=1e3,U={ANNUAL:"annual",QUARTER:"quarter"},V={NYSE:"NYSE",NASDAQ:"NASDAQ",AMEX:"AMEX",TSX:"TSX",LSE:"LSE",ASX:"ASX",NSE:"NSE",BSE:"BSE"},O={TECHNOLOGY:"Technology",HEALTHCARE:"Healthcare",FINANCIAL:"Financial",CONSUMER_DISCRETIONARY:"Consumer Discretionary",CONSUMER_STAPLES:"Consumer Staples",INDUSTRIALS:"Industrials",ENERGY:"Energy",MATERIALS:"Materials",UTILITIES:"Utilities",REAL_ESTATE:"Real Estate",COMMUNICATION_SERVICES:"Communication Services"};
-exports.CalendarEndpoints=p;exports.CompanyEndpoints=g;exports.DEFAULT_LIMIT=H;exports.DEFAULT_TIMEOUT=_;exports.ETFEndpoints=d;exports.EXCHANGES=V;exports.EconomicEndpoints=u;exports.FMP=v;exports.FMPClient=c;exports.FMPValidation=m;exports.FinancialEndpoints=y;exports.InsiderEndpoints=f;exports.InstitutionalEndpoints=P;exports.ListEndpoints=b;exports.MAX_LIMIT=q;exports.MarketEndpoints=h;exports.MutualFundEndpoints=R;exports.NewsEndpoints=I;exports.PERIODS=U;exports.QuoteEndpoints=A;exports.SECEndpoints=C;exports.SECTORS=O;exports.ScreenerEndpoints=S;exports.SenateHouseEndpoints=E;exports.StockEndpoints=T;exports.formatCurrency=w;exports.formatDate=N;exports.formatLargeNumber=L;exports.formatPercentage=D;exports.formatVolume=$;
+'use strict';var v=require('axios');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var v__default=/*#__PURE__*/_interopDefault(v);var k=[/exclusive endpoint/i,/not available under your current/i,/premium/i,/special endpoint/i,/upgrade your plan/i];function F(n,e){let t=e?.trim()||"Unknown error occurred",r=k.some(s=>s.test(t));return n===429?{errorType:"rate-limit",message:`FMP rate limit reached: ${t}`}:n===401?{errorType:"auth",message:`FMP authentication failed (check your FMP_API_KEY): ${t}`}:n===402||n===403||r?{errorType:"plan-restricted",message:`This endpoint is not available on your current FMP plan. (${n}: ${t})`}:n===404?{errorType:"not-found",message:`Not found: ${t}`}:n===400?{errorType:"bad-request",message:`Invalid request: ${t}`}:n===0?{errorType:"network",message:`Network error: ${t}`}:{errorType:"unknown",message:t}}function w(n){return Array.isArray(n)&&n.length===1?n[0]:n}function D(n){return Array.isArray(n)?n:n??[]}function N(n){return n==null?{}:Array.isArray(n)&&n.length===0?{}:n}var c=class{constructor(e){if(!e.apiKey)throw new Error("API key is required for FMPClient");this.apiKey=e.apiKey,this.v3Client=v__default.default.create({baseURL:"https://financialmodelingprep.com/api/v3",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),this.v4Client=v__default.default.create({baseURL:"https://financialmodelingprep.com/api/v4",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),this.stableClient=v__default.default.create({baseURL:"https://financialmodelingprep.com/stable",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),[this.v3Client,this.v4Client,this.stableClient].forEach(t=>{t.interceptors.request.use(r=>(r.params={...r.params,apikey:this.apiKey},r));});}async get(e,t="v3",r){let s=this.getClientForVersion(t);try{let i=await s.get(e,{params:r}),o=i.data;return (Array.isArray(o)||o==null)&&(o=D(o)),{success:!0,data:o,error:null,status:i.status}}catch(i){return this.buildErrorResponse(i)}}async getSingle(e,t="v3",r){let s=this.getClientForVersion(t);try{let i=await s.get(e,{params:r});return {success:!0,data:N(w(i.data)),error:null,status:i.status}}catch(i){return this.buildErrorResponse(i)}}buildErrorResponse(e){let t=e?.response?.data,r=t&&typeof t=="object"?t["Error Message"]??t.message??null:typeof t=="string"?t:null,s=e?.response?.status??0,{errorType:i,message:o}=F(s,r||e?.message||"");return {success:false,data:null,error:o,errorType:i,status:s||500}}getClientForVersion(e){switch(e){case "v3":return this.v3Client;case "v4":return this.v4Client;case "stable":return this.stableClient;default:return this.v3Client}}};var m=class{static isValidSymbol(e){return !e||typeof e!="string"?false:/^[A-Z]{1,5}$/.test(e)}static isValidCryptoSymbol(e){return !e||typeof e!="string"?false:/^[A-Z]{2,10}(USD|EUR|GBP|JPY|CAD|AUD|CHF|CNY)$/.test(e)}static isValidForexPair(e){return !e||typeof e!="string"?false:/^[A-Z]{3}[A-Z]{3}$/.test(e)}static isValidDate(e){if(!e||typeof e!="string"||!/^\d{4}-\d{2}-\d{2}$/.test(e))return  false;let r=new Date(e);return !isNaN(r.getTime())&&r.toISOString().split("T")[0]===e}static isValidDateRange(e,t){if(!this.isValidDate(e)||!this.isValidDate(t))return  false;let r=new Date(e),s=new Date(t);return r<=s}static isValidResponse(e){return !!(e&&typeof e=="object"&&typeof e.success=="boolean")}static isValidApiKey(e){return !e||typeof e!="string"?false:/^[a-zA-Z0-9]{32,}$/.test(e)}static isValidPeriod(e){return !e||typeof e!="string"?false:["annual","quarter","fy"].includes(e.toLowerCase())}static isValidLimit(e){return typeof e=="number"&&Number.isInteger(e)&&e>0&&e<=1e3}static validateQuoteParams(e){let t=[];return e?(e.symbol?!this.isValidSymbol(e.symbol)&&!this.isValidCryptoSymbol(e.symbol)&&!this.isValidForexPair(e.symbol)&&t.push("Invalid symbol format"):t.push("Symbol is required"),e.from&&!this.isValidDate(e.from)&&t.push("Invalid from date format (expected YYYY-MM-DD)"),e.to&&!this.isValidDate(e.to)&&t.push("Invalid to date format (expected YYYY-MM-DD)"),e.from&&e.to&&!this.isValidDateRange(e.from,e.to)&&t.push("From date must be before or equal to to date"),t):(t.push("Parameters object is required"),t)}static validateFinancialParams(e){let t=[];return e?(e.symbol?this.isValidSymbol(e.symbol)||t.push("Invalid symbol format"):t.push("Symbol is required"),e.period&&!this.isValidPeriod(e.period)&&t.push('Invalid period (must be "annual", "quarter", or "FY")'),e.limit&&!this.isValidLimit(e.limit)&&t.push("Invalid limit (must be a positive integer <= 1000)"),t):(t.push("Parameters object is required"),t)}static validateDateRangeParams(e){let t=[];return e?(e.from&&!this.isValidDate(e.from)&&t.push("Invalid from date format (expected YYYY-MM-DD)"),e.to&&!this.isValidDate(e.to)&&t.push("Invalid to date format (expected YYYY-MM-DD)"),e.from&&e.to&&!this.isValidDateRange(e.from,e.to)&&t.push("From date must be before or equal to to date"),t):(t.push("Parameters object is required"),t)}static throwIfInvalid(e,t="Validation"){if(e.length>0)throw new Error(`${t} failed: ${e.join(", ")}`)}};var p=class{constructor(e){this._client=e;}async getEarningsCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/earning_calendar","v3",s)}async getEarningsConfirmed(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/earning-calendar-confirmed","v4",s)}async getDividendsCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/stock_dividend_calendar","v3",s)}async getEconomicsCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/economic_calendar","v3",s)}async getIPOCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/ipo_calendar","v3",s)}async getSplitsCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/stock_split_calendar","v3",s)}};var g=class{constructor(e){this.client=e;}async getCompanyProfile(e){return this.client.getSingle("/profile","stable",{symbol:e})}async getExecutiveCompensation(e){return this.client.get("/governance-executive-compensation","stable",{symbol:e})}async getCompanyNotes(e){return this.client.get("/company-notes","stable",{symbol:e})}async getHistoricalEmployeeCount(e){return this.client.get("/historical-employee-count","stable",{symbol:e})}async getSharesFloat(e){return this.client.getSingle("/shares-float","stable",{symbol:e})}async getHistoricalSharesFloat(e){return this.client.get("/historical/shares_float","v4",{symbol:e})}async getEarningsCallTranscript(e){let{symbol:t,year:r,quarter:s}=e;return this.client.getSingle(`/earning_call_transcript/${t}`,"v3",{year:r,quarter:s})}async getCompanyTranscriptData(e){return this.client.getSingle("/earning_call_transcript","v4",{symbol:e})}};var u=class{constructor(e){this.client=e;}async getTreasuryRates(e){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this.client.get("/treasury-rates","stable",s)}async getEconomicIndicators(e){let{name:t,from:r,to:s}=e,i={name:t};return r&&(i.from=r),s&&(i.to=s),this.client.get("/economic-indicators","stable",i)}};var d=class{constructor(e){this.client=e;}async getHoldingDates(e){return this.client.get("/etf-holdings/portfolio-date","v4",{symbol:e})}async getHoldings(e){let{symbol:t,date:r}=e,s={};return t&&(s.symbol=t),r&&(s.date=r),this.client.get("/etf-holdings","v4",s)}async getHolder(e){return this.client.get(`/etf-holder/${e}`,"v3")}async getProfile(e){return this.client.getSingle("/etf/info","stable",{symbol:e})}async getSectorWeighting(e){return this.client.get("/etf/sector-weightings","stable",{symbol:e})}async getCountryWeighting(e){return this.client.get("/etf/country-weightings","stable",{symbol:e})}async getStockExposure(e){return this.client.get(`/etf-stock-exposure/${e}`,"v3")}};var y=class{constructor(e){this.client=e;}async getIncomeStatement(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/income-statement?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getBalanceSheet(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/balance-sheet-statement?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getCashFlowStatement(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/cash-flow-statement?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getKeyMetrics(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/key-metrics?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getFinancialRatios(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/ratios?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getEnterpriseValue(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/enterprise-values?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getCashflowGrowth(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/cash-flow-statement-growth?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getIncomeGrowth(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/income-statement-growth?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getBalanceSheetGrowth(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/balance-sheet-statement-growth?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getFinancialGrowth(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/financial-growth?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getEarningsHistorical(e){let{symbol:t,limit:r=5}=e;return this.client.get(`/earnings?symbol=${t}&limit=${r}`,"stable")}async getEarningsSurprises(e){return this.client.get(`/earnings-surprises/${e}`,"v3")}};var f=class{constructor(e){this.client=e;}async getInsiderTradingRSS(e){let{page:t=0,limit:r=100}=e;return this.client.get("/insider-trading/latest","stable",{page:t,limit:r})}async searchInsiderTrading(e){let{symbol:t,reportingCik:r,companyCik:s,transactionType:i,page:o=0,limit:a=100}=e,l={page:o,limit:a};return t&&(l.symbol=t),r&&(l.reportingCik=r),s&&(l.companyCik=s),i&&(l.transactionType=i),this.client.get("/insider-trading/search","stable",l)}async getTransactionTypes(){return this.client.get("/insider-trading-transaction-type","stable")}async getInsidersBySymbol(e){let{symbol:t}=e;return this.client.get("/insider-roaster","v4",{symbol:t})}async getInsiderTradeStatistics(e){let{symbol:t}=e;return this.client.get("/insider-trading/statistics","stable",{symbol:t})}async getCikMapper(e){let{page:t=0}=e;return this.client.get("/mapper-cik-name","v4",{page:t})}async getCikMapperByName(e){let{name:t,page:r=0}=e;return this.client.get("/mapper-cik-name","v4",{name:t,page:r})}async getCikMapperBySymbol(e){let{symbol:t}=e;return this.client.getSingle(`/mapper-cik-company/${t}`,"v4")}async getBeneficialOwnership(e){let{symbol:t,limit:r=100}=e;return this.client.get("/acquisition-of-beneficial-ownership","stable",{symbol:t,limit:r})}async getFailToDeliver(e){let{symbol:t,page:r=0}=e;return this.client.get("/fail_to_deliver","v4",{symbol:t,page:r})}async getInsiderTradesBySymbol(e,t=0){return this.searchInsiderTrading({symbol:e,page:t})}async getInsiderTradesByType(e,t=0){return this.searchInsiderTrading({transactionType:e,page:t})}async getInsiderTradesByReportingCik(e,t=0){return this.searchInsiderTrading({reportingCik:e,page:t})}async getInsiderTradesByCompanyCik(e,t=0){return this.searchInsiderTrading({companyCik:e,page:t})}};var P=class{constructor(e){this.client=e;}async getForm13F(e){let{cik:t,date:r}=e,s={};return r&&(s.date=r),this.client.get(`/form-thirteen/${t}`,"v3",s)}async getForm13FDates(e){let{cik:t}=e;return this.client.get(`/form-thirteen-date/${t}`,"v3")}async getInstitutionalHolders(e){let{symbol:t}=e;return this.client.get(`/institutional-holder/${t}`,"v3")}};var b=class{constructor(e){this.client=e;}async getStockList(){return this.client.get("/stock/list")}async getETFList(){return this.client.get("/etf/list")}async getCryptoList(){return this.client.get("/symbol/available-cryptocurrencies")}async getForexList(){return this.client.get("/symbol/available-forex-currency-pairs")}async getAvailableIndexes(){return this.client.get("/symbol/available-indexes")}};var h=class{constructor(e){this.client=e;}async getMarketHours(){return this.client.get("/market-hours","v3")}async getMarketPerformance(){return this.client.get("/quotes/index","v3")}async getGainers(){return this.client.get("/biggest-gainers","stable")}async getLosers(){return this.client.get("/biggest-losers","stable")}async getMostActive(){return this.client.get("/most-actives","stable")}async getSectorPerformance(){return this.client.get("/sector-performance","v3")}async getMarketIndex(){return this.client.get("/quotes/index","v3")}};var R=class{constructor(e){this.client=e;}async getHolders(e){return this.client.get(`/mutual-fund-holder/${e}`,"v3")}};var I=class{constructor(e){this.client=e;}async getArticles(e={}){let{page:t=1,limit:r=100}=e;return this.client.get("/fmp-articles","stable",{page:t,limit:r})}async getStockNews(e={}){let{from:t,to:r,page:s=1,limit:i=100}=e,o={page:s,limit:i};return t&&(o.from=t),r&&(o.to=r),this.client.get("/news/stock-latest","stable",o)}async getCryptoNews(e={}){let{from:t,to:r,page:s=1,limit:i=100}=e,o={page:s,limit:i};return t&&(o.from=t),r&&(o.to=r),this.client.get("/news/crypto-latest","stable",o)}async getForexNews(e={}){let{from:t,to:r,page:s=1,limit:i=100}=e,o={page:s,limit:i};return t&&(o.from=t),r&&(o.to=r),this.client.get("/news/forex-latest","stable",o)}async getStockNewsBySymbol(e){let{symbols:t,from:r,to:s,page:i=1,limit:o=100}=e,a=t.join(","),l={page:i,limit:o};return r&&(l.from=r),s&&(l.to=s),this.client.get(`/news/stock?symbols=${a}`,"stable",l)}async getCryptoNewsBySymbol(e){let{symbols:t,from:r,to:s,page:i=1,limit:o=100}=e,a=t.join(","),l={page:i,limit:o};return r&&(l.from=r),s&&(l.to=s),this.client.get(`/news/crypto?symbols=${a}`,"stable",l)}async getForexNewsBySymbol(e){let{symbols:t,from:r,to:s,page:i=1,limit:o=100}=e,a=t.join(","),l={page:i,limit:o};return r&&(l.from=r),s&&(l.to=s),this.client.get(`/news/forex?symbols=${a}`,"stable",l)}};var A=class{constructor(e){this.client=e;}async getQuote(e){return this.client.getSingle(`/quote/${e}`,"v3")}async getHistoricalPrice(e){let{symbol:t,from:r,to:s}=e,i={};return r&&(i.from=r),s&&(i.to=s),this.client.getSingle(`/historical-price-full/${t}`,"v3",i)}async getQuotes(e){let t=e.join(",");return this.client.get(`/quote/${t}`,"v3")}async getIntraday(e){let{symbol:t,interval:r,from:s,to:i}=e,o={};return s&&(o.from=s),i&&(o.to=i),this.client.get(`/historical-chart/${r}/${t}`,"v3",o)}};var S=class{constructor(e){this.client=e;}async getScreener(e){return this.client.get("/company-screener","stable",e)}async getAvailableExchanges(){return this.client.get("/available-exchanges","stable")}async getAvailableSectors(){return this.client.get("/available-sectors","stable")}async getAvailableIndustries(){return this.client.get("/available-industries","stable")}async getAvailableCountries(){return this.client.get("/available-countries","stable")}};var C=class{constructor(e){this.client=e;}async getRSSFeed(e){return this.client.get("/rss_feed","v4",e)}async getRSSFeedAll(e){return this.client.get("/rss_feed_all","v4",e)}async getRSSFeedV3(e){return this.client.get("/rss_feed","v3",e)}async getRSSFeed8K(e){return this.client.get("/rss_feed_8k","v4",e)}async getSECFilings({symbol:e,params:t}){return this.client.get(`/sec_filings/${e}`,"v3",t)}async getIndividualIndustryClassification(e){return this.client.getSingle("/standard_industrial_classification","v4",e)}async getAllIndustryClassifications(){return this.client.get("/standard_industrial_classification/all","v4")}async getIndustryClassificationCodes(e){return this.client.get("/standard_industrial_classification_list","v4",e)}};var E=class{constructor(e){this.client=e;}async getSenateTrading(e){let{symbol:t}=e;return this.client.get("/senate-trades","stable",{symbol:t})}async getSenateTradingRSSFeed(e){let{page:t,limit:r}=e;return this.client.get("/senate-latest","stable",{page:t,limit:r??100})}async getSenateTradingByName(e){let{name:t}=e;return this.client.get("/senate-trades-by-name","stable",{name:t})}async getHouseTrading(e){let{symbol:t}=e;return this.client.get("/house-trades","stable",{symbol:t})}async getHouseTradingRSSFeed(e){let{page:t,limit:r}=e;return this.client.get("/house-latest","stable",{page:t,limit:r??100})}async getHouseTradingByName(e){let{name:t}=e;return this.client.get("/house-trades-by-name","stable",{name:t})}};var T=class{constructor(e){this.client=e;}async getMarketCap(e){return this.client.getSingle(`/market-capitalization/${e}`,"v3")}async getStockSplits(e){return this.client.get(`/historical-price-full/stock_split/${e}`,"v3")}async getDividendHistory(e){return this.client.getSingle(`/historical-price-full/stock_dividend/${e}`,"v3")}async getRealTimePrice(e){let t=`stock/real-time-price/${e.join(",")}`,r=await this.client.get(t,"v3");if(r.success&&r.data&&!Array.isArray(r.data)){let i=r.data;if(typeof i=="object"&&i!==null&&"companiesPriceList"in i&&Array.isArray(i.companiesPriceList)){let o=i.companiesPriceList.filter(a=>a&&a.symbol);if(o.length>0)return {...r,data:o}}if(typeof i=="object"&&i!==null&&"stockList"in i&&Array.isArray(i.stockList)){let o=i.stockList.filter(a=>a&&a.symbol);if(o.length>0)return {...r,data:o}}return i.symbol?{...r,data:[i]}:(e.length===1&&console.warn(`No real-time price data found for symbol: ${e[0]}`),{...r,data:[]})}let s=r.data.filter(i=>i&&i.symbol);return {...r,data:s}}async getRealTimePriceForMultipleStocks(e){let t=`stock/full/real-time-price/${e.join(",")}`,r=await this.client.get(t,"v3");if(r.success&&r.data&&!Array.isArray(r.data)){let i=r.data;if(typeof i=="object"&&i!==null&&"companiesPriceList"in i&&Array.isArray(i.companiesPriceList)){let o=i.companiesPriceList.filter(a=>a&&a.symbol);if(o.length>0)return {...r,data:o}}if(typeof i=="object"&&i!==null&&"stockList"in i&&Array.isArray(i.stockList)){let o=i.stockList.filter(a=>a&&a.symbol);if(o.length>0)return {...r,data:o}}return i.symbol?{...r,data:[i]}:(e.length===1&&console.warn(`No full real-time price data found for symbol: ${e[0]}`),{...r,data:[]})}let s=r.data.filter(i=>i&&i.symbol);return {...r,data:s}}};var M=class{constructor(e={}){let t=e.apiKey||process.env.FMP_API_KEY;if(!t)throw new Error("FMP API key is required. Please provide it in the config or set the FMP_API_KEY environment variable.");if(!m.isValidApiKey(t))throw new Error("Invalid API key format");let r=new c({...e,apiKey:t});this.calendar=new p(r),this.company=new g(r),this.economic=new u(r),this.etf=new d(r),this.financial=new y(r),this.insider=new f(r),this.institutional=new P(r),this.list=new b(r),this.market=new h(r),this.mutualFund=new R(r),this.news=new I(r),this.quote=new A(r),this.screener=new S(r),this.sec=new C(r),this.senateHouse=new E(r),this.stock=new T(r);}getClient(){return this.stock.client}};function $(n,e="USD"){return new Intl.NumberFormat("en-US",{style:"currency",currency:e}).format(n)}function L(n,e=2){return `${n.toFixed(e)}%`}function _(n){return n>=1e12?`${(n/1e12).toFixed(2)}T`:n>=1e9?`${(n/1e9).toFixed(2)}B`:n>=1e6?`${(n/1e6).toFixed(2)}M`:n>=1e3?`${(n/1e3).toFixed(2)}K`:n.toString()}function q(n){return (typeof n=="string"?new Date(n):n).toISOString().split("T")[0]}function H(n){return n>=1e9?`${(n/1e9).toFixed(2)}B`:n>=1e6?`${(n/1e6).toFixed(2)}M`:n>=1e3?`${(n/1e3).toFixed(2)}K`:n.toString()}var U=1e4,O=100,V=1e3,B={ANNUAL:"annual",QUARTER:"quarter"},Y={NYSE:"NYSE",NASDAQ:"NASDAQ",AMEX:"AMEX",TSX:"TSX",LSE:"LSE",ASX:"ASX",NSE:"NSE",BSE:"BSE"},G={TECHNOLOGY:"Technology",HEALTHCARE:"Healthcare",FINANCIAL:"Financial",CONSUMER_DISCRETIONARY:"Consumer Discretionary",CONSUMER_STAPLES:"Consumer Staples",INDUSTRIALS:"Industrials",ENERGY:"Energy",MATERIALS:"Materials",UTILITIES:"Utilities",REAL_ESTATE:"Real Estate",COMMUNICATION_SERVICES:"Communication Services"};var x=class extends Error{constructor(t,r,s){super(t);this.status=r;this.code=s;this.name="FMPError";}};
+exports.CalendarEndpoints=p;exports.CompanyEndpoints=g;exports.DEFAULT_LIMIT=O;exports.DEFAULT_TIMEOUT=U;exports.ETFEndpoints=d;exports.EXCHANGES=Y;exports.EconomicEndpoints=u;exports.FMP=M;exports.FMPClient=c;exports.FMPError=x;exports.FMPValidation=m;exports.FinancialEndpoints=y;exports.InsiderEndpoints=f;exports.InstitutionalEndpoints=P;exports.ListEndpoints=b;exports.MAX_LIMIT=V;exports.MarketEndpoints=h;exports.MutualFundEndpoints=R;exports.NewsEndpoints=I;exports.PERIODS=B;exports.QuoteEndpoints=A;exports.SECEndpoints=C;exports.SECTORS=G;exports.ScreenerEndpoints=S;exports.SenateHouseEndpoints=E;exports.StockEndpoints=T;exports.classifyError=F;exports.formatCurrency=$;exports.formatDate=q;exports.formatLargeNumber=_;exports.formatPercentage=L;exports.formatVolume=H;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {a}from'./chunk-RM7ETDL3.mjs';export{a as FMPValidation}from'./chunk-RM7ETDL3.mjs';import F from'axios';function k(i){return Array.isArray(i)&&i.length===1?i[0]:i}function M(i){return Array.isArray(i)?i:i??[]}function x(i){return i==null?{}:Array.isArray(i)&&i.length===0?{}:i}var c=class{constructor(e){if(!e.apiKey)throw new Error("API key is required for FMPClient");this.apiKey=e.apiKey,this.v3Client=F.create({baseURL:"https://financialmodelingprep.com/api/v3",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),this.v4Client=F.create({baseURL:"https://financialmodelingprep.com/api/v4",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),this.stableClient=F.create({baseURL:"https://financialmodelingprep.com/stable",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),[this.v3Client,this.v4Client,this.stableClient].forEach(s=>{s.interceptors.request.use(t=>(t.params={...t.params,apikey:this.apiKey},t));});}async get(e,s="v3",t){let n=this.getClientForVersion(s);try{let r=await n.get(e,{params:t}),o=r.data;return (Array.isArray(o)||o==null)&&(o=M(o)),{success:!0,data:o,error:null,status:r.status}}catch(r){return {success:false,data:null,error:r.message||"Unknown error occurred",status:r.response?.status||500}}}async getSingle(e,s="v3",t){let n=this.getClientForVersion(s);try{let r=await n.get(e,{params:t});return {success:!0,data:x(k(r.data)),error:null,status:r.status}}catch(r){return {success:false,data:null,error:r.message||"Unknown error occurred",status:r.response?.status||500}}}getClientForVersion(e){switch(e){case "v3":return this.v3Client;case "v4":return this.v4Client;case "stable":return this.stableClient;default:return this.v3Client}}};var m=class{constructor(e){this._client=e;}async getEarningsCalendar(e={}){let{from:s,to:t}=e,n={};return s&&(n.from=s),t&&(n.to=t),this._client.get("/earning_calendar","v3",n)}async getEarningsConfirmed(e={}){let{from:s,to:t}=e,n={};return s&&(n.from=s),t&&(n.to=t),this._client.get("/earning-calendar-confirmed","v4",n)}async getDividendsCalendar(e={}){let{from:s,to:t}=e,n={};return s&&(n.from=s),t&&(n.to=t),this._client.get("/stock_dividend_calendar","v3",n)}async getEconomicsCalendar(e={}){let{from:s,to:t}=e,n={};return s&&(n.from=s),t&&(n.to=t),this._client.get("/economic_calendar","v3",n)}async getIPOCalendar(e={}){let{from:s,to:t}=e,n={};return s&&(n.from=s),t&&(n.to=t),this._client.get("/ipo_calendar","v3",n)}async getSplitsCalendar(e={}){let{from:s,to:t}=e,n={};return s&&(n.from=s),t&&(n.to=t),this._client.get("/stock_split_calendar","v3",n)}};var p=class{constructor(e){this.client=e;}async getCompanyProfile(e){return this.client.getSingle("/profile","stable",{symbol:e})}async getExecutiveCompensation(e){return this.client.get("/governance-executive-compensation","stable",{symbol:e})}async getCompanyNotes(e){return this.client.get("/company-notes","stable",{symbol:e})}async getHistoricalEmployeeCount(e){return this.client.get("/historical-employee-count","stable",{symbol:e})}async getSharesFloat(e){return this.client.getSingle("/shares-float","stable",{symbol:e})}async getHistoricalSharesFloat(e){return this.client.get("/historical/shares_float","v4",{symbol:e})}async getEarningsCallTranscript(e){let{symbol:s,year:t,quarter:n}=e;return this.client.getSingle(`/earning_call_transcript/${s}`,"v3",{year:t,quarter:n})}async getCompanyTranscriptData(e){return this.client.getSingle("/earning_call_transcript","v4",{symbol:e})}};var g=class{constructor(e){this.client=e;}async getTreasuryRates(e){let{from:s,to:t}=e,n={};return s&&(n.from=s),t&&(n.to=t),this.client.get("/treasury-rates","stable",n)}async getEconomicIndicators(e){let{name:s,from:t,to:n}=e,r={name:s};return t&&(r.from=t),n&&(r.to=n),this.client.get("/economic-indicators","stable",r)}};var u=class{constructor(e){this.client=e;}async getHoldingDates(e){return this.client.get("/etf-holdings/portfolio-date","v4",{symbol:e})}async getHoldings(e){let{symbol:s,date:t}=e,n={};return s&&(n.symbol=s),t&&(n.date=t),this.client.get("/etf-holdings","v4",n)}async getHolder(e){return this.client.get(`/etf-holder/${e}`,"v3")}async getProfile(e){return this.client.getSingle("/etf/info","stable",{symbol:e})}async getSectorWeighting(e){return this.client.get("/etf/sector-weightings","stable",{symbol:e})}async getCountryWeighting(e){return this.client.get("/etf/country-weightings","stable",{symbol:e})}async getStockExposure(e){return this.client.get(`/etf-stock-exposure/${e}`,"v3")}};var d=class{constructor(e){this.client=e;}async getIncomeStatement(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/income-statement?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getBalanceSheet(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/balance-sheet-statement?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getCashFlowStatement(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/cash-flow-statement?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getKeyMetrics(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/key-metrics?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getFinancialRatios(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/ratios?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getEnterpriseValue(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/enterprise-values?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getCashflowGrowth(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/cash-flow-statement-growth?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getIncomeGrowth(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/income-statement-growth?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getBalanceSheetGrowth(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/balance-sheet-statement-growth?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getFinancialGrowth(e){let{symbol:s,period:t="annual",limit:n=5}=e;return this.client.get(`/financial-growth?symbol=${s}&period=${t}&limit=${n}`,"stable")}async getEarningsHistorical(e){let{symbol:s,limit:t=5}=e;return this.client.get(`/earnings?symbol=${s}&limit=${t}`,"stable")}async getEarningsSurprises(e){return this.client.get(`/earnings-surprises/${e}`,"v3")}};var y=class{constructor(e){this.client=e;}async getInsiderTradingRSS(e){let{page:s=0,limit:t=100}=e;return this.client.get("/insider-trading/latest","stable",{page:s,limit:t})}async searchInsiderTrading(e){let{symbol:s,reportingCik:t,companyCik:n,transactionType:r,page:o=0,limit:a=100}=e,l={page:o,limit:a};return s&&(l.symbol=s),t&&(l.reportingCik=t),n&&(l.companyCik=n),r&&(l.transactionType=r),this.client.get("/insider-trading/search","stable",l)}async getTransactionTypes(){return this.client.get("/insider-trading-transaction-type","stable")}async getInsidersBySymbol(e){let{symbol:s}=e;return this.client.get("/insider-roaster","v4",{symbol:s})}async getInsiderTradeStatistics(e){let{symbol:s}=e;return this.client.get("/insider-trading/statistics","stable",{symbol:s})}async getCikMapper(e){let{page:s=0}=e;return this.client.get("/mapper-cik-name","v4",{page:s})}async getCikMapperByName(e){let{name:s,page:t=0}=e;return this.client.get("/mapper-cik-name","v4",{name:s,page:t})}async getCikMapperBySymbol(e){let{symbol:s}=e;return this.client.getSingle(`/mapper-cik-company/${s}`,"v4")}async getBeneficialOwnership(e){let{symbol:s,limit:t=100}=e;return this.client.get("/acquisition-of-beneficial-ownership","stable",{symbol:s,limit:t})}async getFailToDeliver(e){let{symbol:s,page:t=0}=e;return this.client.get("/fail_to_deliver","v4",{symbol:s,page:t})}async getInsiderTradesBySymbol(e,s=0){return this.searchInsiderTrading({symbol:e,page:s})}async getInsiderTradesByType(e,s=0){return this.searchInsiderTrading({transactionType:e,page:s})}async getInsiderTradesByReportingCik(e,s=0){return this.searchInsiderTrading({reportingCik:e,page:s})}async getInsiderTradesByCompanyCik(e,s=0){return this.searchInsiderTrading({companyCik:e,page:s})}};var P=class{constructor(e){this.client=e;}async getForm13F(e){let{cik:s,date:t}=e,n={};return t&&(n.date=t),this.client.get(`/form-thirteen/${s}`,"v3",n)}async getForm13FDates(e){let{cik:s}=e;return this.client.get(`/form-thirteen-date/${s}`,"v3")}async getInstitutionalHolders(e){let{symbol:s}=e;return this.client.get(`/institutional-holder/${s}`,"v3")}};var f=class{constructor(e){this.client=e;}async getStockList(){return this.client.get("/stock/list")}async getETFList(){return this.client.get("/etf/list")}async getCryptoList(){return this.client.get("/symbol/available-cryptocurrencies")}async getForexList(){return this.client.get("/symbol/available-forex-currency-pairs")}async getAvailableIndexes(){return this.client.get("/symbol/available-indexes")}};var b=class{constructor(e){this.client=e;}async getMarketHours(){return this.client.get("/market-hours","v3")}async getMarketPerformance(){return this.client.get("/quotes/index","v3")}async getGainers(){return this.client.get("/biggest-gainers","stable")}async getLosers(){return this.client.get("/biggest-losers","stable")}async getMostActive(){return this.client.get("/most-actives","stable")}async getSectorPerformance(){return this.client.get("/sector-performance","v3")}async getMarketIndex(){return this.client.get("/quotes/index","v3")}};var R=class{constructor(e){this.client=e;}async getHolders(e){return this.client.get(`/mutual-fund-holder/${e}`,"v3")}};var I=class{constructor(e){this.client=e;}async getArticles(e={}){let{page:s=1,limit:t=100}=e;return this.client.get("/fmp-articles","stable",{page:s,limit:t})}async getStockNews(e={}){let{from:s,to:t,page:n=1,limit:r=100}=e,o={page:n,limit:r};return s&&(o.from=s),t&&(o.to=t),this.client.get("/news/stock-latest","stable",o)}async getCryptoNews(e={}){let{from:s,to:t,page:n=1,limit:r=100}=e,o={page:n,limit:r};return s&&(o.from=s),t&&(o.to=t),this.client.get("/news/crypto-latest","stable",o)}async getForexNews(e={}){let{from:s,to:t,page:n=1,limit:r=100}=e,o={page:n,limit:r};return s&&(o.from=s),t&&(o.to=t),this.client.get("/news/forex-latest","stable",o)}async getStockNewsBySymbol(e){let{symbols:s,from:t,to:n,page:r=1,limit:o=100}=e,a=s.join(","),l={page:r,limit:o};return t&&(l.from=t),n&&(l.to=n),this.client.get(`/news/stock?symbols=${a}`,"stable",l)}async getCryptoNewsBySymbol(e){let{symbols:s,from:t,to:n,page:r=1,limit:o=100}=e,a=s.join(","),l={page:r,limit:o};return t&&(l.from=t),n&&(l.to=n),this.client.get(`/news/crypto?symbols=${a}`,"stable",l)}async getForexNewsBySymbol(e){let{symbols:s,from:t,to:n,page:r=1,limit:o=100}=e,a=s.join(","),l={page:r,limit:o};return t&&(l.from=t),n&&(l.to=n),this.client.get(`/news/forex?symbols=${a}`,"stable",l)}};var h=class{constructor(e){this.client=e;}async getQuote(e){return this.client.getSingle(`/quote/${e}`,"v3")}async getHistoricalPrice(e){let{symbol:s,from:t,to:n}=e,r={};return t&&(r.from=t),n&&(r.to=n),this.client.getSingle(`/historical-price-full/${s}`,"v3",r)}async getQuotes(e){let s=e.join(",");return this.client.get(`/quote/${s}`,"v3")}async getIntraday(e){let{symbol:s,interval:t,from:n,to:r}=e,o={};return n&&(o.from=n),r&&(o.to=r),this.client.get(`/historical-chart/${t}/${s}`,"v3",o)}};var A=class{constructor(e){this.client=e;}async getScreener(e){return this.client.get("/company-screener","stable",e)}async getAvailableExchanges(){return this.client.get("/available-exchanges","stable")}async getAvailableSectors(){return this.client.get("/available-sectors","stable")}async getAvailableIndustries(){return this.client.get("/available-industries","stable")}async getAvailableCountries(){return this.client.get("/available-countries","stable")}};var S=class{constructor(e){this.client=e;}async getRSSFeed(e){return this.client.get("/rss_feed","v4",e)}async getRSSFeedAll(e){return this.client.get("/rss_feed_all","v4",e)}async getRSSFeedV3(e){return this.client.get("/rss_feed","v3",e)}async getRSSFeed8K(e){return this.client.get("/rss_feed_8k","v4",e)}async getSECFilings({symbol:e,params:s}){return this.client.get(`/sec_filings/${e}`,"v3",s)}async getIndividualIndustryClassification(e){return this.client.getSingle("/standard_industrial_classification","v4",e)}async getAllIndustryClassifications(){return this.client.get("/standard_industrial_classification/all","v4")}async getIndustryClassificationCodes(e){return this.client.get("/standard_industrial_classification_list","v4",e)}};var C=class{constructor(e){this.client=e;}async getSenateTrading(e){let{symbol:s}=e;return this.client.get("/senate-trades","stable",{symbol:s})}async getSenateTradingRSSFeed(e){let{page:s,limit:t}=e;return this.client.get("/senate-latest","stable",{page:s,limit:t??100})}async getSenateTradingByName(e){let{name:s}=e;return this.client.get("/senate-trades-by-name","stable",{name:s})}async getHouseTrading(e){let{symbol:s}=e;return this.client.get("/house-trades","stable",{symbol:s})}async getHouseTradingRSSFeed(e){let{page:s,limit:t}=e;return this.client.get("/house-latest","stable",{page:s,limit:t??100})}async getHouseTradingByName(e){let{name:s}=e;return this.client.get("/house-trades-by-name","stable",{name:s})}};var E=class{constructor(e){this.client=e;}async getMarketCap(e){return this.client.getSingle(`/market-capitalization/${e}`,"v3")}async getStockSplits(e){return this.client.get(`/historical-price-full/stock_split/${e}`,"v3")}async getDividendHistory(e){return this.client.getSingle(`/historical-price-full/stock_dividend/${e}`,"v3")}async getRealTimePrice(e){let s=`stock/real-time-price/${e.join(",")}`,t=await this.client.get(s,"v3");if(t.success&&t.data&&!Array.isArray(t.data)){let r=t.data;if(typeof r=="object"&&r!==null&&"companiesPriceList"in r&&Array.isArray(r.companiesPriceList)){let o=r.companiesPriceList.filter(a=>a&&a.symbol);if(o.length>0)return {...t,data:o}}if(typeof r=="object"&&r!==null&&"stockList"in r&&Array.isArray(r.stockList)){let o=r.stockList.filter(a=>a&&a.symbol);if(o.length>0)return {...t,data:o}}return r.symbol?{...t,data:[r]}:(e.length===1&&console.warn(`No real-time price data found for symbol: ${e[0]}`),{...t,data:[]})}let n=t.data.filter(r=>r&&r.symbol);return {...t,data:n}}async getRealTimePriceForMultipleStocks(e){let s=`stock/full/real-time-price/${e.join(",")}`,t=await this.client.get(s,"v3");if(t.success&&t.data&&!Array.isArray(t.data)){let r=t.data;if(typeof r=="object"&&r!==null&&"companiesPriceList"in r&&Array.isArray(r.companiesPriceList)){let o=r.companiesPriceList.filter(a=>a&&a.symbol);if(o.length>0)return {...t,data:o}}if(typeof r=="object"&&r!==null&&"stockList"in r&&Array.isArray(r.stockList)){let o=r.stockList.filter(a=>a&&a.symbol);if(o.length>0)return {...t,data:o}}return r.symbol?{...t,data:[r]}:(e.length===1&&console.warn(`No full real-time price data found for symbol: ${e[0]}`),{...t,data:[]})}let n=t.data.filter(r=>r&&r.symbol);return {...t,data:n}}};var v=class{constructor(e={}){let s=e.apiKey||process.env.FMP_API_KEY;if(!s)throw new Error("FMP API key is required. Please provide it in the config or set the FMP_API_KEY environment variable.");if(!a.isValidApiKey(s))throw new Error("Invalid API key format");let t=new c({...e,apiKey:s});this.calendar=new m(t),this.company=new p(t),this.economic=new g(t),this.etf=new u(t),this.financial=new d(t),this.insider=new y(t),this.institutional=new P(t),this.list=new f(t),this.market=new b(t),this.mutualFund=new R(t),this.news=new I(t),this.quote=new h(t),this.screener=new A(t),this.sec=new S(t),this.senateHouse=new C(t),this.stock=new E(t);}getClient(){return this.stock.client}};function w(i,e="USD"){return new Intl.NumberFormat("en-US",{style:"currency",currency:e}).format(i)}function D(i,e=2){return `${i.toFixed(e)}%`}function L(i){return i>=1e12?`${(i/1e12).toFixed(2)}T`:i>=1e9?`${(i/1e9).toFixed(2)}B`:i>=1e6?`${(i/1e6).toFixed(2)}M`:i>=1e3?`${(i/1e3).toFixed(2)}K`:i.toString()}function N(i){return (typeof i=="string"?new Date(i):i).toISOString().split("T")[0]}function _(i){return i>=1e9?`${(i/1e9).toFixed(2)}B`:i>=1e6?`${(i/1e6).toFixed(2)}M`:i>=1e3?`${(i/1e3).toFixed(2)}K`:i.toString()}var $=1e4,H=100,q=1e3,U={ANNUAL:"annual",QUARTER:"quarter"},O={NYSE:"NYSE",NASDAQ:"NASDAQ",AMEX:"AMEX",TSX:"TSX",LSE:"LSE",ASX:"ASX",NSE:"NSE",BSE:"BSE"},B={TECHNOLOGY:"Technology",HEALTHCARE:"Healthcare",FINANCIAL:"Financial",CONSUMER_DISCRETIONARY:"Consumer Discretionary",CONSUMER_STAPLES:"Consumer Staples",INDUSTRIALS:"Industrials",ENERGY:"Energy",MATERIALS:"Materials",UTILITIES:"Utilities",REAL_ESTATE:"Real Estate",COMMUNICATION_SERVICES:"Communication Services"};
-export{m as CalendarEndpoints,p as CompanyEndpoints,H as DEFAULT_LIMIT,$ as DEFAULT_TIMEOUT,u as ETFEndpoints,O as EXCHANGES,g as EconomicEndpoints,v as FMP,c as FMPClient,d as FinancialEndpoints,y as InsiderEndpoints,P as InstitutionalEndpoints,f as ListEndpoints,q as MAX_LIMIT,b as MarketEndpoints,R as MutualFundEndpoints,I as NewsEndpoints,U as PERIODS,h as QuoteEndpoints,S as SECEndpoints,B as SECTORS,A as ScreenerEndpoints,C as SenateHouseEndpoints,E as StockEndpoints,w as formatCurrency,N as formatDate,L as formatLargeNumber,D as formatPercentage,_ as formatVolume};
+import {a}from'./chunk-RM7ETDL3.mjs';export{a as FMPValidation}from'./chunk-RM7ETDL3.mjs';import v from'axios';var x=[/exclusive endpoint/i,/not available under your current/i,/premium/i,/special endpoint/i,/upgrade your plan/i];function F(i,e){let t=e?.trim()||"Unknown error occurred",r=x.some(s=>s.test(t));return i===429?{errorType:"rate-limit",message:`FMP rate limit reached: ${t}`}:i===401?{errorType:"auth",message:`FMP authentication failed (check your FMP_API_KEY): ${t}`}:i===402||i===403||r?{errorType:"plan-restricted",message:`This endpoint is not available on your current FMP plan. (${i}: ${t})`}:i===404?{errorType:"not-found",message:`Not found: ${t}`}:i===400?{errorType:"bad-request",message:`Invalid request: ${t}`}:i===0?{errorType:"network",message:`Network error: ${t}`}:{errorType:"unknown",message:t}}function w(i){return Array.isArray(i)&&i.length===1?i[0]:i}function D(i){return Array.isArray(i)?i:i??[]}function L(i){return i==null?{}:Array.isArray(i)&&i.length===0?{}:i}var c=class{constructor(e){if(!e.apiKey)throw new Error("API key is required for FMPClient");this.apiKey=e.apiKey,this.v3Client=v.create({baseURL:"https://financialmodelingprep.com/api/v3",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),this.v4Client=v.create({baseURL:"https://financialmodelingprep.com/api/v4",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),this.stableClient=v.create({baseURL:"https://financialmodelingprep.com/stable",timeout:e.timeout||1e4,headers:{"Content-Type":"application/json"}}),[this.v3Client,this.v4Client,this.stableClient].forEach(t=>{t.interceptors.request.use(r=>(r.params={...r.params,apikey:this.apiKey},r));});}async get(e,t="v3",r){let s=this.getClientForVersion(t);try{let n=await s.get(e,{params:r}),o=n.data;return (Array.isArray(o)||o==null)&&(o=D(o)),{success:!0,data:o,error:null,status:n.status}}catch(n){return this.buildErrorResponse(n)}}async getSingle(e,t="v3",r){let s=this.getClientForVersion(t);try{let n=await s.get(e,{params:r});return {success:!0,data:L(w(n.data)),error:null,status:n.status}}catch(n){return this.buildErrorResponse(n)}}buildErrorResponse(e){let t=e?.response?.data,r=t&&typeof t=="object"?t["Error Message"]??t.message??null:typeof t=="string"?t:null,s=e?.response?.status??0,{errorType:n,message:o}=F(s,r||e?.message||"");return {success:false,data:null,error:o,errorType:n,status:s||500}}getClientForVersion(e){switch(e){case "v3":return this.v3Client;case "v4":return this.v4Client;case "stable":return this.stableClient;default:return this.v3Client}}};var m=class{constructor(e){this._client=e;}async getEarningsCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/earning_calendar","v3",s)}async getEarningsConfirmed(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/earning-calendar-confirmed","v4",s)}async getDividendsCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/stock_dividend_calendar","v3",s)}async getEconomicsCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/economic_calendar","v3",s)}async getIPOCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/ipo_calendar","v3",s)}async getSplitsCalendar(e={}){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this._client.get("/stock_split_calendar","v3",s)}};var p=class{constructor(e){this.client=e;}async getCompanyProfile(e){return this.client.getSingle("/profile","stable",{symbol:e})}async getExecutiveCompensation(e){return this.client.get("/governance-executive-compensation","stable",{symbol:e})}async getCompanyNotes(e){return this.client.get("/company-notes","stable",{symbol:e})}async getHistoricalEmployeeCount(e){return this.client.get("/historical-employee-count","stable",{symbol:e})}async getSharesFloat(e){return this.client.getSingle("/shares-float","stable",{symbol:e})}async getHistoricalSharesFloat(e){return this.client.get("/historical/shares_float","v4",{symbol:e})}async getEarningsCallTranscript(e){let{symbol:t,year:r,quarter:s}=e;return this.client.getSingle(`/earning_call_transcript/${t}`,"v3",{year:r,quarter:s})}async getCompanyTranscriptData(e){return this.client.getSingle("/earning_call_transcript","v4",{symbol:e})}};var g=class{constructor(e){this.client=e;}async getTreasuryRates(e){let{from:t,to:r}=e,s={};return t&&(s.from=t),r&&(s.to=r),this.client.get("/treasury-rates","stable",s)}async getEconomicIndicators(e){let{name:t,from:r,to:s}=e,n={name:t};return r&&(n.from=r),s&&(n.to=s),this.client.get("/economic-indicators","stable",n)}};var u=class{constructor(e){this.client=e;}async getHoldingDates(e){return this.client.get("/etf-holdings/portfolio-date","v4",{symbol:e})}async getHoldings(e){let{symbol:t,date:r}=e,s={};return t&&(s.symbol=t),r&&(s.date=r),this.client.get("/etf-holdings","v4",s)}async getHolder(e){return this.client.get(`/etf-holder/${e}`,"v3")}async getProfile(e){return this.client.getSingle("/etf/info","stable",{symbol:e})}async getSectorWeighting(e){return this.client.get("/etf/sector-weightings","stable",{symbol:e})}async getCountryWeighting(e){return this.client.get("/etf/country-weightings","stable",{symbol:e})}async getStockExposure(e){return this.client.get(`/etf-stock-exposure/${e}`,"v3")}};var d=class{constructor(e){this.client=e;}async getIncomeStatement(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/income-statement?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getBalanceSheet(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/balance-sheet-statement?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getCashFlowStatement(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/cash-flow-statement?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getKeyMetrics(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/key-metrics?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getFinancialRatios(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/ratios?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getEnterpriseValue(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/enterprise-values?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getCashflowGrowth(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/cash-flow-statement-growth?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getIncomeGrowth(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/income-statement-growth?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getBalanceSheetGrowth(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/balance-sheet-statement-growth?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getFinancialGrowth(e){let{symbol:t,period:r="annual",limit:s=5}=e;return this.client.get(`/financial-growth?symbol=${t}&period=${r}&limit=${s}`,"stable")}async getEarningsHistorical(e){let{symbol:t,limit:r=5}=e;return this.client.get(`/earnings?symbol=${t}&limit=${r}`,"stable")}async getEarningsSurprises(e){return this.client.get(`/earnings-surprises/${e}`,"v3")}};var y=class{constructor(e){this.client=e;}async getInsiderTradingRSS(e){let{page:t=0,limit:r=100}=e;return this.client.get("/insider-trading/latest","stable",{page:t,limit:r})}async searchInsiderTrading(e){let{symbol:t,reportingCik:r,companyCik:s,transactionType:n,page:o=0,limit:a=100}=e,l={page:o,limit:a};return t&&(l.symbol=t),r&&(l.reportingCik=r),s&&(l.companyCik=s),n&&(l.transactionType=n),this.client.get("/insider-trading/search","stable",l)}async getTransactionTypes(){return this.client.get("/insider-trading-transaction-type","stable")}async getInsidersBySymbol(e){let{symbol:t}=e;return this.client.get("/insider-roaster","v4",{symbol:t})}async getInsiderTradeStatistics(e){let{symbol:t}=e;return this.client.get("/insider-trading/statistics","stable",{symbol:t})}async getCikMapper(e){let{page:t=0}=e;return this.client.get("/mapper-cik-name","v4",{page:t})}async getCikMapperByName(e){let{name:t,page:r=0}=e;return this.client.get("/mapper-cik-name","v4",{name:t,page:r})}async getCikMapperBySymbol(e){let{symbol:t}=e;return this.client.getSingle(`/mapper-cik-company/${t}`,"v4")}async getBeneficialOwnership(e){let{symbol:t,limit:r=100}=e;return this.client.get("/acquisition-of-beneficial-ownership","stable",{symbol:t,limit:r})}async getFailToDeliver(e){let{symbol:t,page:r=0}=e;return this.client.get("/fail_to_deliver","v4",{symbol:t,page:r})}async getInsiderTradesBySymbol(e,t=0){return this.searchInsiderTrading({symbol:e,page:t})}async getInsiderTradesByType(e,t=0){return this.searchInsiderTrading({transactionType:e,page:t})}async getInsiderTradesByReportingCik(e,t=0){return this.searchInsiderTrading({reportingCik:e,page:t})}async getInsiderTradesByCompanyCik(e,t=0){return this.searchInsiderTrading({companyCik:e,page:t})}};var P=class{constructor(e){this.client=e;}async getForm13F(e){let{cik:t,date:r}=e,s={};return r&&(s.date=r),this.client.get(`/form-thirteen/${t}`,"v3",s)}async getForm13FDates(e){let{cik:t}=e;return this.client.get(`/form-thirteen-date/${t}`,"v3")}async getInstitutionalHolders(e){let{symbol:t}=e;return this.client.get(`/institutional-holder/${t}`,"v3")}};var f=class{constructor(e){this.client=e;}async getStockList(){return this.client.get("/stock/list")}async getETFList(){return this.client.get("/etf/list")}async getCryptoList(){return this.client.get("/symbol/available-cryptocurrencies")}async getForexList(){return this.client.get("/symbol/available-forex-currency-pairs")}async getAvailableIndexes(){return this.client.get("/symbol/available-indexes")}};var b=class{constructor(e){this.client=e;}async getMarketHours(){return this.client.get("/market-hours","v3")}async getMarketPerformance(){return this.client.get("/quotes/index","v3")}async getGainers(){return this.client.get("/biggest-gainers","stable")}async getLosers(){return this.client.get("/biggest-losers","stable")}async getMostActive(){return this.client.get("/most-actives","stable")}async getSectorPerformance(){return this.client.get("/sector-performance","v3")}async getMarketIndex(){return this.client.get("/quotes/index","v3")}};var R=class{constructor(e){this.client=e;}async getHolders(e){return this.client.get(`/mutual-fund-holder/${e}`,"v3")}};var I=class{constructor(e){this.client=e;}async getArticles(e={}){let{page:t=1,limit:r=100}=e;return this.client.get("/fmp-articles","stable",{page:t,limit:r})}async getStockNews(e={}){let{from:t,to:r,page:s=1,limit:n=100}=e,o={page:s,limit:n};return t&&(o.from=t),r&&(o.to=r),this.client.get("/news/stock-latest","stable",o)}async getCryptoNews(e={}){let{from:t,to:r,page:s=1,limit:n=100}=e,o={page:s,limit:n};return t&&(o.from=t),r&&(o.to=r),this.client.get("/news/crypto-latest","stable",o)}async getForexNews(e={}){let{from:t,to:r,page:s=1,limit:n=100}=e,o={page:s,limit:n};return t&&(o.from=t),r&&(o.to=r),this.client.get("/news/forex-latest","stable",o)}async getStockNewsBySymbol(e){let{symbols:t,from:r,to:s,page:n=1,limit:o=100}=e,a=t.join(","),l={page:n,limit:o};return r&&(l.from=r),s&&(l.to=s),this.client.get(`/news/stock?symbols=${a}`,"stable",l)}async getCryptoNewsBySymbol(e){let{symbols:t,from:r,to:s,page:n=1,limit:o=100}=e,a=t.join(","),l={page:n,limit:o};return r&&(l.from=r),s&&(l.to=s),this.client.get(`/news/crypto?symbols=${a}`,"stable",l)}async getForexNewsBySymbol(e){let{symbols:t,from:r,to:s,page:n=1,limit:o=100}=e,a=t.join(","),l={page:n,limit:o};return r&&(l.from=r),s&&(l.to=s),this.client.get(`/news/forex?symbols=${a}`,"stable",l)}};var h=class{constructor(e){this.client=e;}async getQuote(e){return this.client.getSingle(`/quote/${e}`,"v3")}async getHistoricalPrice(e){let{symbol:t,from:r,to:s}=e,n={};return r&&(n.from=r),s&&(n.to=s),this.client.getSingle(`/historical-price-full/${t}`,"v3",n)}async getQuotes(e){let t=e.join(",");return this.client.get(`/quote/${t}`,"v3")}async getIntraday(e){let{symbol:t,interval:r,from:s,to:n}=e,o={};return s&&(o.from=s),n&&(o.to=n),this.client.get(`/historical-chart/${r}/${t}`,"v3",o)}};var A=class{constructor(e){this.client=e;}async getScreener(e){return this.client.get("/company-screener","stable",e)}async getAvailableExchanges(){return this.client.get("/available-exchanges","stable")}async getAvailableSectors(){return this.client.get("/available-sectors","stable")}async getAvailableIndustries(){return this.client.get("/available-industries","stable")}async getAvailableCountries(){return this.client.get("/available-countries","stable")}};var S=class{constructor(e){this.client=e;}async getRSSFeed(e){return this.client.get("/rss_feed","v4",e)}async getRSSFeedAll(e){return this.client.get("/rss_feed_all","v4",e)}async getRSSFeedV3(e){return this.client.get("/rss_feed","v3",e)}async getRSSFeed8K(e){return this.client.get("/rss_feed_8k","v4",e)}async getSECFilings({symbol:e,params:t}){return this.client.get(`/sec_filings/${e}`,"v3",t)}async getIndividualIndustryClassification(e){return this.client.getSingle("/standard_industrial_classification","v4",e)}async getAllIndustryClassifications(){return this.client.get("/standard_industrial_classification/all","v4")}async getIndustryClassificationCodes(e){return this.client.get("/standard_industrial_classification_list","v4",e)}};var E=class{constructor(e){this.client=e;}async getSenateTrading(e){let{symbol:t}=e;return this.client.get("/senate-trades","stable",{symbol:t})}async getSenateTradingRSSFeed(e){let{page:t,limit:r}=e;return this.client.get("/senate-latest","stable",{page:t,limit:r??100})}async getSenateTradingByName(e){let{name:t}=e;return this.client.get("/senate-trades-by-name","stable",{name:t})}async getHouseTrading(e){let{symbol:t}=e;return this.client.get("/house-trades","stable",{symbol:t})}async getHouseTradingRSSFeed(e){let{page:t,limit:r}=e;return this.client.get("/house-latest","stable",{page:t,limit:r??100})}async getHouseTradingByName(e){let{name:t}=e;return this.client.get("/house-trades-by-name","stable",{name:t})}};var C=class{constructor(e){this.client=e;}async getMarketCap(e){return this.client.getSingle(`/market-capitalization/${e}`,"v3")}async getStockSplits(e){return this.client.get(`/historical-price-full/stock_split/${e}`,"v3")}async getDividendHistory(e){return this.client.getSingle(`/historical-price-full/stock_dividend/${e}`,"v3")}async getRealTimePrice(e){let t=`stock/real-time-price/${e.join(",")}`,r=await this.client.get(t,"v3");if(r.success&&r.data&&!Array.isArray(r.data)){let n=r.data;if(typeof n=="object"&&n!==null&&"companiesPriceList"in n&&Array.isArray(n.companiesPriceList)){let o=n.companiesPriceList.filter(a=>a&&a.symbol);if(o.length>0)return {...r,data:o}}if(typeof n=="object"&&n!==null&&"stockList"in n&&Array.isArray(n.stockList)){let o=n.stockList.filter(a=>a&&a.symbol);if(o.length>0)return {...r,data:o}}return n.symbol?{...r,data:[n]}:(e.length===1&&console.warn(`No real-time price data found for symbol: ${e[0]}`),{...r,data:[]})}let s=r.data.filter(n=>n&&n.symbol);return {...r,data:s}}async getRealTimePriceForMultipleStocks(e){let t=`stock/full/real-time-price/${e.join(",")}`,r=await this.client.get(t,"v3");if(r.success&&r.data&&!Array.isArray(r.data)){let n=r.data;if(typeof n=="object"&&n!==null&&"companiesPriceList"in n&&Array.isArray(n.companiesPriceList)){let o=n.companiesPriceList.filter(a=>a&&a.symbol);if(o.length>0)return {...r,data:o}}if(typeof n=="object"&&n!==null&&"stockList"in n&&Array.isArray(n.stockList)){let o=n.stockList.filter(a=>a&&a.symbol);if(o.length>0)return {...r,data:o}}return n.symbol?{...r,data:[n]}:(e.length===1&&console.warn(`No full real-time price data found for symbol: ${e[0]}`),{...r,data:[]})}let s=r.data.filter(n=>n&&n.symbol);return {...r,data:s}}};var M=class{constructor(e={}){let t=e.apiKey||process.env.FMP_API_KEY;if(!t)throw new Error("FMP API key is required. Please provide it in the config or set the FMP_API_KEY environment variable.");if(!a.isValidApiKey(t))throw new Error("Invalid API key format");let r=new c({...e,apiKey:t});this.calendar=new m(r),this.company=new p(r),this.economic=new g(r),this.etf=new u(r),this.financial=new d(r),this.insider=new y(r),this.institutional=new P(r),this.list=new f(r),this.market=new b(r),this.mutualFund=new R(r),this.news=new I(r),this.quote=new h(r),this.screener=new A(r),this.sec=new S(r),this.senateHouse=new E(r),this.stock=new C(r);}getClient(){return this.stock.client}};function N(i,e="USD"){return new Intl.NumberFormat("en-US",{style:"currency",currency:e}).format(i)}function _(i,e=2){return `${i.toFixed(e)}%`}function $(i){return i>=1e12?`${(i/1e12).toFixed(2)}T`:i>=1e9?`${(i/1e9).toFixed(2)}B`:i>=1e6?`${(i/1e6).toFixed(2)}M`:i>=1e3?`${(i/1e3).toFixed(2)}K`:i.toString()}function H(i){return (typeof i=="string"?new Date(i):i).toISOString().split("T")[0]}function q(i){return i>=1e9?`${(i/1e9).toFixed(2)}B`:i>=1e6?`${(i/1e6).toFixed(2)}M`:i>=1e3?`${(i/1e3).toFixed(2)}K`:i.toString()}var U=1e4,O=100,B=1e3,G={ANNUAL:"annual",QUARTER:"quarter"},K={NYSE:"NYSE",NASDAQ:"NASDAQ",AMEX:"AMEX",TSX:"TSX",LSE:"LSE",ASX:"ASX",NSE:"NSE",BSE:"BSE"},V={TECHNOLOGY:"Technology",HEALTHCARE:"Healthcare",FINANCIAL:"Financial",CONSUMER_DISCRETIONARY:"Consumer Discretionary",CONSUMER_STAPLES:"Consumer Staples",INDUSTRIALS:"Industrials",ENERGY:"Energy",MATERIALS:"Materials",UTILITIES:"Utilities",REAL_ESTATE:"Real Estate",COMMUNICATION_SERVICES:"Communication Services"};var k=class extends Error{constructor(t,r,s){super(t);this.status=r;this.code=s;this.name="FMPError";}};
+export{m as CalendarEndpoints,p as CompanyEndpoints,O as DEFAULT_LIMIT,U as DEFAULT_TIMEOUT,u as ETFEndpoints,K as EXCHANGES,g as EconomicEndpoints,M as FMP,c as FMPClient,k as FMPError,d as FinancialEndpoints,y as InsiderEndpoints,P as InstitutionalEndpoints,f as ListEndpoints,B as MAX_LIMIT,b as MarketEndpoints,R as MutualFundEndpoints,I as NewsEndpoints,G as PERIODS,h as QuoteEndpoints,S as SECEndpoints,V as SECTORS,A as ScreenerEndpoints,E as SenateHouseEndpoints,C as StockEndpoints,F as classifyError,N as formatCurrency,H as formatDate,$ as formatLargeNumber,_ as formatPercentage,q as formatVolume};