@firebase/storage 0.7.0 → 0.7.1-2022028193537

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 (44) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/dist/compat/cjs/compat/reference.d.ts +4 -4
  3. package/dist/compat/cjs/exp/api.d.ts +26 -25
  4. package/dist/compat/cjs/exp/public-types.d.ts +1 -1
  5. package/dist/compat/cjs/index.js +4 -4
  6. package/dist/compat/cjs/index.js.map +1 -1
  7. package/dist/compat/cjs/src/reference.d.ts +4 -4
  8. package/dist/compat/esm2017/compat/reference.d.ts +4 -4
  9. package/dist/compat/esm2017/exp/api.d.ts +26 -25
  10. package/dist/compat/esm2017/exp/public-types.d.ts +1 -1
  11. package/dist/compat/esm2017/index.js +4 -4
  12. package/dist/compat/esm2017/index.js.map +1 -1
  13. package/dist/compat/esm2017/src/reference.d.ts +4 -4
  14. package/dist/compat/esm5/compat/reference.d.ts +4 -4
  15. package/dist/compat/esm5/exp/api.d.ts +26 -25
  16. package/dist/compat/esm5/exp/public-types.d.ts +1 -1
  17. package/dist/compat/esm5/index.js +4 -4
  18. package/dist/compat/esm5/index.js.map +1 -1
  19. package/dist/compat/esm5/src/reference.d.ts +4 -4
  20. package/dist/compat/reference.d.ts +4 -4
  21. package/dist/exp/api.d.ts +26 -25
  22. package/dist/exp/public-types.d.ts +1 -1
  23. package/dist/index.browser.cjs.js +26 -25
  24. package/dist/index.browser.cjs.js.map +1 -1
  25. package/dist/index.browser.esm.js +26 -25
  26. package/dist/index.browser.esm.js.map +1 -1
  27. package/dist/index.browser.esm2017.js +26 -25
  28. package/dist/index.browser.esm2017.js.map +1 -1
  29. package/dist/index.node.cjs.js +26 -25
  30. package/dist/index.node.cjs.js.map +1 -1
  31. package/dist/src/reference.d.ts +4 -4
  32. package/exp/dist/compat/reference.d.ts +4 -4
  33. package/exp/dist/exp/api.d.ts +26 -25
  34. package/exp/dist/exp/public-types.d.ts +1 -1
  35. package/exp/dist/index.browser.esm2017.js +25 -24
  36. package/exp/dist/index.browser.esm2017.js.map +1 -1
  37. package/exp/dist/index.browser.esm5.js +25 -24
  38. package/exp/dist/index.browser.esm5.js.map +1 -1
  39. package/exp/dist/index.node.cjs.js +25 -24
  40. package/exp/dist/index.node.cjs.js.map +1 -1
  41. package/exp/dist/src/reference.d.ts +4 -4
  42. package/exp/dist/storage-public.d.ts +27 -26
  43. package/exp/dist/storage.d.ts +27 -26
  44. package/package.json +2 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  #Unreleased
2
2
 
3
+ ## 0.7.1-2022028193537
4
+
5
+ ### Patch Changes
6
+
7
+ - [`2afff2b61`](https://github.com/firebase/firebase-js-sdk/commit/2afff2b61432561e7beffefb650c506522790f13) [#5948](https://github.com/firebase/firebase-js-sdk/pull/5948) - Update node-fetch version
8
+
3
9
  ## 0.7.0
4
10
 
5
11
  ### Minor Changes
@@ -93,7 +93,7 @@ export declare class ReferenceCompat implements types.Reference, Compat<StorageR
93
93
  */
94
94
  list(options?: types.ListOptions | null): Promise<types.ListResult>;
95
95
  /**
96
- * A promise that resolves with the metadata for this object. If this
96
+ * A `Promise` that resolves with the metadata for this object. If this
97
97
  * object doesn't exist or metadata cannot be retreived, the promise is
98
98
  * rejected.
99
99
  */
@@ -103,19 +103,19 @@ export declare class ReferenceCompat implements types.Reference, Compat<StorageR
103
103
  * @param metadata - The new metadata for the object.
104
104
  * Only values that have been explicitly set will be changed. Explicitly
105
105
  * setting a value to null will remove the metadata.
106
- * @returns A promise that resolves
106
+ * @returns A `Promise` that resolves
107
107
  * with the new metadata for this object.
108
108
  * @see firebaseStorage.Reference.prototype.getMetadata
109
109
  */
110
110
  updateMetadata(metadata: types.SettableMetadata): Promise<types.FullMetadata>;
111
111
  /**
112
- * @returns A promise that resolves with the download
112
+ * @returns A `Promise` that resolves with the download
113
113
  * URL for this object.
114
114
  */
115
115
  getDownloadURL(): Promise<string>;
116
116
  /**
117
117
  * Deletes the object at this location.
118
- * @returns A promise that resolves if the deletion succeeds.
118
+ * @returns A `Promise` that resolves if the deletion succeeds.
119
119
  */
120
120
  delete(): Promise<void>;
121
121
  private _throwIfRoot;
@@ -58,21 +58,21 @@ export declare function uploadString(ref: StorageReference, value: string, forma
58
58
  */
59
59
  export declare function uploadBytesResumable(ref: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: UploadMetadata): UploadTask;
60
60
  /**
61
- * A promise that resolves with the metadata for this object. If this
61
+ * A `Promise` that resolves with the metadata for this object. If this
62
62
  * object doesn't exist or metadata cannot be retreived, the promise is
63
63
  * rejected.
64
64
  * @public
65
- * @param ref - StorageReference to get metadata from.
65
+ * @param ref - {@link StorageReference} to get metadata from.
66
66
  */
67
67
  export declare function getMetadata(ref: StorageReference): Promise<FullMetadata>;
68
68
  /**
69
69
  * Updates the metadata for this object.
70
70
  * @public
71
- * @param ref - StorageReference to update metadata for.
71
+ * @param ref - {@link StorageReference} to update metadata for.
72
72
  * @param metadata - The new metadata for the object.
73
73
  * Only values that have been explicitly set will be changed. Explicitly
74
74
  * setting a value to null will remove the metadata.
75
- * @returns A promise that resolves with the new metadata for this object.
75
+ * @returns A `Promise` that resolves with the new metadata for this object.
76
76
  */
77
77
  export declare function updateMetadata(ref: StorageReference, metadata: SettableMetadata): Promise<FullMetadata>;
78
78
  /**
@@ -90,9 +90,9 @@ export declare function updateMetadata(ref: StorageReference, metadata: Settable
90
90
  * list() may fail if there are too many unsupported objects in the bucket.
91
91
  * @public
92
92
  *
93
- * @param ref - StorageReference to get list from.
94
- * @param options - See ListOptions for details.
95
- * @returns A Promise that resolves with the items and prefixes.
93
+ * @param ref - {@link StorageReference} to get list from.
94
+ * @param options - See {@link ListOptions} for details.
95
+ * @returns A `Promise` that resolves with the items and prefixes.
96
96
  * `prefixes` contains references to sub-folders and `items`
97
97
  * contains references to objects in this folder. `nextPageToken`
98
98
  * can be used to get the rest of the results.
@@ -107,44 +107,45 @@ export declare function list(ref: StorageReference, options?: ListOptions): Prom
107
107
  * Note: The results may not be consistent if objects are changed while this
108
108
  * operation is running.
109
109
  *
110
- * Warning: listAll may potentially consume too many resources if there are
110
+ * Warning: `listAll` may potentially consume too many resources if there are
111
111
  * too many results.
112
112
  * @public
113
- * @param ref - StorageReference to get list from.
113
+ * @param ref - {@link StorageReference} to get list from.
114
114
  *
115
- * @returns A Promise that resolves with all the items and prefixes under
115
+ * @returns A `Promise` that resolves with all the items and prefixes under
116
116
  * the current storage reference. `prefixes` contains references to
117
117
  * sub-directories and `items` contains references to objects in this
118
118
  * folder. `nextPageToken` is never returned.
119
119
  */
120
120
  export declare function listAll(ref: StorageReference): Promise<ListResult>;
121
121
  /**
122
- * Returns the download URL for the given Reference.
122
+ * Returns the download URL for the given {@link StorageReference}.
123
123
  * @public
124
- * @returns A promise that resolves with the download
124
+ * @param ref - {@link StorageReference} to get the download URL for.
125
+ * @returns A `Promise` that resolves with the download
125
126
  * URL for this object.
126
127
  */
127
128
  export declare function getDownloadURL(ref: StorageReference): Promise<string>;
128
129
  /**
129
130
  * Deletes the object at this location.
130
131
  * @public
131
- * @param ref - StorageReference for object to delete.
132
- * @returns A promise that resolves if the deletion succeeds.
132
+ * @param ref - {@link StorageReference} for object to delete.
133
+ * @returns A `Promise` that resolves if the deletion succeeds.
133
134
  */
134
135
  export declare function deleteObject(ref: StorageReference): Promise<void>;
135
136
  /**
136
- * Returns a StorageReference for the given url.
137
- * @param storage - `StorageService` instance.
137
+ * Returns a {@link StorageReference} for the given url.
138
+ * @param storage - {@link FirebaseStorage} instance.
138
139
  * @param url - URL. If empty, returns root reference.
139
140
  * @public
140
141
  */
141
142
  export declare function ref(storage: FirebaseStorage, url?: string): StorageReference;
142
143
  /**
143
- * Returns a StorageReference for the given path in the
144
+ * Returns a {@link StorageReference} for the given path in the
144
145
  * default bucket.
145
- * @param storageOrRef - `StorageService` or `StorageReference`.
146
- * @param pathOrUrlStorage - path. If empty, returns root reference (if Storage
147
- * instance provided) or returns same reference (if Reference provided).
146
+ * @param storageOrRef - {@link FirebaseStorage} or {@link StorageReference}.
147
+ * @param pathOrUrlStorage - path. If empty, returns root reference (if {@link FirebaseStorage}
148
+ * instance provided) or returns same reference (if {@link StorageReference} provided).
148
149
  * @public
149
150
  */
150
151
  export declare function ref(storageOrRef: FirebaseStorage | StorageReference, path?: string): StorageReference;
@@ -154,18 +155,18 @@ export declare function ref(storageOrRef: FirebaseStorage | StorageReference, pa
154
155
  export declare function _getChild(ref: StorageReference, childPath: string): Reference;
155
156
  export { StringFormat } from '../src/implementation/string';
156
157
  /**
157
- * Gets a Firebase StorageService instance for the given Firebase app.
158
+ * Gets a {@link FirebaseStorage} instance for the given Firebase app.
158
159
  * @public
159
- * @param app - Firebase app to get Storage instance for.
160
+ * @param app - Firebase app to get {@link FirebaseStorage} instance for.
160
161
  * @param bucketUrl - The gs:// url to your Firebase Storage Bucket.
161
162
  * If not passed, uses the app's default Storage Bucket.
162
- * @returns A Firebase StorageService instance.
163
+ * @returns A {@link FirebaseStorage} instance.
163
164
  */
164
165
  export declare function getStorage(app?: FirebaseApp, bucketUrl?: string): FirebaseStorage;
165
166
  /**
166
- * Modify this `StorageService` instance to communicate with the Cloud Storage emulator.
167
+ * Modify this {@link FirebaseStorage} instance to communicate with the Cloud Storage emulator.
167
168
  *
168
- * @param storage - The `StorageService` instance
169
+ * @param storage - The {@link FirebaseStorage} instance
169
170
  * @param host - The emulator host (ex: localhost)
170
171
  * @param port - The emulator port (ex: 5001)
171
172
  * @param options.mockUserToken - the mock auth token to use for unit testing Security Rules.
@@ -65,7 +65,7 @@ export interface StorageReference {
65
65
  */
66
66
  name: string;
67
67
  /**
68
- * The StorageService associated with this reference.
68
+ * The {@link FirebaseStorage} instance associated with this reference.
69
69
  */
70
70
  storage: FirebaseStorage;
71
71
  /**
@@ -733,7 +733,7 @@ var ReferenceCompat = /** @class */ (function () {
733
733
  return storage.list(this._delegate, options || undefined).then(function (r) { return new ListResultCompat(r, _this.storage); });
734
734
  };
735
735
  /**
736
- * A promise that resolves with the metadata for this object. If this
736
+ * A `Promise` that resolves with the metadata for this object. If this
737
737
  * object doesn't exist or metadata cannot be retreived, the promise is
738
738
  * rejected.
739
739
  */
@@ -745,7 +745,7 @@ var ReferenceCompat = /** @class */ (function () {
745
745
  * @param metadata - The new metadata for the object.
746
746
  * Only values that have been explicitly set will be changed. Explicitly
747
747
  * setting a value to null will remove the metadata.
748
- * @returns A promise that resolves
748
+ * @returns A `Promise` that resolves
749
749
  * with the new metadata for this object.
750
750
  * @see firebaseStorage.Reference.prototype.getMetadata
751
751
  */
@@ -753,7 +753,7 @@ var ReferenceCompat = /** @class */ (function () {
753
753
  return storage.updateMetadata(this._delegate, metadata);
754
754
  };
755
755
  /**
756
- * @returns A promise that resolves with the download
756
+ * @returns A `Promise` that resolves with the download
757
757
  * URL for this object.
758
758
  */
759
759
  ReferenceCompat.prototype.getDownloadURL = function () {
@@ -761,7 +761,7 @@ var ReferenceCompat = /** @class */ (function () {
761
761
  };
762
762
  /**
763
763
  * Deletes the object at this location.
764
- * @returns A promise that resolves if the deletion succeeds.
764
+ * @returns A `Promise` that resolves if the deletion succeeds.
765
765
  */
766
766
  ReferenceCompat.prototype.delete = function () {
767
767
  this._throwIfRoot('delete');