@kubun/hub 0.17.1 → 0.17.3

package/lib/create-relay.d.ts

@@ -38,6 +38,20 @@ export type CreateRelayOptions = {
      * disable the limit for high-op-rate use.
      */
     rateLimits?: Partial<HubRateLimits>;
+    /**
+     * Max size (bytes) of a single relayed RPC request body, forwarded to
+     * `@enkaku/http-serve` `ServerTransport`. A body past this is rejected with
+     * HTTP 413 before it reaches the hub handlers. Omitted, `@kubun/hub`'s 8 MiB
+     * default applies (raised from the transport's own 1 MiB), so a full-scope
+     * merkle reconciliation of a modest graph is carried without opting in.
+     */
+    maxRequestBodySize?: number;
+    /**
+     * Max buffered bytes per server→client session, forwarded to
+     * `@enkaku/http-serve` `ServerTransport`. Omitted, `@kubun/hub`'s 8 MiB
+     * default applies (raised from the transport's own 1 MiB).
+     */
+    maxSessionBufferBytes?: number;
     retention?: RelayRetentionConfig;
     defaultRetention?: number;
     maxRetention?: number;
@@ -64,6 +78,8 @@ export type RelayInternalOptions = {
     authorize?: AuthorizeHook;
     allowedOrigin?: string | Array<string>;
     rateLimits?: Partial<HubRateLimits>;
+    maxRequestBodySize?: number;
+    maxSessionBufferBytes?: number;
     retention?: RelayRetentionConfig;
     defaultRetention?: number;
     maxRetention?: number;

package/lib/create-relay.js

@@ -11,6 +11,12 @@ const DEFAULT_RETENTION_INTERVAL_SECONDS = 3600;
 const DEFAULT_SUBSCRIPTION_RETENTION_SECONDS = 90 * 24 * 60 * 60;
 const DEFAULT_MAX_RETENTION_SECONDS = 30 * 24 * 60 * 60;
 const DEFAULT_MAX_DEPTH = 1000;
+// Raised from `@enkaku/http-serve`'s own 1 MiB: a relay exists to carry sync
+// frames, and a full-scope merkle reconciliation of a modest graph (~1.5 MiB
+// observed) already exceeds 1 MiB. 8 MiB clears realistic reconciliations with
+// headroom while still bounding a single request.
+const DEFAULT_MAX_REQUEST_BODY_SIZE = 8 * 1024 * 1024;
+const DEFAULT_MAX_SESSION_BUFFER_BYTES = 8 * 1024 * 1024;
 function resolveAccessRules(auth) {
     if (auth == null) return {};
     switch(auth.mode){
@@ -86,7 +92,9 @@ export async function createRelayInternal(options) {
     }
     const allowedOrigin = resolveAllowedOrigin(options.allowedOrigin);
     const transport = new ServerTransport({
-        allowedOrigin
+        allowedOrigin,
+        maxRequestBodySize: options.maxRequestBodySize ?? DEFAULT_MAX_REQUEST_BODY_SIZE,
+        maxSessionBufferBytes: options.maxSessionBufferBytes ?? DEFAULT_MAX_SESSION_BUFFER_BYTES
     });
     const accessRules = resolveAccessRules(options.auth);
     // `@kumiai/hub-server` assembles the handlers, registry, and Enkaku server for
@@ -229,6 +237,8 @@ export async function createRelay(options) {
         authorize: options.authorize,
         allowedOrigin: options.allowedOrigin,
         rateLimits: options.rateLimits,
+        maxRequestBodySize: options.maxRequestBodySize,
+        maxSessionBufferBytes: options.maxSessionBufferBytes,
         retention: options.retention,
         defaultRetention: options.defaultRetention,
         maxRetention: options.maxRetention,

package/lib/index.d.ts

@@ -36,6 +36,18 @@ export type HubOptions = {
      * Omitted, its defaults apply. See `CreateRelayOptions.rateLimits`.
      */
     rateLimits?: Partial<HubRateLimits>;
+    /**
+     * Max size (bytes) of a single relayed RPC request body, forwarded to
+     * `@enkaku/http-serve`. Omitted, `@kubun/hub`'s 8 MiB default applies (raised
+     * from the transport's own 1 MiB). See `CreateRelayOptions.maxRequestBodySize`.
+     */
+    maxRequestBodySize?: number;
+    /**
+     * Max buffered bytes per server→client session, forwarded to
+     * `@enkaku/http-serve`. Omitted, `@kubun/hub`'s 8 MiB default applies. See
+     * `CreateRelayOptions.maxSessionBufferBytes`.
+     */
+    maxSessionBufferBytes?: number;
     /** Optional retention scheduler. */
     retention?: RelayRetentionConfig;
     /** Optional observers for counters / diagnostics. */

package/lib/index.js

@@ -15,6 +15,8 @@ export async function createHub(options) {
         auth: options.auth,
         allowedOrigin: options.allowedOrigin,
         rateLimits: options.rateLimits,
+        maxRequestBodySize: options.maxRequestBodySize,
+        maxSessionBufferBytes: options.maxSessionBufferBytes,
         retention: options.retention,
         observers: options.observers,
         ownsKysely: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubun/hub",
-  "version": "0.17.1",
+  "version": "0.17.3",
   "license": "see LICENSE.md",
   "sideEffects": false,
   "type": "module",