@omnicross/core 0.1.0

package/dist/transformer/transformers/GeminiTransformer.d.cts

@@ -0,0 +1,70 @@
+import { Transformer, TransformerLogger, TransformerOptions, LLMProvider, TransformerContext, UnifiedChatRequest } from '../types.cjs';
+
+/**
+ * GeminiTransformer - Bidirectional transformer for Google Gemini API
+ *
+ * Handles:
+ * - Request: Gemini → unified (transformRequestOut, for endpoint decoding)
+ * - Request: unified → Gemini (transformRequestIn, for provider encoding)
+ * - Response: Gemini → OpenAI (transformResponseOut, for provider decoding)
+ * - Response: OpenAI → Gemini (transformResponseIn, for endpoint encoding)
+ * - Authentication with x-goog-api-key or Bearer header
+ *
+ * @module transformer/transformers/GeminiTransformer
+ */
+
+/**
+ * GeminiTransformer handles Google Gemini API format conversion
+ *
+ * Features:
+ * - Converts UnifiedChatRequest to Gemini Contents format
+ * - Handles thinking/reasoning mode with thinkingConfig
+ * - Converts Gemini responses to OpenAI-compatible format and vice versa
+ * - Supports both streaming and non-streaming responses
+ * - Supports x-goog-api-key (official) and Bearer (relay) authentication
+ */
+declare class GeminiTransformer implements Transformer {
+    static TransformerName: string;
+    name: string;
+    logger?: TransformerLogger;
+    /**
+     * API endpoint pattern for Gemini
+     * :modelAndAction will be replaced with actual model and action
+     */
+    endPoint: string;
+    /** Use Bearer token instead of x-goog-api-key (for relay providers) */
+    private useBearer;
+    constructor(options?: TransformerOptions);
+    /**
+     * Handle authentication
+     * - Official Gemini: x-goog-api-key header
+     * - Relay providers: Authorization: Bearer header
+     */
+    auth(request: unknown, provider: LLMProvider, _context: TransformerContext): Promise<{
+        body: unknown;
+        config: {
+            headers: Record<string, string | undefined>;
+        };
+    }>;
+    /**
+     * Transform request from unified format to Gemini format
+     * Also builds the correct URL for the Gemini API
+     */
+    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
+    /**
+     * Transform incoming request to unified format
+     * (For requests coming into the Gemini endpoint)
+     */
+    transformRequestOut(request: unknown, _context: TransformerContext): Promise<UnifiedChatRequest>;
+    /**
+     * Transform Gemini response to OpenAI-compatible format
+     */
+    transformResponseOut(response: Response, _context: TransformerContext): Promise<Response>;
+    /**
+     * Transform OpenAI-compatible response back to Gemini format
+     * (For endpoint mode — returning Gemini-format responses to the client)
+     */
+    transformResponseIn(response: Response, _context?: TransformerContext): Promise<Response>;
+}
+
+export { GeminiTransformer };

package/dist/transformer/transformers/GeminiTransformer.d.ts

@@ -0,0 +1,70 @@
+import { Transformer, TransformerLogger, TransformerOptions, LLMProvider, TransformerContext, UnifiedChatRequest } from '../types.js';
+
+/**
+ * GeminiTransformer - Bidirectional transformer for Google Gemini API
+ *
+ * Handles:
+ * - Request: Gemini → unified (transformRequestOut, for endpoint decoding)
+ * - Request: unified → Gemini (transformRequestIn, for provider encoding)
+ * - Response: Gemini → OpenAI (transformResponseOut, for provider decoding)
+ * - Response: OpenAI → Gemini (transformResponseIn, for endpoint encoding)
+ * - Authentication with x-goog-api-key or Bearer header
+ *
+ * @module transformer/transformers/GeminiTransformer
+ */
+
+/**
+ * GeminiTransformer handles Google Gemini API format conversion
+ *
+ * Features:
+ * - Converts UnifiedChatRequest to Gemini Contents format
+ * - Handles thinking/reasoning mode with thinkingConfig
+ * - Converts Gemini responses to OpenAI-compatible format and vice versa
+ * - Supports both streaming and non-streaming responses
+ * - Supports x-goog-api-key (official) and Bearer (relay) authentication
+ */
+declare class GeminiTransformer implements Transformer {
+    static TransformerName: string;
+    name: string;
+    logger?: TransformerLogger;
+    /**
+     * API endpoint pattern for Gemini
+     * :modelAndAction will be replaced with actual model and action
+     */
+    endPoint: string;
+    /** Use Bearer token instead of x-goog-api-key (for relay providers) */
+    private useBearer;
+    constructor(options?: TransformerOptions);
+    /**
+     * Handle authentication
+     * - Official Gemini: x-goog-api-key header
+     * - Relay providers: Authorization: Bearer header
+     */
+    auth(request: unknown, provider: LLMProvider, _context: TransformerContext): Promise<{
+        body: unknown;
+        config: {
+            headers: Record<string, string | undefined>;
+        };
+    }>;
+    /**
+     * Transform request from unified format to Gemini format
+     * Also builds the correct URL for the Gemini API
+     */
+    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
+    /**
+     * Transform incoming request to unified format
+     * (For requests coming into the Gemini endpoint)
+     */
+    transformRequestOut(request: unknown, _context: TransformerContext): Promise<UnifiedChatRequest>;
+    /**
+     * Transform Gemini response to OpenAI-compatible format
+     */
+    transformResponseOut(response: Response, _context: TransformerContext): Promise<Response>;
+    /**
+     * Transform OpenAI-compatible response back to Gemini format
+     * (For endpoint mode — returning Gemini-format responses to the client)
+     */
+    transformResponseIn(response: Response, _context?: TransformerContext): Promise<Response>;
+}
+
+export { GeminiTransformer };