@dxv-systems/helpdesk 0.0.0-stage → 0.2.0

package/dist/noise.d.ts

@@ -0,0 +1,17 @@
+import type { InternetMessageHeader, NoiseReason } from "./types";
+export interface NoiseInput {
+    from: string;
+    subject?: string;
+    headers?: InternetMessageHeader[] | Record<string, string | undefined>;
+    replyTo?: string[];
+    ownAddresses: string[];
+    connectedMailboxes: string[];
+}
+export type NoiseVerdict = {
+    action: "ignore" | "process";
+    reason: NoiseReason;
+    detail?: string;
+    customerAddress?: string;
+    suppressAutoResponse?: boolean;
+};
+export declare function classifyNoise(input: NoiseInput): NoiseVerdict;

package/dist/noise.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyNoise = classifyNoise;
+const MACHINE_LOCAL = /^(?:no[-_.]?reply|do[-_.]?not[-_.]?reply|mailer-daemon|postmaster|bounces?)(?:[+._-].*)?$/i;
+const EXCHANGE_SYSTEM_LOCAL = /^microsoftexchange[0-9a-f]{32}$/i;
+const OOO_SUBJECT = /^\s*(?:automatic reply|automatisch antwoord|auto[- ]?reply|autoreply|out of office|afwezigheidsmelding|abwesenheitsnotiz)\b/i;
+function headerMap(headers) {
+    const map = new Map();
+    if (!headers)
+        return map;
+    const entries = Array.isArray(headers)
+        ? headers.map((h) => [h.name, h.value])
+        : Object.entries(headers);
+    for (const [name, value] of entries) {
+        if (value === undefined || value === null)
+            continue;
+        const key = name.trim().toLowerCase();
+        map.set(key, map.has(key) ? `${map.get(key)}, ${String(value)}` : String(value));
+    }
+    return map;
+}
+function keyword(value) {
+    return (value ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
+}
+function realReplyTo(input, from) {
+    const own = [...input.ownAddresses, ...input.connectedMailboxes].map((a) => a.trim().toLowerCase());
+    for (const raw of input.replyTo ?? []) {
+        const a = raw.trim().toLowerCase();
+        const local = a.split("@")[0] ?? "";
+        if (a.includes("@") && a !== from && !own.includes(a) && !MACHINE_LOCAL.test(local))
+            return a;
+    }
+    return null;
+}
+function classifyNoise(input) {
+    const from = input.from.trim().toLowerCase();
+    const h = headerMap(input.headers);
+    const ignore = (reason, detail) => ({
+        action: "ignore",
+        reason,
+        ...(detail ? { detail } : {}),
+    });
+    if (input.ownAddresses.some((a) => a.trim().toLowerCase() === from))
+        return ignore("own_address");
+    if (input.connectedMailboxes.some((a) => a.trim().toLowerCase() === from)) {
+        return ignore("connected_mailbox");
+    }
+    const local = from.split("@")[0] ?? "";
+    const contentType = (h.get("content-type") ?? "").toLowerCase();
+    const isNdrReport = contentType.includes("report-type=delivery-status") || contentType.includes("delivery-status");
+    if (isNdrReport || h.has("x-ms-exchange-message-is-ndr"))
+        return ignore("bounce", "ndr");
+    if (/^(?:mailer-daemon|postmaster)$/i.test(local))
+        return ignore("bounce", local);
+    if (EXCHANGE_SYSTEM_LOCAL.test(local))
+        return ignore("bounce", "exchange");
+    const auto = keyword(h.get("auto-submitted"));
+    if (auto && auto !== "no")
+        return ignore("auto_submitted", auto);
+    const precedence = keyword(h.get("precedence"));
+    if (["bulk", "junk", "list", "auto_reply"].includes(precedence))
+        return ignore("precedence", precedence);
+    if (h.has("x-autoreply") || h.has("x-autorespond") || OOO_SUBJECT.test(input.subject ?? "")) {
+        return ignore("out_of_office");
+    }
+    if (h.has("list-id") || h.has("list-unsubscribe"))
+        return ignore("mailing_list");
+    const suppressAutoResponse = (h.get("x-auto-response-suppress") ?? "").trim() !== "";
+    const flags = suppressAutoResponse ? { suppressAutoResponse } : {};
+    if (MACHINE_LOCAL.test(local)) {
+        const customer = realReplyTo(input, from);
+        if (customer)
+            return { action: "process", reason: "none", customerAddress: customer, ...flags };
+        return ignore("machine_sender", local);
+    }
+    return { action: "process", reason: "none", ...flags };
+}

package/dist/react.d.ts

@@ -0,0 +1,97 @@
+import { type ReactNode } from "react";
+import type { InboxThreadDetail } from "./inbox/types";
+export type { InboxActionResult, InboxThreadDetail, InboxThreadList, InboxThreadSummary, } from "./inbox/types";
+export interface HelpdeskInboxClassNames {
+    root: string;
+    layout: string;
+    listPane: string;
+    detailPane: string;
+    hiddenOnMobile: string;
+    title: string;
+    filters: string;
+    field: string;
+    fieldWide: string;
+    label: string;
+    selectWrap: string;
+    select: string;
+    selectIcon: string;
+    list: string;
+    listItem: string;
+    listItemCurrent: string;
+    listItemTop: string;
+    listItemTitle: string;
+    listItemTime: string;
+    listItemMeta: string;
+    card: string;
+    header: string;
+    headerTop: string;
+    headerActions: string;
+    heading: string;
+    subheading: string;
+    text: string;
+    muted: string;
+    meta: string;
+    badge: string;
+    badgeAttention: string;
+    badgeDone: string;
+    badgeError: string;
+    reasonNote: string;
+    toolButton: string;
+    assignedChip: string;
+    iconButton: string;
+    menu: string;
+    menuItem: string;
+    backLink: string;
+    conversation: string;
+    entry: string;
+    entryOurs: string;
+    avatar: string;
+    avatarOurs: string;
+    avatarEvent: string;
+    message: string;
+    messageOurs: string;
+    messageEvent: string;
+    messageHeader: string;
+    messageBody: string;
+    emptyBody: string;
+    eventTitle: string;
+    details: string;
+    detailsPre: string;
+    fileChips: string;
+    fileChip: string;
+    fileChipName: string;
+    fileChipMeta: string;
+    sentNote: string;
+    composer: string;
+    composerHeader: string;
+    aiChip: string;
+    composerFooter: string;
+    replyChip: string;
+    chipRemove: string;
+    dashedButton: string;
+    srOnly: string;
+    icon: string;
+    textarea: string;
+    actions: string;
+    primaryButton: string;
+    secondaryButton: string;
+    dangerButton: string;
+    linkButton: string;
+    banner: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    context: string;
+}
+export declare const DEFAULT_HELPDESK_INBOX_CLASSNAMES: HelpdeskInboxClassNames;
+export interface HelpdeskInboxProps {
+    apiBasePath?: string;
+    classNames?: Partial<HelpdeskInboxClassNames>;
+    pollIntervalMs?: number;
+    fetch?: typeof fetch;
+    renderCustomerContext?: (thread: InboxThreadDetail["thread"]) => ReactNode;
+    initialThreadId?: string;
+    onThreadChange?: (threadId: string | null) => void;
+}
+export declare function HelpdeskInbox({ apiBasePath, classNames, pollIntervalMs, fetch: fetchImpl, renderCustomerContext, initialThreadId, onThreadChange, }: HelpdeskInboxProps): import("react").JSX.Element;