@quickback-dev/cli 0.51.0 → 0.51.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 (82) hide show
  1. package/dist/commands/compile.d.ts.map +1 -1
  2. package/dist/commands/compile.js +34 -19
  3. package/dist/commands/compile.js.map +1 -1
  4. package/dist/docs/content.js +19 -19
  5. package/dist/docs/content.js.map +1 -1
  6. package/dist/index.js +1 -1
  7. package/dist/lib/action-harvest.d.ts +35 -4
  8. package/dist/lib/action-harvest.d.ts.map +1 -1
  9. package/dist/lib/action-harvest.js +233 -50
  10. package/dist/lib/action-harvest.js.map +1 -1
  11. package/dist/lib/action-harvest.test.js +130 -2
  12. package/dist/lib/action-harvest.test.js.map +1 -1
  13. package/dist/lib/auth.d.ts +6 -0
  14. package/dist/lib/auth.d.ts.map +1 -1
  15. package/dist/lib/auth.js +18 -1
  16. package/dist/lib/auth.js.map +1 -1
  17. package/dist/lib/auth.test.d.ts +2 -0
  18. package/dist/lib/auth.test.d.ts.map +1 -0
  19. package/dist/lib/auth.test.js +19 -0
  20. package/dist/lib/auth.test.js.map +1 -0
  21. package/dist/lib/compile-next-steps.d.ts +4 -0
  22. package/dist/lib/compile-next-steps.d.ts.map +1 -0
  23. package/dist/lib/compile-next-steps.js +69 -0
  24. package/dist/lib/compile-next-steps.js.map +1 -0
  25. package/dist/lib/compile-next-steps.test.d.ts +2 -0
  26. package/dist/lib/compile-next-steps.test.d.ts.map +1 -0
  27. package/dist/lib/compile-next-steps.test.js +76 -0
  28. package/dist/lib/compile-next-steps.test.js.map +1 -0
  29. package/dist/lib/file-loader.d.ts.map +1 -1
  30. package/dist/lib/file-loader.js +1 -0
  31. package/dist/lib/file-loader.js.map +1 -1
  32. package/dist/lib/file-writer.d.ts +1 -1
  33. package/dist/lib/file-writer.d.ts.map +1 -1
  34. package/dist/lib/file-writer.js +20 -5
  35. package/dist/lib/file-writer.js.map +1 -1
  36. package/dist/lib/file-writer.test.d.ts +2 -0
  37. package/dist/lib/file-writer.test.d.ts.map +1 -0
  38. package/dist/lib/file-writer.test.js +90 -0
  39. package/dist/lib/file-writer.test.js.map +1 -0
  40. package/dist/lib/shell.test.d.ts +2 -0
  41. package/dist/lib/shell.test.d.ts.map +1 -0
  42. package/dist/lib/shell.test.js +39 -0
  43. package/dist/lib/shell.test.js.map +1 -0
  44. package/dist/skill/docs/changelog.md +401 -1
  45. package/dist/skill/docs/compiler/cloud-compiler/cli.md +16 -0
  46. package/dist/skill/docs/compiler/cloud-compiler/endpoints.md +4 -2
  47. package/dist/skill/docs/compiler/cloud-compiler/local-compiler.md +17 -5
  48. package/dist/skill/docs/compiler/config/auth.md +17 -2
  49. package/dist/skill/docs/compiler/config/index.md +271 -12
  50. package/dist/skill/docs/compiler/config/output.md +49 -3
  51. package/dist/skill/docs/compiler/config/providers.md +12 -1
  52. package/dist/skill/docs/compiler/config/variables.md +5 -0
  53. package/dist/skill/docs/compiler/definitions/access.md +7 -0
  54. package/dist/skill/docs/compiler/definitions/actions.md +156 -9
  55. package/dist/skill/docs/compiler/definitions/firewall.md +6 -1
  56. package/dist/skill/docs/compiler/definitions/schema.md +12 -0
  57. package/dist/skill/docs/compiler/targets/hono-api/database/neon.md +353 -20
  58. package/dist/skill/docs/compiler/targets/hono-api/using-the-api/index.md +7 -1
  59. package/dist/skill/docs/stack/account-ui/hooks.md +104 -1
  60. package/dist/skill/docs/stack/auth/plugins/aws-sns.md +20 -3
  61. package/dist/skill/docs/stack/cms/schema-format.md +4 -2
  62. package/dist/skill/docs/stack/cms/schema-registry.md +4 -2
  63. package/package.json +1 -1
  64. package/src/skill/docs/changelog.md +401 -1
  65. package/src/skill/docs/compiler/cloud-compiler/cli.md +16 -0
  66. package/src/skill/docs/compiler/cloud-compiler/endpoints.md +4 -2
  67. package/src/skill/docs/compiler/cloud-compiler/local-compiler.md +17 -5
  68. package/src/skill/docs/compiler/config/auth.md +17 -2
  69. package/src/skill/docs/compiler/config/index.md +271 -12
  70. package/src/skill/docs/compiler/config/output.md +49 -3
  71. package/src/skill/docs/compiler/config/providers.md +12 -1
  72. package/src/skill/docs/compiler/config/variables.md +5 -0
  73. package/src/skill/docs/compiler/definitions/access.md +7 -0
  74. package/src/skill/docs/compiler/definitions/actions.md +156 -9
  75. package/src/skill/docs/compiler/definitions/firewall.md +6 -1
  76. package/src/skill/docs/compiler/definitions/schema.md +12 -0
  77. package/src/skill/docs/compiler/targets/hono-api/database/neon.md +353 -20
  78. package/src/skill/docs/compiler/targets/hono-api/using-the-api/index.md +7 -1
  79. package/src/skill/docs/stack/account-ui/hooks.md +104 -1
  80. package/src/skill/docs/stack/auth/plugins/aws-sns.md +20 -3
  81. package/src/skill/docs/stack/cms/schema-format.md +4 -2
  82. package/src/skill/docs/stack/cms/schema-registry.md +4 -2
@@ -121,14 +121,27 @@ import { sendSMSWithSNS, smsTemplates, isValidE164 } from "@quickback-dev/better
121
121
  function getSNSConfig(env: CloudflareBindings | undefined): SNSConfig { /* ... */ }
122
122
 
123
123
  function createAuth(env, cf, executionCtx) {
124
- const fireAndForget = (p) => { /* waitUntil(p) */ };
124
+ const scheduleCredentialDelivery = (delivery) => {
125
+ const observed = delivery.catch(() => {
126
+ console.error(JSON.stringify({
127
+ level: "error",
128
+ event: "auth.credential_delivery_failed",
129
+ }));
130
+ throw new Error("Auth credential delivery failed");
131
+ });
132
+ if (executionCtx) {
133
+ executionCtx.waitUntil(observed);
134
+ return Promise.resolve();
135
+ }
136
+ return observed;
137
+ };
125
138
 
126
139
  return betterAuth({
127
140
  plugins: [
128
141
  phoneNumber({
129
142
  phoneNumberValidator: isValidE164,
130
143
  sendOTP: async ({ phoneNumber, code }) => {
131
- fireAndForget(sendSMSWithSNS(getSNSConfig(env), {
144
+ return scheduleCredentialDelivery(sendSMSWithSNS(getSNSConfig(env), {
132
145
  to: phoneNumber,
133
146
  message: smsTemplates.otp.message({ code, appName: ... }),
134
147
  }));
@@ -140,7 +153,11 @@ function createAuth(env, cf, executionCtx) {
140
153
  }
141
154
  ```
142
155
 
143
- That's the contract: callbacks are fire-and-forget via `executionCtx.waitUntil`, never `await`ed.
156
+ That's the contract: Workers callbacks return after `waitUntil` accepts an
157
+ observed, still-rejecting task, so provider latency stays out of the response.
158
+ Without an execution context, the callback returns the observed promise for the
159
+ caller to await. Failures are logged generically without provider error content
160
+ and are never swallowed.
144
161
 
145
162
  ## Sign-in flow
146
163
 
@@ -8,7 +8,6 @@ The top-level type:
8
8
 
9
9
  ```typescript
10
10
  interface SchemaRegistry {
11
- generatedAt: string;
12
11
  generatedBy: string;
13
12
  version: string;
14
13
  features: Record<string, string[]>;
@@ -22,7 +21,6 @@ interface SchemaRegistry {
22
21
 
23
22
  | Field | Description |
24
23
  |-------|-------------|
25
- | `generatedAt` | ISO 8601 timestamp of when the registry was generated |
26
24
  | `generatedBy` | Always `"quickback-compiler"` |
27
25
  | `version` | Compiler version string |
28
26
  | `features` | Map of feature name to array of source file names |
@@ -32,6 +30,10 @@ interface SchemaRegistry {
32
30
  | `pages` | Map of page slug to full page metadata |
33
31
  | `pagesByFeature` | Map of feature name to array of page slugs in that feature |
34
32
 
33
+ The registry deliberately omits wall-clock generation metadata. Every field is
34
+ derived from compiler inputs, so identical logical input produces
35
+ byte-identical `schema-registry.json` output across consecutive compiles.
36
+
35
37
  ## TableMeta
36
38
 
37
39
  Full metadata for a single table:
@@ -21,7 +21,6 @@ The top-level structure of `schema-registry.json`:
21
21
 
22
22
  ```json
23
23
  {
24
- "generatedAt": "2026-02-14T06:26:53.554Z",
25
24
  "generatedBy": "quickback-compiler",
26
25
  "version": "1.0.0",
27
26
  "features": { ... },
@@ -35,7 +34,6 @@ The top-level structure of `schema-registry.json`:
35
34
 
36
35
  | Field | Type | Description |
37
36
  |-------|------|-------------|
38
- | `generatedAt` | `string` | ISO timestamp of generation |
39
37
  | `generatedBy` | `string` | Always `"quickback-compiler"` |
40
38
  | `version` | `string` | Compiler version used |
41
39
  | `features` | `Record<string, string[]>` | Feature name to file list mapping |
@@ -45,6 +43,10 @@ The top-level structure of `schema-registry.json`:
45
43
  | `pages` | `Record<string, PageMeta>` | Page slug to full page metadata |
46
44
  | `pagesByFeature` | `Record<string, string[]>` | Feature name to page slug list |
47
45
 
46
+ The registry contains no wall-clock generation timestamp. Its bytes are fully
47
+ derived from the logical compiler input, so repeated compiles are stable for
48
+ artifact hashing, caches, and deployment diffs.
49
+
48
50
  ## TableMeta
49
51
 
50
52
  Each table entry contains everything the CMS needs to render its UI: