jskelet 0.2.5 → 0.3.0

package/src/server/middleware/static-precompressed.js

@@ -1,100 +1,100 @@
-/**
- * Build'de üretilmiş `.br` / `.gz` kopyalarını servis eder.
- *
- * `express.static`ten önce çalışır: istemcinin kabul ettiği bir kopya varsa
- * istek yolunu ona çevirir ve doğru `Content-Type` / `Content-Encoding`
- * başlıklarını kendisi kurar. Böylece hash'li varlıklar istek başına yeniden
- * sıkıştırılmaz ve build'deki kalite 11 brotli kullanılır.
- *
- * Kopya yoksa istek olduğu gibi `express.static`e devredilir.
- */
-import fs from "node:fs";
-import path from "node:path";
-import { negotiateEncoding } from "./compression.js";
-import { IMMUTABLE_CACHE } from "../../config/defaults.js";
-
-/** @type {Record<string, string>} */
-const CONTENT_TYPES = {
-  ".css": "text/css; charset=utf-8",
-  ".js": "text/javascript; charset=utf-8",
-  ".mjs": "text/javascript; charset=utf-8",
-  ".svg": "image/svg+xml",
-  ".json": "application/json; charset=utf-8",
-  ".xml": "application/xml; charset=utf-8",
-  ".txt": "text/plain; charset=utf-8",
-  ".map": "application/json; charset=utf-8",
-};
-
-/**
- * @param {string} publicDir
- * @returns {import('express').RequestHandler}
- */
-export function staticPrecompressed(publicDir) {
-  const root = path.resolve(publicDir);
-
-  return (req, res, next) => {
-    if (req.method !== "GET" && req.method !== "HEAD") {
-      next();
-      return;
-    }
-
-    const type = CONTENT_TYPES[path.extname(req.path).toLowerCase()];
-    if (!type) {
-      next();
-      return;
-    }
-
-    const encoding = negotiateEncoding(req.headers["accept-encoding"]);
-    if (!encoding) {
-      next();
-      return;
-    }
-
-    let decoded;
-    try {
-      decoded = decodeURIComponent(req.path);
-    } catch {
-      next();
-      return;
-    }
-
-    const target = path.resolve(root, `.${decoded}`);
-
-    // Path traversal koruması: çözülen yol public/ dışına çıkamaz.
-    if (target !== root && !target.startsWith(root + path.sep)) {
-      next();
-      return;
-    }
-
-    const file = `${target}${encoding === "br" ? ".br" : ".gz"}`;
-
-    let stat;
-    try {
-      stat = fs.statSync(file);
-    } catch {
-      next();
-      return;
-    }
-
-    if (!stat.isFile()) {
-      next();
-      return;
-    }
-
-    res.setHeader("Content-Type", type);
-    res.setHeader("Content-Encoding", encoding);
-    res.setHeader("Content-Length", String(stat.size));
-    res.setHeader("Vary", "Accept-Encoding");
-
-    if (req.path.startsWith("/assets/")) {
-      res.setHeader("Cache-Control", IMMUTABLE_CACHE);
-    }
-
-    if (req.method === "HEAD") {
-      res.end();
-      return;
-    }
-
-    fs.createReadStream(file).on("error", () => res.end()).pipe(res);
-  };
-}
+/**
+ * Build'de üretilmiş `.br` / `.gz` kopyalarını servis eder.
+ *
+ * `express.static`ten önce çalışır: istemcinin kabul ettiği bir kopya varsa
+ * istek yolunu ona çevirir ve doğru `Content-Type` / `Content-Encoding`
+ * başlıklarını kendisi kurar. Böylece hash'li varlıklar istek başına yeniden
+ * sıkıştırılmaz ve build'deki kalite 11 brotli kullanılır.
+ *
+ * Kopya yoksa istek olduğu gibi `express.static`e devredilir.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { negotiateEncoding } from "./compression.js";
+import { IMMUTABLE_CACHE } from "../../config/defaults.js";
+
+/** @type {Record<string, string>} */
+const CONTENT_TYPES = {
+  ".css": "text/css; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".mjs": "text/javascript; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".json": "application/json; charset=utf-8",
+  ".xml": "application/xml; charset=utf-8",
+  ".txt": "text/plain; charset=utf-8",
+  ".map": "application/json; charset=utf-8",
+};
+
+/**
+ * @param {string} publicDir
+ * @returns {import('express').RequestHandler}
+ */
+export function staticPrecompressed(publicDir) {
+  const root = path.resolve(publicDir);
+
+  return (req, res, next) => {
+    if (req.method !== "GET" && req.method !== "HEAD") {
+      next();
+      return;
+    }
+
+    const type = CONTENT_TYPES[path.extname(req.path).toLowerCase()];
+    if (!type) {
+      next();
+      return;
+    }
+
+    const encoding = negotiateEncoding(req.headers["accept-encoding"]);
+    if (!encoding) {
+      next();
+      return;
+    }
+
+    let decoded;
+    try {
+      decoded = decodeURIComponent(req.path);
+    } catch {
+      next();
+      return;
+    }
+
+    const target = path.resolve(root, `.${decoded}`);
+
+    // Path traversal koruması: çözülen yol public/ dışına çıkamaz.
+    if (target !== root && !target.startsWith(root + path.sep)) {
+      next();
+      return;
+    }
+
+    const file = `${target}${encoding === "br" ? ".br" : ".gz"}`;
+
+    let stat;
+    try {
+      stat = fs.statSync(file);
+    } catch {
+      next();
+      return;
+    }
+
+    if (!stat.isFile()) {
+      next();
+      return;
+    }
+
+    res.setHeader("Content-Type", type);
+    res.setHeader("Content-Encoding", encoding);
+    res.setHeader("Content-Length", String(stat.size));
+    res.setHeader("Vary", "Accept-Encoding");
+
+    if (req.path.startsWith("/assets/")) {
+      res.setHeader("Cache-Control", IMMUTABLE_CACHE);
+    }
+
+    if (req.method === "HEAD") {
+      res.end();
+      return;
+    }
+
+    fs.createReadStream(file).on("error", () => res.end()).pipe(res);
+  };
+}

package/src/server/middleware/trailing-slash.js

@@ -0,0 +1,53 @@
+/**
+ * `jskelet.config.mjs` → `trailingSlash` uygulayıcısı.
+ *
+ * Açıkken kanonik URL `/` ile biter: `/hakkinda/` 200 döner, slash'sız
+ * istek 308 ile slash'lıya gider. 301 değil 308 — framework'ün diğer kalıcı
+ * yönlendirmeleri gibi metodu korur ve eski istemcilerin POST'u GET'e
+ * çevirmesini engeller.
+ *
+ * Kapalıyken (varsayılan) hiçbir şey yapmaz: mevcut sitelerin `/x` ve `/x/`
+ * biçimlerini kırmaz.
+ *
+ * İstisnalar Next ile aynı: uzantılı dosya yolları ve `/.well-known/`.
+ * Kök `/` zaten slash ile biter.
+ */
+import { getConfig } from "../../config/index.js";
+
+/**
+ * Bu yola trailing slash dayatılmamalı mı.
+ *
+ * @param {string} pathname
+ * @returns {boolean}
+ */
+export function skipTrailingSlash(pathname) {
+  if (!pathname || pathname === "/") return true;
+  if (pathname.startsWith("/.well-known")) return true;
+
+  // Son segmentte nokta varsa statik dosya sayılır (`/a.b/c` değil,
+  // `/foto.png` ve `/assets/app.js` gibi).
+  const lastSlash = pathname.lastIndexOf("/");
+  const lastSegment = pathname.slice(lastSlash + 1);
+  return lastSegment.includes(".");
+}
+
+/**
+ * @returns {import('express').RequestHandler}
+ */
+export function trailingSlash() {
+  if (!getConfig().trailingSlash) {
+    return (_req, _res, next) => next();
+  }
+
+  return (req, res, next) => {
+    const pathname = req.path ?? "";
+    if (pathname.endsWith("/") || skipTrailingSlash(pathname)) {
+      next();
+      return;
+    }
+
+    // Query string `originalUrl`'den: `req.path` onu düşürür.
+    const query = req.originalUrl.slice(pathname.length);
+    res.redirect(308, `${pathname}/${query}`);
+  };
+}

package/src/server/middleware/upstream-proxy.js

@@ -1,141 +1,141 @@
-/**
- * `jskelet.config.mjs` → `rewrites()` uygulayıcısı ve yeniden kullanılabilir
- * reverse proxy.
- *
- * Harici paket yok; native `fetch` ile stream eden ince bir proxy. `duplex:
- * "half"` gövdeli isteklerde şart, `redirect: "manual"` olmadan upstream'in
- * 302'si burada tüketilir ve tarayıcı hiç görmez.
- *
- * Tipik kullanım: `/api/*` yolunu backend'e taşımak. Bunu tarayıcı
- * same-origin çağırdığı için CORS ve third-party cookie sorunları oluşmaz.
- */
-import { Readable } from "node:stream";
-import { getConfig } from "../../config/index.js";
-import { fillDestination, matchPattern } from "../../config/pattern.js";
-
-/** Hop-by-hop header'lar proxy edilmez. */
-const STRIPPED_REQUEST_HEADERS = new Set([
-  "host",
-  "connection",
-  "content-length",
-  "accept-encoding",
-]);
-
-const STRIPPED_RESPONSE_HEADERS = new Set([
-  "content-encoding",
-  "content-length",
-  "transfer-encoding",
-  "connection",
-]);
-
-/**
- * Rewrite hedefini istek nesnesinde taşımak için; string bir alan adı
- * uygulamanın kendi alanlarıyla çakışabilir.
- */
-const REWRITE_TARGET = Symbol("jskelet.rewriteTarget");
-
-/**
- * @param {import('express').Request} req
- * @returns {Record<string, string>}
- */
-function forwardHeaders(req) {
-  /** @type {Record<string, string>} */
-  const out = {};
-  for (const [key, value] of Object.entries(req.headers)) {
-    if (STRIPPED_REQUEST_HEADERS.has(key)) continue;
-    if (value === undefined) continue;
-    out[key] = Array.isArray(value) ? value.join(", ") : String(value);
-  }
-  return out;
-}
-
-/**
- * Hedefi isteğe göre hesaplayan proxy üretir. `resolveTarget` fırlatırsa
- * istek proxy'lenmez ve zincire devam eder — hedef origin yapılandırılmamış
- * bir kurulumda 500 yerine normal 404 almak daha doğru.
- *
- * @param {(req: import('express').Request) => string} resolveTarget
- * @returns {import('express').RequestHandler}
- */
-export function createProxy(resolveTarget) {
-  return async (req, res, next) => {
-    let target;
-    try {
-      target = resolveTarget(req);
-    } catch {
-      next();
-      return;
-    }
-
-    if (!target) {
-      next();
-      return;
-    }
-
-    const hasBody = req.method !== "GET" && req.method !== "HEAD";
-
-    try {
-      const upstream = await fetch(target, {
-        method: req.method,
-        headers: forwardHeaders(req),
-        body: hasBody ? Readable.toWeb(req) : undefined,
-        duplex: hasBody ? "half" : undefined,
-        redirect: "manual",
-      });
-
-      res.status(upstream.status);
-      upstream.headers.forEach((value, key) => {
-        if (STRIPPED_RESPONSE_HEADERS.has(key.toLowerCase())) return;
-        res.setHeader(key, value);
-      });
-
-      if (!upstream.body) {
-        res.end();
-        return;
-      }
-
-      Readable.fromWeb(upstream.body).pipe(res);
-    } catch (error) {
-      next(error);
-    }
-  };
-}
-
-/**
- * Config'teki `rewrites()` kuralları.
- *
- * Hedef mutlaksa (http/https) istek proxy ile dışa taşınır; göreliyse
- * yalnızca `req.url` değiştirilir ve istek kendi route tablosunda devam eder.
- * İki faz var: `beforeFiles` statik dosyalardan önce, `afterFiles` statik
- * denendikten sonra sayfalardan önce.
- *
- * @param {"beforeFiles" | "afterFiles"} phase
- * @returns {import('express').RequestHandler}
- */
-export function configRewrites(phase) {
-  const rules = getConfig().rewrites.filter((rule) => rule.phase === phase);
-  if (!rules.length) return (req, res, next) => next();
-
-  const proxy = createProxy((req) => req[REWRITE_TARGET]);
-
-  return (req, res, next) => {
-    for (const rule of rules) {
-      const params = matchPattern(rule.pattern, req.path);
-      if (!params) continue;
-
-      const query = req.originalUrl.slice(req.path.length);
-      const destination = fillDestination(rule.destination, params);
-
-      if (/^https?:\/\//.test(destination)) {
-        req[REWRITE_TARGET] = `${destination}${query}`;
-        proxy(req, res, next);
-        return;
-      }
-
-      req.url = `${destination}${query}`;
-      break;
-    }
-
-    next();
-  };
-}
+/**
+ * `jskelet.config.mjs` → `rewrites()` uygulayıcısı ve yeniden kullanılabilir
+ * reverse proxy.
+ *
+ * Harici paket yok; native `fetch` ile stream eden ince bir proxy. `duplex:
+ * "half"` gövdeli isteklerde şart, `redirect: "manual"` olmadan upstream'in
+ * 302'si burada tüketilir ve tarayıcı hiç görmez.
+ *
+ * Tipik kullanım: `/api/*` yolunu backend'e taşımak. Bunu tarayıcı
+ * same-origin çağırdığı için CORS ve third-party cookie sorunları oluşmaz.
+ */
+import { Readable } from "node:stream";
+import { getConfig } from "../../config/index.js";
+import { fillDestination, matchPattern } from "../../config/pattern.js";
+
+/** Hop-by-hop header'lar proxy edilmez. */
+const STRIPPED_REQUEST_HEADERS = new Set([
+  "host",
+  "connection",
+  "content-length",
+  "accept-encoding",
+]);
+
+const STRIPPED_RESPONSE_HEADERS = new Set([
+  "content-encoding",
+  "content-length",
+  "transfer-encoding",
+  "connection",
+]);
+
+/**
+ * Rewrite hedefini istek nesnesinde taşımak için; string bir alan adı
+ * uygulamanın kendi alanlarıyla çakışabilir.
+ */
+const REWRITE_TARGET = Symbol("jskelet.rewriteTarget");
+
+/**
+ * @param {import('express').Request} req
+ * @returns {Record<string, string>}
+ */
+function forwardHeaders(req) {
+  /** @type {Record<string, string>} */
+  const out = {};
+  for (const [key, value] of Object.entries(req.headers)) {
+    if (STRIPPED_REQUEST_HEADERS.has(key)) continue;
+    if (value === undefined) continue;
+    out[key] = Array.isArray(value) ? value.join(", ") : String(value);
+  }
+  return out;
+}
+
+/**
+ * Hedefi isteğe göre hesaplayan proxy üretir. `resolveTarget` fırlatırsa
+ * istek proxy'lenmez ve zincire devam eder — hedef origin yapılandırılmamış
+ * bir kurulumda 500 yerine normal 404 almak daha doğru.
+ *
+ * @param {(req: import('express').Request) => string} resolveTarget
+ * @returns {import('express').RequestHandler}
+ */
+export function createProxy(resolveTarget) {
+  return async (req, res, next) => {
+    let target;
+    try {
+      target = resolveTarget(req);
+    } catch {
+      next();
+      return;
+    }
+
+    if (!target) {
+      next();
+      return;
+    }
+
+    const hasBody = req.method !== "GET" && req.method !== "HEAD";
+
+    try {
+      const upstream = await fetch(target, {
+        method: req.method,
+        headers: forwardHeaders(req),
+        body: hasBody ? Readable.toWeb(req) : undefined,
+        duplex: hasBody ? "half" : undefined,
+        redirect: "manual",
+      });
+
+      res.status(upstream.status);
+      upstream.headers.forEach((value, key) => {
+        if (STRIPPED_RESPONSE_HEADERS.has(key.toLowerCase())) return;
+        res.setHeader(key, value);
+      });
+
+      if (!upstream.body) {
+        res.end();
+        return;
+      }
+
+      Readable.fromWeb(upstream.body).pipe(res);
+    } catch (error) {
+      next(error);
+    }
+  };
+}
+
+/**
+ * Config'teki `rewrites()` kuralları.
+ *
+ * Hedef mutlaksa (http/https) istek proxy ile dışa taşınır; göreliyse
+ * yalnızca `req.url` değiştirilir ve istek kendi route tablosunda devam eder.
+ * İki faz var: `beforeFiles` statik dosyalardan önce, `afterFiles` statik
+ * denendikten sonra sayfalardan önce.
+ *
+ * @param {"beforeFiles" | "afterFiles"} phase
+ * @returns {import('express').RequestHandler}
+ */
+export function configRewrites(phase) {
+  const rules = getConfig().rewrites.filter((rule) => rule.phase === phase);
+  if (!rules.length) return (req, res, next) => next();
+
+  const proxy = createProxy((req) => req[REWRITE_TARGET]);
+
+  return (req, res, next) => {
+    for (const rule of rules) {
+      const params = matchPattern(rule.pattern, req.path);
+      if (!params) continue;
+
+      const query = req.originalUrl.slice(req.path.length);
+      const destination = fillDestination(rule.destination, params);
+
+      if (/^https?:\/\//.test(destination)) {
+        req[REWRITE_TARGET] = `${destination}${query}`;
+        proxy(req, res, next);
+        return;
+      }
+
+      req.url = `${destination}${query}`;
+      break;
+    }
+
+    next();
+  };
+}