@supabase/storage-js 2.81.2-canary.2 → 2.82.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -0
- package/dist/main/StorageClient.d.ts +15 -1
- package/dist/main/StorageClient.d.ts.map +1 -1
- package/dist/main/StorageClient.js +15 -1
- package/dist/main/StorageClient.js.map +1 -1
- package/dist/main/lib/types.d.ts +1 -1
- package/dist/main/lib/types.d.ts.map +1 -1
- package/dist/main/lib/vectors/StorageVectorsClient.d.ts +99 -18
- package/dist/main/lib/vectors/StorageVectorsClient.d.ts.map +1 -1
- package/dist/main/lib/vectors/StorageVectorsClient.js +95 -17
- package/dist/main/lib/vectors/StorageVectorsClient.js.map +1 -1
- package/dist/main/lib/vectors/VectorBucketApi.d.ts +35 -7
- package/dist/main/lib/vectors/VectorBucketApi.d.ts.map +1 -1
- package/dist/main/lib/vectors/VectorBucketApi.js +35 -7
- package/dist/main/lib/vectors/VectorBucketApi.js.map +1 -1
- package/dist/main/lib/vectors/VectorDataApi.d.ts +44 -8
- package/dist/main/lib/vectors/VectorDataApi.d.ts.map +1 -1
- package/dist/main/lib/vectors/VectorDataApi.js +44 -8
- package/dist/main/lib/vectors/VectorDataApi.js.map +1 -1
- package/dist/main/lib/vectors/VectorIndexApi.d.ts +43 -8
- package/dist/main/lib/vectors/VectorIndexApi.d.ts.map +1 -1
- package/dist/main/lib/vectors/VectorIndexApi.js +39 -7
- package/dist/main/lib/vectors/VectorIndexApi.js.map +1 -1
- package/dist/main/lib/version.d.ts +1 -1
- package/dist/main/lib/version.d.ts.map +1 -1
- package/dist/main/lib/version.js +1 -1
- package/dist/main/lib/version.js.map +1 -1
- package/dist/main/packages/StorageAnalyticsApi.d.ts +79 -28
- package/dist/main/packages/StorageAnalyticsApi.d.ts.map +1 -1
- package/dist/main/packages/StorageAnalyticsApi.js +80 -29
- package/dist/main/packages/StorageAnalyticsApi.js.map +1 -1
- package/dist/main/packages/StorageBucketApi.d.ts +143 -1
- package/dist/main/packages/StorageBucketApi.d.ts.map +1 -1
- package/dist/main/packages/StorageBucketApi.js +143 -1
- package/dist/main/packages/StorageBucketApi.js.map +1 -1
- package/dist/main/packages/StorageFileApi.d.ts +410 -2
- package/dist/main/packages/StorageFileApi.d.ts.map +1 -1
- package/dist/main/packages/StorageFileApi.js +410 -2
- package/dist/main/packages/StorageFileApi.js.map +1 -1
- package/dist/module/StorageClient.d.ts +15 -1
- package/dist/module/StorageClient.d.ts.map +1 -1
- package/dist/module/StorageClient.js +15 -1
- package/dist/module/StorageClient.js.map +1 -1
- package/dist/module/lib/types.d.ts +1 -1
- package/dist/module/lib/types.d.ts.map +1 -1
- package/dist/module/lib/vectors/StorageVectorsClient.d.ts +99 -18
- package/dist/module/lib/vectors/StorageVectorsClient.d.ts.map +1 -1
- package/dist/module/lib/vectors/StorageVectorsClient.js +95 -17
- package/dist/module/lib/vectors/StorageVectorsClient.js.map +1 -1
- package/dist/module/lib/vectors/VectorBucketApi.d.ts +35 -7
- package/dist/module/lib/vectors/VectorBucketApi.d.ts.map +1 -1
- package/dist/module/lib/vectors/VectorBucketApi.js +35 -7
- package/dist/module/lib/vectors/VectorBucketApi.js.map +1 -1
- package/dist/module/lib/vectors/VectorDataApi.d.ts +44 -8
- package/dist/module/lib/vectors/VectorDataApi.d.ts.map +1 -1
- package/dist/module/lib/vectors/VectorDataApi.js +44 -8
- package/dist/module/lib/vectors/VectorDataApi.js.map +1 -1
- package/dist/module/lib/vectors/VectorIndexApi.d.ts +43 -8
- package/dist/module/lib/vectors/VectorIndexApi.d.ts.map +1 -1
- package/dist/module/lib/vectors/VectorIndexApi.js +39 -7
- package/dist/module/lib/vectors/VectorIndexApi.js.map +1 -1
- package/dist/module/lib/version.d.ts +1 -1
- package/dist/module/lib/version.d.ts.map +1 -1
- package/dist/module/lib/version.js +1 -1
- package/dist/module/lib/version.js.map +1 -1
- package/dist/module/packages/StorageAnalyticsApi.d.ts +79 -28
- package/dist/module/packages/StorageAnalyticsApi.d.ts.map +1 -1
- package/dist/module/packages/StorageAnalyticsApi.js +80 -29
- package/dist/module/packages/StorageAnalyticsApi.js.map +1 -1
- package/dist/module/packages/StorageBucketApi.d.ts +143 -1
- package/dist/module/packages/StorageBucketApi.d.ts.map +1 -1
- package/dist/module/packages/StorageBucketApi.js +143 -1
- package/dist/module/packages/StorageBucketApi.js.map +1 -1
- package/dist/module/packages/StorageFileApi.d.ts +410 -2
- package/dist/module/packages/StorageFileApi.d.ts.map +1 -1
- package/dist/module/packages/StorageFileApi.js +410 -2
- package/dist/module/packages/StorageFileApi.js.map +1 -1
- package/dist/tsconfig.module.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/dist/umd/supabase.js +1 -1
- package/package.json +1 -1
- package/src/StorageClient.ts +15 -1
- package/src/lib/types.ts +1 -1
- package/src/lib/vectors/StorageVectorsClient.ts +99 -18
- package/src/lib/vectors/VectorBucketApi.ts +35 -7
- package/src/lib/vectors/VectorDataApi.ts +44 -8
- package/src/lib/vectors/VectorIndexApi.ts +43 -8
- package/src/lib/version.ts +1 -1
- package/src/packages/StorageAnalyticsApi.ts +81 -30
- package/src/packages/StorageBucketApi.ts +143 -1
- package/src/packages/StorageFileApi.ts +410 -2
|
@@ -6,10 +6,13 @@ const VectorIndexApi_1 = tslib_1.__importDefault(require("./VectorIndexApi"));
|
|
|
6
6
|
const VectorDataApi_1 = tslib_1.__importDefault(require("./VectorDataApi"));
|
|
7
7
|
const VectorBucketApi_1 = tslib_1.__importDefault(require("./VectorBucketApi"));
|
|
8
8
|
/**
|
|
9
|
+
*
|
|
10
|
+
* @alpha
|
|
11
|
+
*
|
|
9
12
|
* Main client for interacting with S3 Vectors API
|
|
10
13
|
* Provides access to bucket, index, and vector data operations
|
|
11
14
|
*
|
|
12
|
-
* **
|
|
15
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
13
16
|
*
|
|
14
17
|
* **Usage Patterns:**
|
|
15
18
|
*
|
|
@@ -64,23 +67,35 @@ const VectorBucketApi_1 = tslib_1.__importDefault(require("./VectorBucketApi"));
|
|
|
64
67
|
*/
|
|
65
68
|
class StorageVectorsClient extends VectorBucketApi_1.default {
|
|
66
69
|
/**
|
|
70
|
+
* @alpha
|
|
71
|
+
*
|
|
67
72
|
* Creates a StorageVectorsClient that can manage buckets, indexes, and vectors.
|
|
68
73
|
*
|
|
69
|
-
* **
|
|
74
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
70
75
|
*
|
|
76
|
+
* @category Vector Buckets
|
|
71
77
|
* @param url - Base URL of the Storage Vectors REST API.
|
|
72
78
|
* @param options.headers - Optional headers (for example `Authorization`) applied to every request.
|
|
73
79
|
* @param options.fetch - Optional custom `fetch` implementation for non-browser runtimes.
|
|
80
|
+
*
|
|
81
|
+
* @example
|
|
82
|
+
* ```typescript
|
|
83
|
+
* const client = new StorageVectorsClient(url, options)
|
|
84
|
+
* ```
|
|
74
85
|
*/
|
|
75
86
|
constructor(url, options = {}) {
|
|
76
87
|
super(url, options.headers || {}, options.fetch);
|
|
77
88
|
}
|
|
78
89
|
/**
|
|
90
|
+
*
|
|
91
|
+
* @alpha
|
|
92
|
+
*
|
|
79
93
|
* Access operations for a specific vector bucket
|
|
80
94
|
* Returns a scoped client for index and vector operations within the bucket
|
|
81
95
|
*
|
|
82
|
-
* **
|
|
96
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
83
97
|
*
|
|
98
|
+
* @category Vector Buckets
|
|
84
99
|
* @param vectorBucketName - Name of the vector bucket
|
|
85
100
|
* @returns Bucket-scoped client with index and vector operations
|
|
86
101
|
*
|
|
@@ -106,27 +121,42 @@ class StorageVectorsClient extends VectorBucketApi_1.default {
|
|
|
106
121
|
}
|
|
107
122
|
exports.StorageVectorsClient = StorageVectorsClient;
|
|
108
123
|
/**
|
|
124
|
+
*
|
|
125
|
+
* @alpha
|
|
126
|
+
*
|
|
109
127
|
* Scoped client for operations within a specific vector bucket
|
|
110
128
|
* Provides index management and access to vector operations
|
|
111
129
|
*
|
|
112
|
-
* **
|
|
130
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
113
131
|
*/
|
|
114
132
|
class VectorBucketScope extends VectorIndexApi_1.default {
|
|
115
133
|
/**
|
|
134
|
+
* @alpha
|
|
135
|
+
*
|
|
116
136
|
* Creates a helper that automatically scopes all index operations to the provided bucket.
|
|
117
137
|
*
|
|
118
|
-
* **
|
|
138
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
139
|
+
*
|
|
140
|
+
* @category Vector Buckets
|
|
141
|
+
* @example
|
|
142
|
+
* ```typescript
|
|
143
|
+
* const bucket = client.bucket('embeddings-prod')
|
|
144
|
+
* ```
|
|
119
145
|
*/
|
|
120
146
|
constructor(url, headers, vectorBucketName, fetch) {
|
|
121
147
|
super(url, headers, fetch);
|
|
122
148
|
this.vectorBucketName = vectorBucketName;
|
|
123
149
|
}
|
|
124
150
|
/**
|
|
151
|
+
*
|
|
152
|
+
* @alpha
|
|
153
|
+
*
|
|
125
154
|
* Creates a new vector index in this bucket
|
|
126
155
|
* Convenience method that automatically includes the bucket name
|
|
127
156
|
*
|
|
128
|
-
* **
|
|
157
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
129
158
|
*
|
|
159
|
+
* @category Vector Buckets
|
|
130
160
|
* @param options - Index configuration (vectorBucketName is automatically set)
|
|
131
161
|
* @returns Promise with empty response on success or error
|
|
132
162
|
*
|
|
@@ -153,11 +183,15 @@ class VectorBucketScope extends VectorIndexApi_1.default {
|
|
|
153
183
|
});
|
|
154
184
|
}
|
|
155
185
|
/**
|
|
186
|
+
*
|
|
187
|
+
* @alpha
|
|
188
|
+
*
|
|
156
189
|
* Lists indexes in this bucket
|
|
157
190
|
* Convenience method that automatically includes the bucket name
|
|
158
191
|
*
|
|
159
|
-
* **
|
|
192
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
160
193
|
*
|
|
194
|
+
* @category Vector Buckets
|
|
161
195
|
* @param options - Listing options (vectorBucketName is automatically set)
|
|
162
196
|
* @returns Promise with list of indexes or error
|
|
163
197
|
*
|
|
@@ -176,11 +210,15 @@ class VectorBucketScope extends VectorIndexApi_1.default {
|
|
|
176
210
|
});
|
|
177
211
|
}
|
|
178
212
|
/**
|
|
213
|
+
*
|
|
214
|
+
* @alpha
|
|
215
|
+
*
|
|
179
216
|
* Retrieves metadata for a specific index in this bucket
|
|
180
217
|
* Convenience method that automatically includes the bucket name
|
|
181
218
|
*
|
|
182
|
-
* **
|
|
219
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
183
220
|
*
|
|
221
|
+
* @category Vector Buckets
|
|
184
222
|
* @param indexName - Name of the index to retrieve
|
|
185
223
|
* @returns Promise with index metadata or error
|
|
186
224
|
*
|
|
@@ -200,11 +238,15 @@ class VectorBucketScope extends VectorIndexApi_1.default {
|
|
|
200
238
|
});
|
|
201
239
|
}
|
|
202
240
|
/**
|
|
241
|
+
*
|
|
242
|
+
* @alpha
|
|
243
|
+
*
|
|
203
244
|
* Deletes an index from this bucket
|
|
204
245
|
* Convenience method that automatically includes the bucket name
|
|
205
246
|
*
|
|
206
|
-
* **
|
|
247
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
207
248
|
*
|
|
249
|
+
* @category Vector Buckets
|
|
208
250
|
* @param indexName - Name of the index to delete
|
|
209
251
|
* @returns Promise with empty response on success or error
|
|
210
252
|
*
|
|
@@ -223,11 +265,15 @@ class VectorBucketScope extends VectorIndexApi_1.default {
|
|
|
223
265
|
});
|
|
224
266
|
}
|
|
225
267
|
/**
|
|
268
|
+
*
|
|
269
|
+
* @alpha
|
|
270
|
+
*
|
|
226
271
|
* Access operations for a specific index within this bucket
|
|
227
272
|
* Returns a scoped client for vector data operations
|
|
228
273
|
*
|
|
229
|
-
* **
|
|
274
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
230
275
|
*
|
|
276
|
+
* @category Vector Buckets
|
|
231
277
|
* @param indexName - Name of the index
|
|
232
278
|
* @returns Index-scoped client with vector data operations
|
|
233
279
|
*
|
|
@@ -255,16 +301,28 @@ class VectorBucketScope extends VectorIndexApi_1.default {
|
|
|
255
301
|
}
|
|
256
302
|
exports.VectorBucketScope = VectorBucketScope;
|
|
257
303
|
/**
|
|
304
|
+
*
|
|
305
|
+
* @alpha
|
|
306
|
+
*
|
|
258
307
|
* Scoped client for operations within a specific vector index
|
|
259
308
|
* Provides vector data operations (put, get, list, query, delete)
|
|
260
309
|
*
|
|
261
|
-
* **
|
|
310
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
262
311
|
*/
|
|
263
312
|
class VectorIndexScope extends VectorDataApi_1.default {
|
|
264
313
|
/**
|
|
314
|
+
*
|
|
315
|
+
* @alpha
|
|
316
|
+
*
|
|
265
317
|
* Creates a helper that automatically scopes all vector operations to the provided bucket/index names.
|
|
266
318
|
*
|
|
267
|
-
* **
|
|
319
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
320
|
+
*
|
|
321
|
+
* @category Vector Buckets
|
|
322
|
+
* @example
|
|
323
|
+
* ```typescript
|
|
324
|
+
* const index = client.bucket('embeddings-prod').index('documents-openai')
|
|
325
|
+
* ```
|
|
268
326
|
*/
|
|
269
327
|
constructor(url, headers, vectorBucketName, indexName, fetch) {
|
|
270
328
|
super(url, headers, fetch);
|
|
@@ -272,11 +330,15 @@ class VectorIndexScope extends VectorDataApi_1.default {
|
|
|
272
330
|
this.indexName = indexName;
|
|
273
331
|
}
|
|
274
332
|
/**
|
|
333
|
+
*
|
|
334
|
+
* @alpha
|
|
335
|
+
*
|
|
275
336
|
* Inserts or updates vectors in this index
|
|
276
337
|
* Convenience method that automatically includes bucket and index names
|
|
277
338
|
*
|
|
278
|
-
* **
|
|
339
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
279
340
|
*
|
|
341
|
+
* @category Vector Buckets
|
|
280
342
|
* @param options - Vector insertion options (bucket and index names automatically set)
|
|
281
343
|
* @returns Promise with empty response on success or error
|
|
282
344
|
*
|
|
@@ -303,11 +365,15 @@ class VectorIndexScope extends VectorDataApi_1.default {
|
|
|
303
365
|
});
|
|
304
366
|
}
|
|
305
367
|
/**
|
|
368
|
+
*
|
|
369
|
+
* @alpha
|
|
370
|
+
*
|
|
306
371
|
* Retrieves vectors by keys from this index
|
|
307
372
|
* Convenience method that automatically includes bucket and index names
|
|
308
373
|
*
|
|
309
|
-
* **
|
|
374
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
310
375
|
*
|
|
376
|
+
* @category Vector Buckets
|
|
311
377
|
* @param options - Vector retrieval options (bucket and index names automatically set)
|
|
312
378
|
* @returns Promise with array of vectors or error
|
|
313
379
|
*
|
|
@@ -329,11 +395,15 @@ class VectorIndexScope extends VectorDataApi_1.default {
|
|
|
329
395
|
});
|
|
330
396
|
}
|
|
331
397
|
/**
|
|
398
|
+
*
|
|
399
|
+
* @alpha
|
|
400
|
+
*
|
|
332
401
|
* Lists vectors in this index with pagination
|
|
333
402
|
* Convenience method that automatically includes bucket and index names
|
|
334
403
|
*
|
|
335
|
-
* **
|
|
404
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
336
405
|
*
|
|
406
|
+
* @category Vector Buckets
|
|
337
407
|
* @param options - Listing options (bucket and index names automatically set)
|
|
338
408
|
* @returns Promise with array of vectors and pagination token
|
|
339
409
|
*
|
|
@@ -355,11 +425,15 @@ class VectorIndexScope extends VectorDataApi_1.default {
|
|
|
355
425
|
});
|
|
356
426
|
}
|
|
357
427
|
/**
|
|
428
|
+
*
|
|
429
|
+
* @alpha
|
|
430
|
+
*
|
|
358
431
|
* Queries for similar vectors in this index
|
|
359
432
|
* Convenience method that automatically includes bucket and index names
|
|
360
433
|
*
|
|
361
|
-
* **
|
|
434
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
362
435
|
*
|
|
436
|
+
* @category Vector Buckets
|
|
363
437
|
* @param options - Query options (bucket and index names automatically set)
|
|
364
438
|
* @returns Promise with array of similar vectors ordered by distance
|
|
365
439
|
*
|
|
@@ -384,11 +458,15 @@ class VectorIndexScope extends VectorDataApi_1.default {
|
|
|
384
458
|
});
|
|
385
459
|
}
|
|
386
460
|
/**
|
|
461
|
+
*
|
|
462
|
+
* @alpha
|
|
463
|
+
*
|
|
387
464
|
* Deletes vectors by keys from this index
|
|
388
465
|
* Convenience method that automatically includes bucket and index names
|
|
389
466
|
*
|
|
390
|
-
* **
|
|
467
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
391
468
|
*
|
|
469
|
+
* @category Vector Buckets
|
|
392
470
|
* @param options - Deletion options (bucket and index names automatically set)
|
|
393
471
|
* @returns Promise with empty response on success or error
|
|
394
472
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"StorageVectorsClient.js","sourceRoot":"","sources":["../../../../src/lib/vectors/StorageVectorsClient.ts"],"names":[],"mappings":";;;;AAAA,8EAAqE;AACrE,4EAA2C;AAE3C,gFAA+C;
|
|
1
|
+
{"version":3,"file":"StorageVectorsClient.js","sourceRoot":"","sources":["../../../../src/lib/vectors/StorageVectorsClient.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
import { Fetch } from './fetch';
|
|
2
2
|
import { ApiResponse, VectorBucket, ListVectorBucketsOptions, ListVectorBucketsResponse } from './types';
|
|
3
3
|
/**
|
|
4
|
+
*
|
|
5
|
+
* @alpha
|
|
6
|
+
*
|
|
4
7
|
* API class for managing Vector Buckets
|
|
5
8
|
* Provides methods for creating, reading, listing, and deleting vector buckets
|
|
6
9
|
*
|
|
7
|
-
* **
|
|
10
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
8
11
|
*/
|
|
9
12
|
export default class VectorBucketApi {
|
|
10
13
|
protected url: string;
|
|
@@ -14,9 +17,14 @@ export default class VectorBucketApi {
|
|
|
14
17
|
protected fetch: Fetch;
|
|
15
18
|
protected shouldThrowOnError: boolean;
|
|
16
19
|
/**
|
|
20
|
+
*
|
|
21
|
+
* @alpha
|
|
22
|
+
*
|
|
17
23
|
* Creates a new VectorBucketApi instance
|
|
18
24
|
*
|
|
19
|
-
* **
|
|
25
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
26
|
+
*
|
|
27
|
+
* @category Vector Buckets
|
|
20
28
|
* @param url - The base URL for the storage vectors API
|
|
21
29
|
* @param headers - HTTP headers to include in requests
|
|
22
30
|
* @param fetch - Optional custom fetch implementation
|
|
@@ -30,11 +38,15 @@ export default class VectorBucketApi {
|
|
|
30
38
|
[key: string]: string;
|
|
31
39
|
}, fetch?: Fetch);
|
|
32
40
|
/**
|
|
41
|
+
*
|
|
42
|
+
* @alpha
|
|
43
|
+
*
|
|
33
44
|
* Enable throwing errors instead of returning them in the response
|
|
34
45
|
* When enabled, failed operations will throw instead of returning { data: null, error }
|
|
35
46
|
*
|
|
36
|
-
* **
|
|
47
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
37
48
|
*
|
|
49
|
+
* @category Vector Buckets
|
|
38
50
|
* @returns This instance for method chaining
|
|
39
51
|
* @example
|
|
40
52
|
* ```typescript
|
|
@@ -45,11 +57,15 @@ export default class VectorBucketApi {
|
|
|
45
57
|
*/
|
|
46
58
|
throwOnError(): this;
|
|
47
59
|
/**
|
|
60
|
+
*
|
|
61
|
+
* @alpha
|
|
62
|
+
*
|
|
48
63
|
* Creates a new vector bucket
|
|
49
64
|
* Vector buckets are containers for vector indexes and their data
|
|
50
65
|
*
|
|
51
|
-
* **
|
|
66
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
52
67
|
*
|
|
68
|
+
* @category Vector Buckets
|
|
53
69
|
* @param vectorBucketName - Unique name for the vector bucket
|
|
54
70
|
* @returns Promise with empty response on success or error
|
|
55
71
|
*
|
|
@@ -68,11 +84,15 @@ export default class VectorBucketApi {
|
|
|
68
84
|
*/
|
|
69
85
|
createBucket(vectorBucketName: string): Promise<ApiResponse<undefined>>;
|
|
70
86
|
/**
|
|
87
|
+
*
|
|
88
|
+
* @alpha
|
|
89
|
+
*
|
|
71
90
|
* Retrieves metadata for a specific vector bucket
|
|
72
91
|
* Returns bucket configuration including encryption settings and creation time
|
|
73
92
|
*
|
|
74
|
-
* **
|
|
93
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
75
94
|
*
|
|
95
|
+
* @category Vector Buckets
|
|
76
96
|
* @param vectorBucketName - Name of the vector bucket to retrieve
|
|
77
97
|
* @returns Promise with bucket metadata or error
|
|
78
98
|
*
|
|
@@ -92,11 +112,15 @@ export default class VectorBucketApi {
|
|
|
92
112
|
vectorBucket: VectorBucket;
|
|
93
113
|
}>>;
|
|
94
114
|
/**
|
|
115
|
+
*
|
|
116
|
+
* @alpha
|
|
117
|
+
*
|
|
95
118
|
* Lists vector buckets with optional filtering and pagination
|
|
96
119
|
* Supports prefix-based filtering and paginated results
|
|
97
120
|
*
|
|
98
|
-
* **
|
|
121
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
99
122
|
*
|
|
123
|
+
* @category Vector Buckets
|
|
100
124
|
* @param options - Listing options
|
|
101
125
|
* @param options.prefix - Filter buckets by name prefix
|
|
102
126
|
* @param options.maxResults - Maximum results per page (default: 100)
|
|
@@ -121,11 +145,15 @@ export default class VectorBucketApi {
|
|
|
121
145
|
*/
|
|
122
146
|
listBuckets(options?: ListVectorBucketsOptions): Promise<ApiResponse<ListVectorBucketsResponse>>;
|
|
123
147
|
/**
|
|
148
|
+
*
|
|
149
|
+
* @alpha
|
|
150
|
+
*
|
|
124
151
|
* Deletes a vector bucket
|
|
125
152
|
* Bucket must be empty before deletion (all indexes must be removed first)
|
|
126
153
|
*
|
|
127
|
-
* **
|
|
154
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
128
155
|
*
|
|
156
|
+
* @category Vector Buckets
|
|
129
157
|
* @param vectorBucketName - Name of the vector bucket to delete
|
|
130
158
|
* @returns Promise with empty response on success or error
|
|
131
159
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"VectorBucketApi.d.ts","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorBucketApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAQ,MAAM,SAAS,CAAA;AAErC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,SAAS,CAAA;AAEhB
|
|
1
|
+
{"version":3,"file":"VectorBucketApi.d.ts","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorBucketApi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAQ,MAAM,SAAS,CAAA;AAErC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,SAAS,CAAA;AAEhB;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IAC5C,SAAS,CAAC,KAAK,EAAE,KAAK,CAAA;IACtB,SAAS,CAAC,kBAAkB,UAAQ;IAEpC;;;;;;;;;;;;;;;;;OAiBG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAM/E;;;;;;;;;;;;;;;;;OAiBG;IACI,YAAY,IAAI,IAAI;IAK3B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAoB7E;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,YAAY,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IAoB/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,WAAW,CACf,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAiBlD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;CAmB9E"}
|
|
@@ -6,16 +6,24 @@ const errors_1 = require("./errors");
|
|
|
6
6
|
const fetch_1 = require("./fetch");
|
|
7
7
|
const helpers_1 = require("./helpers");
|
|
8
8
|
/**
|
|
9
|
+
*
|
|
10
|
+
* @alpha
|
|
11
|
+
*
|
|
9
12
|
* API class for managing Vector Buckets
|
|
10
13
|
* Provides methods for creating, reading, listing, and deleting vector buckets
|
|
11
14
|
*
|
|
12
|
-
* **
|
|
15
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
13
16
|
*/
|
|
14
17
|
class VectorBucketApi {
|
|
15
18
|
/**
|
|
19
|
+
*
|
|
20
|
+
* @alpha
|
|
21
|
+
*
|
|
16
22
|
* Creates a new VectorBucketApi instance
|
|
17
23
|
*
|
|
18
|
-
* **
|
|
24
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
25
|
+
*
|
|
26
|
+
* @category Vector Buckets
|
|
19
27
|
* @param url - The base URL for the storage vectors API
|
|
20
28
|
* @param headers - HTTP headers to include in requests
|
|
21
29
|
* @param fetch - Optional custom fetch implementation
|
|
@@ -32,11 +40,15 @@ class VectorBucketApi {
|
|
|
32
40
|
this.fetch = (0, helpers_1.resolveFetch)(fetch);
|
|
33
41
|
}
|
|
34
42
|
/**
|
|
43
|
+
*
|
|
44
|
+
* @alpha
|
|
45
|
+
*
|
|
35
46
|
* Enable throwing errors instead of returning them in the response
|
|
36
47
|
* When enabled, failed operations will throw instead of returning { data: null, error }
|
|
37
48
|
*
|
|
38
|
-
* **
|
|
49
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
39
50
|
*
|
|
51
|
+
* @category Vector Buckets
|
|
40
52
|
* @returns This instance for method chaining
|
|
41
53
|
* @example
|
|
42
54
|
* ```typescript
|
|
@@ -50,11 +62,15 @@ class VectorBucketApi {
|
|
|
50
62
|
return this;
|
|
51
63
|
}
|
|
52
64
|
/**
|
|
65
|
+
*
|
|
66
|
+
* @alpha
|
|
67
|
+
*
|
|
53
68
|
* Creates a new vector bucket
|
|
54
69
|
* Vector buckets are containers for vector indexes and their data
|
|
55
70
|
*
|
|
56
|
-
* **
|
|
71
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
57
72
|
*
|
|
73
|
+
* @category Vector Buckets
|
|
58
74
|
* @param vectorBucketName - Unique name for the vector bucket
|
|
59
75
|
* @returns Promise with empty response on success or error
|
|
60
76
|
*
|
|
@@ -89,11 +105,15 @@ class VectorBucketApi {
|
|
|
89
105
|
});
|
|
90
106
|
}
|
|
91
107
|
/**
|
|
108
|
+
*
|
|
109
|
+
* @alpha
|
|
110
|
+
*
|
|
92
111
|
* Retrieves metadata for a specific vector bucket
|
|
93
112
|
* Returns bucket configuration including encryption settings and creation time
|
|
94
113
|
*
|
|
95
|
-
* **
|
|
114
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
96
115
|
*
|
|
116
|
+
* @category Vector Buckets
|
|
97
117
|
* @param vectorBucketName - Name of the vector bucket to retrieve
|
|
98
118
|
* @returns Promise with bucket metadata or error
|
|
99
119
|
*
|
|
@@ -127,11 +147,15 @@ class VectorBucketApi {
|
|
|
127
147
|
});
|
|
128
148
|
}
|
|
129
149
|
/**
|
|
150
|
+
*
|
|
151
|
+
* @alpha
|
|
152
|
+
*
|
|
130
153
|
* Lists vector buckets with optional filtering and pagination
|
|
131
154
|
* Supports prefix-based filtering and paginated results
|
|
132
155
|
*
|
|
133
|
-
* **
|
|
156
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
134
157
|
*
|
|
158
|
+
* @category Vector Buckets
|
|
135
159
|
* @param options - Listing options
|
|
136
160
|
* @param options.prefix - Filter buckets by name prefix
|
|
137
161
|
* @param options.maxResults - Maximum results per page (default: 100)
|
|
@@ -174,11 +198,15 @@ class VectorBucketApi {
|
|
|
174
198
|
});
|
|
175
199
|
}
|
|
176
200
|
/**
|
|
201
|
+
*
|
|
202
|
+
* @alpha
|
|
203
|
+
*
|
|
177
204
|
* Deletes a vector bucket
|
|
178
205
|
* Bucket must be empty before deletion (all indexes must be removed first)
|
|
179
206
|
*
|
|
180
|
-
* **
|
|
207
|
+
* **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
|
|
181
208
|
*
|
|
209
|
+
* @category Vector Buckets
|
|
182
210
|
* @param vectorBucketName - Name of the vector bucket to delete
|
|
183
211
|
* @returns Promise with empty response on success or error
|
|
184
212
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"VectorBucketApi.js","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorBucketApi.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAC7C,qCAAgD;AAChD,mCAAqC;AACrC,uCAAwC;AAQxC
|
|
1
|
+
{"version":3,"file":"VectorBucketApi.js","sourceRoot":"","sources":["../../../../src/lib/vectors/VectorBucketApi.ts"],"names":[],"mappings":"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"}
|