iry 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ca6d5b931545ba2bb0b9f1e9e7ad77da308e7d0ffe8a64d1df2c1e6378cd1a7
-  data.tar.gz: 4747d18e4a249735907597277bad301e9177dffa5aa00e3410355be13d523683
+  metadata.gz: 7ba546c69426b3b1d4c530d79ed5cfed56b5f3ea5dfe629a37b5061a90213b33
+  data.tar.gz: 65aa3e75c36b7fae90d81e20126c0bc134ff16ee7ddc009349754cd17cc14c29
 SHA512:
-  metadata.gz: c2b72c6a64b044c606b3940181971a28fd90fdb1ba7859566adb9f5b7ac17f58aa46544908d06715dbc15105972ee0b272ac65d608dd06ee42fd829799c3ff95
-  data.tar.gz: 2f5c703a19785a8e7fc5689354c80b91d3d3658f00a031edbddad7ca06c36094959f494bbc157c8b40bce4fd3655fd37fa5769ec1fc02e6b7c74524118ebc37b
+  metadata.gz: ef79029f7a9f7a51dbb20964ad407ea146417a10de1c7c4d9149a9d83acece6e9db2abe2f3ca6779c684e31554bea9e22e6496579b5cc16eaf53ec787d6b4d17
+  data.tar.gz: a7daca1aca5c175224affa28884e83c19fcdfd4b01369c8b28f6cea2cfd5cea476fca77d433eb84fa53518a3812c03bc12448617bbd2a104b49dcaec1757cf44

data/VERSION

@@ -1 +1 @@
-0.5.1
+0.7.0

data/db/schema.pgsql

@@ -3,14 +3,27 @@ create extension if not exists "btree_gist";
 
 create table if not exists users (
 	id uuid primary key default gen_random_uuid(),
-  unique_text text unique not null default gen_random_uuid()::text check (unique_text != 'invalid'),
+  unique_text text not null default gen_random_uuid()::text,
   exclude_text text not null default gen_random_uuid()::text,
-	user_id uuid references users (id),
-  untracked_text text unique not null default gen_random_uuid()::text,
+	user_id uuid,
+  untracked_text text not null default gen_random_uuid()::text,
   free_text text not null default '',
-	friend_user_id uuid references users (id),
+	friend_user_id uuid,
 	created_at timestamp(6) not null,
 	updated_at timestamp(6) not null,
 	-- acts similar to unique constraint
 	exclude using gist (exclude_text with =)
 );
+
+create unique index if not exists
+	index_users_on_unique_text on users(unique_text);
+create unique index if not exists
+	index_users_on_untracked_text on users(untracked_text);
+alter table users
+	add constraint chk_rails_15df0d7772 check (unique_text != 'invalid');
+alter table users
+	add constraint fk_rails_6d0b8b3c2f
+		foreign key (user_id) references users(id);
+alter table users
+	add constraint fk_rails_d3f200176b
+		foreign key (friend_user_id) references users(id);

data/lib/iry/constraint/check.rb

@@ -6,7 +6,13 @@ module Iry
       # @param table_name [String]
       # @return [String]
       def self.infer_name(key, table_name)
-        "#{table_name}_#{key}_check"
+        # PostgreSQL convention:
+        # "#{table_name}_#{key}_check"
+        # Rails convention
+        id = "#{table_name}_#{key}_chk"
+        hashed_id = OpenSSL::Digest::SHA256.hexdigest(id)[0..9]
+
+        "chk_rails_#{hashed_id}"
       end
 
       # @return [Symbol]
@@ -30,7 +36,7 @@ module Iry
       end
 
       # @param model [Handlers::Model]
-      # @return [void]
+      # @return [ActiveModel::Error]
       def apply(model)
         model.errors.add(key, message)
       end

data/lib/iry/constraint/exclusion.rb

@@ -30,7 +30,7 @@ module Iry
       end
 
       # @param model [Handlers::Model]
-      # @return [void]
+      # @return [ActiveModel::Error]
       def apply(model)
         model.errors.add(key, message)
       end

data/lib/iry/constraint/foreign_key.rb

@@ -6,7 +6,17 @@ module Iry
       # @param table_name [String]
       # @return [String]
       def self.infer_name(keys, table_name)
-        "#{table_name}_#{keys.join("_")}_fkey"
+        if keys.size > 1
+          # PostgreSQL convention:
+          return "#{table_name}_#{keys.join("_")}_fkey"
+        end
+
+        # Rails convention:
+        column = keys.first
+        id = "#{table_name}_#{column}_fk"
+        hashed_id = OpenSSL::Digest::SHA256.hexdigest(id)[0..9]
+
+        "fk_rails_#{hashed_id}"
       end
 
       # @return [<Symbol>]
@@ -35,7 +45,7 @@ module Iry
       end
 
       # @param model [Handlers::Model]
-      # @return [void]
+      # @return [ActiveModel::Error]
       def apply(model)
         model.errors.add(error_key, message)
       end

data/lib/iry/constraint/unique.rb

@@ -1,12 +1,32 @@
 module Iry
   module Constraint
     class Unique
+      MAX_INFER_NAME_BYTE_SIZE = 62
+
       # Infers the unique constraint name based on keys and table name
       # @param keys [<Symbol>]
       # @param table_name [String]
       # @return [String]
       def self.infer_name(keys, table_name)
-        "#{table_name}_#{keys.join("_")}_key"
+        # PostgreSQL convention:
+        # "#{table_name}_#{keys.join("_")}_key"
+
+        # Rails convention:
+        # index_trip_hikers_on_trip_id_and_hiker_card_id
+        # index_TABLENAME_on_COLUMN1_and_COLUMN2
+        name = "index_#{table_name}_on_#{keys.join("_and_")}"
+        if name.bytesize <= MAX_INFER_NAME_BYTE_SIZE
+          return name
+        end
+
+        digest = OpenSSL::Digest::SHA256.hexdigest(name)[0..9]
+        hashed_id = "_#{digest}"
+        name = "idx_on_#{keys.join("_")}"
+
+        short_limit = max_index_name_size - hashed_identifier.bytesize
+        short_name = name.mb_chars.limit(short_limit).to_s
+
+        "#{short_name}#{hashed_identifier}"
       end
 
       # @return [<Symbol>]
@@ -35,7 +55,7 @@ module Iry
       end
 
       # @param model [Handlers::Model]
-      # @return [void]
+      # @return [ActiveModel::Error]
       def apply(model)
         model.errors.add(error_key, message)
       end

data/lib/iry/constraint.rb

@@ -6,7 +6,7 @@ module Iry
     # Sets validation errors on the model
     # @abstract
     # @param model [Handlers::Model]
-    # @return [void]
+    # @return [ActiveModel::Error]
     def apply(model)
     end
 

data/lib/iry/handlers/null.rb

@@ -15,9 +15,9 @@ module Iry
       # Return always false, failing to handle any constraint
       # @param err [ActiveRecord::StatementInvalid]
       # @param model [Model] should inherit {ActiveRecord::Base} and`include Iry` to match the interface
-      # @return [Boolean]
+      # @return [nil, ActiveModel::Error]
       def handle(err, model)
-        return false
+        return nil
       end
     end
   end

data/lib/iry/handlers/pg.rb

@@ -36,7 +36,9 @@ module Iry
       # Appends constraint errors as model errors
       # @param err [ActiveRecord::StatementInvalid]
       # @param model [Model] should inherit {ActiveRecord::Base} and`include Iry` to match the interface
-      # @return [void]
+      # @return [nil, ActiveModel::Error] if handled constraint, returns the
+      #   error attached to the model. If constraint wasn't handled or handling
+      #   failed, `nil` is returned
       def handle(err, model)
         pgerr = err.cause
         constraint_name_msg = pgerr.result.error_field(::PG::Constants::PG_DIAG_MESSAGE_PRIMARY)
@@ -44,12 +46,10 @@ module Iry
         constraint_name = match[1]
         constraint = model.class.constraints[constraint_name]
         if constraint.nil?
-          return false
+          return nil
         end
 
-        constraint.apply(model)
-
-        return true
+        return constraint.apply(model)
       end
     end
   end

data/lib/iry/handlers.rb

@@ -12,7 +12,8 @@ module Iry
       # @abstract
       # @param err [ActiveRecord::StatementInvalid] possible constraint error to handle
       # @param model [Model]
-      # @return [Boolean] true if this database handler handled the constraint error
+      # @return [nil, ActiveModel::Error] `nil` if couldn't handle the error,
+      #   otherwise the {ActiveModel::Error} added to the model
       def handle(err, model)
       end
     end

data/lib/iry/patch.rb

@@ -6,7 +6,7 @@ module Iry
     # @return [Boolean] true if successful
     def create_or_update(...)
       result = false
-      Iry.handle_constraints!(self) { result = super }
+      TransformConstraints.nested_constraints!(self) { result = super }
       result
     end
   end

data/lib/iry/transform_constraints.rb

@@ -0,0 +1,139 @@
+module Iry
+  # Implementation of {Iry} methods, helps ensuring the main module focus on
+  # documentation
+  module TransformConstraints
+    extend self
+
+    # @param model [Handlers::Model]
+    # @yield
+    # @return [nil, Handlers::Model]
+    def handle_constraints(model, &block)
+      handle_constraints!(model, &block)
+    rescue StatementInvalid
+      return nil
+    end
+
+    # @param model [Handlers::Model]
+    # @yield
+    # @return [Handlers::Model]
+    def handle_constraints!(model, &block)
+      # Allows checking if Iry has been activated (handling).
+      # Number is used to support nested handle_constraints!
+      Thread.current[:iry] ||= 0
+      Thread.current[:iry] += 1
+
+      nested_constraints!(model, &block)
+    rescue StatementInvalid => err
+      # Imports errors from "nested" models back into the parent, to ensure
+      # `errors` is populated and the record is considered invalid
+
+      # Skip if error has been added to the same object being handled
+      if err.record.object_id == model.object_id
+        raise
+      end
+
+      # Adds the error only if it hasn't been added already
+      already_imported = model
+        .errors
+        .each
+        .lazy
+        .select { |ae| ae.respond_to?(:inner_error) }
+        .map { |ae| ae.inner_error }
+        .include?(err.error)
+      if !already_imported
+        model.errors.import(err.error)
+      end
+
+      raise
+    ensure
+      # "Pop" handle_constraints! usage, when 0, no constraint handling should
+      # happen
+      Thread.current[:iry] -= 1
+    end
+
+    # Tracks constraints of models saved as a consequence of saving another
+    # model. This usually represents a situation of model using
+    # `accepts_nested_attributes_for`
+    # @param model [Handlers::Model]
+    # @yield
+    # @return [Handlers::Model]
+    # @private
+    def nested_constraints!(model, &block)
+      raise ArgumentError, "Block required" if block.nil?
+
+      block.()
+
+      return model
+    rescue ActiveRecord::StatementInvalid => err
+      # Exit immediately if Iry hasn't been activated
+      if Thread.current[:iry].nil? || Thread.current[:iry] == 0
+        raise
+      end
+
+      # Exception might be an unknown constraint that is not handled by Iry
+      # yet. If that's the case, Null handler will ensure that everything
+      # proceeds as if Iry wasn't involved
+      handler = Handlers::Null
+      case
+      when Handlers::PG.handle?(err)
+        handler = Handlers::PG
+      end
+
+      model_error = handler.handle(err, model)
+
+      # This constraint is not handled by Iry and should raise normally
+      if model_error.nil?
+        raise
+      end
+
+      raise(
+        StatementInvalid.new(
+          err.message,
+          sql: err.sql,
+          binds: err.binds,
+          record: model,
+          error: model_error
+        )
+      )
+    end
+
+    # @param model [Handlers::Model]
+    # @return [Boolean]
+    def save(model, ...)
+      success = nil
+      constraint_model = handle_constraints(model) { success = model.save(...) }
+
+      if constraint_model
+        return success
+      end
+
+      return false
+    end
+
+    # @param model [Handlers::Model]
+    # @return [true]
+    # @raise [ConstraintViolation]
+    # @raise [ActiveRecord::RecordInvalid]
+    def save!(model, ...)
+      constraint_model = handle_constraints(model) { model.save!(...) }
+
+      if constraint_model
+        return true
+      end
+
+      raise ConstraintViolation.new(model)
+    end
+
+    # @param model [Handlers::Model]
+    # @return [Handlers::Model]
+    def destroy(model)
+      constraint_result = handle_constraints(model) { model.destroy }
+
+      if constraint_result.nil?
+        return false
+      end
+
+      return constraint_result
+    end
+  end
+end

data/lib/iry.rb

@@ -1,4 +1,5 @@
 require "active_record"
+require "openssl"
 
 require_relative "iry/version"
 require_relative "iry/handlers"
@@ -12,6 +13,7 @@ require_relative "iry/constraint/exclusion"
 require_relative "iry/constraint/foreign_key"
 require_relative "iry/constraint/unique"
 require_relative "iry/patch"
+require_relative "iry/transform_constraints"
 
 # Entrypoint of constraint validation, include in a class inheriting {ActiveRecord::Base} and the following class-level
 # methods will be available:
@@ -40,7 +42,8 @@ module Iry
   end
 
   # Raised when constraints have been violated and have been converted to
-  # model errors
+  # model errors, on {ActiveRecord::Base#save!} calls, to simulate a behavior
+  # similar to {ActiveRecord::RecordInvalid} when it's raised
   class ConstraintViolation < ActiveRecord::RecordInvalid
     include Error
 
@@ -50,8 +53,26 @@ module Iry
     #   @return [Handlers::Model]
   end
 
+  # Raised when constraints errors happen and go through Iry, even if these
+  # are not handled. This class inherits from {ActiveRecord::StatementInvalid}
+  # to maximize compatibility with existing code
   class StatementInvalid < ActiveRecord::StatementInvalid
     include Error
+
+    # @return [Handlers::Model] model affected by the constraint violation
+    attr_reader :record
+    # @return [ActiveModel::Error] error attached to the `record` for the
+    #   constraint violation
+    attr_reader :error
+
+    # @param message [nil, String]
+    # @param record [Handlers::Model]
+    # @param error [ActiveModel::Error]
+    def initialize(message = nil, record:, error:, **kwargs)
+      @record = record
+      @error = error
+      super(message, **kwargs)
+    end
   end
 
   # @param klass [Module]
@@ -88,9 +109,7 @@ module Iry
   #   result #=> nil
   #   fail_user.errors.details.fetch(:email) #=> [{error: :taken}]
   def self.handle_constraints(model, &block)
-    handle_constraints!(model, &block)
-  rescue StatementInvalid
-    return nil
+    TransformConstraints.handle_constraints(model, &block)
   end
 
   # Executes block and in case of constraints violations on `model`, block is
@@ -100,26 +119,7 @@ module Iry
   # @yield block must perform the save operation, usually with `save`
   # @return [Handlers::Model] returns `model` parameter
   def self.handle_constraints!(model, &block)
-    raise ArgumentError, "Block required" if block.nil?
-
-    block.()
-
-    return model
-  rescue ActiveRecord::StatementInvalid => err
-    handler = Handlers::Null
-    case
-    when Handlers::PG.handle?(err)
-      handler = Handlers::PG
-    end
-
-    is_handled = handler.handle(err, model)
-
-    # This constraint is not handled by Iry and should raise normally
-    if !is_handled
-      raise
-    end
-
-    raise StatementInvalid.new(err.message, sql: err.sql, binds: err.binds)
+    TransformConstraints.handle_constraints!(model, &block)
   end
 
   # Similar to {ActiveRecord::Base#save} but in case of constraint violations,
@@ -129,14 +129,7 @@ module Iry
   # @param model [Handlers::Model] model to save
   # @return [Boolean] `true` if successful
   def self.save(model, ...)
-    success = nil
-    constraint_model = handle_constraints(model) { success = model.save(...) }
-
-    if constraint_model
-      return success
-    end
-
-    return false
+    TransformConstraints.save(model, ...)
   end
 
   # Similar to {ActiveRecord::Base#save!} but in case of constraint violations,
@@ -151,13 +144,7 @@ module Iry
   # @raise [ActiveRecord::RecordInvalid] triggered when a validation error is
   #   raised, but not a constraint violation
   def self.save!(model, ...)
-    constraint_model = handle_constraints(model) { model.save!(...) }
-
-    if constraint_model
-      return true
-    end
-
-    raise ConstraintViolation.new(model)
+    TransformConstraints.save!(model, ...)
   end
 
   # Similar to {ActiveRecord::Base#destroy} but in case of constraint
@@ -165,12 +152,6 @@ module Iry
   # @param model [Handlers::Model] model to destroy
   # @return [Handlers::Model] the destroyed model
   def self.destroy(model)
-    constraint_result = handle_constraints(model) { model.destroy }
-
-    if constraint_result.nil?
-      return false
-    end
-
-    return constraint_result
+    TransformConstraints.destroy(model)
   end
 end

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "iry",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "iry",
-      "version": "0.5.1",
+      "version": "0.7.0",
       "license": "MIT",
       "devDependencies": {
         "conventional-changelog-cli": ">= 3.0.0",

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iry",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "Transform database constraint errors into activerecord validation errors",
   "private": true,
   "main": "index.js",

data/rbi/iry.rbi

@@ -101,13 +101,44 @@ module Iry
   end
 
   # Raised when constraints have been violated and have been converted to
-  # model errors
+  # model errors, on {ActiveRecord::Base#save!} calls, to simulate a behavior
+  # similar to {ActiveRecord::RecordInvalid} when it's raised
   class ConstraintViolation < ActiveRecord::RecordInvalid
     include Iry::Error
   end
 
+  # Raised when constraints errors happen and go through Iry, even if these
+  # are not handled. This class inherits from {ActiveRecord::StatementInvalid}
+  # to maximize compatibility with existing code
   class StatementInvalid < ActiveRecord::StatementInvalid
     include Iry::Error
+
+    # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
+    # sord omit - no YARD type given for "**kwargs", using untyped
+    # _@param_ `message`
+    # 
+    # _@param_ `record`
+    # 
+    # _@param_ `error`
+    sig do
+      params(
+        message: T.nilable(String),
+        record: Handlers::Model,
+        error: ActiveModel::Error,
+        kwargs: T.untyped
+      ).void
+    end
+    def initialize(message = nil, record:, error:, **kwargs); end
+
+    # _@return_ — model affected by the constraint violation
+    sig { returns(Handlers::Model) }
+    attr_reader :record
+
+    # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
+    # _@return_ — error attached to the `record` for the
+    # constraint violation
+    sig { returns(ActiveModel::Error) }
+    attr_reader :error
   end
 
   # Overrides private API method {ActiveRecord#create_or_update} to handle
@@ -201,8 +232,9 @@ module Iry
       # 
       # _@param_ `model`
       # 
-      # _@return_ — true if this database handler handled the constraint error
-      sig { params(err: ActiveRecord::StatementInvalid, model: Model).returns(T::Boolean) }
+      # _@return_ — `nil` if couldn't handle the error,
+      # otherwise the {ActiveModel::Error} added to the model
+      sig { params(err: ActiveRecord::StatementInvalid, model: Model).void }
       def handle(err, model); end
     end
 
@@ -257,6 +289,10 @@ module Iry
       # _@param_ `err`
       # 
       # _@param_ `model` — should inherit {ActiveRecord::Base} and`include Iry` to match the interface
+      # 
+      # _@return_ — if handled constraint, returns the
+      # error attached to the model. If constraint wasn't handled or handling
+      # failed, `nil` is returned
       sig { params(err: ActiveRecord::StatementInvalid, model: Model).void }
       def handle(err, model); end
 
@@ -275,6 +311,10 @@ module Iry
       # _@param_ `err`
       # 
       # _@param_ `model` — should inherit {ActiveRecord::Base} and`include Iry` to match the interface
+      # 
+      # _@return_ — if handled constraint, returns the
+      # error attached to the model. If constraint wasn't handled or handling
+      # failed, `nil` is returned
       sig { params(err: ActiveRecord::StatementInvalid, model: Model).void }
       def self.handle(err, model); end
     end
@@ -297,7 +337,7 @@ module Iry
       # _@param_ `err`
       # 
       # _@param_ `model` — should inherit {ActiveRecord::Base} and`include Iry` to match the interface
-      sig { params(err: ActiveRecord::StatementInvalid, model: Model).returns(T::Boolean) }
+      sig { params(err: ActiveRecord::StatementInvalid, model: Model).void }
       def handle(err, model); end
 
       # sord warn - ActiveRecord::StatementInvalid wasn't able to be resolved to a constant in this project
@@ -313,7 +353,7 @@ module Iry
       # _@param_ `err`
       # 
       # _@param_ `model` — should inherit {ActiveRecord::Base} and`include Iry` to match the interface
-      sig { params(err: ActiveRecord::StatementInvalid, model: Model).returns(T::Boolean) }
+      sig { params(err: ActiveRecord::StatementInvalid, model: Model).void }
       def self.handle(err, model); end
     end
   end
@@ -337,10 +377,11 @@ module Iry
   # A constraint has a name and can apply errors to an object inheriting from {ActiveRecord::Base}
   # @abstract
   module Constraint
+    # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
     # Sets validation errors on the model
     # 
     # _@param_ `model`
-    sig { params(model: Handlers::Model).void }
+    sig { params(model: Handlers::Model).returns(ActiveModel::Error) }
     def apply(model); end
 
     # Name of the constraint to be caught from the database
@@ -369,8 +410,9 @@ module Iry
       sig { params(key: Symbol, name: String, message: T.any(Symbol, String)).void }
       def initialize(key, name:, message: :invalid); end
 
+      # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
       # _@param_ `model`
-      sig { params(model: Handlers::Model).void }
+      sig { params(model: Handlers::Model).returns(ActiveModel::Error) }
       def apply(model); end
 
       sig { returns(Symbol) }
@@ -384,6 +426,8 @@ module Iry
     end
 
     class Unique
+      MAX_INFER_NAME_BYTE_SIZE = T.let(62, T.untyped)
+
       # Infers the unique constraint name based on keys and table name
       # 
       # _@param_ `keys`
@@ -409,8 +453,9 @@ module Iry
       end
       def initialize(keys, name:, error_key:, message: :taken); end
 
+      # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
       # _@param_ `model`
-      sig { params(model: Handlers::Model).void }
+      sig { params(model: Handlers::Model).returns(ActiveModel::Error) }
       def apply(model); end
 
       sig { returns(T::Array[Symbol]) }
@@ -443,8 +488,9 @@ module Iry
       sig { params(key: Symbol, name: String, message: T.any(Symbol, String)).void }
       def initialize(key, name:, message: :taken); end
 
+      # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
       # _@param_ `model`
-      sig { params(model: Handlers::Model).void }
+      sig { params(model: Handlers::Model).returns(ActiveModel::Error) }
       def apply(model); end
 
       sig { returns(Symbol) }
@@ -483,8 +529,9 @@ module Iry
       end
       def initialize(keys, name:, error_key:, message: :required); end
 
+      # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
       # _@param_ `model`
-      sig { params(model: Handlers::Model).void }
+      sig { params(model: Handlers::Model).returns(ActiveModel::Error) }
       def apply(model); end
 
       sig { returns(T::Array[Symbol]) }
@@ -500,4 +547,66 @@ module Iry
       attr_accessor :error_key
     end
   end
+
+  # Implementation of {Iry} methods, helps ensuring the main module focus on
+  # documentation
+  module TransformConstraints
+    extend Iry::TransformConstraints
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model, block: T.untyped).void }
+    def handle_constraints(model, &block); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model, block: T.untyped).returns(Handlers::Model) }
+    def handle_constraints!(model, &block); end
+
+    # Tracks constraints of models saved as a consequence of saving another
+    # model. This usually represents a situation of model using
+    # `accepts_nested_attributes_for`
+    # 
+    # _@param_ `model`
+    sig { params(model: Handlers::Model, block: T.untyped).returns(Handlers::Model) }
+    def nested_constraints!(model, &block); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model).returns(T::Boolean) }
+    def save(model); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model).returns(T::Boolean) }
+    def save!(model); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model).returns(Handlers::Model) }
+    def destroy(model); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model, block: T.untyped).void }
+    def self.handle_constraints(model, &block); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model, block: T.untyped).returns(Handlers::Model) }
+    def self.handle_constraints!(model, &block); end
+
+    # Tracks constraints of models saved as a consequence of saving another
+    # model. This usually represents a situation of model using
+    # `accepts_nested_attributes_for`
+    # 
+    # _@param_ `model`
+    sig { params(model: Handlers::Model, block: T.untyped).returns(Handlers::Model) }
+    def self.nested_constraints!(model, &block); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model).returns(T::Boolean) }
+    def self.save(model); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model).returns(T::Boolean) }
+    def self.save!(model); end
+
+    # _@param_ `model`
+    sig { params(model: Handlers::Model).returns(Handlers::Model) }
+    def self.destroy(model); end
+  end
 end

data/sig/iry.rbs

@@ -93,13 +93,39 @@ module Iry
   end
 
   # Raised when constraints have been violated and have been converted to
-  # model errors
+  # model errors, on {ActiveRecord::Base#save!} calls, to simulate a behavior
+  # similar to {ActiveRecord::RecordInvalid} when it's raised
   class ConstraintViolation < ActiveRecord::RecordInvalid
     include Iry::Error
   end
 
+  # Raised when constraints errors happen and go through Iry, even if these
+  # are not handled. This class inherits from {ActiveRecord::StatementInvalid}
+  # to maximize compatibility with existing code
   class StatementInvalid < ActiveRecord::StatementInvalid
     include Iry::Error
+
+    # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
+    # sord omit - no YARD type given for "**kwargs", using untyped
+    # _@param_ `message`
+    # 
+    # _@param_ `record`
+    # 
+    # _@param_ `error`
+    def initialize: (
+                      ?String? message,
+                      record: Handlers::Model,
+                      error: ActiveModel::Error,
+                      **untyped kwargs
+                    ) -> void
+
+    # _@return_ — model affected by the constraint violation
+    attr_reader record: Handlers::Model
+
+    # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
+    # _@return_ — error attached to the `record` for the
+    # constraint violation
+    attr_reader error: ActiveModel::Error
   end
 
   # Overrides private API method {ActiveRecord#create_or_update} to handle
@@ -182,8 +208,9 @@ module Iry
       # 
       # _@param_ `model`
       # 
-      # _@return_ — true if this database handler handled the constraint error
-      def handle: (ActiveRecord::StatementInvalid err, Model model) -> bool
+      # _@return_ — `nil` if couldn't handle the error,
+      # otherwise the {ActiveModel::Error} added to the model
+      def handle: (ActiveRecord::StatementInvalid err, Model model) -> void
     end
 
     # Interface of the model class. This class is usually inherits from {ActiveRecord::Base}
@@ -224,6 +251,10 @@ module Iry
       # _@param_ `err`
       # 
       # _@param_ `model` — should inherit {ActiveRecord::Base} and`include Iry` to match the interface
+      # 
+      # _@return_ — if handled constraint, returns the
+      # error attached to the model. If constraint wasn't handled or handling
+      # failed, `nil` is returned
       def handle: (ActiveRecord::StatementInvalid err, Model model) -> void
 
       # sord warn - ActiveRecord::StatementInvalid wasn't able to be resolved to a constant in this project
@@ -240,6 +271,10 @@ module Iry
       # _@param_ `err`
       # 
       # _@param_ `model` — should inherit {ActiveRecord::Base} and`include Iry` to match the interface
+      # 
+      # _@return_ — if handled constraint, returns the
+      # error attached to the model. If constraint wasn't handled or handling
+      # failed, `nil` is returned
       def self.handle: (ActiveRecord::StatementInvalid err, Model model) -> void
     end
 
@@ -260,7 +295,7 @@ module Iry
       # _@param_ `err`
       # 
       # _@param_ `model` — should inherit {ActiveRecord::Base} and`include Iry` to match the interface
-      def handle: (ActiveRecord::StatementInvalid err, Model model) -> bool
+      def handle: (ActiveRecord::StatementInvalid err, Model model) -> void
 
       # sord warn - ActiveRecord::StatementInvalid wasn't able to be resolved to a constant in this project
       # Returns always true, catching any unhandled database exception
@@ -274,7 +309,7 @@ module Iry
       # _@param_ `err`
       # 
       # _@param_ `model` — should inherit {ActiveRecord::Base} and`include Iry` to match the interface
-      def self.handle: (ActiveRecord::StatementInvalid err, Model model) -> bool
+      def self.handle: (ActiveRecord::StatementInvalid err, Model model) -> void
     end
   end
 
@@ -295,10 +330,11 @@ module Iry
   # A constraint has a name and can apply errors to an object inheriting from {ActiveRecord::Base}
   # @abstract
   module Constraint
+    # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
     # Sets validation errors on the model
     # 
     # _@param_ `model`
-    def apply: (Handlers::Model model) -> void
+    def apply: (Handlers::Model model) -> ActiveModel::Error
 
     # Name of the constraint to be caught from the database
     def name: () -> String
@@ -322,8 +358,9 @@ module Iry
       # _@param_ `name` — constraint name
       def initialize: (Symbol key, name: String, ?message: (Symbol | String)) -> void
 
+      # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
       # _@param_ `model`
-      def apply: (Handlers::Model model) -> void
+      def apply: (Handlers::Model model) -> ActiveModel::Error
 
       attr_accessor key: Symbol
 
@@ -333,6 +370,8 @@ module Iry
     end
 
     class Unique
+      MAX_INFER_NAME_BYTE_SIZE: untyped
+
       # Infers the unique constraint name based on keys and table name
       # 
       # _@param_ `keys`
@@ -354,8 +393,9 @@ module Iry
                         ?message: (Symbol | String)
                       ) -> void
 
+      # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
       # _@param_ `model`
-      def apply: (Handlers::Model model) -> void
+      def apply: (Handlers::Model model) -> ActiveModel::Error
 
       attr_accessor keys: ::Array[Symbol]
 
@@ -381,8 +421,9 @@ module Iry
       # _@param_ `name` — constraint name
       def initialize: (Symbol key, name: String, ?message: (Symbol | String)) -> void
 
+      # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
       # _@param_ `model`
-      def apply: (Handlers::Model model) -> void
+      def apply: (Handlers::Model model) -> ActiveModel::Error
 
       attr_accessor key: Symbol
 
@@ -413,8 +454,9 @@ module Iry
                         ?message: (Symbol | String)
                       ) -> void
 
+      # sord warn - ActiveModel::Error wasn't able to be resolved to a constant in this project
       # _@param_ `model`
-      def apply: (Handlers::Model model) -> void
+      def apply: (Handlers::Model model) -> ActiveModel::Error
 
       attr_accessor keys: ::Array[Symbol]
 
@@ -425,4 +467,54 @@ module Iry
       attr_accessor error_key: Symbol
     end
   end
+
+  # Implementation of {Iry} methods, helps ensuring the main module focus on
+  # documentation
+  module TransformConstraints
+    extend Iry::TransformConstraints
+
+    # _@param_ `model`
+    def handle_constraints: (Handlers::Model model) -> void
+
+    # _@param_ `model`
+    def handle_constraints!: (Handlers::Model model) -> Handlers::Model
+
+    # Tracks constraints of models saved as a consequence of saving another
+    # model. This usually represents a situation of model using
+    # `accepts_nested_attributes_for`
+    # 
+    # _@param_ `model`
+    def nested_constraints!: (Handlers::Model model) -> Handlers::Model
+
+    # _@param_ `model`
+    def save: (Handlers::Model model) -> bool
+
+    # _@param_ `model`
+    def save!: (Handlers::Model model) -> bool
+
+    # _@param_ `model`
+    def destroy: (Handlers::Model model) -> Handlers::Model
+
+    # _@param_ `model`
+    def self.handle_constraints: (Handlers::Model model) -> void
+
+    # _@param_ `model`
+    def self.handle_constraints!: (Handlers::Model model) -> Handlers::Model
+
+    # Tracks constraints of models saved as a consequence of saving another
+    # model. This usually represents a situation of model using
+    # `accepts_nested_attributes_for`
+    # 
+    # _@param_ `model`
+    def self.nested_constraints!: (Handlers::Model model) -> Handlers::Model
+
+    # _@param_ `model`
+    def self.save: (Handlers::Model model) -> bool
+
+    # _@param_ `model`
+    def self.save!: (Handlers::Model model) -> bool
+
+    # _@param_ `model`
+    def self.destroy: (Handlers::Model model) -> Handlers::Model
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iry
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Francesco Belladonna
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -107,6 +107,7 @@ files:
 - lib/iry/handlers/pg.rb
 - lib/iry/macros.rb
 - lib/iry/patch.rb
+- lib/iry/transform_constraints.rb
 - lib/iry/version.rb
 - package-lock.json
 - package.json