@nanodi/koa 0.5.1 → 0.6.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/dist/cjs/Controller.d.ts

@@ -1,4 +1,5 @@
 import type * as Koa from "koa";
+/** A request handler class resolved from ctx.scope for each request. Errors propagate to upstream middleware. */
 export interface Controller {
     handle(ctx: Koa.Context, next: Koa.Next): Promise<any>;
 }

package/dist/cjs/Controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../../src/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACxD"}
+{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../../src/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC,iHAAiH;AACjH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACxD"}

package/dist/cjs/decorators.d.ts

@@ -3,12 +3,16 @@ import type * as Koa from "koa";
 import type Router from "@koa/router";
 import { Controller } from "./Controller.js";
 type Method = "get" | "post" | "put" | "patch" | "delete";
+/** `@controller(method, path)` routes requests to the class' handle(). Use with autobindControllers() or autobindInjectableControllers(). */
 export declare function controllerDecorator<T extends RegistrationConstructor<Controller>>(method: Method, path: string): (value: T, context: ClassDecoratorContext) => void;
+/** `@controller.middleware(...middlewares)` runs the middlewares before the controller on its route. */
 export declare function middlewareDecorator<T extends RegistrationConstructor<Controller>>(...middlewares: Koa.Middleware[]): (value: T, context: ClassDecoratorContext) => void;
 export declare const controller: typeof controllerDecorator & {
     middleware: typeof middlewareDecorator;
 };
+/** Adds a route to the router for each class decorated with @controller(). The classes must be registered in the provider. */
 export declare function autobindControllers(router: Router, controllerClasses: RegistrationConstructor<Controller>[]): void;
+/** Adds a route to the router for each class in the collection decorated with @controller(). */
 export declare function autobindInjectableControllers(router: Router, services: ServiceCollection): void;
 export {};
 //# sourceMappingURL=decorators.d.ts.map

package/dist/cjs/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAyB,MAAM,cAAc,CAAC;AACjG,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,KAAK,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAa1D,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,CAAC,UAAU,CAAC,EAC/E,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,IAEK,OAAO,CAAC,EAAE,SAAS,qBAAqB,UAG1D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,IAChG,OAAO,CAAC,EAAE,SAAS,qBAAqB,UAG1D;AAED,eAAO,MAAM,UAAU;;CAErB,CAAC;AAcH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,uBAAuB,CAAC,UAAU,CAAC,EAAE,QAI3G;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,QAIxF"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAyB,MAAM,cAAc,CAAC;AACjG,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,KAAK,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAa1D,6IAA6I;AAC7I,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,CAAC,UAAU,CAAC,EAC/E,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,IAEK,OAAO,CAAC,EAAE,SAAS,qBAAqB,UAG1D;AAED,wGAAwG;AACxG,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,IAChG,OAAO,CAAC,EAAE,SAAS,qBAAqB,UAG1D;AAED,eAAO,MAAM,UAAU;;CAErB,CAAC;AAcH,8HAA8H;AAC9H,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,uBAAuB,CAAC,UAAU,CAAC,EAAE,QAI3G;AAED,gGAAgG;AAChG,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,QAIxF"}

package/dist/cjs/decorators.js

@@ -19,11 +19,13 @@ function setMetadata(value, context, key, metaValue) {
         meta[key] = metaValue;
     }
 }
+/** `@controller(method, path)` routes requests to the class' handle(). Use with autobindControllers() or autobindInjectableControllers(). */
 function controllerDecorator(method, path) {
     return function (value, context) {
         setMetadata(value, context, "nanodi:controller", { method, path });
     };
 }
+/** `@controller.middleware(...middlewares)` runs the middlewares before the controller on its route. */
 function middlewareDecorator(...middlewares) {
     return function (value, context) {
         setMetadata(value, context, "nanodi:controller-middlewares", middlewares);
@@ -34,19 +36,21 @@ exports.controller = Object.assign(controllerDecorator, {
 });
 function bindController(router, controllerClass) {
     const metadata = controllerClass[Symbol.metadata];
-    if (!metadata) {
+    const route = metadata?.["nanodi:controller"];
+    if (!route) {
         throw new Error(`No @controller metadata found for class: ${controllerClass.name}`);
     }
-    const { method, path } = metadata["nanodi:controller"];
     const middlewares = metadata["nanodi:controller-middlewares"] ?? [];
     const controllerKey = (0, core_1.getInjectableClassKey)(controllerClass);
-    (0, middlewares_js_1.requestHandler)(router, method, path, middlewares, controllerKey);
+    (0, middlewares_js_1.requestHandler)(router, route.method, route.path, middlewares, controllerKey);
 }
+/** Adds a route to the router for each class decorated with @controller(). The classes must be registered in the provider. */
 function autobindControllers(router, controllerClasses) {
     for (const controllerClass of controllerClasses) {
         bindController(router, controllerClass);
     }
 }
+/** Adds a route to the router for each class in the collection decorated with @controller(). */
 function autobindInjectableControllers(router, services) {
     for (const registration of services.getByMetadata("nanodi:controller")) {
         bindController(router, registration.useClass);

package/dist/cjs/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":";;;AAmBA,kDAOC;AAED,kDAIC;AAkBD,kDAIC;AAED,sEAIC;AA5DD,uCAAiG;AAIjG,qDAAkD;AAIlD,SAAS,WAAW,CAAwC,KAAQ,EAAE,OAAiC,EAAE,GAAkB,EAAE,SAAc;;IACzI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,sBAAsB;QACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,MAAM,IAAI,GAAG,KAAK,MAAC,MAAM,CAAC,QAAQ,MAArB,KAAK,OAAsB,EAAE,CAAA,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAgB,mBAAmB,CACjC,MAAc,EACd,IAAY;IAEZ,OAAO,UAAU,KAAQ,EAAE,OAA8B;QACvD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,mBAAmB,CAAgD,GAAG,WAA6B;IACjH,OAAO,UAAU,KAAQ,EAAE,OAA8B;QACvD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,+BAA+B,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC,CAAC;AACJ,CAAC;AAEY,QAAA,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE;IAC3D,UAAU,EAAE,mBAAmB;CAChC,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,MAAc,EAAE,eAAoD;IAC1F,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,mBAAmB,CAAqC,CAAC;IAC3F,MAAM,WAAW,GAAG,QAAQ,CAAC,+BAA+B,CAAqB,IAAI,EAAE,CAAC;IACxF,MAAM,aAAa,GAAG,IAAA,4BAAqB,EAAC,eAAe,CAAC,CAAC;IAC7D,IAAA,+BAAc,EAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC;AAED,SAAgB,mBAAmB,CAAC,MAAc,EAAE,iBAAwD;IAC1G,KAAK,MAAM,eAAe,IAAI,iBAAiB,EAAE,CAAC;QAChD,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,SAAgB,6BAA6B,CAAC,MAAc,EAAE,QAA2B;IACvF,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACvE,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":";;;AAoBA,kDAOC;AAGD,kDAIC;AAmBD,kDAIC;AAGD,sEAIC;AAhED,uCAAiG;AAIjG,qDAAkD;AAIlD,SAAS,WAAW,CAAwC,KAAQ,EAAE,OAAiC,EAAE,GAAkB,EAAE,SAAc;;IACzI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,sBAAsB;QACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,MAAM,IAAI,GAAG,KAAK,MAAC,MAAM,CAAC,QAAQ,MAArB,KAAK,OAAsB,EAAE,CAAA,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACxB,CAAC;AACH,CAAC;AAED,6IAA6I;AAC7I,SAAgB,mBAAmB,CACjC,MAAc,EACd,IAAY;IAEZ,OAAO,UAAU,KAAQ,EAAE,OAA8B;QACvD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC;AAED,wGAAwG;AACxG,SAAgB,mBAAmB,CAAgD,GAAG,WAA6B;IACjH,OAAO,UAAU,KAAQ,EAAE,OAA8B;QACvD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,+BAA+B,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC,CAAC;AACJ,CAAC;AAEY,QAAA,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE;IAC3D,UAAU,EAAE,mBAAmB;CAChC,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,MAAc,EAAE,eAAoD;IAC1F,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,mBAAmB,CAAiD,CAAC;IAC9F,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4CAA4C,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,WAAW,GAAG,QAAS,CAAC,+BAA+B,CAAqB,IAAI,EAAE,CAAC;IACzF,MAAM,aAAa,GAAG,IAAA,4BAAqB,EAAC,eAAe,CAAC,CAAC;IAC7D,IAAA,+BAAc,EAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AAC/E,CAAC;AAED,8HAA8H;AAC9H,SAAgB,mBAAmB,CAAC,MAAc,EAAE,iBAAwD;IAC1G,KAAK,MAAM,eAAe,IAAI,iBAAiB,EAAE,CAAC;QAChD,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,SAAgB,6BAA6B,CAAC,MAAc,EAAE,QAA2B;IACvF,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACvE,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/cjs/package.json

@@ -1,3 +1,3 @@
-{
-  "type": "commonjs"
+{
+  "type": "commonjs"
 }

package/dist/cjs/symbols.d.ts

@@ -1,3 +1,4 @@
 import type * as Koa from "koa";
+/** Scoped value key for the current Koa context. Register with registerScopedValue(). */
 export declare const ContextKey: import("@nanodi/core").RegistrationSymbol<Koa.Context>;
 //# sourceMappingURL=symbols.d.ts.map

package/dist/cjs/symbols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC,eAAO,MAAM,UAAU,wDAA6C,CAAC"}
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC,yFAAyF;AACzF,eAAO,MAAM,UAAU,wDAA6C,CAAC"}

package/dist/cjs/symbols.js

@@ -2,5 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContextKey = void 0;
 const core_1 = require("@nanodi/core");
+/** Scoped value key for the current Koa context. Register with registerScopedValue(). */
 exports.ContextKey = (0, core_1.registrationSymbol)("Context");
 //# sourceMappingURL=symbols.js.map

package/dist/cjs/symbols.js.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/symbols.ts"],"names":[],"mappings":";;;AAAA,uCAAkD;AAGrC,QAAA,UAAU,GAAG,IAAA,yBAAkB,EAAc,SAAS,CAAC,CAAC"}
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/symbols.ts"],"names":[],"mappings":";;;AAAA,uCAAkD;AAGlD,yFAAyF;AAC5E,QAAA,UAAU,GAAG,IAAA,yBAAkB,EAAc,SAAS,CAAC,CAAC"}

package/dist/esm/Controller.d.ts

@@ -1,4 +1,5 @@
 import type * as Koa from "koa";
+/** A request handler class resolved from ctx.scope for each request. Errors propagate to upstream middleware. */
 export interface Controller {
     handle(ctx: Koa.Context, next: Koa.Next): Promise<any>;
 }

package/dist/esm/Controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../../src/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACxD"}
+{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../../src/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC,iHAAiH;AACjH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACxD"}

package/dist/esm/decorators.d.ts

@@ -3,12 +3,16 @@ import type * as Koa from "koa";
 import type Router from "@koa/router";
 import { Controller } from "./Controller.js";
 type Method = "get" | "post" | "put" | "patch" | "delete";
+/** `@controller(method, path)` routes requests to the class' handle(). Use with autobindControllers() or autobindInjectableControllers(). */
 export declare function controllerDecorator<T extends RegistrationConstructor<Controller>>(method: Method, path: string): (value: T, context: ClassDecoratorContext) => void;
+/** `@controller.middleware(...middlewares)` runs the middlewares before the controller on its route. */
 export declare function middlewareDecorator<T extends RegistrationConstructor<Controller>>(...middlewares: Koa.Middleware[]): (value: T, context: ClassDecoratorContext) => void;
 export declare const controller: typeof controllerDecorator & {
     middleware: typeof middlewareDecorator;
 };
+/** Adds a route to the router for each class decorated with @controller(). The classes must be registered in the provider. */
 export declare function autobindControllers(router: Router, controllerClasses: RegistrationConstructor<Controller>[]): void;
+/** Adds a route to the router for each class in the collection decorated with @controller(). */
 export declare function autobindInjectableControllers(router: Router, services: ServiceCollection): void;
 export {};
 //# sourceMappingURL=decorators.d.ts.map

package/dist/esm/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAyB,MAAM,cAAc,CAAC;AACjG,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,KAAK,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAa1D,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,CAAC,UAAU,CAAC,EAC/E,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,IAEK,OAAO,CAAC,EAAE,SAAS,qBAAqB,UAG1D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,IAChG,OAAO,CAAC,EAAE,SAAS,qBAAqB,UAG1D;AAED,eAAO,MAAM,UAAU;;CAErB,CAAC;AAcH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,uBAAuB,CAAC,UAAU,CAAC,EAAE,QAI3G;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,QAIxF"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAyB,MAAM,cAAc,CAAC;AACjG,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAChC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,KAAK,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAa1D,6IAA6I;AAC7I,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,CAAC,UAAU,CAAC,EAC/E,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,IAEK,OAAO,CAAC,EAAE,SAAS,qBAAqB,UAG1D;AAED,wGAAwG;AACxG,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,IAChG,OAAO,CAAC,EAAE,SAAS,qBAAqB,UAG1D;AAED,eAAO,MAAM,UAAU;;CAErB,CAAC;AAcH,8HAA8H;AAC9H,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,uBAAuB,CAAC,UAAU,CAAC,EAAE,QAI3G;AAED,gGAAgG;AAChG,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,QAIxF"}

package/dist/esm/decorators.js

@@ -12,11 +12,13 @@ function setMetadata(value, context, key, metaValue) {
         meta[key] = metaValue;
     }
 }
+/** `@controller(method, path)` routes requests to the class' handle(). Use with autobindControllers() or autobindInjectableControllers(). */
 export function controllerDecorator(method, path) {
     return function (value, context) {
         setMetadata(value, context, "nanodi:controller", { method, path });
     };
 }
+/** `@controller.middleware(...middlewares)` runs the middlewares before the controller on its route. */
 export function middlewareDecorator(...middlewares) {
     return function (value, context) {
         setMetadata(value, context, "nanodi:controller-middlewares", middlewares);
@@ -27,19 +29,21 @@ export const controller = Object.assign(controllerDecorator, {
 });
 function bindController(router, controllerClass) {
     const metadata = controllerClass[Symbol.metadata];
-    if (!metadata) {
+    const route = metadata?.["nanodi:controller"];
+    if (!route) {
         throw new Error(`No @controller metadata found for class: ${controllerClass.name}`);
     }
-    const { method, path } = metadata["nanodi:controller"];
     const middlewares = metadata["nanodi:controller-middlewares"] ?? [];
     const controllerKey = getInjectableClassKey(controllerClass);
-    requestHandler(router, method, path, middlewares, controllerKey);
+    requestHandler(router, route.method, route.path, middlewares, controllerKey);
 }
+/** Adds a route to the router for each class decorated with @controller(). The classes must be registered in the provider. */
 export function autobindControllers(router, controllerClasses) {
     for (const controllerClass of controllerClasses) {
         bindController(router, controllerClass);
     }
 }
+/** Adds a route to the router for each class in the collection decorated with @controller(). */
 export function autobindInjectableControllers(router, services) {
     for (const registration of services.getByMetadata("nanodi:controller")) {
         bindController(router, registration.useClass);

package/dist/esm/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAIjG,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,SAAS,WAAW,CAAwC,KAAQ,EAAE,OAAiC,EAAE,GAAkB,EAAE,SAAc;;IACzI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,sBAAsB;QACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,MAAM,IAAI,GAAG,KAAK,MAAC,MAAM,CAAC,QAAQ,MAArB,KAAK,OAAsB,EAAE,CAAA,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,IAAY;IAEZ,OAAO,UAAU,KAAQ,EAAE,OAA8B;QACvD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAgD,GAAG,WAA6B;IACjH,OAAO,UAAU,KAAQ,EAAE,OAA8B;QACvD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,+BAA+B,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE;IAC3D,UAAU,EAAE,mBAAmB;CAChC,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,MAAc,EAAE,eAAoD;IAC1F,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,mBAAmB,CAAqC,CAAC;IAC3F,MAAM,WAAW,GAAG,QAAQ,CAAC,+BAA+B,CAAqB,IAAI,EAAE,CAAC;IACxF,MAAM,aAAa,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAC7D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,iBAAwD;IAC1G,KAAK,MAAM,eAAe,IAAI,iBAAiB,EAAE,CAAC;QAChD,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAAc,EAAE,QAA2B;IACvF,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACvE,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAIjG,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,SAAS,WAAW,CAAwC,KAAQ,EAAE,OAAiC,EAAE,GAAkB,EAAE,SAAc;;IACzI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,sBAAsB;QACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,yBAAyB;QACzB,MAAM,IAAI,GAAG,KAAK,MAAC,MAAM,CAAC,QAAQ,MAArB,KAAK,OAAsB,EAAE,CAAA,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACxB,CAAC;AACH,CAAC;AAED,6IAA6I;AAC7I,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,IAAY;IAEZ,OAAO,UAAU,KAAQ,EAAE,OAA8B;QACvD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,mBAAmB,CAAgD,GAAG,WAA6B;IACjH,OAAO,UAAU,KAAQ,EAAE,OAA8B;QACvD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,+BAA+B,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE;IAC3D,UAAU,EAAE,mBAAmB;CAChC,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,MAAc,EAAE,eAAoD;IAC1F,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC,mBAAmB,CAAiD,CAAC;IAC9F,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4CAA4C,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,WAAW,GAAG,QAAS,CAAC,+BAA+B,CAAqB,IAAI,EAAE,CAAC;IACzF,MAAM,aAAa,GAAG,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAC7D,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AAC/E,CAAC;AAED,8HAA8H;AAC9H,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,iBAAwD;IAC1G,KAAK,MAAM,eAAe,IAAI,iBAAiB,EAAE,CAAC;QAChD,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,6BAA6B,CAAC,MAAc,EAAE,QAA2B;IACvF,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACvE,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/esm/package.json

@@ -1,3 +1,3 @@
-{
-  "type": "module"
+{
+  "type": "module"
 }

package/dist/esm/symbols.d.ts

@@ -1,3 +1,4 @@
 import type * as Koa from "koa";
+/** Scoped value key for the current Koa context. Register with registerScopedValue(). */
 export declare const ContextKey: import("@nanodi/core").RegistrationSymbol<Koa.Context>;
 //# sourceMappingURL=symbols.d.ts.map

package/dist/esm/symbols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC,eAAO,MAAM,UAAU,wDAA6C,CAAC"}
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,GAAG,MAAM,KAAK,CAAC;AAEhC,yFAAyF;AACzF,eAAO,MAAM,UAAU,wDAA6C,CAAC"}

package/dist/esm/symbols.js

@@ -1,3 +1,4 @@
 import { registrationSymbol } from "@nanodi/core";
+/** Scoped value key for the current Koa context. Register with registerScopedValue(). */
 export const ContextKey = registrationSymbol("Context");
 //# sourceMappingURL=symbols.js.map

package/dist/esm/symbols.js.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/symbols.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAc,SAAS,CAAC,CAAC"}
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/symbols.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,yFAAyF;AACzF,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAc,SAAS,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,15 @@
 {
   "name": "@nanodi/koa",
-  "version": "0.5.1",
+  "version": "0.6.0",
+  "description": "Koa controllers with request-scoped dependency injection using @nanodi/core.",
+  "keywords": [
+    "dependency-injection",
+    "express-middleware",
+    "ioc",
+    "ioc-container",
+    "koa-middleware",
+    "typescript"
+  ],
   "private": false,
   "types": "./dist/esm/index.d.ts",
   "main": "./dist/cjs/index.js",
@@ -33,7 +42,7 @@
     "koa": "^3.0.0"
   },
   "dependencies": {
-    "@nanodi/core": "^0.5.1"
+    "@nanodi/core": "^0.6.0"
   },
   "peerDependencies": {
     "@koa/router": "^15.0.0",