@sendblue/cli 0.5.1 → 0.6.0

package/dist/commands/messages.d.ts

@@ -0,0 +1,6 @@
+export declare function messagesCommand(opts: {
+    number?: string;
+    limit?: string;
+    outbound?: boolean;
+    inbound?: boolean;
+}): Promise<void>;

package/dist/commands/messages.js

@@ -0,0 +1,66 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { getMessages } from '../lib/api.js';
+import { formatPhoneNumber, normalizeNumber, printError } from '../lib/format.js';
+export async function messagesCommand(opts) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Fetching messages...', indent: 2 }).start();
+    try {
+        const isOutbound = opts.outbound ? true : opts.inbound ? false : undefined;
+        const number = opts.number ? normalizeNumber(opts.number) : undefined;
+        const limit = Math.min(parseInt(opts.limit || '10', 10) || 10, 100);
+        const result = await getMessages(creds.apiKey, creds.apiSecret, {
+            number,
+            limit,
+            isOutbound
+        });
+        spinner.stop();
+        console.log();
+        if (result.data.length === 0) {
+            console.log(chalk.dim('  No messages found.'));
+            console.log();
+            return;
+        }
+        console.log(chalk.bold(`  Messages`) + chalk.dim(` (${result.data.length} of ${result.pagination.total})`));
+        console.log();
+        for (const msg of result.data) {
+            const direction = msg.is_outbound
+                ? chalk.cyan('OUT')
+                : chalk.green(' IN');
+            const otherNumber = msg.is_outbound ? msg.to_number : msg.from_number;
+            const formatted = otherNumber && typeof otherNumber === 'string' ? formatPhoneNumber(otherNumber) : '?';
+            const date = new Date(msg.date_sent);
+            const timestamp = date.toLocaleString('en-US', {
+                month: 'short',
+                day: 'numeric',
+                hour: 'numeric',
+                minute: '2-digit',
+                hour12: true
+            });
+            const status = msg.status === 'SENT' || msg.status === 'DELIVERED'
+                ? ''
+                : ` ${chalk.yellow(`[${msg.status}]`)}`;
+            const content = msg.content
+                ? msg.content.length > 80
+                    ? msg.content.slice(0, 77) + '...'
+                    : msg.content
+                : chalk.dim('(media)');
+            console.log(`  ${direction} ${chalk.dim(timestamp)}  ${chalk.bold(formatted)}${status}`);
+            console.log(`     ${content}`);
+            console.log();
+        }
+        if (result.pagination.hasMore) {
+            console.log(chalk.dim(`  Showing ${result.data.length} of ${result.pagination.total}. Use --limit to see more.`));
+            console.log();
+        }
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/index.js

@@ -4,15 +4,17 @@ import { Command } from 'commander';
 import { setupCommand } from './commands/setup.js';
 import { loginCommand } from './commands/login.js';
 import { sendCommand } from './commands/send.js';
+import { messagesCommand } from './commands/messages.js';
 import { statusCommand } from './commands/status.js';
 import { whoamiCommand } from './commands/whoami.js';
 import { addContactCommand, contactsCommand } from './commands/add-contact.js';
+import { getLogo } from './lib/format.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 const program = new Command();
 program
     .name('sendblue')
-    .description('Sendblue CLI — iMessage numbers for agents')
+    .description(getLogo())
     .version(version);
 program
     .command('setup')
@@ -37,6 +39,14 @@ program
     .argument('<number>', 'Recipient phone number (E.164 format)')
     .argument('<message>', 'Message content')
     .action(sendCommand);
+program
+    .command('messages')
+    .description('View recent messages')
+    .option('-n, --number <number>', 'Filter by contact phone number')
+    .option('-l, --limit <count>', 'Number of messages to show', '10')
+    .option('--outbound', 'Show only outbound messages')
+    .option('--inbound', 'Show only inbound messages')
+    .action(messagesCommand);
 program
     .command('status')
     .description('Check your account status')

package/dist/lib/api.d.ts

@@ -37,5 +37,35 @@ interface SharedContactsResponse {
 }
 export declare function addContact(apiKey: string, apiSecret: string, recipient: string): Promise<ContactRoute>;
 export declare function getSharedContacts(apiKey: string, apiSecret: string): Promise<SharedContactsResponse>;
+export interface Message {
+    content: string;
+    number: string;
+    from_number: string;
+    to_number: string;
+    is_outbound: boolean;
+    status: string;
+    date_sent: string;
+    date_updated: string;
+    sendblue_number: string;
+    media_url?: string;
+    message_handle: string;
+    row_id: string;
+    [key: string]: unknown;
+}
+interface MessagesResponse {
+    status: string;
+    data: Message[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
+}
+export declare function getMessages(apiKey: string, apiSecret: string, opts: {
+    number?: string;
+    limit?: number;
+    isOutbound?: boolean;
+}): Promise<MessagesResponse>;
 export declare function testKeys(apiKey: string, apiSecret: string): Promise<boolean>;
 export {};

package/dist/lib/api.js

@@ -99,6 +99,28 @@ export async function getSharedContacts(apiKey, apiSecret) {
     }
     return res.json();
 }
+export async function getMessages(apiKey, apiSecret, opts) {
+    const params = new URLSearchParams();
+    params.set('limit', String(opts.limit || 10));
+    params.set('order_by', 'createdAt');
+    params.set('order_direction', 'desc');
+    if (opts.number)
+        params.set('number', opts.number);
+    if (opts.isOutbound !== undefined)
+        params.set('is_outbound', String(opts.isOutbound));
+    const res = await fetch(`${API_BASE}/api/v2/messages?${params}`, {
+        method: 'GET',
+        headers: {
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        }
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to get messages (${res.status})`);
+    }
+    return res.json();
+}
 export async function testKeys(apiKey, apiSecret) {
     try {
         const res = await fetch(`${API_BASE}/account`, {

package/dist/lib/format.d.ts

@@ -1,4 +1,5 @@
 export declare function printLogo(): void;
+export declare function getLogo(): string;
 export declare function normalizeNumber(input: string): string;
 export declare function formatPhoneNumber(e164: string): string;
 export declare function printSuccess(message: string): void;

package/dist/lib/format.js

@@ -1,16 +1,21 @@
 import chalk from 'chalk';
 const blue = chalk.hex('#0088FF');
 export function printLogo() {
+    // Cloud/bubble shape with small circle top-right, matching Sendblue logo
+    const b = blue('█');
+    const h = blue('▀');
+    const l = blue('▄');
     const logo = [
-        `        ${blue('██')}    `,
-        `      ${blue('██████')}  `,
-        `   ${blue('██████████')} `,
-        `  ${blue('████████████')}`,
-        ` ${blue('██████████████')}`,
-        ` ${blue('██████████████')}`,
-        `  ${blue('████████████')}`,
-        `   ${blue('██████████')} `,
-        `    ${blue('████████')}  `,
+        `              ${l}${l}${l}  `,
+        `      ${l}${l}${l}${l}    ${b}${b}${b}  `,
+        `    ${l}${b}${b}${b}${b}${b}${l}  ${h}${h}${h}  `,
+        `  ${l}${b}${b}${b}${b}${b}${b}${b}${b}${l}     `,
+        `  ${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${l}    `,
+        `  ${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${l}   `,
+        `  ${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}   `,
+        `  ${h}${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${h}   `,
+        `   ${h}${b}${b}${b}${b}${b}${b}${b}${b}${h}    `,
+        `    ${h}${h}${h}${h}${h}${h}${h}      `,
     ];
     for (const line of logo) {
         console.log(`  ${line}`);
@@ -20,6 +25,27 @@ export function printLogo() {
     console.log(chalk.dim('    iMessage for agents'));
     console.log();
 }
+export function getLogo() {
+    const b = blue('█');
+    const h = blue('▀');
+    const l = blue('▄');
+    const lines = [
+        `              ${l}${l}${l}  `,
+        `      ${l}${l}${l}${l}    ${b}${b}${b}  `,
+        `    ${l}${b}${b}${b}${b}${b}${l}  ${h}${h}${h}  `,
+        `  ${l}${b}${b}${b}${b}${b}${b}${b}${b}${l}     `,
+        `  ${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${l}    `,
+        `  ${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${l}   `,
+        `  ${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}   `,
+        `  ${h}${b}${b}${b}${b}${b}${b}${b}${b}${b}${b}${h}   `,
+        `   ${h}${b}${b}${b}${b}${b}${b}${b}${b}${h}    `,
+        `    ${h}${h}${h}${h}${h}${h}${h}      `,
+        ``,
+        blue.bold('    sendblue'),
+        chalk.dim('    iMessage for agents'),
+    ];
+    return '\n' + lines.map(l => `  ${l}`).join('\n') + '\n';
+}
 export function normalizeNumber(input) {
     // Strip non-digit chars except leading +
     let num = input.replace(/[^\d+]/g, '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendblue/cli",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Sendblue CLI — iMessage numbers for agents",
   "type": "module",
   "bin": {