feat: snapshot

README.md

@@ -17,12 +17,12 @@
 - Tree-shakable and lightweight core
 - Native aware value serialization and deserialization
 - Restore initial state (hydration)
+- State snapshot
 
 WIP:
 
 - Unmount
 - Key expiration
-- State snapshot
 - State compression
 - Watcher
 
@@ -148,6 +148,15 @@ Removes all stored key/values. If a base is provided, only mounts matching base
 await storage.clear()
 ```
 
+### `snapshot(storage, base?)`
+
+Snapshot from all keys in specified base into a plain javascript object (string: string). Base is removed from keys.
+```js
+import { snapshot } from 'unstorage'
+
+const data = await snapshot(storage, '/etc')
+```
+
 ### `storage.dispose()`
 
 Disposes all mounted storages to ensure there are no open-handles left. Call it before exiting process.

src/storage.ts

@@ -96,6 +96,16 @@ export function createStorage (): Storage {
   return storage
 }
 
+export async function snapshot (storage: Storage, base: string) {
+  base = normalizeBase(base)
+  const keys = await storage.getKeys(base)
+  const snapshot: any = {}
+  await Promise.all(keys.map(async (key) => {
+    snapshot[key.substr(base.length)] = await storage.getItem(key)
+  }))
+  return snapshot
+}
+
 async function dispose (storage: Driver) {
   if (typeof storage.dispose === 'function') {
     await asyncCall(storage.dispose)

test/snapshot.test.ts

@@ -0,0 +1,20 @@
+import { createStorage, snapshot } from '../src'
+
+const data = {
+  'etc:conf': 'test',
+  'data:foo': 'bar'
+}
+
+describe('snapshot', () => {
+  it('snapshot', async () => {
+    const storage = createStorage()
+    await storage.setItems('', data)
+    expect(await snapshot(storage, '')).toMatchObject(data)
+  })
+
+  it('snapshot (subpath)', async () => {
+    const storage = createStorage()
+    await storage.setItems('', data)
+    expect(await snapshot(storage, 'etc')).toMatchObject({ conf: 'test' })
+  })
+})