@friendlycaptcha/server-sdk 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/workflows/ci.yml +47 -0
- package/.github/workflows/publish.yml +18 -0
- package/.prettierrc +3 -0
- package/CHANGELOG.md +5 -0
- package/LICENSE +21 -0
- package/README.md +47 -0
- package/dist/api/errors.d.ts +54 -0
- package/dist/api/errors.js +64 -0
- package/dist/api/errors.js.map +1 -0
- package/dist/api/index.d.ts +1 -0
- package/dist/api/index.js +2 -0
- package/dist/api/index.js.map +1 -0
- package/dist/api/types.d.ts +59 -0
- package/dist/api/types.js +2 -0
- package/dist/api/types.js.map +1 -0
- package/dist/client/client.d.ts +53 -0
- package/dist/client/client.js +100 -0
- package/dist/client/client.js.map +1 -0
- package/dist/client/errors.d.ts +37 -0
- package/dist/client/errors.js +34 -0
- package/dist/client/errors.js.map +1 -0
- package/dist/client/index.d.ts +3 -0
- package/dist/client/index.js +4 -0
- package/dist/client/index.js.map +1 -0
- package/dist/client/result.d.ts +67 -0
- package/dist/client/result.js +125 -0
- package/dist/client/result.js.map +1 -0
- package/dist/client/version.gen.d.ts +1 -0
- package/dist/client/version.gen.js +4 -0
- package/dist/client/version.gen.js.map +1 -0
- package/dist/index.d.ts +292 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -0
- package/dist/tsdoc-metadata.json +11 -0
- package/docs/index.md +12 -0
- package/docs/server-sdk.failed_due_to_client_error_code.md +15 -0
- package/docs/server-sdk.failed_to_decode_response_error_code.md +13 -0
- package/docs/server-sdk.failed_to_encode_error_code.md +13 -0
- package/docs/server-sdk.friendlycaptchaclient._constructor_.md +20 -0
- package/docs/server-sdk.friendlycaptchaclient.md +26 -0
- package/docs/server-sdk.friendlycaptchaclient.verifycaptcharesponse.md +30 -0
- package/docs/server-sdk.friendlycaptchaoptions.apikey.md +13 -0
- package/docs/server-sdk.friendlycaptchaoptions.fetch.md +13 -0
- package/docs/server-sdk.friendlycaptchaoptions.md +24 -0
- package/docs/server-sdk.friendlycaptchaoptions.sitekey.md +11 -0
- package/docs/server-sdk.friendlycaptchaoptions.siteverifyendpoint.md +15 -0
- package/docs/server-sdk.friendlycaptchaoptions.strict.md +15 -0
- package/docs/server-sdk.md +41 -0
- package/docs/server-sdk.request_failed_error_code.md +13 -0
- package/docs/server-sdk.request_failed_timeout_error_code.md +13 -0
- package/docs/server-sdk.siteverifyerrorresponse.error.md +11 -0
- package/docs/server-sdk.siteverifyerrorresponse.md +20 -0
- package/docs/server-sdk.siteverifyerrorresponse.success.md +11 -0
- package/docs/server-sdk.siteverifyerrorresponseerrordata.detail.md +11 -0
- package/docs/server-sdk.siteverifyerrorresponseerrordata.error_code.md +11 -0
- package/docs/server-sdk.siteverifyerrorresponseerrordata.md +20 -0
- package/docs/server-sdk.siteverifyresponse.md +14 -0
- package/docs/server-sdk.siteverifyresponsechallengedata.md +20 -0
- package/docs/server-sdk.siteverifyresponsechallengedata.origin.md +13 -0
- package/docs/server-sdk.siteverifyresponsechallengedata.timestamp.md +13 -0
- package/docs/server-sdk.siteverifyresponsedata.challenge.md +11 -0
- package/docs/server-sdk.siteverifyresponsedata.md +19 -0
- package/docs/server-sdk.siteverifysuccessresponse.data.md +11 -0
- package/docs/server-sdk.siteverifysuccessresponse.md +20 -0
- package/docs/server-sdk.siteverifysuccessresponse.success.md +11 -0
- package/docs/server-sdk.verifyclienterrorcode.md +14 -0
- package/docs/server-sdk.verifyresult._constructor_.md +20 -0
- package/docs/server-sdk.verifyresult.clienterrortype.md +11 -0
- package/docs/server-sdk.verifyresult.geterrorcode.md +15 -0
- package/docs/server-sdk.verifyresult.getresponse.md +17 -0
- package/docs/server-sdk.verifyresult.getresponseerror.md +17 -0
- package/docs/server-sdk.verifyresult.isclienterror.md +19 -0
- package/docs/server-sdk.verifyresult.isdecodeerror.md +17 -0
- package/docs/server-sdk.verifyresult.isencodeerror.md +17 -0
- package/docs/server-sdk.verifyresult.isrequestortimeouterror.md +17 -0
- package/docs/server-sdk.verifyresult.isstrict.md +17 -0
- package/docs/server-sdk.verifyresult.md +44 -0
- package/docs/server-sdk.verifyresult.response.md +13 -0
- package/docs/server-sdk.verifyresult.shouldaccept.md +17 -0
- package/docs/server-sdk.verifyresult.shouldreject.md +17 -0
- package/docs/server-sdk.verifyresult.status.md +13 -0
- package/docs/server-sdk.verifyresult.wasabletoverify.md +17 -0
- package/package.json +44 -0
- package/src/api/errors.ts +77 -0
- package/src/api/index.ts +1 -0
- package/src/api/types.ts +66 -0
- package/src/client/client.ts +154 -0
- package/src/client/errors.ts +42 -0
- package/src/client/index.ts +3 -0
- package/src/client/result.ts +151 -0
- package/src/client/version.gen.ts +3 -0
- package/src/index.ts +2 -0
- package/test/client/client.test.ts +48 -0
- package/test/client/mock.test.ts +44 -0
- package/tsconfig.json +20 -0
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [FriendlyCaptchaOptions](./server-sdk.friendlycaptchaoptions.md) > [strict](./server-sdk.friendlycaptchaoptions.strict.md)
|
|
4
|
+
|
|
5
|
+
## FriendlyCaptchaOptions.strict property
|
|
6
|
+
|
|
7
|
+
Whether to use strict mode, which rejects all captcha responses which were not strictly verified.
|
|
8
|
+
|
|
9
|
+
This is not recommended. Defaults to `false`<!-- -->.
|
|
10
|
+
|
|
11
|
+
**Signature:**
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
strict?: boolean;
|
|
15
|
+
```
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md)
|
|
4
|
+
|
|
5
|
+
## server-sdk package
|
|
6
|
+
|
|
7
|
+
## Classes
|
|
8
|
+
|
|
9
|
+
| Class | Description |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| [FriendlyCaptchaClient](./server-sdk.friendlycaptchaclient.md) | A client for the Friendly Captcha API. |
|
|
12
|
+
| [VerifyResult](./server-sdk.verifyresult.md) | The result of a captcha siteverify request. |
|
|
13
|
+
|
|
14
|
+
## Interfaces
|
|
15
|
+
|
|
16
|
+
| Interface | Description |
|
|
17
|
+
| --- | --- |
|
|
18
|
+
| [FriendlyCaptchaOptions](./server-sdk.friendlycaptchaoptions.md) | Configuration options when creating a new <code>FriendlyCaptchaClient</code>. |
|
|
19
|
+
| [SiteverifyErrorResponse](./server-sdk.siteverifyerrorresponse.md) | |
|
|
20
|
+
| [SiteverifyErrorResponseErrorData](./server-sdk.siteverifyerrorresponseerrordata.md) | |
|
|
21
|
+
| [SiteverifyResponseChallengeData](./server-sdk.siteverifyresponsechallengedata.md) | |
|
|
22
|
+
| [SiteverifyResponseData](./server-sdk.siteverifyresponsedata.md) | |
|
|
23
|
+
| [SiteverifySuccessResponse](./server-sdk.siteverifysuccessresponse.md) | |
|
|
24
|
+
|
|
25
|
+
## Variables
|
|
26
|
+
|
|
27
|
+
| Variable | Description |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| [FAILED\_DUE\_TO\_CLIENT\_ERROR\_CODE](./server-sdk.failed_due_to_client_error_code.md) | <p>An error occured on the client side that could've been prevented. This generally means your configuration is wrong.</p><p>Check your API key and sitekey.</p> |
|
|
30
|
+
| [FAILED\_TO\_DECODE\_RESPONSE\_ERROR\_CODE](./server-sdk.failed_to_decode_response_error_code.md) | The response from the Friendly Captcha API could not be decoded. |
|
|
31
|
+
| [FAILED\_TO\_ENCODE\_ERROR\_CODE](./server-sdk.failed_to_encode_error_code.md) | Failed to encode the captcha response. This means the captcha response was invalid and should never be accepted. |
|
|
32
|
+
| [REQUEST\_FAILED\_ERROR\_CODE](./server-sdk.request_failed_error_code.md) | The request couldn't be made, perhaps there is a network outage, DNS issue, or the API is unreachable. |
|
|
33
|
+
| [REQUEST\_FAILED\_TIMEOUT\_ERROR\_CODE](./server-sdk.request_failed_timeout_error_code.md) | The request couldn't be made, perhaps there is a network outage, DNS issue, or the API is unreachable. |
|
|
34
|
+
|
|
35
|
+
## Type Aliases
|
|
36
|
+
|
|
37
|
+
| Type Alias | Description |
|
|
38
|
+
| --- | --- |
|
|
39
|
+
| [SiteverifyResponse](./server-sdk.siteverifyresponse.md) | |
|
|
40
|
+
| [VerifyClientErrorCode](./server-sdk.verifyclienterrorcode.md) | |
|
|
41
|
+
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [REQUEST\_FAILED\_ERROR\_CODE](./server-sdk.request_failed_error_code.md)
|
|
4
|
+
|
|
5
|
+
## REQUEST\_FAILED\_ERROR\_CODE variable
|
|
6
|
+
|
|
7
|
+
The request couldn't be made, perhaps there is a network outage, DNS issue, or the API is unreachable.
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
REQUEST_FAILED_ERROR_CODE = "request_failed"
|
|
13
|
+
```
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [REQUEST\_FAILED\_TIMEOUT\_ERROR\_CODE](./server-sdk.request_failed_timeout_error_code.md)
|
|
4
|
+
|
|
5
|
+
## REQUEST\_FAILED\_TIMEOUT\_ERROR\_CODE variable
|
|
6
|
+
|
|
7
|
+
The request couldn't be made, perhaps there is a network outage, DNS issue, or the API is unreachable.
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
REQUEST_FAILED_TIMEOUT_ERROR_CODE = "request_failed_due_to_timeout"
|
|
13
|
+
```
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyErrorResponse](./server-sdk.siteverifyerrorresponse.md) > [error](./server-sdk.siteverifyerrorresponse.error.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyErrorResponse.error property
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
error: SiteverifyErrorResponseErrorData;
|
|
11
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyErrorResponse](./server-sdk.siteverifyerrorresponse.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyErrorResponse interface
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
**Signature:**
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
export interface SiteverifyErrorResponse
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Properties
|
|
15
|
+
|
|
16
|
+
| Property | Modifiers | Type | Description |
|
|
17
|
+
| --- | --- | --- | --- |
|
|
18
|
+
| [error](./server-sdk.siteverifyerrorresponse.error.md) | | [SiteverifyErrorResponseErrorData](./server-sdk.siteverifyerrorresponseerrordata.md) | |
|
|
19
|
+
| [success](./server-sdk.siteverifyerrorresponse.success.md) | | false | |
|
|
20
|
+
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyErrorResponse](./server-sdk.siteverifyerrorresponse.md) > [success](./server-sdk.siteverifyerrorresponse.success.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyErrorResponse.success property
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
success: false;
|
|
11
|
+
```
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyErrorResponseErrorData](./server-sdk.siteverifyerrorresponseerrordata.md) > [detail](./server-sdk.siteverifyerrorresponseerrordata.detail.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyErrorResponseErrorData.detail property
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
detail: string;
|
|
11
|
+
```
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyErrorResponseErrorData](./server-sdk.siteverifyerrorresponseerrordata.md) > [error\_code](./server-sdk.siteverifyerrorresponseerrordata.error_code.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyErrorResponseErrorData.error\_code property
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
error_code: SiteverifyErrorCode;
|
|
11
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyErrorResponseErrorData](./server-sdk.siteverifyerrorresponseerrordata.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyErrorResponseErrorData interface
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
**Signature:**
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
export interface SiteverifyErrorResponseErrorData
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Properties
|
|
15
|
+
|
|
16
|
+
| Property | Modifiers | Type | Description |
|
|
17
|
+
| --- | --- | --- | --- |
|
|
18
|
+
| [detail](./server-sdk.siteverifyerrorresponseerrordata.detail.md) | | string | |
|
|
19
|
+
| [error\_code](./server-sdk.siteverifyerrorresponseerrordata.error_code.md) | | SiteverifyErrorCode | |
|
|
20
|
+
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyResponse](./server-sdk.siteverifyresponse.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyResponse type
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
**Signature:**
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
export type SiteverifyResponse = SiteverifySuccessResponse | SiteverifyErrorResponse;
|
|
12
|
+
```
|
|
13
|
+
**References:** [SiteverifySuccessResponse](./server-sdk.siteverifysuccessresponse.md)<!-- -->, [SiteverifyErrorResponse](./server-sdk.siteverifyerrorresponse.md)
|
|
14
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyResponseChallengeData](./server-sdk.siteverifyresponsechallengedata.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyResponseChallengeData interface
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
**Signature:**
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
export interface SiteverifyResponseChallengeData
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Properties
|
|
15
|
+
|
|
16
|
+
| Property | Modifiers | Type | Description |
|
|
17
|
+
| --- | --- | --- | --- |
|
|
18
|
+
| [origin](./server-sdk.siteverifyresponsechallengedata.origin.md) | | string | The origin of the site where the captcha was solved (if known, can be empty string if not known). |
|
|
19
|
+
| [timestamp](./server-sdk.siteverifyresponsechallengedata.timestamp.md) | | string | Timestamp when the captcha challenge was completed (RFC3339). |
|
|
20
|
+
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyResponseChallengeData](./server-sdk.siteverifyresponsechallengedata.md) > [origin](./server-sdk.siteverifyresponsechallengedata.origin.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyResponseChallengeData.origin property
|
|
6
|
+
|
|
7
|
+
The origin of the site where the captcha was solved (if known, can be empty string if not known).
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
origin: string;
|
|
13
|
+
```
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyResponseChallengeData](./server-sdk.siteverifyresponsechallengedata.md) > [timestamp](./server-sdk.siteverifyresponsechallengedata.timestamp.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyResponseChallengeData.timestamp property
|
|
6
|
+
|
|
7
|
+
Timestamp when the captcha challenge was completed (RFC3339).
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
timestamp: string;
|
|
13
|
+
```
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyResponseData](./server-sdk.siteverifyresponsedata.md) > [challenge](./server-sdk.siteverifyresponsedata.challenge.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyResponseData.challenge property
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
challenge: SiteverifyResponseChallengeData;
|
|
11
|
+
```
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifyResponseData](./server-sdk.siteverifyresponsedata.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifyResponseData interface
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
**Signature:**
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
export interface SiteverifyResponseData
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Properties
|
|
15
|
+
|
|
16
|
+
| Property | Modifiers | Type | Description |
|
|
17
|
+
| --- | --- | --- | --- |
|
|
18
|
+
| [challenge](./server-sdk.siteverifyresponsedata.challenge.md) | | [SiteverifyResponseChallengeData](./server-sdk.siteverifyresponsechallengedata.md) | |
|
|
19
|
+
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifySuccessResponse](./server-sdk.siteverifysuccessresponse.md) > [data](./server-sdk.siteverifysuccessresponse.data.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifySuccessResponse.data property
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
data: SiteverifyResponseData;
|
|
11
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifySuccessResponse](./server-sdk.siteverifysuccessresponse.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifySuccessResponse interface
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
**Signature:**
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
export interface SiteverifySuccessResponse
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
## Properties
|
|
15
|
+
|
|
16
|
+
| Property | Modifiers | Type | Description |
|
|
17
|
+
| --- | --- | --- | --- |
|
|
18
|
+
| [data](./server-sdk.siteverifysuccessresponse.data.md) | | [SiteverifyResponseData](./server-sdk.siteverifyresponsedata.md) | |
|
|
19
|
+
| [success](./server-sdk.siteverifysuccessresponse.success.md) | | true | |
|
|
20
|
+
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [SiteverifySuccessResponse](./server-sdk.siteverifysuccessresponse.md) > [success](./server-sdk.siteverifysuccessresponse.success.md)
|
|
4
|
+
|
|
5
|
+
## SiteverifySuccessResponse.success property
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
success: true;
|
|
11
|
+
```
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyClientErrorCode](./server-sdk.verifyclienterrorcode.md)
|
|
4
|
+
|
|
5
|
+
## VerifyClientErrorCode type
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
**Signature:**
|
|
9
|
+
|
|
10
|
+
```typescript
|
|
11
|
+
export type VerifyClientErrorCode = typeof FAILED_TO_ENCODE_ERROR_CODE | typeof REQUEST_FAILED_ERROR_CODE | typeof REQUEST_FAILED_TIMEOUT_ERROR_CODE | typeof FAILED_DUE_TO_CLIENT_ERROR_CODE | typeof FAILED_TO_DECODE_RESPONSE_ERROR_CODE;
|
|
12
|
+
```
|
|
13
|
+
**References:** [FAILED\_TO\_ENCODE\_ERROR\_CODE](./server-sdk.failed_to_encode_error_code.md)<!-- -->, [REQUEST\_FAILED\_ERROR\_CODE](./server-sdk.request_failed_error_code.md)<!-- -->, [REQUEST\_FAILED\_TIMEOUT\_ERROR\_CODE](./server-sdk.request_failed_timeout_error_code.md)<!-- -->, [FAILED\_DUE\_TO\_CLIENT\_ERROR\_CODE](./server-sdk.failed_due_to_client_error_code.md)<!-- -->, [FAILED\_TO\_DECODE\_RESPONSE\_ERROR\_CODE](./server-sdk.failed_to_decode_response_error_code.md)
|
|
14
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [(constructor)](./server-sdk.verifyresult._constructor_.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.(constructor)
|
|
6
|
+
|
|
7
|
+
Constructs a new instance of the `VerifyResult` class
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
constructor(strict: boolean);
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Parameters
|
|
16
|
+
|
|
17
|
+
| Parameter | Type | Description |
|
|
18
|
+
| --- | --- | --- |
|
|
19
|
+
| strict | boolean | |
|
|
20
|
+
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [clientErrorType](./server-sdk.verifyresult.clienterrortype.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.clientErrorType property
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
clientErrorType: VerifyClientErrorCode | null;
|
|
11
|
+
```
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [getErrorCode](./server-sdk.verifyresult.geterrorcode.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.getErrorCode() method
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
getErrorCode(): VerifyClientErrorCode | null;
|
|
11
|
+
```
|
|
12
|
+
**Returns:**
|
|
13
|
+
|
|
14
|
+
[VerifyClientErrorCode](./server-sdk.verifyclienterrorcode.md) \| null
|
|
15
|
+
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [getResponse](./server-sdk.verifyresult.getresponse.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.getResponse() method
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
getResponse(): SiteverifyResponse | null;
|
|
11
|
+
```
|
|
12
|
+
**Returns:**
|
|
13
|
+
|
|
14
|
+
[SiteverifyResponse](./server-sdk.siteverifyresponse.md) \| null
|
|
15
|
+
|
|
16
|
+
The response from the Friendly Captcha API, or null if the request was not made at all.
|
|
17
|
+
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [getResponseError](./server-sdk.verifyresult.getresponseerror.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.getResponseError() method
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
getResponseError(): SiteverifyErrorResponseErrorData | null;
|
|
11
|
+
```
|
|
12
|
+
**Returns:**
|
|
13
|
+
|
|
14
|
+
[SiteverifyErrorResponseErrorData](./server-sdk.siteverifyerrorresponseerrordata.md) \| null
|
|
15
|
+
|
|
16
|
+
The `error` field form the response, or null if it is not present.
|
|
17
|
+
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [isClientError](./server-sdk.verifyresult.isclienterror.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.isClientError() method
|
|
6
|
+
|
|
7
|
+
Something went wrong on the client side, this generally means your configuration is wrong. Check your secrets (API key) and sitekey.
|
|
8
|
+
|
|
9
|
+
See `getResponseError()` for more information.
|
|
10
|
+
|
|
11
|
+
**Signature:**
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
isClientError(): boolean;
|
|
15
|
+
```
|
|
16
|
+
**Returns:**
|
|
17
|
+
|
|
18
|
+
boolean
|
|
19
|
+
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [isDecodeError](./server-sdk.verifyresult.isdecodeerror.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.isDecodeError() method
|
|
6
|
+
|
|
7
|
+
Something went wrong decoding the response from the Friendly Captcha API.
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
isDecodeError(): boolean;
|
|
13
|
+
```
|
|
14
|
+
**Returns:**
|
|
15
|
+
|
|
16
|
+
boolean
|
|
17
|
+
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [isEncodeError](./server-sdk.verifyresult.isencodeerror.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.isEncodeError() method
|
|
6
|
+
|
|
7
|
+
Was unable to encode the captcha response. This means the captcha response was invalid and should never be accepted.
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
isEncodeError(): boolean;
|
|
13
|
+
```
|
|
14
|
+
**Returns:**
|
|
15
|
+
|
|
16
|
+
boolean
|
|
17
|
+
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [isRequestOrTimeoutError](./server-sdk.verifyresult.isrequestortimeouterror.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.isRequestOrTimeoutError() method
|
|
6
|
+
|
|
7
|
+
Something went wrong making the request to the Friendly Captcha API, perhaps there is a network connection issue?
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
isRequestOrTimeoutError(): boolean;
|
|
13
|
+
```
|
|
14
|
+
**Returns:**
|
|
15
|
+
|
|
16
|
+
boolean
|
|
17
|
+
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [isStrict](./server-sdk.verifyresult.isstrict.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.isStrict() method
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
isStrict(): boolean;
|
|
11
|
+
```
|
|
12
|
+
**Returns:**
|
|
13
|
+
|
|
14
|
+
boolean
|
|
15
|
+
|
|
16
|
+
Whether strict mode was enabled for this verification.
|
|
17
|
+
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult class
|
|
6
|
+
|
|
7
|
+
The result of a captcha siteverify request.
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
export declare class VerifyResult
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Constructors
|
|
16
|
+
|
|
17
|
+
| Constructor | Modifiers | Description |
|
|
18
|
+
| --- | --- | --- |
|
|
19
|
+
| [(constructor)(strict)](./server-sdk.verifyresult._constructor_.md) | | Constructs a new instance of the <code>VerifyResult</code> class |
|
|
20
|
+
|
|
21
|
+
## Properties
|
|
22
|
+
|
|
23
|
+
| Property | Modifiers | Type | Description |
|
|
24
|
+
| --- | --- | --- | --- |
|
|
25
|
+
| [clientErrorType](./server-sdk.verifyresult.clienterrortype.md) | | [VerifyClientErrorCode](./server-sdk.verifyclienterrorcode.md) \| null | |
|
|
26
|
+
| [response](./server-sdk.verifyresult.response.md) | | [SiteverifyResponse](./server-sdk.siteverifyresponse.md) \| null | The response from the Friendly Captcha API, or null if the request was not made at all. |
|
|
27
|
+
| [status](./server-sdk.verifyresult.status.md) | | number | The HTTP status code of the response. <code>-1</code> if there was no response. |
|
|
28
|
+
|
|
29
|
+
## Methods
|
|
30
|
+
|
|
31
|
+
| Method | Modifiers | Description |
|
|
32
|
+
| --- | --- | --- |
|
|
33
|
+
| [getErrorCode()](./server-sdk.verifyresult.geterrorcode.md) | | |
|
|
34
|
+
| [getResponse()](./server-sdk.verifyresult.getresponse.md) | | |
|
|
35
|
+
| [getResponseError()](./server-sdk.verifyresult.getresponseerror.md) | | |
|
|
36
|
+
| [isClientError()](./server-sdk.verifyresult.isclienterror.md) | | <p>Something went wrong on the client side, this generally means your configuration is wrong. Check your secrets (API key) and sitekey.</p><p>See <code>getResponseError()</code> for more information.</p> |
|
|
37
|
+
| [isDecodeError()](./server-sdk.verifyresult.isdecodeerror.md) | | Something went wrong decoding the response from the Friendly Captcha API. |
|
|
38
|
+
| [isEncodeError()](./server-sdk.verifyresult.isencodeerror.md) | | Was unable to encode the captcha response. This means the captcha response was invalid and should never be accepted. |
|
|
39
|
+
| [isRequestOrTimeoutError()](./server-sdk.verifyresult.isrequestortimeouterror.md) | | Something went wrong making the request to the Friendly Captcha API, perhaps there is a network connection issue? |
|
|
40
|
+
| [isStrict()](./server-sdk.verifyresult.isstrict.md) | | |
|
|
41
|
+
| [shouldAccept()](./server-sdk.verifyresult.shouldaccept.md) | | |
|
|
42
|
+
| [shouldReject()](./server-sdk.verifyresult.shouldreject.md) | | |
|
|
43
|
+
| [wasAbleToVerify()](./server-sdk.verifyresult.wasabletoverify.md) | | Whether the request to verify the captcha was completed. In other words: the API responded with status 200.' If this is false, you should notify yourself and use <code>getErrorCode()</code> and <code>getResponseError()</code> to see what is wrong. |
|
|
44
|
+
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [response](./server-sdk.verifyresult.response.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.response property
|
|
6
|
+
|
|
7
|
+
The response from the Friendly Captcha API, or null if the request was not made at all.
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
response: SiteverifyResponse | null;
|
|
13
|
+
```
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [shouldAccept](./server-sdk.verifyresult.shouldaccept.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.shouldAccept() method
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
shouldAccept(): boolean;
|
|
11
|
+
```
|
|
12
|
+
**Returns:**
|
|
13
|
+
|
|
14
|
+
boolean
|
|
15
|
+
|
|
16
|
+
Whether the captcha should be accepted. Note that this does not necessarily mean it was verified.
|
|
17
|
+
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [shouldReject](./server-sdk.verifyresult.shouldreject.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.shouldReject() method
|
|
6
|
+
|
|
7
|
+
**Signature:**
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
shouldReject(): boolean;
|
|
11
|
+
```
|
|
12
|
+
**Returns:**
|
|
13
|
+
|
|
14
|
+
boolean
|
|
15
|
+
|
|
16
|
+
The reverse of `shouldAccept()`<!-- -->.
|
|
17
|
+
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@friendlycaptcha/server-sdk](./server-sdk.md) > [VerifyResult](./server-sdk.verifyresult.md) > [status](./server-sdk.verifyresult.status.md)
|
|
4
|
+
|
|
5
|
+
## VerifyResult.status property
|
|
6
|
+
|
|
7
|
+
The HTTP status code of the response. `-1` if there was no response.
|
|
8
|
+
|
|
9
|
+
**Signature:**
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
status: number;
|
|
13
|
+
```
|