rl-core-api 0.7.0 → 0.8.0

package/dist/core/queue/jobStatus.response.js

@@ -0,0 +1,84 @@
+"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.JobStatusResponse = exports.JobErrorResponse = exports.JobProgressResponse = void 0;
+const swagger_1 = require("@nestjs/swagger");
+class JobProgressResponse {
+}
+exports.JobProgressResponse = JobProgressResponse;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 120 }),
+    __metadata("design:type", Number)
+], JobProgressResponse.prototype, "processed", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 175 }),
+    __metadata("design:type", Number)
+], JobProgressResponse.prototype, "total", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 69, description: "Inteiro de 0 a 100" }),
+    __metadata("design:type", Number)
+], JobProgressResponse.prototype, "percent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ required: false, example: "Lendo a planilha" }),
+    __metadata("design:type", String)
+], JobProgressResponse.prototype, "message", void 0);
+class JobErrorResponse {
+}
+exports.JobErrorResponse = JobErrorResponse;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true, example: "INVALID_FILTER" }),
+    __metadata("design:type", Object)
+], JobErrorResponse.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: "Falha ao processar. Tente novamente" }),
+    __metadata("design:type", String)
+], JobErrorResponse.prototype, "message", void 0);
+class JobStatusResponse {
+}
+exports.JobStatusResponse = JobStatusResponse;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: "42" }),
+    __metadata("design:type", String)
+], JobStatusResponse.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: "funkos:import" }),
+    __metadata("design:type", String)
+], JobStatusResponse.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        example: "active",
+        enum: ["waiting", "active", "completed", "failed", "delayed", "unknown"],
+    }),
+    __metadata("design:type", String)
+], JobStatusResponse.prototype, "state", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: JobProgressResponse, nullable: true }),
+    __metadata("design:type", Object)
+], JobStatusResponse.prototype, "progress", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        nullable: true,
+        description: "Relatório que o processador devolveu, no formato da feature",
+    }),
+    __metadata("design:type", Object)
+], JobStatusResponse.prototype, "summary", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: JobErrorResponse, nullable: true }),
+    __metadata("design:type", Object)
+], JobStatusResponse.prototype, "error", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ format: "date-time" }),
+    __metadata("design:type", String)
+], JobStatusResponse.prototype, "createdAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: String, format: "date-time", nullable: true }),
+    __metadata("design:type", Object)
+], JobStatusResponse.prototype, "finishedAt", void 0);

package/dist/core/queue/jobWorkerHost.d.ts

@@ -0,0 +1,17 @@
+import { WorkerHost } from "@nestjs/bullmq";
+import { Logger, OnApplicationBootstrap } from "@nestjs/common";
+import { Job } from "bullmq";
+import { JobContext, JobEnvelope } from "./job.interface";
+import { JobEventsService } from "./jobEvents.service";
+export declare abstract class JobWorkerHost<TPayload = unknown, TSummary = unknown> extends WorkerHost implements OnApplicationBootstrap {
+    protected readonly jobEvents: JobEventsService;
+    protected readonly logger: Logger;
+    constructor(jobEvents: JobEventsService);
+    onApplicationBootstrap(): void;
+    abstract handle(job: JobContext<TPayload>): Promise<TSummary>;
+    process(job: Job<JobEnvelope<TPayload>>): Promise<TSummary>;
+}
+export declare const toSafeError: (err: Error) => {
+    errorCode: string | null;
+    message: string;
+};

package/dist/core/queue/jobWorkerHost.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSafeError = exports.JobWorkerHost = void 0;
+const bullmq_1 = require("@nestjs/bullmq");
+const common_1 = require("@nestjs/common");
+class JobWorkerHost extends bullmq_1.WorkerHost {
+    constructor(jobEvents) {
+        super();
+        this.jobEvents = jobEvents;
+        this.logger = new common_1.Logger(this.constructor.name);
+    }
+    onApplicationBootstrap() {
+        if (!this.worker.isRunning()) {
+            void this.worker.run();
+        }
+    }
+    async process(job) {
+        const jobId = String(job.id);
+        const { ownerId, payload } = job.data;
+        try {
+            const summary = await this.handle({
+                jobId,
+                ownerId,
+                payload,
+                report: async (processed, total, message) => {
+                    const percent = total > 0 ? Math.min(100, Math.round((processed / total) * 100)) : 0;
+                    await job.updateProgress({ processed, total, percent, message });
+                    this.jobEvents.progress(ownerId, {
+                        jobId,
+                        name: job.name,
+                        processed,
+                        total,
+                        percent,
+                        message,
+                    });
+                },
+            });
+            this.jobEvents.completed(ownerId, {
+                jobId,
+                name: job.name,
+                summary,
+            });
+            return summary;
+        }
+        catch (err) {
+            this.logger.error(`Job ${job.name} #${jobId} falhou: ${err.message}`, err.stack);
+            if (job.attemptsMade + 1 >= (job.opts.attempts ?? 1)) {
+                this.jobEvents.failed(ownerId, {
+                    jobId,
+                    name: job.name,
+                    ...(0, exports.toSafeError)(err),
+                });
+            }
+            throw err;
+        }
+    }
+}
+exports.JobWorkerHost = JobWorkerHost;
+const toSafeError = (err) => {
+    if (err instanceof common_1.HttpException) {
+        const response = err.getResponse();
+        const code = typeof response === "object" && response !== null
+            ? (response.errorCode ?? null)
+            : null;
+        return { errorCode: code, message: err.message };
+    }
+    return {
+        errorCode: null,
+        message: "Falha ao processar. Tente novamente ou avise o suporte",
+    };
+};
+exports.toSafeError = toSafeError;

package/dist/core/queue/queue.constants.d.ts

@@ -0,0 +1,11 @@
+export declare const JOBS_QUEUE = "jobs";
+export declare const JOB_PROGRESS_EVENT = "job:progress";
+export declare const JOB_COMPLETED_EVENT = "job:completed";
+export declare const JOB_FAILED_EVENT = "job:failed";
+export declare const JOB_CONCURRENCY = 5;
+export declare const JOB_ATTEMPTS = 3;
+export declare const JOB_BACKOFF_DELAY_MS = 30000;
+export declare const COMPLETED_RETENTION_SECONDS = 86400;
+export declare const FAILED_RETENTION_SECONDS = 14400;
+export declare const isRedisConfigured: () => boolean;
+export declare const queuePrefix: () => string;

package/dist/core/queue/queue.constants.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queuePrefix = exports.isRedisConfigured = exports.FAILED_RETENTION_SECONDS = exports.COMPLETED_RETENTION_SECONDS = exports.JOB_BACKOFF_DELAY_MS = exports.JOB_ATTEMPTS = exports.JOB_CONCURRENCY = exports.JOB_FAILED_EVENT = exports.JOB_COMPLETED_EVENT = exports.JOB_PROGRESS_EVENT = exports.JOBS_QUEUE = void 0;
+const dotenv_1 = require("dotenv");
+(0, dotenv_1.config)();
+exports.JOBS_QUEUE = "jobs";
+exports.JOB_PROGRESS_EVENT = "job:progress";
+exports.JOB_COMPLETED_EVENT = "job:completed";
+exports.JOB_FAILED_EVENT = "job:failed";
+exports.JOB_CONCURRENCY = 5;
+exports.JOB_ATTEMPTS = 3;
+exports.JOB_BACKOFF_DELAY_MS = 30_000;
+exports.COMPLETED_RETENTION_SECONDS = 86_400;
+exports.FAILED_RETENTION_SECONDS = 14_400;
+const isRedisConfigured = () => Boolean(process.env.REDIS_HOST);
+exports.isRedisConfigured = isRedisConfigured;
+const queuePrefix = () => process.env.REDIS_PREFIX ?? "core";
+exports.queuePrefix = queuePrefix;

package/dist/core/queue/queue.module.d.ts

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

package/dist/core/queue/queue.module.js

@@ -0,0 +1,38 @@
+"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.QueueModule = void 0;
+const bullmq_1 = require("@nestjs/bullmq");
+const common_1 = require("@nestjs/common");
+const bullConnection_module_1 = require("./bullConnection.module");
+const job_producer_1 = require("./job.producer");
+const jobEvents_service_1 = require("./jobEvents.service");
+const jobStatus_controller_1 = require("./jobStatus.controller");
+const queue_constants_1 = require("./queue.constants");
+const queueAdmin_controller_1 = require("./queueAdmin.controller");
+const queueAdmin_service_1 = require("./queueAdmin.service");
+const logger = new common_1.Logger("QueueModule");
+const buildImports = () => {
+    if (!(0, queue_constants_1.isRedisConfigured)()) {
+        logger.warn("REDIS_HOST não configurado — a fila não será registrada e o enfileiramento fica indisponível");
+        return [];
+    }
+    return [bullConnection_module_1.BullConnectionModule, bullmq_1.BullModule.registerQueue({ name: queue_constants_1.JOBS_QUEUE })];
+};
+let QueueModule = class QueueModule {
+};
+exports.QueueModule = QueueModule;
+exports.QueueModule = QueueModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        imports: buildImports(),
+        controllers: [jobStatus_controller_1.JobStatusController, queueAdmin_controller_1.QueueAdminController],
+        providers: [job_producer_1.JobProducer, jobEvents_service_1.JobEventsService, queueAdmin_service_1.QueueAdminService],
+        exports: [job_producer_1.JobProducer, jobEvents_service_1.JobEventsService],
+    })
+], QueueModule);

package/dist/core/queue/queueAdmin.controller.d.ts

@@ -0,0 +1,11 @@
+import { QueueCounts, QueueJobSummary } from "./job.interface";
+import { QueueAdminService } from "./queueAdmin.service";
+import { Paginated } from "../utils/pagination.util";
+export declare class QueueAdminController {
+    private readonly queues;
+    constructor(queues: QueueAdminService);
+    counts(): Promise<QueueCounts>;
+    jobs(state: string, page?: string, limit?: string): Promise<Paginated<QueueJobSummary>>;
+    retry(id: string): Promise<void>;
+    remove(id: string): Promise<void>;
+}

package/dist/core/queue/queueAdmin.controller.js

@@ -0,0 +1,93 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueueAdminController = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const requirePermission_decorator_1 = require("../auth/decorators/requirePermission.decorator");
+const permissions_guard_1 = require("../auth/guards/permissions.guard");
+const queueAdmin_response_1 = require("./queueAdmin.response");
+const queueAdmin_service_1 = require("./queueAdmin.service");
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 100;
+let QueueAdminController = class QueueAdminController {
+    constructor(queues) {
+        this.queues = queues;
+    }
+    counts() {
+        return this.queues.counts();
+    }
+    jobs(state, page, limit) {
+        return this.queues.list(toState(state), toPositive(page, 1), Math.min(toPositive(limit, DEFAULT_LIMIT), MAX_LIMIT));
+    }
+    retry(id) {
+        return this.queues.retry(id);
+    }
+    remove(id) {
+        return this.queues.remove(id);
+    }
+};
+exports.QueueAdminController = QueueAdminController;
+__decorate([
+    (0, common_1.Get)("counts"),
+    (0, requirePermission_decorator_1.RequirePermission)("queues:read:any"),
+    (0, swagger_1.ApiOkResponse)({ type: queueAdmin_response_1.QueueCountsResponse }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], QueueAdminController.prototype, "counts", null);
+__decorate([
+    (0, common_1.Get)("jobs"),
+    (0, requirePermission_decorator_1.RequirePermission)("queues:read:any"),
+    (0, swagger_1.ApiQuery)({ name: "state", enum: queueAdmin_service_1.LISTABLE_STATES }),
+    (0, swagger_1.ApiOkResponse)({ type: queueAdmin_response_1.PaginatedQueueJobsResponse }),
+    __param(0, (0, common_1.Query)("state")),
+    __param(1, (0, common_1.Query)("page")),
+    __param(2, (0, common_1.Query)("limit")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", Promise)
+], QueueAdminController.prototype, "jobs", null);
+__decorate([
+    (0, common_1.Post)("jobs/:id/retry"),
+    (0, common_1.HttpCode)(204),
+    (0, requirePermission_decorator_1.RequirePermission)("queues:manage:any"),
+    __param(0, (0, common_1.Param)("id")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], QueueAdminController.prototype, "retry", null);
+__decorate([
+    (0, common_1.Delete)("jobs/:id"),
+    (0, common_1.HttpCode)(204),
+    (0, requirePermission_decorator_1.RequirePermission)("queues:manage:any"),
+    __param(0, (0, common_1.Param)("id")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], QueueAdminController.prototype, "remove", null);
+exports.QueueAdminController = QueueAdminController = __decorate([
+    (0, swagger_1.ApiTags)("Queues"),
+    (0, swagger_1.ApiBearerAuth)(),
+    (0, common_1.UseGuards)(permissions_guard_1.PermissionsGuard),
+    (0, common_1.Controller)({ path: "queues", version: "1" }),
+    __metadata("design:paramtypes", [queueAdmin_service_1.QueueAdminService])
+], QueueAdminController);
+const toState = (value) => queueAdmin_service_1.LISTABLE_STATES.includes(value)
+    ? value
+    : "failed";
+const toPositive = (value, fallback) => {
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
+};

package/dist/core/queue/queueAdmin.response.d.ts

@@ -0,0 +1,23 @@
+import { PaginationMetaResponse } from "../utils/paginationMeta.response";
+export declare class QueueCountsResponse {
+    waiting: number;
+    active: number;
+    completed: number;
+    failed: number;
+    delayed: number;
+}
+export declare class QueueJobResponse {
+    id: string;
+    name: string;
+    state: string;
+    ownerId: string | null;
+    attemptsMade: number;
+    percent: number | null;
+    failedReason: string | null;
+    createdAt: string;
+    finishedAt: string | null;
+}
+export declare class PaginatedQueueJobsResponse {
+    items: QueueJobResponse[];
+    meta: PaginationMetaResponse;
+}

package/dist/core/queue/queueAdmin.response.js

@@ -0,0 +1,87 @@
+"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.PaginatedQueueJobsResponse = exports.QueueJobResponse = exports.QueueCountsResponse = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const paginationMeta_response_1 = require("../utils/paginationMeta.response");
+class QueueCountsResponse {
+}
+exports.QueueCountsResponse = QueueCountsResponse;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 3 }),
+    __metadata("design:type", Number)
+], QueueCountsResponse.prototype, "waiting", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 1 }),
+    __metadata("design:type", Number)
+], QueueCountsResponse.prototype, "active", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 128 }),
+    __metadata("design:type", Number)
+], QueueCountsResponse.prototype, "completed", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 2 }),
+    __metadata("design:type", Number)
+], QueueCountsResponse.prototype, "failed", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 0 }),
+    __metadata("design:type", Number)
+], QueueCountsResponse.prototype, "delayed", void 0);
+class QueueJobResponse {
+}
+exports.QueueJobResponse = QueueJobResponse;
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: "42" }),
+    __metadata("design:type", String)
+], QueueJobResponse.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: "funkos:import" }),
+    __metadata("design:type", String)
+], QueueJobResponse.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: "failed" }),
+    __metadata("design:type", String)
+], QueueJobResponse.prototype, "state", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: String, format: "uuid", nullable: true }),
+    __metadata("design:type", Object)
+], QueueJobResponse.prototype, "ownerId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 2 }),
+    __metadata("design:type", Number)
+], QueueJobResponse.prototype, "attemptsMade", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: Number, nullable: true, example: 69 }),
+    __metadata("design:type", Object)
+], QueueJobResponse.prototype, "percent", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: String, nullable: true }),
+    __metadata("design:type", Object)
+], QueueJobResponse.prototype, "failedReason", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ format: "date-time" }),
+    __metadata("design:type", String)
+], QueueJobResponse.prototype, "createdAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: String, format: "date-time", nullable: true }),
+    __metadata("design:type", Object)
+], QueueJobResponse.prototype, "finishedAt", void 0);
+class PaginatedQueueJobsResponse {
+}
+exports.PaginatedQueueJobsResponse = PaginatedQueueJobsResponse;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: QueueJobResponse, isArray: true }),
+    __metadata("design:type", Array)
+], PaginatedQueueJobsResponse.prototype, "items", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: paginationMeta_response_1.PaginationMetaResponse }),
+    __metadata("design:type", paginationMeta_response_1.PaginationMetaResponse)
+], PaginatedQueueJobsResponse.prototype, "meta", void 0);

package/dist/core/queue/queueAdmin.service.d.ts

@@ -0,0 +1,15 @@
+import { QueueCounts, QueueJobSummary } from "./job.interface";
+import { JobProducer } from "./job.producer";
+import { Paginated } from "../utils/pagination.util";
+export declare const LISTABLE_STATES: readonly ["waiting", "active", "completed", "failed", "delayed"];
+export type ListableState = (typeof LISTABLE_STATES)[number];
+export declare class QueueAdminService {
+    private readonly producer;
+    constructor(producer: JobProducer);
+    counts(): Promise<QueueCounts>;
+    list(state: ListableState, page: number, limit: number): Promise<Paginated<QueueJobSummary>>;
+    retry(jobId: string): Promise<void>;
+    remove(jobId: string): Promise<void>;
+    private findJob;
+    private toSummary;
+}

package/dist/core/queue/queueAdmin.service.js

@@ -0,0 +1,85 @@
+"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.QueueAdminService = exports.LISTABLE_STATES = void 0;
+const common_1 = require("@nestjs/common");
+const job_producer_1 = require("./job.producer");
+const pagination_util_1 = require("../utils/pagination.util");
+exports.LISTABLE_STATES = [
+    "waiting",
+    "active",
+    "completed",
+    "failed",
+    "delayed",
+];
+let QueueAdminService = class QueueAdminService {
+    constructor(producer) {
+        this.producer = producer;
+    }
+    async counts() {
+        const queue = this.producer.requireQueue();
+        const counts = await queue.getJobCounts(...exports.LISTABLE_STATES);
+        return {
+            waiting: counts.waiting ?? 0,
+            active: counts.active ?? 0,
+            completed: counts.completed ?? 0,
+            failed: counts.failed ?? 0,
+            delayed: counts.delayed ?? 0,
+        };
+    }
+    async list(state, page, limit) {
+        const queue = this.producer.requireQueue();
+        const start = (page - 1) * limit;
+        const [jobs, counts] = await Promise.all([
+            queue.getJobs([state], start, start + limit - 1),
+            queue.getJobCounts(state),
+        ]);
+        const items = jobs.filter(Boolean).map((job) => this.toSummary(job, state));
+        return new pagination_util_1.Paginated(items, counts[state] ?? 0, page, limit);
+    }
+    async retry(jobId) {
+        const job = await this.findJob(jobId);
+        await job.retry();
+    }
+    async remove(jobId) {
+        const job = await this.findJob(jobId);
+        await job.remove();
+    }
+    async findJob(jobId) {
+        const queue = this.producer.requireQueue();
+        const job = await queue.getJob(jobId);
+        if (!job) {
+            throw new common_1.NotFoundException("Job não encontrado");
+        }
+        return job;
+    }
+    toSummary(job, state) {
+        const progress = job.progress;
+        return {
+            id: String(job.id),
+            name: job.name,
+            state,
+            ownerId: job.data?.ownerId ?? null,
+            attemptsMade: job.attemptsMade,
+            percent: typeof progress === "object" && progress !== null
+                ? (progress.percent ?? null)
+                : null,
+            failedReason: job.failedReason ?? null,
+            createdAt: new Date(job.timestamp).toISOString(),
+            finishedAt: job.finishedOn ? new Date(job.finishedOn).toISOString() : null,
+        };
+    }
+};
+exports.QueueAdminService = QueueAdminService;
+exports.QueueAdminService = QueueAdminService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [job_producer_1.JobProducer])
+], QueueAdminService);

package/dist/core/queue/redisConnection.d.ts

@@ -0,0 +1,2 @@
+import { RedisOptions } from "ioredis";
+export declare const buildRedisOptions: () => RedisOptions;

package/dist/core/queue/redisConnection.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRedisOptions = void 0;
+const buildRedisOptions = () => ({
+    host: process.env.REDIS_HOST,
+    port: Number(process.env.REDIS_PORT) || 6379,
+    password: process.env.REDIS_PASSWORD || undefined,
+    maxRetriesPerRequest: null,
+    enableReadyCheck: false,
+});
+exports.buildRedisOptions = buildRedisOptions;

package/dist/core/websocket/baseGateway.d.ts

@@ -17,6 +17,7 @@ export declare abstract class BaseGateway implements OnGatewayConnection, OnGate
     handleConnection(socket: Socket): Promise<void>;
     handleDisconnect(socket: Socket): void;
     requestSessionRefresh(userId: string): void;
+    emitToUser<T>(userId: string, event: string, data: T): void;
     protected emitTo<T>(rooms: string[], event: string, data: T): void;
     private scheduleExpiry;
 }

package/dist/core/websocket/baseGateway.js

@@ -43,6 +43,9 @@ class BaseGateway {
     requestSessionRefresh(userId) {
         this.emitTo([(0, socket_constants_1.userRoom)(userId)], socket_constants_1.SESSION_REFRESH_EVENT, { userId });
     }
+    emitToUser(userId, event, data) {
+        this.emitTo([(0, socket_constants_1.userRoom)(userId)], event, data);
+    }
     emitTo(rooms, event, data) {
         const targets = rooms.filter((room) => room.length > 0);
         if (targets.length === 0) {

package/dist/features/audit/audit.module.js

@@ -29,6 +29,7 @@ exports.AuditModule = AuditModule = __decorate([
             domain_1.AuditService,
             { provide: core_1.APP_INTERCEPTOR, useClass: presentation_1.AuditInterceptor },
             presentation_1.HttpErrorListener,
+            presentation_1.UserPermissionsChangedListener,
             presentation_1.UserRolesChangedListener,
             infra_1.AuditDataSubscriber,
         ],

package/dist/features/audit/presentation/index.d.ts

@@ -2,4 +2,5 @@ export * from "./audit.controller";
 export * from "./audit.interceptor";
 export * from "./decorators/auditable.decorator";
 export * from "./httpError.listener";
+export * from "./userPermissionsChanged.listener";
 export * from "./userRolesChanged.listener";

package/dist/features/audit/presentation/index.js

@@ -18,4 +18,5 @@ __exportStar(require("./audit.controller"), exports);
 __exportStar(require("./audit.interceptor"), exports);
 __exportStar(require("./decorators/auditable.decorator"), exports);
 __exportStar(require("./httpError.listener"), exports);
+__exportStar(require("./userPermissionsChanged.listener"), exports);
 __exportStar(require("./userRolesChanged.listener"), exports);

package/dist/features/audit/presentation/userPermissionsChanged.listener.d.ts

@@ -0,0 +1,7 @@
+import { UserPermissionsChangedEvent } from "../../../core/events/appEvent.enum";
+import { AuditService } from "../domain/audit.service";
+export declare class UserPermissionsChangedListener {
+    private readonly audit;
+    constructor(audit: AuditService);
+    onPermissionsChanged(event: UserPermissionsChangedEvent): Promise<void>;
+}