wowsql-sdk 3.9.1 → 3.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d46c9cb43ff0d1ff729ee19c2384dec05476d286c4d5fb74041429fd4b5fc09
-  data.tar.gz: edb308e3ffa9e0be0ca4d7e7f54639da839c137f7eb52ce2eb977f8c9b7eae3b
+  metadata.gz: d95459a8c529ff5a62a4dc8c370041f1c77827bfc55069e562efeb5dcb9ba00a
+  data.tar.gz: 6f05ecb7c8da142eab17f92dd449fbc1761e3e4cb1c33c15028b6e00b8733762
 SHA512:
-  metadata.gz: 24d72bdaedce237c50ed1fcd43326d9cb54a013ee541569ae49a1aa422896b10583d04af7c01a8bb512a11044012ea8865ce5a671c8364891dad7ecb36d320e3
-  data.tar.gz: 9ff8164572fbf57cb644c83c9345b74d18ba1763e91c49e372980a550854837777e7b1122414e8afea08f7873ad2e1b254f08402f66f8f6b31e25db870e955e6
+  metadata.gz: 398dc67a4528c3699f110e5371395896734fb97eb6ef78aa9cef63ea810150e07a77980e63011af8c5c4b04a55551caf1688972c888f71be08e6a9f322723f83
+  data.tar.gz: 8c2e796cdcea0191470e0277201b91222f6fbe51d796698bbff6f50dd2a22a2371fef0e4fcc9d7dfaf07b4170f532d381560a431d1dec67a0d44267b1ee52b3b

data/CHANGELOG.md

@@ -5,11 +5,17 @@ All notable changes to the WowSQL Ruby SDK will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [3.9.1] - 2026-10-07
-
-### Added - Phone OTP (SMS)
-- `sendOtp` / `verifyOtp` (and language equivalents) accept either **email** or **phone** (exactly one)
-- Existing email OTP call sites remain backward compatible
+## [3.9.2] - 2026-10-10
+
+### Added - Optional Turnstile captcha
+- Optional captcha token on signup, login, forgot password, OTP send, magic link, and resend verification
+- Existing calls without a token remain unchanged
+
+## [3.9.1] - 2026-10-07
+
+### Added - Phone OTP (SMS)
+- `sendOtp` / `verifyOtp` (and language equivalents) accept either **email** or **phone** (exactly one)
+- Existing email OTP call sites remain backward compatible
 
 
 ## [3.9.0] - 2026-08-20

data/README.md

@@ -406,6 +406,22 @@ puts response.session.access_token
 puts response.session.refresh_token
 ```
 
+### CAPTCHA (Turnstile)
+
+Optional. Only required when Attack Protection → Turnstile is enabled. Existing calls without `captcha_token` are unchanged.
+
+```ruby
+# 1. GET /auth/v1/settings → captcha.site_key
+# 2. Render Cloudflare Turnstile with that site key
+# 3. Pass the token:
+auth.sign_up(email: "alice@example.com", password: "SecurePass123!", captcha_token: turnstile_token)
+auth.sign_in(email: "alice@example.com", password: "SecurePass123!", captcha_token: turnstile_token)
+auth.forgot_password(email: "alice@example.com", captcha_token: turnstile_token)
+auth.send_otp(email: "alice@example.com", captcha_token: turnstile_token)
+auth.send_magic_link(email: "alice@example.com", captcha_token: turnstile_token)
+auth.resend_verification(email: "alice@example.com", captcha_token: turnstile_token)
+```
+
 ### get_user
 
 ```ruby

data/lib/wowsql/auth.rb

@@ -126,10 +126,11 @@ module WOWSQL
     # @param full_name [String, nil] Optional full name
     # @param user_metadata [Hash, nil] Optional user metadata
     # @return [AuthResponse]
-    def sign_up(email:, password:, full_name: nil, user_metadata: nil)
+    def sign_up(email:, password:, full_name: nil, user_metadata: nil, captcha_token: nil)
       payload = { email: email, password: password }
       payload[:full_name] = full_name if full_name
       payload[:user_metadata] = user_metadata if user_metadata
+      payload[:captcha_token] = captcha_token if captcha_token && !captcha_token.to_s.empty?
 
       data = request('POST', '/signup', nil, payload)
       session = persist_session(data)
@@ -142,8 +143,9 @@ module WOWSQL
     # @param email [String] User email
     # @param password [String] User password
     # @return [AuthResponse]
-    def sign_in(email:, password:)
+    def sign_in(email:, password:, captcha_token: nil)
       payload = { email: email, password: password }
+      payload[:captcha_token] = captcha_token if captcha_token && !captcha_token.to_s.empty?
       data = request('POST', '/login', nil, payload)
       session = persist_session(data)
       AuthResponse.new(session: session, user: nil)
@@ -219,8 +221,9 @@ module WOWSQL
     #
     # @param email [String] User's email address
     # @return [Hash]
-    def forgot_password(email:)
+    def forgot_password(email:, captcha_token: nil)
       payload = { email: email }
+      payload[:captcha_token] = captcha_token if captcha_token && !captcha_token.to_s.empty?
       data = request('POST', '/forgot-password', nil, payload)
       {
         'success' => data['success'] != false,
@@ -248,7 +251,7 @@ module WOWSQL
     # @param phone [String, nil] E.164 phone number
     # @param purpose [String] 'login', 'signup', or 'password_reset'
     # @return [Hash]
-    def send_otp(email: nil, phone: nil, purpose: 'login')
+    def send_otp(email: nil, phone: nil, purpose: 'login', captcha_token: nil)
       unless %w[login signup password_reset].include?(purpose)
         raise WOWSQLError.new("Purpose must be 'login', 'signup', or 'password_reset'")
       end
@@ -259,6 +262,7 @@ module WOWSQL
       payload = { purpose: purpose }
       payload[:email] = email unless email.to_s.empty?
       payload[:phone] = phone unless phone.to_s.empty?
+      payload[:captcha_token] = captcha_token if captcha_token && !captcha_token.to_s.empty?
 
       data = request('POST', '/otp/send', nil, payload)
       {
@@ -311,12 +315,13 @@ module WOWSQL
     # @param email [String] User's email address
     # @param purpose [String] 'login', 'signup', or 'email_verification'
     # @return [Hash]
-    def send_magic_link(email:, purpose: 'login')
+    def send_magic_link(email:, purpose: 'login', captcha_token: nil)
       unless %w[login signup email_verification].include?(purpose)
         raise WOWSQLError.new("Purpose must be 'login', 'signup', or 'email_verification'")
       end
 
       payload = { email: email, purpose: purpose }
+      payload[:captcha_token] = captcha_token if captcha_token && !captcha_token.to_s.empty?
       data = request('POST', '/magic-link/send', nil, payload)
       {
         'success' => data['success'] != false,
@@ -342,8 +347,9 @@ module WOWSQL
     #
     # @param email [String] User's email address
     # @return [Hash]
-    def resend_verification(email:)
+    def resend_verification(email:, captcha_token: nil)
       payload = { email: email }
+      payload[:captcha_token] = captcha_token if captcha_token && !captcha_token.to_s.empty?
       data = request('POST', '/resend-verification', nil, payload)
       {
         'success' => data['success'] != false,

data/lib/wowsql/version.rb

@@ -1,4 +1,4 @@
 module WOWSQL
-  VERSION = "3.9.1"
+  VERSION = "3.9.2"
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wowsql-sdk
 version: !ruby/object:Gem::Version
-  version: 3.9.1
+  version: 3.9.2
 platform: ruby
 authors:
 - WOWSQL Team