feat: add get auth token details method to manage client (#262)

src/lib/types/GetTokenDetailsResponse.ts

@@ -0,0 +1,3 @@
+export interface GetTokenDetailsResponse {
+  [key: string]: unknown;
+}

src/lib/types/index.ts

@@ -26,6 +26,7 @@ export type {
 export type { GetProjectUsageRequestsSchema } from "./GetProjectUsageRequestsSchema";
 export type { GetProjectUsageSummarySchema } from "./GetProjectUsageSummarySchema";
 export type { GetProjectUsageSummaryResponse } from "./GetProjectUsageSummaryResponse";
+export type { GetTokenDetailsResponse } from "./GetTokenDetailsResponse";
 export type {
   ListOnPremCredentialsResponse,
   OnPremCredentialResponse,

src/packages/ManageClient.ts

@@ -27,9 +27,32 @@ import type {
   UpdateProjectMemberScopeSchema,
   UpdateProjectSchema,
   VoidResponse,
+  GetTokenDetailsResponse,
 } from "../lib/types";
 
 export class ManageClient extends AbstractRestfulClient {
+  /**
+   * @see https://developers.deepgram.com/docs/authenticating#test-request
+   */
+  async getTokenDetails(
+    endpoint = "v1/auth/token"
+  ): Promise<DeepgramResponse<GetTokenDetailsResponse>> {
+    try {
+      const url = new URL(this.baseUrl);
+      url.pathname = endpoint;
+
+      const result: GetTokenDetailsResponse = await this.get(this.fetch as Fetch, url);
+
+      return { result, error: null };
+    } catch (error) {
+      if (isDeepgramError(error)) {
+        return { result: null, error };
+      }
+
+      throw error;
+    }
+  }
+
   /**
    * @see https://developers.deepgram.com/reference/get-projects
    */