activerecord-bitemporal 6.0.0 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b36848b2facc997f9179abd32f96d7fde53cd9464f9009fa25a1ca5f13f57890
-  data.tar.gz: 8498da159a6e051841ce253b7051f0722b0cb33d2358fc13a1b3f5c0664cf1f7
+  metadata.gz: 9644dc51d17a2d86e13daa5982fab733cdab79fd1fda78fbe408412a90ccd337
+  data.tar.gz: f535c500ce4f4f738e6c09102d89a449476407956460c1e5b80d211adb4b66c9
 SHA512:
-  metadata.gz: bd8c531ad27a3ba0693d3923a00f62abb4b730251e235d0f3a78b449f2fdc7336052a4e5c0115748330e95a6f75eff2f20dcfc71d3fa1360d3d7e4c98c2b38af
-  data.tar.gz: fe72790fbcb1372f8127afe702cf2696f930c901aaa2b6243c913243b299a74917bca867d068e09039a6df001c942f7db81b0a3c64daa54a919bbdb4714de4ac
+  metadata.gz: d0f7ac0703dd57cd8a837f24adc5c0598cbb5b083a20266c20bd35ae4014a28ee6488ed48e3b30119f01b78c40c063deb7bcbe0f8c61280ef6b7a6bc60d5b3eb
+  data.tar.gz: ad4faf9f2c337bcdcefd8f18a1dadaa191c327a82a5e7391d7b15f06b15bfeff631115466da7fb690062b35cf5174bf8ad991dd3041800abf6063c840bd241ac

data/CHANGELOG.md

@@ -1,8 +1,100 @@
 # Changelog
 
+## Unreleased
+
+### Breaking Changes
+
+### Added
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Chores
+
+## 7.0.0
+
+### Breaking Changes
+
+- [Drop support Rails 7.0 #230](https://github.com/kufu/activerecord-bitemporal/pull/230)
+
+### Added
+
+- [Add Ruby 4.0 in CI #236](https://github.com/kufu/activerecord-bitemporal/pull/236)
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+- [Localize patch for AR::Relation#primary_key in Rails 8.0+ #243](https://github.com/kufu/activerecord-bitemporal/pull/243)
+  - In Rails 8.0+, the global override of `ActiveRecord::Relation#primary_key` with `bitemporal_id_key` has been removed. As a result, the following methods now use `primary_key` (i.e., `id`) instead of `bitemporal_id_key`:
+    - `find_each`, `find_in_batches`, and `in_batches`: the default cursor column for ordering and keyset pagination changes (records are not missed or duplicated, but iteration order differs)
+- [Fix finder methods ordering on Rails 8.0+ #237](https://github.com/kufu/activerecord-bitemporal/pull/237)
+
+### Chores
+
+- [Manage development dependencies in gemfiles #240](https://github.com/kufu/activerecord-bitemporal/pull/240)
+- [Randomize test execution order #239](https://github.com/kufu/activerecord-bitemporal/pull/239)
+- [Update release GitHub Action #232](https://github.com/kufu/activerecord-bitemporal/pull/232)
+- [Bump ruby/setup-ruby from 1.286.0 to 1.288.0 #244](https://github.com/kufu/activerecord-bitemporal/pull/244)
+- [Bump actions/checkout from 6.0.1 to 6.0.2 #242](https://github.com/kufu/activerecord-bitemporal/pull/242)
+- [Bump ruby/setup-ruby from 1.278.0 to 1.286.0 #241](https://github.com/kufu/activerecord-bitemporal/pull/241)
+- [Bump ruby/setup-ruby from 1.268.0 to 1.278.0 #234](https://github.com/kufu/activerecord-bitemporal/pull/234)
+- [Update reviewers #231](https://github.com/kufu/activerecord-bitemporal/pull/231)
+- [Bump actions/checkout from 6.0.0 to 6.0.1 #229](https://github.com/kufu/activerecord-bitemporal/pull/229)
+- [Bump ruby/setup-ruby from 1.267.0 to 1.268.0 #228](https://github.com/kufu/activerecord-bitemporal/pull/228)
+- [Bump actions/checkout from 5.0.0 to 6.0.0 #227](https://github.com/kufu/activerecord-bitemporal/pull/227)
+- [Bump codespell-project/actions-codespell from 2.1 to 2.2 #226](https://github.com/kufu/activerecord-bitemporal/pull/226)
+- [Bump ruby/setup-ruby from 1.265.0 to 1.267.0 #225](https://github.com/kufu/activerecord-bitemporal/pull/225)
+
+## 6.1.0
+
+### Breaking Changes
+
+### Added
+
+- [Support GlobalID integration #176](https://github.com/kufu/activerecord-bitemporal/pull/176)
+
+### Changed
+
+- [Add explicit activesupport dependency #208](https://github.com/kufu/activerecord-bitemporal/pull/208)
+- [Improve ValidDatetimeRangeError message with better grammar and context #207](https://github.com/kufu/activerecord-bitemporal/pull/207)
+- [Delay execution of ActiveRecord::Base-related processing #189](https://github.com/kufu/activerecord-bitemporal/pull/189)
+
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Chores
+
+- [Bump ruby/setup-ruby from 1.263.0 to 1.265.0 #223](https://github.com/kufu/activerecord-bitemporal/pull/223)
+- [Update gemspec files to avoid using git #222](https://github.com/kufu/activerecord-bitemporal/pull/222)
+- [Bump ruby/setup-ruby from 1.257.0 to 1.263.0 #221](https://github.com/kufu/activerecord-bitemporal/pull/221)
+- [Add CodeSpell workflow for spell checking in pull requests #220](https://github.com/kufu/activerecord-bitemporal/pull/220)
+- [Configure dependabot cooldown period to 3 days #219](https://github.com/kufu/activerecord-bitemporal/pull/219)
+- [Bump ruby/setup-ruby from 1.255.0 to 1.257.0 #218](https://github.com/kufu/activerecord-bitemporal/pull/218)
+- [Bump actions/checkout from 4.2.2 to 5.0.0 #215](https://github.com/kufu/activerecord-bitemporal/pull/215)
+- [Bump ruby/setup-ruby from 1.254.0 to 1.255.0 #214](https://github.com/kufu/activerecord-bitemporal/pull/214)
+- [Bump ruby/setup-ruby from 1.247.0 to 1.254.0 #213](https://github.com/kufu/activerecord-bitemporal/pull/213)
+- [Bump ruby/setup-ruby from 1.247.0 to 1.253.0 #212](https://github.com/kufu/activerecord-bitemporal/pull/212)
+- [Setup RuboCop #211](https://github.com/kufu/activerecord-bitemporal/pull/211)
+- [Bump ruby/setup-ruby from 1.245.0 to 1.247.0 #210](https://github.com/kufu/activerecord-bitemporal/pull/210)
+- [Using Trusted Publishing for RubyGems.org. #209](https://github.com/kufu/activerecord-bitemporal/pull/209)
+- [Bump ruby/setup-ruby from 1.244.0 to 1.245.0 #206](https://github.com/kufu/activerecord-bitemporal/pull/206)
+
 ## 6.0.0
 
-### Breaking Changed
+### Breaking Changes
 
 - [Add Ruby 3.4 and remove Ruby 3.0 in CI #185](https://github.com/kufu/activerecord-bitemporal/pull/185)
 - [Drop support Rails 6.1 #192](https://github.com/kufu/activerecord-bitemporal/pull/192)
@@ -26,7 +118,7 @@
 
 - [Add a note to the README that PostgreSQL is required to run the tests. #188](https://github.com/kufu/activerecord-bitemporal/pull/188)
 - [Remove specs for Rails 5.x #191](https://github.com/kufu/activerecord-bitemporal/pull/191)
-- [Update auto assgin member #193](https://github.com/kufu/activerecord-bitemporal/pull/193)
+- [Update auto assign member #193](https://github.com/kufu/activerecord-bitemporal/pull/193)
 - [Pin GitHub Actions dependencies to specific commit hashes #194](https://github.com/kufu/activerecord-bitemporal/pull/194)
 - [Bump ruby/setup-ruby from 1.227.0 to 1.229.0 #195](https://github.com/kufu/activerecord-bitemporal/pull/195)
 - [Bump ruby/setup-ruby from 1.229.0 to 1.233.0 #197](https://github.com/kufu/activerecord-bitemporal/pull/197)
@@ -35,7 +127,7 @@
 - [Bump ruby/setup-ruby from 1.237.0 to 1.238.0 #201](https://github.com/kufu/activerecord-bitemporal/pull/201)
 - [Bump ruby/setup-ruby from 1.238.0 to 1.242.0 #202](https://github.com/kufu/activerecord-bitemporal/pull/202)
 - [Bump ruby/setup-ruby from 1.242.0 to 1.244.0 #203](https://github.com/kufu/activerecord-bitemporal/pull/203)
-- [Update auto assgin member #204](https://github.com/kufu/activerecord-bitemporal/pull/204)
+- [Update auto assign member #204](https://github.com/kufu/activerecord-bitemporal/pull/204)
 
 ## 5.3.0
 
@@ -110,7 +202,7 @@
 
 ## 5.0.0
 
-### Breaking Changed
+### Breaking Changes
 
 - [CI against Ruby 3.2, 3.3, Drop Ruby 2.7 and Rails 6.0 #150](https://github.com/kufu/activerecord-bitemporal/pull/150)
 
@@ -191,7 +283,7 @@
 
 ## 4.0.0
 
-### Breaking Changed
+### Breaking Changes
 
 - [[proposal]When bitemporal_at exists inside the nest, the specified date was not prioritized, so the date of the inner bitemporal_at is now prioritized. #121](https://github.com/kufu/activerecord-bitemporal/pull/121)
 - [Drop support Rails 5.2 #122](https://github.com/kufu/activerecord-bitemporal/pull/122)
@@ -246,7 +338,7 @@
 
 ## 3.0.0
 
-### Breaking Changed
+### Breaking Changes
 - [Assign updated bitemporal times to the receiver after update/destroy](https://github.com/kufu/activerecord-bitemporal/pull/118)
 
 ### Added
@@ -261,7 +353,7 @@
 
 ## 2.3.0
 
-### Breaking Changed
+### Breaking Changes
 
 ### Added
 - [Add `InstanceMethods#swapped_id_previously_was`](https://github.com/kufu/activerecord-bitemporal/pull/114)
@@ -276,7 +368,7 @@
 
 ## 2.2.0
 
-### Breaking Changed
+### Breaking Changes
 
 ### Added
 - [replace postgres docker image](https://github.com/kufu/activerecord-bitemporal/pull/103)
@@ -293,7 +385,7 @@
 
 ## 2.1.0
 
-### Breaking Changed
+### Breaking Changes
 
 ### Added
 - [Update valid_to after #update](https://github.com/kufu/activerecord-bitemporal/pull/105)
@@ -310,7 +402,7 @@
 
 ## 2.0.0
 
-### Breaking Changed
+### Breaking Changes
 - [[Proposal] Changed valid_in to exclude valid_from = to and valid_to = from. by osyo-manga · Pull Request #95](https://github.com/kufu/activerecord-bitemporal/pull/95)
 
 ### Added

data/README.md

@@ -6,6 +6,12 @@ ActiveRecord::Bitemporal
 [![gem-download](https://img.shields.io/gem/dt/activerecord-bitemporal.svg)](https://rubygems.org/gems/activerecord-bitemporal)
 [![CircleCI](https://circleci.com/gh/kufu/activerecord-bitemporal.svg?style=svg)](https://circleci.com/gh/kufu/activerecord-bitemporal)
 
+## Requirements
+
+- Ruby 3.1+
+- Rails 7.1, 7.2, 8.0, or 8.1
+- PostgreSQL
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/lib/activerecord-bitemporal/bitemporal.rb

@@ -1,20 +1,8 @@
 # frozen_string_literal: true
 
+require "activerecord-bitemporal/bitemporal_checker"
 module ActiveRecord
   module Bitemporal
-    module BitemporalChecker
-      refine ::Class do
-        def bi_temporal_model?
-          include?(ActiveRecord::Bitemporal)
-        end
-      end
-
-      refine ::ActiveRecord::Relation do
-        def bi_temporal_model?
-          klass.include?(ActiveRecord::Bitemporal)
-        end
-      end
-    end
     using BitemporalChecker
 
     module Optionable
@@ -124,15 +112,36 @@ module ActiveRecord
     end
 
     module Relation
-      module Finder
-        def find(*ids)
-          return super if block_given?
-          all.spawn.yield_self { |obj|
-            def obj.primary_key
-              "bitemporal_id"
+      module BitemporalIdAsPrimaryKey # :nodoc:
+        private
+
+        # Generate a method that temporarily changes the primary key to
+        # bitemporal_id for localizing the effect of the change to only the
+        # method specified by `name`.
+        #
+        # DO NOT use this method outside of this module.
+        def use_bitemporal_id_as_primary_key(name) # :nodoc:
+          module_eval <<~RUBY, __FILE__, __LINE__ + 1
+            def #{name}(...)
+              all.spawn.yield_self { |relation|
+                def relation.primary_key
+                  bitemporal_id_key
+                end
+                relation.method(:#{name}).super_method.call(...)
+              }
             end
-            obj.method(:find).super_method.call(*ids)
-          }
+          RUBY
+        end
+      end
+      extend BitemporalIdAsPrimaryKey
+
+      module Finder
+        extend BitemporalIdAsPrimaryKey
+
+        use_bitemporal_id_as_primary_key :find
+
+        if ActiveRecord.version >= Gem::Version.new("8.0.0")
+          use_bitemporal_id_as_primary_key :exists?
         end
 
         def find_at_time!(datetime, *ids)
@@ -148,6 +157,10 @@ module ActiveRecord
       end
       include Finder
 
+      if ActiveRecord.version >= Gem::Version.new("8.0.0")
+        use_bitemporal_id_as_primary_key :ids
+      end
+
       def build_arel(*)
         ActiveRecord::Bitemporal.with_bitemporal_option(**bitemporal_option) {
           super
@@ -180,8 +193,12 @@ module ActiveRecord
         end
       end
 
-      def primary_key
-        bitemporal_id_key
+      # Use original primary_key for Active Record 8.0+ as much as possible
+      # to avoid issues with patching primary_key of AR::Relation globally.
+      if ActiveRecord.version < Gem::Version.new("8.0.0")
+        def primary_key
+          bitemporal_id_key
+        end
       end
     end
 
@@ -397,16 +414,14 @@ module ActiveRecord
         false
       end
 
-      if Gem::Version.new("7.1.0") <= ActiveRecord.version
-        # MEMO: Since Rails 7.1 #_find_record refers to a record with find_by!(@primary_key => id)
-        #       But if @primary_key is "id", it can't refer to the intended record, so we hack it to refer to the record based on self.class.bitemporal_id_key
-        #       see: https://github.com/rails/rails/blob/v7.1.0/activerecord/lib/active_record/persistence.rb#L1152-#L1171
-        def _find_record(*)
-          tmp_primary_key, @primary_key = @primary_key, self.class.bitemporal_id_key
-          super
-        ensure
-          @primary_key = tmp_primary_key
-        end
+      # MEMO: Since Rails 7.1 #_find_record refers to a record with find_by!(@primary_key => id)
+      #       But if @primary_key is "id", it can't refer to the intended record, so we hack it to refer to the record based on self.class.bitemporal_id_key
+      #       see: https://github.com/rails/rails/blob/v7.1.0/activerecord/lib/active_record/persistence.rb#L1152-#L1171
+      def _find_record(*)
+        tmp_primary_key, @primary_key = @primary_key, self.class.bitemporal_id_key
+        super
+      ensure
+        @primary_key = tmp_primary_key
       end
 
       module ::ActiveRecord::Persistence
@@ -493,7 +508,10 @@ module ActiveRecord
           # 以前の履歴データは valid_to を詰めて保存
           before_instance[valid_to_key] = target_datetime
           if before_instance.valid_from_cannot_be_greater_equal_than_valid_to
-            raise ValidDatetimeRangeError.new("#{valid_from_key} #{before_instance[valid_from_key]} can't be greater equal than #{valid_to_key} #{before_instance[valid_to_key]}")
+            message = "#{valid_from_key} #{before_instance[valid_from_key]} can't be " \
+                      "greater than or equal to #{valid_to_key} #{before_instance[valid_to_key]} " \
+                      "for #{self.class} with bitemporal_id=#{bitemporal_id}"
+            raise ValidDatetimeRangeError.new(message)
           end
           before_instance.transaction_from = current_time
 
@@ -501,7 +519,10 @@ module ActiveRecord
           after_instance[valid_from_key] = target_datetime
           after_instance[valid_to_key] = current_valid_record[valid_to_key]
           if after_instance.valid_from_cannot_be_greater_equal_than_valid_to
-            raise ValidDatetimeRangeError.new("#{valid_from_key} #{after_instance[valid_from_key]} can't be greater equal than #{valid_to_key} #{after_instance[valid_to_key]}")
+            message = "#{valid_from_key} #{after_instance[valid_from_key]} can't be " \
+                      "greater than or equal to #{valid_to_key} #{after_instance[valid_to_key]} " \
+                      "for #{self.class} with bitemporal_id=#{bitemporal_id}"
+            raise ValidDatetimeRangeError.new(message)
           end
           after_instance.transaction_from = current_time
 

data/lib/activerecord-bitemporal/bitemporal_checker.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module ActiveRecord
+  module Bitemporal
+    module BitemporalChecker
+      refine ::Class do
+        def bi_temporal_model?
+          include?(ActiveRecord::Bitemporal)
+        end
+      end
+
+      refine ::ActiveRecord::Relation do
+        def bi_temporal_model?
+          klass.include?(ActiveRecord::Bitemporal)
+        end
+      end
+    end
+  end
+end

data/lib/activerecord-bitemporal/bitemporalize.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+module ActiveRecord::Bitemporal::Bitemporalize
+  using Module.new {
+    refine ::ActiveRecord::Base do
+      class << ::ActiveRecord::Base
+        def prepend_relation_delegate_class(mod)
+          relation_delegate_class(ActiveRecord::Relation).prepend mod
+          relation_delegate_class(ActiveRecord::AssociationRelation).prepend mod
+        end
+      end
+    end
+  }
+
+  module ClassMethods
+    include ActiveRecord::Bitemporal::Relation::Finder
+
+    def bitemporal_id_key
+      'bitemporal_id'
+    end
+
+    # Override ActiveRecord::Core::ClassMethods#cached_find_by_statement
+    # `.find_by` not use caching
+    def cached_find_by_statement(key, &block)
+      ActiveRecord::StatementCache.create(connection, &block)
+    end
+
+    def inherited(klass)
+      super
+      klass.prepend_relation_delegate_class ActiveRecord::Bitemporal::Relation
+      klass.relation_delegate_class(ActiveRecord::Associations::CollectionProxy).prepend ActiveRecord::Bitemporal::CollectionProxy
+      if relation_delegate_class(ActiveRecord::Relation).ancestors.include? ActiveRecord::Bitemporal::Relation::MergeWithExceptBitemporalDefaultScope
+        klass.relation_delegate_class(ActiveRecord::Relation).prepend ActiveRecord::Bitemporal::Relation::MergeWithExceptBitemporalDefaultScope
+      end
+    end
+  end
+
+  module InstanceMethods
+    include ActiveRecord::Bitemporal::Persistence
+
+    def swap_id!(without_clear_changes_information: false)
+      @_swapped_id_previously_was = nil
+      @_swapped_id = self.id
+      self.id = self.send(bitemporal_id_key)
+      clear_attribute_changes([:id]) unless without_clear_changes_information
+    end
+
+    def swapped_id
+      @_swapped_id || self.id
+    end
+
+    def swapped_id_previously_was
+      @_swapped_id_previously_was
+    end
+
+    def bitemporal_id_key
+      self.class.bitemporal_id_key
+    end
+
+    def bitemporal_ignore_update_columns
+      []
+    end
+
+    def id_in_database
+      swapped_id.presence || super
+    end
+
+    def previously_force_updated?
+      @previously_force_updated
+    end
+
+    def valid_from_cannot_be_greater_equal_than_valid_to
+      if self[valid_from_key] && self[valid_to_key] && self[valid_from_key] >= self[valid_to_key]
+        errors.add(valid_from_key, "can't be greater equal than #{valid_to_key}")
+      end
+    end
+
+    def transaction_from_cannot_be_greater_equal_than_transaction_to
+      if transaction_from && transaction_to && transaction_from >= transaction_to
+        errors.add(:transaction_from, "can't be greater equal than transaction_to")
+      end
+    end
+  end
+
+  def bitemporalize(
+    enable_strict_by_validates_bitemporal_id: false,
+    enable_default_scope: true,
+    enable_merge_with_except_bitemporal_default_scope: false,
+    valid_from_key: :valid_from,
+    valid_to_key: :valid_to
+  )
+    return if ancestors.include? InstanceMethods
+
+    extend ClassMethods
+    include InstanceMethods
+    include ActiveRecord::Bitemporal
+    include ActiveRecord::Bitemporal::Scope
+    include ActiveRecord::Bitemporal::Callbacks
+    prepend ActiveRecord::Bitemporal::GlobalID if defined?(::GlobalID)
+
+    if enable_merge_with_except_bitemporal_default_scope
+      relation_delegate_class(ActiveRecord::Relation).prepend ActiveRecord::Bitemporal::Relation::MergeWithExceptBitemporalDefaultScope
+    end
+
+    if enable_default_scope
+      default_scope {
+        bitemporal_default_scope
+      }
+    end
+
+    after_create do
+      # MEMO: #update_columns is not call #_update_row (and validations, callbacks)
+      update_columns(bitemporal_id_key => swapped_id) unless send(bitemporal_id_key)
+      swap_id!(without_clear_changes_information: true)
+      @previously_force_updated = false
+    end
+
+    after_find do
+      self.swap_id! if self.send(bitemporal_id_key).present?
+      @previously_force_updated = false
+    end
+
+    self.class_attribute :valid_from_key, :valid_to_key, instance_writer: false
+    self.valid_from_key = valid_from_key.to_s
+    self.valid_to_key = valid_to_key.to_s
+    attribute valid_from_key, default: ActiveRecord::Bitemporal::DEFAULT_VALID_FROM
+    attribute valid_to_key, default: ActiveRecord::Bitemporal::DEFAULT_VALID_TO
+    attribute :transaction_from, default: ActiveRecord::Bitemporal::DEFAULT_TRANSACTION_FROM
+    attribute :transaction_to, default: ActiveRecord::Bitemporal::DEFAULT_TRANSACTION_TO
+
+    # Rails 8 support: ensure finder methods (.first, .last, etc.) use bitemporal_id ordering.
+    # Rails 8.0 changed _order_columns to use model.primary_key instead of Relation's primary_key.
+    # The nil-terminated format (Rails 8.1 feature, PR #54679) prevents automatic primary_key
+    # appending to the ORDER BY clause.
+    # See: https://github.com/rails/rails/pull/54679
+    if ActiveRecord.gem_version >= Gem::Version.new("8.0.0")
+      self.implicit_order_column ||= [bitemporal_id_key, nil]
+    end
+
+    # Callback hook to `validates :xxx, uniqueness: true`
+    const_set(:UniquenessValidator, Class.new(ActiveRecord::Validations::UniquenessValidator) {
+      prepend ActiveRecord::Bitemporal::Uniqueness
+    })
+
+    # validations
+    validates valid_from_key, presence: true
+    validates valid_to_key, presence: true
+    validates :transaction_from, presence: true
+    validates :transaction_to, presence: true
+    validate :valid_from_cannot_be_greater_equal_than_valid_to
+    validate :transaction_from_cannot_be_greater_equal_than_transaction_to
+
+    validates bitemporal_id_key, uniqueness: true, allow_nil: true, strict: enable_strict_by_validates_bitemporal_id
+
+    prepend_relation_delegate_class ActiveRecord::Bitemporal::Relation
+    relation_delegate_class(ActiveRecord::Associations::CollectionProxy).prepend ActiveRecord::Bitemporal::CollectionProxy
+  end
+end

data/lib/activerecord-bitemporal/global_id.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+begin
+  require "globalid"
+rescue LoadError
+  # If GlobalID is not available, we skip the GlobalID integration.
+  return
+end
+
+module ActiveRecord
+  module Bitemporal
+    module GlobalID
+      include ::GlobalID::Identification
+
+      def to_global_id(options = {})
+        super(options.merge(app: "bitemporal"))
+      end
+      alias to_gid to_global_id
+
+      class BitemporalLocator < ::GlobalID::Locator::BaseLocator
+        private
+
+        # @override https://github.com/rails/globalid/blob/v1.2.1/lib/global_id/locator.rb#L203
+        def primary_key(model_class)
+          model_class.respond_to?(:bitemporal_id_key) ? model_class.bitemporal_id_key : :id
+        end
+      end
+    end
+  end
+end
+
+# BiTemporal Data Model requires default scope, so `UnscopedLocator` cannot be used.
+GlobalID::Locator.use :bitemporal, ActiveRecord::Bitemporal::GlobalID::BitemporalLocator.new

data/lib/activerecord-bitemporal/scope.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "activerecord-bitemporal/bitemporal_checker"
+
 module ActiveRecord::Bitemporal
   module NodeBitemporalInclude
     refine String do
@@ -158,7 +160,13 @@ module ActiveRecord::Bitemporal
     # @see https://github.com/rails/rails/blob/v7.1.3.4/activerecord/lib/active_record/relation/delegation.rb#L117
     delegate :bitemporal_value, :bitemporal_value=, :valid_datetime, :valid_date,
              :transaction_datetime, :bitemporal_option, :bitemporal_option_merge!,
-             :build_arel, :primary_key, to: :scope
+             :build_arel, to: :scope
+
+    if ActiveRecord.version < Gem::Version.new("8.0.0")
+      delegate :primary_key, to: :scope
+    else
+      delegate :ids, :exists?, to: :scope
+    end
   end
 
   module Scope

data/lib/activerecord-bitemporal/version.rb

@@ -2,6 +2,6 @@
 
 module ActiveRecord
   module Bitemporal
-    VERSION = "6.0.0"
+    VERSION = "7.0.0"
   end
 end