@emeryld/rrroutes-server 2.6.8 → 2.7.0

package/dist/routesV3.server.d.ts

@@ -182,10 +182,36 @@ export type ControllerMap<R extends {
 }, Ctx = unknown, Names extends string = string> = {
     [P in KeysOfRegistry<R>]: RouteDef<LeafFromKey<R, P>, Ctx, Names>;
 };
-export type PartialControllerMap<R extends {
+type RegistryLike = {
     all: readonly AnyLeafLowProfile[];
     byKey: Record<string, AnyLeafLowProfile>;
-}, Ctx = unknown, Names extends string = string> = Partial<ControllerMap<R, Ctx, Names>>;
+};
+export type PartialControllerMap<R extends RegistryLike, Ctx = unknown, Names extends string = string> = Partial<ControllerMap<R, Ctx, Names>>;
+type GlobalBeforeArgsByKey<R extends RegistryLike, Ctx = unknown> = {
+    [K in KeysOfRegistry<R>]: {
+        key: K;
+        method: Uppercase<LeafFromKey<R, K>['method']>;
+        path: LeafFromKey<R, K>['path'];
+        req: express.Request;
+        res: express.Response;
+        next: express.NextFunction;
+        ctx: CtxWithRoutesLogger<Ctx>;
+    } & RouteRequestPayload<LeafFromKey<R, K>>;
+};
+export type RegisterControllersBeforeArgs<R extends RegistryLike, Ctx = unknown> = GlobalBeforeArgsByKey<R, Ctx>[KeysOfRegistry<R>];
+export type RegisterControllersBeforeHandler<R extends RegistryLike, Ctx = unknown> = (args: RegisterControllersBeforeArgs<R, Ctx>) => any;
+export type RegisterControllersOptions<R extends RegistryLike, Ctx = unknown> = {
+    /**
+     * Ctx-aware middlewares that run for every controller registered in this call.
+     * Order: global `before` (this option) -> route `before` -> handler.
+     */
+    before?: Array<RegisterControllersBeforeHandler<R, Ctx>>;
+    /**
+     * Deprecated runtime toggle kept for backward compatibility.
+     * Passing truthy still enforces the previous runtime missing-key error behavior.
+     */
+    all?: boolean;
+};
 /** Options + derivation helpers */
 export type BuildCtxArgs = {
     req: express.Request;
@@ -258,7 +284,7 @@ export type RouteServer<Ctx = unknown, Names extends string = string> = {
     registerControllers<R extends {
         all: readonly AnyLeafLowProfile[];
         byKey: Record<string, AnyLeafLowProfile>;
-    }, F extends boolean = false>(registry: R, controllers: F extends false ? PartialControllerMap<R, Ctx, Names> : ControllerMap<R, Ctx, Names>, all?: F): void;
+    }, F extends boolean = false>(registry: R, controllers: F extends false ? PartialControllerMap<R, Ctx, Names> : ControllerMap<R, Ctx, Names>, allOrOptions?: F | RegisterControllersOptions<R, Ctx>): void;
     warnMissingControllers<R extends {
         all: readonly AnyLeafLowProfile[];
         byKey: Record<string, AnyLeafLowProfile>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-server",
-  "version": "2.6.8",
+  "version": "2.7.0",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -17,8 +17,8 @@
     "dist"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-contract": "^2.6.5",
-    "jose": "^6.2.1",
+    "@emeryld/rrroutes-contract": "^2.7.0",
+    "jose": "^6.2.2",
     "multer": "1.4.5-lts.2",
     "socket.io": "^4.8.3",
     "zod": "^4.3.6"