messages-tool 1.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d48c12680504abaccf7bac25df1d39eb38c4721ae9593d18e1697ffcfca1942e
+  data.tar.gz: f30c932ac4d44046e977c692829b833d1f9155f3590088713887094afc241c87
+SHA512:
+  metadata.gz: 02e0d6881de21564d013a560b570c1e1bb8a6114ded3a6b01b79fa67e0efb7ea8bdd08232ebe14a24f8ec272142d913e4e29d9648a2fe284b48c42a4ed633129
+  data.tar.gz: 737a13d80054fb914615d4c3d3f47d4263dad99abe35580751f56e57b87795eee492da30d68e7079a8777888c845eec04f5eb19305070487261295c277858efe

data/bin/messages-tool

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
+require 'messages_tool'
+
+MessagesTool.run(ARGV)

data/lib/messages_tool.rb

@@ -0,0 +1,419 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+require 'fileutils'
+require 'io/console'
+
+module MessagesTool
+  VERSION = '1.6.0'
+  ENDPOINT = 'https://special-system-987z.vercel.app/api/messages'
+  AUTH_FILE = File.expand_path('../.auth_session.json', __dir__)
+  LOCK_FILE = File.expand_path('../pin.lock', __dir__)
+
+  class << self
+    def load_auth
+      return {} unless File.exist?(AUTH_FILE)
+
+      JSON.parse(File.read(AUTH_FILE))
+    rescue StandardError
+      {}
+    end
+
+    def save_auth(data)
+      File.write(AUTH_FILE, JSON.pretty_generate(data))
+      sync_lock_file(data)
+    end
+
+    def sync_lock_file(data)
+      if data['logged_in']
+        lock_data = {
+          'status' => 'locked',
+          'registered' => data['registered'],
+          'use_application_default' => !!data['use_application_default'],
+          'timestamp' => Time.now.to_i
+        }
+        File.write(LOCK_FILE, JSON.pretty_generate(lock_data))
+      else
+        FileUtils.rm_f(LOCK_FILE)
+      end
+    end
+
+    def prompt_pin(label = 'Enter PIN: ')
+      auth = load_auth
+      if auth['use_application_default'] && auth['pin']
+        puts "#{label}[Application Default Active]"
+        return auth['pin']
+      end
+
+      print label
+      $stdin.noecho(&:gets)&.chomp.tap { puts }
+    end
+
+    def require_auth
+      auth = load_auth
+      unless auth['registered']
+        puts '[-] No PIN registered. Run `messages-tool auth register` or `account register` first.'
+        exit 1
+      end
+
+      unless auth['logged_in'] && File.exist?(LOCK_FILE)
+        puts '[-] Not logged in. Please log in first.'
+        exit 1
+      end
+
+      input_pin = prompt_pin('Enter PIN to continue: ')
+      unless input_pin == auth['pin']
+        puts '[-] Invalid PIN.'
+        exit 1
+      end
+
+      auth
+    end
+
+    def http_request(method, url_str, payload = nil)
+      uri = URI.parse(url_str)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == 'https')
+
+      request = case method
+                when :get then Net::HTTP::Get.new(uri)
+                when :post then Net::HTTP::Post.new(uri)
+                when :delete then Net::HTTP::Delete.new(uri)
+                end
+
+      request['Content-Type'] = 'application/json'
+      request.body = payload.to_json if payload
+
+      response = http.request(request)
+      JSON.parse(response.body)
+    rescue StandardError => e
+      { 'error' => e.message }
+    end
+
+    def show_auth_help
+      puts <<~HELP
+        =========================================="
+                   AUTH / ACCOUNT HELP            "
+        =========================================="
+        Commands Configuration:
+          auth / account register                     Set initial PIN (prompts: Enter new PIN, Confirm new PIN)
+          auth / account login                        Set active session & write pin.lock (prompts: Enter PIN to login)
+          auth / account logout                       End session & remove pin.lock (prompts: Enter PIN to logout)
+          auth / account status                       Display session state (prompts: Enter PIN for status)
+          auth / account reset                        Change existing PIN (prompts: Enter PIN to continue, Enter new PIN to reset, Confirm new PIN)
+          auth / account remove                       Clear authentication file & pin.lock (prompts: Enter PIN to remove)
+          auth / account list                         Display session settings JSON (prompts: Enter PIN to list auth data)
+          auth / account help                         Display this settings configuration menu
+
+        Application-Default Commands:
+          auth / account application-default help     Display application-default configuration menu
+          auth / account application-default register Register default application credentials
+          auth / account application-default login    Login using default application credentials
+          auth / account application-default logout   Logout default session
+          auth / account application-default status   Check default application status
+          auth / account application-default reset    Reset default application PIN
+          auth / account application-default remove   Remove application default configuration
+          auth / account application-default list     List default auth settings JSON
+
+        PIN & Lock Settings:
+          - Masked input enabled via console hidden input.
+          - Session state synchronized across `.auth_session.json` and `pin.lock`.
+        =========================================="
+      HELP
+    end
+
+    def show_app_default_help
+      puts <<~HELP
+        =========================================="
+           APPLICATION DEFAULT AUTHENTICATION      "
+        =========================================="
+        Commands Configuration:
+          application-default register   Register application default PIN
+          application-default login      Authenticate session using default PIN
+          application-default logout     Log out of default session
+          application-default status     Show default status & lock settings
+          application-default reset      Reset application default PIN
+          application-default remove     Remove stored default credentials
+          application-default list       Print JSON of default credentials configuration
+          application-default help       Show this application-default help menu
+        =========================================="
+      HELP
+    end
+
+    def show_main_help
+      puts <<~USAGE
+        Usage: messages-tool <category> <command> [options]
+
+        Global Options:
+          --help, -h       Show main CLI options/help
+          --version, -v    Show script version
+          --json           Output raw API results formatted as JSON
+
+        Auth / Account Commands:
+          auth / account help                            Display auth settings and manual
+          auth / account register                        Register PIN (prompts: Enter new PIN, Confirm new PIN)
+          auth / account login                           Login (prompts: Enter PIN to login)
+          auth / account logout                          Logout (prompts: Enter PIN to logout)
+          auth / account status                          Check status (prompts: Enter PIN for status)
+          auth / account reset                           Reset PIN (prompts: Enter PIN to continue, Enter new PIN to reset, Confirm new PIN)
+          auth / account remove                          Remove auth data and lock file (prompts: Enter PIN to remove)
+          auth / account list                            List auth session JSON (prompts: Enter PIN to list auth data)
+          auth / account application-default <cmd>       Manage application-default credentials
+
+        Messages Commands:
+          messages send --number <phone> --text <text>
+          message send --number <phone> --text <text>
+          send --number <phone> --text <text>
+
+          messages list / message list / list
+          messages delete [--id <id>] / message delete [--id <id>] / delete [--id <id>]
+      USAGE
+    end
+
+    def handle_auth(subcommand, args)
+      auth = load_auth
+
+      if subcommand == 'application-default'
+        app_sub = args.shift || 'help'
+        handle_app_default(app_sub, args)
+        return
+      end
+
+      case subcommand
+      when 'help'
+        show_auth_help
+      when 'register'
+        if auth['registered']
+          puts '[-] Account already registered. Use `auth reset` or `account reset` to change PIN.'
+          return
+        end
+
+        pin = prompt_pin('Enter new PIN: ')
+        confirm = prompt_pin('Confirm new PIN: ')
+
+        if pin.empty? || pin != confirm
+          puts '[-] PINs do not match or cannot be empty.'
+          return
+        end
+
+        save_auth({ 'registered' => true, 'logged_in' => true, 'pin' => pin, 'use_application_default' => false })
+        puts '[+] Registered, logged in, and updated pin.lock successfully.'
+      when 'login'
+        unless auth['registered']
+          puts '[-] No account registered.'
+          return
+        end
+
+        pin = prompt_pin('Enter PIN to login: ')
+        if pin == auth['pin']
+          auth['logged_in'] = true
+          save_auth(auth)
+          puts '[+] Logged in and pin.lock acquired successfully.'
+        else
+          puts '[-] Invalid PIN.'
+        end
+      when 'logout'
+        prompt_pin('Enter PIN to logout: ')
+        auth['logged_in'] = false
+        save_auth(auth)
+        puts '[+] Logged out and released pin.lock successfully.'
+      when 'status'
+        prompt_pin('Enter PIN for status: ')
+        status = auth['logged_in'] && File.exist?(LOCK_FILE) ? 'Logged In (Active Lock)' : 'Logged Out'
+        app_def = auth['use_application_default'] ? 'Enabled' : 'Disabled'
+        puts '=========================================='
+        puts '           AUTH STATUS                    '
+        puts '=========================================='
+        puts " Registered          : #{auth['registered'] ? 'Yes' : 'No'}"
+        puts " Session             : #{status}"
+        puts " Lock File (pin.lock): #{File.exist?(LOCK_FILE) ? 'Present' : 'Absent'}"
+        puts " Application Default : #{app_def}"
+        puts '=========================================='
+      when 'reset'
+        require_auth
+        pin = prompt_pin('Enter new PIN to reset: ')
+        confirm = prompt_pin('Confirm new PIN: ')
+
+        if pin.empty? || pin != confirm
+          puts '[-] PINs do not match or cannot be empty.'
+          return
+        end
+
+        auth['pin'] = pin
+        save_auth(auth)
+        puts '[+] PIN reset and session state updated.'
+      when 'remove'
+        prompt_pin('Enter PIN to remove: ')
+        FileUtils.rm_f(AUTH_FILE)
+        FileUtils.rm_f(LOCK_FILE)
+        puts '[+] Auth session, PIN, and pin.lock removed successfully.'
+      when 'list'
+        prompt_pin('Enter PIN to list auth data: ')
+        puts JSON.pretty_generate(auth)
+      end
+    end
+
+    def handle_app_default(subcommand, _args)
+      auth = load_auth
+
+      case subcommand
+      when 'help'
+        show_app_default_help
+      when 'register'
+        pin = prompt_pin('Enter new PIN: ')
+        confirm = prompt_pin('Confirm new PIN: ')
+
+        if pin.empty? || pin != confirm
+          puts '[-] PINs do not match or cannot be empty.'
+          return
+        end
+
+        save_auth({ 'registered' => true, 'logged_in' => true, 'pin' => pin, 'use_application_default' => true })
+        puts '[+] Application-default credentials registered, logged in, and pin.lock written.'
+      when 'login'
+        unless auth['registered']
+          puts '[-] No account registered.'
+          return
+        end
+
+        auth['use_application_default'] = true
+        auth['logged_in'] = true
+        save_auth(auth)
+        puts '[+] Application-default session logged in (pin.lock updated).'
+      when 'logout'
+        auth['logged_in'] = false
+        save_auth(auth)
+        puts '[+] Application-default session logged out (pin.lock removed).'
+      when 'status'
+        status = auth['logged_in'] && File.exist?(LOCK_FILE) ? 'Logged In (Active Lock)' : 'Logged Out'
+        app_def = auth['use_application_default'] ? 'Enabled' : 'Disabled'
+        puts '=========================================='
+        puts '   APPLICATION DEFAULT AUTH STATUS        '
+        puts '=========================================='
+        puts " Registered          : #{auth['registered'] ? 'Yes' : 'No'}"
+        puts " Session             : #{status}"
+        puts " Lock File (pin.lock): #{File.exist?(LOCK_FILE) ? 'Present' : 'Absent'}"
+        puts " Application Default : #{app_def}"
+        puts '=========================================='
+      when 'reset'
+        require_auth
+        pin = prompt_pin('Enter new PIN to reset: ')
+        confirm = prompt_pin('Confirm new PIN: ')
+
+        if pin.empty? || pin != confirm
+          puts '[-] PINs do not match or cannot be empty.'
+          return
+        end
+
+        auth['pin'] = pin
+        auth['use_application_default'] = true
+        save_auth(auth)
+        puts '[+] Application-default PIN reset successfully.'
+      when 'remove'
+        auth['use_application_default'] = false
+        save_auth(auth)
+        puts '[+] Application-default credentials mode disabled.'
+      when 'list'
+        puts JSON.pretty_generate(auth)
+      end
+    end
+
+    def handle_messages(subcommand, args, raw_json: false)
+      require_auth
+
+      case subcommand
+      when 'send'
+        number_idx = args.index('--number')
+        text_idx = args.index('--text')
+
+        number = number_idx ? args[number_idx + 1] : nil
+        text = text_idx ? args[text_idx + 1] : nil
+
+        if number.nil? || text.nil?
+          puts '[-] Usage: messages send --number <PHONE> --text <MESSAGE>'
+          return
+        end
+
+        res = http_request(:post, ENDPOINT, { phone: number, text: text })
+
+        if raw_json
+          puts JSON.pretty_generate(res)
+        elsif res['success']
+          msg = res['message']
+          puts '=========================================='
+          puts '           MESSAGE SENT                   '
+          puts '=========================================='
+          puts ' Status  : Success (201)'
+          puts " ID      : #{msg['id']}"
+          puts " Phone   : #{msg['phone']}"
+          puts " Text    : #{msg['text']}"
+          puts '=========================================='
+        else
+          puts '=========================================='
+          puts '       FAILED TO SEND MESSAGE             '
+          puts '=========================================='
+          puts " Error   : #{res['error'] || 'Failed to send'}"
+          puts '=========================================='
+        end
+      when 'list'
+        res = http_request(:get, ENDPOINT)
+        if raw_json
+          puts JSON.pretty_generate(res)
+        else
+          puts '=========================================='
+          puts '           MESSAGE LIST                   '
+          puts '=========================================='
+          puts " Total Count : #{res['totalMessages'] || 0}"
+          puts " Data        : #{res.to_json}"
+          puts '=========================================='
+        end
+      when 'delete'
+        id_idx = args.index('--id')
+        id = id_idx ? args[id_idx + 1] : nil
+
+        url = id ? "#{ENDPOINT}?id=#{id}" : ENDPOINT
+        res = http_request(:delete, url)
+
+        if raw_json
+          puts JSON.pretty_generate(res)
+        else
+          puts '=========================================='
+          puts '           DELETE MESSAGES                '
+          puts '=========================================='
+          puts " Response : #{res.to_json}"
+          puts '=========================================='
+        end
+      end
+    end
+
+    def run(argv)
+      raw_json_flag = argv.delete('--json') != nil
+
+      if argv.empty? || argv.include?('--help') || argv.include?('-h')
+        show_main_help
+        exit 0
+      end
+
+      if argv.include?('--version') || argv.include?('-v')
+        puts "messages-tool v#{VERSION}"
+        exit 0
+      end
+
+      group = argv.shift
+      subcmd = argv.shift
+
+      case group
+      when 'auth', 'account'
+        handle_auth(subcmd, argv)
+      when 'messages', 'message'
+        handle_messages(subcmd, argv, raw_json: raw_json_flag)
+      when 'send', 'list', 'delete'
+        handle_messages(group, [subcmd] + argv, raw_json: raw_json_flag)
+      else
+        show_main_help
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: messages-tool
+version: !ruby/object:Gem::Version
+  version: 1.6.0
+platform: ruby
+authors:
+- hb044082-alt
+bindir: bin
+cert_chain: []
+date: 2026-08-31 00:00:00.000000000 Z
+dependencies: []
+description: A CLI utility providing authentication, session lock management, and
+  REST endpoint messaging commands.
+email:
+- dodi66412@gmail.com
+executables:
+- messages-tool
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/messages-tool
+- lib/messages_tool.rb
+homepage: https://github.com/hb044082-alt/messages-tool
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/hb044082-alt/messages-tool
+  source_code_uri: https://github.com/hb044082-alt/messages-tool.git
+  bug_tracker_uri: https://github.com/hb044082-alt/messages-tool/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: CLI tool for authentication and message sending operations.
+test_files: []