reportify-sdk 0.3.8 → 0.3.10

package/README.md

@@ -98,19 +98,19 @@ const result = await client.docs.uploadDocs([
 
 ```typescript
 // Compute technical indicators
-const rsi = await client.quant.computeIndicators({
+const rsi = await client.quant.indicatorsCompute({
   symbols: ['000001'],
   formula: 'RSI(14)'
 });
 
-const macd = await client.quant.computeIndicators({
+const macd = await client.quant.indicatorsCompute({
   symbols: ['000001'],
   formula: 'MACD()'
 });
 
 // Screen stocks by formula
-const oversold = await client.quant.screen({ formula: 'RSI(14) < 30' });
-const goldenCross = await client.quant.screen({ formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))' });
+const oversold = await client.quant.factorsScreen({ formula: 'RSI(14) < 30' });
+const goldenCross = await client.quant.factorsScreen({ formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))' });
 
 // Get OHLCV data
 const ohlcv = await client.quant.ohlcv({ symbol: '000001', startDate: '2024-01-01' });

package/dist/index.d.mts

@@ -62,6 +62,8 @@ interface EarningsSearchOptions {
     endDatetime?: string;
     fiscalYear?: string;
     fiscalQuarter?: string;
+    /** Sort order: 'date_desc' (newest first, default when no query), 'relevance' (recommended when query is provided), 'date_asc' (oldest first) */
+    sortBy?: 'relevance' | 'date_desc' | 'date_asc';
 }
 interface CompanyOverview {
     symbol: string;
@@ -757,13 +759,13 @@ interface BacktestResult {
  * @example
  * ```typescript
  * // Compute RSI indicator
- * const data = await client.quant.computeIndicators({
+ * const data = await client.quant.indicatorsCompute({
  *   symbols: ['000001'],
  *   formula: 'RSI(14)'
  * });
  *
  * // Screen stocks by formula
- * const stocks = await client.quant.screen({
+ * const stocks = await client.quant.factorsScreen({
  *   formula: 'RSI(14) < 30'
  * });
  * ```
@@ -780,14 +782,14 @@ declare class QuantModule {
      *
      * @example
      * ```typescript
-     * const indicators = await client.quant.listIndicators();
+     * const indicators = await client.quant.indicators();
      * indicators.forEach(ind => {
      *   console.log(`${ind.name}: ${ind.description}`);
      *   console.log(`  Fields: ${ind.fields.join(', ')}`);
      * });
      * ```
      */
-    listIndicators(): Promise<IndicatorMeta[]>;
+    indicators(): Promise<IndicatorMeta[]>;
     /**
      * Compute indicator values for given symbols
      *
@@ -801,25 +803,25 @@ declare class QuantModule {
      * @example
      * ```typescript
      * // RSI indicator
-     * const data = await client.quant.computeIndicators({
+     * const data = await client.quant.indicatorsCompute({
      *   symbols: ['000001'],
      *   formula: 'RSI(14)'
      * });
      *
      * // MACD indicator
-     * const data = await client.quant.computeIndicators({
+     * const data = await client.quant.indicatorsCompute({
      *   symbols: ['000001'],
      *   formula: 'MACD()'
      * });
      *
      * // Standard deviation
-     * const data = await client.quant.computeIndicators({
+     * const data = await client.quant.indicatorsCompute({
      *   symbols: ['000001'],
      *   formula: 'STD(CLOSE, 20)'
      * });
      * ```
      */
-    computeIndicators(params: IndicatorComputeParams): Promise<IndicatorData[]>;
+    indicatorsCompute(params: IndicatorComputeParams): Promise<IndicatorData[]>;
     /**
      * Get list of available factors (variables and functions)
      *
@@ -829,7 +831,7 @@ declare class QuantModule {
      *
      * @returns Array of factor definitions organized by level
      */
-    listFactors(): Promise<FactorMeta[]>;
+    factors(): Promise<FactorMeta[]>;
     /**
      * Compute factor values for given symbols
      *
@@ -845,31 +847,31 @@ declare class QuantModule {
      * @example
      * ```typescript
      * // Simple indicator
-     * const data = await client.quant.computeFactors({
+     * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'RSI(14)'
      * });
      *
      * // MACD DIF line
-     * const data = await client.quant.computeFactors({
+     * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'MACD().dif'
      * });
      *
      * // Close above 20-day MA
-     * const data = await client.quant.computeFactors({
+     * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'CLOSE > MA(CLOSE, 20)'
      * });
      *
      * // Fundamental factors (note: functions require parentheses)
-     * const data = await client.quant.computeFactors({
+     * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'PE()'
      * });
      * ```
      */
-    computeFactors(params: FactorComputeParams): Promise<IndicatorData[]>;
+    factorsCompute(params: FactorComputeParams): Promise<IndicatorData[]>;
     /**
      * Screen stocks based on factor formula
      *
@@ -883,27 +885,27 @@ declare class QuantModule {
      * @example
      * ```typescript
      * // RSI oversold
-     * const stocks = await client.quant.screen({
+     * const stocks = await client.quant.factorsScreen({
      *   formula: 'RSI(14) < 30'
      * });
      *
      * // Golden cross
-     * const stocks = await client.quant.screen({
+     * const stocks = await client.quant.factorsScreen({
      *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
      * });
      *
      * // Uptrend
-     * const stocks = await client.quant.screen({
+     * const stocks = await client.quant.factorsScreen({
      *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
      * });
      *
      * // Fundamental screening (note: functions require parentheses)
-     * const stocks = await client.quant.screen({
+     * const stocks = await client.quant.factorsScreen({
      *   formula: '(PE() < 20) & (ROE() > 0.15)'
      * });
      * ```
      */
-    screen(params: ScreenParams): Promise<ScreenedStock[]>;
+    factorsScreen(params: ScreenParams): Promise<ScreenedStock[]>;
     /**
      * Get OHLCV daily data for a single symbol
      *
@@ -1435,21 +1437,27 @@ declare class SearchModule {
      */
     filings(query: string, symbols: string[], options?: Omit<SearchOptions, 'symbols' | 'categories' | 'industries' | 'channelIds'>): Promise<Document[]>;
     /**
-     * Search earnings call transcripts and slides
+     * Search for earnings-related conference call transcripts and presentation slides.
+     * Query is optional - if not provided, returns documents in reverse chronological order;
+     * if provided, results are sorted by relevance by default.
      *
-     * @param query - Search query string
      * @param symbols - Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
-     * @param options - Search options including fiscal year/quarter filters
+     * @param options - Search options including query, fiscal year/quarter filters, and sort order
      */
-    conferenceCalls(query: string, symbols: string[], options?: EarningsSearchOptions): Promise<Document[]>;
+    conferenceCalls(symbols: string[], options?: EarningsSearchOptions & {
+        query?: string;
+    }): Promise<Document[]>;
     /**
-     * Search earnings financial reports
+     * Search for earnings-related documents submitted to exchanges, including quarterly reports,
+     * semi-annual reports, and annual reports. Query is optional - if not provided, returns
+     * documents in reverse chronological order; if provided, results are sorted by relevance by default.
      *
-     * @param query - Search query string
      * @param symbols - Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
-     * @param options - Search options including fiscal year/quarter filters
+     * @param options - Search options including query, fiscal year/quarter filters, and sort order
      */
-    earningsPack(query: string, symbols: string[], options?: EarningsSearchOptions): Promise<Document[]>;
+    earningsPack(symbols: string[], options?: EarningsSearchOptions & {
+        query?: string;
+    }): Promise<Document[]>;
     /**
      * Search conference calls and IR (Investor Relations) meetings
      */

package/dist/index.d.ts

@@ -62,6 +62,8 @@ interface EarningsSearchOptions {
     endDatetime?: string;
     fiscalYear?: string;
     fiscalQuarter?: string;
+    /** Sort order: 'date_desc' (newest first, default when no query), 'relevance' (recommended when query is provided), 'date_asc' (oldest first) */
+    sortBy?: 'relevance' | 'date_desc' | 'date_asc';
 }
 interface CompanyOverview {
     symbol: string;
@@ -757,13 +759,13 @@ interface BacktestResult {
  * @example
  * ```typescript
  * // Compute RSI indicator
- * const data = await client.quant.computeIndicators({
+ * const data = await client.quant.indicatorsCompute({
  *   symbols: ['000001'],
  *   formula: 'RSI(14)'
  * });
  *
  * // Screen stocks by formula
- * const stocks = await client.quant.screen({
+ * const stocks = await client.quant.factorsScreen({
  *   formula: 'RSI(14) < 30'
  * });
  * ```
@@ -780,14 +782,14 @@ declare class QuantModule {
      *
      * @example
      * ```typescript
-     * const indicators = await client.quant.listIndicators();
+     * const indicators = await client.quant.indicators();
      * indicators.forEach(ind => {
      *   console.log(`${ind.name}: ${ind.description}`);
      *   console.log(`  Fields: ${ind.fields.join(', ')}`);
      * });
      * ```
      */
-    listIndicators(): Promise<IndicatorMeta[]>;
+    indicators(): Promise<IndicatorMeta[]>;
     /**
      * Compute indicator values for given symbols
      *
@@ -801,25 +803,25 @@ declare class QuantModule {
      * @example
      * ```typescript
      * // RSI indicator
-     * const data = await client.quant.computeIndicators({
+     * const data = await client.quant.indicatorsCompute({
      *   symbols: ['000001'],
      *   formula: 'RSI(14)'
      * });
      *
      * // MACD indicator
-     * const data = await client.quant.computeIndicators({
+     * const data = await client.quant.indicatorsCompute({
      *   symbols: ['000001'],
      *   formula: 'MACD()'
      * });
      *
      * // Standard deviation
-     * const data = await client.quant.computeIndicators({
+     * const data = await client.quant.indicatorsCompute({
      *   symbols: ['000001'],
      *   formula: 'STD(CLOSE, 20)'
      * });
      * ```
      */
-    computeIndicators(params: IndicatorComputeParams): Promise<IndicatorData[]>;
+    indicatorsCompute(params: IndicatorComputeParams): Promise<IndicatorData[]>;
     /**
      * Get list of available factors (variables and functions)
      *
@@ -829,7 +831,7 @@ declare class QuantModule {
      *
      * @returns Array of factor definitions organized by level
      */
-    listFactors(): Promise<FactorMeta[]>;
+    factors(): Promise<FactorMeta[]>;
     /**
      * Compute factor values for given symbols
      *
@@ -845,31 +847,31 @@ declare class QuantModule {
      * @example
      * ```typescript
      * // Simple indicator
-     * const data = await client.quant.computeFactors({
+     * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'RSI(14)'
      * });
      *
      * // MACD DIF line
-     * const data = await client.quant.computeFactors({
+     * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'MACD().dif'
      * });
      *
      * // Close above 20-day MA
-     * const data = await client.quant.computeFactors({
+     * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'CLOSE > MA(CLOSE, 20)'
      * });
      *
      * // Fundamental factors (note: functions require parentheses)
-     * const data = await client.quant.computeFactors({
+     * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'PE()'
      * });
      * ```
      */
-    computeFactors(params: FactorComputeParams): Promise<IndicatorData[]>;
+    factorsCompute(params: FactorComputeParams): Promise<IndicatorData[]>;
     /**
      * Screen stocks based on factor formula
      *
@@ -883,27 +885,27 @@ declare class QuantModule {
      * @example
      * ```typescript
      * // RSI oversold
-     * const stocks = await client.quant.screen({
+     * const stocks = await client.quant.factorsScreen({
      *   formula: 'RSI(14) < 30'
      * });
      *
      * // Golden cross
-     * const stocks = await client.quant.screen({
+     * const stocks = await client.quant.factorsScreen({
      *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
      * });
      *
      * // Uptrend
-     * const stocks = await client.quant.screen({
+     * const stocks = await client.quant.factorsScreen({
      *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
      * });
      *
      * // Fundamental screening (note: functions require parentheses)
-     * const stocks = await client.quant.screen({
+     * const stocks = await client.quant.factorsScreen({
      *   formula: '(PE() < 20) & (ROE() > 0.15)'
      * });
      * ```
      */
-    screen(params: ScreenParams): Promise<ScreenedStock[]>;
+    factorsScreen(params: ScreenParams): Promise<ScreenedStock[]>;
     /**
      * Get OHLCV daily data for a single symbol
      *
@@ -1435,21 +1437,27 @@ declare class SearchModule {
      */
     filings(query: string, symbols: string[], options?: Omit<SearchOptions, 'symbols' | 'categories' | 'industries' | 'channelIds'>): Promise<Document[]>;
     /**
-     * Search earnings call transcripts and slides
+     * Search for earnings-related conference call transcripts and presentation slides.
+     * Query is optional - if not provided, returns documents in reverse chronological order;
+     * if provided, results are sorted by relevance by default.
      *
-     * @param query - Search query string
      * @param symbols - Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
-     * @param options - Search options including fiscal year/quarter filters
+     * @param options - Search options including query, fiscal year/quarter filters, and sort order
      */
-    conferenceCalls(query: string, symbols: string[], options?: EarningsSearchOptions): Promise<Document[]>;
+    conferenceCalls(symbols: string[], options?: EarningsSearchOptions & {
+        query?: string;
+    }): Promise<Document[]>;
     /**
-     * Search earnings financial reports
+     * Search for earnings-related documents submitted to exchanges, including quarterly reports,
+     * semi-annual reports, and annual reports. Query is optional - if not provided, returns
+     * documents in reverse chronological order; if provided, results are sorted by relevance by default.
      *
-     * @param query - Search query string
      * @param symbols - Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
-     * @param options - Search options including fiscal year/quarter filters
+     * @param options - Search options including query, fiscal year/quarter filters, and sort order
      */
-    earningsPack(query: string, symbols: string[], options?: EarningsSearchOptions): Promise<Document[]>;
+    earningsPack(symbols: string[], options?: EarningsSearchOptions & {
+        query?: string;
+    }): Promise<Document[]>;
     /**
      * Search conference calls and IR (Investor Relations) meetings
      */

package/dist/index.js

@@ -628,14 +628,14 @@ var QuantModule = class {
    *
    * @example
    * ```typescript
-   * const indicators = await client.quant.listIndicators();
+   * const indicators = await client.quant.indicators();
    * indicators.forEach(ind => {
    *   console.log(`${ind.name}: ${ind.description}`);
    *   console.log(`  Fields: ${ind.fields.join(', ')}`);
    * });
    * ```
    */
-  async listIndicators() {
+  async indicators() {
     return this.client.get("/v1/quant/indicators");
   }
   /**
@@ -651,25 +651,25 @@ var QuantModule = class {
    * @example
    * ```typescript
    * // RSI indicator
-   * const data = await client.quant.computeIndicators({
+   * const data = await client.quant.indicatorsCompute({
    *   symbols: ['000001'],
    *   formula: 'RSI(14)'
    * });
    *
    * // MACD indicator
-   * const data = await client.quant.computeIndicators({
+   * const data = await client.quant.indicatorsCompute({
    *   symbols: ['000001'],
    *   formula: 'MACD()'
    * });
    *
    * // Standard deviation
-   * const data = await client.quant.computeIndicators({
+   * const data = await client.quant.indicatorsCompute({
    *   symbols: ['000001'],
    *   formula: 'STD(CLOSE, 20)'
    * });
    * ```
    */
-  async computeIndicators(params) {
+  async indicatorsCompute(params) {
     const response = await this.client.post("/v1/quant/indicators/compute", {
       symbols: params.symbols,
       formula: params.formula,
@@ -691,7 +691,7 @@ var QuantModule = class {
    *
    * @returns Array of factor definitions organized by level
    */
-  async listFactors() {
+  async factors() {
     return this.client.get("/v1/quant/factors");
   }
   /**
@@ -709,31 +709,31 @@ var QuantModule = class {
    * @example
    * ```typescript
    * // Simple indicator
-   * const data = await client.quant.computeFactors({
+   * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'RSI(14)'
    * });
    *
    * // MACD DIF line
-   * const data = await client.quant.computeFactors({
+   * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'MACD().dif'
    * });
    *
    * // Close above 20-day MA
-   * const data = await client.quant.computeFactors({
+   * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'CLOSE > MA(CLOSE, 20)'
    * });
    *
    * // Fundamental factors (note: functions require parentheses)
-   * const data = await client.quant.computeFactors({
+   * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'PE()'
    * });
    * ```
    */
-  async computeFactors(params) {
+  async factorsCompute(params) {
     const response = await this.client.post("/v1/quant/factors/compute", {
       symbols: params.symbols,
       formula: params.formula,
@@ -756,27 +756,27 @@ var QuantModule = class {
    * @example
    * ```typescript
    * // RSI oversold
-   * const stocks = await client.quant.screen({
+   * const stocks = await client.quant.factorsScreen({
    *   formula: 'RSI(14) < 30'
    * });
    *
    * // Golden cross
-   * const stocks = await client.quant.screen({
+   * const stocks = await client.quant.factorsScreen({
    *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
    * });
    *
    * // Uptrend
-   * const stocks = await client.quant.screen({
+   * const stocks = await client.quant.factorsScreen({
    *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
    * });
    *
    * // Fundamental screening (note: functions require parentheses)
-   * const stocks = await client.quant.screen({
+   * const stocks = await client.quant.factorsScreen({
    *   formula: '(PE() < 20) & (ROE() > 0.15)'
    * });
    * ```
    */
-  async screen(params) {
+  async factorsScreen(params) {
     const response = await this.client.post("/v1/quant/factors/screen", {
       formula: params.formula,
       market: params.market || "cn",
@@ -1495,18 +1495,20 @@ var SearchModule = class {
     return response.docs || [];
   }
   /**
-   * Search earnings call transcripts and slides
+   * Search for earnings-related conference call transcripts and presentation slides.
+   * Query is optional - if not provided, returns documents in reverse chronological order;
+   * if provided, results are sorted by relevance by default.
    *
-   * @param query - Search query string
    * @param symbols - Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
-   * @param options - Search options including fiscal year/quarter filters
+   * @param options - Search options including query, fiscal year/quarter filters, and sort order
    */
-  async conferenceCalls(query, symbols, options = {}) {
+  async conferenceCalls(symbols, options = {}) {
     const body = {
-      query,
       symbols,
-      num: options.num || 10
+      num: options.num || 10,
+      sort_by: options.sortBy || "date_desc"
     };
+    if (options.query) body.query = options.query;
     if (options.startDatetime) body.start_datetime = options.startDatetime;
     if (options.endDatetime) body.end_datetime = options.endDatetime;
     if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
@@ -1515,18 +1517,20 @@ var SearchModule = class {
     return response.docs || [];
   }
   /**
-   * Search earnings financial reports
+   * Search for earnings-related documents submitted to exchanges, including quarterly reports,
+   * semi-annual reports, and annual reports. Query is optional - if not provided, returns
+   * documents in reverse chronological order; if provided, results are sorted by relevance by default.
    *
-   * @param query - Search query string
    * @param symbols - Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
-   * @param options - Search options including fiscal year/quarter filters
+   * @param options - Search options including query, fiscal year/quarter filters, and sort order
    */
-  async earningsPack(query, symbols, options = {}) {
+  async earningsPack(symbols, options = {}) {
     const body = {
-      query,
       symbols,
-      num: options.num || 10
+      num: options.num || 10,
+      sort_by: options.sortBy || "date_desc"
     };
+    if (options.query) body.query = options.query;
     if (options.startDatetime) body.start_datetime = options.startDatetime;
     if (options.endDatetime) body.end_datetime = options.endDatetime;
     if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
@@ -1670,7 +1674,7 @@ var Reportify = class {
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
           "Content-Type": "application/json",
-          "User-Agent": "reportify-sdk-js/0.3.8"
+          "User-Agent": "reportify-sdk-js/0.3.10"
         },
         body: options.body ? JSON.stringify(options.body) : void 0,
         signal: controller.signal
@@ -1731,7 +1735,7 @@ var Reportify = class {
       headers: {
         Authorization: `Bearer ${this.apiKey}`,
         "Content-Type": "application/json",
-        "User-Agent": "reportify-sdk-typescript/0.3.8"
+        "User-Agent": "reportify-sdk-typescript/0.3.10"
       }
     });
     if (!response.ok) {

package/dist/index.mjs

@@ -586,14 +586,14 @@ var QuantModule = class {
    *
    * @example
    * ```typescript
-   * const indicators = await client.quant.listIndicators();
+   * const indicators = await client.quant.indicators();
    * indicators.forEach(ind => {
    *   console.log(`${ind.name}: ${ind.description}`);
    *   console.log(`  Fields: ${ind.fields.join(', ')}`);
    * });
    * ```
    */
-  async listIndicators() {
+  async indicators() {
     return this.client.get("/v1/quant/indicators");
   }
   /**
@@ -609,25 +609,25 @@ var QuantModule = class {
    * @example
    * ```typescript
    * // RSI indicator
-   * const data = await client.quant.computeIndicators({
+   * const data = await client.quant.indicatorsCompute({
    *   symbols: ['000001'],
    *   formula: 'RSI(14)'
    * });
    *
    * // MACD indicator
-   * const data = await client.quant.computeIndicators({
+   * const data = await client.quant.indicatorsCompute({
    *   symbols: ['000001'],
    *   formula: 'MACD()'
    * });
    *
    * // Standard deviation
-   * const data = await client.quant.computeIndicators({
+   * const data = await client.quant.indicatorsCompute({
    *   symbols: ['000001'],
    *   formula: 'STD(CLOSE, 20)'
    * });
    * ```
    */
-  async computeIndicators(params) {
+  async indicatorsCompute(params) {
     const response = await this.client.post("/v1/quant/indicators/compute", {
       symbols: params.symbols,
       formula: params.formula,
@@ -649,7 +649,7 @@ var QuantModule = class {
    *
    * @returns Array of factor definitions organized by level
    */
-  async listFactors() {
+  async factors() {
     return this.client.get("/v1/quant/factors");
   }
   /**
@@ -667,31 +667,31 @@ var QuantModule = class {
    * @example
    * ```typescript
    * // Simple indicator
-   * const data = await client.quant.computeFactors({
+   * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'RSI(14)'
    * });
    *
    * // MACD DIF line
-   * const data = await client.quant.computeFactors({
+   * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'MACD().dif'
    * });
    *
    * // Close above 20-day MA
-   * const data = await client.quant.computeFactors({
+   * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'CLOSE > MA(CLOSE, 20)'
    * });
    *
    * // Fundamental factors (note: functions require parentheses)
-   * const data = await client.quant.computeFactors({
+   * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'PE()'
    * });
    * ```
    */
-  async computeFactors(params) {
+  async factorsCompute(params) {
     const response = await this.client.post("/v1/quant/factors/compute", {
       symbols: params.symbols,
       formula: params.formula,
@@ -714,27 +714,27 @@ var QuantModule = class {
    * @example
    * ```typescript
    * // RSI oversold
-   * const stocks = await client.quant.screen({
+   * const stocks = await client.quant.factorsScreen({
    *   formula: 'RSI(14) < 30'
    * });
    *
    * // Golden cross
-   * const stocks = await client.quant.screen({
+   * const stocks = await client.quant.factorsScreen({
    *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
    * });
    *
    * // Uptrend
-   * const stocks = await client.quant.screen({
+   * const stocks = await client.quant.factorsScreen({
    *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
    * });
    *
    * // Fundamental screening (note: functions require parentheses)
-   * const stocks = await client.quant.screen({
+   * const stocks = await client.quant.factorsScreen({
    *   formula: '(PE() < 20) & (ROE() > 0.15)'
    * });
    * ```
    */
-  async screen(params) {
+  async factorsScreen(params) {
     const response = await this.client.post("/v1/quant/factors/screen", {
       formula: params.formula,
       market: params.market || "cn",
@@ -1453,18 +1453,20 @@ var SearchModule = class {
     return response.docs || [];
   }
   /**
-   * Search earnings call transcripts and slides
+   * Search for earnings-related conference call transcripts and presentation slides.
+   * Query is optional - if not provided, returns documents in reverse chronological order;
+   * if provided, results are sorted by relevance by default.
    *
-   * @param query - Search query string
    * @param symbols - Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
-   * @param options - Search options including fiscal year/quarter filters
+   * @param options - Search options including query, fiscal year/quarter filters, and sort order
    */
-  async conferenceCalls(query, symbols, options = {}) {
+  async conferenceCalls(symbols, options = {}) {
     const body = {
-      query,
       symbols,
-      num: options.num || 10
+      num: options.num || 10,
+      sort_by: options.sortBy || "date_desc"
     };
+    if (options.query) body.query = options.query;
     if (options.startDatetime) body.start_datetime = options.startDatetime;
     if (options.endDatetime) body.end_datetime = options.endDatetime;
     if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
@@ -1473,18 +1475,20 @@ var SearchModule = class {
     return response.docs || [];
   }
   /**
-   * Search earnings financial reports
+   * Search for earnings-related documents submitted to exchanges, including quarterly reports,
+   * semi-annual reports, and annual reports. Query is optional - if not provided, returns
+   * documents in reverse chronological order; if provided, results are sorted by relevance by default.
    *
-   * @param query - Search query string
    * @param symbols - Stock symbols in market:ticker format (required, e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
-   * @param options - Search options including fiscal year/quarter filters
+   * @param options - Search options including query, fiscal year/quarter filters, and sort order
    */
-  async earningsPack(query, symbols, options = {}) {
+  async earningsPack(symbols, options = {}) {
     const body = {
-      query,
       symbols,
-      num: options.num || 10
+      num: options.num || 10,
+      sort_by: options.sortBy || "date_desc"
     };
+    if (options.query) body.query = options.query;
     if (options.startDatetime) body.start_datetime = options.startDatetime;
     if (options.endDatetime) body.end_datetime = options.endDatetime;
     if (options.fiscalYear) body.fiscal_year = options.fiscalYear;
@@ -1628,7 +1632,7 @@ var Reportify = class {
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
           "Content-Type": "application/json",
-          "User-Agent": "reportify-sdk-js/0.3.8"
+          "User-Agent": "reportify-sdk-js/0.3.10"
         },
         body: options.body ? JSON.stringify(options.body) : void 0,
         signal: controller.signal
@@ -1689,7 +1693,7 @@ var Reportify = class {
       headers: {
         Authorization: `Bearer ${this.apiKey}`,
         "Content-Type": "application/json",
-        "User-Agent": "reportify-sdk-typescript/0.3.8"
+        "User-Agent": "reportify-sdk-typescript/0.3.10"
       }
     });
     if (!response.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reportify-sdk",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "description": "TypeScript SDK for Reportify API - Financial data and document search",
   "main": "dist/index.js",
   "module": "dist/index.mjs",