@kubun/protocol 0.13.0 → 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/lib/services/graph.d.ts

@@ -3571,14 +3571,6 @@ export declare const mutateGraphParams: {
                 readonly type: "null";
             }];
         };
-        readonly attachments: {
-            readonly type: "object";
-            readonly additionalProperties: {
-                readonly title: "KubunBinaryValue";
-                readonly type: "string";
-                readonly pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$";
-            };
-        };
         readonly transactionID: {
             readonly type: "string";
         };
@@ -7097,14 +7089,6 @@ export declare const graphProtocol: {
                         readonly type: "null";
                     }];
                 };
-                readonly attachments: {
-                    readonly type: "object";
-                    readonly additionalProperties: {
-                        readonly title: "KubunBinaryValue";
-                        readonly type: "string";
-                        readonly pattern: "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$";
-                    };
-                };
                 readonly transactionID: {
                     readonly type: "string";
                 };

package/lib/services/graph.js

@@ -1,6 +1,6 @@
 import { clusterModel } from '../models/cluster.js';
 import { documentModelsRecord } from '../models/document.js';
-import { binaryStringValue, signedJWTStringValue } from '../models/value.js';
+import { signedJWTStringValue } from '../models/value.js';
 export const searchModelConfig = {
     type: 'object',
     properties: {
@@ -226,10 +226,6 @@ export const mutateGraphParams = {
                 }
             ]
         },
-        attachments: {
-            type: 'object',
-            additionalProperties: binaryStringValue
-        },
         transactionID: {
             type: 'string'
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/protocol",
-  "version": "0.13.0",
+  "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.12.0",
-    "@kubun/logger": "^0.12.0"
+    "change-case": "^5.4.4"
   },
   "devDependencies": {
     "graphql": "^16.14.2",