tar-xz 0.1.0

package/lib/node/extract.js

@@ -0,0 +1,274 @@
+/**
+ * Node.js TAR extraction with XZ decompression
+ */
+import { createReadStream, promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { Writable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { createUnxz } from 'node-liblzma';
+import { applyPaxAttributes, BLOCK_SIZE, calculatePadding, isEmptyBlock, parseHeader, parsePaxData, } from '../tar/index.js';
+import { TarEntryType } from '../types.js';
+/**
+ * Transform stream that unpacks TAR format
+ */
+class TarUnpack extends Writable {
+    buffer = Buffer.alloc(0);
+    currentEntry = null;
+    bytesRemaining = 0;
+    paddingRemaining = 0;
+    contentChunks = [];
+    paxAttrs = null;
+    emptyBlockCount = 0;
+    entries = [];
+    _write(chunk, _encoding, callback) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        try {
+            this.processBuffer();
+            callback();
+        }
+        catch (error) {
+            callback(error);
+        }
+    }
+    processBuffer() {
+        while (this.buffer.length > 0) {
+            // Handle padding
+            if (this.paddingRemaining > 0) {
+                const skip = Math.min(this.paddingRemaining, this.buffer.length);
+                this.buffer = this.buffer.subarray(skip);
+                this.paddingRemaining -= skip;
+                continue;
+            }
+            // Handle file content
+            if (this.bytesRemaining > 0 && this.currentEntry) {
+                const readSize = Math.min(this.bytesRemaining, this.buffer.length);
+                this.contentChunks.push(this.buffer.subarray(0, readSize));
+                this.buffer = this.buffer.subarray(readSize);
+                this.bytesRemaining -= readSize;
+                // Entry complete
+                if (this.bytesRemaining === 0) {
+                    const content = Buffer.concat(this.contentChunks);
+                    this.entries.push({ ...this.currentEntry, content });
+                    // Calculate padding
+                    this.paddingRemaining = calculatePadding(this.currentEntry.size);
+                    this.currentEntry = null;
+                    this.contentChunks = [];
+                }
+                continue;
+            }
+            // Need a full block for header
+            if (this.buffer.length < BLOCK_SIZE) {
+                break;
+            }
+            const headerBlock = this.buffer.subarray(0, BLOCK_SIZE);
+            this.buffer = this.buffer.subarray(BLOCK_SIZE);
+            // Check for end-of-archive
+            if (isEmptyBlock(headerBlock)) {
+                this.emptyBlockCount++;
+                if (this.emptyBlockCount >= 2) {
+                    // End of archive
+                    break;
+                }
+                continue;
+            }
+            this.emptyBlockCount = 0;
+            // Parse header
+            let entry = parseHeader(headerBlock);
+            if (!entry) {
+                continue;
+            }
+            // Handle PAX headers
+            if (entry.type === TarEntryType.PAX_HEADER) {
+                // Read PAX data
+                const paxSize = entry.size;
+                const paxPadding = calculatePadding(paxSize);
+                const totalNeeded = paxSize + paxPadding;
+                if (this.buffer.length < totalNeeded) {
+                    // Put header back and wait for more data
+                    this.buffer = Buffer.concat([headerBlock, this.buffer]);
+                    break;
+                }
+                const paxData = this.buffer.subarray(0, paxSize);
+                this.buffer = this.buffer.subarray(paxSize + paxPadding);
+                this.paxAttrs = parsePaxData(paxData);
+                continue;
+            }
+            if (entry.type === TarEntryType.PAX_GLOBAL) {
+                // Skip global PAX headers (we don't support them yet)
+                const skipSize = entry.size + calculatePadding(entry.size);
+                if (this.buffer.length < skipSize) {
+                    this.buffer = Buffer.concat([headerBlock, this.buffer]);
+                    break;
+                }
+                this.buffer = this.buffer.subarray(skipSize);
+                continue;
+            }
+            // Apply PAX attributes if present
+            if (this.paxAttrs) {
+                entry = applyPaxAttributes(entry, this.paxAttrs);
+                this.paxAttrs = null;
+            }
+            // Handle directories (no content)
+            if (entry.type === TarEntryType.DIRECTORY) {
+                this.entries.push({ ...entry, content: Buffer.alloc(0) });
+                continue;
+            }
+            // Handle symlinks (no content)
+            if (entry.type === TarEntryType.SYMLINK || entry.type === TarEntryType.HARDLINK) {
+                this.entries.push({ ...entry, content: Buffer.alloc(0) });
+                continue;
+            }
+            // Regular file - prepare to read content
+            if (entry.size > 0) {
+                this.currentEntry = entry;
+                this.bytesRemaining = entry.size;
+                this.contentChunks = [];
+            }
+            else {
+                this.entries.push({ ...entry, content: Buffer.alloc(0) });
+            }
+        }
+    }
+    _final(callback) {
+        if (this.bytesRemaining > 0) {
+            callback(new Error(`Unexpected end of archive, ${this.bytesRemaining} bytes remaining`));
+        }
+        else {
+            callback();
+        }
+    }
+}
+/**
+ * Strip leading path components from a path
+ */
+function stripPath(filePath, strip) {
+    if (strip <= 0) {
+        return filePath;
+    }
+    const parts = filePath.split('/');
+    return parts.slice(strip).join('/');
+}
+/**
+ * Validate that a path doesn't escape the target directory (path traversal protection)
+ * @throws Error if path traversal is detected
+ */
+function validatePath(destPath, cwd) {
+    const resolvedDest = path.resolve(destPath);
+    const resolvedCwd = path.resolve(cwd);
+    // Ensure the destination path starts with the cwd (no escape via ../)
+    if (!resolvedDest.startsWith(resolvedCwd + path.sep) && resolvedDest !== resolvedCwd) {
+        throw new Error(`Path traversal detected: ${destPath} escapes ${cwd}`);
+    }
+}
+/**
+ * Extract a tar.xz archive
+ *
+ * @param options - Extraction options
+ * @returns Promise with list of extracted entries
+ *
+ * @example
+ * ```ts
+ * await extract({
+ *   file: 'archive.tar.xz',
+ *   cwd: '/dest',
+ *   strip: 1
+ * });
+ * ```
+ */
+export async function extract(options) {
+    const { file, cwd = process.cwd(), strip = 0, filter, preserveOwner = false } = options;
+    // Create decompression and unpacking streams
+    const inputStream = createReadStream(file);
+    const unxzStream = createUnxz();
+    const tarUnpack = new TarUnpack();
+    // Run pipeline
+    await pipeline(inputStream, unxzStream, tarUnpack);
+    // Extract files
+    const extractedEntries = [];
+    for (const entry of tarUnpack.entries) {
+        // Apply strip
+        const strippedName = stripPath(entry.name, strip);
+        if (!strippedName) {
+            continue;
+        }
+        // Apply filter
+        const entryForFilter = { ...entry, name: strippedName };
+        if (filter && !filter(entryForFilter)) {
+            continue;
+        }
+        const destPath = path.join(cwd, strippedName);
+        // Validate path doesn't escape cwd (path traversal protection)
+        validatePath(destPath, cwd);
+        // Ensure parent directory exists
+        await fs.mkdir(path.dirname(destPath), { recursive: true });
+        if (entry.type === TarEntryType.DIRECTORY) {
+            await fs.mkdir(destPath, { recursive: true });
+        }
+        else if (entry.type === TarEntryType.SYMLINK) {
+            try {
+                await fs.unlink(destPath);
+            }
+            catch {
+                // Ignore if doesn't exist
+            }
+            await fs.symlink(entry.linkname, destPath);
+        }
+        else if (entry.type === TarEntryType.HARDLINK) {
+            const linkDest = path.join(cwd, stripPath(entry.linkname, strip));
+            try {
+                await fs.unlink(destPath);
+            }
+            catch {
+                // Ignore if doesn't exist
+            }
+            await fs.link(linkDest, destPath);
+        }
+        else {
+            // Regular file
+            await fs.writeFile(destPath, entry.content);
+        }
+        // Set permissions
+        try {
+            await fs.chmod(destPath, entry.mode);
+        }
+        catch {
+            // Ignore permission errors
+        }
+        // Set ownership if requested and running as root
+        if (preserveOwner && process.getuid?.() === 0) {
+            try {
+                await fs.chown(destPath, entry.uid, entry.gid);
+            }
+            catch {
+                // Ignore ownership errors
+            }
+        }
+        // Set modification time
+        try {
+            const mtime = new Date(entry.mtime * 1000);
+            await fs.utimes(destPath, mtime, mtime);
+        }
+        catch {
+            // Ignore time errors
+        }
+        extractedEntries.push(entryForFilter);
+    }
+    return extractedEntries;
+}
+/**
+ * Extract archive to memory (no disk writes)
+ */
+export async function extractToMemory(file, options = {}) {
+    const { strip = 0, filter } = options;
+    const inputStream = createReadStream(file);
+    const unxzStream = createUnxz();
+    const tarUnpack = new TarUnpack();
+    await pipeline(inputStream, unxzStream, tarUnpack);
+    return tarUnpack.entries
+        .map((entry) => ({
+        ...entry,
+        name: stripPath(entry.name, strip),
+    }))
+        .filter((entry) => entry.name && (!filter || filter(entry)));
+}
+//# sourceMappingURL=extract.js.map

package/lib/node/extract.js.map

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

package/lib/node/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Node.js API for tar.xz archives
+ */
+export { create } from './create.js';
+export { extract, extractToMemory } from './extract.js';
+export { list } from './list.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/lib/node/index.js

@@ -0,0 +1,7 @@
+/**
+ * Node.js API for tar.xz archives
+ */
+export { create } from './create.js';
+export { extract, extractToMemory } from './extract.js';
+export { list } from './list.js';
+//# sourceMappingURL=index.js.map

package/lib/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/lib/node/list.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Node.js TAR listing with XZ decompression
+ */
+import { type ListOptions, type TarEntry } from '../types.js';
+/**
+ * List contents of a tar.xz archive
+ *
+ * @param options - List options
+ * @returns Promise with list of entries
+ *
+ * @example
+ * ```ts
+ * const entries = await list({ file: 'archive.tar.xz' });
+ * for (const entry of entries) {
+ *   console.log(entry.name, entry.size);
+ * }
+ * ```
+ */
+export declare function list(options: ListOptions): Promise<TarEntry[]>;
+//# sourceMappingURL=list.d.ts.map

package/lib/node/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/node/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAsG5E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAUpE"}

package/lib/node/list.js

@@ -0,0 +1,115 @@
+/**
+ * Node.js TAR listing with XZ decompression
+ */
+import { createReadStream } from 'node:fs';
+import { Writable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { createUnxz } from 'node-liblzma';
+import { applyPaxAttributes, BLOCK_SIZE, calculatePadding, isEmptyBlock, parseHeader, parsePaxData, } from '../tar/index.js';
+import { TarEntryType } from '../types.js';
+/**
+ * Writable stream that lists TAR entries without extracting content
+ */
+class TarList extends Writable {
+    buffer = Buffer.alloc(0);
+    bytesToSkip = 0;
+    paxAttrs = null;
+    emptyBlockCount = 0;
+    entries = [];
+    _write(chunk, _encoding, callback) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        try {
+            this.processBuffer();
+            callback();
+        }
+        catch (error) {
+            callback(error);
+        }
+    }
+    processBuffer() {
+        while (this.buffer.length > 0) {
+            // Skip content and padding
+            if (this.bytesToSkip > 0) {
+                const skip = Math.min(this.bytesToSkip, this.buffer.length);
+                this.buffer = this.buffer.subarray(skip);
+                this.bytesToSkip -= skip;
+                continue;
+            }
+            // Need a full block for header
+            if (this.buffer.length < BLOCK_SIZE) {
+                break;
+            }
+            const headerBlock = this.buffer.subarray(0, BLOCK_SIZE);
+            this.buffer = this.buffer.subarray(BLOCK_SIZE);
+            // Check for end-of-archive
+            if (isEmptyBlock(headerBlock)) {
+                this.emptyBlockCount++;
+                if (this.emptyBlockCount >= 2) {
+                    break;
+                }
+                continue;
+            }
+            this.emptyBlockCount = 0;
+            // Parse header
+            let entry = parseHeader(headerBlock);
+            if (!entry) {
+                continue;
+            }
+            // Handle PAX headers
+            if (entry.type === TarEntryType.PAX_HEADER) {
+                const paxSize = entry.size;
+                const paxPadding = calculatePadding(paxSize);
+                const totalNeeded = paxSize + paxPadding;
+                if (this.buffer.length < totalNeeded) {
+                    this.buffer = Buffer.concat([headerBlock, this.buffer]);
+                    break;
+                }
+                const paxData = this.buffer.subarray(0, paxSize);
+                this.buffer = this.buffer.subarray(paxSize + paxPadding);
+                this.paxAttrs = parsePaxData(paxData);
+                continue;
+            }
+            if (entry.type === TarEntryType.PAX_GLOBAL) {
+                this.bytesToSkip = entry.size + calculatePadding(entry.size);
+                continue;
+            }
+            // Apply PAX attributes if present
+            if (this.paxAttrs) {
+                entry = applyPaxAttributes(entry, this.paxAttrs);
+                this.paxAttrs = null;
+            }
+            // Add entry to list
+            this.entries.push(entry);
+            // Skip content
+            if (entry.size > 0) {
+                this.bytesToSkip = entry.size + calculatePadding(entry.size);
+            }
+        }
+    }
+    _final(callback) {
+        callback();
+    }
+}
+/**
+ * List contents of a tar.xz archive
+ *
+ * @param options - List options
+ * @returns Promise with list of entries
+ *
+ * @example
+ * ```ts
+ * const entries = await list({ file: 'archive.tar.xz' });
+ * for (const entry of entries) {
+ *   console.log(entry.name, entry.size);
+ * }
+ * ```
+ */
+export async function list(options) {
+    const { file } = options;
+    const inputStream = createReadStream(file);
+    const unxzStream = createUnxz();
+    const tarList = new TarList();
+    await pipeline(inputStream, unxzStream, tarList);
+    return tarList.entries;
+}
+//# sourceMappingURL=list.js.map

package/lib/node/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/node/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAmC,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5E;;GAEG;AACH,MAAM,OAAQ,SAAQ,QAAQ;IACpB,MAAM,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjC,WAAW,GAAG,CAAC,CAAC;IAChB,QAAQ,GAAyB,IAAI,CAAC;IACtC,eAAe,GAAG,CAAC,CAAC;IAErB,OAAO,GAAe,EAAE,CAAC;IAEhC,MAAM,CAAC,KAAa,EAAE,SAAyB,EAAE,QAAwC;QACvF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAElD,IAAI,CAAC;YACH,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,QAAQ,EAAE,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,KAAc,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,2BAA2B;YAC3B,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;gBACzB,SAAS;YACX,CAAC;YAED,+BAA+B;YAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBACpC,MAAM;YACR,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAE/C,2BAA2B;YAC3B,IAAI,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC9B,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;oBAC9B,MAAM;gBACR,CAAC;gBACD,SAAS;YACX,CAAC;YAED,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;YAEzB,eAAe;YACf,IAAI,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YAED,qBAAqB;YACrB,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,UAAU,EAAE,CAAC;gBAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;gBAC3B,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBAC7C,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,CAAC;gBAEzC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;oBACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;oBACxD,MAAM;gBACR,CAAC;gBAED,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACjD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC;gBACzD,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtC,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,UAAU,EAAE,CAAC;gBAC3C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7D,SAAS;YACX,CAAC;YAED,kCAAkC;YAClC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,CAAC;YAED,oBAAoB;YACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEzB,eAAe;YACf,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,CAAC,QAAwC;QAC7C,QAAQ,EAAE,CAAC;IACb,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAoB;IAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEzB,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,MAAM,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAEjD,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC"}

package/lib/tar/checksum.d.ts

@@ -0,0 +1,40 @@
+/**
+ * TAR header checksum calculation
+ *
+ * The checksum is a simple sum of all bytes in the header block,
+ * with the 8-byte checksum field (bytes 148-155) treated as spaces (0x20).
+ */
+/** Offset of checksum field in TAR header */
+export declare const CHECKSUM_OFFSET = 148;
+/** Length of checksum field */
+export declare const CHECKSUM_LENGTH = 8;
+/**
+ * Calculate TAR header checksum
+ *
+ * @param header - 512-byte TAR header block
+ * @returns Checksum value (sum of unsigned bytes, checksum field as spaces)
+ */
+export declare function calculateChecksum(header: Uint8Array): number;
+/**
+ * Verify TAR header checksum
+ *
+ * @param header - 512-byte TAR header block
+ * @returns true if checksum is valid
+ */
+export declare function verifyChecksum(header: Uint8Array): boolean;
+/**
+ * Write checksum to TAR header
+ *
+ * @param header - 512-byte TAR header block (will be modified)
+ */
+export declare function writeChecksum(header: Uint8Array): void;
+/**
+ * Parse octal number from header field
+ *
+ * @param header - Header buffer
+ * @param offset - Field offset
+ * @param length - Field length
+ * @returns Parsed number
+ */
+export declare function parseOctal(header: Uint8Array, offset: number, length: number): number;
+//# sourceMappingURL=checksum.d.ts.map

package/lib/tar/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../src/tar/checksum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,+BAA+B;AAC/B,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAiB5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAK1D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAgBtD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsBrF"}

package/lib/tar/checksum.js

@@ -0,0 +1,91 @@
+/**
+ * TAR header checksum calculation
+ *
+ * The checksum is a simple sum of all bytes in the header block,
+ * with the 8-byte checksum field (bytes 148-155) treated as spaces (0x20).
+ */
+/** Offset of checksum field in TAR header */
+export const CHECKSUM_OFFSET = 148;
+/** Length of checksum field */
+export const CHECKSUM_LENGTH = 8;
+/**
+ * Calculate TAR header checksum
+ *
+ * @param header - 512-byte TAR header block
+ * @returns Checksum value (sum of unsigned bytes, checksum field as spaces)
+ */
+export function calculateChecksum(header) {
+    if (header.length !== 512) {
+        throw new Error(`Invalid TAR header length: ${header.length}, expected 512`);
+    }
+    let sum = 0;
+    for (let i = 0; i < 512; i++) {
+        // Treat checksum field (bytes 148-155) as spaces (0x20 = 32)
+        if (i >= CHECKSUM_OFFSET && i < CHECKSUM_OFFSET + CHECKSUM_LENGTH) {
+            sum += 0x20;
+        }
+        else {
+            sum += header[i];
+        }
+    }
+    return sum;
+}
+/**
+ * Verify TAR header checksum
+ *
+ * @param header - 512-byte TAR header block
+ * @returns true if checksum is valid
+ */
+export function verifyChecksum(header) {
+    const calculated = calculateChecksum(header);
+    const stored = parseOctal(header, CHECKSUM_OFFSET, CHECKSUM_LENGTH);
+    return calculated === stored;
+}
+/**
+ * Write checksum to TAR header
+ *
+ * @param header - 512-byte TAR header block (will be modified)
+ */
+export function writeChecksum(header) {
+    // First, fill checksum field with spaces
+    for (let i = 0; i < CHECKSUM_LENGTH; i++) {
+        header[CHECKSUM_OFFSET + i] = 0x20;
+    }
+    // Calculate checksum
+    const checksum = calculateChecksum(header);
+    // Write checksum as 6-digit octal, space, null
+    const octalStr = checksum.toString(8).padStart(6, '0');
+    for (let i = 0; i < 6; i++) {
+        header[CHECKSUM_OFFSET + i] = octalStr.charCodeAt(i);
+    }
+    header[CHECKSUM_OFFSET + 6] = 0x00; // null terminator
+    header[CHECKSUM_OFFSET + 7] = 0x20; // space
+}
+/**
+ * Parse octal number from header field
+ *
+ * @param header - Header buffer
+ * @param offset - Field offset
+ * @param length - Field length
+ * @returns Parsed number
+ */
+export function parseOctal(header, offset, length) {
+    let str = '';
+    for (let i = 0; i < length; i++) {
+        const byte = header[offset + i];
+        // Stop at null or space
+        if (byte === 0 || byte === 0x20) {
+            break;
+        }
+        str += String.fromCharCode(byte);
+    }
+    if (str.length === 0) {
+        return 0;
+    }
+    const value = Number.parseInt(str, 8);
+    if (Number.isNaN(value)) {
+        return 0;
+    }
+    return value;
+}
+//# sourceMappingURL=checksum.js.map

package/lib/tar/checksum.js.map

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