@tinycloud/node-sdk 2.5.1 → 2.6.0-beta.1

package/dist/{core-ojeY-wet.d.cts → core-Cr-zD1lk.d.cts}

@@ -910,6 +910,12 @@ declare class TinyCloudNode {
     private _delegationManager?;
     private _spaceService?;
     private runtimePermissionGrants;
+    /**
+     * Memoized `recapOperationsFromSession` result, keyed by the exact SIWE it
+     * was parsed from. The primary session is stable for the life of a sign-in,
+     * so this avoids re-parsing the recap on every registration.
+     */
+    private _recapOperationsCache?;
     /**
      * TinyCloudSession captured by {@link restoreSession} when there's no
      * auth-layer signer available (session-only mode used by OpenKey-backed
@@ -1052,6 +1058,42 @@ declare class TinyCloudNode {
     private isFreshBootstrapAccount;
     private runAccountBootstrap;
     private registerBootstrapRuntimeGrant;
+    /**
+     * Map the base session's OWN recap into runtime permission operations.
+     *
+     * Uses the RAW `parseRecapFromSiwe` binding — NOT `parseRecapCapabilities`,
+     * whose `normalizeSpace` collapses `tinycloud:pkh:...:<owner>:<space>` to a
+     * bare short name and would conflate two owners' identically-named spaces.
+     * We must keep the full owner-scoped URI so a synthetic primary grant can
+     * never cover an operation on a different owner's space.
+     *
+     * Mirrors {@link operationsFromDelegation}'s op shape: encryption network
+     * entries (`urn:tinycloud:encryption:` paths) become `resource` ops; every
+     * other entry becomes a `spaceId` op carrying the raw recap `space` URI.
+     * One op per action.
+     *
+     * Returns `[]` for session-only / restored-without-siwe modes and for any
+     * unparseable SIWE — the primary grant is simply not registered in that case.
+     */
+    private recapOperationsFromSession;
+    /**
+     * Register the base (primary) session's own recap as a synthetic runtime
+     * grant tagged `provenance: "primary"` so it always out-ranks other covering
+     * grants in {@link findGrantForOperations}. This closes the selection-design
+     * hazard where a broad — possibly broken — bootstrap/delegated grant could
+     * hijack an operation the primary session itself already authorized (TC-111).
+     *
+     * Two safety exclusions:
+     *  - Ops whose space is in `lastActivationSkippedSpaceIds` are dropped: the
+     *    node refused to activate those spaces this sign-in even though the recap
+     *    claims them. Including them would let the synthetic primary out-rank a
+     *    working grant and 401 (the "skipped-activation inverted hijack").
+     *  - Encryption `resource` ops are kept as-is (space-independent).
+     *
+     * No-ops when nothing remains after exclusion. Callers (`signIn`,
+     * `restoreSession`) clear `runtimePermissionGrants` first, so no dupes.
+     */
+    private registerPrimarySessionGrant;
     private writeManifestRegistryRecords;
     private scheduleAccountRegistrySync;
     private withAccountRegistryRetry;

package/dist/{core-ojeY-wet.d.ts → core-Cr-zD1lk.d.ts}

@@ -910,6 +910,12 @@ declare class TinyCloudNode {
     private _delegationManager?;
     private _spaceService?;
     private runtimePermissionGrants;
+    /**
+     * Memoized `recapOperationsFromSession` result, keyed by the exact SIWE it
+     * was parsed from. The primary session is stable for the life of a sign-in,
+     * so this avoids re-parsing the recap on every registration.
+     */
+    private _recapOperationsCache?;
     /**
      * TinyCloudSession captured by {@link restoreSession} when there's no
      * auth-layer signer available (session-only mode used by OpenKey-backed
@@ -1052,6 +1058,42 @@ declare class TinyCloudNode {
     private isFreshBootstrapAccount;
     private runAccountBootstrap;
     private registerBootstrapRuntimeGrant;
+    /**
+     * Map the base session's OWN recap into runtime permission operations.
+     *
+     * Uses the RAW `parseRecapFromSiwe` binding — NOT `parseRecapCapabilities`,
+     * whose `normalizeSpace` collapses `tinycloud:pkh:...:<owner>:<space>` to a
+     * bare short name and would conflate two owners' identically-named spaces.
+     * We must keep the full owner-scoped URI so a synthetic primary grant can
+     * never cover an operation on a different owner's space.
+     *
+     * Mirrors {@link operationsFromDelegation}'s op shape: encryption network
+     * entries (`urn:tinycloud:encryption:` paths) become `resource` ops; every
+     * other entry becomes a `spaceId` op carrying the raw recap `space` URI.
+     * One op per action.
+     *
+     * Returns `[]` for session-only / restored-without-siwe modes and for any
+     * unparseable SIWE — the primary grant is simply not registered in that case.
+     */
+    private recapOperationsFromSession;
+    /**
+     * Register the base (primary) session's own recap as a synthetic runtime
+     * grant tagged `provenance: "primary"` so it always out-ranks other covering
+     * grants in {@link findGrantForOperations}. This closes the selection-design
+     * hazard where a broad — possibly broken — bootstrap/delegated grant could
+     * hijack an operation the primary session itself already authorized (TC-111).
+     *
+     * Two safety exclusions:
+     *  - Ops whose space is in `lastActivationSkippedSpaceIds` are dropped: the
+     *    node refused to activate those spaces this sign-in even though the recap
+     *    claims them. Including them would let the synthetic primary out-rank a
+     *    working grant and 401 (the "skipped-activation inverted hijack").
+     *  - Encryption `resource` ops are kept as-is (space-independent).
+     *
+     * No-ops when nothing remains after exclusion. Callers (`signIn`,
+     * `restoreSession`) clear `runtimePermissionGrants` first, so no dupes.
+     */
+    private registerPrimarySessionGrant;
     private writeManifestRegistryRecords;
     private scheduleAccountRegistrySync;
     private withAccountRegistryRetry;

package/dist/core.cjs

@@ -327,8 +327,8 @@ var import_sdk_core2 = require("@tinycloud/sdk-core");
 var defaultSignStrategy = { type: "auto-sign" };
 
 // src/authorization/NodeUserAuthorization.ts
-var DECRYPT_ACTION = "tinycloud.encryption/decrypt";
-var NETWORK_CREATE_ACTION = "tinycloud.encryption/network.create";
+var DECRYPT_ACTION = import_sdk_core3.ENCRYPTION.DECRYPT;
+var NETWORK_CREATE_ACTION = import_sdk_core3.ENCRYPTION.NETWORK_CREATE;
 function didPrincipalMatches(actual, expected) {
   try {
     return (0, import_sdk_core3.principalDidEquals)(actual, expected);
@@ -361,44 +361,27 @@ var NodeUserAuthorization = class {
     this.spacePrefix = config.spacePrefix ?? "default";
     this.defaultActions = config.defaultActions ?? {
       kv: {
-        "": [
-          "tinycloud.kv/put",
-          "tinycloud.kv/get",
-          "tinycloud.kv/del",
-          "tinycloud.kv/list",
-          "tinycloud.kv/metadata"
-        ]
+        "": [import_sdk_core3.KV.PUT, import_sdk_core3.KV.GET, import_sdk_core3.KV.DEL, import_sdk_core3.KV.LIST, import_sdk_core3.KV.METADATA]
       },
       sql: {
-        "": [
-          "tinycloud.sql/read",
-          "tinycloud.sql/write",
-          "tinycloud.sql/schema",
-          "tinycloud.sql/admin",
-          "tinycloud.sql/export"
-        ]
+        "": [import_sdk_core3.SQL.READ, import_sdk_core3.SQL.WRITE, import_sdk_core3.SQL.SCHEMA, import_sdk_core3.SQL.ADMIN, import_sdk_core3.SQL.EXPORT]
       },
       duckdb: {
         "": [
-          "tinycloud.duckdb/read",
-          "tinycloud.duckdb/write",
-          "tinycloud.duckdb/admin",
-          "tinycloud.duckdb/describe",
-          "tinycloud.duckdb/export",
-          "tinycloud.duckdb/import",
-          "tinycloud.duckdb/execute"
+          import_sdk_core3.DUCKDB.READ,
+          import_sdk_core3.DUCKDB.WRITE,
+          import_sdk_core3.DUCKDB.ADMIN,
+          import_sdk_core3.DUCKDB.DESCRIBE,
+          import_sdk_core3.DUCKDB.EXPORT,
+          import_sdk_core3.DUCKDB.IMPORT,
+          import_sdk_core3.DUCKDB.EXECUTE
         ]
       },
       capabilities: {
-        "": ["tinycloud.capabilities/read"]
+        "": [import_sdk_core3.CAPABILITIES.READ]
       },
       hooks: {
-        "": [
-          "tinycloud.hooks/subscribe",
-          "tinycloud.hooks/register",
-          "tinycloud.hooks/list",
-          "tinycloud.hooks/unregister"
-        ]
+        "": [import_sdk_core3.HOOKS.SUBSCRIBE, import_sdk_core3.HOOKS.REGISTER, import_sdk_core3.HOOKS.LIST, import_sdk_core3.HOOKS.UNREGISTER]
       }
     };
     this.sessionExpirationMs = config.sessionExpirationMs ?? import_sdk_core3.EXPIRY.SESSION_MS;
@@ -598,20 +581,17 @@ var NodeUserAuthorization = class {
           [secretsSpaceId]: {
             kv: {
               "vault/secrets/": [
-                "tinycloud.kv/get",
-                "tinycloud.kv/put",
-                "tinycloud.kv/del",
-                "tinycloud.kv/list",
-                "tinycloud.kv/metadata"
+                import_sdk_core3.KV.GET,
+                import_sdk_core3.KV.PUT,
+                import_sdk_core3.KV.DEL,
+                import_sdk_core3.KV.LIST,
+                import_sdk_core3.KV.METADATA
               ]
             }
           }
         },
         rawAbilities: {
-          [defaultNetworkId]: [
-            "tinycloud.encryption/decrypt",
-            "tinycloud.encryption/network.create"
-          ]
+          [defaultNetworkId]: [DECRYPT_ACTION, NETWORK_CREATE_ACTION]
         }
       };
     }
@@ -1675,9 +1655,27 @@ var NodeSecretsService = class {
 // src/TinyCloudNode.ts
 var DEFAULT_HOST = "https://node.tinycloud.xyz";
 var DEFAULT_ENCRYPTION_NETWORK_NAME = "default";
-var NETWORK_CREATE_ACTION2 = "tinycloud.encryption/network.create";
-var DECRYPT_ACTION2 = "tinycloud.encryption/decrypt";
+var NETWORK_CREATE_ACTION2 = import_sdk_core8.ENCRYPTION.NETWORK_CREATE;
+var DECRYPT_ACTION2 = import_sdk_core8.ENCRYPTION.DECRYPT;
 var NETWORK_ADMIN_TYPE = "tinycloud.encryption.network-admin/v1";
+var ROOT_DELEGATION_ACTIONS = [
+  import_sdk_core8.KV.PUT,
+  import_sdk_core8.KV.GET,
+  import_sdk_core8.KV.DEL,
+  import_sdk_core8.KV.LIST,
+  import_sdk_core8.KV.METADATA,
+  import_sdk_core8.SQL.READ,
+  import_sdk_core8.SQL.WRITE,
+  import_sdk_core8.SQL.ADMIN,
+  import_sdk_core8.SQL.ALL,
+  import_sdk_core8.DUCKDB.READ,
+  import_sdk_core8.DUCKDB.WRITE,
+  import_sdk_core8.DUCKDB.ADMIN,
+  import_sdk_core8.DUCKDB.DESCRIBE,
+  import_sdk_core8.DUCKDB.EXPORT,
+  import_sdk_core8.DUCKDB.IMPORT,
+  import_sdk_core8.DUCKDB.ALL
+];
 var DEFAULT_SESSION_EXPIRATION_MS = import_sdk_core8.EXPIRY.SESSION_MS;
 function isOpenKeyAutoSignStrategy(strategy) {
   return strategy?.openKeyAutoSign === true;
@@ -2149,6 +2147,10 @@ var _TinyCloudNode = class _TinyCloudNode {
     await this.tc.signIn(options);
     this.syncResolvedHostFromAuth();
     this.initializeServices();
+    const primarySession = this.currentTinyCloudSession();
+    if (primarySession) {
+      this.registerPrimarySessionGrant(primarySession);
+    }
     const bootstrapped = await this.bootstrapAccountIfNeeded();
     await this.ensureRequestedEncryptionNetworks();
     if (!bootstrapped && this.config.manifest === void 0 && this.config.capabilityRequest === void 0) {
@@ -2392,7 +2394,107 @@ var _TinyCloudNode = class _TinyCloudNode {
         host: this.config.host
       },
       operations,
-      expiresAt
+      expiresAt,
+      provenance: "bootstrap"
+    });
+  }
+  /**
+   * Map the base session's OWN recap into runtime permission operations.
+   *
+   * Uses the RAW `parseRecapFromSiwe` binding — NOT `parseRecapCapabilities`,
+   * whose `normalizeSpace` collapses `tinycloud:pkh:...:<owner>:<space>` to a
+   * bare short name and would conflate two owners' identically-named spaces.
+   * We must keep the full owner-scoped URI so a synthetic primary grant can
+   * never cover an operation on a different owner's space.
+   *
+   * Mirrors {@link operationsFromDelegation}'s op shape: encryption network
+   * entries (`urn:tinycloud:encryption:` paths) become `resource` ops; every
+   * other entry becomes a `spaceId` op carrying the raw recap `space` URI.
+   * One op per action.
+   *
+   * Returns `[]` for session-only / restored-without-siwe modes and for any
+   * unparseable SIWE — the primary grant is simply not registered in that case.
+   */
+  recapOperationsFromSession(session) {
+    const siwe = session.siwe;
+    if (!siwe) {
+      return [];
+    }
+    if (this._recapOperationsCache?.siwe === siwe) {
+      return this._recapOperationsCache.operations;
+    }
+    let operations = [];
+    try {
+      const entries = this.wasmBindings.parseRecapFromSiwe(siwe);
+      if (Array.isArray(entries)) {
+        operations = entries.flatMap((entry) => {
+          const service = this.invocationServiceName(entry.service);
+          return entry.actions.map((action) => ({
+            ...this.isEncryptionNetworkOperation(service, entry.path) ? { resource: entry.path } : { spaceId: entry.space },
+            service,
+            path: entry.path,
+            action
+          }));
+        });
+      }
+    } catch {
+      operations = [];
+    }
+    this._recapOperationsCache = { siwe, operations };
+    return operations;
+  }
+  /**
+   * Register the base (primary) session's own recap as a synthetic runtime
+   * grant tagged `provenance: "primary"` so it always out-ranks other covering
+   * grants in {@link findGrantForOperations}. This closes the selection-design
+   * hazard where a broad — possibly broken — bootstrap/delegated grant could
+   * hijack an operation the primary session itself already authorized (TC-111).
+   *
+   * Two safety exclusions:
+   *  - Ops whose space is in `lastActivationSkippedSpaceIds` are dropped: the
+   *    node refused to activate those spaces this sign-in even though the recap
+   *    claims them. Including them would let the synthetic primary out-rank a
+   *    working grant and 401 (the "skipped-activation inverted hijack").
+   *  - Encryption `resource` ops are kept as-is (space-independent).
+   *
+   * No-ops when nothing remains after exclusion. Callers (`signIn`,
+   * `restoreSession`) clear `runtimePermissionGrants` first, so no dupes.
+   */
+  registerPrimarySessionGrant(session) {
+    const skipped = this.auth ? this.auth.lastActivationSkippedSpaceIds ?? [] : [];
+    const operations = this.recapOperationsFromSession(session).filter(
+      (operation) => operation.spaceId === void 0 || !skipped.some((spaceId) => this.spaceIdsEqual(spaceId, operation.spaceId))
+    );
+    if (operations.length === 0) {
+      return;
+    }
+    const expiresAt = extractSiweExpiration(session.siwe) ?? this.getSessionExpiry();
+    const actions = [...new Set(operations.map((operation) => operation.action))];
+    this.runtimePermissionGrants.push({
+      session: {
+        delegationHeader: session.delegationHeader,
+        delegationCid: session.delegationCid,
+        spaceId: session.spaceId,
+        verificationMethod: session.verificationMethod,
+        jwk: session.jwk
+      },
+      delegation: {
+        cid: session.delegationCid,
+        delegationHeader: session.delegationHeader,
+        delegateDID: session.verificationMethod,
+        delegatorDID: this.did,
+        spaceId: session.spaceId,
+        path: "",
+        actions,
+        expiry: expiresAt,
+        allowSubDelegation: true,
+        ownerAddress: session.address,
+        chainId: session.chainId,
+        host: this.config.host
+      },
+      operations,
+      expiresAt,
+      provenance: "primary"
     });
   }
   async writeManifestRegistryRecords() {
@@ -2728,6 +2830,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       } else {
         this._restoredTcSession = tcSession;
       }
+      this.registerPrimarySessionGrant(tcSession);
     }
   }
   /**
@@ -3199,24 +3302,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         spaceId: tcSession.spaceId,
         path: "",
         // Root access
-        actions: [
-          "tinycloud.kv/put",
-          "tinycloud.kv/get",
-          "tinycloud.kv/del",
-          "tinycloud.kv/list",
-          "tinycloud.kv/metadata",
-          "tinycloud.sql/read",
-          "tinycloud.sql/write",
-          "tinycloud.sql/admin",
-          "tinycloud.sql/*",
-          "tinycloud.duckdb/read",
-          "tinycloud.duckdb/write",
-          "tinycloud.duckdb/admin",
-          "tinycloud.duckdb/describe",
-          "tinycloud.duckdb/export",
-          "tinycloud.duckdb/import",
-          "tinycloud.duckdb/*"
-        ],
+        actions: [...ROOT_DELEGATION_ACTIONS],
         expiry: this.getSessionExpiry(),
         isRevoked: false,
         allowSubDelegation: true
@@ -3229,24 +3315,7 @@ var _TinyCloudNode = class _TinyCloudNode {
             delegateDID: tcSession.verificationMethod,
             spaceId,
             path: "",
-            actions: [
-              "tinycloud.kv/put",
-              "tinycloud.kv/get",
-              "tinycloud.kv/del",
-              "tinycloud.kv/list",
-              "tinycloud.kv/metadata",
-              "tinycloud.sql/read",
-              "tinycloud.sql/write",
-              "tinycloud.sql/admin",
-              "tinycloud.sql/*",
-              "tinycloud.duckdb/read",
-              "tinycloud.duckdb/write",
-              "tinycloud.duckdb/admin",
-              "tinycloud.duckdb/describe",
-              "tinycloud.duckdb/export",
-              "tinycloud.duckdb/import",
-              "tinycloud.duckdb/*"
-            ],
+            actions: [...ROOT_DELEGATION_ACTIONS],
             expiry: this.getSessionExpiry(),
             isRevoked: false,
             allowSubDelegation: true
@@ -3800,7 +3869,7 @@ var _TinyCloudNode = class _TinyCloudNode {
   getRuntimePermissionDelegations(permissions) {
     this.pruneExpiredRuntimePermissionGrants();
     if (permissions === void 0) {
-      return this.runtimePermissionGrants.map((grant) => grant.delegation);
+      return this.runtimePermissionGrants.filter((grant) => grant.provenance !== "primary").map((grant) => grant.delegation);
     }
     const session = this.currentTinyCloudSession();
     if (!session || !Array.isArray(permissions) || permissions.length === 0) {
@@ -3952,7 +4021,8 @@ var _TinyCloudNode = class _TinyCloudNode {
         },
         delegation,
         operations: this.permissionOperations(delegatedEntries, spaceId),
-        expiresAt
+        expiresAt,
+        provenance: "runtime"
       });
       delegations.push(delegation);
     }
@@ -4090,13 +4160,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       throw new Error("Public space not enabled. Set enablePublicSpace: true in config.");
     }
     await this.auth.hostPublicSpace(publicSpaceId);
-    const kvActions = [
-      "tinycloud.kv/put",
-      "tinycloud.kv/get",
-      "tinycloud.kv/del",
-      "tinycloud.kv/list",
-      "tinycloud.kv/metadata"
-    ];
+    const kvActions = [import_sdk_core8.KV.PUT, import_sdk_core8.KV.GET, import_sdk_core8.KV.DEL, import_sdk_core8.KV.LIST, import_sdk_core8.KV.METADATA];
     const abilities = { kv: { "": kvActions } };
     const now = /* @__PURE__ */ new Date();
     const expiryMs = import_sdk_core8.EXPIRY.EPHEMERAL_MS;
@@ -4619,7 +4683,7 @@ var _TinyCloudNode = class _TinyCloudNode {
       return grants;
     }
     for (const operation of operations) {
-      const grant = this.findGrantForOperation(operation);
+      const grant = this.findGrantForOperation(operation, { excludePrimary: true });
       if (!grant) {
         return [];
       }
@@ -4659,7 +4723,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       },
       delegation,
       operations,
-      expiresAt: delegation.expiry
+      expiresAt: delegation.expiry,
+      provenance: "delegated"
     };
   }
   installRuntimeGrantFromServiceSession(delegation, session, expiresAt) {
@@ -4674,7 +4739,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       session,
       delegation,
       operations,
-      expiresAt
+      expiresAt,
+      provenance: "delegated"
     });
   }
   delegatedResourcesForEntries(entries, spaceId) {
@@ -4774,21 +4840,28 @@ var _TinyCloudNode = class _TinyCloudNode {
     });
     return grant?.session ?? fallback;
   }
-  findGrantForOperations(operations) {
+  findGrantForOperations(operations, options) {
     if (operations.length === 0) {
       return void 0;
     }
     this.pruneExpiredRuntimePermissionGrants();
-    return this.runtimePermissionGrants.find((grant) => {
+    const covering = this.runtimePermissionGrants.filter((grant) => {
+      if (options?.excludePrimary && grant.provenance === "primary") {
+        return false;
+      }
       return operations.every(
         (operation) => grant.operations.some(
           (granted) => this.operationCovers(granted, operation)
         )
       );
     });
+    if (covering.length === 0) {
+      return void 0;
+    }
+    return covering.find((grant) => grant.provenance === "primary") ?? covering[0];
   }
-  findGrantForOperation(operation) {
-    return this.findGrantForOperations([operation]);
+  findGrantForOperation(operation, options) {
+    return this.findGrantForOperations([operation], options);
   }
   pruneExpiredRuntimePermissionGrants() {
     const now = Date.now();
@@ -5025,7 +5098,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         session.chainId
       );
       const publicAbilities = {
-        kv: { "": ["tinycloud.kv/get", "tinycloud.kv/put", "tinycloud.kv/metadata"] }
+        kv: { "": [import_sdk_core8.KV.GET, import_sdk_core8.KV.PUT, import_sdk_core8.KV.METADATA] }
       };
       const publicPrepared = this.wasmBindings.prepareSession({
         abilities: publicAbilities,
@@ -5053,7 +5126,7 @@ var _TinyCloudNode = class _TinyCloudNode {
           delegationHeader: publicSession.delegationHeader,
           spaceId: publicSpaceId,
           path: "",
-          actions: ["tinycloud.kv/get", "tinycloud.kv/put", "tinycloud.kv/metadata"],
+          actions: [import_sdk_core8.KV.GET, import_sdk_core8.KV.PUT, import_sdk_core8.KV.METADATA],
           disableSubDelegation: params.disableSubDelegation ?? false,
           expiry: expirationTime,
           delegateDID: params.delegateDID,