Module bucket

Bulk content storage.

Provides Bucket, a keyed blob store holding opaque byte values under opaque string keys, so that bulk content lives wherever a consumer needs it, whether in memory, on the file system or in a remote service, behind a single contract.

Values are stored, retrieved and removed one key at a time, streaming content in and out as a whole:

import { createMemoryBucket } from '@metreeca/core/bucket';

const bucket = createMemoryBucket();

await bucket.put("report.csv", file.stream());

const report = await bucket.get("report.csv"); // a fresh stream, or undefined if the key is unknown

await bucket.delete("report.csv");
Copy