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

package/dist/{TinyCloudNode-BHiKCQ4W.d.ts → TinyCloudNode-Cw00iiSP.d.ts}

@@ -1400,14 +1400,30 @@ declare class TinyCloudNode {
      */
     private readonly storageFull;
     /**
-     * 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: "storage.full", handler: (event: StorageFullEvent) => void): () => void;
+    /**
+     * 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(): {
+        current(): StorageFullEvent | undefined;
+        subscribe(listener: () => void): () => void;
+        subscribeDelegated(listener: () => void): () => void;
+    };
     /** Owner key of the account the current session's own storage belongs to. */
     private currentStorageOwner;
     /**
@@ -1435,6 +1451,13 @@ declare class TinyCloudNode {
     /** SIWE domain — uses config override or defaults to app.tinycloud.xyz */
     private get siweDomain();
     private readonly invokeWithRuntimePermissions;
+    /**
+     * The session (key, issuer, proof) that signs an invokeAny call for `entries`:
+     * the explicit revocation authority, else the covering non-primary runtime
+     * grant, else the caller's session. Everything that re-signs the resulting
+     * invocation must use this session's key.
+     */
+    private selectInvokeAnySession;
     private readonly invokeAnyWithRuntimePermissions;
     /**
      * Create a new TinyCloudNode instance.

package/dist/{TinyCloudNode-DrLNh4bs.d.cts → TinyCloudNode-DD7qjyLU.d.cts}

@@ -1400,14 +1400,30 @@ declare class TinyCloudNode {
      */
     private readonly storageFull;
     /**
-     * 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: "storage.full", handler: (event: StorageFullEvent) => void): () => void;
+    /**
+     * 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(): {
+        current(): StorageFullEvent | undefined;
+        subscribe(listener: () => void): () => void;
+        subscribeDelegated(listener: () => void): () => void;
+    };
     /** Owner key of the account the current session's own storage belongs to. */
     private currentStorageOwner;
     /**
@@ -1435,6 +1451,13 @@ declare class TinyCloudNode {
     /** SIWE domain — uses config override or defaults to app.tinycloud.xyz */
     private get siweDomain();
     private readonly invokeWithRuntimePermissions;
+    /**
+     * The session (key, issuer, proof) that signs an invokeAny call for `entries`:
+     * the explicit revocation authority, else the covering non-primary runtime
+     * grant, else the caller's session. Everything that re-signs the resulting
+     * invocation must use this session's key.
+     */
+    private selectInvokeAnySession;
     private readonly invokeAnyWithRuntimePermissions;
     /**
      * Create a new TinyCloudNode instance.

package/dist/{authority-BVmX2vCi.d.cts → authority-Ck5hZdBn.d.cts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-DrLNh4bs.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-DD7qjyLU.cjs';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/{authority-BHVqCPyl.d.ts → authority-DXR6887E.d.ts}

@@ -1,7 +1,7 @@
 import { ReplicationOptions, PermissionEntry, TinyCloudSession, KVReplicaStorage, ServiceContext, IWasmBindings, WasmRecapEntry } from '@tinycloud/sdk-core';
 import { ReplicaConsentAnchor, AuthorityRefusal, ReplicationAuthority } from '@tinycloud/sdk-services';
 import { ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-BHiKCQ4W.js';
+import { T as TinyCloudNode } from './TinyCloudNode-Cw00iiSP.js';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/core.cjs

@@ -3854,7 +3854,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_core11.StorageFullMonitor((spaceId) => spaceOwnerKey(spaceId) ?? spaceId);
+    this.storageFull = new import_sdk_core11.StorageFullMonitor(
+      (spaceId) => spaceOwnerKey(spaceId) ?? spaceId,
+      () => this.currentStorageOwner()
+    );
     this.invokeWithRuntimePermissions = (session, service, path, action, facts) => {
       const operation = {
         spaceId: session.spaceId,
@@ -3886,17 +3889,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         throw new Error("WASM binding does not support invokeAny");
       }
       const routedEntries = entries;
-      const operations = routedEntries.flatMap((entry) => {
-        const operation = this.operationFromInvokeAnyEntry(entry);
-        return operation ? [operation] : [];
-      });
-      const authorityCid = routedEntries.length === 1 ? routedEntries[0]?.revokeAuthorityCid : void 0;
-      const explicitGrant = authorityCid === void 0 ? void 0 : this.runtimePermissionGrants.find((grant2) => grant2.delegation.cid === authorityCid);
-      if (authorityCid !== void 0 && !explicitGrant) {
-        throw new Error(`Explicit revocation authority ${authorityCid} is not installed.`);
-      }
-      const grant = explicitGrant ?? this.findGrantForOperations(operations);
-      const invocationSession = explicitGrant ? explicitGrant.session : !grant || grant.provenance === "primary" ? session : grant.session;
+      const { session: invocationSession, grant } = this.selectInvokeAnySession(session, entries);
       const caveatPreservingEntries = routedEntries.map(({ revokeAuthorityCid: _cid, ...entry }) => {
         const requested = this.operationFromInvokeAnyEntry(entry);
         const granted = grant && requested && grant.operations.find(
@@ -4020,12 +4013,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") {
@@ -4033,6 +4029,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);
@@ -4134,6 +4145,27 @@ var _TinyCloudNode = class _TinyCloudNode {
   get siweDomain() {
     return this.config.domain ?? "app.tinycloud.xyz";
   }
+  /**
+   * The session (key, issuer, proof) that signs an invokeAny call for `entries`:
+   * the explicit revocation authority, else the covering non-primary runtime
+   * grant, else the caller's session. Everything that re-signs the resulting
+   * invocation must use this session's key.
+   */
+  selectInvokeAnySession(session, entries) {
+    const routedEntries = entries;
+    const operations = routedEntries.flatMap((entry) => {
+      const operation = this.operationFromInvokeAnyEntry(entry);
+      return operation ? [operation] : [];
+    });
+    const authorityCid = routedEntries.length === 1 ? routedEntries[0]?.revokeAuthorityCid : void 0;
+    const explicitGrant = authorityCid === void 0 ? void 0 : this.runtimePermissionGrants.find((grant2) => grant2.delegation.cid === authorityCid);
+    if (authorityCid !== void 0 && !explicitGrant) {
+      throw new Error(`Explicit revocation authority ${authorityCid} is not installed.`);
+    }
+    const grant = explicitGrant ?? this.findGrantForOperations(operations);
+    const invocationSession = explicitGrant ? explicitGrant.session : !grant || grant.provenance === "primary" ? session : grant.session;
+    return { session: invocationSession, grant };
+  }
   /**
    * SharingService for receive-only access (no session required), bound to the
    * current service graph. This lets session-only users receive sharing links
@@ -6553,7 +6585,13 @@ var _TinyCloudNode = class _TinyCloudNode {
   async bindInvocationAudience(authorization, audience) {
     const session = this.currentTinyCloudSession() ?? this._activeServiceSession;
     if (session === void 0) throw new Error("Not signed in. Call signIn() first.");
-    return rewriteInvocationAudience(authorization, audience, session.jwk);
+    const payload = JSON.parse(
+      new TextDecoder().decode(base64UrlDecode(authorization.split(".")[1] ?? ""))
+    );
+    const did = (value) => String(value).split("#", 1)[0];
+    const signer = [session, ...this.runtimePermissionGrants.map((grant) => grant.session)].find((candidate) => did(candidate.verificationMethod) === did(payload.iss));
+    if (!signer) throw new Error("invocation issuer does not match a held session");
+    return rewriteInvocationAudience(authorization, audience, signer.jwk);
   }
   /**
    * Connect a wallet to upgrade from session-only mode to wallet mode.
@@ -6888,23 +6926,25 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("WASM binding does not support invocation CID computation");
     }
     const session = binding?.session ?? this.requireEncryptionSession();
+    const entries = [
+      {
+        resource: input.networkId,
+        service: "encryption",
+        path: input.networkId,
+        action: input.action
+      }
+    ];
     const headers = this.invokeAnyWithRuntimePermissions(
       session,
-      [
-        {
-          resource: input.networkId,
-          service: "encryption",
-          path: input.networkId,
-          action: input.action
-        }
-      ],
+      entries,
       [input.facts]
     );
+    const signingSession = this.selectInvokeAnySession(session, entries).session;
     const authorization = authorizationHeader(headers);
     const audienceBound = await rewriteInvocationAudience(
       authorization,
       input.targetNode,
-      session.jwk
+      signingSession.jwk
     );
     binding?.graph.assertActive();
     return {
@@ -6957,7 +6997,11 @@ var _TinyCloudNode = class _TinyCloudNode {
             path: networkId,
             actions: ["tinycloud.encryption/decrypt"]
           }) : void 0;
-          throw new import_sdk_core11.DecryptTransportResponseError(response.status, permissionHint);
+          throw new import_sdk_core11.DecryptTransportResponseError(
+            response.status,
+            permissionHint,
+            response.status === 404 && networkId === this.getDefaultEncryptionNetworkId() && await response.text().catch(() => "") === "network not found" ? `Network not found: ${networkId}. Sign in again with a current SDK to create the account's encryption network.` : void 0
+          );
         }
         return await response.json();
       }