@ninenity/neutrun 1.0.0

package/dist/Shared/RoleLoader.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// ────────────────────────────────────────────────────────────────────────────────
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ConsoleLog_1 = require("./ConsoleLog");
+const Color_1 = __importDefault(require("../Logger/Color"));
+const Neutrun_1 = __importDefault(require("./Neutrun"));
+const InteractionContext_1 = require("./InteractionContext");
+// ────────────────────────────────────────────────────────────────────────────────
+const NeedsQuoting = (name) => /^[0-9]|[^a-zA-Z0-9_]/.test(name);
+const FormatKey = (name) => {
+    return name.toLowerCase().replace(/[\s-]+/g, '_');
+};
+const QuoteName = (name) => {
+    if (NeedsQuoting(name))
+        return `'${name}'`;
+    return name;
+};
+const GenerateRolesFile = (rolesData) => {
+    const FilePath = Neutrun_1.default.getGeneratedPath('Roles.ts');
+    const OutputDir = path_1.default.dirname(FilePath);
+    if (!fs_1.default.existsSync(OutputDir)) {
+        fs_1.default.mkdirSync(OutputDir, { recursive: true });
+    }
+    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('');
+    Lines.push('export interface AppRoles {');
+    for (const Name of Names) {
+        const SafeName = FormatKey(Name);
+        Lines.push(`  readonly ${QuoteName(SafeName)}: RoleData`);
+    }
+    Lines.push('}');
+    Lines.push('');
+    Lines.push('const FallbackRoles: AppRoles = {');
+    for (const Name of Names) {
+        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(`    Color: ${Role.Color},`);
+        Lines.push(`    Position: ${Role.Position},`);
+        Lines.push(`    Mention: '${Role.Mention}',`);
+        Lines.push(`    toString: () => '${Role.Mention}'`);
+        Lines.push('  },');
+    }
+    Lines.push('}');
+    Lines.push('');
+    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('    if (scoped && scoped !== target) return Reflect.get(scoped, prop, scoped)');
+    Lines.push('    return Reflect.get(target, prop, receiver)');
+    Lines.push('  }');
+    Lines.push('}) as AppRoles');
+    Lines.push('');
+    Lines.push('export default Roles');
+    Lines.push('export type RoleName = keyof AppRoles');
+    fs_1.default.writeFileSync(FilePath, Lines.join('\n'), 'utf-8');
+};
+// ────────────────────────────────────────────────────────────────────────────────
+const CreateEmptyRole = (key) => ({
+    Id: '',
+    Name: key,
+    Color: 0,
+    Position: 0,
+    Mention: '',
+    toString: () => ''
+});
+const CreateRolesProxy = (fallback, byGuild) => new Proxy(fallback, {
+    get(target, prop) {
+        if (typeof prop === 'symbol')
+            return target[prop];
+        const guildId = (0, InteractionContext_1.GetGuildId)();
+        const scoped = guildId ? byGuild[guildId] : undefined;
+        // A known interaction must never fall back to another guild's alias.
+        const source = guildId ? scoped || {} : target;
+        const key = FormatKey(String(prop));
+        if (key in source)
+            return source[key];
+        if (String(prop) in source)
+            return source[String(prop)];
+        return CreateEmptyRole(key);
+    }
+});
+const LoadRoles = async (client) => {
+    const RolesData = {};
+    const RolesByGuild = {};
+    for (const [GuildId, Guild] of client.guilds.cache) {
+        const GuildRolesData = {};
+        try {
+            await Guild.roles.fetch();
+            for (const [_, Role] of Guild.roles.cache) {
+                if (Role.name === '@everyone')
+                    continue;
+                const Key = FormatKey(Role.name);
+                const roleData = {
+                    Id: Role.id,
+                    Name: Role.name,
+                    Color: Role.color,
+                    Position: Role.position,
+                    Mention: `<@&${Role.id}>`,
+                    toString: () => `<@&${Role.id}>`
+                };
+                GuildRolesData[Key] = roleData;
+                // Preserve the generated flat file and access path. It is
+                // only used when there is no active guild context.
+                RolesData[Key] = roleData;
+            }
+            RolesByGuild[String(GuildId)] = GuildRolesData;
+            const Total = Object.keys(GuildRolesData).length;
+            if (Total > 0) {
+                (0, ConsoleLog_1.logSuccess)(`${(0, Color_1.default)(String(Total), 'cyan', 'bold')} cargos indexados`, 'Loader');
+            }
+        }
+        catch (error) {
+            (0, ConsoleLog_1.logError)(`Erro ao indexar cargos em ${Guild.name}`);
+        }
+    }
+    GenerateRolesFile(RolesData);
+    client.appRolesByGuild = Object.fromEntries(Object.entries(RolesByGuild).map(([guildId, roles]) => [
+        guildId,
+        CreateRolesProxy(roles, { [guildId]: roles })
+    ]));
+    client.appRoles = CreateRolesProxy(RolesData, RolesByGuild);
+};
+// ────────────────────────────────────────────────────────────────────────────────
+exports.default = LoadRoles;
+// ────────────────────────────────────────────────────────────────────────────────
+//# sourceMappingURL=RoleLoader.js.map

package/dist/Shared/RoleLoader.js.map

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

package/dist/Shared/Supervisor.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Supervisor de processo: o objetivo é que o bot NUNCA morra.
+ *
+ * Quando ativo, `Neutrun.init` transforma o processo atual em um supervisor
+ * fino e executa o bot em um processo filho idêntico. Se o filho morrer —
+ * crash, OOM, exit não intencional — o supervisor o reinicia com backoff
+ * exponencial e trava de crash-loop. O filho, por sua vez, reporta heartbeats
+ * (um event loop travado é detectado e morto) e roda watchdogs de gateway e
+ * de memória que escalonam para um restart limpo antes da morte real.
+ */
+export declare const SUPERVISED_ENV = "NEUTRUN_SUPERVISED";
+export declare const NO_SUPERVISOR_ENV = "NEUTRUN_NO_SUPERVISOR";
+/** Código de saída que significa "quero reiniciar limpo". */
+export declare const RESTART_EXIT_CODE = 75;
+export interface SupervisorOptions {
+    /** Liga/desliga explicitamente (default: só em produção). */
+    enabled?: boolean;
+    /** Teto de reinícios por hora antes de desistir (trava de crash-loop). */
+    maxRestartsPerHour?: number;
+    /** Base do backoff exponencial entre reinícios. */
+    backoffBaseMs?: number;
+    /** Teto do backoff entre reinícios. */
+    backoffMaxMs?: number;
+    /** Tempo de estabilidade que zera o backoff. */
+    stableResetMs?: number;
+    /** Intervalo do heartbeat do filho (0 desliga o detector de hang). */
+    heartbeatMs?: number;
+    /** Sem heartbeat por este tempo = processo travado → kill + restart. */
+    heartbeatTimeoutMs?: number;
+    /** Reinicia o processo quando o RSS exceder este limite (0 desliga). */
+    memoryLimitMB?: number;
+    /** Gateway continuamente desconectado por este tempo → restart limpo. */
+    gatewayDeadThresholdMs?: number;
+}
+/** Erro que interrompe o fluxo do entry no processo pai. */
+export declare class SupervisedParentHandoff extends Error {
+    readonly neutrunSupervisorHandoff = true;
+    constructor();
+}
+export declare const isHandoffError: (error: unknown) => boolean;
+export declare const resolveSupervisorEnabled: (options: SupervisorOptions | boolean | undefined, env?: NodeJS.ProcessEnv) => boolean;
+export declare const computeBackoffDelay: (restartCount: number, options?: SupervisorOptions) => number;
+export declare const isRestartCapped: (restartTimestamps: number[], maxRestartsPerHour?: number, now?: number) => boolean;
+export declare const shouldRespawn: (intentionalStop: boolean, exitCode: number | null, restartTimestamps: number[], maxRestartsPerHour?: number) => boolean;
+/** Avisa o supervisor que o shutdown é intencional (não reiniciar). */
+export declare const notifyIntentionalStop: () => void;
+/**
+ * Executado no início do `Neutrun.init`. Retorna `true` quando o processo
+ * atual virou o supervisor (e o bot já está rodando no filho) — nesse caso o
+ * init interrompe o fluxo do entry com SupervisedParentHandoff.
+ */
+export declare const maybeFork: (options?: SupervisorOptions | boolean) => boolean;
+/** Interrompe o fluxo do entry no processo pai (o bot roda no filho). */
+export declare const throwParentHandoff: () => never;
+export declare const Supervisor: {
+    maybeFork: (options?: SupervisorOptions | boolean) => boolean;
+    throwParentHandoff: () => never;
+    startChildDuties: (raw?: SupervisorOptions | boolean) => void;
+    notifyIntentionalStop: () => void;
+    resolveSupervisorEnabled: (options: SupervisorOptions | boolean | undefined, env?: NodeJS.ProcessEnv) => boolean;
+    computeBackoffDelay: (restartCount: number, options?: SupervisorOptions) => number;
+    isRestartCapped: (restartTimestamps: number[], maxRestartsPerHour?: number, now?: number) => boolean;
+    shouldRespawn: (intentionalStop: boolean, exitCode: number | null, restartTimestamps: number[], maxRestartsPerHour?: number) => boolean;
+    isHandoffError: (error: unknown) => boolean;
+};
+export default Supervisor;
+//# sourceMappingURL=Supervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Supervisor.d.ts","sourceRoot":"","sources":["../../src/Shared/Supervisor.ts"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AAEH,eAAO,MAAM,cAAc,uBAAuB,CAAA;AAClD,eAAO,MAAM,iBAAiB,0BAA0B,CAAA;AACxD,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAkBD,4DAA4D;AAC5D,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,wBAAwB,QAAO;;CAOhD;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,OACG,CAAA;AAMnD,eAAO,MAAM,wBAAwB,GACnC,SAAS,iBAAiB,GAAG,OAAO,GAAG,SAAS,EAChD,MAAK,MAAM,CAAC,UAAwB,KACnC,OASF,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,cAAc,MAAM,EACpB,UAAU,iBAAiB,KAC1B,MAMF,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,mBAAmB,MAAM,EAAE,EAC3B,qBAAoB,MAAoC,EACxD,MAAK,MAAmB,KACvB,OAGF,CAAA;AAED,eAAO,MAAM,aAAa,GACxB,iBAAiB,OAAO,EACxB,UAAU,MAAM,GAAG,IAAI,EACvB,mBAAmB,MAAM,EAAE,EAC3B,qBAAqB,MAAM,KAC1B,OAQF,CAAA;AA4GD,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,QAAO,IAExC,CAAA;AAyFD;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,iBAAiB,GAAG,OAAO,KACpC,OAcF,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,QAAO,KAErC,CAAA;AAED,eAAO,MAAM,UAAU;0BAtBX,iBAAiB,GAAG,OAAO,KACpC,OAAO;8BAiB4B,KAAK;6BAlGX,iBAAiB,GAAG,OAAO,KAAG,IAAI;iCAjBzB,IAAI;wCA3JlC,iBAAiB,GAAG,OAAO,GAAG,SAAS,QAC3C,MAAM,CAAC,UAAU,KACrB,OAAO;wCAYM,MAAM,YACV,iBAAiB,KAC1B,MAAM;yCASY,MAAM,EAAE,uBACP,MAAM,QACrB,MAAM,KACV,OAAO;qCAMS,OAAO,YACd,MAAM,GAAG,IAAI,qBACJ,MAAM,EAAE,uBACN,MAAM,KAC1B,OAAO;4BA9C4B,OAAO,KAAG,OAAO;CAoStD,CAAA;AAED,eAAe,UAAU,CAAA"}

package/dist/Shared/Supervisor.js

@@ -0,0 +1,308 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Supervisor = exports.throwParentHandoff = exports.maybeFork = exports.notifyIntentionalStop = exports.shouldRespawn = exports.isRestartCapped = exports.computeBackoffDelay = exports.resolveSupervisorEnabled = exports.isHandoffError = exports.SupervisedParentHandoff = exports.RESTART_EXIT_CODE = exports.NO_SUPERVISOR_ENV = exports.SUPERVISED_ENV = void 0;
+// --------------------------------------------------------------------------------
+const node_child_process_1 = require("node:child_process");
+const discord_js_1 = require("discord.js");
+const EventBus_1 = __importDefault(require("./EventBus"));
+const ConsoleLog_1 = require("./ConsoleLog");
+// --------------------------------------------------------------------------------
+/**
+ * Supervisor de processo: o objetivo é que o bot NUNCA morra.
+ *
+ * Quando ativo, `Neutrun.init` transforma o processo atual em um supervisor
+ * fino e executa o bot em um processo filho idêntico. Se o filho morrer —
+ * crash, OOM, exit não intencional — o supervisor o reinicia com backoff
+ * exponencial e trava de crash-loop. O filho, por sua vez, reporta heartbeats
+ * (um event loop travado é detectado e morto) e roda watchdogs de gateway e
+ * de memória que escalonam para um restart limpo antes da morte real.
+ */
+exports.SUPERVISED_ENV = 'NEUTRUN_SUPERVISED';
+exports.NO_SUPERVISOR_ENV = 'NEUTRUN_NO_SUPERVISOR';
+/** Código de saída que significa "quero reiniciar limpo". */
+exports.RESTART_EXIT_CODE = 75;
+const DEFAULTS = {
+    maxRestartsPerHour: 12,
+    backoffBaseMs: 1_000,
+    backoffMaxMs: 60_000,
+    stableResetMs: 5 * 60_000,
+    heartbeatMs: 30_000,
+    heartbeatTimeoutMs: 120_000,
+    memoryLimitMB: 0,
+    gatewayDeadThresholdMs: 5 * 60_000
+};
+const normalizeOptions = (options) => ({ ...DEFAULTS, ...options });
+/** Erro que interrompe o fluxo do entry no processo pai. */
+class SupervisedParentHandoff extends Error {
+    neutrunSupervisorHandoff = true;
+    constructor() {
+        super('Neutrun Supervisor: este processo agora supervisiona o filho — a execução do bot segue no processo filho.');
+        this.name = 'SupervisedParentHandoff';
+    }
+}
+exports.SupervisedParentHandoff = SupervisedParentHandoff;
+const isHandoffError = (error) => error?.neutrunSupervisorHandoff === true;
+exports.isHandoffError = isHandoffError;
+// ──────────────────────────────────────────────────────────────────────────────
+// Funções puras (testáveis sem processos)
+// ──────────────────────────────────────────────────────────────────────────────
+const resolveSupervisorEnabled = (options, env = process.env) => {
+    const flag = String(env[exports.NO_SUPERVISOR_ENV] || '').trim().toLowerCase();
+    if (flag === '1' || flag === 'true')
+        return false;
+    // O filho nunca fork novamente — senão seria uma bomba de processos.
+    if (env[exports.SUPERVISED_ENV])
+        return false;
+    if (typeof options === 'boolean')
+        return options;
+    if (typeof options?.enabled === 'boolean')
+        return options.enabled;
+    const environment = String(env.NODE_ENV || env.BOT_ENV || '').toLowerCase();
+    return environment === 'production';
+};
+exports.resolveSupervisorEnabled = resolveSupervisorEnabled;
+const computeBackoffDelay = (restartCount, options) => {
+    const base = options?.backoffBaseMs ?? DEFAULTS.backoffBaseMs;
+    const max = options?.backoffMaxMs ?? DEFAULTS.backoffMaxMs;
+    const exponent = Math.min(Math.max(restartCount, 0), 6);
+    const delay = Math.min(base * 2 ** exponent, max);
+    return delay + Math.floor(Math.random() * 500);
+};
+exports.computeBackoffDelay = computeBackoffDelay;
+const isRestartCapped = (restartTimestamps, maxRestartsPerHour = DEFAULTS.maxRestartsPerHour, now = Date.now()) => {
+    const hourAgo = now - 3_600_000;
+    return restartTimestamps.filter((at) => at > hourAgo).length >= maxRestartsPerHour;
+};
+exports.isRestartCapped = isRestartCapped;
+const shouldRespawn = (intentionalStop, exitCode, restartTimestamps, maxRestartsPerHour) => {
+    if (intentionalStop)
+        return false;
+    if (exitCode === 0 && !intentionalStop) {
+        // Exit 0 sem aviso intencional é ambíguo: reiniciar por segurança —
+        // quem quer parar de fato envia o stop via IPC ou usa o exit 0 assistido.
+        return true;
+    }
+    return !(0, exports.isRestartCapped)(restartTimestamps, maxRestartsPerHour);
+};
+exports.shouldRespawn = shouldRespawn;
+// ──────────────────────────────────────────────────────────────────────────────
+// Lado pai: supervisionar
+// ──────────────────────────────────────────────────────────────────────────────
+const runParent = (options) => {
+    const restarts = [];
+    let attempt = 0;
+    let intentionalStop = false;
+    let childStartedAt = Date.now();
+    let lastHeartbeatAt = Date.now();
+    let current = null;
+    const spawnChild = () => {
+        const child = (0, node_child_process_1.spawn)(process.argv[0], process.argv.slice(1), {
+            stdio: ['inherit', 'inherit', 'inherit', 'ipc'],
+            env: { ...process.env, [exports.SUPERVISED_ENV]: '1' }
+        });
+        childStartedAt = Date.now();
+        lastHeartbeatAt = Date.now();
+        child.on('message', (message) => {
+            if (message?.type === 'neutrun:heartbeat') {
+                lastHeartbeatAt = Date.now();
+                return;
+            }
+            if (message?.type === 'neutrun:stop') {
+                intentionalStop = true;
+                (0, ConsoleLog_1.logInfo)('Desligamento intencional recebido — supervisor será encerrado.', 'Supervisor');
+            }
+        });
+        child.on('exit', (code, signal) => {
+            current = null;
+            if (intentionalStop)
+                process.exit(0);
+            // Rodou estável por tempo suficiente: o backoff volta ao início.
+            if (Date.now() - childStartedAt >= options.stableResetMs)
+                attempt = 0;
+            if ((0, exports.isRestartCapped)(restarts, options.maxRestartsPerHour)) {
+                (0, ConsoleLog_1.logError)(`Crash-loop: ${options.maxRestartsPerHour} reinícios na última hora. ` +
+                    'Supervisor encerrado — investigue os logs do bot.', 'Supervisor');
+                process.exit(70);
+            }
+            attempt += 1;
+            restarts.push(Date.now());
+            const delay = (0, exports.computeBackoffDelay)(attempt - 1, options);
+            (0, ConsoleLog_1.logWarn)(`Bot morreu (code=${code} signal=${signal}). Reiniciando em ${Math.round(delay / 100) / 10}s…`, 'Supervisor');
+            // Timer propositalmente SEM unref: entre a morte e o renascimento ele
+            // é o único responsável por manter o supervisor vivo.
+            setTimeout(() => {
+                current = spawnChild();
+            }, delay);
+        });
+        return child;
+    };
+    // Um processo vivo que para de bater heartbeats está travado (event loop
+    // bloqueado): matar e renascer é a única recuperação possível.
+    if (options.heartbeatMs > 0) {
+        setInterval(() => {
+            if (intentionalStop || !current)
+                return;
+            if (Date.now() - lastHeartbeatAt <= options.heartbeatTimeoutMs)
+                return;
+            (0, ConsoleLog_1.logWarn)('Bot sem heartbeat — processo travado será encerrado à força.', 'Supervisor');
+            try {
+                current.kill();
+            }
+            catch {
+                // O processo pode ter acabado de sair por conta própria.
+            }
+        }, Math.max(10_000, Math.floor(options.heartbeatMs / 2)));
+    }
+    // O pai não executa código de bot: erros dele são fatais e reportados.
+    process.on('uncaughtException', (error) => {
+        if ((0, exports.isHandoffError)(error))
+            return;
+        (0, ConsoleLog_1.logError)(`Supervisor com erro interno: ${error?.stack || error}`, 'Supervisor');
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        (0, ConsoleLog_1.logError)(`Supervisor com rejeição interna: ${reason?.stack || reason}`, 'Supervisor');
+        process.exit(1);
+    });
+    current = spawnChild();
+    (0, ConsoleLog_1.logInfo)('Supervisor ativo — o bot roda no processo filho supervisionado.', 'Supervisor');
+};
+// ──────────────────────────────────────────────────────────────────────────────
+// Lado filho: bater heartbeat e se auto-diagnosticar
+// ──────────────────────────────────────────────────────────────────────────────
+const notifySupervisor = (message) => {
+    try {
+        if (typeof process.send === 'function')
+            process.send(message);
+    }
+    catch {
+        // Canal IPC fechado (supervisor morto): seguir rodando sem ele.
+    }
+};
+/** Avisa o supervisor que o shutdown é intencional (não reiniciar). */
+const notifyIntentionalStop = () => {
+    notifySupervisor({ type: 'neutrun:stop' });
+};
+exports.notifyIntentionalStop = notifyIntentionalStop;
+const restartClean = (reason) => {
+    (0, ConsoleLog_1.logError)(`Reinício limpo acionado: ${reason}`, 'Supervisor');
+    EventBus_1.default.emit('supervisor:restart', { reason, at: new Date().toISOString() });
+    try {
+        // Telemetria de última hora antes de renascer (best-effort).
+        const { Telemetry } = require('./TelemetryService');
+        Telemetry.registerCounter('supervisorCleanRestarts');
+    }
+    catch {
+        // Nunca bloquear a saída por telemetria.
+    }
+    process.exit(exports.RESTART_EXIT_CODE);
+};
+const startChildDuties = (raw) => {
+    if (!process.env[exports.SUPERVISED_ENV])
+        return;
+    const options = normalizeOptions(typeof raw === 'boolean' ? {} : raw);
+    // Heartbeat: prova de vida para o supervisor.
+    if (options.heartbeatMs > 0) {
+        const timer = setInterval(() => {
+            notifySupervisor({ type: 'neutrun:heartbeat' });
+        }, options.heartbeatMs);
+        timer.unref?.();
+    }
+    // Enxame de exceções não capturadas = estado corrupto: renascer limpo é
+    // mais seguro do que seguir manco. O ProcessManager já loga cada uma.
+    const uncaughtAt = [];
+    process.on('uncaughtException', (error) => {
+        if ((0, exports.isHandoffError)(error))
+            return;
+        const now = Date.now();
+        uncaughtAt.push(now);
+        while (uncaughtAt.length > 0 && now - uncaughtAt[0] > 60_000)
+            uncaughtAt.shift();
+        if (uncaughtAt.length >= 10) {
+            restartClean('mais de 10 exceções não capturadas em 60s');
+        }
+    });
+    // Watchdogs periódicos: gateway morto e memória.
+    let gatewayDeadForMs = 0;
+    let memoryStrikes = 0;
+    setInterval(() => {
+        const CHECK_MS = 60_000;
+        try {
+            const { Bot } = require('./Client');
+            const bot = Bot.Instance;
+            // Gateway: discord.js alterna para Reconnecting ao retentar; ficar em
+            // Disconnected sem parar significa que ele desistiu sozinho.
+            if (bot && bot.ws && bot.destroyed !== true) {
+                if (bot.ws.status === discord_js_1.Status.Disconnected) {
+                    gatewayDeadForMs += CHECK_MS;
+                    if (gatewayDeadForMs >= options.gatewayDeadThresholdMs) {
+                        restartClean(`gateway desconectado por ${Math.round(gatewayDeadForMs / 1000)}s`);
+                    }
+                }
+                else {
+                    gatewayDeadForMs = 0;
+                }
+            }
+            else {
+                gatewayDeadForMs = 0;
+            }
+            // Memória: acima do limite em 3 checagens seguidas (leitura única pode
+            // ser um pico de GC legítimo).
+            if (options.memoryLimitMB > 0) {
+                const rssMB = process.memoryUsage().rss / (1024 * 1024);
+                if (rssMB > options.memoryLimitMB) {
+                    memoryStrikes += 1;
+                    if (memoryStrikes >= 3) {
+                        restartClean(`memória em ${Math.round(rssMB)}MB (limite ${options.memoryLimitMB}MB)`);
+                    }
+                }
+                else {
+                    memoryStrikes = 0;
+                }
+            }
+        }
+        catch (error) {
+            (0, ConsoleLog_1.logWarn)(`Watchdog falhou ao checar: ${error?.message || error}`, 'Supervisor');
+        }
+    }, 60_000).unref?.();
+};
+// ──────────────────────────────────────────────────────────────────────────────
+/**
+ * Executado no início do `Neutrun.init`. Retorna `true` quando o processo
+ * atual virou o supervisor (e o bot já está rodando no filho) — nesse caso o
+ * init interrompe o fluxo do entry com SupervisedParentHandoff.
+ */
+const maybeFork = (options) => {
+    if (!(0, exports.resolveSupervisorEnabled)(options))
+        return false;
+    try {
+        runParent(normalizeOptions(typeof options === 'boolean' ? {} : options));
+        return true;
+    }
+    catch (error) {
+        (0, ConsoleLog_1.logError)(`Supervisor não pôde iniciar (${error?.message || error}) — seguindo sem supervisão.`, 'Supervisor');
+        return false;
+    }
+};
+exports.maybeFork = maybeFork;
+/** Interrompe o fluxo do entry no processo pai (o bot roda no filho). */
+const throwParentHandoff = () => {
+    throw new SupervisedParentHandoff();
+};
+exports.throwParentHandoff = throwParentHandoff;
+exports.Supervisor = {
+    maybeFork: exports.maybeFork,
+    throwParentHandoff: exports.throwParentHandoff,
+    startChildDuties,
+    notifyIntentionalStop: exports.notifyIntentionalStop,
+    resolveSupervisorEnabled: exports.resolveSupervisorEnabled,
+    computeBackoffDelay: exports.computeBackoffDelay,
+    isRestartCapped: exports.isRestartCapped,
+    shouldRespawn: exports.shouldRespawn,
+    isHandoffError: exports.isHandoffError
+};
+exports.default = exports.Supervisor;
+//# sourceMappingURL=Supervisor.js.map

package/dist/Shared/Supervisor.js.map

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

package/dist/Shared/TelemetryService.d.ts

@@ -0,0 +1,63 @@
+import 'dotenv/config';
+export declare class TelemetryService {
+    private telemetryTimer;
+    private isConnected;
+    private started;
+    private lastErrorLogTime;
+    private readonly logCooldownMs;
+    private lastCpuUsage;
+    private lastCpuTime;
+    private readonly actionMap;
+    private readonly eventMap;
+    private readonly counterMap;
+    private clientReadyAt;
+    private queueWriteChain;
+    private queueFlushPromise;
+    private transportBound;
+    private getTransport;
+    private bindTransport;
+    /**
+     * Usa o transporte autenticado do Neutrun.
+     * O bot passa a ter uma única conexão para auth, config, recursos e métricas.
+     */
+    connect(): Promise<void>;
+    disconnect(): void;
+    private handleConnectionState;
+    private handleConnected;
+    /** Marca o instante do ClientReady e publica o evento no EventBus. */
+    markClientReady(): void;
+    /** Contador genérico e limitado de ocorrências (rejeições, reconexões…). */
+    registerCounter(key: string, increment?: number): void;
+    /**
+     * Agrega ocorrências de eventos (gateway Discord ou handlers customizados)
+     * com contagem, erros e duração média da última execução.
+     */
+    registerEvent(name: string, options?: {
+        error?: boolean;
+        durationMs?: number;
+    }): void;
+    private sendLiveMetrics;
+    private logConnectionFailure;
+    registerAction(type: 'slash' | 'prefix' | 'context' | 'component' | 'job' | 'event' | 'autocomplete' | 'modal', name: string, success: boolean, data: any, errorMessage?: string, durationMs?: number): void;
+    /**
+     * Fotografia do estado vivo do bot: registradores de comandos, filas,
+     * cooldowns, gateway e processo. Enviada junto de cada bulk.
+     */
+    getRuntimeSnapshot(): Record<string, unknown>;
+    private buildSystemPayload;
+    private send;
+    private startTelemetryLoop;
+    private stopTelemetryLoop;
+    private calculateCpuUsage;
+    private serializeActions;
+    private serializeEvents;
+    private fitToFrame;
+    sendTelemetryBulk(): Promise<void>;
+    private readQueue;
+    private writeQueue;
+    private queueData;
+    private sendQueuedData;
+}
+export declare const Telemetry: TelemetryService;
+export default Telemetry;
+//# sourceMappingURL=TelemetryService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryService.d.ts","sourceRoot":"","sources":["../../src/Shared/TelemetryService.ts"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAA;AAuMtB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,cAAc,CAAQ;IAE9B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,aAAa;IAarB;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,UAAU,IAAI,IAAI;YAOX,qBAAqB;YAYrB,eAAe;IAW7B,sEAAsE;IAC/D,eAAe,IAAI,IAAI;IAO9B,4EAA4E;IACrE,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,IAAI;IAYxD;;;OAGG;IACI,aAAa,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD,IAAI;YAkCO,eAAe;IAiB7B,OAAO,CAAC,oBAAoB;IASrB,cAAc,CACnB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,cAAc,GAAG,OAAO,EAC/F,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,GAAG,EACT,YAAY,CAAC,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAmDP;;;OAGG;IACI,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA6CpD,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,UAAU;IAyCL,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;YAyBjC,SAAS;YAYT,UAAU;YAeV,SAAS;YAmBT,cAAc;CAwB7B;AAED,eAAO,MAAM,SAAS,kBAAyB,CAAA;AAC/C,eAAe,SAAS,CAAA"}