waf-captcha-frontend 0.0.5

package/README.md

@@ -0,0 +1,283 @@
+# AWS WAF Captcha Interceptor
+
+## Overview
+
+AWS WAF Captcha Interceptor is a lightweight JavaScript/TypeScript library that provides seamless integration with AWS WAF Captcha for fetch-based HTTP requests. The package handles captcha challenges transparently, intercepting requests and displaying captcha modals when required by AWS WAF.
+
+## Installation
+
+```bash
+npm install aws-waf-captcha-interceptor
+# or
+yarn add aws-waf-captcha-interceptor
+```
+
+## Prerequisites
+
+Before using this package, ensure you have AWS WAF configured with CAPTCHA rules
+
+## Quick Start
+
+```typescript
+import { createCaptchaInterceptor } from 'aws-waf-captcha-interceptor';
+
+// Initialize the interceptor
+const captchaFetch = createCaptchaInterceptor({
+  API_KEY: 'your-api-key',
+  JSAPI_URL: 'https://your-domain.aws.captcha.jsapi',
+  captchaContainerId: 'captcha-container',
+});
+
+// Use it like regular fetch
+const response = await captchaFetch('/api/protected-endpoint', {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+  },
+  body: JSON.stringify({ data: 'example' }),
+});
+```
+
+## Configuration
+
+The package accepts the following configuration object:
+
+```typescript
+export interface AWSWAFInterceptorConfig {
+  // Required: API credentials
+  API_KEY: string;
+  JSAPI_URL: string;
+  
+  // Event handlers
+  onSuccess?: () => void;
+  onLoad?: () => void;
+  onError?: (err: string) => void;
+  onPuzzleTimeout?: () => void;
+  onPuzzleIncorrect?: () => void;
+  onPuzzleCorrect?: () => void;
+  
+  // Container IDs for DOM injection
+  captchaContainerId: string;      // Main container for captcha modal
+  captchaContentId?: string;       // Container for captcha form
+  overlayId?: string;             // Overlay element ID
+  modalId?: string;               // Modal container ID
+}
+```
+
+### Default Values
+
+If containers IDs not provided, the package will use these default IDs:
+- `captchaContentId`: `'captcha-content'`
+- `overlayId`: `'captcha-overlay'`
+- `modalId`: `'captcha-modal'`
+
+## Usage
+
+### Basic Implementation
+
+```typescript
+import { createCaptchaInterceptor } from 'aws-waf-captcha-interceptor';
+
+const config = {
+  API_KEY: 'your-api-key',
+  JSAPI_URL: 'https://your-domain.aws.captcha.jsapi',
+  captchaContainerId: 'aws-captcha-container',
+  
+  // Optional event handlers
+  onSuccess: () => console.log('Captcha solved successfully'),
+  onError: (err) => console.error('Captcha error:', err),
+  onPuzzleTimeout: () => console.error('Captcha puzzle timed out'),
+};
+
+const captchaFetch = createCaptchaInterceptor(config);
+
+// Make authenticated requests
+async function fetchProtectedData() {
+  try {
+    const data = await captchaFetch('/api/data', {
+      method: 'GET',
+      credentials: 'include',
+    });
+    return data;
+  } catch (error) {
+    console.error('Request failed:', error);
+    throw error;
+  }
+}
+```
+
+### React Example
+
+```tsx
+import React, { useEffect } from 'react';
+import { createCaptchaInterceptor } from 'aws-waf-captcha-interceptor';
+
+const App = () => {
+  useEffect(() => {
+    // Initialize once when component mounts
+    const captchaFetch = createCaptchaInterceptor({
+        API_KEY: 'your-aws-api-key',
+        JSAPI_URL: 'https://your-domain.aws.captcha.jsapi',
+        captchaContainerId: 'captcha-root',
+    });
+    
+    // Store in context or make globally available
+    window.captchaFetch = captchaFetch;
+  }, []);
+  
+  const handleSubmit = async () => {
+    try {
+      const response = await window.captchaFetch('/api/submit', {
+        method: 'POST',
+        body: JSON.stringify({ formData: 'test' }),
+      });
+      console.log('Success:', response);
+    } catch (error) {
+      console.error('Failed:', error);
+    }
+  };
+  
+  return (
+    <div>
+      {/* Container for captcha - must exist in DOM */}
+      <div id="captcha-root" />
+      <button onClick={handleSubmit}>Submit</button>
+    </div>
+  );
+};
+```
+
+### Advanced Configuration with All Options
+
+```typescript
+const advancedConfig = {
+  API_KEY: 'your-aws-api-key',
+  JSAPI_URL: 'https://your-domain.aws.captcha.jsapi',
+  
+  // Custom container IDs
+  captchaContainerId: 'captcha-root-container',
+  captchaContentId: 'custom-captcha-content',
+  overlayId: 'custom-overlay',
+  modalId: 'custom-modal',
+  
+  // Event handlers
+  onLoad: () => {
+    console.log('Captcha library loaded');
+  },
+  onSuccess: () => {
+    console.log('Captcha verification successful');
+  },
+  onError: (errorMessage) => {
+    console.error('Captcha error:', errorMessage);
+  },
+  onPuzzleTimeout: () => {
+    console.warn('User took too long to solve captcha');
+  },
+  onPuzzleIncorrect: () => {
+    console.log('Incorrect captcha solution');
+  },
+  onPuzzleCorrect: () => {
+    console.log('Captcha solved correctly');
+  },
+};
+
+const captchaFetch = createCaptchaInterceptor(advancedConfig);
+```
+
+## API Reference
+
+### `createCaptchaInterceptor(config: AWSWAFInterceptorConfig)`
+
+Creates and returns a fetch wrapper function that automatically handles AWS WAF captcha challenges.
+
+**Parameters:**
+- `config`: Configuration object as defined in `AWSWAFInterceptorConfig`
+
+**Returns:**
+- A function with the same signature as `fetch()`, but with automatic captcha handling.
+
+### The Wrapped Fetch Function
+
+The returned function has the following signature:
+
+```typescript
+(input: RequestInfo | URL, init?: RequestInit): Promise<Response>
+```
+
+It behaves exactly like the native `fetch` API, but will automatically:
+1. Detect when AWS WAF requires a captcha challenge
+2. Display the captcha modal when needed
+3. Retry the original request after successful captcha completion
+4. Pass through all response data transparently
+
+## How It Works
+
+1. **Initialization**: The interceptor is created with your AWS WAF configuration
+2. **Request Interception**: When you make a fetch request, the interceptor checks if AWS WAF returns a captcha challenge
+3. **Modal Display**: If a captcha is required, a modal is automatically injected into your specified container
+4. **User Interaction**: Users solve the captcha puzzle in the modal
+5. **Request Retry**: After successful captcha completion, the original request is retried with the captcha token
+6. **Transparent Response**: You receive the API response as if no captcha interruption occurred
+
+For more details check the WAF documentation: https://aws.amazon.com/ru/blogs/networking-and-content-delivery/optimizing-web-application-user-experiences-with-aws-waf-javascript-integrations/. Now realized only the Scenario 5.
+
+## Error Handling
+
+The interceptor will throw errors in these cases:
+- AWS WAF configuration is incorrect
+- Captcha cannot be displayed (missing container, etc.)
+- User fails to solve captcha within allowed attempts
+- Network errors during the request
+
+## DOM Requirements
+
+The package requires certain DOM elements to exist or will create them automatically:
+
+```html
+<!-- The container you specify in config must exist -->
+<div id="your-captcha-container-id">
+  <!-- The following elements will be created automatically if not present -->
+  <!-- <div id="captcha-overlay"> -->
+  <!--   <div id="captcha-modal"> -->
+  <!--     <div id="captcha-content"></div> -->
+  <!--   </div> -->
+  <!-- </div> -->
+</div>
+```
+
+## TypeScript Support
+
+The package includes full TypeScript definitions. No additional `@types` package is required.
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/your-org/aws-waf-captcha-interceptor.git
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+```
+
+## Future Roadmap
+
+- [ ] Axios interceptor support
+- [ ] Additional WAF captcha scenarios
+- [ ] Custom UI theming options
+
+## Security
+
+This package handles sensitive operations. Ensure you:
+- Keep your API keys secure
+- Use HTTPS for all requests
+- Follow AWS WAF security best practices
+
+---
+
+**Note**: This package currently only supports fetch-based requests. Axios support is planned for future releases.

package/dist/bundle.cjs.js

@@ -0,0 +1,2 @@
+"use strict";const n=(n,e="captchaForm")=>{var t;let o=document.getElementById(e);const l=null!==(t=document.getElementById(n))&&void 0!==t?t:document.body;return o||(o=document.createElement("div"),o.id=e,l.appendChild(o)),o},e=(e,t,o,l)=>{const{overlay:a,modal:d}=((n,e="modalOverlay",t="modal")=>{var o;const l=null!==(o=document.getElementById(n))&&void 0!==o?o:document.body;let a=document.getElementById(e),d=document.getElementById(t);return a||(a=document.createElement("div"),a.id="modalOverlay",a.style.cssText="\n      position: fixed;\n      top: 0;\n      left: 0;\n      width: 100%;\n      height: 100%;\n      background: rgba(0,0,0,0.5);\n      display: none;\n      z-index: 9999;\n      align-items: center;\n      justify-content: center;\n    ",l.appendChild(a)),d||(d=document.createElement("div"),d.id="modal",d.style.cssText="\n      background: white;\n      padding: 20px;\n      border-radius: 8px;\n      min-width: 300px;\n    ",a.appendChild(d)),{overlay:a,modal:d}})(e,o,l),r=n(e,t);r.parentElement!==d&&d.appendChild(r),a.style.display="flex"},t="AwsWAFScript";exports.createCaptchaFetchHandler=o=>{!function(n){if(!n.API_KEY)throw new Error("API_KEY is not set");if(!n.JSAPI_URL)throw new Error("JSAPI_URL is not set");if(!n.captchaContainerId)throw new Error("the captcha container Id is not set")}(o),function(n){if(document.getElementById(t)||!n)return;const e=document.createElement("script");e.id=t,e.async=!1,e.src=n,document.head.appendChild(e)}(o.JSAPI_URL);return(t,l)=>{const a=n(o.captchaContainerId,null==o?void 0:o.captchaContentId);return e(o.captchaContainerId,null==o?void 0:o.captchaContentId,null==o?void 0:o.overlayId,null==o?void 0:o.modalId),new Promise((n,e)=>{window.AwsWafCaptcha?window.AwsWafIntegration?window.AwsWafCaptcha.renderCaptcha(a,{onSuccess:()=>{var e;((n="modalOverlay")=>{const e=document.getElementById(n);e&&(e.style.display="none")})(null==o?void 0:o.overlayId),null===(e=null==o?void 0:o.onSuccess)||void 0===e||e.call(o),n(window.AwsWafIntegration.fetch(t,l))},onLoad:()=>{var n;null===(n=null==o?void 0:o.onLoad)||void 0===n||n.call(o)},onError:n=>{var t;null===(t=null==o?void 0:o.onError)||void 0===t||t.call(o,n),e(n)},onPuzzleTimeout:()=>{var n;null===(n=null==o?void 0:o.onError)||void 0===n||n.call(o,"CAPTCHA timeout"),e(new Error("CAPTCHA timeout"))},onPuzzleIncorrect:()=>{var n;null===(n=null==o?void 0:o.onPuzzleIncorrect)||void 0===n||n.call(o)},onPuzzleCorrect:()=>{var n;null===(n=null==o?void 0:o.onPuzzleCorrect)||void 0===n||n.call(o)},apiKey:o.API_KEY}):e(new Error("AwsWafIntegration is not available")):e(new Error("AwsWafCaptcha is not available"))})}};
+//# sourceMappingURL=bundle.cjs.js.map

package/dist/bundle.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.cjs.js","sources":["../src/utils/modalUtils.ts","../src/utils/WAFScriptUtils.ts","../src/createCaptchaFetchHandler.ts"],"sourcesContent":[null,null,null],"names":["ensureCaptchaContainer","captchaContainerId","captchaContentId","container","document","getElementById","captchaContainer","_a","body","createElement","id","appendChild","showCaptchaModal","overlayId","modalId","overlay","modal","style","cssText","ensureModalContainer","captchaForm","parentElement","display","WAF_SCRIPT_ID","config","API_KEY","Error","JSAPI_URL","checkWAFconfig","AwsWafScript","async","src","head","loadCaptchaScript","path","init","Promise","resolve","reject","window","AwsWafCaptcha","AwsWafIntegration","renderCaptcha","onSuccess","hideCaptchaModal","fetch","onLoad","onError","error","call","onPuzzleTimeout","onPuzzleIncorrect","onPuzzleCorrect","apiKey"],"mappings":"aAAO,MAAMA,EAAyB,CAACC,EAA4BC,EAA2B,uBAC5F,IAAIC,EAAYC,SAASC,eAAeH,GACxC,MAAMI,EAA8D,QAA3CC,EAAAH,SAASC,eAAeJ,UAAmB,IAAAM,EAAAA,EAAIH,SAASI,KAQjF,OANKL,IACHA,EAAYC,SAASK,cAAc,OACnCN,EAAUO,GAAKR,EACfI,EAAiBK,YAAYR,IAGxBA,GAyCIS,EAAmB,CAC9BX,EACAC,EACAW,EACAC,KAEA,MAAMC,QAAEA,EAAOC,MAAEA,GA5CiB,EAACf,EAA4BY,EAAY,eAAgBC,EAAU,iBACrG,MAAMR,EAA8D,QAA3CC,EAAAH,SAASC,eAAeJ,UAAmB,IAAAM,EAAAA,EAAIH,SAASI,KACjF,IAAIO,EAAUX,SAASC,eAAeQ,GAClCG,EAAQZ,SAASC,eAAeS,GAgCpC,OA9BKC,IACHA,EAAUX,SAASK,cAAc,OACjCM,EAAQL,GAAK,eACbK,EAAQE,MAAMC,QAAU,qPAYxBZ,EAAiBK,YAAYI,IAG1BC,IACHA,EAAQZ,SAASK,cAAc,OAC/BO,EAAMN,GAAK,QACXM,EAAMC,MAAMC,QAAU,6GAMtBH,EAAQJ,YAAYK,IAGf,CAAED,UAASC,UASSG,CAAqBlB,EAAoBY,EAAWC,GACzEM,EAAcpB,EAAuBC,EAAoBC,GAE3DkB,EAAYC,gBAAkBL,GAChCA,EAAML,YAAYS,GAGpBL,EAAQE,MAAMK,QAAU,QC9DbC,EAAgB,iDCEaC,KDApC,SAAyBA,GAC7B,IAAKA,EAAOC,QACV,MAAM,IAAIC,MAAM,sBAGlB,IAAKF,EAAOG,UACV,MAAM,IAAID,MAAM,wBAGlB,IAAKF,EAAOvB,mBACV,MAAM,IAAIyB,MAAM,sCAEpB,CCXEE,CAAeJ,GDaX,SAA4BG,GAChC,GAAIvB,SAASC,eAAekB,KAAmBI,EAAW,OAC1D,MAAME,EAAezB,SAASK,cAAc,UAC5CoB,EAAanB,GAAKa,EAClBM,EAAaC,OAAQ,EACrBD,EAAaE,IAAMJ,EACnBvB,SAAS4B,KAAKrB,YAAYkB,EAC5B,CCnBEI,CAAkBT,EAAOG,WAkDzB,MAhDqB,CAACO,EAAyBC,KAC7C,MAAMf,EAAcpB,EAAuBwB,EAAOvB,mBAAoBuB,eAAAA,EAAQtB,kBAQ9E,OAPAU,EACEY,EAAOvB,mBACPuB,aAAM,EAANA,EAAQtB,iBACRsB,aAAM,EAANA,EAAQX,UACRW,eAAAA,EAAQV,SAGH,IAAIsB,QAAQ,CAACC,EAASC,KACtBC,OAAOC,cAKPD,OAAOE,kBAKZF,OAAOC,cAAcE,cAActB,EAAa,CAC9CuB,UAAW,WFsCa,EAAC9B,EAAoB,kBACnD,MAAME,EAAUX,SAASC,eAAeQ,GACpCE,IACFA,EAAQE,MAAMK,QAAU,SExClBsB,CAAiBpB,eAAAA,EAAQX,mBACzBN,EAAAiB,aAAM,EAANA,EAAQmB,kCACRN,EAAQE,OAAOE,kBAAkBI,MAAMX,EAAMC,KAE/CW,OAAQ,mBACNvC,EAAAiB,aAAM,EAANA,EAAQsB,gCAEVC,QAAUC,UACO,QAAfzC,EAAAiB,aAAM,EAANA,EAAQuB,eAAO,IAAAxC,GAAAA,EAAA0C,KAAAzB,EAAGwB,GAClBV,EAAOU,IAETE,gBAAiB,WACA,QAAf3C,EAAAiB,aAAM,EAANA,EAAQuB,eAAO,IAAAxC,GAAAA,EAAA0C,KAAAzB,EAAG,mBAClBc,EAAO,IAAIZ,MAAM,qBAEnByB,kBAAmB,mBACjB5C,EAAAiB,aAAM,EAANA,EAAQ2B,2CAEVC,gBAAiB,mBACf7C,EAAAiB,aAAM,EAANA,EAAQ4B,yCAEVC,OAAQ7B,EAAOC,UA3Bfa,EAAO,IAAIZ,MAAM,uCALjBY,EAAO,IAAIZ,MAAM"}

package/dist/bundle.esm.js

@@ -0,0 +1,2 @@
+const n=(n,e="captchaForm")=>{var t;let o=document.getElementById(e);const l=null!==(t=document.getElementById(n))&&void 0!==t?t:document.body;return o||(o=document.createElement("div"),o.id=e,l.appendChild(o)),o},e=(e,t,o,l)=>{const{overlay:d,modal:a}=((n,e="modalOverlay",t="modal")=>{var o;const l=null!==(o=document.getElementById(n))&&void 0!==o?o:document.body;let d=document.getElementById(e),a=document.getElementById(t);return d||(d=document.createElement("div"),d.id="modalOverlay",d.style.cssText="\n      position: fixed;\n      top: 0;\n      left: 0;\n      width: 100%;\n      height: 100%;\n      background: rgba(0,0,0,0.5);\n      display: none;\n      z-index: 9999;\n      align-items: center;\n      justify-content: center;\n    ",l.appendChild(d)),a||(a=document.createElement("div"),a.id="modal",a.style.cssText="\n      background: white;\n      padding: 20px;\n      border-radius: 8px;\n      min-width: 300px;\n    ",d.appendChild(a)),{overlay:d,modal:a}})(e,o,l),r=n(e,t);r.parentElement!==a&&a.appendChild(r),d.style.display="flex"},t="AwsWAFScript";const o=o=>{!function(n){if(!n.API_KEY)throw new Error("API_KEY is not set");if(!n.JSAPI_URL)throw new Error("JSAPI_URL is not set");if(!n.captchaContainerId)throw new Error("the captcha container Id is not set")}(o),function(n){if(document.getElementById(t)||!n)return;const e=document.createElement("script");e.id=t,e.async=!1,e.src=n,document.head.appendChild(e)}(o.JSAPI_URL);return(t,l)=>{const d=n(o.captchaContainerId,null==o?void 0:o.captchaContentId);return e(o.captchaContainerId,null==o?void 0:o.captchaContentId,null==o?void 0:o.overlayId,null==o?void 0:o.modalId),new Promise((n,e)=>{window.AwsWafCaptcha?window.AwsWafIntegration?window.AwsWafCaptcha.renderCaptcha(d,{onSuccess:()=>{var e;((n="modalOverlay")=>{const e=document.getElementById(n);e&&(e.style.display="none")})(null==o?void 0:o.overlayId),null===(e=null==o?void 0:o.onSuccess)||void 0===e||e.call(o),n(window.AwsWafIntegration.fetch(t,l))},onLoad:()=>{var n;null===(n=null==o?void 0:o.onLoad)||void 0===n||n.call(o)},onError:n=>{var t;null===(t=null==o?void 0:o.onError)||void 0===t||t.call(o,n),e(n)},onPuzzleTimeout:()=>{var n;null===(n=null==o?void 0:o.onError)||void 0===n||n.call(o,"CAPTCHA timeout"),e(new Error("CAPTCHA timeout"))},onPuzzleIncorrect:()=>{var n;null===(n=null==o?void 0:o.onPuzzleIncorrect)||void 0===n||n.call(o)},onPuzzleCorrect:()=>{var n;null===(n=null==o?void 0:o.onPuzzleCorrect)||void 0===n||n.call(o)},apiKey:o.API_KEY}):e(new Error("AwsWafIntegration is not available")):e(new Error("AwsWafCaptcha is not available"))})}};export{o as createCaptchaFetchHandler};
+//# sourceMappingURL=bundle.esm.js.map

package/dist/bundle.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.esm.js","sources":["../src/utils/modalUtils.ts","../src/utils/WAFScriptUtils.ts","../src/createCaptchaFetchHandler.ts"],"sourcesContent":[null,null,null],"names":["ensureCaptchaContainer","captchaContainerId","captchaContentId","container","document","getElementById","captchaContainer","_a","body","createElement","id","appendChild","showCaptchaModal","overlayId","modalId","overlay","modal","style","cssText","ensureModalContainer","captchaForm","parentElement","display","WAF_SCRIPT_ID","createCaptchaFetchHandler","config","API_KEY","Error","JSAPI_URL","checkWAFconfig","AwsWafScript","async","src","head","loadCaptchaScript","path","init","Promise","resolve","reject","window","AwsWafCaptcha","AwsWafIntegration","renderCaptcha","onSuccess","hideCaptchaModal","fetch","onLoad","onError","error","call","onPuzzleTimeout","onPuzzleIncorrect","onPuzzleCorrect","apiKey"],"mappings":"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"}

package/dist/createCaptchaFetchHandler.d.ts

@@ -0,0 +1,2 @@
+import { AWSWAFInterceptorConfig } from "./types";
+export declare const createCaptchaFetchHandler: (config: AWSWAFInterceptorConfig) => (path: RequestInfo | URL, init: RequestInit) => Promise<Response>;

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+interface AwsWafCaptchaConfig {
+    onSuccess: (wafToken: string) => void;
+    onLoad?: () => void;
+    onError?: (err: string) => void;
+    onPuzzleTimeout?: () => void;
+    onPuzzleIncorrect?: () => void;
+    onPuzzleCorrect?: () => void;
+    apiKey: string;
+}
+interface AwsWafCaptcha {
+    renderCaptcha: (container: string | HTMLElement, config: AwsWafCaptchaConfig) => void;
+}
+interface AwsWafIntegration {
+    fetch: typeof fetch;
+    hasToken: () => boolean;
+    getToken: () => Promise<string>;
+}
+declare global {
+    interface Window {
+        AwsWafIntegration: AwsWafIntegration;
+        AwsWafCaptcha: AwsWafCaptcha;
+    }
+}
+interface AWSWAFInterceptorConfig {
+    API_KEY: string;
+    JSAPI_URL: string;
+    onSuccess?: () => void;
+    onLoad?: () => void;
+    onError?: (err: string) => void;
+    onPuzzleTimeout?: () => void;
+    onPuzzleIncorrect?: () => void;
+    onPuzzleCorrect?: () => void;
+    captchaContainerId: string;
+    captchaContentId?: string;
+    overlayId?: string;
+    modalId?: string;
+}
+
+declare const createCaptchaFetchHandler: (config: AWSWAFInterceptorConfig) => (path: RequestInfo | URL, init: RequestInit) => Promise<Response>;
+
+export { createCaptchaFetchHandler };

package/dist/types.d.ts

@@ -0,0 +1,44 @@
+export interface AwsWafCaptchaConfig {
+    onSuccess: (wafToken: string) => void;
+    onLoad?: () => void;
+    onError?: (err: string) => void;
+    onPuzzleTimeout?: () => void;
+    onPuzzleIncorrect?: () => void;
+    onPuzzleCorrect?: () => void;
+    apiKey: string;
+}
+export interface AwsWafCaptcha {
+    renderCaptcha: (container: string | HTMLElement, config: AwsWafCaptchaConfig) => void;
+}
+export interface AwsWafIntegration {
+    fetch: typeof fetch;
+    hasToken: () => boolean;
+    getToken: () => Promise<string>;
+}
+declare global {
+    interface Window {
+        AwsWafIntegration: AwsWafIntegration;
+        AwsWafCaptcha: AwsWafCaptcha;
+    }
+}
+export interface CaptchaOptions {
+    apiKey: string;
+    captchaContentId: string;
+    onCaptchaRequired: () => void;
+    onSuccess: () => void;
+    onError: (error: string) => void;
+}
+export interface AWSWAFInterceptorConfig {
+    API_KEY: string;
+    JSAPI_URL: string;
+    onSuccess?: () => void;
+    onLoad?: () => void;
+    onError?: (err: string) => void;
+    onPuzzleTimeout?: () => void;
+    onPuzzleIncorrect?: () => void;
+    onPuzzleCorrect?: () => void;
+    captchaContainerId: string;
+    captchaContentId?: string;
+    overlayId?: string;
+    modalId?: string;
+}

package/dist/utils/WAFScriptUtils.d.ts

@@ -0,0 +1,4 @@
+import { AWSWAFInterceptorConfig } from "../types";
+export declare const WAF_SCRIPT_ID = "AwsWAFScript";
+export declare function checkWAFconfig(config: AWSWAFInterceptorConfig): void;
+export declare function loadCaptchaScript(JSAPI_URL: string): void;

package/dist/utils/modalUtils.d.ts

@@ -0,0 +1,7 @@
+export declare const ensureCaptchaContainer: (captchaContainerId: string, captchaContentId?: string) => HTMLElement;
+export declare const ensureModalContainer: (captchaContainerId: string, overlayId?: string, modalId?: string) => {
+    overlay: HTMLElement;
+    modal: HTMLElement;
+};
+export declare const showCaptchaModal: (captchaContainerId: string, captchaContentId?: string, overlayId?: string, modalId?: string) => void;
+export declare const hideCaptchaModal: (overlayId?: string) => void;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "waf-captcha-frontend",
+  "version": "0.0.5",
+  "description": "is a lightweight JavaScript/TypeScript library that provides seamless integration with AWS WAF Captcha for fetch-based HTTP requests. The package handles captcha challenges transparently, intercepting requests and displaying captcha modals when required by AWS WAF.",
+  "main": "dist/bundle.cjs.js",
+  "module": "dist/bundle.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "rollup -c",
+    "build:types": "tsc --emitDeclarationOnly"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "devDependencies": {
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "rollup": "^4.55.1",
+    "rollup-plugin-dts": "^6.3.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3"
+  }
+}