exodus-framework 2.1.1031 → 2.1.1032

package/lib/services/redis.d.ts

@@ -1,5 +1,12 @@
 import Service from '../app/classes/service';
 import { RedisCache } from '../app/classes/cache';
+/**
+ * Serviço de cache
+ *
+ * @class RedisService
+ * @extends {Service}
+ * @implements {IService}
+ */
 declare class RedisService extends Service {
     private client;
     private isReconnecting;

package/lib/services/redis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/services/redis.ts"],"names":[],"mappings":"AAEA,OAAO,OAAO,MAAM,wBAAwB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAUlD,cAAM,YAAa,SAAQ,OAAO;IAChC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAS;IAEf,aAAa;IAOb,OAAO;IAMP,WAAW;YAMV,OAAO;IA2BrB,OAAO,CAAC,iBAAiB;IAQnB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGtC,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM;CAGlC;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/services/redis.ts"],"names":[],"mappings":"AAEA,OAAO,OAAO,MAAM,wBAAwB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD;;;;;;GAMG;AACH,cAAM,YAAa,SAAQ,OAAO;IAChC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAS;IAEf,aAAa;IAOb,OAAO;IAMP,WAAW;YAMV,OAAO;IA2BrB,OAAO,CAAC,iBAAiB;IAQnB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGtC,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM;CAGlC;AAED,eAAe,YAAY,CAAC"}

package/lib/services/redis.js

@@ -19,9 +19,8 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  */
 class RedisService extends _service.default {
   client;
-  isReconnecting = false; // Flag para evitar múltiplas tentativas simultâneas de reconexão
-  isConnected = false; // Flag para controlar o estado da conexão
-
+  isReconnecting = false;
+  isConnected = false;
   async onServiceInit() {
     await super.onServiceInit();
     this.startAttemptDelay = 5 * 1000;
@@ -65,8 +64,6 @@ class RedisService extends _service.default {
       this.isConnected = false;
     });
   }
-
-  //* Common
   async setValue(key, value) {
     await this.client.set(key, value);
   }

package/lib/services/security.d.ts

@@ -15,14 +15,66 @@ declare class SecurityService extends Service {
     }>;
     loadServicePublicKey(): Promise<void>;
     loadKeyByStr(data: string): Promise<JWK.Key>;
+    /**
+     * Chave privada emitida por este serviço
+     *
+     * @memberof SecurityService
+     */
     getPrivateKey(): JWK.Key;
+    /**
+     * Chave publica emitida por este serviço
+     *
+     * @memberof SecurityService
+     */
     getPublicKey(): JWK.Key;
+    /**
+     * Chave publica emitida pelo serviço do hub se sessões
+     *
+     * @memberof SecurityService
+     */
     getServicePublicKey(): JWK.Key;
+    /**
+     * Criptografía utilizando chave publica
+     *
+     * @param {TSignData} data
+     * @memberof SecurityService
+     */
     encrypt(data: TSignData, publicKey: JWK.Key): Promise<string | false>;
+    /**
+     * Descriptografia utilizando chave privada
+     *
+     * @param {string} encryptedData
+     * @memberof SecurityService
+     */
     decrypt<T = any>(encryptedData: string, privateKey: JWK.Key): Promise<T | false>;
+    /**
+     * Realiza uma assinatura usando chave privada
+     *
+     * @param {TSignData} data
+     * @memberof SecurityService
+     */
     sign(data: TSignData, privateKey: JWK.Key): Promise<string>;
+    /**
+     * Verifica assinatura utilizando chave publica
+     *
+     * @param {string} signature
+     * @memberof SecurityService
+     */
     verifySignature<T = any>(signature: string, publicKey: JWK.Key): Promise<(TSignData<T> & Record<string, any>) | false>;
+    /**
+     * Criptografía de dados utilizando um buffer automático ao invés de chaves
+     *
+     * @param {(string | object)} data
+     * @memberof SecurityService
+     */
     simpleEncrypt(data: string | object): [string, Buffer];
+    /**
+     * Utiliza um buffer para descriptografar dados criptografados através de simpleEncrypt()
+     *
+     * @param {string} data
+     * @param {Buffer} key
+     * @memberof SecurityService
+     */
     simpleDecrypt(data: string, key: Buffer): Buffer | false;
 }
 export default SecurityService;

package/lib/services/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/services/security.ts"],"names":[],"mappings":"AAEA,OAAO,EAAO,GAAG,EAAO,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAQ,OAAO,EAAgB,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,cAAM,eAAgB,SAAQ,OAAO;IACnC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,gBAAgB,CAAU;IAErB,OAAO;IAWpB,OAAO,CAAC,UAAU;YAMJ,cAAc;YAad,aAAa;IAMd,cAAc;;;;IASd,oBAAoB;IAUpB,YAAY,CAAC,IAAI,EAAE,MAAM;IAS/B,aAAa;IAQb,YAAY;IAQZ,mBAAmB;IASb,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG;IAyB3C,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC;IAkBhF,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG;IAyBzC,eAAe,CAAC,CAAC,GAAG,GAAG,EAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,CAAC,GAAG,GACjB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAiBjD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAoBtD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK;CAgBhE;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/services/security.ts"],"names":[],"mappings":"AAEA,OAAO,EAAO,GAAG,EAAO,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAQ,OAAO,EAAgB,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,cAAM,eAAgB,SAAQ,OAAO;IACnC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,gBAAgB,CAAU;IAErB,OAAO;IAWpB,OAAO,CAAC,UAAU;YAMJ,cAAc;YAad,aAAa;IAMd,cAAc;;;;IASd,oBAAoB;IAUpB,YAAY,CAAC,IAAI,EAAE,MAAM;IAItC;;;;OAIG;IACI,aAAa;IAGpB;;;;OAIG;IACI,YAAY;IAGnB;;;;OAIG;IACI,mBAAmB;IAG1B;;;;;OAKG;IACU,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG;IAmBxD;;;;;OAKG;IACU,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC;IAY7F;;;;;OAKG;IACU,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG;IAmBtD;;;;;OAKG;IACU,eAAe,CAAC,CAAC,GAAG,GAAG,EAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,CAAC,GAAG,GACjB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAWxD;;;;;OAKG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAa7D;;;;;;OAMG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK;CAgBhE;AAED,eAAe,eAAe,CAAC"}

package/lib/services/security.js

@@ -28,8 +28,6 @@ class SecurityService extends _app.Service {
       recursive: true
     });
   }
-
-  /* Key Pair */
   async loadPrivateKey() {
     const privateKeyPath = _path.default.join(_app.Core.settings.getAuthentication().certPath, 'private_key.pem');
     if (fs.existsSync(privateKeyPath)) {
@@ -135,7 +133,6 @@ class SecurityService extends _app.Service {
       const decrypted = await _nodeJose.JWE.createDecrypt(privateKey).decrypt(encryptedData);
       const result = decrypted.plaintext.toString();
       const parserd = JSON.parse(result);
-      // Tenta parsear como JSON se for objeto
       return parserd.payload;
     } catch (error) {
       new _app.ErrorHandler('Não foi possível descriptografar os dados', error);

package/lib/services/sequelize.d.ts

@@ -3,6 +3,14 @@ import { ServiceModel } from '../app';
 import Service from '../app/classes/service';
 import { EnvDBHost } from '../models';
 import { StaticServiceModel } from '../contracts';
+/**
+ * Serviço de gerênciamento do banco de dados
+ *
+ * @class SequelizeService
+ * @extends {Service}
+ * @deprecated Use {@link DatabaseService}
+ * @implements {IService}
+ */
 declare class SequelizeService extends Service {
     serviceDB: Sequelize;
     models: StaticServiceModel<any>[];

package/lib/services/sequelize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sequelize.d.ts","sourceRoot":"","sources":["../../src/services/sequelize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAsB,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,OAAO,MAAM,wBAAwB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAgB,MAAM,WAAW,CAAC;AAIpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAalD,cAAM,gBAAiB,SAAQ,OAAO;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,kBAAkB,CAAS;IAGtB,aAAa;IAiBb,OAAO;IAaP,WAAW;IAMX,gBAAgB;IAyBhB,KAAK,CAAC,QAAQ,EAAE,MAAM;IAa7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IA8BhC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAsBpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAiBvC,MAAM,CAAC,QAAQ,EAAE,MAAM;IA2BvB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS;IAkBpE,SAAS,CAAC,QAAQ,EAAE,MAAM;IAK1B,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,SAAI;IAkB/B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IA2CpD,cAAc,CAAC,IAAI,EAAE;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;KAClB;IA4BY,WAAW,CAAC,QAAQ,EAAE,MAAM;IAe5B,QAAQ,CAAC,CAAC,SAAS,YAAY,CAAC,KAAK,CAAC,EACjD,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;WAWZ,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE;IAGjD,UAAU;CAOxB;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"sequelize.d.ts","sourceRoot":"","sources":["../../src/services/sequelize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAsB,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,OAAO,MAAM,wBAAwB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAgB,MAAM,WAAW,CAAC;AAIpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAKlD;;;;;;;GAOG;AACH,cAAM,gBAAiB,SAAQ,OAAO;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,kBAAkB,CAAS;IAGtB,aAAa;IAiBb,OAAO;IAaP,WAAW;IAMX,gBAAgB;IAyBhB,KAAK,CAAC,QAAQ,EAAE,MAAM;IAa7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IA8BhC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAsBpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAiBvC,MAAM,CAAC,QAAQ,EAAE,MAAM;IA2BvB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS;IAkBpE,SAAS,CAAC,QAAQ,EAAE,MAAM;IAK1B,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,SAAI;IAkB/B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IA2CpD,cAAc,CAAC,IAAI,EAAE;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;KAClB;IA4BY,WAAW,CAAC,QAAQ,EAAE,MAAM;IAe5B,QAAQ,CAAC,CAAC,SAAS,YAAY,CAAC,KAAK,CAAC,EACjD,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;WAWZ,cAAc,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE;IAGjD,UAAU;CAOxB;AAED,eAAe,gBAAgB,CAAC"}

package/lib/services/sequelize.js

@@ -30,11 +30,9 @@ class SequelizeService extends _service.default {
   initializedModels;
   initializingdModels;
   relations;
-  isReconnecting = false; // Flag para evitar múltiplas tentativas simultâneas de reconexão
-  isMasterConnected = false; // Flag para controlar o estado da conexão
-  isServiceConnected = false; // Flag para controlar o estado da conexão
-
-  //# Initialization
+  isReconnecting = false;
+  isMasterConnected = false;
+  isServiceConnected = false;
   async onServiceInit() {
     await super.onServiceInit();
     if (!this.models) throw new Error('Models are requireds! Call registerModels(modelsArray)');
@@ -81,10 +79,7 @@ class SequelizeService extends _service.default {
       return false;
     }
   }
-
-  // #Database
   async getDB(tenantId) {
-    /* master or service */
     if (tenantId == _app.Core.settings.getDatabase().main.database) {
       return _database.mainDb;
     }
@@ -105,7 +100,6 @@ class SequelizeService extends _service.default {
       try {
         const [results] = await connection.query(`SHOW DATABASES LIKE '${dbQueryName}';`);
         if (results.length === 0) {
-          // Se o banco de dados não existir, cria-o
           await connection.query(`CREATE DATABASE ${dbQueryName};`);
           this.log(`Database "${dbQueryName}" has been created.`);
           return true;
@@ -194,8 +188,6 @@ class SequelizeService extends _service.default {
   getDBName(envToken) {
     return `${_app.Core.settings.getDatabase().main.database}_${envToken}`;
   }
-
-  //#Connection
   reconnect(db, attempts = 2) {
     db.sync().then(() => {
       this.log('Database pronto', 'success');
@@ -266,11 +258,8 @@ class SequelizeService extends _service.default {
       });
     });
   }
-
-  //# Common
   async getRelation(tenantId) {
     let relation;
-    /* fetch relation */
     if (this.relations.get(tenantId)) {
       relation = this.relations.get(tenantId);
     } else {
@@ -285,8 +274,6 @@ class SequelizeService extends _service.default {
     }
     return relation;
   }
-
-  // #Entity
   async getModel(model, tenantId) {
     try {
       const modelKey = `${tenantId}#${model.name}`;

package/lib/services/socket.d.ts

@@ -4,6 +4,13 @@ import { Server } from 'socket.io';
 import Service from '../app/classes/service';
 import SocketEventHandler from '../app/classes/socket/eventhandler';
 import SocketClientHandler from '../app/classes/socket/clienthandler';
+/**
+ * Serviço de gerênciamento de comunicação WS/WSS Socket
+ *
+ * @class SocketIOService
+ * @extends {Service}
+ * @implements {IService}
+ */
 declare class SocketIOService extends Service {
     server: Server;
     private mainRouter;

package/lib/services/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/services/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,OAAO,MAAM,wBAAwB,CAAC;AAC7C,OAAO,kBAAkB,MAAM,oCAAoC,CAAC;AAMpE,OAAO,mBAAmB,MAAM,qCAAqC,CAAC;AAUtE,cAAM,eAAgB,SAAQ,OAAO;IAC5B,MAAM,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,cAAc,CAAsC;IAE/C,oBAAoB;IAOpB,sBAAsB;YAcrB,YAAY;IA4C1B,OAAO,CAAC,UAAU;IAgCX,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,GAAE,WAAW,GAAG,mBAAqC;IAM9F,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE;IAIlD,MAAM,CAAC,sBAAsB,CAAC,QAAQ,EAAE,CAAC,OAAO,mBAAmB,CAAC,EAAE;YAIxD,gBAAgB;CAY/B;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/services/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,OAAO,MAAM,wBAAwB,CAAC;AAC7C,OAAO,kBAAkB,MAAM,oCAAoC,CAAC;AAMpE,OAAO,mBAAmB,MAAM,qCAAqC,CAAC;AAGtE;;;;;;GAMG;AACH,cAAM,eAAgB,SAAQ,OAAO;IAC5B,MAAM,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,cAAc,CAAsC;IAE/C,oBAAoB;IAOpB,sBAAsB;YAcrB,YAAY;IA4C1B,OAAO,CAAC,UAAU;IAgCX,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,GAAE,WAAW,GAAG,mBAAqC;IAM9F,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE;IAIlD,MAAM,CAAC,sBAAsB,CAAC,QAAQ,EAAE,CAAC,OAAO,mBAAmB,CAAC,EAAE;YAIxD,gBAAgB;CAY/B;AAED,eAAe,eAAe,CAAC"}

package/lib/services/socket.js

@@ -26,14 +26,11 @@ class SocketIOService extends _service.default {
   clientHandlers = [];
   async onServiceClusterInit() {
     await super.onServiceClusterInit();
-    if (!this.mainRouter) throw new Error('Need router'); //!sem router
-
+    if (!this.mainRouter) throw new Error('Need router');
     this.eventhandlers = new Map();
   }
   async onExodusClusterStarted() {
     await super.onExodusClusterStarted();
-    //! este depende de ExpressService para iniciar, por isso está aqui
-
     try {
       this.createSocket(_express.default.getService().getHttpServer());
       await this.registerHandlers();

package/lib/services/task/queue/QueueService.js

@@ -9,7 +9,6 @@ var _app = require("../../../app");
 var _core = require("../../../contracts/core");
 var _TaskServiceBase = _interopRequireDefault(require("../TaskServiceBase"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-//* Queue
 class QueueTaskService extends _TaskServiceBase.default {
   connection;
   async onStart() {

package/lib/services/task/queue/QueueTask.js

@@ -17,8 +17,6 @@ class QueueTask extends _app.Singleton {
   name;
   active;
   concurrency;
-
-  //# Init
   async taskInit() {
     this.rECom = new _communication.default(this.constructor.name);
     this.rECom.on(_service.eEventCommunication.RECEIVED_CLUSTER_MESSAGE, this.onTaskMasterReceived.bind(this));
@@ -35,8 +33,6 @@ class QueueTask extends _app.Singleton {
       this.onTaskClusterInit();
     }
   }
-
-  //# Getters
   getQueue() {
     return this.queue;
   }
@@ -55,16 +51,12 @@ class QueueTask extends _app.Singleton {
   getConcurrency() {
     return this.concurrency;
   }
-
-  //# Setters
   setQueue(queue) {
     this.queue = queue;
   }
   setWorker(worker) {
     this.worker = worker;
   }
-
-  //# Basic Handlers
   execute(job, token) {
     this.onExecute(job, token);
     if (this.isCluster()) {
@@ -85,13 +77,10 @@ class QueueTask extends _app.Singleton {
     }
     await this.queue.add(this.getName(), data);
     this.onNewJob(data);
-    // this.log('Nova tarefa disponível.', 'comment');
   }
   static async addJob(data) {
     this.singleton().addJob(data);
   }
-
-  //# Events
   onTaskInit() {
     return;
   }
@@ -101,14 +90,12 @@ class QueueTask extends _app.Singleton {
   onTaskMasterInit() {
     return;
   }
-  //----------------------------------------------------------------------------
   onTaskMasterReceived(_worker, _eventKey, _data) {
     return;
   }
   onTaskClusterReceived(_eventKey, _data) {
     return;
   }
-  //----------------------------------------------------------------------------
   onClusterExecute(_job, _token) {
     return;
   }
@@ -118,12 +105,9 @@ class QueueTask extends _app.Singleton {
   onExecute(_job, _token) {
     return;
   }
-  //----------------------------------------------------------------------------
   onNewJob(_data) {
     return;
   }
-
-  //# Managed
   sendTaskToCluster(clusterId, event, data) {
     this.rECom.sendMessageToCluster(clusterId, event, data);
   }

package/lib/services/task/scheduler/SchedulerTask.d.ts

@@ -17,7 +17,23 @@ declare abstract class ScheduleTask extends Singleton {
     protected name: string;
     protected side: eExecutionSide;
     protected job: Job;
+    /**
+     * Deve ser executada imediatamente e depois agendada?
+     *
+     * @protected
+     * @type {boolean}
+     * @memberof ScheduleTask
+     */
     protected immediate: boolean;
+    /**
+     * Esta task deve ficar ativa ou parada após a execução?
+     * Tenha em mente que se/também immediate = true, esta task será executada apenas na
+     * inicialização do Exodus
+     *
+     * @protected
+     * @type {boolean}
+     * @memberof ScheduleTask
+     */
     protected persistent: boolean;
     execute(): Promise<void>;
     taskInit(): Promise<void>;

package/lib/services/task/scheduler/SchedulerTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchedulerTask.d.ts","sourceRoot":"","sources":["../../../../src/services/task/scheduler/SchedulerTask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;CACf,CAAC;AAEF,uBAAe,YAAa,SAAQ,SAAS;IAC3C,OAAO,CAAC,KAAK,CAA6B;IAC1C,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAC1D,SAAS,CAAC,uBAAuB,EAAE,MAAM,CAAK;IAC9C,SAAS,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa;IAC/D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAAC;IAC/C,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAQnB,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC;IAU7B,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC;IAEjB,OAAO;IAaP,QAAQ;IAsBrB,SAAS,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAGvE,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAK5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAGlC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAGzC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIxC,WAAW,IAAI,qBAAqB,GAAG,MAAM;IAG7C,SAAS,IAAI,OAAO;IAGpB,OAAO,IAAI,MAAM;IAGjB,OAAO,IAAI,cAAc;IAGzB,WAAW,IAAI,OAAO;IAGtB,MAAM,CAAC,GAAG,EAAE,GAAG;IAKf,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAGjC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAGxC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIvC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG;IAShD,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG;IAG5D,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAWzD,SAAS,CAAC,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAGjE,SAAS,CAAC,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa;IAK3E,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAkBxE,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAc1E,SAAS,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa;IAG3F,SAAS,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa;IAG3F,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG;IAU7D,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMxD,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM;IAQ/C,SAAS,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM;CAGlD;AACD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SchedulerTask.d.ts","sourceRoot":"","sources":["../../../../src/services/task/scheduler/SchedulerTask.ts"],"names":[],"mappings":"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"}

package/lib/services/task/scheduler/SchedulerTask.js

@@ -73,8 +73,6 @@ class ScheduleTask extends _app.Singleton {
   sendToTaskMaster(event, data) {
     this.rECom.sendToServiceMaster(event, data);
   }
-
-  //# Muted methods
   onTaskInit() {
     return;
   }
@@ -119,8 +117,6 @@ class ScheduleTask extends _app.Singleton {
       this.sendTaskWorkToCluster(workId, workData);
     }
   }
-
-  //# Cluster
   sendTaskWorkToMaster(workId, workData) {
     this.sendToTaskMaster('work.add', {
       workId,
@@ -143,8 +139,6 @@ class ScheduleTask extends _app.Singleton {
   onTaskClusterReceivedWork(_eventKey, _data) {
     return;
   }
-
-  //# Master
   taskMasterReceived(worker, eventKey, data) {
     switch (eventKey) {
       case 'work.add':
@@ -192,14 +186,11 @@ class ScheduleTask extends _app.Singleton {
   }
   onClusterDown(_, worker) {
     if (this.registeredClusters.has(worker.id)) {
-      // console.log('removendo cluster da lista de registrados');
       this.registeredClusters.delete(worker.id);
     }
   }
   taskClusterRegistered(_worker) {
     if (!this.registeredClusters.has(_worker.id)) {
-      // console.log('registrando novo cluster', _worker.id);
-
       this.registeredClusters.set(_worker.id, true);
     }
     this.onTaskClusterRegistered(_worker);

package/lib/services/test.js

@@ -6,8 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _service = _interopRequireDefault(require("../app/classes/service"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// import 'express-async-errors';
-
 class TestService extends _service.default {
   async onServiceClusterInit() {
     console.log('iniciado no cluster');

package/lib/tasks/queue/teste.js

@@ -1,21 +1 @@
-/* import { Job } from 'bullmq';
-import { QueueTask } from '../../services';
-import { eExecutionSide } from '../../contracts/core';
-
-class TestTaskQueue extends QueueTask<string> {
-  getName(): string {
-    return 'Teste Job Queue';
-  }
-
-  async onTaskInit(): Promise<void> {
-    this.side = eExecutionSide.ANY;
-  }
-
-  async onExecute(_job: Job<string, any, string>, _token?: string): Promise<any> {
-    this.log('this job queue handled');
-  }
-}
-
-export default TestTaskQueue;
- */
 "use strict";

package/lib/tasks/schedule/teste.js

@@ -15,22 +15,10 @@ class TestTaskSchedule extends _services.ScheduleTask {
   getCronTask() {
     return _contansts.eScheduleTaskInterval.DEFAULT;
   }
-  /* async onClusterExecute() {
-    this.log('this job handled');
-    process.exit(0);
-  } */
   async onMasterExecute() {
-    // console.log('sending...');
-    // this.sendTaskWorkToCluster('idworkd12344', 'testeeeeee');
     this.log('this job handled');
     process.exit(0);
   }
-  /* async onTaskClusterInit() {
-    setTimeout(() => {
-      exit();
-    }, 5000);
-  } */
-
   addTaskWork(workId, workData) {
     if (this.isCluster()) {
       this.sendTaskWorkToMaster(workId, workData);
@@ -38,16 +26,12 @@ class TestTaskSchedule extends _services.ScheduleTask {
       this.sendTaskWorkToCluster(workId, workData);
     }
   }
-
-  //# Cluster
   onTaskClusterReceived(eventKey, data) {
     return;
   }
   onTaskClusterReceivedWork(eventKey, data) {
     console.log('novo trabalho recebido neste cluster', data);
   }
-
-  //# Master
   onTaskMasterReceived(worker, eventKey, data) {
     return;
   }

package/lib/utils/api.d.ts

@@ -1,15 +1,172 @@
 import { AxiosHeaders, AxiosInstance, Method } from 'axios';
 import { IApiResponse } from '../contracts/http';
+/**
+ * Classe abstrata base para criação de clientes HTTP usando Axios.
+ *
+ * Esta classe fornece uma estrutura comum para realizar requisições HTTP
+ * com tratamento de erros padronizado, validação de status customizável
+ * e diferentes tipos de requisições (interna, externa, direta).
+ *
+ * @example
+ * ```typescript
+ * class MyApiClient extends Api {
+ *   host = 'https://api.example.com';
+ *   headers = { 'Authorization': 'Bearer token' };
+ *
+ *   validateStatus(status: number): boolean {
+ *     return status >= 200 && status < 300;
+ *   }
+ * }
+ *
+ * const client = new MyApiClient();
+ * const response = await client.request('/users', 'GET');
+ * ```
+ *
+ * @abstract
+ * @class Api
+ * @version 1.0.0
+ * @author Exodus Framework
+ */
 declare abstract class Api {
+    /** Instância do Axios configurada */
     axios: AxiosInstance;
+    /** URL base para as requisições (deve ser implementado nas classes filhas) */
     abstract host: string;
+    /** Headers padrão para as requisições (deve ser implementado nas classes filhas) */
     abstract headers: Record<string, any>;
+    /**
+     * Construtor da classe Api.
+     * Inicializa automaticamente a instância do Axios.
+     */
     constructor();
+    /**
+     * Inicializa a instância do Axios com configurações padrão.
+     *
+     * @protected
+     * @async
+     * @returns Promise<void>
+     *
+     * @example
+     * ```typescript
+     * // Chamado automaticamente no constructor
+     * await this.init();
+     * ```
+     */
     init(): Promise<void>;
+    /**
+     * Método abstrato para validação de status HTTP.
+     * Deve ser implementado nas classes filhas para definir quais status são considerados válidos.
+     *
+     * @abstract
+     * @param status - Código de status HTTP da resposta
+     * @returns true se o status é válido, false caso contrário
+     *
+     * @example
+     * ```typescript
+     * validateStatus(status: number): boolean {
+     *   return status >= 200 && status < 400; // Aceita 2xx e 3xx
+     * }
+     * ```
+     */
     abstract validateStatus(status: number): boolean;
+    /**
+     * Realiza uma requisição HTTP e retorna apenas os dados da resposta.
+     *
+     * @template T - Tipo dos dados esperados na resposta
+     * @param endpoint - Endpoint da API (será concatenado com host)
+     * @param method - Método HTTP (GET, POST, PUT, DELETE, etc.)
+     * @param data - Dados para envio no corpo da requisição (opcional)
+     * @param params - Parâmetros de query string (opcional)
+     * @param headers - Headers adicionais para a requisição (opcional)
+     * @returns Promise com os dados da resposta ou undefined em caso de erro
+     *
+     * @example
+     * ```typescript
+     * // GET request
+     * const users = await this.request<User[]>('/users', 'GET');
+     *
+     * // POST request com dados
+     * const newUser = await this.request<User>('/users', 'POST', {
+     *   name: 'João',
+     *   email: 'joao@example.com'
+     * });
+     *
+     * // GET com parâmetros
+     * const user = await this.request<User>('/users', 'GET', null, { id: 123 });
+     * ```
+     */
     request<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<IApiResponse<T> | import("axios").AxiosResponse<T, any, {}>>;
+    /**
+     * Realiza uma requisição HTTP e retorna a resposta completa do Axios.
+     *
+     * Este método é útil quando você precisa acessar headers, status code,
+     * ou outras propriedades da resposta além dos dados.
+     *
+     * @template T - Tipo dos dados esperados na resposta
+     * @param endpoint - Endpoint da API (será concatenado com host)
+     * @param method - Método HTTP (GET, POST, PUT, DELETE, etc.)
+     * @param data - Dados para envio no corpo da requisição (opcional)
+     * @param params - Parâmetros de query string (opcional)
+     * @param headers - Headers adicionais para a requisição (opcional)
+     * @returns Promise com a resposta completa do Axios ou undefined em caso de erro
+     *
+     * @example
+     * ```typescript
+     * const response = await this.requestDirect<User>('/users/1', 'GET');
+     * console.log(response.status); // 200
+     * console.log(response.headers); // Headers da resposta
+     * console.log(response.data); // Dados do usuário
+     * ```
+     */
     requestDirect<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<import("axios").AxiosResponse<IApiResponse<T>, any, {}> | import("axios").AxiosResponse<T, any, {}>>;
+    /**
+     * Realiza uma requisição HTTP para APIs externas.
+     *
+     * Este método é otimizado para chamadas a APIs de terceiros,
+     * não utilizando a interface IApiResponse padrão do framework.
+     *
+     * @template T - Tipo dos dados esperados na resposta
+     * @param endpoint - Endpoint da API (será concatenado com host)
+     * @param method - Método HTTP (GET, POST, PUT, DELETE, etc.)
+     * @param data - Dados para envio no corpo da requisição (opcional)
+     * @param params - Parâmetros de query string (opcional)
+     * @param headers - Headers adicionais para a requisição (opcional)
+     * @returns Promise com a resposta da API externa ou undefined em caso de erro
+     *
+     * @example
+     * ```typescript
+     * // Chamada para API externa (ex: GitHub)
+     * const githubUser = await this.requestExternal<GitHubUser>(
+     *   '/users/octocat',
+     *   'GET'
+     * );
+     *
+     * // API externa com autenticação
+     * const data = await this.requestExternal<ExternalData>(
+     *   '/api/data',
+     *   'GET',
+     *   null,
+     *   null,
+     *   { 'X-API-Key': 'external-api-key' }
+     * );
+     * ```
+     */
     requestExternal<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<import("axios").AxiosResponse<T, any, {}>>;
+    /**
+     * Gera um ID de segurança lógica baseado na data atual.
+     *
+     * Este método cria um identificador único baseado na data atual,
+     * útil para implementações de segurança ou cache temporal.
+     *
+     * @protected
+     * @returns String contendo o ID de segurança lógica
+     *
+     * @example
+     * ```typescript
+     * const securityId = this.getLogicalSecurityId();
+     * console.log(securityId); // "1695513600000" (exemplo)
+     * ```
+     */
     protected getLogicalSecurityId(): string;
 }
 export default Api;