Implement libdns provider for http.net DNS API

Author: Bene-GG

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bene-GG
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,69 @@
+# http.net DNS for `libdns`
+
+[![Go Reference](https://pkg.go.dev/badge/github.com/libdns/httpnet.svg)](https://pkg.go.dev/github.com/libdns/httpnet)
+
+This package implements the [libdns](https://github.com/libdns/libdns) interfaces for [http.net](https://www.http.net), allowing DNS records to be managed via the http.net partner API.
+
+## Authenticating
+
+Create an API token in the [http.net partner portal](https://partner.http.net)
+(API documentation: <https://www.http.net/docs/api/>) and pass it to the
+provider:
+
+```go
+import "github.com/libdns/httpnet"
+
+provider := &httpnet.Provider{
+    AuthToken: "your-api-token",
+}
+
+records, err := provider.GetRecords(context.Background(), "example.com.")
+```
+
+The `Provider` implements `RecordGetter`, `RecordAppender`, `RecordSetter`, `RecordDeleter`, and `ZoneLister`.
+
+Any DNS record type accepted by the http.net API is supported: records are
+parsed into the matching typed `libdns.Record` (`libdns.Address`, `libdns.MX`,
+`libdns.TXT`, …) via `libdns.RR.Parse()`.
+
+## Caveats
+
+### TTL floor
+
+The http.net API enforces a 60-second minimum TTL. Lower values (including zero)
+are silently raised to 60 before being sent, to avoid request rejection.
+
+### Asynchronous writes
+
+Write operations may return a `pending` status with an empty record list. The
+provider handles this by performing a follow-up read, so callers still receive
+records with their assigned IDs.
+
+### Atomicity
+
+Updates within a single call are applied atomically by `recordsUpdate`, but
+concurrent modifications from separate processes to the same RRset may result
+in inconsistent state. Ensure concurrent processes operate on different RRsets.
+
+## Testing
+
+Unit tests run against an in-process mock server and require no credentials:
+
+```bash
+go test ./...
+```
+
+Integration tests against the live http.net API are opt-in via environment
+variables:
+
+```bash
+export HTTPNET_AUTH_TOKEN=<your-api-token>
+export HTTPNET_TEST_ZONE=example.com.   # a zone you control; trailing dot required
+go test -v ./...
+```
+
+Tests that find these variables unset are skipped automatically.
+
+## License
+
+MIT