storage.get(key, { type })

[pi0]

Describe the feature

Currently, unstorage has two ways to access items:

• getItem(key): Returns a json parsed value if parsable or fallback to text
• `getItemRaw(key): Returns raw storage value (Typically arrayBuffer but unpredictable)

This is an unpredictable behavior and also introduced two sets of methods.

We could support storage.get(key, { type: "text" | "json" | "bytes" | "stream" | "blob" }) API to unify this and also make behavior more predictable.

await storage.get("key") // Defaults to json > text as before using destr
await storage.get("key", { type: "text" )  // Avoid serialization
await storage.get("key", { type: "json" )  // Strictly use JSON.parse
await storage.get("key", { type: "bytes" ) // Return Buffer or Unit8Array
await storage.get("key", { type: "bytes" ) // Return a readable stream

undio can potentially be integrated or we might end-up directly adding small utils in unstorage core to convert

Additional information

• Would you be willing to help implement this feature?

[cjpearson]

This looks like a nice improvement to me. I suppose the typing would also be improved by looking at the type option? Does it make sense to also include blob as a type?