@blinkdotnew/cli 0.3.5 → 0.3.6

package/AGENTS.md

@@ -38,6 +38,7 @@ packages/cli/
 │   │   ├── db.ts               # blink db query/exec/list                           → core.blink.new
 │   │   ├── deploy.ts           # blink deploy / deployments / rollback              → blink.new
 │   │   ├── notify.ts           # blink notify email                                 → core.blink.new
+│   │   ├── sms.ts              # blink sms send                                     → core.blink.new
 │   │   ├── project.ts          # blink project / blink link / blink status          → blink.new
 │   │   ├── rag.ts              # blink rag search/upload/collections                → core.blink.new
 │   │   ├── realtime.ts         # blink realtime publish                             → core.blink.new
@@ -144,6 +145,14 @@ blink notify email <project_id> <to> <subject> [body]
 blink notify email <to> <subject> --file ./body.html
 ```
 
+### SMS (→ core.blink.new /api/v1/sms/send)
+```bash
+blink sms send <to> <message>                     # Send SMS from workspace primary number
+blink sms send <to> <message> --from <number>     # Send from specific workspace number
+blink sms send <to> <message> --json              # Machine-readable output
+```
+Requires a provisioned workspace phone number (`blink phone buy`). 0.1 credits/message.
+
 ### Connectors (→ core.blink.new /api/v1/connectors/[provider]/execute)
 ```bash
 blink connector exec <provider> <action> [params-json] [--account <id>] [--method POST]

package/dist/cli.js

@@ -1726,6 +1726,53 @@ The number is permanently returned to the carrier pool. This action cannot be un
   });
 }
 
+// src/commands/sms.ts
+function formatPhone2(num) {
+  const m = num.match(/^\+1(\d{3})(\d{3})(\d{4})$/);
+  return m ? `+1 (${m[1]}) ${m[2]}-${m[3]}` : num;
+}
+function registerSmsCommands(program2) {
+  const sms = program2.command("sms").description("Send SMS messages from your workspace phone number").addHelpText("after", `
+Commands:
+  send      Send an SMS text message to any phone number
+
+Examples:
+  $ blink sms send "+14155551234" "Your order is ready!"
+  $ blink sms send "+14155551234" "Code: 492817" --from "+19143720262"
+  $ blink sms send "+447911123456" "Your appointment is confirmed."
+  $ blink sms send "+14155551234" "Hello" --json
+
+Requires a provisioned workspace phone number (blink phone list / blink phone buy).
+0.1 credits per message. Credits charged immediately on send.
+`).action(() => sms.help());
+  sms.command("send <to> <message>").description("Send an SMS message (0.1 credits per message)").option("--from <number>", "Specific sender number (default: workspace primary)").addHelpText("after", `
+Examples:
+  $ blink sms send "+14155551234" "Your appointment is confirmed for tomorrow at 2pm."
+  $ blink sms send "+447911123456" "Your order #1042 has shipped!"
+  $ blink sms send "+14155551234" "Code: 492817" --from "+19143720262"
+  $ blink sms send "+14155551234" "Hello" --json
+
+Phone numbers must be in E.164 format (+14155551234).
+Messages over 160 characters count as multiple segments (still 0.1 credits).
+Requires a provisioned workspace phone number: blink phone buy
+`).action(async (to, message, opts) => {
+    requireToken();
+    const body = { to, message };
+    if (opts.from?.trim()) body.from = opts.from.trim();
+    const result = await withSpinner(
+      `Sending SMS to ${to}...`,
+      () => resourcesRequest("/api/v1/sms/send", { body })
+    );
+    if (isJsonMode()) return printJson(result);
+    console.log(`\u2713 SMS sent`);
+    console.log(`  To       ${formatPhone2(result.to)}`);
+    console.log(`  From     ${formatPhone2(result.from)}`);
+    if (result.segment_count > 1) console.log(`  Segments ${result.segment_count}`);
+    console.log(`  ID       ${result.message_id}`);
+    console.log(`  Credits  ${result.credits_charged}`);
+  });
+}
+
 // src/lib/api-app.ts
 var BASE_URL2 = process.env.BLINK_APP_URL ?? "https://blink.new";
 async function appRequest(path, opts = {}) {
@@ -2372,6 +2419,7 @@ registerNotifyCommands(program);
 registerConnectorCommands(program);
 registerLinkedInCommands(program);
 registerPhoneCommands(program);
+registerSmsCommands(program);
 program.command("use <project_id>").description("Set active project for this shell session (alternative to blink link)").option("--export", "Output a shell export statement \u2014 use with eval to actually set it").addHelpText("after", `
 Examples:
   $ blink use proj_xxx                        Shows the export command to run

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/cli",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Blink platform CLI — deploy apps, manage databases, generate AI content",
   "bin": {
     "blink": "dist/cli.js"

package/src/cli.ts

@@ -11,6 +11,7 @@ import { registerNotifyCommands } from './commands/notify.js'
 import { registerConnectorCommands } from './commands/connector.js'
 import { registerLinkedInCommands } from './commands/linkedin.js'
 import { registerPhoneCommands } from './commands/phone.js'
+import { registerSmsCommands } from './commands/sms.js'
 import { registerDeployCommands } from './commands/deploy.js'
 import { registerProjectCommands } from './commands/project.js'
 import { registerAuthCommands } from './commands/auth.js'
@@ -150,6 +151,7 @@ registerNotifyCommands(program)
 registerConnectorCommands(program)
 registerLinkedInCommands(program)
 registerPhoneCommands(program)
+registerSmsCommands(program)
 
 program.command('use <project_id>')
   .description('Set active project for this shell session (alternative to blink link)')

package/src/commands/sms.ts

@@ -0,0 +1,71 @@
+import { Command } from 'commander'
+import { resourcesRequest } from '../lib/api-resources.js'
+import { requireToken } from '../lib/auth.js'
+import { printJson, isJsonMode, withSpinner } from '../lib/output.js'
+
+interface SmsResult {
+  message_id: string
+  twilio_sid: string
+  status: string
+  to: string
+  from: string
+  segment_count: number
+  credits_charged: number
+}
+
+function formatPhone(num: string): string {
+  const m = num.match(/^\+1(\d{3})(\d{3})(\d{4})$/)
+  return m ? `+1 (${m[1]}) ${m[2]}-${m[3]}` : num
+}
+
+export function registerSmsCommands(program: Command) {
+  const sms = program.command('sms')
+    .description('Send SMS messages from your workspace phone number')
+    .addHelpText('after', `
+Commands:
+  send      Send an SMS text message to any phone number
+
+Examples:
+  $ blink sms send "+14155551234" "Your order is ready!"
+  $ blink sms send "+14155551234" "Code: 492817" --from "+19143720262"
+  $ blink sms send "+447911123456" "Your appointment is confirmed."
+  $ blink sms send "+14155551234" "Hello" --json
+
+Requires a provisioned workspace phone number (blink phone list / blink phone buy).
+0.1 credits per message. Credits charged immediately on send.
+`)
+    .action(() => sms.help())
+
+  sms.command('send <to> <message>')
+    .description('Send an SMS message (0.1 credits per message)')
+    .option('--from <number>', 'Specific sender number (default: workspace primary)')
+    .addHelpText('after', `
+Examples:
+  $ blink sms send "+14155551234" "Your appointment is confirmed for tomorrow at 2pm."
+  $ blink sms send "+447911123456" "Your order #1042 has shipped!"
+  $ blink sms send "+14155551234" "Code: 492817" --from "+19143720262"
+  $ blink sms send "+14155551234" "Hello" --json
+
+Phone numbers must be in E.164 format (+14155551234).
+Messages over 160 characters count as multiple segments (still 0.1 credits).
+Requires a provisioned workspace phone number: blink phone buy
+`)
+    .action(async (to: string, message: string, opts) => {
+      requireToken()
+      const body: Record<string, string> = { to, message }
+      if (opts.from?.trim()) body.from = opts.from.trim()
+
+      const result = await withSpinner(`Sending SMS to ${to}...`, () =>
+        resourcesRequest('/api/v1/sms/send', { body })
+      ) as SmsResult
+
+      if (isJsonMode()) return printJson(result)
+
+      console.log(`✓ SMS sent`)
+      console.log(`  To       ${formatPhone(result.to)}`)
+      console.log(`  From     ${formatPhone(result.from)}`)
+      if (result.segment_count > 1) console.log(`  Segments ${result.segment_count}`)
+      console.log(`  ID       ${result.message_id}`)
+      console.log(`  Credits  ${result.credits_charged}`)
+    })
+}