jskelet 0.2.5 → 0.3.0

package/src/server/dev/socket.js

@@ -1,170 +1,170 @@
-/**
- * Dev araçlarının canlı kanalı: küçük bir WebSocket sunucusu.
- *
- * Overlay eskiden istatistikleri iki saniyede bir `GET /stats` ile çekiyordu;
- * panel kapalıyken bile her sekme sürekli istek atıyor, dev sunucusunun istek
- * günlüğünü de kirletiyordu. Artık sunucu değişiklik oldukça (istek, hata,
- * ısıtma ilerlemesi, CSS/JS değişimi) tek bağlantı üzerinden itiyor.
- *
- * Bağımlılık eklemiyoruz: yalnızca sunucu→istemci metin çerçevesi yazmak ve
- * istemcinin ping/close çerçevelerini anlamak gerekiyor; bu da RFC 6455'in
- * küçük bir alt kümesi. `permessage-deflate` yok, parça (fragment) yok —
- * gönderdiğimiz paketler için ikisi de gereksiz.
- */
-import { createHash } from "node:crypto";
-
-/** RFC 6455'te sabitlenmiş el sıkışma tuzu. */
-const GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
-
-/** @type {Set<import('node:net').Socket>} */
-const sockets = new Set();
-
-/** @param {string} key */
-function accept(key) {
-  return createHash("sha1")
-    .update(key + GUID)
-    .digest("base64");
-}
-
-/**
- * Tek parçalı metin çerçevesi. Maskeleme yalnızca istemci→sunucu yönünde
- * zorunlu olduğu için burada yok.
- *
- * @param {string} text
- * @returns {Buffer}
- */
-function frame(text) {
-  const payload = Buffer.from(text, "utf8");
-  const length = payload.length;
-
-  /** @type {Buffer} */
-  let header;
-  if (length < 126) {
-    header = Buffer.from([0x81, length]);
-  } else if (length < 65536) {
-    header = Buffer.alloc(4);
-    header[0] = 0x81;
-    header[1] = 126;
-    header.writeUInt16BE(length, 2);
-  } else {
-    header = Buffer.alloc(10);
-    header[0] = 0x81;
-    header[1] = 127;
-    header.writeBigUInt64BE(BigInt(length), 2);
-  }
-
-  return Buffer.concat([header, payload]);
-}
-
-/**
- * İstemciden gelen çerçeveleri ayıklar. İçerik bizi ilgilendirmiyor; amaç
- * kapanışı ve ping'i doğru yanıtlamak, aksi hâlde tarayıcı bağlantıyı
- * "protokol hatası" sayıp kapatıyor.
- *
- * @param {import('node:net').Socket} socket
- */
-function readFrames(socket) {
-  let buffer = Buffer.alloc(0);
-
-  socket.on("data", (chunk) => {
-    buffer = Buffer.concat([buffer, chunk]);
-
-    while (buffer.length >= 2) {
-      const opcode = buffer[0] & 0x0f;
-      const masked = (buffer[1] & 0x80) !== 0;
-      let length = buffer[1] & 0x7f;
-      let offset = 2;
-
-      if (length === 126) {
-        if (buffer.length < offset + 2) return;
-        length = buffer.readUInt16BE(offset);
-        offset += 2;
-      } else if (length === 127) {
-        if (buffer.length < offset + 8) return;
-        length = Number(buffer.readBigUInt64BE(offset));
-        offset += 8;
-      }
-
-      if (masked) offset += 4;
-      if (buffer.length < offset + length) return;
-
-      buffer = buffer.subarray(offset + length);
-
-      // 0x8 close, 0x9 ping. Veri çerçeveleri yok sayılır: istemcinin bize
-      // söyleyeceği bir şey yok, kanal tek yönlü kullanılıyor.
-      if (opcode === 0x8) {
-        socket.end(Buffer.from([0x88, 0x00]));
-        return;
-      }
-      if (opcode === 0x9) socket.write(Buffer.from([0x8a, 0x00]));
-    }
-  });
-}
-
-/**
- * HTTP upgrade isteğini WebSocket bağlantısına çevirir.
- *
- * @param {import('node:http').IncomingMessage} req
- * @param {import('node:net').Socket} socket
- * @param {Buffer} head Node'un istekle birlikte okuduğu artakalan baytlar.
- * @param {(send: (payload: object) => void) => void} onOpen
- *   Bağlantı kurulunca çağrılır; ilk paketi göndermek için kullanılır.
- */
-export function upgradeToSocket(req, socket, head, onOpen) {
-  const key = req.headers["sec-websocket-key"];
-  if (!key) {
-    socket.destroy();
-    return;
-  }
-
-  socket.write(
-    "HTTP/1.1 101 Switching Protocols\r\n" +
-      "Upgrade: websocket\r\n" +
-      "Connection: Upgrade\r\n" +
-      `Sec-WebSocket-Accept: ${accept(String(key))}\r\n\r\n`,
-  );
-
-  // Küçük paketleri geciktirmenin anlamı yok; panel anlık görünmeli.
-  socket.setNoDelay(true);
-  // Bağlantı hataları (sekme kapanması, ağ) süreci düşürmemeli.
-  socket.on("error", () => socket.destroy());
-  socket.on("close", () => sockets.delete(socket));
-
-  readFrames(socket);
-  // İstekle aynı okumada gelen baytlar varsa akışa geri konur; yoksa
-  // istemcinin ilk çerçevesi sessizce kaybolur.
-  if (head?.length) socket.unshift(head);
-  sockets.add(socket);
-
-  /** @param {object} payload */
-  const send = (payload) => {
-    if (!socket.destroyed) socket.write(frame(JSON.stringify(payload)));
-  };
-
-  // İlk paketler bir sonraki tur'a bırakılır. Aynı yazma turunda gönderilirse
-  // el sıkışma yanıtıyla tek bir TCP parçasına düşüyor ve tarayıcı o parçada
-  // artakalan baytları HTTP gövdesi sanıp bağlantıyı sessizce kapatıyor: ham
-  // bir istemci sorun görmez, Chrome "finished" deyip çıkar.
-  setImmediate(() => {
-    if (!socket.destroyed) onOpen(send);
-  });
-}
-
-/**
- * Bağlı tüm panellere gönderir.
- * @param {object} payload
- */
-export function broadcastSocket(payload) {
-  if (!sockets.size) return;
-
-  const packet = frame(JSON.stringify(payload));
-  for (const socket of sockets) {
-    if (socket.destroyed) sockets.delete(socket);
-    else socket.write(packet);
-  }
-}
-
-/** @returns {number} açık panel sayısı */
-export function socketCount() {
-  return sockets.size;
-}
+/**
+ * Dev araçlarının canlı kanalı: küçük bir WebSocket sunucusu.
+ *
+ * Overlay eskiden istatistikleri iki saniyede bir `GET /stats` ile çekiyordu;
+ * panel kapalıyken bile her sekme sürekli istek atıyor, dev sunucusunun istek
+ * günlüğünü de kirletiyordu. Artık sunucu değişiklik oldukça (istek, hata,
+ * ısıtma ilerlemesi, CSS/JS değişimi) tek bağlantı üzerinden itiyor.
+ *
+ * Bağımlılık eklemiyoruz: yalnızca sunucu→istemci metin çerçevesi yazmak ve
+ * istemcinin ping/close çerçevelerini anlamak gerekiyor; bu da RFC 6455'in
+ * küçük bir alt kümesi. `permessage-deflate` yok, parça (fragment) yok —
+ * gönderdiğimiz paketler için ikisi de gereksiz.
+ */
+import { createHash } from "node:crypto";
+
+/** RFC 6455'te sabitlenmiş el sıkışma tuzu. */
+const GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
+
+/** @type {Set<import('node:net').Socket>} */
+const sockets = new Set();
+
+/** @param {string} key */
+function accept(key) {
+  return createHash("sha1")
+    .update(key + GUID)
+    .digest("base64");
+}
+
+/**
+ * Tek parçalı metin çerçevesi. Maskeleme yalnızca istemci→sunucu yönünde
+ * zorunlu olduğu için burada yok.
+ *
+ * @param {string} text
+ * @returns {Buffer}
+ */
+function frame(text) {
+  const payload = Buffer.from(text, "utf8");
+  const length = payload.length;
+
+  /** @type {Buffer} */
+  let header;
+  if (length < 126) {
+    header = Buffer.from([0x81, length]);
+  } else if (length < 65536) {
+    header = Buffer.alloc(4);
+    header[0] = 0x81;
+    header[1] = 126;
+    header.writeUInt16BE(length, 2);
+  } else {
+    header = Buffer.alloc(10);
+    header[0] = 0x81;
+    header[1] = 127;
+    header.writeBigUInt64BE(BigInt(length), 2);
+  }
+
+  return Buffer.concat([header, payload]);
+}
+
+/**
+ * İstemciden gelen çerçeveleri ayıklar. İçerik bizi ilgilendirmiyor; amaç
+ * kapanışı ve ping'i doğru yanıtlamak, aksi hâlde tarayıcı bağlantıyı
+ * "protokol hatası" sayıp kapatıyor.
+ *
+ * @param {import('node:net').Socket} socket
+ */
+function readFrames(socket) {
+  let buffer = Buffer.alloc(0);
+
+  socket.on("data", (chunk) => {
+    buffer = Buffer.concat([buffer, chunk]);
+
+    while (buffer.length >= 2) {
+      const opcode = buffer[0] & 0x0f;
+      const masked = (buffer[1] & 0x80) !== 0;
+      let length = buffer[1] & 0x7f;
+      let offset = 2;
+
+      if (length === 126) {
+        if (buffer.length < offset + 2) return;
+        length = buffer.readUInt16BE(offset);
+        offset += 2;
+      } else if (length === 127) {
+        if (buffer.length < offset + 8) return;
+        length = Number(buffer.readBigUInt64BE(offset));
+        offset += 8;
+      }
+
+      if (masked) offset += 4;
+      if (buffer.length < offset + length) return;
+
+      buffer = buffer.subarray(offset + length);
+
+      // 0x8 close, 0x9 ping. Veri çerçeveleri yok sayılır: istemcinin bize
+      // söyleyeceği bir şey yok, kanal tek yönlü kullanılıyor.
+      if (opcode === 0x8) {
+        socket.end(Buffer.from([0x88, 0x00]));
+        return;
+      }
+      if (opcode === 0x9) socket.write(Buffer.from([0x8a, 0x00]));
+    }
+  });
+}
+
+/**
+ * HTTP upgrade isteğini WebSocket bağlantısına çevirir.
+ *
+ * @param {import('node:http').IncomingMessage} req
+ * @param {import('node:net').Socket} socket
+ * @param {Buffer} head Node'un istekle birlikte okuduğu artakalan baytlar.
+ * @param {(send: (payload: object) => void) => void} onOpen
+ *   Bağlantı kurulunca çağrılır; ilk paketi göndermek için kullanılır.
+ */
+export function upgradeToSocket(req, socket, head, onOpen) {
+  const key = req.headers["sec-websocket-key"];
+  if (!key) {
+    socket.destroy();
+    return;
+  }
+
+  socket.write(
+    "HTTP/1.1 101 Switching Protocols\r\n" +
+      "Upgrade: websocket\r\n" +
+      "Connection: Upgrade\r\n" +
+      `Sec-WebSocket-Accept: ${accept(String(key))}\r\n\r\n`,
+  );
+
+  // Küçük paketleri geciktirmenin anlamı yok; panel anlık görünmeli.
+  socket.setNoDelay(true);
+  // Bağlantı hataları (sekme kapanması, ağ) süreci düşürmemeli.
+  socket.on("error", () => socket.destroy());
+  socket.on("close", () => sockets.delete(socket));
+
+  readFrames(socket);
+  // İstekle aynı okumada gelen baytlar varsa akışa geri konur; yoksa
+  // istemcinin ilk çerçevesi sessizce kaybolur.
+  if (head?.length) socket.unshift(head);
+  sockets.add(socket);
+
+  /** @param {object} payload */
+  const send = (payload) => {
+    if (!socket.destroyed) socket.write(frame(JSON.stringify(payload)));
+  };
+
+  // İlk paketler bir sonraki tur'a bırakılır. Aynı yazma turunda gönderilirse
+  // el sıkışma yanıtıyla tek bir TCP parçasına düşüyor ve tarayıcı o parçada
+  // artakalan baytları HTTP gövdesi sanıp bağlantıyı sessizce kapatıyor: ham
+  // bir istemci sorun görmez, Chrome "finished" deyip çıkar.
+  setImmediate(() => {
+    if (!socket.destroyed) onOpen(send);
+  });
+}
+
+/**
+ * Bağlı tüm panellere gönderir.
+ * @param {object} payload
+ */
+export function broadcastSocket(payload) {
+  if (!sockets.size) return;
+
+  const packet = frame(JSON.stringify(payload));
+  for (const socket of sockets) {
+    if (socket.destroyed) sockets.delete(socket);
+    else socket.write(packet);
+  }
+}
+
+/** @returns {number} açık panel sayısı */
+export function socketCount() {
+  return sockets.size;
+}

package/src/server/dev/version-check.mjs

@@ -1,139 +1,139 @@
-/**
- * npm kayıt defterindeki son sürümü yoklar ve dev overlay'e "outdated" bilgisi
- * verir. Yalnızca geliştirme sırasında çalışır.
- *
- * Sonuç geçici dizinde saklanıyor: `node --watch` sunucuyu sık yeniden
- * başlatıyor ve her açılışta ağa çıkmak hem yavaş hem gereksiz. Kayıt defteri
- * ulaşılamazsa sessizce eski/boş sonuç kullanılır — sürüm kontrolü hiçbir
- * koşulda dev akışını bekletmez ya da hata basmaz.
- */
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { FRAMEWORK_PACKAGE, FRAMEWORK_VERSION } from "../../version.mjs";
-
-const CACHE_FILE = path.join(os.tmpdir(), `jskelet-version-${FRAMEWORK_PACKAGE}.json`);
-
-/** Aynı sürümü saatte birden fazla sormanın anlamı yok. */
-const TTL = 6 * 60 * 60 * 1000;
-
-const TIMEOUT = 3000;
-
-/** @type {{ current: string, latest: string | null, outdated: boolean, checkedAt: number | null }} */
-let state = {
-  current: FRAMEWORK_VERSION,
-  latest: null,
-  outdated: false,
-  checkedAt: null,
-};
-
-/**
- * Ön sürüm etiketleri (`1.2.0-beta.1`) karşılaştırmada yok sayılır: kayıt
- * defterinden yalnızca `latest` etiketi okunduğu için pratikte gelmiyor.
- * @param {string} a
- * @param {string} b
- * @returns {number} a > b ise pozitif
- */
-function compare(a, b) {
-  const parse = (value) =>
-    String(value)
-      .split("-")[0]
-      .split(".")
-      .map((part) => Number.parseInt(part, 10) || 0);
-
-  const left = parse(a);
-  const right = parse(b);
-
-  for (let index = 0; index < 3; index += 1) {
-    const diff = (left[index] ?? 0) - (right[index] ?? 0);
-    if (diff) return diff;
-  }
-
-  return 0;
-}
-
-/**
- * @param {string | null} latest
- */
-function apply(latest) {
-  state = {
-    current: FRAMEWORK_VERSION,
-    latest,
-    outdated: Boolean(latest) && compare(latest, FRAMEWORK_VERSION) > 0,
-    checkedAt: Date.now(),
-  };
-}
-
-/** @returns {{ latest: string, checkedAt: number } | null} */
-function readCache() {
-  try {
-    const saved = JSON.parse(fs.readFileSync(CACHE_FILE, "utf8"));
-    if (typeof saved.latest !== "string" || typeof saved.checkedAt !== "number") return null;
-    return saved;
-  } catch {
-    return null;
-  }
-}
-
-async function fetchLatest() {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), TIMEOUT);
-
-  try {
-    const response = await fetch(
-      `https://registry.npmjs.org/${encodeURIComponent(FRAMEWORK_PACKAGE)}/latest`,
-      {
-        signal: controller.signal,
-        headers: { accept: "application/vnd.npm.install-v1+json, application/json" },
-      },
-    );
-
-    if (!response.ok) return;
-
-    const body = await response.json();
-    if (typeof body?.version !== "string") return;
-
-    apply(body.version);
-    try {
-      fs.writeFileSync(
-        CACHE_FILE,
-        JSON.stringify({ latest: body.version, checkedAt: state.checkedAt }),
-      );
-    } catch {
-      // Önbellek yazılamazsa yalnızca her açılışta yeniden sorulur.
-    }
-  } catch {
-    // Ağ yok, kayıt defteri kapalı ya da zaman aşımı: sürüm bilgisi boş kalır.
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-/**
- * Kontrolü başlatır. Beklenmez; sonuç geldiğinde `versionStatus()` günceldir.
- * `JSKELET_VERSION_CHECK=0` ile tamamen kapatılabilir (çevrimdışı çalışma,
- * kurumsal ağlar).
- */
-export function startVersionCheck() {
-  if (process.env.JSKELET_VERSION_CHECK === "0") return;
-
-  const cached = readCache();
-  if (cached) {
-    apply(cached.latest);
-    state.checkedAt = cached.checkedAt;
-    if (Date.now() - cached.checkedAt < TTL) return;
-  }
-
-  // Açılışta ağ isteği ilk isteğin önüne geçmesin.
-  const timer = setTimeout(() => {
-    fetchLatest();
-  }, 1500);
-  timer.unref?.();
-}
-
-/**
- * @returns {{ current: string, latest: string | null, outdated: boolean, checkedAt: number | null }}
- */
-export function versionStatus() {
-  return state;
-}
+/**
+ * npm kayıt defterindeki son sürümü yoklar ve dev overlay'e "outdated" bilgisi
+ * verir. Yalnızca geliştirme sırasında çalışır.
+ *
+ * Sonuç geçici dizinde saklanıyor: `node --watch` sunucuyu sık yeniden
+ * başlatıyor ve her açılışta ağa çıkmak hem yavaş hem gereksiz. Kayıt defteri
+ * ulaşılamazsa sessizce eski/boş sonuç kullanılır — sürüm kontrolü hiçbir
+ * koşulda dev akışını bekletmez ya da hata basmaz.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { FRAMEWORK_PACKAGE, FRAMEWORK_VERSION } from "../../version.mjs";
+
+const CACHE_FILE = path.join(os.tmpdir(), `jskelet-version-${FRAMEWORK_PACKAGE}.json`);
+
+/** Aynı sürümü saatte birden fazla sormanın anlamı yok. */
+const TTL = 6 * 60 * 60 * 1000;
+
+const TIMEOUT = 3000;
+
+/** @type {{ current: string, latest: string | null, outdated: boolean, checkedAt: number | null }} */
+let state = {
+  current: FRAMEWORK_VERSION,
+  latest: null,
+  outdated: false,
+  checkedAt: null,
+};
+
+/**
+ * Ön sürüm etiketleri (`1.2.0-beta.1`) karşılaştırmada yok sayılır: kayıt
+ * defterinden yalnızca `latest` etiketi okunduğu için pratikte gelmiyor.
+ * @param {string} a
+ * @param {string} b
+ * @returns {number} a > b ise pozitif
+ */
+function compare(a, b) {
+  const parse = (value) =>
+    String(value)
+      .split("-")[0]
+      .split(".")
+      .map((part) => Number.parseInt(part, 10) || 0);
+
+  const left = parse(a);
+  const right = parse(b);
+
+  for (let index = 0; index < 3; index += 1) {
+    const diff = (left[index] ?? 0) - (right[index] ?? 0);
+    if (diff) return diff;
+  }
+
+  return 0;
+}
+
+/**
+ * @param {string | null} latest
+ */
+function apply(latest) {
+  state = {
+    current: FRAMEWORK_VERSION,
+    latest,
+    outdated: Boolean(latest) && compare(latest, FRAMEWORK_VERSION) > 0,
+    checkedAt: Date.now(),
+  };
+}
+
+/** @returns {{ latest: string, checkedAt: number } | null} */
+function readCache() {
+  try {
+    const saved = JSON.parse(fs.readFileSync(CACHE_FILE, "utf8"));
+    if (typeof saved.latest !== "string" || typeof saved.checkedAt !== "number") return null;
+    return saved;
+  } catch {
+    return null;
+  }
+}
+
+async function fetchLatest() {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TIMEOUT);
+
+  try {
+    const response = await fetch(
+      `https://registry.npmjs.org/${encodeURIComponent(FRAMEWORK_PACKAGE)}/latest`,
+      {
+        signal: controller.signal,
+        headers: { accept: "application/vnd.npm.install-v1+json, application/json" },
+      },
+    );
+
+    if (!response.ok) return;
+
+    const body = await response.json();
+    if (typeof body?.version !== "string") return;
+
+    apply(body.version);
+    try {
+      fs.writeFileSync(
+        CACHE_FILE,
+        JSON.stringify({ latest: body.version, checkedAt: state.checkedAt }),
+      );
+    } catch {
+      // Önbellek yazılamazsa yalnızca her açılışta yeniden sorulur.
+    }
+  } catch {
+    // Ağ yok, kayıt defteri kapalı ya da zaman aşımı: sürüm bilgisi boş kalır.
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+/**
+ * Kontrolü başlatır. Beklenmez; sonuç geldiğinde `versionStatus()` günceldir.
+ * `JSKELET_VERSION_CHECK=0` ile tamamen kapatılabilir (çevrimdışı çalışma,
+ * kurumsal ağlar).
+ */
+export function startVersionCheck() {
+  if (process.env.JSKELET_VERSION_CHECK === "0") return;
+
+  const cached = readCache();
+  if (cached) {
+    apply(cached.latest);
+    state.checkedAt = cached.checkedAt;
+    if (Date.now() - cached.checkedAt < TTL) return;
+  }
+
+  // Açılışta ağ isteği ilk isteğin önüne geçmesin.
+  const timer = setTimeout(() => {
+    fetchLatest();
+  }, 1500);
+  timer.unref?.();
+}
+
+/**
+ * @returns {{ current: string, latest: string | null, outdated: boolean, checkedAt: number | null }}
+ */
+export function versionStatus() {
+  return state;
+}