graphiti 1.8.1 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a623eae37b7a163ee35b336e1ac22c3b2d9c2550abf86f75688e20efca72327f
-  data.tar.gz: 1e025562662054b45379e812252d45d4b66d48364856ce95d4cd0876a058774c
+  metadata.gz: 1153a7480fa50066880ae8fd1b5a4f99a24e69ae3ebffb40ae114dbfcffc9910
+  data.tar.gz: 0f3836b75fb3db4a88393d1ec7877340dedea40e9c59350a8e30f1f4ebce10f1
 SHA512:
-  metadata.gz: 30044adbbca21d52a99f0a2f51374f0cf5449f2c6bed7badcbccd29d8668ac6edd8c45aa8a5bdcf40f992cc53d6f6b8055a91c1a2f73cf623508958603bff715
-  data.tar.gz: 82797839f6d91cd86d6df735c87f9fd98490a21e5ff8a9e92ab2bc0e4b7c65a2c73f692b5c4b31a573a28582dea9e48b353a4cc417eb9b0ccba768f7f77b348c
+  metadata.gz: 7e62b853539691e1649da7ff41441f75e5726af05ee88de6d0721b909926733162c07eeb82763dfc0bbc19ea953026ebd5ab2acf03e11313a7d584894dc89263
+  data.tar.gz: 046642e0a06b2340054d501ace62e56c42cb1ab66c3f1939c05fc59b9b14107109276848e2204eb4b6b18378ab3c4ba18ca45cd8025e54036e413f7079943068

data/.github/workflows/ci.yml

@@ -2,7 +2,7 @@ name: CI
 
 on:
   push:
-    branches: [master]
+    branches: [main]
   pull_request: {}
 
 concurrency:
@@ -45,6 +45,7 @@ jobs:
           - gemfiles/rails_7_1_graphiti_rails.gemfile
           - gemfiles/rails_7_2_graphiti_rails.gemfile
           - gemfiles/rails_8_0_graphiti_rails.gemfile
+          - gemfiles/rails_8_1_graphiti_rails.gemfile
         appraisal:
           - true
           - false
@@ -58,6 +59,9 @@ jobs:
           - ruby: ruby-head
             gemfile: gemfiles/rails_8_0_graphiti_rails.gemfile
             appraisal: true
+          - ruby: ruby-head
+            gemfile: gemfiles/rails_8_1_graphiti_rails.gemfile
+            appraisal: true
           - ruby: ruby-head
             gemfile: Gemfile
             appraisal: false
@@ -83,6 +87,16 @@ jobs:
             appraisal: false
           - gemfile: gemfiles/rails_8_0_graphiti_rails.gemfile
             appraisal: false
+          - gemfile: gemfiles/rails_8_1_graphiti_rails.gemfile
+            appraisal: false
+
+          # Rails 8.1 needs ruby 3.2 +
+          - gemfile: gemfiles/rails_8_1_graphiti_rails.gemfile
+            ruby: 2.7
+          - gemfile: gemfiles/rails_8_1_graphiti_rails.gemfile
+            ruby: 3.0
+          - gemfile: gemfiles/rails_8_1_graphiti_rails.gemfile
+            ruby: 3.1
 
           # Rails 8 needs ruby 3.2 +
           - gemfile: gemfiles/rails_8_0_graphiti_rails.gemfile
@@ -156,7 +170,7 @@ jobs:
   publish:
     name: Release
     runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/master'
+    if: github.ref == 'refs/heads/main'
     needs: [test]
     steps:
       - name: Dispatch Release

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 graphiti changelog
 
+# [1.9.0](https://github.com/graphiti-api/graphiti/compare/v1.8.2...v1.9.0) (2026-01-03)
+
+
+### Features
+
+* Support rails 8.1 ([#500](https://github.com/graphiti-api/graphiti/issues/500)) ([34d0cf0](https://github.com/graphiti-api/graphiti/commit/34d0cf03b6b4d887d10d660f0ae08bfa6833345f))
+
+## [1.8.2](https://github.com/graphiti-api/graphiti/compare/v1.8.1...v1.8.2) (2025-05-20)
+
+
+### Bug Fixes
+
+* prevent context loss by always setting thread and fiber locals ([#497](https://github.com/graphiti-api/graphiti/issues/497)) ([5f45f76](https://github.com/graphiti-api/graphiti/commit/5f45f76f590a8a15e9ae3d47d0673c483da11e66))
+
 ## [1.8.1](https://github.com/graphiti-api/graphiti/compare/v1.8.0...v1.8.1) (2025-03-17)
 
 # [1.8.0](https://github.com/graphiti-api/graphiti/compare/v1.7.9...v1.8.0) (2025-03-17)

data/README.md

@@ -1,22 +1,228 @@
+#### Graphiti
+
 [![CI](https://github.com/graphiti-api/graphiti/actions/workflows/ci.yml/badge.svg)](https://github.com/graphiti-api/graphiti/actions/workflows/ci.yml)
 [![Gem Version](https://badge.fury.io/rb/graphiti.svg)](https://badge.fury.io/rb/graphiti)
 [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard)
 [![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)
 
-<p align="center">
-  <a href="https://www.graphiti.dev/guides">
-    <img " src="https://user-images.githubusercontent.com/55264/54884141-c10ada00-4e43-11e9-866b-e3c01e33a7c7.png" />
-  </a>                                                       
-</p>
-                                                           
-Stylish Graph APIs.
 
-[Website](https://www.graphiti.dev/guides/)
+[![discord](https://img.shields.io/badge/community-discord-8A2BE2?logo=discord)](https://discord.gg/wgqkMBsSRV)
+[![guides](https://img.shields.io/badge/guides-https://www.graphiti.dev-F565A5)](https://www.graphiti.dev)
+
+
+
+<img align="right" src="https://user-images.githubusercontent.com/55264/54884141-c10ada00-4e43-11e9-866b-e3c01e33a7c7.png" alt="Graphiti logo" width="150px" />
+Graphiti is a resource-oriented framework that sits on top of your models (usually ActiveRecord) and exposes them via a JSON:API-compliant interface. It abstracts common concerns like serialization, filtering, sorting, pagination, and sideloading relationships, so you can build powerful APIs with minimal boilerplate. By defining resources instead of controllers and serializers, Graphiti helps you keep your API logic organized, consistent, and easy to maintain.
+
+
+#### Examples 
+Here's an example resource from the [example app](https://github.com/graphiti-api/employee_directory/) just to give you a taste of the possibilities. 
+
+
+```ruby
+class EmployeeResource < ApplicationResource
+  attribute :first_name, :string
+  attribute :last_name, :string
+  attribute :age, :integer
+  attribute :created_at, :datetime, writable: false
+  attribute :updated_at, :datetime, writable: false
+  attribute :title, :string, only: [:filterable, :sortable]
+
+  has_many :positions
+  has_many :tasks
+  many_to_many :teams
+  polymorphic_has_many :notes, as: :notable
+  has_one :current_position, resource: PositionResource do
+    params do |hash|
+      hash[:filter][:current] = true
+    end
+  end
+
+  filter :title, only: [:eq] do
+    eq do |scope, value|
+      scope.joins(:current_position).merge(Position.where(title: value))
+    end
+  end
+
+  sort :title do |scope, value|
+    scope.joins(:current_position).merge(Position.order(title: value))
+  end
+
+  sort :department_name, :string do |scope, value|
+    scope.joins(current_position: :department)
+      .merge(Department.order(name: value))
+  end
+end
+```
+
+A pretty boilerplate controller that just interfaces with the resource
+```ruby
+class EmployeesController < ApplicationController
+  def index
+    employees = EmployeeResource.all(params)
+    respond_with(employees)
+  end
+
+  def show
+    employee = EmployeeResource.find(params)
+    respond_with(employee)
+  end
+
+  def create
+    employee = EmployeeResource.build(params)
+
+    if employee.save
+      render jsonapi: employee, status: 201
+    else
+      render jsonapi_errors: employee
+    end
+  end
+
+  def update
+    employee = EmployeeResource.find(params)
+
+    if employee.update_attributes
+      render jsonapi: employee
+    else
+      render jsonapi_errors: employee
+    end
+  end
+
+  def destroy
+    employee = EmployeeResource.find(params)
+
+    if employee.destroy
+      render jsonapi: { meta: {} }, status: 200
+    else
+      render jsonapi_errors: employee
+    end
+  end
+end
+```
+  
+</details>
+
+
+Now you can query your endpoints simply and powerfully, like: 
+
+
+
+Request:
+```http://localhost:3000/api/v1/employees?filter[title][eq]=Future Government Administrator&filter[age][lt]=40```
+
+<details>
+<summary>JSON-API response</summary>
+
+```json
+{
+  "data": [
+    {
+      "id": "1",
+      "type": "employees",
+      "attributes": {
+        "first_name": "Quinn",
+        "last_name": "Homenick",
+        "age": 36,
+        "created_at": "2025-03-21T23:04:40+00:00",
+        "updated_at": "2025-03-21T23:04:40+00:00"
+      },
+      "relationships": {
+        "positions": {
+          "links": {
+            "related": "/api/v1/positions?filter[employee_id]=1"
+          },
+          "data": [
+            {
+              "type": "positions",
+              "id": "1"
+            },
+            {
+              "type": "positions",
+              "id": "2"
+            }
+          ]
+        },
+        "tasks": {
+          "links": {
+            "related": "/api/v1/tasks?filter[employee_id]=1"
+          }
+        },
+        "teams": {
+          "links": {
+            "related": "/api/v1/teams?filter[employee_id]=1"
+          }
+        },
+        "notes": {
+          "links": {
+            "related": "/api/v1/notes?filter[notable_id]=1&filter[notable_type][eql]=Employee"
+          }
+        },
+        "current_position": {
+          "links": {
+            "related": "/api/v1/positions?filter[current]=true&filter[employee_id]=1"
+          },
+          "data": {
+            "type": "positions",
+            "id": "1"
+          }
+        }
+      }
+    }
+  ],
+  "included": [
+    {
+      "id": "1",
+      "type": "positions",
+      "attributes": {
+        "title": "Future Government Administrator",
+        "active": true
+      },
+      "relationships": {
+        "employee": {
+          "links": {
+            "related": "/api/v1/employees/1"
+          }
+        },
+        "department": {
+          "links": {
+            "related": "/api/v1/departments/3"
+          }
+        }
+      }
+    },
+    {
+      "id": "2",
+      "type": "positions",
+      "attributes": {
+        "title": "Manufacturing Specialist",
+        "active": false
+      },
+      "relationships": {
+        "employee": {
+          "links": {
+            "related": "/api/v1/employees/1"
+          }
+        },
+        "department": {
+          "links": {
+            "related": "/api/v1/departments/2"
+          }
+        }
+      }
+    }
+  ],
+  "meta": {}
+}
+```
+
+</details>
+
+
+
+[Graphiti Guides](https://www.graphiti.dev/guides/)
+
+[Join the Discord](https://discord.gg/wgqkMBsSRV)
 
-[Join the Slack Channel](https://join.slack.com/t/graphiti-api/shared_invite/enQtMjkyMTA3MDgxNTQzLTU5MDI4MDllNTEzOTE1Nzk0ZGJlNTcxZDYzMGY2ZTczMDY2OWZhM2RmNTU0YWNiOWZhZDhkMmU4MzQ5NzIyNWM)
 
-Direct Contact: richmolj@gmail.com
 
-Supports Rails >= 4.1
 
-*Looking for JSONAPI-Suite? You're in the right place. Graphiti is the 1.0 version of JSONAPI Suite. For the deprecated Suite gem, go [here](https://github.com/jsonapi-suite/jsonapi_suite_deprecated)*

data/gemfiles/rails_8_1_graphiti_rails.gemfile

@@ -0,0 +1,19 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "rails", "~> 8.1"
+gem "rspec-rails"
+gem "sqlite3", "~> 2.1"
+gem "database_cleaner"
+gem "graphiti-rails", "~> 0.4.0"
+
+group :test do
+  gem "pry"
+  gem "pry-byebug", platform: [:mri]
+  gem "appraisal"
+  gem "guard"
+  gem "guard-rspec"
+end
+
+gemspec path: "../"

data/lib/graphiti/configuration.rb

@@ -115,7 +115,7 @@ module Graphiti
     private
 
     def infer_uri_decoder
-      if defined?(::ActionDispatch::Journey::Router::Utils)
+      if defined?(::ActionDispatch::Journey::Router::Utils) && ::ActionDispatch::Journey::Router::Utils.respond_to?(:unescape_uri)
         # available in all supported versions of Rails.
         # This method should be preferred for comparing URI path segments
         # to params, as it is the exact decoder used in the Rails router.

data/lib/graphiti/scope.rb

@@ -140,7 +140,7 @@ module Graphiti
       end
       fiber_storage =
         if Fiber.current.respond_to?(:storage)
-          Fiber.current&.storage&.keys&.each_with_object({}) do |key, memo|
+          Fiber.current.storage&.keys&.each_with_object({}) do |key, memo|
             memo[key] = Fiber[key]
           end
         end
@@ -149,27 +149,46 @@ module Graphiti
         self.class.global_thread_pool_executor, Thread.current.object_id, thread_storage, fiber_storage, *args
       ) do |thread_id, thread_storage, fiber_storage, *args|
         wrap_in_rails_executor do
-          execution_context_changed = thread_id != Thread.current.object_id
-          if execution_context_changed
-            thread_storage&.keys&.each_with_object(Thread.current) do |key, thread_current|
-              thread_current[key] = thread_storage[key]
-            end
-            fiber_storage&.keys&.each_with_object(Fiber) do |key, fiber_current|
-              fiber_current[key] = fiber_storage[key]
+          with_thread_locals(thread_storage) do
+            with_fiber_locals(fiber_storage) do
+              Graphiti.broadcast(:global_thread_pool_task_run, self.class.global_thread_pool_stats) do
+                yield(*args)
+              end
             end
           end
+        end
+      end
+    end
 
-          result = Graphiti.broadcast(:global_thread_pool_task_run, self.class.global_thread_pool_stats) do
-            yield(*args)
-          end
+    def with_thread_locals(thread_locals)
+      new_thread_locals = []
+      thread_locals.each do |key, value|
+        if !Thread.current[key]
+          new_thread_locals << key
+        end
+        Thread.current[key] = value
+      end
+      yield
+    ensure
+      new_thread_locals.each do |key|
+        Thread.current[key] = nil
+      end
+    end
 
-          if execution_context_changed
-            thread_storage&.keys&.each { |key| Thread.current[key] = nil }
-            fiber_storage&.keys&.each { |key| Fiber[key] = nil }
-          end
+    def with_fiber_locals(fiber_locals)
+      return yield unless fiber_locals
 
-          result
+      new_fiber_locals = []
+      fiber_locals.each do |key, value|
+        if !Fiber[key]
+          new_fiber_locals << key
         end
+        Fiber[key] = value
+      end
+      yield
+    ensure
+      new_fiber_locals&.each do |key|
+        Fiber[key] = nil
       end
     end
 

data/lib/graphiti/version.rb

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

data/package.json

@@ -21,7 +21,7 @@
   },
   "release": {
     "branches": [
-      "master",
+      "main",
       {
         "name": "beta",
         "prerelease": true

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: graphiti
 version: !ruby/object:Gem::Version
-  version: 1.8.1
+  version: 1.9.0
 platform: ruby
 authors:
 - Lee Richmond
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-03-17 00:00:00.000000000 Z
+date: 2026-01-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jsonapi-serializable
@@ -264,6 +264,7 @@ files:
 - gemfiles/rails_7_2_graphiti_rails.gemfile
 - gemfiles/rails_7_graphiti_rails.gemfile
 - gemfiles/rails_8_0_graphiti_rails.gemfile
+- gemfiles/rails_8_1_graphiti_rails.gemfile
 - graphiti.gemspec
 - lib/graphiti.rb
 - lib/graphiti/adapters/abstract.rb