resend-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 stretch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# resend-cli
+Simple, pretty command-line based tool for sending emails, managing audiences, etc via [Resend](https://resend.com).
+
+## install
+Install resend-cli by running `npm i -g resend-cli`.  
+Do not install resend-cli locally, without the `-g` flag, since it does not make sense for it to be a project dependency.
+
+## usage
+resend-cli does not require any arguments. If you are running resend-cli for the first time, the command-line will prompt you for an API key.
+API keys must have full access for all features of the CLI to work properly. You may create an API key from the [dashboard](https://resend.com/api-keys).
+
+After this, the API key will be saved in plain text (!) at ~/.resend_config.json. For this reason, avoid installing resend-cli on public or shared computers.  
+
+To exit resend-cli, use the Ctrl+C keyboard shortcut.

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "resend-cli",
+  "version": "1.0.0",
+  "description": "GUI for sending emails via resend",
+  "main": "src/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "stretch07",
+  "license": "MIT",
+  "dependencies": {
+    "enquirer": "^2.4.1",
+    "figlet": "^1.7.0",
+    "ora": "^8.0.1",
+    "resend": "^3.2.0"
+  },
+  "type": "module"
+}

package/src/index.js

@@ -0,0 +1,53 @@
+import enquirer from "enquirer"
+import * as fs from "fs/promises"
+import {homedir} from "os"
+import figlet from "figlet"
+import {promisify} from "util"
+const fig = promisify(figlet)
+import ora from "ora"
+import { Resend } from "resend"
+import routes from "./routes.js"
+import readline from "readline"
+
+const text = await fig("resend-cli")
+console.log(text)
+const configPath = `${homedir()}/.resend_config.json`
+const fileExists = await fs.access(configPath).then(() => true).catch(() => false);
+if (fileExists) {
+    let config, instance
+    try {
+        let fileContents = await fs.readFile(configPath)
+        fileContents = fileContents + ''
+        config = JSON.parse(fileContents)
+        //console.log(config.apiKey)
+        instance = new Resend(config.apiKey)
+    } catch (e) {
+        console.error("Error reading config file")
+        console.error(e)
+        process.exit(1)
+    }
+
+    try {
+        await routes({resend: instance, apiKey: config.apiKey, config})
+    } catch {} // this is needed so that Ctrl+C doesn't throw an exception
+} else {
+    const apiKeyResponse = await enquirer.password({
+        message: "Enter an API key with full access: "
+    })
+    const spinner = ora({text: "Authenticating...", spinner: "toggle9"}).start()
+    const resend = new Resend(apiKeyResponse)
+    const apiKeys = await resend.apiKeys.list()
+    spinner.stop()
+    if (apiKeys?.error?.statusCode === 400) {
+        console.error("Invalid API key")
+        process.exit(1)
+    } else {
+        const config = {
+            apiKey: apiKeyResponse
+        }
+        await fs.writeFile(configPath, JSON.stringify(config))
+        console.log("API key saved in plain text to ~/.resend_config.json.")
+        console.log("Run `resend-cli` again to use the CLI.")
+        process.exit(0)
+    }
+}

package/src/routes.js

@@ -0,0 +1,37 @@
+import enquirer from "enquirer";
+import email from "./sections/email.js";
+import domain from "./sections/domain.js";
+import apikeys from "./sections/apikeys.js";
+import audiences from "./sections/audiences.js";
+import contacts from "./sections/contacts.js";
+
+export default async ({resend, apiKey, config}) => {
+    const prompt = new enquirer.Select({
+        message: "Choose a section",
+        choices: [
+            {name: "email", message: "Emails"},
+            {name: "domain", message: "Domains"},
+            {name: "apiKeys", message: "API Keys"},
+            {name: "audiences", message: "Audiences"},
+            {name: "contacts", message: "Contacts"},
+        ]
+    })
+    const answer = await prompt.run()
+    switch (answer) {
+        case "email":
+            await email({resend, apiKey, config})
+            break
+        case "domain":
+            await domain({resend, apiKey, config})
+            break
+        case "apiKeys":
+            await apikeys({resend, apiKey, config})
+            break
+        case "audiences":
+            await audiences({resend, apiKey, config})
+            break
+        case "contacts":
+            await contacts({resend, apiKey, config})
+            break
+    }
+}

package/src/sections/apikeys.js

@@ -0,0 +1,99 @@
+import ora from "ora"
+import enquirer from "enquirer";
+
+const logAPIKey = (apiKey) => {
+    console.log("- ID: " + apiKey.id)
+    if (apiKey.token) {
+        console.log("- API Key: " + apiKey.token)
+    }
+    if (apiKey.name) {
+        console.log("- Name: " + apiKey.name)
+    }
+    if (apiKey.created_at) {
+        console.log("- Created At: " + apiKey.created_at)
+    }
+}
+
+export default async function({resend}, apiKey) {
+    const prompt = new enquirer.Select({
+        message: "Choose an action",
+        choices: [
+            {name: "create", message: "Create API Key"},
+            {name: "list", message: "List API Keys"},
+            {name: "delete", message: "Delete API Key"},
+        ]
+    })
+    const answer = await prompt.run()
+    switch (answer) {
+        case "create":
+            {
+                let form = new enquirer.Form({
+                    name: "createApiKey",
+                    message: "Create an API Key.\nPossible values for permission: full, sending.",
+                    choices: [
+                        {name: "name", message: "Name", initial: "My API Key"},
+                        {name: "permission", message: "Permission", initial: "full"}
+                    ]
+                })
+                form = await form.run()
+                const name = form.name
+                const permission = form.permission === "sending" ? "sending_access" : "full_access"
+                const spinner = ora({text: "Creating API Key...", spinner: "toggle9"}).start()
+                const apiKey = await resend.apiKeys.create({name, permission})
+                spinner.stop()
+                console.log("IMPORTANT! Save this API key in a safe place. It will not be shown again.")
+                logAPIKey(apiKey.data)
+            }
+            break;
+        case "list":
+            {
+                const spinner2 = ora({text: "Fetching API Keys...", spinner: "toggle9"}).start()
+                const listApiKeysResponse = await resend.apiKeys.list()
+                spinner2.stop()
+                const choices = listApiKeysResponse.data.data.map((apiKey) => {
+                    return {message: apiKey.name, name: apiKey.id}
+                })
+                //console.log(choices)
+                let answer = new enquirer.Select({
+                    name: "listApiKeys",
+                    message: "Choose an API Key to view info on",
+                    choices
+                })
+                answer = await answer.run()
+                for (let apiKey of listApiKeysResponse.data.data) {
+                    if (apiKey.id === answer) {
+                        logAPIKey(apiKey)
+                    }
+                }
+            }
+            break
+        case "delete":
+            {
+                const spinner3 = ora({text: "Fetching API Keys...", spinner: "toggle9"}).start()
+                const listApiKeysResponse2 = await resend.apiKeys.list()
+                spinner3.stop()
+                const choices2 = listApiKeysResponse2.data.data.map((apiKey) => {return {message: apiKey.name, name: apiKey.id}})
+                let answer2 = new enquirer.Select({
+                    name: "deleteApiKey",
+                    message: "Choose an API Key to delete",
+                    choices: choices2
+                })
+                answer2 = await answer2.run()
+                console.log(answer2)
+                let confirmDelete = new enquirer.Confirm({
+                    message: "If this API Key is the one you make resend-cli with, you will not be able to use resend-cli anymore with the same key. This action is IRREVERSIBLE!!"
+                })
+                confirmDelete = await confirmDelete.run()
+                if (!confirmDelete) {
+                    console.log("Aborting...")
+                    process.exit(0)
+                }
+                const spinner4 = ora({text: "Deleting API Key...", spinner: "toggle9"}).start()
+                await resend.apiKeys.remove(answer2)
+                spinner4.stop()
+                    console.log("API Key deleted.")
+            }
+            break
+    }
+    process.exit(0)
+}

package/src/sections/audiences.js

@@ -0,0 +1,84 @@
+import ora from "ora"
+import enquirer from "enquirer";
+
+const logAudience = (audience) => {
+    console.log(`- ID: ${audience.id}`)
+    console.log(`- Name: ${audience.name}`)
+    if (audience.created_at) {
+        console.log(`- Created At: ${audience.created_at}`)
+    }
+}
+
+export default async function({resend, apiKey}) {
+    let mainForm = new enquirer.Select({
+        message: "Choose an action",
+        choices: [
+            {name: "add", message: "Add Audience"},
+            {name: "retrieve", message: "List/Retrieve Audience"},
+            {name: "delete", message: "Delete Audience"},
+        ]
+    })
+    mainForm = await mainForm.run()
+
+    switch (mainForm) {
+        case "add":
+            {
+                let form = new enquirer.Form({
+                    name: "createAudience",
+                    message: "Create an audience",
+                    choices: [
+                        {name: "name", message: "Name", initial: "My Audience"},
+                    ]
+                })
+                form = await form.run()
+                const spinner = ora({text: "Creating audience...", spinner: "toggle9"}).start()
+                const audience = await resend.audiences.create({name: form.name})
+                spinner.stop()
+                console.log(`Audience created.`)
+                logAudience(audience.data)
+            }
+            break
+        case "retrieve":
+            {
+                const audienceId = await selectAudience({resend}, "Choose an audience")
+                const spinner = ora({text: "Retrieving audience...", spinner: "toggle9"}).start()
+                const audience = await resend.audiences.get(audienceId)
+                spinner.stop()
+                console.log(`Audience '${audience.data.name}' retrieved.`)
+                logAudience(audience.data)
+            }
+            break
+        case "delete":
+            {
+                const audienceId = await selectAudience({resend}, "Choose an audience")
+                let confirmation = new enquirer.Confirm({
+                    message: "Are you sure you want to delete this audience?",
+                    initial: false
+                })
+                confirmation = await confirmation.run()
+                if (!confirmation) {
+                    console.log("Cancelled.")
+                    process.exit(0)
+                }
+                const spinner = ora({text: "Deleting audience...", spinner: "toggle9"}).start()
+                await resend.audiences.remove(audienceId)
+                spinner.stop()
+                console.log("Audience deleted.")
+            }
+            break
+    }
+}
+
+export async function selectAudience({resend}, message) {
+    const spinner = ora({text: "Fetching audiences...", spinner: "toggle9"}).start()
+    const audiences = await resend.audiences.list()
+    spinner.stop()
+    const choices = audiences.data.data.map((audience) => {return {message: audience.name, name: audience.id}})
+    let answer = new enquirer.Select({
+        name: "listAudiences",
+        message: message ?? "Choose an audience",
+        choices
+    })
+    answer = await answer.run()
+    return answer
+}

package/src/sections/contacts.js

@@ -0,0 +1,177 @@
+import ora from "ora"
+import enquirer from "enquirer";
+import {selectAudience} from "./audiences.js";
+
+const logContact = (contact) => {
+    console.log("- ID: " + contact.id)
+    console.log("- Email: " + contact.email)
+    console.log("- First Name: " + (contact.first_name ?? "N/A"))
+    console.log("- Last Name: " + (contact.last_name ?? "N/A"))
+    console.log("- Created At: " + contact.created_at)
+    console.log("- Unsubscribed: " + contact.unsubscribed)
+
+}
+
+export default async function({resend, apiKey}) {
+    const mainForm = new enquirer.Select({
+        message: "Choose an action",
+        choices: [
+            {name: "add", message: "Add Contact"},
+            {name: "retrieve", message: "Retrieve Contact"},
+            {name: "update", message: "Update Contact"},
+            {name: "delete", message: "Delete Contact"},
+            {name: "list", message: "List Contacts"},
+        ]
+    })
+    const mainFormResponse = await mainForm.run()
+    switch (mainFormResponse) {
+        case "add":
+            {
+                const audienceID = await selectAudience({resend}, "Choose an audience to add a contact to")
+                let form = new enquirer.Form({
+                    name: "createContact",
+                    message: "Add a contact",
+                    choices: [
+                        {name: "email", message: "Email"},
+                        {name: "firstName", message: "First Name", initial: ""},
+                        {name: "lastName", message: "Last Name", initial: ""},
+                    ]
+                })
+                form = await form.run()
+                const spin = ora({text: "Adding contact...", spinner: "toggle9"}).start()
+                const contact = await resend.contacts.create({
+                    audienceId: audienceID,
+                    email: form.email,
+                    firstName: form.firstName,
+                    lastName: form.lastName
+                })
+                spin.stop()
+                //console.log(contact)
+                console.log(`Contact with ID ${contact.data.id} added.`)
+            }
+            break
+        case "retrieve":
+            {
+                const audienceId = await selectAudience({resend}, "Choose an audience")
+                let form = new enquirer.Form({
+                    name: "retrieveContact",
+                    message: "Retrieve a contact",
+                    choices: [
+                        {name: "emailOrID", message: "Email or Contact ID"},
+                    ]
+                })
+                form = await form.run()
+                if (form.emailOrID.includes("@")) {
+                    // we need to list contacts and find the contact with the email
+                    const spin = ora({text: "Retrieving contact...", spinner: "toggle9"}).start()
+                    const contacts = await resend.contacts.list({audienceId})
+                    for (let contact of contacts.data.data) {
+                        if (contact.email === form.emailOrID) {
+                            spin.stop()
+                            logContact(contact)
+                        }
+                    }
+                } else {
+                    const spin = ora({text: "Retrieving contact...", spinner: "toggle9"}).start()
+                    const contact = await resend.contacts.get({id: form.emailOrID, audienceId})
+                    spin.stop()
+                    console.log("- Email: " + contact.data.email)
+                    console.log("- First Name: " + (contact.data.first_name ?? "N/A"))
+                    console.log("- Last Name: " + (contact.data.last_name ?? "N/A"))
+                    console.log("- Created At: " + contact.data.created_at)
+                    console.log("- Unsubscribed: " + contact.data.unsubscribed)
+                }
+            }
+            break
+        case "update":
+            {
+                const audienceId = await selectAudience({resend}, "Choose an audience")
+                let form = new enquirer.Form({
+                    name: "updateContact",
+                    message: "Update a contact",
+                    choices: [
+                        {name: "emailOrID", message: "Email or Contact ID"},
+                        {name: "firstName", message: "First Name", initial: ""},
+                        {name: "lastName", message: "Last Name", initial: ""},
+                        {name: "unsubscribed", message: "Unsubscribed (either true or false)"}
+                    ]
+                })
+                form = await form.run()
+                if (form.emailOrID.includes("@")) {
+                    // we need to list contacts and find the contact with the email
+                    const spin = ora({text: "Updating contact...", spinner: "toggle9"}).start()
+                    const contacts = await resend.contacts.list({audienceId})
+                    for (let contact of contacts.data.data) {
+                        if (contact.email === form.emailOrID) {
+                            const contactUpdate = await resend.contacts.update({
+                                id: contact.id,
+                                audienceId,
+                                firstName: form.firstName,
+                                lastName: form.lastName,
+                                unsubscribed: form.unsubscribed
+                            })
+                            spin.stop()
+                            console.log(`Contact with ID ${contactUpdate.data.id} updated.`)
+                        }
+                    }
+                } else {
+                    const spin = ora({text: "Updating contact...", spinner: "toggle9"}).start()
+                    const contactUpdate = await resend.contacts.update({
+                        id: form.emailOrID,
+                        audienceId,
+                        firstName: form.firstName,
+                        lastName: form.lastName,
+                        unsubscribed: form.unsubscribed
+                    })
+                    spin.stop()
+                    console.log(`Contact with ID ${contactUpdate.data.id} updated.`)
+                }
+            }
+            break
+        case "delete":
+            {
+                const audienceId = await selectAudience({resend}, "Choose an audience")
+                let form = new enquirer.Form({
+                    name: "deleteContact",
+                    message: "Delete a contact",
+                    choices: [
+                        {name: "emailOrID", message: "Email or Contact ID"},
+                    ]
+                })
+                form = await form.run()
+                if (form.emailOrID.includes("@")) {
+                    const spin = ora({text: "Deleting contact...", spinner: "toggle9"}).start()
+                    const contactDelete = await resend.contacts.remove({email: form.emailOrID, audienceId})
+                    spin.stop()
+                    console.log(`Contact with ID ${form.emailOrID} deleted.`)
+                } else {
+                    const spin = ora({text: "Deleting contact...", spinner: "toggle9"}).start()
+                    const contactDelete = await resend.contacts.remove({id: form.emailOrID, audienceId})
+                    spin.stop()
+                    console.log(`Contact with ID ${form.emailOrID} deleted.`)
+                }
+            }
+            break
+        case "list":
+            {
+                const audienceId = await selectAudience({resend}, "Choose an audience")
+                const spin = ora({text: "Fetching contacts...", spinner: "toggle9"}).start()
+                const contacts = await resend.contacts.list({audienceId})
+                spin.stop()
+                //show a select with contact names
+                const choices = contacts.data.data.map((contact) => {return {message: contact.email, name: contact.id}})
+                let answer = new enquirer.Select({
+                    name: "listContacts",
+                    message: "Choose a contact to view info on",
+                    choices
+                })
+                answer = await answer.run()
+                for (let contact of contacts.data.data) {
+                    if (contact.id === answer) {
+                        logContact(contact)
+                    }
+                }
+            }
+    }
+    process.exit(0)
+}

package/src/sections/domain.js

@@ -0,0 +1,195 @@
+import ora from "ora"
+import enquirer from "enquirer";
+
+const logDomain = (domain) => {
+    console.log(`ID: ${domain.data.id}`)
+    console.log(`Name: ${domain.data.name}`)
+    console.log(`Region: ${domain.data.region}`)
+    console.log(`Status: ${domain.data.status}`)
+    console.log(`Created At: ${domain.data.created_at}`)
+}
+
+export default async function({resend}) {
+    let mainForm = new enquirer.Select({
+        message: "Choose an action",
+        choices: [
+            {name: "add", message: "Add Domain"},
+            {name: "retrieve", message: "Retrieve Domain"},
+            {name: "verify", message: "Verify Domain"},
+            {name: "update", message: "Update Domain"},
+            {name: "list", message: "List Domains"},
+            {name: "delete", message: "Delete Domain"},
+        ]
+    })
+    mainForm = await mainForm.run()
+    switch (mainForm) {
+        case "add":
+            {
+                let form = new enquirer.Form({
+                    name: "createDomain",
+                    message: "Add a domain",
+                    choices: [
+                        {name: "name", message: "Domain/subdomain without http"},
+                        {name: "region", message: "Region (possible values: us-east-1, eu-west-1, sa-east-1, ap-northeast-1)", initial: "us-east-1"},
+                    ]
+                })
+                form = await form.run()
+                const spin = ora({text: "Adding domain...", spinner: "toggle9"}).start()
+                const domain = await resend.domains.create({
+                    name: form.name,
+                    region: form.region
+                })
+                if (domain.error) {
+                    spin.stop()
+                    console.error(domain.error.message)
+                    process.exit(1)
+                }
+                spin.stop()
+                console.log(`Domain with ID ${domain.data.id} added.`)
+
+                const choices = domain.data.records.map((record, i) => { return {name: i, message: `Record #${i+1}`} })
+
+                const records = new enquirer.Select({
+                    name: "createRecords",
+                    message: "Add all of the following records to your DNS provider",
+                    choices
+                })
+                let recordsResult
+                async function iterateRecords() {
+                    recordsResult = await records.run()
+                    let record = domain.data.records[recordsResult]
+                    console.log("Add the following record to your DNS provider:")
+                    console.log(`- Type: ${record.type}`)
+                    console.log(`- Value: ${record.value}`)
+                    if (record.priority) {
+                        console.log(`- Priority: ${record.priority}`)
+                    }
+                    if (record.ttl) {
+                        console.log(`- TTL: ${record.ttl}`)
+                    }
+                    console.log("Once you have finished adding the records, run resend-cli and navigate to Domains -> Verify Domain.")
+                    await iterateRecords()
+                }
+                await iterateRecords()
+            }
+            break
+        case "retrieve":
+            {
+                let form = new enquirer.Form({
+                    name: "retrieveDomain",
+                    message: "Retrieve a domain",
+                    choices: [{name: "id", message: "Domain ID"},]
+                })
+                form = await form.run()
+                const spin = ora({text: "Retrieving domain...", spinner: "toggle9"}).start()
+                const domain = await resend.domains.get(form.id)
+                if (domain.error) {
+                    spin.stop()
+                    console.error(domain.error.message)
+                    process.exit(1)
+                }
+                spin.stop()
+                logDomain(domain)
+            }
+            break
+        case "verify":
+            {
+                let form = new enquirer.Form({
+                    name: "verifyDomain",
+                    message: "Verify a domain",
+                    choices: [{name: "id", message: "Domain ID"},]
+                })
+                form = await form.run()
+                const spin = ora({text: "Submitting request...", spinner: "toggle9"}).start()
+                const domain = await resend.domains.verify(form.id)
+                if (domain.error) {
+                    spin.stop()
+                    console.error(domain.error.message)
+                    process.exit(1)
+                }
+                spin.stop()
+                console.log(`Domain with ID ${domain.data.id} submitted for verification.`)
+            }
+            break
+        case "update":
+            {
+                let id = new enquirer.Input({
+                    message: "Enter the ID of the domain you want to update"
+                })
+                id = await id.run()
+                let confirm1 = new enquirer.Confirm({
+                    message: "Enable click tracking?",
+                    initial: false
+                })
+                confirm1 = await confirm1.run()
+                let confirm2 = new enquirer.Confirm({
+                    message: "Enable open tracking?",
+                    initial: false
+                })
+                confirm2 = await confirm2.run()
+
+                const spin = ora({text: "Updating domain...", spinner: "toggle9"}).start()
+                const domain = await resend.domains.update({
+                    id,
+                    clickTracking: confirm1,
+                    openTracking: confirm2
+                })
+                if (domain.error) {
+                    spin.stop()
+                    console.error(domain.error.message)
+                    process.exit(1)
+                }
+                spin.stop()
+                console.log(`Domain with ID ${domain.data.id} updated.`)
+            }
+            break
+        case "list":
+            {
+                const spin = ora({text: "Fetching domains...", spinner: "toggle9"}).start()
+                const domains = await resend.domains.list()
+                if (domains.error) {
+                    spin.stop()
+                    console.error(domains.error.message)
+                    process.exit(1)
+                }
+                spin.stop()
+                const choices = domains.data.data.map((domain) => {return {message: domain.name, name: domain.id}})
+                let answer = new enquirer.Select({
+                    name: "listDomains",
+                    message: "Choose a domain",
+                    choices
+                })
+                answer = await answer.run()
+                const domain = await resend.domains.get(answer)
+                logDomain(domain)
+            }
+            break
+        case "delete":
+            {
+                let form = new enquirer.Form({
+                    name: "deleteDomain",
+                    message: "Delete a domain",
+                    choices: [{name: "id", message: "Domain ID"},]
+                })
+                form = await form.run()
+                let confirm = new enquirer.Confirm({
+                    message: "Are you sure you want to delete this domain?",
+                    initial: false
+                })
+                confirm = await confirm.run()
+                if (!confirm) {
+                    console.log("Cancelled.")
+                    process.exit(0)
+                }
+                const spin = ora({text: "Deleting domain...", spinner: "toggle9"}).start()
+                const domain = await resend.domains.remove(form.id)
+                if (domain.error) {
+                    spin.stop()
+                    console.error(domain.error.message)
+                    process.exit(1)
+                }
+                spin.stop()
+                console.log(`Domain with ID ${form.id} deleted.`)
+            }
+    }
+}

package/src/sections/email.js

@@ -0,0 +1,132 @@
+import ora from "ora"
+import enquirer from "enquirer";
+import {selectAudience} from "./audiences.js";
+import fs from "fs/promises"
+
+const logEmail = (email) => {
+    console.log(`ID: ${email.id}`)
+    console.log(`From: ${email.from}`)
+    console.log(`To: ${email.to}`)
+    console.log(`Subject: ${email.subject}`)
+    console.log(`BCC: ${email.bcc}`)
+    console.log(`CC: ${email.cc}`)
+    console.log(`Reply To: ${email.reply_to}`)
+    console.log(`HTML: ${email.html}`)
+    console.log(`Text: ${email.text}`)
+}
+
+export const addRecipient = async ({resend}, msg) => {
+    let method = new enquirer.Select({
+        message: (msg) + "Choose a method",
+        choices: [
+            {name: "manual", message: "Manual Entry"},
+            {name: "audience", message: "Send to entire Audience"},
+            {name: "none", message: "None"}
+        ]
+    })
+    method = await method.run()
+    if (method === "manual") {
+        let email = new enquirer.Input({
+            message: "Email Addresses, separated by commas",
+            initial: "something@someone.co, delivery@resend.com"
+        })
+        email = await email.run()
+        return email.split(",").map((email) => email.trim())
+    } else if (method === "audience") {
+        const audienceId = await selectAudience({resend}, "Choose an audience")
+        const spinner = ora({text: "Retrieving audience...", spinner: "toggle9"}).start()
+        const audience = await resend.contacts.list({audienceId})
+        spinner.stop()
+        // map audience.data.data array into a comma-separated list of email addresses
+        return audience.data.data.map((contact) => contact.email)
+    } else {
+        return []
+    }
+}
+
+export default async function({resend, apiKey}) {
+    let mainForm = new enquirer.Select({
+        message: "Choose an action",
+        choices: [
+            {name: "send", message: "Send Email"},
+            {name: "retrieve", message: "Retrieve Email"},
+        ]
+    })
+    mainForm = await mainForm.run()
+    switch (mainForm) {
+        case "send":
+            {
+                let from = new enquirer.Input({
+                    message: "From",
+                    initial: "Acme <onboarding@resend.dev>"
+                })
+                from = await from.run()
+                const to = await addRecipient({resend}, "To: ")
+                let subject = new enquirer.Input({
+                    message: "Subject",
+                    initial: "Changelog | Acne Alpha"
+                })
+                subject = await subject.run()
+                const bcc = await addRecipient({resend}, "BCC: ")
+                const cc = await addRecipient({resend}, "CC: ")
+                const reply_to = await addRecipient({resend}, "Reply To: ")
+                let html = new enquirer.Select({
+                    message: "HTML insert method",
+                    choices: [
+                        {name: "file", message: "From file"},
+                        {name: "input", message: "From input"},
+                        {name: "none", message: "None (text instead)"}
+                    ]
+                })
+                html = await html.run()
+                if (html === "file") {
+                    let file = new enquirer.Input({
+                        message: "File path"
+                    })
+                    file = await file.run()
+                    html = await fs.readFile(file, "utf8")
+                } else if (html === "input") {
+                    let htmlInput = new enquirer.Input({
+                        message: "HTML",
+                        initial: "<h1>This is an email</h1>"
+                    })
+                    html = await htmlInput.run()
+                }
+                let text = new enquirer.Input({
+                    message: "Text (not required if HTML is provided)",
+                    initial: "This is a text email"
+                })
+                text = await text.run()
+                const spinner = ora({text: "Sending email...", spinner: "toggle9"}).start()
+                const email = await resend.emails.create({
+                    from,
+                    to,
+                    subject,
+                    bcc,
+                    cc,
+                    reply_to,
+                    html,
+                    text
+                })
+                if (email.error) {
+                    spinner.stop()
+                    console.error(email.error.message)
+                    process.exit(1)
+                }
+                spinner.stop()
+                console.log(`Email with ID ${email.data.id} sent.`)
+            }
+            break
+        case "retrieve":
+            {
+                let emailId = new enquirer.Input({
+                    message: "Email ID"
+                })
+                emailId = await emailId.run()
+                const spinner = ora({text: "Retrieving email...", spinner: "toggle9"}).start()
+                const email = await resend.emails.get(emailId)
+                spinner.stop()
+                logEmail(email.data)
+            }
+    }
+}