Initial Dever 0.0.1

lib/doc/dever-tls.md

@@ -0,0 +1,39 @@
+# TLS
+
+构造可共享的 TLS 配置，连接时验证证书和目标名称，不提供跳过校验的模式。
+
+## dever.tls.ClientResult
+
+显式捕获客户端 TLS 配置的输入失败。
+
+分支：
+- `Ready(config: dever.system.ClientTls)`：配置成功
+- `error Failed(message: Text)`：配置错误
+
+## dever.tls.ServerResult
+
+显式捕获服务端证书或私钥的输入失败。
+
+分支：
+- `Ready(config: dever.system.ServerTls)`：配置成功
+- `error Failed(message: Text)`：配置错误
+
+## dever.tls.system
+
+使用随二进制提供的公共 CA，不读取机器上的可变证书配置。
+
+## dever.tls.client
+
+仅信任指定 PEM CA；无证书或非法 PEM 默认传播失败。
+
+## dever.tls.clientConfig
+
+取出客户端 TLS 配置；创建失败时继续传播错误。
+
+## dever.tls.server
+
+读取证书链及匹配的单个私钥，返回共享服务端配置。
+
+## dever.tls.serverConfig
+
+取出服务端 TLS 配置；创建失败时继续传播错误。