@markee_team/sdk 0.1.0-beta.5 → 0.1.0-beta.7

package/README.md

@@ -357,3 +357,22 @@ Snapshots retain `entry.moderated` (`false`, `true`, or `null`) and can addition
 record views for it. A moderator's false-positive exception on Markee applies only on Markee;
 it does not change SDK visibility. Automatic moderation is enabled by default on Markee.
 Markee operators can explicitly disable it with `FLAG_AUTO_MODERATION=false`; host apps need no configuration.
+
+## Automatic moderation presets
+
+Both React components and `createMarkee`, `createMarkeeSign`, and `MarkeeClient` accept:
+
+```ts
+const moderation = { severity: 'standard' } as const;
+// <MarkeeSign placement={placement} moderation={moderation} />
+// <MarkeeModal placement={placement} moderation={moderation} ... />
+// new MarkeeClient({ moderation }).checkMessage('Your message');
+```
+
+- `relaxed`: existing scam/phishing, concealed-link, and payment-solicitation rules; no profanity dictionary.
+- `standard` (default): current rules plus all supported profanity dictionaries.
+- `strict`: Standard plus any detected link/domain or wallet address/ENS name, even without payment instructions.
+
+These are dictionary/rule presets, not contextual AI classifications or guarantees of safety. They check message text only. Manual flags, exact-text moderator approvals, and unavailable-state hiding still apply. An integration's preset does not change Markee's own Standard policy or the shared moderation queue.
+
+`POST /api/moderation/check` and `/api/sdk/v1/moderation/check` accept an optional top-level `severity` with either `{ kind: 'draft', message }` or `{ kind: 'published', chainId: 8453, markeeIds }`. Omission preserves Standard behavior; invalid values return 400. Verdict caches include the preset policy version. The SDK forwards its setting for draft checks, snapshots, payment reviews, hosted checkout, and view validation. Existing clients need no changes.