kwtsms 0.1.0

data/lib/kwtsms/request.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require "time"
+
+module KwtSMS
+  BASE_URL = "https://www.kwtsms.com/API/"
+
+  # kwtSMS server runs at GMT+3 (Asia/Kuwait).
+  # unix-timestamp values in API responses are server time, not UTC.
+  SERVER_TIMEZONE = "Asia/Kuwait (GMT+3)"
+
+  # POST to a kwtSMS REST/JSON API endpoint.
+  #
+  # Always sets Content-Type and Accept: application/json.
+  # Strips password from log entry.
+  # Returns parsed JSON hash.
+  # Raises RuntimeError on network / HTTP / parse failure.
+  def self.api_request(endpoint, payload, log_file = "")
+    url = URI.parse("#{BASE_URL}#{endpoint}/")
+
+    safe_payload = payload.transform_keys(&:to_s).each_with_object({}) do |(k, v), h|
+      h[k] = k == "password" ? "***" : v
+    end
+
+    log_entry = {
+      "ts" => Time.now.utc.iso8601,
+      "endpoint" => endpoint,
+      "request" => safe_payload,
+      "response" => nil,
+      "ok" => false,
+      "error" => nil
+    }
+
+    begin
+      http = Net::HTTP.new(url.host, url.port)
+      http.use_ssl = true
+      http.open_timeout = 15
+      http.read_timeout = 15
+
+      request = Net::HTTP::Post.new(url.path)
+      request["Content-Type"] = "application/json"
+      request["Accept"] = "application/json"
+      request.body = JSON.generate(payload)
+
+      response = http.request(request)
+      body = response.body.to_s
+
+      begin
+        data = JSON.parse(body)
+      rescue JSON::ParserError => e
+        log_entry["error"] = "Invalid JSON response: #{e.message}"
+        write_log(log_file, log_entry)
+        raise RuntimeError, "Invalid JSON response: #{e.message}"
+      end
+
+      log_entry["response"] = data
+      log_entry["ok"] = data["result"] == "OK"
+      write_log(log_file, log_entry)
+
+      # For HTTP errors (4xx/5xx), kwtSMS returns JSON error details in the body.
+      # If we successfully parsed the JSON, return it like a normal response.
+      return data
+
+    rescue Net::OpenTimeout, Net::ReadTimeout => e
+      err = "Network error: connection timed out"
+      log_entry["error"] = err
+      write_log(log_file, log_entry)
+      raise RuntimeError, err
+
+    rescue SocketError, Errno::ECONNREFUSED, Errno::EHOSTUNREACH, IOError => e
+      err = "Network error: #{e.message}"
+      log_entry["error"] = err
+      write_log(log_file, log_entry)
+      raise RuntimeError, err
+    end
+  end
+end

data/lib/kwtsms/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module KwtSMS
+  VERSION = "0.1.0"
+end

data/lib/kwtsms.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# kwtsms: Ruby client for the kwtSMS API (kwtsms.com)
+#
+# Quick start:
+#   require "kwtsms"
+#
+#   sms = KwtSMS::Client.from_env                          # reads .env / env vars
+#   ok, balance, err = sms.verify
+#   result = sms.send_sms("96598765432", "Your OTP is: 123456")
+#   result = sms.send_sms("96598765432", "Hello", sender: "MY-APP")
+#   report = sms.validate(["96598765432", "+96512345678"])
+#   balance = sms.balance
+#   delivery = sms.status(result["msg-id"])
+#
+# Utility functions:
+#   KwtSMS.normalize_phone("+965 9876 5432")
+#   KwtSMS.validate_phone_input("user@email.com")
+#   KwtSMS.clean_message("Hello \u{1F600} world")
+
+require "set"
+
+require_relative "kwtsms/version"
+require_relative "kwtsms/errors"
+require_relative "kwtsms/phone"
+require_relative "kwtsms/message"
+require_relative "kwtsms/env_loader"
+require_relative "kwtsms/logger"
+require_relative "kwtsms/request"
+require_relative "kwtsms/client"

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: kwtsms
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- boxlink
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-03-06 00:00:00.000000000 Z
+dependencies: []
+description: Official Ruby client library for the kwtSMS SMS gateway. Send SMS, check
+  balance, validate phone numbers, check delivery status, and manage sender IDs. Zero
+  external dependencies.
+email:
+- info@boxlink.net
+executables:
+- kwtsms
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- exe/kwtsms
+- lib/kwtsms.rb
+- lib/kwtsms/client.rb
+- lib/kwtsms/env_loader.rb
+- lib/kwtsms/errors.rb
+- lib/kwtsms/logger.rb
+- lib/kwtsms/message.rb
+- lib/kwtsms/phone.rb
+- lib/kwtsms/request.rb
+- lib/kwtsms/version.rb
+homepage: https://github.com/boxlinknet/kwtsms-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/boxlinknet/kwtsms-ruby
+  source_code_uri: https://github.com/boxlinknet/kwtsms-ruby
+  changelog_uri: https://github.com/boxlinknet/kwtsms-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/boxlinknet/kwtsms-ruby/issues
+  documentation_uri: https://github.com/boxlinknet/kwtsms-ruby#readme
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby client for the kwtSMS API (kwtsms.com)
+test_files: []