@emeryld/rrroutes-server 2.6.2 → 2.6.3

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

@@ -915,28 +915,36 @@ function batchLeaf(server, path, registry, options) {
         const body = req.body;
         if (!isPlainObject2(body)) {
           throw new Error(
-            "Batch request body must be a plain object keyed by encoded route identifiers."
+            "Batch request body must be a plain object keyed by branch aliases."
           );
         }
-        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);
+        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);
       }