graphiti 2.0.0.beta.1 → 2.0.0.beta.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a741f7953d1f54e730d2e801715f3b1d718044a4e0bd59cfd8bb3b364373e715
-  data.tar.gz: 99391699d407dfb92178cf851cce313d691ea930eb0ada81abe764b7a8310087
+  metadata.gz: 69a8294c01d96b3ca136060036e2b8592f46464a775965f6f2e42129915854bd
+  data.tar.gz: e133c0cf444718997a718e16a957b6e11d86aec78696ac2cd4bb4fe8e3b907eb
 SHA512:
-  metadata.gz: 77d02ef7c1a525c286d56677ef103f56c7ea80873f565c6db72d2208d887fac967c8f9cddc6a06f940c4a62c6d7faf58390f5331f18fd2a562aa855fff002afd
-  data.tar.gz: e4e83880da4609da20727c8e8bf7b21cddc6e7436d571218da2f874e682dfdbe03c6960799e12614716b936881a8af95ee0459d6458afcaf5f3818dae198543e
+  metadata.gz: fb38ebe38f207b016b61a960f0b39890fe4cb3aa8e8bc70a50f5f82894513c9360fe37ce02de50a7de14718d5a0f5865a50d6defe1ce15e2730409bc3324401c
+  data.tar.gz: cc5090ad354c15c4f7d5a2c9daa8aab78be9bc7b4f41c62569a5fa5edf7496dd79e2b0d86533027fd7989ed1f7295950fc325a1cf9475ae03992ddd6344a2e27

data/.ruby-version

@@ -0,0 +1 @@
+3.3

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.3.4

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 graphiti changelog
 
+# [2.0.0-beta.3](https://github.com/graphiti-api/graphiti/compare/v2.0.0-beta.2...v2.0.0-beta.3) (2026-07-31)
+
+
+### Features
+
+* carry the assigned model on the resource, not through override signatures ([8ad848d](https://github.com/graphiti-api/graphiti/commit/8ad848d9bcd24cd63efb67e8ce32d5c8f3cfe147))
+
+# [2.0.0-beta.2](https://github.com/graphiti-api/graphiti/compare/v2.0.0-beta.1...v2.0.0-beta.2) (2026-07-30)
+
+
+### Features
+
+* add Resource.wrap as an easy way to use graphiti serialization on models fetched via other means (and not via graphiti's finders) ([#513](https://github.com/graphiti-api/graphiti/issues/513)) ([fcd19e2](https://github.com/graphiti-api/graphiti/commit/fcd19e2d023091d85947dbdd89259b587e0f582b))
+* deprecate mutating attributes in around_persistence hooks ([#514](https://github.com/graphiti-api/graphiti/issues/514)) [skip ci] ([8410ab0](https://github.com/graphiti-api/graphiti/commit/8410ab0a916077601cf85d8260a05ef9098149eb))
+
 # [2.0.0-beta.1](https://github.com/graphiti-api/graphiti/compare/v1.12.2...v2.0.0-beta.1) (2026-07-30)
 
 
@@ -14,6 +29,14 @@ graphiti changelog
 * around_persistence hooks receive the assigned model instead of the attributes hash. Move attribute-hash modifications to before_attributes, or set values on the model. Custom create/update overrides that should receive a pre-assigned model must accept an assigned_model: keyword. See UPGRADING.md
 * Ruby >= 3.0 / Rails >= 6 are now required.
 
+# [1.13.0](https://github.com/graphiti-api/graphiti/compare/v1.12.2...v1.13.0) (2026-07-30)
+
+
+### Features
+
+* add Resource.wrap as an easy way to use graphiti serialization on models fetched via other means (and not via graphiti's finders) ([#513](https://github.com/graphiti-api/graphiti/issues/513)) ([fcd19e2](https://github.com/graphiti-api/graphiti/commit/fcd19e2d023091d85947dbdd89259b587e0f582b))
+* deprecate mutating attributes in around_persistence hooks ([#514](https://github.com/graphiti-api/graphiti/issues/514)) [skip ci] ([8410ab0](https://github.com/graphiti-api/graphiti/commit/8410ab0a916077601cf85d8260a05ef9098149eb))
+
 ## [1.12.2](https://github.com/graphiti-api/graphiti/compare/v1.12.1...v1.12.2) (2026-07-29)
 
 

data/UPGRADING.md

@@ -54,16 +54,6 @@ To migrate, move attribute-hash modifications to `before_attributes` (which stil
 
 `before/around/after_attributes` and `before/around/after_save` are unchanged.
 
-### Breaking: custom create/update overrides and pre-assigned models
-
-If a resource overrides `create` or `update` and callers inspect the model before saving, the override must accept the already-assigned model:
-
-```ruby
-def create(attributes, meta = nil, assigned_model: nil)
-```
-
-Without the keyword, saving a proxy whose model was inspected raises `Graphiti::Errors::AssignedModelNotSupported` rather than silently discarding changes made to the inspected instance. Overridden resources used only via plain `save` are unaffected.
-
 ### Fine print
 
 - If you inspect the model before saving, the attributes callbacks run at inspection time (in your controller, outside the save transaction). On the plain `save` path they run inside the transaction, at the same point as 1.x.

data/lib/graphiti/errors.rb

@@ -84,25 +84,6 @@ module Graphiti
       end
     end
 
-    class AssignedModelNotSupported < Base
-      def initialize(resource_class, method_name)
-        @resource_class = resource_class
-        @method_name = method_name
-      end
-
-      def message
-        <<~MSG
-          #{@resource_class}: the model was already assigned via #assign_attributes (or #data before save), but ##{@method_name} is overridden without a parameter to receive it, so changes made to the unsaved model would be silently lost.
-
-          Accept and use the assigned model in your override:
-
-            def #{@method_name}(attributes, meta = nil, assigned_model: nil)
-
-          or persist with #save alone, without inspecting the model first. See UPGRADING.md.
-        MSG
-      end
-    end
-
     class RemoteWrite < Base
       def initialize(resource_class)
         @resource_class = resource_class
@@ -486,6 +467,19 @@ module Graphiti
       end
     end
 
+    class InvalidWrapModel < Base
+      def initialize(resource_class, model)
+        @resource_class = resource_class
+        @model = model
+      end
+
+      def message
+        <<~MSG
+          #{@resource_class.name}.wrap was given a #{@model.class}, but this resource is for #{@resource_class.model} (subclasses are fine).
+        MSG
+      end
+    end
+
     class ResourceEndpointConflict < Base
       def initialize(path, action, resource_a, resource_b)
         @path = path

data/lib/graphiti/resource/interface.rb

@@ -53,8 +53,28 @@ module Graphiti
           runner.proxy(base_scope, single: true, raise_on_missing: true, assign_action: :create)
         end
 
+        # Wrap models fetched outside graphiti so they render like any other proxy
+        def wrap(models, base_scope = nil)
+          validate_wrap_models!(models)
+          runner = Runner.new(self, {}, nil, :find)
+          runner.proxy(base_scope, bypass_required_filters: true).tap do |proxy|
+            proxy.data = models
+          end
+        end
+
         private
 
+        # Skip polymorphic parents - resource_for_model raises a better error for unknown children
+        def validate_wrap_models!(models)
+          return if abstract_class? || (polymorphic? && !polymorphic_child?)
+
+          [models].flatten.compact.each do |model|
+            unless model.is_a?(self.model)
+              raise Errors::InvalidWrapModel.new(self, model)
+            end
+          end
+        end
+
         def caching_options
           {cache: @cache_resource, cache_expires_in: @cache_expires_in, cache_tag: @cache_tag}
         end

data/lib/graphiti/resource/persistence.rb

@@ -93,11 +93,23 @@ module Graphiti
         model_instance
       end
 
+      # The model built by a prior ResourceProxy#assign_attributes, present
+      # for the duration of the save that persists it
+      attr_reader :assigned_model
+
+      # @api private
+      def with_assigned_model(model)
+        @assigned_model = model
+        yield
+      ensure
+        @assigned_model = nil
+      end
+
       # Attributes are assigned before the persistence callbacks fire, so
       # around_persistence receives the assigned model - its pre-yield
       # position is the last chance to touch the model before save, inside
       # the transaction. Modify attributes in before_attributes instead.
-      def create(create_params, meta = nil, assigned_model: nil)
+      def create(create_params, meta = nil)
         model_instance = assigned_model || assign(create_params, meta, :create)
 
         run_callbacks :persistence, :create, model_instance, meta do
@@ -111,7 +123,7 @@ module Graphiti
         model_instance
       end
 
-      def update(update_params, meta = nil, assigned_model: nil)
+      def update(update_params, meta = nil)
         model_instance = assigned_model || assign(update_params, meta, :update)
 
         run_callbacks :persistence, :update, model_instance, meta do

data/lib/graphiti/resource_proxy.rb

@@ -82,6 +82,12 @@ module Graphiti
       Renderer.new(self, options).as_graphql
     end
 
+    # Records supplied directly, no scope resolution
+    def data=(models)
+      @data = models
+      [@data].flatten.compact.each { |record| @resource.decorate_record(record) }
+    end
+
     def data
       return @data unless @data.nil?
       return assign_attributes(@payload.params) if @assign_action

data/lib/graphiti/util/persistence.rb

@@ -190,22 +190,21 @@ class Graphiti::Util::Persistence
     }
   end
 
-  def accepts_assigned_model?(method)
-    method.parameters.any? { |type, name| name == :assigned_model && [:key, :keyreq].include?(type) }
-  end
-
+  # The assigned model rides on the resource instance rather than through
+  # the method signature, so any override of #create/#update - whatever its
+  # arity - passes it through untouched.
   def call_resource_method(method_name, attributes, caller_model)
     method = @resource.method(method_name)
+    call = if method.arity == 1
+      -> { method.call(attributes) }
+    else
+      -> { method.call(attributes, metadata) }
+    end
 
     if @assigned_model && [:create, :update].include?(method_name)
-      unless accepts_assigned_model?(method)
-        raise Graphiti::Errors::AssignedModelNotSupported.new(@resource.class, method_name)
-      end
-      method.call(attributes, metadata, assigned_model: @assigned_model)
-    elsif method.arity == 1
-      method.call(attributes)
+      @resource.with_assigned_model(@assigned_model) { call.call }
     else
-      method.call(attributes, metadata)
+      call.call
     end
   end
 end

data/lib/graphiti/version.rb

@@ -1,3 +1,3 @@
 module Graphiti
-  VERSION = "2.0.0.beta.1"
+  VERSION = "2.0.0.beta.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: graphiti
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta.1
+  version: 2.0.0.beta.3
 platform: ruby
 authors:
 - Lee Richmond
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-30 00:00:00.000000000 Z
+date: 2026-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jsonapi-serializable
@@ -237,7 +237,9 @@ files:
 - ".github/workflows/release.yml"
 - ".gitignore"
 - ".rspec"
+- ".ruby-version"
 - ".standard.yml"
+- ".tool-versions"
 - ".yardopts"
 - Appraisals
 - CHANGELOG.md