@sendblue/cli 0.1.0

package/dist/commands/send.d.ts

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

package/dist/commands/send.js

@@ -0,0 +1,22 @@
+import chalk from 'chalk';
+import { getCredentials } from '../lib/config.js';
+import { sendMessage } from '../lib/api.js';
+import { printError, printSuccess } from '../lib/format.js';
+export async function sendCommand(number, message) {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue setup` first.');
+        process.exit(1);
+    }
+    try {
+        const result = await sendMessage(creds.apiKey, creds.apiSecret, number, message);
+        printSuccess(`Message sent to ${number}`);
+        if (result.messageId) {
+            console.log(chalk.dim(`  Message ID: ${result.messageId}`));
+        }
+    }
+    catch (err) {
+        printError(`Send failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/setup.d.ts

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

package/dist/commands/setup.js

@@ -0,0 +1,67 @@
+import prompts from 'prompts';
+import chalk from 'chalk';
+import { getCredentials, saveCredentials, credentialsPath } from '../lib/config.js';
+import { setupAccount } from '../lib/api.js';
+import { printCredentials, printError, printInfo } from '../lib/format.js';
+export async function setupCommand() {
+    console.log();
+    console.log(chalk.bold('  sendblue setup'));
+    console.log(chalk.dim('  iMessage numbers for agents'));
+    console.log();
+    // Check for existing credentials
+    const existing = getCredentials();
+    if (existing) {
+        const { overwrite } = await prompts({
+            type: 'confirm',
+            name: 'overwrite',
+            message: `You already have an account configured (${existing.email}). Overwrite?`,
+            initial: false
+        });
+        if (!overwrite) {
+            printInfo('Setup cancelled.');
+            return;
+        }
+    }
+    // Collect info
+    const response = await prompts([
+        {
+            type: 'text',
+            name: 'email',
+            message: 'Email',
+            validate: (v) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v) || 'Enter a valid email'
+        },
+        {
+            type: 'text',
+            name: 'companyName',
+            message: 'Company name (optional)',
+            initial: ''
+        }
+    ]);
+    if (!response.email) {
+        printError('Setup cancelled.');
+        return;
+    }
+    console.log();
+    printInfo('  Setting up your account...');
+    try {
+        const result = await setupAccount(response.email, response.companyName || undefined);
+        saveCredentials({
+            apiKey: result.apiKey,
+            apiSecret: result.apiSecret,
+            email: result.email,
+            assignedNumber: result.assignedNumber,
+            plan: result.plan,
+            createdAt: new Date().toISOString()
+        });
+        printCredentials(result);
+        console.log(chalk.dim(`  Credentials saved to ${credentialsPath()}`));
+        console.log();
+        console.log(chalk.bold('  Quick start:'));
+        console.log(chalk.cyan(`    sendblue send +15551234567 "Hello from Sendblue!"`));
+        console.log();
+    }
+    catch (err) {
+        printError(`  Setup failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/status.d.ts

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

package/dist/commands/status.js

@@ -0,0 +1,25 @@
+import chalk from 'chalk';
+import { getCredentials } from '../lib/config.js';
+import { getAccount } from '../lib/api.js';
+import { formatPhoneNumber, printError } from '../lib/format.js';
+export async function statusCommand() {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue setup` first.');
+        process.exit(1);
+    }
+    try {
+        const account = await getAccount(creds.apiKey, creds.apiSecret);
+        console.log();
+        console.log(chalk.bold('  Account Status'));
+        console.log();
+        console.log(`  ${chalk.bold('Email')}:         ${creds.email}`);
+        console.log(`  ${chalk.bold('Phone Number')}:  ${formatPhoneNumber(creds.assignedNumber)}`);
+        console.log(`  ${chalk.bold('Plan')}:          ${account.plan || creds.plan}`);
+        console.log();
+    }
+    catch (err) {
+        printError(`Failed to fetch status: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}

package/dist/commands/whoami.d.ts

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

package/dist/commands/whoami.js

@@ -0,0 +1,22 @@
+import chalk from 'chalk';
+import { getCredentials, credentialsPath } from '../lib/config.js';
+import { testKeys } from '../lib/api.js';
+import { formatPhoneNumber, printError } from '../lib/format.js';
+export async function whoamiCommand() {
+    const creds = getCredentials();
+    if (!creds) {
+        printError('No credentials found. Run `sendblue setup` first.');
+        process.exit(1);
+    }
+    const valid = await testKeys(creds.apiKey, creds.apiSecret);
+    console.log();
+    console.log(chalk.bold('  Current Account'));
+    console.log();
+    console.log(`  ${chalk.bold('Email')}:         ${creds.email}`);
+    console.log(`  ${chalk.bold('Phone Number')}:  ${formatPhoneNumber(creds.assignedNumber)}`);
+    console.log(`  ${chalk.bold('API Key')}:       ${creds.apiKey.slice(0, 8)}...`);
+    console.log(`  ${chalk.bold('Plan')}:          ${creds.plan}`);
+    console.log(`  ${chalk.bold('Keys Valid')}:    ${valid ? chalk.green('Yes') : chalk.red('No')}`);
+    console.log(`  ${chalk.bold('Config')}:        ${credentialsPath()}`);
+    console.log();
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { setupCommand } from './commands/setup.js';
+import { sendCommand } from './commands/send.js';
+import { statusCommand } from './commands/status.js';
+import { whoamiCommand } from './commands/whoami.js';
+const program = new Command();
+program
+    .name('sendblue')
+    .description('Sendblue CLI — iMessage numbers for agents')
+    .version('0.1.0');
+program
+    .command('setup')
+    .description('Create an account and get a phone number')
+    .action(setupCommand);
+program
+    .command('send')
+    .description('Send a message')
+    .argument('<number>', 'Recipient phone number (E.164 format)')
+    .argument('<message>', 'Message content')
+    .action(sendCommand);
+program
+    .command('status')
+    .description('Check your account status')
+    .action(statusCommand);
+program
+    .command('whoami')
+    .description('Show current credentials')
+    .action(whoamiCommand);
+program.parse();

package/dist/lib/api.d.ts

@@ -0,0 +1,25 @@
+interface SetupResponse {
+    status: string;
+    email: string;
+    apiKey: string;
+    apiSecret: string;
+    assignedNumber: string;
+    plan: string;
+}
+interface SendMessageResponse {
+    status: string;
+    message?: string;
+    messageId?: string;
+    [key: string]: unknown;
+}
+interface AccountResponse {
+    status?: string;
+    email?: string;
+    plan?: string;
+    [key: string]: unknown;
+}
+export declare function setupAccount(email: string, companyName?: string): Promise<SetupResponse>;
+export declare function sendMessage(apiKey: string, apiSecret: string, number: string, content: string): Promise<SendMessageResponse>;
+export declare function getAccount(apiKey: string, apiSecret: string): Promise<AccountResponse>;
+export declare function testKeys(apiKey: string, apiSecret: string): Promise<boolean>;
+export {};

package/dist/lib/api.js

@@ -0,0 +1,59 @@
+const API_BASE = 'https://api.sendblue.co';
+const SETUP_BASE = process.env.SENDBLUE_SETUP_URL || 'https://app.sendblue.co';
+export async function setupAccount(email, companyName) {
+    const res = await fetch(`${SETUP_BASE}/api/v3/cli/setup`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ email, companyName })
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Setup failed (${res.status})`);
+    }
+    return res.json();
+}
+export async function sendMessage(apiKey, apiSecret, number, content) {
+    const res = await fetch(`${API_BASE}/api/send-message`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'sb-api-key-id': apiKey,
+            'sb-api-secret-key': apiSecret
+        },
+        body: JSON.stringify({ number, content })
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(body.error || body.message || `Send failed (${res.status})`);
+    }
+    return res.json();
+}
+export async function getAccount(apiKey, apiSecret) {
+    const res = await fetch(`${API_BASE}/account`, {
+        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 || `Request failed (${res.status})`);
+    }
+    return res.json();
+}
+export async function testKeys(apiKey, apiSecret) {
+    try {
+        const res = await fetch(`${API_BASE}/account`, {
+            method: 'GET',
+            headers: {
+                'sb-api-key-id': apiKey,
+                'sb-api-secret-key': apiSecret
+            }
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/lib/config.d.ts

@@ -0,0 +1,12 @@
+export interface SendblueCredentials {
+    apiKey: string;
+    apiSecret: string;
+    email: string;
+    assignedNumber: string;
+    plan: string;
+    createdAt: string;
+}
+export declare function getCredentials(): SendblueCredentials | null;
+export declare function saveCredentials(creds: SendblueCredentials): void;
+export declare function clearCredentials(): void;
+export declare function credentialsPath(): string;

package/dist/lib/config.js

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const CONFIG_DIR = path.join(os.homedir(), '.sendblue');
+const CREDENTIALS_FILE = path.join(CONFIG_DIR, 'credentials.json');
+export function getCredentials() {
+    try {
+        const data = fs.readFileSync(CREDENTIALS_FILE, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+export function saveCredentials(creds) {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { mode: 0o700 });
+    }
+    fs.writeFileSync(CREDENTIALS_FILE, JSON.stringify(creds, null, 2), {
+        mode: 0o600
+    });
+}
+export function clearCredentials() {
+    try {
+        fs.unlinkSync(CREDENTIALS_FILE);
+    }
+    catch {
+        // ignore if doesn't exist
+    }
+}
+export function credentialsPath() {
+    return CREDENTIALS_FILE;
+}

package/dist/lib/format.d.ts

@@ -0,0 +1,11 @@
+export declare function formatPhoneNumber(e164: string): string;
+export declare function printSuccess(message: string): void;
+export declare function printError(message: string): void;
+export declare function printInfo(message: string): void;
+export declare function printCredentials(data: {
+    email: string;
+    apiKey: string;
+    apiSecret: string;
+    assignedNumber: string;
+    plan: string;
+}): void;

package/dist/lib/format.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+export function formatPhoneNumber(e164) {
+    // +15551234567 -> +1 (555) 123-4567
+    const match = e164.match(/^\+1(\d{3})(\d{3})(\d{4})$/);
+    if (match) {
+        return `+1 (${match[1]}) ${match[2]}-${match[3]}`;
+    }
+    return e164;
+}
+export function printSuccess(message) {
+    console.log(chalk.green(message));
+}
+export function printError(message) {
+    console.error(chalk.red(message));
+}
+export function printInfo(message) {
+    console.log(chalk.cyan(message));
+}
+export function printCredentials(data) {
+    console.log();
+    console.log(chalk.green.bold('  Account created successfully!'));
+    console.log();
+    console.log(`  ${chalk.bold('Phone Number')}:  ${formatPhoneNumber(data.assignedNumber)}`);
+    console.log(`  ${chalk.bold('API Key')}:       ${data.apiKey}`);
+    console.log(`  ${chalk.bold('API Secret')}:    ${data.apiSecret}`);
+    console.log(`  ${chalk.bold('Plan')}:          ${data.plan}`);
+    console.log();
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@sendblue/cli",
+  "version": "0.1.0",
+  "description": "Sendblue CLI — iMessage numbers for agents",
+  "type": "module",
+  "bin": {
+    "sendblue": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "sendblue",
+    "imessage",
+    "sms",
+    "cli",
+    "messaging",
+    "agents"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.5.0"
+  }
+}