@ossy/email 1.5.2 → 1.5.4

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 1.5.4 (2026-05-31)
+
+**Note:** Version bump only for package @ossy/email
+
+
+
+
+
+## 1.5.3 (2026-05-31)
+
+**Note:** Version bump only for package @ossy/email
+
+
+
+
+
 ## 1.5.2 (2026-05-30)
 
 **Note:** Version bump only for package @ossy/email

package/README.md

@@ -144,7 +144,7 @@ const { html, text } = EmailRenderer.render(VerifySignInEmail, { token: 'abc', b
 
 The `email` integration is an `*.integration.js` primitive that the platform connects at startup. It provides two methods: `send` (raw) and `sendTemplate` (React component).
 
-**Required environment variables:**
+**Required environment variables** (not required when `BUILD_ENVIRONMENT=local` — emails are logged to stdout instead):
 
 | Variable | Description |
 |---|---|
@@ -152,7 +152,7 @@ The `email` integration is an `*.integration.js` primitive that the platform con
 | `AWS_ACCESS_KEY_ID` | AWS access key |
 | `AWS_SECRET_ACCESS_KEY` | AWS secret key |
 
-If any variable is missing the integration is skipped with a warning, and `integrations.get('email')` returns `null`.
+If any variable is missing (and `BUILD_ENVIRONMENT` is not `local`), the integration is skipped with a warning, and `integrations.get('email')` returns `null`.
 
 **Using the email client in a task:**
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ossy/email",
   "private": false,
-  "version": "1.5.2",
+  "version": "1.5.4",
   "type": "module",
   "main": "./src/index.js",
   "module": "./src/index.js",
@@ -19,5 +19,5 @@
     "react": "*",
     "react-dom": "*"
   },
-  "gitHead": "51e33c2eaff6973c34f00024a082c6912252ec72"
+  "gitHead": "188d15e1d90f102bc31996da3b32a5aef213f4b7"
 }

package/src/email-renderer.js

@@ -1,10 +1,22 @@
 import { renderToStaticMarkup } from 'react-dom/server'
 import React from 'react'
 
+/** Preserve link targets when stripping tags so local stdout logs include magic-link URLs. */
+function htmlToPlainText(html) {
+  const withLinks = html.replace(
+    /<a\b[^>]*\bhref=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi,
+    (_, href, inner) => {
+      const label = inner.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim()
+      return label ? `${label}: ${href}` : href
+    },
+  )
+  return withLinks.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim()
+}
+
 export const EmailRenderer = {
   render(Component, props) {
     const html = renderToStaticMarkup(React.createElement(Component, props))
-    const text = html.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim()
+    const text = htmlToPlainText(html)
     return { html, text }
   }
 }

package/src/email.integration.js

@@ -3,12 +3,16 @@ import { EmailRenderer } from './email-renderer.js'
 
 export const id = 'email'
 
-export const credentials = [
+const SES_CREDENTIALS = [
   'SES_REGION',
   'AWS_ACCESS_KEY_ID',
   'AWS_SECRET_ACCESS_KEY',
 ]
 
+/** Local dev logs to stdout; SES env vars are not required. */
+export const credentials =
+  process.env.BUILD_ENVIRONMENT === 'local' ? [] : SES_CREDENTIALS
+
 /**
  * Returns an email client configured from env vars.
  * Exposes `send({ to, from, subject, html, text })` and
@@ -17,16 +21,19 @@ export const credentials = [
  * @param {{ env: NodeJS.ProcessEnv }} opts
  */
 export async function connect({ env }) {
-  const ses = new SESClient({
-    region: env.SES_REGION,
-    credentials: {
-      accessKeyId: env.AWS_ACCESS_KEY_ID,
-      secretAccessKey: env.AWS_SECRET_ACCESS_KEY,
-    },
-  })
+  const isLocal = env.BUILD_ENVIRONMENT === 'local'
+  const ses = isLocal
+    ? null
+    : new SESClient({
+        region: env.SES_REGION,
+        credentials: {
+          accessKeyId: env.AWS_ACCESS_KEY_ID,
+          secretAccessKey: env.AWS_SECRET_ACCESS_KEY,
+        },
+      })
 
   function send({ to, from, subject, html, text }) {
-    if (env.BUILD_ENVIRONMENT === 'local') {
+    if (isLocal) {
       console.log('\n-----------YOU GOT MAIL-----------')
       console.log(`To: ${to}`)
       console.log(`From: ${from}`)