@elaraai/e3-cloud-files 1.0.94 → 1.0.97

package/dist/src/sync/memory.js

@@ -2,7 +2,16 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Licensed under BSL 1.1. See LICENSE for details.
  */
-import { FilesUnreadableError, NO_LEDGER } from './engine.js';
+/**
+ * The sync's ports in memory: a bucket, a workspace's inputs and records,
+ * and a ledger, for unit tests and for the portable suite every
+ * implementation runs.
+ *
+ * @packageDocumentation
+ */
+import { createHash } from 'node:crypto';
+import { decodeBeast2For, none, some, variant } from '@elaraai/east';
+import { FilesUnreadableError, NO_LEDGER, } from './engine.js';
 /** Items as an async iterable, as a store's paged listing gives them. */
 function iterate(items) {
     return {
@@ -14,14 +23,44 @@ function iterate(items) {
         },
     };
 }
+/** The bytes of a stream, whole. */
+async function whole(stream) {
+    const chunks = [];
+    let length = 0;
+    for await (const chunk of stream) {
+        chunks.push(chunk);
+        length += chunk.length;
+    }
+    const bytes = new Uint8Array(length);
+    let at = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, at);
+        at += chunk.length;
+    }
+    return bytes;
+}
+/** A value's SHA-256, hex. */
+function sha256Of(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+/** How many rows a collection holds; null for a value that is none. */
+function rowsOf(value) {
+    if (Array.isArray(value))
+        return BigInt(value.length);
+    if (value instanceof Map || value instanceof Set)
+        return BigInt(value.size);
+    return null;
+}
 /** A bucket in memory: files by key, each with its time and an ETag that changes with its bytes. */
 export class MemoryBucket {
     #files = new Map();
     /** Why each file a reader may not read is refused, by key */
     #refused = new Map();
     #version = 0;
-    /** How many times a file's bytes were read, for tests that hold a sync to reading only what changed */
+    /** How many times a file's bytes were read whole or streamed, for tests that hold a sync to reading only what changed */
     reads = 0;
+    /** How many ranges of files' bytes were read, for tests that hold a typed sync to reading a header first */
+    rangeReads = 0;
     /** How many listings were asked for, for tests that hold a sync to listing a prefix once */
     listings = 0;
     /**
@@ -36,10 +75,35 @@ export class MemoryBucket {
         this.#version += 1;
         this.#files.set(key, { bytes: data, modified, etag: `"${this.#version}-${data.length}"` });
     }
+    /**
+     * Writes a file's bytes again under a new ETag, as a multipart upload of
+     * the same bytes leaves it.
+     *
+     * @param key - Its key
+     */
+    touch(key) {
+        const file = this.#files.get(key);
+        if (file === undefined)
+            return;
+        this.#version += 1;
+        this.#files.set(key, { ...file, etag: `"${this.#version}-${file.bytes.length}-again"` });
+    }
     /** Deletes a file. */
     delete(key) {
         this.#files.delete(key);
     }
+    /** A file's bytes, for a test; undefined when there is none. */
+    get(key) {
+        return this.#files.get(key)?.bytes;
+    }
+    /** A file's ETag, as a listing gives it; undefined when there is none. */
+    etagOf(key) {
+        return this.#files.get(key)?.etag;
+    }
+    /** Every key, in order. */
+    keys() {
+        return [...this.#files.keys()].sort();
+    }
     /**
      * Makes a file unreadable, as an archived file, or one encrypted with a key
      * the reader may not use, is: listed, but refused when read.
@@ -64,8 +128,20 @@ export class MemoryBucket {
         const files = this.#files;
         const refused = this.#refused;
         const counted = () => { this.reads += 1; };
+        const ranged = () => { this.rangeReads += 1; };
         const listedOnce = () => { this.listings += 1; };
         const listed = (key, file) => ({ key: key.slice(prefix.length), size: file.bytes.length, modified: file.modified, etag: file.etag });
+        const readable = (object) => {
+            const file = files.get(prefix + object.key);
+            if (file === undefined)
+                throw new FilesUnreadableError(object.key, 'went while the sync read it');
+            if (file.etag !== object.etag)
+                throw new FilesUnreadableError(object.key, 'changed since it was listed: the next sync takes it');
+            const reason = refused.get(prefix + object.key);
+            if (reason !== undefined)
+                throw new FilesUnreadableError(object.key, reason);
+            return file;
+        };
         return {
             list(under, options = {}) {
                 listedOnce();
@@ -79,30 +155,64 @@ export class MemoryBucket {
                 return Promise.resolve(file === undefined ? null : listed(prefix + key, file));
             },
             read(object) {
-                const file = files.get(prefix + object.key);
-                if (file === undefined)
-                    return Promise.reject(new FilesUnreadableError(object.key, 'went while the sync read it'));
-                if (file.etag !== object.etag)
-                    return Promise.reject(new FilesUnreadableError(object.key, 'changed since it was listed: the next sync takes it'));
-                const reason = refused.get(prefix + object.key);
-                if (reason !== undefined)
-                    return Promise.reject(new FilesUnreadableError(object.key, reason));
-                counted();
-                return Promise.resolve(file.bytes);
+                try {
+                    const file = readable(object);
+                    counted();
+                    return Promise.resolve(file.bytes);
+                }
+                catch (err) {
+                    return Promise.reject(err);
+                }
+            },
+            readRange(object, start, end) {
+                try {
+                    const file = readable(object);
+                    ranged();
+                    return Promise.resolve(file.bytes.subarray(start, end));
+                }
+                catch (err) {
+                    return Promise.reject(err);
+                }
+            },
+            open(object, options = {}) {
+                try {
+                    const file = readable(object);
+                    counted();
+                    // A stream of chunks, as a bucket's body comes, from the byte asked
+                    const chunks = [];
+                    for (let at = options.start ?? 0; at < file.bytes.length; at += 1024)
+                        chunks.push(file.bytes.subarray(at, Math.min(at + 1024, file.bytes.length)));
+                    return Promise.resolve(iterate(chunks));
+                }
+                catch (err) {
+                    return Promise.reject(err);
+                }
             },
         };
     }
 }
-/** A workspace's inputs in memory: what a sync wrote to each, and a hash of each value. */
+/** A workspace's inputs and records in memory: what a sync wrote to each, and a hash of each value. */
 export class MemoryWorkspace {
-    /** Each `file` or `latest` input's bytes */
+    /** Each untyped `file` or `latest` input's bytes */
     files = new Map();
+    /** Each typed input's value, decoded */
+    typed = new Map();
     /** Each `folder` input's entries */
     folders = new Map();
     /** Each `listing` input's rows */
     listings = new Map();
     /** How many times each input was written */
     writes = new Map();
+    /** Each record declared, by name: pending until seeded */
+    records = new Map();
+    /** Mutations that refuse every feed, by `record.mutation`, with what they answer */
+    refusing = new Map();
+    /** Mutations whose record is busy, by `record.mutation`: a feed waits, with the reason */
+    waiting = new Map();
+    /** Whether the next typed intake stops before it finishes, as a round's deadline stops one */
+    yieldNextIntake = false;
+    /** Each typed intake's SHA-256 and the hash it gave, so the same bytes give the same hash */
+    #memo = new Map();
     #values = new Map();
     #version = 0;
     /** Records a write, and answers the value's hash: a new one each time. */
@@ -116,10 +226,38 @@ export class MemoryWorkspace {
     /** Empties an input, as a deploy that resets the workspace's inputs does. */
     reset(input) {
         this.files.delete(input);
+        this.typed.delete(input);
         this.folders.delete(input);
         this.listings.delete(input);
         this.#values.delete(input);
     }
+    /**
+     * Declares a record with no state, pending until seeded, or with a state
+     * the package gave it (one commit, `$init`).
+     *
+     * @param name - The record
+     * @param state - Its initial state, if the package declares one
+     */
+    declareRecord(name, state) {
+        this.records.set(name, state === undefined ? { commits: [] } : { commits: [{ name: '$init', id: `${name}#1`, sha256: null }], state });
+    }
+    /**
+     * Mutates a record, as an app's user does: a commit by a mutation's name,
+     * its state replaced.
+     *
+     * @param record - The record
+     * @param mutation - The mutation's name
+     * @param state - The state after it
+     */
+    mutate(record, mutation, state) {
+        const kept = this.records.get(record);
+        if (kept === undefined || kept.commits.length === 0)
+            throw new Error(`record ${record} has no state yet`);
+        const id = `${record}#${kept.commits.length + 1}`;
+        kept.commits.push({ name: mutation, id, sha256: null });
+        kept.state = state;
+        return id;
+    }
     current(input) {
         return Promise.resolve(this.#values.get(input) ?? null);
     }
@@ -140,15 +278,107 @@ export class MemoryWorkspace {
         this.listings.set(input, new Map(rows));
         return Promise.resolve(this.#wrote(input));
     }
+    /** A typed file's bytes, read through the reader's stream, decoded as the type. */
+    async #decoded(file, type, source) {
+        let bytes;
+        try {
+            bytes = await whole(await source.open(file));
+        }
+        catch (err) {
+            if (err instanceof FilesUnreadableError)
+                return { reason: variant('unreadable', err.reason) };
+            throw err;
+        }
+        try {
+            return { bytes, sha256: sha256Of(bytes), value: decodeBeast2For(type)(bytes) };
+        }
+        catch (err) {
+            return { reason: variant('not_beast2', err instanceof Error ? err.message : String(err)) };
+        }
+    }
+    async takeTyped(input, file, type, source, options) {
+        const decoded = await this.#decoded(file, type, source);
+        if ('reason' in decoded)
+            return { status: 'refused', reason: decoded.reason };
+        const { sha256, value } = decoded;
+        if (this.yieldNextIntake && options.resume === undefined) {
+            this.yieldNextIntake = false;
+            return { status: 'yielded', taking: { key: file.key, etag: file.etag, sha256, staging: null } };
+        }
+        // The same bytes give the same value: the store's memo
+        let hash = this.#memo.get(`${input}\u0000${sha256}`);
+        if (hash === undefined) {
+            hash = this.#wrote(input);
+            this.#memo.set(`${input}\u0000${sha256}`, hash);
+        }
+        else {
+            this.#values.set(input, hash);
+        }
+        this.typed.set(input, value);
+        const rows = rowsOf(value);
+        return { status: 'taken', hash, sha256, taken: { key: file.key, type, rows: rows === null ? none : some(rows), how: variant('carried', null) } };
+    }
+    recordState(record) {
+        const kept = this.records.get(record);
+        if (kept === undefined)
+            return Promise.reject(new Error(`record ${record} is not declared`));
+        if (kept.commits.length === 0)
+            return Promise.resolve({ pending: true });
+        const head = kept.commits[kept.commits.length - 1];
+        let sinceSeed = null;
+        for (let i = kept.commits.length - 1; i >= 0; i--) {
+            const name = kept.commits[i].name;
+            if (name === '$init' || name === '$seed') {
+                sinceSeed = kept.commits.length - 1 - i;
+                break;
+            }
+        }
+        return Promise.resolve({ pending: false, head: head.id, sinceSeed });
+    }
+    async seed(record, file, type, source, options) {
+        const kept = this.records.get(record);
+        if (kept === undefined)
+            throw new Error(`record ${record} is not declared`);
+        const decoded = await this.#decoded(file, type, source);
+        if ('reason' in decoded)
+            return { status: 'refused', reason: decoded.reason };
+        const id = `${record}#${kept.commits.length + 1}`;
+        kept.commits.push({ name: options.genesis ? '$init' : '$seed', id, sha256: decoded.sha256 });
+        kept.state = decoded.value;
+        return { status: 'committed', commit: id, rows: rowsOf(decoded.value), sha256: decoded.sha256 };
+    }
+    async feed(record, mutation, file, type, source, options) {
+        const kept = this.records.get(record);
+        if (kept === undefined)
+            throw new Error(`record ${record} is not declared`);
+        if (kept.commits.length === 0)
+            return { status: 'waiting', reason: 'the record has no state yet' };
+        const decoded = await this.#decoded(file, type, source);
+        if ('reason' in decoded)
+            return { status: 'refused', reason: decoded.reason, sha256: '' };
+        // Once per delivery: bytes applied before, under any name, are applied no more
+        if (options.applied?.has(decoded.sha256) === true)
+            return { status: 'applied', sha256: decoded.sha256 };
+        const busy = this.waiting.get(`${record}.${mutation}`);
+        if (busy !== undefined)
+            return { status: 'waiting', reason: busy };
+        const refused = this.refusing.get(`${record}.${mutation}`);
+        if (refused !== undefined)
+            return { status: 'refused', reason: variant('mutation', refused), sha256: decoded.sha256 };
+        const id = `${record}#${kept.commits.length + 1}`;
+        kept.commits.push({ name: mutation, id, sha256: decoded.sha256 });
+        kept.state = decoded.value;
+        return { status: 'committed', commit: id, sha256: decoded.sha256 };
+    }
 }
 /** A ledger in memory. */
 export class MemoryLedger {
     #states = new Map();
-    read(input) {
-        return Promise.resolve(this.#states.get(input) ?? NO_LEDGER);
+    read(key) {
+        return Promise.resolve(this.#states.get(key) ?? NO_LEDGER);
     }
-    write(input, state) {
-        this.#states.set(input, { entries: new Map(state.entries), value: state.value, under: state.under });
+    write(key, state) {
+        this.#states.set(key, { ...state, entries: new Map(state.entries) });
         return Promise.resolve();
     }
 }

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type FilesBinding, type FilesManifest, type FilesPushFile, type FilesPushRefusal, type FilesTarget } from '@elaraai/e3-cloud-types';
+import type { FilesObject, LedgerState } from './engine.js';
+/** What a push's plan is given. */
+export interface PushPlanInput {
+    /** The declarations */
+    readonly manifest: FilesManifest;
+    /** Where each source's files are */
+    readonly bindings: readonly FilesBinding[];
+    /** The files offered: a file's own name, or its path relative to the directory it came from, with that directory's name */
+    readonly files: readonly FilesPushFile[];
+    /** The target every file is for, as `--as` names it; null to match each by its name */
+    readonly as: string | null;
+    /** What a target took last */
+    readonly ledger: (target: FilesTarget) => Promise<LedgerState>;
+    /**
+     * The greatest key a `latest` mapping's prefix holds that its glob
+     * matches, through the binding's reader; null for none. Absent, a
+     * `latest` file is not held to being the greatest.
+     */
+    readonly listGreatest?: (binding: FilesBinding, prefix: string, include: string | null) => Promise<FilesObject | null>;
+    /** A key's file in the source, for the unchanged check; absent, a file the ledger holds is unchanged by its hash alone */
+    readonly stat?: (binding: FilesBinding, key: string) => Promise<FilesObject | null>;
+}
+/** What a push does with one file, before its upload is added: its target, source and key, or why not. */
+export type PushPlanOutcome = {
+    readonly kind: 'put';
+    readonly target: FilesTarget;
+    readonly source: string;
+    readonly key: string;
+    readonly binding: FilesBinding;
+} | {
+    readonly kind: 'unchanged';
+    readonly target: FilesTarget;
+    readonly source: string;
+    readonly key: string;
+} | {
+    readonly kind: 'refused';
+    readonly refusal: FilesPushRefusal;
+};
+/** A file's planned outcome. */
+export interface PushPlannedFile {
+    readonly file: FilesPushFile;
+    readonly outcome: PushPlanOutcome;
+}
+/**
+ * Plans a push: see the module's documentation.
+ *
+ * @param input - The declarations, the bindings, the files, the target named, and the readers
+ * @returns Each file's outcome, in the files' order
+ */
+export declare function planPush(input: PushPlanInput): Promise<PushPlannedFile[]>;
+//# sourceMappingURL=push.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/sync/push.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,OAAO,EAGL,KAAK,YAAY,EAAE,KAAK,aAAa,EAAqB,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EACtH,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,2HAA2H;IAC3H,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACvH,0HAA0H;IAC1H,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACrF;AAED,0GAA0G;AAC1G,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GACrI;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3G;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAErE,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAqDD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAwG/E"}

package/dist/src/sync/push.js

@@ -0,0 +1,205 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * A push's plan: files from disk matched to the mappings that
+ * take them, checked, and each answered put (at a key of the mapping's),
+ * unchanged (the source holds those bytes already) or refused. Pure: the
+ * route and the local CLI share it, each giving it the declarations, the
+ * bindings, the ledgers and a listing of a `latest` prefix through its own
+ * reader. The plan writes nothing; how a put is uploaded (a signed URL, or
+ * the client's own credentials) is the caller's to add.
+ *
+ * Each target's ledger and each `latest` prefix's listing are read once a
+ * plan, however many files it offers.
+ *
+ * Matching, in order:
+ * 1. `as` names one target for every file (`orders`, `record:customers`,
+ *    `mutation:prices.load_prices`; a bare name is an input's): a file goes
+ *    to a `file` or `latest` mapping, a directory's files to a `folder`.
+ * 2. Else a file matches the one `file` mapping whose key's last segment is
+ *    its name (an exact match, which comes first), or the one `latest`
+ *    mapping under whose prefix it lands at its own name, its `include`
+ *    matched; a directory's files match the one `folder` mapping, each at
+ *    its relative path. Several candidates are `ambiguous`, none
+ *    `no_mapping`; a file the mapping's `include` glob leaves out is
+ *    `not_included`, since no sync would take it.
+ * 3. A typed mapping holds the file's header type to its own.
+ * 4. The mapping's limit holds the file's size.
+ * 5. A `latest` mapping refuses a file a greater key than its own would
+ *    shadow.
+ * 6. A file whose bytes the ledger holds for its key, the key still carrying
+ *    the ledger's ETag, is `unchanged`.
+ *
+ * @packageDocumentation
+ */
+import { isTypeValueEqual, variant } from '@elaraai/east';
+import { FILES_FILE_MAX_BYTES, FILES_FOLDER_ENTRY_MAX_BYTES, FILES_TYPED_VALUE_MAX_BYTES, filesTargetText, parseFilesTarget, sameFilesTarget, } from '@elaraai/e3-cloud-types';
+import { globMatcher } from '../paths.js';
+/** The last segment of a key. */
+function lastSegment(key) {
+    return key.slice(key.lastIndexOf('/') + 1);
+}
+/** Whether a type is a collection's: an Array, Set or Dict root, which beast2 stores in segments of any number. */
+function isCollection(type) {
+    return type.type === 'Array' || type.type === 'Set' || type.type === 'Dict';
+}
+/** The type a `file` or `latest` shape names; null for none. */
+function namedType(mapping) {
+    const { shape } = mapping;
+    if (shape.type !== 'file' && shape.type !== 'latest')
+        return null;
+    return shape.value.type.type === 'some' ? shape.value.type.value : null;
+}
+/**
+ * The mappings a file of a name matches by its name: the `file` mappings
+ * whose key's last segment is the name, which are the exact matches; else
+ * the `latest` mappings whose glob matches it.
+ */
+function byName(manifest, name) {
+    const exact = manifest.mappings.filter((m) => m.shape.type === 'file' && lastSegment(m.shape.value.key) === name);
+    if (exact.length > 0)
+        return exact;
+    return manifest.mappings.filter((m) => m.shape.type === 'latest' && globMatcher(m.shape.value.include.type === 'some' ? m.shape.value.include.value : null)(name));
+}
+/** The key a file lands at under a mapping. */
+function keyUnder(mapping, file) {
+    const { shape } = mapping;
+    switch (shape.type) {
+        case 'file': return shape.value.key;
+        case 'latest':
+        case 'folder':
+        case 'listing':
+            return `${shape.value.prefix}${file.name}`;
+    }
+}
+/** The largest file a mapping takes, from the file's own type; null for a typed collection, which has no limit but its segments'. */
+function limitOf(mapping, fileType) {
+    const { shape, target } = mapping;
+    if (shape.type === 'folder')
+        return FILES_FOLDER_ENTRY_MAX_BYTES;
+    if (shape.type === 'listing')
+        return 0;
+    const type = namedType(mapping);
+    if (type === null)
+        return FILES_FILE_MAX_BYTES;
+    if (target.type === 'mutation')
+        return FILES_TYPED_VALUE_MAX_BYTES;
+    return fileType !== null && isCollection(fileType) ? null : FILES_TYPED_VALUE_MAX_BYTES;
+}
+/**
+ * Plans a push: see the module's documentation.
+ *
+ * @param input - The declarations, the bindings, the files, the target named, and the readers
+ * @returns Each file's outcome, in the files' order
+ */
+export async function planPush(input) {
+    const { manifest, bindings, files } = input;
+    const named = input.as === null ? null : parseFilesTarget(input.as);
+    const namedMapping = named === null ? null : manifest.mappings.find((m) => sameFilesTarget(m.target, named)) ?? null;
+    const bindingOf = (source) => bindings.find((b) => b.source === source);
+    // Each ledger and each listing read once a plan
+    const ledgers = new Map();
+    const ledgerOf = (target) => {
+        const text = filesTargetText(target);
+        let read = ledgers.get(text);
+        if (read === undefined)
+            ledgers.set(text, read = input.ledger(target));
+        return read;
+    };
+    const greatests = new Map();
+    const greatestOf = (binding, prefix, include) => {
+        const text = `${binding.source}\u0000${prefix}\u0000${include ?? ''}`;
+        let listed = greatests.get(text);
+        if (listed === undefined)
+            greatests.set(text, listed = input.listGreatest(binding, prefix, include));
+        return listed;
+    };
+    const planned = [];
+    for (const file of files) {
+        const refused = (refusal) => ({ file, outcome: { kind: 'refused', refusal } });
+        const fromDirectory = file.directory.type === 'some';
+        // 1, 2: the mapping
+        let mapping;
+        if (input.as !== null) {
+            if (namedMapping === null) {
+                planned.push(refused(variant('unknown_target', input.as)));
+                continue;
+            }
+            mapping = namedMapping;
+        }
+        else {
+            const candidates = fromDirectory
+                ? manifest.mappings.filter((m) => m.shape.type === 'folder')
+                : byName(manifest, file.name);
+            if (candidates.length === 0) {
+                planned.push(refused(variant('no_mapping', null)));
+                continue;
+            }
+            if (candidates.length > 1) {
+                planned.push(refused(variant('ambiguous', candidates.map((m) => m.target))));
+                continue;
+            }
+            mapping = candidates[0];
+        }
+        const { target, shape } = mapping;
+        const takesOne = shape.type === 'file' || shape.type === 'latest';
+        if (fromDirectory ? takesOne || shape.type === 'listing' : !takesOne) {
+            planned.push(refused(variant('shape_mismatch', { target, directory: fromDirectory })));
+            continue;
+        }
+        // A file the mapping's glob leaves out is put where no sync takes it
+        if ((shape.type === 'latest' || shape.type === 'folder') && shape.value.include.type === 'some' && !globMatcher(shape.value.include.value)(file.name)) {
+            planned.push(refused(variant('not_included', { target, include: shape.value.include.value })));
+            continue;
+        }
+        // 3: the type
+        const expected = namedType(mapping);
+        const actual = file.type.type === 'some' ? file.type.value : null;
+        if (expected !== null) {
+            if (actual === null) {
+                planned.push(refused(variant('not_beast2', { target, expected })));
+                continue;
+            }
+            if (!isTypeValueEqual(actual, expected)) {
+                planned.push(refused(variant('type_mismatch', { target, expected, actual })));
+                continue;
+            }
+        }
+        // 4: the size
+        const limit = limitOf(mapping, actual);
+        if (limit !== null && Number(file.size) > limit) {
+            planned.push(refused(variant('too_large', { target, size: file.size, limit: BigInt(limit) })));
+            continue;
+        }
+        const binding = bindingOf(mapping.source);
+        if (binding === undefined) {
+            // Held off by the caller: a push to an unbound source has nowhere to go
+            planned.push(refused(variant('unknown_target', `${filesTargetText(target)} (its source ${mapping.source} is not bound)`)));
+            continue;
+        }
+        const key = keyUnder(mapping, file);
+        // 5: the greatest key under a latest prefix
+        if (shape.type === 'latest' && input.listGreatest !== undefined) {
+            const greatest = await greatestOf(binding, shape.value.prefix, shape.value.include.type === 'some' ? shape.value.include.value : null);
+            if (greatest !== null && greatest.key > key) {
+                planned.push(refused(variant('not_latest', { target, greatest: greatest.key })));
+                continue;
+            }
+        }
+        // 6: unchanged, by the bytes' hash and the key's ETag
+        const ledger = await ledgerOf(target);
+        const held = ledger.entries.get(key);
+        if (held?.sha256 === file.sha256) {
+            const there = input.stat === undefined ? null : await input.stat(binding, key);
+            if (input.stat === undefined || (there !== null && there.etag === held.etag)) {
+                planned.push({ file, outcome: { kind: 'unchanged', target, source: mapping.source, key } });
+                continue;
+            }
+        }
+        planned.push({ file, outcome: { kind: 'put', target, source: mapping.source, key, binding } });
+    }
+    return planned;
+}
+//# sourceMappingURL=push.js.map