@elaraai/e3-cloud-files 0.0.0-stage → 1.0.92

package/dist/src/s3/index.js

@@ -0,0 +1,138 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * `@elaraai/e3-cloud-files/s3`: the sync's reader of a bucket (`s3://`), one
+ * bound source read through a client the caller makes. The CLI makes it with
+ * the developer's own profile, the platform with a session scoped to the
+ * binding's bucket and prefix; both read through this.
+ *
+ * A listing is the bucket's, a page of 1,000 keys at a time, in key order;
+ * of a prefix's own folder alone (a delimiter), when the sync asks. An ETag is
+ * kept without the quotes the bucket wraps it in. One file's listing is a
+ * listing of its key alone, not a HEAD: a session that may list only under
+ * its binding's prefix is answered 403 for a HEAD of a key that isn't there,
+ * not 404. Credentials that may read the file but list nothing are asked by
+ * a HEAD instead, a 404 its absence. A file is read whole, at the version its listing gave (`If-Match`
+ * its ETag): at most 1 GiB for a `file` or `latest` input, 64 MiB for a
+ * folder's file. A file changed, archived, gone or closed to the reader since
+ * it was listed is refused (`FilesUnreadableError`), the sync going on with
+ * the rest; any other refusal is thrown.
+ *
+ * Needs `@aws-sdk/client-s3`, which a solution's own code never imports: the
+ * CLI and the platform do.
+ *
+ * @packageDocumentation
+ */
+import { GetObjectCommand, HeadObjectCommand, ListObjectsV2Command, S3ServiceException } from '@aws-sdk/client-s3';
+import { FilesUnreadableError } from '../sync/engine.js';
+/** An ETag without the quotes the bucket wraps it in. */
+function bare(etag) {
+    return (etag ?? '').replace(/^"|"$/g, '');
+}
+/** Whether the bucket answered that there is no such key. */
+function missing(err) {
+    return err instanceof S3ServiceException && (err.name === 'NotFound' || err.name === 'NoSuchKey' || err.$metadata.httpStatusCode === 404);
+}
+/** Whether the bucket refused a request for want of access. */
+function denied(err) {
+    return err instanceof S3ServiceException && (err.name === 'AccessDenied' || err.$metadata.httpStatusCode === 403);
+}
+/**
+ * Why the bucket refused to read one file, when the refusal is the file's
+ * own; `null` for any other, which the sync does not go on past.
+ */
+function unreadable(err) {
+    if (!(err instanceof S3ServiceException))
+        return null;
+    switch (err.name) {
+        case 'PreconditionFailed': return 'changed since it was listed: the next sync takes it';
+        case 'InvalidObjectState': return 'is archived: its storage class must be restored before it can be read';
+        case 'AccessDenied': return "can't be read with the binding's access: a key policy or the bucket's refuses it";
+        case 'NoSuchKey': return 'went while the sync read it';
+        default: return err.$metadata.httpStatusCode === 404 ? 'went while the sync read it' : null;
+    }
+}
+/**
+ * The reader of one bound source in its bucket.
+ *
+ * @param client - The client to read with: its credentials and region are the caller's
+ * @param location - The bucket, and the prefix the binding names
+ * @returns The reader: its keys relative to the prefix
+ */
+export function s3FilesReader(client, location) {
+    const absolute = (key) => `${location.prefix}${key}`;
+    return {
+        async *list(prefix, options = {}) {
+            let token;
+            do {
+                const page = await client.send(new ListObjectsV2Command({
+                    Bucket: location.bucket,
+                    Prefix: absolute(prefix),
+                    ContinuationToken: token,
+                    // The prefix's own folder: its subfolders are common prefixes, never listed
+                    ...(options.topFolderOnly === true && { Delimiter: '/' }),
+                }));
+                for (const object of page.Contents ?? []) {
+                    if (object.Key === undefined)
+                        continue;
+                    yield {
+                        key: object.Key.slice(location.prefix.length),
+                        size: object.Size ?? 0,
+                        modified: object.LastModified ?? new Date(0),
+                        etag: bare(object.ETag),
+                    };
+                }
+                token = page.IsTruncated === true ? page.NextContinuationToken : undefined;
+            } while (token !== undefined);
+        },
+        async stat(key) {
+            // The key's own listing comes first among those it begins: it is the
+            // shortest of them, and a listing is in key order
+            let page;
+            try {
+                page = await client.send(new ListObjectsV2Command({ Bucket: location.bucket, Prefix: absolute(key), MaxKeys: 1 }));
+            }
+            catch (err) {
+                if (!denied(err))
+                    throw err;
+                // Credentials that may read the file and list nothing: a HEAD's 404 is its absence
+                try {
+                    const head = await client.send(new HeadObjectCommand({ Bucket: location.bucket, Key: absolute(key) }));
+                    return { key, size: head.ContentLength ?? 0, modified: head.LastModified ?? new Date(0), etag: bare(head.ETag) };
+                }
+                catch (headErr) {
+                    if (missing(headErr))
+                        return null;
+                    throw headErr;
+                }
+            }
+            const object = page.Contents?.[0];
+            if (object?.Key !== absolute(key))
+                return null;
+            return { key, size: object.Size ?? 0, modified: object.LastModified ?? new Date(0), etag: bare(object.ETag) };
+        },
+        async read(file) {
+            let object;
+            try {
+                object = await client.send(new GetObjectCommand({ Bucket: location.bucket, Key: absolute(file.key), IfMatch: `"${file.etag}"` }));
+            }
+            catch (err) {
+                const reason = unreadable(err);
+                if (reason !== null)
+                    throw new FilesUnreadableError(file.key, reason);
+                throw err;
+            }
+            if (object.Body === undefined)
+                throw new Error(`s3://${location.bucket}/${absolute(file.key)} answered no bytes`);
+            if (object.ContentLength !== undefined && object.ContentLength !== file.size) {
+                // Never buffered: its size was never checked
+                object.Body.destroy?.();
+                throw new FilesUnreadableError(file.key, `changed since it was listed (${object.ContentLength} bytes, not the ${file.size} listed): the next sync takes it`);
+            }
+            return object.Body.transformToByteArray();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type StorageBackend } from '@elaraai/e3-core';
+import type { FilesWriter } from '../sync/engine.js';
+/**
+ * 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 declare function storageWriter(storage: StorageBackend, repo: string, ws: string): FilesWriter;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AAgDpE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAkC5F"}

package/dist/src/storage/index.js

@@ -0,0 +1,120 @@
+/**
+ * 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. A memo of the manifest to itself, until e3-core has a door
+            // for a value the store holds (east-workspace#1314); gc drops it once
+            // the manifest is collected
+            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,191 @@
+/**
+ * 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';
+/** 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;
+}
+/** How a reader lists a prefix. */
+export interface FilesListOptions {
+    /** Only the files in the prefix's own folder, none in a folder under it */
+    readonly topFolderOnly?: boolean;
+}
+/** 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 */
+    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}
+     */
+    read(file: FilesObject): Promise<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.
+ */
+export declare class FilesUnreadableError extends Error {
+    readonly key: string;
+    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. */
+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, the value the sync wrote, and what it was taken under. */
+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;
+    /**
+     * 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;
+}
+/** What an input 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`).
+ *
+ * @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.
+ *
+ * @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
+ * 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.
+ *
+ * @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. */
+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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"}