laneful-ruby 1.2.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed5ff94086f558d6ea4bad6c914ec22cbc7b8d012cc27fc3d385d3cbc05c5c49
-  data.tar.gz: 02a6ba4d5c4dbee58809d4e15214623fc273770b3779d73fe6ae25b61de75252
+  metadata.gz: 3ebb676795d8c7c6b9f26ed1387e0420234f835ab57987deac701ab5cb1bef46
+  data.tar.gz: f75807a039ecf0b68ae2ad01ad6d6c613dc5986bec1543cdcda811ee270186f1
 SHA512:
-  metadata.gz: cc30d8a4112104938f451247b7c24654365f4bb6f8efb5dbeacff4947b00841115563bc7e93d4e36b2eb17e3f115a3616d91a99ebff081d0f322fc9ebdca2060
-  data.tar.gz: 560628e6bd7d5cefa3b9e3229c4be1806d8703d6a7c61e919b94d386b9b3e4a27f1ea95602096e5783236489f4c234233676ebeadf42591eb3db767ec4cf6875
+  metadata.gz: ffe6cbc2e0438a8100b61d8a206d088161617d1664126ec7bfe646d2523a033ec580055011cb7b17de4bea39a4e61ce152dda004dabd2d9f036a7ca3c970b5da
+  data.tar.gz: fd6c6e8c27c2b712fcae84ab1c424598949259c7c1a13fb80bbb40466e8d67e21d7824d20c7da5c9af0c480d1e756b8e7f7a55fb9b6e0fda8a8933a4ec2f61a0

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
 
@@ -403,9 +421,10 @@ module Laneful
       if webhook_data
         raise ValidationException, 'Webhook data cannot have more than 20 keys' if webhook_data.size > 20
 
+        # The send API counts UTF-8 bytes, so "é" counts as 2.
         webhook_data.each do |key, value|
-          raise ValidationException, 'Webhook data keys cannot exceed 50 characters' if key.to_s.length > 50
-          raise ValidationException, 'Webhook data values cannot exceed 100 characters' if value.to_s.length > 100
+          raise ValidationException, 'Webhook data keys cannot exceed 50 bytes (UTF-8)' if key.to_s.bytesize > 50
+          raise ValidationException, 'Webhook data values cannot exceed 100 bytes (UTF-8)' if value.to_s.bytesize > 100
         end
       end
 

data/lib/laneful/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Laneful
-  VERSION = '1.2.0'
+  VERSION = '1.3.1'
 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.1
 platform: ruby
 authors:
 - Laneful Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-12 00:00:00.000000000 Z
+date: 2026-10-27 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: []