@emeryld/rrroutes-server 2.6.2 → 2.6.4

package/README.md

@@ -169,7 +169,7 @@ const server = createRRRoute(app, {
 
 ### Batch endpoint helper (`batchLeaf`)
 
-Use `batchLeaf` to register one endpoint that dispatches multiple already-registered controllers by encoded route keys.
+Use `batchLeaf` to register one endpoint that dispatches multiple already-registered controllers by alias, while each entry carries its encoded route key.
 
 ```ts
 import { batchLeaf } from '@emeryld/rrroutes-server'
@@ -185,29 +185,31 @@ Client request body shape:
 
 ```ts
 {
-  [encodeURIComponent('GET /v1/users/:userId')]: {
+  getUser: {
+    encodedLeaf: encodeURIComponent('GET /v1/users/:userId'),
     params: { userId: 'u_1' },
   },
-  [encodeURIComponent('PATCH /v1/users/:userId')]: {
+  updateUser: {
+    encodedLeaf: encodeURIComponent('PATCH /v1/users/:userId'),
     params: { userId: 'u_1' },
     body: { name: 'Emery' },
   },
 }
 ```
 
-Response shape (same encoded keys):
+Response shape (same alias keys):
 
 ```ts
 {
-  [encodeURIComponent('GET /v1/users/:userId')]: { out: { ... }, meta: ... },
-  [encodeURIComponent('PATCH /v1/users/:userId')]: { out: { ... }, meta: ... },
+  getUser: { out: { ... }, meta: ... },
+  updateUser: { out: { ... }, meta: ... },
 }
 ```
 
 Notes:
 
 - Register controllers before calling `batchLeaf(...)`; unknown keys fail at runtime.
-- Dispatch uses `server.invoke(...)` for each entry, so each sub-call runs per-leaf parsing, `buildCtx`, `route.before`, handler execution, and output validation.
+- Dispatch uses `server.invoke(...)` in parallel for each entry, so each sub-call runs per-leaf parsing, `buildCtx`, `route.before`, handler execution, and output validation.
 - Batch dispatch does not replay the full global middleware chain of the original route registration (`sanitizer`, `preCtx`, `postCtx`, Multer).
 
 ### Middleware order and ctx usage

package/dist/index.cjs

@@ -235,6 +235,62 @@ var createRequestSanitizationMiddleware = (options = {}) => {
 };
 var requestSanitizationMiddleware = createRequestSanitizationMiddleware();
 
+// src/routesV3.server.batch.ts
+var isPlainObject2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function batchLeaf(server, path, registry, options) {
+  const method = String(options?.method ?? "post").toLowerCase();
+  const allowedMethods = ["get", "post", "put", "patch", "delete"];
+  if (!allowedMethods.includes(method)) {
+    throw new Error(
+      `Invalid batch method "${String(options?.method)}". Expected one of: ${allowedMethods.join(", ")}.`
+    );
+  }
+  ;
+  server.router[method](
+    path,
+    async (req, res, next) => {
+      try {
+        const body = req.body;
+        if (!isPlainObject2(body)) {
+          throw new Error(
+            "Batch request body must be a plain object keyed by branch aliases."
+          );
+        }
+        const entries = Object.entries(body);
+        const outputEntries = await Promise.all(
+          entries.map(async ([alias, value]) => {
+            const payload = isPlainObject2(value) ? value : {};
+            if (typeof payload.encodedLeaf !== "string" || payload.encodedLeaf.length === 0) {
+              throw new Error(
+                `Batch entry "${alias}" must include a non-empty "encodedLeaf" string.`
+              );
+            }
+            const decodedKey = decodeURIComponent(payload.encodedLeaf);
+            const leaf = registry.byKey[decodedKey];
+            if (!leaf) {
+              throw new Error(`Unknown batch route key: ${decodedKey}`);
+            }
+            const result = await server.invoke(decodedKey, {
+              req,
+              res,
+              next,
+              params: payload.params,
+              query: payload.query,
+              body: payload.body,
+              bodyFiles: payload.bodyFiles
+            });
+            return [alias, result];
+          })
+        );
+        res.json(Object.fromEntries(outputEntries));
+      } catch (err) {
+        next(err);
+      }
+    }
+  );
+  return server.router;
+}
+
 // src/routesV3.server.ts
 var serverDebugEventTypes = [
   "register",
@@ -269,12 +325,12 @@ function createServerDebugEmitter(option) {
   }
   return disabled;
 }
-var isPlainObject2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isPlainObject3 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var decodeJsonLikeQueryValue = (value) => {
   if (Array.isArray(value)) {
     return value.map((entry) => decodeJsonLikeQueryValue(entry));
   }
-  if (isPlainObject2(value)) {
+  if (isPlainObject3(value)) {
     const next = {};
     for (const [key, child] of Object.entries(value)) {
       next[key] = decodeJsonLikeQueryValue(child);
@@ -298,7 +354,7 @@ var REQUEST_PAYLOAD_SYMBOL = /* @__PURE__ */ Symbol.for(
   "typedLeaves.requestPayload"
 );
 function isMulterFile(value) {
-  if (!isPlainObject2(value)) return false;
+  if (!isPlainObject3(value)) return false;
   const candidate = value;
   return typeof candidate.fieldname === "string";
 }
@@ -314,7 +370,7 @@ function collectMulterFiles(req) {
       files.push(value);
       return;
     }
-    if (isPlainObject2(value)) {
+    if (isPlainObject3(value)) {
       Object.values(value).forEach(pushValue);
     }
   };
@@ -899,51 +955,6 @@ function bindAll(router, registry, controllers, config) {
   server.registerControllers(registry, controllers);
   return router;
 }
-function batchLeaf(server, path, registry, options) {
-  const method = String(options?.method ?? "post").toLowerCase();
-  const allowedMethods = ["get", "post", "put", "patch", "delete"];
-  if (!allowedMethods.includes(method)) {
-    throw new Error(
-      `Invalid batch method "${String(options?.method)}". Expected one of: ${allowedMethods.join(", ")}.`
-    );
-  }
-  ;
-  server.router[method](
-    path,
-    async (req, res, next) => {
-      try {
-        const body = req.body;
-        if (!isPlainObject2(body)) {
-          throw new Error(
-            "Batch request body must be a plain object keyed by encoded route identifiers."
-          );
-        }
-        const output = {};
-        for (const [encodedKey, value] of Object.entries(body)) {
-          const decodedKey = decodeURIComponent(encodedKey);
-          const leaf = registry.byKey[decodedKey];
-          if (!leaf) {
-            throw new Error(`Unknown batch route key: ${decodedKey}`);
-          }
-          const payload = isPlainObject2(value) ? value : {};
-          output[encodedKey] = await server.invoke(decodedKey, {
-            req,
-            res,
-            next,
-            params: payload.params,
-            query: payload.query,
-            body: payload.body,
-            bodyFiles: payload.bodyFiles
-          });
-        }
-        res.json(output);
-      } catch (err) {
-        next(err);
-      }
-    }
-  );
-  return server.router;
-}
 var defineControllers = () => (m) => m;
 function warnMissingControllers(router, registry, logger) {
   const registeredStore = router[REGISTERED_ROUTES_SYMBOL];