@mailoo/chat 0.0.0-stage → 1.33.0

package/dist/routes/index.js

@@ -0,0 +1,174 @@
+import {
+  getMailooChatIntegrationConfig
+} from "../chunk-2Y37RYEL.js";
+import "../chunk-77E6HUHY.js";
+
+// src/routes/index.ts
+import {
+  defaultMailooLogger,
+  jsonError,
+  mailooUpstreamOrigin,
+  proxyMailooWebhookJsonPost
+} from "@mailoo/next-core";
+function upstreamGetHeaders(request, apiKey) {
+  const headers = {
+    "Content-Type": "application/json",
+    "X-API-Key": apiKey
+  };
+  const origin = mailooUpstreamOrigin(request);
+  if (origin) headers.Origin = origin;
+  return headers;
+}
+function createChatSubmitHandler(options) {
+  const logger = options?.logger ?? defaultMailooLogger;
+  return async function POST(request) {
+    const cfg = getMailooChatIntegrationConfig();
+    if (!cfg) {
+      return 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 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 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 proxyMailooWebhookJsonPost({
+        request,
+        url,
+        apiKey: cfg.apiKey,
+        body: payload
+      });
+    } catch (error) {
+      logger.logException?.(error, "chat submit proxy failed");
+      return jsonError({ error: "Upstream request failed" }, 502);
+    }
+  };
+}
+function createChatMessagesHandler(options) {
+  const logger = options?.logger ?? defaultMailooLogger;
+  return async function GET(request) {
+    const cfg = getMailooChatIntegrationConfig();
+    if (!cfg) {
+      return jsonError({ error: "Chat BFF not configured" }, 503);
+    }
+    const sessionPublicId = request.nextUrl.searchParams.get("sessionPublicId")?.trim();
+    if (!sessionPublicId) {
+      return 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 jsonError({ error: "Upstream request failed" }, 502);
+    }
+  };
+}
+function createChatStatusHandler(options) {
+  const logger = options?.logger ?? defaultMailooLogger;
+  return async function GET(request) {
+    const cfg = getMailooChatIntegrationConfig();
+    if (!cfg) {
+      return 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 jsonError({ error: "Upstream request failed" }, 502);
+    }
+  };
+}
+function createChatWidgetConfigHandler(options) {
+  const logger = options?.logger ?? defaultMailooLogger;
+  return async function GET(request) {
+    const cfg = getMailooChatIntegrationConfig();
+    if (!cfg) {
+      return 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 jsonError({ error: "Upstream request failed" }, 502);
+    }
+  };
+}
+export {
+  createChatMessagesHandler,
+  createChatStatusHandler,
+  createChatSubmitHandler,
+  createChatWidgetConfigHandler
+};
+//# sourceMappingURL=index.js.map

package/dist/routes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routes/index.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"],"mappings":"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","names":[]}

package/dist/shared-glVmghqk.d.cts

@@ -0,0 +1,40 @@
+declare const DEFAULT_CHAT_SUBMIT_ENDPOINT = "/api/v1/webhooks/chat/submit";
+declare const DEFAULT_CHAT_MESSAGES_ENDPOINT = "/api/v1/webhooks/chat/messages";
+declare const DEFAULT_CHAT_STATUS_ENDPOINT = "/api/v1/webhooks/chat/status";
+declare const DEFAULT_CHAT_SESSION_STORAGE_KEY = "mailoo_site_chat_session_public_id";
+declare const DEFAULT_CHAT_GUEST_PROFILE_KEY = "mailoo_site_chat_guest_profile";
+declare const DEFAULT_CHAT_POLL_INTERVAL_MS = 5000;
+type MailooChatConnectionState = 'idle' | 'connecting' | 'open' | 'closed';
+type MailooChatFaultKind = 'rate_limited' | 'unavailable';
+/** Classified chat transport/service fault (not validation or session lifecycle). */
+type MailooChatFault = {
+    kind: MailooChatFaultKind;
+    status: number;
+    message: string;
+};
+type MailooChatSubmitResult = {
+    ok: true;
+    status: number;
+    data: unknown;
+} | {
+    ok: false;
+    status: number;
+    message: string;
+};
+type MailooChatStatus = {
+    status: string;
+    name: string;
+    type: string;
+    lastActivity: string;
+};
+declare function messageFromPayload(data: unknown, fallback: string): string;
+/**
+ * Classify HTTP/network failures that should show the unavailable panel.
+ * Status-based only (no English string parsing). Returns null for validation,
+ * 4xx client errors other than 429, and session-not-found (handled separately).
+ */
+declare function classifyChatFault(status: number, payload: unknown, fallbackMessage?: string): MailooChatFault | null;
+/** Upstream 404 after DB reset / expired sessionStorage id. */
+declare function isChatSessionNotFound(status: number, data: unknown): boolean;
+
+export { DEFAULT_CHAT_GUEST_PROFILE_KEY as D, type MailooChatFault as M, type MailooChatConnectionState as a, type MailooChatSubmitResult as b, type MailooChatStatus as c, classifyChatFault as d, DEFAULT_CHAT_MESSAGES_ENDPOINT as e, DEFAULT_CHAT_POLL_INTERVAL_MS as f, DEFAULT_CHAT_SESSION_STORAGE_KEY as g, DEFAULT_CHAT_STATUS_ENDPOINT as h, DEFAULT_CHAT_SUBMIT_ENDPOINT as i, isChatSessionNotFound as j, type MailooChatFaultKind as k, messageFromPayload as m };

package/dist/shared-glVmghqk.d.ts

@@ -0,0 +1,40 @@
+declare const DEFAULT_CHAT_SUBMIT_ENDPOINT = "/api/v1/webhooks/chat/submit";
+declare const DEFAULT_CHAT_MESSAGES_ENDPOINT = "/api/v1/webhooks/chat/messages";
+declare const DEFAULT_CHAT_STATUS_ENDPOINT = "/api/v1/webhooks/chat/status";
+declare const DEFAULT_CHAT_SESSION_STORAGE_KEY = "mailoo_site_chat_session_public_id";
+declare const DEFAULT_CHAT_GUEST_PROFILE_KEY = "mailoo_site_chat_guest_profile";
+declare const DEFAULT_CHAT_POLL_INTERVAL_MS = 5000;
+type MailooChatConnectionState = 'idle' | 'connecting' | 'open' | 'closed';
+type MailooChatFaultKind = 'rate_limited' | 'unavailable';
+/** Classified chat transport/service fault (not validation or session lifecycle). */
+type MailooChatFault = {
+    kind: MailooChatFaultKind;
+    status: number;
+    message: string;
+};
+type MailooChatSubmitResult = {
+    ok: true;
+    status: number;
+    data: unknown;
+} | {
+    ok: false;
+    status: number;
+    message: string;
+};
+type MailooChatStatus = {
+    status: string;
+    name: string;
+    type: string;
+    lastActivity: string;
+};
+declare function messageFromPayload(data: unknown, fallback: string): string;
+/**
+ * Classify HTTP/network failures that should show the unavailable panel.
+ * Status-based only (no English string parsing). Returns null for validation,
+ * 4xx client errors other than 429, and session-not-found (handled separately).
+ */
+declare function classifyChatFault(status: number, payload: unknown, fallbackMessage?: string): MailooChatFault | null;
+/** Upstream 404 after DB reset / expired sessionStorage id. */
+declare function isChatSessionNotFound(status: number, data: unknown): boolean;
+
+export { DEFAULT_CHAT_GUEST_PROFILE_KEY as D, type MailooChatFault as M, type MailooChatConnectionState as a, type MailooChatSubmitResult as b, type MailooChatStatus as c, classifyChatFault as d, DEFAULT_CHAT_MESSAGES_ENDPOINT as e, DEFAULT_CHAT_POLL_INTERVAL_MS as f, DEFAULT_CHAT_SESSION_STORAGE_KEY as g, DEFAULT_CHAT_STATUS_ENDPOINT as h, DEFAULT_CHAT_SUBMIT_ENDPOINT as i, isChatSessionNotFound as j, type MailooChatFaultKind as k, messageFromPayload as m };

package/dist/styles/widget.css

@@ -0,0 +1,122 @@
+/**
+ * Host-independent shell for MailooSiteChatWidget.
+ * Import via `@mailoo/chat/styles` so position/launcher work even when the
+ * host Tailwind scan does not include this package.
+ */
+
+.mailoo-chat-root {
+  --mailoo-chat-brand: #2563eb;
+  --mailoo-chat-brand-on: #ffffff;
+  pointer-events: auto;
+  position: fixed;
+  z-index: 200;
+  bottom: 1.25rem;
+  inset-inline-end: 1.25rem;
+  display: flex;
+  flex-direction: column;
+  align-items: flex-end;
+  gap: 0.5rem;
+  isolation: isolate;
+  transform: translateZ(0);
+}
+
+.mailoo-chat-root--left {
+  inset-inline-end: auto;
+  inset-inline-start: 1.25rem;
+  align-items: flex-start;
+}
+
+.mailoo-chat-root--top {
+  top: 1.25rem;
+  bottom: auto;
+  flex-direction: column-reverse;
+}
+
+.mailoo-chat-root--middle {
+  top: 50%;
+  bottom: auto;
+  transform: translate3d(0, -50%, 0);
+}
+
+.mailoo-chat-panel {
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  width: min(100vw - 2rem, 360px);
+  height: 420px;
+  max-height: 70vh;
+  min-height: 260px;
+  border-radius: 0.5rem;
+  border: 1px solid color-mix(in srgb, var(--mailoo-chat-brand) 18%, #e5e7eb);
+  background: #ffffff;
+  box-shadow:
+    var(--elev-raised, 0 20px 40px rgba(15, 23, 42, 0.18));
+  color: #111827;
+}
+
+html[data-theme='dark'] .mailoo-chat-panel {
+  border-color: color-mix(in srgb, var(--mailoo-chat-brand) 28%, #374151);
+  background: #111827;
+  color: #f9fafb;
+}
+
+.mailoo-chat-launcher {
+  position: relative;
+  display: inline-flex;
+  height: 3.5rem;
+  width: 3.5rem;
+  flex-shrink: 0;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  border-radius: 9999px;
+  background: var(--mailoo-chat-brand);
+  color: var(--mailoo-chat-brand-on);
+  box-shadow:
+    var(--elev-raised, 0 10px 24px rgba(15, 23, 42, 0.22));
+  cursor: pointer;
+  transition: opacity 0.15s ease, transform 0.15s ease;
+}
+
+.mailoo-chat-launcher:hover {
+  opacity: 0.92;
+  transform: translateY(-1px);
+}
+
+.mailoo-chat-launcher:focus-visible {
+  outline: 2px solid var(--mailoo-chat-brand);
+  outline-offset: 3px;
+}
+
+.mailoo-chat-launcher__icon {
+  height: 1.5rem;
+  width: 1.5rem;
+}
+
+.mailoo-chat-launcher__online {
+  position: absolute;
+  right: 0.2rem;
+  bottom: 0.2rem;
+  height: 0.7rem;
+  width: 0.7rem;
+  border-radius: 9999px;
+  border: 2px solid var(--mailoo-chat-brand);
+  background: #22c55e;
+  pointer-events: none;
+}
+
+.mailoo-chat-bubble--outbound {
+  background: color-mix(in srgb, var(--mailoo-chat-brand) 14%, #ffffff);
+}
+
+html[data-theme='dark'] .mailoo-chat-bubble--outbound {
+  background: color-mix(in srgb, var(--mailoo-chat-brand) 28%, #111827);
+}
+
+.mailoo-chat-bubble--inbound {
+  background: #f3f4f6;
+}
+
+html[data-theme='dark'] .mailoo-chat-bubble--inbound {
+  background: #1f2937;
+}