thumbgate 1.4.3 → 1.4.4

package/scripts/social-analytics/publishers/instagram.js

@@ -1,317 +0,0 @@
-'use strict';
-
-/**
- * Instagram carousel publisher using the Instagram Graph API v21.0.
- *
- * Replaces the Playwright-based approach with a fully headless API workflow:
- *   1. Create container items for each image (carousel children).
- *   2. Poll each child container until FINISHED.
- *   3. Create a carousel parent container referencing the child IDs.
- *   4. Poll the parent container until FINISHED.
- *   5. Publish the parent container to the feed.
- *
- * Required environment variables:
- *   INSTAGRAM_ACCESS_TOKEN  — long-lived page/user access token
- *   INSTAGRAM_USER_ID       — Instagram business/creator account user ID
- *   R2_PUBLIC_URL           — base URL for publicly accessible hosted images
- *                             (e.g. https://pub-abc123.r2.dev/instagram)
- */
-
-const path = require('path');
-
-const GRAPH_BASE = 'https://graph.facebook.com/v21.0';
-
-// Default polling configuration.
-const DEFAULT_POLL_INTERVAL_MS = 3_000;
-const DEFAULT_TIMEOUT_MS = 120_000;
-
-/**
- * Returns the public URL for a locally staged image file.
- *
- * NOTE: This helper currently assumes the file has already been staged at the
- * public base URL. If we later enable direct uploads here, use the Cloudflare
- * R2 or AWS S3 SDK and return the resulting hosted URL.
- *
- * @param {string} localPath - Absolute or relative path to the image file.
- * @returns {string} Publicly accessible HTTPS URL.
- */
-function uploadImageToR2(localPath) {
-  const r2Base = process.env.R2_PUBLIC_URL;
-  if (!r2Base) throw new Error('R2_PUBLIC_URL is not set');
-
-  const filename = path.basename(localPath);
-  return `${r2Base}/${filename}`;
-}
-
-/**
- * Creates a single carousel child media container on the Graph API.
- *
- * @param {string}  token    - Instagram access token.
- * @param {string}  userId   - Instagram user ID.
- * @param {string}  imageUrl - Public HTTPS URL of the image (or video).
- * @param {boolean} [isVideo=false] - If true, treats the URL as a video_url.
- * @returns {Promise<string>} The container ID returned by the API.
- */
-async function createCarouselChild(token, userId, imageUrl, isVideo = false) {
-  console.log(
-    `[instagram:publisher] Creating carousel child — ${isVideo ? 'video' : 'image'}: ${imageUrl}`
-  );
-
-  const body = new URLSearchParams({
-    is_carousel_item: 'true',
-    access_token: token,
-    ...(isVideo ? { video_url: imageUrl } : { image_url: imageUrl }),
-  });
-
-  const res = await fetch(`${GRAPH_BASE}/${userId}/media`, {
-    method: 'POST',
-    body,
-  });
-
-  const json = await res.json();
-
-  if (!res.ok || json.error) {
-    throw new Error(
-      `createCarouselChild failed (HTTP ${res.status}): ${JSON.stringify(json.error ?? json)}`
-    );
-  }
-
-  console.log(`[instagram:publisher] Child container created: ${json.id}`);
-  return json.id;
-}
-
-/**
- * Polls a media container until its status_code is FINISHED or ERROR.
- *
- * @param {string} token       - Instagram access token.
- * @param {string} containerId - ID of the container to poll.
- * @param {number} [timeoutMs] - Max milliseconds to wait (default 120 000).
- * @returns {Promise<void>} Resolves when FINISHED; rejects on ERROR or timeout.
- */
-async function pollContainerStatus(token, containerId, timeoutMs = DEFAULT_TIMEOUT_MS) {
-  const deadline = Date.now() + timeoutMs;
-
-  console.log(`[instagram:publisher] Polling container ${containerId}…`);
-
-  while (Date.now() < deadline) {
-    const url =
-      `${GRAPH_BASE}/${containerId}?fields=status_code&access_token=${token}`;
-
-    const res = await fetch(url);
-    const json = await res.json();
-
-    if (!res.ok || json.error) {
-      throw new Error(
-        `pollContainerStatus HTTP ${res.status}: ${JSON.stringify(json.error ?? json)}`
-      );
-    }
-
-    const status = json.status_code;
-    console.log(`[instagram:publisher] Container ${containerId} status: ${status}`);
-
-    if (status === 'FINISHED') return;
-    if (status === 'ERROR') {
-      throw new Error(
-        `Container ${containerId} entered ERROR state. Check media URL validity and permissions.`
-      );
-    }
-
-    // Status is IN_PROGRESS or PUBLISHED — keep waiting.
-    await new Promise((resolve) => setTimeout(resolve, DEFAULT_POLL_INTERVAL_MS));
-  }
-
-  throw new Error(
-    `pollContainerStatus timed out after ${timeoutMs}ms for container ${containerId}`
-  );
-}
-
-/**
- * Creates the carousel parent container referencing the given child IDs.
- *
- * @param {string}   token    - Instagram access token.
- * @param {string}   userId   - Instagram user ID.
- * @param {string[]} childIds - Ordered list of child container IDs.
- * @param {string}   caption  - Post caption (hashtags included here).
- * @returns {Promise<string>} The parent container ID.
- */
-async function createCarouselParent(token, userId, childIds, caption) {
-  console.log(
-    `[instagram:publisher] Creating carousel parent with ${childIds.length} children…`
-  );
-
-  const body = new URLSearchParams({
-    media_type: 'CAROUSEL',
-    children: childIds.join(','),
-    caption,
-    access_token: token,
-  });
-
-  const res = await fetch(`${GRAPH_BASE}/${userId}/media`, {
-    method: 'POST',
-    body,
-  });
-
-  const json = await res.json();
-
-  if (!res.ok || json.error) {
-    throw new Error(
-      `createCarouselParent failed (HTTP ${res.status}): ${JSON.stringify(json.error ?? json)}`
-    );
-  }
-
-  console.log(`[instagram:publisher] Parent container created: ${json.id}`);
-  return json.id;
-}
-
-/**
- * Publishes a finalised container to the Instagram feed.
- *
- * @param {string} token       - Instagram access token.
- * @param {string} userId      - Instagram user ID.
- * @param {string} containerId - ID of the FINISHED parent container.
- * @returns {Promise<string>} The published media ID.
- */
-async function publishContainer(token, userId, containerId) {
-  console.log(
-    `[instagram:publisher] Publishing container ${containerId} for user ${userId}…`
-  );
-
-  const body = new URLSearchParams({
-    creation_id: containerId,
-    access_token: token,
-  });
-
-  const res = await fetch(`${GRAPH_BASE}/${userId}/media_publish`, {
-    method: 'POST',
-    body,
-  });
-
-  const json = await res.json();
-
-  if (!res.ok || json.error) {
-    throw new Error(
-      `publishContainer failed (HTTP ${res.status}): ${JSON.stringify(json.error ?? json)}`
-    );
-  }
-
-  console.log(`[instagram:publisher] Published media ID: ${json.id}`);
-  return json.id;
-}
-
-/**
- * Fetches the permalink of a published post by media ID.
- *
- * @param {string} token   - Instagram access token.
- * @param {string} mediaId - ID of the published post.
- * @returns {Promise<string|null>} The permalink URL, or null if unavailable.
- */
-async function fetchPermalink(token, mediaId) {
-  try {
-    const url = `${GRAPH_BASE}/${mediaId}?fields=permalink&access_token=${token}`;
-    const res = await fetch(url);
-    const json = await res.json();
-    return json.permalink ?? null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Orchestrates the full carousel publish flow end-to-end.
- *
- * @param {object}   opts
- * @param {string[]} opts.imageUrls - Ordered array of public HTTPS image URLs.
- * @param {string}   opts.caption   - Post caption (may include hashtags).
- * @param {string}   [opts.token]   - Access token (defaults to env var).
- * @param {string}   [opts.userId]  - User ID (defaults to env var).
- * @returns {Promise<{ id: string, permalink: string|null }>}
- */
-async function publishCarousel({ imageUrls, caption, token, userId }) {
-  const resolvedToken = token ?? process.env.INSTAGRAM_ACCESS_TOKEN;
-  const resolvedUserId = userId ?? process.env.INSTAGRAM_USER_ID;
-
-  if (!resolvedToken) throw new Error('INSTAGRAM_ACCESS_TOKEN is not set');
-  if (!resolvedUserId) throw new Error('INSTAGRAM_USER_ID is not set');
-  if (!imageUrls || imageUrls.length < 2) {
-    throw new Error('publishCarousel requires at least 2 image URLs');
-  }
-  if (imageUrls.length > 10) {
-    throw new Error('Instagram carousels support a maximum of 10 images');
-  }
-
-  // Step 1: Create child containers.
-  console.log(`[instagram:publisher] Starting carousel publish — ${imageUrls.length} images`);
-  const childIds = [];
-  for (const imageUrl of imageUrls) {
-    const childId = await createCarouselChild(resolvedToken, resolvedUserId, imageUrl, false);
-    childIds.push(childId);
-  }
-
-  // Step 2: Poll each child until FINISHED.
-  console.log('[instagram:publisher] Polling child containers…');
-  for (const childId of childIds) {
-    await pollContainerStatus(resolvedToken, childId);
-  }
-
-  // Step 3: Create the carousel parent container.
-  const parentId = await createCarouselParent(
-    resolvedToken,
-    resolvedUserId,
-    childIds,
-    caption
-  );
-
-  // Step 4: Poll the parent until FINISHED.
-  console.log('[instagram:publisher] Polling parent container…');
-  await pollContainerStatus(resolvedToken, parentId);
-
-  // Step 5: Publish.
-  const publishedId = await publishContainer(resolvedToken, resolvedUserId, parentId);
-
-  // Retrieve the permalink for the caller.
-  const permalink = await fetchPermalink(resolvedToken, publishedId);
-
-  console.log(`[instagram:publisher] Carousel live: ${permalink ?? publishedId}`);
-  return { id: publishedId, permalink };
-}
-
-module.exports = {
-  uploadImageToR2,
-  createCarouselChild,
-  pollContainerStatus,
-  createCarouselParent,
-  publishContainer,
-  publishCarousel,
-};
-
-// Allow running directly:
-//   node scripts/social-analytics/publishers/instagram.js \
-//     --images "https://pub.r2.dev/img1.jpg,https://pub.r2.dev/img2.jpg" \
-//     --caption "Your caption here #hashtag"
-if (require.main === module) {
-  (async () => {
-    const args = process.argv.slice(2);
-    const get = (flag) => {
-      const idx = args.indexOf(flag);
-      return idx !== -1 ? args[idx + 1] : null;
-    };
-
-    const imagesArg = get('--images');
-    const caption = get('--caption') ?? '';
-
-    if (!imagesArg) {
-      console.error('Usage: node instagram.js --images "url1,url2,..." --caption "..."');
-      process.exit(1);
-    }
-
-    const imageUrls = imagesArg.split(',').map((u) => u.trim()).filter(Boolean);
-
-    try {
-      const result = await publishCarousel({ imageUrls, caption });
-      console.log('[instagram:publisher] Success:', JSON.stringify(result, null, 2));
-    } catch (err) {
-      console.error('[instagram:publisher] Fatal error:', err.message);
-      process.exit(1);
-    }
-  })();
-}

package/scripts/social-analytics/publishers/linkedin.js

@@ -1,294 +0,0 @@
-'use strict';
-
-/**
- * LinkedIn post publisher using the LinkedIn Posts API (LinkedIn-Version: 202401).
- *
- * Required environment variables:
- *   LINKEDIN_ACCESS_TOKEN  — OAuth 2.0 access token with w_member_social scope (required)
- *   LINKEDIN_PERSON_URN    — Authenticated member URN, e.g. urn:li:person:XXXXX (required)
- *
- * LinkedIn API references:
- *   Posts API:   https://api.linkedin.com/rest/posts
- *   Images API:  https://api.linkedin.com/rest/images?action=initializeUpload
- */
-
-const LI_REST_BASE = 'https://api.linkedin.com/rest';
-
-/**
- * Build standard headers for the LinkedIn Posts API.
- * @param {string} token
- * @returns {Record<string, string>}
- */
-function buildHeaders(token) {
-  return {
-    Authorization: `Bearer ${token}`,
-    'LinkedIn-Version': '202601',
-    'X-Restli-Protocol-Version': '2.0.0',
-    'Content-Type': 'application/json',
-  };
-}
-
-/**
- * Publishes a plain text post to LinkedIn.
- *
- * @param {string} token     - LinkedIn OAuth access token (w_member_social scope required).
- * @param {string} personUrn - Author URN, e.g. "urn:li:person:XXXXX".
- * @param {string} text      - Post body text (commentary).
- * @returns {Promise<string>} The created post URN from the X-RestLi-Id response header.
- */
-async function publishTextPost(token, personUrn, text) {
-  if (!token) throw new Error('publishTextPost: token is required');
-  if (!personUrn) throw new Error('publishTextPost: personUrn is required');
-  if (!text) throw new Error('publishTextPost: text is required');
-
-  const url = `${LI_REST_BASE}/posts`;
-  const body = {
-    author: personUrn,
-    commentary: text,
-    visibility: 'PUBLIC',
-    distribution: { feedDistribution: 'MAIN_FEED' },
-    lifecycleState: 'PUBLISHED',
-  };
-
-  console.log(`[linkedin:publisher] Publishing text post as ${personUrn}`);
-
-  const res = await fetch(url, {
-    method: 'POST',
-    headers: buildHeaders(token),
-    body: JSON.stringify(body),
-  });
-
-  if (!res.ok) {
-    const errBody = await res.text().catch(() => '');
-    throw new Error(`publishTextPost HTTP ${res.status}: ${errBody}`);
-  }
-
-  // LinkedIn returns the created post URN in the X-RestLi-Id header.
-  const postUrn = res.headers.get('x-restli-id') ?? res.headers.get('X-RestLi-Id') ?? '';
-  console.log(`[linkedin:publisher] Text post created. URN: ${postUrn}`);
-  return postUrn;
-}
-
-/**
- * Publishes a post with image attachments to LinkedIn.
- *
- * LinkedIn requires a multi-step upload flow for images:
- *   1. POST /rest/images?action=initializeUpload  → get uploadUrl + image URN.
- *   2. PUT <uploadUrl> with raw image binary.
- *   3. POST /rest/posts with content.media referencing the image URN.
- *
- * NOTE: This implementation handles the full flow for each image URL by fetching
- * the image from the provided URL and uploading the binary to LinkedIn's upload endpoint.
- * imageUrls must be publicly accessible URLs pointing to image files (JPEG/PNG/GIF/WEBP).
- * For production use, consider reading local file buffers directly instead of re-fetching.
- *
- * MVP behaviour: if imageUrls is empty or undefined, falls back to publishTextPost.
- *
- * @param {string}   token      - LinkedIn OAuth access token.
- * @param {string}   personUrn  - Author URN.
- * @param {string}   text       - Post commentary text.
- * @param {string[]} imageUrls  - Array of publicly accessible image URLs to attach.
- * @returns {Promise<string>} The created post URN.
- */
-async function publishImagePost(token, personUrn, text, imageUrls) {
-  if (!token) throw new Error('publishImagePost: token is required');
-  if (!personUrn) throw new Error('publishImagePost: personUrn is required');
-  if (!text) throw new Error('publishImagePost: text is required');
-
-  // Fall back to text-only post if no images supplied.
-  if (!imageUrls || imageUrls.length === 0) {
-    console.warn('[linkedin:publisher] No imageUrls provided; falling back to text-only post.');
-    return publishTextPost(token, personUrn, text);
-  }
-
-  // Step 1 — Register image upload for each image and upload the binary.
-  const initUrl = `${LI_REST_BASE}/images?action=initializeUpload`;
-
-  const imageUrns = [];
-  for (const imgUrl of imageUrls) {
-    console.log(`[linkedin:publisher] Initializing image upload for ${imgUrl}`);
-
-    const initRes = await fetch(initUrl, {
-      method: 'POST',
-      headers: buildHeaders(token),
-      body: JSON.stringify({ initializeUploadRequest: { owner: personUrn } }),
-    });
-
-    if (!initRes.ok) {
-      const errBody = await initRes.text().catch(() => '');
-      throw new Error(`publishImagePost initializeUpload HTTP ${initRes.status}: ${errBody}`);
-    }
-
-    const initJson = await initRes.json();
-    const uploadUrl = initJson.value?.uploadUrl;
-    const imageUrn = initJson.value?.image;
-
-    if (!uploadUrl || !imageUrn) {
-      throw new Error(
-        `publishImagePost: initializeUpload returned unexpected shape: ${JSON.stringify(initJson)}`
-      );
-    }
-
-    // Step 2 — Fetch the image binary and upload it to LinkedIn's upload endpoint.
-    console.log(`[linkedin:publisher] Fetching image binary from ${imgUrl}`);
-    const imgRes = await fetch(imgUrl);
-    if (!imgRes.ok) {
-      throw new Error(`publishImagePost: failed to fetch image from ${imgUrl}: HTTP ${imgRes.status}`);
-    }
-    const imgBuffer = await imgRes.arrayBuffer();
-
-    console.log(`[linkedin:publisher] Uploading image binary (${imgBuffer.byteLength} bytes) to ${uploadUrl}`);
-    const uploadRes = await fetch(uploadUrl, {
-      method: 'PUT',
-      headers: { 'Content-Type': 'application/octet-stream' },
-      body: imgBuffer,
-    });
-
-    if (!uploadRes.ok) {
-      const errBody = await uploadRes.text().catch(() => '');
-      throw new Error(`publishImagePost upload HTTP ${uploadRes.status}: ${errBody}`);
-    }
-
-    imageUrns.push(imageUrn);
-    console.log(`[linkedin:publisher] Image registered: ${imageUrn}`);
-  }
-
-  // Step 3 — Create the post referencing the uploaded image(s).
-  // LinkedIn's Posts API supports a single media attachment per post.
-  // For multi-image posts a multiImage content type is required (uses a different
-  // content.multiImage shape). Here we attach the first image; for multi-image
-  // carousels extend this to use content.multiImage.images[].
-  const url = `${LI_REST_BASE}/posts`;
-  const postBody = {
-    author: personUrn,
-    commentary: text,
-    visibility: 'PUBLIC',
-    distribution: { feedDistribution: 'MAIN_FEED' },
-    lifecycleState: 'PUBLISHED',
-    content: {
-      media: { id: imageUrns[0] },
-    },
-  };
-
-  console.log(`[linkedin:publisher] Creating image post with ${imageUrns.length} image(s) as ${personUrn}`);
-
-  const res = await fetch(url, {
-    method: 'POST',
-    headers: buildHeaders(token),
-    body: JSON.stringify(postBody),
-  });
-
-  if (!res.ok) {
-    const errBody = await res.text().catch(() => '');
-    throw new Error(`publishImagePost HTTP ${res.status}: ${errBody}`);
-  }
-
-  const postUrn = res.headers.get('x-restli-id') ?? res.headers.get('X-RestLi-Id') ?? '';
-  console.log(`[linkedin:publisher] Image post created. URN: ${postUrn}`);
-  return postUrn;
-}
-
-/**
- * Publishes a post with an article (URL) link attachment.
- *
- * LinkedIn will generate a link preview card from the article URL.
- *
- * @param {string} token      - LinkedIn OAuth access token.
- * @param {string} personUrn  - Author URN, e.g. "urn:li:person:XXXXX".
- * @param {string} text       - Post commentary text shown above the preview card.
- * @param {string} articleUrl - The URL to attach as a link preview.
- * @param {string} title      - Title to display in the link preview card.
- * @returns {Promise<string>} The created post URN.
- */
-async function publishArticlePost(token, personUrn, text, articleUrl, title) {
-  if (!token) throw new Error('publishArticlePost: token is required');
-  if (!personUrn) throw new Error('publishArticlePost: personUrn is required');
-  if (!text) throw new Error('publishArticlePost: text is required');
-  if (!articleUrl) throw new Error('publishArticlePost: articleUrl is required');
-  if (!title) throw new Error('publishArticlePost: title is required');
-
-  const url = `${LI_REST_BASE}/posts`;
-  const body = {
-    author: personUrn,
-    commentary: text,
-    visibility: 'PUBLIC',
-    distribution: { feedDistribution: 'MAIN_FEED' },
-    lifecycleState: 'PUBLISHED',
-    content: {
-      article: {
-        source: articleUrl,
-        title: title,
-      },
-    },
-  };
-
-  console.log(`[linkedin:publisher] Publishing article post: "${title}" → ${articleUrl}`);
-
-  const res = await fetch(url, {
-    method: 'POST',
-    headers: buildHeaders(token),
-    body: JSON.stringify(body),
-  });
-
-  if (!res.ok) {
-    const errBody = await res.text().catch(() => '');
-    throw new Error(`publishArticlePost HTTP ${res.status}: ${errBody}`);
-  }
-
-  const postUrn = res.headers.get('x-restli-id') ?? res.headers.get('X-RestLi-Id') ?? '';
-  console.log(`[linkedin:publisher] Article post created. URN: ${postUrn}`);
-  return postUrn;
-}
-
-module.exports = { publishTextPost, publishImagePost, publishArticlePost };
-
-// ---------------------------------------------------------------------------
-// Stand-alone execution
-// ---------------------------------------------------------------------------
-if (require.main === module) {
-  const args = process.argv.slice(2);
-
-  function getArg(flag) {
-    const prefix = `${flag}=`;
-    const entry = args.find((a) => a.startsWith(prefix));
-    return entry ? entry.slice(prefix.length) : null;
-  }
-
-  const text = getArg('--text');
-  const articleUrl = getArg('--article-url');
-  const title = getArg('--title');
-
-  if (!text) {
-    console.error(
-      'Usage: node linkedin.js --text=<post text> [--article-url=<url> --title=<title>]'
-    );
-    process.exit(1);
-  }
-
-  const token = process.env.LINKEDIN_ACCESS_TOKEN;
-  const personUrn = process.env.LINKEDIN_PERSON_URN;
-
-  if (!token) {
-    console.error('LINKEDIN_ACCESS_TOKEN is not set');
-    process.exit(1);
-  }
-  if (!personUrn) {
-    console.error('LINKEDIN_PERSON_URN is not set');
-    process.exit(1);
-  }
-
-  (async () => {
-    try {
-      let postUrn;
-      if (articleUrl && title) {
-        postUrn = await publishArticlePost(token, personUrn, text, articleUrl, title);
-      } else {
-        postUrn = await publishTextPost(token, personUrn, text);
-      }
-      console.log(`[linkedin:publisher] Done. Post URN: ${postUrn}`);
-    } catch (err) {
-      console.error('[linkedin:publisher] Failed:', err.message);
-      process.exit(1);
-    }
-  })();
-}