@zumito-team/analytics-module 0.2.0 → 0.3.0

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@zumito-team/analytics-module",
-  "version": "0.2.0",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "0.3.0",
   "description": "Server analytics module with configurable tracking and optional panel integration",
   "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json && cp -r translations dist/ && cp -r views dist/"
   },

package/commands/AnalyticsConfig.ts

@@ -1,118 +0,0 @@
-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.ts

@@ -1,66 +0,0 @@
-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.ts

@@ -1,14 +0,0 @@
-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.ts

@@ -1,23 +0,0 @@
-import { FrameworkEvent } from 'zumito-framework';
-import { ServiceContainer } from 'zumito-framework';
-import { AnalyticsCollector } from '../../services/AnalyticsCollector.js';
-
-export class GuildMemberAdd extends FrameworkEvent {
-    once = false;
-    source = 'discord';
-
-    private collector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector;
-
-    async execute({ guildmember }: any): Promise<void> {
-        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 */ }
-    }
-}

package/events/discord/GuildMemberRemove.ts

@@ -1,23 +0,0 @@
-import { FrameworkEvent } from 'zumito-framework';
-import { ServiceContainer } from 'zumito-framework';
-import { AnalyticsCollector } from '../../services/AnalyticsCollector.js';
-
-export class GuildMemberRemove extends FrameworkEvent {
-    once = false;
-    source = 'discord';
-
-    private collector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector;
-
-    async execute({ guildmember }: any): Promise<void> {
-        if (!guildmember?.guild?.id) return;
-        const guildId = guildmember.guild.id;
-        await this.collector.recordMemberLeave(guildId);
-
-        try {
-            const memberCount = guildmember.guild.memberCount;
-            if (memberCount) {
-                await this.collector.recordMemberCount(guildId, memberCount);
-            }
-        } catch (_) { /* ignore */ }
-    }
-}

package/events/discord/MessageCreate.ts

@@ -1,16 +0,0 @@
-import { FrameworkEvent } from 'zumito-framework';
-import { ServiceContainer } from 'zumito-framework';
-import { AnalyticsCollector } from '../../services/AnalyticsCollector.js';
-
-export class MessageCreate extends FrameworkEvent {
-    once = false;
-    source = 'discord';
-
-    private collector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector;
-
-    async execute({ message }: any): Promise<void> {
-        if (!message.guildId) return;
-        if (message.author?.bot) return;
-        await this.collector.recordMessage(message.guildId);
-    }
-}

package/events/discord/VoiceStateUpdate.ts

@@ -1,31 +0,0 @@
-import { FrameworkEvent } from 'zumito-framework';
-import { ServiceContainer } from 'zumito-framework';
-import { AnalyticsCollector } from '../../services/AnalyticsCollector.js';
-
-export class VoiceStateUpdate extends FrameworkEvent {
-    once = false;
-    source = 'discord';
-
-    private collector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector;
-
-    async execute({ oldState, newState }: any): Promise<void> {
-        const guildId = newState?.guild?.id || oldState?.guild?.id;
-        if (!guildId) return;
-
-        const userId = newState?.id || oldState?.id;
-        if (!userId) return;
-
-        const oldChannelId = oldState?.channelId || null;
-        const newChannelId = newState?.channelId || null;
-
-        if (oldChannelId === newChannelId) return;
-
-        if (oldChannelId) {
-            await this.collector.recordVoiceLeave(guildId, oldChannelId, userId);
-        }
-
-        if (newChannelId) {
-            await this.collector.recordVoiceJoin(guildId, newChannelId, userId);
-        }
-    }
-}

package/events/framework/CommandExecuted.ts

@@ -1,16 +0,0 @@
-import { FrameworkEvent } from 'zumito-framework';
-import { ServiceContainer } from 'zumito-framework';
-import { AnalyticsCollector } from '../../services/AnalyticsCollector.js';
-
-export class CommandExecuted extends FrameworkEvent {
-    once = false;
-    source = 'framework';
-
-    private collector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector;
-
-    async execute(args: any): Promise<void> {
-        const payload = args.object || args;
-        if (!payload.guildId) return;
-        await this.collector.recordCommand(payload);
-    }
-}

package/index.ts

@@ -1,69 +0,0 @@
-import { Module, ServiceContainer } from 'zumito-framework';
-import { AnalyticsCollector } from './services/AnalyticsCollector.js';
-import { AnalyticsModuleConfig } from './config.js';
-
-export class AnalyticsModule extends Module {
-    static dependencies = [] as const;
-    static optionalDependencies = ['admin-module', 'user-panel-module'] as const;
-
-    constructor(modulePath: string = import.meta.url) {
-        super(modulePath);
-        ServiceContainer.addService(AnalyticsCollector, [], true);
-    }
-
-    async initialize(): Promise<void> {
-        await super.initialize();
-
-        try {
-            const { NavigationService } = await import('@zumito-team/admin-module/services/NavigationService.js');
-            const nav = ServiceContainer.getService(NavigationService);
-            nav.registerItem({
-                id: 'analytics',
-                icon: `<svg xmlns="http://www.w3.org/2000/svg" class="w-6 h-6 text-discord-white/60 group-hover:text-white" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 3v18h18"/><path d="M7 16l4-8 4 5 4-3"/></svg>`,
-                label: 'Analiticas',
-                url: '/admin/analytics',
-                order: 8,
-                category: 'modules',
-                sidebar: {
-                    showDropdown: false,
-                    sections: [
-                        {
-                            label: 'Analiticas',
-                            items: [
-                                { label: 'Dashboard', url: '/admin/analytics' },
-                            ],
-                        },
-                    ],
-                },
-            });
-        } catch (e) {
-            console.warn('[AnalyticsModule] Admin panel not available, skipping admin integration');
-        }
-
-        try {
-            const { UserPanelNavigationService } = await import('@zumito-team/user-panel-module/services/UserPanelNavigationService');
-            const nav = ServiceContainer.getService(UserPanelNavigationService);
-            nav.registerSubItems('dashboard', 'general', [
-                { id: 'analytics', label: 'analytics.sidebarTitle', url: '/panel/:guildId/analytics' },
-            ]);
-        } catch (e) {
-            console.warn('[AnalyticsModule] User panel not available, skipping user panel integration');
-        }
-
-        const collector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector;
-        collector.startCleanupScheduler();
-    }
-
-    async onAllReady(): Promise<void> {
-        const collector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector;
-        collector.clearVoiceSessions();
-    }
-}
-
-export { AnalyticsCollector } from './services/AnalyticsCollector.js';
-export type { CommandExecutedPayload } from './services/AnalyticsCollector.js';
-export { AnalyticsModuleConfig } from './config.js';
-export { GuildDailyStats } from './models/GuildDailyStats.js';
-export { CommandDailyStats } from './models/CommandDailyStats.js';
-export { VoiceChannelDailyStats } from './models/VoiceChannelDailyStats.js';
-export { GuildAnalyticsConfig } from './models/GuildAnalyticsConfig.js';

package/models/CommandDailyStats.ts

@@ -1,25 +0,0 @@
-import { Collection, Field } from 'zumito-framework';
-
-@Collection({ name: 'analytics_command_daily_stats' })
-export class CommandDailyStats {
-    @Field({ type: 'string', primary: true, unique: true })
-    id!: string;
-
-    @Field({ type: 'string' })
-    guild_id!: string;
-
-    @Field({ type: 'string' })
-    command_name!: string;
-
-    @Field({ type: 'string' })
-    date!: string;
-
-    @Field({ type: 'number', default: 0 })
-    usage_count!: number;
-
-    @Field({ type: 'number', default: 0 })
-    total_execution_time_ms!: number;
-
-    @Field({ type: 'number', default: 0 })
-    error_count!: number;
-}

package/models/GuildAnalyticsConfig.ts

@@ -1,34 +0,0 @@
-import { Collection, Field } from 'zumito-framework';
-
-@Collection({ name: 'analytics_guild_config' })
-export class GuildAnalyticsConfig {
-    @Field({ type: 'string', primary: true, unique: true })
-    guild_id!: string;
-
-    @Field({ type: 'boolean', default: true })
-    enabled!: boolean;
-
-    @Field({ type: 'boolean', default: true })
-    track_messages!: boolean;
-
-    @Field({ type: 'boolean', default: true })
-    track_voice!: boolean;
-
-    @Field({ type: 'boolean', default: true })
-    track_members!: boolean;
-
-    @Field({ type: 'boolean', default: true })
-    track_commands!: boolean;
-
-    @Field({ type: 'boolean', default: false })
-    track_command_performance!: boolean;
-
-    @Field({ type: 'boolean', default: false })
-    track_per_channel_voice!: boolean;
-
-    @Field({ type: 'number' })
-    retention_days!: number;
-
-    @Field({ type: 'boolean', default: false })
-    public_stats_page!: boolean;
-}

package/models/GuildDailyStats.ts

@@ -1,31 +0,0 @@
-import { Collection, Field } from 'zumito-framework';
-
-@Collection({ name: 'analytics_guild_daily_stats' })
-export class GuildDailyStats {
-    @Field({ type: 'string', primary: true, unique: true })
-    id!: string;
-
-    @Field({ type: 'string' })
-    guild_id!: string;
-
-    @Field({ type: 'string' })
-    date!: string;
-
-    @Field({ type: 'number', default: 0 })
-    message_count!: number;
-
-    @Field({ type: 'number', default: 0 })
-    join_count!: number;
-
-    @Field({ type: 'number', default: 0 })
-    leave_count!: number;
-
-    @Field({ type: 'number', default: 0 })
-    voice_minutes!: number;
-
-    @Field({ type: 'number', default: 0 })
-    command_count!: number;
-
-    @Field({ type: 'number', default: 0 })
-    member_count!: number;
-}

package/models/VoiceChannelDailyStats.ts

@@ -1,22 +0,0 @@
-import { Collection, Field } from 'zumito-framework';
-
-@Collection({ name: 'analytics_voice_channel_daily_stats' })
-export class VoiceChannelDailyStats {
-    @Field({ type: 'string', primary: true, unique: true })
-    id!: string;
-
-    @Field({ type: 'string' })
-    guild_id!: string;
-
-    @Field({ type: 'string' })
-    channel_id!: string;
-
-    @Field({ type: 'string' })
-    date!: string;
-
-    @Field({ type: 'number', default: 0 })
-    total_minutes!: number;
-
-    @Field({ type: 'number', default: 0 })
-    unique_users!: number;
-}

package/routes/AdminAnalytics.ts

@@ -1,69 +0,0 @@
-import { Route, RouteMethod, ServiceContainer } from 'zumito-framework';
-import path, { dirname } from 'path';
-import { fileURLToPath } from 'url';
-import ejs from 'ejs';
-import { Client } from 'zumito-framework/discord';
-import { AnalyticsCollector } from '../services/AnalyticsCollector.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-export class AdminAnalytics extends Route {
-    method = RouteMethod.get;
-    path = '/admin/analytics';
-
-    constructor(
-        private collector: AnalyticsCollector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector,
-        private client: Client = ServiceContainer.getService(Client),
-    ) {
-        super();
-    }
-
-    async execute(req: any, res: any): Promise<void> {
-        const { AdminAuthService } = await import('@zumito-team/admin-module/services/AdminAuthService.js');
-        const auth = await ServiceContainer.getService(AdminAuthService).isLoginValid(req);
-        if (!auth?.isValid) return res.redirect('/admin/login');
-
-        const daysBack = parseInt(req.query.days as string) || 7;
-
-        const summary = await this.collector.getGlobalStatsSummary(daysBack);
-        const guildGrowth = await this.collector.getGuildGrowth(daysBack);
-        const messagesPerDay = await this.collector.getMessagesPerDay(daysBack);
-        const commandsPerDay = await this.collector.getCommandsPerDay(null, daysBack);
-        const topCommands = await this.collector.getTopCommands(null, daysBack);
-        const slowestCommands = await this.collector.getSlowestCommands(null, daysBack);
-
-        const chartData = {
-            guildGrowth,
-            messagesPerDay,
-            commandsPerDay,
-            topCommands,
-            slowestCommands,
-        };
-
-        const { TranslationManager } = await import('zumito-framework');
-        const tm = ServiceContainer.getService(TranslationManager) as any;
-        const t = (key: string, params?: any) => tm.get(key, 'en', params);
-
-        const content = await ejs.renderFile(
-            path.resolve(__dirname, '../views/admin-analytics.ejs'),
-            {
-                summary,
-                chartData,
-                slowestCommands: slowestCommands.length > 0 ? slowestCommands : undefined,
-                t,
-                daysBack,
-            },
-        );
-
-        const { AdminViewService } = await import('@zumito-team/admin-module/services/AdminViewService.js');
-        const view = ServiceContainer.getService(AdminViewService);
-        const html = await view.render({
-            title: 'Analiticas',
-            content,
-            reqPath: this.path,
-            user: { name: 'Admin' },
-        });
-
-        res.send(html);
-    }
-}