@riverbankcms/sdk 0.7.2 → 0.7.4

package/README.md

@@ -2703,6 +2703,59 @@ export default async function CustomPage({ params }) {
 }
 ```
 
+## Spam Protection
+
+Add ALTCHA proof-of-work spam protection to forms. The widget runs entirely client-side and requires no API keys.
+
+### Setup
+
+```tsx
+'use client'
+
+import { useSpamProtection, getChallengeUrl } from '@riverbankcms/sdk/spam-protection'
+
+function ContactForm() {
+  const { solution, isReady, reset, Widget } = useSpamProtection(getChallengeUrl())
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault()
+    if (!isReady) return
+
+    await fetch('/api/contact', {
+      method: 'POST',
+      body: JSON.stringify({
+        ...formData,
+        altchaSolution: solution,  // Include with submission
+      }),
+    })
+    reset()  // Reset for another submission
+  }
+
+  return (
+    <form onSubmit={handleSubmit}>
+      {/* form fields */}
+      <Widget />
+      <button disabled={!isReady}>Submit</button>
+    </form>
+  )
+}
+```
+
+### Environment
+
+Set `NEXT_PUBLIC_DASHBOARD_URL` so `getChallengeUrl()` resolves correctly.
+
+### Exports
+
+```tsx
+import {
+  useSpamProtection,    // Hook for solution state management
+  getChallengeUrl,      // Returns challenge endpoint URL
+  hasSpamProtection,    // Check if spam protection is enabled (server-only)
+  AltchaWidget,         // Low-level widget component
+} from '@riverbankcms/sdk/spam-protection'
+```
+
 ## Additional Exports
 
 - `@riverbankcms/sdk/rendering` - Low-level rendering components
@@ -2716,3 +2769,4 @@ export default async function CustomPage({ params }) {
 - `@riverbankcms/sdk/analytics` - Analytics tracking helpers
 - `@riverbankcms/sdk/config` - Site configuration utilities (includes `defineConfig`, `defineContentConfig`, `RiverbankSiteConfig`, `ContentConfig`, etc.)
 - `@riverbankcms/sdk/next` - Next.js integration utilities (`createCatchAllPage`)
+- `@riverbankcms/sdk/spam-protection` - ALTCHA spam protection (`useSpamProtection`, `getChallengeUrl`, `AltchaWidget`)

package/dist/client/bookings.d.mts

@@ -23,6 +23,8 @@ type BookingFormProps = {
     className?: string;
     form?: FormConfig | null;
     services?: Service$2[];
+    /** Server-passed spam protection flag. Falls back to NEXT_PUBLIC_SPAM_PROTECTION_ENABLED. */
+    spamProtectionEnabled?: boolean;
 };
 /**
  * BookingFormClient Component

package/dist/client/bookings.d.ts

@@ -23,6 +23,8 @@ type BookingFormProps = {
     className?: string;
     form?: FormConfig | null;
     services?: Service$2[];
+    /** Server-passed spam protection flag. Falls back to NEXT_PUBLIC_SPAM_PROTECTION_ENABLED. */
+    spamProtectionEnabled?: boolean;
 };
 /**
  * BookingFormClient Component