code-ruby 5.1.0 → 5.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eec903cbdd5d6368b89062c2b714515f30296bc14da6c56955cfb56883d1c8ec
-  data.tar.gz: efff6f91bce16b5bd93295f694be06337a7edbbfd3c882108ffc0f4b1381be17
+  metadata.gz: 978d1a5cd5c7828f25ac0d619f50d68dcee1596a9fd3d92ac4e1ba684bfe2481
+  data.tar.gz: 06c6cb5d2bf9e3b596d1524ea710dd3ec7f6c8abcd871f07c62f1eb291967c94
 SHA512:
-  metadata.gz: aaa741df2a2cedebe5db8b763cb0aaac30f5829175baa76a90b4207bbfdb31f2b3eb87cf397eb475ef50e881db24c054e199677f09928f56c359712d5ee83101
-  data.tar.gz: 59c8234dfb28efcb3672fbfb23673bfa5f3748edb92618fc0b5bda474ad700cca898da79f705ce750ac22b47539605544bb5c15d9e53287d872f97e77ffd5d32
+  metadata.gz: 9c314514dc4d2ca20ebd674fe158b90b1f2200008e9e56389fab38513d8b81a1f21f7bd2dbd85f3bf16fe0d376c6879737524bb7597070a413b767d0b43df5a4
+  data.tar.gz: 6ad13fe0f05f93e56fece2befeaf33fb08a10c5f3d2a8186021d57a2e7d6bd7c246615690e78bf950ab25f5453ce9af3b4d43399f6b7e3ea543d7fef83daecf1

data/VERSION

@@ -1 +1 @@
-5.1.0
+5.2.1

data/lib/code/object/cryptography.rb

@@ -13,7 +13,18 @@ class Code
           "Cryptography.sha512(:hello, format: :base64)"
         ]
       }.freeze
+      HMAC_ALGORITHM = "SHA256"
+      DEFAULT_FORMAT = "hex"
       CLASS_FUNCTIONS = {
+        "hmac_sha256" => {
+          name: "hmac_sha256",
+          description: "returns an HMAC SHA256 signature as hex, digest, or base64.",
+          examples: [
+            'Cryptography.hmac_sha256("key", "hello")',
+            'Cryptography.hmac_sha256("key", "hello", format: :base64)',
+            'Cryptography.hmac_sha256("key", "hello", format: :digest).size'
+          ]
+        },
         "md5" => {
           name: "md5",
           description:
@@ -78,6 +89,9 @@ class Code
         arguments = code_arguments.raw
 
         case code_operator.to_s
+        when "hmac_sha256"
+          sig(args) { [Object, Object, { format: String.maybe }] }
+          code_hmac_sha256(*arguments)
         when "md5"
           sig(args) { [Object, { format: String.maybe }] }
           code_md5(*arguments)
@@ -98,6 +112,22 @@ class Code
         end
       end
 
+      def self.code_hmac_sha256(key, payload, options = nil)
+        code_format = (options || {}).to_code.code_get("format")
+        format = code_format.nothing? ? DEFAULT_FORMAT : code_format.to_s.downcase
+        digest = OpenSSL::HMAC.digest(HMAC_ALGORITHM, key.to_s, payload.to_s)
+        case format
+        when "hex", "hexdigest"
+          digest.unpack1("H*").to_code
+        when "digest"
+          digest.to_code
+        when "base64"
+          ::Base64.strict_encode64(digest).to_code
+        else
+          raise Error, "Cryptography: unknown format #{format.inspect}"
+        end
+      end
+
       def self.code_md5(*arguments)
         payload = arguments[0]
         options = arguments[1] || Nothing.new

data/lib/code/object/smtp.rb

@@ -8,6 +8,38 @@ class Code
         description: "stores smtp settings and sends email messages.",
         examples: %w[Smtp Smtp.new Smtp.new.functions.keys.include?(:send)]
       }.freeze
+      MESSAGE_ARGUMENTS = {
+        from: String.maybe,
+        to: String.maybe,
+        subject: String.maybe,
+        body: String.maybe,
+        body_text: String.maybe,
+        body_html: String.maybe,
+        message_id: String.maybe
+      }.freeze
+      TEXT_CONTENT_TYPE = "text/plain; charset=UTF-8"
+      HTML_CONTENT_TYPE = "text/html; charset=UTF-8"
+      MULTIPART_CONTENT_TYPE = "multipart/alternative"
+      CLASS_FUNCTIONS = {
+        "encode" => {
+          name: "encode",
+          description: "encodes a message as MIME email.",
+          examples: [
+            'Smtp.encode({from: "a@example.com", to: "b@example.com", body: "hello"})',
+            'Smtp.encode({subject: "hello", body_text: "world"})',
+            'Smtp.encode({body_html: "<p>hello</p>"})'
+          ]
+        },
+        "address" => {
+          name: "address",
+          description: "parses a single email address and display name.",
+          examples: [
+            'Smtp.address("a@example.com")',
+            'Smtp.address("Alice <a@example.com>")',
+            'Smtp.address("Bob <b@example.com>")'
+          ]
+        }
+      }.freeze
       INSTANCE_FUNCTIONS = {
         "send" => {
           name: "send",
@@ -23,7 +55,7 @@ class Code
       def self.function_documentation(scope)
         return INSTANCE_FUNCTIONS if scope == :instance
 
-        {}
+        CLASS_FUNCTIONS
       end
 
       DEFAULT_PORT = 587
@@ -31,6 +63,69 @@ class Code
       DEFAULT_DOMAIN = "localhost.localdomain"
       ALLOWED_PORTS = [465, 587].freeze
 
+      def self.call(**args)
+        code_operator = args.fetch(:operator, nil).to_code
+        code_arguments = args.fetch(:arguments, []).to_code
+
+        case code_operator.to_s
+        when "encode"
+          sig(args) { MESSAGE_ARGUMENTS }
+          code_encode(code_arguments.code_first)
+        when "address"
+          sig(args) { String }
+          code_address(*code_arguments.raw)
+        else
+          super
+        end
+      end
+
+      def self.code_address(value)
+        text = value.to_s
+        raise Error, "smtp: invalid address" if text.match?(/[\r\n]/)
+
+        addresses = Mail::AddressList.new(text).addresses
+        raise Error, "smtp: expected one address" unless addresses.length == 1
+
+        address = addresses.first
+        unless address.local.present? && address.domain.present?
+          raise Error, "smtp: invalid address"
+        end
+
+        { email: address.address, name: address.display_name }.to_code
+      rescue Mail::Field::ParseError
+        raise Error, "smtp: invalid address"
+      end
+
+      def self.code_encode(message)
+        build_mail(message.to_code).encoded.to_code
+      end
+
+      def self.build_mail(message)
+        mail = Mail.new
+        mail.from = message.code_get("from").to_s
+        mail.to = message.code_get("to").to_s
+        mail.subject = message.code_get("subject").to_s
+        message_id = message.code_get("message_id").to_s
+        if message_id.match?(/[\r\n]/)
+          raise Error, "smtp: invalid message id"
+        end
+
+        mail.message_id = message_id if message_id.present?
+
+        text_part = Mail::Part.new
+        text_part.content_type = TEXT_CONTENT_TYPE
+        text_part.body = message.code_get("body_text").to_s.presence || message.code_get("body").to_s
+        mail.content_type = MULTIPART_CONTENT_TYPE
+        mail.add_part(text_part)
+        if message.code_get("body_html").to_s.present?
+          html_part = Mail::Part.new
+          html_part.content_type = HTML_CONTENT_TYPE
+          html_part.body = message.code_get("body_html").to_s
+          mail.add_part(html_part)
+        end
+        mail
+      end
+
       def call(**args)
         code_operator = args.fetch(:operator, nil).to_code
         code_arguments = args.fetch(:arguments, []).to_code
@@ -38,16 +133,7 @@ class Code
 
         case code_operator.to_s
         when "send"
-          sig(args) do
-            {
-              from: String.maybe,
-              to: String.maybe,
-              subject: String.maybe,
-              body: String.maybe,
-              body_text: String.maybe,
-              body_html: String.maybe
-            }
-          end
+          sig(args) { MESSAGE_ARGUMENTS }
 
           code_send(
             from: code_value.code_get("from"),
@@ -55,7 +141,8 @@ class Code
             subject: code_value.code_get("subject"),
             body: code_value.code_get("body"),
             body_text: code_value.code_get("body_text"),
-            body_html: code_value.code_get("body_html")
+            body_html: code_value.code_get("body_html"),
+            message_id: code_value.code_get("message_id")
           )
         else
           super
@@ -68,31 +155,12 @@ class Code
         subject: nil,
         body: nil,
         body_text: nil,
-        body_html: nil
+        body_html: nil,
+        message_id: nil
       )
-        code_from = from.to_code
-        code_to = to.to_code
-        code_subject = subject.to_code
-        code_body = body.to_code
-        code_body_text = body_text.to_code
-        code_body_html = body_html.to_code
-
-        mail = Mail.new
-        mail.from = code_from.to_s
-        mail.to = code_to.to_s
-        mail.subject = code_subject.to_s
-
-        text_part = Mail::Part.new
-        text_part.content_type = "text/plain; charset=UTF-8"
-        text_part.body = code_body_text.to_s.presence || code_body.to_s
-
-        html_part = Mail::Part.new
-        html_part.content_type = "text/html; charset=UTF-8"
-        html_part.body = code_body_html.to_s
-
-        mail.content_type = "multipart/alternative"
-        mail.add_part(text_part)
-        mail.add_part(html_part) if code_body_html.to_s.present?
+        mail = self.class.build_mail(
+          { from:, to:, subject:, body:, body_text:, body_html:, message_id: }.to_code
+        )
 
         address = code_get("address").to_s
         port = code_get("port").nothing? ? DEFAULT_PORT : code_get("port").to_i

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: code-ruby
 version: !ruby/object:Gem::Version
-  version: 5.1.0
+  version: 5.2.1
 platform: ruby
 authors:
 - Dorian Marié