letter_opener_web_wally 2.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a34ba978b666fa88474ab1697dfa5d323e7d15043ab62e308e5668169afdfcb9
+  data.tar.gz: d9966db09bb55a8087663f307544635260049d4c0ddaff8340b057ee1087ee3e
+SHA512:
+  metadata.gz: 0df7f91a15f1777e24c2e0e1d1de818e9c2072f29c7331fb287ccebe87854d81218bc4f0835df61b8eafdf4b7d9be485747398c88fd151be5aefe6294c2ada49
+  data.tar.gz: bead6616179ea77f6b7fdc1d76e3d8452a8a40fec479a00226169a28409c59936c95db961eeee97bf0d77e591ee925efe9ba171ecc8960a3305e21f750a50865

data/.github/workflows/brakeman-analysis.yml

@@ -0,0 +1,36 @@
+# This workflow integrates Brakeman with GitHub's Code Scanning feature
+# Brakeman is a static analysis security vulnerability scanner for Ruby on Rails applications
+
+name: Brakeman Scan
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [main]
+  schedule:
+    - cron: "21 4 * * 4"
+
+jobs:
+  brakeman-scan:
+    name: Brakeman Scan
+    runs-on: ubuntu-latest
+    steps:
+      # Checkout the repository to the GitHub Actions runner
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      # Customize the ruby version depending on your needs
+      - name: Setup Ruby, JRuby and TruffleRuby
+        uses: ruby/setup-ruby@v1.196.0
+        with:
+          ruby-version: 3.2
+
+      # Install dependencies
+      - name: Install dependencies
+        run: bundle install
+
+      # Run Brakeman
+      - name: Brakeman code scanning
+        uses: standardnotes/brakeman-action@v1.0.0

data/.github/workflows/main.yml

@@ -0,0 +1,29 @@
+name: Run tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby 3.2
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+          bundler-cache: true
+
+      - name: Install dependencies
+        run: bundle install
+
+      - name: Run tests
+        run: bundle exec rake
+
+      - name: Build gem
+        run: bundle exec rake build

data/.github/workflows/release-gem.yml

@@ -0,0 +1,32 @@
+name: Release gem
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: Build + Publish
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Set up Ruby 3.2
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+
+      - run: bundle install
+
+      - name: Publish to RubyGems
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          bundle exec rake build
+          gem push pkg/*.gem
+        env:
+          GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.ruby-version
+.yardoc
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+spec/dummy/log/
+test/tmp
+test/version_tmp
+tmp
+Gemfile.lock
+

data/.rspec

@@ -0,0 +1,4 @@
+--order rand
+--color
+--format progress
+--require rails_helper

data/.rubocop.yml

@@ -0,0 +1,29 @@
+---
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.2
+  Exclude:
+    - "spec/dummy/bin/**/*"
+    - "tmp/**/*"
+    - "vendor/**/*"
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*_spec.rb
+
+Layout/LineLength:
+  Max: 120
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/AbcSize:
+  Max: 25
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,19 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2021-10-02 14:42:36 UTC using RuboCop version 1.22.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 5
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'app/controllers/letter_opener_web/letters_controller.rb'
+    - 'app/models/letter_opener_web/letter.rb'
+    - 'lib/letter_opener_web.rb'
+    - 'lib/letter_opener_web/delivery_method.rb'
+    - 'lib/letter_opener_web/engine.rb'

data/CHANGELOG.md

@@ -0,0 +1,95 @@
+## [v2.0.0](https://github.com/fgrehm/letter_opener_web/compare/v1.4.1...v2.0.0)
+
+  - Require Rails >= 5.2, run tests against Rails 6.1 [#113](https://github.com/fgrehm/letter_opener_web/pull/113)
+  - Inline CSS and Javascript, to avoid dependency on asset pipeline [#113](https://github.com/fgrehm/letter_opener_web/pull/113)
+  - Upgrade to Bootstrap 5.1.1 [#113](https://github.com/fgrehm/letter_opener_web/pull/113)
+  - Add rexml gem into dependency for Ruby 3.0 [#106](https://github.com/fgrehm/letter_opener_web/pull/106)
+  - Add routes for Rails API mode [#69](https://github.com/fgrehm/letter_opener_web/pull/69)
+  - Prevent name conflict with `Letter` class [#108](https://github.com/fgrehm/letter_opener_web/pull/108)
+  - Add Rails' built-in CSRF protection [#111](https://github.com/fgrehm/letter_opener_web/pull/111)
+  - Add Rails' CSP nonce to the script tag [#112](https://github.com/fgrehm/letter_opener_web/pull/112)
+  - Update dev dependencies [#113](https://github.com/fgrehm/letter_opener_web/pull/113)
+  - Switched to using GitHub actions as CI for the project [#113](https://github.com/fgrehm/letter_opener_web/pull/113)
+
+## [1.4.1](https://github.com/fgrehm/letter_opener_web/compare/v1.4.0...v1.4.1) (Oct 5, 2021)
+
+  - Ensure letter is within letters base path [#110](https://github.com/fgrehm/letter_opener_web/pull/110)
+
+## [1.4.0](https://github.com/fgrehm/letter_opener_web/compare/v1.3.4...v1.4.0) (Jan 29, 2020)
+
+  - Removed the dependency on the asset pipeline. Good news for API-only apps! [#83](https://github.com/fgrehm/letter_opener_web/pull/83)
+  - Avoid `require_dependency` if Zeitwerk is enabled [#98](https://github.com/fgrehm/letter_opener_web/pull/98)
+  - Drop support for old rubies and rails. Ruby 2.5+ is supported and Rails 4 is no longer tested [#100](https://github.com/fgrehm/letter_opener_web/pull/100)
+
+## [1.3.4](https://github.com/fgrehm/letter_opener_web/compare/v1.3.3...v1.3.4) (Apr 04, 2018)
+
+### Fixed
+
+  - Due to a load order issue, sometimes the main `ApplicationController` was used by this gem (unnecessary) [#82](https://github.com/fgrehm/letter_opener_web/pull/82)
+
+## [1.3.3](https://github.com/fgrehm/letter_opener_web/compare/v1.3.2...v1.3.3) (Jan 29, 2018)
+
+  - Set `LAUNCHY_DRY_RUN` explicitly to avoid `Launchy::CommandNotFoundError` [#75](https://github.com/fgrehm/letter_opener_web/pull/75)
+  - Update Ruby matrix for test to include more recent versions [#77](https://github.com/fgrehm/letter_opener_web/pull/77)
+
+## [1.3.2](https://github.com/fgrehm/letter_opener_web/compare/v1.3.1...v1.3.2) (Jan 14, 2018)
+
+  - Disable Launchy with ENV to avoid redefining the whole delivery method [#73](https://github.com/fgrehm/letter_opener_web/pull/73)
+  - Fix new Rubocop warnings [#72](https://github.com/fgrehm/letter_opener_web/pull/72)
+  - Hover state fixed to only highlight `tbody>tr` [#70](https://github.com/fgrehm/letter_opener_web/pull/70)
+  - Use `ActiveSupport.on_load` to make sure we don't have load order issues [#66](https://github.com/fgrehm/letter_opener_web/pull/66)
+
+## [1.3.1](https://github.com/fgrehm/letter_opener_web/compare/v1.3.0...v1.3.1) (Feb 04, 2017)
+
+  - Remove warnings about unused variables [#45](https://github.com/fgrehm/letter_opener_web/pull/45)
+  - Remove Rails 5 deprecation warnings [#54](https://github.com/fgrehm/letter_opener_web/pull/54)
+
+## [1.3.0](https://github.com/fgrehm/letter_opener_web/compare/v1.2.3...v1.3.0) (Feb 02, 2015)
+
+  - Depend on `railties` and `actionmailer` [#38](https://github.com/fgrehm/letter_opener_web/pull/38)
+
+## [1.2.3](https://github.com/fgrehm/letter_opener_web/compare/v1.2.2...v1.2.3) (Sep 12, 2014)
+
+  - Fix exception with `sprockets-rails` >= `2.1.4` [#32](https://github.com/fgrehm/letter_opener_web/issues/32) / [#33](https://github.com/fgrehm/letter_opener_web/pull/33)
+
+## [1.2.2](https://github.com/fgrehm/letter_opener_web/compare/v1.2.1...v1.2.2) (Jul 17, 2014)
+
+  - Precompile glyphicons [#30](https://github.com/fgrehm/letter_opener_web/pull/30)
+  - Display letters count on the favicon [#29](https://github.com/fgrehm/letter_opener_web/pull/29)
+  - Validate params passed in to the LettersController and return a 404 in case an email can't be found [#28](https://github.com/fgrehm/letter_opener_web/pull/28)
+
+## [1.2.1](https://github.com/fgrehm/letter_opener_web/compare/v1.2.0...v1.2.1) (Apr 07, 2014)
+
+  - Improve Rails 3 compatibility [#26](https://github.com/fgrehm/letter_opener_web/pull/26) / [#27](https://github.com/fgrehm/letter_opener_web/pull/27)
+
+## [1.2.0](https://github.com/fgrehm/letter_opener_web/compare/v1.1.3...v1.2.0) (Apr 07, 2014)
+
+  - Add support for removing a single email [#23](https://github.com/fgrehm/letter_opener_web/pull/23)
+  - Move vendored assets into the `letter_opener_web` folder [#24](https://github.com/fgrehm/letter_opener_web/issues/24)
+  - Avoid matching `<address>` when changing email links to open on new tabs [#22](https://github.com/fgrehm/letter_opener_web/pull/22)
+
+## [1.1.3](https://github.com/fgrehm/letter_opener_web/compare/v1.1.2...v1.1.3) (Feb 21, 2014)
+
+  - Include assets into `precompile` list [#21](https://github.com/fgrehm/letter_opener_web/pull/21)
+
+## [1.1.2](https://github.com/fgrehm/letter_opener_web/compare/v1.1.1...v1.1.2) (Dec 12, 2013)
+
+  - Nicely handle empty links [#18](https://github.com/fgrehm/letter_opener_web/pull/18)
+
+## [1.1.1](https://github.com/fgrehm/letter_opener_web/compare/v1.1.0...v1.1.1) (Oct 15, 2013)
+
+  - Fix deprecation warning on Rails 4 [#17](https://github.com/fgrehm/letter_opener_web/pull/17)
+
+## [1.1.0](https://github.com/fgrehm/letter_opener_web/compare/v1.0.3...v1.1.0) (Aug 29, 2013)
+
+  - "Relax" Rails dependency in order to use the gem on 4.0 [#15](https://github.com/fgrehm/letter_opener_web/issues/15)
+
+## [1.0.3](https://github.com/fgrehm/letter_opener_web/compare/v1.0.2...v1.0.3) (May 29, 2013)
+
+  - Fix clear button [#12](https://github.com/fgrehm/letter_opener_web/issues/12), tks to [@grumpit](https://github.com/grumpit)
+
+## Previous
+
+The changelog began with version 1.0.3 so any changes prior to that
+can be seen by checking the tagged releases and reading git commit
+messages.

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'http://rubygems.org'
+
+# Declare your gem's dependencies in letter_opener_web.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec

data/README.md

@@ -0,0 +1,176 @@
+# letter_opener_web
+
+![Build Status](https://github.com/fgrehm/letter_opener_web/actions/workflows/main.yml/badge.svg)
+[![Gem Version](https://badge.fury.io/rb/letter_opener_web.svg)](http://badge.fury.io/rb/letter_opener_web)
+[![Code Climate](https://codeclimate.com/github/fgrehm/letter_opener_web.svg)](https://codeclimate.com/github/fgrehm/letter_opener_web)
+
+Gives [letter_opener](https://github.com/ryanb/letter_opener) an interface for
+browsing sent emails.
+
+Check out http://letter-opener-web.herokuapp.com to see it in action.
+
+## Installation
+
+First add the gem to your development environment and run the `bundle` command to install it.
+
+```ruby
+group :development do
+  gem 'letter_opener_web', '~> 2.0'
+end
+```
+
+## Usage
+
+Add to your routes.rb:
+
+```ruby
+Your::Application.routes.draw do
+  mount LetterOpenerWeb::Engine, at: "/letter_opener" if Rails.configuration.delivery_method == :letter_opener_web
+end
+```
+
+And make sure you have [`:letter_opener` delivery method](https://github.com/ryanb/letter_opener#rails-setup)
+configured for your app. Then visit `http://localhost:3000/letter_opener` after
+sending an email and have fun.
+
+If you are running the app from a [Vagrant](http://vagrantup.com) machine or Docker
+container, you might want to skip `letter_opener`'s `launchy` calls and avoid messages
+like these:
+
+```terminal
+12:33:42 web.1  | Failure in opening /vagrant/tmp/letter_opener/1358825621_ba83a22/rich.html
+with options {}: Unable to find a browser command. If this is unexpected, Please rerun with
+environment variable LAUNCHY_DEBUG=true or the '-d' commandline option and file a bug at
+https://github.com/copiousfreetime/launchy/issues/new
+```
+
+In that case (or if you really just want to browse mails using the web interface and
+don't care about opening emails automatically), you can set `:letter_opener_web` as
+your delivery method on your `config/environments/development.rb`:
+
+```ruby
+config.action_mailer.delivery_method = :letter_opener_web
+```
+
+If you're using `:letter_opener_web` as your delivery method, you can change the location of
+the letters by adding the following to an initializer (or in development.rb):
+
+```ruby
+LetterOpenerWeb.configure do |config|
+  config.letters_location = Rails.root.join('your', 'new', 'path')
+end
+```
+
+Letter Opener Web can also be used with Amazon S3 to store letters instead of filesystem.
+You can change the storage type by adding the following to an initializer (or indevelopment.rb):
+
+```ruby
+LetterOpenerWeb.configure do |config|
+  config.letters_storage = :s3
+  config.letters_location = "any/prefix/you/want"
+  config.aws_access_key_id = ENV['AWS_ACCESS_KEY_ID']
+  config.aws_secret_access_key = ENV['AWS_SECRET_ACCESS_KEY']
+  config.aws_region = ENV['AWS_REGION']
+  config.aws_bucket = ENV['AWS_BUCKET']
+end
+```
+
+## Usage on pre-production environments
+
+Some people use this gem on staging / pre-production environments to avoid having real emails
+being sent out. To set that up you'll need to:
+
+1. Move the gem out of the `development` group in your `Gemfile`
+2. Set `config.action_mailer.delivery_method` on the appropriate `config/environments/<env>.rb`
+3. Enable the route for the environments on your `routes.rb`.
+
+In other words, your `Gemfile` will have:
+
+```ruby
+gem 'letter_opener_web'
+```
+
+And your `routes.rb`:
+
+```ruby
+Your::Application.routes.draw do
+  # If you have a dedicated config/environments/staging.rb
+  mount LetterOpenerWeb::Engine, at: "/letter_opener" if Rails.env.staging?
+
+  # If you use RAILS_ENV=production in staging environments, you'll need another
+  # way to disable it in "real production"
+  mount LetterOpenerWeb::Engine, at: "/letter_opener" unless ENV["PRODUCTION_FOR_REAL"]
+end
+```
+
+You might also want to have a look at the sources for the [demo](http://letter-opener-web.herokuapp.com)
+available at https://github.com/fgrehm/letter_opener_web_demo.
+
+### Usage with Amazon S3 to support multiple separated instances
+
+If you are using this gem on Heroku and your application is not using one Dyno or your have containerized setup, the default configuration won't work as the e-mail is saved on the server. You can use S3 bucket instead.
+
+**1. Configure AWS environment:**
+
+* Create new non-public bucket, note the name and the region
+* Create new user using IAM or use existing one for which you already have `aws_access_key_id` and `aws_secret_access_key`
+* Assign proper policy to the user. Replace `your-bucket-name` with the name of the bucket you have created
+
+```json
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "VisualEditor0",
+      "Effect": "Allow",
+      "Action": [
+          "s3:PutObject",
+          "s3:PutObjectAcl",
+          "s3:GetObject",
+          "s3:DeleteObject*"
+      ],
+      "Resource": "arn:aws:s3:::your-bucket-name/*"
+    },
+    {
+      "Sid": "VisualEditor1",
+      "Effect": "Allow",
+      "Action": [
+          "s3:ListBucket"
+      ],
+      "Resource": "arn:aws:s3:::your-bucket-name"
+    }
+  ]
+}
+```
+
+**2. Update gem configuration:**
+
+Add the following configuration to the initializer (or environment files):
+
+```ruby
+LetterOpenerWeb.configure do |config|
+  config.aws_access_key_id = ENV['AWS_ACCESS_KEY_ID']
+  config.aws_secret_access_key = ENV['AWS_SECRET_ACCESS_KEY']
+  config.aws_region = ENV['AWS_REGION']
+  config.aws_bucket = ENV['AWS_BUCKET']
+  config.letters_storage = :s3
+  config.letters_location = "any prefix you want"
+end
+```
+
+When you send e-mail with attachment(s), the presigned link is generated to attachment that is valid for 1 week.
+
+## Acknowledgements
+
+Special thanks to [@alexrothenberg](https://github.com/alexrothenberg) for some
+ideas on [this pull request](https://github.com/ryanb/letter_opener/pull/12) and
+[@pseudomuto](https://github.com/pseudomuto) for keeping the project alive for a
+few years.
+
+## Contributing
+
+1. Fork it and run `bin/setup`
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+RSpec::Core::RakeTask.new(:spec)
+task default: %i[spec rubocop]

data/app/controllers/letter_opener_web/application_controller.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module LetterOpenerWeb
+  class ApplicationController < ActionController::Base
+    protect_from_forgery with: :exception, unless: -> { Rails.configuration.try(:api_only) }
+  end
+end

data/app/controllers/letter_opener_web/letters_controller.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+unless Rails.respond_to?(:autoloaders) && Rails.autoloaders.zeitwerk_enabled?
+  require_dependency 'letter_opener_web/application_controller'
+end
+
+module LetterOpenerWeb
+  class LettersController < ApplicationController
+    before_action :check_style, only: :show
+    before_action :load_letter, only: %i[show attachment destroy]
+    before_action :letter_params, only: %i[show attachment]
+
+    def index
+      @letters = letter_model.search
+    end
+
+    def show
+      text = @letter.send("#{letter_params[:style]}_text")
+                    .gsub('"plain.html"', "\"#{routes.letter_path(id: @letter.id, style: 'plain')}\"")
+                    .gsub('"rich.html"', "\"#{routes.letter_path(id: @letter.id, style: 'rich')}\"")
+
+      render html: text.html_safe
+    end
+
+    def attachment
+      filename = "#{letter_params[:file]}.#{letter_params[:format]}"
+      file     = @letter.attachments[filename]
+
+      return render plain: 'Attachment not found!', status: 404 unless file.present?
+      return redirect_to(file, allow_other_host: true) if LetterOpenerWeb.config.letters_storage == :s3
+
+      send_file(file, filename:, disposition: 'inline')
+    end
+
+    def clear
+      letter_model.destroy_all
+      redirect_to routes.letters_path
+    end
+
+    def destroy
+      @letter.delete
+      respond_to do |format|
+        format.html { redirect_to routes.letters_path }
+        format.js { render js: "window.location='#{routes.letters_path}'" }
+      end
+    end
+
+    private
+
+    def letter_params
+      params.permit(:style, :file, :format, :id)
+    end
+
+    def check_style
+      letter_params[:style] = 'rich' unless %w[plain rich].include?(letter_params[:style])
+    end
+
+    def load_letter
+      @letter = letter_model.find(letter_params[:id])
+
+      head :not_found unless @letter.valid?
+    end
+
+    def routes
+      LetterOpenerWeb.railtie_routes_url_helpers
+    end
+
+    def letter_model
+      case LetterOpenerWeb.config.letters_storage
+      when :s3
+        LetterOpenerWeb::AwsLetter
+      else
+        LetterOpenerWeb::Letter
+      end
+    end
+  end
+end

data/app/models/letter_opener_web/aws_letter.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module LetterOpenerWeb
+  class AwsLetter < BaseLetter
+    def self.aws_list_letters(path = [], **)
+      LetterOpenerWeb
+        .aws_client
+        .list_objects_v2(
+          bucket: LetterOpenerWeb.config.aws_bucket,
+          prefix: File.join([letters_location, *path].compact),
+          **
+        )
+    end
+    delegate :aws_list_letters, to: :class
+
+    def self.search
+      letters = aws_list_letters(delimiter: '.html').common_prefixes.map do |prefix|
+        new(id: File.basename(File.dirname(prefix.prefix)))
+      end
+
+      letters.reverse
+    end
+
+    def self.destroy_all
+      letters = aws_list_letters.contents.map(&:key)
+
+      LetterOpenerWeb.aws_client.delete_objects(
+        bucket: LetterOpenerWeb.config.aws_bucket,
+        delete: {
+          objects: letters.map { |key| { key: } },
+          quiet: false
+        }
+      )
+    end
+
+    def attachments
+      @attachments ||= aws_list_letters([id, 'attachments/']).contents.each_with_object({}) do |file, hash|
+        hash[File.basename(file.key)] = attachment_url(file.key)
+      end
+    end
+
+    def delete
+      return unless valid?
+
+      letters = aws_list_letters([id]).contents.map(&:key)
+
+      LetterOpenerWeb.aws_client.delete_objects(
+        bucket: LetterOpenerWeb.config.aws_bucket,
+        delete: {
+          objects: letters.map { |key| { key: } },
+          quiet: false
+        }
+      )
+    end
+
+    def valid?
+      aws_list_letters([id]).contents.any?
+    end
+
+    private
+
+    def attachment_url(key)
+      bucket = Aws::S3::Bucket.new(
+        name: LetterOpenerWeb.config.aws_bucket, client: LetterOpenerWeb.aws_client
+      )
+
+      obj = bucket.object(key)
+      obj.presigned_url(:get, expires_in: 1.week.to_i)
+    end
+
+    def objects
+      @objects ||= {}
+    end
+
+    def read_file(style)
+      return objects[style] if objects.key?(style)
+
+      response = LetterOpenerWeb.aws_client
+                                .get_object(
+                                  bucket: LetterOpenerWeb.config.aws_bucket,
+                                  key: File.join(letters_location, id, "#{style}.html")
+                                )
+
+      response.body.read.tap do |value|
+        objects[style] = value
+      end
+    rescue Aws::S3::Errors::NoSuchKey
+      ''
+    end
+
+    def style_exists?(style)
+      return !objects[style].empty? if objects.key?(style)
+
+      objects[style] = read_file(style)
+      !objects[style].empty?
+    end
+  end
+end