Library overview

• Tracked-change comparison output for review workflows
• Revision extraction and OOXML-safe document primitives
• Formatting-preserving text and paragraph operations
• Comment and footnote primitive support

​

When to use it directly

• Run document comparison programmatically inside your own server or serverless function
• Build tooling on top of the OOXML primitives (accept/reject changes, add comments, etc.)
• Integrate Safe Docx into a pipeline without a running MCP server

​

Installation

npm install @usejunior/docx-core

​

Quickstart

import { readFile, writeFile } from 'node:fs/promises';
import { compareDocuments } from '@usejunior/docx-core';

const original = await readFile('./original.docx');
const revised = await readFile('./revised.docx');

const result = await compareDocuments(original, revised, {
  author: 'Comparison',
  // engine defaults to 'auto' (atomizer)
});

await writeFile('./output.redline.docx', result.document);
console.log(result.engine, result.stats);
// => 'atomizer' { insertions: 3, deletions: 1, modifications: 0 }

​

Runtime requirements

​

Dependency footprint

• @xmldom/xmldom — XML DOM handling
• jszip — DOCX zip container handling