konserve.indexeddb — io.replikativ/konserve 0.7.304

connect-idb-store cljs

(connect-idb-store db-name & {:as params})

Connect to a IndexedDB backed KV store with the given db name. Optional serializer, read-handlers, write-handlers.

This implementation stores all values as js/Blobs in an IndexedDB object store instance. The object store itself is nameless, and there is no use of versioning, indexing, or cursors.

This data is stored as if indexedDB was a filesystem. Since we do not have file-descriptors to write with, strategy is to build a blob from components (js/Blobs have a nice api explicitly for this) and flush the blob to indexeddb storage on -sync-store calls (which doesnt concern consumers)

• all store ops are asynchronous only

• the database object must be 'unref'ed by calling db.close() before database instances can be deleted. You can do this easily by calling store.close() object method, which is unique to this impl. If you fail to maintain access to db and core.async gets into a weird state due to an unhandled error, you will be unable to delete the database until the vm is restarted

• As of November 2022 firefox does not support IDBFactory.databases() so expect list-dbs, db-exists?, & PBackingStore/-store-exists? to all throw. You must work around this by keeping track of each db name you intend to delete https://developer.mozilla.org/en-US/docs/Web/API/IDBFactory/databases#browser_compatibility

• PBackingBlob/-read-binary returns a webstream that is not queued to the value offset in the same way that the filestore implementations are. Consumers must discard the amount of bytes found in the :offset key of the locked-cb arg map. See: https://developer.mozilla.org/en-US/docs/Web/API/Blob/stream

db-exists? cljs

(db-exists? db-name)

delete-idb cljs

(delete-idb db-name)

flush-blob cljs

(flush-blob {:keys [db key buf header metadata value] :as bb})

list-dbs cljs

(list-dbs)

open-backing-blob cljs

(open-backing-blob db key)

read-blob cljs

(read-blob db key)

write-blob cljs

(write-blob db key blob)