mailsmtp 0.2.0

data/lib/mailsmtp/session.rb

@@ -0,0 +1,63 @@
+module MailSmtp
+  # Per-connection state for one SMTP conversation: where the client is in the
+  # command sequence, who they authenticated as, and the envelope they are
+  # building. One Session lives for the life of a single connection and is
+  # handed to every hook on Server. Subclass via Server#build_session.
+  #
+  # Message bytes are not stored here — during DATA the engine passes a live
+  # +DataReader+ into +Server#receive+.
+  class Session
+    class Envelope
+      attr_accessor :from, :encoding_body, :encoding_utf8, :declared_size
+      attr_reader :to
+
+      def initialize
+        @to = []
+      end
+    end
+
+    attr_accessor :phase,
+      :local_ip, :remote_ip, :helo, :helo_response, :local_response,
+      :connected_at, :encrypted_at, :authenticated_at,
+      :authorization_id, :authentication_id, :auth_login_username,
+      :exceptions, :auth_failures, :proxy, :close_after_reply,
+      :tls_version, :tls_cipher
+    attr_reader :envelope
+
+    def initialize
+      @exceptions = 0
+      @auth_failures = 0
+      @proxy = nil
+      @close_after_reply = false
+      @tls_version = nil
+      @tls_cipher = nil
+      reset
+      @phase = :helo
+    end
+
+    # Clear the per-message state — envelope and command sequence — while
+    # keeping the connection and its authentication. Used on RSET and at the end
+    # of each accepted message.
+    def reset
+      @phase = :ready
+      @envelope = Envelope.new
+      @auth_login_username = nil
+    end
+
+    # Drop identity asserted before STARTTLS (RFC 3207 §4.2).
+    def reset_authentication
+      @authenticated_at = nil
+      @authorization_id = nil
+      @authentication_id = nil
+      @auth_login_username = nil
+    end
+
+    def authenticated?
+      !authenticated_at.nil?
+    end
+
+    def encrypted?
+      !encrypted_at.nil?
+    end
+  end
+end

data/lib/mailsmtp/version.rb

@@ -0,0 +1,3 @@
+module MailSmtp
+  VERSION = "0.2.0"
+end

data/lib/mailsmtp.rb

@@ -0,0 +1,10 @@
+require "mailsmtp/version"
+require "mailsmtp/error"
+require "mailsmtp/errors"
+require "mailsmtp/session"
+require "mailsmtp/data_reader"
+require "mailsmtp/server"
+
+# Mail SMTP server.
+module MailSmtp
+end

data/mailsmtp.gemspec

@@ -0,0 +1,37 @@
+require_relative "lib/mailsmtp/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "mailsmtp"
+  spec.version = MailSmtp::VERSION
+  spec.platform = Gem::Platform::RUBY
+  spec.required_ruby_version = ">= 3.3.4"
+  spec.authors = [ "Simon Lev" ]
+  spec.email = [ "support@postrider.dev" ]
+
+  spec.summary = "A Boring SMTP server for Ruby"
+  spec.description = "Receive email in your own app — no Postfix, no ESP required. Implements the SMTP protocol so you can plug in your own logic for auth, accepting mail, and storage."
+
+  spec.homepage = "https://github.com/mailpiece/mailsmtp"
+  spec.license = "MIT"
+
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata["bug_tracker_uri"] = "#{spec.homepage}/issues"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  # Anchor to the gemspec directory so `gem build` from another cwd still packs files.
+  spec.files = Dir.chdir(__dir__) do
+    Dir[
+      "lib/**/*.rb",
+      "CHANGELOG.md",
+      "README.md",
+      "LICENSE",
+      "mailsmtp.gemspec"
+    ]
+  end
+  spec.require_paths = [ "lib" ]
+
+  # Bundled gems since Ruby 3.4 / 4.0 — must be declared for clean consumer bundles.
+  spec.add_dependency "base64"
+  spec.add_dependency "logger"
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: mailsmtp
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Simon Lev
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Receive email in your own app — no Postfix, no ESP required. Implements
+  the SMTP protocol so you can plug in your own logic for auth, accepting mail, and
+  storage.
+email:
+- support@postrider.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/mailsmtp.rb
+- lib/mailsmtp/data_reader.rb
+- lib/mailsmtp/error.rb
+- lib/mailsmtp/errors.rb
+- lib/mailsmtp/server.rb
+- lib/mailsmtp/session.rb
+- lib/mailsmtp/version.rb
+- mailsmtp.gemspec
+homepage: https://github.com/mailpiece/mailsmtp
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/mailpiece/mailsmtp
+  changelog_uri: https://github.com/mailpiece/mailsmtp/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/mailpiece/mailsmtp/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.4
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: A Boring SMTP server for Ruby
+test_files: []