@tinycloud/node-sdk 3.7.0-beta.2 → 3.7.0-beta.3

package/dist/index.cjs

@@ -21681,7 +21681,10 @@ var _TinyCloudNode = class _TinyCloudNode {
      * and remembers whose storage is full so sign-in and listing skip their
      * best-effort writes. Lives as long as this instance, across sign-ins.
      */
-    this.storageFull = new import_sdk_core10.StorageFullMonitor((spaceId) => spaceOwnerKey(spaceId) ?? spaceId);
+    this.storageFull = new import_sdk_core10.StorageFullMonitor(
+      (spaceId) => spaceOwnerKey(spaceId) ?? spaceId,
+      () => this.currentStorageOwner()
+    );
     this.invokeWithRuntimePermissions = (session, service, path, action, facts) => {
       const operation = {
         spaceId: session.spaceId,
@@ -21837,12 +21840,15 @@ var _TinyCloudNode = class _TinyCloudNode {
     return this._bootstrapStatus;
   }
   /**
-   * Subscribe to `storage.full`. It fires once, on the first write any
-   * service had rejected because the owner's TinyCloud storage is full
+   * Subscribe to `storage.full`. It fires on the first write any service had
+   * rejected because the owner's TinyCloud storage is full
    * (`STORAGE_QUOTA_EXCEEDED` or `STORAGE_LIMIT_REACHED`), so an app can show
-   * one read-only banner. Reads keep working. It fires again only after
-   * `storage.status()` has reported space again for every owner whose write
-   * was rejected. Returns the unsubscribe function.
+   * one read-only banner. Reads keep working. For the signed-in account's own
+   * storage it fires once per episode: the episode ends only when a write to
+   * that storage succeeds, or on sign-out. A `storage.status()` read does not
+   * end it. A rejection on another owner's delegated space fires once per
+   * owner, until that owner's `storage.status()` reports space again. Returns
+   * the unsubscribe function.
    */
   on(event, handler) {
     if (event !== "storage.full") {
@@ -21850,6 +21856,21 @@ var _TinyCloudNode = class _TinyCloudNode {
     }
     return this.storageFull.on(handler);
   }
+  /**
+   * Storage episode state for the UI mount. @internal
+   *
+   * `current()` returns the own-storage rejection that started the episode, or
+   * undefined. `subscribe` calls its listener when the own episode starts or
+   * ends; read `current()` inside it. `subscribeDelegated` calls its listener
+   * once per delegated owner found full, until that owner is cleared.
+   */
+  get storageEpisode() {
+    return {
+      current: () => this.storageFull.rejection,
+      subscribe: (listener) => this.storageFull.onEpisode(listener),
+      subscribeDelegated: (listener) => this.storageFull.onDelegated(listener)
+    };
+  }
   /** Owner key of the account the current session's own storage belongs to. */
   currentStorageOwner() {
     return spaceOwnerKey(this._serviceContext?.session?.spaceId ?? this.currentTinyCloudSession()?.spaceId);