@jrosadob/ms-sophia-framework-mysql 0.0.1

package/README.md

@@ -0,0 +1,101 @@
+# Sophia Framework
+
+## v47
+Define propiedes dinamicas para el datasource:
+entities, subscribers, synchronize, logging, logger: typeOrmLogger
+
+
+
+## Publish
++ Actualizar version in package.json
++ Run `./publish.sh`
+
+## CLI
+
+```bash
+$ pnpm install
+$ pnpm add @nestjs/config   # Install package
+$ pnpm run start            # Development
+$ pnpm run start:dev        # Wath mode
+$ pnpm run start:prod       # Production mode
+
+$ pnpm run test             # Unit tests
+$ pnpm run test:e2e         # e2e tests
+$ pnpm run test:cov         # Coverage test
+```
+
+## Packages
+
+```bash
+pnpm add @nestjs/config
+pnpm add @nestjs/swagger
+pnpm add @nestjs/typeorm
+pnpm add axios
+pnpm add class-transformer
+pnpm add class-validator
+pnpm add js
+pnpm add js-yaml
+pnpm add mysql2
+pnpm add nanoid
+pnpm add typeorm
+pnpm add @nestjs/microservices
+```
+
+## PreHook
+
+```bash
+app.useGlobalInterceptors(new LoggingInterceptor(configService));
+app.useGlobalFilters(new AllExceptionsFilter());
+```
+
+## Idempotencia de Controladores TCP
+Asegurarse de que sea idempotente
+Si es para traer datos no hay problema
+Pero si es para guardar datos, debe usarse una transaccion con una tabla que tiene PK ms-accounts, module-name y method-name.
+Si todo sale bien enviar el ACK.
+Si se detacto duplicado no ejecutar el metodo de negocio, pero enviar el ACK para que RabbitMQ no siga enviando mensajes.
+```TS
+@MessagePattern({ cmd: 'charge' })
+async handleCharge(@Payload() data: any, @Ctx() ctx: RmqContext) {
+  const channel = ctx.getChannelRef();
+  const msg = ctx.getMessage();
+
+  const key =
+    msg.properties?.headers?.['x-idempotency-key'] ||
+    msg.properties?.messageId;
+
+  if (!key) {
+    // Sin clave no hay deduplicación confiable
+    // Decide: rechazar o procesar con riesgo
+    channel.nack(msg, false, false);
+    return;
+  }
+
+  try {
+    await this.dataSource.transaction(async (manager) => {
+      // 1) Intentar registrar el mensaje
+      // Si falla por unique, es duplicado
+      await manager.query(
+        `INSERT INTO processed_messages (consumer_name, message_key)
+         VALUES (?, ?)`,
+        ['payments-consumer', key],
+      );
+
+      // 2) Lógica de negocio real (solo primera vez)
+      await this.paymentService.charge(data, manager);
+    });
+
+    // 3) Confirmar
+    channel.ack(msg);
+  } catch (e: any) {
+    // Duplicado por unique constraint: confirmar y salir
+    if (isDuplicateKeyError(e)) {
+      channel.ack(msg);
+      return;
+    }
+
+    // Error real: reintentar o enviar a DLQ según estrategia
+    channel.nack(msg, false, true);
+  }
+}
+```

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@jrosadob/ms-sophia-framework-mysql",
+  "version": "0.0.1",
+  "description": "Sophia Framework para microservicios en NestJS",
+  "main": "dist/core/index.js",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.1"
+  },
+  "keywords": [
+    "nest",
+    "nestjs",
+    "sophia",
+    "framework",
+    "microservices"
+  ],
+  "author": {
+    "name": "Javier A. Rosado Baltazar",
+    "email": "jrosadob@hotmail.com"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/config": "^4.0.2",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/microservices": "^11.1.27",
+    "@nestjs/platform-express": "^11.0.1",
+    "@nestjs/swagger": "^11.2.0",
+    "@nestjs/typeorm": "^11.0.0",
+    "amqp-connection-manager": "^5.0.0",
+    "amqplib": "^2.0.1",
+    "axios": "^1.12.2",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "dotenv": "^17.2.3",
+    "js": "^0.1.0",
+    "js-yaml": "^4.1.0",
+    "mysql2": "^3.14.5",
+    "nanoid": "^5.1.5",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "typeorm": "^0.3.26"
+  },
+  "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",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^30.0.0",
+    "@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": "^30.0.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"
+  },
+  "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"
+  }
+}