argus-discord-analytics 0.1.1 → 0.2.0

package/dist/index.d.mts

@@ -21,6 +21,7 @@
  * argus.trackRevenue({ source: 'patreon', amount: 500, tier: 'Premium' });
  * ```
  */
+declare const SDK_VERSION = "0.2.0";
 interface ArgusConfig {
     /** Your Argus API key (starts with arg_live_ or arg_test_) */
     apiKey: string;
@@ -93,7 +94,7 @@ declare class Argus {
     private startFlushTimer;
     /**
      * Track a Discord.js interaction automatically
-     * Extracts command name, server ID, and user ID from the interaction
+     * Extracts command name (including subcommands), server ID, and user ID from the interaction
      */
     track(interaction: {
         commandName?: string;
@@ -103,6 +104,7 @@ declare class Argus {
             id: string;
         };
         type?: number;
+        options?: unknown;
     }): void;
     /**
      * Track a custom event
@@ -114,16 +116,22 @@ declare class Argus {
     }): void;
     /**
      * Track a command (convenience method)
+     * Accepts either a command name string or a Discord.js interaction object
      *
      * @example
      * ```typescript
+     * // Option 1: Pass the interaction directly (recommended)
+     * // Automatically extracts subcommands: /show profile -> "show profile"
+     * argus.trackCommand(interaction);
+     *
+     * // Option 2: Pass command name as string
      * argus.trackCommand('ban', {
      *   serverId: interaction.guildId,
      *   userId: interaction.user.id
      * });
      * ```
      */
-    trackCommand(commandName: string, options?: {
+    trackCommand(commandOrInteraction: string | Record<string, unknown>, options?: {
         serverId?: string;
         userId?: string;
         metadata?: Record<string, unknown>;
@@ -240,6 +248,7 @@ declare class Argus {
     startTimer(id: string): string;
     /**
      * End timing and track the command with latency
+     * Automatically extracts subcommands from the interaction
      */
     endTimer(timerId: string, interaction: {
         commandName?: string;
@@ -249,6 +258,7 @@ declare class Argus {
             id: string;
         };
         type?: number;
+        options?: unknown;
     }): void;
     /**
      * Track an event with latency measurement
@@ -264,4 +274,4 @@ declare class Argus {
     shutdown(): Promise<void>;
 }
 
-export { Argus, type ArgusConfig, type HeartbeatConfig, type RevenueEvent, type ServerEvent, type TrackEvent, Argus as default };
+export { Argus, type ArgusConfig, type HeartbeatConfig, type RevenueEvent, SDK_VERSION, type ServerEvent, type TrackEvent, Argus as default };

package/dist/index.d.ts

@@ -21,6 +21,7 @@
  * argus.trackRevenue({ source: 'patreon', amount: 500, tier: 'Premium' });
  * ```
  */
+declare const SDK_VERSION = "0.2.0";
 interface ArgusConfig {
     /** Your Argus API key (starts with arg_live_ or arg_test_) */
     apiKey: string;
@@ -93,7 +94,7 @@ declare class Argus {
     private startFlushTimer;
     /**
      * Track a Discord.js interaction automatically
-     * Extracts command name, server ID, and user ID from the interaction
+     * Extracts command name (including subcommands), server ID, and user ID from the interaction
      */
     track(interaction: {
         commandName?: string;
@@ -103,6 +104,7 @@ declare class Argus {
             id: string;
         };
         type?: number;
+        options?: unknown;
     }): void;
     /**
      * Track a custom event
@@ -114,16 +116,22 @@ declare class Argus {
     }): void;
     /**
      * Track a command (convenience method)
+     * Accepts either a command name string or a Discord.js interaction object
      *
      * @example
      * ```typescript
+     * // Option 1: Pass the interaction directly (recommended)
+     * // Automatically extracts subcommands: /show profile -> "show profile"
+     * argus.trackCommand(interaction);
+     *
+     * // Option 2: Pass command name as string
      * argus.trackCommand('ban', {
      *   serverId: interaction.guildId,
      *   userId: interaction.user.id
      * });
      * ```
      */
-    trackCommand(commandName: string, options?: {
+    trackCommand(commandOrInteraction: string | Record<string, unknown>, options?: {
         serverId?: string;
         userId?: string;
         metadata?: Record<string, unknown>;
@@ -240,6 +248,7 @@ declare class Argus {
     startTimer(id: string): string;
     /**
      * End timing and track the command with latency
+     * Automatically extracts subcommands from the interaction
      */
     endTimer(timerId: string, interaction: {
         commandName?: string;
@@ -249,6 +258,7 @@ declare class Argus {
             id: string;
         };
         type?: number;
+        options?: unknown;
     }): void;
     /**
      * Track an event with latency measurement
@@ -264,4 +274,4 @@ declare class Argus {
     shutdown(): Promise<void>;
 }
 
-export { Argus, type ArgusConfig, type HeartbeatConfig, type RevenueEvent, type ServerEvent, type TrackEvent, Argus as default };
+export { Argus, type ArgusConfig, type HeartbeatConfig, type RevenueEvent, SDK_VERSION, type ServerEvent, type TrackEvent, Argus as default };

package/dist/index.js

@@ -21,9 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   Argus: () => Argus,
+  SDK_VERSION: () => SDK_VERSION,
   default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
+var SDK_VERSION = "0.2.0";
 function hashString(str) {
   let hash = 0;
   for (let i = 0; i < str.length; i++) {
@@ -33,6 +35,25 @@ function hashString(str) {
   }
   return Math.abs(hash).toString(36);
 }
+function extractFullCommandName(interaction) {
+  let command = interaction.commandName || interaction.customId || "unknown";
+  const options = interaction.options;
+  if (options && typeof options.getSubcommandGroup === "function") {
+    try {
+      const group = options.getSubcommandGroup(false);
+      if (group) command += ` ${group}`;
+    } catch {
+    }
+  }
+  if (options && typeof options.getSubcommand === "function") {
+    try {
+      const sub = options.getSubcommand(false);
+      if (sub) command += ` ${sub}`;
+    } catch {
+    }
+  }
+  return command;
+}
 var Argus = class {
   constructor(apiKeyOrConfig) {
     this.queue = [];
@@ -73,10 +94,10 @@ var Argus = class {
   }
   /**
    * Track a Discord.js interaction automatically
-   * Extracts command name, server ID, and user ID from the interaction
+   * Extracts command name (including subcommands), server ID, and user ID from the interaction
    */
   track(interaction) {
-    const name = interaction.commandName || interaction.customId || "unknown";
+    const name = extractFullCommandName(interaction);
     const serverId = interaction.guildId || void 0;
     const userId = interaction.user?.id;
     this.trackEvent("command", name, {
@@ -111,17 +132,37 @@ var Argus = class {
   }
   /**
    * Track a command (convenience method)
+   * Accepts either a command name string or a Discord.js interaction object
    * 
    * @example
    * ```typescript
+   * // Option 1: Pass the interaction directly (recommended)
+   * // Automatically extracts subcommands: /show profile -> "show profile"
+   * argus.trackCommand(interaction);
+   * 
+   * // Option 2: Pass command name as string
    * argus.trackCommand('ban', {
    *   serverId: interaction.guildId,
    *   userId: interaction.user.id
    * });
    * ```
    */
-  trackCommand(commandName, options) {
-    this.trackEvent("command", commandName, options);
+  trackCommand(commandOrInteraction, options) {
+    let commandName;
+    let extractedOptions = options;
+    if (typeof commandOrInteraction === "string") {
+      commandName = commandOrInteraction;
+    } else {
+      commandName = extractFullCommandName(commandOrInteraction);
+      if (!extractedOptions) {
+        const interaction = commandOrInteraction;
+        extractedOptions = {
+          serverId: interaction.guildId || void 0,
+          userId: interaction.user?.id
+        };
+      }
+    }
+    this.trackEvent("command", commandName, extractedOptions);
   }
   /**
    * Track an error
@@ -233,7 +274,7 @@ var Argus = class {
           "Content-Type": "application/json",
           "Authorization": `Bearer ${this.apiKey}`
         },
-        body: JSON.stringify({ events })
+        body: JSON.stringify({ events, sdkVersion: SDK_VERSION })
       });
       if (!response.ok) {
         throw new Error(`HTTP ${response.status}: ${response.statusText}`);
@@ -391,6 +432,7 @@ var Argus = class {
   }
   /**
    * End timing and track the command with latency
+   * Automatically extracts subcommands from the interaction
    */
   endTimer(timerId, interaction) {
     const startTime = this.commandStartTimes.get(timerId);
@@ -401,7 +443,7 @@ var Argus = class {
     }
     const latencyMs = Date.now() - startTime;
     this.commandStartTimes.delete(timerId);
-    const name = interaction.commandName || interaction.customId || "unknown";
+    const name = extractFullCommandName(interaction);
     const serverId = interaction.guildId || void 0;
     const userId = interaction.user?.id;
     this.trackEventWithLatency("command", name, latencyMs, {
@@ -454,5 +496,6 @@ var Argus = class {
 var index_default = Argus;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Argus
+  Argus,
+  SDK_VERSION
 });

package/dist/index.mjs

@@ -1,4 +1,5 @@
 // src/index.ts
+var SDK_VERSION = "0.2.0";
 function hashString(str) {
   let hash = 0;
   for (let i = 0; i < str.length; i++) {
@@ -8,6 +9,25 @@ function hashString(str) {
   }
   return Math.abs(hash).toString(36);
 }
+function extractFullCommandName(interaction) {
+  let command = interaction.commandName || interaction.customId || "unknown";
+  const options = interaction.options;
+  if (options && typeof options.getSubcommandGroup === "function") {
+    try {
+      const group = options.getSubcommandGroup(false);
+      if (group) command += ` ${group}`;
+    } catch {
+    }
+  }
+  if (options && typeof options.getSubcommand === "function") {
+    try {
+      const sub = options.getSubcommand(false);
+      if (sub) command += ` ${sub}`;
+    } catch {
+    }
+  }
+  return command;
+}
 var Argus = class {
   constructor(apiKeyOrConfig) {
     this.queue = [];
@@ -48,10 +68,10 @@ var Argus = class {
   }
   /**
    * Track a Discord.js interaction automatically
-   * Extracts command name, server ID, and user ID from the interaction
+   * Extracts command name (including subcommands), server ID, and user ID from the interaction
    */
   track(interaction) {
-    const name = interaction.commandName || interaction.customId || "unknown";
+    const name = extractFullCommandName(interaction);
     const serverId = interaction.guildId || void 0;
     const userId = interaction.user?.id;
     this.trackEvent("command", name, {
@@ -86,17 +106,37 @@ var Argus = class {
   }
   /**
    * Track a command (convenience method)
+   * Accepts either a command name string or a Discord.js interaction object
    * 
    * @example
    * ```typescript
+   * // Option 1: Pass the interaction directly (recommended)
+   * // Automatically extracts subcommands: /show profile -> "show profile"
+   * argus.trackCommand(interaction);
+   * 
+   * // Option 2: Pass command name as string
    * argus.trackCommand('ban', {
    *   serverId: interaction.guildId,
    *   userId: interaction.user.id
    * });
    * ```
    */
-  trackCommand(commandName, options) {
-    this.trackEvent("command", commandName, options);
+  trackCommand(commandOrInteraction, options) {
+    let commandName;
+    let extractedOptions = options;
+    if (typeof commandOrInteraction === "string") {
+      commandName = commandOrInteraction;
+    } else {
+      commandName = extractFullCommandName(commandOrInteraction);
+      if (!extractedOptions) {
+        const interaction = commandOrInteraction;
+        extractedOptions = {
+          serverId: interaction.guildId || void 0,
+          userId: interaction.user?.id
+        };
+      }
+    }
+    this.trackEvent("command", commandName, extractedOptions);
   }
   /**
    * Track an error
@@ -208,7 +248,7 @@ var Argus = class {
           "Content-Type": "application/json",
           "Authorization": `Bearer ${this.apiKey}`
         },
-        body: JSON.stringify({ events })
+        body: JSON.stringify({ events, sdkVersion: SDK_VERSION })
       });
       if (!response.ok) {
         throw new Error(`HTTP ${response.status}: ${response.statusText}`);
@@ -366,6 +406,7 @@ var Argus = class {
   }
   /**
    * End timing and track the command with latency
+   * Automatically extracts subcommands from the interaction
    */
   endTimer(timerId, interaction) {
     const startTime = this.commandStartTimes.get(timerId);
@@ -376,7 +417,7 @@ var Argus = class {
     }
     const latencyMs = Date.now() - startTime;
     this.commandStartTimes.delete(timerId);
-    const name = interaction.commandName || interaction.customId || "unknown";
+    const name = extractFullCommandName(interaction);
     const serverId = interaction.guildId || void 0;
     const userId = interaction.user?.id;
     this.trackEventWithLatency("command", name, latencyMs, {
@@ -429,5 +470,6 @@ var Argus = class {
 var index_default = Argus;
 export {
   Argus,
+  SDK_VERSION,
   index_default as default
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argus-discord-analytics",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "The all-seeing analytics SDK for Discord bots - track commands, errors, servers, and more",
   "main": "dist/index.js",
   "module": "dist/index.mjs",