@avelardelarosa/core-util 0.0.3

package/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/README.md

@@ -0,0 +1,37 @@
+# 🧱 core-util
+
+**core-util** es una librería personal de utilidades para proyectos **NestJS**, diseñada para centralizar componentes clave y facilitar el desarrollo backend mediante recursos reutilizables y estructurados.
+
+---
+
+## 🔍 Propósito
+
+Este proyecto actúa como una **capa base** para múltiples servicios NestJS, ofreciendo:
+
+- ✅ **Clases abstractas comunes**  
+  Por ejemplo, entidades base con campos de auditoría o herencia reutilizable.
+
+- 📦 **Modelos de respuesta estándar**  
+  Para mantener consistencia en las respuestas de tus APIs.
+
+- 🛡️ **Decoradores y validaciones personalizadas**  
+  Para mejorar la legibilidad y control de tus DTOs.
+
+- 🔧 **Funciones utilitarias**  
+  Manejo de fechas, formateo de datos, utilidades comunes, etc.
+
+- 🧪 **DTOs, constantes y helpers compartidos**  
+  Que se pueden reutilizar entre distintos microservicios.
+
+---
+
+## 🚀 Beneficios
+
+- 🔁 **Reduce el código repetitivo**
+- 🧩 **Aporta consistencia entre proyectos**
+- 📈 **Mejora la escalabilidad y mantenimiento**
+- ♻️ **Fácil de extender y reutilizar**
+
+---
+
+> Este proyecto forma parte de una arquitectura modular para uso personal, y está pensado para integrarse fácilmente en cualquier backend desarrollado con NestJS.

package/eslint.config.mjs

@@ -0,0 +1,34 @@
+// @ts-check
+import eslint from '@eslint/js';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  {
+    ignores: ['eslint.config.mjs'],
+  },
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  eslintPluginPrettierRecommended,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.node,
+        ...globals.jest,
+      },
+      sourceType: 'commonjs',
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+  },
+  {
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-floating-promises': 'warn',
+      '@typescript-eslint/no-unsafe-argument': 'warn'
+    },
+  },
+);

package/nest-cli.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@avelardelarosa/core-util",
+  "version": "0.0.3",
+  "description": "Librería de utilidades comunes para servicios backend desarrollados con NestJS",
+  "author": "Alexander Junior Velarde La Rosa <avelardelarosa@gmail.com>",
+  "private": false,
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "nest build",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:e2e": "jest --config ./test/jest-e2e.json"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/platform-express": "^11.0.1",
+    "@nestjs/typeorm": "^11.0.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "mysql2": "^3.14.2",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "typeorm": "^0.3.25"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@swc/cli": "^0.6.0",
+    "@swc/core": "^1.10.7",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.7",
+    "@types/supertest": "^6.0.2",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "globals": "^16.0.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  }
+}

package/src/api/response/ApiResponse.ts

@@ -0,0 +1,40 @@
+export class Pagination<T> {
+  pageNumber: number;
+  pageSize: number;
+  body: T[];
+  totalElements: number;
+  totalPages: number;
+  lastRow: boolean;
+
+  constructor(init?: Partial<Pagination<T>>) {
+    Object.assign(this, init);
+  }
+}
+
+export class ApiResponse<T> {
+  successful: boolean;
+  code: string;
+  message: string;
+  data: T;
+
+  constructor(init?: Partial<ApiResponse<T>>) {
+    Object.assign(this, init);
+  }
+
+  success(message: string, data: T) {
+    this.successful = true;
+    this.message = message;
+    this.data = data;
+  }
+
+  error(code: string, message: string) {
+    this.successful = false;
+    this.code = code;
+    this.message = message;
+  }
+
+  msg(message: string) {
+    this.successful = true;
+    this.message = message;
+  }
+}

package/src/app.controller.spec.ts

@@ -0,0 +1,22 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+
+describe('AppController', () => {
+  let appController: AppController;
+
+  beforeEach(async () => {
+    const app: TestingModule = await Test.createTestingModule({
+      controllers: [AppController],
+      providers: [AppService],
+    }).compile();
+
+    appController = app.get<AppController>(AppController);
+  });
+
+  describe('root', () => {
+    it('should return "Hello World!"', () => {
+      expect(appController.getHello()).toBe('Hello World!');
+    });
+  });
+});

package/src/app.controller.ts

@@ -0,0 +1,12 @@
+import { Controller, Get } from '@nestjs/common';
+import { AppService } from './app.service';
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get()
+  getHello(): string {
+    return this.appService.getHello();
+  }
+}

package/src/app.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+
+@Module({
+  imports: [],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}

package/src/app.service.ts

@@ -0,0 +1,8 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHello(): string {
+    return 'Hello World!';
+  }
+}

package/src/dto/AuditoryDTO.ts

@@ -0,0 +1,8 @@
+export class AuditoryDTO {
+  createUser: string;
+  createDate: string;
+  updateUser: string;
+  updateDate: string;
+  deleteUser: string;
+  deleteDate: string;
+}

package/src/entities/Auditory.ts

@@ -0,0 +1,25 @@
+import { Column, Entity } from 'typeorm';
+import { IsDate } from 'class-validator';
+import { Type } from 'class-transformer';
+
+@Entity()
+export class Auditory {
+  @Column({ nullable: false })
+  createUser: string;
+  @Column({ type: 'timestamp', nullable: false })
+  @IsDate()
+  @Type(() => Date)
+  createDate: Date;
+  @Column({ nullable: false })
+  updateUser: string;
+  @Column({ type: 'timestamp', nullable: false })
+  @IsDate()
+  @Type(() => Date)
+  updateDate: string;
+  @Column({ nullable: false })
+  deleteUser: string;
+  @Column({ type: 'timestamp', nullable: false })
+  @IsDate()
+  @Type(() => Date)
+  deleteDate: string;
+}

package/src/interfaces/IGenericCrud.ts

@@ -0,0 +1,11 @@
+import { ApiResponse, Pagination } from '../api/response/ApiResponse';
+
+export interface IGenericCrud<T> {
+  pagination(): Promise<ApiResponse<Pagination<T>>>;
+
+  create(t: T): Promise<ApiResponse<T>>;
+
+  update(t: T): Promise<ApiResponse<T>>;
+
+  delete(id: string): Promise<ApiResponse<T>>;
+}

package/src/main.ts

@@ -0,0 +1,8 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(process.env.PORT ?? 3000);
+}
+bootstrap();

package/src/util/Validation.ts

@@ -0,0 +1,63 @@
+export class Validation<T> {
+  isNull(obj: T) {
+    return obj === null;
+  }
+
+  isUndefined(obj: T) {
+    return obj === undefined;
+  }
+
+  isEmpty(obj: T) {
+    return obj === '' || obj === null;
+  }
+
+  sString(obj: unknown): boolean {
+    return typeof obj === 'string';
+  }
+
+  isNumber(obj: unknown): boolean {
+    return typeof obj === 'number' && !isNaN(obj);
+  }
+
+  isBoolean(obj: unknown): boolean {
+    return typeof obj === 'boolean';
+  }
+
+  isPositiveNumber(obj: T) {
+    return this.isNumber(obj) && (obj as number) > 0;
+  }
+
+  isNegativeNumber(obj: T) {
+    return this.isNumber(obj) && (obj as number) < 0;
+  }
+
+  isDate(obj: unknown): boolean {
+    return obj instanceof Date && !isNaN(obj.getTime());
+  }
+
+  isFutureDate(obj: unknown): boolean {
+    return this.isDate(obj) && (obj as Date).getTime() > Date.now();
+  }
+
+  isPastDate(obj: unknown): boolean {
+    return this.isDate(obj) && (obj as Date).getTime() < Date.now();
+  }
+
+  isInArray(value: unknown, array: unknown[]): boolean {
+    return array.includes(value);
+  }
+
+  hasMinLength(obj: T, length: number): boolean {
+    if (typeof obj === 'string' || Array.isArray(obj)) {
+      return (obj as any).length >= length;
+    }
+    return false;
+  }
+
+  hasMaxLength(obj: T, length: number): boolean {
+    if (typeof obj === 'string' || Array.isArray(obj)) {
+      return (obj as any).length <= length;
+    }
+    return false;
+  }
+}

package/test/app.e2e-spec.ts

@@ -0,0 +1,25 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { INestApplication } from '@nestjs/common';
+import * as request from 'supertest';
+import { App } from 'supertest/types';
+import { AppModule } from './../src/app.module';
+
+describe('AppController (e2e)', () => {
+  let app: INestApplication<App>;
+
+  beforeEach(async () => {
+    const moduleFixture: TestingModule = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+
+    app = moduleFixture.createNestApplication();
+    await app.init();
+  });
+
+  it('/ (GET)', () => {
+    return request(app.getHttpServer())
+      .get('/')
+      .expect(200)
+      .expect('Hello World!');
+  });
+});

package/test/jest-e2e.json

@@ -0,0 +1,9 @@
+{
+  "moduleFileExtensions": ["js", "json", "ts"],
+  "rootDir": ".",
+  "testEnvironment": "node",
+  "testRegex": ".e2e-spec.ts$",
+  "transform": {
+    "^.+\\.(t|j)s$": "ts-jest"
+  }
+}

package/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2023",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "forceConsistentCasingInFileNames": true,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "noFallthroughCasesInSwitch": false
+  }
+}