@enbox/dwn-clients 0.0.2

package/dist/esm/json-rpc.js

@@ -0,0 +1,77 @@
+export var JsonRpcErrorCodes;
+(function (JsonRpcErrorCodes) {
+    // JSON-RPC 2.0 pre-defined errors
+    JsonRpcErrorCodes[JsonRpcErrorCodes["InvalidRequest"] = -32600] = "InvalidRequest";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["MethodNotFound"] = -32601] = "MethodNotFound";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["InvalidParams"] = -32602] = "InvalidParams";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["InternalError"] = -32603] = "InternalError";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["ParseError"] = -32700] = "ParseError";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["TransportError"] = -32300] = "TransportError";
+    // App defined errors
+    JsonRpcErrorCodes[JsonRpcErrorCodes["BadRequest"] = -50400] = "BadRequest";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["Unauthorized"] = -50401] = "Unauthorized";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["Forbidden"] = -50403] = "Forbidden";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["Conflict"] = -50409] = "Conflict";
+})(JsonRpcErrorCodes || (JsonRpcErrorCodes = {}));
+export const createJsonRpcErrorResponse = (id, code, message, data) => {
+    const error = { code, message };
+    if (data != undefined) {
+        error.data = data;
+    }
+    return {
+        jsonrpc: '2.0',
+        id,
+        error,
+    };
+};
+export const createJsonRpcNotification = (method, params) => {
+    return {
+        jsonrpc: '2.0',
+        method,
+        params,
+    };
+};
+export const createJsonRpcRequest = (id, method, params) => {
+    return {
+        jsonrpc: '2.0',
+        id,
+        method,
+        params,
+    };
+};
+/**
+ * Creates a JSON-RPC subscription request.
+ *
+ * The caller is responsible for providing the full method name including
+ * any `rpc.subscribe.` prefix.
+ */
+export const createJsonRpcSubscriptionRequest = (id, method, params, subscriptionId) => {
+    return {
+        jsonrpc: '2.0',
+        id,
+        method,
+        params,
+        subscription: {
+            id: subscriptionId !== null && subscriptionId !== void 0 ? subscriptionId : null,
+        }
+    };
+};
+export const createJsonRpcSuccessResponse = (id, result) => {
+    return {
+        jsonrpc: '2.0',
+        id,
+        result: result !== null && result !== void 0 ? result : null,
+    };
+};
+/**
+ * Safely parses a JSON string, returning `null` on failure instead of throwing.
+ */
+export function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+//# sourceMappingURL=json-rpc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.js","sourceRoot":"","sources":["../../src/json-rpc.ts"],"names":[],"mappings":"AAyBA,MAAM,CAAN,IAAY,iBAcX;AAdD,WAAY,iBAAiB;IAC3B,kCAAkC;IAClC,kFAAuB,CAAA;IACvB,kFAAuB,CAAA;IACvB,gFAAsB,CAAA;IACtB,gFAAsB,CAAA;IACtB,0EAAmB,CAAA;IACnB,kFAAuB,CAAA;IAEvB,qBAAqB;IACrB,0EAAmB,CAAA;IACnB,8EAAqB,CAAA;IACrB,wEAAkB,CAAA;IAClB,sEAAiB,CAAA;AACnB,CAAC,EAdW,iBAAiB,KAAjB,iBAAiB,QAc5B;AAkBD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,EAAa,EACb,IAAuB,EACvB,OAAe,EACf,IAAU,EACY,EAAE;IACxB,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC9C,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,KAAK;KACN,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,MAAc,EACd,MAAY,EACI,EAAE;IAClB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,EAAa,EACb,MAAc,EACd,MAAsB,EACN,EAAE;IAClB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,EAAE;QACF,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAC9C,EAAa,EACb,MAAc,EACd,MAAY,EACZ,cAA0B,EACV,EAAE;IAClB,OAAO;QACL,OAAO,EAAQ,KAAK;QACpB,EAAE;QACF,MAAM;QACN,MAAM;QACN,YAAY,EAAG;YACb,EAAE,EAAE,cAAc,aAAd,cAAc,cAAd,cAAc,GAAI,IAAI;SAC3B;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,EAAa,EACb,MAAY,EACY,EAAE;IAC1B,OAAO;QACL,OAAO,EAAG,KAAK;QACf,EAAE;QACF,MAAM,EAAI,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,IAAI;KACzB,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/esm/registration-types.js

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

package/dist/esm/registration-types.js.map

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

package/dist/esm/rpc-client.js

@@ -0,0 +1,123 @@
+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 { createJsonRpcRequest } from './json-rpc.js';
+import { CryptoUtils } from '@enbox/crypto';
+import { HttpDwnRpcClient } from './http-dwn-rpc-client.js';
+import { WebSocketDwnRpcClient } from './web-socket-clients.js';
+export var DidRpcMethod;
+(function (DidRpcMethod) {
+    DidRpcMethod["Create"] = "did.create";
+    DidRpcMethod["Resolve"] = "did.resolve";
+})(DidRpcMethod || (DidRpcMethod = {}));
+/**
+ * Client used to communicate with Dwn Servers
+ */
+export class Web5RpcClient {
+    constructor(clients = []) {
+        this.transportClients = new Map();
+        // include http and socket clients as default.
+        // can be overwritten for 'http:', 'https:', 'ws: or ':wss' if instantiated with other clients.
+        clients = [new HttpWeb5RpcClient(), new WebSocketWeb5RpcClient(), ...clients];
+        for (const client of clients) {
+            for (const transportScheme of client.transportProtocols) {
+                this.transportClients.set(transportScheme, client);
+            }
+        }
+    }
+    get transportProtocols() {
+        return Array.from(this.transportClients.keys());
+    }
+    sendDidRequest(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // URL() will throw if provided `url` is invalid.
+            const url = new URL(request.url);
+            const transportClient = this.transportClients.get(url.protocol);
+            if (!transportClient) {
+                const error = new Error(`no ${url.protocol} transport client available`);
+                error.name = 'NO_TRANSPORT_CLIENT';
+                throw error;
+            }
+            return transportClient.sendDidRequest(request);
+        });
+    }
+    sendDwnRequest(request) {
+        // will throw if url is invalid
+        const url = new URL(request.dwnUrl);
+        const transportClient = this.transportClients.get(url.protocol);
+        if (!transportClient) {
+            const error = new Error(`no ${url.protocol} transport client available`);
+            error.name = 'NO_TRANSPORT_CLIENT';
+            throw error;
+        }
+        return transportClient.sendDwnRequest(request);
+    }
+    getServerInfo(dwnUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // will throw if url is invalid
+            const url = new URL(dwnUrl);
+            const transportClient = this.transportClients.get(url.protocol);
+            if (!transportClient) {
+                const error = new Error(`no ${url.protocol} transport client available`);
+                error.name = 'NO_TRANSPORT_CLIENT';
+                throw error;
+            }
+            return transportClient.getServerInfo(dwnUrl);
+        });
+    }
+}
+export class HttpWeb5RpcClient extends HttpDwnRpcClient {
+    sendDidRequest(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestId = CryptoUtils.randomUuid();
+            const jsonRpcRequest = createJsonRpcRequest(requestId, request.method, {
+                data: request.data
+            });
+            const httpRequest = new Request(request.url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(jsonRpcRequest),
+            });
+            let jsonRpcResponse;
+            try {
+                const response = yield fetch(httpRequest);
+                if (response.ok) {
+                    jsonRpcResponse = yield response.json();
+                    // If the response is an error, throw an error.
+                    if (jsonRpcResponse.error) {
+                        const { code, message } = jsonRpcResponse.error;
+                        throw new Error(`JSON RPC (${code}) - ${message}`);
+                    }
+                }
+                else {
+                    throw new Error(`HTTP (${response.status}) - ${response.statusText}`);
+                }
+            }
+            catch (error) {
+                throw new Error(`Error encountered while processing response from ${request.url}: ${error.message}`);
+            }
+            return jsonRpcResponse.result;
+        });
+    }
+}
+export class WebSocketWeb5RpcClient extends WebSocketDwnRpcClient {
+    sendDidRequest(_request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new Error(`not implemented for transports [${this.transportProtocols.join(', ')}]`);
+        });
+    }
+    getServerInfo(_dwnUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new Error(`not implemented for transports [${this.transportProtocols.join(', ')}]`);
+        });
+    }
+}
+//# sourceMappingURL=rpc-client.js.map

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

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

package/dist/esm/server-info-types.js

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

package/dist/esm/server-info-types.js.map

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

package/dist/esm/utils.js

@@ -0,0 +1,13 @@
+/** Concatenates a base URL and a path ensuring that there is exactly one slash between them. */
+export function concatenateUrl(baseUrl, path) {
+    // Remove trailing slash from baseUrl if it exists
+    if (baseUrl.endsWith('/')) {
+        baseUrl = baseUrl.slice(0, -1);
+    }
+    // Remove leading slash from path if it exists
+    if (path.startsWith('/')) {
+        path = path.slice(1);
+    }
+    return `${baseUrl}/${path}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,IAAY;IAC1D,kDAAkD;IAClD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,8CAA8C;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC;AAC9B,CAAC"}

package/dist/esm/web-socket-clients.js

@@ -0,0 +1,90 @@
+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 { JsonRpcSocket } from './json-rpc-socket.js';
+import { createJsonRpcRequest, createJsonRpcSubscriptionRequest } from './json-rpc.js';
+export class WebSocketDwnRpcClient {
+    get transportProtocols() { return ['ws:', 'wss:']; }
+    sendDwnRequest(request, jsonRpcSocketOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // validate that the dwn URL provided is a valid WebSocket URL
+            const url = new URL(request.dwnUrl);
+            if (url.protocol !== 'ws:' && url.protocol !== 'wss:') {
+                throw new Error(`Invalid websocket protocol ${url.protocol}`);
+            }
+            // check if there is already a connection to this host, if it does not exist, initiate a new connection
+            const hasConnection = WebSocketDwnRpcClient.connections.has(url.host);
+            if (!hasConnection) {
+                try {
+                    const socket = yield JsonRpcSocket.connect(url.toString(), jsonRpcSocketOptions);
+                    const subscriptions = new Map();
+                    WebSocketDwnRpcClient.connections.set(url.host, { socket, subscriptions });
+                }
+                catch (error) {
+                    throw new Error(`Error connecting to ${url.host}: ${error.message}`);
+                }
+            }
+            const connection = WebSocketDwnRpcClient.connections.get(url.host);
+            const { targetDid, message, subscriptionHandler } = request;
+            if (subscriptionHandler) {
+                return WebSocketDwnRpcClient.subscriptionRequest(connection, targetDid, message, subscriptionHandler);
+            }
+            return WebSocketDwnRpcClient.processMessage(connection, targetDid, message);
+        });
+    }
+    static processMessage(connection, target, message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestId = CryptoUtils.randomUuid();
+            const request = createJsonRpcRequest(requestId, 'dwn.processMessage', { target, message });
+            const { socket } = connection;
+            const response = yield socket.request(request);
+            const { error, result } = response;
+            if (error !== undefined) {
+                throw new Error(`error sending DWN request: ${error.message}`);
+            }
+            return result.reply;
+        });
+    }
+    static subscriptionRequest(connection, target, message, messageHandler) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestId = CryptoUtils.randomUuid();
+            const subscriptionId = CryptoUtils.randomUuid();
+            const request = createJsonRpcSubscriptionRequest(requestId, 'rpc.subscribe.dwn.processMessage', { target, message }, subscriptionId);
+            const { socket, subscriptions } = connection;
+            const { response, close } = yield socket.subscribe(request, (response) => {
+                const { result, error } = response;
+                if (error) {
+                    // if there is an error, close the subscription and delete it from the connection
+                    const subscription = subscriptions.get(subscriptionId);
+                    if (subscription) {
+                        subscription.close();
+                    }
+                    subscriptions.delete(subscriptionId);
+                    return;
+                }
+                const { event } = result;
+                messageHandler(event);
+            });
+            const { error, result } = response;
+            if (error) {
+                throw new Error(`could not subscribe via jsonrpc socket: ${error.message}`);
+            }
+            const { reply } = result;
+            if (reply.subscription && close) {
+                subscriptions.set(subscriptionId, Object.assign(Object.assign({}, reply.subscription), { close }));
+                reply.subscription.close = close;
+            }
+            return reply;
+        });
+    }
+}
+// a map of dwn host to WebSocket connection
+WebSocketDwnRpcClient.connections = new Map();
+//# sourceMappingURL=web-socket-clients.js.map

package/dist/esm/web-socket-clients.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * A client for registering tenants with a DWN.
+ */
+export declare 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: string, did: string): Promise<void>;
+    /**
+     * Computes the SHA-256 hash of the given array of strings.
+     */
+    static hashAsHexString(input: string): Promise<string>;
+    /**
+     * Finds a response nonce that qualifies the difficulty requirement for the given proof-of-work challenge and request data.
+     */
+    static findQualifiedResponseNonce(input: {
+        maximumAllowedHashValue: string;
+        challengeNonce: string;
+        requestData: string;
+    }): Promise<string>;
+    /**
+     * Generates 32 random bytes expressed as a HEX string.
+     */
+    static generateNonce(): Promise<string>;
+}
+//# sourceMappingURL=dwn-registrar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dwn-registrar.d.ts","sourceRoot":"","sources":["../../src/dwn-registrar.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;OAIG;WACiB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DnF;;OAEG;WACiB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnE;;OAEG;WACiB,0BAA0B,CAAC,KAAK,EAAE;QACpD,uBAAuB,EAAE,MAAM,CAAC;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BnB;;OAEG;WACiB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CAKrD"}

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

@@ -0,0 +1,45 @@
+import type { MessageSubscriptionHandler, RecordsReadReply, RecordSubscriptionHandler, UnionMessageReply } from '@enbox/dwn-sdk-js';
+export interface SerializableDwnMessage {
+    toJSON(): string;
+}
+export type DwnSubscriptionHandler = MessageSubscriptionHandler | RecordSubscriptionHandler;
+/**
+ * Interface for communicating with {@link https://github.com/enboxorg/enbox | DWN Servers}
+ * via JSON-RPC, supporting operations like sending DWN requests.
+ */
+export interface DwnRpc {
+    /**
+     * Lists the transport protocols supported by the DWN RPC client, such as HTTP or HTTPS.
+     * @returns An array of strings representing the supported transport protocols.
+     */
+    get transportProtocols(): string[];
+    /**
+     * Sends a request to a DWN Server using the specified DWN RPC request parameters.
+     *
+     * @param request - The DWN RPC request containing the URL, target DID, message, and optional data.
+     * @returns A promise that resolves to the response from the DWN server.
+     */
+    sendDwnRequest(request: DwnRpcRequest): Promise<DwnRpcResponse>;
+}
+/**
+ * Represents a JSON RPC request to a DWN server, including the URL, target DID, the message to be
+ * processed, and optional data.
+ */
+export type DwnRpcRequest = {
+    /** Optional data to be sent with the request. */
+    data?: any;
+    /** The URL of the DWN server to which the request is sent. */
+    dwnUrl: string;
+    /** The message to be processed by the DWN server, which can be a serializable DWN message. */
+    message: SerializableDwnMessage | any;
+    /** The DID of the target to which the message is addressed. */
+    targetDid: string;
+    /** Optional subscription handler for DWN message events. */
+    subscriptionHandler?: DwnSubscriptionHandler;
+};
+/**
+ * Represents the JSON RPC response from a DWN server to a request, combining the results of various
+ * DWN operations.
+ */
+export type DwnRpcResponse = UnionMessageReply & RecordsReadReply;
+//# sourceMappingURL=dwn-rpc-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dwn-rpc-types.d.ts","sourceRoot":"","sources":["../../src/dwn-rpc-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEpI,MAAM,WAAW,sBAAsB;IACrC,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,GAAG,yBAAyB,CAAC;AAE5F;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,IAAI,kBAAkB,IAAI,MAAM,EAAE,CAAA;IAElC;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CAChE;AAGD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,GAAG,CAAC;IAEX,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IAEf,8FAA8F;IAC9F,OAAO,EAAE,sBAAsB,GAAG,GAAG,CAAC;IAEtC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAElB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,sBAAsB,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,CAAC"}

package/dist/types/dwn-server-info-cache-memory.d.ts

@@ -0,0 +1,57 @@
+import type { DwnServerInfoCache, ServerInfo } from './server-info-types.js';
+/**
+ * Configuration parameters for creating an in-memory cache for DWN ServerInfo entries.
+ *
+ * Allows customization of the cache time-to-live (TTL) setting.
+ */
+export type DwnServerInfoCacheMemoryParams = {
+    /**
+     * Optional. The time-to-live for cache entries, expressed as a string (e.g., '1h', '15m').
+     * Determines how long a cache entry should remain valid before being considered expired.
+     *
+     * Defaults to '15m' if not specified.
+     */
+    ttl?: string;
+};
+export declare class DwnServerInfoCacheMemory implements DwnServerInfoCache {
+    private cache;
+    constructor({ ttl }?: DwnServerInfoCacheMemoryParams);
+    /**
+     * 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: string): Promise<ServerInfo | undefined>;
+    /**
+     * 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: string, value: ServerInfo): Promise<void>;
+    /**
+     * 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: string): Promise<void>;
+    /**
+     * Clears all entries from the cache.
+     *
+     * @returns A promise that resolves when the operation is complete.
+     */
+    clear(): Promise<void>;
+    /**
+     * This method is a no-op but exists to be consistent with other DWN ServerInfo Cache
+     * implementations.
+     *
+     * @returns A promise that resolves immediately.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=dwn-server-info-cache-memory.d.ts.map

package/dist/types/dwn-server-info-cache-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dwn-server-info-cache-memory.d.ts","sourceRoot":"","sources":["../../src/dwn-server-info-cache-memory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,OAAO,CAAC,KAAK,CAA+B;gBAEhC,EAAE,GAAW,EAAE,GAAE,8BAAkC;IAI/D;;;;;;;OAOG;IACU,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAE,SAAS,CAAC;IAIhE;;;;;;OAMG;IACU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE;;;;;OAKG;IACU,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD;;;;OAIG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}

package/dist/types/http-dwn-rpc-client.d.ts

@@ -0,0 +1,13 @@
+import type { DwnRpc, DwnRpcRequest, DwnRpcResponse } from './dwn-rpc-types.js';
+import type { DwnServerInfoCache, ServerInfo } from './server-info-types.js';
+/**
+ * HTTP client that can be used to communicate with Dwn Servers
+ */
+export declare class HttpDwnRpcClient implements DwnRpc {
+    private serverInfoCache;
+    constructor(serverInfoCache?: DwnServerInfoCache);
+    get transportProtocols(): string[];
+    sendDwnRequest(request: DwnRpcRequest): Promise<DwnRpcResponse>;
+    getServerInfo(dwnUrl: string): Promise<ServerInfo>;
+}
+//# sourceMappingURL=http-dwn-rpc-client.d.ts.map

package/dist/types/http-dwn-rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-dwn-rpc-client.d.ts","sourceRoot":"","sources":["../../src/http-dwn-rpc-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAO7E;;GAEG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,OAAO,CAAC,eAAe,CAAqB;gBAChC,eAAe,CAAC,EAAE,kBAAkB;IAIhD,IAAI,kBAAkB,IAAI,MAAM,EAAE,CAAgC;IAE5D,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAkE/D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAmCzD"}

package/dist/types/index.d.ts

@@ -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.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/types/json-rpc-socket.d.ts

@@ -0,0 +1,40 @@
+import type { JsonRpcRequest, JsonRpcResponse } from './json-rpc.js';
+export interface JsonRpcSocketOptions {
+    /** socket connection timeout in milliseconds */
+    connectTimeout?: number;
+    /** response timeout for rpc requests in milliseconds */
+    responseTimeout?: number;
+    /** optional connection close handler */
+    onclose?: () => void;
+    /** optional socket error handler */
+    onerror?: (error?: any) => void;
+}
+/**
+ * JSON RPC Socket Client for WebSocket request/response and long-running subscriptions.
+ */
+export declare class JsonRpcSocket {
+    private socket;
+    private responseTimeout;
+    private messageHandlers;
+    private constructor();
+    static connect(url: string, options?: JsonRpcSocketOptions): Promise<JsonRpcSocket>;
+    close(): void;
+    /**
+     * Sends a JSON-RPC request through the socket and waits for a single response.
+     */
+    request(request: JsonRpcRequest): Promise<JsonRpcResponse>;
+    /**
+     * 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: JsonRpcRequest, listener: (response: JsonRpcResponse) => void): Promise<{
+        response: JsonRpcResponse;
+        close?: () => Promise<void>;
+    }>;
+    private closeSubscription;
+    /**
+     * Sends a JSON-RPC request through the socket. You must subscribe to a message listener separately to capture the response.
+     */
+    send(request: JsonRpcRequest): void;
+}
+//# sourceMappingURL=json-rpc-socket.d.ts.map

package/dist/types/json-rpc-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc-socket.d.ts","sourceRoot":"","sources":["../../src/json-rpc-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA4BhF,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,qBAAa,aAAa;IAGJ,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,eAAe;IAFtE,OAAO,CAAC,eAAe,CAA6D;IAEpF,OAAO;WAEa,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IA4C7F,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACU,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAyBvE;;;OAGG;IACU,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC;QACtG,QAAQ,EAAE,eAAe,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5B,CAAC;IAuDH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACI,IAAI,CAAC,OAAO,EAAE,cAAc,GAAE,IAAI;CAG1C"}

package/dist/types/json-rpc.d.ts

@@ -0,0 +1,64 @@
+export type JsonRpcId = string | number | null;
+export type JsonRpcParams = any;
+export type JsonRpcVersion = '2.0';
+export interface JsonRpcRequest {
+    jsonrpc: JsonRpcVersion;
+    id?: JsonRpcId;
+    method: string;
+    params?: any;
+    /** JSON RPC Subscription Extension Parameters */
+    subscription?: {
+        id: JsonRpcId;
+    };
+}
+export interface JsonRpcError {
+    code: JsonRpcErrorCodes;
+    message: string;
+    data?: any;
+}
+export interface JsonRpcSubscription {
+    /** JSON RPC Id of the Subscription Request */
+    id: JsonRpcId;
+    close: () => Promise<void>;
+}
+export declare enum JsonRpcErrorCodes {
+    InvalidRequest = -32600,
+    MethodNotFound = -32601,
+    InvalidParams = -32602,
+    InternalError = -32603,
+    ParseError = -32700,
+    TransportError = -32300,
+    BadRequest = -50400,// equivalent to HTTP Status 400
+    Unauthorized = -50401,// equivalent to HTTP Status 401
+    Forbidden = -50403,// equivalent to HTTP Status 403
+    Conflict = -50409
+}
+export type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+export interface JsonRpcSuccessResponse {
+    jsonrpc: JsonRpcVersion;
+    id: JsonRpcId;
+    result: any;
+    error?: never;
+}
+export interface JsonRpcErrorResponse {
+    jsonrpc: JsonRpcVersion;
+    id: JsonRpcId;
+    result?: never;
+    error: JsonRpcError;
+}
+export declare const createJsonRpcErrorResponse: (id: JsonRpcId, code: JsonRpcErrorCodes, message: string, data?: any) => JsonRpcErrorResponse;
+export declare const createJsonRpcNotification: (method: string, params?: any) => JsonRpcRequest;
+export declare const createJsonRpcRequest: (id: JsonRpcId, method: string, params?: JsonRpcParams) => JsonRpcRequest;
+/**
+ * Creates a JSON-RPC subscription request.
+ *
+ * The caller is responsible for providing the full method name including
+ * any `rpc.subscribe.` prefix.
+ */
+export declare const createJsonRpcSubscriptionRequest: (id: JsonRpcId, method: string, params?: any, subscriptionId?: JsonRpcId) => JsonRpcRequest;
+export declare const createJsonRpcSuccessResponse: (id: JsonRpcId, result?: any) => JsonRpcSuccessResponse;
+/**
+ * Safely parses a JSON string, returning `null` on failure instead of throwing.
+ */
+export declare function parseJson(text: string): object | null;
+//# sourceMappingURL=json-rpc.d.ts.map

package/dist/types/json-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../../src/json-rpc.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAC/C,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAChC,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC;AAEnC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,CAAC;IACxB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,iDAAiD;IACjD,YAAY,CAAC,EAAE;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,oBAAY,iBAAiB;IAE3B,cAAc,SAAS;IACvB,cAAc,SAAS;IACvB,aAAa,SAAS;IACtB,aAAa,SAAS;IACtB,UAAU,SAAS;IACnB,cAAc,SAAS;IAGvB,UAAU,SAAS,CAAE,gCAAgC;IACrD,YAAY,SAAS,CAAE,gCAAgC;IACvD,SAAS,SAAS,CAAE,gCAAgC;IACpD,QAAQ,SAAS;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAE5E,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,cAAc,CAAC;IACxB,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,eAAO,MAAM,0BAA0B,OACjC,SAAS,QACP,iBAAiB,WACd,MAAM,SACR,GAAG,KACT,oBAUF,CAAC;AAEF,eAAO,MAAM,yBAAyB,WAC5B,MAAM,WACL,GAAG,KACX,cAMF,CAAC;AAEF,eAAO,MAAM,oBAAoB,OAC3B,SAAS,UACL,MAAM,WACL,aAAa,KACrB,cAOF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,OACvC,SAAS,UACL,MAAM,WACL,GAAG,mBACK,SAAS,KACzB,cAUF,CAAC;AAEF,eAAO,MAAM,4BAA4B,OACnC,SAAS,WACJ,GAAG,KACX,sBAMF,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrD"}