@teepin/sdk 0.2.1 → 0.3.0-rc.1

package/dist/types/links.d.ts

@@ -0,0 +1,86 @@
+import { LinkReads, type Session } from './direct/reads.js';
+import type { ObjectInfo, StorageObject } from './storage.js';
+import { type DownloadOptions, type DownloadSink } from './transfer.js';
+/** How a share link is meant to be offered: previewed where that is safe ("inline"), or saved as a file ("attachment"). */
+export type LinkDisposition = 'inline' | 'attachment';
+export interface OpenLinkOptions {
+    /** The API's address (default: the TEEPIN_BASE_URL environment variable, else https://api.teepin.com). */
+    baseUrl?: string;
+    /** The fetch to use (default: the global one). */
+    fetch?: typeof fetch;
+    /** Aborting it stops every read of the link, as close() does. */
+    signal?: AbortSignal;
+    /** Windows read() fetches ahead of a reader reading straight on (default 2), as openObject's. */
+    prefetch?: number;
+    /** Milliseconds one call to the API may take (default 60000); also how long a read waits for its next bytes. */
+    timeout?: number;
+    /** How many times a request that failed for a passing reason is tried again (default 4). */
+    maxRetries?: number;
+}
+/** A link's token: the link itself when it is a bare token, else its URL's fragment (the console's /l#<token>). */
+export declare function linkToken(link: string): string;
+/**
+ * Opens a share link with no API key: the object's details, then its bytes from the storage network, every one
+ * verified before it is used. link is the link's URL or its token. The link opens whatever is at its key now; once
+ * open, every read is of that version (ObjectChangedError if it is replaced), and reads go on after the link expires:
+ * for up to 30 minutes between reads, and never past the link's expiry plus 24 hours.
+ *
+ * Errors: InvalidLinkError for a damaged or expired link, NotFoundError for an object deleted since the link was made,
+ * PaymentRequiredError (onHold) while its owner's stored data is on hold, and a TeepinError for an object still being
+ * moved into storage.
+ *
+ * ```ts
+ * const obj = await openLink('https://console.teepin.com/l#…');
+ * console.log(obj.name, obj.size);
+ * const body = obj.stream(); // the whole object, its SHA-256 checked at the end
+ * obj.close();
+ * ```
+ */
+export declare function openLink(link: string, opts?: OpenLinkOptions): Promise<SharedObject>;
+/**
+ * An object opened through a share link: its details, and its bytes three ways (read at any offset, one stream of the
+ * whole object, or downloadTo a sink). Close it when done: that stops its reads and zeroes its copy of the data key.
+ */
+export declare class SharedObject {
+    private readonly reads;
+    private readonly session;
+    /** The name to save it as: the last segment of its key ("download" when there is none). */
+    readonly name: string;
+    /** Its size in bytes. */
+    readonly size: number;
+    /** Its content type ("application/octet-stream" when it has none). */
+    readonly contentType: string;
+    /** How the link is meant to be offered. */
+    readonly disposition: LinkDisposition;
+    /** Its download headers, as headObject gives them. */
+    readonly info: ObjectInfo;
+    private readonly file;
+    private readonly ctl;
+    private readonly unlinkSignal;
+    private dek;
+    private isClosed;
+    /** Made by openLink. */
+    constructor(reads: LinkReads, session: Session, opts?: Pick<OpenLinkOptions, 'signal' | 'prefetch'>);
+    get closed(): boolean;
+    /**
+     * Up to length bytes from offset: fewer only at the object's end, none past it. Reading straight on fetches a window
+     * at a time with the next ones ahead, as openObject's reader does; a read somewhere else fetches only what it needs.
+     */
+    read(offset: number, length: number): Promise<Uint8Array>;
+    /**
+     * The whole object as a stream of verified bytes, fetched only as they are read: a window at a time, its SHA-256
+     * checked as the last bytes arrive (ChecksumMismatchError). Read it to its end or cancel it.
+     */
+    stream(opts?: {
+        signal?: AbortSignal;
+    }): ReadableStream<Uint8Array>;
+    /**
+     * Downloads the object into sink, as parallel ranges of the version the link opened, every byte verified before it is
+     * written (the whole object's SHA-256 too, when it is read in one range: concurrency 1, or one window).
+     */
+    downloadTo(sink: DownloadSink, opts?: DownloadOptions): Promise<StorageObject>;
+    /** Stops every read (streams and downloads too) and zeroes this object's copy of the data key. */
+    close(): void;
+    private checkOpen;
+}
+//# sourceMappingURL=links.d.ts.map

package/dist/types/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/links.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,SAAS,EAAgC,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE1F,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAuB,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7F,2HAA2H;AAC3H,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,0GAA0G;IAC1G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gHAAgH;IAChH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mHAAmH;AACnH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAiB9F;AAqBD;;;GAGG;AACH,qBAAa,YAAY;IAmBrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAnB1B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IAEzB,wBAAwB;gBAEL,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,OAAO,EACjC,IAAI,GAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,UAAU,CAAM;IAwBzD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIzD;;;OAGG;IACH,MAAM,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,cAAc,CAAC,UAAU,CAAC;IAevE;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBxF,kGAAkG;IAClG,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,SAAS;CAGlB"}

package/dist/types/node/downloads.d.ts

@@ -0,0 +1,73 @@
+import { type DownloadResult } from '../direct/downloads-plan.js';
+import type { StorageService } from '../storage.js';
+export interface DownloadFilesOptions {
+    /**
+     * Leave a file that already has the object's size and SHA-256 (never compared by ETag): nothing is signed, or
+     * billed, for it.
+     */
+    skipExisting?: boolean;
+    /** Objects, or windows of a large object, fetched at once (default 8). */
+    concurrency?: number;
+    /** Bytes written so far, of all the objects being downloaded. */
+    onProgress?: (done: number, total: number) => void;
+    /**
+     * Keep a journal in the client's state directory (default true), so a download stopped part way goes on from what it
+     * wrote when it's run again. false keeps none.
+     */
+    journal?: boolean;
+    /** Aborting it stops every fetch at once: the call rejects with its reason, and the part files and journal stay for the next run. */
+    signal?: AbortSignal;
+}
+/** One event of a run's journal: an object being downloaded to path, one of its pieces written, and how it ended. */
+export type JournalEvent = {
+    e: 'object';
+    path: string;
+    key: string;
+    version: string;
+    size: number;
+} | {
+    e: 'range';
+    path: string;
+    a: number;
+    b: number;
+} | {
+    e: 'saved';
+    path: string;
+} | {
+    e: 'failed';
+    path: string;
+    error: string;
+};
+/** For tests only (a test checks that nothing under src sets it): called once each journal write is durable. */
+export declare const testHooks: {
+    journaled?: (events: readonly JournalEvent[]) => void;
+};
+/**
+ * Downloads many objects, each to destDir joined with its key (a/b.jpg to destDir/a/b.jpg), and returns one
+ * DownloadResult per key, in order (a key given twice is one). One object's failure never fails another.
+ *
+ * Read sessions are signed 1,000 objects to a request. Up to concurrency objects, or windows of a large object, are
+ * fetched at once, each verified before it is written to <name>.teepin-part beside its target; an object is checked
+ * against its SHA-256 and renamed into place only when whole.
+ *
+ * A download stopped by a passing error (the network, the storage network unavailable, a revoked key), by an abort or
+ * by the process ending is pending: its part file and the run's journal stay, and running the same download again
+ * goes on from what was written, unless the object has changed since.
+ *
+ * A key that isn't a safe path under destDir fails (UnsafePathError): "..", an absolute path, a name Windows can't
+ * have (on every OS), a link under destDir leading out of it, or two keys for one file (names that differ only by case,
+ * where names ignore case). A key ending in "/" (a folder marker) is skipped.
+ */
+export declare function downloadFiles(storage: StorageService, bucket: string, keys: readonly string[], destDir: string, opts?: DownloadFilesOptions): Promise<DownloadResult[]>;
+/**
+ * Downloads every object under prefix (all of them for ""), each to destDir joined with its key after the prefix, as
+ * downloadFiles does. With skipExisting, the listing's size and SHA-256 decide, so a file already there costs nothing
+ * more.
+ */
+export declare function downloadPrefix(storage: StorageService, bucket: string, prefix: string, destDir: string, opts?: DownloadFilesOptions): Promise<DownloadResult[]>;
+/**
+ * Whether names under dir ignore case (Windows, macOS's default volumes), found by trying; true when it can't be told,
+ * the safe side. dir is made if it isn't there.
+ */
+export declare function caseInsensitive(dir: string): Promise<boolean>;
+//# sourceMappingURL=downloads.d.ts.map

package/dist/types/node/downloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.d.ts","sourceRoot":"","sources":["../../../src/node/downloads.ts"],"names":[],"mappings":"AAsCA,OAAO,EAAyD,KAAK,cAAc,EAAkB,MAAM,6BAA6B,CAAC;AAGzI,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,eAAe,CAAC;AAGnE,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qIAAqI;IACrI,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qHAAqH;AACrH,MAAM,MAAM,YAAY,GACpB;IAAE,CAAC,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,CAAC,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,gHAAgH;AAChH,eAAO,MAAM,SAAS,EAAE;IAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,KAAK,IAAI,CAAA;CAAO,CAAC;AAWvF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAE3B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAW3B;AAkfD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBnE"}

package/dist/types/node/journal.d.ts

@@ -0,0 +1,162 @@
+import { type Entry, type Journal, type Row, type Table } from '../direct/journal.js';
+import type { KeyPins, RunPlace } from '../direct/uploads.js';
+export declare const STATE_ENV = "TEEPIN_STATE_DIR";
+export declare const RUN_FILE = "run.json";
+export declare const EVENTS_FILE = "events.jsonl";
+export declare const LOCK_FILE = "lock";
+export declare const PACKS_DIR = "packs";
+export declare const KEYS_DIR = "keys";
+export declare const HISTORY_FILE = "history.log";
+/** The journal's own format version, in run.json. */
+export declare const JOURNAL_FORMAT = 1;
+/** A lock file whose content can't be read yet is being written: held for this long, then stale. */
+export declare const LOCK_GRACE_MS = 10000;
+/** The state directory for this OS (section 19.12), or TEEPIN_STATE_DIR. */
+export declare function defaultStateDir(): string;
+/** Creates path (and its parents) readable by its owner only. */
+export declare function privateDir(path: string): Promise<string>;
+/** fsyncs a directory, so a rename or a new file in it survives a crash; nothing where the OS can't (Windows). */
+export declare function fsyncDir(path: string): Promise<void>;
+/** How long a rename over a file another process has open is tried again on Windows (tests shorten it), and how often. */
+export declare const sharing: {
+    retryMs: number;
+};
+/**
+ * Renames from over to, trying again for up to sharing.retryMs on Windows while another process holds to open
+ * (EPERM, EACCES or EBUSY: a reader of a lock, a history file being appended to). Elsewhere a rename replaces an open
+ * file, so it is tried once (profile 1's W-1; Go's journal does the same).
+ */
+export declare function renameOver(from: string, to: string, retryMs?: number): Promise<void>;
+/** Writes data to path all at once: a temporary file (0600), fsynced, then renamed over it, and the directory fsynced. */
+export declare function writeAtomic(path: string, data: Uint8Array | string): Promise<void>;
+/**
+ * One run's journal on disk: run.json, and events.jsonl appended a line per write. Writes resolve once they are
+ * fsynced; a batch is one line, so it lands whole or not at all. Only the run's lock holder opens it to write.
+ */
+export declare class FileJournal implements Journal {
+    readonly dir: string;
+    readonly durable = true;
+    private readonly data;
+    private fh?;
+    private chain;
+    private closed;
+    private broken?;
+    private constructor();
+    /** Opens a run's journal to write: replayed, then compacted when it has more than one line or a torn one. */
+    static open(dir: string): Promise<FileJournal>;
+    /** A run's rows, read without writing anything (a run another process may hold). */
+    static read(dir: string): Promise<Pick<Journal, 'get' | 'rows'>>;
+    put(table: Table, id: string, row: Row): Promise<void>;
+    write(entries: readonly Entry[]): Promise<void>;
+    get(table: Table, id: string): Row | undefined;
+    rows(table: Table): Row[];
+    nextId(table: Table): string;
+    /** Rewrites the journal as one line, atomically. */
+    compact(): Promise<void>;
+    private rewrite;
+    close(): Promise<void>;
+    private check;
+}
+/**
+ * When process pid started, as this OS tells it: a token that is the same for the same process every time it's asked,
+ * and differs for a process that reused its PID. undefined when the OS can't tell (then a live PID counts as the
+ * holder). Linux: /proc's start time in ticks since boot, with the boot's id; macOS and the BSDs: ps's start time;
+ * Windows: the process's creation time, from PowerShell.
+ */
+export declare function processStart(pid: number): Promise<string | undefined>;
+/**
+ * An exclusive lock on a run, held while it is open, so two processes (or two runs in one process) never work one run
+ * (section 17.2). A process that ends without releasing it leaves it stale, and the next taker takes it over.
+ */
+export declare class RunLock {
+    readonly path: string;
+    /** Our nonce while we hold it. */
+    private mine?;
+    constructor(path: string);
+    get held(): boolean;
+    private get key();
+    /** Takes the lock if no live process (this one included) holds it. */
+    acquire(): Promise<boolean>;
+    /**
+     * Whether a lock is stale: its process is gone (a dead PID on this host, or a reused one, whose start time differs),
+     * or it is this process's and no run here holds it (taking, when this lock object is the one taking it). A lock from
+     * another host is never stale: its PID means nothing here.
+     */
+    private stale;
+    /**
+     * Takes over a stale lock: only one taker's claim (an O_EXCL file named by the stale lock's identity) wins, and the
+     * winner replaces the lock whole only if it is still that stale one.
+     */
+    private takeOver;
+    private staleClaim;
+    /** Lets the lock go (deleting its file, if it is still ours). Safe to call twice. */
+    release(): Promise<void>;
+    /** Whether a live process (this one included, through another lock object) holds the lock. */
+    heldElsewhere(): Promise<boolean>;
+}
+/** Every run of a kind in the state directory, oldest first. */
+export declare function runIds(stateDir: string, kind?: string): Promise<string[]>;
+/** A run's directory in the state directory, with its lock and journal: a RunPlace for the upload engine. */
+export declare class RunDir implements RunPlace {
+    readonly id: string;
+    readonly kind: string;
+    readonly path: string;
+    readonly lock: RunLock;
+    private j?;
+    private released;
+    private constructor();
+    get journal(): FileJournal;
+    /** A new run, locked by this process, its journal open. */
+    static create(stateDir: string, kind?: string): Promise<RunDir>;
+    /** A run, locked for this caller with its journal open; undefined when a live process (or another run here) holds it. */
+    static take(stateDir: string, id: string, kind?: string): Promise<RunDir | undefined>;
+    /** A run's journal read without taking it, and whether a live process holds it. */
+    static peek(stateDir: string, id: string, kind?: string): Promise<{
+        journal: Pick<Journal, 'get' | 'rows'>;
+        inUse: boolean;
+    }>;
+    private packPath;
+    private keyPath;
+    writePack(name: string, data: Uint8Array): Promise<void>;
+    readPack(name: string): Promise<Uint8Array | undefined>;
+    removePack(name: string): Promise<void>;
+    packNames(): Promise<string[]>;
+    writeKey(id: string, key: Uint8Array): Promise<void>;
+    readKey(id: string): Promise<Uint8Array | undefined>;
+    /** Overwrites the key's file with zeros (fsynced), then deletes it. */
+    removeKey(id: string): Promise<void>;
+    /** The ids of the keys kept; leftovers of a write cut short are deleted. */
+    keyNames(): Promise<string[]>;
+    release(): Promise<void>;
+    /** Deletes the run while it still holds the lock (run.json first, so it's no longer listed), then lets the lock go. */
+    remove(): Promise<void>;
+}
+/** An append that finds the history past this many bytes trims it to 7 days. */
+export declare const HISTORY_TRIM_BYTES: number;
+/**
+ * One line about a finished run (section 17.12). Every SDK on this machine shares the file, so a line is added with
+ * one append (O_APPEND) and the file is never rewritten here (profile 1's G-3). It's trimmed to 7 days by
+ * trimHistory: by cleanUploads, or here once it passes HISTORY_TRIM_BYTES.
+ */
+export declare function appendHistory(stateDir: string, line: string, kind?: string, trimAt?: number): Promise<void>;
+/**
+ * Keeps the history's last 7 days, in one atomic rewrite. A line another SDK appends during the rewrite can be lost,
+ * so this runs only at cleanUploads or past the size cap, never on each run.
+ */
+export declare function trimHistory(stateDir: string, kind?: string): Promise<void>;
+/** The bytes under path. */
+export declare function directorySize(path: string): Promise<number>;
+/**
+ * The first public key seen for each account and key version (section 11.4), kept in the state directory's keys.json
+ * (and in memory when it can't be written): a different key under the same version is refused.
+ */
+export declare class FilePins implements KeyPins {
+    private readonly path;
+    private mem;
+    private chain;
+    constructor(stateDir: string);
+    check(accountId: string, version: number, publicKey: Uint8Array): Promise<boolean>;
+    private checkNow;
+    private load;
+}
+//# sourceMappingURL=journal.d.ts.map

package/dist/types/node/journal.d.ts.map

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

package/dist/types/node/uploads.d.ts

@@ -0,0 +1,86 @@
+import type { StorageService } from '../storage.js';
+import { type DirectUploads, type Digests, type FileHash, type RunHost, type RunPlace, type UploadResult, type UploadRun } from '../direct/uploads.js';
+/** node:crypto's hashes: native, and far faster than the portable ones. */
+export declare const nodeDigests: Digests;
+/** The disk the upload engine's runs need, in a state directory. The method tests replace is hashFile. */
+export declare class NodeRunHost implements RunHost {
+    readonly stateDir: string;
+    constructor(stateDir: string);
+    create(): Promise<RunPlace>;
+    ids(): Promise<string[]>;
+    take(id: string): Promise<RunPlace | undefined>;
+    peek(id: string): Promise<{
+        journal: Pick<RunPlace['journal'], 'get' | 'rows'>;
+        inUse: boolean;
+    } | undefined>;
+    history(line: string): Promise<void>;
+    trimHistory(): Promise<void>;
+    size(): Promise<number>;
+    /** A file's size, modification time and SHA-256, or the error reading it; a file that changes while it is read is a changed file. */
+    hashFile(path: string): Promise<FileHash | Error>;
+    readAt(path: string, offset: number, length: number): Promise<Uint8Array>;
+    readWhole(path: string, size: number): Promise<Uint8Array>;
+    /** In one pass, a file's whole SHA-256 and each part's. */
+    hashParts(path: string, size: number, partSize: number): Promise<{
+        whole: string;
+        parts: Map<number, string>;
+    }>;
+    contentType(path: string): string | undefined;
+}
+/** The storage service's upload engine, given the disk: run directories, key pins in the state directory, native hashes. */
+export declare function engineFor(storage: StorageService): DirectUploads;
+export interface UploadFilesOptions {
+    /** With a list of paths: put before each key. */
+    prefix?: string;
+    /** With a list of paths: each key is the path relative to root (with /); without root, the file's name. */
+    root?: string;
+    /** Default: guessed from each file's name. */
+    contentType?: string;
+    metadata?: Record<string, string>;
+    /** Write each object only if none is at its key. */
+    ifNoneMatch?: boolean;
+    /** Bytes saved so far and the total, as files are saved. */
+    onProgress?: (done: number, total: number) => void;
+    /** Journal the run in the state directory, so resumeUploads finishes it after a crash (default true); false keeps it in memory. */
+    journal?: boolean;
+    /** Bytes per part for files sent in parts (default 16 MiB). */
+    partSize?: number;
+    /** Stops the run: it is left in its journal, and resumeUploads (in this process or another) finishes it. */
+    signal?: AbortSignal;
+}
+/**
+ * Uploads many files at once, as one run, and returns one result per file, in order: saved, failed (with its error),
+ * or pending (kept for resumeUploads). One file's failure never fails another, and nothing is thrown for it: only for
+ * what stops the whole run (a revoked key, no permission, no credit), the state directory being unwritable, or an
+ * abort.
+ *
+ * files maps keys to paths, or lists paths: each key is then prefix plus the path relative to root (with /), or plus
+ * its name when there's no root.
+ *
+ * Small files are encrypted on this device and packed together; large ones go in parts. Each file is hashed when queued
+ * and checked again as it's sent, so a file that changes meanwhile fails with FileChangedError.
+ */
+export declare function uploadFiles(storage: StorageService, bucket: string, files: Record<string, string> | readonly string[], opts?: UploadFilesOptions): Promise<UploadResult[]>;
+/**
+ * Finishes every upload run an earlier process (or an aborted call in this one) left unfinished, from its journal in
+ * the state directory, and returns its files' results. Runs a live process is working on are left alone.
+ */
+export declare function resumeUploads(storage: StorageService, opts?: {
+    onProgress?: (done: number, total: number) => void;
+    signal?: AbortSignal;
+}): Promise<UploadResult[]>;
+/**
+ * The upload runs kept in the state directory: how many files each has saved, failed and still pending, whether a
+ * live process is working on it, and whether it has expired (untouched for 7 days: its files were not uploaded).
+ */
+export declare function listUploadRuns(storage: StorageService): Promise<UploadRun[]>;
+/**
+ * Removes the local state of runs untouched for longer than olderThan ms (default 7 days) that no live process is
+ * working on, cancelling their open uploads, with a warning for each (their pending files are not uploaded): never
+ * done silently. Finished runs remove their own state.
+ */
+export declare function cleanUploads(storage: StorageService, opts?: {
+    olderThan?: number;
+    signal?: AbortSignal;
+}): Promise<UploadRun[]>;
+//# sourceMappingURL=uploads.d.ts.map

package/dist/types/node/uploads.d.ts.map

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

package/dist/types/node.d.ts

@@ -1,5 +1,7 @@
 import type { StorageObject, StorageService } from './storage.js';
 import type { DownloadOptions, UploadOptions, UploadSource } from './transfer.js';
+export { downloadFiles, downloadPrefix, type DownloadFilesOptions } from './node/downloads.js';
+export { PART_SUFFIX, UnsafePathError, type DownloadResult, type DownloadStatus } from './direct/downloads-plan.js';
 /** A MIME type guessed from a file name, or undefined. */
 export declare function contentTypeOf(path: string): string | undefined;
 /** An UploadSource reading the file at path. Close it when done. */
@@ -15,6 +17,6 @@ export declare function uploadFile(storage: StorageService, bucket: string, key:
  * their SHA-256 first.
  */
 export declare function downloadFile(storage: StorageService, bucket: string, key: string, path: string, opts?: DownloadOptions): Promise<StorageObject>;
-/** Whether a local file holds the object's bytes: same size, and the same ETag computed with partBytes (default: the SDK's part size). */
-export declare function sameAsObject(path: string, obj: StorageObject, partBytes?: number): Promise<boolean>;
+export { cleanUploads, listUploadRuns, resumeUploads, uploadFiles, type UploadFilesOptions } from './node/uploads.js';
+export type { UploadResult, UploadRun } from './direct/uploads.js';
 //# sourceMappingURL=node.d.ts.map

package/dist/types/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/node.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAYlF,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9D;AAED,oEAAoE;AACpE,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG;IAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAwBjG;AAED,iHAAiH;AACjH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAOrJ;AAQD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBzJ;AAED,0IAA0I;AAC1I,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUzG"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/node.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAYpH,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9D;AAED,oEAAoE;AACpE,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG;IAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAwBjG;AAED,iHAAiH;AACjH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBrJ;AAQD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBzJ;AAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtH,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}