rails-uuid-pk 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 712bd0217dd06a7b87d855696311146bc08bd1ee9f45b52ce1ece11a251a284c
-  data.tar.gz: 8d702575c6177fe8074ea8b88bb650b72d785e83645b02a0a41ace3ea048cc76
+  metadata.gz: 5c8d9367ce6e034ff5ecc94e41e482b38e56f0886fd7cbbcb73a43bd948e3f96
+  data.tar.gz: 972cf5ee47c2c0ca1120decb6f35e16da2e62d9b2e2d2cee8b171fb883bdc003
 SHA512:
-  metadata.gz: 78d45ed25bc2ab1cedc26d2bb64df821ddc1f4e99bf06cc65d3ac595d87a9bad365e458de8ef8c280ee4518cc96d0c5373dc3e569d364f30f2ad0b700cffc029
-  data.tar.gz: d1230736212301ebf5b6d9816fa3c1cd05c92c095290153437cffb9db3ef6340d040553736c370a895aa4ab99c472e0f09503fa6f4e1347b98a442274bbbed12
+  metadata.gz: fd95a444a62a9b337c0c6033530fe75db6e0873750bb8e43f1ac47a6bfdee4443b5139c9f79aa4b432752fcfdd54a32adfca598e6a1dfe5669b8085c2eb2b7cf
+  data.tar.gz: ad6c1eb9f0fed6a62b15930fca2a1e67b09d0c4940314f5fca8032e130637619105159b49f5dd37e96ceb2ccff7ad057ff30b81ae044a2d864e752dec748dde3

data/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v1.0.0.html).
 
+## [0.10.0] - 2026-01-15
+
+### Added
+- **Migration Method `t.uuid`**: Added support for explicit `t.uuid` column definition in migrations for SQLite and MySQL, ensuring consistency with schema dumping and loading
+
+### Fixed
+- **Documentation URI**: Corrected documentation URI in gemspec to use proper RubyDoc.info format
+- **Schema Dumping for SQLite/MySQL**: Fixed "Unknown type" errors during `db:schema:dump` and `NoMethodError` during schema loading by implementing proper type registration and dumper overrides for non-native UUID adapters
+
+### Documentation
+- **Performance Claims**: Corrected UUID generation throughput from ~10,000 to ~800,000 UUIDs/second in README.md and PERFORMANCE.md to reflect actual benchmark results
+- **Architecture Documentation**: Updated ARCHITECTURE.md with accurate database adapter descriptions, corrected PostgreSQL native support vs extension usage, and added proper code examples for MySQL/SQLite extensions
+- **Agent Development Guide**: Updated AGENTS.md with current project structure, test organization, code architecture details, and Rails version requirements
+- **Security Documentation**: Updated SECURITY.md supported versions table to reflect current version 0.10.0 as actively supported
+
 ## [0.9.0] - 2026-01-14
 
 ### Added

data/README.md

@@ -27,7 +27,7 @@ Automatically use UUID v7 for **all primary keys** in Rails applications. Works
 Add to your `Gemfile`:
 
 ```ruby
-gem "rails-uuid-pk", "~> 0.9"
+gem "rails-uuid-pk", "~> 0.10"
 ```
 
 Then run:
@@ -94,7 +94,7 @@ end
 
 ## Performance Overview
 
-**Generation**: ~10,000 UUIDs/second with cryptographic security and monotonic ordering
+**Generation**: ~800,000 UUIDs/second with cryptographic security and monotonic ordering
 
 | Database | Storage | Index Performance | Notes |
 |----------|---------|-------------------|--------|
@@ -214,7 +214,7 @@ DB=sqlite ./bin/test test/uuid/type_test.rb
 gem build rails_uuid_pk.gemspec
 
 # Install locally for testing
-gem install rails-uuid-pk-0.9.0.gem
+gem install rails-uuid-pk-0.10.0.gem
 ```
 
 ### Database Setup

data/lib/rails_uuid_pk/migration_helpers.rb

@@ -162,6 +162,17 @@ module RailsUuidPk
       # Alias for add_reference method (ActiveRecord compatibility)
       alias_method :add_belongs_to, :add_reference
 
+      # Defines a UUID column in a table.
+      #
+      # @param args [Array] Arguments passed to the column method
+      # @param options [Hash] Options passed to the column method
+      # @return [void]
+      def uuid(*args, **options)
+        if respond_to?(:column)
+          column(*args, :uuid, **options)
+        end
+      end
+
       private
 
       # Checks if a table uses UUID primary keys.

data/lib/rails_uuid_pk/mysql2_adapter_extension.rb

@@ -25,6 +25,17 @@ module RailsUuidPk
       )
     end
 
+    # Checks if a type is valid for this adapter.
+    #
+    # Overrides ActiveRecord's valid_type? to recognize the custom UUID type.
+    #
+    # @param type [Symbol] The type to check
+    # @return [Boolean] true if the type is valid
+    def valid_type?(type)
+      return true if type == :uuid
+      super
+    end
+
     # Registers UUID type handlers in the adapter's type map.
     #
     # @param m [ActiveRecord::ConnectionAdapters::AbstractAdapter::TypeMap] The type map to register with
@@ -51,5 +62,16 @@ module RailsUuidPk
       super
       register_uuid_types
     end
+
+    # Overrides type dumping to properly handle UUID columns.
+    #
+    # @param column [ActiveRecord::ConnectionAdapters::Column] The column to dump
+    # @return [Array] The type and options for the schema dump
+    def type_to_dump(column)
+      if column.type == :uuid
+        return [ :uuid, {} ]
+      end
+      super
+    end
   end
 end

data/lib/rails_uuid_pk/sqlite3_adapter_extension.rb

@@ -25,6 +25,17 @@ module RailsUuidPk
       )
     end
 
+    # Checks if a type is valid for this adapter.
+    #
+    # Overrides ActiveRecord's valid_type? to recognize the custom UUID type.
+    #
+    # @param type [Symbol] The type to check
+    # @return [Boolean] true if the type is valid
+    def valid_type?(type)
+      return true if type == :uuid
+      super
+    end
+
     # Registers UUID type handlers in the adapter's type map.
     #
     # @param m [ActiveRecord::ConnectionAdapters::AbstractAdapter::TypeMap] The type map to register with
@@ -53,5 +64,16 @@ module RailsUuidPk
       super unless open_transactions > 0
       register_uuid_types
     end
+
+    # Overrides type dumping to properly handle UUID columns.
+    #
+    # @param column [ActiveRecord::ConnectionAdapters::Column] The column to dump
+    # @return [Array] The type and options for the schema dump
+    def type_to_dump(column)
+      if column.type == :uuid
+        return [ :uuid, {} ]
+      end
+      super
+    end
   end
 end

data/lib/rails_uuid_pk/version.rb

@@ -7,6 +7,6 @@ module RailsUuidPk
   #
   # @return [String] The current version
   # @example
-  #   RailsUuidPk::VERSION # => "0.9.0"
-  VERSION = "0.9.0"
+  #   RailsUuidPk::VERSION # => "0.10.0"
+  VERSION = "0.10.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-uuid-pk
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Joon Lee
@@ -163,6 +163,7 @@ metadata:
   homepage_uri: https://github.com/seouri/rails-uuid-pk
   source_code_uri: https://github.com/seouri/rails-uuid-pk
   changelog_uri: https://github.com/seouri/rails-uuid-pk/blob/main/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/rails-uuid-pk
 rdoc_options: []
 require_paths:
 - lib