Recursively remove/clear items

[Niki2k1]

Describe the feature

Feature Request

It would be very nice to recursively delete/clear sub-items in a storage.

Expected Behavior

We have a users base like this where we set an array of users for e.g caching.

await useStorage('cache').setItem('users:all', '[{ ... }]')
await useStorage('cache').setItem('users:admin', '[{ ... }]')

Now I want to be able to remove the prefix "users" which should recursively remove all items under the key.

await useStorage('cache').remove('users')
// or
await useStorage('cache').clear('users')

Clear which gets described in the Documentation as

Removes all stored key/values. If a base is provided, only mounts matching base will be cleared.

Which to my understanding should exactly be what I am search for, but with a fs driver it does not work (maybe a bug? I can provide a reproduction if needed)

If its not a bug:
Should I just use a loop with getKeys() and removeItem() or is there a better way it could be supported directly in unstorage.

Thank you! 💛

Maybe I don't understand bases correctly. My mental model is only wrapped around the file system implementation but redis for example does not have folders and the key is just a string and you probably can't say remove items with users:* (?)

Reproduction

https://stackblitz.com/edit/github-58uuvdlj?file=server%2Froutes%2Findex.ts

Additional information

• Would you be willing to help implement this feature?

[ToBinio]

Hi,

I myself just got very confused on how the whole thing works - #616 (comment)

As far as I understand it, clear only works on mount level. Meaning, you need to add a driver for "cache:users" extra.
unstorage does not seem to handle nested structures automatically for you.

See https://unstorage.unjs.io/guide#mountmountpoint-driver

For this you will probably need a plugin not sure if the nuxt/nitro config is able to do that.

// plugin.ts
export default defineNitroPlugin(() => {
  const storage = useStorage();

  storage.mount('test', memoryDriver());
  storage.mount('test:user', memoryDriver());
});

// usage.ts
const storage = useStorage('test');

await storage.setItem('user:123', { hello: 'world' });
await storage.setItem('data:123', { hello: 'world' });

await storage.clear('user'); // works
await storage.clear('data'); // does not work

Note: a driver named "cache" might make issues, since this is a name used by nitro for cachedRoutes - I think