@discordanalytics/core 2.8.2 → 2.9.0

package/dist/index.d.mts

@@ -0,0 +1,202 @@
+//#region src/types.d.ts
+declare const ApiEndpoints: {
+  BASE_URL: string;
+  EDIT_SETTINGS_URL: string;
+  EDIT_STATS_URL: string;
+  EVENT_URL: string;
+};
+declare const ErrorCodes: {
+  INVALID_CLIENT_TYPE: string;
+  CLIENT_NOT_READY: string;
+  INVALID_RESPONSE: string;
+  INVALID_API_TOKEN: string;
+  DATA_NOT_SENT: string;
+  SUSPENDED_BOT: string;
+  INSTANCE_NOT_INITIALIZED: string;
+  INVALID_EVENTS_COUNT: string;
+  INVALID_VALUE_TYPE: string;
+  INVALID_EVENT_KEY: string;
+  MAX_RETRIES_EXCEEDED: string;
+};
+type Locale = 'id' | 'en-US' | 'en-GB' | 'bg' | 'zh-CN' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'fi' | 'fr' | 'de' | 'el' | 'hi' | 'hu' | 'it' | 'ja' | 'ko' | 'lt' | 'no' | 'pl' | 'pt-BR' | 'ro' | 'ru' | 'es-ES' | 'sv-SE' | 'th' | 'tr' | 'uk' | 'vi';
+declare enum InteractionType {
+  Ping = 1,
+  ApplicationCommand = 2,
+  MessageComponent = 3,
+  ApplicationCommandAutocomplete = 4,
+  ModalSubmit = 5
+}
+declare enum ApplicationCommandType {
+  ChatInputCommand = 1,
+  UserCommand = 2,
+  MessageCommand = 3
+}
+interface InteractionData {
+  commandType?: ApplicationCommandType;
+  name: string;
+  number: number;
+  type: InteractionType;
+}
+interface LocaleData {
+  locale: Locale;
+  number: number;
+}
+interface GuildData {
+  guildId: string;
+  icon: string | null;
+  interactions: number;
+  members: number;
+  name: string;
+}
+interface GuildMembersData {
+  little: number;
+  medium: number;
+  big: number;
+  huge: number;
+}
+interface UsersTypeData {
+  admin: number;
+  moderator: number;
+  newMember: number;
+  other: number;
+  privateMessage: number;
+}
+interface StatsData {
+  date: string;
+  addedGuilds: number;
+  customEvents: Record<string, number>;
+  guilds: GuildData[];
+  guildCount: number;
+  guildLocales: LocaleData[];
+  guildMembers: GuildMembersData;
+  interactions: InteractionData[];
+  interactionsLocales: LocaleData[];
+  removedGuilds: number;
+  userCount: number;
+  userInstallCount: number;
+  usersType: UsersTypeData;
+}
+interface AnalyticsOptions<TClient = unknown> {
+  client: TClient;
+  api_key: string;
+  api_url?: string;
+  sharded?: boolean;
+  debug?: boolean;
+}
+type TrackGuildType = 'create' | 'delete';
+//#endregion
+//#region src/index.d.ts
+/**
+ * DiscordAnalytics Base Class
+ * @class AnalyticsBase
+ * @description Base class for DiscordAnalytics
+ * @param {string} api_key The API key for DiscordAnalytics
+ * @param {boolean} debug Optional flag to enable debug mode /!\ MUST BE USED ONLY FOR DEBUGGING PURPOSES
+ * @returns {AnalyticsBase} An instance of the AnalyticsBase class
+ * @example
+ * const analytics = new AnalyticsBase('YOUR_API_KEY');
+ * analytics.sendStats('YOUR_CLIENT_ID', 0, 0);
+ */
+declare class AnalyticsBase {
+  private readonly _api_key;
+  private readonly _headers;
+  private readonly debug_mode;
+  readonly _api_url: string;
+  stats_data: StatsData;
+  client_id: string;
+  constructor(api_key: string, api_url?: string, debug?: boolean);
+  debug(...args: unknown[]): void;
+  error(content: unknown, exit?: boolean): void;
+  /**
+   * Custom events
+   * /!\ Advanced users only
+   * /!\ You need to initialize the class first
+   * @param event_key The event key to track
+   * @returns {CustomEvent} The CustomEvent instance
+   * @example
+   * const event = analytics.events('my_custom_event');
+   * event.increment(1);
+   * event.decrement(1);
+   * event.set(10);
+   */
+  events(event_key: string): CustomEvent;
+  updateOrInsert<T>(array: T[], match: (item: T) => boolean, update: (item: T) => void, insert: () => T): void;
+  calculateGuildMembers(guildMembers: number[]): {
+    little: number;
+    medium: number;
+    big: number;
+    huge: number;
+  };
+  /**
+   * Track guilds
+   * /!\ Advanced users only
+   * /!\ You need to initialize the class first
+   * @param {TrackGuildType} type 'create' if the event is guildCreate and 'delete' if is guildDelete
+   */
+  trackGuilds(type: TrackGuildType): void;
+  /**
+   * API call with retries
+   * @param method The HTTP method to use (GET, POST, PUT, DELETE)
+   * @param url The URL to call
+   * @param body The body to send (optional)
+   * @param max_retries The maximum number of retries (default: 5)
+   * @param backoff_factor The backoff factor to use (default: 0.5)
+   * @returns {Promise<void | Response>} The response from the API
+   */
+  api_call_with_retries(method: string, endpoint: string, body?: string, max_retries?: number, backoff_factor?: number): Promise<void | Response>;
+  updateBotInformations(username: string, framework: string, version: string, avatar: string | null): Promise<void>;
+  /**
+   * Send stats to the API
+   * @param client_id The client ID of the bot
+   * @param guild_count The number of guilds the bot is in (default: 0)
+   * @param user_count The number of users the bot is in (default: 0)
+   * @param user_install_count The number of user installs (default: 0)
+   * @param guild_members The number of members in each guild (optional)
+   * @returns {Promise<void>} A promise that resolves when the stats are sent
+   */
+  sendStats(client_id: string, guild_count?: number, user_count?: number, user_install_count?: number, guild_members?: number[]): Promise<void>;
+}
+/**
+ * CustomEvent class
+ * @class CustomEvent
+ * @description Class for custom events
+ * @param {AnalyticsBase} analytics The AnalyticsBase instance
+ * @param {string} event_key The event key to track
+ * @returns {CustomEvent} An instance of the CustomEvent class
+ * @example
+ * const event = analytics.events('my_custom_event');
+ * event.increment(1);
+ * event.decrement(1);
+ * event.set(10);
+ * event.get();
+ */
+declare class CustomEvent {
+  private readonly _analytics;
+  private readonly _event_key;
+  private _last_action;
+  constructor(analytics: AnalyticsBase, event_key: string);
+  private ensure;
+  /**
+   * Increment the event by a value
+   * @param value The value to increment the event by (default: 1)
+   */
+  increment(value?: number): void;
+  /**
+   * Decrement the event by a value
+   * @param value The value to decrement the event by (default: 1)
+   */
+  decrement(value?: number): void;
+  /**
+   * Set the event to a value
+   * @param value The value to set the event to
+   */
+  set(value: number): void;
+  /**
+   * Get the event value
+   * @returns {number} The event value
+   */
+  get(): number;
+}
+//#endregion
+export { AnalyticsBase, AnalyticsOptions, ApiEndpoints, ApplicationCommandType, CustomEvent, ErrorCodes, GuildData, GuildMembersData, InteractionData, InteractionType, Locale, LocaleData, StatsData, TrackGuildType, UsersTypeData };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,297 @@
+//#region src/types.ts
+const ApiEndpoints = {
+	BASE_URL: "https://discordanalytics.xyz/api",
+	EDIT_SETTINGS_URL: `/bots/{id}`,
+	EDIT_STATS_URL: `/bots/{id}/stats`,
+	EVENT_URL: `/bots/{id}/events/{event}`
+};
+const ErrorCodes = {
+	INVALID_CLIENT_TYPE: "Invalid client type, please use a valid client.",
+	CLIENT_NOT_READY: "Client is not ready, please start the client first.",
+	INVALID_RESPONSE: "Invalid response from the API, please try again later.",
+	INVALID_API_TOKEN: "Invalid API token, please get one at " + ApiEndpoints.BASE_URL.split("/api")[0] + " and try again.",
+	DATA_NOT_SENT: "Data cannot be sent to the API, I will try again in a minute.",
+	SUSPENDED_BOT: "Your bot has been suspended, please check your mailbox for more information.",
+	INSTANCE_NOT_INITIALIZED: "It seem that you didn't initialize your instance. Please check the docs for more informations.",
+	INVALID_EVENTS_COUNT: "invalid events count",
+	INVALID_VALUE_TYPE: "invalid value type",
+	INVALID_EVENT_KEY: "invalid event key",
+	MAX_RETRIES_EXCEEDED: "Max retries exceeded, please check your network connection or the API status."
+};
+let InteractionType = /* @__PURE__ */ function(InteractionType) {
+	InteractionType[InteractionType["Ping"] = 1] = "Ping";
+	InteractionType[InteractionType["ApplicationCommand"] = 2] = "ApplicationCommand";
+	InteractionType[InteractionType["MessageComponent"] = 3] = "MessageComponent";
+	InteractionType[InteractionType["ApplicationCommandAutocomplete"] = 4] = "ApplicationCommandAutocomplete";
+	InteractionType[InteractionType["ModalSubmit"] = 5] = "ModalSubmit";
+	return InteractionType;
+}({});
+let ApplicationCommandType = /* @__PURE__ */ function(ApplicationCommandType) {
+	ApplicationCommandType[ApplicationCommandType["ChatInputCommand"] = 1] = "ChatInputCommand";
+	ApplicationCommandType[ApplicationCommandType["UserCommand"] = 2] = "UserCommand";
+	ApplicationCommandType[ApplicationCommandType["MessageCommand"] = 3] = "MessageCommand";
+	return ApplicationCommandType;
+}({});
+//#endregion
+//#region src/index.ts
+/**
+* DiscordAnalytics Base Class
+* @class AnalyticsBase
+* @description Base class for DiscordAnalytics
+* @param {string} api_key The API key for DiscordAnalytics
+* @param {boolean} debug Optional flag to enable debug mode /!\ MUST BE USED ONLY FOR DEBUGGING PURPOSES
+* @returns {AnalyticsBase} An instance of the AnalyticsBase class
+* @example
+* const analytics = new AnalyticsBase('YOUR_API_KEY');
+* analytics.sendStats('YOUR_CLIENT_ID', 0, 0);
+*/
+var AnalyticsBase = class {
+	constructor(api_key, api_url = ApiEndpoints.BASE_URL, debug = false) {
+		this.debug_mode = false;
+		this.stats_data = {
+			date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+			addedGuilds: 0,
+			customEvents: {},
+			guilds: [],
+			guildCount: 0,
+			guildLocales: [],
+			guildMembers: {
+				little: 0,
+				medium: 0,
+				big: 0,
+				huge: 0
+			},
+			interactions: [],
+			interactionsLocales: [],
+			removedGuilds: 0,
+			userCount: 0,
+			userInstallCount: 0,
+			usersType: {
+				admin: 0,
+				moderator: 0,
+				newMember: 0,
+				other: 0,
+				privateMessage: 0
+			}
+		};
+		this.client_id = "";
+		this._api_key = api_key;
+		this._api_url = api_url;
+		this.debug_mode = debug;
+		this._headers = {
+			"Content-Type": "application/json",
+			Authorization: `Bot ${this._api_key}`
+		};
+	}
+	debug(...args) {
+		if (this.debug_mode) console.debug(...args);
+	}
+	error(content, exit = false) {
+		console.error(content);
+		if (exit) process.exit(1);
+	}
+	/**
+	* Custom events
+	* /!\ Advanced users only
+	* /!\ You need to initialize the class first
+	* @param event_key The event key to track
+	* @returns {CustomEvent} The CustomEvent instance
+	* @example
+	* const event = analytics.events('my_custom_event');
+	* event.increment(1);
+	* event.decrement(1);
+	* event.set(10);
+	*/
+	events(event_key) {
+		this.debug(`[DISCORDANALYTICS] Getting event ${event_key}`);
+		if (typeof event_key !== "string") throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_VALUE_TYPE}`);
+		return new CustomEvent(this, event_key);
+	}
+	updateOrInsert(array, match, update, insert) {
+		const item = array.find(match);
+		if (item) update(item);
+		else array.push(insert());
+	}
+	calculateGuildMembers(guildMembers) {
+		return guildMembers.reduce((acc, count) => {
+			if (count <= 100) acc.little++;
+			else if (count <= 500) acc.medium++;
+			else if (count <= 1500) acc.big++;
+			else acc.huge++;
+			return acc;
+		}, {
+			little: 0,
+			medium: 0,
+			big: 0,
+			huge: 0
+		});
+	}
+	/**
+	* Track guilds
+	* /!\ Advanced users only
+	* /!\ You need to initialize the class first
+	* @param {TrackGuildType} type 'create' if the event is guildCreate and 'delete' if is guildDelete
+	*/
+	trackGuilds(type) {
+		this.debug(`[DISCORDANALYTICS] trackGuilds(${type}) triggered`);
+		if (type === "create") this.stats_data.addedGuilds++;
+		else this.stats_data.removedGuilds++;
+	}
+	/**
+	* API call with retries
+	* @param method The HTTP method to use (GET, POST, PUT, DELETE)
+	* @param url The URL to call
+	* @param body The body to send (optional)
+	* @param max_retries The maximum number of retries (default: 5)
+	* @param backoff_factor The backoff factor to use (default: 0.5)
+	* @returns {Promise<void | Response>} The response from the API
+	*/
+	async api_call_with_retries(method, endpoint, body, max_retries = 5, backoff_factor = .5) {
+		let retries = 0;
+		let response;
+		while (retries < max_retries) try {
+			response = await fetch(this._api_url + endpoint, {
+				method,
+				headers: this._headers,
+				body
+			});
+			if (response.ok) return response;
+			else if (response.status === 401) return this.error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_API_TOKEN}`);
+			else if (response.status === 423) return this.error(`[DISCORDANALYTICS] ${ErrorCodes.SUSPENDED_BOT}`);
+			else if (response.status === 404 && endpoint.includes("events")) return this.error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_EVENT_KEY}`, true);
+			else if (response.status !== 200) return this.error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_RESPONSE}`);
+		} catch (error) {
+			retries++;
+			const retry_after = Math.pow(2, retries) * backoff_factor;
+			this.error(`[DISCORDANALYTICS] Error: ${error}. Retrying in ${retry_after} seconds...`);
+			if (retries >= max_retries) return this.error(`[DISCORDANALYTICS] ${ErrorCodes.MAX_RETRIES_EXCEEDED}`);
+			await new Promise((resolve) => setTimeout(resolve, retry_after * 1e3));
+		}
+	}
+	async updateBotInformations(username, framework, version, avatar) {
+		const endpoint = ApiEndpoints.EDIT_SETTINGS_URL.replace("{id}", this.client_id);
+		const body = JSON.stringify({
+			avatar,
+			framework,
+			username,
+			version
+		});
+		await this.api_call_with_retries("PATCH", endpoint, body);
+	}
+	/**
+	* Send stats to the API
+	* @param client_id The client ID of the bot
+	* @param guild_count The number of guilds the bot is in (default: 0)
+	* @param user_count The number of users the bot is in (default: 0)
+	* @param user_install_count The number of user installs (default: 0)
+	* @param guild_members The number of members in each guild (optional)
+	* @returns {Promise<void>} A promise that resolves when the stats are sent
+	*/
+	async sendStats(client_id, guild_count = 0, user_count = 0, user_install_count = 0, guild_members = []) {
+		this.debug("[DISCORDANALYTICS] Sending stats...");
+		const endpoint = ApiEndpoints.EDIT_STATS_URL.replace("{id}", client_id);
+		const body = JSON.stringify(this.stats_data);
+		await this.api_call_with_retries("POST", endpoint, body);
+		this.debug("[DISCORDANALYTICS] Stats sent to the API", body);
+		this.stats_data = {
+			date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+			addedGuilds: 0,
+			customEvents: this.stats_data.customEvents,
+			guilds: [],
+			guildCount: guild_count,
+			guildLocales: [],
+			guildMembers: this.calculateGuildMembers(guild_members),
+			interactions: [],
+			interactionsLocales: [],
+			removedGuilds: 0,
+			userCount: user_count,
+			userInstallCount: user_install_count,
+			usersType: {
+				admin: 0,
+				moderator: 0,
+				newMember: 0,
+				other: 0,
+				privateMessage: 0
+			}
+		};
+	}
+};
+/**
+* CustomEvent class
+* @class CustomEvent
+* @description Class for custom events
+* @param {AnalyticsBase} analytics The AnalyticsBase instance
+* @param {string} event_key The event key to track
+* @returns {CustomEvent} An instance of the CustomEvent class
+* @example
+* const event = analytics.events('my_custom_event');
+* event.increment(1);
+* event.decrement(1);
+* event.set(10);
+* event.get();
+*/
+var CustomEvent = class {
+	constructor(analytics, event_key) {
+		this._analytics = analytics;
+		this._event_key = event_key;
+		this._last_action = "";
+		this.ensure();
+	}
+	async ensure() {
+		if (typeof this._analytics.stats_data.customEvents[this._event_key] !== "number" && process.env.NODE_ENV === "production") {
+			this._analytics.debug(`[DISCORDANALYTICS] Fetching value for event ${this._event_key}`);
+			const endpoint = ApiEndpoints.EVENT_URL.replace("{id}", this._analytics.client_id).replace("{event}", this._event_key);
+			const res = await this._analytics.api_call_with_retries("GET", endpoint);
+			if (res instanceof Response && this._last_action !== "set") {
+				const data = await res.json();
+				this._analytics.stats_data.customEvents[this._event_key] = (this._analytics.stats_data.customEvents[this._event_key] || 0) + (data.currentValue || 0);
+			}
+			this._analytics.debug(`[DISCORDANALYTICS] Value fetched for event ${this._event_key}`);
+		}
+	}
+	/**
+	* Increment the event by a value
+	* @param value The value to increment the event by (default: 1)
+	*/
+	increment(value = 1) {
+		this._analytics.debug(`[DISCORDANALYTICS] Incrementing event ${this._event_key} by ${value}`);
+		if (typeof value !== "number") throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_VALUE_TYPE}`);
+		if (value < 0) throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_EVENTS_COUNT}`);
+		this._analytics.stats_data.customEvents[this._event_key] = (this._analytics.stats_data.customEvents[this._event_key] || 0) + value;
+		this._last_action = "increment";
+	}
+	/**
+	* Decrement the event by a value
+	* @param value The value to decrement the event by (default: 1)
+	*/
+	decrement(value = 1) {
+		this._analytics.debug(`[DISCORDANALYTICS] Decrementing event ${this._event_key} by ${value}`);
+		if (typeof value !== "number") throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_VALUE_TYPE}`);
+		if (value < 0 || this.get() - value < 0) throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_EVENTS_COUNT}`);
+		this._analytics.stats_data.customEvents[this._event_key] -= value;
+		this._last_action = "decrement";
+	}
+	/**
+	* Set the event to a value
+	* @param value The value to set the event to
+	*/
+	set(value) {
+		this._analytics.debug(`[DISCORDANALYTICS] Setting event ${this._event_key} to ${value}`);
+		if (typeof value !== "number") throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_VALUE_TYPE}`);
+		if (value < 0) throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_EVENTS_COUNT}`);
+		this._analytics.stats_data.customEvents[this._event_key] = value;
+		this._last_action = "set";
+	}
+	/**
+	* Get the event value
+	* @returns {number} The event value
+	*/
+	get() {
+		this._analytics.debug(`[DISCORDANALYTICS] Getting event ${this._event_key}`);
+		return this._analytics.stats_data.customEvents[this._event_key];
+	}
+};
+//#endregion
+export { AnalyticsBase, ApiEndpoints, ApplicationCommandType, CustomEvent, ErrorCodes, InteractionType };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/types.ts","../src/index.ts"],"sourcesContent":["export const ApiEndpoints = {\n  BASE_URL: 'https://discordanalytics.xyz/api',\n  EDIT_SETTINGS_URL: `/bots/{id}`,\n  EDIT_STATS_URL: `/bots/{id}/stats`,\n  EVENT_URL: `/bots/{id}/events/{event}`,\n};\n\nexport const ErrorCodes = {\n  INVALID_CLIENT_TYPE: 'Invalid client type, please use a valid client.',\n  CLIENT_NOT_READY: 'Client is not ready, please start the client first.',\n  INVALID_RESPONSE: 'Invalid response from the API, please try again later.',\n  INVALID_API_TOKEN:\n    'Invalid API token, please get one at ' +\n    ApiEndpoints.BASE_URL.split('/api')[0] +\n    ' and try again.',\n  DATA_NOT_SENT: 'Data cannot be sent to the API, I will try again in a minute.',\n  SUSPENDED_BOT: 'Your bot has been suspended, please check your mailbox for more information.',\n  INSTANCE_NOT_INITIALIZED:\n    \"It seem that you didn't initialize your instance. Please check the docs for more informations.\",\n  INVALID_EVENTS_COUNT: 'invalid events count',\n  INVALID_VALUE_TYPE: 'invalid value type',\n  INVALID_EVENT_KEY: 'invalid event key',\n  MAX_RETRIES_EXCEEDED:\n    'Max retries exceeded, please check your network connection or the API status.',\n};\n\nexport type Locale =\n  | 'id'\n  | 'en-US'\n  | 'en-GB'\n  | 'bg'\n  | 'zh-CN'\n  | 'zh-TW'\n  | 'hr'\n  | 'cs'\n  | 'da'\n  | 'nl'\n  | 'fi'\n  | 'fr'\n  | 'de'\n  | 'el'\n  | 'hi'\n  | 'hu'\n  | 'it'\n  | 'ja'\n  | 'ko'\n  | 'lt'\n  | 'no'\n  | 'pl'\n  | 'pt-BR'\n  | 'ro'\n  | 'ru'\n  | 'es-ES'\n  | 'sv-SE'\n  | 'th'\n  | 'tr'\n  | 'uk'\n  | 'vi';\n\nexport enum InteractionType {\n  Ping = 1,\n  ApplicationCommand = 2,\n  MessageComponent = 3,\n  ApplicationCommandAutocomplete = 4,\n  ModalSubmit = 5,\n}\n\nexport enum ApplicationCommandType {\n  ChatInputCommand = 1,\n  UserCommand = 2,\n  MessageCommand = 3,\n}\n\nexport interface InteractionData {\n  commandType?: ApplicationCommandType;\n  name: string;\n  number: number;\n  type: InteractionType;\n}\n\nexport interface LocaleData {\n  locale: Locale;\n  number: number;\n}\n\nexport interface GuildData {\n  guildId: string;\n  icon: string | null;\n  interactions: number;\n  members: number;\n  name: string;\n}\n\nexport interface GuildMembersData {\n  little: number;\n  medium: number;\n  big: number;\n  huge: number;\n}\n\nexport interface UsersTypeData {\n  admin: number;\n  moderator: number;\n  newMember: number;\n  other: number;\n  privateMessage: number;\n}\n\nexport interface StatsData {\n  date: string;\n  addedGuilds: number;\n  customEvents: Record<string, number>;\n  guilds: GuildData[];\n  guildCount: number;\n  guildLocales: LocaleData[];\n  guildMembers: GuildMembersData;\n  interactions: InteractionData[];\n  interactionsLocales: LocaleData[];\n  removedGuilds: number;\n  userCount: number;\n  userInstallCount: number;\n  usersType: UsersTypeData;\n}\n\nexport interface AnalyticsOptions<TClient = unknown> {\n  client: TClient;\n  api_key: string;\n  api_url?: string;\n  sharded?: boolean;\n  debug?: boolean;\n}\n\nexport type TrackGuildType = 'create' | 'delete';\n","import { ApiEndpoints, ErrorCodes, StatsData, TrackGuildType } from './types';\n\n/**\n * DiscordAnalytics Base Class\n * @class AnalyticsBase\n * @description Base class for DiscordAnalytics\n * @param {string} api_key The API key for DiscordAnalytics\n * @param {boolean} debug Optional flag to enable debug mode /!\\ MUST BE USED ONLY FOR DEBUGGING PURPOSES\n * @returns {AnalyticsBase} An instance of the AnalyticsBase class\n * @example\n * const analytics = new AnalyticsBase('YOUR_API_KEY');\n * analytics.sendStats('YOUR_CLIENT_ID', 0, 0);\n */\nexport class AnalyticsBase {\n  private readonly _api_key: string;\n  private readonly _headers: { 'Content-Type': string; Authorization: string };\n  private readonly debug_mode: boolean = false;\n  public readonly _api_url: string;\n  public stats_data: StatsData = {\n    date: new Date().toISOString().slice(0, 10),\n    addedGuilds: 0,\n    customEvents: {},\n    guilds: [],\n    guildCount: 0,\n    guildLocales: [],\n    guildMembers: {\n      little: 0,\n      medium: 0,\n      big: 0,\n      huge: 0,\n    },\n    interactions: [],\n    interactionsLocales: [],\n    removedGuilds: 0,\n    userCount: 0,\n    userInstallCount: 0,\n    usersType: {\n      admin: 0,\n      moderator: 0,\n      newMember: 0,\n      other: 0,\n      privateMessage: 0,\n    },\n  };\n  public client_id: string = '';\n\n  constructor(api_key: string, api_url: string = ApiEndpoints.BASE_URL, debug: boolean = false) {\n    this._api_key = api_key;\n    this._api_url = api_url;\n    this.debug_mode = debug;\n    this._headers = {\n      'Content-Type': 'application/json',\n      Authorization: `Bot ${this._api_key}`,\n    };\n  }\n\n  public debug(...args: unknown[]): void {\n    if (this.debug_mode) console.debug(...args);\n  }\n\n  public error(content: unknown, exit: boolean = false): void {\n    console.error(content);\n    if (exit) process.exit(1);\n  }\n\n  /**\n   * Custom events\n   * /!\\ Advanced users only\n   * /!\\ You need to initialize the class first\n   * @param event_key The event key to track\n   * @returns {CustomEvent} The CustomEvent instance\n   * @example\n   * const event = analytics.events('my_custom_event');\n   * event.increment(1);\n   * event.decrement(1);\n   * event.set(10);\n   */\n  public events(event_key: string): CustomEvent {\n    this.debug(`[DISCORDANALYTICS] Getting event ${event_key}`);\n\n    if (typeof event_key !== 'string')\n      throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_VALUE_TYPE}`);\n\n    return new CustomEvent(this, event_key);\n  }\n\n  public updateOrInsert<T>(\n    array: T[],\n    match: (item: T) => boolean,\n    update: (item: T) => void,\n    insert: () => T,\n  ): void {\n    const item = array.find(match);\n    if (item) update(item);\n    else array.push(insert());\n  }\n\n  public calculateGuildMembers(guildMembers: number[]): {\n    little: number;\n    medium: number;\n    big: number;\n    huge: number;\n  } {\n    return guildMembers.reduce(\n      (acc, count) => {\n        if (count <= 100) acc.little++;\n        else if (count <= 500) acc.medium++;\n        else if (count <= 1500) acc.big++;\n        else acc.huge++;\n        return acc;\n      },\n      { little: 0, medium: 0, big: 0, huge: 0 },\n    );\n  }\n\n  /**\n   * Track guilds\n   * /!\\ Advanced users only\n   * /!\\ You need to initialize the class first\n   * @param {TrackGuildType} type 'create' if the event is guildCreate and 'delete' if is guildDelete\n   */\n  public trackGuilds(type: TrackGuildType): void {\n    this.debug(`[DISCORDANALYTICS] trackGuilds(${type}) triggered`);\n    if (type === 'create') this.stats_data.addedGuilds++;\n    else this.stats_data.removedGuilds++;\n  }\n\n  /**\n   * API call with retries\n   * @param method The HTTP method to use (GET, POST, PUT, DELETE)\n   * @param url The URL to call\n   * @param body The body to send (optional)\n   * @param max_retries The maximum number of retries (default: 5)\n   * @param backoff_factor The backoff factor to use (default: 0.5)\n   * @returns {Promise<void | Response>} The response from the API\n   */\n  public async api_call_with_retries(\n    method: string,\n    endpoint: string,\n    body?: string,\n    max_retries: number = 5,\n    backoff_factor: number = 0.5,\n  ): Promise<void | Response> {\n    let retries = 0;\n    let response: Response;\n\n    while (retries < max_retries) {\n      try {\n        response = await fetch(this._api_url + endpoint, {\n          method,\n          headers: this._headers,\n          body,\n        });\n\n        if (response.ok) return response;\n        else if (response.status === 401)\n          return this.error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_API_TOKEN}`);\n        else if (response.status === 423)\n          return this.error(`[DISCORDANALYTICS] ${ErrorCodes.SUSPENDED_BOT}`);\n        else if (response.status === 404 && endpoint.includes('events'))\n          return this.error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_EVENT_KEY}`, true);\n        else if (response.status !== 200)\n          return this.error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_RESPONSE}`);\n      } catch (error) {\n        retries++;\n        const retry_after = Math.pow(2, retries) * backoff_factor;\n        this.error(`[DISCORDANALYTICS] Error: ${error}. Retrying in ${retry_after} seconds...`);\n        if (retries >= max_retries)\n          return this.error(`[DISCORDANALYTICS] ${ErrorCodes.MAX_RETRIES_EXCEEDED}`);\n        await new Promise((resolve) => setTimeout(resolve, retry_after * 1000));\n      }\n    }\n  }\n\n  public async updateBotInformations(\n    username: string,\n    framework: string,\n    version: string,\n    avatar: string | null,\n  ): Promise<void> {\n    const endpoint = ApiEndpoints.EDIT_SETTINGS_URL.replace('{id}', this.client_id);\n    const body = JSON.stringify({\n      avatar,\n      framework,\n      username,\n      version,\n    });\n    await this.api_call_with_retries('PATCH', endpoint, body);\n  }\n\n  /**\n   * Send stats to the API\n   * @param client_id The client ID of the bot\n   * @param guild_count The number of guilds the bot is in (default: 0)\n   * @param user_count The number of users the bot is in (default: 0)\n   * @param user_install_count The number of user installs (default: 0)\n   * @param guild_members The number of members in each guild (optional)\n   * @returns {Promise<void>} A promise that resolves when the stats are sent\n   */\n  public async sendStats(\n    client_id: string,\n    guild_count: number = 0,\n    user_count: number = 0,\n    user_install_count: number = 0,\n    guild_members: number[] = [],\n  ): Promise<void> {\n    this.debug('[DISCORDANALYTICS] Sending stats...');\n\n    const endpoint = ApiEndpoints.EDIT_STATS_URL.replace('{id}', client_id);\n    const body = JSON.stringify(this.stats_data);\n\n    await this.api_call_with_retries('POST', endpoint, body);\n\n    this.debug('[DISCORDANALYTICS] Stats sent to the API', body);\n\n    this.stats_data = {\n      date: new Date().toISOString().slice(0, 10),\n      addedGuilds: 0,\n      customEvents: this.stats_data.customEvents,\n      guilds: [],\n      guildCount: guild_count,\n      guildLocales: [],\n      guildMembers: this.calculateGuildMembers(guild_members),\n      interactions: [],\n      interactionsLocales: [],\n      removedGuilds: 0,\n      userCount: user_count,\n      userInstallCount: user_install_count,\n      usersType: {\n        admin: 0,\n        moderator: 0,\n        newMember: 0,\n        other: 0,\n        privateMessage: 0,\n      },\n    };\n  }\n}\n\n/**\n * CustomEvent class\n * @class CustomEvent\n * @description Class for custom events\n * @param {AnalyticsBase} analytics The AnalyticsBase instance\n * @param {string} event_key The event key to track\n * @returns {CustomEvent} An instance of the CustomEvent class\n * @example\n * const event = analytics.events('my_custom_event');\n * event.increment(1);\n * event.decrement(1);\n * event.set(10);\n * event.get();\n */\nexport class CustomEvent {\n  private readonly _analytics: AnalyticsBase;\n  private readonly _event_key: string;\n  private _last_action: string;\n\n  constructor(analytics: AnalyticsBase, event_key: string) {\n    this._analytics = analytics;\n    this._event_key = event_key;\n    this._last_action = '';\n\n    this.ensure();\n  }\n\n  private async ensure() {\n    if (\n      typeof this._analytics.stats_data.customEvents[this._event_key] !== 'number' &&\n      process.env.NODE_ENV === 'production'\n    ) {\n      this._analytics.debug(`[DISCORDANALYTICS] Fetching value for event ${this._event_key}`);\n      const endpoint = ApiEndpoints.EVENT_URL.replace('{id}', this._analytics.client_id).replace(\n        '{event}',\n        this._event_key,\n      );\n      const res = await this._analytics.api_call_with_retries('GET', endpoint);\n\n      if (res instanceof Response && this._last_action !== 'set') {\n        const data: { currentValue?: number } = await res.json();\n        this._analytics.stats_data.customEvents[this._event_key] =\n          (this._analytics.stats_data.customEvents[this._event_key] || 0) +\n          (data.currentValue || 0);\n      }\n      this._analytics.debug(`[DISCORDANALYTICS] Value fetched for event ${this._event_key}`);\n    }\n  }\n\n  /**\n   * Increment the event by a value\n   * @param value The value to increment the event by (default: 1)\n   */\n  public increment(value: number = 1): void {\n    this._analytics.debug(`[DISCORDANALYTICS] Incrementing event ${this._event_key} by ${value}`);\n\n    if (typeof value !== 'number')\n      throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_VALUE_TYPE}`);\n\n    if (value < 0) throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_EVENTS_COUNT}`);\n\n    this._analytics.stats_data.customEvents[this._event_key] =\n      (this._analytics.stats_data.customEvents[this._event_key] || 0) + value;\n    this._last_action = 'increment';\n  }\n\n  /**\n   * Decrement the event by a value\n   * @param value The value to decrement the event by (default: 1)\n   */\n  public decrement(value: number = 1): void {\n    this._analytics.debug(`[DISCORDANALYTICS] Decrementing event ${this._event_key} by ${value}`);\n\n    if (typeof value !== 'number')\n      throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_VALUE_TYPE}`);\n\n    if (value < 0 || this.get() - value < 0)\n      throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_EVENTS_COUNT}`);\n\n    this._analytics.stats_data.customEvents[this._event_key] -= value;\n    this._last_action = 'decrement';\n  }\n\n  /**\n   * Set the event to a value\n   * @param value The value to set the event to\n   */\n  public set(value: number): void {\n    this._analytics.debug(`[DISCORDANALYTICS] Setting event ${this._event_key} to ${value}`);\n\n    if (typeof value !== 'number')\n      throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_VALUE_TYPE}`);\n\n    if (value < 0) throw new Error(`[DISCORDANALYTICS] ${ErrorCodes.INVALID_EVENTS_COUNT}`);\n\n    this._analytics.stats_data.customEvents[this._event_key] = value;\n    this._last_action = 'set';\n  }\n\n  /**\n   * Get the event value\n   * @returns {number} The event value\n   */\n  public get(): number {\n    this._analytics.debug(`[DISCORDANALYTICS] Getting event ${this._event_key}`);\n\n    return this._analytics.stats_data.customEvents[this._event_key];\n  }\n}\n\nexport * from './types';\n"],"mappings":"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"}

package/package.json

@@ -1,12 +1,26 @@
 {
   "name": "@discordanalytics/core",
-  "version": "2.8.2",
+  "version": "2.9.0",
   "description": "Core package to work with Discord Analytics",
   "files": [
     "dist"
   ],
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
   "author": "Discord Analytics",
   "homepage": "https://discordanalytics.xyz",
   "readme": "README.md",
@@ -19,9 +33,10 @@
   },
   "devDependencies": {
     "@types/node": "*",
+    "tsdown": "*",
     "typescript": "*"
   },
   "scripts": {
-    "build": "tsc"
+    "build": "tsdown"
   }
 }