@md-safeedit/core 0.1.0-dev

package/dist/diff/diff.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generates a unified diff between oldStr and newStr.
+ */
+export declare function generateUnifiedDiff(oldStr: string, newStr: string, filePath: string): string;

package/dist/diff/diff.js

@@ -0,0 +1,99 @@
+/**
+ * Generates a unified diff between oldStr and newStr.
+ */
+export function generateUnifiedDiff(oldStr, newStr, filePath) {
+    if (oldStr === newStr) {
+        return '';
+    }
+    const oldLines = oldStr.split(/\r?\n/);
+    const newLines = newStr.split(/\r?\n/);
+    const m = oldLines.length;
+    const n = newLines.length;
+    // LCS Dynamic Programming
+    const dp = Array.from({ length: m + 1 }, () => new Int32Array(n + 1));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (oldLines[i - 1] === newLines[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    const ops = [];
+    let i = m;
+    let j = n;
+    while (i > 0 || j > 0) {
+        if (i > 0 && j > 0 && oldLines[i - 1] === newLines[j - 1]) {
+            ops.push({ type: 'same', line: oldLines[i - 1], oldIdx: i - 1, newIdx: j - 1 });
+            i--;
+            j--;
+        }
+        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+            ops.push({ type: 'added', line: newLines[j - 1], oldIdx: -1, newIdx: j - 1 });
+            j--;
+        }
+        else {
+            ops.push({ type: 'removed', line: oldLines[i - 1], oldIdx: i - 1, newIdx: -1 });
+            i--;
+        }
+    }
+    ops.reverse();
+    const contextSize = 3;
+    let diffText = `--- a/${filePath}\n+++ b/${filePath}\n`;
+    for (let k = 0; k < ops.length; k++) {
+        const op = ops[k];
+        if (op.type !== 'same') {
+            const start = Math.max(0, k - contextSize);
+            let end = k;
+            let consecutiveSames = 0;
+            while (end < ops.length) {
+                if (ops[end].type === 'same') {
+                    consecutiveSames++;
+                    if (consecutiveSames > contextSize * 2) {
+                        break;
+                    }
+                }
+                else {
+                    consecutiveSames = 0;
+                }
+                end++;
+            }
+            const hunk = ops.slice(start, end);
+            const oldStartOp = hunk.find(o => o.oldIdx !== -1);
+            const newStartOp = hunk.find(o => o.newIdx !== -1);
+            const oldStartLine = oldStartOp ? oldStartOp.oldIdx + 1 : 1;
+            const newStartLine = newStartOp ? newStartOp.newIdx + 1 : 1;
+            let oldLen = 0;
+            let newLen = 0;
+            hunk.forEach(o => {
+                if (o.type === 'same') {
+                    oldLen++;
+                    newLen++;
+                }
+                else if (o.type === 'removed') {
+                    oldLen++;
+                }
+                else if (o.type === 'added') {
+                    newLen++;
+                }
+            });
+            diffText += `@@ -${oldStartLine},${oldLen} +${newStartLine},${newLen} @@\n`;
+            hunk.forEach(o => {
+                if (o.type === 'same') {
+                    diffText += ` ${o.line}\n`;
+                }
+                else if (o.type === 'removed') {
+                    diffText += `-${o.line}\n`;
+                }
+                else if (o.type === 'added') {
+                    diffText += `+${o.line}\n`;
+                }
+            });
+            k = end - 1;
+        }
+    }
+    return diffText;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/diff/diff.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './snapshot/snapshot.js';
+export * from './transaction/planner.js';
+export * from './writer/atomic.js';
+export * from './diff/diff.js';

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './snapshot/snapshot.js';
+export * from './transaction/planner.js';
+export * from './writer/atomic.js';
+export * from './diff/diff.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/snapshot/snapshot.d.ts

@@ -0,0 +1,47 @@
+export type LineEnding = 'lf' | 'crlf' | 'mixed';
+export type Encoding = 'utf-8' | 'utf-8-bom';
+export interface ByteRange {
+    start: number;
+    end: number;
+}
+export interface FileIdentity {
+    device: number;
+    inode: number;
+}
+export interface DocumentSnapshot {
+    canonicalPath: string;
+    fileIdentity?: FileIdentity;
+    bytes: Uint8Array;
+    content: string;
+    revision: string;
+    encoding: Encoding;
+    lineEnding: LineEnding;
+    createdAt: string;
+}
+/**
+ * Resolves symlinks and ensures the path is canonical and resides within the configured allowed roots.
+ * Throws an error if path traversal is detected.
+ */
+export declare function authorizeAndCanonicalizePath(targetPath: string, allowedRoots: string[]): string;
+/**
+ * Detects encoding (UTF-8 vs UTF-8-BOM) and line endings (LF vs CRLF vs mixed) from content bytes.
+ */
+export declare function detectFileMetadata(bytes: Uint8Array): {
+    encoding: Encoding;
+    lineEnding: LineEnding;
+    cleanContent: string;
+};
+/**
+ * Creates a DocumentSnapshot from a file path.
+ */
+export declare function createSnapshot(targetPath: string, allowedRoots: string[]): DocumentSnapshot;
+/**
+ * Helper class to map between JS character offsets and UTF-8 byte offsets.
+ */
+export declare class OffsetMapper {
+    private charToByte;
+    private byteToChar;
+    constructor(bytes: Uint8Array, str: string);
+    toByteOffset(charOffset: number): number;
+    toCharOffset(byteOffset: number): number;
+}

package/dist/snapshot/snapshot.js

@@ -0,0 +1,169 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+/**
+ * Resolves symlinks and ensures the path is canonical and resides within the configured allowed roots.
+ * Throws an error if path traversal is detected.
+ */
+export function authorizeAndCanonicalizePath(targetPath, allowedRoots) {
+    if (allowedRoots.length === 0) {
+        throw new Error('No allowed roots configured for path authorization.');
+    }
+    let canonical;
+    try {
+        canonical = fs.realpathSync(targetPath);
+    }
+    catch (err) {
+        // If the file doesn't exist yet (e.g. for creation), canonicalize the parent directory
+        const resolvedParent = fs.realpathSync(path.dirname(targetPath));
+        canonical = path.join(resolvedParent, path.basename(targetPath));
+    }
+    const isAllowed = allowedRoots.some(root => {
+        try {
+            const canonicalRoot = fs.realpathSync(root);
+            const relative = path.relative(canonicalRoot, canonical);
+            // If relative starts with '..' or is absolute, it's outside the root
+            return !relative.startsWith('..') && !path.isAbsolute(relative);
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!isAllowed) {
+        throw new Error(`Access Denied: Path "${targetPath}" resolves to "${canonical}" which is outside the authorized roots.`);
+    }
+    return canonical;
+}
+/**
+ * Detects encoding (UTF-8 vs UTF-8-BOM) and line endings (LF vs CRLF vs mixed) from content bytes.
+ */
+export function detectFileMetadata(bytes) {
+    let encoding = 'utf-8';
+    let startOffset = 0;
+    // Detect UTF-8 BOM: EF BB BF
+    if (bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf) {
+        encoding = 'utf-8-bom';
+        startOffset = 3;
+    }
+    const decoder = new TextDecoder('utf-8');
+    const cleanContent = decoder.decode(bytes.subarray(startOffset));
+    let lineEnding = 'lf';
+    const hasLF = cleanContent.includes('\n');
+    const hasCRLF = cleanContent.includes('\r\n');
+    if (hasCRLF) {
+        // Check if there are also standalone LF endings (i.e. LF not preceded by CR)
+        // Replace CRLF with empty, then check if there is still LF
+        const withoutCRLF = cleanContent.replace(/\r\n/g, '');
+        if (withoutCRLF.includes('\n')) {
+            lineEnding = 'mixed';
+        }
+        else {
+            lineEnding = 'crlf';
+        }
+    }
+    else if (hasLF) {
+        lineEnding = 'lf';
+    }
+    else {
+        // No line endings, default to lf
+        lineEnding = 'lf';
+    }
+    return { encoding, lineEnding, cleanContent };
+}
+/**
+ * Creates a DocumentSnapshot from a file path.
+ */
+export function createSnapshot(targetPath, allowedRoots) {
+    const canonicalPath = authorizeAndCanonicalizePath(targetPath, allowedRoots);
+    const stat = fs.statSync(canonicalPath);
+    const fileIdentity = {
+        device: stat.dev,
+        inode: stat.ino
+    };
+    const bytes = fs.readFileSync(canonicalPath);
+    const { encoding, lineEnding, cleanContent } = detectFileMetadata(bytes);
+    const hash = crypto.createHash('sha256').update(bytes).digest('hex');
+    const revision = `sha256:${hash}`;
+    return {
+        canonicalPath,
+        fileIdentity,
+        bytes,
+        content: cleanContent,
+        revision,
+        encoding,
+        lineEnding,
+        createdAt: new Date().toISOString()
+    };
+}
+/**
+ * Helper class to map between JS character offsets and UTF-8 byte offsets.
+ */
+export class OffsetMapper {
+    charToByte;
+    byteToChar;
+    constructor(bytes, str) {
+        // Account for potential BOM offset in raw bytes relative to decoded string
+        const bomOffset = bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf ? 3 : 0;
+        this.charToByte = new Int32Array(str.length + 1);
+        this.byteToChar = new Int32Array(bytes.length + 1 - bomOffset);
+        let charIdx = 0;
+        let byteIdx = 0;
+        while (charIdx < str.length) {
+            this.charToByte[charIdx] = byteIdx;
+            this.byteToChar[byteIdx] = charIdx;
+            const codePoint = str.codePointAt(charIdx);
+            if (codePoint === undefined)
+                break;
+            let utf8Len = 0;
+            if (codePoint <= 0x7f)
+                utf8Len = 1;
+            else if (codePoint <= 0x7ff)
+                utf8Len = 2;
+            else if (codePoint <= 0xffff)
+                utf8Len = 3;
+            else
+                utf8Len = 4;
+            const utf16Len = codePoint > 0xffff ? 2 : 1;
+            for (let b = 0; b < utf8Len; b++) {
+                this.byteToChar[byteIdx + b] = charIdx;
+            }
+            for (let c = 0; c < utf16Len; c++) {
+                this.charToByte[charIdx + c] = byteIdx;
+            }
+            byteIdx += utf8Len;
+            charIdx += utf16Len;
+        }
+        this.charToByte[str.length] = byteIdx;
+        this.byteToChar[byteIdx] = str.length;
+        // Shift everything in charToByte by BOM offset to match raw byte offsets
+        if (bomOffset > 0) {
+            for (let i = 0; i < this.charToByte.length; i++) {
+                this.charToByte[i] += bomOffset;
+            }
+            // Re-initialize byteToChar to include BOM
+            const newByteToChar = new Int32Array(bytes.length + 1);
+            for (let b = 0; b < bomOffset; b++) {
+                newByteToChar[b] = 0;
+            }
+            for (let b = 0; b < this.byteToChar.length; b++) {
+                newByteToChar[b + bomOffset] = this.byteToChar[b];
+            }
+            this.byteToChar = newByteToChar;
+        }
+    }
+    toByteOffset(charOffset) {
+        if (charOffset < 0)
+            return this.charToByte[0];
+        if (charOffset >= this.charToByte.length)
+            return this.charToByte[this.charToByte.length - 1];
+        return this.charToByte[charOffset];
+    }
+    toCharOffset(byteOffset) {
+        if (byteOffset < 0)
+            return 0;
+        if (byteOffset >= this.byteToChar.length)
+            return this.byteToChar[this.byteToChar.length - 1];
+        return this.byteToChar[byteOffset];
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/snapshot/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/transaction/planner.d.ts

@@ -0,0 +1,24 @@
+export interface ByteEdit {
+    offset: number;
+    length: number;
+    replacement: Uint8Array;
+    index: number;
+}
+/**
+ * Checks if any edits overlap.
+ * Intersecting ranges are forbidden.
+ * An insert is allowed at the boundary of a replace, but not strictly inside it.
+ */
+export declare function hasOverlaps(edits: ByteEdit[]): boolean;
+/**
+ * Sorts edits from highest offset to lowest offset for safe application.
+ * Deterministic rules for same-offset edits:
+ * - Replaces (length > 0) are applied first (sorted before inserts).
+ * - Inserts at the same offset are applied in request order (sorted by index descending for right-to-left application).
+ */
+export declare function sortEdits(edits: ByteEdit[]): ByteEdit[];
+/**
+ * Applies a list of byte edits to a source Uint8Array.
+ * Throws an error if overlaps are detected.
+ */
+export declare function applyEdits(source: Uint8Array, edits: ByteEdit[]): Uint8Array;

package/dist/transaction/planner.js

@@ -0,0 +1,75 @@
+/**
+ * Checks if any edits overlap.
+ * Intersecting ranges are forbidden.
+ * An insert is allowed at the boundary of a replace, but not strictly inside it.
+ */
+export function hasOverlaps(edits) {
+    for (let i = 0; i < edits.length; i++) {
+        const a = edits[i];
+        const startA = a.offset;
+        const endA = a.offset + a.length;
+        for (let j = i + 1; j < edits.length; j++) {
+            const b = edits[j];
+            const startB = b.offset;
+            const endB = b.offset + b.length;
+            // Check standard range overlap: max(startA, startB) < min(endA, endB)
+            // This detects if two non-empty ranges intersect, or if an insert is inside a replace.
+            const hasOverlap = Math.max(startA, startB) < Math.min(endA, endB);
+            if (hasOverlap)
+                return true;
+            // Check if one is insert (length 0) and strictly inside another's non-empty range
+            if (a.length > 0 && b.length === 0 && startB > startA && startB < endA)
+                return true;
+            if (b.length > 0 && a.length === 0 && startA > startB && startA < endB)
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Sorts edits from highest offset to lowest offset for safe application.
+ * Deterministic rules for same-offset edits:
+ * - Replaces (length > 0) are applied first (sorted before inserts).
+ * - Inserts at the same offset are applied in request order (sorted by index descending for right-to-left application).
+ */
+export function sortEdits(edits) {
+    return [...edits].sort((a, b) => {
+        if (a.offset !== b.offset) {
+            return b.offset - a.offset; // Higher offsets first
+        }
+        // Same offset: Replace before insert
+        if (a.length !== b.length) {
+            return b.length - a.length; // Replaces (longer lengths) first
+        }
+        // Same offset and same length (e.g. multiple inserts): preserve request order
+        // Since we apply right-to-left, higher request index must be applied first
+        return b.index - a.index;
+    });
+}
+/**
+ * Applies a list of byte edits to a source Uint8Array.
+ * Throws an error if overlaps are detected.
+ */
+export function applyEdits(source, edits) {
+    if (hasOverlaps(edits)) {
+        throw new Error('OVERLAPPING_OPERATIONS');
+    }
+    const sorted = sortEdits(edits);
+    // To avoid multiple allocations, we can rebuild the buffer by slicing and concatenating
+    // since we process from right to left.
+    let currentBytes = source;
+    for (const edit of sorted) {
+        if (edit.offset < 0 || edit.offset + edit.length > currentBytes.length) {
+            throw new Error(`INVALID_REPLACEMENT: Edit offset ${edit.offset} or length ${edit.length} is out of bounds for content size ${currentBytes.length}.`);
+        }
+        const before = currentBytes.subarray(0, edit.offset);
+        const after = currentBytes.subarray(edit.offset + edit.length);
+        const nextBytes = new Uint8Array(before.length + edit.replacement.length + after.length);
+        nextBytes.set(before, 0);
+        nextBytes.set(edit.replacement, before.length);
+        nextBytes.set(after, before.length + edit.replacement.length);
+        currentBytes = nextBytes;
+    }
+    return currentBytes;
+}
+//# sourceMappingURL=planner.js.map

package/dist/transaction/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/transaction/planner.ts"],"names":[],"mappings":"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"}

package/dist/writer/atomic.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Safely and atomically replaces targetFilePath with newBytes.
+ *
+ * Flow:
+ * 1. Checks if original file exists. If it does, record its permissions.
+ * 2. Writes newBytes to a temporary file in the same directory.
+ * 3. Applies the original file permissions to the temporary file.
+ * 4. Checks the current revision of the target file. If it doesn't match expectedRevision, aborts with COMMIT_RACE.
+ * 5. Renames the temporary file to the target path (atomic replace).
+ * 6. Cleans up temporary files on error.
+ */
+export declare function atomicWriteFile(targetFilePath: string, newBytes: Uint8Array, expectedRevision: string): string;

package/dist/writer/atomic.js

@@ -0,0 +1,90 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+/**
+ * Computes the SHA-256 revision hash of a file's bytes.
+ */
+function getFileRevision(filePath) {
+    const bytes = fs.readFileSync(filePath);
+    const hash = crypto.createHash('sha256').update(bytes).digest('hex');
+    return `sha256:${hash}`;
+}
+/**
+ * Safely and atomically replaces targetFilePath with newBytes.
+ *
+ * Flow:
+ * 1. Checks if original file exists. If it does, record its permissions.
+ * 2. Writes newBytes to a temporary file in the same directory.
+ * 3. Applies the original file permissions to the temporary file.
+ * 4. Checks the current revision of the target file. If it doesn't match expectedRevision, aborts with COMMIT_RACE.
+ * 5. Renames the temporary file to the target path (atomic replace).
+ * 6. Cleans up temporary files on error.
+ */
+export function atomicWriteFile(targetFilePath, newBytes, expectedRevision) {
+    const targetDir = path.dirname(targetFilePath);
+    const targetName = path.basename(targetFilePath);
+    const tempFilePath = path.join(targetDir, `.tmp-${targetName}-${crypto.randomBytes(6).toString('hex')}`);
+    let originalMode;
+    let exists = false;
+    try {
+        const stat = fs.statSync(targetFilePath);
+        originalMode = stat.mode;
+        exists = true;
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            throw new Error(`IO_ERROR: Failed to stat target file: ${err.message}`);
+        }
+    }
+    // Write new content to temporary file
+    try {
+        fs.writeFileSync(tempFilePath, newBytes);
+        if (originalMode !== undefined) {
+            fs.chmodSync(tempFilePath, originalMode);
+        }
+    }
+    catch (err) {
+        // Cleanup temporary file
+        try {
+            if (fs.existsSync(tempFilePath)) {
+                fs.unlinkSync(tempFilePath);
+            }
+        }
+        catch { }
+        throw new Error(`IO_ERROR: Failed to write temporary file: ${err.message}`);
+    }
+    // Commit phase
+    try {
+        if (exists) {
+            // Re-read current file to verify no concurrent modification occurred (CAS check)
+            let currentRevision;
+            try {
+                currentRevision = getFileRevision(targetFilePath);
+            }
+            catch (err) {
+                throw new Error(`IO_ERROR: Failed to read target file for revision check: ${err.message}`);
+            }
+            if (currentRevision !== expectedRevision) {
+                throw new Error('COMMIT_RACE');
+            }
+        }
+        // Atomic rename
+        fs.renameSync(tempFilePath, targetFilePath);
+    }
+    catch (err) {
+        // Cleanup
+        try {
+            if (fs.existsSync(tempFilePath)) {
+                fs.unlinkSync(tempFilePath);
+            }
+        }
+        catch { }
+        if (err.message === 'COMMIT_RACE') {
+            throw err;
+        }
+        throw new Error(`IO_ERROR: Failed to rename temporary file: ${err.message}`);
+    }
+    // Calculate new revision
+    return getFileRevision(targetFilePath);
+}
+//# sourceMappingURL=atomic.js.map

package/dist/writer/atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.js","sourceRoot":"","sources":["../../src/writer/atomic.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@md-safeedit/core",
+  "version": "0.1.0-dev",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}