@kubun/protocol 0.13.1 → 0.14.0

package/lib/handler-error.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Canonical, security-sensitive translator: turns a thrown value into a
+ * `HandlerError` ONLY when it carries a registered {@link KubunErrorCode}, so
+ * `HandlerError.from` in `@enkaku/server` forwards its `code`/`data`/`msg` to the
+ * remote caller instead of flattening it to `EK01` / "Handler execution failed".
+ *
+ * Anything else is returned UNCHANGED, and that default is the security property:
+ * an error with no registered code is internal and its message may carry DIDs,
+ * paths, or SQL, so it stays opaque on the wire. This is the one place that
+ * decides which codes may leave the device — GraphQL-shaped errors are handled by
+ * a caller-local branch (see plugin-p2p) that delegates the rest here.
+ */
+export declare function toHandlerError(cause: unknown): unknown;
+/**
+ * Applies {@link toHandlerError} to every handler in a procedure record, so the
+ * translation lives in one place rather than in each handler.
+ */
+export declare function wrapHandlers(handlers: Record<string, unknown>): Record<string, unknown>;

package/lib/handler-error.js

@@ -0,0 +1,56 @@
+import { HandlerError } from '@enkaku/server';
+import { isKubunErrorCode } from './errors.js';
+function isObject(value) {
+    return typeof value === 'object' && value != null && !Array.isArray(value);
+}
+/**
+ * Canonical, security-sensitive translator: turns a thrown value into a
+ * `HandlerError` ONLY when it carries a registered {@link KubunErrorCode}, so
+ * `HandlerError.from` in `@enkaku/server` forwards its `code`/`data`/`msg` to the
+ * remote caller instead of flattening it to `EK01` / "Handler execution failed".
+ *
+ * Anything else is returned UNCHANGED, and that default is the security property:
+ * an error with no registered code is internal and its message may carry DIDs,
+ * paths, or SQL, so it stays opaque on the wire. This is the one place that
+ * decides which codes may leave the device — GraphQL-shaped errors are handled by
+ * a caller-local branch (see plugin-p2p) that delegates the rest here.
+ */ export function toHandlerError(cause) {
+    if (cause instanceof HandlerError) {
+        return cause;
+    }
+    if (isObject(cause) && isKubunErrorCode(cause.code)) {
+        const message = typeof cause.message === 'string' ? cause.message : undefined;
+        const data = isObject(cause.data) ? cause.data : {};
+        return new HandlerError({
+            code: cause.code,
+            message,
+            data,
+            cause
+        });
+    }
+    return cause;
+}
+/**
+ * Applies {@link toHandlerError} to every handler in a procedure record, so the
+ * translation lives in one place rather than in each handler.
+ */ export function wrapHandlers(handlers) {
+    return Object.fromEntries(Object.entries(handlers).map(([name, handler])=>{
+        if (typeof handler !== 'function') {
+            return [
+                name,
+                handler
+            ];
+        }
+        const wrapped = async (...args)=>{
+            try {
+                return await handler(...args);
+            } catch (cause) {
+                throw toHandlerError(cause);
+            }
+        };
+        return [
+            name,
+            wrapped
+        ];
+    }));
+}

package/lib/index.d.ts

@@ -2,6 +2,7 @@ import type { AnyClientMessageOf, AnyServerMessageOf, ClientTransportOf, ServerT
 import type { GraphProtocol } from './services/graph.js';
 export { isKubunErrorCode, type KubunErrorCode, KubunErrorCodes } from './errors.js';
 export type { GraphQLOperationParams, GraphQLSource, GraphQLSourceParams, GraphQLSourceProvider, GraphsProvider, } from './executor.js';
+export { toHandlerError, wrapHandlers } from './handler-error.js';
 export * from './models/catalog.js';
 export * from './models/cluster.js';
 export * from './models/document.js';

package/lib/index.js

@@ -1,4 +1,5 @@
 export { isKubunErrorCode, KubunErrorCodes } from './errors.js';
+export { toHandlerError, wrapHandlers } from './handler-error.js';
 export * from './models/catalog.js';
 export * from './models/cluster.js';
 export * from './models/document.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/protocol",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "keywords": [],
   "license": "see LICENSE.md",
   "sideEffects": false,
@@ -16,11 +16,12 @@
   ],
   "dependencies": {
     "@enkaku/protocol": "^0.21.0",
+    "@enkaku/server": "^0.21.2",
+    "@kubun/id": "^0.14.0",
+    "@kubun/logger": "^0.14.0",
     "@sozai/codec": "^0.4.0",
     "@sozai/schema": "^0.1.1",
-    "change-case": "^5.4.4",
-    "@kubun/id": "^0.13.0",
-    "@kubun/logger": "^0.13.0"
+    "change-case": "^5.4.4"
   },
   "devDependencies": {
     "graphql": "^16.14.2",