borsajs 0.1.5 → 0.2.1

package/LICENSE

@@ -210,12 +210,12 @@ https://github.com/saidsurucu/borsapy
 This library accesses publicly available data from the following sources:
 
 - Paratic (https://www.paratic.com/) - Stock and index data
-- doviz.com (https://www.doviz.com/) - Forex, gold, and commodity data
+- doviz.com (https://www.doviz.com/) - Forex, gold, commodity, economic calendar, and bond data
 - BtcTurk (https://www.btcturk.com/) - Cryptocurrency data
 - TEFAS (https://www.tefas.gov.tr/) - Investment fund data
 - TCMB (https://www.tcmb.gov.tr/) - Inflation data
 - KAP (https://www.kap.org.tr/) - Company information
-- İş Yatırım (https://www.isyatirim.com.tr/) - Derivatives (VIOP) data
+- İş Yatırım (https://www.isyatirim.com.tr/) - Derivatives (VIOP) and stock screening data
 
 ================================================================================
                         IMPORTANT NOTICE FOR COMMERCIAL USE

package/README.en.md

@@ -10,6 +10,27 @@ A TypeScript/JavaScript data library for Turkey financial markets. yfinance-like
 npm install borsajs
 ```
 
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+  - [Ticker (Stocks)](#ticker-stocks)
+  - [FX (Forex & Commodities)](#fx-forex--commodities)
+  - [Crypto](#crypto)
+  - [Index](#index)
+  - [Fund (Investment Funds)](#fund-investment-funds)
+  - [Inflation](#inflation)
+  - [KAP (Public Disclosure Platform)](#kap-public-disclosure-platform)
+  - [EconomicCalendar](#economiccalendar)
+  - [Bond](#bond)
+  - [Screener](#screener)
+  - [VIOP (Derivatives)](#viop-derivatives)
+  - [Symbols](#symbols)
+  - [Download (Multiple Tickers)](#download-multiple-tickers)
+- [Data Sources](#data-sources)
+- [Important Notices](#️-important-notices)
+- [License](#license)
+
 ## Quick Start
 
 ```typescript
@@ -319,6 +340,105 @@ const details = await kap.getCompanyDetails('THYAO');
 }
 ```
 
+### EconomicCalendar
+
+**Track global economic indicators and events in real-time.** Access economic data, reports, and announcements from TR, US, EU, and other countries. Make investment decisions based on macroeconomic indicators.
+
+```typescript
+import { EconomicCalendar, economicCalendar } from 'borsajs';
+
+const cal = new EconomicCalendar();
+const events = await cal.thisWeek();
+const highEvents = await cal.highImportance({ period: '1w' });
+
+// Convenience function
+const trEvents = await economicCalendar({ country: 'TR', importance: 'high' });
+```
+
+**Response:**
+```json
+[
+  {
+    "date": "2026-01-15T00:00:00.000Z",
+    "time": "10:00",
+    "country": "Türkiye",
+    "countryCode": "TR",
+    "event": "Inflation (YoY)",
+    "importance": "high",
+    "period": "December",
+    "actual": "64.77%",
+    "forecast": "65.00%",
+    "previous": "61.98%"
+  }
+]
+```
+
+**Supported Countries:** TR, US, EU, DE, GB, JP, CN, FR, IT, CA, AU, CH
+
+### Bond
+
+**Track Turkish government bond yields in real-time.** Access yields and changes for 2, 5, and 10-year bonds. Get risk-free rate for DCF calculations.
+
+```typescript
+import { Bond, bonds, riskFreeRate } from 'borsajs';
+
+// Get all bonds
+const allBonds = await bonds();
+// → [{ maturity: '2Y', yield: 36.71, ... }, ...]
+
+// Specific bond
+const bond10y = new Bond('10Y');
+const yieldRate = await bond10y.getYieldRate();
+const yieldDecimal = await bond10y.getYieldDecimal();
+
+// Risk-free rate for DCF
+const rfr = await riskFreeRate();
+// → 0.2905 (for 29.05%)
+```
+
+**Response (bonds):**
+```json
+[
+  {
+    "name": "TR 2 Year Bond Rate",
+    "maturity": "2Y",
+    "yield": 36.71,
+    "yieldDecimal": 0.3671,
+    "change": 0.17,
+    "changePct": 0.47
+  }
+]
+```
+
+### Screener
+
+**Screen BIST stocks with 40+ criteria.** Find stocks by market cap, P/E ratio, dividend yield, ROE, and more. Use 15 ready-made templates or custom filters.
+
+```typescript
+import { Screener, screenStocks, sectors } from 'borsajs';
+
+// Use template
+const highDivStocks = await screenStocks({ template: 'high_dividend' });
+
+// Custom filters
+const customStocks = await screenStocks({
+  marketCapMin: 1000,  // Min 1000M TL
+  peMax: 15,           // Max 15 P/E
+  dividendYieldMin: 3, // Min 3% dividend
+});
+
+// Fluent API
+const screener = new Screener();
+const results = await screener
+  .addFilter('market_cap', { min: 215000 })
+  .addFilter('roe', { min: 15 })
+  .run();
+```
+
+**Templates:** `small_cap`, `mid_cap`, `large_cap`, `high_dividend`, `high_upside`, `buy_recommendation`, `high_net_margin`, `low_pe`, `high_roe`, `high_foreign_ownership`
+
+**Filter Criteria:** price, market_cap, pe, pb, ev_ebitda, dividend_yield, roe, roa, net_margin, return_1w, return_1m, foreign_ratio, upside_potential, and 30+ more criteria.
+
 ### Symbols
 
 **Access all market symbols in a single call.** Get comprehensive lists of stocks, cryptocurrencies, currencies, and indices. Perfect starting point for automated data collection or screening algorithms.
@@ -408,6 +528,9 @@ This library accesses publicly available data from the following sources:
 | Fund | TEFAS | [tefas.gov.tr](https://www.tefas.gov.tr/) | Investment fund data |
 | Inflation | TCMB | [tcmb.gov.tr](https://www.tcmb.gov.tr/) | Inflation data |
 | KAP | KAP | [kap.org.tr](https://www.kap.org.tr/) | Company information |
+| EconomicCalendar | doviz.com | [doviz.com](https://www.doviz.com/) | Economic calendar |
+| Bond | doviz.com | [doviz.com](https://www.doviz.com/) | Bond yields |
+| Screener | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Stock screening |
 | VIOP | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Futures and options |
 
 ## ⚠️ Important Notices

package/README.md

@@ -10,6 +10,26 @@ Türkiye finansal piyasaları için TypeScript/JavaScript veri kütüphanesi. BI
 npm install borsajs
 ```
 
+## İçindekiler
+
+- [Hızlı Başlangıç](#hızlı-başlangıç)
+- [API Referansı](#api-referansı)
+  - [Ticker (Hisse Senedi)](#ticker-hisse-senedi)
+  - [FX (Döviz & Emtia)](#fx-döviz--emtia)
+  - [Crypto (Kripto Para)](#crypto-kripto-para)
+  - [Index (Endeksler)](#index-endeksler)
+  - [Fund (Yatırım Fonları)](#fund-yatırım-fonları)
+  - [Inflation (Enflasyon)](#inflation-enflasyon)
+  - [KAP (Kamu Aydınlatma Platformu)](#kap-kamu-aydınlatma-platformu)
+  - [EconomicCalendar (Ekonomik Takvim)](#economiccalendar-ekonomik-takvim)
+  - [Bond (Tahvil Getirileri)](#bond-tahvil-getirileri)
+  - [Screener (Hisse Tarayıcı)](#screener-hisse-tarayıcı)
+  - [VIOP (Vadeli İşlem ve Opsiyon Piyasası)](#viop-vadeli-i̇şlem-ve-opsiyon-piyasası)
+  - [Symbols (Sembol Listeleri)](#symbols-sembol-listeleri)
+- [Veri Kaynakları](#veri-kaynakları)
+- [Önemli Uyarılar](#️-önemli-uyarılar)
+- [Lisans](#lisans)
+
 ## Hızlı Başlangıç
 
 ```typescript
@@ -276,6 +296,105 @@ const details = await kap.getCompanyDetails('THYAO');
 }
 ```
 
+### EconomicCalendar (Ekonomik Takvim)
+
+**Küresel ekonomik göstergeleri ve etkinlikleri gerçek zamanlı takip edin.** EconomicCalendar API ile TR, US, EU ve diğer ülkelerin önemli ekonomik verilerini, raporlarını ve açıklamalarını önceden öğrenin. Yatırım kararlarınızı makro ekonomik göstergeler ışığında alın.
+
+```typescript
+import { EconomicCalendar, economicCalendar } from 'borsajs';
+
+const cal = new EconomicCalendar();
+const events = await cal.thisWeek();
+const highEvents = await cal.highImportance({ period: '1w' });
+
+// Convenience fonksiyonu
+const trEvents = await economicCalendar({ country: 'TR', importance: 'high' });
+```
+
+**Response:**
+```json
+[
+  {
+    "date": "2026-01-15T00:00:00.000Z",
+    "time": "10:00",
+    "country": "Türkiye",
+    "countryCode": "TR",
+    "event": "Enflasyon (YoY)",
+    "importance": "high",
+    "period": "Aralık",
+    "actual": "64.77%",
+    "forecast": "65.00%",
+    "previous": "61.98%"
+  }
+]
+```
+
+**Desteklenen Ülkeler:** TR, US, EU, DE, GB, JP, CN, FR, IT, CA, AU, CH
+
+### Bond (Tahvil Getirileri)
+
+**Türk devlet tahvillerinin getirilerini anlık izleyin.** Bond API ile 2, 5 ve 10 yıllık tahvil faizlerini ve değişimlerini takip edin. DCF hesaplamaları için risksiz getiri oranına kolayca erişin.
+
+```typescript
+import { Bond, bonds, riskFreeRate } from 'borsajs';
+
+// Tüm tahvilleri al
+const allBonds = await bonds();
+// → [{ maturity: '2Y', yield: 36.71, ... }, ...]
+
+// Belirli bir tahvil
+const bond10y = new Bond('10Y');
+const yieldRate = await bond10y.getYieldRate();
+const yieldDecimal = await bond10y.getYieldDecimal();
+
+// DCF hesaplamaları için risksiz getiri
+const rfr = await riskFreeRate();
+// → 0.2905 (29.05% için)
+```
+
+**Response (bonds):**
+```json
+[
+  {
+    "name": "TR 2 Yıllık Tahvil Faizi",
+    "maturity": "2Y",
+    "yield": 36.71,
+    "yieldDecimal": 0.3671,
+    "change": 0.17,
+    "changePct": 0.47
+  }
+]
+```
+
+### Screener (Hisse Tarayıcı)
+
+**BIST hisselerini 40+ farklı kritere göre tarayın.** Screener API ile piyasa değeri, F/K oranı, temettü verimi, ROE ve daha fazla kritere göre hisse senedi bulun. 15 hazır şablon veya özel filtreler ile yatırım stratejinize uygun hisseleri keşfedin.
+
+```typescript
+import { Screener, screenStocks, sectors } from 'borsajs';
+
+// Hazır şablon kullan
+const highDivStocks = await screenStocks({ template: 'high_dividend' });
+
+// Özel filtreler
+const customStocks = await screenStocks({
+  marketCapMin: 1000,  // Min 1000M TL
+  peMax: 15,           // Maks 15 F/K
+  dividendYieldMin: 3, // Min %3 temettü
+});
+
+// Fluent API
+const screener = new Screener();
+const results = await screener
+  .addFilter('market_cap', { min: 215000 })
+  .addFilter('roe', { min: 15 })
+  .run();
+```
+
+**Hazır Şablonlar:** `small_cap`, `mid_cap`, `large_cap`, `high_dividend`, `high_upside`, `buy_recommendation`, `high_net_margin`, `low_pe`, `high_roe`, `high_foreign_ownership`
+
+**Filtre Kriterleri:** price, market_cap, pe, pb, ev_ebitda, dividend_yield, roe, roa, net_margin, return_1w, return_1m, foreign_ratio, upside_potential ve 30+ kriter daha.
+
 ### VIOP (Vadeli İşlem ve Opsiyon Piyasası)
 
 **Türk türev piyasasını gerçek zamanlı takip edin.** Hisse senedi vadeli işlemleri, endeks vadeli işlemleri, döviz ve emtia kontratlarına anında erişin. Riskten korunma (hedging) stratejileri ve türev ürün ticareti için vazgeçilmez.
@@ -354,6 +473,9 @@ Bu kütüphane aşağıdaki kamuya açık veri kaynaklarından yararlanmaktadır
 | Fund | TEFAS | [tefas.gov.tr](https://www.tefas.gov.tr/) | Yatırım fonu verileri |
 | Inflation | TCMB | [tcmb.gov.tr](https://www.tcmb.gov.tr/) | Enflasyon verileri |
 | KAP | KAP | [kap.org.tr](https://www.kap.org.tr/) | Şirket bilgileri |
+| EconomicCalendar | doviz.com | [doviz.com](https://www.doviz.com/) | Ekonomik takvim |
+| Bond | doviz.com | [doviz.com](https://www.doviz.com/) | Tahvil getirileri |
+| Screener | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Hisse tarama |
 | VIOP | İş Yatırım | [isyatirim.com.tr](https://www.isyatirim.com.tr/) | Vadeli işlem ve opsiyon |
 
 ## ⚠️ Önemli Uyarılar

package/dist/bond.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Bond class for Turkish government bond yields - yfinance-like API.
+ */
+import { type BondData } from './providers/dovizcom-bond.js';
+export type { BondData };
+export declare class Bond {
+    private maturity;
+    private provider;
+    private dataCache;
+    /**
+     * Create a Bond instance for a specific maturity.
+     *
+     * @param maturity - Bond maturity (2Y, 5Y, or 10Y)
+     *
+     * @example
+     * ```typescript
+     * const bond = new Bond('10Y');
+     * const yieldRate = await bond.getYieldRate();
+     * ```
+     */
+    constructor(maturity: '2Y' | '5Y' | '10Y');
+    private getData;
+    /**
+     * Get the bond maturity.
+     */
+    getMaturity(): string;
+    /**
+     * Get the bond name.
+     */
+    getName(): Promise<string>;
+    /**
+     * Get the current yield as percentage.
+     * @returns Yield rate as percentage (e.g., 28.03 for 28.03%)
+     */
+    getYieldRate(): Promise<number>;
+    /**
+     * Get the current yield as decimal.
+     * @returns Yield rate as decimal (e.g., 0.2803 for 28.03%)
+     */
+    getYieldDecimal(): Promise<number>;
+    /**
+     * Get the absolute change in yield.
+     */
+    getChange(): Promise<number | null>;
+    /**
+     * Get the percentage change in yield.
+     */
+    getChangePct(): Promise<number | null>;
+    /**
+     * Get all bond information.
+     */
+    getInfo(): Promise<BondData>;
+}
+/**
+ * Get all Turkish government bond yields.
+ *
+ * @returns Array of bond data
+ *
+ * @example
+ * ```typescript
+ * import { bonds } from 'borsajs';
+ * const allBonds = await bonds();
+ * ```
+ */
+export declare function bonds(): Promise<BondData[]>;
+/**
+ * Get the risk-free rate for Turkish market (10Y bond yield).
+ *
+ * @returns 10-year government bond yield as decimal
+ *
+ * @example
+ * ```typescript
+ * import { riskFreeRate } from 'borsajs';
+ * const rfr = await riskFreeRate();
+ * console.log(`Risk-free rate: ${(rfr * 100).toFixed(2)}%`);
+ * ```
+ */
+export declare function riskFreeRate(): Promise<number | null>;
+//# sourceMappingURL=bond.d.ts.map

package/dist/bond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bond.d.ts","sourceRoot":"","sources":["../src/bond.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB,qBAAa,IAAI;IACb,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAyB;IAE1C;;;;;;;;;;OAUG;gBACS,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK;YAI3B,OAAO;IAOrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAKhC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKzC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK5C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;CAGrC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAGjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG3D"}

package/dist/bond.js

@@ -0,0 +1,110 @@
+/**
+ * Bond class for Turkish government bond yields - yfinance-like API.
+ */
+import { getBondProvider } from './providers/dovizcom-bond.js';
+export class Bond {
+    maturity;
+    provider = getBondProvider();
+    dataCache = null;
+    /**
+     * Create a Bond instance for a specific maturity.
+     *
+     * @param maturity - Bond maturity (2Y, 5Y, or 10Y)
+     *
+     * @example
+     * ```typescript
+     * const bond = new Bond('10Y');
+     * const yieldRate = await bond.getYieldRate();
+     * ```
+     */
+    constructor(maturity) {
+        this.maturity = maturity.toUpperCase();
+    }
+    async getData() {
+        if (!this.dataCache) {
+            this.dataCache = await this.provider.getBond(this.maturity);
+        }
+        return this.dataCache;
+    }
+    /**
+     * Get the bond maturity.
+     */
+    getMaturity() {
+        return this.maturity;
+    }
+    /**
+     * Get the bond name.
+     */
+    async getName() {
+        const data = await this.getData();
+        return data.name;
+    }
+    /**
+     * Get the current yield as percentage.
+     * @returns Yield rate as percentage (e.g., 28.03 for 28.03%)
+     */
+    async getYieldRate() {
+        const data = await this.getData();
+        return data.yield;
+    }
+    /**
+     * Get the current yield as decimal.
+     * @returns Yield rate as decimal (e.g., 0.2803 for 28.03%)
+     */
+    async getYieldDecimal() {
+        const data = await this.getData();
+        return data.yieldDecimal;
+    }
+    /**
+     * Get the absolute change in yield.
+     */
+    async getChange() {
+        const data = await this.getData();
+        return data.change;
+    }
+    /**
+     * Get the percentage change in yield.
+     */
+    async getChangePct() {
+        const data = await this.getData();
+        return data.changePct;
+    }
+    /**
+     * Get all bond information.
+     */
+    async getInfo() {
+        return this.getData();
+    }
+}
+/**
+ * Get all Turkish government bond yields.
+ *
+ * @returns Array of bond data
+ *
+ * @example
+ * ```typescript
+ * import { bonds } from 'borsajs';
+ * const allBonds = await bonds();
+ * ```
+ */
+export async function bonds() {
+    const provider = getBondProvider();
+    return provider.getBondYields();
+}
+/**
+ * Get the risk-free rate for Turkish market (10Y bond yield).
+ *
+ * @returns 10-year government bond yield as decimal
+ *
+ * @example
+ * ```typescript
+ * import { riskFreeRate } from 'borsajs';
+ * const rfr = await riskFreeRate();
+ * console.log(`Risk-free rate: ${(rfr * 100).toFixed(2)}%`);
+ * ```
+ */
+export async function riskFreeRate() {
+    const provider = getBondProvider();
+    return provider.get10YYield();
+}
+//# sourceMappingURL=bond.js.map

package/dist/bond.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bond.js","sourceRoot":"","sources":["../src/bond.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAiB,MAAM,8BAA8B,CAAC;AAG9E,MAAM,OAAO,IAAI;IACL,QAAQ,CAAsB;IAC9B,QAAQ,GAAG,eAAe,EAAE,CAAC;IAC7B,SAAS,GAAoB,IAAI,CAAC;IAE1C;;;;;;;;;;OAUG;IACH,YAAY,QAA6B;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAyB,CAAC;IAClE,CAAC;IAEO,KAAK,CAAC,OAAO;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,WAAW;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACjB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACX,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;CACJ;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK;IACvB,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,OAAO,QAAQ,CAAC,aAAa,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAC9B,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/dist/calendar.d.ts

@@ -0,0 +1,77 @@
+/**
+ * EconomicCalendar class for economic events - yfinance-like API.
+ */
+import { type EconomicEvent } from './providers/dovizcom-calendar.js';
+export type { EconomicEvent };
+export declare class EconomicCalendar {
+    private static readonly COUNTRIES;
+    private provider;
+    /**
+     * Get economic calendar events.
+     *
+     * @param options - Options for filtering events
+     * @returns Array of economic events
+     *
+     * @example
+     * ```typescript
+     * const cal = new EconomicCalendar();
+     * const events = await cal.events({ period: '1w' });
+     * ```
+     */
+    events(options?: {
+        period?: '1d' | '1w' | '2w' | '1mo';
+        start?: Date | string;
+        end?: Date | string;
+        country?: string | string[];
+        importance?: 'low' | 'mid' | 'high';
+    }): Promise<EconomicEvent[]>;
+    /**
+     * Get today's economic events.
+     */
+    today(options?: {
+        country?: string | string[];
+        importance?: 'low' | 'mid' | 'high';
+    }): Promise<EconomicEvent[]>;
+    /**
+     * Get this week's economic events.
+     */
+    thisWeek(options?: {
+        country?: string | string[];
+        importance?: 'low' | 'mid' | 'high';
+    }): Promise<EconomicEvent[]>;
+    /**
+     * Get this month's economic events.
+     */
+    thisMonth(options?: {
+        country?: string | string[];
+        importance?: 'low' | 'mid' | 'high';
+    }): Promise<EconomicEvent[]>;
+    /**
+     * Get high importance events only.
+     */
+    highImportance(options?: {
+        period?: '1d' | '1w' | '2w' | '1mo';
+        country?: string | string[];
+    }): Promise<EconomicEvent[]>;
+    /**
+     * Get list of supported country codes.
+     */
+    static countries(): string[];
+    private parseDate;
+    private parseCountries;
+}
+/**
+ * Get economic calendar events (convenience function).
+ *
+ * @example
+ * ```typescript
+ * import { economicCalendar } from 'borsajs';
+ * const events = await economicCalendar({ period: '1w' });
+ * ```
+ */
+export declare function economicCalendar(options?: {
+    period?: '1d' | '1w' | '2w' | '1mo';
+    country?: string | string[];
+    importance?: 'low' | 'mid' | 'high';
+}): Promise<EconomicEvent[]>;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAA4E;IAE7G,OAAO,CAAC,QAAQ,CAAyB;IAEzC;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,OAAO,GAAE;QAClB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;QACpC,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACtB,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;KAClC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA6BjC;;OAEG;IACG,KAAK,CAAC,OAAO,GAAE;QACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;KAClC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIjC;;OAEG;IACG,QAAQ,CAAC,OAAO,GAAE;QACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;KAClC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIjC;;OAEG;IACG,SAAS,CAAC,OAAO,GAAE;QACrB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;KAClC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIjC;;OAEG;IACG,cAAc,CAAC,OAAO,GAAE;QAC1B,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;QACpC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC1B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIjC;;OAEG;IACH,MAAM,CAAC,SAAS,IAAI,MAAM,EAAE;IAI5B,OAAO,CAAC,SAAS;IA0BjB,OAAO,CAAC,cAAc;CAKzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE;IAC5C,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CAClC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAGhC"}