@wilfredojsr/server-node 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wilfredojsr
+
+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/http/health-check.http

@@ -0,0 +1,16 @@
+### Status
+GET {{host}}/
+
+### Ping
+GET {{host}}/ping
+
+### Dynamic Ping
+GET {{host}}/dynamic/123/ping/one?t=qaz
+
+### Dynamic Ping
+POST {{host}}/dynamic/123/ping/one?t=qwerty
+Content-Type: application/json
+
+{
+  "a": 1
+}

package/http/http-client.env.json

@@ -0,0 +1,5 @@
+{
+  "local": {
+    "host": "http://localhost:9000"
+  }
+}

package/nodemon.json

@@ -0,0 +1,6 @@
+{
+  "watch": ["src"],
+  "ext": ".ts,.js",
+  "ignore": [],
+  "exec": "ts-node ./src/main.ts"
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@wilfredojsr/server-node",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "start:dev": "nodemon",
+    "start:prod": "npm run build && cd ./dist && node ./src/main.js",
+    "build": "npm run clean && tsc",
+    "clean": "rimraf dist"
+  },
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "@types/node": "^24.3.0",
+    "nodemon": "^3.1.10",
+    "rimraf": "^6.1.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "dotenv": "^17.2.1",
+    "express": "^5.1.0",
+    "pg": "^8.16.3",
+    "reflect-metadata": "^0.2.2"
+  }
+}

package/src/commons/application.ts

@@ -0,0 +1,51 @@
+import * as express from 'express';
+import { Configurations } from './configurations';
+import {Express} from "express";
+import { join } from 'path';
+
+export class Application {
+  private readonly port = Configurations.get('PORT') || 3000;
+  private readonly app: Express;
+
+  constructor() {
+    this.app = express();
+  }
+
+  static build(options?: ApplicationOptions) {
+    const newApp = new Application();
+    if (!options) {
+      console.warn('Routes not provided. Consider using Application.build({ routes: "path/to/routes" })');
+      return newApp;
+    }
+    const pwd = process.cwd();
+    const path = join(pwd, options?.routes);
+    const routes: Record<any, any> = require(path);
+    if (!routes) {
+      console.warn('Routes not found');
+      return newApp;
+    }
+    Object.values(routes).forEach(route => (new route()['instance'](newApp.app)));
+    return newApp;
+  }
+
+  use(middleware: any) {
+    this.app.use(middleware);
+    return this;
+  }
+
+  pipe(func: (self?: Express) => void) {
+    typeof func === 'function' && func(this.app);
+    return this;
+  }
+
+  start() {
+    this.app.listen(this.port, () => {
+      console.log(`Example app listening on port -> ${this.port}`);
+    });
+    return this;
+  }
+}
+
+interface ApplicationOptions {
+  routes: string;
+}

package/src/commons/configurations.ts

@@ -0,0 +1,9 @@
+import { config } from 'dotenv';
+
+config();
+
+export class Configurations {
+  static get(envVar: string) {
+    return process.env[envVar];
+  }
+}

package/src/commons/decorators/routes-register.ts

@@ -0,0 +1,98 @@
+import 'reflect-metadata';
+
+const paramMetadataKey = Symbol('Param');
+const queryMetadataKey = Symbol('Query');
+const bodyMetadataKey = Symbol('Body');
+
+export function Routes(path: string) {
+  return function (target: any) {
+    const constructor = target.prototype.constructor;
+    constructor.path = path;
+
+    target.prototype.instance = (app) => {
+      const keys = Object.getOwnPropertyNames(target.prototype);
+      keys.forEach(key => {
+        if (key !== 'instance' && key !== 'constructor') {
+          const el = target.prototype[key];
+          if (el instanceof IRoute) {
+            const { method, path: routePath, handler } = el;
+            const mapped = `/${(path || '').replace('/', '')}${(routePath || '').replace('/', '')}`;
+            console.log(`Route -> ${method.toUpperCase()} ${mapped}`);
+            app[method.toLowerCase()](mapped, handler);
+          }
+        }
+      });
+    };
+  };
+}
+
+export function Route(method: string, path: string) {
+  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+    const func = descriptor.value;
+    const route = new IRoute();
+    route.method = method;
+    route.path = path;
+    route.handler = (req, res) => {
+      let params: { index: number, name: string }[] =
+        Reflect.getOwnMetadata(paramMetadataKey, target, propertyKey) || [];
+      let query: { index: number, name: string }[] =
+        Reflect.getOwnMetadata(queryMetadataKey, target, propertyKey) || [];
+      let body: { index: number, name: string }[] =
+        Reflect.getOwnMetadata(bodyMetadataKey, target, propertyKey) || [];
+
+      const args = [...params, ...query, ...body].sort((a, b) => a.index - b.index)
+        .map(param => req.params[param.name] || req.query[param.name] || (param.name === '@@body@@' ? req.body : undefined));
+
+      res.send(func.apply(target, args));
+    };
+    descriptor.value = route;
+  };
+}
+
+export function Param(paramName: string) {
+  return function (target: Object, propertyKey: string, parameterIndex: number) {
+    let params: { index: number, name: string }[] =
+      Reflect.getOwnMetadata(paramMetadataKey, target, propertyKey) || [];
+
+    params.push({
+      index: parameterIndex,
+      name: paramName
+    });
+
+    Reflect.defineMetadata(paramMetadataKey, params, target, propertyKey);
+  };
+}
+
+export function Query(paramName: string) {
+  return function (target: Object, propertyKey: string, parameterIndex: number) {
+    let query: { index: number, name: string }[] =
+      Reflect.getOwnMetadata(queryMetadataKey, target, propertyKey) || [];
+
+    query.push({
+      index: parameterIndex,
+      name: paramName
+    });
+
+    Reflect.defineMetadata(queryMetadataKey, query, target, propertyKey);
+  };
+}
+
+export function Body() {
+  return function (target: Object, propertyKey: string, parameterIndex: number) {
+    let body: { index: number, name: string }[] =
+      Reflect.getOwnMetadata(bodyMetadataKey, target, propertyKey) || [];
+
+    body.push({
+      index: parameterIndex,
+      name: '@@body@@'
+    });
+
+    Reflect.defineMetadata(bodyMetadataKey, body, target, propertyKey);
+  };
+}
+
+class IRoute {
+  method: string;
+  path: string;
+  handler: (req: any, res: any) => any;
+}

package/src/main.ts

@@ -0,0 +1,6 @@
+import * as express from 'express';
+import { Application } from './commons/application';
+
+Application.build({ routes: "src/routes" }).use(express.json()).pipe((app) => {
+  // Any thing for app Express instance
+}).start();

package/src/modules/health-check/health-check.routes.ts

@@ -0,0 +1,42 @@
+import { Body, Param, Query, Route, Routes } from '../../commons/decorators/routes-register';
+
+@Routes('/')
+export class HealthCheckRoutes {
+
+  @Route('get', '/')
+  public healthCheck() {
+    return {
+      status: 'OK'
+    };
+  }
+
+  @Route('get', '/ping')
+  public ping() {
+    return {
+      status: 'Ping'
+    };
+  }
+
+  @Route('get', '/dynamic/:id/ping/:name')
+  public pingDynamic(@Param('id') id: string, @Param('name') name: string, @Query('t') t: string) {
+    return {
+      id,
+      name,
+      t
+    };
+  }
+
+  @Route('post', '/dynamic/:id/ping/:name')
+  public pingDynamicPost(@Param('id') id: string,
+    @Param('name') name: string,
+    @Query('t') t: string,
+    @Body() body: any
+  ) {
+    return {
+      id,
+      name,
+      t,
+      body
+    };
+  }
+}

package/src/routes.ts

@@ -0,0 +1 @@
+export * from './modules/health-check/health-check.routes'

package/tsconfig.build.json

@@ -0,0 +1,3 @@
+{
+  "extends": "./tsconfig.json",
+}

package/tsconfig.json

@@ -0,0 +1,32 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "es2017",
+    "sourceMap": true,
+    "outDir": "./dist/src",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": false,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "forceConsistentCasingInFileNames": false,
+    "noFallthroughCasesInSwitch": false,
+    "resolveJsonModule": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "test",
+    "dist",
+    "http",
+    "**/*spec.ts"
+  ]
+}