nodebb-plugin-facebook-post 1.0.34 → 1.0.36

package/CLAUDE.md

@@ -20,8 +20,9 @@ There is no build step for this plugin. NodeBB handles asset bundling.
 
 **Environment variables (required at NodeBB startup):**
 - `NODEBB_FB_PAGE_ID` – Facebook Page ID
-- `NODEBB_FB_PAGE_ACCESS_TOKEN` – Page access token
+- `NODEBB_FB_PAGE_ACCESS_TOKEN` – Page access token (also used for Instagram Graph API)
 - `NODEBB_FB_GRAPH_VERSION` – optional, defaults to `v25.0`
+- `NODEBB_IG_USER_ID` – optional; Instagram Business Account ID. If omitted, fetched automatically from the linked Page via `/{pageId}?fields=instagram_business_account`
 
 ## Architecture
 

package/library.js

@@ -38,6 +38,7 @@ function readEnv() {
     fbGraphVersion: trimStr(env.NODEBB_FB_GRAPH_VERSION) || 'v25.0',
     fbPageId: trimStr(env.NODEBB_FB_PAGE_ID),
     fbPageAccessToken: trimStr(env.NODEBB_FB_PAGE_ACCESS_TOKEN),
+    igUserId: trimStr(env.NODEBB_IG_USER_ID),
   };
 }
 
@@ -56,6 +57,7 @@ async function loadSettings() {
   settings.fbGraphVersion = env.fbGraphVersion;
   settings.fbPageId = env.fbPageId;
   settings.fbPageAccessToken = env.fbPageAccessToken;
+  settings.igUserId = env.igUserId;
 }
 
 function getForumBaseUrl() {
@@ -227,6 +229,115 @@ async function publishFeedPost({ message, link, photoIds }) {
   return resp.data && resp.data.id;
 }
 
+let cachedIgUserId = null;
+
+async function getInstagramUserId() {
+  if (settings.igUserId) return settings.igUserId;
+  if (cachedIgUserId) return cachedIgUserId;
+  const resp = await axios.get(
+    `https://graph.facebook.com/${settings.fbGraphVersion}/${settings.fbPageId}`,
+    {
+      params: { fields: 'instagram_business_account', access_token: settings.fbPageAccessToken },
+      timeout: 10000,
+    }
+  );
+  const igId = resp.data && resp.data.instagram_business_account && resp.data.instagram_business_account.id;
+  if (!igId) throw new Error('No Instagram Business Account linked to this Facebook Page');
+  cachedIgUserId = igId;
+  return igId;
+}
+
+async function postToInstagram(ctx) {
+  const rawContent = ctx.post.content || '';
+  const topicTitle = decodeHtmlEntities(ctx.topic.title || 'Nouveau sujet');
+  const author = ctx.user.username || 'Quelqu\u2019un';
+  const link = ctx.topicUrlAbs;
+
+  const imageUrls = extractImageUrlsFromContent(rawContent)
+    .filter(isForumHosted)
+    .slice(0, Math.max(0, settings.maxImages));
+
+  // Instagram feed posts require at least one image
+  if (!imageUrls.length) return null;
+
+  const excerpt = settings.includeExcerpt ? sanitizeExcerpt(rawContent, settings.excerptMaxLen) : '';
+  const lines = [`\uD83D\uDCDD ${topicTitle}`];
+  if (excerpt) lines.push(excerpt);
+  lines.push(`\uD83D\uDD17 ${link}`);
+  lines.push(`\u2014 ${author}`);
+  const caption = lines.join('\n\n');
+
+  const igUserId = await getInstagramUserId();
+  const baseUrl = `https://graph.facebook.com/${settings.fbGraphVersion}/${igUserId}`;
+
+  if (imageUrls.length === 1) {
+    const containerResp = await axios.post(`${baseUrl}/media`, null, {
+      params: { image_url: imageUrls[0], caption, access_token: settings.fbPageAccessToken },
+      timeout: 20000,
+    });
+    const containerId = containerResp.data && containerResp.data.id;
+    if (!containerId) return null;
+
+    const publishResp = await axios.post(`${baseUrl}/media_publish`, null, {
+      params: { creation_id: containerId, access_token: settings.fbPageAccessToken },
+      timeout: 20000,
+    });
+    return publishResp.data && publishResp.data.id;
+  }
+
+  // Carousel
+  const childIds = [];
+  for (const url of imageUrls) {
+    // eslint-disable-next-line no-await-in-loop
+    const childResp = await axios.post(`${baseUrl}/media`, null, {
+      params: {
+        image_url: url,
+        media_type: 'IMAGE',
+        is_carousel_item: true,
+        access_token: settings.fbPageAccessToken,
+      },
+      timeout: 20000,
+    });
+    const childId = childResp.data && childResp.data.id;
+    if (childId) childIds.push(childId);
+  }
+  if (!childIds.length) return null;
+
+  // Instagram requires at least 2 children for a carousel; fall back to single image
+  if (childIds.length < 2) {
+    const singleResp = await axios.post(`${baseUrl}/media`, null, {
+      params: { image_url: imageUrls[0], caption, access_token: settings.fbPageAccessToken },
+      timeout: 20000,
+    });
+    const singleId = singleResp.data && singleResp.data.id;
+    if (!singleId) return null;
+    const pubResp = await axios.post(`${baseUrl}/media_publish`, null, {
+      params: { creation_id: singleId, access_token: settings.fbPageAccessToken },
+      timeout: 20000,
+    });
+    return pubResp.data && pubResp.data.id;
+  }
+
+  const form = new URLSearchParams();
+  form.append('media_type', 'CAROUSEL');
+  form.append('caption', caption);
+  childIds.forEach(id => form.append('children', id));
+  form.append('access_token', settings.fbPageAccessToken);
+
+  const carouselResp = await axios.post(`${baseUrl}/media`, form, {
+    headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+    timeout: 20000,
+  });
+  const carouselId = carouselResp.data && carouselResp.data.id;
+  if (!carouselId) return null;
+
+  const publishResp = await axios.post(`${baseUrl}/media_publish`, null, {
+    params: { creation_id: carouselId, access_token: settings.fbPageAccessToken },
+    timeout: 20000,
+  });
+  return publishResp.data && publishResp.data.id;
+}
+
 async function postToFacebook(ctx) {
   const rawContent = ctx.post.content || '';
   const topicTitle = decodeHtmlEntities(ctx.topic.title || 'Nouveau sujet');
@@ -341,16 +452,36 @@ Plugin.onPostSave = async function (hookData) {
 
     const Posts = require.main.require('./src/posts');
 
-    const already = await Posts.getPostField(ctx.post.pid, 'fbPostedId');
-    if (already) return;
+    const fbAlready = await Posts.getPostField(ctx.post.pid, 'fbPostedId');
+    if (!fbAlready) {
+      try {
+        const fbId = await postToFacebook(ctx);
+        if (fbId) {
+          await Posts.setPostField(ctx.post.pid, 'fbPostedId', fbId);
+          await Posts.setPostField(ctx.post.pid, 'fbPostedAt', Date.now());
+          winston.info(`[facebook-post] facebook published pid=${ctx.post.pid} fbId=${fbId}`);
+        } else {
+          winston.warn(`[facebook-post] postToFacebook returned no id for pid=${ctx.post.pid}`);
+        }
+      } catch (fbErr) {
+        const detail = fbErr?.response ? JSON.stringify(fbErr.response.data) : (fbErr?.message || fbErr);
+        winston.error(`[facebook-post] facebook error pid=${ctx.post.pid}: ${detail}`);
+      }
+    }
 
-    const fbId = await postToFacebook(ctx);
-    if (fbId) {
-      await Posts.setPostField(ctx.post.pid, 'fbPostedId', fbId);
-      await Posts.setPostField(ctx.post.pid, 'fbPostedAt', Date.now());
-      winston.info(`[facebook-post] published pid=${ctx.post.pid} fbId=${fbId}`);
-    } else {
-      winston.warn(`[facebook-post] postToFacebook returned no id for pid=${ctx.post.pid}`);
+    const igAlready = await Posts.getPostField(ctx.post.pid, 'igPostedId');
+    if (!igAlready) {
+      try {
+        const igId = await postToInstagram(ctx);
+        if (igId) {
+          await Posts.setPostField(ctx.post.pid, 'igPostedId', igId);
+          await Posts.setPostField(ctx.post.pid, 'igPostedAt', Date.now());
+          winston.info(`[facebook-post] instagram published pid=${ctx.post.pid} igId=${igId}`);
+        }
+      } catch (igErr) {
+        const detail = igErr?.response ? JSON.stringify(igErr.response.data) : (igErr?.message || igErr);
+        winston.error(`[facebook-post] instagram error pid=${ctx.post.pid}: ${detail}`);
+      }
     }
   } catch (e) {
     const detail = e?.response ? JSON.stringify(e.response.data) : (e?.message || e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodebb-plugin-facebook-post",
-  "version": "1.0.34",
+  "version": "1.0.36",
   "description": "Auto-post new NodeBB topics to a fixed Facebook Page (text + NodeBB uploads + place id).",
   "main": "library.js",
   "dependencies": {