@hhkaos/webmentions-widget 0.5.0 → 0.5.2

package/bin/snapshot.js

@@ -17,16 +17,18 @@
 
 import {readFile, writeFile, mkdir} from 'node:fs/promises';
 import {dirname} from 'node:path';
+import {pathToFileURL} from 'node:url';
 
 import {getSnapshotMentions, mergeSnapshot, parseWebmentionJson} from '../src/core.js';
 
 const DEFAULT_API = 'https://webmention.io/api/mentions.jf2';
 const PER_PAGE = 100;
 const PAGE_DELAY_MS = 500;
-const RETRIES = 4;
-const RETRY_DELAY_MS = 2000;
+const RETRIES = 8;
+const RETRY_DELAY_MS = 3000;
+const MAX_RETRY_DELAY_MS = 30000;
 
-function parseArgs(argv) {
+export function parseArgs(argv) {
   const args = {};
 
   argv.forEach((arg, index) => {
@@ -35,7 +37,18 @@ function parseArgs(argv) {
     }
 
     const [flag, inline] = arg.slice(2).split('=');
-    args[flag] = inline ?? (argv[index + 1]?.startsWith('--') ? true : argv[index + 1]);
+
+    if (inline !== undefined) {
+      args[flag] = inline;
+      return;
+    }
+
+    const next = argv[index + 1];
+
+    // A flag is boolean when nothing follows it, or when what follows is
+    // another flag. `--full` as the last argument is the common case, and
+    // reading it as its (missing) value silently disabled it.
+    args[flag] = next === undefined || next.startsWith('--') ? true : next;
   });
 
   return args;
@@ -61,7 +74,13 @@ async function fetchPage(url) {
 
   for (let attempt = 0; attempt <= RETRIES; attempt += 1) {
     if (attempt > 0) {
-      await wait(RETRY_DELAY_MS * 2 ** (attempt - 1));
+      // Capped exponential backoff with jitter. webmention.io has spent today
+      // failing roughly two requests in three, so a job that gives up after
+      // half a minute loses the coin flip often enough to skip whole days; a
+      // daily job can afford to be patient for a couple of minutes instead.
+      const backoff = Math.min(RETRY_DELAY_MS * 2 ** (attempt - 1), MAX_RETRY_DELAY_MS);
+
+      await wait(backoff + Math.random() * 1000);
     }
 
     try {
@@ -163,7 +182,10 @@ async function main() {
   console.log(`Snapshot updated: ${before} → ${snapshot.count} mentions (lastId ${snapshot.lastId}).`);
 }
 
-main().catch((error) => {
-  console.error(error);
-  process.exit(1);
-});
+// Only run when invoked as a command, so the helpers above stay testable.
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hhkaos/webmentions-widget",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Framework-agnostic, dependency-free widget to fetch and render webmention.io mentions for the current page.",
   "type": "module",
   "license": "MIT",