@cj-tech-master/excelts 6.0.0-beta.4 → 6.0.0-beta.5

package/dist/browser/modules/archive/zip/zip-editor.js

@@ -2,13 +2,12 @@ import { dateToZipDos } from "../zip-spec/timestamps.js";
 import { encodeZipStringWithCodec, resolveZipStringCodec } from "../shared/text.js";
 import { DEFAULT_ZIP_LEVEL, DEFAULT_ZIP_TIMESTAMPS, REPRODUCIBLE_ZIP_MOD_TIME } from "../shared/defaults.js";
 import { BufferReader, HttpRangeReader } from "../io/random-access.js";
-import { RemoteZipReader } from "../io/remote-zip-reader.js";
+import { RemoteZipReader } from "../unzip/remote-zip-reader.js";
 import { toAsyncIterable, collectUint8ArrayStream, toUint8ArraySync, isSyncArchiveSource, isInMemoryArchiveSource, resolveArchiveSourceToBuffer } from "../io/archive-source.js";
 import { collect, pipeIterableToSink } from "../io/archive-sink.js";
-import { createAsyncQueue } from "../shared/async-queue.js";
-import { createLinkedAbortController, createAbortError, throwIfAborted, toError } from "../shared/errors.js";
-import { ProgressEmitter } from "../shared/progress.js";
-import { ZipDeflateFile, StreamingZip, ZipRawFile } from "./stream.js";
+import { throwIfAborted, toError } from "../shared/errors.js";
+import { createZipOperation } from "./zip-output-pipeline.js";
+import { ZipDeflateFile, ZipRawFile } from "./stream.js";
 import { createZip, createZipSync } from "./zip-bytes.js";
 import { FLAG_ENCRYPTED } from "../zip-spec/zip-records.js";
 import { ZipEditView } from "./zip-edit-view.js";
@@ -360,226 +359,137 @@ export class ZipEditor {
         const signalOpt = options.signal ?? this._streamDefaults.signal;
         const onProgress = options.onProgress ?? this._streamDefaults.onProgress;
         const progressIntervalMs = options.progressIntervalMs ?? this._streamDefaults.progressIntervalMs;
-        const { controller, cleanup: cleanupAbortLink } = createLinkedAbortController(signalOpt);
-        const signal = controller.signal;
         const preservedMeta = this._buildRawPreservedEntries();
         const sets = this._buildSetEntries();
-        const preservedRaw = [];
-        const preservedRecompressed = [];
-        for (const p of preservedMeta) {
-            const compressedData = this._remote.getRawCompressedStream(p.info.path, { signal });
-            if (compressedData) {
-                preservedRaw.push({ ...p, compressedData });
-                continue;
-            }
-            this._emitWarning(p.info.path, "raw_unavailable", `Cannot read raw compressed payload for entry "${p.info.path}".`);
-            if (this._options.preserve === "strict") {
-                throw new Error(`Cannot preserve entry "${p.info.path}" because its raw compressed payload is unavailable.`);
+        return createZipOperation(preservedMeta.length + sets.length, {
+            comment: this._options.comment,
+            zip64: this._options.zip64,
+            codec: this._stringCodec
+        }, { signal: signalOpt, onProgress, progressIntervalMs }, async ({ zip, signal, progress }) => {
+            // Classify preserved entries using the pipeline's linked signal so that
+            // abort() properly cancels raw compressed streams.
+            const preservedRaw = [];
+            const preservedRecompressed = [];
+            for (const p of preservedMeta) {
+                const compressedData = this._remote.getRawCompressedStream(p.info.path, { signal });
+                if (compressedData) {
+                    preservedRaw.push({ ...p, compressedData });
+                    continue;
+                }
+                this._emitWarning(p.info.path, "raw_unavailable", `Cannot read raw compressed payload for entry "${p.info.path}".`);
+                if (this._options.preserve === "strict") {
+                    throw new Error(`Cannot preserve entry "${p.info.path}" because its raw compressed payload is unavailable.`);
+                }
+                // We cannot re-encrypt entries; best-effort must not silently output decrypted content.
+                if (p.info.isEncrypted) {
+                    this._emitWarning(p.info.path, "encryption_unsupported", `Cannot best-effort preserve encrypted entry "${p.info.path}" without raw passthrough.`);
+                    continue;
+                }
+                // Best-effort fallback: extract and re-add the entry.
+                preservedRecompressed.push({ name: p.outName, info: p.info });
             }
-            // We cannot re-encrypt entries; best-effort must not silently output decrypted content.
-            if (p.info.isEncrypted) {
-                this._emitWarning(p.info.path, "encryption_unsupported", `Cannot best-effort preserve encrypted entry "${p.info.path}" without raw passthrough.`);
-                continue;
+            // Update entriesTotal now that we know how many entries survived classification.
+            const actualTotal = preservedRaw.length + preservedRecompressed.length + sets.length;
+            progress.set("entriesTotal", actualTotal);
+            // 1) Preserved entries: passthrough raw payload.
+            for (let i = 0; i < preservedRaw.length; i++) {
+                throwIfAborted(signal);
+                const entry = preservedRaw[i];
+                progress.update({ currentEntry: { name: entry.outName, index: i, bytesIn: 0 } });
+                const rawFile = this._buildPreservedRawFile(entry.outName, entry.info, entry.compressedData, this._options.zip64);
+                zip.add(rawFile);
+                // StreamingZip auto-starts passthrough files; await completion for accurate progress.
+                await rawFile.done();
+                progress.set("entriesDone", progress.snapshot.entriesDone + 1);
             }
-            // Best-effort fallback: extract and re-add the entry.
-            // This may require holding the entry in memory.
-            preservedRecompressed.push({ name: p.outName, info: p.info });
-        }
-        const progress = new ProgressEmitter({
-            type: "zip",
-            phase: "running",
-            entriesTotal: preservedRaw.length + preservedRecompressed.length + sets.length,
-            entriesDone: 0,
-            bytesIn: 0,
-            bytesOut: 0,
-            zip64: this._options.zip64
-        }, onProgress, { intervalMs: progressIntervalMs });
-        const queue = createAsyncQueue({
-            onCancel: () => {
+            // 1b) Best-effort preserved entries: extract and re-add.
+            for (let k = 0; k < preservedRecompressed.length; k++) {
+                throwIfAborted(signal);
+                const idx = preservedRaw.length + k;
+                const entry = preservedRecompressed[k];
+                let entryBytesIn = 0;
+                progress.update({ currentEntry: { name: entry.name, index: idx, bytesIn: 0 } });
+                let data;
                 try {
-                    controller.abort("cancelled");
+                    data = await this._remote.extractEntry(entry.info);
                 }
-                catch {
-                    // ignore
+                catch (e) {
+                    const err = toError(e);
+                    this._emitWarning(entry.info.path, "unknown", `Failed to extract entry "${entry.info.path}" for best-effort preserve: ${err.message}`);
+                    progress.set("entriesDone", progress.snapshot.entriesDone + 1);
+                    continue;
                 }
-            }
-        });
-        const zip = new StreamingZip((err, data, final) => {
-            if (err) {
-                progress.update({ phase: progress.snapshot.phase === "aborted" ? "aborted" : "error" });
-                queue.fail(err);
-                return;
-            }
-            if (data.length) {
+                const fallbackLevel = entry.info.compressionMethod === 0 ? 0 : this._options.level;
+                const file = new ZipDeflateFile(entry.name, buildZipDeflateFileOptions({
+                    level: fallbackLevel,
+                    modTime: entry.info.lastModified,
+                    comment: entry.info.comment,
+                    externalAttributes: entry.info.externalAttributes,
+                    versionMadeBy: entry.info.versionMadeBy
+                }, {
+                    level: this._options.level,
+                    modTime: this._options.modTime,
+                    timestamps: this._options.timestamps,
+                    smartStore: this._options.smartStore,
+                    zip64: this._options.zip64,
+                    path: this._options.path,
+                    encoding: this._options.encoding
+                }));
+                zip.add(file);
+                entryBytesIn += data.length;
                 progress.mutate(s => {
-                    s.bytesOut += data.length;
+                    s.bytesIn += data.length;
+                    s.currentEntry = { name: entry.name, index: idx, bytesIn: entryBytesIn };
                 });
-                queue.push(data);
-            }
-            if (final) {
-                if (progress.snapshot.phase === "running") {
-                    progress.update({ phase: "done" });
-                }
-                queue.close();
+                await file.push(data, true);
+                await file.complete();
+                progress.set("entriesDone", progress.snapshot.entriesDone + 1);
             }
-        }, {
-            comment: this._options.comment,
-            zip64: this._options.zip64,
-            codec: this._stringCodec
-        });
-        const onAbort = () => {
-            const err = createAbortError(signal.reason);
-            progress.update({ phase: "aborted" });
-            try {
-                zip.abort(err);
-            }
-            catch {
-                // ignore
-            }
-            queue.fail(err);
-        };
-        signal.addEventListener("abort", onAbort, { once: true });
-        (async () => {
-            try {
-                // 1) Preserved entries: passthrough raw payload.
-                for (let i = 0; i < preservedRaw.length; i++) {
-                    throwIfAborted(signal);
-                    const entry = preservedRaw[i];
-                    progress.update({ currentEntry: { name: entry.outName, index: i, bytesIn: 0 } });
-                    const rawFile = this._buildPreservedRawFile(entry.outName, entry.info, entry.compressedData, this._options.zip64);
-                    zip.add(rawFile);
-                    // StreamingZip auto-starts passthrough files; await completion for accurate progress.
-                    await rawFile.done();
-                    progress.set("entriesDone", progress.snapshot.entriesDone + 1);
-                }
-                // 1b) Best-effort preserved entries: extract and re-add.
-                for (let k = 0; k < preservedRecompressed.length; k++) {
-                    throwIfAborted(signal);
-                    const idx = preservedRaw.length + k;
-                    const entry = preservedRecompressed[k];
-                    let entryBytesIn = 0;
-                    progress.update({ currentEntry: { name: entry.name, index: idx, bytesIn: 0 } });
-                    let data;
-                    try {
-                        data = await this._remote.extractEntry(entry.info);
-                    }
-                    catch (e) {
-                        const err = toError(e);
-                        this._emitWarning(entry.info.path, "unknown", `Failed to extract entry "${entry.info.path}" for best-effort preserve: ${err.message}`);
-                        progress.set("entriesDone", progress.snapshot.entriesDone + 1);
-                        continue;
-                    }
-                    const fallbackLevel = entry.info.compressionMethod === 0 ? 0 : this._options.level;
-                    const file = new ZipDeflateFile(entry.name, buildZipDeflateFileOptions({
-                        level: fallbackLevel,
-                        modTime: entry.info.lastModified,
-                        comment: entry.info.comment,
-                        externalAttributes: entry.info.externalAttributes,
-                        versionMadeBy: entry.info.versionMadeBy
-                    }, {
-                        level: this._options.level,
-                        modTime: this._options.modTime,
-                        timestamps: this._options.timestamps,
-                        smartStore: this._options.smartStore,
-                        zip64: this._options.zip64,
-                        path: this._options.path,
-                        encoding: this._options.encoding
-                    }));
-                    zip.add(file);
-                    entryBytesIn += data.length;
+            // 2) Set/update entries: compress from source.
+            for (let j = 0; j < sets.length; j++) {
+                throwIfAborted(signal);
+                const idx = preservedRaw.length + preservedRecompressed.length + j;
+                const entry = sets[j];
+                let entryBytesIn = 0;
+                progress.update({ currentEntry: { name: entry.name, index: idx, bytesIn: 0 } });
+                const file = new ZipDeflateFile(entry.name, buildZipDeflateFileOptions(entry.options, {
+                    level: this._options.level,
+                    modTime: this._options.modTime,
+                    timestamps: this._options.timestamps,
+                    smartStore: this._options.smartStore,
+                    zip64: this._options.zip64,
+                    path: this._options.path,
+                    encoding: this._options.encoding
+                }));
+                zip.add(file);
+                const onChunk = (chunk) => {
+                    entryBytesIn += chunk.length;
                     progress.mutate(s => {
-                        s.bytesIn += data.length;
+                        s.bytesIn += chunk.length;
                         s.currentEntry = { name: entry.name, index: idx, bytesIn: entryBytesIn };
                     });
-                    await file.push(data, true);
-                    await file.complete();
-                    progress.set("entriesDone", progress.snapshot.entriesDone + 1);
-                }
-                // 2) Set/update entries: compress from source.
-                for (let j = 0; j < sets.length; j++) {
+                };
+                if (isSyncArchiveSource(entry.source)) {
+                    const bytes = toUint8ArraySync(entry.source);
                     throwIfAborted(signal);
-                    const idx = preservedRaw.length + preservedRecompressed.length + j;
-                    const entry = sets[j];
-                    let entryBytesIn = 0;
-                    progress.update({ currentEntry: { name: entry.name, index: idx, bytesIn: 0 } });
-                    const file = new ZipDeflateFile(entry.name, buildZipDeflateFileOptions(entry.options, {
-                        level: this._options.level,
-                        modTime: this._options.modTime,
-                        timestamps: this._options.timestamps,
-                        smartStore: this._options.smartStore,
-                        zip64: this._options.zip64,
-                        path: this._options.path,
-                        encoding: this._options.encoding
-                    }));
-                    zip.add(file);
-                    const onChunk = (chunk) => {
-                        entryBytesIn += chunk.length;
-                        progress.mutate(s => {
-                            s.bytesIn += chunk.length;
-                            s.currentEntry = { name: entry.name, index: idx, bytesIn: entryBytesIn };
-                        });
-                    };
-                    if (isSyncArchiveSource(entry.source)) {
-                        const bytes = toUint8ArraySync(entry.source);
-                        throwIfAborted(signal);
-                        onChunk(bytes);
-                        await file.push(bytes, true);
-                    }
-                    else {
-                        // Streaming path (includes Blob via toAsyncIterable(Blob) which prefers Blob.stream())
-                        for await (const chunk of toAsyncIterable(entry.source, { signal, onChunk })) {
-                            throwIfAborted(signal);
-                            await file.push(chunk, false);
-                        }
-                        throwIfAborted(signal);
-                        await file.push(new Uint8Array(0), true);
-                    }
-                    await file.complete();
-                    progress.set("entriesDone", progress.snapshot.entriesDone + 1);
-                }
-                throwIfAborted(signal);
-                zip.end();
-            }
-            catch (e) {
-                const err = toError(e);
-                if (err.name === "AbortError") {
-                    progress.update({ phase: "aborted" });
-                    try {
-                        zip.abort(err);
-                    }
-                    catch {
-                        // ignore
-                    }
+                    onChunk(bytes);
+                    await file.push(bytes, true);
                 }
                 else {
-                    progress.update({ phase: "error" });
-                }
-                queue.fail(err);
-            }
-            finally {
-                try {
-                    signal.removeEventListener("abort", onAbort);
-                }
-                catch {
-                    // ignore
+                    // Streaming path (includes Blob via toAsyncIterable(Blob) which prefers Blob.stream())
+                    for await (const chunk of toAsyncIterable(entry.source, { signal, onChunk })) {
+                        throwIfAborted(signal);
+                        await file.push(chunk, false);
+                    }
+                    throwIfAborted(signal);
+                    await file.push(new Uint8Array(0), true);
                 }
-                cleanupAbortLink();
-                progress.emitNow();
+                await file.complete();
+                progress.set("entriesDone", progress.snapshot.entriesDone + 1);
             }
-        })();
-        return {
-            iterable: queue.iterable,
-            signal,
-            abort(reason) {
-                controller.abort(reason);
-            },
-            pointer() {
-                return progress.snapshot.bytesOut;
-            },
-            progress() {
-                return progress.snapshotCopy();
-            }
-        };
+            throwIfAborted(signal);
+            zip.end();
+        });
     }
     /**
      * Get the output as a single Uint8Array.

package/dist/browser/modules/archive/zip/zip-output-pipeline.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shared output pipeline for ZIP streaming operations.
+ *
+ * Both `ZipArchive` and `ZipEditor` use an identical scaffolding pattern for
+ * their `operation()` method: signal/abort wiring, ProgressEmitter, async queue,
+ * StreamingZip callback, error handling, and return object construction.
+ * This module extracts that shared boilerplate into a single reusable function.
+ */
+import { StreamingZip } from "./stream.js";
+import { ProgressEmitter } from "../shared/progress.js";
+import type { ZipStringCodec, ZipStringEncoding } from "../shared/text.js";
+import type { Zip64Mode } from "../zip-spec/zip-records.js";
+import type { ZipOperation, ZipProgress, ZipStreamOptions } from "./progress.js";
+/** Resolved signal/progress options passed to the pipeline. */
+export interface ZipPipelineOptions {
+    signal?: AbortSignal;
+    onProgress?: ZipStreamOptions["onProgress"];
+    progressIntervalMs?: number;
+}
+/** Options for constructing the internal StreamingZip instance. */
+export interface ZipPipelineZipOptions {
+    comment?: string;
+    zip64?: Zip64Mode;
+    encoding?: ZipStringEncoding;
+    codec?: ZipStringCodec;
+}
+/**
+ * Callback that processes entries within the pipeline.
+ *
+ * The pipeline sets up all scaffolding (abort, progress, queue, StreamingZip)
+ * and then calls this function to do the actual per-entry work. The callback
+ * receives:
+ *
+ * - `zip`      — the StreamingZip instance to add files to
+ * - `signal`   — the linked AbortSignal
+ * - `progress` — the ProgressEmitter to update
+ *
+ * The callback MUST call `zip.end()` when all entries have been added.
+ * It SHOULD call `throwIfAborted(signal)` between entries.
+ */
+export type ZipPipelineProcessFn = (ctx: {
+    zip: StreamingZip;
+    signal: AbortSignal;
+    progress: ProgressEmitter<ZipProgress>;
+}) => Promise<void>;
+/**
+ * Create a streaming ZIP operation with all shared boilerplate wired up.
+ *
+ * @param entriesTotal - Total number of entries (for progress reporting)
+ * @param zipOptions   - Options for the StreamingZip instance
+ * @param pipelineOpts - Signal, progress callback, and interval
+ * @param processFn    - Callback that adds entries to the StreamingZip
+ * @returns A `ZipOperation` handle
+ */
+export declare function createZipOperation(entriesTotal: number, zipOptions: ZipPipelineZipOptions, pipelineOpts: ZipPipelineOptions, processFn: ZipPipelineProcessFn): ZipOperation;

package/dist/browser/modules/archive/zip/zip-output-pipeline.js

@@ -0,0 +1,127 @@
+/**
+ * Shared output pipeline for ZIP streaming operations.
+ *
+ * Both `ZipArchive` and `ZipEditor` use an identical scaffolding pattern for
+ * their `operation()` method: signal/abort wiring, ProgressEmitter, async queue,
+ * StreamingZip callback, error handling, and return object construction.
+ * This module extracts that shared boilerplate into a single reusable function.
+ */
+import { StreamingZip } from "./stream.js";
+import { createAsyncQueue } from "../shared/async-queue.js";
+import { createLinkedAbortController, createAbortError, toError } from "../shared/errors.js";
+import { ProgressEmitter } from "../shared/progress.js";
+// =============================================================================
+// Pipeline
+// =============================================================================
+/**
+ * Create a streaming ZIP operation with all shared boilerplate wired up.
+ *
+ * @param entriesTotal - Total number of entries (for progress reporting)
+ * @param zipOptions   - Options for the StreamingZip instance
+ * @param pipelineOpts - Signal, progress callback, and interval
+ * @param processFn    - Callback that adds entries to the StreamingZip
+ * @returns A `ZipOperation` handle
+ */
+export function createZipOperation(entriesTotal, zipOptions, pipelineOpts, processFn) {
+    const { controller, cleanup: cleanupAbortLink } = createLinkedAbortController(pipelineOpts.signal);
+    const signal = controller.signal;
+    const progress = new ProgressEmitter({
+        type: "zip",
+        phase: "running",
+        entriesTotal,
+        entriesDone: 0,
+        bytesIn: 0,
+        bytesOut: 0,
+        zip64: zipOptions.zip64 ?? "auto"
+    }, pipelineOpts.onProgress, { intervalMs: pipelineOpts.progressIntervalMs });
+    const queue = createAsyncQueue({
+        onCancel: () => {
+            try {
+                controller.abort("cancelled");
+            }
+            catch {
+                // ignore
+            }
+        }
+    });
+    const zip = new StreamingZip((err, data, final) => {
+        if (err) {
+            progress.update({ phase: progress.snapshot.phase === "aborted" ? "aborted" : "error" });
+            queue.fail(err);
+            return;
+        }
+        if (data.length) {
+            progress.mutate(s => {
+                s.bytesOut += data.length;
+            });
+            queue.push(data);
+        }
+        if (final) {
+            if (progress.snapshot.phase === "running") {
+                progress.update({ phase: "done" });
+            }
+            queue.close();
+        }
+    }, {
+        comment: zipOptions.comment,
+        zip64: zipOptions.zip64,
+        encoding: zipOptions.encoding,
+        codec: zipOptions.codec
+    });
+    const onAbort = () => {
+        const err = createAbortError(signal.reason);
+        progress.update({ phase: "aborted" });
+        try {
+            zip.abort(err);
+        }
+        catch {
+            // ignore
+        }
+        queue.fail(err);
+    };
+    signal.addEventListener("abort", onAbort, { once: true });
+    (async () => {
+        try {
+            await processFn({ zip, signal, progress });
+        }
+        catch (e) {
+            const err = toError(e);
+            if (err.name === "AbortError") {
+                progress.update({ phase: "aborted" });
+                try {
+                    zip.abort(err);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            else {
+                progress.update({ phase: "error" });
+            }
+            queue.fail(err);
+        }
+        finally {
+            try {
+                signal.removeEventListener("abort", onAbort);
+            }
+            catch {
+                // ignore
+            }
+            cleanupAbortLink();
+            progress.emitNow();
+        }
+    })();
+    return {
+        iterable: queue.iterable,
+        signal,
+        abort(reason) {
+            controller.abort(reason);
+        },
+        pointer() {
+            return progress.snapshot.bytesOut;
+        },
+        progress() {
+            return progress.snapshotCopy();
+        }
+    };
+}

package/dist/cjs/modules/archive/create-archive.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zip = zip;
+const tar_archive_1 = require("./tar/tar-archive.js");
+const zip_archive_1 = require("./zip/zip-archive.js");
+function zip(options = {}) {
+    if (options.format === "tar") {
+        return new tar_archive_1.TarArchive({
+            modTime: options.modTime,
+            signal: options.signal,
+            onProgress: options.onProgress,
+            progressIntervalMs: options.progressIntervalMs
+        });
+    }
+    return new zip_archive_1.ZipArchive({ ...options, format: "zip" });
+}

package/dist/cjs/modules/archive/index.base.js

@@ -7,8 +7,8 @@
  * from this file and then layer their platform-specific bindings.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.base64ToUint8Array = exports.isTarDataEntry = exports.isTarHardLink = exports.isTarSymlink = exports.isTarDirectory = exports.isTarFile = exports.untar = exports.parseTarStream = exports.parseTar = exports.tarSync = exports.tar = exports.createTarReader = exports.createTarArchive = exports.TarReaderEntry = exports.TarReader = exports.TarArchive = exports.TAR_TYPE = exports.TAR_BLOCK_SIZE = exports.createReader = exports.createArchive = exports.UnzipEntry = exports.ZipReader = exports.unzip = exports.ZipEditPlan = exports.editZipUrl = exports.editZip = exports.ZipEditor = exports.ZipArchive = exports.zip = exports.EntrySizeMismatchError = exports.UnsupportedCompressionError = exports.FileTooLargeError = exports.PasswordRequiredError = exports.DecryptionError = exports.EocdNotFoundError = exports.InvalidZipSignatureError = exports.ZipParseError = exports.ArchiveError = exports.throwIfAborted = exports.isAbortError = exports.createAbortError = exports.AbortError = exports.Crc32MismatchError = exports.RemoteZipReader = exports.HttpRangeError = exports.RangeNotSupportedError = exports.BufferReader = exports.HttpRangeReader = exports.toReadableStream = exports.toAsyncIterable = void 0;
-exports.encryptionMethodFromAesKeyStrength = exports.getAesKeyStrength = exports.isAesEncryption = exports.getEncryptionMethodName = exports.randomBytes = exports.buildAesExtraField = exports.aesEncryptedSize = exports.aesEncrypt = exports.aesDecrypt = exports.COMPRESSION_METHOD_AES = exports.AES_PASSWORD_VERIFY_LENGTH = exports.AES_AUTH_CODE_LENGTH = exports.AES_KEY_LENGTH = exports.AES_SALT_LENGTH = exports.AES_EXTRA_FIELD_ID = exports.AES_VERSION_AE2 = exports.AES_VERSION_AE1 = exports.AES_VENDOR_ID = exports.zipCryptoEncrypt = exports.zipCryptoDecrypt = exports.zipCryptoInitKeys = exports.ZIP_CRYPTO_HEADER_SIZE = exports.uint8ArrayToString = exports.stringToUint8Array = exports.concatUint8Arrays = exports.uint8ArrayToBase64 = void 0;
+exports.concatUint8Arrays = exports.uint8ArrayToBase64 = exports.base64ToUint8Array = exports.isTarDataEntry = exports.isTarHardLink = exports.isTarSymlink = exports.isTarDirectory = exports.isTarFile = exports.untar = exports.parseTarStream = exports.parseTar = exports.tarSync = exports.tar = exports.createTarReader = exports.createTarArchive = exports.TarReaderEntry = exports.TarReader = exports.TarArchive = exports.TAR_TYPE = exports.TAR_BLOCK_SIZE = exports.UnzipEntry = exports.ZipReader = exports.ZipEditPlan = exports.editZipUrl = exports.editZip = exports.ZipEditor = exports.ZipArchive = exports.unzip = exports.zip = exports.EntrySizeMismatchError = exports.UnsupportedCompressionError = exports.FileTooLargeError = exports.PasswordRequiredError = exports.DecryptionError = exports.EocdNotFoundError = exports.InvalidZipSignatureError = exports.ZipParseError = exports.ArchiveError = exports.throwIfAborted = exports.isAbortError = exports.createAbortError = exports.AbortError = exports.Crc32MismatchError = exports.RemoteZipReader = exports.HttpRangeError = exports.RangeNotSupportedError = exports.BufferReader = exports.HttpRangeReader = exports.toReadableStream = exports.toAsyncIterable = void 0;
+exports.encryptionMethodFromAesKeyStrength = exports.getAesKeyStrength = exports.isAesEncryption = exports.getEncryptionMethodName = exports.randomBytes = exports.buildAesExtraField = exports.aesEncryptedSize = exports.aesEncrypt = exports.aesDecrypt = exports.COMPRESSION_METHOD_AES = exports.AES_PASSWORD_VERIFY_LENGTH = exports.AES_AUTH_CODE_LENGTH = exports.AES_KEY_LENGTH = exports.AES_SALT_LENGTH = exports.AES_EXTRA_FIELD_ID = exports.AES_VERSION_AE2 = exports.AES_VERSION_AE1 = exports.AES_VENDOR_ID = exports.zipCryptoEncrypt = exports.zipCryptoDecrypt = exports.zipCryptoInitKeys = exports.ZIP_CRYPTO_HEADER_SIZE = exports.uint8ArrayToString = exports.stringToUint8Array = void 0;
 var archive_source_1 = require("./io/archive-source.js");
 Object.defineProperty(exports, "toAsyncIterable", { enumerable: true, get: function () { return archive_source_1.toAsyncIterable; } });
 Object.defineProperty(exports, "toReadableStream", { enumerable: true, get: function () { return archive_source_1.toReadableStream; } });
@@ -18,7 +18,7 @@ Object.defineProperty(exports, "HttpRangeReader", { enumerable: true, get: funct
 Object.defineProperty(exports, "BufferReader", { enumerable: true, get: function () { return random_access_1.BufferReader; } });
 Object.defineProperty(exports, "RangeNotSupportedError", { enumerable: true, get: function () { return random_access_1.RangeNotSupportedError; } });
 Object.defineProperty(exports, "HttpRangeError", { enumerable: true, get: function () { return random_access_1.HttpRangeError; } });
-var remote_zip_reader_1 = require("./io/remote-zip-reader.js");
+var remote_zip_reader_1 = require("./unzip/remote-zip-reader.js");
 Object.defineProperty(exports, "RemoteZipReader", { enumerable: true, get: function () { return remote_zip_reader_1.RemoteZipReader; } });
 Object.defineProperty(exports, "Crc32MismatchError", { enumerable: true, get: function () { return remote_zip_reader_1.Crc32MismatchError; } });
 // Abort and Error types - all from centralized errors module
@@ -39,21 +39,19 @@ Object.defineProperty(exports, "FileTooLargeError", { enumerable: true, get: fun
 Object.defineProperty(exports, "UnsupportedCompressionError", { enumerable: true, get: function () { return errors_1.UnsupportedCompressionError; } });
 Object.defineProperty(exports, "EntrySizeMismatchError", { enumerable: true, get: function () { return errors_1.EntrySizeMismatchError; } });
 // High-level APIs
+var create_archive_1 = require("./create-archive.js");
+Object.defineProperty(exports, "zip", { enumerable: true, get: function () { return create_archive_1.zip; } });
+var read_archive_1 = require("./read-archive.js");
+Object.defineProperty(exports, "unzip", { enumerable: true, get: function () { return read_archive_1.unzip; } });
 var zip_1 = require("./zip/index.js");
-Object.defineProperty(exports, "zip", { enumerable: true, get: function () { return zip_1.zip; } });
 Object.defineProperty(exports, "ZipArchive", { enumerable: true, get: function () { return zip_1.ZipArchive; } });
 Object.defineProperty(exports, "ZipEditor", { enumerable: true, get: function () { return zip_1.ZipEditor; } });
 Object.defineProperty(exports, "editZip", { enumerable: true, get: function () { return zip_1.editZip; } });
 Object.defineProperty(exports, "editZipUrl", { enumerable: true, get: function () { return zip_1.editZipUrl; } });
 Object.defineProperty(exports, "ZipEditPlan", { enumerable: true, get: function () { return zip_1.ZipEditPlan; } });
 var unzip_1 = require("./unzip/index.js");
-Object.defineProperty(exports, "unzip", { enumerable: true, get: function () { return unzip_1.unzip; } });
 Object.defineProperty(exports, "ZipReader", { enumerable: true, get: function () { return unzip_1.ZipReader; } });
 Object.defineProperty(exports, "UnzipEntry", { enumerable: true, get: function () { return unzip_1.UnzipEntry; } });
-// Format registry (ZIP/TAR dispatch)
-var formats_1 = require("./formats/index.js");
-Object.defineProperty(exports, "createArchive", { enumerable: true, get: function () { return formats_1.createArchive; } });
-Object.defineProperty(exports, "createReader", { enumerable: true, get: function () { return formats_1.createReader; } });
 // TAR archive support (unified API compatible with ZIP)
 // Note: Gzip helpers are exported separately in index.ts / index.browser.ts
 var index_browser_1 = require("./tar/index.browser.js");

package/dist/cjs/modules/archive/read-archive.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unzip = unzip;
+const tar_archive_1 = require("./tar/tar-archive.js");
+const zip_reader_1 = require("./unzip/zip-reader.js");
+function unzip(source, options = {}) {
+    if (options.format === "tar") {
+        return new tar_archive_1.TarReader(source, {
+            signal: options.signal,
+            onProgress: options.onProgress,
+            progressIntervalMs: options.progressIntervalMs
+        });
+    }
+    return new zip_reader_1.ZipReader(source, { ...options, format: "zip" });
+}

package/dist/cjs/modules/archive/unzip/index.js

@@ -1,11 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZipReader = exports.UnzipEntry = void 0;
-exports.unzip = unzip;
-const formats_1 = require("../formats/index.js");
 var zip_reader_1 = require("./zip-reader");
 Object.defineProperty(exports, "UnzipEntry", { enumerable: true, get: function () { return zip_reader_1.UnzipEntry; } });
 Object.defineProperty(exports, "ZipReader", { enumerable: true, get: function () { return zip_reader_1.ZipReader; } });
-function unzip(source, options) {
-    return (0, formats_1.createReader)(source, options);
-}