graphiti-activegraph 0.1.26 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e2e06c991422f868705fa49e812c51af9c537366fac6246ebfc882969e7bdae
-  data.tar.gz: 7fc80649e1455f255450e00dcf6c66fe0ff889d1d74e16ebe123dc70362e8266
+  metadata.gz: '0928b60dbd846d64a29c21e84023b471b619e437261e1d8b77f840e5c633dd81'
+  data.tar.gz: 69afd454fcf50c4ffa50930de69bea8d182c5e32681c9be2c9c33b676719f102
 SHA512:
-  metadata.gz: 3db8cee492d4ac415bddc3a44cf755cfa4f32a0b3865f90821c62a681838776d48c6e12dff4fd30fafce88f204c56884c37bc016bc4b71166fe572ec725ab1df
-  data.tar.gz: 8d7f27a547460a725247b4b28ea629fec384f20e0255f29771c6f805e096063f8bfb5138e576f7ef7d6c7eb1acfe4cfca735940d2852dee41fee3042462ca604
+  metadata.gz: b6675d6ee443f716836b6ce3680597d2ee9abcb5ff5999ba8cd452d03128d3794a5f0bc663d311d99401f4549887f77347be86d0fc84430c5b5b3e869b0bcf10
+  data.tar.gz: 1f972ef62c9bf15ba0b0881206cb09bcb5986a8cd2f28875d703e3d372d61ce89e19cf12f049b6609416ead6d52704185f5791554e5967631d90327ef610e52a

data/.github/workflows/specs.yml

@@ -18,20 +18,34 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby-version: [ jruby ]
+        ruby-version: [ ruby-3.4.2, ruby-3.3.7, ruby-3.2.7 ] # Removed 'jruby' till https://github.com/jruby/jruby/issues/8642 is fixed
+        neo4j: [ 5.23.0 ]
+        include:
+          - ruby: jruby
+            java-version: 17
     env:
       JRUBY_OPTS: --debug -J-Xmx1280m -Xcompile.invokedynamic=false -J-XX:+TieredCompilation -J-XX:TieredStopAtLevel=1 -J-noverify -Xcompile.mode=OFF
     steps:
+      - name: Start neo4j
+        run: docker run --name neo4j --env NEO4J_AUTH=neo4j/password --env NEO4J_ACCEPT_LICENSE_AGREEMENT=yes --env NEO4J_dbms_directories_import= -p7687:7687 -p7474:7474 -v `pwd`/tmp:/var/lib/neo4j/import --rm neo4j:${{ matrix.neo4j }}-enterprise &
+
       - uses: actions/checkout@v3
+
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true
+
       - name: Set up Java
-        uses: actions/setup-java@v3
+        uses: actions/setup-java@v4
+        if: matrix.java-version
         with:
           distribution: 'temurin'
-          java-version: 17
+          java-version: ${{ matrix.java-version }}
+
+      - name: Wait for neo4j
+        run: while [ $((curl localhost:7474/ > /dev/null 2>&1); echo $?) -ne 0 ]; do sleep 1; done
+
       - name: Run tests
         run: bundle exec rspec

data/.gitignore

@@ -52,5 +52,8 @@ build-iPhoneSimulator/
 # unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
 .rvmrc
 
+# RubyMine project files
+.idea
+
 # Used by RuboCop. Remote config files pulled in from inherit_from directive.
 # .rubocop-https?--*

data/CHANGELOG.md

@@ -1,69 +1,27 @@
-## Unreleased
+# Changelog
 
--
+All notable changes to this project will be documented in this file.
 
-## 0.1.8 (09-06-2021)
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-Features:
+## [Unreleased]
 
-- Added support for polymorphic relationship.
+## [1.0.0] - 2025-03-18
 
-## 0.1.13 (21-12-2021)
+### Added
 
-Features:
+- **MRI Support**: Introduced compatibility with MRI (Matz's Ruby Interpreter), expanding the gem's usability beyond JRuby (#38).
+- **Documentation Updates**: Expanded the README to provide clearer guidance on gem usage and integration (#38).
+- **Sideloading Workflow**: Enhanced scoping mechanisms and added support for eager loading associations to improve data retrieval efficiency and flexibility (#38).
 
-- Supports Jruby-9.3.2.0
+### Changed
+- **Resource Class**: Instead of modifying the `Graphiti::Resource` class, we now define `Graphiti::ActiveGraph::Resource`,  
+  which must be inherited in all resource classes to enable ActiveGraph support (#38).
 
-## 0.1.14 (21-12-2021)
+---
 
-Features:
+*Note: For details on changes prior to version 1.0.0, please refer to the [`CHANGELOG_PRE_1.0.0.md`](CHANGELOG_PRE_1.0.0.md) file.*
 
-- Adding unpaginated query to resource proxy with preloaded records. This will help in getting count on API.
-
-## 0.1.15 (21-06-2022)
-
-Features:
-
-- Relationships mentioned in sparse field param (and not in include), will now be returned in relationship block of response
-
-## 0.1.20
-
-Features:
-
-- With graphiti config variable "allow_sidepost" you can allow/disallow sideposting, by default it is allowed.
-
-## 0.1.21
-
-Fixes:
-
-- Runner#proxy keyword arguments
-
-## 0.1.22
-
-Fixes:
-
-- when rendering preloaded resources, we were not applying scoping. Now we are skipping around_scoping callback too.
-
-## 0.1.23 (29-04-2024)
-
-Features:
-
-- Added support for UUID
-
-## 0.1.24 (18-06-2024)
-
-Features:
-
-- Added preliminary support for Sideload backed by function instead of model association
-
-## 0.1.25 (04-12-2024)
-
-Features:
-
-- Added support to preload extra_fields for the main resource, replacing N+1 queries with a single query. This does not apply to sideloaded resources.
-
-<!-- ### [version (DD-MM-YYYY)] -->
-<!-- Breaking changes:-->
-<!-- Features:-->
-<!-- Fixes:-->
-<!-- Misc:-->
+[unreleased]: https://github.com/mrhardikjoshi/graphiti-activegraph/compare/v1.0.0...master
+[1.0.0]: https://github.com/mrhardikjoshi/graphiti-activegraph/compare/9f837108ae57287c65b0f6fd2609dd56a95cd461...v1.0.0

data/CHANGELOG_PRE_1.0.0.md

@@ -0,0 +1,70 @@
+## 0.1.8 (09-06-2021)
+
+Features:
+
+- Added support for polymorphic relationship.
+
+## 0.1.13 (21-12-2021)
+
+Features:
+
+- Supports Jruby-9.3.2.0
+
+## 0.1.14 (21-12-2021)
+
+Features:
+
+- Adding unpaginated query to resource proxy with preloaded records. This will help in getting count on API.
+
+## 0.1.15 (21-06-2022)
+
+Features:
+
+- Relationships mentioned in sparse field param (and not in include), will now be returned in relationship block of response
+
+## 0.1.20
+
+Features:
+
+- With graphiti config variable "allow_sidepost" you can allow/disallow sideposting, by default it is allowed.
+
+## 0.1.21
+
+Fixes:
+
+- Runner#proxy keyword arguments
+
+## 0.1.22
+
+Fixes:
+
+- when rendering preloaded resources, we were not applying scoping. Now we are skipping around_scoping callback too.
+
+## 0.1.23 (29-04-2024)
+
+Features:
+
+- Added support for UUID
+
+## 0.1.24 (18-06-2024)
+
+Features:
+
+- Added preliminary support for Sideload backed by function instead of model association
+
+## 0.1.25 (04-12-2024)
+
+Features:
+
+- Added support to preload extra_fields for the main resource, replacing N+1 queries with a single query. This does not apply to sideloaded resources.
+
+## 0.2.0 (01-24-2025)
+
+Features:
+
+- Added MRI support
+- Added support for rails 8
+
+Breaking changes:
+
+- Removed support for graphiti <= 1.6.3

data/README.md

@@ -0,0 +1,68 @@
+# Graphiti ActiveGraph
+
+[![Gem Version](https://badge.fury.io/rb/graphiti-activegraph.svg)](https://badge.fury.io/rb/graphiti-activegraph) [![Build Status](https://github.com/mrhardikjoshi/graphiti-activegraph/actions/workflows/specs.yml/badge.svg?branch=master)](https://github.com/mrhardikjoshi/graphiti-activegraph/actions?query=branch%3Amaster) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.txt)
+
+An adapter to make Graphiti work with the ActiveGraph(former Neo4jrb) OGM. This gem allows you to easily build [jsonapi.org](https://jsonapi.org) compatible APIs for GraphDB using [Graphiti](https://www.graphiti.dev) and [ActiveGraph](https://github.com/neo4jrb/activegraph). 
+
+### Installation
+Add this line to your application's `Gemfile`:
+```ruby
+gem 'graphiti-activegraph'
+```
+
+And then execute:
+```shell
+bundle install
+```
+
+Or install it yourself as:
+```shell
+gem install graphiti-activegraph
+```
+
+
+## Usage
+While defining a Resource class, inherit it from `Graphiti::ActiveGraph::Resource`
+```ruby
+class PlanetResource < Graphiti::ActiveGraph::Resource
+```
+
+For model backed by `ApplicationRelationship` instead of `ApplicationNode`, we have to set `relationship_resource` to `true` while defining resource class.
+```ruby
+class RelationshipBackedResource < Graphiti::ActiveGraph::Resource
+  self.relationship_resource = true
+end
+```
+
+### Documentation
+##### **Key Differences from Graphiti**
+- **Efficient Sideloading:**
+Unlike Graphiti, which executes multiple queries for sideloading, graphiti-activegraph leverages `with_ordered_associations` from ActiveGraph to fetch sideloaded data in a single query, improving performance.
+
+- **Sideposting Behavior:**
+graphiti-activegraph allows assigning and unassigning relationships via sideposting but does not support modifying a resource’s attributes through sideposting.
+
+- **Thread Context Handling:**
+Graphiti stores context using `Thread.current[]`, which does not persist across different fibers within the same thread. In graphiti-activegraph, when running on MRI (non-JRuby environments), the gem uses `thread_variable_get` and `thread_variable_set`. Ensuring the context remains consistent across different fibers in the same thread.
+
+##### **New Features in graphiti-activegraph**
+###### Rendering Preloaded Objects Without Extra Queries
+graphiti-activegraph introduces two new methods on the Graphiti resource class:
+`with_preloaded_obj(record, params)` – Renders a single preloaded ActiveGraph object without querying the database.
+`all_with_preloaded(records, params)` – Renders multiple preloaded ActiveGraph objects without additional queries.
+**Note:** These methods assume that the provided records are final and will not apply Graphiti’s filtering, sorting, or scoping logic.
+
+### Contributing
+Bug reports and pull requests are welcome on GitHub at https://github.com/mrhardikjoshi/graphiti-activegraph. This project is intended to be a safe, welcoming space for collaboration.
+
+### Release
+1. Make sure version file is updated/incremented in master branch
+2. git checkout master
+3. git pull origin master
+4. git tag v1.2.3
+5. git push origin v1.2.3
+6. gem build graphiti-activegraph.gemspec
+7. gem push graphiti-activegraph-1.2.3.gem
+
+### License
+The gem is available as open-source under the terms of the MIT License.

data/graphiti-activegraph.gemspec

@@ -1,36 +1,30 @@
-lib = File.expand_path("../lib", __FILE__)
+lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "graphiti/active_graph/version"
+require 'graphiti/active_graph/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "graphiti-activegraph"
+  spec.name          = 'graphiti-activegraph'
   spec.version       = Graphiti::ActiveGraph::VERSION
-  spec.authors       = ["Hardik Joshi"]
-  spec.email         = ["hardikjoshi1991@gmail.com"]
+  spec.authors       = ['Hardik Joshi']
+  spec.email         = ['hardikjoshi1991@gmail.com']
 
-  spec.summary       = "Easily build jsonapi.org-compatible APIs for GraphDB"
-  spec.homepage      = "https://github.com/mrhardikjoshi/graphiti-activegraph"
-  spec.license       = "MIT"
+  spec.summary       = 'Easily build jsonapi.org-compatible APIs for GraphDB'
+  spec.homepage      = 'https://github.com/mrhardikjoshi/graphiti-activegraph'
+  spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
-  spec.add_dependency "graphiti", ">= 1.2.0"
-  spec.add_dependency "activegraph", "~> 12.0.0.beta.4"
-  spec.add_dependency "activesupport", ">= 6.0"
-  spec.add_dependency "zeitwerk"
+  spec.add_dependency 'graphiti', '>= 1.6.4'
+  spec.add_dependency 'activegraph', '>= 12.0.0.beta.5'
 
-  spec.add_development_dependency "faraday", "~> 0.15"
-  spec.add_development_dependency "kaminari", "~> 0.17"
-  spec.add_development_dependency "bundler"
-  # dependency conflict introduced during runtime
-  # jar-dependencies is a default gem in JRuby and also a dependency in neo4j-ruby-driver
-  spec.add_development_dependency "jar-dependencies", "~> 0.4.1"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "graphiti_spec_helpers", "1.0.beta.4"
-  spec.add_development_dependency "standard"
-  spec.add_development_dependency "pry"
-  spec.add_development_dependency "rspec", "~> 3.9.0"
+  spec.add_development_dependency 'graphiti_spec_helpers', '>= 1.0.0'
+  spec.add_development_dependency 'standard'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'ffaker'
+  spec.add_development_dependency 'factory_bot_rails'
+  spec.add_development_dependency 'rake', '>= 10.0'
+  spec.add_development_dependency 'rspec', '>= 3.9.0'
 end

data/lib/graphiti/active_graph/adapters/active_graph/function_sideload.rb

@@ -4,12 +4,4 @@ class Graphiti::ActiveGraph::Adapters::ActiveGraph::FunctionSideload < Graphiti:
   def association?
     false
   end
-
-  def self.function_proc(&blk)
-    self.function_proc = blk
-  end
-
-  def self.param_proc(&blk)
-    self.param_proc = blk
-  end
 end

data/lib/graphiti/active_graph/adapters/active_graph.rb

@@ -1,6 +1,6 @@
 module Graphiti::ActiveGraph
   module Adapters
-    class ActiveGraph < ::Graphiti::Adapters::Abstract
+    class ActiveGraph < Graphiti::Adapters::Abstract
       def self.sideloading_classes
         {
           has_many: Graphiti::ActiveGraph::Adapters::ActiveGraph::HasManySideload,

data/lib/graphiti/active_graph/extensions/context.rb

@@ -0,0 +1,17 @@
+module Graphiti::ActiveGraph::Extensions
+  require 'ostruct' if RUBY_PLATFORM != 'java'
+
+  module Context
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def context
+        Thread.current.thread_variable_get(:context) || {}.tap(&method(:context=))
+      end
+
+      def context=(val)
+        Thread.current.thread_variable_set(:context, val)
+      end
+    end
+  end
+end

data/lib/graphiti/active_graph/extensions/resources/authorizationable.rb

@@ -0,0 +1,29 @@
+module Graphiti::ActiveGraph::Extensions::Resources
+  module Authorizationable
+    extend ActiveSupport::Concern
+
+    included do
+      class << self
+        attr_reader :authorize_attributes
+      end
+    end
+
+    class_methods do
+      def attribute_authorization
+        @authorize_attributes = true
+      end
+
+      def authorize_attributes?
+        @authorize_attributes
+      end
+
+      def readable_attributes
+        attributes.select { |_attr_name, options_map| options_map[:readable] }
+      end
+
+      def readable_sideloads
+        sideloads.select { |_sideloads_name, sideload_obj| sideload_obj.readable? }
+      end
+    end
+  end
+end

data/lib/graphiti/active_graph/extensions/resources/payload_combinable.rb

@@ -0,0 +1,24 @@
+module Graphiti::ActiveGraph::Extensions::Resources
+  module PayloadCombinable
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def combine(attributes, relationships)
+        attributes.merge(relationship_attributes(relationships))
+      end
+
+      def relationship_attributes(relationships)
+        relationships.map { |k, v| [k, extract_ids(v)] }.to_h
+      end
+
+      def extract_ids(object)
+        object.is_a?(Array) ? object.map { |o| extract_ids(o) } : object[:attributes][:id]
+      end
+
+      def remove_undeclared_attributes(attr_map)
+        permitted_attrs = all_attributes.keys
+        attr_map.select! { |attr_name, _value| permitted_attrs.include?(attr_name.to_sym) }
+      end
+    end
+  end
+end

data/lib/graphiti/active_graph/extensions/resources/preloadable.rb

@@ -0,0 +1,19 @@
+module Graphiti::ActiveGraph::Extensions::Resources
+  module Preloadable
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def with_preloaded_obj(obj, params)
+        id = params[:data].try(:[], :id) || params.delete(:id)
+        params[:filter] ||= {}
+        params[:filter][:id] = id if id
+
+        build(params, nil, raise_on_missing: false, preloaded: obj)
+      end
+
+      def all_with_preloaded(obj_arr, params)
+        build(params, nil, single: false, raise_on_missing: false, preloaded: obj_arr)
+      end
+    end
+  end
+end

data/lib/graphiti/active_graph/extensions/resources/rel.rb

@@ -0,0 +1,19 @@
+module Graphiti::ActiveGraph::Extensions::Resources
+  module Rel
+    extend ActiveSupport::Concern
+
+    def relation_resource?
+      self.class.relation_resource?
+    end
+
+    class_methods do
+      def relation_resource?
+        config[:relation_resource] || false
+      end
+
+      def relationship_resource=(value)
+        config[:relation_resource] = value
+      end
+    end
+  end
+end

data/lib/graphiti/active_graph/resource.rb

@@ -1,41 +1,52 @@
 module Graphiti
   module ActiveGraph
-    module Resource
-      def relation_resource?
-        config[:relation_resource] || false
+    class Resource < Graphiti::Resource
+      include Extensions::Resources::Authorizationable
+      include Extensions::Resources::PayloadCombinable
+      include Extensions::Resources::Preloadable
+      include Extensions::Resources::Rel
+
+      self.adapter = Adapters::ActiveGraph
+      self.abstract_class = true
+
+      def self.use_uuid
+        define_singleton_method(:inherited) do |klass|
+          super(klass)
+          klass.attribute :id, :uuid
+        end
       end
 
-      def relationship_resource=(value)
-        config[:relation_resource] = value
+      def self.guard_nil_id!(params)
       end
 
-      def with_preloaded_obj(obj, params)
-        id = params[:data].try(:[], :id) || params.delete(:id)
-        params[:filter] ||= {}
-        params[:filter][:id] = id if id
+      def self.extra_attribute?(name)
+        extra_attributes.has_key?(name)
+      end
 
-        build(params, nil, raise_on_missing: false, preloaded: obj)
+      def self.sideload_config(sideload_name)
+        config[:sideloads][sideload_name]
       end
 
-      def all_with_preloaded(obj_arr, params)
-        build(params, nil, single: false, raise_on_missing: false, preloaded: obj_arr)
+      def self.sideload_resource_class(sideload_name)
+        sideload_config(sideload_name)&.resource_class
       end
 
-      def guard_nil_id!(params)
+      def self.custom_eagerload(sideload_name)
+        sideload_config(sideload_name)&.custom_eagerload
       end
 
       def extra_attribute?(name)
-        extra_attributes.has_key?(name)
+        self.class.extra_attribute?(name)
       end
-    end
 
-    module ResourceInstanceMethods
-      def relation_resource?
-        self.class.relation_resource?
+      def build_scope(base, query, opts = {})
+        scoping_class.new(base, self, query, opts)
       end
 
-      def extra_attribute?(name)
-        self.class.extra_attribute?(name)
+      def handle_includes(scope, includes, sorts, **opts)
+        includes_str = JSONAPI::IncludeDirective.new(includes, retain_rel_limit: true).to_string.split(',')
+        options = opts.merge(max_page_size:).merge!(authorize_scope_params)
+        scope.with_ordered_associations(includes_str, sorts, options)
       end
 
       def sideload_name_arr(query)
@@ -68,6 +79,20 @@ module Graphiti
           raise Errors::TypecastFailed.new(self, name, value, e, type_name)
         end
       end
+
+      def authorize_scope_params
+        {}
+      end
+
+      private
+
+      def scoping_class
+        Scope
+      end
+
+      def update_foreign_key(*)
+        true
+      end
     end
   end
 end

data/lib/graphiti/active_graph/resource_proxy.rb

@@ -26,6 +26,8 @@ module Graphiti::ActiveGraph
       @single ? data_for_preloaded_record : data_for_preloaded_records
     end
 
+    alias_method :resolve_data, :data
+
     def data_for_preloaded_record
       @preloaded = @preloaded.is_a?(Array) ? @preloaded[0] : @preloaded
       @resource.decorate_record(@preloaded)

data/lib/graphiti/active_graph/{resource → resources}/interface.rb

@@ -1,10 +1,10 @@
 module Graphiti::ActiveGraph
-  module Resource
+  module Resources
     module Interface
       extend ActiveSupport::Concern
       class_methods do
         def build(params, base_scope = nil, opts = {})
-          validate!(params)
+          validate_request!(params)
           runner = ::Graphiti::Runner.new(self, params)
           runner.proxy(base_scope, { single: true, raise_on_missing: true }.merge(opts) )
         end

data/lib/graphiti/active_graph/{resource → resources}/persistence.rb

@@ -1,5 +1,5 @@
 module Graphiti::ActiveGraph
-  module Resource
+  module Resources
     module Persistence
       def update(update_params, meta = nil)
         model_instance = nil

data/lib/graphiti/active_graph/scope.rb

@@ -0,0 +1,27 @@
+module Graphiti
+  module ActiveGraph
+    class Scope < Graphiti::Scope
+      def non_applicable_for_unpaginated
+        %i[association_eagerload]
+      end
+
+      def apply_scoping(scope, opts)
+        opts[:query_obj] = @query
+        super
+
+        append_scopings(opts) unless @resource.remote?
+        @object
+      end
+
+      def append_scopings(opts)
+        add_scoping(:association_eagerload, Scoping::AssociationEagerLoad, opts)
+      end
+
+      def add_scoping(key, scoping_class, opts, _ = {})
+        @object = scoping_class.new(@resource, @query.hash, @object, opts).apply
+        return if non_applicable_for_unpaginated.include?(key)
+        @unpaginated_object = scoping_class.new(@resource, @query.hash, @unpaginated_object, opts.merge(unpaginated_query: true)).apply
+      end
+    end
+  end
+end

data/lib/graphiti/active_graph/scoping/association_eager_load.rb

@@ -0,0 +1,35 @@
+module Graphiti::ActiveGraph
+  module Scoping
+    # Handles sideloading via scoping instead of sideloading query as in original jsonapi_suite
+    class AssociationEagerLoad < Graphiti::Scoping::Base
+      def custom_scope
+        nil
+      end
+
+      def apply_standard_scope
+        return @scope unless eagerload_associations?
+        if (ids = @scope.collect(&:id)).present?
+          @opts[:query_obj].include_hash.each_key do |key|
+            eagerload_association(key, ids)
+          end
+        end
+        @scope
+      end
+
+      def eagerload_associations?
+        @opts[:query_obj].include_hash.present? && @resource.model.include?(ActiveGraph::Node) &&
+          @resource.model.associations_to_eagerload.present?
+      end
+
+      def eagerload_association(key, ids)
+        return unless @resource.model.eagerload_association?(key)
+        nodes = @resource.model.association_nodes(key, ids, @resource.context.send(:association_filter_params))
+        @scope.each { |node| node.send("#{key}=", nodes[node.id] || nil_or_empty(key)) }
+      end
+
+      def nil_or_empty(key)
+        @resource.class.config[:sideloads][key].type == :has_one ? nil : []
+      end
+    end
+  end
+end

data/lib/graphiti/active_graph/version.rb

@@ -1,5 +1,5 @@
 module Graphiti
   module ActiveGraph
-    VERSION = '0.1.26'
+    VERSION = '1.0.0'
   end
 end

data/lib/graphiti/sidepost_configuration.rb

@@ -3,6 +3,7 @@
 module Graphiti
   module SidepostConfiguration
     extend ActiveSupport::Concern
+
     included do
       attr_accessor :allow_sidepost
     end

data/lib/graphiti-activegraph.rb

@@ -20,21 +20,23 @@ loader.ignore(File.expand_path('graphiti-activegraph.rb', __dir__))
 loader.setup
 
 Graphiti::Scoping::Filterable.prepend Graphiti::ActiveGraph::Scoping::Filterable
-Graphiti::Resource::Persistence.prepend Graphiti::ActiveGraph::Resource::Persistence
-Graphiti::Resource::Interface::ClassMethods.prepend Graphiti::ActiveGraph::Resource::Interface::ClassMethods
+Graphiti::Resource::Persistence.prepend Graphiti::ActiveGraph::Resources::Persistence
+Graphiti::Resource::Interface::ClassMethods.prepend Graphiti::ActiveGraph::Resources::Interface::ClassMethods
 require 'graphiti'
 Graphiti::Scoping::Filter.prepend Graphiti::ActiveGraph::Scoping::Filter
 Graphiti::Util::SerializerRelationship.prepend Graphiti::ActiveGraph::Util::SerializerRelationship
 Graphiti::Util::SerializerAttribute.prepend Graphiti::ActiveGraph::Util::SerializerAttribute
 Graphiti::Util::RelationshipPayload.prepend Graphiti::ActiveGraph::Util::RelationshipPayload
 Graphiti::Query.prepend Graphiti::ActiveGraph::Query
-Graphiti::Resource.prepend Graphiti::ActiveGraph::ResourceInstanceMethods
-Graphiti::Resource.extend Graphiti::ActiveGraph::Resource
 Graphiti::ResourceProxy.prepend Graphiti::ActiveGraph::ResourceProxy
 Graphiti::Runner.prepend Graphiti::ActiveGraph::Runner
 Graphiti::Scope.prepend Graphiti::ActiveGraph::SideloadResolve
 Graphiti::Configuration.include Graphiti::SidepostConfiguration
 Graphiti::RequestValidators::Validator.prepend Graphiti::ActiveGraph::RequestValidators::Validator
 
+unless RUBY_PLATFORM == 'java'
+  Graphiti.prepend Graphiti::ActiveGraph::Extensions::Context
+end
+
 # JSONAPI extensions
 JSONAPI::Serializable::Resource.prepend Graphiti::ActiveGraph::JsonapiExt::Serializable::ResourceExt

metadata

@@ -1,106 +1,63 @@
 --- !ruby/object:Gem::Specification
 name: graphiti-activegraph
 version: !ruby/object:Gem::Version
-  version: 0.1.26
+  version: 1.0.0
 platform: ruby
 authors:
 - Hardik Joshi
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-01-13 00:00:00.000000000 Z
+date: 2025-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
+  name: graphiti
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.0
-  name: graphiti
+        version: 1.6.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.2.0
+        version: 1.6.4
 - !ruby/object:Gem::Dependency
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 12.0.0.beta.4
   name: activegraph
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 12.0.0.beta.4
-- !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
-  name: activesupport
+        version: 12.0.0.beta.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: 12.0.0.beta.5
 - !ruby/object:Gem::Dependency
+  name: graphiti_spec_helpers
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
-  name: zeitwerk
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.15'
-  name: faraday
+        version: 1.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.15'
-- !ruby/object:Gem::Dependency
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.17'
-  name: kaminari
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.17'
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
+  name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  name: bundler
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -109,54 +66,40 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.4.1
-  name: jar-dependencies
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.4.1
-- !ruby/object:Gem::Dependency
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
-  name: rake
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
+  name: ffaker
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.beta.4
-  name: graphiti_spec_helpers
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.beta.4
+        version: '0'
 - !ruby/object:Gem::Dependency
+  name: factory_bot_rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  name: standard
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -165,34 +108,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
-  name: pry
+        version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '10.0'
 - !ruby/object:Gem::Dependency
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.9.0
-  name: rspec
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.9.0
-description:
 email:
 - hardikjoshi1991@gmail.com
 executables: []
@@ -203,8 +145,10 @@ files:
 - ".gitignore"
 - ".rspec"
 - CHANGELOG.md
+- CHANGELOG_PRE_1.0.0.md
 - Gemfile
 - LICENSE.txt
+- README.md
 - graphiti-activegraph.gemspec
 - lib/graphiti-activegraph.rb
 - lib/graphiti/active_graph/adapters/active_graph.rb
@@ -215,16 +159,23 @@ files:
 - lib/graphiti/active_graph/adapters/active_graph/sideload.rb
 - lib/graphiti/active_graph/concerns/path_relationships.rb
 - lib/graphiti/active_graph/deserializer.rb
+- lib/graphiti/active_graph/extensions/context.rb
 - lib/graphiti/active_graph/extensions/grouping/params.rb
 - lib/graphiti/active_graph/extensions/query_params.rb
+- lib/graphiti/active_graph/extensions/resources/authorizationable.rb
+- lib/graphiti/active_graph/extensions/resources/payload_combinable.rb
+- lib/graphiti/active_graph/extensions/resources/preloadable.rb
+- lib/graphiti/active_graph/extensions/resources/rel.rb
 - lib/graphiti/active_graph/jsonapi_ext/serializable/resource_ext.rb
 - lib/graphiti/active_graph/query.rb
 - lib/graphiti/active_graph/request_validators/validator.rb
 - lib/graphiti/active_graph/resource.rb
-- lib/graphiti/active_graph/resource/interface.rb
-- lib/graphiti/active_graph/resource/persistence.rb
 - lib/graphiti/active_graph/resource_proxy.rb
+- lib/graphiti/active_graph/resources/interface.rb
+- lib/graphiti/active_graph/resources/persistence.rb
 - lib/graphiti/active_graph/runner.rb
+- lib/graphiti/active_graph/scope.rb
+- lib/graphiti/active_graph/scoping/association_eager_load.rb
 - lib/graphiti/active_graph/scoping/filter.rb
 - lib/graphiti/active_graph/scoping/filterable.rb
 - lib/graphiti/active_graph/sideload_resolve.rb
@@ -237,7 +188,6 @@ homepage: https://github.com/mrhardikjoshi/graphiti-activegraph
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -252,8 +202,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Easily build jsonapi.org-compatible APIs for GraphDB
 test_files: []