@ninenity/neutrun 1.2.0 → 1.9.2

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/ProcessManager.d.ts

@@ -5,6 +5,7 @@ declare class ProcessManagerImpl {
     private initialized;
     registerCleanupTask(task: CleanupTask, name?: string): () => void;
     init(): void;
+    private requestShutdown;
     private shutdown;
 }
 declare const ProcessManager: ProcessManagerImpl;

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;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"}
+{"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;AAmB7C,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;IA0BnB,OAAO,CAAC,eAAe;YAcT,QAAQ;CAoDvB;AAoBD,QAAA,MAAM,cAAc,oBAA2B,CAAA;AAC/C,eAAe,cAAc,CAAA"}

package/dist/Shared/ProcessManager.js

@@ -4,6 +4,15 @@ const ConsoleLog_1 = require("./ConsoleLog");
 const Supervisor_1 = require("./Supervisor");
 const CLEANUP_TASK_TIMEOUT_MS = 10_000;
 const SHUTDOWN_TIMEOUT_MS = 30_000;
+const describeError = (error) => {
+    if (error instanceof Error)
+        return error.stack || error.message;
+    if (error && typeof error === 'object') {
+        const value = error;
+        return String(value.stack || value.message || error);
+    }
+    return String(error);
+};
 class ProcessManagerImpl {
     isShuttingDown = false;
     cleanupTasks = new Set();
@@ -24,15 +33,21 @@ class ProcessManagerImpl {
             // O handoff do Supervisor é controle de fluxo, não erro real.
             if ((0, Supervisor_1.isHandoffError)(error))
                 return;
-            (0, ConsoleLog_1.logError)(`Uncaught Exception: ${error.stack || error.message}`, 'ProcessManager');
-            void this.shutdown('uncaughtException', 1, false);
+            (0, ConsoleLog_1.logError)(`Uncaught Exception: ${describeError(error)}`, 'ProcessManager');
+            this.requestShutdown('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);
+            (0, ConsoleLog_1.logError)(`Unhandled Rejection: ${describeError(reason)}`, 'ProcessManager');
+            this.requestShutdown('unhandledRejection', 1, false);
+        });
+        process.on('SIGINT', () => this.requestShutdown('SIGINT', 0, true));
+        process.on('SIGTERM', () => this.requestShutdown('SIGTERM', 0, true));
+    }
+    requestShutdown(reason, requestedExitCode, intentional) {
+        void this.shutdown(reason, requestedExitCode, intentional).catch((error) => {
+            (0, ConsoleLog_1.logError)(`Falha interna durante o encerramento: ${error?.stack || error?.message || error}`, 'ProcessManager');
+            process.exit(1);
         });
-        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)

package/dist/Shared/ProcessManager.js.map

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

package/dist/Shared/ServerMetricsService.d.ts

@@ -0,0 +1,85 @@
+import { type Client, type GuildMember, type Message } from 'discord.js';
+export declare const SERVER_METRICS_INTERVAL_MS: number;
+export interface ServerMetricsPeriod {
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+}
+export interface ServerChannelMetrics {
+    channelId: string;
+    messages: number;
+    activeUsersEstimate: number;
+}
+export interface ServerGuildMetrics {
+    guildId: string;
+    messages: number;
+    activeUsersEstimate: number;
+    members: {
+        joined: number;
+        left: number;
+        netChange: number;
+    };
+    averages: {
+        messagesPerChannel: number;
+        messagesPerActiveUser: number;
+        activeUsersPerChannel: number;
+    };
+    channels: ServerChannelMetrics[];
+    droppedChannelMessages: number;
+}
+export interface ServerMetricsDailySnapshot {
+    period: ServerMetricsPeriod;
+    capabilities: {
+        messageEvents: boolean;
+        memberEvents: boolean;
+    };
+    collection: {
+        activeUsers: 'hyperloglog';
+        relativeErrorPercent: number;
+        maxGuilds: number;
+        maxChannels: number;
+        maxChannelsPerGuild: number;
+        droppedGuildEvents: number;
+    };
+    guilds: ServerGuildMetrics[];
+}
+export interface ServerMetricsCollectorOptions {
+    intervalMs?: number;
+    maxGuilds?: number;
+    maxChannels?: number;
+    maxChannelsPerGuild?: number;
+    now?: () => number;
+}
+type SnapshotHandler = (snapshot: ServerMetricsDailySnapshot) => Promise<void> | void;
+export declare class ServerMetricsCollector {
+    private readonly intervalMs;
+    private readonly maxGuilds;
+    private readonly maxChannels;
+    private readonly maxChannelsPerGuild;
+    private readonly now;
+    private guilds;
+    private trackedChannels;
+    private droppedGuildEvents;
+    private periodStartedAt;
+    private client;
+    private timer;
+    private snapshotHandler;
+    private flushing;
+    private capabilities;
+    private readonly onMessageCreate;
+    private readonly onGuildMemberAdd;
+    private readonly onGuildMemberRemove;
+    constructor(options?: ServerMetricsCollectorOptions);
+    bind(client: Client, handler: SnapshotHandler): void;
+    unbind(): void;
+    recordMessage(message: Pick<Message, 'guildId' | 'channelId' | 'author' | 'webhookId'>): void;
+    recordMemberJoined(member: Pick<GuildMember, 'guild' | 'user'>): void;
+    recordMemberLeft(member: Pick<GuildMember, 'guild' | 'user'>): void;
+    snapshot(reset?: boolean): ServerMetricsDailySnapshot;
+    flush(): Promise<void>;
+    private getOrCreateGuild;
+    private seedCachedGuilds;
+    private reset;
+}
+export default ServerMetricsCollector;
+//# sourceMappingURL=ServerMetricsService.d.ts.map

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

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

package/dist/Shared/ServerMetricsService.js

@@ -0,0 +1,284 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerMetricsCollector = exports.SERVER_METRICS_INTERVAL_MS = void 0;
+const discord_js_1 = require("discord.js");
+exports.SERVER_METRICS_INTERVAL_MS = 24 * 60 * 60 * 1_000;
+const UNIQUE_USER_PRECISION = 8;
+const UNIQUE_USER_REGISTERS = 1 << UNIQUE_USER_PRECISION;
+const UNIQUE_USER_RELATIVE_ERROR_PERCENT = Number(((1.04 / Math.sqrt(UNIQUE_USER_REGISTERS)) * 100).toFixed(2));
+const DEFAULT_MAX_GUILDS = 1_000;
+const DEFAULT_MAX_CHANNELS = 5_000;
+const DEFAULT_MAX_CHANNELS_PER_GUILD = 500;
+/**
+ * Contador de cardinalidade aproximada com memória fixa.
+ * IDs são usados somente no hash e nunca ficam armazenados no processo.
+ */
+class HyperLogLogCounter {
+    registers = new Uint8Array(UNIQUE_USER_REGISTERS);
+    add(value) {
+        const hash = fnv1a32(value);
+        const index = hash >>> (32 - UNIQUE_USER_PRECISION);
+        const remaining = (hash << UNIQUE_USER_PRECISION) >>> 0;
+        const rank = Math.min(Math.clz32(remaining) + 1, 32 - UNIQUE_USER_PRECISION + 1);
+        if (rank > this.registers[index])
+            this.registers[index] = rank;
+    }
+    estimate() {
+        let harmonicSum = 0;
+        let zeroRegisters = 0;
+        for (const register of this.registers) {
+            harmonicSum += 2 ** -register;
+            if (register === 0)
+                zeroRegisters += 1;
+        }
+        const alpha = 0.7213 / (1 + 1.079 / UNIQUE_USER_REGISTERS);
+        let estimate = alpha * UNIQUE_USER_REGISTERS * UNIQUE_USER_REGISTERS / harmonicSum;
+        if (estimate <= 2.5 * UNIQUE_USER_REGISTERS && zeroRegisters > 0) {
+            estimate = UNIQUE_USER_REGISTERS * Math.log(UNIQUE_USER_REGISTERS / zeroRegisters);
+        }
+        return Math.max(0, Math.round(estimate));
+    }
+}
+class ServerMetricsCollector {
+    intervalMs;
+    maxGuilds;
+    maxChannels;
+    maxChannelsPerGuild;
+    now;
+    guilds = new Map();
+    trackedChannels = 0;
+    droppedGuildEvents = 0;
+    periodStartedAt;
+    client = null;
+    timer = null;
+    snapshotHandler = null;
+    flushing = false;
+    capabilities = { messageEvents: false, memberEvents: false };
+    onMessageCreate = (message) => {
+        try {
+            this.recordMessage(message);
+        }
+        catch {
+            // Observabilidade nunca pode interromper o dispatch do Discord.
+        }
+    };
+    onGuildMemberAdd = (member) => {
+        try {
+            this.recordMemberJoined(member);
+        }
+        catch {
+            // Observabilidade nunca pode interromper o dispatch do Discord.
+        }
+    };
+    onGuildMemberRemove = (member) => {
+        try {
+            this.recordMemberLeft(member);
+        }
+        catch {
+            // Observabilidade nunca pode interromper o dispatch do Discord.
+        }
+    };
+    constructor(options = {}) {
+        this.intervalMs = clampInteger(options.intervalMs, 1_000, 7 * exports.SERVER_METRICS_INTERVAL_MS, exports.SERVER_METRICS_INTERVAL_MS);
+        this.maxGuilds = clampInteger(options.maxGuilds, 1, 10_000, DEFAULT_MAX_GUILDS);
+        this.maxChannels = clampInteger(options.maxChannels, 1, 50_000, DEFAULT_MAX_CHANNELS);
+        this.maxChannelsPerGuild = clampInteger(options.maxChannelsPerGuild, 1, 5_000, DEFAULT_MAX_CHANNELS_PER_GUILD);
+        this.now = options.now ?? Date.now;
+        this.periodStartedAt = this.now();
+    }
+    bind(client, handler) {
+        if (this.client === client && this.snapshotHandler === handler)
+            return;
+        this.unbind();
+        this.client = client;
+        this.snapshotHandler = handler;
+        this.capabilities = {
+            messageEvents: client.options.intents.has(discord_js_1.GatewayIntentBits.GuildMessages),
+            memberEvents: client.options.intents.has(discord_js_1.GatewayIntentBits.GuildMembers)
+        };
+        client.on(discord_js_1.Events.MessageCreate, this.onMessageCreate);
+        client.on(discord_js_1.Events.GuildMemberAdd, this.onGuildMemberAdd);
+        client.on(discord_js_1.Events.GuildMemberRemove, this.onGuildMemberRemove);
+        this.timer = setInterval(() => {
+            void this.flush().catch(() => {
+                // Métricas nunca devem causar uma rejeição não tratada no bot.
+            });
+        }, this.intervalMs);
+        this.timer.unref?.();
+    }
+    unbind() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        if (this.client) {
+            this.client.removeListener(discord_js_1.Events.MessageCreate, this.onMessageCreate);
+            this.client.removeListener(discord_js_1.Events.GuildMemberAdd, this.onGuildMemberAdd);
+            this.client.removeListener(discord_js_1.Events.GuildMemberRemove, this.onGuildMemberRemove);
+        }
+        this.client = null;
+        this.snapshotHandler = null;
+    }
+    recordMessage(message) {
+        const guildId = message.guildId;
+        const channelId = message.channelId;
+        const author = message.author;
+        const userId = author?.id;
+        if (!guildId || !channelId || !userId || !author || author.bot || message.webhookId)
+            return;
+        const guild = this.getOrCreateGuild(guildId);
+        if (!guild) {
+            this.droppedGuildEvents = safeIncrement(this.droppedGuildEvents);
+            return;
+        }
+        guild.messages = safeIncrement(guild.messages);
+        guild.activeUsers.add(userId);
+        let channel = guild.channels.get(channelId);
+        if (!channel) {
+            if (guild.channels.size >= this.maxChannelsPerGuild ||
+                this.trackedChannels >= this.maxChannels) {
+                guild.droppedChannelMessages = safeIncrement(guild.droppedChannelMessages);
+                return;
+            }
+            channel = {
+                messages: 0,
+                activeUsers: new HyperLogLogCounter()
+            };
+            guild.channels.set(channelId, channel);
+            this.trackedChannels += 1;
+        }
+        channel.messages = safeIncrement(channel.messages);
+        channel.activeUsers.add(userId);
+    }
+    recordMemberJoined(member) {
+        if (member.user.bot)
+            return;
+        const guild = this.getOrCreateGuild(member.guild.id);
+        if (!guild) {
+            this.droppedGuildEvents = safeIncrement(this.droppedGuildEvents);
+            return;
+        }
+        guild.joined = safeIncrement(guild.joined);
+    }
+    recordMemberLeft(member) {
+        if (member.user.bot)
+            return;
+        const guild = this.getOrCreateGuild(member.guild.id);
+        if (!guild) {
+            this.droppedGuildEvents = safeIncrement(this.droppedGuildEvents);
+            return;
+        }
+        guild.left = safeIncrement(guild.left);
+    }
+    snapshot(reset = false) {
+        this.seedCachedGuilds();
+        const endedAt = this.now();
+        const periodStartedAt = this.periodStartedAt;
+        const guilds = Array.from(this.guilds, ([guildId, guild]) => {
+            const channels = Array.from(guild.channels, ([channelId, channel]) => ({
+                channelId,
+                messages: channel.messages,
+                activeUsersEstimate: channel.activeUsers.estimate()
+            })).sort((left, right) => right.messages - left.messages || left.channelId.localeCompare(right.channelId));
+            const activeUsersEstimate = guild.activeUsers.estimate();
+            const activeUsersAcrossChannels = channels.reduce((total, channel) => total + channel.activeUsersEstimate, 0);
+            const trackedMessages = Math.max(0, guild.messages - guild.droppedChannelMessages);
+            return {
+                guildId,
+                messages: guild.messages,
+                activeUsersEstimate,
+                members: {
+                    joined: guild.joined,
+                    left: guild.left,
+                    netChange: guild.joined - guild.left
+                },
+                averages: {
+                    messagesPerChannel: average(trackedMessages, channels.length),
+                    messagesPerActiveUser: average(guild.messages, activeUsersEstimate),
+                    activeUsersPerChannel: average(activeUsersAcrossChannels, channels.length)
+                },
+                channels,
+                droppedChannelMessages: guild.droppedChannelMessages
+            };
+        }).sort((left, right) => left.guildId.localeCompare(right.guildId));
+        const output = {
+            period: {
+                startedAt: new Date(periodStartedAt).toISOString(),
+                endedAt: new Date(endedAt).toISOString(),
+                durationMs: Math.max(0, endedAt - periodStartedAt)
+            },
+            capabilities: { ...this.capabilities },
+            collection: {
+                activeUsers: 'hyperloglog',
+                relativeErrorPercent: UNIQUE_USER_RELATIVE_ERROR_PERCENT,
+                maxGuilds: this.maxGuilds,
+                maxChannels: this.maxChannels,
+                maxChannelsPerGuild: this.maxChannelsPerGuild,
+                droppedGuildEvents: this.droppedGuildEvents
+            },
+            guilds
+        };
+        if (reset)
+            this.reset(endedAt);
+        return output;
+    }
+    async flush() {
+        if (this.flushing || !this.snapshotHandler)
+            return;
+        this.flushing = true;
+        try {
+            await this.snapshotHandler(this.snapshot(true));
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+    getOrCreateGuild(guildId) {
+        const current = this.guilds.get(guildId);
+        if (current)
+            return current;
+        if (this.guilds.size >= this.maxGuilds)
+            return undefined;
+        const guild = {
+            messages: 0,
+            joined: 0,
+            left: 0,
+            droppedChannelMessages: 0,
+            activeUsers: new HyperLogLogCounter(),
+            channels: new Map()
+        };
+        this.guilds.set(guildId, guild);
+        return guild;
+    }
+    seedCachedGuilds() {
+        this.client?.guilds.cache.forEach((guild) => {
+            if (!this.getOrCreateGuild(guild.id)) {
+                this.droppedGuildEvents = safeIncrement(this.droppedGuildEvents);
+            }
+        });
+    }
+    reset(startedAt) {
+        this.guilds = new Map();
+        this.trackedChannels = 0;
+        this.droppedGuildEvents = 0;
+        this.periodStartedAt = startedAt;
+    }
+}
+exports.ServerMetricsCollector = ServerMetricsCollector;
+const fnv1a32 = (value) => {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+};
+const safeIncrement = (value) => Math.min(Number.MAX_SAFE_INTEGER, value + 1);
+const average = (total, count) => count > 0 ? Number((total / count).toFixed(3)) : 0;
+const 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)));
+};
+exports.default = ServerMetricsCollector;
+//# sourceMappingURL=ServerMetricsService.js.map