@umituz/react-native-ai-groq-provider 1.0.3 → 1.0.5

package/dist/providers/ConfigBuilder.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Configuration Builder
+ * Builder pattern for Groq configuration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerationConfigBuilder = exports.ConfigBuilder = void 0;
+const entities_1 = require("../domain/entities");
+/**
+ * Builder for Groq configuration
+ */
+class ConfigBuilder {
+    constructor() {
+        this.config = {};
+    }
+    /**
+     * Set API key
+     */
+    withApiKey(apiKey) {
+        this.config.apiKey = apiKey;
+        return this;
+    }
+    /**
+     * Set base URL
+     */
+    withBaseUrl(baseUrl) {
+        this.config.baseUrl = baseUrl;
+        return this;
+    }
+    /**
+     * Set timeout
+     */
+    withTimeout(timeoutMs) {
+        this.config.timeoutMs = timeoutMs;
+        return this;
+    }
+    /**
+     * Set default text model
+     */
+    withTextModel(model) {
+        this.config.textModel = model;
+        return this;
+    }
+    /**
+     * Build configuration
+     */
+    build() {
+        if (!this.config.apiKey) {
+            throw new Error("API key is required. Use withApiKey() to set it.");
+        }
+        return {
+            apiKey: this.config.apiKey,
+            baseUrl: this.config.baseUrl,
+            timeoutMs: this.config.timeoutMs,
+            textModel: this.config.textModel || entities_1.DEFAULT_MODELS.TEXT,
+        };
+    }
+    /**
+     * Create a new builder instance
+     */
+    static create() {
+        return new ConfigBuilder();
+    }
+}
+exports.ConfigBuilder = ConfigBuilder;
+/**
+ * Builder for generation configuration
+ */
+class GenerationConfigBuilder {
+    constructor() {
+        this.config = {};
+    }
+    /**
+     * Set temperature
+     */
+    withTemperature(temperature) {
+        this.config.temperature = temperature;
+        return this;
+    }
+    /**
+     * Set max tokens
+     */
+    withMaxTokens(maxTokens) {
+        this.config.maxTokens = maxTokens;
+        return this;
+    }
+    /**
+     * Set top P
+     */
+    withTopP(topP) {
+        this.config.topP = topP;
+        return this;
+    }
+    /**
+     * Set frequency penalty
+     */
+    withFrequencyPenalty(penalty) {
+        this.config.frequencyPenalty = penalty;
+        return this;
+    }
+    /**
+     * Set presence penalty
+     */
+    withPresencePenalty(penalty) {
+        this.config.presencePenalty = penalty;
+        return this;
+    }
+    /**
+     * Set stop sequences
+     */
+    withStop(stop) {
+        this.config.stop = stop;
+        return this;
+    }
+    /**
+     * Build configuration
+     */
+    build() {
+        return { ...this.config };
+    }
+    /**
+     * Create a new builder instance
+     */
+    static create() {
+        return new GenerationConfigBuilder();
+    }
+    /**
+     * Create a balanced configuration
+     */
+    static balanced() {
+        return new GenerationConfigBuilder().withTemperature(0.7);
+    }
+    /**
+     * Create a creative configuration
+     */
+    static creative() {
+        return new GenerationConfigBuilder().withTemperature(1.0);
+    }
+    /**
+     * Create a precise configuration
+     */
+    static precise() {
+        return new GenerationConfigBuilder().withTemperature(0.3);
+    }
+}
+exports.GenerationConfigBuilder = GenerationConfigBuilder;
+//# sourceMappingURL=ConfigBuilder.js.map

package/dist/providers/ConfigBuilder.js.map

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

package/dist/providers/ProviderFactory.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Provider Factory
+ * Factory for creating configured Groq provider instances
+ */
+import { ConfigBuilder, GenerationConfigBuilder } from "./ConfigBuilder";
+/**
+ * Provider configuration options
+ */
+export interface ProviderConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    defaultModel?: string;
+}
+/**
+ * Provider factory options
+ */
+export interface ProviderFactoryOptions {
+    enableTelemetry?: boolean;
+    onError?: (error: Error) => void;
+}
+/**
+ * Initialize Groq provider with configuration
+ */
+export declare function initializeProvider(config: ProviderConfig): void;
+/**
+ * Provider factory - creates configured provider instances
+ */
+export declare const providerFactory: {
+    /**
+     * Create a new provider instance
+     */
+    create(config: ProviderConfig): void;
+    /**
+     * Create provider from environment variables
+     */
+    fromEnv(): void;
+    /**
+     * Reset provider (clear configuration)
+     */
+    reset(): void;
+    /**
+     * Check if provider is initialized
+     */
+    isInitialized(): boolean;
+};
+/**
+ * Convenience function to initialize provider
+ */
+export declare function configureProvider(config: ProviderConfig): void;
+/**
+ * Convenience function to reset provider
+ */
+export declare function resetProvider(): void;
+export { ConfigBuilder, GenerationConfigBuilder };
+//# sourceMappingURL=ProviderFactory.d.ts.map

package/dist/providers/ProviderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderFactory.d.ts","sourceRoot":"","sources":["../../src/providers/ProviderFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAO/D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;mBACY,cAAc,GAAG,IAAI;IAIpC;;OAEG;eACQ,IAAI;IAcf;;OAEG;aACM,IAAI;IAIb;;OAEG;qBACc,OAAO;CAGzB,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAGD,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/providers/ProviderFactory.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Provider Factory
+ * Factory for creating configured Groq provider instances
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerationConfigBuilder = exports.ConfigBuilder = exports.providerFactory = void 0;
+exports.initializeProvider = initializeProvider;
+exports.configureProvider = configureProvider;
+exports.resetProvider = resetProvider;
+const GroqClient_1 = require("../infrastructure/services/GroqClient");
+const ConfigBuilder_1 = require("./ConfigBuilder");
+Object.defineProperty(exports, "ConfigBuilder", { enumerable: true, get: function () { return ConfigBuilder_1.ConfigBuilder; } });
+Object.defineProperty(exports, "GenerationConfigBuilder", { enumerable: true, get: function () { return ConfigBuilder_1.GenerationConfigBuilder; } });
+/**
+ * Initialize Groq provider with configuration
+ */
+function initializeProvider(config) {
+    GroqClient_1.groqHttpClient.initialize({
+        apiKey: config.apiKey,
+        baseUrl: config.baseUrl,
+        timeoutMs: config.timeoutMs,
+        textModel: config.defaultModel,
+    });
+}
+/**
+ * Provider factory - creates configured provider instances
+ */
+exports.providerFactory = {
+    /**
+     * Create a new provider instance
+     */
+    create(config) {
+        initializeProvider(config);
+    },
+    /**
+     * Create provider from environment variables
+     */
+    fromEnv() {
+        const apiKey = process.env.GROQ_API_KEY;
+        if (!apiKey) {
+            throw new Error("GROQ_API_KEY environment variable is not set");
+        }
+        initializeProvider({
+            apiKey,
+            baseUrl: process.env.GROQ_BASE_URL,
+            timeoutMs: process.env.GROQ_TIMEOUT_MS ? parseInt(process.env.GROQ_TIMEOUT_MS) : undefined,
+        });
+    },
+    /**
+     * Reset provider (clear configuration)
+     */
+    reset() {
+        GroqClient_1.groqHttpClient.reset();
+    },
+    /**
+     * Check if provider is initialized
+     */
+    isInitialized() {
+        return GroqClient_1.groqHttpClient.isInitialized();
+    },
+};
+/**
+ * Convenience function to initialize provider
+ */
+function configureProvider(config) {
+    exports.providerFactory.create(config);
+}
+/**
+ * Convenience function to reset provider
+ */
+function resetProvider() {
+    exports.providerFactory.reset();
+}
+//# sourceMappingURL=ProviderFactory.js.map

package/dist/providers/ProviderFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderFactory.js","sourceRoot":"","sources":["../../src/providers/ProviderFactory.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA2BH,gDAOC;AAgDD,8CAEC;AAKD,sCAEC;AAxFD,sEAAuE;AACvE,mDAAyE;AA0FhE,8FA1FA,6BAAa,OA0FA;AAAE,wGA1FA,uCAAuB,OA0FA;AAtE/C;;GAEG;AACH,SAAgB,kBAAkB,CAAC,MAAsB;IACvD,2BAAc,CAAC,UAAU,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,YAAY;KAC/B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACU,QAAA,eAAe,GAAG;IAC7B;;OAEG;IACH,MAAM,CAAC,MAAsB;QAC3B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAExC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,kBAAkB,CAAC;YACjB,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;YAClC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS;SAC3F,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK;QACH,2BAAc,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,2BAAc,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAAsB;IACtD,uBAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,uBAAe,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Providers
+ */
+export { ConfigBuilder, GenerationConfigBuilder } from "./ConfigBuilder";
+export { providerFactory, initializeProvider, configureProvider, resetProvider, } from "./ProviderFactory";
+export type { ProviderConfig, ProviderFactoryOptions, } from "./ProviderFactory";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,cAAc,EACd,sBAAsB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Providers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetProvider = exports.configureProvider = exports.initializeProvider = exports.providerFactory = exports.GenerationConfigBuilder = exports.ConfigBuilder = void 0;
+var ConfigBuilder_1 = require("./ConfigBuilder");
+Object.defineProperty(exports, "ConfigBuilder", { enumerable: true, get: function () { return ConfigBuilder_1.ConfigBuilder; } });
+Object.defineProperty(exports, "GenerationConfigBuilder", { enumerable: true, get: function () { return ConfigBuilder_1.GenerationConfigBuilder; } });
+var ProviderFactory_1 = require("./ProviderFactory");
+Object.defineProperty(exports, "providerFactory", { enumerable: true, get: function () { return ProviderFactory_1.providerFactory; } });
+Object.defineProperty(exports, "initializeProvider", { enumerable: true, get: function () { return ProviderFactory_1.initializeProvider; } });
+Object.defineProperty(exports, "configureProvider", { enumerable: true, get: function () { return ProviderFactory_1.configureProvider; } });
+Object.defineProperty(exports, "resetProvider", { enumerable: true, get: function () { return ProviderFactory_1.resetProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iDAAyE;AAAhE,8GAAA,aAAa,OAAA;AAAE,wHAAA,uBAAuB,OAAA;AAC/C,qDAK2B;AAJzB,kHAAA,eAAe,OAAA;AACf,qHAAA,kBAAkB,OAAA;AAClB,oHAAA,iBAAiB,OAAA;AACjB,gHAAA,aAAa,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-groq-provider",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Groq text generation provider for React Native applications",
   "main": "./src/index.ts",
   "types": "./dist/index.d.ts",

package/src/infrastructure/services/GroqClient.ts

@@ -25,6 +25,17 @@ class GroqHttpClient {
   initialize(config: GroqConfig): void {
     const apiKey = config.apiKey?.trim();
 
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[GroqClient] Initializing:", {
+        hasApiKey: !!apiKey,
+        keyLength: apiKey?.length,
+        keyPrefix: apiKey ? apiKey.substring(0, 10) + "..." : "",
+        baseUrl: config.baseUrl || DEFAULT_BASE_URL,
+        timeoutMs: config.timeoutMs || DEFAULT_TIMEOUT,
+        textModel: config.textModel,
+      });
+    }
+
     if (!apiKey || apiKey.length < 10) {
       throw new GroqError(
         GroqErrorType.INVALID_API_KEY,
@@ -39,6 +50,13 @@ class GroqHttpClient {
       textModel: config.textModel,
     };
     this.initialized = true;
+
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[GroqClient] Initialization complete:", {
+        initialized: this.initialized,
+        baseUrl: this.config.baseUrl,
+      });
+    }
   }
 
   /**
@@ -79,6 +97,17 @@ class GroqHttpClient {
     const url = `${this.config.baseUrl}${endpoint}`;
     const timeout = this.config.timeoutMs || DEFAULT_TIMEOUT;
 
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[GroqClient] API Request:", {
+        url,
+        endpoint,
+        method: "POST",
+        timeout: `${timeout}ms`,
+        hasBody: !!body,
+        bodyKeys: body ? Object.keys(body) : [],
+      });
+    }
+
     try {
       // Create AbortController for timeout
       const controller = new AbortController();
@@ -89,6 +118,7 @@ class GroqHttpClient {
         signal.addEventListener("abort", () => controller.abort());
       }
 
+      const fetchStartTime = Date.now();
       const response = await fetch(url, {
         method: "POST",
         headers: {
@@ -99,14 +129,44 @@ class GroqHttpClient {
         signal: controller.signal,
       });
 
+      const fetchDuration = Date.now() - fetchStartTime;
       clearTimeout(timeoutId);
 
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[GroqClient] API Response:", {
+          status: response.status,
+          ok: response.ok,
+          fetchDuration: `${fetchDuration}ms`,
+          contentType: response.headers.get("content-type"),
+        });
+      }
+
       if (!response.ok) {
         await this.handleErrorResponse(response);
       }
 
-      return (await response.json()) as T;
+      const jsonStart = Date.now();
+      const jsonData = (await response.json()) as T;
+      const parseDuration = Date.now() - jsonStart;
+
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[GroqClient] JSON parsed:", {
+          parseDuration: `${parseDuration}ms`,
+          hasData: !!jsonData,
+          dataKeys: jsonData ? Object.keys(jsonData) : [],
+        });
+      }
+
+      return jsonData;
     } catch (error) {
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.error("[GroqClient] Request error:", {
+          error,
+          errorMessage: error instanceof Error ? error.message : String(error),
+          errorName: error instanceof Error ? error.name : undefined,
+        });
+      }
+
       throw this.handleRequestError(error);
     }
   }

package/src/infrastructure/services/StructuredText.ts

@@ -26,8 +26,20 @@ export async function structuredText<T = Record<string, unknown>>(
   prompt: string,
   options: StructuredTextOptions<T> = {}
 ): Promise<T> {
+  const startTime = Date.now();
   const model = options.model || DEFAULT_MODELS.TEXT;
 
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Groq] structuredText called:", {
+      model,
+      promptLength: prompt.length,
+      promptPreview: prompt.substring(0, 150) + "...",
+      hasSchema: !!options.schema,
+      hasExample: !!options.example,
+      generationConfig: options.generationConfig,
+    });
+  }
+
   let systemPrompt = "You are a helpful assistant that generates valid JSON output.";
 
   if (options.schema) {
@@ -59,7 +71,30 @@ export async function structuredText<T = Record<string, unknown>>(
     top_p: options.generationConfig?.topP || 0.9,
   };
 
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Groq] Sending structured request:", {
+      endpoint: "/v1/chat/completions",
+      requestBody: {
+        model: request.model,
+        temperature: request.temperature,
+        max_tokens: request.max_tokens,
+        top_p: request.top_p,
+      },
+    });
+  }
+
+  const apiStartTime = Date.now();
   const response = await groqHttpClient.chatCompletion(request);
+  const apiDuration = Date.now() - apiStartTime;
+
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Groq] Structured API response:", {
+      apiDuration: `${apiDuration}ms`,
+      usage: response.usage,
+      finishReason: response.choices?.[0]?.finish_reason,
+      hasContent: !!response.choices?.[0]?.message?.content,
+    });
+  }
 
   let content = response.choices[0]?.message?.content;
   if (!content) {
@@ -69,6 +104,13 @@ export async function structuredText<T = Record<string, unknown>>(
     );
   }
 
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Groq] Raw response content:", {
+      length: content.length,
+      preview: content.substring(0, 300) + "...",
+    });
+  }
+
   // Clean up the response: remove markdown code blocks if present
   content = content.trim();
   if (content.startsWith("```json")) {
@@ -81,9 +123,33 @@ export async function structuredText<T = Record<string, unknown>>(
   }
   content = content.trim();
 
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Groq] Attempting JSON parse...");
+  }
+
   try {
-    return JSON.parse(content) as T;
+    const parsed = JSON.parse(content) as T;
+    const totalDuration = Date.now() - startTime;
+
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[Groq] structuredText complete:", {
+        totalDuration: `${totalDuration}ms`,
+        apiDuration: `${apiDuration}ms`,
+        parseDuration: `${totalDuration - apiDuration}ms`,
+        parsedKeys: Object.keys(parsed),
+      });
+    }
+
+    return parsed;
   } catch (error) {
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.error("[Groq] JSON parse failed:", {
+        error,
+        contentLength: content.length,
+        contentPreview: content.substring(0, 500) + "...",
+      });
+    }
+
     throw new GroqError(
       GroqErrorType.UNKNOWN_ERROR,
       `Failed to parse JSON response: ${content}`,
@@ -99,8 +165,18 @@ export async function structuredChat<T = Record<string, unknown>>(
   messages: GroqMessage[],
   options: StructuredTextOptions<T> = {}
 ): Promise<T> {
+  const startTime = Date.now();
   const model = options.model || DEFAULT_MODELS.TEXT;
 
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Groq] structuredChat called:", {
+      model,
+      messageCount: messages.length,
+      hasSchema: !!options.schema,
+      hasExample: !!options.example,
+    });
+  }
+
   let systemMessage: GroqMessage | null = null;
 
   // Check if there's already a system message
@@ -137,7 +213,16 @@ export async function structuredChat<T = Record<string, unknown>>(
     top_p: options.generationConfig?.topP || 0.9,
   };
 
+  const apiStartTime = Date.now();
   const response = await groqHttpClient.chatCompletion(request);
+  const apiDuration = Date.now() - apiStartTime;
+
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Groq] structuredChat API response:", {
+      apiDuration: `${apiDuration}ms`,
+      usage: response.usage,
+    });
+  }
 
   let content = response.choices[0]?.message?.content;
   if (!content) {
@@ -159,6 +244,14 @@ export async function structuredChat<T = Record<string, unknown>>(
   }
   content = content.trim();
 
+  const totalDuration = Date.now() - startTime;
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Groq] structuredChat complete:", {
+      totalDuration: `${totalDuration}ms`,
+      responseLength: content.length,
+    });
+  }
+
   try {
     return JSON.parse(content) as T;
   } catch (error) {