nostr 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcfeb88b78cad383e565b6e908be58f58e6f1002083044957ee0f09cf63228f4
-  data.tar.gz: ca2229181586e8bf5f329e4d5ac60ad346076fc8e39281dd43690d57ac98fcb7
+  metadata.gz: 707a302ca79f44bd669a84dc9086c5934bc6f753a78d90989f4d3619db5ed997
+  data.tar.gz: 81a83ff089c864ac5c77bc7d4b26a23755ff2573ee013f68137a79ed9351f140
 SHA512:
-  metadata.gz: 4511decc634548b75429db9166433060795295aea61cda64cd7b2b2647415db3808f4def27f8a4806d77b6fbaef88b11d08788254febd66bcfb7be318059cced
-  data.tar.gz: aef568e9fad07e0b387e3ae1437a50d08c81b59485c8aadd42cd9d7a035319b3da2bd5247e7d58fc890961eec5e0284d9299e6631c674cce3df3a5c210202bf2
+  metadata.gz: 69bf9a378add76760a6955967787602e1bf6e913f22c1194fa9b8d3dc661270b038f26010bb8181378b7d21586b6d5195fe12754007551baa78531b3e4663e16
+  data.tar.gz: a49b8eb1acc9978a1f95be74783253d44807078fc97af2255239067c77125a7a31661514e7196f27d18c76d57805c293c54d5cc0c9427cd792c1f0e65349a796

data/.rubocop.yml

@@ -8,6 +8,8 @@ AllCops:
   TargetRubyVersion: 3.3
   DisplayCopNames: true
   NewCops: enable
+  Exclude:
+    - docs/**/*
 
 # ----------------------- Gemspec -----------------------
 

data/.rubocop_todo.yml

@@ -9,7 +9,7 @@
 # Offense count: 2
 # Configuration parameters: AllowedMethods, AllowedPatterns, IgnoredMethods, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 23
+  Max: 24
 
 # Offense count: 2
 # Configuration parameters: CountComments, CountAsOne, ExcludedMethods, AllowedMethods, AllowedPatterns, IgnoredMethods.

data/.tool-versions

@@ -1,2 +1,2 @@
 ruby 3.3.0
-bun 1.0.30
+bun 1.1.3

data/CHANGELOG.md

@@ -4,6 +4,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.1.1/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [0.7.0] 2024-04-13
+
+### Added
+
+- Added the `Nostr::Client::Logger` class to log connection events, messages sent and received, errors, and connection
+closures.
+- Added the `Nostr::Client::ColorLogger` class to log events in color using ANSI escape codes.
+- Added the `Nostr::Client::PlainLogger` class to log events without color coding.
+- Added Architecture Decision Records (ADRs) to document the decision process for logging functionality.
+- Added a new common use case document for logging and debugging.
+
+### Changed
+
+- Updated the `Nostr::Client` class to use the `ColorLogger` by default for logging client interactions with relays.
+- Updated the `Nostr::Client#connect` method to emit a `:send` event when sending a message.
+- Updated the `Nostr::Client#on` method to pass the `relay` parameter to the `:connect` event handler.
+- Updated bun to version `1.1.3` (was `1.0.30`).
+- Updated the gem `json` to version `2.7` (was `2.6`).
+- Updated the gem `mermaid` to version `10.9` (was `10.6`).
+- Updated the gem `rubocop-rspec` to version `2.29` (was `2.27`).
+- Updated the gem `steep` to version `1.7.dev3` (was `1.6`).
+- Updated the gem `vitepress` to version `1.1` (was `1.0.0-rc.25`).
+- Updated the gem `vitepress-plugin-mermaid` to version `2.0.16` (was `2.0.15`).
+- Updated the error message in `Nostr::InvalidSignatureTypeError` to provide more detail.
+
+### Fixed
+
+Fixed a type-checking issue in `Nostr::Event#verify_signature` by removing a workaround after the steep gem author,
+[@soutaro](https://github.com/soutaro) resolved [the problem I reported](https://github.com/soutaro/steep/issues/1079).
+
 ## [0.6.0] 2024-03-15
 
 ### Added
@@ -27,13 +57,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Updated the gem `rspec-rubocop` to version `2.27` (was `2.25`)
 - Updated the gem `rubocop` to version `1.62` (was `1.57`)
 
-## Fixed
+### Fixed
 
 - Fixed a typo in the README (`generate_keypair` -> `generate_key_pair`)
 - Fixed a typo in the YARD documentation of `Nostr::Key#initialize` (`ValidationError` -> `KeyValidationError`)
-
-### Fixed
-
 - Fixed YARD example rendering issues in `InvalidKeyFormatError#initialize`, `InvalidKeyLengthError#initialize`,
 `InvalidKeyTypeError#initialize`, `Event#initialize`, `EncryptedDirectMessage#initialize` and `Filter#to_h`
 
@@ -115,6 +142,7 @@ principles of immutability and was a major source of internal complexity as I ne
 
 - Initial release
 
+[0.7.0]: https://github.com/wilsonsilva/nostr/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/wilsonsilva/nostr/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/wilsonsilva/nostr/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/wilsonsilva/nostr/compare/v0.3.0...v0.4.0

data/README.md

@@ -80,7 +80,7 @@ relay = Nostr::Relay.new(url: 'wss://nostr.wine', name: 'Wine')
 client.connect(relay)
 
 # Listen asynchronously for the connect event
-client.on :connect do
+client.on :connect do |relay|
   # Send the event to the Relay
   client.publish(text_note_event)
 
@@ -118,6 +118,9 @@ end
 client.on :close do |code, reason|
   # You may attempt to reconnect to the relay here
 end
+
+# This line keeps the background client from exiting immediately.
+gets
 ```
 
 ## 📚 Documentation

data/adr/0003-logging-methods-vs-logger-class.md

@@ -0,0 +1,122 @@
+# 3. Logging methods vs logger class
+
+Date: 2024-03-19
+
+## Status
+
+Accepted
+
+## Context
+
+I'm deciding between integrating logging directly into the main class or creating a dedicated logger class.
+
+### Option 1: Logging methods
+
+The first approach weaves logging actions into the operational code, resulting in a tight coupling of functionality and
+logging. Classes should be open for extension but closed for modification, and this strategy violates that principle.
+
+```ruby
+class Client
+  def connect(relay)
+    execute_within_an_em_thread do
+      client = build_websocket_client(relay.url)
+      parent_to_child_channel.subscribe do |msg|
+        client.send(msg)
+        emit(:send, msg)
+        log_send(msg) # <------ new code
+      end
+
+      client.on :open do
+        child_to_parent_channel.push(type: :open, relay:)
+        log_connection_opened(relay) # <------ new code
+      end
+
+      client.on :message do |event|
+        child_to_parent_channel.push(type: :message, data: event.data)
+        log_message_received(event.data) # <------ new code
+      end
+
+      client.on :error do |event|
+        child_to_parent_channel.push(type: :error, message: event.message)
+        log_error(event.message) # <------ new code
+      end
+
+      client.on :close do |event|
+        child_to_parent_channel.push(type: :close, code: event.code, reason: event.reason)
+        log_connection_closed(event.code, event.reason) # <------ new code
+      end
+    end
+
+    # ------ new code below ------
+
+    def log_send(msg)
+      logger.info("Message sent: #{msg}")
+    end
+
+    def log_connection_opened(relay)
+      logger.info("Connection opened to #{relay.url}")
+    end
+
+    def log_message_received(data)
+      logger.info("Message received: #{data}")
+    end
+
+    def log_error(message)
+      logger.error("Error: #{message}")
+    end
+
+    def log_connection_closed(code, reason)
+      logger.info("Connection closed with code: #{code}, reason: #{reason}")
+    end
+  end
+end
+```
+
+### Option 2: Logger class
+
+The second strategy separates logging into its own class, promoting cleaner code and adherence to the Single
+Responsibility Principle. Client already exposes events that can be tapped into, so the logger class can listen to these
+events and log accordingly.
+
+```ruby
+class ClientLogger
+  def attach_to(client)
+    logger_instance = self
+
+    client.on(:connect) { |relay| logger_instance.on_connect(relay) }
+    client.on(:message) { |message| logger_instance.on_message(message) }
+    client.on(:send) { |message| logger_instance.on_send(message) }
+    client.on(:error) { |message| logger_instance.on_error(message) }
+    client.on(:close) { |code, reason| logger_instance.on_close(code, reason) }
+  end
+
+  def on_connect(relay); end
+  def on_message(message); end
+  def on_send(message); end
+  def on_error(message); end
+  def on_close(code, reason); end
+end
+
+client = Nostr::Client.new
+logger = Nostr::ClientLogger.new
+logger.attach_to(client)
+```
+
+This approach decouples logging from the main class, making it easier to maintain and extend the logging system without
+affecting the core logic.
+
+## Decision
+
+I've chosen the dedicated logger class route. This choice is driven by a desire for extensibility in the logging system.
+With a separate logger, I can easily modify logging behavior—like changing formats, adjusting verbosity levels,
+switching colors, or altering output destinations (files, networks, etc.) — without needing to rewrite any of the main
+operational code.
+
+## Consequences
+
+Adopting a dedicated logger class offers greater flexibility and simplifies maintenance, making it straightforward to
+adjust how and what I log independently of the core logic. This separation of concerns means that any future changes
+to logging preferences or requirements can be implemented quickly and without risk to the main class's functionality.
+However, it's important to manage the integration carefully to avoid introducing complexity, such as handling
+dependencies and ensuring seamless communication between the main operations and the logging system.
+

data/adr/0004-default-logging-activation.md

@@ -0,0 +1,66 @@
+# 3. Default Logging Activation
+
+Date: 2024-03-19
+
+## Status
+
+Accepted
+
+## Context
+
+Logging provides visibility into the gem's behavior and helps to diagnose issues. The decision centered on whether
+to enable logging by default or require manual activation.
+
+### Option 1: On-demand Logging
+
+```ruby
+client = Nostr::Client.new
+logger = Nostr::ClientLogger.new
+logger.attach_to(client)
+```
+
+#### Advantages:
+
+- Offers users flexibility and control over logging.
+- Conserves resources by logging only when needed.
+
+#### Disadvantages:
+
+- Potential to miss critical logs if not enabled.
+- Requires users to read and understand documentation to enable logging.
+- Requires users to manually activate and configure logging.
+
+### Option 2: Automatic Logging
+
+```ruby
+class Client
+  def initialize(logger: ClientLogger.new)
+    @logger = logger
+    logger&.attach_to(self)
+  end
+end
+
+client = Nostr::Client.new
+```
+
+#### Advantages:
+
+- Ensures comprehensive logging without user intervention.
+- Simplifies debugging and monitoring.
+- Balances logging detail with performance impact.
+
+#### Disadvantages:
+
+- Needs additional steps to disable logging.
+
+## Decision
+
+Logging will be enabled by default. Users can disable logging by passing a `nil` logger to the client:
+
+```ruby
+client = Nostr::Client.new(logger: nil)
+```
+
+## Consequences
+
+Enabling logging by default favors ease of use and simplifies the developer's experience.

data/adr/0005-logger-types.md

@@ -0,0 +1,32 @@
+# 3. Logger Types
+
+Date: 2024-04-01
+
+## Status
+
+Accepted
+
+## Context
+
+In developing the `Nostr::Client` logging mechanism, I identified a need to cater to multiple development environments
+and developer preferences. The consideration was whether to implement a singular logger type or to introduce
+multiple, specialized loggers. The alternatives were:
+
+- A single `ClientLogger` providing a one-size-fits-all solution.
+- Multiple logger types:
+  - `Nostr::Client::Logger`: The base class for logging, providing core functionalities.
+  - `Nostr::Client::ColorLogger`: An extension of the base logger, introducing color-coded outputs for enhanced readability in environments that support ANSI colors.
+  - `Nostr::Client::PlainLogger`: A variation that produces logs without color coding, suitable for environments lacking color support or for users preferring plain text.
+
+## Decision
+
+I decided to implement the latter option: three specific kinds of loggers (`Nostr::Client::Logger`,
+`Nostr::Client::ColorLogger`, and `Nostr::Client::PlainLogger`). This approach is intended to offer flexibility and
+cater to the varied preferences and requirements of our users, recognizing the diverse environments in which our
+library might be used.
+
+## Consequences
+
+- `Developer Choice`: Developers gain the ability to select the one that best matches their needs and environmental constraints, thereby enhancing the library's usability.
+- `Code Complexity`: While introducing multiple logger types increases the library's code complexity, this is offset by the significant gain in flexibility and user satisfaction.
+- `Broad Compatibility`: This decision ensures that the logging mechanism is adaptable to a wide range of operational environments, enhancing the library's overall robustness and accessibility.

data/docs/.vitepress/config.mjs

@@ -78,6 +78,7 @@ export default defineConfig(withMermaid({
         text: 'Common use cases',
         collapsed: false,
         items: [
+          { text: 'Logging and debugging', link: '/common-use-cases/logging-and-debugging' },
           { text: 'Bech32 enc/decoding (NIP-19)', link: '/common-use-cases/bech32-encoding-and-decoding-(NIP-19)' },
           { text: 'Signing/verifying messages', link: '/common-use-cases/signing-and-verifying-messages' },
           { text: 'Signing/verifying events', link: '/common-use-cases/signing-and-verifying-events' },

data/docs/common-use-cases/logging-and-debugging.md

@@ -0,0 +1,60 @@
+# Logging and debugging
+
+The `Nostr::Client` class provides built-in logging functionality to help you debug and monitor client interactions with
+relays. By default, the client uses the `ColorLogger`, which logs events in color. However, you can customize the
+logging behavior or disable it entirely.
+
+## Disabling logging
+
+To instantiate a client without any logging, simply pass `logger: nil` when creating the client instance:
+
+```ruby
+client = Nostr::Client.new(logger: nil)
+```
+
+This will disable all logging for the client.
+
+## Formatting the logging
+
+The `Nostr::Client::Logger` class is the base class for logging functionality. It defines the following methods for
+logging different events:
+
+- `on_connect(relay)`: Logs when the client connects to a relay.
+- `on_message(message)`: Logs a message received from the relay.
+- `on_send(message)`: Logs a message sent to the relay.
+- `on_error(message)`: Logs an error message.
+- `on_close(code, reason)`: Logs when the connection with a relay is closed.
+
+You can create your own logger by subclassing `Nostr::Client::Logger` and overriding these methods to customize the
+logging format.
+
+The `Nostr::Client::ColorLogger` is a built-in logger that logs events in color. It uses ANSI escape codes to add color
+to the log output. Here's an example of how the ColorLogger formats the log messages:
+
+- Connection: `"\u001b[32m\u001b[1mConnected to the relay\u001b[22m #{relay.name} (#{relay.url})\u001b[0m"`
+- Message received: `"\u001b[32m\u001b[1m◄-\u001b[0m #{message}"`
+- Message sent: `"\u001b[32m\u001b[1m-►\u001b[0m #{message}"`
+- Error: `"\u001b[31m\u001b[1mError: \u001b[22m#{message}\u001b[0m"`
+- Connection closed: `"\u001b[31m\u001b[1mConnection closed: \u001b[22m#{reason} (##{code})\u001b[0m"`
+
+## Plain text logging
+
+If you prefer plain text logging without colors, you can use the `Nostr::Client::PlainLogger`. This logger formats the
+log messages in a simple, readable format without any ANSI escape codes.
+
+To use the `PlainLogger`, pass it as the `logger` option when creating the client instance:
+
+```ruby
+client = Nostr::Client.new(logger: Nostr::Client::PlainLogger.new)
+```
+
+The `PlainLogger` formats the log messages as follows:
+
+- Connection: `"Connected to the relay #{relay.name} (#{relay.url})"`
+- Message received: `"◄- #{message}"`
+- Message sent: `"-► #{message}"`
+- Error: `"Error: #{message}"`
+- Connection closed: `"Connection closed: #{reason} (##{code})"`
+
+By using the appropriate logger or creating your own custom logger, you can effectively debug and monitor your Nostr
+client's interactions with relays.

data/docs/core/client.md

@@ -28,7 +28,7 @@ The `:connect` event is fired when a connection with a WebSocket is opened. You
 client = Nostr::Client.new
 relay = Nostr::Relay.new(url: 'wss://relay.damus.io', name: 'Damus')
 
-client.on :connect do
+client.on :connect do |relay|
   # When this block executes, you're connected to the relay
 end
 

data/docs/getting-started/overview.md

@@ -165,6 +165,9 @@ end
 client.on :close do |code, reason|
   # You may attempt to reconnect to the relay here
 end
+
+# This line keeps the background client from exiting immediately.
+gets
 ```
 
 Beyond what's covered here, the Nostr protocol and this gem boast a wealth of additional functionalities. For an

data/docs/package.json

@@ -5,8 +5,8 @@
     "docs:preview": "vitepress preview"
   },
   "devDependencies": {
-    "mermaid": "^10.6.1",
-    "vitepress": "^1.0.0-rc.25",
-    "vitepress-plugin-mermaid": "^2.0.15"
+    "mermaid": "^10.9.0",
+    "vitepress": "^1.1.0",
+    "vitepress-plugin-mermaid": "^2.0.16"
   }
 }

data/lib/nostr/client/color_logger.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Nostr
+  class Client
+    # Logs connection events, messages sent and received, errors, and connection closures in color.
+    class ColorLogger < Logger
+      # Logs connection to a relay
+      #
+      # @api private
+      #
+      # @param [Nostr::Relay] relay The relay the client connected to.
+      #
+      # @return [void]
+      #
+      def on_connect(relay)
+        puts "\u001b[32m\u001b[1mConnected to the relay\u001b[22m #{relay.name} (#{relay.url})\u001b[0m"
+      end
+
+      # Logs a message received from the relay
+      #
+      # @api private
+      #
+      # @param [String] message The message received.
+      #
+      # @return [void]
+      #
+      def on_message(message)
+        puts "\u001b[32m\u001b[1m◄-\u001b[0m #{message}"
+      end
+
+      # Logs a message sent to the relay
+      #
+      # @api private
+      #
+      # @param [String] message The message sent.
+      #
+      # @return [void]
+      #
+      def on_send(message)
+        puts "\u001b[32m\u001b[1m-►\u001b[0m #{message}"
+      end
+
+      # Logs an error message
+      #
+      # @api private
+      #
+      # @param [String] message The error message.
+      #
+      # @return [void]
+      #
+      def on_error(message)
+        puts "\u001b[31m\u001b[1mError: \u001b[22m#{message}\u001b[0m"
+      end
+
+      # Logs a closure of connection with a relay
+      #
+      # @api private
+      #
+      # @param [String] code The closure code.
+      # @param [String] reason The reason for the closure.
+      #
+      # @return [void]
+      #
+      def on_close(code, reason)
+        puts "\u001b[31m\u001b[1mConnection closed: \u001b[22m#{reason} (##{code})\u001b[0m"
+      end
+    end
+  end
+end

data/lib/nostr/client/logger.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Nostr
+  class Client
+    # Logs connection events, messages sent and received, errors, and connection closures.
+    class Logger
+      # Attaches event handlers to the specified Nostr client for logging purposes
+      #
+      # @api public
+      #
+      # @example Attaching the logger to a client
+      #   client = Nostr::Client.new
+      #   logger = Nostr::Client::Logger.new
+      #   logger.attach_to(client)
+      #
+      #   # Now, actions like connecting, sending messages, receiving messages,
+      #   # errors, and closing the connection will be logged to the console.
+      #
+      # @param [Nostr::Client] client The client to attach logging functionality to.
+      #
+      # @return [void]
+      #
+      def attach_to(client)
+        logger_instance = self
+
+        client.on(:connect) { |relay| logger_instance.on_connect(relay) }
+        client.on(:message) { |message| logger_instance.on_message(message) }
+        client.on(:send) { |message| logger_instance.on_send(message) }
+        client.on(:error) { |message| logger_instance.on_error(message) }
+        client.on(:close) { |code, reason| logger_instance.on_close(code, reason) }
+      end
+
+      # Logs connection to a relay
+      #
+      # @api private
+      #
+      # @param [Nostr::Relay] relay The relay the client connected to.
+      #
+      # @return [void]
+      #
+      def on_connect(relay); end
+
+      # Logs a message received from the relay
+      #
+      # @api private
+      #
+      # @param [String] message The message received.
+      #
+      # @return [void]
+      #
+      def on_message(message); end
+
+      # Logs a message sent to the relay
+      #
+      # @api private
+      #
+      # @param [String] message The message sent.
+      #
+      # @return [void]
+      #
+      def on_send(message); end
+
+      # Logs an error message
+      #
+      # @api private
+      #
+      # @param [String] message The error message.
+      #
+      # @return [void]
+      #
+      def on_error(message); end
+
+      # Logs a closure of connection with a relay
+      #
+      # @api private
+      #
+      # @param [String] code The closure code.
+      # @param [String] reason The reason for the closure.
+      #
+      # @return [void]
+      #
+      def on_close(code, reason); end
+    end
+  end
+end

data/lib/nostr/client/plain_logger.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Nostr
+  class Client
+    # Logs connection events, messages sent and received, errors, and connection closures.
+    class PlainLogger < Logger
+      # Logs connection to a relay
+      #
+      # @api private
+      #
+      # @param [Nostr::Relay] relay The relay the client connected to.
+      #
+      # @return [void]
+      #
+      def on_connect(relay)
+        puts "Connected to the relay #{relay.name} (#{relay.url})"
+      end
+
+      # Logs a message received from the relay
+      #
+      # @api private
+      #
+      # @param [String] message The message received.
+      #
+      # @return [void]
+      #
+      def on_message(message)
+        puts "◄- #{message}"
+      end
+
+      # Logs a message sent to the relay
+      #
+      # @api private
+      #
+      # @param [String] message The message sent.
+      #
+      # @return [void]
+      #
+      def on_send(message)
+        puts "-► #{message}"
+      end
+
+      # Logs an error message
+      #
+      # @api private
+      #
+      # @param [String] message The error message.
+      #
+      # @return [void]
+      #
+      def on_error(message)
+        puts "Error: #{message}"
+      end
+
+      # Logs a closure of connection with a relay
+      #
+      # @api private
+      #
+      # @param [String] code The closure code.
+      # @param [String] reason The reason for the closure.
+      #
+      # @return [void]
+      #
+      def on_close(code, reason)
+        puts "Connection closed: #{reason} (##{code})"
+      end
+    end
+  end
+end

data/lib/nostr/client.rb

@@ -18,11 +18,19 @@ module Nostr
     # @api public
     #
     # @example Instantiating a client that logs all the events it sends and receives
-    #   client = Nostr::Client.new(debug: true)
+    #   client = Nostr::Client.new
     #
-    def initialize
+    # @example Instantiating a client with no logging
+    #   client = Nostr::Client.new(logger: nil)
+    #
+    # @example Instantiating a client with your own logger
+    #   client = Nostr::Client.new(logger: YourLogger.new)
+    #
+    def initialize(logger: ColorLogger.new)
       @subscriptions = {}
+      @logger = logger
 
+      logger&.attach_to(self)
       initialize_channels
     end
 
@@ -40,11 +48,11 @@ module Nostr
     #
     def connect(relay)
       execute_within_an_em_thread do
-        client = Faye::WebSocket::Client.new(relay.url, [], { tls: { verify_peer: false } })
-        parent_to_child_channel.subscribe { |msg| client.send(msg) }
+        client = build_websocket_client(relay.url)
+        parent_to_child_channel.subscribe { |msg| client.send(msg) && emit(:send, msg) }
 
         client.on :open do
-          child_to_parent_channel.push(type: :open)
+          child_to_parent_channel.push(type: :open, relay:)
         end
 
         client.on :message do |event|
@@ -122,6 +130,14 @@ module Nostr
 
     private
 
+    # The logger that prints all the events that the client sends and receives
+    #
+    # @api private
+    #
+    # @return [ClientLogger]
+    #
+    attr_reader :logger
+
     # The subscriptions that the client has created
     #
     # @api private
@@ -167,11 +183,21 @@ module Nostr
       @child_to_parent_channel = EventMachine::Channel.new
 
       child_to_parent_channel.subscribe do |msg|
-        emit :connect                           if msg[:type] == :open
+        emit :connect, msg[:relay]              if msg[:type] == :open
         emit :message, msg[:data]               if msg[:type] == :message
         emit :error,   msg[:message]            if msg[:type] == :error
         emit :close,   msg[:code], msg[:reason] if msg[:type] == :close
       end
     end
+
+    # Builds a websocket client
+    #
+    # @api private
+    #
+    # @return [Faye::WebSocket::Client]
+    #
+    def build_websocket_client(relay_url)
+      Faye::WebSocket::Client.new(relay_url, [], { tls: { verify_peer: false } })
+    end
   end
 end

data/lib/nostr/errors/invalid_signature_type_error.rb

@@ -11,6 +11,6 @@ module Nostr
     # @example
     #   InvalidSignatureTypeError.new
     #
-    def initialize = super('Invalid signature type')
+    def initialize = super('Invalid signature type. It must be a string with lowercase hexadecimal characters.')
   end
 end

data/lib/nostr/event.rb

@@ -203,8 +203,7 @@ module Nostr
     def verify_signature
       crypto = Crypto.new
 
-      return false if id.nil? || pubkey.nil?
-      return false if sig.nil? # FIXME: See https://github.com/soutaro/steep/issues/1079
+      return false if id.nil? || pubkey.nil? || sig.nil?
 
       crypto.valid_sig?(id, pubkey, sig)
     end

data/lib/nostr/version.rb

@@ -2,5 +2,5 @@
 
 module Nostr
   # The version of the gem
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 end

data/lib/nostr.rb

@@ -16,6 +16,8 @@ require_relative 'nostr/signature'
 require_relative 'nostr/event'
 require_relative 'nostr/events/encrypted_direct_message'
 require_relative 'nostr/client'
+require_relative 'nostr/client/logger'
+require_relative 'nostr/client/color_logger'
 require_relative 'nostr/user'
 require_relative 'nostr/key'
 require_relative 'nostr/private_key'

data/nostr.gemspec

@@ -36,7 +36,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'ecdsa', '~> 1.2'
   spec.add_dependency 'event_emitter', '~> 0.2'
   spec.add_dependency 'faye-websocket', '~> 0.11'
-  spec.add_dependency 'json', '~> 2.6'
+  spec.add_dependency 'json', '~> 2.7'
 
   spec.add_development_dependency 'bundler-audit', '~> 0.9'
   spec.add_development_dependency 'dotenv', '~> 3.1'
@@ -54,10 +54,10 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rspec', '~> 3.13'
   spec.add_development_dependency 'rubocop', '~> 1.62'
   spec.add_development_dependency 'rubocop-rake', '~> 0.6'
-  spec.add_development_dependency 'rubocop-rspec', '2.27'
+  spec.add_development_dependency 'rubocop-rspec', '2.29'
   spec.add_development_dependency 'simplecov', '= 0.17'
   spec.add_development_dependency 'simplecov-console', '~> 0.9'
-  spec.add_development_dependency 'steep', '~> 1.6'
+  spec.add_development_dependency 'steep', '~> 1.7.dev3'
   spec.add_development_dependency 'typeprof', '~> 0.21'
   spec.add_development_dependency 'yard', '~> 0.9'
   spec.add_development_dependency 'yard-junk', '~> 0.0.9'

data/sig/nostr/client/color_logger.rbs

@@ -0,0 +1,6 @@
+module Nostr
+  class Client
+    class ColorLogger < Logger
+    end
+  end
+end

data/sig/nostr/client/logger.rbs

@@ -0,0 +1,12 @@
+module Nostr
+  class Client
+    class Logger
+      def attach_to: (Client client) -> void
+      def on_connect: (Relay relay) -> void
+      def on_message: (String message) -> void
+      def on_send: (String message) -> void
+      def on_error: (String message) -> void
+      def on_close: (String code, String reason) -> void
+    end
+  end
+end

data/sig/nostr/client/plain_logger.rbs

@@ -0,0 +1,6 @@
+module Nostr
+  class Client
+    class PlainLogger < Logger
+    end
+  end
+end

data/sig/nostr/client.rbs

@@ -10,11 +10,13 @@ module Nostr
 
     private
 
+    attr_reader logger: Logger
     attr_reader subscriptions: Hash[String, Subscription]
     attr_reader parent_to_child_channel: EventMachine::Channel
     attr_reader child_to_parent_channel: EventMachine::Channel
 
     def execute_within_an_em_thread: { -> void } -> Thread
     def initialize_channels: -> void
+    def build_websocket_client: (String relay_name) -> Faye::WebSocket::Client
   end
 end

data/sig/vendor/event_emitter.rbs

@@ -1,16 +1,14 @@
 # Added only to satisfy the Steep requirements. Not 100% reliable.
 module EventEmitter
-  interface _Event
-    def data: -> String
-    def message: -> String
-    def code: -> Integer
-    def reason: -> String
-  end
+  def self.included: (Module) -> void
+  def self.apply: (untyped) -> void
 
-  def add_listener: (Symbol event_name) { (_Event event) -> void } -> void
+  def __events: () -> Array[untyped]
+
+  def add_listener: (Symbol | String type, ?Hash[untyped, untyped] params) { (*untyped) -> void } -> Integer
   alias on add_listener
+  alias once add_listener
 
-  def remove_listener: (untyped id_or_type) -> Array[untyped]?
-  def emit: (Symbol `type`, *untyped data) -> Array[untyped]
-  def once: (Symbol `type`) -> Integer
+  def remove_listener: (Integer | Symbol | String id_or_type) -> void
+  def emit: (Symbol | String type, *untyped data) -> void
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nostr
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Wilson Silva
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-03-15 00:00:00.000000000 Z
+date: 2024-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bech32
@@ -86,14 +86,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2.7'
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -324,14 +324,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: '2.27'
+        version: '2.29'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: '2.27'
+        version: '2.29'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -366,14 +366,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: 1.7.dev3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: 1.7.dev3
 - !ruby/object:Gem::Dependency
   name: typeprof
   requirement: !ruby/object:Gem::Requirement
@@ -455,12 +455,16 @@ files:
 - Steepfile
 - adr/0001-record-architecture-decisions.md
 - adr/0002-introduction-of-signature-class.md
+- adr/0003-logging-methods-vs-logger-class.md
+- adr/0004-default-logging-activation.md
+- adr/0005-logger-types.md
 - docs/.gitignore
 - docs/.vitepress/config.mjs
 - docs/README.md
 - docs/api-examples.md
 - docs/bun.lockb
 - docs/common-use-cases/bech32-encoding-and-decoding-(NIP-19).md
+- docs/common-use-cases/logging-and-debugging.md
 - docs/common-use-cases/signing-and-verifying-events.md
 - docs/common-use-cases/signing-and-verifying-messages.md
 - docs/core/client.md
@@ -488,6 +492,9 @@ files:
 - lib/nostr.rb
 - lib/nostr/bech32.rb
 - lib/nostr/client.rb
+- lib/nostr/client/color_logger.rb
+- lib/nostr/client/logger.rb
+- lib/nostr/client/plain_logger.rb
 - lib/nostr/client_message_type.rb
 - lib/nostr/crypto.rb
 - lib/nostr/errors.rb
@@ -520,6 +527,9 @@ files:
 - sig/nostr.rbs
 - sig/nostr/bech32.rbs
 - sig/nostr/client.rbs
+- sig/nostr/client/color_logger.rbs
+- sig/nostr/client/logger.rbs
+- sig/nostr/client/plain_logger.rbs
 - sig/nostr/client_message_type.rbs
 - sig/nostr/crypto.rbs
 - sig/nostr/errors/error.rbs