@shogo-ai/email 1.9.11 → 1.9.13

package/dist/{chunk-VPWVZHAC.js → chunk-AHEPUREO.js}

@@ -24,10 +24,15 @@ var EmailError = class _EmailError extends Error {
 };
 
 // src/templates.ts
-function interpolate(template, data) {
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function interpolate(template, data, options = {}) {
   return template.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (match, path) => {
     const value = getNestedValue(data, path);
-    return value !== void 0 ? String(value) : match;
+    if (value === void 0) return match;
+    const str = String(value);
+    return options.escapeValues ? escapeHtml(str) : str;
   });
 }
 function getNestedValue(obj, path) {
@@ -80,8 +85,8 @@ var EmailTemplateRegistry = class {
       currentYear: (/* @__PURE__ */ new Date()).getFullYear()
     };
     const subject = interpolate(template.subject, allData);
-    const html = interpolate(template.html, allData);
-    const text = template.text ? interpolate(template.text, allData) : htmlToText(html);
+    const html = interpolate(template.html, allData, { escapeValues: true });
+    const text = template.text ? interpolate(template.text, allData) : htmlToText(interpolate(template.html, allData));
     return { subject, html, text };
   }
   /**
@@ -771,6 +776,72 @@ var paymentFailedTemplate = {
   }
 };
 
+// src/templates/billing/usage-overage-charged.ts
+var usageOverageChargedTemplate = {
+  name: "usage-overage-charged",
+  subject: "Usage charge of {{currency}}{{amount}} for {{workspaceName}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">On-demand usage charged</h1>
+    <p class="email-text">
+      <strong>{{workspaceName}}</strong> has used more than its included monthly
+      usage, so we charged an on-demand usage block. We bill these in blocks as
+      you go rather than one large amount at the end of the period.
+    </p>
+    <table width="100%" cellpadding="0" cellspacing="0">
+      <tr>
+        <td class="email-detail-label">Charged now</td>
+        <td class="email-detail-value" align="right">{{currency}}{{amount}}</td>
+      </tr>
+      <tr>
+        <td class="email-detail-label">Overage this period</td>
+        <td class="email-detail-value" align="right">{{currency}}{{periodOverageUsd}}</td>
+      </tr>
+    </table>
+    <br>
+    <a href="{{invoiceUrl}}" class="email-btn-outline">View invoice</a>
+    <hr class="email-divider">
+    <p class="email-text">
+      Want to cap on-demand spend? You can set a monthly spending limit any time.
+    </p>
+    <a href="{{manageUrl}}" class="email-btn-outline">Set a spending limit</a>
+    <p class="email-muted">
+      If you have billing questions, reply to this email or contact support.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME,
+    currency: "$"
+  }
+};
+
+// src/templates/billing/usage-approaching-limit.ts
+var usageApproachingLimitTemplate = {
+  name: "usage-approaching-limit",
+  subject: "Usage alert: {{workspaceName}} is at {{percentUsed}}% of its {{limitLabel}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">Approaching your {{limitLabel}}</h1>
+    <p class="email-text">
+      <strong>{{workspaceName}}</strong> has used
+      <strong>{{currency}}{{usedUsd}}</strong> of its
+      <strong>{{currency}}{{limitUsd}}</strong> {{limitLabel}} this period
+      (<strong>{{percentUsed}}%</strong>).
+    </p>
+    <p class="email-text">
+      Once the included amount is used up, additional usage is billed on demand.
+      You can review usage or set a monthly spending limit below.
+    </p>
+    <a href="{{manageUrl}}" class="email-btn">Review usage &amp; limits</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're receiving this because you're a billing admin for this workspace.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME,
+    currency: "$"
+  }
+};
+
 // src/templates/workspace/member-joined.ts
 var memberJoinedTemplate = {
   name: "member-joined",
@@ -849,6 +920,8 @@ var allTemplates = [
   planUpgradedTemplate,
   paymentReceiptTemplate,
   paymentFailedTemplate,
+  usageOverageChargedTemplate,
+  usageApproachingLimitTemplate,
   memberJoinedTemplate,
   memberRemovedTemplate,
   accountDeletedTemplate
@@ -879,4 +952,4 @@ export {
   allTemplates,
   createShogoTemplateRegistry
 };
-//# sourceMappingURL=chunk-VPWVZHAC.js.map
+//# sourceMappingURL=chunk-AHEPUREO.js.map

package/dist/index.cjs

@@ -65,10 +65,15 @@ var EmailError = class _EmailError extends Error {
 };
 
 // src/templates.ts
-function interpolate(template, data) {
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function interpolate(template, data, options = {}) {
   return template.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (match, path) => {
     const value = getNestedValue(data, path);
-    return value !== void 0 ? String(value) : match;
+    if (value === void 0) return match;
+    const str = String(value);
+    return options.escapeValues ? escapeHtml(str) : str;
   });
 }
 function getNestedValue(obj, path) {
@@ -121,8 +126,8 @@ var EmailTemplateRegistry = class {
       currentYear: (/* @__PURE__ */ new Date()).getFullYear()
     };
     const subject = interpolate(template.subject, allData);
-    const html = interpolate(template.html, allData);
-    const text = template.text ? interpolate(template.text, allData) : htmlToText(html);
+    const html = interpolate(template.html, allData, { escapeValues: true });
+    const text = template.text ? interpolate(template.text, allData) : htmlToText(interpolate(template.html, allData));
     return { subject, html, text };
   }
   /**
@@ -812,6 +817,72 @@ var paymentFailedTemplate = {
   }
 };
 
+// src/templates/billing/usage-overage-charged.ts
+var usageOverageChargedTemplate = {
+  name: "usage-overage-charged",
+  subject: "Usage charge of {{currency}}{{amount}} for {{workspaceName}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">On-demand usage charged</h1>
+    <p class="email-text">
+      <strong>{{workspaceName}}</strong> has used more than its included monthly
+      usage, so we charged an on-demand usage block. We bill these in blocks as
+      you go rather than one large amount at the end of the period.
+    </p>
+    <table width="100%" cellpadding="0" cellspacing="0">
+      <tr>
+        <td class="email-detail-label">Charged now</td>
+        <td class="email-detail-value" align="right">{{currency}}{{amount}}</td>
+      </tr>
+      <tr>
+        <td class="email-detail-label">Overage this period</td>
+        <td class="email-detail-value" align="right">{{currency}}{{periodOverageUsd}}</td>
+      </tr>
+    </table>
+    <br>
+    <a href="{{invoiceUrl}}" class="email-btn-outline">View invoice</a>
+    <hr class="email-divider">
+    <p class="email-text">
+      Want to cap on-demand spend? You can set a monthly spending limit any time.
+    </p>
+    <a href="{{manageUrl}}" class="email-btn-outline">Set a spending limit</a>
+    <p class="email-muted">
+      If you have billing questions, reply to this email or contact support.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME,
+    currency: "$"
+  }
+};
+
+// src/templates/billing/usage-approaching-limit.ts
+var usageApproachingLimitTemplate = {
+  name: "usage-approaching-limit",
+  subject: "Usage alert: {{workspaceName}} is at {{percentUsed}}% of its {{limitLabel}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">Approaching your {{limitLabel}}</h1>
+    <p class="email-text">
+      <strong>{{workspaceName}}</strong> has used
+      <strong>{{currency}}{{usedUsd}}</strong> of its
+      <strong>{{currency}}{{limitUsd}}</strong> {{limitLabel}} this period
+      (<strong>{{percentUsed}}%</strong>).
+    </p>
+    <p class="email-text">
+      Once the included amount is used up, additional usage is billed on demand.
+      You can review usage or set a monthly spending limit below.
+    </p>
+    <a href="{{manageUrl}}" class="email-btn">Review usage &amp; limits</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're receiving this because you're a billing admin for this workspace.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME,
+    currency: "$"
+  }
+};
+
 // src/templates/workspace/member-joined.ts
 var memberJoinedTemplate = {
   name: "member-joined",
@@ -890,6 +961,8 @@ var allTemplates = [
   planUpgradedTemplate,
   paymentReceiptTemplate,
   paymentFailedTemplate,
+  usageOverageChargedTemplate,
+  usageApproachingLimitTemplate,
   memberJoinedTemplate,
   memberRemovedTemplate,
   accountDeletedTemplate

package/dist/index.d.cts

@@ -16,9 +16,13 @@ export { a as EmailAddress, b as EmailConfig, c as EmailError, d as EmailErrorCo
  *
  * @param template - Template string with {{variable}} placeholders
  * @param data - Data object with values to interpolate
+ * @param options - When `escapeValues` is true, interpolated values are
+ *   HTML-encoded (use for HTML bodies; leave off for plain-text subject/text)
  * @returns Interpolated string
  */
-declare function interpolate(template: string, data: Record<string, unknown>): string;
+declare function interpolate(template: string, data: Record<string, unknown>, options?: {
+    escapeValues?: boolean;
+}): string;
 /**
  * Strip HTML tags to create plain text version.
  *

package/dist/index.d.ts

@@ -16,9 +16,13 @@ export { a as EmailAddress, b as EmailConfig, c as EmailError, d as EmailErrorCo
  *
  * @param template - Template string with {{variable}} placeholders
  * @param data - Data object with values to interpolate
+ * @param options - When `escapeValues` is true, interpolated values are
+ *   HTML-encoded (use for HTML bodies; leave off for plain-text subject/text)
  * @returns Interpolated string
  */
-declare function interpolate(template: string, data: Record<string, unknown>): string;
+declare function interpolate(template: string, data: Record<string, unknown>, options?: {
+    escapeValues?: boolean;
+}): string;
 /**
  * Strip HTML tags to create plain text version.
  *

package/dist/index.js

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

package/dist/server.cjs

@@ -379,10 +379,15 @@ function createProviderFromEnv() {
 }
 
 // src/templates.ts
-function interpolate(template, data) {
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function interpolate(template, data, options = {}) {
   return template.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (match, path) => {
     const value = getNestedValue(data, path);
-    return value !== void 0 ? String(value) : match;
+    if (value === void 0) return match;
+    const str = String(value);
+    return options.escapeValues ? escapeHtml(str) : str;
   });
 }
 function getNestedValue(obj, path) {
@@ -435,8 +440,8 @@ var EmailTemplateRegistry = class {
       currentYear: (/* @__PURE__ */ new Date()).getFullYear()
     };
     const subject = interpolate(template.subject, allData);
-    const html = interpolate(template.html, allData);
-    const text = template.text ? interpolate(template.text, allData) : htmlToText(html);
+    const html = interpolate(template.html, allData, { escapeValues: true });
+    const text = template.text ? interpolate(template.text, allData) : htmlToText(interpolate(template.html, allData));
     return { subject, html, text };
   }
   /**
@@ -887,6 +892,72 @@ var paymentFailedTemplate = {
   }
 };
 
+// src/templates/billing/usage-overage-charged.ts
+var usageOverageChargedTemplate = {
+  name: "usage-overage-charged",
+  subject: "Usage charge of {{currency}}{{amount}} for {{workspaceName}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">On-demand usage charged</h1>
+    <p class="email-text">
+      <strong>{{workspaceName}}</strong> has used more than its included monthly
+      usage, so we charged an on-demand usage block. We bill these in blocks as
+      you go rather than one large amount at the end of the period.
+    </p>
+    <table width="100%" cellpadding="0" cellspacing="0">
+      <tr>
+        <td class="email-detail-label">Charged now</td>
+        <td class="email-detail-value" align="right">{{currency}}{{amount}}</td>
+      </tr>
+      <tr>
+        <td class="email-detail-label">Overage this period</td>
+        <td class="email-detail-value" align="right">{{currency}}{{periodOverageUsd}}</td>
+      </tr>
+    </table>
+    <br>
+    <a href="{{invoiceUrl}}" class="email-btn-outline">View invoice</a>
+    <hr class="email-divider">
+    <p class="email-text">
+      Want to cap on-demand spend? You can set a monthly spending limit any time.
+    </p>
+    <a href="{{manageUrl}}" class="email-btn-outline">Set a spending limit</a>
+    <p class="email-muted">
+      If you have billing questions, reply to this email or contact support.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME,
+    currency: "$"
+  }
+};
+
+// src/templates/billing/usage-approaching-limit.ts
+var usageApproachingLimitTemplate = {
+  name: "usage-approaching-limit",
+  subject: "Usage alert: {{workspaceName}} is at {{percentUsed}}% of its {{limitLabel}}",
+  html: wrapInLayout(`
+    <h1 class="email-h1">Approaching your {{limitLabel}}</h1>
+    <p class="email-text">
+      <strong>{{workspaceName}}</strong> has used
+      <strong>{{currency}}{{usedUsd}}</strong> of its
+      <strong>{{currency}}{{limitUsd}}</strong> {{limitLabel}} this period
+      (<strong>{{percentUsed}}%</strong>).
+    </p>
+    <p class="email-text">
+      Once the included amount is used up, additional usage is billed on demand.
+      You can review usage or set a monthly spending limit below.
+    </p>
+    <a href="{{manageUrl}}" class="email-btn">Review usage &amp; limits</a>
+    <hr class="email-divider">
+    <p class="email-muted">
+      You're receiving this because you're a billing admin for this workspace.
+    </p>
+  `),
+  defaults: {
+    appName: EMAIL_CONSTANTS.APP_NAME,
+    currency: "$"
+  }
+};
+
 // src/templates/workspace/member-joined.ts
 var memberJoinedTemplate = {
   name: "member-joined",
@@ -965,6 +1036,8 @@ var allTemplates = [
   planUpgradedTemplate,
   paymentReceiptTemplate,
   paymentFailedTemplate,
+  usageOverageChargedTemplate,
+  usageApproachingLimitTemplate,
   memberJoinedTemplate,
   memberRemovedTemplate,
   accountDeletedTemplate

package/dist/server.js

@@ -3,7 +3,7 @@ import {
   EmailTemplateRegistry,
   createShogoTemplateRegistry,
   formatEmailAddress
-} from "./chunk-VPWVZHAC.js";
+} from "./chunk-AHEPUREO.js";
 
 // src/providers/smtp.ts
 var SmtpProvider = class {

package/package.json

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