rage_arch 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0f57a7080e54d4fd38967f95f88a3e3af2a1a3716665acc79e3b2383fd3b6a4
-  data.tar.gz: '052118de065d6e08bf9c61eacce620d964b8d13f35c745c33d01e5df15515d54'
+  metadata.gz: 1efdb5d61edaeaed3b4f44b83933db1acda1a157730c0aace9084f62c7112cd4
+  data.tar.gz: 8fac4ebf0082380d5f24ae8db666de8247e317f9bb4835195c55a54c54fb58b1
 SHA512:
-  metadata.gz: 0ed85c8a86183eee47cd39bdbcb9685832a73f2d731a4a7e7ba2f4a6b88c47718418b0fae81d1059ef9be628715817a3747999e61fdba971dd8fc3a4f1cabd14
-  data.tar.gz: c3692202b97ad9e8c2ba501a1b033b5b2e6fa2cad0de41b6bdbc9f607131be2d43b11694d2f7c8fd85103a93ae2c0dff6c136d6948967e8177fcd91fc57dfbcd
+  metadata.gz: 5f2b0e4d5f7dfe2f18b1497b967695d8a4a5d452fc7546b9661ee380955abb19b0f2cf6a59fecea1200e54eb3eaa84ec0d209f440d6145f766ee509413c84fc5
+  data.tar.gz: b1641934f744c9fc48f060105044b90b3a829b2ce27ad28d974d9343c4915f04a10df033dbf0351b0d5b059d6b542a57aa016ac7037ef91fd8272d7ed96b2552

data/README.md

@@ -12,33 +12,33 @@
 
 ```bash
 bundle install
-rails g rage:install
+rails g rage_arch:install
 ```
 
-Creates `config/initializers/rage.rb`, `app/use_cases/`, `app/deps/`, and injects `include Rage::Controller` into `ApplicationController`.
+Creates `config/initializers/rage_arch.rb`, `app/use_cases/`, `app/deps/`, and injects `include RageArch::Controller` into `ApplicationController`.
 
 ---
 
 ## Components
 
-### `Rage::Result` — typed result object
+### `RageArch::Result` — typed result object
 
 ```ruby
-result = Rage::Result.success(order)
+result = RageArch::Result.success(order)
 result.success?  # => true
 result.value     # => order
 
-result = Rage::Result.failure(["Validation error"])
+result = RageArch::Result.failure(["Validation error"])
 result.failure?  # => true
 result.errors    # => ["Validation error"]
 ```
 
 ---
 
-### `Rage::UseCase::Base` — use cases
+### `RageArch::UseCase::Base` — use cases
 
 ```ruby
-class CreateOrder < Rage::UseCase::Base
+class CreateOrder < RageArch::UseCase::Base
   use_case_symbol :create_order
   deps :order_store, :notifications  # injected by symbol
 
@@ -54,23 +54,23 @@ end
 Build and run manually:
 
 ```ruby
-use_case = Rage::UseCase::Base.build(:create_order)
+use_case = RageArch::UseCase::Base.build(:create_order)
 result = use_case.call(reference: "REF-1", total_cents: 1000)
 ```
 
 ---
 
-### `Rage::Container` — dependency registration
+### `RageArch::Container` — dependency registration
 
 ```ruby
-Rage.register(:order_store, MyApp::Deps::OrderStore.new)
-Rage.register_ar(:user_store, User)  # automatic ActiveRecord wrapper
-Rage.resolve(:order_store)
+RageArch.register(:order_store, MyApp::Deps::OrderStore.new)
+RageArch.register_ar(:user_store, User)  # automatic ActiveRecord wrapper
+RageArch.resolve(:order_store)
 ```
 
 ---
 
-### `Rage::Controller` — thin controller mixin
+### `RageArch::Controller` — thin controller mixin
 
 ```ruby
 def create
@@ -86,12 +86,12 @@ end
 
 ---
 
-### `Rage::EventPublisher` — domain events
+### `RageArch::EventPublisher` — domain events
 
 Every use case automatically publishes an event when it finishes. Other use cases subscribe to react:
 
 ```ruby
-class Notifications::SendPostCreatedEmail < Rage::UseCase::Base
+class Notifications::SendPostCreatedEmail < RageArch::UseCase::Base
   use_case_symbol :send_post_created_email
   deps :mailer
   subscribe :posts_create  # runs when :posts_create event is published
@@ -122,7 +122,7 @@ skip_auto_publish
 ### Orchestration — use cases calling use cases
 
 ```ruby
-class CreateOrderWithNotification < Rage::UseCase::Base
+class CreateOrderWithNotification < RageArch::UseCase::Base
   use_case_symbol :create_order_with_notification
   deps :order_store
   use_cases :orders_create, :notifications_send
@@ -142,13 +142,13 @@ end
 
 | Command | What it does |
 |---|---|
-| `rails g rage:install` | Initial setup (initializer, directories, controller mixin) |
-| `rails g rage:scaffold Post title:string` | Full CRUD: model, use cases, dep, controller, views, routes |
-| `rails g rage:scaffold Post title:string --api` | Same but API-only (JSON responses) |
-| `rails g rage:scaffold Post title:string --skip-model` | Skip model/migration if it already exists |
-| `rails g rage:use_case CreateOrder` | Generates a base use case file |
-| `rails g rage:dep post_store` | Generates a dep class by scanning method calls in use cases |
-| `rails g rage:ar_dep post_store Post` | Generates a dep that wraps an ActiveRecord model |
+| `rails g rage_arch:install` | Initial setup (initializer, directories, controller mixin) |
+| `rails g rage_arch:scaffold Post title:string` | Full CRUD: model, use cases, dep, controller, views, routes |
+| `rails g rage_arch:scaffold Post title:string --api` | Same but API-only (JSON responses) |
+| `rails g rage_arch:scaffold Post title:string --skip-model` | Skip model/migration if it already exists |
+| `rails g rage_arch:use_case CreateOrder` | Generates a base use case file |
+| `rails g rage_arch:dep post_store` | Generates a dep class by scanning method calls in use cases |
+| `rails g rage_arch:ar_dep post_store Post` | Generates a dep that wraps an ActiveRecord model |
 
 ---
 
@@ -156,8 +156,8 @@ end
 
 ```ruby
 # spec/rails_helper.rb
-require "rage/rspec_matchers"
-require "rage/fake_event_publisher"
+require "rage_arch/rspec_matchers"
+require "rage_arch/fake_event_publisher"
 ```
 
 **Result matchers:**
@@ -170,8 +170,8 @@ expect(result).to fail_with_errors(["Not found"])
 **Fake event publisher:**
 
 ```ruby
-publisher = Rage::FakeEventPublisher.new
-Rage.register(:event_publisher, publisher)
+publisher = RageArch::FakeEventPublisher.new
+RageArch.register(:event_publisher, publisher)
 # ... run use case ...
 expect(publisher.published).to include(hash_including(event: :post_created))
 publisher.clear
@@ -179,11 +179,23 @@ publisher.clear
 
 ---
 
+## Boot verification
+
+At boot, `RageArch.verify_deps!` runs automatically and raises if any dep, method, or use case reference is unregistered. Disable with `config.rage.verify_deps = false`.
+
+---
+
+## Instrumentation
+
+Every use case emits `"rage.use_case.run"` via `ActiveSupport::Notifications` with payload `symbol`, `params`, `success`, `errors`, `result`.
+
+---
+
 ## Documentation
 
 - [`doc/REFERENCE.md`](doc/REFERENCE.md) — Full API reference with all options and examples
 - [`doc/DOCUMENTATION.md`](doc/DOCUMENTATION.md) — Detailed behaviour (use cases, deps, events, config)
-- [`doc/DAY_OF_WORK.md`](doc/DAY_OF_WORK.md) — Quick reference for common tasks
+- [`doc/GETTING_STARTED.md`](doc/GETTING_STARTED.md) — Getting started guide with common tasks
 
 ## License
 

data/lib/generators/rage_arch/templates/ar_dep.rb.tt

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Dep for :<%= symbol_name %>. Wraps the <%= model_name %> Active Record model.
-# Register in config/initializers/rage_arch.rb: Rage.register(:<%= symbol_name %>, <%= full_class_name %>.new)
+# Register in config/initializers/rage_arch.rb: RageArch.register(:<%= symbol_name %>, <%= full_class_name %>.new)
 module <%= module_name %>
   class <%= class_name %>
     def initialize

data/lib/generators/rage_arch/templates/dep.rb.tt

@@ -2,7 +2,7 @@
 
 # Dep for :<%= symbol_name %>.
 # Methods detected from use cases: <%= @methods.join(', ') %>.
-# Register in config/initializers/rage_arch.rb: Rage.register(:<%= symbol_name %>, <%= full_class_name %>.new)
+# Register in config/initializers/rage_arch.rb: RageArch.register(:<%= symbol_name %>, <%= full_class_name %>.new)
 module <%= module_name %>
   class <%= class_name %>
 <% @methods.each do |method_name| -%>

data/lib/generators/rage_arch/templates/rage_arch.rb.tt

@@ -1,15 +1,19 @@
 # frozen_string_literal: true
 
 # Register your app's deps here. Deps are grouped by module (e.g. app/deps/posts/post_repo.rb → Posts::PostRepo).
-# Use Rage.register(:symbol, ClassName.new) or Rage.register_ar(:symbol, Model) for AR-backed deps.
+# Use RageArch.register(:symbol, ClassName.new) or RageArch.register_ar(:symbol, Model) for AR-backed deps.
 
 Rails.application.config.after_initialize do
   # Deps
-  # Rage.register(:post_repo, Posts::PostRepo.new)
-  # Rage.register_ar(:user_repo, User)
+  # RageArch.register(:post_repo, Posts::PostRepo.new)
+  # RageArch.register_ar(:user_repo, User)
 
   # Event publisher: use cases that declare subscribe :event_name are wired here.
   publisher = RageArch::EventPublisher.new
   RageArch::UseCase::Base.wire_subscriptions_to(publisher)
-  Rage.register(:event_publisher, publisher)
+  RageArch.register(:event_publisher, publisher)
+
+  # Called here (after all deps are registered) instead of relying on the Railtie,
+  # which runs before this block. Skipped during asset precompilation.
+  RageArch.verify_deps! unless ENV["SECRET_KEY_BASE_DUMMY"].present?
 end

data/lib/rage_arch/railtie.rb

@@ -12,12 +12,20 @@ module RageArch
     # Load use case files so they register their symbols in the registry.
     # Without this, build(:symbol) would fail until the use case constant was referenced.
     config.after_initialize do |app|
+      # Skip everything during asset precompilation — no deps are registered then.
+      next if ENV["SECRET_KEY_BASE_DUMMY"].present?
+
       use_cases_dir = app.root.join("app/use_cases")
       if use_cases_dir.exist?
         Dir[use_cases_dir.join("**/*.rb")].sort.each { |f| require f }
       end
 
-      RageArch.verify_deps! if app.config.rage.verify_deps != false
+      # NOTE: verify_deps! is intentionally NOT called here. This after_initialize
+      # runs before the app's own initializers' after_initialize blocks, so deps
+      # registered there would not be visible yet. Apps should call
+      # RageArch.verify_deps! manually at the end of their own after_initialize
+      # (config/initializers/rage_arch.rb), after all deps are registered.
+      # Set config.rage.verify_deps = false to opt out.
     end
   end
 end

data/lib/rage_arch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RageArch
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rage_arch
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Rage Corp