optimal-cli 0.1.0

package/dist/lib/newsletter/distribute.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Newsletter Distribution Module
+ *
+ * Triggers newsletter distribution via the n8n webhook and updates
+ * Strapi delivery tracking fields accordingly.
+ *
+ * Functions:
+ *   distributeNewsletter(documentId, opts?) — orchestrate distribution
+ *   checkDistributionStatus(documentId)    — read current delivery status
+ */
+import 'dotenv/config';
+export interface DistributionResult {
+    success: boolean;
+    documentId: string;
+    channel: string;
+    webhookResponse?: unknown;
+    error?: string;
+}
+export interface DeliveryStatus {
+    documentId: string;
+    delivery_status: string;
+    delivered_at: string | null;
+    recipients_count: number | null;
+    ghl_campaign_id: string | null;
+    delivery_errors: unknown[] | null;
+}
+/**
+ * Main orchestrator: fetch newsletter from Strapi, validate state,
+ * update delivery_status to 'sending', trigger the n8n webhook,
+ * and update tracking fields based on the result.
+ *
+ * @param documentId - Strapi documentId (UUID string) of the newsletter
+ * @param opts.channel - Distribution channel. Defaults to 'all'.
+ *
+ * @example
+ *   const result = await distributeNewsletter('abc123-def456')
+ *   const emailOnly = await distributeNewsletter('abc123-def456', { channel: 'email' })
+ */
+export declare function distributeNewsletter(documentId: string, opts?: {
+    channel?: 'email' | 'all';
+}): Promise<DistributionResult>;
+/**
+ * Fetch the current delivery tracking fields for a newsletter from Strapi.
+ *
+ * @param documentId - Strapi documentId (UUID string) of the newsletter
+ *
+ * @example
+ *   const status = await checkDistributionStatus('abc123-def456')
+ *   console.log(status.delivery_status) // 'delivered'
+ *   console.log(status.recipients_count) // 847
+ */
+export declare function checkDistributionStatus(documentId: string): Promise<DeliveryStatus>;

package/dist/lib/newsletter/distribute.js

@@ -0,0 +1,193 @@
+/**
+ * Newsletter Distribution Module
+ *
+ * Triggers newsletter distribution via the n8n webhook and updates
+ * Strapi delivery tracking fields accordingly.
+ *
+ * Functions:
+ *   distributeNewsletter(documentId, opts?) — orchestrate distribution
+ *   checkDistributionStatus(documentId)    — read current delivery status
+ */
+import 'dotenv/config';
+import { strapiGet, strapiPut } from '../cms/strapi-client.js';
+// ── Environment helpers ───────────────────────────────────────────────
+function getWebhookUrl() {
+    const url = process.env.N8N_WEBHOOK_URL;
+    if (!url) {
+        throw new Error('Missing env var: N8N_WEBHOOK_URL\n' +
+            'Set it to your n8n base URL, e.g. https://n8n.op-hub.com\n' +
+            'The distribute module will POST to: $N8N_WEBHOOK_URL/webhook/newsletter-distribute');
+    }
+    return url.replace(/\/+$/, '');
+}
+// ── 1. Distribute Newsletter ──────────────────────────────────────────
+/**
+ * Main orchestrator: fetch newsletter from Strapi, validate state,
+ * update delivery_status to 'sending', trigger the n8n webhook,
+ * and update tracking fields based on the result.
+ *
+ * @param documentId - Strapi documentId (UUID string) of the newsletter
+ * @param opts.channel - Distribution channel. Defaults to 'all'.
+ *
+ * @example
+ *   const result = await distributeNewsletter('abc123-def456')
+ *   const emailOnly = await distributeNewsletter('abc123-def456', { channel: 'email' })
+ */
+export async function distributeNewsletter(documentId, opts = {}) {
+    const channel = opts.channel ?? 'all';
+    // Step 1: Fetch the newsletter from Strapi
+    let newsletter;
+    try {
+        const response = await strapiGet(`/api/newsletters/${documentId}`);
+        newsletter = response.data;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            documentId,
+            channel,
+            error: `Failed to fetch newsletter from Strapi: ${msg}`,
+        };
+    }
+    // Step 2: Validate published state
+    if (!newsletter.publishedAt) {
+        return {
+            success: false,
+            documentId,
+            channel,
+            error: 'Newsletter is not published. Publish it in Strapi before distributing.',
+        };
+    }
+    // Step 3: Validate delivery_status — only distribute if pending or unset
+    const currentStatus = newsletter.delivery_status ?? 'pending';
+    if (currentStatus !== 'pending' && currentStatus !== undefined) {
+        if (currentStatus === 'sending' ||
+            currentStatus === 'delivered' ||
+            currentStatus === 'partial') {
+            return {
+                success: false,
+                documentId,
+                channel,
+                error: `Newsletter already has delivery_status="${currentStatus}". Cannot re-distribute.`,
+            };
+        }
+    }
+    // Step 4: Mark as 'sending' in Strapi
+    try {
+        await strapiPut('/api/newsletters', documentId, {
+            delivery_status: 'sending',
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            documentId,
+            channel,
+            error: `Failed to update delivery_status to 'sending': ${msg}`,
+        };
+    }
+    // Step 5: Trigger n8n webhook
+    const webhookUrl = getWebhookUrl();
+    const webhookEndpoint = `${webhookUrl}/webhook/newsletter-distribute`;
+    const brand = typeof newsletter.brand === 'string' ? newsletter.brand : '';
+    let webhookResponse;
+    try {
+        const res = await fetch(webhookEndpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ documentId, brand, channel }),
+        });
+        if (!res.ok) {
+            let body;
+            try {
+                body = await res.json();
+            }
+            catch {
+                body = await res.text().catch(() => res.statusText);
+            }
+            // Webhook failed — update Strapi to 'failed' with error details
+            const errorDetails = [
+                { step: 'webhook', status: res.status, body },
+            ];
+            await strapiPut('/api/newsletters', documentId, {
+                delivery_status: 'failed',
+                delivery_errors: errorDetails,
+            }).catch(() => {
+                // Best-effort update — don't mask the original error
+            });
+            return {
+                success: false,
+                documentId,
+                channel,
+                error: `n8n webhook returned ${res.status}: ${JSON.stringify(body)}`,
+            };
+        }
+        try {
+            webhookResponse = await res.json();
+        }
+        catch {
+            webhookResponse = { status: res.status };
+        }
+    }
+    catch (err) {
+        // Network/connection error
+        const msg = err instanceof Error ? err.message : String(err);
+        const errorDetails = [{ step: 'webhook', error: msg }];
+        await strapiPut('/api/newsletters', documentId, {
+            delivery_status: 'failed',
+            delivery_errors: errorDetails,
+        }).catch(() => {
+            // Best-effort
+        });
+        return {
+            success: false,
+            documentId,
+            channel,
+            error: `n8n webhook request failed: ${msg}`,
+        };
+    }
+    // Step 6: Webhook succeeded — return success
+    // Note: n8n will update delivery_status to 'delivered' (or 'partial') via its
+    // own Strapi PUT once it finishes sending. We don't update it here.
+    return {
+        success: true,
+        documentId,
+        channel,
+        webhookResponse,
+    };
+}
+// ── 2. Check Distribution Status ─────────────────────────────────────
+/**
+ * Fetch the current delivery tracking fields for a newsletter from Strapi.
+ *
+ * @param documentId - Strapi documentId (UUID string) of the newsletter
+ *
+ * @example
+ *   const status = await checkDistributionStatus('abc123-def456')
+ *   console.log(status.delivery_status) // 'delivered'
+ *   console.log(status.recipients_count) // 847
+ */
+export async function checkDistributionStatus(documentId) {
+    const response = await strapiGet(`/api/newsletters/${documentId}`);
+    const data = response.data;
+    return {
+        documentId,
+        delivery_status: typeof data.delivery_status === 'string'
+            ? data.delivery_status
+            : 'pending',
+        delivered_at: typeof data.delivered_at === 'string'
+            ? data.delivered_at
+            : null,
+        recipients_count: typeof data.recipients_count === 'number'
+            ? data.recipients_count
+            : null,
+        ghl_campaign_id: typeof data.ghl_campaign_id === 'string'
+            ? data.ghl_campaign_id
+            : null,
+        delivery_errors: Array.isArray(data.delivery_errors)
+            ? data.delivery_errors
+            : null,
+    };
+}

package/dist/lib/newsletter/generate-insurance.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Insurance Newsletter Generation — LIFEINSUR (Anchor Point Insurance Co.)
+ *
+ * Thin wrapper around the shared generateNewsletter() orchestrator in generate.ts.
+ * All pipeline logic (NewsAPI fetch, Groq AI, HTML build, Strapi push) lives there;
+ * BRAND_CONFIGS['LIFEINSUR'] already wires up the correct news query, sender email,
+ * brand colors (charcoal #44403E / terracotta #AD7C59 / beige #FCF9F6), and
+ * hasProperties=false so no Excel step runs.
+ *
+ * Ported from: ~/projects/newsletter-automation/generate-newsletter-lifeinsur.py
+ */
+import { type GenerateResult } from './generate.js';
+/** Options accepted by generateInsuranceNewsletter() */
+export interface InsuranceNewsletterOptions {
+    /** ISO date string (YYYY-MM-DD) for the edition date; defaults to today */
+    date?: string;
+    /** When true, skips the Strapi push and returns the generated payload only */
+    dryRun?: boolean;
+}
+/**
+ * Result returned by generateInsuranceNewsletter().
+ * Aliased from GenerateResult for a consistent public API surface;
+ * all fields are identical — import GenerateResult from generate.ts if you
+ * need the underlying type directly.
+ */
+export type NewsletterResult = GenerateResult;
+/**
+ * Generate a LIFEINSUR newsletter for Anchor Point Insurance Co.
+ *
+ * Pipeline steps (delegated to generateNewsletter):
+ *   1. Skip property extraction (LIFEINSUR has no listings)
+ *   2. Fetch life insurance news via NewsAPI
+ *      (query: "life insurance coverage policy florida texas alabama")
+ *   3. Generate market overview + news summaries via Groq (Llama 3.3 70B)
+ *   4. Build branded HTML email with LIFEINSUR color scheme
+ *   5. Push draft to Strapi as brand=LIFEINSUR (unless dryRun=true)
+ *
+ * @example
+ *   const result = await generateInsuranceNewsletter({ dryRun: false })
+ *   console.log(result.strapiDocumentId)
+ */
+export declare function generateInsuranceNewsletter(options?: InsuranceNewsletterOptions): Promise<NewsletterResult>;

package/dist/lib/newsletter/generate-insurance.js

@@ -0,0 +1,36 @@
+/**
+ * Insurance Newsletter Generation — LIFEINSUR (Anchor Point Insurance Co.)
+ *
+ * Thin wrapper around the shared generateNewsletter() orchestrator in generate.ts.
+ * All pipeline logic (NewsAPI fetch, Groq AI, HTML build, Strapi push) lives there;
+ * BRAND_CONFIGS['LIFEINSUR'] already wires up the correct news query, sender email,
+ * brand colors (charcoal #44403E / terracotta #AD7C59 / beige #FCF9F6), and
+ * hasProperties=false so no Excel step runs.
+ *
+ * Ported from: ~/projects/newsletter-automation/generate-newsletter-lifeinsur.py
+ */
+import { generateNewsletter } from './generate.js';
+// ── Orchestrator ──────────────────────────────────────────────────────
+/**
+ * Generate a LIFEINSUR newsletter for Anchor Point Insurance Co.
+ *
+ * Pipeline steps (delegated to generateNewsletter):
+ *   1. Skip property extraction (LIFEINSUR has no listings)
+ *   2. Fetch life insurance news via NewsAPI
+ *      (query: "life insurance coverage policy florida texas alabama")
+ *   3. Generate market overview + news summaries via Groq (Llama 3.3 70B)
+ *   4. Build branded HTML email with LIFEINSUR color scheme
+ *   5. Push draft to Strapi as brand=LIFEINSUR (unless dryRun=true)
+ *
+ * @example
+ *   const result = await generateInsuranceNewsletter({ dryRun: false })
+ *   console.log(result.strapiDocumentId)
+ */
+export async function generateInsuranceNewsletter(options = {}) {
+    return generateNewsletter({
+        brand: 'LIFEINSUR',
+        date: options.date,
+        dryRun: options.dryRun,
+        // No excelPath — LIFEINSUR has no property listings
+    });
+}

package/dist/lib/newsletter/generate.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Newsletter Generation Pipeline
+ *
+ * Ported from Python: ~/projects/newsletter-automation/generate-newsletter-v2.py
+ *
+ * Pipeline: Excel properties -> NewsAPI -> Groq AI -> HTML build -> Strapi push
+ *
+ * Functions:
+ *   fetchNews()             — fetch articles from NewsAPI
+ *   generateAiContent()     — call Groq (OpenAI-compatible) for AI summaries
+ *   readExcelProperties()   — parse columnar Excel (col A = labels, B-N = properties)
+ *   buildPropertyCardHtml() — render a single property card
+ *   buildNewsItemHtml()     — render a single news item
+ *   buildHtml()             — assemble full newsletter HTML
+ *   buildStrapiPayload()    — build the structured Strapi newsletter payload
+ *   generateNewsletter()    — orchestrator that runs the full pipeline
+ */
+export interface Property {
+    name?: string;
+    address?: string;
+    price?: string | number;
+    propertyType?: string;
+    size?: string | number;
+    region?: string;
+    highlights?: string[] | string;
+    imageUrl?: string;
+    listingUrl?: string;
+    contact?: string;
+    notes?: string;
+    analysis?: string;
+    [key: string]: unknown;
+}
+export interface NewsArticle {
+    title: string;
+    source: string;
+    date: string;
+    description: string;
+    url: string;
+}
+export interface AiContent {
+    market_overview: string;
+    property_analyses: Array<{
+        name: string;
+        analysis: string;
+    }>;
+    news_summaries: Array<{
+        title: string;
+        analysis: string;
+    }>;
+}
+export interface NewsletterPayload {
+    data: {
+        title: string;
+        slug: string;
+        brand: string;
+        edition_date: string;
+        subject_line: string;
+        market_overview: string;
+        featured_properties: Property[];
+        news_items: Array<NewsArticle & {
+            analysis?: string;
+        }>;
+        html_body: string;
+        sender_email: string;
+    };
+}
+export interface BrandConfig {
+    brand: string;
+    displayName: string;
+    newsQuery: string;
+    senderEmail: string;
+    contactEmail: string;
+    titlePrefix: string;
+    subjectPrefix: string;
+    /** Whether this brand uses Excel property listings */
+    hasProperties: boolean;
+}
+export interface GenerateOptions {
+    brand: string;
+    date?: string;
+    excelPath?: string;
+    dryRun?: boolean;
+}
+export interface GenerateResult {
+    properties: Property[];
+    newsArticles: NewsArticle[];
+    aiContent: AiContent | null;
+    html: string;
+    payload: NewsletterPayload;
+    strapiDocumentId: string | null;
+}
+export declare function getBrandConfig(brand: string): BrandConfig;
+export declare function fetchNews(query?: string): Promise<NewsArticle[]>;
+export declare function generateAiContent(properties: Property[], newsArticles: NewsArticle[]): Promise<AiContent | null>;
+/**
+ * Read multiple properties from columnar Excel format.
+ * Column A = field labels, Columns B-N = one property per column.
+ *
+ * Uses exceljs (dynamically imported to keep the dependency optional).
+ */
+export declare function readExcelProperties(filePath: string): Promise<Property[]>;
+export declare function buildHtml(properties: Property[], newsArticles: NewsArticle[], aiContent: AiContent | null, brandConfig: BrandConfig): string;
+export declare function buildStrapiPayload(properties: Property[], newsArticles: NewsArticle[], aiContent: AiContent | null, html: string, brandConfig: BrandConfig, editionDate?: string): NewsletterPayload;
+export declare function generateNewsletter(opts: GenerateOptions): Promise<GenerateResult>;