@mailoo/chat 0.0.0-stage → 1.32.2

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { MailooIntegrationConfig } from '@mailoo/next-core';
+import { M as MailooChatWidgetConfig } from './widget-config-B5Tf7gqn.js';
+export { b as MAILOO_CHAT_LAUNCHER_POSITIONS, a as MailooChatLauncherPosition, d as MailooChatWidgetOperator, e as MailooChatWidgetTopic, c as chatWidgetCssVariables, i as isMailooChatLauncherPosition, m as mailooChatLauncherRootClassNames, r as resolveMailooChatLauncherPosition } from './widget-config-B5Tf7gqn.js';
+import 'react';
+
+type MailooChatIntegrationConfig = MailooIntegrationConfig;
+declare function getMailooChatIntegrationConfig(): MailooChatIntegrationConfig | null;
+/**
+ * Base URL the browser uses for Mailoo chat WebSockets (ws/wss).
+ * Precedence: MAILOO_CHAT_WS_ORIGIN → chat API base → API_BASE_URL.
+ * The host must expose WebSocket upgrade on the public API hostname.
+ */
+declare function getMailooChatWebSocketOrigin(): string | null;
+type MailooChatIntegrationStatus = {
+    status: string;
+    name: string;
+    type: string;
+    lastActivity: string;
+};
+
+/**
+ * Server-side status check against Mailoo (API key from env).
+ * Returns null when chat is not configured or the request fails.
+ */
+declare function fetchMailooChatIntegrationStatus(): Promise<MailooChatIntegrationStatus | null>;
+/**
+ * Server-side widget config from Mailoo API (brand, operators, topics, privacy).
+ * Returns null when env is missing, the request fails, or the payload is invalid.
+ * Never throws — hosts must not 500 the page when chat bootstrap fails.
+ */
+declare function fetchMailooChatWidgetConfig(locale: string): Promise<MailooChatWidgetConfig | null>;
+/** Props for {@link MailooSiteChatShell} / floating widget host. */
+type MailooChatHostConfig = {
+    apiOrigin: string;
+    projectUid: string;
+    integrationId: string;
+    welcomeMessage: string;
+    locale: string;
+    isAuthenticated: boolean;
+    /** Always present when resolve succeeds — brand, topics, position, etc. */
+    widgetConfig: MailooChatWidgetConfig;
+};
+/**
+ * Default host resolve: env + public JSBOX widget-config.
+ * Returns null when chat env is incomplete or widget-config cannot load
+ * (do not mount the widget). Never throws — page hosts must stay HTTP 200.
+ */
+declare function resolveMailooChatHostConfig(opts: {
+    locale: string;
+    isAuthenticated?: boolean;
+}): Promise<MailooChatHostConfig | null>;
+
+export { type MailooChatHostConfig, type MailooChatIntegrationConfig, type MailooChatIntegrationStatus, MailooChatWidgetConfig, fetchMailooChatIntegrationStatus, fetchMailooChatWidgetConfig, getMailooChatIntegrationConfig, getMailooChatWebSocketOrigin, resolveMailooChatHostConfig };

package/dist/index.js

@@ -0,0 +1,27 @@
+import {
+  fetchMailooChatIntegrationStatus,
+  fetchMailooChatWidgetConfig,
+  getMailooChatIntegrationConfig,
+  getMailooChatWebSocketOrigin,
+  resolveMailooChatHostConfig
+} from "./chunk-2Y37RYEL.js";
+import {
+  MAILOO_CHAT_LAUNCHER_POSITIONS,
+  chatWidgetCssVariables,
+  isMailooChatLauncherPosition,
+  mailooChatLauncherRootClassNames,
+  resolveMailooChatLauncherPosition
+} from "./chunk-77E6HUHY.js";
+export {
+  MAILOO_CHAT_LAUNCHER_POSITIONS,
+  chatWidgetCssVariables,
+  fetchMailooChatIntegrationStatus,
+  fetchMailooChatWidgetConfig,
+  getMailooChatIntegrationConfig,
+  getMailooChatWebSocketOrigin,
+  isMailooChatLauncherPosition,
+  mailooChatLauncherRootClassNames,
+  resolveMailooChatHostConfig,
+  resolveMailooChatLauncherPosition
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/mailoo-site-chat-widget-C7B797Lu.d.ts

@@ -0,0 +1,130 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { M as MailooChatFault } from './shared-glVmghqk.js';
+import { M as MailooChatWidgetConfig, a as MailooChatLauncherPosition } from './widget-config-B5Tf7gqn.js';
+
+type GuestUiCopy = {
+    intro: string;
+    emailLabel: string;
+    nameLabel: string;
+    emailPlaceholder: string;
+    namePlaceholder: string;
+    continueCta: string;
+    changeContact: string;
+    backToTopics: string;
+    emailInvalid: string;
+    threadHint: string;
+    threadHintIconLabel: string;
+    threadHintCollapse: string;
+    emptyThreadGuest: string;
+    loadingProfile: string;
+};
+type MailooChatUnavailableCopy = {
+    rateLimitedTitle: string;
+    rateLimitedBody: string;
+    unavailableTitle: string;
+    unavailableBody: string;
+    retryCta: string;
+    contactCta: string;
+};
+type MailooChatUiLabels = GuestUiCopy & MailooChatUnavailableCopy & {
+    title: string;
+    launcherOpen: string;
+    launcherClose: string;
+    send: string;
+    composerPlaceholder: string;
+    emptyThreadAuthenticated: string;
+};
+
+type MailooChatUnavailableAction = {
+    type: 'link';
+    href: string;
+    label: string;
+} | {
+    type: 'mailto';
+    email: string;
+    label?: string;
+};
+type MailooChatUnavailableRenderArgs = {
+    fault: MailooChatFault;
+    labels: MailooChatUiLabels;
+    retry: () => void;
+    unavailableAction?: MailooChatUnavailableAction;
+    brandBtnClass: string;
+};
+/**
+ * Built-in panel when chat hits rate limit or service/network unavailability.
+ * Integrators may replace this via `renderUnavailable`.
+ */
+declare function MailooChatUnavailablePanel({ fault, labels, retry, unavailableAction, brandBtnClass, }: MailooChatUnavailableRenderArgs): ReactNode;
+
+type MailooChatWidgetProps = {
+    apiOrigin: string;
+    projectUid: string;
+    integrationId: string;
+    welcomeMessage: string;
+    locale: string;
+    isAuthenticated: boolean;
+    widgetConfig?: MailooChatWidgetConfig | null;
+    className?: string;
+    panelClassName?: string;
+    launcherClassName?: string;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    title?: string;
+    launcherLabel?: string;
+    labels?: Partial<MailooChatUiLabels>;
+    submitEndpoint?: string;
+    messagesEndpoint?: string;
+    pollIntervalMs?: number;
+    enablePolling?: boolean;
+    enableWebSocket?: boolean;
+    position?: MailooChatLauncherPosition;
+    zIndex?: number;
+    onSessionCreated?: (sessionPublicId: string) => void;
+    onMessageSent?: (content: string) => void;
+    onError?: (error: string) => void;
+    onFault?: (fault: MailooChatFault) => void;
+    /** Integrator-chosen contact/link when chat is rate-limited or unavailable. */
+    unavailableAction?: MailooChatUnavailableAction;
+    renderLauncher?: (args: {
+        open: boolean;
+        toggle: () => void;
+    }) => ReactNode;
+    renderHeader?: (args: {
+        welcomeMessage: string;
+        title: string;
+    }) => ReactNode;
+    renderEmpty?: (args: {
+        isAuthenticated: boolean;
+    }) => ReactNode;
+    renderWelcome?: (args: MailooChatWelcomeRenderArgs) => ReactNode;
+    /** Replace the built-in unavailable panel; package still classifies the fault. */
+    renderUnavailable?: (args: MailooChatUnavailableRenderArgs) => ReactNode;
+};
+type MailooChatWelcomeRenderArgs = {
+    widgetConfig: MailooChatWidgetConfig | null | undefined;
+    welcomeMessage: string;
+    title: string;
+    locale: string;
+    labels: MailooChatUiLabels;
+    brandBtnClass: string;
+    brandStyle?: React.CSSProperties;
+    topics: MailooChatWidgetConfig['topics'];
+    selectedTopicId: string | null;
+    setSelectedTopicId: (id: string | null) => void;
+    /** When false, identity comes from session / saved guest profile — no email form. */
+    needsGuestFields: boolean;
+    isAuthenticated: boolean;
+    guestEmail: string;
+    setGuestEmail: (value: string) => void;
+    guestName: string;
+    setGuestName: (value: string) => void;
+    error: string | null;
+    /** Continue from welcome: validates guest email when needed, then enters composer. */
+    confirmGuestContact: (invalidEmailMessage?: string) => boolean;
+};
+declare function MailooSiteChatWidget(props: MailooChatWidgetProps): react.JSX.Element;
+
+export { type MailooChatUnavailableAction as M, type MailooChatUnavailableRenderArgs as a, MailooSiteChatWidget as b, type MailooChatWidgetProps as c, type MailooChatUiLabels as d, type MailooChatWelcomeRenderArgs as e, MailooChatUnavailablePanel as f };

package/dist/mailoo-site-chat-widget-h_cBqsJw.d.cts

@@ -0,0 +1,130 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { M as MailooChatFault } from './shared-glVmghqk.cjs';
+import { M as MailooChatWidgetConfig, a as MailooChatLauncherPosition } from './widget-config-B5Tf7gqn.cjs';
+
+type GuestUiCopy = {
+    intro: string;
+    emailLabel: string;
+    nameLabel: string;
+    emailPlaceholder: string;
+    namePlaceholder: string;
+    continueCta: string;
+    changeContact: string;
+    backToTopics: string;
+    emailInvalid: string;
+    threadHint: string;
+    threadHintIconLabel: string;
+    threadHintCollapse: string;
+    emptyThreadGuest: string;
+    loadingProfile: string;
+};
+type MailooChatUnavailableCopy = {
+    rateLimitedTitle: string;
+    rateLimitedBody: string;
+    unavailableTitle: string;
+    unavailableBody: string;
+    retryCta: string;
+    contactCta: string;
+};
+type MailooChatUiLabels = GuestUiCopy & MailooChatUnavailableCopy & {
+    title: string;
+    launcherOpen: string;
+    launcherClose: string;
+    send: string;
+    composerPlaceholder: string;
+    emptyThreadAuthenticated: string;
+};
+
+type MailooChatUnavailableAction = {
+    type: 'link';
+    href: string;
+    label: string;
+} | {
+    type: 'mailto';
+    email: string;
+    label?: string;
+};
+type MailooChatUnavailableRenderArgs = {
+    fault: MailooChatFault;
+    labels: MailooChatUiLabels;
+    retry: () => void;
+    unavailableAction?: MailooChatUnavailableAction;
+    brandBtnClass: string;
+};
+/**
+ * Built-in panel when chat hits rate limit or service/network unavailability.
+ * Integrators may replace this via `renderUnavailable`.
+ */
+declare function MailooChatUnavailablePanel({ fault, labels, retry, unavailableAction, brandBtnClass, }: MailooChatUnavailableRenderArgs): ReactNode;
+
+type MailooChatWidgetProps = {
+    apiOrigin: string;
+    projectUid: string;
+    integrationId: string;
+    welcomeMessage: string;
+    locale: string;
+    isAuthenticated: boolean;
+    widgetConfig?: MailooChatWidgetConfig | null;
+    className?: string;
+    panelClassName?: string;
+    launcherClassName?: string;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    title?: string;
+    launcherLabel?: string;
+    labels?: Partial<MailooChatUiLabels>;
+    submitEndpoint?: string;
+    messagesEndpoint?: string;
+    pollIntervalMs?: number;
+    enablePolling?: boolean;
+    enableWebSocket?: boolean;
+    position?: MailooChatLauncherPosition;
+    zIndex?: number;
+    onSessionCreated?: (sessionPublicId: string) => void;
+    onMessageSent?: (content: string) => void;
+    onError?: (error: string) => void;
+    onFault?: (fault: MailooChatFault) => void;
+    /** Integrator-chosen contact/link when chat is rate-limited or unavailable. */
+    unavailableAction?: MailooChatUnavailableAction;
+    renderLauncher?: (args: {
+        open: boolean;
+        toggle: () => void;
+    }) => ReactNode;
+    renderHeader?: (args: {
+        welcomeMessage: string;
+        title: string;
+    }) => ReactNode;
+    renderEmpty?: (args: {
+        isAuthenticated: boolean;
+    }) => ReactNode;
+    renderWelcome?: (args: MailooChatWelcomeRenderArgs) => ReactNode;
+    /** Replace the built-in unavailable panel; package still classifies the fault. */
+    renderUnavailable?: (args: MailooChatUnavailableRenderArgs) => ReactNode;
+};
+type MailooChatWelcomeRenderArgs = {
+    widgetConfig: MailooChatWidgetConfig | null | undefined;
+    welcomeMessage: string;
+    title: string;
+    locale: string;
+    labels: MailooChatUiLabels;
+    brandBtnClass: string;
+    brandStyle?: React.CSSProperties;
+    topics: MailooChatWidgetConfig['topics'];
+    selectedTopicId: string | null;
+    setSelectedTopicId: (id: string | null) => void;
+    /** When false, identity comes from session / saved guest profile — no email form. */
+    needsGuestFields: boolean;
+    isAuthenticated: boolean;
+    guestEmail: string;
+    setGuestEmail: (value: string) => void;
+    guestName: string;
+    setGuestName: (value: string) => void;
+    error: string | null;
+    /** Continue from welcome: validates guest email when needed, then enters composer. */
+    confirmGuestContact: (invalidEmailMessage?: string) => boolean;
+};
+declare function MailooSiteChatWidget(props: MailooChatWidgetProps): react.JSX.Element;
+
+export { type MailooChatUnavailableAction as M, type MailooChatUnavailableRenderArgs as a, MailooSiteChatWidget as b, type MailooChatWidgetProps as c, type MailooChatUiLabels as d, type MailooChatWelcomeRenderArgs as e, MailooChatUnavailablePanel as f };

package/dist/routes/index.cjs

@@ -0,0 +1,204 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/routes/index.ts
+var routes_exports = {};
+__export(routes_exports, {
+  createChatMessagesHandler: () => createChatMessagesHandler,
+  createChatStatusHandler: () => createChatStatusHandler,
+  createChatSubmitHandler: () => createChatSubmitHandler,
+  createChatWidgetConfigHandler: () => createChatWidgetConfigHandler
+});
+module.exports = __toCommonJS(routes_exports);
+var import_next_core2 = require("@mailoo/next-core");
+
+// src/config.ts
+var import_navigation = require("next/navigation");
+var import_next_core = require("@mailoo/next-core");
+function getMailooChatIntegrationConfig() {
+  return (0, import_next_core.readMailooIntegrationConfig)({
+    prefix: "MAILOO_CHAT_INTEGRATION",
+    allowApiBaseUrlFallback: true
+  });
+}
+
+// src/routes/index.ts
+function upstreamGetHeaders(request, apiKey) {
+  const headers = {
+    "Content-Type": "application/json",
+    "X-API-Key": apiKey
+  };
+  const origin = (0, import_next_core2.mailooUpstreamOrigin)(request);
+  if (origin) headers.Origin = origin;
+  return headers;
+}
+function createChatSubmitHandler(options) {
+  const logger = options?.logger ?? import_next_core2.defaultMailooLogger;
+  return async function POST(request) {
+    const cfg = getMailooChatIntegrationConfig();
+    if (!cfg) {
+      return (0, import_next_core2.jsonError)(
+        {
+          error: "NOT_CONFIGURED",
+          message: "Chat BFF is not configured. Set MAILOO_CHAT_INTEGRATION_* env."
+        },
+        503
+      );
+    }
+    let body;
+    try {
+      body = await request.json();
+    } catch {
+      return (0, import_next_core2.jsonError)({ error: "Invalid JSON body" }, 400);
+    }
+    const o = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+    const content = typeof o.content === "string" ? o.content.trim() : "";
+    if (!content) {
+      return (0, import_next_core2.jsonError)({ error: "content is required" }, 400);
+    }
+    const payload = { content };
+    if (typeof o.sessionPublicId === "string" && o.sessionPublicId.trim()) {
+      payload.sessionPublicId = o.sessionPublicId.trim();
+    }
+    const fromSession = options?.resolveSender ? await options.resolveSender(request) : null;
+    if (fromSession?.email) {
+      payload.senderEmail = fromSession.email;
+      const name = fromSession.name?.trim();
+      if (name) payload.senderName = name;
+    } else {
+      if (typeof o.senderEmail === "string" && o.senderEmail.trim()) {
+        payload.senderEmail = o.senderEmail.trim();
+      }
+      if (typeof o.senderName === "string" && o.senderName.trim()) {
+        payload.senderName = o.senderName.trim();
+      }
+    }
+    if (typeof o.pageUrl === "string" && o.pageUrl.trim()) {
+      const pageUrl = o.pageUrl.trim();
+      if (pageUrl.length <= 2048 && !/[\r\n\0]/.test(pageUrl)) {
+        payload.pageUrl = pageUrl;
+      }
+    }
+    if (typeof o.topicId === "string" && o.topicId.trim()) {
+      payload.topicId = o.topicId.trim();
+    }
+    const url = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/messages`;
+    try {
+      return await (0, import_next_core2.proxyMailooWebhookJsonPost)({
+        request,
+        url,
+        apiKey: cfg.apiKey,
+        body: payload
+      });
+    } catch (error) {
+      logger.logException?.(error, "chat submit proxy failed");
+      return (0, import_next_core2.jsonError)({ error: "Upstream request failed" }, 502);
+    }
+  };
+}
+function createChatMessagesHandler(options) {
+  const logger = options?.logger ?? import_next_core2.defaultMailooLogger;
+  return async function GET(request) {
+    const cfg = getMailooChatIntegrationConfig();
+    if (!cfg) {
+      return (0, import_next_core2.jsonError)({ error: "Chat BFF not configured" }, 503);
+    }
+    const sessionPublicId = request.nextUrl.searchParams.get("sessionPublicId")?.trim();
+    if (!sessionPublicId) {
+      return (0, import_next_core2.jsonError)({ error: "sessionPublicId is required" }, 400);
+    }
+    const since = request.nextUrl.searchParams.get("since")?.trim();
+    const path = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/sessions/${encodeURIComponent(sessionPublicId)}/messages`;
+    const url = new URL(path);
+    if (since) url.searchParams.set("since", since);
+    try {
+      const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: upstreamGetHeaders(request, cfg.apiKey)
+      });
+      const data = await response.json();
+      return new Response(JSON.stringify(data), {
+        status: response.status,
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch (error) {
+      logger.logException?.(error, "chat messages proxy failed");
+      return (0, import_next_core2.jsonError)({ error: "Upstream request failed" }, 502);
+    }
+  };
+}
+function createChatStatusHandler(options) {
+  const logger = options?.logger ?? import_next_core2.defaultMailooLogger;
+  return async function GET(request) {
+    const cfg = getMailooChatIntegrationConfig();
+    if (!cfg) {
+      return (0, import_next_core2.jsonError)({ error: "Chat BFF not configured" }, 503);
+    }
+    const url = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/status`;
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: upstreamGetHeaders(request, cfg.apiKey)
+      });
+      const data = await response.json();
+      return new Response(JSON.stringify(data), {
+        status: response.status,
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch (error) {
+      logger.logException?.(error, "chat status proxy failed");
+      return (0, import_next_core2.jsonError)({ error: "Upstream request failed" }, 502);
+    }
+  };
+}
+function createChatWidgetConfigHandler(options) {
+  const logger = options?.logger ?? import_next_core2.defaultMailooLogger;
+  return async function GET(request) {
+    const cfg = getMailooChatIntegrationConfig();
+    if (!cfg) {
+      return (0, import_next_core2.jsonError)({ error: "Chat BFF not configured" }, 503);
+    }
+    const locale = request.nextUrl.searchParams.get("locale")?.trim() || "en";
+    const path = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/widget-config`;
+    const url = new URL(path);
+    url.searchParams.set("locale", locale);
+    try {
+      const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: upstreamGetHeaders(request, cfg.apiKey)
+      });
+      const data = await response.json();
+      return new Response(JSON.stringify(data), {
+        status: response.status,
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch (error) {
+      logger.logException?.(error, "chat widget-config proxy failed");
+      return (0, import_next_core2.jsonError)({ error: "Upstream request failed" }, 502);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createChatMessagesHandler,
+  createChatStatusHandler,
+  createChatSubmitHandler,
+  createChatWidgetConfigHandler
+});
+//# sourceMappingURL=index.cjs.map

package/dist/routes/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routes/index.ts","../../src/config.ts"],"sourcesContent":["import type { NextRequest } from 'next/server'\nimport {\n  defaultMailooLogger,\n  jsonError,\n  mailooUpstreamOrigin,\n  proxyMailooWebhookJsonPost,\n  type MailooLogger,\n} from '@mailoo/next-core'\nimport { getMailooChatIntegrationConfig } from '../config.js'\n\nexport type ChatSubmitSender = {\n  email?: string\n  name?: string\n}\n\nfunction upstreamGetHeaders(\n  request: NextRequest,\n  apiKey: string\n): Record<string, string> {\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'X-API-Key': apiKey,\n  }\n  const origin = mailooUpstreamOrigin(request)\n  if (origin) headers.Origin = origin\n  return headers\n}\n\n/**\n * Create chat message submit handler.\n * Optional `resolveSender` lets hosts inject Auth.js/session email without\n * coupling this package to Auth.js.\n */\nexport function createChatSubmitHandler(options?: {\n  logger?: MailooLogger\n  resolveSender?: (\n    request: NextRequest\n  ) => Promise<ChatSubmitSender | null> | ChatSubmitSender | null\n}) {\n  const logger = options?.logger ?? defaultMailooLogger\n  return async function POST(request: NextRequest): Promise<Response> {\n    const cfg = getMailooChatIntegrationConfig()\n    if (!cfg) {\n      return jsonError(\n        {\n          error: 'NOT_CONFIGURED',\n          message:\n            'Chat BFF is not configured. Set MAILOO_CHAT_INTEGRATION_* env.',\n        },\n        503\n      )\n    }\n\n    let body: unknown\n    try {\n      body = await request.json()\n    } catch {\n      return jsonError({ error: 'Invalid JSON body' }, 400)\n    }\n\n    const o =\n      body && typeof body === 'object' && !Array.isArray(body)\n        ? (body as Record<string, unknown>)\n        : {}\n\n    const content = typeof o.content === 'string' ? o.content.trim() : ''\n    if (!content) {\n      return jsonError({ error: 'content is required' }, 400)\n    }\n\n    const payload: Record<string, string> = { content }\n\n    if (typeof o.sessionPublicId === 'string' && o.sessionPublicId.trim()) {\n      payload.sessionPublicId = o.sessionPublicId.trim()\n    }\n\n    const fromSession = options?.resolveSender\n      ? await options.resolveSender(request)\n      : null\n\n    if (fromSession?.email) {\n      payload.senderEmail = fromSession.email\n      const name = fromSession.name?.trim()\n      if (name) payload.senderName = name\n    } else {\n      if (typeof o.senderEmail === 'string' && o.senderEmail.trim()) {\n        payload.senderEmail = o.senderEmail.trim()\n      }\n      if (typeof o.senderName === 'string' && o.senderName.trim()) {\n        payload.senderName = o.senderName.trim()\n      }\n    }\n\n    if (typeof o.pageUrl === 'string' && o.pageUrl.trim()) {\n      const pageUrl = o.pageUrl.trim()\n      if (pageUrl.length <= 2048 && !/[\\r\\n\\0]/.test(pageUrl)) {\n        payload.pageUrl = pageUrl\n      }\n    }\n\n    if (typeof o.topicId === 'string' && o.topicId.trim()) {\n      payload.topicId = o.topicId.trim()\n    }\n\n    const url = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/messages`\n\n    try {\n      return await proxyMailooWebhookJsonPost({\n        request,\n        url,\n        apiKey: cfg.apiKey,\n        body: payload,\n      })\n    } catch (error) {\n      logger.logException?.(error, 'chat submit proxy failed')\n      return jsonError({ error: 'Upstream request failed' }, 502)\n    }\n  }\n}\n\n/** Visitor polling: list session messages via server-held API key. */\nexport function createChatMessagesHandler(options?: { logger?: MailooLogger }) {\n  const logger = options?.logger ?? defaultMailooLogger\n  return async function GET(request: NextRequest): Promise<Response> {\n    const cfg = getMailooChatIntegrationConfig()\n    if (!cfg) {\n      return jsonError({ error: 'Chat BFF not configured' }, 503)\n    }\n\n    const sessionPublicId = request.nextUrl.searchParams\n      .get('sessionPublicId')\n      ?.trim()\n    if (!sessionPublicId) {\n      return jsonError({ error: 'sessionPublicId is required' }, 400)\n    }\n\n    const since = request.nextUrl.searchParams.get('since')?.trim()\n    const path = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/sessions/${encodeURIComponent(sessionPublicId)}/messages`\n    const url = new URL(path)\n    if (since) url.searchParams.set('since', since)\n\n    try {\n      const response = await fetch(url.toString(), {\n        method: 'GET',\n        headers: upstreamGetHeaders(request, cfg.apiKey),\n      })\n      const data = await response.json()\n      return new Response(JSON.stringify(data), {\n        status: response.status,\n        headers: { 'Content-Type': 'application/json' },\n      })\n    } catch (error) {\n      logger.logException?.(error, 'chat messages proxy failed')\n      return jsonError({ error: 'Upstream request failed' }, 502)\n    }\n  }\n}\n\n/** Chat integration status via server-held API key. */\nexport function createChatStatusHandler(options?: { logger?: MailooLogger }) {\n  const logger = options?.logger ?? defaultMailooLogger\n  return async function GET(request: NextRequest): Promise<Response> {\n    const cfg = getMailooChatIntegrationConfig()\n    if (!cfg) {\n      return jsonError({ error: 'Chat BFF not configured' }, 503)\n    }\n\n    const url = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/status`\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: upstreamGetHeaders(request, cfg.apiKey),\n      })\n      const data = await response.json()\n      return new Response(JSON.stringify(data), {\n        status: response.status,\n        headers: { 'Content-Type': 'application/json' },\n      })\n    } catch (error) {\n      logger.logException?.(error, 'chat status proxy failed')\n      return jsonError({ error: 'Upstream request failed' }, 502)\n    }\n  }\n}\n\n/** Public widget config (brand, operators, topics, privacy URL). */\nexport function createChatWidgetConfigHandler(options?: {\n  logger?: MailooLogger\n}) {\n  const logger = options?.logger ?? defaultMailooLogger\n  return async function GET(request: NextRequest): Promise<Response> {\n    const cfg = getMailooChatIntegrationConfig()\n    if (!cfg) {\n      return jsonError({ error: 'Chat BFF not configured' }, 503)\n    }\n\n    const locale = request.nextUrl.searchParams.get('locale')?.trim() || 'en'\n    const path = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/widget-config`\n    const url = new URL(path)\n    url.searchParams.set('locale', locale)\n\n    try {\n      const response = await fetch(url.toString(), {\n        method: 'GET',\n        headers: upstreamGetHeaders(request, cfg.apiKey),\n      })\n      const data = await response.json()\n      return new Response(JSON.stringify(data), {\n        status: response.status,\n        headers: { 'Content-Type': 'application/json' },\n      })\n    } catch (error) {\n      logger.logException?.(error, 'chat widget-config proxy failed')\n      return jsonError({ error: 'Upstream request failed' }, 502)\n    }\n  }\n}\n","import { unstable_rethrow } from 'next/navigation'\nimport {\n  defaultMailooLogger,\n  readMailooIntegrationConfig,\n  type MailooIntegrationConfig,\n} from '@mailoo/next-core'\nimport type { MailooChatWidgetConfig } from './lib/widget-config.js'\n\nexport type MailooChatIntegrationConfig = MailooIntegrationConfig\n\nexport function getMailooChatIntegrationConfig(): MailooChatIntegrationConfig | null {\n  return readMailooIntegrationConfig({\n    prefix: 'MAILOO_CHAT_INTEGRATION',\n    allowApiBaseUrlFallback: true,\n  })\n}\n\n/**\n * Base URL the browser uses for Mailoo chat WebSockets (ws/wss).\n * Precedence: MAILOO_CHAT_WS_ORIGIN → chat API base → API_BASE_URL.\n * The host must expose WebSocket upgrade on the public API hostname.\n */\nexport function getMailooChatWebSocketOrigin(): string | null {\n  const explicit = process.env.MAILOO_CHAT_WS_ORIGIN?.trim()\n  if (explicit) {\n    return explicit.replace(/\\/$/, '')\n  }\n  const chatCfg = getMailooChatIntegrationConfig()\n  if (chatCfg?.apiBaseUrl) {\n    return chatCfg.apiBaseUrl.replace(/\\/$/, '')\n  }\n  const chatApi = process.env.MAILOO_CHAT_INTEGRATION_API?.trim()\n  if (chatApi) {\n    return chatApi.replace(/\\/$/, '')\n  }\n  const api = process.env.API_BASE_URL?.trim()\n  if (api) {\n    return api.replace(/\\/$/, '')\n  }\n  return null\n}\n\nexport type MailooChatIntegrationStatus = {\n  status: string\n  name: string\n  type: string\n  lastActivity: string\n}\n\nexport type { MailooChatWidgetConfig } from './lib/widget-config.js'\nexport {\n  chatWidgetCssVariables,\n  isMailooChatLauncherPosition,\n  mailooChatLauncherRootClassNames,\n  resolveMailooChatLauncherPosition,\n  MAILOO_CHAT_LAUNCHER_POSITIONS,\n  type MailooChatLauncherPosition,\n  type MailooChatWidgetOperator,\n  type MailooChatWidgetTopic,\n} from './lib/widget-config.js'\n\n/**\n * Server-side status check against Mailoo (API key from env).\n * Returns null when chat is not configured or the request fails.\n */\nexport async function fetchMailooChatIntegrationStatus(): Promise<MailooChatIntegrationStatus | null> {\n  const cfg = getMailooChatIntegrationConfig()\n  if (!cfg) return null\n  try {\n    const url = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/status`\n    const response = await fetch(url, {\n      method: 'GET',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-API-Key': cfg.apiKey,\n      },\n    })\n    if (!response.ok) return null\n    const data = (await response.json()) as Partial<MailooChatIntegrationStatus>\n    if (\n      typeof data.status !== 'string' ||\n      typeof data.name !== 'string' ||\n      typeof data.type !== 'string' ||\n      typeof data.lastActivity !== 'string'\n    ) {\n      return null\n    }\n    return {\n      status: data.status,\n      name: data.name,\n      type: data.type,\n      lastActivity: data.lastActivity,\n    }\n  } catch (error) {\n    unstable_rethrow(error)\n    return null\n  }\n}\n\n/**\n * Server-side widget config from Mailoo API (brand, operators, topics, privacy).\n * Returns null when env is missing, the request fails, or the payload is invalid.\n * Never throws — hosts must not 500 the page when chat bootstrap fails.\n */\nexport async function fetchMailooChatWidgetConfig(\n  locale: string\n): Promise<MailooChatWidgetConfig | null> {\n  const cfg = getMailooChatIntegrationConfig()\n  if (!cfg) {\n    return null\n  }\n  try {\n    const url = new URL(\n      `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/widget-config`\n    )\n    url.searchParams.set('locale', locale)\n    const response = await fetch(url.toString(), {\n      method: 'GET',\n      headers: {\n        'Content-Type': 'application/json',\n        'X-API-Key': cfg.apiKey,\n      },\n    })\n    if (!response.ok) {\n      defaultMailooLogger.warn?.(\n        `Failed to fetch chat widget config: HTTP ${response.status}`\n      )\n      return null\n    }\n    const data = (await response.json()) as {\n      widget?: MailooChatWidgetConfig\n    }\n    if (!data.widget || !Array.isArray(data.widget.topics)) {\n      defaultMailooLogger.warn?.(\n        'Failed to fetch chat widget config: invalid response (missing widget.topics)'\n      )\n      return null\n    }\n    return {\n      ...data.widget,\n      topics: data.widget.topics,\n      operators: Array.isArray(data.widget.operators)\n        ? data.widget.operators\n        : [],\n    }\n  } catch (error) {\n    unstable_rethrow(error)\n    defaultMailooLogger.logException?.(\n      error,\n      'Failed to fetch chat widget config'\n    )\n    return null\n  }\n}\n\n/** Props for {@link MailooSiteChatShell} / floating widget host. */\nexport type MailooChatHostConfig = {\n  apiOrigin: string\n  projectUid: string\n  integrationId: string\n  welcomeMessage: string\n  locale: string\n  isAuthenticated: boolean\n  /** Always present when resolve succeeds — brand, topics, position, etc. */\n  widgetConfig: MailooChatWidgetConfig\n}\n\n/**\n * Default host resolve: env + public JSBOX widget-config.\n * Returns null when chat env is incomplete or widget-config cannot load\n * (do not mount the widget). Never throws — page hosts must stay HTTP 200.\n */\nexport async function resolveMailooChatHostConfig(opts: {\n  locale: string\n  isAuthenticated?: boolean\n}): Promise<MailooChatHostConfig | null> {\n  try {\n    const server = getMailooChatIntegrationConfig()\n    if (!server) return null\n\n    const apiOrigin = getMailooChatWebSocketOrigin()\n    if (!apiOrigin) return null\n\n    const locale = opts.locale.trim() || 'en'\n    const widgetConfig = await fetchMailooChatWidgetConfig(locale)\n    if (!widgetConfig) return null\n\n    const welcomeOverride = process.env.MAILOO_CHAT_WELCOME_MESSAGE?.trim()\n    const welcomeMessage =\n      welcomeOverride || widgetConfig.welcomeTagline?.trim() || ''\n\n    return {\n      apiOrigin,\n      projectUid: server.projectUid,\n      integrationId: server.integrationId,\n      welcomeMessage,\n      locale,\n      isAuthenticated: Boolean(opts.isAuthenticated),\n      widgetConfig,\n    }\n  } catch (error) {\n    unstable_rethrow(error)\n    defaultMailooLogger.logException?.(\n      error,\n      'resolveMailooChatHostConfig failed'\n    )\n    return null\n  }\n}\n"],"mappings":"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","names":["import_next_core"]}

package/dist/routes/index.d.cts

@@ -0,0 +1,30 @@
+import { NextRequest } from 'next/server';
+import { MailooLogger } from '@mailoo/next-core';
+
+type ChatSubmitSender = {
+    email?: string;
+    name?: string;
+};
+/**
+ * Create chat message submit handler.
+ * Optional `resolveSender` lets hosts inject Auth.js/session email without
+ * coupling this package to Auth.js.
+ */
+declare function createChatSubmitHandler(options?: {
+    logger?: MailooLogger;
+    resolveSender?: (request: NextRequest) => Promise<ChatSubmitSender | null> | ChatSubmitSender | null;
+}): (request: NextRequest) => Promise<Response>;
+/** Visitor polling: list session messages via server-held API key. */
+declare function createChatMessagesHandler(options?: {
+    logger?: MailooLogger;
+}): (request: NextRequest) => Promise<Response>;
+/** Chat integration status via server-held API key. */
+declare function createChatStatusHandler(options?: {
+    logger?: MailooLogger;
+}): (request: NextRequest) => Promise<Response>;
+/** Public widget config (brand, operators, topics, privacy URL). */
+declare function createChatWidgetConfigHandler(options?: {
+    logger?: MailooLogger;
+}): (request: NextRequest) => Promise<Response>;
+
+export { type ChatSubmitSender, createChatMessagesHandler, createChatStatusHandler, createChatSubmitHandler, createChatWidgetConfigHandler };

package/dist/routes/index.d.ts

@@ -0,0 +1,30 @@
+import { NextRequest } from 'next/server';
+import { MailooLogger } from '@mailoo/next-core';
+
+type ChatSubmitSender = {
+    email?: string;
+    name?: string;
+};
+/**
+ * Create chat message submit handler.
+ * Optional `resolveSender` lets hosts inject Auth.js/session email without
+ * coupling this package to Auth.js.
+ */
+declare function createChatSubmitHandler(options?: {
+    logger?: MailooLogger;
+    resolveSender?: (request: NextRequest) => Promise<ChatSubmitSender | null> | ChatSubmitSender | null;
+}): (request: NextRequest) => Promise<Response>;
+/** Visitor polling: list session messages via server-held API key. */
+declare function createChatMessagesHandler(options?: {
+    logger?: MailooLogger;
+}): (request: NextRequest) => Promise<Response>;
+/** Chat integration status via server-held API key. */
+declare function createChatStatusHandler(options?: {
+    logger?: MailooLogger;
+}): (request: NextRequest) => Promise<Response>;
+/** Public widget config (brand, operators, topics, privacy URL). */
+declare function createChatWidgetConfigHandler(options?: {
+    logger?: MailooLogger;
+}): (request: NextRequest) => Promise<Response>;
+
+export { type ChatSubmitSender, createChatMessagesHandler, createChatStatusHandler, createChatSubmitHandler, createChatWidgetConfigHandler };