propel_authentication 0.1.1

data/lib/generators/propel_auth/unpack_generator.rb

@@ -0,0 +1,345 @@
+# frozen_string_literal: true
+
+##
+# PropelAuth unpacker that extracts the authentication GENERATOR into the host application
+#
+# Usage:
+#   rails generate propel_auth:unpack                 # Unpack entire generator (code + templates)
+#   rails generate propel_auth:unpack --force         # Overwrite existing generator files
+#   rails generate propel_auth:unpack --templates-only # Only copy templates, not generator logic
+#   rails generate propel_auth:unpack --models-only   # Only copy model templates
+#   rails generate propel_auth:unpack --controllers-only # Only copy controller templates
+#
+# This extracts the PropelAuth generator from the gem into lib/generators/propel_auth/
+# so you can customize the generator logic and templates for your specific needs.
+#
+class PropelAuth::UnpackGenerator < Rails::Generators::Base
+  source_root File.expand_path("templates", __dir__)
+  
+  desc "Extract PropelAuth generator code from gem to lib/generators/propel_auth/ for full customization"
+
+  class_option :force,
+               type: :boolean,
+               default: false,
+               desc: "Overwrite existing generator files"
+
+  class_option :templates_only,
+               type: :boolean,
+               default: false,
+               desc: "Extract only generator templates, not generator logic"
+
+  class_option :models_only,
+               type: :boolean,
+               default: false,
+               desc: "Extract only model generator templates"
+
+  class_option :controllers_only,
+               type: :boolean,
+               default: false,
+               desc: "Extract only controller generator templates"
+
+  class_option :tests_only,
+               type: :boolean,
+               default: false,
+               desc: "Extract only test generator templates"
+
+  def unpack_propel_auth_generator
+    show_welcome_message
+    
+    components_to_unpack = determine_components
+    destination_path = "lib/generators/propel_auth"
+    
+    if File.exist?(destination_path) && !options[:force]
+      say "⚠️  #{destination_path} already exists (use --force to overwrite)", :yellow
+      return
+    end
+
+    say "📦 Extracting PropelAuth generator components: #{components_to_unpack.join(', ')}", :green
+    say ""
+
+    unpack_components(components_to_unpack, destination_path)
+    show_completion_message(destination_path)
+  end
+
+  private
+
+  def show_welcome_message
+    say ""
+    say "╔══════════════════════════════════════╗", :cyan
+    say "║      UNPACK PROPEL AUTH GENERATOR    ║", :cyan  
+    say "╚══════════════════════════════════════╝", :cyan
+    say ""
+    say "This extracts the PropelAuth generator from the gem into your app", :blue
+    say "at lib/generators/propel_auth/ so you can customize generator logic and templates.", :blue
+    say ""
+    say "📦 FROM: Gem-based generator (black box)", :yellow
+    say "📁 TO:   Local generator in lib/generators/propel_auth/ (fully customizable)", :green
+    say ""
+  end
+
+  def determine_components
+    if options[:models_only]
+      return %w[models]
+    elsif options[:controllers_only]
+      return %w[controllers]
+    elsif options[:tests_only]
+      return %w[tests]
+    elsif options[:templates_only]
+      return %w[models controllers tests views concerns services config db]
+    else
+      # Default: everything including generator logic
+      return %w[models controllers tests views concerns services config db generator]
+    end
+  end
+
+  def unpack_components(components, destination_path)
+    FileUtils.mkdir_p(destination_path)
+    
+    components.each do |component|
+      unpack_component(component, destination_path)
+    end
+  end
+
+  def unpack_component(component, destination_path)
+    case component
+    when 'models'
+      copy_model_templates(destination_path)
+    when 'controllers'
+      copy_controller_templates(destination_path)
+    when 'tests'
+      copy_test_templates(destination_path)
+    when 'views'
+      copy_view_templates(destination_path)
+    when 'concerns'
+      copy_concern_templates(destination_path)
+    when 'services'
+      copy_service_templates(destination_path)
+    when 'config'
+      copy_config_templates(destination_path)
+    when 'db'
+      copy_db_templates(destination_path)
+    when 'generator'
+      copy_generator_logic(destination_path)
+    else
+      say "   ⚠️  Unknown component: #{component}", :red
+    end
+  end
+
+  def copy_model_templates(destination_path)
+    say "📂 Extracting model generator templates...", :blue
+    
+    model_files = %w[
+      user.rb
+      organization.rb
+      agency.rb
+      agent.rb
+      invitation.rb
+      authenticatable.rb
+    ]
+    
+    model_files.each do |file|
+      copy_template_file(file, destination_path)
+    end
+    
+    say "   ✅ Model generator templates extracted", :green
+  end
+
+  def copy_controller_templates(destination_path)
+    say "📂 Extracting controller generator templates...", :blue
+    
+    copy_template_file("tokens_controller.rb.tt", destination_path)
+    copy_directory_templates("auth", destination_path)
+    
+    say "   ✅ Controller generator templates extracted", :green
+  end
+
+  def copy_test_templates(destination_path)
+    say "📂 Extracting test generator templates...", :blue
+    
+    copy_template_file("user_test.rb.tt", destination_path)
+    copy_directory_templates("test", destination_path)
+    
+    say "   ✅ Test generator templates extracted", :green
+  end
+
+  def copy_view_templates(destination_path)
+    say "📂 Extracting view generator templates...", :blue
+    
+    copy_template_file("auth_mailer.rb", destination_path)
+    copy_directory_templates("views", destination_path)
+    
+    say "   ✅ View generator templates extracted", :green
+  end
+
+  def copy_concern_templates(destination_path)
+    say "📂 Extracting concern generator templates...", :blue
+    
+    copy_directory_templates("concerns", destination_path)
+    
+    say "   ✅ Concern generator templates extracted", :green
+  end
+
+  def copy_service_templates(destination_path)
+    say "📂 Extracting service generator templates...", :blue
+    
+    copy_directory_templates("services", destination_path)
+    
+    say "   ✅ Service generator templates extracted", :green
+  end
+
+  def copy_config_templates(destination_path)
+    say "📂 Extracting config generator templates...", :blue
+    
+    copy_template_file("propel_auth.rb", destination_path)
+    copy_template_file("propel_auth_configuration.rb.tt", destination_path)
+    copy_directory_templates("config", destination_path)
+    
+    say "   ✅ Config generator templates extracted", :green
+  end
+
+  def copy_db_templates(destination_path)
+    say "📂 Extracting database generator templates...", :blue
+    
+    copy_directory_templates("db", destination_path)
+    
+    say "   ✅ Database generator templates extracted", :green
+  end
+
+  def copy_generator_logic(destination_path)
+    say "📂 Extracting generator logic code...", :blue
+    
+    # Copy install generator with proper Rails namespace
+    source_generator = File.join(__dir__, "install_generator.rb")
+    dest_generator = File.join(destination_path, "install_generator.rb")
+    
+    if File.exist?(source_generator)
+      # Read the source and modify the module declaration for proper registration
+      source_content = File.read(source_generator)
+      
+      # Update module declaration to be properly namespaced in host app
+      modified_content = source_content.gsub(
+        /^module PropelAuth$/,
+        "module PropelAuth"
+      ).gsub(
+        /^  class InstallGenerator/,
+        "  class InstallGenerator"
+      )
+      
+      # Create the directory and write the modified generator
+      FileUtils.mkdir_p(File.dirname(dest_generator))
+      File.write(dest_generator, modified_content)
+      
+      say "   ✅ Install generator extracted", :green
+    else
+      say "   ⚠️  Install generator not found", :yellow
+    end
+    
+    # Also copy the unpack and pack generators
+    %w[unpack_generator.rb pack_generator.rb].each do |gen_file|
+      source_file = File.join(__dir__, gen_file)
+      dest_file = File.join(destination_path, gen_file)
+      
+      if File.exist?(source_file)
+        FileUtils.cp(source_file, dest_file)
+        say "   ✅ #{gen_file} extracted", :green
+      else
+        say "   ⚠️  #{gen_file} not found", :yellow
+      end
+    end
+    
+    # Also copy the lib runtime file
+    copy_lib_runtime(destination_path)
+  end
+
+  def copy_lib_runtime(destination_path)
+    say "📂 Extracting PropelAuth runtime code...", :blue
+    
+    lib_source = File.join(self.class.source_root, "lib", "propel_auth.rb")
+    lib_dest = File.join(destination_path, "templates", "lib", "propel_auth.rb")
+    
+    if File.exist?(lib_source)
+      FileUtils.mkdir_p(File.dirname(lib_dest))
+      FileUtils.cp(lib_source, lib_dest)
+      say "   ✅ PropelAuth runtime code extracted", :green
+    else
+      say "   ⚠️  PropelAuth runtime template not found", :yellow
+    end
+  end
+
+  def copy_template_file(filename, destination_path)
+    source_file = File.join(self.class.source_root, filename)
+    dest_file = File.join(destination_path, "templates", filename)
+    
+    if File.exist?(source_file)
+      FileUtils.mkdir_p(File.dirname(dest_file))
+      FileUtils.cp(source_file, dest_file)
+    else
+      say "   ⚠️  Template not found: #{filename}", :yellow
+    end
+  end
+
+  def copy_directory_templates(directory, destination_path)
+    source_dir = File.join(self.class.source_root, directory)
+    dest_dir = File.join(destination_path, "templates", directory)
+    
+    if Dir.exist?(source_dir)
+      FileUtils.mkdir_p(dest_dir)
+      copy_directory_recursively(source_dir, dest_dir)
+    else
+      say "   ⚠️  Directory not found: #{directory}", :yellow
+    end
+  end
+
+  def copy_directory_recursively(source, destination)
+    Dir.glob("#{source}/**/*", File::FNM_DOTMATCH).each do |source_file|
+      next if File.directory?(source_file)
+      next if File.basename(source_file).start_with?('.')
+      
+      relative_path = source_file.sub("#{source}/", '')
+      dest_file = File.join(destination, relative_path)
+      
+      FileUtils.mkdir_p(File.dirname(dest_file))
+      FileUtils.cp(source_file, dest_file)
+    end
+  end
+
+  def show_completion_message(destination_path)
+    say ""
+    say "🎉 PropelAuth GENERATOR unpacked successfully!", :green
+    say ""
+    say "📁 Generator extracted to: #{destination_path}/", :bold
+    say "📂 Templates available at: #{destination_path}/templates/", :bold
+    say ""
+    
+    say "🔧 GENERATOR customization guide:", :bold
+    say "   ⚙️  Generator logic: #{destination_path}/install_generator.rb"
+    say "   📝 Model templates: #{destination_path}/templates/user.rb, organization.rb, etc."
+    say "   🎮 Controller templates: #{destination_path}/templates/tokens_controller.rb.tt"
+    say "   🧪 Test templates: #{destination_path}/templates/test/"
+    say "   📧 Email templates: #{destination_path}/templates/views/auth_mailer/"
+    say "   ⚙️  Config templates: #{destination_path}/templates/config/"
+    say ""
+    
+    say "⚠️  Important: You now have a LOCAL GENERATOR, not gem generator:", :yellow
+    say "   • Your local generator overrides the gem version completely"
+    say "   • Customize any part: logic, templates, options, behavior"
+    say "   • Commit generator code to version control"
+    say "   • Update manually when PropelAuth gem is updated"
+    say ""
+    
+    say "💡 Test your customized generator:", :blue
+    say "   # Your local generator will be used instead of the gem:"
+    say "   rails generate propel_auth:install"
+    say ""
+    
+    say "🔄 To use gem generator again:", :cyan
+    say "   rm -rf #{destination_path}  # Removes local generator, falls back to gem"
+    say ""
+    
+    say "🚀 Now you can:", :green
+    say "   • Modify generator options and behavior in install_generator.rb"
+    say "   • Customize any template for your organization's needs"
+    say "   • Add new generator methods or change existing logic"
+    say "   • Create company-specific authentication patterns"
+  end
+end 

data/lib/propel_auth.rb

@@ -0,0 +1,3 @@
+module PropelAuth
+  VERSION = "0.1.1"
+end

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: propel_authentication
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Propel Team
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-07-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: bcrypt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.20
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.1.20
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+description: A self-extracting generator that creates a JWT-based authentication system
+  with agencies, agents, password resets, email confirmation, and account locking
+  for Rails applications.
+email:
+- admin@propel-hq.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/generators/propel_auth/install_generator.rb
+- lib/generators/propel_auth/pack_generator.rb
+- lib/generators/propel_auth/templates/agency.rb
+- lib/generators/propel_auth/templates/agent.rb
+- lib/generators/propel_auth/templates/auth/base_passwords_controller.rb.tt
+- lib/generators/propel_auth/templates/auth/base_tokens_controller.rb.tt
+- lib/generators/propel_auth/templates/auth/passwords_controller.rb.tt
+- lib/generators/propel_auth/templates/auth_mailer.rb
+- lib/generators/propel_auth/templates/authenticatable.rb
+- lib/generators/propel_auth/templates/concerns/confirmable.rb
+- lib/generators/propel_auth/templates/concerns/lockable.rb
+- lib/generators/propel_auth/templates/concerns/propel_authentication.rb
+- lib/generators/propel_auth/templates/concerns/rack_session_disable.rb
+- lib/generators/propel_auth/templates/concerns/recoverable.rb
+- lib/generators/propel_auth/templates/config/environments/development_email.rb
+- lib/generators/propel_auth/templates/db/migrate/create_agencies.rb
+- lib/generators/propel_auth/templates/db/migrate/create_agents.rb
+- lib/generators/propel_auth/templates/db/migrate/create_invitations.rb
+- lib/generators/propel_auth/templates/db/migrate/create_organizations.rb
+- lib/generators/propel_auth/templates/db/migrate/create_users.rb
+- lib/generators/propel_auth/templates/db/seeds.rb
+- lib/generators/propel_auth/templates/invitation.rb
+- lib/generators/propel_auth/templates/lib/propel_auth.rb
+- lib/generators/propel_auth/templates/organization.rb
+- lib/generators/propel_auth/templates/propel_auth.rb
+- lib/generators/propel_auth/templates/services/auth_notification_service.rb
+- lib/generators/propel_auth/templates/test/concerns/confirmable_test.rb.tt
+- lib/generators/propel_auth/templates/test/concerns/lockable_test.rb.tt
+- lib/generators/propel_auth/templates/test/concerns/propel_authentication_test.rb.tt
+- lib/generators/propel_auth/templates/test/concerns/recoverable_test.rb.tt
+- lib/generators/propel_auth/templates/test/controllers/auth/lockable_integration_test.rb.tt
+- lib/generators/propel_auth/templates/test/controllers/auth/password_reset_integration_test.rb.tt
+- lib/generators/propel_auth/templates/test/controllers/auth/tokens_controller_test.rb.tt
+- lib/generators/propel_auth/templates/test/mailers/auth_mailer_test.rb.tt
+- lib/generators/propel_auth/templates/test/mailers/previews/auth_mailer_preview.rb
+- lib/generators/propel_auth/templates/tokens_controller.rb.tt
+- lib/generators/propel_auth/templates/user.rb
+- lib/generators/propel_auth/templates/user_test.rb.tt
+- lib/generators/propel_auth/templates/views/auth_mailer/account_unlock.html.erb
+- lib/generators/propel_auth/templates/views/auth_mailer/account_unlock.text.erb
+- lib/generators/propel_auth/templates/views/auth_mailer/email_confirmation.html.erb
+- lib/generators/propel_auth/templates/views/auth_mailer/email_confirmation.text.erb
+- lib/generators/propel_auth/templates/views/auth_mailer/password_reset.html.erb
+- lib/generators/propel_auth/templates/views/auth_mailer/password_reset.text.erb
+- lib/generators/propel_auth/templates/views/auth_mailer/user_invitation.html.erb
+- lib/generators/propel_auth/templates/views/auth_mailer/user_invitation.text.erb
+- lib/generators/propel_auth/test/dummy/Dockerfile
+- lib/generators/propel_auth/test/dummy/Gemfile
+- lib/generators/propel_auth/test/dummy/Gemfile.lock
+- lib/generators/propel_auth/test/dummy/README.md
+- lib/generators/propel_auth/test/dummy/Rakefile
+- lib/generators/propel_auth/test/dummy/app/assets/stylesheets/application.css
+- lib/generators/propel_auth/test/dummy/app/controllers/application_controller.rb
+- lib/generators/propel_auth/test/dummy/app/helpers/application_helper.rb
+- lib/generators/propel_auth/test/dummy/app/jobs/application_job.rb
+- lib/generators/propel_auth/test/dummy/app/mailers/application_mailer.rb
+- lib/generators/propel_auth/test/dummy/app/models/application_record.rb
+- lib/generators/propel_auth/test/dummy/app/views/layouts/application.html.erb
+- lib/generators/propel_auth/test/dummy/app/views/layouts/mailer.html.erb
+- lib/generators/propel_auth/test/dummy/app/views/layouts/mailer.text.erb
+- lib/generators/propel_auth/test/dummy/app/views/pwa/manifest.json.erb
+- lib/generators/propel_auth/test/dummy/app/views/pwa/service-worker.js
+- lib/generators/propel_auth/test/dummy/bin/brakeman
+- lib/generators/propel_auth/test/dummy/bin/dev
+- lib/generators/propel_auth/test/dummy/bin/docker-entrypoint
+- lib/generators/propel_auth/test/dummy/bin/rails
+- lib/generators/propel_auth/test/dummy/bin/rake
+- lib/generators/propel_auth/test/dummy/bin/rubocop
+- lib/generators/propel_auth/test/dummy/bin/setup
+- lib/generators/propel_auth/test/dummy/bin/thrust
+- lib/generators/propel_auth/test/dummy/config.ru
+- lib/generators/propel_auth/test/dummy/config/application.rb
+- lib/generators/propel_auth/test/dummy/config/boot.rb
+- lib/generators/propel_auth/test/dummy/config/cable.yml
+- lib/generators/propel_auth/test/dummy/config/credentials.yml.enc
+- lib/generators/propel_auth/test/dummy/config/database.yml
+- lib/generators/propel_auth/test/dummy/config/environment.rb
+- lib/generators/propel_auth/test/dummy/config/environments/development.rb
+- lib/generators/propel_auth/test/dummy/config/environments/production.rb
+- lib/generators/propel_auth/test/dummy/config/environments/test.rb
+- lib/generators/propel_auth/test/dummy/config/initializers/assets.rb
+- lib/generators/propel_auth/test/dummy/config/initializers/content_security_policy.rb
+- lib/generators/propel_auth/test/dummy/config/initializers/filter_parameter_logging.rb
+- lib/generators/propel_auth/test/dummy/config/initializers/inflections.rb
+- lib/generators/propel_auth/test/dummy/config/locales/en.yml
+- lib/generators/propel_auth/test/dummy/config/master.key
+- lib/generators/propel_auth/test/dummy/config/puma.rb
+- lib/generators/propel_auth/test/dummy/config/routes.rb
+- lib/generators/propel_auth/test/dummy/config/storage.yml
+- lib/generators/propel_auth/test/dummy/db/schema.rb
+- lib/generators/propel_auth/test/generators/authentication/controllers/tokens_controller_test.rb
+- lib/generators/propel_auth/test/generators/authentication/install_generator_test.rb
+- lib/generators/propel_auth/test/generators/authentication/uninstall_generator_test.rb
+- lib/generators/propel_auth/test/integration/generator_integration_test.rb
+- lib/generators/propel_auth/test/integration/multi_version_generator_test.rb
+- lib/generators/propel_auth/unpack_generator.rb
+- lib/propel_auth.rb
+homepage: https://github.com/propel-hq/propel_rails.git
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/propel-hq/propel_rails.git
+  source_code_uri: https://github.com/propel-hq/propel_rails.git
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: PropelAuth - JWT authentication system generator for Rails
+test_files: []