@mailoo/chat 0.0.0-stage → 1.32.2

package/LICENSE

@@ -0,0 +1,16 @@
+Mailoo Integrator Use License
+
+Copyright (c) 2026 Mailoo
+
+Permission is granted to use, install, and distribute this software in
+unmodified form, including as a dependency of an application.
+
+Modification of this software is not permitted.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,151 @@
-# Temporary Holding Version
+# `@mailoo/chat`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+JSBOX visitor chat: BFF route factories, headless hooks, and a floating widget.
+
+Install from npm together with `@mailoo/next-core`. Peer: `@heroicons/react`.
+Inside this monorepo, `apps/web` uses `workspace:*`.
+
+## Requirements
+
+- Env: `MAILOO_CHAT_INTEGRATION_{API,API_KEY,PROJECT_UID,ID}`
+- Optional: `MAILOO_CHAT_WS_ORIGIN` (public API host for WSS), `MAILOO_CHAT_WELCOME_MESSAGE`
+- Browser opens WebSocket **directly** to Mailoo API (`/api/v1/chat/visitor-ws`). Ingress must support Upgrade.
+
+## Routes (no Auth.js coupling)
+
+```ts
+import {
+  createChatSubmitHandler,
+  createChatMessagesHandler,
+  createChatStatusHandler,
+  createChatWidgetConfigHandler,
+} from '@mailoo/chat/routes'
+
+export const POST = createChatSubmitHandler({
+  // optional: inject session email
+  resolveSender: async () => {
+    const session = await auth()
+    return session?.user?.email
+      ? { email: session.user.email, name: session.user.name ?? undefined }
+      : null
+  },
+})
+
+export const GET = createChatMessagesHandler()
+```
+
+Status (optional): `createChatStatusHandler()` → `GET /api/v1/webhooks/chat/status`.
+Widget-config (optional BFF): `createChatWidgetConfigHandler()`.
+
+Config helpers from `@mailoo/chat`: `getMailooChatIntegrationConfig`,
+`getMailooChatWebSocketOrigin`, `fetchMailooChatIntegrationStatus`,
+`fetchMailooChatWidgetConfig` (null on failure), `resolveMailooChatHostConfig`.
+
+## Default floating widget (recommended)
+
+Server Component layout:
+
+```tsx
+import { resolveMailooChatHostConfig } from '@mailoo/chat'
+import { MailooSiteChatShell } from '@mailoo/chat/client'
+import { auth } from '@/auth'
+
+const session = await auth()
+const chat = await resolveMailooChatHostConfig({
+  locale,
+  isAuthenticated: Boolean(session?.user?.email),
+})
+
+{chat ? <MailooSiteChatShell chat={chat} /> : null}
+```
+
+`resolveMailooChatHostConfig` returns `null` when env is incomplete or
+widget-config cannot load (HTTP errors, network, invalid payload). It **never
+throws** — hosts must keep the page HTTP 200 and simply omit the chat shell.
+When resolve succeeds it **always** loads JSBOX `config.chatWidget` (brand,
+topics, position, welcome, privacy, operators) as `widgetConfig`. Call
+`openMailooSiteChat()` from any client component to open the panel.
+
+## Hooks
+
+```ts
+import {
+  useMailooChatSession,
+  useMailooChatSubmit,
+  useMailooChatMessages,
+  useMailooChatStatus,
+} from '@mailoo/chat/hooks'
+```
+
+`useMailooChatSession` owns session storage, guest profile, send, poll (`since`),
+and visitor WebSocket. Pass `enabled` to gate realtime (the widget uses panel open).
+
+## Widget (custom / headless UI)
+
+Host CSS **must** import the widget shell (position + launcher do not rely on
+host Tailwind scanning this package). Prefer a path PostCSS can resolve
+(monorepo relative or package export):
+
+```css
+/* monorepo */
+@import '../../../packages/chat/src/styles/widget.css';
+/* or published package */
+@import '@mailoo/chat/styles';
+/* Tailwind v4: also scan package sources if you style with utilities */
+@source '../node_modules/@mailoo/chat/src/**/*.{ts,tsx}';
+```
+
+```tsx
+import { MailooSiteChatWidget } from '@mailoo/chat/client'
+
+;<MailooSiteChatWidget
+  apiOrigin={wsOrigin}
+  projectUid={projectUid}
+  integrationId={integrationId}
+  welcomeMessage={welcome}
+  locale={locale}
+  isAuthenticated={isAuthenticated}
+  widgetConfig={widgetConfig}
+/>
+```
+
+Prefer `resolveMailooChatHostConfig` + `MailooSiteChatShell` so brand/topics are
+not omitted. For a custom UI, pass `widgetConfig` from
+`fetchMailooChatWidgetConfig` (or BFF `…/widget-config`). Brand colors
+(`brandPrimary` / `brandOnPrimary`), welcome title/tagline, topics, operators,
+and launcher `position` come from the JSBOX dashboard **Widget** tab.
+
+Optional: `className` / `panelClassName` / `launcherClassName`, controlled
+`open` / `onOpenChange`, `labels`, endpoint overrides, host `position`
+override (wins over `widgetConfig.position`), `zIndex`,
+`onSessionCreated` / `onMessageSent` / `onError` / `onFault`, and small render
+slots.
+
+### Chat unavailable / rate limit
+
+On submit or message poll, the package classifies **429** as `rate_limited` and
+network / **502** / **503** / other **5xx** as `unavailable`, stops polling, and
+shows a built-in panel (not raw API text). Pass an integrator action or custom
+UI via `MailooSiteChatShell` / `MailooSiteChatWidget`:
+
+```tsx
+<MailooSiteChatShell
+  chat={chat}
+  unavailableAction={{ type: 'mailto', email: 'support@example.com' }}
+  // or: { type: 'link', href: '/support', label: 'Contact support' }
+  // or: renderUnavailable={({ fault, labels, retry }) => …}
+/>
+```
+
+Headless: `useMailooChatSession` exposes `fault`, `onFault`, and
+`retryAfterFault`. Widget-config load still **fail-fast** before mount — this
+panel is only for post-mount send/poll failures.
+
+## Welcome presets
+
+- **Client barrel** `@mailoo/chat/welcome-presets` — Provider, Switcher, renderers
+  (`'use client'`). Safe to import as components from Server Components; do **not**
+  call exported functions from the server. Optional around `MailooSiteChatShell`.
+- **Server-safe parse** `@mailoo/chat/welcome-presets/parse` — `parseMailooChatWelcomePreset`
+  and related types only (no `'use client'`). Use this from RSC / env helpers
+  (e.g. `MAILOO_CHAT_WELCOME_PRESET`).

package/dist/chat-message-Dw6tKBEb.d.cts

@@ -0,0 +1,10 @@
+type MailooChatMessage = {
+    id: string;
+    messageType: string;
+    content: string;
+    senderEmail?: string | null;
+    senderName?: string | null;
+    createdAt: string;
+};
+
+export type { MailooChatMessage as M };

package/dist/chat-message-Dw6tKBEb.d.ts

@@ -0,0 +1,10 @@
+type MailooChatMessage = {
+    id: string;
+    messageType: string;
+    content: string;
+    senderEmail?: string | null;
+    senderName?: string | null;
+    createdAt: string;
+};
+
+export type { MailooChatMessage as M };

package/dist/chunk-2Y37RYEL.js

@@ -0,0 +1,141 @@
+// src/config.ts
+import { unstable_rethrow } from "next/navigation";
+import {
+  defaultMailooLogger,
+  readMailooIntegrationConfig
+} from "@mailoo/next-core";
+function getMailooChatIntegrationConfig() {
+  return readMailooIntegrationConfig({
+    prefix: "MAILOO_CHAT_INTEGRATION",
+    allowApiBaseUrlFallback: true
+  });
+}
+function getMailooChatWebSocketOrigin() {
+  const explicit = process.env.MAILOO_CHAT_WS_ORIGIN?.trim();
+  if (explicit) {
+    return explicit.replace(/\/$/, "");
+  }
+  const chatCfg = getMailooChatIntegrationConfig();
+  if (chatCfg?.apiBaseUrl) {
+    return chatCfg.apiBaseUrl.replace(/\/$/, "");
+  }
+  const chatApi = process.env.MAILOO_CHAT_INTEGRATION_API?.trim();
+  if (chatApi) {
+    return chatApi.replace(/\/$/, "");
+  }
+  const api = process.env.API_BASE_URL?.trim();
+  if (api) {
+    return api.replace(/\/$/, "");
+  }
+  return null;
+}
+async function fetchMailooChatIntegrationStatus() {
+  const cfg = getMailooChatIntegrationConfig();
+  if (!cfg) return null;
+  try {
+    const url = `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/status`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": cfg.apiKey
+      }
+    });
+    if (!response.ok) return null;
+    const data = await response.json();
+    if (typeof data.status !== "string" || typeof data.name !== "string" || typeof data.type !== "string" || typeof data.lastActivity !== "string") {
+      return null;
+    }
+    return {
+      status: data.status,
+      name: data.name,
+      type: data.type,
+      lastActivity: data.lastActivity
+    };
+  } catch (error) {
+    unstable_rethrow(error);
+    return null;
+  }
+}
+async function fetchMailooChatWidgetConfig(locale) {
+  const cfg = getMailooChatIntegrationConfig();
+  if (!cfg) {
+    return null;
+  }
+  try {
+    const url = new URL(
+      `${cfg.apiBaseUrl}/api/v1/webhooks/chat/${cfg.projectUid}/${cfg.integrationId}/widget-config`
+    );
+    url.searchParams.set("locale", locale);
+    const response = await fetch(url.toString(), {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": cfg.apiKey
+      }
+    });
+    if (!response.ok) {
+      defaultMailooLogger.warn?.(
+        `Failed to fetch chat widget config: HTTP ${response.status}`
+      );
+      return null;
+    }
+    const data = await response.json();
+    if (!data.widget || !Array.isArray(data.widget.topics)) {
+      defaultMailooLogger.warn?.(
+        "Failed to fetch chat widget config: invalid response (missing widget.topics)"
+      );
+      return null;
+    }
+    return {
+      ...data.widget,
+      topics: data.widget.topics,
+      operators: Array.isArray(data.widget.operators) ? data.widget.operators : []
+    };
+  } catch (error) {
+    unstable_rethrow(error);
+    defaultMailooLogger.logException?.(
+      error,
+      "Failed to fetch chat widget config"
+    );
+    return null;
+  }
+}
+async function resolveMailooChatHostConfig(opts) {
+  try {
+    const server = getMailooChatIntegrationConfig();
+    if (!server) return null;
+    const apiOrigin = getMailooChatWebSocketOrigin();
+    if (!apiOrigin) return null;
+    const locale = opts.locale.trim() || "en";
+    const widgetConfig = await fetchMailooChatWidgetConfig(locale);
+    if (!widgetConfig) return null;
+    const welcomeOverride = process.env.MAILOO_CHAT_WELCOME_MESSAGE?.trim();
+    const welcomeMessage = welcomeOverride || widgetConfig.welcomeTagline?.trim() || "";
+    return {
+      apiOrigin,
+      projectUid: server.projectUid,
+      integrationId: server.integrationId,
+      welcomeMessage,
+      locale,
+      isAuthenticated: Boolean(opts.isAuthenticated),
+      widgetConfig
+    };
+  } catch (error) {
+    unstable_rethrow(error);
+    defaultMailooLogger.logException?.(
+      error,
+      "resolveMailooChatHostConfig failed"
+    );
+    return null;
+  }
+}
+
+export {
+  getMailooChatIntegrationConfig,
+  getMailooChatWebSocketOrigin,
+  fetchMailooChatIntegrationStatus,
+  fetchMailooChatWidgetConfig,
+  resolveMailooChatHostConfig
+};
+//# sourceMappingURL=chunk-2Y37RYEL.js.map

package/dist/chunk-2Y37RYEL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["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":[]}

package/dist/chunk-4TNHJERE.js

@@ -0,0 +1,19 @@
+// src/welcome-presets/types.ts
+function parseMailooChatWelcomePreset(value) {
+  const trimmed = value?.trim();
+  if (trimmed === "builtin" || trimmed === "team" || trimmed === "assistant") {
+    return trimmed;
+  }
+  return null;
+}
+function normalizeLegacyWelcomePresetId(value) {
+  if (value === "delinea") return "team";
+  if (value === "mia") return "assistant";
+  return parseMailooChatWelcomePreset(value);
+}
+
+export {
+  parseMailooChatWelcomePreset,
+  normalizeLegacyWelcomePresetId
+};
+//# sourceMappingURL=chunk-4TNHJERE.js.map

package/dist/chunk-4TNHJERE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/welcome-presets/types.ts"],"sourcesContent":["export type MailooChatWelcomePresetId = 'builtin' | 'team' | 'assistant'\n\nexport type MailooChatWelcomePresetOption = {\n  id: MailooChatWelcomePresetId\n  label: string\n  description: string\n}\n\nexport function parseMailooChatWelcomePreset(\n  value: string | undefined | null\n): MailooChatWelcomePresetId | null {\n  const trimmed = value?.trim()\n  if (trimmed === 'builtin' || trimmed === 'team' || trimmed === 'assistant') {\n    return trimmed\n  }\n  return null\n}\n\n/** Maps legacy preset ids from earlier builds (localStorage only). */\nexport function normalizeLegacyWelcomePresetId(\n  value: string\n): MailooChatWelcomePresetId | null {\n  if (value === 'delinea') return 'team'\n  if (value === 'mia') return 'assistant'\n  return parseMailooChatWelcomePreset(value)\n}\n"],"mappings":";AAQO,SAAS,6BACd,OACkC;AAClC,QAAM,UAAU,OAAO,KAAK;AAC5B,MAAI,YAAY,aAAa,YAAY,UAAU,YAAY,aAAa;AAC1E,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAGO,SAAS,+BACd,OACkC;AAClC,MAAI,UAAU,UAAW,QAAO;AAChC,MAAI,UAAU,MAAO,QAAO;AAC5B,SAAO,6BAA6B,KAAK;AAC3C;","names":[]}

package/dist/chunk-77E6HUHY.js

@@ -0,0 +1,41 @@
+// src/lib/widget-config.ts
+var MAILOO_CHAT_LAUNCHER_POSITIONS = [
+  "bottom-right",
+  "bottom-left",
+  "top-right",
+  "top-left",
+  "middle-right",
+  "middle-left"
+];
+function isMailooChatLauncherPosition(value) {
+  return typeof value === "string" && MAILOO_CHAT_LAUNCHER_POSITIONS.includes(value);
+}
+function resolveMailooChatLauncherPosition(prop, config) {
+  if (prop) return prop;
+  if (config?.position && isMailooChatLauncherPosition(config.position)) {
+    return config.position;
+  }
+  return "bottom-right";
+}
+function mailooChatLauncherRootClassNames(position) {
+  const parts = ["mailoo-chat-root"];
+  if (position.endsWith("-left")) parts.push("mailoo-chat-root--left");
+  if (position.startsWith("top-")) parts.push("mailoo-chat-root--top");
+  if (position.startsWith("middle-")) parts.push("mailoo-chat-root--middle");
+  return parts.join(" ");
+}
+function chatWidgetCssVariables(config) {
+  return {
+    ["--mailoo-chat-brand"]: config?.brandPrimary ?? "#2563EB",
+    ["--mailoo-chat-brand-on"]: config?.brandOnPrimary ?? "#FFFFFF"
+  };
+}
+
+export {
+  MAILOO_CHAT_LAUNCHER_POSITIONS,
+  isMailooChatLauncherPosition,
+  resolveMailooChatLauncherPosition,
+  mailooChatLauncherRootClassNames,
+  chatWidgetCssVariables
+};
+//# sourceMappingURL=chunk-77E6HUHY.js.map

package/dist/chunk-77E6HUHY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/widget-config.ts"],"sourcesContent":["import type { CSSProperties } from 'react'\n\nexport type MailooChatWidgetTopic = {\n  id: string\n  label: string\n  action: 'start_chat' | 'external_url'\n  externalUrl?: string\n}\n\nexport type MailooChatWidgetOperator = {\n  userId: string\n  name: string | null\n  image: string | null\n  online: boolean\n}\n\nexport const MAILOO_CHAT_LAUNCHER_POSITIONS = [\n  'bottom-right',\n  'bottom-left',\n  'top-right',\n  'top-left',\n  'middle-right',\n  'middle-left',\n] as const\n\nexport type MailooChatLauncherPosition =\n  (typeof MAILOO_CHAT_LAUNCHER_POSITIONS)[number]\n\nexport type MailooChatWidgetConfig = {\n  brandPrimary?: string\n  brandOnPrimary?: string\n  welcomeTitle?: string\n  welcomeTagline?: string\n  privacyPolicyUrl?: string\n  position?: MailooChatLauncherPosition\n  topics: MailooChatWidgetTopic[]\n  operators: MailooChatWidgetOperator[]\n}\n\nexport function isMailooChatLauncherPosition(\n  value: unknown\n): value is MailooChatLauncherPosition {\n  return (\n    typeof value === 'string' &&\n    (MAILOO_CHAT_LAUNCHER_POSITIONS as readonly string[]).includes(value)\n  )\n}\n\nexport function resolveMailooChatLauncherPosition(\n  prop: MailooChatLauncherPosition | undefined,\n  config: Pick<MailooChatWidgetConfig, 'position'> | null | undefined\n): MailooChatLauncherPosition {\n  if (prop) return prop\n  if (config?.position && isMailooChatLauncherPosition(config.position)) {\n    return config.position\n  }\n  return 'bottom-right'\n}\n\nexport function mailooChatLauncherRootClassNames(\n  position: MailooChatLauncherPosition\n): string {\n  const parts = ['mailoo-chat-root']\n  if (position.endsWith('-left')) parts.push('mailoo-chat-root--left')\n  if (position.startsWith('top-')) parts.push('mailoo-chat-root--top')\n  if (position.startsWith('middle-')) parts.push('mailoo-chat-root--middle')\n  return parts.join(' ')\n}\n\nexport function chatWidgetCssVariables(\n  config: Pick<\n    MailooChatWidgetConfig,\n    'brandPrimary' | 'brandOnPrimary'\n  > | null | undefined\n): CSSProperties {\n  return {\n    ['--mailoo-chat-brand' as string]: config?.brandPrimary ?? '#2563EB',\n    ['--mailoo-chat-brand-on' as string]: config?.brandOnPrimary ?? '#FFFFFF',\n  }\n}\n"],"mappings":";AAgBO,IAAM,iCAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAgBO,SAAS,6BACd,OACqC;AACrC,SACE,OAAO,UAAU,YAChB,+BAAqD,SAAS,KAAK;AAExE;AAEO,SAAS,kCACd,MACA,QAC4B;AAC5B,MAAI,KAAM,QAAO;AACjB,MAAI,QAAQ,YAAY,6BAA6B,OAAO,QAAQ,GAAG;AACrE,WAAO,OAAO;AAAA,EAChB;AACA,SAAO;AACT;AAEO,SAAS,iCACd,UACQ;AACR,QAAM,QAAQ,CAAC,kBAAkB;AACjC,MAAI,SAAS,SAAS,OAAO,EAAG,OAAM,KAAK,wBAAwB;AACnE,MAAI,SAAS,WAAW,MAAM,EAAG,OAAM,KAAK,uBAAuB;AACnE,MAAI,SAAS,WAAW,SAAS,EAAG,OAAM,KAAK,0BAA0B;AACzE,SAAO,MAAM,KAAK,GAAG;AACvB;AAEO,SAAS,uBACd,QAIe;AACf,SAAO;AAAA,IACL,CAAC,qBAA+B,GAAG,QAAQ,gBAAgB;AAAA,IAC3D,CAAC,wBAAkC,GAAG,QAAQ,kBAAkB;AAAA,EAClE;AACF;","names":[]}