apertodns 2.0.1 → 2.0.3

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/apertodns.svg)](https://www.npmjs.com/package/apertodns)
 [![npm downloads](https://img.shields.io/npm/dm/apertodns.svg)](https://www.npmjs.com/package/apertodns)
-[![license](https://img.shields.io/npm/l/apertodns.svg)](https://github.com/1r0n3d3v3l0per/apertodns/blob/main/LICENSE)
+[![license](https://img.shields.io/npm/l/apertodns.svg)](https://github.com/apertodns/apertodns/blob/main/LICENSE)
 [![node](https://img.shields.io/node/v/apertodns.svg)](https://nodejs.org)
 
 **Dynamic DNS management from your terminal.** Manage domains, tokens, API keys, and DNS updates with style.
@@ -11,16 +11,19 @@ ApertoDNS is a free Dynamic DNS service that lets you point a subdomain to your
 
 ## Why ApertoDNS?
 
-| Feature | ApertoDNS | No-IP | DuckDNS | Dynu |
-|---------|-----------|-------|---------|------|
-| Free subdomains | Unlimited | 1 (free) | 5 | 4 |
-| API Keys with scopes | Yes | No | No | Limited |
+| Feature | ApertoDNS | Dyn (Oracle) | No-IP | DuckDNS |
+|---------|-----------|--------------|-------|---------|
+| Free plan | Yes | No ($55/yr) | Yes | Yes |
+| Free subdomains | Unlimited | 0 | 1 | 5 |
+| API Keys with scopes | Yes | No | No | No |
 | CLI tool | Yes | No | No | No |
-| IPv6 support | Yes | Paid | Yes | Yes |
-| No forced renewal | Yes | 30 days | Yes | Yes |
-| DynDNS2 compatible | Yes | Yes | No | Yes |
+| Docker images | Yes | No | No | No |
+| IPv6 support | Yes | Paid | Paid | Yes |
+| No forced renewal | Yes | N/A | 30 days | Yes |
+| DynDNS2 compatible | Yes | Yes | Yes | No |
 | Webhooks | Yes | No | No | No |
 | Team sharing | Yes | No | No | No |
+| Open Source | Yes | No | No | No |
 
 ## Features
 
@@ -33,6 +36,7 @@ ApertoDNS is a free Dynamic DNS service that lets you point a subdomain to your
 - **IPv4 & IPv6** - Full dual-stack support
 - **Real-time Stats** - View usage statistics and logs
 - **Router/NAS Compatible** - Works with Synology, QNAP, and DynDNS2-compatible routers
+- **Docker Images** - Official [apertodns/cli](https://hub.docker.com/r/apertodns/cli) and [apertodns/updater](https://hub.docker.com/r/apertodns/updater) images
 
 ## Requirements
 
@@ -94,6 +98,27 @@ apertodns --force
 | `--add-domain <name>` | Create a new subdomain |
 | `--delete-domain` | Delete a domain (interactive) |
 | `--test <domain>` | Test DNS resolution |
+| `update <domain>` | Update a specific domain's IP (use with `--api-key`) |
+
+### TXT Records (ACME DNS-01)
+
+| Command | Description |
+|---------|-------------|
+| `--txt-set <host> <name> <value>` | Set a TXT record |
+| `--txt-delete <host> <name>` | Delete a TXT record |
+
+Perfect for Let's Encrypt DNS-01 challenges:
+
+```bash
+# Set TXT record for certificate validation
+apertodns --txt-set example.apertodns.com _acme-challenge "validation-token"
+
+# Delete TXT record after certificate issuance
+apertodns --txt-delete example.apertodns.com _acme-challenge
+
+# Use with API key for automation
+apertodns --api-key apertodns_live_xxx... --txt-set example.apertodns.com _acme-challenge "token" --json
+```
 
 ### Token Management
 
@@ -123,7 +148,15 @@ apertodns --force
 | `--config` | Edit configuration |
 | `--logout` | Remove local configuration |
 | `--force` | Force DNS update now |
-| `--update` | Standalone DynDNS2 update (with `--domain` and `--token`) |
+
+### Standalone Update (DynDNS2)
+
+| Command | Description |
+|---------|-------------|
+| `--update` | Standalone DynDNS2 update (no config required) |
+| `--domain <fqdn>` | Domain to update (with --update) |
+| `--token <token>` | Token for authentication (with --update) |
+| `--ip <address>` | Custom IP address (optional, auto-detected if omitted) |
 
 ### Daemon Mode
 
@@ -170,7 +203,7 @@ apertodns --domains --json
 apertodns --my-ip --json
 
 # Combine with API key for scripting
-apertodns --api-key ak_xxx... --domains --json
+apertodns --api-key apertodns_live_xxx... --domains --json
 ```
 
 ## Daemon Mode
@@ -185,6 +218,49 @@ apertodns --daemon
 apertodns --daemon --interval 60
 ```
 
+## Standalone Update
+
+Update DNS without any saved configuration - perfect for scripts and one-off updates:
+
+```bash
+# Auto-detect IP and update
+apertodns --update --domain myserver.apertodns.com --token YOUR_TOKEN
+
+# Specify custom IP
+apertodns --update --domain myserver.apertodns.com --token YOUR_TOKEN --ip 203.0.113.42
+```
+
+## Docker
+
+Run without installing Node.js:
+
+```bash
+# Run CLI via Docker
+docker run --rm apertodns/cli --help
+
+# Interactive setup (persisted config)
+docker run -it -v apertodns_config:/root/.config/apertodns apertodns/cli --setup
+
+# List domains
+docker run -v apertodns_config:/root/.config/apertodns apertodns/cli --domains
+
+# Standalone update (no config needed)
+docker run --rm apertodns/cli --update --domain myhost.apertodns.com --token YOUR_TOKEN
+```
+
+For continuous updates, use the dedicated updater image:
+
+```bash
+docker run -d \
+  --name apertodns-updater \
+  --restart unless-stopped \
+  -e TOKEN=your_token \
+  -e DOMAINS=myhost.apertodns.com \
+  apertodns/updater
+```
+
+See [Docker Hub](https://hub.docker.com/r/apertodns/cli) for more options.
+
 ## Automatic Updates (Cron)
 
 Set up automatic IP updates with cron:
@@ -295,7 +371,7 @@ apertodns --add-domain newserver.apertodns.com
 apertodns --domains --json
 
 # Use API key for automation
-APERTODNS_API_KEY=ak_xxx... apertodns --domains --json
+APERTODNS_API_KEY=apertodns_live_xxx... apertodns --domains --json
 ```
 
 ## Links
@@ -303,12 +379,12 @@ APERTODNS_API_KEY=ak_xxx... apertodns --domains --json
 - **Website**: [apertodns.com](https://apertodns.com)
 - **Dashboard**: [apertodns.com/dashboard](https://apertodns.com/dashboard)
 - **Documentation**: [apertodns.com/docs](https://apertodns.com/docs)
-- **Issues**: [GitHub Issues](https://github.com/1r0n3d3v3l0per/apertodns/issues)
+- **Issues**: [GitHub Issues](https://github.com/apertodns/apertodns/issues)
 
 ## Support
 
 Need help?
-- Open an issue on [GitHub](https://github.com/1r0n3d3v3l0per/apertodns/issues)
+- Open an issue on [GitHub](https://github.com/apertodns/apertodns/issues)
 - Email: support@apertodns.com
 
 ## License

package/index.js

@@ -184,6 +184,19 @@ const daemonInterval = getOption("--interval") ? parseInt(getOption("--interval"
 const showMyIp = args.includes("--my-ip") || args.includes("--ip") || subcommand === "ip" || subcommand === "my-ip";
 const logout = args.includes("--logout") || subcommand === "logout";
 
+// TXT record commands (ACME DNS-01 challenges)
+const txtSetIdx = args.indexOf("--txt-set");
+const txtSetArgs = txtSetIdx !== -1 ? {
+  hostname: args[txtSetIdx + 1],
+  name: args[txtSetIdx + 2],
+  value: args[txtSetIdx + 3]
+} : null;
+const txtDeleteIdx = args.indexOf("--txt-delete");
+const txtDeleteArgs = txtDeleteIdx !== -1 ? {
+  hostname: args[txtDeleteIdx + 1],
+  name: args[txtDeleteIdx + 2]
+} : null;
+
 // JSON output helper
 const jsonOutput = (data) => {
   if (showJson) {
@@ -214,6 +227,10 @@ ${chalk.bold("GESTIONE DOMINI:")}
   ${cyan("--delete-domain")}      Elimina un dominio (interattivo)
   ${cyan("--test")} <domain>      Testa risoluzione DNS di un dominio
 
+${chalk.bold("TXT RECORDS (ACME DNS-01):")}
+  ${cyan("--txt-set")} <host> <name> <val>   Imposta record TXT
+  ${cyan("--txt-delete")} <host> <name>      Elimina record TXT
+
 ${chalk.bold("GESTIONE TOKEN:")}
   ${cyan("--enable")} <id>        Attiva un token
   ${cyan("--disable")} <id>       Disattiva un token
@@ -361,9 +378,15 @@ const fetchDomains = async () => {
   const token = await getAuthToken();
   const spin = !showJson ? spinner("Caricamento domini...").start() : null;
   try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15000);
+
     const res = await fetch(`${API_BASE}/domains`, {
-      headers: getAuthHeaders(token)
+      headers: getAuthHeaders(token),
+      signal: controller.signal
     });
+    clearTimeout(timeout);
+
     spin?.stop();
     if (!res.ok) {
       const err = await res.json().catch(() => ({}));
@@ -371,7 +394,7 @@ const fetchDomains = async () => {
     }
     return await res.json();
   } catch (err) {
-    spin?.fail("Errore caricamento domini");
+    spin?.fail(err.name === 'AbortError' ? "Timeout caricamento domini" : "Errore caricamento domini");
     throw err;
   }
 };
@@ -636,6 +659,127 @@ const testDnsResolution = async (domain) => {
   }
 };
 
+// ==================== TXT RECORDS ====================
+
+const IETF_BASE = "https://api.apertodns.com/.well-known/apertodns/v1";
+
+const setTxtRecord = async (hostname, name, value) => {
+  if (!hostname || !name || !value) {
+    if (showJson) {
+      console.log(JSON.stringify({ error: "Uso: --txt-set <hostname> <name> <value>" }));
+    } else {
+      console.log(red("\n❌ Uso: --txt-set <hostname> <name> <value>"));
+      console.log(gray("   Esempio: --txt-set mio.apertodns.com _acme-challenge abc123\n"));
+    }
+    return;
+  }
+
+  const token = await getAuthToken();
+  const spin = !showJson ? spinner(`Impostazione TXT ${name}.${hostname}...`).start() : null;
+
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15000);
+
+    const res = await fetch(`${IETF_BASE}/update`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...getAuthHeaders(token)
+      },
+      body: JSON.stringify({
+        hostname,
+        txt: {
+          name,
+          value,
+          action: "set"
+        }
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+
+    const data = await res.json();
+
+    if (res.ok && data.success !== false) {
+      spin?.succeed(`TXT record impostato: ${name}.${hostname}`);
+      if (showJson) {
+        console.log(JSON.stringify({ success: true, hostname, txt: { name, value, action: "set" }, response: data }, null, 2));
+      } else {
+        console.log(gray(`   Nome: ${cyan(name)}`));
+        console.log(gray(`   Valore: ${cyan(value)}`));
+        console.log();
+      }
+    } else {
+      spin?.fail(`Errore: ${data.error || data.message || 'TXT non supportato'}`);
+      if (showJson) {
+        console.log(JSON.stringify({ error: data.error || data.message }));
+      }
+    }
+  } catch (err) {
+    spin?.fail(err.name === 'AbortError' ? "Timeout" : err.message);
+    if (showJson) {
+      console.log(JSON.stringify({ error: err.message }));
+    }
+  }
+};
+
+const deleteTxtRecord = async (hostname, name) => {
+  if (!hostname || !name) {
+    if (showJson) {
+      console.log(JSON.stringify({ error: "Uso: --txt-delete <hostname> <name>" }));
+    } else {
+      console.log(red("\n❌ Uso: --txt-delete <hostname> <name>"));
+      console.log(gray("   Esempio: --txt-delete mio.apertodns.com _acme-challenge\n"));
+    }
+    return;
+  }
+
+  const token = await getAuthToken();
+  const spin = !showJson ? spinner(`Eliminazione TXT ${name}.${hostname}...`).start() : null;
+
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15000);
+
+    const res = await fetch(`${IETF_BASE}/update`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...getAuthHeaders(token)
+      },
+      body: JSON.stringify({
+        hostname,
+        txt: {
+          name,
+          action: "delete"
+        }
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+
+    const data = await res.json();
+
+    if (res.ok && data.success !== false) {
+      spin?.succeed(`TXT record eliminato: ${name}.${hostname}`);
+      if (showJson) {
+        console.log(JSON.stringify({ success: true, hostname, txt: { name, action: "delete" }, response: data }, null, 2));
+      }
+    } else {
+      spin?.fail(`Errore: ${data.error || data.message || 'TXT non supportato'}`);
+      if (showJson) {
+        console.log(JSON.stringify({ error: data.error || data.message }));
+      }
+    }
+  } catch (err) {
+    spin?.fail(err.name === 'AbortError' ? "Timeout" : err.message);
+    if (showJson) {
+      console.log(JSON.stringify({ error: err.message }));
+    }
+  }
+};
+
 // ==================== TOKENS ====================
 
 const fetchTokens = async () => {
@@ -1799,6 +1943,8 @@ const interactiveMode = async () => {
 const main = async () => {
   try {
     if (logout) await runLogout();
+    else if (txtSetArgs) await setTxtRecord(txtSetArgs.hostname, txtSetArgs.name, txtSetArgs.value);
+    else if (txtDeleteArgs) await deleteTxtRecord(txtDeleteArgs.hostname, txtDeleteArgs.name);
     else if (showMyIp) await showMyIpCommand();
     else if (runDaemon) await runDaemonMode();
     else if (enableTokenId) await updateTokenState(enableTokenId, true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apertodns",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "ApertoDNS CLI - Dynamic DNS management from your terminal. Manage domains, tokens, API keys and DNS updates with style.",
   "main": "index.js",
   "type": "module",
@@ -30,15 +30,15 @@
     "qnap",
     "router"
   ],
-  "author": "Aperto Network <info@apertodns.com>",
+  "author": "Andrea Ferro <support@apertodns.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/1r0n3d3v3l0per/apertodns.git"
+    "url": "https://github.com/apertodns/apertodns.git"
   },
   "homepage": "https://apertodns.com",
   "bugs": {
-    "url": "https://github.com/1r0n3d3v3l0per/apertodns/issues"
+    "url": "https://github.com/apertodns/apertodns/issues"
   },
   "engines": {
     "node": ">=18.0.0"