@shogo-ai/email 2.4.6 → 2.4.7

package/dist/{chunk-NKFT5JLE.js → chunk-QOA2QDKJ.js}

@@ -1211,6 +1211,51 @@ var dripHeartbeatTemplate = {
   }
 };
 
+// src/templates/lifecycle/build-ready.ts
+var buildReadyTemplate = {
+  name: "build-ready",
+  subject: "{{projectName}} is ready",
+  html: wrapInLayout(`
+    <h1 class="email-h1">{{projectName}} is ready</h1>
+    <p class="email-text">
+      Your agent finished a turn in <strong>{{projectName}}</strong> and there
+      is something to look at.
+    </p>
+    <p class="email-text">{{summary}}</p>
+    <a href="{{projectUrl}}" class="email-btn">Open the project</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're getting this because you started a build and stepped away.
+      <a href="{{preferencesUrl}}">Turn these emails off</a>.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME
+  }
+};
+
+// src/templates/lifecycle/credits-reset.ts
+var creditsResetTemplate = {
+  name: "credits-reset",
+  subject: "Your agent is back \u2014 pick up {{projectName}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">Your agent is back</h1>
+    <p class="email-text">
+      Your usage limit reset at <strong>{{resetAt}}</strong>, so
+      <strong>{{projectName}}</strong> can keep going.
+    </p>
+    <a href="{{continueUrl}}" class="email-btn">Continue where you left off</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're getting this once because you hit a limit and left.
+      <a href="{{preferencesUrl}}">Turn these emails off</a>.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME
+  }
+};
+
 // src/templates/lifecycle/conversion.ts
 var conversionUsageLimitTemplate = {
   name: "conversion-usage-limit",
@@ -1382,6 +1427,9 @@ var allTemplates = [
   dripReEngagementTemplate,
   dripPowerUpTemplate,
   dripHeartbeatTemplate,
+  // Lifecycle — Activation
+  buildReadyTemplate,
+  creditsResetTemplate,
   // Lifecycle — Conversion
   conversionUsageLimitTemplate,
   conversionPowerUserTemplate,
@@ -1413,4 +1461,4 @@ export {
   allTemplates,
   createShogoTemplateRegistry
 };
-//# sourceMappingURL=chunk-NKFT5JLE.js.map
+//# sourceMappingURL=chunk-QOA2QDKJ.js.map

package/dist/index.cjs

@@ -1252,6 +1252,51 @@ var dripHeartbeatTemplate = {
   }
 };
 
+// src/templates/lifecycle/build-ready.ts
+var buildReadyTemplate = {
+  name: "build-ready",
+  subject: "{{projectName}} is ready",
+  html: wrapInLayout(`
+    <h1 class="email-h1">{{projectName}} is ready</h1>
+    <p class="email-text">
+      Your agent finished a turn in <strong>{{projectName}}</strong> and there
+      is something to look at.
+    </p>
+    <p class="email-text">{{summary}}</p>
+    <a href="{{projectUrl}}" class="email-btn">Open the project</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're getting this because you started a build and stepped away.
+      <a href="{{preferencesUrl}}">Turn these emails off</a>.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME
+  }
+};
+
+// src/templates/lifecycle/credits-reset.ts
+var creditsResetTemplate = {
+  name: "credits-reset",
+  subject: "Your agent is back \u2014 pick up {{projectName}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">Your agent is back</h1>
+    <p class="email-text">
+      Your usage limit reset at <strong>{{resetAt}}</strong>, so
+      <strong>{{projectName}}</strong> can keep going.
+    </p>
+    <a href="{{continueUrl}}" class="email-btn">Continue where you left off</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're getting this once because you hit a limit and left.
+      <a href="{{preferencesUrl}}">Turn these emails off</a>.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME
+  }
+};
+
 // src/templates/lifecycle/conversion.ts
 var conversionUsageLimitTemplate = {
   name: "conversion-usage-limit",
@@ -1423,6 +1468,9 @@ var allTemplates = [
   dripReEngagementTemplate,
   dripPowerUpTemplate,
   dripHeartbeatTemplate,
+  // Lifecycle — Activation
+  buildReadyTemplate,
+  creditsResetTemplate,
   // Lifecycle — Conversion
   conversionUsageLimitTemplate,
   conversionPowerUserTemplate,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { E as EmailTemplate } from './types-CCHryvHe.cjs';
-export { a as EmailAddress, b as EmailConfig, c as EmailError, d as EmailErrorCode, e as EmailProviderType, f as EmailResult, I as IEmailProvider, g as IEmailService, O as OciEmailConfig, S as SendEmailParams, h as SendTemplateParams, i as SesConfig, j as SmtpConfig, T as TemplateRegistry, k as formatEmailAddress } from './types-CCHryvHe.cjs';
+import { E as EmailTemplate } from './types-szNtZ5IF.cjs';
+export { a as EmailAddress, b as EmailConfig, c as EmailError, d as EmailErrorCode, e as EmailProviderType, f as EmailResult, I as IEmailProvider, g as IEmailService, O as OciEmailConfig, S as SendEmailParams, h as SendTemplateParams, i as SesConfig, j as SmtpConfig, T as TemplateRegistry, k as formatEmailAddress } from './types-szNtZ5IF.cjs';
 
 /**
  * Email Template System

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { E as EmailTemplate } from './types-CCHryvHe.js';
-export { a as EmailAddress, b as EmailConfig, c as EmailError, d as EmailErrorCode, e as EmailProviderType, f as EmailResult, I as IEmailProvider, g as IEmailService, O as OciEmailConfig, S as SendEmailParams, h as SendTemplateParams, i as SesConfig, j as SmtpConfig, T as TemplateRegistry, k as formatEmailAddress } from './types-CCHryvHe.js';
+import { E as EmailTemplate } from './types-szNtZ5IF.js';
+export { a as EmailAddress, b as EmailConfig, c as EmailError, d as EmailErrorCode, e as EmailProviderType, f as EmailResult, I as IEmailProvider, g as IEmailService, O as OciEmailConfig, S as SendEmailParams, h as SendTemplateParams, i as SesConfig, j as SmtpConfig, T as TemplateRegistry, k as formatEmailAddress } from './types-szNtZ5IF.js';
 
 /**
  * Email Template System

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   passwordResetTemplate,
   welcomeTemplate,
   wrapInLayout
-} from "./chunk-NKFT5JLE.js";
+} from "./chunk-QOA2QDKJ.js";
 export {
   DARK_STYLE_OVERRIDES,
   EMAIL_CONSTANTS,

package/dist/server.cjs

@@ -120,7 +120,7 @@ var SmtpProvider = class {
    * Send an email via SMTP
    */
   async send(params) {
-    const { to, subject, html, text, from, replyTo, cc, bcc } = params;
+    const { to, subject, html, text, from, replyTo, cc, bcc, headers } = params;
     if (!from) {
       throw EmailError.configMissing("from address");
     }
@@ -142,6 +142,9 @@ var SmtpProvider = class {
       if (bcc) {
         mailOptions.bcc = this.formatRecipients(bcc);
       }
+      if (headers && Object.keys(headers).length > 0) {
+        mailOptions.headers = headers;
+      }
       const info = await transporter.sendMail(mailOptions);
       return {
         success: true,
@@ -1327,6 +1330,51 @@ var dripHeartbeatTemplate = {
   }
 };
 
+// src/templates/lifecycle/build-ready.ts
+var buildReadyTemplate = {
+  name: "build-ready",
+  subject: "{{projectName}} is ready",
+  html: wrapInLayout(`
+    <h1 class="email-h1">{{projectName}} is ready</h1>
+    <p class="email-text">
+      Your agent finished a turn in <strong>{{projectName}}</strong> and there
+      is something to look at.
+    </p>
+    <p class="email-text">{{summary}}</p>
+    <a href="{{projectUrl}}" class="email-btn">Open the project</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're getting this because you started a build and stepped away.
+      <a href="{{preferencesUrl}}">Turn these emails off</a>.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME
+  }
+};
+
+// src/templates/lifecycle/credits-reset.ts
+var creditsResetTemplate = {
+  name: "credits-reset",
+  subject: "Your agent is back \u2014 pick up {{projectName}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">Your agent is back</h1>
+    <p class="email-text">
+      Your usage limit reset at <strong>{{resetAt}}</strong>, so
+      <strong>{{projectName}}</strong> can keep going.
+    </p>
+    <a href="{{continueUrl}}" class="email-btn">Continue where you left off</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're getting this once because you hit a limit and left.
+      <a href="{{preferencesUrl}}">Turn these emails off</a>.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME
+  }
+};
+
 // src/templates/lifecycle/conversion.ts
 var conversionUsageLimitTemplate = {
   name: "conversion-usage-limit",
@@ -1498,6 +1546,9 @@ var allTemplates = [
   dripReEngagementTemplate,
   dripPowerUpTemplate,
   dripHeartbeatTemplate,
+  // Lifecycle — Activation
+  buildReadyTemplate,
+  creditsResetTemplate,
   // Lifecycle — Conversion
   conversionUsageLimitTemplate,
   conversionPowerUserTemplate,

package/dist/server.d.cts

@@ -1,5 +1,5 @@
-import { b as EmailConfig, a as EmailAddress, g as IEmailService } from './types-CCHryvHe.cjs';
-export { f as EmailResult, E as EmailTemplate, S as SendEmailParams, h as SendTemplateParams } from './types-CCHryvHe.cjs';
+import { b as EmailConfig, a as EmailAddress, g as IEmailService } from './types-szNtZ5IF.cjs';
+export { f as EmailResult, E as EmailTemplate, S as SendEmailParams, h as SendTemplateParams } from './types-szNtZ5IF.cjs';
 
 /**
  * Email Service - Server Side

package/dist/server.d.ts

@@ -1,5 +1,5 @@
-import { b as EmailConfig, a as EmailAddress, g as IEmailService } from './types-CCHryvHe.js';
-export { f as EmailResult, E as EmailTemplate, S as SendEmailParams, h as SendTemplateParams } from './types-CCHryvHe.js';
+import { b as EmailConfig, a as EmailAddress, g as IEmailService } from './types-szNtZ5IF.js';
+export { f as EmailResult, E as EmailTemplate, S as SendEmailParams, h as SendTemplateParams } from './types-szNtZ5IF.js';
 
 /**
  * Email Service - Server Side

package/dist/server.js

@@ -3,7 +3,7 @@ import {
   EmailTemplateRegistry,
   createShogoTemplateRegistry,
   formatEmailAddress
-} from "./chunk-NKFT5JLE.js";
+} from "./chunk-QOA2QDKJ.js";
 
 // src/providers/smtp.ts
 var SmtpProvider = class {
@@ -65,7 +65,7 @@ var SmtpProvider = class {
    * Send an email via SMTP
    */
   async send(params) {
-    const { to, subject, html, text, from, replyTo, cc, bcc } = params;
+    const { to, subject, html, text, from, replyTo, cc, bcc, headers } = params;
     if (!from) {
       throw EmailError.configMissing("from address");
     }
@@ -87,6 +87,9 @@ var SmtpProvider = class {
       if (bcc) {
         mailOptions.bcc = this.formatRecipients(bcc);
       }
+      if (headers && Object.keys(headers).length > 0) {
+        mailOptions.headers = headers;
+      }
       const info = await transporter.sendMail(mailOptions);
       return {
         success: true,

package/dist/{types-CCHryvHe.d.cts → types-szNtZ5IF.d.cts}

@@ -35,6 +35,12 @@ interface SendEmailParams {
     cc?: EmailAddress | EmailAddress[];
     /** BCC recipients */
     bcc?: EmailAddress | EmailAddress[];
+    /**
+     * Extra raw headers, e.g. `List-Unsubscribe` on lifecycle mail. Providers
+     * that speak raw MIME (SMTP) send them; the JSON-based providers ignore the
+     * field rather than failing the send.
+     */
+    headers?: Record<string, string>;
 }
 /**
  * Parameters for sending a templated email
@@ -54,6 +60,12 @@ interface SendTemplateParams<TData extends Record<string, unknown> = Record<stri
     cc?: EmailAddress | EmailAddress[];
     /** BCC recipients */
     bcc?: EmailAddress | EmailAddress[];
+    /**
+     * Extra raw headers, e.g. `List-Unsubscribe` on lifecycle mail. Providers
+     * that speak raw MIME (SMTP) send them; the JSON-based providers ignore the
+     * field rather than failing the send.
+     */
+    headers?: Record<string, string>;
 }
 /**
  * Result from sending an email

package/dist/{types-CCHryvHe.d.ts → types-szNtZ5IF.d.ts}

@@ -35,6 +35,12 @@ interface SendEmailParams {
     cc?: EmailAddress | EmailAddress[];
     /** BCC recipients */
     bcc?: EmailAddress | EmailAddress[];
+    /**
+     * Extra raw headers, e.g. `List-Unsubscribe` on lifecycle mail. Providers
+     * that speak raw MIME (SMTP) send them; the JSON-based providers ignore the
+     * field rather than failing the send.
+     */
+    headers?: Record<string, string>;
 }
 /**
  * Parameters for sending a templated email
@@ -54,6 +60,12 @@ interface SendTemplateParams<TData extends Record<string, unknown> = Record<stri
     cc?: EmailAddress | EmailAddress[];
     /** BCC recipients */
     bcc?: EmailAddress | EmailAddress[];
+    /**
+     * Extra raw headers, e.g. `List-Unsubscribe` on lifecycle mail. Providers
+     * that speak raw MIME (SMTP) send them; the JSON-based providers ignore the
+     * field rather than failing the send.
+     */
+    headers?: Record<string, string>;
 }
 /**
  * Result from sending an email

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shogo-ai/email",
-  "version": "2.4.6",
+  "version": "2.4.7",
   "description": "Shogo Email — multi-provider transactional email (SES, SMTP, OCI) with built-in transactional templates.",
   "license": "MIT",
   "type": "module",