@zumito-team/analytics-module 0.1.0

package/README.md

@@ -0,0 +1,237 @@
+# Analytics Module
+
+**`@zumito-team/analytics-module`** provides configurable server analytics for your Zumito bot. Tracks messages, members, voice activity, and command usage with per-guild granularity. Includes optional web dashboard pages with Chart.js for both the admin and user panels.
+
+## Installation
+
+```bash
+npm install @zumito-team/analytics-module
+```
+
+Add to your `zumito.config.ts`:
+
+```ts
+{
+    path: path.join(__dirname, "node_modules", "@zumito-team", "analytics-module"),
+}
+```
+
+## What it provides
+
+### AnalyticsCollector service
+
+Available via `ServiceContainer.getService(AnalyticsCollector)`. Other modules can query analytics data.
+
+| Method | Description |
+|---|---|
+| `recordMessage(guildId)` | Track a message sent in a guild |
+| `recordMemberJoin(guildId)` | Track a member joining |
+| `recordMemberLeave(guildId)` | Track a member leaving |
+| `recordVoiceJoin(guildId, channelId, userId)` | Track voice channel join |
+| `recordVoiceLeave(guildId, channelId, userId)` | Track voice channel leave (auto-calculates duration) |
+| `recordCommand(payload)` | Track a command execution (success/failure + execution time) |
+| `recordMemberCount(guildId, count)` | Store current member count snapshot |
+| `getGuildStats(guildId, daysBack)` | Get daily stats for a guild |
+| `getGlobalStatsSummary(daysBack)` | Get aggregated global stats |
+| `getGuildGrowth(daysBack)` | Get active guilds per day |
+| `getMessagesPerDay(daysBack)` | Get messages per day (global) |
+| `getCommandsPerDay(guildId, daysBack)` | Get commands per day |
+| `getTopCommands(guildId, daysBack, limit)` | Get most used commands |
+| `getSlowestCommands(guildId, daysBack, limit)` | Get commands sorted by avg execution time |
+| `getVoiceChannelStats(guildId, daysBack)` | Get per-channel voice stats |
+| `getConfig(guildId)` | Get guild analytics configuration |
+| `updateConfig(guildId, partial)` | Update guild analytics configuration |
+| `runCleanup()` | Run data retention cleanup manually |
+| `startCleanupScheduler()` | Start automatic cleanup scheduler |
+| `stopCleanupScheduler()` | Stop automatic cleanup scheduler |
+| `clearVoiceSessions()` | Clear in-memory voice session tracking |
+
+### Events tracked
+
+| Event | Source | Description |
+|---|---|---|
+| `messageCreate` | discord | Message count per guild |
+| `guildMemberAdd` | discord | Join count + member snapshot |
+| `guildMemberRemove` | discord | Leave count + member snapshot |
+| `voiceStateUpdate` | discord | Voice activity (minutes) per guild/channel |
+| `commandExecuted` | framework | Command usage + execution time |
+
+### Commands
+
+| Command | Type | Description |
+|---|---|---|
+| `/stats` | Slash + Prefix | Shows server stats embed (last 7 days) |
+| `/analytics-config` | Slash + Prefix (admin-only) | View/toggle analytics settings per guild |
+
+### Admin Panel
+
+- **`/admin/analytics`** — Global bot statistics: guild growth, messages/day, commands/day, top commands, slowest commands
+- Date range selector: 7 / 30 / 90 days
+- Chart.js visualizations (line, bar, horizontal bar charts)
+
+### User Panel
+
+- **`/panel/:guildId/analytics`** — Per-server statistics: messages, joins/leaves, voice activity, commands, top commands
+- If `track_command_performance` enabled: slowest commands chart
+- If `track_per_channel_voice` enabled: per-channel voice breakdown
+- Date range selector: 7 / 30 / 90 days
+
+## Configuration
+
+### Global defaults
+
+Import and configure global defaults before the module initializes:
+
+```ts
+import { AnalyticsModuleConfig } from '@zumito-team/analytics-module';
+
+AnalyticsModuleConfig.configure({
+    defaultRetentionDays: 90,
+    cleanupIntervalHours: 24,
+    defaultTrackMessages: true,
+    defaultTrackVoice: true,
+    defaultTrackMembers: true,
+    defaultTrackCommands: true,
+    defaultTrackCommandPerformance: false,
+    defaultTrackPerChannelVoice: false,
+});
+```
+
+| Setting | Default | Description |
+|---|---|---|
+| `defaultRetentionDays` | `90` | Days to keep data before auto-deletion |
+| `cleanupIntervalHours` | `24` | How often cleanup runs |
+| `defaultTrackMessages` | `true` | Track messages by default |
+| `defaultTrackVoice` | `true` | Track voice activity by default |
+| `defaultTrackMembers` | `true` | Track joins/leaves by default |
+| `defaultTrackCommands` | `true` | Track command usage by default |
+| `defaultTrackCommandPerformance` | `false` | Track execution time per command |
+| `defaultTrackPerChannelVoice` | `false` | Track per-channel voice stats |
+
+### Per-guild configuration
+
+Use `/analytics-config` or the public API:
+
+```ts
+const collector = ServiceContainer.getService(AnalyticsCollector);
+await collector.updateConfig(guildId, {
+    enabled: true,
+    track_commands: true,
+    track_command_performance: true,  // enable execution time tracking
+    retention_days: 180,              // 6 months for premium
+});
+```
+
+Per-guild DB fields:
+
+| Field | Type | Default |
+|---|---|---|
+| `guild_id` | `string` | Primary key |
+| `enabled` | `boolean` | `true` |
+| `track_messages` | `boolean` | `true` |
+| `track_voice` | `boolean` | `true` |
+| `track_members` | `boolean` | `true` |
+| `track_commands` | `boolean` | `true` |
+| `track_command_performance` | `boolean` | `false` |
+| `track_per_channel_voice` | `boolean` | `false` |
+| `retention_days` | `number` | Globally configured default (90) |
+| `public_stats_page` | `boolean` | `false` |
+
+## Extending
+
+### Consuming AnalyticsCollector in other modules
+
+```ts
+import { AnalyticsCollector, type CommandExecutedPayload } from '@zumito-team/analytics-module';
+import { ServiceContainer } from 'zumito-framework';
+
+const collector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector;
+
+// Query stats
+const stats = await collector.getGuildStats(guildId, 30);
+
+// Get top commands
+const top = await collector.getTopCommands(null, 7, 5);
+
+// Get global summary
+const summary = await collector.getGlobalStatsSummary(7);
+```
+
+### Tracking custom events
+
+```ts
+// Track custom event as a message
+await collector.recordMessage(guildId);
+
+// Track a custom metric directly via DB
+const db = ServiceContainer.getService(DatabaseManager);
+const repo = db.getRepository(GuildDailyStats);
+await repo.insert({ id: `${guildId}_${today()}`, guild_id: guildId, date: today(), message_count: 1 });
+```
+
+### Premium integration
+
+Set a higher retention for premium guilds:
+
+```ts
+// In your premium module
+await collector.updateConfig(guildId, { retention_days: 180 });
+```
+
+## Data models
+
+### GuildDailyStats
+
+Per-guild daily aggregate: `id` = `{guild_id}_{date}`
+
+| Field | Type |
+|---|---|
+| `id` | `string` (PK) |
+| `guild_id` | `string` |
+| `date` | `string` (YYYY-MM-DD) |
+| `message_count` | `number` |
+| `join_count` | `number` |
+| `leave_count` | `number` |
+| `voice_minutes` | `number` |
+| `command_count` | `number` |
+| `member_count` | `number` |
+
+### CommandDailyStats
+
+Per-command daily stats: `id` = `{guild_id}_{command_name}_{date}`
+
+| Field | Type |
+|---|---|
+| `id` | `string` (PK) |
+| `guild_id` | `string` |
+| `command_name` | `string` |
+| `date` | `string` (YYYY-MM-DD) |
+| `usage_count` | `number` |
+| `total_execution_time_ms` | `number` |
+| `error_count` | `number` |
+
+### VoiceChannelDailyStats
+
+Per-channel voice stats: `id` = `{guild_id}_{channel_id}_{date}`
+
+| Field | Type |
+|---|---|
+| `id` | `string` (PK) |
+| `guild_id` | `string` |
+| `channel_id` | `string` |
+| `date` | `string` (YYYY-MM-DD) |
+| `total_minutes` | `number` |
+| `unique_users` | `number` |
+
+## Dependencies
+
+- `zumito-framework`
+- `ejs` — Template rendering
+- `@zumito-team/admin-module` — Optional admin panel integration
+- `@zumito-team/user-panel-module` — Optional user panel integration
+
+## Related modules
+
+- [**Admin Module**](/guides/modules/admin) — Panel where global bot stats appear
+- [**User Panel**](/guides/modules/user-panel) — Panel where per-server stats appear
+- [**Logger**](/guides/modules/logger) — Complementary event logging

package/commands/AnalyticsConfig.d.ts

@@ -0,0 +1,12 @@
+import { Command, CommandParameters } from 'zumito-framework';
+import { AnalyticsCollector } from '../services/AnalyticsCollector.js';
+export declare class AnalyticsConfig extends Command {
+    private collector;
+    name: string;
+    categories: string[];
+    type: string;
+    dm: boolean;
+    adminOnly: boolean;
+    constructor(collector?: AnalyticsCollector);
+    execute({ message, interaction, trans, args }: CommandParameters): Promise<void>;
+}

package/commands/AnalyticsConfig.js

@@ -0,0 +1,93 @@
+import { Command, CommandType, ServiceContainer } from 'zumito-framework';
+import { EmbedBuilder } from 'zumito-framework/discord';
+import { AnalyticsCollector } from '../services/AnalyticsCollector.js';
+export class AnalyticsConfig extends Command {
+    constructor(collector = ServiceContainer.getService(AnalyticsCollector)) {
+        super();
+        this.collector = collector;
+        this.name = 'analytics-config';
+        this.categories = ['analytics', 'admin'];
+        this.type = CommandType.any;
+        this.dm = false;
+        this.adminOnly = true;
+    }
+    async execute({ message, interaction, trans, args }) {
+        const target = message || interaction;
+        if (!target)
+            return;
+        const guildId = message?.guildId || interaction?.guildId;
+        if (!guildId) {
+            await target.reply({ content: trans('noGuild') });
+            return;
+        }
+        const config = await this.collector.getConfig(guildId);
+        const subcommand = args instanceof Map ? args.get('action') : (typeof args === 'object' && 'action' in args ? args['action'] : undefined);
+        if (!subcommand) {
+            const embed = new EmbedBuilder()
+                .setTitle(trans('configTitle'))
+                .setDescription(trans('configDescription'))
+                .addFields({ name: trans('enabled'), value: config.enabled ? '✅ Yes' : '❌ No', inline: true }, { name: trans('trackMessages'), value: config.track_messages ? '✅' : '❌', inline: true }, { name: trans('trackVoice'), value: config.track_voice ? '✅' : '❌', inline: true }, { name: trans('trackMembers'), value: config.track_members ? '✅' : '❌', inline: true }, { name: trans('trackCommands'), value: config.track_commands ? '✅' : '❌', inline: true }, { name: trans('trackPerformance'), value: config.track_command_performance ? '✅' : '❌', inline: true }, { name: trans('trackPerChannelVoice'), value: config.track_per_channel_voice ? '✅' : '❌', inline: true }, { name: trans('retentionDays'), value: (config.retention_days || '90').toString(), inline: true }, { name: trans('publicStats'), value: config.public_stats_page ? '✅' : '❌', inline: true })
+                .setColor(0x5865F2);
+            if (message) {
+                await message.reply({ embeds: [embed] });
+            }
+            else if (interaction) {
+                if (interaction.replied || interaction.deferred) {
+                    await interaction.editReply({ embeds: [embed] });
+                }
+                else {
+                    await interaction.reply({ embeds: [embed], ephemeral: true });
+                }
+            }
+            return;
+        }
+        switch (subcommand) {
+            case 'enable':
+                await this.collector.updateConfig(guildId, { enabled: true });
+                break;
+            case 'disable':
+                await this.collector.updateConfig(guildId, { enabled: false });
+                break;
+            case 'messages':
+                await this.collector.updateConfig(guildId, { track_messages: !config.track_messages });
+                break;
+            case 'voice':
+                await this.collector.updateConfig(guildId, { track_voice: !config.track_voice });
+                break;
+            case 'members':
+                await this.collector.updateConfig(guildId, { track_members: !config.track_members });
+                break;
+            case 'commands':
+                await this.collector.updateConfig(guildId, { track_commands: !config.track_commands });
+                break;
+            case 'performance':
+                await this.collector.updateConfig(guildId, { track_command_performance: !config.track_command_performance });
+                break;
+            case 'retention': {
+                const days = args instanceof Map ? args.get('days') : (typeof args === 'object' && 'days' in args ? args['days'] : null);
+                if (days && typeof days === 'number') {
+                    await this.collector.updateConfig(guildId, { retention_days: days });
+                }
+                break;
+            }
+            default:
+                break;
+        }
+        const updated = await this.collector.getConfig(guildId);
+        const embed = new EmbedBuilder()
+            .setTitle(trans('configUpdated'))
+            .addFields({ name: trans('enabled'), value: updated.enabled ? '✅ Yes' : '❌ No', inline: true }, { name: trans('trackMessages'), value: updated.track_messages ? '✅' : '❌', inline: true }, { name: trans('trackVoice'), value: updated.track_voice ? '✅' : '❌', inline: true }, { name: trans('trackMembers'), value: updated.track_members ? '✅' : '❌', inline: true }, { name: trans('trackCommands'), value: updated.track_commands ? '✅' : '❌', inline: true }, { name: trans('trackPerformance'), value: updated.track_command_performance ? '✅' : '❌', inline: true }, { name: trans('retentionDays'), value: (updated.retention_days || '90').toString(), inline: true })
+            .setColor(0x57F287);
+        if (message) {
+            await message.reply({ embeds: [embed] });
+        }
+        else if (interaction) {
+            if (interaction.replied || interaction.deferred) {
+                await interaction.editReply({ embeds: [embed] });
+            }
+            else {
+                await interaction.reply({ embeds: [embed], ephemeral: true });
+            }
+        }
+    }
+}

package/commands/AnalyticsConfig.ts

@@ -0,0 +1,118 @@
+import { Command, CommandParameters, CommandType, ServiceContainer } from 'zumito-framework';
+import { EmbedBuilder, PermissionFlagsBits } from 'zumito-framework/discord';
+import { AnalyticsCollector } from '../services/AnalyticsCollector.js';
+
+export class AnalyticsConfig extends Command {
+    name = 'analytics-config';
+    categories = ['analytics', 'admin'];
+    type = CommandType.any;
+    dm = false;
+    adminOnly = true;
+
+    constructor(
+        private collector: AnalyticsCollector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector,
+    ) {
+        super();
+    }
+
+    async execute({ message, interaction, trans, args }: CommandParameters): Promise<void> {
+        const target = message || interaction;
+        if (!target) return;
+
+        const guildId = message?.guildId || interaction?.guildId;
+        if (!guildId) {
+            await target.reply({ content: trans('noGuild') } as any);
+            return;
+        }
+
+        const config = await this.collector.getConfig(guildId);
+
+        const subcommand = args instanceof Map ? args.get('action') : (typeof args === 'object' && 'action' in args ? args['action'] : undefined);
+
+        if (!subcommand) {
+            const embed = new EmbedBuilder()
+                .setTitle(trans('configTitle'))
+                .setDescription(trans('configDescription'))
+                .addFields(
+                    { name: trans('enabled'), value: config.enabled ? '✅ Yes' : '❌ No', inline: true },
+                    { name: trans('trackMessages'), value: config.track_messages ? '✅' : '❌', inline: true },
+                    { name: trans('trackVoice'), value: config.track_voice ? '✅' : '❌', inline: true },
+                    { name: trans('trackMembers'), value: config.track_members ? '✅' : '❌', inline: true },
+                    { name: trans('trackCommands'), value: config.track_commands ? '✅' : '❌', inline: true },
+                    { name: trans('trackPerformance'), value: config.track_command_performance ? '✅' : '❌', inline: true },
+                    { name: trans('trackPerChannelVoice'), value: config.track_per_channel_voice ? '✅' : '❌', inline: true },
+                    { name: trans('retentionDays'), value: (config.retention_days || '90').toString(), inline: true },
+                    { name: trans('publicStats'), value: config.public_stats_page ? '✅' : '❌', inline: true },
+                )
+                .setColor(0x5865F2);
+
+            if (message) {
+                await message.reply({ embeds: [embed] });
+            } else if (interaction) {
+                if (interaction.replied || interaction.deferred) {
+                    await interaction.editReply({ embeds: [embed] });
+                } else {
+                    await interaction.reply({ embeds: [embed], ephemeral: true });
+                }
+            }
+            return;
+        }
+
+        switch (subcommand) {
+            case 'enable':
+                await this.collector.updateConfig(guildId, { enabled: true });
+                break;
+            case 'disable':
+                await this.collector.updateConfig(guildId, { enabled: false });
+                break;
+            case 'messages':
+                await this.collector.updateConfig(guildId, { track_messages: !config.track_messages });
+                break;
+            case 'voice':
+                await this.collector.updateConfig(guildId, { track_voice: !config.track_voice });
+                break;
+            case 'members':
+                await this.collector.updateConfig(guildId, { track_members: !config.track_members });
+                break;
+            case 'commands':
+                await this.collector.updateConfig(guildId, { track_commands: !config.track_commands });
+                break;
+            case 'performance':
+                await this.collector.updateConfig(guildId, { track_command_performance: !config.track_command_performance });
+                break;
+            case 'retention': {
+                const days = args instanceof Map ? args.get('days') : (typeof args === 'object' && 'days' in args ? args['days'] : null);
+                if (days && typeof days === 'number') {
+                    await this.collector.updateConfig(guildId, { retention_days: days });
+                }
+                break;
+            }
+            default:
+                break;
+        }
+
+        const updated = await this.collector.getConfig(guildId);
+        const embed = new EmbedBuilder()
+            .setTitle(trans('configUpdated'))
+            .addFields(
+                { name: trans('enabled'), value: updated.enabled ? '✅ Yes' : '❌ No', inline: true },
+                { name: trans('trackMessages'), value: updated.track_messages ? '✅' : '❌', inline: true },
+                { name: trans('trackVoice'), value: updated.track_voice ? '✅' : '❌', inline: true },
+                { name: trans('trackMembers'), value: updated.track_members ? '✅' : '❌', inline: true },
+                { name: trans('trackCommands'), value: updated.track_commands ? '✅' : '❌', inline: true },
+                { name: trans('trackPerformance'), value: updated.track_command_performance ? '✅' : '❌', inline: true },
+                { name: trans('retentionDays'), value: (updated.retention_days || '90').toString(), inline: true },
+            )
+            .setColor(0x57F287);
+
+        if (message) {
+            await message.reply({ embeds: [embed] });
+        } else if (interaction) {
+            if (interaction.replied || interaction.deferred) {
+                await interaction.editReply({ embeds: [embed] });
+            } else {
+                await interaction.reply({ embeds: [embed], ephemeral: true });
+            }
+        }
+    }
+}

package/commands/Stats.d.ts

@@ -0,0 +1,11 @@
+import { Command, CommandParameters } from 'zumito-framework';
+import { AnalyticsCollector } from '../services/AnalyticsCollector.js';
+export declare class Stats extends Command {
+    private collector;
+    name: string;
+    categories: string[];
+    type: string;
+    dm: boolean;
+    constructor(collector?: AnalyticsCollector);
+    execute({ message, interaction, framework, trans }: CommandParameters): Promise<void>;
+}

package/commands/Stats.js

@@ -0,0 +1,52 @@
+import { Command, CommandType, ServiceContainer } from 'zumito-framework';
+import { EmbedBuilder } from 'zumito-framework/discord';
+import { AnalyticsCollector } from '../services/AnalyticsCollector.js';
+export class Stats extends Command {
+    constructor(collector = ServiceContainer.getService(AnalyticsCollector)) {
+        super();
+        this.collector = collector;
+        this.name = 'stats';
+        this.categories = ['analytics', 'utility'];
+        this.type = CommandType.any;
+        this.dm = false;
+    }
+    async execute({ message, interaction, framework, trans }) {
+        const target = message || interaction;
+        if (!target)
+            return;
+        const guildId = message?.guildId || interaction?.guildId;
+        if (!guildId) {
+            await target.reply({ content: trans('noGuild'), ephemeral: true });
+            return;
+        }
+        const daysBack = 7;
+        const stats = await this.collector.getGuildStats(guildId, daysBack);
+        let totalMessages = 0, totalJoins = 0, totalLeaves = 0;
+        let totalVoice = 0, totalCommands = 0;
+        for (const s of stats) {
+            totalMessages += s.message_count;
+            totalJoins += s.join_count;
+            totalLeaves += s.leave_count;
+            totalVoice += s.voice_minutes;
+            totalCommands += s.command_count;
+        }
+        const embed = new EmbedBuilder()
+            .setTitle(trans('title'))
+            .setDescription(trans('description', { days: daysBack }))
+            .addFields({ name: trans('messages'), value: totalMessages.toString(), inline: true }, { name: trans('commands'), value: totalCommands.toString(), inline: true }, { name: trans('joins'), value: totalJoins.toString(), inline: true }, { name: trans('leaves'), value: totalLeaves.toString(), inline: true }, { name: trans('voice'), value: `${Math.round(totalVoice)} min`, inline: true })
+            .setColor(0x5865F2)
+            .setTimestamp();
+        const replyPayload = { embeds: [embed] };
+        if (message) {
+            await message.reply(replyPayload);
+        }
+        else if (interaction) {
+            if (interaction.replied || interaction.deferred) {
+                await interaction.editReply(replyPayload);
+            }
+            else {
+                await interaction.reply({ ...replyPayload, ephemeral: true });
+            }
+        }
+    }
+}

package/commands/Stats.ts

@@ -0,0 +1,66 @@
+import { Command, CommandParameters, CommandType, ServiceContainer } from 'zumito-framework';
+import { EmbedBuilder, ActionRowBuilder, ButtonBuilder, ButtonStyle } from 'zumito-framework/discord';
+import { AnalyticsCollector } from '../services/AnalyticsCollector.js';
+
+export class Stats extends Command {
+    name = 'stats';
+    categories = ['analytics', 'utility'];
+    type = CommandType.any;
+    dm = false;
+
+    constructor(
+        private collector: AnalyticsCollector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector,
+    ) {
+        super();
+    }
+
+    async execute({ message, interaction, framework, trans }: CommandParameters): Promise<void> {
+        const target = message || interaction;
+        if (!target) return;
+
+        const guildId = message?.guildId || interaction?.guildId;
+        if (!guildId) {
+            await target.reply({ content: trans('noGuild'), ephemeral: true } as any);
+            return;
+        }
+
+        const daysBack = 7;
+        const stats = await this.collector.getGuildStats(guildId, daysBack);
+
+        let totalMessages = 0, totalJoins = 0, totalLeaves = 0;
+        let totalVoice = 0, totalCommands = 0;
+
+        for (const s of stats) {
+            totalMessages += s.message_count;
+            totalJoins += s.join_count;
+            totalLeaves += s.leave_count;
+            totalVoice += s.voice_minutes;
+            totalCommands += s.command_count;
+        }
+
+        const embed = new EmbedBuilder()
+            .setTitle(trans('title'))
+            .setDescription(trans('description', { days: daysBack }))
+            .addFields(
+                { name: trans('messages'), value: totalMessages.toString(), inline: true },
+                { name: trans('commands'), value: totalCommands.toString(), inline: true },
+                { name: trans('joins'), value: totalJoins.toString(), inline: true },
+                { name: trans('leaves'), value: totalLeaves.toString(), inline: true },
+                { name: trans('voice'), value: `${Math.round(totalVoice)} min`, inline: true },
+            )
+            .setColor(0x5865F2)
+            .setTimestamp();
+
+        const replyPayload = { embeds: [embed] } as any;
+
+        if (message) {
+            await message.reply(replyPayload);
+        } else if (interaction) {
+            if (interaction.replied || interaction.deferred) {
+                await interaction.editReply(replyPayload);
+            } else {
+                await interaction.reply({ ...replyPayload, ephemeral: true });
+            }
+        }
+    }
+}

package/config.d.ts

@@ -0,0 +1,11 @@
+export declare class AnalyticsModuleConfig {
+    static defaultRetentionDays: number;
+    static cleanupIntervalHours: number;
+    static defaultTrackMessages: boolean;
+    static defaultTrackVoice: boolean;
+    static defaultTrackMembers: boolean;
+    static defaultTrackCommands: boolean;
+    static defaultTrackCommandPerformance: boolean;
+    static defaultTrackPerChannelVoice: boolean;
+    static configure(opts: Partial<typeof AnalyticsModuleConfig>): void;
+}

package/config.js

@@ -0,0 +1,13 @@
+export class AnalyticsModuleConfig {
+    static configure(opts) {
+        Object.assign(this, opts);
+    }
+}
+AnalyticsModuleConfig.defaultRetentionDays = 90;
+AnalyticsModuleConfig.cleanupIntervalHours = 24;
+AnalyticsModuleConfig.defaultTrackMessages = true;
+AnalyticsModuleConfig.defaultTrackVoice = true;
+AnalyticsModuleConfig.defaultTrackMembers = true;
+AnalyticsModuleConfig.defaultTrackCommands = true;
+AnalyticsModuleConfig.defaultTrackCommandPerformance = false;
+AnalyticsModuleConfig.defaultTrackPerChannelVoice = false;

package/config.ts

@@ -0,0 +1,14 @@
+export class AnalyticsModuleConfig {
+    static defaultRetentionDays = 90;
+    static cleanupIntervalHours = 24;
+    static defaultTrackMessages = true;
+    static defaultTrackVoice = true;
+    static defaultTrackMembers = true;
+    static defaultTrackCommands = true;
+    static defaultTrackCommandPerformance = false;
+    static defaultTrackPerChannelVoice = false;
+
+    static configure(opts: Partial<typeof AnalyticsModuleConfig>) {
+        Object.assign(this, opts);
+    }
+}

package/events/discord/GuildMemberAdd.d.ts

@@ -0,0 +1,7 @@
+import { FrameworkEvent } from 'zumito-framework';
+export declare class GuildMemberAdd extends FrameworkEvent {
+    once: boolean;
+    source: string;
+    private collector;
+    execute({ guildmember }: any): Promise<void>;
+}

package/events/discord/GuildMemberAdd.js

@@ -0,0 +1,24 @@
+import { FrameworkEvent } from 'zumito-framework';
+import { ServiceContainer } from 'zumito-framework';
+import { AnalyticsCollector } from '../../services/AnalyticsCollector.js';
+export class GuildMemberAdd extends FrameworkEvent {
+    constructor() {
+        super(...arguments);
+        this.once = false;
+        this.source = 'discord';
+        this.collector = ServiceContainer.getService(AnalyticsCollector);
+    }
+    async execute({ guildmember }) {
+        if (!guildmember?.guild?.id)
+            return;
+        const guildId = guildmember.guild.id;
+        await this.collector.recordMemberJoin(guildId);
+        try {
+            const memberCount = guildmember.guild.memberCount;
+            if (memberCount) {
+                await this.collector.recordMemberCount(guildId, memberCount);
+            }
+        }
+        catch (_) { /* ignore */ }
+    }
+}