@zumito-team/analytics-module 0.4.0 → 0.6.0

package/README.md

@@ -8,11 +8,11 @@
 npm install @zumito-team/analytics-module
 ```
 
-Add to your `zumito.config.ts`:
+Add to your `zumito.config.ts` (note the `/dist` suffix):
 
 ```ts
 {
-    path: path.join(__dirname, "node_modules", "@zumito-team", "analytics-module"),
+    path: path.join(__dirname, "node_modules", "@zumito-team", "analytics-module", "dist"),
 }
 ```
 

package/{services → dist/services}/AnalyticsCollector.js

@@ -15,7 +15,7 @@ export class AnalyticsCollector {
         this.cleanupTimer = null;
     }
     repo(name) {
-        return this.repo(name);
+        return this.db.getRepository(name);
     }
     // ── Event recording ──────────────────────────────────────────
     async ensuredConfig(guildId) {

package/package.json

@@ -1,26 +1,16 @@
 {
   "name": "@zumito-team/analytics-module",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Server analytics module with configurable tracking and optional panel integration",
   "type": "module",
-  "main": "index.js",
-  "types": "index.d.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "files": [
-    "commands",
-    "events",
-    "models",
-    "services",
-    "routes",
-    "translations",
-    "views",
-    "config.js",
-    "config.d.ts",
-    "index.js",
-    "index.d.ts",
+    "dist",
     "README.md"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json"
+    "build": "tsc -p tsconfig.json && cp -r translations dist/ && cp -r views dist/"
   },
   "dependencies": {
     "@zumito-team/admin-module": "^1.8.0",

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/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/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);
-    }
-}

package/routes/UserPanelAnalytics.ts

@@ -1,101 +0,0 @@
-import { Route, RouteMethod, ServiceContainer } from 'zumito-framework';
-import path, { dirname } from 'path';
-import { fileURLToPath } from 'url';
-import ejs from 'ejs';
-import { Client, PermissionFlagsBits } from 'zumito-framework/discord';
-import { AnalyticsCollector } from '../services/AnalyticsCollector.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-export class UserPanelAnalytics extends Route {
-    method = RouteMethod.get;
-    path = '/panel/:guildId/analytics';
-
-    constructor(
-        private collector: AnalyticsCollector = ServiceContainer.getService(AnalyticsCollector) as AnalyticsCollector,
-        private client: Client = ServiceContainer.getService(Client) as Client,
-    ) {
-        super();
-    }
-
-    async execute(req: any, res: any): Promise<void> {
-        const { UserPanelAuthService } = await import('@zumito-team/user-panel-module/services/UserPanelAuthService');
-        const { UserPanelViewService } = await import('@zumito-team/user-panel-module/services/UserPanelViewService');
-        const { UserPanelLanguageManager } = await import('@zumito-team/user-panel-module/services/UserPanelLanguageManager');
-
-        const authService = ServiceContainer.getService(UserPanelAuthService);
-        const authData = await authService.isLoginValid(req);
-        if (!authData.isValid) return res.redirect('/panel/login');
-
-        const userId = authData.data.discordUserData.id;
-        const guildId = req.params.guildId as string;
-        const guild = this.client.guilds.cache.get(guildId);
-        if (!guild) return res.status(404).send('Server not found');
-
-        let member = guild.members.cache.get(userId);
-        if (!member) member = await guild.members.fetch(userId).catch(() => null);
-        if (!member || !(
-            member.permissions.has(PermissionFlagsBits.Administrator) ||
-            member.permissions.has(PermissionFlagsBits.ManageGuild) ||
-            guild.ownerId === userId
-        )) {
-            return res.status(403).send('No tienes permisos en este servidor');
-        }
-
-        const daysBack = parseInt(req.query.days as string) || 7;
-        const langMgr = ServiceContainer.getService(UserPanelLanguageManager);
-        const { t } = langMgr.getLanguageVariables(req, res);
-
-        const stats = await this.collector.getGuildStats(guildId, daysBack);
-
-        let guildSummary = {
-            totalMessages: 0, totalJoins: 0, totalLeaves: 0,
-            totalVoiceMinutes: 0, totalCommands: 0,
-        };
-        const joinsPerDay: { date: string; count: number }[] = [];
-        const leavesPerDay: { date: string; count: number }[] = [];
-        const messagesPerDay: { date: string; count: number }[] = [];
-        const voicePerDay: { date: string; count: number }[] = [];
-
-        for (const s of stats) {
-            guildSummary.totalMessages += s.message_count;
-            guildSummary.totalJoins += s.join_count;
-            guildSummary.totalLeaves += s.leave_count;
-            guildSummary.totalVoiceMinutes += s.voice_minutes;
-            guildSummary.totalCommands += s.command_count;
-
-            messagesPerDay.push({ date: s.date, count: s.message_count });
-            joinsPerDay.push({ date: s.date, count: s.join_count });
-            leavesPerDay.push({ date: s.date, count: s.leave_count });
-            voicePerDay.push({ date: s.date, count: s.voice_minutes });
-        }
-
-        const commandsPerDay = await this.collector.getCommandsPerDay(guildId, daysBack);
-        const topCommands = await this.collector.getTopCommands(guildId, daysBack);
-        const slowestCommands = await this.collector.getSlowestCommands(guildId, daysBack);
-        const channelVoice = await this.collector.getVoiceChannelStats(guildId, daysBack);
-
-        const chartData = {
-            messagesPerDay, joinsPerDay, leavesPerDay, voicePerDay,
-            commandsPerDay, topCommands, slowestCommands, channelVoice,
-        };
-
-        const config = await this.collector.getConfig(guildId);
-
-        const content = await ejs.renderFile(
-            path.resolve(__dirname, '../views/user-analytics.ejs'),
-            {
-                guildSummary,
-                chartData,
-                slowestCommands: (config.track_command_performance && slowestCommands.length > 0) ? slowestCommands : undefined,
-                channelVoice: (config.track_per_channel_voice && channelVoice.length > 0) ? channelVoice : undefined,
-                t,
-                daysBack,
-            },
-        );
-
-        const view = ServiceContainer.getService(UserPanelViewService);
-        const html = await view.render({ content, reqPath: req.path, req, res });
-        res.send(html);
-    }
-}