@quickback-dev/cli 0.52.1 → 0.54.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 (43) hide show
  1. package/dist/commands/push.d.ts +20 -0
  2. package/dist/commands/push.d.ts.map +1 -0
  3. package/dist/commands/push.js +144 -0
  4. package/dist/commands/push.js.map +1 -0
  5. package/dist/commands/push.test.d.ts +2 -0
  6. package/dist/commands/push.test.d.ts.map +1 -0
  7. package/dist/commands/push.test.js +76 -0
  8. package/dist/commands/push.test.js.map +1 -0
  9. package/dist/docs/content.d.ts.map +1 -1
  10. package/dist/docs/content.js +20 -10
  11. package/dist/docs/content.js.map +1 -1
  12. package/dist/index.js +7 -1
  13. package/dist/index.js.map +1 -1
  14. package/dist/lib/file-loader.d.ts.map +1 -1
  15. package/dist/lib/file-loader.js +6 -2
  16. package/dist/lib/file-loader.js.map +1 -1
  17. package/dist/skill/SKILL.md +1 -0
  18. package/dist/skill/docs/changelog.md +68 -0
  19. package/dist/skill/docs/compiler/config/index.md +1 -1
  20. package/dist/skill/docs/compiler/config/providers.md +2 -0
  21. package/dist/skill/docs/compiler/definitions/access.md +29 -5
  22. package/dist/skill/docs/compiler/definitions/actions.md +2 -0
  23. package/dist/skill/docs/compiler/definitions/scopes.md +10 -4
  24. package/dist/skill/docs/stack/push/index.md +290 -0
  25. package/dist/skill/docs/stack/realtime/durable-objects.md +1 -1
  26. package/dist/skill/docs/stack/realtime/index.md +3 -1
  27. package/dist/skill/docs/stack/realtime/live-views.md +1 -1
  28. package/dist/skill/docs/stack/realtime/named-invalidations.md +147 -0
  29. package/dist/skill/docs/stack/realtime/using-realtime.md +1 -0
  30. package/package.json +1 -1
  31. package/src/skill/SKILL.md +1 -0
  32. package/src/skill/docs/changelog.md +68 -0
  33. package/src/skill/docs/compiler/config/index.md +1 -1
  34. package/src/skill/docs/compiler/config/providers.md +2 -0
  35. package/src/skill/docs/compiler/definitions/access.md +29 -5
  36. package/src/skill/docs/compiler/definitions/actions.md +2 -0
  37. package/src/skill/docs/compiler/definitions/scopes.md +10 -4
  38. package/src/skill/docs/stack/push/index.md +290 -0
  39. package/src/skill/docs/stack/realtime/durable-objects.md +1 -1
  40. package/src/skill/docs/stack/realtime/index.md +3 -1
  41. package/src/skill/docs/stack/realtime/live-views.md +1 -1
  42. package/src/skill/docs/stack/realtime/named-invalidations.md +147 -0
  43. package/src/skill/docs/stack/realtime/using-realtime.md +1 -0
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Push Subcommands
3
+ *
4
+ * `quickback push generate-keys` — mints a fresh VAPID keypair (P-256)
5
+ * in the right format for config.push.vapidPublicKey / vapidPrivateKey,
6
+ * plus copy-pasteable wrangler secret commands.
7
+ */
8
+ /**
9
+ * Mint a fresh ECDH P-256 keypair and emit the public key as a 65-byte
10
+ * uncompressed point and the private key as the 32-byte scalar — both
11
+ * base64url-encoded, the format RFC 8292 VAPID expects.
12
+ */
13
+ declare function generateVapidKeypair(): Promise<{
14
+ publicKey: string;
15
+ privateKey: string;
16
+ }>;
17
+ declare function generateKeys(args: string[]): Promise<void>;
18
+ export { generateKeys as __generateKeysForTest, generateVapidKeypair as __generateVapidKeypairForTest };
19
+ export declare function push(args: string[]): Promise<void>;
20
+ //# sourceMappingURL=push.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/commands/push.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH;;;;GAIG;AACH,iBAAe,oBAAoB,IAAI,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCxF;AAED,iBAAe,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEzD;AAaD,OAAO,EAAE,YAAY,IAAI,qBAAqB,EAAE,oBAAoB,IAAI,6BAA6B,EAAE,CAAC;AAExG,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBxD"}
@@ -0,0 +1,144 @@
1
+ /**
2
+ * Push Subcommands
3
+ *
4
+ * `quickback push generate-keys` — mints a fresh VAPID keypair (P-256)
5
+ * in the right format for config.push.vapidPublicKey / vapidPrivateKey,
6
+ * plus copy-pasteable wrangler secret commands.
7
+ */
8
+ import pc from 'picocolors';
9
+ import { webcrypto } from 'node:crypto';
10
+ import { writeFileSync } from 'node:fs';
11
+ import { resolve } from 'node:path';
12
+ const subtle = webcrypto.subtle;
13
+ function b64uEncode(bytes) {
14
+ return Buffer.from(bytes)
15
+ .toString('base64')
16
+ .replace(/\+/g, '-')
17
+ .replace(/\//g, '_')
18
+ .replace(/=+$/, '');
19
+ }
20
+ function b64uDecode(s) {
21
+ const pad = s.length % 4 === 0 ? '' : '='.repeat(4 - (s.length % 4));
22
+ return Buffer.from(s.replace(/-/g, '+').replace(/_/g, '/') + pad, 'base64');
23
+ }
24
+ /**
25
+ * Mint a fresh ECDH P-256 keypair and emit the public key as a 65-byte
26
+ * uncompressed point and the private key as the 32-byte scalar — both
27
+ * base64url-encoded, the format RFC 8292 VAPID expects.
28
+ */
29
+ async function generateVapidKeypair() {
30
+ // ECDH key generation produces the same P-256 keypair shape as ECDSA
31
+ // would, but the JWK exporter gives us cleaner access to the private
32
+ // scalar (d field). VAPID uses ECDSA at sign time — Web Crypto rebuilds
33
+ // the signing key from the same x/y/d when the helper imports it.
34
+ const kp = (await subtle.generateKey({ name: 'ECDH', namedCurve: 'P-256' }, true, ['deriveBits']));
35
+ // Public key: 65-byte uncompressed raw form (0x04 || x(32) || y(32)).
36
+ const pubRaw = new Uint8Array(await subtle.exportKey('raw', kp.publicKey));
37
+ if (pubRaw.length !== 65 || pubRaw[0] !== 0x04) {
38
+ throw new Error('Generated public key is not in expected 65-byte uncompressed form.');
39
+ }
40
+ // Private key: 32-byte scalar from JWK `d` field.
41
+ const jwk = await subtle.exportKey('jwk', kp.privateKey);
42
+ if (typeof jwk.d !== 'string') {
43
+ throw new Error('Generated private key has no d field — JWK export malformed.');
44
+ }
45
+ const dBytes = b64uDecode(jwk.d);
46
+ if (dBytes.length !== 32) {
47
+ // JWK d field can be left-padded with zeros; some implementations
48
+ // strip them. Re-pad to exactly 32 bytes for VAPID compatibility.
49
+ if (dBytes.length > 32) {
50
+ throw new Error(`Private scalar is ${dBytes.length} bytes; expected 32.`);
51
+ }
52
+ const padded = new Uint8Array(32);
53
+ padded.set(dBytes, 32 - dBytes.length);
54
+ return { publicKey: b64uEncode(pubRaw), privateKey: b64uEncode(padded) };
55
+ }
56
+ return { publicKey: b64uEncode(pubRaw), privateKey: b64uEncode(dBytes) };
57
+ }
58
+ async function generateKeys(args) {
59
+ console.log(pc.bold('\nQuickback — VAPID keypair generator\n'));
60
+ const outFlagIdx = args.findIndex((a) => a === '--out' || a === '-o');
61
+ const outPath = outFlagIdx >= 0 ? args[outFlagIdx + 1] : undefined;
62
+ if (outFlagIdx >= 0 && !outPath) {
63
+ console.error(pc.red('--out requires a file path, e.g. quickback push generate-keys --out .vapid-private-key'));
64
+ process.exit(1);
65
+ }
66
+ const { publicKey, privateKey } = await generateVapidKeypair();
67
+ console.log(pc.gray('Public key (base64url, 65-byte uncompressed P-256):'));
68
+ console.log(pc.cyan(publicKey));
69
+ console.log('');
70
+ if (outPath) {
71
+ // File mode: the private key NEVER touches stdout (or scrollback, or a
72
+ // terminal logger). 0600 so other local users can't read it either.
73
+ const resolved = resolve(outPath);
74
+ writeFileSync(resolved, privateKey + '\n', { mode: 0o600 });
75
+ console.log(pc.gray('Private key written to:'));
76
+ console.log(pc.cyan(resolved), pc.gray('(mode 0600 — not printed)'));
77
+ console.log('');
78
+ console.log(pc.bold('Next steps:'));
79
+ console.log('');
80
+ console.log(pc.gray('1. Set the private key as a wrangler secret, then delete the file:'));
81
+ console.log('');
82
+ console.log(` ${pc.cyan(`npx wrangler secret put VAPID_PRIVATE_KEY < ${outPath}`)}`);
83
+ console.log(` ${pc.cyan(`rm ${outPath}`)}`);
84
+ }
85
+ else {
86
+ console.log(pc.gray('Private key (base64url, 32-byte P-256 scalar):'));
87
+ console.log(pc.cyan(privateKey));
88
+ console.log('');
89
+ console.log(pc.gray('Tip: use'), pc.cyan('quickback push generate-keys --out .vapid-private-key'), pc.gray('to keep the'));
90
+ console.log(pc.gray('private key out of your terminal scrollback entirely.'));
91
+ console.log('');
92
+ console.log(pc.bold('Next steps:'));
93
+ console.log('');
94
+ console.log(pc.gray('1. Set the private key as a wrangler secret (NEVER commit it, and avoid'));
95
+ console.log(pc.gray(' echo-piping it — that lands the key in your shell history):'));
96
+ console.log('');
97
+ console.log(` ${pc.cyan('npx wrangler secret put VAPID_PRIVATE_KEY')}`);
98
+ console.log(pc.gray(' (wrangler prompts for the value — paste the private key above)'));
99
+ }
100
+ console.log('');
101
+ console.log(pc.gray('2. Add this to your quickback.config.ts:'));
102
+ console.log('');
103
+ console.log(pc.gray(' push: {'));
104
+ console.log(pc.gray(` provider: 'web-push',`));
105
+ console.log(pc.gray(` vapidPublicKey: '${publicKey}',`));
106
+ console.log(pc.gray(` vapidPrivateKey: 'env:VAPID_PRIVATE_KEY',`));
107
+ console.log(pc.gray(` vapidSubject: 'mailto:notifications@yourdomain.com',`));
108
+ console.log(pc.gray(' },'));
109
+ console.log('');
110
+ console.log(pc.gray('3. Recompile and deploy:'));
111
+ console.log('');
112
+ console.log(` ${pc.cyan('quickback compile')}`);
113
+ console.log(` ${pc.cyan('npx wrangler deploy')}`);
114
+ console.log('');
115
+ console.log(pc.yellow('⚠'), pc.gray('The private key is minted only once. If you lose it, generate a new pair'));
116
+ console.log(' ', pc.gray('and re-subscribe affected users — old subscriptions become unverifiable.'));
117
+ console.log('');
118
+ }
119
+ function printPushHelp() {
120
+ console.log(pc.bold('\nQuickback push commands\n'));
121
+ console.log('Usage:');
122
+ console.log(' quickback push <subcommand>');
123
+ console.log('');
124
+ console.log('Subcommands:');
125
+ console.log(` ${pc.cyan('generate-keys')} [--out <file>] Mint a fresh VAPID keypair (P-256, base64url).`);
126
+ console.log(pc.gray(' --out writes the private key to <file> (0600) instead of stdout.'));
127
+ console.log('');
128
+ }
129
+ export { generateKeys as __generateKeysForTest, generateVapidKeypair as __generateVapidKeypairForTest };
130
+ export async function push(args) {
131
+ const sub = args[0];
132
+ if (!sub || sub === 'help' || sub === '--help' || sub === '-h') {
133
+ printPushHelp();
134
+ return;
135
+ }
136
+ if (sub === 'generate-keys') {
137
+ await generateKeys(args.slice(1));
138
+ return;
139
+ }
140
+ console.error(pc.red(`Unknown push subcommand: ${sub}`));
141
+ printPushHelp();
142
+ process.exit(1);
143
+ }
144
+ //# sourceMappingURL=push.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/commands/push.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=push.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"push.test.d.ts","sourceRoot":"","sources":["../../src/commands/push.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,76 @@
1
+ /**
2
+ * `quickback push generate-keys` (port plan step 8).
3
+ *
4
+ * The security property under test: with `--out <file>`, the private key
5
+ * NEVER touches stdout — it goes to a 0600 file only. Key format is also
6
+ * verified (65-byte 0x04 public point, 32-byte private scalar, base64url).
7
+ */
8
+ import { afterEach, describe, expect, test } from 'bun:test';
9
+ import { mkdtempSync, readFileSync, rmSync, statSync } from 'node:fs';
10
+ import { join } from 'node:path';
11
+ import { tmpdir } from 'node:os';
12
+ import { __generateKeysForTest, __generateVapidKeypairForTest } from './push.js';
13
+ function b64uDecode(s) {
14
+ const pad = s.length % 4 === 0 ? '' : '='.repeat(4 - (s.length % 4));
15
+ return new Uint8Array(Buffer.from(s.replace(/-/g, '+').replace(/_/g, '/') + pad, 'base64'));
16
+ }
17
+ const realLog = console.log;
18
+ const realError = console.error;
19
+ afterEach(() => {
20
+ console.log = realLog;
21
+ console.error = realError;
22
+ });
23
+ function captureOutput() {
24
+ const captured = { lines: [] };
25
+ console.log = (...args) => { captured.lines.push(args.map(String).join(' ')); };
26
+ console.error = (...args) => { captured.lines.push(args.map(String).join(' ')); };
27
+ return captured;
28
+ }
29
+ describe('generateVapidKeypair — format', () => {
30
+ test('public key is a 65-byte uncompressed P-256 point, private a 32-byte scalar', async () => {
31
+ const { publicKey, privateKey } = await __generateVapidKeypairForTest();
32
+ const pub = b64uDecode(publicKey);
33
+ expect(pub.length).toBe(65);
34
+ expect(pub[0]).toBe(0x04);
35
+ expect(b64uDecode(privateKey).length).toBe(32);
36
+ // base64url alphabet only
37
+ expect(publicKey).toMatch(/^[A-Za-z0-9_-]+$/);
38
+ expect(privateKey).toMatch(/^[A-Za-z0-9_-]+$/);
39
+ });
40
+ });
41
+ describe('generate-keys --out — private key never on stdout', () => {
42
+ test('writes the private key to a 0600 file and prints only the public key', async () => {
43
+ const dir = mkdtempSync(join(tmpdir(), 'qb-push-keys-'));
44
+ const outPath = join(dir, 'vapid-key');
45
+ try {
46
+ const captured = captureOutput();
47
+ await __generateKeysForTest(['--out', outPath]);
48
+ console.log = realLog;
49
+ const privateKey = readFileSync(outPath, 'utf8').trim();
50
+ expect(b64uDecode(privateKey).length).toBe(32);
51
+ // 0600 — other local users can't read the scalar.
52
+ expect(statSync(outPath).mode & 0o777).toBe(0o600);
53
+ const stdout = captured.lines.join('\n');
54
+ // THE property: the private scalar never appears in terminal output.
55
+ expect(stdout).not.toContain(privateKey);
56
+ // The public key DOES print (it's not a secret and config needs it).
57
+ const pubLine = captured.lines.find((l) => /[A-Za-z0-9_-]{86,88}/.test(l.replace(/\x1b\[[0-9;]*m/g, '')));
58
+ expect(pubLine).toBeDefined();
59
+ // And the follow-up instructions reference the secret-put-from-file flow.
60
+ expect(stdout).toContain('wrangler secret put VAPID_PRIVATE_KEY <');
61
+ }
62
+ finally {
63
+ rmSync(dir, { recursive: true, force: true });
64
+ }
65
+ });
66
+ test('without --out the key prints once and no echo-pipe is suggested', async () => {
67
+ const captured = captureOutput();
68
+ await __generateKeysForTest([]);
69
+ console.log = realLog;
70
+ const stdout = captured.lines.join('\n');
71
+ // Interactive prompt flow, not `echo "<key>" |` (shell-history leak).
72
+ expect(stdout).not.toContain('echo "');
73
+ expect(stdout).toContain('wrangler secret put VAPID_PRIVATE_KEY');
74
+ });
75
+ });
76
+ //# sourceMappingURL=push.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"push.test.js","sourceRoot":"","sources":["../../src/commands/push.test.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/docs/content.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA6fzC,CAAC;AAEF,eAAO,MAAM,UAAU,UAgItB,CAAC"}
1
+ {"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/docs/content.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAqgBzC,CAAC;AAEF,eAAO,MAAM,UAAU,UAkItB,CAAC"}