npm - emailr-cli - Versions diffs - 1.5.4 → 1.6.0 - Mend

emailr-cli 1.5.4 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/dist/index.js +2643 -112
package/package.json +2 -2

package/dist/index.js CHANGED Viewed

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import {Command}from'commander';import {Emailr}from'emailr';import E from'fs';import G from'os';import U from'path';import ie from'cli-table3';import v from'chalk';import qe from'http';import {URL}from'url';import ct from'crypto';import {spawn,execSync,exec}from'child_process';var _e=[U.join(G.homedir(),".emailrrc"),U.join(G.homedir(),".config","emailr","config.json")];function m(){if(process.env.EMAILR_API_KEY)return {apiKey:process.env.EMAILR_API_KEY,baseUrl:process.env.EMAILR_BASE_URL,format:process.env.EMAILR_FORMAT||"table"};for(let n of _e)if(E.existsSync(n))try{let t=E.readFileSync(n,"utf-8"),e=JSON.parse(t);if(e.apiKey)return {apiKey:e.apiKey,baseUrl:e.baseUrl,format:e.format||"table"}}catch{}throw new Error(`No API key configured.
+import {Command}from'commander';import {Emailr}from'emailr';import v,{readFileSync}from'fs';import W from'os';import N from'path';import re from'cli-table3';import S from'chalk';import Je from'http';import {URL}from'url';import ct from'crypto';import {spawn,execSync,exec}from'child_process';var Re=[N.join(W.homedir(),".emailrrc"),N.join(W.homedir(),".config","emailr","config.json")];function m(){if(process.env.EMAILR_API_KEY)return {apiKey:process.env.EMAILR_API_KEY,baseUrl:process.env.EMAILR_BASE_URL,format:process.env.EMAILR_FORMAT||"table"};for(let i of Re)if(v.existsSync(i))try{let t=v.readFileSync(i,"utf-8"),e=JSON.parse(t);if(e.apiKey)return {apiKey:e.apiKey,baseUrl:e.baseUrl,format:e.format||"table"}}catch{}throw new Error(`No API key configured.
 Set the EMAILR_API_KEY environment variable:
   export EMAILR_API_KEY=your-api-key
@@ -7,9 +7,419 @@ Set the EMAILR_API_KEY environment variable:
 Or create a config file at ~/.emailrrc:
   { "apiKey": "your-api-key" }
-Or run: emailr config set api-key <your-api-key>`)}function j(){let n=U.join(G.homedir(),".config","emailr");return U.join(n,"config.json")}function A(n){let t=j(),e=U.dirname(t);E.existsSync(e)||E.mkdirSync(e,{recursive:true});let o={};if(E.existsSync(t))try{o=JSON.parse(E.readFileSync(t,"utf-8"));}catch{}let i={...o,...n};E.writeFileSync(t,JSON.stringify(i,null,2)+`
-`);}function re(n){try{return m()[n]?.toString()}catch{return}}function c(n,t="table"){t==="json"?console.log(JSON.stringify(n,null,2)):Le(n);}function Le(n){Array.isArray(n)?Re(n):typeof n=="object"&&n!==null?Ne(n):console.log(n);}function Re(n){if(n.length===0){console.log(v.gray("No results"));return}let t=n[0];if(typeof t!="object"||t===null){n.forEach(i=>console.log(i));return}let e=Object.keys(t),o=new ie({head:e.map(i=>v.cyan(i)),style:{head:[],border:[]}});for(let i of n){let a=e.map(r=>{let s=i[r];return se(s)});o.push(a);}console.log(o.toString());}function Ne(n){let t=new ie({style:{head:[],border:[]}});for(let[e,o]of Object.entries(n))t.push([v.cyan(e),se(o)]);console.log(t.toString());}function se(n){return n==null?v.gray("-"):typeof n=="boolean"?n?v.green("\u2713"):v.red("\u2717"):typeof n=="object"?JSON.stringify(n):String(n)}function d(n){console.log(v.green("\u2713"),n);}function l(n){console.error(v.red("\u2717"),n);}function k(n){console.warn(v.yellow("\u26A0"),n);}function p(n){console.log(v.blue("\u2139"),n);}function ce(){return new Command("send").description("Send an email").requiredOption("--to <email>","Recipient email address (comma-separated for multiple)").option("--from <email>","Sender email address").option("--subject <subject>","Email subject").option("--html <html>","HTML content").option("--text <text>","Plain text content").option("--template <id>","Template ID to use").option("--template-data <json>","Template data as JSON").option("--cc <emails>","CC recipients (comma-separated)").option("--bcc <emails>","BCC recipients (comma-separated)").option("--reply-to <email>","Reply-to email address").option("--schedule <datetime>","Schedule send time (ISO 8601)").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),o=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),i=t.to.split(",").map(s=>s.trim()),a={to:i.length===1?i[0]:i};if(t.from&&(a.from=t.from),t.subject&&(a.subject=t.subject),t.html&&(a.html=t.html),t.text&&(a.text=t.text),t.template&&(a.template_id=t.template),t.templateData)try{a.template_data=JSON.parse(t.templateData);}catch{l("Invalid JSON for --template-data"),process.exit(1);}if(t.cc){let s=t.cc.split(",").map(f=>f.trim());a.cc=s.length===1?s[0]:s;}if(t.bcc){let s=t.bcc.split(",").map(f=>f.trim());a.bcc=s.length===1?s[0]:s;}t.replyTo&&(a.reply_to_email=t.replyTo),t.schedule&&(a.scheduled_at=t.schedule);let r=await o.emails.send(a);t.format==="json"?c(r,"json"):(d("Email sent successfully!"),c({"Message ID":r.message_id,Recipients:r.recipients,Status:r.status,...r.scheduled_at&&{"Scheduled At":r.scheduled_at}},"table"));}catch(e){l(e instanceof Error?e.message:"Failed to send email"),process.exit(1);}})}function le(){let n=new Command("contacts").description("Manage contacts");return n.command("list").description("List all contacts").option("--limit <number>","Number of contacts to return","20").option("--offset <number>","Offset for pagination","0").option("--subscribed","Only show subscribed contacts").option("--unsubscribed","Only show unsubscribed contacts").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),o=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),i={limit:parseInt(t.limit,10),offset:parseInt(t.offset,10)};t.subscribed&&(i.subscribed=!0),t.unsubscribed&&(i.subscribed=!1);let a=await o.contacts.list(i);if(t.format==="json")c(a,"json");else {let r=a.contacts.map(s=>({ID:s.id,Email:s.email,Name:[s.first_name,s.last_name].filter(Boolean).join(" ")||"-",Subscribed:s.subscribed,Created:s.created_at}));c(r,"table"),console.log(`
-Total: ${a.total}`);}}catch(e){l(e instanceof Error?e.message:"Failed to list contacts"),process.exit(1);}}),n.command("get <id>").description("Get a contact by ID").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).contacts.get(t);c(a,e.format);}catch(o){l(o instanceof Error?o.message:"Failed to get contact"),process.exit(1);}}),n.command("create").description("Create a new contact").requiredOption("--email <email>","Contact email address").option("--first-name <name>","First name").option("--last-name <name>","Last name").option("--subscribed","Mark as subscribed (default: true)").option("--metadata <json>","Metadata as JSON").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),o=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),i={email:t.email};if(t.firstName&&(i.first_name=t.firstName),t.lastName&&(i.last_name=t.lastName),t.subscribed!==void 0&&(i.subscribed=t.subscribed),t.metadata)try{i.metadata=JSON.parse(t.metadata);}catch{l("Invalid JSON for --metadata"),process.exit(1);}let a=await o.contacts.create(i);t.format==="json"?c(a,"json"):(d(`Contact created: ${a.id}`),c(a,"table"));}catch(e){l(e instanceof Error?e.message:"Failed to create contact"),process.exit(1);}}),n.command("update <id>").description("Update a contact").option("--email <email>","New email address").option("--first-name <name>","First name").option("--last-name <name>","Last name").option("--subscribed","Mark as subscribed").option("--unsubscribed","Mark as unsubscribed").option("--metadata <json>","Metadata as JSON").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),i=new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}),a={};if(e.email&&(a.email=e.email),e.firstName&&(a.first_name=e.firstName),e.lastName&&(a.last_name=e.lastName),e.subscribed&&(a.subscribed=!0),e.unsubscribed&&(a.subscribed=!1),e.metadata)try{a.metadata=JSON.parse(e.metadata);}catch{l("Invalid JSON for --metadata"),process.exit(1);}let r=await i.contacts.update(t,a);e.format==="json"?c(r,"json"):(d(`Contact updated: ${r.id}`),c(r,"table"));}catch(o){l(o instanceof Error?o.message:"Failed to update contact"),process.exit(1);}}),n.command("delete <id>").description("Delete a contact").action(async t=>{try{let e=m();await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).contacts.delete(t),d(`Contact deleted: ${t}`);}catch(e){l(e instanceof Error?e.message:"Failed to delete contact"),process.exit(1);}}),n}function de(){return U.join(G.homedir(),".config","emailr","templates")}function He(){let n=de();E.existsSync(n)||E.mkdirSync(n,{recursive:true});}function J(n){return U.join(de(),`${n}.html`)}function z(n,t){He();let e=J(n);E.writeFileSync(e,t,"utf-8");}function pe(n){let t=J(n);return E.existsSync(t)?E.readFileSync(t,"utf-8"):null}function fe(n){let t=J(n);return E.existsSync(t)}var y=null,T=null,H=false;function ge(n){return n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}function Be(n){return n===null||n.trim()===""}function We(n){return `<!DOCTYPE html>
+Or run: emailr config set api-key <your-api-key>`)}function I(){let i=N.join(W.homedir(),".config","emailr");return N.join(i,"config.json")}function G(i){let t=I(),e=N.dirname(t);v.existsSync(e)||v.mkdirSync(e,{recursive:true});let a={};if(v.existsSync(t))try{a=JSON.parse(v.readFileSync(t,"utf-8"));}catch{}let r={...a,...i};v.writeFileSync(t,JSON.stringify(r,null,2)+`
+`);}function ne(i){try{return m()[i]?.toString()}catch{return}}function c(i,t="table"){t==="json"?console.log(JSON.stringify(i,null,2)):Me(i);}function Me(i){Array.isArray(i)?Le(i):typeof i=="object"&&i!==null?De(i):console.log(i);}function Le(i){if(i.length===0){console.log(S.gray("No results"));return}let t=i[0];if(typeof t!="object"||t===null){i.forEach(r=>console.log(r));return}let e=Object.keys(t),a=new re({head:e.map(r=>S.cyan(r)),style:{head:[],border:[]}});for(let r of i){let o=e.map(n=>{let s=r[n];return se(s)});a.push(o);}console.log(a.toString());}function De(i){let t=new re({style:{head:[],border:[]}});for(let[e,a]of Object.entries(i))t.push([S.cyan(e),se(a)]);console.log(t.toString());}function se(i){return i==null?S.gray("-"):typeof i=="boolean"?i?S.green("\u2713"):S.red("\u2717"):typeof i=="object"?JSON.stringify(i):String(i)}function d(i){console.log(S.green("\u2713"),i);}function l(i){console.error(S.red("\u2717"),i);}function k(i){console.warn(S.yellow("\u26A0"),i);}function u(i){console.log(S.blue("\u2139"),i);}function ce(){return new Command("send").description(`Send an email
+USAGE
+  emailr send --to <email_address> [options]
+DESCRIPTION
+  Send a transactional email to one or more recipients. You can provide
+  email content directly via options, load content from files, or use
+  a pre-defined template with variable substitution.
+OPTIONS
+  --to <email_address>         Recipient email address (required)
+                               Use comma-separated values for multiple recipients
+  --from <email_address>       Sender email address (uses default if not specified)
+  --subject <subject_line>     Email subject line
+  Content Options (choose one approach):
+  --html <html_content>        Inline HTML content for the email body
+  --text <text_content>        Inline plain text content for the email body
+  --html-file <file_path>      Read HTML content from a file
+  --text-file <file_path>      Read plain text content from a file
+  --template <template_id>     Use a pre-defined template by ID
+  --template-data <json>       JSON object with template variable values
+  Additional Recipients:
+  --cc <email_addresses>       CC recipients (comma-separated)
+  --bcc <email_addresses>      BCC recipients (comma-separated)
+  --reply-to <email_address>   Reply-to email address
+  Scheduling:
+  --schedule <datetime>        Schedule send time in ISO 8601 format
+                               Example: 2024-12-25T09:00:00Z
+  Output:
+  --format <format>            Output format: json | table (default: table)
+CONTENT OPTIONS EXPLAINED
+  There are three ways to provide email content:
+  1. Inline Content (--html / --text):
+     Provide content directly on the command line. Best for short content
+     or when content is generated by a script.
+       --html "<h1>Hello</h1><p>Welcome!</p>"
+       --text "Hello, Welcome to our service!"
+  2. File Content (--html-file / --text-file):
+     Read content from local files. Best for longer emails or when you
+     want to edit content in your preferred editor.
+       --html-file ./email.html
+       --text-file ./email.txt
+  3. Template (--template / --template-data):
+     Use a pre-defined template with variable substitution. Best for
+     consistent branding and reusable email designs.
+       --template tmpl_abc123 --template-data '{"name": "John"}'
+  You can combine --html/--html-file with --text/--text-file to provide
+  both HTML and plain text versions. The plain text version is used as
+  a fallback for email clients that don't support HTML.
+TEMPLATE DATA FORMAT
+  The --template-data option accepts a JSON object where keys match
+  the variable names defined in your template.
+  Template with variables {{name}} and {{order_id}}:
+    --template-data '{"name": "John Doe", "order_id": "ORD-12345"}'
+  Complex data with nested objects:
+    --template-data '{"user": {"name": "John", "email": "john@example.com"}, "items": ["Item 1", "Item 2"]}'
+  Using a JSON file (via shell):
+    --template-data "$(cat data.json)"
+OUTPUT FORMATS
+  --format json      Machine-readable JSON with message_id, recipients, status
+  --format table     Human-readable table output (default)
+EXAMPLES
+  # Simple email with inline HTML
+  emailr send --to "user@example.com" \\
+    --subject "Welcome!" \\
+    --html "<h1>Welcome</h1><p>Thanks for signing up!</p>"
+  # Email with plain text fallback
+  emailr send --to "user@example.com" \\
+    --subject "Hello" \\
+    --html "<h1>Hello</h1>" \\
+    --text "Hello (plain text version)"
+  # Email from HTML file
+  emailr send --to "user@example.com" \\
+    --subject "Newsletter" \\
+    --html-file ./newsletter.html \\
+    --text-file ./newsletter.txt
+  # Multiple recipients
+  emailr send --to "user1@example.com,user2@example.com,user3@example.com" \\
+    --subject "Team Update" \\
+    --html-file ./update.html
+  # Using a template with variables
+  emailr send --to "customer@example.com" \\
+    --template tmpl_welcome123 \\
+    --template-data '{"name": "John", "company": "Acme Inc"}'
+  # Template email with complex data
+  emailr send --to "customer@example.com" \\
+    --template tmpl_order_confirm \\
+    --template-data '{"customer_name": "Jane", "order_id": "ORD-789", "total": "$99.99", "items": [{"name": "Widget", "qty": 2}]}'
+  # Email with CC and BCC
+  emailr send --to "primary@example.com" \\
+    --cc "manager@example.com,team@example.com" \\
+    --bcc "archive@example.com" \\
+    --subject "Project Update" \\
+    --html-file ./update.html
+  # Scheduled email
+  emailr send --to "user@example.com" \\
+    --subject "Reminder" \\
+    --html "<p>Don't forget your appointment tomorrow!</p>" \\
+    --schedule "2024-12-25T09:00:00Z"
+  # Custom sender and reply-to
+  emailr send --to "customer@example.com" \\
+    --from "support@mycompany.com" \\
+    --reply-to "help@mycompany.com" \\
+    --subject "Support Response" \\
+    --html-file ./response.html
+  # Get JSON output for scripting
+  emailr send --to "user@example.com" \\
+    --subject "Test" \\
+    --text "Test email" \\
+    --format json
+  # Send and capture message ID
+  emailr send --to "user@example.com" \\
+    --subject "Test" \\
+    --text "Hello" \\
+    --format json | jq -r '.message_id'
+SEE ALSO
+  emailr templates   Manage email templates
+  emailr contacts    Manage contacts
+  emailr broadcasts  Send bulk emails to segments`).requiredOption("--to <email>","Recipient email address (comma-separated for multiple)").option("--from <email>","Sender email address").option("--subject <subject>","Email subject").option("--html <html>","HTML content (inline)").option("--text <text>","Plain text content (inline)").option("--html-file <path>","Read HTML content from file").option("--text-file <path>","Read plain text content from file").option("--template <id>","Template ID to use").option("--template-data <json>","Template data as JSON").option("--cc <emails>","CC recipients (comma-separated)").option("--bcc <emails>","BCC recipients (comma-separated)").option("--reply-to <email>","Reply-to email address").option("--schedule <datetime>","Schedule send time (ISO 8601)").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),a=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),r=t.to.split(",").map(s=>s.trim()),o={to:r.length===1?r[0]:r};if(t.from&&(o.from=t.from),t.subject&&(o.subject=t.subject),t.htmlFile)try{o.html=readFileSync(t.htmlFile,"utf-8");}catch{l(`Failed to read HTML file: ${t.htmlFile}`),process.exit(1);}else t.html&&(o.html=t.html);if(t.textFile)try{o.text=readFileSync(t.textFile,"utf-8");}catch{l(`Failed to read text file: ${t.textFile}`),process.exit(1);}else t.text&&(o.text=t.text);if(t.template&&(o.template_id=t.template),t.templateData)try{o.template_data=JSON.parse(t.templateData);}catch{l("Invalid JSON for --template-data"),process.exit(1);}if(t.cc){let s=t.cc.split(",").map(p=>p.trim());o.cc=s.length===1?s[0]:s;}if(t.bcc){let s=t.bcc.split(",").map(p=>p.trim());o.bcc=s.length===1?s[0]:s;}t.replyTo&&(o.reply_to_email=t.replyTo),t.schedule&&(o.scheduled_at=t.schedule);let n=await a.emails.send(o);t.format==="json"?c(n,"json"):(d("Email sent successfully!"),c({"Message ID":n.message_id,Recipients:n.recipients,Status:n.status,...n.scheduled_at&&{"Scheduled At":n.scheduled_at}},"table"));}catch(e){l(e instanceof Error?e.message:"Failed to send email"),process.exit(1);}})}function me(){let i=new Command("contacts").description(`Manage contacts
+USAGE
+  emailr contacts <subcommand> [options]
+DESCRIPTION
+  Create, update, list, and manage email contacts. Contacts are the recipients
+  of your email campaigns and can be organized into segments for targeted
+  broadcasts.
+SUBCOMMANDS
+  list               List all contacts with pagination and filtering
+  get <id>           Get a contact by ID
+  create             Create a new contact
+  update <id>        Update an existing contact
+  delete <id>        Delete a contact
+OPTIONS
+  --format <format>  Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json      Machine-readable JSON output
+  --format table     Human-readable table output (default)
+PAGINATION OPTIONS
+  --limit <count>    Number of contacts to return (default: 20)
+  --offset <count>   Number of contacts to skip (default: 0)
+FILTER OPTIONS
+  --subscribed       Only show subscribed contacts
+  --unsubscribed     Only show unsubscribed contacts
+METADATA OPTION
+  --metadata <json>  Custom metadata as JSON object
+  The metadata option accepts a JSON object with custom key-value pairs.
+  This allows you to store additional information about contacts.
+  JSON Format Examples:
+    '{"plan": "premium", "source": "website"}'
+    '{"company": "Acme Inc", "role": "developer"}'
+    '{"tags": ["vip", "early-adopter"], "score": 100}'
+EXAMPLES
+  # List all contacts
+  emailr contacts list
+  # List with pagination
+  emailr contacts list --limit 50 --offset 100
+  # List only subscribed contacts
+  emailr contacts list --subscribed
+  # List only unsubscribed contacts
+  emailr contacts list --unsubscribed
+  # Get a specific contact
+  emailr contacts get con_abc123
+  # Create a new contact
+  emailr contacts create --email "user@example.com" --first-name "John" --last-name "Doe"
+  # Create contact with metadata
+  emailr contacts create --email "user@example.com" --metadata '{"plan": "premium"}'
+  # Update a contact
+  emailr contacts update con_abc123 --first-name "Jane"
+  # Update contact subscription status
+  emailr contacts update con_abc123 --unsubscribed
+  # Update contact metadata
+  emailr contacts update con_abc123 --metadata '{"plan": "enterprise", "upgraded": true}'
+  # Delete a contact
+  emailr contacts delete con_abc123
+  # Get JSON output for scripting
+  emailr contacts list --format json
+SEE ALSO
+  emailr segments     Manage contact segments
+  emailr broadcasts   Send emails to contacts`);return i.command("list").description(`List all contacts
+USAGE
+  emailr contacts list [options]
+DESCRIPTION
+  Retrieves a paginated list of all contacts in your account. Supports
+  filtering by subscription status and pagination for large contact lists.
+OPTIONS
+  --limit <count>      Number of contacts to return (default: 20)
+  --offset <count>     Number of contacts to skip for pagination (default: 0)
+  --subscribed         Only show subscribed contacts
+  --unsubscribed       Only show unsubscribed contacts
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Machine-readable JSON with contacts array and total count
+  --format table       Human-readable table with columns: ID, Email, Name, Subscribed, Created
+PAGINATION
+  Use --limit and --offset together for pagination:
+  - Page 1: --limit 20 --offset 0 (default)
+  - Page 2: --limit 20 --offset 20
+  - Page 3: --limit 20 --offset 40
+EXAMPLES
+  # List first 20 contacts (default)
+  emailr contacts list
+  # List 50 contacts
+  emailr contacts list --limit 50
+  # Get page 2 of results (20 per page)
+  emailr contacts list --limit 20 --offset 20
+  # List only subscribed contacts
+  emailr contacts list --subscribed
+  # List only unsubscribed contacts
+  emailr contacts list --unsubscribed
+  # Get JSON output for scripting
+  emailr contacts list --format json
+  # Combine filters with pagination
+  emailr contacts list --subscribed --limit 100 --offset 0`).option("--limit <number>","Number of contacts to return","20").option("--offset <number>","Offset for pagination","0").option("--subscribed","Only show subscribed contacts").option("--unsubscribed","Only show unsubscribed contacts").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),a=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),r={limit:parseInt(t.limit,10),offset:parseInt(t.offset,10)};t.subscribed&&(r.subscribed=!0),t.unsubscribed&&(r.subscribed=!1);let o=await a.contacts.list(r);if(t.format==="json")c(o,"json");else {let n=o.contacts.map(s=>({ID:s.id,Email:s.email,Name:[s.first_name,s.last_name].filter(Boolean).join(" ")||"-",Subscribed:s.subscribed,Created:s.created_at}));c(n,"table"),console.log(`
+Total: ${o.total}`);}}catch(e){l(e instanceof Error?e.message:"Failed to list contacts"),process.exit(1);}}),i.command("get <contact_id>").description(`Get a contact by ID
+USAGE
+  emailr contacts get <contact_id> [options]
+DESCRIPTION
+  Retrieves detailed information about a specific contact including
+  email, name, subscription status, metadata, and timestamps.
+ARGUMENTS
+  <contact_id>         The unique contact identifier (e.g., con_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Full contact object including all fields and metadata
+  --format table       Summary table with key contact information
+EXAMPLES
+  # Get contact details
+  emailr contacts get con_abc123
+  # Get full contact data as JSON
+  emailr contacts get con_abc123 --format json
+  # Pipe JSON to jq for processing
+  emailr contacts get con_abc123 --format json | jq '.metadata'`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).contacts.get(t);c(o,e.format);}catch(a){l(a instanceof Error?a.message:"Failed to get contact"),process.exit(1);}}),i.command("create").description(`Create a new contact
+USAGE
+  emailr contacts create --email <email_address> [options]
+DESCRIPTION
+  Creates a new contact with the specified email address and optional
+  details. Contacts are subscribed by default unless --subscribed is
+  explicitly set to false.
+OPTIONS
+  --email <email_address>    Contact email address (required)
+  --first-name <name>        First name
+  --last-name <name>         Last name
+  --subscribed               Mark as subscribed (default: true)
+  --metadata <json>          Custom metadata as JSON object
+  --format <format>          Output format: json | table (default: table)
+METADATA FORMAT
+  The --metadata option accepts a JSON object with custom key-value pairs:
+    '{"plan": "premium", "source": "website"}'
+    '{"company": "Acme Inc", "role": "developer"}'
+    '{"tags": ["vip", "early-adopter"], "score": 100}'
+OUTPUT FORMATS
+  --format json              Full contact object with all fields
+  --format table             Summary table with ID, Email, Name, Subscribed
+EXAMPLES
+  # Create contact with email only
+  emailr contacts create --email "user@example.com"
+  # Create contact with full name
+  emailr contacts create --email "user@example.com" --first-name "John" --last-name "Doe"
+  # Create contact with metadata
+  emailr contacts create --email "user@example.com" --metadata '{"plan": "premium", "source": "signup"}'
+  # Create unsubscribed contact (for import purposes)
+  emailr contacts create --email "user@example.com" --subscribed false
+  # Get JSON output for scripting
+  emailr contacts create --email "user@example.com" --format json`).requiredOption("--email <email>","Contact email address").option("--first-name <name>","First name").option("--last-name <name>","Last name").option("--subscribed","Mark as subscribed (default: true)").option("--metadata <json>","Metadata as JSON").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),a=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),r={email:t.email};if(t.firstName&&(r.first_name=t.firstName),t.lastName&&(r.last_name=t.lastName),t.subscribed!==void 0&&(r.subscribed=t.subscribed),t.metadata)try{r.metadata=JSON.parse(t.metadata);}catch{l("Invalid JSON for --metadata"),process.exit(1);}let o=await a.contacts.create(r);t.format==="json"?c(o,"json"):(d(`Contact created: ${o.id}`),c(o,"table"));}catch(e){l(e instanceof Error?e.message:"Failed to create contact"),process.exit(1);}}),i.command("update <contact_id>").description(`Update a contact
+USAGE
+  emailr contacts update <contact_id> [options]
+DESCRIPTION
+  Updates an existing contact with new values. Only specified fields
+  are updated; omitted fields remain unchanged.
+ARGUMENTS
+  <contact_id>               The unique contact identifier (e.g., con_abc123)
+OPTIONS
+  --email <email_address>    New email address
+  --first-name <name>        New first name
+  --last-name <name>         New last name
+  --subscribed               Mark as subscribed
+  --unsubscribed             Mark as unsubscribed
+  --metadata <json>          New metadata as JSON object (replaces existing)
+  --format <format>          Output format: json | table (default: table)
+METADATA FORMAT
+  The --metadata option accepts a JSON object. Note that this replaces
+  the entire metadata object, not individual fields:
+    '{"plan": "enterprise", "upgraded": true}'
+    '{"tags": ["vip"], "notes": "Important customer"}'
+OUTPUT FORMATS
+  --format json              Full updated contact object
+  --format table             Summary table with updated contact information
+EXAMPLES
+  # Update contact name
+  emailr contacts update con_abc123 --first-name "Jane" --last-name "Smith"
+  # Update email address
+  emailr contacts update con_abc123 --email "newemail@example.com"
+  # Unsubscribe a contact
+  emailr contacts update con_abc123 --unsubscribed
+  # Resubscribe a contact
+  emailr contacts update con_abc123 --subscribed
+  # Update metadata
+  emailr contacts update con_abc123 --metadata '{"plan": "enterprise", "upgraded": true}'
+  # Get JSON output
+  emailr contacts update con_abc123 --first-name "Jane" --format json`).option("--email <email>","New email address").option("--first-name <name>","First name").option("--last-name <name>","Last name").option("--subscribed","Mark as subscribed").option("--unsubscribed","Mark as unsubscribed").option("--metadata <json>","Metadata as JSON").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),r=new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}),o={};if(e.email&&(o.email=e.email),e.firstName&&(o.first_name=e.firstName),e.lastName&&(o.last_name=e.lastName),e.subscribed&&(o.subscribed=!0),e.unsubscribed&&(o.subscribed=!1),e.metadata)try{o.metadata=JSON.parse(e.metadata);}catch{l("Invalid JSON for --metadata"),process.exit(1);}let n=await r.contacts.update(t,o);e.format==="json"?c(n,"json"):(d(`Contact updated: ${n.id}`),c(n,"table"));}catch(a){l(a instanceof Error?a.message:"Failed to update contact"),process.exit(1);}}),i.command("delete <contact_id>").description(`Delete a contact
+USAGE
+  emailr contacts delete <contact_id>
+DESCRIPTION
+  Permanently deletes a contact. This action cannot be undone.
+  The contact will be removed from all segments.
+ARGUMENTS
+  <contact_id>         The unique contact identifier (e.g., con_abc123)
+EXAMPLES
+  # Delete a contact
+  emailr contacts delete con_abc123
+WARNING
+  This action is permanent and cannot be undone.`).action(async t=>{try{let e=m();await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).contacts.delete(t),d(`Contact deleted: ${t}`);}catch(e){l(e instanceof Error?e.message:"Failed to delete contact"),process.exit(1);}}),i}function pe(){return N.join(W.homedir(),".config","emailr","templates")}function qe(){let i=pe();v.existsSync(i)||v.mkdirSync(i,{recursive:true});}function B(i){return N.join(pe(),`${i}.html`)}function X(i,t){qe();let e=B(i);v.writeFileSync(e,t,"utf-8");}function ue(i){let t=B(i);return v.existsSync(t)?v.readFileSync(t,"utf-8"):null}function fe(i){let t=B(i);return v.existsSync(t)}var w=null,C=null,H=false;function he(i){return i.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}function $e(i){return i===null||i.trim()===""}function We(i){return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
@@ -75,14 +485,14 @@ Total: ${a.total}`);}}catch(e){l(e instanceof Error?e.message:"Failed to list co
     <div class="icon">\u{1F4ED}</div>
     <h1>No Content Available</h1>
     <p>This template exists but has no HTML content to display.</p>
-    <div class="template-id">${ge(n)}</div>
+    <div class="template-id">${he(i)}</div>
     <div class="hint">
       <p><strong>To add content:</strong></p>
       <p>Update the template using the CLI with the <code>--html</code> option or provide HTML content when creating the template.</p>
     </div>
   </div>
 </body>
-</html>`}function ue(n){return `<!DOCTYPE html>
+</html>`}function be(i){return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
@@ -134,11 +544,11 @@ Total: ${a.total}`);}}catch(e){l(e instanceof Error?e.message:"Failed to list co
     <div class="icon">404</div>
     <h1>Template Not Found</h1>
     <p>The requested template could not be found in local storage.</p>
-    <div class="template-id">${ge(n)}</div>
+    <div class="template-id">${he(i)}</div>
     <p style="margin-top: 1rem;">Try creating or retrieving the template first using the CLI.</p>
   </div>
 </body>
-</html>`}function Ge(n){let t=n.match(/^\/preview\/([^/]+)$/);return t?t[1]:null}function Je(){return (n,t)=>{if(n.method!=="GET"){t.writeHead(405,{"Content-Type":"text/plain"}),t.end("Method Not Allowed");return}let e=n.url||"/",o=Ge(e);if(!o){t.writeHead(404,{"Content-Type":"text/plain"}),t.end("Not Found");return}if(!fe(o)){t.writeHead(404,{"Content-Type":"text/html; charset=utf-8"}),t.end(ue(o));return}let i=pe(o);if(i===null){t.writeHead(404,{"Content-Type":"text/html; charset=utf-8"}),t.end(ue(o));return}if(Be(i)){t.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),t.end(We(o));return}t.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),t.end(i);}}var be={async start(){return H&&T!==null?T:new Promise((n,t)=>{y=qe.createServer(Je()),y.listen(0,"127.0.0.1",()=>{let e=y.address();e&&typeof e=="object"?(T=e.port,H=true,y.unref(),n(T)):t(new Error("Failed to get server address"));}),y.on("error",e=>{H=false,T=null,y=null,t(new Error(`Failed to start preview server: ${e.message}`));});})},getPort(){return T},isRunning(){return H},async stop(){if(y)return new Promise(n=>{y.close(()=>{y=null,T=null,H=false,n();});})}};function he(){return be}async function V(n){try{return `http://127.0.0.1:${await be.start()}/preview/${n}`}catch{return null}}function ye(){y&&y.ref();}var P=null,Y=null,B=null,L=[],ve=`
+</html>`}function Be(i){let t=i.match(/^\/preview\/([^/]+)$/);return t?t[1]:null}function Xe(){return (i,t)=>{if(i.method!=="GET"){t.writeHead(405,{"Content-Type":"text/plain"}),t.end("Method Not Allowed");return}let e=i.url||"/",a=Be(e);if(!a){t.writeHead(404,{"Content-Type":"text/plain"}),t.end("Not Found");return}if(!fe(a)){t.writeHead(404,{"Content-Type":"text/html; charset=utf-8"}),t.end(be(a));return}let r=ue(a);if(r===null){t.writeHead(404,{"Content-Type":"text/html; charset=utf-8"}),t.end(be(a));return}if($e(r)){t.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),t.end(We(a));return}t.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),t.end(r);}}var ge={async start(){return H&&C!==null?C:new Promise((i,t)=>{w=Je.createServer(Xe()),w.listen(0,"127.0.0.1",()=>{let e=w.address();e&&typeof e=="object"?(C=e.port,H=true,w.unref(),i(C)):t(new Error("Failed to get server address"));}),w.on("error",e=>{H=false,C=null,w=null,t(new Error(`Failed to start preview server: ${e.message}`));});})},getPort(){return C},isRunning(){return H},async stop(){if(w)return new Promise(i=>{w.close(()=>{w=null,C=null,H=false,i();});})}};function we(){return ge}async function V(i){try{return `http://127.0.0.1:${await ge.start()}/preview/${i}`}catch{return null}}function ye(){w&&w.ref();}var A=null,z=null,J=null,R=[],ve=`
 <script>
 (function() {
   const evtSource = new EventSource('/__live-reload');
@@ -152,31 +562,369 @@ Total: ${a.total}`);}}catch(e){l(e instanceof Error?e.message:"Failed to list co
   };
 })();
 </script>
-`;function Ye(n){return n.includes("</body>")?n.replace("</body>",`${ve}</body>`):n+ve}function Qe(){L.forEach(n=>{try{n.write(`data: reload
+`;function Ye(i){return i.includes("</body>")?i.replace("</body>",`${ve}</body>`):i+ve}function Ze(){R.forEach(i=>{try{i.write(`data: reload
+`);}catch{}});}async function Y(i,t){let e=N.resolve(i);return new Promise((a,r)=>{A=Je.createServer((o,n)=>{if(o.url==="/__live-reload"){n.writeHead(200,{"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive","Access-Control-Allow-Origin":"*"}),n.write(`data: connected
+`),R.push(n),o.on("close",()=>{R=R.filter(s=>s!==n);});return}if(o.method==="GET"){try{let s=v.readFileSync(e,"utf-8"),p=Ye(s);n.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),n.end(p);}catch(s){n.writeHead(500,{"Content-Type":"text/plain"}),n.end(`Error reading file: ${s instanceof Error?s.message:String(s)}`);}return}n.writeHead(405,{"Content-Type":"text/plain"}),n.end("Method Not Allowed");}),A.listen(0,"127.0.0.1",()=>{let o=A.address();if(o&&typeof o=="object"){z=o.port;let n=null;J=v.watch(e,s=>{s==="change"&&(n&&clearTimeout(n),n=setTimeout(()=>{Ze(),t?.();},100));}),a(z);}else r(new Error("Failed to get server address"));}),A.on("error",o=>{r(new Error(`Failed to start server: ${o.message}`));});})}async function Z(){if(J&&(J.close(),J=null),R.forEach(i=>{try{i.end();}catch{}}),R=[],A)return new Promise(i=>{A.close(()=>{A=null,z=null,i();});})}async function Te(i){try{let t=i.html_content??"";X(i.id,t);}catch(t){return k(`Could not save template for preview: ${t instanceof Error?t.message:String(t)}`),null}try{let t=await V(i.id);return t===null?(k("Could not start preview server"),null):t}catch(t){return k(`Could not generate preview URL: ${t instanceof Error?t.message:String(t)}`),null}}function Oe(){let i=new Command("templates").description(`Manage email templates
+USAGE
+  emailr templates <subcommand> [options]
+DESCRIPTION
+  Create, edit, preview, and publish email templates. Supports both local
+  live-preview editing and server-side preview URLs for sharing with AI agents.
+SUBCOMMANDS
+  list               List all templates
+  get <id>           Get a template by ID
+  create             Create a new template
+  update <id>        Update an existing template
+  delete <id>        Delete a template
+  fetch <id>         Download template HTML to file or stdout
+  push-preview <id>  Upload HTML to template's preview for sharing
+  preview <id>       Preview a template in the browser
+  edit <id>          Start live editing session with hot-reload
+  draft              Start live drafting session for new template
+  stop-preview       Stop any running background preview server
+OUTPUT FORMATS
+  --format json      Machine-readable JSON output
+  --format table     Human-readable table output (default)
+EXAMPLES
+  # List all templates
+  emailr templates list
+  # Get a specific template
+  emailr templates get tpl_abc123
+  # Create a template from file
+  emailr templates create --name "Welcome" --subject "Welcome!" --html-file welcome.html
+  # Update a template
+  emailr templates update tpl_abc123 --subject "New Subject"
+  # Download template HTML to a file
+  emailr templates fetch tpl_abc123 --output template.html
+  # Push preview for AI agent review
+  emailr templates push-preview tpl_abc123 --html-file template.html
+  # Start live editing with hot-reload
+  emailr templates edit tpl_abc123 --file ./template.html
+  # Draft a new template with live preview
+  emailr templates draft --file ./new-template.html
+AGENTIC WORKFLOW
+  For collaborating with AI agents on template design:
+  1. Fetch current template:
+     emailr templates fetch <id> --output template.html
+  2. Edit locally or with AI assistance
+  3. Push preview for AI review:
+     emailr templates push-preview <id> --html-file template.html
+  4. Share the preview URL with your AI agent for feedback
+  5. Repeat steps 2-4 until satisfied
+  6. Publish the final version:
+     emailr templates update <id> --html-file template.html
+SEE ALSO
+  emailr send         Send emails using templates
+  emailr broadcasts   Send bulk emails to segments`);return i.command("list").description(`List all templates
+USAGE
+  emailr templates list [options]
+DESCRIPTION
+  Retrieves a paginated list of all email templates in your account.
+  Returns template ID, name, subject, variables, and creation date.
+OPTIONS
+  --limit <count>      Number of templates to return (default: 20)
+  --page <page_number> Page number for pagination (default: 1)
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Machine-readable JSON array of template objects
+  --format table       Human-readable table with columns: ID, Name, Subject, Variables, Created
-`);}catch{}});}async function Q(n,t){let e=U.resolve(n);return new Promise((o,i)=>{P=qe.createServer((a,r)=>{if(a.url==="/__live-reload"){r.writeHead(200,{"Content-Type":"text/event-stream","Cache-Control":"no-cache",Connection:"keep-alive","Access-Control-Allow-Origin":"*"}),r.write(`data: connected
+EXAMPLES
+  # List first 20 templates
+  emailr templates list
-`),L.push(r),a.on("close",()=>{L=L.filter(s=>s!==r);});return}if(a.method==="GET"){try{let s=E.readFileSync(e,"utf-8"),f=Ye(s);r.writeHead(200,{"Content-Type":"text/html; charset=utf-8"}),r.end(f);}catch(s){r.writeHead(500,{"Content-Type":"text/plain"}),r.end(`Error reading file: ${s instanceof Error?s.message:String(s)}`);}return}r.writeHead(405,{"Content-Type":"text/plain"}),r.end("Method Not Allowed");}),P.listen(0,"127.0.0.1",()=>{let a=P.address();if(a&&typeof a=="object"){Y=a.port;let r=null;B=E.watch(e,s=>{s==="change"&&(r&&clearTimeout(r),r=setTimeout(()=>{Qe(),t?.();},100));}),o(Y);}else i(new Error("Failed to get server address"));}),P.on("error",a=>{i(new Error(`Failed to start server: ${a.message}`));});})}async function X(){if(B&&(B.close(),B=null),L.forEach(n=>{try{n.end();}catch{}}),L=[],P)return new Promise(n=>{P.close(()=>{P=null,Y=null,n();});})}async function xe(n){try{let t=n.html_content??"";z(n.id,t);}catch(t){return k(`Could not save template for preview: ${t instanceof Error?t.message:String(t)}`),null}try{let t=await V(n.id);return t===null?(k("Could not start preview server"),null):t}catch(t){return k(`Could not generate preview URL: ${t instanceof Error?t.message:String(t)}`),null}}function Se(){let n=new Command("templates").description(`Manage email templates
+  # List 50 templates
+  emailr templates list --limit 50
-AGENTIC LIVE EDITING:
-  draft              Create new template with live preview
-  edit <id>          Edit existing template with live preview
+  # Get page 2 of results
+  emailr templates list --page 2 --limit 10
-Both commands save HTML to a local file and start a hot-reload server.
-Edit the file and see changes instantly in the browser.`);return n.command("list").description("List all templates").option("--limit <number>","Number of templates to return","20").option("--page <number>","Page number","1").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),i=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).templates.list({limit:parseInt(t.limit,10),page:parseInt(t.page,10)});if(t.format==="json")c(i,"json");else {let a=i.map(r=>({ID:r.id,Name:r.name,Subject:r.subject,Variables:r.variables?.join(", ")||"-",Created:r.created_at}));c(a,"table"),console.log(`
-Total: ${i.length}`);}}catch(e){l(e instanceof Error?e.message:"Failed to list templates"),process.exit(1);}}),n.command("get <id>").description("Get a template by ID").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).templates.get(t),r=await xe({id:a.id,html_content:a.html_content??void 0});if(e.format==="json")c({...a,preview_url:r},"json");else {let s={ID:a.id,Name:a.name,Subject:a.subject,Variables:a.variables?.join(", ")||"-",Created:a.created_at};r&&(s["Preview URL"]=r),c(s,"table");}}catch(o){l(o instanceof Error?o.message:"Failed to get template"),process.exit(1);}}),n.command("create").description(`Create a new template
+  # Get JSON output for scripting
+  emailr templates list --format json`).option("--limit <count>","Number of templates to return","20").option("--page <page_number>","Page number for pagination","1").option("--format <format>","Output format: json | table","table").action(async t=>{try{let e=m(),r=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).templates.list({limit:parseInt(t.limit,10),page:parseInt(t.page,10)});if(t.format==="json")c(r,"json");else {let o=r.map(n=>({ID:n.id,Name:n.name,Subject:n.subject,Variables:n.variables?.join(", ")||"-",Created:n.created_at}));c(o,"table"),console.log(`
+Total: ${r.length}`);}}catch(e){l(e instanceof Error?e.message:"Failed to list templates"),process.exit(1);}}),i.command("get <template_id>").description(`Get a template by ID
-TIP: For live preview while building, use "emailr templates draft" first.
-It creates a local file with hot-reload preview, then use this command to save.`).requiredOption("--name <name>","Template name").requiredOption("--subject <subject>","Email subject").option("--html <html>","HTML content").option("--text <text>","Plain text content").option("--html-file <path>","Read HTML content from file").option("--text-file <path>","Read text content from file").option("--from <email>","Default from email").option("--reply-to <email>","Default reply-to email").option("--preview-text <text>","Preview text").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),o=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),i={name:t.name,subject:t.subject};if(t.htmlFile){let s=await import('fs');i.html_content=s.readFileSync(t.htmlFile,"utf-8");}else t.html&&(i.html_content=t.html);if(t.textFile){let s=await import('fs');i.text_content=s.readFileSync(t.textFile,"utf-8");}else t.text&&(i.text_content=t.text);t.from&&(i.from_email=t.from),t.replyTo&&(i.reply_to=t.replyTo),t.previewText&&(i.preview_text=t.previewText);let a=await o.templates.create(i),r=await xe({id:a.id,html_content:a.html_content??void 0});if(t.format==="json")c({...a,preview_url:r},"json");else {d(`Template created: ${a.id}`);let s={ID:a.id,Name:a.name,Subject:a.subject,Variables:a.variables?.join(", ")||"-"};r&&(s["Preview URL"]=r),c(s,"table"),r&&console.log(`
-Open the Preview URL in your browser to view the rendered template.`);}}catch(e){l(e instanceof Error?e.message:"Failed to create template"),process.exit(1);}}),n.command("update <id>").description(`Update a template
+USAGE
+  emailr templates get <template_id> [options]
-TIP: For live preview while editing, use "emailr templates edit <id>" first.
-It downloads the template with hot-reload preview, then use this command to save.`).option("--name <name>","Template name").option("--subject <subject>","Email subject").option("--html <html>","HTML content").option("--text <text>","Plain text content").option("--html-file <path>","Read HTML content from file").option("--text-file <path>","Read text content from file").option("--from <email>","Default from email").option("--reply-to <email>","Default reply-to email").option("--preview-text <text>","Preview text").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),i=new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}),a={};if(e.name&&(a.name=e.name),e.subject&&(a.subject=e.subject),e.htmlFile){let s=await import('fs');a.html_content=s.readFileSync(e.htmlFile,"utf-8");}else e.html&&(a.html_content=e.html);if(e.textFile){let s=await import('fs');a.text_content=s.readFileSync(e.textFile,"utf-8");}else e.text&&(a.text_content=e.text);e.from&&(a.from_email=e.from),e.replyTo&&(a.reply_to=e.replyTo),e.previewText&&(a.preview_text=e.previewText);let r=await i.templates.update(t,a);if(e.format==="json")c(r,"json");else {d(`Template updated: ${r.id}`);let s={ID:r.id,Name:r.name,Subject:r.subject,Variables:r.variables?.join(", ")||"-",Updated:r.updated_at};c(s,"table");}}catch(o){l(o instanceof Error?o.message:"Failed to update template"),process.exit(1);}}),n.command("delete <id>").description("Delete a template").action(async t=>{try{let e=m();await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).templates.delete(t),d(`Template deleted: ${t}`);}catch(e){l(e instanceof Error?e.message:"Failed to delete template"),process.exit(1);}}),n.command("preview <id>").description("Preview a template in the browser").option("--no-open","Do not automatically open browser").option("--foreground","Keep process running in foreground (blocks terminal)").action(async(t,e)=>{try{let o=m(),i=new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl});console.log(`Fetching template ${t}...`);let a=await i.templates.get(t),r=a.html_content??"";if(z(a.id,r),e.foreground){let u=await V(a.id);if(u||(l("Failed to start preview server"),process.exit(1)),ye(),console.log(`
-Template: ${a.name}`),console.log(`Preview URL: ${u}`),e.open!==!1)try{await(await import('open')).default(u),console.log(`
+DESCRIPTION
+  Retrieves detailed information about a specific template including
+  its HTML content, subject, variables, and preview URL if available.
+  Also starts a local preview server for viewing the template.
+ARGUMENTS
+  <template_id>        The unique template identifier (e.g., tpl_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Full template object including html_content and preview_url
+  --format table       Summary table with ID, Name, Subject, Variables, Created, Preview URL
+EXAMPLES
+  # Get template details
+  emailr templates get tpl_abc123
+  # Get full template data as JSON
+  emailr templates get tpl_abc123 --format json
+  # Pipe JSON to jq for processing
+  emailr templates get tpl_abc123 --format json | jq '.html_content'`).option("--format <format>","Output format: json | table","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).templates.get(t),n=await Te({id:o.id,html_content:o.html_content??void 0}),s=o.preview_html?`${a.baseUrl}/preview/${o.id}`:null;if(e.format==="json")c({...o,preview_url:s??n},"json");else {let p={ID:o.id,Name:o.name,Subject:o.subject,Variables:o.variables?.join(", ")||"-",Created:o.created_at};s?p["Preview URL"]=s:n&&(p["Local Preview"]=n),c(p,"table");}}catch(a){l(a instanceof Error?a.message:"Failed to get template"),process.exit(1);}}),i.command("fetch <template_id>").description(`Download template HTML to file or stdout
+USAGE
+  emailr templates fetch <template_id> [options]
+DESCRIPTION
+  Downloads the HTML content of a template to a local file or prints
+  it to stdout. Use this to get a local copy for editing before
+  pushing a preview or updating the template.
+ARGUMENTS
+  <template_id>        The unique template identifier (e.g., tpl_abc123)
+OPTIONS
+  --output <file_path> Write HTML to specified file (default: print to stdout)
+  --preview            Fetch preview HTML instead of published HTML
+EXAMPLES
+  # Print HTML to stdout
+  emailr templates fetch tpl_abc123
+  # Save to file for editing
+  emailr templates fetch tpl_abc123 --output template.html
+  # Fetch preview HTML instead of published
+  emailr templates fetch tpl_abc123 --preview --output preview.html
+  # Pipe to another command
+  emailr templates fetch tpl_abc123 | grep "{{.*}}"
+AGENTIC WORKFLOW
+  This is step 1 of the agentic workflow:
+  1. Fetch: emailr templates fetch <id> --output template.html
+  2. Edit locally or with AI assistance
+  3. Push preview: emailr templates push-preview <id> --html-file template.html`).option("--output <file_path>","Write HTML to file (default: stdout)").option("--preview","Fetch preview HTML instead of published HTML").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).templates.fetch(t,{preview:e.preview??!1});if(o||(e.preview?(l("No preview HTML exists for this template"),console.log(`
+Run 'emailr templates push-preview <id> --html-file <path>' to create a preview.`)):l("Template has no HTML content"),process.exit(1)),e.output){let n=N.resolve(e.output);v.writeFileSync(n,o,"utf-8"),d(`HTML saved to: ${n}`);}else console.log(o);}catch(a){l(a instanceof Error?a.message:"Failed to fetch template"),process.exit(1);}}),i.command("push-preview <template_id>").description(`Upload HTML to template's preview for sharing with AI agents
+USAGE
+  emailr templates push-preview <template_id> --html-file <file_path>
+  emailr templates push-preview <template_id> --html <html_content>
+DESCRIPTION
+  Uploads HTML content to a template's preview slot. The preview is
+  accessible via a public URL that can be shared with AI agents for
+  review and feedback. The preview persists until the template is
+  published or a new preview is pushed.
+ARGUMENTS
+  <template_id>              The unique template identifier (e.g., tpl_abc123)
+OPTIONS
+  --html-file <file_path>    Read HTML content from specified file
+  --html <html_content>      Inline HTML content string
+  --format <format>          Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json              Returns: { template_id, preview_url, status }
+  --format table             Human-readable table with Template ID, Preview URL, Status
+EXAMPLES
+  # Push preview from file
+  emailr templates push-preview tpl_abc123 --html-file template.html
+  # Push preview with inline HTML
+  emailr templates push-preview tpl_abc123 --html "<h1>Hello {{name}}</h1>"
+  # Get JSON output for scripting
+  emailr templates push-preview tpl_abc123 --html-file template.html --format json
+  # Extract just the preview URL
+  emailr templates push-preview tpl_abc123 --html-file template.html --format json | jq -r '.preview_url'
+AGENTIC WORKFLOW
+  This is step 3 of the agentic workflow:
+  1. Fetch: emailr templates fetch <id> --output template.html
+  2. Edit locally or with AI assistance
+  3. Push preview: emailr templates push-preview <id> --html-file template.html
+  4. Share the preview URL with your AI agent for feedback
+  5. Repeat steps 2-4 until satisfied`).option("--html-file <file_path>","Read HTML content from file").option("--html <html_content>","Inline HTML content").option("--format <format>","Output format: json | table","table").action(async(t,e)=>{try{!e.htmlFile&&!e.html&&(l("Either --html-file or --html is required"),console.log(`
+Usage:`),console.log("  emailr templates push-preview <id> --html-file <path>"),console.log("  emailr templates push-preview <id> --html <content>"),process.exit(1)),e.htmlFile&&e.html&&(l("Cannot use both --html-file and --html. Choose one."),process.exit(1));let a=m(),r=new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}),o;if(e.htmlFile){let p=N.resolve(e.htmlFile);try{o=v.readFileSync(p,"utf-8");}catch{l(`Failed to read file: ${p}`),process.exit(1);}}else o=e.html;let n=await r.templates.pushPreview(t,o),s="updated";e.format==="json"?c({template_id:t,preview_url:n.preview_url,status:s},"json"):(d("Preview uploaded successfully"),c({"Template ID":t,"Preview URL":n.preview_url,Status:s},"table"),console.log(`
+Share this URL with your AI agent for feedback.`));}catch(a){l(a instanceof Error?a.message:"Failed to push preview"),process.exit(1);}}),i.command("create").description(`Create a new email template
+USAGE
+  emailr templates create --name <template_name> --subject <subject_line> [options]
+DESCRIPTION
+  Creates a new email template with the specified name, subject, and content.
+  HTML content can be provided inline or from a file. After creation, a local
+  preview URL is generated for viewing the template.
+OPTIONS
+  --name <template_name>       Template name (required)
+  --subject <subject_line>     Email subject line (required)
+  --html <html_content>        Inline HTML content
+  --text <text_content>        Plain text content
+  --html-file <file_path>      Read HTML content from file
+  --text-file <file_path>      Read text content from file
+  --from <email_address>       Default from email address
+  --reply-to <email_address>   Default reply-to email address
+  --preview-text <text>        Preview text shown in email clients
+  --format <format>            Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json                Full template object with preview_url
+  --format table               Summary table with ID, Name, Subject, Variables, Preview URL
+EXAMPLES
+  # Create template with inline HTML
+  emailr templates create --name "Welcome" --subject "Welcome to {{company}}!" \\
+    --html "<h1>Hello {{name}}</h1>"
+  # Create template from file
+  emailr templates create --name "Newsletter" --subject "Weekly Update" \\
+    --html-file newsletter.html
+  # Create with all options
+  emailr templates create --name "Order Confirmation" --subject "Order #{{order_id}}" \\
+    --html-file order.html --text-file order.txt \\
+    --from "orders@example.com" --reply-to "support@example.com"
+  # Get JSON output for scripting
+  emailr templates create --name "Test" --subject "Test" --html "<p>Test</p>" --format json
+TIP
+  For live preview while building, use "emailr templates draft" first.
+  It creates a local file with hot-reload preview, then use this command to save.`).requiredOption("--name <template_name>","Template name").requiredOption("--subject <subject_line>","Email subject line").option("--html <html_content>","Inline HTML content").option("--text <text_content>","Plain text content").option("--html-file <file_path>","Read HTML content from file").option("--text-file <file_path>","Read text content from file").option("--from <email_address>","Default from email address").option("--reply-to <email_address>","Default reply-to email address").option("--preview-text <text>","Preview text shown in email clients").option("--format <format>","Output format: json | table","table").action(async t=>{try{let e=m(),a=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),r={name:t.name,subject:t.subject};if(t.htmlFile){let s=await import('fs');r.html_content=s.readFileSync(t.htmlFile,"utf-8");}else t.html&&(r.html_content=t.html);if(t.textFile){let s=await import('fs');r.text_content=s.readFileSync(t.textFile,"utf-8");}else t.text&&(r.text_content=t.text);t.from&&(r.from_email=t.from),t.replyTo&&(r.reply_to=t.replyTo),t.previewText&&(r.preview_text=t.previewText);let o=await a.templates.create(r),n=await Te({id:o.id,html_content:o.html_content??void 0});if(t.format==="json")c({...o,preview_url:n},"json");else {d(`Template created: ${o.id}`);let s={ID:o.id,Name:o.name,Subject:o.subject,Variables:o.variables?.join(", ")||"-"};n&&(s["Preview URL"]=n),c(s,"table"),n&&console.log(`
+Open the Preview URL in your browser to view the rendered template.`);}}catch(e){l(e instanceof Error?e.message:"Failed to create template"),process.exit(1);}}),i.command("update <template_id>").description(`Update an existing email template
+USAGE
+  emailr templates update <template_id> [options]
+DESCRIPTION
+  Updates an existing template with new values. Only specified fields
+  are updated; omitted fields remain unchanged. Use this to publish
+  changes after editing with the agentic workflow.
+ARGUMENTS
+  <template_id>                The unique template identifier (e.g., tpl_abc123)
+OPTIONS
+  --name <template_name>       New template name
+  --subject <subject_line>     New email subject line
+  --html <html_content>        New inline HTML content
+  --text <text_content>        New plain text content
+  --html-file <file_path>      Read new HTML content from file
+  --text-file <file_path>      Read new text content from file
+  --from <email_address>       New default from email address
+  --reply-to <email_address>   New default reply-to email address
+  --preview-text <text>        New preview text
+  --format <format>            Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json                Full updated template object
+  --format table               Summary table with ID, Name, Subject, Variables, Updated
+EXAMPLES
+  # Update subject line
+  emailr templates update tpl_abc123 --subject "New Subject Line"
+  # Update HTML from file (publish after editing)
+  emailr templates update tpl_abc123 --html-file template.html
+  # Update multiple fields
+  emailr templates update tpl_abc123 --name "Updated Name" --subject "Updated Subject"
+  # Get JSON output
+  emailr templates update tpl_abc123 --subject "Test" --format json
+TIP
+  For live preview while editing, use "emailr templates edit <id>" first.
+  It downloads the template with hot-reload preview, then use this command to save.
+AGENTIC WORKFLOW
+  This is the final step of the agentic workflow:
+  1. Fetch: emailr templates fetch <id> --output template.html
+  2. Edit locally or with AI assistance
+  3. Push preview: emailr templates push-preview <id> --html-file template.html
+  4. Share URL with AI agent, iterate on feedback
+  5. Publish: emailr templates update <id> --html-file template.html`).option("--name <template_name>","New template name").option("--subject <subject_line>","New email subject line").option("--html <html_content>","New inline HTML content").option("--text <text_content>","New plain text content").option("--html-file <file_path>","Read new HTML content from file").option("--text-file <file_path>","Read new text content from file").option("--from <email_address>","New default from email address").option("--reply-to <email_address>","New default reply-to email address").option("--preview-text <text>","New preview text").option("--format <format>","Output format: json | table","table").action(async(t,e)=>{try{let a=m(),r=new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}),o={};if(e.name&&(o.name=e.name),e.subject&&(o.subject=e.subject),e.htmlFile){let s=await import('fs');o.html_content=s.readFileSync(e.htmlFile,"utf-8");}else e.html&&(o.html_content=e.html);if(e.textFile){let s=await import('fs');o.text_content=s.readFileSync(e.textFile,"utf-8");}else e.text&&(o.text_content=e.text);e.from&&(o.from_email=e.from),e.replyTo&&(o.reply_to=e.replyTo),e.previewText&&(o.preview_text=e.previewText);let n=await r.templates.update(t,o);if(e.format==="json")c(n,"json");else {d(`Template updated: ${n.id}`);let s={ID:n.id,Name:n.name,Subject:n.subject,Variables:n.variables?.join(", ")||"-",Updated:n.updated_at};c(s,"table");}}catch(a){l(a instanceof Error?a.message:"Failed to update template"),process.exit(1);}}),i.command("delete <template_id>").description(`Delete a template
+USAGE
+  emailr templates delete <template_id>
+DESCRIPTION
+  Permanently deletes a template. This action cannot be undone.
+  Any broadcasts or automations using this template will fail.
+ARGUMENTS
+  <template_id>        The unique template identifier (e.g., tpl_abc123)
+EXAMPLES
+  # Delete a template
+  emailr templates delete tpl_abc123
+WARNING
+  This action is permanent and cannot be undone.`).action(async t=>{try{let e=m();await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).templates.delete(t),d(`Template deleted: ${t}`);}catch(e){l(e instanceof Error?e.message:"Failed to delete template"),process.exit(1);}}),i.command("preview <template_id>").description(`Preview a template in the browser
+USAGE
+  emailr templates preview <template_id> [options]
+DESCRIPTION
+  Opens a template preview in your default browser. By default, runs
+  a background server that serves the template HTML. Use --foreground
+  to keep the process running in the terminal.
+ARGUMENTS
+  <template_id>        The unique template identifier (e.g., tpl_abc123)
+OPTIONS
+  --no-open            Do not automatically open browser
+  --foreground         Keep process running in foreground (blocks terminal)
+EXAMPLES
+  # Preview template in browser
+  emailr templates preview tpl_abc123
+  # Preview without opening browser (just get URL)
+  emailr templates preview tpl_abc123 --no-open
+  # Run in foreground (Ctrl+C to stop)
+  emailr templates preview tpl_abc123 --foreground
+SEE ALSO
+  emailr templates edit         Live editing with hot-reload
+  emailr templates stop-preview Stop background preview server`).option("--no-open","Do not automatically open browser").option("--foreground","Keep process running in foreground (blocks terminal)").action(async(t,e)=>{try{let a=m(),r=new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl});console.log(`Fetching template ${t}...`);let o=await r.templates.get(t),n=o.html_content??"";if(X(o.id,n),e.foreground){let f=await V(o.id);if(f||(l("Failed to start preview server"),process.exit(1)),ye(),console.log(`
+Template: ${o.name}`),console.log(`Preview URL: ${f}`),e.open!==!1)try{await(await import('open')).default(f),console.log(`
 Browser opened.`);}catch{console.log(`
 Could not open browser automatically. Open the URL above manually.`);}process.on("SIGINT",async()=>{console.log(`
-Stopping preview server...`),await he().stop(),console.log("Done."),process.exit(0);});return}let s=U.join(process.cwd(),`.template-preview-${a.id}.html`);E.writeFileSync(s,r,"utf-8");let{spawn:f}=await import('child_process'),g=await import('os'),x=U.join(g.tmpdir(),"emailr-preview.pid");try{let u=E.readFileSync(x,"utf-8").trim();process.kill(parseInt(u,10),"SIGTERM");}catch{}let b=`
+Stopping preview server...`),await we().stop(),console.log("Done."),process.exit(0);});return}let s=N.join(process.cwd(),`.template-preview-${o.id}.html`);v.writeFileSync(s,n,"utf-8");let{spawn:p}=await import('child_process'),b=await import('os'),T=N.join(b.tmpdir(),"emailr-preview.pid");try{let f=v.readFileSync(T,"utf-8").trim();process.kill(parseInt(f,10),"SIGTERM");}catch{}let h=`
           const http = require('http');
           const fs = require('fs');
           const path = require('path');
@@ -201,25 +949,59 @@ Stopping preview server...`),await he().stop(),console.log("Done."),process.exit
             console.log('PORT:' + port);
           });
           process.on('SIGTERM', () => { try { fs.unlinkSync(pidFile); fs.unlinkSync(portFile); fs.unlinkSync(filePath); } catch {} process.exit(0); });
-        `,w=f("node",["-e",b],{detached:!0,stdio:["ignore","pipe","ignore"]}),S="";await new Promise(u=>{w.stdout?.on("data",C=>{let q=C.toString().match(/PORT:(\d+)/);q&&(S=q[1],u());}),setTimeout(u,3e3);}),w.unref();let D=`http://127.0.0.1:${S}/`;if(console.log(`
-Template: ${a.name}`),console.log(`Preview URL: ${D}`),console.log(`
-To stop: emailr templates stop-preview`),e.open!==!1)try{await(await import('open')).default(D);}catch{}process.exit(0);}catch(o){l(o instanceof Error?o.message:"Failed to preview template"),process.exit(1);}}),n.command("edit <id>").description(`Start a live editing session for a template.
-WORKFLOW:
-1. Run: emailr templates edit <id> --file ./template.html
-2. Edit the file at ./template.html - browser auto-refreshes on save
-3. When done: emailr templates update <id> --html-file ./template.html
-4. Stop server: emailr templates stop-preview`).option("--file <path>","Path to save the HTML file for editing","./template.html").option("--no-open","Do not automatically open browser").option("--foreground","Keep process running in foreground (blocks terminal)").action(async(t,e)=>{try{let o=m(),i=new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}),a=U.resolve(e.file);console.log(`Fetching template ${t}...`);let r=await i.templates.get(t),s=r.html_content??"";if(E.writeFileSync(a,s,"utf-8"),console.log(`Template saved to: ${a}`),e.foreground){let C=`http://127.0.0.1:${await Q(a,()=>{console.log("File changed - browser refreshed");})}/`;if(console.log(`
-Template: ${r.name}`),console.log(`Template ID: ${r.id}`),console.log(`Live Preview: ${C}`),console.log(`File: ${a}`),console.log(`
-Watching for changes... Edit the file and see live updates.`),console.log(`When done, run: emailr templates update ${t} --html-file ${e.file}`),e.open!==!1)try{await(await import('open')).default(C);}catch{}process.on("SIGINT",async()=>{console.log(`
-Stopping live preview server...`),await X(),console.log("Done."),console.log(`
-To save changes: emailr templates update ${t} --html-file ${e.file}`),process.exit(0);});return}let{spawn:f}=await import('child_process'),g=await import('os'),x=U.join(g.tmpdir(),"emailr-preview.pid");try{let u=E.readFileSync(x,"utf-8").trim();process.kill(parseInt(u,10),"SIGTERM");}catch{}let b=`
+        `,y=p("node",["-e",h],{detached:!0,stdio:["ignore","pipe","ignore"]}),O="";await new Promise(f=>{y.stdout?.on("data",_=>{let q=_.toString().match(/PORT:(\d+)/);q&&(O=q[1],f());}),setTimeout(f,3e3);}),y.unref();let D=`http://127.0.0.1:${O}/`;if(console.log(`
+Template: ${o.name}`),console.log(`Preview URL: ${D}`),console.log(`
+To stop: emailr templates stop-preview`),e.open!==!1)try{await(await import('open')).default(D);}catch{}process.exit(0);}catch(a){l(a instanceof Error?a.message:"Failed to preview template"),process.exit(1);}}),i.command("edit <template_id>").description(`Start a live editing session for a template with hot-reload
+USAGE
+  emailr templates edit <template_id> [options]
+DESCRIPTION
+  Downloads a template's HTML to a local file and starts a live preview
+  server with hot-reload. Edit the file in your editor and see changes
+  instantly in the browser. When done, save changes with the update command.
+ARGUMENTS
+  <template_id>        The unique template identifier (e.g., tpl_abc123)
+OPTIONS
+  --file <file_path>   Path to save the HTML file for editing (default: ./template.html)
+  --no-open            Do not automatically open browser
+  --foreground         Keep process running in foreground (blocks terminal)
+WORKFLOW
+  1. Run: emailr templates edit <id> --file ./template.html
+  2. Edit the file at ./template.html - browser auto-refreshes on save
+  3. When done: emailr templates update <id> --html-file ./template.html
+  4. Stop server: emailr templates stop-preview
+EXAMPLES
+  # Start editing with default file path
+  emailr templates edit tpl_abc123
+  # Specify custom file path
+  emailr templates edit tpl_abc123 --file ./emails/welcome.html
+  # Run in foreground (Ctrl+C to stop)
+  emailr templates edit tpl_abc123 --foreground
+  # Don't open browser automatically
+  emailr templates edit tpl_abc123 --no-open
+SEE ALSO
+  emailr templates draft        Draft a new template with live preview
+  emailr templates update       Save changes to the template
+  emailr templates stop-preview Stop the background preview server`).option("--file <file_path>","Path to save the HTML file for editing","./template.html").option("--no-open","Do not automatically open browser").option("--foreground","Keep process running in foreground (blocks terminal)").action(async(t,e)=>{try{let a=m(),r=new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}),o=N.resolve(e.file);console.log(`Fetching template ${t}...`);let n=await r.templates.get(t),s=n.html_content??"";if(v.writeFileSync(o,s,"utf-8"),console.log(`Template saved to: ${o}`),e.foreground){let _=`http://127.0.0.1:${await Y(o,()=>{console.log("File changed - browser refreshed");})}/`;if(console.log(`
+Template: ${n.name}`),console.log(`Template ID: ${n.id}`),console.log(`Live Preview: ${_}`),console.log(`File: ${o}`),console.log(`
+Watching for changes... Edit the file and see live updates.`),console.log(`When done, run: emailr templates update ${t} --html-file ${e.file}`),e.open!==!1)try{await(await import('open')).default(_);}catch{}process.on("SIGINT",async()=>{console.log(`
+Stopping live preview server...`),await Z(),console.log("Done."),console.log(`
+To save changes: emailr templates update ${t} --html-file ${e.file}`),process.exit(0);});return}let{spawn:p}=await import('child_process'),b=await import('os'),T=N.join(b.tmpdir(),"emailr-preview.pid");try{let f=v.readFileSync(T,"utf-8").trim();process.kill(parseInt(f,10),"SIGTERM");}catch{}let h=`
           const http = require('http');
           const fs = require('fs');
           const path = require('path');
           const os = require('os');
-          const filePath = ${JSON.stringify(a)};
+          const filePath = ${JSON.stringify(o)};
           const pidFile = path.join(os.tmpdir(), 'emailr-preview.pid');
           const portFile = path.join(os.tmpdir(), 'emailr-preview.port');
           let clients = [];
@@ -254,16 +1036,52 @@ To save changes: emailr templates update ${t} --html-file ${e.file}`),process.ex
             });
           });
           process.on('SIGTERM', () => { try { fs.unlinkSync(pidFile); fs.unlinkSync(portFile); } catch {} process.exit(0); });
-        `,w=f("node",["-e",b],{detached:!0,stdio:["ignore","pipe","ignore"]}),S="";await new Promise(u=>{w.stdout?.on("data",C=>{let ne=C.toString().match(/PORT:(\d+)/);ne&&(S=ne[1],u());}),setTimeout(u,3e3);}),w.unref();let D=`http://127.0.0.1:${S}/`;if(console.log(`
-Template: ${r.name}`),console.log(`Template ID: ${r.id}`),console.log(`Live Preview: ${D}`),console.log(`File: ${a}`),console.log(`
+        `,y=p("node",["-e",h],{detached:!0,stdio:["ignore","pipe","ignore"]}),O="";await new Promise(f=>{y.stdout?.on("data",_=>{let ie=_.toString().match(/PORT:(\d+)/);ie&&(O=ie[1],f());}),setTimeout(f,3e3);}),y.unref();let D=`http://127.0.0.1:${O}/`;if(console.log(`
+Template: ${n.name}`),console.log(`Template ID: ${n.id}`),console.log(`Live Preview: ${D}`),console.log(`File: ${o}`),console.log(`
 Edit the file and see live updates in the browser.`),console.log(`
-When done:`),console.log(`  emailr templates update ${t} --html-file ${e.file}`),console.log("  emailr templates stop-preview"),e.open!==!1)try{await(await import('open')).default(D);}catch{}process.exit(0);}catch(o){l(o instanceof Error?o.message:"Failed to edit template"),process.exit(1);}}),n.command("draft").description(`Start a live drafting session for a new template.
+When done:`),console.log(`  emailr templates update ${t} --html-file ${e.file}`),console.log("  emailr templates stop-preview"),e.open!==!1)try{await(await import('open')).default(D);}catch{}process.exit(0);}catch(a){l(a instanceof Error?a.message:"Failed to edit template"),process.exit(1);}}),i.command("draft").description(`Start a live drafting session for a new template with hot-reload
+USAGE
+  emailr templates draft [options]
+DESCRIPTION
+  Creates a new HTML file with a starter template and starts a live
+  preview server with hot-reload. Edit the file in your editor and
+  see changes instantly in the browser. When done, create the template
+  with the create command.
+OPTIONS
+  --file <file_path>   Path to save the HTML file for drafting (default: ./new-template.html)
+  --no-open            Do not automatically open browser
+  --blank              Start with a blank file instead of starter template
+  --foreground         Keep process running in foreground (blocks terminal)
-WORKFLOW:
-1. Run: emailr templates draft --file ./new-template.html
-2. Edit the file at ./new-template.html - browser auto-refreshes on save
-3. When done: emailr templates create --name "My Template" --subject "Subject" --html-file ./new-template.html
-4. Stop server: emailr templates stop-preview`).option("--file <path>","Path to save the HTML file for drafting","./new-template.html").option("--no-open","Do not automatically open browser").option("--blank","Start with a blank file instead of starter template").option("--foreground","Keep process running in foreground (blocks terminal)").action(async t=>{try{let e=U.resolve(t.file),o;if(t.blank?o="":o=`<!DOCTYPE html>
+WORKFLOW
+  1. Run: emailr templates draft --file ./new-template.html
+  2. Edit the file at ./new-template.html - browser auto-refreshes on save
+  3. When done: emailr templates create --name "My Template" --subject "Subject" --html-file ./new-template.html
+  4. Stop server: emailr templates stop-preview
+EXAMPLES
+  # Start drafting with default file path
+  emailr templates draft
+  # Specify custom file path
+  emailr templates draft --file ./emails/new-welcome.html
+  # Start with blank file (no starter template)
+  emailr templates draft --blank
+  # Run in foreground (Ctrl+C to stop)
+  emailr templates draft --foreground
+  # Don't open browser automatically
+  emailr templates draft --no-open
+SEE ALSO
+  emailr templates edit         Edit an existing template with live preview
+  emailr templates create       Create the template from your draft
+  emailr templates stop-preview Stop the background preview server`).option("--file <file_path>","Path to save the HTML file for drafting","./new-template.html").option("--no-open","Do not automatically open browser").option("--blank","Start with a blank file instead of starter template").option("--foreground","Keep process running in foreground (blocks terminal)").action(async t=>{try{let e=N.resolve(t.file),a;if(t.blank?a="":a=`<!DOCTYPE html>
 <html>
 <head>
   <meta charset="UTF-8">
@@ -298,13 +1116,13 @@ WORKFLOW:
     <p><a href="{{unsubscribe_link}}">Unsubscribe</a></p>
   </div>
 </body>
-</html>`,E.writeFileSync(e,o,"utf-8"),console.log(`Template draft created: ${e}`),t.foreground){let w=`http://127.0.0.1:${await Q(e,()=>{console.log("File changed - browser refreshed");})}/`;if(console.log(`
-Live Preview: ${w}`),console.log(`File: ${e}`),console.log(`
+</html>`,v.writeFileSync(e,a,"utf-8"),console.log(`Template draft created: ${e}`),t.foreground){let y=`http://127.0.0.1:${await Y(e,()=>{console.log("File changed - browser refreshed");})}/`;if(console.log(`
+Live Preview: ${y}`),console.log(`File: ${e}`),console.log(`
 Watching for changes... Edit the file and see live updates.`),console.log(`
-When done, create the template:`),console.log(`  emailr templates create --name "Template Name" --subject "Email Subject" --html-file ${t.file}`),t.open!==!1)try{await(await import('open')).default(w);}catch{}process.on("SIGINT",async()=>{console.log(`
+When done, create the template:`),console.log(`  emailr templates create --name "Template Name" --subject "Email Subject" --html-file ${t.file}`),t.open!==!1)try{await(await import('open')).default(y);}catch{}process.on("SIGINT",async()=>{console.log(`
-Stopping live preview server...`),await X(),console.log("Done."),console.log(`
-To create template: emailr templates create --name "Template Name" --subject "Email Subject" --html-file ${t.file}`),process.exit(0);});return}let{spawn:i}=await import('child_process'),a=await import('os'),r=U.join(a.tmpdir(),"emailr-preview.pid");try{let b=E.readFileSync(r,"utf-8").trim();process.kill(parseInt(b,10),"SIGTERM");}catch{}let s=`
+Stopping live preview server...`),await Z(),console.log("Done."),console.log(`
+To create template: emailr templates create --name "Template Name" --subject "Email Subject" --html-file ${t.file}`),process.exit(0);});return}let{spawn:r}=await import('child_process'),o=await import('os'),n=N.join(o.tmpdir(),"emailr-preview.pid");try{let h=v.readFileSync(n,"utf-8").trim();process.kill(parseInt(h,10),"SIGTERM");}catch{}let s=`
           const http = require('http');
           const fs = require('fs');
           const path = require('path');
@@ -344,61 +1162,1688 @@ To create template: emailr templates create --name "Template Name" --subject "Em
             });
           });
           process.on('SIGTERM', () => { try { fs.unlinkSync(pidFile); fs.unlinkSync(portFile); } catch {} process.exit(0); });
-        `,f=i("node",["-e",s],{detached:!0,stdio:["ignore","pipe","ignore"]}),g="";await new Promise(b=>{f.stdout?.on("data",w=>{let S=w.toString().match(/PORT:(\d+)/);S&&(g=S[1],b());}),setTimeout(b,3e3);}),f.unref();let x=`http://127.0.0.1:${g}/`;if(console.log(`
-Live Preview: ${x}`),console.log(`File: ${e}`),console.log(`
+        `,p=r("node",["-e",s],{detached:!0,stdio:["ignore","pipe","ignore"]}),b="";await new Promise(h=>{p.stdout?.on("data",y=>{let O=y.toString().match(/PORT:(\d+)/);O&&(b=O[1],h());}),setTimeout(h,3e3);}),p.unref();let T=`http://127.0.0.1:${b}/`;if(console.log(`
+Live Preview: ${T}`),console.log(`File: ${e}`),console.log(`
 Edit the file and see live updates in the browser.`),console.log(`
-When done:`),console.log(`  emailr templates create --name "Template Name" --subject "Email Subject" --html-file ${t.file}`),console.log("  emailr templates stop-preview"),t.open!==!1)try{await(await import('open')).default(x);}catch{}process.exit(0);}catch(e){l(e instanceof Error?e.message:"Failed to start draft session"),process.exit(1);}}),n.command("stop-preview").description("Stop any running background preview server").action(async()=>{let t=await import('os'),e=U.join(t.tmpdir(),"emailr-preview.pid");try{let o=E.readFileSync(e,"utf-8").trim();process.kill(parseInt(o,10),"SIGTERM"),E.unlinkSync(e),d("Preview server stopped");}catch{d("No preview server running");}}),n}function Ce(){let n=new Command("domains").description("Manage sending domains");return n.command("list").description("List all domains").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),i=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).domains.list();if(t.format==="json")c(i,"json");else {let a=i.map(r=>({ID:r.id,Domain:r.domain,Status:r.status,DKIM:r.dkim_verified,SPF:r.spf_verified,DMARC:r.dmarc_verified,Created:r.created_at}));c(a,"table");}}catch(e){l(e instanceof Error?e.message:"Failed to list domains"),process.exit(1);}}),n.command("get <id>").description("Get a domain by ID").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).domains.get(t);c(a,e.format);}catch(o){l(o instanceof Error?o.message:"Failed to get domain"),process.exit(1);}}),n.command("add <domain>").description("Add a new domain").option("--receiving-subdomain <subdomain>","Subdomain for receiving emails").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),i=new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}),a={domain:t};e.receivingSubdomain&&(a.receivingSubdomain=e.receivingSubdomain);let r=await i.domains.add(a);if(e.format==="json")c(r,"json");else {if(d(`Domain added: ${r.domain}`),p("Add the following DNS records to verify your domain:"),console.log(""),r.dns_records){let s=[{Type:"DKIM",...Z(r.dns_records.dkim)},{Type:"SPF",...Z(r.dns_records.spf)},{Type:"DMARC",...Z(r.dns_records.dmarc)}];c(s,"table");}console.log(""),p(`Run 'emailr domains verify ${r.id}' after adding DNS records`);}}catch(o){l(o instanceof Error?o.message:"Failed to add domain"),process.exit(1);}}),n.command("verify <id>").description("Verify a domain").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).domains.verify(t);e.format==="json"?c(a,"json"):a.verified?d("Domain verified successfully!"):(p(`Domain status: ${a.status}`),a.dkim_status&&p(`DKIM status: ${a.dkim_status}`));}catch(o){l(o instanceof Error?o.message:"Failed to verify domain"),process.exit(1);}}),n.command("check-dns <id>").description("Check DNS records for a domain").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).domains.checkDns(t);if(e.format==="json")c(a,"json");else {let r=Object.entries(a).map(([s,f])=>({Record:s,Verified:f.verified,Expected:f.expected||"-",Found:f.found?.join(", ")||"-"}));c(r,"table");}}catch(o){l(o instanceof Error?o.message:"Failed to check DNS"),process.exit(1);}}),n.command("delete <id>").description("Delete a domain").action(async t=>{try{let e=m();await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).domains.delete(t),d(`Domain deleted: ${t}`);}catch(e){l(e instanceof Error?e.message:"Failed to delete domain"),process.exit(1);}}),n}function Z(n){return {"Record Type":n.type,Name:n.name,Value:n.value.length>50?n.value.substring(0,47)+"...":n.value,...n.priority!==void 0&&{Priority:n.priority}}}function je(){let n=new Command("config").description("Manage CLI configuration");return n.command("set <key> <value>").description("Set a configuration value").action(async(t,e)=>{try{let o=["api-key","base-url","format"],i=t.toLowerCase();o.includes(i)||(l(`Invalid config key: ${t}`),p(`Valid keys: ${o.join(", ")}`),process.exit(1));let r={"api-key":"apiKey","base-url":"baseUrl",format:"format"}[i];i==="format"&&!["json","table"].includes(e)&&(l(`Invalid format value: ${e}`),p("Valid formats: json, table"),process.exit(1)),A({[r]:e}),d(`Configuration saved: ${t} = ${i==="api-key"?"***":e}`),p(`Config file: ${j()}`);}catch(o){l(o instanceof Error?o.message:"Failed to save configuration"),process.exit(1);}}),n.command("get <key>").description("Get a configuration value").action(async t=>{try{let e=["api-key","base-url","format"],o=t.toLowerCase();e.includes(o)||(l(`Invalid config key: ${t}`),p(`Valid keys: ${e.join(", ")}`),process.exit(1));let a={"api-key":"apiKey","base-url":"baseUrl",format:"format"}[o],r=re(a);r?console.log(o==="api-key"?r.substring(0,8)+"..."+r.substring(r.length-4):r):p(`${t} is not set`);}catch(e){l(e instanceof Error?e.message:"Failed to get configuration"),process.exit(1);}}),n.command("list").description("List all configuration values").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),o={"api-key":e.apiKey?e.apiKey.substring(0,8)+"..."+e.apiKey.substring(e.apiKey.length-4):"(not set)","base-url":e.baseUrl||"(default)",format:e.format||"table"};if(t.format==="json")c(o,"json");else {let i=Object.entries(o).map(([a,r])=>({Key:a,Value:r}));c(i,"table");}console.log(""),p(`Config file: ${j()}`);}catch(e){e instanceof Error&&e.message.includes("No API key configured")?(p("No configuration found."),p("Run 'emailr config set api-key <your-api-key>' to get started.")):(l(e instanceof Error?e.message:"Failed to list configuration"),process.exit(1));}}),n.command("path").description("Show the configuration file path").action(()=>{console.log(j());}),n.command("init").description("Initialize configuration interactively").option("--api-key <key>","API key to use").option("--base-url <url>","Base URL for API").action(async t=>{try{t.apiKey?(A({apiKey:t.apiKey,baseUrl:t.baseUrl}),d("Configuration initialized!"),p(`Config file: ${j()}`)):(p("Initialize your Emailr CLI configuration:"),console.log(""),p("Run with --api-key flag:"),console.log("  emailr config init --api-key <your-api-key>"),console.log(""),p("Or set environment variable:"),console.log("  export EMAILR_API_KEY=<your-api-key>"));}catch(e){l(e instanceof Error?e.message:"Failed to initialize configuration"),process.exit(1);}}),n}function ke(){let n=new Command("broadcasts").description("Manage broadcast campaigns");return n.command("list").description("List all broadcasts").option("--status <status>","Filter by status (draft, scheduled, sending, sent)").option("--limit <number>","Number of broadcasts to return","20").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),i=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).broadcasts.list({status:t.status,limit:parseInt(t.limit)});if(t.format==="json")c(i,"json");else {if(i.length===0){console.log("No broadcasts found.");return}let a=i.map(r=>({ID:r.id,Name:r.name,Subject:r.subject.substring(0,30)+(r.subject.length>30?"...":""),Status:r.status,Recipients:r.total_recipients||0,Sent:r.sent_count||0,Created:new Date(r.created_at).toLocaleDateString()}));c(a,"table");}}catch(e){l(e instanceof Error?e.message:"Failed to list broadcasts"),process.exit(1);}}),n.command("get <id>").description("Get broadcast details").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).broadcasts.get(t);e.format==="json"?c(a,"json"):c({ID:a.id,Name:a.name,Subject:a.subject,"From Email":a.from_email,Status:a.status,"Total Recipients":a.total_recipients||0,"Sent Count":a.sent_count||0,Delivered:a.delivered_count||0,Opened:a.opened_count||0,Clicked:a.clicked_count||0,Bounced:a.bounced_count||0,"Scheduled At":a.scheduled_at||"N/A","Started At":a.started_at||"N/A","Completed At":a.completed_at||"N/A","Created At":a.created_at},"table");}catch(o){l(o instanceof Error?o.message:"Failed to get broadcast"),process.exit(1);}}),n.command("create").description("Create a new broadcast").requiredOption("--name <name>","Broadcast name").requiredOption("--subject <subject>","Email subject").requiredOption("--from <email>","Sender email address").option("--template <id>","Template ID to use").option("--segment <id>","Segment ID to target").option("--html <html>","HTML content").option("--text <text>","Plain text content").option("--schedule <datetime>","Schedule time (ISO 8601)").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),i=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).broadcasts.create({name:t.name,subject:t.subject,from_email:t.from,template_id:t.template,segment_id:t.segment,html_content:t.html,text_content:t.text,scheduled_at:t.schedule});t.format==="json"?c(i,"json"):(d("Broadcast created successfully!"),c({ID:i.id,Name:i.name,Status:i.status,"Scheduled At":i.scheduled_at||"Not scheduled"},"table"));}catch(e){l(e instanceof Error?e.message:"Failed to create broadcast"),process.exit(1);}}),n.command("send <id>").description("Send a broadcast immediately").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).broadcasts.send(t);e.format==="json"?c(a,"json"):(d("Broadcast sent successfully!"),c({Success:a.success,Sent:a.sent,Total:a.total},"table"));}catch(o){l(o instanceof Error?o.message:"Failed to send broadcast"),process.exit(1);}}),n.command("schedule <id>").description("Schedule a broadcast").requiredOption("--at <datetime>","Schedule time (ISO 8601)").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).broadcasts.schedule(t,e.at);e.format==="json"?c(a,"json"):(d("Broadcast scheduled successfully!"),c({ID:a.id,Name:a.name,Status:a.status,"Scheduled At":a.scheduled_at},"table"));}catch(o){l(o instanceof Error?o.message:"Failed to schedule broadcast"),process.exit(1);}}),n.command("cancel <id>").description("Cancel a scheduled broadcast").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).broadcasts.cancel(t);e.format==="json"?c(a,"json"):d("Broadcast cancelled successfully!");}catch(o){l(o instanceof Error?o.message:"Failed to cancel broadcast"),process.exit(1);}}),n.command("delete <id>").description("Delete a broadcast").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).broadcasts.delete(t);e.format==="json"?c(a,"json"):d("Broadcast deleted successfully!");}catch(o){l(o instanceof Error?o.message:"Failed to delete broadcast"),process.exit(1);}}),n}function Ee(){let n=new Command("webhooks").description("Manage webhooks");return n.command("list").description("List all webhooks").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),i=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).webhooks.list();if(t.format==="json")c(i,"json");else {if(i.length===0){console.log("No webhooks found.");return}let a=i.map(r=>({ID:r.id,Name:r.name,URL:r.url.substring(0,40)+(r.url.length>40?"...":""),Events:r.events.join(", "),Active:r.active?"Yes":"No"}));c(a,"table");}}catch(e){l(e instanceof Error?e.message:"Failed to list webhooks"),process.exit(1);}}),n.command("get <id>").description("Get webhook details").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).webhooks.get(t);e.format==="json"?c(a,"json"):c({ID:a.id,Name:a.name,URL:a.url,Events:a.events.join(", "),Active:a.active?"Yes":"No",Secret:a.secret,"Created At":a.created_at},"table");}catch(o){l(o instanceof Error?o.message:"Failed to get webhook"),process.exit(1);}}),n.command("create").description("Create a new webhook").requiredOption("--name <name>","Webhook name").requiredOption("--url <url>","Webhook URL").requiredOption("--events <events>","Events to subscribe to (comma-separated)").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),o=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),i=t.events.split(",").map(r=>r.trim()),a=await o.webhooks.create({name:t.name,url:t.url,events:i});t.format==="json"?c(a,"json"):(d("Webhook created successfully!"),c({ID:a.id,Name:a.name,URL:a.url,Secret:a.secret},"table"));}catch(e){l(e instanceof Error?e.message:"Failed to create webhook"),process.exit(1);}}),n.command("update <id>").description("Update a webhook").option("--name <name>","New webhook name").option("--url <url>","New webhook URL").option("--events <events>","New events (comma-separated)").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),i=new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}),a={};e.name&&(a.name=e.name),e.url&&(a.url=e.url),e.events&&(a.events=e.events.split(",").map(s=>s.trim()));let r=await i.webhooks.update(t,a);e.format==="json"?c(r,"json"):(d("Webhook updated successfully!"),c({ID:r.id,Name:r.name,URL:r.url},"table"));}catch(o){l(o instanceof Error?o.message:"Failed to update webhook"),process.exit(1);}}),n.command("enable <id>").description("Enable a webhook").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).webhooks.enable(t);e.format==="json"?c(a,"json"):d("Webhook enabled successfully!");}catch(o){l(o instanceof Error?o.message:"Failed to enable webhook"),process.exit(1);}}),n.command("disable <id>").description("Disable a webhook").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).webhooks.disable(t);e.format==="json"?c(a,"json"):d("Webhook disabled successfully!");}catch(o){l(o instanceof Error?o.message:"Failed to disable webhook"),process.exit(1);}}),n.command("delete <id>").description("Delete a webhook").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).webhooks.delete(t);e.format==="json"?c(a,"json"):d("Webhook deleted successfully!");}catch(o){l(o instanceof Error?o.message:"Failed to delete webhook"),process.exit(1);}}),n}function Fe(){let n=new Command("segments").description("Manage contact segments");return n.command("list").description("List all segments").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),i=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).segments.list();if(t.format==="json")c(i,"json");else {if(i.length===0){console.log("No segments found.");return}let a=i.map(r=>({ID:r.id,Name:r.name,Description:(r.description||"").substring(0,30)+((r.description?.length||0)>30?"...":""),"Created At":new Date(r.created_at).toLocaleDateString()}));c(a,"table");}}catch(e){l(e instanceof Error?e.message:"Failed to list segments"),process.exit(1);}}),n.command("get <id>").description("Get segment details").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).segments.get(t);e.format==="json"?c(a,"json"):c({ID:a.id,Name:a.name,Description:a.description||"N/A",Conditions:JSON.stringify(a.conditions),"Created At":a.created_at,"Updated At":a.updated_at},"table");}catch(o){l(o instanceof Error?o.message:"Failed to get segment"),process.exit(1);}}),n.command("create").description("Create a new segment").requiredOption("--name <name>","Segment name").requiredOption("--conditions <json>","Segment conditions as JSON").option("--description <description>","Segment description").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),o=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),i;try{i=JSON.parse(t.conditions);}catch{l("Invalid JSON for --conditions"),process.exit(1);}let a=await o.segments.create({name:t.name,description:t.description,conditions:i});t.format==="json"?c(a,"json"):(d("Segment created successfully!"),c({ID:a.id,Name:a.name},"table"));}catch(e){l(e instanceof Error?e.message:"Failed to create segment"),process.exit(1);}}),n.command("update <id>").description("Update a segment").option("--name <name>","New segment name").option("--description <description>","New description").option("--conditions <json>","New conditions as JSON").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),i=new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}),a={};if(e.name&&(a.name=e.name),e.description&&(a.description=e.description),e.conditions)try{a.conditions=JSON.parse(e.conditions);}catch{l("Invalid JSON for --conditions"),process.exit(1);}let r=await i.segments.update(t,a);e.format==="json"?c(r,"json"):(d("Segment updated successfully!"),c({ID:r.id,Name:r.name},"table"));}catch(o){l(o instanceof Error?o.message:"Failed to update segment"),process.exit(1);}}),n.command("delete <id>").description("Delete a segment").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).segments.delete(t);e.format==="json"?c(a,"json"):d("Segment deleted successfully!");}catch(o){l(o instanceof Error?o.message:"Failed to delete segment"),process.exit(1);}}),n.command("count <id>").description("Get the number of contacts in a segment").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let o=m(),a=await new Emailr({apiKey:o.apiKey,baseUrl:o.baseUrl}).segments.getContactsCount(t);e.format==="json"?c(a,"json"):console.log(`Segment contains ${a.count} contacts.`);}catch(o){l(o instanceof Error?o.message:"Failed to get segment count"),process.exit(1);}}),n}function it(n){try{let t=n.startsWith("http")?n:`http://localhost${n}`,e=new URL(t);return {key:e.searchParams.get("key")??void 0,code:e.searchParams.get("code")??void 0,state:e.searchParams.get("state")??void 0,error:e.searchParams.get("error")??void 0,message:e.searchParams.get("message")??void 0}}catch{return {}}}function st(){return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Login Successful - Emailr CLI</title>
-  <style>
-    body {
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
-      display: flex;
-      justify-content: center;
-      align-items: center;
-      min-height: 100vh;
-      margin: 0;
-      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-      color: #fff;
-    }
-    .container {
-      text-align: center;
-      padding: 2rem;
-      background: rgba(255, 255, 255, 0.1);
-      border-radius: 16px;
-      backdrop-filter: blur(10px);
-      max-width: 400px;
-    }
-    .icon {
-      font-size: 4rem;
-      margin-bottom: 1rem;
-    }
-    h1 {
-      margin: 0 0 1rem 0;
-      font-size: 1.5rem;
-    }
-    p {
-      margin: 0;
-      opacity: 0.9;
-    }
-  </style>
-</head>
-<body>
-  <div class="container">
-    <div class="icon">\u2713</div>
-    <h1>Login Successful!</h1>
-    <p>You can close this window and return to your terminal.</p>
-  </div>
-</body>
-</html>`}function ee(n){return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Login Failed - Emailr CLI</title>
+When done:`),console.log(`  emailr templates create --name "Template Name" --subject "Email Subject" --html-file ${t.file}`),console.log("  emailr templates stop-preview"),t.open!==!1)try{await(await import('open')).default(T);}catch{}process.exit(0);}catch(e){l(e instanceof Error?e.message:"Failed to start draft session"),process.exit(1);}}),i.command("stop-preview").description(`Stop any running background preview server
+USAGE
+  emailr templates stop-preview
+DESCRIPTION
+  Stops the background preview server started by the edit, draft, or
+  preview commands. Use this when you're done editing and want to
+  clean up the background process.
+EXAMPLES
+  # Stop the preview server
+  emailr templates stop-preview
+SEE ALSO
+  emailr templates edit    Start live editing session
+  emailr templates draft   Start live drafting session
+  emailr templates preview Preview a template in browser`).action(async()=>{let t=await import('os'),e=N.join(t.tmpdir(),"emailr-preview.pid");try{let a=v.readFileSync(e,"utf-8").trim();process.kill(parseInt(a,10),"SIGTERM"),v.unlinkSync(e),d("Preview server stopped");}catch{d("No preview server running");}}),i}function Ee(){let i=new Command("domains").description(`Manage sending domains
+USAGE
+  emailr domains <subcommand> [options]
+DESCRIPTION
+  Add, verify, and manage sending domains for email delivery. Domains must
+  be verified before you can send emails from addresses on that domain.
+  Verification requires adding DNS records to prove domain ownership.
+SUBCOMMANDS
+  list               List all domains with verification status
+  get <id>           Get domain details including DNS records
+  add <domain>       Add a new domain and get required DNS records
+  verify <id>        Trigger verification check for a domain
+  check-dns <id>     Check current DNS record status
+  delete <id>        Delete a domain permanently
+DOMAIN VERIFICATION WORKFLOW
+  1. Add domain:      emailr domains add example.com
+  2. Configure DNS:   Add the DKIM, SPF, and DMARC records shown
+  3. Wait:            DNS propagation can take up to 48 hours
+  4. Verify:          emailr domains verify <domain_id>
+  5. Check status:    emailr domains check-dns <domain_id>
+DNS RECORD TYPES
+  DKIM (DomainKeys Identified Mail):
+    - Cryptographic signature for email authentication
+    - Proves emails are authorized by domain owner
+    - TXT record with public key
+  SPF (Sender Policy Framework):
+    - Specifies which servers can send email for your domain
+    - Prevents email spoofing
+    - TXT record listing authorized senders
+  DMARC (Domain-based Message Authentication):
+    - Policy for handling authentication failures
+    - Specifies how receivers should treat failed emails
+    - TXT record with policy settings
+OPTIONS
+  --format <format>  Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json      Machine-readable JSON output
+  --format table     Human-readable table output (default)
+EXAMPLES
+  # List all domains with verification status
+  emailr domains list
+  # Add a new domain
+  emailr domains add example.com
+  # Add domain with receiving subdomain
+  emailr domains add example.com --receiving-subdomain inbound
+  # Check DNS record status
+  emailr domains check-dns dom_abc123
+  # Verify domain after DNS configuration
+  emailr domains verify dom_abc123
+  # Get domain details
+  emailr domains get dom_abc123
+  # Delete a domain
+  emailr domains delete dom_abc123
+  # Get JSON output for scripting
+  emailr domains list --format json
+VERIFICATION STATUS
+  pending      Domain added, awaiting DNS configuration
+  verifying    Verification in progress
+  verified     All DNS records verified, ready to send
+  failed       Verification failed, check DNS records
+SEE ALSO
+  emailr send        Send emails using verified domains
+  emailr webhooks    Receive domain verification events`);return i.command("list").description(`List all domains
+USAGE
+  emailr domains list [options]
+DESCRIPTION
+  Retrieves a list of all domains configured for your account.
+  Shows domain name, verification status, and individual DNS record status.
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Machine-readable JSON array of domain objects
+  --format table       Human-readable table with columns: ID, Domain, Status, DKIM, SPF, DMARC, Created
+EXAMPLES
+  # List all domains
+  emailr domains list
+  # Get JSON output for scripting
+  emailr domains list --format json
+  # Filter verified domains with jq
+  emailr domains list --format json | jq '.[] | select(.status == "verified")'
+  # Count domains
+  emailr domains list --format json | jq 'length'`).option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),r=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).domains.list();if(t.format==="json")c(r,"json");else {let o=r.map(n=>({ID:n.id,Domain:n.domain,Status:n.status,DKIM:n.dkim_verified,SPF:n.spf_verified,DMARC:n.dmarc_verified,Created:n.created_at}));c(o,"table");}}catch(e){l(e instanceof Error?e.message:"Failed to list domains"),process.exit(1);}}),i.command("get <domain_id>").description(`Get domain details
+USAGE
+  emailr domains get <domain_id> [options]
+DESCRIPTION
+  Retrieves detailed information about a specific domain including
+  verification status and DNS record configuration.
+ARGUMENTS
+  <domain_id>          The unique domain identifier (e.g., dom_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Full domain object with all fields and DNS records
+  --format table       Summary table with domain details
+EXAMPLES
+  # Get domain details
+  emailr domains get dom_abc123
+  # Get full domain data as JSON
+  emailr domains get dom_abc123 --format json
+  # Extract DNS records
+  emailr domains get dom_abc123 --format json | jq '.dns_records'`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).domains.get(t);c(o,e.format);}catch(a){l(a instanceof Error?a.message:"Failed to get domain"),process.exit(1);}}),i.command("add <domain_name>").description(`Add a new domain
+USAGE
+  emailr domains add <domain_name> [options]
+DESCRIPTION
+  Adds a new sending domain and returns the DNS records required for
+  verification. After adding, configure these records with your DNS
+  provider, then run 'verify' to complete setup.
+ARGUMENTS
+  <domain_name>        The domain to add (e.g., example.com)
+OPTIONS
+  --receiving-subdomain <subdomain>    Subdomain for receiving emails (optional)
+  --format <format>                    Output format: json | table (default: table)
+DNS RECORDS RETURNED
+  After adding a domain, you'll receive three DNS records to configure:
+  DKIM Record:
+    Type: TXT
+    Name: emailr._domainkey.example.com
+    Value: v=DKIM1; k=rsa; p=<public_key>
+  SPF Record:
+    Type: TXT
+    Name: example.com
+    Value: v=spf1 include:_spf.emailr.com ~all
+  DMARC Record:
+    Type: TXT
+    Name: _dmarc.example.com
+    Value: v=DMARC1; p=none; rua=mailto:dmarc@example.com
+OUTPUT FORMATS
+  --format json        Full domain object with DNS records
+  --format table       Summary with DNS records in table format
+EXAMPLES
+  # Add a domain
+  emailr domains add example.com
+  # Add domain with receiving subdomain
+  emailr domains add example.com --receiving-subdomain inbound
+  # Get JSON output with DNS records
+  emailr domains add example.com --format json
+NEXT STEPS
+  1. Copy the DNS records shown in the output
+  2. Add them to your DNS provider (Cloudflare, Route53, etc.)
+  3. Wait for DNS propagation (up to 48 hours)
+  4. Run: emailr domains verify <domain_id>`).option("--receiving-subdomain <subdomain>","Subdomain for receiving emails").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),r=new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}),o={domain:t};e.receivingSubdomain&&(o.receivingSubdomain=e.receivingSubdomain);let n=await r.domains.add(o);if(e.format==="json")c(n,"json");else {if(d(`Domain added: ${n.domain}`),u("Add the following DNS records to verify your domain:"),console.log(""),n.dns_records){let s=[{Type:"DKIM",...Q(n.dns_records.dkim)},{Type:"SPF",...Q(n.dns_records.spf)},{Type:"DMARC",...Q(n.dns_records.dmarc)}];c(s,"table");}console.log(""),u(`Run 'emailr domains verify ${n.id}' after adding DNS records`);}}catch(a){l(a instanceof Error?a.message:"Failed to add domain"),process.exit(1);}}),i.command("verify <domain_id>").description(`Verify a domain
+USAGE
+  emailr domains verify <domain_id> [options]
+DESCRIPTION
+  Triggers a verification check for a domain. This queries DNS to confirm
+  that the required DKIM, SPF, and DMARC records are properly configured.
+  Run this after adding DNS records to your domain.
+ARGUMENTS
+  <domain_id>          The unique domain identifier (e.g., dom_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+VERIFICATION PROCESS
+  1. Emailr queries DNS for your domain's records
+  2. Compares found records against expected values
+  3. Updates verification status for each record type
+  4. Domain is verified when all records pass
+OUTPUT FORMATS
+  --format json        Verification result with status details
+  --format table       Human-readable verification status
+EXAMPLES
+  # Verify a domain
+  emailr domains verify dom_abc123
+  # Get JSON verification result
+  emailr domains verify dom_abc123 --format json
+TROUBLESHOOTING
+  If verification fails:
+  1. Run 'check-dns' to see which records are missing
+  2. Verify records are correctly configured with your DNS provider
+  3. Wait for DNS propagation (can take up to 48 hours)
+  4. Try verification again`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).domains.verify(t);e.format==="json"?c(o,"json"):o.verified?d("Domain verified successfully!"):(u(`Domain status: ${o.status}`),o.dkim_status&&u(`DKIM status: ${o.dkim_status}`));}catch(a){l(a instanceof Error?a.message:"Failed to verify domain"),process.exit(1);}}),i.command("check-dns <domain_id>").description(`Check DNS records for a domain
+USAGE
+  emailr domains check-dns <domain_id> [options]
+DESCRIPTION
+  Queries DNS to check the current status of DKIM, SPF, and DMARC records
+  for a domain. Shows expected vs. found values to help troubleshoot
+  verification issues.
+ARGUMENTS
+  <domain_id>          The unique domain identifier (e.g., dom_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+DNS RECORD STATUS
+  For each record type (DKIM, SPF, DMARC), shows:
+  - Verified: Whether the record matches expected value
+  - Expected: The value Emailr expects to find
+  - Found: The actual value(s) found in DNS
+OUTPUT FORMATS
+  --format json        Detailed DNS check results as JSON
+  --format table       Table showing Record, Verified, Expected, Found
+EXAMPLES
+  # Check DNS records
+  emailr domains check-dns dom_abc123
+  # Get JSON output for debugging
+  emailr domains check-dns dom_abc123 --format json
+  # Check specific record with jq
+  emailr domains check-dns dom_abc123 --format json | jq '.dkim'
+COMMON ISSUES
+  Record not found:
+    - DNS propagation may still be in progress
+    - Record may be misconfigured at DNS provider
+  Value mismatch:
+    - Copy the exact value from 'add' command output
+    - Ensure no extra spaces or characters
+  Multiple records found:
+    - Remove duplicate TXT records
+    - Keep only the Emailr-specific record`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).domains.checkDns(t);if(e.format==="json")c(o,"json");else {let n=Object.entries(o).map(([s,p])=>({Record:s,Verified:p.verified,Expected:p.expected||"-",Found:p.found?.join(", ")||"-"}));c(n,"table");}}catch(a){l(a instanceof Error?a.message:"Failed to check DNS"),process.exit(1);}}),i.command("delete <domain_id>").description(`Delete a domain
+USAGE
+  emailr domains delete <domain_id> [options]
+DESCRIPTION
+  Permanently deletes a domain from your account. This action cannot be
+  undone. You will no longer be able to send emails from this domain.
+ARGUMENTS
+  <domain_id>          The unique domain identifier (e.g., dom_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { success: boolean }
+  --format table       Human-readable success message
+EXAMPLES
+  # Delete a domain
+  emailr domains delete dom_abc123
+  # Get JSON output
+  emailr domains delete dom_abc123 --format json
+WARNING
+  This action is permanent and cannot be undone.
+  - Emails from this domain will fail to send
+  - DNS records can be removed from your DNS provider
+  - Re-add the domain if you need to restore functionality`).option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m();await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).domains.delete(t),d(`Domain deleted: ${t}`);}catch(e){l(e instanceof Error?e.message:"Failed to delete domain"),process.exit(1);}}),i}function Q(i){return {"Record Type":i.type,Name:i.name,Value:i.value.length>50?i.value.substring(0,47)+"...":i.value,...i.priority!==void 0&&{Priority:i.priority}}}function Ne(){let i=new Command("config").description(`Manage CLI configuration
+USAGE
+  emailr config <subcommand> [options]
+DESCRIPTION
+  Configure the Emailr CLI with your API credentials and preferences.
+  Settings can be stored in a config file or provided via environment
+  variables. Environment variables take precedence over config file values.
+SUBCOMMANDS
+  set <key> <value>    Set a configuration value
+  get <key>            Get a configuration value
+  list                 List all configuration values
+  path                 Show the configuration file path
+  init                 Initialize configuration interactively
+CONFIGURABLE SETTINGS
+  api-key              Your Emailr API key (required for API access)
+  base-url             Custom API base URL (default: https://api.emailr.dev)
+  format               Default output format: json | table (default: table)
+ENVIRONMENT VARIABLES
+  EMAILR_API_KEY       API key (overrides config file api-key)
+  EMAILR_BASE_URL      Base URL (overrides config file base-url)
+  Environment variables take precedence over config file values, allowing
+  you to override settings without modifying the config file.
+CONFIG FILE LOCATION
+  ~/.emailr/config.json
+  The config file is created automatically when you run 'emailr config set'
+  or 'emailr config init'. The file stores settings in JSON format.
+OUTPUT FORMATS
+  --format json        Machine-readable JSON output (for list command)
+  --format table       Human-readable table output (default)
+EXAMPLES
+  # Set your API key
+  emailr config set api-key re_abc123xyz
+  # Set a custom API base URL
+  emailr config set base-url https://custom.api.example.com
+  # View current configuration
+  emailr config list
+  # Get a specific setting
+  emailr config get api-key
+  # Show config file location
+  emailr config path
+  # Initialize with API key
+  emailr config init --api-key re_abc123xyz
+  # Use environment variable instead of config file
+  export EMAILR_API_KEY=re_abc123xyz
+  emailr templates list
+SEE ALSO
+  emailr --help        Show all available commands`);return i.command("set <key> <value>").description(`Set a configuration value
+USAGE
+  emailr config set <key> <value>
+DESCRIPTION
+  Stores a configuration value in the config file (~/.emailr/config.json).
+  The config file is created automatically if it doesn't exist.
+ARGUMENTS
+  <key>                Configuration key to set
+  <value>              Value to assign to the key
+VALID KEYS
+  api-key              Your Emailr API key (masked in output for security)
+  base-url             Custom API base URL
+  format               Default output format: json | table
+EXAMPLES
+  # Set your API key
+  emailr config set api-key re_abc123xyz
+  # Set a custom API base URL
+  emailr config set base-url https://custom.api.example.com
+  # Set default output format to JSON
+  emailr config set format json
+NOTE
+  Environment variables (EMAILR_API_KEY, EMAILR_BASE_URL) take precedence
+  over config file values at runtime.`).action(async(t,e)=>{try{let a=["api-key","base-url","format"],r=t.toLowerCase();a.includes(r)||(l(`Invalid config key: ${t}`),u(`Valid keys: ${a.join(", ")}`),process.exit(1));let n={"api-key":"apiKey","base-url":"baseUrl",format:"format"}[r];r==="format"&&!["json","table"].includes(e)&&(l(`Invalid format value: ${e}`),u("Valid formats: json, table"),process.exit(1)),G({[n]:e}),d(`Configuration saved: ${t} = ${r==="api-key"?"***":e}`),u(`Config file: ${I()}`);}catch(a){l(a instanceof Error?a.message:"Failed to save configuration"),process.exit(1);}}),i.command("get <key>").description(`Get a configuration value
+USAGE
+  emailr config get <key>
+DESCRIPTION
+  Retrieves and displays a single configuration value from the config file.
+  API keys are partially masked for security (shows first 8 and last 4 chars).
+ARGUMENTS
+  <key>                Configuration key to retrieve
+VALID KEYS
+  api-key              Your Emailr API key (partially masked in output)
+  base-url             Custom API base URL
+  format               Default output format
+EXAMPLES
+  # Get your API key (masked)
+  emailr config get api-key
+  # Get the base URL
+  emailr config get base-url
+  # Get default output format
+  emailr config get format
+SEE ALSO
+  emailr config list   Show all configuration values`).action(async t=>{try{let e=["api-key","base-url","format"],a=t.toLowerCase();e.includes(a)||(l(`Invalid config key: ${t}`),u(`Valid keys: ${e.join(", ")}`),process.exit(1));let o={"api-key":"apiKey","base-url":"baseUrl",format:"format"}[a],n=ne(o);n?console.log(a==="api-key"?n.substring(0,8)+"..."+n.substring(n.length-4):n):u(`${t} is not set`);}catch(e){l(e instanceof Error?e.message:"Failed to get configuration"),process.exit(1);}}),i.command("list").description(`List all configuration values
+USAGE
+  emailr config list [options]
+DESCRIPTION
+  Displays all configuration values from the config file. API keys are
+  partially masked for security. Shows the config file location at the end.
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Machine-readable JSON object with all settings
+  --format table       Human-readable table with Key and Value columns
+EXAMPLES
+  # List all settings in table format
+  emailr config list
+  # List all settings as JSON
+  emailr config list --format json
+  # Pipe JSON to jq for processing
+  emailr config list --format json | jq '.["api-key"]'
+SEE ALSO
+  emailr config get    Get a single configuration value
+  emailr config path   Show config file location`).option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),a={"api-key":e.apiKey?e.apiKey.substring(0,8)+"..."+e.apiKey.substring(e.apiKey.length-4):"(not set)","base-url":e.baseUrl||"(default)",format:e.format||"table"};if(t.format==="json")c(a,"json");else {let r=Object.entries(a).map(([o,n])=>({Key:o,Value:n}));c(r,"table");}console.log(""),u(`Config file: ${I()}`);}catch(e){e instanceof Error&&e.message.includes("No API key configured")?(u("No configuration found."),u("Run 'emailr config set api-key <your-api-key>' to get started.")):(l(e instanceof Error?e.message:"Failed to list configuration"),process.exit(1));}}),i.command("path").description(`Show the configuration file path
+USAGE
+  emailr config path
+DESCRIPTION
+  Displays the full path to the configuration file. Useful for debugging
+  or when you need to manually edit or backup the config file.
+CONFIG FILE LOCATION
+  ~/.emailr/config.json
+  The config file stores settings in JSON format:
+  {
+    "apiKey": "re_abc123...",
+    "baseUrl": "https://api.emailr.dev",
+    "format": "table"
+  }
+EXAMPLES
+  # Show config file path
+  emailr config path
+  # Open config file in editor (macOS)
+  open $(emailr config path)
+  # View config file contents
+  cat $(emailr config path)`).action(()=>{console.log(I());}),i.command("init").description(`Initialize configuration interactively
+USAGE
+  emailr config init [options]
+DESCRIPTION
+  Sets up the CLI configuration with your API credentials. Creates the
+  config file (~/.emailr/config.json) if it doesn't exist.
+OPTIONS
+  --api-key <api_key>  API key to use
+  --base-url <url>     Base URL for API (optional)
+EXAMPLES
+  # Initialize with API key
+  emailr config init --api-key re_abc123xyz
+  # Initialize with custom base URL
+  emailr config init --api-key re_abc123xyz --base-url https://custom.api.example.com
+  # Show initialization instructions
+  emailr config init
+ALTERNATIVE: ENVIRONMENT VARIABLES
+  Instead of using config init, you can set environment variables:
+  export EMAILR_API_KEY=re_abc123xyz
+  export EMAILR_BASE_URL=https://api.emailr.dev  # optional
+  Environment variables take precedence over config file values.
+SEE ALSO
+  emailr config set    Set individual configuration values
+  emailr config list   View current configuration`).option("--api-key <key>","API key to use").option("--base-url <url>","Base URL for API").action(async t=>{try{t.apiKey?(G({apiKey:t.apiKey,baseUrl:t.baseUrl}),d("Configuration initialized!"),u(`Config file: ${I()}`)):(u("Initialize your Emailr CLI configuration:"),console.log(""),u("Run with --api-key flag:"),console.log("  emailr config init --api-key <your-api-key>"),console.log(""),u("Or set environment variable:"),console.log("  export EMAILR_API_KEY=<your-api-key>"));}catch(e){l(e instanceof Error?e.message:"Failed to initialize configuration"),process.exit(1);}}),i}function _e(){let i=new Command("broadcasts").description(`Manage broadcast campaigns
+USAGE
+  emailr broadcasts <subcommand> [options]
+DESCRIPTION
+  Create, schedule, send, and manage email broadcast campaigns. Broadcasts
+  are bulk email sends to a group of contacts, typically defined by a segment.
+  BROADCASTS, TEMPLATES, AND SEGMENTS
+  Broadcasts bring together templates and segments to send targeted emails:
+  - Templates: Define the email content (HTML, subject, variables)
+  - Segments: Define the audience (which contacts receive the email)
+  - Broadcasts: Combine a template with a segment and handle delivery
+  A typical workflow:
+  1. Create a template with your email content
+  2. Create a segment to target specific contacts
+  3. Create a broadcast linking the template and segment
+  4. Send immediately or schedule for later
+SUBCOMMANDS
+  list               List all broadcasts with optional status filter
+  get <id>           Get broadcast details and delivery statistics
+  create             Create a new broadcast campaign
+  send <id>          Send a broadcast immediately
+  schedule <id>      Schedule a broadcast for future delivery
+  cancel <id>        Cancel a scheduled broadcast
+  delete <id>        Delete a broadcast
+BROADCAST STATUS VALUES
+  draft              Broadcast created but not yet sent or scheduled
+  scheduled          Broadcast scheduled for future delivery
+  sending            Broadcast is currently being sent
+  sent               Broadcast has been fully delivered
+OPTIONS
+  --format <format>  Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json      Machine-readable JSON output
+  --format table     Human-readable table output (default)
+SCHEDULING OPTION
+  --schedule <datetime>  Schedule time in ISO 8601 format
+  ISO 8601 Datetime Format Examples:
+    2024-12-25T10:00:00Z           UTC time
+    2024-12-25T10:00:00-05:00      Eastern Time (UTC-5)
+    2024-12-25T10:00:00+01:00      Central European Time (UTC+1)
+    2024-12-25T15:30:00Z           Specific time with minutes
+  Note: Always include timezone offset or 'Z' for UTC to avoid ambiguity.
+EXAMPLES
+  # List all broadcasts
+  emailr broadcasts list
+  # List only scheduled broadcasts
+  emailr broadcasts list --status scheduled
+  # Get broadcast details with delivery stats
+  emailr broadcasts get brd_abc123
+  # Create a broadcast using a template and segment
+  emailr broadcasts create --name "Weekly Newsletter" \\
+    --subject "This Week's Updates" \\
+    --from "newsletter@example.com" \\
+    --template tpl_abc123 \\
+    --segment seg_xyz789
+  # Create a broadcast with inline HTML
+  emailr broadcasts create --name "Flash Sale" \\
+    --subject "24-Hour Flash Sale!" \\
+    --from "sales@example.com" \\
+    --segment seg_xyz789 \\
+    --html "<h1>Flash Sale</h1><p>Don't miss out!</p>"
+  # Create and schedule a broadcast
+  emailr broadcasts create --name "Holiday Promo" \\
+    --subject "Holiday Special" \\
+    --from "promo@example.com" \\
+    --template tpl_abc123 \\
+    --segment seg_xyz789 \\
+    --schedule "2024-12-25T10:00:00Z"
+  # Send a draft broadcast immediately
+  emailr broadcasts send brd_abc123
+  # Schedule an existing broadcast
+  emailr broadcasts schedule brd_abc123 --at "2024-12-25T10:00:00Z"
+  # Cancel a scheduled broadcast
+  emailr broadcasts cancel brd_abc123
+  # Delete a broadcast
+  emailr broadcasts delete brd_abc123
+  # Get JSON output for scripting
+  emailr broadcasts list --format json
+SEE ALSO
+  emailr templates   Manage email templates
+  emailr segments    Manage contact segments
+  emailr contacts    Manage individual contacts`);return i.command("list").description(`List all broadcasts
+USAGE
+  emailr broadcasts list [options]
+DESCRIPTION
+  Retrieves a list of all broadcast campaigns. Supports filtering by status
+  and limiting the number of results returned.
+OPTIONS
+  --status <status>    Filter by status: draft | scheduled | sending | sent
+  --limit <count>      Number of broadcasts to return (default: 20)
+  --format <format>    Output format: json | table (default: table)
+STATUS VALUES
+  draft                Broadcast created but not yet sent or scheduled
+  scheduled            Broadcast scheduled for future delivery
+  sending              Broadcast is currently being sent
+  sent                 Broadcast has been fully delivered
+OUTPUT FORMATS
+  --format json        Machine-readable JSON array of broadcast objects
+  --format table       Human-readable table with columns: ID, Name, Subject, Status, Recipients, Sent, Created
+EXAMPLES
+  # List all broadcasts
+  emailr broadcasts list
+  # List only draft broadcasts
+  emailr broadcasts list --status draft
+  # List only scheduled broadcasts
+  emailr broadcasts list --status scheduled
+  # List sent broadcasts
+  emailr broadcasts list --status sent
+  # List more broadcasts
+  emailr broadcasts list --limit 50
+  # Get JSON output for scripting
+  emailr broadcasts list --format json
+  # Pipe JSON to jq for processing
+  emailr broadcasts list --format json | jq '.[] | select(.status == "scheduled")'`).option("--status <status>","Filter by status (draft, scheduled, sending, sent)").option("--limit <number>","Number of broadcasts to return","20").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),r=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).broadcasts.list({status:t.status,limit:parseInt(t.limit)});if(t.format==="json")c(r,"json");else {if(r.length===0){console.log("No broadcasts found.");return}let o=r.map(n=>({ID:n.id,Name:n.name,Subject:n.subject.substring(0,30)+(n.subject.length>30?"...":""),Status:n.status,Recipients:n.total_recipients||0,Sent:n.sent_count||0,Created:new Date(n.created_at).toLocaleDateString()}));c(o,"table");}}catch(e){l(e instanceof Error?e.message:"Failed to list broadcasts"),process.exit(1);}}),i.command("get <broadcast_id>").description(`Get broadcast details
+USAGE
+  emailr broadcasts get <broadcast_id> [options]
+DESCRIPTION
+  Retrieves detailed information about a specific broadcast including
+  delivery statistics (sent, delivered, opened, clicked, bounced).
+ARGUMENTS
+  <broadcast_id>       The unique broadcast identifier (e.g., brd_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Full broadcast object with all fields and statistics
+  --format table       Summary table with broadcast details and delivery stats
+DELIVERY STATISTICS
+  Total Recipients     Number of contacts targeted by the broadcast
+  Sent Count           Number of emails sent
+  Delivered            Number of emails successfully delivered
+  Opened               Number of unique opens
+  Clicked              Number of unique clicks
+  Bounced              Number of bounced emails
+EXAMPLES
+  # Get broadcast details
+  emailr broadcasts get brd_abc123
+  # Get full broadcast data as JSON
+  emailr broadcasts get brd_abc123 --format json
+  # Pipe JSON to jq for processing
+  emailr broadcasts get brd_abc123 --format json | jq '{sent: .sent_count, opened: .opened_count}'`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).broadcasts.get(t);e.format==="json"?c(o,"json"):c({ID:o.id,Name:o.name,Subject:o.subject,"From Email":o.from_email,Status:o.status,"Total Recipients":o.total_recipients||0,"Sent Count":o.sent_count||0,Delivered:o.delivered_count||0,Opened:o.opened_count||0,Clicked:o.clicked_count||0,Bounced:o.bounced_count||0,"Scheduled At":o.scheduled_at||"N/A","Started At":o.started_at||"N/A","Completed At":o.completed_at||"N/A","Created At":o.created_at},"table");}catch(a){l(a instanceof Error?a.message:"Failed to get broadcast"),process.exit(1);}}),i.command("create").description(`Create a new broadcast
+USAGE
+  emailr broadcasts create --name <name> --subject <subject> --from <email> [options]
+DESCRIPTION
+  Creates a new broadcast campaign. You can use a template for content or
+  provide inline HTML/text. Target recipients using a segment ID.
+OPTIONS
+  --name <broadcast_name>      Broadcast name for internal reference (required)
+  --subject <subject_line>     Email subject line (required)
+  --from <email_address>       Sender email address (required)
+  --template <template_id>     Template ID to use for content
+  --segment <segment_id>       Segment ID to target recipients
+  --html <html_content>        Inline HTML content (alternative to --template)
+  --text <text_content>        Plain text content
+  --schedule <datetime>        Schedule time in ISO 8601 format
+  --format <format>            Output format: json | table (default: table)
+CONTENT OPTIONS
+  Use either --template OR --html/--text for content:
+  - --template: Use a pre-built template (recommended for reusable content)
+  - --html/--text: Provide inline content (good for one-off emails)
+SCHEDULING OPTION
+  --schedule <datetime>  Schedule time in ISO 8601 format
+  ISO 8601 Datetime Format Examples:
+    2024-12-25T10:00:00Z           UTC time
+    2024-12-25T10:00:00-05:00      Eastern Time (UTC-5)
+    2024-12-25T10:00:00+01:00      Central European Time (UTC+1)
+  If not specified, broadcast is created as draft and can be sent later.
+OUTPUT FORMATS
+  --format json                Full broadcast object with all fields
+  --format table               Summary table with ID, Name, Status, Scheduled At
+EXAMPLES
+  # Create broadcast with template and segment
+  emailr broadcasts create --name "Weekly Newsletter" \\
+    --subject "This Week's Updates" \\
+    --from "newsletter@example.com" \\
+    --template tpl_abc123 \\
+    --segment seg_xyz789
+  # Create broadcast with inline HTML
+  emailr broadcasts create --name "Flash Sale" \\
+    --subject "24-Hour Flash Sale!" \\
+    --from "sales@example.com" \\
+    --segment seg_xyz789 \\
+    --html "<h1>Flash Sale</h1><p>Don't miss out!</p>"
+  # Create and schedule broadcast for Christmas morning UTC
+  emailr broadcasts create --name "Holiday Promo" \\
+    --subject "Holiday Special" \\
+    --from "promo@example.com" \\
+    --template tpl_abc123 \\
+    --segment seg_xyz789 \\
+    --schedule "2024-12-25T10:00:00Z"
+  # Create broadcast scheduled for 9 AM Eastern
+  emailr broadcasts create --name "Morning Update" \\
+    --subject "Good Morning!" \\
+    --from "updates@example.com" \\
+    --template tpl_abc123 \\
+    --segment seg_xyz789 \\
+    --schedule "2024-06-15T09:00:00-04:00"
+  # Get JSON output for scripting
+  emailr broadcasts create --name "Test" --subject "Test" \\
+    --from "test@example.com" --html "<p>Test</p>" --format json
+SEE ALSO
+  emailr templates   Create and manage email templates
+  emailr segments    Create and manage contact segments`).requiredOption("--name <name>","Broadcast name").requiredOption("--subject <subject>","Email subject").requiredOption("--from <email>","Sender email address").option("--template <id>","Template ID to use").option("--segment <id>","Segment ID to target").option("--html <html>","HTML content").option("--text <text>","Plain text content").option("--schedule <datetime>","Schedule time (ISO 8601)").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),r=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).broadcasts.create({name:t.name,subject:t.subject,from_email:t.from,template_id:t.template,segment_id:t.segment,html_content:t.html,text_content:t.text,scheduled_at:t.schedule});t.format==="json"?c(r,"json"):(d("Broadcast created successfully!"),c({ID:r.id,Name:r.name,Status:r.status,"Scheduled At":r.scheduled_at||"Not scheduled"},"table"));}catch(e){l(e instanceof Error?e.message:"Failed to create broadcast"),process.exit(1);}}),i.command("send <broadcast_id>").description(`Send a broadcast immediately
+USAGE
+  emailr broadcasts send <broadcast_id> [options]
+DESCRIPTION
+  Sends a broadcast immediately to all recipients in the target segment.
+  The broadcast must be in 'draft' or 'scheduled' status. Once sent,
+  the status changes to 'sending' and then 'sent' when complete.
+ARGUMENTS
+  <broadcast_id>       The unique broadcast identifier (e.g., brd_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { success: boolean, sent: number, total: number }
+  --format table       Human-readable summary with success status and counts
+EXAMPLES
+  # Send a broadcast immediately
+  emailr broadcasts send brd_abc123
+  # Get JSON output for scripting
+  emailr broadcasts send brd_abc123 --format json
+  # Extract sent count from JSON
+  emailr broadcasts send brd_abc123 --format json | jq '.sent'
+NOTE
+  Sending is asynchronous. The command returns when sending starts,
+  not when all emails are delivered. Use 'emailr broadcasts get' to
+  check delivery progress.`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).broadcasts.send(t);e.format==="json"?c(o,"json"):(d("Broadcast sent successfully!"),c({Success:o.success,Sent:o.sent,Total:o.total},"table"));}catch(a){l(a instanceof Error?a.message:"Failed to send broadcast"),process.exit(1);}}),i.command("schedule <broadcast_id>").description(`Schedule a broadcast for future delivery
+USAGE
+  emailr broadcasts schedule <broadcast_id> --at <datetime> [options]
+DESCRIPTION
+  Schedules a broadcast to be sent at a specific time. The broadcast
+  must be in 'draft' status. After scheduling, the status changes to
+  'scheduled'. Use 'cancel' to unschedule if needed.
+ARGUMENTS
+  <broadcast_id>       The unique broadcast identifier (e.g., brd_abc123)
+OPTIONS
+  --at <datetime>      Schedule time in ISO 8601 format (required)
+  --format <format>    Output format: json | table (default: table)
+ISO 8601 DATETIME FORMAT
+  The --at option requires a datetime in ISO 8601 format with timezone:
+  Format: YYYY-MM-DDTHH:MM:SS\xB1HH:MM or YYYY-MM-DDTHH:MM:SSZ
+  Examples:
+    2024-12-25T10:00:00Z           UTC time (Z = Zulu/UTC)
+    2024-12-25T10:00:00-05:00      Eastern Standard Time (UTC-5)
+    2024-12-25T10:00:00-04:00      Eastern Daylight Time (UTC-4)
+    2024-12-25T10:00:00+01:00      Central European Time (UTC+1)
+    2024-12-25T10:00:00+09:00      Japan Standard Time (UTC+9)
+    2024-06-15T15:30:00Z           Specific time with minutes
+  Always include timezone to avoid ambiguity.
+OUTPUT FORMATS
+  --format json        Full broadcast object with scheduled_at field
+  --format table       Summary table with ID, Name, Status, Scheduled At
+EXAMPLES
+  # Schedule for Christmas morning UTC
+  emailr broadcasts schedule brd_abc123 --at "2024-12-25T10:00:00Z"
+  # Schedule for 9 AM Eastern Time
+  emailr broadcasts schedule brd_abc123 --at "2024-06-15T09:00:00-04:00"
+  # Schedule for noon Central European Time
+  emailr broadcasts schedule brd_abc123 --at "2024-06-15T12:00:00+01:00"
+  # Get JSON output for scripting
+  emailr broadcasts schedule brd_abc123 --at "2024-12-25T10:00:00Z" --format json
+SEE ALSO
+  emailr broadcasts cancel   Cancel a scheduled broadcast`).requiredOption("--at <datetime>","Schedule time (ISO 8601)").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).broadcasts.schedule(t,e.at);e.format==="json"?c(o,"json"):(d("Broadcast scheduled successfully!"),c({ID:o.id,Name:o.name,Status:o.status,"Scheduled At":o.scheduled_at},"table"));}catch(a){l(a instanceof Error?a.message:"Failed to schedule broadcast"),process.exit(1);}}),i.command("cancel <broadcast_id>").description(`Cancel a scheduled broadcast
+USAGE
+  emailr broadcasts cancel <broadcast_id> [options]
+DESCRIPTION
+  Cancels a scheduled broadcast, returning it to 'draft' status.
+  The broadcast can then be rescheduled or sent immediately.
+  Only broadcasts with 'scheduled' status can be cancelled.
+ARGUMENTS
+  <broadcast_id>       The unique broadcast identifier (e.g., brd_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { success: boolean }
+  --format table       Human-readable success message
+EXAMPLES
+  # Cancel a scheduled broadcast
+  emailr broadcasts cancel brd_abc123
+  # Get JSON output for scripting
+  emailr broadcasts cancel brd_abc123 --format json
+NOTE
+  Broadcasts that are already 'sending' or 'sent' cannot be cancelled.`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).broadcasts.cancel(t);e.format==="json"?c(o,"json"):d("Broadcast cancelled successfully!");}catch(a){l(a instanceof Error?a.message:"Failed to cancel broadcast"),process.exit(1);}}),i.command("delete <broadcast_id>").description(`Delete a broadcast
+USAGE
+  emailr broadcasts delete <broadcast_id> [options]
+DESCRIPTION
+  Permanently deletes a broadcast. This action cannot be undone.
+  Delivery statistics and history will be lost.
+ARGUMENTS
+  <broadcast_id>       The unique broadcast identifier (e.g., brd_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { success: boolean }
+  --format table       Human-readable success message
+EXAMPLES
+  # Delete a broadcast
+  emailr broadcasts delete brd_abc123
+  # Get JSON output for scripting
+  emailr broadcasts delete brd_abc123 --format json
+WARNING
+  This action is permanent and cannot be undone.
+  All delivery statistics will be lost.`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).broadcasts.delete(t);e.format==="json"?c(o,"json"):d("Broadcast deleted successfully!");}catch(a){l(a instanceof Error?a.message:"Failed to delete broadcast"),process.exit(1);}}),i}function Ie(){let i=new Command("webhooks").description(`Manage webhooks
+USAGE
+  emailr webhooks <subcommand> [options]
+DESCRIPTION
+  Create, update, and manage webhook endpoints for receiving real-time
+  notifications about email and contact events. Webhooks allow you to
+  integrate Emailr with your own systems and automate workflows.
+SUBCOMMANDS
+  list               List all webhooks
+  get <id>           Get webhook details including secret
+  create             Create a new webhook endpoint
+  update <id>        Update webhook name, URL, or events
+  enable <id>        Enable a disabled webhook
+  disable <id>       Disable a webhook (stops event delivery)
+  delete <id>        Delete a webhook permanently
+AVAILABLE EVENT TYPES
+  Email Events:
+    email.sent              Email accepted for delivery
+    email.delivered         Email successfully delivered to recipient
+    email.bounced           Email permanently rejected by recipient server
+    email.complained        Recipient marked email as spam
+    email.opened            Recipient opened the email
+    email.clicked           Recipient clicked a link in the email
+    email.failed            Email delivery failed
+    email.delivery_delayed  Email delivery temporarily delayed
+  Contact Events:
+    contact.created         New contact added to audience
+    contact.updated         Contact information updated
+    contact.deleted         Contact removed from audience
+  Domain Events:
+    domain.verified              Domain identity verified
+    domain.verification_failed   Domain verification failed
+    domain.mail_from_verified    MAIL FROM domain verified
+    domain.mail_from_failed      MAIL FROM verification failed
+    domain.deactivated           Domain deactivated
+OPTIONS
+  --format <format>  Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json      Machine-readable JSON output
+  --format table     Human-readable table output (default)
+EVENTS OPTION FORMAT
+  The --events option accepts a comma-separated list of event types:
+  Single event:
+    --events "email.sent"
+  Multiple events:
+    --events "email.sent,email.delivered,email.bounced"
+  All email events:
+    --events "email.sent,email.delivered,email.bounced,email.complained,email.opened,email.clicked,email.failed"
+  Contact events:
+    --events "contact.created,contact.updated,contact.deleted"
+  Mixed events:
+    --events "email.delivered,email.bounced,contact.created"
+EXAMPLES
+  # List all webhooks
+  emailr webhooks list
+  # Get webhook details (includes secret for signature verification)
+  emailr webhooks get whk_abc123
+  # Create webhook for email delivery events
+  emailr webhooks create --name "Delivery Tracker" \\
+    --url "https://example.com/webhooks/emailr" \\
+    --events "email.sent,email.delivered,email.bounced"
+  # Create webhook for all email tracking events
+  emailr webhooks create --name "Email Analytics" \\
+    --url "https://example.com/webhooks/analytics" \\
+    --events "email.delivered,email.opened,email.clicked,email.bounced"
+  # Create webhook for contact changes
+  emailr webhooks create --name "CRM Sync" \\
+    --url "https://example.com/webhooks/crm" \\
+    --events "contact.created,contact.updated,contact.deleted"
+  # Update webhook URL
+  emailr webhooks update whk_abc123 --url "https://new-url.com/webhook"
+  # Update webhook events
+  emailr webhooks update whk_abc123 --events "email.sent,email.delivered"
+  # Disable webhook temporarily
+  emailr webhooks disable whk_abc123
+  # Re-enable webhook
+  emailr webhooks enable whk_abc123
+  # Delete webhook
+  emailr webhooks delete whk_abc123
+  # Get JSON output for scripting
+  emailr webhooks list --format json
+WEBHOOK PAYLOAD
+  Webhooks receive POST requests with JSON payloads:
+  {
+    "type": "email.delivered",
+    "created_at": "2024-02-22T23:41:12.126Z",
+    "data": {
+      "email_id": "em_abc123",
+      "to": "recipient@example.com",
+      "subject": "Your order confirmation"
+    }
+  }
+SIGNATURE VERIFICATION
+  Each webhook request includes an X-Emailr-Signature header.
+  Use the webhook secret (shown in 'get' command) to verify signatures.
+SEE ALSO
+  emailr domains     Manage sending domains
+  emailr send        Send emails directly`);return i.command("list").description(`List all webhooks
+USAGE
+  emailr webhooks list [options]
+DESCRIPTION
+  Retrieves a list of all webhook endpoints configured for your account.
+  Shows webhook ID, name, URL, subscribed events, and active status.
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Machine-readable JSON array of webhook objects
+  --format table       Human-readable table with columns: ID, Name, URL, Events, Active
+EXAMPLES
+  # List all webhooks
+  emailr webhooks list
+  # Get JSON output for scripting
+  emailr webhooks list --format json
+  # Filter active webhooks with jq
+  emailr webhooks list --format json | jq '.[] | select(.active == true)'
+  # Count webhooks
+  emailr webhooks list --format json | jq 'length'`).option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),r=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).webhooks.list();if(t.format==="json")c(r,"json");else {if(r.data.length===0){console.log("No webhooks found.");return}let o=r.data.map(n=>({ID:n.id,Name:n.name,URL:n.url.substring(0,40)+(n.url.length>40?"...":""),Events:n.events.join(", "),Active:n.active?"Yes":"No"}));c(o,"table");}}catch(e){l(e instanceof Error?e.message:"Failed to list webhooks"),process.exit(1);}}),i.command("get <webhook_id>").description(`Get webhook details
+USAGE
+  emailr webhooks get <webhook_id> [options]
+DESCRIPTION
+  Retrieves detailed information about a specific webhook including
+  the webhook secret used for signature verification.
+ARGUMENTS
+  <webhook_id>         The unique webhook identifier (e.g., whk_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Full webhook object with all fields including secret
+  --format table       Summary table with webhook details
+WEBHOOK SECRET
+  The secret is used to verify webhook signatures. Each webhook request
+  includes an X-Emailr-Signature header that you can verify using this secret.
+EXAMPLES
+  # Get webhook details
+  emailr webhooks get whk_abc123
+  # Get full webhook data as JSON
+  emailr webhooks get whk_abc123 --format json
+  # Extract just the secret
+  emailr webhooks get whk_abc123 --format json | jq -r '.secret'`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).webhooks.get(t);e.format==="json"?c(o,"json"):c({ID:o.id,Name:o.name,URL:o.url,Events:o.events.join(", "),Active:o.active?"Yes":"No",Secret:o.secret,"Created At":o.created_at},"table");}catch(a){l(a instanceof Error?a.message:"Failed to get webhook"),process.exit(1);}}),i.command("create").description(`Create a new webhook
+USAGE
+  emailr webhooks create --name <name> --url <url> --events <events> [options]
+DESCRIPTION
+  Creates a new webhook endpoint to receive real-time notifications
+  about email and contact events. The webhook is enabled by default.
+OPTIONS
+  --name <webhook_name>    Webhook name for identification (required)
+  --url <endpoint_url>     HTTPS URL to receive webhook POST requests (required)
+  --events <event_list>    Comma-separated list of event types (required)
+  --format <format>        Output format: json | table (default: table)
+AVAILABLE EVENT TYPES
+  Email Events:
+    email.sent              Email accepted for delivery
+    email.delivered         Email successfully delivered
+    email.bounced           Email permanently rejected
+    email.complained        Recipient marked as spam
+    email.opened            Recipient opened email
+    email.clicked           Recipient clicked link
+    email.failed            Delivery failed
+    email.delivery_delayed  Delivery temporarily delayed
+  Contact Events:
+    contact.created         New contact added
+    contact.updated         Contact updated
+    contact.deleted         Contact removed
+  Domain Events:
+    domain.verified              Domain verified
+    domain.verification_failed   Verification failed
+    domain.mail_from_verified    MAIL FROM verified
+    domain.mail_from_failed      MAIL FROM failed
+    domain.deactivated           Domain deactivated
+EVENTS FORMAT
+  Provide events as a comma-separated list (no spaces after commas):
+    --events "email.sent,email.delivered,email.bounced"
+OUTPUT FORMATS
+  --format json        Full webhook object including generated secret
+  --format table       Summary with ID, Name, URL, and Secret
+EXAMPLES
+  # Create webhook for delivery tracking
+  emailr webhooks create --name "Delivery Tracker" \\
+    --url "https://example.com/webhooks/emailr" \\
+    --events "email.sent,email.delivered,email.bounced"
+  # Create webhook for email analytics
+  emailr webhooks create --name "Analytics" \\
+    --url "https://analytics.example.com/hook" \\
+    --events "email.delivered,email.opened,email.clicked"
+  # Create webhook for CRM integration
+  emailr webhooks create --name "CRM Sync" \\
+    --url "https://crm.example.com/emailr" \\
+    --events "contact.created,contact.updated,contact.deleted"
+  # Create webhook for bounce handling
+  emailr webhooks create --name "Bounce Handler" \\
+    --url "https://example.com/bounces" \\
+    --events "email.bounced,email.complained"
+  # Get JSON output with secret
+  emailr webhooks create --name "Test" \\
+    --url "https://example.com/test" \\
+    --events "email.sent" --format json
+NOTE
+  Save the webhook secret returned by this command. You'll need it
+  to verify webhook signatures in your endpoint.`).requiredOption("--name <name>","Webhook name").requiredOption("--url <url>","Webhook URL").requiredOption("--events <events>","Events to subscribe to (comma-separated)").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),a=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),r=t.events.split(",").map(n=>n.trim()),o=await a.webhooks.create({name:t.name,url:t.url,events:r});t.format==="json"?c(o,"json"):(d("Webhook created successfully!"),c({ID:o.id,Name:o.name,URL:o.url,Secret:o.secret},"table"));}catch(e){l(e instanceof Error?e.message:"Failed to create webhook"),process.exit(1);}}),i.command("update <webhook_id>").description(`Update a webhook
+USAGE
+  emailr webhooks update <webhook_id> [options]
+DESCRIPTION
+  Updates an existing webhook's name, URL, or subscribed events.
+  Only provide the options you want to change.
+ARGUMENTS
+  <webhook_id>         The unique webhook identifier (e.g., whk_abc123)
+OPTIONS
+  --name <webhook_name>    New webhook name
+  --url <endpoint_url>     New webhook URL
+  --events <event_list>    New comma-separated list of events (replaces existing)
+  --format <format>        Output format: json | table (default: table)
+EVENTS FORMAT
+  The --events option replaces all existing events:
+    --events "email.sent,email.delivered"
+  To add events, first get current events, then include all in update.
+OUTPUT FORMATS
+  --format json        Updated webhook object
+  --format table       Summary with ID, Name, URL
+EXAMPLES
+  # Update webhook name
+  emailr webhooks update whk_abc123 --name "New Name"
+  # Update webhook URL
+  emailr webhooks update whk_abc123 --url "https://new-url.com/webhook"
+  # Update subscribed events
+  emailr webhooks update whk_abc123 --events "email.sent,email.delivered,email.bounced"
+  # Update multiple fields
+  emailr webhooks update whk_abc123 \\
+    --name "Updated Webhook" \\
+    --url "https://new-url.com/hook" \\
+    --events "email.delivered,email.bounced"
+  # Get JSON output
+  emailr webhooks update whk_abc123 --name "New Name" --format json`).option("--name <name>","New webhook name").option("--url <url>","New webhook URL").option("--events <events>","New events (comma-separated)").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),r=new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}),o={};e.name&&(o.name=e.name),e.url&&(o.url=e.url),e.events&&(o.events=e.events.split(",").map(s=>s.trim()));let n=await r.webhooks.update(t,o);e.format==="json"?c(n,"json"):(d("Webhook updated successfully!"),c({ID:n.id,Name:n.name,URL:n.url},"table"));}catch(a){l(a instanceof Error?a.message:"Failed to update webhook"),process.exit(1);}}),i.command("enable <webhook_id>").description(`Enable a webhook
+USAGE
+  emailr webhooks enable <webhook_id> [options]
+DESCRIPTION
+  Enables a disabled webhook to resume receiving event notifications.
+  Use this after fixing issues with your webhook endpoint.
+ARGUMENTS
+  <webhook_id>         The unique webhook identifier (e.g., whk_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { success: boolean, active: boolean }
+  --format table       Human-readable success message
+EXAMPLES
+  # Enable a webhook
+  emailr webhooks enable whk_abc123
+  # Get JSON output
+  emailr webhooks enable whk_abc123 --format json`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).webhooks.enable(t);e.format==="json"?c(o,"json"):d("Webhook enabled successfully!");}catch(a){l(a instanceof Error?a.message:"Failed to enable webhook"),process.exit(1);}}),i.command("disable <webhook_id>").description(`Disable a webhook
+USAGE
+  emailr webhooks disable <webhook_id> [options]
+DESCRIPTION
+  Disables a webhook to temporarily stop receiving event notifications.
+  Events that occur while disabled are not queued or retried.
+  Use 'enable' to resume receiving events.
+ARGUMENTS
+  <webhook_id>         The unique webhook identifier (e.g., whk_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { success: boolean, active: boolean }
+  --format table       Human-readable success message
+EXAMPLES
+  # Disable a webhook
+  emailr webhooks disable whk_abc123
+  # Get JSON output
+  emailr webhooks disable whk_abc123 --format json
+NOTE
+  Events are not queued while webhook is disabled. If you need to
+  temporarily stop processing, consider handling this in your endpoint.`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).webhooks.disable(t);e.format==="json"?c(o,"json"):d("Webhook disabled successfully!");}catch(a){l(a instanceof Error?a.message:"Failed to disable webhook"),process.exit(1);}}),i.command("delete <webhook_id>").description(`Delete a webhook
+USAGE
+  emailr webhooks delete <webhook_id> [options]
+DESCRIPTION
+  Permanently deletes a webhook endpoint. This action cannot be undone.
+  The webhook will immediately stop receiving events.
+ARGUMENTS
+  <webhook_id>         The unique webhook identifier (e.g., whk_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { success: boolean }
+  --format table       Human-readable success message
+EXAMPLES
+  # Delete a webhook
+  emailr webhooks delete whk_abc123
+  # Get JSON output
+  emailr webhooks delete whk_abc123 --format json
+WARNING
+  This action is permanent and cannot be undone.
+  Create a new webhook if you need to restore functionality.`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).webhooks.delete(t);e.format==="json"?c(o,"json"):d("Webhook deleted successfully!");}catch(a){l(a instanceof Error?a.message:"Failed to delete webhook"),process.exit(1);}}),i}function ke(){let i=new Command("segments").description(`Manage contact segments
+USAGE
+  emailr segments <subcommand> [options]
+DESCRIPTION
+  Create, update, list, and manage contact segments. Segments are dynamic
+  groups of contacts defined by conditions. Use segments to target specific
+  audiences for broadcasts and campaigns.
+SUBCOMMANDS
+  list               List all segments
+  get <id>           Get a segment by ID
+  create             Create a new segment with conditions
+  update <id>        Update an existing segment
+  delete <id>        Delete a segment
+  count <id>         Get the number of contacts in a segment
+OPTIONS
+  --format <format>  Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json      Machine-readable JSON output
+  --format table     Human-readable table output (default)
+CONDITIONS OPTION
+  --conditions <json>  Segment conditions as JSON array
+  Conditions define which contacts belong to a segment. Each condition
+  specifies a field, operator, and value to match against.
+  Condition Structure:
+    {
+      "field": "<field_name>",
+      "operator": "<operator>",
+      "value": "<value>"
+    }
+  Available Fields:
+    - email           Contact email address
+    - first_name      Contact first name
+    - last_name       Contact last name
+    - subscribed      Subscription status (true/false)
+    - created_at      Contact creation date
+    - metadata.*      Custom metadata fields (e.g., metadata.plan)
+  Available Operators:
+    - equals          Exact match
+    - not_equals      Does not match
+    - contains        Contains substring (strings only)
+    - not_contains    Does not contain substring
+    - starts_with     Starts with prefix
+    - ends_with       Ends with suffix
+    - greater_than    Greater than (numbers/dates)
+    - less_than       Less than (numbers/dates)
+    - is_set          Field has a value
+    - is_not_set      Field is empty/null
+COMMON SEGMENT CONDITION EXAMPLES
+  # Subscribed contacts only
+  '[{"field": "subscribed", "operator": "equals", "value": true}]'
+  # Contacts with Gmail addresses
+  '[{"field": "email", "operator": "contains", "value": "@gmail.com"}]'
+  # Premium plan users (using metadata)
+  '[{"field": "metadata.plan", "operator": "equals", "value": "premium"}]'
+  # Contacts created in the last 30 days
+  '[{"field": "created_at", "operator": "greater_than", "value": "2024-01-01"}]'
+  # Multiple conditions (AND logic)
+  '[
+    {"field": "subscribed", "operator": "equals", "value": true},
+    {"field": "metadata.plan", "operator": "equals", "value": "enterprise"}
+  ]'
+  # VIP customers with high engagement score
+  '[
+    {"field": "metadata.vip", "operator": "equals", "value": true},
+    {"field": "metadata.score", "operator": "greater_than", "value": 80}
+  ]'
+EXAMPLES
+  # List all segments
+  emailr segments list
+  # Get a specific segment
+  emailr segments get seg_abc123
+  # Create a segment for subscribed contacts
+  emailr segments create --name "Active Subscribers" \\
+    --conditions '[{"field": "subscribed", "operator": "equals", "value": true}]'
+  # Create a segment for premium users
+  emailr segments create --name "Premium Users" \\
+    --description "Users on premium plan" \\
+    --conditions '[{"field": "metadata.plan", "operator": "equals", "value": "premium"}]'
+  # Update segment conditions
+  emailr segments update seg_abc123 \\
+    --conditions '[{"field": "metadata.plan", "operator": "equals", "value": "enterprise"}]'
+  # Get contact count in a segment
+  emailr segments count seg_abc123
+  # Delete a segment
+  emailr segments delete seg_abc123
+  # Get JSON output for scripting
+  emailr segments list --format json
+SEE ALSO
+  emailr contacts     Manage individual contacts
+  emailr broadcasts   Send emails to segments`);return i.command("list").description(`List all segments
+USAGE
+  emailr segments list [options]
+DESCRIPTION
+  Retrieves a list of all segments in your account. Returns segment ID,
+  name, description, and creation date.
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Machine-readable JSON array of segment objects
+  --format table       Human-readable table with columns: ID, Name, Description, Created At
+EXAMPLES
+  # List all segments
+  emailr segments list
+  # Get JSON output for scripting
+  emailr segments list --format json
+  # Pipe JSON to jq for processing
+  emailr segments list --format json | jq '.[].name'`).option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),r=await new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}).segments.list();if(t.format==="json")c(r,"json");else {if(r.length===0){console.log("No segments found.");return}let o=r.map(n=>({ID:n.id,Name:n.name,Description:(n.description||"").substring(0,30)+((n.description?.length||0)>30?"...":""),"Created At":new Date(n.created_at).toLocaleDateString()}));c(o,"table");}}catch(e){l(e instanceof Error?e.message:"Failed to list segments"),process.exit(1);}}),i.command("get <segment_id>").description(`Get segment details
+USAGE
+  emailr segments get <segment_id> [options]
+DESCRIPTION
+  Retrieves detailed information about a specific segment including
+  its name, description, conditions, and timestamps.
+ARGUMENTS
+  <segment_id>         The unique segment identifier (e.g., seg_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Full segment object including conditions array
+  --format table       Summary table with ID, Name, Description, Conditions, Created At, Updated At
+EXAMPLES
+  # Get segment details
+  emailr segments get seg_abc123
+  # Get full segment data as JSON
+  emailr segments get seg_abc123 --format json
+  # Pipe JSON to jq to view conditions
+  emailr segments get seg_abc123 --format json | jq '.conditions'`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).segments.get(t);e.format==="json"?c(o,"json"):c({ID:o.id,Name:o.name,Description:o.description||"N/A",Conditions:JSON.stringify(o.conditions),"Created At":o.created_at,"Updated At":o.updated_at},"table");}catch(a){l(a instanceof Error?a.message:"Failed to get segment"),process.exit(1);}}),i.command("create").description(`Create a new segment
+USAGE
+  emailr segments create --name <segment_name> --conditions <json> [options]
+DESCRIPTION
+  Creates a new segment with the specified name and conditions. Conditions
+  define which contacts belong to the segment using field/operator/value rules.
+OPTIONS
+  --name <segment_name>      Segment name (required)
+  --conditions <json>        Segment conditions as JSON array (required)
+  --description <text>       Segment description
+  --format <format>          Output format: json | table (default: table)
+CONDITIONS FORMAT
+  Conditions are specified as a JSON array of condition objects:
+    '[{"field": "<field>", "operator": "<op>", "value": "<val>"}]'
+  See 'emailr segments --help' for full conditions documentation.
+OUTPUT FORMATS
+  --format json              Full segment object with all fields
+  --format table             Summary table with ID and Name
+EXAMPLES
+  # Create segment for subscribed contacts
+  emailr segments create --name "Active Subscribers" \\
+    --conditions '[{"field": "subscribed", "operator": "equals", "value": true}]'
+  # Create segment with description
+  emailr segments create --name "Premium Users" \\
+    --description "Users on premium plan" \\
+    --conditions '[{"field": "metadata.plan", "operator": "equals", "value": "premium"}]'
+  # Create segment with multiple conditions
+  emailr segments create --name "Engaged Premium" \\
+    --conditions '[
+      {"field": "subscribed", "operator": "equals", "value": true},
+      {"field": "metadata.plan", "operator": "equals", "value": "premium"}
+    ]'
+  # Create segment for Gmail users
+  emailr segments create --name "Gmail Users" \\
+    --conditions '[{"field": "email", "operator": "contains", "value": "@gmail.com"}]'
+  # Get JSON output for scripting
+  emailr segments create --name "Test" \\
+    --conditions '[{"field": "subscribed", "operator": "equals", "value": true}]' \\
+    --format json`).requiredOption("--name <name>","Segment name").requiredOption("--conditions <json>","Segment conditions as JSON").option("--description <description>","Segment description").option("--format <format>","Output format (json|table)","table").action(async t=>{try{let e=m(),a=new Emailr({apiKey:e.apiKey,baseUrl:e.baseUrl}),r;try{r=JSON.parse(t.conditions);}catch{l("Invalid JSON for --conditions"),process.exit(1);}let o=await a.segments.create({name:t.name,description:t.description,conditions:r});t.format==="json"?c(o,"json"):(d("Segment created successfully!"),c({ID:o.id,Name:o.name},"table"));}catch(e){l(e instanceof Error?e.message:"Failed to create segment"),process.exit(1);}}),i.command("update <segment_id>").description(`Update a segment
+USAGE
+  emailr segments update <segment_id> [options]
+DESCRIPTION
+  Updates an existing segment with new values. Only specified fields
+  are updated; omitted fields remain unchanged.
+ARGUMENTS
+  <segment_id>               The unique segment identifier (e.g., seg_abc123)
+OPTIONS
+  --name <segment_name>      New segment name
+  --description <text>       New description
+  --conditions <json>        New conditions as JSON array (replaces existing)
+  --format <format>          Output format: json | table (default: table)
+CONDITIONS FORMAT
+  Conditions are specified as a JSON array of condition objects.
+  Note: This replaces all existing conditions, not individual ones.
+  See 'emailr segments --help' for full conditions documentation.
+OUTPUT FORMATS
+  --format json              Full updated segment object
+  --format table             Summary table with ID and Name
+EXAMPLES
+  # Update segment name
+  emailr segments update seg_abc123 --name "New Segment Name"
+  # Update segment description
+  emailr segments update seg_abc123 --description "Updated description"
+  # Update segment conditions
+  emailr segments update seg_abc123 \\
+    --conditions '[{"field": "metadata.plan", "operator": "equals", "value": "enterprise"}]'
+  # Update multiple fields
+  emailr segments update seg_abc123 \\
+    --name "Enterprise Users" \\
+    --description "Users on enterprise plan" \\
+    --conditions '[{"field": "metadata.plan", "operator": "equals", "value": "enterprise"}]'
+  # Get JSON output
+  emailr segments update seg_abc123 --name "Updated" --format json`).option("--name <name>","New segment name").option("--description <description>","New description").option("--conditions <json>","New conditions as JSON").option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),r=new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}),o={};if(e.name&&(o.name=e.name),e.description&&(o.description=e.description),e.conditions)try{o.conditions=JSON.parse(e.conditions);}catch{l("Invalid JSON for --conditions"),process.exit(1);}let n=await r.segments.update(t,o);e.format==="json"?c(n,"json"):(d("Segment updated successfully!"),c({ID:n.id,Name:n.name},"table"));}catch(a){l(a instanceof Error?a.message:"Failed to update segment"),process.exit(1);}}),i.command("delete <segment_id>").description(`Delete a segment
+USAGE
+  emailr segments delete <segment_id>
+DESCRIPTION
+  Permanently deletes a segment. This action cannot be undone.
+  Contacts in the segment are NOT deleted, only the segment definition.
+ARGUMENTS
+  <segment_id>         The unique segment identifier (e.g., seg_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { success: boolean }
+  --format table       Human-readable success message
+EXAMPLES
+  # Delete a segment
+  emailr segments delete seg_abc123
+WARNING
+  This action is permanent and cannot be undone.
+  Any broadcasts targeting this segment will need to be updated.`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).segments.delete(t);e.format==="json"?c(o,"json"):d("Segment deleted successfully!");}catch(a){l(a instanceof Error?a.message:"Failed to delete segment"),process.exit(1);}}),i.command("count <segment_id>").description(`Get the number of contacts in a segment
+USAGE
+  emailr segments count <segment_id> [options]
+DESCRIPTION
+  Returns the count of contacts that match the segment's conditions.
+  Useful for verifying segment conditions before sending broadcasts.
+ARGUMENTS
+  <segment_id>         The unique segment identifier (e.g., seg_abc123)
+OPTIONS
+  --format <format>    Output format: json | table (default: table)
+OUTPUT FORMATS
+  --format json        Returns: { count: <number> }
+  --format table       Human-readable message with contact count
+EXAMPLES
+  # Get contact count in a segment
+  emailr segments count seg_abc123
+  # Get JSON output for scripting
+  emailr segments count seg_abc123 --format json
+  # Extract just the count value
+  emailr segments count seg_abc123 --format json | jq '.count'
+TIP
+  Use this before sending broadcasts to verify your segment
+  targets the expected number of contacts.`).option("--format <format>","Output format (json|table)","table").action(async(t,e)=>{try{let a=m(),o=await new Emailr({apiKey:a.apiKey,baseUrl:a.baseUrl}).segments.getContactsCount(t);e.format==="json"?c(o,"json"):console.log(`Segment contains ${o.count} contacts.`);}catch(a){l(a instanceof Error?a.message:"Failed to get segment count"),process.exit(1);}}),i}function st(i){try{let t=i.startsWith("http")?i:`http://localhost${i}`,e=new URL(t);return {key:e.searchParams.get("key")??void 0,code:e.searchParams.get("code")??void 0,state:e.searchParams.get("state")??void 0,error:e.searchParams.get("error")??void 0,message:e.searchParams.get("message")??void 0}}catch{return {}}}function lt(){return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Login Successful - Emailr CLI</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      min-height: 100vh;
+      margin: 0;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: #fff;
+    }
+    .container {
+      text-align: center;
+      padding: 2rem;
+      background: rgba(255, 255, 255, 0.1);
+      border-radius: 16px;
+      backdrop-filter: blur(10px);
+      max-width: 400px;
+    }
+    .icon {
+      font-size: 4rem;
+      margin-bottom: 1rem;
+    }
+    h1 {
+      margin: 0 0 1rem 0;
+      font-size: 1.5rem;
+    }
+    p {
+      margin: 0;
+      opacity: 0.9;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="icon">\u2713</div>
+    <h1>Login Successful!</h1>
+    <p>You can close this window and return to your terminal.</p>
+  </div>
+</body>
+</html>`}function ee(i){return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Login Failed - Emailr CLI</title>
   <style>
     body {
       font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif;
@@ -444,11 +2889,11 @@ When done:`),console.log(`  emailr templates create --name "Template Name" --sub
     <div class="icon">\u2717</div>
     <h1>Login Failed</h1>
     <p>Something went wrong during authentication.</p>
-    <div class="error-message">${n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}</div>
+    <div class="error-message">${i.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}</div>
     <p style="margin-top: 1rem;">Please close this window and try again.</p>
   </div>
 </body>
-</html>`}function Te(){let n=null,t=0,e=null,o=null,i=null;return {async start(){return new Promise((a,r)=>{n=qe.createServer((s,f)=>{if(s.method!=="GET"||!s.url?.startsWith("/callback")){f.writeHead(404,{"Content-Type":"text/plain"}),f.end("Not Found");return}let g=it(s.url);if(i&&g.state!==i){f.writeHead(400,{"Content-Type":"text/html"}),f.end(ee("Security verification failed. State parameter mismatch.")),e&&e({success:false,error:"State parameter mismatch"});return}if(g.error){let b=g.message||g.error;f.writeHead(200,{"Content-Type":"text/html"}),f.end(ee(b)),e&&e({success:false,error:b});return}let x=g.key||g.code;if(x){f.writeHead(200,{"Content-Type":"text/html"}),f.end(st()),e&&e({success:true,apiKey:x});return}f.writeHead(400,{"Content-Type":"text/html"}),f.end(ee("Invalid callback: missing required parameters.")),e&&e({success:false,error:"Invalid callback: missing required parameters"});}),n.listen(0,"127.0.0.1",()=>{let s=n.address();s&&typeof s=="object"?(t=s.port,a({port:t,url:`http://127.0.0.1:${t}/callback`})):r(new Error("Failed to get server address"));}),n.on("error",s=>{r(new Error(`Failed to start callback server: ${s.message}`));});})},async waitForCallback(a,r){return i=a,new Promise(s=>{e=s,o=setTimeout(()=>{e&&e({success:false,error:"Login timed out. Please try again."});},r);})},async stop(){if(o&&(clearTimeout(o),o=null),n)return new Promise(a=>{n.close(()=>{n=null,a();});})}}}function Pe(){return ct.randomBytes(32).toString("hex")}function Ie(n){return new Promise(t=>{let e=process.platform,o;switch(e){case "darwin":o=`open "${n}"`;break;case "win32":o=`start "" "${n}"`;break;default:o=`xdg-open "${n}"`;break}exec(o,i=>{t(!i);});})}var W=120,dt=process.env.EMAILR_WEB_URL||"https://app.emailr.dev";function pt(n,t){let e=`http://127.0.0.1:${t}/callback`,o=new URLSearchParams({state:n,callback_url:e});return `${dt}/consent/authorize?${o.toString()}`}function Ue(){return new Command("login").description("Log in to Emailr via browser authentication").option("-t, --timeout <seconds>","Timeout in seconds",String(W)).option("--no-browser","Don't automatically open the browser").action(async t=>{await ft({timeout:parseInt(t.timeout,10)||W,noBrowser:t.browser===false});})}async function ft(n){let t=Te(),e=(n.timeout||W)*1e3;try{p("Starting authentication server...");let{port:o,url:i}=await t.start(),a=Pe(),r=pt(a,o);console.log(""),p("Authorization URL:"),console.log(`  ${r}`),console.log(""),n.noBrowser?p("Please open the URL above in your browser to continue."):await Ie(r)?p("Browser opened. Please complete authentication in your browser."):(k("Could not open browser automatically."),p("Please open the URL above in your browser to continue.")),console.log(""),p(`Waiting for authentication (timeout: ${n.timeout||W}s)...`);let s=await t.waitForCallback(a,e);s.success&&s.apiKey?(A({apiKey:s.apiKey}),console.log(""),d("Login successful!"),p(`API key saved to: ${j()}`),p("You can now use the Emailr CLI.")):(console.log(""),l(s.error||"Authentication failed."),p("Please try again or use manual configuration:"),console.log("  emailr config set api-key <your-api-key>"),process.exit(1));}catch(o){console.log(""),l(o instanceof Error?o.message:"An unexpected error occurred."),p("Please try again or use manual configuration:"),console.log("  emailr config set api-key <your-api-key>"),process.exit(1);}finally{await t.stop();}}var oe=U.join(G.homedir(),".config","opencode","skills","emailr-cli"),ht=`---
+</html>`}function je(){let i=null,t=0,e=null,a=null,r=null;return {async start(){return new Promise((o,n)=>{i=Je.createServer((s,p)=>{if(s.method!=="GET"||!s.url?.startsWith("/callback")){p.writeHead(404,{"Content-Type":"text/plain"}),p.end("Not Found");return}let b=st(s.url);if(r&&b.state!==r){p.writeHead(400,{"Content-Type":"text/html"}),p.end(ee("Security verification failed. State parameter mismatch.")),e&&e({success:false,error:"State parameter mismatch"});return}if(b.error){let h=b.message||b.error;p.writeHead(200,{"Content-Type":"text/html"}),p.end(ee(h)),e&&e({success:false,error:h});return}let T=b.key||b.code;if(T){p.writeHead(200,{"Content-Type":"text/html"}),p.end(lt()),e&&e({success:true,apiKey:T});return}p.writeHead(400,{"Content-Type":"text/html"}),p.end(ee("Invalid callback: missing required parameters.")),e&&e({success:false,error:"Invalid callback: missing required parameters"});}),i.listen(0,"127.0.0.1",()=>{let s=i.address();s&&typeof s=="object"?(t=s.port,o({port:t,url:`http://127.0.0.1:${t}/callback`})):n(new Error("Failed to get server address"));}),i.on("error",s=>{n(new Error(`Failed to start callback server: ${s.message}`));});})},async waitForCallback(o,n){return r=o,new Promise(s=>{e=s,a=setTimeout(()=>{e&&e({success:false,error:"Login timed out. Please try again."});},n);})},async stop(){if(a&&(clearTimeout(a),a=null),i)return new Promise(o=>{i.close(()=>{i=null,o();});})}}}function Ce(){return ct.randomBytes(32).toString("hex")}function Ae(i){return new Promise(t=>{let e=process.platform,a;switch(e){case "darwin":a=`open "${i}"`;break;case "win32":a=`start "" "${i}"`;break;default:a=`xdg-open "${i}"`;break}exec(a,r=>{t(!r);});})}var $=120,pt=process.env.EMAILR_WEB_URL||"https://app.emailr.dev";function ut(i,t){let e=`http://127.0.0.1:${t}/callback`,a=new URLSearchParams({state:i,callback_url:e});return `${pt}/consent/authorize?${a.toString()}`}function Pe(){return new Command("login").description("Log in to Emailr via browser authentication").option("-t, --timeout <seconds>","Timeout in seconds",String($)).option("--no-browser","Don't automatically open the browser").action(async t=>{await ft({timeout:parseInt(t.timeout,10)||$,noBrowser:t.browser===false});})}async function ft(i){let t=je(),e=(i.timeout||$)*1e3;try{u("Starting authentication server...");let{port:a,url:r}=await t.start(),o=Ce(),n=ut(o,a);console.log(""),u("Authorization URL:"),console.log(`  ${n}`),console.log(""),i.noBrowser?u("Please open the URL above in your browser to continue."):await Ae(n)?u("Browser opened. Please complete authentication in your browser."):(k("Could not open browser automatically."),u("Please open the URL above in your browser to continue.")),console.log(""),u(`Waiting for authentication (timeout: ${i.timeout||$}s)...`);let s=await t.waitForCallback(o,e);s.success&&s.apiKey?(G({apiKey:s.apiKey}),console.log(""),d("Login successful!"),u(`API key saved to: ${I()}`),u("You can now use the Emailr CLI.")):(console.log(""),l(s.error||"Authentication failed."),u("Please try again or use manual configuration:"),console.log("  emailr config set api-key <your-api-key>"),process.exit(1));}catch(a){console.log(""),l(a instanceof Error?a.message:"An unexpected error occurred."),u("Please try again or use manual configuration:"),console.log("  emailr config set api-key <your-api-key>"),process.exit(1);}finally{await t.stop();}}var ae=N.join(W.homedir(),".config","opencode","skills","emailr-cli"),wt=`---
 name: emailr-cli
 description: Operate the Emailr CLI to send emails, manage contacts, templates, domains, broadcasts, webhooks, and segments. Includes LIVE PREVIEW editing for templates with hot-reload.
 ---
@@ -488,7 +2933,7 @@ IMPORTANT: Always use \`--background\` flag so the command returns immediately a
 - Create: \`emailr templates create --name "Name" --subject "Subject" --html-file ./template.html\`
 - Update: \`emailr templates update <id> --html-file ./template.html\`
 - Delete: \`emailr templates delete <id>\`
-`;function yt(){try{return execSync("which opencode",{stdio:"ignore"}),!0}catch{return  false}}function wt(){console.log("Installing OpenCode AI agent...");try{return execSync("npm install -g opencode-ai@latest",{stdio:"inherit"}),!0}catch{if(process.platform==="darwin")try{return execSync("brew install anomalyco/tap/opencode",{stdio:"inherit"}),!0}catch{return  false}return  false}}function vt(){E.existsSync(oe)||E.mkdirSync(oe,{recursive:true});let n=U.join(oe,"SKILL.md");E.writeFileSync(n,ht,"utf-8");}function Ke(){return new Command("agent").description(`Launch an AI agent with Emailr CLI expertise
+`;function yt(){try{return execSync("which opencode",{stdio:"ignore"}),!0}catch{return  false}}function St(){console.log("Installing OpenCode AI agent...");try{return execSync("npm install -g opencode-ai@latest",{stdio:"inherit"}),!0}catch{if(process.platform==="darwin")try{return execSync("brew install anomalyco/tap/opencode",{stdio:"inherit"}),!0}catch{return  false}return  false}}function vt(){v.existsSync(ae)||v.mkdirSync(ae,{recursive:true});let i=N.join(ae,"SKILL.md");v.writeFileSync(i,wt,"utf-8");}function xe(){return new Command("agent").description(`Launch an AI agent with Emailr CLI expertise
 This opens OpenCode (opencode.ai), an AI coding agent that knows how to use all Emailr CLI commands.
 The agent can help you:
@@ -496,7 +2941,93 @@ The agent can help you:
 - Manage contacts, broadcasts, and segments
 - Configure domains and webhooks
-The agent runs in your terminal with full access to the emailr CLI.`).option("--install","Install OpenCode if not already installed").option("--model <model>","Model to use (e.g., anthropic/claude-sonnet-4)").action(async t=>{yt()||(t.install?wt()||(l("Failed to install OpenCode. Please install manually:"),console.log("  npm install -g opencode-ai@latest"),console.log("  # or"),console.log("  brew install anomalyco/tap/opencode"),process.exit(1)):(l("OpenCode AI agent is not installed."),console.log(`
-Install it with one of:`),console.log("  emailr agent --install"),console.log("  npm install -g opencode-ai@latest"),console.log("  brew install anomalyco/tap/opencode"),process.exit(1)));try{vt(),d("Emailr CLI skill loaded");}catch(i){k(`Could not install skill: ${i instanceof Error?i.message:String(i)}`);}let e=[];t.model&&e.push("--model",t.model),console.log(`
+The agent runs in your terminal with full access to the emailr CLI.`).option("--install","Install OpenCode if not already installed").option("--model <model>","Model to use (e.g., anthropic/claude-sonnet-4)").action(async t=>{yt()||(t.install?St()||(l("Failed to install OpenCode. Please install manually:"),console.log("  npm install -g opencode-ai@latest"),console.log("  # or"),console.log("  brew install anomalyco/tap/opencode"),process.exit(1)):(l("OpenCode AI agent is not installed."),console.log(`
+Install it with one of:`),console.log("  emailr agent --install"),console.log("  npm install -g opencode-ai@latest"),console.log("  brew install anomalyco/tap/opencode"),process.exit(1)));try{vt(),d("Emailr CLI skill loaded");}catch(r){k(`Could not install skill: ${r instanceof Error?r.message:String(r)}`);}let e=[];t.model&&e.push("--model",t.model),console.log(`
 Starting Emailr AI Agent...`),console.log("The agent has the emailr-cli skill loaded."),console.log(`Ask it to help with emails, templates, contacts, or broadcasts.
-`);let o=spawn("opencode",e,{stdio:"inherit",env:process.env});o.on("error",i=>{l(`Failed to start agent: ${i.message}`),process.exit(1);}),o.on("exit",i=>{process.exit(i??0);});})}var h=new Command;h.name("emailr").description("Emailr CLI - Send emails and manage your email infrastructure").version("1.5.3");h.addCommand(ce());h.addCommand(le());h.addCommand(Se());h.addCommand(Ce());h.addCommand(ke());h.addCommand(Ee());h.addCommand(Fe());h.addCommand(je());h.addCommand(Ue());h.addCommand(Ke());h.parse();
+`);let a=spawn("opencode",e,{stdio:"inherit",env:process.env});a.on("error",r=>{l(`Failed to start agent: ${r.message}`),process.exit(1);}),a.on("exit",r=>{process.exit(r??0);});})}var g=new Command;g.name("emailr").description(`Emailr CLI - Send emails and manage your email infrastructure
+USAGE
+  emailr <command> [subcommand] [options]
+DESCRIPTION
+  The Emailr CLI provides a complete interface for sending emails and managing
+  your email infrastructure. All commands support both human-readable table
+  output and machine-readable JSON output for scripting and AI agent workflows.
+COMMANDS
+  send                 Send individual emails with HTML/text content or templates
+  templates            Create, edit, preview, and publish email templates
+  contacts             Manage email contacts and their metadata
+  segments             Create and manage contact segments with conditions
+  broadcasts           Send bulk email campaigns to segments
+  webhooks             Configure webhook endpoints for email events
+  domains              Add and verify sending domains (DKIM, SPF, DMARC)
+  config               Configure CLI settings (API key, base URL)
+  login                Authenticate with your Emailr account
+  agent                Run the AI agent for automated email tasks
+GETTING STARTED
+  1. Set your API key:
+     emailr config set api-key <your_api_key>
+  2. Verify your configuration:
+     emailr config list
+  3. Send your first email:
+     emailr send --to user@example.com --subject "Hello" --html "<p>Hi!</p>"
+OUTPUT FORMATS
+  Most commands support --format option:
+  --format table       Human-readable table output (default)
+  --format json        Machine-readable JSON output for scripting
+ENVIRONMENT VARIABLES
+  EMAILR_API_KEY       API key (overrides config file)
+  EMAILR_BASE_URL      Custom API base URL (overrides config file)
+EXAMPLES
+  # Send a simple email
+  emailr send --to user@example.com --subject "Hello" --html "<p>Hi!</p>"
+  # Send using a template
+  emailr send --to user@example.com --template tpl_abc123 \\
+    --template-data '{"name": "John"}'
+  # List all templates
+  emailr templates list
+  # Create a new contact
+  emailr contacts create --email user@example.com --name "John Doe"
+  # Create a segment for active subscribers
+  emailr segments create --name "Active" \\
+    --conditions '[{"field": "subscribed", "operator": "equals", "value": true}]'
+  # Send a broadcast to a segment
+  emailr broadcasts create --name "Newsletter" --template tpl_abc123 \\
+    --segment seg_xyz789
+  # Add and verify a sending domain
+  emailr domains add example.com
+  emailr domains verify example.com
+  # Configure a webhook for delivery events
+  emailr webhooks create --name "Deliveries" --url "https://..." \\
+    --events "email.delivered,email.bounced"
+  # Get JSON output for scripting
+  emailr contacts list --format json | jq '.[].email'
+AGENTIC WORKFLOW
+  For collaborating with AI agents on email templates:
+  1. Fetch template: emailr templates fetch <id> --output template.html
+  2. Edit locally or with AI assistance
+  3. Push preview: emailr templates push-preview <id> --html-file template.html
+  4. Share preview URL with AI agent for feedback
+  5. Iterate until satisfied
+  6. Publish: emailr templates update <id> --html-file template.html
+MORE INFORMATION
+  Run 'emailr <command> --help' for detailed help on any command.
+  Run 'emailr <command> <subcommand> --help' for subcommand details.`).version("1.5.4");g.addCommand(ce());g.addCommand(me());g.addCommand(Oe());g.addCommand(Ee());g.addCommand(_e());g.addCommand(Ie());g.addCommand(ke());g.addCommand(Ne());g.addCommand(Pe());g.addCommand(xe());g.parse();