@umituz/react-native-ai-groq-provider 1.0.27 → 1.0.29

package/dist/shared/request-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../../src/shared/request-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACZ,MAAM,+BAA+B,CAAC;AAGvC,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,cAAc;IACzB,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,qBAA0B,GAClC,eAAe;IAwClB,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,eAAe;IAKlB,MAAM,CAAC,wBAAwB,CAC7B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,qBAA0B,GAClC,eAAe;CAOnB"}

package/dist/shared/request-builder.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Request Builder Utility
+ * Centralized request building logic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestBuilder = void 0;
+const groq_types_1 = require("../domain/entities/groq.types");
+class RequestBuilder {
+    static buildChatRequest(messages, options = {}) {
+        const { model = groq_types_1.DEFAULT_MODELS.TEXT, generationConfig = {}, defaultTemperature = 0.7, defaultMaxTokens = 1024, } = options;
+        const request = {
+            model,
+            messages,
+            temperature: generationConfig.temperature !== undefined
+                ? generationConfig.temperature
+                : defaultTemperature,
+            max_tokens: generationConfig.maxTokens !== undefined
+                ? generationConfig.maxTokens
+                : defaultMaxTokens,
+        };
+        // Only include defined optional properties
+        // Map camelCase to snake_case for API
+        if (generationConfig.topP !== undefined) {
+            request.top_p = generationConfig.topP;
+        }
+        if (generationConfig.n !== undefined) {
+            request.n = generationConfig.n;
+        }
+        if (generationConfig.stop !== undefined) {
+            request.stop = generationConfig.stop;
+        }
+        if (generationConfig.frequencyPenalty !== undefined) {
+            request.frequency_penalty = generationConfig.frequencyPenalty;
+        }
+        if (generationConfig.presencePenalty !== undefined) {
+            request.presence_penalty = generationConfig.presencePenalty;
+        }
+        return request;
+    }
+    static buildPromptRequest(prompt, options = {}) {
+        const messages = [{ role: "user", content: prompt }];
+        return this.buildChatRequest(messages, options);
+    }
+    static buildSystemPromptRequest(systemPrompt, userPrompt, options = {}) {
+        const messages = [
+            { role: "system", content: systemPrompt },
+            { role: "user", content: userPrompt },
+        ];
+        return this.buildChatRequest(messages, options);
+    }
+}
+exports.RequestBuilder = RequestBuilder;
+//# sourceMappingURL=request-builder.js.map

package/dist/shared/request-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.js","sourceRoot":"","sources":["../../src/shared/request-builder.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAOH,8DAA+D;AAS/D,MAAa,cAAc;IACzB,MAAM,CAAC,gBAAgB,CACrB,QAAuB,EACvB,UAAiC,EAAE;QAEnC,MAAM,EACJ,KAAK,GAAG,2BAAc,CAAC,IAAI,EAC3B,gBAAgB,GAAG,EAAE,EACrB,kBAAkB,GAAG,GAAG,EACxB,gBAAgB,GAAG,IAAI,GACxB,GAAG,OAAO,CAAC;QAEZ,MAAM,OAAO,GAAoB;YAC/B,KAAK;YACL,QAAQ;YACR,WAAW,EAAE,gBAAgB,CAAC,WAAW,KAAK,SAAS;gBACrD,CAAC,CAAC,gBAAgB,CAAC,WAAW;gBAC9B,CAAC,CAAC,kBAAkB;YACtB,UAAU,EAAE,gBAAgB,CAAC,SAAS,KAAK,SAAS;gBAClD,CAAC,CAAC,gBAAgB,CAAC,SAAS;gBAC5B,CAAC,CAAC,gBAAgB;SACrB,CAAC;QAEF,2CAA2C;QAC3C,sCAAsC;QACtC,IAAI,gBAAgB,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC;QACxC,CAAC;QACD,IAAI,gBAAgB,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,gBAAgB,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC;QACvC,CAAC;QACD,IAAI,gBAAgB,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACpD,OAAO,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC;QAChE,CAAC;QACD,IAAI,gBAAgB,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACnD,OAAO,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,eAAe,CAAC;QAC9D,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,kBAAkB,CACvB,MAAc,EACd,UAAiC,EAAE;QAEnC,MAAM,QAAQ,GAAkB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,wBAAwB,CAC7B,YAAoB,EACpB,UAAkB,EAClB,UAAiC,EAAE;QAEnC,MAAM,QAAQ,GAAkB;YAC9B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;YACzC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;SACtC,CAAC;QACF,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;CACF;AA/DD,wCA+DC"}

package/dist/shared/response-handler.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Response Handler Utility
+ * Handles API response parsing and extraction
+ */
+import type { GroqChatResponse, GroqFinishReason } from "../domain/entities/groq.types";
+interface Logger {
+    debug: (tag: string, message: string, context?: Record<string, unknown>) => void;
+    isEnabled?: () => boolean;
+}
+export interface ResponseHandlerResult {
+    content: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    finishReason: GroqFinishReason;
+}
+export declare class ResponseHandler {
+    /**
+     * Extract content from chat completion response
+     */
+    static extractContent(response: GroqChatResponse): string;
+    /**
+     * Handle complete response and extract all relevant data
+     */
+    static handleResponse(response: GroqChatResponse): ResponseHandlerResult;
+    /**
+     * Extract usage information
+     */
+    private static extractUsage;
+    /**
+     * Log response details (only if logger is enabled)
+     */
+    static logResponse(logger: Logger, response: GroqChatResponse, apiMs: number): void;
+}
+export {};
+//# sourceMappingURL=response-handler.d.ts.map

package/dist/shared/response-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-handler.d.ts","sourceRoot":"","sources":["../../src/shared/response-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAa,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEnG,UAAU,MAAM;IACd,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IAQzD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,qBAAqB;IAmBxE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAY3B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAkBpF"}

package/dist/shared/response-handler.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Response Handler Utility
+ * Handles API response parsing and extraction
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseHandler = void 0;
+class ResponseHandler {
+    /**
+     * Extract content from chat completion response
+     */
+    static extractContent(response) {
+        const choices = response.choices;
+        if (!choices || choices.length === 0) {
+            return "";
+        }
+        return choices[0].message?.content || "";
+    }
+    /**
+     * Handle complete response and extract all relevant data
+     */
+    static handleResponse(response) {
+        const choices = response.choices;
+        if (!choices || choices.length === 0) {
+            return {
+                content: "",
+                usage: this.extractUsage(response.usage),
+                finishReason: "stop",
+            };
+        }
+        const choice = choices[0];
+        return {
+            content: choice.message?.content || "",
+            usage: this.extractUsage(response.usage),
+            finishReason: choice.finish_reason || "stop",
+        };
+    }
+    /**
+     * Extract usage information
+     */
+    static extractUsage(usage) {
+        return {
+            promptTokens: usage.prompt_tokens || 0,
+            completionTokens: usage.completion_tokens || 0,
+            totalTokens: usage.total_tokens || 0,
+        };
+    }
+    /**
+     * Log response details (only if logger is enabled)
+     */
+    static logResponse(logger, response, apiMs) {
+        // Early return if logging is disabled
+        if (logger.isEnabled && !logger.isEnabled()) {
+            return;
+        }
+        const choices = response.choices;
+        const firstChoice = choices?.[0];
+        logger.debug("ResponseHandler", "API response received", {
+            model: response.model,
+            promptTokens: response.usage.prompt_tokens,
+            completionTokens: response.usage.completion_tokens,
+            totalTokens: response.usage.total_tokens,
+            finishReason: firstChoice?.finish_reason,
+            apiDuration: `${apiMs}ms`,
+        });
+    }
+}
+exports.ResponseHandler = ResponseHandler;
+//# sourceMappingURL=response-handler.js.map

package/dist/shared/response-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-handler.js","sourceRoot":"","sources":["../../src/shared/response-handler.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAmBH,MAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAA0B;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAA0B;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAEjC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO;gBACL,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACxC,YAAY,EAAE,MAAM;aACrB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE;YACtC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;YACxC,YAAY,EAAE,MAAM,CAAC,aAAa,IAAI,MAAM;SAC7C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,YAAY,CAAC,KAAgB;QAK1C,OAAO;YACL,YAAY,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;YACtC,gBAAgB,EAAE,KAAK,CAAC,iBAAiB,IAAI,CAAC;YAC9C,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;SACrC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAc,EAAE,QAA0B,EAAE,KAAa;QAC1E,sCAAsC;QACtC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QACjC,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAEjC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,uBAAuB,EAAE;YACvD,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;YAC1C,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,iBAAiB;YAClD,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;YACxC,YAAY,EAAE,WAAW,EAAE,aAAa;YACxC,WAAW,EAAE,GAAG,KAAK,IAAI;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AAtED,0CAsEC"}

package/dist/shared/timer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Timer Utility
+ * Performance measurement helper
+ */
+export interface TimerResult {
+    totalMs: number;
+    apiMs: number;
+    processingMs: number;
+}
+export declare class Timer {
+    private startTime;
+    private apiStartTime?;
+    private apiEndTime?;
+    constructor();
+    startApiCall(): void;
+    endApiCall(): void;
+    getResult(): TimerResult;
+    static format(ms: number): string;
+}
+//# sourceMappingURL=timer.d.ts.map

package/dist/shared/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/shared/timer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAS;;IAM5B,YAAY,IAAI,IAAI;IAIpB,UAAU,IAAI,IAAI;IAIlB,SAAS,IAAI,WAAW;IAWxB,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;CAGlC"}

package/dist/shared/timer.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Timer Utility
+ * Performance measurement helper
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timer = void 0;
+class Timer {
+    constructor() {
+        this.startTime = Date.now();
+    }
+    startApiCall() {
+        this.apiStartTime = Date.now();
+    }
+    endApiCall() {
+        this.apiEndTime = Date.now();
+    }
+    getResult() {
+        const endTime = Date.now();
+        const totalMs = endTime - this.startTime;
+        const apiMs = this.apiEndTime && this.apiStartTime
+            ? this.apiEndTime - this.apiStartTime
+            : 0;
+        const processingMs = totalMs - apiMs;
+        return { totalMs, apiMs, processingMs };
+    }
+    static format(ms) {
+        return `${ms}ms`;
+    }
+}
+exports.Timer = Timer;
+//# sourceMappingURL=timer.js.map

package/dist/shared/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/shared/timer.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAQH,MAAa,KAAK;IAKhB;QACE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED,YAAY;QACV,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACjC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED,SAAS;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY;YAChD,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY;YACrC,CAAC,CAAC,CAAC,CAAC;QACN,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,CAAC;QAErC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,EAAU;QACtB,OAAO,GAAG,EAAE,IAAI,CAAC;IACnB,CAAC;CACF;AA/BD,sBA+BC"}

package/package.json

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

package/src/application/use-cases/chat-generation.usecase.ts

@@ -0,0 +1,55 @@
+/**
+ * Chat Generation Use Case
+ * Simple stateless chat completion for single-turn conversations
+ */
+
+import type { GroqMessage, GroqGenerationConfig } from "../../domain/entities/groq.types";
+import { DEFAULT_MODELS } from "../../domain/entities/groq.types";
+import { groqHttpClient } from "../../infrastructure/http/groq-http-client";
+import { RequestBuilder } from "../../shared/request-builder";
+import { ResponseHandler } from "../../shared/response-handler";
+import { Timer } from "../../shared/timer";
+import { logger } from "../../shared/logger";
+
+export interface ChatGenerationOptions {
+  model?: string;
+  generationConfig?: GroqGenerationConfig;
+}
+
+export async function chatGeneration(
+  messages: GroqMessage[],
+  options: ChatGenerationOptions = {}
+): Promise<string> {
+  const timer = new Timer();
+
+  logger.debug("ChatGeneration", "Called", {
+    model: options.model,
+    messageCount: messages.length,
+  });
+
+  const request = RequestBuilder.buildChatRequest(messages, {
+    model: options.model || DEFAULT_MODELS.TEXT,
+    generationConfig: options.generationConfig,
+  });
+
+  logger.debug("ChatGeneration", "Sending request", {
+    endpoint: "/v1/chat/completions",
+    model: request.model,
+  });
+
+  timer.startApiCall();
+  const response = await groqHttpClient.chatCompletion(request);
+  timer.endApiCall();
+
+  const result = timer.getResult();
+  ResponseHandler.logResponse(logger, response, result.apiMs);
+
+  const handled = ResponseHandler.handleResponse(response);
+
+  logger.debug("ChatGeneration", "Complete", {
+    totalDuration: Timer.format(result.totalMs),
+    responseLength: handled.content.length,
+  });
+
+  return handled.content;
+}

package/src/index.ts

@@ -43,6 +43,7 @@ export {
 export { generateText, type TextGenerationOptions } from "./application/use-cases/text-generation.usecase";
 export { generateStructured, type StructuredGenerationOptions } from "./application/use-cases/structured-generation.usecase";
 export { streamText, type StreamingCallbacks, type StreamingOptions } from "./application/use-cases/streaming.usecase";
+export { chatGeneration, type ChatGenerationOptions } from "./application/use-cases/chat-generation.usecase";
 export { chatSessionManager, type ChatSession, type ChatSendResult } from "./application/use-cases/chat-session.usecase";
 
 // Infrastructure Layer - Direct exports