fmp-node-api 0.1.0 → 0.1.1

package/dist/types-only.d.mts

@@ -0,0 +1,2 @@
+export { A as APIResponse, P as PeriodParams, S as SymbolParams } from './common-COsxpVBY.mjs';
+export { B as BalanceSheet, C as CashFlowStatement, N as CompanyProfile, l as ETFHolder, k as ETFHolding, m as ETFProfile, z as EarningsCalendar, q as EconomicIndicator, F as FinancialRatios, a1 as Form13FResponse, a0 as HouseTradingResponse, I as IncomeStatement, a4 as InsiderTradingSearchResponse, a2 as InstitutionalHolderResponse, K as KeyMetrics, M as MarketCap, r as MarketHours, u as MarketIndex, X as Quote, ad as RSSFeedItem, _ as SenateTradingResponse, al as StockDividend, v as StockList, b as StockRealTimePrice, c as StockRealTimePriceFull, ak as StockSplit } from './types-only-v3B1TqXe.mjs';

package/dist/types-only.d.ts

@@ -0,0 +1,2 @@
+export { A as APIResponse, P as PeriodParams, S as SymbolParams } from './common-COsxpVBY.js';
+export { B as BalanceSheet, C as CashFlowStatement, N as CompanyProfile, l as ETFHolder, k as ETFHolding, m as ETFProfile, z as EarningsCalendar, q as EconomicIndicator, F as FinancialRatios, a1 as Form13FResponse, a0 as HouseTradingResponse, I as IncomeStatement, a4 as InsiderTradingSearchResponse, a2 as InstitutionalHolderResponse, K as KeyMetrics, M as MarketCap, r as MarketHours, u as MarketIndex, X as Quote, ad as RSSFeedItem, _ as SenateTradingResponse, al as StockDividend, v as StockList, b as StockRealTimePrice, c as StockRealTimePriceFull, ak as StockSplit } from './types-only-DjnrpNZm.js';

package/dist/types-only.js

@@ -0,0 +1 @@
+'use strict';

package/dist/utils/validation.d.mts

@@ -0,0 +1,88 @@
+import { A as APIResponse } from '../common-COsxpVBY.mjs';
+
+/**
+ * Validation utilities for FMP API parameters and responses
+ */
+declare class FMPValidation {
+    /**
+     * Validate stock symbol format
+     * @param symbol - The symbol to validate
+     * @returns True if the symbol format is valid
+     */
+    static isValidSymbol(symbol: string): boolean;
+    /**
+     * Validate crypto symbol format
+     * @param symbol - The crypto symbol to validate
+     * @returns True if the crypto symbol format is valid
+     */
+    static isValidCryptoSymbol(symbol: string): boolean;
+    /**
+     * Validate forex pair format
+     * @param symbol - The forex pair to validate
+     * @returns True if the forex pair format is valid
+     */
+    static isValidForexPair(symbol: string): boolean;
+    /**
+     * Validate date format (YYYY-MM-DD)
+     * @param date - The date string to validate
+     * @returns True if the date format is valid
+     */
+    static isValidDate(date: string): boolean;
+    /**
+     * Validate date range
+     * @param from - Start date
+     * @param to - End date
+     * @returns True if the date range is valid
+     */
+    static isValidDateRange(from: string, to: string): boolean;
+    /**
+     * Validate API response structure
+     * @param response - The response to validate
+     * @returns True if the response has the expected structure
+     */
+    static isValidResponse(response: any): response is APIResponse<any>;
+    /**
+     * Validate API key format
+     * @param apiKey - The API key to validate
+     * @returns True if the API key format is valid
+     */
+    static isValidApiKey(apiKey: string): boolean;
+    /**
+     * Validate period parameter
+     * @param period - The period to validate
+     * @returns True if the period is valid
+     */
+    static isValidPeriod(period: string): boolean;
+    /**
+     * Validate limit parameter
+     * @param limit - The limit to validate
+     * @returns True if the limit is valid
+     */
+    static isValidLimit(limit: number): boolean;
+    /**
+     * Get validation errors for quote parameters
+     * @param params - The parameters to validate
+     * @returns Array of validation error messages
+     */
+    static validateQuoteParams(params: any): string[];
+    /**
+     * Get validation errors for financial statement parameters
+     * @param params - The parameters to validate
+     * @returns Array of validation error messages
+     */
+    static validateFinancialParams(params: any): string[];
+    /**
+     * Get validation errors for date range parameters
+     * @param params - The parameters to validate
+     * @returns Array of validation error messages
+     */
+    static validateDateRangeParams(params: any): string[];
+    /**
+     * Validate and throw error if validation fails
+     * @param errors - Array of validation errors
+     * @param context - Context for the error message
+     */
+    static throwIfInvalid(errors: string[], context?: string): void;
+}
+
+export { FMPValidation };

package/dist/utils/validation.d.ts

@@ -0,0 +1,88 @@
+import { A as APIResponse } from '../common-COsxpVBY.js';
+
+/**
+ * Validation utilities for FMP API parameters and responses
+ */
+declare class FMPValidation {
+    /**
+     * Validate stock symbol format
+     * @param symbol - The symbol to validate
+     * @returns True if the symbol format is valid
+     */
+    static isValidSymbol(symbol: string): boolean;
+    /**
+     * Validate crypto symbol format
+     * @param symbol - The crypto symbol to validate
+     * @returns True if the crypto symbol format is valid
+     */
+    static isValidCryptoSymbol(symbol: string): boolean;
+    /**
+     * Validate forex pair format
+     * @param symbol - The forex pair to validate
+     * @returns True if the forex pair format is valid
+     */
+    static isValidForexPair(symbol: string): boolean;
+    /**
+     * Validate date format (YYYY-MM-DD)
+     * @param date - The date string to validate
+     * @returns True if the date format is valid
+     */
+    static isValidDate(date: string): boolean;
+    /**
+     * Validate date range
+     * @param from - Start date
+     * @param to - End date
+     * @returns True if the date range is valid
+     */
+    static isValidDateRange(from: string, to: string): boolean;
+    /**
+     * Validate API response structure
+     * @param response - The response to validate
+     * @returns True if the response has the expected structure
+     */
+    static isValidResponse(response: any): response is APIResponse<any>;
+    /**
+     * Validate API key format
+     * @param apiKey - The API key to validate
+     * @returns True if the API key format is valid
+     */
+    static isValidApiKey(apiKey: string): boolean;
+    /**
+     * Validate period parameter
+     * @param period - The period to validate
+     * @returns True if the period is valid
+     */
+    static isValidPeriod(period: string): boolean;
+    /**
+     * Validate limit parameter
+     * @param limit - The limit to validate
+     * @returns True if the limit is valid
+     */
+    static isValidLimit(limit: number): boolean;
+    /**
+     * Get validation errors for quote parameters
+     * @param params - The parameters to validate
+     * @returns Array of validation error messages
+     */
+    static validateQuoteParams(params: any): string[];
+    /**
+     * Get validation errors for financial statement parameters
+     * @param params - The parameters to validate
+     * @returns Array of validation error messages
+     */
+    static validateFinancialParams(params: any): string[];
+    /**
+     * Get validation errors for date range parameters
+     * @param params - The parameters to validate
+     * @returns Array of validation error messages
+     */
+    static validateDateRangeParams(params: any): string[];
+    /**
+     * Validate and throw error if validation fails
+     * @param errors - Array of validation errors
+     * @param context - Context for the error message
+     */
+    static throwIfInvalid(errors: string[], context?: string): void;
+}
+
+export { FMPValidation };

package/dist/utils/validation.js

@@ -0,0 +1 @@
+'use strict';var s=class{static isValidSymbol(t){return !t||typeof t!="string"?false:/^[A-Z]{1,5}$/.test(t)}static isValidCryptoSymbol(t){return !t||typeof t!="string"?false:/^[A-Z]{2,10}(USD|EUR|GBP|JPY|CAD|AUD|CHF|CNY)$/.test(t)}static isValidForexPair(t){return !t||typeof t!="string"?false:/^[A-Z]{3}[A-Z]{3}$/.test(t)}static isValidDate(t){if(!t||typeof t!="string"||!/^\d{4}-\d{2}-\d{2}$/.test(t))return  false;let i=new Date(t);return !isNaN(i.getTime())&&i.toISOString().split("T")[0]===t}static isValidDateRange(t,e){if(!this.isValidDate(t)||!this.isValidDate(e))return  false;let i=new Date(t),r=new Date(e);return i<=r}static isValidResponse(t){return !!(t&&typeof t=="object"&&typeof t.success=="boolean")}static isValidApiKey(t){return !t||typeof t!="string"?false:/^[a-zA-Z0-9]{32,}$/.test(t)}static isValidPeriod(t){return !t||typeof t!="string"?false:["annual","quarter","fy"].includes(t.toLowerCase())}static isValidLimit(t){return typeof t=="number"&&Number.isInteger(t)&&t>0&&t<=1e3}static validateQuoteParams(t){let e=[];return t?(t.symbol?!this.isValidSymbol(t.symbol)&&!this.isValidCryptoSymbol(t.symbol)&&!this.isValidForexPair(t.symbol)&&e.push("Invalid symbol format"):e.push("Symbol is required"),t.from&&!this.isValidDate(t.from)&&e.push("Invalid from date format (expected YYYY-MM-DD)"),t.to&&!this.isValidDate(t.to)&&e.push("Invalid to date format (expected YYYY-MM-DD)"),t.from&&t.to&&!this.isValidDateRange(t.from,t.to)&&e.push("From date must be before or equal to to date"),e):(e.push("Parameters object is required"),e)}static validateFinancialParams(t){let e=[];return t?(t.symbol?this.isValidSymbol(t.symbol)||e.push("Invalid symbol format"):e.push("Symbol is required"),t.period&&!this.isValidPeriod(t.period)&&e.push('Invalid period (must be "annual", "quarter", or "FY")'),t.limit&&!this.isValidLimit(t.limit)&&e.push("Invalid limit (must be a positive integer <= 1000)"),e):(e.push("Parameters object is required"),e)}static validateDateRangeParams(t){let e=[];return t?(t.from&&!this.isValidDate(t.from)&&e.push("Invalid from date format (expected YYYY-MM-DD)"),t.to&&!this.isValidDate(t.to)&&e.push("Invalid to date format (expected YYYY-MM-DD)"),t.from&&t.to&&!this.isValidDateRange(t.from,t.to)&&e.push("From date must be before or equal to to date"),e):(e.push("Parameters object is required"),e)}static throwIfInvalid(t,e="Validation"){if(t.length>0)throw new Error(`${e} failed: ${t.join(", ")}`)}};exports.FMPValidation=s;

package/dist/utils/validation.mjs

@@ -0,0 +1 @@
+export{a as FMPValidation}from'../chunk-RM7ETDL3.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmp-node-api",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A comprehensive Node.js wrapper for Financial Modeling Prep API",
   "disclaimer": "This package is not affiliated with, endorsed by, or sponsored by Financial Modeling Prep (FMP). This is an independent, community-developed wrapper.",
   "main": "./dist/index.js",
@@ -11,6 +11,16 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types-only.d.ts",
+      "import": "./dist/types-only.mjs",
+      "require": "./dist/types-only.js"
+    },
+    "./utils/validation": {
+      "types": "./dist/utils/validation.d.ts",
+      "import": "./dist/utils/validation.mjs",
+      "require": "./dist/utils/validation.js"
     }
   },
   "files": [