legion-cache 1.3.17 → 1.3.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2d0de0aa53a2886b16a2d2e10bb18e37128a0e0d50d118d689c8f87aa15fcb72
-  data.tar.gz: 49387e7f795a779e595b700c2afe8eda19b7bc0e07273306ae57ca9ec71b2782
+  metadata.gz: aded92a74b60ff3cae8cab7d33d38f147bf17ac308dfd78695b2e6e2ed70298e
+  data.tar.gz: 244c88d6428745bd91d949dc7738cf65392e644d2143b3c092ab9b84fc610cd2
 SHA512:
-  metadata.gz: af05e3b8f771a81307f9c3fb81c6dcb6a9fad154bd127660d71a9e645c44636fb1317ef70db618fa5e139fb617d012747bb477017226b829cc5d26ff3db6cd5a
-  data.tar.gz: 0e31e8c387e44ff1c8e4089cabd04536df39e373cbc38bc90dc1beba85b080d92d77887ee1f4faccf4ef96bb0a02bc51d43bdebda53231e627d26f57e014775f
+  metadata.gz: d6b790d262f8d9735c7d3a31a5222b449408deb00126f5184b8404fafbfa95a30a2eb3826a1cff5c0a44420fe0510399ff47c002ec816b65f596079977d00e4b
+  data.tar.gz: 774eb4fd9532934894e4d38ab52cba094e5fbab03c33eeb12f9aae0a244efebfddf3eea454a97445598143de680e2eac01ddd6b4f256b4ce116408e398c07e50

data/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## [Unreleased]
 
+## [1.3.18] - 2026-03-29
+
+### Added
+- Layered TTL resolution in Helper (per-call → LEX override → Settings → FALLBACK_TTL)
+- `cache_default_ttl` / `local_cache_default_ttl` — LEX-overridable default TTL methods
+- `cache_exist?` / `local_cache_exist?` — key existence checks
+- `cache_connected?` / `local_cache_connected?` — connection status helpers
+- `cache_pool_size` / `cache_pool_available` — pool info (shared tier)
+- `local_cache_pool_size` / `local_cache_pool_available` — pool info (local tier)
+- `phi:` keyword argument on `cache_set` / `local_cache_set` for PHI TTL enforcement
+- `default_ttl` key in Settings.default and Settings.local (defaults to 60)
+
 ## [1.3.17] - 2026-03-25
 
 ### Added

data/CLAUDE.md

@@ -8,7 +8,7 @@
 Caching wrapper for the LegionIO framework. Provides a consistent interface for Memcached (via `dalli`) and Redis (via `redis` gem) with connection pooling. Driver selection is config-driven.
 
 **GitHub**: https://github.com/LegionIO/legion-cache
-**Version**: 1.3.12
+**Version**: 1.3.17
 **License**: Apache-2.0
 
 ## Architecture
@@ -39,6 +39,7 @@ Legion::Cache (singleton module)
 ├── Memory                  # Lite mode adapter: pure in-memory cache, TTL expiry, Mutex thread-safety
 │   └── Activated by LEGION_MODE=lite env var; no Redis/Memcached required
 ├── Helper                  # Injectable cache mixin for LEX extensions (namespaced cache_*/local_cache_*)
+├── RedisHash               # Redis-specific sorted set + hash operations (hset/hgetall/hdel/zadd/zrangebyscore/zrem/expire); Redis-only, module_function pattern
 ├── Local                   # Local cache tier (localhost Redis/Memcached, fallback target)
 │   ├── .setup              # Connect to local cache server (auto-detect driver)
 │   ├── .shutdown           # Close local connection
@@ -134,10 +135,25 @@ Dalli enforces a 1MB client-side limit by default (`value_max_bytes: 1_048_576`)
 | `lib/legion/cache/memory.rb` | Lite mode Memory adapter: in-memory store with TTL + Mutex thread-safety |
 | `lib/legion/cache/helper.rb` | Injectable cache mixin for LEX extensions |
 | `lib/legion/cache/local.rb` | Local cache tier (localhost, fallback target) |
+| `lib/legion/cache/redis_hash.rb` | Redis sorted set + hash operations (hset/hgetall/hdel/zadd/zrangebyscore/zrem/expire) |
 | `lib/legion/cache/pool.rb` | Connection pool management |
 | `lib/legion/cache/settings.rb` | Default configuration + local defaults |
 | `lib/legion/cache/version.rb` | VERSION constant |
 
+## PHI TTL Cap
+
+When `phi: true` is passed to `set`, the TTL is capped at `cache.compliance.phi_max_ttl` (default 3600s). This enforces the HIPAA PHI TTL policy in legion-logging. The `enforce_phi_ttl(ttl, phi: false)` method applies the cap; without `phi: true` the TTL is passed through unchanged.
+
+```json
+{
+  "cache": {
+    "compliance": {
+      "phi_max_ttl": 3600
+    }
+  }
+}
+```
+
 ## Role in LegionIO
 
 Optional caching layer initialized during `Legion::Service` startup. Used by `legion-data` for model caching (Sequel caching plugin) and by extensions for general-purpose caching.

data/README.md

@@ -2,7 +2,7 @@
 
 Caching wrapper for the [LegionIO](https://github.com/LegionIO/LegionIO) framework. Provides a consistent interface for Memcached (via `dalli`) and Redis (via `redis` gem) with connection pooling. Driver selection is config-driven.
 
-**Version**: 1.3.12
+**Version**: 1.3.17
 
 ## Installation
 

data/lib/legion/cache/helper.rb

@@ -3,12 +3,38 @@
 module Legion
   module Cache
     module Helper
+      FALLBACK_TTL = 60
+
+      # --- TTL Resolution ---
+      # Override in your LEX to set a custom default TTL for the extension.
+      # Resolution chain: per-call ttl: kwarg -> LEX override -> Settings -> FALLBACK_TTL
+      def cache_default_ttl
+        return FALLBACK_TTL unless defined?(Legion::Settings)
+
+        Legion::Settings.dig(:cache, :default_ttl) || FALLBACK_TTL
+      rescue StandardError
+        FALLBACK_TTL
+      end
+
+      def local_cache_default_ttl
+        return cache_default_ttl unless defined?(Legion::Settings)
+
+        Legion::Settings.dig(:cache_local, :default_ttl) || cache_default_ttl
+      rescue StandardError
+        cache_default_ttl
+      end
+
+      # --- Namespace ---
+
       def cache_namespace
         @cache_namespace ||= derive_cache_namespace
       end
 
-      def cache_set(key, value, ttl: 60)
-        Legion::Cache.set(cache_namespace + key, value, ttl)
+      # --- Core Operations (shared tier) ---
+
+      def cache_set(key, value, ttl: nil, phi: false)
+        effective_ttl = ttl || cache_default_ttl
+        Legion::Cache.set(cache_namespace + key, value, effective_ttl, phi: phi)
       end
 
       def cache_get(key)
@@ -19,12 +45,21 @@ module Legion
         Legion::Cache.delete(cache_namespace + key)
       end
 
-      def cache_fetch(key, ttl: 60, &)
-        Legion::Cache.fetch(cache_namespace + key, ttl, &)
+      def cache_fetch(key, ttl: nil, &)
+        effective_ttl = ttl || cache_default_ttl
+        Legion::Cache.fetch(cache_namespace + key, effective_ttl, &)
+      end
+
+      def cache_exist?(key)
+        !Legion::Cache.get(cache_namespace + key).nil?
       end
 
-      def local_cache_set(key, value, ttl: 60)
-        Legion::Cache::Local.set(cache_namespace + key, value, ttl)
+      # --- Core Operations (local tier) ---
+
+      def local_cache_set(key, value, ttl: nil, phi: false)
+        effective_ttl = ttl || local_cache_default_ttl
+        effective_ttl = Legion::Cache.enforce_phi_ttl(effective_ttl, phi: phi)
+        Legion::Cache::Local.set(cache_namespace + key, value, effective_ttl)
       end
 
       def local_cache_get(key)
@@ -35,8 +70,57 @@ module Legion
         Legion::Cache::Local.delete(cache_namespace + key)
       end
 
-      def local_cache_fetch(key, ttl: 60, &)
-        Legion::Cache::Local.fetch(cache_namespace + key, ttl, &)
+      def local_cache_fetch(key, ttl: nil, &)
+        effective_ttl = ttl || local_cache_default_ttl
+        Legion::Cache::Local.fetch(cache_namespace + key, effective_ttl, &)
+      end
+
+      def local_cache_exist?(key)
+        !Legion::Cache::Local.get(cache_namespace + key).nil?
+      end
+
+      # --- Status ---
+
+      def cache_connected?
+        Legion::Cache.connected?
+      end
+
+      def local_cache_connected?
+        Legion::Cache::Local.connected?
+      end
+
+      # --- Pool Info ---
+
+      def cache_pool_size
+        return 0 unless cache_connected?
+
+        Legion::Cache.pool_size
+      rescue StandardError
+        0
+      end
+
+      def cache_pool_available
+        return 0 unless cache_connected?
+
+        Legion::Cache.available
+      rescue StandardError
+        0
+      end
+
+      def local_cache_pool_size
+        return 0 unless local_cache_connected?
+
+        Legion::Cache::Local.pool_size
+      rescue StandardError
+        0
+      end
+
+      def local_cache_pool_available
+        return 0 unless local_cache_connected?
+
+        Legion::Cache::Local.available
+      rescue StandardError
+        0
       end
 
       private

data/lib/legion/cache/settings.rb

@@ -25,6 +25,7 @@ module Legion
           cache_nils:         false,
           pool_size:          10,
           timeout:            5,
+          default_ttl:        60,
           serializer:         Legion::JSON,
           cluster:            nil,
           replica:            false,
@@ -50,6 +51,7 @@ module Legion
           cache_nils:         false,
           pool_size:          5,
           timeout:            3,
+          default_ttl:        60,
           serializer:         Legion::JSON,
           username:           nil,
           password:           nil,

data/lib/legion/cache/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Cache
-    VERSION = '1.3.17'
+    VERSION = '1.3.18'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-cache
 version: !ruby/object:Gem::Version
-  version: 1.3.17
+  version: 1.3.18
 platform: ruby
 authors:
 - Esity