wespy-ts 0.2.0

package/dist/platforms/wechat/wechat-album.extractor.js

@@ -0,0 +1,190 @@
+/**
+ * WeChat 专辑提取器
+ */
+import { ok, err } from '../../core/result.js';
+import { fileSystemError, networkError } from '../../core/errors.js';
+import { stripHashSuffix } from '../../utils/url.js';
+import { fetchWechatArticle } from './wechat-article.extractor.js';
+import { writeJsonSafe } from '../../utils/fs.js';
+import { formatLocalTime } from '../../utils/text.js';
+import { join } from 'node:path';
+const WECHAT_MOBILE_UA = 'Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 MicroMessenger/8.0.5';
+/**
+ * 解析专辑 URL 参数
+ */
+export function parseAlbumInfo(albumUrl) {
+    try {
+        const parsed = new URL(albumUrl);
+        const params = parsed.searchParams;
+        const biz = params.get('__biz') || '';
+        const action = params.get('action') || '';
+        const albumId = params.get('album_id') || '';
+        if (!biz || !action || !albumId)
+            return null;
+        return { biz, action, albumId, originalUrl: albumUrl };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取专辑中的文章列表（分页）
+ */
+export async function fetchAlbumArticleList(albumUrl, httpClient, maxArticles) {
+    const albumInfo = parseAlbumInfo(albumUrl);
+    if (!albumInfo) {
+        return err(networkError('无法解析专辑 URL', { url: albumUrl }));
+    }
+    const articles = [];
+    let beginMsgid = 0;
+    let beginItemidx = 0;
+    const count = 10;
+    while (true) {
+        const apiUrl = new URL('https://mp.weixin.qq.com/mp/appmsgalbum');
+        apiUrl.searchParams.set('action', 'getalbum');
+        apiUrl.searchParams.set('__biz', albumInfo.biz);
+        apiUrl.searchParams.set('album_id', albumInfo.albumId);
+        apiUrl.searchParams.set('count', String(count));
+        apiUrl.searchParams.set('begin_msgid', String(beginMsgid));
+        apiUrl.searchParams.set('begin_itemidx', String(beginItemidx));
+        apiUrl.searchParams.set('f', 'json');
+        const res = await httpClient.get(apiUrl.toString(), {
+            'User-Agent': WECHAT_MOBILE_UA,
+            Referer: 'https://mp.weixin.qq.com/',
+        });
+        if (!res.ok) {
+            // 如果已经获取到部分文章，返回成功
+            if (articles.length > 0)
+                break;
+            return err(res.error);
+        }
+        let data;
+        try {
+            data = JSON.parse(res.value.body);
+        }
+        catch {
+            if (articles.length > 0)
+                break;
+            return err(networkError('专辑 API 响应不是有效 JSON', { url: albumUrl }));
+        }
+        const baseResp = data['base_resp'];
+        if (baseResp && baseResp['ret'] !== 0) {
+            if (articles.length > 0)
+                break;
+            return err(networkError(`专辑 API 返回错误: ${JSON.stringify(baseResp)}`, { url: albumUrl }));
+        }
+        const albumResp = data['getalbum_resp'];
+        const articleList = (albumResp?.['article_list'] ?? []);
+        if (!articleList.length)
+            break;
+        for (const item of articleList) {
+            const title = String(item['title'] ?? '').trim();
+            const url = stripHashSuffix(String(item['url'] ?? '')).trim();
+            // 关键字段为空则跳过该条目
+            if (!title || !url)
+                continue;
+            const entry = {
+                title,
+                url,
+                msgid: String(item['msgid'] ?? ''),
+                createTime: String(item['create_time'] ?? ''),
+                coverImg: String(item['cover_img_1_1'] ?? ''),
+                itemidx: String(item['itemidx'] ?? ''),
+                key: String(item['key'] ?? ''),
+            };
+            articles.push(entry);
+            if (maxArticles && articles.length >= maxArticles) {
+                return ok(articles);
+            }
+        }
+        // 检查是否还有更多
+        if (!albumResp)
+            break;
+        const continueFlag = String(albumResp['continue_flag'] ?? '0');
+        if (continueFlag !== '1')
+            break;
+        // 更新分页游标 — 缺失则终止（避免死循环）
+        const last = articleList[articleList.length - 1];
+        const lastMsgid = last['msgid'];
+        const lastItemidx = last['itemidx'];
+        if (lastMsgid == null || lastItemidx == null)
+            break;
+        beginMsgid = Number(lastMsgid);
+        beginItemidx = Number(lastItemidx);
+        // 延迟
+        await delay(500);
+    }
+    return ok(articles);
+}
+/**
+ * 批量下载专辑文章
+ */
+export async function fetchAlbumArticles(albumUrl, httpClient, outputDir, formats, maxArticles) {
+    const listResult = await fetchAlbumArticleList(albumUrl, httpClient, maxArticles);
+    if (!listResult.ok)
+        return err(listResult.error);
+    const entries = listResult.value;
+    if (!entries.length) {
+        // Python: 返回空列表（成功），不是错误
+        return ok({ articles: [], artifacts: [], failedCount: 0 });
+    }
+    const albumName = `album_${Math.floor(Date.now() / 1000)}`;
+    const albumDir = join(outputDir, albumName);
+    const articles = [];
+    const allArtifacts = [];
+    const failed = [];
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        console.log(`\n[${i + 1}/${entries.length}] 正在下载: ${entry.title}`);
+        const articleResult = await fetchWechatArticle(entry.url, httpClient, albumDir, formats);
+        if (articleResult.ok) {
+            // 合并专辑元数据到文章（与 Python 版一致）
+            const article = articleResult.value.article;
+            article.metadata['album_title'] = entry.title;
+            article.metadata['album_url'] = albumUrl;
+            article.metadata['msgid'] = entry.msgid;
+            article.metadata['create_time'] = entry.createTime;
+            article.metadata['cover_img'] = entry.coverImg;
+            articles.push(article);
+            allArtifacts.push(...articleResult.value.artifacts);
+            console.log(`✅ 下载成功`);
+        }
+        else {
+            failed.push({ title: entry.title, url: entry.url, msgid: entry.msgid, error: articleResult.error.message });
+            console.log(`❌ 下载失败: ${articleResult.error.message}`);
+        }
+        // 延迟
+        if (i < entries.length - 1)
+            await delay(1000);
+    }
+    // 保存汇总（与 Python 版字段一致）
+    const summaryFile = join(outputDir, `${albumName}_summary.json`);
+    try {
+        await writeJsonSafe(summaryFile, {
+            album_url: albumUrl,
+            download_time: formatLocalTime(),
+            statistics: {
+                total_count: entries.length,
+                successful_count: articles.length,
+                failed_count: failed.length,
+            },
+            successful_articles: articles.map((a) => ({
+                title: a.title,
+                author: a.author,
+                url: a.url,
+                msgid: String(a.metadata['msgid'] ?? ''),
+                create_time: String(a.metadata['create_time'] ?? ''),
+            })),
+            failed_articles: failed,
+        });
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return err(fileSystemError(message, { outputDir, albumUrl }));
+    }
+    return ok({ articles, artifacts: allArtifacts, summaryFile, failedCount: failed.length });
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=wechat-album.extractor.js.map

package/dist/platforms/wechat/wechat-album.extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-album.extractor.js","sourceRoot":"","sources":["../../../src/platforms/wechat/wechat-album.extractor.ts"],"names":[],"mappings":"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"}

package/dist/platforms/wechat/wechat-article.extractor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WeChat 文章提取器
+ */
+import { HttpClient } from '../../fetcher/http-client.js';
+import type { ArticleDraft, OutputFormat, OutputArtifact } from '../../core/types.js';
+import type { Result } from '../../core/result.js';
+import type { WechatArticleInfo } from './wechat.types.js';
+/**
+ * 从 HTML 中提取微信文章信息
+ * 返回空字符串表示未找到对应字段，不注入假数据
+ */
+export declare function extractWechatInfo(html: string): WechatArticleInfo;
+/**
+ * 获取单篇微信文章
+ */
+export declare function fetchWechatArticle(url: string, httpClient: HttpClient, outputDir: string, formats: OutputFormat[]): Promise<Result<{
+    article: ArticleDraft;
+    artifacts: OutputArtifact[];
+}>>;
+//# sourceMappingURL=wechat-article.extractor.d.ts.map

package/dist/platforms/wechat/wechat-article.extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-article.extractor.d.ts","sourceRoot":"","sources":["../../../src/platforms/wechat/wechat-article.extractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACrF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAKlD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAO1D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAoCjE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAAC,CAyCzE"}

package/dist/platforms/wechat/wechat-article.extractor.js

@@ -0,0 +1,132 @@
+/**
+ * WeChat 文章提取器
+ */
+import * as cheerio from 'cheerio';
+import { htmlToMarkdown } from '../../converter/html-to-markdown.js';
+import { ok, err } from '../../core/result.js';
+import { fileSystemError, parseEmptyError } from '../../core/errors.js';
+import { sanitizeFilename, formatLocalTime } from '../../utils/text.js';
+import { writeFileSafe, writeJsonSafe, ensureDir } from '../../utils/fs.js';
+import { join } from 'node:path';
+const WECHAT_HEADERS = {
+    Referer: 'https://mp.weixin.qq.com/',
+};
+/**
+ * 从 HTML 中提取微信文章信息
+ * 返回空字符串表示未找到对应字段，不注入假数据
+ */
+export function extractWechatInfo(html) {
+    const $ = cheerio.load(html);
+    // 标题
+    const titleEl = $('h1.rich_media_title').first().length
+        ? $('h1.rich_media_title').first()
+        : $('h1').first();
+    const title = titleEl.text().trim();
+    // 作者
+    const authorEl = $('#js_name').first().length ? $('#js_name').first()
+        : $('a.profile_nickname').first().length ? $('a.profile_nickname').first()
+            : $('span.profile_nickname').first();
+    const author = authorEl.text().trim().replace(/[\n\r\t]/g, '');
+    // 发布时间
+    let publishTime = '';
+    const timeEl = $('#publish_time').first().length
+        ? $('#publish_time').first()
+        : $('span.publish_time').first();
+    if (timeEl.length) {
+        publishTime = timeEl.text().trim();
+    }
+    // JS 渲染的时间 fallback
+    if (!publishTime) {
+        const match = html.match(/create_time:\s*JsDecode\('([^']+)'\)/);
+        if (match)
+            publishTime = match[1];
+    }
+    // 内容
+    const contentEl = $('#js_content');
+    const contentHtml = contentEl.length ? (contentEl.html() ?? '') : '';
+    const contentText = contentEl.length ? contentEl.text().trim() : '';
+    return { title, author, publishTime, contentHtml, contentText };
+}
+/**
+ * 获取单篇微信文章
+ */
+export async function fetchWechatArticle(url, httpClient, outputDir, formats) {
+    const res = await httpClient.get(url, WECHAT_HEADERS);
+    if (!res.ok)
+        return err(res.error);
+    const html = res.value.body;
+    const info = extractWechatInfo(html);
+    // 标题为空 → 解析失败
+    if (!info.title) {
+        return err(parseEmptyError(url));
+    }
+    // 记录缺失字段为 warnings，不注入假数据
+    const warnings = [];
+    if (!info.author)
+        warnings.push('未找到作者信息');
+    if (!info.publishTime)
+        warnings.push('未找到发布时间');
+    const article = {
+        platform: 'wechat',
+        url,
+        title: info.title,
+        author: info.author || undefined,
+        publishTime: info.publishTime || undefined,
+        rawHtml: html,
+        contentHtml: info.contentHtml,
+        contentText: info.contentText,
+        markdown: htmlToMarkdown(info.contentHtml),
+        metadata: {},
+        fetchedAt: formatLocalTime(),
+        warnings,
+    };
+    let artifacts;
+    try {
+        artifacts = await saveArtifacts(article, outputDir, formats);
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return err(fileSystemError(message, { outputDir, url }));
+    }
+    return ok({ article, artifacts, warnings });
+}
+async function saveArtifacts(article, outputDir, formats) {
+    const artifacts = [];
+    const safeTitle = sanitizeFilename(article.title);
+    const timestamp = Math.floor(Date.now() / 1000);
+    await ensureDir(outputDir);
+    // HTML 文件保存完整页面（与 Python 版一致）
+    const htmlFileName = formats.includes('html') && article.rawHtml
+        ? `${safeTitle}_${timestamp}.html`
+        : null;
+    if (htmlFileName && article.rawHtml) {
+        const filePath = join(outputDir, htmlFileName);
+        await writeFileSafe(filePath, article.rawHtml);
+        artifacts.push({ type: 'html', path: filePath });
+    }
+    if (formats.includes('json')) {
+        const filePath = join(outputDir, `${safeTitle}_${timestamp}_info.json`);
+        await writeJsonSafe(filePath, {
+            title: article.title,
+            author: article.author ?? null,
+            publish_time: article.publishTime ?? null,
+            url: article.url,
+            html_file: htmlFileName,
+            fetch_time: article.fetchedAt,
+        });
+        artifacts.push({ type: 'json', path: filePath });
+    }
+    if (formats.includes('markdown') && article.markdown) {
+        const filePath = join(outputDir, `${safeTitle}_${timestamp}.md`);
+        const lines = [`# ${article.title}`, ''];
+        if (article.author)
+            lines.push(`**作者**: ${article.author}`);
+        if (article.publishTime)
+            lines.push(`**发布时间**: ${article.publishTime}`);
+        lines.push(`**原文链接**: ${article.url}`, '', '---', '', article.markdown);
+        await writeFileSafe(filePath, lines.join('\n'));
+        artifacts.push({ type: 'markdown', path: filePath });
+    }
+    return artifacts;
+}
+//# sourceMappingURL=wechat-article.extractor.js.map

package/dist/platforms/wechat/wechat-article.extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-article.extractor.js","sourceRoot":"","sources":["../../../src/platforms/wechat/wechat-article.extractor.ts"],"names":[],"mappings":"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"}

package/dist/platforms/wechat/wechat.types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WeChat 平台相关类型
+ */
+export interface WechatArticleInfo {
+    title: string;
+    author: string;
+    publishTime: string;
+    contentHtml: string;
+    contentText: string;
+}
+export interface WechatAlbumInfo {
+    biz: string;
+    action: string;
+    albumId: string;
+    originalUrl: string;
+}
+//# sourceMappingURL=wechat.types.d.ts.map

package/dist/platforms/wechat/wechat.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat.types.d.ts","sourceRoot":"","sources":["../../../src/platforms/wechat/wechat.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB"}

package/dist/platforms/wechat/wechat.types.js

@@ -0,0 +1,5 @@
+/**
+ * WeChat 平台相关类型
+ */
+export {};
+//# sourceMappingURL=wechat.types.js.map

package/dist/platforms/wechat/wechat.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat.types.js","sourceRoot":"","sources":["../../../src/platforms/wechat/wechat.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/sdk/fetch-album-list.d.ts

@@ -0,0 +1,10 @@
+/**
+ * fetchAlbumList SDK API —— 仅获取专辑文章列表，不下载文章内容
+ * 对应 Python 版 album_fetcher.fetch_album_articles()
+ */
+import type { FetchAlbumListInput, FetchAlbumListResult } from '../core/types.js';
+/**
+ * 获取微信专辑文章列表（仅 API，不下载文章内容）
+ */
+export declare function fetchAlbumList(input: FetchAlbumListInput): Promise<FetchAlbumListResult>;
+//# sourceMappingURL=fetch-album-list.d.ts.map

package/dist/sdk/fetch-album-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-album-list.d.ts","sourceRoot":"","sources":["../../src/sdk/fetch-album-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAErB,MAAM,kBAAkB,CAAA;AAQzB;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkB9F"}

package/dist/sdk/fetch-album-list.js

@@ -0,0 +1,31 @@
+/**
+ * fetchAlbumList SDK API —— 仅获取专辑文章列表，不下载文章内容
+ * 对应 Python 版 album_fetcher.fetch_album_articles()
+ */
+import { FetchAlbumListInputSchema } from '../core/types.js';
+import { HttpClient } from '../fetcher/http-client.js';
+import { fetchAlbumArticleList } from '../platforms/wechat/wechat-album.extractor.js';
+import { isWechatAlbumUrl } from '../platforms/detector.js';
+import { unsupportedUrlError, invalidInputError } from '../core/errors.js';
+/**
+ * 获取微信专辑文章列表（仅 API，不下载文章内容）
+ */
+export async function fetchAlbumList(input) {
+    const parsed = FetchAlbumListInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return failure(invalidInputError(parsed.error.issues.map((i) => i.message).join('; ')));
+    }
+    const { url, maxArticles, timeoutMs } = parsed.data;
+    if (!isWechatAlbumUrl(url)) {
+        return failure(unsupportedUrlError('fetchAlbumList 仅支持微信专辑 URL'));
+    }
+    const httpClient = new HttpClient({ timeoutMs });
+    const res = await fetchAlbumArticleList(url, httpClient, maxArticles);
+    if (!res.ok)
+        return failure(res.error);
+    return { ok: true, articles: res.value, warnings: [] };
+}
+function failure(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=fetch-album-list.js.map

package/dist/sdk/fetch-album-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-album-list.js","sourceRoot":"","sources":["../../src/sdk/fetch-album-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAA;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA0B;IAC7D,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzF,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,IAAI,CAAA;IAEnD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,mBAAmB,CAAC,4BAA4B,CAAC,CAAC,CAAA;IACnE,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;IAEhD,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC,CAAA;IACrE,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAEtC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;AACxD,CAAC;AAED,SAAS,OAAO,CAAC,KAAiB;IAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC7B,CAAC"}

package/dist/sdk/fetch-album.d.ts

@@ -0,0 +1,24 @@
+/**
+ * fetchAlbum SDK API
+ */
+import type { FetchAlbumInput, FetchAlbumResult } from '../core/types.js';
+/**
+ * 获取微信专辑中的文章列表并批量下载
+ *
+ * @example
+ * ```ts
+ * import { fetchAlbum } from 'wespy'
+ *
+ * const result = await fetchAlbum({
+ *   url: 'https://mp.weixin.qq.com/mp/appmsgalbum?...',
+ *   maxArticles: 5,
+ *   format: ['markdown'],
+ * })
+ *
+ * if (result.ok) {
+ *   console.log(`成功获取 ${result.articles.length} 篇文章`)
+ * }
+ * ```
+ */
+export declare function fetchAlbum(input: FetchAlbumInput): Promise<FetchAlbumResult>;
+//# sourceMappingURL=fetch-album.d.ts.map

package/dist/sdk/fetch-album.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-album.d.ts","sourceRoot":"","sources":["../../src/sdk/fetch-album.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAEjB,MAAM,kBAAkB,CAAA;AAQzB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwClF"}

package/dist/sdk/fetch-album.js

@@ -0,0 +1,67 @@
+/**
+ * fetchAlbum SDK API
+ */
+import { FetchAlbumInputSchema } from '../core/types.js';
+import { HttpClient } from '../fetcher/http-client.js';
+import { fetchAlbumArticles } from '../platforms/wechat/wechat-album.extractor.js';
+import { isWechatAlbumUrl } from '../platforms/detector.js';
+import { unsupportedUrlError, invalidInputError } from '../core/errors.js';
+/**
+ * 获取微信专辑中的文章列表并批量下载
+ *
+ * @example
+ * ```ts
+ * import { fetchAlbum } from 'wespy'
+ *
+ * const result = await fetchAlbum({
+ *   url: 'https://mp.weixin.qq.com/mp/appmsgalbum?...',
+ *   maxArticles: 5,
+ *   format: ['markdown'],
+ * })
+ *
+ * if (result.ok) {
+ *   console.log(`成功获取 ${result.articles.length} 篇文章`)
+ * }
+ * ```
+ */
+export async function fetchAlbum(input) {
+    // 输入校验
+    const parsed = FetchAlbumInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return failure(invalidInputError(parsed.error.issues.map((i) => i.message).join('; ')));
+    }
+    const { url, outputDir, format, maxArticles, timeoutMs, downloadImages } = parsed.data;
+    if (downloadImages) {
+        return failure(invalidInputError('downloadImages 尚未实现；Python 原版仅在 Markdown 中转换图片代理 URL'));
+    }
+    if (!isWechatAlbumUrl(url)) {
+        return failure(unsupportedUrlError('fetchAlbum 仅支持微信专辑 URL'));
+    }
+    const httpClient = new HttpClient({ timeoutMs });
+    try {
+        const res = await fetchAlbumArticles(url, httpClient, outputDir, format, maxArticles);
+        if (!res.ok)
+            return failure(res.error);
+        return {
+            ok: true,
+            articles: res.value.articles,
+            artifacts: res.value.artifacts,
+            warnings: [],
+            summaryFile: res.value.summaryFile,
+            failedCount: res.value.failedCount,
+        };
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return failure({
+            code: 'UNKNOWN_ERROR',
+            message,
+            retryable: false,
+            details: { url },
+        });
+    }
+}
+function failure(error) {
+    return { ok: false, error };
+}
+//# sourceMappingURL=fetch-album.js.map

package/dist/sdk/fetch-album.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-album.js","sourceRoot":"","sources":["../../src/sdk/fetch-album.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,OAAO;IACP,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzF,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,IAAI,CAAA;IAEtF,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,iBAAiB,CAAC,sDAAsD,CAAC,CAAC,CAAA;IAC3F,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;IAEhD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;QACrF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAEtC,OAAO;YACL,EAAE,EAAE,IAAI;YACR,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ;YAC5B,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS;YAC9B,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW;YAClC,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW;SACnC,CAAA;IACH,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QAC1D,OAAO,OAAO,CAAC;YACb,IAAI,EAAE,eAAe;YACrB,OAAO;YACP,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,GAAG,EAAE;SACjB,CAAC,CAAA;IACJ,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAiB;IAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC7B,CAAC"}

package/dist/sdk/fetch-article.d.ts

@@ -0,0 +1,24 @@
+/**
+ * fetchArticle SDK API
+ */
+import type { FetchArticleInput, FetchArticleResult } from '../core/types.js';
+/**
+ * 获取单篇文章
+ *
+ * @example
+ * ```ts
+ * import { fetchArticle } from 'wespy'
+ *
+ * const result = await fetchArticle({
+ *   url: 'https://mp.weixin.qq.com/s/xxxxx',
+ *   format: ['markdown', 'json'],
+ * })
+ *
+ * if (result.ok) {
+ *   console.log(result.article.title)
+ *   console.log(result.article.markdown)
+ * }
+ * ```
+ */
+export declare function fetchArticle(input: FetchArticleInput): Promise<FetchArticleResult>;
+//# sourceMappingURL=fetch-article.d.ts.map

package/dist/sdk/fetch-article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-article.d.ts","sourceRoot":"","sources":["../../src/sdk/fetch-article.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAKnB,MAAM,kBAAkB,CAAA;AAWzB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmExF"}