@ninenity/neutrun 1.0.0

package/dist/Shared/LogTransport.js

@@ -0,0 +1,357 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogTransport = void 0;
+const crypto_1 = require("crypto");
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const Logger_1 = __importDefault(require("../Logger"));
+const MAX_QUEUE_EVENTS = 5_000;
+const MAX_BATCH_EVENTS = 50;
+const MAX_BATCH_BYTES = 48 * 1024;
+const MAX_SPOOL_EVENTS = 2_000;
+const MAX_SPOOL_BYTES = 2 * 1024 * 1024;
+const FLUSH_INTERVAL_MS = 100;
+const PERSIST_INTERVAL_MS = 1_000;
+const MAX_TEXT_LENGTH = 16_384;
+const secretEnvironmentKeys = [
+    'API_KEY',
+    'API_SECRET',
+    'BOT_TOKEN',
+    'DISCORD_TOKEN',
+    'WS_SECRET',
+    'CLIENT_SECRET'
+];
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const getConfiguredSecrets = () => {
+    const values = secretEnvironmentKeys
+        .map((key) => process.env[key]?.trim() || '')
+        .filter((value) => value.length >= 8);
+    return Array.from(new Set(values)).sort((a, b) => b.length - a.length);
+};
+const redact = (value) => {
+    let text = String(value ?? '').slice(0, MAX_TEXT_LENGTH);
+    for (const secret of getConfiguredSecrets()) {
+        try {
+            text = text.replace(new RegExp(escapeRegExp(secret), 'g'), '[REDACTED]');
+        }
+        catch {
+            // Uma credencial inválida não deve interromper o envio dos logs.
+        }
+    }
+    text = text.replace(/\bBearer\s+[^\s,;]+/gi, 'Bearer [REDACTED]');
+    text = text.replace(/\b(api[_-]?key|api[_-]?secret|bot[_-]?token|discord[_-]?token|authorization|password|secret)\b\s*[:=]\s*([^\s,;]+)/gi, '$1=[REDACTED]');
+    return text;
+};
+const safeNumber = (value, fallback) => {
+    return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+};
+const safeEvent = (event, sessionId, seq) => {
+    const timestamp = safeNumber(event.timestamp, Date.now());
+    return {
+        version: 1,
+        id: `${sessionId}:${seq}`,
+        seq,
+        timestamp,
+        isoTimestamp: typeof event.isoTimestamp === 'string' && event.isoTimestamp.length <= 64
+            ? event.isoTimestamp
+            : new Date(timestamp).toISOString(),
+        level: event.level === 'debug' ||
+            event.level === 'info' ||
+            event.level === 'success' ||
+            event.level === 'warn' ||
+            event.level === 'error'
+            ? event.level
+            : 'info',
+        source: redact(event.source).slice(0, 100),
+        ...(event.tag ? { tag: redact(event.tag).slice(0, 100) } : {}),
+        message: redact(event.message),
+        raw: redact(event.raw)
+    };
+};
+const isBotLogEvent = (value) => {
+    if (!value || typeof value !== 'object')
+        return false;
+    const event = value;
+    return (event.version === 1 &&
+        typeof event.id === 'string' &&
+        event.id.length <= 200 &&
+        typeof event.seq === 'number' &&
+        Number.isSafeInteger(event.seq) &&
+        event.seq > 0 &&
+        typeof event.timestamp === 'number' &&
+        Number.isFinite(event.timestamp) &&
+        typeof event.message === 'string' &&
+        typeof event.raw === 'string');
+};
+/**
+ * Transporte privado de logs do bot.
+ *
+ * O Logger permanece síncrono; este transporte apenas enfileira eventos e
+ * envia lotes pequenos pelo socket já
+ * autenticado. Assim, um pico de logs não abre conexões extras nem bloqueia o
+ * loop principal do bot.
+ */
+class LogTransport {
+    options;
+    spoolPath;
+    spoolTempPath;
+    unsubscribeLogger;
+    unsubscribeConnection;
+    queue = [];
+    sessionId = (0, crypto_1.randomUUID)();
+    nextSeq = 0;
+    dropped = 0;
+    flushTimer = null;
+    persistTimer = null;
+    flushPromise = null;
+    spoolLoadPromise = null;
+    spoolLoaded = false;
+    stopped = false;
+    constructor(options) {
+        this.options = options;
+        const spoolDirectory = path_1.default.join(process.cwd(), '.ninenity');
+        this.spoolPath = path_1.default.join(spoolDirectory, 'logs_queue.json');
+        this.spoolTempPath = path_1.default.join(spoolDirectory, `logs_queue.${process.pid}.${(0, crypto_1.randomUUID)()}.tmp`);
+        this.unsubscribeLogger = Logger_1.default.onEvent((event) => this.enqueue(event));
+        this.unsubscribeConnection = options.onConnectionChange((connected) => {
+            if (connected) {
+                void this.flush().catch(() => undefined);
+            }
+            else {
+                this.schedulePersist();
+            }
+        });
+    }
+    getPendingCount() {
+        return this.queue.length;
+    }
+    async flush() {
+        if (this.stopped || !this.options.isConnected())
+            return;
+        if (this.flushPromise)
+            return this.flushPromise;
+        this.flushPromise = this.flushInternal().finally(() => {
+            this.flushPromise = null;
+        });
+        return this.flushPromise;
+    }
+    stop() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        this.unsubscribeLogger();
+        this.unsubscribeConnection();
+        this.clearFlushTimer();
+        this.clearPersistTimer();
+    }
+    enqueue(event) {
+        if (this.stopped)
+            return;
+        const nextSeq = this.nextSeq + 1;
+        this.nextSeq = nextSeq;
+        this.queue.push(safeEvent(event, this.sessionId, nextSeq));
+        if (this.queue.length > MAX_QUEUE_EVENTS) {
+            const overflow = this.queue.length - MAX_QUEUE_EVENTS;
+            this.queue.splice(0, overflow);
+            this.dropped += overflow;
+        }
+        if (this.options.isConnected()) {
+            this.scheduleFlush();
+        }
+        else {
+            this.schedulePersist();
+        }
+    }
+    async flushInternal() {
+        await this.loadSpool();
+        while (!this.stopped && this.options.isConnected() && this.queue.length > 0) {
+            const events = this.takeBatch();
+            if (events.length === 0)
+                break;
+            const payload = {
+                version: 1,
+                sessionId: this.sessionId,
+                botId: this.safeBotId(),
+                environment: this.options.getEnvironment(),
+                firstSeq: events[0].seq,
+                lastSeq: events[events.length - 1].seq,
+                dropped: this.dropped,
+                events
+            };
+            let sent = false;
+            try {
+                sent = this.options.send('bot_log_batch', payload);
+            }
+            catch {
+                sent = false;
+            }
+            if (!sent)
+                break;
+            this.queue.splice(0, events.length);
+            this.dropped = 0;
+            await Promise.resolve();
+        }
+        if (this.queue.length === 0) {
+            this.clearPersistTimer();
+            await this.removeSpool();
+        }
+        else if (this.options.isConnected()) {
+            this.scheduleFlush();
+        }
+        else {
+            this.schedulePersist();
+        }
+    }
+    takeBatch() {
+        const events = [];
+        for (const event of this.queue.slice(0, MAX_BATCH_EVENTS)) {
+            const candidate = [...events, event];
+            const payload = {
+                version: 1,
+                sessionId: this.sessionId,
+                botId: this.safeBotId(),
+                environment: this.options.getEnvironment(),
+                firstSeq: candidate[0].seq,
+                lastSeq: candidate[candidate.length - 1].seq,
+                dropped: this.dropped,
+                events: candidate
+            };
+            if (Buffer.byteLength(JSON.stringify(payload), 'utf8') > MAX_BATCH_BYTES) {
+                break;
+            }
+            events.push(event);
+        }
+        // Cada evento ? limitado a 16 KB, mas mantemos uma prote??o caso o
+        // contrato mude no futuro e um evento isolado ultrapasse o frame.
+        return events.length > 0 ? events : this.queue.slice(0, 1);
+    }
+    scheduleFlush() {
+        if (this.stopped || this.flushTimer || !this.options.isConnected())
+            return;
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            void this.flush().catch(() => undefined);
+        }, FLUSH_INTERVAL_MS);
+        this.flushTimer.unref?.();
+    }
+    schedulePersist() {
+        if (this.stopped || this.persistTimer || this.queue.length === 0)
+            return;
+        this.persistTimer = setTimeout(() => {
+            this.persistTimer = null;
+            void this.persistSpool().catch(() => undefined);
+        }, PERSIST_INTERVAL_MS);
+        this.persistTimer.unref?.();
+    }
+    clearFlushTimer() {
+        if (!this.flushTimer)
+            return;
+        clearTimeout(this.flushTimer);
+        this.flushTimer = null;
+    }
+    clearPersistTimer() {
+        if (!this.persistTimer)
+            return;
+        clearTimeout(this.persistTimer);
+        this.persistTimer = null;
+    }
+    async loadSpool() {
+        if (this.spoolLoaded)
+            return;
+        if (this.spoolLoadPromise)
+            return this.spoolLoadPromise;
+        this.spoolLoadPromise = (async () => {
+            try {
+                const stats = await promises_1.default.stat(this.spoolPath);
+                if (!stats.isFile() || stats.size <= 0 || stats.size > MAX_SPOOL_BYTES)
+                    return;
+                const parsed = JSON.parse(await promises_1.default.readFile(this.spoolPath, 'utf8'));
+                if (!parsed || typeof parsed !== 'object')
+                    return;
+                const spool = parsed;
+                if (spool.version !== 1 || typeof spool.sessionId !== 'string')
+                    return;
+                const events = Array.isArray(spool.events)
+                    ? spool.events.filter(isBotLogEvent).slice(-MAX_SPOOL_EVENTS)
+                    : [];
+                if (events.length === 0)
+                    return;
+                const currentQueue = this.queue;
+                // O spool pode ter sido escrito antes de uma queda e os eventos da
+                // nova execução podem ter entrado na fila enquanto o arquivo era
+                // lido. Reindexamos tudo na sessão atual para manter um único cursor
+                // monotúnico no lote enviado ? API.
+                this.nextSeq = 0;
+                this.queue = [...events, ...currentQueue]
+                    .slice(-MAX_QUEUE_EVENTS)
+                    .map((event) => {
+                    const seq = ++this.nextSeq;
+                    return { ...event, id: `${this.sessionId}:${seq}`, seq };
+                });
+                this.dropped += typeof spool.dropped === 'number' ? Math.max(0, spool.dropped) : 0;
+            }
+            catch {
+                // O spool ? apenas uma rede de segurança; falhar ao l?-lo não pode
+                // impedir o bot de conectar ou processar comandos.
+            }
+            finally {
+                this.spoolLoaded = true;
+                this.spoolLoadPromise = null;
+            }
+        })();
+        return this.spoolLoadPromise;
+    }
+    async persistSpool() {
+        if (this.stopped || this.queue.length === 0 || this.options.isConnected())
+            return;
+        try {
+            const events = this.queue.slice(-MAX_SPOOL_EVENTS);
+            const spool = {
+                version: 1,
+                sessionId: this.sessionId,
+                dropped: this.dropped + Math.max(0, this.queue.length - events.length),
+                events
+            };
+            const serialized = JSON.stringify(spool);
+            if (Buffer.byteLength(serialized, 'utf8') > MAX_SPOOL_BYTES)
+                return;
+            await promises_1.default.mkdir(path_1.default.dirname(this.spoolPath), { recursive: true });
+            await promises_1.default.writeFile(this.spoolTempPath, serialized, 'utf8');
+            if (this.options.isConnected()) {
+                await promises_1.default.unlink(this.spoolTempPath).catch(() => undefined);
+                return;
+            }
+            await promises_1.default.rename(this.spoolTempPath, this.spoolPath);
+        }
+        catch {
+            try {
+                await promises_1.default.unlink(this.spoolTempPath);
+            }
+            catch {
+                // Nothing to clean up.
+            }
+        }
+    }
+    async removeSpool() {
+        try {
+            await promises_1.default.unlink(this.spoolPath);
+        }
+        catch {
+            // ENOENT and permission errors are intentionally ignored here.
+        }
+    }
+    safeBotId() {
+        try {
+            return String(this.options.getBotId() || 'default_bot').slice(0, 100);
+        }
+        catch {
+            return 'default_bot';
+        }
+    }
+}
+exports.LogTransport = LogTransport;
+exports.default = LogTransport;
+//# sourceMappingURL=LogTransport.js.map

package/dist/Shared/LogTransport.js.map

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

package/dist/Shared/Neutrun.d.ts

@@ -0,0 +1,55 @@
+import { Bot } from './Client';
+import { SupervisorOptions } from './Supervisor';
+export interface NeutrunInitOptions {
+    /** Instância única do bot, criada pelo app com `new Bot({...})`. */
+    bot: Bot;
+    plugins?: {
+        emojis?: any;
+        database?: any;
+        i18n?: any;
+        agents?: any;
+        [key: string]: any;
+    };
+    settings?: {
+        baseDir?: string;
+        /**
+         * Resiliência: supervisiona o bot em processo filho e o reinicia com
+         * backoff se ele morrer. Default: ativo apenas em produção.
+         * Desative com `false` ou `NEUTRUN_NO_SUPERVISOR=1`.
+         */
+        supervisor?: boolean | SupervisorOptions;
+    };
+}
+declare const Neutrun: {
+    /**
+     * Acesso em runtime ao ComponentBuilder oficial do framework:
+     * `Neutrun.component.Paginator`, `Neutrun.component.MessageBuilder`, etc.
+     * Carregado sob demanda e cacheado; para imports estáticos prefira
+     * `@ninenity/neutrun/component`.
+     */
+    readonly component: typeof import("@ninenity/componentbuilder");
+    /**
+     * A instância única do bot. Forma canônica de acesso: `Neutrun.bot.slash(...)`.
+     *
+     * O getter é sempre atual — `const { bot } = Neutrun` captura o valor do
+     * momento da desestruturação, então prefira o acesso direto em módulos
+     * carregados antes do init. A instância passa a existir no momento do
+     * `new Bot({...})`; acessar antes disso é erro de programação e lança
+     * com uma mensagem orientando o fluxo correto.
+     */
+    readonly bot: Bot;
+    init: (options: NeutrunInitOptions) => void;
+    isInitialized: () => boolean;
+    getPath: () => string;
+    getGeneratedPath: (filename?: string) => string;
+    read: <T = any>(name: string) => T | null;
+    write: (name: string, data: any) => void;
+    cache: {
+        read: <T = any>(name: string) => T | null;
+        write: (name: string, data: any) => void;
+        append: (name: string, item: any) => void;
+        clear: (name: string) => void;
+    };
+};
+export default Neutrun;
+//# sourceMappingURL=Neutrun.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Neutrun.d.ts","sourceRoot":"","sources":["../../src/Shared/Neutrun.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,OAAO,EAAc,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAG5D,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,GAAG,EAAE,GAAG,CAAA;IACR,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,GAAG,CAAA;QACZ,QAAQ,CAAC,EAAE,GAAG,CAAA;QACd,IAAI,CAAC,EAAE,GAAG,CAAA;QACV,MAAM,CAAC,EAAE,GAAG,CAAA;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KACnB,CAAA;IACD,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB;;;;WAIG;QACH,UAAU,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAA;KACzC,CAAA;CACF;AAmPD,QAAA,MAAM,OAAO;IACX;;;;;OAKG;wBACc,cAAc,4BAA4B,CAAC;IAG5D;;;;;;;;OAQG;kBACQ,GAAG;oBAxPO,kBAAkB,KAAG,IAAI;yBAiOtB,OAAO;mBAjFb,MAAM;kCAWW,MAAM,KAAG,MAAM;WAmBtC,CAAC,cAAc,MAAM,KAAG,CAAC,GAAG,IAAI;kBAYzB,MAAM,QAAQ,GAAG,KAAG,IAAI;;eAO1B,CAAC,cAAc,MAAM,KAAG,CAAC,GAAG,IAAI;sBAYzB,MAAM,QAAQ,GAAG,KAAG,IAAI;uBAOvB,MAAM,QAAQ,GAAG,KAAG,IAAI;sBAMzB,MAAM,KAAG,IAAI;;CAoDtC,CAAA;AAGD,eAAe,OAAO,CAAA"}