@earendil-works/chord 1.4.0 → 1.5.1

package/dist/node/app/files.js

@@ -0,0 +1,368 @@
+// Files (slice 13 §4; decision "Files v2"): the kit's file storage, one `Files` object per host (`self.get(Files, {})`),
+// its bytes in the host's `files/` and its index in the host's store (`files-index.ts`). Every file lives in a space
+// (`shared`, `artifacts`, `uploads`, …) at a path (`docs/report.md`); folders are index entries, and a move changes only
+// the index. Bytes never change: writing to a path adds a version (a new blob), `copy` shares a blob, and a blob goes
+// once no version references it. Small files in one call (`put`), large ones in chunks (design §23 "Chunked transfers":
+// `begin`, `append` at the stored offset, `uploaded` to resume after a drop, `finish`; unfinished uploads expire); a
+// `key` makes a write idempotent; reads by range; caps per host; a summary per space for an app's server index;
+// `FilesFolder` lists one folder live. Plugins never see a path on disk.
+import { readdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { setTimeout as sleep } from "node:timers/promises";
+import { arr, bool, bytes, int, keyed, lit, local, method, nul, obj, opt, str, union, } from "../../contracts/index.js";
+import { ChordError } from "../../data/index.js";
+import { invalid } from "../../data/internal.js";
+import { defineFacet } from "../../host/index.js";
+import { Blobs } from "./blobs.js";
+import { checkPath, checkSpace, FileSchema, FilesIndex, FolderSchema, MAX_PAGE, MetaSchema, SummarySchema, } from "./files-index.js";
+import { FolderViews } from "./folder-views.js";
+import { newToken } from "./secrets.js";
+import { Uploads } from "./uploads.js";
+/**
+ * A write's fields: where, its type, who wrote it (a string the writer sets), its producer's reference, key, `meta`, and
+ * an import's original time.
+ */
+const WRITE = {
+    space: str(),
+    path: str(),
+    mime: str(),
+    source: str(),
+    ref: opt(str({ min: 1 })),
+    key: opt(str({ min: 1 })),
+    meta: opt(MetaSchema),
+    /** For imports only: when the file was made where it comes from (ms since the epoch); the write's time otherwise. */
+    created: opt(int({ min: 0 })),
+};
+/** A page's arguments: a cursor of the page before, and how many (100 by default, at most 1,000). */
+const PAGE = { after: opt(str()), limit: opt(int({ min: 1, max: MAX_PAGE })) };
+/** A page of `item`s and the cursor of the next one. */
+const pageOf = (item) => obj({ items: arr(item), next: opt(str()) });
+/** A version or nothing. */
+const MAYBE_FILE = union([FileSchema, nul()]);
+/** One entry of a folder's listing. */
+const EntrySchema = union([
+    obj({ kind: lit("folder"), folder: FolderSchema }),
+    obj({ kind: lit("file"), file: FileSchema }),
+]);
+/** The host's files (one per host): writes, reads, the index's queries, folders, moves, copies, removal, summaries. */
+export const Files = local("chord.app.files", {
+    version: 2,
+    params: {},
+    members: {
+        /** Each space's summary (counts, bytes, the newest versions): what an app mirrors to its server's index. */
+        summary: keyed(SummarySchema),
+        /**
+         * Stores a small file (at most 4 MiB) in one call as a new version at `path`, one past the highest it ever had.
+         * A `key` the space has already stores nothing and answers the version written with it.
+         */
+        put: method(obj({ ...WRITE, bytes: bytes() }), FileSchema),
+        /**
+         * Starts a chunked upload of what `finish` stores as `put` would: its upload id; with a `key` the space has, the
+         * version written with it (`exists`), or the upload under way with it. `unavailable` (`busy`) while the host's cap
+         * of uploads are under way.
+         */
+        begin: method(obj(WRITE), union([obj({ kind: lit("upload"), upload: str() }), obj({ kind: lit("exists"), file: FileSchema })])),
+        /**
+         * Appends a chunk (at most 4 MiB; about 1 MiB is the usual size) to upload `upload` at `offset`, which must be
+         * the bytes stored so far (else `invalid`, its details `{ offset }` the stored one).
+         */
+        append: method(obj({ upload: str(), offset: int({ min: 0 }), bytes: bytes() })),
+        /** The bytes stored so far of upload `upload`: where a writer resumes after a drop. */
+        uploaded: method(str(), int()),
+        /** Ends upload `upload`: the version it made. */
+        finish: method(str(), FileSchema),
+        /** Drops upload `upload` and what it stored (an unknown one: nothing): its writer gave up. */
+        cancel: method(str()),
+        /** `length` bytes (at most 4 MiB) of version `id` from `offset` (fewer at its end). */
+        read: method(obj({ id: str(), offset: int({ min: 0 }), length: int({ min: 0 }) }), bytes()),
+        /** Version `id`, or `null`. */
+        file: method(str(), MAYBE_FILE),
+        /** Version `version` of the file at `path` (its newest without one), or `null`. */
+        get: method(obj({ space: str(), path: str(), version: opt(int({ min: 1 })) }), MAYBE_FILE),
+        /** The version written with `key` in `space`, or `null`. */
+        byKey: method(obj({ space: str(), key: str({ min: 1 }) }), MAYBE_FILE),
+        /** A page of the versions with `ref` in `space`, oldest first. */
+        byRef: method(obj({ space: str(), ref: str({ min: 1 }), ...PAGE }), pageOf(FileSchema)),
+        /** A page of the versions of the file at `path`, newest first. */
+        versions: method(obj({ space: str(), path: str(), ...PAGE }), pageOf(FileSchema)),
+        /** A page of folder `folder`'s entries (`""`: the space's root): its folders, then its files' newest versions. */
+        list: method(obj({ space: str(), folder: str(), ...PAGE }), pageOf(EntrySchema)),
+        /** Makes folder `path` and its missing parents (an existing one: itself); refused where a file is. */
+        mkdir: method(obj({ space: str(), path: str() }), FolderSchema),
+        /**
+         * Moves (renames) the file or folder `from` to `to`, changing only the index; refused when `to` exists or lies
+         * inside `from`.
+         */
+        move: method(obj({ space: str(), from: str(), to: str() })),
+        /** Copies version `id` as a new version at `path` of `space`, sharing its blob (its metadata but its key). */
+        copy: method(obj({ id: str(), space: str(), path: str() }), FileSchema),
+        /** Removes version `id` (an unknown one: nothing); the next older version becomes the path's newest. */
+        remove: method(str()),
+        /** Removes the file at `path` (every version) or the folder at `path` with everything under it. */
+        removePath: method(obj({ space: str(), path: str() })),
+        /** Removes everything in space `space`. */
+        removeSpace: method(str()),
+    },
+});
+/** One folder of the host's files, live: its first 500 entries (folders, then files) and whether more follow. */
+export const FilesFolder = local("chord.app.files.folder", {
+    version: 1,
+    params: { space: str(), folder: str() },
+    members: { listing: obj({ entries: arr(EntrySchema), more: bool() }) },
+});
+/** The largest piece a call carries (a `put`, an `append`, a `read`): 4 MiB, well under a link's part limit. */
+const MAX_PIECE = 4 * 1024 * 1024;
+/** A page's size when the caller names none. */
+const PAGE_SIZE = 100;
+/** How many entries a `FilesFolder` shows. */
+const FOLDER_VIEW = 500;
+/** How long an upload may go unwritten before it expires: an hour. */
+const UPLOAD_IDLE_MS = 60 * 60_000;
+/** How often expired uploads are dropped: every minute. */
+const SWEEP_MS = 60_000;
+/**
+ * The kit's facet serving `Files` and `FilesFolder` with the host's files directory `dir` (`<host dir>/files`),
+ * `caps` and at most `uploads` uploads under way (64 by default). Blobs live in `dir/blobs/`, uploads under way in
+ * `dir/.uploads/<run>/` (`Uploads`), ending with the object (an unfinished one is dropped when the next one goes live).
+ * For apps that host their own hosts; `startServer` and `startWorker` load it on theirs.
+ */
+export function filesFacet(dir, caps = {}, uploads = 64) {
+    const maxFile = caps.maxFile ?? 256 * 1024 * 1024;
+    const maxTotal = caps.maxTotal ?? 4 * 1024 * 1024 * 1024;
+    const uploadsDir = join(dir, ".uploads");
+    const blobs = new Blobs(join(dir, "blobs"));
+    const views = new FolderViews();
+    return defineFacet((host) => {
+        host.serve(Files, (_params, self) => {
+            const index = new FilesIndex(self);
+            // This run's uploads in their own directory: an upload left by an earlier run (its process ended) can never
+            // finish and is dropped, while this run's may already have begun.
+            const run = join(uploadsDir, newToken(12));
+            const underway = new Uploads(run, uploads);
+            views.bind(async (space, folder, ctx) => {
+                const page = await index.list(space, folder, FOLDER_VIEW, undefined, ctx);
+                return { entries: page.items, more: page.next !== undefined };
+            });
+            // Changes take turns: a version number, a key and a blob's count are decided by the one change running.
+            let last = Promise.resolve();
+            const turn = (fn) => {
+                const result = last.then(fn);
+                last = result.catch(() => { });
+                return result;
+            };
+            // Uploads under way count against the total too: two of them cannot pass it together.
+            const room = (adding, fileSize) => {
+                if (fileSize > maxFile)
+                    throw tooLarge(`a file of ${fileSize} bytes is larger than this host's cap (${maxFile})`);
+                if (index.usage.value.bytes + underway.size + adding > maxTotal) {
+                    throw tooLarge(`this host's files would exceed their cap (${maxTotal} bytes)`);
+                }
+            };
+            // A new blob's version; the blob goes again when its index commit fails.
+            const store = async (write, blob, size, ctx) => {
+                try {
+                    const file = await index.add(newToken(12), write, { id: blob, size, fresh: true }, ctx);
+                    await views.changed(write.space, ctx);
+                    return file;
+                }
+                catch (error) {
+                    await blobs.remove([blob]);
+                    throw error;
+                }
+            };
+            const known = async (write, ctx) => write.key === undefined ? undefined : index.byKey(write.space, write.key, ctx);
+            self.onLive((ctx) => sweep(uploadsDir, run, underway, () => turn(() => blobs.sweep((id) => index.hasBlob(id, ctx))), ctx));
+            return {
+                summary: index.summary,
+                put: ({ bytes, ...write }, ctx) => {
+                    checkWrite(write);
+                    if (bytes.length > MAX_PIECE)
+                        throw tooLarge(`put takes at most ${MAX_PIECE} bytes: use begin, append, finish`);
+                    return turn(async () => {
+                        const existing = await known(write, ctx);
+                        if (existing !== undefined)
+                            return existing;
+                        room(bytes.length, bytes.length);
+                        const blob = newToken(12);
+                        await blobs.write(blob, bytes, join(run, `put-${blob}`)).catch(async (error) => {
+                            await rm(join(run, `put-${blob}`), { force: true });
+                            throw error;
+                        });
+                        return store(write, blob, bytes.length, ctx);
+                    });
+                },
+                begin: (write, ctx) => {
+                    checkWrite(write);
+                    return turn(async () => {
+                        const existing = await known(write, ctx);
+                        if (existing !== undefined)
+                            return { kind: "exists", file: existing };
+                        const resumed = underway.find((data) => data.space === write.space && data.key !== undefined && data.key === write.key);
+                        if (resumed !== undefined)
+                            return { kind: "upload", upload: resumed };
+                        if ((await index.exists(write.space, write.path, ctx)) === "folder")
+                            throw invalid("args", `files: ${write.space}:${write.path} is a folder`, { conflict: write.path });
+                        return { kind: "upload", upload: await underway.begin(write) };
+                    });
+                },
+                append: async ({ upload, offset, bytes }) => {
+                    if (bytes.length > MAX_PIECE)
+                        throw tooLarge(`append takes at most ${MAX_PIECE} bytes`);
+                    await underway.append(upload, offset, bytes, room);
+                    return null;
+                },
+                uploaded: (upload) => underway.uploaded(upload),
+                finish: (upload, ctx) => turn(async () => {
+                    const blob = newToken(12);
+                    await blobs.prepare();
+                    const { data, size } = await underway.finish(upload, blobs.path(blob));
+                    const existing = await known(data, ctx);
+                    if (existing === undefined)
+                        return store(data, blob, size, ctx);
+                    await blobs.remove([blob]);
+                    return existing;
+                }),
+                cancel: async (upload) => {
+                    await underway.cancel(upload);
+                    return null;
+                },
+                read: async ({ id, offset, length }, ctx) => {
+                    if (length > MAX_PIECE)
+                        throw tooLarge(`read takes at most ${MAX_PIECE} bytes`);
+                    const found = await index.blobOf(id, ctx);
+                    if (found === undefined)
+                        throw invalid("args", `files: no file ${id}`);
+                    return blobs.read(found.blob, found.size, offset, length);
+                },
+                file: async (id, ctx) => (await index.file(id, ctx)) ?? null,
+                get: async ({ space, path, version }, ctx) => {
+                    checkSpace(space);
+                    checkPath(path, "file");
+                    return (await index.get(space, path, version, ctx)) ?? null;
+                },
+                byKey: async ({ space, key }, ctx) => {
+                    checkSpace(space);
+                    return (await index.byKey(space, key, ctx)) ?? null;
+                },
+                byRef: ({ space, ref, after, limit }, ctx) => {
+                    checkSpace(space);
+                    return index.byRef(space, ref, limit ?? PAGE_SIZE, after, ctx);
+                },
+                versions: ({ space, path, after, limit }, ctx) => {
+                    checkSpace(space);
+                    checkPath(path, "file");
+                    return index.versions(space, path, limit ?? PAGE_SIZE, after, ctx);
+                },
+                list: ({ space, folder, after, limit }, ctx) => {
+                    checkSpace(space);
+                    checkPath(folder, "folder");
+                    return index.list(space, folder, limit ?? PAGE_SIZE, after, ctx);
+                },
+                mkdir: ({ space, path }, ctx) => {
+                    checkSpace(space);
+                    checkPath(path, "file");
+                    return turn(async () => {
+                        const folder = await index.mkdir(space, path, ctx);
+                        await views.changed(space, ctx);
+                        return folder;
+                    });
+                },
+                move: ({ space, from, to }, ctx) => {
+                    checkSpace(space);
+                    checkPath(from, "file");
+                    checkPath(to, "file");
+                    return turn(async () => {
+                        await index.move(space, from, to, ctx);
+                        await views.changed(space, ctx);
+                        return null;
+                    });
+                },
+                copy: ({ id, space, path }, ctx) => {
+                    checkSpace(space);
+                    checkPath(path, "file");
+                    return turn(async () => {
+                        const [file, found] = [await index.file(id, ctx), await index.blobOf(id, ctx)];
+                        if (file === undefined || found === undefined)
+                            throw invalid("args", `files: no file ${id}`);
+                        const { mime, source, ref, meta } = file;
+                        const write = {
+                            space,
+                            path,
+                            mime,
+                            source,
+                            ...(ref === undefined ? {} : { ref }),
+                            ...(meta === undefined ? {} : { meta }),
+                        };
+                        const copied = await index.add(newToken(12), write, { id: found.blob, size: found.size, fresh: false }, ctx);
+                        await views.changed(space, ctx);
+                        return copied;
+                    });
+                },
+                remove: (id, ctx) => turn(async () => {
+                    const removed = await index.remove(id, ctx);
+                    if (removed === undefined)
+                        return null;
+                    await blobs.remove(removed.gone);
+                    await views.changed(removed.space, ctx);
+                    return null;
+                }),
+                removePath: ({ space, path }, ctx) => {
+                    checkSpace(space);
+                    checkPath(path, "file");
+                    return turn(async () => {
+                        await blobs.remove(await index.removePath(space, path, ctx));
+                        await views.changed(space, ctx);
+                        return null;
+                    });
+                },
+                removeSpace: (space, ctx) => {
+                    checkSpace(space);
+                    return turn(async () => {
+                        await blobs.remove(await index.removeSpace(space, ctx));
+                        await views.changed(space, ctx);
+                        return null;
+                    });
+                },
+            };
+        });
+        host.serve(FilesFolder, ({ space, folder }, self) => {
+            checkSpace(space);
+            checkPath(folder, "folder");
+            // Its listing is read through the host's `Files`, which must be live first.
+            self.get(Files, {});
+            return { listing: self.follow((observer, ctx) => views.attach(space, folder, observer, ctx)) };
+        });
+    });
+}
+/** Refuses a write's space or path outside the rules (a trust boundary: the caller's). */
+function checkWrite(write) {
+    checkSpace(write.space);
+    checkPath(write.path, "file");
+}
+/**
+ * The files object's routine once live: drops the uploads earlier runs left (every directory under `uploadsDir` but
+ * `run`) and the blobs no commit took (`sweepBlobs`), then every minute the uploads unwritten for an hour; when the
+ * object ends, every upload still under way.
+ */
+async function sweep(uploadsDir, run, uploads, sweepBlobs, ctx) {
+    for (const entry of await readdir(uploadsDir).catch(() => [])) {
+        if (join(uploadsDir, entry) !== run)
+            await rm(join(uploadsDir, entry), { recursive: true, force: true });
+    }
+    try {
+        await sweepBlobs();
+        for (;;) {
+            await sleep(SWEEP_MS, undefined, { signal: ctx.abortSignal });
+            await uploads.expire(UPLOAD_IDLE_MS);
+        }
+    }
+    finally {
+        if (ctx.abortSignal?.aborted === true)
+            await uploads.close();
+    }
+}
+/** A cap refused a write. */
+function tooLarge(message) {
+    return new ChordError({ code: "too_large", message: `files: ${message}` });
+}
+//# sourceMappingURL=files.js.map

package/dist/node/app/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/node/app/files.ts"],"names":[],"mappings":"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","sourcesContent":["// Files (slice 13 §4; decision \"Files v2\"): the kit's file storage, one `Files` object per host (`self.get(Files, {})`),\n// its bytes in the host's `files/` and its index in the host's store (`files-index.ts`). Every file lives in a space\n// (`shared`, `artifacts`, `uploads`, …) at a path (`docs/report.md`); folders are index entries, and a move changes only\n// the index. Bytes never change: writing to a path adds a version (a new blob), `copy` shares a blob, and a blob goes\n// once no version references it. Small files in one call (`put`), large ones in chunks (design §23 \"Chunked transfers\":\n// `begin`, `append` at the stored offset, `uploaded` to resume after a drop, `finish`; unfinished uploads expire); a\n// `key` makes a write idempotent; reads by range; caps per host; a summary per space for an app's server index;\n// `FilesFolder` lists one folder live. Plugins never see a path on disk.\n\nimport { readdir, rm } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { setTimeout as sleep } from \"node:timers/promises\";\nimport type { Context } from \"../../context/index.ts\";\nimport {\n\tarr,\n\tbool,\n\tbytes,\n\tint,\n\tkeyed,\n\tlit,\n\tlocal,\n\tmethod,\n\tnul,\n\tobj,\n\topt,\n\ttype Schema,\n\tstr,\n\tunion,\n} from \"../../contracts/index.ts\";\nimport { ChordError, type Principal } from \"../../data/index.ts\";\nimport { invalid } from \"../../data/internal.ts\";\nimport { type Ctx, defineFacet, type Facet } from \"../../host/index.ts\";\nimport { Blobs } from \"./blobs.ts\";\nimport {\n\tcheckPath,\n\tcheckSpace,\n\ttype FileInfo,\n\tFileSchema,\n\tFilesIndex,\n\ttype FileWrite,\n\tFolderSchema,\n\tMAX_PAGE,\n\tMetaSchema,\n\tSummarySchema,\n} from \"./files-index.ts\";\nimport { type FolderListing, FolderViews } from \"./folder-views.ts\";\nimport { newToken } from \"./secrets.ts\";\nimport { Uploads } from \"./uploads.ts\";\n\nexport type { FileInfo, FileWrite, FolderEntry, FolderInfo, SpaceSummary } from \"./files-index.ts\";\nexport type { FolderListing } from \"./folder-views.ts\";\n\n/** The caps of one host's files (bytes). */\nexport type FilesCaps = {\n\t/** The largest file: 256 MiB by default. */\n\treadonly maxFile?: number;\n\t/** All blobs on disk together (a copy shares its blob), uploads under way included: 4 GiB by default. */\n\treadonly maxTotal?: number;\n};\n\n/**\n * A write's fields: where, its type, who wrote it (a string the writer sets), its producer's reference, key, `meta`, and\n * an import's original time.\n */\nconst WRITE = {\n\tspace: str(),\n\tpath: str(),\n\tmime: str(),\n\tsource: str(),\n\tref: opt(str({ min: 1 })),\n\tkey: opt(str({ min: 1 })),\n\tmeta: opt(MetaSchema),\n\t/** For imports only: when the file was made where it comes from (ms since the epoch); the write's time otherwise. */\n\tcreated: opt(int({ min: 0 })),\n};\n\n/** A page's arguments: a cursor of the page before, and how many (100 by default, at most 1,000). */\nconst PAGE = { after: opt(str()), limit: opt(int({ min: 1, max: MAX_PAGE })) };\n\n/** A page of `item`s and the cursor of the next one. */\nconst pageOf = <T>(item: Schema<T>) => obj({ items: arr(item), next: opt(str()) });\n\n/** A version or nothing. */\nconst MAYBE_FILE = union([FileSchema, nul()]);\n\n/** One entry of a folder's listing. */\nconst EntrySchema = union([\n\tobj({ kind: lit(\"folder\"), folder: FolderSchema }),\n\tobj({ kind: lit(\"file\"), file: FileSchema }),\n]);\n\n/** The host's files (one per host): writes, reads, the index's queries, folders, moves, copies, removal, summaries. */\nexport const Files = local(\"chord.app.files\", {\n\tversion: 2,\n\tparams: {},\n\tmembers: {\n\t\t/** Each space's summary (counts, bytes, the newest versions): what an app mirrors to its server's index. */\n\t\tsummary: keyed(SummarySchema),\n\t\t/**\n\t\t * Stores a small file (at most 4 MiB) in one call as a new version at `path`, one past the highest it ever had.\n\t\t * A `key` the space has already stores nothing and answers the version written with it.\n\t\t */\n\t\tput: method(obj({ ...WRITE, bytes: bytes() }), FileSchema),\n\t\t/**\n\t\t * Starts a chunked upload of what `finish` stores as `put` would: its upload id; with a `key` the space has, the\n\t\t * version written with it (`exists`), or the upload under way with it. `unavailable` (`busy`) while the host's cap\n\t\t * of uploads are under way.\n\t\t */\n\t\tbegin: method(\n\t\t\tobj(WRITE),\n\t\t\tunion([obj({ kind: lit(\"upload\"), upload: str() }), obj({ kind: lit(\"exists\"), file: FileSchema })]),\n\t\t),\n\t\t/**\n\t\t * Appends a chunk (at most 4 MiB; about 1 MiB is the usual size) to upload `upload` at `offset`, which must be\n\t\t * the bytes stored so far (else `invalid`, its details `{ offset }` the stored one).\n\t\t */\n\t\tappend: method(obj({ upload: str(), offset: int({ min: 0 }), bytes: bytes() })),\n\t\t/** The bytes stored so far of upload `upload`: where a writer resumes after a drop. */\n\t\tuploaded: method(str(), int()),\n\t\t/** Ends upload `upload`: the version it made. */\n\t\tfinish: method(str(), FileSchema),\n\t\t/** Drops upload `upload` and what it stored (an unknown one: nothing): its writer gave up. */\n\t\tcancel: method(str()),\n\t\t/** `length` bytes (at most 4 MiB) of version `id` from `offset` (fewer at its end). */\n\t\tread: method(obj({ id: str(), offset: int({ min: 0 }), length: int({ min: 0 }) }), bytes()),\n\t\t/** Version `id`, or `null`. */\n\t\tfile: method(str(), MAYBE_FILE),\n\t\t/** Version `version` of the file at `path` (its newest without one), or `null`. */\n\t\tget: method(obj({ space: str(), path: str(), version: opt(int({ min: 1 })) }), MAYBE_FILE),\n\t\t/** The version written with `key` in `space`, or `null`. */\n\t\tbyKey: method(obj({ space: str(), key: str({ min: 1 }) }), MAYBE_FILE),\n\t\t/** A page of the versions with `ref` in `space`, oldest first. */\n\t\tbyRef: method(obj({ space: str(), ref: str({ min: 1 }), ...PAGE }), pageOf(FileSchema)),\n\t\t/** A page of the versions of the file at `path`, newest first. */\n\t\tversions: method(obj({ space: str(), path: str(), ...PAGE }), pageOf(FileSchema)),\n\t\t/** A page of folder `folder`'s entries (`\"\"`: the space's root): its folders, then its files' newest versions. */\n\t\tlist: method(obj({ space: str(), folder: str(), ...PAGE }), pageOf(EntrySchema)),\n\t\t/** Makes folder `path` and its missing parents (an existing one: itself); refused where a file is. */\n\t\tmkdir: method(obj({ space: str(), path: str() }), FolderSchema),\n\t\t/**\n\t\t * Moves (renames) the file or folder `from` to `to`, changing only the index; refused when `to` exists or lies\n\t\t * inside `from`.\n\t\t */\n\t\tmove: method(obj({ space: str(), from: str(), to: str() })),\n\t\t/** Copies version `id` as a new version at `path` of `space`, sharing its blob (its metadata but its key). */\n\t\tcopy: method(obj({ id: str(), space: str(), path: str() }), FileSchema),\n\t\t/** Removes version `id` (an unknown one: nothing); the next older version becomes the path's newest. */\n\t\tremove: method(str()),\n\t\t/** Removes the file at `path` (every version) or the folder at `path` with everything under it. */\n\t\tremovePath: method(obj({ space: str(), path: str() })),\n\t\t/** Removes everything in space `space`. */\n\t\tremoveSpace: method(str()),\n\t},\n});\n\n/** One folder of the host's files, live: its first 500 entries (folders, then files) and whether more follow. */\nexport const FilesFolder = local(\"chord.app.files.folder\", {\n\tversion: 1,\n\tparams: { space: str(), folder: str() },\n\tmembers: { listing: obj({ entries: arr(EntrySchema), more: bool() }) },\n});\n\n/** The largest piece a call carries (a `put`, an `append`, a `read`): 4 MiB, well under a link's part limit. */\nconst MAX_PIECE = 4 * 1024 * 1024;\n\n/** A page's size when the caller names none. */\nconst PAGE_SIZE = 100;\n\n/** How many entries a `FilesFolder` shows. */\nconst FOLDER_VIEW = 500;\n\n/** How long an upload may go unwritten before it expires: an hour. */\nconst UPLOAD_IDLE_MS = 60 * 60_000;\n\n/** How often expired uploads are dropped: every minute. */\nconst SWEEP_MS = 60_000;\n\n/**\n * The kit's facet serving `Files` and `FilesFolder` with the host's files directory `dir` (`<host dir>/files`),\n * `caps` and at most `uploads` uploads under way (64 by default). Blobs live in `dir/blobs/`, uploads under way in\n * `dir/.uploads/<run>/` (`Uploads`), ending with the object (an unfinished one is dropped when the next one goes live).\n * For apps that host their own hosts; `startServer` and `startWorker` load it on theirs.\n */\nexport function filesFacet<P extends Principal>(dir: string, caps: FilesCaps = {}, uploads = 64): Facet<P> {\n\tconst maxFile = caps.maxFile ?? 256 * 1024 * 1024;\n\tconst maxTotal = caps.maxTotal ?? 4 * 1024 * 1024 * 1024;\n\tconst uploadsDir = join(dir, \".uploads\");\n\tconst blobs = new Blobs(join(dir, \"blobs\"));\n\tconst views = new FolderViews();\n\treturn defineFacet<P>((host) => {\n\t\thost.serve(Files, (_params, self) => {\n\t\t\tconst index = new FilesIndex(self);\n\t\t\t// This run's uploads in their own directory: an upload left by an earlier run (its process ended) can never\n\t\t\t// finish and is dropped, while this run's may already have begun.\n\t\t\tconst run = join(uploadsDir, newToken(12));\n\t\t\tconst underway = new Uploads<FileWrite>(run, uploads);\n\t\t\tviews.bind(async (space, folder, ctx) => {\n\t\t\t\tconst page = await index.list(space, folder, FOLDER_VIEW, undefined, ctx);\n\t\t\t\treturn { entries: page.items, more: page.next !== undefined };\n\t\t\t});\n\t\t\t// Changes take turns: a version number, a key and a blob's count are decided by the one change running.\n\t\t\tlet last: Promise<unknown> = Promise.resolve();\n\t\t\tconst turn = <R>(fn: () => Promise<R>): Promise<R> => {\n\t\t\t\tconst result = last.then(fn);\n\t\t\t\tlast = result.catch(() => {});\n\t\t\t\treturn result;\n\t\t\t};\n\t\t\t// Uploads under way count against the total too: two of them cannot pass it together.\n\t\t\tconst room = (adding: number, fileSize: number): void => {\n\t\t\t\tif (fileSize > maxFile)\n\t\t\t\t\tthrow tooLarge(`a file of ${fileSize} bytes is larger than this host's cap (${maxFile})`);\n\t\t\t\tif (index.usage.value.bytes + underway.size + adding > maxTotal) {\n\t\t\t\t\tthrow tooLarge(`this host's files would exceed their cap (${maxTotal} bytes)`);\n\t\t\t\t}\n\t\t\t};\n\t\t\t// A new blob's version; the blob goes again when its index commit fails.\n\t\t\tconst store = async (write: FileWrite, blob: string, size: number, ctx: Ctx): Promise<FileInfo> => {\n\t\t\t\ttry {\n\t\t\t\t\tconst file = await index.add(newToken(12), write, { id: blob, size, fresh: true }, ctx);\n\t\t\t\t\tawait views.changed(write.space, ctx);\n\t\t\t\t\treturn file;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tawait blobs.remove([blob]);\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t};\n\t\t\tconst known = async (write: FileWrite, ctx: Ctx): Promise<FileInfo | undefined> =>\n\t\t\t\twrite.key === undefined ? undefined : index.byKey(write.space, write.key, ctx);\n\t\t\tself.onLive((ctx) =>\n\t\t\t\tsweep(uploadsDir, run, underway, () => turn(() => blobs.sweep((id) => index.hasBlob(id, ctx))), ctx),\n\t\t\t);\n\t\t\treturn {\n\t\t\t\tsummary: index.summary,\n\t\t\t\tput: ({ bytes, ...write }, ctx) => {\n\t\t\t\t\tcheckWrite(write);\n\t\t\t\t\tif (bytes.length > MAX_PIECE)\n\t\t\t\t\t\tthrow tooLarge(`put takes at most ${MAX_PIECE} bytes: use begin, append, finish`);\n\t\t\t\t\treturn turn(async () => {\n\t\t\t\t\t\tconst existing = await known(write, ctx);\n\t\t\t\t\t\tif (existing !== undefined) return existing;\n\t\t\t\t\t\troom(bytes.length, bytes.length);\n\t\t\t\t\t\tconst blob = newToken(12);\n\t\t\t\t\t\tawait blobs.write(blob, bytes, join(run, `put-${blob}`)).catch(async (error: unknown) => {\n\t\t\t\t\t\t\tawait rm(join(run, `put-${blob}`), { force: true });\n\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t});\n\t\t\t\t\t\treturn store(write, blob, bytes.length, ctx);\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tbegin: (write, ctx) => {\n\t\t\t\t\tcheckWrite(write);\n\t\t\t\t\treturn turn(async () => {\n\t\t\t\t\t\tconst existing = await known(write, ctx);\n\t\t\t\t\t\tif (existing !== undefined) return { kind: \"exists\" as const, file: existing };\n\t\t\t\t\t\tconst resumed = underway.find(\n\t\t\t\t\t\t\t(data) => data.space === write.space && data.key !== undefined && data.key === write.key,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tif (resumed !== undefined) return { kind: \"upload\" as const, upload: resumed };\n\t\t\t\t\t\tif ((await index.exists(write.space, write.path, ctx)) === \"folder\")\n\t\t\t\t\t\t\tthrow invalid(\"args\", `files: ${write.space}:${write.path} is a folder`, { conflict: write.path });\n\t\t\t\t\t\treturn { kind: \"upload\" as const, upload: await underway.begin(write) };\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tappend: async ({ upload, offset, bytes }) => {\n\t\t\t\t\tif (bytes.length > MAX_PIECE) throw tooLarge(`append takes at most ${MAX_PIECE} bytes`);\n\t\t\t\t\tawait underway.append(upload, offset, bytes, room);\n\t\t\t\t\treturn null;\n\t\t\t\t},\n\t\t\t\tuploaded: (upload) => underway.uploaded(upload),\n\t\t\t\tfinish: (upload, ctx) =>\n\t\t\t\t\tturn(async () => {\n\t\t\t\t\t\tconst blob = newToken(12);\n\t\t\t\t\t\tawait blobs.prepare();\n\t\t\t\t\t\tconst { data, size } = await underway.finish(upload, blobs.path(blob));\n\t\t\t\t\t\tconst existing = await known(data, ctx);\n\t\t\t\t\t\tif (existing === undefined) return store(data, blob, size, ctx);\n\t\t\t\t\t\tawait blobs.remove([blob]);\n\t\t\t\t\t\treturn existing;\n\t\t\t\t\t}),\n\t\t\t\tcancel: async (upload) => {\n\t\t\t\t\tawait underway.cancel(upload);\n\t\t\t\t\treturn null;\n\t\t\t\t},\n\t\t\t\tread: async ({ id, offset, length }, ctx) => {\n\t\t\t\t\tif (length > MAX_PIECE) throw tooLarge(`read takes at most ${MAX_PIECE} bytes`);\n\t\t\t\t\tconst found = await index.blobOf(id, ctx);\n\t\t\t\t\tif (found === undefined) throw invalid(\"args\", `files: no file ${id}`);\n\t\t\t\t\treturn blobs.read(found.blob, found.size, offset, length);\n\t\t\t\t},\n\t\t\t\tfile: async (id, ctx) => (await index.file(id, ctx)) ?? null,\n\t\t\t\tget: async ({ space, path, version }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\tcheckPath(path, \"file\");\n\t\t\t\t\treturn (await index.get(space, path, version, ctx)) ?? null;\n\t\t\t\t},\n\t\t\t\tbyKey: async ({ space, key }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\treturn (await index.byKey(space, key, ctx)) ?? null;\n\t\t\t\t},\n\t\t\t\tbyRef: ({ space, ref, after, limit }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\treturn index.byRef(space, ref, limit ?? PAGE_SIZE, after, ctx);\n\t\t\t\t},\n\t\t\t\tversions: ({ space, path, after, limit }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\tcheckPath(path, \"file\");\n\t\t\t\t\treturn index.versions(space, path, limit ?? PAGE_SIZE, after, ctx);\n\t\t\t\t},\n\t\t\t\tlist: ({ space, folder, after, limit }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\tcheckPath(folder, \"folder\");\n\t\t\t\t\treturn index.list(space, folder, limit ?? PAGE_SIZE, after, ctx);\n\t\t\t\t},\n\t\t\t\tmkdir: ({ space, path }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\tcheckPath(path, \"file\");\n\t\t\t\t\treturn turn(async () => {\n\t\t\t\t\t\tconst folder = await index.mkdir(space, path, ctx);\n\t\t\t\t\t\tawait views.changed(space, ctx);\n\t\t\t\t\t\treturn folder;\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tmove: ({ space, from, to }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\tcheckPath(from, \"file\");\n\t\t\t\t\tcheckPath(to, \"file\");\n\t\t\t\t\treturn turn(async () => {\n\t\t\t\t\t\tawait index.move(space, from, to, ctx);\n\t\t\t\t\t\tawait views.changed(space, ctx);\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tcopy: ({ id, space, path }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\tcheckPath(path, \"file\");\n\t\t\t\t\treturn turn(async () => {\n\t\t\t\t\t\tconst [file, found] = [await index.file(id, ctx), await index.blobOf(id, ctx)];\n\t\t\t\t\t\tif (file === undefined || found === undefined) throw invalid(\"args\", `files: no file ${id}`);\n\t\t\t\t\t\tconst { mime, source, ref, meta } = file;\n\t\t\t\t\t\tconst write = {\n\t\t\t\t\t\t\tspace,\n\t\t\t\t\t\t\tpath,\n\t\t\t\t\t\t\tmime,\n\t\t\t\t\t\t\tsource,\n\t\t\t\t\t\t\t...(ref === undefined ? {} : { ref }),\n\t\t\t\t\t\t\t...(meta === undefined ? {} : { meta }),\n\t\t\t\t\t\t};\n\t\t\t\t\t\tconst copied = await index.add(\n\t\t\t\t\t\t\tnewToken(12),\n\t\t\t\t\t\t\twrite,\n\t\t\t\t\t\t\t{ id: found.blob, size: found.size, fresh: false },\n\t\t\t\t\t\t\tctx,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tawait views.changed(space, ctx);\n\t\t\t\t\t\treturn copied;\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tremove: (id, ctx) =>\n\t\t\t\t\tturn(async () => {\n\t\t\t\t\t\tconst removed = await index.remove(id, ctx);\n\t\t\t\t\t\tif (removed === undefined) return null;\n\t\t\t\t\t\tawait blobs.remove(removed.gone);\n\t\t\t\t\t\tawait views.changed(removed.space, ctx);\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t}),\n\t\t\t\tremovePath: ({ space, path }, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\tcheckPath(path, \"file\");\n\t\t\t\t\treturn turn(async () => {\n\t\t\t\t\t\tawait blobs.remove(await index.removePath(space, path, ctx));\n\t\t\t\t\t\tawait views.changed(space, ctx);\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tremoveSpace: (space, ctx) => {\n\t\t\t\t\tcheckSpace(space);\n\t\t\t\t\treturn turn(async () => {\n\t\t\t\t\t\tawait blobs.remove(await index.removeSpace(space, ctx));\n\t\t\t\t\t\tawait views.changed(space, ctx);\n\t\t\t\t\t\treturn null;\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t};\n\t\t});\n\t\thost.serve(FilesFolder, ({ space, folder }, self) => {\n\t\t\tcheckSpace(space);\n\t\t\tcheckPath(folder, \"folder\");\n\t\t\t// Its listing is read through the host's `Files`, which must be live first.\n\t\t\tself.get(Files, {});\n\t\t\treturn { listing: self.follow<FolderListing>((observer, ctx) => views.attach(space, folder, observer, ctx)) };\n\t\t});\n\t});\n}\n\n/** Refuses a write's space or path outside the rules (a trust boundary: the caller's). */\nfunction checkWrite(write: FileWrite): void {\n\tcheckSpace(write.space);\n\tcheckPath(write.path, \"file\");\n}\n\n/**\n * The files object's routine once live: drops the uploads earlier runs left (every directory under `uploadsDir` but\n * `run`) and the blobs no commit took (`sweepBlobs`), then every minute the uploads unwritten for an hour; when the\n * object ends, every upload still under way.\n */\nasync function sweep(\n\tuploadsDir: string,\n\trun: string,\n\tuploads: Uploads<FileWrite>,\n\tsweepBlobs: () => Promise<void>,\n\tctx: Context,\n): Promise<void> {\n\tfor (const entry of await readdir(uploadsDir).catch(() => [])) {\n\t\tif (join(uploadsDir, entry) !== run) await rm(join(uploadsDir, entry), { recursive: true, force: true });\n\t}\n\ttry {\n\t\tawait sweepBlobs();\n\t\tfor (;;) {\n\t\t\tawait sleep(SWEEP_MS, undefined, { signal: ctx.abortSignal });\n\t\t\tawait uploads.expire(UPLOAD_IDLE_MS);\n\t\t}\n\t} finally {\n\t\tif (ctx.abortSignal?.aborted === true) await uploads.close();\n\t}\n}\n\n/** A cap refused a write. */\nfunction tooLarge(message: string): ChordError {\n\treturn new ChordError({ code: \"too_large\", message: `files: ${message}` });\n}\n"]}

package/dist/node/app/folder-views.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from "../../context/index.ts";
+import type { FollowAttachment, FollowObserver } from "../../host/index.ts";
+import type { FolderEntry } from "./files-index.ts";
+/** A folder's first entries, and whether more follow. */
+export type FolderListing = {
+    readonly entries: FolderEntry[];
+    readonly more: boolean;
+};
+/** How a folder's listing is read: the current `Files` attempt's index. */
+export type ListingReader = (space: string, folder: string, context: Context) => Promise<FolderListing>;
+/** The watched folders of one host's `Files`. */
+export declare class FolderViews {
+    #private;
+    /** Reads through `reader` from now on (each `Files` attempt binds its own). */
+    bind(reader: ListingReader): void;
+    /** Watches folder `folder` of `space` for `observer`: its listing now, and its detach. */
+    attach(space: string, folder: string, observer: FollowObserver<unknown>, context: Context): Promise<FollowAttachment<FolderListing>>;
+    /** Space `space` changed: every watched folder of it is read again (once per folder) and its watchers told. */
+    changed(space: string, context: Context): Promise<void>;
+}
+//# sourceMappingURL=folder-views.d.ts.map

package/dist/node/app/folder-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-views.d.ts","sourceRoot":"","sources":["../../../src/node/app/folder-views.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAExF,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAWxG,iDAAiD;AACjD,qBAAa,WAAW;;IAIvB,+EAA+E;IAC/E,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEhC;IAED,0FAA0F;IACpF,MAAM,CACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,EACjC,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAe1C;IAED,+GAA+G;IACzG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAc5D;CAMD"}

package/dist/node/app/folder-views.js

@@ -0,0 +1,55 @@
+// Live folder listings (Files v2): what a `FilesFolder` object shows, the first entries of one folder, followed
+// (`self.follow`) from the host's `Files`. Files reads a watched folder again after each change of its space, inside
+// the method that changed it, and hands the listing to its watchers; a listing attaching meanwhile reads again. One
+// read per watched folder and change: meant for the folders on someone's screen, not for every folder of a drive.
+/** The watched folders of one host's `Files`. */
+export class FolderViews {
+    #reader;
+    #views = new Set();
+    /** Reads through `reader` from now on (each `Files` attempt binds its own). */
+    bind(reader) {
+        this.#reader = reader;
+    }
+    /** Watches folder `folder` of `space` for `observer`: its listing now, and its detach. */
+    async attach(space, folder, observer, context) {
+        const view = { space, folder, observer, attaching: true, stale: false };
+        this.#views.add(view);
+        try {
+            let value;
+            do {
+                view.stale = false;
+                value = await this.#read(space, folder, context);
+            } while (view.stale);
+            view.attaching = false;
+            return { value, detach: () => this.#views.delete(view) };
+        }
+        catch (error) {
+            this.#views.delete(view);
+            throw error;
+        }
+    }
+    /** Space `space` changed: every watched folder of it is read again (once per folder) and its watchers told. */
+    async changed(space, context) {
+        const byFolder = new Map();
+        for (const view of this.#views) {
+            if (view.space !== space)
+                continue;
+            if (view.attaching)
+                view.stale = true;
+            else
+                byFolder.set(view.folder, [...(byFolder.get(view.folder) ?? []), view]);
+        }
+        for (const [folder, views] of byFolder) {
+            const value = await this.#read(space, folder, context);
+            for (const view of views) {
+                if (this.#views.has(view))
+                    view.observer.advance({ kind: "value", value, ops: [["r", value]], retired: false }, context);
+            }
+        }
+    }
+    /** The listing through the bound reader (bound before any `FilesFolder` goes live: it waits for `Files`). */
+    #read(space, folder, context) {
+        return this.#reader(space, folder, context);
+    }
+}
+//# sourceMappingURL=folder-views.js.map

package/dist/node/app/folder-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-views.js","sourceRoot":"","sources":["../../../src/node/app/folder-views.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,qHAAqH;AACrH,oHAAoH;AACpH,kHAAkH;AAqBlH,iDAAiD;AACjD,MAAM,OAAO,WAAW;IACvB,OAAO,CAA4B;IAC1B,MAAM,GAAG,IAAI,GAAG,EAAQ,CAAC;IAElC,+EAA+E;IAC/E,IAAI,CAAC,MAAqB;QACzB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,MAAM,CACX,KAAa,EACb,MAAc,EACd,QAAiC,EACjC,OAAgB;QAEhB,MAAM,IAAI,GAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC;YACJ,IAAI,KAAoB,CAAC;YACzB,GAAG,CAAC;gBACH,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;gBACnB,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE;YACrB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAED,+GAA+G;IAC/G,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAgB;QAC5C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;gBAAE,SAAS;YACnC,IAAI,IAAI,CAAC,SAAS;gBAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;;gBACjC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9E,CAAC;QACD,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;oBACxB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YAChG,CAAC;QACF,CAAC;IACF,CAAC;IAED,6GAA6G;IAC7G,KAAK,CAAC,KAAa,EAAE,MAAc,EAAE,OAAgB;QACpD,OAAO,IAAI,CAAC,OAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;CACD","sourcesContent":["// Live folder listings (Files v2): what a `FilesFolder` object shows, the first entries of one folder, followed\n// (`self.follow`) from the host's `Files`. Files reads a watched folder again after each change of its space, inside\n// the method that changed it, and hands the listing to its watchers; a listing attaching meanwhile reads again. One\n// read per watched folder and change: meant for the folders on someone's screen, not for every folder of a drive.\n\nimport type { Context } from \"../../context/index.ts\";\nimport type { FollowAttachment, FollowObserver } from \"../../host/index.ts\";\nimport type { FolderEntry } from \"./files-index.ts\";\n\n/** A folder's first entries, and whether more follow. */\nexport type FolderListing = { readonly entries: FolderEntry[]; readonly more: boolean };\n\n/** How a folder's listing is read: the current `Files` attempt's index. */\nexport type ListingReader = (space: string, folder: string, context: Context) => Promise<FolderListing>;\n\n/** A watched folder: its observer, and whether it is still attaching (then a change makes it read again). */\ntype View = {\n\treadonly space: string;\n\treadonly folder: string;\n\treadonly observer: FollowObserver<unknown>;\n\tattaching: boolean;\n\tstale: boolean;\n};\n\n/** The watched folders of one host's `Files`. */\nexport class FolderViews {\n\t#reader: ListingReader | undefined;\n\treadonly #views = new Set<View>();\n\n\t/** Reads through `reader` from now on (each `Files` attempt binds its own). */\n\tbind(reader: ListingReader): void {\n\t\tthis.#reader = reader;\n\t}\n\n\t/** Watches folder `folder` of `space` for `observer`: its listing now, and its detach. */\n\tasync attach(\n\t\tspace: string,\n\t\tfolder: string,\n\t\tobserver: FollowObserver<unknown>,\n\t\tcontext: Context,\n\t): Promise<FollowAttachment<FolderListing>> {\n\t\tconst view: View = { space, folder, observer, attaching: true, stale: false };\n\t\tthis.#views.add(view);\n\t\ttry {\n\t\t\tlet value: FolderListing;\n\t\t\tdo {\n\t\t\t\tview.stale = false;\n\t\t\t\tvalue = await this.#read(space, folder, context);\n\t\t\t} while (view.stale);\n\t\t\tview.attaching = false;\n\t\t\treturn { value, detach: () => this.#views.delete(view) };\n\t\t} catch (error) {\n\t\t\tthis.#views.delete(view);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\t/** Space `space` changed: every watched folder of it is read again (once per folder) and its watchers told. */\n\tasync changed(space: string, context: Context): Promise<void> {\n\t\tconst byFolder = new Map<string, View[]>();\n\t\tfor (const view of this.#views) {\n\t\t\tif (view.space !== space) continue;\n\t\t\tif (view.attaching) view.stale = true;\n\t\t\telse byFolder.set(view.folder, [...(byFolder.get(view.folder) ?? []), view]);\n\t\t}\n\t\tfor (const [folder, views] of byFolder) {\n\t\t\tconst value = await this.#read(space, folder, context);\n\t\t\tfor (const view of views) {\n\t\t\t\tif (this.#views.has(view))\n\t\t\t\t\tview.observer.advance({ kind: \"value\", value, ops: [[\"r\", value]], retired: false }, context);\n\t\t\t}\n\t\t}\n\t}\n\n\t/** The listing through the bound reader (bound before any `FilesFolder` goes live: it waits for `Files`). */\n\t#read(space: string, folder: string, context: Context): Promise<FolderListing> {\n\t\treturn this.#reader!(space, folder, context);\n\t}\n}\n"]}

package/dist/node/app/index.d.ts

@@ -0,0 +1,12 @@
+export { type App, type AppApi, type AppError, type AppKind, type AppOptions, type AppPlugins, type AppTimeouts, type AppWorkerKind, Server, startServer, } from "./app.ts";
+export { ARCHIVE_FORMAT, type ArchiveManifest } from "./archive.ts";
+export { type EphemeralUser, ephemeralLoginFacet } from "./ephemeral.ts";
+export { type FileInfo, Files, type FilesCaps, FilesFolder, type FileWrite, type FolderEntry, type FolderInfo, type FolderListing, filesFacet, type SpaceSummary, } from "./files.ts";
+export { copyFiles } from "./files-copy.ts";
+export { AppInfo, WorkerInfo } from "./info.ts";
+export { inviteFacet } from "./invite.ts";
+export { privateDirectory, privateStore } from "./layout.ts";
+export { SESSION_COOKIE, type SessionInfo, type SessionKind, Sessions } from "./sessions.ts";
+export { defineUsers } from "./users.ts";
+export { startWorker, type WorkerOptions } from "./worker.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/app/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,KAAK,GAAG,EACR,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,MAAM,EACN,WAAW,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,KAAK,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACN,KAAK,QAAQ,EACb,KAAK,EACL,KAAK,SAAS,EACd,WAAW,EACX,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,UAAU,EACV,KAAK,YAAY,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/node/app/index.js

@@ -0,0 +1,15 @@
+// Chord v2's app kit (`@earendil-works/chord/app`; slice 13): `startServer` on the server and `startWorker` in a
+// worker's entry, the start-data objects, sessions and the owner's sign-in, device pairing, the files of each host,
+// export and import per address, and the optional plugins (users, invites, ephemeral login).
+export { Server, startServer, } from "./app.js";
+export { ARCHIVE_FORMAT } from "./archive.js";
+export { ephemeralLoginFacet } from "./ephemeral.js";
+export { Files, FilesFolder, filesFacet, } from "./files.js";
+export { copyFiles } from "./files-copy.js";
+export { AppInfo, WorkerInfo } from "./info.js";
+export { inviteFacet } from "./invite.js";
+export { privateDirectory, privateStore } from "./layout.js";
+export { SESSION_COOKIE, Sessions } from "./sessions.js";
+export { defineUsers } from "./users.js";
+export { startWorker } from "./worker.js";
+//# sourceMappingURL=index.js.map

package/dist/node/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/node/app/index.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,oHAAoH;AACpH,6FAA6F;AAE7F,OAAO,EASN,MAAM,EACN,WAAW,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAwB,MAAM,cAAc,CAAC;AACpE,OAAO,EAAsB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAEN,KAAK,EAEL,WAAW,EAKX,UAAU,GAEV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAsC,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC","sourcesContent":["// Chord v2's app kit (`@earendil-works/chord/app`; slice 13): `startServer` on the server and `startWorker` in a\n// worker's entry, the start-data objects, sessions and the owner's sign-in, device pairing, the files of each host,\n// export and import per address, and the optional plugins (users, invites, ephemeral login).\n\nexport {\n\ttype App,\n\ttype AppApi,\n\ttype AppError,\n\ttype AppKind,\n\ttype AppOptions,\n\ttype AppPlugins,\n\ttype AppTimeouts,\n\ttype AppWorkerKind,\n\tServer,\n\tstartServer,\n} from \"./app.ts\";\nexport { ARCHIVE_FORMAT, type ArchiveManifest } from \"./archive.ts\";\nexport { type EphemeralUser, ephemeralLoginFacet } from \"./ephemeral.ts\";\nexport {\n\ttype FileInfo,\n\tFiles,\n\ttype FilesCaps,\n\tFilesFolder,\n\ttype FileWrite,\n\ttype FolderEntry,\n\ttype FolderInfo,\n\ttype FolderListing,\n\tfilesFacet,\n\ttype SpaceSummary,\n} from \"./files.ts\";\nexport { copyFiles } from \"./files-copy.ts\";\nexport { AppInfo, WorkerInfo } from \"./info.ts\";\nexport { inviteFacet } from \"./invite.ts\";\nexport { privateDirectory, privateStore } from \"./layout.ts\";\nexport { SESSION_COOKIE, type SessionInfo, type SessionKind, Sessions } from \"./sessions.ts\";\nexport { defineUsers } from \"./users.ts\";\nexport { startWorker, type WorkerOptions } from \"./worker.ts\";\n"]}