jets 3.1.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2aa7cee0958dbdb8e631abc755587de924e101c25b5f64d2f1c4b31ec1abf3d9
-  data.tar.gz: bd4aaa8264304a61a780140f1f0f33d0e68658d57c6be55487f27faa090fdf57
+  metadata.gz: 557e01dec1b92f8a04213ef4b7f5ee9d8a35f25dd20231c96ba24b0d9890b7cd
+  data.tar.gz: 5c8c12ae959d76dc9e5a681c8f18a40d5d60defcc4eead52ed9d9ad2571a3fe1
 SHA512:
-  metadata.gz: 0a0b34e96bb206743a192297848e70f03ef07ed587633e81bd1731881dcca2fb2a9232c374194c795b1e48eb537b690b882650c9f9173e5c77faca4cb1a9a83d
-  data.tar.gz: 2270fd363dc73f508e662ba4a115a71d54db9f298f5db17738328b88ec62284a544a41668a93b18bcbc094009d6bf178cc82c65e37a751f2af3036c8cb00a680
+  metadata.gz: 944a1d09ba4da26110e292cdf42d73a240d283d066dbe1ca677787c20b03ee925cf12e3d92555bc16e6327c7096ce59782cd271ff802f5d8554819674f040020
+  data.tar.gz: 987eac8ef96a9cc10b0ac071ff099c02245cf5143bb75d23622513aba73ba447414ab0c542f7a734c30ba6ce07f20cd479daecc030c02d9a5d3505c10c0a5c34

data/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: boltops-tools

data/CHANGELOG.md

@@ -3,6 +3,61 @@
 All notable changes to this project will be documented in this file.
 This project *loosely tries* to adhere to [Semantic Versioning](http://semver.org/).
 
+## [4.0.0] - 2023-05-27
+- [#641](https://github.com/boltops-tools/jets/pull/641) bundle check and prevent error from getting to aws lambda
+- [#642](https://github.com/boltops-tools/jets/pull/642) Fix rack mounted apps: update interface with removed meth
+- [#643](https://github.com/boltops-tools/jets/pull/643) JETS_EXTRA support, deprecate JETS_ENV_EXTRA
+- [#644](https://github.com/boltops-tools/jets/pull/644) remove docs to separate repo
+- [#645](https://github.com/boltops-tools/jets/pull/645) PreheatJob: fix function lookups and iam function permission
+- [#646](https://github.com/boltops-tools/jets/pull/646) log debug uploading and setting content type
+- [#647](https://github.com/boltops-tools/jets/pull/647) fix Jets.logger call
+- [#648](https://github.com/boltops-tools/jets/pull/648) make sure logger level info is default
+- [#649](https://github.com/boltops-tools/jets/pull/649) Custom Domain: Hard fail on IAM permission error
+- [#650](https://github.com/boltops-tools/jets/pull/650) Validate lambda function names
+- [#651](https://github.com/boltops-tools/jets/pull/651) allow custom rake tasks with params to work with jets as well as rake command
+- [#652](https://github.com/boltops-tools/jets/pull/652) Validate lambda function names: fix regexp
+- [#653](https://github.com/boltops-tools/jets/pull/653) refactor cleanup: rename Jets::Naming to Jets::Names
+- [#654](https://github.com/boltops-tools/jets/pull/654) Ruby 3.2 Support
+- apigw routes state save: fix to_json infinite loop from Grape apps
+- delete .python-version: more general approach. fixes specs when specific version of python is not installed
+
+## [3.2.2] - 2023-05-19
+- [#640](https://github.com/boltops-tools/jets/pull/640) Base path mapping CloudFormation custom resource and lambda function hardening
+
+## [3.2.1] - 2023-05-03
+- [#637](https://github.com/boltops-tools/jets/pull/637) Readme: Replace "splat out" with "had" a baby
+- [#638](https://github.com/boltops-tools/jets/pull/638) feature: update an array of reserved variables in aws lambda
+- [#639](https://github.com/boltops-tools/jets/pull/639) fix assets upload during deploy
+
+## [3.2.0] - 2022-12-03
+- [#631](https://github.com/boltops-tools/jets/pull/631) Implement vpc_endpoint_ids configuration
+- [#634](https://github.com/boltops-tools/jets/pull/634) Custom domain messaging
+- [#635](https://github.com/boltops-tools/jets/pull/635) smarter apigw routes paging calculation
+- Introduce the storage of APIGW routes state in the jets managed s3 bucket under path jets/state/apigw/pages.json and jets/state/apigw/routes.json
+- This speeds up deployment for apps with a large number of routes. Depending on the internet connection this can be minutes faster.
+- Update internationalization.md
+- fix domain.name check when APIGW changes
+- improve change apigw endpoint change messaging
+
+## [3.1.5] - 2022-08-08
+- [#628](https://github.com/boltops-tools/jets/pull/628) Multiple Databases
+- [#629](https://github.com/boltops-tools/jets/pull/629) loosen zeitwerk dependency in generated project Gemfile
+- [#630](https://github.com/boltops-tools/jets/pull/630) compile assets with WEBPACKER_ASSET_HOST as s3 endpoint url
+
+## [3.1.4] - 2022-07-02
+- [#627](https://github.com/boltops-tools/jets/pull/627) use >= for most gem dependencies
+
+## [3.1.3] - 2022-06-29
+- [#626](https://github.com/boltops-tools/jets/pull/626) aws options to better handle rate limit for base path mapping
+
+## [3.1.2] - 2022-04-24
+- [#618](https://github.com/boltops-tools/jets/pull/618) Jets Console accepts environment cli argument
+- [#621](https://github.com/boltops-tools/jets/pull/621) Add SQS and SNS event helpers for jobs
+- [#624](https://github.com/boltops-tools/jets/pull/624) Add lambda.function.ephemeral_storage function property support
+
+## [3.1.1] - 2022-01-18
+- [#615](https://github.com/boltops-tools/jets/pull/615) adjust required_ruby_version
+
 ## [3.1.0] - 2022-01-08
 - [#614](https://github.com/boltops-tools/jets/pull/614) support zeitwerk 2.5
 - clean command alias -y for --yes option

data/README.md

@@ -2,7 +2,7 @@
   <a href="http://rubyonjets.com"><img src="http://rubyonjets.com/img/logos/jets-logo-full.png" /></a>
 </div>
 
-Ruby and Lambda splat out a baby and that child's name is [Jets](http://rubyonjets.com/).
+Ruby and Lambda had a baby and that child's name is [Jets](http://rubyonjets.com/).
 
 ![Build Status](https://codebuild.us-west-2.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoiZ08vK2hjOHczQUVoUDhSYnBNNUU4T0gxQWJuOTlLaXpwVGQ1NjJ3NnVDY1dSdFVXQ3d2VXVSQzRFcU1qd1JPMndFZlByRktIcTUrZm5GWlM5dHpjM1ZrPSIsIml2UGFyYW1ldGVyU3BlYyI6Imluc1Qrd25GanhUdHlidjUiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)
 [![CircleCI](https://circleci.com/gh/boltops-tools/jets.svg?style=svg)](https://circleci.com/gh/boltops-tools/jets)
@@ -16,10 +16,6 @@ Please **watch/star** this repo to help grow and support the project.
 
 **Upgrading**: If you are upgrading Jets, please check on the [Upgrading Notes](http://rubyonjets.com/docs/extras/upgrading/).
 
-## Sponsors
-
-[![](https://img.boltops.com/boltops/tools/jets/sponsors/arist.png)](https://arist.co/)
-
 ## What is Ruby on Jets?
 
 Jets is a Ruby Serverless Framework.  Jets allows you to create serverless applications with a beautiful language: Ruby.  It includes everything required to build an application and deploy it to AWS Lambda.

data/backers.md

@@ -11,10 +11,5 @@ Funds donated via Patreon go directly to support Tung Nguyen's full-time work on
 <h2 align="center">Backers via Patreon</h2>
 
 <!--10 start-->
-- Erlend Finvåg
-- Nate Clark
-- Hirokatsu Endo
-- Michael Choi
-- Phan Lam
 - Theron Welch
 <!--10 end-->

data/jets.gemspec

@@ -14,7 +14,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://rubyonjets.com"
   spec.license       = "MIT"
 
-  spec.required_ruby_version = '~> 2.5'
+  spec.required_ruby_version = ['>= 2.5.0']
   spec.rdoc_options += Jets::Rdoc.options
 
   vendor_files       = Dir.glob("vendor/**/*")
@@ -44,7 +44,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "aws-sdk-sqs"
   spec.add_dependency "aws-sdk-ssm"
   spec.add_dependency "cfn-status"
-  spec.add_dependency "cfn_camelizer", "~> 0.4.6"
+  spec.add_dependency "cfn_camelizer", ">= 0.4.9"
   spec.add_dependency "cfn_response"
   spec.add_dependency "dotenv"
   spec.add_dependency "gems" # jets-gems dependency
@@ -57,11 +57,11 @@ Gem::Specification.new do |spec|
   spec.add_dependency "railties", "~> 6.1.0" # for ActiveRecord database_tasks.rb
   spec.add_dependency "rainbow"
   spec.add_dependency "recursive-open-struct"
-  spec.add_dependency "serverlessgems", "~> 0.1.4"
+  spec.add_dependency "serverlessgems", ">= 0.2.0"
   spec.add_dependency "shotgun"
   spec.add_dependency "text-table"
   spec.add_dependency "thor"
-  spec.add_dependency "zeitwerk", "~> 2.5.0"
+  spec.add_dependency "zeitwerk", ">= 2.6.0"
 
   spec.add_development_dependency "bundler"
   spec.add_development_dependency "byebug"

data/lib/jets/application/defaults.rb

@@ -51,6 +51,7 @@ class Jets::Application
       config.autoload_paths = [] # allows for customization
       config.ignore_paths = [] # allows for customization
       config.logger = Jets::Logger.new($stderr)
+      config.logger.level = Logger::INFO
       config.time_zone = "UTC"
 
       # function properties defaults
@@ -59,6 +60,7 @@ class Jets::Application
       # default memory setting based on:
       # https://medium.com/epsagon/how-to-make-lambda-faster-memory-performance-benchmark-be6ebc41f0fc
       config.function.memory_size = 1536
+      config.function.ephemeral_storage = { size: 512 } # megabytes
 
       config.prewarm = ActiveSupport::OrderedOptions.new
       config.prewarm.enable = true
@@ -76,10 +78,11 @@ class Jets::Application
       config.inflections.irregular = {}
 
       config.assets = ActiveSupport::OrderedOptions.new
-      config.assets.folders = %w[assets images packs]
       config.assets.base_url = nil # IE: https://cloudfront.com/my/base/path
-      config.assets.max_age = 3600
       config.assets.cache_control = nil # IE: public, max-age=3600 , max_age is a shorter way to set cache_control.
+      config.assets.folders = %w[assets images packs]
+      config.assets.max_age = 3600
+      config.assets.webpacker_asset_host = "s3_endpoint"  # true = use conventional by default
 
       config.ruby = ActiveSupport::OrderedOptions.new
 
@@ -97,6 +100,7 @@ class Jets::Application
       config.api.cors_authorization_type = nil # nil so ApiGateway::Cors#cors_authorization_type handles
       config.api.endpoint_policy = nil # required when endpoint_type is EDGE
       config.api.endpoint_type = 'EDGE' # PRIVATE, EDGE, REGIONAL
+      config.api.vpc_endpoint_ids = nil
 
       config.api.authorizers = ActiveSupport::OrderedOptions.new
       config.api.authorizers.default_token_source = "Auth" # method.request.header.Auth
@@ -159,6 +163,7 @@ class Jets::Application
 
       config.ruby = ActiveSupport::OrderedOptions.new
       config.ruby.check = true
+      config.ruby.supported_versions = %w[2.5 2.7 3.2] # supported by AWS Lambda
 
       config
     end

data/lib/jets/application.rb

@@ -163,13 +163,12 @@ class Jets::Application
     staging: 'stag',
   }
   def set_computed_configs!
-    # env_extra can be also be set with JETS_ENV_EXTRA.
-    # JETS_ENV_EXTRA higher precedence than config.env_extra
-    config.env_extra = ENV['JETS_ENV_EXTRA'] if ENV['JETS_ENV_EXTRA']
-    # IE: With env_extra: project-dev-1
-    #     Without env_extra: project-dev
+    # env var JETS_EXTRA higher precedence than config.extra
+    config.extra = Jets.extra
+    # IE: With extra: project-dev-1
+    #     Without extra: project-dev
     config.short_env = ENV_MAP[Jets.env.to_sym] || Jets.env
-    # table_namespace does not have the env_extra, more common case desired.
+    # table_namespace does not have the extra, more common case desired.
     config.table_namespace = [config.project_name, config.short_env].compact.join('-')
 
     config.project_namespace = Jets.project_namespace
@@ -205,7 +204,7 @@ class Jets::Application
     if File.exist?(database_yml)
       require "active_record/database_configurations" # lazy require
       text = Jets::Erb.result(database_yml)
-      db_configs = YAML.load(text)
+      db_configs = Jets::Util::Yamler.load(text)
       configurations = ActiveRecord::DatabaseConfigurations.new(db_configs)
       config.database = configurations
     end

data/lib/jets/aws_info.rb

@@ -73,7 +73,7 @@ module Jets
       return "fake-test-s3-bucket" if Jets.env.test?
       return @@s3_bucket unless @@s3_bucket == BUCKET_DOES_NOT_YET_EXIST
 
-      resp = cfn.describe_stacks(stack_name: Jets::Naming.parent_stack_name)
+      resp = cfn.describe_stacks(stack_name: Jets::Names.parent_stack_name)
       stack = resp.stacks.first
       output = stack["outputs"].find { |o| o["output_key"] == "S3Bucket" }
       @@s3_bucket = output["output_value"] # s3_bucket
@@ -83,7 +83,7 @@ module Jets
       # not been loaded in the config yet.  We do some trickery with loading
       # the config twice in Application#load_app_config
       # The first load will result in a Aws::CloudFormation::Errors::ValidationError
-      # since the Jets::Naming.parent_stack_name has not been properly set yet.
+      # since the Jets::Names.parent_stack_name has not been properly set yet.
       #
       # Rescuing all exceptions in case there are other exceptions dont know about yet
       # Here are the known ones: Aws::CloudFormation::Errors::ValidationError, Aws::CloudFormation::Errors::InvalidClientTokenId

data/lib/jets/aws_services.rb

@@ -86,10 +86,18 @@ module Jets::AwsServices
       retry_limit: 7, # default: 3
       retry_base_delay: 0.6, # default: 0.3
     }
+    # See debug logger. Noisy.
+    # Example:
+    #     D, [2022-12-02T13:18:55.298788 #26182] DEBUG -- : [Aws::APIGateway::Client 200 0.030837 0 retries] get_method(rest_api_id:"mke40eh6l0",resource_id:"zf8w2m",http_method:"GET")
     options.merge!(
       log_level: :debug,
       logger: Logger.new($stdout),
     ) if ENV['JETS_DEBUG_AWS_SDK']
+    # https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/debugging.html to enable http_wire_trace
+    # See the HTTP headers and JSON responses. Super noisy.
+    options.merge!(
+      http_wire_trace: true,
+    ) if ENV['JETS_DEBUG_AWS_SDK_HTTP_WIRE_TRACE']
     options
   end
 end

data/lib/jets/booter.rb

@@ -10,6 +10,7 @@ class Jets::Booter
       Jets::Bundle.require
 
       Jets.application.setup!
+      check_ruby_version!
 
       # Turbines are loaded after setup_autoload_paths in Jets.application.setup!  Some Turbine options are defined
       # in the project so setup must happen before internal Turbines are loaded.
@@ -94,11 +95,23 @@ class Jets::Booter
     # `show processlist` until after a query. Have confirmed that the connection is reused and the connection count stays
     # the same.
     def connect_db
-      primary_hash_config = ActiveRecord::Base.configurations.configs_for(env_name: Jets.env).find { |hash_config|
-        hash_config.name == "primary"
-      }
-      primary_config = primary_hash_config.configuration_hash # configuration_hash is a normal Ruby Hash
-      ActiveRecord::Base.establish_connection(primary_config)
+      if ActiveRecord::Base.legacy_connection_handling
+        primary_hash_config = ActiveRecord::Base.configurations.configs_for(env_name: Jets.env).find { |hash_config|
+          hash_config.name == "primary"
+        }
+
+        primary_config = primary_hash_config.configuration_hash # configuration_hash is a normal Ruby Hash
+
+        ActiveRecord::Base.establish_connection(primary_config)
+      else
+        configs = ActiveRecord::Base.configurations.configs_for(env_name: Jets.env, include_replicas: true)
+
+        databases = { }
+        databases[:writing] = :primary if configs.any? { |config| config.name == "primary" }
+        databases[:reading] = :primary_replica if configs.any? { |config| config.name == "primary_replica" }
+
+        ActiveRecord::Base.connects_to database: databases
+      end
     end
 
     def load_internal_turbines
@@ -162,5 +175,51 @@ class Jets::Booter
         exit 1
       end
     end
+
+    def check_ruby_version!
+      return if ENV['JETS_RUBY_CHECK'] == '0'
+      return if !Jets.config.ruby.check
+      return if ruby_version_supported?
+
+      puts <<~EOL.color(:red)
+        You are using Ruby #{RUBY_VERSION}
+        AWS Lambda does not support this version.
+        Please use one of the supported Ruby versions: #{supported_ruby_versions.join(' ')}
+      EOL
+
+      puts <<~EOL
+        If you would like to skip this check, you can set: JETS_RUBY_CHECK=0 or configure
+
+        config/application.rb
+
+            Jets.application.configure do
+              config.ruby.check = false
+            end
+
+        Or if you want to allow additional Ruby versions, then configure:
+
+        config/application.rb
+
+            Jets.application.configure do
+              config.ruby.supported_versions = ["2.5", "2.7", "3.2"]
+            end
+
+        Note: If AWS Lambda does not officially support the Ruby version,
+        you'll need to also provide the Ruby Custom Runtime Layer.
+        Related Docs: https://rubyonjets.com/docs/extras/custom-runtime/
+      EOL
+      exit 1
+    end
+
+    def ruby_version_supported?
+      md = RUBY_VERSION.match(/(\d+)\.(\d+)\.\d+/)
+      major, minor = md[1], md[2]
+      detected_ruby = [major, minor].join('.')
+      supported_ruby_versions.include?(detected_ruby)
+    end
+
+    def supported_ruby_versions
+      Jets.config.ruby.supported_versions
+    end
   end
 end

data/lib/jets/builders/code_builder.rb

@@ -26,7 +26,6 @@ module Jets::Builders
     end
 
     def build
-      check_ruby_version
       @version_purger.purge
       cache_check_message
 
@@ -80,6 +79,7 @@ module Jets::Builders
       return false if ENV['JETS_BUILD_NO_INTERNET']
       s3_key = "jets/code/#{filename}"
       begin
+        Jets.logger.debug "Checking s3://#{s3_bucket}/#{s3_key}"
         s3.head_object(bucket: s3_bucket, key: s3_key)
         true
       rescue Aws::S3::Errors::NotFound, Aws::S3::Errors::Forbidden
@@ -205,12 +205,45 @@ module Jets::Builders
       return unless webpacker_included?
 
       sh("yarn install")
+
+      ENV['WEBPACKER_ASSET_HOST'] = webpacker_asset_host if Jets.config.assets.webpacker_asset_host
       webpack_command = File.exist?("#{Jets.root}/bin/webpack") ?
           "bin/webpack" :
           `which webpack`.strip
       sh "JETS_ENV=#{Jets.env} #{webpack_command}"
     end
 
+    # Different url for these. Examples:
+    #
+    #   webpacker_asset_host https://demo-dev-s3bucket-lw5vq7ht8ip4.s3.us-west-2.amazonaws.com/jets/public/packs/media/images/boltops-0dd1c6bd.png
+    #   s3_base_url          https://s3-us-west-2.amazonaws.com/demo-dev-s3bucket-lw5vq7ht8ip4/jets/packs/media/images/boltops-0dd1c6bd.png
+    #
+    # Interesting: webpacker_asset_host works but s3_base_url does not for CORs. IE: reactjs or vuejs requests
+    # Thinking AWS configures the non-subdomain url endpoint to be more restrictive.
+    #
+    def webpacker_asset_host
+      # Allow user to set assets.webpacker_asset_host
+      #
+      #   Jets.application.configure do
+      #     config.assets.webpacker_asset_host = "https://cloudfront.com/my/base/path"
+      #   end
+      #
+      assets = Jets.config.assets
+      return assets.webpacker_asset_host if assets.webpacker_asset_host && assets.webpacker_asset_host != "s3_endpoint"
+      return assets.base_url if assets.base_url
+
+      # By default, will use the s3 url endpoint directly by convention
+      return unless assets.webpacker_asset_host == "s3_endpoint"
+
+      region = Jets.aws.region
+
+      asset_base_url = region == 'us-east-1' ?
+        "https://#{s3_bucket}.s3.amazonaws.com" :
+        "https://#{s3_bucket}.s3.#{region}.amazonaws.com"
+
+      "#{asset_base_url}/jets/public" # s3_base_url
+    end
+
     def webpacker_included?
       # Old code, leaving around for now:
       # Thanks: https://stackoverflow.com/questions/4195735/get-list-of-gems-being-used-by-a-bundler-project
@@ -322,7 +355,7 @@ module Jets::Builders
       webpacker_yml = "#{"#{stage_area}/code"}/config/webpacker.yml"
       return unless File.exist?(webpacker_yml)
 
-      config = YAML.load_file(webpacker_yml)
+      config = Jets::Util::Yamler.load_file(webpacker_yml)
       config["development"]["compile"] = false # force this to be false for deployment
       new_yaml = YAML.dump(config)
       IO.write(webpacker_yml, new_yaml)
@@ -379,25 +412,6 @@ module Jets::Builders
       FileUtils.cp_r(ruby_version_path, build_area)
     end
 
-    SUPPORTED_RUBY_VERSIONS = %w[2.5 2.7]
-    def check_ruby_version
-      return unless ENV['JETS_RUBY_CHECK'] == '0' || Jets.config.ruby.check == false
-      return if ruby_version_supported?
-      puts <<~EOL.color(:red)
-      You are using Ruby version #{RUBY_VERSION} which is not supported by Jets.
-      Please use one of the Jets supported ruby versions: #{SUPPORTED_RUBY_VERSIONS.join(' ')}
-      If you would like to skip this check you can set: JETS_RUBY_CHECK=0
-      EOL
-      exit 1
-    end
-
-    def ruby_version_supported?
-      md = RUBY_VERSION.match(/(\d+)\.(\d+)\.\d+/)
-      major, minor = md[1], md[2]
-      detected_ruby = [major, minor].join('.')
-      SUPPORTED_RUBY_VERSIONS.include?(detected_ruby)
-    end
-
     # Group all the path settings together here
     def self.tmp_code
       Jets::Commands::Build.tmp_code

data/lib/jets/builders/gem_replacer.rb

@@ -1,6 +1,8 @@
 module Jets::Builders
   class GemReplacer
     extend Memoist
+    include Util
+    
     def initialize(options)
       @options = options
     end
@@ -37,13 +39,6 @@ module Jets::Builders
       FileUtils.mv(src, dest) unless File.exist?(dest) # looks like rename_gem actually runs twice
     end
 
-    def sh(command)
-      puts "=> #{command}".color(:green)
-      success = system(command)
-      abort("Command Failed: #{command}") unless success
-      success
-    end
-
     def ruby_folder
       Jets::Gems.ruby_folder
     end

data/lib/jets/builders/ruby_packager.rb

@@ -3,9 +3,9 @@ require "bundler" # for clean_old_submodules only
 module Jets::Builders
   class RubyPackager
     include Util
-    
-    GEM_REGEXP = /-(arm|x)\d+.*-(darwin|linux)/    
-    
+
+    GEM_REGEXP = /-(arm|x)\d+.*-(darwin|linux)/
+
     attr_reader :full_app_root
     def initialize(relative_app_root)
       @full_app_root = "#{build_area}/#{relative_app_root}"
@@ -16,6 +16,7 @@ module Jets::Builders
 
       clean_old_submodules
       bundle_install
+      bundle_check
       copy_bundle_config
       copy_cache_gems
     end
@@ -75,7 +76,39 @@ module Jets::Builders
       # For example we add the jets-rails to the Gemfile.
       copy_back_gemfile_lock
 
-      puts 'Bundle install success.'
+      puts 'Bundle install completed'
+    end
+
+    # Example `bundle check` error:
+    #
+    #     The following gems are missing
+    #     * date (3.3.3)
+    #     * timeout (0.3.2)
+    #     Install missing gems with `bundle install`
+    #
+    # Example success:
+    #
+    #     The Gemfile's dependencies are satisfied
+    #
+    def bundle_check
+      out = ''
+      Bundler.with_unbundled_env do
+        out = `cd #{cache_area} && bundle check 2>&1`
+      end
+      if out.include?("missing")
+        puts "Failed: bundle check".color(:red)
+        puts <<~EOL
+          This means something went wrong with the bundle install.
+          Jets will prevent the deployment to AWS Lambda.
+          It's better to error now instead of finding out on AWS Lambda.
+          The bundle install can fail for different system-specific reasons.
+          It could be an outdated or incompatible version of RubyGems and Ruby.
+
+          Related: https://community.boltops.com/t/could-not-find-timeout-0-3-1-in-any-of-the-sources/996
+
+        EOL
+        exit 1
+      end
     end
 
     def copy_back_gemfile_lock

data/lib/jets/cfn/builders/api_deployment_builder.rb

@@ -45,7 +45,7 @@ module Jets::Cfn::Builders
 
     # template_path is an interface method
     def template_path
-      Jets::Naming.api_deployment_template_path
+      Jets::Names.api_deployment_template_path
     end
 
     # do not bother writing a template if routes are empty

data/lib/jets/cfn/builders/api_gateway_builder.rb

@@ -18,7 +18,7 @@ module Jets::Cfn::Builders
 
     # template_path is an interface method
     def template_path
-      Jets::Naming.api_gateway_template_path
+      Jets::Names.api_gateway_template_path
     end
 
     # do not bother writing a template if routes are empty
@@ -49,19 +49,19 @@ module Jets::Cfn::Builders
 
     def add_route53_dns
       dns = Jets::Resource::Route53::RecordSet.new
-      if !existing_domain_name?(dns.domain_name) or existing_dns_record_on_stack? 
+      if !existing_domain_name?(dns.domain_name) or existing_dns_record_on_stack?
         add_resource(dns)
         add_outputs(dns.outputs)
       end
     end
 
-    def create_domain_name()
+    def create_domain_name
       resource = Jets::Resource::ApiGateway::DomainName.new
-      
+
       return {
         "DomainName" => resource.domain_name
       } if (existing_domain_name?(resource) and !existing_domain_name_on_stack?)
-      
+
       add_resource(resource)
       return resource.outputs
     end
@@ -70,41 +70,44 @@ module Jets::Cfn::Builders
       apigateway.get_domain_name({
         domain_name: resource.domain_name
       })
-      return true
-    rescue
-      return false
+      true
+    # IE: Aws::APIGateway::Errors::NotFoundException Invalid domain name identifier specified
+    rescue Aws::APIGateway::Errors::NotFoundException
+      false
     end
     memoize :existing_domain_name?
 
     def existing_domain_name_on_stack?
-      cfn.describe_stack_resource({
+      cfn.describe_stack_resource(
         stack_name: api_gateway_physical_resource_id,
         logical_resource_id: "DomainName"
-      })
-      return true
-    rescue
-      return false
+      )
+      true
+    # IE: Aws::CloudFormation::Errors::ValidationError (Resource DomainName does not exist for stack demo-dev)
+    rescue Aws::CloudFormation::Errors::ValidationError
+      false
     end
 
     def existing_dns_record_on_stack?
-      cfn.describe_stack_resource({
+      cfn.describe_stack_resource(
         stack_name: api_gateway_physical_resource_id,
         logical_resource_id: "DnsRecord"
-      })
-      return true
-    rescue
-      return false
+      )
+      true
+    # IE: Aws::CloudFormation::Errors::ValidationError (Resource DnsRecord does not exist for stack demo-dev)
+    rescue Aws::CloudFormation::Errors::ValidationError
+      false
     end
 
     def api_gateway_physical_resource_id
-      cfn.describe_stack_resource({
-        stack_name: Jets::Naming.parent_stack_name,
+      resp = cfn.describe_stack_resource(
+        stack_name: Jets::Names.parent_stack_name,
         logical_resource_id: "ApiGateway"
-      })
-      .stack_resource_detail
-      .physical_resource_id
-    rescue
-      return nil
+      )
+      resp&.stack_resource_detail&.physical_resource_id
+    # IE: Aws::CloudFormation::Errors::ValidationError (Resource ApiGateway does not exist for stack demo-dev)
+    rescue Aws::CloudFormation::Errors::ValidationError
+      nil
     end
     memoize :api_gateway_physical_resource_id
 
@@ -114,8 +117,9 @@ module Jets::Cfn::Builders
     def add_gateway_routes
       # Reject homepage. Otherwise we have 200 - 1 resources on the first page.
       # There's a next call in ApiResources.add_gateway_resources to skip the homepage.
-      all_paths = Jets::Router.all_paths.reject { |p| p == '' }
-      all_paths.each_slice(PAGE_LIMIT).each_with_index do |paths, i|
+      page_builder = Jets::Cfn::Builders::PageBuilder.new
+      pages = page_builder.build
+      pages.each_with_index do |paths, i|
         ApiResourcesBuilder.new(@options, paths, i+1).build
       end
     end

data/lib/jets/cfn/builders/api_resources_builder.rb

@@ -16,7 +16,7 @@ module Jets::Cfn::Builders
 
     # template_path is an interface method
     def template_path
-      Jets::Naming.api_resources_template_path(@page)
+      Jets::Names.api_resources_template_path(@page)
     end
 
     def add_rest_api_parameter

data/lib/jets/cfn/builders/authorizer_builder.rb

@@ -61,7 +61,7 @@ module Jets::Cfn::Builders
     end
 
     def template_path
-      Jets::Naming.authorizer_template_path(@path)
+      Jets::Names.authorizer_template_path(@path)
     end
   end
 end