@prodantix/react 0.0.1 → 0.0.2-beta.348

package/dist/index.cjs

@@ -1,3 +1,3 @@
 'use client';
-"use strict";"use client";var l=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var c=(e,t)=>{for(var o in t)l(e,o,{get:t[o],enumerable:!0})},u=(e,t,o,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of s(t))!C.call(e,r)&&r!==o&&l(e,r,{get:()=>t[r],enumerable:!(i=p(t,r))||i.enumerable});return e};var f=e=>u(l({},"__esModule",{value:!0}),e);var b={};c(b,{ProdantixProvider:()=>v,useProdantix:()=>m});module.exports=f(b);var a=require("@prodantix/sdk/web"),n=require("react"),P=require("react/jsx-runtime"),x=(0,n.createContext)(null),d=null,v=({children:e,options:t})=>{let[o,i]=(0,n.useState)(d);return(0,n.useEffect)(()=>{d??(d=(0,a.createWebClient)(t)),i(d)},[t]),(0,P.jsx)(x.Provider,{value:o,children:e})},m=()=>(0,n.useContext)(x);0&&(module.exports={ProdantixProvider,useProdantix});
+"use strict";"use client";var x=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var w=(n,e)=>{for(var t in e)x(n,t,{get:e[t],enumerable:!0})},O=(n,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of k(e))!$.call(n,i)&&i!==t&&x(n,i,{get:()=>e[i],enumerable:!(o=b(e,i))||o.enumerable});return n};var A=n=>O(x({},"__esModule",{value:!0}),n);var N={};w(N,{ProdantixProvider:()=>W,prodantixConfig:()=>y,resetProdantixForTest:()=>R,skipReason:()=>K,useMessenger:()=>I,useProdantix:()=>E});module.exports=A(N);var C=require("@prodantix/sdk/chat"),g=require("@prodantix/sdk/messenger"),P=require("@prodantix/sdk/web"),r=require("react"),h=require("react/jsx-runtime"),m=(0,r.createContext)(null),v=(0,r.createContext)(null),f="[prodantix/react]";function y(n){let e=n.key?.trim()??"",t=n.host?.trim()??"";return e===""||t===""?null:{apiKey:e,host:t}}function K(n,e){let t=y(n);if(t===null){let o=[n.key?.trim()?null:"key",n.host?.trim()?null:"host"].filter(Boolean).join(" and ");return`${f} disabled: no ${o}. Nothing will be sent from this app.`}return e===null?null:e.apiKey!==t.apiKey||e.host!==t.host?`${f} already installed against ${e.host}; the new host ${t.host} is ignored for this page load.`:null}var p=null,l=null,a=null;function R(){p=null,a=null,l?.destroy(),l=null}var W=({children:n,options:e})=>{let[t,o]=(0,r.useState)(a),[i,H]=(0,r.useState)(null);return(0,r.useEffect)(()=>{let s={host:e.host,key:e.apiKey},d=K(s,p);if(d!==null){console.warn(d);return}let u=y(s);if(u===null||p!==null){o(a);return}try{a=(0,P.createWebClient)(e),p=u,o(a)}catch(c){console.error(`${f} failed to start against ${u.host}:`,c)}},[e]),(0,r.useEffect)(()=>{let s=e.messengerHost?.trim();if(!s||!e.apiKey||l)return;let d=!1,u=a?.distinctId??"anonymous";return(async()=>{let c=await(0,g.fetchMessengerConfig)({apiKey:e.apiKey,host:s,onError:M=>console.warn(`${f} messenger settings could not be read:`,M)})??(0,g.cachedMessengerConfig)(void 0,e.apiKey);d||!c?.enabled||l||(l=(0,C.mountChat)({apiKey:e.apiKey,appearance:c,distinctId:u,host:s}),H({close:()=>l?.close(),open:()=>l?.open()}))})(),()=>{d=!0}},[e]),(0,h.jsx)(m.Provider,{value:t,children:(0,h.jsx)(v.Provider,{value:i,children:n})})},E=()=>(0,r.useContext)(m),I=()=>(0,r.useContext)(v);0&&(module.exports={ProdantixProvider,prodantixConfig,resetProdantixForTest,skipReason,useMessenger,useProdantix});
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -4,13 +4,52 @@ import { ProdantixClient } from '@prodantix/sdk';
 import { WebClientOptions } from '@prodantix/sdk/web';
 export { WebClientOptions } from '@prodantix/sdk/web';
 
+interface ProdantixOptions extends WebClientOptions {
+    /** The public browser edge, e.g. `https://eu.edge.prodantix.com`. The
+     *  messenger appears when this is set AND the project has it switched on in
+     *  the console; absent, the provider installs analytics only. */
+    messengerHost?: string;
+}
 interface ProdantixProviderProps {
     children?: ReactNode;
-    options: WebClientOptions;
+    options: ProdantixOptions;
+}
+interface MessengerHandle {
+    open(): void;
+    close(): void;
+}
+interface ActiveConfig {
+    apiKey: string;
+    host: string;
 }
+/** The web-client config when both public values are present, else null: an app
+ *  ships identically with prodantix disabled (no key in the build). */
+declare function prodantixConfig(env: {
+    host?: string;
+    key?: string;
+}): ActiveConfig | null;
+/**
+ * Why this mount will send nothing, or null when it will.
+ *
+ * Ported from `@bomdisoft/analytics`, where every one of these was a silent
+ * return. An app that mounts the provider and ships no events looks exactly like
+ * an app that is working, because the component renders null either way and the
+ * beacon is the only evidence.
+ */
+declare function skipReason(env: {
+    host?: string;
+    key?: string;
+}, active: ActiveConfig | null): string | null;
+/** Test seam: the module-level install is deliberately once-per-page-load, so a
+ *  test needs a way back to a clean slate. */
+declare function resetProdantixForTest(): void;
 declare const ProdantixProvider: ({ children, options }: ProdantixProviderProps) => react.JSX.Element;
 /** The page's client, or null on the server, before the provider's effect has
  *  run, or outside a provider. */
 declare const useProdantix: () => ProdantixClient | null;
+/** The messenger, for a site that wants its own button to open it. Null until
+ *  the project's configuration has been read and says enabled, so a caller must
+ *  handle that rather than assume a handle exists. */
+declare const useMessenger: () => MessengerHandle | null;
 
-export { ProdantixProvider, type ProdantixProviderProps, useProdantix };
+export { type MessengerHandle, type ProdantixOptions, ProdantixProvider, type ProdantixProviderProps, prodantixConfig, resetProdantixForTest, skipReason, useMessenger, useProdantix };

package/dist/index.d.ts

@@ -4,13 +4,52 @@ import { ProdantixClient } from '@prodantix/sdk';
 import { WebClientOptions } from '@prodantix/sdk/web';
 export { WebClientOptions } from '@prodantix/sdk/web';
 
+interface ProdantixOptions extends WebClientOptions {
+    /** The public browser edge, e.g. `https://eu.edge.prodantix.com`. The
+     *  messenger appears when this is set AND the project has it switched on in
+     *  the console; absent, the provider installs analytics only. */
+    messengerHost?: string;
+}
 interface ProdantixProviderProps {
     children?: ReactNode;
-    options: WebClientOptions;
+    options: ProdantixOptions;
+}
+interface MessengerHandle {
+    open(): void;
+    close(): void;
+}
+interface ActiveConfig {
+    apiKey: string;
+    host: string;
 }
+/** The web-client config when both public values are present, else null: an app
+ *  ships identically with prodantix disabled (no key in the build). */
+declare function prodantixConfig(env: {
+    host?: string;
+    key?: string;
+}): ActiveConfig | null;
+/**
+ * Why this mount will send nothing, or null when it will.
+ *
+ * Ported from `@bomdisoft/analytics`, where every one of these was a silent
+ * return. An app that mounts the provider and ships no events looks exactly like
+ * an app that is working, because the component renders null either way and the
+ * beacon is the only evidence.
+ */
+declare function skipReason(env: {
+    host?: string;
+    key?: string;
+}, active: ActiveConfig | null): string | null;
+/** Test seam: the module-level install is deliberately once-per-page-load, so a
+ *  test needs a way back to a clean slate. */
+declare function resetProdantixForTest(): void;
 declare const ProdantixProvider: ({ children, options }: ProdantixProviderProps) => react.JSX.Element;
 /** The page's client, or null on the server, before the provider's effect has
  *  run, or outside a provider. */
 declare const useProdantix: () => ProdantixClient | null;
+/** The messenger, for a site that wants its own button to open it. Null until
+ *  the project's configuration has been read and says enabled, so a caller must
+ *  handle that rather than assume a handle exists. */
+declare const useMessenger: () => MessengerHandle | null;
 
-export { ProdantixProvider, type ProdantixProviderProps, useProdantix };
+export { type MessengerHandle, type ProdantixOptions, ProdantixProvider, type ProdantixProviderProps, prodantixConfig, resetProdantixForTest, skipReason, useMessenger, useProdantix };

package/dist/index.js

@@ -1,3 +1,3 @@
 'use client';
-"use client";import{createWebClient as l}from"@prodantix/sdk/web";import{createContext as d,useContext as a,useEffect as x,useState as P}from"react";import{jsx as p}from"react/jsx-runtime";var n=d(null),t=null,c=({children:o,options:e})=>{let[r,i]=P(t);return x(()=>{t??(t=l(e)),i(t)},[e]),p(n.Provider,{value:r,children:o})},u=()=>a(n);export{c as ProdantixProvider,u as useProdantix};
+"use client";import{mountChat as H}from"@prodantix/sdk/chat";import{cachedMessengerConfig as M,fetchMessengerConfig as b}from"@prodantix/sdk/messenger";import{createWebClient as k}from"@prodantix/sdk/web";import{createContext as x,useContext as h,useEffect as p,useState as f}from"react";import{jsx as g}from"react/jsx-runtime";var y=x(null),C=x(null),c="[prodantix/react]";function P(t){let e=t.key?.trim()??"",n=t.host?.trim()??"";return e===""||n===""?null:{apiKey:e,host:n}}function $(t,e){let n=P(t);if(n===null){let a=[t.key?.trim()?null:"key",t.host?.trim()?null:"host"].filter(Boolean).join(" and ");return`${c} disabled: no ${a}. Nothing will be sent from this app.`}return e===null?null:e.apiKey!==n.apiKey||e.host!==n.host?`${c} already installed against ${e.host}; the new host ${n.host} is ignored for this page load.`:null}var u=null,r=null,i=null;function W(){u=null,i=null,r?.destroy(),r=null}var E=({children:t,options:e})=>{let[n,a]=f(i),[m,v]=f(null);return p(()=>{let o={host:e.host,key:e.apiKey},l=$(o,u);if(l!==null){console.warn(l);return}let s=P(o);if(s===null||u!==null){a(i);return}try{i=k(e),u=s,a(i)}catch(d){console.error(`${c} failed to start against ${s.host}:`,d)}},[e]),p(()=>{let o=e.messengerHost?.trim();if(!o||!e.apiKey||r)return;let l=!1,s=i?.distinctId??"anonymous";return(async()=>{let d=await b({apiKey:e.apiKey,host:o,onError:K=>console.warn(`${c} messenger settings could not be read:`,K)})??M(void 0,e.apiKey);l||!d?.enabled||r||(r=H({apiKey:e.apiKey,appearance:d,distinctId:s,host:o}),v({close:()=>r?.close(),open:()=>r?.open()}))})(),()=>{l=!0}},[e]),g(y.Provider,{value:n,children:g(C.Provider,{value:m,children:t})})},I=()=>h(y),N=()=>h(C);export{E as ProdantixProvider,P as prodantixConfig,W as resetProdantixForTest,$ as skipReason,N as useMessenger,I as useProdantix};
 //# sourceMappingURL=index.js.map

package/package.json

@@ -2,14 +2,14 @@
   "description": "React adapter for the Prodantix SDK: a provider that installs the web client once, StrictMode-safe, and a hook that reads it",
   "devDependencies": {
     "@bomdisoft/typescript-config": "0.0.0",
-    "@happy-dom/global-registrator": "^20.10.3",
-    "@prodantix/sdk": "0.0.1",
+    "@happy-dom/global-registrator": "^20.11.6",
+    "@prodantix/sdk": "0.1.0",
     "@testing-library/react": "^16.3.2",
-    "@types/bun": "^1.3.14",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "react": "19.2.7",
-    "react-dom": "19.2.7",
+    "@types/bun": "^1.4.0",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
     "tsup": "8.5.1",
     "typescript": "^6.0.3"
   },
@@ -47,5 +47,5 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.0.1"
+  "version": "0.0.2-beta.348"
 }