the-active-rpc 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7633a03bfd747226a57e031d46a3c7f22319e3602da77e6722ed989807d56cf5
+  data.tar.gz: cdb02a60468c746b81dde375f49f3133bd60b029640dc766c682a5b27b86b74a
+SHA512:
+  metadata.gz: 8b0c1b6fd916af175584915a0b2002c9970cd9df969f8a2e524da725ae008dd70c5871ff9c56b19a20ea0ee3c4b1a0c4d1f03031f4fa3d0d103a86bd9096a41a
+  data.tar.gz: 95b9a7d6ca83b1f0c0e147d82230bddd7833916f024c87d9de9c4203993bcaf738c5915c335a173ac78cf90247f6c56805d2a17f7c631fa923f4c282a252af96

data/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+## [1.0.1](https://github.com/shqear93/the-active-rpc/compare/the-active-rpc/v1.0.0...the-active-rpc/v1.0.1) (2026-06-01)
+
+
+### Bug Fixes
+
+* trigger gem publish after repo rename ([0b231d1](https://github.com/shqear93/the-active-rpc/commit/0b231d1730579305c6a88d69ff4d9da85b54f49d))
+
+## 1.0.0 (2026-06-01)
+
+
+### ⚠ BREAKING CHANGES
+
+* initial release of the-active-rpc
+
+### Features
+
+* initial active_rpc gem extraction ([efe3202](https://github.com/shqear93/active_rpc/commit/efe32024077d6bfeff97c9ede6d7134648bf7fb0))
+* initial release of the-active-rpc ([ee304aa](https://github.com/shqear93/active_rpc/commit/ee304aaaab5c45eccb60e4efec53c38d16884ac6))
+* port specs, clean debug output, add CI/release-please ([1ac312c](https://github.com/shqear93/active_rpc/commit/1ac312c7a15b13968e9c5a5a36315ce5eb0ac1a5))
+
+
+### Bug Fixes
+
+* correct Quick Start heading case in README ([1d23fb0](https://github.com/shqear93/active_rpc/commit/1d23fb045d4dbbab4985dcb36456be00d641e2ce))
+* pin dry-configurable to ~> 1.3.0 for Ruby 3.1/3.2 compat ([b5ed5a2](https://github.com/shqear93/active_rpc/commit/b5ed5a29b4029dec3fc78b9b3c786cc3dcdc0aba))
+* pin pagy to ~> 9.4 for Ruby 3.1/3.2 compat ([15b9fde](https://github.com/shqear93/active_rpc/commit/15b9fdeed1fde4201e999a886ad160486402a5ba))
+* trigger release 1.2.2 ([7ac02bf](https://github.com/shqear93/active_rpc/commit/7ac02bf449e1854927a5144fde0bc9d3a57300a5))
+* update README heading ([f1ae9f5](https://github.com/shqear93/active_rpc/commit/f1ae9f500c67fb22460ca184e01951d49599ad39))
+
+## [1.2.1](https://github.com/shqear93/active_rpc/compare/the-active-rpc/v1.2.0...the-active-rpc/v1.2.1) (2026-06-01)
+
+
+### Bug Fixes
+
+* update README heading ([f1ae9f5](https://github.com/shqear93/active_rpc/commit/f1ae9f500c67fb22460ca184e01951d49599ad39))
+
+## [1.2.0](https://github.com/shqear93/active_rpc/compare/the-active-rpc-v1.1.2...the-active-rpc/v1.2.0) (2026-06-01)
+
+
+### Features
+
+* initial active_rpc gem extraction ([efe3202](https://github.com/shqear93/active_rpc/commit/efe32024077d6bfeff97c9ede6d7134648bf7fb0))
+* port specs, clean debug output, add CI/release-please ([1ac312c](https://github.com/shqear93/active_rpc/commit/1ac312c7a15b13968e9c5a5a36315ce5eb0ac1a5))
+
+
+### Bug Fixes
+
+* correct Quick Start heading case in README ([1d23fb0](https://github.com/shqear93/active_rpc/commit/1d23fb045d4dbbab4985dcb36456be00d641e2ce))
+* pin dry-configurable to ~> 1.3.0 for Ruby 3.1/3.2 compat ([b5ed5a2](https://github.com/shqear93/active_rpc/commit/b5ed5a29b4029dec3fc78b9b3c786cc3dcdc0aba))
+* pin pagy to ~> 9.4 for Ruby 3.1/3.2 compat ([15b9fde](https://github.com/shqear93/active_rpc/commit/15b9fdeed1fde4201e999a886ad160486402a5ba))
+
+## [1.1.2](https://github.com/shqear93/active_rpc/compare/active_rpc/v1.1.1...active_rpc/v1.1.2) (2026-06-01)
+
+
+### Bug Fixes
+
+* pin dry-configurable to ~> 1.3.0 for Ruby 3.1/3.2 compat ([b5ed5a2](https://github.com/shqear93/active_rpc/commit/b5ed5a29b4029dec3fc78b9b3c786cc3dcdc0aba))
+* pin pagy to ~> 9.4 for Ruby 3.1/3.2 compat ([15b9fde](https://github.com/shqear93/active_rpc/commit/15b9fdeed1fde4201e999a886ad160486402a5ba))
+
+## [1.1.1](https://github.com/shqear93/active_rpc/compare/active_rpc/v1.1.0...active_rpc/v1.1.1) (2026-06-01)
+
+
+### Bug Fixes
+
+* correct Quick Start heading case in README ([1d23fb0](https://github.com/shqear93/active_rpc/commit/1d23fb045d4dbbab4985dcb36456be00d641e2ce))
+
+## [1.1.0](https://github.com/shqear93/active_rpc/compare/active_rpc-v1.0.0...active_rpc/v1.1.0) (2026-06-01)
+
+
+### Features
+
+* initial active_rpc gem extraction ([efe3202](https://github.com/shqear93/active_rpc/commit/efe32024077d6bfeff97c9ede6d7134648bf7fb0))
+* port specs, clean debug output, add CI/release-please ([1ac312c](https://github.com/shqear93/active_rpc/commit/1ac312c7a15b13968e9c5a5a36315ce5eb0ac1a5))
+
+## 1.0.0
+
+- Extract ActiveRpc from athar_rpc into standalone gem
+- Generic namespace (`ActiveRpc`) with no Athar-specific proto definitions
+- Configurable service resolver
+- Backward compatibility aliases in `athar_rpc` wrapper gem

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Athar Association
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,59 @@
+# The Active RPC
+# ActiveRpc
+
+ActiveRecord associations for gRPC services.
+
+## Quick start
+
+```ruby
+class Employee < ApplicationRecord
+  include ActiveRpc::ModelExtensions
+
+  active_rpc :core, :User, foreign_key: :user_id do
+    attribute :name, :string
+    attribute :email, :string
+    attribute :department, :string
+  end
+end
+```
+
+```ruby
+# Bulk load user data in one gRPC call
+Employee.all.with_user_data
+
+# Filter employees by remote user attribute
+Employee.where_rpc(:user_ids, department: 'Engineering')
+```
+
+## Features
+
+- **rpc_belongs_to** — Treat remote gRPC resources like local associations
+- **Bulk loading** — `with_user_data` fetches all related records in one gRPC call
+- **Cross-service filtering** — `where_rpc` filters local records by remote attributes
+- **Dirty tracking** — Change remote attributes locally, propagate on save
+- **Bidirectional create/update** — Creating/updating local records creates/updates remote resources
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'the-active-rpc'
+```
+
+## Configuration
+
+```ruby
+ActiveRpc.configure do |config|
+  config.service_resolver = ->(subsystem, service_name) {
+    "::MyApp::#{subsystem.camelize}::#{service_name}".constantize
+  }
+end
+```
+
+## License
+
+MIT
+
+## License
+

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/active_rpc/client_config.rb

@@ -0,0 +1,30 @@
+require 'dry-configurable'
+require 'yaml'
+
+module ActiveRpc
+  module ClientConfig
+    extend Dry::Configurable
+
+    setting :configs, default: {}, reader: true
+
+    def self.load_config
+      config_file = File.join(Rails.root, 'config', 'grpc_clients.yml')
+
+      unless File.exist?(config_file)
+        raise "gRPC client config file not found: #{config_file}"
+      end
+
+      configure do |config|
+        config.configs = YAML.safe_load(
+          File.read(config_file),
+          aliases: true,
+          permitted_classes: [Symbol]
+        )[Rails.env]
+      end
+    end
+
+    def self.for(subsystem)
+      configs.fetch(subsystem.to_s, {})
+    end
+  end
+end

data/lib/active_rpc/client_factory.rb

@@ -0,0 +1,61 @@
+require 'gruf'
+require 'singleton'
+require 'ostruct'
+
+module ActiveRpc
+  class DummyClient
+    def initialize(subsystem, service_name)
+      @subsystem = subsystem
+      @service_name = service_name
+    end
+
+    def call(method, params = {})
+      if defined?(Rails)
+        Rails.logger.warn("[ActiveRpc::DummyClient] Called #{method} on #{@subsystem}/#{@service_name} with params: #{params.inspect}")
+      end
+      OpenStruct.new(message: nil)
+    end
+  end
+
+  class ClientFactory
+    include Singleton
+
+    def initialize
+      @clients = {}
+    end
+
+    def client_for(subsystem, service_name)
+      key = "#{subsystem}_#{service_name}"
+      @clients[key] ||= create_client(subsystem, service_name)
+    end
+
+    private
+
+    def create_client(subsystem, service_name)
+      if ClientConfig.configs.empty? && defined?(Rails)
+        Rails.logger.warn('ActiveRpc::ClientConfig not loaded yet, attempting to load it now')
+        ClientConfig.load_config rescue nil
+      end
+
+      config = ClientConfig.for(subsystem)
+      if config.empty?
+        if defined?(Rails) && Rails.env.production?
+          Rails.logger.error("No gRPC configuration found for #{subsystem} in production environment")
+          return DummyClient.new(subsystem, service_name)
+        else
+          raise "No gRPC configuration found for #{subsystem}"
+        end
+      end
+
+      service_class = ActiveRpc.configuration.service_resolver.call(subsystem, service_name)
+
+      Gruf::Client.new(
+        service: service_class,
+        options: {
+          hostname: "#{config['grpc_host']}:#{config['grpc_port']}",
+          use_ssl: config['use_ssl']
+        }
+      )
+    end
+  end
+end

data/lib/active_rpc/configuration.rb

@@ -0,0 +1,50 @@
+module ActiveRpc
+  class Configuration
+    attr_accessor :local_mode, :local_mode_data, :service_resolver
+
+    def initialize
+      @local_mode = false
+      @local_mode_data = nil
+      @service_resolver = default_service_resolver
+    end
+
+    private
+
+    def default_service_resolver
+      ->(subsystem, service_name) { "::#{subsystem.to_s.camelize}::#{service_name}".constantize }
+    end
+  end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def enable_local_mode!
+      @local_mode_override = true
+    end
+
+    def disable_local_mode!
+      @local_mode_override = false
+    end
+
+    def local_mode?
+      return @local_mode_override unless @local_mode_override.nil?
+      configuration.local_mode || false
+    end
+
+    def with_local_mode
+      original = @local_mode_override
+      @local_mode_override = true
+      begin
+        yield
+      ensure
+        @local_mode_override = original
+      end
+    end
+  end
+end

data/lib/active_rpc/model_extensions/attribute_dsl.rb

@@ -0,0 +1,31 @@
+module ActiveRpc
+  module ModelExtensions
+    class AttributeDsl
+      def initialize(config)
+        @config = config
+      end
+
+      def define_rpc_attribute(name, type, options = {})
+        @config.attributes << name.to_sym
+        @config.attribute_types[name.to_sym] = type
+        @config.attribute_defaults[name.to_sym] = options[:default] if options.key?(:default)
+      end
+
+      alias_method :attribute, :define_rpc_attribute
+
+      def query_config(options = {})
+        @config.query_config = options
+      end
+
+      def scope(name, description = nil)
+        @config.scopes ||= {}
+        @config.scopes[name] = { description: description }
+      end
+
+      def where_rpc_mapping(mappings = {})
+        @config.where_rpc_mappings ||= {}
+        @config.where_rpc_mappings.merge!(mappings)
+      end
+    end
+  end
+end