@rmdes/indiekit-endpoint-syndicate 1.0.0-beta.34 → 1.0.0-beta.36

package/lib/controllers/syndicate.js

@@ -4,6 +4,7 @@ import { findBearerToken } from "../token.js";
 import {
   getAllPostData,
   getPostData,
+  isPostReady,
   syndicateToTargets,
 } from "../utils.js";
 
@@ -31,6 +32,21 @@ const syndicatePost = async ({
   bearerToken,
   force = false,
 }) => {
+  // Readiness gate: verify post and OG image are live before syndicating.
+  // Skip check in force mode (manual re-syndication from UI/backlog script).
+  const meUrl = typeof publication.me === "string" ? publication.me : publication.me?.href || publication.me?.toString?.() || "";
+  if (!force && meUrl && postData.properties?.url) {
+    console.log(`[syndication] Readiness gate: checking ${postData.properties.url} (me=${meUrl})`);
+    const readiness = await isPostReady(postData.properties.url, meUrl);
+    if (!readiness.ready) {
+      console.log(
+        `[syndication] Skipping ${postData.properties.url} — not yet built ` +
+        `(post: ${readiness.postStatus}, og: ${readiness.ogStatus})`
+      );
+      return { skipped: true, url: postData.properties.url, readiness };
+    }
+  }
+
   const { failedTargets, syndicatedUrls } = await syndicateToTargets(
     publication,
     postData.properties,
@@ -148,6 +164,7 @@ export const syndicateController = {
       const results = [];
       let successCount = 0;
       let failCount = 0;
+      let skippedCount = 0;
 
       for (const postData of allPostData) {
         try {
@@ -158,6 +175,18 @@ export const syndicateController = {
             bearerToken,
           });
 
+          // Post was skipped (not yet built)
+          if (result.skipped) {
+            results.push({
+              url: result.url,
+              success: true,
+              skipped: true,
+              reason: `Not yet built (post: ${result.readiness.postStatus}, og: ${result.readiness.ogStatus})`,
+            });
+            skippedCount++;
+            continue;
+          }
+
           results.push({
             url: result.url,
             success: true,
@@ -191,7 +220,7 @@ export const syndicateController = {
       }
 
       const description =
-        `Processed ${allPostData.length} post(s): ${successCount} succeeded, ${failCount} failed`;
+        `Processed ${allPostData.length} post(s): ${successCount} succeeded, ${failCount} failed, ${skippedCount} not yet built`;
 
       console.log(`[syndication] ${description}`);
 

package/lib/utils.js

@@ -217,3 +217,74 @@ export const syndicateToTargets = async (
     syndicatedUrls,
   };
 };
+
+/**
+ * Derive OG image slug from a post URL path.
+ * Matches Eleventy theme's ogSlug filter logic.
+ *
+ * Date-based: /type/YYYY/MM/DD/slug → YYYY-MM-DD-slug
+ * Non-date:   /about/ → about
+ *
+ * @param {string} postUrl - Full post URL
+ * @returns {string|null} OG slug or null
+ */
+export function urlToOgSlug(postUrl) {
+  try {
+    const pathname = new URL(postUrl).pathname;
+    const segments = pathname.split("/").filter(Boolean);
+
+    // Date-based URL: /type/yyyy/MM/dd/slug → 5 segments
+    if (segments.length === 5) {
+      const [, year, month, day, slug] = segments;
+      if (/^\d{4}$/.test(year) && /^\d{2}$/.test(month) && /^\d{2}$/.test(day)) {
+        return `${year}-${month}-${day}-${slug}`;
+      }
+    }
+
+    // Fallback: last segment
+    return segments[segments.length - 1] || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Check if a post and its OG image are live on the public site.
+ * Uses HTTP HEAD requests with a 5-second timeout.
+ *
+ * @param {string} postUrl - Full public URL of the post
+ * @param {string} me - Publication URL (e.g., "https://rmendes.net")
+ * @returns {Promise<{ready: boolean, postStatus: number, ogStatus: number}>}
+ */
+export async function isPostReady(postUrl, me) {
+  const ogSlug = urlToOgSlug(postUrl);
+  const meNorm = me?.replace(/\/$/, "");
+  const ogUrl = ogSlug && meNorm ? `${meNorm}/og/${ogSlug}.png` : null;
+
+  const headCheck = async (url) => {
+    try {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 5000);
+      const response = await fetch(url, {
+        method: "HEAD",
+        redirect: "follow",
+        signal: controller.signal,
+      });
+      clearTimeout(timeoutId);
+      return response.status;
+    } catch {
+      return 0;
+    }
+  };
+
+  const [postStatus, ogStatus] = await Promise.all([
+    headCheck(postUrl),
+    ogUrl ? headCheck(ogUrl) : Promise.resolve(200),
+  ]);
+
+  return {
+    ready: postStatus === 200 && ogStatus === 200,
+    postStatus,
+    ogStatus,
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rmdes/indiekit-endpoint-syndicate",
-  "version": "1.0.0-beta.34",
+  "version": "1.0.0-beta.36",
   "description": "Syndication endpoint for Indiekit. Fork of @indiekit/endpoint-syndicate with batch syndication support and bug fixes.",
   "keywords": [
     "indiekit",