graphiti 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1153a7480fa50066880ae8fd1b5a4f99a24e69ae3ebffb40ae114dbfcffc9910
-  data.tar.gz: 0f3836b75fb3db4a88393d1ec7877340dedea40e9c59350a8e30f1f4ebce10f1
+  metadata.gz: ad1f5708fdf6d0ce3e322a050c23440765c7d965be7020e1c1fa1a4a8205ee85
+  data.tar.gz: b80f90e0cc2421b89ef4ccbb142bb8ee67ccb5490eb55ace716ca22e154cc578
 SHA512:
-  metadata.gz: 7e62b853539691e1649da7ff41441f75e5726af05ee88de6d0721b909926733162c07eeb82763dfc0bbc19ea953026ebd5ab2acf03e11313a7d584894dc89263
-  data.tar.gz: 046642e0a06b2340054d501ace62e56c42cb1ab66c3f1939c05fc59b9b14107109276848e2204eb4b6b18378ab3c4ba18ca45cd8025e54036e413f7079943068
+  metadata.gz: 9f2a223141a825552d578c2b3720a2157337e48ff7a4c3bb55b09eb3dac0093f65903c20b048893b8ab61ea47cc21c61c41a25ae59aa2163efe08c721e5dd5b8
+  data.tar.gz: 4bb15d52b3749de416d8c90cf6e9964614412346ed25e9504135da48b187d5212aa6c79931e8c4ff1691cc83bea439f12d3d2813736c23bc80afbb9c8082ee6c

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 graphiti changelog
 
+# [1.10.0](https://github.com/graphiti-api/graphiti/compare/v1.9.0...v1.10.0) (2026-01-06)
+
+
+### Features
+
+* add cache tag support to allow context-aware caching ([#498](https://github.com/graphiti-api/graphiti/issues/498)) ([e8c2bad](https://github.com/graphiti-api/graphiti/commit/e8c2bad478cb3dd8dbd1a5e993b10f84046a0fa8))
+
 # [1.9.0](https://github.com/graphiti-api/graphiti/compare/v1.8.2...v1.9.0) (2026-01-03)
 
 

data/lib/graphiti/resource/interface.rb

@@ -4,9 +4,10 @@ module Graphiti
       extend ActiveSupport::Concern
 
       class_methods do
-        def cache_resource(expires_in: false)
+        def cache_resource(expires_in: false, tag: nil)
           @cache_resource = true
           @cache_expires_in = expires_in
+          @cache_tag = tag
         end
 
         def all(params = {}, base_scope = nil)
@@ -55,7 +56,7 @@ module Graphiti
         private
 
         def caching_options
-          {cache: @cache_resource, cache_expires_in: @cache_expires_in}
+          {cache: @cache_resource, cache_expires_in: @cache_expires_in, cache_tag: @cache_tag}
         end
 
         def validate_request!(params)

data/lib/graphiti/resource_proxy.rb

@@ -2,14 +2,19 @@ module Graphiti
   class ResourceProxy
     include Enumerable
 
-    attr_reader :resource, :query, :scope, :payload, :cache_expires_in, :cache
+    attr_reader :resource, :query, :scope, :payload, :cache_expires_in, :cache, :cache_tag
 
-    def initialize(resource, scope, query,
+    def initialize(
+      resource,
+      scope,
+      query,
       payload: nil,
       single: false,
       raise_on_missing: false,
       cache: nil,
-      cache_expires_in: nil)
+      cache_expires_in: nil,
+      cache_tag: nil
+    )
 
       @resource = resource
       @scope = scope
@@ -19,6 +24,7 @@ module Graphiti
       @raise_on_missing = raise_on_missing
       @cache = cache
       @cache_expires_in = cache_expires_in
+      @cache_tag = cache_tag
     end
 
     def cache?
@@ -207,12 +213,30 @@ module Graphiti
       "W/#{ActiveSupport::Digest.hexdigest(cache_key_with_version.to_s)}"
     end
 
+    def resource_cache_tag
+      return unless @cache_tag.present? && @resource.respond_to?(@cache_tag)
+
+      @resource.try(@cache_tag)
+    end
+
     def cache_key
-      ActiveSupport::Cache.expand_cache_key([@scope.cache_key, @query.cache_key])
+      ActiveSupport::Cache.expand_cache_key(
+        [
+          @scope.cache_key,
+          @query.cache_key,
+          resource_cache_tag
+        ].compact_blank
+      )
     end
 
     def cache_key_with_version
-      ActiveSupport::Cache.expand_cache_key([@scope.cache_key_with_version, @query.cache_key])
+      ActiveSupport::Cache.expand_cache_key(
+        [
+          @scope.cache_key_with_version,
+          @query.cache_key,
+          resource_cache_tag
+        ].compact_blank
+      )
     end
 
     private

data/lib/graphiti/runner.rb

@@ -58,22 +58,29 @@ module Graphiti
 
     def proxy(base = nil, opts = {})
       base ||= jsonapi_resource.base_scope
-      scope_opts = opts.slice :sideload_parent_length,
+      scope_opts = opts.slice(
+        :sideload_parent_length,
         :default_paginate,
         :after_resolve,
         :sideload,
         :parent,
         :params,
         :bypass_required_filters
+      )
+
       scope = jsonapi_scope(base, scope_opts)
-      ResourceProxy.new jsonapi_resource,
+
+      ::Graphiti::ResourceProxy.new(
+        jsonapi_resource,
         scope,
         query,
         payload: deserialized_payload,
         single: opts[:single],
         raise_on_missing: opts[:raise_on_missing],
         cache: opts[:cache],
-        cache_expires_in: opts[:cache_expires_in]
+        cache_expires_in: opts[:cache_expires_in],
+        cache_tag: opts[:cache_tag]
+      )
     end
   end
 end

data/lib/graphiti/util/cache_debug.rb

@@ -12,7 +12,9 @@ module Graphiti
       end
 
       def name
-        "#{Graphiti.context[:object]&.request&.method} #{Graphiti.context[:object]&.request&.url}"
+        tag = proxy.resource_cache_tag
+
+        "#{::Graphiti.context[:object]&.request&.method} #{::Graphiti.context[:object]&.request&.url} #{tag}"
       end
 
       def key

data/lib/graphiti/version.rb

@@ -1,3 +1,3 @@
 module Graphiti
-  VERSION = "1.9.0"
+  VERSION = "1.10.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: graphiti
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Lee Richmond
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-03 00:00:00.000000000 Z
+date: 2026-01-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jsonapi-serializable