@nestlab/google-recaptcha 3.0.1 → 3.1.0

package/README.md

@@ -8,6 +8,7 @@ Supported for HTTP and GraphQL [NestJS](https://docs.nestjs.com/) applications.
 - [Configuration](#configuration)
 - [Usage](#usage)
     -  [Validate in service](#validate-in-service)
+    -  [Validate in service (enterprise)](#validate-in-service-enterprise)
     -  [Guard](#guard)
     -  [GraphQL guard](#graphql-guard)
 - [Error handling](#error-handling)
@@ -58,22 +59,55 @@ export class AppModule {
 }
 ```
 
+**Configuration for reCAPTCHA Enterprise**
+
+```typescript
+@Module({
+    imports: [
+        GoogleRecaptchaModule.forRoot({
+            response: (req: IncomingMessage) => (req.headers.recaptcha || '').toString(),
+            skipIf: process.env.NODE_ENV !== 'production',
+            actions: ['SignUp', 'SignIn'],
+            score: 0.8,
+            enterprise: { 
+                projectId: process.env.RECAPTCHA_ENTERPRISE_PROJECT_ID, 
+                siteKey: process.env.RECAPTCHA_ENTERPRISE_SITE_KEY, 
+                apiKey: process.env.RECAPTCHA_ENTERPRISE_API_KEY, 
+            },
+        })
+    ],
+})
+export class AppModule {
+}
+```
+
 **Tip: header names transforming to lower case.**
 
 **For example:** If you send 'Recaptcha' header then use `(req) => req.headers.recaptcha`
 
-**Configuration options**
+#### Configuration options
 
 | Property          | Description |
 |-------------------|-------------|
-| `secretKey`       | **Required.**<br> Type: `string`<br> Google recaptcha secret key |
 | `response`        | **Required.**<br> Type: `(request) => string`<br> Function that returns response (recaptcha token) by request |
+| `secretKey`       | Optional.<br> Type: `string`<br> Google recaptcha secret key. Must be set if you don't use reCAPTCHA Enterprise |
+| `debug`           | Optional.<br> Type: `boolean` <br> Default: `false` <br> Enables logging requests, responses, errors and transformed results |
+| `logger`          | Optional.<br> Type: `Logger` <br> Default: `new Logger()` <br> Instance of custom logger that extended from Logger (@nestjs/common) |
 | `skipIf`          | Optional.<br> Type: `boolean` \| `(request) => boolean \| Promise<boolean>` <br> Function that returns true if you allow the request to skip the recaptcha verification. Useful for involing other check methods (e.g. custom privileged API key) or for development or testing |
+| `enterprise`      | Optional.<br> Type: [`GoogleRecaptchaEnterpriseOptions`](#GoogleRecaptchaEnterpriseOptions) <br> Options for using recCAPTCHA Enterprise API. Cannot using with `secretKey` option.  |
 | `network`         | Optional.<br> Type: `GoogleRecaptchaNetwork` \| `string`<br> Default: `GoogleRecaptchaNetwork.Google` <br> If your server has trouble connecting to https://google.com then you can set networks:<br> `GoogleRecaptchaNetwork.Google` = 'https://www.google.com/recaptcha/api/siteverify'<br>`GoogleRecaptchaNetwork.Recaptcha` = 'https://recaptcha.net/recaptcha/api/siteverify'<br> or set any api url |
 | `score`           | Optional.<br> Type: `number` \| `(score: number) => boolean`<br> Score validator for reCAPTCHA v3. <br> `number` - minimum available score. <br> `(score: number) => boolean` - function with custom validation rules. |
 | `actions`         | Optional.<br> Type: `string[]`<br> Available action list for reCAPTCHA v3. <br> You can make this check stricter by passing the action property parameter to `@Recaptcha(...)` decorator. |
 | `axiosConfig`     | Optional.<br> Type: `AxiosRequestConfig`<br> Allows to setup proxy, response timeout, https agent etc... |
 
+#### GoogleRecaptchaEnterpriseOptions
+
+| Property        | Description |
+|-----------------|-------------|
+| `projectId`     | **Required.**<br> Type: `string`<br> Google Cloud project ID |
+| `siteKey`       | **Required.**<br> Type: `string`<br> [reCAPTCHA key](https://cloud.google.com/recaptcha-enterprise/docs/keys) associated with the site/app. |
+| `apiKey`        | **Required.**<br> Type: `string`<br> API key associated with the current project. <br>Must have permission `reCAPTCHA Enterprise API`. <br> You can manage credentials [here](https://console.cloud.google.com/apis/credentials). |
+
 If you want import configs from your [ConfigService](https://docs.nestjs.com/techniques/configuration#getting-started) via [custom getter function](https://docs.nestjs.com/techniques/configuration#custom-getter-functions) that will return `GoogleRecaptchaModuleOptions` object.
 
 ```typescript
@@ -115,6 +149,32 @@ export class SomeService {
 }
 ```
 
+### Validate in service (Enterprise)
+
+```typescript
+@Injectable()
+export class SomeService {
+    constructor(private readonly recaptchaEnterpriseValidator: GoogleRecaptchaEnterpriseValidator) {
+    }
+
+    async someAction(recaptchaToken: string): Promise<void> {
+        const result = await this.recaptchaEnterpriseValidator.validate({
+            response: recaptchaToken,
+            score: 0.8,
+            action: 'SomeAction',
+        });
+        
+        if (!result.success) {
+            throw new GoogleRecaptchaException(result.errors);
+        }
+        
+        const riskAnalytics = result.getEnterpriseRiskAnalytics();
+        
+        // TODO: Your implemetation
+    }
+}
+```
+
 ### Guard
 
 Use `@Recaptcha` decorator to protect your endpoints.

package/enums/classification-reason.d.ts

@@ -0,0 +1,8 @@
+export declare enum ClassificationReason {
+    CLASSIFICATION_REASON_UNSPECIFIED = "CLASSIFICATION_REASON_UNSPECIFIED",
+    AUTOMATION = "AUTOMATION",
+    UNEXPECTED_ENVIRONMENT = "UNEXPECTED_ENVIRONMENT",
+    TOO_MUCH_TRAFFIC = "TOO_MUCH_TRAFFIC",
+    UNEXPECTED_USAGE_PATTERNS = "UNEXPECTED_USAGE_PATTERNS",
+    LOW_CONFIDENCE_SCORE = "LOW_CONFIDENCE_SCORE"
+}

package/enums/classification-reason.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClassificationReason = void 0;
+var ClassificationReason;
+(function (ClassificationReason) {
+    ClassificationReason["CLASSIFICATION_REASON_UNSPECIFIED"] = "CLASSIFICATION_REASON_UNSPECIFIED";
+    ClassificationReason["AUTOMATION"] = "AUTOMATION";
+    ClassificationReason["UNEXPECTED_ENVIRONMENT"] = "UNEXPECTED_ENVIRONMENT";
+    ClassificationReason["TOO_MUCH_TRAFFIC"] = "TOO_MUCH_TRAFFIC";
+    ClassificationReason["UNEXPECTED_USAGE_PATTERNS"] = "UNEXPECTED_USAGE_PATTERNS";
+    ClassificationReason["LOW_CONFIDENCE_SCORE"] = "LOW_CONFIDENCE_SCORE";
+})(ClassificationReason = exports.ClassificationReason || (exports.ClassificationReason = {}));
+//# sourceMappingURL=classification-reason.js.map

package/enums/classification-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification-reason.js","sourceRoot":"","sources":["../../src/enums/classification-reason.ts"],"names":[],"mappings":";;;AAAA,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC5B,+FAAuE,CAAA;IACvE,iDAAyB,CAAA;IACzB,yEAAiD,CAAA;IACjD,6DAAqC,CAAA;IACrC,+EAAuD,CAAA;IACvD,qEAA6C,CAAA;AACjD,CAAC,EAPW,oBAAoB,GAApB,4BAAoB,KAApB,4BAAoB,QAO/B"}

package/enums/error-code.d.ts

@@ -9,5 +9,7 @@ export declare enum ErrorCode {
     ForbiddenAction = "forbidden-action",
     LowScore = "low-score",
     InvalidKeys = "invalid-keys",
-    NetworkError = "network-error"
+    NetworkError = "network-error",
+    SiteMismatch = "site-mismatch",
+    BrowserError = "browser-error"
 }

package/enums/error-code.js

@@ -14,5 +14,8 @@ var ErrorCode;
     ErrorCode["LowScore"] = "low-score";
     ErrorCode["InvalidKeys"] = "invalid-keys";
     ErrorCode["NetworkError"] = "network-error";
+    // enterprise
+    ErrorCode["SiteMismatch"] = "site-mismatch";
+    ErrorCode["BrowserError"] = "browser-error";
 })(ErrorCode = exports.ErrorCode || (exports.ErrorCode = {}));
 //# sourceMappingURL=error-code.js.map

package/enums/error-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-code.js","sourceRoot":"","sources":["../../src/enums/error-code.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAYX;AAZD,WAAY,SAAS;IACpB,wDAA2C,CAAA;IAC3C,wDAA2C,CAAA;IAC3C,4DAA+C,CAAA;IAC/C,4DAA+C,CAAA;IAC/C,uCAA0B,CAAA;IAC1B,wDAA2C,CAAA;IAC3C,2CAA8B,CAAA;IAC9B,iDAAoC,CAAA;IACpC,mCAAsB,CAAA;IACtB,yCAA4B,CAAA;IACzB,2CAA8B,CAAA;AAClC,CAAC,EAZW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAYpB"}
+{"version":3,"file":"error-code.js","sourceRoot":"","sources":["../../src/enums/error-code.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAeX;AAfD,WAAY,SAAS;IACpB,wDAA2C,CAAA;IAC3C,wDAA2C,CAAA;IAC3C,4DAA+C,CAAA;IAC/C,4DAA+C,CAAA;IAC/C,uCAA0B,CAAA;IAC1B,wDAA2C,CAAA;IAC3C,2CAA8B,CAAA;IAC9B,iDAAoC,CAAA;IACpC,mCAAsB,CAAA;IACtB,yCAA4B,CAAA;IACzB,2CAA8B,CAAA;IACjC,aAAa;IACb,2CAA8B,CAAA;IAC9B,2CAA8B,CAAA;AAC/B,CAAC,EAfW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAepB"}

package/enums/google-recaptcha-context.d.ts

@@ -0,0 +1,4 @@
+export declare enum GoogleRecaptchaContext {
+    GoogleRecaptcha = "GoogleRecaptcha",
+    GoogleRecaptchaEnterprise = "GoogleRecaptchaEnterprise"
+}

package/enums/google-recaptcha-context.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleRecaptchaContext = void 0;
+var GoogleRecaptchaContext;
+(function (GoogleRecaptchaContext) {
+    GoogleRecaptchaContext["GoogleRecaptcha"] = "GoogleRecaptcha";
+    GoogleRecaptchaContext["GoogleRecaptchaEnterprise"] = "GoogleRecaptchaEnterprise";
+})(GoogleRecaptchaContext = exports.GoogleRecaptchaContext || (exports.GoogleRecaptchaContext = {}));
+//# sourceMappingURL=google-recaptcha-context.js.map

package/enums/google-recaptcha-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-recaptcha-context.js","sourceRoot":"","sources":["../../src/enums/google-recaptcha-context.ts"],"names":[],"mappings":";;;AAAA,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAC9B,6DAAmC,CAAA;IACnC,iFAAuD,CAAA;AAC3D,CAAC,EAHW,sBAAsB,GAAtB,8BAAsB,KAAtB,8BAAsB,QAGjC"}

package/enums/google-recaptcha-enterprise-reason.d.ts

@@ -0,0 +1,10 @@
+export declare enum GoogleRecaptchaEnterpriseReason {
+    InvalidReasonUnspecified = "INVALID_REASON_UNSPECIFIED",
+    UnknownInvalidReason = "UNKNOWN_INVALID_REASON",
+    Malformed = "MALFORMED",
+    Expired = "EXPIRED",
+    Dupe = "DUPE",
+    SiteMismatch = "SITE_MISMATCH",
+    Missing = "MISSING",
+    BrowserError = "BROWSER_ERROR"
+}

package/enums/google-recaptcha-enterprise-reason.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleRecaptchaEnterpriseReason = void 0;
+var GoogleRecaptchaEnterpriseReason;
+(function (GoogleRecaptchaEnterpriseReason) {
+    GoogleRecaptchaEnterpriseReason["InvalidReasonUnspecified"] = "INVALID_REASON_UNSPECIFIED";
+    GoogleRecaptchaEnterpriseReason["UnknownInvalidReason"] = "UNKNOWN_INVALID_REASON";
+    GoogleRecaptchaEnterpriseReason["Malformed"] = "MALFORMED";
+    GoogleRecaptchaEnterpriseReason["Expired"] = "EXPIRED";
+    GoogleRecaptchaEnterpriseReason["Dupe"] = "DUPE";
+    GoogleRecaptchaEnterpriseReason["SiteMismatch"] = "SITE_MISMATCH";
+    GoogleRecaptchaEnterpriseReason["Missing"] = "MISSING";
+    GoogleRecaptchaEnterpriseReason["BrowserError"] = "BROWSER_ERROR";
+})(GoogleRecaptchaEnterpriseReason = exports.GoogleRecaptchaEnterpriseReason || (exports.GoogleRecaptchaEnterpriseReason = {}));
+//# sourceMappingURL=google-recaptcha-enterprise-reason.js.map

package/enums/google-recaptcha-enterprise-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-recaptcha-enterprise-reason.js","sourceRoot":"","sources":["../../src/enums/google-recaptcha-enterprise-reason.ts"],"names":[],"mappings":";;;AAAA,IAAY,+BASX;AATD,WAAY,+BAA+B;IACvC,0FAAuD,CAAA;IACvD,kFAA+C,CAAA;IAC/C,0DAAuB,CAAA;IACvB,sDAAmB,CAAA;IACnB,gDAAa,CAAA;IACb,iEAA8B,CAAA;IAC9B,sDAAmB,CAAA;IACnB,iEAA8B,CAAA;AAClC,CAAC,EATW,+BAA+B,GAA/B,uCAA+B,KAA/B,uCAA+B,QAS1C"}

package/exceptions/google-recaptcha.exception.js

@@ -25,6 +25,10 @@ class GoogleRecaptchaException extends common_1.HttpException {
                 return 'Low recaptcha score.';
             case error_code_1.ErrorCode.ForbiddenAction:
                 return 'Forbidden recaptcha action.';
+            case error_code_1.ErrorCode.SiteMismatch:
+                return 'The user verification token did not match the provided site key.';
+            case error_code_1.ErrorCode.BrowserError:
+                return 'Retriable error (such as network failure) occurred on the browser.';
             case error_code_1.ErrorCode.UnknownError:
             case error_code_1.ErrorCode.BadRequest:
             default:

package/exceptions/google-recaptcha.exception.js.map

@@ -1 +1 @@
-{"version":3,"file":"google-recaptcha.exception.js","sourceRoot":"","sources":["../../src/exceptions/google-recaptcha.exception.ts"],"names":[],"mappings":";;;AAAA,2CAAyD;AACzD,oDAA8C;AAE9C,MAAa,wBAAyB,SAAQ,sBAAa;IAC1D,YAA4B,UAAuB,EACpC,YAAqB;QAC7B,KAAK,CACD,YAAY,IAAI,wBAAwB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACvE,wBAAwB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CACzD,CAAC;QALmB,eAAU,GAAV,UAAU,CAAa;IAMnD,CAAC;IAEO,MAAM,CAAC,eAAe,CAAC,SAAoB;QAClD,QAAQ,SAAS,EAAE;YAClB,KAAK,sBAAS,CAAC,oBAAoB;gBAClC,OAAO,iDAAiD,CAAC;YAE1D,KAAK,sBAAS,CAAC,oBAAoB;gBAClC,OAAO,oCAAoC,CAAC;YAC7C,KAAK,sBAAS,CAAC,kBAAkB;gBAChC,OAAO,iFAAiF,CAAC;YAE1F,KAAK,sBAAS,CAAC,kBAAkB,CAAC;YAClC,KAAK,sBAAS,CAAC,kBAAkB;gBAChC,OAAO,gEAAgE,CAAC;YAEzE,KAAK,sBAAS,CAAC,WAAW;gBACzB,OAAO,gDAAgD,CAAC;YAEzD,KAAK,sBAAS,CAAC,QAAQ;gBACtB,OAAO,sBAAsB,CAAA;YAE9B,KAAK,sBAAS,CAAC,eAAe;gBAC7B,OAAO,6BAA6B,CAAA;YAE5B,KAAK,sBAAS,CAAC,YAAY,CAAC;YACrC,KAAK,sBAAS,CAAC,UAAU,CAAC;YAC1B;gBACC,OAAO,qEAAqE,CAAC;SAC9E;IACF,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,SAAoB;QACjD,OAAO,SAAS,KAAK,sBAAS,CAAC,oBAAoB;YAClD,SAAS,KAAK,sBAAS,CAAC,oBAAoB;YAC5C,SAAS,KAAK,sBAAS,CAAC,kBAAkB;YAC1C,SAAS,KAAK,sBAAS,CAAC,eAAe;YACvC,SAAS,KAAK,sBAAS,CAAC,QAAQ;YAChC,SAAS,KAAK,sBAAS,CAAC,WAAW;YACpC,CAAC,CAAC,mBAAU,CAAC,WAAW;YACxB,CAAC,CAAC,mBAAU,CAAC,qBAAqB,CAAC;IACpC,CAAC;CACD;AAjDD,4DAiDC"}
+{"version":3,"file":"google-recaptcha.exception.js","sourceRoot":"","sources":["../../src/exceptions/google-recaptcha.exception.ts"],"names":[],"mappings":";;;AAAA,2CAAyD;AACzD,oDAA8C;AAE9C,MAAa,wBAAyB,SAAQ,sBAAa;IAC1D,YAA4B,UAAuB,EACpC,YAAqB;QAC7B,KAAK,CACD,YAAY,IAAI,wBAAwB,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACvE,wBAAwB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CACzD,CAAC;QALmB,eAAU,GAAV,UAAU,CAAa;IAMnD,CAAC;IAEO,MAAM,CAAC,eAAe,CAAC,SAAoB;QAClD,QAAQ,SAAS,EAAE;YAClB,KAAK,sBAAS,CAAC,oBAAoB;gBAClC,OAAO,iDAAiD,CAAC;YAE1D,KAAK,sBAAS,CAAC,oBAAoB;gBAClC,OAAO,oCAAoC,CAAC;YAC7C,KAAK,sBAAS,CAAC,kBAAkB;gBAChC,OAAO,iFAAiF,CAAC;YAE1F,KAAK,sBAAS,CAAC,kBAAkB,CAAC;YAClC,KAAK,sBAAS,CAAC,kBAAkB;gBAChC,OAAO,gEAAgE,CAAC;YAEzE,KAAK,sBAAS,CAAC,WAAW;gBACzB,OAAO,gDAAgD,CAAC;YAEzD,KAAK,sBAAS,CAAC,QAAQ;gBACtB,OAAO,sBAAsB,CAAA;YAE9B,KAAK,sBAAS,CAAC,eAAe;gBAC7B,OAAO,6BAA6B,CAAA;YAErC,KAAK,sBAAS,CAAC,YAAY;gBAC1B,OAAO,kEAAkE,CAAC;YAE3E,KAAK,sBAAS,CAAC,YAAY;gBAC1B,OAAO,oEAAoE,CAAC;YAE7E,KAAK,sBAAS,CAAC,YAAY,CAAC;YAC5B,KAAK,sBAAS,CAAC,UAAU,CAAC;YAC1B;gBACC,OAAO,qEAAqE,CAAC;SAC9E;IACF,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,SAAoB;QACjD,OAAO,SAAS,KAAK,sBAAS,CAAC,oBAAoB;YAClD,SAAS,KAAK,sBAAS,CAAC,oBAAoB;YAC5C,SAAS,KAAK,sBAAS,CAAC,kBAAkB;YAC1C,SAAS,KAAK,sBAAS,CAAC,eAAe;YACvC,SAAS,KAAK,sBAAS,CAAC,QAAQ;YAChC,SAAS,KAAK,sBAAS,CAAC,WAAW;YACpC,CAAC,CAAC,mBAAU,CAAC,WAAW;YACxB,CAAC,CAAC,mBAAU,CAAC,qBAAqB,CAAC;IACpC,CAAC;CACD;AAvDD,4DAuDC"}

package/google-recaptcha.module.d.ts

@@ -8,5 +8,6 @@ export declare class GoogleRecaptchaModule {
     private static transformAxiosConfig;
     private static createAsyncProviders;
     private static createAsyncOptionsProvider;
+    private static validateOptions;
     private static isGoogleRecaptchaFactory;
 }

package/google-recaptcha.module.js

@@ -12,26 +12,39 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GoogleRecaptchaModule = void 0;
+const common_1 = require("@nestjs/common");
 const google_recaptcha_guard_1 = require("./guards/google-recaptcha.guard");
-const google_recaptcha_validator_1 = require("./services/google-recaptcha.validator");
+const google_recaptcha_validator_1 = require("./services/validators/google-recaptcha.validator");
+const google_recaptcha_enterprise_validator_1 = require("./services/validators/google-recaptcha-enterprise.validator");
 const provider_declarations_1 = require("./provider.declarations");
 const recaptcha_request_resolver_1 = require("./services/recaptcha-request.resolver");
 const load_module_1 = require("./helpers/load-module");
 const core_1 = require("@nestjs/core");
 const axios = require("axios");
 const https_1 = require("https");
+const recaptcha_validator_resolver_1 = require("./services/recaptcha-validator.resolver");
+const enterprise_reason_transformer_1 = require("./services/enterprise-reason.transformer");
+const xor_1 = require("./helpers/xor");
 class GoogleRecaptchaModule {
     static forRoot(options) {
         const providers = [
             core_1.Reflector,
             google_recaptcha_guard_1.GoogleRecaptchaGuard,
             google_recaptcha_validator_1.GoogleRecaptchaValidator,
+            google_recaptcha_enterprise_validator_1.GoogleRecaptchaEnterpriseValidator,
             recaptcha_request_resolver_1.RecaptchaRequestResolver,
+            recaptcha_validator_resolver_1.RecaptchaValidatorResolver,
+            enterprise_reason_transformer_1.EnterpriseReasonTransformer,
             {
                 provide: provider_declarations_1.RECAPTCHA_OPTIONS,
                 useValue: options,
             },
+            {
+                provide: provider_declarations_1.RECAPTCHA_LOGGER,
+                useFactory: () => options.logger || new common_1.Logger(),
+            },
         ];
+        this.validateOptions(options);
         const httpModule = this.resolveHttpModule();
         const internalProviders = [
             {
@@ -59,9 +72,19 @@ class GoogleRecaptchaModule {
     static forRootAsync(options) {
         const providers = [
             core_1.Reflector,
+            {
+                provide: provider_declarations_1.RECAPTCHA_LOGGER,
+                useFactory: (options) => options.logger || new common_1.Logger(),
+                inject: [
+                    provider_declarations_1.RECAPTCHA_OPTIONS,
+                ],
+            },
             google_recaptcha_guard_1.GoogleRecaptchaGuard,
             google_recaptcha_validator_1.GoogleRecaptchaValidator,
+            google_recaptcha_enterprise_validator_1.GoogleRecaptchaEnterpriseValidator,
             recaptcha_request_resolver_1.RecaptchaRequestResolver,
+            recaptcha_validator_resolver_1.RecaptchaValidatorResolver,
+            enterprise_reason_transformer_1.EnterpriseReasonTransformer,
             ...this.createAsyncProviders(options)
         ];
         const httpModule = this.resolveHttpModule();
@@ -76,6 +99,7 @@ class GoogleRecaptchaModule {
             {
                 provide: provider_declarations_1.RECAPTCHA_AXIOS_INSTANCE,
                 useFactory: (options) => {
+                    this.validateOptions(options);
                     const transformedAxiosConfig = this.transformAxiosConfig(Object.assign(Object.assign(Object.assign({}, this.axiosDefaultConfig), options.axiosConfig), { headers: null }));
                     return axios.default.create(transformedAxiosConfig);
                 },
@@ -136,6 +160,12 @@ class GoogleRecaptchaModule {
             inject: [options.useExisting || options.useClass],
         };
     }
+    static validateOptions(options) {
+        const hasEnterpriseOptions = !!Object.keys(options.enterprise || {}).length;
+        if (!(0, xor_1.xor)(!!options.secretKey, hasEnterpriseOptions)) {
+            throw new Error('Google recaptcha options must be contains "secretKey" xor "enterprise".');
+        }
+    }
     static isGoogleRecaptchaFactory(object) {
         return !!object && typeof object.createGoogleRecaptchaOptions === 'function';
     }

package/google-recaptcha.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"google-recaptcha.module.js","sourceRoot":"","sources":["../src/google-recaptcha.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"google-recaptcha.module.js","sourceRoot":"","sources":["../src/google-recaptcha.module.ts"],"names":[],"mappings":"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"}

package/guards/google-recaptcha.guard.d.ts

@@ -1,13 +1,15 @@
-import { CanActivate, ExecutionContext } from '@nestjs/common';
-import { GoogleRecaptchaValidator } from '../services/google-recaptcha.validator';
-import { GoogleRecaptchaGuardOptions } from '../interfaces/google-recaptcha-guard-options';
+import { CanActivate, ExecutionContext, Logger } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
 import { RecaptchaRequestResolver } from '../services/recaptcha-request.resolver';
+import { GoogleRecaptchaModuleOptions } from '../interfaces/google-recaptcha-module-options';
+import { RecaptchaValidatorResolver } from '../services/recaptcha-validator.resolver';
 export declare class GoogleRecaptchaGuard implements CanActivate {
-    private readonly validator;
     private readonly reflector;
     private readonly requestResolver;
+    private readonly validatorResolver;
+    private readonly logger;
     private readonly options;
-    constructor(validator: GoogleRecaptchaValidator, reflector: Reflector, requestResolver: RecaptchaRequestResolver, options: GoogleRecaptchaGuardOptions);
+    constructor(reflector: Reflector, requestResolver: RecaptchaRequestResolver, validatorResolver: RecaptchaValidatorResolver, logger: Logger, options: GoogleRecaptchaModuleOptions);
     canActivate(context: ExecutionContext): Promise<true | never>;
+    private resolveLogContext;
 }

package/guards/google-recaptcha.guard.js

@@ -14,16 +14,19 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GoogleRecaptchaGuard = void 0;
 const common_1 = require("@nestjs/common");
-const google_recaptcha_validator_1 = require("../services/google-recaptcha.validator");
 const provider_declarations_1 = require("../provider.declarations");
 const google_recaptcha_exception_1 = require("../exceptions/google-recaptcha.exception");
 const core_1 = require("@nestjs/core");
 const recaptcha_request_resolver_1 = require("../services/recaptcha-request.resolver");
+const recaptcha_validator_resolver_1 = require("../services/recaptcha-validator.resolver");
+const google_recaptcha_context_1 = require("../enums/google-recaptcha-context");
+const google_recaptcha_enterprise_validator_1 = require("../services/validators/google-recaptcha-enterprise.validator");
 let GoogleRecaptchaGuard = class GoogleRecaptchaGuard {
-    constructor(validator, reflector, requestResolver, options) {
-        this.validator = validator;
+    constructor(reflector, requestResolver, validatorResolver, logger, options) {
         this.reflector = reflector;
         this.requestResolver = requestResolver;
+        this.validatorResolver = validatorResolver;
+        this.logger = logger;
         this.options = options;
     }
     async canActivate(context) {
@@ -40,19 +43,31 @@ let GoogleRecaptchaGuard = class GoogleRecaptchaGuard {
             : await this.options.response(request);
         const score = (options === null || options === void 0 ? void 0 : options.score) || this.options.score;
         const action = options === null || options === void 0 ? void 0 : options.action;
-        request.recaptchaValidationResult = await this.validator.validate({ response, score, action });
+        const validator = this.validatorResolver.resolve();
+        request.recaptchaValidationResult = await validator.validate({ response, score, action });
+        if (this.options.debug) {
+            const loggerCtx = this.resolveLogContext(validator);
+            this.logger.debug(request.recaptchaValidationResult, `${loggerCtx}.result`);
+        }
         if (request.recaptchaValidationResult.success) {
             return true;
         }
         throw new google_recaptcha_exception_1.GoogleRecaptchaException(request.recaptchaValidationResult.errors);
     }
+    resolveLogContext(validator) {
+        return validator instanceof google_recaptcha_enterprise_validator_1.GoogleRecaptchaEnterpriseValidator
+            ? google_recaptcha_context_1.GoogleRecaptchaContext.GoogleRecaptchaEnterprise
+            : google_recaptcha_context_1.GoogleRecaptchaContext.GoogleRecaptcha;
+    }
 };
 GoogleRecaptchaGuard = __decorate([
     (0, common_1.Injectable)(),
-    __param(3, (0, common_1.Inject)(provider_declarations_1.RECAPTCHA_OPTIONS)),
-    __metadata("design:paramtypes", [google_recaptcha_validator_1.GoogleRecaptchaValidator,
-        core_1.Reflector,
-        recaptcha_request_resolver_1.RecaptchaRequestResolver, Object])
+    __param(3, (0, common_1.Inject)(provider_declarations_1.RECAPTCHA_LOGGER)),
+    __param(4, (0, common_1.Inject)(provider_declarations_1.RECAPTCHA_OPTIONS)),
+    __metadata("design:paramtypes", [core_1.Reflector,
+        recaptcha_request_resolver_1.RecaptchaRequestResolver,
+        recaptcha_validator_resolver_1.RecaptchaValidatorResolver,
+        common_1.Logger, Object])
 ], GoogleRecaptchaGuard);
 exports.GoogleRecaptchaGuard = GoogleRecaptchaGuard;
 //# sourceMappingURL=google-recaptcha.guard.js.map

package/guards/google-recaptcha.guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"google-recaptcha.guard.js","sourceRoot":"","sources":["../../src/guards/google-recaptcha.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAmF;AACnF,uFAAkF;AAElF,oEAA2F;AAC3F,yFAAoF;AACpF,uCAAyC;AACzC,uFAAkF;AAIlF,IAAa,oBAAoB,GAAjC,MAAa,oBAAoB;IAC7B,YAA6B,SAAmC,EACnC,SAAoB,EACpB,eAAyC,EACd,OAAoC;QAH/D,cAAS,GAAT,SAAS,CAA0B;QACnC,cAAS,GAAT,SAAS,CAAW;QACpB,oBAAe,GAAf,eAAe,CAA0B;QACd,YAAO,GAAP,OAAO,CAA6B;IAC5F,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAyB;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEtD,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU;YAClD,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YACpC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAE5B,IAAI,IAAI,EAAE;YACN,OAAO,IAAI,CAAC;SACf;QAED,MAAM,OAAO,GAAmC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,oDAA4B,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAEvH,MAAM,QAAQ,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;YAC9B,CAAC,CAAC,MAAM,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;YAClC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,KAAK,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,KAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAC;QAE/B,OAAO,CAAC,yBAAyB,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAC,CAAC,CAAC;QAE7F,IAAI,OAAO,CAAC,yBAAyB,CAAC,OAAO,EAAE;YAC3C,OAAO,IAAI,CAAC;SACf;QAED,MAAM,IAAI,qDAAwB,CAAC,OAAO,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACjF,CAAC;CACJ,CAAA;AAnCY,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IAKI,WAAA,IAAA,eAAM,EAAC,yCAAiB,CAAC,CAAA;qCAHE,qDAAwB;QACxB,gBAAS;QACH,qDAAwB;GAH7D,oBAAoB,CAmChC;AAnCY,oDAAoB"}
+{"version":3,"file":"google-recaptcha.guard.js","sourceRoot":"","sources":["../../src/guards/google-recaptcha.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA2F;AAC3F,oEAA6G;AAC7G,yFAAoF;AACpF,uCAAyC;AACzC,uFAAkF;AAGlF,2FAAsF;AACtF,gFAA2E;AAE3E,wHAAkH;AAGlH,IAAa,oBAAoB,GAAjC,MAAa,oBAAoB;IAC7B,YAA6B,SAAoB,EACpB,eAAyC,EACzC,iBAA6C,EACnB,MAAc,EACb,OAAqC;QAJhE,cAAS,GAAT,SAAS,CAAW;QACpB,oBAAe,GAAf,eAAe,CAA0B;QACzC,sBAAiB,GAAjB,iBAAiB,CAA4B;QACnB,WAAM,GAAN,MAAM,CAAQ;QACb,YAAO,GAAP,OAAO,CAA8B;IAC7F,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAyB;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAEtD,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU;YAClD,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YACpC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAE5B,IAAI,IAAI,EAAE;YACN,OAAO,IAAI,CAAC;SACf;QAED,MAAM,OAAO,GAAmC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,oDAA4B,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAEvH,MAAM,QAAQ,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;YAC9B,CAAC,CAAC,MAAM,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;YAClC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,KAAK,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,KAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACnD,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAC;QAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QAEnD,OAAO,CAAC,yBAAyB,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,EAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAC,CAAC,CAAC;QAExF,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;YACpB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,yBAAyB,EAAE,GAAG,SAAS,SAAS,CAAC,CAAC;SAC/E;QAED,IAAI,OAAO,CAAC,yBAAyB,CAAC,OAAO,EAAE;YAC3C,OAAO,IAAI,CAAC;SACf;QAED,MAAM,IAAI,qDAAwB,CAAC,OAAO,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACjF,CAAC;IAEO,iBAAiB,CAAC,SAA2C;QACjE,OAAO,SAAS,YAAY,0EAAkC;YAC1D,CAAC,CAAC,iDAAsB,CAAC,yBAAyB;YAClD,CAAC,CAAC,iDAAsB,CAAC,eAAe,CAAC;IACjD,CAAC;CACJ,CAAA;AAjDY,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IAKI,WAAA,IAAA,eAAM,EAAC,wCAAgB,CAAC,CAAA;IACxB,WAAA,IAAA,eAAM,EAAC,yCAAiB,CAAC,CAAA;qCAJE,gBAAS;QACH,qDAAwB;QACtB,yDAA0B;QACX,eAAM;GAJ5D,oBAAoB,CAiDhC;AAjDY,oDAAoB"}

package/helpers/xor.d.ts

@@ -0,0 +1 @@
+export declare function xor(a: boolean, b: boolean): boolean;

package/helpers/xor.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.xor = void 0;
+function xor(a, b) {
+    return !!a !== !!b;
+}
+exports.xor = xor;
+//# sourceMappingURL=xor.js.map

package/helpers/xor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.js","sourceRoot":"","sources":["../../src/helpers/xor.ts"],"names":[],"mappings":";;;AAAA,SAAgB,GAAG,CAAC,CAAU,EAAE,CAAU;IACtC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAFD,kBAEC"}

package/index.d.ts

@@ -5,7 +5,10 @@ export { GoogleRecaptchaGuard } from './guards/google-recaptcha.guard';
 export { GoogleRecaptchaModule } from './google-recaptcha.module';
 export { GoogleRecaptchaModuleOptions } from './interfaces/google-recaptcha-module-options';
 export { ErrorCode } from './enums/error-code';
-export { ApplicationType } from './enums/application-type';
 export { GoogleRecaptchaNetwork } from './enums/google-recaptcha-network';
 export { GoogleRecaptchaException } from './exceptions/google-recaptcha.exception';
 export { GoogleRecaptchaNetworkException } from './exceptions/google-recaptcha-network.exception';
+export { GoogleRecaptchaValidator } from './services/validators/google-recaptcha.validator';
+export { GoogleRecaptchaEnterpriseValidator } from './services/validators/google-recaptcha-enterprise.validator';
+export { RecaptchaVerificationResult } from './models/recaptcha-verification-result';
+export { ClassificationReason } from './enums/classification-reason';

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GoogleRecaptchaNetworkException = exports.GoogleRecaptchaException = exports.GoogleRecaptchaNetwork = exports.ApplicationType = exports.ErrorCode = exports.GoogleRecaptchaModule = exports.GoogleRecaptchaGuard = exports.RecaptchaResult = exports.SetRecaptchaOptions = exports.Recaptcha = void 0;
+exports.ClassificationReason = exports.RecaptchaVerificationResult = exports.GoogleRecaptchaEnterpriseValidator = exports.GoogleRecaptchaValidator = exports.GoogleRecaptchaNetworkException = exports.GoogleRecaptchaException = exports.GoogleRecaptchaNetwork = exports.ErrorCode = exports.GoogleRecaptchaModule = exports.GoogleRecaptchaGuard = exports.RecaptchaResult = exports.SetRecaptchaOptions = exports.Recaptcha = void 0;
 var recaptcha_1 = require("./decorators/recaptcha");
 Object.defineProperty(exports, "Recaptcha", { enumerable: true, get: function () { return recaptcha_1.Recaptcha; } });
 var set_recaptcha_options_1 = require("./decorators/set-recaptcha-options");
@@ -13,12 +13,18 @@ var google_recaptcha_module_1 = require("./google-recaptcha.module");
 Object.defineProperty(exports, "GoogleRecaptchaModule", { enumerable: true, get: function () { return google_recaptcha_module_1.GoogleRecaptchaModule; } });
 var error_code_1 = require("./enums/error-code");
 Object.defineProperty(exports, "ErrorCode", { enumerable: true, get: function () { return error_code_1.ErrorCode; } });
-var application_type_1 = require("./enums/application-type");
-Object.defineProperty(exports, "ApplicationType", { enumerable: true, get: function () { return application_type_1.ApplicationType; } });
 var google_recaptcha_network_1 = require("./enums/google-recaptcha-network");
 Object.defineProperty(exports, "GoogleRecaptchaNetwork", { enumerable: true, get: function () { return google_recaptcha_network_1.GoogleRecaptchaNetwork; } });
 var google_recaptcha_exception_1 = require("./exceptions/google-recaptcha.exception");
 Object.defineProperty(exports, "GoogleRecaptchaException", { enumerable: true, get: function () { return google_recaptcha_exception_1.GoogleRecaptchaException; } });
 var google_recaptcha_network_exception_1 = require("./exceptions/google-recaptcha-network.exception");
 Object.defineProperty(exports, "GoogleRecaptchaNetworkException", { enumerable: true, get: function () { return google_recaptcha_network_exception_1.GoogleRecaptchaNetworkException; } });
+var google_recaptcha_validator_1 = require("./services/validators/google-recaptcha.validator");
+Object.defineProperty(exports, "GoogleRecaptchaValidator", { enumerable: true, get: function () { return google_recaptcha_validator_1.GoogleRecaptchaValidator; } });
+var google_recaptcha_enterprise_validator_1 = require("./services/validators/google-recaptcha-enterprise.validator");
+Object.defineProperty(exports, "GoogleRecaptchaEnterpriseValidator", { enumerable: true, get: function () { return google_recaptcha_enterprise_validator_1.GoogleRecaptchaEnterpriseValidator; } });
+var recaptcha_verification_result_1 = require("./models/recaptcha-verification-result");
+Object.defineProperty(exports, "RecaptchaVerificationResult", { enumerable: true, get: function () { return recaptcha_verification_result_1.RecaptchaVerificationResult; } });
+var classification_reason_1 = require("./enums/classification-reason");
+Object.defineProperty(exports, "ClassificationReason", { enumerable: true, get: function () { return classification_reason_1.ClassificationReason; } });
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAAmD;AAA1C,sGAAA,SAAS,OAAA;AAClB,4EAAyE;AAAhE,4HAAA,mBAAmB,OAAA;AAC5B,kEAAgE;AAAvD,mHAAA,eAAe,OAAA;AACxB,0EAAuE;AAA9D,8HAAA,oBAAoB,OAAA;AAC7B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAE9B,iDAA+C;AAAtC,uGAAA,SAAS,OAAA;AAClB,6DAA2D;AAAlD,mHAAA,eAAe,OAAA;AACxB,6EAAyE;AAAhE,kIAAA,sBAAsB,OAAA;AAC/B,sFAAmF;AAA1E,sIAAA,wBAAwB,OAAA;AACjC,sGAAkG;AAAzF,qJAAA,+BAA+B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAAmD;AAA1C,sGAAA,SAAS,OAAA;AAClB,4EAAyE;AAAhE,4HAAA,mBAAmB,OAAA;AAC5B,kEAAgE;AAAvD,mHAAA,eAAe,OAAA;AACxB,0EAAuE;AAA9D,8HAAA,oBAAoB,OAAA;AAC7B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAE9B,iDAA+C;AAAtC,uGAAA,SAAS,OAAA;AAClB,6EAAyE;AAAhE,kIAAA,sBAAsB,OAAA;AAC/B,sFAAmF;AAA1E,sIAAA,wBAAwB,OAAA;AACjC,sGAAkG;AAAzF,qJAAA,+BAA+B,OAAA;AACxC,+FAA2F;AAAlF,sIAAA,wBAAwB,OAAA;AACjC,qHAAgH;AAAvG,2JAAA,kCAAkC,OAAA;AAC3C,wFAAqF;AAA5E,4IAAA,2BAA2B,OAAA;AACpC,uEAAqE;AAA5D,6HAAA,oBAAoB,OAAA"}

package/interfaces/google-recaptcha-enterprise-options.d.ts

@@ -0,0 +1,5 @@
+export interface GoogleRecaptchaEnterpriseOptions {
+    projectId: string;
+    siteKey: string;
+    apiKey: string;
+}

package/interfaces/google-recaptcha-enterprise-options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=google-recaptcha-enterprise-options.js.map

package/interfaces/google-recaptcha-enterprise-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-recaptcha-enterprise-options.js","sourceRoot":"","sources":["../../src/interfaces/google-recaptcha-enterprise-options.ts"],"names":[],"mappings":""}

package/interfaces/google-recaptcha-module-options.d.ts

@@ -1,7 +1,10 @@
 import { GoogleRecaptchaGuardOptions } from './google-recaptcha-guard-options';
 import { GoogleRecaptchaValidatorOptions } from './google-recaptcha-validator-options';
 import { ModuleMetadata, Type } from '@nestjs/common/interfaces';
+import { Logger } from '@nestjs/common';
 export interface GoogleRecaptchaModuleOptions extends GoogleRecaptchaValidatorOptions, GoogleRecaptchaGuardOptions {
+    debug?: boolean;
+    logger?: Logger;
 }
 export interface GoogleRecaptchaOptionsFactory {
     createGoogleRecaptchaOptions(): Promise<GoogleRecaptchaModuleOptions> | GoogleRecaptchaModuleOptions;

package/interfaces/google-recaptcha-validator-options.d.ts

@@ -1,8 +1,9 @@
 import { GoogleRecaptchaNetwork } from '../enums/google-recaptcha-network';
 import { ScoreValidator } from '../types';
 import { AxiosRequestConfig } from 'axios';
+import { GoogleRecaptchaEnterpriseOptions } from './google-recaptcha-enterprise-options';
 export interface GoogleRecaptchaValidatorOptions {
-    secretKey: string;
+    secretKey?: string;
     actions?: string[];
     score?: ScoreValidator;
     /**
@@ -13,4 +14,5 @@ export interface GoogleRecaptchaValidatorOptions {
      */
     network?: GoogleRecaptchaNetwork | string;
     axiosConfig?: AxiosRequestConfig;
+    enterprise?: GoogleRecaptchaEnterpriseOptions;
 }

package/interfaces/verify-response-enterprise.d.ts

@@ -0,0 +1,29 @@
+import { GoogleRecaptchaEnterpriseReason } from '../enums/google-recaptcha-enterprise-reason';
+import { ClassificationReason } from '../enums/classification-reason';
+export interface VerifyResponseEnterprise {
+    tokenProperties: VerifyResponseEnterpriseTokenProperties;
+    riskAnalysis: VerifyResponseEnterpriseRiskAnalysis;
+    event: VerifyTokenEnterpriseResponseEvent;
+    name: string;
+}
+export interface VerifyTokenEnterpriseEvent {
+    token: string;
+    siteKey: string;
+    expectedAction: string;
+}
+export interface VerifyTokenEnterpriseResponseEvent extends VerifyTokenEnterpriseEvent {
+    userAgent: string;
+    userIpAddress: string;
+    hashedAccountId: string;
+}
+export interface VerifyResponseEnterpriseTokenProperties {
+    valid: boolean;
+    invalidReason?: GoogleRecaptchaEnterpriseReason;
+    hostname: string;
+    action: string;
+    createTime: string;
+}
+export interface VerifyResponseEnterpriseRiskAnalysis {
+    score: number;
+    reasons: ClassificationReason[];
+}

package/interfaces/{google-recaptcha-validation-result.js → verify-response-enterprise.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=google-recaptcha-validation-result.js.map
+//# sourceMappingURL=verify-response-enterprise.js.map

package/interfaces/verify-response-enterprise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-response-enterprise.js","sourceRoot":"","sources":["../../src/interfaces/verify-response-enterprise.ts"],"names":[],"mappings":""}

package/models/recaptcha-verification-result.d.ts

@@ -1,7 +1,22 @@
-import { GoogleRecaptchaValidationResult } from '../interfaces/google-recaptcha-validation-result';
-export declare class RecaptchaVerificationResult {
-    readonly action: string;
-    readonly score: number;
+import { ErrorCode } from '../enums/error-code';
+import { VerifyResponseEnterprise } from '../interfaces/verify-response-enterprise';
+export interface RecaptchaVerificationResultOptions<Res = any> {
+    success: boolean;
+    nativeResponse: Res;
+    hostname: string;
+    action?: string;
+    score?: number;
+    errors: ErrorCode[];
+}
+export declare class RecaptchaVerificationResult<Res = any> {
+    private readonly options;
+    readonly success: boolean;
     readonly hostname: string;
-    constructor(result: GoogleRecaptchaValidationResult);
+    readonly action: string | undefined;
+    readonly score: number | undefined;
+    readonly nativeResponse: Res;
+    readonly errors: ErrorCode[];
+    constructor(options: RecaptchaVerificationResultOptions);
+    getResponse(): Res;
+    getEnterpriseRiskAnalytics(): VerifyResponseEnterprise | null;
 }