feat(provider): add support for Spaceship

docs/spaceship.md

@@ -0,0 +1,33 @@
+# Spaceship
+
+## Configuration
+
+Docs can be found for the spaceship API [here](https://docs.spaceship.dev/).
+### Example
+
+```json
+{
+  "settings": [
+    {
+      "provider": "spaceship",
+      "domain": "example.com",
+      "host": "subdomain",
+      "apikey": "YOUR_API_KEY",
+      "apisecret": "YOUR_API_SECRET",
+      "ip_version": "ipv4"
+    }
+  ]
+}
+```
+
+### Compulsory parameters
+
+- `"domain"` is the domain to update. It can be a root domain (i.e. `example.com`) or a subdomain (i.e. `subdomain.example.com`).
+- `"apikey"` is your API key which can be obtained from [API Manager](https://www.spaceship.com/application/api-manager/).
+- `"apisecret"` is your API secret which is provided along with your API key in the API Manager.
+
+### Optional parameters
+
+- `"ip_version"` can be `ipv4` (A records), or `ipv6` (AAAA records) or `ipv4 or ipv6` (update one of the two, depending on the public ip found). It defaults to `ipv4 or ipv6`.
+- `"ipv6_suffix"` is the IPv6 interface identifier suffix to use. It can be for example `0:0:0:0:72ad:8fbb:a54e:bedd/64`. If left empty, it defaults to no suffix and the raw public IPv6 address obtained is used in the record updating.
+- `"ttl"` is the record TTL which defaults to 3600 seconds.

internal/provider/constants/providers.go

@@ -51,6 +51,7 @@ const (
 	Route53      models.Provider = "route53"
 	SelfhostDe   models.Provider = "selfhost.de"
 	Servercow    models.Provider = "servercow"
+	Spaceship    models.Provider = "spaceship"
 	Spdyn        models.Provider = "spdyn"
 	Strato       models.Provider = "strato"
 	Variomedia   models.Provider = "variomedia"
@@ -104,6 +105,7 @@ func ProviderChoices() []models.Provider {
 		Porkbun,
 		Route53,
 		SelfhostDe,
+		Spaceship,
 		Spdyn,
 		Strato,
 		Variomedia,

internal/provider/provider.go

@@ -57,6 +57,7 @@ import (
 	"github.com/qdm12/ddns-updater/internal/provider/providers/route53"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/selfhostde"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/servercow"
+	"github.com/qdm12/ddns-updater/internal/provider/providers/spaceship"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/spdyn"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/strato"
 	"github.com/qdm12/ddns-updater/internal/provider/providers/variomedia"
@@ -178,6 +179,8 @@ func New(providerName models.Provider, data json.RawMessage, domain, owner strin
 		return selfhostde.New(data, domain, owner, ipVersion, ipv6Suffix)
 	case constants.Servercow:
 		return servercow.New(data, domain, owner, ipVersion, ipv6Suffix)
+	case constants.Spaceship:
+		return spaceship.New(data, domain, owner, ipVersion, ipv6Suffix)
 	case constants.Spdyn:
 		return spdyn.New(data, domain, owner, ipVersion, ipv6Suffix)
 	case constants.Strato:

internal/provider/providers/spaceship/createrecord.go

@@ -0,0 +1,70 @@
+package spaceship
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"net/url"
+
+	"github.com/qdm12/ddns-updater/internal/provider/errors"
+	"github.com/qdm12/ddns-updater/internal/provider/utils"
+)
+
+func (p *Provider) createRecord(ctx context.Context, client *http.Client,
+	recordType, address string) error {
+	u := url.URL{
+		Scheme: "https",
+		Host:   "spaceship.dev",
+		Path:   fmt.Sprintf("/api/v1/dns/records/%s", p.domain),
+	}
+
+	createData := struct {
+		Force bool `json:"force"`
+		Items []struct {
+			Type    string `json:"type"`
+			Name    string `json:"name"`
+			Address string `json:"address"`
+			TTL     int    `json:"ttl"`
+		} `json:"items"`
+	}{
+		Force: true,
+		Items: []struct {
+			Type    string `json:"type"`
+			Name    string `json:"name"`
+			Address string `json:"address"`
+			TTL     int    `json:"ttl"`
+		}{{
+			Type:    recordType,
+			Name:    p.owner,
+			Address: address,
+			TTL:     3600,
+		}},
+	}
+
+	var requestBody bytes.Buffer
+	if err := json.NewEncoder(&requestBody).Encode(createData); err != nil {
+		return fmt.Errorf("encoding request body: %w", err)
+	}
+
+	request, err := http.NewRequestWithContext(ctx, http.MethodPut, u.String(), &requestBody)
+	if err != nil {
+		return fmt.Errorf("creating request: %w", err)
+	}
+	p.setHeaders(request)
+
+	response, err := client.Do(request)
+	if err != nil {
+		return err
+	}
+	defer response.Body.Close()
+
+	if response.StatusCode != http.StatusNoContent {
+		return fmt.Errorf("%w: %d: %s",
+			errors.ErrHTTPStatusNotValid, response.StatusCode,
+			utils.BodyToSingleLine(response.Body))
+	}
+
+	return nil
+}

internal/provider/providers/spaceship/getrecord.go

@@ -0,0 +1,51 @@
+package spaceship
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"net/url"
+)
+
+type Record struct {
+	Type    string `json:"type"`
+	Name    string `json:"name"`
+	Address string `json:"address"`
+}
+
+func (p *Provider) getRecords(ctx context.Context, client *http.Client) (
+	records []Record, err error) {
+	u := url.URL{
+		Scheme: "https",
+		Host:   "spaceship.dev",
+		Path:   fmt.Sprintf("/api/v1/dns/records/%s", p.domain),
+	}
+
+	values := url.Values{}
+	values.Set("take", "100")
+	values.Set("skip", "0")
+	u.RawQuery = values.Encode()
+
+	request, err := http.NewRequestWithContext(ctx, http.MethodGet, u.String(), nil)
+	if err != nil {
+		return nil, fmt.Errorf("creating http request: %w", err)
+	}
+	p.setHeaders(request)
+
+	response, err := client.Do(request)
+	if err != nil {
+		return nil, err
+	}
+	defer response.Body.Close()
+
+	var recordsResponse struct {
+		Items []Record `json:"items"`
+	}
+
+	if err := json.NewDecoder(response.Body).Decode(&recordsResponse); err != nil {
+		return nil, fmt.Errorf("decoding response: %w", err)
+	}
+
+	return recordsResponse.Items, nil
+}

internal/provider/providers/spaceship/provider.go

@@ -0,0 +1,112 @@
+package spaceship
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"net/netip"
+
+	"github.com/qdm12/ddns-updater/internal/provider/constants"
+	"github.com/qdm12/ddns-updater/internal/models"
+	"github.com/qdm12/ddns-updater/internal/provider/errors"
+	"github.com/qdm12/ddns-updater/internal/provider/headers"
+	"github.com/qdm12/ddns-updater/internal/provider/utils"
+	"github.com/qdm12/ddns-updater/pkg/publicip/ipversion"
+)
+
+type Provider struct {
+	domain     string
+	owner      string
+	ipVersion  ipversion.IPVersion
+	ipv6Suffix netip.Prefix
+	apiKey     string
+	apiSecret  string
+}
+
+func New(data json.RawMessage, domain, owner string,
+	ipVersion ipversion.IPVersion, ipv6Suffix netip.Prefix) (
+	p *Provider, err error,
+) {
+	extraSettings := struct {
+		APIKey    string `json:"apikey"`
+		APISecret string `json:"apisecret"`
+	}{}
+	err = json.Unmarshal(data, &extraSettings)
+	if err != nil {
+		return nil, err
+	}
+
+	err = validateSettings(domain, extraSettings.APIKey, extraSettings.APISecret)
+	if err != nil {
+		return nil, fmt.Errorf("validating provider specific settings: %w", err)
+	}
+
+	return &Provider{
+		domain:     domain,
+		owner:      owner,
+		ipVersion:  ipVersion,
+		ipv6Suffix: ipv6Suffix,
+		apiKey:     extraSettings.APIKey,
+		apiSecret:  extraSettings.APISecret,
+	}, nil
+}
+
+func validateSettings(domain, apiKey, apiSecret string) (err error) {
+	err = utils.CheckDomain(domain)
+	if err != nil {
+		return fmt.Errorf("%w: %w", errors.ErrDomainNotValid, err)
+	}
+
+	switch {
+	case apiKey == "":
+		return fmt.Errorf("%w", errors.ErrAPIKeyNotSet)
+	case apiSecret == "":
+		return fmt.Errorf("%w", errors.ErrAPISecretNotSet)
+	}
+	return nil
+}
+
+func (p *Provider) String() string {
+	return utils.ToString(p.domain, p.owner, constants.Spaceship, p.ipVersion)
+}
+
+func (p *Provider) Domain() string {
+	return p.domain
+}
+
+func (p *Provider) Owner() string {
+	return p.owner
+}
+
+func (p *Provider) IPVersion() ipversion.IPVersion {
+	return p.ipVersion
+}
+
+func (p *Provider) IPv6Suffix() netip.Prefix {
+	return p.ipv6Suffix
+}
+
+func (p *Provider) Proxied() bool {
+	return false
+}
+
+func (p *Provider) BuildDomainName() string {
+	return utils.BuildDomainName(p.owner, p.domain)
+}
+
+func (p *Provider) HTML() models.HTMLRow {
+	return models.HTMLRow{
+		Domain:    fmt.Sprintf("<a href=\"http://%s\">%s</a>", p.BuildDomainName(), p.BuildDomainName()),
+		Owner:     p.Owner(),
+		Provider:  fmt.Sprintf("<a href=\"https://www.spaceship.com/application/advanced-dns-application/manage/%s\">Spaceship</a>", p.domain),
+		IPVersion: p.ipVersion.String(),
+	}
+}
+
+func (p *Provider) setHeaders(request *http.Request) {
+	headers.SetUserAgent(request)
+	headers.SetContentType(request, "application/json")
+	headers.SetAccept(request, "application/json")
+	request.Header.Set("X-Api-Key", p.apiKey)
+	request.Header.Set("X-Api-Secret", p.apiSecret)
+}