w-md2docx 1.0.0

package/test/unit-cvMdTo.test.mjs

@@ -0,0 +1,132 @@
+import fs from 'fs'
+import path from 'path'
+import assert from 'assert'
+import cvMdTo from '../src/cvMdTo.mjs'
+
+
+//cvMdTo之html路徑(不需Microsoft Word); docx路徑於unit-cvMdToDocx以Word守門測試
+describe('cvMdTo', function() {
+
+    let fdTmp = path.resolve('./tmp/zt_cvMdTo')
+    let svgB64 = fs.readFileSync('./test/cocktail.svg').toString('base64')
+    let toHtml = (r) => Buffer.from(r.html.base64, 'base64').toString('utf8')
+
+    before(function() {
+        fs.mkdirSync(fdTmp, { recursive: true })
+    })
+
+    after(function() {
+        fs.rmSync(fdTmp, { recursive: true, force: true })
+    })
+
+    it('out=html: 回傳物件形狀與檔名', async function() {
+        let r = await cvMdTo({ md: '# 標題A\n\n內文B', name: '報告R00.01', out: 'html' })
+        assert.strict.equal(r.name, '報告R00.01')
+        assert.strict.equal(r.out, 'html')
+        assert.strict.equal(r.nAssets, 0)
+        assert.strict.equal(typeof r.ms, 'number')
+        assert.strict.equal(r.docx, undefined)
+        assert.strict.equal(r.html.fileName, '報告R00.01.html')
+        assert.strict.equal(r.html.mime, 'text/html; charset=utf-8')
+        assert.strict.equal(r.html.size, Buffer.from(r.html.base64, 'base64').length)
+        let h = toHtml(r)
+        assert.strict.equal(h.includes('標題A'), true)
+        assert.strict.equal(h.includes('內文B'), true)
+        assert.strict.equal(h.includes('<title>報告R00.01</title>'), true) //title取自md檔名(=name)
+    })
+
+    it('name含路徑與非法字元時被清理', async function() {
+        let r = await cvMdTo({ md: '# t', name: '../a/b:c.md', out: 'html' })
+        assert.strict.equal(r.name, 'b_c')
+        assert.strict.equal(r.html.fileName, 'b_c.html')
+    })
+
+    it('name未給則為output', async function() {
+        let r = await cvMdTo({ md: '# t', out: 'html' })
+        assert.strict.equal(r.name, 'output')
+    })
+
+    it('mdBase64可替代md', async function() {
+        let r = await cvMdTo({ mdBase64: Buffer.from('# 由b64', 'utf8').toString('base64'), out: 'html' })
+        assert.strict.equal(toHtml(r).includes('由b64'), true)
+    })
+
+    it('md優先於mdBase64', async function() {
+        let r = await cvMdTo({ md: '# 主', mdBase64: Buffer.from('# 副', 'utf8').toString('base64'), out: 'html' })
+        let h = toHtml(r)
+        assert.strict.equal(h.includes('主'), true)
+        assert.strict.equal(h.includes('副'), false)
+    })
+
+    it('md為空(未給/空白/非字串)則reject', async function() {
+        let msg = 'md is empty: md (string) or mdBase64 is required'
+        await assert.rejects(cvMdTo({ out: 'html' }), (e) => e === msg)
+        await assert.rejects(cvMdTo({ md: '   \n', out: 'html' }), (e) => e === msg)
+        await assert.rejects(cvMdTo({ md: 123, out: 'html' }), (e) => e === msg)
+        await assert.rejects(cvMdTo(), (e) => e === msg)
+    })
+
+    it('資產: 以md內原字串為path, 同時支援markdown圖與<img>之URL編碼引用, 圖片內嵌為base64', async function() {
+        let r = await cvMdTo({
+            md: '# t\n\n![p](pics/圖.svg)\n\n<img src="pics/%E5%9C%96.svg" />',
+            out: 'html',
+            assets: [{ path: 'pics/%E5%9C%96.svg', base64: svgB64 }],
+        })
+        assert.strict.equal(r.nAssets, 1)
+        let h = toHtml(r)
+        assert.strict.equal((h.match(/src="data:image\/png;base64,/g) || []).length, 2)
+        assert.strict.equal(h.includes('pics/'), false) //相對路徵已全數替換
+    })
+
+    it('資產: assets非陣列視為無資產', async function() {
+        let r = await cvMdTo({ md: '# t', out: 'html', assets: 'x' })
+        assert.strict.equal(r.nAssets, 0)
+    })
+
+    it('資產缺漏(<img>引用): 英文可行動訊息且不含工作夾路徑', async function() {
+        await assert.rejects(cvMdTo({ md: '# t\n\n<img src="pics/no.png" />', out: 'html' }), (e) => {
+            assert.strict.equal(e, 'Failed to convert md to html: the referenced file (pics/no.png) does not exist, please make sure it is included in assets')
+            return true
+        })
+    })
+
+    it('資產穿越/絕對路徑/空base64: 以asset開頭之訊息reject', async function() {
+        await assert.rejects(cvMdTo({ md: '# t', out: 'html', assets: [{ path: '../x.png', base64: 'QUI=' }] }), (e) => e === 'asset.path is outside the working folder: ../x.png')
+        await assert.rejects(cvMdTo({ md: '# t', out: 'html', assets: [{ path: 'C:/x.png', base64: 'QUI=' }] }), (e) => e === 'asset.path must be a relative path: C:/x.png')
+        await assert.rejects(cvMdTo({ md: '# t', out: 'html', assets: [{ path: 'x.png' }] }), (e) => e === 'asset.base64 is empty: x.png')
+    })
+
+    it('optMd2html傳遞至w-md2html(imgWidthMax)', async function() {
+        let r = await cvMdTo({
+            md: '![p](pics/a.svg)',
+            out: 'html',
+            assets: [{ path: 'pics/a.svg', base64: svgB64 }],
+            optMd2html: { imgWidthMax: '123px' },
+        })
+        assert.strict.equal(/max-width:\s*123px/.test(toHtml(r)), true)
+    })
+
+    it('dirWork指定則作業夾建於其下; keepWork=true保留, false清除', async function() {
+        let dirWork = path.resolve(fdTmp, 'work')
+        await cvMdTo({ md: '# t', out: 'html', dirWork, keepWork: true })
+        let jobs = fs.readdirSync(dirWork).filter((v) => v.startsWith('job_'))
+        assert.strict.equal(jobs.length, 1)
+        assert.strict.equal(fs.existsSync(path.resolve(dirWork, jobs[0], 'output.md')), true)
+        assert.strict.equal(fs.existsSync(path.resolve(dirWork, jobs[0], 'output.html')), true)
+        await cvMdTo({ md: '# t', out: 'html', dirWork })
+        assert.strict.equal(fs.readdirSync(dirWork).filter((v) => v.startsWith('job_')).length, 1) //僅前一次保留者
+    })
+
+    it('keepWork非布林值視為false', async function() {
+        let dirWork = path.resolve(fdTmp, 'work2')
+        await cvMdTo({ md: '# t', out: 'html', dirWork, keepWork: 'true' })
+        assert.strict.equal(fs.readdirSync(dirWork).filter((v) => v.startsWith('job_')).length, 0)
+    })
+
+    it('失敗時作業夾仍被清除', async function() {
+        let dirWork = path.resolve(fdTmp, 'work3')
+        await assert.rejects(cvMdTo({ md: '# t\n\n<img src="no.png" />', out: 'html', dirWork }))
+        assert.strict.equal(fs.readdirSync(dirWork).filter((v) => v.startsWith('job_')).length, 0)
+    })
+
+})

package/test/unit-cvMdToDocx.test.mjs

@@ -0,0 +1,185 @@
+import fs from 'fs'
+import path from 'path'
+import zlib from 'zlib'
+import { execFileSync } from 'child_process'
+import assert from 'assert'
+import cvMdToDocx from '../src/cvMdToDocx.mjs'
+import cvMdTo from '../src/cvMdTo.mjs'
+import { getFpExe } from '../src/utils.mjs'
+
+
+//hasWord: 本機是否可調用 Microsoft Word(Windows + Word.Application COM 已註冊 + htmlToDocx.exe 存在)
+//why: docx 階段須真 Word, 無 Word 之機器僅測輸入檢查, 實轉區塊整段略過(同 w-html2docx 之 isWindows 守門)
+function hasWord() {
+    if (process.platform !== 'win32') {
+        return false
+    }
+    if (getFpExe() === '') {
+        return false
+    }
+    try {
+        execFileSync('reg', ['query', 'HKCR\\Word.Application'], { stdio: 'ignore', windowsHide: true })
+        return true
+    }
+    catch (err) {
+        return false
+    }
+}
+
+
+//readZipEntries: 讀取zip(docx)內各檔案, 回傳{name:Buffer}
+//why: 以central directory解析, 不引入額外套件; docx為標準deflate/stored, 無zip64
+function readZipEntries(buf) {
+    let iE = buf.lastIndexOf(Buffer.from([0x50, 0x4b, 0x05, 0x06]))
+    assert.strict.ok(iE >= 0, 'zip end of central directory not found')
+    let nEntries = buf.readUInt16LE(iE + 10)
+    let p = buf.readUInt32LE(iE + 16)
+    let kp = {}
+    for (let i = 0; i < nEntries; i++) {
+        assert.strict.equal(buf.readUInt32LE(p), 0x02014b50, 'central directory header signature')
+        let method = buf.readUInt16LE(p + 10)
+        let compSize = buf.readUInt32LE(p + 20)
+        let nameLen = buf.readUInt16LE(p + 28)
+        let extraLen = buf.readUInt16LE(p + 30)
+        let commentLen = buf.readUInt16LE(p + 32)
+        let offLocal = buf.readUInt32LE(p + 42)
+        let name = buf.toString('utf8', p + 46, p + 46 + nameLen)
+        let lNameLen = buf.readUInt16LE(offLocal + 26)
+        let lExtraLen = buf.readUInt16LE(offLocal + 28)
+        let start = offLocal + 30 + lNameLen + lExtraLen
+        let data = buf.subarray(start, start + compSize)
+        kp[name] = (method === 8) ? zlib.inflateRawSync(data) : Buffer.from(data)
+        p += 46 + nameLen + extraLen + commentLen
+    }
+    return kp
+}
+
+
+describe('cvMdToDocx 輸入檢查(不需Word)', function() {
+
+    it('fpInMd非有效字串', async function() {
+        await assert.rejects(cvMdToDocx('', './tmp/x.docx'), (e) => e === 'fpInMd must be a non-empty string')
+        await assert.rejects(cvMdToDocx(null, './tmp/x.docx'), (e) => e === 'fpInMd must be a non-empty string')
+    })
+
+    it('fpInMd不存在', async function() {
+        await assert.rejects(cvMdToDocx('./test/nope.md', './tmp/x.docx'), (e) => /^fpInMd\[.+nope\.md\] does not exist$/.test(e))
+    })
+
+    it('fpOutDocx非有效字串', async function() {
+        await assert.rejects(cvMdToDocx('./test/report.md', ''), (e) => e === 'fpOutDocx must be a non-empty string')
+    })
+
+    it('fpInTemp不存在', async function() {
+        await assert.rejects(cvMdToDocx('./test/report.md', './tmp/x.docx', { fpInTemp: './test/nope.docx' }), (e) => /^fpInTemp\[.+nope\.docx\] does not exist$/.test(e))
+    })
+
+})
+
+
+describe('cvMdToDocx 實轉(需Windows+Microsoft Word)', function() {
+
+    //check
+    if (!hasWord()) {
+        console.log('[unit-cvMdToDocx] Microsoft Word not available on this machine, skip real conversion tests')
+        return
+    }
+
+    let fdTmp = path.resolve('./tmp/zt_cvMdToDocx')
+    let fpIn = './test/report.md'
+    let fpOut = path.resolve(fdTmp, 'report.docx')
+    let fpOutHtml = path.resolve(fdTmp, 'report.html')
+    let fpInTemp = './src/templates/temp_tpc.docx'
+    let rt = null
+    let zip = null
+    let xml = ''
+
+    before(async function() {
+        this.timeout(180000)
+        fs.mkdirSync(fdTmp, { recursive: true })
+        rt = await cvMdToDocx(fpIn, fpOut, {
+            fpInTemp,
+            fpOutHtml,
+            optMd2html: { imgWidthMax: '500px' },
+            optHtml2docx: { imgRatioWidthMax: 0.5 },
+        })
+        zip = readZipEntries(fs.readFileSync(fpOut))
+        xml = zip['word/document.xml'].toString('utf8')
+    })
+
+    after(function() {
+        fs.rmSync(fdTmp, { recursive: true, force: true })
+    })
+
+    it('回傳物件: fpOutDocx/sizeDocx/sizeHtml/ms/fpOutHtml與實體檔一致', function() {
+        assert.strict.equal(rt.fpOutDocx, fpOut)
+        assert.strict.equal(rt.sizeDocx, fs.statSync(fpOut).size)
+        assert.strict.equal(rt.sizeDocx > 0, true)
+        assert.strict.equal(rt.fpOutHtml, fpOutHtml)
+        assert.strict.equal(rt.sizeHtml, fs.statSync(fpOutHtml).size)
+        assert.strict.equal(typeof rt.ms, 'number')
+    })
+
+    it('docx為zip且含主文件', function() {
+        assert.strict.equal(fs.readFileSync(fpOut).subarray(0, 2).toString('latin1'), 'PK')
+        assert.strict.equal(typeof zip['word/document.xml'], 'object')
+        assert.strict.equal(typeof zip['[Content_Types].xml'], 'object')
+    })
+
+    it('主文件含來源md之標題與清單文字', function() {
+        assert.strict.equal(xml.includes('計畫報告'), true) //h1
+        assert.strict.equal(xml.includes('資料流程自動化'), true) //li
+    })
+
+    it('內文圖片已嵌入(word/media)', function() {
+        let medias = Object.keys(zip).filter((v) => v.startsWith('word/media/'))
+        assert.strict.equal(medias.length > 0, true)
+    })
+
+    it('模板settings之doNotAutoCompressPictures保留', function() {
+        let settings = zip['word/settings.xml'].toString('utf8')
+        assert.strict.equal(settings.includes('<w:doNotAutoCompressPictures'), true)
+    })
+
+    it('未指定fpOutHtml時不留中介檔, 回傳無fpOutHtml', async function() {
+        this.timeout(180000)
+        let fpOut2 = path.resolve(fdTmp, 'report2.docx')
+        let r = await cvMdToDocx(fpIn, fpOut2, { fpInTemp })
+        assert.strict.equal(r.fpOutHtml, undefined)
+        assert.strict.equal(fs.existsSync(fpOut2), true)
+        assert.strict.equal(fs.existsSync(fpOut2.replace(/\.docx$/, '.html')), false)
+    })
+
+    it('並發兩份轉檔皆成功(內部佇列序列化)', async function() {
+        this.timeout(300000)
+        let [ra, rb] = await Promise.all([
+            cvMdToDocx(fpIn, path.resolve(fdTmp, 'a.docx'), { fpInTemp }),
+            cvMdToDocx(fpIn, path.resolve(fdTmp, 'b.docx'), { fpInTemp }),
+        ])
+        assert.strict.equal(ra.sizeDocx > 0, true)
+        assert.strict.equal(rb.sizeDocx > 0, true)
+    })
+
+    it('cvMdTo out非法值(如大小寫不符)退回docx', async function() {
+        this.timeout(180000)
+        let r = await cvMdTo({ md: '# t', out: 'HTML', fpInTemp, dirWork: fdTmp })
+        assert.strict.equal(r.out, 'docx')
+        assert.strict.equal(r.html, undefined)
+        assert.strict.equal(r.docx.size > 0, true)
+    })
+
+    it('cvMdTo out=both: html與docx內容皆回傳且msDocx存在', async function() {
+        this.timeout(180000)
+        let r = await cvMdTo({ md: '# 內容轉檔\n\n段落', name: '內容', out: 'both', fpInTemp, dirWork: fdTmp })
+        assert.strict.equal(r.out, 'both')
+        assert.strict.equal(r.html.fileName, '內容.html')
+        assert.strict.equal(r.docx.fileName, '內容.docx')
+        assert.strict.equal(r.docx.mime, 'application/vnd.openxmlformats-officedocument.wordprocessingml.document')
+        assert.strict.equal(r.docx.size, Buffer.from(r.docx.base64, 'base64').length)
+        assert.strict.equal(typeof r.msDocx, 'number')
+        let z = readZipEntries(Buffer.from(r.docx.base64, 'base64'))
+        assert.strict.equal(z['word/document.xml'].toString('utf8').includes('內容轉檔'), true)
+        assert.strict.equal(fs.readdirSync(fdTmp).filter((v) => v.startsWith('job_')).length, 0) //作業夾已清除
+    })
+
+})

package/test/unit-utils.test.mjs

@@ -0,0 +1,370 @@
+import fs from 'fs'
+import path from 'path'
+import assert from 'assert'
+import {
+    mimeHtml,
+    mimeDocx,
+    toErrText,
+    retryBusy,
+    runExclusive,
+    getQueueSize,
+    getFpExe,
+    checkDocxReady,
+    toSafeName,
+    resolveAssetPaths,
+    writeAssets,
+    cleanWorkDir,
+    transErrAsset
+} from '../src/utils.mjs'
+
+
+let sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+
+
+describe('utils', function() {
+
+    let fdTmp = path.resolve('./tmp/zt_utils')
+
+    before(function() {
+        fs.mkdirSync(fdTmp, { recursive: true })
+    })
+
+    after(function() {
+        fs.rmSync(fdTmp, { recursive: true, force: true })
+    })
+
+    describe('mime', function() {
+
+        it('mimeHtml/mimeDocx', function() {
+            assert.strict.equal(mimeHtml, 'text/html; charset=utf-8')
+            assert.strict.equal(mimeDocx, 'application/vnd.openxmlformats-officedocument.wordprocessingml.document')
+        })
+
+    })
+
+    describe('toErrText', function() {
+
+        it('字串原樣回傳', function() {
+            assert.strict.equal(toErrText('abc'), 'abc')
+            assert.strict.equal(toErrText(''), '')
+        })
+
+        it('Error取message', function() {
+            assert.strict.equal(toErrText(new Error('boom')), 'boom')
+        })
+
+        it('物件無message則JSON化', function() {
+            assert.strict.equal(toErrText({ code: 'E1' }), '{"code":"E1"}')
+        })
+
+        it('null/undefined轉為文字', function() {
+            assert.strict.equal(toErrText(null), 'null')
+            assert.strict.equal(toErrText(undefined), 'undefined')
+        })
+
+    })
+
+    describe('retryBusy', function() {
+
+        it('fun非函數則reject', async function() {
+            await assert.rejects(retryBusy('x'), (e) => e === 'fun must be a function')
+        })
+
+        it('EBUSY/EPERM重試至成功', async function() {
+            let n = 0
+            let r = await retryBusy(async () => {
+                n++
+                if (n <= 2) {
+                    let e = new Error('locked')
+                    e.code = (n === 1) ? 'EBUSY' : 'EPERM'
+                    throw e
+                }
+                return 'ok'
+            }, { delayMs: 5 })
+            assert.strict.equal(r, 'ok')
+            assert.strict.equal(n, 3)
+        })
+
+        it('非busy錯誤不重試, 直接拋出', async function() {
+            let n = 0
+            await assert.rejects(retryBusy(async () => {
+                n++
+                throw new Error('other')
+            }, { delayMs: 5 }), /other/)
+            assert.strict.equal(n, 1)
+        })
+
+        it('字串reject(底層轉檔器慣例)不重試, 原樣拋出', async function() {
+            let n = 0
+            await assert.rejects(retryBusy(() => {
+                n++
+                return Promise.reject('fpIn[x] does not exist')
+            }, { delayMs: 5 }), (e) => e === 'fpIn[x] does not exist')
+            assert.strict.equal(n, 1)
+        })
+
+        it('tries耗盡則拋出最後錯誤', async function() {
+            let n = 0
+            await assert.rejects(retryBusy(async () => {
+                n++
+                let e = new Error('locked')
+                e.code = 'EBUSY'
+                throw e
+            }, { tries: 3, delayMs: 5 }), /locked/)
+            assert.strict.equal(n, 3)
+        })
+
+        it('tries/delayMs非法值採預設(tries=6)', async function() {
+            let n = 0
+            await assert.rejects(retryBusy(async () => {
+                n++
+                let e = new Error('locked')
+                e.code = 'EBUSY'
+                throw e
+            }, { tries: -1, delayMs: 'x' }), /locked/)
+            assert.strict.equal(n, 6)
+        })
+
+    })
+
+    describe('runExclusive/getQueueSize', function() {
+
+        it('fun非函數則reject', async function() {
+            await assert.rejects(runExclusive(null), (e) => e === 'fun must be a function')
+        })
+
+        it('依序執行, 佇列數隨進出增減', async function() {
+            let order = []
+            assert.strict.equal(getQueueSize(), 0)
+            let p1 = runExclusive(async () => {
+                await sleep(60)
+                order.push(1)
+                return 'a'
+            })
+            let p2 = runExclusive(async () => {
+                order.push(2)
+                return 'b'
+            })
+            assert.strict.equal(getQueueSize(), 2)
+            let rs = await Promise.all([p1, p2])
+            await sleep(5) //佇列減量於pm.then之後, 給予一個tick
+            assert.strict.deepEqual(rs, ['a', 'b'])
+            assert.strict.deepEqual(order, [1, 2]) //後進者須等前者完成
+            assert.strict.equal(getQueueSize(), 0)
+        })
+
+        it('前一件失敗不阻斷後續', async function() {
+            let p1 = runExclusive(() => Promise.reject('fail1'))
+            let p2 = runExclusive(async () => 'ok2')
+            await assert.rejects(p1, (e) => e === 'fail1')
+            assert.strict.equal(await p2, 'ok2')
+            await sleep(5)
+            assert.strict.equal(getQueueSize(), 0)
+        })
+
+    })
+
+    describe('getFpExe/checkDocxReady', function() {
+
+        it('getFpExe回傳字串, 存在時為實體檔', function() {
+            let fp = getFpExe()
+            assert.strict.equal(typeof fp, 'string')
+            if (fp !== '') {
+                assert.strict.equal(fs.existsSync(fp), true)
+                assert.strict.equal(/htmlToDocx\.exe$/.test(fp), true)
+            }
+        })
+
+        it('checkDocxReady欄位與一致性', function() {
+            let r = checkDocxReady()
+            assert.strict.equal(r.platform, process.platform)
+            assert.strict.equal(r.isWindows, process.platform === 'win32')
+            assert.strict.equal(r.cwd, path.resolve())
+            assert.strict.equal(r.exePath, getFpExe())
+            assert.strict.equal(r.exeFound, r.exePath !== '')
+            assert.strict.equal(r.ready, r.isWindows && r.exeFound)
+        })
+
+    })
+
+    describe('toSafeName', function() {
+
+        it('去除路徑成分與副檔名', function() {
+            assert.strict.equal(toSafeName('../report/報告R00.01.md'), '報告R00.01')
+            assert.strict.equal(toSafeName('a\\b\\c.docx'), 'c')
+            assert.strict.equal(toSafeName('x.HTML'), 'x')
+        })
+
+        it('非法字元替換為底線', function() {
+            //note: 冒號不置於第2字元, 否則 Windows 之 path.basename 視 'a:' 為磁碟機前綴(路徑成分)而剝除
+            assert.strict.equal(toSafeName('a*b?c"d<e>f|g:h'), 'a_b_c_d_e_f_g_h')
+            assert.strict.equal(toSafeName('a\tb\rc\nd'), 'a_b_c_d')
+        })
+
+        it('去除開頭點號, 空值回output', function() {
+            assert.strict.equal(toSafeName('..hidden'), 'hidden')
+            assert.strict.equal(toSafeName(''), 'output')
+            assert.strict.equal(toSafeName('   '), 'output')
+            assert.strict.equal(toSafeName(null), 'output')
+            assert.strict.equal(toSafeName(123), 'output')
+            assert.strict.equal(toSafeName('...'), 'output')
+        })
+
+        it('長度截至120', function() {
+            assert.strict.equal(toSafeName('x'.repeat(200)).length, 120)
+        })
+
+    })
+
+    describe('resolveAssetPaths', function() {
+
+        it('一般相對路徑回傳單一絕對路徑', function() {
+            let rs = resolveAssetPaths(fdTmp, 'pics/a.png')
+            assert.strict.deepEqual(rs, [path.resolve(fdTmp, 'pics/a.png')])
+        })
+
+        it('反斜線正規化', function() {
+            let rs = resolveAssetPaths(fdTmp, 'pics\\a.png')
+            assert.strict.deepEqual(rs, [path.resolve(fdTmp, 'pics/a.png')])
+        })
+
+        it('URL編碼路徑回傳原字串與解碼後兩者', function() {
+            let rs = resolveAssetPaths(fdTmp, 'pics/%E5%9C%96.png')
+            assert.strict.deepEqual(rs, [path.resolve(fdTmp, 'pics/%E5%9C%96.png'), path.resolve(fdTmp, 'pics/圖.png')])
+        })
+
+        it('非法percent序列視為未編碼', function() {
+            let rs = resolveAssetPaths(fdTmp, 'pics/100%.png')
+            assert.strict.deepEqual(rs, [path.resolve(fdTmp, 'pics/100%.png')])
+        })
+
+        it('空路徑/非字串拋錯', function() {
+            assert.throws(() => resolveAssetPaths(fdTmp, ''), /^Error: asset\.path is empty$/)
+            assert.throws(() => resolveAssetPaths(fdTmp, null), /^Error: asset\.path is empty$/)
+        })
+
+        it('絕對路徑(磁碟機/根/UNC)拋錯', function() {
+            assert.throws(() => resolveAssetPaths(fdTmp, 'C:/x.png'), /^Error: asset\.path must be a relative path: C:\/x\.png$/)
+            assert.throws(() => resolveAssetPaths(fdTmp, '/x.png'), /must be a relative path/)
+            assert.throws(() => resolveAssetPaths(fdTmp, '//srv/x.png'), /must be a relative path/)
+        })
+
+        it('路徑穿越(含編碼形式)拋錯', function() {
+            assert.throws(() => resolveAssetPaths(fdTmp, '../x.png'), /^Error: asset\.path is outside the working folder: \.\.\/x\.png$/)
+            assert.throws(() => resolveAssetPaths(fdTmp, 'a/../../x.png'), /is outside the working folder/)
+            assert.throws(() => resolveAssetPaths(fdTmp, '%2e%2e/x.png'), /is outside the working folder/)
+        })
+
+        it('同前綴兄弟資料夾不放行', function() {
+            let dirJob = path.resolve(fdTmp, 'job_1')
+            assert.throws(() => resolveAssetPaths(dirJob, '../job_1x/x.png'), /is outside the working folder/)
+        })
+
+    })
+
+    describe('writeAssets', function() {
+
+        it('非陣列回0', function() {
+            assert.strict.equal(writeAssets(fdTmp, null), 0)
+            assert.strict.equal(writeAssets(fdTmp, 'x'), 0)
+        })
+
+        it('寫入檔案(含子資料夾), 編碼路徵同時寫出兩檔, 容許data URI與contentBase64', function() {
+            let dirJob = path.resolve(fdTmp, 'job_w')
+            let n = writeAssets(dirJob, [
+                { path: 'pics/%E5%9C%96.png', base64: Buffer.from('AB').toString('base64') },
+                { path: 'b.txt', base64: `data:text/plain;base64,${Buffer.from('CD').toString('base64')}` },
+                { path: 'c.txt', contentBase64: Buffer.from('EF').toString('base64') },
+            ])
+            assert.strict.equal(n, 3)
+            assert.strict.equal(fs.readFileSync(path.resolve(dirJob, 'pics/%E5%9C%96.png'), 'utf8'), 'AB')
+            assert.strict.equal(fs.readFileSync(path.resolve(dirJob, 'pics/圖.png'), 'utf8'), 'AB')
+            assert.strict.equal(fs.readFileSync(path.resolve(dirJob, 'b.txt'), 'utf8'), 'CD')
+            assert.strict.equal(fs.readFileSync(path.resolve(dirJob, 'c.txt'), 'utf8'), 'EF')
+        })
+
+        it('base64為空拋錯', function() {
+            assert.throws(() => writeAssets(fdTmp, [{ path: 'x.png' }]), /^Error: asset\.base64 is empty: x\.png$/)
+            assert.throws(() => writeAssets(fdTmp, [{ path: 'x.png', base64: 123 }]), /asset\.base64 is empty/)
+        })
+
+        it('路徑穿越拋錯且不寫檔', function() {
+            assert.throws(() => writeAssets(fdTmp, [{ path: '../zt_evil.txt', base64: 'QUI=' }]), /is outside the working folder/)
+            assert.strict.equal(fs.existsSync(path.resolve(fdTmp, '../zt_evil.txt')), false)
+        })
+
+    })
+
+    describe('cleanWorkDir', function() {
+
+        it('非有效字串回0', function() {
+            assert.strict.equal(cleanWorkDir(''), 0)
+            assert.strict.equal(cleanWorkDir(null), 0)
+        })
+
+        it('資料夾不存在則建立並回0', function() {
+            let d = path.resolve(fdTmp, 'work_new')
+            assert.strict.equal(fs.existsSync(d), false)
+            assert.strict.equal(cleanWorkDir(d), 0)
+            assert.strict.equal(fs.existsSync(d), true)
+        })
+
+        it('僅刪逾時之job_夾, 非job_與未逾時者保留', function() {
+            let d = path.resolve(fdTmp, 'work_clean')
+            let dOld = path.resolve(d, 'job_old')
+            let dNew = path.resolve(d, 'job_new')
+            let dOther = path.resolve(d, 'other_old')
+            fs.mkdirSync(dOld, { recursive: true })
+            fs.mkdirSync(dNew, { recursive: true })
+            fs.mkdirSync(dOther, { recursive: true })
+            let tOld = (Date.now() - 2 * 3600 * 1000) / 1000
+            fs.utimesSync(dOld, tOld, tOld)
+            fs.utimesSync(dOther, tOld, tOld)
+            let n = cleanWorkDir(d, { msAge: 3600 * 1000 })
+            assert.strict.equal(n, 1)
+            assert.strict.equal(fs.existsSync(dOld), false)
+            assert.strict.equal(fs.existsSync(dNew), true)
+            assert.strict.equal(fs.existsSync(dOther), true)
+        })
+
+        it('msAge非法值採預設6小時', function() {
+            let d = path.resolve(fdTmp, 'work_def')
+            let d5h = path.resolve(d, 'job_5h')
+            let d7h = path.resolve(d, 'job_7h')
+            fs.mkdirSync(d5h, { recursive: true })
+            fs.mkdirSync(d7h, { recursive: true })
+            let t5 = (Date.now() - 5 * 3600 * 1000) / 1000
+            let t7 = (Date.now() - 7 * 3600 * 1000) / 1000
+            fs.utimesSync(d5h, t5, t5)
+            fs.utimesSync(d7h, t7, t7)
+            assert.strict.equal(cleanWorkDir(d, { msAge: 'x' }), 1)
+            assert.strict.equal(fs.existsSync(d5h), true)
+            assert.strict.equal(fs.existsSync(d7h), false)
+        })
+
+    })
+
+    describe('transErrAsset', function() {
+
+        it('資產缺漏訊息轉為可行動之英文提示並隱去工作夾路徑', function() {
+            let msg = 'fp[C:/tmp/w-md2docx/job_123_abc/pics/圖.png] does not exist'
+            assert.strict.equal(transErrAsset(msg), 'Failed to convert md to html: the referenced file (pics/圖.png) does not exist, please make sure it is included in assets')
+        })
+
+        it('反斜線路徑亦可解析', function() {
+            let msg = 'Failed to convert md to html: fp[C:\\tmp\\job_1_a\\pics\\a.png] does not exist'
+            assert.strict.equal(transErrAsset(msg), 'Failed to convert md to html: the referenced file (pics/a.png) does not exist, please make sure it is included in assets')
+        })
+
+        it('非資產缺漏訊息原樣回傳', function() {
+            assert.strict.equal(transErrAsset('other error'), 'other error')
+            assert.strict.equal(transErrAsset('fp[x] does not exist'), 'fp[x] does not exist') //無 job_ 片段
+        })
+
+        it('非字串轉為文字', function() {
+            assert.strict.equal(transErrAsset(new Error('e1')), 'e1')
+        })
+
+    })
+
+})