belt 0.3.4 → 0.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33ab3ee829508580c32a99fd91f008cd09b3dd80e2502f22b03e7e4d5ff9d00a
-  data.tar.gz: 204c45931c8e038037f4d49781bbf43fff9396cd58e32d38d4cdb607fdccdfa7
+  metadata.gz: 803700aa6a859842c684ea0dc77b455a050698f1585663346e2c0aa1c057687a
+  data.tar.gz: b442f719e65920b93f1ba09eb841ba6498490645630576e8700d448073f21731
 SHA512:
-  metadata.gz: 2f2f957782e6b03ef246167f46309a51a50cc286d3d4c1d8ba4411eba8a2ad558a2556986991848116519c5286bef5d57e5805307bbf314932580b82397beb43
-  data.tar.gz: 587671ca7188c4ff9476ee4568b3f7f513c05eb285088be3b7282a1b2096b4cc7f6a3c7d7f1e609e92e22e87db851b785422fd0ab4ea07e76ecd028cf6b87103
+  metadata.gz: 6ebc34ade7cbbd8867330adbbe5c0ae2732719265d7afe1c080a4d9320c7d80e1dce316186f2de560bcda3df76ad8bdc4af31a2d7c3bd77d95c0dbd0c2fe41b5
+  data.tar.gz: 43abfb9e472722ca8728558edd91f2a41a8f77f5857d992528c915a35c36951f9b30548918d11f2a6291947714abd9f823049d22e3e3907ad850b16ae5c3331c

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## Unreleased
+
+## 0.3.5
+
+### Enhancement
+
+- **Multiple frontends**: Frontend directory is no longer hardcoded to `frontend/`.
+  Declare named SPAs in `config/frontends.yml` (path, dist dir, terraform output names).
+  `belt generate frontend react --name ops --path ops-app` scaffolds an additional app.
+  Generators, `belt server`, `belt frontend env`, and `belt deploy frontend` accept
+  `--frontend NAME`. `belt deploy frontend <env>` deploys all configured frontends;
+  pass `--frontend` to target one. Existing single-`frontend/` apps keep working
+  with no config file.
+- **Sidecar Lambda zips**: `belt deploy` / `belt plan` / `belt apply` build zip
+  artifacts that Terraform `filebase64sha256` needs at plan time (e.g. Stowzilla's
+  Node `image-processor`). Node packages are installed in Docker on linux/amd64
+  so native addons match Lambda. Missing zips are built automatically; unchanged
+  sources skip the rebuild.
+
+### Bug fix
+
+- **Frontend CloudFront invalidation**: `belt deploy frontend` no longer prints
+  terraform's "output not found" error when a named frontend sets
+  `cloudfront_domain_output` instead of a distribution-id output. Missing
+  terraform outputs are read with stderr silenced.
+
 ## 0.3.4
 
 ### Enhancement

data/lib/belt/cli/auth_command.rb

@@ -3,6 +3,7 @@
 require 'fileutils'
 require 'erb'
 require_relative 'app_detection'
+require_relative 'frontend_registry'
 
 module Belt
   module CLI
@@ -20,13 +21,14 @@ module Belt
 
         force = args.delete('--force') || args.delete('-f')
         signup = args.delete('--signup')
+        frontend_name = FrontendRegistry.extract_flag!(args, '--frontend')
         pools = parse_pools(args)
 
-        new(pools: pools, force: force, signup: signup).generate
+        new(pools: pools, force: force, signup: signup, frontend_name: frontend_name).generate
       end
 
       def self.destroy(_args)
-        new(pools: [], force: false).remove
+        new(pools: [], force: false, skip_frontend_resolve: true).remove
       end
 
       def self.print_help
@@ -36,8 +38,9 @@ module Belt
           Usage: belt generate auth [pool_names...] [options]
 
           Options:
-            --signup        Allow public user registration (generates frontend views)
-            --force, -f     Overwrite existing cognito.tf (skip collision check)
+            --signup           Allow public user registration (generates frontend views)
+            --frontend NAME    Target frontend when several exist
+            --force, -f        Overwrite existing cognito.tf (skip collision check)
 
           Arguments:
             pool_names      Optional pool names for multiple user pools.
@@ -86,12 +89,13 @@ module Belt
         names.map(&:downcase).map { |n| n.gsub(/[^a-z0-9_]/, '_') }
       end
 
-      def initialize(pools:, force: false, signup: false)
+      def initialize(pools:, force: false, signup: false, frontend_name: nil, skip_frontend_resolve: false)
         @pool_names = pools
         @force = force
         @signup = signup
         @app_name = detect_app_name
         @pools = build_pool_metadata
+        @frontend = skip_frontend_resolve ? nil : resolve_frontend(frontend_name)
       end
 
       def generate
@@ -117,7 +121,7 @@ module Belt
         puts '       end'
         puts ''
         if frontend?
-          puts '  2. Wire auth into your frontend/src/App.jsx:'
+          puts "  2. Wire auth into your #{@frontend.src_dir}/App.jsx:"
           puts ''
           puts "       import Login from './pages/auth/Login'"
           puts "       import ProtectedRoute from './components/ProtectedRoute'"
@@ -185,20 +189,30 @@ module Belt
         end
       end
 
+      def resolve_frontend(name)
+        registry = FrontendRegistry.new
+        return nil if registry.empty? && name.nil?
+
+        return registry.resolve!(name) if name
+
+        registry.default
+      end
+
       def frontend?
-        Dir.exist?('frontend/src')
+        @frontend && Dir.exist?(@frontend.src_dir)
       end
 
       def generate_frontend_auth
         frontend_template_dir = File.join(TEMPLATE_DIR, 'frontend')
+        src = @frontend.src_dir
 
         # Generate auth lib files
-        lib_dir = 'frontend/src/lib'
+        lib_dir = File.join(src, 'lib')
         FileUtils.mkdir_p(lib_dir)
         copy_frontend_file(frontend_template_dir, 'auth.js', File.join(lib_dir, 'auth.js'))
         copy_frontend_file(frontend_template_dir, 'apiClient.js', File.join(lib_dir, 'apiClient.js'))
 
-        pages_dir = 'frontend/src/pages/auth'
+        pages_dir = File.join(src, 'pages/auth')
         FileUtils.mkdir_p(pages_dir)
         copy_frontend_file(frontend_template_dir, 'Login.jsx', File.join(pages_dir, 'Login.jsx'))
         copy_frontend_file(frontend_template_dir, 'auth.css', File.join(pages_dir, 'auth.css'))
@@ -209,7 +223,7 @@ module Belt
         end
 
         # Generate ProtectedRoute component
-        components_dir = 'frontend/src/components'
+        components_dir = File.join(src, 'components')
         FileUtils.mkdir_p(components_dir)
         copy_frontend_file(frontend_template_dir, 'ProtectedRoute.jsx',
                            File.join(components_dir, 'ProtectedRoute.jsx'))
@@ -226,11 +240,12 @@ module Belt
       def install_cognito_sdk
         puts "\n  Installing @aws-sdk/client-cognito-identity-provider..."
         success = system('npm', 'install', '@aws-sdk/client-cognito-identity-provider',
-                         '--prefix', 'frontend', '--no-fund', '--no-audit', '--silent')
+                         '--prefix', @frontend.path, '--no-fund', '--no-audit', '--silent')
         if success
           puts '  ✓      npm dependency installed'
         else
-          puts '  ⚠      npm install failed — run: cd frontend && npm install @aws-sdk/client-cognito-identity-provider'
+          puts "  ⚠      npm install failed — run: cd #{@frontend.path} && " \
+               'npm install @aws-sdk/client-cognito-identity-provider'
         end
       end
 

data/lib/belt/cli/deploy_command.rb

@@ -10,6 +10,7 @@ require_relative 'backup_config'
 require_relative 'backup_runner'
 require_relative 'environment_config'
 require_relative 'path_gem_materializer'
+require_relative 'zip_artifact_builder'
 
 module Belt
   module CLI
@@ -66,7 +67,8 @@ module Belt
             puts '  belt deploy prod           # Deploy to prod'
             puts '  belt deploy dev --auto     # Deploy without confirmation'
             puts '  belt deploy --rebuild      # Fast code push (no infra changes)'
-            puts '  belt deploy frontend dev   # Deploy frontend only'
+            puts '  belt deploy frontend dev              # Deploy frontend(s)'
+            puts '  belt deploy frontend dev --frontend ops'
             puts "\nNo environments found. Run `belt generate environment dev` first."
             exit 1
           end
@@ -92,10 +94,11 @@ module Belt
             1. Ensure Gemfile.lock is consistent (fix stale PATH refs)
             2. Regenerate route manifests
             3. Run pre-deploy backups (if configured in belt.rb)
-            4. terraform init    (initialize providers/modules)
-            5. terraform plan    (preview changes)
-            6. Prompt for confirmation (unless --auto)
-            7. terraform apply   (deploy changes)
+            4. Build sidecar Lambda zips Terraform needs at plan time
+            5. terraform init    (initialize providers/modules)
+            6. terraform plan    (preview changes)
+            7. Prompt for confirmation (unless --auto)
+            8. terraform apply   (deploy changes)
 
           Options:
             --auto, --yes, -y    Skip confirmation prompt (auto-approve)
@@ -130,7 +133,8 @@ module Belt
             belt deploy prod --rebuild # Fast code push to prod
             belt deploy prod --skip-backup  # Skip backups for this deploy
             belt deploy prod --backup-only  # Run backups without deploying
-            belt deploy frontend dev   # Deploy frontend assets only
+            belt deploy frontend dev              # Deploy frontend asset(s)
+            belt deploy frontend dev --frontend ops
         HELP
       end
 
@@ -155,6 +159,7 @@ module Belt
         warn_active_path_gems!
         generate_routes_if_needed
         run_backups unless @skip_backup
+        build_zip_artifacts!
 
         Dir.chdir(env_dir) do
           run_init
@@ -663,6 +668,10 @@ module Belt
         puts ' (timed out waiting, but code was pushed)'
       end
 
+      def build_zip_artifacts!
+        ZipArtifactBuilder.build!(project_root: @project_root, infra_dir: @infra_dir)
+      end
+
       def run_init
         puts '━━━ terraform init ━━━'
         success = system('terraform', 'init')
@@ -706,15 +715,19 @@ module Belt
       end
 
       def deploy_frontend_if_exists
-        frontend_dir = File.join(@project_root, 'frontend')
-        return unless Dir.exist?(frontend_dir) && File.exist?(File.join(frontend_dir, 'package.json'))
-
-        puts "\n━━━ frontend deploy ━━━"
+        require_relative 'frontend_registry'
         require_relative 'frontend_deploy_command'
-        Belt::CLI::FrontendDeployCommand.new(@env).run
-      rescue StandardError => e
-        puts "\n  ⚠ Frontend deploy failed: #{e.message}"
-        puts "    Run `belt deploy frontend #{@env}` manually to retry."
+
+        frontends = FrontendRegistry.new.existing
+        return if frontends.empty?
+
+        frontends.each do |frontend|
+          puts "\n━━━ #{frontend.label} deploy ━━━"
+          Belt::CLI::FrontendDeployCommand.new(@env, frontend: frontend).run
+        rescue StandardError => e
+          puts "\n  ⚠ #{frontend.label.capitalize} deploy failed: #{e.message}"
+          puts "    Run `belt deploy frontend #{@env} --frontend #{frontend.name}` manually to retry."
+        end
       end
 
       def print_outputs(env_dir)

data/lib/belt/cli/destroy_command.rb

@@ -3,6 +3,7 @@
 require 'fileutils'
 require_relative 'app_detection'
 require_relative 'auth_command'
+require_relative 'frontend_registry'
 require_relative 'generator_registry'
 require_relative 'tables_command'
 require_relative '../inflector'
@@ -51,25 +52,28 @@ module Belt
           flags = parse_environment_flags(args)
           new(generator, name, [], **flags).destroy
         when 'frontend'
-          new(generator, nil, []).destroy
+          frontend_name = FrontendRegistry.extract_flag!(args, '--frontend')
+          new(generator, nil, [], frontend_name: frontend_name).destroy
         when 'auth'
           Belt::CLI::AuthCommand.destroy(args)
         when 'views'
+          frontend_name = FrontendRegistry.extract_flag!(args, '--frontend')
           name = args.shift
           if name.nil? || name.empty?
-            puts 'Usage: belt destroy views <name>'
+            puts 'Usage: belt destroy views <name> [--frontend NAME]'
             exit 1
           end
-          new(generator, name, args.map { |a| parse_field(a) }).destroy
+          new(generator, name, args.map { |a| parse_field(a) }, frontend_name: frontend_name).destroy
         when 'index'
           Belt::CLI::IndexCommand.run(['remove'] + args)
         else
+          frontend_name = FrontendRegistry.extract_flag!(args, '--frontend')
           name = args.shift
           if name.nil? || name.empty?
             puts "Usage: belt destroy #{generator} <name>"
             exit 1
           end
-          new(generator, name, args.map { |a| parse_field(a) }).destroy
+          new(generator, name, args.map { |a| parse_field(a) }, frontend_name: frontend_name).destroy
         end
       end
 
@@ -105,7 +109,7 @@ module Belt
             controller    Remove a controller
             auth          Remove Cognito user pool infrastructure
             environment   Remove a deployment environment and tear down infrastructure
-            frontend      Remove the frontend/ directory
+            frontend      Remove a frontend directory (use --frontend NAME when several exist)
             views         Remove React pages for a resource
 
           Environment options:
@@ -120,7 +124,9 @@ module Belt
             belt d environment dev --skip-terraform
             belt d environment dev --force
             belt d frontend
+            belt d frontend --frontend ops
             belt d views post
+            belt d views post --frontend ops
 
           ⚠ This is destructive. Files will be permanently deleted.
 
@@ -129,12 +135,14 @@ module Belt
         HELP
       end
 
-      def initialize(generator, name, fields, force: false, skip_terraform: false)
+      # rubocop:disable Metrics/ParameterLists -- keyword options for destroy flags
+      def initialize(generator, name, fields, force: false, skip_terraform: false, frontend_name: nil)
         @generator = generator
         @name = name&.downcase&.gsub(/[^a-z0-9_]/, '_')
         @fields = fields
         @force = force
         @skip_terraform = skip_terraform
+        @frontend_name = frontend_name
         @app_name = detect_namespace
         @singular_name = @name ? Belt::Inflector.singularize(@name) : nil
         @resource_name = @singular_name ? Belt::Inflector.pluralize(@singular_name) : nil
@@ -142,6 +150,7 @@ module Belt
         @removed = []
         @updated = []
       end
+      # rubocop:enable Metrics/ParameterLists
 
       def destroy
         case @generator
@@ -350,39 +359,62 @@ module Belt
       end
 
       def destroy_frontend
-        dir = 'frontend'
+        frontend = FrontendRegistry.new.resolve!(@frontend_name)
+        dir = frontend.path
         if Dir.exist?(dir)
           FileUtils.rm_rf(dir)
           @removed << dir
           puts "  remove  #{dir}/"
 
-          # Remove frontend.tf from the module
-          module_frontend = 'infrastructure/modules/app/frontend.tf'
-          if File.exist?(module_frontend)
-            FileUtils.rm_f(module_frontend)
-            @removed << module_frontend
-            puts "  remove  #{module_frontend}"
+          tf_file = File.join('infrastructure/modules/app', "#{frontend.tf_name}.tf")
+          if File.exist?(tf_file)
+            FileUtils.rm_f(tf_file)
+            @removed << tf_file
+            puts "  remove  #{tf_file}"
           end
 
-          puts "\n✓ Frontend removed!"
+          puts "\n✓ #{frontend.label.capitalize} removed!"
         else
-          puts '✗ No frontend/ directory found.'
+          puts "✗ No #{dir}/ directory found."
           exit 1
         end
       end
 
+      def target_frontends
+        registry = FrontendRegistry.new
+        return [] if registry.empty?
+
+        if @frontend_name
+          [registry.resolve!(@frontend_name)]
+        else
+          registry.all
+        end
+      end
+
       def destroy_views
         return unless @resource_name
 
-        pages_dir = "frontend/src/pages/#{@resource_name}"
-
-        if Dir.exist?(pages_dir)
-          FileUtils.rm_rf(pages_dir)
-          @removed << pages_dir
-          puts "  remove  #{pages_dir}/"
+        targets = target_frontends
+        if targets.empty?
+          pages_dir = "frontend/src/pages/#{@resource_name}"
+          if Dir.exist?(pages_dir)
+            FileUtils.rm_rf(pages_dir)
+            @removed << pages_dir
+            puts "  remove  #{pages_dir}/"
+          end
+          remove_view_routes_from('frontend/src/App.jsx')
+          return
         end
 
-        remove_view_routes
+        targets.each do |frontend|
+          pages_dir = "#{frontend.src_dir}/pages/#{@resource_name}"
+          if Dir.exist?(pages_dir)
+            FileUtils.rm_rf(pages_dir)
+            @removed << pages_dir
+            puts "  remove  #{pages_dir}/"
+          end
+          remove_view_routes_from(frontend.app_jsx)
+        end
       end
 
       def remove_file(path)
@@ -467,8 +499,7 @@ module Belt
         Belt::CLI::TablesCommand.sync_all_environments
       end
 
-      def remove_view_routes
-        app_jsx = 'frontend/src/App.jsx'
+      def remove_view_routes_from(app_jsx)
         return unless File.exist?(app_jsx)
 
         content = File.read(app_jsx)

data/lib/belt/cli/environment_command.rb

@@ -3,6 +3,8 @@
 require 'fileutils'
 require 'erb'
 require_relative 'app_detection'
+require_relative 'frontend_registry'
+require_relative 'frontend_setup_command'
 
 module Belt
   module CLI
@@ -52,6 +54,8 @@ module Belt
           puts "  create  #{dest_path}" unless @quiet
         end
 
+        append_extra_frontend_outputs(File.join(dest_dir, 'outputs.tf'))
+
         return if @quiet || !@announce
 
         puts "\n✓ Environment '#{@env_name}' created!"
@@ -82,6 +86,14 @@ module Belt
         File.write(dest_path, content)
       end
 
+      def append_extra_frontend_outputs(outputs_file)
+        FrontendRegistry.new.all.each do |frontend|
+          next if frontend.tf_name == 'frontend'
+
+          FrontendSetupCommand.append_env_outputs_for(frontend, outputs_file)
+        end
+      end
+
       # Resolve the state bucket name to use in backend.tf.
       # Priority: existing sibling backend.tf → AWS account ID → bare placeholder.
       def resolve_state_bucket

data/lib/belt/cli/explain_command.rb

@@ -36,7 +36,9 @@ module Belt
         'backup' => 'backups',
         'plugin' => 'plugins',
         'irb' => 'console',
-        'repl' => 'console'
+        'repl' => 'console',
+        'frontends' => 'frontend',
+        'spa' => 'frontend'
       }.freeze
 
       def self.run(args)

data/lib/belt/cli/frontend_command.rb

@@ -5,6 +5,7 @@ require 'erb'
 require 'json'
 require 'open3'
 require_relative 'app_detection'
+require_relative 'frontend_registry'
 
 module Belt
   module CLI
@@ -15,33 +16,39 @@ module Belt
       include AppDetection
 
       def self.run(args)
+        name = FrontendRegistry.extract_flag!(args, '--name')
+        path = FrontendRegistry.extract_flag!(args, '--path')
         framework = args.shift
 
         if framework.nil? || !FRAMEWORKS.include?(framework)
-          puts "Usage: belt generate frontend <#{FRAMEWORKS.join('|')}>"
+          puts "Usage: belt generate frontend <#{FRAMEWORKS.join('|')}> [--name NAME] [--path DIR]"
           puts "\nScaffolds a frontend application with build tooling and API client."
           puts "\nExamples:"
           puts '  belt generate frontend react'
           puts '  belt generate frontend vue'
+          puts '  belt generate frontend react --name ops --path ops-app'
           exit 1
         end
 
-        new(framework).generate
+        new(framework, name: name, path: path).generate
       end
 
-      def initialize(framework, quiet: false, announce: true)
+      def initialize(framework, quiet: false, announce: true, name: nil, path: nil)
         @framework = framework
         @quiet = quiet
         @announce = announce
         @app_name = detect_app_name
         @module_name = @app_name.split(/[-_]/).map(&:capitalize).join
+        @name = name || (path ? File.basename(path) : 'frontend')
+        @path = path || name || 'frontend'
+        @frontend = Frontend.new(name: @name, path: @path, default: @name == 'frontend' && @path == 'frontend')
       end
 
       def generate
-        dest_dir = 'frontend'
+        dest_dir = @frontend.path
 
         if Dir.exist?(dest_dir) && !Dir.empty?(dest_dir)
-          puts "Directory 'frontend/' already exists and is not empty."
+          puts "Directory '#{dest_dir}/' already exists and is not empty."
           exit 1
         end
 
@@ -54,8 +61,9 @@ module Belt
         end
 
         copy_template(framework_dir, dest_dir)
+        register_frontend!
 
-        puts "\n✓ Frontend (#{@framework}) created in frontend/" unless @quiet
+        puts "\n✓ Frontend (#{@framework}) created in #{dest_dir}/" unless @quiet
 
         install_dependencies(dest_dir)
         setup_frontend_infra_for_existing_environments
@@ -64,7 +72,11 @@ module Belt
         return if @quiet || !@announce
 
         puts "\nNext steps:"
-        puts '  belt server                   # Start local dev server'
+        if @frontend.name == 'frontend'
+          puts '  belt server                   # Start local dev server'
+        else
+          puts "  belt server --frontend #{@frontend.name}"
+        end
         puts '  belt deploy                   # Deploy everything to AWS'
       end
 
@@ -88,9 +100,18 @@ module Belt
         end
       end
 
+      def register_frontend!
+        custom = @frontend.name != 'frontend' || @frontend.path != 'frontend'
+        config_exists = FrontendRegistry.find_config_path
+        return unless custom || config_exists
+
+        dest = FrontendRegistry.register!(name: @frontend.name, path: @frontend.path)
+        puts "  update  #{dest} (#{@frontend.name})" unless @quiet
+      end
+
       def setup_frontend_infra_for_existing_environments
         module_dir = 'infrastructure/modules/app'
-        frontend_tf = File.join(module_dir, 'frontend.tf')
+        frontend_tf = File.join(module_dir, "#{@frontend.tf_name == 'frontend' ? 'frontend' : @frontend.tf_name}.tf")
 
         if File.exist?(frontend_tf)
           puts "  skip    #{frontend_tf} (already exists)" unless @quiet
@@ -101,7 +122,7 @@ module Belt
 
         puts "\n  Setting up frontend infrastructure..." unless @quiet
         require_relative 'frontend_setup_command'
-        FrontendSetupCommand.new(nil, quiet: true).run
+        FrontendSetupCommand.new(nil, quiet: true, frontend: @frontend).run
         puts "  create  #{frontend_tf}" unless @quiet
       end
 
@@ -118,7 +139,7 @@ module Belt
         require_relative 'views_command'
         resources.each do |resource_name|
           fields = ViewsCommand.read_schema_fields(resource_name)
-          ViewsCommand.new(resource_name, fields, force: true).generate
+          ViewsCommand.new(resource_name, fields, force: true, frontend: @frontend).generate
         end
       end