optimal-cli 1.0.1 → 1.1.0

package/dist/lib/infra/migrate.js

@@ -1,103 +0,0 @@
-import 'dotenv/config';
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-import { readdir, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-const run = promisify(execFile);
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-/** Hardcoded project directories — these live on Carlos's machine. */
-const PROJECT_DIRS = {
-    returnpro: '/home/optimal/dashboard-returnpro',
-    optimalos: '/home/optimal/optimalos',
-};
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-function getProjectDir(target) {
-    return PROJECT_DIRS[target];
-}
-function migrationsDir(target) {
-    return join(getProjectDir(target), 'supabase', 'migrations');
-}
-/**
- * Generate a timestamp string in YYYYMMDDHHMMSS format (UTC).
- */
-function timestamp() {
-    const now = new Date();
-    const pad = (n, len = 2) => String(n).padStart(len, '0');
-    return [
-        now.getUTCFullYear(),
-        pad(now.getUTCMonth() + 1),
-        pad(now.getUTCDate()),
-        pad(now.getUTCHours()),
-        pad(now.getUTCMinutes()),
-        pad(now.getUTCSeconds()),
-    ].join('');
-}
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Run `supabase db push --linked` (or `--dry-run` if requested) against the
- * given target project directory.
- *
- * Uses `execFile` (not `exec`) to avoid shell injection.
- * The `cwd` option switches the Supabase CLI into the correct project.
- */
-export async function migrateDb(opts) {
-    const { target, dryRun = false } = opts;
-    const projectDir = getProjectDir(target);
-    const args = ['db', 'push', '--linked'];
-    if (dryRun)
-        args.push('--dry-run');
-    try {
-        const { stdout, stderr } = await run('supabase', args, {
-            cwd: projectDir,
-            timeout: 120_000,
-        });
-        return {
-            success: true,
-            target,
-            output: stdout.trim(),
-            errors: stderr.trim(),
-        };
-    }
-    catch (err) {
-        const e = err;
-        return {
-            success: false,
-            target,
-            output: (e.stdout ?? '').trim(),
-            errors: (e.stderr ?? e.message ?? String(err)).trim(),
-        };
-    }
-}
-/**
- * List migration `.sql` files in the target's `supabase/migrations/` directory,
- * sorted chronologically (by filename, which starts with a YYYYMMDDHHMMSS prefix).
- *
- * Returns only filenames, not full paths.
- */
-export async function listPendingMigrations(target) {
-    const dir = migrationsDir(target);
-    const entries = await readdir(dir);
-    return entries
-        .filter((f) => f.endsWith('.sql'))
-        .sort(); // lexicographic == chronological given the YYYYMMDDHHMMSS prefix
-}
-/**
- * Create a new empty migration file in the target's `supabase/migrations/`
- * directory.
- *
- * The filename format is `{YYYYMMDDHHMMSS}_{name}.sql` (UTC timestamp).
- * Returns the full absolute path of the created file.
- */
-export async function createMigration(target, name) {
-    const sanitized = name.replace(/\s+/g, '_').replace(/[^a-zA-Z0-9_]/g, '');
-    const filename = `${timestamp()}_${sanitized}.sql`;
-    const fullPath = join(migrationsDir(target), filename);
-    await writeFile(fullPath, `-- Migration: ${sanitized}\n-- Target: ${target}\n-- Created: ${new Date().toISOString()}\n\n`, { encoding: 'utf8' });
-    return fullPath;
-}

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

@@ -1,52 +0,0 @@
-/**
- * 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

@@ -1,193 +0,0 @@
-/**
- * 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.js

@@ -1,36 +0,0 @@
-/**
- * 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

@@ -1,104 +0,0 @@
-/**
- * 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>;