Added comments and fixed typings

Author: maneesht

packages/firebase/compat/index.d.ts

@@ -8017,11 +8017,61 @@ declare namespace firebase.storage {
     md5Hash?: string | null;
   }
 
+  /**
+   * @public
+   * Error codes that can be attached to `StorageError`s.
+   */
+  export enum StorageErrorCode {
+    UNKNOWN = 'unknown',
+    OBJECT_NOT_FOUND = 'object-not-found',
+    BUCKET_NOT_FOUND = 'bucket-not-found',
+    PROJECT_NOT_FOUND = 'project-not-found',
+    QUOTA_EXCEEDED = 'quota-exceeded',
+    UNAUTHENTICATED = 'unauthenticated',
+    UNAUTHORIZED = 'unauthorized',
+    UNAUTHORIZED_APP = 'unauthorized-app',
+    RETRY_LIMIT_EXCEEDED = 'retry-limit-exceeded',
+    INVALID_CHECKSUM = 'invalid-checksum',
+    CANCELED = 'canceled',
+    INVALID_EVENT_NAME = 'invalid-event-name',
+    INVALID_URL = 'invalid-url',
+    INVALID_DEFAULT_BUCKET = 'invalid-default-bucket',
+    NO_DEFAULT_BUCKET = 'no-default-bucket',
+    CANNOT_SLICE_BLOB = 'cannot-slice-blob',
+    SERVER_FILE_WRONG_SIZE = 'server-file-wrong-size',
+    NO_DOWNLOAD_URL = 'no-download-url',
+    INVALID_ARGUMENT = 'invalid-argument',
+    INVALID_ARGUMENT_COUNT = 'invalid-argument-count',
+    APP_DELETED = 'app-deleted',
+    INVALID_ROOT_OPERATION = 'invalid-root-operation',
+    INVALID_FORMAT = 'invalid-format',
+    INTERNAL_ERROR = 'internal-error',
+    UNSUPPORTED_ENVIRONMENT = 'unsupported-environment'
+  }
+
   /**
    * An error returned by the Firebase Storage SDK.
+   * @public
    */
-  interface FirebaseStorageError extends FirebaseError {
-    serverResponse: string | null;
+  export interface FirebaseStorageError extends FirebaseError {
+    /**
+     * Stores custom error data unque to StorageError.
+     */
+    customData: {
+      serverResponse: string | null;
+    };
+
+    get status(): number;
+    set status(status: number);
+    /**
+     * Compares a StorageErrorCode against this error's code, filtering out the prefix.
+     */
+    _codeEquals(code: StorageErrorCode): boolean;
+    /**
+     * Optional response message that was added by the server.
+     */
+    get serverResponse(): null | string;
+    set serverResponse(serverResponse: string | null);
   }
 
   interface StorageObserver<T> {

packages/storage-types/index.d.ts

@@ -96,6 +96,7 @@ export interface StorageObserver<T> {
   error?: (error: FirebaseStorageError) => void | null;
   complete?: CompleteFn | null;
 }
+
 export enum StorageErrorCode {
   UNKNOWN = 'unknown',
   OBJECT_NOT_FOUND = 'object-not-found',
@@ -123,6 +124,7 @@ export enum StorageErrorCode {
   INTERNAL_ERROR = 'internal-error',
   UNSUPPORTED_ENVIRONMENT = 'unsupported-environment'
 }
+
 export interface FirebaseStorageError extends FirebaseError {
   /**
    * Stores custom error data unque to StorageError.