@tinycloud/node-sdk 3.8.0-beta.2 → 3.8.0-beta.4

package/dist/{TinyCloudNode-B6VOBrCb.d.ts → TinyCloudNode-BKFo3t4u.d.ts}

@@ -2,6 +2,7 @@ import * as _tinycloud_sdk_core from '@tinycloud/sdk-core';
 import { AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, CapabilityPresentationEnvelopeV1, IUserAuthorization, ISigner, ISessionStorage, ISpaceCreationHandler, RegistryPolicy, RegistrySequenceStore, OnNodeNotFound, LocalNodeIdentityStore, IWasmBindings, ISessionManager, SiweConfig, Manifest, ComposedManifestRequest, ReplicationOptions, TinyCloudSession, PersistedSessionData, ClientSession, PermissionEntry, Extension, SignRequest, SpaceHostResult, SignInOptions, TelemetryConfig, ServiceContext, IKVService, ISQLService, IDuckDbService, IHooksService, CreateOwnerDelegationParams as CreateOwnerDelegationParams$1, OwnerDelegationReceipt as OwnerDelegationReceipt$1, Delegation, StorageFullEvent, IStorageService, INotificationHandler, IENSResolver, RetryPolicy, KVReplicaStorage, AccountService, InvokeAnyFunction as InvokeAnyFunction$1, UnifiedPolicyCapability, RegisterPolicyV3Input, RegisterPolicyV3Receipt, CanonicalJson, ShareDeliveryAuthorizationV3Receipt, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISpace, ISharingService, DelegationResult, DelegationRevocationReceipt, DelegationStatus, ServiceSession, ReplicationControl, ResolvedDelegate } from '@tinycloud/sdk-core';
 import { ReplicaPurgeFailedEvent, ReplicaSessionStamp } from '@tinycloud/sdk-services/kv/replication';
 import { InvokeFunction, InvokeAnyFunction, FetchFunction, RequestSink, RequestLogReader } from '@tinycloud/sdk-services';
+import { NamedKeyClient } from '@tinycloud/sdk-services/encryption/named-keys';
 import { EventEmitter } from 'events';
 import { P as PortableDelegation, S as SessionGrantProof, g as VerifiedSessionGrant } from './delegation-0LKZkmP2.js';
 
@@ -515,6 +516,9 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      * @internal
      */
     private getCapabilityRequest;
+    private refreshNamedKeyFeatureForSignIn;
+    /** Manifest key paths that this sign-in cannot grant. */
+    get unavailableKeyPaths(): string[];
     private resolveSpaceName;
     /**
      * The plain-session primary abilities: `defaultActions` (the shared table)
@@ -1301,6 +1305,8 @@ declare class TinyCloudNode {
     private _hooks?;
     private _vault?;
     private _encryption?;
+    private _namedKeyClient?;
+    private _keysUnavailable;
     private _baseVaults;
     private _baseSecrets;
     private _secrets;
@@ -2162,6 +2168,10 @@ declare class TinyCloudNode {
      * Network-scoped encryption/decrypt service.
      */
     get encryption(): IEncryptionService;
+    /** Named keys bound to the current session. */
+    get keys(): NamedKeyClient;
+    /** Manifest key paths unavailable during the latest `signIn()` attempt. */
+    get keysUnavailable(): readonly string[];
     getEncryptionNetwork(nameOrNetworkId?: string): Promise<NetworkDescriptor | null>;
     createEncryptionNetwork(name?: string): Promise<NetworkDescriptor>;
     /**

package/dist/{TinyCloudNode-CVO41O12.d.cts → TinyCloudNode-CxRHpusk.d.cts}

@@ -2,6 +2,7 @@ import * as _tinycloud_sdk_core from '@tinycloud/sdk-core';
 import { AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, CapabilityPresentationEnvelopeV1, IUserAuthorization, ISigner, ISessionStorage, ISpaceCreationHandler, RegistryPolicy, RegistrySequenceStore, OnNodeNotFound, LocalNodeIdentityStore, IWasmBindings, ISessionManager, SiweConfig, Manifest, ComposedManifestRequest, ReplicationOptions, TinyCloudSession, PersistedSessionData, ClientSession, PermissionEntry, Extension, SignRequest, SpaceHostResult, SignInOptions, TelemetryConfig, ServiceContext, IKVService, ISQLService, IDuckDbService, IHooksService, CreateOwnerDelegationParams as CreateOwnerDelegationParams$1, OwnerDelegationReceipt as OwnerDelegationReceipt$1, Delegation, StorageFullEvent, IStorageService, INotificationHandler, IENSResolver, RetryPolicy, KVReplicaStorage, AccountService, InvokeAnyFunction as InvokeAnyFunction$1, UnifiedPolicyCapability, RegisterPolicyV3Input, RegisterPolicyV3Receipt, CanonicalJson, ShareDeliveryAuthorizationV3Receipt, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISpace, ISharingService, DelegationResult, DelegationRevocationReceipt, DelegationStatus, ServiceSession, ReplicationControl, ResolvedDelegate } from '@tinycloud/sdk-core';
 import { ReplicaPurgeFailedEvent, ReplicaSessionStamp } from '@tinycloud/sdk-services/kv/replication';
 import { InvokeFunction, InvokeAnyFunction, FetchFunction, RequestSink, RequestLogReader } from '@tinycloud/sdk-services';
+import { NamedKeyClient } from '@tinycloud/sdk-services/encryption/named-keys';
 import { EventEmitter } from 'events';
 import { P as PortableDelegation, S as SessionGrantProof, g as VerifiedSessionGrant } from './delegation-0LKZkmP2.cjs';
 
@@ -515,6 +516,9 @@ declare class NodeUserAuthorization implements IUserAuthorization {
      * @internal
      */
     private getCapabilityRequest;
+    private refreshNamedKeyFeatureForSignIn;
+    /** Manifest key paths that this sign-in cannot grant. */
+    get unavailableKeyPaths(): string[];
     private resolveSpaceName;
     /**
      * The plain-session primary abilities: `defaultActions` (the shared table)
@@ -1301,6 +1305,8 @@ declare class TinyCloudNode {
     private _hooks?;
     private _vault?;
     private _encryption?;
+    private _namedKeyClient?;
+    private _keysUnavailable;
     private _baseVaults;
     private _baseSecrets;
     private _secrets;
@@ -2162,6 +2168,10 @@ declare class TinyCloudNode {
      * Network-scoped encryption/decrypt service.
      */
     get encryption(): IEncryptionService;
+    /** Named keys bound to the current session. */
+    get keys(): NamedKeyClient;
+    /** Manifest key paths unavailable during the latest `signIn()` attempt. */
+    get keysUnavailable(): readonly string[];
     getEncryptionNetwork(nameOrNetworkId?: string): Promise<NetworkDescriptor | null>;
     createEncryptionNetwork(name?: string): Promise<NetworkDescriptor>;
     /**

package/dist/{authority-DGi1hIMK.d.ts → authority-BV9Nwh8x.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 { ReplicaLocalEraseOutcome, ReplicaPurgeLocalCopyResult, ReplicaPurgeTrigger, ReplicaPurgeFailedEvent, ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-B6VOBrCb.js';
+import { T as TinyCloudNode } from './TinyCloudNode-BKFo3t4u.js';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/{authority-DgVV80bI.d.cts → authority-gdjLIlC3.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 { ReplicaLocalEraseOutcome, ReplicaPurgeLocalCopyResult, ReplicaPurgeTrigger, ReplicaPurgeFailedEvent, ReplicaSessionStamp, ReplicaDenyInput } from '@tinycloud/sdk-services/kv/replication';
-import { T as TinyCloudNode } from './TinyCloudNode-CVO41O12.cjs';
+import { T as TinyCloudNode } from './TinyCloudNode-CxRHpusk.cjs';
 
 /** Constructor-time validation; the space-dependent secrets check runs at sign-in and open. */
 declare function assertValidReplicationConfig(replication: (ReplicationOptions & {

package/dist/core.cjs

@@ -345,6 +345,32 @@ var FileSessionStorage = class {
 var import_node_crypto = require("crypto");
 var import_siwe = require("siwe");
 var import_sdk_core5 = require("@tinycloud/sdk-core");
+var import_resource = require("@tinycloud/sdk-services/encryption/resource");
+var import_sdk_services2 = require("@tinycloud/sdk-services");
+
+// src/authorization/appKeyHostBinding.ts
+var DOMAIN_LABEL = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+var IPV4 = /^\d+\.\d+\.\d+\.\d+$/;
+var APP_ID = /^[a-z0-9][a-z0-9._-]{0,63}$/;
+function appKeyHostBinding(domain, appId) {
+  if (!APP_ID.test(appId)) return false;
+  if (domain.endsWith(":")) return false;
+  let url;
+  try {
+    url = new URL(`https://${domain}`);
+  } catch {
+    return false;
+  }
+  if (url.protocol !== "https:" || url.port !== "" || url.username !== "" || url.password !== "") return false;
+  if (url.pathname !== "/" || url.search !== "" || url.hash !== "") return false;
+  const host = url.hostname;
+  if (host.startsWith("[") || host.endsWith(".") || IPV4.test(host)) return false;
+  const labels = host.split(".");
+  if (labels.length < 2 || labels[labels.length - 1] === "localhost") return false;
+  if (!labels.every((label) => DOMAIN_LABEL.test(label))) return false;
+  const reversed = labels.reverse().join(".");
+  return appId === reversed || appId.startsWith(`${reversed}.`);
+}
 
 // src/replication/authority-sign-in.ts
 var import_sdk_core2 = require("@tinycloud/sdk-core");
@@ -832,6 +858,23 @@ var NodeUserAuthorization = class {
     );
     return this._capabilityRequest;
   }
+  async refreshNamedKeyFeatureForSignIn(address, chainId) {
+    const request = this.getCapabilityRequest();
+    const siweDomain = this.siweConfig?.domain ?? this.domain;
+    const hasNamedKeys = request?.manifests.some((manifest) => manifest.keys?.length && appKeyHostBinding(siweDomain, manifest.keys_app_id ?? manifest.app_id));
+    if (hasNamedKeys) {
+      await this.resolveTinyCloudHostsForSignIn(address, chainId);
+      await this.refreshNodeInfo();
+    }
+  }
+  /** Manifest key paths that this sign-in cannot grant. */
+  get unavailableKeyPaths() {
+    const request = this.getCapabilityRequest();
+    const siweDomain = this.siweConfig?.domain ?? this.domain;
+    return (request?.manifests ?? []).flatMap(
+      (manifest) => this._nodeFeatures.includes("encryption-named-keys-v1") && appKeyHostBinding(siweDomain, manifest.keys_app_id ?? manifest.app_id) ? [] : (manifest.keys ?? []).map((entry) => "path" in entry ? entry.path : entry.prefix)
+    );
+  }
   resolveSpaceName(space, address, chainId) {
     if (space.startsWith("tinycloud:")) {
       return space;
@@ -1023,15 +1066,31 @@ var NodeUserAuthorization = class {
     }
     const rawAbilities = {};
     const currentDid = (0, import_sdk_core5.pkhDid)(address, chainId);
+    if (this._nodeFeatures.includes("encryption-named-keys-v1")) {
+      const siweDomain = this.siweConfig?.domain ?? this.domain;
+      for (const manifest of request.manifests) {
+        if (!appKeyHostBinding(siweDomain, manifest.keys_app_id ?? manifest.app_id)) continue;
+        for (const declaration of manifest.keys ?? []) {
+          const path = "path" in declaration ? declaration.path : declaration.prefix;
+          const resource = `urn:tinycloud:encryption:${currentDid}:default/${path}`;
+          for (const ability of declaration.abilities) {
+            addRawAbility(rawAbilities, resource, `tinycloud.encryption/${ability}`);
+          }
+        }
+      }
+    }
     const spaceResources = request.resources.filter((entry) => {
       if (entry.service !== import_sdk_core5.ENCRYPTION_PERMISSION_SERVICE) {
         return true;
       }
+      const parsed = entry.path.includes("/") ? (0, import_resource.parseEncryptionResource)(entry.path) : { ...(0, import_sdk_services2.parseNetworkId)(entry.path), kind: "network" };
+      if (parsed.kind !== "network") {
+        throw new import_sdk_core5.ManifestValidationError("named keys go in manifest.keys");
+      }
       for (const action of entry.actions) {
         addRawAbility(rawAbilities, entry.path, action);
       }
-      if (entry.actions.includes(DECRYPT_ACTION)) {
-        const parsed = (0, import_sdk_core5.parseNetworkId)(entry.path);
+      if (entry.actions.includes(DECRYPT_ACTION) && parsed.kind === "network") {
         if (didPrincipalMatches(parsed.ownerDid, currentDid)) {
           addRawAbility(rawAbilities, entry.path, NETWORK_CREATE_ACTION);
         }
@@ -1427,6 +1486,8 @@ var NodeUserAuthorization = class {
     this._chainId = chainId;
     await this.resolveTinyCloudHostsForSignIn(address, chainId);
     this.assertSignInCurrent(generation);
+    await this.refreshNamedKeyFeatureForSignIn(address, chainId);
+    this.assertSignInCurrent(generation);
     const keyId = `session-${Date.now()}`;
     this.sessionManager.renameSessionKeyId(this.activeSessionKeyId, keyId);
     this.activeSessionKeyId = keyId;
@@ -1573,6 +1634,7 @@ var NodeUserAuthorization = class {
     refuseCaveated(this.getCapabilityRequest()?.manifests);
     const address = (0, import_sdk_core5.canonicalizeAddress)(await this.signer.getAddress());
     const chainId = await this.signer.getChainId();
+    await this.refreshNamedKeyFeatureForSignIn(address, chainId);
     const keyId = `session-${Date.now()}`;
     this.sessionManager.renameSessionKeyId(this.activeSessionKeyId, keyId);
     this.activeSessionKeyId = keyId;
@@ -2152,7 +2214,7 @@ var NodeUserAuthorization = class {
 };
 
 // src/recordingServiceContext.ts
-var import_sdk_services2 = require("@tinycloud/sdk-services");
+var import_sdk_services3 = require("@tinycloud/sdk-services");
 var import_requestLog = require("@tinycloud/sdk-services/telemetry/requestLog");
 
 // src/recordingRegistry.ts
@@ -2197,9 +2259,9 @@ function replicationEvent(sample, op) {
 }
 function createServiceContext(config) {
   const { requestSink, ...base } = config;
-  return requestSink === void 0 ? new import_sdk_services2.ServiceContext(base) : new RecordingServiceContext(base, requestSink);
+  return requestSink === void 0 ? new import_sdk_services3.ServiceContext(base) : new RecordingServiceContext(base, requestSink);
 }
-var RecordingServiceContext = class extends import_sdk_services2.ServiceContext {
+var RecordingServiceContext = class extends import_sdk_services3.ServiceContext {
   constructor(config, sink) {
     const pending = {};
     super({
@@ -2793,8 +2855,9 @@ function deserializeDelegation(data) {
 // src/TinyCloudNode.ts
 var import_siwe2 = require("siwe");
 var import_sdk_core11 = require("@tinycloud/sdk-core");
-var import_sdk_services3 = require("@tinycloud/sdk-services");
+var import_sdk_services4 = require("@tinycloud/sdk-services");
 var import_requestLog2 = require("@tinycloud/sdk-services/telemetry/requestLog");
+var import_resource2 = require("@tinycloud/sdk-services/encryption/resource");
 
 // src/account/AccountService.ts
 var import_sdk_core7 = require("@tinycloud/sdk-core");
@@ -3802,6 +3865,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         return void 0;
       }
     };
+    this._keysUnavailable = [];
     this._baseVaults = /* @__PURE__ */ new Map();
     this._baseSecrets = /* @__PURE__ */ new Map();
     this._secrets = /* @__PURE__ */ new Map();
@@ -4629,6 +4693,8 @@ var _TinyCloudNode = class _TinyCloudNode {
     this._hooks = void 0;
     this._vault = void 0;
     this._encryption = void 0;
+    this._namedKeyClient = void 0;
+    this._keysUnavailable = [];
     this._baseVaults.clear();
     this._baseSecrets.clear();
     this._secrets.clear();
@@ -4751,6 +4817,8 @@ var _TinyCloudNode = class _TinyCloudNode {
     this._hooks = void 0;
     this._vault = void 0;
     this._encryption = void 0;
+    this._namedKeyClient = void 0;
+    this._keysUnavailable = [];
     this._baseVaults.clear();
     this._baseSecrets.clear();
     this._secrets.clear();
@@ -4803,6 +4871,26 @@ var _TinyCloudNode = class _TinyCloudNode {
     this.assertSessionEpoch(epoch, "Sign-in");
     await this.ensureRequestedEncryptionNetworks();
     this.assertSessionEpoch(epoch, "Sign-in");
+    this._keysUnavailable = this.auth?.unavailableKeyPaths ?? [];
+    if (this._keysUnavailable.length > 0) {
+      this.notificationHandler.warning(`Named keys unavailable: ${this._keysUnavailable.join(", ")}`);
+    }
+    if (this.nodeFeatures.includes("encryption-named-keys-v1")) {
+      for (const manifest of this.auth?.capabilityRequest?.manifests ?? []) {
+        for (const declaration of manifest.keys ?? []) {
+          if ("path" in declaration && declaration.abilities.includes("key.create") && !this._keysUnavailable.includes(declaration.path)) {
+            try {
+              await this.keys.ensureKey(declaration.path);
+            } catch (error) {
+              this._keysUnavailable.push(declaration.path);
+              const code = error && typeof error === "object" && "code" in error && typeof error.code === "string" && /^[A-Z_]+$/.test(error.code) ? error.code : "UNKNOWN";
+              this.notificationHandler.warning(`Named key unavailable: ${declaration.path} (${code})`);
+            }
+            this.assertSessionEpoch(epoch, "Sign-in");
+          }
+        }
+      }
+    }
     if (!bootstrapped && this.config.manifest === void 0 && this.config.capabilityRequest === void 0) {
       await this.ensureOwnedSpaceHostedById(this.ownedSpaceId(import_sdk_core11.SECRETS_SPACE));
     }
@@ -5379,7 +5467,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     if (!this.currentSessionCoversAccountRegistry()) {
       if (!_TinyCloudNode.accountRegistrySkipLogged) {
         _TinyCloudNode.accountRegistrySkipLogged = true;
-        import_sdk_services3.tinyCloudDebugLogger.log("registry.skip");
+        import_sdk_services4.tinyCloudDebugLogger.log("registry.skip");
       }
       return;
     }
@@ -5590,7 +5678,8 @@ var _TinyCloudNode = class _TinyCloudNode {
     const networkIds = /* @__PURE__ */ new Set();
     for (const resource of request.resources) {
       if (resource.service === import_sdk_core11.ENCRYPTION_PERMISSION_SERVICE && resource.path.startsWith("urn:tinycloud:encryption:") && resource.actions.includes(DECRYPT_ACTION2)) {
-        networkIds.add(resource.path);
+        const parsed = resource.path.includes("/") ? (0, import_resource2.parseEncryptionResource)(resource.path) : { ...(0, import_sdk_core11.parseNetworkId)(resource.path), kind: "network" };
+        if (parsed.kind === "network") networkIds.add(resource.path);
       }
     }
     return [...networkIds];
@@ -6140,6 +6229,8 @@ var _TinyCloudNode = class _TinyCloudNode {
     this._hooks = stagedGraph.hooks;
     this._vault = stagedGraph.vault;
     this._encryption = stagedGraph.encryption;
+    this._namedKeyClient = void 0;
+    this._keysUnavailable = [];
     this._capabilityRegistry = stagedGraph.capabilityRegistry;
     this._keyProvider = stagedGraph.keyProvider;
     this._sharingService = stagedGraph.sharingService;
@@ -7049,7 +7140,7 @@ var _TinyCloudNode = class _TinyCloudNode {
         );
         graph.assertActive();
         if (!response.ok) {
-          const permissionHint = response.status === 401 || response.status === 403 ? (0, import_sdk_services3.parsePermissionHint)({
+          const permissionHint = response.status === 401 || response.status === 403 ? (0, import_sdk_services4.parsePermissionHint)({
             service: "tinycloud.encryption",
             path: networkId,
             actions: ["tinycloud.encryption/decrypt"]
@@ -7736,6 +7827,40 @@ var _TinyCloudNode = class _TinyCloudNode {
   get encryption() {
     return this.getEncryptionService();
   }
+  /** Named keys bound to the current session. */
+  get keys() {
+    return new Proxy({}, {
+      get: (_target, property) => {
+        if (property === "refreshNodeInfo") {
+          return () => {
+            void this._namedKeyClient?.then((client) => client.refreshNodeInfo());
+          };
+        }
+        if (typeof property !== "string" || ![
+          "getPublicKey",
+          "describeKey",
+          "createKey",
+          "blockKey",
+          "unblockKey",
+          "ensureKey",
+          "encrypt",
+          "decrypt",
+          "decryptMany"
+        ].includes(property)) return void 0;
+        return (...args) => {
+          this._namedKeyClient ?? (this._namedKeyClient = import("./encryption-keys.cjs").then(({ createNamedKeyClient }) => createNamedKeyClient(this)));
+          return this._namedKeyClient.then((client) => {
+            const method = client[property];
+            return method.apply(client, args);
+          });
+        };
+      }
+    });
+  }
+  /** Manifest key paths unavailable during the latest `signIn()` attempt. */
+  get keysUnavailable() {
+    return this._keysUnavailable;
+  }
   async getEncryptionNetwork(nameOrNetworkId = this.getDefaultEncryptionNetworkId()) {
     const networkId = nameOrNetworkId.startsWith("urn:tinycloud:encryption:") ? nameOrNetworkId : this.getDefaultEncryptionNetworkId(nameOrNetworkId);
     return this.fetchEncryptionNetworkAt(
@@ -7863,7 +7988,7 @@ var _TinyCloudNode = class _TinyCloudNode {
     );
     if (result.status !== "ok") {
       if (result.status === "permission_required") {
-        const hint = (0, import_sdk_services3.parsePermissionHint)(result.hint);
+        const hint = (0, import_sdk_services4.parsePermissionHint)(result.hint);
         if (hint === void 0) return { status: "read_failed" };
         return {
           status: "permission_required",