@enbox/dwn-clients 0.0.2

package/README.md

@@ -0,0 +1,73 @@
+# @enbox/dwn-clients
+
+Client libraries and shared types for communicating with [DWN Servers](../dwn-server).
+
+## What's Included
+
+### Transport Clients
+
+| Export | Description |
+|---|---|
+| `HttpDwnRpcClient` | HTTP client for DWN JSON-RPC endpoints |
+| `WebSocketDwnRpcClient` | WebSocket client for DWN JSON-RPC with subscriptions |
+| `Web5RpcClient` | Transport multiplexer — routes to HTTP or WebSocket based on URL scheme |
+| `HttpWeb5RpcClient` | HTTP client with DID RPC support |
+| `WebSocketWeb5RpcClient` | WebSocket client with DID RPC support |
+| `DwnRegistrar` | HTTP client for DWN tenant registration (proof-of-work challenge flow) |
+
+### JSON-RPC
+
+| Export | Description |
+|---|---|
+| `createJsonRpcRequest` | Factory for JSON-RPC 2.0 request objects |
+| `createJsonRpcSuccessResponse` | Factory for JSON-RPC success responses |
+| `createJsonRpcErrorResponse` | Factory for JSON-RPC error responses |
+| `JsonRpcSocket` | Persistent WebSocket wrapper for JSON-RPC messaging |
+
+### Shared Types
+
+Types used by both `@enbox/dwn-server` (server-side) and clients:
+
+| Type | Description |
+|---|---|
+| `ServerInfo` | Full `/info` endpoint response shape |
+| `ProofOfWorkChallengeModel` | `GET /registration/proof-of-work` response |
+| `RegistrationData` | Tenant registration data (`did` + `termsOfServiceHash`) |
+| `RegistrationRequest` | `POST /registration` request body |
+| `JsonRpcRequest` / `JsonRpcResponse` | JSON-RPC 2.0 message envelopes |
+| `DwnRpcRequest` / `DwnRpcResponse` | DWN-specific RPC request/response |
+
+### Utilities
+
+| Export | Description |
+|---|---|
+| `concatenateUrl` | Join a base URL and path segment with exactly one `/` |
+| `DwnServerInfoCacheMemory` | In-memory cache for `ServerInfo` with TTL |
+
+## Usage
+
+```typescript
+import { Web5RpcClient } from '@enbox/dwn-clients';
+
+const rpc = new Web5RpcClient();
+
+// Send a DWN request over HTTP
+const response = await rpc.sendDwnRequest({
+  dwnUrl    : 'https://dwn.example.com',
+  targetDid : 'did:dht:abc123',
+  message   : recordsWriteMessage,
+  data      : dataStream,
+});
+
+// Get server info
+const info = await rpc.getServerInfo('https://dwn.example.com');
+console.log(info.registrationRequirements); // ['proof-of-work-sha256-v0', 'terms-of-service']
+
+// Register a tenant
+import { DwnRegistrar } from '@enbox/dwn-clients';
+await DwnRegistrar.registerTenant('https://dwn.example.com', 'did:dht:abc123');
+```
+
+## License
+
+Apache-2.0

package/dist/esm/dwn-registrar.js

@@ -0,0 +1,119 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { concatenateUrl } from './utils.js';
+import { Convert } from '@enbox/common';
+import { CryptoUtils, Sha256 } from '@enbox/crypto';
+/**
+ * A client for registering tenants with a DWN.
+ */
+export class DwnRegistrar {
+    /**
+     * Registers a new tenant with the given DWN.
+     * NOTE: Assumes the user has already accepted the terms of service.
+     * NOTE: Currently the DWN Server from `dwn-server` does not require user signature.
+     */
+    static registerTenant(dwnEndpoint, did) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const registrationEndpoint = concatenateUrl(dwnEndpoint, 'registration');
+            const termsOfUseEndpoint = concatenateUrl(registrationEndpoint, 'terms-of-service');
+            const proofOfWorkEndpoint = concatenateUrl(registrationEndpoint, 'proof-of-work');
+            // fetch the terms-of-service
+            const termsOfServiceGetResponse = yield fetch(termsOfUseEndpoint, {
+                method: 'GET',
+            });
+            if (termsOfServiceGetResponse.status !== 200) {
+                const statusCode = termsOfServiceGetResponse.status;
+                const statusText = termsOfServiceGetResponse.statusText;
+                const errorText = yield termsOfServiceGetResponse.text();
+                throw new Error(`Failed fetching terms-of-service: ${statusCode} ${statusText}: ${errorText}`);
+            }
+            const termsOfServiceFetched = yield termsOfServiceGetResponse.text();
+            // fetch the proof-of-work challenge
+            const proofOfWorkChallengeGetResponse = yield fetch(proofOfWorkEndpoint, {
+                method: 'GET',
+            });
+            const { challengeNonce, maximumAllowedHashValue } = yield proofOfWorkChallengeGetResponse.json();
+            // create registration data based on the hash of the terms-of-service and the DID
+            const registrationData = {
+                did,
+                termsOfServiceHash: yield DwnRegistrar.hashAsHexString(termsOfServiceFetched),
+            };
+            // compute the proof-of-work response nonce based on the proof-of-work challenge and the registration data.
+            const responseNonce = yield DwnRegistrar.findQualifiedResponseNonce({
+                challengeNonce,
+                maximumAllowedHashValue,
+                requestData: JSON.stringify(registrationData),
+            });
+            // send the registration request to the server
+            const registrationRequest = {
+                registrationData,
+                proofOfWork: {
+                    challengeNonce,
+                    responseNonce,
+                },
+            };
+            const registrationResponse = yield fetch(registrationEndpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(registrationRequest),
+            });
+            if (registrationResponse.status !== 200) {
+                const statusCode = registrationResponse.status;
+                const statusText = registrationResponse.statusText;
+                const errorText = yield registrationResponse.text();
+                throw new Error(`Registration failed: ${statusCode} ${statusText}: ${errorText}`);
+            }
+        });
+    }
+    /**
+     * Computes the SHA-256 hash of the given array of strings.
+     */
+    static hashAsHexString(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const hashAsBytes = yield Sha256.digest({ data: Convert.string(input).toUint8Array() });
+            const hashAsHex = Convert.uint8Array(hashAsBytes).toHex();
+            return hashAsHex;
+        });
+    }
+    /**
+     * Finds a response nonce that qualifies the difficulty requirement for the given proof-of-work challenge and request data.
+     */
+    static findQualifiedResponseNonce(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const startTime = Date.now();
+            const { maximumAllowedHashValue, challengeNonce, requestData } = input;
+            const maximumAllowedHashValueAsBigInt = BigInt(`0x${maximumAllowedHashValue}`);
+            let iterations = 1;
+            let responseNonce;
+            let qualifiedSolutionNonceFound = false;
+            do {
+                responseNonce = yield this.generateNonce();
+                const computedHash = yield DwnRegistrar.hashAsHexString(challengeNonce + responseNonce + requestData);
+                const computedHashAsBigInt = BigInt(`0x${computedHash}`);
+                qualifiedSolutionNonceFound = computedHashAsBigInt <= maximumAllowedHashValueAsBigInt;
+                iterations++;
+            } while (!qualifiedSolutionNonceFound);
+            // Log final/successful iteration.
+            console.log(`iterations: ${iterations}, time lapsed: ${Date.now() - startTime} ms`);
+            return responseNonce;
+        });
+    }
+    /**
+     * Generates 32 random bytes expressed as a HEX string.
+     */
+    static generateNonce() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const randomBytes = CryptoUtils.randomBytes(32);
+            const hexString = Convert.uint8Array(randomBytes).toHex().toUpperCase();
+            return hexString;
+        });
+    }
+}
+//# sourceMappingURL=dwn-registrar.js.map

package/dist/esm/dwn-registrar.js.map

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

package/dist/esm/dwn-rpc-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dwn-rpc-types.js.map

package/dist/esm/dwn-rpc-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dwn-rpc-types.js","sourceRoot":"","sources":["../../src/dwn-rpc-types.ts"],"names":[],"mappings":""}

package/dist/esm/dwn-server-info-cache-memory.js

@@ -0,0 +1,74 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import ms from 'ms';
+import { TtlCache } from '@enbox/common';
+export class DwnServerInfoCacheMemory {
+    constructor({ ttl = '15m' } = {}) {
+        this.cache = new TtlCache({ ttl: ms(ttl) });
+    }
+    /**
+     * Retrieves a DWN ServerInfo entry from the cache.
+     *
+     * If the cached item has exceeded its TTL, it's scheduled for deletion and undefined is returned.
+     *
+     * @param dwnUrl - The DWN URL endpoint string used as the key for getting the entry.
+     * @returns The cached DWN ServerInfo entry or undefined if not found or expired.
+     */
+    get(dwnUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.cache.get(dwnUrl);
+        });
+    }
+    /**
+     * Stores a DWN ServerInfo entry in the cache with a TTL.
+     *
+     * @param dwnUrl - The DWN URL endpoint string used as the key for storing the entry.
+     * @param value - The DWN ServerInfo entry to be cached.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    set(dwnUrl, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.cache.set(dwnUrl, value);
+        });
+    }
+    /**
+     * Deletes a DWN ServerInfo entry from the cache.
+     *
+     * @param dwnUrl - The DWN URL endpoint string used as the key for deletion.
+     * @returns A promise that resolves when the operation is complete.
+     */
+    delete(dwnUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.cache.delete(dwnUrl);
+        });
+    }
+    /**
+     * Clears all entries from the cache.
+     *
+     * @returns A promise that resolves when the operation is complete.
+     */
+    clear() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.cache.clear();
+        });
+    }
+    /**
+     * This method is a no-op but exists to be consistent with other DWN ServerInfo Cache
+     * implementations.
+     *
+     * @returns A promise that resolves immediately.
+     */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // No-op since there is no underlying store to close.
+        });
+    }
+}
+//# sourceMappingURL=dwn-server-info-cache-memory.js.map

package/dist/esm/dwn-server-info-cache-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dwn-server-info-cache-memory.js","sourceRoot":"","sources":["../../src/dwn-server-info-cache-memory.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAmBzC,MAAM,OAAO,wBAAwB;IAGnC,YAAY,EAAE,GAAG,GAAG,KAAK,KAAoC,EAAE;QAC7D,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACU,GAAG,CAAC,MAAc;;YAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;KAAA;IAED;;;;;;OAMG;IACU,GAAG,CAAC,MAAc,EAAE,KAAiB;;YAChD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;KAAA;IAED;;;;;OAKG;IACU,MAAM,CAAC,MAAc;;YAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;KAAA;IAED;;;;OAIG;IACU,KAAK;;YAChB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KAAA;IAED;;;;;OAKG;IACU,KAAK;;YAChB,qDAAqD;QACvD,CAAC;KAAA;CACF"}

package/dist/esm/http-dwn-rpc-client.js

@@ -0,0 +1,115 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { CryptoUtils } from '@enbox/crypto';
+import { DataStream } from '@enbox/dwn-sdk-js';
+import { DwnServerInfoCacheMemory } from './dwn-server-info-cache-memory.js';
+import { createJsonRpcRequest, parseJson } from './json-rpc.js';
+/**
+ * HTTP client that can be used to communicate with Dwn Servers
+ */
+export class HttpDwnRpcClient {
+    constructor(serverInfoCache) {
+        this.serverInfoCache = serverInfoCache !== null && serverInfoCache !== void 0 ? serverInfoCache : new DwnServerInfoCacheMemory();
+    }
+    get transportProtocols() { return ['http:', 'https:']; }
+    sendDwnRequest(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestId = CryptoUtils.randomUuid();
+            const jsonRpcRequest = createJsonRpcRequest(requestId, 'dwn.processMessage', {
+                target: request.targetDid,
+                message: request.message
+            });
+            const requestHeaders = {
+                'dwn-request': JSON.stringify(jsonRpcRequest)
+            };
+            const fetchOpts = {
+                method: 'POST',
+                headers: requestHeaders,
+            };
+            if (request.data) {
+                requestHeaders['content-type'] = 'application/octet-stream';
+                fetchOpts.body = request.data;
+            }
+            const resp = yield fetch(request.dwnUrl, fetchOpts);
+            let dwnRpcResponse;
+            // When the server streams record data back, the JSON-RPC envelope is in the
+            // `dwn-response` header and the body is the raw data stream.  Otherwise the
+            // entire JSON-RPC response is the body.
+            const hasDataStream = resp.headers.has('dwn-response');
+            if (hasDataStream) {
+                const jsonRpcResponse = parseJson(resp.headers.get('dwn-response'));
+                if (jsonRpcResponse == null) {
+                    throw new Error(`failed to parse json rpc response. dwn url: ${request.dwnUrl}`);
+                }
+                dwnRpcResponse = jsonRpcResponse;
+            }
+            else {
+                const responseBody = yield resp.text();
+                dwnRpcResponse = JSON.parse(responseBody);
+            }
+            if (dwnRpcResponse.error) {
+                const { code, message } = dwnRpcResponse.error;
+                throw new Error(`(${code}) - ${message}`);
+            }
+            // Materialise the response body before attaching to the reply.
+            // Bun (<=1.3.9) has a bug where resp.body.getReader() can intermittently
+            // return undefined, crashing DataStream.toBytes() in its finally block.
+            // Buffering via arrayBuffer() is a safe workaround.
+            // TODO: https://github.com/enboxorg/enbox/issues/90 — remove once Bun ships fix
+            const { reply } = dwnRpcResponse.result;
+            if (hasDataStream) {
+                const bodyBytes = new Uint8Array(yield resp.arrayBuffer());
+                const dataStream = DataStream.fromBytes(bodyBytes);
+                if (reply.record) {
+                    reply.record.data = dataStream;
+                }
+                else if (reply.entry) {
+                    reply.entry.data = dataStream;
+                }
+            }
+            return reply;
+        });
+    }
+    getServerInfo(dwnUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const serverInfo = yield this.serverInfoCache.get(dwnUrl);
+            if (serverInfo) {
+                return serverInfo;
+            }
+            const url = new URL(dwnUrl);
+            // add `/info` to the dwn server url path
+            url.pathname.endsWith('/') ? url.pathname += 'info' : url.pathname += '/info';
+            try {
+                const response = yield fetch(url.toString());
+                if (response.ok) {
+                    const results = yield response.json();
+                    const serverInfo = {
+                        maxFileSize: results.maxFileSize,
+                        registrationRequirements: results.registrationRequirements,
+                        server: results.server,
+                        sdkVersion: results.sdkVersion,
+                        url: results.url,
+                        version: results.version,
+                        webSocketSupport: results.webSocketSupport,
+                    };
+                    this.serverInfoCache.set(dwnUrl, serverInfo);
+                    return serverInfo;
+                }
+                else {
+                    throw new Error(`HTTP (${response.status}) - ${response.statusText}`);
+                }
+            }
+            catch (error) {
+                throw new Error(`Error encountered while processing response from ${url.toString()}: ${error.message}`);
+            }
+        });
+    }
+}
+//# sourceMappingURL=http-dwn-rpc-client.js.map

package/dist/esm/http-dwn-rpc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-dwn-rpc-client.js","sourceRoot":"","sources":["../../src/http-dwn-rpc-client.ts"],"names":[],"mappings":";;;;;;;;;AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAE3B,YAAY,eAAoC;QAC9C,IAAI,CAAC,eAAe,GAAG,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,IAAI,wBAAwB,EAAE,CAAC;IAC3E,CAAC;IAED,IAAI,kBAAkB,KAAe,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5D,cAAc,CAAC,OAAsB;;YACzC,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC;YAC3C,MAAM,cAAc,GAAG,oBAAoB,CAAC,SAAS,EAAE,oBAAoB,EAAE;gBAC3E,MAAM,EAAI,OAAO,CAAC,SAAS;gBAC3B,OAAO,EAAG,OAAO,CAAC,OAAO;aAC1B,CAAC,CAAC;YAEH,MAAM,cAAc,GAA2B;gBAC7C,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;aAC9C,CAAC;YAEF,MAAM,SAAS,GAAgB;gBAC7B,MAAM,EAAI,MAAM;gBAChB,OAAO,EAAG,cAAc;aACzB,CAAC;YAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,cAAc,CAAC,cAAc,CAAC,GAAG,0BAA0B,CAAC;gBAC5D,SAAS,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAChC,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACpD,IAAI,cAA+B,CAAC;YAEpC,4EAA4E;YAC5E,4EAA4E;YAC5E,wCAAwC;YACxC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAEvD,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,eAAe,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAE,CAAoB,CAAC;gBAExF,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACnF,CAAC;gBAED,cAAc,GAAG,eAAe,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBACvC,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC5C,CAAC;YAED,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;gBACzB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,OAAO,OAAO,EAAE,CAAC,CAAC;YAC5C,CAAC;YAED,+DAA+D;YAC/D,yEAAyE;YACzE,wEAAwE;YACxE,oDAAoD;YACpD,gFAAgF;YAChF,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC;YACxC,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC3D,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBACnD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjB,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC;gBACjC,CAAC;qBAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBACvB,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,OAAO,KAAuB,CAAC;QACjC,CAAC;KAAA;IAEK,aAAa,CAAC,MAAc;;YAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1D,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;YAE5B,yCAAyC;YACzC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC;YAE9E,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC7C,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAChB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAgB,CAAC;oBAEpD,MAAM,UAAU,GAAe;wBAC7B,WAAW,EAAgB,OAAO,CAAC,WAAW;wBAC9C,wBAAwB,EAAG,OAAO,CAAC,wBAAwB;wBAC3D,MAAM,EAAqB,OAAO,CAAC,MAAM;wBACzC,UAAU,EAAiB,OAAO,CAAC,UAAU;wBAC7C,GAAG,EAAwB,OAAO,CAAC,GAAG;wBACtC,OAAO,EAAoB,OAAO,CAAC,OAAO;wBAC1C,gBAAgB,EAAW,OAAO,CAAC,gBAAgB;qBACpD,CAAC;oBACF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBAE7C,OAAO,UAAU,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,oDAAoD,GAAG,CAAC,QAAQ,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1G,CAAC;QACH,CAAC;KAAA;CACF"}

package/dist/esm/index.js

@@ -0,0 +1,12 @@
+export * from './dwn-registrar.js';
+export * from './dwn-rpc-types.js';
+export * from './dwn-server-info-cache-memory.js';
+export * from './http-dwn-rpc-client.js';
+export * from './json-rpc.js';
+export * from './json-rpc-socket.js';
+export * from './registration-types.js';
+export * from './rpc-client.js';
+export * from './server-info-types.js';
+export * from './utils.js';
+export * from './web-socket-clients.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC"}

package/dist/esm/json-rpc-socket.js

@@ -0,0 +1,175 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { CryptoUtils } from '@enbox/crypto';
+import { createJsonRpcSubscriptionRequest, parseJson } from './json-rpc.js';
+/**
+ * Converts WebSocket message data to a string.
+ * Bun's native WebSocket delivers `event.data` as an `ArrayBuffer`,
+ * whereas Node.js `ws` delivers it as a `string`.
+ */
+function toText(data) {
+    if (typeof data === 'string') {
+        return data;
+    }
+    if (data instanceof ArrayBuffer) {
+        return new TextDecoder().decode(data);
+    }
+    // Buffer / Uint8Array fallback
+    if (data instanceof Uint8Array) {
+        return new TextDecoder().decode(data);
+    }
+    return String(data);
+}
+// These were arbitrarily chosen, but can be modified via connect options
+const CONNECT_TIMEOUT = 3000;
+const RESPONSE_TIMEOUT = 30000;
+/**
+ * JSON RPC Socket Client for WebSocket request/response and long-running subscriptions.
+ */
+export class JsonRpcSocket {
+    constructor(socket, responseTimeout) {
+        this.socket = socket;
+        this.responseTimeout = responseTimeout;
+        this.messageHandlers = new Map();
+    }
+    static connect(url_1) {
+        return __awaiter(this, arguments, void 0, function* (url, options = {}) {
+            const { connectTimeout = CONNECT_TIMEOUT, responseTimeout = RESPONSE_TIMEOUT, onclose, onerror } = options;
+            const socket = new WebSocket(url);
+            if (!onclose) {
+                socket.onclose = () => {
+                    console.info(`JSON RPC Socket close ${url}`);
+                };
+            }
+            else {
+                socket.onclose = onclose;
+            }
+            if (!onerror) {
+                socket.onerror = (error) => {
+                    console.error(`JSON RPC Socket error ${url}`, error);
+                };
+            }
+            else {
+                socket.onerror = onerror;
+            }
+            return new Promise((resolve, reject) => {
+                socket.addEventListener('open', () => {
+                    const jsonRpcSocket = new JsonRpcSocket(socket, responseTimeout);
+                    socket.addEventListener('message', (event) => {
+                        const jsonRpcResponse = parseJson(toText(event.data));
+                        const handler = jsonRpcSocket.messageHandlers.get(jsonRpcResponse.id);
+                        if (handler) {
+                            handler(event);
+                        }
+                    });
+                    resolve(jsonRpcSocket);
+                });
+                socket.addEventListener('error', (error) => {
+                    reject(error);
+                });
+                setTimeout(() => reject(new Error('connect timed out')), connectTimeout);
+            });
+        });
+    }
+    close() {
+        this.socket.close();
+    }
+    /**
+     * Sends a JSON-RPC request through the socket and waits for a single response.
+     */
+    request(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => {
+                var _a;
+                (_a = request.id) !== null && _a !== void 0 ? _a : (request.id = CryptoUtils.randomUuid());
+                const handleResponse = (event) => {
+                    const jsonRpsResponse = parseJson(toText(event.data));
+                    if (jsonRpsResponse.id === request.id) {
+                        // if the incoming response id matches the request id, we will remove the listener and resolve the response
+                        this.messageHandlers.delete(request.id);
+                        return resolve(jsonRpsResponse);
+                    }
+                };
+                // add the listener to the map of message handlers
+                this.messageHandlers.set(request.id, handleResponse);
+                this.send(request);
+                // reject this promise if we don't receive any response back within the timeout period
+                setTimeout(() => {
+                    this.messageHandlers.delete(request.id);
+                    reject(new Error('request timed out'));
+                }, this.responseTimeout);
+            });
+        });
+    }
+    /**
+     * Sends a JSON-RPC request through the socket and keeps a listener open to read associated responses as they arrive.
+     * Returns a close method to clean up the listener.
+     */
+    subscribe(request, listener) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!request.method.startsWith('rpc.subscribe.')) {
+                throw new Error('subscribe rpc requests must include the `rpc.subscribe` prefix');
+            }
+            if (!request.subscription) {
+                throw new Error('subscribe rpc requests must include subscribe options');
+            }
+            const subscriptionId = request.subscription.id;
+            // Preserve any existing handler for this subscriptionId so that a rejected
+            // duplicate-subscribe attempt does not clobber an active subscription.
+            const existingHandler = this.messageHandlers.get(subscriptionId);
+            const socketEventListener = (event) => {
+                const jsonRpcResponse = parseJson(toText(event.data));
+                if (jsonRpcResponse.id === subscriptionId) {
+                    if (jsonRpcResponse.error !== undefined) {
+                        // remove the event listener upon receipt of a JSON RPC Error.
+                        this.messageHandlers.delete(subscriptionId);
+                        this.closeSubscription(subscriptionId).catch(() => {
+                            // swallow timeout errors; the subscription is already cleaned up locally.
+                        });
+                    }
+                    listener(jsonRpcResponse);
+                }
+            };
+            this.messageHandlers.set(subscriptionId, socketEventListener);
+            const response = yield this.request(request);
+            if (response.error) {
+                // Restore the previous handler if one existed, otherwise clean up.
+                if (existingHandler) {
+                    this.messageHandlers.set(subscriptionId, existingHandler);
+                }
+                else {
+                    this.messageHandlers.delete(subscriptionId);
+                }
+                return { response };
+            }
+            // clean up listener and create a `rpc.subscribe.close` message to use when closing this JSON RPC subscription
+            const close = () => __awaiter(this, void 0, void 0, function* () {
+                this.messageHandlers.delete(subscriptionId);
+                yield this.closeSubscription(subscriptionId);
+            });
+            return {
+                response,
+                close
+            };
+        });
+    }
+    closeSubscription(id) {
+        const requestId = CryptoUtils.randomUuid();
+        const request = createJsonRpcSubscriptionRequest(requestId, 'rpc.subscribe.close', {}, id);
+        return this.request(request);
+    }
+    /**
+     * Sends a JSON-RPC request through the socket. You must subscribe to a message listener separately to capture the response.
+     */
+    send(request) {
+        this.socket.send(JSON.stringify(request));
+    }
+}
+//# sourceMappingURL=json-rpc-socket.js.map

package/dist/esm/json-rpc-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc-socket.js","sourceRoot":"","sources":["../../src/json-rpc-socket.ts"],"names":[],"mappings":";;;;;;;;;AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gCAAgC,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5E;;;;GAIG;AACH,SAAS,MAAM,CAAC,IAAa;IAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;QAChC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,+BAA+B;IAC/B,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;QAC/B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,yEAAyE;AACzE,MAAM,eAAe,GAAG,IAAK,CAAC;AAC9B,MAAM,gBAAgB,GAAG,KAAM,CAAC;AAahC;;GAEG;AACH,MAAM,OAAO,aAAa;IAGxB,YAA4B,MAAiB,EAAU,eAAuB;QAAlD,WAAM,GAAN,MAAM,CAAW;QAAU,oBAAe,GAAf,eAAe,CAAQ;QAFtE,oBAAe,GAAmD,IAAI,GAAG,EAAE,CAAC;IAEH,CAAC;IAE3E,MAAM,CAAO,OAAO;6DAAC,GAAW,EAAE,UAAgC,EAAE;YACzE,MAAM,EAAE,cAAc,GAAG,eAAe,EAAE,eAAe,GAAG,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;YAE3G,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;YAElC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,CAAC,OAAO,GAAG,GAAQ,EAAE;oBACzB,OAAO,CAAC,IAAI,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;gBAC/C,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;YAC3B,CAAC;YAED,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,CAAC,OAAO,GAAG,CAAC,KAAW,EAAO,EAAE;oBACpC,OAAO,CAAC,KAAK,CAAC,yBAAyB,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;gBACvD,CAAC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;YAC3B,CAAC;YAED,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACpD,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;oBACnC,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;oBAEjE,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAoB,EAAE,EAAE;wBAC1D,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAoB,CAAC;wBACzE,MAAM,OAAO,GAAG,aAAa,CAAC,eAAe,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;wBACtE,IAAI,OAAO,EAAE,CAAC;4BACZ,OAAO,CAAC,KAAK,CAAC,CAAC;wBACjB,CAAC;oBACH,CAAC,CAAC,CAAC;oBAEH,OAAO,CAAC,aAAa,CAAC,CAAC;gBACzB,CAAC,CAAC,CAAC;gBAEH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAU,EAAE,EAAE;oBAC9C,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC,CAAC,CAAC;gBAEH,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YAC3E,CAAC,CAAC,CAAC;QACL,CAAC;KAAA;IAEM,KAAK;QACV,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACU,OAAO,CAAC,OAAuB;;YAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;;gBACrC,MAAA,OAAO,CAAC,EAAE,oCAAV,OAAO,CAAC,EAAE,GAAK,WAAW,CAAC,UAAU,EAAE,EAAC;gBAExC,MAAM,cAAc,GAAG,CAAC,KAAoB,EAAO,EAAE;oBACnD,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAoB,CAAC;oBACzE,IAAI,eAAe,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;wBACtC,2GAA2G;wBAC3G,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;wBACxC,OAAO,OAAO,CAAC,eAAe,CAAC,CAAC;oBAClC,CAAC;gBACH,CAAC,CAAC;gBAEF,kDAAkD;gBAClD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAG,EAAE,cAAc,CAAC,CAAC;gBACtD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAEnB,sFAAsF;gBACtF,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAG,CAAC,CAAC;oBACzC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBACzC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC;KAAA;IAED;;;OAGG;IACU,SAAS,CAAC,OAAuB,EAAE,QAA6C;;YAK3F,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;YACpF,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAC3E,CAAC;YAED,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAE/C,2EAA2E;YAC3E,uEAAuE;YACvE,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAEjE,MAAM,mBAAmB,GAAG,CAAC,KAAoB,EAAO,EAAE;gBACxD,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAoB,CAAC;gBACzE,IAAI,eAAe,CAAC,EAAE,KAAK,cAAc,EAAE,CAAC;oBAC1C,IAAI,eAAe,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;wBACxC,8DAA8D;wBAC9D,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;wBAC5C,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;4BAChD,0EAA0E;wBAC5E,CAAC,CAAC,CAAC;oBACL,CAAC;oBACD,QAAQ,CAAC,eAAe,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;YAE9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,mEAAmE;gBACnE,IAAI,eAAe,EAAE,CAAC;oBACpB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;gBAC5D,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC9C,CAAC;gBACD,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,CAAC;YAED,8GAA8G;YAC9G,MAAM,KAAK,GAAG,GAAwB,EAAE;gBACtC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC5C,MAAM,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;YAC/C,CAAC,CAAA,CAAC;YAEF,OAAO;gBACL,QAAQ;gBACR,KAAK;aACN,CAAC;QACJ,CAAC;KAAA;IAEO,iBAAiB,CAAC,EAAa;QACrC,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,gCAAgC,CAAC,SAAS,EAAE,qBAAqB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3F,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,OAAuB;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF"}