@auth-craft/worker-d1-stack 0.1.0 → 0.2.0

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 (57) hide show
  1. package/CHANGELOG.md +75 -0
  2. package/README.md +201 -4
  3. package/assets/check/config.mjs +119 -10
  4. package/assets/data/snapshot.mjs +190 -0
  5. package/assets/engine/dev-engine.mjs +1 -0
  6. package/assets/manifest.json +19 -2
  7. package/assets/sbom/data.cdx.json +1042 -0
  8. package/assets/sbom/worker.cdx.json +26 -8
  9. package/assets/worker/worker.js +56 -56
  10. package/dist/check.d.ts.map +1 -1
  11. package/dist/check.js +3 -0
  12. package/dist/check.js.map +1 -1
  13. package/dist/cli.d.ts +6 -1
  14. package/dist/cli.d.ts.map +1 -1
  15. package/dist/cli.js +262 -4
  16. package/dist/cli.js.map +1 -1
  17. package/dist/commands.d.ts +12 -0
  18. package/dist/commands.d.ts.map +1 -1
  19. package/dist/commands.js +34 -2
  20. package/dist/commands.js.map +1 -1
  21. package/dist/cutover.d.ts +63 -0
  22. package/dist/cutover.d.ts.map +1 -0
  23. package/dist/cutover.js +310 -0
  24. package/dist/cutover.js.map +1 -0
  25. package/dist/data.d.ts +52 -0
  26. package/dist/data.d.ts.map +1 -0
  27. package/dist/data.js +131 -0
  28. package/dist/data.js.map +1 -0
  29. package/dist/dev.d.ts +16 -0
  30. package/dist/dev.d.ts.map +1 -0
  31. package/dist/dev.js +80 -0
  32. package/dist/dev.js.map +1 -0
  33. package/dist/init.d.ts +5 -0
  34. package/dist/init.d.ts.map +1 -1
  35. package/dist/init.js +4 -1
  36. package/dist/init.js.map +1 -1
  37. package/dist/preflight.d.ts +45 -0
  38. package/dist/preflight.d.ts.map +1 -0
  39. package/dist/preflight.js +335 -0
  40. package/dist/preflight.js.map +1 -0
  41. package/dist/secrets-file.d.ts +1 -1
  42. package/dist/secrets-file.d.ts.map +1 -1
  43. package/dist/secrets-file.js +1 -0
  44. package/dist/secrets-file.js.map +1 -1
  45. package/dist/service-token.d.ts +6 -0
  46. package/dist/service-token.d.ts.map +1 -0
  47. package/dist/service-token.js +26 -0
  48. package/dist/service-token.js.map +1 -0
  49. package/dist/smoke.d.ts +11 -0
  50. package/dist/smoke.d.ts.map +1 -1
  51. package/dist/smoke.js +53 -11
  52. package/dist/smoke.js.map +1 -1
  53. package/dist/wrangler-runner.d.ts +8 -0
  54. package/dist/wrangler-runner.d.ts.map +1 -1
  55. package/dist/wrangler-runner.js +17 -0
  56. package/dist/wrangler-runner.js.map +1 -1
  57. package/package.json +12 -4
@@ -0,0 +1,310 @@
1
+ /**
2
+ * `cutover` (docs/LAMBDA_TO_WORKER_PROPOSAL.md §4.5–4.6): move a Lambda deployment to
3
+ * this Worker in one command, resumable from the step that failed.
4
+ *
5
+ * 1 preflight read-only settings / D1 / relay checks
6
+ * 2 maintenance on deploy the Worker fenced (MAINTENANCE_MODE)
7
+ * 3 fence on the Lambda stops (`<fence> on`, then `<fence> status` must say FENCE=on)
8
+ * 4 export → verify → check-hashes → import (reconciled) → reconcile
9
+ * 5 maintenance off + smoke when a smoke account is given
10
+ * 6 switch the app's own routing change (`--switch`)
11
+ *
12
+ * State lives next to the snapshot (`<snapshot-dir>.cutover.json`). A finished step is
13
+ * skipped on a re-run; an import that started and did not finish is never re-run
14
+ * blindly (reconcile first). Before step 6 a rollback is `--rollback` (fence off, Worker
15
+ * back in maintenance, nothing the users wrote is lost because they wrote nowhere).
16
+ * From the moment step 6 starts — it deploys several things, one after the other —
17
+ * users may have written to the Worker: `--rollback` is refused and only
18
+ * `--rollback-after-writes` (data back into a new Lambda table) remains. A failed switch
19
+ * puts the Worker back in maintenance so nothing more is written meanwhile.
20
+ *
21
+ * External effects all go through injected runners (wrangler, aws, node, shell, fetch),
22
+ * so the local rehearsal runs the same sequence with a local Lambda and Worker.
23
+ */
24
+ import { spawn } from 'node:child_process';
25
+ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
26
+ import { dirname, resolve } from 'node:path';
27
+ import { maintenance } from './commands.js';
28
+ import { runData, runNode } from './data.js';
29
+ import { runPreflight } from './preflight.js';
30
+ import { runSmoke } from './smoke.js';
31
+ import { CliError } from './wrangler-config.js';
32
+ import { runCapture, runWrangler } from './wrangler-runner.js';
33
+ export const runShell = (command) => new Promise((resolvePromise, reject) => {
34
+ const child = spawn('bash', ['-c', command], { stdio: ['ignore', 'pipe', 'inherit'] });
35
+ let stdout = '';
36
+ child.stdout?.on('data', (chunk) => {
37
+ const text = chunk.toString();
38
+ stdout += text;
39
+ process.stdout.write(text);
40
+ });
41
+ child.on('error', reject);
42
+ child.on('exit', (code) => resolvePromise({ code: code ?? 1, stdout }));
43
+ });
44
+ const CUTOVER_STEPS = [
45
+ 'preflight',
46
+ 'maintenance-on',
47
+ 'fence-on',
48
+ 'export',
49
+ 'verify',
50
+ 'check-hashes',
51
+ 'import',
52
+ 'reconcile',
53
+ 'maintenance-off',
54
+ 'smoke',
55
+ 'switch',
56
+ ];
57
+ const ROLLBACK_STEPS = [
58
+ 'maintenance-on',
59
+ 'export',
60
+ 'verify',
61
+ 'lambda-deploy',
62
+ 'fence-check',
63
+ 'import',
64
+ 'reconcile',
65
+ 'fence-off',
66
+ 'switch-back',
67
+ ];
68
+ /** Steps that write somewhere and must not be re-run after an interruption without a look. */
69
+ const NOT_BLINDLY_REPEATED = new Set(['import']);
70
+ export const stateFile = (snapshotDir) => `${resolve(snapshotDir)}.cutover.json`;
71
+ function readState(path) {
72
+ if (!existsSync(path))
73
+ return null;
74
+ const state = JSON.parse(readFileSync(path, 'utf8'));
75
+ if (state.version !== 1)
76
+ throw new CliError(`${path}: unknown state version`);
77
+ return state;
78
+ }
79
+ function writeState(path, state) {
80
+ if (!existsSync(dirname(path)))
81
+ throw new CliError(`${dirname(path)} does not exist`);
82
+ writeFileSync(path, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
83
+ }
84
+ const NOT_CARRIED = 'Not carried by the snapshot (docs/LAMBDA_TO_WORKER_PROPOSAL.md §4.8): pending verification/reset links, sign-in and MFA codes (users request them again), rate-limit counters, email logs and suppressions of the Worker. Account lockouts and sessions are carried.';
85
+ async function runSteps(path, state, steps, actions, out) {
86
+ if (state.started && !state.done.includes(state.started) && NOT_BLINDLY_REPEATED.has(state.started)) {
87
+ throw new CliError(`the step "${state.started}" started and did not finish: run \`data reconcile\` to see what landed, then decide (an import only goes into an empty store)`);
88
+ }
89
+ for (const step of steps) {
90
+ if (state.done.includes(step)) {
91
+ out.info(`· ${step}: done before`);
92
+ continue;
93
+ }
94
+ out.info(`→ ${step}`);
95
+ state.started = step;
96
+ writeState(path, state);
97
+ await actions[step]?.();
98
+ state.done.push(step);
99
+ delete state.started;
100
+ writeState(path, state);
101
+ out.info(`✓ ${step}`);
102
+ }
103
+ }
104
+ async function shellOk(shell, command, what) {
105
+ const res = await shell(command);
106
+ if (res.code !== 0)
107
+ throw new CliError(`${what} failed (exit ${res.code})`);
108
+ return res.stdout;
109
+ }
110
+ async function fenceIsOn(shell, fence) {
111
+ const status = await shellOk(shell, `${fence} status`, 'fence status');
112
+ if (!/^FENCE=on$/m.test(status))
113
+ throw new CliError('the Lambda is not fenced (`fence status` did not print FENCE=on)');
114
+ }
115
+ export async function cutover(options, deps) {
116
+ const { out } = deps;
117
+ const run = deps.run ?? runWrangler;
118
+ const capture = deps.capture ?? runCapture;
119
+ const node = deps.node ?? runNode;
120
+ const shell = deps.shell ?? runShell;
121
+ const path = stateFile(options.snapshotDir);
122
+ const state = readState(path) ?? { version: 1, phase: 'preparing', done: [] };
123
+ if (state.phase === 'switched') {
124
+ out.info('cutover: already switched; nothing to do');
125
+ return 0;
126
+ }
127
+ if (state.phase === 'rolled-back' ||
128
+ state.phase.startsWith('rolling-back') ||
129
+ state.phase === 'rolled-back-after-writes') {
130
+ throw new CliError(`${path}: this cutover was rolled back; start again with a new --snapshot-dir`);
131
+ }
132
+ if (!options.yes) {
133
+ out.info(`cutover plan (state: ${path})`);
134
+ for (const step of CUTOVER_STEPS)
135
+ out.info(` ${state.done.includes(step) ? '✓' : '·'} ${step}`);
136
+ out.info(NOT_CARRIED);
137
+ out.info('Nothing changed. Re-run with --yes to carry it out.');
138
+ return 0;
139
+ }
140
+ out.info(NOT_CARRIED);
141
+ const data = async (operation, extra = {}) => {
142
+ const code = await runData({
143
+ operation,
144
+ dir: options.snapshotDir,
145
+ config: options.config,
146
+ secretsFile: options.secretsFile,
147
+ writeFence: operation !== 'verify' && operation !== 'check-hashes',
148
+ ...extra,
149
+ }, deps.env, node);
150
+ if (code !== 0)
151
+ throw new CliError(`data ${operation} failed (exit ${code})`);
152
+ };
153
+ const maintenanceTo = (mode) => maintenance({ config: options.config, mode, secretsFile: options.secretsFile }, run, out);
154
+ const actions = {
155
+ preflight: async () => {
156
+ const checks = await runPreflight({
157
+ fromLambda: options.fromLambda,
158
+ region: options.region,
159
+ config: options.config,
160
+ secretsFile: options.secretsFile,
161
+ ...(deps.fetch && { fetch: deps.fetch }),
162
+ }, capture);
163
+ for (const c of checks) {
164
+ const line = `${c.name}${c.detail ? `: ${c.detail}` : ''}`;
165
+ if (c.ok === false)
166
+ out.error(` ✗ ${line}`);
167
+ else
168
+ out.info(` ${c.ok === true ? '✓' : '!'} ${line}`);
169
+ }
170
+ if (checks.some((c) => c.ok === false))
171
+ throw new CliError('preflight failed; nothing changed');
172
+ },
173
+ 'maintenance-on': () => maintenanceTo('on'),
174
+ 'fence-on': async () => {
175
+ await shellOk(shell, `${options.fence} on`, 'fence on');
176
+ await fenceIsOn(shell, options.fence);
177
+ },
178
+ export: () => data('export', { from: 'dynamodb', table: options.table, region: options.region }),
179
+ verify: () => data('verify'),
180
+ 'check-hashes': () => data('check-hashes', options.maxN !== undefined ? { maxN: options.maxN } : {}),
181
+ import: () => data('import', { to: 'd1' }),
182
+ reconcile: () => data('reconcile', { to: 'd1' }),
183
+ 'maintenance-off': () => maintenanceTo('off'),
184
+ smoke: async () => {
185
+ if (!options.smoke) {
186
+ out.info(' ! no smoke account given (--smoke-email): skipped');
187
+ return;
188
+ }
189
+ const password = deps.env.AUTH_CRAFT_SMOKE_PASSWORD;
190
+ if (!password)
191
+ throw new CliError('AUTH_CRAFT_SMOKE_PASSWORD: required with --smoke-email');
192
+ const vars = JSON.parse(readFileSync(options.config, 'utf8')).vars ?? {};
193
+ const engine = vars.PASSWORD_ENGINE === 'remote' ? 'remote' : 'local';
194
+ const steps = await runSmoke({
195
+ url: options.smoke.url,
196
+ passwordEngine: engine,
197
+ email: options.smoke.email,
198
+ password,
199
+ ...(options.smoke.origin && { cookie: { origin: options.smoke.origin } }),
200
+ ...(options.smoke.app && { app: options.smoke.app }),
201
+ ...(deps.fetch && { fetch: deps.fetch }),
202
+ });
203
+ for (const s of steps)
204
+ (s.ok ? out.info : out.error)(` ${s.ok ? '✓' : '✗'} ${s.name}${s.detail ? `: ${s.detail}` : ''}`);
205
+ if (steps.some((s) => !s.ok)) {
206
+ // Back behind the fence before stopping: the Worker served the smoke account only.
207
+ await maintenanceTo('on');
208
+ state.done = state.done.filter((d) => d !== 'maintenance-off');
209
+ writeState(path, state);
210
+ throw new CliError('smoke failed; the Worker is back in maintenance');
211
+ }
212
+ },
213
+ switch: async () => {
214
+ state.phase = 'switching';
215
+ writeState(path, state);
216
+ const res = await shell(options.switchCommand);
217
+ if (res.code !== 0) {
218
+ try {
219
+ await maintenanceTo('on');
220
+ out.error(' the Worker is back in maintenance (nothing more is written to it)');
221
+ }
222
+ catch {
223
+ out.error(' could not put the Worker back in maintenance: do it now (`maintenance on`)');
224
+ }
225
+ throw new CliError(`the switch failed part way (exit ${res.code}): users may already have written to the Worker. Fix and re-run \`cutover --yes\` (it resumes at the switch), or roll back with \`cutover --rollback-after-writes\`; \`--rollback\` is refused from here on`);
226
+ }
227
+ },
228
+ };
229
+ await runSteps(path, state, CUTOVER_STEPS, actions, out);
230
+ state.phase = 'switched';
231
+ writeState(path, state);
232
+ out.info('cutover: switched. Keep the Lambda fenced for one stable cycle; roll back with `cutover --rollback-after-writes`.');
233
+ return 0;
234
+ }
235
+ /** Before the switch only: fence off, Worker in maintenance, D1 left for a later attempt. */
236
+ export async function rollbackBeforeSwitch(options, deps) {
237
+ const { out } = deps;
238
+ const path = stateFile(options.snapshotDir);
239
+ const state = readState(path);
240
+ if (!state)
241
+ throw new CliError(`${path}: no cutover started here`);
242
+ if (state.phase === 'switching' || state.phase === 'switched') {
243
+ throw new CliError('the switch has started: users may have written to the Worker, and this rollback would drop that. Use `cutover --rollback-after-writes`');
244
+ }
245
+ if (!options.yes) {
246
+ out.info('rollback plan: Worker into maintenance, Lambda fence off. Re-run with --yes.');
247
+ return 0;
248
+ }
249
+ const run = deps.run ?? runWrangler;
250
+ const shell = deps.shell ?? runShell;
251
+ if (state.done.includes('maintenance-on')) {
252
+ await maintenance({ config: options.config, mode: 'on', secretsFile: options.secretsFile }, run, out);
253
+ }
254
+ if (state.done.includes('fence-on') || state.started === 'fence-on') {
255
+ await shellOk(shell, `${options.fence} off`, 'fence off');
256
+ }
257
+ state.phase = 'rolled-back';
258
+ writeState(path, state);
259
+ out.info('rollback: the Lambda serves again; the Worker stays in maintenance. D1 keeps what was imported: empty it before a new attempt.');
260
+ return 0;
261
+ }
262
+ /** After users wrote to the Worker: its data goes into a NEW Lambda table, then traffic goes back. */
263
+ export async function rollbackAfterWrites(options, deps) {
264
+ const { out } = deps;
265
+ const run = deps.run ?? runWrangler;
266
+ const node = deps.node ?? runNode;
267
+ const shell = deps.shell ?? runShell;
268
+ const path = stateFile(options.snapshotDir);
269
+ const state = readState(path) ?? { version: 1, phase: 'rolling-back-after-writes', done: [] };
270
+ if (state.phase === 'rolled-back-after-writes') {
271
+ out.info('rollback: already done');
272
+ return 0;
273
+ }
274
+ if (!options.yes) {
275
+ out.info(`rollback-after-writes plan (state: ${path})`);
276
+ for (const step of ROLLBACK_STEPS)
277
+ out.info(` ${state.done.includes(step) ? '✓' : '·'} ${step}`);
278
+ out.info('Nothing changed. Re-run with --yes to carry it out.');
279
+ return 0;
280
+ }
281
+ const data = async (operation, extra) => {
282
+ const code = await runData({ operation, dir: options.snapshotDir, config: options.config, secretsFile: options.secretsFile, ...extra }, deps.env, node);
283
+ if (code !== 0)
284
+ throw new CliError(`data ${operation} failed (exit ${code})`);
285
+ };
286
+ const target = { to: 'dynamodb', table: options.table, region: options.region, writeFence: true };
287
+ const actions = {
288
+ 'maintenance-on': () => maintenance({ config: options.config, mode: 'on', secretsFile: options.secretsFile }, run, out),
289
+ export: () => data('export', { from: 'd1', writeFence: true }),
290
+ verify: () => data('verify', {}),
291
+ 'lambda-deploy': async () => {
292
+ await shellOk(shell, options.lambdaDeploy, 'Lambda deploy onto the new table');
293
+ },
294
+ 'fence-check': () => fenceIsOn(shell, options.fence),
295
+ import: () => data('import', target),
296
+ reconcile: () => data('reconcile', target),
297
+ 'fence-off': async () => {
298
+ await shellOk(shell, `${options.fence} off`, 'fence off');
299
+ },
300
+ 'switch-back': async () => {
301
+ await shellOk(shell, options.switchBack, 'switch back');
302
+ },
303
+ };
304
+ await runSteps(path, state, ROLLBACK_STEPS, actions, out);
305
+ state.phase = 'rolled-back-after-writes';
306
+ writeState(path, state);
307
+ out.info('rollback: the Lambda serves the data the Worker held, from the new table. Keep the table suffix in every later deploy.');
308
+ return 0;
309
+ }
310
+ //# sourceMappingURL=cutover.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cutover.js","sourceRoot":"","sources":["../src/cutover.ts"],"names":[],"mappings":"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"}
package/dist/data.d.ts ADDED
@@ -0,0 +1,52 @@
1
+ export declare const DATA_SNAPSHOT_CLI: string;
2
+ /**
3
+ * The local D1 of this config (`migrate --local`, `wrangler dev`): wrangler keeps it as a
4
+ * SQLite file under .wrangler/state next to the config. Exactly one database is expected.
5
+ */
6
+ export declare function localD1File(config: string): string;
7
+ export type DataOperation = 'export' | 'verify' | 'check-hashes' | 'import' | 'reconcile';
8
+ export interface DataOptions {
9
+ operation: DataOperation;
10
+ dir: string;
11
+ config: string;
12
+ /** export: dynamodb | d1. */
13
+ from?: string;
14
+ /** import / reconcile: d1 (default) | dynamodb. */
15
+ to?: string;
16
+ table?: string;
17
+ region?: string;
18
+ writeFence?: boolean;
19
+ dryRun?: boolean;
20
+ plaintext?: boolean;
21
+ /** check-hashes: largest scrypt N the password engine accepts (its PASSWORD_ENGINE_MAX_N). */
22
+ maxN?: string;
23
+ /** Source of MFA_SECRET_KEY_ID / MFA_SECRET_PREVIOUS_KEYS when they are secrets. */
24
+ secretsFile?: string;
25
+ /** D1 is the local database (wrangler's SQLite file), not the remote one. */
26
+ local?: boolean;
27
+ }
28
+ /** Runs the bundled snapshot CLI; resolves with its exit code. Injected in tests. */
29
+ export type NodeRunner = (args: string[], env: NodeJS.ProcessEnv) => Promise<number>;
30
+ export declare const runNode: NodeRunner;
31
+ /** The MFA key ids the Worker decrypts with: MFA_SECRET_KEY_ID (default k1) and every previous key's id. */
32
+ export declare function mfaKeyIds(values: Record<string, string | undefined>): string[];
33
+ export declare function dataInvocation(options: DataOptions, env: NodeJS.ProcessEnv): {
34
+ args: string[];
35
+ env: NodeJS.ProcessEnv;
36
+ };
37
+ export declare function runData(options: DataOptions, env: NodeJS.ProcessEnv, run?: NodeRunner): Promise<number>;
38
+ export interface BootstrapAdminOptions {
39
+ config: string;
40
+ email: string;
41
+ create?: boolean;
42
+ displayName?: string;
43
+ local?: boolean;
44
+ }
45
+ /**
46
+ * `bootstrap-admin`: the system tenant's owner on this Worker's D1 (a new deployment,
47
+ * dev, end-to-end tests; a moved deployment brings its admin in the snapshot). The same
48
+ * use case as the PostgreSQL server's `bootstrap-owner`. Idempotent for the same account;
49
+ * a different existing owner is refused. Password: BOOTSTRAP_OWNER_PASSWORD (with --create).
50
+ */
51
+ export declare function runBootstrapAdmin(options: BootstrapAdminOptions, env: NodeJS.ProcessEnv, run?: NodeRunner): Promise<number>;
52
+ //# sourceMappingURL=data.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,iBAAiB,QAAuC,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWlD;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1F,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,aAAa,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAErF,eAAO,MAAM,OAAO,EAAE,UAKlB,CAAC;AAEL,4GAA4G;AAC5G,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAQ9E;AAID,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,CAwC5C;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,GAAE,UAAoB,GACxB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,GAAG,GAAE,UAAoB,GACxB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}
package/dist/data.js ADDED
@@ -0,0 +1,131 @@
1
+ /**
2
+ * `data`: move a deployment's data into this Worker's D1 (or back out, for a rollback)
3
+ * with the snapshot commands of auth-admin-cli, bundled here (assets/data/snapshot.mjs):
4
+ * the same code, the same guarantees (encrypted by default, preflight before any write,
5
+ * reconcile after, an empty destination only).
6
+ *
7
+ * What would drift if typed by hand comes from wrangler.json instead: the D1 database id
8
+ * (the `DB` binding), EMAIL_CANONICALIZE and the MFA key ids the Worker will run with.
9
+ * Credentials stay in the environment: CLOUDFLARE_ACCOUNT_ID + CLOUDFLARE_API_TOKEN for
10
+ * D1, the usual AWS chain for DynamoDB, MIGRATION_SNAPSHOT_KEY(_FILE) for the snapshot.
11
+ */
12
+ import { spawn } from 'node:child_process';
13
+ import { existsSync, readdirSync } from 'node:fs';
14
+ import { dirname, join, resolve } from 'node:path';
15
+ import { ASSETS } from './paths.js';
16
+ import { readSecretsFile } from './secrets-file.js';
17
+ import { CliError, readWranglerConfig } from './wrangler-config.js';
18
+ export const DATA_SNAPSHOT_CLI = join(ASSETS, 'data', 'snapshot.mjs');
19
+ /**
20
+ * The local D1 of this config (`migrate --local`, `wrangler dev`): wrangler keeps it as a
21
+ * SQLite file under .wrangler/state next to the config. Exactly one database is expected.
22
+ */
23
+ export function localD1File(config) {
24
+ const dir = join(dirname(resolve(config)), '.wrangler', 'state', 'v3', 'd1', 'miniflare-D1DatabaseObject');
25
+ const files = existsSync(dir) ? readdirSync(dir).filter((f) => f.endsWith('.sqlite') && f !== 'metadata.sqlite') : [];
26
+ if (files.length !== 1) {
27
+ throw new CliError(files.length === 0
28
+ ? 'no local D1 yet: run `auth-craft-worker migrate --local` first'
29
+ : `${files.length} local D1 databases under ${dir}`);
30
+ }
31
+ return join(dir, files[0]);
32
+ }
33
+ export const runNode = (args, env) => new Promise((resolve, reject) => {
34
+ const child = spawn(process.execPath, args, { env, stdio: 'inherit' });
35
+ child.on('error', reject);
36
+ child.on('exit', (code) => resolve(code ?? 1));
37
+ });
38
+ /** The MFA key ids the Worker decrypts with: MFA_SECRET_KEY_ID (default k1) and every previous key's id. */
39
+ export function mfaKeyIds(values) {
40
+ if (!values.MFA_SECRET_KEY && !values.MFA_SECRET_KEY_ID)
41
+ return [];
42
+ const ids = new Set([values.MFA_SECRET_KEY_ID?.trim() || 'k1']);
43
+ for (const entry of (values.MFA_SECRET_PREVIOUS_KEYS ?? '').split(',')) {
44
+ const id = entry.split(':')[0]?.trim();
45
+ if (id)
46
+ ids.add(id);
47
+ }
48
+ return [...ids];
49
+ }
50
+ const STORES = ['dynamodb', 'd1'];
51
+ export function dataInvocation(options, env) {
52
+ const config = readWranglerConfig(options.config);
53
+ const databaseId = config.d1_databases?.find((d) => d.binding === 'DB')?.database_id;
54
+ if (!databaseId)
55
+ throw new CliError(`${options.config}: no D1 database bound as DB`);
56
+ const vars = config.vars ?? {};
57
+ const secrets = options.secretsFile ? readSecretsFile(options.secretsFile) : {};
58
+ const store = options.operation === 'export' ? options.from : (options.to ?? 'd1');
59
+ const storeless = options.operation === 'verify' || options.operation === 'check-hashes';
60
+ if (!storeless && (!store || !STORES.includes(store))) {
61
+ throw new CliError(options.operation === 'export' ? '--from: dynamodb or d1' : '--to: d1 or dynamodb');
62
+ }
63
+ if (store === 'dynamodb' && !storeless) {
64
+ if (!options.table)
65
+ throw new CliError('--table: the DynamoDB table ({app}-{env}-{layer}-data)');
66
+ if (!options.region && !env.AWS_REGION)
67
+ throw new CliError('--region (or AWS_REGION)');
68
+ }
69
+ const childEnv = {
70
+ ...env,
71
+ CLOUDFLARE_D1_DATABASE_ID: databaseId,
72
+ EMAIL_CANONICALIZE: vars.EMAIL_CANONICALIZE === 'true' ? 'true' : 'false',
73
+ MIGRATION_MFA_KEY_IDS: env.MIGRATION_MFA_KEY_IDS ?? mfaKeyIds({ ...vars, ...secrets }).join(','),
74
+ ...(options.local && { D1_SQLITE_FILE: localD1File(options.config) }),
75
+ ...(options.table && { DYNAMODB_TABLE_NAME: options.table }),
76
+ ...(options.region && { AWS_REGION: options.region }),
77
+ };
78
+ const args = [DATA_SNAPSHOT_CLI, 'snapshot', options.operation, options.dir];
79
+ if (options.operation === 'export')
80
+ args.push('--from', store);
81
+ if (options.operation === 'import' || options.operation === 'reconcile')
82
+ args.push('--to', store);
83
+ if (options.writeFence)
84
+ args.push('--write-fence');
85
+ if (options.dryRun) {
86
+ if (options.operation !== 'import')
87
+ throw new CliError('--dry-run: import only');
88
+ args.push('--dry-run');
89
+ }
90
+ if (options.maxN !== undefined) {
91
+ if (options.operation !== 'check-hashes')
92
+ throw new CliError('--max-n: check-hashes only');
93
+ args.push('--max-n', options.maxN);
94
+ }
95
+ if (options.plaintext)
96
+ args.push('--plaintext');
97
+ return { args, env: childEnv };
98
+ }
99
+ export async function runData(options, env, run = runNode) {
100
+ const invocation = dataInvocation(options, env);
101
+ return run(invocation.args, invocation.env);
102
+ }
103
+ /**
104
+ * `bootstrap-admin`: the system tenant's owner on this Worker's D1 (a new deployment,
105
+ * dev, end-to-end tests; a moved deployment brings its admin in the snapshot). The same
106
+ * use case as the PostgreSQL server's `bootstrap-owner`. Idempotent for the same account;
107
+ * a different existing owner is refused. Password: BOOTSTRAP_OWNER_PASSWORD (with --create).
108
+ */
109
+ export async function runBootstrapAdmin(options, env, run = runNode) {
110
+ const config = readWranglerConfig(options.config);
111
+ const databaseId = config.d1_databases?.find((d) => d.binding === 'DB')?.database_id;
112
+ if (!databaseId)
113
+ throw new CliError(`${options.config}: no D1 database bound as DB`);
114
+ if (options.create && !env.BOOTSTRAP_OWNER_PASSWORD)
115
+ throw new CliError('--create needs BOOTSTRAP_OWNER_PASSWORD');
116
+ const vars = config.vars ?? {};
117
+ const args = [DATA_SNAPSHOT_CLI, 'bootstrap-owner', '--email', options.email, '--type', 'system'];
118
+ if (options.create)
119
+ args.push('--create');
120
+ if (options.displayName)
121
+ args.push('--display-name', options.displayName);
122
+ return run(args, {
123
+ ...env,
124
+ CLOUDFLARE_D1_DATABASE_ID: databaseId,
125
+ EMAIL_CANONICALIZE: vars.EMAIL_CANONICALIZE === 'true' ? 'true' : 'false',
126
+ EMAIL_CANONICAL_LEGACY_LOOKUP: vars.EMAIL_CANONICAL_LEGACY_LOOKUP === 'false' ? 'false' : 'true',
127
+ SYSTEM_TENANT_ID: vars.SYSTEM_TENANT_ID?.trim() || '__system__',
128
+ ...(options.local && { D1_SQLITE_FILE: localD1File(options.config) }),
129
+ });
130
+ }
131
+ //# sourceMappingURL=data.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data.js","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"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"}
package/dist/dev.d.ts ADDED
@@ -0,0 +1,16 @@
1
+ import { type Output } from './commands.js';
2
+ import { type NodeRunner } from './data.js';
3
+ import type { WranglerRunner } from './wrangler-runner.js';
4
+ export declare const DEV_ENGINE: string;
5
+ export interface DevOptions {
6
+ config: string;
7
+ port: number;
8
+ seedAdmin?: string;
9
+ }
10
+ export declare function runDev(options: DevOptions, deps: {
11
+ run: WranglerRunner;
12
+ out: Output;
13
+ env: NodeJS.ProcessEnv;
14
+ node?: NodeRunner;
15
+ }): Promise<number>;
16
+ //# sourceMappingURL=dev.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAYA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,KAAK,UAAU,EAA8B,MAAM,WAAW,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,eAAO,MAAM,UAAU,QAA2C,CAAC;AAGnE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8BD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAA;CAAE,GACpF,OAAO,CAAC,MAAM,CAAC,CAqCjB"}
package/dist/dev.js ADDED
@@ -0,0 +1,80 @@
1
+ /**
2
+ * `dev` (docs/LAMBDA_TO_WORKER_PROPOSAL.md §5.3): this package's Worker on this machine
3
+ * for an app's own end-to-end tests — the local D1 migrated, optionally a system admin
4
+ * seeded (`--seed-admin`, password BOOTSTRAP_OWNER_PASSWORD), then `wrangler dev --local`.
5
+ * With PASSWORD_ENGINE=remote in wrangler.json, the real password engine starts on
6
+ * 127.0.0.1 with a key made for this run, passed to the Worker with `--var` (the app's
7
+ * .dev.vars is never touched; it keeps the JWT keys and other secrets).
8
+ *
9
+ * Runs until interrupted; stops the engine with it.
10
+ */
11
+ import { spawn } from 'node:child_process';
12
+ import { dirname, join, resolve } from 'node:path';
13
+ import { migrate } from './commands.js';
14
+ import { runBootstrapAdmin, runNode } from './data.js';
15
+ import { ASSETS } from './paths.js';
16
+ import { CliError, readWranglerConfig } from './wrangler-config.js';
17
+ export const DEV_ENGINE = join(ASSETS, 'engine', 'dev-engine.mjs');
18
+ const DEV_ENGINE_ISSUER = 'auth-craft-dev-engine';
19
+ /** Starts the local engine; resolves with its URL and the Worker variables that reach it. */
20
+ async function startEngine() {
21
+ const pair = (await crypto.subtle.generateKey({ name: 'Ed25519' }, true, ['sign', 'verify']));
22
+ const privateJwk = JSON.stringify(await crypto.subtle.exportKey('jwk', pair.privateKey));
23
+ const { kty, crv, x } = await crypto.subtle.exportKey('jwk', pair.publicKey);
24
+ const child = spawn(process.execPath, [DEV_ENGINE], {
25
+ env: { ...process.env, DEV_ENGINE_PUBLIC_JWK: JSON.stringify({ kty, crv, x }), DEV_ENGINE_ISSUER },
26
+ stdio: ['ignore', 'pipe', 'inherit'],
27
+ });
28
+ const port = await new Promise((resolvePort, reject) => {
29
+ let buffer = '';
30
+ child.stdout?.on('data', (chunk) => {
31
+ buffer += chunk.toString();
32
+ const match = /LISTENING (\d+)/.exec(buffer);
33
+ if (match)
34
+ resolvePort(Number(match[1]));
35
+ });
36
+ child.once('exit', () => reject(new CliError('the local password engine stopped before listening')));
37
+ });
38
+ return {
39
+ child,
40
+ vars: {
41
+ PASSWORD_ENGINE_URL: `http://127.0.0.1:${port}`,
42
+ PASSWORD_ENGINE_SIGNING_KEY: privateJwk,
43
+ PASSWORD_ENGINE_ISSUER: DEV_ENGINE_ISSUER,
44
+ },
45
+ };
46
+ }
47
+ export async function runDev(options, deps) {
48
+ const config = resolve(options.config);
49
+ const vars = readWranglerConfig(config).vars ?? {};
50
+ if (options.seedAdmin && !deps.env.BOOTSTRAP_OWNER_PASSWORD) {
51
+ throw new CliError('--seed-admin needs BOOTSTRAP_OWNER_PASSWORD');
52
+ }
53
+ await migrate({ config, local: true }, deps.run, deps.out);
54
+ if (options.seedAdmin) {
55
+ const code = await runBootstrapAdmin({ config, email: options.seedAdmin, create: true, local: true }, deps.env, deps.node ?? runNode);
56
+ if (code !== 0)
57
+ throw new CliError(`seeding the admin failed (exit ${code})`);
58
+ }
59
+ const engine = vars.PASSWORD_ENGINE === 'remote' ? await startEngine() : null;
60
+ if (engine)
61
+ deps.out.info(`dev: local password engine on ${engine.vars.PASSWORD_ENGINE_URL}`);
62
+ const varFlags = Object.entries(engine?.vars ?? {}).flatMap(([k, v]) => ['--var', `${k}:${v}`]);
63
+ try {
64
+ const code = await deps.run([
65
+ 'dev',
66
+ '--config',
67
+ config,
68
+ '--local',
69
+ '--port',
70
+ String(options.port),
71
+ '--show-interactive-dev-session=false',
72
+ ...varFlags,
73
+ ], { cwd: dirname(config) });
74
+ return code;
75
+ }
76
+ finally {
77
+ engine?.child.kill('SIGTERM');
78
+ }
79
+ }
80
+ //# sourceMappingURL=dev.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"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"}