@supabase/storage-js 2.76.2-canary.0 → 2.76.2-canary.2

package/src/lib/types.ts

@@ -19,6 +19,14 @@ export interface Bucket {
   public: boolean
 }
 
+export interface ListBucketOptions {
+  limit?: number
+  offset?: number
+  sortColumn?: 'id' | 'name' | 'created_at' | 'updated_at'
+  sortOrder?: 'asc' | 'desc'
+  search?: string
+}
+
 /**
  * Represents an Analytics Bucket using Apache Iceberg table format.
  * Analytics buckets are optimized for analytical queries and data processing.
@@ -43,6 +51,7 @@ export interface FileObject {
   id: string
   updated_at: string
   created_at: string
+  /** @deprecated */
   last_accessed_at: string
   metadata: Record<string, any>
   buckets: Bucket
@@ -55,6 +64,7 @@ export interface FileObjectV2 {
   bucket_id: string
   updated_at: string
   created_at: string
+  /** @deprecated */
   last_accessed_at: string
   size?: number
   cache_control?: string

package/src/lib/version.ts

@@ -4,4 +4,4 @@
 // - Debugging and support (identifying which version is running)
 // - Telemetry and logging (version reporting in errors/analytics)
 // - Ensuring build artifacts match the published package version
-export const version = '2.76.2-canary.0'
+export const version = '2.76.2-canary.2'

package/src/packages/StorageBucketApi.ts

@@ -2,7 +2,7 @@ import { DEFAULT_HEADERS } from '../lib/constants'
 import { isStorageError, StorageError } from '../lib/errors'
 import { Fetch, get, post, put, remove } from '../lib/fetch'
 import { resolveFetch } from '../lib/helpers'
-import { Bucket, BucketType } from '../lib/types'
+import { Bucket, BucketType, ListBucketOptions } from '../lib/types'
 import { StorageClientOptions } from '../StorageClient'
 
 export default class StorageBucketApi {
@@ -44,7 +44,7 @@ export default class StorageBucketApi {
   /**
    * Retrieves the details of all Storage buckets within an existing project.
    */
-  async listBuckets(): Promise<
+  async listBuckets(options?: ListBucketOptions): Promise<
     | {
         data: Bucket[]
         error: null
@@ -55,7 +55,10 @@ export default class StorageBucketApi {
       }
   > {
     try {
-      const data = await get(this.fetch, `${this.url}/bucket`, { headers: this.headers })
+      const queryString = this.listBucketOptionsToQueryString(options)
+      const data = await get(this.fetch, `${this.url}/bucket${queryString}`, {
+        headers: this.headers,
+      })
       return { data, error: null }
     } catch (error) {
       if (this.shouldThrowOnError) {
@@ -286,4 +289,26 @@ export default class StorageBucketApi {
       throw error
     }
   }
+
+  private listBucketOptionsToQueryString(options?: ListBucketOptions): string {
+    const params: Record<string, string> = {}
+    if (options) {
+      if ('limit' in options) {
+        params.limit = String(options.limit)
+      }
+      if ('offset' in options) {
+        params.offset = String(options.offset)
+      }
+      if (options.search) {
+        params.search = options.search
+      }
+      if (options.sortColumn) {
+        params.sortColumn = options.sortColumn
+      }
+      if (options.sortOrder) {
+        params.sortOrder = options.sortOrder
+      }
+    }
+    return Object.keys(params).length > 0 ? '?' + new URLSearchParams(params).toString() : ''
+  }
 }