@sendblue/cli 0.6.2 → 0.7.0

package/README.md

@@ -0,0 +1,105 @@
+# Sendblue CLI
+
+iMessage numbers for AI agents. Set up an iMessage-enabled phone number and start sending messages in under a minute.
+
+## Install
+
+```bash
+npm install -g @sendblue/cli
+```
+
+Requires Node.js 18+.
+
+## Quick Start
+
+```bash
+# Create an account and get an iMessage number
+sendblue setup
+
+# Send a message
+sendblue send +15551234567 'Hello from Sendblue!'
+```
+
+## Commands
+
+### `sendblue setup`
+
+Create a new Sendblue account. Walks you through email verification, company name, and adding your first contact.
+
+```bash
+# Interactive (recommended for first time)
+sendblue setup
+
+# Non-interactive (for CI/scripts)
+sendblue setup --email you@example.com                          # sends verification code, exits
+sendblue setup --email you@example.com --code 12345678 --company my-co --contact +15551234567
+```
+
+| Flag | Description |
+|------|-------------|
+| `--email <email>` | Email address |
+| `--code <code>` | 8-digit verification code |
+| `--company <name>` | Company name (lowercase, hyphens/underscores, 3-64 chars) |
+| `--contact <number>` | First contact phone number (E.164 format) |
+
+### `sendblue login`
+
+Log in to an existing account.
+
+```bash
+sendblue login
+```
+
+### `sendblue send <number> <message>`
+
+Send an iMessage.
+
+```bash
+sendblue send +15551234567 'Hey, your order shipped!'
+```
+
+### `sendblue messages`
+
+View recent messages.
+
+```bash
+sendblue messages
+sendblue messages -n +15551234567 --limit 20
+sendblue messages --inbound
+```
+
+| Flag | Description |
+|------|-------------|
+| `-n, --number <number>` | Filter by contact |
+| `-l, --limit <count>` | Number of messages (default: 10) |
+| `--outbound` | Show only sent messages |
+| `--inbound` | Show only received messages |
+
+### `sendblue add-contact <number>`
+
+Add a contact to your account.
+
+```bash
+sendblue add-contact +15551234567
+```
+
+### `sendblue contacts`
+
+List all contacts and their verification status.
+
+### `sendblue status`
+
+Check your account status and plan.
+
+### `sendblue whoami`
+
+Show current credentials and verify they're valid.
+
+## Credentials
+
+Credentials are stored in `~/.sendblue/credentials.json` with `600` permissions (owner read/write only). Run `sendblue whoami` to see the current config path.
+
+## Links
+
+- [Sendblue](https://sendblue.co)
+- [API Docs](https://docs.sendblue.co)

package/dist/commands/lines.d.ts

@@ -0,0 +1 @@
+export declare function linesCommand(): Promise<void>;

package/dist/commands/lines.js

@@ -0,0 +1,35 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { getLines } from '../lib/api.js';
+import { formatPhoneNumber, printError } from '../lib/format.js';
+export async function linesCommand() {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Fetching lines...', indent: 2 }).start();
+    try {
+        const result = await getLines(creds.apiKey, creds.apiSecret);
+        spinner.stop();
+        console.log();
+        console.log(chalk.bold('  Phone Lines'));
+        console.log();
+        if (!result.numbers || result.numbers.length === 0) {
+            console.log(chalk.dim('  No lines assigned yet.'));
+        }
+        else {
+            for (const number of result.numbers) {
+                console.log(`  ${formatPhoneNumber(number)}`);
+            }
+            console.log();
+            console.log(chalk.dim(`  ${result.numbers.length} line${result.numbers.length === 1 ? '' : 's'} total`));
+        }
+        console.log();
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/send-group.d.ts

@@ -0,0 +1,5 @@
+interface SendGroupOptions {
+    media?: string;
+}
+export declare function sendGroupCommand(numbers: string[], opts: SendGroupOptions): Promise<void>;
+export {};

package/dist/commands/send-group.js

@@ -0,0 +1,33 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { sendGroupMessage } from '../lib/api.js';
+import { normalizeNumber, formatPhoneNumber, printError } from '../lib/format.js';
+export async function sendGroupCommand(numbers, opts) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    // Last argument is the message, rest are numbers
+    if (numbers.length < 3) {
+        printError('Usage: sendblue send-group <number1> <number2> [number3...] <message>');
+        printError('At least 2 phone numbers and a message are required.');
+        process.exit(1);
+    }
+    const message = numbers[numbers.length - 1];
+    const phoneNumbers = numbers.slice(0, -1).map(normalizeNumber);
+    const spinner = ora({ text: `Sending group message to ${phoneNumbers.length} recipients...`, indent: 2 }).start();
+    try {
+        const result = await sendGroupMessage(creds.apiKey, creds.apiSecret, phoneNumbers, message, creds.assignedNumber, opts.media);
+        spinner.succeed(`Group message sent to ${phoneNumbers.length} recipients`);
+        console.log(chalk.dim(`  Recipients: ${phoneNumbers.map(formatPhoneNumber).join(', ')}`));
+        if (result.messageId) {
+            console.log(chalk.dim(`  Message ID: ${result.messageId}`));
+        }
+    }
+    catch (err) {
+        spinner.fail(`Send failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/send.d.ts

@@ -1 +1,5 @@
-export declare function sendCommand(number: string, message: string): Promise<void>;
+interface SendOptions {
+    media?: string;
+}
+export declare function sendCommand(number: string, message: string, opts: SendOptions): Promise<void>;
+export {};

package/dist/commands/send.js

@@ -2,9 +2,8 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { getCredentials } from '../lib/config.js';
 import { sendMessage } from '../lib/api.js';
-import { normalizeNumber } from '../lib/format.js';
-import { printError } from '../lib/format.js';
-export async function sendCommand(number, message) {
+import { normalizeNumber, printError } from '../lib/format.js';
+export async function sendCommand(number, message, opts) {
     const creds = getCredentials();
     if (!creds) {
         printError('No credentials found. Run `sendblue login` first.');
@@ -13,7 +12,7 @@ export async function sendCommand(number, message) {
     const normalized = normalizeNumber(number);
     const spinner = ora({ text: `Sending to ${normalized}...`, indent: 2 }).start();
     try {
-        const result = await sendMessage(creds.apiKey, creds.apiSecret, normalized, message, creds.assignedNumber);
+        const result = await sendMessage(creds.apiKey, creds.apiSecret, normalized, message, creds.assignedNumber, opts.media);
         spinner.succeed(`Message sent to ${normalized}`);
         if (result.messageId) {
             console.log(chalk.dim(`  Message ID: ${result.messageId}`));

package/dist/commands/show-keys.d.ts

@@ -0,0 +1 @@
+export declare function showKeysCommand(): Promise<void>;

package/dist/commands/show-keys.js

@@ -0,0 +1,16 @@
+import chalk from 'chalk';
+import { getCredentials } from '../lib/config.js';
+import { printError } from '../lib/format.js';
+export async function showKeysCommand() {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    console.log();
+    console.log(chalk.bold('  API Keys'));
+    console.log();
+    console.log(`  ${chalk.bold('API Key')}:    ${creds.apiKey}`);
+    console.log(`  ${chalk.bold('API Secret')}: ${creds.apiSecret}`);
+    console.log();
+}

package/dist/commands/typing.d.ts

@@ -0,0 +1 @@
+export declare function typingCommand(number: string): Promise<void>;

package/dist/commands/typing.js

@@ -0,0 +1,21 @@
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { sendTypingIndicator } from '../lib/api.js';
+import { normalizeNumber, printError } from '../lib/format.js';
+export async function typingCommand(number) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    const normalized = normalizeNumber(number);
+    const spinner = ora({ text: `Sending typing indicator to ${normalized}...`, indent: 2 }).start();
+    try {
+        await sendTypingIndicator(creds.apiKey, creds.apiSecret, normalized, creds.assignedNumber);
+        spinner.succeed(`Typing indicator sent to ${normalized}`);
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/webhooks.d.ts

@@ -0,0 +1,7 @@
+export declare function webhooksListCommand(): Promise<void>;
+export declare function webhooksAddCommand(url: string, opts: {
+    type: string;
+}): Promise<void>;
+export declare function webhooksRemoveCommand(url: string, opts: {
+    type: string;
+}): Promise<void>;

package/dist/commands/webhooks.js

@@ -0,0 +1,78 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { getCredentials } from '../lib/config.js';
+import { getWebhooks, addWebhook, deleteWebhook } from '../lib/api.js';
+import { printError } from '../lib/format.js';
+const VALID_TYPES = ['receive', 'outbound', 'call_log', 'line_blocked', 'line_assigned', 'contact_created'];
+export async function webhooksListCommand() {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Fetching webhooks...', indent: 2 }).start();
+    try {
+        const result = await getWebhooks(creds.apiKey, creds.apiSecret);
+        spinner.stop();
+        console.log();
+        console.log(chalk.bold('  Webhooks'));
+        console.log();
+        if (!result.webhooks || result.webhooks.length === 0) {
+            console.log(chalk.dim('  No webhooks configured.'));
+            console.log();
+            console.log(chalk.dim('  Add one with:'));
+            console.log(chalk.cyan('    sendblue webhooks add <url> --type receive'));
+        }
+        else {
+            for (const wh of result.webhooks) {
+                const type = wh.type ? chalk.dim(` (${wh.type})`) : '';
+                console.log(`  ${chalk.cyan(wh.url)}${type}`);
+            }
+        }
+        console.log();
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+export async function webhooksAddCommand(url, opts) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    if (!VALID_TYPES.includes(opts.type)) {
+        printError(`Invalid type. Must be one of: ${VALID_TYPES.join(', ')}`);
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Adding webhook...', indent: 2 }).start();
+    try {
+        await addWebhook(creds.apiKey, creds.apiSecret, url, opts.type);
+        spinner.succeed(`Webhook added: ${url} (${opts.type})`);
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+export async function webhooksRemoveCommand(url, opts) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue login` first.');
+        process.exit(1);
+    }
+    if (!VALID_TYPES.includes(opts.type)) {
+        printError(`Invalid type. Must be one of: ${VALID_TYPES.join(', ')}`);
+        process.exit(1);
+    }
+    const spinner = ora({ text: 'Removing webhook...', indent: 2 }).start();
+    try {
+        await deleteWebhook(creds.apiKey, creds.apiSecret, url, opts.type);
+        spinner.succeed(`Webhook removed: ${url} (${opts.type})`);
+    }
+    catch (err) {
+        spinner.fail(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/index.js

@@ -4,10 +4,15 @@ import { Command } from 'commander';
 import { setupCommand } from './commands/setup.js';
 import { loginCommand } from './commands/login.js';
 import { sendCommand } from './commands/send.js';
+import { sendGroupCommand } from './commands/send-group.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 { typingCommand } from './commands/typing.js';
+import { linesCommand } from './commands/lines.js';
+import { webhooksListCommand, webhooksAddCommand, webhooksRemoveCommand } from './commands/webhooks.js';
+import { showKeysCommand } from './commands/show-keys.js';
 import { getLogo } from './lib/format.js';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
@@ -28,21 +33,24 @@ program
     .command('login')
     .description('Log in to an existing Sendblue account')
     .action(loginCommand);
-program
-    .command('add-contact')
-    .description('Add a contact to your account')
-    .argument('<number>', 'Contact phone number (E.164 format)')
-    .action(addContactCommand);
-program
-    .command('contacts')
-    .description('List contacts and verification status')
-    .action(contactsCommand);
 program
     .command('send')
     .description('Send a message')
     .argument('<number>', 'Recipient phone number (E.164 format)')
     .argument('<message>', 'Message content')
+    .option('--media <url>', 'Attach a media URL (image, video, etc.)')
     .action(sendCommand);
+program
+    .command('send-group')
+    .description('Send a group message')
+    .argument('<args...>', 'Phone numbers followed by message: <num1> <num2> [...] <message>')
+    .option('--media <url>', 'Attach a media URL')
+    .action(sendGroupCommand);
+program
+    .command('typing')
+    .description('Send a typing indicator')
+    .argument('<number>', 'Recipient phone number (E.164 format)')
+    .action(typingCommand);
 program
     .command('messages')
     .description('View recent messages')
@@ -51,6 +59,38 @@ program
     .option('--outbound', 'Show only outbound messages')
     .option('--inbound', 'Show only inbound messages')
     .action(messagesCommand);
+program
+    .command('add-contact')
+    .description('Add a contact to your account')
+    .argument('<number>', 'Contact phone number (E.164 format)')
+    .action(addContactCommand);
+program
+    .command('contacts')
+    .description('List contacts and verification status')
+    .action(contactsCommand);
+program
+    .command('lines')
+    .description('List phone numbers on your account')
+    .action(linesCommand);
+const webhooks = program
+    .command('webhooks')
+    .description('Manage webhooks');
+webhooks
+    .command('list')
+    .description('List configured webhooks')
+    .action(webhooksListCommand);
+webhooks
+    .command('add')
+    .description('Add a webhook')
+    .argument('<url>', 'Webhook URL')
+    .requiredOption('--type <type>', 'Event type (receive, outbound, call_log, line_blocked, line_assigned, contact_created)')
+    .action(webhooksAddCommand);
+webhooks
+    .command('remove')
+    .description('Remove a webhook')
+    .argument('<url>', 'Webhook URL')
+    .requiredOption('--type <type>', 'Event type')
+    .action(webhooksRemoveCommand);
 program
     .command('status')
     .description('Check your account status')
@@ -59,4 +99,8 @@ program
     .command('whoami')
     .description('Show current credentials')
     .action(whoamiCommand);
+program
+    .command('show-keys')
+    .description('Show your API key and secret')
+    .action(showKeysCommand);
 program.parse();

package/dist/lib/api.d.ts

@@ -22,7 +22,7 @@ interface AccountResponse {
 export declare function sendCode(email: string): Promise<void>;
 export declare function verifySetup(email: string, code: string, companyName: string): Promise<SetupResponse>;
 export declare function verifyLogin(email: string, code: string): Promise<SetupResponse>;
-export declare function sendMessage(apiKey: string, apiSecret: string, number: string, content: string, fromNumber?: string): Promise<SendMessageResponse>;
+export declare function sendMessage(apiKey: string, apiSecret: string, number: string, content: string, fromNumber?: string, mediaUrl?: string): Promise<SendMessageResponse>;
 export declare function getAccount(apiKey: string, apiSecret: string): Promise<AccountResponse>;
 interface ContactRoute {
     id: number;
@@ -67,5 +67,21 @@ export declare function getMessages(apiKey: string, apiSecret: string, opts: {
     limit?: number;
     isOutbound?: boolean;
 }): Promise<MessagesResponse>;
+export declare function sendTypingIndicator(apiKey: string, apiSecret: string, number: string, fromNumber?: string): Promise<void>;
+export declare function sendGroupMessage(apiKey: string, apiSecret: string, numbers: string[], content: string, fromNumber?: string, mediaUrl?: string): Promise<SendMessageResponse>;
+export declare function getLines(apiKey: string, apiSecret: string): Promise<{
+    numbers: string[];
+}>;
+interface Webhook {
+    url: string;
+    type?: string;
+}
+interface WebhooksResponse {
+    webhooks: Webhook[];
+    [key: string]: unknown;
+}
+export declare function getWebhooks(apiKey: string, apiSecret: string): Promise<WebhooksResponse>;
+export declare function addWebhook(apiKey: string, apiSecret: string, url: string, type: string): Promise<void>;
+export declare function deleteWebhook(apiKey: string, apiSecret: string, url: string, type: string): Promise<void>;
 export declare function testKeys(apiKey: string, apiSecret: string): Promise<boolean>;
 export {};

package/dist/lib/api.js

@@ -1,5 +1,5 @@
 const API_BASE = 'https://api.sendblue.com';
-const SETUP_BASE = process.env.SENDBLUE_SETUP_URL || 'https://dashboard.sendblue.com';
+const SETUP_BASE = 'https://dashboard.sendblue.com';
 export async function sendCode(email) {
     const res = await fetch(`${SETUP_BASE}/api/v3/cli/setup`, {
         method: 'POST',
@@ -35,10 +35,12 @@ export async function verifyLogin(email, code) {
     }
     return res.json();
 }
-export async function sendMessage(apiKey, apiSecret, number, content, fromNumber) {
+export async function sendMessage(apiKey, apiSecret, number, content, fromNumber, mediaUrl) {
     const body = { number, content };
     if (fromNumber)
         body.from_number = fromNumber;
+    if (mediaUrl)
+        body.media_url = mediaUrl;
     const res = await fetch(`${API_BASE}/api/send-message`, {
         method: 'POST',
         headers: {
@@ -121,6 +123,106 @@ export async function getMessages(apiKey, apiSecret, opts) {
     }
     return res.json();
 }
+// --- Typing indicator ---
+export async function sendTypingIndicator(apiKey, apiSecret, number, fromNumber) {
+    const body = { number };
+    if (fromNumber)
+        body.from_number = fromNumber;
+    const res = await fetch(`${API_BASE}/api/send-typing-indicator`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to send typing indicator (${res.status})`);
+    }
+}
+// --- Group messaging ---
+export async function sendGroupMessage(apiKey, apiSecret, numbers, content, fromNumber, mediaUrl) {
+    const body = { numbers, content };
+    if (fromNumber)
+        body.from_number = fromNumber;
+    if (mediaUrl)
+        body.media_url = mediaUrl;
+    const res = await fetch(`${API_BASE}/api/send-group-message`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to send group message (${res.status})`);
+    }
+    return res.json();
+}
+// --- Lines ---
+export async function getLines(apiKey, apiSecret) {
+    const res = await fetch(`${API_BASE}/api/lines`, {
+        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 lines (${res.status})`);
+    }
+    return res.json();
+}
+export async function getWebhooks(apiKey, apiSecret) {
+    const res = await fetch(`${API_BASE}/api/account/webhooks`, {
+        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 webhooks (${res.status})`);
+    }
+    return res.json();
+}
+export async function addWebhook(apiKey, apiSecret, url, type) {
+    const res = await fetch(`${API_BASE}/api/account/webhooks`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify({ webhooks: [url], type })
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to add webhook (${res.status})`);
+    }
+}
+export async function deleteWebhook(apiKey, apiSecret, url, type) {
+    const res = await fetch(`${API_BASE}/api/account/webhooks`, {
+        method: 'DELETE',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify({ webhooks: [url], type })
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Failed to delete webhook (${res.status})`);
+    }
+}
 export async function testKeys(apiKey, apiSecret) {
     try {
         const res = await fetch(`${API_BASE}/account`, {

package/package.json

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