@emdzej/csfs-zip 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michał Jaskólski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# @emdzej/csfs-zip
+
+A zip archive as a file system — read from any backend, by range, without
+unpacking it.
+
+_Part of [csfs](https://github.com/emdzej/csfs) — a **c**lient **s**ide **f**ile **s**ystem: one read API over static HTTP, a picked directory,
+OPFS, and inside zip archives._
+
+```ts
+import { zipFromBlob, withArchives } from "@emdzej/csfs-zip";
+import { httpFileSystem } from "@emdzej/csfs-http";
+
+// A picked or dropped file
+const fs = withArchives(zipFromBlob(file));
+await fs.read("/inside/photo.png");
+
+// Or an archive sitting in another tree, read in place
+const http = withArchives(httpFileSystem("https://example.test/data"));
+await http.read("/media.zip#/photo.png"); // a few Range requests, not 945 MB
+```
+
+Only the central directory and the requested entry are read. Which is the whole
+point: a 945 MB archive on a static host becomes browsable in a tab.
+
+## `#` addressing
+
+`withArchives(fs)` makes `#` work on any file system, and nests:
+
+```ts
+await fs.read("/pack.zip#/inside.txt");
+await fs.read("/outer.zip#/inner.zip#/deep.txt");
+```
+
+Paths without a `#` are passed straight through, so wrapping a file system costs
+nothing until someone uses the syntax. Archives are opened once and cached —
+the expensive part is the central directory, not the reads — and cached as the
+_promise_, so two concurrent lookups share one read of it.
+
+## Transparent mounts
+
+`withTransparentArchives(fs, mounts)` makes an archive answer for a directory
+that does not exist:
+
+```ts
+const fs = withTransparentArchives(base, [
+  { archive: "/drawings.zip", serves: "/drawings", entry: "basename" },
+]);
+
+await fs.read("/drawings/1132/1132C000.png"); // from a flat archive
+```
+
+This is the case that motivated the package. A parts catalogue ships 38,488
+drawings as one flat `drawings.zip` _and_ as a tree bucketed by name, and every
+reference in the data uses the tree's shape. The archive and the extracted
+layout are **different shapes**, and only the tree's author knows how one maps
+onto the other — so a mount _declares_ it. `entry: "basename"` is a fact about
+that archive, not a default.
+
+Several archives may serve one directory, which is how a multi-disc data set
+that ships three different `images_1.zip` files is read without renaming
+anything.
+
+**A real file always wins**, so a tree that _was_ extracted keeps working, and a
+half-extracted one falls back file by file rather than failing.
+
+## Zip handling is not ours
+
+The reader is [`@zip.js/zip.js`](https://github.com/gildas-lormeau/zip.js). The
+format has enough corners to be worth a library: zip64 past 4 GB or 65,535
+entries, data descriptors, cp437 entry names, and — the one that catches people
+— archives whose _local_ headers carry zero sizes and a zero CRC while the
+central directory holds the truth.
+
+What this package supplies is `CsFileReader`, a `zip.js` `Reader` over a
+`CsFile`. That one adapter is what lets an archive be read from HTTP, a picked
+directory, OPFS, or `node:fs` without any of them knowing about zip.
+
+## Licence
+
+**MIT** — see [LICENSE](https://github.com/emdzej/csfs/blob/main/LICENSE).

package/dist/archives.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Archives as part of the surrounding file system.
+ *
+ * Two ways in, because they answer different questions:
+ *
+ * **`withArchives(fs)`** makes `#` work. `/dessins/100.zip#/1132C000.png`
+ * resolves through the archive, and so does `/a.zip#/b.zip#/deep.txt`. The
+ * caller has to know the archive is there, which is the honest case when a
+ * path comes from a manifest or a link.
+ *
+ * **`withTransparentArchives(fs, mounts)`** makes an archive answer for a
+ * directory that does not exist. A tree may ship `dessins/100.zip` while every
+ * reference in the data says `dessins/100/1132/1132C000.png` — the archive and
+ * the extracted layout are *different shapes*, and only the tree's author
+ * knows how one maps onto the other. So a mount states it rather than guessing.
+ *
+ * Mounted archives are opened once and cached, because the expensive part is
+ * the central directory, not the reads.
+ */
+import { dirname, formatPath, statVia, type CsFileSystem } from "@emdzej/csfs-core";
+import { type ZipFileSystemOptions } from "./zip-fs.js";
+/** Which archive stands in for which directory, and how names map. */
+export interface ArchiveMount {
+    /** Path of the archive within the host file system. */
+    readonly archive: string;
+    /** The directory it answers for. */
+    readonly serves: string;
+    /**
+     * How to turn a requested path into an entry name.
+     *
+     * `"relative"` strips `serves` — the usual case, where the archive mirrors
+     * the directory. `"basename"` uses only the last segment, for a flat archive
+     * standing in for a nested tree; that is not a corner case, it is how parts
+     * catalogues ship their drawings.
+     */
+    readonly entry?: "relative" | "basename";
+}
+/**
+ * Resolve `#` fragments through archives.
+ *
+ * Read-only, and it adds no behaviour to paths without a `#` — so wrapping a
+ * file system costs nothing until someone uses the syntax.
+ */
+export declare function withArchives(fs: CsFileSystem, opts?: ZipFileSystemOptions): CsFileSystem;
+/**
+ * Make archives answer for directories, per a declared mapping.
+ *
+ * A real file always wins: a tree that was extracted keeps working, and a
+ * half-extracted one falls back file by file rather than failing. Except for
+ * *listing* — a directory that exists only inside an archive has no real
+ * counterpart to list, so both are merged.
+ */
+export declare function withTransparentArchives(fs: CsFileSystem, mounts: readonly ArchiveMount[], opts?: ZipFileSystemOptions): CsFileSystem;
+/** Re-exported for callers building paths. */
+export { formatPath, dirname, statVia };
+//# sourceMappingURL=archives.d.ts.map

package/dist/archives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archives.d.ts","sourceRoot":"","sources":["../src/archives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAEL,OAAO,EACP,UAAU,EAGV,OAAO,EAIP,KAAK,YAAY,EAElB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAgC,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEtF,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,YAAY,CA2ExF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,IAAI,CAAC,EAAE,oBAAoB,GAC1B,YAAY,CAqGd;AAqCD,8CAA8C;AAC9C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/archives.js

@@ -0,0 +1,248 @@
+/**
+ * Archives as part of the surrounding file system.
+ *
+ * Two ways in, because they answer different questions:
+ *
+ * **`withArchives(fs)`** makes `#` work. `/dessins/100.zip#/1132C000.png`
+ * resolves through the archive, and so does `/a.zip#/b.zip#/deep.txt`. The
+ * caller has to know the archive is there, which is the honest case when a
+ * path comes from a manifest or a link.
+ *
+ * **`withTransparentArchives(fs, mounts)`** makes an archive answer for a
+ * directory that does not exist. A tree may ship `dessins/100.zip` while every
+ * reference in the data says `dessins/100/1132/1132C000.png` — the archive and
+ * the extracted layout are *different shapes*, and only the tree's author
+ * knows how one maps onto the other. So a mount states it rather than guessing.
+ *
+ * Mounted archives are opened once and cached, because the expensive part is
+ * the central directory, not the reads.
+ */
+import { basename, dirname, formatPath, normalizePath, parsePath, statVia, } from "@emdzej/csfs-core";
+import { ZipFileSystem, zipFileSystem } from "./zip-fs.js";
+/**
+ * Resolve `#` fragments through archives.
+ *
+ * Read-only, and it adds no behaviour to paths without a `#` — so wrapping a
+ * file system costs nothing until someone uses the syntax.
+ */
+export function withArchives(fs, opts) {
+    const cache = new Map();
+    const mount = (path) => {
+        const hit = cache.get(path);
+        if (hit)
+            return hit;
+        // Cached as the promise, so two concurrent lookups share one read of the
+        // central directory rather than both fetching it.
+        const promise = (async () => {
+            const file = await resolve(path);
+            return file ? zipFileSystem(file, opts) : null;
+        })();
+        cache.set(path, promise);
+        return promise;
+    };
+    /** Resolve a possibly-nested path down to the file it names. */
+    async function resolve(path) {
+        const { base, fragments } = parsePath(path);
+        if (fragments.length === 0)
+            return await fs.file(base);
+        let container = base;
+        for (let i = 0; i < fragments.length; i++) {
+            const inner = fragments[i];
+            const archive = await mount(container);
+            if (!archive)
+                return null;
+            if (i === fragments.length - 1)
+                return await archive.file(inner);
+            // Not the last hop: this fragment names another archive, so it becomes
+            // the container for the next one.
+            container = `${container}#${inner}`;
+        }
+        return null;
+    }
+    return {
+        kind: `${fs.kind}+zip`,
+        async file(path) {
+            return await resolve(path);
+        },
+        async directory(path) {
+            const { base, fragments } = parsePath(path);
+            if (fragments.length === 0)
+                return await fs.directory(base);
+            let container = base;
+            for (let i = 0; i < fragments.length - 1; i++) {
+                container = `${container}#${fragments[i]}`;
+            }
+            const archive = await mount(container);
+            return archive ? await archive.directory(fragments[fragments.length - 1]) : null;
+        },
+        async read(path) {
+            return (await resolve(path))?.bytes() ?? null;
+        },
+        async stat(path) {
+            const { base, fragments } = parsePath(path);
+            if (fragments.length === 0)
+                return await fs.stat(base);
+            let container = base;
+            for (let i = 0; i < fragments.length - 1; i++) {
+                container = `${container}#${fragments[i]}`;
+            }
+            const archive = await mount(container);
+            return archive ? await archive.stat(fragments[fragments.length - 1]) : null;
+        },
+        async directUrl(path) {
+            const { fragments } = parsePath(path);
+            // An entry inside an archive has no URL of its own: the bytes are
+            // compressed inside a larger file, so handing back the archive's URL
+            // would load the wrong thing entirely.
+            if (fragments.length > 0)
+                return null;
+            return (await fs.directUrl?.(path)) ?? null;
+        },
+    };
+}
+/**
+ * Make archives answer for directories, per a declared mapping.
+ *
+ * A real file always wins: a tree that was extracted keeps working, and a
+ * half-extracted one falls back file by file rather than failing. Except for
+ * *listing* — a directory that exists only inside an archive has no real
+ * counterpart to list, so both are merged.
+ */
+export function withTransparentArchives(fs, mounts, opts) {
+    const normalized = mounts.map((m) => ({
+        archive: normalizePath(m.archive),
+        serves: normalizePath(m.serves),
+        entry: m.entry ?? "relative",
+    }));
+    const cache = new Map();
+    const mount = (archive) => {
+        const hit = cache.get(archive);
+        if (hit)
+            return hit;
+        const promise = (async () => {
+            const file = await fs.file(archive);
+            return file ? zipFileSystem(file, opts) : null;
+        })();
+        cache.set(archive, promise);
+        return promise;
+    };
+    /** Every mount that could answer for this path. */
+    function candidates(path) {
+        const p = normalizePath(path);
+        const out = [];
+        for (const m of normalized) {
+            if (p !== m.serves && !p.startsWith(`${m.serves}/`))
+                continue;
+            // Plural on purpose: several archives can stand in for one directory,
+            // which is how a data set that ships `images_1.zip` on three discs is
+            // read without renaming its contents.
+            const inner = m.entry === "basename" ? `/${basename(p)}` : p.slice(m.serves.length) || "/";
+            out.push({ archive: m.archive, inner });
+        }
+        return out;
+    }
+    async function fromArchives(path) {
+        for (const { archive, inner } of candidates(path)) {
+            const zip = await mount(archive);
+            const found = await zip?.file(inner);
+            if (found)
+                return found;
+        }
+        return null;
+    }
+    return {
+        kind: `${fs.kind}+mounted-zip`,
+        async file(path) {
+            return (await fs.file(path)) ?? (await fromArchives(path));
+        },
+        async read(path) {
+            return (await this.file(path))?.bytes() ?? null;
+        },
+        async directory(path) {
+            const real = await fs.directory(path);
+            const mounted = candidates(path);
+            if (mounted.length === 0)
+                return real;
+            const inners = [];
+            for (const { archive, inner } of mounted) {
+                // A `basename` mount has no directory structure to contribute: its
+                // entries are flat and its shape says nothing about the tree it stands
+                // in for, so listing it would invent paths that do not resolve.
+                const m = normalized.find((n) => n.archive === archive);
+                if (m?.entry === "basename")
+                    continue;
+                const zip = await mount(archive);
+                const dir = await zip?.directory(inner);
+                if (dir)
+                    inners.push(dir);
+            }
+            if (!real && inners.length === 0)
+                return null;
+            return new MergedDirectory(normalizePath(path), real, inners, this);
+        },
+        async stat(path) {
+            const direct = await fs.stat(path);
+            if (direct)
+                return direct;
+            const file = await fromArchives(path);
+            if (file)
+                return { kind: "file", name: basename(path), size: file.size };
+            const dir = await this.directory(path);
+            return dir ? { kind: "directory", name: basename(path), size: 0 } : null;
+        },
+        async directUrl(path) {
+            /*
+             * Only for a file that really exists.
+             *
+             * The inner backend decides, and its answer is already the right one:
+             * `HttpFileSystem.directUrl` returns null for a path its manifest does
+             * not list. So a path that only a mounted archive can serve gets null
+             * here and the caller falls back to a blob — which is correct, because
+             * the bytes are inside a zip and no URL addresses them.
+             *
+             * Asking the inner backend rather than checking `file()` first also
+             * keeps this to one lookup, and keeps "is there a real file" a question
+             * only the backend answers.
+             */
+            return (await fs.directUrl?.(path)) ?? null;
+        },
+    };
+}
+/** A directory whose children come from the real tree and from archives. */
+class MergedDirectory {
+    path;
+    real;
+    inners;
+    owner;
+    name;
+    constructor(path, real, inners, owner) {
+        this.path = path;
+        this.real = real;
+        this.inners = inners;
+        this.owner = owner;
+        this.name = basename(path);
+    }
+    async entries() {
+        const byName = new Map();
+        // Real files first, so an extracted copy wins over an archived one and the
+        // sizes reported are the ones on disk.
+        for (const source of [this.real, ...this.inners]) {
+            if (!source)
+                continue;
+            for (const e of await source.entries()) {
+                if (!byName.has(e.name))
+                    byName.set(e.name, e);
+            }
+        }
+        return [...byName.values()];
+    }
+    async file(name) {
+        return await this.owner.file(`${this.path}/${name}`);
+    }
+    async directory(name) {
+        return await this.owner.directory(`${this.path}/${name}`);
+    }
+}
+/** Re-exported for callers building paths. */
+export { formatPath, dirname, statVia };
+//# sourceMappingURL=archives.js.map

package/dist/archives.js.map

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

package/dist/blob-zip.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=blob-zip.test.d.ts.map

package/dist/blob-zip.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-zip.test.d.ts","sourceRoot":"","sources":["../src/blob-zip.test.ts"],"names":[],"mappings":""}

package/dist/blob-zip.test.js

@@ -0,0 +1,75 @@
+import { readFile } from "node:fs/promises";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { BlobWriter, TextReader, Uint8ArrayReader, ZipWriter } from "@zip.js/zip.js";
+import { zipFromBlob } from "./zip-fs.js";
+import { withArchives } from "./archives.js";
+async function makeZip(files) {
+    const w = new ZipWriter(new BlobWriter("application/zip"), { useWebWorkers: false });
+    for (const f of files) {
+        await w.add(f.name, f.bytes ? new Uint8ArrayReader(f.bytes) : new TextReader(f.text ?? ""));
+    }
+    return new Uint8Array(await (await w.close()).arrayBuffer());
+}
+let dir;
+beforeAll(async () => {
+    dir = await mkdtemp(join(tmpdir(), "csfs-blob-"));
+    const inner = await makeZip([{ name: "buried.txt", text: "two levels down" }]);
+    await writeFile(join(dir, "outer.zip"), await makeZip([
+        { name: "top.txt", text: "at the top" },
+        { name: "deep/leaf.txt", text: "a leaf" },
+        { name: "inner.zip", bytes: inner },
+    ]));
+});
+afterAll(async () => {
+    await rm(dir, { recursive: true, force: true });
+});
+/** Exactly what a picker, an `<input type="file">` or a drop event hands over. */
+async function pickedFile() {
+    const bytes = await readFile(join(dir, "outer.zip"));
+    return new File([bytes], "outer.zip", { type: "application/zip" });
+}
+describe("a picked archive as a file system", () => {
+    it("mounts a File with no adapter, because a File is a Blob", async () => {
+        // The claim the whole contract rests on. If this needed an adapter, the
+        // interface would be wrong.
+        const fs = zipFromBlob(await pickedFile());
+        expect(fs.kind).toBe("zip");
+        const root = await fs.directory("/");
+        expect((await root.entries()).map((e) => `${e.kind}:${e.name}`).sort()).toEqual([
+            "directory:deep",
+            "file:inner.zip",
+            "file:top.txt",
+        ]);
+        expect(await (await fs.file("/top.txt")).text()).toBe("at the top");
+        expect(await (await fs.file("/deep/leaf.txt")).text()).toBe("a leaf");
+    });
+    it("takes its path from the file's own name", async () => {
+        const fs = zipFromBlob(await pickedFile());
+        const file = await fs.file("/top.txt");
+        expect(file.path).toBe("/top.txt");
+        expect(file.type).toBe("text/plain; charset=utf-8");
+    });
+    it("reads an archive nested inside the picked one", async () => {
+        // Composition worth checking rather than assuming: the outer entry is
+        // decompressed to bytes, and those bytes then have to serve as a
+        // container in their own right.
+        const fs = withArchives(zipFromBlob(await pickedFile()));
+        const bytes = await fs.read("/inner.zip#/buried.txt");
+        expect(new TextDecoder().decode(bytes)).toBe("two levels down");
+    });
+    it("reports absence as null, from a blob as from anywhere else", async () => {
+        const fs = zipFromBlob(await pickedFile());
+        expect(await fs.file("/nope.txt")).toBeNull();
+        expect(await fs.directory("/nope")).toBeNull();
+        expect(await fs.stat("/nope")).toBeNull();
+    });
+    it("says what is wrong when the file is not an archive", async () => {
+        const notAZip = new File([new TextEncoder().encode("hello")], "x.zip");
+        const fs = zipFromBlob(notAZip);
+        await expect(fs.file("/anything")).rejects.toThrow(/not a readable zip archive/);
+    });
+});
+//# sourceMappingURL=blob-zip.test.js.map

package/dist/blob-zip.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./reader.js";
+export * from "./zip-fs.js";
+export * from "./archives.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./reader.js";
+export * from "./zip-fs.js";
+export * from "./archives.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/reader.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A `zip.js` reader over a `CsFile`.
+ *
+ * This is the whole trick behind mounting archives: `zip.js` reads through a
+ * `Reader` interface, and a `CsFile` already offers `size` and `slice`. So one
+ * small adapter lets an archive be read from *any* backend — over HTTP by
+ * range, out of a picked directory, out of OPFS, or out of another archive —
+ * without csfs implementing a single byte of the zip format.
+ *
+ * Zip handling is not reinvented here on purpose. The format has enough
+ * corners to be worth a library: zip64 for anything over 4 GB or 65,535
+ * entries, the data-descriptor case where sizes trail the data, cp437 versus
+ * UTF-8 entry names, and — the one that catches people — archives whose
+ * *local* headers carry zero sizes and a zero CRC while the central directory
+ * holds the truth. `zip.js` reads the central directory, which is what makes
+ * those readable at all.
+ */
+import { Reader } from "@zip.js/zip.js";
+import type { CsFile } from "@emdzej/csfs-core";
+/**
+ * Presents a `CsFile` to `zip.js`.
+ *
+ * `readUint8Array` is the only method that touches data, and it slices rather
+ * than buffering, so reading a central directory out of a 945 MB archive costs
+ * two range reads instead of a download.
+ */
+export declare class CsFileReader extends Reader<CsFile> {
+    private readonly file;
+    constructor(file: CsFile);
+    init(): Promise<void>;
+    readUint8Array(index: number, length: number): Promise<Uint8Array>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../src/reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,MAAM,CAAC,MAAM,CAAC;IAI9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,MAAM;IAMT,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAYlF"}

package/dist/reader.js

@@ -0,0 +1,51 @@
+/**
+ * A `zip.js` reader over a `CsFile`.
+ *
+ * This is the whole trick behind mounting archives: `zip.js` reads through a
+ * `Reader` interface, and a `CsFile` already offers `size` and `slice`. So one
+ * small adapter lets an archive be read from *any* backend — over HTTP by
+ * range, out of a picked directory, out of OPFS, or out of another archive —
+ * without csfs implementing a single byte of the zip format.
+ *
+ * Zip handling is not reinvented here on purpose. The format has enough
+ * corners to be worth a library: zip64 for anything over 4 GB or 65,535
+ * entries, the data-descriptor case where sizes trail the data, cp437 versus
+ * UTF-8 entry names, and — the one that catches people — archives whose
+ * *local* headers carry zero sizes and a zero CRC while the central directory
+ * holds the truth. `zip.js` reads the central directory, which is what makes
+ * those readable at all.
+ */
+import { Reader } from "@zip.js/zip.js";
+/**
+ * Presents a `CsFile` to `zip.js`.
+ *
+ * `readUint8Array` is the only method that touches data, and it slices rather
+ * than buffering, so reading a central directory out of a 945 MB archive costs
+ * two range reads instead of a download.
+ */
+export class CsFileReader extends Reader {
+    // Kept alongside rather than read back from the base class: `Reader.value`
+    // is not part of zip.js's published types, and relying on an internal would
+    // make a patch release able to break this.
+    file;
+    constructor(file) {
+        super(file);
+        this.file = file;
+        this.size = file.size;
+    }
+    async init() {
+        this.size = this.file.size;
+    }
+    async readUint8Array(index, length) {
+        if (length === 0)
+            return new Uint8Array(0);
+        const bytes = await this.file.slice(index, index + length).bytes();
+        // A short read means the backend clamped a range. Saying so beats handing
+        // back a truncated buffer that a parser will misread as corrupt data.
+        if (bytes.byteLength < length) {
+            throw new Error(`${this.file.path}: wanted ${length} bytes at ${index}, got ${bytes.byteLength}`);
+        }
+        return bytes;
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../src/reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC;;;;;;GAMG;AACH,MAAM,OAAO,YAAa,SAAQ,MAAc;IAC9C,2EAA2E;IAC3E,4EAA4E;IAC5E,2CAA2C;IAC1B,IAAI,CAAS;IAE9B,YAAY,IAAY;QACtB,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC7B,CAAC;IAEQ,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,MAAc;QACzD,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QACnE,0EAA0E;QAC1E,sEAAsE;QACtE,IAAI,KAAK,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,MAAM,aAAa,KAAK,SAAS,KAAK,CAAC,UAAU,EAAE,CACjF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/zip-fs.d.ts

@@ -0,0 +1,82 @@
+/**
+ * An archive, as a file system.
+ *
+ * A zip stores a flat list of entries whose names happen to contain slashes;
+ * it has no directories in the sense a caller means. So the entry list is read
+ * once and a tree is synthesised from it — including directories that exist
+ * only implicitly, because plenty of archives never write directory entries at
+ * all and a tree that omitted them would lose every file inside.
+ *
+ * The central directory is read on first use and kept. That is one round trip
+ * of a couple of megabytes for a large archive — 2.2 MB for 38,488 entries —
+ * after which every lookup is a map hit and every read is one range request.
+ * Re-reading it per file would cost more than the files.
+ */
+import { type FileEntry } from "@zip.js/zip.js";
+import { dirname, type CsDirectory, type CsFile, type CsFileSystem, type CsStat, type BlobLike } from "@emdzej/csfs-core";
+export interface ZipFileSystemOptions {
+    /**
+     * Match entry names without regard to case.
+     *
+     * Off by default. Archives built on Windows are inconsistent about case and
+     * some data sets rely on that, but two entries differing only in case then
+     * become ambiguous — so it is a choice the caller makes knowingly.
+     */
+    caseInsensitive?: boolean;
+    /** Password, for the archives that need one. */
+    password?: string;
+}
+interface Node {
+    readonly name: string;
+    /**
+     * Only a `FileEntry` can be read: `Entry` is a union with `DirectoryEntry`,
+     * which has no `getData`. Narrowing here rather than at each read means the
+     * tree cannot hold something unreadable in a file position.
+     */
+    readonly entry?: FileEntry;
+    readonly children: Map<string, Node>;
+}
+export declare class ZipFileSystem implements CsFileSystem {
+    private readonly archive;
+    private readonly opts;
+    readonly kind = "zip";
+    private tree?;
+    constructor(archive: CsFile, opts?: ZipFileSystemOptions);
+    /** Read the central directory once and build the tree from it. */
+    private load;
+    private nodeAt;
+    /** Read one entry's bytes. */
+    private readEntry;
+    file(path: string): Promise<CsFile | null>;
+    directory(path: string): Promise<CsDirectory | null>;
+    read(path: string): Promise<Uint8Array | null>;
+    stat(path: string): Promise<CsStat | null>;
+    /** Entry names as stored, for callers that want the flat view. */
+    names(): Promise<string[]>;
+    /** @internal — `ZipDirectory` reaches back for this. */
+    entryFile(node: Node, path: string): Promise<CsFile | null>;
+}
+/** Mount an archive. Nothing is read until something is asked for. */
+export declare function zipFileSystem(archive: CsFile, opts?: ZipFileSystemOptions): ZipFileSystem;
+/** Re-exported so callers can build a path without importing core directly. */
+export { dirname };
+/**
+ * Mount a `Blob` or a `File` as a file system.
+ *
+ * This is the whole answer to "can I open a zip the user picked?" — a `File`
+ * *is* a `Blob`, so it already satisfies the read contract and needs no
+ * adapter. It works from `showOpenFilePicker()`, from `<input type="file">`
+ * and from a drop event, and the latter two work in every browser rather than
+ * only in Chromium.
+ *
+ * One caveat worth passing on: a `File` is a snapshot of a path, not a lock on
+ * it. If the archive changes on disk after being picked, later reads throw
+ * rather than returning stale bytes — which is the right behaviour, but a
+ * long-lived page should be ready to ask for it again.
+ */
+export declare function zipFromBlob(blob: BlobLike & {
+    name?: string;
+}, opts?: ZipFileSystemOptions & {
+    path?: string;
+}): ZipFileSystem;
+//# sourceMappingURL=zip-fs.d.ts.map

package/dist/zip-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-fs.d.ts","sourceRoot":"","sources":["../src/zip-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAKL,OAAO,EAKP,KAAK,WAAW,EAEhB,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,IAAI;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACtC;AAMD,qBAAa,aAAc,YAAW,YAAY;IAK9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,IAAI,CAAC,CAAgB;gBAGV,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,oBAAyB;IAGlD,kEAAkE;IAClE,OAAO,CAAC,IAAI;YAwDE,MAAM;IAUpB,8BAA8B;YAChB,SAAS;IAsBjB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY1C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAMpD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI9C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOhD,kEAAkE;IAC5D,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAahC,wDAAwD;IAClD,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAKlE;AA8BD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAEzF;AAED,+EAA+E;AAC/E,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,QAAQ,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAClC,IAAI,GAAE,oBAAoB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,aAAa,CAGf"}

package/dist/zip-fs.js

@@ -0,0 +1,217 @@
+/**
+ * An archive, as a file system.
+ *
+ * A zip stores a flat list of entries whose names happen to contain slashes;
+ * it has no directories in the sense a caller means. So the entry list is read
+ * once and a tree is synthesised from it — including directories that exist
+ * only implicitly, because plenty of archives never write directory entries at
+ * all and a tree that omitted them would lose every file inside.
+ *
+ * The central directory is read on first use and kept. That is one round trip
+ * of a couple of megabytes for a large archive — 2.2 MB for 38,488 entries —
+ * after which every lookup is a map hit and every read is one range request.
+ * Re-reading it per file would cost more than the files.
+ */
+import { ZipReader } from "@zip.js/zip.js";
+import { BackendError, basename, blobFile, bytesFile, dirname, mimeType, normalizePath, segments, statVia, } from "@emdzej/csfs-core";
+import { CsFileReader } from "./reader.js";
+function keyOf(name, caseInsensitive) {
+    return caseInsensitive ? name.toLowerCase() : name;
+}
+export class ZipFileSystem {
+    archive;
+    opts;
+    kind = "zip";
+    tree;
+    constructor(archive, opts = {}) {
+        this.archive = archive;
+        this.opts = opts;
+    }
+    /** Read the central directory once and build the tree from it. */
+    load() {
+        this.tree ??= (async () => {
+            const reader = new ZipReader(new CsFileReader(this.archive), {
+                // `zip.js` would otherwise spin up workers, which is wrong for a
+                // library: a consumer may already be inside one, and a page that reads
+                // three files should not start a worker pool to do it.
+                useWebWorkers: false,
+            });
+            let entries;
+            try {
+                entries = await reader.getEntries();
+            }
+            catch (e) {
+                throw new BackendError(`not a readable zip archive: ${e instanceof Error ? e.message : String(e)}`, this.archive.path);
+            }
+            const insensitive = this.opts.caseInsensitive ?? false;
+            const root = { name: "", children: new Map() };
+            for (const entry of entries) {
+                const parts = segments(entry.filename);
+                if (parts.length === 0)
+                    continue;
+                let node = root;
+                // Every parent is created on the way down, whether or not the archive
+                // bothered to store a directory entry for it.
+                for (const part of parts.slice(0, -1)) {
+                    const key = keyOf(part, insensitive);
+                    let next = node.children.get(key);
+                    if (!next) {
+                        next = { name: part, children: new Map() };
+                        node.children.set(key, next);
+                    }
+                    node = next;
+                }
+                const last = parts[parts.length - 1];
+                const key = keyOf(last, insensitive);
+                if (entry.directory) {
+                    if (!node.children.has(key)) {
+                        node.children.set(key, { name: last, children: new Map() });
+                    }
+                }
+                else {
+                    // A later entry with the same name replaces an earlier one, which is
+                    // what every unzip does.
+                    node.children.set(key, {
+                        name: last,
+                        entry: entry,
+                        children: new Map(),
+                    });
+                }
+            }
+            return root;
+        })();
+        return this.tree;
+    }
+    async nodeAt(path) {
+        const insensitive = this.opts.caseInsensitive ?? false;
+        let node = await this.load();
+        for (const part of segments(path)) {
+            node = node?.children.get(keyOf(part, insensitive));
+            if (!node)
+                return null;
+        }
+        return node ?? null;
+    }
+    /** Read one entry's bytes. */
+    async readEntry(entry, path) {
+        const chunks = [];
+        const sink = new WritableStream({
+            write(chunk) {
+                chunks.push(chunk);
+            },
+        });
+        await entry.getData(sink, {
+            ...(this.opts.password !== undefined ? { password: this.opts.password } : {}),
+            useWebWorkers: false,
+        });
+        let total = 0;
+        for (const c of chunks)
+            total += c.byteLength;
+        const out = new Uint8Array(total);
+        let at = 0;
+        for (const c of chunks) {
+            out.set(c, at);
+            at += c.byteLength;
+        }
+        return out;
+    }
+    async file(path) {
+        const node = await this.nodeAt(path);
+        if (!node?.entry)
+            return null;
+        const full = normalizePath(path);
+        // Decompressed eagerly, and only on request. A `CsFile` promises random
+        // access, and a deflated entry has no seekable form — offering a lazy
+        // slice would mean re-inflating from the start for every read, which is
+        // slower and more surprising than doing it once.
+        const bytes = await this.readEntry(node.entry, full);
+        return bytesFile(full, bytes, mimeType(full));
+    }
+    async directory(path) {
+        const node = await this.nodeAt(path);
+        if (!node || node.entry)
+            return null;
+        return new ZipDirectory(this, node, normalizePath(path));
+    }
+    async read(path) {
+        return (await this.file(path))?.bytes() ?? null;
+    }
+    async stat(path) {
+        const root = await this.directory("/");
+        if (!root)
+            return null;
+        if (segments(path).length === 0)
+            return { kind: "directory", name: "", size: 0 };
+        return await statVia(root, path);
+    }
+    /** Entry names as stored, for callers that want the flat view. */
+    async names() {
+        const out = [];
+        const visit = (node, prefix) => {
+            for (const child of node.children.values()) {
+                const p = `${prefix}/${child.name}`;
+                if (child.entry)
+                    out.push(p);
+                else
+                    visit(child, p);
+            }
+        };
+        visit(await this.load(), "");
+        return out;
+    }
+    /** @internal — `ZipDirectory` reaches back for this. */
+    async entryFile(node, path) {
+        if (!node.entry)
+            return null;
+        const bytes = await this.readEntry(node.entry, path);
+        return bytesFile(path, bytes, mimeType(path));
+    }
+}
+class ZipDirectory {
+    fs;
+    node;
+    path;
+    name;
+    constructor(fs, node, path) {
+        this.fs = fs;
+        this.node = node;
+        this.path = path;
+        this.name = basename(path);
+    }
+    async entries() {
+        return [...this.node.children.values()].map((child) => child.entry
+            ? { kind: "file", name: child.name, size: child.entry.uncompressedSize }
+            : { kind: "directory", name: child.name });
+    }
+    async file(name) {
+        return await this.fs.file(`${this.path}/${name}`);
+    }
+    async directory(name) {
+        return await this.fs.directory(`${this.path}/${name}`);
+    }
+}
+/** Mount an archive. Nothing is read until something is asked for. */
+export function zipFileSystem(archive, opts) {
+    return new ZipFileSystem(archive, opts);
+}
+/** Re-exported so callers can build a path without importing core directly. */
+export { dirname };
+/**
+ * Mount a `Blob` or a `File` as a file system.
+ *
+ * This is the whole answer to "can I open a zip the user picked?" — a `File`
+ * *is* a `Blob`, so it already satisfies the read contract and needs no
+ * adapter. It works from `showOpenFilePicker()`, from `<input type="file">`
+ * and from a drop event, and the latter two work in every browser rather than
+ * only in Chromium.
+ *
+ * One caveat worth passing on: a `File` is a snapshot of a path, not a lock on
+ * it. If the archive changes on disk after being picked, later reads throw
+ * rather than returning stale bytes — which is the right behaviour, but a
+ * long-lived page should be ready to ask for it again.
+ */
+export function zipFromBlob(blob, opts = {}) {
+    const { path, ...rest } = opts;
+    return new ZipFileSystem(blobFile(blob, path, "application/zip"), rest);
+}
+//# sourceMappingURL=zip-fs.js.map

package/dist/zip-fs.js.map

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

package/dist/zip-fs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zip-fs.test.d.ts.map

package/dist/zip-fs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-fs.test.d.ts","sourceRoot":"","sources":["../src/zip-fs.test.ts"],"names":[],"mappings":""}

package/dist/zip-fs.test.js

@@ -0,0 +1,159 @@
+import { openAsBlob } from "node:fs";
+import { mkdtemp, writeFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it, beforeAll, afterAll } from "vitest";
+import { BlobFile } from "@emdzej/csfs-core";
+import { ZipWriter, BlobWriter, TextReader, Uint8ArrayReader } from "@zip.js/zip.js";
+import { zipFileSystem } from "./zip-fs.js";
+import { withArchives, withTransparentArchives } from "./archives.js";
+import { nodeFileSystem } from "@emdzej/csfs-node";
+/** Build a real archive with zip.js, so the fixture is not hand-rolled. */
+async function makeZip(files) {
+    const writer = new ZipWriter(new BlobWriter("application/zip"), { useWebWorkers: false });
+    for (const f of files) {
+        await writer.add(f.name, f.bytes ? new Uint8ArrayReader(f.bytes) : new TextReader(f.text ?? ""));
+    }
+    const blob = await writer.close();
+    return new Uint8Array(await blob.arrayBuffer());
+}
+const fileOf = (path, bytes) => new BlobFile(path, new Blob([bytes]));
+describe("ZipFileSystem", () => {
+    it("synthesises directories the archive never stored", async () => {
+        // Plenty of archives write no directory entries at all. A tree built only
+        // from stored directories would lose every file inside them.
+        const zip = await makeZip([
+            { name: "deep/nested/one.txt", text: "one" },
+            { name: "top.txt", text: "top" },
+        ]);
+        const fs = zipFileSystem(fileOf("/a.zip", zip));
+        const root = await fs.directory("/");
+        expect((await root.entries()).map((e) => `${e.kind}:${e.name}`).sort()).toEqual([
+            "directory:deep",
+            "file:top.txt",
+        ]);
+        expect(await fs.directory("/deep/nested")).not.toBeNull();
+        expect(await (await fs.file("/deep/nested/one.txt")).text()).toBe("one");
+    });
+    it("reports sizes and reads bytes back exactly", async () => {
+        const payload = new Uint8Array(5000).map((_, i) => i % 251);
+        const zip = await makeZip([{ name: "blob.bin", bytes: payload }]);
+        const fs = zipFileSystem(fileOf("/a.zip", zip));
+        const file = await fs.file("/blob.bin");
+        expect(file.size).toBe(5000);
+        expect(await file.bytes()).toEqual(payload);
+        // Slicing a decompressed entry has to work like any other file.
+        expect(await file.slice(10, 20).bytes()).toEqual(payload.subarray(10, 20));
+    });
+    it("returns null rather than throwing for anything absent", async () => {
+        const fs = zipFileSystem(fileOf("/a.zip", await makeZip([{ name: "a.txt", text: "a" }])));
+        expect(await fs.file("/nope.txt")).toBeNull();
+        expect(await fs.directory("/nope")).toBeNull();
+        // A directory is not a file and a file is not a directory.
+        expect(await fs.directory("/a.txt")).toBeNull();
+    });
+    it("says what is wrong when handed something that is not an archive", async () => {
+        const fs = zipFileSystem(fileOf("/a.zip", new TextEncoder().encode("not a zip")));
+        await expect(fs.file("/a.txt")).rejects.toThrow(/not a readable zip archive/);
+    });
+    it("can match names without regard to case, when asked", async () => {
+        const zip = await makeZip([{ name: "MS43.IPO", text: "x" }]);
+        expect(await zipFileSystem(fileOf("/a.zip", zip)).file("/ms43.ipo")).toBeNull();
+        const insensitive = zipFileSystem(fileOf("/a.zip", zip), { caseInsensitive: true });
+        expect(await insensitive.file("/ms43.ipo")).not.toBeNull();
+    });
+});
+describe("# addressing", () => {
+    let dir;
+    beforeAll(async () => {
+        dir = await mkdtemp(join(tmpdir(), "csfs-"));
+        const inner = await makeZip([{ name: "deep/file.txt", text: "from the inner zip" }]);
+        const outer = await makeZip([
+            { name: "inner.zip", bytes: inner },
+            { name: "plain.txt", text: "beside it" },
+        ]);
+        await writeFile(join(dir, "outer.zip"), outer);
+        await writeFile(join(dir, "loose.txt"), "on disk");
+    });
+    afterAll(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    it("reads through one archive", async () => {
+        const fs = withArchives(nodeFileSystem(dir));
+        expect(await fs.read("/outer.zip#/plain.txt").then((b) => new TextDecoder().decode(b))).toBe("beside it");
+    });
+    it("reads through nested archives", async () => {
+        // The reason nesting is supported at all: it costs one loop, and without
+        // it someone eventually hits the special case.
+        const fs = withArchives(nodeFileSystem(dir));
+        const bytes = await fs.read("/outer.zip#/inner.zip#/deep/file.txt");
+        expect(new TextDecoder().decode(bytes)).toBe("from the inner zip");
+    });
+    it("leaves ordinary paths alone", async () => {
+        const fs = withArchives(nodeFileSystem(dir));
+        expect(new TextDecoder().decode((await fs.read("/loose.txt")))).toBe("on disk");
+        expect(await fs.read("/absent.txt")).toBeNull();
+    });
+    it("lists a directory inside an archive", async () => {
+        const fs = withArchives(nodeFileSystem(dir));
+        const inside = await fs.directory("/outer.zip#/");
+        expect((await inside.entries()).map((e) => e.name).sort()).toEqual([
+            "inner.zip",
+            "plain.txt",
+        ]);
+    });
+    it("resolves .. without escaping the archive", async () => {
+        // Paths arrive from manifests and URLs, so this is untrusted input.
+        const fs = withArchives(nodeFileSystem(dir));
+        expect(await fs.read("/outer.zip#/../../../etc/passwd")).toBeNull();
+    });
+});
+describe("mounted archives", () => {
+    let dir;
+    beforeAll(async () => {
+        dir = await mkdtemp(join(tmpdir(), "csfs-mount-"));
+        // A flat archive standing in for a nested tree — the shape a parts
+        // catalogue ships its drawings in.
+        await writeFile(join(dir, "drawings.zip"), await makeZip([{ name: "1132C000.png", text: "a drawing" }]));
+        // Two archives serving one directory with no overlapping names, which is
+        // how a multi-disc set ships its illustrations.
+        await writeFile(join(dir, "img-1.zip"), await makeZip([{ name: "one.png", text: "first" }]));
+        await writeFile(join(dir, "img-2.zip"), await makeZip([{ name: "two.png", text: "second" }]));
+    });
+    afterAll(async () => {
+        await rm(dir, { recursive: true, force: true });
+    });
+    it("serves a flat archive under a nested path", async () => {
+        const fs = withTransparentArchives(nodeFileSystem(dir), [
+            { archive: "/drawings.zip", serves: "/drawings", entry: "basename" },
+        ]);
+        const bytes = await fs.read("/drawings/1132/1132C000.png");
+        expect(new TextDecoder().decode(bytes)).toBe("a drawing");
+    });
+    it("tries every archive that serves a directory", async () => {
+        const fs = withTransparentArchives(nodeFileSystem(dir), [
+            { archive: "/img-1.zip", serves: "/img", entry: "basename" },
+            { archive: "/img-2.zip", serves: "/img", entry: "basename" },
+        ]);
+        expect(new TextDecoder().decode((await fs.read("/img/one.png")))).toBe("first");
+        expect(new TextDecoder().decode((await fs.read("/img/two.png")))).toBe("second");
+        expect(await fs.read("/img/three.png")).toBeNull();
+    });
+    it("prefers a real file, so an extracted tree keeps working", async () => {
+        await writeFile(join(dir, "extracted.txt"), "the real one");
+        const fs = withTransparentArchives(nodeFileSystem(dir), [
+            { archive: "/drawings.zip", serves: "/", entry: "basename" },
+        ]);
+        expect(new TextDecoder().decode((await fs.read("/extracted.txt")))).toBe("the real one");
+    });
+    it("stats a file that exists only inside an archive", async () => {
+        const fs = withTransparentArchives(nodeFileSystem(dir), [
+            { archive: "/drawings.zip", serves: "/drawings", entry: "basename" },
+        ]);
+        const st = await fs.stat("/drawings/1132/1132C000.png");
+        expect(st).toEqual({ kind: "file", name: "1132C000.png", size: 9 });
+    });
+});
+/** Keep `openAsBlob` referenced: it is what makes the Node backend sliceable. */
+void openAsBlob;
+//# sourceMappingURL=zip-fs.test.js.map

package/dist/zip-fs.test.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@emdzej/csfs-zip",
+  "version": "0.1.0",
+  "description": "Mount a zip archive as a file system, read by range",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/emdzej/csfs.git",
+    "directory": "packages/zip"
+  },
+  "homepage": "https://github.com/emdzej/csfs/tree/main/packages/zip#readme",
+  "bugs": {
+    "url": "https://github.com/emdzej/csfs/issues"
+  },
+  "keywords": [
+    "filesystem",
+    "browser",
+    "zip",
+    "range-requests",
+    "opfs",
+    "file-system-access",
+    "http"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@zip.js/zip.js": "^2.10.0",
+    "@emdzej/csfs-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.1",
+    "@emdzej/csfs-node": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo"
+  }
+}