@suphark/notify 0.9.0 → 0.10.1

package/README.md

@@ -72,6 +72,22 @@ await sendMail({ to, template: "po-approved", data: { name, po: { no: "PO-9" },
 - render เองฝั่งแอป (เช่นหน้าดูตัวอย่าง): `import { renderEmailTemplate } from "@suphark/notify/template"` — ตัวเดียวกับที่ hub ใช้ ไม่พึ่ง node
 - `template` ส่งได้เฉพาะผ่าน hub — provider ในเครื่องไม่ถูกใช้ (ไม่มีทางสำรองเมื่อ hub ล่ม) อีเมลสำคัญที่ต้องมีสำรองให้ render เองแล้วส่ง `html`
 
+### อีเมลล็อกอินมาตรฐาน + ข้อความสำรองเมื่อ Pi Notify ล่ม (0.10.0)
+
+```ts
+await sendMail({
+  to: user.email,
+  template: "auth.magic-link", // หรือ auth.reset-password / auth.verify-email
+  data: { url: magicLinkUrl, expiresIn: "15 นาที" }, // appName ไม่ต้องส่ง — hub เติมชื่อแอปให้
+});
+```
+
+- ใช้ได้ทุกแอปทันทีโดยไม่ต้องสร้างเทมเพลต (ฉบับสวยอยู่ที่ Pi Notify) — อยากปรับข้อความเฉพาะแอป สร้างเทมเพลตชื่อเดียวกันทับ (คอนโซล: แอป → เทมเพลตอีเมล → "ปรับสำหรับแอป")
+- **ติดต่อ Pi Notify ไม่ได้** (ล่ม/เครือข่าย/ไม่ตอบ) และแอปตั้ง provider ในเครื่องไว้ (SMTP/Resend) → SDK ส่งข้อความพื้นฐาน (หัวเรื่อง + ลิงก์ + อายุลิงก์) ผ่าน provider ในเครื่องแทน ผล `fallback: true` — ผู้ใช้ยังล็อกอินได้
+- Pi Notify ตอบว่าข้อมูลผิด (เช่นไม่ส่ง `url`) → โยน error ไม่ส่งข้อความสำรอง
+- เทมเพลตของแอปเองใส่ข้อความสำรองได้: `sendMail({ template: "po-approved", data, fallback: { subject, text, html? } })`
+- ข้อความที่ส่งทางสำรองไม่มีใน log ของ Pi Notify (ดูจาก `onEvent` type `"fallback"`)
+
 ### อีเมลที่ต้องถึงแน่: `deliverWithin` + `idempotencyKey` กับ `sendMail` (0.8.0)
 
 ```ts
@@ -487,6 +503,11 @@ Pi Notify มี contract test (`apps/notify/src/test/contract/`) เก็บ b
 
 ## Changelog
 
+- 0.10.1 — ข้อความสำรองของเทมเพลต `auth.*` ใช้ชื่อผู้ส่ง (`from` / `MAIL_FROM`) เป็นชื่อแอปในหัวเรื่องเมื่อแอปไม่ได้ส่ง `appName` (เดิมหัวเรื่องไม่มีชื่อแอป)
+- 0.10.0 — **อีเมลล็อกอินมาตรฐาน + ข้อความสำรอง** (เพิ่มอย่างเดียว; ต้องใช้ Pi Notify 2026-11-11+)
+  - เทมเพลตมาตรฐาน `auth.magic-link` / `auth.reset-password` / `auth.verify-email` ใช้ได้ทุกแอปโดยไม่ต้องสร้าง (สร้างชื่อเดียวกันเพื่อปรับ)
+  - ติดต่อ hub ไม่ได้ → ส่งข้อความพื้นฐานผ่าน provider ในเครื่อง (`SendResult.fallback`, event `"fallback"`) · `Message.fallback` สำหรับเทมเพลตของแอปเอง
+  - `listTemplates()` / `getTemplate()` คืนเทมเพลตมาตรฐานด้วย (`builtin: true`) · hub เติม `appName` ให้ทุกเทมเพลต
 - 0.9.0 — **เทมเพลตอีเมลที่ hub** (เพิ่มอย่างเดียว; ต้องใช้ Pi Notify 2026-11-11+)
   - `sendMail({ to, template, data })` — hub render เทมเพลตของแอป (`subject` ไม่บังคับเมื่อใช้ template)
   - `listTemplates` / `getTemplate` / `saveTemplate` / `deleteTemplate` / `previewTemplate` — จัดการเทมเพลตจากแอป

package/dist/{chunk-AAB6GK3Z.js → chunk-JN7P2CVF.js}

@@ -1,3 +1,7 @@
+import {
+  builtinFallback
+} from "./chunk-NNMV7FZ3.js";
+
 // src/address.ts
 var NAMED_RE = /^\s*(?:"?([^"<]*?)"?\s*)?<([^<>\s]+@[^<>\s]+)>\s*$/;
 var EMAIL_RE = /^[^\s@<>]+@[^\s@<>]+\.[^\s@<>]+$/;
@@ -807,6 +811,9 @@ function debugLogger(e) {
         `${tag} ${e.provider} cooldown [${e.kind}] until ${new Date(e.untilMs).toISOString()} (failures=${e.failures})`
       );
       break;
+    case "fallback":
+      console.warn(`${tag} hub unreachable \u2192 sent fallback text for template ${e.template}`);
+      break;
     case "recovered":
       console.log(`${tag} ${e.provider} recovered`);
       break;
@@ -913,6 +920,49 @@ function createMailer(options = {}) {
     return pick;
   }
   async function send(message) {
+    if (!message?.template) return sendVia(message, "all");
+    const fromName = (() => {
+      try {
+        return (message.from !== void 0 ? parseAddress(message.from) : defaultFrom)?.name;
+      } catch {
+        return void 0;
+      }
+    })();
+    const fallback = message.fallback ?? builtinFallback(message.template, {
+      ...fromName ? { appName: fromName } : {},
+      ...message.data
+    });
+    const hasHub = entries.some((e) => e.provider.type === "hub");
+    const hasLocal = entries.some((e) => e.provider.type !== "hub" && !e.disabled);
+    const asFallback = (fb) => ({
+      ...message,
+      template: void 0,
+      data: void 0,
+      fallback: void 0,
+      subject: fb.subject,
+      text: fb.text,
+      html: fb.html
+    });
+    if (!hasHub) {
+      if (fallback && hasLocal)
+        return { ...await sendVia(asFallback(fallback), "local"), fallback: true };
+      throw new MailError(
+        `template "${message.template}" \u0E15\u0E49\u0E2D\u0E07\u0E2A\u0E48\u0E07\u0E1C\u0E48\u0E32\u0E19 Pi Notify hub \u2014 \u0E15\u0E31\u0E49\u0E07 PI_NOTIFY_KEY`,
+        { kind: "invalid" }
+      );
+    }
+    try {
+      return await sendVia(message, "hub");
+    } catch (err) {
+      const attempts = err instanceof AllProvidersFailedError ? err.attempts : [];
+      const invalid = err instanceof MailError && err.kind === "invalid" && attempts.length === 0 || attempts.some((a) => a.kind === "invalid");
+      if (!fallback || !hasLocal || invalid) throw err;
+      emit({ type: "fallback", template: message.template });
+      const r = await sendVia(asFallback(fallback), "local");
+      return { ...r, failedOver: true, fallback: true, attempts: [...attempts, ...r.attempts] };
+    }
+  }
+  async function sendVia(message, via) {
     if (!message?.to || Array.isArray(message.to) && message.to.length === 0)
       throw new MailError("Message has no recipients (to)", { kind: "invalid" });
     if (!message.template) {
@@ -921,14 +971,8 @@ function createMailer(options = {}) {
         throw new MailError("Message needs html or text", { kind: "invalid" });
     }
     let candidates = order();
-    if (message.template) {
-      candidates = candidates.filter((e) => e.provider.type === "hub");
-      if (candidates.length === 0)
-        throw new MailError(
-          `template "${message.template}" \u0E15\u0E49\u0E2D\u0E07\u0E2A\u0E48\u0E07\u0E1C\u0E48\u0E32\u0E19 Pi Notify hub \u2014 \u0E15\u0E31\u0E49\u0E07 PI_NOTIFY_KEY`,
-          { kind: "invalid" }
-        );
-    }
+    if (via !== "all")
+      candidates = candidates.filter((e) => e.provider.type === "hub" === (via === "hub"));
     if (message.prefer) {
       const i = candidates.findIndex((e) => e.provider.name === message.prefer);
       if (i > 0) candidates = [candidates[i], ...candidates.filter((_, j) => j !== i)];

package/dist/{chunk-XVD6P4HN.js → chunk-NNMV7FZ3.js}

@@ -178,6 +178,93 @@ function renderEmailTemplate(t, data, opts = {}) {
   const text = t.text?.trim() ? renderTemplate(t.text, data, { escape: false }) : toPlainText(body);
   return { subject, html, text };
 }
+var BUILTIN_TEMPLATE_KEYS = [
+  "auth.magic-link",
+  "auth.reset-password",
+  "auth.verify-email"
+];
+function isBuiltinTemplate(key) {
+  return BUILTIN_TEMPLATE_KEYS.includes(key);
+}
+var AUTH_VARIABLES = [
+  {
+    name: "url",
+    label: "\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E17\u0E35\u0E48\u0E1C\u0E39\u0E49\u0E43\u0E0A\u0E49\u0E15\u0E49\u0E2D\u0E07\u0E01\u0E14",
+    sample: "https://app.example.com/auth/verify?token=abc",
+    required: true
+  },
+  { name: "appName", label: "\u0E0A\u0E37\u0E48\u0E2D\u0E41\u0E2D\u0E1B (hub \u0E40\u0E15\u0E34\u0E21\u0E43\u0E2B\u0E49\u0E16\u0E49\u0E32\u0E44\u0E21\u0E48\u0E2A\u0E48\u0E07)", sample: "ESTAR Supply Chain" },
+  { name: "expiresIn", label: "\u0E2D\u0E32\u0E22\u0E38\u0E25\u0E34\u0E07\u0E01\u0E4C \u0E40\u0E0A\u0E48\u0E19 15 \u0E19\u0E32\u0E17\u0E35", sample: "15 \u0E19\u0E32\u0E17\u0E35" }
+];
+var BUTTON = "display:inline-block;background:#1d4ed8;color:#ffffff;text-decoration:none;padding:12px 20px;border-radius:8px;font-weight:600";
+function authHtml(heading, lead, button, note) {
+  return `<h2 style="margin:0 0 12px;font-size:20px">${heading}</h2>
+<p style="margin:0 0 20px">${lead}</p>
+<p style="margin:0 0 20px"><a href="{{url}}" style="${BUTTON}">${button}</a></p>
+<p style="margin:0 0 8px;font-size:13px;color:#475569">${note}{{#if expiresIn}} \u0E25\u0E34\u0E07\u0E01\u0E4C\u0E2B\u0E21\u0E14\u0E2D\u0E32\u0E22\u0E38\u0E43\u0E19 {{expiresIn}}{{/if}}</p>
+<p style="margin:0 0 8px;font-size:13px;color:#475569">\u0E16\u0E49\u0E32\u0E1B\u0E38\u0E48\u0E21\u0E01\u0E14\u0E44\u0E21\u0E48\u0E44\u0E14\u0E49 \u0E43\u0E2B\u0E49\u0E04\u0E31\u0E14\u0E25\u0E2D\u0E01\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E19\u0E35\u0E49\u0E44\u0E1B\u0E40\u0E1B\u0E34\u0E14\u0E43\u0E19\u0E40\u0E1A\u0E23\u0E32\u0E27\u0E4C\u0E40\u0E0B\u0E2D\u0E23\u0E4C:<br><span style="word-break:break-all">{{url}}</span></p>
+<p style="margin:16px 0 0;font-size:13px;color:#475569">\u0E16\u0E49\u0E32\u0E04\u0E38\u0E13\u0E44\u0E21\u0E48\u0E44\u0E14\u0E49\u0E40\u0E1B\u0E47\u0E19\u0E04\u0E19\u0E02\u0E2D \u0E44\u0E21\u0E48\u0E15\u0E49\u0E2D\u0E07\u0E17\u0E33\u0E2D\u0E30\u0E44\u0E23 \u2014 \u0E1A\u0E31\u0E0D\u0E0A\u0E35\u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13\u0E22\u0E31\u0E07\u0E1B\u0E25\u0E2D\u0E14\u0E20\u0E31\u0E22</p>`;
+}
+var BUILTIN_TEMPLATES = {
+  "auth.magic-link": {
+    name: "\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E40\u0E02\u0E49\u0E32\u0E2A\u0E39\u0E48\u0E23\u0E30\u0E1A\u0E1A (\u0E21\u0E32\u0E15\u0E23\u0E10\u0E32\u0E19)",
+    subject: "\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E40\u0E02\u0E49\u0E32\u0E2A\u0E39\u0E48\u0E23\u0E30\u0E1A\u0E1A{{#if appName}} {{appName}}{{/if}}",
+    html: authHtml(
+      "\u0E40\u0E02\u0E49\u0E32\u0E2A\u0E39\u0E48\u0E23\u0E30\u0E1A\u0E1A{{#if appName}} {{appName}}{{/if}}",
+      "\u0E01\u0E14\u0E1B\u0E38\u0E48\u0E21\u0E14\u0E49\u0E32\u0E19\u0E25\u0E48\u0E32\u0E07\u0E40\u0E1E\u0E37\u0E48\u0E2D\u0E40\u0E02\u0E49\u0E32\u0E2A\u0E39\u0E48\u0E23\u0E30\u0E1A\u0E1A \u0E44\u0E21\u0E48\u0E15\u0E49\u0E2D\u0E07\u0E43\u0E0A\u0E49\u0E23\u0E2B\u0E31\u0E2A\u0E1C\u0E48\u0E32\u0E19",
+      "\u0E40\u0E02\u0E49\u0E32\u0E2A\u0E39\u0E48\u0E23\u0E30\u0E1A\u0E1A",
+      "\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E19\u0E35\u0E49\u0E43\u0E0A\u0E49\u0E44\u0E14\u0E49\u0E04\u0E23\u0E31\u0E49\u0E07\u0E40\u0E14\u0E35\u0E22\u0E27"
+    ),
+    variables: AUTH_VARIABLES
+  },
+  "auth.reset-password": {
+    name: "\u0E15\u0E31\u0E49\u0E07\u0E23\u0E2B\u0E31\u0E2A\u0E1C\u0E48\u0E32\u0E19\u0E43\u0E2B\u0E21\u0E48 (\u0E21\u0E32\u0E15\u0E23\u0E10\u0E32\u0E19)",
+    subject: "\u0E15\u0E31\u0E49\u0E07\u0E23\u0E2B\u0E31\u0E2A\u0E1C\u0E48\u0E32\u0E19\u0E43\u0E2B\u0E21\u0E48{{#if appName}} {{appName}}{{/if}}",
+    html: authHtml(
+      "\u0E15\u0E31\u0E49\u0E07\u0E23\u0E2B\u0E31\u0E2A\u0E1C\u0E48\u0E32\u0E19\u0E43\u0E2B\u0E21\u0E48",
+      "\u0E21\u0E35\u0E04\u0E33\u0E02\u0E2D\u0E15\u0E31\u0E49\u0E07\u0E23\u0E2B\u0E31\u0E2A\u0E1C\u0E48\u0E32\u0E19\u0E43\u0E2B\u0E21\u0E48\u0E2A\u0E33\u0E2B\u0E23\u0E31\u0E1A\u0E1A\u0E31\u0E0D\u0E0A\u0E35\u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13{{#if appName}} \u0E43\u0E19 {{appName}}{{/if}} \u0E01\u0E14\u0E1B\u0E38\u0E48\u0E21\u0E14\u0E49\u0E32\u0E19\u0E25\u0E48\u0E32\u0E07\u0E40\u0E1E\u0E37\u0E48\u0E2D\u0E15\u0E31\u0E49\u0E07\u0E23\u0E2B\u0E31\u0E2A\u0E1C\u0E48\u0E32\u0E19\u0E43\u0E2B\u0E21\u0E48",
+      "\u0E15\u0E31\u0E49\u0E07\u0E23\u0E2B\u0E31\u0E2A\u0E1C\u0E48\u0E32\u0E19\u0E43\u0E2B\u0E21\u0E48",
+      "\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E19\u0E35\u0E49\u0E43\u0E0A\u0E49\u0E44\u0E14\u0E49\u0E04\u0E23\u0E31\u0E49\u0E07\u0E40\u0E14\u0E35\u0E22\u0E27"
+    ),
+    variables: AUTH_VARIABLES
+  },
+  "auth.verify-email": {
+    name: "\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E2D\u0E35\u0E40\u0E21\u0E25 (\u0E21\u0E32\u0E15\u0E23\u0E10\u0E32\u0E19)",
+    subject: "\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E2D\u0E35\u0E40\u0E21\u0E25\u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13{{#if appName}} \u2014 {{appName}}{{/if}}",
+    html: authHtml(
+      "\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E2D\u0E35\u0E40\u0E21\u0E25\u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13",
+      "\u0E01\u0E14\u0E1B\u0E38\u0E48\u0E21\u0E14\u0E49\u0E32\u0E19\u0E25\u0E48\u0E32\u0E07\u0E40\u0E1E\u0E37\u0E48\u0E2D\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E27\u0E48\u0E32\u0E2D\u0E35\u0E40\u0E21\u0E25\u0E19\u0E35\u0E49\u0E40\u0E1B\u0E47\u0E19\u0E02\u0E2D\u0E07\u0E04\u0E38\u0E13{{#if appName}} \u0E41\u0E25\u0E30\u0E40\u0E23\u0E34\u0E48\u0E21\u0E43\u0E0A\u0E49 {{appName}}{{/if}}",
+      "\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E2D\u0E35\u0E40\u0E21\u0E25",
+      "\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E04\u0E23\u0E31\u0E49\u0E07\u0E40\u0E14\u0E35\u0E22\u0E27\u0E01\u0E47\u0E1E\u0E2D"
+    ),
+    variables: AUTH_VARIABLES
+  }
+};
+var FALLBACK_SUBJECT = {
+  "auth.magic-link": "\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E40\u0E02\u0E49\u0E32\u0E2A\u0E39\u0E48\u0E23\u0E30\u0E1A\u0E1A",
+  "auth.reset-password": "\u0E15\u0E31\u0E49\u0E07\u0E23\u0E2B\u0E31\u0E2A\u0E1C\u0E48\u0E32\u0E19\u0E43\u0E2B\u0E21\u0E48",
+  "auth.verify-email": "\u0E22\u0E37\u0E19\u0E22\u0E31\u0E19\u0E2D\u0E35\u0E40\u0E21\u0E25"
+};
+function builtinFallback(key, data) {
+  if (!isBuiltinTemplate(key)) return null;
+  const url = typeof data?.url === "string" ? data.url : "";
+  if (!url) return null;
+  const app = typeof data?.appName === "string" && data.appName ? data.appName : "";
+  const expires = typeof data?.expiresIn === "string" && data.expiresIn ? data.expiresIn : "";
+  const subject = `${FALLBACK_SUBJECT[key]}${app ? ` ${app}` : ""}`;
+  const lines = [
+    `${FALLBACK_SUBJECT[key]}${app ? ` (${app})` : ""}`,
+    "",
+    "\u0E40\u0E1B\u0E34\u0E14\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E19\u0E35\u0E49:",
+    url,
+    "",
+    ...expires ? [`\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E2B\u0E21\u0E14\u0E2D\u0E32\u0E22\u0E38\u0E43\u0E19 ${expires}`] : [],
+    "\u0E16\u0E49\u0E32\u0E04\u0E38\u0E13\u0E44\u0E21\u0E48\u0E44\u0E14\u0E49\u0E40\u0E1B\u0E47\u0E19\u0E04\u0E19\u0E02\u0E2D \u0E44\u0E21\u0E48\u0E15\u0E49\u0E2D\u0E07\u0E17\u0E33\u0E2D\u0E30\u0E44\u0E23"
+  ];
+  const text = lines.join("\n");
+  const html = `<p>${escapeHtml(lines[0])}</p><p><a href="${escapeHtml(url)}">${escapeHtml(url)}</a></p>${expires ? `<p>\u0E25\u0E34\u0E07\u0E01\u0E4C\u0E2B\u0E21\u0E14\u0E2D\u0E32\u0E22\u0E38\u0E43\u0E19 ${escapeHtml(expires)}</p>` : ""}<p>\u0E16\u0E49\u0E32\u0E04\u0E38\u0E13\u0E44\u0E21\u0E48\u0E44\u0E14\u0E49\u0E40\u0E1B\u0E47\u0E19\u0E04\u0E19\u0E02\u0E2D \u0E44\u0E21\u0E48\u0E15\u0E49\u0E2D\u0E07\u0E17\u0E33\u0E2D\u0E30\u0E44\u0E23</p>`;
+  return { subject, text, html };
+}
 
 export {
   looksLikeHtml,
@@ -189,5 +276,9 @@ export {
   templateVariableNames,
   sampleData,
   wrapEmailLayout,
-  renderEmailTemplate
+  renderEmailTemplate,
+  BUILTIN_TEMPLATE_KEYS,
+  isBuiltinTemplate,
+  BUILTIN_TEMPLATES,
+  builtinFallback
 };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { P as ParsedAddress, A as Address, a as Provider, E as ErrorKind, Q as Quota, M as Message, S as SendResult, b as ProviderStatus, c as ProviderInfo, d as Store, e as MailerEvent, f as Attempt, g as PushDevice, N as NotifyOptions, h as NotifyResultItem, i as NotifyInput, j as NotifyTopicInput } from './notify-Dgzxhh-U.js';
-export { k as Attachment, C as ChannelStatus, l as NOTIFY_TIMEOUT_MS, m as NormalizedMessage, n as NotifyChannel, o as NotifyResult, p as PushSubscriptionJson, q as QuotaUsage, R as Recipient, r as RecipientChannelInfo, s as RecipientInfo, t as RequestStatus, u as SkipReason, v as createLink, w as deletePushSubscription, x as getChannelStatus, y as getPushConfig, z as getRecipient, B as getRequestStatus, D as hasNotifyKey, F as listPushDevices, G as notify, H as notifyTopic, I as savePushSubscription, J as toEmails } from './notify-Dgzxhh-U.js';
+import { P as ParsedAddress, A as Address, a as Provider, E as ErrorKind, Q as Quota, M as Message, S as SendResult, b as ProviderStatus, c as ProviderInfo, d as Store, e as MailerEvent, f as Attempt, g as PushDevice, N as NotifyOptions, h as NotifyResultItem, i as NotifyInput, j as NotifyTopicInput } from './notify-D-PhiDzT.js';
+export { k as Attachment, C as ChannelStatus, l as NOTIFY_TIMEOUT_MS, m as NormalizedMessage, n as NotifyChannel, o as NotifyResult, p as PushSubscriptionJson, q as QuotaUsage, R as Recipient, r as RecipientChannelInfo, s as RecipientInfo, t as RequestStatus, u as SkipReason, v as createLink, w as deletePushSubscription, x as getChannelStatus, y as getPushConfig, z as getRecipient, B as getRequestStatus, D as hasNotifyKey, F as listPushDevices, G as notify, H as notifyTopic, I as savePushSubscription, J as toEmails } from './notify-D-PhiDzT.js';
 import { TemplateVariable } from './template.js';
-export { TemplateError, renderEmailTemplate } from './template.js';
+export { BUILTIN_TEMPLATE_KEYS, BuiltinTemplateKey, TemplateError, builtinFallback, isBuiltinTemplate, renderEmailTemplate } from './template.js';
 
 /** แปลง "ชื่อ <a@b.com>" / "a@b.com" / { name, email } → { name, email } */
 declare function parseAddress(input: Address): ParsedAddress;
@@ -479,6 +479,8 @@ interface EmailTemplateInfo {
     enabled: boolean;
     version: number;
     updatedAt: string;
+    /** (0.10.0) true = เทมเพลตมาตรฐานของ Pi Notify (auth.*) ที่แอปยังไม่ได้สร้างทับ */
+    builtin?: boolean;
 }
 interface EmailTemplateInput {
     name: string;

package/dist/index.js

@@ -41,14 +41,17 @@ import {
   sendMail,
   sendMailSafe,
   toEmails
-} from "./chunk-AAB6GK3Z.js";
+} from "./chunk-JN7P2CVF.js";
 import {
+  BUILTIN_TEMPLATE_KEYS,
   TemplateError,
+  builtinFallback,
+  isBuiltinTemplate,
   looksLikeHtml,
   renderEmailTemplate,
   resolveFormat,
   toPlainText
-} from "./chunk-XVD6P4HN.js";
+} from "./chunk-NNMV7FZ3.js";
 
 // src/push.ts
 function createPushHandlers(options) {
@@ -227,12 +230,14 @@ async function previewTemplate(key, input = {}, opts = {}) {
 }
 export {
   AllProvidersFailedError,
+  BUILTIN_TEMPLATE_KEYS,
   DEFAULT_COOLDOWN,
   DEFAULT_HUB_URL,
   MailError,
   NOTIFY_TIMEOUT_MS,
   SMTP_PRESETS,
   TemplateError,
+  builtinFallback,
   classifyError,
   configureMailer,
   createConsoleProvider,
@@ -256,6 +261,7 @@ export {
   getRequestStatus,
   getTemplate,
   hasNotifyKey,
+  isBuiltinTemplate,
   listProviders,
   listPushDevices,
   listTemplates,

package/dist/next.js

@@ -2,7 +2,8 @@ import {
   notifySafe,
   notifyTopicSafe,
   sendMailSafe
-} from "./chunk-AAB6GK3Z.js";
+} from "./chunk-JN7P2CVF.js";
+import "./chunk-NNMV7FZ3.js";
 
 // src/next.ts
 import { after } from "next/server";

package/dist/{notify-Dgzxhh-U.d.ts → notify-D-PhiDzT.d.ts}

@@ -47,6 +47,15 @@ interface Message {
     template?: string;
     /** ค่าตัวแปรของเทมเพลต (`{{name}}`, `{{#each items}}` …) */
     data?: Record<string, unknown>;
+    /**
+     * (0.10.0) ข้อความสำรองเมื่อติดต่อ Pi Notify ไม่ได้ — ส่งผ่าน provider ในเครื่อง (SMTP/Resend)
+     * เทมเพลตมาตรฐาน `auth.*` มีข้อความสำรองในตัวแล้ว ไม่ต้องใส่
+     */
+    fallback?: {
+        subject: string;
+        text: string;
+        html?: string;
+    };
 }
 /** ข้อมูลตัวเลือกที่แอปควรรู้ — แค่ชื่อ/ประเภท/พร้อมใช้ไหม */
 interface ProviderInfo {
@@ -113,6 +122,8 @@ interface SendResult {
     attempts: Attempt[];
     /** (0.8.0) hub รับไว้ส่งซ้ำเอง (ส่ง deliverWithin) — ยังไม่ถึงผู้รับ, `id` = deliveryId ในคิวของ hub */
     queued?: boolean;
+    /** (0.10.0) ส่งข้อความสำรองของเทมเพลตผ่าน provider ในเครื่อง เพราะติดต่อ Pi Notify ไม่ได้ */
+    fallback?: boolean;
 }
 interface Quota {
     perHour?: number;
@@ -178,6 +189,11 @@ type MailerEvent = {
 } | {
     type: "exhausted";
     attempts: Attempt[];
+}
+/** (0.10.0) ติดต่อ hub ไม่ได้ จึงส่งข้อความสำรองของเทมเพลตผ่าน provider ในเครื่อง */
+ | {
+    type: "fallback";
+    template: string;
 };
 interface QuotaUsage {
     window: "hour" | "day" | "month";

package/dist/template.d.ts

@@ -74,6 +74,23 @@ declare function renderEmailTemplate(t: EmailTemplateSource, data: Data, opts?:
     html: string;
     text: string;
 };
+/** ชื่อเทมเพลตมาตรฐาน — ทุกแอปใช้ได้โดยไม่ต้องสร้าง (สร้างชื่อเดียวกันใน Pi Notify เพื่อปรับเฉพาะแอป) */
+declare const BUILTIN_TEMPLATE_KEYS: readonly ["auth.magic-link", "auth.reset-password", "auth.verify-email"];
+type BuiltinTemplateKey = (typeof BUILTIN_TEMPLATE_KEYS)[number];
+declare function isBuiltinTemplate(key: string): key is BuiltinTemplateKey;
+/** ฉบับเต็ม (hub ใช้เมื่อแอปไม่ได้สร้างเทมเพลตชื่อนี้เอง) */
+declare const BUILTIN_TEMPLATES: Record<BuiltinTemplateKey, EmailTemplateSource & {
+    name: string;
+}>;
+/**
+ * ข้อความสำรองแบบพื้นฐาน (ไม่สวย แต่ใช้ล็อกอินได้) — SDK ส่งผ่าน provider ในเครื่องเมื่อติดต่อ Pi Notify ไม่ได้
+ * คืน null เมื่อไม่ใช่เทมเพลตมาตรฐานหรือไม่มี url
+ */
+declare function builtinFallback(key: string, data: Record<string, unknown> | undefined): {
+    subject: string;
+    text: string;
+    html: string;
+} | null;
 
-export { TemplateError, parseTemplate, renderEmailTemplate, renderTemplate, sampleData, templateVariableNames, wrapEmailLayout };
-export type { EmailTemplateSource, TemplateVariable };
+export { BUILTIN_TEMPLATES, BUILTIN_TEMPLATE_KEYS, TemplateError, builtinFallback, isBuiltinTemplate, parseTemplate, renderEmailTemplate, renderTemplate, sampleData, templateVariableNames, wrapEmailLayout };
+export type { BuiltinTemplateKey, EmailTemplateSource, TemplateVariable };

package/dist/template.js

@@ -1,14 +1,22 @@
 import {
+  BUILTIN_TEMPLATES,
+  BUILTIN_TEMPLATE_KEYS,
   TemplateError,
+  builtinFallback,
+  isBuiltinTemplate,
   parseTemplate,
   renderEmailTemplate,
   renderTemplate,
   sampleData,
   templateVariableNames,
   wrapEmailLayout
-} from "./chunk-XVD6P4HN.js";
+} from "./chunk-NNMV7FZ3.js";
 export {
+  BUILTIN_TEMPLATES,
+  BUILTIN_TEMPLATE_KEYS,
   TemplateError,
+  builtinFallback,
+  isBuiltinTemplate,
   parseTemplate,
   renderEmailTemplate,
   renderTemplate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suphark/notify",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "private": false,
   "type": "module",
   "description": "ส่งอีเมล + แจ้งเตือน Telegram ผ่าน Pi Notify hub (notify.suphark.com) หรือส่งอีเมลตรงไป Resend/SMTP/Zoho/ZeptoMail ใน API เดียว พร้อม failover อัตโนมัติ",