npm - jskelet - Versions diffs - 0.6.3 → 0.6.5 - Mend

jskelet 0.6.3 → 0.6.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (154) hide show

package/AGENTS.md +136 -136
package/CHANGELOG.md +633 -620
package/LICENSE +21 -21
package/README.md +2 -0
package/bin/jskelet.mjs +130 -130
package/docs/01-baslangic.md +291 -291
package/docs/02-mimari.md +310 -310
package/docs/03-routing.md +515 -515
package/docs/04-render-ve-sablonlar.md +700 -661
package/docs/05-islands.md +486 -486
package/docs/06-cache.md +1467 -1443
package/docs/07-yapilandirma.md +1208 -1197
package/docs/08-build.md +429 -429
package/docs/09-dev-araclari.md +364 -364
package/docs/10-dagitim.md +351 -338
package/docs/12-panel-ve-oturum.md +479 -478
package/docs/README.md +83 -83
package/docs/en/01-getting-started.md +298 -298
package/docs/en/02-architecture.md +329 -329
package/docs/en/03-routing.md +531 -531
package/docs/en/04-rendering.md +708 -669
package/docs/en/05-islands.md +497 -497
package/docs/en/06-caching.md +1476 -1453
package/docs/en/07-configuration.md +1229 -1219
package/docs/en/08-build.md +447 -447
package/docs/en/09-dev-tools.md +373 -373
package/docs/en/10-deployment.md +355 -340
package/docs/en/11-migration.md +398 -398
package/docs/en/12-dashboards-and-sessions.md +489 -488
package/docs/en/README.md +87 -87
package/package.json +137 -137
package/src/build/ensure-build.mjs +19 -19
package/src/build/paths.mjs +153 -153
package/src/build/resolve-peer.mjs +36 -36
package/src/build/tasks/client.mjs +349 -349
package/src/build/tasks/css.mjs +235 -235
package/src/build/tasks/fonts.mjs +146 -146
package/src/build/tasks/icons.mjs +357 -357
package/src/build/tasks/images.mjs +244 -244
package/src/build/tasks/precompress.mjs +78 -78
package/src/build/tasks/templates.mjs +20 -20
package/src/client/admin/i18n.js +764 -764
package/src/client/admin/login.html +74 -74
package/src/client/admin/panel.css +809 -809
package/src/client/admin/panel.html +495 -495
package/src/client/admin/panel.js +1251 -1251
package/src/client/devtools/report.html +185 -185
package/src/client/devtools/report.js +745 -745
package/src/client/devtools/seo.js +628 -628
package/src/client/dom.js +95 -95
package/src/client/form.js +192 -192
package/src/client/index.js +45 -45
package/src/client/registry.js +305 -305
package/src/client/safe-image.js +91 -91
package/src/client/shared-cookie.js +225 -225
package/src/client/store.js +36 -36
package/src/client/swap.js +188 -188
package/src/compile/codegen.js +336 -336
package/src/compile/compile-all.js +149 -149
package/src/compile/errors.js +66 -66
package/src/compile/expr.js +409 -409
package/src/compile/index.js +17 -17
package/src/compile/parse.js +541 -541
package/src/compile/resolve.js +211 -211
package/src/compile/scan-exports.js +51 -51
package/src/config/defaults.js +541 -534
package/src/config/index.js +1500 -1469
package/src/config/pattern.js +107 -107
package/src/generate.mjs +163 -163
package/src/http/control-flow.js +71 -71
package/src/http/cookies-entry.js +21 -21
package/src/http/cookies.js +277 -277
package/src/http/request-cache.js +46 -46
package/src/http/request-context.js +165 -165
package/src/http/shared-cookie.js +178 -178
package/src/index.js +101 -101
package/src/init.mjs +232 -230
package/src/migrate/apply.mjs +262 -262
package/src/migrate/babel.mjs +79 -79
package/src/migrate/classify.mjs +155 -155
package/src/migrate/config.mjs +126 -126
package/src/migrate/fs-walk.mjs +191 -191
package/src/migrate/parse.mjs +26 -26
package/src/migrate/scan.mjs +177 -177
package/src/migrate/transform/expr-source.mjs +168 -168
package/src/migrate/transform/island.mjs +67 -67
package/src/migrate/transform/jsx-to-component.mjs +302 -302
package/src/migrate/transform/jsx-to-jsk.mjs +330 -330
package/src/migrate/transform/page-split.mjs +435 -435
package/src/migrate/write.mjs +81 -81
package/src/migrate.mjs +171 -171
package/src/runtime/alias-hooks.mjs +119 -119
package/src/runtime/register.mjs +4 -4
package/src/server/admin/actions.js +229 -229
package/src/server/admin/auth.js +125 -125
package/src/server/admin/event-log.js +151 -151
package/src/server/admin/gate.js +209 -209
package/src/server/admin/inventory.js +188 -188
package/src/server/admin/mount.js +56 -56
package/src/server/admin/router.js +216 -216
package/src/server/admin/snapshot.js +241 -241
package/src/server/assets.js +147 -147
package/src/server/auth/handoff.js +309 -309
package/src/server/cache-blob.js +70 -70
package/src/server/cache-control.js +45 -0
package/src/server/cache-deps.js +42 -42
package/src/server/cache-vary.js +113 -113
package/src/server/cloudflare.js +607 -607
package/src/server/create-app.js +366 -366
package/src/server/data-cache.js +553 -553
package/src/server/dev/report.js +485 -485
package/src/server/dev/socket.js +170 -170
package/src/server/dev/version-check.mjs +139 -139
package/src/server/disk-cache.js +233 -233
package/src/server/ejs-adapter.js +59 -59
package/src/server/html-cache.js +1196 -1196
package/src/server/image-optimizer.js +500 -500
package/src/server/logs/access-middleware.js +66 -66
package/src/server/logs/file-sink.js +193 -193
package/src/server/logs/pipeline.js +165 -165
package/src/server/logs/s3-put.js +214 -214
package/src/server/logs/s3-sink.js +112 -112
package/src/server/metadata.js +102 -102
package/src/server/middleware/compression.js +205 -205
package/src/server/middleware/csrf.js +134 -134
package/src/server/middleware/dev-gate.js +75 -75
package/src/server/middleware/headers.js +37 -37
package/src/server/middleware/redirects.js +32 -32
package/src/server/middleware/robots-txt.js +341 -341
package/src/server/middleware/static-precompressed.js +121 -121
package/src/server/middleware/trailing-slash.js +53 -53
package/src/server/middleware/upstream-proxy.js +141 -141
package/src/server/og-image.js +965 -356
package/src/server/og-raster.mjs +21 -0
package/src/server/port-guard.js +255 -255
package/src/server/prewarm.js +1082 -1082
package/src/server/redis.js +588 -588
package/src/server/render.js +910 -910
package/src/server/router.js +157 -157
package/src/server/status-page.js +265 -265
package/src/server/upstream-limiter.js +376 -376
package/src/server/upstream-tracking.js +166 -166
package/src/shared/cookie-domain.js +66 -66
package/src/start.mjs +22 -22
package/src/templates/layout.ejs +30 -30
package/src/templates/layout.jsk +30 -30
package/src/version.mjs +31 -31
package/src/views/components/loader.js +101 -101
package/src/views/helpers/html.js +102 -102
package/src/views/helpers/tags.js +375 -375
package/types/config/defaults.d.ts +6 -0
package/types/config/index.d.ts +6 -0
package/types/server/cache-control.d.ts +28 -0
package/types/server/og-image.d.ts +51 -3

package/src/server/metadata.js CHANGED Viewed

@@ -1,102 +1,102 @@
-/**
- * Metadata → `<head>` etiketleri. Next.js'in Metadata API'sinin karşılığı.
- *
- * Controller `metadata` döndürür, framework onu etiketlere çevirir. Şema
- * bilinçli olarak küçük: title/description/canonical/robots ve OpenGraph +
- * Twitter kartları. Daha fazlası gerekirse `extraTags` ile ham HTML eklenir,
- * böylece framework her yeni meta türü için sürüm çıkarmak zorunda kalmaz.
- *
- * @typedef {object} Metadata
- * @property {string} [title]
- * @property {string} [titleTemplate] `"%s | Site"` — `title` buna gömülür.
- * @property {string} [description]
- * @property {string} [canonical] Mutlak ya da göreli URL.
- * @property {string} [siteUrl] Göreli canonical'ı mutlaklaştırmak için.
- * @property {{ index?: boolean, follow?: boolean }} [robots]
- * @property {string} [locale]
- * @property {object} [openGraph] `{ title, description, url, type, siteName, image, imageWidth, imageHeight }`
- * @property {object} [twitter] `{ card, site, creator, title, description, image }`
- * @property {string[]} [extraTags] Olduğu gibi basılacak ham etiketler.
- */
-import { attrs, esc } from "../views/helpers/html.js";
-/**
- * @param {string} name
- * @param {unknown} content
- * @returns {string}
- */
-function meta(name, content) {
-  if (content == null || content === "") return "";
-  return `<meta${attrs({ name, content })}>`;
-}
-/**
- * OpenGraph `property` kullanır, `name` değil — bazı kazıyıcılar `name` ile
- * yazılmış og etiketlerini görmezden geliyor.
- *
- * @param {string} property
- * @param {unknown} content
- * @returns {string}
- */
-function og(property, content) {
-  if (content == null || content === "") return "";
-  return `<meta${attrs({ property, content })}>`;
-}
-/**
- * @param {string} [canonical]
- * @param {string} [siteUrl]
- * @returns {string | undefined}
- */
-function absoluteUrl(canonical, siteUrl) {
-  if (!canonical) return undefined;
-  if (/^https?:\/\//.test(canonical)) return canonical;
-  if (!siteUrl) return canonical;
-  return new URL(canonical, siteUrl).href;
-}
-/**
- * @param {Metadata} [metadata]
- * @returns {string}
- */
-export function renderHeadMeta(metadata = {}) {
-  const title = metadata.titleTemplate && metadata.title
-    ? metadata.titleTemplate.replace("%s", metadata.title)
-    : metadata.title;
-  const url = absoluteUrl(metadata.canonical, metadata.siteUrl);
-  const robots = metadata.robots ?? {};
-  // Varsayılan indekslenebilir: bir sayfayı gizlemek açık bir karar olmalı.
-  const robotsValue = [
-    robots.index === false ? "noindex" : "index",
-    robots.follow === false ? "nofollow" : "follow",
-  ].join(", ");
-  const graph = metadata.openGraph ?? {};
-  const card = metadata.twitter ?? {};
-  return [
-    title ? `<title>${esc(title)}</title>` : "",
-    meta("description", metadata.description),
-    url ? `<link${attrs({ rel: "canonical", href: url })}>` : "",
-    meta("robots", robotsValue),
-    og("og:type", graph.type ?? "website"),
-    og("og:title", graph.title ?? title),
-    og("og:description", graph.description ?? metadata.description),
-    og("og:url", graph.url ?? url),
-    og("og:site_name", graph.siteName),
-    og("og:locale", metadata.locale),
-    og("og:image", graph.image),
-    og("og:image:width", graph.imageWidth),
-    og("og:image:height", graph.imageHeight),
-    meta("twitter:card", card.card ?? (graph.image ? "summary_large_image" : "summary")),
-    meta("twitter:site", card.site),
-    meta("twitter:creator", card.creator),
-    meta("twitter:title", card.title ?? graph.title ?? title),
-    meta("twitter:description", card.description ?? metadata.description),
-    meta("twitter:image", card.image ?? graph.image),
-    ...(metadata.extraTags ?? []),
-  ]
-    .filter(Boolean)
-    .join("");
-}
+/**
+ * Metadata → `<head>` etiketleri. Next.js'in Metadata API'sinin karşılığı.
+ *
+ * Controller `metadata` döndürür, framework onu etiketlere çevirir. Şema
+ * bilinçli olarak küçük: title/description/canonical/robots ve OpenGraph +
+ * Twitter kartları. Daha fazlası gerekirse `extraTags` ile ham HTML eklenir,
+ * böylece framework her yeni meta türü için sürüm çıkarmak zorunda kalmaz.
+ *
+ * @typedef {object} Metadata
+ * @property {string} [title]
+ * @property {string} [titleTemplate] `"%s | Site"` — `title` buna gömülür.
+ * @property {string} [description]
+ * @property {string} [canonical] Mutlak ya da göreli URL.
+ * @property {string} [siteUrl] Göreli canonical'ı mutlaklaştırmak için.
+ * @property {{ index?: boolean, follow?: boolean }} [robots]
+ * @property {string} [locale]
+ * @property {object} [openGraph] `{ title, description, url, type, siteName, image, imageWidth, imageHeight }`
+ * @property {object} [twitter] `{ card, site, creator, title, description, image }`
+ * @property {string[]} [extraTags] Olduğu gibi basılacak ham etiketler.
+ */
+import { attrs, esc } from "../views/helpers/html.js";
+/**
+ * @param {string} name
+ * @param {unknown} content
+ * @returns {string}
+ */
+function meta(name, content) {
+  if (content == null || content === "") return "";
+  return `<meta${attrs({ name, content })}>`;
+}
+/**
+ * OpenGraph `property` kullanır, `name` değil — bazı kazıyıcılar `name` ile
+ * yazılmış og etiketlerini görmezden geliyor.
+ *
+ * @param {string} property
+ * @param {unknown} content
+ * @returns {string}
+ */
+function og(property, content) {
+  if (content == null || content === "") return "";
+  return `<meta${attrs({ property, content })}>`;
+}
+/**
+ * @param {string} [canonical]
+ * @param {string} [siteUrl]
+ * @returns {string | undefined}
+ */
+function absoluteUrl(canonical, siteUrl) {
+  if (!canonical) return undefined;
+  if (/^https?:\/\//.test(canonical)) return canonical;
+  if (!siteUrl) return canonical;
+  return new URL(canonical, siteUrl).href;
+}
+/**
+ * @param {Metadata} [metadata]
+ * @returns {string}
+ */
+export function renderHeadMeta(metadata = {}) {
+  const title = metadata.titleTemplate && metadata.title
+    ? metadata.titleTemplate.replace("%s", metadata.title)
+    : metadata.title;
+  const url = absoluteUrl(metadata.canonical, metadata.siteUrl);
+  const robots = metadata.robots ?? {};
+  // Varsayılan indekslenebilir: bir sayfayı gizlemek açık bir karar olmalı.
+  const robotsValue = [
+    robots.index === false ? "noindex" : "index",
+    robots.follow === false ? "nofollow" : "follow",
+  ].join(", ");
+  const graph = metadata.openGraph ?? {};
+  const card = metadata.twitter ?? {};
+  return [
+    title ? `<title>${esc(title)}</title>` : "",
+    meta("description", metadata.description),
+    url ? `<link${attrs({ rel: "canonical", href: url })}>` : "",
+    meta("robots", robotsValue),
+    og("og:type", graph.type ?? "website"),
+    og("og:title", graph.title ?? title),
+    og("og:description", graph.description ?? metadata.description),
+    og("og:url", graph.url ?? url),
+    og("og:site_name", graph.siteName),
+    og("og:locale", metadata.locale),
+    og("og:image", graph.image),
+    og("og:image:width", graph.imageWidth),
+    og("og:image:height", graph.imageHeight),
+    meta("twitter:card", card.card ?? (graph.image ? "summary_large_image" : "summary")),
+    meta("twitter:site", card.site),
+    meta("twitter:creator", card.creator),
+    meta("twitter:title", card.title ?? graph.title ?? title),
+    meta("twitter:description", card.description ?? metadata.description),
+    meta("twitter:image", card.image ?? graph.image),
+    ...(metadata.extraTags ?? []),
+  ]
+    .filter(Boolean)
+    .join("");
+}

package/src/server/middleware/compression.js CHANGED Viewed

@@ -1,205 +1,205 @@
-/**
- * Yanıt sıkıştırma — Next.js'in varsayılan `compress: true` davranışının yerine.
- *
- * `compression` paketi brotli desteklemiyor ve yedi geçişli bağımlılık
- * getiriyor; `node:zlib` ile brotli + gzip pazarlığı yapmak yeterli.
- * Brotli tercih edilir: ana sayfa HTML'inde gzip'e göre ~%35 daha küçük.
- */
-import zlib from "node:zlib";
-import { Writable } from "node:stream";
-/** Bu eşiğin altındaki gövdelerde sıkıştırma kazancı yok. */
-const THRESHOLD_BYTES = 1024;
-const COMPRESSIBLE =
-  /^(?:text\/|application\/(?:json|javascript|xml|xhtml\+xml|rss\+xml|atom\+xml|ld\+json|manifest\+json)|image\/svg\+xml)/i;
-const BROTLI_OPTIONS = {
-  params: {
-    // Metin için 5, varsayılan 11'e göre çok daha hızlı ve neredeyse aynı boyut.
-    [zlib.constants.BROTLI_PARAM_QUALITY]: 5,
-    [zlib.constants.BROTLI_PARAM_MODE]: zlib.constants.BROTLI_MODE_TEXT,
-  },
-};
-/**
- * @param {string} header
- * @returns {"br" | "gzip" | null}
- */
-function negotiate(header) {
-  if (!header) return null;
-  /** @type {Map<string, number>} */
-  const weights = new Map();
-  for (const part of header.split(",")) {
-    const [name, ...params] = part.trim().split(";");
-    const q = params
-      .map((p) => p.trim())
-      .find((p) => p.startsWith("q="));
-    weights.set(name.toLowerCase(), q ? Number(q.slice(2)) : 1);
-  }
-  if ((weights.get("br") ?? 0) > 0) return "br";
-  if ((weights.get("gzip") ?? 0) > 0) return "gzip";
-  return null;
-}
-/**
- * İçeriği bir kez sıkıştırıp saklamak isteyen çağıranlar için (HTML cache).
- *
- * @param {string | undefined} acceptEncoding
- * @returns {"br" | "gzip" | null}
- */
-export function negotiateEncoding(acceptEncoding) {
-  return negotiate(acceptEncoding ?? "");
-}
-/**
- * @param {string} text
- * @param {"br" | "gzip"} encoding
- * @returns {Promise<Buffer>}
- */
-export function encodeText(text, encoding) {
-  const input = Buffer.from(text, "utf8");
-  return new Promise((resolve, reject) => {
-    const done = (error, result) => (error ? reject(error) : resolve(result));
-    if (encoding === "br") zlib.brotliCompress(input, BROTLI_OPTIONS, done);
-    else zlib.gzip(input, done);
-  });
-}
-/**
- * @param {import('http').ServerResponse} res
- * @returns {boolean}
- */
-function shouldCompress(res) {
-  if (res.getHeader("content-encoding")) return false;
-  if (res.getHeader("cache-control")?.toString().includes("no-transform")) {
-    return false;
-  }
-  const type = res.getHeader("content-type")?.toString() ?? "";
-  if (type.includes("text/event-stream")) return false;
-  if (!COMPRESSIBLE.test(type)) return false;
-  const length = Number(res.getHeader("content-length"));
-  return Number.isNaN(length) || length >= THRESHOLD_BYTES;
-}
-/**
- * @returns {import('express').RequestHandler}
- */
-export function compression() {
-  return (req, res, next) => {
-    // HEAD gövdesi yok; zaten sıkışık ikili içerik boşuna CPU yakar.
-    const encoding = req.method === "HEAD" ? null : negotiate(req.headers["accept-encoding"]);
-    const originalWrite = res.write.bind(res);
-    const originalEnd = res.end.bind(res);
-    /** @type {import('zlib').Gzip | import('zlib').BrotliCompress | null} */
-    let stream = null;
-    let decided = false;
-    let passthrough = false;
-    function decide() {
-      if (decided) return;
-      decided = true;
-      // SSE gibi akışlar başlıkları kendileri yazar (`writeHead`); bu noktada
-      // başlık eklemek çökme sebebi olur, sıkıştırma da anlamsızdır.
-      if (res.headersSent) {
-        passthrough = true;
-        return;
-      }
-      // Vary her durumda: aynı URL farklı encoding ile cache'lenebilir.
-      res.setHeader("Vary", appendVary(res.getHeader("Vary"), "Accept-Encoding"));
-      if (!encoding || !shouldCompress(res)) {
-        passthrough = true;
-        return;
-      }
-      res.setHeader("Content-Encoding", encoding);
-      res.removeHeader("Content-Length");
-      stream =
-        encoding === "br"
-          ? zlib.createBrotliCompress(BROTLI_OPTIONS)
-          : zlib.createGzip({ level: 6 });
-      // Sıkıştırılmış çıktıyı sokete geri baskıya saygı duyarak aktar.
-      stream.pipe(
-        new Writable({
-          write(chunk, chunkEncoding, callback) {
-            originalWrite(chunk, chunkEncoding, callback);
-          },
-          final(callback) {
-            originalEnd();
-            callback();
-          },
-        }),
-      );
-      // `express.static` gövdeyi `pipe` ile yazar ve `res.write()` false
-      // dönerse `drain` bekler; zlib doldu-boşaldı sinyalini yansıtmazsak
-      // aktarım sessizce askıda kalır.
-      stream.on("drain", () => res.emit("drain"));
-      stream.on("error", () => originalEnd());
-    }
-    res.write = function write(chunk, encodingArg, callback) {
-      decide();
-      if (passthrough) return originalWrite(chunk, encodingArg, callback);
-      if (!chunk) return true;
-      return stream.write(toBuffer(chunk, encodingArg), callback);
-    };
-    res.end = function end(chunk, encodingArg, callback) {
-      decide();
-      if (passthrough) return originalEnd(chunk, encodingArg, callback);
-      if (chunk && typeof chunk !== "function") {
-        stream.end(toBuffer(chunk, encodingArg), callback);
-      } else {
-        stream.end();
-      }
-      return res;
-    };
-    next();
-  };
-}
-/**
- * @param {unknown} chunk
- * @param {unknown} encodingArg
- * @returns {Buffer}
- */
-function toBuffer(chunk, encodingArg) {
-  if (Buffer.isBuffer(chunk)) return chunk;
-  return Buffer.from(
-    /** @type {string} */ (chunk),
-    typeof encodingArg === "string" ? /** @type {BufferEncoding} */ (encodingArg) : "utf8",
-  );
-}
-/**
- * @param {unknown} current
- * @param {string} field
- * @returns {string}
- */
-function appendVary(current, field) {
-  const existing = current ? String(current) : "";
-  if (!existing) return field;
-  const parts = existing.split(",").map((p) => p.trim().toLowerCase());
-  return parts.includes(field.toLowerCase()) ? existing : `${existing}, ${field}`;
-}
+/**
+ * Yanıt sıkıştırma — Next.js'in varsayılan `compress: true` davranışının yerine.
+ *
+ * `compression` paketi brotli desteklemiyor ve yedi geçişli bağımlılık
+ * getiriyor; `node:zlib` ile brotli + gzip pazarlığı yapmak yeterli.
+ * Brotli tercih edilir: ana sayfa HTML'inde gzip'e göre ~%35 daha küçük.
+ */
+import zlib from "node:zlib";
+import { Writable } from "node:stream";
+/** Bu eşiğin altındaki gövdelerde sıkıştırma kazancı yok. */
+const THRESHOLD_BYTES = 1024;
+const COMPRESSIBLE =
+  /^(?:text\/|application\/(?:json|javascript|xml|xhtml\+xml|rss\+xml|atom\+xml|ld\+json|manifest\+json)|image\/svg\+xml)/i;
+const BROTLI_OPTIONS = {
+  params: {
+    // Metin için 5, varsayılan 11'e göre çok daha hızlı ve neredeyse aynı boyut.
+    [zlib.constants.BROTLI_PARAM_QUALITY]: 5,
+    [zlib.constants.BROTLI_PARAM_MODE]: zlib.constants.BROTLI_MODE_TEXT,
+  },
+};
+/**
+ * @param {string} header
+ * @returns {"br" | "gzip" | null}
+ */
+function negotiate(header) {
+  if (!header) return null;
+  /** @type {Map<string, number>} */
+  const weights = new Map();
+  for (const part of header.split(",")) {
+    const [name, ...params] = part.trim().split(";");
+    const q = params
+      .map((p) => p.trim())
+      .find((p) => p.startsWith("q="));
+    weights.set(name.toLowerCase(), q ? Number(q.slice(2)) : 1);
+  }
+  if ((weights.get("br") ?? 0) > 0) return "br";
+  if ((weights.get("gzip") ?? 0) > 0) return "gzip";
+  return null;
+}
+/**
+ * İçeriği bir kez sıkıştırıp saklamak isteyen çağıranlar için (HTML cache).
+ *
+ * @param {string | undefined} acceptEncoding
+ * @returns {"br" | "gzip" | null}
+ */
+export function negotiateEncoding(acceptEncoding) {
+  return negotiate(acceptEncoding ?? "");
+}
+/**
+ * @param {string} text
+ * @param {"br" | "gzip"} encoding
+ * @returns {Promise<Buffer>}
+ */
+export function encodeText(text, encoding) {
+  const input = Buffer.from(text, "utf8");
+  return new Promise((resolve, reject) => {
+    const done = (error, result) => (error ? reject(error) : resolve(result));
+    if (encoding === "br") zlib.brotliCompress(input, BROTLI_OPTIONS, done);
+    else zlib.gzip(input, done);
+  });
+}
+/**
+ * @param {import('http').ServerResponse} res
+ * @returns {boolean}
+ */
+function shouldCompress(res) {
+  if (res.getHeader("content-encoding")) return false;
+  if (res.getHeader("cache-control")?.toString().includes("no-transform")) {
+    return false;
+  }
+  const type = res.getHeader("content-type")?.toString() ?? "";
+  if (type.includes("text/event-stream")) return false;
+  if (!COMPRESSIBLE.test(type)) return false;
+  const length = Number(res.getHeader("content-length"));
+  return Number.isNaN(length) || length >= THRESHOLD_BYTES;
+}
+/**
+ * @returns {import('express').RequestHandler}
+ */
+export function compression() {
+  return (req, res, next) => {
+    // HEAD gövdesi yok; zaten sıkışık ikili içerik boşuna CPU yakar.
+    const encoding = req.method === "HEAD" ? null : negotiate(req.headers["accept-encoding"]);
+    const originalWrite = res.write.bind(res);
+    const originalEnd = res.end.bind(res);
+    /** @type {import('zlib').Gzip | import('zlib').BrotliCompress | null} */
+    let stream = null;
+    let decided = false;
+    let passthrough = false;
+    function decide() {
+      if (decided) return;
+      decided = true;
+      // SSE gibi akışlar başlıkları kendileri yazar (`writeHead`); bu noktada
+      // başlık eklemek çökme sebebi olur, sıkıştırma da anlamsızdır.
+      if (res.headersSent) {
+        passthrough = true;
+        return;
+      }
+      // Vary her durumda: aynı URL farklı encoding ile cache'lenebilir.
+      res.setHeader("Vary", appendVary(res.getHeader("Vary"), "Accept-Encoding"));
+      if (!encoding || !shouldCompress(res)) {
+        passthrough = true;
+        return;
+      }
+      res.setHeader("Content-Encoding", encoding);
+      res.removeHeader("Content-Length");
+      stream =
+        encoding === "br"
+          ? zlib.createBrotliCompress(BROTLI_OPTIONS)
+          : zlib.createGzip({ level: 6 });
+      // Sıkıştırılmış çıktıyı sokete geri baskıya saygı duyarak aktar.
+      stream.pipe(
+        new Writable({
+          write(chunk, chunkEncoding, callback) {
+            originalWrite(chunk, chunkEncoding, callback);
+          },
+          final(callback) {
+            originalEnd();
+            callback();
+          },
+        }),
+      );
+      // `express.static` gövdeyi `pipe` ile yazar ve `res.write()` false
+      // dönerse `drain` bekler; zlib doldu-boşaldı sinyalini yansıtmazsak
+      // aktarım sessizce askıda kalır.
+      stream.on("drain", () => res.emit("drain"));
+      stream.on("error", () => originalEnd());
+    }
+    res.write = function write(chunk, encodingArg, callback) {
+      decide();
+      if (passthrough) return originalWrite(chunk, encodingArg, callback);
+      if (!chunk) return true;
+      return stream.write(toBuffer(chunk, encodingArg), callback);
+    };
+    res.end = function end(chunk, encodingArg, callback) {
+      decide();
+      if (passthrough) return originalEnd(chunk, encodingArg, callback);
+      if (chunk && typeof chunk !== "function") {
+        stream.end(toBuffer(chunk, encodingArg), callback);
+      } else {
+        stream.end();
+      }
+      return res;
+    };
+    next();
+  };
+}
+/**
+ * @param {unknown} chunk
+ * @param {unknown} encodingArg
+ * @returns {Buffer}
+ */
+function toBuffer(chunk, encodingArg) {
+  if (Buffer.isBuffer(chunk)) return chunk;
+  return Buffer.from(
+    /** @type {string} */ (chunk),
+    typeof encodingArg === "string" ? /** @type {BufferEncoding} */ (encodingArg) : "utf8",
+  );
+}
+/**
+ * @param {unknown} current
+ * @param {string} field
+ * @returns {string}
+ */
+function appendVary(current, field) {
+  const existing = current ? String(current) : "";
+  if (!existing) return field;
+  const parts = existing.split(",").map((p) => p.trim().toLowerCase());
+  return parts.includes(field.toLowerCase()) ? existing : `${existing}, ${field}`;
+}