fileboost 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 820b61fe3e68521f6aa18ff54604405a16591022e6bf51e3c05676ee702b68bd
-  data.tar.gz: cb24ea71429294b6f8ef8e9a5e33019ee147888ff559b6a4e031fe6d1f39a167
+  metadata.gz: 75a25ae54b0e37c76e53aac050c9ecec3349ae68177ba50627d0e28ba447864b
+  data.tar.gz: 5bbbec4d29a49c78c5b4c4ab322f7b3598a26ca7845af7a51bbfb2da83066335
 SHA512:
-  metadata.gz: 31156ad54e654a70966a6cab9b4b80dd0f274eb2949f69b86dd7a4f1a30aaf1649cb4a3de52cf8dbff82ec22ff177df2cdea38fe53b620533af3225a47079170
-  data.tar.gz: 90942c719df9ea0b565bcce52349ff29b9dfb46b2de6ac965edc736d0a787dab96926fb3a24110724c6c834daae68276e4ef4dea9e46cfd11681d6f7c2d63056
+  metadata.gz: fe2d690a0f1978dba962020123532bb619e3bec66818b5afc08682006bc9d43c91ea478766060df3c022ed24f17b5f6c92d0eb72991f9c393e559568bd25d4e3
+  data.tar.gz: 99c983aaebabdbdfa70b5c6c3316b64c1eb6e5e1d3fa92bf3282cb8a4dc27d1ae045ff4781373de7ca3ef4556bf7ed12ff978b915db5b0e7c1599af4f7c9dfd7

data/README.md

@@ -42,7 +42,7 @@ Fileboost is a Rails gem that provides seamless integration with the Fileboost.d
 ## Requirements
 
 - Ruby 3.0+
-- Rails 7.1+
+- Rails 7+
 - ActiveStorage
 
 ## Installation
@@ -83,7 +83,7 @@ Or configure directly in your initializer:
 Fileboost.configure do |config|
   config.project_id = ENV["FILEBOOST_PROJECT_ID"]
   config.token = ENV["FILEBOOST_TOKEN"]
-  
+
   # Optional: Enable drop-in replacement for Rails image_tag (default: false)
   config.patch_image_tag = true
 end
@@ -93,7 +93,7 @@ end
 
 ### Drop-in Replacement (Recommended)
 
-Enable `patch_image_tag` in your configuration to automatically optimize ActiveStorage images with your existing `image_tag` calls:
+> Enable `patch_image_tag` in your configuration to automatically optimize ActiveStorage images with your existing `image_tag` calls:
 
 ```ruby
 # config/initializers/fileboost.rb
@@ -121,6 +121,7 @@ With this enabled, your existing Rails code automatically gets Fileboost optimiz
 ```
 
 **Benefits:**
+
 - Zero code changes required for existing ActiveStorage images
 - Full ActiveStorage variant support with automatic transformation mapping
 - Automatic fallback to Rails behavior for non-ActiveStorage assets
@@ -235,15 +236,14 @@ Fileboost now provides full support for ActiveStorage variants with automatic tr
 
 Fileboost automatically maps ActiveStorage variant transformations to optimized URL parameters:
 
-| ActiveStorage Variant | Fileboost Parameters | Description |
-|----------------------|---------------------|-------------|
-| `resize_to_limit: [w, h]` | `w=W&h=H&fit=scale-down` | Resize within bounds, preserving aspect ratio |
-| `resize_to_fit: [w, h]` | `w=W&h=H&fit=contain` | Resize to fit exactly, with letterboxing if needed |
-| `resize_to_fill: [w, h]` | `w=W&h=H&fit=cover` | Resize and crop to fill exactly |
-| `resize_and_pad: [w, h]` | `w=W&h=H&fit=pad` | Resize with padding |
-| `quality: 85` | `q=85` | JPEG/WebP quality (1-100) |
-| `rotate: "-90"` | `r=-90` | Rotation in degrees |
-
+| ActiveStorage Variant     | Fileboost Parameters     | Description                                        |
+| ------------------------- | ------------------------ | -------------------------------------------------- |
+| `resize_to_limit: [w, h]` | `w=W&h=H&fit=scale-down` | Resize within bounds, preserving aspect ratio      |
+| `resize_to_fit: [w, h]`   | `w=W&h=H&fit=contain`    | Resize to fit exactly, with letterboxing if needed |
+| `resize_to_fill: [w, h]`  | `w=W&h=H&fit=cover`      | Resize and crop to fill exactly                    |
+| `resize_and_pad: [w, h]`  | `w=W&h=H&fit=pad`        | Resize with padding                                |
+| `quality: 85`             | `q=85`                   | JPEG/WebP quality (1-100)                          |
+| `rotate: "-90"`           | `r=-90`                  | Rotation in degrees                                |
 
 #### Combining Variants with Custom Options
 
@@ -251,13 +251,13 @@ You can combine variant transformations with additional Fileboost options:
 
 ```erb
 <!-- Variant transformations + additional options -->
-<%= image_tag user.avatar.variant(resize_to_limit: [200, 200]), 
+<%= image_tag user.avatar.variant(resize_to_limit: [200, 200]),
     resize: { blur: 5, brightness: 110 } %>
 <!-- ↓ Combines variant params with additional blur and brightness -->
 
 <!-- Override variant parameters -->
 <%= image_tag post.image.variant(resize_to_limit: [400, 300]),
-    resize: { w: 500 } %>  
+    resize: { w: 500 } %>
 <!-- ↓ Uses h=300&fit=scale-down from variant, but overrides width to 500 -->
 ```
 

data/lib/fileboost/helpers.rb

@@ -5,7 +5,7 @@ module Fileboost
     # 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
+    # @param options [Hash] Accepts a `:resize` hash for transformations plus standard HTML options
     # @return [String] HTML image tag
     #
     # Examples:
@@ -25,7 +25,7 @@ module Fileboost
     # Generate an optimized URL using Fileboost
     #
     # @param asset [ActiveStorage::Blob, ActiveStorage::Attached, ActiveStorage::VariantWithRecord] The ActiveStorage image asset
-    # @param options [Hash] Image transformation options
+    # @param options [Hash] Supports a `:resize` hash for image transformations and an optional `:disposition`
     # @return [String, nil] The optimized URL or nil if generation failed
     #
     # Examples:

data/lib/fileboost/url_builder.rb

@@ -45,7 +45,10 @@ module Fileboost
       # Extract and normalize transformation parameters
       transformation_params = extract_transformation_params(asset, options)
 
-      # Generate HMAC signature for secure authentication
+      # Separate disposition from transformation params for signature generation
+      disposition = transformation_params.delete("disposition")
+
+      # Generate HMAC signature for secure authentication (excluding disposition)
       signature = Fileboost::SignatureGenerator.generate(
         asset_path: asset_path,
         params: transformation_params
@@ -53,8 +56,9 @@ module Fileboost
 
       raise SignatureGenerationError, "Failed to generate signature" unless signature
 
-      # Add signature to parameters
+      # Add signature and disposition back to final URL parameters
       all_params = transformation_params.merge("sig" => signature)
+      all_params["disposition"] = disposition if disposition
 
       # Build final URL
       uri = URI.join(base_url, full_path)
@@ -118,6 +122,11 @@ module Fileboost
         end
       end
 
+      disposition = options[:disposition] || options["disposition"]
+      if disposition.present?
+        params["disposition"] = disposition.to_s.strip.downcase
+      end
+
       params
     end
 

data/lib/fileboost/version.rb

@@ -1,3 +1,3 @@
 module Fileboost
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fileboost
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - bilal budhani