fileboost 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fd85f01129f867dfe1627a2fd20f22ac47e873f03cdecf5973ffa1cbc0f3ff40
+  data.tar.gz: e2f625239f1e930f3d08b10f8fd67a62b882c553291e112bcd34ce0b1b92598e
+SHA512:
+  metadata.gz: c206e01371679f502dac87f79309933e38560e76eba829f01016458e6cf2588ef6167df9c737ca4caee636406795647536428e96ba8899b12a2c07f6221e57df
+  data.tar.gz: cfd0ad1902c05576a38e34d4fe5aec67ce0c1a5349f26bd044fd840ae83ba7cac7ad71d693b083b9581cc35c68a2386eec39114c0a1b05f0fb5de06ac7b7e7c4

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright bilal
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,227 @@
+# Fileboost
+
+[![Gem Version](https://badge.fury.io/rb/fileboost.svg)](https://badge.fury.io/rb/fileboost)
+
+Fileboost is a Rails gem that provides seamless integration with the Fileboost.dev image optimization service. It offers drop-in replacement helpers for Rails' native image helpers with automatic optimization, HMAC authentication, and comprehensive transformation support for ActiveStorage objects.
+
+## Features
+
+- 🚀 **Drop-in replacement** for Rails `image_tag` and `url_for` helpers
+- 🔒 **Secure HMAC authentication** with Fileboost.dev service
+- 📱 **ActiveStorage only** - works exclusively with ActiveStorage attachments
+- 🎛️ **Comprehensive transformations** - resize, quality, format conversion, and more
+- 🔧 **Simple configuration** - just project ID and token required
+
+## Installation
+
+Register an account at [Fileboost.dev](https://fileboost.dev) and obtain your project ID and token.
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "fileboost"
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+Generate the initializer:
+
+```bash
+$ rails generate fileboost:install
+```
+
+## Configuration
+
+Set your environment variables:
+
+```bash
+export FILEBOOST_PROJECT_ID="your-project-id"
+export FILEBOOST_TOKEN="your-secret-token"
+```
+
+## Usage
+
+### Basic Image Tag
+
+Replace `image_tag` with `fileboost_image_tag` for ActiveStorage objects:
+
+```erb
+<!-- Before (Rails) -->
+<%= image_tag user.avatar, width: 300, height: 300, alt: "Avatar" %>
+
+<!-- After (Fileboost) -->
+<%= fileboost_image_tag user.avatar, resize: { w: 300, h: 300 }, alt: "Avatar" %>
+```
+
+**Note:** Fileboost only works with ActiveStorage objects. String paths and external URLs are not supported.
+
+### URL Generation
+
+Generate optimized URLs directly:
+
+```erb
+<div style="background-image: url(<%= fileboost_url_for(banner.image, resize: { w: 1200, h: 400 }) %>)">
+  <!-- content -->
+</div>
+```
+
+### Transformation Options
+
+Fileboost supports comprehensive image transformations:
+
+```erb
+<%= fileboost_image_tag post.image,
+      resize: {
+        width: 800,         # Resize width
+        height: 600,        # Resize height
+        quality: 85,        # JPEG/WebP quality (1-100)
+        blur: 5,            # Blur effect (0-100)
+        brightness: 110,    # Brightness adjustment (0-200, 100 = normal)
+        contrast: 120,      # Contrast adjustment (0-200, 100 = normal)
+        rotation: 90,       # Rotation in degrees (0-359)
+        fit: :cover         # Resize behavior (cover, contain, fill, scale-down, crop, pad)
+      },
+      class: "hero-image",  # Standard Rails options work too
+      alt: "Hero image" %>
+
+<!-- Short parameter names also work -->
+<%= fileboost_image_tag post.image,
+      resize: { w: 800, h: 600, q: 85 },
+      class: "hero-image" %>
+```
+
+### Parameter Aliases
+
+Use short or long parameter names within the resize parameter:
+
+```ruby
+# These are equivalent:
+fileboost_image_tag(image, resize: { w: 400, h: 300, q: 85 })
+fileboost_image_tag(image, resize: { width: 400, height: 300, quality: 85 })
+```
+
+**Note:** Avoid using the `format` parameter. Fileboost automatically selects the optimal image format (WebP, AVIF, JPEG, etc.) based on browser headers and capabilities for the best performance and compatibility.
+
+### ActiveStorage Support
+
+Works seamlessly with all ActiveStorage attachment types:
+
+```erb
+<!-- has_one_attached -->
+<%= fileboost_image_tag user.avatar, resize: { w: 150, h: 150, fit: :cover } %>
+
+<!-- has_many_attached -->
+<% post.images.each do |image| %>
+  <%= fileboost_image_tag image, resize: { width: 400, quality: 90 } %>
+<% end %>
+
+<!-- Direct blob access -->
+<%= fileboost_image_tag post.featured_image.blob, resize: { w: 800 } %>
+```
+
+### Responsive Images
+
+Generate multiple sizes for responsive designs:
+
+```ruby
+# In your controller or helper
+@responsive_urls = fileboost_responsive_urls(hero.image, [
+  { width: 400, suffix: "sm" },
+  { width: 800, suffix: "md" },
+  { width: 1200, suffix: "lg" }
+], resize: { quality: 85 })
+
+# Returns: { "sm" => "url1", "md" => "url2", "lg" => "url3" }
+```
+
+```erb
+<!-- In your view -->
+<img src="<%= @responsive_urls['md'] %>"
+     srcset="<%= @responsive_urls['sm'] %> 400w,
+             <%= @responsive_urls['md'] %> 800w,
+             <%= @responsive_urls['lg'] %> 1200w"
+     sizes="(max-width: 400px) 400px, (max-width: 800px) 800px, 1200px"
+     alt="Responsive image">
+```
+
+## Error Handling
+
+Fileboost handles errors gracefully:
+
+- **Configuration errors**: Logs warnings about missing configuration and returns empty strings/nil
+- **Invalid assets**: Logs errors when non-ActiveStorage objects are passed and returns empty strings/nil
+- **Signature errors**: Returns nil when HMAC generation fails
+
+## Security
+
+Fileboost uses HMAC-SHA256 signatures to secure your image transformations:
+
+- URLs are signed with your secret token
+- Prevents unauthorized image manipulation
+- Signatures include all transformation parameters
+- Uses secure comparison to prevent timing attacks
+
+## Development
+
+After checking out the repo, run:
+
+```bash
+$ bundle install
+$ rake test
+```
+
+To test against the dummy Rails application:
+
+```bash
+$ cd test/dummy
+$ rails server
+```
+
+## Testing
+
+Run the test suite:
+
+```bash
+$ rake test
+```
+
+Run RuboCop:
+
+```bash
+$ bundle exec rubocop
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Write tests for your changes
+4. Ensure all tests pass (`rake test`)
+5. Commit your changes (`git commit -am 'Add some feature'`)
+6. Push to the branch (`git push origin my-new-feature`)
+7. Create new Pull Request
+
+## Fileboost.dev Service
+
+To use Fileboost, you'll need access to the Fileboost.dev image optimization service at `cdn.fileboost.dev`. The service:
+
+1. Receives requests at `https://cdn.fileboost.dev/{project_id}/path/to/activestorage/blob`
+2. Verifies HMAC signatures using your secret token
+3. Applies transformations based on query parameters
+4. Returns optimized images
+
+The service handles ActiveStorage blob URLs and applies image transformations on-the-fly.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Support
+
+- [GitHub Issues](https://github.com/bilalbudhani/fileboost/issues)
+- [Documentation](https://github.com/bilalbudhani/fileboost/wiki)
+- [Cloudflare Worker Setup Guide](https://github.com/bilalbudhani/fileboost-worker)

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+load "rails/tasks/statistics.rake"
+
+require "bundler/gem_tasks"

data/lib/fileboost/config.rb

@@ -0,0 +1,29 @@
+module Fileboost
+  class Config
+    attr_accessor :project_id, :token
+
+    CDN_DOMAIN = "cdn.fileboost.dev"
+    BASE_URL = "https://#{CDN_DOMAIN}"
+
+    def initialize
+      @project_id = ENV["FILEBOOST_PROJECT_ID"]
+      @token = ENV["FILEBOOST_TOKEN"]
+    end
+
+    def valid?
+      project_id.present? && token.present?
+    end
+
+    def base_url
+      BASE_URL
+    end
+  end
+
+  def self.config
+    @config ||= Config.new
+  end
+
+  def self.configure
+    yield(config) if block_given?
+  end
+end

data/lib/fileboost/engine.rb

@@ -0,0 +1,17 @@
+module Fileboost
+  class Engine < ::Rails::Engine
+    isolate_namespace Fileboost
+
+    initializer "fileboost.action_view" do
+      ActiveSupport.on_load :action_view do
+        include Fileboost::Helpers
+      end
+    end
+
+    initializer "fileboost.active_storage" do
+      ActiveSupport.on_load :active_storage_blob do
+        # Extend ActiveStorage::Blob with fileboost-specific methods if needed
+      end
+    end
+  end
+end

data/lib/fileboost/error_handler.rb

@@ -0,0 +1,57 @@
+module Fileboost
+  class ErrorHandler
+    class << self
+      def handle_with_fallback(error_context, &block)
+        begin
+          yield
+        rescue StandardError => e
+          log_error(error_context, e)
+          
+          if Fileboost.config.fallback_to_rails
+            yield_fallback if block_given?
+          else
+            nil
+          end
+        end
+      end
+
+      def handle_gracefully(error_context, default_value = nil, &block)
+        begin
+          yield
+        rescue StandardError => e
+          log_error(error_context, e)
+          default_value
+        end
+      end
+
+      private
+
+      def log_error(context, error)
+        return unless defined?(Rails) && Rails.logger
+
+        Rails.logger.warn(
+          "[Fileboost] Error in #{context}: #{error.class}: #{error.message}"
+        )
+        
+        # Log backtrace in development for debugging
+        if Rails.env.development?
+          Rails.logger.debug(
+            "[Fileboost] Backtrace:\n#{error.backtrace.take(5).join("\n")}"
+          )
+        end
+      end
+
+      def yield_fallback
+        # This would be implemented by the calling code
+        # The pattern is to pass a fallback block when needed
+        nil
+      end
+    end
+  end
+
+  # Specific exception classes for better error handling
+  class ConfigurationError < StandardError; end
+  class SignatureGenerationError < StandardError; end
+  class UrlBuildError < StandardError; end
+  class AssetPathExtractionError < StandardError; end
+end

data/lib/fileboost/helpers.rb

@@ -0,0 +1,107 @@
+require "active_storage"
+
+module Fileboost
+  module Helpers
+    # Generate an optimized image tag using Fileboost
+    #
+    # @param asset [ActiveStorage::Blob, ActiveStorage::Attached, ActiveStorage::VariantWithRecord] The ActiveStorage image asset
+    # @param options [Hash] Image transformation and HTML options
+    # @return [String] HTML image tag
+    #
+    # Examples:
+    #   fileboost_image_tag(user.avatar, resize: { w: 300, h: 200 }, alt: "Avatar")
+    #   fileboost_image_tag(post.featured_image.blob, resize: { width: 1200, quality: 90 }, class: "hero-image")
+    def fileboost_image_tag(asset, **options)
+      # Extract resize options for transformation
+      resize_options = options.delete(:resize) || {}
+
+      # Generate the optimized URL
+      optimized_url = fileboost_url_for(asset, resize: resize_options)
+
+      # Return empty string if no URL could be generated
+      return "" if optimized_url.blank?
+
+      # Use the optimized URL with Rails image_tag for consistency
+      image_tag(optimized_url, **options)
+    end
+
+    # Generate an optimized URL using Fileboost
+    #
+    # @param asset [ActiveStorage::Blob, ActiveStorage::Attached, ActiveStorage::VariantWithRecord] The ActiveStorage image asset
+    # @param options [Hash] Image transformation options
+    # @return [String, nil] The optimized URL or nil if generation failed
+    #
+    # Examples:
+    #   fileboost_url_for(post.image, resize: { width: 500, format: :webp })
+    #   fileboost_url_for(user.avatar.blob, resize: { w: 1200, h: 400, q: 85 })
+    def fileboost_url_for(asset, **options)
+      # Validate that asset is an ActiveStorage object
+      unless valid_activestorage_asset?(asset)
+        Rails.logger.error("[Fileboost] Invalid asset type #{asset.class}. Only ActiveStorage objects are supported.") if defined?(Rails)
+        return nil
+      end
+
+      # Validate configuration
+      unless Fileboost.config.valid?
+        log_configuration_warning
+        return nil
+      end
+
+      # Build the optimized URL
+      Fileboost::UrlBuilder.build_url(asset, **options)
+    end
+
+    # Generate multiple image URLs for responsive images
+    #
+    # @param asset [ActiveStorage::Blob, ActiveStorage::Attached, ActiveStorage::VariantWithRecord] The ActiveStorage image asset
+    # @param sizes [Array<Hash>] Array of size configurations
+    # @param base_options [Hash] Base transformation options applied to all sizes
+    # @return [Hash] Hash with size keys and URL values
+    #
+    # Example:
+    #   fileboost_responsive_urls(hero.image, [
+    #     { width: 400, suffix: "sm" },
+    #     { width: 800, suffix: "md" },
+    #     { width: 1200, suffix: "lg" }
+    #   ], resize: { quality: 85, format: :webp })
+    #   # Returns: { "sm" => "url1", "md" => "url2", "lg" => "url3" }
+    def fileboost_responsive_urls(asset, sizes, **base_options)
+      urls = {}
+
+      sizes.each do |size_config|
+        suffix = size_config[:suffix] || size_config["suffix"]
+        size_options = size_config.except(:suffix, "suffix")
+        combined_options = base_options.merge(size_options)
+
+        url = fileboost_url_for(asset, **combined_options)
+        urls[suffix] = url if url.present?
+      end
+
+      urls
+    end
+
+    private
+
+
+    # Validate that the asset is a supported ActiveStorage object
+    def valid_activestorage_asset?(asset)
+      return true if asset.is_a?(ActiveStorage::Blob)
+      return true if asset.is_a?(ActiveStorage::Attached)
+      return true if asset.is_a?(ActiveStorage::VariantWithRecord)
+
+      false
+    end
+
+    # Log configuration warnings
+    def log_configuration_warning
+      missing_configs = []
+      missing_configs << "project_id" if Fileboost.config.project_id.blank?
+      missing_configs << "token" if Fileboost.config.token.blank?
+
+      Rails.logger.warn(
+        "[Fileboost] Configuration incomplete. Missing: #{missing_configs.join(', ')}. " \
+        "Set FILEBOOST_PROJECT_ID and FILEBOOST_TOKEN environment variables or configure them in your initializer."
+      ) if defined?(Rails)
+    end
+  end
+end

data/lib/fileboost/signature_generator.rb

@@ -0,0 +1,44 @@
+require "openssl"
+require "base64"
+
+module Fileboost
+  class SignatureGenerator
+    def self.generate(project_id:, asset_path:, params: {})
+      return nil unless project_id.present? && asset_path.present? && Fileboost.config.token.present?
+
+      # Sort parameters for consistent signature generation
+      sorted_params = params.sort.to_h
+      query_string = sorted_params.map { |k, v| "#{k}=#{v}" }.join("&")
+
+      # Create the signing string: project_id:asset_path:sorted_query_params
+      signing_string = [project_id, asset_path, query_string].join(":")
+      Rails.logger.debug("signature payload #{project_id}, #{asset_path}, #{query_string}, #{Fileboost.config.token}")
+      # Generate HMAC-SHA256 signature for secure authentication with Fileboost.dev
+      digest = OpenSSL::HMAC.digest("SHA256", Fileboost.config.token, signing_string)
+      # Use URL-safe base64 encoding and remove padding for maximum URL compatibility
+      Base64.urlsafe_encode64(digest, padding: false)
+    rescue StandardError => e
+      if defined?(Rails) && Rails.env.development?
+        raise e
+      else
+        Rails.logger.warn("[Fileboost] Failed to generate signature: #{e.message}") if defined?(Rails)
+        nil
+      end
+    end
+
+    def self.verify_signature(project_id:, asset_path:, params: {}, signature:)
+      expected_signature = generate(project_id: project_id, asset_path: asset_path, params: params)
+      return false if expected_signature.nil? || signature.nil?
+
+      # Use secure comparison to prevent timing attacks
+      ActiveSupport::SecurityUtils.secure_compare(signature, expected_signature)
+    rescue StandardError => e
+      if defined?(Rails) && Rails.env.development?
+        raise e
+      else
+        Rails.logger.warn("[Fileboost] Failed to verify signature: #{e.message}") if defined?(Rails)
+        false
+      end
+    end
+  end
+end

data/lib/fileboost/url_builder.rb

@@ -0,0 +1,155 @@
+require "uri"
+
+module Fileboost
+  class UrlBuilder
+    # Supported transformation parameters for Fileboost.dev service
+    TRANSFORMATION_PARAMS = %w[
+      w width
+      h height
+      q quality
+      f format
+      b blur
+      br brightness
+      c contrast
+      r rotation
+      fit
+    ].freeze
+
+    # Parameter aliases for convenience
+    PARAM_ALIASES = {
+      "width" => "w",
+      "height" => "h",
+      "quality" => "q",
+      "format" => "f",
+      "blur" => "b",
+      "brightness" => "br",
+      "contrast" => "c",
+      "rotation" => "r"
+    }.freeze
+
+    # Valid resize parameter keys
+    RESIZE_PARAMS = %w[w width h height q quality f format b blur br brightness c contrast r rotation fit].freeze
+
+    def self.build_url(asset, **options)
+      return nil unless Fileboost.config.valid?
+      
+      asset_path = extract_asset_path(asset)
+      return nil unless asset_path.present?
+
+      project_id = Fileboost.config.project_id
+      base_url = Fileboost.config.base_url
+      
+      # Build the full asset URL path for Fileboost.dev service
+      full_path = "/#{project_id}#{asset_path}"
+      
+      # Extract and normalize transformation parameters
+      transformation_params = extract_transformation_params(options)
+      
+      # Generate HMAC signature for secure authentication
+      signature = Fileboost::SignatureGenerator.generate(
+        project_id: project_id,
+        asset_path: asset_path,
+        params: transformation_params
+      )
+      
+      return nil unless signature
+      
+      # Add signature to parameters
+      all_params = transformation_params.merge("sig" => signature)
+      
+      # Build final URL
+      uri = URI.join(base_url, full_path)
+      uri.query = URI.encode_www_form(all_params) unless all_params.empty?
+      
+      uri.to_s
+    rescue StandardError => e
+      if defined?(Rails) && Rails.env.development?
+        raise e
+      else
+        Rails.logger.warn("[Fileboost] Failed to build URL: #{e.message}") if defined?(Rails)
+        nil
+      end
+    end
+
+    private
+
+    def self.extract_asset_path(asset)
+      case asset
+      when ActiveStorage::Blob
+        # ActiveStorage Blob
+        Rails.application.routes.url_helpers.rails_blob_path(asset, only_path: true)
+        
+      when ActiveStorage::Attached
+        # ActiveStorage Attachment (has_one_attached, has_many_attached)
+        if asset.respond_to?(:blob) && asset.blob.present?
+          Rails.application.routes.url_helpers.rails_blob_path(asset.blob, only_path: true)
+        else
+          Rails.logger.warn("[Fileboost] ActiveStorage attachment has no blob") if defined?(Rails)
+          nil
+        end
+        
+      when ActiveStorage::VariantWithRecord
+        # ActiveStorage Variant - use blob URL to avoid triggering variant generation
+        Rails.application.routes.url_helpers.rails_blob_path(asset.blob, only_path: true)
+        
+      else
+        # Only ActiveStorage objects are supported
+        Rails.logger.warn("[Fileboost] Unsupported asset type: #{asset.class}. Only ActiveStorage objects are supported.") if defined?(Rails)
+        nil
+      end
+    rescue StandardError => e
+      if defined?(Rails) && Rails.env.development?
+        raise e
+      else
+        Rails.logger.warn("[Fileboost] Failed to extract asset path: #{e.message}") if defined?(Rails)
+        nil
+      end
+    end
+
+    def self.extract_transformation_params(options)
+      params = {}
+      
+      # Only handle nested resize parameter
+      if options[:resize].is_a?(Hash)
+        resize_options = options[:resize]
+        resize_options.each do |key, value|
+          key_str = key.to_s
+          
+          # Only process valid resize parameters
+          next unless RESIZE_PARAMS.include?(key_str)
+          
+          # Use alias if available
+          param_key = PARAM_ALIASES[key_str] || key_str
+          
+          # Convert value to string and validate
+          param_value = normalize_param_value(param_key, value)
+          next if param_value.blank?
+          
+          params[param_key] = param_value
+        end
+      end
+      
+      params
+    end
+
+    def self.normalize_param_value(key, value)
+      case key
+      when "w", "h", "q", "b", "br", "c", "r"
+        # Numeric parameters
+        value.to_i.to_s if value.to_i > 0
+      when "f"
+        # Format parameter - validate against common formats
+        valid_formats = %w[webp jpeg jpg png gif avif]
+        normalized = value.to_s.downcase
+        valid_formats.include?(normalized) ? normalized : nil
+      when "fit"
+        # Fit parameter - validate against supported values
+        valid_fits = %w[cover contain fill scale-down crop pad]
+        normalized = value.to_s.downcase.gsub("_", "-")
+        valid_fits.include?(normalized) ? normalized : nil
+      else
+        value.to_s
+      end
+    end
+  end
+end

data/lib/fileboost/version.rb

@@ -0,0 +1,3 @@
+module Fileboost
+  VERSION = "0.1.0"
+end

data/lib/fileboost.rb

@@ -0,0 +1,12 @@
+require "fileboost/version"
+require "fileboost/config"
+require "fileboost/error_handler"
+require "fileboost/signature_generator"
+require "fileboost/url_builder"
+require "fileboost/helpers"
+require "fileboost/engine"
+
+module Fileboost
+  # Fileboost provides seamless integration with the Fileboost.dev
+  # image optimization service for Rails applications
+end

data/lib/generators/fileboost/install_generator.rb

@@ -0,0 +1,27 @@
+require "rails/generators/base"
+
+module Fileboost
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      desc "Create Fileboost initializer file"
+      
+      def self.source_root
+        @source_root ||= File.expand_path("templates", __dir__)
+      end
+
+      def create_initializer_file
+        template "fileboost.rb", "config/initializers/fileboost.rb"
+      end
+
+      def show_readme
+        readme "INSTALL" if behavior == :invoke
+      end
+
+      private
+
+      def readme(path)
+        say File.read(File.join(self.class.source_root, "#{path}.md"))
+      end
+    end
+  end
+end

data/lib/generators/fileboost/templates/INSTALL.md

@@ -0,0 +1,41 @@
+===============================================================================
+
+                      ⚡ Fileboost Installation Complete!
+
+===============================================================================
+
+The Fileboost initializer has been created at:
+config/initializers/fileboost.rb
+
+Next steps:
+
+1. Set your environment variables:
+   export FILEBOOST_PROJECT_ID="your-project-id"
+   export FILEBOOST_TOKEN="your-secret-token"
+
+2. Or configure directly in the initializer file:
+   Edit config/initializers/fileboost.rb with your credentials
+
+3. Start using Fileboost helpers in your views:
+
+   <!-- Replace image_tag with fileboost_image_tag -->
+
+   <%= fileboost_image_tag user.avatar, alt: "Avatar", resize: {width: 100, height: 100, fit: "cover"} %>
+
+   <!-- Generate optimized URLs -->
+
+   <%= fileboost_url_for post.image %>
+
+4. Supported transformation options:
+   - width, height (or w, h)
+   - quality (or q): 1-100
+   - format (or f): webp, jpeg, png, gif, avif
+   - blur (or b): 0-100
+   - brightness (or br): 0-200
+   - contrast (or c): 0-200
+   - rotation (or r): 0-359
+   - fit: cover, contain, fill, scale-down, crop, pad
+
+For more information, visit: https://fileboost.dev
+
+===============================================================================

data/lib/generators/fileboost/templates/fileboost.rb

@@ -0,0 +1,19 @@
+# Fileboost Configuration
+#
+# Configure your Fileboost integration for seamless image optimization
+# through the Fileboost.dev service. Set up your environment variables or
+# configure the values directly below.
+#
+# Fileboost uses cdn.fileboost.dev as the CDN domain and only supports
+# ActiveStorage objects.
+
+Fileboost.configure do |config|
+  # Your unique Fileboost project identifier
+  # You can also set this via the FILEBOOST_PROJECT_ID environment variable
+  config.project_id = ENV["FILEBOOST_PROJECT_ID"] # || "your-project-id"
+
+  # HMAC signing secret for secure authentication with Fileboost.dev service
+  # You can also set this via the FILEBOOST_TOKEN environment variable
+  # IMPORTANT: Keep this secret secure and never commit it to version control
+  config.token = ENV["FILEBOOST_TOKEN"] # || "your-secret-token"
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: fileboost
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- bilal
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activestorage
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: combustion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 8.0.0
+description: Fileboost provides drop-in replacement Rails image helpers with automatic
+  optimization through the Fileboost.dev service. Works exclusively with ActiveStorage
+  objects, features HMAC authentication, and comprehensive transformation support.
+email:
+- bilal@bilalbudhani.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/fileboost.rb
+- lib/fileboost/config.rb
+- lib/fileboost/engine.rb
+- lib/fileboost/error_handler.rb
+- lib/fileboost/helpers.rb
+- lib/fileboost/signature_generator.rb
+- lib/fileboost/url_builder.rb
+- lib/fileboost/version.rb
+- lib/generators/fileboost/install_generator.rb
+- lib/generators/fileboost/templates/INSTALL.md
+- lib/generators/fileboost/templates/fileboost.rb
+homepage: https://github.com/bilalbudhani/fileboost-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/bilalbudhani/fileboost-ruby
+  source_code_uri: https://github.com/bilalbudhani/fileboost-ruby
+  changelog_uri: https://github.com/bilalbudhani/fileboost-ruby/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Rails gem for Fileboost.dev image optimization with ActiveStorage
+test_files: []