jsvelox 1.5.0 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsvelox",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Lightweight JS library for AI integration and developer utilities",
   "main": "src/index.js",
   "type": "module",

package/src/index.js

@@ -1,4 +1,8 @@
 export class VeloxAI {
+  // TR: Kütüphaneyi başlatır. API key, provider (claude/openai/gemini), model ve timeout ayarlarını alır.
+  // Eksik bilgi girilirse hata fırlatır.
+  // EN: Initializes the library. Takes API key, provider (claude/openai/gemini), model and timeout settings.
+  // Throws an error if required fields are missing.
   constructor(config) {
     if (!config.apiKey) {
       throw new Error('API key zorunlu!')
@@ -12,15 +16,19 @@ export class VeloxAI {
     this.memory = []
     this.timeout = config.timeout || 30000
   }
-
+  // TR: Kullanıcının mesajını seçili yapay zekaya gönderir ve cevabı döndürür.
+  // Konuşma geçmişini (memory) otomatik yönetir. Hata olursa memory'i temizler.
+  // EN: Sends the user's message to the selected AI and returns the response.
+  // Automatically manages conversation history (memory). Clears memory on error.
   async send(message) {
-    this.memory.push({ role: 'user', content: message })
+  this.memory.push({ role: 'user', content: message })
 
-    const timeoutPromise = new Promise((_, reject) =>
-      setTimeout(() => reject(new Error('Zaman aşımı! AI cevap vermedi.')), this.timeout)
-    )
+  const timeoutPromise = new Promise((_, reject) =>
+    setTimeout(() => reject(new Error('Zaman aşımı! AI cevap vermedi.')), this.timeout)
+  )
 
-    let cevap
+  let cevap
+  try {
     if (this.provider === 'claude') {
       cevap = await Promise.race([this._sendClaude(this.memory), timeoutPromise])
     } else if (this.provider === 'openai') {
@@ -30,21 +38,34 @@ export class VeloxAI {
     } else {
       throw new Error('Geçersiz provider. claude, openai veya gemini kullan.')
     }
-
-    this.memory.push({ role: 'assistant', content: cevap })
-    return cevap
+  } catch (err) {
+    this.memory.pop() // hata olunca memory'den çıkar
+    throw err
   }
 
+  this.memory.push({ role: 'assistant', content: cevap })
+  return cevap
+}
+  // TR: Mesajı gönderir, hata olursa belirtilen sayıda tekrar dener (varsayılan 3 kez).
+  // Her deneme arasında 1 saniye bekler. Tüm denemeler başarısız olursa hatayı fırlatır.
+  // EN: Sends the message and retries on failure up to the specified number of times (default 3).
+  // Waits 1 second between retries. Throws the error if all attempts fail.
+
   async sendWithRetry(message, retries = 3) {
-    for (let i = 0; i < retries; i++) {
-      try {
-        return await this.send(message)
-      } catch (err) {
-        if (i === retries - 1) throw err
-        await new Promise(r => setTimeout(r, 1000))
-      }
+  for (let i = 0; i < retries; i++) {
+    try {
+      return await this.send(message)
+    } catch (err) {
+      this.memory.pop() // hata olunca memory'den çıkar
+      if (i === retries - 1) throw err
+      await new Promise(r => setTimeout(r, 1000))
     }
-  } 
+  }
+} 
+  // TR: Mesajı Anthropic Claude API'sine gönderir ve metin cevabı döndürür.
+  // Dahili metottur, doğrudan çağrılmamalıdır.
+  // EN: Sends the message to Anthropic Claude API and returns the text response.
+  // Internal method, should not be called directly.
 
   async _sendClaude(memory) {
     const response = await fetch('https://api.anthropic.com/v1/messages', {
@@ -66,6 +87,10 @@ export class VeloxAI {
     }
     return data.content[0].text
   }
+  // TR: Mesajı OpenAI API'sine gönderir ve metin cevabı döndürür.
+  // Dahili metottur, doğrudan çağrılmamalıdır.
+  // EN: Sends the message to OpenAI API and returns the text response.
+  // Internal method, should not be called directly.
 
   async _sendOpenAI(memory) {
     const response = await fetch('https://api.openai.com/v1/chat/completions', {
@@ -85,6 +110,11 @@ export class VeloxAI {
     }
     return data.choices[0].message.content
   }
+  // TR: Mesajı Google Gemini API'sine gönderir ve metin cevabı döndürür.
+  // Konuşma geçmişini Gemini'nin beklediği formata dönüştürür.
+  // EN: Sends the message to Google Gemini API and returns the text response.
+  // Converts conversation history into the format expected by Gemini.
+
   async _sendGemini(memory) {
     const url = `https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=${this.apiKey}`    
     const contents = memory.map(m => ({