Skip to content

fix(docs): correct cross-language inconsistencies and add missing features#43

Open
forgetso wants to merge 3 commits into
mainfrom
fix/marketing-doc-inconsistencies
Open

fix(docs): correct cross-language inconsistencies and add missing features#43
forgetso wants to merge 3 commits into
mainfrom
fix/marketing-doc-inconsistencies

Conversation

@forgetso

Copy link
Copy Markdown
Member

Summary

Cross-language fixes (en + de/es/fr/it/pt-br):

  • Broken React integration links in welcome/ and basics/client-side-rendering.mdx pointed at /angular-integration/ instead of /react-integration/ (24 instances across 12 files).
  • Invisible CAPTCHA server-side example used reCAPTCHA-style field names (response, remoteip, result.success) instead of Prosopo's (token, ip, verified). Matches ApiParams and VerificationResponse in captcha/packages/types.
  • Server-side verification SDK example: new ProsopoServer(config) would crash at runtime because verifyProvider requires pair.sign(...). Now passes pair via getPair(). Also if (await isVerified(...)) treated the returned object as a boolean — fixed to unpack result.verified. JS fetch example missing await on response.json().
  • Tier naming: "Pro and Enterprise" → "Professional and Enterprise" to match the Tier enum in the portal (packages/portal/src/components/AccountComponents/UpgradeModal.tsx).

English-only:

  • Add ASN as a documented access-control rule field. Already supported by RuleEditorFields.ts and the policy schema (captcha/packages/user-access-policy/src/rule.ts), just undocumented.
  • Reword traffic-filter "Providing the IP Address" to lead with what actually happens (filters always run against the session-initiation IP; passing ip overrides with a fresh lookup). Previous wording implied the ip field was required.

Test plan

  • Build the docs locally and visually inspect the affected pages
  • Click the React integration links from the welcome and client-side-rendering pages — they should now resolve
  • Copy the server-side verification SDK example into a fresh project and verify it runs without throwing
  • Verify the invisible-captcha JS example matches the format documented elsewhere on the site

🤖 Generated with Claude Code

forgetso and others added 3 commits June 2, 2026 16:38
Replaces the one-paragraph mention of the disposable-domain blocklist
with full coverage of the five-stage check chain (direct lookup,
SSRF-safe validation, HTTPS redirect probe, CNAME chase, MX fallback),
provider-side config (`spamEmailDomainsUrls`, scheduler cron) and the
standalone `/v1/prosopo/provider/client/spam/email` endpoint with
request/response examples.

Also updates the evaluation-order list to reflect that the domain-list
stage runs last (after the synchronous pattern rules) since it is the
most expensive.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Cuts implementation detail that doesn't belong on customer-facing docs:
the SSRF safety check, source-code paths, the provider-side feed URLs
and cron config, and the per-step DNS-chase explanation.

What's left: what the toggle does, what gets caught (including the
redirect/CNAME/MX chase, named but not over-explained), the rejection
status code, and the standalone endpoint contract.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…tures

Cross-language fixes (en + de/es/fr/it/pt-br):
- Fix broken React integration links in welcome and client-side-rendering
  (pointed at /angular-integration/ instead of /react-integration/)
- Fix invisible-captcha server-side example using reCAPTCHA-style fields
  (response/remoteip/result.success) instead of Prosopo's (token/ip/verified)
- Fix server-side-verification SDK example: ProsopoServer requires a pair
  argument; isVerified returns a VerificationResponse object, not a boolean
- Fix tier naming "Pro and Enterprise" -> "Professional and Enterprise"
  to match the Tier enum in the portal

English-only:
- Add ASN as a documented access-control rule field (already supported by
  the rule editor and policy schema, just undocumented)
- Reword traffic-filter "Providing the IP Address" to lead with what
  actually happens (filters always run against the session-initiation IP;
  passing ip overrides with a fresh lookup) instead of implying the IP
  field is required

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@netlify

netlify Bot commented Jun 10, 2026

Copy link
Copy Markdown

Deploy Preview for peaceful-pothos-9e62ce ready!

Name Link
🔨 Latest commit 501e7b9
🔍 Latest deploy log https://app.netlify.com/projects/peaceful-pothos-9e62ce/deploys/6a29598420ee260008bec673
😎 Deploy Preview https://deploy-preview-43--peaceful-pothos-9e62ce.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant