sqlite_crypto 2.1.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31acfd48736d083cd848127dcffbfefc620be1e3694e3f69e19b0d0c09d3aad9
-  data.tar.gz: 59daf83e4a32c19a97e7dc2a311e395a46a70f40222963c9e271575d82ac4c04
+  metadata.gz: 5092437393d977d0bc5bd3ab75fec48c2518ff2ab0296bf6bb1abc42cdd1dfd9
+  data.tar.gz: 85e2ba284a68ee0cdf113895771788e5d60ee324631672f414f96756f08c5a9c
 SHA512:
-  metadata.gz: '03968e8bd73633bf3a5150a46b2fe72f84a11ece19f735c4be8406dd954a3168e38cca89394b547e8e8d3f728e6d211933b1fd13792a5bdcebdfc522287547c8'
-  data.tar.gz: bbbd062951f49856e4b74cd90c4bb8a67c5d2dab2547bebffb40643b1eb4b14c0a6c0f269ed8e53356b3e09922541d2c8c95fdc8d64a0e1aa0d6d82d09a752e7
+  metadata.gz: 66a702bb87cf9ebb082a4f0a727df6fd3f8232e47295cf5d56d3e7a03d7604c29d7692ddd556753a4cf9a0e1076885273b748c65e67adede97f0cc8e44e7718e
+  data.tar.gz: 2d6c01a90e63dfd79947c010de863c0b0180c83056d5c72a7d9a6dd0a3e901c5ecebb6ff91c2c78c589e22a108b3183d9d382be612346ac5f3c23262fffd342d

data/CHANGELOG.md

@@ -5,6 +5,38 @@ 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/v2.0.0.html).
 
+## [2.3.0] - 2026-07-15
+
+### Security
+- Refreshed lockfiles, picking up fixes for transitive CVEs in `sqlite3`, `nokogiri`, `json`, `crass`, and `concurrent-ruby`
+
+### Changed
+- Updated `.ruby-version` from `4.0.3` to `4.0.6`
+- CI: cache bundler installs per Rails version, run `bundler-audit` from the bundle, and drop the empty coverage-threshold step
+- Narrowed the runtime dependency from `rails` to `activerecord` + `railties`, dropping the `action_text-trix` pin it required
+- **Tightened ULID validation**: rejects `I`, `L`, `O`, `U`, which Crockford base32 excludes
+
+### Fixed
+- **Reads no longer raise on malformed legacy IDs**: `Type::Base#deserialize` returns stored values as-is instead of re-validating them, so a corrupted row no longer crashes every read of it. Writes (`#cast`/`#serialize`) still validate strictly
+- **Primary-key type cache invalidation**: `_sqlite_crypto_pk_type` now clears on `reset_column_information` instead of going stale after a migration
+- **Adapter guard for auto ID generation**: primary-key detection now only applies to SQLite3 connections, not any string(36/26) primary key regardless of adapter
+- **`references`/`belongs_to` with `to_table` and `foreign_key: true`**: the foreign key now targets the correct table instead of the pluralized association name
+
+## [2.2.0] - 2026-05-08
+
+### Added
+- **Theme-aware README logo**: Added dark-mode/light-mode logo switching via `<picture>` in `README.md`
+- **Shared ID type mapping module**: Added `SqliteCrypto::IdTypes` to centralize UUID/ULID limit and type detection logic
+- Unit specs for `SqliteCrypto::IdTypes`
+
+### Changed
+- Refactored schema dumper, migration helpers, model extensions, and SQLite adapter extension to use `SqliteCrypto::IdTypes`
+- Updated `.ruby-version` from `4.0.0` to `4.0.3`
+- Refreshed README badges and compatibility notes
+
+### Fixed
+- Removed repeated migration fixture loading warning by replacing `load` with `require_relative` in migration integration spec
+
 ## [2.1.0] - 2026-03-22
 
 ### Added
@@ -156,4 +188,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - Rails version compatibility for migrations (supports Rails 7.1 through 8.1)
 - Schema dumper prepend timing by loading sqlite3_adapter explicitly
-- ULID foreign key detection with proper table name pluralization
+- ULID foreign key detection with proper table name pluralization

data/README.md

@@ -1,11 +1,28 @@
-# SQLite Crypto
-
-[![Version](https://img.shields.io/badge/version-2.0.2-blue.svg)](https://github.com/bart-oz/sqlite_crypto/releases)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.txt)
-[![types supported](https://img.shields.io/badge/types-ULID,_UUIDv7/v4-brightgreen.svg)](https://github.com/bart-oz/sqlite_crypto)
-[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](https://github.com/bart-oz/sqlite_crypto/actions)
-[![Coverage](https://img.shields.io/badge/coverage-98.06%25-brightgreen.svg)](https://github.com/bart-oz/sqlite_crypto/actions)
-[![Status](https://img.shields.io/badge/status-active-success.svg)](https://github.com/bart-oz/sqlite_crypto)
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset=".github/workflows/logo_dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset=".github/workflows/logo_light.svg">
+    <img alt="sqlite_crypto logo" src=".github/workflows/logo_light.svg" width="220">
+  </picture>
+</p>
+
+<p align="center">
+  <a href="https://github.com/bart-oz/sqlite_crypto/releases">
+    <img src="https://img.shields.io/badge/version-2.3.0-blue.svg" alt="Version">
+  </a>
+  <a href="LICENSE.txt">
+    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
+  </a>
+  <a href="https://github.com/bart-oz/sqlite_crypto">
+    <img src="https://img.shields.io/badge/types-ULID,_UUIDv7/v4-brightgreen.svg" alt="Types supported">
+  </a>
+  <a href="https://github.com/bart-oz/sqlite_crypto/actions/workflows/ci.yml">
+    <img src="https://github.com/bart-oz/sqlite_crypto/actions/workflows/ci.yml/badge.svg" alt="Tests">
+  </a>
+  <a href="https://github.com/bart-oz/sqlite_crypto">
+    <img src="https://img.shields.io/badge/status-active-success.svg" alt="Status">
+  </a>
+</p>
 
 ## Overview
 
@@ -24,11 +41,11 @@ end
 - Automatic foreign key type detection
 - Model-level ID generation
 - Clean schema.rb output
-- Zero external dependencies
+- Lightweight runtime dependencies (`activerecord`, `railties`, `sqlite3`, `ulid` — no full `rails` metagem)
 
 ## Compatibility
 
-**Ruby & Rails:**
+**Ruby & Rails tested in CI:**
 
 |       | Rails 7.1 | Rails 7.2 | Rails 8.0 | Rails 8.1 |
 |-------|-----------|-----------|-----------|-----------|
@@ -38,6 +55,11 @@ end
 | Ruby 3.4 | ✓ | ✓ | ✓ | ✓ |
 | Ruby 4.0 | ✓ | ✓ | ✓ | ✓ |
 
+**Upstream lifecycle note (as of 2026-07-15):**
+- Ruby 3.1 is EOL; Ruby 3.2 is EOL. Latest stable Ruby is 4.0.6.
+- Rails 7.1 is EOL.
+- Rails 7.2 is security-fixes-only; Rails 8.0 and 8.1 are actively supported.
+
 **UUID Versions:**
 
 | Version | Ruby 3.1/3.2 | Ruby 3.3+ |
@@ -237,4 +259,4 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/bart-o
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](LICENSE.txt).
+The gem is available as open source under the terms of the [MIT License](LICENSE.txt).

data/lib/sqlite_crypto/id_types.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module SqliteCrypto
+  module IdTypes
+    UUID_LENGTH = 36
+    ULID_LENGTH = 26
+
+    TYPE_TO_LIMIT = {
+      uuid: UUID_LENGTH,
+      ulid: ULID_LENGTH
+    }.freeze
+    LIMIT_TO_TYPE = TYPE_TO_LIMIT.invert.freeze
+
+    module_function
+
+    def string_limit_for(type)
+      TYPE_TO_LIMIT[type]
+    end
+
+    def type_from_string_limit(limit)
+      LIMIT_TO_TYPE[limit]
+    end
+
+    def type_from_sql_type(sql_type)
+      case sql_type.to_s.downcase
+      when "varchar(#{UUID_LENGTH})", "uuid" then :uuid
+      when "varchar(#{ULID_LENGTH})", "ulid" then :ulid
+      end
+    end
+  end
+end

data/lib/sqlite_crypto/migration_helpers.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "active_record/connection_adapters/sqlite3_adapter"
+require "sqlite_crypto/id_types"
 
 module SqliteCrypto
   module MigrationHelpers
@@ -17,11 +18,17 @@ module SqliteCrypto
     module References
       def references(*args, **options)
         ref_name = args.first
-        ref_table = options.delete(:to_table) || ref_name.to_s.pluralize
+        explicit_to_table = options.delete(:to_table)
+        ref_table = explicit_to_table || ref_name.to_s.pluralize
 
         if (primary_key_type = detect_primary_key_type(ref_table))
           options[:type] ||= :string
-          options[:limit] ||= (primary_key_type == :uuid) ? 36 : 26
+          options[:limit] ||= IdTypes.string_limit_for(primary_key_type)
+        end
+
+        if explicit_to_table && options[:foreign_key]
+          fk_options = options[:foreign_key].is_a?(Hash) ? options[:foreign_key] : {}
+          options[:foreign_key] = fk_options.reverse_merge(to_table: explicit_to_table)
         end
 
         super
@@ -43,10 +50,7 @@ module SqliteCrypto
         pk_column = find_primary_key_column(table_name, conn)
         return nil unless pk_column
 
-        case pk_column.sql_type.downcase
-        when "varchar(36)", "uuid" then :uuid
-        when "varchar(26)", "ulid" then :ulid
-        end
+        IdTypes.type_from_sql_type(pk_column.sql_type)
       end
 
       def find_primary_key_column(table_name, conn)

data/lib/sqlite_crypto/model_extensions.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "ulid"
+require "sqlite_crypto/id_types"
 
 module SqliteCrypto
   module ModelExtensions
@@ -49,11 +50,17 @@ module SqliteCrypto
         @_sqlite_crypto_pk_type = _detect_sqlite_crypto_pk_type
       end
 
+      def reset_column_information
+        remove_instance_variable(:@_sqlite_crypto_pk_type) if defined?(@_sqlite_crypto_pk_type)
+        super
+      end
+
       private
 
       def _detect_sqlite_crypto_pk_type
         return nil if abstract_class?
         return nil unless table_exists?
+        return nil unless connection.adapter_name == "SQLite"
 
         pk = primary_key
         return nil unless pk
@@ -62,10 +69,7 @@ module SqliteCrypto
         return nil unless column
         return nil unless column.type == :string
 
-        case column.limit
-        when 36 then :uuid
-        when 26 then :ulid
-        end
+        IdTypes.type_from_string_limit(column.limit)
       rescue ActiveRecord::StatementInvalid
         nil
       end

data/lib/sqlite_crypto/schema_dumper.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "sqlite_crypto/id_types"
+
 module SqliteCrypto
   module SchemaDumper
     private
@@ -7,11 +9,10 @@ module SqliteCrypto
     def column_spec_for_primary_key(column)
       return super unless column.name == "id" && column.type == :string
 
-      case column.limit
-      when 36 then {id: :uuid}
-      when 26 then {id: :ulid}
-      else super
-      end
+      primary_key_type = IdTypes.type_from_string_limit(column.limit)
+      return super unless primary_key_type
+
+      {id: primary_key_type}
     end
   end
 end

data/lib/sqlite_crypto/sqlite3_adapter_extension.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
+require "sqlite_crypto/id_types"
+
 module SqliteCrypto
   module Sqlite3AdapterExtension
     def native_database_types
       super.merge(
-        uuid: {name: "varchar", limit: 36},
-        ulid: {name: "varchar", limit: 26}
+        uuid: {name: "varchar", limit: IdTypes::UUID_LENGTH},
+        ulid: {name: "varchar", limit: IdTypes::ULID_LENGTH}
       )
     end
   end

data/lib/sqlite_crypto/type/base.rb

@@ -4,8 +4,7 @@ module SqliteCrypto
   module Type
     class Base < ActiveRecord::Type::String
       def deserialize(value)
-        return if value.nil?
-        cast(value)
+        value&.to_s
       end
 
       def cast(value)
@@ -25,7 +24,7 @@ module SqliteCrypto
       end
 
       def changed_in_place?(raw_old_value, new_value)
-        cast(raw_old_value) != cast(new_value)
+        deserialize(raw_old_value) != cast(new_value)
       end
 
       private

data/lib/sqlite_crypto/type/ulid.rb

@@ -5,7 +5,8 @@ require "sqlite_crypto/type/base"
 module SqliteCrypto
   module Type
     class ULID < Base
-      ULID_PATTERN = /\A[0-7][0-9A-Z]{25}\z/i
+      # Crockford base32 excludes I, L, O, U to avoid confusion with 1, 0.
+      ULID_PATTERN = /\A[0-7][0-9A-HJKMNP-TV-Z]{25}\z/i
 
       def type
         :ulid

data/lib/sqlite_crypto/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module SqliteCrypto
-  VERSION = "2.1.0"
+  VERSION = "2.3.0"
   RUBY_MINIMUM_VERSION = "3.1.0"
   RAILS_MINIMUM_VERSION = "7.1.0"
 end

data/lib/sqlite_crypto.rb

@@ -5,6 +5,7 @@ require "sqlite_crypto/configuration"
 require "sqlite_crypto/railtie" if defined?(Rails)
 require "sqlite_crypto/schema_dumper" if defined?(ActiveRecord)
 require "sqlite_crypto/schema_definitions"
+require "sqlite_crypto/id_types"
 require "sqlite_crypto/generators/uuid"
 
 module SqliteCrypto

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqlite_crypto
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.3.0
 platform: ruby
 authors:
 - BartOz
@@ -10,7 +10,21 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.1.0
+- !ruby/object:Gem::Dependency
+  name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,8 +67,7 @@ dependencies:
         version: '1.0'
 description: UUID and ULID primary key support for Rails with SQLite3. Provides automatic
   type registration, validation, foreign key detection, and clean schema generation.
-  Supports UUIDv4 (random), UUIDv7 (time-ordered), and ULID (compact, time-sortable)
-  with zero external dependencies.
+  Supports UUIDv4 (random), UUIDv7 (time-ordered), and ULID (compact, time-sortable).
 email:
 - bartek.ozdoba@gmail.com
 executables: []
@@ -69,6 +82,7 @@ files:
 - lib/sqlite_crypto.rb
 - lib/sqlite_crypto/configuration.rb
 - lib/sqlite_crypto/generators/uuid.rb
+- lib/sqlite_crypto/id_types.rb
 - lib/sqlite_crypto/migration_helpers.rb
 - lib/sqlite_crypto/model_extensions.rb
 - lib/sqlite_crypto/railtie.rb
@@ -98,7 +112,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.16
 specification_version: 4
 summary: UUID (v4/v7) and ULID primary keys for Rails + SQLite3
 test_files: []