valyu-js 2.0.0 → 2.0.2

package/README.md

@@ -60,9 +60,12 @@ valyu.search(
         relevanceThreshold: 0.5,                 // Minimum relevance score (0-1)
         maxPrice: 30,                            // Maximum price per thousand queries (CPM)
         includedSources: [],                     // Specific sources to search
+        excludeSources: [],                      // Sources/domains to exclude
         category: null,                          // Category filter
         startDate: null,                         // Start date (YYYY-MM-DD)
-        endDate: null                            // End date (YYYY-MM-DD)
+        endDate: null,                           // End date (YYYY-MM-DD)
+        countryCode: null,                       // Country code filter
+        responseLength: null                     // Response length control
     }
 )
 ```
@@ -78,9 +81,12 @@ valyu.search(
 | `relevanceThreshold` | `number` | `0.5` | Minimum relevance score for results (0.0-1.0) |
 | `maxPrice` | `number` | `30` | Maximum price per thousand queries in CPM |
 | `includedSources` | `string[]` | `[]` | Specific data sources or URLs to search |
+| `excludeSources` | `string[]` | `[]` | List of URLs/domains to exclude from search results |
 | `category` | `string` | `null` | Category filter for results |
 | `startDate` | `string` | `null` | Start date filter in YYYY-MM-DD format |
 | `endDate` | `string` | `null` | End date filter in YYYY-MM-DD format |
+| `countryCode` | `string` | `null` | Country code filter (e.g., "US", "GB", "JP", "ALL") |
+| `responseLength` | `string \| number` | `null` | Response length: "short", "medium", "large", "max", or character count |
 
 ### Response Format
 
@@ -129,23 +135,24 @@ const { Valyu } = require('valyu');
 
 const valyu = new Valyu("your-api-key");
 
-// Simple search across all sources
-const response = await valyu.search("What is machine learning?");
-console.log(`Found ${response.results.length} results`);
+// Simple search with no search parameters
+const response = await valyu.search("what is trans-applifying mRNA");
+console.log(response);
 ```
 
 ### Academic Research
 
 ```javascript
-// Search academic papers on arXiv
+// Deep search over academic papers
 const response = await valyu.search(
-  "agentic search-enhanced large reasoning models",
+  "implementation details of agentic search-enhanced large reasoning models",
   {
     searchType: "proprietary",
     maxNumResults: 10,
     relevanceThreshold: 0.6,
     includedSources: ["valyu/valyu-arxiv"],
-    startDate: "2024-05-01"
+    category: "agentic RAG",
+    startDate: "2024-12-01"
   }
 );
 ```
@@ -153,31 +160,63 @@ const response = await valyu.search(
 ### Web Search with Date Filtering
 
 ```javascript
-// Search recent web content
+// Web search with date range
 const response = await valyu.search(
-  "what is claude 4 opus model",
+  "what are the grok 4 benchmark results",
   {
     searchType: "web",
     maxNumResults: 7,
     relevanceThreshold: 0.5,
-    startDate: "2024-01-01",
-    endDate: "2024-12-31"
+    startDate: "2025-06-01",
+    endDate: "2025-07-25"
   }
 );
 ```
 
-### Hybrid Search
+### Country-Specific Search
 
 ```javascript
-// Search both web and proprietary sources
+// Web search with country filtering
 const response = await valyu.search(
-    "quantum computing breakthroughs",
-    {
-        searchType: "all",
-        category: "technology",
-        relevanceThreshold: 0.6,
-        maxPrice: 50
-    }
+  "what is the weather where i am?",
+  {
+    searchType: "web",
+    maxNumResults: 2,
+    countryCode: "UK",
+    responseLength: "short"
+  }
+);
+```
+
+### Search with Source Exclusion
+
+```javascript
+// Hybrid search excluding specific sources
+const response = await valyu.search(
+  "quantum computing applications in cryptography",
+  {
+    searchType: "all",
+    maxNumResults: 8,
+    relevanceThreshold: 0.5,
+    maxPrice: 40,
+    excludeSources: ["paperswithcode.com", "wikipedia.org"],
+    responseLength: "large",
+    isToolCall: true
+  }
+);
+```
+
+### Custom Response Length
+
+```javascript
+// Search with custom character count
+const response = await valyu.search(
+  "State of video generation AI models",
+  {
+    maxNumResults: 10,
+    category: "vLLMs",
+    responseLength: 1000  // Limit to 1000 characters per result
+  }
 );
 ```
 
@@ -215,14 +254,6 @@ Set your API key in one of these ways:
    const valyu = new Valyu("your-api-key-here");
    ```
 
-3. **Custom base URL** (for staging/testing):
-   ```javascript
-   const valyu = new Valyu(
-       "your-api-key-here",
-       "https://stage.api.valyu.network/v1"
-   );
-   ```
-
 ## Error Handling
 
 The SDK handles errors gracefully and returns structured error responses:
@@ -243,17 +274,20 @@ if (!response.success) {
 
 ## TypeScript Support
 
-The SDK includes full TypeScript support:
+The SDK includes full TypeScript support with type definitions for all parameters:
 
 ```typescript
-import { Valyu, SearchOptions, SearchResponse } from 'valyu';
+import { Valyu, SearchOptions, SearchResponse, CountryCode, ResponseLength } from 'valyu';
 
 const valyu = new Valyu("your-api-key");
 
 const options: SearchOptions = {
     searchType: "proprietary",
     maxNumResults: 10,
-    relevanceThreshold: 0.6
+    relevanceThreshold: 0.6,
+    excludeSources: ["reddit.com", "twitter.com"],
+    countryCode: "US" as CountryCode,
+    responseLength: "medium" as ResponseLength
 };
 
 const response: SearchResponse = await valyu.search("machine learning", options);

package/dist/index.d.mts

@@ -1,6 +1,8 @@
 type SearchType = "web" | "proprietary" | "all";
 type FeedbackSentiment = "very good" | "good" | "bad" | "very bad";
 type DataType = "structured" | "unstructured";
+type CountryCode = "ALL" | "AR" | "AU" | "AT" | "BE" | "BR" | "CA" | "CL" | "DK" | "FI" | "FR" | "DE" | "HK" | "IN" | "ID" | "IT" | "JP" | "KR" | "MY" | "MX" | "NL" | "NZ" | "NO" | "CN" | "PL" | "PT" | "PH" | "RU" | "SA" | "ZA" | "ES" | "SE" | "CH" | "TW" | "TR" | "GB" | "US";
+type ResponseLength = "short" | "medium" | "large" | "max" | number;
 interface SearchResult {
     title: string;
     url: string;
@@ -19,9 +21,12 @@ interface SearchOptions {
     isToolCall?: boolean;
     relevanceThreshold?: number;
     includedSources?: string[];
+    excludeSources?: string[];
     category?: string;
     startDate?: string;
     endDate?: string;
+    countryCode?: CountryCode;
+    responseLength?: ResponseLength;
 }
 interface SearchResponse {
     success: boolean;
@@ -51,9 +56,24 @@ declare class Valyu {
      */
     private validateDateFormat;
     /**
-     * Search for information using the Valyu API v2
+     * Search for information using the Valyu DeepSearch API
+     * @param query - The search query string
+     * @param options - Search configuration options
+     * @param options.searchType - Type of search: "web", "proprietary", or "all"
+     * @param options.maxNumResults - Maximum number of results (1-20)
+     * @param options.maxPrice - Maximum price per thousand characters (CPM)
+     * @param options.isToolCall - Whether this is a tool call
+     * @param options.relevanceThreshold - Minimum relevance score (0-1)
+     * @param options.includedSources - List of specific sources to include
+     * @param options.excludeSources - List of URLs/domains to exclude from search results
+     * @param options.category - Category filter for search results
+     * @param options.startDate - Start date filter (YYYY-MM-DD format)
+     * @param options.endDate - End date filter (YYYY-MM-DD format)
+     * @param options.countryCode - Country code filter for search results
+     * @param options.responseLength - Response content length: "short"/"medium"/"large"/"max" or integer character count
+     * @returns Promise resolving to search results
      */
     search(query: string, options?: SearchOptions): Promise<SearchResponse>;
 }
 
-export { type FeedbackResponse, type FeedbackSentiment, type SearchOptions, type SearchResponse, type SearchType, Valyu };
+export { type CountryCode, type FeedbackResponse, type FeedbackSentiment, type ResponseLength, type SearchOptions, type SearchResponse, type SearchType, Valyu };

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 type SearchType = "web" | "proprietary" | "all";
 type FeedbackSentiment = "very good" | "good" | "bad" | "very bad";
 type DataType = "structured" | "unstructured";
+type CountryCode = "ALL" | "AR" | "AU" | "AT" | "BE" | "BR" | "CA" | "CL" | "DK" | "FI" | "FR" | "DE" | "HK" | "IN" | "ID" | "IT" | "JP" | "KR" | "MY" | "MX" | "NL" | "NZ" | "NO" | "CN" | "PL" | "PT" | "PH" | "RU" | "SA" | "ZA" | "ES" | "SE" | "CH" | "TW" | "TR" | "GB" | "US";
+type ResponseLength = "short" | "medium" | "large" | "max" | number;
 interface SearchResult {
     title: string;
     url: string;
@@ -19,9 +21,12 @@ interface SearchOptions {
     isToolCall?: boolean;
     relevanceThreshold?: number;
     includedSources?: string[];
+    excludeSources?: string[];
     category?: string;
     startDate?: string;
     endDate?: string;
+    countryCode?: CountryCode;
+    responseLength?: ResponseLength;
 }
 interface SearchResponse {
     success: boolean;
@@ -51,9 +56,24 @@ declare class Valyu {
      */
     private validateDateFormat;
     /**
-     * Search for information using the Valyu API v2
+     * Search for information using the Valyu DeepSearch API
+     * @param query - The search query string
+     * @param options - Search configuration options
+     * @param options.searchType - Type of search: "web", "proprietary", or "all"
+     * @param options.maxNumResults - Maximum number of results (1-20)
+     * @param options.maxPrice - Maximum price per thousand characters (CPM)
+     * @param options.isToolCall - Whether this is a tool call
+     * @param options.relevanceThreshold - Minimum relevance score (0-1)
+     * @param options.includedSources - List of specific sources to include
+     * @param options.excludeSources - List of URLs/domains to exclude from search results
+     * @param options.category - Category filter for search results
+     * @param options.startDate - Start date filter (YYYY-MM-DD format)
+     * @param options.endDate - End date filter (YYYY-MM-DD format)
+     * @param options.countryCode - Country code filter for search results
+     * @param options.responseLength - Response content length: "short"/"medium"/"large"/"max" or integer character count
+     * @returns Promise resolving to search results
      */
     search(query: string, options?: SearchOptions): Promise<SearchResponse>;
 }
 
-export { type FeedbackResponse, type FeedbackSentiment, type SearchOptions, type SearchResponse, type SearchType, Valyu };
+export { type CountryCode, type FeedbackResponse, type FeedbackSentiment, type ResponseLength, type SearchOptions, type SearchResponse, type SearchType, Valyu };

package/dist/index.js

@@ -60,7 +60,22 @@ var Valyu = class {
     return parsedDate instanceof Date && !isNaN(parsedDate.getTime());
   }
   /**
-   * Search for information using the Valyu API v2
+   * Search for information using the Valyu DeepSearch API
+   * @param query - The search query string
+   * @param options - Search configuration options
+   * @param options.searchType - Type of search: "web", "proprietary", or "all"
+   * @param options.maxNumResults - Maximum number of results (1-20)
+   * @param options.maxPrice - Maximum price per thousand characters (CPM)
+   * @param options.isToolCall - Whether this is a tool call
+   * @param options.relevanceThreshold - Minimum relevance score (0-1)
+   * @param options.includedSources - List of specific sources to include
+   * @param options.excludeSources - List of URLs/domains to exclude from search results
+   * @param options.category - Category filter for search results
+   * @param options.startDate - Start date filter (YYYY-MM-DD format)
+   * @param options.endDate - End date filter (YYYY-MM-DD format)
+   * @param options.countryCode - Country code filter for search results
+   * @param options.responseLength - Response content length: "short"/"medium"/"large"/"max" or integer character count
+   * @returns Promise resolving to search results
    */
   async search(query, options = {}) {
     try {
@@ -137,6 +152,9 @@ var Valyu = class {
       if (options.includedSources !== void 0) {
         payload.included_sources = options.includedSources;
       }
+      if (options.excludeSources !== void 0) {
+        payload.exclude_sources = options.excludeSources;
+      }
       if (options.category !== void 0) {
         payload.category = options.category;
       }
@@ -146,6 +164,12 @@ var Valyu = class {
       if (options.endDate !== void 0) {
         payload.end_date = options.endDate;
       }
+      if (options.countryCode !== void 0) {
+        payload.country_code = options.countryCode;
+      }
+      if (options.responseLength !== void 0) {
+        payload.response_length = options.responseLength;
+      }
       const response = await import_axios.default.post(
         `${this.baseUrl}/deepsearch`,
         payload,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, SearchOptions } from './types';\n\nexport class Valyu {\n  private baseUrl: string;\n  private headers: Record<string, string>;\n\n  constructor(apiKey?: string, baseUrl: string = \"https://api.valyu.network/v1\") {\n    if (!apiKey) {\n      apiKey = process.env.VALYU_API_KEY;\n      if (!apiKey) {\n        throw new Error(\"VALYU_API_KEY is not set\");\n      }\n    }\n    this.baseUrl = baseUrl;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey\n    };\n  }\n\n  /**\n   * Validates date format (YYYY-MM-DD)\n   */\n  private validateDateFormat(date: string): boolean {\n    const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n    if (!dateRegex.test(date)) {\n      return false;\n    }\n    const parsedDate = new Date(date);\n    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());\n  }\n\n  /**\n   * Search for information using the Valyu API v2\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n    try {\n      // Default values for v2 API\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultIsToolCall = true;\n      const defaultRelevanceThreshold = 0.5;\n      const defaultMaxPrice = 30;\n\n      // Validate searchType\n      let finalSearchType: SearchType = defaultSearchType;\n      const providedSearchTypeString = options.searchType?.toLowerCase();\n\n      if (providedSearchTypeString === \"web\" || providedSearchTypeString === \"proprietary\" || providedSearchTypeString === \"all\") {\n        finalSearchType = providedSearchTypeString as SearchType;\n      } else if (options.searchType !== undefined) {\n        return {\n          success: false,\n          error: \"Invalid searchType provided. Must be one of: all, web, proprietary\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate date formats\n      if (options.startDate && !this.validateDateFormat(options.startDate)) {\n        return {\n          success: false,\n          error: \"Invalid startDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      if (options.endDate && !this.validateDateFormat(options.endDate)) {\n        return {\n          success: false,\n          error: \"Invalid endDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate maxNumResults range\n      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;\n      if (maxNumResults < 1 || maxNumResults > 20) {\n        return {\n          success: false,\n          error: \"maxNumResults must be between 1 and 20\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: maxNumResults,\n        is_tool_call: options.isToolCall ?? defaultIsToolCall,\n        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      // Add optional parameters only if provided\n      if (options.includedSources !== undefined) {\n        payload.included_sources = options.includedSources;\n      }\n\n      if (options.category !== undefined) {\n        payload.category = options.category;\n      }\n\n      if (options.startDate !== undefined) {\n        payload.start_date = options.startDate;\n      }\n\n      if (options.endDate !== undefined) {\n        payload.end_date = options.endDate;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/deepsearch`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error,\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        tx_id: null,\n        query,\n        results: [],\n        results_by_source: { web: 0, proprietary: 0 },\n        total_deduction_pcm: 0.0,\n        total_deduction_dollars: 0.0,\n        total_characters: 0\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse,\n  SearchOptions\n} from './types'; "],"mappings":"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","names":["axios"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, SearchOptions } from './types';\n\nexport class Valyu {\n  private baseUrl: string;\n  private headers: Record<string, string>;\n\n  constructor(apiKey?: string, baseUrl: string = \"https://api.valyu.network/v1\") {\n    if (!apiKey) {\n      apiKey = process.env.VALYU_API_KEY;\n      if (!apiKey) {\n        throw new Error(\"VALYU_API_KEY is not set\");\n      }\n    }\n    this.baseUrl = baseUrl;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey\n    };\n  }\n\n  /**\n   * Validates date format (YYYY-MM-DD)\n   */\n  private validateDateFormat(date: string): boolean {\n    const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n    if (!dateRegex.test(date)) {\n      return false;\n    }\n    const parsedDate = new Date(date);\n    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());\n  }\n\n  /**\n   * Search for information using the Valyu DeepSearch API\n   * @param query - The search query string\n   * @param options - Search configuration options\n   * @param options.searchType - Type of search: \"web\", \"proprietary\", or \"all\"\n   * @param options.maxNumResults - Maximum number of results (1-20)\n   * @param options.maxPrice - Maximum price per thousand characters (CPM)\n   * @param options.isToolCall - Whether this is a tool call\n   * @param options.relevanceThreshold - Minimum relevance score (0-1)\n   * @param options.includedSources - List of specific sources to include\n   * @param options.excludeSources - List of URLs/domains to exclude from search results\n   * @param options.category - Category filter for search results\n   * @param options.startDate - Start date filter (YYYY-MM-DD format)\n   * @param options.endDate - End date filter (YYYY-MM-DD format)\n   * @param options.countryCode - Country code filter for search results\n   * @param options.responseLength - Response content length: \"short\"/\"medium\"/\"large\"/\"max\" or integer character count\n   * @returns Promise resolving to search results\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n    try {\n      // Default values\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultIsToolCall = true;\n      const defaultRelevanceThreshold = 0.5;\n      const defaultMaxPrice = 30;\n\n      // Validate searchType\n      let finalSearchType: SearchType = defaultSearchType;\n      const providedSearchTypeString = options.searchType?.toLowerCase();\n\n      if (providedSearchTypeString === \"web\" || providedSearchTypeString === \"proprietary\" || providedSearchTypeString === \"all\") {\n        finalSearchType = providedSearchTypeString as SearchType;\n      } else if (options.searchType !== undefined) {\n        return {\n          success: false,\n          error: \"Invalid searchType provided. Must be one of: all, web, proprietary\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate date formats\n      if (options.startDate && !this.validateDateFormat(options.startDate)) {\n        return {\n          success: false,\n          error: \"Invalid startDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      if (options.endDate && !this.validateDateFormat(options.endDate)) {\n        return {\n          success: false,\n          error: \"Invalid endDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate maxNumResults range\n      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;\n      if (maxNumResults < 1 || maxNumResults > 20) {\n        return {\n          success: false,\n          error: \"maxNumResults must be between 1 and 20\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: maxNumResults,\n        is_tool_call: options.isToolCall ?? defaultIsToolCall,\n        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      // Add optional parameters only if provided\n      if (options.includedSources !== undefined) {\n        payload.included_sources = options.includedSources;\n      }\n\n      if (options.excludeSources !== undefined) {\n        payload.exclude_sources = options.excludeSources;\n      }\n\n      if (options.category !== undefined) {\n        payload.category = options.category;\n      }\n\n      if (options.startDate !== undefined) {\n        payload.start_date = options.startDate;\n      }\n\n      if (options.endDate !== undefined) {\n        payload.end_date = options.endDate;\n      }\n\n      if (options.countryCode !== undefined) {\n        payload.country_code = options.countryCode;\n      }\n\n      if (options.responseLength !== undefined) {\n        payload.response_length = options.responseLength;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/deepsearch`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error,\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        tx_id: null,\n        query,\n        results: [],\n        results_by_source: { web: 0, proprietary: 0 },\n        total_deduction_pcm: 0.0,\n        total_deduction_dollars: 0.0,\n        total_characters: 0\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse,\n  SearchOptions,\n  CountryCode,\n  ResponseLength\n} from './types'; "],"mappings":"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","names":["axios"]}

package/dist/index.mjs

@@ -26,7 +26,22 @@ var Valyu = class {
     return parsedDate instanceof Date && !isNaN(parsedDate.getTime());
   }
   /**
-   * Search for information using the Valyu API v2
+   * Search for information using the Valyu DeepSearch API
+   * @param query - The search query string
+   * @param options - Search configuration options
+   * @param options.searchType - Type of search: "web", "proprietary", or "all"
+   * @param options.maxNumResults - Maximum number of results (1-20)
+   * @param options.maxPrice - Maximum price per thousand characters (CPM)
+   * @param options.isToolCall - Whether this is a tool call
+   * @param options.relevanceThreshold - Minimum relevance score (0-1)
+   * @param options.includedSources - List of specific sources to include
+   * @param options.excludeSources - List of URLs/domains to exclude from search results
+   * @param options.category - Category filter for search results
+   * @param options.startDate - Start date filter (YYYY-MM-DD format)
+   * @param options.endDate - End date filter (YYYY-MM-DD format)
+   * @param options.countryCode - Country code filter for search results
+   * @param options.responseLength - Response content length: "short"/"medium"/"large"/"max" or integer character count
+   * @returns Promise resolving to search results
    */
   async search(query, options = {}) {
     try {
@@ -103,6 +118,9 @@ var Valyu = class {
       if (options.includedSources !== void 0) {
         payload.included_sources = options.includedSources;
       }
+      if (options.excludeSources !== void 0) {
+        payload.exclude_sources = options.excludeSources;
+      }
       if (options.category !== void 0) {
         payload.category = options.category;
       }
@@ -112,6 +130,12 @@ var Valyu = class {
       if (options.endDate !== void 0) {
         payload.end_date = options.endDate;
       }
+      if (options.countryCode !== void 0) {
+        payload.country_code = options.countryCode;
+      }
+      if (options.responseLength !== void 0) {
+        payload.response_length = options.responseLength;
+      }
       const response = await axios.post(
         `${this.baseUrl}/deepsearch`,
         payload,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, SearchOptions } from './types';\n\nexport class Valyu {\n  private baseUrl: string;\n  private headers: Record<string, string>;\n\n  constructor(apiKey?: string, baseUrl: string = \"https://api.valyu.network/v1\") {\n    if (!apiKey) {\n      apiKey = process.env.VALYU_API_KEY;\n      if (!apiKey) {\n        throw new Error(\"VALYU_API_KEY is not set\");\n      }\n    }\n    this.baseUrl = baseUrl;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey\n    };\n  }\n\n  /**\n   * Validates date format (YYYY-MM-DD)\n   */\n  private validateDateFormat(date: string): boolean {\n    const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n    if (!dateRegex.test(date)) {\n      return false;\n    }\n    const parsedDate = new Date(date);\n    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());\n  }\n\n  /**\n   * Search for information using the Valyu API v2\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n    try {\n      // Default values for v2 API\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultIsToolCall = true;\n      const defaultRelevanceThreshold = 0.5;\n      const defaultMaxPrice = 30;\n\n      // Validate searchType\n      let finalSearchType: SearchType = defaultSearchType;\n      const providedSearchTypeString = options.searchType?.toLowerCase();\n\n      if (providedSearchTypeString === \"web\" || providedSearchTypeString === \"proprietary\" || providedSearchTypeString === \"all\") {\n        finalSearchType = providedSearchTypeString as SearchType;\n      } else if (options.searchType !== undefined) {\n        return {\n          success: false,\n          error: \"Invalid searchType provided. Must be one of: all, web, proprietary\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate date formats\n      if (options.startDate && !this.validateDateFormat(options.startDate)) {\n        return {\n          success: false,\n          error: \"Invalid startDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      if (options.endDate && !this.validateDateFormat(options.endDate)) {\n        return {\n          success: false,\n          error: \"Invalid endDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate maxNumResults range\n      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;\n      if (maxNumResults < 1 || maxNumResults > 20) {\n        return {\n          success: false,\n          error: \"maxNumResults must be between 1 and 20\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: maxNumResults,\n        is_tool_call: options.isToolCall ?? defaultIsToolCall,\n        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      // Add optional parameters only if provided\n      if (options.includedSources !== undefined) {\n        payload.included_sources = options.includedSources;\n      }\n\n      if (options.category !== undefined) {\n        payload.category = options.category;\n      }\n\n      if (options.startDate !== undefined) {\n        payload.start_date = options.startDate;\n      }\n\n      if (options.endDate !== undefined) {\n        payload.end_date = options.endDate;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/deepsearch`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error,\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        tx_id: null,\n        query,\n        results: [],\n        results_by_source: { web: 0, proprietary: 0 },\n        total_deduction_pcm: 0.0,\n        total_deduction_dollars: 0.0,\n        total_characters: 0\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse,\n  SearchOptions\n} from './types'; "],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import axios from 'axios';\nimport { SearchResponse, SearchType, SearchOptions } from './types';\n\nexport class Valyu {\n  private baseUrl: string;\n  private headers: Record<string, string>;\n\n  constructor(apiKey?: string, baseUrl: string = \"https://api.valyu.network/v1\") {\n    if (!apiKey) {\n      apiKey = process.env.VALYU_API_KEY;\n      if (!apiKey) {\n        throw new Error(\"VALYU_API_KEY is not set\");\n      }\n    }\n    this.baseUrl = baseUrl;\n    this.headers = {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey\n    };\n  }\n\n  /**\n   * Validates date format (YYYY-MM-DD)\n   */\n  private validateDateFormat(date: string): boolean {\n    const dateRegex = /^\\d{4}-\\d{2}-\\d{2}$/;\n    if (!dateRegex.test(date)) {\n      return false;\n    }\n    const parsedDate = new Date(date);\n    return parsedDate instanceof Date && !isNaN(parsedDate.getTime());\n  }\n\n  /**\n   * Search for information using the Valyu DeepSearch API\n   * @param query - The search query string\n   * @param options - Search configuration options\n   * @param options.searchType - Type of search: \"web\", \"proprietary\", or \"all\"\n   * @param options.maxNumResults - Maximum number of results (1-20)\n   * @param options.maxPrice - Maximum price per thousand characters (CPM)\n   * @param options.isToolCall - Whether this is a tool call\n   * @param options.relevanceThreshold - Minimum relevance score (0-1)\n   * @param options.includedSources - List of specific sources to include\n   * @param options.excludeSources - List of URLs/domains to exclude from search results\n   * @param options.category - Category filter for search results\n   * @param options.startDate - Start date filter (YYYY-MM-DD format)\n   * @param options.endDate - End date filter (YYYY-MM-DD format)\n   * @param options.countryCode - Country code filter for search results\n   * @param options.responseLength - Response content length: \"short\"/\"medium\"/\"large\"/\"max\" or integer character count\n   * @returns Promise resolving to search results\n   */\n  async search(query: string, options: SearchOptions = {}): Promise<SearchResponse> {\n    try {\n      // Default values\n      const defaultSearchType: SearchType = \"all\";\n      const defaultMaxNumResults = 10;\n      const defaultIsToolCall = true;\n      const defaultRelevanceThreshold = 0.5;\n      const defaultMaxPrice = 30;\n\n      // Validate searchType\n      let finalSearchType: SearchType = defaultSearchType;\n      const providedSearchTypeString = options.searchType?.toLowerCase();\n\n      if (providedSearchTypeString === \"web\" || providedSearchTypeString === \"proprietary\" || providedSearchTypeString === \"all\") {\n        finalSearchType = providedSearchTypeString as SearchType;\n      } else if (options.searchType !== undefined) {\n        return {\n          success: false,\n          error: \"Invalid searchType provided. Must be one of: all, web, proprietary\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate date formats\n      if (options.startDate && !this.validateDateFormat(options.startDate)) {\n        return {\n          success: false,\n          error: \"Invalid startDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      if (options.endDate && !this.validateDateFormat(options.endDate)) {\n        return {\n          success: false,\n          error: \"Invalid endDate format. Must be YYYY-MM-DD\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Validate maxNumResults range\n      const maxNumResults = options.maxNumResults ?? defaultMaxNumResults;\n      if (maxNumResults < 1 || maxNumResults > 20) {\n        return {\n          success: false,\n          error: \"maxNumResults must be between 1 and 20\",\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      // Build payload with snake_case for API\n      const payload: Record<string, any> = {\n        query,\n        search_type: finalSearchType,\n        max_num_results: maxNumResults,\n        is_tool_call: options.isToolCall ?? defaultIsToolCall,\n        relevance_threshold: options.relevanceThreshold ?? defaultRelevanceThreshold,\n        max_price: options.maxPrice ?? defaultMaxPrice,\n      };\n\n      // Add optional parameters only if provided\n      if (options.includedSources !== undefined) {\n        payload.included_sources = options.includedSources;\n      }\n\n      if (options.excludeSources !== undefined) {\n        payload.exclude_sources = options.excludeSources;\n      }\n\n      if (options.category !== undefined) {\n        payload.category = options.category;\n      }\n\n      if (options.startDate !== undefined) {\n        payload.start_date = options.startDate;\n      }\n\n      if (options.endDate !== undefined) {\n        payload.end_date = options.endDate;\n      }\n\n      if (options.countryCode !== undefined) {\n        payload.country_code = options.countryCode;\n      }\n\n      if (options.responseLength !== undefined) {\n        payload.response_length = options.responseLength;\n      }\n\n      const response = await axios.post(\n        `${this.baseUrl}/deepsearch`,\n        payload,\n        { headers: this.headers }\n      );\n\n      if (!response.status || response.status < 200 || response.status >= 300) {\n        return {\n          success: false,\n          error: response.data?.error,\n          tx_id: null,\n          query,\n          results: [],\n          results_by_source: { web: 0, proprietary: 0 },\n          total_deduction_pcm: 0.0,\n          total_deduction_dollars: 0.0,\n          total_characters: 0\n        };\n      }\n\n      return response.data;\n    } catch (e: any) {\n      return {\n        success: false,\n        error: e.response?.data?.error || e.message,\n        tx_id: null,\n        query,\n        results: [],\n        results_by_source: { web: 0, proprietary: 0 },\n        total_deduction_pcm: 0.0,\n        total_deduction_dollars: 0.0,\n        total_characters: 0\n      };\n    }\n  }\n}\n\nexport type { \n  SearchResponse, \n  SearchType, \n  FeedbackSentiment, \n  FeedbackResponse,\n  SearchOptions,\n  CountryCode,\n  ResponseLength\n} from './types'; "],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "valyu-js",
-    "version": "2.0.0",
+    "version": "2.0.2",
     "description": "DeepSearch API for AI.",
     "files": [
         "dist"