docs: document threat and billing metadata

[davidmytton]

Document the IP threat intelligence and Guard billing metadata introduced by arcjet/arcjet#8653.

The Guard examples cover JavaScript, Python, and Go, including language-specific field names, billing units, and optional-presence semantics.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
arcjet-docs	Ready	Preview	Aug 5, 2026 6:50pm

[arcjet-review]

Arcjet Review — 🟢 Low Risk

Decision: Approved

Rationale: Documentation-only change adding two new sections: usage billing metadata for guard rules and IP threat intelligence fields for IPAnalysis. No code, config, or infrastructure changes. No escalation triggers fire. No security implications from prose additions.

Summary of Changes

Adds documentation for (1) optional billing metadata on prompt-injection and content-moderation rule results across JS/TS, Python, and Go, and (2) the decision.ip.threat IP threat intelligence fields (riskLevel, confidence, reputation, isSafe, networkTypes, activities, entities, entityName, service, backgroundNoise).

Notes

Docs-only PR, ~137 lines added, well under size threshold. Security-review skill not loaded because there is no executable code being introduced; the additions are prose and illustrative snippets that reference existing SDK APIs.

_{Review: cf46d5d2 | Model: anthropic/claude-opus-4-7 | Powered by Arcjet Review}