@trustsig/react 1.2.7 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TrustSig
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # @trustsig/react
 
-React Context Provider and hooks for TrustSig bot protection.
+React Context Provider and hooks for TrustSig bot protection. React 18 or 19.
 
 ## Installation
 
@@ -8,10 +8,9 @@ React Context Provider and hooks for TrustSig bot protection.
 npm install @trustsig/react
 ```
 
-## Usage (Next.js App Router)
-
-### 1. Root Layout
+## Usage
 
+### 1. Setup Provider
 Wrap your application or specific routes with the provider.
 
 ```tsx
@@ -20,46 +19,63 @@ import { TrustSigProvider } from '@trustsig/react';
 
 export default function RootLayout({ children }) {
   return (
-    <TrustSigProvider siteKey="YOUR_PUBLIC_KEY" interceptRequests={true}>
+    <TrustSigProvider siteKey="pk_live_..." autoScan>
       {children}
     </TrustSigProvider>
   );
 }
 ```
 
-### 2. Usage in Client Components
-
-Use the hook inside any component nested under the provider.
+### 2. Using the Hook
+Use `useTrustSig` to access the analysis methods.
 
 ```tsx
 "use client";
 import { useTrustSig } from '@trustsig/react';
 
-export function LoginForm() {
-  const { getResponse } = useTrustSig();
+export function ActionForm() {
+  const { getResponse, isLoaded, error } = useTrustSig();
 
   const handleSubmit = async (e) => {
     e.preventDefault();
-    const token = await getResponse();
-    
-    await fetch('/api/login', {
-      method: 'POST',
-      headers: { 'X-TrustSig-Response': token || '' },
-      body: JSON.stringify({ email: "user@example.com" })
-    });
+    const response = await getResponse(); // { request_id, token } | null
+
+    if (response?.token) {
+      await fetch('/api/secure-action', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-TrustSig-Response': response.token,
+        },
+        body: JSON.stringify({ data: '...' }),
+      });
+    }
   };
 
   return (
-    <form onSubmit={handleSubmit}>
-      <button type="submit">Login</button>
-    </form>
+    <button onClick={handleSubmit} disabled={!isLoaded}>
+      Submit Secure Action
+    </button>
   );
 }
 ```
 
+`getResponse()` resolves to `{ request_id, token }` or `null` (script failed
+to load, timed out, or no verdict yet — inspect `error`). The server is the
+trust boundary: always verify the token with `@trustsig/server`.
+
 ## API
 
 | Export | Type | Description |
 | --- | --- | --- |
-| `TrustSigProvider` | Component | The React context provider. |
-| `useTrustSig` | Hook | Hook to get the response token and status. |
+| `isLoaded` | `boolean` | True once the TrustSig script has loaded. |
+| `error` | `Error \| null` | Set if script loading failed or timed out (`SCRIPT_LOAD_FAIL` / `SCRIPT_LOAD_TIMEOUT`). |
+| `getResponse()` | `Promise<TrustSigResponse \| null>` | Current analysis result. |
+| `scan()` | `Promise<TrustSigResponse \| null>` | Manually trigger a new analysis scan. |
+| `setCustomData(data)` | `void` | Update custom metadata for subsequent scans. |
+
+### Provider props
+
+`siteKey` (required), `scriptUrl`, `interceptRequests`, `autoScan`, `debug`,
+`nonce`, `env`, `customData`. Changing `customData` updates the running script
+in place — it does **not** re-inject the script or reset state.

package/dist/index.cjs

@@ -42,6 +42,17 @@ module.exports = __toCommonJS(index_exports);
 var import_react = __toESM(require("react"), 1);
 var import_client = require("@trustsig/client");
 var TrustSigContext = (0, import_react.createContext)(null);
+function stableStringify(value) {
+  return JSON.stringify(value, (_key, val) => {
+    if (val && typeof val === "object" && !Array.isArray(val)) {
+      return Object.keys(val).sort().reduce((acc, k) => {
+        acc[k] = val[k];
+        return acc;
+      }, {});
+    }
+    return val;
+  });
+}
 var TrustSigProvider = ({
   siteKey,
   scriptUrl,
@@ -55,6 +66,7 @@ var TrustSigProvider = ({
 }) => {
   const [isLoaded, setIsLoaded] = (0, import_react.useState)(false);
   const [error, setError] = (0, import_react.useState)(null);
+  const initialCustomData = (0, import_react.useRef)(customData).current;
   const client = (0, import_react.useMemo)(
     () => new import_client.TrustSigClient({
       siteKey,
@@ -64,30 +76,33 @@ var TrustSigProvider = ({
       debug,
       nonce,
       env,
-      customData
+      customData: initialCustomData
     }),
-    [siteKey, scriptUrl, interceptRequests, autoScan, debug, nonce, env, JSON.stringify(customData)]
+    [siteKey, scriptUrl, interceptRequests, autoScan, debug, nonce, env, initialCustomData]
   );
   (0, import_react.useEffect)(() => {
     let mounted = true;
     client.load().then(() => {
-      if (mounted) {
-        setIsLoaded(true);
-      }
+      if (mounted) setIsLoaded(true);
     }).catch((err) => {
-      if (mounted) {
-        setError(err);
-      }
+      if (mounted) setError(err);
     });
     return () => {
       mounted = false;
     };
   }, [client]);
+  const customDataKey = customData ? stableStringify(customData) : "";
+  (0, import_react.useEffect)(() => {
+    if (customData) {
+      client.setCustomData(customData);
+    }
+  }, [client, customDataKey]);
   const value = (0, import_react.useMemo)(
     () => ({
       isLoaded,
       error,
       getResponse: () => client.getResponse(),
+      scan: () => client.scan(),
       setCustomData: (data) => client.setCustomData(data)
     }),
     [isLoaded, error, client]
@@ -97,7 +112,7 @@ var TrustSigProvider = ({
 var useTrustSigContext = () => {
   const context = (0, import_react.useContext)(TrustSigContext);
   if (!context) {
-    throw new Error("USE_TRUSTSIG_CONTEXT_ERROR");
+    throw new Error("useTrustSig must be used within a <TrustSigProvider>");
   }
   return context;
 };

package/dist/index.d.cts

@@ -1,11 +1,12 @@
 import React from 'react';
-import { TrustSigEnv } from '@trustsig/types';
+import { TrustSigResponse, TrustSigEnv } from '@trustsig/types';
 
 interface TrustSigContextValue {
     isLoaded: boolean;
     error: Error | null;
-    getResponse: () => Promise<string | null>;
-    setCustomData: (data: Record<string, any>) => void;
+    getResponse: () => Promise<TrustSigResponse | null>;
+    scan: () => Promise<TrustSigResponse | null>;
+    setCustomData: (data: Record<string, unknown>) => void;
 }
 interface TrustSigProviderProps {
     siteKey: string;
@@ -15,7 +16,7 @@ interface TrustSigProviderProps {
     debug?: boolean;
     nonce?: string;
     env?: TrustSigEnv;
-    customData?: Record<string, any>;
+    customData?: Record<string, unknown>;
     children: React.ReactNode;
 }
 declare const TrustSigProvider: React.FC<TrustSigProviderProps>;

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import React from 'react';
-import { TrustSigEnv } from '@trustsig/types';
+import { TrustSigResponse, TrustSigEnv } from '@trustsig/types';
 
 interface TrustSigContextValue {
     isLoaded: boolean;
     error: Error | null;
-    getResponse: () => Promise<string | null>;
-    setCustomData: (data: Record<string, any>) => void;
+    getResponse: () => Promise<TrustSigResponse | null>;
+    scan: () => Promise<TrustSigResponse | null>;
+    setCustomData: (data: Record<string, unknown>) => void;
 }
 interface TrustSigProviderProps {
     siteKey: string;
@@ -15,7 +16,7 @@ interface TrustSigProviderProps {
     debug?: boolean;
     nonce?: string;
     env?: TrustSigEnv;
-    customData?: Record<string, any>;
+    customData?: Record<string, unknown>;
     children: React.ReactNode;
 }
 declare const TrustSigProvider: React.FC<TrustSigProviderProps>;

package/dist/index.js

@@ -2,9 +2,20 @@
 "use client";
 
 // src/TrustSigProvider.tsx
-import React, { createContext, useContext, useEffect, useState, useMemo } from "react";
+import React, { createContext, useContext, useEffect, useRef, useState, useMemo } from "react";
 import { TrustSigClient } from "@trustsig/client";
 var TrustSigContext = createContext(null);
+function stableStringify(value) {
+  return JSON.stringify(value, (_key, val) => {
+    if (val && typeof val === "object" && !Array.isArray(val)) {
+      return Object.keys(val).sort().reduce((acc, k) => {
+        acc[k] = val[k];
+        return acc;
+      }, {});
+    }
+    return val;
+  });
+}
 var TrustSigProvider = ({
   siteKey,
   scriptUrl,
@@ -18,6 +29,7 @@ var TrustSigProvider = ({
 }) => {
   const [isLoaded, setIsLoaded] = useState(false);
   const [error, setError] = useState(null);
+  const initialCustomData = useRef(customData).current;
   const client = useMemo(
     () => new TrustSigClient({
       siteKey,
@@ -27,30 +39,33 @@ var TrustSigProvider = ({
       debug,
       nonce,
       env,
-      customData
+      customData: initialCustomData
     }),
-    [siteKey, scriptUrl, interceptRequests, autoScan, debug, nonce, env, JSON.stringify(customData)]
+    [siteKey, scriptUrl, interceptRequests, autoScan, debug, nonce, env, initialCustomData]
   );
   useEffect(() => {
     let mounted = true;
     client.load().then(() => {
-      if (mounted) {
-        setIsLoaded(true);
-      }
+      if (mounted) setIsLoaded(true);
     }).catch((err) => {
-      if (mounted) {
-        setError(err);
-      }
+      if (mounted) setError(err);
     });
     return () => {
       mounted = false;
     };
   }, [client]);
+  const customDataKey = customData ? stableStringify(customData) : "";
+  useEffect(() => {
+    if (customData) {
+      client.setCustomData(customData);
+    }
+  }, [client, customDataKey]);
   const value = useMemo(
     () => ({
       isLoaded,
       error,
       getResponse: () => client.getResponse(),
+      scan: () => client.scan(),
       setCustomData: (data) => client.setCustomData(data)
     }),
     [isLoaded, error, client]
@@ -60,7 +75,7 @@ var TrustSigProvider = ({
 var useTrustSigContext = () => {
   const context = useContext(TrustSigContext);
   if (!context) {
-    throw new Error("USE_TRUSTSIG_CONTEXT_ERROR");
+    throw new Error("useTrustSig must be used within a <TrustSigProvider>");
   }
   return context;
 };

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@trustsig/react",
-  "version": "1.2.7",
+  "version": "2.0.0",
+  "description": "React Context Provider and hooks for TrustSig bot protection",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "sideEffects": false,
   "files": [
     "dist"
   ],
@@ -17,14 +19,40 @@
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "tsup"
+    "build": "tsup",
+    "prepublishOnly": "tsup"
+  },
+  "keywords": [
+    "trustsig",
+    "security",
+    "bot-protection",
+    "react",
+    "nextjs",
+    "hooks"
+  ],
+  "author": "TrustSig (https://trustsig.eu)",
+  "license": "MIT",
+  "homepage": "https://trustsig.eu",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trustsig-eu/trustsigjs.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/trustsig-eu/trustsigjs/issues"
+  },
+  "engines": {
+    "node": ">=18"
   },
   "dependencies": {
-    "@trustsig/client": "^1.1.11",
-    "@trustsig/types": "^1.1.11"
+    "@trustsig/client": "^2.0.0",
+    "@trustsig/types": "^2.0.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }