@devbro/neko-router 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @devbro/neko-router
+
+cool routing solution for choosing the code that runs for a given URI.
+
+## supported features
+
+- support controller and function as main executor
+- middleware support both as class and function
+- singleton middleware and new instance per request middleware
+- support route variables
+
+## example
+
+```ts
+import {Router, Request, Response} from '@devbro/neko-router';
+const router: Router = new Router();
+
+router.addRoute(['GET', 'HEAD'], '/api/v1/countries', async (req: Request, res: Response) => {
+    return 'GET countries';
+});
+
+router
+    .addRoute(['POST'], '/api/v1/countries', async (req: Request, res: Response) => {
+    return 'POST countries';
+    })
+    .addMiddleware([m1, m2]);
+
+    router.addRoute(
+      ['GET'],
+      '/api/v1/countries/:countryId',
+      async (req: Request, res: Response) => {
+        return 'GET PARAM countries ' + req.params?.countryId;
+      }
+    ).addMiddleware((req,res,next) => {
+        console.log('request.params:', req.params);
+        await next();
+        console.log('final result:', res.statusCode);
+    });
+
+    let req = { url: '/api/v1/countries', method: 'GET' } as Request;
+    let res = { ??? } as Response;
+    let resolved = router.resolve(req);
+
+    let compiled_route = router.getCompiledRoute(req,res);
+    await compiled_route.run();
+    console.log(res.statusCode);
+```

package/dist/CompiledRoute.d.mts

@@ -0,0 +1,23 @@
+import { R as Request, a as Response, M as MiddlewareProvider, b as Middleware } from './Middleware-BjWt0Uml.mjs';
+import { Route } from './Route.mjs';
+import 'http';
+
+declare class CompiledRoute {
+    route: Route;
+    match: any;
+    request: Request;
+    response: Response;
+    globalMiddlewares: MiddlewareProvider[];
+    constructor(route: Route, match: any, request: Request, response: Response, globalMiddlewares?: MiddlewareProvider[]);
+    private middlewares;
+    getMiddlewares(): Middleware[];
+    private prepareMiddlewares;
+    isClass(func: any): boolean;
+    run(): Promise<void>;
+    prepareOutputJsonFormat<T>(obj: object | Array<any>): T;
+    convertToString(obj: any): string;
+    processResponseBody(res: Response, controller_rc: any): void;
+    runMiddlewares(middlewares: Middleware[], req: Request, res: Response): Promise<void>;
+}
+
+export { CompiledRoute };

package/dist/CompiledRoute.d.ts

@@ -0,0 +1,23 @@
+import { R as Request, a as Response, M as MiddlewareProvider, b as Middleware } from './Middleware-BjWt0Uml.js';
+import { Route } from './Route.js';
+import 'http';
+
+declare class CompiledRoute {
+    route: Route;
+    match: any;
+    request: Request;
+    response: Response;
+    globalMiddlewares: MiddlewareProvider[];
+    constructor(route: Route, match: any, request: Request, response: Response, globalMiddlewares?: MiddlewareProvider[]);
+    private middlewares;
+    getMiddlewares(): Middleware[];
+    private prepareMiddlewares;
+    isClass(func: any): boolean;
+    run(): Promise<void>;
+    prepareOutputJsonFormat<T>(obj: object | Array<any>): T;
+    convertToString(obj: any): string;
+    processResponseBody(res: Response, controller_rc: any): void;
+    runMiddlewares(middlewares: Middleware[], req: Request, res: Response): Promise<void>;
+}
+
+export { CompiledRoute };

package/dist/CompiledRoute.js

@@ -0,0 +1,162 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+var CompiledRoute_exports = {};
+__export(CompiledRoute_exports, {
+  CompiledRoute: () => CompiledRoute
+});
+module.exports = __toCommonJS(CompiledRoute_exports);
+var import_Middleware = require("./Middleware");
+var import_MiddlewareFactory = require("./MiddlewareFactory");
+class CompiledRoute {
+  constructor(route, match, request, response, globalMiddlewares = []) {
+    this.route = route;
+    this.match = match;
+    this.request = request;
+    this.response = response;
+    this.globalMiddlewares = globalMiddlewares;
+    this.middlewares = [];
+    this.prepareMiddlewares();
+  }
+  getMiddlewares() {
+    return this.middlewares;
+  }
+  prepareMiddlewares() {
+    this.middlewares = [];
+    for (const middleware of [...this.globalMiddlewares, ...this.route.getMiddlewares()]) {
+      if (middleware instanceof import_Middleware.Middleware) {
+        this.middlewares.push(middleware);
+      } else if (this.isClass(middleware)) {
+        this.middlewares.push(middleware.getInstance({}));
+      } else if (typeof middleware === "function") {
+        this.middlewares.push(import_MiddlewareFactory.MiddlewareFactory.create(middleware));
+      } else {
+        throw new Error("Invalid middleware type");
+      }
+    }
+  }
+  isClass(func) {
+    return typeof func === "function" && /^class\s/.test(Function.prototype.toString.call(func));
+  }
+  run() {
+    return __async(this, null, function* () {
+      return yield this.runMiddlewares(this.middlewares, this.request, this.response);
+    });
+  }
+  prepareOutputJsonFormat(obj) {
+    function traverse(value) {
+      if (!value || typeof value !== "object") {
+        return value;
+      }
+      if (typeof value.toJson === "function") {
+        return traverse(value.toJson());
+      }
+      if (Array.isArray(value)) {
+        return value.map(traverse);
+      }
+      const result = {};
+      for (const key in value) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
+          result[key] = traverse(value[key]);
+        }
+      }
+      return result;
+    }
+    return traverse(obj);
+  }
+  convertToString(obj) {
+    if (typeof obj === "string") {
+      return obj;
+    } else if (obj instanceof Buffer) {
+      return obj.toString();
+    } else if (typeof obj === "object") {
+      return JSON.stringify(this.prepareOutputJsonFormat(obj));
+    }
+    return String(obj);
+  }
+  processResponseBody(res, controller_rc) {
+    if (controller_rc && res.writableEnded) {
+      throw new Error("cannot write to response, response has already ended");
+    }
+    if (res.writableEnded) {
+      return;
+    }
+    if (controller_rc) {
+      const header_content_type = res.getHeader("Content-Type");
+      if (!header_content_type && typeof controller_rc === "object") {
+        res.setHeader("Content-Type", "application/json");
+      } else if (!header_content_type) {
+        res.setHeader("Content-Type", "text/plain");
+      }
+      res.end(this.convertToString(controller_rc));
+      return;
+    } else {
+      res.statusCode = [200].includes(res.statusCode) ? 204 : res.statusCode;
+      res.end();
+    }
+  }
+  runMiddlewares(middlewares, req, res) {
+    return __async(this, null, function* () {
+      let index = 0;
+      const me = this;
+      function next() {
+        return __async(this, null, function* () {
+          if (index >= middlewares.length) {
+            const controller_rc = yield me.route.callHanlder(req, res);
+            yield me.processResponseBody(res, controller_rc);
+            return;
+          }
+          const middleware = middlewares[index++];
+          if (middleware instanceof import_Middleware.Middleware) {
+            yield middleware.call(req, res, next);
+          } else if (typeof middleware === "function") {
+            yield middleware(req, res, next);
+          } else {
+            throw new Error("does not know how to run middleware");
+          }
+        });
+      }
+      yield next();
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CompiledRoute
+});
+//# sourceMappingURL=CompiledRoute.js.map

package/dist/CompiledRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/CompiledRoute.ts"],"sourcesContent":["import { Middleware } from './Middleware';\nimport { MiddlewareFactory } from './MiddlewareFactory';\nimport { Route } from './Route';\nimport { HandlerType, MiddlewareProvider } from './types';\nimport { LexerToken, Request, Response } from './types';\n\nexport class CompiledRoute {\n  constructor(\n    public route: Route,\n    public match: any,\n    public request: Request,\n    public response: Response,\n    public globalMiddlewares: MiddlewareProvider[] = []\n  ) {\n    this.prepareMiddlewares();\n  }\n\n  private middlewares: Middleware[] = [];\n\n  getMiddlewares() {\n    return this.middlewares;\n  }\n\n  private prepareMiddlewares() {\n    this.middlewares = [];\n    for (const middleware of [...this.globalMiddlewares, ...this.route.getMiddlewares()]) {\n      if (middleware instanceof Middleware) {\n        this.middlewares.push(middleware);\n      } else if (this.isClass(middleware)) {\n        this.middlewares.push((middleware as any).getInstance({}));\n      } else if (typeof middleware === 'function') {\n        this.middlewares.push(MiddlewareFactory.create(middleware as HandlerType));\n      } else {\n        throw new Error('Invalid middleware type');\n      }\n    }\n  }\n\n  isClass(func: any) {\n    return typeof func === 'function' && /^class\\s/.test(Function.prototype.toString.call(func));\n  }\n\n  async run() {\n    return await this.runMiddlewares(this.middlewares, this.request, this.response);\n  }\n\n  prepareOutputJsonFormat<T>(obj: object | Array<any>): T {\n    function traverse(value: any): any {\n      if (!value || typeof value !== 'object') {\n        return value;\n      }\n\n      if (typeof value.toJson === 'function') {\n        return traverse(value.toJson());\n      }\n\n      if (Array.isArray(value)) {\n        return value.map(traverse);\n      }\n\n      const result: Record<string, any> = {};\n      for (const key in value) {\n        if (Object.prototype.hasOwnProperty.call(value, key)) {\n          result[key] = traverse(value[key]);\n        }\n      }\n      return result;\n    }\n\n    return traverse(obj);\n  }\n\n  convertToString(obj: any) {\n    if (typeof obj === 'string') {\n      return obj;\n    } else if (obj instanceof Buffer) {\n      return obj.toString();\n    } else if (typeof obj === 'object') {\n      return JSON.stringify(this.prepareOutputJsonFormat(obj));\n    }\n    return String(obj);\n  }\n\n  processResponseBody(res: Response, controller_rc: any) {\n    if (controller_rc && res.writableEnded) {\n      throw new Error('cannot write to response, response has already ended');\n    }\n\n    if (res.writableEnded) {\n      return;\n    }\n\n    if (controller_rc) {\n      const header_content_type = res.getHeader('Content-Type');\n      if (!header_content_type && typeof controller_rc === 'object') {\n        res.setHeader('Content-Type', 'application/json');\n      } else if (!header_content_type) {\n        res.setHeader('Content-Type', 'text/plain');\n      }\n\n      res.end(this.convertToString(controller_rc));\n      return;\n    } else {\n      res.statusCode = [200].includes(res.statusCode) ? 204 : res.statusCode;\n      res.end();\n    }\n  }\n\n  async runMiddlewares(middlewares: Middleware[], req: Request, res: Response) {\n    let index = 0;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const me = this;\n\n    async function next() {\n      if (index >= middlewares.length) {\n        const controller_rc = await me.route.callHanlder(req, res);\n        await me.processResponseBody(res, controller_rc);\n        return;\n      }\n\n      const middleware: Middleware | any = middlewares[index++];\n\n      if (middleware instanceof Middleware) {\n        await middleware.call(req, res, next);\n      } else if (typeof middleware === 'function') {\n        await middleware(req, res, next);\n      } else {\n        throw new Error('does not know how to run middleware');\n      }\n    }\n\n    await next();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/CompiledRoute.mjs

@@ -0,0 +1,138 @@
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+import { Middleware } from "./Middleware";
+import { MiddlewareFactory } from "./MiddlewareFactory";
+class CompiledRoute {
+  constructor(route, match, request, response, globalMiddlewares = []) {
+    this.route = route;
+    this.match = match;
+    this.request = request;
+    this.response = response;
+    this.globalMiddlewares = globalMiddlewares;
+    this.middlewares = [];
+    this.prepareMiddlewares();
+  }
+  getMiddlewares() {
+    return this.middlewares;
+  }
+  prepareMiddlewares() {
+    this.middlewares = [];
+    for (const middleware of [...this.globalMiddlewares, ...this.route.getMiddlewares()]) {
+      if (middleware instanceof Middleware) {
+        this.middlewares.push(middleware);
+      } else if (this.isClass(middleware)) {
+        this.middlewares.push(middleware.getInstance({}));
+      } else if (typeof middleware === "function") {
+        this.middlewares.push(MiddlewareFactory.create(middleware));
+      } else {
+        throw new Error("Invalid middleware type");
+      }
+    }
+  }
+  isClass(func) {
+    return typeof func === "function" && /^class\s/.test(Function.prototype.toString.call(func));
+  }
+  run() {
+    return __async(this, null, function* () {
+      return yield this.runMiddlewares(this.middlewares, this.request, this.response);
+    });
+  }
+  prepareOutputJsonFormat(obj) {
+    function traverse(value) {
+      if (!value || typeof value !== "object") {
+        return value;
+      }
+      if (typeof value.toJson === "function") {
+        return traverse(value.toJson());
+      }
+      if (Array.isArray(value)) {
+        return value.map(traverse);
+      }
+      const result = {};
+      for (const key in value) {
+        if (Object.prototype.hasOwnProperty.call(value, key)) {
+          result[key] = traverse(value[key]);
+        }
+      }
+      return result;
+    }
+    return traverse(obj);
+  }
+  convertToString(obj) {
+    if (typeof obj === "string") {
+      return obj;
+    } else if (obj instanceof Buffer) {
+      return obj.toString();
+    } else if (typeof obj === "object") {
+      return JSON.stringify(this.prepareOutputJsonFormat(obj));
+    }
+    return String(obj);
+  }
+  processResponseBody(res, controller_rc) {
+    if (controller_rc && res.writableEnded) {
+      throw new Error("cannot write to response, response has already ended");
+    }
+    if (res.writableEnded) {
+      return;
+    }
+    if (controller_rc) {
+      const header_content_type = res.getHeader("Content-Type");
+      if (!header_content_type && typeof controller_rc === "object") {
+        res.setHeader("Content-Type", "application/json");
+      } else if (!header_content_type) {
+        res.setHeader("Content-Type", "text/plain");
+      }
+      res.end(this.convertToString(controller_rc));
+      return;
+    } else {
+      res.statusCode = [200].includes(res.statusCode) ? 204 : res.statusCode;
+      res.end();
+    }
+  }
+  runMiddlewares(middlewares, req, res) {
+    return __async(this, null, function* () {
+      let index = 0;
+      const me = this;
+      function next() {
+        return __async(this, null, function* () {
+          if (index >= middlewares.length) {
+            const controller_rc = yield me.route.callHanlder(req, res);
+            yield me.processResponseBody(res, controller_rc);
+            return;
+          }
+          const middleware = middlewares[index++];
+          if (middleware instanceof Middleware) {
+            yield middleware.call(req, res, next);
+          } else if (typeof middleware === "function") {
+            yield middleware(req, res, next);
+          } else {
+            throw new Error("does not know how to run middleware");
+          }
+        });
+      }
+      yield next();
+    });
+  }
+}
+export {
+  CompiledRoute
+};
+//# sourceMappingURL=CompiledRoute.mjs.map

package/dist/CompiledRoute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/CompiledRoute.ts"],"sourcesContent":["import { Middleware } from './Middleware';\nimport { MiddlewareFactory } from './MiddlewareFactory';\nimport { Route } from './Route';\nimport { HandlerType, MiddlewareProvider } from './types';\nimport { LexerToken, Request, Response } from './types';\n\nexport class CompiledRoute {\n  constructor(\n    public route: Route,\n    public match: any,\n    public request: Request,\n    public response: Response,\n    public globalMiddlewares: MiddlewareProvider[] = []\n  ) {\n    this.prepareMiddlewares();\n  }\n\n  private middlewares: Middleware[] = [];\n\n  getMiddlewares() {\n    return this.middlewares;\n  }\n\n  private prepareMiddlewares() {\n    this.middlewares = [];\n    for (const middleware of [...this.globalMiddlewares, ...this.route.getMiddlewares()]) {\n      if (middleware instanceof Middleware) {\n        this.middlewares.push(middleware);\n      } else if (this.isClass(middleware)) {\n        this.middlewares.push((middleware as any).getInstance({}));\n      } else if (typeof middleware === 'function') {\n        this.middlewares.push(MiddlewareFactory.create(middleware as HandlerType));\n      } else {\n        throw new Error('Invalid middleware type');\n      }\n    }\n  }\n\n  isClass(func: any) {\n    return typeof func === 'function' && /^class\\s/.test(Function.prototype.toString.call(func));\n  }\n\n  async run() {\n    return await this.runMiddlewares(this.middlewares, this.request, this.response);\n  }\n\n  prepareOutputJsonFormat<T>(obj: object | Array<any>): T {\n    function traverse(value: any): any {\n      if (!value || typeof value !== 'object') {\n        return value;\n      }\n\n      if (typeof value.toJson === 'function') {\n        return traverse(value.toJson());\n      }\n\n      if (Array.isArray(value)) {\n        return value.map(traverse);\n      }\n\n      const result: Record<string, any> = {};\n      for (const key in value) {\n        if (Object.prototype.hasOwnProperty.call(value, key)) {\n          result[key] = traverse(value[key]);\n        }\n      }\n      return result;\n    }\n\n    return traverse(obj);\n  }\n\n  convertToString(obj: any) {\n    if (typeof obj === 'string') {\n      return obj;\n    } else if (obj instanceof Buffer) {\n      return obj.toString();\n    } else if (typeof obj === 'object') {\n      return JSON.stringify(this.prepareOutputJsonFormat(obj));\n    }\n    return String(obj);\n  }\n\n  processResponseBody(res: Response, controller_rc: any) {\n    if (controller_rc && res.writableEnded) {\n      throw new Error('cannot write to response, response has already ended');\n    }\n\n    if (res.writableEnded) {\n      return;\n    }\n\n    if (controller_rc) {\n      const header_content_type = res.getHeader('Content-Type');\n      if (!header_content_type && typeof controller_rc === 'object') {\n        res.setHeader('Content-Type', 'application/json');\n      } else if (!header_content_type) {\n        res.setHeader('Content-Type', 'text/plain');\n      }\n\n      res.end(this.convertToString(controller_rc));\n      return;\n    } else {\n      res.statusCode = [200].includes(res.statusCode) ? 204 : res.statusCode;\n      res.end();\n    }\n  }\n\n  async runMiddlewares(middlewares: Middleware[], req: Request, res: Response) {\n    let index = 0;\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const me = this;\n\n    async function next() {\n      if (index >= middlewares.length) {\n        const controller_rc = await me.route.callHanlder(req, res);\n        await me.processResponseBody(res, controller_rc);\n        return;\n      }\n\n      const middleware: Middleware | any = middlewares[index++];\n\n      if (middleware instanceof Middleware) {\n        await middleware.call(req, res, next);\n      } else if (typeof middleware === 'function') {\n        await middleware(req, res, next);\n      } else {\n        throw new Error('does not know how to run middleware');\n      }\n    }\n\n    await next();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/Controller.d.mts

@@ -0,0 +1,38 @@
+import { M as MiddlewareProvider, C as ControllerDecoratorOptions } from './Middleware-BjWt0Uml.mjs';
+import 'http';
+
+declare class BaseController {
+    static routes: {
+        methods: string[];
+        path: string;
+        handler: string;
+        middlewares: MiddlewareProvider[];
+    }[];
+    static basePath: string;
+    static baseMiddlewares: MiddlewareProvider[];
+    static getInstance(): BaseController;
+}
+declare function Controller(path: string, options?: ControllerDecoratorOptions): ClassDecorator;
+declare function Get(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function Post(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function Put(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function Patch(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function Delete(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function createParamDecorator(func: () => Promise<any> | (() => any)): ParameterDecorator;
+
+export { BaseController, Controller, Delete, Get, Patch, Post, Put, createParamDecorator };

package/dist/Controller.d.ts

@@ -0,0 +1,38 @@
+import { M as MiddlewareProvider, C as ControllerDecoratorOptions } from './Middleware-BjWt0Uml.js';
+import 'http';
+
+declare class BaseController {
+    static routes: {
+        methods: string[];
+        path: string;
+        handler: string;
+        middlewares: MiddlewareProvider[];
+    }[];
+    static basePath: string;
+    static baseMiddlewares: MiddlewareProvider[];
+    static getInstance(): BaseController;
+}
+declare function Controller(path: string, options?: ControllerDecoratorOptions): ClassDecorator;
+declare function Get(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function Post(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function Put(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function Patch(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function Delete(data?: {
+    path?: string;
+    middlewares?: MiddlewareProvider[];
+}): MethodDecorator;
+declare function createParamDecorator(func: () => Promise<any> | (() => any)): ParameterDecorator;
+
+export { BaseController, Controller, Delete, Get, Patch, Post, Put, createParamDecorator };

package/dist/Controller.js

@@ -0,0 +1,146 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+var Controller_exports = {};
+__export(Controller_exports, {
+  BaseController: () => BaseController,
+  Controller: () => Controller,
+  Delete: () => Delete,
+  Get: () => Get,
+  Patch: () => Patch,
+  Post: () => Post,
+  Put: () => Put,
+  createParamDecorator: () => createParamDecorator
+});
+module.exports = __toCommonJS(Controller_exports);
+class BaseController {
+  static getInstance() {
+    return new this();
+  }
+}
+BaseController.routes = [];
+BaseController.basePath = "";
+function Controller(path, options = {}) {
+  return function(target) {
+    target.routes = target.routes || [];
+    target.basePath = path;
+    target.baseMiddlewares = options.middlewares || [];
+  };
+}
+function createHttpDecorator(data) {
+  return function(target, propertyKey, descriptor) {
+    if (!target.constructor.routes) {
+      target.constructor.routes = [];
+    }
+    target.constructor.routes.push({
+      methods: data.methods,
+      path: data.path,
+      handler: propertyKey,
+      middlewares: data.middlewares || []
+    });
+    const originalMethod = descriptor.value;
+    const paramKeys = Reflect.ownKeys(target);
+    descriptor.value = function(...args) {
+      return __async(this, null, function* () {
+        const paramCustomKeys = paramKeys.filter(
+          (key) => typeof key === "string" && key.endsWith(":custom")
+        );
+        for (const paramKey of paramCustomKeys) {
+          const paramIndex = parseInt(paramKey.split(":")[1]);
+          let method = Reflect.get(target, paramKey.toString());
+          if (typeof paramIndex === "number" && typeof method === "function") {
+            args[paramIndex] = yield method();
+          }
+        }
+        return originalMethod.apply(this, args);
+      });
+    };
+  };
+}
+function Get(data = {}) {
+  return createHttpDecorator({
+    methods: ["GET", "HEAD"],
+    path: data.path || "/",
+    middlewares: data.middlewares || []
+  });
+}
+function Post(data = {}) {
+  return createHttpDecorator({
+    methods: ["POST"],
+    path: data.path || "/",
+    middlewares: data.middlewares || []
+  });
+}
+function Put(data = {}) {
+  return createHttpDecorator({
+    methods: ["PUT"],
+    path: data.path || "/",
+    middlewares: data.middlewares || []
+  });
+}
+function Patch(data = {}) {
+  return createHttpDecorator({
+    methods: ["PATCH"],
+    path: data.path || "/",
+    middlewares: data.middlewares || []
+  });
+}
+function Delete(data = {}) {
+  return createHttpDecorator({
+    methods: ["DELETE"],
+    path: data.path || "/",
+    middlewares: data.middlewares || []
+  });
+}
+function createParamDecorator(func) {
+  return function MyParamDecorator(target, propertyKey, parameterIndex) {
+    Reflect.set(target, `${propertyKey == null ? void 0 : propertyKey.toString()}:${parameterIndex}:custom`, func);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseController,
+  Controller,
+  Delete,
+  Get,
+  Patch,
+  Post,
+  Put,
+  createParamDecorator
+});
+//# sourceMappingURL=Controller.js.map

package/dist/Controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Controller.ts"],"sourcesContent":["import { ControllerDecoratorOptions, MiddlewareProvider } from './types';\nimport { Middleware } from './Middleware';\n\nexport class BaseController {\n  static routes: {\n    methods: string[];\n    path: string;\n    handler: string;\n    middlewares: MiddlewareProvider[];\n  }[] = [];\n  static basePath: string = '';\n  static baseMiddlewares: MiddlewareProvider[];\n\n  static getInstance() {\n    return new this();\n  }\n}\n\nexport function Controller(path: string, options: ControllerDecoratorOptions = {}): ClassDecorator {\n  return function (target: any) {\n    (target as any).routes = (target as any).routes || [];\n    (target as any).basePath = path;\n    (target as any).baseMiddlewares = options.middlewares || [];\n  };\n}\n\nfunction createHttpDecorator(data: {\n  methods: string[];\n  path: string;\n  middlewares: MiddlewareProvider[];\n}): MethodDecorator {\n  return function (target: any, propertyKey: string | symbol, descriptor: PropertyDescriptor) {\n    if (!target.constructor.routes) {\n      target.constructor.routes = [];\n    }\n    target.constructor.routes.push({\n      methods: data.methods,\n      path: data.path,\n      handler: propertyKey,\n      middlewares: data.middlewares || [],\n    });\n\n    const originalMethod = descriptor.value!;\n    const paramKeys = Reflect.ownKeys(target);\n\n    descriptor.value = async function (...args: any[]) {\n      const paramCustomKeys = paramKeys.filter(\n        (key) => typeof key === 'string' && key.endsWith(':custom')\n      );\n      for (const paramKey of paramCustomKeys) {\n        const paramIndex = parseInt((paramKey as string).split(':')[1]);\n        let method = Reflect.get(target, paramKey.toString());\n        if (typeof paramIndex === 'number' && typeof method === 'function') {\n          args[paramIndex] = await method();\n        }\n      }\n\n      return originalMethod.apply(this, args);\n    };\n  };\n}\n\nexport function Get(\n  data: { path?: string; middlewares?: MiddlewareProvider[] } = {}\n): MethodDecorator {\n  return createHttpDecorator({\n    methods: ['GET', 'HEAD'],\n    path: data.path || '/',\n    middlewares: data.middlewares || [],\n  });\n}\n\nexport function Post(\n  data: { path?: string; middlewares?: MiddlewareProvider[] } = {}\n): MethodDecorator {\n  return createHttpDecorator({\n    methods: ['POST'],\n    path: data.path || '/',\n    middlewares: data.middlewares || [],\n  });\n}\n\nexport function Put(\n  data: { path?: string; middlewares?: MiddlewareProvider[] } = {}\n): MethodDecorator {\n  return createHttpDecorator({\n    methods: ['PUT'],\n    path: data.path || '/',\n    middlewares: data.middlewares || [],\n  });\n}\n\nexport function Patch(\n  data: { path?: string; middlewares?: MiddlewareProvider[] } = {}\n): MethodDecorator {\n  return createHttpDecorator({\n    methods: ['PATCH'],\n    path: data.path || '/',\n    middlewares: data.middlewares || [],\n  });\n}\n\nexport function Delete(\n  data: { path?: string; middlewares?: MiddlewareProvider[] } = {}\n): MethodDecorator {\n  return createHttpDecorator({\n    methods: ['DELETE'],\n    path: data.path || '/',\n    middlewares: data.middlewares || [],\n  });\n}\n\nexport function createParamDecorator(func: () => Promise<any> | (() => any)): ParameterDecorator {\n  return function MyParamDecorator(\n    target: Object,\n    propertyKey: string | symbol | undefined,\n    parameterIndex: number\n  ) {\n    Reflect.set(target, `${propertyKey?.toString()}:${parameterIndex}:custom`, func);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,MAAM,eAAe;AAAA,EAU1B,OAAO,cAAc;AACnB,WAAO,IAAI,KAAK;AAAA,EAClB;AACF;AAba,eACJ,SAKD,CAAC;AANI,eAOJ,WAAmB;AAQrB,SAAS,WAAW,MAAc,UAAsC,CAAC,GAAmB;AACjG,SAAO,SAAU,QAAa;AAC5B,IAAC,OAAe,SAAU,OAAe,UAAU,CAAC;AACpD,IAAC,OAAe,WAAW;AAC3B,IAAC,OAAe,kBAAkB,QAAQ,eAAe,CAAC;AAAA,EAC5D;AACF;AAEA,SAAS,oBAAoB,MAIT;AAClB,SAAO,SAAU,QAAa,aAA8B,YAAgC;AAC1F,QAAI,CAAC,OAAO,YAAY,QAAQ;AAC9B,aAAO,YAAY,SAAS,CAAC;AAAA,IAC/B;AACA,WAAO,YAAY,OAAO,KAAK;AAAA,MAC7B,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,SAAS;AAAA,MACT,aAAa,KAAK,eAAe,CAAC;AAAA,IACpC,CAAC;AAED,UAAM,iBAAiB,WAAW;AAClC,UAAM,YAAY,QAAQ,QAAQ,MAAM;AAExC,eAAW,QAAQ,YAAmB,MAAa;AAAA;AACjD,cAAM,kBAAkB,UAAU;AAAA,UAChC,CAAC,QAAQ,OAAO,QAAQ,YAAY,IAAI,SAAS,SAAS;AAAA,QAC5D;AACA,mBAAW,YAAY,iBAAiB;AACtC,gBAAM,aAAa,SAAU,SAAoB,MAAM,GAAG,EAAE,CAAC,CAAC;AAC9D,cAAI,SAAS,QAAQ,IAAI,QAAQ,SAAS,SAAS,CAAC;AACpD,cAAI,OAAO,eAAe,YAAY,OAAO,WAAW,YAAY;AAClE,iBAAK,UAAU,IAAI,MAAM,OAAO;AAAA,UAClC;AAAA,QACF;AAEA,eAAO,eAAe,MAAM,MAAM,IAAI;AAAA,MACxC;AAAA;AAAA,EACF;AACF;AAEO,SAAS,IACd,OAA8D,CAAC,GAC9C;AACjB,SAAO,oBAAoB;AAAA,IACzB,SAAS,CAAC,OAAO,MAAM;AAAA,IACvB,MAAM,KAAK,QAAQ;AAAA,IACnB,aAAa,KAAK,eAAe,CAAC;AAAA,EACpC,CAAC;AACH;AAEO,SAAS,KACd,OAA8D,CAAC,GAC9C;AACjB,SAAO,oBAAoB;AAAA,IACzB,SAAS,CAAC,MAAM;AAAA,IAChB,MAAM,KAAK,QAAQ;AAAA,IACnB,aAAa,KAAK,eAAe,CAAC;AAAA,EACpC,CAAC;AACH;AAEO,SAAS,IACd,OAA8D,CAAC,GAC9C;AACjB,SAAO,oBAAoB;AAAA,IACzB,SAAS,CAAC,KAAK;AAAA,IACf,MAAM,KAAK,QAAQ;AAAA,IACnB,aAAa,KAAK,eAAe,CAAC;AAAA,EACpC,CAAC;AACH;AAEO,SAAS,MACd,OAA8D,CAAC,GAC9C;AACjB,SAAO,oBAAoB;AAAA,IACzB,SAAS,CAAC,OAAO;AAAA,IACjB,MAAM,KAAK,QAAQ;AAAA,IACnB,aAAa,KAAK,eAAe,CAAC;AAAA,EACpC,CAAC;AACH;AAEO,SAAS,OACd,OAA8D,CAAC,GAC9C;AACjB,SAAO,oBAAoB;AAAA,IACzB,SAAS,CAAC,QAAQ;AAAA,IAClB,MAAM,KAAK,QAAQ;AAAA,IACnB,aAAa,KAAK,eAAe,CAAC;AAAA,EACpC,CAAC;AACH;AAEO,SAAS,qBAAqB,MAA4D;AAC/F,SAAO,SAAS,iBACd,QACA,aACA,gBACA;AACA,YAAQ,IAAI,QAAQ,GAAG,2CAAa,UAAU,IAAI,cAAc,WAAW,IAAI;AAAA,EACjF;AACF;","names":[]}