@elaraai/e3-cloud-files 0.0.0-stage → 1.0.91-alpha.0

package/dist/src/storage/index.js

@@ -0,0 +1,117 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * `@elaraai/e3-cloud-files/storage`: the sync's writer over an e3 store, the
+ * one a local repository and a deployed workspace both write through.
+ *
+ * A `file`, `latest` or `listing` input is written as any input is
+ * (`workspaceSetDataset`). A `folder` is updated a piece at a time: e3 stores
+ * a collection as pieces, each holding the entries between two keys, so only
+ * the pieces holding a changed or removed file are read and cut again, and
+ * every other piece is carried over as it is stored (`storeCollection`), never
+ * read. However large the folder, a sync holds the pieces it changes and the
+ * files it read. The new folder is then taken in as the input's value by e3's
+ * own door (`datasetAdoptKnown`), which checks its type, holds the dataset's
+ * write lock and versions it as any input write.
+ *
+ * Needs `@elaraai/e3-core`, which a solution's own code never imports: the
+ * CLI and the platform do.
+ *
+ * @packageDocumentation
+ */
+import { StringType, compareFor, decodeBeast2For, variant } from '@elaraai/east';
+import { DatasetSegments, datasetAdoptKnown, storeCollection, workspaceGetDatasetHash, workspaceSetDataset, } from '@elaraai/e3-core';
+import { FilesFileType, FilesFolderType, FilesListingType } from '@elaraai/e3-cloud-types';
+/** An input's path: `.inputs.<input>`. */
+function inputPath(input) {
+    return [variant('field', 'inputs'), variant('field', input)];
+}
+const compareKeys = compareFor(StringType);
+const decodeFolder = decodeBeast2For(FilesFolderType);
+/** Entries in a Dict's order. */
+function ordered(entries) {
+    return [...entries].map(([k, v]) => [k, v]).sort(([a], [b]) => compareKeys(a, b));
+}
+/**
+ * The sources a folder's new value is stored from: the pieces no change
+ * touches carried over by reference, and each piece a change touches read,
+ * changed and cut again.
+ */
+async function folderSources(storage, repo, hash, changes) {
+    const pieces = await DatasetSegments.open(storage, repo, hash);
+    if (pieces.counts.length === 0)
+        return [{ elements: ordered(changes.set) }];
+    const touched = new Map();
+    const at = async (path) => {
+        const i = await pieces.segmentFor(path);
+        let change = touched.get(i);
+        if (change === undefined)
+            touched.set(i, change = { set: [], remove: [] });
+        return change;
+    };
+    for (const [path, bytes] of changes.set)
+        (await at(path)).set.push([path, bytes]);
+    for (const path of changes.remove)
+        (await at(path)).remove.push(path);
+    const sources = [];
+    let next = 0;
+    for (const i of [...touched.keys()].sort((a, b) => a - b)) {
+        if (i > next)
+            sources.push({ stored: pieces.hash, from: next, to: i });
+        const entries = new Map(decodeFolder(await pieces.segment(i)));
+        const change = touched.get(i);
+        for (const path of change.remove)
+            entries.delete(path);
+        for (const [path, bytes] of change.set)
+            entries.set(path, bytes);
+        sources.push({ elements: ordered(entries) });
+        next = i + 1;
+    }
+    if (next < pieces.counts.length)
+        sources.push({ stored: pieces.hash, from: next, to: pieces.counts.length });
+    return sources;
+}
+/**
+ * The sync's writer over an e3 store, for one workspace.
+ *
+ * @param storage - The store: a local repository's (`LocalStorage`) or the platform's
+ * @param repo - The repository: a local repository's path, or the platform's repository name
+ * @param ws - The workspace
+ * @returns The writer
+ */
+export function storageWriter(storage, repo, ws) {
+    const current = async (input) => (await workspaceGetDatasetHash(storage, repo, ws, inputPath(input))).hash;
+    const written = async (input) => {
+        const hash = await current(input);
+        if (hash === null)
+            throw new Error(`input ${input} is unassigned after it was written`);
+        return hash;
+    };
+    return {
+        current,
+        async setFile(input, bytes) {
+            await workspaceSetDataset(storage, repo, ws, inputPath(input), bytes, FilesFileType);
+            return written(input);
+        },
+        async setListing(input, rows) {
+            const value = new Map([...rows].sort(([a], [b]) => compareKeys(a, b)));
+            await workspaceSetDataset(storage, repo, ws, inputPath(input), value, FilesListingType);
+            return written(input);
+        },
+        async updateFolder(input, changes) {
+            const hash = changes.fresh ? null : await current(input);
+            const sources = hash === null ? [{ elements: ordered(changes.set) }] : await folderSources(storage, repo, hash, changes);
+            const stored = await storeCollection(storage, repo, FilesFolderType, sources);
+            // The store knows the new folder as the manifest it is, so e3's door
+            // takes it in as the input's value, checked and versioned, reading nothing
+            await storage.refs.adoptionWrite(repo, stored, stored);
+            const adopted = await datasetAdoptKnown(storage, repo, ws, inputPath(input), stored);
+            if (adopted === null)
+                throw new Error(`input ${input} could not take the folder ${stored}`);
+            return adopted.hash;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/storage/index.js.map

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

package/dist/src/sync/engine.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type FilesBinding, type FilesListingRow, type FilesManifest, type FilesProblem, type FilesSyncReport } from '@elaraai/e3-cloud-types';
+/** A file of a source, as a listing gives it. */
+export interface FilesObject {
+    /** Its key, relative to where the workspace binds the source */
+    readonly key: string;
+    /** Its size in bytes */
+    readonly size: number;
+    /** When it was last written */
+    readonly modified: Date;
+    /** Its ETag, which changes whenever its bytes do */
+    readonly etag: string;
+}
+/** Reads one bound source: a bucket, under the prefix the binding names. */
+export interface FilesReader {
+    /** Every file under a prefix (relative to the binding), in key order */
+    list(prefix: string): AsyncIterable<FilesObject>;
+    /** One file's listing, or `null` when there is none */
+    stat(key: string): Promise<FilesObject | null>;
+    /** One file's bytes */
+    read(key: string): Promise<Uint8Array>;
+}
+/** Writes one workspace's inputs. Each write answers the value it set: its hash. */
+export interface FilesWriter {
+    /** The value an input holds now, its hash; `null` while it is unassigned */
+    current(input: string): Promise<string | null>;
+    /** Sets a `file` or `latest` input to a file's bytes */
+    setFile(input: string, bytes: Uint8Array): Promise<string>;
+    /**
+     * Updates a `folder` input: each file in `set` added or replaced, each path
+     * in `remove` taken out, every other entry as it was; or, `fresh`, the
+     * folder made of `set` alone
+     */
+    updateFolder(input: string, changes: FolderChanges): Promise<string>;
+    /** Sets a `listing` input */
+    setListing(input: string, rows: ReadonlyMap<string, FilesListingRow>): Promise<string>;
+}
+/** What a sync changes in a `folder` input. */
+export interface FolderChanges {
+    /** Each file added or replaced, by its path relative to the prefix */
+    readonly set: ReadonlyMap<string, Uint8Array>;
+    /** Each path taken out */
+    readonly remove: ReadonlySet<string>;
+    /** Whether the folder is `set` alone, whatever the input holds now */
+    readonly fresh: boolean;
+}
+/** What an input took of one file. */
+export interface LedgerEntry {
+    readonly etag: string;
+    readonly size: number;
+}
+/** What an input took last: each file, and the value the sync wrote. */
+export interface LedgerState {
+    /** Each file it took, by key */
+    readonly entries: ReadonlyMap<string, LedgerEntry>;
+    /** The value the sync wrote, its hash; `null` before its first sync */
+    readonly value: string | null;
+}
+/** Remembers, for each input, what it took last. */
+export interface FilesLedger {
+    /** What an input took last; nothing before its first sync */
+    read(input: string): Promise<LedgerState>;
+    /** Remembers what an input took */
+    write(input: string, state: LedgerState): Promise<void>;
+}
+/** What a sync is given. */
+export interface SyncOptions {
+    /** The declarations */
+    readonly manifest: FilesManifest;
+    /** Where each source's files are */
+    readonly bindings: readonly FilesBinding[];
+    /** Reads a bound source */
+    readonly reader: (binding: FilesBinding) => FilesReader;
+    /** Writes the workspace's inputs */
+    readonly writer: FilesWriter;
+    /** Remembers what each input took */
+    readonly ledger: FilesLedger;
+    /** List what a sync would take, and take nothing */
+    readonly dryRun?: boolean;
+    /** Only these inputs; every mapping when absent */
+    readonly inputs?: readonly string[];
+    /** The time, for the report */
+    readonly now?: () => Date;
+    /** The most bytes of a folder's files held before they are written: {@link FOLDER_BATCH_BYTES} when absent */
+    readonly batchBytes?: number;
+}
+/** What one round of a sync is given: a sync's options, and when to stop. */
+export interface SyncRoundOptions extends SyncOptions {
+    /**
+     * Asked between inputs and between a folder's batches, once the round has
+     * written something: `true` stops the round there, every input as it was
+     * last written and remembered
+     */
+    readonly shouldYield?: () => boolean;
+}
+/** What a round did, and whether it stopped before the end. */
+export interface FilesSyncRound {
+    /** What it did: each input it reached, with what it took */
+    readonly report: FilesSyncReport;
+    /** Whether it stopped when asked, with inputs or a folder's files left for the next */
+    readonly yielded: boolean;
+}
+/** The most bytes of a folder's files a sync holds before it writes them, when not told: 256 MiB. */
+export declare const FOLDER_BATCH_BYTES: number;
+/** Thrown when a sync cannot start, naming every problem. */
+export declare class FilesSyncError extends Error {
+    readonly problems: readonly FilesProblem[];
+    constructor(problems: readonly FilesProblem[]);
+}
+/**
+ * Brings each mapping's input up to date with its source's files, stopping
+ * when asked between inputs or between a folder's batches: one round of a
+ * sync that hands over, as the platform's do. What it stopped before, the
+ * next round takes.
+ *
+ * @param options - The declarations, the bindings, what reads, writes and remembers, and when to stop
+ * @returns What it did, per input it reached, and whether it stopped before the end
+ * @throws {FilesSyncError} When a mapping's source is not bound, before
+ *   anything is read
+ * @throws {Error} When an input named is not one a declaration fills
+ */
+export declare function syncFilesRound(options: SyncRoundOptions): Promise<FilesSyncRound>;
+/**
+ * Brings each mapping's input up to date with its source's files, to the end.
+ *
+ * @param options - The declarations, the bindings, and what reads, writes and remembers
+ * @returns What it did, per mapping
+ * @throws {FilesSyncError} When a mapping's source is not bound, before
+ *   anything is read
+ * @throws {Error} When an input named is not one a declaration fills
+ */
+export declare function syncFiles(options: SyncOptions): Promise<FilesSyncReport>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/src/sync/engine.d.ts.map

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

package/dist/src/sync/engine.js

@@ -0,0 +1,345 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * The sync: what a source's files fill, brought up to date.
+ *
+ * One algorithm for a local repository and a deployed workspace alike: what
+ * reads a bucket, what writes a workspace's inputs and what remembers the
+ * files each input took are given to it ({@link FilesReader},
+ * {@link FilesWriter}, {@link FilesLedger}), so both behave the same.
+ *
+ * For each mapping: list the source, compare each file with what the input
+ * took last (its ETag and size), read what is new or changed, write the input,
+ * and remember what it took and the value it wrote. A file the same as before
+ * is never read again, so a sync with nothing new reads nothing; an input
+ * whose files are as they were is not written. A file over its shape's limit
+ * is refused, named in the report, and never truncated. An input is
+ * remembered only once it is written, so a sync that stops part way takes the
+ * rest next time.
+ *
+ * A folder's new and changed files are taken in batches of at most 256 MiB
+ * ({@link FOLDER_BATCH_BYTES}): each batch is read, written and remembered
+ * before the next is read, so a sync holds one batch of files, however large
+ * the folder. A sync can stop between inputs and between a folder's batches
+ * when asked ({@link syncFilesRound}, a cloud round handing over), and the
+ * next takes the rest.
+ *
+ * What an input took is trusted only while the input still holds the value
+ * the sync wrote: a deploy that resets the workspace's inputs, or anyone
+ * setting one by hand, leaves it holding another, and the next sync takes all
+ * of its files again.
+ *
+ * @packageDocumentation
+ */
+import { variant } from '@elaraai/east';
+import { FILES_FILE_MAX_BYTES, FILES_FOLDER_ENTRY_MAX_BYTES, filesProblemText, } from '@elaraai/e3-cloud-types';
+import { globMatcher } from '../paths.js';
+/** The most bytes of a folder's files a sync holds before it writes them, when not told: 256 MiB. */
+export const FOLDER_BATCH_BYTES = 256 * 1024 * 1024;
+/** The most files of a folder a sync writes at once. */
+const FOLDER_BATCH_FILES = 4096;
+/** Thrown when a sync cannot start, naming every problem. */
+export class FilesSyncError extends Error {
+    problems;
+    constructor(problems) {
+        super(`The files cannot be synced:\n${problems.map((p) => `  - ${filesProblemText(p)}`).join('\n')}`);
+        this.name = 'FilesSyncError';
+        this.problems = problems;
+    }
+}
+/** Whether a sync should stop here: asked to, once it has written something. */
+function stopping(sync) {
+    if (!sync.yielded && sync.progressed && sync.options.shouldYield?.() === true)
+        sync.yielded = true;
+    return sync.yielded;
+}
+/** A tally of nothing. */
+function emptyTally() {
+    return { added: 0n, changed: 0n, removed: 0n, unchanged: 0n, refused: [], bytes: 0n, updated: false };
+}
+/** A mapping's report, from its tally. */
+function reportOf(mapping, tally) {
+    return { input: mapping.input, ...tally };
+}
+/** A key's path relative to a prefix. */
+function relative(prefix, key) {
+    return key.slice(prefix.length);
+}
+/** Whether two ledger entries name the same bytes. */
+function same(a, b) {
+    return a !== undefined && b !== undefined && a.etag === b.etag && a.size === b.size;
+}
+/** A file's ledger entry. */
+function entryOf(object) {
+    return { etag: object.etag, size: object.size };
+}
+/** A mapping's binding; checked to exist before a sync starts. */
+function bindingOf(mapping, options) {
+    return options.bindings.find((b) => b.source === mapping.source);
+}
+/** A mapping's reader: one per bound source, for the sync. */
+function readerOf(sync, mapping) {
+    let reader = sync.readers.get(mapping.source);
+    if (reader === undefined)
+        sync.readers.set(mapping.source, reader = sync.options.reader(bindingOf(mapping, sync.options)));
+    return reader;
+}
+/** What an input took last, trusted only while it holds the value the sync wrote. */
+async function before(sync, input) {
+    const [state, current] = await Promise.all([sync.options.ledger.read(input), sync.options.writer.current(input)]);
+    if (state.value !== null && state.value === current)
+        return { entries: state.entries, trusted: true, stale: false };
+    return { entries: new Map(), trusted: false, stale: current !== null || state.value !== null };
+}
+/** A folder's files to read, in batches of at most `maxBytes` (a file larger alone in its own). */
+function batched(files, maxBytes) {
+    const batches = [];
+    let batch = [];
+    let bytes = 0;
+    for (const file of files) {
+        if (batch.length > 0 && (bytes + file.size > maxBytes || batch.length >= FOLDER_BATCH_FILES)) {
+            batches.push(batch);
+            batch = [];
+            bytes = 0;
+        }
+        batch.push(file);
+        bytes += file.size;
+    }
+    if (batch.length > 0)
+        batches.push(batch);
+    return batches;
+}
+/** The files a selection holds: under its prefix, matching its glob, keyed by their path relative to the prefix. */
+async function selection(reader, prefix, include) {
+    const matches = globMatcher(include);
+    const files = new Map();
+    for await (const object of reader.list(prefix)) {
+        const path = relative(prefix, object.key);
+        // A key ending with / is a folder's placeholder, not a file
+        if (path === '' || object.key.endsWith('/'))
+            continue;
+        if (matches(path))
+            files.set(path, object);
+    }
+    return files;
+}
+/** Syncs a `file` or `latest` mapping to the one file it selects, or none. */
+async function syncOne(sync, mapping, chosen, missing) {
+    const { options } = sync;
+    const report = emptyTally();
+    if (chosen === null) {
+        report.refused.push(missing);
+        return reportOf(mapping, report);
+    }
+    const prior = await before(sync, mapping.input);
+    if (same(prior.entries.get(chosen.key), entryOf(chosen))) {
+        report.unchanged = 1n;
+        return reportOf(mapping, report);
+    }
+    if (chosen.size > FILES_FILE_MAX_BYTES) {
+        report.refused.push({ key: chosen.key, reason: `is ${chosen.size} bytes, over the ${FILES_FILE_MAX_BYTES} a file input takes` });
+        return reportOf(mapping, report);
+    }
+    if (!prior.trusted && !prior.stale)
+        report.added = 1n;
+    else
+        report.changed = 1n;
+    report.bytes = BigInt(chosen.size);
+    report.updated = true;
+    if (options.dryRun === true)
+        return reportOf(mapping, report);
+    const value = await options.writer.setFile(mapping.input, await readerOf(sync, mapping).read(chosen.key));
+    await options.ledger.write(mapping.input, { entries: new Map([[chosen.key, entryOf(chosen)]]), value });
+    sync.progressed = true;
+    return reportOf(mapping, report);
+}
+/**
+ * Syncs a `folder` mapping: what is new or changed read and written, what is
+ * gone taken out. The files to read are taken in batches, each written and
+ * remembered before the next is read; the round may stop between batches.
+ * What is gone goes with the first batch; an input the sync does not trust is
+ * made again, from the first batch alone, then added to.
+ */
+async function syncFolder(sync, mapping, prefix, files) {
+    const { options } = sync;
+    const report = emptyTally();
+    const prior = await before(sync, mapping.input);
+    const binding = bindingOf(mapping, options);
+    // On a local repository, `latest` keeps only the greatest keys
+    let kept = files;
+    if (binding.latest.type === 'some') {
+        const keys = [...files.keys()].sort();
+        kept = new Map(keys.slice(Math.max(0, keys.length - Number(binding.latest.value))).map((path) => [path, files.get(path)]));
+    }
+    // The plan: what is read, what stays as it is, what goes
+    const toRead = [];
+    const staying = new Set();
+    for (const object of kept.values()) {
+        const previous = prior.entries.get(object.key);
+        if (same(previous, entryOf(object))) {
+            report.unchanged += 1n;
+            staying.add(object.key);
+            continue;
+        }
+        if (object.size > FILES_FOLDER_ENTRY_MAX_BYTES) {
+            report.refused.push({ key: object.key, reason: `is ${object.size} bytes, over the ${FILES_FOLDER_ENTRY_MAX_BYTES} a folder's file may be` });
+            // What the input held of it, if anything, stays
+            if (previous !== undefined)
+                staying.add(object.key);
+            continue;
+        }
+        toRead.push(object);
+    }
+    const reading = new Set(toRead.map((object) => object.key));
+    const gone = [...prior.entries.keys()].filter((key) => !staying.has(key) && !reading.has(key));
+    // An input the sync does not trust is made again from the files alone, even when there are none
+    const fresh = !prior.trusted;
+    if (toRead.length === 0 && gone.length === 0 && !fresh)
+        return reportOf(mapping, report);
+    if (options.dryRun === true) {
+        for (const object of toRead) {
+            if (prior.entries.has(object.key))
+                report.changed += 1n;
+            else
+                report.added += 1n;
+            report.bytes += BigInt(object.size);
+        }
+        report.removed = BigInt(gone.length);
+        report.updated = true;
+        return reportOf(mapping, report);
+    }
+    const reader = readerOf(sync, mapping);
+    const entries = new Map(prior.entries);
+    const batches = batched(toRead, options.batchBytes ?? FOLDER_BATCH_BYTES);
+    let first = true;
+    for (const batch of batches.length === 0 ? [[]] : batches) {
+        if (!first && stopping(sync))
+            break;
+        const set = new Map();
+        for (const object of batch)
+            set.set(relative(prefix, object.key), await reader.read(object.key));
+        const remove = first ? new Set(gone.map((key) => relative(prefix, key))) : new Set();
+        const value = await options.writer.updateFolder(mapping.input, { set, remove, fresh: first && fresh });
+        if (first) {
+            for (const key of gone)
+                entries.delete(key);
+            report.removed = BigInt(gone.length);
+        }
+        for (const object of batch) {
+            if (prior.entries.has(object.key))
+                report.changed += 1n;
+            else
+                report.added += 1n;
+            report.bytes += BigInt(object.size);
+            entries.set(object.key, entryOf(object));
+        }
+        report.updated = true;
+        await options.ledger.write(mapping.input, { entries: new Map(entries), value });
+        sync.progressed = true;
+        first = false;
+    }
+    return reportOf(mapping, report);
+}
+/** Syncs a `listing` mapping: written whole whenever any file is new, changed or gone. */
+async function syncListing(sync, mapping, files) {
+    const { options } = sync;
+    const report = emptyTally();
+    const prior = await before(sync, mapping.input);
+    const after = new Map();
+    const rows = new Map();
+    for (const [path, object] of files) {
+        const previous = prior.entries.get(object.key);
+        if (previous === undefined)
+            report.added += 1n;
+        else if (same(previous, entryOf(object)))
+            report.unchanged += 1n;
+        else
+            report.changed += 1n;
+        after.set(object.key, entryOf(object));
+        rows.set(path, { size: BigInt(object.size), modified: object.modified, etag: object.etag });
+    }
+    for (const key of prior.entries.keys())
+        if (!after.has(key))
+            report.removed += 1n;
+    report.updated = report.added > 0n || report.changed > 0n || report.removed > 0n || !prior.trusted;
+    if (options.dryRun === true || !report.updated)
+        return reportOf(mapping, report);
+    const value = await options.writer.setListing(mapping.input, rows);
+    await options.ledger.write(mapping.input, { entries: after, value });
+    sync.progressed = true;
+    return reportOf(mapping, report);
+}
+/**
+ * Brings each mapping's input up to date with its source's files, stopping
+ * when asked between inputs or between a folder's batches: one round of a
+ * sync that hands over, as the platform's do. What it stopped before, the
+ * next round takes.
+ *
+ * @param options - The declarations, the bindings, what reads, writes and remembers, and when to stop
+ * @returns What it did, per input it reached, and whether it stopped before the end
+ * @throws {FilesSyncError} When a mapping's source is not bound, before
+ *   anything is read
+ * @throws {Error} When an input named is not one a declaration fills
+ */
+export async function syncFilesRound(options) {
+    const now = options.now ?? (() => new Date());
+    const started = now();
+    const declared = new Set(options.manifest.mappings.map((m) => m.input));
+    const unknown = (options.inputs ?? []).filter((input) => !declared.has(input));
+    if (unknown.length > 0) {
+        throw new Error(`No declaration fills ${unknown.map((i) => `'${i}'`).join(', ')}: the inputs files fill are ${[...declared].join(', ') || 'none'}`);
+    }
+    const wanted = options.inputs === undefined ? null : new Set(options.inputs);
+    const mappings = options.manifest.mappings.filter((m) => wanted === null || wanted.has(m.input));
+    const bound = new Set(options.bindings.map((b) => b.source));
+    const problems = [...new Set(mappings.map((m) => m.source))]
+        .filter((source) => !bound.has(source))
+        .map((source) => variant('source_unbound', { source }));
+    if (problems.length > 0)
+        throw new FilesSyncError(problems);
+    const sync = { options, readers: new Map(), progressed: false, yielded: false };
+    const reports = [];
+    for (const mapping of mappings) {
+        if (stopping(sync))
+            break;
+        const reader = readerOf(sync, mapping);
+        const shape = mapping.shape;
+        if (shape.type === 'file') {
+            const missing = { key: shape.value.key, reason: 'no such file' };
+            reports.push(await syncOne(sync, mapping, await reader.stat(shape.value.key), missing));
+            continue;
+        }
+        const { prefix } = shape.value;
+        const files = await selection(reader, prefix, shape.value.include.type === 'some' ? shape.value.include.value : null);
+        switch (shape.type) {
+            case 'latest': {
+                const greatest = [...files.keys()].sort().at(-1);
+                const missing = { key: prefix, reason: 'no file under it matches' };
+                reports.push(await syncOne(sync, mapping, greatest === undefined ? null : files.get(greatest), missing));
+                break;
+            }
+            case 'folder':
+                reports.push(await syncFolder(sync, mapping, prefix, files));
+                break;
+            case 'listing':
+                reports.push(await syncListing(sync, mapping, files));
+                break;
+        }
+    }
+    return { report: { started, finished: now(), dryRun: options.dryRun === true, mappings: reports }, yielded: sync.yielded };
+}
+/**
+ * Brings each mapping's input up to date with its source's files, to the end.
+ *
+ * @param options - The declarations, the bindings, and what reads, writes and remembers
+ * @returns What it did, per mapping
+ * @throws {FilesSyncError} When a mapping's source is not bound, before
+ *   anything is read
+ * @throws {Error} When an input named is not one a declaration fills
+ */
+export async function syncFiles(options) {
+    return (await syncFilesRound(options)).report;
+}
+//# sourceMappingURL=engine.js.map

package/dist/src/sync/engine.js.map

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

package/dist/src/sync/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * `@elaraai/e3-cloud-files/sync`: the sync, with what reads a bucket, writes
+ * a workspace and remembers what each input took given to it, so a local
+ * repository and a deployed workspace sync the same way; and those three in
+ * memory, for tests.
+ *
+ * @packageDocumentation
+ */
+export { syncFiles, syncFilesRound, FilesSyncError, FOLDER_BATCH_BYTES, type SyncOptions, type SyncRoundOptions, type FilesSyncRound, type FilesObject, type FilesReader, type FilesWriter, type FolderChanges, type FilesLedger, type LedgerEntry, type LedgerState, } from './engine.js';
+export { MemoryBucket, MemoryWorkspace, MemoryLedger } from './memory.js';
+//# sourceMappingURL=index.d.ts.map