plutonium 0.33.1 → 0.34.0

data/gemfiles/rails_8.1.gemfile.lock

@@ -0,0 +1,419 @@
+PATH
+  remote: ..
+  specs:
+    plutonium (0.33.1)
+      action_policy (~> 0.7.0)
+      listen (~> 3.8)
+      pagy (~> 9.0)
+      phlex (~> 2.0)
+      phlex-rails
+      phlex-slotable (>= 1.0.0)
+      phlex-tabler_icons
+      phlexi-display (>= 0.2.0)
+      phlexi-field (>= 0.2.0)
+      phlexi-form (>= 0.10.0)
+      phlexi-menu (>= 0.4.0)
+      phlexi-table (>= 0.2.0)
+      rabl (~> 0.16.1)
+      rails (>= 7.2)
+      redcarpet
+      semantic_range (~> 3.0)
+      tailwind_merge
+      tty-prompt (~> 0.23.1)
+      zeitwerk
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    action_policy (0.7.6)
+      ruby-next-core (>= 1.0)
+    action_text-trix (2.1.16)
+      railties
+    actioncable (8.1.1)
+      actionpack (= 8.1.1)
+      activesupport (= 8.1.1)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+      zeitwerk (~> 2.6)
+    actionmailbox (8.1.1)
+      actionpack (= 8.1.1)
+      activejob (= 8.1.1)
+      activerecord (= 8.1.1)
+      activestorage (= 8.1.1)
+      activesupport (= 8.1.1)
+      mail (>= 2.8.0)
+    actionmailer (8.1.1)
+      actionpack (= 8.1.1)
+      actionview (= 8.1.1)
+      activejob (= 8.1.1)
+      activesupport (= 8.1.1)
+      mail (>= 2.8.0)
+      rails-dom-testing (~> 2.2)
+    actionpack (8.1.1)
+      actionview (= 8.1.1)
+      activesupport (= 8.1.1)
+      nokogiri (>= 1.8.5)
+      rack (>= 2.2.4)
+      rack-session (>= 1.0.1)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+      useragent (~> 0.16)
+    actiontext (8.1.1)
+      action_text-trix (~> 2.1.15)
+      actionpack (= 8.1.1)
+      activerecord (= 8.1.1)
+      activestorage (= 8.1.1)
+      activesupport (= 8.1.1)
+      globalid (>= 0.6.0)
+      nokogiri (>= 1.8.5)
+    actionview (8.1.1)
+      activesupport (= 8.1.1)
+      builder (~> 3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activejob (8.1.1)
+      activesupport (= 8.1.1)
+      globalid (>= 0.3.6)
+    activemodel (8.1.1)
+      activesupport (= 8.1.1)
+    activerecord (8.1.1)
+      activemodel (= 8.1.1)
+      activesupport (= 8.1.1)
+      timeout (>= 0.4.0)
+    activestorage (8.1.1)
+      actionpack (= 8.1.1)
+      activejob (= 8.1.1)
+      activerecord (= 8.1.1)
+      activesupport (= 8.1.1)
+      marcel (~> 1.0)
+    activesupport (8.1.1)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    ansi (1.5.0)
+    appraisal (2.5.0)
+      bundler
+      rake
+      thor (>= 0.14.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bcrypt (3.1.21)
+    bigdecimal (4.0.1)
+    brakeman (7.1.1)
+      racc
+    builder (3.3.0)
+    bundle-audit (0.1.0)
+      bundler-audit
+    bundler-audit (0.9.2)
+      bundler (>= 1.2.0, < 3)
+      thor (~> 1.0)
+    chunky_png (1.4.0)
+    combustion (1.5.0)
+      activesupport (>= 3.0.0)
+      railties (>= 3.0.0)
+      thor (>= 0.14.6)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
+    crass (1.0.6)
+    date (3.5.1)
+    drb (2.2.3)
+    erb (6.0.1)
+    erubi (1.13.1)
+    ffi (1.17.3-arm64-darwin)
+    fiber-local (1.1.0)
+      fiber-storage
+    fiber-storage (1.0.1)
+    globalid (1.3.0)
+      activesupport (>= 6.1)
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    importmap-rails (2.1.0)
+      actionpack (>= 6.0.0)
+      activesupport (>= 6.0.0)
+      railties (>= 6.0.0)
+    io-console (0.8.2)
+    irb (1.16.0)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.18.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    listen (3.10.0)
+      logger
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    logger (1.7.0)
+    loofah (2.25.0)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
+    mail (2.9.0)
+      logger
+      mini_mime (>= 0.1.1)
+      net-imap
+      net-pop
+      net-smtp
+    marcel (1.1.0)
+    mini_mime (1.1.5)
+    minitest (6.0.1)
+      prism (~> 1.5)
+    minitest-reporters (1.7.1)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    net-imap (0.6.2)
+      date
+      net-protocol
+    net-pop (0.1.2)
+      net-protocol
+    net-protocol (0.2.2)
+      timeout
+    net-smtp (0.5.1)
+      net-protocol
+    nio4r (2.7.5)
+    nokogiri (1.19.0-arm64-darwin)
+      racc (~> 1.4)
+    pagy (9.4.0)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    phlex (2.3.1)
+      zeitwerk (~> 2.7)
+    phlex-rails (2.3.1)
+      phlex (~> 2.3.0)
+      railties (>= 7.1, < 9)
+      zeitwerk (~> 2.7)
+    phlex-slotable (1.0.0)
+      phlex (>= 2, < 3)
+    phlex-tabler_icons (0.3.0)
+    phlexi-display (0.2.0)
+      activesupport
+      phlex (~> 2.0)
+      phlexi-field (~> 0.2.0)
+      zeitwerk
+    phlexi-field (0.2.0)
+      activesupport (>= 7.1)
+      fiber-local
+      phlex (~> 2.0)
+      zeitwerk
+    phlexi-form (0.11.0)
+      activesupport
+      phlex (~> 2.0)
+      phlexi-field (~> 0.2.0)
+      zeitwerk
+    phlexi-menu (0.4.0)
+      phlex (~> 2.0)
+      phlexi-field (~> 0.2.0)
+      zeitwerk
+    phlexi-table (0.2.0)
+      activesupport
+      phlex (~> 2.0)
+      phlexi-display
+      phlexi-field (~> 0.2.0)
+      zeitwerk
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.7.0)
+    propshaft (1.3.1)
+      actionpack (>= 7.0.0)
+      activesupport (>= 7.0.0)
+      rack
+    psych (5.3.1)
+      date
+      stringio
+    puma (6.5.0)
+      nio4r (~> 2.0)
+    rabl (0.16.1)
+      activesupport (>= 2.3.14)
+    racc (1.8.1)
+    rack (3.2.4)
+    rack-session (2.1.1)
+      base64 (>= 0.1.0)
+      rack (>= 3.0.0)
+    rack-test (2.2.0)
+      rack (>= 1.3)
+    rackup (2.3.1)
+      rack (>= 3)
+    rails (8.1.1)
+      actioncable (= 8.1.1)
+      actionmailbox (= 8.1.1)
+      actionmailer (= 8.1.1)
+      actionpack (= 8.1.1)
+      actiontext (= 8.1.1)
+      actionview (= 8.1.1)
+      activejob (= 8.1.1)
+      activemodel (= 8.1.1)
+      activerecord (= 8.1.1)
+      activestorage (= 8.1.1)
+      activesupport (= 8.1.1)
+      bundler (>= 1.15.0)
+      railties (= 8.1.1)
+    rails-dom-testing (2.3.0)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.6.2)
+      loofah (~> 2.21)
+      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
+    railties (8.1.1)
+      actionpack (= 8.1.1)
+      activesupport (= 8.1.1)
+      irb (~> 1.13)
+      rackup (>= 1.0.0)
+      rake (>= 12.2)
+      thor (~> 1.0, >= 1.2.2)
+      tsort (>= 0.2)
+      zeitwerk (~> 2.6)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
+    rdoc (7.0.3)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    redcarpet (3.6.1)
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    roda (3.100.0)
+      rack
+    rodauth (2.42.0)
+      roda (>= 2.6.0)
+      sequel (>= 4)
+    rodauth-model (0.4.0)
+      rodauth (~> 2.28)
+    rodauth-rails (2.1.2)
+      railties (>= 5.1)
+      roda (~> 3.76)
+      rodauth (~> 2.36)
+      rodauth-model (~> 0.2)
+    rotp (6.3.0)
+    rqrcode (3.2.0)
+      chunky_png (~> 1.0)
+      rqrcode_core (~> 2.0)
+    rqrcode_core (2.1.0)
+    rubocop (1.80.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.47.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-next-core (1.2.0)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    semantic_range (3.1.0)
+    sequel (5.100.0)
+      bigdecimal
+    sequel-activerecord_connection (2.0.1)
+      activerecord (>= 5.1)
+      sequel (~> 5.38)
+    sin_lru_redux (2.5.2)
+    sqlite3 (2.6.0-arm64-darwin)
+    standard (1.51.1)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.80.2)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.8.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.25.0)
+    stimulus-rails (1.3.4)
+      railties (>= 6.0.0)
+    stringio (3.2.0)
+    tailwind_merge (1.3.2)
+      sin_lru_redux (~> 2.5)
+    thor (1.5.0)
+    tilt (2.7.0)
+    timeout (0.6.0)
+    tsort (0.2.0)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.2)
+    turbo-rails (2.0.13)
+      actionpack (>= 7.1.0)
+      railties (>= 7.1.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+    uri (1.1.1)
+    useragent (0.16.11)
+    websocket-driver (0.8.0)
+      base64
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.5)
+    wisper (2.0.1)
+    zeitwerk (2.7.4)
+
+PLATFORMS
+  arm64-darwin
+
+DEPENDENCIES
+  appraisal
+  bcrypt
+  brakeman
+  bundle-audit
+  combustion
+  importmap-rails
+  minitest
+  minitest-reporters
+  plutonium!
+  propshaft
+  puma (>= 5.0)
+  rails (~> 8.1.0)
+  rake
+  rodauth-rails
+  rotp
+  rqrcode
+  sequel-activerecord_connection
+  sqlite3
+  standard
+  stimulus-rails
+  tilt
+  turbo-rails
+  tzinfo-data
+
+BUNDLED WITH
+   2.5.16

data/lib/generators/pu/gem/dotenv/templates/.env

@@ -1,6 +1,8 @@
 # Secrets should NOT be added here.
 # Set them in `.env.local`
 
+RAILS_DEFAULT_URL="http://localhost:3000"
+
 # # == S3
 # S3_REGION=S3_REGION
 # S3_BUCKET=S3_BUCKET

data/lib/generators/pu/gem/dotenv/templates/config/initializers/001_ensure_required_env.rb

@@ -1,7 +1,9 @@
 return if ENV["SECRET_KEY_BASE_DUMMY"].present?
 
 # Add required env vars to this list
-required_env_vars = %w[]
+required_env_vars = %w[
+  RAILS_DEFAULT_URL
+]
 
 if Rails.env.production?
   required_env_vars += %w[RAILS_MASTER_KEY DATABASE_URL]

data/lib/generators/pu/lib/plutonium_generators/model_generator_base.rb

@@ -93,13 +93,13 @@ module PlutoniumGenerators
             end
 
             if name.include? "/"
-              attr_options[:to_table] = name.tr("/", "_").pluralize.to_sym
+              attr_options[:to_table] = name.underscore.tr("/", "_").pluralize.to_sym
               attr_options[:class_name] = name.classify
+              name = name.underscore
               if (shared_namespace = find_shared_namespace(model_name, name, separator: "/"))
-                name = name.sub "#{shared_namespace}/", ""
+                name = name.sub("#{shared_namespace}/", "")
               end
-
-              name = name.tr "/", "_"
+              name = name.tr("/", "_")
             end
           end
 
@@ -109,12 +109,12 @@ module PlutoniumGenerators
         private
 
         def parse_type_and_options(type)
+          nullable = type&.include?("?")
+          type = type&.sub("?", "") if nullable
+
           parsed_type, parsed_options = super
 
-          if type&.ends_with?("?")
-            parsed_type.remove!("?")
-            parsed_options[:null] = true
-          end
+          parsed_options[:null] = nullable ? true : false
 
           [parsed_type, parsed_options]
         end
@@ -122,14 +122,10 @@ module PlutoniumGenerators
         private
 
         def find_shared_namespace(model1, model2, separator: "::")
-          # Split the model names by separator to get the namespaces and class names as arrays
-          parts1 = model1.split(separator)
-          parts2 = model2.split(separator)
+          parts1 = model1.underscore.split(separator)
+          parts2 = model2.underscore.split(separator)
 
-          # Initialize an array to hold the shared namespace parts
           shared_namespace = []
-
-          # Iterate over the shorter of the two arrays
           [parts1.length, parts2.length].min.times do |i|
             if parts1[i] == parts2[i]
               shared_namespace << parts1[i]
@@ -138,13 +134,14 @@ module PlutoniumGenerators
             end
           end
 
-          # Return the shared namespace, joined by '::' or nil if there's no shared namespace
           shared_namespace.empty? ? nil : shared_namespace.join(separator)
         end
       end
 
       def required?
-        super || attr_options[:null] != true
+        return false if attr_options[:null] == true
+
+        super
       end
 
       def cents?

data/lib/generators/pu/pkg/portal/USAGE

@@ -0,0 +1,65 @@
+Description:
+    Generates a Plutonium portal package (web interface).
+
+Usage:
+    rails g pu:pkg:portal NAME [options]
+
+Options:
+    --auth=NAME      Rodauth account to authenticate with (e.g., --auth=user)
+    --public         Grant public access (no authentication required)
+    --byo       Bring your own authentication (configure manually)
+
+    Without options, the generator prompts interactively for authentication choice.
+
+Examples:
+    # Interactive mode (prompts for auth configuration)
+    rails g pu:pkg:portal admin
+
+    # With Rodauth authentication
+    rails g pu:pkg:portal admin --auth=admin
+    rails g pu:pkg:portal dashboard --auth=user
+
+    # Public access (no authentication)
+    rails g pu:pkg:portal api --public
+
+    # Custom authentication (implement your own)
+    rails g pu:pkg:portal custom --byo
+
+Generated Structure:
+    packages/[name]_portal/
+    ├── app/
+    │   ├── controllers/[name]_portal/
+    │   │   ├── concerns/controller.rb
+    │   │   ├── plutonium_controller.rb
+    │   │   ├── resource_controller.rb
+    │   │   └── dashboard_controller.rb
+    │   ├── definitions/[name]_portal/
+    │   ├── policies/[name]_portal/
+    │   └── views/[name]_portal/
+    ├── config/
+    │   └── routes.rb
+    └── lib/
+        └── engine.rb
+
+Authentication Modes:
+    Rodauth:
+        Uses Plutonium::Auth::Rodauth(:account_name) in controller concern.
+        Requires rodauth account to be set up first.
+
+    Public:
+        Uses Plutonium::Auth::Public in controller concern.
+        No authentication required for any routes.
+
+    Bring Your Own:
+        Uses Plutonium::Auth::Public as base.
+        Implement current_user method in controller concern.
+
+After Generation:
+    1. Mount the portal in config/routes.rb:
+       mount AdminPortal::Engine, at: "/admin"
+
+    2. Connect resources to the portal:
+       rails g pu:res:conn Post --dest=admin_portal
+
+    3. Optionally configure entity scoping in engine.rb:
+       scope_to_entity Organization, strategy: :path

data/lib/generators/pu/pkg/portal/portal_generator.rb

@@ -13,17 +13,13 @@ module Pu
 
       argument :name
 
+      class_option :auth, type: :string, desc: "Rodauth account to authenticate with (e.g., --auth=user)"
+      class_option :public, type: :boolean, default: false, desc: "Grant public access (no authentication)"
+      class_option :byo, type: :boolean, default: false, desc: "Bring your own authentication"
+
       def start
         validate_package_name name
-
-        if defined?(RodauthApp) && (rodauths = RodauthApp.opts[:rodauths].keys).present?
-          rodauth_account = prompt.select("Select rodauth account to authenticate with:", rodauths + [:none])
-          @rodauth_account = rodauth_account unless rodauth_account == :none
-        elsif prompt.yes?("Do you want to grant public access?")
-          @public_access = true
-        else
-          @bring_your_own_auth = true
-        end
+        configure_authentication
 
         template "lib/engine.rb", "packages/#{package_namespace}/lib/engine.rb"
         template "config/routes.rb", "packages/#{package_namespace}/config/routes.rb"
@@ -56,6 +52,23 @@ module Pu
 
       attr_reader :rodauth_account
 
+      def configure_authentication
+        if options[:auth].present?
+          @rodauth_account = options[:auth].to_sym
+        elsif options[:public]
+          @public_access = true
+        elsif options[:byo]
+          @bring_your_own_auth = true
+        elsif defined?(RodauthApp) && (rodauths = RodauthApp.opts[:rodauths].keys).present?
+          rodauth_account = prompt.select("Select rodauth account to authenticate with:", rodauths + [:none])
+          @rodauth_account = rodauth_account unless rodauth_account == :none
+        elsif prompt.yes?("Do you want to grant public access?")
+          @public_access = true
+        else
+          @bring_your_own_auth = true
+        end
+      end
+
       def package_name
         name.camelize + "Portal"
       end

data/lib/generators/pu/res/conn/USAGE

@@ -0,0 +1,71 @@
+Description:
+    Connects resources to a portal for web access. Creates portal-specific
+    controller, policy, and definition, and registers routes.
+
+Usage:
+    rails g pu:res:conn [RESOURCES...] [options]
+
+Options:
+    --dest=PORTAL        Target portal package (e.g., admin_portal)
+    --src=PACKAGE        Source feature package (optional)
+                         Use main_app for resources in the main application
+                         Use package name for resources in a feature package
+
+Arguments:
+    RESOURCES            Space-separated list of model names to connect.
+                         Use full namespaced names for packaged resources.
+                         If omitted, prompts for interactive selection.
+
+Examples:
+    # Connect main_app resource (not in a package)
+    rails g pu:res:conn PropertyAmenity --dest=admin_portal
+
+    # Connect multiple main_app resources
+    rails g pu:res:conn Post Comment Tag --dest=admin_portal
+
+    # Connect namespaced resources (from a feature package)
+    rails g pu:res:conn Blogging::Post Blogging::Comment --dest=admin_portal
+
+    # Interactive mode (prompts for everything)
+    rails g pu:res:conn
+
+    # Specify source package explicitly
+    rails g pu:res:conn --src=blogging --dest=admin_portal
+
+    # Specify main_app as source explicitly
+    rails g pu:res:conn --src=main_app --dest=admin_portal
+
+Generated Files:
+    For resource Post connected to admin_portal:
+
+    Controller: packages/admin_portal/app/controllers/admin_portal/posts_controller.rb
+    Policy:     packages/admin_portal/app/policies/admin_portal/post_policy.rb (if needed)
+    Definition: packages/admin_portal/app/definitions/admin_portal/post_definition.rb (if needed)
+    Routes:     Updates packages/admin_portal/config/routes.rb
+
+Generated Code:
+    Controller inherits from resource's base controller:
+        class AdminPortal::PostsController < ::PostsController
+          include AdminPortal::Concerns::Controller
+        end
+
+    Policy inherits from resource's base policy with portal mixin:
+        class AdminPortal::PostPolicy < ::PostPolicy
+          include AdminPortal::ResourcePolicy
+        end
+
+    Routes register the resource:
+        register_resource ::Blogging::Post
+
+Workflow:
+    1. Create feature package:  rails g pu:pkg:package blogging
+    2. Create resources:        rails g pu:res:scaffold Post ... --dest=blogging
+    3. Run migrations:          rails db:migrate
+    4. Create portal:           rails g pu:pkg:portal admin
+    5. Connect to portal:       rails g pu:res:conn Blogging::Post --dest=admin_portal
+
+Notes:
+    - Always use this generator instead of manually connecting resources
+    - Portal policies/definitions allow per-portal customization
+    - Run after creating resources with pu:res:scaffold
+    - Run after migrations so attributes can be detected