markdown-to-mfuns-json 1.0.0

package/dist/upload.cjs

@@ -0,0 +1,226 @@
+/**
+ * 喵御宅（Mfuns）图片上传模块
+ */
+const MFUNS_API_BASE = 'https://api.mfuns.net';
+const MAX_IMAGE_SIZE = 20 * 1024 * 1024; // 20MB
+const CONCURRENT_UPLOADS = 3; // 并发数
+/** 支持的图片 MIME 类型 */
+const SUPPORTED_IMAGE_TYPES = [
+    'image/jpeg',
+    'image/png',
+    'image/gif',
+    'image/webp',
+    'image/bmp',
+    'image/svg+xml',
+];
+/** 支持的图片扩展名（用于检测 URL） */
+const SUPPORTED_IMAGE_EXTS = /\.(jpg|jpeg|png|gif|webp|bmp|svg)(\?.*)?$/i;
+/**
+ * 检测是否为图片 URL
+ */
+function isImageUrl(url) {
+    return SUPPORTED_IMAGE_EXTS.test(url);
+}
+/**
+ * 检测是否为 base64 图片
+ */
+function isBase64Image(url) {
+    return /^data:image\/(png|jpe?g|gif|webp|bmp|svg\+xml);base64,/i.test(url);
+}
+/**
+ * 从 base64 创建 File 对象
+ */
+function base64ToFile(base64, filename) {
+    const match = base64.match(/^data:(image\/\w+(?:\+xml)?);base64,(.+)$/);
+    if (!match) {
+        throw new Error('Invalid base64 image format');
+    }
+    const mimeType = match[1];
+    const base64Data = match[2];
+    const byteString = atob(base64Data);
+    const ab = new ArrayBuffer(byteString.length);
+    const ia = new Uint8Array(ab);
+    for (let i = 0; i < byteString.length; i++) {
+        ia[i] = byteString.charCodeAt(i);
+    }
+    const blob = new Blob([ab], { type: mimeType });
+    const ext = mimeType.replace('image/', '').replace('+xml', '');
+    const name = filename || `image.${ext}`;
+    return new File([blob], name, { type: mimeType });
+}
+/**
+ * 下载网络图片
+ */
+async function downloadImage(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download image: ${response.status} ${response.statusText}`);
+    }
+    const contentType = response.headers.get('content-type');
+    if (contentType && !SUPPORTED_IMAGE_TYPES.some(t => contentType.includes(t))) {
+        throw new Error(`Unsupported image type: ${contentType}`);
+    }
+    const blob = await response.blob();
+    if (blob.size > MAX_IMAGE_SIZE) {
+        throw new Error(`Image size exceeds 20MB limit: ${(blob.size / 1024 / 1024).toFixed(2)}MB`);
+    }
+    // 从 URL 提取文件名
+    const urlObj = new URL(url);
+    const pathname = urlObj.pathname;
+    const filename = pathname.substring(pathname.lastIndexOf('/') + 1) || 'image.jpg';
+    return new File([blob], filename, { type: blob.type || 'image/jpeg' });
+}
+/**
+ * 上传单个图片到喵御宅服务器
+ */
+export async function uploadImageToMfuns(file, options) {
+    if (file.size > MAX_IMAGE_SIZE) {
+        throw new Error(`Image size exceeds 20MB limit: ${(file.size / 1024 / 1024).toFixed(2)}MB`);
+    }
+    const formData = new FormData();
+    formData.append('file', file);
+    const headers = {
+        Authorization: options.token,
+    };
+    if (options.deviceInfo) {
+        const { clientType, deviceId, osName, osVersion, deviceModel } = options.deviceInfo;
+        if (clientType)
+            headers['X-Client-Type'] = clientType;
+        if (deviceId)
+            headers['X-Device-Id'] = deviceId;
+        if (osName)
+            headers['X-OS-Name'] = osName;
+        if (osVersion)
+            headers['X-OS-Version'] = osVersion;
+        if (deviceModel)
+            headers['X-Device-Model'] = deviceModel;
+    }
+    const response = await fetch(`${MFUNS_API_BASE}/v1/media/upload_image`, {
+        method: 'POST',
+        headers,
+        body: formData,
+    });
+    if (!response.ok) {
+        throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
+    }
+    const result = await response.json();
+    if (result.code !== 1) {
+        throw new Error(`Upload failed: ${result.msg || 'Unknown error'}`);
+    }
+    return result.data.file.file_path;
+}
+/**
+ * 处理图片 URL（下载/转换 + 上传）
+ */
+export async function processImageUrl(url, options) {
+    // 没有 token，检查是否需要上传
+    if (!options?.token) {
+        if (isBase64Image(url)) {
+            throw new Error('Base64 images must be uploaded to Mfuns server. ' +
+                'Please provide a token in options.');
+        }
+        // 网络图片保留原 URL
+        return url;
+    }
+    // 有 token，处理上传
+    let file;
+    if (isBase64Image(url)) {
+        file = base64ToFile(url);
+    }
+    else if (isImageUrl(url)) {
+        file = await downloadImage(url);
+    }
+    else {
+        // 不是图片 URL，原样返回
+        return url;
+    }
+    return uploadImageToMfuns(file, options);
+}
+/**
+ * 并发控制处理器
+ */
+export class ConcurrentProcessor {
+    constructor(processor, concurrency) {
+        this.processor = processor;
+        this.concurrency = concurrency;
+        this.queue = [];
+        this.running = 0;
+        this.results = new Map();
+    }
+    async process(items) {
+        return new Promise((resolve, reject) => {
+            let completed = 0;
+            let hasError = false;
+            const checkComplete = () => {
+                if (hasError)
+                    return;
+                if (completed === items.length) {
+                    const ordered = items.map((_, i) => this.results.get(i));
+                    resolve(ordered);
+                }
+            };
+            const runNext = () => {
+                if (hasError)
+                    return;
+                while (this.running < this.concurrency && this.queue.length > 0) {
+                    const task = this.queue.shift();
+                    this.running++;
+                    // 找到这个 task 对应的 index
+                    const index = items.indexOf(task.item);
+                    this.processor(task.item, index)
+                        .then((result) => {
+                        if (hasError)
+                            return;
+                        this.results.set(index, result);
+                        task.resolve(result);
+                    })
+                        .catch((error) => {
+                        if (hasError)
+                            return;
+                        hasError = true;
+                        task.reject(error);
+                        reject(error);
+                    })
+                        .finally(() => {
+                        this.running--;
+                        completed++;
+                        checkComplete();
+                        runNext();
+                    });
+                }
+            };
+            // 将任务加入队列
+            items.forEach((item) => {
+                new Promise((res, rej) => {
+                    this.queue.push({ item, resolve: res, reject: rej });
+                });
+            });
+            runNext();
+        });
+    }
+}
+/**
+ * 批量处理图片 URL
+ */
+export async function processImageUrls(urls, options, onError) {
+    const processor = new ConcurrentProcessor(async (url) => {
+        try {
+            return await processImageUrl(url, options);
+        }
+        catch (error) {
+            if (onError) {
+                const action = onError(error, url);
+                if (action === 'skip') {
+                    return '';
+                }
+                else if (action === 'keep-original') {
+                    return url;
+                }
+            }
+            throw error;
+        }
+    }, CONCURRENT_UPLOADS);
+    return processor.process(urls);
+}
+
+module.exports = { isImageUrl, isBase64Image, base64ToFile, downloadImage, uploadImageToMfuns, processImageUrl, processImageUrls };

package/dist/upload.d.mts

@@ -0,0 +1,51 @@
+/**
+ * 喵御宅（Mfuns）图片上传模块
+ */
+/** 设备信息 */
+export interface DeviceInfo {
+    clientType?: string;
+    deviceId?: string;
+    osName?: string;
+    osVersion?: string;
+    deviceModel?: string;
+}
+/** 上传配置 */
+export interface UploadOptions {
+    /** Redis session token（必填，否则无法上传） */
+    token: string;
+    /** 可选设备信息 */
+    deviceInfo?: DeviceInfo;
+}
+/**
+ * 检测是否为图片 URL
+ */
+export declare function isImageUrl(url: string): boolean;
+/**
+ * 检测是否为 base64 图片
+ */
+export declare function isBase64Image(url: string): boolean;
+/**
+ * 上传单个图片到喵御宅服务器
+ */
+export declare function uploadImageToMfuns(file: File, options: UploadOptions): Promise<string>;
+/**
+ * 处理图片 URL（下载/转换 + 上传）
+ */
+export declare function processImageUrl(url: string, options?: UploadOptions): Promise<string>;
+/**
+ * 并发控制处理器
+ */
+export declare class ConcurrentProcessor<T, R> {
+    private processor;
+    private concurrency;
+    private queue;
+    private running;
+    private results;
+    constructor(processor: (item: T, index: number) => Promise<R>, concurrency: number);
+    process(items: T[]): Promise<R[]>;
+}
+/**
+ * 批量处理图片 URL
+ */
+export declare function processImageUrls(urls: string[], options?: UploadOptions, onError?: (error: Error, url: string) => 'throw' | 'skip' | 'keep-original'): Promise<string[]>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 喵御宅（Mfuns）图片上传模块
+ */
+/** 设备信息 */
+export interface DeviceInfo {
+    clientType?: string;
+    deviceId?: string;
+    osName?: string;
+    osVersion?: string;
+    deviceModel?: string;
+}
+/** 上传配置 */
+export interface UploadOptions {
+    /** Redis session token（必填，否则无法上传） */
+    token: string;
+    /** 可选设备信息 */
+    deviceInfo?: DeviceInfo;
+}
+/**
+ * 检测是否为图片 URL
+ */
+export declare function isImageUrl(url: string): boolean;
+/**
+ * 检测是否为 base64 图片
+ */
+export declare function isBase64Image(url: string): boolean;
+/**
+ * 上传单个图片到喵御宅服务器
+ */
+export declare function uploadImageToMfuns(file: File, options: UploadOptions): Promise<string>;
+/**
+ * 处理图片 URL（下载/转换 + 上传）
+ */
+export declare function processImageUrl(url: string, options?: UploadOptions): Promise<string>;
+/**
+ * 并发控制处理器
+ */
+export declare class ConcurrentProcessor<T, R> {
+    private processor;
+    private concurrency;
+    private queue;
+    private running;
+    private results;
+    constructor(processor: (item: T, index: number) => Promise<R>, concurrency: number);
+    process(items: T[]): Promise<R[]>;
+}
+/**
+ * 批量处理图片 URL
+ */
+export declare function processImageUrls(urls: string[], options?: UploadOptions, onError?: (error: Error, url: string) => 'throw' | 'skip' | 'keep-original'): Promise<string[]>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAeD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAwDD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;GAEG;AACH,qBAAa,mBAAmB,CAAC,CAAC,EAAE,CAAC;IAMjC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,WAAW;IANrB,OAAO,CAAC,KAAK,CAAmF;IAChG,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAwB;gBAG7B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACjD,WAAW,EAAE,MAAM;IAGvB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAsDxC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,GAAG,eAAe,GAC1E,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnB"}

package/dist/upload.mjs

@@ -0,0 +1,224 @@
+/**
+ * 喵御宅（Mfuns）图片上传模块
+ */
+const MFUNS_API_BASE = 'https://api.mfuns.net';
+const MAX_IMAGE_SIZE = 20 * 1024 * 1024; // 20MB
+const CONCURRENT_UPLOADS = 3; // 并发数
+/** 支持的图片 MIME 类型 */
+const SUPPORTED_IMAGE_TYPES = [
+    'image/jpeg',
+    'image/png',
+    'image/gif',
+    'image/webp',
+    'image/bmp',
+    'image/svg+xml',
+];
+/** 支持的图片扩展名（用于检测 URL） */
+const SUPPORTED_IMAGE_EXTS = /\.(jpg|jpeg|png|gif|webp|bmp|svg)(\?.*)?$/i;
+/**
+ * 检测是否为图片 URL
+ */
+export function isImageUrl(url) {
+    return SUPPORTED_IMAGE_EXTS.test(url);
+}
+/**
+ * 检测是否为 base64 图片
+ */
+export function isBase64Image(url) {
+    return /^data:image\/(png|jpe?g|gif|webp|bmp|svg\+xml);base64,/i.test(url);
+}
+/**
+ * 从 base64 创建 File 对象
+ */
+function base64ToFile(base64, filename) {
+    const match = base64.match(/^data:(image\/\w+(?:\+xml)?);base64,(.+)$/);
+    if (!match) {
+        throw new Error('Invalid base64 image format');
+    }
+    const mimeType = match[1];
+    const base64Data = match[2];
+    const byteString = atob(base64Data);
+    const ab = new ArrayBuffer(byteString.length);
+    const ia = new Uint8Array(ab);
+    for (let i = 0; i < byteString.length; i++) {
+        ia[i] = byteString.charCodeAt(i);
+    }
+    const blob = new Blob([ab], { type: mimeType });
+    const ext = mimeType.replace('image/', '').replace('+xml', '');
+    const name = filename || `image.${ext}`;
+    return new File([blob], name, { type: mimeType });
+}
+/**
+ * 下载网络图片
+ */
+async function downloadImage(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download image: ${response.status} ${response.statusText}`);
+    }
+    const contentType = response.headers.get('content-type');
+    if (contentType && !SUPPORTED_IMAGE_TYPES.some(t => contentType.includes(t))) {
+        throw new Error(`Unsupported image type: ${contentType}`);
+    }
+    const blob = await response.blob();
+    if (blob.size > MAX_IMAGE_SIZE) {
+        throw new Error(`Image size exceeds 20MB limit: ${(blob.size / 1024 / 1024).toFixed(2)}MB`);
+    }
+    // 从 URL 提取文件名
+    const urlObj = new URL(url);
+    const pathname = urlObj.pathname;
+    const filename = pathname.substring(pathname.lastIndexOf('/') + 1) || 'image.jpg';
+    return new File([blob], filename, { type: blob.type || 'image/jpeg' });
+}
+/**
+ * 上传单个图片到喵御宅服务器
+ */
+export async function uploadImageToMfuns(file, options) {
+    if (file.size > MAX_IMAGE_SIZE) {
+        throw new Error(`Image size exceeds 20MB limit: ${(file.size / 1024 / 1024).toFixed(2)}MB`);
+    }
+    const formData = new FormData();
+    formData.append('file', file);
+    const headers = {
+        Authorization: options.token,
+    };
+    if (options.deviceInfo) {
+        const { clientType, deviceId, osName, osVersion, deviceModel } = options.deviceInfo;
+        if (clientType)
+            headers['X-Client-Type'] = clientType;
+        if (deviceId)
+            headers['X-Device-Id'] = deviceId;
+        if (osName)
+            headers['X-OS-Name'] = osName;
+        if (osVersion)
+            headers['X-OS-Version'] = osVersion;
+        if (deviceModel)
+            headers['X-Device-Model'] = deviceModel;
+    }
+    const response = await fetch(`${MFUNS_API_BASE}/v1/media/upload_image`, {
+        method: 'POST',
+        headers,
+        body: formData,
+    });
+    if (!response.ok) {
+        throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
+    }
+    const result = await response.json();
+    if (result.code !== 1) {
+        throw new Error(`Upload failed: ${result.msg || 'Unknown error'}`);
+    }
+    return result.data.file.file_path;
+}
+/**
+ * 处理图片 URL（下载/转换 + 上传）
+ */
+export async function processImageUrl(url, options) {
+    // 没有 token，检查是否需要上传
+    if (!options?.token) {
+        if (isBase64Image(url)) {
+            throw new Error('Base64 images must be uploaded to Mfuns server. ' +
+                'Please provide a token in options.');
+        }
+        // 网络图片保留原 URL
+        return url;
+    }
+    // 有 token，处理上传
+    let file;
+    if (isBase64Image(url)) {
+        file = base64ToFile(url);
+    }
+    else if (isImageUrl(url)) {
+        file = await downloadImage(url);
+    }
+    else {
+        // 不是图片 URL，原样返回
+        return url;
+    }
+    return uploadImageToMfuns(file, options);
+}
+/**
+ * 并发控制处理器
+ */
+export class ConcurrentProcessor {
+    constructor(processor, concurrency) {
+        this.processor = processor;
+        this.concurrency = concurrency;
+        this.queue = [];
+        this.running = 0;
+        this.results = new Map();
+    }
+    async process(items) {
+        return new Promise((resolve, reject) => {
+            let completed = 0;
+            let hasError = false;
+            const checkComplete = () => {
+                if (hasError)
+                    return;
+                if (completed === items.length) {
+                    const ordered = items.map((_, i) => this.results.get(i));
+                    resolve(ordered);
+                }
+            };
+            const runNext = () => {
+                if (hasError)
+                    return;
+                while (this.running < this.concurrency && this.queue.length > 0) {
+                    const task = this.queue.shift();
+                    this.running++;
+                    // 找到这个 task 对应的 index
+                    const index = items.indexOf(task.item);
+                    this.processor(task.item, index)
+                        .then((result) => {
+                        if (hasError)
+                            return;
+                        this.results.set(index, result);
+                        task.resolve(result);
+                    })
+                        .catch((error) => {
+                        if (hasError)
+                            return;
+                        hasError = true;
+                        task.reject(error);
+                        reject(error);
+                    })
+                        .finally(() => {
+                        this.running--;
+                        completed++;
+                        checkComplete();
+                        runNext();
+                    });
+                }
+            };
+            // 将任务加入队列
+            items.forEach((item) => {
+                new Promise((res, rej) => {
+                    this.queue.push({ item, resolve: res, reject: rej });
+                });
+            });
+            runNext();
+        });
+    }
+}
+/**
+ * 批量处理图片 URL
+ */
+export async function processImageUrls(urls, options, onError) {
+    const processor = new ConcurrentProcessor(async (url) => {
+        try {
+            return await processImageUrl(url, options);
+        }
+        catch (error) {
+            if (onError) {
+                const action = onError(error, url);
+                if (action === 'skip') {
+                    return '';
+                }
+                else if (action === 'keep-original') {
+                    return url;
+                }
+            }
+            throw error;
+        }
+    }, CONCURRENT_UPLOADS);
+    return processor.process(urls);
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "markdown-to-mfuns-json",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "将 Markdown 转换为喵御宅（Mfuns）定制的 Quill Delta JSON 格式",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/build.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "markdown",
+    "quill",
+    "delta",
+    "mfuns",
+    "喵御宅",
+    "json"
+  ],
+  "author": "Amoyens1s <amoyensis@outlook.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}