v2er-insight 1.0.0

package/dist/core/v2ex/urls/constants.d.ts

@@ -0,0 +1,5 @@
+/**
+ * V2EX 基础 URL 配置
+ */
+export declare const V2EX_BASE = "https://www.v2ex.com";
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/v2ex/urls/constants.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * V2EX 基础 URL 配置
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V2EX_BASE = void 0;
+exports.V2EX_BASE = 'https://www.v2ex.com';
+//# sourceMappingURL=constants.js.map

package/dist/core/v2ex/urls/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * V2EX URL 生成器导出
+ */
+export { V2EX_BASE } from './constants';
+export { getUserProfileUrl, getUserRepliesUrl, getUserTopicsUrl } from './user-urls';
+export { getTopicUrl, extractTopicIdFromPath } from './topic-urls';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/v2ex/urls/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * V2EX URL 生成器导出
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTopicIdFromPath = exports.getTopicUrl = exports.getUserTopicsUrl = exports.getUserRepliesUrl = exports.getUserProfileUrl = exports.V2EX_BASE = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "V2EX_BASE", { enumerable: true, get: function () { return constants_1.V2EX_BASE; } });
+var user_urls_1 = require("./user-urls");
+Object.defineProperty(exports, "getUserProfileUrl", { enumerable: true, get: function () { return user_urls_1.getUserProfileUrl; } });
+Object.defineProperty(exports, "getUserRepliesUrl", { enumerable: true, get: function () { return user_urls_1.getUserRepliesUrl; } });
+Object.defineProperty(exports, "getUserTopicsUrl", { enumerable: true, get: function () { return user_urls_1.getUserTopicsUrl; } });
+var topic_urls_1 = require("./topic-urls");
+Object.defineProperty(exports, "getTopicUrl", { enumerable: true, get: function () { return topic_urls_1.getTopicUrl; } });
+Object.defineProperty(exports, "extractTopicIdFromPath", { enumerable: true, get: function () { return topic_urls_1.extractTopicIdFromPath; } });
+//# sourceMappingURL=index.js.map

package/dist/core/v2ex/urls/topic-urls.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 帖子相关 URL 生成器
+ */
+/**
+ * 生成单个帖子页面 URL
+ * 支持帖子 ID 或相对路径作为输入
+ *
+ * @param topicIdOrPath - 帖子 ID（如 123456）或相对路径（如 /t/123456）
+ * @returns 完整 URL，如 https://www.v2ex.com/t/123456
+ * @throws 当输入的路径格式无效时（包含 /t/ 但无法提取有效 ID）
+ */
+export declare function getTopicUrl(topicIdOrPath: string | number): string;
+/**
+ * 从帖子相对路径提取帖子 ID
+ * @param path - 相对路径，如 /t/1180072 或 /t/1180072#reply1
+ * @returns 帖子 ID，如 1180072
+ */
+export declare function extractTopicIdFromPath(path: string): string | null;
+//# sourceMappingURL=topic-urls.d.ts.map

package/dist/core/v2ex/urls/topic-urls.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * 帖子相关 URL 生成器
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTopicUrl = getTopicUrl;
+exports.extractTopicIdFromPath = extractTopicIdFromPath;
+const constants_1 = require("./constants");
+/**
+ * 生成单个帖子页面 URL
+ * 支持帖子 ID 或相对路径作为输入
+ *
+ * @param topicIdOrPath - 帖子 ID（如 123456）或相对路径（如 /t/123456）
+ * @returns 完整 URL，如 https://www.v2ex.com/t/123456
+ * @throws 当输入的路径格式无效时（包含 /t/ 但无法提取有效 ID）
+ */
+function getTopicUrl(topicIdOrPath) {
+    // 数字直接使用
+    if (typeof topicIdOrPath === 'number') {
+        return `${constants_1.V2EX_BASE}/t/${topicIdOrPath}`;
+    }
+    // 修剪空白并验证
+    const trimmed = topicIdOrPath.trim();
+    if (!trimmed) {
+        throw new Error('Invalid topic ID: empty string provided');
+    }
+    // 路径格式（包含 /t/），提取 ID
+    if (trimmed.includes('/t/')) {
+        const topicId = extractTopicIdFromPath(trimmed);
+        if (topicId) {
+            return `${constants_1.V2EX_BASE}/t/${topicId}`;
+        }
+        // 包含 /t/ 但提取失败，抛出错误使问题更早暴露
+        throw new Error(`Invalid topic path: cannot extract topic ID from "${trimmed}"`);
+    }
+    // 纯 ID 字符串
+    return `${constants_1.V2EX_BASE}/t/${trimmed}`;
+}
+/**
+ * 从帖子相对路径提取帖子 ID
+ * @param path - 相对路径，如 /t/1180072 或 /t/1180072#reply1
+ * @returns 帖子 ID，如 1180072
+ */
+function extractTopicIdFromPath(path) {
+    const match = path.match(/\/t\/(\d+)/);
+    return match?.[1] ?? null;
+}
+//# sourceMappingURL=topic-urls.js.map

package/dist/core/v2ex/urls/user-urls.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 用户相关 URL 生成器
+ */
+/**
+ * 生成用户主页 URL
+ * @param username - 用户名
+ * @returns 完整 URL，如 https://www.v2ex.com/member/<username>
+ */
+export declare function getUserProfileUrl(username: string): string;
+/**
+ * 生成用户回复列表页 URL
+ * @param username - 用户名
+ * @param page - 页码，默认为 1
+ * @returns 完整 URL，如 https://www.v2ex.com/member/<username>/replies?p=1
+ */
+export declare function getUserRepliesUrl(username: string, page?: number): string;
+/**
+ * 生成用户发帖列表页 URL
+ * @param username - 用户名
+ * @param page - 页码，默认为 1
+ * @returns 完整 URL，如 https://www.v2ex.com/member/<username>/topics?p=1
+ */
+export declare function getUserTopicsUrl(username: string, page?: number): string;
+//# sourceMappingURL=user-urls.d.ts.map

package/dist/core/v2ex/urls/user-urls.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * 用户相关 URL 生成器
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserProfileUrl = getUserProfileUrl;
+exports.getUserRepliesUrl = getUserRepliesUrl;
+exports.getUserTopicsUrl = getUserTopicsUrl;
+const constants_1 = require("./constants");
+/**
+ * 生成用户主页 URL
+ * @param username - 用户名
+ * @returns 完整 URL，如 https://www.v2ex.com/member/<username>
+ */
+function getUserProfileUrl(username) {
+    return `${constants_1.V2EX_BASE}/member/${username}`;
+}
+/**
+ * 生成用户回复列表页 URL
+ * @param username - 用户名
+ * @param page - 页码，默认为 1
+ * @returns 完整 URL，如 https://www.v2ex.com/member/<username>/replies?p=1
+ */
+function getUserRepliesUrl(username, page = 1) {
+    return `${constants_1.V2EX_BASE}/member/${username}/replies?p=${page}`;
+}
+/**
+ * 生成用户发帖列表页 URL
+ * @param username - 用户名
+ * @param page - 页码，默认为 1
+ * @returns 完整 URL，如 https://www.v2ex.com/member/<username>/topics?p=1
+ */
+function getUserTopicsUrl(username, page = 1) {
+    return `${constants_1.V2EX_BASE}/member/${username}/topics?p=${page}`;
+}
+//# sourceMappingURL=user-urls.js.map

package/dist/core/v2ex/use-cases/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * V2EX Services 导出
+ * 提供高级数据获取 API
+ */
+export type { ServiceOptions, PagedResult } from './types';
+export { getUserProfile, getAllUserReplies, getAllUserTopicUrls, getAllUserTopicsDetail, } from './user';
+export type { UserTopicUrlsResult, UserTopicsDetailResult } from './user';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/v2ex/use-cases/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * V2EX Services 导出
+ * 提供高级数据获取 API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllUserTopicsDetail = exports.getAllUserTopicUrls = exports.getAllUserReplies = exports.getUserProfile = void 0;
+// 用户服务导出
+var user_1 = require("./user");
+Object.defineProperty(exports, "getUserProfile", { enumerable: true, get: function () { return user_1.getUserProfile; } });
+Object.defineProperty(exports, "getAllUserReplies", { enumerable: true, get: function () { return user_1.getAllUserReplies; } });
+Object.defineProperty(exports, "getAllUserTopicUrls", { enumerable: true, get: function () { return user_1.getAllUserTopicUrls; } });
+Object.defineProperty(exports, "getAllUserTopicsDetail", { enumerable: true, get: function () { return user_1.getAllUserTopicsDetail; } });
+//# sourceMappingURL=index.js.map

package/dist/core/v2ex/use-cases/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Service Layer 类型定义
+ * 定义服务层的配置选项和返回结果类型
+ */
+import type { FetchEvents } from '../../../infra/fetcher';
+/**
+ * Service 调用配置选项
+ */
+export interface ServiceOptions {
+    /** 请求超时时间（毫秒），默认使用 Fetcher 的 30000ms */
+    timeout?: number;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+    /** 抓取事件回调，用于进度展示 */
+    events?: FetchEvents;
+}
+/**
+ * 分页数据获取结果
+ * 用于返回多页合并后的数据
+ */
+export interface PagedResult<T> {
+    /** 合并后的完整数据列表 */
+    data: T[];
+    /** 总页数（来自第一页解析） */
+    totalPages: number;
+    /** 成功抓取的页数 */
+    fetchedPages: number;
+    /** 失败的页数 */
+    failedPages: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/v2ex/use-cases/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Service Layer 类型定义
+ * 定义服务层的配置选项和返回结果类型
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/v2ex/use-cases/user/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 用户相关服务导出
+ */
+export type { UserTopicUrlsResult } from './topic-urls';
+export type { UserTopicsDetailResult } from './topics-detail';
+export { getUserProfile } from './profile';
+export { getAllUserReplies } from './replies';
+export { getAllUserTopicUrls } from './topic-urls';
+export { getAllUserTopicsDetail } from './topics-detail';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/v2ex/use-cases/user/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * 用户相关服务导出
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllUserTopicsDetail = exports.getAllUserTopicUrls = exports.getAllUserReplies = exports.getUserProfile = void 0;
+// 服务函数导出
+var profile_1 = require("./profile");
+Object.defineProperty(exports, "getUserProfile", { enumerable: true, get: function () { return profile_1.getUserProfile; } });
+var replies_1 = require("./replies");
+Object.defineProperty(exports, "getAllUserReplies", { enumerable: true, get: function () { return replies_1.getAllUserReplies; } });
+var topic_urls_1 = require("./topic-urls");
+Object.defineProperty(exports, "getAllUserTopicUrls", { enumerable: true, get: function () { return topic_urls_1.getAllUserTopicUrls; } });
+var topics_detail_1 = require("./topics-detail");
+Object.defineProperty(exports, "getAllUserTopicsDetail", { enumerable: true, get: function () { return topics_detail_1.getAllUserTopicsDetail; } });
+//# sourceMappingURL=index.js.map

package/dist/core/v2ex/use-cases/user/profile.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 用户资料获取服务
+ */
+import type { UserProfileParseResult } from '../../types';
+import type { ServiceOptions } from '../types';
+/**
+ * 获取用户资料
+ *
+ * @param username - 用户名
+ * @param options - 服务配置选项
+ * @returns 用户资料解析结果，失败时返回 null
+ */
+export declare function getUserProfile(username: string, options?: ServiceOptions): Promise<UserProfileParseResult | null>;
+//# sourceMappingURL=profile.d.ts.map

package/dist/core/v2ex/use-cases/user/profile.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * 用户资料获取服务
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserProfile = getUserProfile;
+const fetcher_1 = require("../../../../infra/fetcher");
+const urls_1 = require("../../urls");
+const parsers_1 = require("../../parsers");
+/**
+ * 获取用户资料
+ *
+ * @param username - 用户名
+ * @param options - 服务配置选项
+ * @returns 用户资料解析结果，失败时返回 null
+ */
+async function getUserProfile(username, options) {
+    // 空用户名验证
+    if (!username.trim()) {
+        throw new Error('Invalid username: empty string provided');
+    }
+    const fetcher = new fetcher_1.Fetcher(new fetcher_1.SequentialStrategy());
+    const fetchOptions = {
+        timeout: options?.timeout,
+        headers: options?.headers,
+    };
+    const url = (0, urls_1.getUserProfileUrl)(username);
+    options?.events?.onStart?.(url, 0, 1);
+    const generator = fetcher.fetch([url], fetchOptions);
+    const result = await generator.next();
+    if (!result.value?.success || !result.value.content) {
+        options?.events?.onError?.(result.value, 0, 1);
+        return null;
+    }
+    options?.events?.onSuccess?.(result.value, 0, 1);
+    try {
+        return (0, parsers_1.parseUserProfile)(result.value.content);
+    }
+    catch (error) {
+        // 解析失败时也触发错误事件，保持与获取失败的一致性
+        options?.events?.onError?.({
+            url,
+            success: false,
+            content: null,
+            error: error instanceof Error ? error : new Error(String(error)),
+            statusCode: 0,
+        }, 0, 1);
+        return null;
+    }
+}
+//# sourceMappingURL=profile.js.map

package/dist/core/v2ex/use-cases/user/replies.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 用户回复数据获取服务
+ */
+import type { V2exReply } from '../../types';
+import type { PagedResult, ServiceOptions } from '../types';
+/**
+ * 获取用户所有回复
+ *
+ * @param username - 用户名
+ * @param options - 服务配置选项
+ * @returns 包含所有回复的分页结果
+ */
+export declare function getAllUserReplies(username: string, options?: ServiceOptions): Promise<PagedResult<V2exReply>>;
+//# sourceMappingURL=replies.d.ts.map

package/dist/core/v2ex/use-cases/user/replies.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * 用户回复数据获取服务
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllUserReplies = getAllUserReplies;
+const urls_1 = require("../../urls");
+const parsers_1 = require("../../parsers");
+const utils_1 = require("../utils");
+/**
+ * 获取用户所有回复
+ *
+ * @param username - 用户名
+ * @param options - 服务配置选项
+ * @returns 包含所有回复的分页结果
+ */
+async function getAllUserReplies(username, options) {
+    return (0, utils_1.fetchPagedData)((page) => (0, urls_1.getUserRepliesUrl)(username, page), parsers_1.parseRepliesPage, (result) => result.replies, options);
+}
+//# sourceMappingURL=replies.js.map

package/dist/core/v2ex/use-cases/user/topic-urls.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 用户发帖 URL 列表获取服务
+ */
+import type { PagedResult, ServiceOptions } from '../types';
+/**
+ * 用户发帖 URL 获取结果
+ * 扩展 PagedResult，增加隐藏状态标识
+ */
+export interface UserTopicUrlsResult extends PagedResult<string> {
+    /** 用户是否隐藏了主题列表 */
+    isHidden: boolean;
+}
+/**
+ * 获取用户所有发帖完整 URL
+ *
+ * @param username - 用户名
+ * @param options - 服务配置选项
+ * @returns 包含所有发帖完整 URL 的结果
+ */
+export declare function getAllUserTopicUrls(username: string, options?: ServiceOptions): Promise<UserTopicUrlsResult>;
+//# sourceMappingURL=topic-urls.d.ts.map

package/dist/core/v2ex/use-cases/user/topic-urls.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * 用户发帖 URL 列表获取服务
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllUserTopicUrls = getAllUserTopicUrls;
+const urls_1 = require("../../urls");
+const parsers_1 = require("../../parsers");
+const utils_1 = require("../utils");
+/**
+ * 获取用户所有发帖完整 URL
+ *
+ * @param username - 用户名
+ * @param options - 服务配置选项
+ * @returns 包含所有发帖完整 URL 的结果
+ */
+async function getAllUserTopicUrls(username, options) {
+    const result = await (0, utils_1.fetchPagedData)((page) => (0, urls_1.getUserTopicsUrl)(username, page), parsers_1.parseTopicsListPage, (parsed) => parsed.topicUrls, options);
+    // 将相对路径转换为完整 URL
+    const fullUrls = result.data.map((path) => (0, urls_1.getTopicUrl)(path));
+    // 检测隐藏状态：空数据且单页可能是隐藏
+    const isHidden = result.data.length === 0 && result.totalPages === 1;
+    return {
+        ...result,
+        data: fullUrls,
+        isHidden,
+    };
+}
+//# sourceMappingURL=topic-urls.js.map

package/dist/core/v2ex/use-cases/user/topics-detail.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 用户发帖详情获取服务
+ * 获取用户所有发帖的完整内容
+ */
+import type { TopicDetailParseResult } from '../../types';
+import type { ServiceOptions } from '../types';
+/**
+ * 用户发帖详情获取结果
+ */
+export interface UserTopicsDetailResult {
+    /** 所有帖子详情列表 */
+    topics: TopicDetailParseResult[];
+    /** 帖子总数（URL 数量） */
+    totalTopics: number;
+    /** 成功获取详情的帖子数 */
+    fetchedTopics: number;
+    /** 获取失败的帖子数 */
+    failedTopics: number;
+    /** 用户是否隐藏了主题列表 */
+    isHidden: boolean;
+}
+/**
+ * 获取用户所有发帖的完整详情
+ *
+ * @param username - 用户名
+ * @param options - 服务配置选项
+ * @returns 包含所有帖子详情的结果
+ */
+export declare function getAllUserTopicsDetail(username: string, options?: ServiceOptions): Promise<UserTopicsDetailResult>;
+//# sourceMappingURL=topics-detail.d.ts.map

package/dist/core/v2ex/use-cases/user/topics-detail.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * 用户发帖详情获取服务
+ * 获取用户所有发帖的完整内容
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAllUserTopicsDetail = getAllUserTopicsDetail;
+const fetcher_1 = require("../../../../infra/fetcher");
+const parsers_1 = require("../../parsers");
+const topic_urls_1 = require("./topic-urls");
+/**
+ * 获取用户所有发帖的完整详情
+ *
+ * @param username - 用户名
+ * @param options - 服务配置选项
+ * @returns 包含所有帖子详情的结果
+ */
+async function getAllUserTopicsDetail(username, options) {
+    // 获取用户所有帖子完整 URL
+    const urlsResult = await (0, topic_urls_1.getAllUserTopicUrls)(username, options);
+    if (urlsResult.isHidden || urlsResult.data.length === 0) {
+        return {
+            topics: [],
+            totalTopics: 0,
+            fetchedTopics: 0,
+            failedTopics: 0,
+            isHidden: urlsResult.isHidden,
+        };
+    }
+    const fetcher = new fetcher_1.Fetcher(new fetcher_1.SequentialStrategy());
+    const fetchOptions = {
+        timeout: options?.timeout,
+        headers: options?.headers,
+    };
+    const topics = [];
+    let fetchedTopics = 0;
+    let failedTopics = 0;
+    // 批量抓取并解析帖子详情
+    for await (const result of fetcher.fetch(urlsResult.data, fetchOptions, options?.events)) {
+        if (result.success && result.content) {
+            try {
+                const detail = (0, parsers_1.parseTopicDetail)(result.content);
+                topics.push(detail);
+                fetchedTopics++;
+            }
+            catch {
+                failedTopics++;
+            }
+        }
+        else {
+            failedTopics++;
+        }
+    }
+    return {
+        topics,
+        totalTopics: urlsResult.data.length,
+        fetchedTopics,
+        failedTopics,
+        isHidden: false,
+    };
+}
+//# sourceMappingURL=topics-detail.js.map

package/dist/core/v2ex/use-cases/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Service 工具函数导出
+ */
+export { fetchPagedData } from './page-orchestrator';
+export type { PaginatedParseResult } from './page-orchestrator';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/v2ex/use-cases/utils/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Service 工具函数导出
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchPagedData = void 0;
+var page_orchestrator_1 = require("./page-orchestrator");
+Object.defineProperty(exports, "fetchPagedData", { enumerable: true, get: function () { return page_orchestrator_1.fetchPagedData; } });
+//# sourceMappingURL=index.js.map

package/dist/core/v2ex/use-cases/utils/page-orchestrator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 分页数据编排器
+ * 提供通用的多页数据获取逻辑
+ */
+import type { PagedResult, ServiceOptions } from '../types';
+/**
+ * 分页解析结果的基础接口
+ * 任何需要分页的解析结果都必须包含这两个字段
+ */
+export interface PaginatedParseResult {
+    currentPage: number;
+    totalPages: number;
+}
+/**
+ * 获取分页数据的通用函数
+ *
+ * @param urlGenerator - 根据页码生成 URL 的函数
+ * @param parser - 解析 HTML 并返回包含分页信息的结果
+ * @param extractor - 从解析结果中提取数据列表的函数
+ * @param options - 服务配置选项
+ * @returns 合并后的分页结果
+ */
+export declare function fetchPagedData<TParseResult extends PaginatedParseResult, TData>(urlGenerator: (page: number) => string, parser: (html: string) => TParseResult, extractor: (result: TParseResult) => TData[], options?: ServiceOptions): Promise<PagedResult<TData>>;
+//# sourceMappingURL=page-orchestrator.d.ts.map

package/dist/core/v2ex/use-cases/utils/page-orchestrator.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * 分页数据编排器
+ * 提供通用的多页数据获取逻辑
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchPagedData = fetchPagedData;
+const fetcher_1 = require("../../../../infra/fetcher");
+/**
+ * 获取分页数据的通用函数
+ *
+ * @param urlGenerator - 根据页码生成 URL 的函数
+ * @param parser - 解析 HTML 并返回包含分页信息的结果
+ * @param extractor - 从解析结果中提取数据列表的函数
+ * @param options - 服务配置选项
+ * @returns 合并后的分页结果
+ */
+async function fetchPagedData(urlGenerator, parser, extractor, options) {
+    const fetcher = new fetcher_1.Fetcher(new fetcher_1.SequentialStrategy());
+    const fetchOptions = {
+        timeout: options?.timeout,
+        headers: options?.headers,
+    };
+    const allData = [];
+    let totalPages = 1;
+    let fetchedPages = 0;
+    let failedPages = 0;
+    // 抓取第一页，获取分页信息
+    // total 参数使用 -1 表示尚未确定总页数
+    const firstPageUrl = urlGenerator(1);
+    options?.events?.onStart?.(firstPageUrl, 0, -1);
+    const firstPageGen = fetcher.fetch([firstPageUrl], fetchOptions);
+    const firstPageResult = await firstPageGen.next();
+    if (!firstPageResult.value?.success || !firstPageResult.value.content) {
+        options?.events?.onError?.(firstPageResult.value, 0, -1);
+        return { data: [], totalPages: 1, fetchedPages: 0, failedPages: 1 };
+    }
+    options?.events?.onSuccess?.(firstPageResult.value, 0, -1);
+    // 解析第一页数据
+    try {
+        const firstParsed = parser(firstPageResult.value.content);
+        totalPages = firstParsed.totalPages;
+        allData.push(...extractor(firstParsed));
+        fetchedPages = 1;
+    }
+    catch (error) {
+        // 第一页解析失败，通知错误并返回空结果
+        options?.events?.onError?.({
+            url: firstPageUrl,
+            success: false,
+            content: null,
+            error: error instanceof Error ? error : new Error(String(error)),
+            statusCode: 0,
+        }, 0, -1);
+        return { data: [], totalPages: 1, fetchedPages: 0, failedPages: 1 };
+    }
+    // 单页时直接返回
+    if (totalPages <= 1) {
+        return { data: allData, totalPages, fetchedPages, failedPages };
+    }
+    // 生成剩余页 URL 并批量抓取
+    const remainingUrls = [];
+    for (let page = 2; page <= totalPages; page++) {
+        remainingUrls.push(urlGenerator(page));
+    }
+    let pageIndex = 1; // 从第2页开始，index=1
+    for await (const result of fetcher.fetch(remainingUrls, fetchOptions, options?.events)) {
+        if (result.success && result.content) {
+            try {
+                const parsed = parser(result.content);
+                allData.push(...extractor(parsed));
+                fetchedPages++;
+            }
+            catch (error) {
+                // 单页解析失败，通知错误并继续
+                options?.events?.onError?.({
+                    url: result.url,
+                    success: false,
+                    content: null,
+                    error: error instanceof Error ? error : new Error(String(error)),
+                    statusCode: 0,
+                }, pageIndex, totalPages);
+                failedPages++;
+            }
+        }
+        else {
+            failedPages++;
+        }
+        pageIndex++;
+    }
+    return { data: allData, totalPages, fetchedPages, failedPages };
+}
+//# sourceMappingURL=page-orchestrator.js.map