npm - @duvandroid/react-blind-agents - Versions diffs - 0.1.1 → 0.2.1 - Mend

@duvandroid/react-blind-agents 0.1.1 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md CHANGED Viewed

@@ -475,7 +475,14 @@ app.post('/webhooks/blind-agents', async (req, res) => {
     'ticket.created':        `🎫 *New ticket:* <${data.page_url}|${data.title}> — ${data.priority} priority`,
     'ticket.status_changed': `🔄 *Ticket updated:* ${data.title} → ${data.status}`,
     'ticket.resolved':       `✅ *Ticket resolved:* ${data.title}`,
+    'ticket.closed':         `🔒 *Ticket closed:* ${data.title}`,
     'contact.created':       `👤 *New contact:* ${data.name} (${data.email})`,
+    'contact.updated':       `✏️ *Contact updated:* ${data.name}`,
+    'contact.assigned':      `📋 *Contact assigned:* ${data.name}`,
+    'contact.tag_added':     `🏷️ *Tag added:* ${data.tag} → ${data.contact_id}`,
+    'contact.comment_added': `💬 *New comment on contact:* ${data.content}`,
+    'conversation.created':  `💬 *New conversation started*`,
+    'conversation.closed':   `🔒 *Conversation closed*`,
   };
   await fetch(SLACK_URL!, {
@@ -573,8 +580,11 @@ Add a **Respond to Webhook** node at the end — Response Code `200`. Without it
 | `ticket.created` | Create Jira / Linear issue |
 | `ticket.created` (high priority) | Send Gmail alert to on-call |
 | `ticket.resolved` | Append row to Google Sheet |
-| `contact.created` | Sync contact to HubSpot / Mailchimp |
 | `ticket.status_changed` | Update Notion database row |
+| `contact.created` | Sync contact to HubSpot / Mailchimp |
+| `contact.tag_added` | Enroll contact in an email sequence |
+| `contact.comment_added` | Log internal notes to Notion |
+| `conversation.closed` | Trigger a CSAT survey email |
 | Any event | POST to Zapier catch hook for further routing |
 ### Self-hosting n8n with Docker
@@ -603,15 +613,74 @@ Every event sends this JSON body:
   "id": "evt_01HXYZ...",
   "event": "ticket.created",
   "created_at": "2026-04-09T03:00:00Z",
-  "data": {
-    "id": "tkt_01HXYZ...",
-    "title": "Button not working on checkout",
-    "status": "open",
-    "priority": "high",
-    "type": "bug",
-    "contact": { "name": "Jane Doe", "email": "jane@example.com" },
-    "page_url": "https://yoursite.com/checkout"
-  }
+  "data": { ... }
+}
+```
+The `data` shape depends on the event type:
+**Ticket events** (`ticket.created`, `ticket.status_changed`, `ticket.resolved`, `ticket.closed`)
+```json
+{
+  "id": "uuid",
+  "org_id": "uuid",
+  "contact_id": "uuid or null",
+  "title": "Button not working on checkout",
+  "description": "Steps to reproduce...",
+  "status": "open",
+  "priority": "high",
+  "type": "bug",
+  "page_url": "https://yoursite.com/checkout",
+  "created_at": "2026-04-09T03:00:00+00:00",
+  "updated_at": "2026-04-09T03:00:00+00:00"
+}
+```
+For `ticket.status_changed`, `ticket.resolved`, and `ticket.closed`, the payload also includes:
+```json
+{
+  "previous_status": "open",
+  "changed_by_id": "uuid or null"
+}
+```
+**Contact events** (`contact.created`, `contact.updated`, `contact.assigned`)
+```json
+{
+  "contact_id": "uuid",
+  "email": "jane@example.com",
+  "name": "Jane Doe",
+  "phone": "1234567890"
+}
+```
+For `contact.assigned`, the payload also includes:
+```json
+{
+  "assigned_to_id": "uuid or null"
+}
+```
+**Contact tag events** (`contact.tag_added`, `contact.tag_removed`)
+```json
+{
+  "contact_id": "uuid",
+  "tag": "vip"
+}
+```
+**Contact comment event** (`contact.comment_added`)
+```json
+{
+  "contact_id": "uuid",
+  "comment_id": "uuid",
+  "author_id": "uuid",
+  "content": "Followed up via email."
 }
 ```
@@ -620,11 +689,17 @@ Every event sends this JSON body:
 | Event | Fired when |
 |---|---|
 | `ticket.created` | A new ticket is submitted |
-| `ticket.status_changed` | Ticket status is updated |
+| `ticket.status_changed` | Ticket status is updated (any change) |
 | `ticket.resolved` | Ticket is marked resolved |
 | `ticket.closed` | Ticket is closed |
 | `contact.created` | A new contact is registered |
+| `contact.updated` | Contact profile fields are edited |
+| `contact.assigned` | Contact is assigned to a team member |
+| `contact.tag_added` | A tag is added to a contact |
+| `contact.tag_removed` | A tag is removed from a contact |
+| `contact.comment_added` | An internal comment is posted on a contact |
 | `conversation.created` | A new chat conversation starts |
+| `conversation.closed` | A conversation is closed |
 ---

package/dist/index.d.mts CHANGED Viewed

@@ -1,30 +1,70 @@
-interface BlindAgentsWidgetProps {
+import * as react_jsx_runtime from 'react/jsx-runtime';
+/** Common props shared by all widget types. */
+interface BaseWidgetProps {
     /** Your Blind Agents public API key (ba_...) */
     apiKey: string;
+    /** Pre-filled WhatsApp number to skip identity verification */
+    userWhatsapp?: string;
+    /** Override the CDN base URL (useful for self-hosting) */
+    cdnBase?: string;
+    /** Script loading strategy @default "afterInteractive" */
+    strategy?: 'afterInteractive' | 'lazyOnload' | 'beforeInteractive';
+    /** Called once the script finishes loading */
+    onLoad?: () => void;
+    /** Called if the script fails to load */
+    onError?: (error: Error) => void;
+}
+/** Report / bug-reporter widget */
+interface ReportWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
     /** Accent color for the widget UI — any valid CSS color */
     primaryColor?: string;
     /** Title displayed in the widget panel header @default "Help Center" */
     title?: string;
     /** Label for the report button @default "Report an issue" */
     reportBtnText?: string;
-    /** Emoji on the launcher floating button */
+    /** Emoji on the launcher floating button @default "🐛" */
     btnEmoji?: string;
     /** Tooltip on the launcher button */
     btnTooltip?: string;
     /** Text shown when there are no reports @default "No issues reported yet." */
     emptyText?: string;
-    /** Pre-fill the user's WhatsApp number or email to skip identity verification */
-    userWhatsapp?: string;
-    /** Script loading strategy @default "afterInteractive" */
-    strategy?: 'afterInteractive' | 'lazyOnload' | 'beforeInteractive';
-    /** Override the CDN URL (useful for self-hosting) @default "https://cdn.blindagents.com/report.js" */
+}
+/** Webchat widget */
+interface ChatWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
+    /** The agent UUID to connect this chat to */
+    agentId?: string;
+    /** Accent color for the chat bubble and header */
+    primaryColor?: string;
+}
+/** Product guides widget */
+interface GuideWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
+}
+/** Root provider props — all children share this apiKey */
+interface BlindAgentsProps extends BaseWidgetProps {
+    children: React.ReactNode;
+}
+/** @deprecated Use <BlindAgents apiKey="..."><BlindAgents.Report /></BlindAgents> instead */
+interface BlindAgentsWidgetProps extends BaseWidgetProps {
+    primaryColor?: string;
+    title?: string;
+    reportBtnText?: string;
+    btnEmoji?: string;
+    btnTooltip?: string;
+    emptyText?: string;
+    /** @deprecated Prefer userWhatsapp */
     src?: string;
-    /** Called once the script finishes loading */
-    onLoad?: () => void;
-    /** Called if the script fails to load */
-    onError?: (error: Error) => void;
 }
-declare function BlindAgentsWidget({ apiKey, primaryColor, title, reportBtnText, btnEmoji, btnTooltip, emptyText, userWhatsapp, strategy, src, onLoad, onError, }: BlindAgentsWidgetProps): null;
+declare function BlindAgents({ apiKey, userWhatsapp, cdnBase, strategy, children, }: BlindAgentsProps): react_jsx_runtime.JSX.Element;
+declare namespace BlindAgents {
+    var Report: ({ primaryColor, title, reportBtnText, btnEmoji, btnTooltip, emptyText, userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: ReportWidgetProps) => null;
+    var Chat: ({ agentId, primaryColor, userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: ChatWidgetProps) => null;
+    var Guide: ({ userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: GuideWidgetProps) => null;
+}
+/** @deprecated Use <BlindAgents><BlindAgents.Report /></BlindAgents> */
+declare function BlindAgentsWidget(props: ReportWidgetProps & {
+    apiKey: string;
+}): react_jsx_runtime.JSX.Element;
-export { BlindAgentsWidget, type BlindAgentsWidgetProps };
+export { BlindAgents, type BlindAgentsProps, BlindAgentsWidget, type BlindAgentsWidgetProps, type ChatWidgetProps, type GuideWidgetProps, type ReportWidgetProps };

package/dist/index.d.ts CHANGED Viewed

@@ -1,30 +1,70 @@
-interface BlindAgentsWidgetProps {
+import * as react_jsx_runtime from 'react/jsx-runtime';
+/** Common props shared by all widget types. */
+interface BaseWidgetProps {
     /** Your Blind Agents public API key (ba_...) */
     apiKey: string;
+    /** Pre-filled WhatsApp number to skip identity verification */
+    userWhatsapp?: string;
+    /** Override the CDN base URL (useful for self-hosting) */
+    cdnBase?: string;
+    /** Script loading strategy @default "afterInteractive" */
+    strategy?: 'afterInteractive' | 'lazyOnload' | 'beforeInteractive';
+    /** Called once the script finishes loading */
+    onLoad?: () => void;
+    /** Called if the script fails to load */
+    onError?: (error: Error) => void;
+}
+/** Report / bug-reporter widget */
+interface ReportWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
     /** Accent color for the widget UI — any valid CSS color */
     primaryColor?: string;
     /** Title displayed in the widget panel header @default "Help Center" */
     title?: string;
     /** Label for the report button @default "Report an issue" */
     reportBtnText?: string;
-    /** Emoji on the launcher floating button */
+    /** Emoji on the launcher floating button @default "🐛" */
     btnEmoji?: string;
     /** Tooltip on the launcher button */
     btnTooltip?: string;
     /** Text shown when there are no reports @default "No issues reported yet." */
     emptyText?: string;
-    /** Pre-fill the user's WhatsApp number or email to skip identity verification */
-    userWhatsapp?: string;
-    /** Script loading strategy @default "afterInteractive" */
-    strategy?: 'afterInteractive' | 'lazyOnload' | 'beforeInteractive';
-    /** Override the CDN URL (useful for self-hosting) @default "https://cdn.blindagents.com/report.js" */
+}
+/** Webchat widget */
+interface ChatWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
+    /** The agent UUID to connect this chat to */
+    agentId?: string;
+    /** Accent color for the chat bubble and header */
+    primaryColor?: string;
+}
+/** Product guides widget */
+interface GuideWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
+}
+/** Root provider props — all children share this apiKey */
+interface BlindAgentsProps extends BaseWidgetProps {
+    children: React.ReactNode;
+}
+/** @deprecated Use <BlindAgents apiKey="..."><BlindAgents.Report /></BlindAgents> instead */
+interface BlindAgentsWidgetProps extends BaseWidgetProps {
+    primaryColor?: string;
+    title?: string;
+    reportBtnText?: string;
+    btnEmoji?: string;
+    btnTooltip?: string;
+    emptyText?: string;
+    /** @deprecated Prefer userWhatsapp */
     src?: string;
-    /** Called once the script finishes loading */
-    onLoad?: () => void;
-    /** Called if the script fails to load */
-    onError?: (error: Error) => void;
 }
-declare function BlindAgentsWidget({ apiKey, primaryColor, title, reportBtnText, btnEmoji, btnTooltip, emptyText, userWhatsapp, strategy, src, onLoad, onError, }: BlindAgentsWidgetProps): null;
+declare function BlindAgents({ apiKey, userWhatsapp, cdnBase, strategy, children, }: BlindAgentsProps): react_jsx_runtime.JSX.Element;
+declare namespace BlindAgents {
+    var Report: ({ primaryColor, title, reportBtnText, btnEmoji, btnTooltip, emptyText, userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: ReportWidgetProps) => null;
+    var Chat: ({ agentId, primaryColor, userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: ChatWidgetProps) => null;
+    var Guide: ({ userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: GuideWidgetProps) => null;
+}
+/** @deprecated Use <BlindAgents><BlindAgents.Report /></BlindAgents> */
+declare function BlindAgentsWidget(props: ReportWidgetProps & {
+    apiKey: string;
+}): react_jsx_runtime.JSX.Element;
-export { BlindAgentsWidget, type BlindAgentsWidgetProps };
+export { BlindAgents, type BlindAgentsProps, BlindAgentsWidget, type BlindAgentsWidgetProps, type ChatWidgetProps, type GuideWidgetProps, type ReportWidgetProps };

package/dist/index.js CHANGED Viewed

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,51 +17,54 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  BlindAgents: () => BlindAgents,
   BlindAgentsWidget: () => BlindAgentsWidget
 });
 module.exports = __toCommonJS(src_exports);
-// src/ReactBlindAgentsWidget.tsx
+// src/ReactBlindAgents.tsx
+var import_react2 = __toESM(require("react"));
+// src/context.ts
 var import_react = require("react");
-var CDN_DEFAULT = "https://cdn.blindagents.com/report.js";
-function BlindAgentsWidget({
-  apiKey,
-  primaryColor,
-  title,
-  reportBtnText,
-  btnEmoji,
-  btnTooltip,
-  emptyText,
-  userWhatsapp,
-  strategy = "afterInteractive",
-  src = CDN_DEFAULT,
-  onLoad,
-  onError
-}) {
-  const injected = (0, import_react.useRef)(false);
-  (0, import_react.useEffect)(() => {
+// src/types.ts
+var CDN_BASE = "https://cdn.blindagents.com";
+// src/context.ts
+var BlindAgentsContext = (0, import_react.createContext)({
+  apiKey: "",
+  cdnBase: CDN_BASE,
+  strategy: "afterInteractive"
+});
+// src/ReactBlindAgents.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function useScript(src, attrs, strategy, onLoad, onError) {
+  const injected = (0, import_react2.useRef)(false);
+  (0, import_react2.useEffect)(() => {
     if (injected.current) return;
     injected.current = true;
-    const existing = document.querySelector(
-      `script[src="${src}"][data-ba-managed]`
-    );
-    if (existing) return;
+    if (document.querySelector(`script[src="${src}"][data-ba-managed]`)) return;
     const el = document.createElement("script");
     el.src = src;
     el.setAttribute("data-ba-managed", "true");
-    el.setAttribute("data-api-key", apiKey);
-    if (primaryColor) el.setAttribute("data-primary-color", primaryColor);
-    if (title) el.setAttribute("data-title", title);
-    if (reportBtnText) el.setAttribute("data-report-btn-text", reportBtnText);
-    if (btnEmoji) el.setAttribute("data-btn-emoji", btnEmoji);
-    if (btnTooltip) el.setAttribute("data-btn-tooltip", btnTooltip);
-    if (emptyText) el.setAttribute("data-empty-text", emptyText);
-    if (userWhatsapp) el.setAttribute("data-user-whatsapp", userWhatsapp);
+    Object.entries(attrs).forEach(([k, v]) => {
+      if (v != null && v !== "") el.setAttribute(k, v);
+    });
     if (onLoad) el.addEventListener("load", () => onLoad());
     if (onError) el.addEventListener("error", () => onError(new Error(`Failed to load ${src}`)));
     const inject = () => {
@@ -67,7 +72,7 @@ function BlindAgentsWidget({
       if (strategy === "lazyOnload") el.async = true;
       document.head.appendChild(el);
     };
-    if (strategy === "lazyOnload" && typeof window !== "undefined" && "requestIdleCallback" in window) {
+    if (strategy === "lazyOnload" && "requestIdleCallback" in window) {
       window.requestIdleCallback(inject);
     } else {
       inject();
@@ -76,11 +81,90 @@ function BlindAgentsWidget({
       el.parentNode?.removeChild(el);
       injected.current = false;
     };
-  }, [apiKey, src]);
+  }, [src]);
+}
+function Report({
+  primaryColor,
+  title,
+  reportBtnText,
+  btnEmoji,
+  btnTooltip,
+  emptyText,
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = import_react2.default.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/report.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp;
+  useScript(src, {
+    "data-api-key": ctx.apiKey,
+    "data-primary-color": primaryColor,
+    "data-title": title,
+    "data-report-btn-text": reportBtnText,
+    "data-btn-emoji": btnEmoji,
+    "data-btn-tooltip": btnTooltip,
+    "data-empty-text": emptyText,
+    "data-user-whatsapp": wa
+  }, localStrategy ?? ctx.strategy, onLoad, onError);
+  return null;
+}
+function Chat({
+  agentId,
+  primaryColor,
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = import_react2.default.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/chat.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp;
+  useScript(src, {
+    "data-api-key": ctx.apiKey,
+    "data-agent-id": agentId,
+    "data-primary-color": primaryColor,
+    "data-user-whatsapp": wa
+  }, localStrategy ?? ctx.strategy, onLoad, onError);
   return null;
 }
+function Guide({
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = import_react2.default.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/guide.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp;
+  useScript(src, {
+    "data-api-key": ctx.apiKey,
+    "data-user-whatsapp": wa
+  }, localStrategy ?? ctx.strategy, onLoad, onError);
+  return null;
+}
+function BlindAgents({
+  apiKey,
+  userWhatsapp,
+  cdnBase = CDN_BASE,
+  strategy = "afterInteractive",
+  children
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(BlindAgentsContext.Provider, { value: { apiKey, userWhatsapp, cdnBase, strategy }, children });
+}
+BlindAgents.Report = Report;
+BlindAgents.Chat = Chat;
+BlindAgents.Guide = Guide;
+function BlindAgentsWidget(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(BlindAgents, { apiKey: props.apiKey, userWhatsapp: props.userWhatsapp, strategy: props.strategy, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Report, { ...props }) });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BlindAgents,
   BlindAgentsWidget
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/ReactBlindAgentsWidget.tsx"],"sourcesContent":["// Plain React entry — Vite, CRA, etc.\n// For Next.js use: import { BlindAgentsWidget } from 'react-blind-agents/next'\nexport { BlindAgentsWidget } from './ReactBlindAgentsWidget';\nexport type { BlindAgentsWidgetProps } from './types';\n","'use client';\n\nimport { useEffect, useRef } from 'react';\nimport type { BlindAgentsWidgetProps } from './types';\n\nconst CDN_DEFAULT = 'https://cdn.blindagents.com/report.js';\n\nexport function BlindAgentsWidget({\n apiKey,\n primaryColor,\n title,\n reportBtnText,\n btnEmoji,\n btnTooltip,\n emptyText,\n userWhatsapp,\n strategy = 'afterInteractive',\n src = CDN_DEFAULT,\n onLoad,\n onError,\n}: BlindAgentsWidgetProps) {\n const injected = useRef(false);\n\n useEffect(() => {\n if (injected.current) return;\n injected.current = true;\n\n // Deduplicate across multiple widget instances\n const existing = document.querySelector<HTMLScriptElement>(\n `script[src=\"${src}\"][data-ba-managed]`\n );\n if (existing) return;\n\n const el = document.createElement('script');\n el.src = src;\n el.setAttribute('data-ba-managed', 'true');\n el.setAttribute('data-api-key', apiKey);\n if (primaryColor) el.setAttribute('data-primary-color', primaryColor);\n if (title) el.setAttribute('data-title', title);\n if (reportBtnText) el.setAttribute('data-report-btn-text', reportBtnText);\n if (btnEmoji) el.setAttribute('data-btn-emoji', btnEmoji);\n if (btnTooltip) el.setAttribute('data-btn-tooltip', btnTooltip);\n if (emptyText) el.setAttribute('data-empty-text', emptyText);\n if (userWhatsapp) el.setAttribute('data-user-whatsapp', userWhatsapp);\n\n if (onLoad) el.addEventListener('load', () => onLoad());\n if (onError) el.addEventListener('error', () => onError(new Error(`Failed to load ${src}`)));\n\n const inject = () => {\n if (strategy === 'afterInteractive') el.defer = true;\n if (strategy === 'lazyOnload') el.async = true;\n document.head.appendChild(el);\n };\n\n if (strategy === 'lazyOnload' && typeof window !== 'undefined' && 'requestIdleCallback' in window) {\n (window as Window & { requestIdleCallback: (cb: () => void) => void }).requestIdleCallback(inject);\n } else {\n inject();\n }\n\n return () => {\n el.parentNode?.removeChild(el);\n injected.current = false;\n };\n }, [apiKey, src]); // eslint-disable-line react-hooks/exhaustive-deps\n\n return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,mBAAkC;AAGlC,IAAM,cAAc;AAEb,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,MAAM;AAAA,EACN;AAAA,EACA;AACF,GAA2B;AACzB,QAAM,eAAW,qBAAO,KAAK;AAE7B,8BAAU,MAAM;AACd,QAAI,SAAS,QAAS;AACtB,aAAS,UAAU;AAGnB,UAAM,WAAW,SAAS;AAAA,MACxB,eAAe,GAAG;AAAA,IACpB;AACA,QAAI,SAAU;AAEd,UAAM,KAAK,SAAS,cAAc,QAAQ;AAC1C,OAAG,MAAM;AACT,OAAG,aAAa,mBAAmB,MAAM;AACzC,OAAG,aAAa,gBAAgB,MAAM;AACtC,QAAI,aAAe,IAAG,aAAa,sBAAsB,YAAY;AACrE,QAAI,MAAe,IAAG,aAAa,cAAc,KAAK;AACtD,QAAI,cAAe,IAAG,aAAa,wBAAwB,aAAa;AACxE,QAAI,SAAe,IAAG,aAAa,kBAAkB,QAAQ;AAC7D,QAAI,WAAe,IAAG,aAAa,oBAAoB,UAAU;AACjE,QAAI,UAAe,IAAG,aAAa,mBAAmB,SAAS;AAC/D,QAAI,aAAe,IAAG,aAAa,sBAAsB,YAAY;AAErE,QAAI,OAAS,IAAG,iBAAiB,QAAQ,MAAM,OAAO,CAAC;AACvD,QAAI,QAAS,IAAG,iBAAiB,SAAS,MAAM,QAAQ,IAAI,MAAM,kBAAkB,GAAG,EAAE,CAAC,CAAC;AAE3F,UAAM,SAAS,MAAM;AACnB,UAAI,aAAa,mBAAoB,IAAG,QAAQ;AAChD,UAAI,aAAa,aAAoB,IAAG,QAAQ;AAChD,eAAS,KAAK,YAAY,EAAE;AAAA,IAC9B;AAEA,QAAI,aAAa,gBAAgB,OAAO,WAAW,eAAe,yBAAyB,QAAQ;AACjG,MAAC,OAAsE,oBAAoB,MAAM;AAAA,IACnG,OAAO;AACL,aAAO;AAAA,IACT;AAEA,WAAO,MAAM;AACX,SAAG,YAAY,YAAY,EAAE;AAC7B,eAAS,UAAU;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,QAAQ,GAAG,CAAC;AAEhB,SAAO;AACT;","names":[]}
1	+ {"version":3,"sources":["../src/index.ts","../src/ReactBlindAgents.tsx","../src/context.ts","../src/types.ts"],"sourcesContent":["// Plain React entry — Vite, CRA, Remix, etc.\n// For Next.js use: import { BlindAgents } from '@duvandroid/react-blind-agents/next'\nexport { BlindAgents, BlindAgentsWidget } from './ReactBlindAgents';\nexport type {\n BlindAgentsProps,\n ReportWidgetProps,\n ChatWidgetProps,\n GuideWidgetProps,\n BlindAgentsWidgetProps,\n} from './types';\n","'use client';\n\nimport React, { useEffect, useRef } from 'react';\nimport { BlindAgentsContext } from './context';\nimport type {\n BlindAgentsProps,\n ReportWidgetProps,\n ChatWidgetProps,\n GuideWidgetProps,\n} from './types';\nimport { CDN_BASE } from './types';\n\n// ── Script injection helper ───────────────────────────────────────────────────\n\nfunction useScript(\n src: string,\n attrs: Record<string, string \| undefined>,\n strategy: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive',\n onLoad?: () => void,\n onError?: (e: Error) => void,\n) {\n const injected = useRef(false);\n\n useEffect(() => {\n if (injected.current) return;\n injected.current = true;\n\n // Deduplicate — only one script per src\n if (document.querySelector(`script[src=\"${src}\"][data-ba-managed]`)) return;\n\n const el = document.createElement('script');\n el.src = src;\n el.setAttribute('data-ba-managed', 'true');\n Object.entries(attrs).forEach(([k, v]) => {\n if (v != null && v !== '') el.setAttribute(k, v);\n });\n\n if (onLoad) el.addEventListener('load', () => onLoad());\n if (onError) el.addEventListener('error', () => onError(new Error(`Failed to load ${src}`)));\n\n const inject = () => {\n if (strategy === 'afterInteractive') el.defer = true;\n if (strategy === 'lazyOnload') el.async = true;\n document.head.appendChild(el);\n };\n\n if (strategy === 'lazyOnload' && 'requestIdleCallback' in window) {\n (window as any).requestIdleCallback(inject);\n } else {\n inject();\n }\n\n return () => { el.parentNode?.removeChild(el); injected.current = false; };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [src]);\n}\n\n// ── Widget sub-components ─────────────────────────────────────────────────────\n\nfunction Report({\n primaryColor,\n title,\n reportBtnText,\n btnEmoji,\n btnTooltip,\n emptyText,\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: ReportWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/report.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp;\n\n useScript(src, {\n 'data-api-key': ctx.apiKey,\n 'data-primary-color': primaryColor,\n 'data-title': title,\n 'data-report-btn-text': reportBtnText,\n 'data-btn-emoji': btnEmoji,\n 'data-btn-tooltip': btnTooltip,\n 'data-empty-text': emptyText,\n 'data-user-whatsapp': wa,\n }, localStrategy ?? ctx.strategy, onLoad, onError);\n\n return null;\n}\n\nfunction Chat({\n agentId,\n primaryColor,\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: ChatWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/chat.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp;\n\n useScript(src, {\n 'data-api-key': ctx.apiKey,\n 'data-agent-id': agentId,\n 'data-primary-color': primaryColor,\n 'data-user-whatsapp': wa,\n }, localStrategy ?? ctx.strategy, onLoad, onError);\n\n return null;\n}\n\nfunction Guide({\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: GuideWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/guide.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp;\n\n useScript(src, {\n 'data-api-key': ctx.apiKey,\n 'data-user-whatsapp': wa,\n }, localStrategy ?? ctx.strategy, onLoad, onError);\n\n return null;\n}\n\n// ── Root provider ─────────────────────────────────────────────────────────────\n\nexport function BlindAgents({\n apiKey,\n userWhatsapp,\n cdnBase = CDN_BASE,\n strategy = 'afterInteractive',\n children,\n}: BlindAgentsProps) {\n return (\n <BlindAgentsContext.Provider value={{ apiKey, userWhatsapp, cdnBase, strategy }}>\n {children}\n </BlindAgentsContext.Provider>\n );\n}\n\nBlindAgents.Report = Report;\nBlindAgents.Chat = Chat;\nBlindAgents.Guide = Guide;\n\n// ── Legacy single-widget export (backwards compat) ───────────────────────────\n/** @deprecated Use <BlindAgents><BlindAgents.Report /></BlindAgents> /\nexport function BlindAgentsWidget(props: ReportWidgetProps & { apiKey: string }) {\n return (\n <BlindAgents apiKey={props.apiKey} userWhatsapp={props.userWhatsapp} strategy={props.strategy}>\n <Report {...props} />\n </BlindAgents>\n );\n}\n","import { createContext, useContext } from 'react';\nimport { CDN_BASE } from './types';\n\nexport interface BlindAgentsContextValue {\n apiKey: string;\n userWhatsapp?: string;\n cdnBase: string;\n strategy: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive';\n}\n\nexport const BlindAgentsContext = createContext<BlindAgentsContextValue>({\n apiKey: '',\n cdnBase: CDN_BASE,\n strategy: 'afterInteractive',\n});\n\nexport function useBlindAgents(): BlindAgentsContextValue {\n return useContext(BlindAgentsContext);\n}\n","const CDN_BASE = 'https://cdn.blindagents.com';\n\nexport { CDN_BASE };\n\n/* Common props shared by all widget types. /\nexport interface BaseWidgetProps {\n /* Your Blind Agents public API key (ba_...) /\n apiKey: string;\n /* Pre-filled WhatsApp number to skip identity verification /\n userWhatsapp?: string;\n /* Override the CDN base URL (useful for self-hosting) /\n cdnBase?: string;\n /* Script loading strategy @default \"afterInteractive\" /\n strategy?: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive';\n /* Called once the script finishes loading /\n onLoad?: () => void;\n /* Called if the script fails to load /\n onError?: (error: Error) => void;\n}\n\n/* Report / bug-reporter widget /\nexport interface ReportWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n /* Accent color for the widget UI — any valid CSS color /\n primaryColor?: string;\n /* Title displayed in the widget panel header @default \"Help Center\" /\n title?: string;\n /* Label for the report button @default \"Report an issue\" /\n reportBtnText?: string;\n /* Emoji on the launcher floating button @default \"🐛\" /\n btnEmoji?: string;\n /* Tooltip on the launcher button /\n btnTooltip?: string;\n /* Text shown when there are no reports @default \"No issues reported yet.\" /\n emptyText?: string;\n}\n\n/* Webchat widget /\nexport interface ChatWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n /* The agent UUID to connect this chat to /\n agentId?: string;\n /* Accent color for the chat bubble and header /\n primaryColor?: string;\n}\n\n/* Product guides widget /\nexport interface GuideWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n // No additional props yet — the guide SDK reads config from the dashboard\n}\n\n/* Root provider props — all children share this apiKey /\nexport interface BlindAgentsProps extends BaseWidgetProps {\n children: React.ReactNode;\n}\n\n// ── Legacy single-widget props (kept for backwards compatibility) ──────────────\n/* @deprecated Use <BlindAgents apiKey=\"...\"><BlindAgents.Report /></BlindAgents> instead /\nexport interface BlindAgentsWidgetProps extends BaseWidgetProps {\n primaryColor?: string;\n title?: string;\n reportBtnText?: string;\n btnEmoji?: string;\n btnTooltip?: string;\n emptyText?: string;\n /* @deprecated Prefer userWhatsapp */\n src?: string;\n}\n"],"mappings":"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","names":["import_react","React"]}

package/dist/index.mjs CHANGED Viewed

@@ -1,39 +1,33 @@
-// src/ReactBlindAgentsWidget.tsx
-import { useEffect, useRef } from "react";
-var CDN_DEFAULT = "https://cdn.blindagents.com/report.js";
-function BlindAgentsWidget({
-  apiKey,
-  primaryColor,
-  title,
-  reportBtnText,
-  btnEmoji,
-  btnTooltip,
-  emptyText,
-  userWhatsapp,
-  strategy = "afterInteractive",
-  src = CDN_DEFAULT,
-  onLoad,
-  onError
-}) {
+// src/ReactBlindAgents.tsx
+import React, { useEffect, useRef } from "react";
+// src/context.ts
+import { createContext, useContext } from "react";
+// src/types.ts
+var CDN_BASE = "https://cdn.blindagents.com";
+// src/context.ts
+var BlindAgentsContext = createContext({
+  apiKey: "",
+  cdnBase: CDN_BASE,
+  strategy: "afterInteractive"
+});
+// src/ReactBlindAgents.tsx
+import { jsx } from "react/jsx-runtime";
+function useScript(src, attrs, strategy, onLoad, onError) {
   const injected = useRef(false);
   useEffect(() => {
     if (injected.current) return;
     injected.current = true;
-    const existing = document.querySelector(
-      `script[src="${src}"][data-ba-managed]`
-    );
-    if (existing) return;
+    if (document.querySelector(`script[src="${src}"][data-ba-managed]`)) return;
     const el = document.createElement("script");
     el.src = src;
     el.setAttribute("data-ba-managed", "true");
-    el.setAttribute("data-api-key", apiKey);
-    if (primaryColor) el.setAttribute("data-primary-color", primaryColor);
-    if (title) el.setAttribute("data-title", title);
-    if (reportBtnText) el.setAttribute("data-report-btn-text", reportBtnText);
-    if (btnEmoji) el.setAttribute("data-btn-emoji", btnEmoji);
-    if (btnTooltip) el.setAttribute("data-btn-tooltip", btnTooltip);
-    if (emptyText) el.setAttribute("data-empty-text", emptyText);
-    if (userWhatsapp) el.setAttribute("data-user-whatsapp", userWhatsapp);
+    Object.entries(attrs).forEach(([k, v]) => {
+      if (v != null && v !== "") el.setAttribute(k, v);
+    });
     if (onLoad) el.addEventListener("load", () => onLoad());
     if (onError) el.addEventListener("error", () => onError(new Error(`Failed to load ${src}`)));
     const inject = () => {
@@ -41,7 +35,7 @@ function BlindAgentsWidget({
       if (strategy === "lazyOnload") el.async = true;
       document.head.appendChild(el);
     };
-    if (strategy === "lazyOnload" && typeof window !== "undefined" && "requestIdleCallback" in window) {
+    if (strategy === "lazyOnload" && "requestIdleCallback" in window) {
       window.requestIdleCallback(inject);
     } else {
       inject();
@@ -50,10 +44,89 @@ function BlindAgentsWidget({
       el.parentNode?.removeChild(el);
       injected.current = false;
     };
-  }, [apiKey, src]);
+  }, [src]);
+}
+function Report({
+  primaryColor,
+  title,
+  reportBtnText,
+  btnEmoji,
+  btnTooltip,
+  emptyText,
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = React.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/report.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp;
+  useScript(src, {
+    "data-api-key": ctx.apiKey,
+    "data-primary-color": primaryColor,
+    "data-title": title,
+    "data-report-btn-text": reportBtnText,
+    "data-btn-emoji": btnEmoji,
+    "data-btn-tooltip": btnTooltip,
+    "data-empty-text": emptyText,
+    "data-user-whatsapp": wa
+  }, localStrategy ?? ctx.strategy, onLoad, onError);
+  return null;
+}
+function Chat({
+  agentId,
+  primaryColor,
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = React.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/chat.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp;
+  useScript(src, {
+    "data-api-key": ctx.apiKey,
+    "data-agent-id": agentId,
+    "data-primary-color": primaryColor,
+    "data-user-whatsapp": wa
+  }, localStrategy ?? ctx.strategy, onLoad, onError);
   return null;
 }
+function Guide({
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = React.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/guide.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp;
+  useScript(src, {
+    "data-api-key": ctx.apiKey,
+    "data-user-whatsapp": wa
+  }, localStrategy ?? ctx.strategy, onLoad, onError);
+  return null;
+}
+function BlindAgents({
+  apiKey,
+  userWhatsapp,
+  cdnBase = CDN_BASE,
+  strategy = "afterInteractive",
+  children
+}) {
+  return /* @__PURE__ */ jsx(BlindAgentsContext.Provider, { value: { apiKey, userWhatsapp, cdnBase, strategy }, children });
+}
+BlindAgents.Report = Report;
+BlindAgents.Chat = Chat;
+BlindAgents.Guide = Guide;
+function BlindAgentsWidget(props) {
+  return /* @__PURE__ */ jsx(BlindAgents, { apiKey: props.apiKey, userWhatsapp: props.userWhatsapp, strategy: props.strategy, children: /* @__PURE__ */ jsx(Report, { ...props }) });
+}
 export {
+  BlindAgents,
   BlindAgentsWidget
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/ReactBlindAgentsWidget.tsx"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef } from 'react';\nimport type { BlindAgentsWidgetProps } from './types';\n\nconst CDN_DEFAULT = 'https://cdn.blindagents.com/report.js';\n\nexport function BlindAgentsWidget({\n apiKey,\n primaryColor,\n title,\n reportBtnText,\n btnEmoji,\n btnTooltip,\n emptyText,\n userWhatsapp,\n strategy = 'afterInteractive',\n src = CDN_DEFAULT,\n onLoad,\n onError,\n}: BlindAgentsWidgetProps) {\n const injected = useRef(false);\n\n useEffect(() => {\n if (injected.current) return;\n injected.current = true;\n\n // Deduplicate across multiple widget instances\n const existing = document.querySelector<HTMLScriptElement>(\n `script[src=\"${src}\"][data-ba-managed]`\n );\n if (existing) return;\n\n const el = document.createElement('script');\n el.src = src;\n el.setAttribute('data-ba-managed', 'true');\n el.setAttribute('data-api-key', apiKey);\n if (primaryColor) el.setAttribute('data-primary-color', primaryColor);\n if (title) el.setAttribute('data-title', title);\n if (reportBtnText) el.setAttribute('data-report-btn-text', reportBtnText);\n if (btnEmoji) el.setAttribute('data-btn-emoji', btnEmoji);\n if (btnTooltip) el.setAttribute('data-btn-tooltip', btnTooltip);\n if (emptyText) el.setAttribute('data-empty-text', emptyText);\n if (userWhatsapp) el.setAttribute('data-user-whatsapp', userWhatsapp);\n\n if (onLoad) el.addEventListener('load', () => onLoad());\n if (onError) el.addEventListener('error', () => onError(new Error(`Failed to load ${src}`)));\n\n const inject = () => {\n if (strategy === 'afterInteractive') el.defer = true;\n if (strategy === 'lazyOnload') el.async = true;\n document.head.appendChild(el);\n };\n\n if (strategy === 'lazyOnload' && typeof window !== 'undefined' && 'requestIdleCallback' in window) {\n (window as Window & { requestIdleCallback: (cb: () => void) => void }).requestIdleCallback(inject);\n } else {\n inject();\n }\n\n return () => {\n el.parentNode?.removeChild(el);\n injected.current = false;\n };\n }, [apiKey, src]); // eslint-disable-line react-hooks/exhaustive-deps\n\n return null;\n}\n"],"mappings":";AAEA,SAAS,WAAW,cAAc;AAGlC,IAAM,cAAc;AAEb,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,MAAM;AAAA,EACN;AAAA,EACA;AACF,GAA2B;AACzB,QAAM,WAAW,OAAO,KAAK;AAE7B,YAAU,MAAM;AACd,QAAI,SAAS,QAAS;AACtB,aAAS,UAAU;AAGnB,UAAM,WAAW,SAAS;AAAA,MACxB,eAAe,GAAG;AAAA,IACpB;AACA,QAAI,SAAU;AAEd,UAAM,KAAK,SAAS,cAAc,QAAQ;AAC1C,OAAG,MAAM;AACT,OAAG,aAAa,mBAAmB,MAAM;AACzC,OAAG,aAAa,gBAAgB,MAAM;AACtC,QAAI,aAAe,IAAG,aAAa,sBAAsB,YAAY;AACrE,QAAI,MAAe,IAAG,aAAa,cAAc,KAAK;AACtD,QAAI,cAAe,IAAG,aAAa,wBAAwB,aAAa;AACxE,QAAI,SAAe,IAAG,aAAa,kBAAkB,QAAQ;AAC7D,QAAI,WAAe,IAAG,aAAa,oBAAoB,UAAU;AACjE,QAAI,UAAe,IAAG,aAAa,mBAAmB,SAAS;AAC/D,QAAI,aAAe,IAAG,aAAa,sBAAsB,YAAY;AAErE,QAAI,OAAS,IAAG,iBAAiB,QAAQ,MAAM,OAAO,CAAC;AACvD,QAAI,QAAS,IAAG,iBAAiB,SAAS,MAAM,QAAQ,IAAI,MAAM,kBAAkB,GAAG,EAAE,CAAC,CAAC;AAE3F,UAAM,SAAS,MAAM;AACnB,UAAI,aAAa,mBAAoB,IAAG,QAAQ;AAChD,UAAI,aAAa,aAAoB,IAAG,QAAQ;AAChD,eAAS,KAAK,YAAY,EAAE;AAAA,IAC9B;AAEA,QAAI,aAAa,gBAAgB,OAAO,WAAW,eAAe,yBAAyB,QAAQ;AACjG,MAAC,OAAsE,oBAAoB,MAAM;AAAA,IACnG,OAAO;AACL,aAAO;AAAA,IACT;AAEA,WAAO,MAAM;AACX,SAAG,YAAY,YAAY,EAAE;AAC7B,eAAS,UAAU;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,QAAQ,GAAG,CAAC;AAEhB,SAAO;AACT;","names":[]}
1	+ {"version":3,"sources":["../src/ReactBlindAgents.tsx","../src/context.ts","../src/types.ts"],"sourcesContent":["'use client';\n\nimport React, { useEffect, useRef } from 'react';\nimport { BlindAgentsContext } from './context';\nimport type {\n BlindAgentsProps,\n ReportWidgetProps,\n ChatWidgetProps,\n GuideWidgetProps,\n} from './types';\nimport { CDN_BASE } from './types';\n\n// ── Script injection helper ───────────────────────────────────────────────────\n\nfunction useScript(\n src: string,\n attrs: Record<string, string \| undefined>,\n strategy: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive',\n onLoad?: () => void,\n onError?: (e: Error) => void,\n) {\n const injected = useRef(false);\n\n useEffect(() => {\n if (injected.current) return;\n injected.current = true;\n\n // Deduplicate — only one script per src\n if (document.querySelector(`script[src=\"${src}\"][data-ba-managed]`)) return;\n\n const el = document.createElement('script');\n el.src = src;\n el.setAttribute('data-ba-managed', 'true');\n Object.entries(attrs).forEach(([k, v]) => {\n if (v != null && v !== '') el.setAttribute(k, v);\n });\n\n if (onLoad) el.addEventListener('load', () => onLoad());\n if (onError) el.addEventListener('error', () => onError(new Error(`Failed to load ${src}`)));\n\n const inject = () => {\n if (strategy === 'afterInteractive') el.defer = true;\n if (strategy === 'lazyOnload') el.async = true;\n document.head.appendChild(el);\n };\n\n if (strategy === 'lazyOnload' && 'requestIdleCallback' in window) {\n (window as any).requestIdleCallback(inject);\n } else {\n inject();\n }\n\n return () => { el.parentNode?.removeChild(el); injected.current = false; };\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [src]);\n}\n\n// ── Widget sub-components ─────────────────────────────────────────────────────\n\nfunction Report({\n primaryColor,\n title,\n reportBtnText,\n btnEmoji,\n btnTooltip,\n emptyText,\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: ReportWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/report.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp;\n\n useScript(src, {\n 'data-api-key': ctx.apiKey,\n 'data-primary-color': primaryColor,\n 'data-title': title,\n 'data-report-btn-text': reportBtnText,\n 'data-btn-emoji': btnEmoji,\n 'data-btn-tooltip': btnTooltip,\n 'data-empty-text': emptyText,\n 'data-user-whatsapp': wa,\n }, localStrategy ?? ctx.strategy, onLoad, onError);\n\n return null;\n}\n\nfunction Chat({\n agentId,\n primaryColor,\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: ChatWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/chat.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp;\n\n useScript(src, {\n 'data-api-key': ctx.apiKey,\n 'data-agent-id': agentId,\n 'data-primary-color': primaryColor,\n 'data-user-whatsapp': wa,\n }, localStrategy ?? ctx.strategy, onLoad, onError);\n\n return null;\n}\n\nfunction Guide({\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: GuideWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/guide.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp;\n\n useScript(src, {\n 'data-api-key': ctx.apiKey,\n 'data-user-whatsapp': wa,\n }, localStrategy ?? ctx.strategy, onLoad, onError);\n\n return null;\n}\n\n// ── Root provider ─────────────────────────────────────────────────────────────\n\nexport function BlindAgents({\n apiKey,\n userWhatsapp,\n cdnBase = CDN_BASE,\n strategy = 'afterInteractive',\n children,\n}: BlindAgentsProps) {\n return (\n <BlindAgentsContext.Provider value={{ apiKey, userWhatsapp, cdnBase, strategy }}>\n {children}\n </BlindAgentsContext.Provider>\n );\n}\n\nBlindAgents.Report = Report;\nBlindAgents.Chat = Chat;\nBlindAgents.Guide = Guide;\n\n// ── Legacy single-widget export (backwards compat) ───────────────────────────\n/** @deprecated Use <BlindAgents><BlindAgents.Report /></BlindAgents> /\nexport function BlindAgentsWidget(props: ReportWidgetProps & { apiKey: string }) {\n return (\n <BlindAgents apiKey={props.apiKey} userWhatsapp={props.userWhatsapp} strategy={props.strategy}>\n <Report {...props} />\n </BlindAgents>\n );\n}\n","import { createContext, useContext } from 'react';\nimport { CDN_BASE } from './types';\n\nexport interface BlindAgentsContextValue {\n apiKey: string;\n userWhatsapp?: string;\n cdnBase: string;\n strategy: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive';\n}\n\nexport const BlindAgentsContext = createContext<BlindAgentsContextValue>({\n apiKey: '',\n cdnBase: CDN_BASE,\n strategy: 'afterInteractive',\n});\n\nexport function useBlindAgents(): BlindAgentsContextValue {\n return useContext(BlindAgentsContext);\n}\n","const CDN_BASE = 'https://cdn.blindagents.com';\n\nexport { CDN_BASE };\n\n/* Common props shared by all widget types. /\nexport interface BaseWidgetProps {\n /* Your Blind Agents public API key (ba_...) /\n apiKey: string;\n /* Pre-filled WhatsApp number to skip identity verification /\n userWhatsapp?: string;\n /* Override the CDN base URL (useful for self-hosting) /\n cdnBase?: string;\n /* Script loading strategy @default \"afterInteractive\" /\n strategy?: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive';\n /* Called once the script finishes loading /\n onLoad?: () => void;\n /* Called if the script fails to load /\n onError?: (error: Error) => void;\n}\n\n/* Report / bug-reporter widget /\nexport interface ReportWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n /* Accent color for the widget UI — any valid CSS color /\n primaryColor?: string;\n /* Title displayed in the widget panel header @default \"Help Center\" /\n title?: string;\n /* Label for the report button @default \"Report an issue\" /\n reportBtnText?: string;\n /* Emoji on the launcher floating button @default \"🐛\" /\n btnEmoji?: string;\n /* Tooltip on the launcher button /\n btnTooltip?: string;\n /* Text shown when there are no reports @default \"No issues reported yet.\" /\n emptyText?: string;\n}\n\n/* Webchat widget /\nexport interface ChatWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n /* The agent UUID to connect this chat to /\n agentId?: string;\n /* Accent color for the chat bubble and header /\n primaryColor?: string;\n}\n\n/* Product guides widget /\nexport interface GuideWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n // No additional props yet — the guide SDK reads config from the dashboard\n}\n\n/* Root provider props — all children share this apiKey /\nexport interface BlindAgentsProps extends BaseWidgetProps {\n children: React.ReactNode;\n}\n\n// ── Legacy single-widget props (kept for backwards compatibility) ──────────────\n/* @deprecated Use <BlindAgents apiKey=\"...\"><BlindAgents.Report /></BlindAgents> instead /\nexport interface BlindAgentsWidgetProps extends BaseWidgetProps {\n primaryColor?: string;\n title?: string;\n reportBtnText?: string;\n btnEmoji?: string;\n btnTooltip?: string;\n emptyText?: string;\n /* @deprecated Prefer userWhatsapp */\n src?: string;\n}\n"],"mappings":"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","names":[]}

package/dist/next.d.mts CHANGED Viewed

@@ -1,32 +1,70 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-interface BlindAgentsWidgetProps {
+/** Common props shared by all widget types. */
+interface BaseWidgetProps {
     /** Your Blind Agents public API key (ba_...) */
     apiKey: string;
+    /** Pre-filled WhatsApp number to skip identity verification */
+    userWhatsapp?: string;
+    /** Override the CDN base URL (useful for self-hosting) */
+    cdnBase?: string;
+    /** Script loading strategy @default "afterInteractive" */
+    strategy?: 'afterInteractive' | 'lazyOnload' | 'beforeInteractive';
+    /** Called once the script finishes loading */
+    onLoad?: () => void;
+    /** Called if the script fails to load */
+    onError?: (error: Error) => void;
+}
+/** Report / bug-reporter widget */
+interface ReportWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
     /** Accent color for the widget UI — any valid CSS color */
     primaryColor?: string;
     /** Title displayed in the widget panel header @default "Help Center" */
     title?: string;
     /** Label for the report button @default "Report an issue" */
     reportBtnText?: string;
-    /** Emoji on the launcher floating button */
+    /** Emoji on the launcher floating button @default "🐛" */
     btnEmoji?: string;
     /** Tooltip on the launcher button */
     btnTooltip?: string;
     /** Text shown when there are no reports @default "No issues reported yet." */
     emptyText?: string;
-    /** Pre-fill the user's WhatsApp number or email to skip identity verification */
-    userWhatsapp?: string;
-    /** Script loading strategy @default "afterInteractive" */
-    strategy?: 'afterInteractive' | 'lazyOnload' | 'beforeInteractive';
-    /** Override the CDN URL (useful for self-hosting) @default "https://cdn.blindagents.com/report.js" */
+}
+/** Webchat widget */
+interface ChatWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
+    /** The agent UUID to connect this chat to */
+    agentId?: string;
+    /** Accent color for the chat bubble and header */
+    primaryColor?: string;
+}
+/** Product guides widget */
+interface GuideWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
+}
+/** Root provider props — all children share this apiKey */
+interface BlindAgentsProps extends BaseWidgetProps {
+    children: React.ReactNode;
+}
+/** @deprecated Use <BlindAgents apiKey="..."><BlindAgents.Report /></BlindAgents> instead */
+interface BlindAgentsWidgetProps extends BaseWidgetProps {
+    primaryColor?: string;
+    title?: string;
+    reportBtnText?: string;
+    btnEmoji?: string;
+    btnTooltip?: string;
+    emptyText?: string;
+    /** @deprecated Prefer userWhatsapp */
     src?: string;
-    /** Called once the script finishes loading */
-    onLoad?: () => void;
-    /** Called if the script fails to load */
-    onError?: (error: Error) => void;
 }
-declare function BlindAgentsWidget({ apiKey, primaryColor, title, reportBtnText, btnEmoji, btnTooltip, emptyText, userWhatsapp, strategy, src, onLoad, onError, }: BlindAgentsWidgetProps): react_jsx_runtime.JSX.Element;
+declare function BlindAgents({ apiKey, userWhatsapp, cdnBase, strategy, children, }: BlindAgentsProps): react_jsx_runtime.JSX.Element;
+declare namespace BlindAgents {
+    var Report: ({ primaryColor, title, reportBtnText, btnEmoji, btnTooltip, emptyText, userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: ReportWidgetProps) => react_jsx_runtime.JSX.Element;
+    var Chat: ({ agentId, primaryColor, userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: ChatWidgetProps) => react_jsx_runtime.JSX.Element;
+    var Guide: ({ userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: GuideWidgetProps) => react_jsx_runtime.JSX.Element;
+}
+/** @deprecated Use <BlindAgents><BlindAgents.Report /></BlindAgents> */
+declare function BlindAgentsWidget(props: ReportWidgetProps & {
+    apiKey: string;
+}): react_jsx_runtime.JSX.Element;
-export { BlindAgentsWidget, type BlindAgentsWidgetProps };
+export { BlindAgents, type BlindAgentsProps, BlindAgentsWidget, type BlindAgentsWidgetProps, type ChatWidgetProps, type GuideWidgetProps, type ReportWidgetProps };

package/dist/next.d.ts CHANGED Viewed

@@ -1,32 +1,70 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-interface BlindAgentsWidgetProps {
+/** Common props shared by all widget types. */
+interface BaseWidgetProps {
     /** Your Blind Agents public API key (ba_...) */
     apiKey: string;
+    /** Pre-filled WhatsApp number to skip identity verification */
+    userWhatsapp?: string;
+    /** Override the CDN base URL (useful for self-hosting) */
+    cdnBase?: string;
+    /** Script loading strategy @default "afterInteractive" */
+    strategy?: 'afterInteractive' | 'lazyOnload' | 'beforeInteractive';
+    /** Called once the script finishes loading */
+    onLoad?: () => void;
+    /** Called if the script fails to load */
+    onError?: (error: Error) => void;
+}
+/** Report / bug-reporter widget */
+interface ReportWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
     /** Accent color for the widget UI — any valid CSS color */
     primaryColor?: string;
     /** Title displayed in the widget panel header @default "Help Center" */
     title?: string;
     /** Label for the report button @default "Report an issue" */
     reportBtnText?: string;
-    /** Emoji on the launcher floating button */
+    /** Emoji on the launcher floating button @default "🐛" */
     btnEmoji?: string;
     /** Tooltip on the launcher button */
     btnTooltip?: string;
     /** Text shown when there are no reports @default "No issues reported yet." */
     emptyText?: string;
-    /** Pre-fill the user's WhatsApp number or email to skip identity verification */
-    userWhatsapp?: string;
-    /** Script loading strategy @default "afterInteractive" */
-    strategy?: 'afterInteractive' | 'lazyOnload' | 'beforeInteractive';
-    /** Override the CDN URL (useful for self-hosting) @default "https://cdn.blindagents.com/report.js" */
+}
+/** Webchat widget */
+interface ChatWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
+    /** The agent UUID to connect this chat to */
+    agentId?: string;
+    /** Accent color for the chat bubble and header */
+    primaryColor?: string;
+}
+/** Product guides widget */
+interface GuideWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {
+}
+/** Root provider props — all children share this apiKey */
+interface BlindAgentsProps extends BaseWidgetProps {
+    children: React.ReactNode;
+}
+/** @deprecated Use <BlindAgents apiKey="..."><BlindAgents.Report /></BlindAgents> instead */
+interface BlindAgentsWidgetProps extends BaseWidgetProps {
+    primaryColor?: string;
+    title?: string;
+    reportBtnText?: string;
+    btnEmoji?: string;
+    btnTooltip?: string;
+    emptyText?: string;
+    /** @deprecated Prefer userWhatsapp */
     src?: string;
-    /** Called once the script finishes loading */
-    onLoad?: () => void;
-    /** Called if the script fails to load */
-    onError?: (error: Error) => void;
 }
-declare function BlindAgentsWidget({ apiKey, primaryColor, title, reportBtnText, btnEmoji, btnTooltip, emptyText, userWhatsapp, strategy, src, onLoad, onError, }: BlindAgentsWidgetProps): react_jsx_runtime.JSX.Element;
+declare function BlindAgents({ apiKey, userWhatsapp, cdnBase, strategy, children, }: BlindAgentsProps): react_jsx_runtime.JSX.Element;
+declare namespace BlindAgents {
+    var Report: ({ primaryColor, title, reportBtnText, btnEmoji, btnTooltip, emptyText, userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: ReportWidgetProps) => react_jsx_runtime.JSX.Element;
+    var Chat: ({ agentId, primaryColor, userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: ChatWidgetProps) => react_jsx_runtime.JSX.Element;
+    var Guide: ({ userWhatsapp: localWhatsapp, cdnBase: localCdn, strategy: localStrategy, onLoad, onError, }: GuideWidgetProps) => react_jsx_runtime.JSX.Element;
+}
+/** @deprecated Use <BlindAgents><BlindAgents.Report /></BlindAgents> */
+declare function BlindAgentsWidget(props: ReportWidgetProps & {
+    apiKey: string;
+}): react_jsx_runtime.JSX.Element;
-export { BlindAgentsWidget, type BlindAgentsWidgetProps };
+export { BlindAgents, type BlindAgentsProps, BlindAgentsWidget, type BlindAgentsWidgetProps, type ChatWidgetProps, type GuideWidgetProps, type ReportWidgetProps };

package/dist/next.js CHANGED Viewed

@@ -30,48 +30,130 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/next.ts
 var next_exports = {};
 __export(next_exports, {
+  BlindAgents: () => BlindAgents,
   BlindAgentsWidget: () => BlindAgentsWidget
 });
 module.exports = __toCommonJS(next_exports);
-// src/NextBlindAgentsWidget.tsx
+// src/NextBlindAgents.tsx
+var import_react2 = __toESM(require("react"));
 var import_script = __toESM(require("next/script"));
+// src/context.ts
+var import_react = require("react");
+// src/types.ts
+var CDN_BASE = "https://cdn.blindagents.com";
+// src/context.ts
+var BlindAgentsContext = (0, import_react.createContext)({
+  apiKey: "",
+  cdnBase: CDN_BASE,
+  strategy: "afterInteractive"
+});
+// src/NextBlindAgents.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
-var CDN_DEFAULT = "https://cdn.blindagents.com/report.js";
-function BlindAgentsWidget({
-  apiKey,
+function Report({
   primaryColor,
   title,
   reportBtnText,
   btnEmoji,
   btnTooltip,
   emptyText,
-  userWhatsapp,
-  strategy = "afterInteractive",
-  src = CDN_DEFAULT,
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
   onLoad,
   onError
 }) {
+  const ctx = import_react2.default.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/report.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp ?? "";
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
     import_script.default,
     {
       src,
-      strategy,
-      "data-api-key": apiKey,
+      strategy: localStrategy ?? ctx.strategy,
+      "data-api-key": ctx.apiKey,
       "data-primary-color": primaryColor,
       "data-title": title,
       "data-report-btn-text": reportBtnText,
       "data-btn-emoji": btnEmoji,
       "data-btn-tooltip": btnTooltip,
       "data-empty-text": emptyText,
-      "data-user-whatsapp": userWhatsapp ?? "",
+      "data-user-whatsapp": wa,
+      onLoad,
+      onError: onError ? () => onError(new Error(`Failed to load ${src}`)) : void 0
+    }
+  );
+}
+function Chat({
+  agentId,
+  primaryColor,
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = import_react2.default.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/chat.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp ?? "";
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_script.default,
+    {
+      src,
+      strategy: localStrategy ?? ctx.strategy,
+      "data-api-key": ctx.apiKey,
+      "data-agent-id": agentId,
+      "data-primary-color": primaryColor,
+      "data-user-whatsapp": wa,
+      onLoad,
+      onError: onError ? () => onError(new Error(`Failed to load ${src}`)) : void 0
+    }
+  );
+}
+function Guide({
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = import_react2.default.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/guide.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp ?? "";
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_script.default,
+    {
+      src,
+      strategy: localStrategy ?? ctx.strategy,
+      "data-api-key": ctx.apiKey,
+      "data-user-whatsapp": wa,
       onLoad,
       onError: onError ? () => onError(new Error(`Failed to load ${src}`)) : void 0
     }
   );
 }
+function BlindAgents({
+  apiKey,
+  userWhatsapp,
+  cdnBase = CDN_BASE,
+  strategy = "afterInteractive",
+  children
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(BlindAgentsContext.Provider, { value: { apiKey, userWhatsapp, cdnBase, strategy }, children });
+}
+BlindAgents.Report = Report;
+BlindAgents.Chat = Chat;
+BlindAgents.Guide = Guide;
+function BlindAgentsWidget(props) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(BlindAgents, { apiKey: props.apiKey, userWhatsapp: props.userWhatsapp, strategy: props.strategy, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Report, { ...props }) });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BlindAgents,
   BlindAgentsWidget
 });
 //# sourceMappingURL=next.js.map

package/dist/next.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/next.ts","../src/~~NextBlindAgentsWidget~~.tsx"],"sourcesContent":["// Next.js entry (App Router + Pages Router)\n// Uses next/script for correct hydration and strategy support.\nexport { BlindAgentsWidget } from './~~NextBlindAgentsWidget~~';\nexport type { BlindAgentsWidgetProps } from './types';\n","'use client';\n\n// ~~This~~ ~~file is only included in the `react-blind-agents/next`~~ subpath entry~~.\n//~~ It ~~relies~~ ~~on `~~next/script` ~~which~~ is ~~NOT~~ ~~available~~ in ~~plain~~ React ~~apps.\~~nimport Script from 'next/script';\nimport type { ~~BlindAgentsWidgetProps~~ } from './types';\n\~~nconst~~ ~~CDN_DEFAULT~~ = ~~'https://cdn.blindagents.com/report.js';\~~n\~~nexport~~ ~~function BlindAgentsWidget~~({\n ~~apiKey,\n~~ primaryColor,\n title,\n reportBtnText,\n btnEmoji,\n btnTooltip,\n emptyText,\n userWhatsapp,\n ~~strategy~~ ~~= 'afterInteractive'~~,\n ~~src~~ ~~= CDN_DEFAULT~~,\n onLoad,\n onError,\n}: ~~BlindAgentsWidgetProps~~) {\n return (\n <Script\n src={src}\n strategy={strategy}\n data-api-key={apiKey}\n data-primary-color={primaryColor}\n data-title={title}\n data-report-btn-text={reportBtnText}\n data-btn-emoji={btnEmoji}\n data-btn-tooltip={btnTooltip}\n data-empty-text={emptyText}\n data-user-whatsapp={userWhatsapp ?? ''}\n onLoad={onLoad}\n onError={onError ? () => onError(new Error(`Failed to load ${src}`)) : undefined}\n />\n );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;~~ACIA~~,~~oBAAmB~~;~~AAoBf;AAjBJ~~,IAAM,~~cAAc~~;~~AAEb~~,~~SAAS~~,~~kBAAkB~~;AAAA,~~EAChC~~;AAAA,~~EACA~~;AAAA,~~EACA~~;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,~~WAAW~~;AAAA,~~EACX~~,~~MAAM~~;AAAA,~~EACN~~;AAAA,EACA;AACF,~~GAA2B~~;~~AACzB~~,SACE;AAAA,IAAC,~~cAAAA~~;AAAA,IAAA;AAAA,MACC;AAAA,MACA;AAAA,~~MACA~~,gBAAc;AAAA,~~MACd~~,sBAAoB;AAAA,MACpB,cAAY;AAAA,MACZ,wBAAsB;AAAA,MACtB,kBAAgB;AAAA,MAChB,oBAAkB;AAAA,MAClB,mBAAiB;AAAA,MACjB,sBAAoB,gBAAgB;AAAA,~~MACpC~~;AAAA,MACA,SAAS,UAAU,MAAM,QAAQ,IAAI,MAAM,kBAAkB,GAAG,EAAE,CAAC,IAAI;AAAA;AAAA,EACzE;AAEJ;","names":["Script"]}
1	+ {"version":3,"sources":["../src/next.ts","../src/NextBlindAgents.tsx","../src/context.ts","../src/types.ts"],"sourcesContent":["// Next.js entry (App Router + Pages Router)\n// Uses next/script for correct hydration and strategy support.\nexport { BlindAgents, BlindAgentsWidget } from './NextBlindAgents';\nexport type {\n BlindAgentsProps,\n ReportWidgetProps,\n ChatWidgetProps,\n GuideWidgetProps,\n BlindAgentsWidgetProps,\n} from './types';\n","'use client';\n\n// Next.js subpath entry — uses next/script for correct strategy & hydration.\nimport React from 'react';\nimport Script from 'next/script';\nimport { BlindAgentsContext } from './context';\nimport type {\n BlindAgentsProps,\n ReportWidgetProps,\n ChatWidgetProps,\n GuideWidgetProps,\n} from './types';\nimport { CDN_BASE } from './types';\n\n// ── Widget sub-components ─────────────────────────────────────────────────────\n\nfunction Report({\n primaryColor,\n title,\n reportBtnText,\n btnEmoji,\n btnTooltip,\n emptyText,\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: ReportWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/report.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp ?? '';\n\n return (\n <Script\n src={src}\n strategy={localStrategy ?? ctx.strategy}\n data-api-key={ctx.apiKey}\n data-primary-color={primaryColor}\n data-title={title}\n data-report-btn-text={reportBtnText}\n data-btn-emoji={btnEmoji}\n data-btn-tooltip={btnTooltip}\n data-empty-text={emptyText}\n data-user-whatsapp={wa}\n onLoad={onLoad}\n onError={onError ? () => onError(new Error(`Failed to load ${src}`)) : undefined}\n />\n );\n}\n\nfunction Chat({\n agentId,\n primaryColor,\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: ChatWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/chat.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp ?? '';\n\n return (\n <Script\n src={src}\n strategy={localStrategy ?? ctx.strategy}\n data-api-key={ctx.apiKey}\n data-agent-id={agentId}\n data-primary-color={primaryColor}\n data-user-whatsapp={wa}\n onLoad={onLoad}\n onError={onError ? () => onError(new Error(`Failed to load ${src}`)) : undefined}\n />\n );\n}\n\nfunction Guide({\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: GuideWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/guide.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp ?? '';\n\n return (\n <Script\n src={src}\n strategy={localStrategy ?? ctx.strategy}\n data-api-key={ctx.apiKey}\n data-user-whatsapp={wa}\n onLoad={onLoad}\n onError={onError ? () => onError(new Error(`Failed to load ${src}`)) : undefined}\n />\n );\n}\n\n// ── Root provider ─────────────────────────────────────────────────────────────\n\nexport function BlindAgents({\n apiKey,\n userWhatsapp,\n cdnBase = CDN_BASE,\n strategy = 'afterInteractive',\n children,\n}: BlindAgentsProps) {\n return (\n <BlindAgentsContext.Provider value={{ apiKey, userWhatsapp, cdnBase, strategy }}>\n {children}\n </BlindAgentsContext.Provider>\n );\n}\n\nBlindAgents.Report = Report;\nBlindAgents.Chat = Chat;\nBlindAgents.Guide = Guide;\n\n// ── Legacy single-widget export (backwards compat) ───────────────────────────\n/** @deprecated Use <BlindAgents><BlindAgents.Report /></BlindAgents> /\nexport function BlindAgentsWidget(props: ReportWidgetProps & { apiKey: string }) {\n return (\n <BlindAgents apiKey={props.apiKey} userWhatsapp={props.userWhatsapp} strategy={props.strategy}>\n <Report {...props} />\n </BlindAgents>\n );\n}\n","import { createContext, useContext } from 'react';\nimport { CDN_BASE } from './types';\n\nexport interface BlindAgentsContextValue {\n apiKey: string;\n userWhatsapp?: string;\n cdnBase: string;\n strategy: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive';\n}\n\nexport const BlindAgentsContext = createContext<BlindAgentsContextValue>({\n apiKey: '',\n cdnBase: CDN_BASE,\n strategy: 'afterInteractive',\n});\n\nexport function useBlindAgents(): BlindAgentsContextValue {\n return useContext(BlindAgentsContext);\n}\n","const CDN_BASE = 'https://cdn.blindagents.com';\n\nexport { CDN_BASE };\n\n/* Common props shared by all widget types. /\nexport interface BaseWidgetProps {\n /* Your Blind Agents public API key (ba_...) /\n apiKey: string;\n /* Pre-filled WhatsApp number to skip identity verification /\n userWhatsapp?: string;\n /* Override the CDN base URL (useful for self-hosting) /\n cdnBase?: string;\n /* Script loading strategy @default \"afterInteractive\" /\n strategy?: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive';\n /* Called once the script finishes loading /\n onLoad?: () => void;\n /* Called if the script fails to load /\n onError?: (error: Error) => void;\n}\n\n/* Report / bug-reporter widget /\nexport interface ReportWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n /* Accent color for the widget UI — any valid CSS color /\n primaryColor?: string;\n /* Title displayed in the widget panel header @default \"Help Center\" /\n title?: string;\n /* Label for the report button @default \"Report an issue\" /\n reportBtnText?: string;\n /* Emoji on the launcher floating button @default \"🐛\" /\n btnEmoji?: string;\n /* Tooltip on the launcher button /\n btnTooltip?: string;\n /* Text shown when there are no reports @default \"No issues reported yet.\" /\n emptyText?: string;\n}\n\n/* Webchat widget /\nexport interface ChatWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n /* The agent UUID to connect this chat to /\n agentId?: string;\n /* Accent color for the chat bubble and header /\n primaryColor?: string;\n}\n\n/* Product guides widget /\nexport interface GuideWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n // No additional props yet — the guide SDK reads config from the dashboard\n}\n\n/* Root provider props — all children share this apiKey /\nexport interface BlindAgentsProps extends BaseWidgetProps {\n children: React.ReactNode;\n}\n\n// ── Legacy single-widget props (kept for backwards compatibility) ──────────────\n/* @deprecated Use <BlindAgents apiKey=\"...\"><BlindAgents.Report /></BlindAgents> instead /\nexport interface BlindAgentsWidgetProps extends BaseWidgetProps {\n primaryColor?: string;\n title?: string;\n reportBtnText?: string;\n btnEmoji?: string;\n btnTooltip?: string;\n emptyText?: string;\n /* @deprecated Prefer userWhatsapp */\n src?: string;\n}\n"],"mappings":"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","names":["import_react","React","Script"]}

package/dist/next.mjs CHANGED Viewed

@@ -1,40 +1,121 @@
-// src/NextBlindAgentsWidget.tsx
+// src/NextBlindAgents.tsx
+import React from "react";
 import Script from "next/script";
+// src/context.ts
+import { createContext, useContext } from "react";
+// src/types.ts
+var CDN_BASE = "https://cdn.blindagents.com";
+// src/context.ts
+var BlindAgentsContext = createContext({
+  apiKey: "",
+  cdnBase: CDN_BASE,
+  strategy: "afterInteractive"
+});
+// src/NextBlindAgents.tsx
 import { jsx } from "react/jsx-runtime";
-var CDN_DEFAULT = "https://cdn.blindagents.com/report.js";
-function BlindAgentsWidget({
-  apiKey,
+function Report({
   primaryColor,
   title,
   reportBtnText,
   btnEmoji,
   btnTooltip,
   emptyText,
-  userWhatsapp,
-  strategy = "afterInteractive",
-  src = CDN_DEFAULT,
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
   onLoad,
   onError
 }) {
+  const ctx = React.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/report.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp ?? "";
   return /* @__PURE__ */ jsx(
     Script,
     {
       src,
-      strategy,
-      "data-api-key": apiKey,
+      strategy: localStrategy ?? ctx.strategy,
+      "data-api-key": ctx.apiKey,
       "data-primary-color": primaryColor,
       "data-title": title,
       "data-report-btn-text": reportBtnText,
       "data-btn-emoji": btnEmoji,
       "data-btn-tooltip": btnTooltip,
       "data-empty-text": emptyText,
-      "data-user-whatsapp": userWhatsapp ?? "",
+      "data-user-whatsapp": wa,
+      onLoad,
+      onError: onError ? () => onError(new Error(`Failed to load ${src}`)) : void 0
+    }
+  );
+}
+function Chat({
+  agentId,
+  primaryColor,
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = React.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/chat.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp ?? "";
+  return /* @__PURE__ */ jsx(
+    Script,
+    {
+      src,
+      strategy: localStrategy ?? ctx.strategy,
+      "data-api-key": ctx.apiKey,
+      "data-agent-id": agentId,
+      "data-primary-color": primaryColor,
+      "data-user-whatsapp": wa,
       onLoad,
       onError: onError ? () => onError(new Error(`Failed to load ${src}`)) : void 0
     }
   );
 }
+function Guide({
+  userWhatsapp: localWhatsapp,
+  cdnBase: localCdn,
+  strategy: localStrategy,
+  onLoad,
+  onError
+}) {
+  const ctx = React.useContext(BlindAgentsContext);
+  const src = `${localCdn ?? ctx.cdnBase}/guide.js`;
+  const wa = localWhatsapp ?? ctx.userWhatsapp ?? "";
+  return /* @__PURE__ */ jsx(
+    Script,
+    {
+      src,
+      strategy: localStrategy ?? ctx.strategy,
+      "data-api-key": ctx.apiKey,
+      "data-user-whatsapp": wa,
+      onLoad,
+      onError: onError ? () => onError(new Error(`Failed to load ${src}`)) : void 0
+    }
+  );
+}
+function BlindAgents({
+  apiKey,
+  userWhatsapp,
+  cdnBase = CDN_BASE,
+  strategy = "afterInteractive",
+  children
+}) {
+  return /* @__PURE__ */ jsx(BlindAgentsContext.Provider, { value: { apiKey, userWhatsapp, cdnBase, strategy }, children });
+}
+BlindAgents.Report = Report;
+BlindAgents.Chat = Chat;
+BlindAgents.Guide = Guide;
+function BlindAgentsWidget(props) {
+  return /* @__PURE__ */ jsx(BlindAgents, { apiKey: props.apiKey, userWhatsapp: props.userWhatsapp, strategy: props.strategy, children: /* @__PURE__ */ jsx(Report, { ...props }) });
+}
 export {
+  BlindAgents,
   BlindAgentsWidget
 };
 //# sourceMappingURL=next.mjs.map

package/dist/next.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/~~NextBlindAgentsWidget~~.tsx"],"sourcesContent":["'use client';\n\n// ~~This~~ ~~file is only included in the `react-blind-agents/next`~~ subpath entry~~.\n//~~ It ~~relies~~ ~~on `~~next/script` ~~which~~ is ~~NOT~~ ~~available~~ in ~~plain~~ React ~~apps.\~~nimport Script from 'next/script';\nimport type { ~~BlindAgentsWidgetProps~~ } from './types';\n\~~nconst~~ ~~CDN_DEFAULT~~ = ~~'https://cdn.blindagents.com/report.js';\~~n\~~nexport~~ ~~function BlindAgentsWidget~~({\n ~~apiKey,\n~~ primaryColor,\n title,\n reportBtnText,\n btnEmoji,\n btnTooltip,\n emptyText,\n userWhatsapp,\n ~~strategy~~ ~~= 'afterInteractive'~~,\n ~~src~~ ~~= CDN_DEFAULT~~,\n onLoad,\n onError,\n}: ~~BlindAgentsWidgetProps~~) {\n return (\n <Script\n src={src}\n strategy={strategy}\n data-api-key={apiKey}\n data-primary-color={primaryColor}\n data-title={title}\n data-report-btn-text={reportBtnText}\n data-btn-emoji={btnEmoji}\n data-btn-tooltip={btnTooltip}\n data-empty-text={emptyText}\n data-user-whatsapp={userWhatsapp ?? ''}\n onLoad={onLoad}\n onError={onError ? () => onError(new Error(`Failed to load ${src}`)) : undefined}\n />\n );\n}\n"],"mappings":";~~AAIA~~,OAAO,~~YAAY~~;~~AAoBf;AAjBJ~~,~~IAAM~~,~~cAAc;AAEb~~,SAAS,kBAAkB;AAAA,~~EAChC~~;AAAA,~~EACA~~;AAAA,~~EACA~~;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,~~WAAW~~;AAAA,~~EACX~~,~~MAAM~~;AAAA,~~EACN~~;AAAA,EACA;AACF,~~GAA2B~~;~~AACzB~~,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,~~MACA~~,gBAAc;AAAA,~~MACd~~,sBAAoB;AAAA,MACpB,cAAY;AAAA,MACZ,wBAAsB;AAAA,MACtB,kBAAgB;AAAA,MAChB,oBAAkB;AAAA,MAClB,mBAAiB;AAAA,MACjB,sBAAoB,gBAAgB;AAAA,~~MACpC~~;AAAA,MACA,SAAS,UAAU,MAAM,QAAQ,IAAI,MAAM,kBAAkB,GAAG,EAAE,CAAC,IAAI;AAAA;AAAA,EACzE;AAEJ;","names":[]}
1	+ {"version":3,"sources":["../src/NextBlindAgents.tsx","../src/context.ts","../src/types.ts"],"sourcesContent":["'use client';\n\n// Next.js subpath entry — uses next/script for correct strategy & hydration.\nimport React from 'react';\nimport Script from 'next/script';\nimport { BlindAgentsContext } from './context';\nimport type {\n BlindAgentsProps,\n ReportWidgetProps,\n ChatWidgetProps,\n GuideWidgetProps,\n} from './types';\nimport { CDN_BASE } from './types';\n\n// ── Widget sub-components ─────────────────────────────────────────────────────\n\nfunction Report({\n primaryColor,\n title,\n reportBtnText,\n btnEmoji,\n btnTooltip,\n emptyText,\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: ReportWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/report.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp ?? '';\n\n return (\n <Script\n src={src}\n strategy={localStrategy ?? ctx.strategy}\n data-api-key={ctx.apiKey}\n data-primary-color={primaryColor}\n data-title={title}\n data-report-btn-text={reportBtnText}\n data-btn-emoji={btnEmoji}\n data-btn-tooltip={btnTooltip}\n data-empty-text={emptyText}\n data-user-whatsapp={wa}\n onLoad={onLoad}\n onError={onError ? () => onError(new Error(`Failed to load ${src}`)) : undefined}\n />\n );\n}\n\nfunction Chat({\n agentId,\n primaryColor,\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: ChatWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/chat.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp ?? '';\n\n return (\n <Script\n src={src}\n strategy={localStrategy ?? ctx.strategy}\n data-api-key={ctx.apiKey}\n data-agent-id={agentId}\n data-primary-color={primaryColor}\n data-user-whatsapp={wa}\n onLoad={onLoad}\n onError={onError ? () => onError(new Error(`Failed to load ${src}`)) : undefined}\n />\n );\n}\n\nfunction Guide({\n userWhatsapp: localWhatsapp,\n cdnBase: localCdn,\n strategy: localStrategy,\n onLoad,\n onError,\n}: GuideWidgetProps) {\n const ctx = React.useContext(BlindAgentsContext);\n const src = `${localCdn ?? ctx.cdnBase}/guide.js`;\n const wa = localWhatsapp ?? ctx.userWhatsapp ?? '';\n\n return (\n <Script\n src={src}\n strategy={localStrategy ?? ctx.strategy}\n data-api-key={ctx.apiKey}\n data-user-whatsapp={wa}\n onLoad={onLoad}\n onError={onError ? () => onError(new Error(`Failed to load ${src}`)) : undefined}\n />\n );\n}\n\n// ── Root provider ─────────────────────────────────────────────────────────────\n\nexport function BlindAgents({\n apiKey,\n userWhatsapp,\n cdnBase = CDN_BASE,\n strategy = 'afterInteractive',\n children,\n}: BlindAgentsProps) {\n return (\n <BlindAgentsContext.Provider value={{ apiKey, userWhatsapp, cdnBase, strategy }}>\n {children}\n </BlindAgentsContext.Provider>\n );\n}\n\nBlindAgents.Report = Report;\nBlindAgents.Chat = Chat;\nBlindAgents.Guide = Guide;\n\n// ── Legacy single-widget export (backwards compat) ───────────────────────────\n/** @deprecated Use <BlindAgents><BlindAgents.Report /></BlindAgents> /\nexport function BlindAgentsWidget(props: ReportWidgetProps & { apiKey: string }) {\n return (\n <BlindAgents apiKey={props.apiKey} userWhatsapp={props.userWhatsapp} strategy={props.strategy}>\n <Report {...props} />\n </BlindAgents>\n );\n}\n","import { createContext, useContext } from 'react';\nimport { CDN_BASE } from './types';\n\nexport interface BlindAgentsContextValue {\n apiKey: string;\n userWhatsapp?: string;\n cdnBase: string;\n strategy: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive';\n}\n\nexport const BlindAgentsContext = createContext<BlindAgentsContextValue>({\n apiKey: '',\n cdnBase: CDN_BASE,\n strategy: 'afterInteractive',\n});\n\nexport function useBlindAgents(): BlindAgentsContextValue {\n return useContext(BlindAgentsContext);\n}\n","const CDN_BASE = 'https://cdn.blindagents.com';\n\nexport { CDN_BASE };\n\n/* Common props shared by all widget types. /\nexport interface BaseWidgetProps {\n /* Your Blind Agents public API key (ba_...) /\n apiKey: string;\n /* Pre-filled WhatsApp number to skip identity verification /\n userWhatsapp?: string;\n /* Override the CDN base URL (useful for self-hosting) /\n cdnBase?: string;\n /* Script loading strategy @default \"afterInteractive\" /\n strategy?: 'afterInteractive' \| 'lazyOnload' \| 'beforeInteractive';\n /* Called once the script finishes loading /\n onLoad?: () => void;\n /* Called if the script fails to load /\n onError?: (error: Error) => void;\n}\n\n/* Report / bug-reporter widget /\nexport interface ReportWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n /* Accent color for the widget UI — any valid CSS color /\n primaryColor?: string;\n /* Title displayed in the widget panel header @default \"Help Center\" /\n title?: string;\n /* Label for the report button @default \"Report an issue\" /\n reportBtnText?: string;\n /* Emoji on the launcher floating button @default \"🐛\" /\n btnEmoji?: string;\n /* Tooltip on the launcher button /\n btnTooltip?: string;\n /* Text shown when there are no reports @default \"No issues reported yet.\" /\n emptyText?: string;\n}\n\n/* Webchat widget /\nexport interface ChatWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n /* The agent UUID to connect this chat to /\n agentId?: string;\n /* Accent color for the chat bubble and header /\n primaryColor?: string;\n}\n\n/* Product guides widget /\nexport interface GuideWidgetProps extends Omit<BaseWidgetProps, 'apiKey'> {\n // No additional props yet — the guide SDK reads config from the dashboard\n}\n\n/* Root provider props — all children share this apiKey /\nexport interface BlindAgentsProps extends BaseWidgetProps {\n children: React.ReactNode;\n}\n\n// ── Legacy single-widget props (kept for backwards compatibility) ──────────────\n/* @deprecated Use <BlindAgents apiKey=\"...\"><BlindAgents.Report /></BlindAgents> instead /\nexport interface BlindAgentsWidgetProps extends BaseWidgetProps {\n primaryColor?: string;\n title?: string;\n reportBtnText?: string;\n btnEmoji?: string;\n btnTooltip?: string;\n emptyText?: string;\n /* @deprecated Prefer userWhatsapp */\n src?: string;\n}\n"],"mappings":";AAGA,OAAO,WAAW;AAClB,OAAO,YAAY;;;ACJnB,SAAS,eAAe,kBAAkB;;;ACA1C,IAAM,WAAW;;;ADUV,IAAM,qBAAqB,cAAuC;AAAA,EACvE,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;;;ADoBG;AAlBJ,SAAS,OAAO;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,SAAS;AAAA,EACT,UAAU;AAAA,EACV;AAAA,EACA;AACF,GAAsB;AACpB,QAAM,MAAM,MAAM,WAAW,kBAAkB;AAC/C,QAAM,MAAM,GAAG,YAAY,IAAI,OAAO;AACtC,QAAM,KAAM,iBAAiB,IAAI,gBAAgB;AAEjD,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,UAAU,iBAAiB,IAAI;AAAA,MAC/B,gBAAc,IAAI;AAAA,MAClB,sBAAoB;AAAA,MACpB,cAAY;AAAA,MACZ,wBAAsB;AAAA,MACtB,kBAAgB;AAAA,MAChB,oBAAkB;AAAA,MAClB,mBAAiB;AAAA,MACjB,sBAAoB;AAAA,MACpB;AAAA,MACA,SAAS,UAAU,MAAM,QAAQ,IAAI,MAAM,kBAAkB,GAAG,EAAE,CAAC,IAAI;AAAA;AAAA,EACzE;AAEJ;AAEA,SAAS,KAAK;AAAA,EACZ;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd,SAAS;AAAA,EACT,UAAU;AAAA,EACV;AAAA,EACA;AACF,GAAoB;AAClB,QAAM,MAAM,MAAM,WAAW,kBAAkB;AAC/C,QAAM,MAAM,GAAG,YAAY,IAAI,OAAO;AACtC,QAAM,KAAM,iBAAiB,IAAI,gBAAgB;AAEjD,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,UAAU,iBAAiB,IAAI;AAAA,MAC/B,gBAAc,IAAI;AAAA,MAClB,iBAAe;AAAA,MACf,sBAAoB;AAAA,MACpB,sBAAoB;AAAA,MACpB;AAAA,MACA,SAAS,UAAU,MAAM,QAAQ,IAAI,MAAM,kBAAkB,GAAG,EAAE,CAAC,IAAI;AAAA;AAAA,EACzE;AAEJ;AAEA,SAAS,MAAM;AAAA,EACb,cAAc;AAAA,EACd,SAAS;AAAA,EACT,UAAU;AAAA,EACV;AAAA,EACA;AACF,GAAqB;AACnB,QAAM,MAAM,MAAM,WAAW,kBAAkB;AAC/C,QAAM,MAAM,GAAG,YAAY,IAAI,OAAO;AACtC,QAAM,KAAM,iBAAiB,IAAI,gBAAgB;AAEjD,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,UAAU,iBAAiB,IAAI;AAAA,MAC/B,gBAAc,IAAI;AAAA,MAClB,sBAAoB;AAAA,MACpB;AAAA,MACA,SAAS,UAAU,MAAM,QAAQ,IAAI,MAAM,kBAAkB,GAAG,EAAE,CAAC,IAAI;AAAA;AAAA,EACzE;AAEJ;AAIO,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA,UAAU;AAAA,EACV,WAAW;AAAA,EACX;AACF,GAAqB;AACnB,SACE,oBAAC,mBAAmB,UAAnB,EAA4B,OAAO,EAAE,QAAQ,cAAc,SAAS,SAAS,GAC3E,UACH;AAEJ;AAEA,YAAY,SAAS;AACrB,YAAY,OAAS;AACrB,YAAY,QAAS;AAId,SAAS,kBAAkB,OAA+C;AAC/E,SACE,oBAAC,eAAY,QAAQ,MAAM,QAAQ,cAAc,MAAM,cAAc,UAAU,MAAM,UACnF,8BAAC,UAAQ,GAAG,OAAO,GACrB;AAEJ;","names":[]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@duvandroid/react-blind-agents",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "React component for the Blind Agents pixel widget — bug reporter, webchat, and product guides.",
   "author": "Blind Agents <hola@blindagents.com>",
   "license": "MIT",
@@ -57,4 +57,4 @@
     "tsup": "^8.5.0",
     "typescript": "^5.0.0"
   }
-}
+}