@tinycloud/node-sdk 2.0.4-beta.0 → 2.1.0-beta.0

package/dist/core.d.cts

@@ -1,4 +1,4 @@
-import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, IWasmBindings, SiweConfig, ClientSession, TinyCloudSession, Extension, Delegation, IKVService, ISQLService, IDuckDbService, INotificationHandler, IENSResolver, IDataVaultService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISharingService, CreateDelegationParams, DelegationResult, KeyProvider, ISessionManager, JWK } from '@tinycloud/sdk-core';
+import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, IWasmBindings, SiweConfig, ClientSession, TinyCloudSession, Extension, Delegation, IKVService, ISQLService, IDuckDbService, IHooksService, INotificationHandler, IENSResolver, IDataVaultService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISharingService, CreateDelegationParams, DelegationResult, KeyProvider, ISessionManager, JWK } from '@tinycloud/sdk-core';
 export { AutoApproveSpaceCreationHandler, AutoRejectStrategy, AutoSignStrategy, BatchOptions, BatchResponse, CallbackStrategy, CapabilityEntry, CapabilityKeyRegistry, CapabilityKeyRegistryErrorCode, CapabilityKeyRegistryErrorCodes, ClientSession, ColumnInfo, CreateDelegationParams, DataVaultConfig, DataVaultService, DatabaseHandle, Delegation, DelegationChain, DelegationChainV2, DelegationDirection, DelegationError, DelegationErrorCode, DelegationErrorCodes, DelegationFilters, DelegationManager, DelegationManagerConfig, DelegationRecord, DelegationResult, DuckDbAction, DuckDbActionType, DuckDbBatchOptions, DuckDbBatchResponse, DuckDbDatabaseHandle, DuckDbExecuteOptions, DuckDbExecuteResponse, DuckDbOptions, DuckDbQueryOptions, DuckDbQueryResponse, DuckDbService, DuckDbServiceConfig, DuckDbStatement, DuckDbValue, EncodedShareData, ExecuteOptions, ExecuteResponse, Extension, FetchFunction, GenerateShareParams, ICapabilityKeyRegistry, IDataVaultService, IDatabaseHandle, IDuckDbDatabaseHandle, IDuckDbService, IENSResolver, IKVService, INotificationHandler, IPrefixedKVService, ISQLService, ISessionManager, ISessionStorage, ISharingService, ISigner, ISpace, ISpaceCreationHandler, ISpaceScopedDelegations, ISpaceScopedSharing, ISpaceService, IUserAuthorization, IWasmBindings, IngestOptions, InvokeFunction, JWK, KVResponse, KVService, KVServiceConfig, KeyInfo, KeyProvider, KeyType, PersistedSessionData, PrefixedKVService, ProtocolMismatchError, QueryOptions, QueryResponse, ReceiveOptions, SQLAction, SQLActionType, SQLService, SQLServiceConfig, SchemaInfo, ServiceContext, ServiceContextConfig, ServiceSession, ShareAccess, ShareLink, ShareLinkData, ShareSchema, SharingService, SharingServiceConfig, SignCallback, SignRequest, SignResponse, SilentNotificationHandler, Space, SpaceConfig, SpaceCreationContext, SpaceErrorCode, SpaceErrorCodes, SpaceInfo, SpaceOwnership, SpaceService, SpaceServiceConfig, SqlStatement, SqlValue, StoredDelegationChain, TableInfo, TinyCloud, TinyCloudConfig, TinyCloudSession, UnsupportedFeatureError, VaultCrypto, VaultEntry, VaultError, VaultGetOptions, VaultGrantOptions, VaultHeaders, VaultListOptions, VaultPublicSpaceKVActions, VaultPutOptions, VersionCheckError, ViewInfo, WasmVaultFunctions, buildSpaceUri, checkNodeInfo, createCapabilityKeyRegistry, createSharingService, createSpaceService, createVaultCrypto, defaultSpaceCreationHandler, makePublicSpaceId, parseSpaceUri } from '@tinycloud/sdk-core';
 import { EventEmitter } from 'events';
 import { InvokeFunction } from '@tinycloud/sdk-services';
@@ -444,6 +444,7 @@ declare class DelegatedAccess {
     private _kv;
     private _sql;
     private _duckdb;
+    private _hooks;
     constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string, invoke: InvokeFunction);
     /**
      * Get the delegation this access was created from.
@@ -469,6 +470,10 @@ declare class DelegatedAccess {
      * DuckDB operations on the delegated space.
      */
     get duckdb(): IDuckDbService;
+    /**
+     * Hooks write-stream subscriptions on the delegated space.
+     */
+    get hooks(): IHooksService;
 }
 
 /**
@@ -573,6 +578,7 @@ declare class TinyCloudNode {
     private _kv?;
     private _sql?;
     private _duckdb?;
+    private _hooks?;
     private _vault?;
     /** Cached public KV with proper delegation (set by ensurePublicSpace) */
     private _publicKV?;
@@ -776,6 +782,10 @@ declare class TinyCloudNode {
      * Call `vault.unlock(signer)` after signIn() to derive encryption keys.
      */
     get vault(): IDataVaultService;
+    /**
+     * Hooks write stream subscription API.
+     */
+    get hooks(): IHooksService;
     /**
      * Get the CapabilityKeyRegistry for managing keys and their capabilities.
      *

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, IWasmBindings, SiweConfig, ClientSession, TinyCloudSession, Extension, Delegation, IKVService, ISQLService, IDuckDbService, INotificationHandler, IENSResolver, IDataVaultService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISharingService, CreateDelegationParams, DelegationResult, KeyProvider, ISessionManager, JWK } from '@tinycloud/sdk-core';
+import { ISessionStorage, PersistedSessionData, AutoSignStrategy, AutoRejectStrategy, CallbackStrategy, IUserAuthorization, ISigner, ISpaceCreationHandler, IWasmBindings, SiweConfig, ClientSession, TinyCloudSession, Extension, Delegation, IKVService, ISQLService, IDuckDbService, IHooksService, INotificationHandler, IENSResolver, IDataVaultService, ICapabilityKeyRegistry, DelegationManager, ISpaceService, ISharingService, CreateDelegationParams, DelegationResult, KeyProvider, ISessionManager, JWK } from '@tinycloud/sdk-core';
 export { AutoApproveSpaceCreationHandler, AutoRejectStrategy, AutoSignStrategy, BatchOptions, BatchResponse, CallbackStrategy, CapabilityEntry, CapabilityKeyRegistry, CapabilityKeyRegistryErrorCode, CapabilityKeyRegistryErrorCodes, ClientSession, ColumnInfo, CreateDelegationParams, DataVaultConfig, DataVaultService, DatabaseHandle, Delegation, DelegationChain, DelegationChainV2, DelegationDirection, DelegationError, DelegationErrorCode, DelegationErrorCodes, DelegationFilters, DelegationManager, DelegationManagerConfig, DelegationRecord, DelegationResult, DuckDbAction, DuckDbActionType, DuckDbBatchOptions, DuckDbBatchResponse, DuckDbDatabaseHandle, DuckDbExecuteOptions, DuckDbExecuteResponse, DuckDbOptions, DuckDbQueryOptions, DuckDbQueryResponse, DuckDbService, DuckDbServiceConfig, DuckDbStatement, DuckDbValue, EncodedShareData, ExecuteOptions, ExecuteResponse, Extension, FetchFunction, GenerateShareParams, ICapabilityKeyRegistry, IDataVaultService, IDatabaseHandle, IDuckDbDatabaseHandle, IDuckDbService, IENSResolver, IKVService, INotificationHandler, IPrefixedKVService, ISQLService, ISessionManager, ISessionStorage, ISharingService, ISigner, ISpace, ISpaceCreationHandler, ISpaceScopedDelegations, ISpaceScopedSharing, ISpaceService, IUserAuthorization, IWasmBindings, IngestOptions, InvokeFunction, JWK, KVResponse, KVService, KVServiceConfig, KeyInfo, KeyProvider, KeyType, PersistedSessionData, PrefixedKVService, ProtocolMismatchError, QueryOptions, QueryResponse, ReceiveOptions, SQLAction, SQLActionType, SQLService, SQLServiceConfig, SchemaInfo, ServiceContext, ServiceContextConfig, ServiceSession, ShareAccess, ShareLink, ShareLinkData, ShareSchema, SharingService, SharingServiceConfig, SignCallback, SignRequest, SignResponse, SilentNotificationHandler, Space, SpaceConfig, SpaceCreationContext, SpaceErrorCode, SpaceErrorCodes, SpaceInfo, SpaceOwnership, SpaceService, SpaceServiceConfig, SqlStatement, SqlValue, StoredDelegationChain, TableInfo, TinyCloud, TinyCloudConfig, TinyCloudSession, UnsupportedFeatureError, VaultCrypto, VaultEntry, VaultError, VaultGetOptions, VaultGrantOptions, VaultHeaders, VaultListOptions, VaultPublicSpaceKVActions, VaultPutOptions, VersionCheckError, ViewInfo, WasmVaultFunctions, buildSpaceUri, checkNodeInfo, createCapabilityKeyRegistry, createSharingService, createSpaceService, createVaultCrypto, defaultSpaceCreationHandler, makePublicSpaceId, parseSpaceUri } from '@tinycloud/sdk-core';
 import { EventEmitter } from 'events';
 import { InvokeFunction } from '@tinycloud/sdk-services';
@@ -444,6 +444,7 @@ declare class DelegatedAccess {
     private _kv;
     private _sql;
     private _duckdb;
+    private _hooks;
     constructor(session: TinyCloudSession, delegation: PortableDelegation, host: string, invoke: InvokeFunction);
     /**
      * Get the delegation this access was created from.
@@ -469,6 +470,10 @@ declare class DelegatedAccess {
      * DuckDB operations on the delegated space.
      */
     get duckdb(): IDuckDbService;
+    /**
+     * Hooks write-stream subscriptions on the delegated space.
+     */
+    get hooks(): IHooksService;
 }
 
 /**
@@ -573,6 +578,7 @@ declare class TinyCloudNode {
     private _kv?;
     private _sql?;
     private _duckdb?;
+    private _hooks?;
     private _vault?;
     /** Cached public KV with proper delegation (set by ensurePublicSpace) */
     private _publicKV?;
@@ -776,6 +782,10 @@ declare class TinyCloudNode {
      * Call `vault.unlock(signer)` after signIn() to derive encryption keys.
      */
     get vault(): IDataVaultService;
+    /**
+     * Hooks write stream subscription API.
+     */
+    get hooks(): IHooksService;
     /**
      * Get the CapabilityKeyRegistry for managing keys and their capabilities.
      *

package/dist/core.js

@@ -253,12 +253,22 @@ var NodeUserAuthorization = class {
       },
       capabilities: {
         "": ["tinycloud.capabilities/read"]
+      },
+      hooks: {
+        "": [
+          "tinycloud.hooks/subscribe",
+          "tinycloud.hooks/register",
+          "tinycloud.hooks/list",
+          "tinycloud.hooks/unregister"
+        ]
       }
     };
     this.sessionExpirationMs = config.sessionExpirationMs ?? 60 * 60 * 1e3;
     this.autoCreateSpace = config.autoCreateSpace ?? false;
     this.spaceCreationHandler = config.spaceCreationHandler;
-    this.tinycloudHosts = config.tinycloudHosts ?? ["https://node.tinycloud.xyz"];
+    this.tinycloudHosts = config.tinycloudHosts ?? [
+      "https://node.tinycloud.xyz"
+    ];
     this.enablePublicSpace = config.enablePublicSpace ?? true;
     this.nonce = config.nonce;
     this.siweConfig = config.siweConfig;
@@ -398,7 +408,10 @@ var NodeUserAuthorization = class {
           throw err;
         }
       } catch (error) {
-        handler.onSpaceCreationFailed?.(creationContext, error instanceof Error ? error : new Error(String(error)));
+        handler.onSpaceCreationFailed?.(
+          creationContext,
+          error instanceof Error ? error : new Error(String(error))
+        );
         throw error;
       }
       await new Promise((resolve) => setTimeout(resolve, 100));
@@ -432,7 +445,10 @@ var NodeUserAuthorization = class {
           throw err;
         }
       } catch (error) {
-        handler.onSpaceCreationFailed?.(creationContext, error instanceof Error ? error : new Error(String(error)));
+        handler.onSpaceCreationFailed?.(
+          creationContext,
+          error instanceof Error ? error : new Error(String(error))
+        );
         throw error;
       }
       await new Promise((resolve) => setTimeout(resolve, 100));
@@ -541,7 +557,10 @@ var NodeUserAuthorization = class {
     this._tinyCloudSession = tinyCloudSession;
     this._address = address;
     this._chainId = chainId;
-    const nodeInfo = await checkNodeInfo(this.tinycloudHosts[0], this.wasm.protocolVersion());
+    const nodeInfo = await checkNodeInfo(
+      this.tinycloudHosts[0],
+      this.wasm.protocolVersion()
+    );
     this._nodeFeatures = nodeInfo.features;
     for (const ext of this.extensions) {
       if (ext.afterSignIn) {
@@ -701,7 +720,10 @@ var NodeUserAuthorization = class {
     this._tinyCloudSession = tinyCloudSession;
     this._address = address;
     this._chainId = chainId;
-    const nodeInfo = await checkNodeInfo(this.tinycloudHosts[0], this.wasm.protocolVersion());
+    const nodeInfo = await checkNodeInfo(
+      this.tinycloudHosts[0],
+      this.wasm.protocolVersion()
+    );
     this._nodeFeatures = nodeInfo.features;
     for (const ext of this.extensions) {
       if (ext.afterSignIn) {
@@ -752,7 +774,9 @@ var NodeUserAuthorization = class {
         );
       }
       default:
-        throw new Error(`Unknown sign strategy: ${this.signStrategy.type}`);
+        throw new Error(
+          `Unknown sign strategy: ${this.signStrategy.type}`
+        );
     }
   }
   /**
@@ -786,6 +810,7 @@ import {
   KVService as KVService2,
   SQLService as SQLService2,
   DuckDbService as DuckDbService2,
+  HooksService as HooksService2,
   DataVaultService,
   createVaultCrypto,
   ServiceContext as ServiceContext2,
@@ -801,6 +826,7 @@ import {
 // src/DelegatedAccess.ts
 import {
   KVService,
+  HooksService,
   SQLService,
   DuckDbService,
   ServiceContext
@@ -825,6 +851,9 @@ var DelegatedAccess = class {
     this._duckdb = new DuckDbService({});
     this._duckdb.initialize(this._serviceContext);
     this._serviceContext.registerService("duckdb", this._duckdb);
+    this._hooks = new HooksService({});
+    this._hooks.initialize(this._serviceContext);
+    this._serviceContext.registerService("hooks", this._hooks);
     const serviceSession = {
       delegationHeader: session.delegationHeader,
       delegationCid: session.delegationCid,
@@ -870,6 +899,12 @@ var DelegatedAccess = class {
   get duckdb() {
     return this._duckdb;
   }
+  /**
+   * Hooks write-stream subscriptions on the delegated space.
+   */
+  get hooks() {
+    return this._hooks;
+  }
 };
 
 // src/keys/WasmKeyProvider.ts
@@ -1075,7 +1110,9 @@ var TinyCloudNode = class _TinyCloudNode {
       nonce: config.nonce,
       siweConfig: config.siweConfig
     });
-    this.tc = new TinyCloud(this.auth);
+    this.tc = new TinyCloud(this.auth, {
+      invokeAny: this.wasmBindings.invokeAny
+    });
   }
   /**
    * Get the primary identity DID for this user.
@@ -1144,6 +1181,7 @@ var TinyCloudNode = class _TinyCloudNode {
     this._kv = void 0;
     this._sql = void 0;
     this._duckdb = void 0;
+    this._hooks = void 0;
     this._serviceContext = void 0;
     await this.tc.signIn();
     this.initializeServices();
@@ -1163,6 +1201,7 @@ var TinyCloudNode = class _TinyCloudNode {
     this._kv = void 0;
     this._sql = void 0;
     this._duckdb = void 0;
+    this._hooks = void 0;
     this._serviceContext = void 0;
     if (sessionData.address) {
       this._address = sessionData.address;
@@ -1172,6 +1211,7 @@ var TinyCloudNode = class _TinyCloudNode {
     }
     this._serviceContext = new ServiceContext2({
       invoke: this.wasmBindings.invoke,
+      invokeAny: this.wasmBindings.invokeAny,
       fetch: globalThis.fetch.bind(globalThis),
       hosts: [this.config.host]
     });
@@ -1184,6 +1224,9 @@ var TinyCloudNode = class _TinyCloudNode {
     this._duckdb = new DuckDbService2({});
     this._duckdb.initialize(this._serviceContext);
     this._serviceContext.registerService("duckdb", this._duckdb);
+    this._hooks = new HooksService2({});
+    this._hooks.initialize(this._serviceContext);
+    this._serviceContext.registerService("hooks", this._hooks);
     const serviceSession = {
       delegationHeader: sessionData.delegationHeader,
       delegationCid: sessionData.delegationCid,
@@ -1283,7 +1326,9 @@ var TinyCloudNode = class _TinyCloudNode {
       nonce: this.config.nonce,
       siweConfig: this.config.siweConfig
     });
-    this.tc = new TinyCloud(this.auth);
+    this.tc = new TinyCloud(this.auth, {
+      invokeAny: this.wasmBindings.invokeAny
+    });
     this.config.prefix = prefix;
   }
   /**
@@ -1321,7 +1366,9 @@ var TinyCloudNode = class _TinyCloudNode {
       nonce: this.config.nonce,
       siweConfig: this.config.siweConfig
     });
-    this.tc = new TinyCloud(this.auth);
+    this.tc = new TinyCloud(this.auth, {
+      invokeAny: this.wasmBindings.invokeAny
+    });
     this.config.prefix = prefix;
   }
   /**
@@ -1336,6 +1383,7 @@ var TinyCloudNode = class _TinyCloudNode {
     this.tc.initializeServices(this.wasmBindings.invoke, [this.config.host]);
     this._serviceContext = new ServiceContext2({
       invoke: this.wasmBindings.invoke,
+      invokeAny: this.wasmBindings.invokeAny,
       fetch: globalThis.fetch.bind(globalThis),
       hosts: [this.config.host]
     });
@@ -1353,6 +1401,9 @@ var TinyCloudNode = class _TinyCloudNode {
       this._duckdb.initialize(this._serviceContext);
       this._serviceContext.registerService("duckdb", this._duckdb);
     }
+    this._hooks = new HooksService2({});
+    this._hooks.initialize(this._serviceContext);
+    this._serviceContext.registerService("hooks", this._hooks);
     const serviceSession = {
       delegationHeader: session.delegationHeader,
       delegationCid: session.delegationCid,
@@ -1731,6 +1782,15 @@ var TinyCloudNode = class _TinyCloudNode {
     }
     return this._vault;
   }
+  /**
+   * Hooks write stream subscription API.
+   */
+  get hooks() {
+    if (!this._hooks) {
+      throw new Error("Not signed in. Call signIn() first.");
+    }
+    return this._hooks;
+  }
   // ===========================================================================
   // v2 Service Accessors
   // ===========================================================================