discord-voice-tracker 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,266 @@
+import { GuildMember, VoiceBasedChannel, PermissionResolvable } from 'discord.js';
+/**
+ * Configuration options for the VoiceManager
+ */
+export interface VoiceManagerOptions {
+    /** Storage adapter to use */
+    storage: StorageAdapter;
+    /** Check interval in milliseconds (default: 5000) */
+    checkInterval?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Default configuration for new guilds */
+    defaultConfig?: Partial<GuildConfig>;
+}
+/**
+ * Guild-specific configuration
+ */
+export interface GuildConfig {
+    /** Guild ID */
+    guildId: string;
+    /** Track bots */
+    trackBots: boolean;
+    /** Track all voice channels */
+    trackAllChannels: boolean;
+    /** Specific channel IDs to track (if trackAllChannels is false) */
+    channelIds: string[];
+    /** Track muted users */
+    trackMuted: boolean;
+    /** Track deafened users */
+    trackDeafened: boolean;
+    /** Minimum users in channel to start tracking */
+    minUsersToTrack: number;
+    /** Maximum users in channel to track (0 = unlimited) */
+    maxUsersToTrack: number;
+    /** Permissions that exempt users from tracking */
+    exemptPermissions: PermissionResolvable[];
+    /** XP to award per check */
+    xpPerCheck: number;
+    /** Voice time to add per check (milliseconds) */
+    voiceTimePerCheck: number;
+    /** Level calculation multiplier */
+    levelMultiplier: number;
+    /** Enable XP/leveling system */
+    enableLeveling: boolean;
+    /** Enable voice time tracking */
+    enableVoiceTime: boolean;
+    /** Custom channel filter function */
+    channelFilter?: (channel: VoiceBasedChannel) => boolean | Promise<boolean>;
+    /** Custom member filter function */
+    memberFilter?: (member: GuildMember) => boolean | Promise<boolean>;
+}
+/**
+ * User voice data
+ */
+export interface UserData {
+    /** User ID */
+    userId: string;
+    /** Guild ID */
+    guildId: string;
+    /** Total voice time in milliseconds */
+    totalVoiceTime: number;
+    /** Current XP */
+    xp: number;
+    /** Current level */
+    level: number;
+    /** Voice time per channel */
+    channels: ChannelData[];
+    /** Last seen timestamp */
+    lastSeen: Date;
+    /** Current streak (consecutive days) */
+    streak: number;
+    /** Total sessions */
+    totalSessions: number;
+    /** Custom user data */
+    metadata?: Record<string, any>;
+}
+/**
+ * Channel-specific voice data
+ */
+export interface ChannelData {
+    /** Channel ID */
+    channelId: string;
+    /** Voice time in this channel (milliseconds) */
+    voiceTime: number;
+    /** Number of sessions in this channel */
+    sessions: number;
+    /** Last activity timestamp */
+    lastActivity: Date;
+}
+/**
+ * Voice session data
+ */
+export interface SessionData {
+    /** Session ID */
+    sessionId: string;
+    /** User ID */
+    userId: string;
+    /** Guild ID */
+    guildId: string;
+    /** Channel ID */
+    channelId: string;
+    /** Session start time */
+    startTime: Date;
+    /** Session end time */
+    endTime?: Date;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** XP earned in this session */
+    xpEarned: number;
+    /** Was user muted */
+    wasMuted: boolean;
+    /** Was user deafened */
+    wasDeafened: boolean;
+}
+/**
+ * Guild data container
+ */
+export interface GuildData {
+    /** Guild ID */
+    guildId: string;
+    /** Guild configuration */
+    config: GuildConfig;
+    /** All users in this guild */
+    users: Map<string, UserData>;
+    /** Last updated timestamp */
+    lastUpdated: Date;
+}
+/**
+ * Leaderboard entry
+ */
+export interface LeaderboardEntry {
+    /** User ID */
+    userId: string;
+    /** Guild ID */
+    guildId: string;
+    /** Total voice time */
+    voiceTime: number;
+    /** XP */
+    xp: number;
+    /** Level */
+    level: number;
+    /** Rank */
+    rank: number;
+}
+/**
+ * Statistics for a user or guild
+ */
+export interface Statistics {
+    /** Total voice time */
+    totalVoiceTime: number;
+    /** Total XP */
+    totalXp: number;
+    /** Average session duration */
+    avgSessionDuration: number;
+    /** Total sessions */
+    totalSessions: number;
+    /** Most active channel */
+    mostActiveChannel?: string;
+    /** Daily breakdown */
+    dailyStats: DailyStats[];
+}
+/**
+ * Daily statistics
+ */
+export interface DailyStats {
+    /** Date */
+    date: string;
+    /** Voice time that day */
+    voiceTime: number;
+    /** XP earned that day */
+    xp: number;
+    /** Sessions that day */
+    sessions: number;
+}
+/**
+ * Storage adapter interface
+ */
+export interface StorageAdapter {
+    /** Initialize the storage */
+    init(): Promise<void>;
+    /** Get guild data */
+    getGuild(guildId: string): Promise<GuildData | null>;
+    /** Save guild data */
+    saveGuild(guildData: GuildData): Promise<void>;
+    /** Delete guild data */
+    deleteGuild(guildId: string): Promise<void>;
+    /** Get user data */
+    getUser(guildId: string, userId: string): Promise<UserData | null>;
+    /** Save user data */
+    saveUser(guildId: string, userData: UserData): Promise<void>;
+    /** Delete user data */
+    deleteUser(guildId: string, userId: string): Promise<void>;
+    /** Get all guilds */
+    getAllGuilds(): Promise<GuildData[]>;
+    /** Get leaderboard */
+    getLeaderboard(guildId: string, sortBy: 'voiceTime' | 'xp' | 'level', limit: number, offset: number): Promise<LeaderboardEntry[]>;
+    /** Save session */
+    saveSession(session: SessionData): Promise<void>;
+    /** Get user sessions */
+    getSessions(guildId: string, userId: string, limit?: number): Promise<SessionData[]>;
+    /** Close storage connection */
+    close(): Promise<void>;
+}
+/**
+ * Event types
+ */
+export interface VoiceEvents {
+    /** User gained voice time */
+    voiceTimeGained: (userData: UserData, gained: number) => void;
+    /** User gained XP */
+    xpGained: (userData: UserData, gained: number) => void;
+    /** User leveled up */
+    levelUp: (userData: UserData, oldLevel: number, newLevel: number) => void;
+    /** User started voice session */
+    sessionStart: (session: SessionData) => void;
+    /** User ended voice session */
+    sessionEnd: (session: SessionData) => void;
+    /** Guild configuration updated */
+    configUpdated: (guildId: string, config: GuildConfig) => void;
+    /** Error occurred */
+    error: (error: Error) => void;
+    /** Debug message */
+    debug: (message: string) => void;
+}
+/**
+ * Update options for user data
+ */
+export interface UserUpdateOptions {
+    /** Add voice time */
+    addVoiceTime?: number;
+    /** Add XP */
+    addXp?: number;
+    /** Set level */
+    setLevel?: number;
+    /** Update metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Query options for leaderboard
+ */
+export interface LeaderboardOptions {
+    /** Sort by field */
+    sortBy?: 'voiceTime' | 'xp' | 'level';
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Filter by minimum level */
+    minLevel?: number;
+    /** Filter by minimum XP */
+    minXp?: number;
+}
+/**
+ * Migration data structure
+ */
+export interface MigrationData {
+    /** Version migrating from */
+    fromVersion: string;
+    /** Version migrating to */
+    toVersion: string;
+    /** Guild data to migrate */
+    guilds: any[];
+    /** Timestamp */
+    timestamp: Date;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+// src/types/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA,qBAAqB"}

package/dist/utils/Calculator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * XP and Level calculation utility
+ */
+export declare class XPCalculator {
+    /**
+     * Calculate level from XP
+     * Formula: level = multiplier * sqrt(xp)
+     */
+    calculateLevel(xp: number, multiplier?: number): number;
+    /**
+     * Calculate XP needed for a specific level
+     */
+    calculateXPForLevel(level: number, multiplier?: number): number;
+    /**
+     * Calculate XP needed to reach next level
+     */
+    calculateXPToNextLevel(currentXP: number, multiplier?: number): number;
+    /**
+     * Calculate progress percentage to next level
+     */
+    calculateLevelProgress(currentXP: number, multiplier?: number): number;
+    /**
+     * Format voice time to readable string
+     */
+    formatVoiceTime(milliseconds: number): string;
+    /**
+     * Calculate average session duration
+     */
+    calculateAverageSessionDuration(totalVoiceTime: number, totalSessions: number): number;
+}
+//# sourceMappingURL=Calculator.d.ts.map

package/dist/utils/Calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Calculator.d.ts","sourceRoot":"","sources":["../../src/utils/Calculator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,MAAM;IAI5D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,MAAM;IAIpE;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,MAAM;IAM3E;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,MAAM;IAS3E;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAiB7C;;OAEG;IACH,+BAA+B,CAC7B,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM;CAIV"}

package/dist/utils/Calculator.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XPCalculator = void 0;
+/**
+ * XP and Level calculation utility
+ */
+class XPCalculator {
+    /**
+     * Calculate level from XP
+     * Formula: level = multiplier * sqrt(xp)
+     */
+    calculateLevel(xp, multiplier = 0.1) {
+        return Math.floor(multiplier * Math.sqrt(xp));
+    }
+    /**
+     * Calculate XP needed for a specific level
+     */
+    calculateXPForLevel(level, multiplier = 0.1) {
+        return Math.pow(level / multiplier, 2);
+    }
+    /**
+     * Calculate XP needed to reach next level
+     */
+    calculateXPToNextLevel(currentXP, multiplier = 0.1) {
+        const currentLevel = this.calculateLevel(currentXP, multiplier);
+        const nextLevelXP = this.calculateXPForLevel(currentLevel + 1, multiplier);
+        return nextLevelXP - currentXP;
+    }
+    /**
+     * Calculate progress percentage to next level
+     */
+    calculateLevelProgress(currentXP, multiplier = 0.1) {
+        const currentLevel = this.calculateLevel(currentXP, multiplier);
+        const currentLevelXP = this.calculateXPForLevel(currentLevel, multiplier);
+        const nextLevelXP = this.calculateXPForLevel(currentLevel + 1, multiplier);
+        const progress = (currentXP - currentLevelXP) / (nextLevelXP - currentLevelXP);
+        return Math.round(progress * 100);
+    }
+    /**
+     * Format voice time to readable string
+     */
+    formatVoiceTime(milliseconds) {
+        const seconds = Math.floor(milliseconds / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        const days = Math.floor(hours / 24);
+        if (days > 0) {
+            return `${days}d ${hours % 24}h ${minutes % 60}m`;
+        }
+        else if (hours > 0) {
+            return `${hours}h ${minutes % 60}m`;
+        }
+        else if (minutes > 0) {
+            return `${minutes}m ${seconds % 60}s`;
+        }
+        else {
+            return `${seconds}s`;
+        }
+    }
+    /**
+     * Calculate average session duration
+     */
+    calculateAverageSessionDuration(totalVoiceTime, totalSessions) {
+        if (totalSessions === 0)
+            return 0;
+        return totalVoiceTime / totalSessions;
+    }
+}
+exports.XPCalculator = XPCalculator;
+//# sourceMappingURL=Calculator.js.map

package/dist/utils/Calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Calculator.js","sourceRoot":"","sources":["../../src/utils/Calculator.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,YAAY;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAU,EAAE,aAAqB,GAAG;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,KAAa,EAAE,aAAqB,GAAG;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,SAAiB,EAAE,aAAqB,GAAG;QAChE,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;QAC3E,OAAO,WAAW,GAAG,SAAS,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,SAAiB,EAAE,aAAqB,GAAG;QAChE,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC1E,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;QAE3E,MAAM,QAAQ,GAAG,CAAC,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,WAAW,GAAG,cAAc,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,YAAoB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAEpC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;QACpD,CAAC;aAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;QACtC,CAAC;aAAM,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,OAAO,GAAG,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,+BAA+B,CAC7B,cAAsB,EACtB,aAAqB;QAErB,IAAI,aAAa,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAClC,OAAO,cAAc,GAAG,aAAa,CAAC;IACxC,CAAC;CACF;AAnED,oCAmEC"}

package/dist/utils/Logger.d.ts

@@ -0,0 +1,9 @@
+export declare class Logger {
+    private debugEnabled;
+    constructor(debug?: boolean);
+    log(message: string, ...args: any[]): void;
+    error(message: string, error?: any): void;
+    warn(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/utils/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/utils/Logger.ts"],"names":[],"mappings":"AAAA,qBAAa,MAAM;IACjB,OAAO,CAAC,YAAY,CAAU;gBAElB,KAAK,GAAE,OAAe;IAIlC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI1C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI;IAIzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAK7C"}

package/dist/utils/Logger.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+class Logger {
+    debugEnabled;
+    constructor(debug = false) {
+        this.debugEnabled = debug;
+    }
+    log(message, ...args) {
+        console.log(`[VoiceTracker] ${message}`, ...args);
+    }
+    error(message, error) {
+        console.error(`[VoiceTracker ERROR] ${message}`, error);
+    }
+    warn(message, ...args) {
+        console.warn(`[VoiceTracker WARN] ${message}`, ...args);
+    }
+    debug(message, ...args) {
+        if (this.debugEnabled) {
+            console.log(`[VoiceTracker DEBUG] ${message}`, ...args);
+        }
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=Logger.js.map

package/dist/utils/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/utils/Logger.ts"],"names":[],"mappings":";;;AAAA,MAAa,MAAM;IACT,YAAY,CAAU;IAE9B,YAAY,QAAiB,KAAK;QAChC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,GAAG,IAAW;QACjC,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAW;QAChC,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,OAAO,CAAC,IAAI,CAAC,uBAAuB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,wBAAwB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF;AAxBD,wBAwBC"}

package/dist/utils/Validator.d.ts

@@ -0,0 +1,19 @@
+import { GuildConfig } from '../types';
+/**
+ * Input validation utility
+ */
+export declare class Validator {
+    /**
+     * Validate guild configuration
+     */
+    static validateGuildConfig(config: Partial<GuildConfig>): string[];
+    /**
+     * Validate user ID (Discord snowflake)
+     */
+    static validateSnowflake(id: string): boolean;
+    /**
+     * Validate pagination parameters
+     */
+    static validatePagination(limit: number, offset: number): string[];
+}
+//# sourceMappingURL=Validator.d.ts.map

package/dist/utils/Validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.d.ts","sourceRoot":"","sources":["../../src/utils/Validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE;IA2ClE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;CAanE"}

package/dist/utils/Validator.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validator = void 0;
+/**
+ * Input validation utility
+ */
+class Validator {
+    /**
+     * Validate guild configuration
+     */
+    static validateGuildConfig(config) {
+        const errors = [];
+        if (config.minUsersToTrack !== undefined && config.minUsersToTrack < 0) {
+            errors.push('minUsersToTrack must be >= 0');
+        }
+        if (config.maxUsersToTrack !== undefined && config.maxUsersToTrack < 0) {
+            errors.push('maxUsersToTrack must be >= 0');
+        }
+        if (config.minUsersToTrack !== undefined &&
+            config.maxUsersToTrack !== undefined &&
+            config.maxUsersToTrack > 0 &&
+            config.minUsersToTrack > config.maxUsersToTrack) {
+            errors.push('minUsersToTrack cannot be greater than maxUsersToTrack');
+        }
+        if (config.xpPerCheck !== undefined && config.xpPerCheck < 0) {
+            errors.push('xpPerCheck must be >= 0');
+        }
+        if (config.voiceTimePerCheck !== undefined && config.voiceTimePerCheck < 0) {
+            errors.push('voiceTimePerCheck must be >= 0');
+        }
+        if (config.levelMultiplier !== undefined && config.levelMultiplier <= 0) {
+            errors.push('levelMultiplier must be > 0');
+        }
+        if (config.channelIds !== undefined && !Array.isArray(config.channelIds)) {
+            errors.push('channelIds must be an array');
+        }
+        if (config.exemptPermissions !== undefined && !Array.isArray(config.exemptPermissions)) {
+            errors.push('exemptPermissions must be an array');
+        }
+        return errors;
+    }
+    /**
+     * Validate user ID (Discord snowflake)
+     */
+    static validateSnowflake(id) {
+        return /^\d{17,19}$/.test(id);
+    }
+    /**
+     * Validate pagination parameters
+     */
+    static validatePagination(limit, offset) {
+        const errors = [];
+        if (limit < 1 || limit > 100) {
+            errors.push('limit must be between 1 and 100');
+        }
+        if (offset < 0) {
+            errors.push('offset must be >= 0');
+        }
+        return errors;
+    }
+}
+exports.Validator = Validator;
+//# sourceMappingURL=Validator.js.map

package/dist/utils/Validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.js","sourceRoot":"","sources":["../../src/utils/Validator.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAA4B;QACrD,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,MAAM,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,MAAM,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC9C,CAAC;QAED,IACE,MAAM,CAAC,eAAe,KAAK,SAAS;YACpC,MAAM,CAAC,eAAe,KAAK,SAAS;YACpC,MAAM,CAAC,eAAe,GAAG,CAAC;YAC1B,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,EAC/C,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI,MAAM,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAC3E,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,MAAM,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC;YACxE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACzE,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACvF,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,EAAU;QACjC,OAAO,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAa,EAAE,MAAc;QACrD,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAtED,8BAsEC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "discord-voice-tracker",
+  "version": "1.0.0",
+  "description": "Modern voice activity tracking for Discord bots with XP, leveling, and comprehensive statistics",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepublishOnly": "npm run build",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "discord",
+    "discord.js",
+    "voice",
+    "voice-tracking",
+    "voice-time",
+    "tracking",
+    "bot",
+    "discord-bot",
+    "leveling",
+    "xp",
+    "leaderboard",
+    "statistics",
+    "analytics",
+    "voice-chat",
+    "mongodb",
+    "typescript"
+  ],
+  "author": "Async",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Instinzts/discord-voice-tracker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Instinzts/discord-voice-tracker/issues"
+  },
+  "homepage": "https://github.com/Instinzts/discord-voice-tracker#readme",
+  "peerDependencies": {
+    "discord.js": "^14.0.0"
+  },
+  "dependencies": {},
+  "optionalDependencies": {
+    "mongodb": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.10",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "discord.js": "^14.25.1",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.39.2",
+    "jest": "^30.2.0",
+    "mongodb": "^7.0.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}