@suphark/notify 0.10.1 → 0.11.0

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

@@ -158,6 +158,11 @@ function sampleData(variables) {
   }
   return out;
 }
+function htmlToText(html) {
+  return toPlainText(
+    html.replace(/<(head|style|script|title)\b[^>]*>[\s\S]*?<\/\1\s*>/gi, "").replace(/<\/(p|div|li|h[1-6]|tr|table|ul|ol)\s*>/gi, "$&\n")
+  ).replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+}
 function wrapEmailLayout(body, opts = {}) {
   const footer = opts.appName ? `<p style="margin:24px 0 0;font-size:12px;color:#64748b">\u0E2A\u0E48\u0E07\u0E08\u0E32\u0E01 ${escapeHtml(opts.appName)}</p>` : "";
   return `<!doctype html>
@@ -175,7 +180,7 @@ function renderEmailTemplate(t, data, opts = {}) {
   const subject = renderTemplate(t.subject, data, { escape: false }).replace(/\s+/g, " ").trim();
   const body = renderTemplate(t.html, data, { escape: true });
   const html = /<html[\s>]/i.test(body) ? body : wrapEmailLayout(body, { ...opts, title: subject });
-  const text = t.text?.trim() ? renderTemplate(t.text, data, { escape: false }) : toPlainText(body);
+  const text = t.text?.trim() ? renderTemplate(t.text, data, { escape: false }) : htmlToText(body);
   return { subject, html, text };
 }
 var BUILTIN_TEMPLATE_KEYS = [
@@ -275,6 +280,7 @@ export {
   renderTemplate,
   templateVariableNames,
   sampleData,
+  htmlToText,
   wrapEmailLayout,
   renderEmailTemplate,
   BUILTIN_TEMPLATE_KEYS,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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 { P as ParsedAddress, A as Address, a as PushDevice, N as NotifyOptions, C as ChannelStatus, b as Provider, E as ErrorKind, Q as Quota, M as Message, S as SendResult, c as ProviderStatus, d as ProviderInfo, e as Store, f as MailerEvent, g as Attempt, h as NotifyResultItem, i as NotifyInput, j as NotifyTopicInput } from './notify-DA7BsQBD.js';
+export { k as Attachment, 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 absoluteLink, w as createLink, x as deletePushSubscription, y as getChannelStatus, z as getPushConfig, B as getRecipient, D as getRequestStatus, F as hasNotifyKey, G as listPushDevices, H as notify, I as notifyTopic, J as pauseChannel, K as savePushSubscription, L as toEmails } from './notify-DA7BsQBD.js';
 import { TemplateVariable } from './template.js';
 export { BUILTIN_TEMPLATE_KEYS, BuiltinTemplateKey, TemplateError, builtinFallback, isBuiltinTemplate, renderEmailTemplate } from './template.js';
 
@@ -13,6 +13,100 @@ declare function parseAddressList(input: Address | Address[] | undefined): Parse
 /** { name, email } → "ชื่อ <a@b.com>" (สำหรับ API ที่รับ string) */
 declare function formatAddress(a: ParsedAddress): string;
 
+/** ผู้ใช้ที่ล็อกอินอยู่ในแอป — **ต้องมาจาก session ฝั่ง server เท่านั้น** ห้ามรับอีเมลจาก client */
+interface PushUser {
+    email: string;
+    /** user id ใน Pi Auth (sub) — ให้ Pi Notify ลบ subscription ตามบัญชีที่ถูกลบ */
+    id?: string;
+}
+/** รูปที่ `PushSubscription.toJSON()` ของเบราว์เซอร์ส่งมา (field optional ตาม DOM type) */
+interface BrowserPushSubscription {
+    endpoint?: string;
+    keys?: Record<string, string | undefined>;
+}
+interface PushHandlersOptions extends NotifyOptions {
+    /** ดึงผู้ใช้จาก session ของแอป — คืน null/undefined = ยังไม่ล็อกอิน */
+    getUser: () => PushUser | null | undefined | Promise<PushUser | null | undefined>;
+}
+interface PushHandlers {
+    /** VAPID public key สำหรับ `pushManager.subscribe({ applicationServerKey })` */
+    getPublicKey(): Promise<string>;
+    subscribe(subscription: BrowserPushSubscription, opts?: {
+        label?: string;
+    }): Promise<{
+        ok: true;
+        created: boolean;
+    }>;
+    unsubscribe(endpoint: string): Promise<{
+        ok: true;
+        deleted: number;
+    }>;
+    listDevices(): Promise<{
+        devices: PushDevice[];
+    }>;
+}
+/**
+ * ชุดฟังก์ชันสำหรับ Server Actions ของ `<WebPushRow />` — แอปส่งแค่ `getUser`
+ * (ใน `"use server"` ห่อเป็น `export async function` ทีละตัว; ห้าม import SDK ใน Client Component)
+ */
+declare function createPushHandlers(options: PushHandlersOptions): PushHandlers;
+interface PushServiceWorkerOptions {
+    /** ไอคอนของการแจ้งเตือน (path ในแอป) ค่าเริ่มต้น /icon-192.png */
+    icon?: string;
+    /** ลิงก์ที่เปิดเมื่อ payload ไม่มี link ค่าเริ่มต้น / */
+    defaultLink?: string;
+}
+/** ซอร์ส service worker ที่รับ push ของ Pi Notify (payload { title, body, link? }) — เปิดเฉพาะลิงก์ใน origin ของแอป */
+declare function pushServiceWorkerSource(options?: PushServiceWorkerOptions): string;
+/**
+ * Route Handler ที่เสิร์ฟ service worker จากตัวแพ็กเกจเอง (same-origin, ล็อกเวอร์ชันผ่าน npm)
+ * @example // app/sw.js/route.ts
+ * export const GET = pushServiceWorker();
+ * ไม่แนะนำให้ importScripts จากโดเมนอื่น: service worker คุมทั้ง origin ของแอปและดักทุก request
+ */
+declare function pushServiceWorker(options?: PushServiceWorkerOptions): () => Response;
+
+/** ช่องทางแชทที่ผู้ใช้ผูกเองได้ */
+type ChatLinkChannel = "telegram" | "line";
+/** ลิงก์ผูกที่ส่งให้ UI (`ChatLinkRow` ของ @suphark/ui/pwa) */
+interface ChatLink {
+    url: string;
+    code: string;
+    expiresAt: string;
+    /** ชื่อ bot/OA ให้ผู้ใช้ค้นเองเมื่อเปิดลิงก์ไม่ได้ (Telegram "@xxx_bot" · LINE "@xxx") */
+    botName?: string;
+    /** ข้อความที่ผู้ใช้พิมพ์เองได้ (Telegram `/start <code>` · LINE `ผูก Pi Notify <code>`) */
+    command: string;
+}
+interface ChatLinkHandlersOptions extends NotifyOptions {
+    /** ดึงผู้ใช้จาก session ของแอป (ฝั่ง server เท่านั้น) — คืน null/undefined = ยังไม่ล็อกอิน */
+    getUser: () => PushUser | null | undefined | Promise<PushUser | null | undefined>;
+}
+interface ChatLinkHandlers {
+    /** สถานะการผูกของผู้ใช้ที่ล็อกอินอยู่ — UI โพลทุก 3 วิหลังออกลิงก์ */
+    getStatus(channel: ChatLinkChannel): Promise<ChannelStatus>;
+    /** ออกลิงก์ผูก (หมดอายุ 10 นาที) */
+    createLink(channel: ChatLinkChannel): Promise<ChatLink>;
+    /**
+     * "ยกเลิกการผูก" = พักไว้ (ไม่ลบ) — การผูกใช้ร่วมทุกแอป จึงหยุดรับจากทุกแอป
+     * ผู้ใช้เปิดรับคืนได้ด้วยการกดผูกใหม่ หรือที่หน้า ช่องทางของฉัน ของ Pi Notify
+     */
+    unlink(channel: ChatLinkChannel): Promise<{
+        paused: number;
+    }>;
+}
+/**
+ * (0.11.0) ชุดฟังก์ชันสำหรับ Server Actions ของ `<ChatLinkRow />` (คู่ createPushHandlers) — แอปส่งแค่ `getUser`
+ * อีเมลมาจาก session ฝั่ง server เสมอ (ไม่รับจาก client) · ห่อเป็น `export async function` ทีละตัวในไฟล์ `"use server"`
+ *
+ * @example
+ *   const chat = createChatLinkHandlers({ getUser: async () => (await auth())?.user });
+ *   export async function chatStatus(c: "telegram" | "line") { return chat.getStatus(c); }
+ *   export async function chatCreateLink(c: "telegram" | "line") { return chat.createLink(c); }
+ *   export async function chatUnlink(c: "telegram" | "line") { return chat.unlink(c); }
+ */
+declare function createChatLinkHandlers(options: ChatLinkHandlersOptions): ChatLinkHandlers;
+
 interface ConsoleOptions {
     name?: string;
     from?: ParsedAddress;
@@ -330,59 +424,6 @@ declare function toPlainText(html: string): string;
 /** เวลาพัก (วินาที) ต่อ error แต่ละแบบ ก่อนกลับมาลอง provider นั้นอีก — คูณสองทุกครั้งที่พังซ้ำ */
 declare const DEFAULT_COOLDOWN: Record<ErrorKind, number>;
 
-/** ผู้ใช้ที่ล็อกอินอยู่ในแอป — **ต้องมาจาก session ฝั่ง server เท่านั้น** ห้ามรับอีเมลจาก client */
-interface PushUser {
-    email: string;
-    /** user id ใน Pi Auth (sub) — ให้ Pi Notify ลบ subscription ตามบัญชีที่ถูกลบ */
-    id?: string;
-}
-/** รูปที่ `PushSubscription.toJSON()` ของเบราว์เซอร์ส่งมา (field optional ตาม DOM type) */
-interface BrowserPushSubscription {
-    endpoint?: string;
-    keys?: Record<string, string | undefined>;
-}
-interface PushHandlersOptions extends NotifyOptions {
-    /** ดึงผู้ใช้จาก session ของแอป — คืน null/undefined = ยังไม่ล็อกอิน */
-    getUser: () => PushUser | null | undefined | Promise<PushUser | null | undefined>;
-}
-interface PushHandlers {
-    /** VAPID public key สำหรับ `pushManager.subscribe({ applicationServerKey })` */
-    getPublicKey(): Promise<string>;
-    subscribe(subscription: BrowserPushSubscription, opts?: {
-        label?: string;
-    }): Promise<{
-        ok: true;
-        created: boolean;
-    }>;
-    unsubscribe(endpoint: string): Promise<{
-        ok: true;
-        deleted: number;
-    }>;
-    listDevices(): Promise<{
-        devices: PushDevice[];
-    }>;
-}
-/**
- * ชุดฟังก์ชันสำหรับ Server Actions ของ `<WebPushRow />` — แอปส่งแค่ `getUser`
- * (ใน `"use server"` ห่อเป็น `export async function` ทีละตัว; ห้าม import SDK ใน Client Component)
- */
-declare function createPushHandlers(options: PushHandlersOptions): PushHandlers;
-interface PushServiceWorkerOptions {
-    /** ไอคอนของการแจ้งเตือน (path ในแอป) ค่าเริ่มต้น /icon-192.png */
-    icon?: string;
-    /** ลิงก์ที่เปิดเมื่อ payload ไม่มี link ค่าเริ่มต้น / */
-    defaultLink?: string;
-}
-/** ซอร์ส service worker ที่รับ push ของ Pi Notify (payload { title, body, link? }) — เปิดเฉพาะลิงก์ใน origin ของแอป */
-declare function pushServiceWorkerSource(options?: PushServiceWorkerOptions): string;
-/**
- * Route Handler ที่เสิร์ฟ service worker จากตัวแพ็กเกจเอง (same-origin, ล็อกเวอร์ชันผ่าน npm)
- * @example // app/sw.js/route.ts
- * export const GET = pushServiceWorker();
- * ไม่แนะนำให้ importScripts จากโดเมนอื่น: service worker คุมทั้ง origin ของแอปและดักทุก request
- */
-declare function pushServiceWorker(options?: PushServiceWorkerOptions): () => Response;
-
 interface NotifyEmailInput {
     title: string;
     body: string;
@@ -517,5 +558,5 @@ declare function previewTemplate(key: string, input?: {
     text: string;
 }>;
 
-export { Address, AllProvidersFailedError, Attempt, DEFAULT_COOLDOWN, DEFAULT_HUB_URL, ErrorKind, MailError, MailerEvent, Message, NotifyInput, NotifyOptions, NotifyResultItem, NotifyTopicInput, ParsedAddress, Provider, ProviderInfo, ProviderStatus, PushDevice, Quota, SMTP_PRESETS, SendResult, Store, TemplateVariable, classifyError, configureMailer, createConsoleProvider, createHubProvider, createMailer, createMemoryStore, createPresetSmtpProvider, createPushHandlers, createRedisStore, createResendProvider, createSmtpProvider, createZeptoMailProvider, deleteTemplate, formatAddress, getMailer, getTemplate, listProviders, listTemplates, looksLikeHtml, notifySafe, notifyTopicSafe, parseAddress, parseAddressList, previewTemplate, providersFromEnv, pushServiceWorker, pushServiceWorkerSource, renderNotifyEmail, requireFrom, resetMailer, resetSafeWarnings, resolveFormat, saveTemplate, sendMail, sendMailSafe, toPlainText };
-export type { BodyFormat, BrowserPushSubscription, ConsoleOptions, EmailTemplateInfo, EmailTemplateInput, Env, HubErrorResponse, HubOptions, HubSendRequest, HubSendResponse, Mailer, MailerOptions, NotifyEmailInput, NotifySafeResult, ProviderConfig, PushHandlers, PushHandlersOptions, PushServiceWorkerOptions, PushUser, RedisLike, ResendOptions, SendMailSafeResult, SmtpOptions, SmtpPreset, ZeptoMailOptions };
+export { Address, AllProvidersFailedError, Attempt, ChannelStatus, DEFAULT_COOLDOWN, DEFAULT_HUB_URL, ErrorKind, MailError, MailerEvent, Message, NotifyInput, NotifyOptions, NotifyResultItem, NotifyTopicInput, ParsedAddress, Provider, ProviderInfo, ProviderStatus, PushDevice, Quota, SMTP_PRESETS, SendResult, Store, TemplateVariable, classifyError, configureMailer, createChatLinkHandlers, createConsoleProvider, createHubProvider, createMailer, createMemoryStore, createPresetSmtpProvider, createPushHandlers, createRedisStore, createResendProvider, createSmtpProvider, createZeptoMailProvider, deleteTemplate, formatAddress, getMailer, getTemplate, listProviders, listTemplates, looksLikeHtml, notifySafe, notifyTopicSafe, parseAddress, parseAddressList, previewTemplate, providersFromEnv, pushServiceWorker, pushServiceWorkerSource, renderNotifyEmail, requireFrom, resetMailer, resetSafeWarnings, resolveFormat, saveTemplate, sendMail, sendMailSafe, toPlainText };
+export type { BodyFormat, BrowserPushSubscription, ChatLink, ChatLinkChannel, ChatLinkHandlers, ChatLinkHandlersOptions, ConsoleOptions, EmailTemplateInfo, EmailTemplateInput, Env, HubErrorResponse, HubOptions, HubSendRequest, HubSendResponse, Mailer, MailerOptions, NotifyEmailInput, NotifySafeResult, ProviderConfig, PushHandlers, PushHandlersOptions, PushServiceWorkerOptions, PushUser, RedisLike, ResendOptions, SendMailSafeResult, SmtpOptions, SmtpPreset, ZeptoMailOptions };

package/dist/index.js

@@ -5,6 +5,7 @@ import {
   MailError,
   NOTIFY_TIMEOUT_MS,
   SMTP_PRESETS,
+  absoluteLink,
   classifyError,
   configureMailer,
   createConsoleProvider,
@@ -33,6 +34,7 @@ import {
   notifyTopicSafe,
   parseAddress,
   parseAddressList,
+  pauseChannel,
   providersFromEnv,
   requireFrom,
   resetMailer,
@@ -41,7 +43,7 @@ import {
   sendMail,
   sendMailSafe,
   toEmails
-} from "./chunk-JN7P2CVF.js";
+} from "./chunk-SBQOHUW4.js";
 import {
   BUILTIN_TEMPLATE_KEYS,
   TemplateError,
@@ -51,7 +53,54 @@ import {
   renderEmailTemplate,
   resolveFormat,
   toPlainText
-} from "./chunk-NNMV7FZ3.js";
+} from "./chunk-WXINJXF4.js";
+
+// src/chat-link.ts
+var COMMAND = {
+  telegram: (code) => `/start ${code}`,
+  line: (code) => `\u0E1C\u0E39\u0E01 Pi Notify ${code}`
+};
+function assertChannel(channel) {
+  if (channel !== "telegram" && channel !== "line")
+    throw new MailError("chat link: channel \u0E23\u0E2D\u0E07\u0E23\u0E31\u0E1A\u0E40\u0E09\u0E1E\u0E32\u0E30 telegram, line", {
+      kind: "invalid",
+      provider: "hub"
+    });
+}
+function createChatLinkHandlers(options) {
+  const { getUser, ...opts } = options;
+  const requireUser = async () => {
+    const user = await getUser();
+    if (!user?.email)
+      throw new MailError("chat link: \u0E22\u0E31\u0E07\u0E44\u0E21\u0E48\u0E44\u0E14\u0E49\u0E25\u0E47\u0E2D\u0E01\u0E2D\u0E34\u0E19", { kind: "auth", status: 401, provider: "hub" });
+    return user;
+  };
+  return {
+    async getStatus(channel) {
+      assertChannel(channel);
+      return getChannelStatus((await requireUser()).email, channel, opts);
+    },
+    async createLink(channel) {
+      assertChannel(channel);
+      const user = await requireUser();
+      const link = await createLink(user.email, channel, {
+        ...opts,
+        ...user.id ? { piUserId: user.id } : {}
+      });
+      return {
+        url: link.url,
+        code: link.code,
+        expiresAt: link.expiresAt,
+        ...link.botName ? { botName: link.botName } : {},
+        command: COMMAND[channel](link.code)
+      };
+    },
+    async unlink(channel) {
+      assertChannel(channel);
+      return pauseChannel((await requireUser()).email, channel, opts);
+    }
+  };
+}
 
 // src/push.ts
 function createPushHandlers(options) {
@@ -237,9 +286,11 @@ export {
   NOTIFY_TIMEOUT_MS,
   SMTP_PRESETS,
   TemplateError,
+  absoluteLink,
   builtinFallback,
   classifyError,
   configureMailer,
+  createChatLinkHandlers,
   createConsoleProvider,
   createHubProvider,
   createLink,
@@ -272,6 +323,7 @@ export {
   notifyTopicSafe,
   parseAddress,
   parseAddressList,
+  pauseChannel,
   previewTemplate,
   providersFromEnv,
   pushServiceWorker,

package/dist/next.js

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

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

@@ -315,6 +315,11 @@ interface NotifyOptions {
      * ค่าเริ่มต้น notify() 65000 (ยาวกว่า maxDuration 60 วิของ /api/v1/notify เล็กน้อย) · getRecipient()/createLink() 10000
      */
     timeoutMs?: number;
+    /**
+     * (0.11.0) โดเมนของแอป ไว้เติมหน้าลิงก์แบบ relative ("/user/account") ใน notify/notifyTopic
+     * ค่าเริ่มต้น APP_URL หรือ NEXT_PUBLIC_APP_URL
+     */
+    appUrl?: string;
 }
 /** เวลารอเริ่มต้นของแต่ละคำสั่ง (ms) */
 declare const NOTIFY_TIMEOUT_MS: {
@@ -352,6 +357,11 @@ interface RecipientInfo {
 }
 /** มี PI_NOTIFY_KEY (ใน opts หรือ env) หรือไม่ — ให้ helper แบบ safe/later ใช้ตัดสินว่า "ปิดอยู่" */
 declare function hasNotifyKey(opts?: NotifyOptions): boolean;
+/**
+ * (0.11.0) ลิงก์ relative ("/memo/12") → URL เต็มจาก opts.appUrl / APP_URL / NEXT_PUBLIC_APP_URL
+ * (hub ต้องการ URL เต็ม เพราะลิงก์ถูกเปิดจาก Telegram/LINE/อีเมล ไม่ใช่จากในแอป) — ไม่มีโดเมน = MailError invalid
+ */
+declare function absoluteLink(link: string, opts?: NotifyOptions): string;
 /**
  * แจ้งเตือนผู้รับผ่าน Pi Notify hub — แชทที่ผู้รับผูกไว้ (Telegram / LINE / web push) หรืออีเมล
  * ใช้ env เดียวกับ sendMail(): PI_NOTIFY_KEY (+ PI_NOTIFY_URL)
@@ -370,8 +380,11 @@ interface RequestStatus {
     key: string;
     /** mail = sendMail, notify = notify()/notifyTopic() */
     type: "mail" | "notify";
-    /** processing = ยังตอบคำขอแรกไม่เสร็จ · queued = ยังมีรายการรอส่งซ้ำ · partial = สำเร็จบางรายการ */
-    status: "processing" | "queued" | "sent" | "failed" | "partial";
+    /**
+     * processing = ยังตอบคำขอแรกไม่เสร็จ · queued = ยังมีรายการรอส่งซ้ำ · partial = สำเร็จบางรายการ
+     * · skipped (0.10.2) = ไม่มีรายการไหนถูกส่ง (topic ไม่มีปลายทาง / ผู้รับไม่ได้ผูกช่องทาง)
+     */
+    status: "processing" | "queued" | "sent" | "failed" | "partial" | "skipped";
     /** รายการต่อผู้รับ/ช่องทาง — รายการที่เคย queued แสดงสถานะล่าสุดจริง (sent/failed/queued) */
     results: NotifyResultItem[];
     summary: {
@@ -407,10 +420,20 @@ declare function createLink(email: Recipient, channel?: Exclude<NotifyChannel, "
     url: string;
     code: string;
     expiresAt: string;
+    botName?: string;
+}>;
+/**
+ * (0.11.0) "ยกเลิกการผูก" จากหน้าตั้งค่าของแอป = พักไว้ (ไม่ลบ) — การผูก Telegram/LINE ใช้ร่วมทุกแอป
+ * จึงหยุดรับจากทุกแอป ผู้ใช้เปิดรับคืนได้ที่หน้า ช่องทางของฉัน หรือกดผูกใหม่ · คืนจำนวนที่พัก
+ */
+declare function pauseChannel(email: Recipient, channel: Exclude<NotifyChannel, "email" | "push">, opts?: NotifyOptions): Promise<{
+    paused: number;
 }>;
 /** สถานะการผูกช่องทางหนึ่งของผู้รับ — แทนการ find ใน `getRecipient().channels` เองในแต่ละแอป */
 interface ChannelStatus {
     linked: boolean;
+    /** (0.11.0) ผูกไว้แต่พักอยู่ (ผู้ใช้กดยกเลิก/พักไว้) — กดผูกใหม่ = เปิดรับคืน */
+    paused?: boolean;
     label: string | null;
     linkedAt: string | null;
     /** หน้า Pi Notify ที่ผู้รับจัดการช่องทางเอง */
@@ -446,5 +469,5 @@ declare function listPushDevices(email: string, opts?: NotifyOptions): Promise<{
     devices: PushDevice[];
 }>;
 
-export { getRequestStatus as B, hasNotifyKey as D, listPushDevices as F, notify as G, notifyTopic as H, savePushSubscription as I, toEmails as J, NOTIFY_TIMEOUT_MS as l, createLink as v, deletePushSubscription as w, getChannelStatus as x, getPushConfig as y, getRecipient as z };
-export type { Address as A, ChannelStatus as C, ErrorKind as E, Message as M, NotifyOptions as N, ParsedAddress as P, Quota as Q, Recipient as R, SendResult as S, Provider as a, ProviderStatus as b, ProviderInfo as c, Store as d, MailerEvent as e, Attempt as f, PushDevice as g, NotifyResultItem as h, NotifyInput as i, NotifyTopicInput as j, Attachment as k, NormalizedMessage as m, NotifyChannel as n, NotifyResult as o, PushSubscriptionJson as p, QuotaUsage as q, RecipientChannelInfo as r, RecipientInfo as s, RequestStatus as t, SkipReason as u };
+export { getRecipient as B, getRequestStatus as D, hasNotifyKey as F, listPushDevices as G, notify as H, notifyTopic as I, pauseChannel as J, savePushSubscription as K, toEmails as L, NOTIFY_TIMEOUT_MS as l, absoluteLink as v, createLink as w, deletePushSubscription as x, getChannelStatus as y, getPushConfig as z };
+export type { Address as A, ChannelStatus as C, ErrorKind as E, Message as M, NotifyOptions as N, ParsedAddress as P, Quota as Q, Recipient as R, SendResult as S, PushDevice as a, Provider as b, ProviderStatus as c, ProviderInfo as d, Store as e, MailerEvent as f, Attempt as g, NotifyResultItem as h, NotifyInput as i, NotifyTopicInput as j, Attachment as k, NormalizedMessage as m, NotifyChannel as n, NotifyResult as o, PushSubscriptionJson as p, QuotaUsage as q, RecipientChannelInfo as r, RecipientInfo as s, RequestStatus as t, SkipReason as u };

package/dist/template.d.ts

@@ -58,6 +58,11 @@ declare function renderTemplate(source: string, data: Data, opts: {
 declare function templateVariableNames(...sources: string[]): string[];
 /** ค่าตัวอย่างจากรายการตัวแปร (path a.b → ซ้อน object) */
 declare function sampleData(variables: TemplateVariable[] | null | undefined): Data;
+/**
+ * ข้อความล้วนจาก HTML ที่ render แล้ว — ตัด <head>/<style>/<script>/<title> ทั้งก้อนก่อน (เทมเพลต HTML เต็มฉบับ
+ * ไม่ให้ CSS หลุดเข้า text part) และขึ้นบรรทัดใหม่ตามบล็อก (p, div, li, h1–h6, tr) ให้อ่านได้
+ */
+declare function htmlToText(html: string): string;
 /** layout มาตรฐานเมื่อ HTML ไม่มี <html> ของตัวเอง — กว้าง 600px อ่านง่ายทุกโปรแกรมอีเมล */
 declare function wrapEmailLayout(body: string, opts?: {
     appName?: string;
@@ -92,5 +97,5 @@ declare function builtinFallback(key: string, data: Record<string, unknown> | un
     html: string;
 } | null;
 
-export { BUILTIN_TEMPLATES, BUILTIN_TEMPLATE_KEYS, TemplateError, builtinFallback, isBuiltinTemplate, parseTemplate, renderEmailTemplate, renderTemplate, sampleData, templateVariableNames, wrapEmailLayout };
+export { BUILTIN_TEMPLATES, BUILTIN_TEMPLATE_KEYS, TemplateError, builtinFallback, htmlToText, isBuiltinTemplate, parseTemplate, renderEmailTemplate, renderTemplate, sampleData, templateVariableNames, wrapEmailLayout };
 export type { BuiltinTemplateKey, EmailTemplateSource, TemplateVariable };

package/dist/template.js

@@ -3,6 +3,7 @@ import {
   BUILTIN_TEMPLATE_KEYS,
   TemplateError,
   builtinFallback,
+  htmlToText,
   isBuiltinTemplate,
   parseTemplate,
   renderEmailTemplate,
@@ -10,12 +11,13 @@ import {
   sampleData,
   templateVariableNames,
   wrapEmailLayout
-} from "./chunk-NNMV7FZ3.js";
+} from "./chunk-WXINJXF4.js";
 export {
   BUILTIN_TEMPLATES,
   BUILTIN_TEMPLATE_KEYS,
   TemplateError,
   builtinFallback,
+  htmlToText,
   isBuiltinTemplate,
   parseTemplate,
   renderEmailTemplate,

package/package.json

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