- Added support for Verifalia API v2.6

- Added support for multiple CAPTCHA - Bot detection services.
- Added support for bearer token authentication and Multi-Factor authentication.
- Improved error handling: added support for parsing RFC-9457 `problem+json` responses and returning problem details in errors.
- Breaking change: the `invoke()` method in the `MultiplexedRestClient` class has been changed to accept instances of the new `RestRequest` class; if you're not using the `MultiplexedRestClient` class directly in your code, you won't be impacted by this change.
- Breaking change: the logic for `Authenticator` has been updated to accommodate bearer authentication and multi-factor authentication / TOTP; if you're not using a custom authentication method in your code, you won't be impacted by this change.
- Improved documentation.

.gitignore

@@ -1,3 +1,4 @@
 node_modules
 .rpt2_cache
-package-lock.json
+package-lock.json
+.idea

browser/esm/RestRequest-90d7ab0c.js

@@ -0,0 +1,44 @@
+// (c) Verifalia - email verification service - https://verifalia.com
+/**
+ * @license
+ * Verifalia - Email list cleaning and real-time email verification service
+ * https://verifalia.com/
+ * [email protected]
+ *
+ * Copyright (c) 2005-2024 Cobisi Research
+ *
+ * Cobisi Research
+ * Via Della Costituzione, 31
+ * 35010 Vigonza
+ * Italy - European Union
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+class RestRequest {
+    constructor(method, resource, params, data, configOverride) {
+        this.method = method;
+        this.resource = resource;
+        this.params = params;
+        this.data = data;
+        this.configOverride = configOverride;
+    }
+}
+
+export { RestRequest as R };

browser/esm/VerifaliaRestClient.d.ts

@@ -52,7 +52,7 @@ export declare class VerifaliaRestClient {
      * Default Verifalia base URIs for client-certificate authentication.
      */
     private _baseCcaUris;
-    private _restClientfactory;
+    private readonly _restClientFactory;
     /**
      * Allows to manage the credits for the Verifalia account.
      */

browser/esm/VerifaliaRestClientConfiguration.d.ts

@@ -31,6 +31,7 @@
  */
 /// <reference types="node" />
 import { KeyObject } from "tls";
+import { Authenticator } from "./rest/security/Authenticator";
 export interface VerifaliaRestClientConfiguration {
     /**
      * The username or the browser app key to use while authenticating to the Verifalia API, if
@@ -76,5 +77,6 @@ export interface VerifaliaRestClientConfiguration {
      * Shared passphrase used for a single private key and/or a PFX.
      */
     passphrase?: string;
+    authenticator?: Authenticator;
 }
 //# sourceMappingURL=VerifaliaRestClientConfiguration.d.ts.map

browser/esm/credits/functions.js

@@ -1,5 +1,6 @@
 // (c) Verifalia - email verification service - https://verifalia.com
 import { __awaiter, __asyncGenerator, __await } from 'tslib';
+import { R as RestRequest } from '../RestRequest-90d7ab0c.js';
 
 /**
  * @license
@@ -40,7 +41,7 @@ import { __awaiter, __asyncGenerator, __await } from 'tslib';
  */
 const getCreditsBalance = (restClientFactory, cancellationToken) => __awaiter(void 0, void 0, void 0, function* () {
     const restClient = restClientFactory.build();
-    return yield (yield restClient.invoke("GET", '/credits/balance', undefined, undefined, undefined, cancellationToken)).deserialize();
+    return yield (yield restClient.invoke(new RestRequest('GET', '/credits/balance'), cancellationToken)).deserialize();
 });
 /**
  * Lists the daily usages of the credits for the Verifalia account.
@@ -72,7 +73,7 @@ function listCreditsDailyUsages(restClientFactory, options, cancellationToken) {
                     }
                 }
             }
-            const response = yield __await(restClient.invoke('GET', `/credits/daily-usage`, params, undefined, undefined, cancellationToken));
+            const response = yield __await(restClient.invoke(new RestRequest('GET', `/credits/daily-usage`, params), cancellationToken));
             // TODO: Check the response status code
             listSegment = yield __await(response.deserialize());
             for (const item of listSegment.data) {

browser/esm/email-validations/constants.js

@@ -254,5 +254,21 @@ const ValidationPriority_Normal = 127;
  * The highest possible relative processing priority (speed) for a validation job.
  */
 const ValidationPriority_Highest = 255;
+/**
+ * hCaptcha.
+ */
+const CaptchaProvider_HCaptcha = 'hCaptcha';
+/**
+ * Google reCAPTCHA v2.
+ */
+const CaptchaProvider_ReCaptchaV2 = 'reCaptcha_v2';
+/**
+ * Google reCAPTCHA v3.
+ */
+const CaptchaProvider_ReCaptchaV3 = 'reCaptcha_v3';
+/**
+ * Cloudflare Turnstile.
+ */
+const CaptchaProvider_Turnstile = 'Turnstile';
 
-export { DeduplicationMode_Off, DeduplicationMode_Relaxed, DeduplicationMode_Safe, QualityLevelName_Extreme, QualityLevelName_High, QualityLevelName_Standard, ValidationEntryClassification_Deliverable, ValidationEntryClassification_Risky, ValidationEntryClassification_Undeliverable, ValidationEntryClassification_Unknown, ValidationEntryStatus_AtSignNotFound, ValidationEntryStatus_CatchAllConnectionFailure, ValidationEntryStatus_CatchAllValidationTimeout, ValidationEntryStatus_DnsConnectionFailure, ValidationEntryStatus_DnsQueryTimeout, ValidationEntryStatus_DomainDoesNotExist, ValidationEntryStatus_DomainHasNullMx, ValidationEntryStatus_DomainIsMisconfigured, ValidationEntryStatus_DomainIsWellKnownDea, ValidationEntryStatus_DomainPartCompliancyFailure, ValidationEntryStatus_DoubleDotSequence, ValidationEntryStatus_Duplicate, ValidationEntryStatus_InvalidAddressLength, ValidationEntryStatus_InvalidCharacterInSequence, ValidationEntryStatus_InvalidEmptyQuotedWord, ValidationEntryStatus_InvalidFoldingWhiteSpaceSequence, ValidationEntryStatus_InvalidLocalPartLength, ValidationEntryStatus_InvalidWordBoundaryStart, ValidationEntryStatus_IspSpecificSyntaxFailure, ValidationEntryStatus_LocalEndPointRejected, ValidationEntryStatus_LocalPartIsWellKnownRoleAccount, ValidationEntryStatus_LocalSenderAddressRejected, ValidationEntryStatus_MailExchangerIsHoneypot, ValidationEntryStatus_MailExchangerIsParked, ValidationEntryStatus_MailExchangerIsWellKnownDea, ValidationEntryStatus_MailboxConnectionFailure, ValidationEntryStatus_MailboxDoesNotExist, ValidationEntryStatus_MailboxIsDea, ValidationEntryStatus_MailboxTemporarilyUnavailable, ValidationEntryStatus_MailboxValidationTimeout, ValidationEntryStatus_OverrideMatch, ValidationEntryStatus_ServerDoesNotSupportInternationalMailboxes, ValidationEntryStatus_ServerIsCatchAll, ValidationEntryStatus_ServerTemporaryUnavailable, ValidationEntryStatus_SmtpConnectionFailure, ValidationEntryStatus_SmtpConnectionTimeout, ValidationEntryStatus_SmtpDialogError, ValidationEntryStatus_Success, ValidationEntryStatus_UnacceptableDomainLiteral, ValidationEntryStatus_UnbalancedCommentParenthesis, ValidationEntryStatus_UnexpectedQuotedPairSequence, ValidationEntryStatus_UnhandledException, ValidationEntryStatus_UnmatchedQuotedPair, ValidationPriority_Highest, ValidationPriority_Lowest, ValidationPriority_Normal, ValidationStatus_Completed, ValidationStatus_Deleted, ValidationStatus_Expired, ValidationStatus_InProgress };
+export { CaptchaProvider_HCaptcha, CaptchaProvider_ReCaptchaV2, CaptchaProvider_ReCaptchaV3, CaptchaProvider_Turnstile, DeduplicationMode_Off, DeduplicationMode_Relaxed, DeduplicationMode_Safe, QualityLevelName_Extreme, QualityLevelName_High, QualityLevelName_Standard, ValidationEntryClassification_Deliverable, ValidationEntryClassification_Risky, ValidationEntryClassification_Undeliverable, ValidationEntryClassification_Unknown, ValidationEntryStatus_AtSignNotFound, ValidationEntryStatus_CatchAllConnectionFailure, ValidationEntryStatus_CatchAllValidationTimeout, ValidationEntryStatus_DnsConnectionFailure, ValidationEntryStatus_DnsQueryTimeout, ValidationEntryStatus_DomainDoesNotExist, ValidationEntryStatus_DomainHasNullMx, ValidationEntryStatus_DomainIsMisconfigured, ValidationEntryStatus_DomainIsWellKnownDea, ValidationEntryStatus_DomainPartCompliancyFailure, ValidationEntryStatus_DoubleDotSequence, ValidationEntryStatus_Duplicate, ValidationEntryStatus_InvalidAddressLength, ValidationEntryStatus_InvalidCharacterInSequence, ValidationEntryStatus_InvalidEmptyQuotedWord, ValidationEntryStatus_InvalidFoldingWhiteSpaceSequence, ValidationEntryStatus_InvalidLocalPartLength, ValidationEntryStatus_InvalidWordBoundaryStart, ValidationEntryStatus_IspSpecificSyntaxFailure, ValidationEntryStatus_LocalEndPointRejected, ValidationEntryStatus_LocalPartIsWellKnownRoleAccount, ValidationEntryStatus_LocalSenderAddressRejected, ValidationEntryStatus_MailExchangerIsHoneypot, ValidationEntryStatus_MailExchangerIsParked, ValidationEntryStatus_MailExchangerIsWellKnownDea, ValidationEntryStatus_MailboxConnectionFailure, ValidationEntryStatus_MailboxDoesNotExist, ValidationEntryStatus_MailboxIsDea, ValidationEntryStatus_MailboxTemporarilyUnavailable, ValidationEntryStatus_MailboxValidationTimeout, ValidationEntryStatus_OverrideMatch, ValidationEntryStatus_ServerDoesNotSupportInternationalMailboxes, ValidationEntryStatus_ServerIsCatchAll, ValidationEntryStatus_ServerTemporaryUnavailable, ValidationEntryStatus_SmtpConnectionFailure, ValidationEntryStatus_SmtpConnectionTimeout, ValidationEntryStatus_SmtpDialogError, ValidationEntryStatus_Success, ValidationEntryStatus_UnacceptableDomainLiteral, ValidationEntryStatus_UnbalancedCommentParenthesis, ValidationEntryStatus_UnexpectedQuotedPairSequence, ValidationEntryStatus_UnhandledException, ValidationEntryStatus_UnmatchedQuotedPair, ValidationPriority_Highest, ValidationPriority_Lowest, ValidationPriority_Normal, ValidationStatus_Completed, ValidationStatus_Deleted, ValidationStatus_Expired, ValidationStatus_InProgress };

browser/esm/email-validations/constants/index.d.ts

@@ -253,4 +253,20 @@ export declare const ValidationPriority_Normal = 127;
  * The highest possible relative processing priority (speed) for a validation job.
  */
 export declare const ValidationPriority_Highest = 255;
+/**
+ * hCaptcha.
+ */
+export declare const CaptchaProvider_HCaptcha = "hCaptcha";
+/**
+ * Google reCAPTCHA v2.
+ */
+export declare const CaptchaProvider_ReCaptchaV2 = "reCaptcha_v2";
+/**
+ * Google reCAPTCHA v3.
+ */
+export declare const CaptchaProvider_ReCaptchaV3 = "reCaptcha_v3";
+/**
+ * Cloudflare Turnstile.
+ */
+export declare const CaptchaProvider_Turnstile = "Turnstile";
 //# sourceMappingURL=index.d.ts.map