@weft-framework/server 0.0.0-stage → 0.0.1

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 (175) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +4 -2
  3. package/dist/account.d.ts +124 -0
  4. package/dist/account.js +344 -0
  5. package/dist/action.d.ts +43 -0
  6. package/dist/action.js +135 -0
  7. package/dist/admin.d.ts +99 -0
  8. package/dist/admin.js +431 -0
  9. package/dist/api.d.ts +21 -0
  10. package/dist/api.js +72 -0
  11. package/dist/app.d.ts +202 -0
  12. package/dist/app.js +3692 -0
  13. package/dist/assets.d.ts +4 -0
  14. package/dist/assets.js +91 -0
  15. package/dist/auth.d.ts +150 -0
  16. package/dist/auth.js +215 -0
  17. package/dist/backup.d.ts +46 -0
  18. package/dist/backup.js +345 -0
  19. package/dist/build.d.ts +33 -0
  20. package/dist/build.js +274 -0
  21. package/dist/bun.d.ts +30 -0
  22. package/dist/bun.js +53 -0
  23. package/dist/calendar.d.ts +161 -0
  24. package/dist/calendar.js +690 -0
  25. package/dist/compiler.d.ts +13 -0
  26. package/dist/compiler.js +58 -0
  27. package/dist/compress.d.ts +6 -0
  28. package/dist/compress.js +78 -0
  29. package/dist/config.d.ts +26 -0
  30. package/dist/config.js +317 -0
  31. package/dist/context.d.ts +9 -0
  32. package/dist/context.js +1 -0
  33. package/dist/contract.d.ts +18 -0
  34. package/dist/contract.js +171 -0
  35. package/dist/datamap.d.ts +24 -0
  36. package/dist/datamap.js +365 -0
  37. package/dist/db-backup.d.ts +27 -0
  38. package/dist/db-backup.js +115 -0
  39. package/dist/dev-events.d.ts +14 -0
  40. package/dist/dev-events.js +135 -0
  41. package/dist/dev.d.ts +1 -0
  42. package/dist/dev.js +240 -0
  43. package/dist/devtools-client.d.ts +1 -0
  44. package/dist/devtools-client.js +362 -0
  45. package/dist/devtools.d.ts +87 -0
  46. package/dist/devtools.js +68 -0
  47. package/dist/edge.d.ts +3 -0
  48. package/dist/edge.js +7 -0
  49. package/dist/email-signin.d.ts +92 -0
  50. package/dist/email-signin.js +259 -0
  51. package/dist/env.d.ts +1 -0
  52. package/dist/env.js +15 -0
  53. package/dist/explain.d.ts +12 -0
  54. package/dist/explain.js +217 -0
  55. package/dist/files.d.ts +6 -0
  56. package/dist/files.js +170 -0
  57. package/dist/grants.d.ts +69 -0
  58. package/dist/grants.js +206 -0
  59. package/dist/image/bitmap.d.ts +11 -0
  60. package/dist/image/bitmap.js +172 -0
  61. package/dist/image/jpeg.d.ts +10 -0
  62. package/dist/image/jpeg.js +697 -0
  63. package/dist/image/png.d.ts +8 -0
  64. package/dist/image/png.js +282 -0
  65. package/dist/image/transform.d.ts +20 -0
  66. package/dist/image/transform.js +52 -0
  67. package/dist/image/worker.d.ts +1 -0
  68. package/dist/image/worker.js +11 -0
  69. package/dist/images.d.ts +39 -0
  70. package/dist/images.js +283 -0
  71. package/dist/index.d.ts +64 -0
  72. package/dist/index.js +31 -0
  73. package/dist/inspect-hub.d.ts +42 -0
  74. package/dist/inspect-hub.js +14 -0
  75. package/dist/inspector.d.ts +51 -0
  76. package/dist/inspector.js +193 -0
  77. package/dist/job-admin.d.ts +55 -0
  78. package/dist/job-admin.js +89 -0
  79. package/dist/jobs.d.ts +222 -0
  80. package/dist/jobs.js +789 -0
  81. package/dist/live.d.ts +72 -0
  82. package/dist/live.js +481 -0
  83. package/dist/load-config.d.ts +2 -0
  84. package/dist/load-config.js +41 -0
  85. package/dist/log.d.ts +20 -0
  86. package/dist/log.js +143 -0
  87. package/dist/mail.d.ts +189 -0
  88. package/dist/mail.js +999 -0
  89. package/dist/media.d.ts +129 -0
  90. package/dist/media.js +470 -0
  91. package/dist/meta.d.ts +54 -0
  92. package/dist/meta.js +146 -0
  93. package/dist/middleware.d.ts +20 -0
  94. package/dist/middleware.js +101 -0
  95. package/dist/migrate.d.ts +12 -0
  96. package/dist/migrate.js +88 -0
  97. package/dist/node.d.ts +26 -0
  98. package/dist/node.js +96 -0
  99. package/dist/notice.d.ts +21 -0
  100. package/dist/notice.js +48 -0
  101. package/dist/npm.d.ts +16 -0
  102. package/dist/npm.js +347 -0
  103. package/dist/oauth.d.ts +76 -0
  104. package/dist/oauth.js +408 -0
  105. package/dist/otel.d.ts +57 -0
  106. package/dist/otel.js +293 -0
  107. package/dist/passkey.d.ts +99 -0
  108. package/dist/passkey.js +572 -0
  109. package/dist/password.d.ts +8 -0
  110. package/dist/password.js +65 -0
  111. package/dist/pdf.d.ts +46 -0
  112. package/dist/pdf.js +332 -0
  113. package/dist/personal-data.d.ts +22 -0
  114. package/dist/personal-data.js +148 -0
  115. package/dist/pointers.d.ts +9 -0
  116. package/dist/pointers.js +148 -0
  117. package/dist/postcss.d.ts +3 -0
  118. package/dist/postcss.js +89 -0
  119. package/dist/presence.d.ts +27 -0
  120. package/dist/presence.js +161 -0
  121. package/dist/preview.d.ts +25 -0
  122. package/dist/preview.js +353 -0
  123. package/dist/production.d.ts +16 -0
  124. package/dist/production.js +119 -0
  125. package/dist/project.d.ts +23 -0
  126. package/dist/project.js +536 -0
  127. package/dist/regions.d.ts +47 -0
  128. package/dist/regions.js +511 -0
  129. package/dist/replay.d.ts +44 -0
  130. package/dist/replay.js +259 -0
  131. package/dist/router.d.ts +29 -0
  132. package/dist/router.js +146 -0
  133. package/dist/rules-diff.d.ts +18 -0
  134. package/dist/rules-diff.js +165 -0
  135. package/dist/rules-test.d.ts +17 -0
  136. package/dist/rules-test.js +108 -0
  137. package/dist/saml.d.ts +160 -0
  138. package/dist/saml.js +959 -0
  139. package/dist/seal.d.ts +35 -0
  140. package/dist/seal.js +107 -0
  141. package/dist/secret.d.ts +14 -0
  142. package/dist/secret.js +110 -0
  143. package/dist/security.d.ts +53 -0
  144. package/dist/security.js +250 -0
  145. package/dist/seed.d.ts +16 -0
  146. package/dist/seed.js +94 -0
  147. package/dist/seo.d.ts +42 -0
  148. package/dist/seo.js +175 -0
  149. package/dist/settings.d.ts +79 -0
  150. package/dist/settings.js +212 -0
  151. package/dist/shared.d.ts +15 -0
  152. package/dist/shared.js +283 -0
  153. package/dist/shell.d.ts +12 -0
  154. package/dist/shell.js +118 -0
  155. package/dist/storage.d.ts +13 -0
  156. package/dist/storage.js +55 -0
  157. package/dist/support.d.ts +83 -0
  158. package/dist/support.js +236 -0
  159. package/dist/sync.d.ts +35 -0
  160. package/dist/sync.js +167 -0
  161. package/dist/tailwind.d.ts +14 -0
  162. package/dist/tailwind.js +117 -0
  163. package/dist/two-factor.d.ts +103 -0
  164. package/dist/two-factor.js +435 -0
  165. package/dist/uploads.d.ts +185 -0
  166. package/dist/uploads.js +991 -0
  167. package/dist/webhooks.d.ts +169 -0
  168. package/dist/webhooks.js +758 -0
  169. package/dist/webpush.d.ts +97 -0
  170. package/dist/webpush.js +372 -0
  171. package/dist/wizard.d.ts +141 -0
  172. package/dist/wizard.js +410 -0
  173. package/dist/workflows.d.ts +134 -0
  174. package/dist/workflows.js +511 -0
  175. package/package.json +186 -4
package/dist/backup.js ADDED
@@ -0,0 +1,345 @@
1
+ import { execFile } from "node:child_process";
2
+ import { randomUUID } from "node:crypto";
3
+ import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
4
+ import { tmpdir } from "node:os";
5
+ import { basename, dirname, join } from "node:path";
6
+ import { openSqlite } from "@weft-framework/data/sqlite";
7
+ import { presignS3 } from "./uploads.js";
8
+ const NAME_RE = /^([a-z][a-z0-9-]{0,39})-(\d{8}T\d{6}(?:\d{3})?Z)\.(sqlite|pgdump)$/;
9
+ const isOurs = (name, prefix, ext) => {
10
+ const m = NAME_RE.exec(name);
11
+ return !!m && m[1] === prefix && m[3] === ext;
12
+ };
13
+ function stamp(ms) {
14
+ return new Date(ms).toISOString().replace(/[-:]/g, "").replace(/\.(\d{3})Z$/, "$1Z");
15
+ }
16
+ function timeOf(name) {
17
+ const m = NAME_RE.exec(name);
18
+ if (!m)
19
+ return null;
20
+ const s = m[2];
21
+ const iso = `${s.slice(0, 4)}-${s.slice(4, 6)}-${s.slice(6, 8)}T${s.slice(9, 11)}:${s.slice(11, 13)}:${s.slice(13, 15)}.${s.length > 16 ? s.slice(15, 18) : "000"}Z`;
22
+ const t = Date.parse(iso);
23
+ return Number.isNaN(t) ? null : t;
24
+ }
25
+ export function dirBackups(dir) {
26
+ if (typeof dir !== "string" || dir === "")
27
+ throw new Error("dirBackups: needs a directory");
28
+ return {
29
+ async put(name, data) {
30
+ mkdirSync(dir, { recursive: true });
31
+ const tmp = join(dir, `.${name}.${randomUUID()}.tmp`);
32
+ writeFileSync(tmp, data);
33
+ renameSync(tmp, join(dir, name));
34
+ },
35
+ async get(name) {
36
+ const file = join(dir, name);
37
+ return existsSync(file) ? new Uint8Array(readFileSync(file)) : null;
38
+ },
39
+ async list() {
40
+ if (!existsSync(dir))
41
+ return [];
42
+ return readdirSync(dir)
43
+ .filter((n) => NAME_RE.test(n))
44
+ .map((name) => ({ name, size: statSync(join(dir, name)).size }));
45
+ },
46
+ async remove(name) {
47
+ rmSync(join(dir, name), { force: true });
48
+ },
49
+ };
50
+ }
51
+ const reveal = (v) => (v === undefined ? undefined : typeof v === "string" ? v : v.reveal());
52
+ export function s3Backups(o) {
53
+ let base;
54
+ try {
55
+ base = new URL(o.endpoint);
56
+ }
57
+ catch {
58
+ throw new Error("s3Backups: endpoint is a URL");
59
+ }
60
+ if (base.protocol !== "https:" && !["localhost", "127.0.0.1", "[::1]"].includes(base.hostname)) {
61
+ throw new Error("s3Backups: endpoint must be https (http only for a local MinIO)");
62
+ }
63
+ if (typeof o.bucket !== "string" || !/^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$/.test(o.bucket))
64
+ throw new Error("s3Backups: bucket is an S3 bucket name");
65
+ const prefix = o.prefix ?? "";
66
+ if (!/^[A-Za-z0-9._/-]{0,200}$/.test(prefix) || prefix.includes(".."))
67
+ throw new Error("s3Backups: prefix is a plain key prefix");
68
+ const doFetch = o.fetch ?? ((url, init) => fetch(url, init));
69
+ const root = o.pathStyle ? `${base.origin}/${o.bucket}` : `${base.protocol}//${o.bucket}.${base.host}`;
70
+ const sign = (method, url) => presignS3({
71
+ method,
72
+ url,
73
+ region: o.region,
74
+ accessKeyId: o.accessKeyId,
75
+ secretAccessKey: reveal(o.secretAccessKey),
76
+ ...(o.sessionToken ? { sessionToken: reveal(o.sessionToken) } : {}),
77
+ expiresSeconds: 300,
78
+ ...(o.now ? { now: o.now() } : {}),
79
+ });
80
+ const objectUrl = (name) => `${root}/${prefix}${name}`;
81
+ const check = async (res, what) => {
82
+ if (!res.ok)
83
+ throw new Error(`s3Backups: ${what} failed with HTTP ${res.status}`);
84
+ return res;
85
+ };
86
+ return {
87
+ async put(name, data) {
88
+ await check(await doFetch(await sign("PUT", objectUrl(name)), { method: "PUT", body: data }), `upload of ${name}`);
89
+ },
90
+ async get(name) {
91
+ const res = await doFetch(await sign("GET", objectUrl(name)), { method: "GET" });
92
+ if (res.status === 404)
93
+ return null;
94
+ return new Uint8Array(await (await check(res, `download of ${name}`)).arrayBuffer());
95
+ },
96
+ async list() {
97
+ const out = [];
98
+ let token = null;
99
+ for (let page = 0; page < 100; page++) {
100
+ const u = new URL(`${root}/`);
101
+ u.searchParams.set("list-type", "2");
102
+ u.searchParams.set("prefix", prefix);
103
+ if (token)
104
+ u.searchParams.set("continuation-token", token);
105
+ const xml = await (await check(await doFetch(await sign("GET", u.href), { method: "GET" }), "listing")).text();
106
+ for (const m of xml.matchAll(/<Contents>([\s\S]*?)<\/Contents>/g)) {
107
+ const key = /<Key>([^<]*)<\/Key>/.exec(m[1])?.[1] ?? "";
108
+ const size = Number(/<Size>(\d+)<\/Size>/.exec(m[1])?.[1] ?? NaN);
109
+ const name = key.startsWith(prefix) ? key.slice(prefix.length) : "";
110
+ if (NAME_RE.test(name) && Number.isFinite(size))
111
+ out.push({ name, size });
112
+ }
113
+ token = /<IsTruncated>true<\/IsTruncated>/.test(xml) ? (/<NextContinuationToken>([^<]*)<\/NextContinuationToken>/.exec(xml)?.[1] ?? null) : null;
114
+ if (!token)
115
+ break;
116
+ }
117
+ return out;
118
+ },
119
+ async remove(name) {
120
+ const res = await doFetch(await sign("DELETE", objectUrl(name)), { method: "DELETE" });
121
+ if (res.status !== 404)
122
+ await check(res, `removal of ${name}`);
123
+ },
124
+ };
125
+ }
126
+ function checkCopy(file) {
127
+ const db = openSqlite(file, { readOnly: true });
128
+ try {
129
+ const rows = db.prepare("PRAGMA quick_check").all();
130
+ const result = rows.map((r) => String(Object.values(r)[0])).join("; ");
131
+ if (result !== "ok")
132
+ throw new Error(`backup: the copy failed its check: ${result.slice(0, 200)}`);
133
+ }
134
+ finally {
135
+ db.close();
136
+ }
137
+ }
138
+ export function defineBackups(o) {
139
+ if (typeof o.database !== "string" || o.database === "" || o.database === ":memory:")
140
+ throw new Error("defineBackups: database is a SQLite file");
141
+ if (!o.target || typeof o.target.put !== "function")
142
+ throw new Error("defineBackups: needs a target (dirBackups, s3Backups)");
143
+ const keep = o.keep ?? 7;
144
+ if (!Number.isInteger(keep) || keep < 1 || keep > 1000)
145
+ throw new Error("defineBackups: keep is 1 to 1000");
146
+ const prefix = o.prefix ?? "backup";
147
+ if (!/^[a-z][a-z0-9-]{0,39}$/.test(prefix))
148
+ throw new Error("defineBackups: prefix is lowercase letters, digits and dashes");
149
+ const now = o.now ?? Date.now;
150
+ const tmpDir = dirname(o.database);
151
+ const list = async () => (await o.target.list())
152
+ .filter((f) => isOurs(f.name, prefix, "sqlite"))
153
+ .map((f) => ({ name: f.name, size: f.size, time: timeOf(f.name) }))
154
+ .sort((a, b) => b.time - a.time || (a.name < b.name ? 1 : -1));
155
+ return {
156
+ list,
157
+ async run() {
158
+ if (!existsSync(o.database))
159
+ throw new Error(`backup: no database at ${o.database}`);
160
+ const time = now();
161
+ const name = `${prefix}-${stamp(time)}.sqlite`;
162
+ const tmp = join(tmpDir, `.weft-backup-${randomUUID()}.sqlite`);
163
+ try {
164
+ const db = openSqlite(o.database);
165
+ try {
166
+ db.prepare("VACUUM INTO ?").run(tmp);
167
+ }
168
+ finally {
169
+ db.close();
170
+ }
171
+ checkCopy(tmp);
172
+ const data = new Uint8Array(readFileSync(tmp));
173
+ await o.target.put(name, data);
174
+ const all = await list();
175
+ for (const old of all.slice(keep)) {
176
+ await o.target.remove(old.name);
177
+ }
178
+ return { name, size: data.byteLength, time };
179
+ }
180
+ finally {
181
+ rmSync(tmp, { force: true });
182
+ }
183
+ },
184
+ async restore(name) {
185
+ if (typeof name !== "string" || !isOurs(name, prefix, "sqlite")) {
186
+ throw new Error(`restore: ${JSON.stringify(String(name).slice(0, 80))} is not a backup name such as ${prefix}-20261114T020000Z.sqlite`);
187
+ }
188
+ const data = await o.target.get(name);
189
+ if (!data)
190
+ throw new Error(`restore: no backup ${name}`);
191
+ mkdirSync(tmpDir, { recursive: true });
192
+ const tmp = join(tmpDir, `.weft-restore-${randomUUID()}.sqlite`);
193
+ try {
194
+ writeFileSync(tmp, data);
195
+ checkCopy(tmp);
196
+ let previous = null;
197
+ if (existsSync(o.database)) {
198
+ previous = `${o.database}.before-restore-${stamp(now())}`;
199
+ renameSync(o.database, previous);
200
+ for (const suffix of ["-wal", "-shm"]) {
201
+ if (existsSync(o.database + suffix))
202
+ renameSync(o.database + suffix, previous + suffix);
203
+ }
204
+ }
205
+ renameSync(tmp, o.database);
206
+ return { previous };
207
+ }
208
+ finally {
209
+ rmSync(tmp, { force: true });
210
+ }
211
+ },
212
+ };
213
+ }
214
+ const PG_PARAMS = {
215
+ sslmode: "PGSSLMODE",
216
+ sslrootcert: "PGSSLROOTCERT",
217
+ sslcert: "PGSSLCERT",
218
+ sslkey: "PGSSLKEY",
219
+ application_name: "PGAPPNAME",
220
+ connect_timeout: "PGCONNECT_TIMEOUT",
221
+ };
222
+ export function pgEnvironment(url, base = process.env) {
223
+ let u;
224
+ try {
225
+ u = new URL(url);
226
+ }
227
+ catch {
228
+ throw new Error("definePgBackups: url is a postgres:// URL");
229
+ }
230
+ if (u.protocol !== "postgres:" && u.protocol !== "postgresql:")
231
+ throw new Error("definePgBackups: url is a postgres:// URL");
232
+ const database = decodeURIComponent(u.pathname.replace(/^\//, ""));
233
+ if (!u.hostname || database === "" || database.includes("/"))
234
+ throw new Error("definePgBackups: url names a host and a database");
235
+ const env = {};
236
+ for (const [k, v] of Object.entries(base))
237
+ if (v !== undefined && !/^PG/i.test(k))
238
+ env[k] = v;
239
+ env.PGHOST = u.hostname.replace(/^\[(.*)\]$/, "$1");
240
+ if (u.port)
241
+ env.PGPORT = u.port;
242
+ env.PGDATABASE = database;
243
+ if (u.username)
244
+ env.PGUSER = decodeURIComponent(u.username);
245
+ if (u.password)
246
+ env.PGPASSWORD = decodeURIComponent(u.password);
247
+ for (const [k, v] of u.searchParams) {
248
+ const name = PG_PARAMS[k];
249
+ if (!name)
250
+ throw new Error(`definePgBackups: unsupported url parameter ${JSON.stringify(k.slice(0, 40))}`);
251
+ env[name] = v;
252
+ }
253
+ return env;
254
+ }
255
+ function runTool(program, args, env, timeoutMs) {
256
+ return new Promise((resolve, reject) => {
257
+ execFile(program, args, { env, timeout: timeoutMs, maxBuffer: 64 * 1024 * 1024, windowsHide: true }, (err, stdout, stderr) => {
258
+ if (!err)
259
+ return resolve(String(stdout));
260
+ const code = err.code;
261
+ if (code === "ENOENT")
262
+ return reject(new Error(`backup: ${program} was not found; install the Postgres client tools or set its path`));
263
+ const why = String(stderr).trim().split("\n").slice(-3).join(" ").slice(0, 400) || err.message;
264
+ reject(new Error(`backup: ${basename(program)} failed: ${why}`));
265
+ });
266
+ });
267
+ }
268
+ export function definePgBackups(o) {
269
+ const url = typeof o.url === "string" ? o.url : o.url?.reveal?.();
270
+ if (typeof url !== "string")
271
+ throw new Error("definePgBackups: needs a url");
272
+ const env = pgEnvironment(url);
273
+ if (!o.target || typeof o.target.put !== "function")
274
+ throw new Error("definePgBackups: needs a target (dirBackups, s3Backups)");
275
+ const keep = o.keep ?? 7;
276
+ if (!Number.isInteger(keep) || keep < 1 || keep > 1000)
277
+ throw new Error("definePgBackups: keep is 1 to 1000");
278
+ const prefix = o.prefix ?? "backup";
279
+ if (!/^[a-z][a-z0-9-]{0,39}$/.test(prefix))
280
+ throw new Error("definePgBackups: prefix is lowercase letters, digits and dashes");
281
+ const timeoutMs = o.timeoutMs ?? 3_600_000;
282
+ if (!Number.isInteger(timeoutMs) || timeoutMs < 1000)
283
+ throw new Error("definePgBackups: timeoutMs is at least 1000");
284
+ const pgDump = o.pgDump ?? "pg_dump";
285
+ const pgRestore = o.pgRestore ?? "pg_restore";
286
+ const now = o.now ?? Date.now;
287
+ const tmpRoot = o.tmpDir ?? tmpdir();
288
+ const list = async () => (await o.target.list())
289
+ .filter((f) => isOurs(f.name, prefix, "pgdump"))
290
+ .map((f) => ({ name: f.name, size: f.size, time: timeOf(f.name) }))
291
+ .sort((a, b) => b.time - a.time || (a.name < b.name ? 1 : -1));
292
+ const check = async (file) => {
293
+ const toc = await runTool(pgRestore, ["--list", file], env, timeoutMs);
294
+ if (!/^;\s*Archive created at/m.test(toc))
295
+ throw new Error("backup: the dump failed its check: pg_restore --list read no archive");
296
+ };
297
+ const dump = async (time) => {
298
+ const name = `${prefix}-${stamp(time)}.pgdump`;
299
+ mkdirSync(tmpRoot, { recursive: true });
300
+ const tmp = join(tmpRoot, `.weft-backup-${randomUUID()}.pgdump`);
301
+ try {
302
+ await runTool(pgDump, ["--format=custom", "--no-password", `--file=${tmp}`], env, timeoutMs);
303
+ await check(tmp);
304
+ const data = new Uint8Array(readFileSync(tmp));
305
+ await o.target.put(name, data);
306
+ return { name, size: data.byteLength, time };
307
+ }
308
+ finally {
309
+ rmSync(tmp, { force: true });
310
+ }
311
+ };
312
+ return {
313
+ list,
314
+ async run() {
315
+ const file = await dump(now());
316
+ for (const old of (await list()).slice(keep)) {
317
+ await o.target.remove(old.name);
318
+ }
319
+ return file;
320
+ },
321
+ async restore(name) {
322
+ if (typeof name !== "string" || !isOurs(name, prefix, "pgdump")) {
323
+ throw new Error(`restore: ${JSON.stringify(String(name).slice(0, 80))} is not a backup name such as ${prefix}-20261114T020000Z.pgdump`);
324
+ }
325
+ const data = await o.target.get(name);
326
+ if (!data)
327
+ throw new Error(`restore: no backup ${name}`);
328
+ mkdirSync(tmpRoot, { recursive: true });
329
+ const tmp = join(tmpRoot, `.weft-restore-${randomUUID()}.pgdump`);
330
+ try {
331
+ writeFileSync(tmp, data);
332
+ await check(tmp);
333
+ let time = now();
334
+ while ((await o.target.get(`${prefix}-${stamp(time)}.pgdump`)) !== null)
335
+ time += 1;
336
+ const previous = await dump(time);
337
+ await runTool(pgRestore, ["--clean", "--if-exists", "--single-transaction", "--exit-on-error", "--no-owner", "--no-password", `--dbname=${env.PGDATABASE}`, tmp], env, timeoutMs);
338
+ return { previous: previous.name };
339
+ }
340
+ finally {
341
+ rmSync(tmp, { force: true });
342
+ }
343
+ },
344
+ };
345
+ }
@@ -0,0 +1,33 @@
1
+ import { type Compiler } from "./compiler.js";
2
+ export declare const BUILD_FORMAT = 1;
3
+ export interface BuildManifest {
4
+ weft: number;
5
+ buildId: string;
6
+ clientEntry: string;
7
+ routes: string[];
8
+ api: string[];
9
+ actions: string[];
10
+ models: string[];
11
+ notFound: boolean;
12
+ error: boolean;
13
+ middleware: boolean;
14
+ assets: Record<string, number>;
15
+ edge: EdgePlan;
16
+ }
17
+ export interface EdgePlan {
18
+ static: Record<string, string>;
19
+ cacheable: string[];
20
+ origin: Record<string, string>;
21
+ }
22
+ export interface BuildOptions {
23
+ compiler: Compiler;
24
+ out?: string;
25
+ }
26
+ export declare class BuildError extends Error {
27
+ }
28
+ export declare function versionImports(js: string, prefix: string): string;
29
+ export declare function versionAssets(assets: Record<string, string>): {
30
+ assets: Record<string, string>;
31
+ buildId: string;
32
+ };
33
+ export declare function build(root: string, opts: BuildOptions): Promise<BuildManifest>;
package/dist/build.js ADDED
@@ -0,0 +1,274 @@
1
+ import { createHash, randomBytes } from "node:crypto";
2
+ import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync } from "node:fs";
3
+ import { dirname, isAbsolute, join, relative, resolve } from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+ import { parseArgs } from "node:util";
6
+ import { CompileError, compileTree, findCompiler } from "./compiler.js";
7
+ import { ConfigError } from "./config.js";
8
+ import { openApi } from "./contract.js";
9
+ import { dataManifest } from "./datamap.js";
10
+ import { ProjectError, loadProject } from "./project.js";
11
+ import { createApp, edgeReason } from "./app.js";
12
+ export const BUILD_FORMAT = 1;
13
+ export class BuildError extends Error {
14
+ }
15
+ function within(child, parent) {
16
+ const rel = relative(parent, child);
17
+ return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
18
+ }
19
+ function checkOut(root, out) {
20
+ if (within(root, out)) {
21
+ throw new BuildError(`refusing to build into ${out}: it contains the project`);
22
+ }
23
+ for (const dir of ["src", "public", "node_modules"]) {
24
+ if (within(out, join(root, dir))) {
25
+ throw new BuildError(`refusing to build into ${out}: it is inside ${dir}/`);
26
+ }
27
+ }
28
+ if (!existsSync(out) || readdirSync(out).length === 0) {
29
+ return;
30
+ }
31
+ try {
32
+ const prev = JSON.parse(readFileSync(join(out, "manifest.json"), "utf8"));
33
+ if (typeof prev.weft === "number") {
34
+ return;
35
+ }
36
+ }
37
+ catch {
38
+ }
39
+ throw new BuildError(`refusing to replace ${out}: not empty and not a previous build`);
40
+ }
41
+ export function versionImports(js, prefix) {
42
+ return js.replace(/(\bfrom\s*|\bimport\s*\(?\s*)(["'])\/_weft\//g, `$1$2${prefix}`);
43
+ }
44
+ export function versionAssets(assets) {
45
+ const h = createHash("sha256");
46
+ for (const path of Object.keys(assets).sort()) {
47
+ h.update(path).update("\0").update(assets[path]).update("\0");
48
+ }
49
+ const buildId = h.digest("hex").slice(0, 12);
50
+ const prefix = `/_weft/${buildId}/`;
51
+ const out = {};
52
+ for (const [path, source] of Object.entries(assets)) {
53
+ if (!path.startsWith("/_weft/")) {
54
+ throw new BuildError(`asset outside /_weft/: ${path}`);
55
+ }
56
+ out[prefix + path.slice("/_weft/".length)] = versionImports(source, prefix);
57
+ }
58
+ return { assets: out, buildId };
59
+ }
60
+ export async function build(root, opts) {
61
+ root = resolve(root);
62
+ const out = resolve(opts.out ?? join(root, "dist"));
63
+ if (!existsSync(join(root, "src", "pages"))) {
64
+ throw new BuildError(`${root}: no src/pages directory`);
65
+ }
66
+ checkOut(root, out);
67
+ rmSync(out, { recursive: true, force: true });
68
+ const serverDir = join(out, "server");
69
+ mkdirSync(serverDir, { recursive: true });
70
+ compileTree(opts.compiler, join(root, "src"), serverDir);
71
+ const shell = join(root, "src", "index.html");
72
+ if (existsSync(shell)) {
73
+ cpSync(shell, join(serverDir, "index.html"));
74
+ }
75
+ const project = await loadProject(root, {
76
+ outDir: serverDir,
77
+ production: true,
78
+ compileStyles: true,
79
+ onWarn: (m) => console.warn(` warning ${m}`),
80
+ });
81
+ const { assets, buildId } = versionAssets(project.assets ?? {});
82
+ const clientEntry = `/_weft/${buildId}/client.js`;
83
+ if (!(clientEntry in assets)) {
84
+ throw new BuildError("the browser runtime has no client entry");
85
+ }
86
+ const sizes = {};
87
+ for (const [path, source] of Object.entries(assets)) {
88
+ const file = join(out, "client", ...path.split("/").filter((p) => p !== "").map(decodeURI));
89
+ if (!within(file, join(out, "client"))) {
90
+ throw new BuildError(`asset path escapes the output: ${path}`);
91
+ }
92
+ mkdirSync(dirname(file), { recursive: true });
93
+ writeFileSync(file, source);
94
+ sizes[path] = Buffer.byteLength(source);
95
+ }
96
+ const manifest = {
97
+ weft: BUILD_FORMAT,
98
+ buildId,
99
+ clientEntry,
100
+ routes: Object.keys(project.routes).sort(),
101
+ api: Object.keys(project.api ?? {}).sort(),
102
+ actions: Object.keys(project.actions ?? {}).sort(),
103
+ models: Object.keys(project.models).sort(),
104
+ notFound: project.notFound !== undefined,
105
+ error: project.error !== undefined,
106
+ middleware: project.middleware !== undefined,
107
+ assets: sizes,
108
+ edge: await splitEdge(project, root, out, assets, clientEntry),
109
+ };
110
+ writeFileSync(join(out, "edge", "routes.json"), JSON.stringify({ weft: BUILD_FORMAT, buildId, ...manifest.edge, immutable: `/_weft/${buildId}/` }, null, 2) + "\n");
111
+ writeFileSync(join(out, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
112
+ const pkgFile = join(root, "package.json");
113
+ const pkg = (existsSync(pkgFile) ? JSON.parse(readFileSync(pkgFile, "utf8")) : {});
114
+ const contract = openApi({ actions: project.actions, api: project.api, models: project.models }, {
115
+ title: typeof pkg.name === "string" ? pkg.name : "weft-app",
116
+ version: typeof pkg.version === "string" ? pkg.version : "0.0.0",
117
+ });
118
+ writeFileSync(join(out, "openapi.json"), JSON.stringify(contract, null, 2) + "\n");
119
+ const data = await dataManifest(serverDir);
120
+ writeFileSync(join(out, "data-manifest.json"), JSON.stringify(data, null, 2) + "\n");
121
+ for (const name of data.unused.models)
122
+ console.warn(` warning model ${name}: no code reads it (dist/data-manifest.json)`);
123
+ for (const [name, fields] of Object.entries(data.unused.fields)) {
124
+ console.warn(` warning ${name}: no code reads ${fields.map((f) => `\`${f}\``).join(", ")} (written, or never used)`);
125
+ }
126
+ writeFileSync(join(out, "server.mjs"), "// Production entry written by `weft build`: node dist/server.mjs (or bun).\n" +
127
+ 'import { runProduction } from "@weft-framework/server/production";\n\n' +
128
+ "await runProduction(new URL(\".\", import.meta.url));\n");
129
+ return manifest;
130
+ }
131
+ async function splitEdge(project, root, out, assets, clientEntry) {
132
+ const dir = join(out, "edge");
133
+ mkdirSync(dir, { recursive: true });
134
+ const { models: _models, database: _database, emails: _emails, ...appOptions } = project;
135
+ const plan = { static: {}, cacheable: [], origin: {} };
136
+ const candidates = [];
137
+ for (const pattern of Object.keys(project.routes).sort()) {
138
+ const why = appOptions.edge === false ? "edge: false" : edgeReason(project.routes[pattern], appOptions);
139
+ if (why)
140
+ plan.origin[pattern] = why;
141
+ else if (pattern.includes("["))
142
+ plan.cacheable.push(pattern);
143
+ else
144
+ candidates.push(pattern);
145
+ }
146
+ const write = (path, body) => {
147
+ const page = typeof body === "string" && !path.endsWith(".css");
148
+ const rel = path === "/" ? "index.html" : page ? `${decodeURIComponent(path.slice(1))}/index.html` : decodeURIComponent(path.slice(1));
149
+ const file = join(dir, ...rel.split("/"));
150
+ if (!within(file, dir) || file === dir)
151
+ throw new BuildError(`edge path escapes the output: ${path}`);
152
+ mkdirSync(dirname(file), { recursive: true });
153
+ writeFileSync(file, body);
154
+ return rel;
155
+ };
156
+ const app = createApp({
157
+ ...appOptions,
158
+ secret: randomBytes(32).toString("hex"),
159
+ assets,
160
+ clientEntry,
161
+ immutableAssets: true,
162
+ transports: ["sse"],
163
+ onError: () => { },
164
+ });
165
+ const get = async (path) => (await app.fetch(new Request(`http://build.invalid${path}`))) ?? null;
166
+ try {
167
+ for (const pattern of candidates) {
168
+ const res = await get(pattern);
169
+ if (!res || res.status !== 200 || !/\bs-maxage=/.test(res.headers.get("cache-control") ?? "")) {
170
+ await res?.body?.cancel();
171
+ plan.origin[pattern] = "renders per visitor (live data, browser code or a form that posts)";
172
+ continue;
173
+ }
174
+ const html = await res.text();
175
+ plan.static[pattern] = write(pattern, html);
176
+ for (const m of html.matchAll(/href="(\/_weft\/(?:styles|app)\.css)\?v=[^"]*"/g)) {
177
+ const sheet = m[1];
178
+ if (sheet in plan.static)
179
+ continue;
180
+ const css = await get(sheet);
181
+ if (css?.status === 200)
182
+ plan.static[sheet] = write(sheet, await css.text());
183
+ }
184
+ }
185
+ await publicToEdge(project, root, get, write, plan);
186
+ }
187
+ finally {
188
+ app.close();
189
+ }
190
+ return plan;
191
+ }
192
+ async function publicToEdge(project, root, get, write, plan) {
193
+ const pub = join(root, "public");
194
+ if (!project.files || !existsSync(pub))
195
+ return;
196
+ const files = [];
197
+ const walk = (d) => {
198
+ for (const e of readdirSync(d, { withFileTypes: true })) {
199
+ if (files.length >= 10_000)
200
+ return;
201
+ if (e.name.startsWith("."))
202
+ continue;
203
+ if (e.isDirectory())
204
+ walk(join(d, e.name));
205
+ else if (e.isFile())
206
+ files.push(join(d, e.name));
207
+ }
208
+ };
209
+ walk(pub);
210
+ for (const file of files) {
211
+ const path = "/" + relative(pub, file).split(/[\/]/).map(encodeURIComponent).join("/");
212
+ if (path in plan.static)
213
+ continue;
214
+ const res = await get(path);
215
+ if (!res || res.status !== 200 || /(no-store|private)/.test(res.headers.get("cache-control") ?? "")) {
216
+ await res?.body?.cancel();
217
+ continue;
218
+ }
219
+ const body = new Uint8Array(await res.arrayBuffer());
220
+ if (Buffer.compare(body, readFileSync(file)) === 0)
221
+ plan.static[path] = write(path, body);
222
+ }
223
+ }
224
+ async function main() {
225
+ const { values, positionals } = parseArgs({
226
+ allowPositionals: true,
227
+ options: { out: { type: "string" } },
228
+ });
229
+ const root = resolve(positionals[0] ?? ".");
230
+ const started = performance.now();
231
+ try {
232
+ const m = await build(root, { compiler: findCompiler(root), out: values.out });
233
+ const ms = Math.round(performance.now() - started);
234
+ const bytes = Object.values(m.assets).reduce((a, b) => a + b, 0);
235
+ console.log(`[weft] build ${m.buildId} in ${ms} ms`);
236
+ console.log(` routes ${m.routes.join(" ") || "-"}`);
237
+ if (m.api.length > 0) {
238
+ console.log(` api ${m.api.join(" ")}`);
239
+ }
240
+ if (m.actions.length > 0) {
241
+ console.log(` actions ${m.actions.join(" ")}`);
242
+ }
243
+ if (m.models.length > 0) {
244
+ console.log(` models ${m.models.join(" ")}`);
245
+ }
246
+ console.log(` client ${Object.keys(m.assets).length} modules, ${(bytes / 1024).toFixed(1)} KiB`);
247
+ const pages = Object.keys(m.edge.static).filter((p) => m.routes.includes(p));
248
+ console.log(` edge ${pages.join(" ") || "-"}${m.edge.cacheable.length ? ` (cacheable: ${m.edge.cacheable.join(" ")})` : ""}`);
249
+ console.log(`\nStart it with: node ${relative(process.cwd(), join(values.out ? resolve(values.out) : join(root, "dist"), "server.mjs"))}`);
250
+ }
251
+ catch (err) {
252
+ if (err instanceof CompileError) {
253
+ console.error(err.diagnostics);
254
+ }
255
+ else if (err instanceof BuildError || err instanceof ProjectError || err instanceof ConfigError) {
256
+ console.error(`[weft] ${err.message}`);
257
+ }
258
+ else {
259
+ console.error("[weft]", err);
260
+ }
261
+ process.exit(1);
262
+ }
263
+ }
264
+ function isEntry() {
265
+ try {
266
+ return !!process.argv[1] && realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
267
+ }
268
+ catch {
269
+ return false;
270
+ }
271
+ }
272
+ if (isEntry()) {
273
+ await main();
274
+ }
package/dist/bun.d.ts ADDED
@@ -0,0 +1,30 @@
1
+ import type { App } from "./app.js";
2
+ export interface BunServeOptions {
3
+ port?: number;
4
+ hostname?: string;
5
+ trustProxy?: boolean;
6
+ idleTimeout?: number;
7
+ onError?(err: unknown): void;
8
+ }
9
+ export interface BunServer {
10
+ url: string;
11
+ close(): Promise<void>;
12
+ }
13
+ export interface BunServeApi {
14
+ serve(opts: {
15
+ port: number;
16
+ hostname: string;
17
+ idleTimeout: number;
18
+ fetch(req: Request, server: unknown): Promise<Response | undefined>;
19
+ error(err: unknown): Response;
20
+ websocket: App["websocket"] & {
21
+ sendPings?: boolean;
22
+ idleTimeout?: number;
23
+ };
24
+ }): {
25
+ url: URL;
26
+ stop(closeActive?: boolean): unknown;
27
+ };
28
+ }
29
+ export declare function forwarded(req: Request): Request;
30
+ export declare function serveBun(app: App, opts?: BunServeOptions, bun?: BunServeApi): BunServer;