--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_drop_chatstates/README.md	Sat Aug 02 10:51:20 2025 -0400
@@ -0,0 +1,38 @@
+---
+labels:
+- 'Stage-Alpha'
+- 'Type-Web'
+summary: Drop chatstates for specific domains.
+rockspec:
+  build:
+    modules:
+      mod_drop_chatstates: mod_drop_chatstates.lua
+...
+
+Introduction
+============
+
+This is a Prosody module to drop chatstates for specific domains.
+
+Clients that request chatstates to virtual JIDs (i.e. those created by
+modules like mod\_voipms to send/receive SMS/MMS on domains like
+'sms.example.com') will, by design, receive errors indicating the
+service is unavailable. While most clients will silently ignore this,
+clients like profanity will not. This module allows us to drop responses
+for chatstates on selected domains if we know they will never respond.
+
+Configuration
+=============
+
+| option                    | type   | default | description
+|---------------------------|--------|---------|-------------------------------|
+| drop\_chatstates\_domains | table  | {}      | Domains to drop chatstates for
+
+Sample module configuration:
+
+```
+modules_enabled = {
+    "drop_chatstates";
+}
+drop_chatstates_domains = { "sms.example.com" }
+```