@devstroupe/devkit-nest 1.0.1 → 1.1.0

package/dist/audit/audit.context.d.ts

@@ -0,0 +1,9 @@
+import { AsyncLocalStorage } from 'async_hooks';
+export interface AuditRequestContext {
+    userId?: string | number;
+    ip?: string;
+    userAgent?: string;
+    correlationId?: string;
+    timestamp: Date;
+}
+export declare const auditLocalStorage: AsyncLocalStorage<AuditRequestContext>;

package/dist/audit/audit.context.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditLocalStorage = void 0;
+const async_hooks_1 = require("async_hooks");
+exports.auditLocalStorage = new async_hooks_1.AsyncLocalStorage();

package/dist/audit/audit.interceptor.d.ts

@@ -0,0 +1,5 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Observable } from 'rxjs';
+export declare class AuditInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}

package/dist/audit/audit.interceptor.js

@@ -0,0 +1,81 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+const audit_context_1 = require("./audit.context");
+const crypto = __importStar(require("crypto"));
+let AuditInterceptor = class AuditInterceptor {
+    intercept(context, next) {
+        const http = context.switchToHttp();
+        const req = http.getRequest();
+        if (!req) {
+            return next.handle();
+        }
+        const correlationId = req.headers['x-correlation-id'] || crypto.randomUUID();
+        const ip = req.ip || req.headers['x-forwarded-for'] || req.socket.remoteAddress;
+        const userAgent = req.headers['user-agent'];
+        // O usuário é extraído do JWT que o AuthGuard decodificou e salvou no request.user
+        const userId = req.user?.sub || req.user?.id || undefined;
+        const auditContext = {
+            userId,
+            ip,
+            userAgent,
+            correlationId,
+            timestamp: new Date(),
+        };
+        // Executa a requisição dentro do escopo do AsyncLocalStorage
+        return new rxjs_1.Observable((subscriber) => {
+            audit_context_1.auditLocalStorage.run(auditContext, () => {
+                next.handle().subscribe({
+                    next: (val) => subscriber.next(val),
+                    error: (err) => subscriber.error(err),
+                    complete: () => subscriber.complete(),
+                });
+            });
+        });
+    }
+};
+exports.AuditInterceptor = AuditInterceptor;
+exports.AuditInterceptor = AuditInterceptor = __decorate([
+    (0, common_1.Injectable)()
+], AuditInterceptor);

package/dist/audit/audit.module.d.ts

@@ -0,0 +1,2 @@
+export declare class AuditModule {
+}

package/dist/audit/audit.module.js

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const audit_interceptor_1 = require("./audit.interceptor");
+const audit_subscriber_1 = require("./audit.subscriber");
+let AuditModule = class AuditModule {
+};
+exports.AuditModule = AuditModule;
+exports.AuditModule = AuditModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [
+            audit_subscriber_1.AuditSubscriber,
+            {
+                provide: core_1.APP_INTERCEPTOR,
+                useClass: audit_interceptor_1.AuditInterceptor,
+            },
+        ],
+        exports: [],
+    })
+], AuditModule);

package/dist/audit/audit.subscriber.d.ts

@@ -0,0 +1,14 @@
+import { EntitySubscriberInterface, InsertEvent, UpdateEvent, RemoveEvent, DataSource } from 'typeorm';
+export declare class AuditSubscriber implements EntitySubscriberInterface {
+    private readonly logger;
+    constructor(dataSource: DataSource);
+    private redact;
+    private getDiff;
+    private getEntityId;
+    beforeInsert(event: InsertEvent<any>): void;
+    beforeUpdate(event: UpdateEvent<any>): void;
+    afterInsert(event: InsertEvent<any>): void;
+    afterUpdate(event: UpdateEvent<any>): void;
+    afterRemove(event: RemoveEvent<any>): void;
+    private processEvent;
+}

package/dist/audit/audit.subscriber.js

@@ -0,0 +1,129 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditSubscriber = void 0;
+const typeorm_1 = require("typeorm");
+const audit_context_1 = require("./audit.context");
+const common_1 = require("@nestjs/common");
+const DEFAULT_REDACT_FIELDS = [
+    'password',
+    'token',
+    'secret',
+    'secretaccesskey',
+    'accesskey',
+    'passwordhash',
+    'current_refresh_token',
+    'currentrefreshtoken',
+    'creditcard',
+    'cvv',
+];
+let AuditSubscriber = class AuditSubscriber {
+    logger = new common_1.Logger('AuditSystem');
+    constructor(dataSource) {
+        dataSource.subscribers.push(this);
+    }
+    redact(data) {
+        if (!data || typeof data !== 'object')
+            return data;
+        const copy = Array.isArray(data) ? [...data] : { ...data };
+        for (const key of Object.keys(copy)) {
+            const lowerKey = key.toLowerCase();
+            if (DEFAULT_REDACT_FIELDS.includes(lowerKey)) {
+                copy[key] = '******';
+            }
+            else if (typeof copy[key] === 'object' && copy[key] !== null) {
+                copy[key] = this.redact(copy[key]);
+            }
+        }
+        return copy;
+    }
+    getDiff(before, after) {
+        const oldValues = {};
+        const newValues = {};
+        if (!before || !after) {
+            return { oldValues: before, newValues: after };
+        }
+        for (const key of Object.keys(after)) {
+            if (key === 'updatedAt' || key === 'createdAt')
+                continue;
+            const valBefore = before[key];
+            const valAfter = after[key];
+            // Comparação simples para detectar mudanças
+            if (JSON.stringify(valBefore) !== JSON.stringify(valAfter)) {
+                oldValues[key] = valBefore;
+                newValues[key] = valAfter;
+            }
+        }
+        return { oldValues, newValues };
+    }
+    getEntityId(event) {
+        return event.entityId || event.entity?.id || event.databaseEntity?.id;
+    }
+    beforeInsert(event) {
+        const store = audit_context_1.auditLocalStorage.getStore();
+        if (store && store.userId && event.entity) {
+            if ('createdByUserId' in event.entity) {
+                event.entity.createdByUserId = store.userId;
+            }
+            if ('updatedByUserId' in event.entity) {
+                event.entity.updatedByUserId = store.userId;
+            }
+        }
+    }
+    beforeUpdate(event) {
+        const store = audit_context_1.auditLocalStorage.getStore();
+        if (store && store.userId && event.entity) {
+            if ('updatedByUserId' in event.entity) {
+                event.entity.updatedByUserId = store.userId;
+            }
+        }
+    }
+    afterInsert(event) {
+        this.processEvent('CREATE', event.metadata.tableName, this.getEntityId(event), null, event.entity);
+    }
+    afterUpdate(event) {
+        if (!event.databaseEntity || !event.entity)
+            return;
+        const { oldValues, newValues } = this.getDiff(event.databaseEntity, event.entity);
+        // Só registra se de fato mudou algo além de updatedAt/createdAt
+        if (Object.keys(newValues).length > 0) {
+            this.processEvent('UPDATE', event.metadata.tableName, this.getEntityId(event), oldValues, newValues);
+        }
+    }
+    afterRemove(event) {
+        this.processEvent('DELETE', event.metadata.tableName, this.getEntityId(event), event.databaseEntity, null);
+    }
+    processEvent(action, entity, id, before, after) {
+        const store = audit_context_1.auditLocalStorage.getStore();
+        if (!store)
+            return; // Se a alteração ocorreu fora de uma requisição HTTP (ex: seeds, scripts), não auditamos por este canal
+        const logPayload = {
+            action,
+            entity,
+            entityId: id,
+            before: this.redact(before),
+            after: this.redact(after),
+            userId: store.userId,
+            ip: store.ip,
+            userAgent: store.userAgent,
+            correlationId: store.correlationId,
+            timestamp: store.timestamp,
+        };
+        // Imprimir o log de auditoria no formato JSON estruturado no console
+        this.logger.log(`[AUDIT] ${JSON.stringify(logPayload)}`);
+    }
+};
+exports.AuditSubscriber = AuditSubscriber;
+exports.AuditSubscriber = AuditSubscriber = __decorate([
+    (0, typeorm_1.EventSubscriber)(),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [typeorm_1.DataSource])
+], AuditSubscriber);

package/dist/audit/index.d.ts

@@ -0,0 +1,4 @@
+export * from './audit.module';
+export * from './audit.interceptor';
+export * from './audit.subscriber';
+export * from './audit.context';

package/dist/audit/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./audit.module"), exports);
+__exportStar(require("./audit.interceptor"), exports);
+__exportStar(require("./audit.subscriber"), exports);
+__exportStar(require("./audit.context"), exports);

package/dist/http/base-crud.controller.d.ts

@@ -1,6 +1,8 @@
+import { RealtimeService } from '../realtime/realtime.service';
 export declare abstract class BaseCrudController<Entity, FilterDto = any> {
     protected readonly service: any;
     constructor(service: any);
+    protected readonly realtimeService?: RealtimeService;
     create(body: any): Promise<Entity>;
     update(id: string, body: any): Promise<Entity>;
     findMany(filter: FilterDto): Promise<any>;

package/dist/http/base-crud.controller.js

@@ -15,16 +15,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseCrudController = void 0;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
+const realtime_service_1 = require("../realtime/realtime.service");
 class BaseCrudController {
     service;
     constructor(service) {
         this.service = service;
     }
+    realtimeService;
     async create(body) {
-        return await this.service.create(body);
+        const result = await this.service.create(body);
+        if (this.realtimeService) {
+            const entityName = this.constructor.name.replace('Controller', '').replace('MsController', '').toLowerCase();
+            this.realtimeService.publishEntityChange(entityName, 'create', result, result.tenantId);
+        }
+        return result;
     }
     async update(id, body) {
-        return await this.service.update(+id, body);
+        const result = await this.service.update(+id, body);
+        if (this.realtimeService) {
+            const entityName = this.constructor.name.replace('Controller', '').replace('MsController', '').toLowerCase();
+            this.realtimeService.publishEntityChange(entityName, 'update', result, result.tenantId);
+        }
+        return result;
     }
     async findMany(filter) {
         return await this.service.findMany(filter);
@@ -33,10 +45,19 @@ class BaseCrudController {
         return await this.service.findOne(+id);
     }
     async delete(id) {
-        return await this.service.delete(+id);
+        await this.service.delete(+id);
+        if (this.realtimeService) {
+            const entityName = this.constructor.name.replace('Controller', '').replace('MsController', '').toLowerCase();
+            this.realtimeService.publishEntityChange(entityName, 'delete', { id: +id });
+        }
     }
 }
 exports.BaseCrudController = BaseCrudController;
+__decorate([
+    (0, common_1.Inject)(realtime_service_1.RealtimeService),
+    (0, common_1.Optional)(),
+    __metadata("design:type", realtime_service_1.RealtimeService)
+], BaseCrudController.prototype, "realtimeService", void 0);
 __decorate([
     (0, common_1.Post)(),
     (0, swagger_1.ApiOperation)({ summary: 'Create entity' }),

package/dist/index.d.ts

@@ -4,3 +4,5 @@ export * from './database/typeorm-query.builder';
 export * from './http/base-crud.controller';
 export * from './storage';
 export * from './auth';
+export * from './realtime';
+export * from './audit';

package/dist/index.js

@@ -20,3 +20,5 @@ __exportStar(require("./database/typeorm-query.builder"), exports);
 __exportStar(require("./http/base-crud.controller"), exports);
 __exportStar(require("./storage"), exports);
 __exportStar(require("./auth"), exports);
+__exportStar(require("./realtime"), exports);
+__exportStar(require("./audit"), exports);

package/dist/realtime/index.d.ts

@@ -0,0 +1,3 @@
+export * from './realtime.module';
+export * from './realtime.service';
+export * from './realtime.gateway';

package/dist/realtime/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./realtime.module"), exports);
+__exportStar(require("./realtime.service"), exports);
+__exportStar(require("./realtime.gateway"), exports);

package/dist/realtime/realtime.gateway.d.ts

@@ -0,0 +1,14 @@
+import { OnGatewayConnection, OnGatewayDisconnect } from '@nestjs/websockets';
+import { Server, Socket } from 'socket.io';
+export declare class RealtimeGateway implements OnGatewayConnection, OnGatewayDisconnect {
+    server: Server;
+    private readonly logger;
+    private connectedUsers;
+    handleConnection(client: Socket): void;
+    handleDisconnect(client: Socket): void;
+    emitEntityChange(entityName: string, action: string, data: any, tenantId?: string): void;
+    handleSubscribeEntity(entity: string, client: Socket): {
+        event: string;
+        data: string;
+    };
+}

package/dist/realtime/realtime.gateway.js

@@ -0,0 +1,134 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var RealtimeGateway_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeGateway = void 0;
+const websockets_1 = require("@nestjs/websockets");
+const socket_io_1 = require("socket.io");
+const common_1 = require("@nestjs/common");
+const jwt = __importStar(require("jsonwebtoken"));
+let RealtimeGateway = RealtimeGateway_1 = class RealtimeGateway {
+    server;
+    logger = new common_1.Logger(RealtimeGateway_1.name);
+    connectedUsers = new Map();
+    handleConnection(client) {
+        try {
+            const token = client.handshake.auth?.token || client.handshake.headers?.authorization?.split(' ')[1];
+            if (!token) {
+                this.logger.warn(`Conexão rejeitada: Token JWT ausente.`);
+                client.disconnect();
+                return;
+            }
+            const secret = process.env.JWT_SECRET || 'devstroupe-secret-key-12345';
+            const decoded = jwt.verify(token, secret);
+            client.data = {
+                userId: decoded.sub,
+                email: decoded.email,
+                role: decoded.role,
+                tenantId: decoded.tenantId,
+                permissions: decoded.permissions || [],
+            };
+            // Registrar o socket associado ao usuário
+            this.connectedUsers.set(String(decoded.sub), client);
+            // Entrar nas salas padrão do usuário (sala própria, sala do perfil e do tenant)
+            client.join(`user:${decoded.sub}`);
+            if (decoded.role) {
+                client.join(`role:${decoded.role}`);
+            }
+            if (decoded.tenantId) {
+                client.join(`tenant:${decoded.tenantId}`);
+            }
+            this.logger.log(`Cliente conectado: User ID ${decoded.sub} (Socket ${client.id})`);
+        }
+        catch (err) {
+            this.logger.warn(`Conexão rejeitada: Token JWT inválido.`);
+            client.disconnect();
+        }
+    }
+    handleDisconnect(client) {
+        if (client.data?.userId) {
+            this.connectedUsers.delete(String(client.data.userId));
+            this.logger.log(`Cliente desconectado: User ID ${client.data.userId} (Socket ${client.id})`);
+        }
+    }
+    // Notifica uma mudança de entidade para todos os inscritos (respeitando o tenant se houver)
+    emitEntityChange(entityName, action, data, tenantId) {
+        const payload = { entity: entityName, action, data };
+        if (tenantId) {
+            this.server.to(`tenant:${tenantId}`).emit('entity_changed', payload);
+        }
+        else {
+            this.server.emit('entity_changed', payload);
+        }
+    }
+    handleSubscribeEntity(entity, client) {
+        client.join(`entity:${entity}`);
+        return { event: 'subscribed', data: entity };
+    }
+};
+exports.RealtimeGateway = RealtimeGateway;
+__decorate([
+    (0, websockets_1.WebSocketServer)(),
+    __metadata("design:type", socket_io_1.Server)
+], RealtimeGateway.prototype, "server", void 0);
+__decorate([
+    (0, websockets_1.SubscribeMessage)('subscribe_entity'),
+    __param(0, (0, websockets_1.MessageBody)()),
+    __param(1, (0, websockets_1.ConnectedSocket)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, socket_io_1.Socket]),
+    __metadata("design:returntype", void 0)
+], RealtimeGateway.prototype, "handleSubscribeEntity", null);
+exports.RealtimeGateway = RealtimeGateway = RealtimeGateway_1 = __decorate([
+    (0, websockets_1.WebSocketGateway)({
+        cors: {
+            origin: '*',
+        },
+        transports: ['websocket'],
+    }),
+    (0, common_1.Injectable)()
+], RealtimeGateway);

package/dist/realtime/realtime.module.d.ts

@@ -0,0 +1,2 @@
+export declare class RealtimeModule {
+}

package/dist/realtime/realtime.module.js

@@ -0,0 +1,22 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeModule = void 0;
+const common_1 = require("@nestjs/common");
+const realtime_gateway_1 = require("./realtime.gateway");
+const realtime_service_1 = require("./realtime.service");
+let RealtimeModule = class RealtimeModule {
+};
+exports.RealtimeModule = RealtimeModule;
+exports.RealtimeModule = RealtimeModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [realtime_gateway_1.RealtimeGateway, realtime_service_1.RealtimeService],
+        exports: [realtime_service_1.RealtimeService],
+    })
+], RealtimeModule);

package/dist/realtime/realtime.service.d.ts

@@ -0,0 +1,10 @@
+import { RealtimeGateway } from './realtime.gateway';
+export declare class RealtimeService {
+    private readonly gateway;
+    constructor(gateway: RealtimeGateway);
+    /**
+     * Publica uma mudança de entidade no WebSocket.
+     * Se chamado a partir de um Controller, isso garante que o evento seja publicado pós-commit da transação.
+     */
+    publishEntityChange(entityName: string, action: 'create' | 'update' | 'delete', data: any, tenantId?: string): void;
+}

package/dist/realtime/realtime.service.js

@@ -0,0 +1,32 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeService = void 0;
+const common_1 = require("@nestjs/common");
+const realtime_gateway_1 = require("./realtime.gateway");
+let RealtimeService = class RealtimeService {
+    gateway;
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    /**
+     * Publica uma mudança de entidade no WebSocket.
+     * Se chamado a partir de um Controller, isso garante que o evento seja publicado pós-commit da transação.
+     */
+    publishEntityChange(entityName, action, data, tenantId) {
+        this.gateway.emitEntityChange(entityName, action, data, tenantId);
+    }
+};
+exports.RealtimeService = RealtimeService;
+exports.RealtimeService = RealtimeService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [realtime_gateway_1.RealtimeGateway])
+], RealtimeService);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devstroupe/devkit-nest",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "DevsTroupe Development Kit — NestJS base classes: BaseRepository, BaseCrudController and query parsers",
   "license": "MIT",
   "keywords": [
@@ -29,14 +29,18 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@devstroupe/devkit-core": "^1.0.0",
     "@aws-sdk/client-s3": "^3.500.0",
-    "@aws-sdk/s3-request-presigner": "^3.500.0"
+    "@aws-sdk/s3-request-presigner": "^3.500.0",
+    "jsonwebtoken": "^9.0.2",
+    "@devstroupe/devkit-core": "1.1.0"
   },
   "peerDependencies": {
     "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/core": "^10.0.0 || ^11.0.0",
     "@nestjs/swagger": "^7.0.0 || ^8.0.0 || ^9.0.0 || ^10.0.0 || ^11.0.0",
+    "@nestjs/websockets": "^10.0.0 || ^11.0.0",
+    "socket.io": "^4.7.0",
+    "rxjs": "^7.0.0",
     "typeorm": "^0.3.0",
     "reflect-metadata": "^0.1.13 || ^0.2.0"
   },
@@ -44,7 +48,11 @@
     "@nestjs/common": "^10.3.8",
     "@nestjs/core": "^10.3.8",
     "@nestjs/swagger": "^7.3.1",
+    "@nestjs/websockets": "^10.3.8",
+    "@types/jsonwebtoken": "^9.0.6",
     "@types/node": "^20.11.0",
+    "rxjs": "^7.8.1",
+    "socket.io": "^4.7.5",
     "typeorm": "^0.3.17",
     "reflect-metadata": "^0.1.13",
     "typescript": "^5.4.5"