chore(storage): docs and deno test setup

Author: mandarini

packages/core/storage-js/README.md

@@ -202,19 +202,26 @@ Supabase Storage provides built-in support for storing and querying high-dimensi
 
 ### Quick Start
 
+#### Using with StorageClient (Recommended)
+
+If you already have a `StorageClient` instance for regular file operations, access vector functionality through the `vectors` property:
+
 ```typescript
-import { StorageVectorsClient } from '@supabase/storage-js'
+import { StorageClient } from '@supabase/storage-js'
 
-// Initialize client
-const vectorClient = new StorageVectorsClient('https://your-project.supabase.co/storage/v1', {
-  headers: { Authorization: 'Bearer YOUR_TOKEN' },
+const storageClient = new StorageClient('https://your-project.supabase.co/storage/v1', {
+  apikey: 'YOUR_API_KEY',
+  Authorization: 'Bearer YOUR_TOKEN',
 })
 
+// Access vector operations
+const vectors = storageClient.vectors
+
 // Create a vector bucket
-await vectorClient.createVectorBucket('embeddings-prod')
+await vectors.createVectorBucket('embeddings-prod')
 
 // Create an index
-const bucket = vectorClient.from('embeddings-prod')
+const bucket = vectors.from('embeddings-prod')
 await bucket.createIndex({
   indexName: 'documents-openai',
   dataType: 'float32',
@@ -250,6 +257,28 @@ if (data) {
 }
 ```
 
+#### Standalone Usage
+
+For vector-only applications that don't need regular file storage operations, you can create a dedicated vector client:
+
+```typescript
+import { StorageVectorsClient } from '@supabase/storage-js'
+
+// Initialize standalone vector client
+const vectorClient = new StorageVectorsClient('https://your-project.supabase.co/storage/v1', {
+  headers: { Authorization: 'Bearer YOUR_TOKEN' },
+})
+
+// Use the same API as shown above
+await vectorClient.createVectorBucket('embeddings-prod')
+const bucket = vectorClient.from('embeddings-prod')
+// ... rest of operations
+```
+
+> **When to use each pattern:**
+> - Use `storageClient.vectors` when working with both files and vectors in the same application
+> - Use `new StorageVectorsClient()` for applications that only need vector operations without file storage
+
 ### API Reference
 
 #### Client Initialization

packages/integrations/storage-vectors-js/package.json

@@ -2,22 +2,28 @@
   "name": "@supabase/storage-vectors-js",
   "version": "0.0.0",
   "private": true,
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/main/index.js",
+  "module": "./dist/module/index.js",
+  "types": "./dist/module/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "@supabase-js/source": "./src/index.ts",
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "default": "./dist/index.js"
+      "types": "./dist/module/index.d.ts",
+      "require": "./dist/main/index.js",
+      "import": "./dist/module/index.js",
+      "default": "./dist/module/index.js"
     }
   },
   "files": [
     "dist",
     "!**/*.tsbuildinfo"
   ],
   "scripts": {
+    "clean": "rimraf dist",
+    "build": "npm run clean && npm run build:main && npm run build:module",
+    "build:main": "tsc -p tsconfig.lib.json",
+    "build:module": "tsc -p tsconfig.module.json",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",

packages/integrations/storage-vectors-js/project.json

@@ -0,0 +1,18 @@
+{
+  "name": "storage-vectors-js",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/integrations/storage-vectors-js/src",
+  "projectType": "library",
+  "targets": {
+    "build": {
+      "executor": "nx:run-script",
+      "options": {
+        "script": "build"
+      },
+      "dependsOn": ["^build"],
+      "inputs": ["production", "^production"],
+      "outputs": ["{projectRoot}/dist"],
+      "cache": true
+    }
+  }
+}

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

@@ -30,9 +30,24 @@ export interface StorageVectorsClientOptions {
  * Main client for interacting with S3 Vectors API
  * Provides access to bucket, index, and vector data operations
  *
- * @example
+ * **Usage Patterns:**
+ *
+ * 1. **Via StorageClient (recommended for most use cases):**
+ * ```typescript
+ * import { StorageClient } from '@supabase/storage-js'
+ *
+ * const storageClient = new StorageClient(url, headers)
+ * const vectors = storageClient.vectors
+ *
+ * // Use vector operations
+ * await vectors.createVectorBucket('embeddings-prod')
+ * const bucket = vectors.from('embeddings-prod')
+ * await bucket.createIndex({ ... })
+ * ```
+ *
+ * 2. **Standalone (for vector-only applications):**
  * ```typescript
- * import { StorageVectorsClient } from '@supabase/storage'
+ * import { StorageVectorsClient } from '@supabase/storage-js'
  *
  * const client = new StorageVectorsClient('https://api.example.com', {
  *   headers: { 'Authorization': 'Bearer token' }
@@ -42,7 +57,7 @@ export interface StorageVectorsClientOptions {
  * await client.createVectorBucket('embeddings-prod')
  *
  * // Access index operations via buckets
- * const bucket = client.bucket('embeddings-prod')
+ * const bucket = client.from('embeddings-prod')
  * await bucket.createIndex({
  *   indexName: 'documents',
  *   dataType: 'float32',

packages/integrations/storage-vectors-js/tsconfig.lib.json

@@ -3,7 +3,7 @@
   "compilerOptions": {
     "baseUrl": ".",
     "rootDir": "src",
-    "outDir": "dist",
+    "outDir": "dist/main",
     "target": "ES2017",
     "module": "CommonJS",
     "moduleResolution": "Node",

packages/integrations/storage-vectors-js/tsconfig.module.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.lib.json",
+  "compilerOptions": {
+    "module": "ES2020",
+    "outDir": "dist/module"
+  }
+}