@rmdes/indiekit-endpoint-blogroll 1.0.23 → 1.0.25

package/index.js

@@ -7,6 +7,8 @@ import { blogsController } from "./lib/controllers/blogs.js";
 import { sourcesController } from "./lib/controllers/sources.js";
 import { apiController } from "./lib/controllers/api.js";
 import { startSync, stopSync } from "./lib/sync/scheduler.js";
+import { waitForReady } from "@rmdes/indiekit-startup-gate";
+import { BLOGROLL_BLOCKS } from "./lib/blocks.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -54,6 +56,10 @@ export default class BlogrollEndpoint {
     };
   }
 
+  get blocks() {
+    return BLOGROLL_BLOCKS;
+  }
+
   /**
    * Protected routes (require authentication)
    * Admin dashboard and management
@@ -142,11 +148,15 @@ export default class BlogrollEndpoint {
 
     // Start background sync if database is available
     if (Indiekit.config.application.mongodbUrl) {
-      startSync(Indiekit, this.options);
+      this._stopGate = waitForReady(
+        () => startSync(Indiekit, this.options),
+        { label: "Blogroll" },
+      );
     }
   }
 
   destroy() {
+    this._stopGate?.();
     stopSync();
   }
 }

package/lib/blocks.js

@@ -0,0 +1,49 @@
+/**
+ * Blogroll v2 block declarations (Phase 7b — plugin block ownership).
+ *
+ * The `blogroll` and `feedland` sidebar widgets were site-config BUILTIN_BLOCKS
+ * seeds (requiresPlugin null, gated only by the theme's legacy
+ * widgetPluginRequirements render-map). Declaring them here makes site-config's
+ * scanPlugins stamp `sourcePlugin` → `requiresPlugin` ("Blogroll endpoint"), so
+ * the blocks are properly plugin-gated (theme ENDPOINT_SLUGS maps them to the
+ * `blogroll` loadout slug). scanPlugins precedence is `built-in < plugin blocks`,
+ * so these entries OVERWRITE the builtin seeds on sites where the plugin is
+ * loaded; the seeds themselves are removed from site-config in Phase 7d alongside
+ * the legacy-map bridge.
+ *
+ * Both are owned by this plugin: FeedLand is an alternate blogroll backend served
+ * by the same endpoint. Descriptors are byte-faithful to the BUILTIN_BLOCKS
+ * entries. Bespoke templates: the theme owns `components/widgets/blogroll.njk` and
+ * `components/widgets/feedland.njk` (no generic `render.renderer`);
+ * `data.source:"api"` documents the runtime fetch.
+ *
+ * @module lib/blocks
+ */
+
+/** @type {Array<object>} */
+export const BLOGROLL_BLOCKS = [
+  {
+    id: "blogroll",
+    version: 1,
+    label: "Blogroll",
+    description: "Blog recommendations",
+    icon: "list",
+    category: "social",
+    placement: { regions: ["sidebar"], surfaces: ["homepage"] },
+    multiple: false,
+    data: { source: "api" },
+    schema: { type: "object", additionalProperties: false, properties: {} },
+  },
+  {
+    id: "feedland",
+    version: 1,
+    label: "FeedLand",
+    description: "FeedLand blogroll widget",
+    icon: "rss",
+    category: "social",
+    placement: { regions: ["sidebar"], surfaces: ["homepage"] },
+    multiple: false,
+    data: { source: "api" },
+    schema: { type: "object", additionalProperties: false, properties: {} },
+  },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rmdes/indiekit-endpoint-blogroll",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "Blogroll endpoint for Indiekit. Aggregates blog feeds from OPML, JSON feeds, or manual entry.",
   "keywords": [
     "indiekit",
@@ -40,6 +40,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",