feat(sdk)!: allow passing Activity for passive sitekeys

CHANGES.md

@@ -2,7 +2,7 @@
 
 # 4.0.0
 
-- Feature: accept `HCaptcha.getClient(Activity)` for passive `siteKey`s (#112)
+- Feat (breaking change): accept `HCaptcha.getClient(Activity)` for passive sitekeys. (#112)
 
 # 3.11.0
 

README.md

@@ -115,7 +115,8 @@ To remove a specific listener you may use `HCaptcha.removeOn[Success|Failure|Ope
 
 To remove all listeners you may use `HCaptcha.removeAllListener()`.
 
-Note: For a regular use-case (Visual Challenge validation), `HCaptcha.getClient(Activity)` must be called with `FragmentActivity` instance
+Note ⚠️: For the regular use-case (visual challenge validation), `HCaptcha.getClient(Activity)` must be called with `FragmentActivity` instance. `Activity` is allowed only when `hideDialog=true`.
+
 
 ```java
 ...

sdk/src/main/java/com/hcaptcha/sdk/HCaptcha.java

@@ -106,7 +106,7 @@ void onFailure(final HCaptchaException exception) {
                 captchaVerifier = HCaptchaDialogFragment.newInstance(inputConfig, internalConfig, listener);
                 this.config = inputConfig;
             } else {
-                throw new IllegalStateException("Visual Challenge verification require FragmentActivity");
+                throw new IllegalStateException("Visual hCaptcha challenge verification requires FragmentActivity.");
             }
         } catch (AndroidRuntimeException e) {
             listener.onFailure(new HCaptchaException(HCaptchaError.ERROR));