@friendlycaptcha/server-sdk 0.1.2 → 0.2.0

package/dist/api/typesRiskIntelligence.js

@@ -0,0 +1,25 @@
+/** @summary Unknown or missing risk score
+ *  @public
+ */
+export const RISK_SCORE_UNKNOWN = 0;
+/** @summary Very low risk score (1/5)
+ *  @public
+ */
+export const RISK_SCORE_VERY_LOW = 1;
+/** @summary Low risk score (2/5)
+ *  @public
+ */
+export const RISK_SCORE_LOW = 2;
+/** @summary Medium risk score (3/5)
+ *  @public
+ */
+export const RISK_SCORE_MEDIUM = 3;
+/** @summary High risk score (4/5)
+ *  @public
+ */
+export const RISK_SCORE_HIGH = 4;
+/** @summary Very high risk score (5/5)
+ *  @public
+ */
+export const RISK_SCORE_VERY_HIGH = 5;
+//# sourceMappingURL=typesRiskIntelligence.js.map

package/dist/api/typesRiskIntelligence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesRiskIntelligence.js","sourceRoot":"","sources":["../../../src/api/typesRiskIntelligence.ts"],"names":[],"mappings":"AAsDA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAU,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAU,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAU,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAU,CAAC;AAE1C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAU,CAAC"}

package/dist/client/client.d.ts

@@ -10,7 +10,17 @@ export interface FriendlyCaptchaOptions {
      */
     apiKey: string;
     /**
+     * The API endpoint domain to use. Can be "eu", "global", or a custom domain (e.g., "https://api.example.com").
+     * Do not include a path - it will be automatically appended.
+     *
+     * Defaults to `"global"`.
+     */
+    apiEndpoint?: string;
+    /**
+     * @deprecated Use `apiEndpoint` instead. This option will be removed in a future version.
+     *
      * The endpoint to use for the API. Can be "eu", "global", or a custom URL.
+     * If a full URL with a path is provided, the path will be stripped.
      *
      * Defaults to `"global"`.
      */
@@ -37,6 +47,11 @@ export declare class FriendlyCaptchaClient {
     private strict;
     private fetch;
     constructor(opts: FriendlyCaptchaOptions);
+    /**
+     * Get the siteverify endpoint URL being used by this client.
+     * @internal - For testing purposes only
+     */
+    getSiteverifyEndpoint(): string;
     /**
      * Verify a captcha response.
      *

package/dist/client/client.js

@@ -1,8 +1,9 @@
 import { FAILED_DUE_TO_CLIENT_ERROR_CODE, FAILED_TO_DECODE_RESPONSE_ERROR_CODE, FAILED_TO_ENCODE_ERROR_CODE, REQUEST_FAILED_ERROR_CODE, REQUEST_FAILED_TIMEOUT_ERROR_CODE, } from "./errors.js";
 import { VerifyResult } from "./result.js";
 import { SDK_VERSION } from "./version.gen.js";
-const GLOBAL_SITEVERIFY_ENDPOINT = "https://global.frcapi.com/api/v2/captcha/siteverify";
-const EU_SITEVERIFY_ENDPOINT = "https://eu.frcapi.com/api/v2/captcha/siteverify";
+const GLOBAL_API_ENDPOINT = "https://global.frcapi.com";
+const EU_API_ENDPOINT = "https://eu.frcapi.com";
+const SITEVERIFY_PATH = "/api/v2/captcha/siteverify";
 /**
  * A client for the Friendly Captcha API.
  * @public
@@ -14,17 +15,36 @@ export class FriendlyCaptchaClient {
             throw new Error("api key is required");
         }
         this.apiKey = opts.apiKey;
-        let siteverifyEndpoint = opts.siteverifyEndpoint || "global";
-        if (siteverifyEndpoint === "global") {
-            siteverifyEndpoint = GLOBAL_SITEVERIFY_ENDPOINT;
+        // Determine the API endpoint domain
+        let apiEndpoint = opts.apiEndpoint || opts.siteverifyEndpoint || "global";
+        // Handle shorthands
+        if (apiEndpoint === "global") {
+            apiEndpoint = GLOBAL_API_ENDPOINT;
         }
-        else if (siteverifyEndpoint === "eu") {
-            siteverifyEndpoint = EU_SITEVERIFY_ENDPOINT;
+        else if (apiEndpoint === "eu") {
+            apiEndpoint = EU_API_ENDPOINT;
         }
-        this.siteverifyEndpoint = siteverifyEndpoint;
+        else {
+            // Strip path from custom URLs (for backward compatibility with siteverifyEndpoint)
+            try {
+                const url = new URL(apiEndpoint);
+                apiEndpoint = `${url.protocol}//${url.host}`;
+            }
+            catch (e) {
+                // If it's not a valid URL, use as-is
+            }
+        }
+        this.siteverifyEndpoint = apiEndpoint + SITEVERIFY_PATH;
         this.strict = !!opts.strict;
         this.fetch = opts.fetch || globalThis.fetch;
     }
+    /**
+     * Get the siteverify endpoint URL being used by this client.
+     * @internal - For testing purposes only
+     */
+    getSiteverifyEndpoint() {
+        return this.siteverifyEndpoint;
+    }
     /**
      * Verify a captcha response.
      *

package/dist/client/client.js.map

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

package/dist/client/version.gen.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.2";
+export declare const SDK_VERSION = "0.2.0";

package/dist/client/version.gen.js

@@ -1,4 +1,4 @@
 // This file is auto-generated by scripts/updateVersion.mjs
 // Do not edit this file directly
-export const SDK_VERSION = "0.1.2";
+export const SDK_VERSION = "0.2.0";
 //# sourceMappingURL=version.gen.js.map