hensei-api/app/services/character_image_download_service.rb
Justin Edmund deb5cfddb2 add character creation + image download API
- validate granblue_id via HEAD request to GBF CDN
- create characters with editor role check (role >= 7)
- async image download job with Redis status polling
- download_status endpoint for progress tracking
2025-12-01 00:48:40 -08:00

76 lines
2.1 KiB
Ruby

# frozen_string_literal: true
# Service wrapper for downloading character images from Granblue servers to S3.
# Uses the existing CharacterDownloader but provides a cleaner interface for controllers.
#
# @example Download images for a character
# service = CharacterImageDownloadService.new(character)
# result = service.download
# if result.success?
# puts result.images
# else
# puts result.error
# end
class CharacterImageDownloadService
Result = Struct.new(:success?, :images, :error, :total, keyword_init: true)
def initialize(character, options = {})
@character = character
@force = options[:force] || false
@size = options[:size] || 'all'
@storage = options[:storage] || :s3
end
# Downloads images for the character
#
# @return [Result] Struct with success status, images manifest, and any errors
def download
downloader = Granblue::Downloaders::CharacterDownloader.new(
@character.granblue_id,
storage: @storage,
verbose: Rails.env.development?
)
selected_size = @size == 'all' ? nil : @size
downloader.download(selected_size)
manifest = build_image_manifest
Result.new(
success?: true,
images: manifest,
total: count_total_images(manifest)
)
rescue StandardError => e
Rails.logger.error "[CharacterImageDownload] Failed for #{@character.granblue_id}: #{e.message}"
Result.new(
success?: false,
error: e.message
)
end
private
def build_image_manifest
sizes = Granblue::Downloaders::CharacterDownloader::SIZES
variants = build_variants
sizes.each_with_object({}) do |size, manifest|
manifest[size] = variants.map do |variant|
extension = size == 'detail' ? 'png' : 'jpg'
"#{variant}.#{extension}"
end
end
end
def build_variants
variants = ["#{@character.granblue_id}_01", "#{@character.granblue_id}_02"]
variants << "#{@character.granblue_id}_03" if @character.flb
variants << "#{@character.granblue_id}_04" if @character.ulb
variants
end
def count_total_images(manifest)
manifest.values.sum(&:size)
end
end