hyraft-rule 0.1.0.alpha2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b937076a72d8bfd0cf0988d5ca46906a18ad338c08659edbea525087d45d1d4
-  data.tar.gz: 48d3f56004343a2eb270012b97bde1253bb661e3798e183179ac453947548520
+  metadata.gz: 3ceb5f5d19fd16ef3f5f54d282e81d1e15db13cac65137688889280762ab47a1
+  data.tar.gz: 14b7bd672260e3ad84089ed5c3f13282808317b6a564a6f1669a401b820f629f
 SHA512:
-  metadata.gz: 4d50fea795954a932f28614abd6dad757fb5baec3c4ac390a6ec7ebe2ffeeb371d849b06926ae003837139fc3a9a84c9f8c840a61a19235988718c284cd29628
-  data.tar.gz: 3a8c9a4d04d361c83ab1652b7479321d2b0378d9bebdb5d8ccb889c3d891a9c9c248c90e1f702ad46d23b793c6ff15c1033e30740ed68a5b268e1b44dcafad6a
+  metadata.gz: b76d6da0d1df616cb966c523b900b93e471536a18caed301b605d5adac7ade0535d0e48e5d03076a101a27287cbb36bd8aabdb95fc196ee4d27a4145f1f40f8a
+  data.tar.gz: f1e7505c49b11ec307cfc6592bdc8af86cc6f4eb12b7b5bb1dbbb2f6869b8b3f0f1e4137c5b92fa2eb819a06d43eafb1111031845a89c070c7ab75653d5603d9

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
-## [0.1.0] - 2025-11-12
+## [1.0.0] - 2026-7-12
+### Fixed
+Supports Ruby 4 and above only.
 
-- Initial release
+## [0.1.0.alpha2] - 2025-11-30
+### Fixed
+- Fixed README documentation
+- Add safety flag to disassemble command
+
+## [0.1.0.alpha1] - 2025-11-26
+- Initial release

data/README.md

@@ -29,77 +29,128 @@ This is a standalone command-line interface (CLI) for the Hyraft framework.
 ```
 
 
-## Usage ( Assemble / Disassemble )
+## Usage ( in-api )
 
+Generate:
 
 ```bash
- assemble  - Creates blueprint structure for templates, engine, and adapters.
-
- disassemble - Deconstructs the project into its core components.
+hyraft-rule in-api articles title content
+hyraft-rule in-api users name email role
+hyraft-rule in-api products name price stock
+hyraft-rule in-api posts title body author
 ```
+## Usage ( out-data )
+
+Generate:
 
 ```bash
-# Default web-app
-hyr-rule assemble articles
-hyr-rule disassemble articles
 
-# Specific app folders
+# Generate storage for any resource
+hyraft-rule out-data articles title content
+hyraft-rule out-data users name email password
+hyraft-rule out-data products name price stock quantity
+hyraft-rule out-data comments body author_id post_id
+hyraft-rule out-data posts title content published
+hyraft-rule out-data categories name description
+hyraft-rule out-data tags name
 
-hyr-rule assemble {any-folder-name}/users
+```
 
 
-hyr-rule assemble admin-app/users
-hyr-rule disassemble admin-app/users
 
-hyr-rule assemble api-app/products
-hyr-rule disassemble api-app/products
-```
 
+## Usage ( Engine )
+
+Generate:
 
+```bash
+# Generate engine with attributes
+hyraft-rule engine articles title content
 
-## Usage ( Engine )
+# With custom target directory
+hyraft-rule engine articles title content ./myapp
+
+# Without attributes (will show placeholder)
+hyraft-rule engine articles
+```
+
+## Usage ( Port )
 
 Generate:
 
 ```bash
+# Basic usage
+hyraft-rule port articles
 
-hyr-rule circuit articles
+# Different resources
+hyraft-rule port users
+hyraft-rule port products
+hyraft-rule port comments
 
-hyr-rule port articles
+# With custom path
+hyraft-rule port articles ./my_project
+```
+
+## Usage ( Cable )
+
+Generate:
+
+```bash
+# Generate cable for articles
+hyraft-rule cable articles title content
+
+# Generate cable for users
+hyraft-rule cable users name email password
 
-hyr-rule source article
+# Generate cable for products
+hyraft-rule cable products name price stock
 
+# Generate cable for comments
+hyraft-rule cable comments body author_id post_id
 ```
 
-## Usage ( Web Adapter a.k.a Controller )
+## Usage ( JWT key )
 
 Generate:
 
 ```bash
 
-# Only add the specific web adapter
-hyr-rule web-adapter articles
-hyr-rule web-adapter admin-app/products
+hyraft-rule jwt generate
+hyraft-rule jwt g
+hyraft-rule jwt show
+hyraft-rule jwt help
 
-# Only remove the specific web adapter
-hyr-rule remove-adapter articles
-hyr-rule remove-adapter admin-app/users
 ```
 
-## Usage ( data-gateway )
+## Usage ( Routes )
 
 Generate:
 
 ```bash
-hyr-rule data-gateway articles
-hyr-rule data-gateway admin-app/products
+
+# Add traditional routes for articles
+hyraft-rule routes articles tra
+
+# Add SPA routes for articles
+hyraft-rule routes articles spa
+
+# Default is tra
+hyraft-rule routes articles
+
 ```
 
+## Usage ( API Routes )
+
+Generate:
+
+```bash
 
+hyr-rule api-routes articles
+hyraft-rule api-routes articles
+```
 
 
 ## Usage ( Templates )
-- hyr-rule
 
 Generate:
 
@@ -112,8 +163,8 @@ hyr-rule template admin-app/users
 hyraft-rule template admin-app/users
 ```
 
+
 ## Usage ( For Help )
-- hyr-rule
 
 Generate:
 
@@ -135,37 +186,37 @@ hyraft-rule -h
 
 
 ## Usage ( Database ) 
-- hyr-rule-db
+- hyraft-rule-db
 
 
 Schema:  
       
 
 ```bash
-      hyr-rule-db generate create_users
-      hyr-rule-db generate add_email_to_users
+      hyraft-rule-db generate create_users
+      hyraft-rule-db generate add_email_to_users
 
    - Migration Generation Schema Examples:
    
-      hyr-rule-db generate create_users
-      hyr-rule-db generate create_articles
-      hyr-rule-db generate create_products
-      hyr-rule-db generate create_categories
-      hyr-rule-db generate add_image_file_to_articles
-      hyr-rule-db generate add_price_to_products
-      hyr-rule-db generate remove_status_from_posts
-      hyr-rule-db generate drop_old_tables
+      hyraft-rule-db generate create_users
+      hyraft-rule-db generate create_articles
+      hyraft-rule-db generate create_products
+      hyraft-rule-db generate create_categories
+      hyraft-rule-db generate add_image_file_to_articles
+      hyraft-rule-db generate add_price_to_products
+      hyraft-rule-db generate remove_status_from_posts
+      hyraft-rule-db generate drop_old_tables
 
 
     Examples:
-     hyr-rule-db generate create_articles title content:text
+     hyraft-rule-db generate create_articles title content:text
 
-     hyr-rule-db generate create_products name:string price:decimal description:text user_id:int
-     hyr-rule-db generate create_users username:string age:int email:string active:bool created_at:datetime
+     hyraft-rule-db generate create_products name:string price:decimal description:text user_id:int
+     hyraft-rule-db generate create_users username:string age:int email:string active:bool created_at:datetime
 
-     hyr-rule-db generate create_products name:string price:decimal description:text user_id:int
-     hyr-rule-db generate create_users username age:int email active:bool
-     hyr-rule-db generate create_articles title content:text published_at:datetime views:int
+     hyraft-rule-db generate create_products name:string price:decimal description:text user_id:int
+     hyraft-rule-db generate create_users username age:int email active:bool
+     hyraft-rule-db generate create_articles title content:text published_at:datetime views:int
 
 
 ```
@@ -185,18 +236,18 @@ Migrations:
 
     Examples:
 
-      hyr-rule-db migrate
-      hyr-rule-db status
-      hyr-rule-db rollback
-      hyr-rule-db reset
-      hyr-rule-db help
+      hyraft-rule-db migrate
+      hyraft-rule-db status
+      hyraft-rule-db rollback
+      hyraft-rule-db reset
+      hyraft-rule-db help
 
     Environment Usage:
 
-      hyr-rule-db migrate                     # Current environment (run: hyr s thin)
-      APP_ENV=test hyr-rule-db migrate        # Test environment (run: APP_ENV=test hyr s thin)
-      APP_ENV=development hyr-rule-db migrate # Development environment (run: APP_ENV=development hyr s thin)
-      APP_ENV=production hyr-rule-db migrate  # Production environment (run: APP_ENV=production hyr s thin)
+      hyraft-rule-db migrate                     # Current environment (run: hyr s thin)
+      APP_ENV=test hyraft-rule-db migrate        # Test environment (run: APP_ENV=test hyr s thin)
+      APP_ENV=development hyraft-rule-db migrate # Development environment (run: APP_ENV=development hyr s thin)
+      APP_ENV=production hyraft-rule-db migrate  # Production environment (run: APP_ENV=production hyr s thin)
 
     Quick Reference:
 
@@ -230,6 +281,39 @@ After checking out the repo, run `bundle install` to install dependencies.
 
 Then, run `rake test` to run the tests.
 
+```bash
+
+rake test 
+
+comment this: FileUtils.rm_rf(TEST_APP_DIR) located at test_helper.rb
+
+- To generate files
+
+
+# Run single test file
+rake test TEST=test/hyraft/rule/circuit/port_command_test.rb
+
+or
+
+ruby -Ilib:test test/hyraft/rule/circuit/port_command_test.rb
+
+# Run specific test method
+rake test TEST=test/hyraft/rule/circuit/port_command_test.rb -n test_generates_port_file
+
+# Run with pattern
+rake test TEST=test/hyraft/rule/circuit/port_command_test.rb -n /test_generates/
+
+
+
+rake test TEST=test/hyraft/rule/base/in_api_command_test.rb
+rake test TEST=test/hyraft/rule/circuit/engine_command_test.rb
+rake test TEST=test/hyraft/rule/connectors/cable_command_test.rb
+rake test TEST=test/hyraft/rule/base/out_data_command_test.rb
+
+rake test TEST=test/hyraft/rule/jwt/jwt_command_test.rb
+
+```
+
 
 ## Contributing
 

data/exe/hyraft-rule-db

@@ -1,5 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
+#hyarft-rule-db.rb
 
 require 'fileutils'
 require 'sequel'
@@ -66,7 +67,7 @@ $LOAD_PATH.unshift(APP_ROOT) unless $LOAD_PATH.include?(APP_ROOT)
 
 begin
   require File.join(APP_ROOT, 'boot')
-  require File.join(APP_ROOT, 'infra', 'database', 'sequel_connection')
+  require File.join(APP_ROOT, 'setup', 'database', 'sequel_connection')
 rescue LoadError => e
   puts "❌ Error loading dependencies: #{e.message}"
   exit 1
@@ -81,7 +82,7 @@ rescue => e
   exit 1
 end
 
-MIGRATIONS_DIR = File.join(APP_ROOT, 'infra', 'database', 'migrations')
+MIGRATIONS_DIR = File.join(APP_ROOT, 'setup', 'database', 'migrations')
 
 # -------------------------------
 # Generate Migration Methods

data/hyraft-rule.gemspec

@@ -12,16 +12,17 @@ Gem::Specification.new do |spec|
   spec.description = "This is a standalone command-line interface (CLI) for the Hyraft framework."
   spec.homepage = "https://github.com/demjhonsilver/hyraft-rule"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.4.0"
-
+  spec.required_ruby_version = ">= 4.0.0"
 
 
   spec.metadata = {
+    "homepage_uri"     => "https://github.com/demjhonsilver/hyraft-rule",
     "documentation_uri" => "https://www.rubydoc.info/gems/hyraft-rule",
-    "source_code_uri"   => "https://github.com/demjhonsilver/hyraft-rule",
+    "source_code_uri"  => "https://github.com/demjhonsilver/hyraft-rule/tree/main",
+    "changelog_uri"    => "https://github.com/demjhonsilver/hyraft-rule/blob/main/CHANGELOG.md"
   }
-
-
+  
+   spec.metadata["rubygems_mfa_required"] = "true"
 
   # Manual file listing without git dependency
 # In hyraft-rule.gemspec - update the files section
@@ -33,15 +34,15 @@ Gem::Specification.new do |spec|
     "lib/hyraft/rule.rb",
     "lib/hyraft/rule/version.rb",
     "lib/hyraft/rule/command.rb",
-    "lib/hyraft/rule/engine/source_command.rb",
-    "lib/hyraft/rule/engine/circuit_command.rb",
-    "lib/hyraft/rule/engine/port_command.rb",
-    "lib/hyraft/rule/adapter_request/web_adapter_command.rb",
-    "lib/hyraft/rule/adapter_request/remove_adapter_command.rb",
-    "lib/hyraft/rule/adapter_exhaust/data_gateway_command.rb", 
-    "lib/hyraft/rule/assemble_command.rb", 
-    "lib/hyraft/rule/disassemble_command.rb", 
-     "lib/hyraft/rule/template_command.rb", 
+    "lib/hyraft/rule/base/in_api_command.rb", 
+    "lib/hyraft/rule/base/out_data_command.rb", 
+    "lib/hyraft/rule/connectors/cable_command.rb",
+    "lib/hyraft/rule/circuit/port_command.rb",
+    "lib/hyraft/rule/circuit/engine_command.rb",
+    "lib/hyraft/rule/router/web_routes_command.rb", 
+    "lib/hyraft/rule/router/api_routes_command.rb", 
+    "lib/hyraft/rule/template/template_command.rb", 
+    "lib/hyraft/rule/jwt/jwt_command.rb", 
     "LICENSE.txt",
     "README.md",
     "CHANGELOG.md",
@@ -55,5 +56,5 @@ Gem::Specification.new do |spec|
 
   # Runtime dependencies
   spec.add_development_dependency "rake", "~> 13.3"
-  spec.add_development_dependency "minitest", "~> 5.26"
+  # spec.add_development_dependency "minitest", "~> 5.26"
 end

data/lib/hyraft/rule/base/in_api_command.rb

@@ -0,0 +1,208 @@
+# lib/hyraft/rule/base/in_api_command.rb
+
+# frozen_string_literal: true
+
+
+require 'fileutils'
+
+module Hyraft
+  module Rule
+    module Base
+      class InApiCommand
+        def self.start(args)
+          resource_name = args[0]
+          return show_usage unless resource_name
+
+          plural_name = resource_name.downcase
+          attributes = []
+
+          if args.length > 1
+            last_arg = args[-1]
+            if last_arg.include?('/') || last_arg == '.' || last_arg == '..' || last_arg.start_with?('./')
+              target_dir = last_arg
+              attributes = args[1..-2] if args.length > 2
+            else
+              target_dir = "."
+              attributes = args[1..-1]
+            end
+          else
+            target_dir = "."
+          end
+
+          singular_name = plural_name.chomp('s')
+          class_name = resource_name.split('_').map(&:capitalize).join
+          resource_class = singular_name.capitalize
+
+          filename = "#{plural_name}_request.rb"
+          request_dir = File.join(target_dir, "base-adapters", "in-api")
+          full_path = File.join(request_dir, filename)
+
+          FileUtils.mkdir_p(request_dir)
+          
+          # Ruby 4.0 Box syntax for template
+          template = %{
+# base-adapters/in-api/#{plural_name}_request.rb
+
+pathway 'connectors/cable/#{plural_name}_cable'
+
+require 'json'
+
+class #{class_name}Request
+  include HtmlSafety
+
+  def create(env)
+    input = env['BODY']
+    
+    if input.nil? || input.empty?
+      return json_response({ error: 'Empty body' }, 400)
+    end
+
+    begin
+      data = JSON.parse(input, symbolize_names: true)
+      #{attributes.map { |a| "#{a} = data[:#{a}].to_s" }.join("\n      ")}
+      
+      if #{attributes.map { |a| "#{a}.empty?" }.join(" || ")}
+        return json_response({ error: '#{attributes.map(&:capitalize).join(' and ')} required' }, 422)
+      end
+      
+      #{attributes.map { |a| "safe_#{a} = safety(#{a})" }.join("\n      ")}
+      
+      result = #{class_name}Cable.create_#{singular_name}(#{attributes.map { |a| "safe_#{a}" }.join(", ")})
+      
+      safe_result = {
+        id: result[:id],
+        #{attributes.map { |a| "#{a}: safety(result[:#{a}].to_s)," }.join("\n        ")}
+        created_at: result[:created_at],
+        updated_at: result[:updated_at]
+      }
+      
+      json_response({ 
+        data: safe_result, 
+        message: '#{resource_class} created successfully!' 
+      }, 201)
+      
+    rescue JSON::ParserError
+      json_response({ error: 'Invalid JSON' }, 400)
+    rescue StandardError => e
+      json_response({ error: safety(e.message) }, 422)
+    end
+  end
+
+  def index(env)
+    items = #{class_name}Cable.list_#{plural_name}
+    all_items = items.is_a?(Array) ? items.reverse : []
+    
+    safe_items = all_items.map do |item|
+      {
+        id: item[:id],
+        #{attributes.map { |a| "#{a}: safety(item[:#{a}].to_s)," }.join("\n        ")}
+        created_at: item[:created_at],
+        updated_at: item[:updated_at]
+      }
+    end
+    
+    json_response({ data: safe_items }, 200)
+  end
+
+  def show(env, id)
+    begin
+      result = #{class_name}Cable.get_#{singular_name}(id)
+      
+      if result
+        safe_result = {
+          id: result[:id],
+          #{attributes.map { |a| "#{a}: safety(result[:#{a}].to_s)," }.join("\n          ")}
+          created_at: result[:created_at],
+          updated_at: result[:updated_at]
+        }
+        json_response({ data: safe_result }, 200)
+      else
+        json_response({ error: '#{resource_class} not found' }, 404)
+      end
+    rescue StandardError => e
+      json_response({ error: safety(e.message) }, 404)
+    end
+  end
+
+  def update(env, id)
+    input = env['BODY']
+    
+    if input.nil? || input.empty?
+      return json_response({ error: 'Empty body' }, 400)
+    end
+
+    begin
+      data = JSON.parse(input, symbolize_names: true)
+      #{attributes.map { |a| "#{a} = data[:#{a}].to_s" }.join("\n      ")}
+      
+      if #{attributes.map { |a| "#{a}.empty?" }.join(" || ")}
+        return json_response({ error: '#{attributes.map(&:capitalize).join(' and ')} required' }, 422)
+      end
+      
+      #{attributes.map { |a| "safe_#{a} = safety(#{a})" }.join("\n      ")}
+      
+      result = #{class_name}Cable.update_#{singular_name}(id, #{attributes.map { |a| "safe_#{a}" }.join(", ")})
+      
+      safe_result = {
+        id: result[:id],
+        #{attributes.map { |a| "#{a}: safety(result[:#{a}].to_s)," }.join("\n        ")}
+        created_at: result[:created_at],
+        updated_at: result[:updated_at]
+      }
+      
+      json_response({ data: safe_result, message: '#{resource_class} updated successfully!' }, 200)
+      
+    rescue JSON::ParserError
+      json_response({ error: 'Invalid JSON' }, 400)
+    rescue StandardError => e
+      if e.message == "Not found"
+        json_response({ error: safety(e.message) }, 404)
+      else
+        json_response({ error: safety(e.message) }, 422)
+      end
+    end
+  end
+
+  def delete(env, id)
+    begin
+      #{class_name}Cable.delete_#{singular_name}(id)
+      json_response({ data: { deleted: true, id: id, message: '#{resource_class} deleted successfully!' } }, 200)
+    rescue StandardError => e
+      if e.message == "Not found"
+        json_response({ error: safety(e.message) }, 404)
+      else
+        json_response({ error: safety(e.message) }, 422)
+      end
+    end
+  end
+
+  private
+
+  def json_response(data, status)
+    body = data.to_json
+    [status, { 'Content-Type' => 'application/json' }, [body]]
+  end
+end
+}.strip
+
+          File.write(full_path, template)
+
+          puts "\e[94m✓ Created API request: #{full_path}\e[0m"
+          puts "\e[38;5;214mResource: #{plural_name}"
+          puts "Attributes: #{attributes.join(', ')}\e[0m" if attributes.any?
+        end
+
+        def self.show_usage
+          puts "Usage: hyraft-rule in-api <resource_name> [attributes...] [target_dir]"
+          puts ""
+          puts "Examples:"
+          puts "  hyraft-rule in-api articles title content"
+          puts "  hyraft-rule in-api admins username password email"
+          puts "  hyraft-rule in-api comments body author_id"
+          puts ""
+          puts "This creates: base-adapters/in-api/<resource_name>_request.rb"
+        end
+      end
+    end
+  end
+end