@quickback-dev/cli 0.60.1 → 0.60.3

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 (75) hide show
  1. package/dist/commands/compile.d.ts.map +1 -1
  2. package/dist/commands/compile.js +1 -9
  3. package/dist/commands/compile.js.map +1 -1
  4. package/dist/commands/cursor.d.ts.map +1 -1
  5. package/dist/commands/cursor.js +6 -7
  6. package/dist/commands/cursor.js.map +1 -1
  7. package/dist/commands/deploy.d.ts.map +1 -1
  8. package/dist/commands/deploy.js +1 -9
  9. package/dist/commands/deploy.js.map +1 -1
  10. package/dist/commands/docs.d.ts.map +1 -1
  11. package/dist/commands/docs.js +3 -1
  12. package/dist/commands/docs.js.map +1 -1
  13. package/dist/commands/mcp.d.ts.map +1 -1
  14. package/dist/commands/mcp.js +3 -1
  15. package/dist/commands/mcp.js.map +1 -1
  16. package/dist/commands/migrations.d.ts.map +1 -1
  17. package/dist/commands/migrations.js +1 -9
  18. package/dist/commands/migrations.js.map +1 -1
  19. package/dist/docs/index.d.ts +25 -0
  20. package/dist/docs/index.d.ts.map +1 -0
  21. package/dist/docs/index.js +70 -0
  22. package/dist/docs/index.js.map +1 -0
  23. package/dist/docs/index.test.d.ts +2 -0
  24. package/dist/docs/index.test.d.ts.map +1 -0
  25. package/dist/docs/index.test.js +51 -0
  26. package/dist/docs/index.test.js.map +1 -0
  27. package/dist/index.js +1 -1
  28. package/dist/lib/auth.d.ts +0 -4
  29. package/dist/lib/auth.d.ts.map +1 -1
  30. package/dist/lib/auth.js +0 -16
  31. package/dist/lib/auth.js.map +1 -1
  32. package/dist/lib/compiler-stubs.d.ts +22 -67
  33. package/dist/lib/compiler-stubs.d.ts.map +1 -1
  34. package/dist/lib/compiler-stubs.js +35 -100
  35. package/dist/lib/compiler-stubs.js.map +1 -1
  36. package/dist/lib/copy-passthrough.d.ts +43 -0
  37. package/dist/lib/copy-passthrough.d.ts.map +1 -0
  38. package/dist/lib/copy-passthrough.js +118 -0
  39. package/dist/lib/copy-passthrough.js.map +1 -0
  40. package/dist/lib/copy-public-assets.d.ts +19 -22
  41. package/dist/lib/copy-public-assets.d.ts.map +1 -1
  42. package/dist/lib/copy-public-assets.js +20 -99
  43. package/dist/lib/copy-public-assets.js.map +1 -1
  44. package/dist/lib/copy-source-apps.d.ts +22 -20
  45. package/dist/lib/copy-source-apps.d.ts.map +1 -1
  46. package/dist/lib/copy-source-apps.js +21 -105
  47. package/dist/lib/copy-source-apps.js.map +1 -1
  48. package/dist/lib/file-writer.d.ts +0 -5
  49. package/dist/lib/file-writer.d.ts.map +1 -1
  50. package/dist/lib/file-writer.js +0 -17
  51. package/dist/lib/file-writer.js.map +1 -1
  52. package/dist/lib/prepare-output.d.ts.map +1 -1
  53. package/dist/lib/prepare-output.js +1 -9
  54. package/dist/lib/prepare-output.js.map +1 -1
  55. package/dist/skill/docs/configure/index.md +3 -0
  56. package/dist/skill/docs/platform/database/d1.md +98 -0
  57. package/dist/skill/docs/platform/database/neon.md +14 -7
  58. package/dist/skill/docs/start/deploy-browser.md +37 -2
  59. package/dist/templates/registry.d.ts +0 -5
  60. package/dist/templates/registry.d.ts.map +1 -1
  61. package/dist/templates/registry.js +0 -21
  62. package/dist/templates/registry.js.map +1 -1
  63. package/package.json +2 -3
  64. package/src/skill/docs/configure/index.md +3 -0
  65. package/src/skill/docs/platform/database/d1.md +98 -0
  66. package/src/skill/docs/platform/database/neon.md +14 -7
  67. package/src/skill/docs/start/deploy-browser.md +37 -2
  68. package/dist/docs/content.d.ts +0 -7
  69. package/dist/docs/content.d.ts.map +0 -1
  70. package/dist/docs/content.js +0 -737
  71. package/dist/docs/content.js.map +0 -1
  72. package/dist/lib/helpers.d.ts +0 -39
  73. package/dist/lib/helpers.d.ts.map +0 -1
  74. package/dist/lib/helpers.js +0 -299
  75. package/dist/lib/helpers.js.map +0 -1
@@ -4,7 +4,7 @@ Build a backend in [Quickback Start](https://start.quickback.dev), get a green c
4
4
 
5
5
  This page covers the browser flow. For local projects, or anything the browser flow doesn't support yet, use [`quickback deploy`](/start/deploy) — the CLI covers every resource type and is always available.
6
6
 
7
- > Browser deployment is rolling out. The hosted deploy service ships fail-closed behind a kill switch while the final authentication work lands; if the Deploy card doesn't appear in Start, your session isn't in the rollout yet. `quickback deploy` works for everyone today.
7
+ > Browser deployment is new. The hosted deploy service sits behind a kill switch, and provisioning is rate-limited to 5 deploys per minute per user — enough to stop a runaway retry loop, not something a normal deploy will ever hit. `quickback deploy` works for everyone today.
8
8
 
9
9
 
10
10
  ## Browser vs CLI
@@ -75,6 +75,41 @@ What's requested, and why:
75
75
 
76
76
  Nothing broader is requested — no zone, DNS, billing, or account-management access.
77
77
 
78
+ If you cancel at Cloudflare's consent screen — or Cloudflare ends the attempt for any other reason — you land back in Start with the card explaining what happened and a **Try Cloudflare again** button. Nothing is stored on a cancelled attempt, and a connection you already had is left untouched.
79
+
80
+ ## Connection states and recovery
81
+
82
+ The deploy card is the whole connection UI: it reports the state of your Cloudflare connection and offers exactly one thing to do about it.
83
+
84
+ | What you see | What happened | What to do |
85
+ |---|---|---|
86
+ | **Connect your Cloudflare account** | No connection stored | **Continue with Cloudflare** |
87
+ | Masked email badge, green | Connected and healthy | Deploy |
88
+ | "This connection expires in N minutes" | The access token is near the end of its life | Nothing yet — reconnect when it lapses |
89
+ | Badge turns amber, "· reconnect" | Token expired, grant revoked in Cloudflare, or the connection was deleted | **Reconnect Cloudflare** — one consent, same connection record |
90
+ | "This Cloudflare connection can't …" | The grant is missing a permission a deploy needs (an older connection, or a scope your OAuth client didn't allow) | **Reconnect Cloudflare** to grant the rest |
91
+ | "This Cloudflare login isn't a member of any account" | The identity you connected belongs to no Cloudflare account | Create or join an account in the Cloudflare dashboard, then reconnect |
92
+ | "Couldn't reach the deploy service…" | Transient failure talking to Quickback or Cloudflare | **Try again** |
93
+ | "Browser deploys aren't fully configured on the server yet" | A deploy-service misconfiguration, not anything on your side | Use [`quickback deploy`](/start/deploy) for now |
94
+ | "Too many deploys in a minute" | More than 5 provisions in a minute on one account | Wait for the `Retry-After` window and click Deploy again |
95
+
96
+ Deploy is disabled while a reconnect is pending, so a deploy never starts on a connection that can't finish it. If a connection dies *during* a deploy, the failure comes back as a reconnect prompt rather than a raw error — the deploy is safe to re-run after reconnecting, because provisioning adopts and migrations apply once.
97
+
98
+ ### Reconnecting
99
+
100
+ **Reconnect** re-runs the same consent and lands on the **same connection record** — your account picker, deploys, and claim links all keep working. Reconnecting is also how you widen a grant that's missing a permission.
101
+
102
+ ### Connecting more than one Cloudflare account
103
+
104
+ Connect a second Cloudflare login with **Connect another** and the card grows a login picker above the account picker. Start remembers which one you deployed with last and preselects it.
105
+
106
+ ### Disconnecting vs. revoking
107
+
108
+ Two different things, and you usually want both:
109
+
110
+ - **Disconnect** (in the card) makes Quickback forget the connection and its stored token. It doesn't touch anything in your Cloudflare account, and it never touches deployed apps — they're plain Workers in your account and keep running.
111
+ - **Revoke** (Cloudflare dashboard → **My Profile → Access Management → Connected Applications**, linked from the card) withdraws the grant itself. The stored ciphertext becomes useless immediately; the next thing Start tries turns into a reconnect prompt.
112
+
78
113
  ## Where your token lives
79
114
 
80
115
  The OAuth token never reaches your browser, the chat model, or the compiler. It is held by the deploy service and:
@@ -83,7 +118,7 @@ The OAuth token never reaches your browser, the chat model, or the compiler. It
83
118
  - bound to its connection record (the ciphertext is unusable if copied elsewhere);
84
119
  - decrypted only inside the API calls of an active deploy, then discarded.
85
120
 
86
- Tokens expire; when one does, Start shows a reconnect prompt and a fresh consent re-issues it onto the same connection. Revoking in Cloudflare kills the token immediately — the stored ciphertext becomes useless.
121
+ Tokens expire; when one does, Start shows a reconnect prompt and a fresh consent re-issues it onto the same connection. Revoking in Cloudflare kills the token immediately — the stored ciphertext becomes useless, and the card turns the next failed call into that same reconnect prompt. See [Connection states and recovery](#connection-states-and-recovery) for the full set.
87
122
 
88
123
  ## Secrets on the deployed app
89
124
 
@@ -1,7 +0,0 @@
1
- export interface DocEntry {
2
- title: string;
3
- content: string;
4
- }
5
- export declare const DOCS: Record<string, DocEntry>;
6
- export declare const TOPIC_LIST: string[];
7
- //# sourceMappingURL=content.d.ts.map
@@ -1 +0,0 @@
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,CAykBzC,CAAC;AAEF,eAAO,MAAM,UAAU,UAmJtB,CAAC"}