@nexly/react-web 0.9.0 → 0.10.0

package/dist/nexly-provider.d.ts

@@ -6,13 +6,18 @@ export type NexlyProviderProps = {
     appId: string;
     /** Ingest API token (maps to `key` on {@link Nexly}). Not named `key` — reserved in React. */
     ingestKey: string;
+    /**
+     * SDK identity sent as top-level `client` on the wire. Defaults to `'react'`
+     * for this package; framework wrappers (e.g. `@nexly/next`) override it.
+     */
+    client?: string;
     /** When a client exists, send one pageview on mount. */
     autoPageView?: boolean;
     /** When true and a client exists, attach engagement listeners (scroll, click, visibility, …). Cleaned up on change/unmount. */
     autoEngagement?: boolean;
     children: ReactNode;
 };
-export declare function NexlyProvider({ collectUrl, appId, ingestKey, autoPageView, autoEngagement, children, }: NexlyProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function NexlyProvider({ collectUrl, appId, ingestKey, client: clientOverride, autoPageView, autoEngagement, children, }: NexlyProviderProps): import("react/jsx-runtime").JSX.Element;
 /** Returns the configured {@link Nexly} client, or `null` if credentials are incomplete. Must be used under {@link NexlyProvider}. */
 export declare function useNexlyClient(): Nexly | null;
 //# sourceMappingURL=nexly-provider.d.ts.map

package/dist/nexly-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexly-provider.d.ts","sourceRoot":"","sources":["../src/nexly-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIrF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,+HAA+H;IAC/H,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,KAAK,EACL,SAAS,EACT,YAAoB,EACpB,cAAsB,EACtB,QAAQ,GACT,EAAE,kBAAkB,2CA0BpB;AAED,sIAAsI;AACtI,wBAAgB,cAAc,IAAI,KAAK,GAAG,IAAI,CAE7C"}
+{"version":3,"file":"nexly-provider.d.ts","sourceRoot":"","sources":["../src/nexly-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAIrF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,+HAA+H;IAC/H,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAED,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,KAAK,EACL,SAAS,EACT,MAAM,EAAE,cAAc,EACtB,YAAoB,EACpB,cAAsB,EACtB,QAAQ,GACT,EAAE,kBAAkB,2CA2BpB;AAED,sIAAsI;AACtI,wBAAgB,cAAc,IAAI,KAAK,GAAG,IAAI,CAE7C"}

package/dist/nexly-provider.js

@@ -2,8 +2,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { Nexly } from '@nexly/web';
 import { createContext, useContext, useEffect, useMemo } from 'react';
 const NexlyClientContext = createContext(null);
-export function NexlyProvider({ collectUrl, appId, ingestKey, autoPageView = false, autoEngagement = false, children, }) {
-    const client = useMemo(() => {
+export function NexlyProvider({ collectUrl, appId, ingestKey, client: clientOverride, autoPageView = false, autoEngagement = false, children, }) {
+    const clientId = clientOverride ?? 'react';
+    const nexly = useMemo(() => {
         const id = (appId ?? '').trim();
         const k = (ingestKey ?? '').trim();
         if (!id || !k) {
@@ -13,20 +14,20 @@ export function NexlyProvider({ collectUrl, appId, ingestKey, autoPageView = fal
                 console.warn('[Nexly] Missing ingestKey — tracking is disabled.');
             return null;
         }
-        return Nexly.init({ collectUrl, appId: id, key: k });
-    }, [collectUrl, appId, ingestKey]);
+        return Nexly.init({ collectUrl, appId: id, key: k, client: clientId });
+    }, [collectUrl, appId, ingestKey, clientId]);
     useEffect(() => {
-        if (autoPageView && client) {
-            client.pageview();
+        if (autoPageView && nexly) {
+            nexly.pageview();
         }
-    }, [autoPageView, client]);
+    }, [autoPageView, nexly]);
     useEffect(() => {
-        if (!autoEngagement || !client) {
+        if (!autoEngagement || !nexly) {
             return;
         }
-        return client.startEngagement();
-    }, [autoEngagement, client]);
-    return _jsx(NexlyClientContext.Provider, { value: client, children: children });
+        return nexly.startEngagement();
+    }, [autoEngagement, nexly]);
+    return _jsx(NexlyClientContext.Provider, { value: nexly, children: children });
 }
 /** Returns the configured {@link Nexly} client, or `null` if credentials are incomplete. Must be used under {@link NexlyProvider}. */
 export function useNexlyClient() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexly/react-web",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "React bindings for Nexly (@nexly/web): provider, client hook, engagement, optional auto pageview",
   "license": "MIT",
   "keywords": [
@@ -39,7 +39,7 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@nexly/web": "0.9.0"
+    "@nexly/web": "0.10.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.14",