natswork-client 0.0.1

data/lib/natswork/rails/generators/job_generator.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'rails/generators/named_base'
+
+module NatsWork
+  module Generators
+    class JobGenerator < Rails::Generators::NamedBase
+      desc 'Creates a new NatsWork job class'
+
+      source_root File.expand_path('templates', __dir__)
+
+      argument :methods, type: :array, default: [], banner: 'method method'
+
+      class_option :queue, type: :string, default: 'default',
+                           desc: 'Queue name for this job'
+
+      class_option :retries, type: :numeric, default: 3,
+                             desc: 'Number of retries for this job'
+
+      class_option :timeout, type: :numeric, default: 30,
+                             desc: 'Timeout in seconds for this job'
+
+      def create_job_file
+        template 'job.rb.erb', File.join('app/jobs', class_path, "#{file_name}_job.rb")
+      end
+
+      def create_test_file
+        if defined?(RSpec)
+          template 'job_spec.rb.erb',
+                   File.join('spec/jobs', class_path, "#{file_name}_job_spec.rb")
+        else
+          template 'job_test.rb.erb',
+                   File.join('test/jobs', class_path, "#{file_name}_job_test.rb")
+        end
+      end
+    end
+  end
+end

data/lib/natswork/rails/generators/templates/job.rb.erb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+<% module_namespacing do -%>
+class <%= class_name %>Job < NatsWork::Job
+  queue '<%= options[:queue] %>'
+  retries <%= options[:retries] %>
+  timeout <%= options[:timeout] %>
+  
+  def perform(<%= methods.empty? ? '*args' : methods.map { |m| m.underscore }.join(', ') %>)
+<% if methods.any? -%>
+<% methods.each do |method| -%>
+    # Process <%= method.underscore %>
+<% end -%>
+<% else -%>
+    # Implement job logic here
+<% end -%>
+  end
+end
+<% end -%>

data/lib/natswork/rails/generators/templates/job_spec.rb.erb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'rails_helper'
+
+<% module_namespacing do -%>
+RSpec.describe <%= class_name %>Job, type: :job do
+  describe '#perform' do
+    it 'executes the job successfully' do
+      job = described_class.new
+<% if methods.any? -%>
+      expect { job.perform(<%= methods.map { |m| ":#{m.underscore}" }.join(', ') %>) }.not_to raise_error
+<% else -%>
+      expect { job.perform('test') }.not_to raise_error
+<% end -%>
+    end
+    
+    it 'is registered in the job registry' do
+      expect(NatsWork::Registry.instance.registered?('<%= class_name %>Job')).to be true
+    end
+    
+    it 'uses the correct queue' do
+      metadata = NatsWork::Registry.instance.metadata_for('<%= class_name %>Job')
+      expect(metadata[:queue]).to eq('<%= options[:queue] %>')
+    end
+  end
+end
+<% end -%>

data/lib/natswork/rails/generators/templates/job_test.rb.erb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+<% module_namespacing do -%>
+class <%= class_name %>JobTest < ActiveSupport::TestCase
+  def setup
+    @job = <%= class_name %>Job.new
+  end
+  
+  test 'performs job successfully' do
+<% if methods.any? -%>
+    assert_nothing_raised { @job.perform(<%= methods.map { |m| ":#{m.underscore}" }.join(', ') %>) }
+<% else -%>
+    assert_nothing_raised { @job.perform('test') }
+<% end -%>
+  end
+  
+  test 'is registered in the job registry' do
+    assert NatsWork::Registry.instance.registered?('<%= class_name %>Job')
+  end
+  
+  test 'uses the correct queue' do
+    metadata = NatsWork::Registry.instance.metadata_for('<%= class_name %>Job')
+    assert_equal '<%= options[:queue] %>', metadata[:queue]
+  end
+end
+<% end -%>

data/lib/natswork/railtie.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'rails/railtie'
+
+module NatsWork
+  class Railtie < ::Rails::Railtie
+    initializer 'natswork.setup' do
+      ActiveSupport.on_load(:after_initialize) do
+        NatsWork::Railtie.load_jobs
+      end
+    end
+
+    config.to_prepare do
+      NatsWork::Railtie.load_jobs if Rails.application.config.cache_classes == false
+    end
+
+    def self.load_jobs
+      return unless Rails.application
+
+      jobs_path = Rails.root.join('app', 'jobs')
+      return unless jobs_path.exist?
+
+      NatsWork::Registry.instance.scan_directory(jobs_path.to_s)
+
+      Rails.logger.info "[NatsWork] Loaded #{NatsWork::Registry.instance.size} job(s)"
+    end
+
+    console do
+      # Load console helpers when Rails console starts
+      require 'natswork/rails/console_helpers'
+    end
+
+    generators do
+      require 'natswork/rails/generators/job_generator'
+    end
+  end
+end

data/lib/natswork/registry.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require 'singleton'
+require 'concurrent'
+require 'json'
+require 'natswork/errors'
+
+module NatsWork
+  class Registry
+    include Singleton
+
+    def initialize
+      @mutex = Mutex.new
+      @jobs = Concurrent::Hash.new
+      @metadata = Concurrent::Hash.new
+    end
+
+    def register(name, job_class, options = {})
+      name = name.to_s
+      @mutex.synchronize do
+        @jobs[name] = job_class
+        @metadata[name] = build_metadata(job_class, options)
+      end
+    end
+
+    def lookup(name)
+      @jobs[name.to_s]
+    end
+
+    def lookup!(name)
+      job_class = lookup(name)
+      raise UnknownJobError, "Unknown job: #{name}" unless job_class
+
+      job_class
+    end
+
+    def registered?(name)
+      @jobs.key?(name.to_s)
+    end
+
+    def jobs_for_queue(queue_name)
+      @jobs.select do |name, _|
+        metadata = @metadata[name]
+        metadata && metadata[:queue] == queue_name
+      end.to_a
+    end
+
+    def queues
+      @metadata.values.map { |m| m[:queue] }.compact.uniq
+    end
+
+    def all
+      @jobs.to_a
+    end
+
+    def size
+      @jobs.size
+    end
+
+    def clear!
+      @mutex.synchronize do
+        @jobs.clear
+        @metadata.clear
+      end
+    end
+
+    def metadata_for(name)
+      @metadata[name.to_s]
+    end
+
+    def alias(alias_name, source_name)
+      source_class = lookup!(source_name)
+      source_metadata = @metadata[source_name.to_s]
+
+      @mutex.synchronize do
+        @jobs[alias_name.to_s] = source_class
+        @metadata[alias_name.to_s] = source_metadata.dup if source_metadata
+      end
+    end
+
+    def to_h
+      @mutex.synchronize do
+        @jobs.each_with_object({}) do |(name, klass), hash|
+          metadata = @metadata[name] || {}
+          hash[name] = metadata.merge(class: klass.name)
+        end
+      end
+    end
+
+    def to_json(*args)
+      to_h.transform_values do |meta|
+        meta.except(:class).merge('class' => meta[:class])
+      end.to_json(*args)
+    end
+
+    def load_from_hash(config)
+      @mutex.synchronize do
+        config.each do |name, settings|
+          class_name = settings['class'] || settings[:class]
+          job_class = Object.const_get(class_name)
+
+          options = settings.dup
+          options.delete('class')
+          options.delete(:class)
+
+          @jobs[name] = job_class
+          @metadata[name] = build_metadata(job_class, symbolize_keys(options))
+        end
+      end
+    end
+
+    def scan_directory(path)
+      Dir.glob(File.join(path, '**', '*.rb')).sort.each do |file|
+        require file
+      end
+    end
+
+    private
+
+    def build_metadata(job_class, options)
+      {
+        class: job_class,
+        queue: options[:queue] || 'default',
+        retries: options[:retries],
+        timeout: options[:timeout]
+      }.compact
+    end
+
+    def symbolize_keys(hash)
+      hash.transform_keys(&:to_sym)
+    end
+  end
+end

data/lib/natswork/serializer.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'time'
+require 'date'
+
+module NatsWork
+  class SerializationError < Error; end
+
+  module Serializer
+    module_function
+
+    def dump(object)
+      JSON.generate(prepare_for_json(object))
+    rescue StandardError => e
+      raise SerializationError, "Cannot serialize object: #{e.message}"
+    end
+
+    def load(json_string, symbolize_keys: true)
+      JSON.parse(json_string.to_s, symbolize_names: symbolize_keys)
+    rescue JSON::ParserError => e
+      raise SerializationError, "Failed to parse JSON: #{e.message}"
+    end
+
+    def safe_dump(object)
+      dump(object)
+    rescue SerializationError
+      nil
+    end
+
+    def safe_load(json_string, symbolize_keys: true)
+      load(json_string, symbolize_keys: symbolize_keys)
+    rescue SerializationError
+      nil
+    end
+
+    private
+
+    def prepare_for_json(object)
+      case object
+      when Hash
+        object.transform_keys(&:to_s).transform_values { |v| prepare_for_json(v) }
+      when Array
+        object.map { |item| prepare_for_json(item) }
+      when Symbol
+        object.to_s
+      when Time
+        object.utc.iso8601
+      when Date
+        object.iso8601
+      when DateTime
+        object.to_time.utc.iso8601
+      when String, Numeric, TrueClass, FalseClass, NilClass
+        object
+      else
+        if object.respond_to?(:to_h)
+          prepare_for_json(object.to_h)
+        elsif object.respond_to?(:as_json)
+          prepare_for_json(object.as_json)
+        else
+          raise SerializationError, "Cannot serialize object of type #{object.class}"
+        end
+      end
+    end
+
+    module_function :prepare_for_json
+  end
+end

data/lib/natswork/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module NatsWork
+  VERSION = '0.1.0'
+end

data/lib/natswork-client.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+# Main entry point for natswork-client gem
+require 'natswork'

data/lib/natswork.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require 'logger'
+require 'json'
+require 'securerandom'
+require 'time'
+
+# Load core components first
+require_relative 'natswork/version'
+require_relative 'natswork/errors'
+require_relative 'natswork/configuration'
+
+# Core NatsWork module
+module NatsWork
+  class << self
+    def config
+      @config ||= Configuration.instance
+    end
+
+    def configure
+      yield(config) if block_given?
+      config
+    end
+
+    def logger
+      config.logger || Logger.new($stdout)
+    end
+  end
+end
+
+# Initialize default configuration
+NatsWork.configure
+
+# Load remaining components
+require_relative 'natswork/serializer'
+require_relative 'natswork/logging'
+require_relative 'natswork/message'
+require_relative 'natswork/connection'
+require_relative 'natswork/connection_pool'
+require_relative 'natswork/jetstream_manager'
+require_relative 'natswork/registry'
+require_relative 'natswork/job'
+require_relative 'natswork/client'

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: natswork-client
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- NatsWork Contributors
+bindir: exe
+cert_chain: []
+date: 2025-09-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: nats-pure
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: 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.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+description: Dispatch jobs to NatsWork workers via NATS messaging
+email:
+- natswork@tesote.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/active_job/queue_adapters/natswork_adapter.rb
+- lib/generators/natswork/install_generator.rb
+- lib/generators/natswork/job_generator.rb
+- lib/generators/natswork/templates/job.rb.erb
+- lib/generators/natswork/templates/job_spec.rb.erb
+- lib/generators/natswork/templates/natswork.rb.erb
+- lib/natswork-client.rb
+- lib/natswork.rb
+- lib/natswork/circuit_breaker.rb
+- lib/natswork/client.rb
+- lib/natswork/client/version.rb
+- lib/natswork/compression.rb
+- lib/natswork/configuration.rb
+- lib/natswork/connection.rb
+- lib/natswork/connection_pool.rb
+- lib/natswork/errors.rb
+- lib/natswork/jetstream_manager.rb
+- lib/natswork/job.rb
+- lib/natswork/logging.rb
+- lib/natswork/message.rb
+- lib/natswork/rails/console_helpers.rb
+- lib/natswork/rails/generators/job_generator.rb
+- lib/natswork/rails/generators/templates/job.rb.erb
+- lib/natswork/rails/generators/templates/job_spec.rb.erb
+- lib/natswork/rails/generators/templates/job_test.rb.erb
+- lib/natswork/railtie.rb
+- lib/natswork/registry.rb
+- lib/natswork/serializer.rb
+- lib/natswork/version.rb
+homepage: https://github.com/tesote/nats-work
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/tesote/nats-work
+  source_code_uri: https://github.com/tesote/nats-work
+  changelog_uri: https://github.com/tesote/nats-work/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Client gem for NatsWork job processing system
+test_files: []