@ninenity/neutrun 1.0.0 → 1.9.0

package/dist/Shared/Observability.d.ts

@@ -0,0 +1,59 @@
+export type MetricLabelValue = string | number | boolean;
+export type MetricLabels = Record<string, MetricLabelValue | null | undefined>;
+export interface ObservabilityContext {
+    correlationId: string;
+    requestId?: string;
+    source?: string;
+}
+export interface CounterSnapshot {
+    name: string;
+    labels: Record<string, MetricLabelValue>;
+    value: number;
+}
+export interface GaugeSnapshot extends CounterSnapshot {
+}
+export interface HistogramSnapshot {
+    name: string;
+    labels: Record<string, MetricLabelValue>;
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    average: number;
+}
+export interface ObservabilitySnapshot {
+    generatedAt: string;
+    droppedSeries: number;
+    counters: CounterSnapshot[];
+    gauges: GaugeSnapshot[];
+    histograms: HistogramSnapshot[];
+}
+export interface ObservabilityOptions {
+    maxSeries?: number;
+    maxLabels?: number;
+}
+export declare class ObservabilityRegistry {
+    private readonly contextStorage;
+    private readonly counters;
+    private readonly gauges;
+    private readonly histograms;
+    private readonly maxSeries;
+    private readonly maxLabels;
+    private droppedSeries;
+    constructor(options?: ObservabilityOptions);
+    createCorrelationId(): string;
+    getContext(): ObservabilityContext | undefined;
+    getCorrelationId(): string | undefined;
+    run<T>(context: Partial<ObservabilityContext>, callback: () => T): T;
+    increment(name: string, value?: number, labels?: MetricLabels): void;
+    setGauge(name: string, value: number, labels?: MetricLabels): void;
+    observe(name: string, value: number, labels?: MetricLabels): void;
+    snapshot(reset?: boolean): ObservabilitySnapshot;
+    reset(): void;
+    private resetMeasurements;
+    private getOrCreateSeries;
+    private get totalSeries();
+}
+export declare const Observability: ObservabilityRegistry;
+export default Observability;
+//# sourceMappingURL=Observability.d.ts.map

package/dist/Shared/Observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Observability.d.ts","sourceRoot":"","sources":["../../src/Shared/Observability.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AACxD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAE9E,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACxC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;CAAG;AAEzD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,UAAU,EAAE,iBAAiB,EAAE,CAAA;CAChC;AAcD,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgD;IAC/E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsD;IAC/E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsD;IAC7E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,aAAa,CAAI;gBAEN,OAAO,GAAE,oBAAyB;IAK9C,mBAAmB,IAAI,MAAM;IAI7B,UAAU,IAAI,oBAAoB,GAAG,SAAS;IAI9C,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAcpE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,MAAM,GAAE,YAAiB,GAAG,IAAI;IAOnE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiB,GAAG,IAAI;IAOtE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiB,GAAG,IAAI;IAgBrE,QAAQ,CAAC,KAAK,UAAQ,GAAG,qBAAqB;IA+B9C,KAAK,IAAI,IAAI;IAOpB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,KAAK,WAAW,GAEtB;CACF;AAED,eAAO,MAAM,aAAa,uBAA8B,CAAA;AACxD,eAAe,aAAa,CAAA"}

package/dist/Shared/Observability.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Observability = exports.ObservabilityRegistry = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+const node_crypto_1 = require("node:crypto");
+const DEFAULT_MAX_SERIES = 300;
+const DEFAULT_MAX_LABELS = 8;
+const MAX_NAME_LENGTH = 100;
+const MAX_LABEL_VALUE_LENGTH = 100;
+const SENSITIVE_LABEL_PATTERN = /(?:authorization|cookie|password|secret|token|api[-_]?key)/i;
+class ObservabilityRegistry {
+    contextStorage = new node_async_hooks_1.AsyncLocalStorage();
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    maxSeries;
+    maxLabels;
+    droppedSeries = 0;
+    constructor(options = {}) {
+        this.maxSeries = clampInteger(options.maxSeries, 10, 5_000, DEFAULT_MAX_SERIES);
+        this.maxLabels = clampInteger(options.maxLabels, 0, 20, DEFAULT_MAX_LABELS);
+    }
+    createCorrelationId() {
+        return (0, node_crypto_1.randomUUID)();
+    }
+    getContext() {
+        return this.contextStorage.getStore();
+    }
+    getCorrelationId() {
+        return this.getContext()?.correlationId;
+    }
+    run(context, callback) {
+        const correlationId = normalizeCorrelationId(context.correlationId ?? context.requestId ?? this.createCorrelationId());
+        return this.contextStorage.run({
+            correlationId,
+            ...(context.requestId ? { requestId: normalizeCorrelationId(context.requestId) } : {}),
+            ...(context.source ? { source: String(context.source).slice(0, 50) } : {})
+        }, callback);
+    }
+    increment(name, value = 1, labels = {}) {
+        if (!Number.isFinite(value))
+            return;
+        const series = this.getOrCreateSeries(this.counters, name, labels, { value: 0 });
+        if (!series)
+            return;
+        series.value = boundedNumber(series.value + value);
+    }
+    setGauge(name, value, labels = {}) {
+        if (!Number.isFinite(value))
+            return;
+        const series = this.getOrCreateSeries(this.gauges, name, labels, { value: 0 });
+        if (!series)
+            return;
+        series.value = boundedNumber(value);
+    }
+    observe(name, value, labels = {}) {
+        if (!Number.isFinite(value))
+            return;
+        const bounded = boundedNumber(value);
+        const series = this.getOrCreateSeries(this.histograms, name, labels, {
+            count: 0,
+            sum: 0,
+            min: Number.POSITIVE_INFINITY,
+            max: Number.NEGATIVE_INFINITY
+        });
+        if (!series)
+            return;
+        series.count = Math.min(Number.MAX_SAFE_INTEGER, series.count + 1);
+        series.sum = boundedNumber(series.sum + bounded);
+        series.min = Math.min(series.min, bounded);
+        series.max = Math.max(series.max, bounded);
+    }
+    snapshot(reset = false) {
+        const snapshot = {
+            generatedAt: new Date().toISOString(),
+            droppedSeries: this.droppedSeries,
+            counters: Array.from(this.counters.values(), ({ name, labels, value }) => ({
+                name,
+                labels: { ...labels },
+                value
+            })),
+            gauges: Array.from(this.gauges.values(), ({ name, labels, value }) => ({
+                name,
+                labels: { ...labels },
+                value
+            })),
+            histograms: Array.from(this.histograms.values(), ({ name, labels, count, sum, min, max }) => ({
+                name,
+                labels: { ...labels },
+                count,
+                sum,
+                min: count > 0 ? min : 0,
+                max: count > 0 ? max : 0,
+                average: count > 0 ? Number((sum / count).toFixed(3)) : 0
+            }))
+        };
+        if (reset)
+            this.resetMeasurements();
+        return snapshot;
+    }
+    reset() {
+        this.counters.clear();
+        this.gauges.clear();
+        this.histograms.clear();
+        this.droppedSeries = 0;
+    }
+    resetMeasurements() {
+        this.counters.clear();
+        this.histograms.clear();
+        this.droppedSeries = 0;
+    }
+    getOrCreateSeries(store, name, labels, defaults) {
+        const safeName = normalizeMetricName(name);
+        if (!safeName)
+            return undefined;
+        const safeLabels = normalizeLabels(labels, this.maxLabels);
+        const key = createSeriesKey(safeName, safeLabels);
+        const current = store.get(key);
+        if (current)
+            return current;
+        if (this.totalSeries >= this.maxSeries) {
+            this.droppedSeries = Math.min(Number.MAX_SAFE_INTEGER, this.droppedSeries + 1);
+            return undefined;
+        }
+        const series = {
+            name: safeName,
+            labels: safeLabels,
+            ...defaults
+        };
+        store.set(key, series);
+        return series;
+    }
+    get totalSeries() {
+        return this.counters.size + this.gauges.size + this.histograms.size;
+    }
+}
+exports.ObservabilityRegistry = ObservabilityRegistry;
+exports.Observability = new ObservabilityRegistry();
+exports.default = exports.Observability;
+function normalizeMetricName(value) {
+    return String(value || '')
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_.:-]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .slice(0, MAX_NAME_LENGTH);
+}
+function normalizeLabels(labels, maxLabels) {
+    const output = {};
+    const entries = Object.entries(labels)
+        .filter(([key, value]) => value !== undefined && value !== null && !SENSITIVE_LABEL_PATTERN.test(key))
+        .sort(([left], [right]) => left.localeCompare(right))
+        .slice(0, maxLabels);
+    for (const [key, value] of entries) {
+        const safeKey = normalizeMetricName(key);
+        if (!safeKey || SENSITIVE_LABEL_PATTERN.test(safeKey))
+            continue;
+        output[safeKey] = typeof value === 'string'
+            ? value.slice(0, MAX_LABEL_VALUE_LENGTH)
+            : typeof value === 'number'
+                ? Number.isFinite(value) ? value : 0
+                : value;
+    }
+    return output;
+}
+function createSeriesKey(name, labels) {
+    return `${name}:${JSON.stringify(labels)}`;
+}
+function normalizeCorrelationId(value) {
+    const normalized = String(value || '').trim();
+    if (/^[a-zA-Z0-9._:-]{8,100}$/.test(normalized))
+        return normalized;
+    return (0, node_crypto_1.randomUUID)();
+}
+function boundedNumber(value) {
+    return Math.max(-Number.MAX_SAFE_INTEGER, Math.min(Number.MAX_SAFE_INTEGER, value));
+}
+function clampInteger(value, minimum, maximum, fallback) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    return Math.max(minimum, Math.min(maximum, Math.floor(parsed)));
+}
+//# sourceMappingURL=Observability.js.map

package/dist/Shared/Observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Observability.js","sourceRoot":"","sources":["../../src/Shared/Observability.ts"],"names":[],"mappings":"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"}

package/dist/Shared/Plugin.d.ts

@@ -1,5 +1,5 @@
 import { Bot } from './Client';
-export interface LibsPlugin {
+export interface NeutrunPlugin {
     name: string;
     onPreLogin?: (client: Bot) => Promise<void> | void;
     onReady?: (client: Bot) => Promise<void> | void;

package/dist/Shared/Plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/Shared/Plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAClD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC/C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAClD"}
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/Shared/Plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAClD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC/C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAClD"}

package/dist/Shared/Pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pool.d.ts","sourceRoot":"","sources":["../../src/Shared/Pool.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,UAAU,GAAI,aAAa,MAAM,MAU7B,CAAC,EAAE,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAc5C,CAAA;AAED,eAAe,UAAU,CAAA"}
+{"version":3,"file":"Pool.d.ts","sourceRoot":"","sources":["../../src/Shared/Pool.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,UAAU,GAAI,aAAa,MAAM,MAa7B,CAAC,EAAE,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAc5C,CAAA;AAED,eAAe,UAAU,CAAA"}

package/dist/Shared/Pool.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const CreatePool = (concurrency) => {
+    if (!Number.isInteger(concurrency) || concurrency <= 0) {
+        throw new RangeError('A concorrência do pool precisa ser um inteiro positivo.');
+    }
     let Active = 0;
     const Queue = [];
     const Next = () => {

package/dist/Shared/Pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"Pool.js","sourceRoot":"","sources":["../../src/Shared/Pool.ts"],"names":[],"mappings":";;AAAA,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAE,EAAE;IACzC,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,MAAM,KAAK,GAAsB,EAAE,CAAA;IAEnC,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,MAAM,IAAI,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACvD,MAAM,EAAE,CAAA;QACR,KAAK,CAAC,KAAK,EAAG,EAAE,CAAA;IAClB,CAAC,CAAA;IAED,OAAO,CAAI,EAAoB,EAAc,EAAE,CAC7C,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAA;YACb,CAAC;oBAAS,CAAC;gBACT,MAAM,EAAE,CAAA;gBACR,IAAI,EAAE,CAAA;YACR,CAAC;QACH,CAAC,CAAC,CAAA;QACF,IAAI,EAAE,CAAA;IACR,CAAC,CAAC,CAAA;AACN,CAAC,CAAA;AAED,kBAAe,UAAU,CAAA"}
+{"version":3,"file":"Pool.js","sourceRoot":"","sources":["../../src/Shared/Pool.ts"],"names":[],"mappings":";;AAAA,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAE,EAAE;IACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,UAAU,CAAC,yDAAyD,CAAC,CAAA;IACjF,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,MAAM,KAAK,GAAsB,EAAE,CAAA;IAEnC,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,MAAM,IAAI,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QACvD,MAAM,EAAE,CAAA;QACR,KAAK,CAAC,KAAK,EAAG,EAAE,CAAA;IAClB,CAAC,CAAA;IAED,OAAO,CAAI,EAAoB,EAAc,EAAE,CAC7C,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACpB,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,CAAA;YACb,CAAC;oBAAS,CAAC;gBACT,MAAM,EAAE,CAAA;gBACR,IAAI,EAAE,CAAA;YACR,CAAC;QACH,CAAC,CAAC,CAAA;QACF,IAAI,EAAE,CAAA;IACR,CAAC,CAAC,CAAA;AACN,CAAC,CAAA;AAED,kBAAe,UAAU,CAAA"}

package/dist/Shared/ProcessManager.d.ts

@@ -3,8 +3,9 @@ declare class ProcessManagerImpl {
     private isShuttingDown;
     private cleanupTasks;
     private initialized;
-    registerCleanupTask(task: CleanupTask): void;
+    registerCleanupTask(task: CleanupTask, name?: string): () => void;
     init(): void;
+    private shutdown;
 }
 declare const ProcessManager: ProcessManagerImpl;
 export default ProcessManager;

package/dist/Shared/ProcessManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProcessManager.d.ts","sourceRoot":"","sources":["../../src/Shared/ProcessManager.ts"],"names":[],"mappings":"AAGA,KAAK,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAE7C,cAAM,kBAAkB;IACtB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,WAAW,CAAQ;IAEpB,mBAAmB,CAAC,IAAI,EAAE,WAAW;IAIrC,IAAI;CA4DZ;AAED,QAAA,MAAM,cAAc,oBAA2B,CAAA;AAC/C,eAAe,cAAc,CAAA"}
+{"version":3,"file":"ProcessManager.d.ts","sourceRoot":"","sources":["../../src/Shared/ProcessManager.ts"],"names":[],"mappings":"AAGA,KAAK,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAU7C,cAAM,kBAAkB;IACtB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,WAAW,CAAQ;IAEpB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,SAAY,GAAG,MAAM,IAAI;IAUpE,IAAI,IAAI,IAAI;YA0BL,QAAQ;CAoDvB;AAoBD,QAAA,MAAM,cAAc,oBAA2B,CAAA;AAC/C,eAAe,cAAc,CAAA"}

package/dist/Shared/ProcessManager.js

@@ -2,12 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const ConsoleLog_1 = require("./ConsoleLog");
 const Supervisor_1 = require("./Supervisor");
+const CLEANUP_TASK_TIMEOUT_MS = 10_000;
+const SHUTDOWN_TIMEOUT_MS = 30_000;
 class ProcessManagerImpl {
     isShuttingDown = false;
-    cleanupTasks = [];
+    cleanupTasks = new Set();
     initialized = false;
-    registerCleanupTask(task) {
-        this.cleanupTasks.push(task);
+    registerCleanupTask(task, name = 'cleanup') {
+        if (typeof task !== 'function') {
+            throw new TypeError('A tarefa de encerramento precisa ser uma função.');
+        }
+        const entry = { task, name: name.trim() || 'cleanup' };
+        this.cleanupTasks.add(entry);
+        return () => this.cleanupTasks.delete(entry);
     }
     init() {
         if (this.initialized)
@@ -18,39 +25,62 @@ class ProcessManagerImpl {
             if ((0, Supervisor_1.isHandoffError)(error))
                 return;
             (0, ConsoleLog_1.logError)(`Uncaught Exception: ${error.stack || error.message}`, 'ProcessManager');
+            void this.shutdown('uncaughtException', 1, false);
         });
         process.on('unhandledRejection', (reason) => {
             (0, ConsoleLog_1.logError)(`Unhandled Rejection: ${reason?.stack || reason?.message || reason}`, 'ProcessManager');
+            void this.shutdown('unhandledRejection', 1, false);
         });
-        const handleShutdown = async (signal) => {
-            if (this.isShuttingDown)
-                return;
-            this.isShuttingDown = true;
-            (0, ConsoleLog_1.logWarn)(`Sinal ${signal} recebido. Iniciando Graceful Shutdown...`, 'ProcessManager');
-            try {
-                for (const task of [...this.cleanupTasks]) {
-                    try {
-                        await task();
-                    }
-                    catch (error) {
-                        (0, ConsoleLog_1.logError)(`Erro durante o Graceful Shutdown: ${error?.stack || error?.message || error}`, 'ProcessManager');
-                    }
-                }
-                (0, ConsoleLog_1.logSuccess)('Todas as tarefas de encerramento foram concluídas. Processo finalizado.', 'ProcessManager');
-                // Avisa o supervisor que o shutdown foi pedido — não é morte.
+        process.on('SIGINT', () => void this.shutdown('SIGINT', 0, true));
+        process.on('SIGTERM', () => void this.shutdown('SIGTERM', 0, true));
+    }
+    async shutdown(reason, requestedExitCode, intentional) {
+        if (this.isShuttingDown)
+            return;
+        this.isShuttingDown = true;
+        (0, ConsoleLog_1.logWarn)(`${intentional ? 'Sinal' : 'Falha fatal'} ${reason} recebido. Iniciando Graceful Shutdown...`, 'ProcessManager');
+        const forceExitTimer = setTimeout(() => {
+            (0, ConsoleLog_1.logError)(`Graceful Shutdown excedeu ${SHUTDOWN_TIMEOUT_MS}ms; encerrando o processo.`, 'ProcessManager');
+            if (intentional)
                 (0, Supervisor_1.notifyIntentionalStop)();
-                process.exit(0);
+            process.exit(requestedExitCode || 1);
+        }, SHUTDOWN_TIMEOUT_MS);
+        let cleanupFailed = false;
+        const tasks = Array.from(this.cleanupTasks).reverse();
+        for (const { task, name } of tasks) {
+            try {
+                await withTimeout(Promise.resolve().then(task), CLEANUP_TASK_TIMEOUT_MS, `Tarefa de encerramento "${name}" excedeu ${CLEANUP_TASK_TIMEOUT_MS}ms.`);
             }
             catch (error) {
-                (0, ConsoleLog_1.logError)(`Erro durante o Graceful Shutdown: ${error.stack || error.message}`, 'ProcessManager');
-                (0, Supervisor_1.notifyIntentionalStop)();
-                process.exit(0);
+                cleanupFailed = true;
+                (0, ConsoleLog_1.logError)(`Erro ao encerrar ${name}: ${error?.stack || error?.message || error}`, 'ProcessManager');
             }
-        };
-        process.on('SIGINT', () => handleShutdown('SIGINT'));
-        process.on('SIGTERM', () => handleShutdown('SIGTERM'));
+        }
+        clearTimeout(forceExitTimer);
+        if (!cleanupFailed) {
+            (0, ConsoleLog_1.logSuccess)('Todas as tarefas de encerramento foram concluídas. Processo finalizado.', 'ProcessManager');
+        }
+        // Apenas sinais administrativos impedem o supervisor de reiniciar.
+        if (intentional)
+            (0, Supervisor_1.notifyIntentionalStop)();
+        process.exit(cleanupFailed ? 1 : requestedExitCode);
     }
 }
+const withTimeout = async (promise, timeoutMs, message) => {
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => reject(new Error(message)), timeoutMs);
+            })
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+};
 const ProcessManager = new ProcessManagerImpl();
 exports.default = ProcessManager;
 //# sourceMappingURL=ProcessManager.js.map

package/dist/Shared/ProcessManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProcessManager.js","sourceRoot":"","sources":["../../src/Shared/ProcessManager.ts"],"names":[],"mappings":";;AAAA,6CAA4D;AAC5D,6CAAoE;AAIpE,MAAM,kBAAkB;IACd,cAAc,GAAG,KAAK,CAAA;IACtB,YAAY,GAAkB,EAAE,CAAA;IAChC,WAAW,GAAG,KAAK,CAAA;IAEpB,mBAAmB,CAAC,IAAiB;QAC1C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAEM,IAAI;QACT,IAAI,IAAI,CAAC,WAAW;YAAE,OAAM;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QAEvB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,8DAA8D;YAC9D,IAAI,IAAA,2BAAc,EAAC,KAAK,CAAC;gBAAE,OAAM;YACjC,IAAA,qBAAQ,EACN,uBAAuB,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,EACrD,gBAAgB,CACjB,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAW,EAAE,EAAE;YAC/C,IAAA,qBAAQ,EACN,wBAAwB,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,OAAO,IAAI,MAAM,EAAE,EACpE,gBAAgB,CACjB,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,MAAM,cAAc,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YAC9C,IAAI,IAAI,CAAC,cAAc;gBAAE,OAAM;YAC/B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;YAE1B,IAAA,oBAAO,EACL,SAAS,MAAM,2CAA2C,EAC1D,gBAAgB,CACjB,CAAA;YAED,IAAI,CAAC;gBACH,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC1C,IAAI,CAAC;wBACH,MAAM,IAAI,EAAE,CAAA;oBACd,CAAC;oBAAC,OAAO,KAAU,EAAE,CAAC;wBACpB,IAAA,qBAAQ,EACN,qCAAqC,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,KAAK,EAAE,EAC9E,gBAAgB,CACjB,CAAA;oBACH,CAAC;gBACH,CAAC;gBACD,IAAA,uBAAU,EACR,yEAAyE,EACzE,gBAAgB,CACjB,CAAA;gBACD,8DAA8D;gBAC9D,IAAA,kCAAqB,GAAE,CAAA;gBACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,IAAA,qBAAQ,EACN,qCAAqC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,EACnE,gBAAgB,CACjB,CAAA;gBACD,IAAA,kCAAqB,GAAE,CAAA;gBACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;QACH,CAAC,CAAA;QAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAA;QACpD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAA;IACxD,CAAC;CACF;AAED,MAAM,cAAc,GAAG,IAAI,kBAAkB,EAAE,CAAA;AAC/C,kBAAe,cAAc,CAAA"}
+{"version":3,"file":"ProcessManager.js","sourceRoot":"","sources":["../../src/Shared/ProcessManager.ts"],"names":[],"mappings":"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"}

package/dist/Shared/QueueManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueueManager.d.ts","sourceRoot":"","sources":["../../src/Shared/QueueManager.ts"],"names":[],"mappings":"AA+DA,QAAA,MAAM,YAAY;cA7BD,CAAC,OAAO,MAAM,QAAQ,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC;;;;;CAgCnE,CAAA;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"QueueManager.d.ts","sourceRoot":"","sources":["../../src/Shared/QueueManager.ts"],"names":[],"mappings":"AAkFA,QAAA,MAAM,YAAY;cA5CD,CAAC,OAAO,MAAM,QAAQ,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC;;;;;CA+CnE,CAAA;AAED,eAAe,YAAY,CAAA"}

package/dist/Shared/QueueManager.js

@@ -6,6 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // ────────────────────────────────────────────────────────────────────────────────
 const ConsoleLog_1 = require("./ConsoleLog");
 const Color_1 = __importDefault(require("../Logger/Color"));
+const MAX_QUEUE_KEYS = 10_000;
+const MAX_WAITING_PER_QUEUE = 1_000;
+const MAX_QUEUE_KEY_LENGTH = 200;
 const queues = new Map();
 const running = new Set();
 const processQueue = async (key) => {
@@ -15,21 +18,36 @@ const processQueue = async (key) => {
     if (!queue || queue.length === 0)
         return;
     running.add(key);
-    while (queue.length > 0) {
-        const task = queue.shift();
-        if (task) {
-            try {
-                await task();
-            }
-            catch (error) {
-                (0, ConsoleLog_1.logError)(`Erro ao executar tarefa na fila ${(0, Color_1.default)(key, 'cyan', 'bold')}: ${error}`);
+    try {
+        while (queue.length > 0) {
+            const task = queue.shift();
+            if (task) {
+                try {
+                    await task();
+                }
+                catch (error) {
+                    (0, ConsoleLog_1.logError)(`Erro ao executar tarefa na fila ${(0, Color_1.default)(key, 'cyan', 'bold')}: ${error}`);
+                }
             }
         }
     }
-    running.delete(key);
-    queues.delete(key);
+    finally {
+        running.delete(key);
+        if (queue.length === 0)
+            queues.delete(key);
+    }
 };
 const enqueue = (key, task) => {
+    const normalizedKey = String(key || '').trim();
+    if (!normalizedKey || normalizedKey.length > MAX_QUEUE_KEY_LENGTH) {
+        return Promise.reject(new TypeError(`A chave da fila deve ter entre 1 e ${MAX_QUEUE_KEY_LENGTH} caracteres.`));
+    }
+    if (typeof task !== 'function') {
+        return Promise.reject(new TypeError('A tarefa da fila precisa ser uma função.'));
+    }
+    if (!queues.has(normalizedKey) && queues.size >= MAX_QUEUE_KEYS) {
+        return Promise.reject(new RangeError('O limite de filas simultâneas foi atingido.'));
+    }
     return new Promise((resolve, reject) => {
         const wrappedTask = async () => {
             try {
@@ -40,10 +58,14 @@ const enqueue = (key, task) => {
                 reject(error);
             }
         };
-        const queue = queues.get(key) || [];
+        const queue = queues.get(normalizedKey) || [];
+        if (queue.length >= MAX_WAITING_PER_QUEUE) {
+            reject(new RangeError(`A fila "${normalizedKey}" atingiu o limite de espera.`));
+            return;
+        }
         queue.push(wrappedTask);
-        queues.set(key, queue);
-        processQueue(key);
+        queues.set(normalizedKey, queue);
+        void processQueue(normalizedKey);
     });
 };
 // ────────────────────────────────────────────────────────────────────────────────

package/dist/Shared/QueueManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueueManager.js","sourceRoot":"","sources":["../../src/Shared/QueueManager.ts"],"names":[],"mappings":";;;;;AAAA,mFAAmF;AACnF,6CAAuC;AACvC,4DAAmC;AAKnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAA;AAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;AAEjC,MAAM,YAAY,GAAG,KAAK,EAAE,GAAW,EAAE,EAAE;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAM;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAExC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAEhB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;QAC1B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,IAAI,EAAE,CAAA;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAA,qBAAQ,EACN,mCAAmC,IAAA,eAAK,EAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,KAAK,EAAE,CAC1E,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACnB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AACpB,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,CAAI,GAAW,EAAE,IAAsB,EAAc,EAAE;IACrE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAA;gBAC3B,OAAO,CAAC,MAAM,CAAC,CAAA;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAA;YACf,CAAC;QACH,CAAC,CAAA;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;QACnC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAEtB,YAAY,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,mFAAmF;AACnF,MAAM,KAAK,GAAG,GAAG,EAAE;IACjB,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,IAAI,KAAK,CAAC,MAAM,CAAA;IAC5D,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,IAAI;QACpB,OAAO;KACR,CAAA;AACH,CAAC,CAAA;AAED,MAAM,YAAY,GAAG;IACnB,OAAO;IACP,KAAK;CACN,CAAA;AAED,kBAAe,YAAY,CAAA;AAC3B,mFAAmF"}
+{"version":3,"file":"QueueManager.js","sourceRoot":"","sources":["../../src/Shared/QueueManager.ts"],"names":[],"mappings":"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"}

package/dist/Shared/RoleLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RoleLoader.d.ts","sourceRoot":"","sources":["../../src/Shared/RoleLoader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,cAAc,EAAY,MAAM,sBAAsB,CAAA;AA6GzE,QAAA,MAAM,SAAS,GAAU,QAAQ,cAAc,CAAC,GAAG,CAAC,KAAG,OAAO,CAAC,IAAI,CAiDlE,CAAA;AAGD,eAAe,SAAS,CAAA"}
+{"version":3,"file":"RoleLoader.d.ts","sourceRoot":"","sources":["../../src/Shared/RoleLoader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,cAAc,EAAY,MAAM,sBAAsB,CAAA;AAuHzE,QAAA,MAAM,SAAS,GAAU,QAAQ,cAAc,CAAC,GAAG,CAAC,KAAG,OAAO,CAAC,IAAI,CAoDlE,CAAA;AAGD,eAAe,SAAS,CAAA"}

package/dist/Shared/RoleLoader.js

@@ -17,7 +17,7 @@ const FormatKey = (name) => {
 };
 const QuoteName = (name) => {
     if (NeedsQuoting(name))
-        return `'${name}'`;
+        return JSON.stringify(name);
     return name;
 };
 const GenerateRolesFile = (rolesData) => {
@@ -29,7 +29,7 @@ const GenerateRolesFile = (rolesData) => {
     const Names = Object.keys(rolesData).sort();
     const Lines = [];
     Lines.push("import type { RoleData } from '@ninenity/neutrun'");
-    Lines.push("import { Bot } from '@ninenity/neutrun'");
+    Lines.push("import { Neutrun } from '@ninenity/neutrun'");
     Lines.push('');
     Lines.push('export interface AppRoles {');
     for (const Name of Names) {
@@ -43,12 +43,12 @@ const GenerateRolesFile = (rolesData) => {
         const SafeName = FormatKey(Name);
         const Role = rolesData[Name];
         Lines.push(`  ${QuoteName(SafeName)}: {`);
-        Lines.push(`    Id: '${Role.Id}',`);
-        Lines.push(`    Name: '${Role.Name.replace(/'/g, "\\'")}',`);
+        Lines.push(`    Id: ${JSON.stringify(String(Role.Id))},`);
+        Lines.push(`    Name: ${JSON.stringify(String(Role.Name))},`);
         Lines.push(`    Color: ${Role.Color},`);
         Lines.push(`    Position: ${Role.Position},`);
-        Lines.push(`    Mention: '${Role.Mention}',`);
-        Lines.push(`    toString: () => '${Role.Mention}'`);
+        Lines.push(`    Mention: ${JSON.stringify(String(Role.Mention))},`);
+        Lines.push(`    toString: () => ${JSON.stringify(String(Role.Mention))}`);
         Lines.push('  },');
     }
     Lines.push('}');
@@ -56,7 +56,7 @@ const GenerateRolesFile = (rolesData) => {
     Lines.push('const Roles = new Proxy(FallbackRoles, {');
     Lines.push('  get(target, prop, receiver) {');
     Lines.push("    if (typeof prop === 'symbol') return Reflect.get(target, prop, receiver)");
-    Lines.push('    const scoped = Bot.Instance?.getAppRoles?.() as AppRoles | undefined');
+    Lines.push('    const scoped = Neutrun.bot.getAppRoles?.() as AppRoles | undefined');
     Lines.push('    if (scoped && scoped !== target) return Reflect.get(scoped, prop, scoped)');
     Lines.push('    return Reflect.get(target, prop, receiver)');
     Lines.push('  }');
@@ -64,7 +64,18 @@ const GenerateRolesFile = (rolesData) => {
     Lines.push('');
     Lines.push('export default Roles');
     Lines.push('export type RoleName = keyof AppRoles');
-    fs_1.default.writeFileSync(FilePath, Lines.join('\n'), 'utf-8');
+    WriteGeneratedFile(FilePath, Lines.join('\n'));
+};
+const WriteGeneratedFile = (file, content) => {
+    const temporaryPath = `${file}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        fs_1.default.writeFileSync(temporaryPath, content, 'utf-8');
+        fs_1.default.renameSync(temporaryPath, file);
+    }
+    finally {
+        if (fs_1.default.existsSync(temporaryPath))
+            fs_1.default.unlinkSync(temporaryPath);
+    }
 };
 // ────────────────────────────────────────────────────────────────────────────────
 const CreateEmptyRole = (key) => ({
@@ -110,6 +121,9 @@ const LoadRoles = async (client) => {
                     Mention: `<@&${Role.id}>`,
                     toString: () => `<@&${Role.id}>`
                 };
+                if (GuildRolesData[Key]?.Id !== undefined && GuildRolesData[Key].Id !== Role.id) {
+                    (0, ConsoleLog_1.logWarn)(`Cargos com o mesmo alias "${Key}" em ${Guild.name}; o último será usado.`, 'Loader');
+                }
                 GuildRolesData[Key] = roleData;
                 // Preserve the generated flat file and access path. It is
                 // only used when there is no active guild context.