fileport-gateway 0.1.7 → 0.2.0

package/README.md

@@ -14,7 +14,8 @@ Implemented:
 - reverse proxy with GET/HEAD/Range;
 - traversal, encoded-path and symlink-escape protection;
 - CLI and browser preview shell;
-- explicit RO/RW shares, expiry and strict existing-file-only atomic saves.
+- explicit RO/RW shares, expiry and strict existing-file-only atomic saves;
+- in-browser archive browsing and bounded entry preview for ZIP and compressed tar files.
 
 See [current architecture](docs/CURRENT_ARCHITECTURE,md), [Dufs compatibility](docs/DUFS_COMPATIBILITY,md), and [migration plan](docs/MIGRATION_PLAN,md), and [network/CLI contract](docs/NETWORK_AND_CLI.md).
 
@@ -58,6 +59,22 @@ fileport share ./report.md --readonly
 
 Proxy mode treats `public.url` as the externally advertised URL. DNS is reported for diagnostics but is not required to resolve to a local interface, and the public port does not need to equal the origin listener port. Fileport does not configure or verify the reverse proxy itself; verify the resulting capability URL end to end.
 
+## Archive browsing
+
+The preview shell recognizes these formats by filename extension:
+
+- ZIP: `.zip`
+- tar: `.tar`
+- gzip-compressed tar: `.tar.gz`, `.tgz`
+- bzip2-compressed tar: `.tar.bz2`, `.tbz`, `.tbz2`
+- xz-compressed tar: `.tar.xz`, `.txz`
+
+Opening one of these files shows a sorted archive manifest with entry paths, types, uncompressed sizes and ZIP encryption status. Entries marked previewable—supported, unencrypted regular files of at most 10 MiB—can be opened with magic-validated image, PDF or media previews, sanitized Markdown/source/text views, and bounded binary-entry download behavior; a selected binary entry can be downloaded from that view. The original archive remains available through Download. Archive entries are read-only even when the enclosing share is RW.
+
+Fileport streams archive parsing and decompression and never extracts archive contents to disk. A selected entry is buffered in memory only after its size has passed the preview checks. Limits are a 512 MiB archive input file, 10,000 entries per archive, 4 KiB per entry path, 4 MiB of aggregate manifest path text, 256 MiB of expanded data per tar scan, and 10 MiB per entry preview. Archive work runs in memory-limited worker threads with bounded global/per-archive concurrency and a 15-second wall-clock timeout. Tar archives are rescanned when an entry is opened; the limit applies to every such scan.
+
+Unsafe archive paths are omitted from the manifest and counted. Leading `./` prefixes and trailing directory slashes are normalized; after that, absolute paths, drive-prefixed paths, backslashes, NULs, empty components, and `.` or `..` components are unsafe. Symlinks, hard links and other non-regular entries may be listed but are never followed or previewed. Encrypted ZIP entries and regular files over the preview limit are listed as non-previewable; download the original archive to handle them with a trusted local tool.
+
 ```bash
 fileport --help
 fileport share --help

package/THIRD_PARTY_NOTICES.md

@@ -10,3 +10,23 @@ Fileport Gateway packages the official Linux x86_64 musl binary of [Dufs](https:
 - Release archive SHA256: `817769f726613194bcff9d0e3e481eaccc86ac11208857614f36a8c02f410977`
 
 The corresponding license texts are included in `vendor/LICENSE-DUFS-APACHE` and `vendor/LICENSE-DUFS-MIT`.
+
+## Archive preview dependencies
+
+The archive preview implementation uses the following direct runtime dependencies. Versions shown are the versions currently locked by `package-lock.json`.
+
+| Package | Purpose | License | Source |
+|---|---|---|---|
+| `yauzl` 3.4.0 | Lazy ZIP directory and entry streaming | MIT | https://github.com/thejoshwolfe/yauzl |
+| `tar-stream` 3.2.1 | Streaming tar parsing | MIT | https://github.com/mafintosh/tar-stream |
+| `unbzip2-stream` 1.4.3 | Streaming bzip2 decompression | MIT | https://github.com/regular/unbzip2-stream |
+| `xz-decompress` 0.2.3 | WebAssembly-backed streaming xz decompression | MIT (package declaration) | https://github.com/httptoolkit/xz-decompress |
+| `mime-types` 3.0.1 | Content types for entry preview responses | MIT | https://github.com/jshttp/mime-types |
+
+`xz-decompress` includes the following upstream code, as declared by the notice embedded in its distributed JavaScript bundle:
+
+- `xzwasm`, copyright Steve Sanderson, MIT license: https://github.com/SteveSanderson/xzwasm
+- `xz-embedded`, by Lasse Collin and Igor Pavlov, public domain: https://tukaani.org/xz/embedded.html
+- `walloc`, copyright 2020 Igalia, S.L., MIT license: https://github.com/wingo/walloc
+
+Gzip decompression is provided by Node.js's built-in `node:zlib` module rather than an additional npm package. Package copyright and license texts are available from the linked upstream repositories and installed package distributions.

package/dist/archive-engine.d.ts

@@ -0,0 +1,42 @@
+export declare const MAX_ARCHIVE_ENTRIES = 10000;
+export declare const MAX_ARCHIVE_SCAN_BYTES: number;
+export declare const MAX_ARCHIVE_FILE_BYTES: number;
+export declare const MAX_ARCHIVE_ENTRY_BYTES: number;
+export declare const MAX_ARCHIVE_PATH_BYTES = 4096;
+export declare const MAX_ARCHIVE_MANIFEST_PATH_BYTES: number;
+export type ArchiveFormat = "zip" | "tar" | "tar.gz" | "tar.bz2" | "tar.xz";
+export type ArchiveEntryType = "file" | "directory" | "symlink" | "other";
+export interface ArchiveEntry {
+    path: string;
+    type: ArchiveEntryType;
+    size: number;
+    compressedSize?: number;
+    modifiedAt?: string;
+    previewable: boolean;
+    encrypted?: boolean;
+}
+export interface ArchiveManifest {
+    format: ArchiveFormat;
+    entries: ArchiveEntry[];
+    skippedUnsafe: number;
+    limits: {
+        maxEntries: number;
+        maxArchiveBytes: number;
+        maxScannedBytes: number;
+        maxPreviewBytes: number;
+    };
+}
+export interface ArchiveContent {
+    entry: ArchiveEntry;
+    body: Buffer;
+    contentType: string;
+}
+export declare class ArchiveError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message?: string);
+}
+export declare function archiveFormat(file: string): ArchiveFormat | undefined;
+export declare function isArchivePath(file: string): boolean;
+export declare function listArchive(file: string, expectedRealPath?: string): Promise<ArchiveManifest>;
+export declare function readArchiveEntry(file: string, rawEntry: string, expectedRealPath?: string): Promise<ArchiveContent>;

package/dist/archive-engine.js

@@ -0,0 +1,372 @@
+import { close as closeFd, constants, createReadStream, fstat, open as openFd } from "node:fs";
+import { realpath } from "node:fs/promises";
+import { createGunzip } from "node:zlib";
+import { createRequire } from "node:module";
+import unbzip2 from "unbzip2-stream";
+import { Readable, Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { contentType, lookup } from "mime-types";
+import { extract } from "tar-stream";
+import { fromFdPromise } from "yauzl";
+const { XzReadableStream } = createRequire(import.meta.url)("xz-decompress");
+export const MAX_ARCHIVE_ENTRIES = 10_000;
+export const MAX_ARCHIVE_SCAN_BYTES = 256 * 1024 * 1024;
+export const MAX_ARCHIVE_FILE_BYTES = 512 * 1024 * 1024;
+export const MAX_ARCHIVE_ENTRY_BYTES = 10 * 1024 * 1024;
+export const MAX_ARCHIVE_PATH_BYTES = 4096;
+export const MAX_ARCHIVE_MANIFEST_PATH_BYTES = 4 * 1024 * 1024;
+class ArchiveEntryFound extends Error {
+}
+export class ArchiveError extends Error {
+    status;
+    code;
+    constructor(status, code, message = code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+}
+class ByteLimitTransform extends Transform {
+    limit;
+    seen = 0;
+    constructor(limit) {
+        super();
+        this.limit = limit;
+    }
+    _transform(chunk, _encoding, callback) {
+        this.seen += chunk.length;
+        if (this.seen > this.limit)
+            return callback(new ArchiveError(413, "archive_scan_too_large", `archive expands beyond the ${this.limit} byte scan limit`));
+        callback(null, chunk);
+    }
+}
+export function archiveFormat(file) {
+    const lower = file.toLowerCase();
+    if (lower.endsWith(".zip"))
+        return "zip";
+    if (lower.endsWith(".tar.gz") || lower.endsWith(".tgz"))
+        return "tar.gz";
+    if (lower.endsWith(".tar.bz2") || lower.endsWith(".tbz2") || lower.endsWith(".tbz"))
+        return "tar.bz2";
+    if (lower.endsWith(".tar.xz") || lower.endsWith(".txz"))
+        return "tar.xz";
+    if (lower.endsWith(".tar"))
+        return "tar";
+    return undefined;
+}
+export function isArchivePath(file) { return archiveFormat(file) !== undefined; }
+function safeArchivePath(raw) {
+    if (!raw || raw.includes("\0") || raw.includes("\\") || raw.startsWith("/") || /^[A-Za-z]:/.test(raw))
+        return undefined;
+    let value = raw;
+    while (value.startsWith("./"))
+        value = value.slice(2);
+    value = value.replace(/\/+$/, "");
+    if (!value || value === ".")
+        return undefined;
+    const parts = value.split("/");
+    if (parts.some(part => !part || part === "." || part === ".."))
+        return undefined;
+    return parts.join("/");
+}
+function requestedEntryPath(raw) {
+    const normalized = safeArchivePath(raw);
+    if (!normalized)
+        throw new ArchiveError(400, "unsafe_archive_path", "unsafe archive entry path");
+    return normalized;
+}
+function limits() { return { maxEntries: MAX_ARCHIVE_ENTRIES, maxArchiveBytes: MAX_ARCHIVE_FILE_BYTES, maxScannedBytes: MAX_ARCHIVE_SCAN_BYTES, maxPreviewBytes: MAX_ARCHIVE_ENTRY_BYTES }; }
+function mimeFor(file, body) {
+    const lower = file.toLowerCase(), textual = /\.(?:md|markdown|txt|json|csv|tsv|ya?ml|toml|xml|html?|css|js|mjs|cjs|ts|tsx|jsx|py|go|rs|java|kt|sh|bash|zsh|fish|sql|log|ini|conf)$/i.test(lower);
+    if (textual) {
+        try {
+            new TextDecoder("utf-8", { fatal: true }).decode(body);
+            return contentType(lookup(file) || "text/plain") || "text/plain; charset=utf-8";
+        }
+        catch {
+            return "application/octet-stream";
+        }
+    }
+    if (body.length >= 8 && body.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])))
+        return "image/png";
+    if (body.length >= 3 && body[0] === 0xff && body[1] === 0xd8 && body[2] === 0xff)
+        return "image/jpeg";
+    if (body.length >= 6 && (body.subarray(0, 6).toString("ascii") === "GIF87a" || body.subarray(0, 6).toString("ascii") === "GIF89a"))
+        return "image/gif";
+    if (body.length >= 12 && body.subarray(0, 4).toString("ascii") === "RIFF" && body.subarray(8, 12).toString("ascii") === "WEBP")
+        return "image/webp";
+    if (body.length >= 12 && body.subarray(0, 4).toString("ascii") === "RIFF" && body.subarray(8, 12).toString("ascii") === "WAVE")
+        return "audio/wav";
+    if (body.length >= 4 && body.subarray(0, 4).toString("ascii") === "OggS")
+        return "audio/ogg";
+    if (body.length >= 4 && body.subarray(0, 4).toString("ascii") === "fLaC")
+        return "audio/flac";
+    if (body.length >= 3 && body.subarray(0, 3).toString("ascii") === "ID3" || body.length >= 2 && body[0] === 0xff && (body[1] & 0xe0) === 0xe0)
+        return "audio/mpeg";
+    if (body.length >= 12 && body.subarray(4, 8).toString("ascii") === "ftyp")
+        return "video/mp4";
+    if (body.length >= 4 && body[0] === 0x1a && body[1] === 0x45 && body[2] === 0xdf && body[3] === 0xa3)
+        return "video/webm";
+    if (body.length >= 5 && body.subarray(0, 5).toString("ascii") === "%PDF-")
+        return "application/pdf";
+    return "application/octet-stream";
+}
+function zipType(entry) {
+    if (entry.fileName.endsWith("/"))
+        return "directory";
+    const unixType = (entry.externalFileAttributes >>> 16) & 0xf000;
+    if (unixType === 0xa000)
+        return "symlink";
+    if (unixType && unixType !== 0x8000)
+        return "other";
+    return "file";
+}
+function tarType(header) {
+    if (header.type === "file" || header.type === "contiguous-file")
+        return "file";
+    if (header.type === "directory")
+        return "directory";
+    if (header.type === "link" || header.type === "symlink")
+        return "symlink";
+    return "other";
+}
+function archiveEntry(path, type, size, modifiedAt, compressedSize, encrypted) {
+    return { path, type, size, ...(compressedSize === undefined ? {} : { compressedSize }), ...(modifiedAt ? { modifiedAt } : {}), previewable: type === "file" && !encrypted && size <= MAX_ARCHIVE_ENTRY_BYTES, ...(encrypted ? { encrypted: true } : {}) };
+}
+function stableEntries(entries) { return entries.sort((a, b) => a.path.localeCompare(b.path) || a.type.localeCompare(b.type)); }
+async function openArchiveFile(file, expectedRealPath) {
+    let handle;
+    try {
+        handle = await new Promise((resolve, reject) => openFd(file, constants.O_RDONLY | constants.O_NOFOLLOW, (error, fd) => error ? reject(error) : resolve(fd)));
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ELOOP")
+            throw new ArchiveError(409, "archive_target_changed", "archive target changed during authorization");
+        throw error;
+    }
+    const stat = await new Promise((resolve, reject) => fstat(handle, (error, value) => error ? reject(error) : resolve(value)));
+    let actual;
+    try {
+        actual = await realpath(`/proc/self/fd/${handle}`);
+    }
+    catch {
+        await closeArchiveFile(handle);
+        throw new ArchiveError(409, "archive_target_changed", "cannot verify opened archive target");
+    }
+    if (actual !== expectedRealPath) {
+        await closeArchiveFile(handle);
+        throw new ArchiveError(409, "archive_target_changed", "archive target changed during authorization");
+    }
+    if (!stat.isFile()) {
+        await closeArchiveFile(handle);
+        throw new ArchiveError(415, "archive_not_regular_file");
+    }
+    if (stat.size > MAX_ARCHIVE_FILE_BYTES) {
+        await closeArchiveFile(handle);
+        throw new ArchiveError(413, "archive_file_too_large", `archive exceeds the ${MAX_ARCHIVE_FILE_BYTES} byte input limit`);
+    }
+    return handle;
+}
+async function closeArchiveFile(handle) {
+    await new Promise((resolve, reject) => closeFd(handle, error => error && error.code !== "EBADF" ? reject(error) : resolve()));
+}
+async function listZip(file, expectedRealPath) {
+    const handle = await openArchiveFile(file, expectedRealPath);
+    let zip;
+    try {
+        zip = await fromFdPromise(handle, { lazyEntries: true, autoClose: false, validateEntrySizes: true, strictFileNames: false });
+    }
+    catch {
+        await closeArchiveFile(handle);
+        throw new ArchiveError(422, "invalid_archive", "cannot read ZIP archive");
+    }
+    if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {
+        try {
+            zip.close();
+        }
+        catch { }
+        throw new ArchiveError(413, "archive_too_many_entries", `archive contains more than ${MAX_ARCHIVE_ENTRIES} entries`);
+    }
+    const entries = [];
+    let skippedUnsafe = 0, pathBytes = 0;
+    try {
+        for await (const item of zip.eachEntry()) {
+            if (entries.length >= MAX_ARCHIVE_ENTRIES)
+                throw new ArchiveError(413, "archive_too_many_entries", `archive contains more than ${MAX_ARCHIVE_ENTRIES} entries`);
+            const normalized = safeArchivePath(item.fileName);
+            if (!normalized) {
+                skippedUnsafe++;
+                continue;
+            }
+            const bytes = Buffer.byteLength(normalized);
+            if (bytes > MAX_ARCHIVE_PATH_BYTES)
+                throw new ArchiveError(413, "archive_path_too_long");
+            pathBytes += bytes;
+            if (pathBytes > MAX_ARCHIVE_MANIFEST_PATH_BYTES)
+                throw new ArchiveError(413, "archive_manifest_too_large");
+            const type = zipType(item), encrypted = item.isEncrypted();
+            let modifiedAt;
+            try {
+                modifiedAt = item.getLastModDate().toISOString();
+            }
+            catch { }
+            const meta = archiveEntry(normalized, type, item.uncompressedSize, modifiedAt, item.compressedSize, encrypted);
+            meta.previewable = meta.previewable && item.canDecodeFileData() && item.compressedSize <= MAX_ARCHIVE_SCAN_BYTES;
+            entries.push(meta);
+        }
+    }
+    catch (error) {
+        if (error instanceof ArchiveError)
+            throw error;
+        throw new ArchiveError(422, "invalid_archive", "cannot read ZIP archive");
+    }
+    finally {
+        try {
+            zip.close();
+        }
+        catch { }
+    }
+    return { format: "zip", entries: stableEntries(entries), skippedUnsafe, limits: limits() };
+}
+async function readZipEntry(file, requested, expectedRealPath) {
+    const handle = await openArchiveFile(file, expectedRealPath);
+    let zip;
+    try {
+        zip = await fromFdPromise(handle, { lazyEntries: true, autoClose: false, validateEntrySizes: true, strictFileNames: false });
+    }
+    catch {
+        await closeArchiveFile(handle);
+        throw new ArchiveError(422, "invalid_archive", "cannot read ZIP archive");
+    }
+    if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {
+        try {
+            zip.close();
+        }
+        catch { }
+        throw new ArchiveError(413, "archive_too_many_entries", `archive contains more than ${MAX_ARCHIVE_ENTRIES} entries`);
+    }
+    try {
+        for await (const item of zip.eachEntry()) {
+            const normalized = safeArchivePath(item.fileName);
+            if (normalized !== requested)
+                continue;
+            const type = zipType(item), encrypted = item.isEncrypted(), meta = archiveEntry(normalized, type, item.uncompressedSize, undefined, item.compressedSize, encrypted);
+            if (type !== "file" || encrypted || !item.canDecodeFileData())
+                throw new ArchiveError(415, encrypted ? "archive_entry_encrypted" : "archive_entry_not_previewable");
+            if (item.uncompressedSize > MAX_ARCHIVE_ENTRY_BYTES || item.compressedSize > MAX_ARCHIVE_SCAN_BYTES)
+                throw new ArchiveError(413, "archive_entry_too_large", `archive entry exceeds the ${MAX_ARCHIVE_ENTRY_BYTES} byte preview limit`);
+            const stream = await zip.openReadStreamPromise(item);
+            const chunks = [];
+            let size = 0;
+            for await (const chunk of stream) {
+                const value = Buffer.from(chunk);
+                size += value.length;
+                if (size > MAX_ARCHIVE_ENTRY_BYTES) {
+                    stream.destroy();
+                    throw new ArchiveError(413, "archive_entry_too_large");
+                }
+                chunks.push(value);
+            }
+            const body = Buffer.concat(chunks);
+            return { entry: meta, body, contentType: mimeFor(requested, body) };
+        }
+        throw new ArchiveError(404, "archive_entry_not_found");
+    }
+    catch (error) {
+        if (error instanceof ArchiveError)
+            throw error;
+        throw new ArchiveError(422, "invalid_archive", "cannot extract ZIP entry");
+    }
+    finally {
+        try {
+            zip.close();
+        }
+        catch { }
+    }
+}
+async function scanTar(file, format, expectedRealPath, requested) {
+    const parser = extract();
+    const entries = [];
+    let seenEntries = 0, skippedUnsafe = 0, pathBytes = 0, content, parserError;
+    parser.on("entry", (header, stream, next) => {
+        const normalized = safeArchivePath(header.name), type = tarType(header), size = Number(header.size || 0);
+        if (!Number.isSafeInteger(size) || size < 0)
+            return next(new ArchiveError(422, "invalid_archive", "invalid tar entry size"));
+        seenEntries++;
+        if (seenEntries > MAX_ARCHIVE_ENTRIES)
+            return next(new ArchiveError(413, "archive_too_many_entries", `archive contains more than ${MAX_ARCHIVE_ENTRIES} entries`));
+        if (!normalized) {
+            skippedUnsafe++;
+            stream.on("end", () => next());
+            stream.resume();
+            return;
+        }
+        const bytes = Buffer.byteLength(normalized);
+        if (bytes > MAX_ARCHIVE_PATH_BYTES)
+            return next(new ArchiveError(413, "archive_path_too_long"));
+        pathBytes += bytes;
+        if (pathBytes > MAX_ARCHIVE_MANIFEST_PATH_BYTES)
+            return next(new ArchiveError(413, "archive_manifest_too_large"));
+        const modifiedAt = header.mtime instanceof Date && !Number.isNaN(header.mtime.getTime()) ? header.mtime.toISOString() : undefined;
+        const meta = archiveEntry(normalized, type, size, modifiedAt);
+        entries.push(meta);
+        if (requested === normalized) {
+            if (type !== "file")
+                return next(new ArchiveError(415, "archive_entry_not_previewable"));
+            if (size > MAX_ARCHIVE_ENTRY_BYTES)
+                return next(new ArchiveError(413, "archive_entry_too_large", `archive entry exceeds the ${MAX_ARCHIVE_ENTRY_BYTES} byte preview limit`));
+            const chunks = [];
+            let actual = 0;
+            stream.on("data", (chunk) => { const value = Buffer.from(chunk); actual += value.length; if (actual <= MAX_ARCHIVE_ENTRY_BYTES)
+                chunks.push(value); });
+            stream.on("end", () => { if (actual > MAX_ARCHIVE_ENTRY_BYTES)
+                return next(new ArchiveError(413, "archive_entry_too_large")); const body = Buffer.concat(chunks); content = { entry: meta, body, contentType: mimeFor(requested, body) }; next(new ArchiveEntryFound()); });
+            return;
+        }
+        stream.on("end", () => next());
+        stream.resume();
+    });
+    parser.on("error", error => { parserError = error; });
+    const handle = await openArchiveFile(file, expectedRealPath), source = createReadStream(file, { fd: handle, autoClose: true }), limiter = new ByteLimitTransform(MAX_ARCHIVE_SCAN_BYTES);
+    try {
+        if (format === "tar.gz")
+            await pipeline(source, createGunzip(), limiter, parser);
+        else if (format === "tar.bz2")
+            await pipeline(source, unbzip2(), limiter, parser);
+        else if (format === "tar.xz")
+            await pipeline(Readable.fromWeb(new XzReadableStream(Readable.toWeb(source))), limiter, parser);
+        else
+            await pipeline(source, limiter, parser);
+    }
+    catch (error) {
+        const cause = parserError || error;
+        if (cause instanceof ArchiveEntryFound && content)
+            return { entries, skippedUnsafe, content };
+        if (cause instanceof ArchiveError)
+            throw cause;
+        throw new ArchiveError(422, "invalid_archive", `cannot read ${format} archive`);
+    }
+    return { entries: stableEntries(entries), skippedUnsafe, content };
+}
+export async function listArchive(file, expectedRealPath = file) {
+    const format = archiveFormat(file);
+    if (!format)
+        throw new ArchiveError(415, "unsupported_archive", "supported archives: .zip, .tar, .tar.gz, .tgz, .tar.bz2, .tbz2, .tar.xz, .txz");
+    if (format === "zip")
+        return listZip(file, expectedRealPath);
+    const result = await scanTar(file, format, expectedRealPath);
+    return { format, entries: result.entries, skippedUnsafe: result.skippedUnsafe, limits: limits() };
+}
+export async function readArchiveEntry(file, rawEntry, expectedRealPath = file) {
+    const requested = requestedEntryPath(rawEntry), format = archiveFormat(file);
+    if (!format)
+        throw new ArchiveError(415, "unsupported_archive");
+    if (format === "zip")
+        return readZipEntry(file, requested, expectedRealPath);
+    const result = await scanTar(file, format, expectedRealPath, requested);
+    if (!result.content)
+        throw new ArchiveError(404, "archive_entry_not_found");
+    return result.content;
+}
+//# sourceMappingURL=archive-engine.js.map

package/dist/archive-engine.js.map

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

package/dist/archive-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/archive-worker.js

@@ -0,0 +1,12 @@
+import { parentPort, workerData } from "node:worker_threads";
+import { ArchiveError, listArchive, readArchiveEntry } from "./archive-engine.js";
+try {
+    const input = workerData;
+    const value = input.action === "list" ? await listArchive(input.file, input.expectedRealPath) : await readArchiveEntry(input.file, input.entry ?? "", input.expectedRealPath);
+    parentPort.postMessage({ ok: true, value });
+}
+catch (error) {
+    const value = error instanceof ArchiveError ? error : new ArchiveError(422, "invalid_archive", error instanceof Error ? error.message : String(error));
+    parentPort.postMessage({ ok: false, error: { status: value.status, code: value.code, message: value.message } });
+}
+//# sourceMappingURL=archive-worker.js.map

package/dist/archive-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-worker.js","sourceRoot":"","sources":["../src/archive-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGlF,IAAG,CAAC;IACF,MAAM,KAAK,GAAC,UAAkB,CAAC;IAC/B,MAAM,KAAK,GAAC,KAAK,CAAC,MAAM,KAAG,MAAM,CAAA,CAAC,CAAA,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,EAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA,CAAC,CAAA,MAAM,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAC,KAAK,CAAC,KAAK,IAAE,EAAE,EAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACjK,UAAW,CAAC,WAAW,CAAC,EAAC,EAAE,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,CAAC;AAC3C,CAAC;AAAA,OAAM,KAAK,EAAC,CAAC;IAAA,MAAM,KAAK,GAAC,KAAK,YAAY,YAAY,CAAA,CAAC,CAAA,KAAK,CAAA,CAAC,CAAA,IAAI,YAAY,CAAC,GAAG,EAAC,iBAAiB,EAAC,KAAK,YAAY,KAAK,CAAA,CAAC,CAAA,KAAK,CAAC,OAAO,CAAA,CAAC,CAAA,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAAA,UAAW,CAAC,WAAW,CAAC,EAAC,EAAE,EAAC,KAAK,EAAC,KAAK,EAAC,EAAC,MAAM,EAAC,KAAK,CAAC,MAAM,EAAC,IAAI,EAAC,KAAK,CAAC,IAAI,EAAC,OAAO,EAAC,KAAK,CAAC,OAAO,EAAC,EAAC,CAAC,CAAC;AAAA,CAAC"}

package/dist/archive.d.ts

@@ -0,0 +1,17 @@
+import { type ArchiveContent, type ArchiveFormat, type ArchiveManifest } from "./archive-engine.js";
+export type { ArchiveContent, ArchiveEntry, ArchiveEntryType, ArchiveFormat, ArchiveManifest } from "./archive-engine.js";
+export { MAX_ARCHIVE_ENTRIES, MAX_ARCHIVE_ENTRY_BYTES, MAX_ARCHIVE_FILE_BYTES, MAX_ARCHIVE_PATH_BYTES, MAX_ARCHIVE_MANIFEST_PATH_BYTES, MAX_ARCHIVE_SCAN_BYTES } from "./archive-engine.js";
+export declare class ArchiveError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message?: string);
+}
+export interface ArchiveJobOptions {
+    expectedRealPath: string;
+    key: string;
+    signal?: AbortSignal;
+}
+export declare function archiveFormat(file: string): ArchiveFormat | undefined;
+export declare function isArchivePath(file: string): boolean;
+export declare function listArchive(file: string, options?: ArchiveJobOptions): Promise<ArchiveManifest>;
+export declare function readArchiveEntry(file: string, rawEntry: string, options?: ArchiveJobOptions): Promise<ArchiveContent>;

package/dist/archive.js

@@ -0,0 +1,75 @@
+import { Worker } from "node:worker_threads";
+import { archiveFormat as detectArchiveFormat } from "./archive-engine.js";
+export { MAX_ARCHIVE_ENTRIES, MAX_ARCHIVE_ENTRY_BYTES, MAX_ARCHIVE_FILE_BYTES, MAX_ARCHIVE_PATH_BYTES, MAX_ARCHIVE_MANIFEST_PATH_BYTES, MAX_ARCHIVE_SCAN_BYTES } from "./archive-engine.js";
+const MAX_CONCURRENT_ARCHIVE_JOBS = 2;
+const MAX_QUEUED_ARCHIVE_JOBS = 32;
+const ARCHIVE_JOB_TIMEOUT_MS = 15_000;
+export class ArchiveError extends Error {
+    status;
+    code;
+    constructor(status, code, message = code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+}
+let active = 0;
+const activeKeys = new Set(), queue = [];
+export function archiveFormat(file) { return detectArchiveFormat(file); }
+export function isArchivePath(file) { return archiveFormat(file) !== undefined; }
+function schedule() {
+    while (active < MAX_CONCURRENT_ARCHIVE_JOBS) {
+        const index = queue.findIndex(job => !activeKeys.has(job.key));
+        if (index < 0)
+            return;
+        const [job] = queue.splice(index, 1);
+        if (job.queuedAbort)
+            job.signal?.removeEventListener("abort", job.queuedAbort);
+        if (job.signal?.aborted) {
+            job.reject(new ArchiveError(499, "archive_request_aborted"));
+            continue;
+        }
+        active++;
+        activeKeys.add(job.key);
+        void job.start().then(job.resolve, job.reject).finally(() => { active--; activeKeys.delete(job.key); schedule(); });
+    }
+}
+function limited(key, signal, start) {
+    if (signal?.aborted)
+        return Promise.reject(new ArchiveError(499, "archive_request_aborted"));
+    if (queue.length >= MAX_QUEUED_ARCHIVE_JOBS)
+        return Promise.reject(new ArchiveError(429, "archive_queue_full", "too many archive preview requests"));
+    return new Promise((resolve, reject) => { const job = { key, start, resolve: resolve, reject, signal }; const abort = () => { const index = queue.indexOf(job); if (index >= 0) {
+        queue.splice(index, 1);
+        reject(new ArchiveError(499, "archive_request_aborted"));
+    } }; job.queuedAbort = abort; signal?.addEventListener("abort", abort, { once: true }); queue.push(job); schedule(); });
+}
+function runWorker(input, signal) {
+    return new Promise((resolve, reject) => {
+        const workerFile = new URL(import.meta.url.endsWith(".ts") ? "./archive-worker.ts" : "./archive-worker.js", import.meta.url);
+        const worker = new Worker(workerFile, { workerData: input, resourceLimits: { maxOldGenerationSizeMb: 128, maxYoungGenerationSizeMb: 16, stackSizeMb: 4 } });
+        let settled = false;
+        const finish = (error, value) => { if (settled)
+            return; settled = true; clearTimeout(timer); signal?.removeEventListener("abort", onAbort); void worker.terminate(); error ? reject(error) : resolve(value); };
+        const onAbort = () => finish(new ArchiveError(499, "archive_request_aborted"));
+        const timer = setTimeout(() => finish(new ArchiveError(504, "archive_timeout", `archive preview exceeded ${ARCHIVE_JOB_TIMEOUT_MS}ms`)), ARCHIVE_JOB_TIMEOUT_MS);
+        timer.unref();
+        signal?.addEventListener("abort", onAbort, { once: true });
+        worker.once("message", message => { if (message?.ok) {
+            const value = message.value;
+            if (value?.body)
+                value.body = Buffer.from(value.body);
+            finish(undefined, value);
+        }
+        else {
+            const e = message?.error;
+            finish(new ArchiveError(Number(e?.status) || 422, String(e?.code || "invalid_archive"), String(e?.message || "archive processing failed")));
+        } });
+        worker.once("error", error => finish(new ArchiveError(422, "archive_worker_failed", error.message)));
+        worker.once("exit", code => { if (!settled)
+            finish(new ArchiveError(422, "archive_worker_failed", `archive worker exited with code ${code}`)); });
+    });
+}
+export async function listArchive(file, options = { expectedRealPath: file, key: file }) { return limited(options.key, options.signal, () => runWorker({ action: "list", file, expectedRealPath: options.expectedRealPath }, options.signal)); }
+export async function readArchiveEntry(file, rawEntry, options = { expectedRealPath: file, key: file }) { return limited(options.key, options.signal, () => runWorker({ action: "read", file, expectedRealPath: options.expectedRealPath, entry: rawEntry }, options.signal)); }
+//# sourceMappingURL=archive.js.map

package/dist/archive.js.map

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