chore(storage): update names

Author: mandarini

packages/core/storage-js/README.md

@@ -123,7 +123,7 @@ Specialized buckets for storing and querying high-dimensional vector embeddings.
 
 ```js
 // Create vector bucket
-await storageClient.vectors.createVectorBucket('embeddings-prod')
+await storageClient.vectors.createBucket('embeddings-prod')
 
 // Create index and insert vectors
 const bucket = storageClient.vectors.from('embeddings-prod')
@@ -638,7 +638,7 @@ const supabase = createClient(
 const vectors = supabase.storage.vectors
 
 // Create a vector bucket
-await vectors.createVectorBucket('embeddings-prod')
+await vectors.createBucket('embeddings-prod')
 
 // Create an index
 const bucket = vectors.from('embeddings-prod')
@@ -693,7 +693,7 @@ const storageClient = new StorageClient('https://your-project.supabase.co/storag
 const vectors = storageClient.vectors
 
 // Use the same API as shown in Option 1
-await vectors.createVectorBucket('embeddings-prod')
+await vectors.createBucket('embeddings-prod')
 const bucket = vectors.from('embeddings-prod')
 // ... rest of operations
 ```
@@ -711,7 +711,7 @@ const vectorClient = new StorageVectorsClient('https://your-project.supabase.co/
 })
 
 // Use the same API as shown in Option 1
-await vectorClient.createVectorBucket('embeddings-prod')
+await vectorClient.createBucket('embeddings-prod')
 const bucket = vectorClient.from('embeddings-prod')
 // ... rest of operations
 ```
@@ -742,35 +742,35 @@ Vector buckets are top-level containers for organizing vector indexes.
 ##### Create Bucket
 
 ```typescript
-const { data, error } = await vectorClient.createVectorBucket('my-bucket')
+const { data, error } = await vectorClient.createBucket('my-bucket')
 ```
 
 ##### Get Bucket
 
 ```typescript
-const { data, error } = await vectorClient.getVectorBucket('my-bucket')
+const { data, error } = await vectorClient.getBucket('my-bucket')
 console.log('Created at:', new Date(data.vectorBucket.creationTime! * 1000))
 ```
 
 ##### List Buckets
 
 ```typescript
-const { data, error } = await vectorClient.listVectorBuckets({
+const { data, error } = await vectorClient.listBuckets({
   prefix: 'prod-',
   maxResults: 100,
 })
 
 // Pagination
 if (data?.nextToken) {
-  const next = await vectorClient.listVectorBuckets({ nextToken: data.nextToken })
+  const next = await vectorClient.listBuckets({ nextToken: data.nextToken })
 }
 ```
 
 ##### Delete Bucket
 
 ```typescript
 // Bucket must be empty (all indexes deleted first)
-const { error } = await vectorClient.deleteVectorBucket('my-bucket')
+const { error } = await vectorClient.deleteBucket('my-bucket')
 ```
 
 #### Vector Indexes
@@ -947,7 +947,7 @@ await index.deleteVectors({
 The library uses a consistent error handling pattern:
 
 ```typescript
-const { data, error } = await vectorClient.createVectorBucket('my-bucket')
+const { data, error } = await vectorClient.createBucket('my-bucket')
 
 if (error) {
   console.error('Error:', error.message)
@@ -976,7 +976,7 @@ const vectorClient = new StorageVectorsClient(url, options)
 vectorClient.throwOnError()
 
 try {
-  const { data } = await vectorClient.createVectorBucket('my-bucket')
+  const { data } = await vectorClient.createBucket('my-bucket')
   // data is guaranteed to be present
 } catch (error) {
   if (error instanceof StorageVectorsApiError) {

packages/core/storage-js/src/lib/vectors/StorageVectorsClient.ts

@@ -40,7 +40,7 @@ export interface StorageVectorsClientOptions {
  * const vectors = storageClient.vectors
  *
  * // Use vector operations
- * await vectors.createVectorBucket('embeddings-prod')
+ * await vectors.createBucket('embeddings-prod')
  * const bucket = vectors.from('embeddings-prod')
  * await bucket.createIndex({ ... })
  * ```
@@ -49,15 +49,15 @@ export interface StorageVectorsClientOptions {
  * ```typescript
  * import { StorageVectorsClient } from '@supabase/storage-js'
  *
- * const client = new StorageVectorsClient('https://api.example.com', {
+ * const vectorsClient = new StorageVectorsClient('https://api.example.com', {
  *   headers: { 'Authorization': 'Bearer token' }
  * })
  *
  * // Access bucket operations
- * await client.createVectorBucket('embeddings-prod')
+ * await vectorsClient.createBucket('embeddings-prod')
  *
  * // Access index operations via buckets
- * const bucket = client.from('embeddings-prod')
+ * const bucket = vectorsClient.from('embeddings-prod')
  * await bucket.createIndex({
  *   indexName: 'documents',
  *   dataType: 'float32',

packages/core/storage-js/src/lib/vectors/VectorBucketApi.ts

@@ -19,6 +19,12 @@ export default class VectorBucketApi {
   protected fetch: Fetch
   protected shouldThrowOnError = false
 
+  /**
+   * Creates a new VectorBucketApi instance
+   * @param url - The base URL for the storage vectors API
+   * @param headers - HTTP headers to include in requests
+   * @param fetch - Optional custom fetch implementation
+   */
   constructor(url: string, headers: { [key: string]: string } = {}, fetch?: Fetch) {
     this.url = url.replace(/\/$/, '')
     this.headers = { ...DEFAULT_HEADERS, ...headers }
@@ -34,7 +40,7 @@ export default class VectorBucketApi {
    * ```typescript
    * const client = new VectorBucketApi(url, headers)
    * client.throwOnError()
-   * const { data } = await client.createVectorBucket('my-bucket') // throws on error
+   * const { data } = await client.createBucket('my-bucket') // throws on error
    * ```
    */
   public throwOnError(): this {
@@ -56,13 +62,13 @@ export default class VectorBucketApi {
    *
    * @example
    * ```typescript
-   * const { data, error } = await client.createVectorBucket('embeddings-prod')
+   * const { data, error } = await client.createBucket('embeddings-prod')
    * if (error) {
    *   console.error('Failed to create bucket:', error.message)
    * }
    * ```
    */
-  async createVectorBucket(vectorBucketName: string): Promise<ApiResponse<undefined>> {
+  async createBucket(vectorBucketName: string): Promise<ApiResponse<undefined>> {
     try {
       const data = await post(
         this.fetch,
@@ -95,13 +101,13 @@ export default class VectorBucketApi {
    *
    * @example
    * ```typescript
-   * const { data, error } = await client.getVectorBucket('embeddings-prod')
+   * const { data, error } = await client.getBucket('embeddings-prod')
    * if (data) {
    *   console.log('Bucket created at:', new Date(data.vectorBucket.creationTime! * 1000))
    * }
    * ```
    */
-  async getVectorBucket(
+  async getBucket(
     vectorBucketName: string
   ): Promise<ApiResponse<{ vectorBucket: VectorBucket }>> {
     try {
@@ -139,17 +145,17 @@ export default class VectorBucketApi {
    * @example
    * ```typescript
    * // List all buckets with prefix 'prod-'
-   * const { data, error } = await client.listVectorBuckets({ prefix: 'prod-' })
+   * const { data, error } = await client.listBuckets({ prefix: 'prod-' })
    * if (data) {
    *   console.log('Found buckets:', data.buckets.length)
    *   // Fetch next page if available
    *   if (data.nextToken) {
-   *     const next = await client.listVectorBuckets({ nextToken: data.nextToken })
+   *     const next = await client.listBuckets({ nextToken: data.nextToken })
    *   }
    * }
    * ```
    */
-  async listVectorBuckets(
+  async listBuckets(
     options: ListVectorBucketsOptions = {}
   ): Promise<ApiResponse<ListVectorBucketsResponse>> {
     try {
@@ -183,13 +189,13 @@ export default class VectorBucketApi {
    * @example
    * ```typescript
    * // Delete all indexes first, then delete bucket
-   * const { error } = await client.deleteVectorBucket('old-bucket')
+   * const { error } = await client.deleteBucket('old-bucket')
    * if (error?.statusCode === 'S3VectorBucketNotEmpty') {
    *   console.error('Must delete all indexes first')
    * }
    * ```
    */
-  async deleteVectorBucket(vectorBucketName: string): Promise<ApiResponse<undefined>> {
+  async deleteBucket(vectorBucketName: string): Promise<ApiResponse<undefined>> {
     try {
       const data = await post(
         this.fetch,