@tinycloud/node-sdk 2.3.0-beta.7 → 2.3.0-beta.8

package/dist/{core-CNyXnUx9.d.cts → core-BdlIWB-K.d.cts}

@@ -1,4 +1,4 @@
-import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, IWasmBindings, SiweConfig, Manifest, ComposedManifestRequest, ClientSession, TinyCloudSession, Extension, SignInOptions, Delegation, DelegatedResource, IKVService, ISQLService, IDuckDbService, IHooksService, INotificationHandler, IENSResolver, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, PermissionEntry, DelegationManager, ISpaceService, ISpace, ISharingService, CreateDelegationParams, DelegationResult, ResolvedDelegate, KeyProvider, ISessionManager, JWK } from '@tinycloud/sdk-core';
+import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, IWasmBindings, SiweConfig, Manifest, ComposedManifestRequest, ClientSession, TinyCloudSession, Extension, SignInOptions, Delegation, DelegatedResource, TelemetryConfig, IKVService, ISQLService, IDuckDbService, IHooksService, INotificationHandler, IENSResolver, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, PermissionEntry, DelegationManager, ISpaceService, ISpace, ISharingService, CreateDelegationParams, DelegationResult, ResolvedDelegate, KeyProvider, ISessionManager, JWK } from '@tinycloud/sdk-core';
 import { EventEmitter } from 'events';
 import { InvokeFunction } from '@tinycloud/sdk-services';
 
@@ -587,7 +587,7 @@ declare class DelegatedAccess {
     private _sql;
     private _duckdb;
     private _hooks;
-    constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string, invoke: InvokeFunction);
+    constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string, invoke: InvokeFunction, telemetry?: TelemetryConfig);
     /**
      * Get the delegation this access was created from.
      */
@@ -723,6 +723,8 @@ interface TinyCloudNodeConfig {
     capabilityRequest?: ComposedManifestRequest;
     /** Include implicit account registry permissions when composing `manifest`. Default true. */
     includeAccountRegistryPermissions?: boolean;
+    /** Default-off service telemetry. */
+    telemetry?: TelemetryConfig;
 }
 /**
  * Options for {@link TinyCloudNode.delegateTo}.
@@ -1076,6 +1078,21 @@ declare class TinyCloudNode {
      * @param spaceId - Full space URI (`tinycloud:pkh:eip155:<chain>:<addr>:<name>`).
      */
     sqlForSpace(spaceId: string): ISQLService;
+    /**
+     * Get a KV service scoped to a specific space.
+     *
+     * The KV counterpart to {@link sqlForSpace}: clones the active service
+     * context and overrides its session's spaceId so that subsequent
+     * `kv/<action>` invocations route to that space. Useful for reading data
+     * that a manifest app stores outside the primary space (e.g. transcripts a
+     * `defaults: true` app keeps under the owner's `applications` space), when
+     * the caller already holds a delegation covering the target space.
+     *
+     * Does NOT auto-create the space.
+     *
+     * @param spaceId - Full space URI (`tinycloud:pkh:eip155:<chain>:<addr>:<name>`).
+     */
+    kvForSpace(spaceId: string): IKVService;
     /**
      * DuckDB database operations on this user's space.
      */

package/dist/{core-CNyXnUx9.d.ts → core-BdlIWB-K.d.ts}

@@ -1,4 +1,4 @@
-import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, IWasmBindings, SiweConfig, Manifest, ComposedManifestRequest, ClientSession, TinyCloudSession, Extension, SignInOptions, Delegation, DelegatedResource, IKVService, ISQLService, IDuckDbService, IHooksService, INotificationHandler, IENSResolver, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, PermissionEntry, DelegationManager, ISpaceService, ISpace, ISharingService, CreateDelegationParams, DelegationResult, ResolvedDelegate, KeyProvider, ISessionManager, JWK } from '@tinycloud/sdk-core';
+import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, IWasmBindings, SiweConfig, Manifest, ComposedManifestRequest, ClientSession, TinyCloudSession, Extension, SignInOptions, Delegation, DelegatedResource, TelemetryConfig, IKVService, ISQLService, IDuckDbService, IHooksService, INotificationHandler, IENSResolver, IDataVaultService, IEncryptionService, NetworkDescriptor, ISecretsService, ICapabilityKeyRegistry, PermissionEntry, DelegationManager, ISpaceService, ISpace, ISharingService, CreateDelegationParams, DelegationResult, ResolvedDelegate, KeyProvider, ISessionManager, JWK } from '@tinycloud/sdk-core';
 import { EventEmitter } from 'events';
 import { InvokeFunction } from '@tinycloud/sdk-services';
 
@@ -587,7 +587,7 @@ declare class DelegatedAccess {
     private _sql;
     private _duckdb;
     private _hooks;
-    constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string, invoke: InvokeFunction);
+    constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string, invoke: InvokeFunction, telemetry?: TelemetryConfig);
     /**
      * Get the delegation this access was created from.
      */
@@ -723,6 +723,8 @@ interface TinyCloudNodeConfig {
     capabilityRequest?: ComposedManifestRequest;
     /** Include implicit account registry permissions when composing `manifest`. Default true. */
     includeAccountRegistryPermissions?: boolean;
+    /** Default-off service telemetry. */
+    telemetry?: TelemetryConfig;
 }
 /**
  * Options for {@link TinyCloudNode.delegateTo}.
@@ -1076,6 +1078,21 @@ declare class TinyCloudNode {
      * @param spaceId - Full space URI (`tinycloud:pkh:eip155:<chain>:<addr>:<name>`).
      */
     sqlForSpace(spaceId: string): ISQLService;
+    /**
+     * Get a KV service scoped to a specific space.
+     *
+     * The KV counterpart to {@link sqlForSpace}: clones the active service
+     * context and overrides its session's spaceId so that subsequent
+     * `kv/<action>` invocations route to that space. Useful for reading data
+     * that a manifest app stores outside the primary space (e.g. transcripts a
+     * `defaults: true` app keeps under the owner's `applications` space), when
+     * the caller already holds a delegation covering the target space.
+     *
+     * Does NOT auto-create the space.
+     *
+     * @param spaceId - Full space URI (`tinycloud:pkh:eip155:<chain>:<addr>:<name>`).
+     */
+    kvForSpace(spaceId: string): IKVService;
     /**
      * DuckDB database operations on this user's space.
      */

package/dist/core.cjs

@@ -518,11 +518,13 @@ var NodeUserAuthorization = class {
     const request = this.getCapabilityRequest();
     if (request === void 0) {
       const defaultNetworkId = this.defaultEncryptionNetworkId(address, chainId);
+      const primarySpaceId2 = (0, import_sdk_core2.makePkhSpaceId)(address, chainId, this.spacePrefix);
       const secretsSpaceId = (0, import_sdk_core2.makePkhSpaceId)(address, chainId, "secrets");
       return {
         abilities: this.defaultActions,
-        spaceId: (0, import_sdk_core2.makePkhSpaceId)(address, chainId, this.spacePrefix),
+        spaceId: primarySpaceId2,
         spaceAbilities: {
+          [primarySpaceId2]: this.defaultActions,
           [secretsSpaceId]: {
             kv: {
               "vault/secrets/": [
@@ -1122,14 +1124,15 @@ var import_sdk_core6 = require("@tinycloud/sdk-core");
 // src/DelegatedAccess.ts
 var import_sdk_core3 = require("@tinycloud/sdk-core");
 var DelegatedAccess = class {
-  constructor(session, delegation, host, invoke) {
+  constructor(session, delegation, host, invoke, telemetry) {
     this.session = session;
     this._delegation = delegation;
     this.host = host;
     this._serviceContext = new import_sdk_core3.ServiceContext({
       invoke,
       fetch: globalThis.fetch.bind(globalThis),
-      hosts: [host]
+      hosts: [host],
+      telemetry
     });
     const prefix = this._delegation.path.replace(/\/$/, "");
     this._kv = new import_sdk_core3.KVService({ prefix });
@@ -1710,7 +1713,8 @@ var _TinyCloudNode = class _TinyCloudNode {
         const kvContext = new import_sdk_core6.ServiceContext({
           invoke: config2.invoke,
           fetch: config2.fetch ?? globalThis.fetch.bind(globalThis),
-          hosts: config2.hosts
+          hosts: config2.hosts,
+          telemetry: this.config.telemetry
         });
         kvContext.setSession(config2.session);
         kvService.initialize(kvContext);
@@ -1767,7 +1771,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       includeAccountRegistryPermissions: config.includeAccountRegistryPermissions
     });
     this.tc = new import_sdk_core6.TinyCloud(this.auth, {
-      invokeAny: this.invokeAnyWithRuntimePermissions
+      invokeAny: this.invokeAnyWithRuntimePermissions,
+      telemetry: config.telemetry
     });
   }
   syncResolvedHostFromAuth() {
@@ -1999,7 +2004,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       invoke: this.invokeWithRuntimePermissions,
       invokeAny: this.invokeAnyWithRuntimePermissions,
       fetch: globalThis.fetch.bind(globalThis),
-      hosts: [this.config.host]
+      hosts: [this.config.host],
+      telemetry: this.config.telemetry
     });
     this._kv = new import_sdk_core6.KVService({});
     this._kv.initialize(this._serviceContext);
@@ -2110,7 +2116,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       includeAccountRegistryPermissions: this.config.includeAccountRegistryPermissions
     });
     this.tc = new import_sdk_core6.TinyCloud(this.auth, {
-      invokeAny: this.invokeAnyWithRuntimePermissions
+      invokeAny: this.invokeAnyWithRuntimePermissions,
+      telemetry: this.config.telemetry
     });
     this.config.prefix = prefix;
   }
@@ -2154,7 +2161,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       includeAccountRegistryPermissions: this.config.includeAccountRegistryPermissions
     });
     this.tc = new import_sdk_core6.TinyCloud(this.auth, {
-      invokeAny: this.invokeAnyWithRuntimePermissions
+      invokeAny: this.invokeAnyWithRuntimePermissions,
+      telemetry: this.config.telemetry
     });
     this.config.prefix = prefix;
   }
@@ -2172,7 +2180,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       invoke: this.invokeWithRuntimePermissions,
       invokeAny: this.invokeAnyWithRuntimePermissions,
       fetch: globalThis.fetch.bind(globalThis),
-      hosts: [this.config.host]
+      hosts: [this.config.host],
+      telemetry: this.config.telemetry
     });
     this._kv = new import_sdk_core6.KVService({});
     this._kv.initialize(this._serviceContext);
@@ -2211,7 +2220,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       const spaceScopedContext = new import_sdk_core6.ServiceContext({
         invoke: this._serviceContext.invoke,
         fetch: this._serviceContext.fetch,
-        hosts: this._serviceContext.hosts
+        hosts: this._serviceContext.hosts,
+        telemetry: this.config.telemetry
       });
       const session = this._serviceContext.session;
       if (session) {
@@ -2776,12 +2786,41 @@ var _TinyCloudNode = class _TinyCloudNode {
     const spaceScopedContext = new import_sdk_core6.ServiceContext({
       invoke: this._serviceContext.invoke,
       fetch: this._serviceContext.fetch,
-      hosts: this._serviceContext.hosts
+      hosts: this._serviceContext.hosts,
+      telemetry: this.config.telemetry
     });
     spaceScopedContext.setSession({ ...this._serviceContext.session, spaceId });
     sql.initialize(spaceScopedContext);
     return sql;
   }
+  /**
+   * Get a KV service scoped to a specific space.
+   *
+   * The KV counterpart to {@link sqlForSpace}: clones the active service
+   * context and overrides its session's spaceId so that subsequent
+   * `kv/<action>` invocations route to that space. Useful for reading data
+   * that a manifest app stores outside the primary space (e.g. transcripts a
+   * `defaults: true` app keeps under the owner's `applications` space), when
+   * the caller already holds a delegation covering the target space.
+   *
+   * Does NOT auto-create the space.
+   *
+   * @param spaceId - Full space URI (`tinycloud:pkh:eip155:<chain>:<addr>:<name>`).
+   */
+  kvForSpace(spaceId) {
+    if (!this._serviceContext || !this._serviceContext.session) {
+      throw new Error("Not signed in. Call signIn() first.");
+    }
+    const kv = new import_sdk_core6.KVService({});
+    const spaceScopedContext = new import_sdk_core6.ServiceContext({
+      invoke: this._serviceContext.invoke,
+      fetch: this._serviceContext.fetch,
+      hosts: this._serviceContext.hosts
+    });
+    spaceScopedContext.setSession({ ...this._serviceContext.session, spaceId });
+    kv.initialize(spaceScopedContext);
+    return kv;
+  }
   /**
    * DuckDB database operations on this user's space.
    */
@@ -3348,7 +3387,8 @@ var _TinyCloudNode = class _TinyCloudNode {
       const publicContext = new import_sdk_core6.ServiceContext({
         invoke: this.invokeWithRuntimePermissions,
         fetch: this._serviceContext.fetch,
-        hosts: this._serviceContext.hosts
+        hosts: this._serviceContext.hosts,
+        telemetry: this.config.telemetry
       });
       publicContext.setSession({
         delegationHeader: delegationSession.delegationHeader,
@@ -4244,7 +4284,13 @@ var _TinyCloudNode = class _TinyCloudNode {
         },
         delegation.expiry
       );
-      return new DelegatedAccess(session2, delegation, targetHost, this.wasmBindings.invoke);
+      return new DelegatedAccess(
+        session2,
+        delegation,
+        targetHost,
+        this.wasmBindings.invoke,
+        this.config.telemetry
+      );
     }
     const mySession = this.auth?.tinyCloudSession;
     if (!mySession) {
@@ -4322,7 +4368,13 @@ var _TinyCloudNode = class _TinyCloudNode {
       },
       expirationTime
     );
-    return new DelegatedAccess(session, delegation, targetHost, this.wasmBindings.invoke);
+    return new DelegatedAccess(
+      session,
+      delegation,
+      targetHost,
+      this.wasmBindings.invoke,
+      this.config.telemetry
+    );
   }
   /**
    * Create a sub-delegation from a received delegation.