laneful-ruby 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed5ff94086f558d6ea4bad6c914ec22cbc7b8d012cc27fc3d385d3cbc05c5c49
-  data.tar.gz: 02a6ba4d5c4dbee58809d4e15214623fc273770b3779d73fe6ae25b61de75252
+  metadata.gz: ae0fefd1de5f15988a54f6d158b70bb9037a7879d344ce217066347bec84dbd0
+  data.tar.gz: 5c4f9702e0fa83de52b7bbe040700817bbcabeabed1d753951cdaed0a6ea831f
 SHA512:
-  metadata.gz: cc30d8a4112104938f451247b7c24654365f4bb6f8efb5dbeacff4947b00841115563bc7e93d4e36b2eb17e3f115a3616d91a99ebff081d0f322fc9ebdca2060
-  data.tar.gz: 560628e6bd7d5cefa3b9e3229c4be1806d8703d6a7c61e919b94d386b9b3e4a27f1ea95602096e5783236489f4c234233676ebeadf42591eb3db767ec4cf6875
+  metadata.gz: bb8596d2eccaac4b25963ef3bfa5dc0eff89bd3884d5a44fa61b10892aad841d342d06f303918e68e3a49cf17509519fa3bcf3a577c2672cb2cf4c82dbb8182c
+  data.tar.gz: 7012812bed4f9c9c217d1aa6299c76eeb43c29cc8c4effe3cf0b78aaae6340992483b05ed58e1e975d95e98f11029f76f813e0c0775345150062a3dab15dcc8c

data/lib/laneful/models.rb

@@ -115,19 +115,26 @@ module Laneful
     end
   end
 
-  # Request-level mail settings (sandbox mode, return message IDs)
+  # Request-level mail settings (sandbox mode, return message IDs, idempotency key).
+  #
+  # idempotency_key protects against duplicate sends: Laneful accepts a key once per
+  # organization for one hour. A repeated request with the same key is answered with
+  # status "accepted" (and no message IDs) and sends nothing. Keys are 1 to 36 bytes.
   class MailSettings
-    attr_reader :sandbox_mode, :return_message_ids
+    attr_reader :sandbox_mode, :return_message_ids, :idempotency_key
 
-    def initialize(sandbox_mode: nil, return_message_ids: nil)
+    def initialize(sandbox_mode: nil, return_message_ids: nil, idempotency_key: nil)
       @sandbox_mode = sandbox_mode
       @return_message_ids = return_message_ids
+      @idempotency_key = idempotency_key
+      validate_idempotency_key!
     end
 
     def self.from_hash(data)
       new(
         sandbox_mode: data['sandbox_mode'],
-        return_message_ids: data['return_message_ids']
+        return_message_ids: data['return_message_ids'],
+        idempotency_key: data['idempotency_key']
       )
     end
 
@@ -135,13 +142,15 @@ module Laneful
       hash = {}
       hash['sandbox_mode'] = sandbox_mode unless sandbox_mode.nil?
       hash['return_message_ids'] = return_message_ids unless return_message_ids.nil?
+      hash['idempotency_key'] = idempotency_key unless idempotency_key.nil?
       hash
     end
 
     def ==(other)
       return false unless other.is_a?(MailSettings)
 
-      sandbox_mode == other.sandbox_mode && return_message_ids == other.return_message_ids
+      sandbox_mode == other.sandbox_mode && return_message_ids == other.return_message_ids &&
+        idempotency_key == other.idempotency_key
     end
 
     def eql?(other)
@@ -149,7 +158,16 @@ module Laneful
     end
 
     def hash
-      [sandbox_mode, return_message_ids].hash
+      [sandbox_mode, return_message_ids, idempotency_key].hash
+    end
+
+    private
+
+    def validate_idempotency_key!
+      return if idempotency_key.nil?
+      return if idempotency_key.bytesize.between?(1, 36)
+
+      raise ValidationException, 'idempotency_key must contain between 1 and 36 bytes'
     end
   end
 

data/lib/laneful/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Laneful
-  VERSION = '1.2.0'
+  VERSION = '1.3.0'
 end

data/lib/laneful/webhooks.rb

@@ -10,14 +10,12 @@ module Laneful
     SIGNATURE_PREFIX = 'sha256='
     SIGNATURE_HEADER_NAME = 'x-webhook-signature'
 
-    # Valid event types as documented
+    # Documented event types. Informational: parse_webhook_payload keeps events of other
+    # types, so new event types don't make the whole payload fail.
     VALID_EVENT_TYPES = %w[
       request delivery open click drop spam_complaint unsubscribe bounce
     ].freeze
 
-    # UUID pattern for lane_id validation
-    UUID_PATTERN = /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/i
-
     # Verifies a webhook signature with support for sha256= prefix
     # @param secret [String] The webhook secret
     # @param payload [String] The webhook payload
@@ -133,9 +131,7 @@ module Laneful
         raise ArgumentError, "Missing required field: #{field}" unless event.key?(field)
       end
 
-      # Validate event type
-      event_type = event['event']
-      raise ArgumentError, "Invalid event type: #{event_type}" unless VALID_EVENT_TYPES.include?(event_type)
+      raise ArgumentError, 'Missing required field: event' if event['event'].to_s.empty?
 
       # Validate email format
       email = event['email']
@@ -149,9 +145,7 @@ module Laneful
         raise ArgumentError, 'Invalid timestamp format'
       end
 
-      # Validate lane_id is a valid UUID format
-      lane_id = event['lane_id']
-      raise ArgumentError, "Invalid lane_id format: #{lane_id}" unless UUID_PATTERN.match?(lane_id)
+      # lane_id isn't checked: request events have an empty lane_id.
 
       # Return event with all fields (required + optional)
       event

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: laneful-ruby
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Laneful Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-12 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -53,14 +53,14 @@ files:
 - lib/laneful/org_models.rb
 - lib/laneful/version.rb
 - lib/laneful/webhooks.rb
-homepage: https://github.com/laneful/laneful-ruby
+homepage: https://github.com/lanefulhq/laneful-ruby
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/laneful/laneful-ruby
-  source_code_uri: https://github.com/laneful/laneful-ruby
-  changelog_uri: https://github.com/laneful/laneful-ruby/blob/main/CHANGELOG.md
-  documentation_uri: https://docs.laneful.com/ruby
+  homepage_uri: https://github.com/lanefulhq/laneful-ruby
+  source_code_uri: https://github.com/lanefulhq/laneful-ruby
+  changelog_uri: https://github.com/lanefulhq/laneful-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://laneful.com/docs/ruby-sdk/
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []