w-md2docx 1.0.0

package/src/ApiServer.mjs

@@ -0,0 +1,444 @@
+import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import { execFile } from 'child_process'
+import get from 'lodash-es/get.js'
+import isstr from 'wsemi/src/isstr.mjs'
+import isestr from 'wsemi/src/isestr.mjs'
+import isbol from 'wsemi/src/isbol.mjs'
+import isobj from 'wsemi/src/isobj.mjs'
+import isp0int from 'wsemi/src/isp0int.mjs'
+import ispnum from 'wsemi/src/ispnum.mjs'
+import cint from 'wsemi/src/cint.mjs'
+import cdbl from 'wsemi/src/cdbl.mjs'
+import fsIsFile from 'wsemi/src/fsIsFile.mjs'
+import fsIsFolder from 'wsemi/src/fsIsFolder.mjs'
+import Hapi from '@hapi/hapi'
+import cvMdTo from './cvMdTo.mjs'
+import { toErrText, checkDocxReady, getQueueSize, cleanWorkDir } from './utils.mjs'
+
+
+//fdSelf (場景B: 內建模板隨模組所在資料夾, 不依啟動時之相對路徑漂移)
+let fdSelf = path.dirname(fileURLToPath(import.meta.url))
+
+
+//getWinwordCount: 取當前 WINWORD 行程數(診斷用)
+//why: 殘留之 WINWORD 行程會鎖檔並使後續轉檔失敗, 健檢時一併呈現供判斷
+function getWinwordCount() {
+    return new Promise((resolve) => {
+        if (process.platform !== 'win32') {
+            resolve(-1)
+            return
+        }
+        execFile('tasklist', ['/FI', 'IMAGENAME eq WINWORD.EXE', '/NH'], { windowsHide: true, timeout: 8000 }, (err, stdout) => {
+            if (err) {
+                resolve(-1)
+                return
+            }
+            let n = (String(stdout).match(/WINWORD\.EXE/gi) || []).length
+            resolve(n)
+        })
+    })
+}
+
+
+//toContentDisposition: 組附檔標頭(中文檔名以 RFC5987 之 filename* 提供)
+function toContentDisposition(fileName) {
+    let ascii = fileName.replace(/[^\x20-\x7E]/g, '_').replace(/"/g, '')
+    return `attachment; filename="${ascii}"; filename*=UTF-8''${encodeURIComponent(fileName)}`
+}
+
+
+//isInputError: 判斷是否為輸入面錯誤(回 400), 其餘視為轉檔或環境錯誤(回 500)
+//note: 前綴須與 cvMdTo/utils 之錯誤訊息一致
+function isInputError(msg) {
+    return /^(md is empty|asset|templateName)/.test(msg)
+}
+
+
+/**
+ * 建立並啟動Markdown轉Html/Docx之API服務
+ *
+ * 以hapi提供三個端點：GET /api/health(健康檢查與環境狀態)、GET /api/selftest(實跑一次最小轉檔驗證本機Word可用)、POST /api/convert(轉檔主端點，JSON參數同cvMdTo，另可用templateName指定服務端模板或templateBase64夾帶模板；query帶download=1時單一格式直接回傳二進位檔)。
+ *
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {Integer} [opt.port=22000] 輸入服務埠號整數，給0則由系統自動配置(實際埠號見回傳之server.info.port)，預設22000
+ * @param {String} [opt.host='0.0.0.0'] 輸入監聽位址字串，預設'0.0.0.0'
+ * @param {String} [opt.token=''] 輸入權杖字串，非空時所有/api/*須帶x-api-token標頭，預設''
+ * @param {Number} [opt.maxMb=256] 輸入請求大小上限數字，單位MB，預設256
+ * @param {String} [opt.dirTemplates=''] 輸入docx模板資料夾位置字串，未給則用本套件src/templates，預設''
+ * @param {String} [opt.dirWork=''] 輸入工作資料夾位置字串，未給則用系統暫存夾下之w-md2docx，預設''
+ * @param {String} [opt.templateDef='temp_tpc.docx'] 輸入預設模板檔名字串，預設'temp_tpc.docx'
+ * @param {Boolean} [opt.autoStart=true] 輸入是否立即啟動服務布林值，預設true
+ * @returns {Promise} 回傳Promise，resolve回傳{server,settings,getState,stop}，其中server為hapi實例，getState為取環境狀態之async函數，stop為停止服務之async函數，reject回傳錯誤訊息
+ * @example
+ *
+ * import ApiServer from 'w-md2docx/src/ApiServer.mjs'
+ *
+ * let { server, settings } = await ApiServer({
+ *     port: 22000,
+ *     token: '',
+ * })
+ * console.log(`listening on ${server.info.uri}`, settings)
+ *
+ */
+async function ApiServer(opt = {}) {
+
+    //port (0 為由系統自動配置, 供測試等場景避免撞埠; 實際埠號由 server.info.port 取得)
+    let port = get(opt, 'port', null)
+    if (!isp0int(port)) {
+        port = 22000
+    }
+    port = cint(port)
+
+    //host
+    let host = get(opt, 'host', '')
+    if (!isestr(host)) {
+        host = '0.0.0.0'
+    }
+    host = host.trim()
+
+    //token
+    let token = get(opt, 'token', '')
+    if (!isstr(token)) {
+        token = ''
+    }
+    token = token.trim()
+
+    //maxMb
+    let maxMb = get(opt, 'maxMb', null)
+    if (!ispnum(maxMb)) {
+        maxMb = 256
+    }
+    maxMb = cdbl(maxMb)
+    let maxBytes = Math.round(maxMb * 1024 * 1024)
+
+    //dirTemplates
+    let dirTemplates = get(opt, 'dirTemplates', '')
+    if (!isestr(dirTemplates)) {
+        dirTemplates = path.resolve(fdSelf, 'templates')
+    }
+    dirTemplates = path.resolve(dirTemplates)
+
+    //dirWork
+    let dirWork = get(opt, 'dirWork', '')
+    if (!isestr(dirWork)) {
+        dirWork = path.join(os.tmpdir(), 'w-md2docx')
+    }
+    dirWork = path.resolve(dirWork)
+
+    //templateDef
+    let templateDef = get(opt, 'templateDef', '')
+    if (!isestr(templateDef)) {
+        templateDef = 'temp_tpc.docx'
+    }
+    templateDef = templateDef.trim()
+
+    //autoStart
+    let autoStart = get(opt, 'autoStart', true)
+    if (!isbol(autoStart)) {
+        autoStart = true
+    }
+
+    //listTemplates: 列出可用之 docx 模板檔名
+    let listTemplates = () => {
+        if (!fsIsFolder(dirTemplates)) {
+            return []
+        }
+        return fs.readdirSync(dirTemplates).filter((v) => /\.docx$/i.test(v))
+    }
+
+    //getFpTemplateDef: 取預設模板位置(不存在則回空字串)
+    let getFpTemplateDef = () => {
+        let fp = path.resolve(dirTemplates, path.basename(templateDef))
+        return fsIsFile(fp) ? fp : ''
+    }
+
+    //pickTemplate: 決定本次使用之模板
+    //順序: 請求端夾帶(base64) > 請求指定之服務端模板名 > 服務端預設模板 > 空(交由底層自行決定)
+    //回傳 { fpInTemp, from, fpTmpDel } ; fpTmpDel 為須於用畢刪除之暫存模板檔
+    let pickTemplate = (inp) => {
+
+        //請求端夾帶
+        let b64 = get(inp, 'templateBase64', '')
+        if (!isestr(b64)) {
+            b64 = get(inp, 'template.base64', '')
+        }
+        if (isestr(b64)) {
+            b64 = b64.replace(/^data:[^;]+;base64,/, '')
+            fs.mkdirSync(dirWork, { recursive: true })
+            let fp = path.resolve(dirWork, `tmpl_${Date.now()}_${Math.random().toString(36).slice(2, 8)}.docx`)
+            fs.writeFileSync(fp, Buffer.from(b64, 'base64'))
+            return { fpInTemp: fp, from: 'request', fpTmpDel: fp }
+        }
+
+        //指定服務端模板名
+        let fn = get(inp, 'templateName', '')
+        if (isestr(fn)) {
+            fn = fn.trim()
+        }
+        else {
+            fn = ''
+        }
+        if (fn !== '') {
+            let fp = path.resolve(dirTemplates, path.basename(fn)) //basename 化, 限定取用 templates 內之檔案
+            if (!fsIsFile(fp)) {
+                throw new Error(`templateName[${fn}] does not exist (available templates: ${listTemplates().join(', ') || 'none'})`)
+            }
+            return { fpInTemp: fp, from: 'server', fpTmpDel: '' }
+        }
+
+        //服務端預設模板
+        let fpDef = getFpTemplateDef()
+        if (fpDef !== '') {
+            return { fpInTemp: fpDef, from: 'default', fpTmpDel: '' }
+        }
+
+        return { fpInTemp: '', from: 'none', fpTmpDel: '' }
+    }
+
+    //getState: 取服務環境狀態
+    let getState = async () => {
+        let rd = checkDocxReady()
+        let nWinword = await getWinwordCount()
+        return {
+            platform: rd.platform,
+            node: process.version,
+            cwd: rd.cwd,
+            exeFound: rd.exeFound,
+            exePath: rd.exePath,
+            docxReady: rd.ready, //僅代表環境具備條件, 實際 Word 可用性須以 /api/selftest 驗證
+            templateDefault: getFpTemplateDef(),
+            templates: listTemplates(),
+            dirTemplates,
+            dirWork,
+            queue: getQueueSize(),
+            winwordProcesses: nWinword,
+            maxBytes,
+            tokenRequired: token !== '',
+        }
+    }
+
+    //convertCore: 依請求內容轉檔(模板由服務端決定後交由核心處理)
+    let convertCore = async (inp) => {
+        let rTemp = pickTemplate(inp)
+        try {
+            let keepTmp = get(inp, 'keepTmp', false)
+            let keepWork = get(inp, 'keepWork', false)
+            let r = await cvMdTo({
+                md: get(inp, 'md', ''),
+                mdBase64: get(inp, 'mdBase64', ''),
+                name: get(inp, 'name', ''),
+                out: get(inp, 'out', ''),
+                assets: get(inp, 'assets', []),
+                dirWork,
+                fpInTemp: rTemp.fpInTemp,
+                optMd2html: get(inp, 'optMd2html', {}),
+                optHtml2docx: get(inp, 'optHtml2docx', {}),
+                keepWork: (keepTmp === true || keepTmp === 'true' || keepWork === true || keepWork === 'true'),
+            })
+            return {
+                success: true,
+                ...r,
+                template: rTemp.from,
+            }
+        }
+        finally {
+            //刪除本次夾帶之暫存模板
+            if (rTemp.fpTmpDel !== '' && fsIsFile(rTemp.fpTmpDel)) {
+                try {
+                    fs.unlinkSync(rTemp.fpTmpDel)
+                }
+                catch (err) {
+                    //殘檔被鎖, 留待下次清理
+                }
+            }
+        }
+    }
+
+    //清除逾時殘留之作業資料夾
+    let nClean = cleanWorkDir(dirWork)
+
+    //server
+    let server = Hapi.server({
+        port,
+        host,
+        routes: {
+            cors: true, //內網工具服務, 便於自瀏覽器或他機測試
+            payload: {
+                maxBytes,
+            },
+        },
+    })
+
+    //token 驗證(未設定時不啟用)
+    server.ext('onRequest', (req, h) => {
+        if (token === '') {
+            return h.continue
+        }
+        if (!req.path.startsWith('/api/')) {
+            return h.continue
+        }
+        let t = get(req, 'headers.x-api-token', '')
+        if (t !== token) {
+            return h.response({ success: false, error: 'unauthorized: a valid x-api-token header is required' }).code(401).takeover()
+        }
+        return h.continue
+    })
+
+    //apis
+    server.route([
+
+        {
+            //服務說明(供瀏覽器直接開啟確認服務存活)
+            method: 'GET',
+            path: '/',
+            handler: () => {
+                return {
+                    service: 'w-md2docx',
+                    description: 'API service for converting Markdown to HTML/DOCX',
+                    endpoints: {
+                        'GET /api/health': 'health check and environment state',
+                        'GET /api/selftest': 'run a minimal conversion to verify that Microsoft Word is available',
+                        'POST /api/convert': 'main conversion endpoint (JSON)',
+                    },
+                }
+            },
+        },
+
+        {
+            method: 'GET',
+            path: '/api/health',
+            handler: async () => {
+                let st = await getState()
+                return {
+                    success: true,
+                    ...st,
+                }
+            },
+        },
+
+        {
+            //實跑一次最小 md -> docx, 驗證本機 Word 確實可用(健檢僅檢查靜態條件, 無法確認 Word 能否被調用)
+            method: 'GET',
+            path: '/api/selftest',
+            handler: async (req, h) => {
+                let msStart = Date.now()
+                try {
+                    let r = await convertCore({
+                        md: '# selftest\n\nThis file is generated by the self test of the conversion service.\n',
+                        name: 'selftest',
+                        out: 'both',
+                    })
+                    return {
+                        success: true,
+                        ms: Date.now() - msStart,
+                        htmlSize: get(r, 'html.size', 0),
+                        docxSize: get(r, 'docx.size', 0),
+                        template: r.template,
+                    }
+                }
+                catch (err) {
+                    let st = await getState()
+                    return h.response({
+                        success: false,
+                        error: toErrText(err),
+                        ms: Date.now() - msStart,
+                        env: st,
+                    }).code(500)
+                }
+            },
+        },
+
+        {
+            method: 'POST',
+            path: '/api/convert',
+            options: {
+                payload: {
+                    maxBytes,
+                    parse: true,
+                    allow: 'application/json',
+                    timeout: false, //允許大檔慢速上傳
+                },
+                timeout: {
+                    socket: false, //轉檔耗時較長, 不以 socket 逾時中斷
+                },
+            },
+            handler: async (req, h) => {
+
+                let inp = req.payload
+                if (!isobj(inp)) {
+                    return h.response({ success: false, error: 'parameters must be provided as a JSON object' }).code(400)
+                }
+
+                //download: 單一格式時可直接回傳二進位檔(便於 curl -o 與瀏覽器下載)
+                //why: 不合法組合(out='both')於轉檔前即擋下, 避免先跑完耗時之 Word 轉檔才回 400
+                let qd = get(req, 'query.download', '')
+                let download = (qd === '1' || qd === 'true')
+                if (download && get(inp, 'out', '') === 'both') {
+                    return h.response({ success: false, error: 'download only supports out of html or docx (single format)' }).code(400)
+                }
+
+                try {
+
+                    let r = await convertCore(inp)
+
+                    if (download) {
+                        let one = null
+                        if (r.out === 'docx' && isobj(r.docx)) {
+                            one = r.docx
+                        }
+                        else if (r.out === 'html' && isobj(r.html)) {
+                            one = r.html
+                        }
+                        if (one === null) {
+                            return h.response({ success: false, error: 'download only supports out of html or docx (single format)' }).code(400)
+                        }
+                        return h.response(Buffer.from(one.base64, 'base64'))
+                            .type(one.mime)
+                            .header('content-disposition', toContentDisposition(one.fileName))
+                    }
+
+                    return r
+
+                }
+                catch (err) {
+                    let msg = toErrText(err)
+                    let code = isInputError(msg) ? 400 : 500
+                    return h.response({ success: false, error: msg }).code(code)
+                }
+
+            },
+        },
+
+    ])
+
+    //autoStart
+    if (autoStart) {
+        await server.start()
+    }
+
+    //定期清除逾時殘留之作業資料夾
+    let idInterval = setInterval(() => {
+        cleanWorkDir(dirWork)
+    }, 3600 * 1000)
+    idInterval.unref()
+
+    //stop
+    let stop = async () => {
+        clearInterval(idInterval)
+        await server.stop()
+    }
+
+    return {
+        server,
+        getState,
+        stop,
+        settings: { port, host, token, maxMb, maxBytes, dirTemplates, dirWork, templateDef, nClean },
+    }
+
+}
+
+
+export default ApiServer

package/src/WMd2docx.mjs

@@ -0,0 +1,29 @@
+import cvMdToDocx from './cvMdToDocx.mjs'
+import cvMdTo from './cvMdTo.mjs'
+import ApiServer from './ApiServer.mjs'
+import ApiClient from './ApiClient.mjs'
+
+
+/**
+ * Markdown轉Docx工具集
+ *
+ * 匯整四個入口：cvMdToDocx(md檔轉docx檔)、cvMdTo(md內容轉html/docx之base64)、ApiServer(hapi轉檔服務)、ApiClient(呼叫轉檔服務之用戶端)。
+ *
+ * @example
+ *
+ * import WMd2docx from 'w-md2docx/src/WMd2docx.mjs'
+ *
+ * let r = await WMd2docx.cvMdToDocx('./test/report.md', './test/report.docx')
+ * console.log(r)
+ * // => { fpOutDocx: '…', sizeDocx: 39856, sizeHtml: 12345, ms: 8342 }
+ *
+ */
+let WMd2docx = {
+    cvMdToDocx,
+    cvMdTo,
+    ApiServer,
+    ApiClient,
+}
+
+
+export default WMd2docx

package/src/cvMdTo.mjs

@@ -0,0 +1,216 @@
+import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import get from 'lodash-es/get.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import isbol from 'wsemi/src/isbol.mjs'
+import isobj from 'wsemi/src/isobj.mjs'
+import isarr from 'wsemi/src/isarr.mjs'
+import fsIsFile from 'wsemi/src/fsIsFile.mjs'
+import WMd2html from 'w-md2html/src/WMd2html.mjs'
+import cvMdToDocx from './cvMdToDocx.mjs'
+import { mimeHtml, mimeDocx, toErrText, retryBusy, toSafeName, writeAssets, transErrAsset } from './utils.mjs'
+
+
+/**
+ * Markdown內容轉Html與Docx內容
+ *
+ * 與cvMdToDocx之差異：本函數接收Markdown「內容」與其引用之資產(圖片等)，於獨立工作資料夾內還原後轉檔，完成後回傳產物之base64內容並清除工作資料夾。適用於服務端等無實體來源檔之情境；有實體md檔者請直接用cvMdToDocx。
+ *
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {String} [opt.md=''] 輸入Markdown內容字串，與mdBase64二擇一
+ * @param {String} [opt.mdBase64=''] 輸入Markdown內容之base64字串，與md二擇一
+ * @param {String} [opt.name='output'] 輸入輸出檔名主體字串(不含副檔名)，將自動移除路徑成分與非法字元，預設'output'
+ * @param {String} [opt.out='docx'] 輸入產出類型字串，可為'html'、'docx'、'both'，預設'docx'
+ * @param {Array} [opt.assets=[]] 輸入md內引用之相對路徑資產陣列，格式[{path,base64}]，預設[]
+ * @param {String} [opt.dirWork=''] 輸入工作資料夾根位置字串，未給則用系統暫存夾下之w-md2docx，預設''
+ * @param {String} [opt.fpInTemp=''] 輸入Docx模板檔位置字串，未給則由w-html2docx使用其內建模板，預設''
+ * @param {Object} [opt.optMd2html={}] 輸入傳予w-md2html之設定物件，預設{}
+ * @param {Object} [opt.optHtml2docx={}] 輸入傳予w-html2docx之設定物件，預設{}
+ * @param {Boolean} [opt.keepWork=false] 輸入是否保留工作資料夾供除錯布林值，預設false
+ * @returns {Promise} 回傳Promise，resolve回傳結果物件{name,out,ms,nAssets,[msDocx],[html],[docx]}，其中html與docx為{fileName,mime,size,base64}，reject回傳錯誤訊息
+ * @example
+ *
+ * import cvMdTo from 'w-md2docx/src/cvMdTo.mjs'
+ *
+ * let r = await cvMdTo({
+ *     md: '# 標題\n\n<img src="pics/圖.png" />',
+ *     name: '報告R00.01',
+ *     out: 'docx',
+ *     assets: [{ path: 'pics/圖.png', base64: '…' }],
+ * })
+ * console.log(r)
+ * // => { name: '報告R00.01', out: 'docx', ms: 8342, nAssets: 1, msDocx: 8300, docx: { fileName: '報告R00.01.docx', mime: '…', size: 39856, base64: '…' } }
+ *
+ */
+async function cvMdTo(opt = {}) {
+
+    let msStart = Date.now()
+
+    //out
+    let out = get(opt, 'out', '')
+    if (out !== 'html' && out !== 'docx' && out !== 'both') {
+        out = 'docx'
+    }
+    let needHtml = (out === 'html' || out === 'both')
+    let needDocx = (out === 'docx' || out === 'both')
+
+    //md
+    let md = ''
+    let mdIn = get(opt, 'md', '')
+    let mdBase64 = get(opt, 'mdBase64', '')
+    if (isestr(mdIn)) {
+        md = mdIn
+    }
+    else if (isestr(mdBase64)) {
+        md = Buffer.from(mdBase64, 'base64').toString('utf8')
+    }
+    if (md.trim() === '') {
+        return Promise.reject('md is empty: md (string) or mdBase64 is required')
+    }
+
+    //name
+    let name = toSafeName(get(opt, 'name', ''))
+
+    //assets
+    let assets = get(opt, 'assets', [])
+    if (!isarr(assets)) {
+        assets = []
+    }
+
+    //dirWork (未指定則用系統暫存夾)
+    let dirWork = get(opt, 'dirWork', '')
+    if (!isestr(dirWork)) {
+        dirWork = path.join(os.tmpdir(), 'w-md2docx')
+    }
+    dirWork = path.resolve(dirWork)
+
+    //fpInTemp (存在性由 cvMdToDocx 檢查)
+    let fpInTemp = get(opt, 'fpInTemp', '')
+    if (!isestr(fpInTemp)) {
+        fpInTemp = ''
+    }
+
+    //optMd2html
+    let optMd2html = get(opt, 'optMd2html', {})
+    if (!isobj(optMd2html)) {
+        optMd2html = {}
+    }
+
+    //optHtml2docx
+    let optHtml2docx = get(opt, 'optHtml2docx', {})
+    if (!isobj(optHtml2docx)) {
+        optHtml2docx = {}
+    }
+
+    //keepWork (除錯用, 保留工作資料夾)
+    let keepWork = get(opt, 'keepWork', false)
+    if (!isbol(keepWork)) {
+        keepWork = false
+    }
+
+    //dirJob (每次作業獨立資料夾, 使同名檔案與資產互不干擾)
+    let idJob = `${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
+    let dirJob = path.resolve(dirWork, `job_${idJob}`)
+    fs.mkdirSync(dirJob, { recursive: true })
+
+    let rt = {
+        name,
+        out,
+        ms: 0,
+        nAssets: 0,
+    }
+
+    try {
+
+        //寫入 md (資產以 md 所在資料夾為基準解析, 故兩者同置於 dirJob)
+        let fpMd = path.resolve(dirJob, `${name}.md`)
+        fs.writeFileSync(fpMd, md, 'utf8')
+
+        //寫入資產
+        try {
+            rt.nAssets = writeAssets(dirJob, assets)
+        }
+        catch (err) {
+            return Promise.reject(toErrText(err))
+        }
+
+        let fpHtml = path.resolve(dirJob, `${name}.html`)
+
+        if (needDocx) {
+
+            //md -> html -> docx (中介 html 指定產於作業夾, 供 out 含 html 時一併回傳)
+            let fpDocx = path.resolve(dirJob, `${name}.docx`)
+            let errDocx = null
+            let r = await cvMdToDocx(fpMd, fpDocx, {
+                fpInTemp,
+                fpOutHtml: fpHtml,
+                optMd2html,
+                optHtml2docx,
+            })
+                .catch((err) => {
+                    errDocx = transErrAsset(toErrText(err))
+                })
+            if (errDocx !== null) {
+                return Promise.reject(errDocx)
+            }
+
+            let buf = fs.readFileSync(fpDocx)
+            rt.docx = {
+                fileName: `${name}.docx`,
+                mime: mimeDocx,
+                size: buf.length,
+                base64: buf.toString('base64'),
+            }
+            rt.msDocx = get(r, 'ms', 0)
+
+        }
+        else {
+
+            //僅需 html, 不啟動 Word
+            let errHtml = null
+            await retryBusy(() => WMd2html(fpMd, fpHtml, optMd2html))
+                .catch((err) => {
+                    errHtml = toErrText(err)
+                })
+            if (errHtml !== null) {
+                return Promise.reject(transErrAsset(`Failed to convert md to html: ${errHtml}`))
+            }
+            if (!fsIsFile(fpHtml) || fs.statSync(fpHtml).size === 0) {
+                return Promise.reject('Failed to convert md to html: html was not generated or is empty')
+            }
+
+        }
+
+        if (needHtml) {
+            let buf = fs.readFileSync(fpHtml)
+            rt.html = {
+                fileName: `${name}.html`,
+                mime: mimeHtml,
+                size: buf.length,
+                base64: buf.toString('base64'),
+            }
+        }
+
+        rt.ms = Date.now() - msStart
+        return rt
+
+    }
+    finally {
+
+        //清除作業資料夾(除錯模式保留)
+        if (!keepWork) {
+            try {
+                fs.rmSync(dirJob, { recursive: true, force: true })
+            }
+            catch (err) {
+                //殘檔被鎖, 留待下次清理
+            }
+        }
+
+    }
+
+}
+
+
+export default cvMdTo