notilify 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40b885f623c42c3883eaa84f8123fb924238d92de662d9527b9fe2f4e6acd02c
-  data.tar.gz: 661e52e86911ce7719f64b4e79c77297c90313cdcb2e023c795a25bd70ac3fd6
+  metadata.gz: 98be21736192ebc4eb8d02962290056b07cf25e4553d50fa16f321175de201b2
+  data.tar.gz: 8092aebb56fdeeb6102664aea13c7300b3b80c4756cca3ae795ca7f3d3b804b9
 SHA512:
-  metadata.gz: 8b8ff7dc6b09f668f9ce4c623b35e1cb7852bd2b6f8395d4588c52b2ed00c4cfa20a0c670e7d4d892dff4ba5ffa50ef4e18572fda82504452cc7d1afaa9922aa
-  data.tar.gz: e383a5e50f1d31d422e577ba087af0eaf78e1d8dc625ead6ebe5f83d1bd25ffa348b02db1c771da023a9c20cc8ee691e97083bd33ae225953d9ea667f3bf4fbd
+  metadata.gz: 2e740930e4192c6d02ba70944bb756a7ff793f0e4a8dbee83f0ef2244d9459d1d1ba1ca9688081d6634382bbe20b5df6996384bd81562969892669e5a1228f08
+  data.tar.gz: db78b64c54fbc1e76b707912493f13f0e30ef2b499c26dc659959e5dc0ef6c4d42b65513daa00e78e183e62693f5f3c1df019e5380e32bc6dec742bf035607dd

data/README.md

@@ -1,43 +1,18 @@
-# Notilify SDKs
+# notilify for Ruby
 
-Official, dependency-light clients for the [Notilify API](https://docs.notilify.com). Every package is named `notilify` in its language ecosystem and shares the same first-release contract.
-
-This repository is open source under the [MIT License](LICENSE). Contributions and security reports are welcome; review [CONTRIBUTING.md](CONTRIBUTING.md), [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md), and [SECURITY.md](SECURITY.md) before participating.
-
-## SDKs
-
-| Language | Package | Status | Directory |
-| --- | --- | --- | --- |
-| Node.js | [`notilify`](https://www.npmjs.com/package/notilify) | Published | [`sdks/node`](sdks/node) |
-| Python | `notilify` | Registry release pending | [`sdks/python`](sdks/python) |
-| PHP | `notilify/notilify` | Registry release pending | [`sdks/php`](sdks/php) |
-| Go | `github.com/codelinglabs/notilify-sdks/sdks/go` | Module tag pending | [`sdks/go`](sdks/go) |
-| Ruby | `notilify` | Registry release pending | [`sdks/ruby`](sdks/ruby) |
-| Java | `com.notilify:notilify` | Registry release pending | [`sdks/java`](sdks/java) |
-| .NET | `Notilify` | Registry release pending | [`sdks/dotnet`](sdks/dotnet) |
-
-## Shared contract
-
-Each client:
-
-- authenticates with `Authorization: Bearer <api-key>`
-- sends one SMS through `POST /v1/message`
-- accepts `from`, `to`, `message`, and an optional idempotency key
-- defaults to `https://api.notilify.com`
-- supports a custom base URL and timeout for testing and controlled environments
-- throws a structured Notilify error for non-2xx responses
-
-```text
-Client(apiKey, options)
-  .sendMessage({ from, to, message, idempotencyKey })
+```bash
+gem install notilify
 ```
 
-API keys must remain on a trusted server. Do not embed them in browser or mobile application bundles.
-
-## Versioning
+```ruby
+require "notilify"
 
-SDKs begin at `0.1.0` while the common API and packaging are validated. Language packages can be released independently, but behavior changes should remain aligned across every implementation.
-
-## Validation
+client = Notilify::Client.new(ENV.fetch("NOTILIFY_API_KEY"))
+response = client.send_message(
+  from: "NOTILIFY", to: "+14155552671",
+  message: "Your verification code is 482913",
+  idempotency_key: "verification-482913"
+)
+```
 
-Run `./scripts/check-sdks.sh` locally. It exercises each language's request, authentication, idempotency, response, and error checks, then validates or builds the npm, Python, Composer, RubyGems, Maven, and NuGet packages using free local toolchains. It does not require hosted CI or an organization billing plan.
+Requires Ruby 3.0 or newer.

data/lib/notilify.rb

@@ -0,0 +1,67 @@
+require "json"
+require "net/http"
+require "uri"
+
+module Notilify
+  class Error < StandardError
+    attr_reader :status_code, :data
+
+    def initialize(message, status_code: nil, data: nil)
+      super(message)
+      @status_code = status_code
+      @data = data
+    end
+  end
+
+  class Client
+    def initialize(api_key, base_url: "https://api.notilify.com", timeout: 10, transport: nil)
+      raise ArgumentError, "A Notilify API key is required" if api_key.to_s.strip.empty?
+      @api_key = api_key
+      @base_url = base_url.sub(%r{/$}, "")
+      @timeout = timeout
+      @transport = transport
+    end
+
+    def send_message(from:, to:, message:, idempotency_key: nil)
+      validate_message(from, to, message)
+      uri = URI("#{@base_url}/v1/message")
+      request = Net::HTTP::Post.new(uri)
+      request["Authorization"] = "Bearer #{@api_key}"
+      request["Content-Type"] = "application/json"
+      request["Idempotency-Key"] = idempotency_key if idempotency_key && !idempotency_key.empty?
+      request.body = { from: from, to: to, message: message }.to_json
+      response = @transport ? @transport.call(uri, request) : perform(uri, request)
+      body = parse_body(response.body)
+      unless response.code.to_i.between?(200, 299)
+        api_message = body.is_a?(Hash) ? body["message"] : nil
+        data = body.is_a?(Hash) ? body["data"] : body
+        raise Error.new(api_message || "Notilify request failed with HTTP #{response.code}", status_code: response.code.to_i, data: data)
+      end
+      body
+    rescue ArgumentError, Error
+      raise
+    rescue StandardError => error
+      raise Error, "Notilify request failed: #{error.message}"
+    end
+
+    private
+
+    def perform(uri, request)
+      Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https", open_timeout: @timeout, read_timeout: @timeout) { |http| http.request(request) }
+    end
+
+    def validate_message(from, to, message)
+      { "from" => from, "to" => to, "message" => message }.each do |name, value|
+        raise ArgumentError, "#{name} is required" unless value.is_a?(String) && !value.strip.empty?
+      end
+      raise ArgumentError, "message must be 160 characters or fewer" if message.length > 160
+    end
+
+    def parse_body(raw)
+      return nil if raw.nil? || raw.empty?
+      JSON.parse(raw)
+    rescue JSON::ParserError
+      raw
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: notilify
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Notilify
@@ -17,12 +17,13 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- lib/notilify.rb
 homepage: https://notilify.com
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/codelinglabs/notilify-sdks/tree/main/sdks/ruby
-  bug_tracker_uri: https://github.com/codelinglabs/notilify-sdks/issues
+  source_code_uri: https://github.com/notilify/notilify-sdks/tree/main/sdks/ruby
+  bug_tracker_uri: https://github.com/notilify/notilify-sdks/issues
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: