optimal-cli 1.0.0 → 1.0.1

package/lib/social/publish.ts

@@ -1,301 +0,0 @@
-/**
- * Social Post Publisher
- *
- * Handles publishing social posts from Strapi to platforms via n8n webhooks,
- * with delivery status tracking written back to Strapi.
- *
- * Functions:
- *   publishSocialPosts()  — Main orchestrator: fetch pending posts, publish to Strapi,
- *                           trigger n8n webhook, update delivery_status
- *   getPublishQueue()     — List posts ready to publish (pending + has scheduled_date)
- *   retryFailed()         — Re-attempt posts with delivery_status = 'failed'
- */
-
-import 'dotenv/config'
-import {
-  strapiGet,
-  strapiPut,
-  publish,
-  type StrapiPage,
-  type StrapiItem,
-} from '../cms/strapi-client.js'
-
-// ── Types ─────────────────────────────────────────────────────────────
-
-export interface PublishOptions {
-  brand: string
-  /** Max posts to publish (default: all pending) */
-  limit?: number
-  /** Preview without actually publishing */
-  dryRun?: boolean
-}
-
-export interface QueuedPost {
-  documentId: string
-  headline: string
-  platform: string
-  brand: string
-  scheduled_date: string
-}
-
-export interface PublishResult {
-  published: number
-  failed: number
-  skipped: number
-  details: Array<{
-    documentId: string
-    headline: string
-    status: 'published' | 'failed' | 'skipped'
-    error?: string
-  }>
-}
-
-// ── Config ────────────────────────────────────────────────────────────
-
-function getN8nWebhookUrl(): string {
-  const url = process.env.N8N_WEBHOOK_URL
-  if (!url) {
-    throw new Error(
-      'Missing env var: N8N_WEBHOOK_URL\n' +
-        'Set it in your .env file, e.g.:\n' +
-        '  N8N_WEBHOOK_URL=https://n8n.op-hub.com',
-    )
-  }
-  return url.replace(/\/+$/, '')
-}
-
-// ── Internal helpers ──────────────────────────────────────────────────
-
-/** Trigger n8n webhook for a single social post */
-async function triggerN8nWebhook(
-  documentId: string,
-  platform: string,
-  brand: string,
-): Promise<void> {
-  const baseUrl = getN8nWebhookUrl()
-  const webhookUrl = `${baseUrl}/webhook/social-post-publish`
-
-  const res = await fetch(webhookUrl, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ documentId, platform, brand }),
-  })
-
-  if (!res.ok) {
-    let detail = `HTTP ${res.status}: ${res.statusText}`
-    try {
-      const body = await res.text()
-      if (body) detail += ` — ${body.slice(0, 200)}`
-    } catch {
-      // non-text body, ignore
-    }
-    throw new Error(`n8n webhook failed: ${detail}`)
-  }
-}
-
-/** Fetch social posts by brand + delivery_status from Strapi */
-async function fetchPostsByStatus(
-  brand: string,
-  deliveryStatus: 'pending' | 'failed',
-): Promise<StrapiItem[]> {
-  const result = await strapiGet<StrapiPage>('/api/social-posts', {
-    'filters[brand][$eq]': brand,
-    'filters[delivery_status][$eq]': deliveryStatus,
-    'sort': 'scheduled_date:asc',
-    'pagination[pageSize]': '250',
-  })
-  return result.data
-}
-
-/** Process a single post: publish in Strapi, trigger n8n, update status */
-async function processPost(
-  post: StrapiItem,
-  dryRun: boolean,
-): Promise<{ status: 'published' | 'failed' | 'skipped'; error?: string }> {
-  const documentId = post.documentId
-  const headline = (post.headline as string | undefined) ?? '(no headline)'
-  const platform = (post.platform as string | undefined) ?? 'unknown'
-  const brand = (post.brand as string | undefined) ?? 'unknown'
-
-  if (dryRun) {
-    return { status: 'skipped' }
-  }
-
-  try {
-    // Step 1: Publish in Strapi (set publishedAt)
-    await publish('social-posts', documentId)
-
-    // Step 2: Trigger n8n webhook
-    try {
-      await triggerN8nWebhook(documentId, platform, brand)
-    } catch (webhookErr) {
-      // Webhook failure: mark failed, but don't rethrow — continue to next post
-      const errMsg = webhookErr instanceof Error ? webhookErr.message : String(webhookErr)
-      await strapiPut('/api/social-posts', documentId, {
-        delivery_status: 'failed',
-        delivery_errors: [{ timestamp: new Date().toISOString(), error: errMsg }],
-      })
-      return { status: 'failed', error: errMsg }
-    }
-
-    // Step 3: Update delivery_status to 'scheduled' on success
-    await strapiPut('/api/social-posts', documentId, {
-      delivery_status: 'scheduled',
-    })
-
-    return { status: 'published' }
-  } catch (err) {
-    const errMsg = err instanceof Error ? err.message : String(err)
-    // Best-effort status update on unexpected errors
-    try {
-      await strapiPut('/api/social-posts', documentId, {
-        delivery_status: 'failed',
-        delivery_errors: [{ timestamp: new Date().toISOString(), error: errMsg }],
-      })
-    } catch {
-      // Ignore secondary failure — original error is more important
-    }
-    return { status: 'failed', error: errMsg }
-  }
-}
-
-// ── Core orchestrator ─────────────────────────────────────────────────
-
-/**
- * Fetch pending social posts for a brand and publish them:
- *   1. Publish in Strapi (set publishedAt)
- *   2. Trigger n8n webhook
- *   3. Update delivery_status to 'scheduled' (or 'failed' on error)
- *
- * @example
- *   const result = await publishSocialPosts({ brand: 'LIFEINSUR', limit: 3 })
- *   console.log(`Published: ${result.published}, Failed: ${result.failed}`)
- */
-export async function publishSocialPosts(
-  opts: PublishOptions,
-): Promise<PublishResult> {
-  const { brand, limit, dryRun = false } = opts
-
-  // Validate n8n URL up front (unless dry run)
-  if (!dryRun) {
-    getN8nWebhookUrl()
-  }
-
-  const posts = await fetchPostsByStatus(brand, 'pending')
-  const postsToProcess = limit !== undefined ? posts.slice(0, limit) : posts
-
-  const result: PublishResult = {
-    published: 0,
-    failed: 0,
-    skipped: 0,
-    details: [],
-  }
-
-  for (const post of postsToProcess) {
-    const documentId = post.documentId
-    const headline = (post.headline as string | undefined) ?? '(no headline)'
-
-    const outcome = await processPost(post, dryRun)
-
-    if (outcome.status === 'published') result.published++
-    else if (outcome.status === 'failed') result.failed++
-    else result.skipped++
-
-    result.details.push({
-      documentId,
-      headline,
-      status: outcome.status,
-      ...(outcome.error !== undefined && { error: outcome.error }),
-    })
-  }
-
-  return result
-}
-
-// ── Publish queue ─────────────────────────────────────────────────────
-
-/**
- * List posts ready to publish: delivery_status = 'pending' AND has a scheduled_date.
- *
- * @example
- *   const queue = await getPublishQueue('LIFEINSUR')
- *   queue.forEach(p => console.log(p.scheduled_date, p.headline))
- */
-export async function getPublishQueue(brand: string): Promise<QueuedPost[]> {
-  const posts = await fetchPostsByStatus(brand, 'pending')
-
-  return posts
-    .filter((post) => {
-      const scheduledDate = post.scheduled_date as string | null | undefined
-      return scheduledDate != null && scheduledDate !== ''
-    })
-    .map((post) => ({
-      documentId: post.documentId,
-      headline: (post.headline as string | undefined) ?? '(no headline)',
-      platform: (post.platform as string | undefined) ?? 'unknown',
-      brand: (post.brand as string | undefined) ?? brand,
-      scheduled_date: post.scheduled_date as string,
-    }))
-}
-
-// ── Retry failed ──────────────────────────────────────────────────────
-
-/**
- * Re-attempt publishing posts with delivery_status = 'failed'.
- * Resets delivery_status to 'pending' on each post before re-processing.
- *
- * @example
- *   const result = await retryFailed('LIFEINSUR')
- *   console.log(`Re-published: ${result.published}, Still failing: ${result.failed}`)
- */
-export async function retryFailed(brand: string): Promise<PublishResult> {
-  // Validate n8n URL up front
-  getN8nWebhookUrl()
-
-  const posts = await fetchPostsByStatus(brand, 'failed')
-
-  const result: PublishResult = {
-    published: 0,
-    failed: 0,
-    skipped: 0,
-    details: [],
-  }
-
-  for (const post of posts) {
-    const documentId = post.documentId
-    const headline = (post.headline as string | undefined) ?? '(no headline)'
-
-    // Reset to pending so processPost can re-publish cleanly
-    try {
-      await strapiPut('/api/social-posts', documentId, {
-        delivery_status: 'pending',
-        delivery_errors: null,
-      })
-    } catch (err) {
-      const errMsg = err instanceof Error ? err.message : String(err)
-      result.failed++
-      result.details.push({
-        documentId,
-        headline,
-        status: 'failed',
-        error: `Could not reset delivery_status: ${errMsg}`,
-      })
-      continue
-    }
-
-    const outcome = await processPost(post, false)
-
-    if (outcome.status === 'published') result.published++
-    else if (outcome.status === 'failed') result.failed++
-    else result.skipped++
-
-    result.details.push({
-      documentId,
-      headline,
-      status: outcome.status,
-      ...(outcome.error !== undefined && { error: outcome.error }),
-    })
-  }
-
-  return result
-}