@hhkaos/webmentions-widget 0.5.2 → 0.5.4

package/bin/snapshot.js

@@ -15,9 +15,10 @@
  * WEBMENTION_IO_TOKEN, or --token. Domain queries require it.
  */
 
+import {realpathSync} from 'node:fs';
 import {readFile, writeFile, mkdir} from 'node:fs/promises';
 import {dirname} from 'node:path';
-import {pathToFileURL} from 'node:url';
+import {fileURLToPath} from 'node:url';
 
 import {getSnapshotMentions, mergeSnapshot, parseWebmentionJson} from '../src/core.js';
 
@@ -164,12 +165,25 @@ async function main() {
 
   const before = getSnapshotMentions(existing).length;
 
-  if (!collected.length && existing) {
-    console.log(`No new mentions since #${sinceId}. Snapshot unchanged (${before}).`);
+  console.log(`Fetched ${collected.length} mention(s) for ${domain}${sinceId ? ` since #${sinceId}` : ''}.`);
+
+  if (!collected.length) {
+    if (args.full) {
+      // An authoritative refetch that came back empty is far more likely to be
+      // a wrong --domain than a genuinely empty account, so keep what we have.
+      console.log('Nothing returned for a full refresh; keeping the current snapshot.');
+      return;
+    }
+
+    console.log(`Snapshot unchanged (${before}).`);
     return;
   }
 
-  const snapshot = mergeSnapshot(existing, collected);
+  // A full refetch is authoritative: replace rather than merge, so mentions
+  // collected under a domain we no longer query do not linger forever.
+  const snapshot = args.full
+    ? mergeSnapshot(null, collected)
+    : mergeSnapshot(existing, collected);
 
   if (snapshot.count === before) {
     console.log(`Snapshot unchanged (${before} mentions).`);
@@ -182,8 +196,27 @@ async function main() {
   console.log(`Snapshot updated: ${before} → ${snapshot.count} mentions (lastId ${snapshot.lastId}).`);
 }
 
-// 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) {
+/**
+ * True when this file is the process entry point.
+ *
+ * Compared through realpath on both sides: npm installs a bin as a symlink in
+ * node_modules/.bin, so argv[1] is that link rather than this file, and a
+ * naive URL comparison makes the command a silent no-op.
+ */
+function isEntryPoint() {
+  if (!process.argv[1]) {
+    return false;
+  }
+
+  try {
+    return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+}
+
+// Guarded so the helpers above stay importable by tests.
+if (isEntryPoint()) {
   main().catch((error) => {
     console.error(error);
     process.exit(1);

package/package.json

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