@silverassist/recaptcha 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.1] - 2026-02-06
+
+### Fixed
+
+- Fix race condition in lazy mode where `grecaptcha` was unavailable immediately after script load (#15)
+- Fix `act()` warnings in client tests by properly wrapping async callbacks
+- Fix TypeScript lint error for `tagName` property on `Node` type in tests
+
+### Changed
+
+- Add JSDoc module headers with `@module`, `@author`, `@license`, and `@version` tags to all source files
+- Document callback stability requirements (`useCallback`) in `onTokenGenerated` and `onError` props
+- Improve test coverage from 82% to 86% branch coverage with edge case tests
+- Suppress expected reCAPTCHA console logs during test execution
+- Update release prompt to include version sync for JSDoc headers
+
+### Dependencies
+
+- Bump `@types/node` from 25.0.10 to 25.2.0
+- Bump `@types/react` from 19.2.9 to 19.2.10
+- Bump `next` from 16.1.5 to 16.1.6
+
 ## [0.2.0] - 2026-02-02
 
 ### Added

package/dist/client/index.d.mts

@@ -14,9 +14,29 @@ interface RecaptchaWrapperProps {
     siteKey?: string;
     /** Token refresh interval in ms (default: 90000 = 90 seconds) */
     refreshInterval?: number;
-    /** Callback when token is generated */
+    /**
+     * Callback when token is generated.
+     * @remarks Should be memoized with useCallback to prevent unnecessary re-renders.
+     * @example
+     * ```tsx
+     * const handleToken = useCallback((token: string) => {
+     *   console.log('Token:', token);
+     * }, []);
+     * <RecaptchaWrapper action="form" onTokenGenerated={handleToken} />
+     * ```
+     */
     onTokenGenerated?: (token: string) => void;
-    /** Callback when an error occurs */
+    /**
+     * Callback when an error occurs.
+     * @remarks Should be memoized with useCallback to prevent unnecessary re-renders.
+     * @example
+     * ```tsx
+     * const handleError = useCallback((error: Error) => {
+     *   console.error('reCAPTCHA error:', error);
+     * }, []);
+     * <RecaptchaWrapper action="form" onError={handleError} />
+     * ```
+     */
     onError?: (error: Error) => void;
     /** Enable lazy loading (default: false for backward compatibility) */
     lazy?: boolean;
@@ -77,10 +97,19 @@ declare global {
  *
  * @example With callbacks
  * ```tsx
+ * // IMPORTANT: Memoize callbacks to prevent unnecessary re-renders
+ * const handleToken = useCallback((token: string) => {
+ *   console.log("Token:", token);
+ * }, []);
+ *
+ * const handleError = useCallback((error: Error) => {
+ *   console.error("Error:", error);
+ * }, []);
+ *
  * <RecaptchaWrapper
  *   action="payment"
- *   onTokenGenerated={(token) => console.log("Token:", token)}
- *   onError={(error) => console.error("Error:", error)}
+ *   onTokenGenerated={handleToken}
+ *   onError={handleError}
  * />
  * ```
  *

package/dist/client/index.d.ts

@@ -14,9 +14,29 @@ interface RecaptchaWrapperProps {
     siteKey?: string;
     /** Token refresh interval in ms (default: 90000 = 90 seconds) */
     refreshInterval?: number;
-    /** Callback when token is generated */
+    /**
+     * Callback when token is generated.
+     * @remarks Should be memoized with useCallback to prevent unnecessary re-renders.
+     * @example
+     * ```tsx
+     * const handleToken = useCallback((token: string) => {
+     *   console.log('Token:', token);
+     * }, []);
+     * <RecaptchaWrapper action="form" onTokenGenerated={handleToken} />
+     * ```
+     */
     onTokenGenerated?: (token: string) => void;
-    /** Callback when an error occurs */
+    /**
+     * Callback when an error occurs.
+     * @remarks Should be memoized with useCallback to prevent unnecessary re-renders.
+     * @example
+     * ```tsx
+     * const handleError = useCallback((error: Error) => {
+     *   console.error('reCAPTCHA error:', error);
+     * }, []);
+     * <RecaptchaWrapper action="form" onError={handleError} />
+     * ```
+     */
     onError?: (error: Error) => void;
     /** Enable lazy loading (default: false for backward compatibility) */
     lazy?: boolean;
@@ -77,10 +97,19 @@ declare global {
  *
  * @example With callbacks
  * ```tsx
+ * // IMPORTANT: Memoize callbacks to prevent unnecessary re-renders
+ * const handleToken = useCallback((token: string) => {
+ *   console.log("Token:", token);
+ * }, []);
+ *
+ * const handleError = useCallback((error: Error) => {
+ *   console.error("Error:", error);
+ * }, []);
+ *
  * <RecaptchaWrapper
  *   action="payment"
- *   onTokenGenerated={(token) => console.log("Token:", token)}
- *   onError={(error) => console.error("Error:", error)}
+ *   onTokenGenerated={handleToken}
+ *   onError={handleError}
  * />
  * ```
  *

package/dist/client/index.js

@@ -65,6 +65,7 @@ function RecaptchaWrapper({
   const tokenInputRef = react.useRef(null);
   const refreshIntervalRef = react.useRef(null);
   const containerRef = react.useRef(null);
+  const isMountedRef = react.useRef(true);
   const [isVisible, setIsVisible] = react.useState(!lazy);
   const [scriptLoaded, setScriptLoaded] = react.useState(false);
   const executeRecaptcha = react.useCallback(async () => {
@@ -72,24 +73,44 @@ function RecaptchaWrapper({
       return;
     }
     try {
-      if (typeof window !== "undefined" && window.grecaptcha) {
-        window.grecaptcha.ready(async () => {
-          try {
-            const token = await window.grecaptcha.execute(siteKey, { action });
-            if (tokenInputRef.current) {
-              tokenInputRef.current.value = token;
-            }
-            if (onTokenGenerated) {
-              onTokenGenerated(token);
-            }
-          } catch (error) {
-            console.error("[reCAPTCHA] Error executing reCAPTCHA:", error);
-            if (onError && error instanceof Error) {
-              onError(error);
-            }
+      const waitForGrecaptcha = async (maxAttempts = 20, delayMs = 100) => {
+        for (let i = 0; i < maxAttempts; i++) {
+          if (!isMountedRef.current) {
+            return false;
           }
-        });
+          if (typeof window !== "undefined" && window.grecaptcha) {
+            return true;
+          }
+          await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+        return false;
+      };
+      const grecaptchaAvailable = await waitForGrecaptcha();
+      if (!isMountedRef.current || !grecaptchaAvailable) {
+        return;
       }
+      window.grecaptcha.ready(async () => {
+        if (!isMountedRef.current) {
+          return;
+        }
+        try {
+          const token = await window.grecaptcha.execute(siteKey, { action });
+          if (!isMountedRef.current) {
+            return;
+          }
+          if (tokenInputRef.current) {
+            tokenInputRef.current.value = token;
+          }
+          if (onTokenGenerated) {
+            onTokenGenerated(token);
+          }
+        } catch (error) {
+          console.error("[reCAPTCHA] Error executing reCAPTCHA:", error);
+          if (onError && error instanceof Error) {
+            onError(error);
+          }
+        }
+      });
     } catch (error) {
       console.error("[reCAPTCHA] Error:", error);
       if (onError && error instanceof Error) {
@@ -150,6 +171,12 @@ function RecaptchaWrapper({
       }
     };
   }, [scriptLoaded, executeRecaptcha, refreshInterval]);
+  react.useEffect(() => {
+    isMountedRef.current = true;
+    return () => {
+      isMountedRef.current = false;
+    };
+  }, []);
   if (!siteKey) {
     if (process.env.NODE_ENV === "development") {
       console.warn(
@@ -201,6 +228,27 @@ function RecaptchaWrapper({
   ] });
 }
 var client_default = RecaptchaWrapper;
+/**
+ * @module @silverassist/recaptcha/constants
+ * @description reCAPTCHA Configuration Constants - Default configuration values
+ * for reCAPTCHA v3 integration.
+ *
+ * @author Miguel Colmenares <me@miguelcolmenares.com>
+ * @license Polyform-Noncommercial-1.0.0
+ * @version 0.2.1
+ * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}
+ */
+/**
+ * @module @silverassist/recaptcha/client
+ * @description reCAPTCHA v3 Client Component - Loads the Google reCAPTCHA script
+ * and generates tokens automatically. Place inside a form to add invisible spam protection.
+ *
+ * @author Miguel Colmenares <me@miguelcolmenares.com>
+ * @license Polyform-Noncommercial-1.0.0
+ * @version 0.2.1
+ * @see {@link https://developers.google.com/recaptcha/docs/v3|Google reCAPTCHA v3 Documentation}
+ * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}
+ */
 
 exports.RecaptchaWrapper = RecaptchaWrapper;
 exports.default = client_default;

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants/index.ts","../../src/client/index.tsx"],"names":["useRef","useState","useCallback","useEffect","jsxs","jsx","Script"],"mappings":";;;;;;;;;;;;AAsBO,IAAM,8BAAA,GAAiC,GAAA;AAKvC,IAAM,gBAAA,GAAoC;AAAA,EAIxB;AAAA,EAEvB,oBAAA,EAAsB;AACxB,CAAA;ACbA,SAAS,mBAAA,CACP,OAAA,EACA,MAAA,EACA,OAAA,EACM;AAEN,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,iBAAA,EAAmB;AAC7D,IAAA,MAAA,EAAO;AACP,IAAA;AAAA,EACF;AAGA,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,kBAAA,EAAoB;AAC9D,IAAA,MAAA,CAAO,oBAAA,GAAuB,MAAA,CAAO,oBAAA,IAAwB,EAAC;AAC9D,IAAA,MAAA,CAAO,oBAAA,CAAqB,IAAA,CAAK,EAAE,MAAA,EAAQ,SAAS,CAAA;AACpD,IAAA;AAAA,EACF;AAGA,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA,MAAA,CAAO,kBAAA,GAAqB,IAAA;AAC5B,IAAA,MAAA,CAAO,uBAAuB,EAAC;AAE/B,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,aAAA,CAAc,QAAQ,CAAA;AAC9C,IAAA,MAAA,CAAO,GAAA,GAAM,kDAAkD,OAAO,CAAA,CAAA;AACtE,IAAA,MAAA,CAAO,KAAA,GAAQ,IAAA;AAEf,IAAA,MAAA,CAAO,SAAS,MAAM;AACpB,MAAA,MAAA,CAAO,iBAAA,GAAoB,IAAA;AAC3B,MAAA,MAAA,CAAO,kBAAA,GAAqB,KAAA;AAC5B,MAAA,MAAA,EAAO;AACP,MAAA,MAAA,CAAO,sBAAsB,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,QAAQ,CAAA;AACxD,MAAA,MAAA,CAAO,uBAAuB,EAAC;AAAA,IACjC,CAAA;AAEA,IAAA,MAAA,CAAO,UAAU,MAAM;AACrB,MAAA,MAAA,CAAO,kBAAA,GAAqB,KAAA;AAC5B,MAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,iCAAiC,CAAA;AACzD,MAAA,OAAA,CAAQ,KAAK,CAAA;AAEb,MAAA,MAAA,CAAO,sBAAsB,OAAA,CAAQ,CAAC,OAAO,EAAA,CAAG,OAAA,CAAQ,KAAK,CAAC,CAAA;AAC9D,MAAA,MAAA,CAAO,uBAAuB,EAAC;AAAA,IACjC,CAAA;AAEA,IAAA,QAAA,CAAS,IAAA,CAAK,YAAY,MAAM,CAAA;AAAA,EAClC;AACF;AAkDO,SAAS,gBAAA,CAAiB;AAAA,EAC/B,MAAA;AAAA,EACA,SAAA,GAAY,gBAAA;AAAA,EACZ,OAAA,GAAU,iBAAA;AAAA,EACV,OAAA,EAAS,WAAA;AAAA,EACT,kBAAkB,gBAAA,CAAiB,oBAAA;AAAA,EACnC,gBAAA;AAAA,EACA,OAAA;AAAA,EACA,IAAA,GAAO,KAAA;AAAA,EACP,cAAA,GAAiB;AACnB,CAAA,EAA0B;AAExB,EAAA,MAAM,OAAA,GAAU,WAAA,IAAe,OAAA,CAAQ,GAAA,CAAI,8BAAA;AAC3C,EAAA,MAAM,aAAA,GAAgBA,aAAyB,IAAI,CAAA;AACnD,EAAA,MAAM,kBAAA,GAAqBA,aAA8B,IAAI,CAAA;AAC7D,EAAA,MAAM,YAAA,GAAeA,aAAuB,IAAI,CAAA;AAChD,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAIC,cAAA,CAAS,CAAC,IAAI,CAAA;AAChD,EAAA,MAAM,CAAC,YAAA,EAAc,eAAe,CAAA,GAAIA,eAAS,KAAK,CAAA;AAGtD,EAAA,MAAM,gBAAA,GAAmBC,kBAAY,YAAY;AAC/C,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA;AAAA,IACF;AAEA,IAAA,IAAI;AACF,MAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,UAAA,EAAY;AACtD,QAAA,MAAA,CAAO,UAAA,CAAW,MAAM,YAAY;AAClC,UAAA,IAAI;AACF,YAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,UAAA,CAAW,QAAQ,OAAA,EAAS,EAAE,QAAQ,CAAA;AAGjE,YAAA,IAAI,cAAc,OAAA,EAAS;AACzB,cAAA,aAAA,CAAc,QAAQ,KAAA,GAAQ,KAAA;AAAA,YAChC;AAGA,YAAA,IAAI,gBAAA,EAAkB;AACpB,cAAA,gBAAA,CAAiB,KAAK,CAAA;AAAA,YACxB;AAAA,UACF,SAAS,KAAA,EAAO;AACd,YAAA,OAAA,CAAQ,KAAA,CAAM,0CAA0C,KAAK,CAAA;AAC7D,YAAA,IAAI,OAAA,IAAW,iBAAiB,KAAA,EAAO;AACrC,cAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,YACf;AAAA,UACF;AAAA,QACF,CAAC,CAAA;AAAA,MACH;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,sBAAsB,KAAK,CAAA;AACzC,MAAA,IAAI,OAAA,IAAW,iBAAiB,KAAA,EAAO;AACrC,QAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,MACf;AAAA,IACF;AAAA,EACF,GAAG,CAAC,OAAA,EAAS,MAAA,EAAQ,gBAAA,EAAkB,OAAO,CAAC,CAAA;AAG/C,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,IAAA,IAAQ,CAAC,YAAA,CAAa,OAAA,EAAS;AAIpC,IAAA,IAAI,OAAO,yBAAyB,WAAA,EAAa;AAC/C,MAAA,YAAA,CAAa,IAAI,CAAA;AACjB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,WAAW,IAAI,oBAAA;AAAA,MACnB,CAAC,CAAC,KAAK,CAAA,KAAM;AACX,QAAA,IAAI,MAAM,cAAA,EAAgB;AACxB,UAAA,YAAA,CAAa,IAAI,CAAA;AACjB,UAAA,QAAA,CAAS,UAAA,EAAW;AAAA,QACtB;AAAA,MACF,CAAA;AAAA,MACA,EAAE,YAAY,cAAA;AAAe,KAC/B;AAEA,IAAA,QAAA,CAAS,OAAA,CAAQ,aAAa,OAAO,CAAA;AACrC,IAAA,OAAO,MAAM,SAAS,UAAA,EAAW;AAAA,EACnC,CAAA,EAAG,CAAC,IAAA,EAAM,cAAc,CAAC,CAAA;AAGzB,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAI,IAAA,EAAM;AAGV,IAAA,IAAI,OAAO,WAAW,WAAA,IAAe,CAAC,OAAO,iBAAA,IAAqB,CAAC,OAAO,kBAAA,EAAoB;AAC5F,MAAA,MAAA,CAAO,kBAAA,GAAqB,IAAA;AAC5B,MAAA,MAAA,CAAO,oBAAA,GAAuB,MAAA,CAAO,oBAAA,IAAwB,EAAC;AAAA,IAChE;AAAA,EACF,CAAA,EAAG,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA;AAGlB,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAI,CAAC,IAAA,EAAM;AACX,IAAA,IAAI,CAAC,SAAA,EAAW;AAEhB,IAAA,MAAM,aAAa,MAAM;AACvB,MAAA,eAAA,CAAgB,IAAI,CAAA;AACpB,MAAA,gBAAA,EAAiB;AAAA,IACnB,CAAA;AAEA,IAAA,MAAM,WAAA,GAAc,CAAC,KAAA,KAAiB;AACpC,MAAA,OAAA,CAAQ,MAAM,6CAA6C,CAAA;AAC3D,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,MACf;AAAA,IACF,CAAA;AAEA,IAAA,mBAAA,CAAoB,OAAA,EAAS,YAAY,WAAW,CAAA;AAAA,EACtD,GAAG,CAAC,OAAA,EAAS,MAAM,SAAA,EAAW,gBAAA,EAAkB,OAAO,CAAC,CAAA;AAGxD,EAAAA,eAAA,CAAU,MAAM;AAEd,IAAA,IAAI,CAAC,YAAA,EAAc;AAGnB,IAAA,kBAAA,CAAmB,OAAA,GAAU,YAAY,MAAM;AAC7C,MAAA,gBAAA,EAAiB;AAAA,IACnB,GAAG,eAAe,CAAA;AAGlB,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,mBAAmB,OAAA,EAAS;AAC9B,QAAA,aAAA,CAAc,mBAAmB,OAAO,CAAA;AAAA,MAC1C;AAAA,IACF,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,YAAA,EAAc,gBAAA,EAAkB,eAAe,CAAC,CAAA;AAGpD,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,aAAA,EAAe;AAC1C,MAAA,OAAA,CAAQ,IAAA;AAAA,QACN;AAAA,OACF;AAAA,IACF;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,uBACEC,eAAA,CAAC,SAAI,GAAA,EAAK,YAAA,EAAc,OAAO,EAAE,OAAA,EAAS,YAAW,EAOnD,QAAA,EAAA;AAAA,oBAAAC,cAAA;AAAA,MAAC,OAAA;AAAA,MAAA;AAAA,QACC,GAAA,EAAK,aAAA;AAAA,QACL,IAAA,EAAK,QAAA;AAAA,QACL,IAAA,EAAM,SAAA;AAAA,QACN,EAAA,EAAI,OAAA;AAAA,QACJ,aAAA,EAAY;AAAA;AAAA,KACd;AAAA,IAGC,CAAC,IAAA,oBACAA,cAAA;AAAA,MAACC,uBAAA;AAAA,MAAA;AAAA,QACC,GAAA,EAAK,kDAAkD,OAAO,CAAA,CAAA;AAAA,QAC9D,QAAA,EAAS,kBAAA;AAAA,QACT,QAAQ,MAAM;AAEZ,UAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,YAAA,MAAA,CAAO,iBAAA,GAAoB,IAAA;AAC3B,YAAA,MAAA,CAAO,kBAAA,GAAqB,KAAA;AAE5B,YAAA,MAAA,CAAO,sBAAsB,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,QAAQ,CAAA;AACxD,YAAA,MAAA,CAAO,uBAAuB,EAAC;AAAA,UACjC;AACA,UAAA,eAAA,CAAgB,IAAI,CAAA;AACpB,UAAA,gBAAA,EAAiB;AAAA,QACnB,CAAA;AAAA,QACA,SAAS,MAAM;AAEb,UAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,YAAA,MAAA,CAAO,kBAAA,GAAqB,KAAA;AAE5B,YAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,iCAAiC,CAAA;AACzD,YAAA,MAAA,CAAO,sBAAsB,OAAA,CAAQ,CAAC,OAAO,EAAA,CAAG,OAAA,CAAQ,KAAK,CAAC,CAAA;AAC9D,YAAA,MAAA,CAAO,uBAAuB,EAAC;AAAA,UACjC;AACA,UAAA,OAAA,CAAQ,MAAM,6CAA6C,CAAA;AAC3D,UAAA,IAAI,OAAA,EAAS;AACX,YAAA,OAAA,CAAQ,IAAI,KAAA,CAAM,iCAAiC,CAAC,CAAA;AAAA,UACtD;AAAA,QACF;AAAA;AAAA;AACF,GAAA,EAEJ,CAAA;AAEJ;AAEA,IAAO,cAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * reCAPTCHA Configuration Constants\n *\n * Default configuration values for reCAPTCHA v3 integration.\n *\n * @packageDocumentation\n */\n\nimport type { RecaptchaConfig } from \"../types\";\n\n/**\n * Default score threshold for validation\n * Scores below this value are considered suspicious\n * Range: 0.0 (bot) to 1.0 (human)\n */\nexport const DEFAULT_SCORE_THRESHOLD = 0.5;\n\n/**\n * Token refresh interval in milliseconds\n * reCAPTCHA tokens expire after 2 minutes, so we refresh at 90 seconds\n * to ensure tokens are always valid when forms are submitted\n */\nexport const DEFAULT_TOKEN_REFRESH_INTERVAL = 90000;\n\n/**\n * reCAPTCHA v3 configuration constants\n */\nexport const RECAPTCHA_CONFIG: RecaptchaConfig = {\n  /** Google reCAPTCHA verification endpoint */\n  verifyUrl: \"https://www.google.com/recaptcha/api/siteverify\",\n  /** Default score threshold for validation */\n  defaultScoreThreshold: DEFAULT_SCORE_THRESHOLD,\n  /** Default token refresh interval */\n  tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL,\n} as const;\n","/**\n * reCAPTCHA v3 Client Component\n *\n * Loads the Google reCAPTCHA script and generates tokens automatically.\n * Place inside a form to add invisible spam protection.\n *\n * @see https://developers.google.com/recaptcha/docs/v3\n * @packageDocumentation\n */\n\n\"use client\";\n\nimport Script from \"next/script\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { RecaptchaWrapperProps } from \"../types\";\nimport { RECAPTCHA_CONFIG } from \"../constants\";\n\n/**\n * Load reCAPTCHA script manually (singleton pattern)\n * Ensures script is only loaded once globally\n */\nfunction loadRecaptchaScript(\n  siteKey: string,\n  onLoad: () => void,\n  onError: (error: Error) => void\n): void {\n  // Already loaded\n  if (typeof window !== \"undefined\" && window.__recaptchaLoaded) {\n    onLoad();\n    return;\n  }\n\n  // Currently loading - add callbacks\n  if (typeof window !== \"undefined\" && window.__recaptchaLoading) {\n    window.__recaptchaCallbacks = window.__recaptchaCallbacks || [];\n    window.__recaptchaCallbacks.push({ onLoad, onError });\n    return;\n  }\n\n  // Start loading\n  if (typeof window !== \"undefined\") {\n    window.__recaptchaLoading = true;\n    window.__recaptchaCallbacks = [];\n\n    const script = document.createElement(\"script\");\n    script.src = `https://www.google.com/recaptcha/api.js?render=${siteKey}`;\n    script.async = true;\n\n    script.onload = () => {\n      window.__recaptchaLoaded = true;\n      window.__recaptchaLoading = false;\n      onLoad();\n      window.__recaptchaCallbacks?.forEach((cb) => cb.onLoad());\n      window.__recaptchaCallbacks = [];\n    };\n\n    script.onerror = () => {\n      window.__recaptchaLoading = false;\n      const error = new Error(\"Failed to load reCAPTCHA script\");\n      onError(error);\n      // Notify all queued callbacks about the failure\n      window.__recaptchaCallbacks?.forEach((cb) => cb.onError(error));\n      window.__recaptchaCallbacks = [];\n    };\n\n    document.head.appendChild(script);\n  }\n}\n\n/**\n * RecaptchaWrapper - Client component for reCAPTCHA v3 integration\n *\n * Features:\n * - Loads reCAPTCHA script automatically\n * - Generates token when script loads\n * - Refreshes token periodically (tokens expire after 2 minutes)\n * - Stores token in hidden input field for form submission\n * - Graceful fallback when not configured\n * - Lazy loading support to defer script loading until visible\n *\n * @example Basic usage\n * ```tsx\n * <form action={formAction}>\n *   <RecaptchaWrapper action=\"contact_form\" />\n *   <input name=\"email\" type=\"email\" required />\n *   <button type=\"submit\">Submit</button>\n * </form>\n * ```\n *\n * @example Custom input name\n * ```tsx\n * <RecaptchaWrapper\n *   action=\"signup\"\n *   inputName=\"captchaToken\"\n *   inputId=\"signup-captcha\"\n * />\n * ```\n *\n * @example With callbacks\n * ```tsx\n * <RecaptchaWrapper\n *   action=\"payment\"\n *   onTokenGenerated={(token) => console.log(\"Token:\", token)}\n *   onError={(error) => console.error(\"Error:\", error)}\n * />\n * ```\n *\n * @example Lazy loading for better performance\n * ```tsx\n * <RecaptchaWrapper action=\"contact_form\" lazy />\n * ```\n *\n * @example Lazy loading with custom root margin\n * ```tsx\n * <RecaptchaWrapper action=\"contact_form\" lazy lazyRootMargin=\"400px\" />\n * ```\n */\nexport function RecaptchaWrapper({\n  action,\n  inputName = \"recaptchaToken\",\n  inputId = \"recaptcha-token\",\n  siteKey: propSiteKey,\n  refreshInterval = RECAPTCHA_CONFIG.tokenRefreshInterval,\n  onTokenGenerated,\n  onError,\n  lazy = false,\n  lazyRootMargin = \"200px\",\n}: RecaptchaWrapperProps) {\n  // Use prop siteKey or fall back to environment variable\n  const siteKey = propSiteKey ?? process.env.NEXT_PUBLIC_RECAPTCHA_SITE_KEY;\n  const tokenInputRef = useRef<HTMLInputElement>(null);\n  const refreshIntervalRef = useRef<NodeJS.Timeout | null>(null);\n  const containerRef = useRef<HTMLDivElement>(null);\n  const [isVisible, setIsVisible] = useState(!lazy); // If not lazy, start visible\n  const [scriptLoaded, setScriptLoaded] = useState(false);\n\n  // Execute reCAPTCHA and store token\n  const executeRecaptcha = useCallback(async () => {\n    if (!siteKey) {\n      return;\n    }\n\n    try {\n      if (typeof window !== \"undefined\" && window.grecaptcha) {\n        window.grecaptcha.ready(async () => {\n          try {\n            const token = await window.grecaptcha.execute(siteKey, { action });\n\n            // Store token in hidden input\n            if (tokenInputRef.current) {\n              tokenInputRef.current.value = token;\n            }\n\n            // Call callback if provided\n            if (onTokenGenerated) {\n              onTokenGenerated(token);\n            }\n          } catch (error) {\n            console.error(\"[reCAPTCHA] Error executing reCAPTCHA:\", error);\n            if (onError && error instanceof Error) {\n              onError(error);\n            }\n          }\n        });\n      }\n    } catch (error) {\n      console.error(\"[reCAPTCHA] Error:\", error);\n      if (onError && error instanceof Error) {\n        onError(error);\n      }\n    }\n  }, [siteKey, action, onTokenGenerated, onError]);\n\n  // IntersectionObserver for lazy loading\n  useEffect(() => {\n    if (!lazy || !containerRef.current) return;\n\n    // Fallback to eager loading if IntersectionObserver is not supported\n    // (older browsers, some SSR/test environments)\n    if (typeof IntersectionObserver === \"undefined\") {\n      setIsVisible(true);\n      return;\n    }\n\n    const observer = new IntersectionObserver(\n      ([entry]) => {\n        if (entry.isIntersecting) {\n          setIsVisible(true);\n          observer.disconnect();\n        }\n      },\n      { rootMargin: lazyRootMargin }\n    );\n\n    observer.observe(containerRef.current);\n    return () => observer.disconnect();\n  }, [lazy, lazyRootMargin]);\n\n  // Mark loading flag for non-lazy mode to prevent duplicate loads\n  useEffect(() => {\n    if (!siteKey) return;\n    if (lazy) return; // Only for non-lazy mode\n\n    // Set loading flag before Script component loads\n    if (typeof window !== \"undefined\" && !window.__recaptchaLoaded && !window.__recaptchaLoading) {\n      window.__recaptchaLoading = true;\n      window.__recaptchaCallbacks = window.__recaptchaCallbacks || [];\n    }\n  }, [siteKey, lazy]);\n\n  // Load script when visible (only for lazy mode)\n  useEffect(() => {\n    if (!siteKey) return;\n    if (!lazy) return; // Only use manual loading for lazy mode\n    if (!isVisible) return; // Wait until visible\n\n    const handleLoad = () => {\n      setScriptLoaded(true);\n      executeRecaptcha();\n    };\n\n    const handleError = (error: Error) => {\n      console.error(\"[reCAPTCHA] Failed to load reCAPTCHA script\");\n      if (onError) {\n        onError(error);\n      }\n    };\n\n    loadRecaptchaScript(siteKey, handleLoad, handleError);\n  }, [siteKey, lazy, isVisible, executeRecaptcha, onError]);\n\n  // Set up token refresh interval (tokens expire after 2 minutes)\n  useEffect(() => {\n    // Only set up refresh if script is loaded\n    if (!scriptLoaded) return;\n\n    // Set up refresh interval\n    refreshIntervalRef.current = setInterval(() => {\n      executeRecaptcha();\n    }, refreshInterval);\n\n    // Cleanup interval on unmount\n    return () => {\n      if (refreshIntervalRef.current) {\n        clearInterval(refreshIntervalRef.current);\n      }\n    };\n  }, [scriptLoaded, executeRecaptcha, refreshInterval]);\n\n  // Don't render anything if site key is not configured\n  if (!siteKey) {\n    if (process.env.NODE_ENV === \"development\") {\n      console.warn(\n        \"[reCAPTCHA] Site key not configured. Set NEXT_PUBLIC_RECAPTCHA_SITE_KEY environment variable.\"\n      );\n    }\n    return null;\n  }\n\n  return (\n    <div ref={containerRef} style={{ display: \"contents\" }}>\n      {/* \n        Note: display: contents makes this wrapper transparent to the DOM layout.\n        The wrapper is needed for IntersectionObserver but shouldn't affect form layout.\n        Browser support: https://caniuse.com/css-display-contents\n      */}\n      {/* Hidden input to store the token */}\n      <input\n        ref={tokenInputRef}\n        type=\"hidden\"\n        name={inputName}\n        id={inputId}\n        data-testid=\"recaptcha-token-input\"\n      />\n\n      {/* Load reCAPTCHA script using Next.js Script component for non-lazy mode */}\n      {!lazy && (\n        <Script\n          src={`https://www.google.com/recaptcha/api.js?render=${siteKey}`}\n          strategy=\"afterInteractive\"\n          onLoad={() => {\n            // Mark script as loaded globally for singleton behavior\n            if (typeof window !== \"undefined\") {\n              window.__recaptchaLoaded = true;\n              window.__recaptchaLoading = false;\n              // Flush all queued callbacks from lazy instances\n              window.__recaptchaCallbacks?.forEach((cb) => cb.onLoad());\n              window.__recaptchaCallbacks = [];\n            }\n            setScriptLoaded(true);\n            executeRecaptcha();\n          }}\n          onError={() => {\n            // Mark loading as complete on error\n            if (typeof window !== \"undefined\") {\n              window.__recaptchaLoading = false;\n              // Notify all queued callbacks about the failure\n              const error = new Error(\"Failed to load reCAPTCHA script\");\n              window.__recaptchaCallbacks?.forEach((cb) => cb.onError(error));\n              window.__recaptchaCallbacks = [];\n            }\n            console.error(\"[reCAPTCHA] Failed to load reCAPTCHA script\");\n            if (onError) {\n              onError(new Error(\"Failed to load reCAPTCHA script\"));\n            }\n          }}\n        />\n      )}\n    </div>\n  );\n}\n\nexport default RecaptchaWrapper;\n"]}
+{"version":3,"sources":["../../src/constants/index.ts","../../src/client/index.tsx"],"names":["useRef","useState","useCallback","useEffect","jsxs","jsx","Script"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @module @silverassist/recaptcha/constants\n * @description reCAPTCHA Configuration Constants - Default configuration values\n * for reCAPTCHA v3 integration.\n *\n * @author Miguel Colmenares <me@miguelcolmenares.com>\n * @license Polyform-Noncommercial-1.0.0\n * @version 0.2.1\n * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}\n */\n\nimport type { RecaptchaConfig } from \"../types\";\n\n/**\n * Default score threshold for validation\n * Scores below this value are considered suspicious\n * Range: 0.0 (bot) to 1.0 (human)\n */\nexport const DEFAULT_SCORE_THRESHOLD = 0.5;\n\n/**\n * Token refresh interval in milliseconds\n * reCAPTCHA tokens expire after 2 minutes, so we refresh at 90 seconds\n * to ensure tokens are always valid when forms are submitted\n */\nexport const DEFAULT_TOKEN_REFRESH_INTERVAL = 90000;\n\n/**\n * reCAPTCHA v3 configuration constants\n */\nexport const RECAPTCHA_CONFIG: RecaptchaConfig = {\n  /** Google reCAPTCHA verification endpoint */\n  verifyUrl: \"https://www.google.com/recaptcha/api/siteverify\",\n  /** Default score threshold for validation */\n  defaultScoreThreshold: DEFAULT_SCORE_THRESHOLD,\n  /** Default token refresh interval */\n  tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL,\n} as const;\n","/**\n * @module @silverassist/recaptcha/client\n * @description reCAPTCHA v3 Client Component - Loads the Google reCAPTCHA script\n * and generates tokens automatically. Place inside a form to add invisible spam protection.\n *\n * @author Miguel Colmenares <me@miguelcolmenares.com>\n * @license Polyform-Noncommercial-1.0.0\n * @version 0.2.1\n * @see {@link https://developers.google.com/recaptcha/docs/v3|Google reCAPTCHA v3 Documentation}\n * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}\n */\n\n\"use client\";\n\nimport Script from \"next/script\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { RecaptchaWrapperProps } from \"../types\";\nimport { RECAPTCHA_CONFIG } from \"../constants\";\n\n/**\n * Load reCAPTCHA script manually (singleton pattern)\n * Ensures script is only loaded once globally\n */\nfunction loadRecaptchaScript(\n  siteKey: string,\n  onLoad: () => void,\n  onError: (error: Error) => void\n): void {\n  // Already loaded\n  if (typeof window !== \"undefined\" && window.__recaptchaLoaded) {\n    onLoad();\n    return;\n  }\n\n  // Currently loading - add callbacks\n  if (typeof window !== \"undefined\" && window.__recaptchaLoading) {\n    window.__recaptchaCallbacks = window.__recaptchaCallbacks || [];\n    window.__recaptchaCallbacks.push({ onLoad, onError });\n    return;\n  }\n\n  // Start loading\n  if (typeof window !== \"undefined\") {\n    window.__recaptchaLoading = true;\n    window.__recaptchaCallbacks = [];\n\n    const script = document.createElement(\"script\");\n    script.src = `https://www.google.com/recaptcha/api.js?render=${siteKey}`;\n    script.async = true;\n\n    script.onload = () => {\n      window.__recaptchaLoaded = true;\n      window.__recaptchaLoading = false;\n      onLoad();\n      window.__recaptchaCallbacks?.forEach((cb) => cb.onLoad());\n      window.__recaptchaCallbacks = [];\n    };\n\n    script.onerror = () => {\n      window.__recaptchaLoading = false;\n      const error = new Error(\"Failed to load reCAPTCHA script\");\n      onError(error);\n      // Notify all queued callbacks about the failure\n      window.__recaptchaCallbacks?.forEach((cb) => cb.onError(error));\n      window.__recaptchaCallbacks = [];\n    };\n\n    document.head.appendChild(script);\n  }\n}\n\n/**\n * RecaptchaWrapper - Client component for reCAPTCHA v3 integration\n *\n * Features:\n * - Loads reCAPTCHA script automatically\n * - Generates token when script loads\n * - Refreshes token periodically (tokens expire after 2 minutes)\n * - Stores token in hidden input field for form submission\n * - Graceful fallback when not configured\n * - Lazy loading support to defer script loading until visible\n *\n * @example Basic usage\n * ```tsx\n * <form action={formAction}>\n *   <RecaptchaWrapper action=\"contact_form\" />\n *   <input name=\"email\" type=\"email\" required />\n *   <button type=\"submit\">Submit</button>\n * </form>\n * ```\n *\n * @example Custom input name\n * ```tsx\n * <RecaptchaWrapper\n *   action=\"signup\"\n *   inputName=\"captchaToken\"\n *   inputId=\"signup-captcha\"\n * />\n * ```\n *\n * @example With callbacks\n * ```tsx\n * // IMPORTANT: Memoize callbacks to prevent unnecessary re-renders\n * const handleToken = useCallback((token: string) => {\n *   console.log(\"Token:\", token);\n * }, []);\n *\n * const handleError = useCallback((error: Error) => {\n *   console.error(\"Error:\", error);\n * }, []);\n *\n * <RecaptchaWrapper\n *   action=\"payment\"\n *   onTokenGenerated={handleToken}\n *   onError={handleError}\n * />\n * ```\n *\n * @example Lazy loading for better performance\n * ```tsx\n * <RecaptchaWrapper action=\"contact_form\" lazy />\n * ```\n *\n * @example Lazy loading with custom root margin\n * ```tsx\n * <RecaptchaWrapper action=\"contact_form\" lazy lazyRootMargin=\"400px\" />\n * ```\n */\nexport function RecaptchaWrapper({\n  action,\n  inputName = \"recaptchaToken\",\n  inputId = \"recaptcha-token\",\n  siteKey: propSiteKey,\n  refreshInterval = RECAPTCHA_CONFIG.tokenRefreshInterval,\n  onTokenGenerated,\n  onError,\n  lazy = false,\n  lazyRootMargin = \"200px\",\n}: RecaptchaWrapperProps) {\n  // Use prop siteKey or fall back to environment variable\n  const siteKey = propSiteKey ?? process.env.NEXT_PUBLIC_RECAPTCHA_SITE_KEY;\n  const tokenInputRef = useRef<HTMLInputElement>(null);\n  const refreshIntervalRef = useRef<NodeJS.Timeout | null>(null);\n  const containerRef = useRef<HTMLDivElement>(null);\n  const isMountedRef = useRef<boolean>(true);\n  const [isVisible, setIsVisible] = useState(!lazy); // If not lazy, start visible\n  const [scriptLoaded, setScriptLoaded] = useState(false);\n\n  // Execute reCAPTCHA and store token\n  const executeRecaptcha = useCallback(async () => {\n    if (!siteKey) {\n      return;\n    }\n\n    try {\n      // Wait for grecaptcha to be available (with timeout)\n      // This handles the race condition where the script loads but\n      // window.grecaptcha is not immediately available\n      const waitForGrecaptcha = async (maxAttempts = 20, delayMs = 100): Promise<boolean> => {\n        for (let i = 0; i < maxAttempts; i++) {\n          // Check if component is still mounted\n          if (!isMountedRef.current) {\n            return false;\n          }\n          \n          if (typeof window !== \"undefined\" && window.grecaptcha) {\n            return true;\n          }\n          await new Promise((resolve) => setTimeout(resolve, delayMs));\n        }\n        return false;\n      };\n\n      const grecaptchaAvailable = await waitForGrecaptcha();\n\n      // Exit early if component unmounted during polling\n      if (!isMountedRef.current || !grecaptchaAvailable) {\n        return;\n      }\n\n      window.grecaptcha.ready(async () => {\n        // Check if still mounted before executing\n        if (!isMountedRef.current) {\n          return;\n        }\n\n        try {\n          const token = await window.grecaptcha.execute(siteKey, { action });\n\n          // Check if still mounted before storing token\n          if (!isMountedRef.current) {\n            return;\n          }\n\n          // Store token in hidden input\n          if (tokenInputRef.current) {\n            tokenInputRef.current.value = token;\n          }\n\n          // Call callback if provided\n          if (onTokenGenerated) {\n            onTokenGenerated(token);\n          }\n        } catch (error) {\n          console.error(\"[reCAPTCHA] Error executing reCAPTCHA:\", error);\n          if (onError && error instanceof Error) {\n            onError(error);\n          }\n        }\n      });\n    } catch (error) {\n      console.error(\"[reCAPTCHA] Error:\", error);\n      if (onError && error instanceof Error) {\n        onError(error);\n      }\n    }\n  }, [siteKey, action, onTokenGenerated, onError]);\n\n  // IntersectionObserver for lazy loading\n  useEffect(() => {\n    if (!lazy || !containerRef.current) return;\n\n    // Fallback to eager loading if IntersectionObserver is not supported\n    // (older browsers, some SSR/test environments)\n    if (typeof IntersectionObserver === \"undefined\") {\n      setIsVisible(true);\n      return;\n    }\n\n    const observer = new IntersectionObserver(\n      ([entry]) => {\n        if (entry.isIntersecting) {\n          setIsVisible(true);\n          observer.disconnect();\n        }\n      },\n      { rootMargin: lazyRootMargin }\n    );\n\n    observer.observe(containerRef.current);\n    return () => observer.disconnect();\n  }, [lazy, lazyRootMargin]);\n\n  // Mark loading flag for non-lazy mode to prevent duplicate loads\n  useEffect(() => {\n    if (!siteKey) return;\n    if (lazy) return; // Only for non-lazy mode\n\n    // Set loading flag before Script component loads\n    if (typeof window !== \"undefined\" && !window.__recaptchaLoaded && !window.__recaptchaLoading) {\n      window.__recaptchaLoading = true;\n      window.__recaptchaCallbacks = window.__recaptchaCallbacks || [];\n    }\n  }, [siteKey, lazy]);\n\n  // Load script when visible (only for lazy mode)\n  useEffect(() => {\n    if (!siteKey) return;\n    if (!lazy) return; // Only use manual loading for lazy mode\n    if (!isVisible) return; // Wait until visible\n\n    const handleLoad = () => {\n      setScriptLoaded(true);\n      executeRecaptcha();\n    };\n\n    const handleError = (error: Error) => {\n      console.error(\"[reCAPTCHA] Failed to load reCAPTCHA script\");\n      if (onError) {\n        onError(error);\n      }\n    };\n\n    loadRecaptchaScript(siteKey, handleLoad, handleError);\n  }, [siteKey, lazy, isVisible, executeRecaptcha, onError]);\n\n  // Set up token refresh interval (tokens expire after 2 minutes)\n  useEffect(() => {\n    // Only set up refresh if script is loaded\n    if (!scriptLoaded) return;\n\n    // Set up refresh interval\n    refreshIntervalRef.current = setInterval(() => {\n      executeRecaptcha();\n    }, refreshInterval);\n\n    // Cleanup interval on unmount\n    return () => {\n      if (refreshIntervalRef.current) {\n        clearInterval(refreshIntervalRef.current);\n      }\n    };\n  }, [scriptLoaded, executeRecaptcha, refreshInterval]);\n\n  // Track mounted state to prevent side effects after unmount\n  useEffect(() => {\n    isMountedRef.current = true;\n    \n    return () => {\n      isMountedRef.current = false;\n    };\n  }, []);\n\n  // Don't render anything if site key is not configured\n  if (!siteKey) {\n    if (process.env.NODE_ENV === \"development\") {\n      console.warn(\n        \"[reCAPTCHA] Site key not configured. Set NEXT_PUBLIC_RECAPTCHA_SITE_KEY environment variable.\"\n      );\n    }\n    return null;\n  }\n\n  return (\n    <div ref={containerRef} style={{ display: \"contents\" }}>\n      {/* \n        Note: display: contents makes this wrapper transparent to the DOM layout.\n        The wrapper is needed for IntersectionObserver but shouldn't affect form layout.\n        Browser support: https://caniuse.com/css-display-contents\n      */}\n      {/* Hidden input to store the token */}\n      <input\n        ref={tokenInputRef}\n        type=\"hidden\"\n        name={inputName}\n        id={inputId}\n        data-testid=\"recaptcha-token-input\"\n      />\n\n      {/* Load reCAPTCHA script using Next.js Script component for non-lazy mode */}\n      {!lazy && (\n        <Script\n          src={`https://www.google.com/recaptcha/api.js?render=${siteKey}`}\n          strategy=\"afterInteractive\"\n          onLoad={() => {\n            // Mark script as loaded globally for singleton behavior\n            if (typeof window !== \"undefined\") {\n              window.__recaptchaLoaded = true;\n              window.__recaptchaLoading = false;\n              // Flush all queued callbacks from lazy instances\n              window.__recaptchaCallbacks?.forEach((cb) => cb.onLoad());\n              window.__recaptchaCallbacks = [];\n            }\n            setScriptLoaded(true);\n            executeRecaptcha();\n          }}\n          onError={() => {\n            // Mark loading as complete on error\n            if (typeof window !== \"undefined\") {\n              window.__recaptchaLoading = false;\n              // Notify all queued callbacks about the failure\n              const error = new Error(\"Failed to load reCAPTCHA script\");\n              window.__recaptchaCallbacks?.forEach((cb) => cb.onError(error));\n              window.__recaptchaCallbacks = [];\n            }\n            console.error(\"[reCAPTCHA] Failed to load reCAPTCHA script\");\n            if (onError) {\n              onError(new Error(\"Failed to load reCAPTCHA script\"));\n            }\n          }}\n        />\n      )}\n    </div>\n  );\n}\n\nexport default RecaptchaWrapper;\n"]}

package/dist/client/index.mjs

@@ -57,6 +57,7 @@ function RecaptchaWrapper({
   const tokenInputRef = useRef(null);
   const refreshIntervalRef = useRef(null);
   const containerRef = useRef(null);
+  const isMountedRef = useRef(true);
   const [isVisible, setIsVisible] = useState(!lazy);
   const [scriptLoaded, setScriptLoaded] = useState(false);
   const executeRecaptcha = useCallback(async () => {
@@ -64,24 +65,44 @@ function RecaptchaWrapper({
       return;
     }
     try {
-      if (typeof window !== "undefined" && window.grecaptcha) {
-        window.grecaptcha.ready(async () => {
-          try {
-            const token = await window.grecaptcha.execute(siteKey, { action });
-            if (tokenInputRef.current) {
-              tokenInputRef.current.value = token;
-            }
-            if (onTokenGenerated) {
-              onTokenGenerated(token);
-            }
-          } catch (error) {
-            console.error("[reCAPTCHA] Error executing reCAPTCHA:", error);
-            if (onError && error instanceof Error) {
-              onError(error);
-            }
+      const waitForGrecaptcha = async (maxAttempts = 20, delayMs = 100) => {
+        for (let i = 0; i < maxAttempts; i++) {
+          if (!isMountedRef.current) {
+            return false;
           }
-        });
+          if (typeof window !== "undefined" && window.grecaptcha) {
+            return true;
+          }
+          await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+        return false;
+      };
+      const grecaptchaAvailable = await waitForGrecaptcha();
+      if (!isMountedRef.current || !grecaptchaAvailable) {
+        return;
       }
+      window.grecaptcha.ready(async () => {
+        if (!isMountedRef.current) {
+          return;
+        }
+        try {
+          const token = await window.grecaptcha.execute(siteKey, { action });
+          if (!isMountedRef.current) {
+            return;
+          }
+          if (tokenInputRef.current) {
+            tokenInputRef.current.value = token;
+          }
+          if (onTokenGenerated) {
+            onTokenGenerated(token);
+          }
+        } catch (error) {
+          console.error("[reCAPTCHA] Error executing reCAPTCHA:", error);
+          if (onError && error instanceof Error) {
+            onError(error);
+          }
+        }
+      });
     } catch (error) {
       console.error("[reCAPTCHA] Error:", error);
       if (onError && error instanceof Error) {
@@ -142,6 +163,12 @@ function RecaptchaWrapper({
       }
     };
   }, [scriptLoaded, executeRecaptcha, refreshInterval]);
+  useEffect(() => {
+    isMountedRef.current = true;
+    return () => {
+      isMountedRef.current = false;
+    };
+  }, []);
   if (!siteKey) {
     if (process.env.NODE_ENV === "development") {
       console.warn(
@@ -193,6 +220,27 @@ function RecaptchaWrapper({
   ] });
 }
 var client_default = RecaptchaWrapper;
+/**
+ * @module @silverassist/recaptcha/constants
+ * @description reCAPTCHA Configuration Constants - Default configuration values
+ * for reCAPTCHA v3 integration.
+ *
+ * @author Miguel Colmenares <me@miguelcolmenares.com>
+ * @license Polyform-Noncommercial-1.0.0
+ * @version 0.2.1
+ * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}
+ */
+/**
+ * @module @silverassist/recaptcha/client
+ * @description reCAPTCHA v3 Client Component - Loads the Google reCAPTCHA script
+ * and generates tokens automatically. Place inside a form to add invisible spam protection.
+ *
+ * @author Miguel Colmenares <me@miguelcolmenares.com>
+ * @license Polyform-Noncommercial-1.0.0
+ * @version 0.2.1
+ * @see {@link https://developers.google.com/recaptcha/docs/v3|Google reCAPTCHA v3 Documentation}
+ * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}
+ */
 
 export { RecaptchaWrapper, client_default as default };
 //# sourceMappingURL=index.mjs.map

package/dist/client/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants/index.ts","../../src/client/index.tsx"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * reCAPTCHA Configuration Constants\n *\n * Default configuration values for reCAPTCHA v3 integration.\n *\n * @packageDocumentation\n */\n\nimport type { RecaptchaConfig } from \"../types\";\n\n/**\n * Default score threshold for validation\n * Scores below this value are considered suspicious\n * Range: 0.0 (bot) to 1.0 (human)\n */\nexport const DEFAULT_SCORE_THRESHOLD = 0.5;\n\n/**\n * Token refresh interval in milliseconds\n * reCAPTCHA tokens expire after 2 minutes, so we refresh at 90 seconds\n * to ensure tokens are always valid when forms are submitted\n */\nexport const DEFAULT_TOKEN_REFRESH_INTERVAL = 90000;\n\n/**\n * reCAPTCHA v3 configuration constants\n */\nexport const RECAPTCHA_CONFIG: RecaptchaConfig = {\n  /** Google reCAPTCHA verification endpoint */\n  verifyUrl: \"https://www.google.com/recaptcha/api/siteverify\",\n  /** Default score threshold for validation */\n  defaultScoreThreshold: DEFAULT_SCORE_THRESHOLD,\n  /** Default token refresh interval */\n  tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL,\n} as const;\n","/**\n * reCAPTCHA v3 Client Component\n *\n * Loads the Google reCAPTCHA script and generates tokens automatically.\n * Place inside a form to add invisible spam protection.\n *\n * @see https://developers.google.com/recaptcha/docs/v3\n * @packageDocumentation\n */\n\n\"use client\";\n\nimport Script from \"next/script\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { RecaptchaWrapperProps } from \"../types\";\nimport { RECAPTCHA_CONFIG } from \"../constants\";\n\n/**\n * Load reCAPTCHA script manually (singleton pattern)\n * Ensures script is only loaded once globally\n */\nfunction loadRecaptchaScript(\n  siteKey: string,\n  onLoad: () => void,\n  onError: (error: Error) => void\n): void {\n  // Already loaded\n  if (typeof window !== \"undefined\" && window.__recaptchaLoaded) {\n    onLoad();\n    return;\n  }\n\n  // Currently loading - add callbacks\n  if (typeof window !== \"undefined\" && window.__recaptchaLoading) {\n    window.__recaptchaCallbacks = window.__recaptchaCallbacks || [];\n    window.__recaptchaCallbacks.push({ onLoad, onError });\n    return;\n  }\n\n  // Start loading\n  if (typeof window !== \"undefined\") {\n    window.__recaptchaLoading = true;\n    window.__recaptchaCallbacks = [];\n\n    const script = document.createElement(\"script\");\n    script.src = `https://www.google.com/recaptcha/api.js?render=${siteKey}`;\n    script.async = true;\n\n    script.onload = () => {\n      window.__recaptchaLoaded = true;\n      window.__recaptchaLoading = false;\n      onLoad();\n      window.__recaptchaCallbacks?.forEach((cb) => cb.onLoad());\n      window.__recaptchaCallbacks = [];\n    };\n\n    script.onerror = () => {\n      window.__recaptchaLoading = false;\n      const error = new Error(\"Failed to load reCAPTCHA script\");\n      onError(error);\n      // Notify all queued callbacks about the failure\n      window.__recaptchaCallbacks?.forEach((cb) => cb.onError(error));\n      window.__recaptchaCallbacks = [];\n    };\n\n    document.head.appendChild(script);\n  }\n}\n\n/**\n * RecaptchaWrapper - Client component for reCAPTCHA v3 integration\n *\n * Features:\n * - Loads reCAPTCHA script automatically\n * - Generates token when script loads\n * - Refreshes token periodically (tokens expire after 2 minutes)\n * - Stores token in hidden input field for form submission\n * - Graceful fallback when not configured\n * - Lazy loading support to defer script loading until visible\n *\n * @example Basic usage\n * ```tsx\n * <form action={formAction}>\n *   <RecaptchaWrapper action=\"contact_form\" />\n *   <input name=\"email\" type=\"email\" required />\n *   <button type=\"submit\">Submit</button>\n * </form>\n * ```\n *\n * @example Custom input name\n * ```tsx\n * <RecaptchaWrapper\n *   action=\"signup\"\n *   inputName=\"captchaToken\"\n *   inputId=\"signup-captcha\"\n * />\n * ```\n *\n * @example With callbacks\n * ```tsx\n * <RecaptchaWrapper\n *   action=\"payment\"\n *   onTokenGenerated={(token) => console.log(\"Token:\", token)}\n *   onError={(error) => console.error(\"Error:\", error)}\n * />\n * ```\n *\n * @example Lazy loading for better performance\n * ```tsx\n * <RecaptchaWrapper action=\"contact_form\" lazy />\n * ```\n *\n * @example Lazy loading with custom root margin\n * ```tsx\n * <RecaptchaWrapper action=\"contact_form\" lazy lazyRootMargin=\"400px\" />\n * ```\n */\nexport function RecaptchaWrapper({\n  action,\n  inputName = \"recaptchaToken\",\n  inputId = \"recaptcha-token\",\n  siteKey: propSiteKey,\n  refreshInterval = RECAPTCHA_CONFIG.tokenRefreshInterval,\n  onTokenGenerated,\n  onError,\n  lazy = false,\n  lazyRootMargin = \"200px\",\n}: RecaptchaWrapperProps) {\n  // Use prop siteKey or fall back to environment variable\n  const siteKey = propSiteKey ?? process.env.NEXT_PUBLIC_RECAPTCHA_SITE_KEY;\n  const tokenInputRef = useRef<HTMLInputElement>(null);\n  const refreshIntervalRef = useRef<NodeJS.Timeout | null>(null);\n  const containerRef = useRef<HTMLDivElement>(null);\n  const [isVisible, setIsVisible] = useState(!lazy); // If not lazy, start visible\n  const [scriptLoaded, setScriptLoaded] = useState(false);\n\n  // Execute reCAPTCHA and store token\n  const executeRecaptcha = useCallback(async () => {\n    if (!siteKey) {\n      return;\n    }\n\n    try {\n      if (typeof window !== \"undefined\" && window.grecaptcha) {\n        window.grecaptcha.ready(async () => {\n          try {\n            const token = await window.grecaptcha.execute(siteKey, { action });\n\n            // Store token in hidden input\n            if (tokenInputRef.current) {\n              tokenInputRef.current.value = token;\n            }\n\n            // Call callback if provided\n            if (onTokenGenerated) {\n              onTokenGenerated(token);\n            }\n          } catch (error) {\n            console.error(\"[reCAPTCHA] Error executing reCAPTCHA:\", error);\n            if (onError && error instanceof Error) {\n              onError(error);\n            }\n          }\n        });\n      }\n    } catch (error) {\n      console.error(\"[reCAPTCHA] Error:\", error);\n      if (onError && error instanceof Error) {\n        onError(error);\n      }\n    }\n  }, [siteKey, action, onTokenGenerated, onError]);\n\n  // IntersectionObserver for lazy loading\n  useEffect(() => {\n    if (!lazy || !containerRef.current) return;\n\n    // Fallback to eager loading if IntersectionObserver is not supported\n    // (older browsers, some SSR/test environments)\n    if (typeof IntersectionObserver === \"undefined\") {\n      setIsVisible(true);\n      return;\n    }\n\n    const observer = new IntersectionObserver(\n      ([entry]) => {\n        if (entry.isIntersecting) {\n          setIsVisible(true);\n          observer.disconnect();\n        }\n      },\n      { rootMargin: lazyRootMargin }\n    );\n\n    observer.observe(containerRef.current);\n    return () => observer.disconnect();\n  }, [lazy, lazyRootMargin]);\n\n  // Mark loading flag for non-lazy mode to prevent duplicate loads\n  useEffect(() => {\n    if (!siteKey) return;\n    if (lazy) return; // Only for non-lazy mode\n\n    // Set loading flag before Script component loads\n    if (typeof window !== \"undefined\" && !window.__recaptchaLoaded && !window.__recaptchaLoading) {\n      window.__recaptchaLoading = true;\n      window.__recaptchaCallbacks = window.__recaptchaCallbacks || [];\n    }\n  }, [siteKey, lazy]);\n\n  // Load script when visible (only for lazy mode)\n  useEffect(() => {\n    if (!siteKey) return;\n    if (!lazy) return; // Only use manual loading for lazy mode\n    if (!isVisible) return; // Wait until visible\n\n    const handleLoad = () => {\n      setScriptLoaded(true);\n      executeRecaptcha();\n    };\n\n    const handleError = (error: Error) => {\n      console.error(\"[reCAPTCHA] Failed to load reCAPTCHA script\");\n      if (onError) {\n        onError(error);\n      }\n    };\n\n    loadRecaptchaScript(siteKey, handleLoad, handleError);\n  }, [siteKey, lazy, isVisible, executeRecaptcha, onError]);\n\n  // Set up token refresh interval (tokens expire after 2 minutes)\n  useEffect(() => {\n    // Only set up refresh if script is loaded\n    if (!scriptLoaded) return;\n\n    // Set up refresh interval\n    refreshIntervalRef.current = setInterval(() => {\n      executeRecaptcha();\n    }, refreshInterval);\n\n    // Cleanup interval on unmount\n    return () => {\n      if (refreshIntervalRef.current) {\n        clearInterval(refreshIntervalRef.current);\n      }\n    };\n  }, [scriptLoaded, executeRecaptcha, refreshInterval]);\n\n  // Don't render anything if site key is not configured\n  if (!siteKey) {\n    if (process.env.NODE_ENV === \"development\") {\n      console.warn(\n        \"[reCAPTCHA] Site key not configured. Set NEXT_PUBLIC_RECAPTCHA_SITE_KEY environment variable.\"\n      );\n    }\n    return null;\n  }\n\n  return (\n    <div ref={containerRef} style={{ display: \"contents\" }}>\n      {/* \n        Note: display: contents makes this wrapper transparent to the DOM layout.\n        The wrapper is needed for IntersectionObserver but shouldn't affect form layout.\n        Browser support: https://caniuse.com/css-display-contents\n      */}\n      {/* Hidden input to store the token */}\n      <input\n        ref={tokenInputRef}\n        type=\"hidden\"\n        name={inputName}\n        id={inputId}\n        data-testid=\"recaptcha-token-input\"\n      />\n\n      {/* Load reCAPTCHA script using Next.js Script component for non-lazy mode */}\n      {!lazy && (\n        <Script\n          src={`https://www.google.com/recaptcha/api.js?render=${siteKey}`}\n          strategy=\"afterInteractive\"\n          onLoad={() => {\n            // Mark script as loaded globally for singleton behavior\n            if (typeof window !== \"undefined\") {\n              window.__recaptchaLoaded = true;\n              window.__recaptchaLoading = false;\n              // Flush all queued callbacks from lazy instances\n              window.__recaptchaCallbacks?.forEach((cb) => cb.onLoad());\n              window.__recaptchaCallbacks = [];\n            }\n            setScriptLoaded(true);\n            executeRecaptcha();\n          }}\n          onError={() => {\n            // Mark loading as complete on error\n            if (typeof window !== \"undefined\") {\n              window.__recaptchaLoading = false;\n              // Notify all queued callbacks about the failure\n              const error = new Error(\"Failed to load reCAPTCHA script\");\n              window.__recaptchaCallbacks?.forEach((cb) => cb.onError(error));\n              window.__recaptchaCallbacks = [];\n            }\n            console.error(\"[reCAPTCHA] Failed to load reCAPTCHA script\");\n            if (onError) {\n              onError(new Error(\"Failed to load reCAPTCHA script\"));\n            }\n          }}\n        />\n      )}\n    </div>\n  );\n}\n\nexport default RecaptchaWrapper;\n"]}
+{"version":3,"sources":["../../src/constants/index.ts","../../src/client/index.tsx"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * @module @silverassist/recaptcha/constants\n * @description reCAPTCHA Configuration Constants - Default configuration values\n * for reCAPTCHA v3 integration.\n *\n * @author Miguel Colmenares <me@miguelcolmenares.com>\n * @license Polyform-Noncommercial-1.0.0\n * @version 0.2.1\n * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}\n */\n\nimport type { RecaptchaConfig } from \"../types\";\n\n/**\n * Default score threshold for validation\n * Scores below this value are considered suspicious\n * Range: 0.0 (bot) to 1.0 (human)\n */\nexport const DEFAULT_SCORE_THRESHOLD = 0.5;\n\n/**\n * Token refresh interval in milliseconds\n * reCAPTCHA tokens expire after 2 minutes, so we refresh at 90 seconds\n * to ensure tokens are always valid when forms are submitted\n */\nexport const DEFAULT_TOKEN_REFRESH_INTERVAL = 90000;\n\n/**\n * reCAPTCHA v3 configuration constants\n */\nexport const RECAPTCHA_CONFIG: RecaptchaConfig = {\n  /** Google reCAPTCHA verification endpoint */\n  verifyUrl: \"https://www.google.com/recaptcha/api/siteverify\",\n  /** Default score threshold for validation */\n  defaultScoreThreshold: DEFAULT_SCORE_THRESHOLD,\n  /** Default token refresh interval */\n  tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL,\n} as const;\n","/**\n * @module @silverassist/recaptcha/client\n * @description reCAPTCHA v3 Client Component - Loads the Google reCAPTCHA script\n * and generates tokens automatically. Place inside a form to add invisible spam protection.\n *\n * @author Miguel Colmenares <me@miguelcolmenares.com>\n * @license Polyform-Noncommercial-1.0.0\n * @version 0.2.1\n * @see {@link https://developers.google.com/recaptcha/docs/v3|Google reCAPTCHA v3 Documentation}\n * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}\n */\n\n\"use client\";\n\nimport Script from \"next/script\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { RecaptchaWrapperProps } from \"../types\";\nimport { RECAPTCHA_CONFIG } from \"../constants\";\n\n/**\n * Load reCAPTCHA script manually (singleton pattern)\n * Ensures script is only loaded once globally\n */\nfunction loadRecaptchaScript(\n  siteKey: string,\n  onLoad: () => void,\n  onError: (error: Error) => void\n): void {\n  // Already loaded\n  if (typeof window !== \"undefined\" && window.__recaptchaLoaded) {\n    onLoad();\n    return;\n  }\n\n  // Currently loading - add callbacks\n  if (typeof window !== \"undefined\" && window.__recaptchaLoading) {\n    window.__recaptchaCallbacks = window.__recaptchaCallbacks || [];\n    window.__recaptchaCallbacks.push({ onLoad, onError });\n    return;\n  }\n\n  // Start loading\n  if (typeof window !== \"undefined\") {\n    window.__recaptchaLoading = true;\n    window.__recaptchaCallbacks = [];\n\n    const script = document.createElement(\"script\");\n    script.src = `https://www.google.com/recaptcha/api.js?render=${siteKey}`;\n    script.async = true;\n\n    script.onload = () => {\n      window.__recaptchaLoaded = true;\n      window.__recaptchaLoading = false;\n      onLoad();\n      window.__recaptchaCallbacks?.forEach((cb) => cb.onLoad());\n      window.__recaptchaCallbacks = [];\n    };\n\n    script.onerror = () => {\n      window.__recaptchaLoading = false;\n      const error = new Error(\"Failed to load reCAPTCHA script\");\n      onError(error);\n      // Notify all queued callbacks about the failure\n      window.__recaptchaCallbacks?.forEach((cb) => cb.onError(error));\n      window.__recaptchaCallbacks = [];\n    };\n\n    document.head.appendChild(script);\n  }\n}\n\n/**\n * RecaptchaWrapper - Client component for reCAPTCHA v3 integration\n *\n * Features:\n * - Loads reCAPTCHA script automatically\n * - Generates token when script loads\n * - Refreshes token periodically (tokens expire after 2 minutes)\n * - Stores token in hidden input field for form submission\n * - Graceful fallback when not configured\n * - Lazy loading support to defer script loading until visible\n *\n * @example Basic usage\n * ```tsx\n * <form action={formAction}>\n *   <RecaptchaWrapper action=\"contact_form\" />\n *   <input name=\"email\" type=\"email\" required />\n *   <button type=\"submit\">Submit</button>\n * </form>\n * ```\n *\n * @example Custom input name\n * ```tsx\n * <RecaptchaWrapper\n *   action=\"signup\"\n *   inputName=\"captchaToken\"\n *   inputId=\"signup-captcha\"\n * />\n * ```\n *\n * @example With callbacks\n * ```tsx\n * // IMPORTANT: Memoize callbacks to prevent unnecessary re-renders\n * const handleToken = useCallback((token: string) => {\n *   console.log(\"Token:\", token);\n * }, []);\n *\n * const handleError = useCallback((error: Error) => {\n *   console.error(\"Error:\", error);\n * }, []);\n *\n * <RecaptchaWrapper\n *   action=\"payment\"\n *   onTokenGenerated={handleToken}\n *   onError={handleError}\n * />\n * ```\n *\n * @example Lazy loading for better performance\n * ```tsx\n * <RecaptchaWrapper action=\"contact_form\" lazy />\n * ```\n *\n * @example Lazy loading with custom root margin\n * ```tsx\n * <RecaptchaWrapper action=\"contact_form\" lazy lazyRootMargin=\"400px\" />\n * ```\n */\nexport function RecaptchaWrapper({\n  action,\n  inputName = \"recaptchaToken\",\n  inputId = \"recaptcha-token\",\n  siteKey: propSiteKey,\n  refreshInterval = RECAPTCHA_CONFIG.tokenRefreshInterval,\n  onTokenGenerated,\n  onError,\n  lazy = false,\n  lazyRootMargin = \"200px\",\n}: RecaptchaWrapperProps) {\n  // Use prop siteKey or fall back to environment variable\n  const siteKey = propSiteKey ?? process.env.NEXT_PUBLIC_RECAPTCHA_SITE_KEY;\n  const tokenInputRef = useRef<HTMLInputElement>(null);\n  const refreshIntervalRef = useRef<NodeJS.Timeout | null>(null);\n  const containerRef = useRef<HTMLDivElement>(null);\n  const isMountedRef = useRef<boolean>(true);\n  const [isVisible, setIsVisible] = useState(!lazy); // If not lazy, start visible\n  const [scriptLoaded, setScriptLoaded] = useState(false);\n\n  // Execute reCAPTCHA and store token\n  const executeRecaptcha = useCallback(async () => {\n    if (!siteKey) {\n      return;\n    }\n\n    try {\n      // Wait for grecaptcha to be available (with timeout)\n      // This handles the race condition where the script loads but\n      // window.grecaptcha is not immediately available\n      const waitForGrecaptcha = async (maxAttempts = 20, delayMs = 100): Promise<boolean> => {\n        for (let i = 0; i < maxAttempts; i++) {\n          // Check if component is still mounted\n          if (!isMountedRef.current) {\n            return false;\n          }\n          \n          if (typeof window !== \"undefined\" && window.grecaptcha) {\n            return true;\n          }\n          await new Promise((resolve) => setTimeout(resolve, delayMs));\n        }\n        return false;\n      };\n\n      const grecaptchaAvailable = await waitForGrecaptcha();\n\n      // Exit early if component unmounted during polling\n      if (!isMountedRef.current || !grecaptchaAvailable) {\n        return;\n      }\n\n      window.grecaptcha.ready(async () => {\n        // Check if still mounted before executing\n        if (!isMountedRef.current) {\n          return;\n        }\n\n        try {\n          const token = await window.grecaptcha.execute(siteKey, { action });\n\n          // Check if still mounted before storing token\n          if (!isMountedRef.current) {\n            return;\n          }\n\n          // Store token in hidden input\n          if (tokenInputRef.current) {\n            tokenInputRef.current.value = token;\n          }\n\n          // Call callback if provided\n          if (onTokenGenerated) {\n            onTokenGenerated(token);\n          }\n        } catch (error) {\n          console.error(\"[reCAPTCHA] Error executing reCAPTCHA:\", error);\n          if (onError && error instanceof Error) {\n            onError(error);\n          }\n        }\n      });\n    } catch (error) {\n      console.error(\"[reCAPTCHA] Error:\", error);\n      if (onError && error instanceof Error) {\n        onError(error);\n      }\n    }\n  }, [siteKey, action, onTokenGenerated, onError]);\n\n  // IntersectionObserver for lazy loading\n  useEffect(() => {\n    if (!lazy || !containerRef.current) return;\n\n    // Fallback to eager loading if IntersectionObserver is not supported\n    // (older browsers, some SSR/test environments)\n    if (typeof IntersectionObserver === \"undefined\") {\n      setIsVisible(true);\n      return;\n    }\n\n    const observer = new IntersectionObserver(\n      ([entry]) => {\n        if (entry.isIntersecting) {\n          setIsVisible(true);\n          observer.disconnect();\n        }\n      },\n      { rootMargin: lazyRootMargin }\n    );\n\n    observer.observe(containerRef.current);\n    return () => observer.disconnect();\n  }, [lazy, lazyRootMargin]);\n\n  // Mark loading flag for non-lazy mode to prevent duplicate loads\n  useEffect(() => {\n    if (!siteKey) return;\n    if (lazy) return; // Only for non-lazy mode\n\n    // Set loading flag before Script component loads\n    if (typeof window !== \"undefined\" && !window.__recaptchaLoaded && !window.__recaptchaLoading) {\n      window.__recaptchaLoading = true;\n      window.__recaptchaCallbacks = window.__recaptchaCallbacks || [];\n    }\n  }, [siteKey, lazy]);\n\n  // Load script when visible (only for lazy mode)\n  useEffect(() => {\n    if (!siteKey) return;\n    if (!lazy) return; // Only use manual loading for lazy mode\n    if (!isVisible) return; // Wait until visible\n\n    const handleLoad = () => {\n      setScriptLoaded(true);\n      executeRecaptcha();\n    };\n\n    const handleError = (error: Error) => {\n      console.error(\"[reCAPTCHA] Failed to load reCAPTCHA script\");\n      if (onError) {\n        onError(error);\n      }\n    };\n\n    loadRecaptchaScript(siteKey, handleLoad, handleError);\n  }, [siteKey, lazy, isVisible, executeRecaptcha, onError]);\n\n  // Set up token refresh interval (tokens expire after 2 minutes)\n  useEffect(() => {\n    // Only set up refresh if script is loaded\n    if (!scriptLoaded) return;\n\n    // Set up refresh interval\n    refreshIntervalRef.current = setInterval(() => {\n      executeRecaptcha();\n    }, refreshInterval);\n\n    // Cleanup interval on unmount\n    return () => {\n      if (refreshIntervalRef.current) {\n        clearInterval(refreshIntervalRef.current);\n      }\n    };\n  }, [scriptLoaded, executeRecaptcha, refreshInterval]);\n\n  // Track mounted state to prevent side effects after unmount\n  useEffect(() => {\n    isMountedRef.current = true;\n    \n    return () => {\n      isMountedRef.current = false;\n    };\n  }, []);\n\n  // Don't render anything if site key is not configured\n  if (!siteKey) {\n    if (process.env.NODE_ENV === \"development\") {\n      console.warn(\n        \"[reCAPTCHA] Site key not configured. Set NEXT_PUBLIC_RECAPTCHA_SITE_KEY environment variable.\"\n      );\n    }\n    return null;\n  }\n\n  return (\n    <div ref={containerRef} style={{ display: \"contents\" }}>\n      {/* \n        Note: display: contents makes this wrapper transparent to the DOM layout.\n        The wrapper is needed for IntersectionObserver but shouldn't affect form layout.\n        Browser support: https://caniuse.com/css-display-contents\n      */}\n      {/* Hidden input to store the token */}\n      <input\n        ref={tokenInputRef}\n        type=\"hidden\"\n        name={inputName}\n        id={inputId}\n        data-testid=\"recaptcha-token-input\"\n      />\n\n      {/* Load reCAPTCHA script using Next.js Script component for non-lazy mode */}\n      {!lazy && (\n        <Script\n          src={`https://www.google.com/recaptcha/api.js?render=${siteKey}`}\n          strategy=\"afterInteractive\"\n          onLoad={() => {\n            // Mark script as loaded globally for singleton behavior\n            if (typeof window !== \"undefined\") {\n              window.__recaptchaLoaded = true;\n              window.__recaptchaLoading = false;\n              // Flush all queued callbacks from lazy instances\n              window.__recaptchaCallbacks?.forEach((cb) => cb.onLoad());\n              window.__recaptchaCallbacks = [];\n            }\n            setScriptLoaded(true);\n            executeRecaptcha();\n          }}\n          onError={() => {\n            // Mark loading as complete on error\n            if (typeof window !== \"undefined\") {\n              window.__recaptchaLoading = false;\n              // Notify all queued callbacks about the failure\n              const error = new Error(\"Failed to load reCAPTCHA script\");\n              window.__recaptchaCallbacks?.forEach((cb) => cb.onError(error));\n              window.__recaptchaCallbacks = [];\n            }\n            console.error(\"[reCAPTCHA] Failed to load reCAPTCHA script\");\n            if (onError) {\n              onError(new Error(\"Failed to load reCAPTCHA script\"));\n            }\n          }}\n        />\n      )}\n    </div>\n  );\n}\n\nexport default RecaptchaWrapper;\n"]}

package/dist/constants/index.d.mts

@@ -1,11 +1,14 @@
 import { RecaptchaConfig } from '../types/index.mjs';
 
 /**
- * reCAPTCHA Configuration Constants
+ * @module @silverassist/recaptcha/constants
+ * @description reCAPTCHA Configuration Constants - Default configuration values
+ * for reCAPTCHA v3 integration.
  *
- * Default configuration values for reCAPTCHA v3 integration.
- *
- * @packageDocumentation
+ * @author Miguel Colmenares <me@miguelcolmenares.com>
+ * @license Polyform-Noncommercial-1.0.0
+ * @version 0.2.1
+ * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}
  */
 
 /**

package/dist/constants/index.d.ts

@@ -1,11 +1,14 @@
 import { RecaptchaConfig } from '../types/index.js';
 
 /**
- * reCAPTCHA Configuration Constants
+ * @module @silverassist/recaptcha/constants
+ * @description reCAPTCHA Configuration Constants - Default configuration values
+ * for reCAPTCHA v3 integration.
  *
- * Default configuration values for reCAPTCHA v3 integration.
- *
- * @packageDocumentation
+ * @author Miguel Colmenares <me@miguelcolmenares.com>
+ * @license Polyform-Noncommercial-1.0.0
+ * @version 0.2.1
+ * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}
  */
 
 /**

package/dist/constants/index.js

@@ -11,6 +11,16 @@ var RECAPTCHA_CONFIG = {
   /** Default token refresh interval */
   tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL
 };
+/**
+ * @module @silverassist/recaptcha/constants
+ * @description reCAPTCHA Configuration Constants - Default configuration values
+ * for reCAPTCHA v3 integration.
+ *
+ * @author Miguel Colmenares <me@miguelcolmenares.com>
+ * @license Polyform-Noncommercial-1.0.0
+ * @version 0.2.1
+ * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}
+ */
 
 exports.DEFAULT_SCORE_THRESHOLD = DEFAULT_SCORE_THRESHOLD;
 exports.DEFAULT_TOKEN_REFRESH_INTERVAL = DEFAULT_TOKEN_REFRESH_INTERVAL;

package/dist/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants/index.ts"],"names":[],"mappings":";;;AAeO,IAAM,uBAAA,GAA0B;AAOhC,IAAM,8BAAA,GAAiC;AAKvC,IAAM,gBAAA,GAAoC;AAAA;AAAA,EAE/C,SAAA,EAAW,iDAAA;AAAA;AAAA,EAEX,qBAAA,EAAuB,uBAAA;AAAA;AAAA,EAEvB,oBAAA,EAAsB;AACxB","file":"index.js","sourcesContent":["/**\n * reCAPTCHA Configuration Constants\n *\n * Default configuration values for reCAPTCHA v3 integration.\n *\n * @packageDocumentation\n */\n\nimport type { RecaptchaConfig } from \"../types\";\n\n/**\n * Default score threshold for validation\n * Scores below this value are considered suspicious\n * Range: 0.0 (bot) to 1.0 (human)\n */\nexport const DEFAULT_SCORE_THRESHOLD = 0.5;\n\n/**\n * Token refresh interval in milliseconds\n * reCAPTCHA tokens expire after 2 minutes, so we refresh at 90 seconds\n * to ensure tokens are always valid when forms are submitted\n */\nexport const DEFAULT_TOKEN_REFRESH_INTERVAL = 90000;\n\n/**\n * reCAPTCHA v3 configuration constants\n */\nexport const RECAPTCHA_CONFIG: RecaptchaConfig = {\n  /** Google reCAPTCHA verification endpoint */\n  verifyUrl: \"https://www.google.com/recaptcha/api/siteverify\",\n  /** Default score threshold for validation */\n  defaultScoreThreshold: DEFAULT_SCORE_THRESHOLD,\n  /** Default token refresh interval */\n  tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL,\n} as const;\n"]}
+{"version":3,"sources":["../../src/constants/index.ts"],"names":[],"mappings":";;;AAkBO,IAAM,uBAAA,GAA0B;AAOhC,IAAM,8BAAA,GAAiC;AAKvC,IAAM,gBAAA,GAAoC;AAAA;AAAA,EAE/C,SAAA,EAAW,iDAAA;AAAA;AAAA,EAEX,qBAAA,EAAuB,uBAAA;AAAA;AAAA,EAEvB,oBAAA,EAAsB;AACxB","file":"index.js","sourcesContent":["/**\n * @module @silverassist/recaptcha/constants\n * @description reCAPTCHA Configuration Constants - Default configuration values\n * for reCAPTCHA v3 integration.\n *\n * @author Miguel Colmenares <me@miguelcolmenares.com>\n * @license Polyform-Noncommercial-1.0.0\n * @version 0.2.1\n * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}\n */\n\nimport type { RecaptchaConfig } from \"../types\";\n\n/**\n * Default score threshold for validation\n * Scores below this value are considered suspicious\n * Range: 0.0 (bot) to 1.0 (human)\n */\nexport const DEFAULT_SCORE_THRESHOLD = 0.5;\n\n/**\n * Token refresh interval in milliseconds\n * reCAPTCHA tokens expire after 2 minutes, so we refresh at 90 seconds\n * to ensure tokens are always valid when forms are submitted\n */\nexport const DEFAULT_TOKEN_REFRESH_INTERVAL = 90000;\n\n/**\n * reCAPTCHA v3 configuration constants\n */\nexport const RECAPTCHA_CONFIG: RecaptchaConfig = {\n  /** Google reCAPTCHA verification endpoint */\n  verifyUrl: \"https://www.google.com/recaptcha/api/siteverify\",\n  /** Default score threshold for validation */\n  defaultScoreThreshold: DEFAULT_SCORE_THRESHOLD,\n  /** Default token refresh interval */\n  tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL,\n} as const;\n"]}

package/dist/constants/index.mjs

@@ -9,6 +9,16 @@ var RECAPTCHA_CONFIG = {
   /** Default token refresh interval */
   tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL
 };
+/**
+ * @module @silverassist/recaptcha/constants
+ * @description reCAPTCHA Configuration Constants - Default configuration values
+ * for reCAPTCHA v3 integration.
+ *
+ * @author Miguel Colmenares <me@miguelcolmenares.com>
+ * @license Polyform-Noncommercial-1.0.0
+ * @version 0.2.1
+ * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}
+ */
 
 export { DEFAULT_SCORE_THRESHOLD, DEFAULT_TOKEN_REFRESH_INTERVAL, RECAPTCHA_CONFIG };
 //# sourceMappingURL=index.mjs.map

package/dist/constants/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants/index.ts"],"names":[],"mappings":";AAeO,IAAM,uBAAA,GAA0B;AAOhC,IAAM,8BAAA,GAAiC;AAKvC,IAAM,gBAAA,GAAoC;AAAA;AAAA,EAE/C,SAAA,EAAW,iDAAA;AAAA;AAAA,EAEX,qBAAA,EAAuB,uBAAA;AAAA;AAAA,EAEvB,oBAAA,EAAsB;AACxB","file":"index.mjs","sourcesContent":["/**\n * reCAPTCHA Configuration Constants\n *\n * Default configuration values for reCAPTCHA v3 integration.\n *\n * @packageDocumentation\n */\n\nimport type { RecaptchaConfig } from \"../types\";\n\n/**\n * Default score threshold for validation\n * Scores below this value are considered suspicious\n * Range: 0.0 (bot) to 1.0 (human)\n */\nexport const DEFAULT_SCORE_THRESHOLD = 0.5;\n\n/**\n * Token refresh interval in milliseconds\n * reCAPTCHA tokens expire after 2 minutes, so we refresh at 90 seconds\n * to ensure tokens are always valid when forms are submitted\n */\nexport const DEFAULT_TOKEN_REFRESH_INTERVAL = 90000;\n\n/**\n * reCAPTCHA v3 configuration constants\n */\nexport const RECAPTCHA_CONFIG: RecaptchaConfig = {\n  /** Google reCAPTCHA verification endpoint */\n  verifyUrl: \"https://www.google.com/recaptcha/api/siteverify\",\n  /** Default score threshold for validation */\n  defaultScoreThreshold: DEFAULT_SCORE_THRESHOLD,\n  /** Default token refresh interval */\n  tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL,\n} as const;\n"]}
+{"version":3,"sources":["../../src/constants/index.ts"],"names":[],"mappings":";AAkBO,IAAM,uBAAA,GAA0B;AAOhC,IAAM,8BAAA,GAAiC;AAKvC,IAAM,gBAAA,GAAoC;AAAA;AAAA,EAE/C,SAAA,EAAW,iDAAA;AAAA;AAAA,EAEX,qBAAA,EAAuB,uBAAA;AAAA;AAAA,EAEvB,oBAAA,EAAsB;AACxB","file":"index.mjs","sourcesContent":["/**\n * @module @silverassist/recaptcha/constants\n * @description reCAPTCHA Configuration Constants - Default configuration values\n * for reCAPTCHA v3 integration.\n *\n * @author Miguel Colmenares <me@miguelcolmenares.com>\n * @license Polyform-Noncommercial-1.0.0\n * @version 0.2.1\n * @see {@link https://github.com/SilverAssist/recaptcha|GitHub Repository}\n */\n\nimport type { RecaptchaConfig } from \"../types\";\n\n/**\n * Default score threshold for validation\n * Scores below this value are considered suspicious\n * Range: 0.0 (bot) to 1.0 (human)\n */\nexport const DEFAULT_SCORE_THRESHOLD = 0.5;\n\n/**\n * Token refresh interval in milliseconds\n * reCAPTCHA tokens expire after 2 minutes, so we refresh at 90 seconds\n * to ensure tokens are always valid when forms are submitted\n */\nexport const DEFAULT_TOKEN_REFRESH_INTERVAL = 90000;\n\n/**\n * reCAPTCHA v3 configuration constants\n */\nexport const RECAPTCHA_CONFIG: RecaptchaConfig = {\n  /** Google reCAPTCHA verification endpoint */\n  verifyUrl: \"https://www.google.com/recaptcha/api/siteverify\",\n  /** Default score threshold for validation */\n  defaultScoreThreshold: DEFAULT_SCORE_THRESHOLD,\n  /** Default token refresh interval */\n  tokenRefreshInterval: DEFAULT_TOKEN_REFRESH_INTERVAL,\n} as const;\n"]}