jskelet 0.2.4 → 0.3.0

package/src/server/create-app.js

@@ -7,11 +7,13 @@
  *   1. rewrites(beforeFiles) — statik dosyalardan da önce çalışmalı, yoksa
  *      `/assets/x.js` yolunu başka bir yere taşıyan kural işlemez.
  *   2. compression — static'ten önce; sonra gelirse statik dosyalar sıkışmaz.
- *   3. headers → devGate → redirects — gate'in 404'ü redirect'ten önce.
+ *   3. headers → devGate → redirects → trailingSlash — gate'in 404'ü
+ *      redirect'ten önce; trailingSlash config redirects'ten sonra, böylece
+ *      açık kurallar istenen yolu önce görür.
  *   4. staticPrecompressed → express.static — build'de üretilmiş `.br`/`.gz`
  *      kopyalar varsa onlar servis edilir (kalite 11), yoksa istek altındaki
  *      static'e düşer ve middleware anında sıkıştırır (kalite 5).
- *   4b. cache paneli (açıksa) — statikten sonra, route'lardan önce: kendi
+ *   4b. admin paneli (açıksa) — statikten sonra, route'lardan önce: kendi
  *      gövde ayrıştırıcısını taşır ve uygulama yolunu gölgeleyemez.
  *   5. body parser'lar — statikten sonra: görsel isteklerinde gövde ayrıştırma
  *      maliyeti ödenmesin.
@@ -29,6 +31,7 @@ import { csrf } from "./middleware/csrf.js";
 import { staticPrecompressed } from "./middleware/static-precompressed.js";
 import { devGate } from "./middleware/dev-gate.js";
 import { redirects } from "./middleware/redirects.js";
+import { trailingSlash } from "./middleware/trailing-slash.js";
 import { configRewrites } from "./middleware/upstream-proxy.js";
 import { getConfig, loadConfig } from "../config/index.js";
 import { IMMUTABLE_CACHE } from "../config/defaults.js";
@@ -85,6 +88,7 @@ export async function createApp(options = {}) {
   app.use(headersMiddleware());
   app.use(devGate());
   app.use(redirects());
+  app.use(trailingSlash());
 
   app.use(staticPrecompressed(config.dirs.public));
   app.use(
@@ -110,13 +114,13 @@ export async function createApp(options = {}) {
     mountDevtools(app);
   }
 
-  // Önbellek paneli ortama bakmaz, config'e bakar: açıkça etkinleştirilmedikçe
+  // Yönetim paneli ortama bakmaz, config'e bakar: açıkça etkinleştirilmedikçe
   // modül hiç yüklenmez ve yol da yoktur. Kendi gövde ayrıştırıcısını
   // taşıdığı için aşağıdaki parser'lardan önce durabiliyor; route'lardan
   // önce olması gerekiyor ki uygulama aynı yolu gölgeleyemesin.
-  if (config.cachePanel.enabled) {
-    const { mountCachePanel } = await import("./cache-panel.js");
-    mountCachePanel(app);
+  if (config.admin.enabled) {
+    const { mountAdmin } = await import("./admin/mount.js");
+    mountAdmin(app);
   }
 
   app.use(express.urlencoded({ extended: false, limit: "64kb" }));

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/client/cache-panel/panel.html

@@ -1,308 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <meta name="robots" content="noindex, nofollow, noarchive, nosnippet" />
-    <meta name="referrer" content="no-referrer" />
-    <title>Cache · JSkelet</title>
-    <link rel="icon" href="logo.png" />
-    <link rel="stylesheet" href="panel.css" />
-  </head>
-  <body>
-    <header>
-      <div class="brand">
-        <img src="logo.png" alt="" width="30" height="30" />
-        <span class="wordmark">JSkelet</span>
-        <span class="badge" id="version">—</span>
-      </div>
-
-      <nav class="crumbs" aria-label="Panel">
-        <span aria-current="page" data-i18n="nav.cache">Cache</span>
-      </nav>
-
-      <span class="spacer"></span>
-
-      <span class="chip" id="env">—</span>
-      <span class="chip" id="pid">—</span>
-      <span class="chip" id="uptime">—</span>
-      <span class="chip" id="memory">—</span>
-
-      <span id="language"></span>
-
-      <label class="check">
-        <input type="checkbox" id="auto" checked />
-        <span data-i18n="shell.live">live</span>
-      </label>
-      <button id="refresh" data-i18n="shell.refresh">Refresh</button>
-      <button id="logout" data-i18n="shell.signOut">Sign out</button>
-    </header>
-
-    <main>
-      <div class="cards">
-        <div class="card">
-          <div class="label" data-i18n="card.htmlEntries">HTML entries</div>
-          <div class="value" id="html-size">—</div>
-          <div class="sub" id="html-sub">—</div>
-        </div>
-        <div class="card">
-          <div class="label" data-i18n="card.htmlMemory">HTML in memory</div>
-          <div class="value" id="html-bytes">—</div>
-          <div class="sub" id="html-stale">—</div>
-        </div>
-        <div class="card">
-          <div class="label" data-i18n="card.dataEntries">Data entries</div>
-          <div class="value" id="data-size">—</div>
-          <div class="sub" id="data-sub">—</div>
-        </div>
-        <div class="card">
-          <div class="label" data-i18n="card.sharedTier">Shared tier</div>
-          <div class="value" id="redis-state">—</div>
-          <div class="sub" id="redis-sub">—</div>
-        </div>
-        <div class="card">
-          <div class="label" data-i18n="card.prewarm">Prewarm</div>
-          <div class="value" id="prewarm-state">—</div>
-          <div class="sub" id="prewarm-sub">—</div>
-        </div>
-      </div>
-
-      <section>
-        <h2>
-          <span data-i18n="redis.section">Shared tier</span>
-          <span class="count" id="redis-heading">—</span>
-        </h2>
-        <div class="body">
-          <dl class="kv" id="redis-kv"></dl>
-
-          <div class="row" id="redis-actions" hidden>
-            <button id="redis-inspect" data-i18n="redis.inspect">Count keys in Redis</button>
-            <button class="danger" id="redis-html" data-i18n="redis.dropHtml">
-              Drop shared HTML keys
-            </button>
-            <button class="danger" id="redis-data" data-i18n="redis.dropData">
-              Drop shared data keys
-            </button>
-          </div>
-
-          <div class="suggest" id="redis-suggest" hidden>
-            <p class="m0">
-              <strong data-i18n="redis.suggest.title">No shared tier.</strong>
-              <span data-i18n="redis.suggest.body"></span>
-            </p>
-            <pre><code>npm install ioredis</code></pre>
-            <pre><code>// jskelet.config.mjs
-cache() {
-  return {
-    redis: { enabled: true, url: process.env.REDIS_URL },
-  };
-}</code></pre>
-            <p class="hint m0" data-i18n="redis.suggest.hint"></p>
-          </div>
-        </div>
-      </section>
-
-      <section>
-        <h2>
-          <span data-i18n="cf.section">Cloudflare</span>
-          <span class="count" id="cf-heading">—</span>
-          <span class="tabs">
-            <button id="cf-refresh" data-i18n="cf.refresh">Refresh</button>
-          </span>
-        </h2>
-        <div class="body">
-          <dl class="kv" id="cf-kv"></dl>
-
-          <div id="cf-tools" hidden>
-            <div class="row">
-              <button class="danger" id="cf-purge-all" data-i18n="cf.purgeAll">
-                Purge everything
-              </button>
-              <button id="cf-purge-cached" data-i18n="cf.purgeCached">
-                Purge URLs cached here
-              </button>
-              <label class="check">
-                <input type="checkbox" id="cf-dev" />
-                <span data-i18n="cf.devMode"></span>
-              </label>
-            </div>
-
-            <div class="row">
-              <select id="cf-kind">
-                <option value="prefixes" data-i18n="cf.kind.prefixes">prefixes</option>
-                <option value="hosts" data-i18n="cf.kind.hosts">hosts</option>
-                <option value="tags" data-i18n="cf.kind.tags">cache tags</option>
-              </select>
-              <input
-                class="grow"
-                type="text"
-                id="cf-values"
-                spellcheck="false"
-                data-i18n-ph="cf.values.placeholder"
-              />
-              <button class="primary" id="cf-purge-keys" data-i18n="cf.purge">Purge</button>
-            </div>
-
-            <div class="row">
-              <button id="cf-tiered" data-i18n="cf.toggleTiered">Toggle Tiered Cache</button>
-              <button id="cf-reserve" data-i18n="cf.toggleReserve">Toggle Cache Reserve</button>
-              <button class="danger" id="cf-reserve-clear" data-i18n="cf.clearReserve">
-                Clear Cache Reserve
-              </button>
-            </div>
-
-            <div class="row">
-              <input
-                class="grow"
-                type="text"
-                id="cf-path"
-                spellcheck="false"
-                data-i18n-ph="cf.path.placeholder"
-              />
-              <button id="cf-analytics" data-i18n="cf.queryAnalytics">Query analytics</button>
-            </div>
-
-            <div id="cf-report" class="report" hidden></div>
-
-            <p class="hint" data-i18n="cf.edgeHint"></p>
-          </div>
-
-          <div class="suggest" id="cf-suggest" hidden>
-            <p class="m0">
-              <strong data-i18n="cf.suggest.title">Cloudflare is not connected.</strong>
-              <span data-i18n="cf.suggest.body"></span>
-            </p>
-            <pre><code>JSKELET_CLOUDFLARE_KEY=your_api_token
-JSKELET_CLOUDFLARE_ZONE_ID=your_zone_id</code></pre>
-            <p class="hint m0" data-i18n-html="cf.suggest.hint"></p>
-          </div>
-        </div>
-      </section>
-
-      <section>
-        <h2>
-          <span data-i18n="host.section">Host</span>
-          <span class="count" id="host-heading">—</span>
-        </h2>
-        <div class="body">
-          <div class="meter">
-            <div class="meter-head">
-              <span data-i18n="host.memory">Memory</span>
-              <span class="mono" id="ram-text">—</span>
-            </div>
-            <div class="bar"><span id="ram-bar"></span></div>
-            <p class="hint m0" id="ram-note">—</p>
-          </div>
-
-          <div class="meter">
-            <div class="meter-head">
-              <span data-i18n="host.disk">Disk</span>
-              <span class="mono" id="disk-text">—</span>
-            </div>
-            <div class="bar"><span id="disk-bar"></span></div>
-            <p class="hint m0" id="disk-note">—</p>
-          </div>
-        </div>
-      </section>
-
-      <section>
-        <h2><span data-i18n="actions.section">Actions</span></h2>
-        <div class="body">
-          <div class="row">
-            <input
-              class="grow"
-              type="text"
-              id="target"
-              spellcheck="false"
-              data-i18n-ph="actions.target.placeholder"
-            />
-            <label class="check">
-              <input type="checkbox" id="hard" />
-              <span data-i18n="actions.hard"></span>
-            </label>
-            <button class="primary" id="invalidate" data-i18n="actions.invalidate">
-              Invalidate
-            </button>
-          </div>
-
-          <div class="row">
-            <input
-              class="grow"
-              type="text"
-              id="prefix"
-              spellcheck="false"
-              data-i18n-ph="actions.prefix.placeholder"
-            />
-            <button class="danger" id="clear-data" data-i18n="actions.clearData">
-              Clear data cache
-            </button>
-            <button class="danger" id="clear-html" data-i18n="actions.clearHtml">
-              Clear HTML cache
-            </button>
-          </div>
-
-          <div class="row">
-            <button id="prewarm" data-i18n="actions.prewarm">Prewarm all paths</button>
-          </div>
-
-          <p class="hint" data-i18n="actions.hint"></p>
-        </div>
-      </section>
-
-      <section>
-        <h2>
-          <span data-i18n="entries.section">Entries</span>
-          <span class="count" id="listed">—</span>
-          <span class="tabs" role="tablist">
-            <button id="tab-html" role="tab" aria-selected="true">HTML</button>
-            <button id="tab-data" role="tab" aria-selected="false" data-i18n="tab.data">
-              Data
-            </button>
-          </span>
-        </h2>
-        <div class="body">
-          <div class="row">
-            <input
-              class="grow"
-              type="search"
-              id="search"
-              spellcheck="false"
-              data-i18n-ph="entries.search"
-            />
-          </div>
-        </div>
-        <div class="scroll">
-          <table>
-            <thead id="thead"></thead>
-            <tbody id="tbody"></tbody>
-          </table>
-          <div class="empty" id="empty" data-i18n="entries.empty" hidden>No entries.</div>
-        </div>
-      </section>
-    </main>
-
-    <footer>
-      <div class="foot-brand">
-        <img src="logo.png" alt="" width="24" height="24" />
-        <span class="wordmark">JSkelet</span>
-        <span class="mono" id="foot-release">—</span>
-      </div>
-
-      <div class="foot-links">
-        <a id="foot-repo" href="https://github.com/ayberkenis/jskelet" rel="noreferrer noopener">
-          GitHub
-        </a>
-        <span class="dot" aria-hidden="true">·</span>
-        <span data-i18n="footer.panel">Cache panel</span>
-        <span class="dot" aria-hidden="true">·</span>
-        <span class="live">
-          <span class="pulse"></span>
-          <span data-i18n="footer.rotates">Password rotates on restart</span>
-        </span>
-      </div>
-    </footer>
-
-    <div id="toast"></div>
-    <script type="module" src="panel.js"></script>
-  </body>
-</html>