jskelet 0.6.3 → 0.6.4

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 (153) hide show
  1. package/AGENTS.md +136 -136
  2. package/CHANGELOG.md +628 -620
  3. package/LICENSE +21 -21
  4. package/README.md +2 -0
  5. package/bin/jskelet.mjs +130 -130
  6. package/docs/01-baslangic.md +291 -291
  7. package/docs/02-mimari.md +310 -310
  8. package/docs/03-routing.md +515 -515
  9. package/docs/04-render-ve-sablonlar.md +667 -661
  10. package/docs/05-islands.md +486 -486
  11. package/docs/06-cache.md +1467 -1443
  12. package/docs/07-yapilandirma.md +1208 -1197
  13. package/docs/08-build.md +429 -429
  14. package/docs/09-dev-araclari.md +364 -364
  15. package/docs/10-dagitim.md +348 -338
  16. package/docs/12-panel-ve-oturum.md +479 -478
  17. package/docs/README.md +83 -83
  18. package/docs/en/01-getting-started.md +298 -298
  19. package/docs/en/02-architecture.md +329 -329
  20. package/docs/en/03-routing.md +531 -531
  21. package/docs/en/04-rendering.md +675 -669
  22. package/docs/en/05-islands.md +497 -497
  23. package/docs/en/06-caching.md +1476 -1453
  24. package/docs/en/07-configuration.md +1229 -1219
  25. package/docs/en/08-build.md +447 -447
  26. package/docs/en/09-dev-tools.md +373 -373
  27. package/docs/en/10-deployment.md +351 -340
  28. package/docs/en/11-migration.md +398 -398
  29. package/docs/en/12-dashboards-and-sessions.md +489 -488
  30. package/docs/en/README.md +87 -87
  31. package/package.json +137 -137
  32. package/src/build/ensure-build.mjs +19 -19
  33. package/src/build/paths.mjs +153 -153
  34. package/src/build/resolve-peer.mjs +36 -36
  35. package/src/build/tasks/client.mjs +349 -349
  36. package/src/build/tasks/css.mjs +235 -235
  37. package/src/build/tasks/fonts.mjs +146 -146
  38. package/src/build/tasks/icons.mjs +357 -357
  39. package/src/build/tasks/images.mjs +244 -244
  40. package/src/build/tasks/precompress.mjs +78 -78
  41. package/src/build/tasks/templates.mjs +20 -20
  42. package/src/client/admin/i18n.js +764 -764
  43. package/src/client/admin/login.html +74 -74
  44. package/src/client/admin/panel.css +809 -809
  45. package/src/client/admin/panel.html +495 -495
  46. package/src/client/admin/panel.js +1251 -1251
  47. package/src/client/devtools/report.html +185 -185
  48. package/src/client/devtools/report.js +745 -745
  49. package/src/client/devtools/seo.js +628 -628
  50. package/src/client/dom.js +95 -95
  51. package/src/client/form.js +192 -192
  52. package/src/client/index.js +45 -45
  53. package/src/client/registry.js +305 -305
  54. package/src/client/safe-image.js +91 -91
  55. package/src/client/shared-cookie.js +225 -225
  56. package/src/client/store.js +36 -36
  57. package/src/client/swap.js +188 -188
  58. package/src/compile/codegen.js +336 -336
  59. package/src/compile/compile-all.js +149 -149
  60. package/src/compile/errors.js +66 -66
  61. package/src/compile/expr.js +409 -409
  62. package/src/compile/index.js +17 -17
  63. package/src/compile/parse.js +541 -541
  64. package/src/compile/resolve.js +211 -211
  65. package/src/compile/scan-exports.js +51 -51
  66. package/src/config/defaults.js +541 -534
  67. package/src/config/index.js +1500 -1469
  68. package/src/config/pattern.js +107 -107
  69. package/src/generate.mjs +163 -163
  70. package/src/http/control-flow.js +71 -71
  71. package/src/http/cookies-entry.js +21 -21
  72. package/src/http/cookies.js +277 -277
  73. package/src/http/request-cache.js +46 -46
  74. package/src/http/request-context.js +165 -165
  75. package/src/http/shared-cookie.js +178 -178
  76. package/src/index.js +101 -101
  77. package/src/init.mjs +232 -230
  78. package/src/migrate/apply.mjs +262 -262
  79. package/src/migrate/babel.mjs +79 -79
  80. package/src/migrate/classify.mjs +155 -155
  81. package/src/migrate/config.mjs +126 -126
  82. package/src/migrate/fs-walk.mjs +191 -191
  83. package/src/migrate/parse.mjs +26 -26
  84. package/src/migrate/scan.mjs +177 -177
  85. package/src/migrate/transform/expr-source.mjs +168 -168
  86. package/src/migrate/transform/island.mjs +67 -67
  87. package/src/migrate/transform/jsx-to-component.mjs +302 -302
  88. package/src/migrate/transform/jsx-to-jsk.mjs +330 -330
  89. package/src/migrate/transform/page-split.mjs +435 -435
  90. package/src/migrate/write.mjs +81 -81
  91. package/src/migrate.mjs +171 -171
  92. package/src/runtime/alias-hooks.mjs +119 -119
  93. package/src/runtime/register.mjs +4 -4
  94. package/src/server/admin/actions.js +229 -229
  95. package/src/server/admin/auth.js +125 -125
  96. package/src/server/admin/event-log.js +151 -151
  97. package/src/server/admin/gate.js +209 -209
  98. package/src/server/admin/inventory.js +188 -188
  99. package/src/server/admin/mount.js +56 -56
  100. package/src/server/admin/router.js +216 -216
  101. package/src/server/admin/snapshot.js +241 -241
  102. package/src/server/assets.js +147 -147
  103. package/src/server/auth/handoff.js +309 -309
  104. package/src/server/cache-blob.js +70 -70
  105. package/src/server/cache-control.js +45 -0
  106. package/src/server/cache-deps.js +42 -42
  107. package/src/server/cache-vary.js +113 -113
  108. package/src/server/cloudflare.js +607 -607
  109. package/src/server/create-app.js +366 -366
  110. package/src/server/data-cache.js +553 -553
  111. package/src/server/dev/report.js +485 -485
  112. package/src/server/dev/socket.js +170 -170
  113. package/src/server/dev/version-check.mjs +139 -139
  114. package/src/server/disk-cache.js +233 -233
  115. package/src/server/ejs-adapter.js +59 -59
  116. package/src/server/html-cache.js +1196 -1196
  117. package/src/server/image-optimizer.js +500 -500
  118. package/src/server/logs/access-middleware.js +66 -66
  119. package/src/server/logs/file-sink.js +193 -193
  120. package/src/server/logs/pipeline.js +165 -165
  121. package/src/server/logs/s3-put.js +214 -214
  122. package/src/server/logs/s3-sink.js +112 -112
  123. package/src/server/metadata.js +102 -102
  124. package/src/server/middleware/compression.js +205 -205
  125. package/src/server/middleware/csrf.js +134 -134
  126. package/src/server/middleware/dev-gate.js +75 -75
  127. package/src/server/middleware/headers.js +37 -37
  128. package/src/server/middleware/redirects.js +32 -32
  129. package/src/server/middleware/robots-txt.js +341 -341
  130. package/src/server/middleware/static-precompressed.js +121 -121
  131. package/src/server/middleware/trailing-slash.js +53 -53
  132. package/src/server/middleware/upstream-proxy.js +141 -141
  133. package/src/server/og-image.js +369 -356
  134. package/src/server/port-guard.js +255 -255
  135. package/src/server/prewarm.js +1082 -1082
  136. package/src/server/redis.js +588 -588
  137. package/src/server/render.js +910 -910
  138. package/src/server/router.js +157 -157
  139. package/src/server/status-page.js +265 -265
  140. package/src/server/upstream-limiter.js +376 -376
  141. package/src/server/upstream-tracking.js +166 -166
  142. package/src/shared/cookie-domain.js +66 -66
  143. package/src/start.mjs +22 -22
  144. package/src/templates/layout.ejs +30 -30
  145. package/src/templates/layout.jsk +30 -30
  146. package/src/version.mjs +31 -31
  147. package/src/views/components/loader.js +101 -101
  148. package/src/views/helpers/html.js +102 -102
  149. package/src/views/helpers/tags.js +375 -375
  150. package/types/config/defaults.d.ts +6 -0
  151. package/types/config/index.d.ts +6 -0
  152. package/types/server/cache-control.d.ts +28 -0
  153. package/types/server/og-image.d.ts +5 -0
@@ -1,216 +1,216 @@
1
- /**
2
- * Admin paneli Express router'ı.
3
- */
4
- import fs from "node:fs";
5
- import path from "node:path";
6
- import express from "express";
7
- import { FRAMEWORK_ROOT } from "../../config/index.js";
8
- import {
9
- ACTION_HEADER,
10
- authenticated,
11
- clearSessionCookie,
12
- createSession,
13
- destroySession,
14
- passwordMatches,
15
- sessionCookie,
16
- } from "./auth.js";
17
- import { clearOffender, gateMiddleware, noteFailure } from "./gate.js";
18
- import { snapshot } from "./snapshot.js";
19
- import { runAction } from "./actions.js";
20
- import {
21
- list as listLogs,
22
- subscribeLive,
23
- } from "./event-log.js";
24
- import {
25
- listExpressRoutes,
26
- listRouteModules,
27
- listViews,
28
- routeActivity,
29
- } from "./inventory.js";
30
- import {
31
- cloudflareConfigured,
32
- fetchCacheAnalytics,
33
- fetchCloudflareOverview,
34
- fetchPathEdges,
35
- } from "../cloudflare.js";
36
-
37
- const PANEL_DIR = path.join(FRAMEWORK_ROOT, "src", "client", "admin");
38
-
39
- /**
40
- * @param {() => typeof import('../../config/defaults.js').DEFAULT_ADMIN} getSettings
41
- * @param {import('express').Express} app
42
- * @returns {import('express').Router}
43
- */
44
- export function createAdminRouter(getSettings, app) {
45
- const api = express.Router();
46
-
47
- api.use((req, res, next) => {
48
- res.setHeader("Cache-Control", "no-store, no-cache, must-revalidate");
49
- res.setHeader("X-Robots-Tag", "noindex, nofollow, noarchive, nosnippet");
50
- res.setHeader("Referrer-Policy", "no-referrer");
51
- next();
52
- });
53
-
54
- api.use(gateMiddleware(getSettings));
55
-
56
- // Soft page routes → aynı shell (client path ile sekme seçer).
57
- // JSON API'ler ayrı `/api/*` altında: `/logs` hem sayfa hem döküm olamaz.
58
- const shellPages = ["/", "/cache", "/routes", "/views", "/logs", "/system"];
59
- for (const page of shellPages) {
60
- api.get(page, (req, res) => {
61
- const settings = getSettings();
62
- const bare = req.originalUrl.split("?")[0];
63
- if (page === "/" && !bare.endsWith("/")) {
64
- res.redirect(302, `${settings.basePath}/`);
65
- return;
66
- }
67
-
68
- res.type("html");
69
- sendFile(res, authenticated(req) ? "panel.html" : "login.html");
70
- });
71
- }
72
-
73
- api.get("/panel.css", (req, res) => {
74
- res.type("text/css");
75
- sendFile(res, "panel.css");
76
- });
77
-
78
- api.get("/i18n.js", (req, res) => {
79
- res.type("application/javascript");
80
- sendFile(res, "i18n.js");
81
- });
82
-
83
- api.get("/logo.png", (req, res) => {
84
- res.type("image/png");
85
- fs.createReadStream(path.join(FRAMEWORK_ROOT, "src", "logo.png")).pipe(res);
86
- });
87
-
88
- api.post("/login", express.json({ limit: "4kb" }), (req, res) => {
89
- const settings = getSettings();
90
- const password = typeof req.body?.password === "string" ? req.body.password : "";
91
-
92
- if (!passwordMatches(password)) {
93
- noteFailure(req, password ? "wrong password" : "empty password", settings);
94
- res.status(401).json({ ok: false, message: "Invalid password" });
95
- return;
96
- }
97
-
98
- const { token, maxAge } = createSession(settings.sessionHours);
99
- clearOffender(req);
100
- res.setHeader("Set-Cookie", sessionCookie(settings.basePath, token, maxAge));
101
- res.json({ ok: true });
102
- });
103
-
104
- api.use((req, res, next) => {
105
- if (authenticated(req)) return next();
106
-
107
- if (req.method !== "GET" && req.method !== "HEAD") {
108
- noteFailure(req, `unauthenticated ${req.method} ${req.path}`, getSettings());
109
- }
110
-
111
- res.status(404).type("text/plain").send("Not Found");
112
- });
113
-
114
- api.post("/logout", (req, res) => {
115
- const settings = getSettings();
116
- destroySession(req);
117
- res.setHeader("Set-Cookie", clearSessionCookie(settings.basePath));
118
- res.json({ ok: true });
119
- });
120
-
121
- api.get("/panel.js", (req, res) => {
122
- res.type("application/javascript");
123
- sendFile(res, "panel.js");
124
- });
125
-
126
- api.get("/data", async (req, res) => {
127
- const query = typeof req.query.q === "string" ? req.query.q : "";
128
- res.json(await snapshot(query));
129
- });
130
-
131
- api.get("/api/routes", (req, res) => {
132
- res.json({
133
- routes: listExpressRoutes(app),
134
- modules: listRouteModules(),
135
- activity: routeActivity(),
136
- });
137
- });
138
-
139
- api.get("/api/views", (req, res) => {
140
- res.json({ views: listViews() });
141
- });
142
-
143
- api.get("/api/logs", (req, res) => {
144
- const after = Number(req.query.after) || 0;
145
- const limit = Number(req.query.limit) || 200;
146
- res.json({ entries: listLogs(after, limit) });
147
- });
148
-
149
- api.get("/api/logs/stream", (req, res) => {
150
- res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
151
- res.setHeader("Cache-Control", "no-store, no-cache");
152
- res.setHeader("Connection", "keep-alive");
153
- res.flushHeaders?.();
154
-
155
- const replay = listLogs(0, 100);
156
- for (const entry of replay) {
157
- res.write(`data: ${JSON.stringify(entry)}\n\n`);
158
- }
159
-
160
- const unsubscribe = subscribeLive((entry) => {
161
- res.write(`data: ${JSON.stringify(entry)}\n\n`);
162
- });
163
-
164
- const heartbeat = setInterval(() => {
165
- res.write(": ping\n\n");
166
- }, 15000);
167
-
168
- req.on("close", () => {
169
- clearInterval(heartbeat);
170
- unsubscribe();
171
- });
172
- });
173
-
174
- api.get("/cloudflare", async (req, res) => {
175
- res.json(await fetchCloudflareOverview({ force: req.query.force === "1" }));
176
- });
177
-
178
- api.post("/cloudflare/analytics", express.json({ limit: "8kb" }), async (req, res) => {
179
- if (!cloudflareConfigured()) {
180
- res.json({ ok: false, error: "not configured" });
181
- return;
182
- }
183
-
184
- const hours = Number(req.body?.hours) || undefined;
185
- const pathValue = typeof req.body?.path === "string" ? req.body.path.trim() : "";
186
- res.json(
187
- pathValue
188
- ? await fetchPathEdges({ path: pathValue, hours })
189
- : await fetchCacheAnalytics({ hours }),
190
- );
191
- });
192
-
193
- api.post("/action", express.json({ limit: "64kb" }), async (req, res) => {
194
- if (req.get(ACTION_HEADER) !== "1") {
195
- res.status(404).type("text/plain").send("Not Found");
196
- return;
197
- }
198
-
199
- try {
200
- res.json(await runAction(req.body ?? {}, req));
201
- } catch (error) {
202
- console.error("[admin] action failed", error);
203
- res.status(500).json({ ok: false, message: "Action failed, see server logs" });
204
- }
205
- });
206
-
207
- return api;
208
- }
209
-
210
- /**
211
- * @param {import('express').Response} res
212
- * @param {string} name
213
- */
214
- function sendFile(res, name) {
215
- fs.createReadStream(path.join(PANEL_DIR, name)).pipe(res);
216
- }
1
+ /**
2
+ * Admin paneli Express router'ı.
3
+ */
4
+ import fs from "node:fs";
5
+ import path from "node:path";
6
+ import express from "express";
7
+ import { FRAMEWORK_ROOT } from "../../config/index.js";
8
+ import {
9
+ ACTION_HEADER,
10
+ authenticated,
11
+ clearSessionCookie,
12
+ createSession,
13
+ destroySession,
14
+ passwordMatches,
15
+ sessionCookie,
16
+ } from "./auth.js";
17
+ import { clearOffender, gateMiddleware, noteFailure } from "./gate.js";
18
+ import { snapshot } from "./snapshot.js";
19
+ import { runAction } from "./actions.js";
20
+ import {
21
+ list as listLogs,
22
+ subscribeLive,
23
+ } from "./event-log.js";
24
+ import {
25
+ listExpressRoutes,
26
+ listRouteModules,
27
+ listViews,
28
+ routeActivity,
29
+ } from "./inventory.js";
30
+ import {
31
+ cloudflareConfigured,
32
+ fetchCacheAnalytics,
33
+ fetchCloudflareOverview,
34
+ fetchPathEdges,
35
+ } from "../cloudflare.js";
36
+
37
+ const PANEL_DIR = path.join(FRAMEWORK_ROOT, "src", "client", "admin");
38
+
39
+ /**
40
+ * @param {() => typeof import('../../config/defaults.js').DEFAULT_ADMIN} getSettings
41
+ * @param {import('express').Express} app
42
+ * @returns {import('express').Router}
43
+ */
44
+ export function createAdminRouter(getSettings, app) {
45
+ const api = express.Router();
46
+
47
+ api.use((req, res, next) => {
48
+ res.setHeader("Cache-Control", "no-store, no-cache, must-revalidate");
49
+ res.setHeader("X-Robots-Tag", "noindex, nofollow, noarchive, nosnippet");
50
+ res.setHeader("Referrer-Policy", "no-referrer");
51
+ next();
52
+ });
53
+
54
+ api.use(gateMiddleware(getSettings));
55
+
56
+ // Soft page routes → aynı shell (client path ile sekme seçer).
57
+ // JSON API'ler ayrı `/api/*` altında: `/logs` hem sayfa hem döküm olamaz.
58
+ const shellPages = ["/", "/cache", "/routes", "/views", "/logs", "/system"];
59
+ for (const page of shellPages) {
60
+ api.get(page, (req, res) => {
61
+ const settings = getSettings();
62
+ const bare = req.originalUrl.split("?")[0];
63
+ if (page === "/" && !bare.endsWith("/")) {
64
+ res.redirect(302, `${settings.basePath}/`);
65
+ return;
66
+ }
67
+
68
+ res.type("html");
69
+ sendFile(res, authenticated(req) ? "panel.html" : "login.html");
70
+ });
71
+ }
72
+
73
+ api.get("/panel.css", (req, res) => {
74
+ res.type("text/css");
75
+ sendFile(res, "panel.css");
76
+ });
77
+
78
+ api.get("/i18n.js", (req, res) => {
79
+ res.type("application/javascript");
80
+ sendFile(res, "i18n.js");
81
+ });
82
+
83
+ api.get("/logo.png", (req, res) => {
84
+ res.type("image/png");
85
+ fs.createReadStream(path.join(FRAMEWORK_ROOT, "src", "logo.png")).pipe(res);
86
+ });
87
+
88
+ api.post("/login", express.json({ limit: "4kb" }), (req, res) => {
89
+ const settings = getSettings();
90
+ const password = typeof req.body?.password === "string" ? req.body.password : "";
91
+
92
+ if (!passwordMatches(password)) {
93
+ noteFailure(req, password ? "wrong password" : "empty password", settings);
94
+ res.status(401).json({ ok: false, message: "Invalid password" });
95
+ return;
96
+ }
97
+
98
+ const { token, maxAge } = createSession(settings.sessionHours);
99
+ clearOffender(req);
100
+ res.setHeader("Set-Cookie", sessionCookie(settings.basePath, token, maxAge));
101
+ res.json({ ok: true });
102
+ });
103
+
104
+ api.use((req, res, next) => {
105
+ if (authenticated(req)) return next();
106
+
107
+ if (req.method !== "GET" && req.method !== "HEAD") {
108
+ noteFailure(req, `unauthenticated ${req.method} ${req.path}`, getSettings());
109
+ }
110
+
111
+ res.status(404).type("text/plain").send("Not Found");
112
+ });
113
+
114
+ api.post("/logout", (req, res) => {
115
+ const settings = getSettings();
116
+ destroySession(req);
117
+ res.setHeader("Set-Cookie", clearSessionCookie(settings.basePath));
118
+ res.json({ ok: true });
119
+ });
120
+
121
+ api.get("/panel.js", (req, res) => {
122
+ res.type("application/javascript");
123
+ sendFile(res, "panel.js");
124
+ });
125
+
126
+ api.get("/data", async (req, res) => {
127
+ const query = typeof req.query.q === "string" ? req.query.q : "";
128
+ res.json(await snapshot(query));
129
+ });
130
+
131
+ api.get("/api/routes", (req, res) => {
132
+ res.json({
133
+ routes: listExpressRoutes(app),
134
+ modules: listRouteModules(),
135
+ activity: routeActivity(),
136
+ });
137
+ });
138
+
139
+ api.get("/api/views", (req, res) => {
140
+ res.json({ views: listViews() });
141
+ });
142
+
143
+ api.get("/api/logs", (req, res) => {
144
+ const after = Number(req.query.after) || 0;
145
+ const limit = Number(req.query.limit) || 200;
146
+ res.json({ entries: listLogs(after, limit) });
147
+ });
148
+
149
+ api.get("/api/logs/stream", (req, res) => {
150
+ res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
151
+ res.setHeader("Cache-Control", "no-store, no-cache");
152
+ res.setHeader("Connection", "keep-alive");
153
+ res.flushHeaders?.();
154
+
155
+ const replay = listLogs(0, 100);
156
+ for (const entry of replay) {
157
+ res.write(`data: ${JSON.stringify(entry)}\n\n`);
158
+ }
159
+
160
+ const unsubscribe = subscribeLive((entry) => {
161
+ res.write(`data: ${JSON.stringify(entry)}\n\n`);
162
+ });
163
+
164
+ const heartbeat = setInterval(() => {
165
+ res.write(": ping\n\n");
166
+ }, 15000);
167
+
168
+ req.on("close", () => {
169
+ clearInterval(heartbeat);
170
+ unsubscribe();
171
+ });
172
+ });
173
+
174
+ api.get("/cloudflare", async (req, res) => {
175
+ res.json(await fetchCloudflareOverview({ force: req.query.force === "1" }));
176
+ });
177
+
178
+ api.post("/cloudflare/analytics", express.json({ limit: "8kb" }), async (req, res) => {
179
+ if (!cloudflareConfigured()) {
180
+ res.json({ ok: false, error: "not configured" });
181
+ return;
182
+ }
183
+
184
+ const hours = Number(req.body?.hours) || undefined;
185
+ const pathValue = typeof req.body?.path === "string" ? req.body.path.trim() : "";
186
+ res.json(
187
+ pathValue
188
+ ? await fetchPathEdges({ path: pathValue, hours })
189
+ : await fetchCacheAnalytics({ hours }),
190
+ );
191
+ });
192
+
193
+ api.post("/action", express.json({ limit: "64kb" }), async (req, res) => {
194
+ if (req.get(ACTION_HEADER) !== "1") {
195
+ res.status(404).type("text/plain").send("Not Found");
196
+ return;
197
+ }
198
+
199
+ try {
200
+ res.json(await runAction(req.body ?? {}, req));
201
+ } catch (error) {
202
+ console.error("[admin] action failed", error);
203
+ res.status(500).json({ ok: false, message: "Action failed, see server logs" });
204
+ }
205
+ });
206
+
207
+ return api;
208
+ }
209
+
210
+ /**
211
+ * @param {import('express').Response} res
212
+ * @param {string} name
213
+ */
214
+ function sendFile(res, name) {
215
+ fs.createReadStream(path.join(PANEL_DIR, name)).pipe(res);
216
+ }