wespy-ts 0.2.0

package/dist/converter/html-to-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-markdown.js","sourceRoot":"","sources":["../../src/converter/html-to-markdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEvE;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IAChD,OAAO,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,CAAqB,EAAE,IAA8B;IACxE,IAAI,EAAE,GAAG,EAAE,CAAA;IAEX,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QAChC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;YACnC,IAAI,IAAI;gBAAE,EAAE,IAAI,IAAI,CAAA;YACpB,OAAM;QACR,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;YAAE,OAAM;QAEhC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;QACnB,MAAM,GAAG,GAAI,KAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAA;QAExD,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,IAAI;gBACP,EAAE,IAAI,IAAI,CAAA;gBACV,MAAK;YAEP,KAAK,GAAG,CAAC;YACT,KAAK,KAAK,CAAC;YACX,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBACzC,IAAI,OAAO;oBAAE,EAAE,IAAI,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;gBAC1C,MAAK;YACP,CAAC;YAED,KAAK,IAAI,CAAC;YACV,KAAK,IAAI,CAAC;YACV,KAAK,IAAI,CAAC;YACV,KAAK,IAAI,CAAC;YACV,KAAK,IAAI,CAAC;YACV,KAAK,IAAI,CAAC,CAAC,CAAC;gBACV,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAA;gBACnC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBACzC,IAAI,OAAO;oBAAE,EAAE,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,CAAA;gBAClE,MAAK;YACP,CAAC;YAED,KAAK,QAAQ,CAAC;YACd,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBACzC,IAAI,OAAO;oBAAE,EAAE,IAAI,IAAI,GAAG,OAAO,GAAG,IAAI,CAAA;gBACxC,MAAK;YACP,CAAC;YAED,KAAK,IAAI,CAAC;YACV,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBACzC,IAAI,OAAO;oBAAE,EAAE,IAAI,GAAG,GAAG,OAAO,GAAG,GAAG,CAAA;gBACtC,MAAK;YACP,CAAC;YAED,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;gBACvD,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;gBAChC,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;oBACxC,EAAE,IAAI,OAAO,GAAG,KAAK,QAAQ,KAAK,CAAA;gBACpC,CAAC;gBACD,MAAK;YACP,CAAC;YAED,KAAK,GAAG,CAAC,CAAC,CAAC;gBACT,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;gBAClC,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;gBACtC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;oBACjB,EAAE,IAAI,IAAI,IAAI,KAAK,IAAI,GAAG,CAAA;gBAC5B,CAAC;qBAAM,IAAI,IAAI,EAAE,CAAC;oBAChB,EAAE,IAAI,IAAI,CAAA;gBACZ,CAAC;gBACD,MAAK;YACP,CAAC;YAED,KAAK,IAAI,CAAC;YACV,KAAK,IAAI,CAAC,CAAC,CAAC;gBACV,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC,CAAA;gBACpD,IAAI,WAAW;oBAAE,EAAE,IAAI,IAAI,GAAG,WAAW,GAAG,IAAI,CAAA;gBAChD,MAAK;YACP,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,+BAA+B;gBAC/B,MAAM,MAAM,GAAI,KAAoB,CAAC,MAAM,CAAA;gBAC3C,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,IAAK,MAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK;oBAAE,MAAK;gBACrG,MAAM,WAAW,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;gBACpC,IAAI,WAAW;oBAAE,EAAE,IAAI,GAAG,GAAG,WAAW,GAAG,GAAG,CAAA;gBAC9C,MAAK;YACP,CAAC;YAED,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,WAAW,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAA;gBAC1C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBACzC,IAAI,WAAW,EAAE,CAAC;oBAChB,IAAI,QAAQ,EAAE,CAAC;wBACb,EAAE,IAAI,WAAW,QAAQ,KAAK,WAAW,YAAY,CAAA;oBACvD,CAAC;yBAAM,CAAC;wBACN,EAAE,IAAI,aAAa,WAAW,YAAY,CAAA;oBAC5C,CAAC;gBACH,CAAC;gBACD,MAAK;YACP,CAAC;YAED,OAAO,CAAC,CAAC,CAAC;gBACR,EAAE,IAAI,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,CAAA;AACX,CAAC;AAED,SAAS,WAAW,CAAC,CAAqB,EAAE,MAAgC,EAAE,OAAgB;IAC5F,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,OAAO,EAAE,CAAC;gBACZ,EAAE,IAAI,GAAG,KAAK,KAAK,OAAO,IAAI,CAAA;gBAC9B,KAAK,EAAE,CAAA;YACT,CAAC;iBAAM,CAAC;gBACN,EAAE,IAAI,KAAK,OAAO,IAAI,CAAA;YACxB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,CAAA;AACX,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA+B;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5D,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAsB,EAAE,KAA+B;IAChF,mBAAmB;IACnB,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC3E,IAAI,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;IACzC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IAErB,sBAAsB;IACtB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC7E,IAAI,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;QACtC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAA;QAErB,mBAAmB;QACnB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpE,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAA;IAC7C,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACrE,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC,WAAW,EAAE,CAAA;IAEjD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/converter/sanitize-html.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTML 清理工具
+ * 用于清理掘金等内容中的冗余样式
+ */
+/**
+ * 清理 HTML 内容：
+ * - 移除 <style> 标签
+ * - 移除 data-highlight 属性元素
+ * - 移除 inline style 属性
+ */
+export declare function sanitizeHtml(html: string): string;
+//# sourceMappingURL=sanitize-html.d.ts.map

package/dist/converter/sanitize-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-html.d.ts","sourceRoot":"","sources":["../../src/converter/sanitize-html.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAajD"}

package/dist/converter/sanitize-html.js

@@ -0,0 +1,22 @@
+/**
+ * HTML 清理工具
+ * 用于清理掘金等内容中的冗余样式
+ */
+import * as cheerio from 'cheerio';
+/**
+ * 清理 HTML 内容：
+ * - 移除 <style> 标签
+ * - 移除 data-highlight 属性元素
+ * - 移除 inline style 属性
+ */
+export function sanitizeHtml(html) {
+    const $ = cheerio.load(html, { xmlMode: false });
+    // 移除所有 style 标签
+    $('style').remove();
+    // 移除 data-highlight 属性元素
+    $('[data-highlight]').remove();
+    // 移除所有元素的 style 属性
+    $('[style]').removeAttr('style');
+    return $.html();
+}
+//# sourceMappingURL=sanitize-html.js.map

package/dist/converter/sanitize-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-html.js","sourceRoot":"","sources":["../../src/converter/sanitize-html.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAElC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IAEhD,gBAAgB;IAChB,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAA;IAEnB,yBAAyB;IACzB,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,EAAE,CAAA;IAE9B,mBAAmB;IACnB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IAEhC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;AACjB,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WeSpy 错误模型
+ */
+import type { WeSpyError } from './types.js';
+export declare class WeSpyException extends Error {
+    readonly wespyError: WeSpyError;
+    constructor(error: WeSpyError);
+}
+export declare function createError(code: WeSpyError['code'], message: string, retryable?: boolean, details?: Record<string, unknown>): WeSpyError;
+export declare function networkError(message: string, details?: Record<string, unknown>): WeSpyError;
+export declare function httpStatusError(statusCode: number, url: string): WeSpyError;
+export declare function timeoutError(url: string, timeoutMs: number): WeSpyError;
+export declare function parseEmptyError(url: string): WeSpyError;
+export declare function unsupportedUrlError(url: string): WeSpyError;
+export declare function invalidInputError(message: string): WeSpyError;
+export declare function fileSystemError(message: string, details?: Record<string, unknown>): WeSpyError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;gBAEnB,KAAK,EAAE,UAAU;CAK9B;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EACxB,OAAO,EAAE,MAAM,EACf,SAAS,UAAQ,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,UAAU,CAEZ;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAE3F;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAO3E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAEvE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAE7D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAE9F"}

package/dist/core/errors.js

@@ -0,0 +1,36 @@
+/**
+ * WeSpy 错误模型
+ */
+export class WeSpyException extends Error {
+    wespyError;
+    constructor(error) {
+        super(error.message);
+        this.name = 'WeSpyException';
+        this.wespyError = error;
+    }
+}
+export function createError(code, message, retryable = false, details) {
+    return { code, message, retryable, details };
+}
+export function networkError(message, details) {
+    return createError('NETWORK_ERROR', message, true, details);
+}
+export function httpStatusError(statusCode, url) {
+    return createError('HTTP_STATUS_ERROR', `HTTP ${statusCode} for ${url}`, statusCode >= 500 || statusCode === 429, { statusCode, url });
+}
+export function timeoutError(url, timeoutMs) {
+    return createError('TIMEOUT', `Request timed out after ${timeoutMs}ms: ${url}`, true, { url, timeoutMs });
+}
+export function parseEmptyError(url) {
+    return createError('PARSE_EMPTY', `Failed to extract article content from: ${url}`, false, { url });
+}
+export function unsupportedUrlError(url) {
+    return createError('UNSUPPORTED_URL', `Unsupported URL: ${url}`, false, { url });
+}
+export function invalidInputError(message) {
+    return createError('INVALID_INPUT', message, false);
+}
+export function fileSystemError(message, details) {
+    return createError('FILE_SYSTEM_ERROR', message, false, details);
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,UAAU,CAAY;IAE/B,YAAY,KAAiB;QAC3B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;IACzB,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CACzB,IAAwB,EACxB,OAAe,EACf,SAAS,GAAG,KAAK,EACjB,OAAiC;IAEjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAiC;IAC7E,OAAO,WAAW,CAAC,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,GAAW;IAC7D,OAAO,WAAW,CAChB,mBAAmB,EACnB,QAAQ,UAAU,QAAQ,GAAG,EAAE,EAC/B,UAAU,IAAI,GAAG,IAAI,UAAU,KAAK,GAAG,EACvC,EAAE,UAAU,EAAE,GAAG,EAAE,CACpB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,SAAiB;IACzD,OAAO,WAAW,CAAC,SAAS,EAAE,2BAA2B,SAAS,OAAO,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;AAC3G,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,WAAW,CAAC,aAAa,EAAE,2CAA2C,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;AACrG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,WAAW,CAAC,iBAAiB,EAAE,oBAAoB,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;AAClF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,WAAW,CAAC,eAAe,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,OAAiC;IAChF,OAAO,WAAW,CAAC,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;AAClE,CAAC"}

package/dist/core/result.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Result 类型 —— 避免 throw，用类型安全的方式传递错误
+ */
+import type { WeSpyError } from './types.js';
+export type Result<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: WeSpyError;
+};
+export declare function ok<T>(value: T): Result<T>;
+export declare function err<T>(error: WeSpyError): Result<T>;
+export declare function isOk<T>(result: Result<T>): result is {
+    ok: true;
+    value: T;
+};
+export declare function isErr<T>(result: Result<T>): result is {
+    ok: false;
+    error: WeSpyError;
+};
+/** 将 Result 转为值或抛出异常 */
+export declare function unwrap<T>(result: Result<T>): T;
+/** 将 Result 转为值或返回默认值 */
+export declare function unwrapOr<T>(result: Result<T>, defaultValue: T): T;
+//# sourceMappingURL=result.d.ts.map

package/dist/core/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAA;AAEpC,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEzC;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAEnD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAE3E;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAEtF;AAED,wBAAwB;AACxB,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAG9C;AAED,yBAAyB;AACzB,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAEjE"}

package/dist/core/result.js

@@ -0,0 +1,26 @@
+/**
+ * Result 类型 —— 避免 throw，用类型安全的方式传递错误
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+export function isOk(result) {
+    return result.ok;
+}
+export function isErr(result) {
+    return !result.ok;
+}
+/** 将 Result 转为值或抛出异常 */
+export function unwrap(result) {
+    if (result.ok)
+        return result.value;
+    throw new Error(result.error.message);
+}
+/** 将 Result 转为值或返回默认值 */
+export function unwrapOr(result, defaultValue) {
+    return result.ok ? result.value : defaultValue;
+}
+//# sourceMappingURL=result.js.map

package/dist/core/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAiB;IACtC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,IAAI,CAAI,MAAiB;IACvC,OAAO,MAAM,CAAC,EAAE,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,KAAK,CAAI,MAAiB;IACxC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAA;AACnB,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,MAAM,CAAI,MAAiB;IACzC,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC,KAAK,CAAA;IAClC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;AACvC,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,QAAQ,CAAI,MAAiB,EAAE,YAAe;IAC5D,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAA;AAChD,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,156 @@
+/**
+ * WeSpy 核心类型定义
+ */
+import { z } from 'zod';
+export type SupportedPlatform = 'wechat' | 'wechat-album' | 'juejin' | 'generic';
+export type OutputFormat = 'json' | 'markdown' | 'html';
+export declare const FetchArticleInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    outputDir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<["json", "markdown", "html"]>, "many">>>;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    userAgent: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    downloadImages: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    outputDir: string;
+    format: ("json" | "markdown" | "html")[];
+    timeoutMs: number;
+    userAgent?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    downloadImages?: boolean | undefined;
+}, {
+    url: string;
+    outputDir?: string | undefined;
+    format?: ("json" | "markdown" | "html")[] | undefined;
+    timeoutMs?: number | undefined;
+    userAgent?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    downloadImages?: boolean | undefined;
+}>;
+export type FetchArticleInput = z.input<typeof FetchArticleInputSchema>;
+export declare const FetchAlbumInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    outputDir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEnum<["json", "markdown", "html"]>, "many">>>;
+    maxArticles: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    downloadImages: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    outputDir: string;
+    format: ("json" | "markdown" | "html")[];
+    timeoutMs: number;
+    maxArticles: number;
+    downloadImages?: boolean | undefined;
+}, {
+    url: string;
+    outputDir?: string | undefined;
+    format?: ("json" | "markdown" | "html")[] | undefined;
+    timeoutMs?: number | undefined;
+    downloadImages?: boolean | undefined;
+    maxArticles?: number | undefined;
+}>;
+export type FetchAlbumInput = z.input<typeof FetchAlbumInputSchema>;
+export interface ArticleImage {
+    originalUrl: string;
+    localPath?: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+}
+export interface ArticleDraft {
+    platform: SupportedPlatform;
+    url: string;
+    title: string;
+    author?: string;
+    publishTime?: string;
+    summary?: string;
+    /** 完整页面 HTML（与 Python 版 html_content 一致） */
+    rawHtml?: string;
+    /** 内容区域 HTML */
+    contentHtml?: string;
+    contentText?: string;
+    markdown?: string;
+    images?: ArticleImage[];
+    metadata: Record<string, unknown>;
+    fetchedAt: string;
+    warnings: string[];
+}
+export interface OutputArtifact {
+    type: 'json' | 'markdown' | 'html' | 'asset';
+    path: string;
+}
+export interface FetchArticleSuccess {
+    ok: true;
+    article: ArticleDraft;
+    artifacts: OutputArtifact[];
+    warnings: string[];
+}
+export interface FetchArticleAlbumSuccess {
+    ok: true;
+    articles: ArticleDraft[];
+    artifacts: OutputArtifact[];
+    warnings: string[];
+    summaryFile?: string;
+    failedCount?: number;
+}
+export interface FetchArticleFailure {
+    ok: false;
+    error: WeSpyError;
+}
+export type FetchArticleResult = FetchArticleSuccess | FetchArticleAlbumSuccess | FetchArticleFailure;
+export interface FetchAlbumSuccess {
+    ok: true;
+    articles: ArticleDraft[];
+    artifacts: OutputArtifact[];
+    warnings: string[];
+    summaryFile?: string;
+    failedCount?: number;
+}
+export interface FetchAlbumFailure {
+    ok: false;
+    error: WeSpyError;
+}
+export type FetchAlbumResult = FetchAlbumSuccess | FetchAlbumFailure;
+export declare const FetchAlbumListInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    maxArticles: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    timeoutMs: number;
+    maxArticles: number;
+}, {
+    url: string;
+    timeoutMs?: number | undefined;
+    maxArticles?: number | undefined;
+}>;
+export type FetchAlbumListInput = z.input<typeof FetchAlbumListInputSchema>;
+export interface FetchAlbumListSuccess {
+    ok: true;
+    articles: AlbumArticleEntry[];
+    warnings: string[];
+}
+export interface FetchAlbumListFailure {
+    ok: false;
+    error: WeSpyError;
+}
+export type FetchAlbumListResult = FetchAlbumListSuccess | FetchAlbumListFailure;
+export interface AlbumArticleEntry {
+    title: string;
+    url: string;
+    msgid: string;
+    createTime: string;
+    coverImg: string;
+    itemidx: string;
+    key: string;
+}
+export interface WeSpyError {
+    code: 'INVALID_INPUT' | 'UNSUPPORTED_URL' | 'NETWORK_ERROR' | 'HTTP_STATUS_ERROR' | 'PARSE_EMPTY' | 'TIMEOUT' | 'FILE_SYSTEM_ERROR' | 'UNKNOWN_ERROR';
+    message: string;
+    retryable: boolean;
+    details?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/core/types.js

@@ -0,0 +1,29 @@
+/**
+ * WeSpy 核心类型定义
+ */
+import { z } from 'zod';
+// ─── Input Schemas (zod) ────────────────────────────────────
+export const FetchArticleInputSchema = z.object({
+    url: z.string().url('URL 格式无效'),
+    outputDir: z.string().optional().default('articles'),
+    format: z.array(z.enum(['json', 'markdown', 'html'])).optional().default(['markdown']),
+    timeoutMs: z.number().int().positive().optional().default(30000),
+    userAgent: z.string().optional(),
+    headers: z.record(z.string()).optional(),
+    downloadImages: z.boolean().optional(),
+});
+export const FetchAlbumInputSchema = z.object({
+    url: z.string().url('URL 格式无效'),
+    outputDir: z.string().optional().default('articles'),
+    format: z.array(z.enum(['json', 'markdown', 'html'])).optional().default(['markdown']),
+    maxArticles: z.number().int().positive().optional().default(10),
+    timeoutMs: z.number().int().positive().optional().default(30000),
+    downloadImages: z.boolean().optional(),
+});
+// ─── Album List (仅获取列表，不下载文章) ─────────────────
+export const FetchAlbumListInputSchema = z.object({
+    url: z.string().url('URL 格式无效'),
+    maxArticles: z.number().int().positive().optional().default(10),
+    timeoutMs: z.number().int().positive().optional().default(30000),
+});
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAcvB,+DAA+D;AAE/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IACtF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAChE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;IACtF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAChE,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAA;AAsFF,iDAAiD;AAEjD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACjE,CAAC,CAAA"}

package/dist/fetcher/http-client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * HTTP 客户端封装
+ * 基于 Node 内置 fetch（18+），支持 timeout、headers、user-agent、错误分类、编码检测
+ */
+import type { Result } from '../core/result.js';
+export interface HttpResponse {
+    statusCode: number;
+    headers: Record<string, string>;
+    body: string;
+}
+export interface HttpClientOptions {
+    timeoutMs?: number;
+    userAgent?: string;
+    headers?: Record<string, string>;
+}
+export declare class HttpClient {
+    private readonly timeoutMs;
+    private readonly defaultHeaders;
+    constructor(options?: HttpClientOptions);
+    /**
+     * 发起 GET 请求
+     */
+    get(url: string, extraHeaders?: Record<string, string>): Promise<Result<HttpResponse>>;
+    /**
+     * 解码响应体，处理编码检测
+     * fetch 自动处理 gzip/brotli 解压，
+     * 只在 Content-Type 指定了非 UTF-8 charset 时才手动重新解码。
+     */
+    private decodeBody;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/fetcher/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/fetcher/http-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAG/C,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAaD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAE3C,OAAO,GAAE,iBAAsB;IAS3C;;OAEG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IA4ChC;;;;OAIG;YACW,UAAU;CAuBzB"}

package/dist/fetcher/http-client.js

@@ -0,0 +1,124 @@
+/**
+ * HTTP 客户端封装
+ * 基于 Node 内置 fetch（18+），支持 timeout、headers、user-agent、错误分类、编码检测
+ */
+import { networkError, httpStatusError, timeoutError } from '../core/errors.js';
+import { ok, err } from '../core/result.js';
+const DEFAULT_USER_AGENT = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36';
+// 不设置 Accept-Encoding，让 fetch 自行管理压缩/解压
+const DEFAULT_HEADERS = {
+    Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8',
+    'Accept-Language': 'zh-CN,zh;q=0.9,en;q=0.8',
+    Connection: 'keep-alive',
+    'Upgrade-Insecure-Requests': '1',
+};
+export class HttpClient {
+    timeoutMs;
+    defaultHeaders;
+    constructor(options = {}) {
+        this.timeoutMs = options.timeoutMs ?? 30000;
+        this.defaultHeaders = {
+            ...DEFAULT_HEADERS,
+            'User-Agent': options.userAgent ?? DEFAULT_USER_AGENT,
+            ...options.headers,
+        };
+    }
+    /**
+     * 发起 GET 请求
+     */
+    async get(url, extraHeaders) {
+        const headers = { ...this.defaultHeaders, ...extraHeaders };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers,
+                signal: controller.signal,
+            });
+            const statusCode = response.status;
+            if (statusCode >= 400) {
+                return err(httpStatusError(statusCode, url));
+            }
+            // 将 fetch headers 转为 Record<string, string>
+            const responseHeaders = {};
+            response.headers.forEach((value, key) => {
+                responseHeaders[key.toLowerCase()] = value;
+            });
+            // 检测编码并解码
+            const body = await this.decodeBody(response, responseHeaders);
+            return ok({ statusCode, headers: responseHeaders, body });
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                if (e.name === 'AbortError' || e.message.includes('abort')) {
+                    return err(timeoutError(url, this.timeoutMs));
+                }
+                if (e.name === 'TypeError' && e.message.includes('fetch')) {
+                    return err(networkError(e.message, { url, cause: e.message }));
+                }
+                return err(networkError(e.message, { url, cause: e.message }));
+            }
+            return err(networkError('Unknown network error', { url }));
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * 解码响应体，处理编码检测
+     * fetch 自动处理 gzip/brotli 解压，
+     * 只在 Content-Type 指定了非 UTF-8 charset 时才手动重新解码。
+     */
+    async decodeBody(response, headers) {
+        // 1. 从 Content-Type header 提取 charset
+        const contentType = headers['content-type'] ?? '';
+        const charset = extractCharset(contentType);
+        const encoding = normalizeEncoding(charset);
+        // 2. 如果是 UTF-8 或没有指定 charset，直接用 .text()
+        if (!encoding || encoding === 'utf-8') {
+            return await response.text();
+        }
+        // 3. 非 UTF-8 charset：用 arrayBuffer + TextDecoder 手动解码
+        try {
+            const buffer = await response.arrayBuffer();
+            const decoder = new TextDecoder(encoding);
+            return decoder.decode(buffer);
+        }
+        catch {
+            return await response.text();
+        }
+    }
+}
+/**
+ * 从 Content-Type header 提取 charset
+ * 例如: "text/html; charset=gb2312" → "gb2312"
+ * 处理重复 header: "text/html; charset=UTF-8, text/html; charset=UTF-8"
+ */
+function extractCharset(contentType) {
+    // 取第一个 content-type 值（逗号分隔时）
+    const firstPart = contentType.split(',')[0] ?? contentType;
+    const match = firstPart.match(/charset=([^\s;]+)/i);
+    return match ? match[1].trim().toLowerCase() : null;
+}
+/**
+ * 标准化编码名称，映射常见别名
+ */
+function normalizeEncoding(charset) {
+    if (!charset)
+        return null;
+    const map = {
+        'gb2312': 'gbk',
+        'gb18030': 'gbk',
+        'gbk': 'gbk',
+        'big5': 'big5',
+        'euc-kr': 'euc-kr',
+        'shift_jis': 'shift_jis',
+        'iso-8859-1': 'windows-1252',
+        'latin1': 'windows-1252',
+        'utf-8': 'utf-8',
+        'utf8': 'utf-8',
+    };
+    return map[charset] ?? charset;
+}
+//# sourceMappingURL=http-client.js.map

package/dist/fetcher/http-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * WeSpy SDK 入口
+ * 提供 fetchArticle / fetchAlbum API 供外部项目 import 使用
+ */
+export { fetchArticle } from './sdk/fetch-article.js';
+export { fetchAlbum } from './sdk/fetch-album.js';
+export { fetchAlbumList } from './sdk/fetch-album-list.js';
+export type { SupportedPlatform, OutputFormat, FetchArticleInput, FetchAlbumInput, FetchAlbumListInput, ArticleDraft, ArticleImage, OutputArtifact, FetchArticleResult, FetchArticleSuccess, FetchArticleAlbumSuccess, FetchArticleFailure, FetchAlbumResult, FetchAlbumSuccess, FetchAlbumFailure, FetchAlbumListResult, FetchAlbumListSuccess, FetchAlbumListFailure, AlbumArticleEntry, WeSpyError, } from './core/types.js';
+export { FetchArticleInputSchema, FetchAlbumInputSchema, FetchAlbumListInputSchema, } from './core/types.js';
+export type { Result } from './core/result.js';
+export { ok, err, isOk, isErr, unwrap, unwrapOr } from './core/result.js';
+export { WeSpyException, createError, networkError, httpStatusError, timeoutError, parseEmptyError, unsupportedUrlError, invalidInputError, fileSystemError, } from './core/errors.js';
+export { detectPlatform, isWechatUrl, isJuejinUrl } from './platforms/detector.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG1D,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,GACX,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAGzE,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * WeSpy SDK 入口
+ * 提供 fetchArticle / fetchAlbum API 供外部项目 import 使用
+ */
+export { fetchArticle } from './sdk/fetch-article.js';
+export { fetchAlbum } from './sdk/fetch-album.js';
+export { fetchAlbumList } from './sdk/fetch-album-list.js';
+export { FetchArticleInputSchema, FetchAlbumInputSchema, FetchAlbumListInputSchema, } from './core/types.js';
+export { ok, err, isOk, isErr, unwrap, unwrapOr } from './core/result.js';
+// 错误工厂
+export { WeSpyException, createError, networkError, httpStatusError, timeoutError, parseEmptyError, unsupportedUrlError, invalidInputError, fileSystemError, } from './core/errors.js';
+// 平台检测
+export { detectPlatform, isWechatUrl, isJuejinUrl } from './platforms/detector.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AA0B1D,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAA;AAIxB,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEzE,OAAO;AACP,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO;AACP,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/platforms/detector.d.ts

@@ -0,0 +1,15 @@
+/**
+ * URL 平台检测器
+ */
+import { detectPlatform } from '../utils/url.js';
+import type { SupportedPlatform } from '../core/types.js';
+export { detectPlatform };
+export declare function isWechatUrl(url: string): boolean;
+export declare function isWechatAlbumUrl(url: string): boolean;
+export declare function isJuejinUrl(url: string): boolean;
+/**
+ * 检测 URL 是否有效（可被 URL 解析器解析）
+ */
+export declare function isValidUrl(url: string): boolean;
+export declare function getPlatformLabel(platform: SupportedPlatform): string;
+//# sourceMappingURL=detector.d.ts.map

package/dist/platforms/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/platforms/detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,OAAO,EAAE,cAAc,EAAE,CAAA;AAEzB,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAOpE"}