plutonium 0.41.1 → 0.42.0

data/lib/plutonium/api_client/concerns/disable_api_client.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module ApiClient
+    module Concerns
+      # DisableApiClient provides the core logic for disabling API client accounts.
+      #
+      # Include this in your DisableInteraction and implement the required methods.
+      #
+      # @example Basic usage
+      #   class ApiClient::DisableInteraction < Plutonium::Resource::Interaction
+      #     include Plutonium::ApiClient::Concerns::DisableApiClient
+      #
+      #     def rodauth_name
+      #       :api_client
+      #     end
+      #   end
+      #
+      module DisableApiClient
+        extend ActiveSupport::Concern
+
+        included do
+          presents label: "Disable",
+            description: "Disable this API client (cannot be undone)",
+            icon: Phlex::TablerIcons::Ban,
+            color: :danger
+
+          attribute :resource
+
+          validates :resource, presence: true
+        end
+
+        def execute
+          login = resource.login
+
+          rodauth_instance.close_account(account_login: login)
+
+          succeed(resource).with_message(success_message(login))
+        rescue => e
+          failed(base: e.message)
+        end
+
+        private
+
+        # Override to specify the Rodauth configuration name
+        # @return [Symbol]
+        def rodauth_name
+          raise NotImplementedError, "#{self.class}#rodauth_name must return the Rodauth configuration name (e.g., :api_client)"
+        end
+
+        # Override to customize success message
+        # @param login [String] the login of the disabled API client
+        # @return [String]
+        def success_message(login)
+          "API client '#{login}' has been disabled"
+        end
+
+        def rodauth_instance
+          RodauthApp.rodauth(rodauth_name)
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/api_client.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Plutonium
+  # ApiClient module provides concerns for building API client account interactions.
+  #
+  # @example Creating an API client interaction
+  #   class ApiClient::CreateInteraction < Plutonium::Resource::Interaction
+  #     include Plutonium::ApiClient::Concerns::CreateApiClient
+  #
+  #     def rodauth_name
+  #       :api_client
+  #     end
+  #
+  #     def api_client_class
+  #       ApiClient
+  #     end
+  #   end
+  #
+  module ApiClient
+  end
+end

data/lib/plutonium/interaction/concerns/scoping.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module Interaction
+    module Concerns
+      # Scoping concern provides access to scoped records from the controller context.
+      #
+      # This handles both:
+      # - Entity scoping: Portal-level multi-tenancy via `scope_to_entity` (accessed via `current_scoped_entity`)
+      # - Parent scoping: Nested routes (accessed via `current_parent`)
+      #
+      # The `scoped_record_of_type` method checks both contexts and ensures type safety.
+      #
+      # @example Using in an interaction
+      #   class MyInteraction < Plutonium::Resource::Interaction
+      #     include Plutonium::Interaction::Concerns::Scoping
+      #
+      #     def execute
+      #       organization = scoped_record_of_type(Organization)
+      #       # Returns the Organization from either entity or parent scope
+      #     end
+      #   end
+      #
+      module Scoping
+        extend ActiveSupport::Concern
+
+        private
+
+        # Returns a scoped record that matches the expected type.
+        #
+        # Checks both entity scoping (`current_scoped_entity`) and parent scoping (`current_parent`),
+        # returning the first match that is an instance of the specified class.
+        #
+        # @param klass [Class] the expected model class
+        # @return [Object, nil] the scoped record if found and type matches, nil otherwise
+        def scoped_record_of_type(klass)
+          [current_scoped_entity, current_parent].find { |record| record.is_a?(klass) }
+        end
+
+        # Returns the parent record from the controller (nested routes).
+        #
+        # @return [Object, nil] the current parent or nil
+        def current_parent
+          view_context.controller.current_parent
+        rescue NoMethodError
+          nil
+        end
+
+        # Returns the entity record from the controller (portal multi-tenancy).
+        #
+        # @return [Object, nil] the current scoped entity or nil
+        def current_scoped_entity
+          view_context.controller.current_scoped_entity
+        rescue NoMethodError
+          nil
+        end
+
+        # Returns the appropriate parent for URL generation.
+        # Prefers entity scope over parent scope.
+        #
+        # @return [Object, nil] the entity or parent, whichever is available
+        def scoped_parent
+          current_scoped_entity || current_parent
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/interaction/response/render.rb

@@ -12,7 +12,22 @@ module Plutonium
         # @param controller [ActionController::Base] The controller instance.
         # @return [void]
         def execute(controller)
-          controller.render(*@args, @options)
+          render_args = @args
+          render_options = @options
+
+          controller.instance_eval do
+            respond_to do |format|
+              format.turbo_stream do
+                # For Turbo requests, replace the form with the rendered content
+                render turbo_stream: turbo_stream.replace(
+                  "interaction-form",
+                  view_context.render(*render_args, **render_options)
+                )
+              end
+
+              format.any { render(*render_args, **render_options) }
+            end
+          end
         end
       end
     end

data/lib/plutonium/invites/concerns/invite_user.rb

@@ -24,7 +24,7 @@ module Plutonium
         extend ActiveSupport::Concern
 
         included do
-          presents label: "Invite User", icon: Phlex::TablerIcons::Mail
+          include Plutonium::Interaction::Concerns::Scoping
 
           attribute :resource
           attribute :email

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.41.1"
+  VERSION = "0.42.0"
   NEXT_MAJOR_VERSION = VERSION.split(".").tap { |v|
     v[1] = v[1].to_i + 1
     v[2] = 0

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radioactive-labs/plutonium",
-  "version": "0.41.1",
+  "version": "0.42.0",
   "description": "Build production-ready Rails apps in minutes, not days. Convention-driven, fully customizable, AI-ready.",
   "type": "module",
   "main": "src/js/core.js",

data/src/js/controllers/clipboard_controller.js

@@ -0,0 +1,37 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = ["source"]
+
+  copy(event) {
+    const text = this.sourceTarget.value || this.sourceTarget.textContent
+    const button = event.currentTarget
+    const originalText = button.textContent
+
+    navigator.clipboard.writeText(text).then(() => {
+      button.textContent = "Copied!"
+      setTimeout(() => {
+        button.textContent = originalText
+      }, 2000)
+    }).catch((err) => {
+      // Fallback for browsers that don't support clipboard API
+      console.warn("Clipboard API failed, using fallback:", err)
+      this.fallbackCopy(text)
+      button.textContent = "Copied!"
+      setTimeout(() => {
+        button.textContent = originalText
+      }, 2000)
+    })
+  }
+
+  fallbackCopy(text) {
+    const textarea = document.createElement("textarea")
+    textarea.value = text
+    textarea.style.position = "fixed"
+    textarea.style.opacity = "0"
+    document.body.appendChild(textarea)
+    textarea.select()
+    document.execCommand("copy")
+    document.body.removeChild(textarea)
+  }
+}

data/src/js/controllers/register_controllers.js

@@ -23,6 +23,7 @@ import KeyValueStoreController from "./key_value_store_controller.js"
 import BulkActionsController from "./bulk_actions_controller.js"
 import FilterPanelController from "./filter_panel_controller.js"
 import TextareaAutogrowController from "./textarea_autogrow_controller.js"
+import ClipboardController from "./clipboard_controller.js"
 
 export default function (application) {
   // Register controllers here
@@ -50,4 +51,5 @@ export default function (application) {
   application.register("bulk-actions", BulkActionsController)
   application.register("filter-panel", FilterPanelController)
   application.register("textarea-autogrow", TextareaAutogrowController)
+  application.register("clipboard", ClipboardController)
 }

data/src/js/controllers/remote_modal_controller.js

@@ -3,8 +3,13 @@ import { Controller } from "@hotwired/stimulus";
 // Connects to data-controller="remote-modal"
 export default class extends Controller {
   connect() {
-    // Store original scroll position
+    // Store original scroll position and body overflow
     this.originalScrollPosition = window.scrollY;
+    this.originalOverflow = document.body.style.overflow;
+    this.bodyStateRestored = false;
+
+    // Lock body scroll
+    document.body.style.overflow = "hidden";
 
     // Show the modal
     this.element.showModal();
@@ -15,17 +20,26 @@ export default class extends Controller {
   close() {
     // Close the modal
     this.element.close();
-    // Restore the original scroll position
-    window.scrollTo(0, this.originalScrollPosition);
+    this.restoreBodyState();
   }
 
   disconnect() {
     // Clean up event listener when controller is disconnected
     this.element.removeEventListener("close", this.handleClose);
+    this.restoreBodyState();
   }
 
   handleClose() {
-    // Restore the original scroll position after dialog closes
+    this.restoreBodyState();
+  }
+
+  restoreBodyState() {
+    if (this.bodyStateRestored) return;
+    this.bodyStateRestored = true;
+
+    // Restore body overflow
+    document.body.style.overflow = this.originalOverflow || "";
+    // Restore the original scroll position
     window.scrollTo(0, this.originalScrollPosition);
   }
 }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.41.1
+  version: 0.42.0
 platform: ruby
 authors:
 - Stefan Froelich
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-09 00:00:00.000000000 Z
+date: 2026-02-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -745,6 +745,7 @@ files:
 - lib/generators/pu/rodauth/concerns/account_selector.rb
 - lib/generators/pu/rodauth/concerns/configuration.rb
 - lib/generators/pu/rodauth/concerns/feature_selector.rb
+- lib/generators/pu/rodauth/concerns/gem_helpers.rb
 - lib/generators/pu/rodauth/install_generator.rb
 - lib/generators/pu/rodauth/migration/active_record/account_expiration.erb
 - lib/generators/pu/rodauth/migration/active_record/active_sessions.erb
@@ -799,6 +800,11 @@ files:
 - lib/generators/pu/rodauth/templates/lib/tasks/rodauth_admin.rake.tt
 - lib/generators/pu/rodauth/views_generator.rb
 - lib/generators/pu/saas/USAGE
+- lib/generators/pu/saas/api_client/USAGE
+- lib/generators/pu/saas/api_client/templates/app/interactions/create_interaction.rb.tt
+- lib/generators/pu/saas/api_client/templates/app/interactions/disable_interaction.rb.tt
+- lib/generators/pu/saas/api_client/templates/lib/tasks/api_client.rake.tt
+- lib/generators/pu/saas/api_client_generator.rb
 - lib/generators/pu/saas/entity/USAGE
 - lib/generators/pu/saas/entity_generator.rb
 - lib/generators/pu/saas/membership/USAGE
@@ -825,6 +831,9 @@ files:
 - lib/plutonium/action/route_options.rb
 - lib/plutonium/action/simple.rb
 - lib/plutonium/action_policy/sti_policy_lookup.rb
+- lib/plutonium/api_client.rb
+- lib/plutonium/api_client/concerns/create_api_client.rb
+- lib/plutonium/api_client/concerns/disable_api_client.rb
 - lib/plutonium/auth.rb
 - lib/plutonium/auth/public.rb
 - lib/plutonium/auth/rodauth.rb
@@ -859,6 +868,7 @@ files:
 - lib/plutonium/helpers/turbo_stream_actions_helper.rb
 - lib/plutonium/interaction/README.md
 - lib/plutonium/interaction/base.rb
+- lib/plutonium/interaction/concerns/scoping.rb
 - lib/plutonium/interaction/concerns/workflow_dsl.rb
 - lib/plutonium/interaction/nested_attributes.rb
 - lib/plutonium/interaction/outcome.rb
@@ -1023,6 +1033,7 @@ files:
 - src/js/controllers/attachment_preview_container_controller.js
 - src/js/controllers/attachment_preview_controller.js
 - src/js/controllers/bulk_actions_controller.js
+- src/js/controllers/clipboard_controller.js
 - src/js/controllers/color_mode_controller.js
 - src/js/controllers/easymde_controller.js
 - src/js/controllers/filter_panel_controller.js