@rmdes/indiekit-endpoint-webmention-io 1.0.0

package/locales/en.json

@@ -0,0 +1,75 @@
+{
+  "webmention-io": {
+    "title": "Webmentions",
+    "webmentions": {
+      "none": "No webmentions found. Try running a sync."
+    },
+    "mention": {
+      "bookmark-of": "bookmarked %s",
+      "in-reply-to": "replied to %s",
+      "like-of": "liked %s",
+      "mention-of": "mentioned %s",
+      "repost-of": "reposted %s",
+      "rsvp": "responded to %s"
+    },
+    "sync": {
+      "now": "Sync Now",
+      "full": "Full Re-sync",
+      "lastSync": "Last synced",
+      "never": "Never synced",
+      "synced": "Sync complete",
+      "added": "new mentions added",
+      "inProgress": "Sync in progress…"
+    },
+    "filter": {
+      "all": "All",
+      "visible": "Visible",
+      "hidden": "Hidden",
+      "show": "Show",
+      "type": "Type",
+      "likes": "Likes",
+      "replies": "Replies",
+      "reposts": "Reposts",
+      "mentions": "Mentions"
+    },
+    "actions": {
+      "hide": "Hide",
+      "unhide": "Unhide",
+      "block": "Block",
+      "hidden": "Hidden",
+      "reasonManual": "manual",
+      "reasonBlocklist": "blocklist",
+      "reasonPrivacy": "privacy"
+    },
+    "blocklist": {
+      "title": "Webmention Blocklist",
+      "description": "Blocked domains will not appear in webmentions. Existing mentions from blocked domains are automatically hidden.",
+      "add": "Block a Domain",
+      "domainLabel": "Domain",
+      "domainPlaceholder": "spam.example.com",
+      "reasonLabel": "Reason",
+      "reasonSpam": "Spam",
+      "reasonManual": "Manual",
+      "blockButton": "Block Domain",
+      "unblock": "Unblock",
+      "empty": "No domains blocked.",
+      "privacy": {
+        "title": "Privacy Removal",
+        "description": "Permanently delete all webmentions from a domain and block future ones. Use for GDPR or personal removal requests.",
+        "domainLabel": "Domain to remove",
+        "removeButton": "Remove & Block"
+      },
+      "blocked": "Domain blocked",
+      "unblocked": "Domain unblocked",
+      "removed": "mentions permanently deleted",
+      "unhidden": "mentions restored",
+      "mentionsHidden": "mentions hidden",
+      "blockedAt": "Blocked"
+    },
+    "counts": {
+      "total": "total",
+      "hidden": "hidden",
+      "visible": "visible"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@rmdes/indiekit-endpoint-webmention-io",
+  "version": "1.0.0",
+  "description": "Webmention moderation endpoint for Indiekit. Syncs webmentions from webmention.io into MongoDB with delete, block, and privacy removal capabilities.",
+  "keywords": [
+    "indiekit",
+    "indiekit-plugin",
+    "indieweb",
+    "webmention",
+    "moderation"
+  ],
+  "homepage": "https://github.com/rmdes/indiekit-endpoint-webmention-io",
+  "bugs": {
+    "url": "https://github.com/rmdes/indiekit-endpoint-webmention-io/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rmdes/indiekit-endpoint-webmention-io.git"
+  },
+  "author": {
+    "name": "Ricardo Mendes",
+    "url": "https://rmendes.net"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "lib",
+    "locales",
+    "views",
+    "index.js"
+  ],
+  "dependencies": {
+    "@indiekit/error": "^1.0.0-beta.25",
+    "@indiekit/frontend": "^1.0.0-beta.25",
+    "express": "^5.0.0",
+    "sanitize-html": "^2.14.0"
+  },
+  "peerDependencies": {
+    "@indiekit/indiekit": ">=1.0.0-beta.25"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/views/webmentions-blocklist.njk

@@ -0,0 +1,193 @@
+{% extends "document.njk" %}
+
+{% block content %}
+<style>
+  .bl-section {
+    background: var(--color-offset, #f5f5f5);
+    border-radius: var(--border-radius-small, 0.5rem);
+    padding: var(--space-m, 1.5rem);
+    margin-block-end: var(--space-m, 1.5rem);
+  }
+
+  .bl-section h2 {
+    font: var(--font-heading, bold 1.25rem/1.4 sans-serif);
+    margin-block-end: var(--space-xs, 0.5rem);
+  }
+
+  .bl-section__desc {
+    color: var(--color-on-offset, #666);
+    font: var(--font-body, 0.875rem/1.5 sans-serif);
+    margin-block-end: var(--space-s, 0.75rem);
+  }
+
+  .bl-form {
+    display: flex;
+    gap: var(--space-xs, 0.5rem);
+    align-items: flex-end;
+    flex-wrap: wrap;
+  }
+
+  .bl-form .field {
+    flex: 1;
+    min-width: 200px;
+  }
+
+  .bl-form .field__label {
+    display: block;
+    font: var(--font-caption, 0.75rem/1.4 sans-serif);
+    font-weight: 600;
+    margin-block-end: 0.25rem;
+  }
+
+  .bl-form .field__input {
+    width: 100%;
+    padding: var(--space-2xs, 0.375rem) var(--space-xs, 0.5rem);
+    border: 1px solid var(--color-outline-variant, #ccc);
+    border-radius: var(--border-radius-small, 0.25rem);
+    font: var(--font-body, 0.875rem/1.5 sans-serif);
+  }
+
+  .bl-table {
+    width: 100%;
+    border-collapse: collapse;
+    font: var(--font-body, 0.875rem/1.5 sans-serif);
+  }
+
+  .bl-table th {
+    text-align: left;
+    font-weight: 600;
+    padding: var(--space-xs, 0.5rem);
+    border-block-end: 2px solid var(--color-outline-variant, #ddd);
+  }
+
+  .bl-table td {
+    padding: var(--space-xs, 0.5rem);
+    border-block-end: 1px solid var(--color-outline-variant, #eee);
+    vertical-align: middle;
+  }
+
+  .bl-badge {
+    display: inline-block;
+    font: var(--font-caption, 0.6875rem/1.4 sans-serif);
+    padding: 0.125rem 0.375rem;
+    border-radius: var(--border-radius-small, 0.25rem);
+    background: var(--color-offset, #e9ecef);
+  }
+
+  .bl-badge--privacy {
+    background: var(--color-error-container, #f8d7da);
+    color: var(--color-error, #dc3545);
+  }
+
+  .bl-badge--spam {
+    background: var(--color-warning-container, #fff3cd);
+    color: var(--color-warning, #856404);
+  }
+
+  .bl-empty {
+    color: var(--color-on-offset, #666);
+    text-align: center;
+    padding: var(--space-m, 1rem);
+  }
+
+  .bl-success {
+    background: var(--color-success-container, #d4edda);
+    border: 1px solid var(--color-success, #28a745);
+    border-radius: var(--border-radius-small, 0.25rem);
+    padding: var(--space-s, 0.75rem);
+    margin-block-end: var(--space-m, 1rem);
+  }
+
+  .bl-back {
+    margin-block-end: var(--space-m, 1rem);
+  }
+</style>
+
+<div class="bl-back">
+  <a href="{{ wmEndpoint }}">&larr; {{ __("webmention-io.title") }}</a>
+</div>
+
+{# Flash messages #}
+{% if request.query.unblocked %}
+<div class="bl-success">
+  {{ __("webmention-io.blocklist.unblocked") }} — {{ request.query.unhidden or 0 }} {{ __("webmention-io.blocklist.unhidden") }}
+</div>
+{% endif %}
+{% if request.query.removed %}
+<div class="bl-success">
+  {{ request.query.count or 0 }} {{ __("webmention-io.blocklist.removed") }}
+</div>
+{% endif %}
+
+{# Add to blocklist #}
+<section class="bl-section">
+  <h2>{{ __("webmention-io.blocklist.add") }}</h2>
+  <p class="bl-section__desc">{{ __("webmention-io.blocklist.description") }}</p>
+
+  <form method="post" action="{{ wmEndpoint }}/block" class="bl-form">
+    <div class="field">
+      <label class="field__label">{{ __("webmention-io.blocklist.domainLabel") }}</label>
+      <input type="text" name="domain" class="field__input" placeholder="{{ __("webmention-io.blocklist.domainPlaceholder") }}" required>
+    </div>
+    <button type="submit" class="button button--primary">{{ __("webmention-io.blocklist.blockButton") }}</button>
+  </form>
+</section>
+
+{# Privacy removal #}
+<section class="bl-section">
+  <h2>{{ __("webmention-io.blocklist.privacy.title") }}</h2>
+  <p class="bl-section__desc">{{ __("webmention-io.blocklist.privacy.description") }}</p>
+
+  <form method="post" action="{{ wmEndpoint }}/privacy-remove" class="bl-form"
+        onsubmit="return confirm('This will PERMANENTLY DELETE all webmentions from this domain and block it. This cannot be undone. Continue?')">
+    <div class="field">
+      <label class="field__label">{{ __("webmention-io.blocklist.privacy.domainLabel") }}</label>
+      <input type="text" name="domain" class="field__input" placeholder="{{ __("webmention-io.blocklist.domainPlaceholder") }}" required>
+    </div>
+    <button type="submit" class="button button--primary">{{ __("webmention-io.blocklist.privacy.removeButton") }}</button>
+  </form>
+</section>
+
+{# Blocklist table #}
+<section class="bl-section">
+  <h2>{{ __("webmention-io.blocklist.title") }} ({{ entries.length }})</h2>
+
+  {% if entries.length > 0 %}
+  <table class="bl-table">
+    <thead>
+      <tr>
+        <th>{{ __("webmention-io.blocklist.domainLabel") }}</th>
+        <th>{{ __("webmention-io.blocklist.reasonLabel") }}</th>
+        <th>{{ __("webmention-io.blocklist.mentionsHidden") }}</th>
+        <th>{{ __("webmention-io.blocklist.blockedAt") }}</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      {% for entry in entries %}
+      <tr>
+        <td><strong>{{ entry.domain }}</strong></td>
+        <td>
+          <span class="bl-badge {% if entry.reason == 'privacy' %}bl-badge--privacy{% elif entry.reason == 'spam' %}bl-badge--spam{% endif %}">
+            {{ entry.reason }}
+          </span>
+        </td>
+        <td>{{ entry.mentionsHidden or 0 }}</td>
+        <td>{{ entry.blockedAt | date }}</td>
+        <td>
+          <form method="post" action="{{ wmEndpoint }}/blocklist/{{ entry.domain | urlencode }}/delete" style="display:inline">
+            <button type="submit" class="button button--small button--secondary"
+                    onclick="return confirm('Unblock {{ entry.domain }}? Mentions hidden by this block will be restored.')">
+              {{ __("webmention-io.blocklist.unblock") }}
+            </button>
+          </form>
+        </td>
+      </tr>
+      {% endfor %}
+    </tbody>
+  </table>
+  {% else %}
+  <p class="bl-empty">{{ __("webmention-io.blocklist.empty") }}</p>
+  {% endif %}
+</section>
+{% endblock %}

package/views/webmentions.njk

@@ -0,0 +1,222 @@
+{% extends "document.njk" %}
+
+{% block content %}
+<style>
+  .wm-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: flex-start;
+    flex-wrap: wrap;
+    gap: var(--space-s, 0.75rem);
+    margin-block-end: var(--space-m, 1.5rem);
+  }
+
+  .wm-stats {
+    display: flex;
+    gap: var(--space-m, 1rem);
+    font: var(--font-body, 0.875rem/1.5 sans-serif);
+    color: var(--color-on-offset, #666);
+  }
+
+  .wm-stats__item {
+    display: flex;
+    align-items: center;
+    gap: 0.25rem;
+  }
+
+  .wm-stats__count {
+    font-weight: 700;
+    color: var(--color-on-surface, inherit);
+  }
+
+  .wm-actions-bar {
+    display: flex;
+    gap: var(--space-xs, 0.5rem);
+    flex-wrap: wrap;
+    align-items: center;
+  }
+
+  .wm-sync-info {
+    font: var(--font-caption, 0.75rem/1.4 sans-serif);
+    color: var(--color-on-offset, #666);
+  }
+
+  .wm-filters {
+    display: flex;
+    gap: var(--space-m, 1rem);
+    margin-block-end: var(--space-m, 1rem);
+    flex-wrap: wrap;
+    font: var(--font-body, 0.875rem/1.5 sans-serif);
+  }
+
+  .wm-filters a {
+    text-decoration: none;
+    padding: 0.25rem 0.5rem;
+    border-radius: var(--border-radius-small, 0.25rem);
+    color: var(--color-on-offset, #666);
+  }
+
+  .wm-filters a.active {
+    background: var(--color-primary, #0066cc);
+    color: var(--color-on-primary, #fff);
+  }
+
+  .wm-mention-wrapper {
+    margin-block-end: var(--space-xs, 0.5rem);
+    position: relative;
+  }
+
+  .wm-mention-wrapper--hidden {
+    opacity: 0.5;
+  }
+
+  .wm-mention-actions {
+    display: flex;
+    gap: var(--space-2xs, 0.25rem);
+    margin-block-start: var(--space-2xs, 0.25rem);
+    padding-inline-start: 3.5rem;
+  }
+
+  .wm-mention-badge {
+    display: inline-block;
+    font: var(--font-caption, 0.6875rem/1.4 sans-serif);
+    padding: 0.125rem 0.375rem;
+    border-radius: var(--border-radius-small, 0.25rem);
+    background: var(--color-warning-container, #fff3cd);
+    color: var(--color-warning, #856404);
+  }
+
+  .wm-success {
+    background: var(--color-success-container, #d4edda);
+    border: 1px solid var(--color-success, #28a745);
+    border-radius: var(--border-radius-small, 0.25rem);
+    padding: var(--space-s, 0.75rem);
+    margin-block-end: var(--space-m, 1rem);
+  }
+
+  .wm-error {
+    background: var(--color-error-container, #f8d7da);
+    border: 1px solid var(--color-error, #dc3545);
+    border-radius: var(--border-radius-small, 0.25rem);
+    padding: var(--space-s, 0.75rem);
+    margin-block-end: var(--space-m, 1rem);
+  }
+</style>
+
+{# Flash messages #}
+{% if request.query.synced %}
+<div class="wm-success">
+  {{ __("webmention-io.sync.synced") }} — {{ request.query.added or 0 }} {{ __("webmention-io.sync.added") }}
+</div>
+{% endif %}
+{% if request.query.hidden %}
+<div class="wm-success">Webmention hidden.</div>
+{% endif %}
+{% if request.query.unhidden %}
+<div class="wm-success">Webmention restored.</div>
+{% endif %}
+{% if request.query.blocked %}
+<div class="wm-success">{{ __("webmention-io.blocklist.blocked") }}: {{ request.query.domain }}</div>
+{% endif %}
+{% if request.query.error %}
+<div class="wm-error">Error: {{ request.query.error }}</div>
+{% endif %}
+
+{# Header with stats and sync controls #}
+<div class="wm-header">
+  <div class="wm-stats">
+    <span class="wm-stats__item">
+      <span class="wm-stats__count">{{ counts.visible }}</span> {{ __("webmention-io.counts.visible") }}
+    </span>
+    <span class="wm-stats__item">
+      <span class="wm-stats__count">{{ counts.hidden }}</span> {{ __("webmention-io.counts.hidden") }}
+    </span>
+    <span class="wm-stats__item">
+      <span class="wm-stats__count">{{ counts.total }}</span> {{ __("webmention-io.counts.total") }}
+    </span>
+  </div>
+
+  <div class="wm-actions-bar">
+    <span class="wm-sync-info">
+      {% if syncState.lastSync %}
+        {{ __("webmention-io.sync.lastSync") }}: {{ syncState.lastSync | date }}
+      {% else %}
+        {{ __("webmention-io.sync.never") }}
+      {% endif %}
+    </span>
+    <form method="post" action="{{ wmEndpoint }}/sync" style="display:inline">
+      <button type="submit" class="button button--small">{{ __("webmention-io.sync.now") }}</button>
+    </form>
+    <form method="post" action="{{ wmEndpoint }}/sync/full" style="display:inline"
+          onsubmit="return confirm('This will clear all cached webmentions and re-fetch from webmention.io. Continue?')">
+      <button type="submit" class="button button--small button--secondary">{{ __("webmention-io.sync.full") }}</button>
+    </form>
+    <a href="{{ wmEndpoint }}/blocklist" class="button button--small button--secondary">{{ __("webmention-io.blocklist.title") }}</a>
+  </div>
+</div>
+
+{# Filters #}
+<div class="wm-filters">
+  <div>
+    {{ __("webmention-io.filter.show") }}:
+    <a href="{{ wmEndpoint }}?filter=all&type={{ typeFilter }}" class="{% if filter == 'all' %}active{% endif %}">{{ __("webmention-io.filter.all") }}</a>
+    <a href="{{ wmEndpoint }}?filter=visible&type={{ typeFilter }}" class="{% if filter == 'visible' %}active{% endif %}">{{ __("webmention-io.filter.visible") }}</a>
+    <a href="{{ wmEndpoint }}?filter=hidden&type={{ typeFilter }}" class="{% if filter == 'hidden' %}active{% endif %}">{{ __("webmention-io.filter.hidden") }}</a>
+  </div>
+  <div>
+    {{ __("webmention-io.filter.type") }}:
+    <a href="{{ wmEndpoint }}?filter={{ filter }}&type=all" class="{% if typeFilter == 'all' %}active{% endif %}">{{ __("webmention-io.filter.all") }}</a>
+    <a href="{{ wmEndpoint }}?filter={{ filter }}&type=like-of" class="{% if typeFilter == 'like-of' %}active{% endif %}">{{ __("webmention-io.filter.likes") }}</a>
+    <a href="{{ wmEndpoint }}?filter={{ filter }}&type=in-reply-to" class="{% if typeFilter == 'in-reply-to' %}active{% endif %}">{{ __("webmention-io.filter.replies") }}</a>
+    <a href="{{ wmEndpoint }}?filter={{ filter }}&type=repost-of" class="{% if typeFilter == 'repost-of' %}active{% endif %}">{{ __("webmention-io.filter.reposts") }}</a>
+    <a href="{{ wmEndpoint }}?filter={{ filter }}&type=mention-of" class="{% if typeFilter == 'mention-of' %}active{% endif %}">{{ __("webmention-io.filter.mentions") }}</a>
+  </div>
+</div>
+
+{# Webmention list #}
+{%- if webmentions and webmentions.length > 0 %}
+  {% for item in webmentions %}
+  <div class="wm-mention-wrapper {% if item.hidden %}wm-mention-wrapper--hidden{% endif %}">
+    {{ mention({
+      user: {
+        avatar: item.user.avatar,
+        meta: __("webmention-io.mention." + item["wm-property"], item["wm-target"]) | urlize,
+        name: item.user.name
+      },
+      mention: {
+        title: item.title,
+        icon: item.icon,
+        description: item.description if item.description and item.description.html,
+        permalink: item.url,
+        published: item.published
+      }
+    }) | indent(4) }}
+
+    <div class="wm-mention-actions">
+      {% if item.hidden %}
+        <span class="wm-mention-badge">{{ __("webmention-io.actions.hidden") }} ({{ item.hiddenReason or "manual" }})</span>
+        <form method="post" action="{{ wmEndpoint }}/{{ item.id }}/unhide" style="display:inline">
+          <button type="submit" class="button button--small">{{ __("webmention-io.actions.unhide") }}</button>
+        </form>
+      {% else %}
+        <form method="post" action="{{ wmEndpoint }}/{{ item.id }}/hide" style="display:inline">
+          <button type="submit" class="button button--small button--secondary">{{ __("webmention-io.actions.hide") }}</button>
+        </form>
+      {% endif %}
+
+      {% if item.sourceDomain %}
+        <form method="post" action="{{ wmEndpoint }}/block" style="display:inline"
+              onsubmit="return confirm('Block all webmentions from {{ item.sourceDomain }}?')">
+          <input type="hidden" name="domain" value="{{ item.sourceDomain }}">
+          <button type="submit" class="button button--small button--secondary">{{ __("webmention-io.actions.block") }} {{ item.sourceDomain }}</button>
+        </form>
+      {% endif %}
+    </div>
+  </div>
+  {% endfor %}
+
+  {{ pagination(cursor) }}
+{%- else -%}
+  {{ prose({ text: __("webmention-io.webmentions.none") }) }}
+{%- endif %}
+{% endblock %}