@softure-ai/backup 0.0.0-stage → 0.1.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 (117) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/LICENSE +21 -0
  3. package/README.md +243 -2
  4. package/dist/cli/main.d.ts +3 -0
  5. package/dist/cli/main.d.ts.map +1 -0
  6. package/dist/cli/main.js +16 -0
  7. package/dist/cli/main.js.map +1 -0
  8. package/dist/cli/run.d.ts +15 -0
  9. package/dist/cli/run.d.ts.map +1 -0
  10. package/dist/cli/run.js +442 -0
  11. package/dist/cli/run.js.map +1 -0
  12. package/dist/contract.d.ts +41 -0
  13. package/dist/contract.d.ts.map +1 -0
  14. package/dist/contract.js +15 -0
  15. package/dist/contract.js.map +1 -0
  16. package/dist/index.d.ts +22 -0
  17. package/dist/index.d.ts.map +1 -0
  18. package/dist/index.js +30 -0
  19. package/dist/index.js.map +1 -0
  20. package/dist/messages/en.d.ts +17 -0
  21. package/dist/messages/en.d.ts.map +1 -0
  22. package/dist/messages/en.js +17 -0
  23. package/dist/messages/en.js.map +1 -0
  24. package/dist/messages/index.d.ts +22 -0
  25. package/dist/messages/index.d.ts.map +1 -0
  26. package/dist/messages/index.js +4 -0
  27. package/dist/messages/index.js.map +1 -0
  28. package/dist/offsite/config.d.ts +45 -0
  29. package/dist/offsite/config.d.ts.map +1 -0
  30. package/dist/offsite/config.js +147 -0
  31. package/dist/offsite/config.js.map +1 -0
  32. package/dist/offsite/crypto.d.ts +22 -0
  33. package/dist/offsite/crypto.d.ts.map +1 -0
  34. package/dist/offsite/crypto.js +48 -0
  35. package/dist/offsite/crypto.js.map +1 -0
  36. package/dist/offsite/dump.d.ts +23 -0
  37. package/dist/offsite/dump.d.ts.map +1 -0
  38. package/dist/offsite/dump.js +85 -0
  39. package/dist/offsite/dump.js.map +1 -0
  40. package/dist/offsite/index.d.ts +13 -0
  41. package/dist/offsite/index.d.ts.map +1 -0
  42. package/dist/offsite/index.js +15 -0
  43. package/dist/offsite/index.js.map +1 -0
  44. package/dist/offsite/lifecycle.d.ts +17 -0
  45. package/dist/offsite/lifecycle.d.ts.map +1 -0
  46. package/dist/offsite/lifecycle.js +45 -0
  47. package/dist/offsite/lifecycle.js.map +1 -0
  48. package/dist/offsite/objects.d.ts +19 -0
  49. package/dist/offsite/objects.d.ts.map +1 -0
  50. package/dist/offsite/objects.js +44 -0
  51. package/dist/offsite/objects.js.map +1 -0
  52. package/dist/offsite/postgres.d.ts +32 -0
  53. package/dist/offsite/postgres.d.ts.map +1 -0
  54. package/dist/offsite/postgres.js +97 -0
  55. package/dist/offsite/postgres.js.map +1 -0
  56. package/dist/offsite/record.d.ts +3 -0
  57. package/dist/offsite/record.d.ts.map +1 -0
  58. package/dist/offsite/record.js +10 -0
  59. package/dist/offsite/record.js.map +1 -0
  60. package/dist/offsite/restore.d.ts +54 -0
  61. package/dist/offsite/restore.d.ts.map +1 -0
  62. package/dist/offsite/restore.js +67 -0
  63. package/dist/offsite/restore.js.map +1 -0
  64. package/dist/offsite/s3.d.ts +34 -0
  65. package/dist/offsite/s3.d.ts.map +1 -0
  66. package/dist/offsite/s3.js +119 -0
  67. package/dist/offsite/s3.js.map +1 -0
  68. package/dist/offsite/sigv4.d.ts +19 -0
  69. package/dist/offsite/sigv4.d.ts.map +1 -0
  70. package/dist/offsite/sigv4.js +69 -0
  71. package/dist/offsite/sigv4.js.map +1 -0
  72. package/dist/offsite/status-sql.d.ts +10 -0
  73. package/dist/offsite/status-sql.d.ts.map +1 -0
  74. package/dist/offsite/status-sql.js +37 -0
  75. package/dist/offsite/status-sql.js.map +1 -0
  76. package/dist/offsite/upload.d.ts +33 -0
  77. package/dist/offsite/upload.d.ts.map +1 -0
  78. package/dist/offsite/upload.js +98 -0
  79. package/dist/offsite/upload.js.map +1 -0
  80. package/dist/offsite/verify.d.ts +32 -0
  81. package/dist/offsite/verify.d.ts.map +1 -0
  82. package/dist/offsite/verify.js +75 -0
  83. package/dist/offsite/verify.js.map +1 -0
  84. package/dist/schema.d.ts +150 -0
  85. package/dist/schema.d.ts.map +1 -0
  86. package/dist/schema.js +15 -0
  87. package/dist/schema.js.map +1 -0
  88. package/dist/server/index.d.ts +28 -0
  89. package/dist/server/index.d.ts.map +1 -0
  90. package/dist/server/index.js +98 -0
  91. package/dist/server/index.js.map +1 -0
  92. package/examples/backup-verify.yml +84 -0
  93. package/migrations/0001_create_runs.sql +21 -0
  94. package/module.json +12 -0
  95. package/package.json +73 -4
  96. package/src/cli/main.ts +16 -0
  97. package/src/cli/run.ts +441 -0
  98. package/src/contract.ts +47 -0
  99. package/src/index.ts +41 -0
  100. package/src/messages/en.ts +16 -0
  101. package/src/messages/index.ts +6 -0
  102. package/src/offsite/config.ts +173 -0
  103. package/src/offsite/crypto.ts +53 -0
  104. package/src/offsite/dump.ts +97 -0
  105. package/src/offsite/index.ts +33 -0
  106. package/src/offsite/lifecycle.ts +47 -0
  107. package/src/offsite/objects.ts +54 -0
  108. package/src/offsite/postgres.ts +115 -0
  109. package/src/offsite/record.ts +11 -0
  110. package/src/offsite/restore.ts +108 -0
  111. package/src/offsite/s3.ts +144 -0
  112. package/src/offsite/sigv4.ts +84 -0
  113. package/src/offsite/status-sql.ts +45 -0
  114. package/src/offsite/upload.ts +116 -0
  115. package/src/offsite/verify.ts +97 -0
  116. package/src/schema.ts +17 -0
  117. package/src/server/index.ts +111 -0
@@ -0,0 +1,442 @@
1
+ // `softure-backup <command>`: the host's nightly upload, and restore, fetch, verify and lifecycle for the operator.
2
+ // Secrets come only from the environment and the private key only from a file or stdin; an argument that looks like
3
+ // a key is refused, so nothing secret ever shows in `ps` or a shell history. Exit status: 0 done, 1 failed, 2 usage.
4
+ import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
5
+ import { tmpdir } from "node:os";
6
+ import { join, resolve } from "node:path";
7
+ import { parseArgs } from "node:util";
8
+ import { parseDeployConfig, parseTableList } from "@softure-ai/deploy";
9
+ import { createLogger } from "@softure-ai/observability";
10
+ import { collectSecrets, readReadConfig, readUploadConfig, redactSecrets, } from "../offsite/config.js";
11
+ import { parseIdentities } from "../offsite/crypto.js";
12
+ import { buildDumpFileName, runPgDump } from "../offsite/dump.js";
13
+ import { recordRun } from "../offsite/record.js";
14
+ import { buildLifecycleJson, buildLifecycleXml, parseLifecycleDays } from "../offsite/lifecycle.js";
15
+ import { fetchBackup, restoreBackup } from "../offsite/restore.js";
16
+ import { buildStatusSql } from "../offsite/status-sql.js";
17
+ import { buildNotConfiguredRecord, uploadBackups } from "../offsite/upload.js";
18
+ import { DEFAULT_MAX_AGE_HOURS, selectVerifyTables, verifyBackup } from "../offsite/verify.js";
19
+ const USAGE = `usage: softure-backup <command> [options]
20
+
21
+ upload --app=<name> --file=<path>... [--status-sql=<file>] [--summary=<file>]
22
+ encrypt and upload the night's backup files (BACKUP_S3_*, BACKUP_AGE_RECIPIENT)
23
+ run --app=<name> [--config=deploy.json] [--summary=<file>]
24
+ dump the database (BACKUP_DATABASE_URL), encrypt, upload and record the run: a host without a server
25
+ restore --identity=<file|-> [--key=<object>] [--into=<database>] [--overwrite] [--no-owner] [--app=<name>]
26
+ restore a database backup (newest by default) into a new database (BACKUP_RESTORE_DATABASE_URL)
27
+ fetch --identity=<file|-> --out=<file> [--kind=data|database] [--key=<object>] [--app=<name>]
28
+ download and decrypt one object, e.g. the newest data archive
29
+ verify --identity=<file|-> [--config=deploy.json] [--tables=a,b] [--migrations-dir=<dir>] [--max-age-hours=26]
30
+ restore the newest copy into a throwaway database, check it, drop it (BACKUP_VERIFY_DATABASE_URL)
31
+ lifecycle [--days=30] [--format=xml|json] [--app=<name>]
32
+ print the bucket lifecycle rule that expires the prefix's objects
33
+ `;
34
+ const USAGE_EXIT = 2;
35
+ const SECRET_KEY_TEXT = /AGE-SECRET-KEY-/i;
36
+ class UsageError extends Error {
37
+ }
38
+ function readConfigOrFail(result, command) {
39
+ if (result.status === "ok")
40
+ return result.config;
41
+ if (result.status === "not_configured")
42
+ throw new UsageError(`${command}: the off-site store is not configured (BACKUP_S3_*).`);
43
+ throw new UsageError(`${command}: the off-site settings are not valid: ${result.problems.join("; ")}.`);
44
+ }
45
+ async function readIdentities(value, io, command) {
46
+ if (value === undefined)
47
+ throw new UsageError(`${command}: --identity=<file> or --identity=- (stdin) is required.`);
48
+ const text = value === "-" ? await io.readStdin() : readTextFile(resolve(io.cwd, value), command);
49
+ const parsed = parseIdentities(text);
50
+ if (!parsed.ok)
51
+ throw new UsageError(`${command}: ${parsed.problem}.`);
52
+ return parsed.identities;
53
+ }
54
+ function readTextFile(path, command) {
55
+ try {
56
+ return readFileSync(path, "utf8");
57
+ }
58
+ catch (error) {
59
+ throw new UsageError(`${command}: cannot read ${path} (${error.code ?? "unknown error"}).`);
60
+ }
61
+ }
62
+ function requireUrl(io, name, command) {
63
+ const url = io.env[name]?.trim();
64
+ if (url === undefined || url === "")
65
+ throw new UsageError(`${command}: ${name} is not set (a superuser's postgres:// URL).`);
66
+ if (!/^postgres(ql)?:\/\//.test(url))
67
+ throw new UsageError(`${command}: ${name} is not a postgres:// URL.`);
68
+ return url;
69
+ }
70
+ function getAppName(app, io, command) {
71
+ if (app !== undefined)
72
+ return app;
73
+ const prefix = io.env.BACKUP_S3_PREFIX?.trim();
74
+ if (prefix !== undefined && prefix !== "")
75
+ return prefix;
76
+ throw new UsageError(`${command}: --app=<name> is required when BACKUP_S3_PREFIX is not set.`);
77
+ }
78
+ function describeRecord(record) {
79
+ if (record.result === "ok") {
80
+ const seconds = ((record.finishedAt.getTime() - record.startedAt.getTime()) / 1000).toFixed(1);
81
+ return `ok|${String(record.objects.length)} object(s), ${String(record.sizeBytes)} bytes in ${seconds} s`;
82
+ }
83
+ if (record.result === "not_configured")
84
+ return "not_configured";
85
+ return `failed|${record.error?.code ?? "upload_failed"}|${(record.error?.message ?? "").replace(/[\r\n|]+/g, " ")}`;
86
+ }
87
+ async function runUpload(args, io) {
88
+ const { values } = parseArgs({
89
+ args,
90
+ strict: true,
91
+ options: {
92
+ app: { type: "string" },
93
+ file: { type: "string", multiple: true, default: [] },
94
+ "status-sql": { type: "string" },
95
+ summary: { type: "string" },
96
+ },
97
+ });
98
+ if (values.app === undefined)
99
+ throw new UsageError("upload: --app=<name> is required (the default key prefix).");
100
+ const now = io.now ?? (() => new Date());
101
+ const logger = createLogger("@softure-ai/backup");
102
+ const secrets = collectSecrets(io.env);
103
+ const config = readUploadConfig(io.env, values.app);
104
+ let record;
105
+ if (config.status === "not_configured") {
106
+ record = buildNotConfiguredRecord(now());
107
+ }
108
+ else if (config.status === "invalid") {
109
+ const at = now();
110
+ record = { startedAt: at, finishedAt: at, result: "failed", objects: [], sizeBytes: 0, error: { code: "config_invalid", message: config.problems.join("; ") } };
111
+ }
112
+ else {
113
+ record = await uploadBackups({
114
+ config: config.config,
115
+ files: values.file.map((file) => resolve(io.cwd, file)),
116
+ now,
117
+ s3: { now, ...(io.fetch === undefined ? {} : { fetch: io.fetch }) },
118
+ onUploaded: (object) => {
119
+ logger.info("off-site backup object uploaded", { key: object.key, bytes: object.bytes, sha256: object.sha256 });
120
+ },
121
+ });
122
+ }
123
+ if (record.error !== null)
124
+ record = { ...record, error: { ...record.error, message: redactSecrets(record.error.message, secrets) } };
125
+ if (values["status-sql"] !== undefined)
126
+ writeFileSync(resolve(io.cwd, values["status-sql"]), buildStatusSql(record), { mode: 0o600 });
127
+ const summary = describeRecord(record);
128
+ if (values.summary !== undefined)
129
+ writeFileSync(resolve(io.cwd, values.summary), `${summary}\n`, { mode: 0o600 });
130
+ const durationMs = record.finishedAt.getTime() - record.startedAt.getTime();
131
+ if (record.result === "failed") {
132
+ logger.error("off-site backup failed", { result: record.result, code: record.error?.code, message: record.error?.message, durationMs });
133
+ io.stderr(`upload: failed (${record.error?.code ?? ""}): ${record.error?.message ?? ""}\n`);
134
+ return 1;
135
+ }
136
+ if (record.result === "not_configured") {
137
+ io.stdout("upload: not configured (no BACKUP_S3_* in the environment); nothing uploaded.\n");
138
+ return 0;
139
+ }
140
+ logger.info("off-site backup succeeded", { result: record.result, objects: record.objects.length, bytes: record.sizeBytes, durationMs });
141
+ for (const object of record.objects)
142
+ io.stdout(`upload: ${object.key} (${String(object.bytes)} bytes, sha256 ${object.sha256})\n`);
143
+ return 0;
144
+ }
145
+ function readDeployDatabase(config, io, command) {
146
+ const path = resolve(io.cwd, config);
147
+ let json;
148
+ try {
149
+ json = JSON.parse(readTextFile(path, command));
150
+ }
151
+ catch (error) {
152
+ if (error instanceof UsageError)
153
+ throw error;
154
+ throw new UsageError(`${command}: ${path} is not JSON.`);
155
+ }
156
+ const parsed = parseDeployConfig(json);
157
+ if (!parsed.ok)
158
+ throw new UsageError(`${command}: ${path} is not a valid deploy.json: ${parsed.issues.join("; ")}.`);
159
+ return parsed.config.database ?? {};
160
+ }
161
+ function failedRecord(startedAt, finishedAt, code, message) {
162
+ return { startedAt, finishedAt, result: "failed", objects: [], sizeBytes: 0, error: { code, message } };
163
+ }
164
+ /**
165
+ * The whole night's run for a host without a server: dump over BACKUP_DATABASE_URL into a private temporary
166
+ * directory, upload with the same code as `upload`, and write the same row into `backup.runs` over the same URL.
167
+ */
168
+ async function runNow(args, io) {
169
+ const { values } = parseArgs({
170
+ args,
171
+ strict: true,
172
+ options: {
173
+ app: { type: "string" },
174
+ config: { type: "string" },
175
+ summary: { type: "string" },
176
+ "pg-dump": { type: "string" },
177
+ },
178
+ });
179
+ if (values.app === undefined)
180
+ throw new UsageError("run: --app=<name> is required (the default key prefix).");
181
+ const databaseUrl = requireUrl(io, "BACKUP_DATABASE_URL", "run");
182
+ const excludeTableData = values.config === undefined ? [] : [...(readDeployDatabase(values.config, io, "run").excludeTableData ?? [])];
183
+ const now = io.now ?? (() => new Date());
184
+ const logger = createLogger("@softure-ai/backup");
185
+ const secrets = collectSecrets(io.env);
186
+ const config = readUploadConfig(io.env, values.app);
187
+ let record;
188
+ if (config.status === "not_configured") {
189
+ record = buildNotConfiguredRecord(now());
190
+ }
191
+ else if (config.status === "invalid") {
192
+ const at = now();
193
+ record = failedRecord(at, at, "config_invalid", config.problems.join("; "));
194
+ }
195
+ else {
196
+ const startedAt = now();
197
+ const dir = mkdtempSync(join(tmpdir(), "softure-backup-run-"));
198
+ try {
199
+ const out = join(dir, buildDumpFileName(startedAt));
200
+ const dump = await runPgDump({
201
+ url: databaseUrl,
202
+ out,
203
+ excludeTableData,
204
+ pgDump: values["pg-dump"] ?? io.env.BACKUP_PG_DUMP ?? "pg_dump",
205
+ env: io.env,
206
+ });
207
+ if (dump.ok) {
208
+ logger.info("database dumped", { bytes: dump.bytes });
209
+ const uploaded = await uploadBackups({
210
+ config: config.config,
211
+ files: [out],
212
+ now,
213
+ s3: { now, ...(io.fetch === undefined ? {} : { fetch: io.fetch }) },
214
+ onUploaded: (object) => {
215
+ logger.info("off-site backup object uploaded", { key: object.key, bytes: object.bytes, sha256: object.sha256 });
216
+ },
217
+ });
218
+ record = { ...uploaded, startedAt };
219
+ }
220
+ else {
221
+ record = failedRecord(startedAt, now(), "dump_failed", dump.problem);
222
+ }
223
+ }
224
+ finally {
225
+ rmSync(dir, { recursive: true, force: true });
226
+ }
227
+ }
228
+ if (record.error !== null)
229
+ record = { ...record, error: { ...record.error, message: redactSecrets(record.error.message, secrets) } };
230
+ const summary = describeRecord(record);
231
+ if (values.summary !== undefined)
232
+ writeFileSync(resolve(io.cwd, values.summary), `${summary}\n`, { mode: 0o600 });
233
+ try {
234
+ await (io.recordRun ?? recordRun)(databaseUrl, record);
235
+ }
236
+ catch (error) {
237
+ const problem = redactSecrets(error instanceof Error ? error.message : String(error), secrets);
238
+ logger.error("off-site backup run not recorded", { result: record.result, problem });
239
+ io.stderr(`run: ${summary.split("|")[0] ?? ""}, but the run could not be recorded in backup.runs: ${problem}\n`);
240
+ return 1;
241
+ }
242
+ const durationMs = record.finishedAt.getTime() - record.startedAt.getTime();
243
+ if (record.result === "failed") {
244
+ logger.error("off-site backup failed", { result: record.result, code: record.error?.code, message: record.error?.message, durationMs });
245
+ io.stderr(`run: failed (${record.error?.code ?? ""}): ${record.error?.message ?? ""}\n`);
246
+ return 1;
247
+ }
248
+ if (record.result === "not_configured") {
249
+ io.stdout("run: not configured (no BACKUP_S3_* in the environment); nothing dumped or uploaded.\n");
250
+ return 0;
251
+ }
252
+ logger.info("off-site backup succeeded", { result: record.result, objects: record.objects.length, bytes: record.sizeBytes, durationMs });
253
+ for (const object of record.objects)
254
+ io.stdout(`run: ${object.key} (${String(object.bytes)} bytes, sha256 ${object.sha256})\n`);
255
+ return 0;
256
+ }
257
+ async function runRestore(args, io) {
258
+ const { values } = parseArgs({
259
+ args,
260
+ strict: true,
261
+ options: {
262
+ identity: { type: "string" },
263
+ key: { type: "string" },
264
+ into: { type: "string" },
265
+ overwrite: { type: "boolean", default: false },
266
+ "no-owner": { type: "boolean", default: false },
267
+ app: { type: "string" },
268
+ "pg-restore": { type: "string" },
269
+ },
270
+ });
271
+ const store = readConfigOrFail(readReadConfig(io.env, getAppName(values.app, io, "restore")), "restore");
272
+ const adminUrl = requireUrl(io, "BACKUP_RESTORE_DATABASE_URL", "restore");
273
+ if (values.overwrite && values.into === undefined)
274
+ throw new UsageError("restore: --overwrite needs --into=<database>, the database to restore over.");
275
+ const identities = await readIdentities(values.identity, io, "restore");
276
+ const result = await restoreBackup({
277
+ store,
278
+ identities,
279
+ adminUrl,
280
+ ...(values.key === undefined ? {} : { key: values.key }),
281
+ ...(values.into === undefined ? {} : { into: values.into }),
282
+ overwrite: values.overwrite,
283
+ noOwner: values["no-owner"],
284
+ pgRestore: values["pg-restore"] ?? io.env.BACKUP_PG_RESTORE ?? "pg_restore",
285
+ env: io.env,
286
+ ...(io.now === undefined ? {} : { now: io.now() }),
287
+ s3: io.fetch === undefined ? {} : { fetch: io.fetch },
288
+ });
289
+ if (!result.ok) {
290
+ io.stderr(`restore: ${redactSecrets(result.problem, collectSecrets(io.env))}\n`);
291
+ return 1;
292
+ }
293
+ io.stdout(`restore: ${result.value.key} restored into ${result.value.created ? "the new database" : "the existing database"} ${result.value.database}\n`);
294
+ return 0;
295
+ }
296
+ async function runFetch(args, io) {
297
+ const { values } = parseArgs({
298
+ args,
299
+ strict: true,
300
+ options: {
301
+ identity: { type: "string" },
302
+ key: { type: "string" },
303
+ kind: { type: "string", default: "data" },
304
+ out: { type: "string" },
305
+ app: { type: "string" },
306
+ },
307
+ });
308
+ if (values.kind !== "data" && values.kind !== "database")
309
+ throw new UsageError("fetch: --kind is data or database.");
310
+ if (values.out === undefined)
311
+ throw new UsageError("fetch: --out=<file> is required.");
312
+ const store = readConfigOrFail(readReadConfig(io.env, getAppName(values.app, io, "fetch")), "fetch");
313
+ const identities = await readIdentities(values.identity, io, "fetch");
314
+ const result = await fetchBackup({
315
+ store,
316
+ identities,
317
+ kind: values.kind,
318
+ out: resolve(io.cwd, values.out),
319
+ ...(values.key === undefined ? {} : { key: values.key }),
320
+ s3: io.fetch === undefined ? {} : { fetch: io.fetch },
321
+ });
322
+ if (!result.ok) {
323
+ io.stderr(`fetch: ${redactSecrets(result.problem, collectSecrets(io.env))}\n`);
324
+ return 1;
325
+ }
326
+ io.stdout(`fetch: ${result.value.key} decrypted to ${result.value.out}\n`);
327
+ return 0;
328
+ }
329
+ function readVerifyTables(config, tables, io) {
330
+ if (tables !== undefined) {
331
+ const parsed = parseTableList(tables);
332
+ if (!parsed.ok)
333
+ throw new UsageError(`verify: --tables: ${parsed.problem}.`);
334
+ return parsed.tables;
335
+ }
336
+ if (config === undefined)
337
+ return [];
338
+ const database = readDeployDatabase(config, io, "verify");
339
+ return selectVerifyTables(database.rowCountTables, database.excludeTableData);
340
+ }
341
+ async function runVerify(args, io) {
342
+ const { values } = parseArgs({
343
+ args,
344
+ strict: true,
345
+ options: {
346
+ identity: { type: "string" },
347
+ config: { type: "string" },
348
+ tables: { type: "string" },
349
+ "migrations-dir": { type: "string" },
350
+ "max-age-hours": { type: "string" },
351
+ app: { type: "string" },
352
+ "pg-restore": { type: "string" },
353
+ },
354
+ });
355
+ const maxAgeText = values["max-age-hours"];
356
+ const maxAgeHours = maxAgeText === undefined ? DEFAULT_MAX_AGE_HOURS : Number(maxAgeText);
357
+ if (!Number.isFinite(maxAgeHours) || maxAgeHours <= 0 || maxAgeHours > 24 * 366)
358
+ throw new UsageError("verify: --max-age-hours is a number of hours above 0.");
359
+ const store = readConfigOrFail(readReadConfig(io.env, getAppName(values.app, io, "verify")), "verify");
360
+ const adminUrl = requireUrl(io, "BACKUP_VERIFY_DATABASE_URL", "verify");
361
+ const tables = readVerifyTables(values.config, values.tables, io);
362
+ const identities = await readIdentities(values.identity, io, "verify");
363
+ const logger = createLogger("@softure-ai/backup");
364
+ const result = await verifyBackup({
365
+ store,
366
+ identities,
367
+ adminUrl,
368
+ tables,
369
+ ...(values["migrations-dir"] === undefined ? {} : { migrationsDir: resolve(io.cwd, values["migrations-dir"]) }),
370
+ maxAgeHours,
371
+ pgRestore: values["pg-restore"] ?? io.env.BACKUP_PG_RESTORE ?? "pg_restore",
372
+ env: io.env,
373
+ ...(io.now === undefined ? {} : { now: io.now() }),
374
+ s3: io.fetch === undefined ? {} : { fetch: io.fetch },
375
+ });
376
+ if (!result.ok) {
377
+ const problem = redactSecrets(result.problem, collectSecrets(io.env));
378
+ logger.error("off-site backup verify failed", { problem });
379
+ io.stderr(`verify: ${problem}\n`);
380
+ return 1;
381
+ }
382
+ const counts = Object.entries(result.value.counts).map(([table, count]) => `${table}=${String(count)}`).join(",");
383
+ logger.info("off-site backup verified", { key: result.value.key, ageHours: Number(result.value.ageHours.toFixed(1)), schemaGuard: result.value.schemaGuard });
384
+ io.stdout(`verify: ${result.value.key} (${result.value.ageHours.toFixed(1)} h old) restores; schema guard ${result.value.schemaGuard}; ${counts === "" ? "no tables listed" : counts}\n`);
385
+ return 0;
386
+ }
387
+ function runLifecycle(args, io) {
388
+ const { values } = parseArgs({
389
+ args,
390
+ strict: true,
391
+ options: { days: { type: "string" }, format: { type: "string", default: "xml" }, app: { type: "string" } },
392
+ });
393
+ const days = parseLifecycleDays(values.days);
394
+ if (!days.ok)
395
+ throw new UsageError(`lifecycle: ${days.problem}.`);
396
+ const prefix = getAppName(values.app, io, "lifecycle");
397
+ if (values.format === "xml")
398
+ io.stdout(buildLifecycleXml(prefix, days.days));
399
+ else if (values.format === "json")
400
+ io.stdout(buildLifecycleJson(prefix, days.days));
401
+ else
402
+ throw new UsageError("lifecycle: --format is xml or json.");
403
+ return 0;
404
+ }
405
+ export async function runCli(argv, io) {
406
+ const [command, ...args] = argv;
407
+ try {
408
+ if (args.some((arg) => SECRET_KEY_TEXT.test(arg))) {
409
+ throw new UsageError("an argument holds an age secret key; pass it through --identity=<file> or --identity=- (stdin), never as an argument.");
410
+ }
411
+ switch (command) {
412
+ case "upload":
413
+ return await runUpload(args, io);
414
+ case "run":
415
+ return await runNow(args, io);
416
+ case "restore":
417
+ return await runRestore(args, io);
418
+ case "fetch":
419
+ return await runFetch(args, io);
420
+ case "verify":
421
+ return await runVerify(args, io);
422
+ case "lifecycle":
423
+ return runLifecycle(args, io);
424
+ case undefined:
425
+ case "--help":
426
+ case "help":
427
+ io.stdout(USAGE);
428
+ return command === undefined ? USAGE_EXIT : 0;
429
+ default:
430
+ throw new UsageError(`unknown command ${command}.\n${USAGE}`);
431
+ }
432
+ }
433
+ catch (error) {
434
+ if (error instanceof UsageError || (error instanceof TypeError && "code" in error && String(error.code).startsWith("ERR_PARSE_ARGS"))) {
435
+ io.stderr(`softure-backup: ${error.message}\n`);
436
+ return USAGE_EXIT;
437
+ }
438
+ io.stderr(`softure-backup: ${command ?? ""} failed: ${redactSecrets(error instanceof Error ? error.message : String(error), collectSecrets(io.env))}\n`);
439
+ return 1;
440
+ }
441
+ }
442
+ //# sourceMappingURL=run.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ /** How a run ended: uploaded, failed, or skipped because the host has no off-site configuration. */
2
+ export declare const BACKUP_RESULTS: readonly ["ok", "failed", "not_configured"];
3
+ export type BackupResult = (typeof BACKUP_RESULTS)[number];
4
+ /** Safe error codes of a failed run; the message beside them never holds a secret. */
5
+ export declare const BACKUP_ERROR_CODES: readonly ["config_invalid", "file_missing", "encrypt_failed", "upload_denied", "upload_failed", "network_error", "dump_failed"];
6
+ export type BackupErrorCode = (typeof BACKUP_ERROR_CODES)[number];
7
+ /** What a backup file holds: the database dump or an archive of the data volume's folders. */
8
+ export type BackupKind = "database" | "data";
9
+ /** One encrypted object a run uploaded. */
10
+ export interface BackupObject {
11
+ readonly kind: BackupKind;
12
+ /** The object key in the bucket, `<prefix>/<file name>.age`. */
13
+ readonly key: string;
14
+ /** Bytes of the encrypted object. */
15
+ readonly bytes: number;
16
+ /** sha256 of the encrypted object, hex. */
17
+ readonly sha256: string;
18
+ }
19
+ /** One recorded run of the off-site copy. */
20
+ export interface BackupRun {
21
+ readonly startedAt: Date;
22
+ readonly finishedAt: Date;
23
+ readonly result: BackupResult;
24
+ readonly objects: readonly BackupObject[];
25
+ readonly sizeBytes: number;
26
+ readonly error: {
27
+ readonly code: string;
28
+ readonly message: string;
29
+ } | null;
30
+ }
31
+ /** What a settings screen shows: the newest run, the newest successful one, or nothing recorded yet. */
32
+ export type BackupStatus = {
33
+ readonly result: "not_configured";
34
+ readonly lastRun: null;
35
+ readonly lastSuccess: null;
36
+ } | {
37
+ readonly result: BackupResult;
38
+ readonly lastRun: BackupRun;
39
+ readonly lastSuccess: BackupRun | null;
40
+ };
41
+ //# sourceMappingURL=contract.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAGA,oGAAoG;AACpG,eAAO,MAAM,cAAc,YAAI,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAU,CAAC;AAC1E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,YAC7B,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,CACL,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,8FAA8F;AAC9F,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE7C,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC5E;AAED,wGAAwG;AACxG,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAA;CAAE,GACzF;IAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,CAAC"}
@@ -0,0 +1,15 @@
1
+ // Result types and codes of the backup module. No user-facing copy here: an app's settings screen translates the
2
+ // result and error codes through `messages` (docs/02-module-standard.md §6).
3
+ /** How a run ended: uploaded, failed, or skipped because the host has no off-site configuration. */
4
+ export const BACKUP_RESULTS = ["ok", "failed", "not_configured"];
5
+ /** Safe error codes of a failed run; the message beside them never holds a secret. */
6
+ export const BACKUP_ERROR_CODES = [
7
+ "config_invalid",
8
+ "file_missing",
9
+ "encrypt_failed",
10
+ "upload_denied",
11
+ "upload_failed",
12
+ "network_error",
13
+ "dump_failed",
14
+ ];
15
+ //# sourceMappingURL=contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,6EAA6E;AAE7E,oGAAoG;AACpG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,CAAU,CAAC;AAG1E,sFAAsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,eAAe;IACf,eAAe;IACf,aAAa;CACL,CAAC"}
@@ -0,0 +1,22 @@
1
+ export declare const MODULE_ID = "backup";
2
+ /** Adds the status table of the off-site backup: `modules: [backup()]` in `softure.config.ts`. */
3
+ export declare const backup: import("@softure-ai/core").ModuleFactory<{}, {
4
+ result: {
5
+ ok: string;
6
+ failed: string;
7
+ not_configured: string;
8
+ };
9
+ errors: {
10
+ config_invalid: string;
11
+ file_missing: string;
12
+ encrypt_failed: string;
13
+ upload_denied: string;
14
+ upload_failed: string;
15
+ network_error: string;
16
+ dump_failed: string;
17
+ };
18
+ }, undefined>;
19
+ export { BACKUP_ERROR_CODES, BACKUP_RESULTS, type BackupErrorCode, type BackupKind, type BackupObject, type BackupResult, type BackupRun, type BackupStatus, } from "./contract.js";
20
+ export { backupMessages, type BackupMessages } from "./messages/index.js";
21
+ export { backupSchema, runs } from "./schema.js";
22
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,kGAAkG;AAClG,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;aAgBjB,CAAC;AAEH,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,30 @@
1
+ // Public API of @softure-ai/backup: the module factory for softure.config.ts (its migration creates backup.runs,
2
+ // the status the host run writes), the contract types and messages. The app reads the status through
3
+ // `@softure-ai/backup/server`; the host side (upload, restore, verify) is `@softure-ai/backup/offsite` and the
4
+ // `softure-backup` command.
5
+ import { defineModule, resolveMigrationsDir } from "@softure-ai/core";
6
+ import { backupMessages } from "./messages/index.js";
7
+ import { checkRunsTable } from "./server/index.js";
8
+ export const MODULE_ID = "backup";
9
+ /** Adds the status table of the off-site backup: `modules: [backup()]` in `softure.config.ts`. */
10
+ export const backup = defineModule({
11
+ manifest: {
12
+ id: MODULE_ID,
13
+ version: "0.1.0",
14
+ dependsOn: {},
15
+ dbSchema: "backup",
16
+ tables: ["runs"],
17
+ env: [],
18
+ switches: [],
19
+ routes: {},
20
+ mount: [],
21
+ privacy: { exports: false, deletes: false },
22
+ },
23
+ messages: backupMessages,
24
+ migrations: { dir: resolveMigrationsDir(import.meta.url, "../migrations/") },
25
+ health: checkRunsTable,
26
+ });
27
+ export { BACKUP_ERROR_CODES, BACKUP_RESULTS, } from "./contract.js";
28
+ export { backupMessages } from "./messages/index.js";
29
+ export { backupSchema, runs } from "./schema.js";
30
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,qGAAqG;AACrG,+GAA+G;AAC/G,4BAA4B;AAC5B,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAElC,kGAAkG;AAClG,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;IACjC,QAAQ,EAAE;QACR,EAAE,EAAE,SAAS;QACb,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,CAAC,MAAM,CAAC;QAChB,GAAG,EAAE,EAAE;QACP,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;KAC5C;IACD,QAAQ,EAAE,cAAc;IACxB,UAAU,EAAE,EAAE,GAAG,EAAE,oBAAoB,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE;IAC5E,MAAM,EAAE,cAAc;CACvB,CAAC,CAAC;AAEH,OAAO,EACL,kBAAkB,EAClB,cAAc,GAOf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAuB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,17 @@
1
+ export declare const en: {
2
+ result: {
3
+ ok: string;
4
+ failed: string;
5
+ not_configured: string;
6
+ };
7
+ errors: {
8
+ config_invalid: string;
9
+ file_missing: string;
10
+ encrypt_failed: string;
11
+ upload_denied: string;
12
+ upload_failed: string;
13
+ network_error: string;
14
+ dump_failed: string;
15
+ };
16
+ };
17
+ //# sourceMappingURL=en.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/messages/en.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;IACb,MAAM;QACJ,EAAE;QACF,MAAM;QACN,cAAc;;IAEhB,MAAM;QACJ,cAAc;QACd,YAAY;QACZ,cAAc;QACd,aAAa;QACb,aAAa;QACb,aAAa;QACb,WAAW;;CAEd,CAAC"}
@@ -0,0 +1,17 @@
1
+ export const en = {
2
+ result: {
3
+ ok: "Off-site backup succeeded",
4
+ failed: "Off-site backup failed",
5
+ not_configured: "Off-site backup is not configured",
6
+ },
7
+ errors: {
8
+ config_invalid: "The off-site backup settings are incomplete or invalid.",
9
+ file_missing: "The local backup file was not found.",
10
+ encrypt_failed: "The backup could not be encrypted.",
11
+ upload_denied: "The storage refused the upload; check the token's permissions.",
12
+ upload_failed: "The upload to the storage failed.",
13
+ network_error: "The storage could not be reached.",
14
+ dump_failed: "The database could not be dumped.",
15
+ },
16
+ };
17
+ //# sourceMappingURL=en.js.map