jskelet 0.2.5 → 0.3.0

package/src/config/index.js

@@ -17,8 +17,8 @@
  *   rewrites()  → [{ source, destination }] | { beforeFiles?, afterFiles? }
  *   cache()     → { html?: { [source]: saniye },
  *                   query?: { [source]: string[] | true }, maxEntries?: number,
- *                   data?: {...}, redis?: {...}, prewarm?: {...},
- *                   panel?: {...} }
+ *                   data?: {...}, redis?: {...}, prewarm?: {...} }
+ *   admin()     → { enabled?, basePath?, allowIps?, blockBots?, … }
  *
  * Fonksiyon olmayan bölümler (`brand`, `security`, `static`, `navigation`…)
  * düz nesne olarak okunur.
@@ -29,8 +29,8 @@ import process from "node:process";
 import { pathToFileURL } from "node:url";
 import { compilePattern, matchPattern } from "./pattern.js";
 import {
+  DEFAULT_ADMIN,
   DEFAULT_BRAND,
-  DEFAULT_CACHE_PANEL,
   DEFAULT_CLOUDFLARE,
   DEFAULT_DATA_CACHE,
   DEFAULT_DEV_GATE_BYPASS,
@@ -96,7 +96,7 @@ const CONFIG_FILE = "jskelet.config.mjs";
  * @property {{ attempts: number, delayMs: number }} transientRetry
  * @property {RedisConfig} redis Opsiyonel Redis ikinci kademesi.
  * @property {typeof DEFAULT_UPSTREAM_LIMIT} upstream Upstream hız freni.
- * @property {typeof DEFAULT_CACHE_PANEL} cachePanel Önbellek yönetim paneli.
+ * @property {typeof DEFAULT_ADMIN} admin Framework yönetim paneli.
  * @property {typeof DEFAULT_CLOUDFLARE} cloudflare Cloudflare cache yüzeyi.
  * @property {Record<string, unknown>} prewarm
  * @property {{ source: string, test: (pathname: string) => boolean }[]} prewarmPriority
@@ -104,6 +104,7 @@ const CONFIG_FILE = "jskelet.config.mjs";
  * @property {Record<string, Function>} hooks
  * @property {string} layout Layout `.ejs` dosyasının mutlak yolu.
  * @property {string[] | null} routes Açık route modülü listesi.
+ * @property {boolean} trailingSlash URL'ler `/` ile bitsin mi (Next `trailingSlash`).
  * @property {{ extensions: Set<string>, prefixes: string[] }} static
  * @property {string[]} devGateBypass
  * @property {string[]} preconnect
@@ -301,46 +302,58 @@ function normalizeUpstream(raw) {
 }
 
 /**
- * Önbellek panelinin bölümü.
- *
- * `enabled` yalnızca açıkça `true` verildiğinde ya da `JSKELET_CACHE_PANEL`
- * ortam değişkeni ayarlandığında açılır: paneli yanlışlıkla açmanın bedeli,
- * önbelleği boşaltabilen bir ucu internete koymak.
+ * Yönetim paneli. `enabled` yalnızca açıkça `true` verildiğinde ya da
+ * `JSKELET_ADMIN` ortam değişkeni ayarlandığında açılır: paneli yanlışlıkla
+ * açmanın bedeli, önbelleği boşaltabilen bir ucu internete koymak.
  *
  * Ortam değişkeni config'in **üstünde** duruyor, çünkü paneli genelde bir
  * arıza sırasında tek seferlik açmak isteniyor ve o an config dosyasını
- * değiştirip yeniden dağıtmak istenmiyor. `JSKELET_CACHE_PANEL=0` aynı
- * mantıkla config'te açık olan paneli kapatır.
+ * değiştirip yeniden dağıtmak istenmiyor. `JSKELET_ADMIN=0` aynı mantıkla
+ * config'te açık olan paneli kapatır.
  *
  * @param {unknown} raw
- * @returns {typeof DEFAULT_CACHE_PANEL}
+ * @returns {typeof DEFAULT_ADMIN}
  */
-function normalizeCachePanel(raw) {
+function normalizeAdmin(raw) {
   const source = /** @type {Record<string, any>} */ (raw ?? {});
-  const env = process.env.JSKELET_CACHE_PANEL;
+  const env = process.env.JSKELET_ADMIN;
 
   const basePath =
     typeof source.basePath === "string" && source.basePath.startsWith("/")
       ? source.basePath.replace(/\/+$/, "")
-      : DEFAULT_CACHE_PANEL.basePath;
+      : DEFAULT_ADMIN.basePath;
 
   /** @param {string} key @param {number} min */
   const positive = (key, min) => {
     const value = Number(source[key]);
     return Number.isFinite(value) && value >= min
       ? value
-      : /** @type {any} */ (DEFAULT_CACHE_PANEL)[key];
+      : /** @type {any} */ (DEFAULT_ADMIN)[key];
   };
 
+  const allowIps = Array.isArray(source.allowIps)
+    ? source.allowIps
+        .filter((entry) => typeof entry === "string" && entry.trim())
+        .map((entry) => entry.trim())
+    : [...DEFAULT_ADMIN.allowIps];
+
+  const logSize = Number(source.logSize);
+
   return {
     enabled:
       env === undefined
         ? source.enabled === true
         : env !== "0" && env !== "false" && env !== "",
-    basePath: basePath || DEFAULT_CACHE_PANEL.basePath,
+    basePath: basePath || DEFAULT_ADMIN.basePath,
+    allowIps,
+    blockBots: source.blockBots !== false,
     banAttempts: Math.floor(positive("banAttempts", 1)),
     banHours: positive("banHours", 0),
     sessionHours: positive("sessionHours", 0),
+    logSize:
+      Number.isFinite(logSize) && logSize >= 50
+        ? Math.min(5000, Math.floor(logSize))
+        : DEFAULT_ADMIN.logSize,
   };
 }
 
@@ -423,7 +436,6 @@ function normalizeQueryRules(raw) {
  *   transientRetry: { attempts: number, delayMs: number },
  *   redis: RedisConfig,
  *   upstream: typeof DEFAULT_UPSTREAM_LIMIT,
- *   cachePanel: typeof DEFAULT_CACHE_PANEL,
  *   cloudflare: typeof DEFAULT_CLOUDFLARE,
  *   prewarm: Record<string, unknown>,
  *   prewarmPriority: ResolvedConfig["prewarmPriority"] }}
@@ -464,7 +476,6 @@ function normalizeCache(raw) {
         : { ...DEFAULT_TRANSIENT_RETRY, ...(raw?.transientRetry ?? {}) },
     redis: normalizeRedis(raw?.redis),
     upstream: normalizeUpstream(raw?.upstream),
-    cachePanel: normalizeCachePanel(raw?.panel),
     cloudflare: normalizeCloudflare(raw?.cloudflare),
     // Desenler derlenmiş hâlde ayrı alanda tutulur: `prewarm` sayısal
     // ayarların düz torbası olarak kalsın, her turda yeniden derlenmesin.
@@ -669,11 +680,12 @@ export async function loadConfig(options = {}) {
     }
   };
 
-  const [headers, redirects, rewrites, cache] = await Promise.all([
+  const [headers, redirects, rewrites, cache, admin] = await Promise.all([
     section("headers"),
     section("redirects"),
     section("rewrites"),
     section("cache"),
+    section("admin"),
   ]);
 
   const {
@@ -686,7 +698,6 @@ export async function loadConfig(options = {}) {
     transientRetry,
     redis,
     upstream,
-    cachePanel,
     cloudflare,
     prewarm,
     prewarmPriority,
@@ -710,7 +721,7 @@ export async function loadConfig(options = {}) {
     transientRetry,
     redis,
     upstream,
-    cachePanel,
+    admin: normalizeAdmin(admin),
     cloudflare,
     prewarm,
     prewarmPriority,
@@ -718,6 +729,11 @@ export async function loadConfig(options = {}) {
     hooks: source.hooks ?? {},
     layout: resolveLayout(dirs, source.layout),
     routes: Array.isArray(source.routes) ? source.routes : null,
+    // Varsayılan kapalı: açıkken `/hakkinda` → 308 `/hakkinda/` ve kanonik
+    // yanıt 200'dir. Kapalıyken slash dayatılmaz — Express'in non-strict
+    // eşleşmesi her iki biçimi de 200 ile servis eder (Next'in varsayılan
+    // "slash'ı kırp" davranışından bilinçli fark).
+    trailingSlash: source.trailingSlash === true,
     static: {
       extensions: new Set(source.static?.extensions ?? DEFAULT_STATIC.extensions),
       prefixes: source.static?.prefixes ?? DEFAULT_STATIC.prefixes,

package/src/config/pattern.js

@@ -1,107 +1,107 @@
-/**
- * `next.config` `source`/`destination` sözdiziminin küçük bir derleyicisi.
- *
- * Desteklenen biçimler:
- *   `/haber/:slug`      → tek segment yakalar
- *   `/:path*`           → sıfır veya daha fazla segment yakalar
- *   `/:path*.svg`       → joker + sabit son ek (uzantı kuralları böyle yazılır)
- *   `/etiket-:slug`     → segment ortasında parametre
- *
- * Yakalanan değerler `destination` içindeki aynı adlı `:param`'lara yazılır.
- * Next'in tam `path-to-regexp` yüzeyi değil; config'te fiilen kullanılan alt
- * küme bilinçli olarak seçildi ve tanınmayan bir sözdizimi sessizce literal
- * kabul edilmez, uyarı üretir.
- */
-
-/** @typedef {{ regex: RegExp, keys: string[], source: string }} CompiledPattern */
-
-const PARAM = /^:([A-Za-z_][A-Za-z0-9_]*)(\*)?/;
-
-/** @param {string} text */
-function escapeLiteral(text) {
-  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-/**
- * @param {string} source
- * @returns {CompiledPattern | null}
- */
-export function compilePattern(source) {
-  if (typeof source !== "string" || !source.startsWith("/")) {
-    console.warn(`[config] invalid source (must start with \`/\`): ${source}`);
-    return null;
-  }
-
-  /** @type {string[]} */
-  const keys = [];
-  let pattern = "";
-  let index = 0;
-
-  while (index < source.length) {
-    const char = source[index];
-
-    if (char !== ":") {
-      pattern += escapeLiteral(char);
-      index += 1;
-      continue;
-    }
-
-    const match = source.slice(index).match(PARAM);
-    if (!match) {
-      pattern += escapeLiteral(char);
-      index += 1;
-      continue;
-    }
-
-    const [raw, name, wildcard] = match;
-    keys.push(name);
-
-    if (!wildcard) {
-      // Tek segmentli parametre segment sınırını aşmaz.
-      pattern += "([^/]+)";
-      index += raw.length;
-      continue;
-    }
-
-    // Joker parametre segment sınırlarını aşar ve **sıfır** segment de
-    // yakalar: `/hesabim/:path*` kuralı `/hesabim`i de kapsamalı, aksi hâlde
-    // bir bölümün tamamını kapatmak isteyen kural kök yolu atlıyor. Bunun için
-    // hemen öncesindeki `/` de opsiyonele alınır.
-    const trailingSlash = pattern.endsWith("/");
-    pattern = trailingSlash ? `${pattern.slice(0, -1)}(?:/(.*))?` : `${pattern}(.*)`;
-    index += raw.length;
-  }
-
-  return { regex: new RegExp(`^${pattern}$`), keys, source };
-}
-
-/**
- * @param {CompiledPattern} compiled
- * @param {string} pathname
- * @returns {Record<string, string> | null}
- */
-export function matchPattern(compiled, pathname) {
-  const match = compiled.regex.exec(pathname);
-  if (!match) return null;
-
-  /** @type {Record<string, string>} */
-  const params = {};
-  compiled.keys.forEach((key, i) => {
-    params[key] = match[i + 1] ?? "";
-  });
-  return params;
-}
-
-/**
- * `destination` içindeki `:param` yer tutucularını doldurur.
- *
- * @param {string} destination
- * @param {Record<string, string>} params
- * @returns {string}
- */
-export function fillDestination(destination, params) {
-  return destination.replace(
-    /:([A-Za-z_][A-Za-z0-9_]*)(\*)?/g,
-    (raw, name) => params[name] ?? raw,
-  );
-}
+/**
+ * `next.config` `source`/`destination` sözdiziminin küçük bir derleyicisi.
+ *
+ * Desteklenen biçimler:
+ *   `/haber/:slug`      → tek segment yakalar
+ *   `/:path*`           → sıfır veya daha fazla segment yakalar
+ *   `/:path*.svg`       → joker + sabit son ek (uzantı kuralları böyle yazılır)
+ *   `/etiket-:slug`     → segment ortasında parametre
+ *
+ * Yakalanan değerler `destination` içindeki aynı adlı `:param`'lara yazılır.
+ * Next'in tam `path-to-regexp` yüzeyi değil; config'te fiilen kullanılan alt
+ * küme bilinçli olarak seçildi ve tanınmayan bir sözdizimi sessizce literal
+ * kabul edilmez, uyarı üretir.
+ */
+
+/** @typedef {{ regex: RegExp, keys: string[], source: string }} CompiledPattern */
+
+const PARAM = /^:([A-Za-z_][A-Za-z0-9_]*)(\*)?/;
+
+/** @param {string} text */
+function escapeLiteral(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+/**
+ * @param {string} source
+ * @returns {CompiledPattern | null}
+ */
+export function compilePattern(source) {
+  if (typeof source !== "string" || !source.startsWith("/")) {
+    console.warn(`[config] invalid source (must start with \`/\`): ${source}`);
+    return null;
+  }
+
+  /** @type {string[]} */
+  const keys = [];
+  let pattern = "";
+  let index = 0;
+
+  while (index < source.length) {
+    const char = source[index];
+
+    if (char !== ":") {
+      pattern += escapeLiteral(char);
+      index += 1;
+      continue;
+    }
+
+    const match = source.slice(index).match(PARAM);
+    if (!match) {
+      pattern += escapeLiteral(char);
+      index += 1;
+      continue;
+    }
+
+    const [raw, name, wildcard] = match;
+    keys.push(name);
+
+    if (!wildcard) {
+      // Tek segmentli parametre segment sınırını aşmaz.
+      pattern += "([^/]+)";
+      index += raw.length;
+      continue;
+    }
+
+    // Joker parametre segment sınırlarını aşar ve **sıfır** segment de
+    // yakalar: `/hesabim/:path*` kuralı `/hesabim`i de kapsamalı, aksi hâlde
+    // bir bölümün tamamını kapatmak isteyen kural kök yolu atlıyor. Bunun için
+    // hemen öncesindeki `/` de opsiyonele alınır.
+    const trailingSlash = pattern.endsWith("/");
+    pattern = trailingSlash ? `${pattern.slice(0, -1)}(?:/(.*))?` : `${pattern}(.*)`;
+    index += raw.length;
+  }
+
+  return { regex: new RegExp(`^${pattern}$`), keys, source };
+}
+
+/**
+ * @param {CompiledPattern} compiled
+ * @param {string} pathname
+ * @returns {Record<string, string> | null}
+ */
+export function matchPattern(compiled, pathname) {
+  const match = compiled.regex.exec(pathname);
+  if (!match) return null;
+
+  /** @type {Record<string, string>} */
+  const params = {};
+  compiled.keys.forEach((key, i) => {
+    params[key] = match[i + 1] ?? "";
+  });
+  return params;
+}
+
+/**
+ * `destination` içindeki `:param` yer tutucularını doldurur.
+ *
+ * @param {string} destination
+ * @param {Record<string, string>} params
+ * @returns {string}
+ */
+export function fillDestination(destination, params) {
+  return destination.replace(
+    /:([A-Za-z_][A-Za-z0-9_]*)(\*)?/g,
+    (raw, name) => params[name] ?? raw,
+  );
+}

package/src/http/control-flow.js

@@ -1,71 +1,71 @@
-/**
- * `next/navigation` içindeki notFound/redirect kontrol akışının karşılığı.
- * Derinlerdeki bir fonksiyon throw eder, Express error handler yakalar.
- */
-
-export class NotFoundError extends Error {
-  constructor(message = "Not Found") {
-    super(message);
-    this.name = "NotFoundError";
-    this.statusCode = 404;
-  }
-}
-
-export class RedirectError extends Error {
-  /**
-   * @param {string} location
-   * @param {301 | 302 | 303 | 307 | 308} [statusCode]
-   */
-  constructor(location, statusCode = 307) {
-    super(`Redirect to ${location}`);
-    this.name = "RedirectError";
-    this.location = location;
-    this.statusCode = statusCode;
-  }
-}
-
-/** @returns {never} */
-export function notFound() {
-  throw new NotFoundError();
-}
-
-/**
- * @param {string} location
- * @returns {never}
- */
-export function permanentRedirect(location) {
-  throw new RedirectError(location, 308);
-}
-
-/**
- * @param {string} location
- * @returns {never}
- */
-export function redirect(location) {
-  throw new RedirectError(location, 307);
-}
-
-/**
- * POST sonrası yönlendirme (303 See Other).
- *
- * `redirect()` 307 kullanır ve 307 **metodu korur**: bir POST handler'ından
- * çağrıldığında tarayıcı hedefe yeniden POST eder. Form gönderiminden sonra
- * sayfayı GET olarak açmak — yani geri tuşunun formu yeniden göndermediği
- * klasik "post/redirect/get" akışı — 303 gerektiriyor.
- *
- * @param {string} location
- * @returns {never}
- */
-export function seeOther(location) {
-  throw new RedirectError(location, 303);
-}
-
-/** @param {unknown} error */
-export function isNotFoundError(error) {
-  return error instanceof NotFoundError;
-}
-
-/** @param {unknown} error */
-export function isRedirectError(error) {
-  return error instanceof RedirectError;
-}
+/**
+ * `next/navigation` içindeki notFound/redirect kontrol akışının karşılığı.
+ * Derinlerdeki bir fonksiyon throw eder, Express error handler yakalar.
+ */
+
+export class NotFoundError extends Error {
+  constructor(message = "Not Found") {
+    super(message);
+    this.name = "NotFoundError";
+    this.statusCode = 404;
+  }
+}
+
+export class RedirectError extends Error {
+  /**
+   * @param {string} location
+   * @param {301 | 302 | 303 | 307 | 308} [statusCode]
+   */
+  constructor(location, statusCode = 307) {
+    super(`Redirect to ${location}`);
+    this.name = "RedirectError";
+    this.location = location;
+    this.statusCode = statusCode;
+  }
+}
+
+/** @returns {never} */
+export function notFound() {
+  throw new NotFoundError();
+}
+
+/**
+ * @param {string} location
+ * @returns {never}
+ */
+export function permanentRedirect(location) {
+  throw new RedirectError(location, 308);
+}
+
+/**
+ * @param {string} location
+ * @returns {never}
+ */
+export function redirect(location) {
+  throw new RedirectError(location, 307);
+}
+
+/**
+ * POST sonrası yönlendirme (303 See Other).
+ *
+ * `redirect()` 307 kullanır ve 307 **metodu korur**: bir POST handler'ından
+ * çağrıldığında tarayıcı hedefe yeniden POST eder. Form gönderiminden sonra
+ * sayfayı GET olarak açmak — yani geri tuşunun formu yeniden göndermediği
+ * klasik "post/redirect/get" akışı — 303 gerektiriyor.
+ *
+ * @param {string} location
+ * @returns {never}
+ */
+export function seeOther(location) {
+  throw new RedirectError(location, 303);
+}
+
+/** @param {unknown} error */
+export function isNotFoundError(error) {
+  return error instanceof NotFoundError;
+}
+
+/** @param {unknown} error */
+export function isRedirectError(error) {
+  return error instanceof RedirectError;
+}