BEHEMOTH

> hashed blob storage. on opfs. in memory. on disk. in orbit.

- 🗿 behemoth stores binary data, anywhere.
- 🔒 content-addressable -- sha256 hashes for identity (never store a dupe)
- 🔮 blob-oriented -- blobs provide random-access and are generally super cool
- 🏞️ stream-oriented -- streams allow you to upload/download big stuff smoothly
- ♻️ isomorphic -- runs in browsers or node
- 🛰️ remote -- (coming soon) connect to a remote behemoth api service

$3

> all behemoths have the same shape

Behemoth
- .has(hash: Hash): Promise
``ts
const exists = await behemoth.has(hash)
`
- .require(hash: Hash): Promise
`ts
const blob = await behemoth.require(hash)
`
- .get(hash: Hash): Promise
`ts
const blob = await behemoth.get(hash)
`
- .set(blob: Blob, options?: SetOptions): Promise
`ts
const hash = await behemoth.set(blob)
`
`ts
const hash = await behemoth.set(blob, {
onProgress: progress => {
progress.total // number, total amount of work
progress.done // number, amount of work completed
},
})
`
- .delete(...hashes: Hash[]): Promise
`ts
await behemoth.delete(hash)
`





$3

> store data in the browser's origin private file system

`ts
import {BehemothOpfs} from "@e280/behemoth"

const behemoth = await BehemothOpfs.mkdir("my-data")
`





$3

> store data to disk via node fs

`ts
import {BehemothDisk} from "@e280/behemoth/node"
// 👆

const behemoth = await BehemothDisk.mkdir("./my-data")
`





$3

> store data in memory

`ts
import {BehemothMemory} from "@e280/behemoth"

const behemoth = new BehemothMemory()
`




$3

> handy tools you might wanna use

- hashBlob(blob: Blob, onProgress: (hashed: number) => void): Promise
`ts
const hash = await hashBlob(blob)
`
`ts
const hash = await hashBlob(blob, hashed => {
console.log(bytes hashed: ${hashed})
})
`
- readBlob(blob: Blob): AsyncGenerator
`ts
for await (const chunk of readBlob(blob))
chunk
`
- readStream(stream: ReadableStream): AsyncGenerator
`ts
for await (const chunk of readStream(stream))
chunk
``

🧑‍💻 open source

e280.org, github stars plz