feat: full-stack deployments — deploy/promote/rollback/logs for Workers-based apps

[netanelgilad]

Note

Description

This PR adds first-class support for full-stack deployments — hosting framework builds (React Router 7, TanStack Start, Astro 6, vinext, anything built with @cloudflare/vite-plugin) as Cloudflare Workers on Base44. It introduces a new src/core/deployments/ module that detects the wrangler artifact, hashes and uploads static assets, collects Worker modules, and drives the create → upload → finalize API flow. The base44 deploy command now automatically prefers this Workers path over the legacy site tar.gz upload when an artifact is present, and new deployments, promote, rollback, and domains commands round out the lifecycle. It also adds custom domain management (base44 domains add/list/remove) and extends base44 logs to stream deployment logs.

Related Issue

None

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Other (please describe):

Changes Made

Full-stack deployments (src/core/deployments/)

• wrangler-config.ts — detects the deploy artifact via .wrangler/deploy/config.json redirect, root wrangler.json(c), or errors on unsupported wrangler.toml; validates no_bundle: true and rejects unsupported bindings while passing vars through. Handles Astro 6 quirks (empty compatibility_flags, extra redirect-file fields).
• manifest.ts — walks the assets directory, applies .assetsignore, and hashes files as sha256(app_id || bytes) (app-id-salted to prevent cross-tenant cache poisoning), with 25 MiB per-file and 100k file caps.
• modules.ts — collects Worker modules per the wrangler rules globs, including source maps, capped at 40 MB.
• upload.ts — uploads asset buckets directly to the signed upload_url (base64 multipart, bearer JWT, concurrency 3 with retries/backoff).
• api.ts / deploy.ts / schema.ts — the create → bucket upload → finalize flow, plus list/get/promote/rollback/logs API calls with Zod schemas.

CLI commands

• Extended base44 deploy with --prod, --build, and --prebuilt flags; builds when configured and routes to the full-stack path when an artifact exists (legacy behavior unchanged otherwise).
• Added base44 deployments list / get <id>, base44 promote <id>, and base44 rollback [-y].
• Added base44 domains add/list/remove (src/core/domains/) with live status polling for connecting custom domains.
• Extended base44 logs with --deployment <id|production> and live --follow streaming.
• Wired all new commands into program.ts; added error classes in core/errors.ts.

Docs & tests

• New docs/deployments.md topic guide; updated docs/AGENTS.md, docs/resources.md, docs/testing.md.
• Extended TestAPIServer testkit with deployment/asset-upload/finalize/promote/rollback/logs mocks and a fullstack-project fixture.
• Added CLI integration specs (deployments, domains, fullstack_deploy, logs_deployment) and core unit specs (manifest, modules, wrangler-config).

Testing

• I have tested these changes locally
• I have added/updated tests as needed
• All tests pass (npm test)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (if applicable)
• My changes generate no new warnings
• I have updated docs/ (AGENTS.md) if I made architectural changes

Additional Notes

Full-stack support is limited to no_bundle: true outputs with no non-vars bindings; wrangler.toml and bundled outputs fail fast with clear errors. The legacy site tar.gz deploy path is preserved unchanged for apps without a full-stack artifact. A follow-up commit greens CI (knip dead exports, Windows fixture line-endings, Bun binary charset).

---

_{🤖 Generated by Claude | 2026-07-06 14:37 UTC | 1712ae1}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.1.1-pr.559.d9cc6f9

Prefer not to change any import paths? Install using npm alias so your code still imports base44:

npm i "base44@npm:@base44-preview/cli@0.1.1-pr.559.d9cc6f9"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.1.1-pr.559.d9cc6f9"
  }
}

• 📦 Preview Package: @base44-preview/cli@0.1.1-pr.559.d9cc6f9
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}