jskelet 0.2.3 → 0.2.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 (91) hide show
  1. package/AGENTS.md +132 -132
  2. package/CHANGELOG.md +15 -0
  3. package/LICENSE +21 -21
  4. package/bin/jskelet.mjs +103 -103
  5. package/docs/01-baslangic.md +285 -285
  6. package/docs/02-mimari.md +287 -287
  7. package/docs/03-routing.md +480 -480
  8. package/docs/04-render-ve-sablonlar.md +490 -490
  9. package/docs/05-islands.md +482 -482
  10. package/docs/06-cache.md +1209 -1202
  11. package/docs/08-build.md +366 -366
  12. package/docs/09-dev-araclari.md +335 -335
  13. package/docs/10-dagitim.md +329 -329
  14. package/docs/12-panel-ve-oturum.md +384 -384
  15. package/docs/README.md +105 -105
  16. package/docs/en/01-getting-started.md +292 -292
  17. package/docs/en/02-architecture.md +305 -305
  18. package/docs/en/03-routing.md +497 -497
  19. package/docs/en/04-rendering.md +504 -504
  20. package/docs/en/05-islands.md +492 -492
  21. package/docs/en/06-caching.md +1239 -1232
  22. package/docs/en/07-configuration.md +986 -986
  23. package/docs/en/08-build.md +383 -383
  24. package/docs/en/09-dev-tools.md +342 -342
  25. package/docs/en/10-deployment.md +332 -332
  26. package/docs/en/11-migration.md +359 -359
  27. package/docs/en/12-dashboards-and-sessions.md +392 -392
  28. package/docs/en/README.md +112 -112
  29. package/package.json +102 -102
  30. package/src/build/ensure-build.mjs +15 -15
  31. package/src/build/paths.mjs +143 -143
  32. package/src/build/resolve-peer.mjs +36 -36
  33. package/src/build/tasks/client.mjs +268 -268
  34. package/src/build/tasks/css.mjs +124 -124
  35. package/src/build/tasks/fonts.mjs +146 -146
  36. package/src/build/tasks/icons.mjs +224 -224
  37. package/src/build/tasks/images.mjs +244 -244
  38. package/src/build/tasks/precompress.mjs +78 -78
  39. package/src/client/cache-panel/i18n.js +670 -0
  40. package/src/client/cache-panel/login.html +74 -71
  41. package/src/client/cache-panel/panel.css +756 -740
  42. package/src/client/cache-panel/panel.html +308 -307
  43. package/src/client/cache-panel/panel.js +915 -808
  44. package/src/client/devtools/report.html +185 -185
  45. package/src/client/devtools/report.js +725 -725
  46. package/src/client/dom.js +95 -95
  47. package/src/client/form.js +192 -192
  48. package/src/client/index.js +35 -35
  49. package/src/client/registry.js +297 -297
  50. package/src/client/safe-image.js +91 -91
  51. package/src/client/store.js +36 -36
  52. package/src/client/swap.js +188 -188
  53. package/src/config/pattern.js +107 -107
  54. package/src/http/control-flow.js +71 -71
  55. package/src/http/cookies.js +257 -257
  56. package/src/http/request-cache.js +46 -46
  57. package/src/http/request-context.js +162 -162
  58. package/src/index.js +83 -83
  59. package/src/init.mjs +221 -221
  60. package/src/runtime/alias-hooks.mjs +119 -119
  61. package/src/runtime/register.mjs +4 -4
  62. package/src/server/assets.js +147 -147
  63. package/src/server/cache-deps.js +42 -42
  64. package/src/server/cache-panel.js +759 -738
  65. package/src/server/cloudflare.js +607 -595
  66. package/src/server/create-app.js +291 -291
  67. package/src/server/data-cache.js +462 -462
  68. package/src/server/dev/report.js +369 -369
  69. package/src/server/dev/socket.js +170 -170
  70. package/src/server/dev/version-check.mjs +139 -139
  71. package/src/server/html-cache.js +817 -817
  72. package/src/server/metadata.js +102 -102
  73. package/src/server/middleware/compression.js +205 -205
  74. package/src/server/middleware/csrf.js +134 -134
  75. package/src/server/middleware/dev-gate.js +62 -62
  76. package/src/server/middleware/headers.js +37 -37
  77. package/src/server/middleware/redirects.js +32 -32
  78. package/src/server/middleware/static-precompressed.js +100 -100
  79. package/src/server/middleware/upstream-proxy.js +141 -141
  80. package/src/server/prewarm.js +601 -601
  81. package/src/server/redis.js +569 -569
  82. package/src/server/router.js +128 -128
  83. package/src/server/status-page.js +164 -164
  84. package/src/server/upstream-limiter.js +376 -376
  85. package/src/server/upstream-tracking.js +166 -166
  86. package/src/start.mjs +7 -7
  87. package/src/templates/layout.ejs +44 -44
  88. package/src/version.mjs +31 -31
  89. package/src/views/components/loader.js +85 -85
  90. package/src/views/helpers/html.js +102 -102
  91. package/src/views/helpers/tags.js +245 -245
package/src/server/metadata.js CHANGED
@@ -1,102 +1,102 @@
1
- /**
2
- * Metadata → `<head>` etiketleri. Next.js'in Metadata API'sinin karşılığı.
3
- *
4
- * Controller `metadata` döndürür, framework onu etiketlere çevirir. Şema
5
- * bilinçli olarak küçük: title/description/canonical/robots ve OpenGraph +
6
- * Twitter kartları. Daha fazlası gerekirse `extraTags` ile ham HTML eklenir,
7
- * böylece framework her yeni meta türü için sürüm çıkarmak zorunda kalmaz.
8
- *
9
- * @typedef {object} Metadata
10
- * @property {string} [title]
11
- * @property {string} [titleTemplate] `"%s | Site"` — `title` buna gömülür.
12
- * @property {string} [description]
13
- * @property {string} [canonical] Mutlak ya da göreli URL.
14
- * @property {string} [siteUrl] Göreli canonical'ı mutlaklaştırmak için.
15
- * @property {{ index?: boolean, follow?: boolean }} [robots]
16
- * @property {string} [locale]
17
- * @property {object} [openGraph] `{ title, description, url, type, siteName, image, imageWidth, imageHeight }`
18
- * @property {object} [twitter] `{ card, site, creator, title, description, image }`
19
- * @property {string[]} [extraTags] Olduğu gibi basılacak ham etiketler.
20
- */
21
- import { attrs, esc } from "../views/helpers/html.js";
22
-
23
- /**
24
- * @param {string} name
25
- * @param {unknown} content
26
- * @returns {string}
27
- */
28
- function meta(name, content) {
29
- if (content == null || content === "") return "";
30
- return `<meta${attrs({ name, content })}>`;
31
- }
32
-
33
- /**
34
- * OpenGraph `property` kullanır, `name` değil — bazı kazıyıcılar `name` ile
35
- * yazılmış og etiketlerini görmezden geliyor.
36
- *
37
- * @param {string} property
38
- * @param {unknown} content
39
- * @returns {string}
40
- */
41
- function og(property, content) {
42
- if (content == null || content === "") return "";
43
- return `<meta${attrs({ property, content })}>`;
44
- }
45
-
46
- /**
47
- * @param {string} [canonical]
48
- * @param {string} [siteUrl]
49
- * @returns {string | undefined}
50
- */
51
- function absoluteUrl(canonical, siteUrl) {
52
- if (!canonical) return undefined;
53
- if (/^https?:\/\//.test(canonical)) return canonical;
54
- if (!siteUrl) return canonical;
55
- return new URL(canonical, siteUrl).href;
56
- }
57
-
58
- /**
59
- * @param {Metadata} [metadata]
60
- * @returns {string}
61
- */
62
- export function renderHeadMeta(metadata = {}) {
63
- const title = metadata.titleTemplate && metadata.title
64
- ? metadata.titleTemplate.replace("%s", metadata.title)
65
- : metadata.title;
66
-
67
- const url = absoluteUrl(metadata.canonical, metadata.siteUrl);
68
- const robots = metadata.robots ?? {};
69
- // Varsayılan indekslenebilir: bir sayfayı gizlemek açık bir karar olmalı.
70
- const robotsValue = [
71
- robots.index === false ? "noindex" : "index",
72
- robots.follow === false ? "nofollow" : "follow",
73
- ].join(", ");
74
-
75
- const graph = metadata.openGraph ?? {};
76
- const card = metadata.twitter ?? {};
77
-
78
- return [
79
- title ? `<title>${esc(title)}</title>` : "",
80
- meta("description", metadata.description),
81
- url ? `<link${attrs({ rel: "canonical", href: url })}>` : "",
82
- meta("robots", robotsValue),
83
- og("og:type", graph.type ?? "website"),
84
- og("og:title", graph.title ?? title),
85
- og("og:description", graph.description ?? metadata.description),
86
- og("og:url", graph.url ?? url),
87
- og("og:site_name", graph.siteName),
88
- og("og:locale", metadata.locale),
89
- og("og:image", graph.image),
90
- og("og:image:width", graph.imageWidth),
91
- og("og:image:height", graph.imageHeight),
92
- meta("twitter:card", card.card ?? (graph.image ? "summary_large_image" : "summary")),
93
- meta("twitter:site", card.site),
94
- meta("twitter:creator", card.creator),
95
- meta("twitter:title", card.title ?? graph.title ?? title),
96
- meta("twitter:description", card.description ?? metadata.description),
97
- meta("twitter:image", card.image ?? graph.image),
98
- ...(metadata.extraTags ?? []),
99
- ]
100
- .filter(Boolean)
101
- .join("");
102
- }
1
+ /**
2
+ * Metadata → `<head>` etiketleri. Next.js'in Metadata API'sinin karşılığı.
3
+ *
4
+ * Controller `metadata` döndürür, framework onu etiketlere çevirir. Şema
5
+ * bilinçli olarak küçük: title/description/canonical/robots ve OpenGraph +
6
+ * Twitter kartları. Daha fazlası gerekirse `extraTags` ile ham HTML eklenir,
7
+ * böylece framework her yeni meta türü için sürüm çıkarmak zorunda kalmaz.
8
+ *
9
+ * @typedef {object} Metadata
10
+ * @property {string} [title]
11
+ * @property {string} [titleTemplate] `"%s | Site"` — `title` buna gömülür.
12
+ * @property {string} [description]
13
+ * @property {string} [canonical] Mutlak ya da göreli URL.
14
+ * @property {string} [siteUrl] Göreli canonical'ı mutlaklaştırmak için.
15
+ * @property {{ index?: boolean, follow?: boolean }} [robots]
16
+ * @property {string} [locale]
17
+ * @property {object} [openGraph] `{ title, description, url, type, siteName, image, imageWidth, imageHeight }`
18
+ * @property {object} [twitter] `{ card, site, creator, title, description, image }`
19
+ * @property {string[]} [extraTags] Olduğu gibi basılacak ham etiketler.
20
+ */
21
+ import { attrs, esc } from "../views/helpers/html.js";
22
+
23
+ /**
24
+ * @param {string} name
25
+ * @param {unknown} content
26
+ * @returns {string}
27
+ */
28
+ function meta(name, content) {
29
+ if (content == null || content === "") return "";
30
+ return `<meta${attrs({ name, content })}>`;
31
+ }
32
+
33
+ /**
34
+ * OpenGraph `property` kullanır, `name` değil — bazı kazıyıcılar `name` ile
35
+ * yazılmış og etiketlerini görmezden geliyor.
36
+ *
37
+ * @param {string} property
38
+ * @param {unknown} content
39
+ * @returns {string}
40
+ */
41
+ function og(property, content) {
42
+ if (content == null || content === "") return "";
43
+ return `<meta${attrs({ property, content })}>`;
44
+ }
45
+
46
+ /**
47
+ * @param {string} [canonical]
48
+ * @param {string} [siteUrl]
49
+ * @returns {string | undefined}
50
+ */
51
+ function absoluteUrl(canonical, siteUrl) {
52
+ if (!canonical) return undefined;
53
+ if (/^https?:\/\//.test(canonical)) return canonical;
54
+ if (!siteUrl) return canonical;
55
+ return new URL(canonical, siteUrl).href;
56
+ }
57
+
58
+ /**
59
+ * @param {Metadata} [metadata]
60
+ * @returns {string}
61
+ */
62
+ export function renderHeadMeta(metadata = {}) {
63
+ const title = metadata.titleTemplate && metadata.title
64
+ ? metadata.titleTemplate.replace("%s", metadata.title)
65
+ : metadata.title;
66
+
67
+ const url = absoluteUrl(metadata.canonical, metadata.siteUrl);
68
+ const robots = metadata.robots ?? {};
69
+ // Varsayılan indekslenebilir: bir sayfayı gizlemek açık bir karar olmalı.
70
+ const robotsValue = [
71
+ robots.index === false ? "noindex" : "index",
72
+ robots.follow === false ? "nofollow" : "follow",
73
+ ].join(", ");
74
+
75
+ const graph = metadata.openGraph ?? {};
76
+ const card = metadata.twitter ?? {};
77
+
78
+ return [
79
+ title ? `<title>${esc(title)}</title>` : "",
80
+ meta("description", metadata.description),
81
+ url ? `<link${attrs({ rel: "canonical", href: url })}>` : "",
82
+ meta("robots", robotsValue),
83
+ og("og:type", graph.type ?? "website"),
84
+ og("og:title", graph.title ?? title),
85
+ og("og:description", graph.description ?? metadata.description),
86
+ og("og:url", graph.url ?? url),
87
+ og("og:site_name", graph.siteName),
88
+ og("og:locale", metadata.locale),
89
+ og("og:image", graph.image),
90
+ og("og:image:width", graph.imageWidth),
91
+ og("og:image:height", graph.imageHeight),
92
+ meta("twitter:card", card.card ?? (graph.image ? "summary_large_image" : "summary")),
93
+ meta("twitter:site", card.site),
94
+ meta("twitter:creator", card.creator),
95
+ meta("twitter:title", card.title ?? graph.title ?? title),
96
+ meta("twitter:description", card.description ?? metadata.description),
97
+ meta("twitter:image", card.image ?? graph.image),
98
+ ...(metadata.extraTags ?? []),
99
+ ]
100
+ .filter(Boolean)
101
+ .join("");
102
+ }
package/src/server/middleware/compression.js CHANGED
@@ -1,205 +1,205 @@
1
- /**
2
- * Yanıt sıkıştırma — Next.js'in varsayılan `compress: true` davranışının yerine.
3
- *
4
- * `compression` paketi brotli desteklemiyor ve yedi geçişli bağımlılık
5
- * getiriyor; `node:zlib` ile brotli + gzip pazarlığı yapmak yeterli.
6
- * Brotli tercih edilir: ana sayfa HTML'inde gzip'e göre ~%35 daha küçük.
7
- */
8
- import zlib from "node:zlib";
9
- import { Writable } from "node:stream";
10
-
11
- /** Bu eşiğin altındaki gövdelerde sıkıştırma kazancı yok. */
12
- const THRESHOLD_BYTES = 1024;
13
-
14
- const COMPRESSIBLE =
15
- /^(?:text\/|application\/(?:json|javascript|xml|xhtml\+xml|rss\+xml|atom\+xml|ld\+json|manifest\+json)|image\/svg\+xml)/i;
16
-
17
- const BROTLI_OPTIONS = {
18
- params: {
19
- // Metin için 5, varsayılan 11'e göre çok daha hızlı ve neredeyse aynı boyut.
20
- [zlib.constants.BROTLI_PARAM_QUALITY]: 5,
21
- [zlib.constants.BROTLI_PARAM_MODE]: zlib.constants.BROTLI_MODE_TEXT,
22
- },
23
- };
24
-
25
- /**
26
- * @param {string} header
27
- * @returns {"br" | "gzip" | null}
28
- */
29
- function negotiate(header) {
30
- if (!header) return null;
31
-
32
- /** @type {Map<string, number>} */
33
- const weights = new Map();
34
-
35
- for (const part of header.split(",")) {
36
- const [name, ...params] = part.trim().split(";");
37
- const q = params
38
- .map((p) => p.trim())
39
- .find((p) => p.startsWith("q="));
40
-
41
- weights.set(name.toLowerCase(), q ? Number(q.slice(2)) : 1);
42
- }
43
-
44
- if ((weights.get("br") ?? 0) > 0) return "br";
45
- if ((weights.get("gzip") ?? 0) > 0) return "gzip";
46
- return null;
47
- }
48
-
49
- /**
50
- * İçeriği bir kez sıkıştırıp saklamak isteyen çağıranlar için (HTML cache).
51
- *
52
- * @param {string | undefined} acceptEncoding
53
- * @returns {"br" | "gzip" | null}
54
- */
55
- export function negotiateEncoding(acceptEncoding) {
56
- return negotiate(acceptEncoding ?? "");
57
- }
58
-
59
- /**
60
- * @param {string} text
61
- * @param {"br" | "gzip"} encoding
62
- * @returns {Promise<Buffer>}
63
- */
64
- export function encodeText(text, encoding) {
65
- const input = Buffer.from(text, "utf8");
66
-
67
- return new Promise((resolve, reject) => {
68
- const done = (error, result) => (error ? reject(error) : resolve(result));
69
-
70
- if (encoding === "br") zlib.brotliCompress(input, BROTLI_OPTIONS, done);
71
- else zlib.gzip(input, done);
72
- });
73
- }
74
-
75
- /**
76
- * @param {import('http').ServerResponse} res
77
- * @returns {boolean}
78
- */
79
- function shouldCompress(res) {
80
- if (res.getHeader("content-encoding")) return false;
81
- if (res.getHeader("cache-control")?.toString().includes("no-transform")) {
82
- return false;
83
- }
84
-
85
- const type = res.getHeader("content-type")?.toString() ?? "";
86
- if (type.includes("text/event-stream")) return false;
87
- if (!COMPRESSIBLE.test(type)) return false;
88
-
89
- const length = Number(res.getHeader("content-length"));
90
- return Number.isNaN(length) || length >= THRESHOLD_BYTES;
91
- }
92
-
93
- /**
94
- * @returns {import('express').RequestHandler}
95
- */
96
- export function compression() {
97
- return (req, res, next) => {
98
- // HEAD gövdesi yok; zaten sıkışık ikili içerik boşuna CPU yakar.
99
- const encoding = req.method === "HEAD" ? null : negotiate(req.headers["accept-encoding"]);
100
-
101
- const originalWrite = res.write.bind(res);
102
- const originalEnd = res.end.bind(res);
103
-
104
- /** @type {import('zlib').Gzip | import('zlib').BrotliCompress | null} */
105
- let stream = null;
106
- let decided = false;
107
- let passthrough = false;
108
-
109
- function decide() {
110
- if (decided) return;
111
- decided = true;
112
-
113
- // SSE gibi akışlar başlıkları kendileri yazar (`writeHead`); bu noktada
114
- // başlık eklemek çökme sebebi olur, sıkıştırma da anlamsızdır.
115
- if (res.headersSent) {
116
- passthrough = true;
117
- return;
118
- }
119
-
120
- // Vary her durumda: aynı URL farklı encoding ile cache'lenebilir.
121
- res.setHeader("Vary", appendVary(res.getHeader("Vary"), "Accept-Encoding"));
122
-
123
- if (!encoding || !shouldCompress(res)) {
124
- passthrough = true;
125
- return;
126
- }
127
-
128
- res.setHeader("Content-Encoding", encoding);
129
- res.removeHeader("Content-Length");
130
-
131
- stream =
132
- encoding === "br"
133
- ? zlib.createBrotliCompress(BROTLI_OPTIONS)
134
- : zlib.createGzip({ level: 6 });
135
-
136
- // Sıkıştırılmış çıktıyı sokete geri baskıya saygı duyarak aktar.
137
- stream.pipe(
138
- new Writable({
139
- write(chunk, chunkEncoding, callback) {
140
- originalWrite(chunk, chunkEncoding, callback);
141
- },
142
- final(callback) {
143
- originalEnd();
144
- callback();
145
- },
146
- }),
147
- );
148
-
149
- // `express.static` gövdeyi `pipe` ile yazar ve `res.write()` false
150
- // dönerse `drain` bekler; zlib doldu-boşaldı sinyalini yansıtmazsak
151
- // aktarım sessizce askıda kalır.
152
- stream.on("drain", () => res.emit("drain"));
153
- stream.on("error", () => originalEnd());
154
- }
155
-
156
- res.write = function write(chunk, encodingArg, callback) {
157
- decide();
158
- if (passthrough) return originalWrite(chunk, encodingArg, callback);
159
- if (!chunk) return true;
160
-
161
- return stream.write(toBuffer(chunk, encodingArg), callback);
162
- };
163
-
164
- res.end = function end(chunk, encodingArg, callback) {
165
- decide();
166
- if (passthrough) return originalEnd(chunk, encodingArg, callback);
167
-
168
- if (chunk && typeof chunk !== "function") {
169
- stream.end(toBuffer(chunk, encodingArg), callback);
170
- } else {
171
- stream.end();
172
- }
173
-
174
- return res;
175
- };
176
-
177
- next();
178
- };
179
- }
180
-
181
- /**
182
- * @param {unknown} chunk
183
- * @param {unknown} encodingArg
184
- * @returns {Buffer}
185
- */
186
- function toBuffer(chunk, encodingArg) {
187
- if (Buffer.isBuffer(chunk)) return chunk;
188
- return Buffer.from(
189
- /** @type {string} */ (chunk),
190
- typeof encodingArg === "string" ? /** @type {BufferEncoding} */ (encodingArg) : "utf8",
191
- );
192
- }
193
-
194
- /**
195
- * @param {unknown} current
196
- * @param {string} field
197
- * @returns {string}
198
- */
199
- function appendVary(current, field) {
200
- const existing = current ? String(current) : "";
201
- if (!existing) return field;
202
-
203
- const parts = existing.split(",").map((p) => p.trim().toLowerCase());
204
- return parts.includes(field.toLowerCase()) ? existing : `${existing}, ${field}`;
205
- }
1
+ /**
2
+ * Yanıt sıkıştırma — Next.js'in varsayılan `compress: true` davranışının yerine.
3
+ *
4
+ * `compression` paketi brotli desteklemiyor ve yedi geçişli bağımlılık
5
+ * getiriyor; `node:zlib` ile brotli + gzip pazarlığı yapmak yeterli.
6
+ * Brotli tercih edilir: ana sayfa HTML'inde gzip'e göre ~%35 daha küçük.
7
+ */
8
+ import zlib from "node:zlib";
9
+ import { Writable } from "node:stream";
10
+
11
+ /** Bu eşiğin altındaki gövdelerde sıkıştırma kazancı yok. */
12
+ const THRESHOLD_BYTES = 1024;
13
+
14
+ const COMPRESSIBLE =
15
+ /^(?:text\/|application\/(?:json|javascript|xml|xhtml\+xml|rss\+xml|atom\+xml|ld\+json|manifest\+json)|image\/svg\+xml)/i;
16
+
17
+ const BROTLI_OPTIONS = {
18
+ params: {
19
+ // Metin için 5, varsayılan 11'e göre çok daha hızlı ve neredeyse aynı boyut.
20
+ [zlib.constants.BROTLI_PARAM_QUALITY]: 5,
21
+ [zlib.constants.BROTLI_PARAM_MODE]: zlib.constants.BROTLI_MODE_TEXT,
22
+ },
23
+ };
24
+
25
+ /**
26
+ * @param {string} header
27
+ * @returns {"br" | "gzip" | null}
28
+ */
29
+ function negotiate(header) {
30
+ if (!header) return null;
31
+
32
+ /** @type {Map<string, number>} */
33
+ const weights = new Map();
34
+
35
+ for (const part of header.split(",")) {
36
+ const [name, ...params] = part.trim().split(";");
37
+ const q = params
38
+ .map((p) => p.trim())
39
+ .find((p) => p.startsWith("q="));
40
+
41
+ weights.set(name.toLowerCase(), q ? Number(q.slice(2)) : 1);
42
+ }
43
+
44
+ if ((weights.get("br") ?? 0) > 0) return "br";
45
+ if ((weights.get("gzip") ?? 0) > 0) return "gzip";
46
+ return null;
47
+ }
48
+
49
+ /**
50
+ * İçeriği bir kez sıkıştırıp saklamak isteyen çağıranlar için (HTML cache).
51
+ *
52
+ * @param {string | undefined} acceptEncoding
53
+ * @returns {"br" | "gzip" | null}
54
+ */
55
+ export function negotiateEncoding(acceptEncoding) {
56
+ return negotiate(acceptEncoding ?? "");
57
+ }
58
+
59
+ /**
60
+ * @param {string} text
61
+ * @param {"br" | "gzip"} encoding
62
+ * @returns {Promise<Buffer>}
63
+ */
64
+ export function encodeText(text, encoding) {
65
+ const input = Buffer.from(text, "utf8");
66
+
67
+ return new Promise((resolve, reject) => {
68
+ const done = (error, result) => (error ? reject(error) : resolve(result));
69
+
70
+ if (encoding === "br") zlib.brotliCompress(input, BROTLI_OPTIONS, done);
71
+ else zlib.gzip(input, done);
72
+ });
73
+ }
74
+
75
+ /**
76
+ * @param {import('http').ServerResponse} res
77
+ * @returns {boolean}
78
+ */
79
+ function shouldCompress(res) {
80
+ if (res.getHeader("content-encoding")) return false;
81
+ if (res.getHeader("cache-control")?.toString().includes("no-transform")) {
82
+ return false;
83
+ }
84
+
85
+ const type = res.getHeader("content-type")?.toString() ?? "";
86
+ if (type.includes("text/event-stream")) return false;
87
+ if (!COMPRESSIBLE.test(type)) return false;
88
+
89
+ const length = Number(res.getHeader("content-length"));
90
+ return Number.isNaN(length) || length >= THRESHOLD_BYTES;
91
+ }
92
+
93
+ /**
94
+ * @returns {import('express').RequestHandler}
95
+ */
96
+ export function compression() {
97
+ return (req, res, next) => {
98
+ // HEAD gövdesi yok; zaten sıkışık ikili içerik boşuna CPU yakar.
99
+ const encoding = req.method === "HEAD" ? null : negotiate(req.headers["accept-encoding"]);
100
+
101
+ const originalWrite = res.write.bind(res);
102
+ const originalEnd = res.end.bind(res);
103
+
104
+ /** @type {import('zlib').Gzip | import('zlib').BrotliCompress | null} */
105
+ let stream = null;
106
+ let decided = false;
107
+ let passthrough = false;
108
+
109
+ function decide() {
110
+ if (decided) return;
111
+ decided = true;
112
+
113
+ // SSE gibi akışlar başlıkları kendileri yazar (`writeHead`); bu noktada
114
+ // başlık eklemek çökme sebebi olur, sıkıştırma da anlamsızdır.
115
+ if (res.headersSent) {
116
+ passthrough = true;
117
+ return;
118
+ }
119
+
120
+ // Vary her durumda: aynı URL farklı encoding ile cache'lenebilir.
121
+ res.setHeader("Vary", appendVary(res.getHeader("Vary"), "Accept-Encoding"));
122
+
123
+ if (!encoding || !shouldCompress(res)) {
124
+ passthrough = true;
125
+ return;
126
+ }
127
+
128
+ res.setHeader("Content-Encoding", encoding);
129
+ res.removeHeader("Content-Length");
130
+
131
+ stream =
132
+ encoding === "br"
133
+ ? zlib.createBrotliCompress(BROTLI_OPTIONS)
134
+ : zlib.createGzip({ level: 6 });
135
+
136
+ // Sıkıştırılmış çıktıyı sokete geri baskıya saygı duyarak aktar.
137
+ stream.pipe(
138
+ new Writable({
139
+ write(chunk, chunkEncoding, callback) {
140
+ originalWrite(chunk, chunkEncoding, callback);
141
+ },
142
+ final(callback) {
143
+ originalEnd();
144
+ callback();
145
+ },
146
+ }),
147
+ );
148
+
149
+ // `express.static` gövdeyi `pipe` ile yazar ve `res.write()` false
150
+ // dönerse `drain` bekler; zlib doldu-boşaldı sinyalini yansıtmazsak
151
+ // aktarım sessizce askıda kalır.
152
+ stream.on("drain", () => res.emit("drain"));
153
+ stream.on("error", () => originalEnd());
154
+ }
155
+
156
+ res.write = function write(chunk, encodingArg, callback) {
157
+ decide();
158
+ if (passthrough) return originalWrite(chunk, encodingArg, callback);
159
+ if (!chunk) return true;
160
+
161
+ return stream.write(toBuffer(chunk, encodingArg), callback);
162
+ };
163
+
164
+ res.end = function end(chunk, encodingArg, callback) {
165
+ decide();
166
+ if (passthrough) return originalEnd(chunk, encodingArg, callback);
167
+
168
+ if (chunk && typeof chunk !== "function") {
169
+ stream.end(toBuffer(chunk, encodingArg), callback);
170
+ } else {
171
+ stream.end();
172
+ }
173
+
174
+ return res;
175
+ };
176
+
177
+ next();
178
+ };
179
+ }
180
+
181
+ /**
182
+ * @param {unknown} chunk
183
+ * @param {unknown} encodingArg
184
+ * @returns {Buffer}
185
+ */
186
+ function toBuffer(chunk, encodingArg) {
187
+ if (Buffer.isBuffer(chunk)) return chunk;
188
+ return Buffer.from(
189
+ /** @type {string} */ (chunk),
190
+ typeof encodingArg === "string" ? /** @type {BufferEncoding} */ (encodingArg) : "utf8",
191
+ );
192
+ }
193
+
194
+ /**
195
+ * @param {unknown} current
196
+ * @param {string} field
197
+ * @returns {string}
198
+ */
199
+ function appendVary(current, field) {
200
+ const existing = current ? String(current) : "";
201
+ if (!existing) return field;
202
+
203
+ const parts = existing.split(",").map((p) => p.trim().toLowerCase());
204
+ return parts.includes(field.toLowerCase()) ? existing : `${existing}, ${field}`;
205
+ }