feat: add storage interface + implement indexedDb

src/index.js

@@ -3,7 +3,7 @@ import { CID } from 'multiformats'
 import { extractVerifiedContent } from './utils/car.js'
 import { asAsyncIterable, asyncIteratorToBuffer } from './utils/itr.js'
 import { randomUUID } from './utils/uuid.js'
-import { memoryStorage } from './utils/storage.js'
+import { memoryStorage } from './utils/storage/index.js'
 
 class Saturn {
   /**

src/utils/storage/index.js

@@ -0,0 +1,17 @@
+
+// @ts-check
+
+import { indexedDbStorage } from './indexed-db-storage.js'
+import { memoryStorage } from './memory-storage.js'
+
+/**
+ * @typedef {object} Storage
+ * @property {function(string):Promise<any>} get - Retrieves the value associated with the key.
+ * @property {function(string,any):Promise<void>} set - Sets a new value for the key.
+ * @property {function(string):Promise<any>} delete - Deletes the value associated with the key.
+ */
+
+export {
+  indexedDbStorage,
+  memoryStorage
+}

src/utils/storage.js → src/utils/storage/indexed-db-storage.js

@@ -6,16 +6,9 @@ const DEFAULT_IDB_VERSION = 1
 const DEFAULT_IDB_STORAGE_NAME = 'saturn-db'
 const DEFAULT_SATURN_STORAGE_NAME = 'saturn-client'
 
-/**
- * @typedef {object} Storage
- * @property {function(string):Promise<any>} get - Retrieves the value associated with the key.
- * @property {function(string,any):Promise<void>} set - Sets a new value for the key.
- * @property {function(string):Promise<any>} delete - Deletes the value associated with the key.
- */
-
 /**
  * @function indexedDbStorage
- * @returns {Storage}
+ * @returns {import('./index.js').Storage}
  */
 export function indexedDbStorage () {
   const indexedDbExists = (typeof window !== 'undefined') && window?.indexedDB
@@ -34,17 +27,3 @@ export function indexedDbStorage () {
     delete: async (key) => indexedDbExists && (await dbPromise).delete(DEFAULT_SATURN_STORAGE_NAME, key)
   }
 }
-
-/**
- * @function memoryStorage
- * @returns {Storage}
- */
-export function memoryStorage () {
-  const storageObject = {}
-
-  return {
-    get: async (key) => storageObject[key],
-    set: async (key, value) => { storageObject[key] = value },
-    delete: async (key) => { delete storageObject[key] }
-  }
-}

src/utils/storage/memory-storage.js

@@ -0,0 +1,14 @@
+
+/**
+ * @function memoryStorage
+ * @returns {import('./index.js').Storage}
+ */
+export function memoryStorage () {
+  const storageObject = {}
+
+  return {
+    get: async (key) => storageObject[key],
+    set: async (key, value) => { storageObject[key] = value },
+    delete: async (key) => { delete storageObject[key] }
+  }
+}