@gitsense/gsc-utils 0.2.3 → 0.2.5

package/src/EnvUtils.js

@@ -0,0 +1,88 @@
+/*
+ * Component: Environment Utilities
+ * Block-UUID: a4f78a41-3054-45f1-a839-778a3bd598f2
+ * Parent-UUID: N/A
+ * Version: 1.0.0
+ * Description: Provides utility functions for loading and accessing environment variables from a .env file.
+ * Language: JavaScript
+ * Created-at: 2025-08-28T17:46:26.948Z
+ * Authors: Gemini 2.5 Flash (v1.0.0)
+ */
+
+
+const fs = require('fs').promises;
+const path = require('path');
+
+// Simple .env parser, as dotenv is not explicitly a dependency
+// This handles basic KEY=VALUE pairs, ignores comments and empty lines.
+async function parseEnvFile(filePath) {
+    const env = {};
+    try {
+        const fileContent = await fs.readFile(filePath, 'utf8');
+        fileContent.split('\n').forEach(line => {
+            const trimmedLine = line.trim();
+            if (trimmedLine.length === 0 || trimmedLine.startsWith('#')) {
+                return; // Skip empty lines and comments
+            }
+            const parts = trimmedLine.split('=');
+            if (parts.length >= 2) {
+                const key = parts[0].trim();
+                const value = parts.slice(1).join('=').trim(); // Handle values with '='
+                env[key] = value;
+            }
+        });
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            console.warn(`EnvUtils: .env file not found at ${filePath}. Proceeding without loading.`);
+        } else {
+            throw new Error(`EnvUtils: Failed to read or parse .env file at ${filePath}: ${error.message}`);
+        }
+    }
+    return env;
+}
+
+/**
+ * Loads environment variables from the specified .env file path into process.env.
+ * This function will only load the .env file once per process.
+ *
+ * @param {string} filePath - The absolute path to the .env file.
+ * @returns {Promise<void>} A promise that resolves when the .env file has been processed.
+ * @throws {Error} If the file exists but cannot be read or parsed.
+ */
+let envLoaded = false;
+async function loadEnv(filePath) {
+    if (envLoaded) {
+        return; // Only load once
+    }
+
+    const envVars = await parseEnvFile(filePath);
+    for (const key in envVars) {
+        if (Object.hasOwnProperty.call(envVars, key)) {
+            // Only set if not already set in process.env (e.g., by system environment)
+            if (process.env[key] === undefined) {
+                process.env[key] = envVars[key];
+            }
+        }
+    }
+    envLoaded = true;
+}
+
+/**
+ * Retrieves the value of a specific API key from process.env.
+ * Assumes loadEnv has been called previously.
+ *
+ * @param {string} keyName - The name of the environment variable holding the API key (e.g., "GEMINI_API_KEY").
+ * @returns {string|null} The API key string, or null if the environment variable is not set.
+ */
+function getApiKey(keyName) {
+    if (typeof keyName !== 'string' || keyName.trim() === '') {
+        console.warn('EnvUtils: Attempted to get API key with an invalid keyName.');
+        return null;
+    }
+    return process.env[keyName] || null;
+}
+
+module.exports = {
+    loadEnv,
+    getApiKey
+};

package/src/GitSenseChatUtils.js

@@ -1,12 +1,12 @@
-/**
+/*
  * Component: GitSenseChatUtils
  * Block-UUID: 5e8d1a9c-0b3f-4e1a-8c7d-9f0b2e1d3a4b
  * Parent-UUID: 7a9b1c8e-f1a4-4b2d-9e8f-6f7a0b1c2d3f
- * Version: 2.1.1
- * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules.
+ * Version: 2.1.3
+ * Description: Interface class for GitSense Chat utilities providing a unified API for code block parsing (markdown), extraction, and patch operations. Integrates functionalities from CodeBlockUtils and PatchUtils modules, and now includes ConfigUtils and EnvUtils.
  * Language: JavaScript
  * Created-at: 2025-04-15T16:04:26.780Z
- * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1)
+ * Authors: Claude 3.7 Sonnet (v1.0.0), Gemini 2.5 Pro (v2.0.0), Gemini 2.5 Pro (v2.1.0), Gemini 2.5 Pro (v2.1.1), Gemini 2.5 Flash (v2.1.2), Gemini 2.5 Flash (v2.1.3)
  */
 
 
@@ -15,18 +15,20 @@ const CodeBlockUtils = require('./CodeBlockUtils');
 const ContextUtils = require('./ContextUtils');
 const MessageUtils = require('./MessageUtils');
 const AnalysisBlockUtils = require('./AnalysisBlockUtils');
-const AnalyzerUtils = require('./AnalyzerUtils');
+const AnalyzerUtils = require('./AnalyzerUtils'); // Updated import
 const PatchUtils = require('./PatchUtils');
 const GSToolBlockUtils = require('./GSToolBlockUtils');
 const LLMUtils = require('./LLMUtils');
 const JsonUtils = require('./JsonUtils');
+const ConfigUtils = require('./ConfigUtils');
+const EnvUtils = require('./EnvUtils');
 
 const {
     estimateTokens
 } = LLMUtils;
 
-const { 
-    detectJsonComments 
+const {
+    detectJsonComments
 } = JsonUtils;
 
 const {
@@ -53,6 +55,16 @@ const {
     validateOverviewMetadata,
 } = AnalysisBlockUtils;
 
+const { // Updated AnalyzerUtils destructuring
+    buildChatIdToPathMap,
+    processLLMAnalysisResponse,
+    validateLLMAnalysisData,
+    getAnalyzers,
+    getAnalyzerSchema,
+    deleteAnalyzer,
+    getAnalyzerInstructionsContent,
+} = AnalyzerUtils;
+
 const {
     COMMENT_STYLES,
     generateUUID,
@@ -92,11 +104,24 @@ const {
     verifyAndCorrectLineNumbers,
 } = PatchUtils;
 
-const { 
+const {
     isToolBlock,
     parseToolBlock
 } = GSToolBlockUtils;
 
+const {
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName
+} = ConfigUtils;
+
+const {
+    loadEnv,
+    getApiKey
+} = EnvUtils;
+
+
 /**
  * GitSenseChatUtils class provides a unified interface to code block and patch utilities.
  * Focuses on markdown code block extraction and processing.
@@ -241,8 +266,8 @@ class GitSenseChatUtils {
     extractDiffContent(patchText) {
         // Uses function from PatchUtils (assuming it's named extractPatchContent or similar)
         // If PatchUtils.extractDiffContent exists, use it. Otherwise, use extractPatchContent.
-        return PatchUtils.extractDiffContent 
-            ? PatchUtils.extractDiffContent(patchText) 
+        return PatchUtils.extractDiffContent
+            ? PatchUtils.extractDiffContent(patchText)
             : PatchUtils.extractPatchContent(patchText);
     }
 
@@ -317,6 +342,8 @@ module.exports = {
     ChatUtils,
     GSToolBlockUtils,
     JsonUtils,
+    ConfigUtils,
+    EnvUtils,
 
     // --- Individual Function Exports (sourced correctly) ---
 
@@ -349,26 +376,30 @@ module.exports = {
     formatBlockWithLineNumbers,
     formatBlocksWithLineNumbers,
     removeLineNumbers,
-     
+
     // Other Utilities (from CodeBlockUtils)
     removeCodeBlockMarkers,
     parseCommentDelimitedBlocks,
     updateCodeBlockByIndex,
     deleteCodeBlockByIndex,
 
-    // Analysis Block Utilities 
+    // Analysis Block Utilities
     isOverviewBlock,
     getOverviewType,
     parseOverviewMetadata,
     validateOverviewMetadata,
 
     // Analyzer Utilities
-    buildChatIdToPathMap: AnalyzerUtils.buildChatIdToPathMap,
-    processLLMAnalysisResponse: AnalyzerUtils.processLLMAnalysisResponse,
-    validateLLMAnalysisData: AnalyzerUtils.validateLLMAnalysisData,
+    buildChatIdToPathMap,
+    processLLMAnalysisResponse,
+    validateLLMAnalysisData,
+    getAnalyzers,
+    getAnalyzerSchema,
+    deleteAnalyzer,
+    getAnalyzerInstructionsContent,
 
     // ChatUtils
-    getChatMessages, 
+    getChatMessages,
 
     // Message Utils
     getChatTemplateMessages,
@@ -388,6 +419,16 @@ module.exports = {
     isToolBlock,
     parseToolBlock,
 
+    // Config Utils
+    loadConfig,
+    getProviderConfig,
+    getModelProviderDetails,
+    getApiKeyName,
+
+    // EnvUtils
+    loadEnv,
+    getApiKey,
+
     // Note: Internal helpers like findAllCodeFences, matchFencesAndExtractBlocks are
     // typically not exported directly from the facade but are available via CodeBlockUtils object.
 };