!feat: simulate directory in blob list

[farnabaz]

resolves #101

This creates a slightly breaking change when delimiter is defined in request

CleanShot.2024-05-27.at.18.20.44.mp4

[atinux]

Thanks for the PR!

I would like to give a consistent experience for what is returned from the list() method and returns:

interface BlobListResult {
  blobs: []
  hasMore: boolean
  cursor?: string
  folders?: string[]
}

Also, adding the option folded: true option instead to return the folders:

// Folded mode
const { blobs, folders } = await hubBlob().list({ folded: true })

// Expanded mode
const { blobs } = await hubBlob().list()

By returning hasMore and cursor, we also fix the pagination issue we have (to be tested):

We should be able to do:

const { list } = hubBlob()
let hasMore = true
let cursor
 
while (hasMore) {
  const res = await list({
    limit: 10,
    cursor,
  })
  hasMore = res.hasMore
  cursor = res.cursor
}

[farnabaz]

Also, adding the option folded: true option instead to return the folders:

Buckets accepts delimiter string to create these folds. I think kipping this delimiter makes more sense, and allows users to customise folding bahavior. WDYT @atinux ?

const { blobs, folders } = await hubBlob().list({ delimiter: '/' })

[cloudflare-workers-and-pages]

Deploying nuxthub-docs with    Cloudflare Pages

Latest commit:	8069b00
Status:	✅  Deploy successful!
Preview URL:	https://4fdfbc26.nuxthub-module.pages.dev
Branch Preview URL:	https://feat-blob-folders.nuxthub-module.pages.dev

View logs