meodp 0.0.9 → 0.2.0

package/dist/notify/feishu.d.cts

@@ -0,0 +1,74 @@
+import { LinkNotification } from './index.cjs';
+import '../shared/meodp.93e06e00.cjs';
+
+interface FeishuOptions {
+    transport?: string;
+    appId?: string;
+    appSecret?: string;
+    receiveId?: string;
+    receiveIdType?: string;
+    webhook?: string;
+    keyword?: string;
+    secret?: string;
+    timestamp?: number;
+    reportUrl?: string;
+    runUrl?: string;
+    reportLabel?: string;
+    timeZone?: string;
+    maxItems?: number;
+}
+type FeishuFetch = (url: string, init: RequestInit) => Promise<Response>;
+interface PlainText {
+    tag: 'plain_text';
+    content: string;
+}
+interface CardButton {
+    tag: 'button';
+    text: PlainText;
+    type: 'default' | 'primary';
+    url: string;
+}
+type CardElement = {
+    tag: 'div';
+    text: PlainText;
+} | {
+    tag: 'div';
+    fields: {
+        is_short: boolean;
+        text: PlainText;
+    }[];
+} | {
+    tag: 'note';
+    elements: PlainText[];
+} | {
+    tag: 'hr';
+} | {
+    tag: 'markdown';
+    content: string;
+} | {
+    tag: 'action';
+    actions: CardButton[];
+};
+declare function signFeishu(timestamp: string | number, secret: string): string;
+declare function createFeishuCard(message: LinkNotification, { keyword, reportUrl, runUrl, reportLabel, timeZone, maxItems }?: FeishuOptions): {
+    config: {
+        wide_screen_mode: boolean;
+        enable_forward: boolean;
+    };
+    header: {
+        template: string;
+        title: PlainText;
+    };
+    elements: CardElement[];
+};
+declare function createFeishuPayload(message: LinkNotification, options?: FeishuOptions): {
+    msg_type: "interactive";
+    card: ReturnType<typeof createFeishuCard>;
+    timestamp?: string;
+    sign?: string;
+};
+declare function sendFeishuNotification(message: LinkNotification, options: FeishuOptions, fetcher?: FeishuFetch): Promise<{
+    messageId: string;
+} | undefined>;
+
+export { type FeishuFetch, type FeishuOptions, createFeishuCard, createFeishuPayload, sendFeishuNotification, signFeishu };

package/dist/notify/feishu.d.mts

@@ -0,0 +1,74 @@
+import { LinkNotification } from './index.mjs';
+import '../shared/meodp.93e06e00.mjs';
+
+interface FeishuOptions {
+    transport?: string;
+    appId?: string;
+    appSecret?: string;
+    receiveId?: string;
+    receiveIdType?: string;
+    webhook?: string;
+    keyword?: string;
+    secret?: string;
+    timestamp?: number;
+    reportUrl?: string;
+    runUrl?: string;
+    reportLabel?: string;
+    timeZone?: string;
+    maxItems?: number;
+}
+type FeishuFetch = (url: string, init: RequestInit) => Promise<Response>;
+interface PlainText {
+    tag: 'plain_text';
+    content: string;
+}
+interface CardButton {
+    tag: 'button';
+    text: PlainText;
+    type: 'default' | 'primary';
+    url: string;
+}
+type CardElement = {
+    tag: 'div';
+    text: PlainText;
+} | {
+    tag: 'div';
+    fields: {
+        is_short: boolean;
+        text: PlainText;
+    }[];
+} | {
+    tag: 'note';
+    elements: PlainText[];
+} | {
+    tag: 'hr';
+} | {
+    tag: 'markdown';
+    content: string;
+} | {
+    tag: 'action';
+    actions: CardButton[];
+};
+declare function signFeishu(timestamp: string | number, secret: string): string;
+declare function createFeishuCard(message: LinkNotification, { keyword, reportUrl, runUrl, reportLabel, timeZone, maxItems }?: FeishuOptions): {
+    config: {
+        wide_screen_mode: boolean;
+        enable_forward: boolean;
+    };
+    header: {
+        template: string;
+        title: PlainText;
+    };
+    elements: CardElement[];
+};
+declare function createFeishuPayload(message: LinkNotification, options?: FeishuOptions): {
+    msg_type: "interactive";
+    card: ReturnType<typeof createFeishuCard>;
+    timestamp?: string;
+    sign?: string;
+};
+declare function sendFeishuNotification(message: LinkNotification, options: FeishuOptions, fetcher?: FeishuFetch): Promise<{
+    messageId: string;
+} | undefined>;
+
+export { type FeishuFetch, type FeishuOptions, createFeishuCard, createFeishuPayload, sendFeishuNotification, signFeishu };

package/dist/notify/feishu.d.ts

@@ -0,0 +1,74 @@
+import { LinkNotification } from './index.js';
+import '../shared/meodp.93e06e00.js';
+
+interface FeishuOptions {
+    transport?: string;
+    appId?: string;
+    appSecret?: string;
+    receiveId?: string;
+    receiveIdType?: string;
+    webhook?: string;
+    keyword?: string;
+    secret?: string;
+    timestamp?: number;
+    reportUrl?: string;
+    runUrl?: string;
+    reportLabel?: string;
+    timeZone?: string;
+    maxItems?: number;
+}
+type FeishuFetch = (url: string, init: RequestInit) => Promise<Response>;
+interface PlainText {
+    tag: 'plain_text';
+    content: string;
+}
+interface CardButton {
+    tag: 'button';
+    text: PlainText;
+    type: 'default' | 'primary';
+    url: string;
+}
+type CardElement = {
+    tag: 'div';
+    text: PlainText;
+} | {
+    tag: 'div';
+    fields: {
+        is_short: boolean;
+        text: PlainText;
+    }[];
+} | {
+    tag: 'note';
+    elements: PlainText[];
+} | {
+    tag: 'hr';
+} | {
+    tag: 'markdown';
+    content: string;
+} | {
+    tag: 'action';
+    actions: CardButton[];
+};
+declare function signFeishu(timestamp: string | number, secret: string): string;
+declare function createFeishuCard(message: LinkNotification, { keyword, reportUrl, runUrl, reportLabel, timeZone, maxItems }?: FeishuOptions): {
+    config: {
+        wide_screen_mode: boolean;
+        enable_forward: boolean;
+    };
+    header: {
+        template: string;
+        title: PlainText;
+    };
+    elements: CardElement[];
+};
+declare function createFeishuPayload(message: LinkNotification, options?: FeishuOptions): {
+    msg_type: "interactive";
+    card: ReturnType<typeof createFeishuCard>;
+    timestamp?: string;
+    sign?: string;
+};
+declare function sendFeishuNotification(message: LinkNotification, options: FeishuOptions, fetcher?: FeishuFetch): Promise<{
+    messageId: string;
+} | undefined>;
+
+export { type FeishuFetch, type FeishuOptions, createFeishuCard, createFeishuPayload, sendFeishuNotification, signFeishu };

package/dist/notify/feishu.mjs

@@ -0,0 +1,157 @@
+import { createHmac, createHash } from 'node:crypto';
+
+function truncate(text, limit) {
+  const characters = Array.from(String(text));
+  return characters.length > limit ? `${characters.slice(0, limit).join("")}
+\u2026\u5B8C\u6574\u5185\u5BB9\u8BF7\u67E5\u770B\u62A5\u544A\u3002` : characters.join("");
+}
+function safeLink(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    throw new Error("Notification links must use HTTP(S) without credentials.");
+  }
+  if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password)
+    throw new Error("Notification links must use HTTP(S) without credentials.");
+  return parsed.href;
+}
+function signFeishu(timestamp, secret) {
+  return createHmac("sha256", `${timestamp}
+${secret}`).digest("base64");
+}
+function createFeishuCard(message, { keyword = "", reportUrl, runUrl, reportLabel = "\u67E5\u770B\u5B8C\u6574\u62A5\u544A", timeZone = "UTC", maxItems = 6 } = {}) {
+  if (!Number.isSafeInteger(maxItems) || maxItems < 1 || maxItems > 6)
+    throw new Error("maxItems must be between 1 and 6.");
+  const text = (content) => ({ tag: "plain_text", content });
+  const elements = [];
+  if (message.test)
+    elements.push({ tag: "div", text: text(message.text) });
+  if (message.report) {
+    const { total, reachable, restricted, unavailable } = message.report.summary;
+    elements.push({
+      tag: "div",
+      fields: [["\u{1F310} \u68C0\u6D4B\u7AD9\u70B9", total], ["\u2705 \u53EF\u8BBF\u95EE", reachable], ["\u{1F7E0} \u8BBF\u95EE\u53D7\u9650", restricted], ["\u{1F534} \u672C\u6B21\u4E0D\u53EF\u8BBF\u95EE", unavailable]].map(([label, value]) => ({ is_short: true, text: text(`${label}
+${value}`) }))
+    });
+    const date = new Date(message.report.completedAt);
+    const time = Number.isNaN(date.valueOf()) ? message.report.completedAt : new Intl.DateTimeFormat("zh-CN", {
+      timeZone,
+      dateStyle: "medium",
+      timeStyle: "short",
+      hour12: false
+    }).format(date);
+    elements.push({ tag: "note", elements: [text(`${message.test ? "\u793A\u4F8B\u5FEB\u7167" : "\u68C0\u6D4B\u5B8C\u6210"}\uFF1A${time}\uFF08${timeZone}\uFF09
+\u68C0\u6D4B\u73AF\u5883\uFF1A${truncate(message.report.observer, 80)}`)] });
+    if (message.entries?.length) {
+      elements.push({ tag: "hr" }, { tag: "markdown", content: "**\u72B6\u6001\u6458\u8981**" });
+      for (const { item, reason } of message.entries.slice(0, maxItems)) {
+        elements.push({ tag: "div", text: text(`${reason} \xB7 ${truncate(item.name || item.url, 60)}
+${truncate(item.url, 160)}
+HTTP / \u539F\u56E0\uFF1A${truncate(item.httpStatus ?? item.reason ?? "\u2014", 80)} \xB7 \u8FDE\u7EED\u5931\u8D25 ${item.consecutiveFailures} \u6B21`) });
+      }
+      if (message.entries.length > maxItems)
+        elements.push({ tag: "note", elements: [text(`\u53E6\u6709 ${message.entries.length - maxItems} \u9879\uFF0C\u70B9\u51FB\u4E0B\u65B9\u67E5\u770B\u5B8C\u6574\u62A5\u544A\u3002`)] });
+    } else {
+      elements.push({ tag: "div", text: text("\u672C\u6B21\u6CA1\u6709\u9700\u8981\u5173\u6CE8\u7684\u72B6\u6001\u53D8\u5316\u3002") });
+    }
+  } else if (!message.test) {
+    elements.push({ tag: "div", text: text(truncate(message.text, 2500)) });
+  }
+  const actions = [];
+  for (const [label, url] of [[reportLabel, reportUrl], ["\u67E5\u770B\u672C\u6B21\u8FD0\u884C", runUrl]]) {
+    if (url)
+      actions.push({ tag: "button", text: text(label), type: actions.length ? "default" : "primary", url: safeLink(url) });
+  }
+  if (actions.length)
+    elements.push({ tag: "action", actions });
+  elements.push({ tag: "note", elements: [text("\u8BBF\u95EE\u53D7\u9650\u4E0D\u7B49\u4E8E\u5931\u6548\uFF1B\u8FDE\u7EED\u5931\u8D25\u6B21\u6570\u4E0D\u4EE3\u8868\u671F\u95F4\u6301\u7EED\u5B95\u673A\u3002")] });
+  const template = message.test ? "blue" : message.report?.summary?.unavailable ? "orange" : message.report?.summary?.restricted ? "yellow" : "green";
+  return {
+    config: { wide_screen_mode: true, enable_forward: false },
+    header: { template, title: text(`${keyword ? `${truncate(keyword, 64)} \xB7 ` : ""}${truncate(message.subject, 100)}`) },
+    elements
+  };
+}
+function createFeishuPayload(message, options = {}) {
+  const payload = { msg_type: "interactive", card: createFeishuCard(message, options) };
+  if (options.secret) {
+    payload.timestamp = String(options.timestamp ?? Math.floor(Date.now() / 1e3));
+    payload.sign = signFeishu(payload.timestamp, options.secret);
+  }
+  return payload;
+}
+async function requestFeishu(url, init, fetcher, phase) {
+  let response;
+  try {
+    response = await fetcher(url, { ...init, redirect: "error", signal: AbortSignal.timeout(15e3) });
+  } catch {
+    throw new Error(`Feishu ${phase} request failed or timed out; check delivery before retrying.`);
+  }
+  if (!response.ok)
+    throw new Error(`Feishu ${phase} returned HTTP ${response.status}.`);
+  let result;
+  try {
+    result = await response.json();
+  } catch {
+    throw new Error(`Feishu ${phase} returned an invalid response; check delivery before retrying.`);
+  }
+  if (!result || typeof result !== "object")
+    throw new Error(`Feishu ${phase} returned an invalid response; check delivery before retrying.`);
+  const code = ("code" in result ? result.code : void 0) ?? ("StatusCode" in result ? result.StatusCode : void 0);
+  if (code !== 0)
+    throw new Error(`Feishu ${phase} rejected the request (code ${Number.isInteger(code) ? code : "unknown"}). Check the bot configuration and permissions.`);
+  return result;
+}
+async function sendFeishuNotification(message, options, fetcher = fetch) {
+  const transport = options.transport || "webhook";
+  if (!["app", "webhook"].includes(transport))
+    throw new Error("feishu.transport must be app or webhook.");
+  if (transport === "app") {
+    for (const [name, value] of [["feishu.appId", options.appId], ["feishu.appSecret", options.appSecret], ["feishu.receiveId", options.receiveId]]) {
+      if (!value?.trim())
+        throw new Error(`Configure ${name} in the notification configuration.`);
+    }
+    const receiveIdType = options.receiveIdType || "open_id";
+    if (!["open_id", "user_id", "union_id", "email"].includes(receiveIdType))
+      throw new Error("feishu.receiveIdType must be open_id, user_id, union_id, or email for direct messages.");
+    const card = createFeishuCard(message, options);
+    const auth = await requestFeishu("https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ app_id: options.appId, app_secret: options.appSecret })
+    }, fetcher, "authentication");
+    if (!("tenant_access_token" in auth) || typeof auth.tenant_access_token !== "string" || !auth.tenant_access_token)
+      throw new Error("Feishu authentication returned no tenant access token.");
+    const content = JSON.stringify(card);
+    const uuid = createHash("sha256").update(`${options.appId}
+${receiveIdType}
+${options.receiveId}
+${content}`).digest("hex").slice(0, 40);
+    const result = await requestFeishu(`https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=${receiveIdType}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "Authorization": `Bearer ${auth.tenant_access_token}` },
+      body: JSON.stringify({ receive_id: options.receiveId, msg_type: "interactive", content, uuid })
+    }, fetcher, "direct message");
+    if (!("data" in result) || !result.data || typeof result.data !== "object" || !("message_id" in result.data) || typeof result.data.message_id !== "string" || !result.data.message_id) {
+      throw new Error("Feishu returned no message ID; check delivery before retrying.");
+    }
+    return { messageId: result.data.message_id };
+  }
+  let webhook;
+  try {
+    webhook = new URL(options.webhook || "");
+  } catch {
+    throw new Error("Configure feishu.webhook in the notification configuration.");
+  }
+  if (webhook.protocol !== "https:" || !["open.feishu.cn", "open.larksuite.com"].includes(webhook.hostname) || !/^\/open-apis\/bot\/v2\/hook\/[a-z0-9-]+$/i.test(webhook.pathname) || webhook.username || webhook.password || webhook.search || webhook.hash || webhook.port) {
+    throw new Error("feishu.webhook must be an official Feishu/Lark custom bot webhook.");
+  }
+  await requestFeishu(webhook.href, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(createFeishuPayload(message, options))
+  }, fetcher, "webhook");
+}
+
+export { createFeishuCard, createFeishuPayload, sendFeishuNotification, signFeishu };

package/dist/notify/index.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+const labels = { reachable: "\u53EF\u8BBF\u95EE", restricted: "\u8BBF\u95EE\u53D7\u9650", unavailable: "\u672C\u6B21\u4E0D\u53EF\u8BBF\u95EE" };
+const singleLine = (value) => String(value).replace(/[\r\n]+/g, " ");
+function createNotification(report, options = {}) {
+  const { previousReport: previous, mode = "changes", failureThreshold = 2, observerMismatch = "error", title = "MEODP", reportUrl, runUrl } = options;
+  if (mode === "off")
+    return void 0;
+  if (!Number.isSafeInteger(failureThreshold) || failureThreshold < 1)
+    throw new Error("failureThreshold must be a positive integer.");
+  if (previous && previous.observer !== report.observer && observerMismatch !== "reset")
+    throw new Error("Previous report belongs to another observer; choose observerMismatch: reset to start a new baseline.");
+  if (!["changes", "weekly"].includes(mode))
+    throw new Error("Notification mode must be off, changes, or weekly.");
+  if (!["error", "reset"].includes(observerMismatch))
+    throw new Error("observerMismatch must be error or reset.");
+  const oldResults = new Map((previous?.observer === report.observer ? previous.results : []).map((item) => [item.url, item]));
+  const changes = [];
+  for (const item of report.results) {
+    const old = oldResults.get(item.url);
+    let kind;
+    if (item.status === "unavailable" && old?.status !== "unavailable")
+      kind = "unavailable";
+    else if (item.status === "unavailable" && item.consecutiveFailures >= failureThreshold && old && old.consecutiveFailures < failureThreshold)
+      kind = "failure-threshold";
+    else if (item.status === "restricted" && old?.status !== "restricted")
+      kind = "restricted";
+    else if (item.status === "reachable" && old?.status === "unavailable")
+      kind = "recovered";
+    else if (item.status === "reachable" && old?.status === "restricted")
+      kind = "restriction-lifted";
+    if (kind) {
+      const reasons = { "unavailable": "\u65B0\u589E\u4E0D\u53EF\u8BBF\u95EE", "restricted": "\u65B0\u589E\u8BBF\u95EE\u9650\u5236", "failure-threshold": `\u8FDE\u7EED ${failureThreshold} \u6B21\u68C0\u6D4B\u5931\u8D25`, "recovered": "\u6062\u590D\u8BBF\u95EE", "restriction-lifted": "\u8BBF\u95EE\u9650\u5236\u89E3\u9664" };
+      changes.push({ item, kind, reason: reasons[kind] });
+    }
+  }
+  if (mode === "changes" && !changes.length)
+    return void 0;
+  const { total, reachable, restricted, unavailable } = report.summary;
+  const entries = mode === "changes" ? changes : report.results.filter((item) => item.status !== "reachable").map((item) => ({ item, kind: item.status === "restricted" ? "restricted" : "unavailable", reason: labels[item.status] }));
+  const lines = [
+    `\u68C0\u6D4B\u65F6\u95F4\uFF1A${report.completedAt}`,
+    `\u68C0\u6D4B\u73AF\u5883\uFF1A${singleLine(report.observer)}`,
+    `\u5171 ${total} \u4E2A\u7AD9\u70B9\uFF1A${reachable} \u53EF\u8BBF\u95EE\uFF0C${restricted} \u8BBF\u95EE\u53D7\u9650\uFF0C${unavailable} \u672C\u6B21\u4E0D\u53EF\u8BBF\u95EE\u3002`,
+    "",
+    ...entries.map(({ item, reason }) => `- ${reason}\uFF1A${singleLine(item.name || item.url)}
+  ${item.url}
+  HTTP / \u539F\u56E0\uFF1A${item.httpStatus ?? item.reason ?? "\u2014"}\uFF1B\u8FDE\u7EED\u5931\u8D25 ${item.consecutiveFailures} \u6B21`)
+  ];
+  if (mode === "weekly") {
+    const recovered = changes.filter(({ kind }) => kind === "recovered" || kind === "restriction-lifted");
+    lines.push(...recovered.map(({ item, reason }) => `- ${reason}\uFF1A${singleLine(item.name || item.url)} ${item.url}`));
+    entries.push(...recovered);
+  }
+  lines.push("", ...reportUrl ? [`\u72B6\u6001\u9875\uFF1A${reportUrl}`] : [], ...runUrl ? [`\u672C\u6B21\u8FD0\u884C\u4E0E\u62A5\u544A\u9644\u4EF6\uFF1A${runUrl}`] : [], "", "\u8BBF\u95EE\u53D7\u9650\u4E0D\u7B49\u4E8E\u5931\u6548\uFF1B\u8FDE\u7EED\u5931\u8D25\u6B21\u6570\u662F\u72EC\u7ACB\u89C2\u6D4B\uFF0C\u4E0D\u4EE3\u8868\u671F\u95F4\u6301\u7EED\u5B95\u673A\u3002");
+  return {
+    subject: mode === "weekly" ? `[${singleLine(title)}] \u6BCF\u5468\u94FE\u63A5\u68C0\u6D4B\u6458\u8981` : `[${singleLine(title)}] ${changes.length} \u9879\u94FE\u63A5\u72B6\u6001\u53D8\u5316`,
+    text: lines.join("\n"),
+    report,
+    entries
+  };
+}
+
+exports.createNotification = createNotification;

package/dist/notify/index.d.cts

@@ -0,0 +1,27 @@
+import { b as LinkObservation, C as CheckReport } from '../shared/meodp.93e06e00.cjs';
+
+type NotificationKind = 'unavailable' | 'restricted' | 'failure-threshold' | 'recovered' | 'restriction-lifted';
+interface NotificationEntry {
+    kind: NotificationKind;
+    item: LinkObservation;
+    reason: string;
+}
+interface LinkNotification {
+    subject: string;
+    text: string;
+    test?: boolean;
+    report?: Pick<CheckReport, 'summary' | 'completedAt' | 'observer'>;
+    entries?: NotificationEntry[];
+}
+interface NotificationOptions {
+    previousReport?: CheckReport;
+    mode?: 'off' | 'changes' | 'weekly';
+    failureThreshold?: number;
+    observerMismatch?: 'error' | 'reset';
+    title?: string;
+    reportUrl?: string;
+    runUrl?: string;
+}
+declare function createNotification(report: CheckReport, options?: NotificationOptions): LinkNotification | undefined;
+
+export { type LinkNotification, type NotificationEntry, type NotificationKind, type NotificationOptions, createNotification };

package/dist/notify/index.d.mts

@@ -0,0 +1,27 @@
+import { b as LinkObservation, C as CheckReport } from '../shared/meodp.93e06e00.mjs';
+
+type NotificationKind = 'unavailable' | 'restricted' | 'failure-threshold' | 'recovered' | 'restriction-lifted';
+interface NotificationEntry {
+    kind: NotificationKind;
+    item: LinkObservation;
+    reason: string;
+}
+interface LinkNotification {
+    subject: string;
+    text: string;
+    test?: boolean;
+    report?: Pick<CheckReport, 'summary' | 'completedAt' | 'observer'>;
+    entries?: NotificationEntry[];
+}
+interface NotificationOptions {
+    previousReport?: CheckReport;
+    mode?: 'off' | 'changes' | 'weekly';
+    failureThreshold?: number;
+    observerMismatch?: 'error' | 'reset';
+    title?: string;
+    reportUrl?: string;
+    runUrl?: string;
+}
+declare function createNotification(report: CheckReport, options?: NotificationOptions): LinkNotification | undefined;
+
+export { type LinkNotification, type NotificationEntry, type NotificationKind, type NotificationOptions, createNotification };

package/dist/notify/index.d.ts

@@ -0,0 +1,27 @@
+import { b as LinkObservation, C as CheckReport } from '../shared/meodp.93e06e00.js';
+
+type NotificationKind = 'unavailable' | 'restricted' | 'failure-threshold' | 'recovered' | 'restriction-lifted';
+interface NotificationEntry {
+    kind: NotificationKind;
+    item: LinkObservation;
+    reason: string;
+}
+interface LinkNotification {
+    subject: string;
+    text: string;
+    test?: boolean;
+    report?: Pick<CheckReport, 'summary' | 'completedAt' | 'observer'>;
+    entries?: NotificationEntry[];
+}
+interface NotificationOptions {
+    previousReport?: CheckReport;
+    mode?: 'off' | 'changes' | 'weekly';
+    failureThreshold?: number;
+    observerMismatch?: 'error' | 'reset';
+    title?: string;
+    reportUrl?: string;
+    runUrl?: string;
+}
+declare function createNotification(report: CheckReport, options?: NotificationOptions): LinkNotification | undefined;
+
+export { type LinkNotification, type NotificationEntry, type NotificationKind, type NotificationOptions, createNotification };

package/dist/notify/index.mjs

@@ -0,0 +1,62 @@
+const labels = { reachable: "\u53EF\u8BBF\u95EE", restricted: "\u8BBF\u95EE\u53D7\u9650", unavailable: "\u672C\u6B21\u4E0D\u53EF\u8BBF\u95EE" };
+const singleLine = (value) => String(value).replace(/[\r\n]+/g, " ");
+function createNotification(report, options = {}) {
+  const { previousReport: previous, mode = "changes", failureThreshold = 2, observerMismatch = "error", title = "MEODP", reportUrl, runUrl } = options;
+  if (mode === "off")
+    return void 0;
+  if (!Number.isSafeInteger(failureThreshold) || failureThreshold < 1)
+    throw new Error("failureThreshold must be a positive integer.");
+  if (previous && previous.observer !== report.observer && observerMismatch !== "reset")
+    throw new Error("Previous report belongs to another observer; choose observerMismatch: reset to start a new baseline.");
+  if (!["changes", "weekly"].includes(mode))
+    throw new Error("Notification mode must be off, changes, or weekly.");
+  if (!["error", "reset"].includes(observerMismatch))
+    throw new Error("observerMismatch must be error or reset.");
+  const oldResults = new Map((previous?.observer === report.observer ? previous.results : []).map((item) => [item.url, item]));
+  const changes = [];
+  for (const item of report.results) {
+    const old = oldResults.get(item.url);
+    let kind;
+    if (item.status === "unavailable" && old?.status !== "unavailable")
+      kind = "unavailable";
+    else if (item.status === "unavailable" && item.consecutiveFailures >= failureThreshold && old && old.consecutiveFailures < failureThreshold)
+      kind = "failure-threshold";
+    else if (item.status === "restricted" && old?.status !== "restricted")
+      kind = "restricted";
+    else if (item.status === "reachable" && old?.status === "unavailable")
+      kind = "recovered";
+    else if (item.status === "reachable" && old?.status === "restricted")
+      kind = "restriction-lifted";
+    if (kind) {
+      const reasons = { "unavailable": "\u65B0\u589E\u4E0D\u53EF\u8BBF\u95EE", "restricted": "\u65B0\u589E\u8BBF\u95EE\u9650\u5236", "failure-threshold": `\u8FDE\u7EED ${failureThreshold} \u6B21\u68C0\u6D4B\u5931\u8D25`, "recovered": "\u6062\u590D\u8BBF\u95EE", "restriction-lifted": "\u8BBF\u95EE\u9650\u5236\u89E3\u9664" };
+      changes.push({ item, kind, reason: reasons[kind] });
+    }
+  }
+  if (mode === "changes" && !changes.length)
+    return void 0;
+  const { total, reachable, restricted, unavailable } = report.summary;
+  const entries = mode === "changes" ? changes : report.results.filter((item) => item.status !== "reachable").map((item) => ({ item, kind: item.status === "restricted" ? "restricted" : "unavailable", reason: labels[item.status] }));
+  const lines = [
+    `\u68C0\u6D4B\u65F6\u95F4\uFF1A${report.completedAt}`,
+    `\u68C0\u6D4B\u73AF\u5883\uFF1A${singleLine(report.observer)}`,
+    `\u5171 ${total} \u4E2A\u7AD9\u70B9\uFF1A${reachable} \u53EF\u8BBF\u95EE\uFF0C${restricted} \u8BBF\u95EE\u53D7\u9650\uFF0C${unavailable} \u672C\u6B21\u4E0D\u53EF\u8BBF\u95EE\u3002`,
+    "",
+    ...entries.map(({ item, reason }) => `- ${reason}\uFF1A${singleLine(item.name || item.url)}
+  ${item.url}
+  HTTP / \u539F\u56E0\uFF1A${item.httpStatus ?? item.reason ?? "\u2014"}\uFF1B\u8FDE\u7EED\u5931\u8D25 ${item.consecutiveFailures} \u6B21`)
+  ];
+  if (mode === "weekly") {
+    const recovered = changes.filter(({ kind }) => kind === "recovered" || kind === "restriction-lifted");
+    lines.push(...recovered.map(({ item, reason }) => `- ${reason}\uFF1A${singleLine(item.name || item.url)} ${item.url}`));
+    entries.push(...recovered);
+  }
+  lines.push("", ...reportUrl ? [`\u72B6\u6001\u9875\uFF1A${reportUrl}`] : [], ...runUrl ? [`\u672C\u6B21\u8FD0\u884C\u4E0E\u62A5\u544A\u9644\u4EF6\uFF1A${runUrl}`] : [], "", "\u8BBF\u95EE\u53D7\u9650\u4E0D\u7B49\u4E8E\u5931\u6548\uFF1B\u8FDE\u7EED\u5931\u8D25\u6B21\u6570\u662F\u72EC\u7ACB\u89C2\u6D4B\uFF0C\u4E0D\u4EE3\u8868\u671F\u95F4\u6301\u7EED\u5B95\u673A\u3002");
+  return {
+    subject: mode === "weekly" ? `[${singleLine(title)}] \u6BCF\u5468\u94FE\u63A5\u68C0\u6D4B\u6458\u8981` : `[${singleLine(title)}] ${changes.length} \u9879\u94FE\u63A5\u72B6\u6001\u53D8\u5316`,
+    text: lines.join("\n"),
+    report,
+    entries
+  };
+}
+
+export { createNotification };