@quickback-dev/cli 0.64.1 → 0.65.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 (73) hide show
  1. package/dist/codex/AGENTS.md +290 -0
  2. package/dist/commands/codex.d.ts +16 -0
  3. package/dist/commands/codex.d.ts.map +1 -0
  4. package/dist/commands/codex.js +159 -0
  5. package/dist/commands/codex.js.map +1 -0
  6. package/dist/commands/init.d.ts +6 -0
  7. package/dist/commands/init.d.ts.map +1 -0
  8. package/dist/commands/init.js +405 -0
  9. package/dist/commands/init.js.map +1 -0
  10. package/dist/docs/content.d.ts.map +1 -1
  11. package/dist/docs/content.js +94 -159
  12. package/dist/docs/content.js.map +1 -1
  13. package/dist/index.js +1 -1
  14. package/dist/lib/action-harvest.d.ts.map +1 -1
  15. package/dist/lib/action-harvest.js +6 -1
  16. package/dist/lib/action-harvest.js.map +1 -1
  17. package/dist/lib/action-harvest.test.js +19 -0
  18. package/dist/lib/action-harvest.test.js.map +1 -1
  19. package/dist/lib/compiler-stubs.d.ts +10 -0
  20. package/dist/lib/compiler-stubs.d.ts.map +1 -1
  21. package/dist/lib/compiler-stubs.js +16 -0
  22. package/dist/lib/compiler-stubs.js.map +1 -1
  23. package/dist/lib/file-writer.js +23 -0
  24. package/dist/lib/file-writer.js.map +1 -1
  25. package/dist/lib/file-writer.test.js +25 -0
  26. package/dist/lib/file-writer.test.js.map +1 -1
  27. package/dist/lib/sweep-stale.d.ts +25 -0
  28. package/dist/lib/sweep-stale.d.ts.map +1 -0
  29. package/dist/lib/sweep-stale.js +179 -0
  30. package/dist/lib/sweep-stale.js.map +1 -0
  31. package/dist/lib/sweep-stale.test.d.ts +2 -0
  32. package/dist/lib/sweep-stale.test.d.ts.map +1 -0
  33. package/dist/lib/sweep-stale.test.js +130 -0
  34. package/dist/lib/sweep-stale.test.js.map +1 -0
  35. package/dist/skill/docs/api/actions.md +6 -20
  36. package/dist/skill/docs/changelog/index.md +23 -2
  37. package/dist/skill/docs/configure/bindings.md +1 -1
  38. package/dist/skill/docs/configure/domains.md +4 -2
  39. package/dist/skill/docs/configure/variables.md +2 -2
  40. package/dist/skill/docs/define/actions/defining.md +12 -0
  41. package/dist/skill/docs/define/authz-roles.md +52 -0
  42. package/dist/skill/docs/platform/auth/plugins/aws-ses.md +6 -18
  43. package/dist/skill/docs/platform/auth/plugins/aws-sns.md +4 -4
  44. package/dist/skill/docs/platform/auth/plugins/index.md +21 -1
  45. package/dist/skill/docs/platform/auth/plugins/subscriptions.md +297 -0
  46. package/dist/skill/docs/platform/payments/dev-loop.md +228 -0
  47. package/dist/skill/docs/platform/payments/index.md +158 -0
  48. package/dist/skill/docs/platform/payments/one-off-checkout.md +266 -0
  49. package/dist/skill/docs/platform/realtime/index.md +2 -1
  50. package/dist/skill/docs/platform/realtime/using-realtime.md +7 -5
  51. package/dist/skill/docs/platform/storage/r2.md +12 -0
  52. package/dist/skill/docs/platform/webhooks/inbound.md +5 -2
  53. package/dist/skill/docs/start/template-cloudflare.md +1 -1
  54. package/package.json +1 -1
  55. package/src/skill/docs/api/actions.md +6 -20
  56. package/src/skill/docs/changelog/index.md +23 -2
  57. package/src/skill/docs/configure/bindings.md +1 -1
  58. package/src/skill/docs/configure/domains.md +4 -2
  59. package/src/skill/docs/configure/variables.md +2 -2
  60. package/src/skill/docs/define/actions/defining.md +12 -0
  61. package/src/skill/docs/define/authz-roles.md +52 -0
  62. package/src/skill/docs/platform/auth/plugins/aws-ses.md +6 -18
  63. package/src/skill/docs/platform/auth/plugins/aws-sns.md +4 -4
  64. package/src/skill/docs/platform/auth/plugins/index.md +21 -1
  65. package/src/skill/docs/platform/auth/plugins/subscriptions.md +297 -0
  66. package/src/skill/docs/platform/payments/dev-loop.md +228 -0
  67. package/src/skill/docs/platform/payments/index.md +158 -0
  68. package/src/skill/docs/platform/payments/one-off-checkout.md +266 -0
  69. package/src/skill/docs/platform/realtime/index.md +2 -1
  70. package/src/skill/docs/platform/realtime/using-realtime.md +7 -5
  71. package/src/skill/docs/platform/storage/r2.md +12 -0
  72. package/src/skill/docs/platform/webhooks/inbound.md +5 -2
  73. package/src/skill/docs/start/template-cloudflare.md +1 -1
@@ -214,11 +214,13 @@ new_classes = ["Broadcaster"]
214
214
 
215
215
  ## CloudEvents envelopes (contract v2)
216
216
 
217
- On `contract: { version: "v2" }` the WebSocket endpoint moves to
218
- `/broadcast/v2` and every **data frame** is wrapped in a
217
+ On `contract: { version: "v2" }` every **data frame** is wrapped in a
219
218
  [CloudEvents 1.0](https://cloudevents.io) envelope at the Durable Object's
220
- send boundary. Control frames (`pong`, `error`, `reauth_ok`) stay raw on both
221
- versions, and pinned-v1 projects keep the raw frames byte-identically.
219
+ send boundary. The endpoint does **not** move — the path segment tracks
220
+ `contract.routes` (so `/broadcast/v1` unless you also set `routes: "v2"`);
221
+ `version` changes only the frame format. Control frames (`pong`, `error`,
222
+ `reauth_ok`) stay raw on both versions, and pinned-v1 projects keep the raw
223
+ frames byte-identically.
222
224
 
223
225
  | v1 frame | CloudEvents `type` | `data` | extensions |
224
226
  |---|---|---|---|
@@ -241,7 +243,7 @@ as a normal `postgres_changes` frame on the table's room.
241
243
  ```json
242
244
  { "specversion": "1.0",
243
245
  "id": "evt_9f2…",
244
- "source": "/broadcast/v2/websocket",
246
+ "source": "/broadcast/v1/websocket",
245
247
  "type": "event.mobile-bundle.changed",
246
248
  "time": "2026-07-20T12:00:00Z",
247
249
  "datacontenttype": "application/json",
@@ -76,6 +76,7 @@ export default {
76
76
  fileStorage: {
77
77
  name: 'cloudflare-r2',
78
78
  config: {
79
+ managed: true,
79
80
  binding: 'R2_BUCKET',
80
81
  bucketName: 'my-app-files',
81
82
  filesBinding: 'FILES_DB',
@@ -87,6 +88,17 @@ export default {
87
88
  };
88
89
  ```
89
90
 
91
+ > `managed: true` is what turns on everything on this page — the `/storage/v1/*`
92
+ > routes, the files worker, and the `FILES_DB` metadata database. Without it R2
93
+ > file storage is **presign-only**: the compiler signs requests against the
94
+ > bucket by name and emits **no** bucket binding into `wrangler.toml`, so
95
+ > `binding` and `filesBinding` are ignored and `env.R2_BUCKET` is `undefined`
96
+ > at runtime (the compile warns when you set them anyway).
97
+ >
98
+ > To read the bucket directly from your own code in presign-only mode, declare
99
+ > it yourself under [`bindings.r2Buckets`](/configure/bindings).
100
+
101
+
90
102
  ## API Endpoints
91
103
 
92
104
  ### Storage API (api.yourdomain.com/storage/v1)
@@ -82,10 +82,13 @@ onWebhookEvent("stripe:invoice.paid", async (ctx) => {
82
82
  });
83
83
  ```
84
84
 
85
- `data.object` is an open record. Cast it when you need inner-field typing:
85
+ `data.object` is an open record. Cast it when you need inner-field typing — and
86
+ route the cast **through `unknown`**. `ctx.data` is a `Record<string, unknown>`,
87
+ which does not sufficiently overlap a Stripe resource interface, so the direct
88
+ one-step form is a `TS2352` error:
86
89
 
87
90
  ```typescript
88
- const session = ctx.data as import("stripe").Stripe.Checkout.Session;
91
+ const session = ctx.data as unknown as import("stripe").Stripe.Checkout.Session;
89
92
  ```
90
93
 
91
94
  **Execution order:**
@@ -204,7 +204,7 @@ Depending on your configuration, the compiler may also generate bindings for:
204
204
 
205
205
  | Binding | Type | When Generated |
206
206
  |---------|------|----------------|
207
- | `R2_BUCKET` | R2 Bucket | `fileStorage` configured |
207
+ | `R2_BUCKET` | R2 Bucket | **managed** `fileStorage` — `{ managed: true }` (presign-only emits no binding) |
208
208
  | `AI` | Workers AI | `embeddings` configured on any feature |
209
209
  | `VECTORIZE` | Vectorize Index | `embeddings` configured |
210
210
  | `EMBEDDINGS_QUEUE` | Queue | `embeddings` configured |