vert-core 1.0.0

data/lib/vert/railtie.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Vert
+  class Railtie < Rails::Railtie
+    config.vert = ActiveSupport::OrderedOptions.new
+
+    initializer "vert.middleware" do |app|
+      if Vert.config.enable_rls
+        app.middleware.use Vert::Rls::ContextMiddleware
+      end
+    end
+
+    initializer "vert.sidekiq" do
+      if defined?(Sidekiq) && Vert.config.enable_rls
+        Sidekiq.configure_server do |config|
+          config.server_middleware do |chain|
+            chain.add Vert::Rls::JobMiddleware
+          end
+        end
+        Sidekiq.configure_client do |config|
+          config.client_middleware do |chain|
+            chain.add Vert::Rls::JobClientMiddleware
+          end
+        end
+      end
+    end
+
+    config.to_prepare do
+      if Vert.config.enable_rls && defined?(ApplicationController)
+        ApplicationController.include(Vert::Rls::ControllerContext)
+      end
+    end
+
+    initializer "vert.routes" do |app|
+      next unless Vert.config.enable_health && Vert.config.auto_mount_health_routes
+      next if app.routes.named_routes.key?(:health)
+
+      app.routes.append do
+        Vert::Health::Routes.mount(self)
+      end
+    end
+
+    generators do
+      require_relative "generators/install_generator"
+      require_relative "generators/rls_migration_generator"
+    end
+
+    console do
+      puts "Vert v#{Vert::VERSION} loaded"
+      puts "  Config: Vert.config"
+      puts "  Health: Vert::Health.check_all (when enable_health)"
+    end
+  end
+end

data/lib/vert/rls/connection_handler.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Vert
+  module Rls
+    class ConnectionHandler
+      class << self
+        def set_context(tenant_id:, company_id: nil, user_id: nil)
+          return unless tenant_id.present?
+          connection = ActiveRecord::Base.connection
+          connection.execute(ActiveRecord::Base.sanitize_sql(["SET LOCAL app.current_tenant_id = %s", tenant_id]))
+          connection.execute(ActiveRecord::Base.sanitize_sql(["SET LOCAL app.current_company_id = %s", company_id])) if company_id.present?
+          connection.execute(ActiveRecord::Base.sanitize_sql(["SET LOCAL app.current_user_id = %s", user_id])) if user_id.present?
+          Vert::Current.rls_configured = true
+        rescue StandardError => e
+          Rails.logger.error("[Vert::RLS] #{e.message}") if defined?(Rails)
+          raise
+        end
+
+        def reset_context
+          return unless Vert::Current.rls_configured
+          connection = ActiveRecord::Base.connection
+          connection.execute("RESET app.current_tenant_id")
+          connection.execute("RESET app.current_company_id")
+          connection.execute("RESET app.current_user_id")
+          Vert::Current.rls_configured = false
+        rescue StandardError => e
+          Rails.logger.error("[Vert::RLS] #{e.message}") if defined?(Rails)
+        end
+
+        def with_context(tenant_id:, company_id: nil, user_id: nil)
+          previous = Vert::Current.serialize
+          set_context(tenant_id: tenant_id, company_id: company_id, user_id: user_id)
+          Vert::Current.set_context(tenant_id: tenant_id, company_id: company_id, user_id: user_id)
+          yield
+        ensure
+          reset_context
+          Vert::Current.deserialize(previous)
+        end
+
+        def create_functions_sql
+          <<~SQL
+            CREATE OR REPLACE FUNCTION current_tenant_id() RETURNS uuid AS $$
+              SELECT NULLIF(current_setting('app.current_tenant_id', true), '')::uuid;
+            $$ LANGUAGE SQL STABLE;
+            CREATE OR REPLACE FUNCTION current_company_id() RETURNS uuid AS $$
+              SELECT NULLIF(current_setting('app.current_company_id', true), '')::uuid;
+            $$ LANGUAGE SQL STABLE;
+            CREATE OR REPLACE FUNCTION current_user_id() RETURNS uuid AS $$
+              SELECT NULLIF(current_setting('app.current_user_id', true), '')::uuid;
+            $$ LANGUAGE SQL STABLE;
+          SQL
+        end
+      end
+    end
+  end
+end

data/lib/vert/rls/consumer_context.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Vert
+  module Rls
+    module ConsumerContext
+      extend ActiveSupport::Concern
+
+      def work_with_params(message, delivery_info, metadata)
+        h = metadata[:headers] || {}
+        Vert::Current.set_context(
+          tenant_id: h["tenant_id"] || h[:tenant_id],
+          user_id: h["user_id"] || h[:user_id],
+          company_id: h["company_id"] || h[:company_id],
+          request_id: h["request_id"] || h[:request_id] || SecureRandom.uuid
+        )
+        if Vert.config.enable_rls && Vert::Current.tenant_id.present?
+          ConnectionHandler.set_context(tenant_id: Vert::Current.tenant_id, company_id: Vert::Current.company_id, user_id: Vert::Current.user_id)
+        end
+        super
+      ensure
+        Vert::Current.reset_all
+        ConnectionHandler.reset_context if Vert.config.enable_rls
+      end
+    end
+
+    class BaseConsumer
+      include Sneakers::Worker if defined?(Sneakers::Worker)
+      include ConsumerContext if defined?(Sneakers::Worker)
+    end
+  end
+end

data/lib/vert/rls/context_middleware.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Vert
+  module Rls
+    class ContextMiddleware
+      def initialize(app)
+        @app = app
+      end
+
+      def call(env)
+        response = @app.call(env)
+        response
+      ensure
+        Vert::Rls::ConnectionHandler.reset_context if Vert.config.enable_rls
+      end
+    end
+
+    module ControllerContext
+      extend ActiveSupport::Concern
+
+      included do
+        after_action :configure_rls_context, if: -> { Vert.config.enable_rls }
+      end
+
+      private
+
+      def configure_rls_context
+        return unless Vert::Current.tenant_id.present?
+        Vert::Rls::ConnectionHandler.set_context(
+          tenant_id: Vert::Current.tenant_id,
+          company_id: Vert::Current.company_id,
+          user_id: Vert::Current.user_id
+        )
+      end
+    end
+  end
+end

data/lib/vert/rls/job_context.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Vert
+  module Rls
+    module JobContext
+      extend ActiveSupport::Concern
+
+      class_methods do
+        def perform_async(*args)
+          super(*args, __vert_context__: Vert::Current.serialize)
+        end
+
+        def perform_in(interval, *args)
+          super(interval, *args, __vert_context__: Vert::Current.serialize)
+        end
+
+        def perform_at(timestamp, *args)
+          super(timestamp, *args, __vert_context__: Vert::Current.serialize)
+        end
+      end
+
+      def perform(*args)
+        context = args.last.is_a?(Hash) && (args.last.delete(:__vert_context__) || args.last.delete("__vert_context__"))
+        Vert::Current.deserialize(context) if context
+        Vert::Rls::ConnectionHandler.set_context(tenant_id: Vert::Current.tenant_id, company_id: Vert::Current.company_id, user_id: Vert::Current.user_id) if Vert.config.enable_rls && Vert::Current.tenant_id.present?
+
+        clean = args.last.is_a?(Hash) ? (args[0..-2] + [args.last.except(:__vert_context__, "__vert_context__")]).reject { |a| a.respond_to?(:empty?) && a.empty? } : args
+        super(*clean)
+      ensure
+        Vert::Current.reset_all
+        Vert::Rls::ConnectionHandler.reset_context if Vert.config.enable_rls
+      end
+    end
+
+    class JobMiddleware
+      def call(_worker, job, _queue)
+        context = job.delete("__vert_context__")
+        if context
+          Vert::Current.deserialize(context)
+          Vert::Rls::ConnectionHandler.set_context(tenant_id: Vert::Current.tenant_id, company_id: Vert::Current.company_id, user_id: Vert::Current.user_id) if Vert.config.enable_rls && Vert::Current.tenant_id.present?
+        end
+        yield
+      ensure
+        Vert::Current.reset_all
+        Vert::Rls::ConnectionHandler.reset_context if Vert.config.enable_rls
+      end
+    end
+
+    class JobClientMiddleware
+      def call(_worker_class, job, _queue, _redis_pool)
+        job["__vert_context__"] = Vert::Current.serialize
+        yield
+      end
+    end
+  end
+end

data/lib/vert/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Vert
+  VERSION = "1.0.0"
+end

data/lib/vert.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative "vert/version"
+require_relative "vert/configuration"
+
+# Concerns (sempre carregados; inclua no model conforme necessário)
+require_relative "vert/concerns/current_attributes"
+require_relative "vert/concerns/uuid_primary_key"
+require_relative "vert/concerns/auditable"
+require_relative "vert/concerns/soft_deletable"
+require_relative "vert/concerns/multi_tenant"
+require_relative "vert/concerns/company_scoped"
+require_relative "vert/concerns/document_storeable"
+
+# Clients
+require_relative "vert/clients/document_service_client"
+
+# Outbox
+require_relative "vert/outbox/event"
+require_relative "vert/outbox/publisher"
+require_relative "vert/outbox/publisher_job"
+
+# RLS
+require_relative "vert/rls/context_middleware"
+require_relative "vert/rls/job_context"
+require_relative "vert/rls/consumer_context"
+require_relative "vert/rls/connection_handler"
+
+# Health
+require_relative "vert/health/checker"
+require_relative "vert/health/routes"
+
+# Authorization
+require_relative "vert/authorization/permission_resolver"
+require_relative "vert/authorization/dynamic_policy"
+require_relative "vert/authorization/policy_finder"
+require_relative "vert/authorization/controller_methods"
+
+# Railtie
+require_relative "vert/railtie" if defined?(Rails::Railtie)
+
+module Vert
+  class Error < StandardError; end
+  class TenantNotSetError < Error; end
+  class CompanyNotSetError < Error; end
+
+  class << self
+    def configure
+      yield(configuration)
+    end
+
+    def configuration
+      @configuration ||= Vert::Configuration.new
+    end
+
+    alias config configuration
+  end
+end

data/vert.gemspec

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative "lib/vert/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "vert-core"
+  spec.version = Vert::VERSION
+  spec.authors = ["Vert Team"]
+  spec.email = ["dev@vert.dev"]
+
+  spec.summary = "Generic core library for Rails microservices"
+  spec.description = "Optional patterns for Rails apps: multi-tenancy, RLS, outbox, health checks, auditing, soft delete, UUID primary keys, and document storage client. All features are configurable via initializer."
+  spec.homepage = "https://github.com/edinaldo-novti/vert"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(__dir__) do
+    Dir.glob("**/*").reject do |f|
+      File.directory?(f) ||
+        (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activesupport", ">= 7.0"
+  spec.add_dependency "activerecord", ">= 7.0"
+  spec.add_dependency "discard", "~> 1.3"
+  spec.add_dependency "bunny", "~> 2.22"
+  spec.add_dependency "sidekiq", ">= 7.0"
+
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop", "~> 1.21"
+  spec.add_development_dependency "rubocop-rails", "~> 2.0"
+  spec.add_development_dependency "rubocop-rspec", "~> 2.0"
+end

metadata

@@ -0,0 +1,223 @@
+--- !ruby/object:Gem::Specification
+name: vert-core
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Vert Team
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: discard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: bunny
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.22'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.22'
+- !ruby/object:Gem::Dependency
+  name: sidekiq
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: 'Optional patterns for Rails apps: multi-tenancy, RLS, outbox, health
+  checks, auditing, soft delete, UUID primary keys, and document storage client. All
+  features are configurable via initializer.'
+email:
+- dev@vert.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- lib/vert.rb
+- lib/vert/authorization/controller_methods.rb
+- lib/vert/authorization/dynamic_policy.rb
+- lib/vert/authorization/permission_resolver.rb
+- lib/vert/authorization/policy_finder.rb
+- lib/vert/clients/document_service_client.rb
+- lib/vert/concerns/auditable.rb
+- lib/vert/concerns/company_scoped.rb
+- lib/vert/concerns/current_attributes.rb
+- lib/vert/concerns/document_storeable.rb
+- lib/vert/concerns/multi_tenant.rb
+- lib/vert/concerns/soft_deletable.rb
+- lib/vert/concerns/uuid_primary_key.rb
+- lib/vert/configuration.rb
+- lib/vert/generators/install_generator.rb
+- lib/vert/generators/rls_migration_generator.rb
+- lib/vert/generators/templates/application_record.rb.tt
+- lib/vert/generators/templates/create_outbox_events.rb.tt
+- lib/vert/generators/templates/create_rls_functions.rb.tt
+- lib/vert/generators/templates/current.rb.tt
+- lib/vert/generators/templates/enable_rls_on_tables.rb.tt
+- lib/vert/generators/templates/health_controller.rb.tt
+- lib/vert/generators/templates/initializer.rb.tt
+- lib/vert/generators/templates/outbox_event.rb.tt
+- lib/vert/health/checker.rb
+- lib/vert/health/routes.rb
+- lib/vert/outbox/event.rb
+- lib/vert/outbox/publisher.rb
+- lib/vert/outbox/publisher_job.rb
+- lib/vert/railtie.rb
+- lib/vert/rls/connection_handler.rb
+- lib/vert/rls/consumer_context.rb
+- lib/vert/rls/context_middleware.rb
+- lib/vert/rls/job_context.rb
+- lib/vert/version.rb
+- vert.gemspec
+homepage: https://github.com/edinaldo-novti/vert
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/edinaldo-novti/vert
+  source_code_uri: https://github.com/edinaldo-novti/vert
+  changelog_uri: https://github.com/edinaldo-novti/vert/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Generic core library for Rails microservices
+test_files: []