@rmdes/indiekit-endpoint-webmention-io 1.0.7 → 1.0.9

package/index.js

@@ -7,6 +7,8 @@ import { blocklistController } from "./lib/controllers/blocklist.js";
 import { syncController } from "./lib/controllers/sync-controller.js";
 import { apiController } from "./lib/controllers/api.js";
 import { startSync, stopSync } from "./lib/sync.js";
+import { waitForReady } from "@rmdes/indiekit-startup-gate";
+import { WEBMENTION_BLOCKS } from "./lib/blocks.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -43,6 +45,10 @@ export default class WebmentionEndpoint {
     };
   }
 
+  get blocks() {
+    return WEBMENTION_BLOCKS;
+  }
+
   /**
    * Protected routes (require authentication)
    * Admin dashboard, moderation, sync controls
@@ -103,11 +109,15 @@ export default class WebmentionEndpoint {
 
     // Start background sync if database is available
     if (Indiekit.config.application.mongodbUrl) {
-      startSync(Indiekit, this.options);
+      this._stopGate = waitForReady(
+        () => startSync(Indiekit, this.options),
+        { label: "Webmention.io" },
+      );
     }
   }
 
   destroy() {
+    this._stopGate?.();
     stopSync();
   }
 }

package/lib/blocks.js

@@ -0,0 +1,35 @@
+/**
+ * Webmention-io v2 block declaration (Phase 7b — plugin block ownership).
+ *
+ * The `webmentions` sidebar widget was a site-config BUILTIN_BLOCKS seed
+ * (requiresPlugin null, gated only by the theme's legacy widgetPluginRequirements
+ * render-map). Declaring it here makes site-config's scanPlugins stamp
+ * `sourcePlugin` → `requiresPlugin` ("Webmention moderation endpoint"), so the
+ * block is properly plugin-gated (theme ENDPOINT_SLUGS maps it to the
+ * `webmention-io` loadout slug). scanPlugins precedence is `built-in < plugin
+ * blocks`, so this entry OVERWRITES the builtin seed on sites where the plugin is
+ * loaded; the seed itself is removed from site-config in Phase 7d alongside the
+ * legacy-map bridge.
+ *
+ * Descriptor is byte-faithful to the BUILTIN_BLOCKS entry. Bespoke template: the
+ * theme owns `components/widgets/webmentions.njk` (no generic `render.renderer`);
+ * `data.source:"api"` documents the runtime fetch.
+ *
+ * @module lib/blocks
+ */
+
+/** @type {Array<object>} */
+export const WEBMENTION_BLOCKS = [
+  {
+    id: "webmentions",
+    version: 1,
+    label: "Webmentions",
+    description: "Recent inbound/outbound webmentions",
+    icon: "message-circle",
+    category: "social",
+    placement: { regions: ["sidebar"], surfaces: ["homepage", "postType"] },
+    multiple: false,
+    data: { source: "api" },
+    schema: { type: "object", additionalProperties: false, properties: {} },
+  },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rmdes/indiekit-endpoint-webmention-io",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Webmention moderation endpoint for Indiekit. Syncs webmentions from webmention.io into MongoDB with delete, block, and privacy removal capabilities.",
   "keywords": [
     "indiekit",
@@ -37,6 +37,7 @@
     "index.js"
   ],
   "dependencies": {
+    "@rmdes/indiekit-startup-gate": "^1.0.0",
     "@indiekit/error": "^1.0.0-beta.25",
     "@indiekit/frontend": "^1.0.0-beta.25",
     "express": "^5.0.0",