rdbtools

Bộ công cụ CLI nhỏ cho các tác vụ thường gặp:

• fix-sort-imports: sắp xếp thứ tự import cho JS/TS.
• docx-to-md: chuyển file .docx sang Markdown, tách ảnh ra file riêng.
• md-extract: tách ảnh nhúng dạng data:image/...;base64 trong Markdown thành file ảnh.
• rdb-mock: chạy mock server có route tùy biến và proxy các route còn lại lên upstream.

Cài đặt

Dùng trực tiếp trong repo

npm install

Dùng như package CLI

npm install -g @nguyenduclong/rdbtools

Hoặc chạy qua npx:

npx @nguyenduclong/rdbtools <command>

1) fix-sort-imports

Sắp xếp nhóm import theo cú pháp member (none, all, multiple, single), đồng thời sort tên trong { ... }.

Cách dùng

fix-sort-imports <file-or-dir> [...more] [--write=false]

Ví dụ:

fix-sort-imports src
fix-sort-imports src/a.ts src/b.ts
fix-sort-imports src --write=false

Ghi chú:

• Mặc định --write=true (ghi đè file).
• Bỏ qua các thư mục phổ biến như node_modules, .git, dist, build, coverage, .next, .turbo, .yarn, out.

2) docx-to-md

Chuyển .docx thành Markdown, xuất ảnh thành file riêng trong thư mục output.

Cách dùng

docx-to-md <input-docx-file>

Ví dụ:

docx-to-md ./docs/spec.docx

Kết quả:

• Tạo thư mục cùng tên file đầu vào (không gồm đuôi .docx), ví dụ docs/spec/.
• File markdown output: docs/spec/spec.md.
• Ảnh được xuất vào cùng thư mục output.

3) md-extract

Tách ảnh nhúng base64 trong file Markdown thành file ảnh riêng và rewrite lại link ảnh trong Markdown.

Cách dùng

md-extract <input-markdown-file>

Ví dụ:

md-extract ./notes/report.md

Kết quả:

• Tạo thư mục output theo tên file markdown, ví dụ notes/report/.
• File markdown đã rewrite: notes/report/report.md.
• Ảnh được xuất vào cùng thư mục output.

4) rdb-mock

Mock server dựa trên Express:

• Route khớp trong mockRoutes sẽ dùng handler mock.
• Route còn lại sẽ proxy sang sourceUrl.

Cách dùng

rdb-mock <path-to-mock-routes-file>

Ví dụ file config (mock.config.cjs):

module.exports = {
  sourceUrl: 'http://localhost:8000',
  host: '127.0.0.1', // optional, mặc định lấy từ MOCK_HOST hoặc 127.0.0.1
  port: 8001,
  mockRoutes: [
    {
      path: '/tenant/pats/',
      method: 'GET',
      handle: (req, res) => res.status(200).json({ results: [] }),
    },
  ],
  // optional
  middlewares: [],
};

Chạy:

rdb-mock ./mock.config.cjs

Health check:

curl http://127.0.0.1:8001/__mock/health

Scripts npm

npm run extract-md-images -- <input-md-file>
npm run docx-to-md -- <input-docx-file>
npm run rdb-mock -- <path-to-config>

License

ISC