reportify-sdk 0.3.13 → 0.3.15

package/dist/index.d.mts

@@ -1409,7 +1409,7 @@ declare class UserModule {
      * Unfollow a company (remove from stock watchlist)
      *
      * @param symbol - Stock symbol in market:ticker format (e.g., US:AAPL, HK:00700)
-     * @returns Status of the unfollow operation
+     * @returns Status of unfollow operation
      *
      * @example
      * ```typescript
@@ -1421,6 +1421,171 @@ declare class UserModule {
         symbol: string;
         success: boolean;
     }>;
+    /**
+     * Create a new follow group
+     *
+     * @param name - Group name
+     * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+     *                      follow_type: 1=company, 3=channel
+     * @returns Created group information including group_id, name, and count
+     *
+     * @example
+     * ```typescript
+     * const result = await client.user.createFollowGroup('My Stocks', [
+     *   { follow_type: 1, follow_value: 'US:AAPL' },
+     *   { follow_type: 1, follow_value: 'HK:00700' }
+     * ]);
+     * console.log(`Created group: ${result.group_id}`);
+     * ```
+     */
+    createFollowGroup(name: string, followValues?: Array<{
+        follow_type: number;
+        follow_value: string;
+    }>): Promise<{
+        group_id: string;
+        name: string;
+        count: number;
+    }>;
+    /**
+     * Get all follow groups for authenticated user
+     *
+     * @returns List of follow groups with group_id, name, and count
+     *
+     * @example
+     * ```typescript
+     * const groups = await client.user.getFollowGroups();
+     * groups.forEach(group => {
+     *   console.log(`${group.name}: ${group.count} items`);
+     * });
+     * ```
+     */
+    getFollowGroups(): Promise<Array<{
+        group_id: string;
+        name: string;
+        count: number;
+    }>>;
+    /**
+     * Get a follow group by ID
+     *
+     * @param groupId - Group ID
+     * @returns Group information including group_id, name, and count
+     *
+     * @example
+     * ```typescript
+     * const group = await client.user.getFollowGroup('group_123');
+     * console.log(`${group.name}: ${group.count} items`);
+     * ```
+     */
+    getFollowGroup(groupId: string): Promise<{
+        group_id: string;
+        name: string;
+        count: number;
+    }>;
+    /**
+     * Update a follow group
+     *
+     * @param groupId - Group ID
+     * @param name - New group name
+     * @returns Updated group information
+     *
+     * @example
+     * ```typescript
+     * const result = await client.user.updateFollowGroup('group_123', 'New Name');
+     * console.log(`Updated: ${result.name}`);
+     * ```
+     */
+    updateFollowGroup(groupId: string, name?: string): Promise<{
+        group_id: string;
+        name: string;
+        count: number;
+    }>;
+    /**
+     * Delete a follow group
+     *
+     * @param groupId - Group ID
+     * @returns Status message
+     *
+     * @example
+     * ```typescript
+     * await client.user.deleteFollowGroup('group_123');
+     * ```
+     */
+    deleteFollowGroup(groupId: string): Promise<void>;
+    /**
+     * Add follows to a group
+     *
+     * @param groupId - Group ID
+     * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+     *                      follow_type: 1=company, 3=channel
+     * @returns Status message
+     *
+     * @example
+     * ```typescript
+     * await client.user.addFollowsToGroup('group_123', [
+     *   { follow_type: 1, follow_value: 'US:TSLA' }
+     * ]);
+     * ```
+     */
+    addFollowsToGroup(groupId: string, followValues: Array<{
+        follow_type: number;
+        follow_value: string;
+    }>): Promise<void>;
+    /**
+     * Remove follows from a group
+     *
+     * @param groupId - Group ID
+     * @param followIds - List of follow IDs to remove
+     * @returns Status message
+     *
+     * @example
+     * ```typescript
+     * await client.user.removeFollowsFromGroup('group_123', ['follow_1', 'follow_2']);
+     * ```
+     */
+    removeFollowsFromGroup(groupId: string, followIds: string[]): Promise<void>;
+    /**
+     * Set follows for a group (replace all existing follows)
+     *
+     * @param groupId - Group ID
+     * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+     *                      follow_type: 1=company, 3=channel
+     * @returns Status message
+     *
+     * @example
+     * ```typescript
+     * await client.user.setGroupFollows('group_123', [
+     *   { follow_type: 1, follow_value: 'US:AAPL' },
+     *   { follow_type: 1, follow_value: 'HK:00700' }
+     * ]);
+     * ```
+     */
+    setGroupFollows(groupId: string, followValues: Array<{
+        follow_type: number;
+        follow_value: string;
+    }>): Promise<void>;
+    /**
+     * Get reports for a follow group
+     *
+     * @param groupId - Group ID
+     * @param pageNum - Page number (default: 1)
+     * @param pageSize - Page size (default: 10, max: 100)
+     * @returns Report data including items list, total_count, page_num, and page_size
+     *
+     * @example
+     * ```typescript
+     * const result = await client.user.getGroupReports('group_123', 1, 20);
+     * console.log(`Total: ${result.total_count}`);
+     * result.items.forEach(report => {
+     *   console.log(report.title || 'Untitled');
+     * });
+     * ```
+     */
+    getGroupReports(groupId: string, pageNum?: number, pageSize?: number): Promise<{
+        items: any[];
+        total_count: number;
+        page_num: number;
+        page_size: number;
+    }>;
 }
 
 /**
@@ -1499,6 +1664,34 @@ declare class SearchModule {
      * Search webpage content
      */
     webpages(query: string, options?: Omit<SearchOptions, 'symbols' | 'categories' | 'industries' | 'channelIds'>): Promise<Document[]>;
+    /**
+     * Crawl web content from given URLs.
+     *
+     * @param urls Array of URLs to get contents for
+     * @param options Options for text, highlights, summary, subpages, etc.
+     * @returns CrawlResponse Promise with extracted results and statuses
+     */
+    crawl(urls: string[], options?: {
+        text?: boolean | {
+            maxCharacters?: number;
+            includeHtmlTags?: boolean;
+            verbosity?: 'compact' | 'full';
+        };
+        highlights?: {
+            query?: string;
+            maxCharacters?: number;
+            numSentences?: number;
+            highlightsPerUrl?: number;
+        };
+        summary?: {
+            query?: string;
+            schema?: Record<string, unknown>;
+        };
+        subpages?: number;
+        subpageTarget?: string[];
+        maxAgeHours?: number;
+        livecrawlTimeout?: number;
+    }): Promise<any>;
 }
 
 /**
@@ -1556,6 +1749,10 @@ declare class Reportify {
      * Make a DELETE request
      */
     delete<T = unknown>(path: string, body?: Record<string, unknown>): Promise<T>;
+    /**
+     * Make a PUT request
+     */
+    put<T = unknown>(path: string, body?: Record<string, unknown>): Promise<T>;
     /**
      * Make a GET request and return raw bytes (for file downloads)
      */

package/dist/index.d.ts

@@ -1409,7 +1409,7 @@ declare class UserModule {
      * Unfollow a company (remove from stock watchlist)
      *
      * @param symbol - Stock symbol in market:ticker format (e.g., US:AAPL, HK:00700)
-     * @returns Status of the unfollow operation
+     * @returns Status of unfollow operation
      *
      * @example
      * ```typescript
@@ -1421,6 +1421,171 @@ declare class UserModule {
         symbol: string;
         success: boolean;
     }>;
+    /**
+     * Create a new follow group
+     *
+     * @param name - Group name
+     * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+     *                      follow_type: 1=company, 3=channel
+     * @returns Created group information including group_id, name, and count
+     *
+     * @example
+     * ```typescript
+     * const result = await client.user.createFollowGroup('My Stocks', [
+     *   { follow_type: 1, follow_value: 'US:AAPL' },
+     *   { follow_type: 1, follow_value: 'HK:00700' }
+     * ]);
+     * console.log(`Created group: ${result.group_id}`);
+     * ```
+     */
+    createFollowGroup(name: string, followValues?: Array<{
+        follow_type: number;
+        follow_value: string;
+    }>): Promise<{
+        group_id: string;
+        name: string;
+        count: number;
+    }>;
+    /**
+     * Get all follow groups for authenticated user
+     *
+     * @returns List of follow groups with group_id, name, and count
+     *
+     * @example
+     * ```typescript
+     * const groups = await client.user.getFollowGroups();
+     * groups.forEach(group => {
+     *   console.log(`${group.name}: ${group.count} items`);
+     * });
+     * ```
+     */
+    getFollowGroups(): Promise<Array<{
+        group_id: string;
+        name: string;
+        count: number;
+    }>>;
+    /**
+     * Get a follow group by ID
+     *
+     * @param groupId - Group ID
+     * @returns Group information including group_id, name, and count
+     *
+     * @example
+     * ```typescript
+     * const group = await client.user.getFollowGroup('group_123');
+     * console.log(`${group.name}: ${group.count} items`);
+     * ```
+     */
+    getFollowGroup(groupId: string): Promise<{
+        group_id: string;
+        name: string;
+        count: number;
+    }>;
+    /**
+     * Update a follow group
+     *
+     * @param groupId - Group ID
+     * @param name - New group name
+     * @returns Updated group information
+     *
+     * @example
+     * ```typescript
+     * const result = await client.user.updateFollowGroup('group_123', 'New Name');
+     * console.log(`Updated: ${result.name}`);
+     * ```
+     */
+    updateFollowGroup(groupId: string, name?: string): Promise<{
+        group_id: string;
+        name: string;
+        count: number;
+    }>;
+    /**
+     * Delete a follow group
+     *
+     * @param groupId - Group ID
+     * @returns Status message
+     *
+     * @example
+     * ```typescript
+     * await client.user.deleteFollowGroup('group_123');
+     * ```
+     */
+    deleteFollowGroup(groupId: string): Promise<void>;
+    /**
+     * Add follows to a group
+     *
+     * @param groupId - Group ID
+     * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+     *                      follow_type: 1=company, 3=channel
+     * @returns Status message
+     *
+     * @example
+     * ```typescript
+     * await client.user.addFollowsToGroup('group_123', [
+     *   { follow_type: 1, follow_value: 'US:TSLA' }
+     * ]);
+     * ```
+     */
+    addFollowsToGroup(groupId: string, followValues: Array<{
+        follow_type: number;
+        follow_value: string;
+    }>): Promise<void>;
+    /**
+     * Remove follows from a group
+     *
+     * @param groupId - Group ID
+     * @param followIds - List of follow IDs to remove
+     * @returns Status message
+     *
+     * @example
+     * ```typescript
+     * await client.user.removeFollowsFromGroup('group_123', ['follow_1', 'follow_2']);
+     * ```
+     */
+    removeFollowsFromGroup(groupId: string, followIds: string[]): Promise<void>;
+    /**
+     * Set follows for a group (replace all existing follows)
+     *
+     * @param groupId - Group ID
+     * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+     *                      follow_type: 1=company, 3=channel
+     * @returns Status message
+     *
+     * @example
+     * ```typescript
+     * await client.user.setGroupFollows('group_123', [
+     *   { follow_type: 1, follow_value: 'US:AAPL' },
+     *   { follow_type: 1, follow_value: 'HK:00700' }
+     * ]);
+     * ```
+     */
+    setGroupFollows(groupId: string, followValues: Array<{
+        follow_type: number;
+        follow_value: string;
+    }>): Promise<void>;
+    /**
+     * Get reports for a follow group
+     *
+     * @param groupId - Group ID
+     * @param pageNum - Page number (default: 1)
+     * @param pageSize - Page size (default: 10, max: 100)
+     * @returns Report data including items list, total_count, page_num, and page_size
+     *
+     * @example
+     * ```typescript
+     * const result = await client.user.getGroupReports('group_123', 1, 20);
+     * console.log(`Total: ${result.total_count}`);
+     * result.items.forEach(report => {
+     *   console.log(report.title || 'Untitled');
+     * });
+     * ```
+     */
+    getGroupReports(groupId: string, pageNum?: number, pageSize?: number): Promise<{
+        items: any[];
+        total_count: number;
+        page_num: number;
+        page_size: number;
+    }>;
 }
 
 /**
@@ -1499,6 +1664,34 @@ declare class SearchModule {
      * Search webpage content
      */
     webpages(query: string, options?: Omit<SearchOptions, 'symbols' | 'categories' | 'industries' | 'channelIds'>): Promise<Document[]>;
+    /**
+     * Crawl web content from given URLs.
+     *
+     * @param urls Array of URLs to get contents for
+     * @param options Options for text, highlights, summary, subpages, etc.
+     * @returns CrawlResponse Promise with extracted results and statuses
+     */
+    crawl(urls: string[], options?: {
+        text?: boolean | {
+            maxCharacters?: number;
+            includeHtmlTags?: boolean;
+            verbosity?: 'compact' | 'full';
+        };
+        highlights?: {
+            query?: string;
+            maxCharacters?: number;
+            numSentences?: number;
+            highlightsPerUrl?: number;
+        };
+        summary?: {
+            query?: string;
+            schema?: Record<string, unknown>;
+        };
+        subpages?: number;
+        subpageTarget?: string[];
+        maxAgeHours?: number;
+        livecrawlTimeout?: number;
+    }): Promise<any>;
 }
 
 /**
@@ -1556,6 +1749,10 @@ declare class Reportify {
      * Make a DELETE request
      */
     delete<T = unknown>(path: string, body?: Record<string, unknown>): Promise<T>;
+    /**
+     * Make a PUT request
+     */
+    put<T = unknown>(path: string, body?: Record<string, unknown>): Promise<T>;
     /**
      * Make a GET request and return raw bytes (for file downloads)
      */

package/dist/index.js

@@ -1446,7 +1446,7 @@ var UserModule = class {
    * Unfollow a company (remove from stock watchlist)
    *
    * @param symbol - Stock symbol in market:ticker format (e.g., US:AAPL, HK:00700)
-   * @returns Status of the unfollow operation
+   * @returns Status of unfollow operation
    *
    * @example
    * ```typescript
@@ -1460,6 +1460,186 @@ var UserModule = class {
       { symbol }
     );
   }
+  /**
+   * Create a new follow group
+   *
+   * @param name - Group name
+   * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+   *                      follow_type: 1=company, 3=channel
+   * @returns Created group information including group_id, name, and count
+   *
+   * @example
+   * ```typescript
+   * const result = await client.user.createFollowGroup('My Stocks', [
+   *   { follow_type: 1, follow_value: 'US:AAPL' },
+   *   { follow_type: 1, follow_value: 'HK:00700' }
+   * ]);
+   * console.log(`Created group: ${result.group_id}`);
+   * ```
+   */
+  async createFollowGroup(name, followValues) {
+    const json = { name };
+    if (followValues !== void 0) {
+      json.follow_values = followValues;
+    }
+    return this.client.post(
+      "/v1/tools/user/follow-groups",
+      json
+    );
+  }
+  /**
+   * Get all follow groups for authenticated user
+   *
+   * @returns List of follow groups with group_id, name, and count
+   *
+   * @example
+   * ```typescript
+   * const groups = await client.user.getFollowGroups();
+   * groups.forEach(group => {
+   *   console.log(`${group.name}: ${group.count} items`);
+   * });
+   * ```
+   */
+  async getFollowGroups() {
+    const response = await this.client.get("/v1/tools/user/follow-groups");
+    return response.groups || [];
+  }
+  /**
+   * Get a follow group by ID
+   *
+   * @param groupId - Group ID
+   * @returns Group information including group_id, name, and count
+   *
+   * @example
+   * ```typescript
+   * const group = await client.user.getFollowGroup('group_123');
+   * console.log(`${group.name}: ${group.count} items`);
+   * ```
+   */
+  async getFollowGroup(groupId) {
+    return this.client.get(
+      `/v1/tools/user/follow-groups/${groupId}`
+    );
+  }
+  /**
+   * Update a follow group
+   *
+   * @param groupId - Group ID
+   * @param name - New group name
+   * @returns Updated group information
+   *
+   * @example
+   * ```typescript
+   * const result = await client.user.updateFollowGroup('group_123', 'New Name');
+   * console.log(`Updated: ${result.name}`);
+   * ```
+   */
+  async updateFollowGroup(groupId, name) {
+    const json = {};
+    if (name !== void 0) {
+      json.name = name;
+    }
+    return this.client.post(
+      `/v1/tools/user/follow-groups/${groupId}`,
+      json
+    );
+  }
+  /**
+   * Delete a follow group
+   *
+   * @param groupId - Group ID
+   * @returns Status message
+   *
+   * @example
+   * ```typescript
+   * await client.user.deleteFollowGroup('group_123');
+   * ```
+   */
+  async deleteFollowGroup(groupId) {
+    return this.client.delete(`/v1/tools/user/follow-groups/${groupId}`);
+  }
+  /**
+   * Add follows to a group
+   *
+   * @param groupId - Group ID
+   * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+   *                      follow_type: 1=company, 3=channel
+   * @returns Status message
+   *
+   * @example
+   * ```typescript
+   * await client.user.addFollowsToGroup('group_123', [
+   *   { follow_type: 1, follow_value: 'US:TSLA' }
+   * ]);
+   * ```
+   */
+  async addFollowsToGroup(groupId, followValues) {
+    return this.client.post(`/v1/tools/user/follow-groups/${groupId}/follows`, {
+      follow_values: followValues
+    });
+  }
+  /**
+   * Remove follows from a group
+   *
+   * @param groupId - Group ID
+   * @param followIds - List of follow IDs to remove
+   * @returns Status message
+   *
+   * @example
+   * ```typescript
+   * await client.user.removeFollowsFromGroup('group_123', ['follow_1', 'follow_2']);
+   * ```
+   */
+  async removeFollowsFromGroup(groupId, followIds) {
+    return this.client.delete(
+      `/v1/tools/user/follow-groups/${groupId}/follows`,
+      { follow_ids: followIds }
+    );
+  }
+  /**
+   * Set follows for a group (replace all existing follows)
+   *
+   * @param groupId - Group ID
+   * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+   *                      follow_type: 1=company, 3=channel
+   * @returns Status message
+   *
+   * @example
+   * ```typescript
+   * await client.user.setGroupFollows('group_123', [
+   *   { follow_type: 1, follow_value: 'US:AAPL' },
+   *   { follow_type: 1, follow_value: 'HK:00700' }
+   * ]);
+   * ```
+   */
+  async setGroupFollows(groupId, followValues) {
+    return this.client.put(`/v1/tools/user/follow-groups/${groupId}/follows`, {
+      follow_values: followValues
+    });
+  }
+  /**
+   * Get reports for a follow group
+   *
+   * @param groupId - Group ID
+   * @param pageNum - Page number (default: 1)
+   * @param pageSize - Page size (default: 10, max: 100)
+   * @returns Report data including items list, total_count, page_num, and page_size
+   *
+   * @example
+   * ```typescript
+   * const result = await client.user.getGroupReports('group_123', 1, 20);
+   * console.log(`Total: ${result.total_count}`);
+   * result.items.forEach(report => {
+   *   console.log(report.title || 'Untitled');
+   * });
+   * ```
+   */
+  async getGroupReports(groupId, pageNum = 1, pageSize = 10) {
+    return this.client.get(`/v1/tools/user/follow-groups/${groupId}/reports`, {
+      page_num: pageNum,
+      page_size: pageSize
+    });
+  }
 };
 
 // src/search.ts
@@ -1623,6 +1803,24 @@ var SearchModule = class {
     const response = await this.client.post("/v2/search/webpages", body);
     return response.docs || [];
   }
+  /**
+   * Crawl web content from given URLs.
+   *
+   * @param urls Array of URLs to get contents for
+   * @param options Options for text, highlights, summary, subpages, etc.
+   * @returns CrawlResponse Promise with extracted results and statuses
+   */
+  async crawl(urls, options) {
+    const data = { ids: urls };
+    if (options?.text !== void 0) data.text = options.text;
+    if (options?.highlights !== void 0) data.highlights = options.highlights;
+    if (options?.summary !== void 0) data.summary = options.summary;
+    if (options?.subpages !== void 0) data.subpages = options.subpages;
+    if (options?.subpageTarget !== void 0) data.subpageTarget = options.subpageTarget;
+    if (options?.maxAgeHours !== void 0) data.maxAgeHours = options.maxAgeHours;
+    if (options?.livecrawlTimeout !== void 0) data.livecrawlTimeout = options.livecrawlTimeout;
+    return this.client.post("/v2/search/crawl", data);
+  }
 };
 
 // src/types.ts
@@ -1768,6 +1966,12 @@ var Reportify = class {
   async delete(path, body) {
     return this.request("DELETE", path, { body });
   }
+  /**
+   * Make a PUT request
+   */
+  async put(path, body) {
+    return this.request("PUT", path, { body });
+  }
   /**
    * Make a GET request and return raw bytes (for file downloads)
    */

package/dist/index.mjs

@@ -1404,7 +1404,7 @@ var UserModule = class {
    * Unfollow a company (remove from stock watchlist)
    *
    * @param symbol - Stock symbol in market:ticker format (e.g., US:AAPL, HK:00700)
-   * @returns Status of the unfollow operation
+   * @returns Status of unfollow operation
    *
    * @example
    * ```typescript
@@ -1418,6 +1418,186 @@ var UserModule = class {
       { symbol }
     );
   }
+  /**
+   * Create a new follow group
+   *
+   * @param name - Group name
+   * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+   *                      follow_type: 1=company, 3=channel
+   * @returns Created group information including group_id, name, and count
+   *
+   * @example
+   * ```typescript
+   * const result = await client.user.createFollowGroup('My Stocks', [
+   *   { follow_type: 1, follow_value: 'US:AAPL' },
+   *   { follow_type: 1, follow_value: 'HK:00700' }
+   * ]);
+   * console.log(`Created group: ${result.group_id}`);
+   * ```
+   */
+  async createFollowGroup(name, followValues) {
+    const json = { name };
+    if (followValues !== void 0) {
+      json.follow_values = followValues;
+    }
+    return this.client.post(
+      "/v1/tools/user/follow-groups",
+      json
+    );
+  }
+  /**
+   * Get all follow groups for authenticated user
+   *
+   * @returns List of follow groups with group_id, name, and count
+   *
+   * @example
+   * ```typescript
+   * const groups = await client.user.getFollowGroups();
+   * groups.forEach(group => {
+   *   console.log(`${group.name}: ${group.count} items`);
+   * });
+   * ```
+   */
+  async getFollowGroups() {
+    const response = await this.client.get("/v1/tools/user/follow-groups");
+    return response.groups || [];
+  }
+  /**
+   * Get a follow group by ID
+   *
+   * @param groupId - Group ID
+   * @returns Group information including group_id, name, and count
+   *
+   * @example
+   * ```typescript
+   * const group = await client.user.getFollowGroup('group_123');
+   * console.log(`${group.name}: ${group.count} items`);
+   * ```
+   */
+  async getFollowGroup(groupId) {
+    return this.client.get(
+      `/v1/tools/user/follow-groups/${groupId}`
+    );
+  }
+  /**
+   * Update a follow group
+   *
+   * @param groupId - Group ID
+   * @param name - New group name
+   * @returns Updated group information
+   *
+   * @example
+   * ```typescript
+   * const result = await client.user.updateFollowGroup('group_123', 'New Name');
+   * console.log(`Updated: ${result.name}`);
+   * ```
+   */
+  async updateFollowGroup(groupId, name) {
+    const json = {};
+    if (name !== void 0) {
+      json.name = name;
+    }
+    return this.client.post(
+      `/v1/tools/user/follow-groups/${groupId}`,
+      json
+    );
+  }
+  /**
+   * Delete a follow group
+   *
+   * @param groupId - Group ID
+   * @returns Status message
+   *
+   * @example
+   * ```typescript
+   * await client.user.deleteFollowGroup('group_123');
+   * ```
+   */
+  async deleteFollowGroup(groupId) {
+    return this.client.delete(`/v1/tools/user/follow-groups/${groupId}`);
+  }
+  /**
+   * Add follows to a group
+   *
+   * @param groupId - Group ID
+   * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+   *                      follow_type: 1=company, 3=channel
+   * @returns Status message
+   *
+   * @example
+   * ```typescript
+   * await client.user.addFollowsToGroup('group_123', [
+   *   { follow_type: 1, follow_value: 'US:TSLA' }
+   * ]);
+   * ```
+   */
+  async addFollowsToGroup(groupId, followValues) {
+    return this.client.post(`/v1/tools/user/follow-groups/${groupId}/follows`, {
+      follow_values: followValues
+    });
+  }
+  /**
+   * Remove follows from a group
+   *
+   * @param groupId - Group ID
+   * @param followIds - List of follow IDs to remove
+   * @returns Status message
+   *
+   * @example
+   * ```typescript
+   * await client.user.removeFollowsFromGroup('group_123', ['follow_1', 'follow_2']);
+   * ```
+   */
+  async removeFollowsFromGroup(groupId, followIds) {
+    return this.client.delete(
+      `/v1/tools/user/follow-groups/${groupId}/follows`,
+      { follow_ids: followIds }
+    );
+  }
+  /**
+   * Set follows for a group (replace all existing follows)
+   *
+   * @param groupId - Group ID
+   * @param followValues - List of follow values (each with 'follow_type' as int and 'follow_value' as string)
+   *                      follow_type: 1=company, 3=channel
+   * @returns Status message
+   *
+   * @example
+   * ```typescript
+   * await client.user.setGroupFollows('group_123', [
+   *   { follow_type: 1, follow_value: 'US:AAPL' },
+   *   { follow_type: 1, follow_value: 'HK:00700' }
+   * ]);
+   * ```
+   */
+  async setGroupFollows(groupId, followValues) {
+    return this.client.put(`/v1/tools/user/follow-groups/${groupId}/follows`, {
+      follow_values: followValues
+    });
+  }
+  /**
+   * Get reports for a follow group
+   *
+   * @param groupId - Group ID
+   * @param pageNum - Page number (default: 1)
+   * @param pageSize - Page size (default: 10, max: 100)
+   * @returns Report data including items list, total_count, page_num, and page_size
+   *
+   * @example
+   * ```typescript
+   * const result = await client.user.getGroupReports('group_123', 1, 20);
+   * console.log(`Total: ${result.total_count}`);
+   * result.items.forEach(report => {
+   *   console.log(report.title || 'Untitled');
+   * });
+   * ```
+   */
+  async getGroupReports(groupId, pageNum = 1, pageSize = 10) {
+    return this.client.get(`/v1/tools/user/follow-groups/${groupId}/reports`, {
+      page_num: pageNum,
+      page_size: pageSize
+    });
+  }
 };
 
 // src/search.ts
@@ -1581,6 +1761,24 @@ var SearchModule = class {
     const response = await this.client.post("/v2/search/webpages", body);
     return response.docs || [];
   }
+  /**
+   * Crawl web content from given URLs.
+   *
+   * @param urls Array of URLs to get contents for
+   * @param options Options for text, highlights, summary, subpages, etc.
+   * @returns CrawlResponse Promise with extracted results and statuses
+   */
+  async crawl(urls, options) {
+    const data = { ids: urls };
+    if (options?.text !== void 0) data.text = options.text;
+    if (options?.highlights !== void 0) data.highlights = options.highlights;
+    if (options?.summary !== void 0) data.summary = options.summary;
+    if (options?.subpages !== void 0) data.subpages = options.subpages;
+    if (options?.subpageTarget !== void 0) data.subpageTarget = options.subpageTarget;
+    if (options?.maxAgeHours !== void 0) data.maxAgeHours = options.maxAgeHours;
+    if (options?.livecrawlTimeout !== void 0) data.livecrawlTimeout = options.livecrawlTimeout;
+    return this.client.post("/v2/search/crawl", data);
+  }
 };
 
 // src/types.ts
@@ -1726,6 +1924,12 @@ var Reportify = class {
   async delete(path, body) {
     return this.request("DELETE", path, { body });
   }
+  /**
+   * Make a PUT request
+   */
+  async put(path, body) {
+    return this.request("PUT", path, { body });
+  }
   /**
    * Make a GET request and return raw bytes (for file downloads)
    */

package/package.json

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