@gusnips/one-click-dns 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gustavo Salomé
+
+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.

package/README.md

@@ -1,3 +1,143 @@
-# Temporary Holding Version
+# @gusnips/one-click-dns
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Put DNS records in a customer's zone. The package finds where their DNS lives, then gives you the best way to add the record: a signed Domain Connect link, a pasted API token, or the steps for that host.
+
+```bash
+npm install @gusnips/one-click-dns
+# or
+bun add @gusnips/one-click-dns
+```
+
+It has three entry points:
+
+- `@gusnips/one-click-dns`: runs in the browser. The host list, the record spelling and the template presets.
+- `@gusnips/one-click-dns/server`: reads DNS, builds signed links. Node or Bun.
+- `@gusnips/one-click-dns/writers`: writes a record with an API token. Server only.
+
+Keep keys and tokens on the server. Nothing in the browser entry needs them.
+
+## First call
+
+```ts
+import { planConnection, systemDnsLookups } from "@gusnips/one-click-dns/server";
+
+const plan = await planConnection({ hostname: "help.acme.com" }, systemDnsLookups(2000));
+
+console.log(plan.reading?.hosts); // ["cloudflare"]
+console.log(plan.methods.map((method) => method.kind)); // ["api-token", "manual"]
+```
+
+`methods` lists the ways to connect, best first:
+
+| `kind`           | What it means                                                                                         |
+| ---------------- | ----------------------------------------------------------------------------------------------------- |
+| `domain-connect` | One click. You send the person to `url`, their DNS host asks them to approve, and the records appear. |
+| `api-token`      | The person pastes a token, and your server writes the record.                                         |
+| `manual`         | The person copies the records by hand. The host's name is in `hosts`. Always the last one.            |
+
+`plan.reading` is `null` when DNS did not answer. That is not the same as "host unknown", so do not show it as one.
+
+## Add a record with a token
+
+```ts
+import { cloudflare } from "@gusnips/one-click-dns/writers";
+
+const outcome = await cloudflare.addRecord({
+  token, // the person's Cloudflare API token
+  record: { type: "CNAME", name: "help.acme.com", value: "abc123.domains.example.app" },
+});
+// "created", "unchanged" or "unproxied"
+```
+
+The token is used for this call only. It is never stored, logged or put in an error. A record the person already has is never overwritten: you get a `conflict` instead.
+
+When the write fails, it throws a `DnsWriteError` with a `code`. Word each code in your own languages:
+
+| `code`              | What to tell the person                                                              |
+| ------------------- | ------------------------------------------------------------------------------------ |
+| `token_invalid`     | The host did not accept the token. Paste it again.                                   |
+| `zone_read_missing` | The token cannot list domains. Give it that permission.                              |
+| `dns_edit_missing`  | The token cannot change DNS records. Give it that permission.                        |
+| `zone_not_found`    | The token's account does not hold this domain.                                       |
+| `conflict`          | The name already has another record (`params.type`). They decide what to do with it. |
+| `unavailable`       | The host did not answer. Try again.                                                  |
+
+Cloudflare is the only writer today.
+
+## One-click links (Domain Connect)
+
+A link needs a template that your DNS host has switched on, and a key pair. You publish the public key in DNS and keep the private key on your server.
+
+```ts
+const plan = await planConnection(
+  {
+    hostname: "help.acme.com",
+    connect: {
+      providerId: "example.com", // your id in the Templates repository
+      keyId: "_dck1", // the TXT record name that holds your public key
+      serviceId: "custom-domain", // your template
+      privateKeyPem,
+      params: (zone) => ({
+        domain: zone,
+        host: "help",
+        target: "abc123",
+        redirect_uri: "https://app.example.com/done",
+      }),
+    },
+  },
+  systemDnsLookups(2000),
+);
+```
+
+When the host has your template, `plan.methods` starts with a `domain-connect` method. Sending the person back to `redirect_uri` proves nothing. Check the DNS yourself before you mark the domain done.
+
+Only these providers are asked, because their `_domainconnect` value and settings were read from DNS: Cloudflare, Vercel, Simply.com and GoDaddy. A name in a customer's DNS is never fetched. More providers join the same way, one value at a time.
+
+## Templates
+
+A template is a small JSON file in the public [Domain Connect Templates](https://github.com/Domain-Connect/Templates) repository. It lists the records you may ask a host to add. The presets build one that follows the repository's rules:
+
+```ts
+import { cnameTemplate, templateFileName } from "@gusnips/one-click-dns";
+
+const template = cnameTemplate(
+  {
+    providerId: "example.com",
+    providerName: "Example",
+    logoUrl: "https://example.com/logo.svg",
+    syncPubKeyDomain: "example.com",
+    syncRedirectDomain: "app.example.com",
+  },
+  { pointsTo: "%target%.domains.example.com" },
+);
+
+console.log(templateFileName(template)); // "example.com.custom-domain.json"
+```
+
+There are presets for a CNAME, DMARC, SPF, DKIM, MX and a verification TXT.
+
+A template belongs to the company that files it. It names your key domain, and the host checks every link against the key published there. So you cannot use someone else's template, and nobody can use yours. The customer's domain is not in the template: it comes with each link, so one template serves every customer.
+
+To file a template: test it in the [online editor](https://domainconnect.paulonet.eu/dc/free/templateedit), run `dc-template-linter -merge-or-fail` on it, open a pull request, then ask each DNS host to switch it on.
+
+## Steps for the host
+
+`DNS_HOSTS` holds 33 hosts: how to recognise them from their name servers, the labels on their DNS page and the traps (a proxy on by default, a trailing dot, a TXT that needs quotes). The package holds data and no sentences, so you write the steps in your own words and languages. `dnsRecordRow` spells a record the way a host wants it typed:
+
+```ts
+import { dnsRecordRow } from "@gusnips/one-click-dns";
+
+dnsRecordRow("route53", "acme.com", { type: "TXT", name: "acme.com", value: "v=spf1 ~all" });
+// { type: "TXT", name: "", value: "\"v=spf1 ~all\"", atRoot: true, rootUnsure: false }
+```
+
+A name server pattern is in the list only when the host documents it or it was seen in DNS. A label is quoted only when the host's own page shows it.
+
+## Checks
+
+```bash
+bun run lint
+bun run typecheck
+bun run build
+bun test src/path/to/file.test.ts
+```

package/dist/chunk-2T2PEF4H.js

@@ -0,0 +1,521 @@
+import {
+  normalizeDnsName
+} from "./chunk-P2O7INDB.js";
+
+// src/hosts.ts
+var DNS_HOST_IDS = [
+  "cloudflare",
+  "godaddy",
+  "namecheap",
+  "namecheap-hosting",
+  "squarespace",
+  "route53",
+  "google-cloud-dns",
+  "azure-dns",
+  "ionos",
+  "hostinger",
+  "porkbun",
+  "name-com",
+  "dynadot",
+  "namesilo",
+  "gandi",
+  "ovhcloud",
+  "digitalocean",
+  "hetzner",
+  "vercel",
+  "netlify",
+  "wix",
+  "wordpress-com",
+  "cpanel",
+  "bluehost",
+  "hostgator",
+  "hostgator-br",
+  "siteground",
+  "registro-br",
+  "locaweb",
+  "kinghost",
+  "uol-host",
+  "umbler",
+  "dnsimple"
+];
+var NO_FIELDS = { name: null, value: null };
+var SHORT = { kind: "shortName" };
+var TRAILING_DOT = { kind: "trailingDot" };
+var QUOTED_TXT = { kind: "quotedTxt" };
+var CPANEL_EDITOR = {
+  link: null,
+  open: "Zone Editor",
+  add: "Add Record",
+  save: "Save Record",
+  cname: { name: "Name", value: "Record" },
+  txt: { name: "Name", value: "Record" },
+  root: null,
+  traps: []
+};
+var DNS_HOSTS = {
+  cloudflare: {
+    name: "Cloudflare",
+    // Documented: <name>.ns.cloudflare.com, and <color>.foundationdns.{com,net,org}.
+    ns: [/^[a-z0-9-]+\.ns\.cloudflare\.com$/, /^[a-z0-9-]+\.foundationdns\.(com|net|org)$/],
+    link: "https://dash.cloudflare.com/?to=/:account/:zone/dns/records",
+    open: "DNS Records",
+    add: "Add record",
+    save: "Save",
+    cname: { name: "Name", value: "Target" },
+    // The dashboard's label for a TXT value is not on a docs page.
+    txt: { name: "Name", value: null },
+    root: "@",
+    traps: [{ kind: "proxyOff", field: "Proxy status", value: "DNS only" }, SHORT]
+  },
+  godaddy: {
+    name: "GoDaddy",
+    // Observed: ns<NN>.domaincontrol.com (GoDaddy's docs show only ns1).
+    ns: [/^ns\d{1,2}\.domaincontrol\.com$/],
+    link: null,
+    open: "DNS",
+    add: "Add New Record",
+    save: "Save",
+    cname: { name: "Name", value: "Value" },
+    txt: { name: "Name", value: "Value" },
+    root: "@",
+    traps: [SHORT]
+  },
+  namecheap: {
+    name: "Namecheap",
+    // Documented: dns1/2.registrar-servers.com (BasicDNS), pdns1/2 (PremiumDNS),
+    // freedns1-5 (FreeDNS).
+    ns: [/^(dns|pdns|freedns)\d\.registrar-servers\.com$/],
+    link: null,
+    open: "Advanced DNS",
+    add: "Add New Record",
+    save: "Save All Changes",
+    cname: { name: "Host", value: "Value" },
+    txt: { name: "Host", value: "Value" },
+    root: "@",
+    traps: [SHORT]
+  },
+  "namecheap-hosting": {
+    name: "Namecheap hosting",
+    // Documented: dns1/2.namecheaphosting.com. The records live in cPanel, not Advanced DNS.
+    ns: [/^dns\d\.namecheaphosting\.com$/],
+    ...CPANEL_EDITOR
+  },
+  squarespace: {
+    name: "Squarespace",
+    ns: [
+      // Documented: Google Cloud DNS nameservers "ending in squarespacedns.com".
+      /^[a-z0-9-]+\.squarespacedns\.com$/,
+      // Observed, listed so that these names read as ambiguous (domains moved from Google
+      // Domains sit on Google's names; older Squarespace domains on NS1's).
+      /^ns-cloud-[a-z]\d\.googledomains\.com$/,
+      /^dns\d\.p\d{2}\.nsone\.net$/
+    ],
+    link: null,
+    open: "DNS Settings",
+    add: "Add record",
+    save: "Save",
+    cname: { name: "Name", value: "Data" },
+    txt: { name: "Name", value: "Text" },
+    root: "@",
+    traps: [SHORT]
+  },
+  route53: {
+    name: "Amazon Route 53",
+    // Documented: ns-<n>.awsdns-<nn>.{com,net,org,co.uk}.
+    ns: [/^ns-\d+\.awsdns-\d+\.(com|net|org|co\.uk)$/],
+    link: "https://console.aws.amazon.com/route53/v2/hostedzones",
+    open: "Hosted zones",
+    add: "Create record",
+    save: "Create records",
+    cname: { name: "Record name", value: "Value" },
+    txt: { name: "Record name", value: "Value" },
+    // "don't enter a value (for example, an @ symbol) in the Name field".
+    root: "",
+    traps: [SHORT, QUOTED_TXT]
+  },
+  "google-cloud-dns": {
+    name: "Google Cloud DNS",
+    // Documented: ns-cloud-<a-d><1-4>.googledomains.com. Squarespace domains moved from
+    // Google Domains use the same names, so a set of them is ambiguous.
+    ns: [/^ns-cloud-[a-z]\d\.googledomains\.com$/],
+    link: null,
+    open: null,
+    add: "Add standard",
+    save: "Create",
+    cname: { name: "DNS name", value: null },
+    txt: { name: "DNS name", value: null },
+    // "To create a resource record at the domain apex, leave the DNS name field blank."
+    root: "",
+    traps: [SHORT]
+  },
+  "azure-dns": {
+    name: "Azure DNS",
+    // Documented: ns<1-4>-<nn>.azure-dns.{com,net,org,info}.
+    ns: [/^ns\d-\d+\.azure-dns\.(com|net|org|info)$/],
+    link: null,
+    open: "Record sets",
+    add: "Add",
+    save: "Add",
+    cname: { name: "Name", value: null },
+    txt: { name: "Name", value: null },
+    root: "@",
+    traps: [SHORT]
+  },
+  ionos: {
+    name: "IONOS",
+    // Documented: ns1<ZZZ>.ui-dns.{de,biz,org,com}, ZZZ from 016 to 126.
+    ns: [/^ns1\d{3}\.ui-dns\.(de|biz|org|com)$/],
+    link: null,
+    open: "DNS",
+    add: "Add Record",
+    save: "Save",
+    // The two articles spell the name box differently.
+    cname: { name: "Hostname", value: "Point to" },
+    txt: { name: "Host name", value: "Value" },
+    root: "@",
+    traps: [SHORT]
+  },
+  hostinger: {
+    name: "Hostinger",
+    // No pattern: ns1/2.dns-parking.com is a search snippet, never confirmed on a page of
+    // theirs. The picker reaches Hostinger.
+    ns: [],
+    link: null,
+    open: "DNS Zone Editor",
+    add: null,
+    save: "Add Record",
+    cname: { name: "Name", value: "Points to" },
+    txt: { name: "Name", value: "TXT value" },
+    root: "@",
+    traps: [SHORT, { kind: "oneSpf" }]
+  },
+  porkbun: {
+    name: "Porkbun",
+    // Documented: <city>.ns.porkbun.com.
+    ns: [/^[a-z]+\.ns\.porkbun\.com$/],
+    link: null,
+    open: "DNS",
+    add: "Add Record",
+    save: "Add",
+    cname: { name: "Host", value: "Answer" },
+    txt: { name: "Host", value: "Answer" },
+    // "If you're adding DNS records to your root domain, you will leave this field blank."
+    root: "",
+    traps: [SHORT]
+  },
+  "name-com": {
+    name: "Name.com",
+    // Observed: ns1<abc>.name.com to ns4<abc>.name.com.
+    ns: [/^ns[1-4][a-z]{3}\.name\.com$/],
+    link: null,
+    open: "Manage DNS Records",
+    add: null,
+    save: "Add Record",
+    cname: { name: "Host", value: "Answer" },
+    txt: { name: "Host", value: "Answer" },
+    root: null,
+    traps: [SHORT]
+  },
+  dynadot: {
+    name: "Dynadot",
+    // A Dynadot staff answer on its forum: ns1/2.dyna-ns.net.
+    ns: [/^ns\d\.dyna-ns\.net$/],
+    link: null,
+    open: "DNS Settings",
+    add: null,
+    save: "Save Settings",
+    cname: { name: "Subdomain Record", value: "IP Address or Target Host" },
+    txt: NO_FIELDS,
+    // The zone's own name goes in a separate "Domain Record" section, never as "@".
+    root: null,
+    traps: [SHORT]
+  },
+  namesilo: {
+    name: "NameSilo",
+    // Documented: ns1-3.dnsowl.com.
+    ns: [/^ns\d\.dnsowl\.com$/],
+    link: null,
+    open: null,
+    add: null,
+    save: "Submit",
+    cname: NO_FIELDS,
+    txt: NO_FIELDS,
+    // "You can leave the hostname blank ... If you do enter an "@", we will convert that".
+    root: "",
+    traps: []
+  },
+  gandi: {
+    name: "Gandi",
+    // Observed: ns-<n>-<a|b|c>.gandi.net.
+    ns: [/^ns-\d+-[abc]\.gandi\.net$/],
+    link: null,
+    open: "DNS Records",
+    add: "Add",
+    save: null,
+    cname: NO_FIELDS,
+    txt: NO_FIELDS,
+    root: null,
+    traps: [SHORT]
+  },
+  ovhcloud: {
+    name: "OVHcloud",
+    // Documented: (ns|dns)<nn or nnn>.ovh.net, and (ns|dns)200.anycast.me.
+    ns: [/^(ns|dns)\d{2,3}\.ovh\.net$/, /^(ns|dns)200\.anycast\.me$/],
+    link: null,
+    open: "DNS zone",
+    add: "Add an entry",
+    save: null,
+    cname: { name: "Subdomain", value: "Target" },
+    txt: { name: "Subdomain", value: "Target" },
+    root: null,
+    traps: [SHORT, TRAILING_DOT]
+  },
+  digitalocean: {
+    name: "DigitalOcean",
+    // Documented: ns1-3.digitalocean.com.
+    ns: [/^ns[1-3]\.digitalocean\.com$/],
+    link: null,
+    open: "Domains",
+    add: "Create a record",
+    save: "Create Record",
+    cname: { name: "Hostname", value: "Is an alias of" },
+    txt: { name: "Hostname", value: "TXT Value" },
+    root: "@",
+    traps: [SHORT, TRAILING_DOT]
+  },
+  hetzner: {
+    name: "Hetzner",
+    ns: [
+      // Documented: the primary, secondary (still used by older zones) and konsoleH names.
+      /^(hydrogen|oxygen|helium)\.ns\.hetzner\.(com|de)$/,
+      /^[a-z0-9]+\.first-ns\.de$/,
+      /^[a-z0-9]+\.second-ns\.(de|com)$/,
+      /^ns1\.your-server\.de$/
+    ],
+    link: null,
+    open: "DNS",
+    add: null,
+    save: "Add",
+    cname: { name: "Name", value: "Alias / Value" },
+    txt: { name: "Name", value: null },
+    root: "@",
+    traps: [SHORT, TRAILING_DOT, QUOTED_TXT]
+  },
+  vercel: {
+    name: "Vercel",
+    // Documented: ns1-4.vercel-dns.com (the "alternates" are not named).
+    ns: [/^ns[1-4]\.vercel-dns\.com$/],
+    link: "https://vercel.com/d?to=%2F%5Bteam%5D%2F%7E%2Fdomains",
+    open: "Domains",
+    add: null,
+    save: "Add",
+    cname: { name: "Name", value: "Value" },
+    txt: { name: "Name", value: "Value" },
+    // "Leave Name blank for the root domain."
+    root: "",
+    traps: [SHORT]
+  },
+  netlify: {
+    name: "Netlify",
+    // Documented: "a format similar to dns1.p01.nsone.net". NS1's names are shared with
+    // older Squarespace zones, so a set of them is ambiguous.
+    ns: [/^dns\d\.p\d{2}\.nsone\.net$/],
+    link: null,
+    open: "DNS",
+    add: "Add new record",
+    save: "Save",
+    cname: NO_FIELDS,
+    txt: NO_FIELDS,
+    root: null,
+    traps: []
+  },
+  wix: {
+    name: "Wix",
+    // Observed: ns<n>.wixdns.net. A domain "connected to Wix via pointing" keeps its old
+    // name servers, so it never matches here.
+    ns: [/^ns\d+\.wixdns\.net$/],
+    link: null,
+    open: "Manage DNS Records",
+    add: "Add Record",
+    save: "Save",
+    cname: { name: "Host Name", value: "Value" },
+    txt: { name: "Host Name", value: "Value" },
+    // "Leave this field blank if you were instructed to add an @ sign."
+    root: "",
+    traps: []
+  },
+  "wordpress-com": {
+    name: "WordPress.com",
+    // Documented: ns1-3.wordpress.com.
+    ns: [/^ns[1-3]\.wordpress\.com$/],
+    link: "https://wordpress.com/domains/",
+    open: "DNS records",
+    add: "Add record",
+    save: null,
+    cname: { name: "Name (host)", value: "Alias of (points to)" },
+    txt: { name: "Name", value: "Text" },
+    root: "@",
+    // The Name box takes the label or the whole name, and ignores quotes around a TXT value.
+    traps: []
+  },
+  cpanel: {
+    // Hosting companies run their own name servers, so there is no pattern: the picker
+    // reaches it.
+    name: "cPanel",
+    ns: [],
+    ...CPANEL_EDITOR
+  },
+  bluehost: {
+    name: "Bluehost",
+    // Documented: ns1/2.bluehost.com. Its help is behind a captcha and the menu path was
+    // read from a 2024 archive, so no label is quoted.
+    ns: [/^ns[12]\.bluehost\.com$/],
+    link: null,
+    open: null,
+    add: null,
+    save: null,
+    cname: NO_FIELDS,
+    txt: NO_FIELDS,
+    root: null,
+    traps: []
+  },
+  hostgator: {
+    name: "HostGator",
+    // Documented: hgns1/2.hostgator.com for new customers, ns<NNNN>.hostgator.com before
+    // November 2023.
+    ns: [/^hgns\d\.hostgator\.com$/, /^ns\d{4}\.hostgator\.com$/],
+    link: null,
+    open: "DNS",
+    add: "+ ADD RECORD",
+    save: "ADD",
+    cname: NO_FIELDS,
+    txt: NO_FIELDS,
+    root: null,
+    traps: []
+  },
+  "hostgator-br": {
+    name: "HostGator Brasil",
+    // Documented: dns3/4.hostgator.com.br for a registered domain with no plan yet. A plan's
+    // names come in its activation email and are not on a page.
+    ns: [/^dns[34]\.hostgator\.com\.br$/],
+    link: null,
+    open: "Editar Zona Avan\xE7ada de DNS",
+    add: "Adicionar registro",
+    save: "Adicionar",
+    // The value box's name changes with the type ("O nome é alterado conforme o Tipo").
+    cname: { name: "Nome", value: null },
+    txt: { name: "Nome", value: null },
+    root: null,
+    traps: []
+  },
+  siteground: {
+    name: "SiteGround",
+    // Documented: ns1/2.siteground.net.
+    ns: [/^ns[12]\.siteground\.net$/],
+    link: null,
+    open: "DNS Zone Editor",
+    add: null,
+    save: "Create",
+    cname: { name: "Name", value: null },
+    txt: { name: "Name", value: null },
+    root: null,
+    traps: [SHORT]
+  },
+  "registro-br": {
+    name: "Registro.br",
+    // Observed: a.auto.dns.br and b.auto.dns.br.
+    ns: [/^[ab]\.auto\.dns\.br$/],
+    link: null,
+    open: "CONFIGURAR ZONA DNS",
+    add: null,
+    save: null,
+    cname: NO_FIELDS,
+    txt: NO_FIELDS,
+    root: null,
+    traps: [{ kind: "advancedMode", mode: "Modo Avan\xE7ado" }]
+  },
+  locaweb: {
+    name: "Locaweb",
+    // Documented: ns1-3.locaweb.com.br.
+    ns: [/^ns[1-3]\.locaweb\.com\.br$/],
+    link: null,
+    open: "Editar zona DNS",
+    add: "Adicionar entrada",
+    save: null,
+    cname: { name: "Entrada", value: "Conte\xFAdo" },
+    txt: { name: "Entrada", value: "Conte\xFAdo" },
+    // "o campo Entrada é preenchido por padrão com apenas um ponto (.)".
+    root: ".",
+    traps: []
+  },
+  kinghost: {
+    name: "KingHost",
+    // Documented: dns1-6.kinghost.com.br.
+    ns: [/^dns[1-6]\.kinghost\.com\.br$/],
+    link: null,
+    open: "Gerenciar DNS",
+    add: "+ ADICIONAR DNS",
+    save: "ADICIONAR DNS",
+    // The form is a screenshot, so the case of "host" and "destino" is unconfirmed.
+    cname: NO_FIELDS,
+    txt: NO_FIELDS,
+    root: "@",
+    traps: [{ kind: "secondSave", button: "SALVAR ALTERA\xC7\xD5ES" }]
+  },
+  "uol-host": {
+    name: "UOL Host",
+    // Documented: ns1-3.dominios.uol.com.br.
+    ns: [/^ns[1-3]\.dominios\.uol\.com\.br$/],
+    link: null,
+    open: "Administrar DNS",
+    add: "Criar nova entrada",
+    save: "Salvar entrada",
+    cname: { name: "Entrada", value: "Destino" },
+    txt: { name: "Entrada", value: "Valor" },
+    root: "",
+    traps: []
+  },
+  umbler: {
+    name: "Umbler",
+    // Documented: ns<NNN>.umbler.{com,in,com.br,co.uk}.
+    ns: [/^ns\d{3}\.umbler\.(com|in|com\.br|co\.uk)$/],
+    link: null,
+    open: "Editor de DNS",
+    add: "Adicionar",
+    save: "Salvar",
+    cname: { name: "Nome", value: "Endere\xE7o" },
+    txt: { name: "Nome", value: "Dados" },
+    root: "@",
+    traps: [SHORT]
+  },
+  dnsimple: {
+    name: "DNSimple",
+    // Documented: ns1-4.dnsimple-edge.{com,net,io,org}, and the legacy ns1-4.dnsimple.com.
+    ns: [/^ns[1-4]\.dnsimple-edge\.(com|net|io|org)$/, /^ns[1-4]\.dnsimple\.com$/],
+    link: null,
+    open: "Record editor",
+    add: "Add record",
+    save: "Add Record",
+    cname: { name: "Name", value: "Content" },
+    txt: { name: "Name", value: "Content" },
+    root: "",
+    traps: [SHORT]
+  }
+};
+function trapOf(host, kind) {
+  return host.traps.find((trap) => trap.kind === kind);
+}
+function detectDnsHosts(nameservers) {
+  const names = nameservers.map(normalizeDnsName).filter(Boolean);
+  if (!names.length) return [];
+  return DNS_HOST_IDS.filter(
+    (id) => names.every((name) => DNS_HOSTS[id].ns.some((pattern) => pattern.test(name)))
+  );
+}
+
+export {
+  DNS_HOST_IDS,
+  DNS_HOSTS,
+  trapOf,
+  detectDnsHosts
+};