@enbox/agent 0.1.8 → 0.2.0

package/dist/types/types/dwn.d.ts

@@ -1,43 +1,42 @@
 import type { DidService } from '@enbox/dids';
 import type { RequireOnly } from '@enbox/common';
-import type { GenericMessageReply, MessagesReadMessage, MessagesReadOptions, MessagesReadReply, MessagesSubscribeMessage, MessagesSubscribeOptions, MessagesSubscribeReply, MessagesSyncMessage, MessagesSyncReply, MessageSubscriptionHandler, ProtocolsConfigureMessage, ProtocolsConfigureOptions, ProtocolsQueryMessage, ProtocolsQueryOptions, ProtocolsQueryReply, RecordsDeleteMessage, RecordsDeleteOptions, RecordsQueryMessage, RecordsQueryOptions, RecordsQueryReply, RecordsReadMessage, RecordsReadOptions, RecordsReadReply, RecordsSubscribeMessage, RecordsSubscribeOptions, RecordsSubscribeReply, RecordSubscriptionHandler, RecordsWriteMessage, RecordsWriteOptions } from '@enbox/dwn-sdk-js';
+import type { GenericMessageReply, MessagesReadMessage, MessagesReadOptions, MessagesReadReply, MessagesSubscribeMessage, MessagesSubscribeOptions, MessagesSubscribeReply, MessagesSyncMessage, MessagesSyncReply, ProtocolsConfigureMessage, ProtocolsConfigureOptions, ProtocolsQueryMessage, ProtocolsQueryOptions, ProtocolsQueryReply, RecordsDeleteMessage, RecordsDeleteOptions, RecordsQueryMessage, RecordsQueryOptions, RecordsQueryReply, RecordsReadMessage, RecordsReadOptions, RecordsReadReply, RecordsSubscribeMessage, RecordsSubscribeOptions, RecordsSubscribeReply, RecordsWriteMessage, RecordsWriteOptions, SubscriptionListener } from '@enbox/dwn-sdk-js';
 import type { MessagesSyncOptions } from '@enbox/dwn-sdk-js';
 import { MessagesRead, MessagesSubscribe, MessagesSync, ProtocolsConfigure, ProtocolsQuery, RecordsDelete, RecordsQuery, RecordsRead, RecordsSubscribe, RecordsWrite } from '@enbox/dwn-sdk-js';
 /**
  * Represents a Decentralized Web Node (DWN) service in a DID Document.
  *
  * A DWN DID service is a specialized type of DID service with the `type` set to
- * `DecentralizedWebNode`. It includes specific properties `enc` and `sig` that are used to identify
- * the public keys that can be used to interact with the DID Subject. The values of these properties
- * are strings or arrays of strings containing one or more verification method `id` values present in
- * the same DID document. If the `enc` and/or `sig` properties are an array of strings, an entity
- * interacting with the DID subject is expected to use the verification methods in the order they
- * are listed.
+ * `DecentralizedWebNode`. Encryption and signing keys are resolved from the DID document's
+ * verification methods, not from the service entry.
+ *
+ * The `enc` and `sig` properties are optional legacy fields that may be present on existing
+ * DID documents for backward compatibility. New implementations should resolve keys from the
+ * DID document's verification methods by purpose (`keyAgreement` for encryption,
+ * `authentication`/`assertionMethod` for signing).
  *
  * @example
  * ```ts
  * const service: DwnDidService = {
  *   id: 'did:example:123#dwn',
  *   type: 'DecentralizedWebNode',
- *   serviceEndpoint: 'https://enbox-dwn.fly.dev',
- *   enc: 'did:example:123#key-1',
- *   sig: 'did:example:123#key-2'
+ *   serviceEndpoint: 'https://enbox-dwn.fly.dev'
  * }
  * ```
  *
- * @see {@link https://identity.foundation/decentralized-web-node/spec/ | DIF Decentralized Web Node (DWN) Specification}
+ * @see {@link https://github.com/enboxorg/dwn-spec | Enbox DWN Specification}
  */
 export interface DwnDidService extends DidService {
     /**
-     * One or more verification method `id` values that can be used to encrypt information
-     * intended for the DID subject.
+     * @deprecated Optional legacy field. Resolve encryption keys from the DID document's
+     * `keyAgreement` verification methods instead.
      */
     enc?: string | string[];
     /**
-     * One or more verification method `id` values that will be used by the DID subject to sign data
-     * or by another entity to verify signatures created by the DID subject.
+     * @deprecated Optional legacy field. Resolve signing keys from the DID document's
+     * `authentication` or `assertionMethod` verification methods instead.
      */
-    sig: string | string[];
+    sig?: string | string[];
 }
 export declare enum DwnInterface {
     MessagesRead = "MessagesRead",
@@ -101,8 +100,8 @@ export interface DwnMessageReply {
     [DwnInterface.RecordsWrite]: GenericMessageReply;
 }
 export interface MessageHandler {
-    [DwnInterface.MessagesSubscribe]: MessageSubscriptionHandler;
-    [DwnInterface.RecordsSubscribe]: RecordSubscriptionHandler;
+    [DwnInterface.MessagesSubscribe]: SubscriptionListener;
+    [DwnInterface.RecordsSubscribe]: SubscriptionListener;
     [DwnInterface.MessagesRead]: undefined;
     [DwnInterface.MessagesSync]: undefined;
     [DwnInterface.ProtocolsConfigure]: undefined;
@@ -177,5 +176,5 @@ export type DwnMessageWithData<T extends DwnInterface> = {
     dataStream?: ReadableStream<Uint8Array>;
 };
 export { DateSort as DwnDateSort, DwnConstant, ContentEncryptionAlgorithm as DwnContentEncryptionAlgorithm, KeyDerivationScheme as DwnKeyDerivationScheme, PermissionGrant as DwnPermissionGrant, PermissionRequest as DwnPermissionRequest, PermissionsProtocol as DwnPermissionsProtocol, } from '@enbox/dwn-sdk-js';
-export type { DataEncodedRecordsWriteMessage as DwnDataEncodedRecordsWriteMessage, MessageSigner as DwnSigner, MessageSubscription as DwnMessageSubscription, MessageSubscriptionHandler as DwnMessageSubscriptionHandler, MessagesPermissionScope as DwnMessagesPermissionScope, PaginationCursor as DwnPaginationCursor, PermissionConditions as DwnPermissionConditions, PermissionGrantData as DwnPermissionGrantData, PermissionRequestData as DwnPermissionRequestData, PermissionScope as DwnPermissionScope, ProtocolDefinition as DwnProtocolDefinition, ProtocolPermissionScope as DwnProtocolPermissionScope, PublicKeyJwk as DwnPublicKeyJwk, RecordSubscriptionHandler as DwnRecordSubscriptionHandler, RecordsPermissionScope as DwnRecordsPermissionScope, } from '@enbox/dwn-sdk-js';
+export type { DataEncodedRecordsWriteMessage as DwnDataEncodedRecordsWriteMessage, MessageSigner as DwnSigner, MessageSubscription as DwnMessageSubscription, MessagesPermissionScope as DwnMessagesPermissionScope, PaginationCursor as DwnPaginationCursor, PermissionConditions as DwnPermissionConditions, PermissionGrantData as DwnPermissionGrantData, PermissionRequestData as DwnPermissionRequestData, PermissionScope as DwnPermissionScope, ProtocolDefinition as DwnProtocolDefinition, ProtocolPermissionScope as DwnProtocolPermissionScope, PublicKeyJwk as DwnPublicKeyJwk, RecordsPermissionScope as DwnRecordsPermissionScope, SubscriptionListener as DwnSubscriptionListener, SubscriptionMessage as DwnSubscriptionMessage, } from '@enbox/dwn-sdk-js';
 //# sourceMappingURL=dwn.d.ts.map

package/dist/types/types/dwn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dwn.d.ts","sourceRoot":"","sources":["../../../src/types/dwn.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dwn.d.ts","sourceRoot":"","sources":["../../../src/types/dwn.ts"],"names":[],"mappings":"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"}

package/dist/types/types/sync.d.ts

@@ -12,11 +12,53 @@ export type SyncIdentityOptions = {
      */
     protocols: string[];
 };
+/**
+ * Connectivity state of the sync engine.
+ */
+export type SyncConnectivityState = 'online' | 'offline' | 'unknown';
+/**
+ * Describes the sync mode: `'poll'` for periodic SMT reconciliation,
+ * `'live'` for `MessagesSubscribe`-based real-time sync with SMT fallback.
+ */
+export type SyncMode = 'poll' | 'live';
+/**
+ * Parameters for {@link SyncEngine.startSync}.
+ */
+export type StartSyncParams = {
+    /**
+     * The sync mode to use. Default: `'poll'`.
+     *
+     * - `'live'`: Opens `MessagesSubscribe` WebSocket subscriptions to remote
+     *   DWNs for real-time pull, and listens to the local EventLog for immediate
+     *   push. Falls back to SMT reconciliation on cold start or long disconnect.
+     *   An infrequent SMT integrity check still runs at `interval`.
+     *
+     * - `'poll'`: Legacy mode. Performs a full SMT set-reconciliation sync on a
+     *   fixed interval. No WebSocket subscriptions are used.
+     */
+    mode?: SyncMode;
+    /**
+     * The interval at which the sync operation should be performed.
+     * Accepts any value recognised by `ms()`, e.g. `'30s'`, `'2m'`, `'10m'`.
+     *
+     * In `'live'` mode this controls the frequency of the SMT integrity check.
+     * In `'poll'` mode this controls the polling frequency.
+     *
+     * Default: `'2m'` (in poll mode), `'5m'` (in live mode).
+     */
+    interval?: string;
+};
 export interface SyncEngine {
     /**
      * The agent that the SyncEngine is attached to.
      */
     agent: Web5PlatformAgent;
+    /**
+     * Current connectivity state as observed by the sync engine.
+     * Updated when WebSocket subscriptions connect/disconnect or when the
+     * browser `online`/`offline` events fire.
+     */
+    readonly connectivityState: SyncConnectivityState;
     /**
      * Register an identity to be managed by the SyncEngine for syncing.
      * The options can define specific protocols that should only be synced, or a delegate DID that should be used to sign the sync messages.
@@ -48,13 +90,13 @@ export interface SyncEngine {
      */
     sync(direction?: 'push' | 'pull'): Promise<void>;
     /**
-     * Starts a periodic sync that runs at an interval. Subsequent calls to startSync will update the interval.
+     * Starts sync. In `'live'` mode opens real-time subscriptions with SMT
+     * fallback; in `'poll'` mode uses periodic SMT reconciliation.
      *
-     * @param params { interval: string } the interval at which the sync operation should be performed. ex: '30s', '1m', '10m'
+     * Subsequent calls update the mode/interval. Calling with a different mode
+     * tears down the previous mode's resources before starting the new one.
      */
-    startSync(params: {
-        interval: string;
-    }): Promise<void>;
+    startSync(params: StartSyncParams): Promise<void>;
     /**
      * Stops the periodic sync operation, will complete the current sync operation if one is already in progress.
      *

package/dist/types/types/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/types/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB,CAAC;AACF,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,KAAK,EAAE,iBAAiB,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAC1E;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F;;;;;OAKG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/types/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,KAAK,EAAE,iBAAiB,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;IAElD;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAC1E;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F;;;;;OAKG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enbox/agent",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/esm/index.js",
   "module": "./dist/esm/index.js",
@@ -71,11 +71,11 @@
   },
   "dependencies": {
     "@scure/bip39": "1.2.2",
-    "@enbox/dwn-clients": "0.0.5",
-    "@enbox/dwn-sdk-js": "0.0.7",
-    "@enbox/common": "0.0.3",
-    "@enbox/crypto": "0.0.4",
-    "@enbox/dids": "0.0.5",
+    "@enbox/dwn-clients": "0.0.7",
+    "@enbox/dwn-sdk-js": "0.1.0",
+    "@enbox/common": "0.0.5",
+    "@enbox/crypto": "0.0.6",
+    "@enbox/dids": "0.0.7",
     "abstract-level": "1.0.4",
     "ed25519-keygen": "0.4.11",
     "level": "8.0.0",

package/src/anonymous-dwn-api.ts

@@ -11,7 +11,7 @@ import type {
   RecordsQueryReply,
   RecordsReadReply,
   RecordsSubscribeReply,
-  RecordSubscriptionHandler,
+  SubscriptionListener,
 } from '@enbox/dwn-sdk-js';
 import type { DwnRpcRequest, Web5Rpc } from '@enbox/dwn-clients';
 
@@ -154,13 +154,13 @@ export class AnonymousDwnApi {
    *
    * @param target - The DID whose DWN to subscribe to.
    * @param params - Subscribe parameters (filter).
-   * @param handler - Callback for incoming record events.
+   * @param handler - Callback for incoming subscription messages (events and EOSE).
    * @returns The raw `RecordsSubscribeReply` from the remote DWN.
    */
   public async recordsSubscribe(
     target: string,
     params: AnonymousRecordsSubscribeParams,
-    handler: RecordSubscriptionHandler,
+    handler: SubscriptionListener,
   ): Promise<RecordsSubscribeReply> {
     const recordsSubscribe = await RecordsSubscribe.create({
       filter           : params.filter,
@@ -221,7 +221,7 @@ export class AnonymousDwnApi {
     target: string,
     message: unknown,
     data?: Blob,
-    subscriptionHandler?: RecordSubscriptionHandler,
+    subscriptionHandler?: SubscriptionListener,
   ): Promise<TReply> {
     const dwnEndpointUrls = await getDwnServiceEndpointUrls(target, this._didResolver);
     const errorMessages: { url: string; message: string }[] = [];

package/src/connect.ts

@@ -84,6 +84,7 @@ async function initClient({
     headers : {
       'Content-Type': 'application/x-www-form-urlencoded',
     },
+    signal: AbortSignal.timeout(30_000),
   });
 
   if (!parResponse.ok) {
@@ -112,7 +113,7 @@ async function initClient({
   });
 
   // subscribe to receiving a response from the wallet with default TTL. receive ciphertext of {@link Web5ConnectAuthResponse}
-  const authResponse = await pollWithTtl(() => fetch(tokenUrl));
+  const authResponse = await pollWithTtl(() => fetch(tokenUrl, { signal: AbortSignal.timeout(30_000) }));
 
   if (authResponse) {
     const jwe = await authResponse?.text();
@@ -224,19 +225,12 @@ function createPermissionRequestForProtocol({ definition, permissions }: Protoco
     method    : DwnMethodName.Query,
   });
 
-  // In order to enable sync, we must request permissions for `MessagesSync`, `MessagesRead` and `MessagesSubscribe`
+  // A Messages.Read grant is a unified scope that covers MessagesRead, MessagesSync, and MessagesSubscribe.
+  // This single grant enables sync and real-time subscriptions for the protocol.
   requests.push({
     protocol  : definition.protocol,
     interface : DwnInterfaceName.Messages,
     method    : DwnMethodName.Read,
-  }, {
-    protocol  : definition.protocol,
-    interface : DwnInterfaceName.Messages,
-    method    : DwnMethodName.Sync,
-  }, {
-    protocol  : definition.protocol,
-    interface : DwnInterfaceName.Messages,
-    method    : DwnMethodName.Subscribe,
   });
 
   // We also request any additional permissions the user has requested for this protocol