tina4ruby 3.10.85 → 3.10.86

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e5521375e695d48e70b9f86d6a5c7abb62f9e887ee02ab975308bd51a99ee91
-  data.tar.gz: fd6c0fb85f91def5fbae4996752c70c36f184cfbec1f61cbc4d3949a8109a4fc
+  metadata.gz: c48ff6ca420828c13d58b56461236b1cc88f183d8c26ef07d659a5fdbae0387b
+  data.tar.gz: c97876faf8d439dbb7c843708dceaac560c68261d5ba3e10c370b5986e8f0458
 SHA512:
-  metadata.gz: 3d4a4d7db8e8fa3b87df07f19ab708ef9a3aebc00d40a5280adf7637869ef9ea40a4b1afce22aa3fd83bfdc6de073fb3eaa34c4842bdc5e6dedf2947758c6cd9
-  data.tar.gz: fdb5d4fd739f8926f8ec6cbed5d12691219d8938217bc7f3234fa8e1d166487ed8f12095c45e5dd128a3782412b1ef0685d85901e7972db05a0565e48baea4d6
+  metadata.gz: 81043f5493f03b8abe8fed8291bba748df5c770cd711a8825837cff14ee9ab855d30736fcf4d2b5f0d5dea9148b6e2b29fbc4fb44c6bbbeb1918741be0d219bc
+  data.tar.gz: b918fb9ee51de4a14412ec5b5f0503da65ff7669244c6ff1653c77ab2af02898e4cafc73e7f3b2c95ab07f927f61415cc9318882292d38e2582e55b8eb140d93

data/lib/tina4/field_types.rb

@@ -79,6 +79,67 @@ module Tina4
         register_field(name, :json, nullable: nullable, default: default)
       end
 
+      # Declare a foreign key integer column and auto-wire relationships.
+      #
+      # Automatically:
+      #   - Registers an integer field for the column
+      #   - Calls belongs_to on this class (strip _id suffix for association name)
+      #   - Calls has_many on the referenced class (if already loaded)
+      #
+      # @param name [Symbol]  Column name (e.g. :user_id)
+      # @param references [Class, String]  Referenced model class or its name
+      # @param related_name [Symbol, String, nil]  Override the has-many name on the referenced model
+      #
+      # Example:
+      #   class Post < Tina4::ORM
+      #     integer_field :id, primary_key: true
+      #     foreign_key_field :user_id, references: User
+      #   end
+      #   # post.user  → belongs_to auto-wired
+      #   # user.posts → has_many auto-wired
+      def foreign_key_field(name, references:, related_name: nil, **options)
+        register_field(name, :integer, **options)
+
+        # Derive association name: strip _id suffix
+        belongs_name = name.to_s.end_with?("_id") ? name.to_s[0..-4].to_sym : name.to_sym
+
+        # Wire belongs_to on this class
+        belongs_to(belongs_name, class_name: references.to_s.split("::").last, foreign_key: name.to_s) if respond_to?(:belongs_to, true)
+
+        # Wire has_many on referenced class (if already a loaded Class)
+        if references.is_a?(Class) && references.respond_to?(:has_many, true)
+          hm_name = (related_name || "#{self.name.split("::").last.downcase}s").to_sym
+          references.has_many(hm_name, class_name: self.name.split("::").last, foreign_key: name.to_s)
+        end
+
+        # Register for deferred wiring (resolves when referenced class is later loaded)
+        @@_fk_registry ||= {}
+        ref_name = references.is_a?(Class) ? references.name.split("::").last : references.to_s.split("::").last
+        @@_fk_registry[ref_name] ||= []
+        hm_key = (related_name || "#{self.name.split("::").last.downcase}s").to_s
+        @@_fk_registry[ref_name] << {
+          declaring_class: self,
+          has_many_name: hm_key.to_sym,
+          foreign_key: name.to_s
+        }
+      end
+
+      # Apply any deferred FK-registry has_many wiring for this class.
+      # Called automatically when a class that is referenced by a ForeignKeyField is defined.
+      def apply_fk_registry!
+        class_simple_name = self.name.split("::").last
+        return unless defined?(@@_fk_registry) && @@_fk_registry.key?(class_simple_name)
+
+        @@_fk_registry[class_simple_name].each do |entry|
+          next if entry[:applied]
+
+          has_many(entry[:has_many_name],
+                   class_name: entry[:declaring_class].name.split("::").last,
+                   foreign_key: entry[:foreign_key]) if respond_to?(:has_many, true)
+          entry[:applied] = true
+        end
+      end
+
       private
 
       def register_field(name, type, **options)

data/lib/tina4/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tina4
-  VERSION = "3.10.85"
+  VERSION = "3.10.86"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.10.85
+  version: 3.10.86
 platform: ruby
 authors:
 - Tina4 Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-08 00:00:00.000000000 Z
+date: 2026-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack