@mailmodo/cli 0.0.56-beta.pr58.108 → 0.0.56-beta.pr58.95

package/oclif.manifest.json

@@ -631,173 +631,6 @@
         "index.js"
       ]
     },
-    "report": {
-      "aliases": [],
-      "args": {},
-      "description": "Fetch an email analytics report",
-      "examples": [
-        "<%= config.bin %> report --preset last7d",
-        "<%= config.bin %> report --preset last30d --group-by emailId",
-        "<%= config.bin %> report --from YYYY-MM-DD --to YYYY-MM-DD --output timeseries",
-        "<%= config.bin %> report --preset last7d --output entries --page 1",
-        "<%= config.bin %> report --preset last30d --sequence welcome-flow --event opened",
-        "<%= config.bin %> report --preset last7d --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Output as JSON",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "contact": {
-          "description": "Filter by contact email (repeatable)",
-          "name": "contact",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "email-id": {
-          "description": "Filter by email template ID (repeatable)",
-          "name": "email-id",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "event": {
-          "description": "Filter by event type (repeatable)",
-          "name": "event",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "bounced",
-            "clicked",
-            "complained",
-            "delivered",
-            "opened",
-            "sent",
-            "skipped",
-            "unsubscribed"
-          ],
-          "type": "option"
-        },
-        "from": {
-          "description": "Start of time range, inclusive (YYYY-MM-DD)",
-          "exclusive": [
-            "preset"
-          ],
-          "name": "from",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "group-by": {
-          "description": "Group results by dimension",
-          "name": "group-by",
-          "default": "none",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "contact",
-            "day",
-            "emailId",
-            "hour",
-            "none",
-            "sequenceId",
-            "status"
-          ],
-          "type": "option"
-        },
-        "limit": {
-          "description": "Entries per page, max 200 (entries output only)",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output": {
-          "description": "Output shape: summary | entries | timeseries",
-          "name": "output",
-          "default": "summary",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "entries",
-            "summary",
-            "timeseries"
-          ],
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number (entries output only)",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "preset": {
-          "description": "Relative time range preset",
-          "exclusive": [
-            "from",
-            "to"
-          ],
-          "name": "preset",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "last30d",
-            "last7d",
-            "last90d",
-            "lastMonth",
-            "thisMonth",
-            "today",
-            "yesterday"
-          ],
-          "type": "option"
-        },
-        "sequence": {
-          "description": "Filter by sequence ID (repeatable)",
-          "name": "sequence",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "to": {
-          "description": "End of time range, exclusive (YYYY-MM-DD)",
-          "exclusive": [
-            "preset"
-          ],
-          "name": "to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "report",
-      "pluginAlias": "@mailmodo/cli",
-      "pluginName": "@mailmodo/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "report",
-        "index.js"
-      ]
-    },
     "sdk": {
       "aliases": [],
       "args": {},
@@ -932,5 +765,5 @@
       ]
     }
   },
-  "version": "0.0.56-beta.pr58.108"
+  "version": "0.0.56-beta.pr58.95"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailmodo/cli",
   "description": "Email lifecycle automation for the AI-native builder generation.",
-  "version": "0.0.56-beta.pr58.108",
+  "version": "0.0.56-beta.pr58.95",
   "author": "provishalk",
   "bin": {
     "mailmodo": "bin/run.js"

package/dist/commands/report/index.d.ts

@@ -1,22 +0,0 @@
-import { BaseCommand } from '../../lib/base-command.js';
-export default class Report extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        contact: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'email-id': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        event: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'group-by': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        preset: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        sequence: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-    private makeCtx;
-}

package/dist/commands/report/index.js

@@ -1,123 +0,0 @@
-import { Flags } from '@oclif/core';
-import { BaseCommand } from '../../lib/base-command.js';
-import { API_ENDPOINTS } from '../../lib/constants.js';
-import { REPORTS } from '../../lib/messages.js';
-import { buildReportPayload } from '../../lib/commands/report/payload.js';
-import { renderReport } from '../../lib/commands/report/output.js';
-import { promptReportFlags } from '../../lib/commands/report/prompt.js';
-export default class Report extends BaseCommand {
-    static description = 'Fetch an email analytics report';
-    static examples = [
-        '<%= config.bin %> report --preset last7d',
-        '<%= config.bin %> report --preset last30d --group-by emailId',
-        '<%= config.bin %> report --from YYYY-MM-DD --to YYYY-MM-DD --output timeseries',
-        '<%= config.bin %> report --preset last7d --output entries --page 1',
-        '<%= config.bin %> report --preset last30d --sequence welcome-flow --event opened',
-        '<%= config.bin %> report --preset last7d --json',
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        contact: Flags.string({
-            description: 'Filter by contact email (repeatable)',
-            multiple: true,
-        }),
-        'email-id': Flags.string({
-            description: 'Filter by email template ID (repeatable)',
-            multiple: true,
-        }),
-        event: Flags.string({
-            description: 'Filter by event type (repeatable)',
-            multiple: true,
-            options: [
-                'bounced',
-                'clicked',
-                'complained',
-                'delivered',
-                'opened',
-                'sent',
-                'skipped',
-                'unsubscribed',
-            ],
-        }),
-        from: Flags.string({
-            description: 'Start of time range, inclusive (YYYY-MM-DD)',
-            exclusive: ['preset'],
-        }),
-        'group-by': Flags.string({
-            default: 'none',
-            description: 'Group results by dimension',
-            options: [
-                'contact',
-                'day',
-                'emailId',
-                'hour',
-                'none',
-                'sequenceId',
-                'status',
-            ],
-        }),
-        limit: Flags.integer({
-            default: 50,
-            description: 'Entries per page, max 200 (entries output only)',
-            max: 200,
-        }),
-        output: Flags.string({
-            default: 'summary',
-            description: 'Output shape: summary | entries | timeseries',
-            options: ['entries', 'summary', 'timeseries'],
-        }),
-        page: Flags.integer({
-            default: 1,
-            description: 'Page number (entries output only)',
-        }),
-        preset: Flags.string({
-            description: 'Relative time range preset',
-            exclusive: ['from', 'to'],
-            options: [
-                'last30d',
-                'last7d',
-                'last90d',
-                'lastMonth',
-                'thisMonth',
-                'today',
-                'yesterday',
-            ],
-        }),
-        sequence: Flags.string({
-            description: 'Filter by sequence ID (repeatable)',
-            multiple: true,
-        }),
-        to: Flags.string({
-            description: 'End of time range, exclusive (YYYY-MM-DD)',
-            exclusive: ['preset'],
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(Report);
-        await this.ensureAuth();
-        if ((flags.from && !flags.to) || (!flags.from && flags.to)) {
-            this.error(REPORTS.FROM_TO_REQUIRED);
-        }
-        const resolved = flags.json
-            ? flags
-            : await promptReportFlags(flags);
-        const ctx = this.makeCtx();
-        const payload = buildReportPayload(resolved, (m) => this.error(m));
-        const response = await ctx.spinner(REPORTS.FETCH_SPINNER, flags.json, () => ctx.post(API_ENDPOINTS.REPORTS, payload));
-        if (!response.ok)
-            ctx.onApiError(response);
-        if (flags.json) {
-            this.log(JSON.stringify(response.data, null, 2));
-            return;
-        }
-        renderReport(ctx, response.data, resolved.output);
-    }
-    makeCtx() {
-        return {
-            log: (msg) => this.log(msg),
-            onApiError: (r) => this.handleApiError(r),
-            post: (path, body) => this.apiClient.post(path, body),
-            spinner: (text, json, work) => this.withApiSpinner({ json, text }, work),
-        };
-    }
-}

package/dist/lib/commands/report/output-entries.d.ts

@@ -1,2 +0,0 @@
-import type { EntriesResponse, ReportCtx } from './types.js';
-export declare function renderEntries(ctx: ReportCtx, data: EntriesResponse): void;

package/dist/lib/commands/report/output-entries.js

@@ -1,59 +0,0 @@
-import chalk from 'chalk';
-const TIME_W = 18;
-const EMAIL_W = 24;
-const SEQ_W = 12;
-const STATUS_W = 14;
-const CONTACT_COL = TIME_W + EMAIL_W + SEQ_W + STATUS_W;
-function statusColor(status) {
-    switch (status) {
-        case 'bounced':
-        case 'complained': {
-            return chalk.red;
-        }
-        case 'clicked':
-        case 'delivered':
-        case 'opened':
-        case 'sent': {
-            return chalk.green;
-        }
-        case 'skipped': {
-            return chalk.yellow;
-        }
-        default: {
-            return chalk.white;
-        }
-    }
-}
-function truncate(s, width) {
-    return s.length > width ? s.slice(0, width - 1) + '…' : s;
-}
-function shortSeq(id) {
-    return id.length > 8 ? id.slice(0, 8) + '…' : id;
-}
-export function renderEntries(ctx, data) {
-    const { entries, limit, page, total } = data;
-    ctx.log(`\n  ${'Time'.padEnd(TIME_W)}${'Template'.padEnd(EMAIL_W)}` +
-        `${'Sequence'.padEnd(SEQ_W)}${'Status'.padEnd(STATUS_W)}Contact`);
-    ctx.log(`  ${'─'.repeat(CONTACT_COL + 28)}`);
-    if (!entries?.length) {
-        ctx.log(`  ${chalk.dim('No entries found.')}`);
-        ctx.log('');
-        return;
-    }
-    for (const entry of entries) {
-        const time = (entry.timestamp || '').padEnd(TIME_W);
-        const email = truncate(entry.emailId || '', EMAIL_W - 2).padEnd(EMAIL_W);
-        const seq = chalk.dim(shortSeq(entry.sequenceId || '').padEnd(SEQ_W));
-        const status = statusColor(entry.status)((entry.status || '').padEnd(STATUS_W));
-        ctx.log(`  ${time}${email}${seq}${status}${entry.contact || ''}`);
-        if (entry.reason) {
-            const label = entry.status === 'skipped' ? 'condition not met' : 'reason';
-            ctx.log(`  ${' '.repeat(CONTACT_COL)}${chalk.dim(`└ ${label}: ${entry.reason}`)}`);
-        }
-    }
-    const totalPages = Math.ceil(total / limit);
-    ctx.log(`\n  Page ${page} of ${totalPages}  ·  ${total} total entries`);
-    if (page < totalPages)
-        ctx.log(`  ${chalk.dim(`Next: --page ${page + 1}`)}`);
-    ctx.log('');
-}

package/dist/lib/commands/report/output-timeseries.d.ts

@@ -1,2 +0,0 @@
-import type { ReportCtx, TimeseriesResponse } from './types.js';
-export declare function renderTimeseries(ctx: ReportCtx, data: TimeseriesResponse): void;

package/dist/lib/commands/report/output-timeseries.js

@@ -1,28 +0,0 @@
-import chalk from 'chalk';
-function fmtRate(n) {
-    return (n * 100).toFixed(1) + '%';
-}
-export function renderTimeseries(ctx, data) {
-    const { bucket, series, timeRange } = data;
-    const from = timeRange.from.slice(0, 10);
-    const to = timeRange.to.slice(0, 10);
-    ctx.log(`\n  ${chalk.dim(`Bucket: ${bucket}  (${from} → ${to})`)}`);
-    ctx.log(`\n  ${'Time'.padEnd(22)}${'Sent'.padEnd(7)}${'Delivered'.padEnd(11)}${'Opened'.padEnd(8)}${'Clicked'.padEnd(9)}${'OpenRate'.padEnd(10)}${'ClickRate'.padEnd(10)}BounceRate`);
-    ctx.log(`  ${'─'.repeat(87)}`);
-    if (!series?.length) {
-        ctx.log(`  ${chalk.dim('No timeseries data.')}`);
-        ctx.log('');
-        return;
-    }
-    for (const point of series) {
-        ctx.log(`  ${(point.ts || '').padEnd(22)}` +
-            `${String(point.sent).padEnd(7)}` +
-            `${String(point.delivered).padEnd(11)}` +
-            `${String(point.opened).padEnd(8)}` +
-            `${String(point.clicked).padEnd(9)}` +
-            `${fmtRate(point.openRate).padEnd(10)}` +
-            `${fmtRate(point.clickRate).padEnd(10)}` +
-            `${fmtRate(point.bounceRate)}`);
-    }
-    ctx.log('');
-}

package/dist/lib/commands/report/output.d.ts

@@ -1,3 +0,0 @@
-import type { ReportCtx, ReportResponse, SummaryResponse } from './types.js';
-export declare function renderSummary(ctx: ReportCtx, data: SummaryResponse): void;
-export declare function renderReport(ctx: ReportCtx, data: ReportResponse, mode: string): void;

package/dist/lib/commands/report/output.js

@@ -1,56 +0,0 @@
-import chalk from 'chalk';
-import { renderEntries } from './output-entries.js';
-import { renderTimeseries } from './output-timeseries.js';
-function fmtRate(n) {
-    return (n * 100).toFixed(1) + '%';
-}
-function statsColumns(s) {
-    return [
-        String(s.sent).padEnd(7),
-        String(s.delivered).padEnd(11),
-        String(s.opened).padEnd(8),
-        String(s.clicked).padEnd(9),
-        String(s.bounced).padEnd(9),
-        fmtRate(s.openRate).padEnd(10),
-        fmtRate(s.clickRate).padEnd(10),
-        fmtRate(s.bounceRate),
-    ].join('');
-}
-function renderGroupedTable(ctx, data) {
-    ctx.log(`\n  ${'Key'.padEnd(20)}${'Sent'.padEnd(7)}${'Delivered'.padEnd(11)}` +
-        `${'Opened'.padEnd(8)}${'Clicked'.padEnd(9)}${'Bounced'.padEnd(9)}` +
-        `${'OpenRate'.padEnd(10)}${'ClickRate'.padEnd(10)}BounceRate`);
-    ctx.log(`  ${'─'.repeat(93)}`);
-    for (const g of data.groups) {
-        const key = g.key.slice(0, 19).padEnd(20);
-        ctx.log(`  ${key}${statsColumns(g)}`);
-    }
-    ctx.log(`  ${'─'.repeat(93)}`);
-    ctx.log(`  ${chalk.bold('TOTAL'.padEnd(20))}${statsColumns(data.totals)}`);
-}
-function renderTotalsOnly(ctx, data) {
-    const t = data.totals;
-    ctx.log(`\n  Sent: ${t.sent}   Delivered: ${t.delivered}   Opened: ${t.opened}` +
-        `   Clicked: ${t.clicked}   Bounced: ${t.bounced}`);
-    ctx.log(`  Open rate: ${fmtRate(t.openRate)}   Click rate: ${fmtRate(t.clickRate)}` +
-        `   Bounce rate: ${fmtRate(t.bounceRate)}`);
-}
-export function renderSummary(ctx, data) {
-    const { from, to } = data.timeRange;
-    ctx.log(`\n  ${chalk.dim(`${from.slice(0, 10)} → ${to.slice(0, 10)}`)}`);
-    if (data.groups.length > 0) {
-        renderGroupedTable(ctx, data);
-    }
-    else {
-        renderTotalsOnly(ctx, data);
-    }
-    ctx.log('');
-}
-export function renderReport(ctx, data, mode) {
-    if (mode === 'entries')
-        renderEntries(ctx, data);
-    else if (mode === 'timeseries')
-        renderTimeseries(ctx, data);
-    else
-        renderSummary(ctx, data);
-}

package/dist/lib/commands/report/payload.d.ts

@@ -1,2 +0,0 @@
-import type { ReportFlags, ReportPayload } from './types.js';
-export declare function buildReportPayload(flags: ReportFlags, onError: (m: string) => never): ReportPayload;

package/dist/lib/commands/report/payload.js

@@ -1,49 +0,0 @@
-import { REPORTS } from '../../messages.js';
-function buildTimeRange(flags) {
-    if (flags.preset)
-        return { preset: flags.preset };
-    if (flags.from && flags.to)
-        return { from: flags.from, to: flags.to };
-    return undefined;
-}
-function buildFilters(flags) {
-    const f = {};
-    if (flags.sequence?.length)
-        f.sequenceIds = flags.sequence;
-    if (flags['email-id']?.length)
-        f.emailIds = flags['email-id'];
-    if (flags.contact?.length)
-        f.contactEmails = flags.contact;
-    if (flags.event?.length)
-        f.events = flags.event;
-    return Object.keys(f).length > 0 ? f : undefined;
-}
-function validateFilterSizes(flags, onError) {
-    const arrays = [
-        flags.sequence,
-        flags['email-id'],
-        flags.contact,
-        flags.event,
-    ];
-    if (arrays.some((a) => a && a.length > 100))
-        onError(REPORTS.TOO_MANY_ITEMS);
-}
-export function buildReportPayload(flags, onError) {
-    validateFilterSizes(flags, onError);
-    const timeRange = buildTimeRange(flags);
-    if (!timeRange)
-        onError(REPORTS.TIME_RANGE_REQUIRED);
-    const payload = {
-        groupBy: flags['group-by'],
-        output: flags.output,
-        timeRange,
-    };
-    const filters = buildFilters(flags);
-    if (filters)
-        payload.filters = filters;
-    if (flags.output === 'entries') {
-        payload.page = flags.page;
-        payload.limit = flags.limit;
-    }
-    return payload;
-}

package/dist/lib/commands/report/prompt.d.ts

@@ -1,2 +0,0 @@
-import type { ReportFlags } from './types.js';
-export declare function promptReportFlags(flags: ReportFlags): Promise<ReportFlags>;

package/dist/lib/commands/report/prompt.js

@@ -1,82 +0,0 @@
-import { input, select } from '@inquirer/prompts';
-const PRESET_CHOICES = [
-    { name: 'Today', value: 'today' },
-    { name: 'Yesterday', value: 'yesterday' },
-    { name: 'Last 7 days', value: 'last7d' },
-    { name: 'Last 30 days', value: 'last30d' },
-    { name: 'Last 90 days', value: 'last90d' },
-    { name: 'This month', value: 'thisMonth' },
-    { name: 'Last month', value: 'lastMonth' },
-];
-const OUTPUT_CHOICES = [
-    { name: 'Summary — grouped aggregates', value: 'summary' },
-    { name: 'Entries — paginated event log', value: 'entries' },
-    { name: 'Timeseries — bucketed over time', value: 'timeseries' },
-];
-const GROUP_BY_CHOICES = [
-    { name: 'None (totals only)', value: 'none' },
-    { name: 'Email template', value: 'emailId' },
-    { name: 'Sequence ID', value: 'sequenceId' },
-    { name: 'Day', value: 'day' },
-    { name: 'Hour', value: 'hour' },
-    { name: 'Contact', value: 'contact' },
-    { name: 'Status', value: 'status' },
-];
-function isValidIsoDate(value) {
-    if (!value?.trim())
-        return 'Date is required';
-    if (Number.isNaN(new Date(value).getTime()))
-        return 'Enter a valid date in YYYY-MM-DD format';
-    return true;
-}
-async function promptTimeRange() {
-    const usePreset = await select({
-        choices: [
-            { name: 'Use a preset  (today, last7d, last30d…)', value: true },
-            { name: 'Enter a custom date range', value: false },
-        ],
-        message: 'Time range:',
-    });
-    if (usePreset) {
-        const preset = await select({
-            choices: PRESET_CHOICES,
-            message: 'Preset:',
-        });
-        return { preset };
-    }
-    const from = await input({
-        message: 'Start date (YYYY-MM-DD):',
-        validate: isValidIsoDate,
-    });
-    const to = await input({
-        message: 'End date, exclusive (YYYY-MM-DD):',
-        validate(v) {
-            const check = isValidIsoDate(v);
-            if (check !== true)
-                return check;
-            if (new Date(v) <= new Date(from))
-                return 'End date must be after start date';
-            return true;
-        },
-    });
-    return { from, to };
-}
-export async function promptReportFlags(flags) {
-    const hasTimeRange = Boolean(flags.preset || (flags.from && flags.to));
-    if (hasTimeRange)
-        return flags;
-    const timeRange = await promptTimeRange();
-    const output = await select({
-        choices: OUTPUT_CHOICES,
-        default: flags.output,
-        message: 'Output mode:',
-    });
-    const groupBy = output === 'summary'
-        ? await select({
-            choices: GROUP_BY_CHOICES,
-            default: flags['group-by'],
-            message: 'Group by:',
-        })
-        : 'none';
-    return { ...flags, ...timeRange, 'group-by': groupBy, output };
-}