@voltro/cli 0.5.0 → 0.7.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 (87) hide show
  1. package/CHANGELOG.md +68 -1
  2. package/bin/voltro.mjs +63 -2
  3. package/dist/apiBuild-CSM74oEZ.js +2 -0
  4. package/dist/{apiBuild-CZugTK46.js → apiBuild-deIjJKJm.js} +2 -1
  5. package/dist/bin.js +2 -2
  6. package/dist/{commands-CJheDVOr.js → commands-BHdc71DG.js} +2671 -2960
  7. package/dist/dev-BYfrYwrT.js +2 -0
  8. package/dist/dev-Bqyq62Ak.js +6492 -0
  9. package/dist/devActivity-1WtIVyHc.js +153 -0
  10. package/dist/devActivity.d.ts +46 -0
  11. package/dist/devActivity.js +2 -0
  12. package/dist/index.js +1 -1
  13. package/dist/inspectMetrics-BLUBAWLb.js +3711 -0
  14. package/dist/serveCommand-Dn6--0Bv.js +1111 -0
  15. package/dist/serveEntry.js +3 -2
  16. package/dist/start-CWZW_4Et.js +941 -0
  17. package/dist/startEntry.d.ts +5 -0
  18. package/dist/startEntry.js +3 -0
  19. package/package.json +22 -17
  20. package/templates/AGENTS.core.md +36 -1
  21. package/templates/AGENTS.md +36 -1
  22. package/templates/agent-docs/_manifest.json +3 -3
  23. package/templates/agent-docs/ai.md +35 -3
  24. package/templates/agent-docs/authentication.md +264 -0
  25. package/templates/agent-docs/cli.md +126 -3
  26. package/templates/agent-docs/configuration.md +38 -0
  27. package/templates/agent-docs/data.md +616 -40
  28. package/templates/agent-docs/database/querying.md +151 -3
  29. package/templates/agent-docs/database/schema.md +1 -0
  30. package/templates/agent-docs/deployment.md +171 -0
  31. package/templates/agent-docs/internationalization.md +2 -0
  32. package/templates/agent-docs/plugins.md +4 -4
  33. package/templates/agent-docs/reference.md +56 -2
  34. package/templates/agent-docs/templates/apibackends.md +13 -2
  35. package/templates/agent-docs/testing.md +215 -3
  36. package/templates/apps/api-ai/package.json +7 -7
  37. package/templates/apps/api-auth/app.config.ts +20 -13
  38. package/templates/apps/api-auth/package.json +8 -8
  39. package/templates/apps/api-backend/package.json +7 -7
  40. package/templates/apps/api-backend-deactivation/package.json +7 -7
  41. package/templates/apps/api-backend-mail/package.json +8 -8
  42. package/templates/apps/api-backend-mariadb/.env.example +10 -4
  43. package/templates/apps/api-backend-mariadb/package.json +9 -9
  44. package/templates/apps/api-backend-storage/package.json +8 -8
  45. package/templates/apps/api-data-advanced/app.config.ts +21 -8
  46. package/templates/apps/api-data-advanced/package.json +8 -8
  47. package/templates/apps/api-durable/package.json +8 -8
  48. package/templates/apps/api-feature-flags/package.json +9 -9
  49. package/templates/apps/api-governance/app.config.ts +15 -2
  50. package/templates/apps/api-governance/package.json +8 -8
  51. package/templates/apps/api-kv/package.json +8 -8
  52. package/templates/apps/api-moderation/package.json +8 -8
  53. package/templates/apps/api-observability/package.json +8 -8
  54. package/templates/apps/api-ratelimit/package.json +8 -8
  55. package/templates/apps/api-rbac/package.json +8 -8
  56. package/templates/apps/api-rest/package.json +7 -7
  57. package/templates/apps/api-saas/package.json +11 -11
  58. package/templates/apps/api-search/package.json +8 -8
  59. package/templates/apps/api-versioning/package.json +8 -8
  60. package/templates/apps/api-webhooks/app.config.ts +20 -1
  61. package/templates/apps/api-webhooks/package.json +8 -8
  62. package/templates/apps/changelog/package.json +6 -6
  63. package/templates/apps/edge-functions/package.json +2 -2
  64. package/templates/apps/frontend-admin/package.json +8 -8
  65. package/templates/apps/frontend-app/package.json +8 -8
  66. package/templates/apps/frontend-blank/package.json +7 -7
  67. package/templates/apps/frontend-contact/package.json +7 -7
  68. package/templates/apps/frontend-dashboard/package.json +7 -7
  69. package/templates/apps/frontend-docs/package.json +7 -7
  70. package/templates/apps/frontend-i18n/package.json +6 -6
  71. package/templates/apps/frontend-landing/package.json +7 -7
  72. package/templates/apps/frontend-spa/package.json +7 -7
  73. package/templates/apps/frontend-ssr/package.json +7 -7
  74. package/templates/apps/frontend-ssr-api/package.json +8 -8
  75. package/templates/apps/frontend-static-blog/package.json +6 -6
  76. package/templates/baselines/bare/.env.example +10 -3
  77. package/templates/baselines/compose/.env.example +10 -2
  78. package/templates/baselines/compose-mariadb/.env.example +10 -2
  79. package/templates/baselines/helm/.env.example +10 -3
  80. package/dist/apiBuild-D-iBYKa3.js +0 -2
  81. package/dist/dev-B71ICpXJ.js +0 -9896
  82. package/dist/dev-DNUetyG2.js +0 -2
  83. package/dist/serveCommand-C0WFA396.js +0 -1084
  84. package/templates/apps/api-auth/.env +0 -17
  85. package/templates/apps/api-data-advanced/.env +0 -17
  86. package/templates/apps/api-governance/.env +0 -4
  87. package/templates/apps/api-webhooks/.env +0 -6
package/templates/apps/frontend-spa/package.json CHANGED
@@ -11,17 +11,17 @@
11
11
  "typecheck": "tsc --noEmit"
12
12
  },
13
13
  "dependencies": {
14
- "@voltro/cli": "0.5.0",
15
- "@voltro/client": "0.5.0",
16
- "@voltro/env": "0.5.0",
17
- "@voltro/i18n": "0.5.0",
18
- "@voltro/ui-shadcn": "0.5.0",
19
- "@voltro/web": "0.5.0",
14
+ "@voltro/cli": "0.7.0",
15
+ "@voltro/client": "0.7.0",
16
+ "@voltro/env": "0.7.0",
17
+ "@voltro/i18n": "0.7.0",
18
+ "@voltro/ui-shadcn": "0.7.0",
19
+ "@voltro/web": "0.7.0",
20
20
  "react": "^19.0.0",
21
21
  "react-dom": "^19.0.0"
22
22
  },
23
23
  "devDependencies": {
24
- "@voltro/devtools": "0.5.0",
24
+ "@voltro/devtools": "0.7.0",
25
25
  "@types/react": "^19.0.0",
26
26
  "@types/react-dom": "^19.0.0",
27
27
  "typescript": "^5.7.0",
package/templates/apps/frontend-ssr/package.json CHANGED
@@ -11,17 +11,17 @@
11
11
  "test": "voltro test"
12
12
  },
13
13
  "dependencies": {
14
- "@voltro/cli": "0.5.0",
15
- "@voltro/client": "0.5.0",
16
- "@voltro/env": "0.5.0",
17
- "@voltro/i18n": "0.5.0",
18
- "@voltro/ui-shadcn": "0.5.0",
19
- "@voltro/web": "0.5.0",
14
+ "@voltro/cli": "0.7.0",
15
+ "@voltro/client": "0.7.0",
16
+ "@voltro/env": "0.7.0",
17
+ "@voltro/i18n": "0.7.0",
18
+ "@voltro/ui-shadcn": "0.7.0",
19
+ "@voltro/web": "0.7.0",
20
20
  "react": "^19.0.0",
21
21
  "react-dom": "^19.0.0"
22
22
  },
23
23
  "devDependencies": {
24
- "@voltro/devtools": "0.5.0",
24
+ "@voltro/devtools": "0.7.0",
25
25
  "@types/react": "^19.0.0",
26
26
  "@types/react-dom": "^19.0.0",
27
27
  "typescript": "^5.7.0",
package/templates/apps/frontend-ssr-api/package.json CHANGED
@@ -11,18 +11,18 @@
11
11
  "test": "voltro test"
12
12
  },
13
13
  "dependencies": {
14
- "@{{projectName}}/api": "0.5.0",
15
- "@voltro/cli": "0.5.0",
16
- "@voltro/client": "0.5.0",
17
- "@voltro/env": "0.5.0",
18
- "@voltro/i18n": "0.5.0",
19
- "@voltro/ui-shadcn": "0.5.0",
20
- "@voltro/web": "0.5.0",
14
+ "@{{projectName}}/api": "0.7.0",
15
+ "@voltro/cli": "0.7.0",
16
+ "@voltro/client": "0.7.0",
17
+ "@voltro/env": "0.7.0",
18
+ "@voltro/i18n": "0.7.0",
19
+ "@voltro/ui-shadcn": "0.7.0",
20
+ "@voltro/web": "0.7.0",
21
21
  "react": "^19.0.0",
22
22
  "react-dom": "^19.0.0"
23
23
  },
24
24
  "devDependencies": {
25
- "@voltro/devtools": "0.5.0",
25
+ "@voltro/devtools": "0.7.0",
26
26
  "@types/react": "^19.0.0",
27
27
  "@types/react-dom": "^19.0.0",
28
28
  "typescript": "^5.7.0",
package/templates/apps/frontend-static-blog/package.json CHANGED
@@ -11,16 +11,16 @@
11
11
  "test": "voltro test"
12
12
  },
13
13
  "dependencies": {
14
- "@voltro/cli": "0.5.0",
15
- "@voltro/client": "0.5.0",
16
- "@voltro/env": "0.5.0",
17
- "@voltro/i18n": "0.5.0",
18
- "@voltro/web": "0.5.0",
14
+ "@voltro/cli": "0.7.0",
15
+ "@voltro/client": "0.7.0",
16
+ "@voltro/env": "0.7.0",
17
+ "@voltro/i18n": "0.7.0",
18
+ "@voltro/web": "0.7.0",
19
19
  "react": "^19.0.0",
20
20
  "react-dom": "^19.0.0"
21
21
  },
22
22
  "devDependencies": {
23
- "@voltro/devtools": "0.5.0",
23
+ "@voltro/devtools": "0.7.0",
24
24
  "@types/react": "^19.0.0",
25
25
  "@types/react-dom": "^19.0.0",
26
26
  "typescript": "^5.7.0",
package/templates/baselines/bare/.env.example CHANGED
@@ -9,9 +9,16 @@
9
9
  # cloud provider URL).
10
10
  DB_URL=postgres://app:app@localhost:5432/{{projectName}}
11
11
 
12
- # Session signing secret. The plugin-auth handlers refuse to mint
13
- # sessions without it. Rotate before shipping.
14
- VOLTRO_SESSION_SECRET=dev-only-secret-please-rotate-in-prod
12
+ # Session signing secret — NO VALUE SHIPS HERE ON PURPOSE.
13
+ #
14
+ # `voltro dev` mints a unique one for this project into a gitignored
15
+ # .env.local on first boot, so local development needs nothing from you.
16
+ # A shipped placeholder would be a signing key published to everyone who
17
+ # downloads this template, making every session in your deployment forgeable.
18
+ #
19
+ # Your DEPLOYMENT needs its own — `voltro serve` refuses to start without it:
20
+ # voltro secret generate session
21
+ VOLTRO_SESSION_SECRET=
15
22
 
16
23
  # ─── Optional backends — ALL OFF by default; uncomment to activate ───────────
17
24
  # The cache and the durable KV each run on a zero-infra default (in-process
package/templates/baselines/compose/.env.example CHANGED
@@ -12,8 +12,16 @@
12
12
  # the host is `localhost` and port stays 5433.
13
13
  DB_URL=postgres://app:app@localhost:5433/{{projectName}}
14
14
 
15
- # Used by prod:up — required, no dev fallback.
16
- VOLTRO_SESSION_SECRET=dev-only-secret-please-rotate-in-prod
15
+ # Session signing secret — NO VALUE SHIPS HERE ON PURPOSE.
16
+ #
17
+ # `voltro dev` mints a unique one for this project into a gitignored
18
+ # .env.local on first boot, so local development needs nothing from you.
19
+ # A shipped placeholder would be a signing key published to everyone who
20
+ # downloads this template, making every session in your deployment forgeable.
21
+ #
22
+ # Your DEPLOYMENT needs its own — `voltro serve` refuses to start without it:
23
+ # voltro secret generate session
24
+ VOLTRO_SESSION_SECRET=
17
25
 
18
26
  # Used by docker-compose.prod.yml — the prod postgres uses a
19
27
  # different password from dev (intentional: avoid `db:reset` blowing
package/templates/baselines/compose-mariadb/.env.example CHANGED
@@ -24,8 +24,16 @@ S3_ACCESS_KEY_ID=minioadmin
24
24
  S3_SECRET_ACCESS_KEY=minioadmin
25
25
  S3_FORCE_PATH_STYLE=1
26
26
 
27
- # HMAC key for signed sessions — REQUIRED by prod:up (no dev fallback).
28
- VOLTRO_SESSION_SECRET=dev-only-secret-please-rotate-in-prod
27
+ # Session signing secret — NO VALUE SHIPS HERE ON PURPOSE.
28
+ #
29
+ # `voltro dev` mints a unique one for this project into a gitignored
30
+ # .env.local on first boot, so local development needs nothing from you.
31
+ # A shipped placeholder would be a signing key published to everyone who
32
+ # downloads this template, making every session in your deployment forgeable.
33
+ #
34
+ # Your DEPLOYMENT needs its own — `voltro serve` refuses to start without it:
35
+ # voltro secret generate session
36
+ VOLTRO_SESSION_SECRET=
29
37
 
30
38
  # Used by docker-compose.prod.yml — the prod DB uses a different root
31
39
  # password from dev (avoids `db:reset` blowing away a prod-shape dataset).
package/templates/baselines/helm/.env.example CHANGED
@@ -10,9 +10,16 @@
10
10
  # managed instance you can reach from your laptop).
11
11
  DB_URL=postgres://app:app@localhost:5432/{{projectName}}
12
12
 
13
- # Local session signing secret. The chart's Secret is the source of
14
- # truth in the cluster.
15
- VOLTRO_SESSION_SECRET=dev-only-secret-please-rotate-in-prod
13
+ # Session signing secret — NO VALUE SHIPS HERE ON PURPOSE.
14
+ #
15
+ # `voltro dev` mints a unique one for this project into a gitignored
16
+ # .env.local on first boot, so local development needs nothing from you.
17
+ # A shipped placeholder would be a signing key published to everyone who
18
+ # downloads this template, making every session in your deployment forgeable.
19
+ #
20
+ # Your DEPLOYMENT needs its own — `voltro serve` refuses to start without it:
21
+ # voltro secret generate session
22
+ VOLTRO_SESSION_SECRET=
16
23
 
17
24
  # ─── Optional backends — ALL OFF by default; uncomment to activate ───────────
18
25
  # The cache and the durable KV each run on a zero-infra default (in-process
package/dist/apiBuild-D-iBYKa3.js DELETED
@@ -1,2 +0,0 @@
1
- import { i as e, r as t } from "./apiBuild-CZugTK46.js";
2
- export { t as runApiBuild, e as runServeBundleBuild };