optimal-cli 1.0.0 → 1.0.1

package/dist/lib/social/meta.js

@@ -0,0 +1,160 @@
+/**
+ * Meta Graph API — Instagram Content Publishing
+ *
+ * Direct Instagram publishing via Meta's Content Publishing API.
+ * Replaces n8n webhook intermediary for IG posts.
+ *
+ * Functions:
+ *   publishIgPhoto()     — Publish a single image post to Instagram
+ *   publishIgCarousel()  — Publish a carousel (multi-image) post to Instagram
+ *   getMetaConfig()      — Read Meta credentials from env vars
+ *   getMetaConfigForBrand() — Read brand-specific Meta credentials
+ */
+export class MetaApiError extends Error {
+    status;
+    metaError;
+    constructor(message, status, metaError) {
+        super(message);
+        this.status = status;
+        this.metaError = metaError;
+        this.name = 'MetaApiError';
+    }
+}
+// ── Config ───────────────────────────────────────────────────────────
+const GRAPH_API_BASE = 'https://graph.facebook.com/v21.0';
+// Injectable fetch for testing
+let _fetch = globalThis.fetch;
+export function setFetchForTests(fn) {
+    _fetch = fn;
+}
+export function resetFetchForTests() {
+    _fetch = globalThis.fetch;
+}
+// ── Internal helpers ─────────────────────────────────────────────────
+async function graphPost(path, body) {
+    const res = await _fetch(`${GRAPH_API_BASE}${path}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const err = data.error;
+        throw new MetaApiError(err?.message ?? `Meta API ${res.status}: ${res.statusText}`, res.status, err ? { message: err.message ?? '', type: err.type, code: err.code } : undefined);
+    }
+    return data;
+}
+// ── Config readers ───────────────────────────────────────────────────
+/**
+ * Read Meta API credentials from environment variables.
+ * Requires: META_ACCESS_TOKEN, META_IG_ACCOUNT_ID
+ */
+export function getMetaConfig() {
+    const accessToken = process.env.META_ACCESS_TOKEN;
+    const igAccountId = process.env.META_IG_ACCOUNT_ID;
+    if (!accessToken) {
+        throw new Error('Missing env var: META_ACCESS_TOKEN\n' +
+            'Get a long-lived page access token from Meta Business Suite:\n' +
+            '  https://business.facebook.com/settings/system-users');
+    }
+    if (!igAccountId) {
+        throw new Error('Missing env var: META_IG_ACCOUNT_ID\n' +
+            'Find your IG Business account ID via Graph API Explorer:\n' +
+            '  GET /me/accounts → page_id → GET /{page_id}?fields=instagram_business_account');
+    }
+    return { accessToken, igAccountId };
+}
+/**
+ * Read Meta API credentials for a specific brand.
+ * Looks for META_IG_ACCOUNT_ID_{BRAND} first, falls back to META_IG_ACCOUNT_ID.
+ * Brand key is normalized: hyphens become underscores (CRE-11TRUST → CRE_11TRUST).
+ */
+export function getMetaConfigForBrand(brand) {
+    const accessToken = process.env.META_ACCESS_TOKEN;
+    if (!accessToken) {
+        throw new Error('Missing env var: META_ACCESS_TOKEN');
+    }
+    const envKey = `META_IG_ACCOUNT_ID_${brand.replace(/-/g, '_')}`;
+    const igAccountId = process.env[envKey] ?? process.env.META_IG_ACCOUNT_ID;
+    if (!igAccountId) {
+        throw new Error(`Missing env var: ${envKey} or META_IG_ACCOUNT_ID`);
+    }
+    return { accessToken, igAccountId };
+}
+// ── Publishing ───────────────────────────────────────────────────────
+/**
+ * Publish a single photo to Instagram.
+ *
+ * Two-step process per Meta Content Publishing API:
+ * 1. Create media container with image_url + caption
+ * 2. Publish the container
+ *
+ * @example
+ *   const result = await publishIgPhoto(config, {
+ *     imageUrl: 'https://cdn.example.com/photo.jpg',
+ *     caption: 'Check out our latest listing! #realestate',
+ *   })
+ *   console.log(`Published: ${result.mediaId}`)
+ */
+export async function publishIgPhoto(config, opts) {
+    // Step 1: Create media container
+    const container = await graphPost(`/${config.igAccountId}/media`, {
+        image_url: opts.imageUrl,
+        caption: opts.caption,
+        access_token: config.accessToken,
+    });
+    // Step 2: Publish the container
+    const published = await graphPost(`/${config.igAccountId}/media_publish`, {
+        creation_id: container.id,
+        access_token: config.accessToken,
+    });
+    return {
+        containerId: container.id,
+        mediaId: published.id,
+    };
+}
+/**
+ * Publish a carousel (multi-image) post to Instagram.
+ *
+ * Three-step process:
+ * 1. Create individual item containers (is_carousel_item=true)
+ * 2. Create carousel container referencing all item IDs
+ * 3. Publish the carousel container
+ *
+ * @example
+ *   const result = await publishIgCarousel(config, {
+ *     caption: 'Property tour highlights',
+ *     items: [
+ *       { imageUrl: 'https://cdn.example.com/1.jpg' },
+ *       { imageUrl: 'https://cdn.example.com/2.jpg' },
+ *     ],
+ *   })
+ */
+export async function publishIgCarousel(config, opts) {
+    // Step 1: Create individual item containers
+    const itemIds = [];
+    for (const item of opts.items) {
+        const container = await graphPost(`/${config.igAccountId}/media`, {
+            image_url: item.imageUrl,
+            is_carousel_item: true,
+            access_token: config.accessToken,
+        });
+        itemIds.push(container.id);
+    }
+    // Step 2: Create carousel container
+    const carousel = await graphPost(`/${config.igAccountId}/media`, {
+        media_type: 'CAROUSEL',
+        children: itemIds,
+        caption: opts.caption,
+        access_token: config.accessToken,
+    });
+    // Step 3: Publish
+    const published = await graphPost(`/${config.igAccountId}/media_publish`, {
+        creation_id: carousel.id,
+        access_token: config.accessToken,
+    });
+    return {
+        containerId: carousel.id,
+        mediaId: published.id,
+    };
+}

package/dist/lib/social/post-generator.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Social Post Generation Pipeline
+ *
+ * Ported from Python: ~/projects/newsletter-automation social post pipeline
+ *
+ * Pipeline: Groq AI generates post ideas -> Unsplash image search -> Strapi push
+ *
+ * Functions:
+ *   callGroq()            — call Groq API (OpenAI-compatible) for AI content
+ *   searchUnsplashImage() — search Unsplash NAPI for a stock photo URL
+ *   generateSocialPosts() — orchestrator: generate posts and push to Strapi
+ */
+import 'dotenv/config';
+export interface GeneratePostsOptions {
+    brand: string;
+    /** Number of posts to generate (default: 9) */
+    count?: number;
+    /** Week start date in YYYY-MM-DD format */
+    weekOf?: string;
+    /** Platforms to target (default: ['instagram', 'facebook']) */
+    platforms?: string[];
+    /** Generate but do not push to Strapi */
+    dryRun?: boolean;
+}
+export interface SocialPostData {
+    headline: string;
+    body: string;
+    cta_text: string;
+    cta_url: string;
+    image_url: string | null;
+    overlay_style: 'dark-bottom' | 'brand-bottom' | 'brand-full' | 'dark-full';
+    template: string;
+    platform: string;
+    brand: string;
+    scheduled_date: string;
+    delivery_status: 'pending';
+}
+export interface GeneratePostsResult {
+    brand: string;
+    postsCreated: number;
+    posts: Array<{
+        documentId: string;
+        headline: string;
+        platform: string;
+        scheduled_date: string;
+    }>;
+    errors: string[];
+}
+/**
+ * Call the Groq API (OpenAI-compatible) and return the assistant's response text.
+ *
+ * @example
+ *   const response = await callGroq('You are a copywriter.', 'Write a tagline.')
+ */
+export declare function callGroq(systemPrompt: string, userPrompt: string): Promise<string>;
+/**
+ * Search Unsplash NAPI for a themed stock photo URL.
+ * Returns the `.results[0].urls.regular` URL, or null if not found.
+ *
+ * Note: Uses the public NAPI endpoint — no auth required but may be rate-limited.
+ *
+ * @example
+ *   const url = await searchUnsplashImage('life insurance family protection')
+ */
+export declare function searchUnsplashImage(query: string): Promise<string | null>;
+/**
+ * Main orchestrator: generate AI-powered social media posts and push to Strapi.
+ *
+ * Steps:
+ *   1. Call Groq to generate post ideas as JSON
+ *   2. For each post, search Unsplash for a themed image
+ *   3. Build SocialPostData and push to Strapi via POST /api/social-posts
+ *   4. Return summary of created posts and any errors
+ *
+ * @example
+ *   const result = await generateSocialPosts({
+ *     brand: 'LIFEINSUR',
+ *     count: 9,
+ *     weekOf: '2026-03-02',
+ *   })
+ *   console.log(`Created ${result.postsCreated} posts`)
+ */
+export declare function generateSocialPosts(opts: GeneratePostsOptions): Promise<GeneratePostsResult>;

package/dist/lib/social/post-generator.js

@@ -0,0 +1,333 @@
+/**
+ * Social Post Generation Pipeline
+ *
+ * Ported from Python: ~/projects/newsletter-automation social post pipeline
+ *
+ * Pipeline: Groq AI generates post ideas -> Unsplash image search -> Strapi push
+ *
+ * Functions:
+ *   callGroq()            — call Groq API (OpenAI-compatible) for AI content
+ *   searchUnsplashImage() — search Unsplash NAPI for a stock photo URL
+ *   generateSocialPosts() — orchestrator: generate posts and push to Strapi
+ */
+import 'dotenv/config';
+import { strapiPost } from '../cms/strapi-client.js';
+// ── Constants ────────────────────────────────────────────────────────
+const OVERLAY_STYLES = [
+    'dark-bottom',
+    'brand-bottom',
+    'brand-full',
+    'dark-full',
+];
+const BRAND_CONFIGS = {
+    'CRE-11TRUST': {
+        displayName: 'ElevenTrust Commercial Real Estate',
+        ctaUrl: 'https://eleventrust.com',
+        industry: 'commercial real estate in South Florida',
+    },
+    'LIFEINSUR': {
+        displayName: 'Anchor Point Insurance Co.',
+        ctaUrl: 'https://anchorpointinsurance.com',
+        industry: 'life insurance and financial protection',
+    },
+};
+// ── Environment helper ───────────────────────────────────────────────
+function requireEnv(name) {
+    const val = process.env[name];
+    if (!val)
+        throw new Error(`Missing env var: ${name}`);
+    return val;
+}
+// ── 1. Groq API Call ─────────────────────────────────────────────────
+/**
+ * Call the Groq API (OpenAI-compatible) and return the assistant's response text.
+ *
+ * @example
+ *   const response = await callGroq('You are a copywriter.', 'Write a tagline.')
+ */
+export async function callGroq(systemPrompt, userPrompt) {
+    const apiKey = requireEnv('GROQ_API_KEY');
+    const model = process.env.GROQ_MODEL ?? 'llama-3.3-70b-versatile';
+    const messages = [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userPrompt },
+    ];
+    const response = await fetch('https://api.groq.com/openai/v1/chat/completions', {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            model,
+            messages,
+            temperature: 0.8,
+        }),
+    });
+    const data = await response.json();
+    if (!data.choices || data.choices.length === 0) {
+        throw new Error(`Groq error: ${JSON.stringify(data.error ?? data)}`);
+    }
+    return data.choices[0].message.content;
+}
+// ── 2. Unsplash Image Search ─────────────────────────────────────────
+/**
+ * Search Unsplash NAPI for a themed stock photo URL.
+ * Returns the `.results[0].urls.regular` URL, or null if not found.
+ *
+ * Note: Uses the public NAPI endpoint — no auth required but may be rate-limited.
+ *
+ * @example
+ *   const url = await searchUnsplashImage('life insurance family protection')
+ */
+export async function searchUnsplashImage(query) {
+    try {
+        const encodedQuery = encodeURIComponent(query);
+        const response = await fetch(`https://unsplash.com/napi/search/photos?query=${encodedQuery}&per_page=3`, {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36',
+                Accept: 'application/json',
+            },
+        });
+        if (!response.ok) {
+            console.warn(`   [Unsplash] HTTP ${response.status} for query: "${query}"`);
+            return null;
+        }
+        const data = await response.json();
+        const url = data.results?.[0]?.urls?.regular ?? null;
+        if (!url) {
+            console.warn(`   [Unsplash] No results for query: "${query}"`);
+        }
+        return url;
+    }
+    catch (err) {
+        console.warn(`   [Unsplash] Error searching for "${query}": ${err.message}`);
+        return null;
+    }
+}
+// ── 3. Build Weekly Schedule ─────────────────────────────────────────
+/**
+ * Distribute post dates across a week (Mon-Fri + weekend for overflow).
+ * Returns an array of ISO date strings (YYYY-MM-DD).
+ */
+function buildWeeklySchedule(weekOf, count) {
+    const start = new Date(weekOf);
+    // Ensure we start from Monday — find the Monday of the given week
+    const dayOfWeek = start.getDay(); // 0=Sun, 1=Mon, ..., 6=Sat
+    const daysToMonday = dayOfWeek === 0 ? -6 : 1 - dayOfWeek;
+    start.setDate(start.getDate() + daysToMonday);
+    // Build Mon-Sun sequence (7 days)
+    const weekDays = [];
+    for (let i = 0; i < 7; i++) {
+        const d = new Date(start);
+        d.setDate(start.getDate() + i);
+        weekDays.push(d.toISOString().slice(0, 10));
+    }
+    // Fill schedule: Mon-Fri first, then Sat-Sun for overflow
+    const schedule = [];
+    const weekdaySlots = weekDays.slice(0, 5); // Mon-Fri
+    const weekendSlots = weekDays.slice(5); // Sat-Sun
+    for (let i = 0; i < count; i++) {
+        if (i < weekdaySlots.length) {
+            schedule.push(weekdaySlots[i]);
+        }
+        else {
+            // Overflow into weekend, then repeat weekdays
+            const overflowSlots = [...weekendSlots, ...weekdaySlots];
+            schedule.push(overflowSlots[(i - weekdaySlots.length) % overflowSlots.length]);
+        }
+    }
+    return schedule;
+}
+// ── 4. Build AI Prompts ──────────────────────────────────────────────
+function buildSystemPrompt(brand) {
+    const config = BRAND_CONFIGS[brand];
+    const displayName = config?.displayName ?? brand;
+    const industry = config?.industry ?? 'professional services';
+    return `You are an expert social media copywriter specializing in ${industry} for ${displayName}.
+
+Your task is to generate engaging, conversion-focused social media ad posts. Each post must:
+- Hook the viewer in the first line (no generic openers)
+- Speak to a specific pain point or aspiration
+- Include a clear, action-oriented CTA
+- Be authentic and avoid jargon
+- Be appropriate for paid social advertising (Instagram and Facebook)
+
+Always respond with ONLY valid JSON — no markdown fences, no explanations, no extra text.`;
+}
+function buildUserPrompt(brand, platforms, weekStart, count) {
+    const config = BRAND_CONFIGS[brand];
+    const displayName = config?.displayName ?? brand;
+    const ctaUrl = config?.ctaUrl ?? 'https://example.com';
+    const industry = config?.industry ?? 'professional services';
+    return `Generate ${count} social media ad posts for ${displayName} (brand: ${brand}).
+
+Target platforms: ${platforms.join(', ')}
+Week of: ${weekStart}
+Industry: ${industry}
+CTA URL: ${ctaUrl}
+
+Return a JSON array of exactly ${count} post objects. Each object must have these exact fields:
+- "headline": string — attention-grabbing first line (max 60 chars)
+- "body": string — 2-4 sentence post copy (max 280 chars)
+- "cta_text": string — button label (e.g., "Get a Free Quote", "Learn More", "Schedule a Call")
+- "cta_url": string — full URL for the CTA
+- "image_search_query": string — 3-5 keyword search string to find a relevant stock photo on Unsplash
+- "overlay_style": string — one of: "dark-bottom", "brand-bottom", "brand-full", "dark-full"
+- "template": string — one of: "standard", "quote", "offer", "testimonial", "educational"
+
+Vary the templates, tones, and angles across the ${count} posts. Mix benefit-focused, story-driven, and urgency-based approaches.
+
+Return ONLY the JSON array, no other text.`;
+}
+// ── 5. Parse AI Response ─────────────────────────────────────────────
+function parseAiPostIdeas(raw) {
+    let content = raw.trim();
+    // Strip markdown fences if present
+    if (content.startsWith('```')) {
+        const firstNewline = content.indexOf('\n');
+        content = firstNewline !== -1 ? content.slice(firstNewline + 1) : content.slice(3);
+    }
+    if (content.endsWith('```')) {
+        content = content.slice(0, -3).trim();
+    }
+    const parsed = JSON.parse(content);
+    if (!Array.isArray(parsed)) {
+        throw new Error('AI response is not a JSON array');
+    }
+    return parsed;
+}
+// ── 6. Orchestrator ──────────────────────────────────────────────────
+/**
+ * Main orchestrator: generate AI-powered social media posts and push to Strapi.
+ *
+ * Steps:
+ *   1. Call Groq to generate post ideas as JSON
+ *   2. For each post, search Unsplash for a themed image
+ *   3. Build SocialPostData and push to Strapi via POST /api/social-posts
+ *   4. Return summary of created posts and any errors
+ *
+ * @example
+ *   const result = await generateSocialPosts({
+ *     brand: 'LIFEINSUR',
+ *     count: 9,
+ *     weekOf: '2026-03-02',
+ *   })
+ *   console.log(`Created ${result.postsCreated} posts`)
+ */
+export async function generateSocialPosts(opts) {
+    const { brand, count = 9, weekOf = new Date().toISOString().slice(0, 10), platforms = ['instagram', 'facebook'], dryRun = false, } = opts;
+    const config = BRAND_CONFIGS[brand];
+    const displayName = config?.displayName ?? brand;
+    console.log('='.repeat(60));
+    console.log(`SOCIAL POST GENERATOR — ${displayName}`);
+    console.log('='.repeat(60));
+    console.log(`Brand: ${brand}`);
+    console.log(`Count: ${count}`);
+    console.log(`Week of: ${weekOf}`);
+    console.log(`Platforms: ${platforms.join(', ')}`);
+    if (dryRun)
+        console.log('DRY RUN — will not push to Strapi');
+    const result = {
+        brand,
+        postsCreated: 0,
+        posts: [],
+        errors: [],
+    };
+    // Step 1: Generate post ideas via Groq
+    console.log(`\n1. Calling Groq to generate ${count} post ideas...`);
+    let postIdeas;
+    try {
+        const systemPrompt = buildSystemPrompt(brand);
+        const userPrompt = buildUserPrompt(brand, platforms, weekOf, count);
+        const raw = await callGroq(systemPrompt, userPrompt);
+        postIdeas = parseAiPostIdeas(raw);
+        console.log(`   Generated ${postIdeas.length} post ideas`);
+    }
+    catch (err) {
+        const msg = `Failed to generate post ideas: ${err.message}`;
+        console.error(`   ERROR: ${msg}`);
+        result.errors.push(msg);
+        return result;
+    }
+    // Step 2: Build weekly schedule
+    const schedule = buildWeeklySchedule(weekOf, count);
+    console.log(`\n2. Scheduling posts: ${schedule[0]} → ${schedule[schedule.length - 1]}`);
+    // Step 3: Process each post idea
+    console.log(`\n3. Processing ${postIdeas.length} posts (image search + Strapi push)...`);
+    for (let i = 0; i < postIdeas.length; i++) {
+        const idea = postIdeas[i];
+        const platform = platforms[i % platforms.length];
+        const scheduled_date = schedule[i] ?? schedule[schedule.length - 1];
+        const overlay_style = OVERLAY_STYLES[i % OVERLAY_STYLES.length];
+        console.log(`\n   [${i + 1}/${postIdeas.length}] "${idea.headline}"`);
+        console.log(`   Platform: ${platform} | Date: ${scheduled_date}`);
+        // Search Unsplash for image
+        let image_url = null;
+        if (idea.image_search_query) {
+            console.log(`   Searching Unsplash: "${idea.image_search_query}"`);
+            image_url = await searchUnsplashImage(idea.image_search_query);
+            if (image_url) {
+                console.log(`   Image found: ${image_url.slice(0, 60)}...`);
+            }
+            else {
+                console.log(`   No image found — posting without image`);
+            }
+        }
+        // Build post data
+        const postData = {
+            headline: idea.headline,
+            body: idea.body,
+            cta_text: idea.cta_text,
+            cta_url: idea.cta_url,
+            image_url,
+            overlay_style: idea.overlay_style ?? overlay_style,
+            template: idea.template ?? 'standard',
+            platform,
+            brand,
+            scheduled_date,
+            delivery_status: 'pending',
+        };
+        // Push to Strapi (unless dry run)
+        if (dryRun) {
+            console.log(`   DRY RUN — would create post in Strapi`);
+            result.posts.push({
+                documentId: `dry-run-${i + 1}`,
+                headline: postData.headline,
+                platform: postData.platform,
+                scheduled_date: postData.scheduled_date,
+            });
+            result.postsCreated++;
+        }
+        else {
+            try {
+                const created = await strapiPost('/api/social-posts', postData);
+                const documentId = created.documentId ?? 'unknown';
+                console.log(`   Created in Strapi (documentId: ${documentId})`);
+                result.posts.push({
+                    documentId,
+                    headline: postData.headline,
+                    platform: postData.platform,
+                    scheduled_date: postData.scheduled_date,
+                });
+                result.postsCreated++;
+            }
+            catch (err) {
+                const msg = `Failed to create post "${idea.headline}": ${err.message}`;
+                console.error(`   ERROR: ${msg}`);
+                result.errors.push(msg);
+            }
+        }
+    }
+    // Summary
+    console.log('\n' + '='.repeat(60));
+    console.log(`DONE! Created ${result.postsCreated}/${count} posts`);
+    if (result.errors.length > 0) {
+        console.log(`Errors (${result.errors.length}):`);
+        for (const e of result.errors) {
+            console.log(`  - ${e}`);
+        }
+    }
+    console.log('='.repeat(60));
+    return result;
+}

package/dist/lib/social/publish.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 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';
+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;
+    }>;
+}
+/**
+ * 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 declare function publishSocialPosts(opts: PublishOptions): Promise<PublishResult>;
+/**
+ * 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 declare function getPublishQueue(brand: string): Promise<QueuedPost[]>;
+/**
+ * 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 declare function retryFailed(brand: string): Promise<PublishResult>;