og_pilot_ruby 0.4.3 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e2a983c2b0ced955a1d89e715316050384d6879ec31e328b391e1b7d6e788e9
-  data.tar.gz: a2e254954c6f260f493f10e86fd19b8a7d2a64781f9a970ad730bd51fc411962
+  metadata.gz: 367bb4f8ea0c4a82c261f4403a42ae5bbf2afa25069bad87250c884ca343526b
+  data.tar.gz: 753f95ace14cc5d6b1895a286174810457837ba9e7b0fdb2dcb646bfa9f8ea78
 SHA512:
-  metadata.gz: 8fe9e289d37a64f41c9d578aba09477ce5e0fa9ea29a422ded261b9ab01b45c02cb7aff88581ed446bd2e5aafeb94c9f49b5762e374bfe6b63d6063985ec462b
-  data.tar.gz: 96d7f35d05dae228f048bae8e7ee55a046fc4480f2546b5153c3bf72763ccd7116efa41d59c6b9f71b9d651cd0d17aca71636dfaba6a62123d8a71a2c8257ef3
+  metadata.gz: ec298c3d0d781c259aece2d385f1f53a0e26633295b0bc8b1624ab85123a6cb5840a0b4f81a4e303940c425b618d270b8f504e19cb7654466046c11dbbda666b
+  data.tar.gz: 29008c57e899486428e21c2395e0f3cdfc2010d1bc533cd93102e0ba17a41cabc96c94295bf4b3a46247ebe8a6ff5e183a7981e6c8d540406cbea3e22e29eb9f

data/README.md

@@ -29,6 +29,8 @@ 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.cache_store = Rails.cache
+  # config.cache_ttl = 86_400
 end
 ```
 
@@ -61,6 +63,12 @@ image_url = OgPilotRuby.create_image(
 If you omit `iat`, OG Pilot will cache the image indefinitely. Provide an `iat` to
 refresh the cache daily.
 
+When `config.cache_store` is set, the client can also cache generated responses
+locally:
+
+- With `iat`: cache for `cache_ttl` seconds
+- Without `iat`: cache for `7 * cache_ttl` seconds
+
 ### Fail-safe behavior
 
 `create_image` is non-blocking. If any error occurs (request, configuration,
@@ -558,6 +566,8 @@ The gem handles `iss` (domain) and `sub` (API key prefix) automatically.
 | `open_timeout`     | `5`                     | Connection timeout in seconds                                            |
 | `read_timeout`     | `10`                    | Read timeout in seconds                                                  |
 | `strip_extensions` | `true`                  | When `true`, file extensions are stripped from resolved paths (see [Strip extensions](#strip-extensions)) |
+| `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                       |
 
 ### Ruby options
 
@@ -624,6 +634,26 @@ payload = {
 data = OgPilotRuby.create_image(**payload, json: true)
 ```
 
+### Local caching
+
+You can optionally enable client-side caching to avoid repeated API calls for
+identical payloads:
+
+```ruby
+OgPilotRuby.configure do |config|
+  config.cache_store = Rails.cache
+  config.cache_ttl = 86_400 # 1 day
+end
+```
+
+Cache key inputs include the normalized payload, `iat`, output mode (`json`
+vs URL), and configured domain.
+
+TTL behavior:
+
+- If `iat` is present: cached for `cache_ttl`
+- If `iat` is omitted: cached for `7 * cache_ttl`
+
 ### Strip extensions
 
 When `strip_extensions` is enabled, the client removes file extensions from the

data/lib/og_pilot_ruby/client.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "digest"
 require "json"
 require "logger"
 require "net/http"
@@ -25,14 +26,24 @@ module OgPilotRuby
       params.delete("path") if params.key?("path")
       params[:path] = manual_path.to_s.strip.empty? ? resolved_path(default:) : normalize_path(manual_path)
 
+      cache_key = cache_key_for(params, iat:, json:)
+      if config.cache_store && cache_key
+        cached = read_cached(cache_key)
+        return cached if cached
+      end
+
       uri = build_uri(params, iat:)
       response, final_uri = request(uri, json:, headers:)
 
-      if json
+      result = if json
         JSON.parse(response.body)
       else
         response["Location"] || final_uri.to_s
       end
+
+      write_cached(cache_key, result, iat:) if config.cache_store && cache_key && result
+
+      result
     rescue StandardError => e
       log_create_image_failure(e, json:)
       json ? { "image_url" => nil } : nil
@@ -42,6 +53,25 @@ module OgPilotRuby
 
       attr_reader :config
 
+      def cache_key_for(params, iat:, json:)
+        key_data = params.transform_keys(&:to_sym).merge(iat: iat, json: json, domain: domain!)
+        normalized = key_data.sort_by { |k, _| k.to_s }.to_h
+        "og_pilot:#{Digest::SHA256.hexdigest(normalized.to_json)[0, 16]}"
+      end
+
+      def read_cached(cache_key)
+        config.cache_store.read(cache_key)
+      rescue StandardError
+        nil
+      end
+
+      def write_cached(cache_key, result, iat:)
+        ttl = iat ? config.cache_ttl : (7 * config.cache_ttl)
+        config.cache_store.write(cache_key, result, expires_in: ttl)
+      rescue StandardError
+        nil
+      end
+
       def log_create_image_failure(error, json:)
         mode = json ? "json" : "url"
         message = "OgPilotRuby create_image failed (mode=#{mode}): #{error.class}: #{error.message}"

data/lib/og_pilot_ruby/configuration.rb

@@ -5,7 +5,7 @@ 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
+    attr_accessor :api_key, :domain, :base_url, :open_timeout, :read_timeout, :strip_extensions, :cache_store, :cache_ttl
 
     def initialize
       @api_key = ENV.fetch("OG_PILOT_API_KEY", nil)
@@ -14,6 +14,8 @@ module OgPilotRuby
       @open_timeout = 5
       @read_timeout = 10
       @strip_extensions = true
+      @cache_store = nil
+      @cache_ttl = 86400
     end
   end
 end

data/lib/og_pilot_ruby/version.rb

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

metadata

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