@quickback-dev/cli 0.66.1 → 0.66.2

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 (199) hide show
  1. package/README.md +7 -4
  2. package/dist/commands/build.d.ts +51 -0
  3. package/dist/commands/build.d.ts.map +1 -0
  4. package/dist/commands/build.js +793 -0
  5. package/dist/commands/build.js.map +1 -0
  6. package/dist/commands/build.test.d.ts +2 -0
  7. package/dist/commands/build.test.d.ts.map +1 -0
  8. package/dist/commands/build.test.js +150 -0
  9. package/dist/commands/build.test.js.map +1 -0
  10. package/dist/commands/check.d.ts +2 -2
  11. package/dist/commands/check.js +4 -4
  12. package/dist/commands/check.js.map +1 -1
  13. package/dist/commands/create.d.ts +1 -1
  14. package/dist/commands/create.js +7 -7
  15. package/dist/commands/create.js.map +1 -1
  16. package/dist/commands/deploy.d.ts +6 -6
  17. package/dist/commands/deploy.js +23 -23
  18. package/dist/commands/deploy.js.map +1 -1
  19. package/dist/commands/example.js +1 -1
  20. package/dist/commands/example.js.map +1 -1
  21. package/dist/commands/mcp.js +1 -1
  22. package/dist/commands/mcp.js.map +1 -1
  23. package/dist/commands/migrate.d.ts +1 -1
  24. package/dist/commands/migrate.js +3 -3
  25. package/dist/commands/migrate.js.map +1 -1
  26. package/dist/commands/migrations.js +2 -2
  27. package/dist/commands/migrations.js.map +1 -1
  28. package/dist/commands/push.js +1 -1
  29. package/dist/commands/push.js.map +1 -1
  30. package/dist/commands/start.js +1 -1
  31. package/dist/commands/start.js.map +1 -1
  32. package/dist/cursor/quickback.mdc +1 -1
  33. package/dist/index.js +18 -15
  34. package/dist/index.js.map +1 -1
  35. package/dist/lib/auth.js +1 -1
  36. package/dist/lib/auth.js.map +1 -1
  37. package/dist/lib/compiler-floor.d.ts +1 -1
  38. package/dist/lib/compiler-floor.js +1 -1
  39. package/dist/lib/file-loader.js +2 -2
  40. package/dist/lib/file-loader.js.map +1 -1
  41. package/dist/lib/file-writer.d.ts +2 -0
  42. package/dist/lib/file-writer.d.ts.map +1 -1
  43. package/dist/lib/file-writer.js +16 -0
  44. package/dist/lib/file-writer.js.map +1 -1
  45. package/dist/lib/file-writer.test.js +16 -0
  46. package/dist/lib/file-writer.test.js.map +1 -1
  47. package/dist/lib/migrations/file-envelopes.js +3 -3
  48. package/dist/lib/migrations/file-envelopes.js.map +1 -1
  49. package/dist/lib/prepare-output.test.js +1 -1
  50. package/dist/lib/prepare-output.test.js.map +1 -1
  51. package/dist/lib/schema-sync/index.js +1 -1
  52. package/dist/lib/schema-sync/index.test.js +1 -1
  53. package/dist/lib/schema-sync/index.test.js.map +1 -1
  54. package/dist/skill/SKILL.md +6 -6
  55. package/dist/skill/docs/api/crud.md +7 -0
  56. package/dist/skill/docs/api/index.md +1 -1
  57. package/dist/skill/docs/api/openapi.md +1 -1
  58. package/dist/skill/docs/changelog/index.md +19 -1
  59. package/dist/skill/docs/configure/agents.md +1 -1
  60. package/dist/skill/docs/configure/index.md +8 -3
  61. package/dist/skill/docs/configure/providers.md +1 -0
  62. package/dist/skill/docs/configure/variables.md +3 -3
  63. package/dist/skill/docs/define/access.md +7 -0
  64. package/dist/skill/docs/define/actions/defining.md +35 -7
  65. package/dist/skill/docs/define/actions/record-and-standalone.md +7 -4
  66. package/dist/skill/docs/define/actions/scoped-db.md +46 -16
  67. package/dist/skill/docs/define/areas.md +1 -1
  68. package/dist/skill/docs/define/diagnostics.md +1 -0
  69. package/dist/skill/docs/define/encryption.md +1 -1
  70. package/dist/skill/docs/define/feature.md +14 -7
  71. package/dist/skill/docs/define/guards.md +27 -3
  72. package/dist/skill/docs/define/schema.md +24 -14
  73. package/dist/skill/docs/define/security.md +1 -1
  74. package/dist/skill/docs/define/transitions.md +35 -4
  75. package/dist/skill/docs/define/views.md +33 -0
  76. package/dist/skill/docs/index.md +2 -2
  77. package/dist/skill/docs/platform/auth/api-keys.md +1 -1
  78. package/dist/skill/docs/platform/auth/using-auth.md +37 -0
  79. package/dist/skill/docs/platform/database/d1.md +2 -2
  80. package/dist/skill/docs/platform/database/neon.md +4 -4
  81. package/dist/skill/docs/platform/email/index.md +1 -1
  82. package/dist/skill/docs/platform/queues/handlers.md +1 -1
  83. package/dist/skill/docs/platform/queues/using-queues.md +1 -1
  84. package/dist/skill/docs/platform/schedules/index.md +1 -1
  85. package/dist/skill/docs/platform/storage/index.md +3 -3
  86. package/dist/skill/docs/platform/storage/r2.md +87 -37
  87. package/dist/skill/docs/platform/storage/using-r2.md +99 -19
  88. package/dist/skill/docs/platform/webhooks/inbound.md +40 -0
  89. package/dist/skill/docs/start/deploy-browser.md +39 -44
  90. package/dist/skill/docs/start/deploy-owner-access.md +28 -19
  91. package/dist/skill/docs/start/deploy.md +2 -2
  92. package/dist/skill/docs/start/first-api.md +1 -1
  93. package/dist/skill/docs/start/hand-crafted.md +3 -3
  94. package/dist/skill/docs/start/index.md +3 -3
  95. package/dist/skill/docs/start/quickstart.md +3 -3
  96. package/dist/skill/docs/start/template-blog.md +2 -2
  97. package/dist/skill/docs/start/template-cloudflare.md +2 -2
  98. package/dist/skill/docs/start/template-empty.md +1 -1
  99. package/dist/skill/docs/start/templates.md +1 -1
  100. package/dist/skill/docs/tooling/claude-skill.md +1 -1
  101. package/dist/skill/docs/tooling/cli.md +20 -15
  102. package/dist/skill/docs/tooling/cloud-compiler/authentication.md +1 -1
  103. package/dist/skill/docs/tooling/cloud-compiler/endpoints.md +5 -3
  104. package/dist/skill/docs/tooling/cloud-compiler/index.md +1 -1
  105. package/dist/skill/docs/tooling/cloud-compiler/local-compiler.md +2 -2
  106. package/dist/skill/docs/tooling/cloud-compiler/troubleshooting.md +47 -2
  107. package/dist/skill/docs/tooling/output.md +23 -2
  108. package/dist/skill/docs/tooling/troubleshooting.md +1 -1
  109. package/dist/skill/docs/ui/account/environment-variables.md +2 -2
  110. package/dist/skill/docs/ui/account/features/admin.md +1 -1
  111. package/dist/skill/docs/ui/account/features/avatars.md +24 -8
  112. package/dist/skill/docs/ui/account/features/index.md +9 -5
  113. package/dist/skill/docs/ui/account/features/organizations.md +3 -2
  114. package/dist/skill/docs/ui/account/index.md +3 -1
  115. package/dist/skill/docs/ui/account/with-quickback.md +1 -1
  116. package/dist/skill/docs/ui/admin/actions.md +97 -3
  117. package/dist/skill/docs/ui/admin/components.md +4 -6
  118. package/dist/skill/docs/ui/admin/connecting.md +15 -3
  119. package/dist/skill/docs/ui/admin/index.md +71 -6
  120. package/dist/skill/docs/ui/admin/inline-editing.md +38 -4
  121. package/dist/skill/docs/ui/admin/record-layouts.md +22 -21
  122. package/dist/skill/docs/ui/admin/schema-format.md +39 -2
  123. package/dist/skill/docs/ui/admin/schema-registry.md +107 -7
  124. package/dist/skill/docs/ui/admin/security.md +19 -4
  125. package/dist/skill/docs/ui/admin/table-views.md +59 -12
  126. package/package.json +1 -1
  127. package/src/cursor/quickback.mdc +1 -1
  128. package/src/skill/SKILL.md +6 -6
  129. package/src/skill/docs/api/crud.md +7 -0
  130. package/src/skill/docs/api/index.md +1 -1
  131. package/src/skill/docs/api/openapi.md +1 -1
  132. package/src/skill/docs/changelog/index.md +19 -1
  133. package/src/skill/docs/configure/agents.md +1 -1
  134. package/src/skill/docs/configure/index.md +8 -3
  135. package/src/skill/docs/configure/providers.md +1 -0
  136. package/src/skill/docs/configure/variables.md +3 -3
  137. package/src/skill/docs/define/access.md +7 -0
  138. package/src/skill/docs/define/actions/defining.md +35 -7
  139. package/src/skill/docs/define/actions/record-and-standalone.md +7 -4
  140. package/src/skill/docs/define/actions/scoped-db.md +46 -16
  141. package/src/skill/docs/define/areas.md +1 -1
  142. package/src/skill/docs/define/diagnostics.md +1 -0
  143. package/src/skill/docs/define/encryption.md +1 -1
  144. package/src/skill/docs/define/feature.md +14 -7
  145. package/src/skill/docs/define/guards.md +27 -3
  146. package/src/skill/docs/define/schema.md +24 -14
  147. package/src/skill/docs/define/security.md +1 -1
  148. package/src/skill/docs/define/transitions.md +35 -4
  149. package/src/skill/docs/define/views.md +33 -0
  150. package/src/skill/docs/index.md +2 -2
  151. package/src/skill/docs/platform/auth/api-keys.md +1 -1
  152. package/src/skill/docs/platform/auth/using-auth.md +37 -0
  153. package/src/skill/docs/platform/database/d1.md +2 -2
  154. package/src/skill/docs/platform/database/neon.md +4 -4
  155. package/src/skill/docs/platform/email/index.md +1 -1
  156. package/src/skill/docs/platform/queues/handlers.md +1 -1
  157. package/src/skill/docs/platform/queues/using-queues.md +1 -1
  158. package/src/skill/docs/platform/schedules/index.md +1 -1
  159. package/src/skill/docs/platform/storage/index.md +3 -3
  160. package/src/skill/docs/platform/storage/r2.md +87 -37
  161. package/src/skill/docs/platform/storage/using-r2.md +99 -19
  162. package/src/skill/docs/platform/webhooks/inbound.md +40 -0
  163. package/src/skill/docs/start/deploy-browser.md +39 -44
  164. package/src/skill/docs/start/deploy-owner-access.md +28 -19
  165. package/src/skill/docs/start/deploy.md +2 -2
  166. package/src/skill/docs/start/first-api.md +1 -1
  167. package/src/skill/docs/start/hand-crafted.md +3 -3
  168. package/src/skill/docs/start/index.md +3 -3
  169. package/src/skill/docs/start/quickstart.md +3 -3
  170. package/src/skill/docs/start/template-blog.md +2 -2
  171. package/src/skill/docs/start/template-cloudflare.md +2 -2
  172. package/src/skill/docs/start/template-empty.md +1 -1
  173. package/src/skill/docs/start/templates.md +1 -1
  174. package/src/skill/docs/tooling/claude-skill.md +1 -1
  175. package/src/skill/docs/tooling/cli.md +20 -15
  176. package/src/skill/docs/tooling/cloud-compiler/authentication.md +1 -1
  177. package/src/skill/docs/tooling/cloud-compiler/endpoints.md +5 -3
  178. package/src/skill/docs/tooling/cloud-compiler/index.md +1 -1
  179. package/src/skill/docs/tooling/cloud-compiler/local-compiler.md +2 -2
  180. package/src/skill/docs/tooling/cloud-compiler/troubleshooting.md +47 -2
  181. package/src/skill/docs/tooling/output.md +23 -2
  182. package/src/skill/docs/tooling/troubleshooting.md +1 -1
  183. package/src/skill/docs/ui/account/environment-variables.md +2 -2
  184. package/src/skill/docs/ui/account/features/admin.md +1 -1
  185. package/src/skill/docs/ui/account/features/avatars.md +24 -8
  186. package/src/skill/docs/ui/account/features/index.md +9 -5
  187. package/src/skill/docs/ui/account/features/organizations.md +3 -2
  188. package/src/skill/docs/ui/account/index.md +3 -1
  189. package/src/skill/docs/ui/account/with-quickback.md +1 -1
  190. package/src/skill/docs/ui/admin/actions.md +97 -3
  191. package/src/skill/docs/ui/admin/components.md +4 -6
  192. package/src/skill/docs/ui/admin/connecting.md +15 -3
  193. package/src/skill/docs/ui/admin/index.md +71 -6
  194. package/src/skill/docs/ui/admin/inline-editing.md +38 -4
  195. package/src/skill/docs/ui/admin/record-layouts.md +22 -21
  196. package/src/skill/docs/ui/admin/schema-format.md +39 -2
  197. package/src/skill/docs/ui/admin/schema-registry.md +107 -7
  198. package/src/skill/docs/ui/admin/security.md +19 -4
  199. package/src/skill/docs/ui/admin/table-views.md +59 -12
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @quickback-dev/cli
2
2
 
3
- The Quickback CLI — a thin client for the Quickback compiler. Define your backend in TypeScript, run `quickback compile`, and ship a fully wired Cloudflare Worker project with auth, database, migrations, security pillars, CMS, and Account UI already generated.
3
+ The Quickback CLI — a thin client for the Quickback compiler. Define your backend in TypeScript, run `quickback build`, and ship a fully wired Cloudflare Worker project with auth, database, migrations, security pillars, CMS, and Account UI already generated.
4
4
 
5
5
  ```bash
6
6
  # Fastest path — interactive, scaffolds in the current directory
@@ -10,12 +10,15 @@ npx @quickback-dev/cli start
10
10
  npm i -g @quickback-dev/cli
11
11
  quickback create cloudflare my-app
12
12
  cd my-app
13
- quickback compile
13
+ quickback build
14
14
  ```
15
15
 
16
- If a remote compile fails, rerun with `quickback compile --verbose` to show the
16
+ If a remote build fails, rerun with `quickback build --verbose` to show the
17
17
  failing command, exit code, stderr/stdout tail, and suggested fixes.
18
18
 
19
+ `quickback compile` is the former name of `quickback build` and still works as
20
+ an alias, so existing scripts and CI pipelines keep running unchanged.
21
+
19
22
  Full docs: [docs.quickback.dev](https://docs.quickback.dev)
20
23
 
21
24
  ---
@@ -26,7 +29,7 @@ Full docs: [docs.quickback.dev](https://docs.quickback.dev)
26
29
  |---|---|
27
30
  | `quickback start` | Interactive one-shot onboarding — picks template, scaffolds, defers login until the compile step. Designed for `npx` in an empty folder. |
28
31
  | `quickback create <template> <name>` | Scriptable scaffold from a Quickback template (e.g. `cloudflare`, `blog`, `todos`, `saas`) |
29
- | `quickback compile` | Compile your `quickback/quickback.config.ts` + feature definitions into a generated project. Checks managed schema declarations first; pass `--fix-schema` to apply safe additive fixes. |
32
+ | `quickback build` | Build your `quickback/quickback.config.ts` + feature definitions into a generated project. Checks managed schema declarations first; pass `--fix-schema` to apply safe additive fixes. |
30
33
  | `quickback schema check` | Check every authored feature table for canonical managed audit/soft-delete declarations without writing files. |
31
34
  | `quickback schema sync` | Add missing canonical managed declarations transactionally; divergent authored declarations fail closed for manual review. |
32
35
  | `quickback example [name]` | Extract a pre-compiled example project (e.g. `recruitment`) into the current directory |
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Compile Command
3
+ *
4
+ * Loads configuration and features from disk, calls the remote compiler API,
5
+ * writes the generated files to the project root, and runs post-compile commands.
6
+ *
7
+ * Project structure:
8
+ * my-app/
9
+ * ├── quickback/
10
+ * │ ├── quickback.config.ts
11
+ * │ ├── features/...
12
+ * │ └── drizzle/ ← migration SQL + meta (compiler-owned)
13
+ * ├── src/ ← compiled code written here
14
+ * ├── supabase/migrations/ ← for Supabase provider
15
+ * └── package.json
16
+ */
17
+ /**
18
+ * `build.outputDir` → the migration staging workspace's `outputRootPath`.
19
+ *
20
+ * The two use different bases, which is the whole reason this exists.
21
+ * `outputDir` is authored relative to the **quickback/ dir** (every other
22
+ * reader does `join(quickbackDir, outputDir)`), while staging resolves its
23
+ * paths against the **project root** and rejects anything containing `..`.
24
+ * Passing the raw value made a legitimate `outputDir: "../src"` — config in
25
+ * `quickback/`, generated tree at `<root>/src`, the standard nested layout —
26
+ * read as a path-escape attempt and fail the compile.
27
+ *
28
+ * Returns a POSIX-style path relative to the project root, or `undefined`
29
+ * when the project doesn't set `outputDir`.
30
+ */
31
+ export declare function resolveOutputRootPath(projectRoot: string, quickbackDir: string, outputDir: string | undefined): string | undefined;
32
+ export interface BuildOptions {
33
+ /**
34
+ * Whether to splice the schema-driven kitchen-sink block into the
35
+ * user's quickback.config.ts after a successful build. Defaults
36
+ * to true; the CLI accepts `--no-sync-config` to disable.
37
+ */
38
+ syncConfig?: boolean;
39
+ /**
40
+ * Request detailed compiler failure output, including the failing command,
41
+ * exit code, stderr/stdout tails, and any suggested fixes.
42
+ */
43
+ verbose?: boolean;
44
+ /**
45
+ * Apply safe additive managed-column declarations to authored feature
46
+ * schemas before loading them for compilation.
47
+ */
48
+ fixSchema?: boolean;
49
+ }
50
+ export declare function build(options?: BuildOptions): Promise<void>;
51
+ //# sourceMappingURL=build.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAyFH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,GAAG,SAAS,CAGpB;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8wBrE"}