@rmdes/indiekit-endpoint-activitypub 0.1.0

package/lib/webfinger.js

@@ -0,0 +1,43 @@
+/**
+ * Handle WebFinger resource resolution.
+ *
+ * WebFinger is the discovery mechanism for ActivityPub — when someone
+ * searches for @rick@rmendes.net, their server queries:
+ *   GET /.well-known/webfinger?resource=acct:rick@rmendes.net
+ *
+ * We return a JRD (JSON Resource Descriptor) pointing to the actor URL
+ * so the remote server can then fetch the full actor document.
+ *
+ * @param {string} resource - The resource query (e.g. "acct:rick@rmendes.net")
+ * @param {object} options
+ * @param {string} options.handle - Actor handle (e.g. "rick")
+ * @param {string} options.hostname - Publication hostname (e.g. "rmendes.net")
+ * @param {string} options.actorUrl - Full actor URL (e.g. "https://rmendes.net/")
+ * @returns {object|null} JRD response object, or null if resource doesn't match
+ */
+export function handleWebFinger(resource, options) {
+  const { handle, hostname, actorUrl } = options;
+  const expectedAcct = `acct:${handle}@${hostname}`;
+
+  // Match both "acct:rick@rmendes.net" and the actor URL itself
+  if (resource !== expectedAcct && resource !== actorUrl) {
+    return null;
+  }
+
+  return {
+    subject: expectedAcct,
+    aliases: [actorUrl],
+    links: [
+      {
+        rel: "self",
+        type: "application/activity+json",
+        href: actorUrl,
+      },
+      {
+        rel: "http://webfinger.net/rel/profile-page",
+        type: "text/html",
+        href: actorUrl,
+      },
+    ],
+  };
+}

package/locales/en.json

@@ -0,0 +1,41 @@
+{
+  "activitypub": {
+    "title": "ActivityPub",
+    "followers": "Followers",
+    "following": "Following",
+    "activities": "Activity log",
+    "migrate": "Mastodon migration",
+    "recentActivity": "Recent activity",
+    "noActivity": "No activity yet. Once your actor is federated, interactions will appear here.",
+    "noFollowers": "No followers yet.",
+    "noFollowing": "Not following anyone yet.",
+    "followerCount": "%d follower",
+    "followerCount_plural": "%d followers",
+    "followingCount": "%d following",
+    "followedAt": "Followed",
+    "source": "Source",
+    "sourceImport": "Mastodon import",
+    "sourceManual": "Manual",
+    "sourceFederation": "Federation",
+    "direction": "Direction",
+    "directionInbound": "Received",
+    "directionOutbound": "Sent",
+    "migrate.aliasLabel": "Your old Mastodon account URL",
+    "migrate.aliasHint": "e.g. https://mstdn.social/users/rmdes — sets alsoKnownAs on your actor",
+    "migrate.aliasSave": "Save alias",
+    "migrate.importLabel": "Import followers and following",
+    "migrate.fileLabel": "Mastodon export CSV",
+    "migrate.fileHint": "Upload following_accounts.csv from your Mastodon data export",
+    "migrate.importButton": "Import",
+    "migrate.importFollowing": "Import following list",
+    "migrate.importFollowers": "Import followers list (pending until they re-follow after Move)",
+    "migrate.step1Title": "Step 1 — Configure actor alias",
+    "migrate.step1Desc": "Link your old Mastodon account to this actor so the fediverse knows they are the same person.",
+    "migrate.step2Title": "Step 2 — Import followers/following",
+    "migrate.step2Desc": "Upload your Mastodon data export CSV to import your social graph.",
+    "migrate.step3Title": "Step 3 — Trigger Move on Mastodon",
+    "migrate.step3Desc": "Go to your Mastodon instance → Preferences → Account → Move to a different account. Enter your new handle and confirm. After the Move, followers will automatically re-follow you here.",
+    "migrate.success": "Imported %d following, %d followers (%d failed).",
+    "migrate.aliasSuccess": "Actor alias updated."
+  }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@rmdes/indiekit-endpoint-activitypub",
+  "version": "0.1.0",
+  "description": "ActivityPub federation endpoint for Indiekit via Fedify. Adds full fediverse support: actor, inbox, outbox, followers, following, syndication, and Mastodon migration.",
+  "keywords": [
+    "indiekit",
+    "indiekit-plugin",
+    "indieweb",
+    "activitypub",
+    "fediverse",
+    "federation",
+    "fedify"
+  ],
+  "author": {
+    "name": "Ricardo Mendes",
+    "url": "https://rmendes.net"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "main": "index.js",
+  "exports": "./index.js",
+  "files": [
+    "assets",
+    "lib",
+    "locales",
+    "views",
+    "index.js"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rmdes/indiekit-endpoint-activitypub"
+  },
+  "bugs": {
+    "url": "https://github.com/rmdes/indiekit-endpoint-activitypub/issues"
+  },
+  "dependencies": {
+    "@fedify/fedify": "^1.10.0",
+    "@fedify/express": "^1.9.0",
+    "express": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@indiekit/error": "^1.0.0-beta.25",
+    "@indiekit/frontend": "^1.0.0-beta.25"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/views/activities.njk

@@ -0,0 +1,29 @@
+{% extends "document.njk" %}
+
+{% from "heading/macro.njk" import heading with context %}
+{% from "card/macro.njk" import card with context %}
+{% from "badge/macro.njk" import badge with context %}
+{% from "prose/macro.njk" import prose with context %}
+{% from "pagination/macro.njk" import pagination with context %}
+
+{% block content %}
+  {{ heading({ text: __("activitypub.activities"), level: 1, parent: { text: __("activitypub.title"), href: mountPath } }) }}
+
+  {% if activities.length > 0 %}
+    {% for activity in activities %}
+      {{ card({
+        title: activity.actorName or activity.actorUrl,
+        description: { text: activity.summary },
+        published: activity.receivedAt,
+        badges: [
+          { text: activity.type },
+          { text: __("activitypub.directionInbound") if activity.direction === "inbound" else __("activitypub.directionOutbound") }
+        ]
+      }) }}
+    {% endfor %}
+
+    {{ pagination(cursor) if cursor }}
+  {% else %}
+    {{ prose({ text: __("activitypub.noActivity") }) }}
+  {% endif %}
+{% endblock %}

package/views/dashboard.njk

@@ -0,0 +1,45 @@
+{% extends "document.njk" %}
+
+{% from "heading/macro.njk" import heading with context %}
+{% from "card/macro.njk" import card with context %}
+{% from "card-grid/macro.njk" import cardGrid with context %}
+{% from "prose/macro.njk" import prose with context %}
+{% from "badge/macro.njk" import badge with context %}
+
+{% block content %}
+  {{ heading({ text: title, level: 1 }) }}
+
+  {{ cardGrid({ cardSize: "16rem", items: [
+    {
+      title: followerCount + " " + __("activitypub.followers"),
+      url: mountPath + "/admin/followers"
+    },
+    {
+      title: followingCount + " " + __("activitypub.following"),
+      url: mountPath + "/admin/following"
+    },
+    {
+      title: __("activitypub.activities"),
+      url: mountPath + "/admin/activities"
+    },
+    {
+      title: __("activitypub.migrate"),
+      url: mountPath + "/admin/migrate"
+    }
+  ]}) }}
+
+  {{ heading({ text: __("activitypub.recentActivity"), level: 2 }) }}
+
+  {% if recentActivities.length > 0 %}
+    {% for activity in recentActivities %}
+      {{ card({
+        title: activity.actorName or activity.actorUrl,
+        description: { text: activity.summary },
+        published: activity.receivedAt,
+        badges: [{ text: activity.type }]
+      }) }}
+    {% endfor %}
+  {% else %}
+    {{ prose({ text: __("activitypub.noActivity") }) }}
+  {% endif %}
+{% endblock %}

package/views/followers.njk

@@ -0,0 +1,26 @@
+{% extends "document.njk" %}
+
+{% from "heading/macro.njk" import heading with context %}
+{% from "card/macro.njk" import card with context %}
+{% from "prose/macro.njk" import prose with context %}
+{% from "pagination/macro.njk" import pagination with context %}
+
+{% block content %}
+  {{ heading({ text: followerCount + " " + __("activitypub.followers"), level: 1, parent: { text: __("activitypub.title"), href: mountPath } }) }}
+
+  {% if followers.length > 0 %}
+    {% for follower in followers %}
+      {{ card({
+        title: follower.name or follower.handle or follower.actorUrl,
+        url: follower.actorUrl,
+        photo: { src: follower.avatar, alt: follower.name } if follower.avatar,
+        description: { text: "@" + follower.handle if follower.handle },
+        published: follower.followedAt
+      }) }}
+    {% endfor %}
+
+    {{ pagination(cursor) if cursor }}
+  {% else %}
+    {{ prose({ text: __("activitypub.noFollowers") }) }}
+  {% endif %}
+{% endblock %}

package/views/following.njk

@@ -0,0 +1,27 @@
+{% extends "document.njk" %}
+
+{% from "heading/macro.njk" import heading with context %}
+{% from "card/macro.njk" import card with context %}
+{% from "prose/macro.njk" import prose with context %}
+{% from "badge/macro.njk" import badge with context %}
+{% from "pagination/macro.njk" import pagination with context %}
+
+{% block content %}
+  {{ heading({ text: followingCount + " " + __("activitypub.following"), level: 1, parent: { text: __("activitypub.title"), href: mountPath } }) }}
+
+  {% if following.length > 0 %}
+    {% for account in following %}
+      {{ card({
+        title: account.name or account.handle or account.actorUrl,
+        url: account.actorUrl,
+        description: { text: "@" + account.handle if account.handle },
+        published: account.followedAt,
+        badges: [{ text: __("activitypub.sourceImport") if account.source === "import" else __("activitypub.sourceFederation") }]
+      }) }}
+    {% endfor %}
+
+    {{ pagination(cursor) if cursor }}
+  {% else %}
+    {{ prose({ text: __("activitypub.noFollowing") }) }}
+  {% endif %}
+{% endblock %}

package/views/migrate.njk

@@ -0,0 +1,67 @@
+{% extends "document.njk" %}
+
+{% from "heading/macro.njk" import heading with context %}
+{% from "input/macro.njk" import input with context %}
+{% from "button/macro.njk" import button with context %}
+{% from "checkboxes/macro.njk" import checkboxes with context %}
+{% from "file-input/macro.njk" import fileInput with context %}
+{% from "details/macro.njk" import details with context %}
+{% from "notification-banner/macro.njk" import notificationBanner with context %}
+{% from "prose/macro.njk" import prose with context %}
+
+{% block content %}
+  {{ heading({ text: title, level: 1, parent: { text: __("activitypub.title"), href: mountPath } }) }}
+
+  {% if result %}
+    {{ notificationBanner({ type: result.type, text: result.text }) }}
+  {% endif %}
+
+  {# Step 1 — Actor alias #}
+  {{ heading({ text: __("activitypub.migrate.step1Title"), level: 2 }) }}
+  {{ prose({ text: __("activitypub.migrate.step1Desc") }) }}
+
+  <form method="post" novalidate>
+    <input type="hidden" name="action" value="alias">
+    {{ input({
+      name: "aliasUrl",
+      label: __("activitypub.migrate.aliasLabel"),
+      hint: __("activitypub.migrate.aliasHint"),
+      type: "url"
+    }) }}
+    {{ button({ text: __("activitypub.migrate.aliasSave") }) }}
+  </form>
+
+  <hr>
+
+  {# Step 2 — Import CSV #}
+  {{ heading({ text: __("activitypub.migrate.step2Title"), level: 2 }) }}
+  {{ prose({ text: __("activitypub.migrate.step2Desc") }) }}
+
+  <form method="post" enctype="multipart/form-data" novalidate>
+    <input type="hidden" name="action" value="import">
+
+    {{ checkboxes({
+      name: "importTypes",
+      items: [
+        { value: "following", text: __("activitypub.migrate.importFollowing") },
+        { value: "followers", text: __("activitypub.migrate.importFollowers") }
+      ],
+      values: ["following"]
+    }) }}
+
+    {{ fileInput({
+      name: "csvFile",
+      label: __("activitypub.migrate.fileLabel"),
+      hint: __("activitypub.migrate.fileHint"),
+      accept: ".csv,.txt"
+    }) }}
+
+    {{ button({ text: __("activitypub.migrate.importButton") }) }}
+  </form>
+
+  <hr>
+
+  {# Step 3 — Instructions #}
+  {{ heading({ text: __("activitypub.migrate.step3Title"), level: 2 }) }}
+  {{ prose({ text: __("activitypub.migrate.step3Desc") }) }}
+{% endblock %}