@supabase/storage-js 2.84.1-canary.1 → 2.85.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.
Files changed (40) hide show
  1. package/README.md +10 -7
  2. package/dist/main/lib/vectors/StorageVectorsClient.d.ts +108 -14
  3. package/dist/main/lib/vectors/StorageVectorsClient.d.ts.map +1 -1
  4. package/dist/main/lib/vectors/StorageVectorsClient.js +124 -4
  5. package/dist/main/lib/vectors/StorageVectorsClient.js.map +1 -1
  6. package/dist/main/lib/version.d.ts +1 -1
  7. package/dist/main/lib/version.d.ts.map +1 -1
  8. package/dist/main/lib/version.js +1 -1
  9. package/dist/main/lib/version.js.map +1 -1
  10. package/dist/main/packages/StorageAnalyticsClient.d.ts +5 -5
  11. package/dist/main/packages/StorageAnalyticsClient.d.ts.map +1 -1
  12. package/dist/main/packages/StorageAnalyticsClient.js +4 -4
  13. package/dist/main/packages/StorageBucketApi.d.ts +4 -4
  14. package/dist/main/packages/StorageBucketApi.js +4 -4
  15. package/dist/main/packages/StorageFileApi.d.ts +12 -12
  16. package/dist/main/packages/StorageFileApi.js +12 -12
  17. package/dist/module/lib/vectors/StorageVectorsClient.d.ts +108 -14
  18. package/dist/module/lib/vectors/StorageVectorsClient.d.ts.map +1 -1
  19. package/dist/module/lib/vectors/StorageVectorsClient.js +124 -4
  20. package/dist/module/lib/vectors/StorageVectorsClient.js.map +1 -1
  21. package/dist/module/lib/version.d.ts +1 -1
  22. package/dist/module/lib/version.d.ts.map +1 -1
  23. package/dist/module/lib/version.js +1 -1
  24. package/dist/module/lib/version.js.map +1 -1
  25. package/dist/module/packages/StorageAnalyticsClient.d.ts +5 -5
  26. package/dist/module/packages/StorageAnalyticsClient.d.ts.map +1 -1
  27. package/dist/module/packages/StorageAnalyticsClient.js +4 -4
  28. package/dist/module/packages/StorageBucketApi.d.ts +4 -4
  29. package/dist/module/packages/StorageBucketApi.js +4 -4
  30. package/dist/module/packages/StorageFileApi.d.ts +12 -12
  31. package/dist/module/packages/StorageFileApi.js +12 -12
  32. package/dist/tsconfig.module.tsbuildinfo +1 -1
  33. package/dist/tsconfig.tsbuildinfo +1 -1
  34. package/dist/umd/supabase.js +1 -1
  35. package/package.json +1 -1
  36. package/src/lib/vectors/StorageVectorsClient.ts +114 -4
  37. package/src/lib/version.ts +1 -1
  38. package/src/packages/StorageAnalyticsClient.ts +5 -5
  39. package/src/packages/StorageBucketApi.ts +4 -4
  40. package/src/packages/StorageFileApi.ts +12 -12
@@ -54,7 +54,7 @@ export default class StorageAnalyticsClient {
54
54
  *
55
55
  * @category Analytics Buckets
56
56
  * @param name A unique name for the bucket you are creating
57
- * @returns Promise with newly created bucket name or error
57
+ * @returns Promise with response containing newly created analytics bucket or error
58
58
  *
59
59
  * @example Create analytics bucket
60
60
  * ```js
@@ -97,10 +97,10 @@ export default class StorageAnalyticsClient {
97
97
  * @param options Query parameters for listing buckets
98
98
  * @param options.limit Maximum number of buckets to return
99
99
  * @param options.offset Number of buckets to skip
100
- * @param options.sortColumn Column to sort by ('id', 'name', 'created_at', 'updated_at')
100
+ * @param options.sortColumn Column to sort by ('name', 'created_at', 'updated_at')
101
101
  * @param options.sortOrder Sort order ('asc' or 'desc')
102
102
  * @param options.search Search term to filter bucket names
103
- * @returns Promise with list of analytics buckets or error
103
+ * @returns Promise with response containing array of analytics buckets or error
104
104
  *
105
105
  * @example List analytics buckets
106
106
  * ```js
@@ -134,7 +134,7 @@ export default class StorageAnalyticsClient {
134
134
  listBuckets(options?: {
135
135
  limit?: number;
136
136
  offset?: number;
137
- sortColumn?: 'id' | 'name' | 'created_at' | 'updated_at';
137
+ sortColumn?: 'name' | 'created_at' | 'updated_at';
138
138
  sortOrder?: 'asc' | 'desc';
139
139
  search?: string;
140
140
  }): Promise<{
@@ -155,7 +155,7 @@ export default class StorageAnalyticsClient {
155
155
  *
156
156
  * @category Analytics Buckets
157
157
  * @param bucketName The unique identifier of the bucket you would like to delete
158
- * @returns Promise with success message or error
158
+ * @returns Promise with response containing success message or error
159
159
  *
160
160
  * @example Delete analytics bucket
161
161
  * ```js
@@ -1 +1 @@
1
- {"version":3,"file":"StorageAnalyticsClient.d.ts","sourceRoot":"","sources":["../../../src/packages/StorageAnalyticsClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAqB,MAAM,cAAc,CAAA;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAsB;IACzC,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;;;;;;;;;;;;;;;;OAgBG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAM/E;;;;;;;;;;OAUG;IACI,YAAY,IAAI,IAAI;IAK3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CACrC;QACE,IAAI,EAAE,cAAc,CAAA;QACpB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,YAAY,GAAG,YAAY,CAAA;QACxD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CACP;QACE,IAAI,EAAE,cAAc,EAAE,CAAA;QACtB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAC3C;QACE,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;QACzB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;CAoBF"}
1
+ {"version":3,"file":"StorageAnalyticsClient.d.ts","sourceRoot":"","sources":["../../../src/packages/StorageAnalyticsClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAqB,MAAM,cAAc,CAAA;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAsB;IACzC,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;;;;;;;;;;;;;;;;OAgBG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAM/E;;;;;;;;;;OAUG;IACI,YAAY,IAAI,IAAI;IAK3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CACrC;QACE,IAAI,EAAE,cAAc,CAAA;QACpB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAAA;QACjD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CACP;QACE,IAAI,EAAE,cAAc,EAAE,CAAA;QACtB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAC3C;QACE,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;QACzB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;CAoBF"}
@@ -56,7 +56,7 @@ export default class StorageAnalyticsClient {
56
56
  *
57
57
  * @category Analytics Buckets
58
58
  * @param name A unique name for the bucket you are creating
59
- * @returns Promise with newly created bucket name or error
59
+ * @returns Promise with response containing newly created analytics bucket or error
60
60
  *
61
61
  * @example Create analytics bucket
62
62
  * ```js
@@ -109,10 +109,10 @@ export default class StorageAnalyticsClient {
109
109
  * @param options Query parameters for listing buckets
110
110
  * @param options.limit Maximum number of buckets to return
111
111
  * @param options.offset Number of buckets to skip
112
- * @param options.sortColumn Column to sort by ('id', 'name', 'created_at', 'updated_at')
112
+ * @param options.sortColumn Column to sort by ('name', 'created_at', 'updated_at')
113
113
  * @param options.sortOrder Sort order ('asc' or 'desc')
114
114
  * @param options.search Search term to filter bucket names
115
- * @returns Promise with list of analytics buckets or error
115
+ * @returns Promise with response containing array of analytics buckets or error
116
116
  *
117
117
  * @example List analytics buckets
118
118
  * ```js
@@ -185,7 +185,7 @@ export default class StorageAnalyticsClient {
185
185
  *
186
186
  * @category Analytics Buckets
187
187
  * @param bucketName The unique identifier of the bucket you would like to delete
188
- * @returns Promise with success message or error
188
+ * @returns Promise with response containing success message or error
189
189
  *
190
190
  * @example Delete analytics bucket
191
191
  * ```js
@@ -28,7 +28,7 @@ export default class StorageBucketApi {
28
28
  * @param options.sortColumn Column to sort by ('id', 'name', 'created_at', 'updated_at')
29
29
  * @param options.sortOrder Sort order ('asc' or 'desc')
30
30
  * @param options.search Search term to filter bucket names
31
- * @returns Promise with list of buckets or error
31
+ * @returns Promise with response containing array of buckets or error
32
32
  *
33
33
  * @example List buckets
34
34
  * ```js
@@ -62,7 +62,7 @@ export default class StorageBucketApi {
62
62
  *
63
63
  * @category File Buckets
64
64
  * @param id The unique identifier of the bucket you would like to retrieve.
65
- * @returns Promise with bucket details or error
65
+ * @returns Promise with response containing bucket details or error
66
66
  *
67
67
  * @example Get bucket
68
68
  * ```js
@@ -111,7 +111,7 @@ export default class StorageBucketApi {
111
111
  * Each mime type specified can be a wildcard, e.g. image/*, or a specific mime type, e.g. image/png.
112
112
  * @param options.type (private-beta) specifies the bucket type. see `BucketType` for more details.
113
113
  * - default bucket type is `STANDARD`
114
- * @returns Promise with newly created bucket id or error
114
+ * @returns Promise with response containing newly created bucket name or error
115
115
  *
116
116
  * @example Create bucket
117
117
  * ```js
@@ -158,7 +158,7 @@ export default class StorageBucketApi {
158
158
  * @param options.allowedMimeTypes specifies the allowed mime types that this bucket can accept during upload.
159
159
  * The default value is null, which allows files with all mime types to be uploaded.
160
160
  * Each mime type specified can be a wildcard, e.g. image/*, or a specific mime type, e.g. image/png.
161
- * @returns Promise with success message or error
161
+ * @returns Promise with response containing success message or error
162
162
  *
163
163
  * @example Update bucket
164
164
  * ```js
@@ -38,7 +38,7 @@ export default class StorageBucketApi {
38
38
  * @param options.sortColumn Column to sort by ('id', 'name', 'created_at', 'updated_at')
39
39
  * @param options.sortOrder Sort order ('asc' or 'desc')
40
40
  * @param options.search Search term to filter bucket names
41
- * @returns Promise with list of buckets or error
41
+ * @returns Promise with response containing array of buckets or error
42
42
  *
43
43
  * @example List buckets
44
44
  * ```js
@@ -85,7 +85,7 @@ export default class StorageBucketApi {
85
85
  *
86
86
  * @category File Buckets
87
87
  * @param id The unique identifier of the bucket you would like to retrieve.
88
- * @returns Promise with bucket details or error
88
+ * @returns Promise with response containing bucket details or error
89
89
  *
90
90
  * @example Get bucket
91
91
  * ```js
@@ -144,7 +144,7 @@ export default class StorageBucketApi {
144
144
  * Each mime type specified can be a wildcard, e.g. image/*, or a specific mime type, e.g. image/png.
145
145
  * @param options.type (private-beta) specifies the bucket type. see `BucketType` for more details.
146
146
  * - default bucket type is `STANDARD`
147
- * @returns Promise with newly created bucket id or error
147
+ * @returns Promise with response containing newly created bucket name or error
148
148
  *
149
149
  * @example Create bucket
150
150
  * ```js
@@ -205,7 +205,7 @@ export default class StorageBucketApi {
205
205
  * @param options.allowedMimeTypes specifies the allowed mime types that this bucket can accept during upload.
206
206
  * The default value is null, which allows files with all mime types to be uploaded.
207
207
  * Each mime type specified can be a wildcard, e.g. image/*, or a specific mime type, e.g. image/png.
208
- * @returns Promise with success message or error
208
+ * @returns Promise with response containing success message or error
209
209
  *
210
210
  * @example Update bucket
211
211
  * ```js
@@ -35,7 +35,7 @@ export default class StorageFileApi {
35
35
  * @param path The file path, including the file name. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to upload.
36
36
  * @param fileBody The body of the file to be stored in the bucket.
37
37
  * @param fileOptions Optional file upload options including cacheControl, contentType, upsert, and metadata.
38
- * @returns Promise with file path and id or error
38
+ * @returns Promise with response containing file path, id, and fullPath or error
39
39
  *
40
40
  * @example Upload file
41
41
  * ```js
@@ -91,7 +91,7 @@ export default class StorageFileApi {
91
91
  * @param token The token generated from `createSignedUploadUrl`
92
92
  * @param fileBody The body of the file to be stored in the bucket.
93
93
  * @param fileOptions Optional file upload options including cacheControl and contentType.
94
- * @returns Promise with file path and full path or error
94
+ * @returns Promise with response containing file path and fullPath or error
95
95
  *
96
96
  * @example Upload to a signed URL
97
97
  * ```js
@@ -130,7 +130,7 @@ export default class StorageFileApi {
130
130
  * @category File Buckets
131
131
  * @param path The file path, including the current file name. For example `folder/image.png`.
132
132
  * @param options.upsert If set to true, allows the file to be overwritten if it already exists.
133
- * @returns Promise with signed upload URL, token, and path or error
133
+ * @returns Promise with response containing signed upload URL, token, and path or error
134
134
  *
135
135
  * @example Create Signed Upload URL
136
136
  * ```js
@@ -172,7 +172,7 @@ export default class StorageFileApi {
172
172
  * @param path The relative file path. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to update.
173
173
  * @param fileBody The body of the file to be stored in the bucket.
174
174
  * @param fileOptions Optional file upload options including cacheControl, contentType, upsert, and metadata.
175
- * @returns Promise with file path and id or error
175
+ * @returns Promise with response containing file path, id, and fullPath or error
176
176
  *
177
177
  * @example Update file
178
178
  * ```js
@@ -227,7 +227,7 @@ export default class StorageFileApi {
227
227
  * @param fromPath The original file path, including the current file name. For example `folder/image.png`.
228
228
  * @param toPath The new file path, including the new file name. For example `folder/image-new.png`.
229
229
  * @param options The destination options.
230
- * @returns Promise with success message or error
230
+ * @returns Promise with response containing success message or error
231
231
  *
232
232
  * @example Move file
233
233
  * ```js
@@ -263,7 +263,7 @@ export default class StorageFileApi {
263
263
  * @param fromPath The original file path, including the current file name. For example `folder/image.png`.
264
264
  * @param toPath The new file path, including the new file name. For example `folder/image-copy.png`.
265
265
  * @param options The destination options.
266
- * @returns Promise with copied file path or error
266
+ * @returns Promise with response containing copied file path or error
267
267
  *
268
268
  * @example Copy file
269
269
  * ```js
@@ -300,7 +300,7 @@ export default class StorageFileApi {
300
300
  * @param expiresIn The number of seconds until the signed URL expires. For example, `60` for a URL which is valid for one minute.
301
301
  * @param options.download triggers the file as a download if set to true. Set this parameter as the name of the file if you want to trigger the download with a different filename.
302
302
  * @param options.transform Transform the asset before serving it to the client.
303
- * @returns Promise with signed URL or error
303
+ * @returns Promise with response containing signed URL or error
304
304
  *
305
305
  * @example Create Signed URL
306
306
  * ```js
@@ -362,7 +362,7 @@ export default class StorageFileApi {
362
362
  * @param paths The file paths to be downloaded, including the current file names. For example `['folder/image.png', 'folder2/image2.png']`.
363
363
  * @param expiresIn The number of seconds until the signed URLs expire. For example, `60` for URLs which are valid for one minute.
364
364
  * @param options.download triggers the file as a download if set to true. Set this parameter as the name of the file if you want to trigger the download with a different filename.
365
- * @returns Promise with array of signed URLs or error
365
+ * @returns Promise with response containing array of objects with signedUrl, path, and error or error
366
366
  *
367
367
  * @example Create Signed URLs
368
368
  * ```js
@@ -452,7 +452,7 @@ export default class StorageFileApi {
452
452
  *
453
453
  * @category File Buckets
454
454
  * @param path The file path, including the file name. For example `folder/image.png`.
455
- * @returns Promise with file metadata or error
455
+ * @returns Promise with response containing file metadata or error
456
456
  *
457
457
  * @example Get file info
458
458
  * ```js
@@ -474,7 +474,7 @@ export default class StorageFileApi {
474
474
  *
475
475
  * @category File Buckets
476
476
  * @param path The file path, including the file name. For example `folder/image.png`.
477
- * @returns Promise with boolean indicating file existence or error
477
+ * @returns Promise with response containing boolean indicating file existence or error
478
478
  *
479
479
  * @example Check file existence
480
480
  * ```js
@@ -554,7 +554,7 @@ export default class StorageFileApi {
554
554
  *
555
555
  * @category File Buckets
556
556
  * @param paths An array of files to delete, including the path and file name. For example [`'folder/image.png'`].
557
- * @returns Promise with list of deleted files or error
557
+ * @returns Promise with response containing array of deleted file objects or error
558
558
  *
559
559
  * @example Delete file
560
560
  * ```js
@@ -595,7 +595,7 @@ export default class StorageFileApi {
595
595
  * @param path The folder path.
596
596
  * @param options Search options including limit (defaults to 100), offset, sortBy, and search
597
597
  * @param parameters Optional fetch parameters including signal for cancellation
598
- * @returns Promise with list of files or error
598
+ * @returns Promise with response containing array of files or error
599
599
  *
600
600
  * @example List files in a bucket
601
601
  * ```js
@@ -109,7 +109,7 @@ export default class StorageFileApi {
109
109
  * @param path The file path, including the file name. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to upload.
110
110
  * @param fileBody The body of the file to be stored in the bucket.
111
111
  * @param fileOptions Optional file upload options including cacheControl, contentType, upsert, and metadata.
112
- * @returns Promise with file path and id or error
112
+ * @returns Promise with response containing file path, id, and fullPath or error
113
113
  *
114
114
  * @example Upload file
115
115
  * ```js
@@ -159,7 +159,7 @@ export default class StorageFileApi {
159
159
  * @param token The token generated from `createSignedUploadUrl`
160
160
  * @param fileBody The body of the file to be stored in the bucket.
161
161
  * @param fileOptions Optional file upload options including cacheControl and contentType.
162
- * @returns Promise with file path and full path or error
162
+ * @returns Promise with response containing file path and fullPath or error
163
163
  *
164
164
  * @example Upload to a signed URL
165
165
  * ```js
@@ -229,7 +229,7 @@ export default class StorageFileApi {
229
229
  * @category File Buckets
230
230
  * @param path The file path, including the current file name. For example `folder/image.png`.
231
231
  * @param options.upsert If set to true, allows the file to be overwritten if it already exists.
232
- * @returns Promise with signed upload URL, token, and path or error
232
+ * @returns Promise with response containing signed upload URL, token, and path or error
233
233
  *
234
234
  * @example Create Signed Upload URL
235
235
  * ```js
@@ -285,7 +285,7 @@ export default class StorageFileApi {
285
285
  * @param path The relative file path. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to update.
286
286
  * @param fileBody The body of the file to be stored in the bucket.
287
287
  * @param fileOptions Optional file upload options including cacheControl, contentType, upsert, and metadata.
288
- * @returns Promise with file path and id or error
288
+ * @returns Promise with response containing file path, id, and fullPath or error
289
289
  *
290
290
  * @example Update file
291
291
  * ```js
@@ -334,7 +334,7 @@ export default class StorageFileApi {
334
334
  * @param fromPath The original file path, including the current file name. For example `folder/image.png`.
335
335
  * @param toPath The new file path, including the new file name. For example `folder/image-new.png`.
336
336
  * @param options The destination options.
337
- * @returns Promise with success message or error
337
+ * @returns Promise with response containing success message or error
338
338
  *
339
339
  * @example Move file
340
340
  * ```js
@@ -383,7 +383,7 @@ export default class StorageFileApi {
383
383
  * @param fromPath The original file path, including the current file name. For example `folder/image.png`.
384
384
  * @param toPath The new file path, including the new file name. For example `folder/image-copy.png`.
385
385
  * @param options The destination options.
386
- * @returns Promise with copied file path or error
386
+ * @returns Promise with response containing copied file path or error
387
387
  *
388
388
  * @example Copy file
389
389
  * ```js
@@ -433,7 +433,7 @@ export default class StorageFileApi {
433
433
  * @param expiresIn The number of seconds until the signed URL expires. For example, `60` for a URL which is valid for one minute.
434
434
  * @param options.download triggers the file as a download if set to true. Set this parameter as the name of the file if you want to trigger the download with a different filename.
435
435
  * @param options.transform Transform the asset before serving it to the client.
436
- * @returns Promise with signed URL or error
436
+ * @returns Promise with response containing signed URL or error
437
437
  *
438
438
  * @example Create Signed URL
439
439
  * ```js
@@ -506,7 +506,7 @@ export default class StorageFileApi {
506
506
  * @param paths The file paths to be downloaded, including the current file names. For example `['folder/image.png', 'folder2/image2.png']`.
507
507
  * @param expiresIn The number of seconds until the signed URLs expire. For example, `60` for URLs which are valid for one minute.
508
508
  * @param options.download triggers the file as a download if set to true. Set this parameter as the name of the file if you want to trigger the download with a different filename.
509
- * @returns Promise with array of signed URLs or error
509
+ * @returns Promise with response containing array of objects with signedUrl, path, and error or error
510
510
  *
511
511
  * @example Create Signed URLs
512
512
  * ```js
@@ -617,7 +617,7 @@ export default class StorageFileApi {
617
617
  *
618
618
  * @category File Buckets
619
619
  * @param path The file path, including the file name. For example `folder/image.png`.
620
- * @returns Promise with file metadata or error
620
+ * @returns Promise with response containing file metadata or error
621
621
  *
622
622
  * @example Get file info
623
623
  * ```js
@@ -652,7 +652,7 @@ export default class StorageFileApi {
652
652
  *
653
653
  * @category File Buckets
654
654
  * @param path The file path, including the file name. For example `folder/image.png`.
655
- * @returns Promise with boolean indicating file existence or error
655
+ * @returns Promise with response containing boolean indicating file existence or error
656
656
  *
657
657
  * @example Check file existence
658
658
  * ```js
@@ -763,7 +763,7 @@ export default class StorageFileApi {
763
763
  *
764
764
  * @category File Buckets
765
765
  * @param paths An array of files to delete, including the path and file name. For example [`'folder/image.png'`].
766
- * @returns Promise with list of deleted files or error
766
+ * @returns Promise with response containing array of deleted file objects or error
767
767
  *
768
768
  * @example Delete file
769
769
  * ```js
@@ -864,7 +864,7 @@ export default class StorageFileApi {
864
864
  * @param path The folder path.
865
865
  * @param options Search options including limit (defaults to 100), offset, sortBy, and search
866
866
  * @param parameters Optional fetch parameters including signal for cancellation
867
- * @returns Promise with list of files or error
867
+ * @returns Promise with response containing array of files or error
868
868
  *
869
869
  * @example List files in a bucket
870
870
  * ```js