@certik/skynet 0.25.3 → 0.25.4

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.25.4
+
+- Added `email` module with `sendEmail` helper for sending emails via Mailgun
+
 ## 0.25.3
 
 - Add `getDeployBin` function to `cli` library to run ts files via bun so Nomad/Doppler don't try to exec the file directly.

package/dist/email.d.ts

@@ -0,0 +1,9 @@
+interface SendEmailOptions {
+    to: string | string[];
+    subject: string;
+    html: string;
+    from: string;
+    text?: string;
+}
+export declare function sendEmail({ to, subject, html, from, text }: SendEmailOptions): Promise<void>;
+export {};

package/dist/email.js

@@ -0,0 +1,31 @@
+// src/email.ts
+import Mailgun from "mailgun.js";
+import formData from "form-data";
+async function sendEmail({ to, subject, html, from, text }) {
+  const apiKey = process.env.MAILGUN_API_KEY;
+  if (!apiKey) {
+    throw new Error("missing MAILGUN_API_KEY");
+  }
+  const domain = process.env.MAILGUN_DOMAIN;
+  if (!domain) {
+    throw new Error("missing MAILGUN_DOMAIN");
+  }
+  const mailgun = new Mailgun(formData);
+  const mg = mailgun.client({ username: "api", key: apiKey });
+  const recipients = Array.isArray(to) ? to : [to];
+  try {
+    await mg.messages.create(domain, {
+      from,
+      to: recipients,
+      subject,
+      ...text ? { text } : {},
+      html
+    });
+  } catch (error) {
+    console.error("failed to send email", error);
+    throw error;
+  }
+}
+export {
+  sendEmail
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@certik/skynet",
-  "version": "0.25.3",
+  "version": "0.25.4",
   "description": "Skynet Shared JS library",
   "type": "module",
   "exports": {
@@ -44,6 +44,10 @@
       "import": "./dist/dynamodb.js",
       "types": "./dist/dynamodb.d.ts"
     },
+    "./email": {
+      "import": "./dist/email.js",
+      "types": "./dist/email.d.ts"
+    },
     "./env": {
       "import": "./dist/env.js",
       "types": "./dist/env.d.ts"
@@ -116,6 +120,8 @@
     "chalk": "^5.6.2",
     "execa": "^9.6.1",
     "express": "^5.2.1",
+    "form-data": "^4.0.5",
+    "mailgun.js": "^12.7.1",
     "meow": "^14.0.0",
     "p-memoize": "^8.0.0",
     "p-throttle": "^8.1.0",

package/src/email.ts

@@ -0,0 +1,40 @@
+import Mailgun from "mailgun.js";
+import formData from "form-data";
+
+interface SendEmailOptions {
+  to: string | string[];
+  subject: string;
+  html: string;
+  from: string;
+  text?: string;
+}
+
+export async function sendEmail({ to, subject, html, from, text }: SendEmailOptions) {
+  const apiKey = process.env.MAILGUN_API_KEY;
+  if (!apiKey) {
+    throw new Error("missing MAILGUN_API_KEY");
+  }
+
+  const domain = process.env.MAILGUN_DOMAIN;
+  if (!domain) {
+    throw new Error("missing MAILGUN_DOMAIN");
+  }
+
+  const mailgun = new Mailgun(formData);
+  const mg = mailgun.client({ username: "api", key: apiKey });
+
+  const recipients = Array.isArray(to) ? to : [to];
+
+  try {
+    await mg.messages.create(domain, {
+      from,
+      to: recipients,
+      subject,
+      ...(text ? { text } : {}),
+      html,
+    });
+  } catch (error) {
+    console.error("failed to send email", error);
+    throw error;
+  }
+}