Add documentation for an optional handleStorageChange method in StorageApi

Signed-off-by: Dawit Ameneshewa <dawitam11@gmail.com>

packages/core-app-api/api-report.md

@@ -558,6 +558,8 @@ export class WebStorage implements StorageApi {
   // (undocumented)
   get<T>(key: string): T | undefined;
   // (undocumented)
+  handleStorageChange(eventKey: StorageEvent['key']): void;
+  // (undocumented)
   observe$<T extends JsonValue>(
     key: string,
   ): Observable<StorageValueSnapshot<T>>;

packages/core-plugin-api/api-report.md

@@ -697,6 +697,7 @@ export type SignInPageProps = {
 // @public
 export interface StorageApi {
   forBucket(name: string): StorageApi;
+  handleStorageChange?(eventKey: StorageEvent['key']): void;
   observe$<T extends JsonValue>(
     key: string,
   ): Observable<StorageValueSnapshot<T>>;

packages/core-plugin-api/src/apis/definitions/StorageApi.ts

@@ -91,7 +91,7 @@ export interface StorageApi {
    *
    * @param eventKey - The key of a storage event object
    */
-  handleStorageChange(eventKey: StorageEvent['key']): void;
+  handleStorageChange?(eventKey: StorageEvent['key']): void;
 
   /**
    * Returns an immediate snapshot value for the given key, if possible.