@enbox/dwn-server 0.0.16 → 0.1.0

package/dist/esm/src/json-rpc-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-rpc-api.d.ts","sourceRoot":"","sources":["../../../src/json-rpc-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAKzD,eAAO,MAAM,aAAa,eAAsB,CAAC"}
+{"version":3,"file":"json-rpc-api.d.ts","sourceRoot":"","sources":["../../../src/json-rpc-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAMzD,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/esm/src/json-rpc-api.js

@@ -1,9 +1,11 @@
 import { JsonRpcRouter } from './lib/json-rpc-router.js';
 import { handleDwnProcessMessage } from './json-rpc-handlers/dwn/index.js';
+import { handlePing } from './json-rpc-handlers/ping.js';
 import { handleSubscriptionAck, handleSubscriptionsClose } from './json-rpc-handlers/subscription/index.js';
 export const jsonRpcRouter = new JsonRpcRouter();
 jsonRpcRouter.on('dwn.processMessage', handleDwnProcessMessage);
 jsonRpcRouter.on('rpc.subscribe.dwn.processMessage', handleDwnProcessMessage);
 jsonRpcRouter.on('rpc.ack', handleSubscriptionAck);
 jsonRpcRouter.on('rpc.subscribe.close', handleSubscriptionsClose);
+jsonRpcRouter.on('rpc.ping', handlePing);
 //# sourceMappingURL=json-rpc-api.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"json-rpc-api.js","sourceRoot":"","sources":["../../../src/json-rpc-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAE5G,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AAEjD,aAAa,CAAC,EAAE,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,CAAC;AAChE,aAAa,CAAC,EAAE,CAAC,kCAAkC,EAAE,uBAAuB,CAAC,CAAC;AAE9E,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;AACnD,aAAa,CAAC,EAAE,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"json-rpc-api.js","sourceRoot":"","sources":["../../../src/json-rpc-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAE5G,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AAEjD,aAAa,CAAC,EAAE,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,CAAC;AAChE,aAAa,CAAC,EAAE,CAAC,kCAAkC,EAAE,uBAAuB,CAAC,CAAC;AAE9E,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;AACnD,aAAa,CAAC,EAAE,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC;AAElE,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC"}

package/dist/esm/src/json-rpc-handlers/ping.d.ts

@@ -0,0 +1,10 @@
+import type { JsonRpcHandler } from '../lib/json-rpc-router.js';
+/**
+ * Handles `rpc.ping` requests — a lightweight application-level heartbeat.
+ *
+ * Clients send `rpc.ping` periodically to detect silently dead WebSocket
+ * connections (NAT timeout, network switch, device sleep). The server
+ * responds with a simple success so the client knows the connection is alive.
+ */
+export declare const handlePing: JsonRpcHandler;
+//# sourceMappingURL=ping.d.ts.map

package/dist/esm/src/json-rpc-handlers/ping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../../../src/json-rpc-handlers/ping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2BAA2B,CAAC;AAInC;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,cAIxB,CAAC"}

package/dist/esm/src/json-rpc-handlers/ping.js

@@ -0,0 +1,14 @@
+import { createJsonRpcSuccessResponse } from '@enbox/dwn-clients';
+/**
+ * Handles `rpc.ping` requests — a lightweight application-level heartbeat.
+ *
+ * Clients send `rpc.ping` periodically to detect silently dead WebSocket
+ * connections (NAT timeout, network switch, device sleep). The server
+ * responds with a simple success so the client knows the connection is alive.
+ */
+export const handlePing = async (request) => {
+    return {
+        jsonRpcResponse: createJsonRpcSuccessResponse(request.id, { ok: true }),
+    };
+};
+//# sourceMappingURL=ping.js.map

package/dist/esm/src/json-rpc-handlers/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../../../src/json-rpc-handlers/ping.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmB,KAAK,EAAE,OAAO,EAA4B,EAAE;IACpF,OAAO;QACL,eAAe,EAAE,4BAA4B,CAAC,OAAO,CAAC,EAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/src/lib/json-rpc-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-rpc-router.d.ts","sourceRoot":"","sources":["../../../../src/lib/json-rpc-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE;QACpB,gDAAgD;QAChD,EAAE,EAAE,SAAS,CAAC;QACd,2GAA2G;QAC3G,mBAAmB,EAAE,oBAAoB,CAAC;KAC3C,CAAA;IACD,iGAAiG;IACjG,UAAU,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACxC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,+EAA+E;IAC/E,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAC3B,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B,qBAAa,aAAa;IACxB,OAAO,CAAC,cAAc,CAAuC;;IAM7D,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAI/C,MAAM,CACV,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;CAK5B"}
+{"version":3,"file":"json-rpc-router.d.ts","sourceRoot":"","sources":["../../../../src/lib/json-rpc-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE;QACpB,gDAAgD;QAChD,EAAE,EAAE,SAAS,CAAC;QACd,2GAA2G;QAC3G,mBAAmB,EAAE,oBAAoB,CAAC;KAC3C,CAAA;IACD,iGAAiG;IACjG,UAAU,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACxC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAChC,+EAA+E;IAC/E,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAC3B,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B,qBAAa,aAAa;IACxB,OAAO,CAAC,cAAc,CAAuC;;IAM7D,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAI/C,MAAM,CACV,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;CAc5B"}

package/dist/esm/src/lib/json-rpc-router.js

@@ -1,3 +1,4 @@
+import { createJsonRpcErrorResponse, JsonRpcErrorCodes } from '@enbox/dwn-clients';
 export class JsonRpcRouter {
     methodHandlers;
     constructor() {
@@ -8,6 +9,11 @@ export class JsonRpcRouter {
     }
     async handle(rpcRequest, context) {
         const handler = this.methodHandlers[rpcRequest.method];
+        if (!handler) {
+            return {
+                jsonRpcResponse: createJsonRpcErrorResponse(rpcRequest.id, JsonRpcErrorCodes.MethodNotFound, `Method not found: ${rpcRequest.method}`),
+            };
+        }
         return await handler(rpcRequest, context);
     }
 }

package/dist/esm/src/lib/json-rpc-router.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-rpc-router.js","sourceRoot":"","sources":["../../../../src/lib/json-rpc-router.ts"],"names":[],"mappings":"AA+CA,MAAM,OAAO,aAAa;IAChB,cAAc,CAAuC;IAE7D;QACE,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,EAAE,CAAC,UAAkB,EAAE,OAAuB;QAC5C,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM,CACV,UAA0B,EAC1B,OAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAEvD,OAAO,MAAM,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF"}
+{"version":3,"file":"json-rpc-router.js","sourceRoot":"","sources":["../../../../src/lib/json-rpc-router.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAuCnF,MAAM,OAAO,aAAa;IAChB,cAAc,CAAuC;IAE7D;QACE,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,EAAE,CAAC,UAAkB,EAAE,OAAuB;QAC5C,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM,CACV,UAA0B,EAC1B,OAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,eAAe,EAAE,0BAA0B,CACzC,UAAU,CAAC,EAAG,EACd,iBAAiB,CAAC,cAAc,EAChC,qBAAqB,UAAU,CAAC,MAAM,EAAE,CACzC;aACF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@enbox/dwn-server",
   "type": "module",
-  "version": "0.0.16",
+  "version": "0.1.0",
   "license": "Apache-2.0",
   "files": [
     "dist",
@@ -33,7 +33,7 @@
     "@enbox/common": "0.1.0",
     "@enbox/crypto": "0.1.0",
     "@enbox/dids": "0.1.0",
-    "@enbox/dwn-clients": "0.2.6",
+    "@enbox/dwn-clients": "0.3.0",
     "@enbox/dwn-sdk-js": "0.3.2",
     "@enbox/dwn-sql-store": "0.0.17",
     "@nats-io/jetstream": "3.3.1",

package/src/json-rpc-api.ts

@@ -1,6 +1,7 @@
 import { JsonRpcRouter } from './lib/json-rpc-router.js';
 
 import { handleDwnProcessMessage } from './json-rpc-handlers/dwn/index.js';
+import { handlePing } from './json-rpc-handlers/ping.js';
 import { handleSubscriptionAck, handleSubscriptionsClose } from './json-rpc-handlers/subscription/index.js';
 
 export const jsonRpcRouter = new JsonRpcRouter();
@@ -10,3 +11,5 @@ jsonRpcRouter.on('rpc.subscribe.dwn.processMessage', handleDwnProcessMessage);
 
 jsonRpcRouter.on('rpc.ack', handleSubscriptionAck);
 jsonRpcRouter.on('rpc.subscribe.close', handleSubscriptionsClose);
+
+jsonRpcRouter.on('rpc.ping', handlePing);

package/src/json-rpc-handlers/ping.ts

@@ -0,0 +1,19 @@
+import type {
+  HandlerResponse,
+  JsonRpcHandler,
+} from '../lib/json-rpc-router.js';
+
+import { createJsonRpcSuccessResponse } from '@enbox/dwn-clients';
+
+/**
+ * Handles `rpc.ping` requests — a lightweight application-level heartbeat.
+ *
+ * Clients send `rpc.ping` periodically to detect silently dead WebSocket
+ * connections (NAT timeout, network switch, device sleep). The server
+ * responds with a simple success so the client knows the connection is alive.
+ */
+export const handlePing: JsonRpcHandler = async (request): Promise<HandlerResponse> => {
+  return {
+    jsonRpcResponse: createJsonRpcSuccessResponse(request.id!, { ok: true }),
+  };
+};

package/src/lib/json-rpc-router.ts

@@ -8,6 +8,8 @@ import type { SocketConnection } from '../connection/socket-connection.js';
 import type { Dwn, SubscriptionListener } from '@enbox/dwn-sdk-js';
 import type { JsonRpcId, JsonRpcRequest, JsonRpcResponse } from '@enbox/dwn-clients';
 
+import { createJsonRpcErrorResponse, JsonRpcErrorCodes } from '@enbox/dwn-clients';
+
 export type RequestContext = {
   transport: 'http' | 'ws';
   dwn: Dwn;
@@ -61,6 +63,15 @@ export class JsonRpcRouter {
     context: RequestContext,
   ): Promise<HandlerResponse> {
     const handler = this.methodHandlers[rpcRequest.method];
+    if (!handler) {
+      return {
+        jsonRpcResponse: createJsonRpcErrorResponse(
+          rpcRequest.id!,
+          JsonRpcErrorCodes.MethodNotFound,
+          `Method not found: ${rpcRequest.method}`,
+        ),
+      };
+    }
 
     return await handler(rpcRequest, context);
   }