@elaraai/e3-cloud-files 1.0.94 → 1.1.0

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

@@ -2,7 +2,63 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Licensed under BSL 1.1. See LICENSE for details.
  */
-import { type FilesBinding, type FilesLedgerValue, type FilesListingRow, type FilesManifest, type FilesMapping, type FilesProblem, type FilesSyncReport } from '@elaraai/e3-cloud-types';
+/**
+ * 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 records, and what
+ * remembers the files each target 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 target
+ * took last (its ETag and size), read what is new or changed, write the
+ * target, and remember what it took and the value it wrote or the commit it
+ * made. A file the same as before is never read again, so a sync with
+ * nothing new reads nothing; a target whose files are as they were is not
+ * written. A file over its limit is refused, named in the report, and never
+ * truncated; so is a file its reader cannot read (archived, changed since it
+ * was listed, or closed to the reader's access: {@link FilesUnreadableError}),
+ * the sync going on with the rest, and the next sync trying it again. A
+ * target is remembered only once it is written, so a sync that stops part
+ * way takes the rest next time.
+ *
+ * A `file` or `latest` mapping with a type takes its file in as the beast2
+ * value it holds: the file's header is read first, through a ranged read,
+ * and a file of another type, or no beast2, is refused before any other
+ * byte of it is read; then the writer takes the file in from a stream of its
+ * bytes ({@link FilesWriter.takeTyped}: never held whole, a collection by
+ * pieces), which may outlast a round and resume in the next, the file it was
+ * taking remembered by its key and ETag so no other file is resumed as it.
+ * A record's mapping seeds the record ({@link FilesWriter.seed}: its file is
+ * the record's first state, or its state again while nothing has mutated it
+ * since, or when the sync is asked to reset it); a mutation's feeds it
+ * ({@link FilesWriter.feed}): every new file under its prefix, in key order,
+ * each applied once, by the file's hash, and never again under another name.
+ *
+ * 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 targets, between a folder's batches,
+ * between a feed's files and within a typed intake when asked
+ * ({@link syncFilesRound}, a cloud round handing over), and the next takes
+ * the rest.
+ *
+ * What a target took is trusted only while its mapping and its source's
+ * binding are those it was taken under ({@link LedgerState}'s `under`) and,
+ * for an input, while the input still holds the value the sync wrote: a
+ * deploy that resets the workspace's inputs, anyone setting one by hand, a
+ * changed declaration or a source bound elsewhere, and the next sync takes
+ * all of its files again, even when a sync under the old declarations wrote
+ * its ledger after the change. A record's or mutation's ledger stays
+ * trusted as the record moves on: the record itself says what a seed may do.
+ *
+ * Mappings that share a source and a prefix list it once a round; a glob that
+ * matches only the prefix's own folder lists that folder alone.
+ *
+ * @packageDocumentation
+ */
+import { type EastTypeValue } from '@elaraai/east';
+import { type FilesBinding, type FilesLedgerValue, type FilesListingRow, type FilesManifest, type FilesMapping, type FilesProblem, type FilesRefusalReason, type FilesSyncReport, type FilesTaken, type FilesTarget } 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 */
@@ -19,39 +75,159 @@ export interface FilesListOptions {
     /** Only the files in the prefix's own folder, none in a folder under it */
     readonly topFolderOnly?: boolean;
 }
+/** How a reader opens a file's bytes. */
+export interface FilesOpenOptions {
+    /** The byte to start at: a typed intake resumed where its staging stood */
+    readonly start?: number;
+}
 /** 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, options?: FilesListOptions): AsyncIterable<FilesObject>;
-    /** One file's listing, or `null` when there is none */
+    /** The files under a prefix, in key order; a prefix's own folder alone when asked */
+    list(prefix: string, options?: FilesListOptions): AsyncIterable<FilesObject> | Iterable<FilesObject>;
+    /** One file, or null when there is none at the key */
     stat(key: string): Promise<FilesObject | null>;
     /**
-     * One file's bytes, as its listing gave it: a file that changed since, or
-     * that the reader cannot read, is refused with a {@link FilesUnreadableError}
+     * A file's bytes, whole, at the version its listing gave.
+     *
+     * @throws {FilesUnreadableError} When the file cannot be read: archived, changed since it was listed, gone, or closed to the reader
+     */
+    read(object: FilesObject): Promise<Uint8Array>;
+    /**
+     * A range of a file's bytes, `[start, end)`: a typed file's header, read
+     * before any other byte of it.
+     *
+     * @throws {FilesUnreadableError} As `read`
+     */
+    readRange(object: FilesObject, start: number, end: number): Promise<Uint8Array>;
+    /**
+     * A file's bytes as a stream, from a byte on, for a typed file taken in
+     * without being held whole.
+     *
+     * @throws {FilesUnreadableError} As `read`
      */
-    read(file: FilesObject): Promise<Uint8Array>;
+    open(object: FilesObject, options?: FilesOpenOptions): Promise<AsyncIterable<Uint8Array>>;
 }
 /**
- * A file a reader cannot read, which a sync refuses and names in its report,
- * going on with the rest; the next sync tries it again. A reader throws it
- * for what is the file's own, never for its source as a whole: a file
- * archived, changed or gone since it was listed, or closed to the reader's
- * access. Any other error ends the round, which is tried again.
+ * Thrown by a reader for a file it cannot read, which the sync refuses and
+ * goes on past: archived, changed since it was listed, gone, or closed to
+ * the reader's access. Anything else a reader throws stops the sync.
  */
 export declare class FilesUnreadableError extends Error {
+    /** The file's key */
     readonly key: string;
+    /** Why, as the refusal says it */
     readonly reason: string;
-    /**
-     * @param key - The file's key, relative to the binding
-     * @param reason - Why, completing "'<key>' …"
-     */
     constructor(key: string, reason: string);
 }
-/** Writes one workspace's inputs. Each write answers the value it set: its hash. */
+/**
+ * A typed intake under way across rounds: the file it takes (its key and
+ * ETag, so no other file is resumed as it), its SHA-256 once its bytes are
+ * placed in the store, else where its staging stood (the writer's own
+ * progress, as text).
+ */
+export interface TypedIntakeProgress {
+    readonly key: string;
+    readonly etag: string;
+    readonly sha256: string | null;
+    readonly staging: string | null;
+}
+/** What a typed intake is given. */
+export interface TypedIntakeOptions {
+    /** The file's SHA-256, where the caller knows it (a push) */
+    readonly sha256?: string;
+    /** The intake of this same file an earlier round left under way, to resume */
+    readonly resume?: TypedIntakeProgress;
+    /** Stops the intake where it can resume: a round's deadline */
+    readonly signal?: AbortSignal;
+}
+/**
+ * What a typed intake did: took the file; stopped at the round's deadline,
+ * where the next round resumes it (`taking`), or before anything was kept,
+ * so the next round starts the file again (`taking` null); or refused it.
+ */
+export type TypedIntakeResult = {
+    readonly status: 'taken';
+    readonly hash: string;
+    readonly sha256: string;
+    readonly taken: FilesTaken;
+} | {
+    readonly status: 'yielded';
+    readonly taking: TypedIntakeProgress | null;
+} | {
+    readonly status: 'refused';
+    readonly reason: FilesRefusalReason;
+};
+/**
+ * A record, as a seed reads it: pending (no state yet, its file its genesis),
+ * or its head commit, with how many commits have been made since its last
+ * seed (`$init` or `$seed`); null when its history was not walked to a seed.
+ */
+export type RecordSeedState = {
+    readonly pending: true;
+} | {
+    readonly pending: false;
+    readonly head: string;
+    readonly sinceSeed: number | null;
+};
+/** What a seed is given. */
+export interface SeedOptions {
+    /** Whether the record is pending, so the file is its genesis (`$init`); else its state again (`$seed`) */
+    readonly genesis: boolean;
+    /** The file's SHA-256, where the caller knows it */
+    readonly sha256?: string;
+    readonly signal?: AbortSignal;
+}
+/**
+ * What a seed did: committed the file as the record's state; stopped at the
+ * round's deadline, the pieces it took in remembered for the next sync; or
+ * refused the file.
+ */
+export type SeedResult = {
+    readonly status: 'committed';
+    readonly commit: string;
+    readonly rows: bigint | null;
+    readonly sha256: string;
+} | {
+    readonly status: 'yielded';
+} | {
+    readonly status: 'refused';
+    readonly reason: FilesRefusalReason;
+};
+/** What a feed is given. */
+export interface FeedOptions {
+    /** The file's SHA-256, where the caller knows it: the feed's idempotency key */
+    readonly sha256?: string;
+    /** The SHA-256 of every file the mutation has applied already: one of them is applied again under no name */
+    readonly applied?: ReadonlySet<string>;
+    readonly signal?: AbortSignal;
+}
+/**
+ * What a feed did: committed through the mutation; applied before, so
+ * nothing more; waits (for the record's first state, or for a round the
+ * deadline or a busy record cut short: tried again by the next sync); or
+ * was refused by the mutation, which the file's bytes must change to be
+ * tried again.
+ */
+export type FeedResult = {
+    readonly status: 'committed';
+    readonly commit: string;
+    readonly sha256: string;
+} | {
+    readonly status: 'applied';
+    readonly sha256: string;
+} | {
+    readonly status: 'waiting';
+    readonly reason: string;
+} | {
+    readonly status: 'refused';
+    readonly reason: FilesRefusalReason;
+    readonly sha256: string;
+};
+/** Writes one workspace's inputs and records, as a sync fills them. */
 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 */
+    /** Sets a `file` or `latest` input with no type 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
@@ -61,6 +237,18 @@ export interface FilesWriter {
     updateFolder(input: string, changes: FolderChanges): Promise<string>;
     /** Sets a `listing` input */
     setListing(input: string, rows: ReadonlyMap<string, FilesListingRow>): Promise<string>;
+    /**
+     * Takes a typed file in as an input's value, from a stream of its bytes:
+     * never held whole, a collection by pieces. The file's header has been
+     * checked against `type` already.
+     */
+    takeTyped(input: string, file: FilesObject, type: EastTypeValue, source: FilesReader, options: TypedIntakeOptions): Promise<TypedIntakeResult>;
+    /** A record, as a seed reads it; absent where records cannot be seeded */
+    recordState?(record: string): Promise<RecordSeedState>;
+    /** Seeds a record from a typed file: its first state, or its state again */
+    seed?(record: string, file: FilesObject, type: EastTypeValue, source: FilesReader, options: SeedOptions): Promise<SeedResult>;
+    /** Feeds a record's mutation a typed file's value, once */
+    feed?(record: string, mutation: string, file: FilesObject, type: EastTypeValue, source: FilesReader, options: FeedOptions): Promise<FeedResult>;
 }
 /** What a sync changes in a `folder` input. */
 export interface FolderChanges {
@@ -71,55 +259,76 @@ export interface FolderChanges {
     /** Whether the folder is `set` alone, whatever the input holds now */
     readonly fresh: boolean;
 }
-/** What an input took of one file. */
+/** What a target took of one file. */
 export interface LedgerEntry {
     readonly etag: string;
     readonly size: number;
+    /** The file's SHA-256, where the sync hashed it */
+    readonly sha256?: string;
+    /** When the file was last written, as its listing said */
+    readonly modified?: Date;
 }
-/** What an input took last: each file, the value the sync wrote, and what it was taken under. */
+/** What a target took last: each file, the value the sync wrote or the commit it made, and what it was taken under. */
 export interface LedgerState {
-    /** Each file it took, by key */
+    /** Each file it took, by key; a feed's, every file applied */
     readonly entries: ReadonlyMap<string, LedgerEntry>;
-    /** The value the sync wrote, its hash; `null` before its first sync */
+    /** The value the sync wrote, its hash: an input's; `null` before its first sync */
     readonly value: string | null;
     /**
      * The mapping's shape and its source's binding it was taken under, as one
      * text ({@link takenUnder}); `null` before its first sync
      */
     readonly under: string | null;
+    /** The commit the sync made: a record's seed, a mutation's last feed; `null` for an input, or before any */
+    readonly commit: string | null;
+    /** The SHA-256 of a feed the mutation refused, not tried again until the file changes */
+    readonly tried: string | null;
+    /** A typed intake under way across rounds */
+    readonly taking: TypedIntakeProgress | null;
 }
-/** What an input took before its first sync: nothing. */
+/** What a target took before its first sync: nothing. */
 export declare const NO_LEDGER: LedgerState;
 /**
- * What an input took, as a store keeps it (e3-cloud-types' `FilesLedgerType`).
+ * What a target took, as a store keeps it (e3-cloud-types' `FilesLedgerType`).
  *
  * @param state - What it took
  * @returns Its East value
  */
 export declare function ledgerValueOf(state: LedgerState): FilesLedgerValue;
 /**
- * What an input took, from what a store keeps.
+ * What a target took, from what a store keeps.
  *
  * @param value - Its East value
  * @returns What it took
  */
 export declare function ledgerStateOf(value: FilesLedgerValue): LedgerState;
 /**
- * What an input's files are taken under: its mapping's shape and where its
+ * The key a target's ledger is kept under: an input's name, as the first
+ * version kept it; a record's under `records/`; a mutation's under
+ * `mutations/{record}/{mutation}` (two segments: a name may hold a dot).
+ *
+ * @param target - The target
+ * @returns Its ledger's key
+ */
+export declare function ledgerKeyOf(target: FilesTarget): string;
+/**
+ * What a target's files are taken under: its mapping's shape and where its
  * source is bound, as one text. A ledger taken under another is not trusted:
- * its keys may name other files, and its paths another folder's.
+ * its keys may name other files, and its paths another folder's. A shape
+ * that names no type prints as the first version printed it, so a ledger it
+ * wrote stays trusted.
  *
  * @param mapping - The mapping
  * @param binding - Its source's binding
  * @returns The text
  */
 export declare function takenUnder(mapping: FilesMapping, binding: FilesBinding): string;
-/** Remembers, for each input, what it took last. */
+/** Remembers, for each target, 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 target took last, by its ledger's key ({@link ledgerKeyOf}); nothing before its first sync */
+    read(key: string): Promise<LedgerState>;
+    /** Remembers what a target took */
+    write(key: string, state: LedgerState): Promise<void>;
 }
 /** What a sync is given. */
 export interface SyncOptions {
@@ -129,33 +338,37 @@ export interface SyncOptions {
     readonly bindings: readonly FilesBinding[];
     /** Reads a bound source */
     readonly reader: (binding: FilesBinding) => FilesReader;
-    /** Writes the workspace's inputs */
+    /** Writes the workspace's inputs and records */
     readonly writer: FilesWriter;
-    /** Remembers what each input took */
+    /** Remembers what each target 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[];
+    /** Only these targets; every mapping when absent */
+    readonly targets?: readonly FilesTarget[];
+    /** Records whose file is taken as their state again, whatever has mutated them since their seed */
+    readonly reset?: 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;
+    /** Stops a typed intake, a seed or a feed where it can resume: a round's deadline */
+    readonly signal?: AbortSignal;
 }
 /** 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
+     * Asked between targets, between a folder's batches and between a feed's
+     * files, once the round has written something: `true` stops the round
+     * there, every target 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 */
+    /** What it did: each target 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 */
+    /** Whether it stopped when asked, with targets, a folder's files, a feed's files or an intake 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. */
@@ -166,26 +379,52 @@ export declare class FilesSyncError extends Error {
     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.
+ * The root type a beast2 file's header declares, read through its head:
+ * 64 KiB, then wider only for a wide type section, never the file. Refused
+ * as no beast2 when the header is malformed, or wider than any type section
+ * is. What the sync and a push's reading of a file on disk share.
+ *
+ * @param size - The file's size
+ * @param readHead - Reads the file's first bytes, as many as asked
+ * @returns The declared root type, or why the file is no beast2
+ */
+export declare function beast2HeaderTypeOf(size: number, readHead: (bytes: number) => Promise<Uint8Array>): Promise<{
+    type: EastTypeValue;
+} | {
+    reason: FilesRefusalReason;
+}>;
+/**
+ * Whether a type is a collection's: an Array, Set or Dict root, which beast2
+ * stores in segments and e3 takes in by pieces, of any size.
+ *
+ * @param type - The type
+ * @returns Whether it is a collection
+ */
+export declare function isCollectionType(type: EastTypeValue): boolean;
+/**
+ * Brings each mapping's target up to date with its source's files, stopping
+ * when asked between targets, between a folder's batches, between a feed's
+ * files or within a typed intake: one round of a sync that hands over, as
+ * the platform's do. What it stopped before, the next round takes. Records
+ * are seeded before mutations are fed, so a record seeded and fed in one
+ * sync takes both, in that order.
  *
  * @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
+ * @returns What it did, per target 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
+ * @throws {Error} When a target 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.
+ * Brings each mapping's target 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
+ * @throws {Error} When a target 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

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