jskelet 0.1.6 → 0.1.7

package/docs/09-dev-araclari.md

@@ -149,10 +149,13 @@ uğramadığı için kanal `listen` sonrası doğrudan sunucuya bağlanır
 sunucu→istemci metin çerçevesi yazmak ve istemcinin ping/close çerçevelerini
 yanıtlamak gerekiyor.
 
-Soket hiç açılamazsa (araya giren bir proxy WebSocket'i geçirmiyor olabilir)
-overlay eski yola düşer: `/events` SSE akışı + `/stats` yoklaması. Soket kurulup
-sonra düşerse — yani sunucu yeniden başlıyorsa — yarım saniyede bir yeniden
-bağlanır ve gösterge bu sırada "bağlantı yok" der.
+Soket kurulup sonra düşerse — yani sunucu yeniden başlıyorsa — yarım saniyede
+bir yeniden bağlanır ve gösterge bu sırada "bağlantı yok" der. Hiç açılamazsa
+aralığı kademeli açarak dört kez denenir; sayfa, sunucunun yeniden başlama
+penceresinde açılmış olabilir ve tek bir başarısızlık kanalın çalışmadığı
+anlamına gelmez. Denemeler de tutmazsa (araya giren bir proxy WebSocket'i
+geçirmiyor olabilir) overlay eski yola düşer: `/events` SSE akışı + `/stats`
+yoklaması.
 
 ## Devtools overlay
 

package/docs/en/09-dev-tools.md

@@ -152,11 +152,13 @@ the middleware chain, so the channel is attached straight to the server after
 `ws`: all it needs is to write server-to-client text frames and to answer the
 client's ping/close frames.
 
-If the socket cannot be opened at all (a proxy in between may not pass WebSocket
-through), the overlay falls back to the old path: the `/events` SSE stream plus
-polling `/stats`. If the socket opens and later drops — that is, the server is
-restarting — it reconnects every half second and the indicator reads
-"server restarting…" in the meantime.
+If the socket opens and later drops — that is, the server is restarting — it
+reconnects every half second and the indicator reads "server restarting…" in the
+meantime. If it never opens, it is retried four times with a widening gap: the
+page may have been loaded during the server's restart window, and a single
+failure does not mean the channel is unavailable. If those attempts fail too (a
+proxy in between may not pass WebSocket through), the overlay falls back to the
+old path: the `/events` SSE stream plus polling `/stats`.
 
 ## Devtools overlay
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jskelet",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "A framework that feels like no framework: Express 5 + EJS server rendering, vanilla JS islands, Tailwind v4 and an in-process HTML TTL cache.",
   "type": "module",
   "license": "MIT",

package/src/client/devtools/overlay.js

@@ -397,6 +397,15 @@ let restarts = 0;
  * yenileme yapılır; overlay durumu sekme belleğinde durduğu için panel açık
  * kalmaya devam eder.
  */
+/**
+ * Hiç açılmadan üst üste bu kadar denemeden sonra kanal yerine yedek yola
+ * geçilir. Tek bir başarısızlık yetmiyor: sayfa, sunucunun yeniden başlama
+ * penceresinde açılmış olabilir ve o an soket kurulamaz.
+ */
+const SOCKET_ATTEMPTS = 4;
+
+let socketFailures = 0;
+
 function connectSocket() {
   let socket;
   try {
@@ -408,12 +417,11 @@ function connectSocket() {
     return;
   }
 
-  // Soket hiç açılamazsa (proxy WebSocket'i geçirmiyor olabilir) eski
-  // SSE + yoklama yoluna düşülür; dev akışı bir ara katman yüzünden körelmesin.
   let opened = false;
 
   socket.addEventListener("open", () => {
     opened = true;
+    socketFailures = 0;
   });
 
   socket.addEventListener("message", (event) => {
@@ -421,18 +429,31 @@ function connectSocket() {
   });
 
   socket.addEventListener("close", () => {
-    if (!opened) {
-      startFallback();
-      return;
-    }
-
-    // Sunucu yeniden başlıyor: gösterge "bağlantı yok"a döner ve kısa aralıkla
+    // Sunucu yeniden başlıyor olabilir: gösterge "bağlantı yok"a döner ve
     // yeniden denenir. Açılışta gelen `hello` yeniden başlatmayı bildirir.
     if (!offline) {
       offline = true;
       render();
     }
-    setTimeout(connectSocket, 500);
+
+    if (opened) {
+      socketFailures = 0;
+      setTimeout(connectSocket, 500);
+      return;
+    }
+
+    socketFailures += 1;
+
+    // Kanal hiç kurulamıyorsa araya giren bir katman WebSocket'i geçirmiyor
+    // demektir; dev akışı bunun yüzünden körelmesin diye eski yola düşülür.
+    if (socketFailures >= SOCKET_ATTEMPTS) {
+      startFallback();
+      return;
+    }
+
+    // Yeniden başlatma birkaç saniye sürebiliyor; aralık kademeli açılır ki
+    // tarayıcı konsolu başarısız bağlantı satırlarıyla dolmasın.
+    setTimeout(connectSocket, socketFailures * 700);
   });
 }