@mailmodo/cli 0.0.56-beta.pr58.107 → 0.0.56-beta.pr58.94

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)}${'Email'.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 ID', 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 };
-}

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

@@ -1,97 +0,0 @@
-import type { ApiResponse } from '../../api-client.js';
-export interface ReportFilters {
-    contactEmails?: string[];
-    emailIds?: string[];
-    events?: string[];
-    sequenceIds?: string[];
-}
-export type ReportTimeRange = {
-    from: string;
-    to: string;
-} | {
-    preset: string;
-};
-export interface ReportPayload {
-    filters?: ReportFilters;
-    groupBy: string;
-    limit?: number;
-    output: string;
-    page?: number;
-    timeRange?: ReportTimeRange;
-}
-export interface ReportGroup {
-    bounceRate: number;
-    bounced: number;
-    clickRate: number;
-    clicked: number;
-    complained: number;
-    delivered: number;
-    key: string;
-    openRate: number;
-    opened: number;
-    sent: number;
-    skipped: number;
-    unsubscribed: number;
-}
-export type ReportTotals = Omit<ReportGroup, 'key'>;
-export interface SummaryResponse {
-    groupBy: string;
-    groups: ReportGroup[];
-    timeRange: {
-        from: string;
-        to: string;
-    };
-    totals: ReportTotals;
-}
-export interface EntryRecord {
-    contact: string;
-    emailId: string;
-    reason?: null | string;
-    sequenceId: string;
-    status: string;
-    timestamp: string;
-}
-export interface EntriesResponse {
-    entries: EntryRecord[];
-    limit: number;
-    page: number;
-    timeRange: {
-        from: string;
-        to: string;
-    };
-    total: number;
-}
-export type TimeseriesPoint = ReportTotals & {
-    ts: string;
-};
-export interface TimeseriesResponse {
-    bucket: string;
-    series: TimeseriesPoint[];
-    timeRange: {
-        from: string;
-        to: string;
-    };
-}
-export type ReportResponse = EntriesResponse | SummaryResponse | TimeseriesResponse;
-export type ReportFlags = {
-    contact?: string[];
-    'email-id'?: string[];
-    event?: string[];
-    from?: string;
-    'group-by': string;
-    limit: number;
-    output: string;
-    page: number;
-    preset?: string;
-    sequence?: string[];
-    to?: string;
-};
-export type ReportCtx = {
-    log(msg?: string): void;
-    onApiError(resp: {
-        error?: string;
-        status: number;
-    }): never;
-    post<T = Record<string, unknown>>(path: string, body?: unknown): Promise<ApiResponse<T>>;
-    spinner<T>(text: string, json: boolean, work: () => Promise<T>): Promise<T>;
-};

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

@@ -1 +0,0 @@
-export {};