og_pilot_ruby 0.4.7 → 0.4.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7378c97e45ba7c02d8f8895b53614583443c0d393d56e0c8f4267941a65012d1
-  data.tar.gz: ec37c266916a73ce5610d7a9a74137bd1771dddf9f368db910c2d8f36880a1e9
+  metadata.gz: 7337416e1651ceadf68ca9eba08b8a4a4945d62f30154391006b2dd11cd7e892
+  data.tar.gz: ebd7c609da7e75151f6f06741b82a19d244ca3953e7f563f496f7f268c3ec5cb
 SHA512:
-  metadata.gz: b12fee2e4b63b2eb78942dfa301c7fdeaa44c205dacac2e505c05720370be0ca33da85ddcad5af19d64c9accca72098bc17942bb581ecc6492e14ca06d064fa1
-  data.tar.gz: ceb27ff2523496441e15247740db9dbb446fe59aebfe242f3f81b127e033bb66b57e0f774a9e7f3d549c000c8066d3ea1f509267ce3ed9bdf2d0d10a4eb96784
+  metadata.gz: 06fcd6974ee8842cff3cb77747cb0c8a011207aecc5d0fced3f92ea049fd6109343d0bb9395fbe8798267a681b79a1d72dded42935c75e05c8e99b1d443c747f
+  data.tar.gz: 198f785e8486ebad307f5ca1f4c70d4743362e526bb9ff5978d65ad30a8878677f498f2c120317491319cf67183ffbffee0092432cfee65b359731e316e947dc

data/README.md

@@ -29,6 +29,9 @@ OgPilotRuby.configure do |config|
   config.api_key = ENV.fetch("OG_PILOT_API_KEY")
   config.domain = ENV.fetch("OG_PILOT_DOMAIN")
   # config.strip_extensions = true
+  # config.image_type = "webp"
+  # config.quality = 82
+  # config.max_bytes = 220_000
   # config.cache_store = Rails.cache
   # config.cache_ttl = 86_400
 end
@@ -63,6 +66,19 @@ image_url = OgPilotRuby.create_image(
 If you omit `iat`, OG Pilot will cache the image indefinitely. Provide an `iat` to
 refresh the cache daily.
 
+For the same delivery settings on every request, configure them once:
+
+```ruby
+OgPilotRuby.configure do |config|
+  config.image_type = "webp"
+  config.quality = 82
+  config.max_bytes = 220_000
+end
+```
+
+Per-call `image_type`, `quality`, and `max_bytes` values still override those
+defaults when you need a one-off delivery profile.
+
 When `config.cache_store` is set, the client can also cache generated responses
 locally:
 
@@ -553,6 +569,9 @@ The gem handles `iss` (domain) and `sub` (API key prefix) automatically.
 | `image_url`   | No       | —        | Hero image URL                                                |
 | `bg_color`    | No       | —        | Background color (hex format)                                 |
 | `text_color`  | No       | —        | Text color (hex format)                                       |
+| `image_type`  | No       | —        | Delivered image format: `jpeg`, `png`, `webp`, or `gif`       |
+| `quality`     | No       | —        | Delivered image quality from `1` to `100`                     |
+| `max_bytes`   | No       | —        | Maximum delivered image size in bytes                         |
 | `iat`         | No       | —        | Issued-at timestamp for daily cache busting                   |
 | `path`        | No       | auto-set | Request path for image rendering context. When provided, it overrides auto-resolution (see [Path handling](#path-handling)) |
 
@@ -567,6 +586,9 @@ The gem handles `iss` (domain) and `sub` (API key prefix) automatically.
 | `read_timeout`     | `10`                    | Read timeout in seconds                                                  |
 | `strip_extensions` | `true`                  | When `true`, file extensions are stripped from resolved paths (see [Strip extensions](#strip-extensions)) |
 | `strip_query_parameters` | `false`           | When `true`, query strings are removed from resolved paths before signing (see [Strip query parameters](#strip-query-parameters)) |
+| `image_type`       | `nil`                   | Default delivered image format: `jpeg`, `png`, `webp`, or `gif`          |
+| `quality`          | `nil`                   | Default delivered image quality from `1` to `100`                        |
+| `max_bytes`        | `nil`                   | Default maximum delivered image size in bytes                            |
 | `cache_store`      | `nil`                   | Optional cache backend with `read`/`write` (for example `Rails.cache`)  |
 | `cache_ttl`        | `86400`                 | Cache TTL in seconds when `cache_store` is enabled                       |
 

data/lib/generators/og_pilot_ruby/install/templates/initializer.rb

@@ -10,4 +10,7 @@ OgPilotRuby.configure do |config|
   # config.read_timeout = 10
   # config.strip_extensions = true
   # config.strip_query_parameters = true
+  # config.image_type = "webp"
+  # config.quality = 82
+  # config.max_bytes = 220_000
 end

data/lib/og_pilot_ruby/client.rb

@@ -20,7 +20,7 @@ module OgPilotRuby
 
     def create_image(params = {}, json: false, iat: nil, headers: {}, default: false)
       params ||= {}
-      params = params.dup
+      params = apply_configured_image_defaults(params.dup)
       # Always include a path; manual overrides win, otherwise resolve from the current request.
       manual_path = params.key?(:path) ? params[:path] : params["path"]
       params.delete("path") if params.key?("path")
@@ -178,6 +178,21 @@ module OgPilotRuby
         symbolized
       end
 
+      def apply_configured_image_defaults(params)
+        {
+          image_type: config.image_type,
+          quality: config.quality,
+          max_bytes: config.max_bytes
+        }.each do |key, value|
+          next if value.nil?
+          next if params.key?(key) || params.key?(key.to_s)
+
+          params[key] = value
+        end
+
+        params
+      end
+
       def validate_payload!(payload)
         raise OgPilotRuby::ConfigurationError, "OG Pilot domain is missing" if payload[:iss].nil? || payload[:iss].empty?
         raise OgPilotRuby::ConfigurationError, "OG Pilot API key prefix is missing" if payload[:sub].nil? || payload[:sub].empty?

data/lib/og_pilot_ruby/configuration.rb

@@ -5,7 +5,9 @@ module OgPilotRuby
     DEFAULT_BASE_URL = "https://ogpilot.com"
     private_constant :DEFAULT_BASE_URL
 
-    attr_accessor :api_key, :domain, :base_url, :open_timeout, :read_timeout, :strip_extensions, :strip_query_parameters, :cache_store, :cache_ttl
+    attr_accessor :api_key, :domain, :base_url, :open_timeout, :read_timeout,
+                  :strip_extensions, :strip_query_parameters, :image_type,
+                  :quality, :max_bytes, :cache_store, :cache_ttl
 
     def initialize
       @api_key = ENV.fetch("OG_PILOT_API_KEY", nil)
@@ -15,6 +17,9 @@ module OgPilotRuby
       @read_timeout = 10
       @strip_extensions = true
       @strip_query_parameters = false
+      @image_type = nil
+      @quality = nil
+      @max_bytes = nil
       @cache_store = nil
       @cache_ttl = 86400
     end

data/lib/og_pilot_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OgPilotRuby
-  VERSION = "0.4.7"
+  VERSION = "0.4.8"
 end

data/lib/og_pilot_ruby.rb

@@ -59,6 +59,9 @@ module OgPilotRuby
     #   image_url   - String hero image URL.
     #   bg_color    - String background color (hex format).
     #   text_color  - String text color (hex format).
+    #   image_type  - String delivered image format (jpeg/png/webp/gif).
+    #   quality     - Integer delivered image quality (1-100).
+    #   max_bytes   - Integer maximum delivered image size in bytes.
     #   path        - String request path for analytics context.
     #
     # == Request options

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: og_pilot_ruby
 version: !ruby/object:Gem::Version
-  version: 0.4.7
+  version: 0.4.8
 platform: ruby
 authors:
 - Sunergos IT LLC